Funções e retornos SDK em nove linguagens

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

(*Application, error)

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.
• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.

Retorno

(State, error)

Retorna o estado da conta; veja a tabela de campos abaixo.

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

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

(State, error)

Retorna o estado; ErrNoSession ou NO_SESSION indica ausência de sessão salva. Trate outros erros separadamente.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Logout(ctx context.Context) → error

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

ReleaseDevice(ctx context.Context) → error

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Close() → void

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

void

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

(*Application, error)

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• launchPath, productPath: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

(*Application, error)

Retorna o objeto criado; inicialização não comprova autorização.

LoadPublicConfig(path string) → (PublicConfig, error)

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• path: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

(PublicConfig, error)

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Cria o adaptador SDK oficial para integrações avançadas; a declaração é transmitida apenas em memória.

Parâmetros

• product, runtime: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

(Runtime, error)

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• allowLocalHTTP: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

(*Client, error)

Retorna o objeto criado; inicialização não comprova autorização.

WithToken(token string) → *Client

Finalidade

Retorna uma cópia do cliente com o token informado, para servidores confiáveis.

Parâmetros

• token: Token de sessão Launch, retornado somente por interfaces de sessão básicas ou armazenamento criptografado.

Retorno

*Client

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta e retorna dados ou sessão, sem iniciar o runtime de autorização.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.
• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.

Retorno

(User, error)

Retorna o estado da conta; veja a tabela de campos abaixo.

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

Finalidade

Autentica a conta e retorna dados ou sessão, sem iniciar o runtime de autorização.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.
• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.

Retorno

(Session, error)

Retorna o estado da conta; veja a tabela de campos abaixo.

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

Finalidade

Consulta a conta atual; sucesso não autoriza funções protegidas.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

(User, error)

Retorna o estado da conta; veja a tabela de campos abaixo.

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

Finalidade

Obtém declaração de identidade de uso único e contexto público, que não são licença nem permissão de função.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.
• product: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.

Retorno

(Identity, error)

Retorna o estado da conta; veja a tabela de campos abaixo.

SignOut(ctx context.Context) → error

Finalidade

Revoga a sessão Launch e apaga o token do cliente; não substitui a saída do dispositivo pelo SDK oficial.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

API antiga preservada: o protocolo de credenciais de licença permanente foi removido e as chamadas falham. Use Application.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.
• product: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.

Retorno

(Credential, error)

Sempre falha; migre para troca de identidade de conta.

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

Finalidade

API antiga preservada: o protocolo de credenciais de licença permanente foi removido e as chamadas falham. Use Application.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.
• product: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• policy: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

(Credential, error)

Sempre falha; migre para troca de identidade de conta.

NewSystemSessionStore(directory string) → (SessionStore, error)

Finalidade

Cria armazenamento persistente protegido; obtenha a chave no cofre de credenciais do sistema operacional.

Parâmetros

• directory: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

(SessionStore, error)

Retorna o objeto criado; inicialização não comprova autorização.

ProtectDirectory(directory string) → error

Finalidade

Restringe o diretório ao usuário Windows atual ou a permissões privadas nas demais plataformas.

Parâmetros

• directory: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

ServiceUnavailable(err error) → bool

Finalidade

Identifica indisponibilidade temporária; isso nunca permite autorização offline.

Parâmetros

• err: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

bool

Retorna uma classificação booleana, não uma autorização.

Error() → string

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

string

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

Unwrap() → error

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

error

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Carrega a conta por chave isolada; o registro contém segredos exclusivos do SDK.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

([]byte, error)

Retorna o registro secreto; ausência retorna valor vazio ou ErrNoSession conforme a linguagem.

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

Finalidade

Salva atomicamente o registro da conta sob sua chave isolada.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Exclui o registro da conta, preservando caches de autorização e diário de saída do SDK oficial.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Inicia verificação e manutenção SDK oficial; login e proteção de funções usam APIs separadas.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.
• onError: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Deactivate(ctx context.Context) → error

Finalidade

Encerra a sessão do dispositivo pelo SDK oficial; a aplicação revoga a sessão Launch separadamente.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

error

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Close() → void

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

void

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.
• pending_attempts: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application (self)

Retorna esta instância da aplicação, não dados da conta nem resultado de autorização.

restore() → bool

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Retorno

bool

true indica restauração; false indica ausência de sessão restaurável. Negação, expiração e falha de rede geram erros.

