@signa-so/sdk 0.2.2 → 0.7.0

package/dist/resources/deadlines.js

@@ -0,0 +1,26 @@
+import { BaseResource } from '../resource.js';
+import { createList } from '../pagination.js';
+export class Deadlines extends BaseResource {
+    /**
+     * Compute trademark maintenance deadlines for one or more marks.
+     *
+     * Scope: `trademarks:read`. Billed as 1 unit per item.
+     *
+     * ```typescript
+     * const results = await signa.deadlines.compute({
+     *   items: [{
+     *     jurisdiction: 'US',
+     *     filing_route: 'national',
+     *     status: 'registered',
+     *     filing_date: '2019-01-15',
+     *     registration_date: '2020-03-10',
+     *   }],
+     * });
+     * ```
+     */
+    async compute(body, options) {
+        const response = await this._post('/v1/deadlines/compute', body, options);
+        return createList({ ...response, has_more: false }, () => Promise.resolve({ ...response, data: [], has_more: false }));
+    }
+}
+//# sourceMappingURL=deadlines.js.map

package/dist/resources/deadlines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadlines.js","sourceRoot":"","sources":["../../src/resources/deadlines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAQ9D,MAAM,OAAO,SAAU,SAAQ,YAAY;IACzC;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,OAAO,CACX,IAA2B,EAC3B,OAAwB;QAExB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAC/B,uBAAuB,EACvB,IAAI,EACJ,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CACvD,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAC5D,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/entities.d.ts

