Funzioni SDK e valori restituiti in nove linguaggi

Connect(merchantOrigin, productID, licentivoProductID string, trustedKeys map[string]string, options Config) → (*Application, error)

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

(*Application, error)

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Login(ctx context.Context, email, password string) → (State, error)

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.
• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.

Valore restituito

(State, error)

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

Restore(ctx context.Context) → (State, error)

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

(State, error)

Restituisce lo stato; ErrNoSession o NO_SESSION indica nessuna sessione salvata. Gestisci separatamente gli altri errori.

RunFeature(feature string, action func() error) → error

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Logout(ctx context.Context) → error

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

ReleaseDevice(ctx context.Context) → error

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Close() → void

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

void

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

NewApplication(config Config) → (*Application, error)

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

(*Application, error)

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

NewApplicationFromFiles(launchPath, productPath string, options Config) → (*Application, error)

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• launchPath, productPath: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

(*Application, error)

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

LoadPublicConfig(path string) → (PublicConfig, error)

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• path: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

(PublicConfig, error)

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

NewRuntime(product ProductConfig, runtime RuntimeConfig) → (Runtime, error)

Scopo

Crea l’adattatore SDK ufficiale per integrazioni avanzate; l’attestazione viene trasmessa solo in memoria.

Parametri

• product, runtime: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

(Runtime, error)

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

New(origin string, allowLocalHTTP bool) → (*Client, error)

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• allowLocalHTTP: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

(*Client, error)

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

WithToken(token string) → *Client

Scopo

Restituisce una copia del client con il token fornito, per backend attendibili.

Parametri

• token: Token di sessione Launch, restituito solo dalle interfacce di sessione base o archivio cifrato.

Valore restituito

*Client

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Login(ctx context.Context, email, password string) → (User, error)

Scopo

Autentica l’account e restituisce dati o sessione, senza avviare il runtime di autorizzazione.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.
• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.

Valore restituito

(User, error)

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

LoginSession(ctx context.Context, email, password string) → (Session, error)

Scopo

Autentica l’account e restituisce dati o sessione, senza avviare il runtime di autorizzazione.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.
• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.

Valore restituito

(Session, error)

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

CurrentUser(ctx context.Context) → (User, error)

Scopo

Consulta l’account corrente; il successo non autorizza funzioni protette.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

(User, error)

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

Identity(ctx context.Context, product, environment string) → (Identity, error)

Scopo

Ottiene un’attestazione monouso e dati pubblici di instradamento, non una licenza o un permesso di funzione.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.
• product: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.

Valore restituito

(Identity, error)

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

SignOut(ctx context.Context) → error

Scopo

Revoca la sessione Launch e cancella il token del client; non sostituisce la disconnessione del dispositivo dell’SDK ufficiale.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Credential(ctx context.Context, product, environment string) → (Credential, error)

Scopo

API precedente conservata: il protocollo delle credenziali di licenza permanenti è stato rimosso e le chiamate falliscono. Usa Application.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.
• product: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.

Valore restituito

(Credential, error)

Fallisce sempre; migra allo scambio d’identità account.

CredentialWithRetry(ctx context.Context, product, environment string, policy RetryPolicy) → (Credential, error)

Scopo

API precedente conservata: il protocollo delle credenziali di licenza permanenti è stato rimosso e le chiamate falliscono. Usa Application.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.
• product: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• policy: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

(Credential, error)

Fallisce sempre; migra allo scambio d’identità account.

NewSystemSessionStore(directory string) → (SessionStore, error)

Scopo

Crea un archivio persistente protetto; ottieni la chiave dalla cassaforte credenziali del sistema operativo.

Parametri

• directory: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

(SessionStore, error)

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

ProtectDirectory(directory string) → error

Scopo

Limita l’accesso alla cartella all’utente Windows corrente o ai permessi privati delle altre piattaforme.

Parametri

• directory: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

ServiceUnavailable(err error) → bool

Scopo

Riconosce l’indisponibilità temporanea; questo non permette mai autorizzazioni offline.

Parametri

• err: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

bool

Restituisce una classificazione booleana, non un’autorizzazione.

Error() → string

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

string

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

Unwrap() → error

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

error

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

Load(ctx context.Context, key string) → ([]byte, error)

Scopo

Carica l’account tramite chiave isolata; i dati segreti sono riservati all’SDK.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

([]byte, error)

Restituisce il record segreto; se assente restituisce un valore vuoto o ErrNoSession secondo il linguaggio.

Save(ctx context.Context, key string, value []byte) → error

Scopo

Salva atomicamente l’account con la sua chiave isolata.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Delete(ctx context.Context, key string) → error