run_feature(name, action) → T

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

T

Retorna o resultado do callback de negócio; falhas de autorização e exceções geram erros.

logout() → bool

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Retorno

bool

true confirma a saída; false indica saída remota ou revogação de dispositivo pendente. Falhas de armazenamento também podem gerar erros.

release_device() → bool

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Retorno

bool

true confirma a saída; false indica saída remota ou revogação de dispositivo pendente. Falhas de armazenamento também podem gerar erros.

close() → None

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

None

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

Application / None

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• product_config: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• launch_config, product_config: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

MemoryStore() → MemoryStore

Finalidade

Cria armazenamento de sessão válido somente neste processo.

Retorno

MemoryStore

Retorna o objeto criado; inicialização não comprova autorização.

WindowsDPAPIStore(directory=None) → WindowsDPAPIStore

Finalidade

Cria armazenamento persistente protegido; obtenha a chave no cofre de credenciais do sistema operacional.

Parâmetros

• directory: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

WindowsDPAPIStore

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Parâmetros

• code, status, retry_after: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

APIError

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

load(key) → bytes | None

Finalidade

Carrega a conta por chave isolada; o registro contém segredos exclusivos do SDK.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

bytes | None

Retorna o registro secreto; ausência retorna valor vazio ou ErrNoSession conforme a linguagem.

save(key, value) → None

Finalidade

Salva atomicamente o registro da conta sob sua chave isolada.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

None

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

delete(key) → None

Finalidade

Exclui o registro da conta, preservando caches de autorização e diário de saída do SDK oficial.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

None

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• store, cacheDirectory: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.
• pendingAttempts: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.
• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Task

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Task<bool>

true indica restauração; false indica ausência de sessão restaurável. Negação, expiração e falha de rede geram erros.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

Task

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

Retorno

AuthorizationStatus? (null: runtime absent)

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

Logout(CancellationToken ct=default) → Task

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Task

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

ReleaseDevice(CancellationToken ct=default) → Task

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Task

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

DisposeAsync() → ValueTask

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

ValueTask

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do 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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productId: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• productConfig: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• launchPath, productPath: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• store: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

new MemoryStore() → MemoryStore

Finalidade

Cria armazenamento de sessão válido somente neste processo.

Retorno

MemoryStore

Retorna o objeto criado; inicialização não comprova autorização.

new WindowsDPAPIStore(string? directory=null) → WindowsDPAPIStore

Finalidade

Cria armazenamento persistente protegido; obtenha a chave no cofre de credenciais do sistema operacional.

Parâmetros

• directory: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

WindowsDPAPIStore

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Parâmetros

• code, status, retryAfterSeconds: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

LaunchException

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

Load(string key) → byte[]?

Finalidade

Carrega a conta por chave isolada; o registro contém segredos exclusivos do SDK.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

byte[]?

Retorna o registro secreto; ausência retorna valor vazio ou ErrNoSession conforme a linguagem.

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

Finalidade

Salva atomicamente o registro da conta sob sua chave isolada.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Delete(string key) → void

Finalidade

Exclui o registro da conta, preservando caches de autorização e diário de saída do SDK oficial.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Start(CancellationToken ct) → Task

Finalidade

Inicia verificação e manutenção SDK oficial; login e proteção de funções usam APIs separadas.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Task

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Status() → AuthorizationStatus

Finalidade

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

Retorno

AuthorizationStatus

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

Task

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Deactivate(CancellationToken ct) → Task

Finalidade

Encerra a sessão do dispositivo pelo SDK oficial; a aplicação revoga a sessão Launch separadamente.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Task

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

DisposeAsync() → ValueTask

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

ValueTask

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.

Retorno

Launch

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.

Retorno

State

Retorna o estado da conta; veja a tabela de campos abaixo.

restore() → State

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Retorno

State

Retorna o estado; ErrNoSession ou NO_SESSION indica ausência de sessão salva. Trate outros erros separadamente.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

logout() → void

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

releaseDevice() → void

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

close() → void

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

void

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• config, product: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• cacheRoot: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• store, transport, factory, sleeper: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Launch

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.

Retorno

Config

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

Launch.Config.load(Path path) → Config

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• path: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

Config

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• path: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

Map<String,Object>

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

new Launch.MemoryStore() → MemoryStore

Finalidade

Cria armazenamento de sessão válido somente neste processo.

Retorno

MemoryStore

Retorna o objeto criado; inicialização não comprova autorização.

