@curviate/sdk 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ Versioning: semantic — minor for additive changes, patch for bug fixes; no sta
 
 ---
 
+## [0.9.0] — 2026-07-03
+
+### Added
+
+- **Account enrichment fields.** `accounts.list()` items and `accounts.get()` now carry six cached account-detail fields, populated by an async background enrichment on every successful account activation: `username`, `premium_id`, `public_identifier`, `substrate_created_at` (ISO-8601 UTC), `signatures` (`{title, content}[]`), and `groups` (`string[]`). All six are `null`/`[]` until the account's first enrichment pass completes — never `undefined`, never a missing key. Types: `AccountListPage`, `AccountDetail`.
+- `accounts.get()` gains `seat_id` (`string | null`) — the seat the account occupies, `null` for an admin seatless account. Previously only `accounts.list()` items carried this field.
+
+### Changed
+
+- `connected_at` (on both `accounts.list()` items and `accounts.get()`) and `last_checked_at` (`accounts.get()`) now consistently emit ISO-8601 UTC (`…Z`) timestamps — a prior docs-vs-runtime drift meant these could reach callers in raw Postgres wire format. No type change (already typed as `string`/`string | null`); this is a runtime-correctness fix reflected in the regenerated example values.
+- Regenerated types from the current API surface. No resource method signatures changed — purely additive response fields.
+- `quotas[]` (on `accounts.get()`) is now documented as advisory usage-safety recommendations: daily families never cause a rejected request; only `account.per_minute` is a binding limit enforced with HTTP 429. `recommended_throttle_hint` semantics documented per level (`none` / `slow_down` / `backoff` are advisory; `stop` is reserved for the binding per-minute limit). JSDoc-only — no type shape change.
+
+---
+
 ## [0.8.0] — 2026-07-02
 
 ### Added

package/dist/index.d.ts

@@ -164,8 +164,23 @@ interface paths {
                                 headline?: string | null;
                                 /** @description The seat this account occupies. */
                                 seat_id?: string | null;
-                                /** @description ISO-8601 connection timestamp. */
-                                connected_at?: string;
+                                /** @description ISO-8601 UTC connection timestamp. */
+                                connected_at?: string | null;
+                                /** @description Cached account username. Null until enriched. */
+                                username?: string | null;
+                                /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                                premium_id?: string | null;
+                                /** @description Cached public profile identifier. Null until enriched. */
+                                public_identifier?: string | null;
+                                /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                                substrate_created_at?: string | null;
+                                /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                                signatures?: {
+                                    title?: string;
+                                    content?: string;
+                                }[];
+                                /** @description Cached group names the account belongs to. Empty until enriched. */
+                                groups?: string[];
                             }[];
                             /** @description Next-page cursor; null on the last page. */
                             cursor?: string | null;