Scopo

Elimina l’account senza cancellare cache di autorizzazione o registro di disconnessione dell’SDK ufficiale.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Start(ctx context.Context, onError func(error)) → error

Scopo

Avvia verifica e manutenzione SDK ufficiale; accesso e protezione funzioni usano API separate.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.
• onError: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

RunFeature(feature string, action func() error) → error

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Deactivate(ctx context.Context) → error

Scopo

Disconnette il dispositivo tramite SDK ufficiale; l’applicazione revoca separatamente la sessione Launch.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

error

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Close() → void

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

void

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

Application.connect(merchant_origin, product_id, licentivo_product_id, trusted_keys, environment="live", **kwargs) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

login(email, password, *, pending_attempts=3) → Application (self)

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.
• pending_attempts: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application (self)

Restituisce questa istanza dell’applicazione, non dati account o un risultato di autorizzazione.

restore() → bool

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Valore restituito

bool

true indica ripristino riuscito; false indica nessuna sessione ripristinabile. Rifiuto, scadenza e rete producono errori.

run_feature(name, action) → T

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

T

Restituisce il risultato della callback; problemi di autorizzazione ed eccezioni operative producono errori.

logout() → bool

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Valore restituito

bool

true conferma la disconnessione; false indica disconnessione remota o revoca del dispositivo in sospeso. L’archivio può anche generare errori.

release_device() → bool

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Valore restituito

bool

true conferma la disconnessione; false indica disconnessione remota o revoca del dispositivo in sospeso. L’archivio può anche generare errori.

close() → None

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

None

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

with Application.connect(...) as app: ... → Application / None

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

Application / None

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

Application(origin, product_id, product_config, environment="live", store=None, runtime_factory=None, cache_dir=None, sleep=time.sleep, opener=None) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• product_config: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Application.from_files(launch_config, product_config, **kwargs) → Application

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• launch_config, product_config: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

MemoryStore() → MemoryStore

Scopo

Crea un archivio sessioni valido soltanto nel processo corrente.

Valore restituito

MemoryStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

WindowsDPAPIStore(directory=None) → WindowsDPAPIStore

Scopo

Crea un archivio persistente protetto; ottieni la chiave dalla cassaforte credenziali del sistema operativo.

Parametri

• directory: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

WindowsDPAPIStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

APIError(code, status=0, retry_after=0) → APIError

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Parametri

• code, status, retry_after: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

APIError

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

load(key) → bytes | None

Scopo

Carica l’account tramite chiave isolata; i dati segreti sono riservati all’SDK.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

bytes | None

Restituisce il record segreto; se assente restituisce un valore vuoto o ErrNoSession secondo il linguaggio.

save(key, value) → None

Scopo

Salva atomicamente l’account con la sua chiave isolata.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

None

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

delete(key) → None

Scopo

Elimina l’account senza cancellare cache di autorizzazione o registro di disconnessione dell’SDK ufficiale.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

None

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Application.Connect(string merchantOrigin, string productId, string licentivoProductId, Dictionary<string,string> trustedKeys, string environment="live", ISessionStore? store=null, string? cacheDirectory=null) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• store, cacheDirectory: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Login(string email, string password, int pendingAttempts=3, CancellationToken ct=default) → Task

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.
• pendingAttempts: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.
• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Task

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Restore(CancellationToken ct=default) → Task<bool>

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Task<bool>

true indica ripristino riuscito; false indica nessuna sessione ripristinabile. Rifiuto, scadenza e rete producono errori.

RunFeature(string feature, Func<Task> action) → Task

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

Task

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Status() → AuthorizationStatus? (null: runtime absent)

Scopo

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

Valore restituito

AuthorizationStatus? (null: runtime absent)

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

Logout(CancellationToken ct=default) → Task

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Task

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

ReleaseDevice(CancellationToken ct=default) → Task

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Task

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

DisposeAsync() → ValueTask

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

ValueTask

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

Application(string origin, string productId, Config productConfig, string environment="live", ISessionStore? store=null, string? cacheDirectory=null, HttpMessageHandler? handler=null, Func<Config,IRuntime>? runtimeFactory=null) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productId: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• productConfig: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Application.FromFiles(string launchPath, string productPath, ISessionStore? store=null) → Application

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• launchPath, productPath: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• store: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

new MemoryStore() → MemoryStore

Scopo

Crea un archivio sessioni valido soltanto nel processo corrente.

Valore restituito

MemoryStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

new WindowsDPAPIStore(string? directory=null) → WindowsDPAPIStore

Scopo