new EncryptedFileStore(Path directory, SecretKey vaultKey) → EncryptedFileStore

Finalidade

Cria armazenamento persistente protegido; obtenha a chave no cofre de credenciais do sistema operacional.

Parâmetros

• directory: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• vaultKey: Chave de criptografia do cofre do sistema; nunca armazene junto dos registros criptografados.

Retorno

EncryptedFileStore

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Envia requisições HTTP da conta e retorna status, cabeçalhos ou corpo bruto, sem decidir autorização.

Parâmetros

• method, uri, bearer, body: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

Response

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Parâmetros

• code, status, requestID, retryAfterMillis, transport: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

Failure

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

unavailable() → boolean

Finalidade

Identifica indisponibilidade temporária; isso nunca permite autorização offline.

Retorno

boolean

Retorna uma classificação booleana, não uma autorização.

load(String scope) → byte[] | null

Finalidade

Carrega a conta por chave isolada; o registro contém segredos exclusivos do SDK.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

byte[] | null

Retorna o registro secreto; ausência retorna valor vazio ou ErrNoSession conforme a linguagem.

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

Finalidade

Salva atomicamente o registro da conta sob sua chave isolada.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

delete(String scope) → void

Finalidade

Exclui o registro da conta, preservando caches de autorização e diário de saída do SDK oficial.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

canStartOffline() → boolean

Finalidade

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

Retorno

boolean

Retorna uma classificação booleana, não uma autorização.

start() → void

Finalidade

Inicia verificação e manutenção SDK oficial; login e proteção de funções usam APIs separadas.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

releaseDevice() → void

Finalidade

Encerra a sessão do dispositivo pelo SDK oficial; a aplicação revoga a sessão Launch separadamente.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

close() → void

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

void

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Cria o adaptador SDK oficial para integrações avançadas; a declaração é transmitida apenas em memória.

Parâmetros

• settings: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

Runtime

Retorna o objeto criado; inicialização não comprova autorização.

sleep(long milliseconds) → void

Finalidade

Aguarda a duração indicada para agendar tentativas avançadas.

Parâmetros

• milliseconds: Espera recomendada para repetir; diferencie segundos, milissegundos e Duration conforme a linguagem.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.
• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Promise<SessionState>

Retorna o estado da conta; veja a tabela de campos abaixo.

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

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Promise<SessionState | null>

Retorna o estado; null ou nil indica ausência de sessão restaurável. Outras falhas geram erros.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

Promise<T>

Retorna o resultado do callback de negócio; falhas de autorização e exceções geram erros.

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

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Promise<boolean>

true confirma a saída; false indica saída remota ou revogação de dispositivo pendente. Falhas de armazenamento também podem gerar erros.

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

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Promise<void>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

close() → Promise<void>

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

Promise<void>

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• launch, product: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• launchPath, productPath: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Promise<Application>

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• launch, product: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

{launch: LaunchConfig, product: PublicProductConfig}

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• launchPath, productPath: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

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

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

defaultTransport(request: Request) → Promise<Response>

Finalidade

Envia requisições HTTP da conta e retorna status, cabeçalhos ou corpo bruto, sem decidir autorização.

Parâmetros

• request: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

Promise<Response>

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

new MemoryStore() → MemoryStore

Finalidade

Cria armazenamento de sessão válido somente neste processo.

Retorno

MemoryStore

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Cria armazenamento persistente protegido; obtenha a chave no cofre de credenciais do sistema operacional.

Parâmetros

• directory: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• key: Chave de criptografia do cofre do sistema; nunca armazene junto dos registros criptografados.

Retorno

EncryptedFileStore

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Parâmetros

• code, status, retryAfterSeconds: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

LaunchError

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Carrega a conta por chave isolada; o registro contém segredos exclusivos do SDK.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

Promise<SavedSession | null>

Retorna o registro secreto; ausência retorna valor vazio ou ErrNoSession conforme a linguagem.

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

Finalidade

Salva atomicamente o registro da conta sob sua chave isolada.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

Promise<void>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

delete(scope: string) → Promise<void>

Finalidade

Exclui o registro da conta, preservando caches de autorização e diário de saída do SDK oficial.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

Promise<void>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

Retorno

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

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

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

Finalidade

Inicia verificação e manutenção SDK oficial; login e proteção de funções usam APIs separadas.

Parâmetros

• onError: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.
• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Promise<unknown>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

