codai-sdk 0.13.0 → 0.54.1

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

@@ -65,11 +65,30 @@ surface.
 | `receipt`          | `get`                                                                                                                                                                                                | `GET /v1/receipt`                                        |
 | `feedback`         | `submit`                                                                                                                                                                                             | `POST /v1/feedback`                                      |
 | `phoneModels`      | `list`                                                                                                                                                                                               | `GET /v1/phone/models`                                   |
-| `resolve`          | `submit`, `get`, `accept`, `balance`, `attestation`, `keys`, `verifyAttestation`, `health`, `waitFor`                                                                                                | `https://resolve.codai.ro/v1/resolve/*` (own host)       |
+| `billing`          | `get`, `invoices`, `watchBalance` (read-only)                                                                                                                                                        | `GET /v1/billing`, `GET /v1/billing/invoices`            |
+| `referrals`        | `get`, `redeem`, `setConsent`                                                                                                                                                                        | `GET /v1/referrals`, `PATCH /v1/account`                 |
+| `resolve`          | `submit`, `get`, `list`, `iterate`, `accept`, `balance`, `attestation`, `keys`, `verifyAttestation`, `health`, `waitFor`                                                                             | `https://resolve.codai.ro/v1/resolve/*` (own host)       |
 
 Every method takes an optional last argument `{ ext, signal }` where `ext` is a
 typed bag of `X-Codai-*` extension headers (see below).
 
+## Lists and the share sheet
+
+`lists` covers `/v1/lists/*` and `POST /v1/share`: `list`, `create`, `reorder`,
+`update`, `delete`, `items`, `add`, `updateItem`, `deleteItem`, `image`
+(bytes + content type), `exportMarkdown` (string), `share` and `stream` (live
+`list` events). `add` and `share` are idempotent on `client_id` / the canonical
+URL: a duplicate answers 200 with `created: false`.
+
+```ts
+const { item, list } = await client.lists.share({ url: 'https://example.com', auto: true });
+const md = await client.lists.exportMarkdown(list.id);
+for await (const ev of client.lists.stream()) console.log(ev.op, ev.listId, ev.itemId);
+```
+
+`schedules.audit({ schedule_id?, limit? })` returns the scheduler audit log
+(`GET /v1/schedules/audit`), newest first.
+
 ## Streaming
 
 ```ts
@@ -301,6 +320,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