Crea un archivio persistente protetto; ottieni la chiave dalla cassaforte credenziali del sistema operativo.

Parametri

• directory: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

WindowsDPAPIStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

new LaunchException(string code, int status=0, int retryAfterSeconds=0) → LaunchException

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Parametri

• code, status, retryAfterSeconds: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

LaunchException

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

Load(string key) → byte[]?

Scopo

Carica l’account tramite chiave isolata; i dati segreti sono riservati all’SDK.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

byte[]?

Restituisce il record segreto; se assente restituisce un valore vuoto o ErrNoSession secondo il linguaggio.

Save(string key, byte[] value) → void

Scopo

Salva atomicamente l’account con la sua chiave isolata.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Delete(string key) → void

Scopo

Elimina l’account senza cancellare cache di autorizzazione o registro di disconnessione dell’SDK ufficiale.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Start(CancellationToken ct) → Task

Scopo

Avvia verifica e manutenzione SDK ufficiale; accesso e protezione funzioni usano API separate.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Task

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Status() → AuthorizationStatus

Scopo

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

Valore restituito

AuthorizationStatus

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

RunFeature(string feature, Func<Task> action) → Task

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

Task

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Deactivate(CancellationToken ct) → Task

Scopo

Disconnette il dispositivo tramite SDK ufficiale; l’applicazione revoca separatamente la sessione Launch.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Task

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

DisposeAsync() → ValueTask

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

ValueTask

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

Launch.connect(String merchantOrigin, String productId, String licentivoProductId, Map<String,String> trustedKeys, String environment) → Launch

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.

Valore restituito

Launch

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

login(String email, char[] password) → State

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.

Valore restituito

State

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

restore() → State

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Valore restituito

State

Restituisce lo stato; ErrNoSession o NO_SESSION indica nessuna sessione salvata. Gestisci separatamente gli altri errori.

runFeature(String feature, Client.FeatureAction action) → void

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

logout() → void

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

releaseDevice() → void

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

close() → void

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

void

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

new Launch(Config config, Map<String,Object> product, Path cacheRoot [, Store store, Transport transport, RuntimeFactory factory, Sleeper sleeper]) → Launch

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• config, product: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• cacheRoot: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• store, transport, factory, sleeper: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Launch

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

new Launch.Config(String merchantOrigin, String launchProductID, String licentivoProductID, String environment) → Config

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.

Valore restituito

Config

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

Launch.Config.load(Path path) → Config

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• path: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

Config

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

Launch.readPublic(Path path) → Map<String,Object>

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• path: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

Map<String,Object>

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

new Launch.MemoryStore() → MemoryStore

Scopo

Crea un archivio sessioni valido soltanto nel processo corrente.

Valore restituito

MemoryStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

new EncryptedFileStore(Path directory, SecretKey vaultKey) → EncryptedFileStore

Scopo

Crea un archivio persistente protetto; ottieni la chiave dalla cassaforte credenziali del sistema operativo.

Parametri

• directory: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• vaultKey: Chiave di cifratura dalla cassaforte del sistema; non salvarla accanto ai record cifrati.

Valore restituito

EncryptedFileStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

request(String method, URI uri, String bearer, byte[] body) → Response

Scopo

Invia richieste HTTP dell’account e restituisce stato, intestazioni o corpo grezzo, senza decidere autorizzazioni.

Parametri

• method, uri, bearer, body: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

Response

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

new Launch.Failure(String code [, int status, String requestID, long retryAfterMillis, boolean transport]) → Failure

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Parametri

• code, status, requestID, retryAfterMillis, transport: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

Failure

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

unavailable() → boolean

Scopo

Riconosce l’indisponibilità temporanea; questo non permette mai autorizzazioni offline.

Valore restituito

boolean

Restituisce una classificazione booleana, non un’autorizzazione.

load(String scope) → byte[] | null

Scopo

Carica l’account tramite chiave isolata; i dati segreti sono riservati all’SDK.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

byte[] | null

Restituisce il record segreto; se assente restituisce un valore vuoto o ErrNoSession secondo il linguaggio.

save(String scope, byte[] secret) → void

Scopo

Salva atomicamente l’account con la sua chiave isolata.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

delete(String scope) → void

Scopo

Elimina l’account senza cancellare cache di autorizzazione o registro di disconnessione dell’SDK ufficiale.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

canStartOffline() → boolean

Scopo

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

Valore restituito

boolean

Restituisce una classificazione booleana, non un’autorizzazione.

start() → void

Scopo

Avvia verifica e manutenzione SDK ufficiale; accesso e protezione funzioni usano API separate.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

runFeature(String feature, Client.FeatureAction action) → void

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