Promise<T>

Retorna o resultado do callback de negócio; falhas de autorização e exceções geram erros.

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

Finalidade

Encerra a sessão do dispositivo pelo SDK oficial; a aplicação revoga a sessão Launch separadamente.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Promise<unknown>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Encerra a sessão do dispositivo pelo SDK oficial; a aplicação revoga a sessão Launch separadamente.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

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

Saída local e revogação remota são distintas. Trate pendências e falhas de armazenamento; preserve o diário SDK.

close() → Promise<unknown>

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

Promise<unknown>

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.

Retorno

Result<Application, Failure>

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.

Retorno

Result<State, Failure>

Retorna o estado da conta; veja a tabela de campos abaixo.

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

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Retorno

Result<State, Failure>

Retorna o estado; ErrNoSession ou NO_SESSION indica ausência de sessão salva. Trate outros erros separadamente.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

Result<T, Failure>

Retorna o resultado do callback de negócio; falhas de autorização e exceções geram erros.

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

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Retorno

Result<(), Failure>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Retorno

Result<(), Failure>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

()

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• config, product: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• cache_root: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

Result<Application, Failure>

Retorna o objeto criado; inicialização não comprova autorização.

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>

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• config, product: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• cache_root: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• store, transport, factory, sleeper: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Result<Application, Failure>

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.

Retorno

Result<Config, Failure>

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• path: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

Result<Config, Failure>

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• path: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

Result<Value, Failure>

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

MemoryStore::default() → MemoryStore

Finalidade

Cria armazenamento de sessão válido somente neste processo.

Retorno

MemoryStore

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Cria armazenamento persistente protegido; obtenha a chave no cofre de credenciais do sistema operacional.

Parâmetros

• root: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• vault_key: Chave de criptografia do cofre do sistema; nunca armazene junto dos registros criptografados.

Retorno

Result<EncryptedFileStore, Failure>

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Envia requisições HTTP da conta e retorna status, cabeçalhos ou corpo bruto, sem decidir autorização.

Retorno

Result<CurlTransport, Failure>

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Envia requisições HTTP da conta e retorna status, cabeçalhos ou corpo bruto, sem decidir autorização.

Parâmetros

• method, url, bearer, body: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

Result<Response, Failure>

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Parâmetros

• code: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

Failure

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Aguarda a duração indicada para agendar tentativas avançadas.

Parâmetros

• duration: Espera recomendada para repetir; diferencie segundos, milissegundos e Duration conforme a linguagem.

Retorno

Result<(), Failure>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Carrega a conta por chave isolada; o registro contém segredos exclusivos do SDK.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

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

Retorna o registro secreto; ausência retorna valor vazio ou ErrNoSession conforme a linguagem.

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

Finalidade

Salva atomicamente o registro da conta sob sua chave isolada.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

Result<(), Failure>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Exclui o registro da conta, preservando caches de autorização e diário de saída do SDK oficial.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

Result<(), Failure>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

Result<(), Failure>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Encerra a sessão do dispositivo pelo SDK oficial; a aplicação revoga a sessão Launch separadamente.

Retorno

Result<(), Failure>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

close(&mut self) → ()

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

()

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Cria o adaptador SDK oficial para integrações avançadas; a declaração é transmitida apenas em memória.

Parâmetros

• settings, cached_only: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

Result<Box<dyn Runtime>, Failure>

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Cria o adaptador SDK oficial para integrações avançadas; a declaração é transmitida apenas em memória.

Parâmetros

• settings: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

Result<Box<dyn Runtime>, Failure>

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Aguarda a duração indicada para agendar tentativas avançadas.

Parâmetros

• duration: Espera recomendada para repetir; diferencie segundos, milissegundos e Duration conforme a linguagem.

Retorno

Result<(), Failure>

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.
• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Hash

Retorna o estado da conta; veja a tabela de campos abaixo.

restore(cancellation: nil) → Hash | nil

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

Hash | nil

Retorna o estado; null ou nil indica ausência de sessão restaurável. Outras falhas geram erros.

run_feature(feature) { ... } → T

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

T

Retorna o resultado do callback de negócio; falhas de autorização e exceções geram erros.

logout(cancellation: nil) → true | false

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

true | false

true confirma a saída; false indica saída remota ou revogação de dispositivo pendente. Falhas de armazenamento também podem gerar erros.

release_device(cancellation: nil) → true | false

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Parâmetros

