Fonctions SDK et valeurs renvoyées dans neuf langages

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

(*Application, error)

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.
• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.

Résultat

(State, error)

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

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

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

(State, error)

Renvoie l’état du compte ; ErrNoSession ou NO_SESSION signifie aucune session. Traitez les autres erreurs séparément.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Logout(ctx context.Context) → error

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

ReleaseDevice(ctx context.Context) → error

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Close() → void

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

void

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

(*Application, error)

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• launchPath, productPath: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

(*Application, error)

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

LoadPublicConfig(path string) → (PublicConfig, error)

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• path: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

(PublicConfig, error)

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Crée l’adaptateur du SDK officiel pour les intégrations avancées ; l’attestation reste en mémoire.

Paramètres

• product, runtime: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

(Runtime, error)

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• allowLocalHTTP: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

(*Client, error)

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

WithToken(token string) → *Client

Rôle

Renvoie une copie du client avec le jeton fourni, réservée aux serveurs de confiance.

Paramètres

• token: Jeton de session Launch, accessible uniquement aux interfaces de session bas niveau ou de stockage chiffré.

Résultat

*Client

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Authentifie le compte et renvoie ses informations ou sa session, sans démarrer le moteur d’autorisation.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.
• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.

Résultat

(User, error)

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

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

Rôle

Authentifie le compte et renvoie ses informations ou sa session, sans démarrer le moteur d’autorisation.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.
• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.

Résultat

(Session, error)

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

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

Rôle

Consulte le compte actuel ; le succès n’autorise pas les fonctions protégées.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

(User, error)

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

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

Rôle

Obtient une attestation d’identité à usage unique et le routage public, sans licence ni droit de fonction.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.
• product: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.

Résultat

(Identity, error)

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

SignOut(ctx context.Context) → error

Rôle

Révoque la session Launch et efface le jeton du client, sans remplacer la déconnexion de l’appareil du SDK officiel.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Ancienne API conservée : le protocole de licence permanente a été retiré, donc les appels échouent. Utilisez Application.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.
• product: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.

Résultat

(Credential, error)

Échoue toujours ; migrez vers l’échange d’identité de compte.

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

Rôle

Ancienne API conservée : le protocole de licence permanente a été retiré, donc les appels échouent. Utilisez Application.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.
• product: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• policy: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

(Credential, error)

Échoue toujours ; migrez vers l’échange d’identité de compte.

NewSystemSessionStore(directory string) → (SessionStore, error)

Rôle

Crée un stockage persistant protégé ; récupérez la clé dans le coffre d’identifiants du système.

Paramètres

• directory: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

(SessionStore, error)

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

ProtectDirectory(directory string) → error

Rôle

Limite l’accès au dossier à l’utilisateur Windows actuel ou aux permissions privées des autres plateformes.

Paramètres

• directory: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

ServiceUnavailable(err error) → bool

Rôle

Identifie une indisponibilité temporaire ; cela n’autorise jamais à travailler hors ligne.

Paramètres

• err: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

bool

Renvoie une classification booléenne, pas une autorisation.

Error() → string

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

string

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

Unwrap() → error

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

error

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Charge un compte par clé isolée ; les données secrètes sont réservées au SDK.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

([]byte, error)

Renvoie le compte secret ; son absence donne une valeur vide ou ErrNoSession selon le langage.

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

Rôle

Enregistre atomiquement le compte sous sa clé isolée.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Supprime le compte sans supprimer le cache d’autorisation ni le journal de déconnexion du SDK officiel.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Démarre la vérification et les tâches SDK officielles ; connexion et protection des fonctions restent séparées.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.
• onError: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Deactivate(ctx context.Context) → error

Rôle

Déconnecte l’appareil via le SDK officiel ; l’application révoque séparément la session Launch.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

error

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Close() → void

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

void

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.
• pending_attempts: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application (self)

Renvoie cette instance d’application, pas des informations de compte ni une autorisation.

restore() → bool

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Résultat

bool

true indique une restauration réussie ; false indique aucune session restaurable. Refus, expiration et problèmes réseau produisent une erreur.

run_feature(name, action) → T

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

T

Renvoie le résultat du rappel métier ; les refus et exceptions sont signalés comme erreurs.

logout() → bool

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Résultat

bool

true confirme la déconnexion ; false indique une déconnexion distante ou révocation d’appareil en attente. Le stockage peut aussi produire une erreur.