releaseDevice() → void

Scopo

Disconnette il dispositivo tramite SDK ufficiale; l’applicazione revoca separatamente la sessione Launch.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

close() → void

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

void

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

create(Map<String,Object> settings) → Runtime

Scopo

Crea l’adattatore SDK ufficiale per integrazioni avanzate; l’attestazione viene trasmessa solo in memoria.

Parametri

• settings: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

Runtime

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

sleep(long milliseconds) → void

Scopo

Attende la durata indicata per pianificare tentativi avanzati.

Parametri

• milliseconds: Attesa consigliata prima di riprovare; distingui secondi, millisecondi e Duration secondo il linguaggio.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Application.connect(merchantOrigin, productID, licentivoProductID, trustedKeys, options?) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

login(email: string, password: string, options?: {signal?: AbortSignal}) → Promise<SessionState>

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.
• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Promise<SessionState>

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

restore(options?: {signal?: AbortSignal}) → Promise<SessionState | null>

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Promise<SessionState | null>

Restituisce lo stato; null o nil indica nessuna sessione ripristinabile. Gli altri fallimenti producono errori.

runFeature<T>(name: string, action: () => T | Promise<T>) → Promise<T>

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

Promise<T>

Restituisce il risultato della callback; problemi di autorizzazione ed eccezioni operative producono errori.

logout(options?: {signal?: AbortSignal}) → Promise<boolean>

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Promise<boolean>

true conferma la disconnessione; false indica disconnessione remota o revoca del dispositivo in sospeso. L’archivio può anche generare errori.

releaseDevice(options?: {signal?: AbortSignal}) → Promise<void>

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Promise<void>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

close() → Promise<void>

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

Promise<void>

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

new Application(launch: LaunchConfig, product: PublicProductConfig, options?: Options) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• launch, product: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Application.fromFiles(launchPath: string, productPath: string, options?: Options) → Promise<Application>

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• launchPath, productPath: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Promise<Application>

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

validateConfig(launch: LaunchConfig, product: PublicProductConfig) → {launch: LaunchConfig, product: PublicProductConfig}

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• launch, product: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

{launch: LaunchConfig, product: PublicProductConfig}

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

loadConfig(launchPath: string, productPath: string) → Promise<{launch: LaunchConfig, product: PublicProductConfig}>

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• launchPath, productPath: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

Promise<{launch: LaunchConfig, product: PublicProductConfig}>

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

defaultTransport(request: Request) → Promise<Response>

Scopo

Invia richieste HTTP dell’account e restituisce stato, intestazioni o corpo grezzo, senza decidere autorizzazioni.

Parametri

• request: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

Promise<Response>

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

new MemoryStore() → MemoryStore

Scopo

Crea un archivio sessioni valido soltanto nel processo corrente.

Valore restituito

MemoryStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

new EncryptedFileStore(directory: string, key: Uint8Array) → EncryptedFileStore

Scopo

Crea un archivio persistente protetto; ottieni la chiave dalla cassaforte credenziali del sistema operativo.

Parametri

• directory: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• key: Chiave di cifratura dalla cassaforte del sistema; non salvarla accanto ai record cifrati.

Valore restituito

EncryptedFileStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

new LaunchError(code: string, status=0, retryAfterSeconds=0) → LaunchError

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Parametri

• code, status, retryAfterSeconds: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

LaunchError

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

load(scope: string) → Promise<SavedSession | null>

Scopo

Carica l’account tramite chiave isolata; i dati segreti sono riservati all’SDK.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Promise<SavedSession | null>

Restituisce il record segreto; se assente restituisce un valore vuoto o ErrNoSession secondo il linguaggio.

save(scope: string, value: SavedSession) → Promise<void>

Scopo

Salva atomicamente l’account con la sua chiave isolata.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Promise<void>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

delete(scope: string) → Promise<void>

Scopo

Elimina l’account senza cancellare cache di autorizzazione o registro di disconnessione dell’SDK ufficiale.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Promise<void>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

status() → {allowed:boolean,state:string} | Promise<{allowed:boolean,state:string}>

Scopo

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

Valore restituito

{allowed:boolean,state:string} | Promise<{allowed:boolean,state:string}>

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

start(onError?: (error: unknown) => void, signal?: AbortSignal) → Promise<unknown>

Scopo

Avvia verifica e manutenzione SDK ufficiale; accesso e protezione funzioni usano API separate.

Parametri

• onError: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.
• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Promise<unknown>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

runFeature<T>(name: string, action: () => T | Promise<T>) → Promise<T>

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

Promise<T>

