Funciones y valores devueltos del SDK en nueve lenguajes

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

(*Application, error)

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.
• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.

Resultado

(State, error)

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

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

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

(State, error)

Devuelve el estado; ErrNoSession o NO_SESSION indica que no hay sesión guardada. Trata otros errores por separado.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Logout(ctx context.Context) → error

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

ReleaseDevice(ctx context.Context) → error

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Close() → void

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

void

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

(*Application, error)

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• launchPath, productPath: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

(*Application, error)

Devuelve el objeto creado; la inicialización no demuestra autorización.

LoadPublicConfig(path string) → (PublicConfig, error)

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• path: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

(PublicConfig, error)

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Crea el adaptador del SDK oficial para integraciones avanzadas; la declaración solo se transmite en memoria.

Parámetros

• product, runtime: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

(Runtime, error)

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• allowLocalHTTP: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

(*Client, error)

Devuelve el objeto creado; la inicialización no demuestra autorización.

WithToken(token string) → *Client

Propósito

Devuelve una copia del cliente con el token indicado, para servidores de confianza.

Parámetros

• token: Token de sesión Launch, devuelto solo por interfaces de sesión de bajo nivel o almacenamiento cifrado.

Resultado

*Client

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Autentica la cuenta y devuelve información o sesión, sin iniciar el motor de autorización.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.
• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.

Resultado

(User, error)

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

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

Propósito

Autentica la cuenta y devuelve información o sesión, sin iniciar el motor de autorización.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.
• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.

Resultado

(Session, error)

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

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

Propósito

Consulta la cuenta actual; el éxito no autoriza funciones protegidas.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

(User, error)

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

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

Propósito

Obtiene una declaración de identidad de un solo uso y contexto público; no son una licencia ni permisos de función.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.
• product: Identificador del producto Launch, completado por el código de integración de administración.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.

Resultado

(Identity, error)

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

SignOut(ctx context.Context) → error

Propósito

Revoca la sesión Launch y borra el token del cliente; no sustituye el cierre de sesión del dispositivo del SDK oficial.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

API heredada conservada: se eliminó el protocolo de credenciales de licencia permanente y las llamadas fallan. Usa Application.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.
• product: Identificador del producto Launch, completado por el código de integración de administración.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.

Resultado

(Credential, error)

Siempre falla; migra al intercambio de identidad de cuenta.

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

Propósito

API heredada conservada: se eliminó el protocolo de credenciales de licencia permanente y las llamadas fallan. Usa Application.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.
• product: Identificador del producto Launch, completado por el código de integración de administración.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• policy: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

(Credential, error)

Siempre falla; migra al intercambio de identidad de cuenta.

NewSystemSessionStore(directory string) → (SessionStore, error)

Propósito

Crea almacenamiento persistente protegido; obtén la clave de cifrado del almacén de credenciales del sistema.

Parámetros

• directory: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

(SessionStore, error)

Devuelve el objeto creado; la inicialización no demuestra autorización.

ProtectDirectory(directory string) → error

Propósito

Restringe el directorio al usuario actual de Windows o a permisos privados en otras plataformas.

Parámetros

• directory: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

ServiceUnavailable(err error) → bool

Propósito

Identifica una indisponibilidad temporal; esto nunca autoriza el uso sin conexión.

Parámetros

• err: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

bool

Devuelve una clasificación booleana, no una autorización.

Error() → string

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

string

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

Unwrap() → error

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

error

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Carga la cuenta mediante una clave aislada; contiene secretos destinados únicamente al SDK.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

([]byte, error)

Devuelve el registro secreto; su ausencia devuelve un valor vacío o ErrNoSession según el lenguaje.

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

Propósito

Guarda atómicamente la cuenta bajo su clave aislada.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Elimina la cuenta sin borrar la caché de autorización ni el registro de cierre del SDK oficial.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Inicia verificación y mantenimiento del SDK oficial; usa por separado las API de acceso y protección.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.
• onError: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Deactivate(ctx context.Context) → error

Propósito

Cierra la sesión del dispositivo con el SDK oficial; la aplicación revoca aparte la sesión Launch.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

error

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Close() → void

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

void

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.
• pending_attempts: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application (self)

Devuelve esta instancia de aplicación, no información de cuenta ni un resultado de autorización.

restore() → bool

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Resultado

bool

true indica restauración correcta; false indica que no hay sesión restaurable. Los rechazos, vencimientos y errores de red generan errores.

run_feature(name, action) → T

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

T