release_device() → bool

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Résultat

bool

true confirme la déconnexion ; false indique une déconnexion distante ou révocation d’appareil en attente. Le stockage peut aussi produire une erreur.

close() → None

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

None

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

Application / None

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• product_config: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• launch_config, product_config: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

MemoryStore() → MemoryStore

Rôle

Crée un stockage de session limité au processus actuel.

Résultat

MemoryStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

WindowsDPAPIStore(directory=None) → WindowsDPAPIStore

Rôle

Crée un stockage persistant protégé ; récupérez la clé dans le coffre d’identifiants du système.

Paramètres

• directory: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

WindowsDPAPIStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Paramètres

• code, status, retry_after: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

APIError

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

load(key) → bytes | None

Rôle

Charge un compte par clé isolée ; les données secrètes sont réservées au SDK.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

bytes | None

Renvoie le compte secret ; son absence donne une valeur vide ou ErrNoSession selon le langage.

save(key, value) → None

Rôle

Enregistre atomiquement le compte sous sa clé isolée.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

None

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

delete(key) → None

Rôle

Supprime le compte sans supprimer le cache d’autorisation ni le journal de déconnexion du SDK officiel.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

None

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• store, cacheDirectory: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.
• pendingAttempts: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.
• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Task

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Task<bool>

true indique une restauration réussie ; false indique aucune session restaurable. Refus, expiration et problèmes réseau produisent une erreur.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

Task

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

Résultat

AuthorizationStatus? (null: runtime absent)

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

Logout(CancellationToken ct=default) → Task

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Task

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

ReleaseDevice(CancellationToken ct=default) → Task

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Task

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

DisposeAsync() → ValueTask

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

ValueTask

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productId: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• productConfig: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• launchPath, productPath: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• store: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

new MemoryStore() → MemoryStore

Rôle

Crée un stockage de session limité au processus actuel.

Résultat

MemoryStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

new WindowsDPAPIStore(string? directory=null) → WindowsDPAPIStore

Rôle

Crée un stockage persistant protégé ; récupérez la clé dans le coffre d’identifiants du système.

Paramètres

• directory: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

WindowsDPAPIStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Paramètres

• code, status, retryAfterSeconds: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

LaunchException

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

Load(string key) → byte[]?

Rôle

Charge un compte par clé isolée ; les données secrètes sont réservées au SDK.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

byte[]?

Renvoie le compte secret ; son absence donne une valeur vide ou ErrNoSession selon le langage.

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

Rôle

Enregistre atomiquement le compte sous sa clé isolée.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Delete(string key) → void

Rôle

Supprime le compte sans supprimer le cache d’autorisation ni le journal de déconnexion du SDK officiel.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Start(CancellationToken ct) → Task

Rôle

Démarre la vérification et les tâches SDK officielles ; connexion et protection des fonctions restent séparées.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Task

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Status() → AuthorizationStatus

Rôle

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

Résultat

AuthorizationStatus

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

Task

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Deactivate(CancellationToken ct) → Task

Rôle

Déconnecte l’appareil via le SDK officiel ; l’application révoque séparément la session Launch.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Task

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

DisposeAsync() → ValueTask

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

ValueTask

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.

Résultat

Launch

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.

Résultat

State

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

restore() → State

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Résultat

State

Renvoie l’état du compte ; ErrNoSession ou NO_SESSION signifie aucune session. Traitez les autres erreurs séparément.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

logout() → void

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

releaseDevice() → void

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

close() → void

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

void

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• config, product: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• cacheRoot: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• store, transport, factory, sleeper: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Launch

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.

Résultat

Config

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

Launch.Config.load(Path path) → Config

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• path: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

Config

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• path: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

Map<String,Object>

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

new Launch.MemoryStore() → MemoryStore

Rôle

Crée un stockage de session limité au processus actuel.

Résultat

MemoryStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

new EncryptedFileStore(Path directory, SecretKey vaultKey) → EncryptedFileStore

Rôle

Crée un stockage persistant protégé ; récupérez la clé dans le coffre d’identifiants du système.

Paramètres

• directory: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• vaultKey: Clé de chiffrement issue du coffre système ; ne la stockez pas avec les données chiffrées.

Résultat

EncryptedFileStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Envoie les requêtes HTTP du compte et renvoie statut, en-têtes ou corps brut, sans décider de l’autorisation.

Paramètres

• method, uri, bearer, body: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

Response

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Paramètres

• code, status, requestID, retryAfterMillis, transport: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

Failure

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

unavailable() → boolean

Rôle

Identifie une indisponibilité temporaire ; cela n’autorise jamais à travailler hors ligne.

Résultat

boolean

Renvoie une classification booléenne, pas une autorisation.

load(String scope) → byte[] | null

Rôle

Charge un compte par clé isolée ; les données secrètes sont réservées au SDK.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

byte[] | null

Renvoie le compte secret ; son absence donne une valeur vide ou ErrNoSession selon le langage.

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

Rôle

Enregistre atomiquement le compte sous sa clé isolée.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

delete(String scope) → void

Rôle

Supprime le compte sans supprimer le cache d’autorisation ni le journal de déconnexion du SDK officiel.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

canStartOffline() → boolean

Rôle

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

Résultat

boolean

Renvoie une classification booléenne, pas une autorisation.

start() → void

Rôle

Démarre la vérification et les tâches SDK officielles ; connexion et protection des fonctions restent séparées.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

releaseDevice() → void

Rôle

Déconnecte l’appareil via le SDK officiel ; l’application révoque séparément la session Launch.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

close() → void

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

void

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Crée l’adaptateur du SDK officiel pour les intégrations avancées ; l’attestation reste en mémoire.

Paramètres

• settings: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

Runtime

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

sleep(long milliseconds) → void

Rôle

Attend la durée indiquée pour planifier les nouvelles tentatives avancées.

Paramètres

• milliseconds: Délai recommandé avant nouvelle tentative ; vérifiez les unités : secondes, millisecondes ou Duration.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.
• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Promise<SessionState>

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

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

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Promise<SessionState | null>

Renvoie l’état du compte ; null ou nil signifie aucune session restaurable. Les autres échecs produisent une erreur.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

Promise<T>

Renvoie le résultat du rappel métier ; les refus et exceptions sont signalés comme erreurs.

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

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Promise<boolean>

true confirme la déconnexion ; false indique une déconnexion distante ou révocation d’appareil en attente. Le stockage peut aussi produire une erreur.

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

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Promise<void>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

close() → Promise<void>

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

Promise<void>

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• launch, product: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• launchPath, productPath: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Promise<Application>

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• launch, product: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

{launch: LaunchConfig, product: PublicProductConfig}

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• launchPath, productPath: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

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

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

defaultTransport(request: Request) → Promise<Response>

Rôle

Envoie les requêtes HTTP du compte et renvoie statut, en-têtes ou corps brut, sans décider de l’autorisation.

Paramètres

• request: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

Promise<Response>

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

new MemoryStore() → MemoryStore

Rôle

Crée un stockage de session limité au processus actuel.

Résultat

MemoryStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Crée un stockage persistant protégé ; récupérez la clé dans le coffre d’identifiants du système.

Paramètres

• directory: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• key: Clé de chiffrement issue du coffre système ; ne la stockez pas avec les données chiffrées.

Résultat

EncryptedFileStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Paramètres

• code, status, retryAfterSeconds: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

LaunchError

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Charge un compte par clé isolée ; les données secrètes sont réservées au SDK.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

Promise<SavedSession | null>

Renvoie le compte secret ; son absence donne une valeur vide ou ErrNoSession selon le langage.

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

Rôle

Enregistre atomiquement le compte sous sa clé isolée.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

Promise<void>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

delete(scope: string) → Promise<void>

Rôle

Supprime le compte sans supprimer le cache d’autorisation ni le journal de déconnexion du SDK officiel.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

Promise<void>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

Résultat

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

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

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

Rôle

Démarre la vérification et les tâches SDK officielles ; connexion et protection des fonctions restent séparées.

Paramètres

• onError: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.
• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Promise<unknown>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

Promise<T>

Renvoie le résultat du rappel métier ; les refus et exceptions sont signalés comme erreurs.

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

Rôle

Déconnecte l’appareil via le SDK officiel ; l’application révoque séparément la session Launch.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Promise<unknown>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Déconnecte l’appareil via le SDK officiel ; l’application révoque séparément la session Launch.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

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

Déconnexion locale et révocation distante sont distinctes. Gérez les tâches en attente et erreurs de stockage ; conservez le journal SDK.

