codai-sdk 0.13.0 → 0.29.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Dragos Catalin Vladulescu (codai)
+Copyright (c) 2026 Interactive Media Solutions S.R.L. (codai)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -301,6 +301,40 @@ const me = await codai.account.get();
 await codai.account.update({ training_opt_out: true });
 ```
 
+## Host apps: keys, overrides and subscriptions (`CodaiApps`)
+
+Apps that resell codai to their own users (e.g. studiai.ro) manage keys through the mgmt API
+(`https://api.codai.ro`) with an **app connection token** (`codai_app_…`, created at
+`codai.ro/console/apps/<app>`), not a user key. `CodaiApps` unwraps the `{ ok, data }` envelope and
+throws `CodaiError` (`status`, `code` such as `missing_scope:keys.mint` or `no_key_for_external_id`).
+Default timeout 20 s, one retry on 429/5xx; `keys.mint` is never retried.
+
+```ts
+import { CodaiApps } from 'codai-sdk';
+
+const apps = new CodaiApps({
+  appToken: process.env.CODAI_APP_TOKEN, // /apps/* calls
+  validateToken: process.env.CODAI_VALIDATE_TOKEN, // optional, validateKey only
+});
+
+const minted = await apps.keys.mint({
+  email: 'ana@example.com',
+  endUserExternalId: 'uid:gh1',
+  tierSlug: 'pro',
+});
+const keys = await apps.keys.list({ endUserExternalId: 'uid:gh1' });
+const usage = await apps.keys.usage(minted.id, 30);
+await apps.keys.update(minted.id, { enabled: false });
+await apps.keys.revokeAllFor('uid:gh1');
+
+await apps.users.setOverride('uid:gh1', { tasksPerDay: 200, resetUsage: true });
+const { override, effectiveLimits } = await apps.users.getOverride('uid:gh1');
+await apps.users.clearOverride('uid:gh1');
+
+await apps.subscriptions.sync({ email: 'ana@example.com', event: stripeEvent });
+const check = await apps.validateKey(presentedKey); // { valid, key?, entitlements?, reason? }
+```
+
 ## Feedback
 
 ```ts