Restituisce il risultato della callback; problemi di autorizzazione ed eccezioni operative producono errori.

deactivate(signal?: AbortSignal) → Promise<unknown>

Scopo

Disconnette il dispositivo tramite SDK ufficiale; l’applicazione revoca separatamente la sessione Launch.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Promise<unknown>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

logout?(signal?: AbortSignal) → Promise<{local_complete:boolean,revocation_pending:boolean,storage_error?:string}>

Scopo

Disconnette il dispositivo tramite SDK ufficiale; l’applicazione revoca separatamente la sessione Launch.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Promise<{local_complete:boolean,revocation_pending:boolean,storage_error?:string}>

Disconnessione locale e revoca remota sono distinte. Gestisci operazioni pendenti ed errori di archiviazione; conserva il registro SDK.

close() → Promise<unknown>

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

Promise<unknown>

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

Application::connect(origin: &str, product_id: &str, licentivo_product_id: &str, trusted_keys: &[(&str,&str)], environment: &str) → Result<Application, Failure>

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.

Valore restituito

Result<Application, Failure>

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

login(&mut self, email: &str, password: &str) → Result<State, Failure>

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.

Valore restituito

Result<State, Failure>

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

restore(&mut self) → Result<State, Failure>

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Valore restituito

Result<State, Failure>

Restituisce lo stato; ErrNoSession o NO_SESSION indica nessuna sessione salvata. Gestisci separatamente gli altri errori.

run_feature<T,F: FnOnce() -> Result<T,Failure>>(&mut self, feature: &str, action: F) → Result<T, Failure>

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

Result<T, Failure>

Restituisce il risultato della callback; problemi di autorizzazione ed eccezioni operative producono errori.

logout(&mut self) → Result<(), Failure>

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Valore restituito

Result<(), Failure>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

release_device(&mut self) → Result<(), Failure>

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Valore restituito

Result<(), Failure>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

close(&mut self) / drop(&mut self) → ()

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

()

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

Application::new(config: Config, product: Value, cache_root: PathBuf) → Result<Application, Failure>

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• config, product: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• cache_root: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

Result<Application, Failure>

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Application::with_components(config: Config, product: Value, cache_root: PathBuf, store: Box<dyn Store>, transport: Box<dyn Transport>, factory: Box<dyn RuntimeFactory>, sleeper: Box<dyn Sleeper>) → Result<Application, Failure>

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• config, product: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• cache_root: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• store, transport, factory, sleeper: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Result<Application, Failure>

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Config::new(origin: &str, product: &str, runtime_product: &str, environment: &str) → Result<Config, Failure>

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.

Valore restituito

Result<Config, Failure>

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

Config::load(path: impl AsRef<Path>) → Result<Config, Failure>

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• path: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

Result<Config, Failure>

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

read_public(path: impl AsRef<Path>) → Result<Value, Failure>

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• path: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

Result<Value, Failure>

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

MemoryStore::default() → MemoryStore

Scopo

Crea un archivio sessioni valido soltanto nel processo corrente.

Valore restituito

MemoryStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

EncryptedFileStore::new(root: PathBuf, vault_key: [u8;32]) → Result<EncryptedFileStore, Failure>

Scopo

Crea un archivio persistente protetto; ottieni la chiave dalla cassaforte credenziali del sistema operativo.

Parametri

• root: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• vault_key: Chiave di cifratura dalla cassaforte del sistema; non salvarla accanto ai record cifrati.

Valore restituito

Result<EncryptedFileStore, Failure>

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

CurlTransport::new() → Result<CurlTransport, Failure>

Scopo

Invia richieste HTTP dell’account e restituisce stato, intestazioni o corpo grezzo, senza decidere autorizzazioni.

Valore restituito

Result<CurlTransport, Failure>

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

request(&mut self, method: &str, url: &str, bearer: &str, body: &[u8]) → Result<Response, Failure>

Scopo

Invia richieste HTTP dell’account e restituisce stato, intestazioni o corpo grezzo, senza decidere autorizzazioni.

Parametri

• method, url, bearer, body: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

Result<Response, Failure>

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

Failure::new(code: &str) → Failure

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Parametri

• code: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

Failure

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

sleep(&mut self, duration: Duration) → Result<(), Failure>

Scopo

Attende la durata indicata per pianificare tentativi avanzati.

Parametri

• duration: Attesa consigliata prima di riprovare; distingui secondi, millisecondi e Duration secondo il linguaggio.

Valore restituito

Result<(), Failure>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

load(&mut self, scope: &str) → Result<Option<Vec<u8>>, Failure>

Scopo