close() → Promise<unknown>

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

Promise<unknown>

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.

Résultat

Result<Application, Failure>

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.

Résultat

Result<State, Failure>

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

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

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Résultat

Result<State, Failure>

Renvoie l’état du compte ; ErrNoSession ou NO_SESSION signifie aucune session. Traitez les autres erreurs séparément.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

Result<T, Failure>

Renvoie le résultat du rappel métier ; les refus et exceptions sont signalés comme erreurs.

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

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Résultat

Result<(), Failure>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Résultat

Result<(), Failure>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

()

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• config, product: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• cache_root: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

Result<Application, Failure>

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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>

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• config, product: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• cache_root: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• store, transport, factory, sleeper: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Result<Application, Failure>

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.

Résultat

Result<Config, Failure>

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• path: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

Result<Config, Failure>

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• path: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

Result<Value, Failure>

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

MemoryStore::default() → MemoryStore

Rôle

Crée un stockage de session limité au processus actuel.

Résultat

MemoryStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Crée un stockage persistant protégé ; récupérez la clé dans le coffre d’identifiants du système.

Paramètres

• root: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• vault_key: Clé de chiffrement issue du coffre système ; ne la stockez pas avec les données chiffrées.

Résultat

Result<EncryptedFileStore, Failure>

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Envoie les requêtes HTTP du compte et renvoie statut, en-têtes ou corps brut, sans décider de l’autorisation.

Résultat

Result<CurlTransport, Failure>

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Envoie les requêtes HTTP du compte et renvoie statut, en-têtes ou corps brut, sans décider de l’autorisation.

Paramètres

• method, url, bearer, body: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

Result<Response, Failure>

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Paramètres

• code: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

Failure

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Attend la durée indiquée pour planifier les nouvelles tentatives avancées.

Paramètres

• duration: Délai recommandé avant nouvelle tentative ; vérifiez les unités : secondes, millisecondes ou Duration.

Résultat

Result<(), Failure>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Charge un compte par clé isolée ; les données secrètes sont réservées au SDK.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

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

Renvoie le compte secret ; son absence donne une valeur vide ou ErrNoSession selon le langage.

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

Rôle

Enregistre atomiquement le compte sous sa clé isolée.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

Result<(), Failure>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Supprime le compte sans supprimer le cache d’autorisation ni le journal de déconnexion du SDK officiel.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

Result<(), Failure>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

Result<(), Failure>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Déconnecte l’appareil via le SDK officiel ; l’application révoque séparément la session Launch.

Résultat

Result<(), Failure>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

close(&mut self) → ()

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

()

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Crée l’adaptateur du SDK officiel pour les intégrations avancées ; l’attestation reste en mémoire.

Paramètres

• settings, cached_only: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

Result<Box<dyn Runtime>, Failure>

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Crée l’adaptateur du SDK officiel pour les intégrations avancées ; l’attestation reste en mémoire.

Paramètres

• settings: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

Result<Box<dyn Runtime>, Failure>

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Attend la durée indiquée pour planifier les nouvelles tentatives avancées.

Paramètres

• duration: Délai recommandé avant nouvelle tentative ; vérifiez les unités : secondes, millisecondes ou Duration.

Résultat

Result<(), Failure>

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.
• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Hash

Renvoie l’état du compte ; consultez le tableau des champs ci-dessous.

restore(cancellation: nil) → Hash | nil

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

Hash | nil

Renvoie l’état du compte ; null ou nil signifie aucune session restaurable. Les autres échecs produisent une erreur.

run_feature(feature) { ... } → T

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

T

Renvoie le résultat du rappel métier ; les refus et exceptions sont signalés comme erreurs.

logout(cancellation: nil) → true | false

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

true | false

true confirme la déconnexion ; false indique une déconnexion distante ou révocation d’appareil en attente. Le stockage peut aussi produire une erreur.

release_device(cancellation: nil) → true | false

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Paramètres

• ctx / ct / signal / cancellation: Contexte de requête ou signal d’annulation ; le contexte de cycle de vie Go contrôle aussi les tâches de fond.

Résultat

true | false

true confirme la déconnexion ; false indique une déconnexion distante ou révocation d’appareil en attente. Le stockage peut aussi produire une erreur.

close → nil

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