@@ -0,0 +1,53 @@
+import { BaseResource } from '../resource.js';
+import { type SignaList } from '../pagination.js';
+import type { EntityDetail, EntitySummary, EntityFamily, TrademarkSummary, EntityRetrieveParams, EntityListParams, EntityTrademarksParams, EntityFamilyParams, AnalyticsReport, RequestOptions } from '../types.js';
+/**
+ * Resolved entities (PLN-118 "link, don't merge") — the cross-office identity
+ * layer over per-office owner clusters. An `ent_*` id is either a RESOLVED
+ * (materialized) entity or a DERIVED `ent_<owner-uuid>` singleton; the API
+ * resolves both, so a derived id of a since-linked owner returns the real
+ * entity (its `id` may differ from the one requested).
+ */
+export declare class Entities extends BaseResource {
+    analytics(id: string, options?: RequestOptions): Promise<AnalyticsReport>;
+    /**
+     * Retrieve a single entity by ID.
+     *
+     * Resolved entities embed `members[]` with per-link evidence; derived
+     * singletons carry a member-of-one. Passing a derived `ent_<owner-uuid>` for
+     * an owner that has since been linked resolves to the real entity.
+     *
+     * ```typescript
+     * const entity = await signa.entities.retrieve('ent_abc123');
+     * ```
+     */
+    retrieve(id: string, _params?: EntityRetrieveParams, options?: RequestOptions): Promise<EntityDetail>;
+    /**
+     * List + search resolved entities. OpenSearch-backed for both text and
+     * filter-only queries.
+     *
+     * ```typescript
+     * const entities = await signa.entities.list({ q: '8x8', publicly_traded: true });
+     * ```
+     */
+    list(params?: EntityListParams, options?: RequestOptions): Promise<SignaList<EntitySummary>>;
+    /**
+     * List trademarks across ALL member owners of the entity (summary tier).
+     *
+     * ```typescript
+     * const tms = await signa.entities.trademarks('ent_abc123', { status_primary: 'active' });
+     * ```
+     */
+    trademarks(id: string, params?: EntityTrademarksParams, options?: RequestOptions): Promise<SignaList<TrademarkSummary>>;
+    /**
+     * GLEIF-curated direct family — parent + direct children (1 level). Sourced
+     * from GLEIF Level 2; an absent edge does not imply no relationship (see the
+     * response `coverage_caveat`).
+     *
+     * ```typescript
+     * const family = await signa.entities.family('ent_abc123');
+     * ```
+     */
+    family(id: string, _params?: EntityFamilyParams, options?: RequestOptions): Promise<EntityFamily>;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/resources/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/resources/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,YAAY;IAClC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAK/E;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,oBAAoB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;IAKxB;;;;;;;OAOG;IACG,IAAI,CACR,MAAM,CAAC,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAQpC;;;;;;OAMG;IACG,UAAU,CACd,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAavC;;;;;;;;OAQG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC;CAIzB"}

package/dist/resources/entities.js

@@ -0,0 +1,74 @@
+import { BaseResource } from '../resource.js';
+import { createList } from '../pagination.js';
+/**
+ * Resolved entities (PLN-118 "link, don't merge") — the cross-office identity
+ * layer over per-office owner clusters. An `ent_*` id is either a RESOLVED
+ * (materialized) entity or a DERIVED `ent_<owner-uuid>` singleton; the API
+ * resolves both, so a derived id of a since-linked owner returns the real
+ * entity (its `id` may differ from the one requested).
+ */
+export class Entities extends BaseResource {
+    async analytics(id, options) {
+        this._validateId(id);
+        return this._get(`/v1/entities/${encodeURIComponent(id)}/analytics`, undefined, options);
+    }
+    /**
+     * Retrieve a single entity by ID.
+     *
+     * Resolved entities embed `members[]` with per-link evidence; derived
+     * singletons carry a member-of-one. Passing a derived `ent_<owner-uuid>` for
+     * an owner that has since been linked resolves to the real entity.
+     *
+     * ```typescript
+     * const entity = await signa.entities.retrieve('ent_abc123');
+     * ```
+     */
+    async retrieve(id, _params, options) {
+        this._validateId(id);
+        return this._get(`/v1/entities/${encodeURIComponent(id)}`, undefined, options);
+    }
+    /**
+     * List + search resolved entities. OpenSearch-backed for both text and
+     * filter-only queries.
+     *
+     * ```typescript
+     * const entities = await signa.entities.list({ q: '8x8', publicly_traded: true });
+     * ```
+     */
+    async list(params, options) {
+        const fetchPage = async (cursor) => {
+            return this._getListResponse('/v1/entities', { ...params, cursor }, options);
+        };
+        const firstPage = await fetchPage(params?.cursor);
+        return createList(firstPage, fetchPage);
+    }
+    /**
+     * List trademarks across ALL member owners of the entity (summary tier).
+     *
+     * ```typescript
+     * const tms = await signa.entities.trademarks('ent_abc123', { status_primary: 'active' });
+     * ```
+     */
+    async trademarks(id, params, options) {
+        this._validateId(id);
+        const fetchPage = async (cursor) => {
+            return this._getListResponse(`/v1/entities/${encodeURIComponent(id)}/trademarks`, { ...params, cursor }, options);
+        };
+        const firstPage = await fetchPage(params?.cursor);
+        return createList(firstPage, fetchPage);
+    }
+    /**
+     * GLEIF-curated direct family — parent + direct children (1 level). Sourced
+     * from GLEIF Level 2; an absent edge does not imply no relationship (see the
+     * response `coverage_caveat`).
+     *
+     * ```typescript
+     * const family = await signa.entities.family('ent_abc123');
+     * ```
+     */
+    async family(id, _params, options) {
+        this._validateId(id);
+        return this._get(`/v1/entities/${encodeURIComponent(id)}/family`, undefined, options);
+    }
+}
+//# sourceMappingURL=entities.js.map

package/dist/resources/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/resources/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAc9D;;;;;;GAMG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IACxC,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,OAAwB;QAClD,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAkB,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,OAA8B,EAC9B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAe,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/F,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CACR,MAAyB,EACzB,OAAwB;QAExB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAAgB,cAAc,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9F,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,EAAU,EACV,MAA+B,EAC/B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAC1B,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,aAAa,EACnD,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EACrB,OAAO,CACR,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CACV,EAAU,EACV,OAA4B,EAC5B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAe,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACtG,CAAC;CACF"}

package/dist/resources/events.d.ts

@@ -4,7 +4,7 @@ import type { OrgEvent, OrgEventDetail, OrgEventListParams, RequestOptions } fro
 export declare class Events extends BaseResource {
     /** List organization events. */
     list(params?: OrgEventListParams, options?: RequestOptions): Promise<SignaList<OrgEvent>>;
-    /** Retrieve an event with before/after diffs. IDs are plain bigints. */
-    retrieve(id: number | string, options?: RequestOptions): Promise<OrgEventDetail>;
+    /** Retrieve an event with before/after diffs. IDs are evt_-prefixed strings. */
+    retrieve(id: string, options?: RequestOptions): Promise<OrgEventDetail>;
 }
 //# sourceMappingURL=events.d.ts.map

package/dist/resources/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,MAAO,SAAQ,YAAY;IACtC,gCAAgC;IAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAe/F,wEAAwE;IAClE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAMvF"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,MAAO,SAAQ,YAAY;IACtC,gCAAgC;IAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAe/F,gFAAgF;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;CAM9E"}