Carica l’account tramite chiave isolata; i dati segreti sono riservati all’SDK.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Result<Option<Vec<u8>>, Failure>

Restituisce il record segreto; se assente restituisce un valore vuoto o ErrNoSession secondo il linguaggio.

save(&mut self, scope: &str, value: &[u8]) → Result<(), Failure>

Scopo

Salva atomicamente l’account con la sua chiave isolata.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Result<(), Failure>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

delete(&mut self, scope: &str) → Result<(), Failure>

Scopo

Elimina l’account senza cancellare cache di autorizzazione o registro di disconnessione dell’SDK ufficiale.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Result<(), Failure>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

run_feature(&mut self, feature: &str, action: &mut dyn FnMut() -> Result<(),Failure>) → Result<(), Failure>

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

Result<(), Failure>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

release_device(&mut self) → Result<(), Failure>

Scopo

Disconnette il dispositivo tramite SDK ufficiale; l’applicazione revoca separatamente la sessione Launch.

Valore restituito

Result<(), Failure>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

close(&mut self) → ()

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

()

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

open(&mut self, settings: &Value, cached_only: bool) → Result<Box<dyn Runtime>, Failure>

Scopo

Crea l’adattatore SDK ufficiale per integrazioni avanzate; l’attestazione viene trasmessa solo in memoria.

Parametri

• settings, cached_only: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

Result<Box<dyn Runtime>, Failure>

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

for_logout(&mut self, settings: &Value) → Result<Box<dyn Runtime>, Failure>

Scopo

Crea l’adattatore SDK ufficiale per integrazioni avanzate; l’attestazione viene trasmessa solo in memoria.

Parametri

• settings: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

Result<Box<dyn Runtime>, Failure>

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

sleep(&mut self, duration: Duration) → Result<(), Failure>

Scopo

Attende la durata indicata per pianificare tentativi avanzati.

Parametri

• duration: Attesa consigliata prima di riprovare; distingui secondi, millisecondi e Duration secondo il linguaggio.

Valore restituito

Result<(), Failure>

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

LicentivoLaunch::Application.connect(merchant_origin, product_id, licentivo_product_id, trusted_keys, environment: "live", **options) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

login(email, password, cancellation: nil) → Hash

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.
• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Hash

Restituisce lo stato dell’account; consulta la tabella dei campi seguente.

restore(cancellation: nil) → Hash | nil

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

Hash | nil

Restituisce lo stato; null o nil indica nessuna sessione ripristinabile. Gli altri fallimenti producono errori.

run_feature(feature) { ... } → T

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

T

Restituisce il risultato della callback; problemi di autorizzazione ed eccezioni operative producono errori.

logout(cancellation: nil) → true | false

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

true | false

true conferma la disconnessione; false indica disconnessione remota o revoca del dispositivo in sospeso. L’archivio può anche generare errori.

release_device(cancellation: nil) → true | false

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Parametri

• ctx / ct / signal / cancellation: Contesto di richiesta o segnale d’annullamento; il contesto del ciclo Go governa anche le attività di fondo.

Valore restituito

true | false

true conferma la disconnessione; false indica disconnessione remota o revoca del dispositivo in sospeso. L’archivio può anche generare errori.

close → nil

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

nil

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

Application.new(launch, product, store: MemoryStore.new, transport: nil, runtime_factory: nil, cache_dir: nil, sleep: nil, pending_attempts: 5) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• launch, product: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Application.from_files(launch_path, product_path, **options) → Application

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• launchPath, productPath: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• options / config: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

LicentivoLaunch.origin(value, environment) → String

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• value: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.

Valore restituito

String

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

LicentivoLaunch.validate_config(launch, product) → [Hash, Hash]

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• launch, product: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

[Hash, Hash]

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

LicentivoLaunch.load_config(launch_path, product_path) → [Hash, Hash]

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• launchPath, productPath: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.

Valore restituito

[Hash, Hash]

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

LicentivoLaunch.default_transport(request) → Hash

Scopo

Invia richieste HTTP dell’account e restituisce stato, intestazioni o corpo grezzo, senza decidere autorizzazioni.

Parametri

• request: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

Hash

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

MemoryStore.new → MemoryStore

Scopo

Crea un archivio sessioni valido soltanto nel processo corrente.

Valore restituito

MemoryStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

EncryptedFileStore.new(directory, key) → EncryptedFileStore

Scopo

Crea un archivio persistente protetto; ottieni la chiave dalla cassaforte credenziali del sistema operativo.

Parametri

• directory: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• key: Chiave di cifratura dalla cassaforte del sistema; non salvarla accanto ai record cifrati.

Valore restituito

