@signa-so/sdk 0.2.2 → 0.4.0

package/dist/index.d.ts

@@ -2,5 +2,7 @@ export { Signa } from './client.js';
 export { Signa as default } from './client.js';
 export { SignaError, SignaAPIError, BadRequestError, AuthenticationError, PermissionError, NotFoundError, ConflictError, RateLimitError, InternalServerError, ConnectionError, TimeoutError, } from './errors.js';
 export { SignaList } from './pagination.js';
-export type { Trademark, TrademarkSummary, Event, Owner, OwnerSummary, Attorney, AttorneySummary, Firm, FirmSummary, Proceeding, ProceedingDetail, SearchV2Result, CrossEntitySuggestion, Classification, ClassificationDetail, GoodsServicesTerm, Office, OfficeDetail, Jurisdiction, JurisdictionDetail, DeadlineRules, Status, EventType, DesignCode, DesignCodeDetail, TrademarkSource, TrademarkCoverage, TrademarkProceeding, OwnerRelated, Portfolio, SavedSearch, Watch, Alert, OrgEvent, OrgEventDetail, Identity, Usage, ApiKey, ApiKeyWithRawKey, DeletedResponse, SearchMeta, APIErrorBody, AttorneyStats, OwnerStats, FirmStats, Specializations, TopClient, TopAttorney, JurisdictionEntry, TrendEntry, TrademarkBatchBody, TrademarkBatchResponse, TrademarkChange, TrademarkRelationship, TrademarkSuggestion, AttorneyClient, TrademarkRetrieveParams, TrademarkListParams, TrademarkHistoryParams, TrademarkChangesParams, TrademarkRelatedParams, TrademarkSuggestParams, TrademarkCoverageParams, TrademarkProceedingsParams, OwnerRetrieveParams, OwnerListParams, OwnerTrademarksParams, OwnerRelatedParams, AttorneyRetrieveParams, AttorneyListParams, AttorneyTrademarksParams, AttorneyClientsParams, FirmRetrieveParams, FirmListParams, FirmAttorneysParams, FirmTrademarksParams, ProceedingListParams, SearchV2Body, CrossEntitySuggestParams, ClassificationListParams, ClassificationTermsParams, DesignCodeListParams, StatusListParams, PortfolioCreateParams, PortfolioUpdateParams, PortfolioListParams, PortfolioRetrieveParams, PortfolioAddMarksBody, PortfolioRemoveMarksBody, PortfolioDeadlineParams, PortfolioDeadlinesIcalParams, SavedSearchCreateParams, SavedSearchUpdateParams, SavedSearchListParams, SavedSearchExecuteParams, WatchCreateParams, WatchUpdateParams, WatchListParams, AlertListParams, AlertUpdateStatusBody, AlertBatchUpdateBody, OrgEventListParams, ApiKeyCreateParams, ApiKeyUpdateParams, RequestOptions, ClientOptions, } from './types.js';
+export { verifyWebhookSignature } from './webhooks.js';
+export type { WebhookSignatureHeaders } from './webhooks.js';
+export type { Trademark, TrademarkSummary, Event, Owner, OwnerSummary, EntitySummary, EntityDetail, EntityMember, EntityMemberLink, EntityCompany, EntityFamily, EntityFamilyNode, Attorney, AttorneySummary, Firm, FirmSummary, Proceeding, ProceedingDetail, SearchV2Result, CrossEntitySuggestion, Classification, ClassificationDetail, AcceptedTerm, ClassificationSuggestionLite, ClassificationSuggestResult, GoodsServicesSuggestionClass, GoodsServicesSuggestResult, GoodsServicesTerm, Office, OfficeDetail, Jurisdiction, JurisdictionDetail, DeadlineRule, OppositionRule, RuleSource, Status, EventType, DesignCode, DesignCodeDetail, TrademarkSource, TrademarkCoverage, TrademarkProceeding, OwnerRelated, Portfolio, SavedSearch, Watch, WatchType, WatchStatus, WatchDeliveryMode, WatchTriggerEvent, WatchQuery, WatchPreviewResponse, WatchDiagnostics, WatchDiagnosticsLeaseState, WatchDiagnosticsWindowStatus, Alert, AlertEventType, AlertSeverity, OppositionWindowStatus, Webhook, WebhookDisabledReason, WebhookEvent, WebhookEventType, WebhookStatus, WebhookDelivery, WebhookDeliveryStatus, WebhookTestResponse, WebhookRedeliveryResponse, AlertCreatedPayload, AlertCreatedEvent, OrgEvent, OrgEventDetail, Identity, Usage, ApiKey, ApiKeyWithRawKey, RequestLog, RequestLogDetail, UsageSummaryResponse, UsageSummaryItem, UsageBillingPeriod, DeletedResponse, SearchMeta, APIErrorBody, AttorneyStats, OwnerStats, FirmStats, TrademarkBatchBody, TrademarkBatchResponse, TrademarkChange, TrademarkRelationship, TrademarkSuggestion, AttorneyClient, TrademarkRetrieveParams, TrademarkListParams, TrademarkHistoryParams, TrademarkChangesParams, TrademarkRelatedParams, TrademarkSuggestParams, TrademarkCoverageParams, TrademarkProceedingsParams, OwnerRetrieveParams, OwnerListParams, OwnerTrademarksParams, OwnerRelatedParams, EntityRetrieveParams, EntityListParams, EntityTrademarksParams, EntityFamilyParams, AttorneyRetrieveParams, AttorneyListParams, AttorneyTrademarksParams, AttorneyClientsParams, FirmRetrieveParams, FirmListParams, FirmAttorneysParams, FirmTrademarksParams, ProceedingListParams, TrademarkSearchBody, SearchV2Body, CrossEntitySuggestParams, ClassificationListParams, ClassificationSuggestParams, DesignCodeListParams, GoodsServicesListParams, GoodsServicesSuggestParams, PortfolioCreateParams, PortfolioUpdateParams, PortfolioListParams, PortfolioRetrieveParams, PortfolioAddTrademarksBody, PortfolioRemoveTrademarksBody, PortfolioDeadlineParams, PortfolioDeadlinesIcalParams, SavedSearchCreateParams, SavedSearchUpdateParams, SavedSearchListParams, SavedSearchExecuteParams, WatchCreateParams, WatchCreateQueryParams, WatchUpdateParams, WatchListParams, WatchReplayParams, WatchPreviewParams, WatchBulkParams, WatchDiagnosticsParams, AlertListParams, AlertLookupParams, WebhookCreateParams, WebhookUpdateParams, WebhookListParams, WebhookDeliveryListParams, OrgEventListParams, ApiKeyCreateParams, ApiKeyUpdateParams, LogListParams, UsageSummaryParams, RequestOptions, ClientOptions, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,YAAY,EAEV,SAAS,EACT,gBAAgB,EAChB,KAAK,EACL,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,IAAI,EACJ,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,MAAM,EACN,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,WAAW,EACX,KAAK,EACL,KAAK,EACL,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,EAEZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,eAAe,EACf,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,UAAU,EAEV,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAE1B,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EAEpB,YAAY,EACZ,wBAAwB,EAExB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,gBAAgB,EAEhB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B,EAE5B,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EAExB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAEf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EAEpB,kBAAkB,EAElB,kBAAkB,EAClB,kBAAkB,EAElB,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,4 +4,6 @@ export { Signa as default } from './client.js';
 export { SignaError, SignaAPIError, BadRequestError, AuthenticationError, PermissionError, NotFoundError, ConflictError, RateLimitError, InternalServerError, ConnectionError, TimeoutError, } from './errors.js';
 // ── Pagination ──────────────────────────────────────────────────────
 export { SignaList } from './pagination.js';
+// ── Webhooks helper ─────────────────────────────────────────────────
+export { verifyWebhookSignature } from './webhooks.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAE/C,uEAAuE;AACvE,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,uEAAuE;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AAE/C,uEAAuE;AACvE,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,uEAAuE;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,uEAAuE;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/pagination.d.ts

@@ -36,7 +36,7 @@ export declare class SignaList<T> implements AsyncIterable<T> {
      * Async iterator that yields items across all pages.
      *
      * ```typescript
-     * for await (const trademark of signa.trademarks.list({ jurisdiction_code: 'US' })) {
+     * for await (const trademark of signa.trademarks.list({ jurisdictions: ['US'] })) {
      *   console.log(trademark.mark_text);
      * }
      * ```

package/dist/pagination.js

@@ -55,7 +55,7 @@ export class SignaList {
      * Async iterator that yields items across all pages.
      *
      * ```typescript
-     * for await (const trademark of signa.trademarks.list({ jurisdiction_code: 'US' })) {
+     * for await (const trademark of signa.trademarks.list({ jurisdictions: ['US'] })) {
      *   console.log(trademark.mark_text);
      * }
      * ```

package/dist/resources/alerts.d.ts

@@ -1,20 +1,25 @@
 import { BaseResource } from '../resource.js';
 import { type SignaList } from '../pagination.js';
-import type { Alert, AlertListParams, AlertUpdateStatusBody, AlertBatchUpdateBody, RequestOptions } from '../types.js';
+import type { Alert, AlertListParams, RequestOptions } from '../types.js';
+/**
+ * Alert operations — monitoring v1 (TSK-111).
+ *
+ * **Read-only.** Alerts are immutable in the canonical layer (VAL-API-018b).
+ * The legacy `acknowledge` / `dismiss` / batch routes were removed in
+ * Phase 4. Customers track open work in their own systems (or our
+ * dashboard's saved-view layer); the canonical alert is the immutable
+ * fact of "this watch matched this trademark version at this time."
+ */
 export declare class Alerts extends BaseResource {
-    /** List all organization alerts. */
+    /** List alerts for the calling org (cursor pagination, max 100/page). */
     list(params?: AlertListParams, options?: RequestOptions): Promise<SignaList<Alert>>;
-    /** Retrieve an alert. */
+    /** Retrieve a single alert. */
     retrieve(id: string, options?: RequestOptions): Promise<Alert>;
-    /** Update an alert's status. */
-    updateStatus(id: string, body: AlertUpdateStatusBody, options?: RequestOptions): Promise<Alert>;
-    /** Convenience: acknowledge an alert. */
-    acknowledge(id: string, options?: RequestOptions): Promise<Alert>;
-    /** Convenience: dismiss an alert. */
-    dismiss(id: string, options?: RequestOptions): Promise<Alert>;
-    /** Batch update alert statuses. */
-    batchUpdate(body: AlertBatchUpdateBody, options?: RequestOptions): Promise<{
-        updated: number;
-    }>;
+    /**
+     * Bulk-fetch alerts by ID (max 100). Useful for polling clients that
+     * want to confirm a batch of `webhook-id` values. Org-scoped — alerts
+     * belonging to other orgs are silently dropped from the result.
+     */
+    lookup(ids: string[], options?: RequestOptions): Promise<Alert[]>;
 }
 //# sourceMappingURL=alerts.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/resources/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,MAAO,SAAQ,YAAY;IACtC,oCAAoC;IAC9B,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAezF,yBAAyB;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAKpE,gCAAgC;IAC1B,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAKrG,yCAAyC;IACnC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAIvE,qCAAqC;IAC/B,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAInE,mCAAmC;IAC7B,WAAW,CAAC,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGtG"}
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/resources/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EAEf,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,qBAAa,MAAO,SAAQ,YAAY;IACtC,yEAAyE;IACnE,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAOzF,+BAA+B;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAKpE;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAaxE"}

package/dist/resources/alerts.js

@@ -1,32 +1,40 @@
 import { BaseResource } from '../resource.js';
 import { createList } from '../pagination.js';
+/**
+ * Alert operations — monitoring v1 (TSK-111).
+ *
+ * **Read-only.** Alerts are immutable in the canonical layer (VAL-API-018b).
+ * The legacy `acknowledge` / `dismiss` / batch routes were removed in
+ * Phase 4. Customers track open work in their own systems (or our
+ * dashboard's saved-view layer); the canonical alert is the immutable
+ * fact of "this watch matched this trademark version at this time."
+ */
 export class Alerts extends BaseResource {
-    /** List all organization alerts. */
+    /** List alerts for the calling org (cursor pagination, max 100/page). */
     async list(params, options) {
-        const response = await this._getListResponse('/v1/alerts', params, options);
-        return createList(response, (cursor) => this._getListResponse('/v1/alerts', { ...params, cursor }, options));
+        const fetchPage = async (cursor) => this._getListResponse('/v1/alerts', { ...params, cursor }, options);
+        const firstPage = await fetchPage(params?.cursor);
+        return createList(firstPage, fetchPage);
     }
-    /** Retrieve an alert. */
+    /** Retrieve a single alert. */
     async retrieve(id, options) {
         this._validateId(id);
         return this._get(`/v1/alerts/${encodeURIComponent(id)}`, undefined, options);
     }
-    /** Update an alert's status. */
-    async updateStatus(id, body, options) {
-        this._validateId(id);
-        return this._patch(`/v1/alerts/${encodeURIComponent(id)}`, body, options);
-    }
-    /** Convenience: acknowledge an alert. */
-    async acknowledge(id, options) {
-        return this.updateStatus(id, { status: 'acknowledged' }, options);
-    }
-    /** Convenience: dismiss an alert. */
-    async dismiss(id, options) {
-        return this.updateStatus(id, { status: 'dismissed' }, options);
-    }
-    /** Batch update alert statuses. */
-    async batchUpdate(body, options) {
-        return this._post('/v1/alerts/batch', body, options);
+    /**
+     * Bulk-fetch alerts by ID (max 100). Useful for polling clients that
+     * want to confirm a batch of `webhook-id` values. Org-scoped — alerts
+     * belonging to other orgs are silently dropped from the result.
+     */
+    async lookup(ids, options) {
+        if (!Array.isArray(ids) || ids.length === 0)
+            return [];
+        if (ids.length > 100) {
+            throw new Error('alerts.lookup() accepts at most 100 IDs per call.');
+        }
+        const body = { ids };
+        const res = await this._post('/v1/alerts/lookup', body, options);
+        return res.data;
     }
 }
 //# sourceMappingURL=alerts.js.map

package/dist/resources/alerts.js.map

@@ -1 +1 @@
-{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/resources/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAS9D,MAAM,OAAO,MAAO,SAAQ,YAAY;IACtC,oCAAoC;IACpC,KAAK,CAAC,IAAI,CAAC,MAAwB,EAAE,OAAwB;QAC3D,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,yBAAyB;IACzB,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;QACjD,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAQ,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,IAA2B,EAAE,OAAwB;QAClF,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAQ,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,WAAW,CAAC,EAAU,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,WAAW,CAAC,IAA0B,EAAE,OAAwB;QACpE,OAAO,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF"}
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/resources/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAQ9D;;;;;;;;GAQG;AACH,MAAM,OAAO,MAAO,SAAQ,YAAY;IACtC,yEAAyE;IACzE,KAAK,CAAC,IAAI,CAAC,MAAwB,EAAE,OAAwB;QAC3D,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE,CAC1C,IAAI,CAAC,gBAAgB,CAAQ,YAAY,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7E,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;QACjD,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAQ,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,GAAa,EAAE,OAAwB;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvD,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,IAAI,GAAsB,EAAE,GAAG,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAC1B,mBAAmB,EACnB,IAAI,EACJ,OAAO,CACR,CAAC;QACF,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;CACF"}

package/dist/resources/attorneys.d.ts

@@ -5,12 +5,15 @@ export declare class Attorneys extends BaseResource {
     /**
      * Retrieve a single attorney by ID.
      *
+     * Always returns the full detail tier: canonical name, firm linkage,
+     * country, address, aliases, identifiers, and scalar stats when computed.
+     * There are no optional `include` relations on attorney detail.
+     *
      * ```typescript
      * const attorney = await signa.attorneys.retrieve('att_abc123');
-     * const attorney = await signa.attorneys.retrieve('att_abc123', { include: ['recent_trademarks', 'stats', 'specializations'] });
      * ```
      */
-    retrieve(id: string, params?: AttorneyRetrieveParams, options?: RequestOptions): Promise<Attorney>;
+    retrieve(id: string, _params?: AttorneyRetrieveParams, options?: RequestOptions): Promise<Attorney>;
     /**
      * List attorneys with optional search and filters.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"attorneys.d.ts","sourceRoot":"","sources":["../../src/resources/attorneys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,SAAU,SAAQ,YAAY;IACzC;;;;;;;OAOG;IACG,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC;IAOpB;;;;;;OAMG;IACG,IAAI,CACR,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAQtC;;;;;;OAMG;IACG,UAAU,CACd,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAavC;;;;;;OAMG;IACG,OAAO,CACX,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;CAetC"}
+{"version":3,"file":"attorneys.d.ts","sourceRoot":"","sources":["../../src/resources/attorneys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,SAAU,SAAQ,YAAY;IACzC;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,sBAAsB,EAChC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,QAAQ,CAAC;IAKpB;;;;;;OAMG;IACG,IAAI,CACR,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAQtC;;;;;;OAMG;IACG,UAAU,CACd,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAavC;;;;;;OAMG;IACG,OAAO,CACX,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;CAetC"}

package/dist/resources/attorneys.js

@@ -4,16 +4,17 @@ export class Attorneys extends BaseResource {
     /**
      * Retrieve a single attorney by ID.
      *
+     * Always returns the full detail tier: canonical name, firm linkage,
+     * country, address, aliases, identifiers, and scalar stats when computed.
+     * There are no optional `include` relations on attorney detail.
+     *
      * ```typescript
      * const attorney = await signa.attorneys.retrieve('att_abc123');
-     * const attorney = await signa.attorneys.retrieve('att_abc123', { include: ['recent_trademarks', 'stats', 'specializations'] });
      * ```
      */
-    async retrieve(id, params, options) {
+    async retrieve(id, _params, options) {
         this._validateId(id);
-        return this._get(`/v1/attorneys/${encodeURIComponent(id)}`, {
-            include: params?.include,
-        }, options);
+        return this._get(`/v1/attorneys/${encodeURIComponent(id)}`, undefined, options);
     }
     /**
      * List attorneys with optional search and filters.

package/dist/resources/attorneys.js.map

@@ -1 +1 @@
-{"version":3,"file":"attorneys.js","sourceRoot":"","sources":["../../src/resources/attorneys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAa9D,MAAM,OAAO,SAAU,SAAQ,YAAY;IACzC;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,MAA+B,EAC/B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAW,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE;YACpE,OAAO,EAAE,MAAM,EAAE,OAAO;SACzB,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,MAA2B,EAC3B,OAAwB;QAExB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAAkB,eAAe,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACjG,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,MAAiC,EACjC,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAC1B,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,aAAa,EACpD,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,OAAO,CACX,EAAU,EACV,MAA8B,EAC9B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EACjD,MAAiC,EACjC,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACrC,IAAI,CAAC,gBAAgB,CACnB,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EACjD,EAAE,GAAG,MAAM,EAAE,MAAM,EAA6B,EAChD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"attorneys.js","sourceRoot":"","sources":["../../src/resources/attorneys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAa9D,MAAM,OAAO,SAAU,SAAQ,YAAY;IACzC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,OAAgC,EAChC,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,IAAI,CAAW,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,MAA2B,EAC3B,OAAwB;QAExB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAAkB,eAAe,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACjG,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,MAAiC,EACjC,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,SAAS,GAAG,KAAK,EAAE,MAAe,EAAE,EAAE;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAC1B,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,aAAa,EACpD,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,OAAO,CACX,EAAU,EACV,MAA8B,EAC9B,OAAwB;QAExB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EACjD,MAAiC,EACjC,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACrC,IAAI,CAAC,gBAAgB,CACnB,iBAAiB,kBAAkB,CAAC,EAAE,CAAC,UAAU,EACjD,EAAE,GAAG,MAAM,EAAE,MAAM,EAA6B,EAChD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/entities.d.ts

@@ -0,0 +1,52 @@
+import { BaseResource } from '../resource.js';
+import { type SignaList } from '../pagination.js';
+import type { EntityDetail, EntitySummary, EntityFamily, TrademarkSummary, EntityRetrieveParams, EntityListParams, EntityTrademarksParams, EntityFamilyParams, 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 {
+    /**
+     * 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,cAAc,EACf,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,YAAY;IACxC;;;;;;;;;;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,70 @@
+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 {
+    /**
+     * 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;AAa9D;;;;;;GAMG;AACH,MAAM,OAAO,QAAS,SAAQ,YAAY;IACxC;;;;;;;;;;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/firms.d.ts

@@ -6,8 +6,8 @@ export declare class Firms extends BaseResource {
      * 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: ['stats', 'specializations', 'trend'] });
      * ```
      */
     retrieve(id: string, params?: FirmRetrieveParams, options?: RequestOptions): Promise<Firm>;
@@ -23,8 +23,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 +32,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.js

@@ -5,8 +5,8 @@ export class Firms extends BaseResource {
      * 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: ['stats', 'specializations', 'trend'] });
      * ```
      */
     async retrieve(id, params, options) {
@@ -33,8 +33,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 +49,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/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 units.
+     *
+     * ```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 units.
+     *
+     * ```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/{platform.d.ts → organization.d.ts}

@@ -1,7 +1,7 @@
 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, RequestOptions } from '../types.js';
+import type { Identity, Usage, ApiKey, ApiKeyWithRawKey, DeletedResponse, ApiKeyCreateParams, ApiKeyUpdateParams, RequestLog, RequestLogDetail, UsageSummaryParams, UsageSummaryResponse, 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>;
@@ -16,14 +16,35 @@ declare class ApiKeys extends BaseResource {
     /** Rotate an API key. Old key expires in 24h. Returns new raw key. */
     rotate(id: string, options?: RequestOptions): Promise<ApiKeyWithRawKey>;
 }
-export declare class Platform extends BaseResource {
+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 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=platform.d.ts.map
+//# sourceMappingURL=organization.d.ts.map