nil

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• launch, product: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• launchPath, productPath: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• options / config: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

LicentivoLaunch.origin(value, environment) → String

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• value: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.

Résultat

String

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• launch, product: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

[Hash, Hash]

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• launchPath, productPath: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.

Résultat

[Hash, Hash]

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

LicentivoLaunch.default_transport(request) → Hash

Rôle

Envoie les requêtes HTTP du compte et renvoie statut, en-têtes ou corps brut, sans décider de l’autorisation.

Paramètres

• request: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

Hash

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

MemoryStore.new → MemoryStore

Rôle

Crée un stockage de session limité au processus actuel.

Résultat

MemoryStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

EncryptedFileStore.new(directory, key) → EncryptedFileStore

Rôle

Crée un stockage persistant protégé ; récupérez la clé dans le coffre d’identifiants du système.

Paramètres

• directory: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• key: Clé de chiffrement issue du coffre système ; ne la stockez pas avec les données chiffrées.

Résultat

EncryptedFileStore

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

persistent? / secure? → true | false

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Résultat

true | false

Renvoie une classification booléenne, pas une autorisation.

path(scope) → String

Rôle

Valide ou lit la configuration publique ; produits, environnement et clés de signature doivent correspondre.

Paramètres

• scope: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

String

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

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

Rôle

Demande ou vérifie l’annulation coopérative ; une annulation n’est pas une autorisation réussie.

Résultat

true / nil

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Paramètres

• code, status, retry_after_seconds: Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

Error

Renvoie le type indiqué dans la signature ; le résultat n’accorde aucun droit de fonction.

load(scope) → Hash | nil

Rôle

Charge un compte par clé isolée ; les données secrètes sont réservées au SDK.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

Hash | nil

Renvoie le compte secret ; son absence donne une valeur vide ou ErrNoSession selon le langage.

save(scope, record) → Object

Rôle

Enregistre atomiquement le compte sous sa clé isolée.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

Object

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

delete(scope) → Object

Rôle

Supprime le compte sans supprimer le cache d’autorisation ni le journal de déconnexion du SDK officiel.

Paramètres

• scope / key, value / record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

Object

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• remember, store: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

launch_application *

Renvoie un pointeur possédé ; NULL indique un échec d’initialisation. Libérez-le avec close.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.

Résultat

int

1 indique le succès ; 0 indique l’échec. Lisez ensuite le code d’erreur.

launch_application_restore(launch_application *app) → int

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Résultat

int

1 : restauration réussie ; 0 : aucune session ; -1 : refus ou échec. Lisez le code d’erreur après échec.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.
• context: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

int

1 indique le succès ; 0 indique l’échec. Lisez ensuite le code d’erreur.

launch_application_logout(launch_application *app) → int

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Résultat

int

1 indique le succès ; 0 indique l’échec. Lisez ensuite le code d’erreur.

launch_application_release_device(launch_application *app) → int

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Résultat

int

1 indique le succès ; 0 indique l’échec. Lisez ensuite le code d’erreur.

launch_application_status(launch_application *app) → char *

Rôle

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

Résultat

char *

Renvoie un texte JSON possédé à libérer avec ln_free_string. Sans moteur : login_required et allowed=false.

launch_application_error(const launch_application *app) → const char *

Rôle

Crée ou lit une erreur structurée pour classification, temporisation et diagnostic.

Résultat

const char *

Renvoie une chaîne d’erreur empruntée. Ne la libérez pas et ne l’utilisez pas après destruction de l’application.

launch_application_close(launch_application *app) → void

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

void

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• product_config_path: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• remember, store: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

launch_application *

Renvoie un pointeur possédé ; NULL indique un échec d’initialisation. Libérez-le avec close.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• launchPath, productPath: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• remember, store: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

launch_application *

Renvoie un pointeur possédé ; NULL indique un échec d’initialisation. Libérez-le avec close.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• argc, argv: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

launch_application *

Renvoie un pointeur possédé ; NULL indique un échec d’initialisation. Libérez-le avec close.

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

Rôle

Ancienne API conservée : le protocole de licence permanente a été retiré, donc les appels échouent. Utilisez Application.

Paramètres

• account, origin, product_id, config_path, environment, email, password, argc, argv: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

int

Échoue toujours ; migrez vers l’échange d’identité de compte.

launch_sign_out(launch_account *account, int clear_cache) → void

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Paramètres