Devuelve el resultado de la función de negocio; los fallos de autorización y excepciones generan errores.

logout() → bool

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Resultado

bool

true confirma el cierre; false indica cierre remoto o revocación de dispositivo pendiente. El almacenamiento también puede producir errores.

release_device() → bool

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Resultado

bool

true confirma el cierre; false indica cierre remoto o revocación de dispositivo pendiente. El almacenamiento también puede producir errores.

close() → None

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

None

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

Application / None

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• product_id: Identificador del producto Launch, completado por el código de integración de administración.
• product_config: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• launch_config, product_config: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

MemoryStore() → MemoryStore

Propósito

Crea almacenamiento de sesión válido únicamente durante este proceso.

Resultado

MemoryStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

WindowsDPAPIStore(directory=None) → WindowsDPAPIStore

Propósito

Crea almacenamiento persistente protegido; obtén la clave de cifrado del almacén de credenciales del sistema.

Parámetros

• directory: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

WindowsDPAPIStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Parámetros

• code, status, retry_after: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

APIError

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

load(key) → bytes | None

Propósito

Carga la cuenta mediante una clave aislada; contiene secretos destinados únicamente al SDK.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

bytes | None

Devuelve el registro secreto; su ausencia devuelve un valor vacío o ErrNoSession según el lenguaje.

save(key, value) → None

Propósito

Guarda atómicamente la cuenta bajo su clave aislada.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

None

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

delete(key) → None

Propósito

Elimina la cuenta sin borrar la caché de autorización ni el registro de cierre del SDK oficial.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

None

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• store, cacheDirectory: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.
• pendingAttempts: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.
• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Task

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Task<bool>

true indica restauración correcta; false indica que no hay sesión restaurable. Los rechazos, vencimientos y errores de red generan errores.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

Task

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

Resultado

AuthorizationStatus? (null: runtime absent)

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

Logout(CancellationToken ct=default) → Task

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Task

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

ReleaseDevice(CancellationToken ct=default) → Task

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Task

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

DisposeAsync() → ValueTask

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

ValueTask

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productId: Identificador del producto Launch, completado por el código de integración de administración.
• productConfig: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• launchPath, productPath: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• store: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

new MemoryStore() → MemoryStore

Propósito

Crea almacenamiento de sesión válido únicamente durante este proceso.

Resultado

MemoryStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

new WindowsDPAPIStore(string? directory=null) → WindowsDPAPIStore

Propósito

Crea almacenamiento persistente protegido; obtén la clave de cifrado del almacén de credenciales del sistema.

Parámetros

• directory: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

WindowsDPAPIStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Parámetros

• code, status, retryAfterSeconds: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

LaunchException

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

Load(string key) → byte[]?

Propósito

Carga la cuenta mediante una clave aislada; contiene secretos destinados únicamente al SDK.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

byte[]?

Devuelve el registro secreto; su ausencia devuelve un valor vacío o ErrNoSession según el lenguaje.

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

Propósito

Guarda atómicamente la cuenta bajo su clave aislada.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Delete(string key) → void

Propósito

Elimina la cuenta sin borrar la caché de autorización ni el registro de cierre del SDK oficial.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Start(CancellationToken ct) → Task

Propósito

Inicia verificación y mantenimiento del SDK oficial; usa por separado las API de acceso y protección.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Task

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Status() → AuthorizationStatus

Propósito

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

Resultado

AuthorizationStatus

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

Task

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Deactivate(CancellationToken ct) → Task

Propósito

Cierra la sesión del dispositivo con el SDK oficial; la aplicación revoca aparte la sesión Launch.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Task

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

DisposeAsync() → ValueTask

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

ValueTask

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.

Resultado

Launch

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.

Resultado

State

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

restore() → State

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Resultado

State

Devuelve el estado; ErrNoSession o NO_SESSION indica que no hay sesión guardada. Trata otros errores por separado.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

logout() → void

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

releaseDevice() → void

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

close() → void

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

void

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• config, product: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• cacheRoot: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• store, transport, factory, sleeper: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Launch

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.

Resultado

Config

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

Launch.Config.load(Path path) → Config

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• path: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

Config

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• path: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

Map<String,Object>

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

new Launch.MemoryStore() → MemoryStore

Propósito

Crea almacenamiento de sesión válido únicamente durante este proceso.

Resultado

MemoryStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

new EncryptedFileStore(Path directory, SecretKey vaultKey) → EncryptedFileStore

Propósito