@@ -508,9 +523,28 @@ interface paths {
                             auth_method?: string;
                             full_name?: string | null;
                             headline?: string | null;
+                            /** @description ISO-8601 UTC connection timestamp. */
                             connected_at?: string | null;
+                            /** @description ISO-8601 UTC time the account state was last checked. */
                             last_checked_at?: string;
-                            /** @description Per-account quota view — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, account.per_minute). */
+                            /** @description The seat this account occupies (null for an admin seatless account). */
+                            seat_id?: string | null;
+                            /** @description Cached account username. Null until enriched. */
+                            username?: string | null;
+                            /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                            premium_id?: string | null;
+                            /** @description Cached public profile identifier. Null until enriched. */
+                            public_identifier?: string | null;
+                            /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                            substrate_created_at?: string | null;
+                            /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                            signatures?: {
+                                title?: string;
+                                content?: string;
+                            }[];
+                            /** @description Cached group names the account belongs to. Empty until enriched. */
+                            groups?: string[];
+                            /** @description Usage-safety recommendations for this account — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, profile.endorse, account.per_minute). These are advisory only: Curviate never rejects a request because a daily recommendation is exceeded; only account.per_minute is a binding limit enforced with HTTP 429. */
                             quotas?: {
                                 /** @description Quota family (e.g. messages.daily, account.per_minute). */
                                 quota_name?: string;
@@ -521,7 +555,7 @@ interface paths {
                                 /** @description ISO-8601 UTC time the current window resets. */
                                 reset_time?: string;
                                 /**
-                                 * @description Pacing hint.
+                                 * @description Pacing recommendation for this family, advisory only. `none` (under 80% consumed), `slow_down` (80-99% consumed), and `backoff` (100%+ consumed) never block a request. `stop` is reserved exclusively for `account.per_minute` — the sole binding limit, whose breach is enforced with HTTP 429.
                                  * @enum {string}
                                  */
                                 recommended_throttle_hint?: "none" | "slow_down" | "backoff" | "stop";
@@ -15047,6 +15081,11 @@ declare class AccountsResource {
     /**
      * List the tenant's connected LinkedIn accounts, cursor-paginated.
      *
+     * Each item also carries a small set of cached account-detail fields
+     * (`username`, `premium_id`, `public_identifier`, `substrate_created_at`,
+     * `signatures`, `groups`) populated by an async background enrichment —
+     * `null`/`[]` until the account's first enrichment pass completes.
+     *
      * @param params - optional `limit` (1–250) and `cursor` (from a prior page).
      * @returns a page of accounts and the next-page `cursor` (null when exhausted).
      *
@@ -15077,7 +15116,14 @@ declare class AccountsResource {
     createConnectLink(body: AccountConnectLinkBody): Promise<AccountConnectLinkResult>;
     /**
      * Return metadata and current state for one connected account, including the
-     * central `quotas[]` view for all tracked quota families.
+     * central `quotas[]` view for all tracked quota families and `seat_id` (the
+     * seat this account occupies, `null` for an admin seatless account).
+     *
+     * This is a stale-while-revalidate read — it always returns immediately
+     * from the cached row (never blocks on a live substrate call), and the
+     * six cached enrichment fields (`username`, `premium_id`,
+     * `public_identifier`, `substrate_created_at`, `signatures`, `groups`) are
+     * `null`/`[]` until the account's first enrichment pass completes.
      */
     get(accountId: string): Promise<AccountDetail>;
     /**

package/dist/index.js

@@ -308,6 +308,11 @@ var AccountsResource = class {
   /**
    * List the tenant's connected LinkedIn accounts, cursor-paginated.
    *
+   * Each item also carries a small set of cached account-detail fields
+   * (`username`, `premium_id`, `public_identifier`, `substrate_created_at`,
+   * `signatures`, `groups`) populated by an async background enrichment —
+   * `null`/`[]` until the account's first enrichment pass completes.
+   *
    * @param params - optional `limit` (1–250) and `cursor` (from a prior page).
    * @returns a page of accounts and the next-page `cursor` (null when exhausted).
    *
@@ -368,7 +373,14 @@ var AccountsResource = class {
   }
   /**
    * Return metadata and current state for one connected account, including the
-   * central `quotas[]` view for all tracked quota families.
+   * central `quotas[]` view for all tracked quota families and `seat_id` (the
+   * seat this account occupies, `null` for an admin seatless account).
+   *
+   * This is a stale-while-revalidate read — it always returns immediately
+   * from the cached row (never blocks on a live substrate call), and the
+   * six cached enrichment fields (`username`, `premium_id`,
+   * `public_identifier`, `substrate_created_at`, `signatures`, `groups`) are
+   * `null`/`[]` until the account's first enrichment pass completes.
    */
   get(accountId) {
     return this.ctx.request({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curviate/sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "private": false,
   "description": "TypeScript SDK for the Curviate API.",
   "license": "MIT",

package/src/generated/types.ts

@@ -55,8 +55,23 @@ export interface paths {
                                 headline?: string | null;
                                 /** @description The seat this account occupies. */
                                 seat_id?: string | null;
-                                /** @description ISO-8601 connection timestamp. */
-                                connected_at?: string;
+                                /** @description ISO-8601 UTC connection timestamp. */
+                                connected_at?: string | null;
+                                /** @description Cached account username. Null until enriched. */
+                                username?: string | null;
+                                /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                                premium_id?: string | null;
+                                /** @description Cached public profile identifier. Null until enriched. */
+                                public_identifier?: string | null;
+                                /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                                substrate_created_at?: string | null;
+                                /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                                signatures?: {
+                                    title?: string;
+                                    content?: string;
+                                }[];
+                                /** @description Cached group names the account belongs to. Empty until enriched. */
+                                groups?: string[];
                             }[];
                             /** @description Next-page cursor; null on the last page. */
                             cursor?: string | null;
@@ -399,9 +414,28 @@ export interface paths {
                             auth_method?: string;
                             full_name?: string | null;
                             headline?: string | null;
+                            /** @description ISO-8601 UTC connection timestamp. */
                             connected_at?: string | null;
+                            /** @description ISO-8601 UTC time the account state was last checked. */
                             last_checked_at?: string;
-                            /** @description Per-account quota view — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, account.per_minute). */
+                            /** @description The seat this account occupies (null for an admin seatless account). */
+                            seat_id?: string | null;
+                            /** @description Cached account username. Null until enriched. */
+                            username?: string | null;
+                            /** @description Cached premium-membership id. Null until enriched, or for non-premium accounts. */
+                            premium_id?: string | null;
+                            /** @description Cached public profile identifier. Null until enriched. */
+                            public_identifier?: string | null;
+                            /** @description ISO-8601 UTC creation timestamp of the underlying LinkedIn account — distinct from connected_at. Null until enriched. */
+                            substrate_created_at?: string | null;
+                            /** @description Cached signature blocks (title + content) for the account. Empty until enriched. */
+                            signatures?: {
+                                title?: string;
+                                content?: string;
+                            }[];
+                            /** @description Cached group names the account belongs to. Empty until enriched. */
+                            groups?: string[];
+                            /** @description Usage-safety recommendations for this account — one entry per tracked family (messages.daily, connection_requests.daily, profile_views.daily, inmail.daily, profile.endorse, account.per_minute). These are advisory only: Curviate never rejects a request because a daily recommendation is exceeded; only account.per_minute is a binding limit enforced with HTTP 429. */
                             quotas?: {
                                 /** @description Quota family (e.g. messages.daily, account.per_minute). */
                                 quota_name?: string;
@@ -412,7 +446,7 @@ export interface paths {
                                 /** @description ISO-8601 UTC time the current window resets. */
                                 reset_time?: string;
                                 /**
-                                 * @description Pacing hint.
+                                 * @description Pacing recommendation for this family, advisory only. `none` (under 80% consumed), `slow_down` (80-99% consumed), and `backoff` (100%+ consumed) never block a request. `stop` is reserved exclusively for `account.per_minute` — the sole binding limit, whose breach is enforced with HTTP 429.
                                  * @enum {string}
                                  */
                                 recommended_throttle_hint?: "none" | "slow_down" | "backoff" | "stop";