package/dist/resources/events.js

@@ -7,12 +7,12 @@ export class Events extends BaseResource {
         const response = await this._getListResponse('/v1/events', params, options);
         return createList(response, (cursor) => this._getListResponse('/v1/events', { ...params, cursor }, options));
     }
-    /** Retrieve an event with before/after diffs. IDs are plain bigints. */
+    /** Retrieve an event with before/after diffs. IDs are evt_-prefixed strings. */
     async retrieve(id, options) {
         if (id === undefined || id === null || id === '') {
             throw new SignaError('id is required and must be a non-empty string');
         }
-        return this._get(`/v1/events/${String(id)}`, undefined, options);
+        return this._get(`/v1/events/${id}`, undefined, options);
     }
 }
 //# sourceMappingURL=events.js.map

package/dist/resources/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C,MAAM,OAAO,MAAO,SAAQ,YAAY;IACtC,gCAAgC;IAChC,KAAK,CAAC,IAAI,CAAC,MAA2B,EAAE,OAAwB;QAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,YAAY,EACZ,MAAiC,EACjC,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACrC,IAAI,CAAC,gBAAgB,CACnB,YAAY,EACZ,EAAE,GAAG,MAAM,EAAE,MAAM,EAA6B,EAChD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,QAAQ,CAAC,EAAmB,EAAE,OAAwB;QAC1D,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAiB,cAAc,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;CACF"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/resources/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C,MAAM,OAAO,MAAO,SAAQ,YAAY;IACtC,gCAAgC;IAChC,KAAK,CAAC,IAAI,CAAC,MAA2B,EAAE,OAAwB;QAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,YAAY,EACZ,MAAiC,EACjC,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACrC,IAAI,CAAC,gBAAgB,CACnB,YAAY,EACZ,EAAE,GAAG,MAAM,EAAE,MAAM,EAA6B,EAChD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;QACjD,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAiB,cAAc,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/resources/feedback.d.ts

@@ -0,0 +1,19 @@
+import { BaseResource } from '../resource.js';
+import { type SignaList } from '../pagination.js';
+import type { Feedback, FeedbackCreateParams, FeedbackListParams, RequestOptions } from '../types.js';
+export declare class FeedbackResource extends BaseResource {
+    /**
+     * Submit structured customer feedback (data issue, bug, feature request, or
+     * other). Free (never billed), org-scoped, idempotent via the standard
+     * Idempotency-Key header (auto-injected by the SDK).
+     */
+    create(body: FeedbackCreateParams, options?: RequestOptions): Promise<Feedback>;
+    /**
+     * List feedback submitted by the authenticated organization. Cursor-paginated,
+     * newest-first. Filterable by type, status, and created-at range.
+     */
+    list(params?: FeedbackListParams, options?: RequestOptions): Promise<SignaList<Feedback>>;
+    /** Retrieve a single feedback item by its fbk_-prefixed ID. */
+    retrieve(id: string, options?: RequestOptions): Promise<Feedback>;
+}
+//# sourceMappingURL=feedback.d.ts.map

package/dist/resources/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/resources/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,KAAK,EACV,QAAQ,EACR,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,gBAAiB,SAAQ,YAAY;IAChD;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrF;;;OAGG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAe/F,+DAA+D;IACzD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;CAMxE"}

package/dist/resources/feedback.js