Crea almacenamiento persistente protegido; obtén la clave de cifrado del almacén de credenciales del sistema.

Parámetros

• directory: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• vaultKey: Clave de cifrado del almacén de credenciales del sistema; nunca la guardes junto a los registros cifrados.

Resultado

EncryptedFileStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Envía solicitudes HTTP de cuenta y devuelve estado, cabeceras o cuerpo sin procesar; no decide autorizaciones.

Parámetros

• method, uri, bearer, body: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

Response

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Parámetros

• code, status, requestID, retryAfterMillis, transport: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

Failure

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

unavailable() → boolean

Propósito

Identifica una indisponibilidad temporal; esto nunca autoriza el uso sin conexión.

Resultado

boolean

Devuelve una clasificación booleana, no una autorización.

load(String scope) → byte[] | null

Propósito

Carga la cuenta mediante una clave aislada; contiene secretos destinados únicamente al SDK.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

byte[] | null

Devuelve el registro secreto; su ausencia devuelve un valor vacío o ErrNoSession según el lenguaje.

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

Propósito

Guarda atómicamente la cuenta bajo su clave aislada.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

delete(String scope) → void

Propósito

Elimina la cuenta sin borrar la caché de autorización ni el registro de cierre del SDK oficial.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

canStartOffline() → boolean

Propósito

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

Resultado

boolean

Devuelve una clasificación booleana, no una autorización.

start() → void

Propósito

Inicia verificación y mantenimiento del SDK oficial; usa por separado las API de acceso y protección.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

releaseDevice() → void

Propósito

Cierra la sesión del dispositivo con el SDK oficial; la aplicación revoca aparte la sesión Launch.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

close() → void

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

void

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Crea el adaptador del SDK oficial para integraciones avanzadas; la declaración solo se transmite en memoria.

Parámetros

• settings: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

Runtime

Devuelve el objeto creado; la inicialización no demuestra autorización.

sleep(long milliseconds) → void

Propósito

Espera el tiempo indicado para programar reintentos avanzados.

Parámetros

• milliseconds: Espera recomendada antes de reintentar; distingue segundos, milisegundos y Duration según el lenguaje.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.
• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Promise<SessionState>

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

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

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Promise<SessionState | null>

Devuelve el estado de la cuenta; null o nil indica que no hay sesión restaurable. Otros fallos generan errores.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

Promise<T>

Devuelve el resultado de la función de negocio; los fallos de autorización y excepciones generan errores.

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

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Promise<boolean>

true confirma el cierre; false indica cierre remoto o revocación de dispositivo pendiente. El almacenamiento también puede producir errores.

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

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Promise<void>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

close() → Promise<void>

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

Promise<void>

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• launch, product: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• launchPath, productPath: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Promise<Application>

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• launch, product: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

{launch: LaunchConfig, product: PublicProductConfig}

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• launchPath, productPath: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

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

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

defaultTransport(request: Request) → Promise<Response>

Propósito

Envía solicitudes HTTP de cuenta y devuelve estado, cabeceras o cuerpo sin procesar; no decide autorizaciones.

Parámetros

• request: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

Promise<Response>

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

new MemoryStore() → MemoryStore

Propósito

Crea almacenamiento de sesión válido únicamente durante este proceso.

Resultado

MemoryStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Crea almacenamiento persistente protegido; obtén la clave de cifrado del almacén de credenciales del sistema.

Parámetros

• directory: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• key: Clave de cifrado del almacén de credenciales del sistema; nunca la guardes junto a los registros cifrados.

Resultado

EncryptedFileStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Parámetros

• code, status, retryAfterSeconds: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

LaunchError

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Carga la cuenta mediante una clave aislada; contiene secretos destinados únicamente al SDK.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

Promise<SavedSession | null>

Devuelve el registro secreto; su ausencia devuelve un valor vacío o ErrNoSession según el lenguaje.

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

Propósito

Guarda atómicamente la cuenta bajo su clave aislada.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

Promise<void>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

delete(scope: string) → Promise<void>

Propósito

Elimina la cuenta sin borrar la caché de autorización ni el registro de cierre del SDK oficial.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

Promise<void>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

Resultado

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

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

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

Propósito

Inicia verificación y mantenimiento del SDK oficial; usa por separado las API de acceso y protección.

Parámetros

• onError: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.
• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Promise<unknown>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

Promise<T>

Devuelve el resultado de la función de negocio; los fallos de autorización y excepciones generan errores.

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

Propósito

