@mr-tick/sdk
v0.11.0
Published
Toolkit para o ecossistema Mr-tick.
Readme
@mr-tick/sdk
O SDK reúne ferramentas para criar extensões do Mr. Tick sem alterar o aplicativo. Ele permite conectar ferramentas de trabalho, consultar tarefas, registrar apontamentos e sugestões, adicionar ações e criar temas. Essas extensões são chamadas de addons.
SDK público para addons do Mr. Tick. Instale o pacote publicado no npm; não importe pacotes privados do monorepo. A linha 0.11 usa capabilities canônicas e separa autenticação de conexões dos providers de dados.
Modelo público
AddonContext.core: runtime, workspaces, connections, tasks, metadata, timer e timeEntries.AddonContext.contributions: commands, menus, settings, connections, dataSources e themes.AddonContext.host: events, notifications, vault e oauth.IDataSourceInstance: tasksProvider, timeEntriesProvider, membersProvider e metadataProvider.
O manifesto declara capabilities e requiredApiVersion. Addons que conectam contas declaram auth; perfis e autenticadores são registrados em runtime por contributions.connections, com retorno Either. IDataSource não fornece perfis de conexão. IHttpClient exige validador de resposta. APIs funcionais retornam Either; os helpers OAuth de baixo nível mantêm seus contratos de Promise específicos.
Guias
Registre contribuições em activate e retorne sem aguardar o runtime. Feche recursos próprios em deactivate. Addons executam código confiável no main do Electron, sem sandbox para código não confiável. Versões são publicadas pelo fluxo de Changesets/CI; não faça bump manual.