@@ -0,0 +1,29 @@
+import { BaseResource } from '../resource.js';
+import { createList } from '../pagination.js';
+import { SignaError } from '../errors.js';
+export class FeedbackResource extends BaseResource {
+    /**
+     * Submit structured customer feedback (data issue, bug, feature request, or
+     * other). Free (never billed), org-scoped, idempotent via the standard
+     * Idempotency-Key header (auto-injected by the SDK).
+     */
+    async create(body, options) {
+        return this._post('/v1/feedback', body, options);
+    }
+    /**
+     * List feedback submitted by the authenticated organization. Cursor-paginated,
+     * newest-first. Filterable by type, status, and created-at range.
+     */
+    async list(params, options) {
+        const response = await this._getListResponse('/v1/feedback', params, options);
+        return createList(response, (cursor) => this._getListResponse('/v1/feedback', { ...params, cursor }, options));
+    }
+    /** Retrieve a single feedback item by its fbk_-prefixed ID. */
+    async retrieve(id, options) {
+        if (id === undefined || id === null || id === '') {
+            throw new SignaError('id is required and must be a non-empty string');
+        }
+        return this._get(`/v1/feedback/${id}`, undefined, options);
+    }
+}
+//# sourceMappingURL=feedback.js.map

package/dist/resources/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/resources/feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,IAA0B,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAW,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,MAA2B,EAAE,OAAwB;QAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,cAAc,EACd,MAAiC,EACjC,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACrC,IAAI,CAAC,gBAAgB,CACnB,cAAc,EACd,EAAE,GAAG,MAAM,EAAE,MAAM,EAA6B,EAChD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;QACjD,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAW,gBAAgB,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/resources/firms.d.ts

@@ -1,13 +1,14 @@
 import { BaseResource } from '../resource.js';
 import { type SignaList } from '../pagination.js';