Cierra la sesión del dispositivo con el SDK oficial; la aplicación revoca aparte la sesión Launch.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Promise<unknown>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Cierra la sesión del dispositivo con el SDK oficial; la aplicación revoca aparte la sesión Launch.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

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

El cierre local y la revocación remota son distintos. Gestiona pendientes y fallos de almacenamiento; conserva el registro SDK.

close() → Promise<unknown>

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

Promise<unknown>

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.

Resultado

Result<Application, Failure>

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.

Resultado

Result<State, Failure>

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

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

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Resultado

Result<State, Failure>

Devuelve el estado; ErrNoSession o NO_SESSION indica que no hay sesión guardada. Trata otros errores por separado.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

Result<T, Failure>

Devuelve el resultado de la función de negocio; los fallos de autorización y excepciones generan errores.

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

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Resultado

Result<(), Failure>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Resultado

Result<(), Failure>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

()

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• config, product: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• cache_root: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

Result<Application, Failure>

Devuelve el objeto creado; la inicialización no demuestra autorización.

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>

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• config, product: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• cache_root: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• store, transport, factory, sleeper: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Result<Application, Failure>

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.

Resultado

Result<Config, Failure>

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• path: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

Result<Config, Failure>

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• path: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

Result<Value, Failure>

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

MemoryStore::default() → MemoryStore

Propósito

Crea almacenamiento de sesión válido únicamente durante este proceso.

Resultado

MemoryStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Crea almacenamiento persistente protegido; obtén la clave de cifrado del almacén de credenciales del sistema.

Parámetros

• root: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• vault_key: Clave de cifrado del almacén de credenciales del sistema; nunca la guardes junto a los registros cifrados.

Resultado

Result<EncryptedFileStore, Failure>

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Envía solicitudes HTTP de cuenta y devuelve estado, cabeceras o cuerpo sin procesar; no decide autorizaciones.

Resultado

Result<CurlTransport, Failure>

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Envía solicitudes HTTP de cuenta y devuelve estado, cabeceras o cuerpo sin procesar; no decide autorizaciones.

Parámetros

• method, url, bearer, body: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

Result<Response, Failure>

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Parámetros

• code: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

Failure

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Espera el tiempo indicado para programar reintentos avanzados.

Parámetros

• duration: Espera recomendada antes de reintentar; distingue segundos, milisegundos y Duration según el lenguaje.

Resultado

Result<(), Failure>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Carga la cuenta mediante una clave aislada; contiene secretos destinados únicamente al SDK.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

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

Devuelve el registro secreto; su ausencia devuelve un valor vacío o ErrNoSession según el lenguaje.

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

Propósito

Guarda atómicamente la cuenta bajo su clave aislada.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

Result<(), Failure>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Elimina la cuenta sin borrar la caché de autorización ni el registro de cierre del SDK oficial.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

Result<(), Failure>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

Result<(), Failure>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Cierra la sesión del dispositivo con el SDK oficial; la aplicación revoca aparte la sesión Launch.

Resultado

Result<(), Failure>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

close(&mut self) → ()

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

()

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Crea el adaptador del SDK oficial para integraciones avanzadas; la declaración solo se transmite en memoria.

Parámetros

• settings, cached_only: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

Result<Box<dyn Runtime>, Failure>

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Crea el adaptador del SDK oficial para integraciones avanzadas; la declaración solo se transmite en memoria.

Parámetros

• settings: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

Result<Box<dyn Runtime>, Failure>

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Espera el tiempo indicado para programar reintentos avanzados.

Parámetros

• duration: Espera recomendada antes de reintentar; distingue segundos, milisegundos y Duration según el lenguaje.

Resultado

Result<(), Failure>

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.
• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Hash

Devuelve el estado de la cuenta; consulta la tabla de campos inferior.

restore(cancellation: nil) → Hash | nil

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

Hash | nil

Devuelve el estado de la cuenta; null o nil indica que no hay sesión restaurable. Otros fallos generan errores.

run_feature(feature) { ... } → T

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

T

Devuelve el resultado de la función de negocio; los fallos de autorización y excepciones generan errores.

logout(cancellation: nil) → true | false

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

true | false

true confirma el cierre; false indica cierre remoto o revocación de dispositivo pendiente. El almacenamiento también puede producir errores.

release_device(cancellation: nil) → true | false

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Parámetros

• ctx / ct / signal / cancellation: Contexto de solicitud o señal de cancelación; el contexto de ciclo de vida Go controla también las tareas de fondo.

Resultado

true | false