• account, clear_cache: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

ln_free_string(char *value) → void

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Paramètres

• value: Renvoie un texte JSON possédé à libérer avec ln_free_string. Sans moteur : login_required et allowed=false.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Charge un compte par clé isolée ; les données secrètes sont réservées au SDK.

Paramètres

• context: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• scope, record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

int

1 : trouvé, 0 : absent, -1 : lecture échouée. load alloue record ; l’appelant le libère.

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

Rôle

Enregistre atomiquement le compte sous sa clé isolée.

Paramètres

• context: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• scope, record: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

int (1: success, 0: failure)

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Supprime le compte sans supprimer le cache d’autorisation ni le journal de déconnexion du SDK officiel.

Paramètres

• context: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.
• scope: Clés d’isolation et données secrètes SDK ; le stockage personnalisé doit gérer plusieurs clés et le remplacement atomique.

Résultat

int (1: success, 0: failure)

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

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

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• merchantOrigin / origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• productID / product_id: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• licentivoProductID / licentivo_product_id: Identifiant du produit de licence Licentivo, correspondant à la configuration de signature publique.
• trustedKeys / trusted_keys: Correspondance entre identifiants de clés et clés publiques pour vérifier les autorisations signées du SDK officiel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• remember, store: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Connecte le compte client, obtient une attestation d’identité temporaire et démarre le SDK officiel d’autorisation.

Paramètres

• email, password: Adresse électronique et mot de passe du compte client de cette boutique ; mot de passe limité à cette connexion.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Restore() → bool

Rôle

Lit la session mémorisée, confirme le compte en ligne, obtient une nouvelle attestation et démarre le SDK officiel.

Résultat

bool

true indique une restauration réussie ; false indique aucune session restaurable. Refus, expiration et problèmes réseau produisent une erreur.

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

Rôle

Le SDK officiel vérifie chaque exécution. Le rappel ne s’exécute que si l’autorisation est accordée.

Paramètres

• feature / name, action / block: Le nom de fonction doit correspondre à la politique ; le rappel contient le travail réellement protégé.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Logout() → void

Rôle

Arrête l’autorisation locale, déconnecte le SDK officiel puis révoque la session Launch. Les tâches distantes inachevées restent à réessayer.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

ReleaseDevice() → void

Rôle

Entrée compatible de déconnexion explicite, avec le même processus de déconnexion du compte et de l’appareil que Logout.

Résultat

void

Aucune valeur métier ; un retour normal indique le succès, une erreur ou exception indique l’échec.

Status() → std::string (JSON)

Rôle

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

Résultat

std::string (JSON)

Lit l’état d’autorisation du SDK officiel, sans connecter le compte ni remplacer les vérifications des fonctions.

~Application() → void

Rôle

Arrête cette instance et ses tâches tout en conservant la connexion mémorisée et l’association de l’appareil.

Résultat

void

Aucune valeur métier ; fermer l’application ne confirme ni déconnexion du compte ni libération de l’appareil.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• origin: Origine complète de la boutique, avec protocole et port nécessaire ; utilisez HTTPS en production.
• product: Identifiant produit Launch, rempli automatiquement par le code d’intégration de l’administration.
• config: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• environment: sandbox ou live ; comptes, produits et caches doivent partager le même environnement.
• remember, store: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

explicit Application(launch_application *app) → Application

Rôle

Valide les paramètres publics et crée l’application, sans connexion au compte ni autorisation des fonctions protégées.

Paramètres

• app: Renvoie un pointeur possédé ; NULL indique un échec d’initialisation. Libérez-le avec close.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Lit deux configurations publiques existantes, vérifie la correspondance des produits et crée l’application. La connexion directe ne nécessite aucun fichier.

Paramètres

• launch, product: Chemins de configuration choisis ou dossier privé de cache et stockage de l’utilisateur actuel.
• remember, store: Options de stockage, cache privé, annulation, nouvelles tentatives ou composants avancés.

Résultat

Application

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.

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

Rôle

Transfère la propriété de l’application native. La copie est désactivée et l’objet d’origine ne possède plus le pointeur.

Paramètres

• other: Configuration, adaptateur, transport ou requête fournis uniquement pour les intégrations avancées.

Résultat

Application / Application&

Renvoie l’objet créé ; l’initialisation ne constitue pas une autorisation.