EncryptedFileStore

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

persistent? / secure? → true | false

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Valore restituito

true | false

Restituisce una classificazione booleana, non un’autorizzazione.

path(scope) → String

Scopo

Valida o legge le impostazioni pubbliche; prodotti, ambiente e chiavi di firma devono corrispondere.

Parametri

• scope: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

String

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

CancellationToken.new.cancel / check! → true / nil

Scopo

Richiede o verifica l’annullamento cooperativo; annullare non significa autorizzazione riuscita.

Valore restituito

true / nil

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Error.new(code, status: 0, retry_after_seconds: 0) → Error

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Parametri

• code, status, retry_after_seconds: Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

Error

Restituisce il tipo indicato nella firma; il risultato non concede permessi di funzione.

load(scope) → Hash | nil

Scopo

Carica l’account tramite chiave isolata; i dati segreti sono riservati all’SDK.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Hash | nil

Restituisce il record segreto; se assente restituisce un valore vuoto o ErrNoSession secondo il linguaggio.

save(scope, record) → Object

Scopo

Salva atomicamente l’account con la sua chiave isolata.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Object

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

delete(scope) → Object

Scopo

Elimina l’account senza cancellare cache di autorizzazione o registro di disconnessione dell’SDK ufficiale.

Parametri

• scope / key, value / record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

Object

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

launch_application_connect(origin, product_id, licentivo_product_id, trusted_keys_json, environment, remember, store) → launch_application *

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• remember, store: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

launch_application *

Restituisce un puntatore posseduto; NULL indica inizializzazione fallita. Liberalo con close.

launch_application_login(launch_application *app, const char *email, const char *password) → int

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.

Valore restituito

int

1 indica successo; 0 indica fallimento. Leggi il codice dopo un errore.

launch_application_restore(launch_application *app) → int

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Valore restituito

int

1 indica ripristino, 0 nessuna sessione, -1 rifiuto o fallimento. Leggi il codice dopo un errore.

launch_application_run_feature(app, feature, ln_feature_action action, void *context) → int

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.
• context: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

int

1 indica successo; 0 indica fallimento. Leggi il codice dopo un errore.

launch_application_logout(launch_application *app) → int

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Valore restituito

int

1 indica successo; 0 indica fallimento. Leggi il codice dopo un errore.

launch_application_release_device(launch_application *app) → int

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Valore restituito

int

1 indica successo; 0 indica fallimento. Leggi il codice dopo un errore.

launch_application_status(launch_application *app) → char *

Scopo

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

Valore restituito

char *

Restituisce JSON di cui gestire la memoria con ln_free_string. Senza runtime: login_required e allowed=false.

launch_application_error(const launch_application *app) → const char *

Scopo

Crea o legge errori strutturati per classificazione, attesa e diagnosi correlata.

Valore restituito

const char *

Restituisce una stringa di errore presa in prestito. Non liberarla né usarla dopo la distruzione dell’applicazione.

launch_application_close(launch_application *app) → void

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

void

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

launch_application_open(origin, product_id, product_config_path, environment, remember, store) → launch_application *

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• product_config_path: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• remember, store: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

launch_application *

Restituisce un puntatore posseduto; NULL indica inizializzazione fallita. Liberalo con close.

launch_application_from_files(launch_config_path, product_config_path, remember, store) → launch_application *

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• launchPath, productPath: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• remember, store: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

launch_application *

Restituisce un puntatore posseduto; NULL indica inizializzazione fallita. Liberalo con close.

launch_application_cli(int argc, char **argv) → launch_application *

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• argc, argv: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

launch_application *

Restituisce un puntatore posseduto; NULL indica inizializzazione fallita. Liberalo con close.

launch_login(account, origin, product_id, config_path, environment, email, password) / launch_sign_in(account, argc, argv) → int

Scopo

API precedente conservata: il protocollo delle credenziali di licenza permanenti è stato rimosso e le chiamate falliscono. Usa Application.

Parametri

• account, origin, product_id, config_path, environment, email, password, argc, argv: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

int

Fallisce sempre; migra allo scambio d’identità account.

launch_sign_out(launch_account *account, int clear_cache) → void

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Parametri

• account, clear_cache: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

ln_free_string(char *value) → void

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Parametri

• value: Restituisce JSON di cui gestire la memoria con ln_free_string. Senza runtime: login_required e allowed=false.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

load(void *context, const char *scope, char **record) → int

Scopo

Carica l’account tramite chiave isolata; i dati segreti sono riservati all’SDK.

Parametri

• context: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• scope, record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

int

1 trovato, 0 assente, -1 errore di lettura. load alloca record; il chiamante lo libera.