• ctx / ct / signal / cancellation: Contexto da requisição ou sinal de cancelamento; o contexto de ciclo Go controla também tarefas em segundo plano.

Retorno

true | false

true confirma a saída; false indica saída remota ou revogação de dispositivo pendente. Falhas de armazenamento também podem gerar erros.

close → nil

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

nil

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• launch, product: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• launchPath, productPath: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• options / config: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

LicentivoLaunch.origin(value, environment) → String

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• value: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.

Retorno

String

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• launch, product: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

[Hash, Hash]

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• launchPath, productPath: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.

Retorno

[Hash, Hash]

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

LicentivoLaunch.default_transport(request) → Hash

Finalidade

Envia requisições HTTP da conta e retorna status, cabeçalhos ou corpo bruto, sem decidir autorização.

Parâmetros

• request: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

Hash

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

MemoryStore.new → MemoryStore

Finalidade

Cria armazenamento de sessão válido somente neste processo.

Retorno

MemoryStore

Retorna o objeto criado; inicialização não comprova autorização.

EncryptedFileStore.new(directory, key) → EncryptedFileStore

Finalidade

Cria armazenamento persistente protegido; obtenha a chave no cofre de credenciais do sistema operacional.

Parâmetros

• directory: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• key: Chave de criptografia do cofre do sistema; nunca armazene junto dos registros criptografados.

Retorno

EncryptedFileStore

Retorna o objeto criado; inicialização não comprova autorização.

persistent? / secure? → true | false

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Retorno

true | false

Retorna uma classificação booleana, não uma autorização.

path(scope) → String

Finalidade

Valida ou lê configurações públicas; produtos, ambiente e chaves de assinatura devem corresponder.

Parâmetros

• scope: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

String

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

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

Finalidade

Solicita ou verifica cancelamento cooperativo; cancelar não significa autorização bem-sucedida.

Retorno

true / nil

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Parâmetros

• code, status, retry_after_seconds: Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

Error

Retorna o tipo indicado na assinatura; o resultado não concede permissão de função.

load(scope) → Hash | nil

Finalidade

Carrega a conta por chave isolada; o registro contém segredos exclusivos do SDK.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

Hash | nil

Retorna o registro secreto; ausência retorna valor vazio ou ErrNoSession conforme a linguagem.

save(scope, record) → Object

Finalidade

Salva atomicamente o registro da conta sob sua chave isolada.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

Object

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

delete(scope) → Object

Finalidade

Exclui o registro da conta, preservando caches de autorização e diário de saída do SDK oficial.

Parâmetros

• scope / key, value / record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

Object

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• remember, store: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

launch_application *

Retorna ponteiro sob sua propriedade; NULL indica falha de inicialização. Libere com close.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.

Retorno

int

1 indica sucesso; 0 indica falha. Leia o código de erro após falhar.

launch_application_restore(launch_application *app) → int

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Retorno

int

1 indica restauração, 0 nenhuma sessão e -1 negação ou falha. Leia o código após falhar.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.
• context: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

int

1 indica sucesso; 0 indica falha. Leia o código de erro após falhar.

launch_application_logout(launch_application *app) → int

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Retorno

int

1 indica sucesso; 0 indica falha. Leia o código de erro após falhar.

launch_application_release_device(launch_application *app) → int

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Retorno

int

1 indica sucesso; 0 indica falha. Leia o código de erro após falhar.

launch_application_status(launch_application *app) → char *

Finalidade

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

Retorno

char *

Retorna JSON cuja memória deve ser liberada com ln_free_string. Sem runtime: login_required e allowed=false.

launch_application_error(const launch_application *app) → const char *

Finalidade

Cria ou lê erros estruturados para classificação, espera e diagnóstico correlacionado.

Retorno

const char *

Retorna texto de erro emprestado. Não libere nem use após destruir a aplicação.

launch_application_close(launch_application *app) → void

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

void

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• product_config_path: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• remember, store: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

launch_application *

Retorna ponteiro sob sua propriedade; NULL indica falha de inicialização. Libere com close.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• launchPath, productPath: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• remember, store: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

launch_application *

Retorna ponteiro sob sua propriedade; NULL indica falha de inicialização. Libere com close.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• argc, argv: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

launch_application *

Retorna ponteiro sob sua propriedade; NULL indica falha de inicialização. Libere com close.

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

Finalidade

API antiga preservada: o protocolo de credenciais de licença permanente foi removido e as chamadas falham. Use Application.