true confirma el cierre; false indica cierre remoto o revocación de dispositivo pendiente. El almacenamiento también puede producir errores.

close → nil

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

nil

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• launch, product: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• launchPath, productPath: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• options / config: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

LicentivoLaunch.origin(value, environment) → String

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• value: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.

Resultado

String

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• launch, product: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

[Hash, Hash]

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• launchPath, productPath: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.

Resultado

[Hash, Hash]

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

LicentivoLaunch.default_transport(request) → Hash

Propósito

Envía solicitudes HTTP de cuenta y devuelve estado, cabeceras o cuerpo sin procesar; no decide autorizaciones.

Parámetros

• request: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

Hash

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

MemoryStore.new → MemoryStore

Propósito

Crea almacenamiento de sesión válido únicamente durante este proceso.

Resultado

MemoryStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

EncryptedFileStore.new(directory, key) → EncryptedFileStore

Propósito

Crea almacenamiento persistente protegido; obtén la clave de cifrado del almacén de credenciales del sistema.

Parámetros

• directory: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• key: Clave de cifrado del almacén de credenciales del sistema; nunca la guardes junto a los registros cifrados.

Resultado

EncryptedFileStore

Devuelve el objeto creado; la inicialización no demuestra autorización.

persistent? / secure? → true | false

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Resultado

true | false

Devuelve una clasificación booleana, no una autorización.

path(scope) → String

Propósito

Valida o lee la configuración pública; deben coincidir productos, entorno y claves de firma.

Parámetros

• scope: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

String

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

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

Propósito

Solicita o comprueba la cancelación cooperativa; cancelar no significa autorización correcta.

Resultado

true / nil

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Parámetros

• code, status, retry_after_seconds: Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

Error

Devuelve el tipo indicado en la firma; el resultado no concede permisos de función.

load(scope) → Hash | nil

Propósito

Carga la cuenta mediante una clave aislada; contiene secretos destinados únicamente al SDK.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

Hash | nil

Devuelve el registro secreto; su ausencia devuelve un valor vacío o ErrNoSession según el lenguaje.

save(scope, record) → Object

Propósito

Guarda atómicamente la cuenta bajo su clave aislada.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

Object

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

delete(scope) → Object

Propósito

Elimina la cuenta sin borrar la caché de autorización ni el registro de cierre del SDK oficial.

Parámetros

• scope / key, value / record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

Object

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• remember, store: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

launch_application *

Devuelve un puntero de propiedad transferida; NULL indica fallo de inicialización. Libéralo mediante close.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.

Resultado

int

1 indica éxito; 0 indica fallo. Lee el código de error tras fallar.

launch_application_restore(launch_application *app) → int

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Resultado

int

1 indica restauración; 0, ausencia de sesión; -1, rechazo o fallo. Lee el código de error tras fallar.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.
• context: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

int

1 indica éxito; 0 indica fallo. Lee el código de error tras fallar.

launch_application_logout(launch_application *app) → int

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Resultado

int

1 indica éxito; 0 indica fallo. Lee el código de error tras fallar.

launch_application_release_device(launch_application *app) → int

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Resultado

int

1 indica éxito; 0 indica fallo. Lee el código de error tras fallar.

launch_application_status(launch_application *app) → char *

Propósito

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

Resultado

char *

Devuelve JSON cuya memoria debes liberar con ln_free_string. Sin motor: login_required y allowed=false.

launch_application_error(const launch_application *app) → const char *

Propósito

Crea o lee errores estructurados para clasificación, espera y diagnóstico correlacionado.

Resultado

const char *

Devuelve una cadena prestada con el código de error. No la liberes ni uses tras destruir la aplicación.

launch_application_close(launch_application *app) → void

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

void

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• product_id: Identificador del producto Launch, completado por el código de integración de administración.
• product_config_path: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• remember, store: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

launch_application *

Devuelve un puntero de propiedad transferida; NULL indica fallo de inicialización. Libéralo mediante close.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• launchPath, productPath: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• remember, store: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

launch_application *

Devuelve un puntero de propiedad transferida; NULL indica fallo de inicialización. Libéralo mediante close.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• argc, argv: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

launch_application *

Devuelve un puntero de propiedad transferida; NULL indica fallo de inicialización. Libéralo mediante close.

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

Propósito

API heredada conservada: se eliminó el protocolo de credenciales de licencia permanente y las llamadas fallan. Usa Application.

Parámetros

• account, origin, product_id, config_path, environment, email, password, argc, argv: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

int