save(void *context, const char *scope, const char *record) → int (1: success, 0: failure)

Scopo

Salva atomicamente l’account con la sua chiave isolata.

Parametri

• context: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• scope, record: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

int (1: success, 0: failure)

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

remove(void *context, const char *scope) → int (1: success, 0: failure)

Scopo

Elimina l’account senza cancellare cache di autorizzazione o registro di disconnessione dell’SDK ufficiale.

Parametri

• context: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.
• scope: Chiavi d’isolamento e record segreti SDK; gli archivi personalizzati devono supportare più chiavi e sostituzione atomica.

Valore restituito

int (1: success, 0: failure)

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Application::Connect(origin, product, licentivo_product, trusted_keys_json, environment="live", remember=false, store=nullptr) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• merchantOrigin / origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• productID / product_id: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• licentivoProductID / licentivo_product_id: Identificativo prodotto di licenza Licentivo, coerente con la configurazione pubblica di firma.
• trustedKeys / trusted_keys: Mappa degli identificativi delle chiavi alle chiavi pubbliche per verificare i permessi firmati dell’SDK ufficiale.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• remember, store: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Login(const char *email, const char *password) → void

Scopo

Accede all’account del negozio, ottiene un’attestazione temporanea e avvia l’SDK ufficiale di autorizzazione.

Parametri

• email, password: Email e password del cliente di questo negozio; password usata solo per questo accesso.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Restore() → bool

Scopo

Legge la sessione salvata, conferma l’account online, ottiene una nuova attestazione e avvia l’SDK ufficiale.

Valore restituito

bool

true indica ripristino riuscito; false indica nessuna sessione ripristinabile. Rifiuto, scadenza e rete producono errori.

RunFeature(const char *feature, Action action) → void

Scopo

L’SDK ufficiale verifica ogni esecuzione e avvia la callback solo se autorizzata.

Parametri

• feature / name, action / block: Il nome funzione deve corrispondere alla politica; la callback contiene il lavoro realmente protetto.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Logout() → void

Scopo

Ferma l’autorizzazione locale, disconnette l’SDK ufficiale e revoca la sessione Launch. Conserva le operazioni remote incompiute per riprovarle.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

ReleaseDevice() → void

Scopo

Ingresso compatibile per la disconnessione esplicita, con lo stesso flusso di account e dispositivo di Logout.

Valore restituito

void

Nessun valore operativo; il completamento normale indica successo, errori o eccezioni indicano fallimento.

Status() → std::string (JSON)

Scopo

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

Valore restituito

std::string (JSON)

Legge lo stato di autorizzazione dell’SDK ufficiale, senza accedere né sostituire i controlli delle funzioni.

~Application() → void

Scopo

Ferma questa istanza e le attività, conservando l’accesso memorizzato e l’associazione del dispositivo.

Valore restituito

void

Nessun valore operativo; la chiusura ordinaria non conferma disconnessione dell’account o rilascio del dispositivo.

Application(origin, product, config, environment="live", remember=false, store=nullptr) → Application

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• origin: Origine completa del negozio con protocollo e porta necessaria; usa HTTPS in produzione.
• product: Identificativo prodotto Launch, compilato automaticamente dal codice d’integrazione amministrativo.
• config: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• environment: sandbox o live; account, prodotti e cache devono condividere l’ambiente.
• remember, store: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

explicit Application(launch_application *app) → Application

Scopo

Valida le impostazioni pubbliche e crea l’applicazione, senza accedere all’account né autorizzare funzioni protette.

Parametri

• app: Restituisce un puntatore posseduto; NULL indica inizializzazione fallita. Liberalo con close.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Application::FromFiles(launch, product, remember=false, store=nullptr) → Application

Scopo

Legge due configurazioni pubbliche esistenti, verifica i prodotti e crea l’applicazione. La connessione diretta non richiede file.

Parametri

• launch, product: Percorsi di configurazione scelti o cartella privata di cache e archivio dell’utente corrente.
• remember, store: Opzioni per archivio sessioni, cache privata, annullamento, tentativi o componenti avanzati.

Valore restituito

Application

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.

Application(Application&& other) / operator=(Application&& other) → Application / Application&

Scopo

Trasferisce la proprietà dell’applicazione nativa. La copia è disabilitata e l’oggetto originale non possiede più il puntatore.

Parametri

• other: Oggetti configurazione, adattatore runtime, trasporto o richiesta, solo per integrazioni avanzate.

Valore restituito

Application / Application&

Restituisce l’oggetto creato; l’inizializzazione non dimostra un’autorizzazione.