Parâmetros

• account, origin, product_id, config_path, environment, email, password, argc, argv: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

int

Sempre falha; migre para troca de identidade de conta.

launch_sign_out(launch_account *account, int clear_cache) → void

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Parâmetros

• account, clear_cache: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

ln_free_string(char *value) → void

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Parâmetros

• value: Retorna JSON cuja memória deve ser liberada com ln_free_string. Sem runtime: login_required e allowed=false.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Carrega a conta por chave isolada; o registro contém segredos exclusivos do SDK.

Parâmetros

• context: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• scope, record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

int

1 encontrado, 0 ausente, -1 falha de leitura. load aloca record; o chamador libera.

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

Finalidade

Salva atomicamente o registro da conta sob sua chave isolada.

Parâmetros

• context: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• scope, record: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

int (1: success, 0: failure)

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Exclui o registro da conta, preservando caches de autorização e diário de saída do SDK oficial.

Parâmetros

• context: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.
• scope: Chaves de isolamento e registros secretos SDK; armazenamento personalizado deve aceitar múltiplas chaves e substituição atômica.

Retorno

int (1: success, 0: failure)

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

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

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• merchantOrigin / origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• productID / product_id: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• licentivoProductID / licentivo_product_id: Identificador do produto de licença Licentivo, correspondente à configuração pública de assinatura.
• trustedKeys / trusted_keys: Mapa de identificadores de chave para chaves públicas que verificam permissões assinadas do SDK oficial.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• remember, store: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Autentica a conta da loja, obtém uma declaração de identidade temporária e inicia o SDK oficial.

Parâmetros

• email, password: Email e senha da conta do cliente nesta loja; use a senha apenas neste login.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Restore() → bool

Finalidade

Lê a sessão salva, confirma a conta online, obtém nova declaração e inicia o SDK oficial.

Retorno

bool

true indica restauração; false indica ausência de sessão restaurável. Negação, expiração e falha de rede geram erros.

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

Finalidade

O SDK oficial verifica cada execução e só executa o callback quando autorizado.

Parâmetros

• feature / name, action / block: O nome da função deve corresponder à política; o callback contém o trabalho protegido real.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Logout() → void

Finalidade

Interrompe a autorização local, encerra a sessão do SDK oficial e revoga a sessão Launch. Preserva tarefas remotas pendentes para repetir.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

ReleaseDevice() → void

Finalidade

Entrada compatível de saída explícita, com o mesmo fluxo de conta e dispositivo de Logout.

Retorno

void

Sem retorno de negócio; conclusão normal indica sucesso, erros ou exceções indicam falha.

Status() → std::string (JSON)

Finalidade

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

Retorno

std::string (JSON)

Lê o estado de autorização do SDK oficial; não autentica nem substitui a verificação de cada função.

~Application() → void

Finalidade

Interrompe esta instância e tarefas mantendo o login salvo e o vínculo do dispositivo.

Retorno

void

Sem retorno de negócio; fechamento normal não confirma saída da conta nem liberação do dispositivo.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• origin: Origem completa da loja com protocolo e porta necessária; use HTTPS em produção.
• product: Identificador de produto Launch, preenchido automaticamente pelo código de integração administrativo.
• config: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• environment: sandbox ou live; mantenha contas, produtos e caches no mesmo ambiente.
• remember, store: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

explicit Application(launch_application *app) → Application

Finalidade

Valida as configurações públicas e cria a aplicação, sem iniciar sessão nem autorizar funções protegidas.

Parâmetros

• app: Retorna ponteiro sob sua propriedade; NULL indica falha de inicialização. Libere com close.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Lê duas configurações públicas existentes, verifica os produtos e cria a aplicação. A conexão direta dispensa arquivos.

Parâmetros

• launch, product: Caminhos de configuração escolhidos ou diretório privado de cache e armazenamento do usuário atual.
• remember, store: Opções de armazenamento, cache privado, cancelamento, tentativas ou componentes avançados.

Retorno

Application

Retorna o objeto criado; inicialização não comprova autorização.

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

Finalidade

Transfere a propriedade da aplicação nativa. A cópia é desabilitada e o objeto original deixa de possuir o ponteiro.

Parâmetros

• other: Objetos de configuração, runtime, transporte ou requisição, somente para integrações avançadas.

Retorno

Application / Application&

Retorna o objeto criado; inicialização não comprova autorização.