-import type { Firm, FirmSummary, AttorneySummary, TrademarkSummary, FirmRetrieveParams, FirmListParams, FirmAttorneysParams, FirmTrademarksParams, RequestOptions } from '../types.js';
+import type { Firm, FirmSummary, AttorneySummary, TrademarkSummary, FirmRetrieveParams, FirmListParams, FirmAttorneysParams, FirmTrademarksParams, RequestOptions, AnalyticsReport } from '../types.js';
 export declare class Firms extends BaseResource {
+    analytics(id: string, options?: RequestOptions): Promise<AnalyticsReport>;
     /**
      * Retrieve a single firm by ID.
      *
      * ```typescript
-     * const firm = await signa.firms.retrieve('frm_abc123');
-     * const firm = await signa.firms.retrieve('frm_abc123', { include: ['stats', 'specializations', 'trend'] });
+     * const firm = await signa.firms.retrieve('firm_abc123');
+     * const firm = await signa.firms.retrieve('firm_abc123', { include: ['attorneys'] });
      * ```
      */
     retrieve(id: string, params?: FirmRetrieveParams, options?: RequestOptions): Promise<Firm>;
@@ -23,8 +24,8 @@ export declare class Firms extends BaseResource {
      * List a firm's attorneys.
      *
      * ```typescript
-     * const attorneys = await signa.firms.attorneys('frm_abc123');
-     * const attorneys = await signa.firms.attorneys('frm_abc123', { sort: '-trademark_count' });
+     * const attorneys = await signa.firms.attorneys('firm_abc123');
+     * const attorneys = await signa.firms.attorneys('firm_abc123', { sort: '-trademark_count' });
      * ```
      */
     attorneys(id: string, params?: FirmAttorneysParams, options?: RequestOptions): Promise<SignaList<AttorneySummary>>;
@@ -32,7 +33,7 @@ export declare class Firms extends BaseResource {
      * List a firm's trademarks.
      *
      * ```typescript
-     * const tms = await signa.firms.trademarks('frm_abc123', { status: 'registered' });
+     * const tms = await signa.firms.trademarks('firm_abc123', { status: 'registered' });
      * ```
      */
     trademarks(id: string, params?: FirmTrademarksParams, options?: RequestOptions): Promise<SignaList<TrademarkSummary>>;

package/dist/resources/firms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firms.d.ts","sourceRoot":"","sources":["../../src/resources/firms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,KAAM,SAAQ,YAAY;IACrC;;;;;;;OAOG;IACG,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAOhB;;;;;;OAMG;IACG,IAAI,CACR,MAAM,CAAC,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAQlC;;;;;;;OAOG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAatC;;;;;;OAMG;IACG,UAAU,CACd,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;CAYxC"}
+{"version":3,"file":"firms.d.ts","sourceRoot":"","sources":["../../src/resources/firms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,IAAI,EACJ,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB,qBAAa,KAAM,SAAQ,YAAY;IAC/B,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/E;;;;;;;OAOG;IACG,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAOhB;;;;;;OAMG;IACG,IAAI,CACR,MAAM,CAAC,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAQlC;;;;;;;OAOG;IACG,SAAS,CACb,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAatC;;;;;;OAMG;IACG,UAAU,CACd,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;CAYxC"}

package/dist/resources/firms.js

@@ -1,12 +1,16 @@
 import { BaseResource } from '../resource.js';
 import { createList } from '../pagination.js';
 export class Firms extends BaseResource {
+    async analytics(id, options) {
+        this._validateId(id);
+        return this._get(`/v1/firms/${encodeURIComponent(id)}/analytics`, undefined, options);
+    }
     /**
      * Retrieve a single firm by ID.
      *
      * ```typescript
-     * const firm = await signa.firms.retrieve('frm_abc123');
-     * const firm = await signa.firms.retrieve('frm_abc123', { include: ['stats', 'specializations', 'trend'] });
+     * const firm = await signa.firms.retrieve('firm_abc123');
+     * const firm = await signa.firms.retrieve('firm_abc123', { include: ['attorneys'] });
      * ```
      */
     async retrieve(id, params, options) {
@@ -33,8 +37,8 @@ export class Firms extends BaseResource {
      * List a firm's attorneys.
      *
      * ```typescript
-     * const attorneys = await signa.firms.attorneys('frm_abc123');
-     * const attorneys = await signa.firms.attorneys('frm_abc123', { sort: '-trademark_count' });
+     * const attorneys = await signa.firms.attorneys('firm_abc123');
+     * const attorneys = await signa.firms.attorneys('firm_abc123', { sort: '-trademark_count' });
      * ```
      */
     async attorneys(id, params, options) {
@@ -49,7 +53,7 @@ export class Firms extends BaseResource {
      * List a firm's trademarks.
      *
      * ```typescript
-     * const tms = await signa.firms.trademarks('frm_abc123', { status: 'registered' });
+     * const tms = await signa.firms.trademarks('firm_abc123', { status: 'registered' });
      * ```
      */
     async trademarks(id, params, options) {

package/dist/resources/firms.js.map

@@ -1 +1 @@
-{"version":3,"file":"firms.js","sourceRoot":"","sources":["../../src/resources/firms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAa9D,MAAM,OAAO,KAAM,SAAQ,YAAY;IACrC;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,MAA2B,EAC3B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAO,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YAC5D,OAAO,EAAE,MAAM,EAAE,OAAO;SACzB,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,MAAuB,EACvB,OAAwB;QAExB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAAc,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACzF,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CACb,EAAU,EACV,MAA4B,EAC5B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAC1B,aAAa,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAC/C,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EACrB,OAAO,CACR,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,EAAU,EACV,MAA6B,EAC7B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAC1B,aAAa,kBAAkB,CAAC,EAAE,CAAC,aAAa,EAChD,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EACrB,OAAO,CACR,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;CACF"}
+{"version":3,"file":"firms.js","sourceRoot":"","sources":["../../src/resources/firms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAc9D,MAAM,OAAO,KAAM,SAAQ,YAAY;IACrC,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,OAAwB;QAClD,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAkB,aAAa,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACzG,CAAC;IACD;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,MAA2B,EAC3B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAO,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YAC5D,OAAO,EAAE,MAAM,EAAE,OAAO;SACzB,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,MAAuB,EACvB,OAAwB;QAExB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAAc,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACzF,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CACb,EAAU,EACV,MAA4B,EAC5B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAC1B,aAAa,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAC/C,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EACrB,OAAO,CACR,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,EAAU,EACV,MAA6B,EAC7B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAC1B,aAAa,kBAAkB,CAAC,EAAE,CAAC,aAAa,EAChD,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EACrB,OAAO,CACR,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/resources/goods-services.d.ts

@@ -0,0 +1,56 @@
+import { BaseResource } from '../resource.js';
+import { type SignaList } from '../pagination.js';
+import type { GoodsServicesTerm, GoodsServicesListParams, GoodsServicesSuggestParams, GoodsServicesSuggestResult, RequestOptions } from '../types.js';
+/**
+ * Goods & services — the pre-approved-terms catalog (Harmonised Database +
+ * USPTO ID Manual) and the AI-assisted G&S specification drafter.
+ *
+ * - {@link GoodsServices.list} — browse/search the term catalog. At least
+ *   one of `q` or `class` must be provided.
+ * - {@link GoodsServices.suggest} — draft a filing-ready goods/services
+ *   specification from a natural-language description. Pass `class_number`
+ *   to scope the output to a single, already-chosen class.
+ */
+export declare class GoodsServices extends BaseResource {
+    /**
+     * Browse/search accepted goods & services terms. At least one of `q` or
+     * `class` must be provided.
+     *
+     * Scope: `trademarks:read`. Not billed (reference data).
+     *
+     * ```typescript
+     * // Scoped — autocomplete inside a class the user already selected
+     * const terms = await signa.goodsServices.list({ q: 'software', class: 9 });
+     *
+     * // Cross-class — "which classes accept this term?"
+     * const poster = await signa.goodsServices.list({ q: 'poster' });
+     * ```
+     */
+    list(params: GoodsServicesListParams, options?: RequestOptions): Promise<SignaList<GoodsServicesTerm>>;
+    /**
+     * Draft a goods/services specification for a natural-language description.
+     * Returns ranked Nice classes with filing-ready wording per class, grounded
+     * in the pre-approved term catalog (Harmonised Database + USPTO ID Manual).
+     *
+     * Pass `class_number` to restrict the response to a single, already-chosen
+     * class (useful when refining wording inside a class the caller has already
+     * picked).
+     *
+     * Scope: `trademarks:read`. Billed as 2 credits.
+     *
+     * ```typescript
+     * // Full draft across all relevant classes
+     * const spec = await signa.goodsServices.suggest({
+     *   description: 'e-commerce company selling sneakers',
+     * });
+     *
+     * // Refine wording for a known class
+     * const refined = await signa.goodsServices.suggest({
+     *   description: 'running shoes',
+     *   class_number: 25,
+     * });
+     * ```
+     */
+    suggest(body: GoodsServicesSuggestParams, options?: RequestOptions): Promise<GoodsServicesSuggestResult>;
+}
+//# sourceMappingURL=goods-services.d.ts.map

package/dist/resources/goods-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goods-services.d.ts","sourceRoot":"","sources":["../../src/resources/goods-services.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C;;;;;;;;;;;;;OAaG;IACG,IAAI,CACR,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAexC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,OAAO,CACX,IAAI,EAAE,0BAA0B,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,0BAA0B,CAAC;CAOvC"}

package/dist/resources/goods-services.js

@@ -0,0 +1,60 @@
+import { BaseResource } from '../resource.js';
+import { createList } from '../pagination.js';
+/**
+ * Goods & services — the pre-approved-terms catalog (Harmonised Database +
+ * USPTO ID Manual) and the AI-assisted G&S specification drafter.
+ *
+ * - {@link GoodsServices.list} — browse/search the term catalog. At least
+ *   one of `q` or `class` must be provided.
+ * - {@link GoodsServices.suggest} — draft a filing-ready goods/services
+ *   specification from a natural-language description. Pass `class_number`
+ *   to scope the output to a single, already-chosen class.
+ */
+export class GoodsServices extends BaseResource {
+    /**
+     * Browse/search accepted goods & services terms. At least one of `q` or
+     * `class` must be provided.
+     *
+     * Scope: `trademarks:read`. Not billed (reference data).
+     *
+     * ```typescript
+     * // Scoped — autocomplete inside a class the user already selected
+     * const terms = await signa.goodsServices.list({ q: 'software', class: 9 });
+     *
+     * // Cross-class — "which classes accept this term?"
+     * const poster = await signa.goodsServices.list({ q: 'poster' });
+     * ```
+     */
+    async list(params, options) {
+        const response = await this._getListResponse('/v1/goods-services', params, options);
+        return createList(response, (cursor) => this._getListResponse('/v1/goods-services', { ...params, cursor }, options));
+    }
+    /**
+     * Draft a goods/services specification for a natural-language description.
+     * Returns ranked Nice classes with filing-ready wording per class, grounded
+     * in the pre-approved term catalog (Harmonised Database + USPTO ID Manual).
+     *
+     * Pass `class_number` to restrict the response to a single, already-chosen
+     * class (useful when refining wording inside a class the caller has already
+     * picked).
+     *
+     * Scope: `trademarks:read`. Billed as 2 credits.
+     *
+     * ```typescript
+     * // Full draft across all relevant classes
+     * const spec = await signa.goodsServices.suggest({
+     *   description: 'e-commerce company selling sneakers',
+     * });
+     *
+     * // Refine wording for a known class
+     * const refined = await signa.goodsServices.suggest({
+     *   description: 'running shoes',
+     *   class_number: 25,
+     * });
+     * ```
+     */
+    async suggest(body, options) {
+        return this._post('/v1/goods-services/suggest', body, options);
+    }
+}
+//# sourceMappingURL=goods-services.js.map

package/dist/resources/goods-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goods-services.js","sourceRoot":"","sources":["../../src/resources/goods-services.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAS9D;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,CACR,MAA+B,EAC/B,OAAwB;QAExB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,oBAAoB,EACpB,MAA4C,EAC5C,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACrC,IAAI,CAAC,gBAAgB,CACnB,oBAAoB,EACpB,EAAE,GAAG,MAAM,EAAE,MAAM,EAAwC,EAC3D,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,OAAO,CACX,IAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,KAAK,CACf,4BAA4B,EAC5B,IAAI,EACJ,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/oppositions.d.ts

@@ -0,0 +1,18 @@
+import { BaseResource } from '../resource.js';
+import { type SignaList } from '../pagination.js';
+import type { OppositionComputeParams, OppositionWindowComputation, RequestOptions } from '../types.js';
+export declare class Oppositions extends BaseResource {
+    /**
+     * Compute opposition windows for one or more published marks.
+     *
+     * Scope: `trademarks:read`. Billed as 1 unit per item.
+     *
+     * ```typescript
+     * const windows = await signa.oppositions.compute({
+     *   items: [{ office: 'EM', publication_date: '2026-05-01' }],
+     * });
+     * ```
+     */
+    compute(body: OppositionComputeParams, options?: RequestOptions): Promise<SignaList<OppositionWindowComputation>>;
+}
+//# sourceMappingURL=oppositions.d.ts.map

package/dist/resources/oppositions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oppositions.d.ts","sourceRoot":"","sources":["../../src/resources/oppositions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,uBAAuB,EAEvB,2BAA2B,EAC3B,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,WAAY,SAAQ,YAAY;IAC3C;;;;;;;;;;OAUG;IACG,OAAO,CACX,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;CAUnD"}

package/dist/resources/oppositions.js

@@ -0,0 +1,20 @@
+import { BaseResource } from '../resource.js';
+import { createList } from '../pagination.js';
+export class Oppositions extends BaseResource {
+    /**
+     * Compute opposition windows for one or more published marks.
+     *
+     * Scope: `trademarks:read`. Billed as 1 unit per item.
+     *
+     * ```typescript
+     * const windows = await signa.oppositions.compute({
+     *   items: [{ office: 'EM', publication_date: '2026-05-01' }],
+     * });
+     * ```
+     */
+    async compute(body, options) {
+        const response = await this._post('/v1/oppositions/compute', body, options);
+        return createList({ ...response, has_more: false }, () => Promise.resolve({ ...response, data: [], has_more: false }));
+    }
+}
+//# sourceMappingURL=oppositions.js.map

package/dist/resources/oppositions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oppositions.js","sourceRoot":"","sources":["../../src/resources/oppositions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAQ9D,MAAM,OAAO,WAAY,SAAQ,YAAY;IAC3C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CACX,IAA6B,EAC7B,OAAwB;QAExB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAC/B,yBAAyB,EACzB,IAAI,EACJ,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CACvD,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAC5D,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/organization.d.ts

@@ -0,0 +1,56 @@
+import { BaseResource } from '../resource.js';
+import { type SignaList } from '../pagination.js';
+import type { FetchConfig } from '../_internals/fetch-with-retry.js';
+import type { Identity, Usage, ApiKey, ApiKeyWithRawKey, DeletedResponse, ApiKeyCreateParams, ApiKeyUpdateParams, RequestLog, RequestLogDetail, UsageSummaryParams, UsageSummaryResponse, CreditBalance, LogListParams, RequestOptions } from '../types.js';
+declare class ApiKeys extends BaseResource {
+    /** Create a new API key. Returns the raw key once. */
+    create(body: ApiKeyCreateParams, options?: RequestOptions): Promise<ApiKeyWithRawKey>;
+    /** List organization's active API keys. */
+    list(options?: RequestOptions): Promise<SignaList<ApiKey>>;
+    /** Retrieve an API key. */
+    retrieve(id: string, options?: RequestOptions): Promise<ApiKey>;
+    /** Update an API key. */
+    update(id: string, body: ApiKeyUpdateParams, options?: RequestOptions): Promise<ApiKey>;
+    /** Revoke (soft-delete) an API key. */
+    revoke(id: string, options?: RequestOptions): Promise<DeletedResponse>;
+    /** Rotate an API key. Old key expires in 24h. Returns new raw key. */
+    rotate(id: string, options?: RequestOptions): Promise<ApiKeyWithRawKey>;
+}
+declare class Logs extends BaseResource {
+    /**
+     * List request logs for the org (paginated).
+     *
+     * Per-plan retention limits apply: `free` → 7 days, `starter` → 30 days,
+     * `beta`/`pro`/`enterprise` → 90 days. Defaults to the last 24 hours.
+     */
+    list(params?: LogListParams, options?: RequestOptions): Promise<SignaList<RequestLog>>;
+    /** Retrieve a single request log by request_id. */
+    retrieve(requestId: string, options?: RequestOptions): Promise<RequestLogDetail>;
+}
+export declare class Organization extends BaseResource {
+    /** API key management. */
+    readonly apiKeys: ApiKeys;
+    /** Request log access. */
+    readonly logs: Logs;
+    constructor(config: FetchConfig);
+    /** Get the authenticated identity (org, plan, key info). */
+    me(options?: RequestOptions): Promise<Identity>;
+    /** Get billing period usage and rate limit info. */
+    usage(options?: RequestOptions): Promise<Usage>;
+    /**
+     * Get the pooled credit balance: the spendable balance, a breakdown of
+     * remaining credits by grant type (plan vs addon vs promo), and the
+     * per-grant expiry schedule in consumption order.
+     */
+    credits(options?: RequestOptions): Promise<CreditBalance>;
+    /**
+     * Get daily usage breakdown from pre-aggregated rollups plus current
+     * billing period quota context.
+     *
+     * Named `usageSummary` (not nested under `usage`) because `usage` is a
+     * method on this class, not a namespace.
+     */
+    usageSummary(params: UsageSummaryParams, options?: RequestOptions): Promise<UsageSummaryResponse>;
+}
+export {};
+//# sourceMappingURL=organization.d.ts.map

package/dist/resources/organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../../src/resources/organization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,KAAK,EACV,QAAQ,EACR,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,cAAM,OAAQ,SAAQ,YAAY;IAChC,sDAAsD;IAChD,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI3F,2CAA2C;IACrC,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAOhE,2BAA2B;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrE,yBAAyB;IACnB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7F,uCAAuC;IACjC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAK5E,sEAAsE;IAChE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAI9E;AAED,cAAM,IAAK,SAAQ,YAAY;IAC7B;;;;;OAKG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAO5F,mDAAmD;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAQvF;AAED,qBAAa,YAAa,SAAQ,YAAY;IAC5C,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;gBAER,MAAM,EAAE,WAAW;IAM/B,4DAA4D;IACtD,EAAE,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIrD,oDAAoD;IAC9C,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAIrD;;;;OAIG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAI/D;;;;;;OAMG;IACG,YAAY,CAChB,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,oBAAoB,CAAC;CAGjC"}