Siempre falla; migra al intercambio de identidad de cuenta.

launch_sign_out(launch_account *account, int clear_cache) → void

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Parámetros

• account, clear_cache: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

ln_free_string(char *value) → void

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Parámetros

• value: Devuelve JSON cuya memoria debes liberar con ln_free_string. Sin motor: login_required y allowed=false.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Carga la cuenta mediante una clave aislada; contiene secretos destinados únicamente al SDK.

Parámetros

• context: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• scope, record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

int

1 encontrado, 0 ausente, -1 error de lectura. load asigna record y el llamador lo libera.

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

Propósito

Guarda atómicamente la cuenta bajo su clave aislada.

Parámetros

• context: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• scope, record: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

int (1: success, 0: failure)

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Elimina la cuenta sin borrar la caché de autorización ni el registro de cierre del SDK oficial.

Parámetros

• context: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.
• scope: Claves de aislamiento y registros secretos SDK; el almacenamiento personalizado debe admitir varias claves y sustitución atómica.

Resultado

int (1: success, 0: failure)

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

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

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• merchantOrigin / origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• productID / product_id: Identificador del producto Launch, completado por el código de integración de administración.
• licentivoProductID / licentivo_product_id: Identificador del producto de licencia Licentivo; debe coincidir con la configuración pública de firma.
• trustedKeys / trusted_keys: Mapa de identificadores de clave a claves públicas para verificar permisos firmados del SDK oficial.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• remember, store: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Inicia sesión con la cuenta de la tienda, obtiene una declaración de identidad temporal e inicia el SDK oficial.

Parámetros

• email, password: Correo y contraseña de la cuenta del cliente en esta tienda; usa la contraseña solo para este inicio de sesión.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Restore() → bool

Propósito

Lee la sesión guardada, confirma la cuenta en línea, obtiene una nueva declaración e inicia el SDK oficial.

Resultado

bool

true indica restauración correcta; false indica que no hay sesión restaurable. Los rechazos, vencimientos y errores de red generan errores.

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

Propósito

El SDK oficial verifica cada ejecución y solo ejecuta la función de retorno cuando está autorizada.

Parámetros

• feature / name, action / block: El nombre de función debe coincidir con la política; la función de retorno contiene el trabajo protegido real.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Logout() → void

Propósito

Detiene la autorización local, cierra sesión en el SDK oficial y revoca la sesión Launch. Conserva las tareas remotas pendientes para reintentarlas.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

ReleaseDevice() → void

Propósito

Entrada compatible para cerrar sesión explícitamente, con el mismo proceso de cuenta y dispositivo que Logout.

Resultado

void

Sin valor de negocio; la finalización normal indica éxito y los errores o excepciones indican fallo.

Status() → std::string (JSON)

Propósito

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

Resultado

std::string (JSON)

Lee el estado de autorización del SDK oficial; no inicia sesión ni sustituye la comprobación de cada función.

~Application() → void

Propósito

Detiene esta instancia y sus tareas conservando el inicio de sesión guardado y la vinculación del dispositivo.

Resultado

void

Sin valor de negocio; cerrar normalmente no confirma cierre de cuenta ni liberación del dispositivo.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• origin: Origen completo de la tienda con protocolo y puerto necesario; usa HTTPS en producción.
• product: Identificador del producto Launch, completado por el código de integración de administración.
• config: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• environment: sandbox o live; mantén cuentas, productos y cachés en el mismo entorno.
• remember, store: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

explicit Application(launch_application *app) → Application

Propósito

Valida la configuración pública y crea la aplicación; no inicia sesión ni autoriza funciones protegidas.

Parámetros

• app: Devuelve un puntero de propiedad transferida; NULL indica fallo de inicialización. Libéralo mediante close.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Lee dos configuraciones públicas existentes, comprueba sus productos y crea la aplicación. La conexión directa no necesita archivos.

Parámetros

• launch, product: Rutas de configuración elegidas o directorios privados de caché y almacenamiento del usuario actual.
• remember, store: Opciones de almacenamiento, caché privada, cancelación, reintentos o componentes avanzados.

Resultado

Application

Devuelve el objeto creado; la inicialización no demuestra autorización.

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

Propósito

Transfiere la propiedad de la aplicación nativa. La copia está deshabilitada y el objeto original deja de poseer el puntero.

Parámetros

• other: Objetos de configuración, motor, transporte o solicitud, solo para integraciones avanzadas.

Resultado

Application / Application&

Devuelve el objeto creado; la inicialización no demuestra autorización.