@signa-so/sdk 0.2.0

package/dist/resources/trademarks.js

@@ -0,0 +1,117 @@
+import { BaseResource } from '../resource.js';
+import { createList } from '../pagination.js';
+export class Trademarks extends BaseResource {
+    /**
+     * Retrieve a single trademark by ID.
+     *
+     * ```typescript
+     * const tm = await signa.trademarks.retrieve('tm_abc123');
+     * const tm = await signa.trademarks.retrieve('tm_abc123', { include: ['owners', 'history'] });
+     * ```
+     */
+    async retrieve(id, params, options) {
+        return this._get(`/v1/trademarks/${encodeURIComponent(id)}`, {
+            include: params?.include,
+            fields: params?.fields,
+        }, options);
+    }
+    /**
+     * List trademarks with filters. At least one filter is required.
+     * Returns a SignaList supporting auto-pagination.
+     *
+     * ```typescript
+     * const page = await signa.trademarks.list({ jurisdiction_code: 'US', status: 'registered' });
+     *
+     * for await (const tm of signa.trademarks.list({ jurisdiction_code: 'US' })) {
+     *   console.log(tm.mark_text);
+     * }
+     * ```
+     */
+    async list(params, options) {
+        const fetchPage = async (cursor) => {
+            return this._getListResponse('/v1/trademarks', { ...params, cursor }, options);
+        };
+        const firstPage = await fetchPage(params?.cursor);
+        return createList(firstPage, fetchPage);
+    }
+    /**
+     * List event history for a trademark.
+     *
+     * ```typescript
+     * const events = await signa.trademarks.history('tm_abc123');
+     * const filtered = await signa.trademarks.history('tm_abc123', { event_type: 'status_change' });
+     * ```
+     */
+    async history(id, params, options) {
+        const fetchPage = async (cursor) => {
+            return this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/history`, { ...params, cursor }, options);
+        };
+        const firstPage = await fetchPage(params?.cursor);
+        return createList(firstPage, fetchPage);
+    }
+    /**
+     * Look up multiple trademarks by ID or office identifiers.
+     *
+     * ```typescript
+     * const result = await signa.trademarks.batch({ ids: ['tm_abc', 'tm_def'] });
+     * const result = await signa.trademarks.batch({
+     *   identifiers: [{ application_number: '97123456', office: 'uspto' }],
+     * });
+     * ```
+     */
+    async batch(body, options) {
+        return this._post('/v1/trademarks/batch', body, options);
+    }
+    /**
+     * Version-level change history for a trademark.
+     *
+     * ```typescript
+     * const changes = await signa.trademarks.changes('tm_abc123');
+     * ```
+     */
+    async changes(id, params, options) {
+        const response = await this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/changes`, params, options);
+        return createList(response, (cursor) => this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/changes`, { ...params, cursor }, options));
+    }
+    /**
+     * Mark-to-mark relationships for a trademark.
+     *
+     * ```typescript
+     * const related = await signa.trademarks.related('tm_abc123');
+     * ```
+     */
+    async related(id, params, options) {
+        const response = await this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/related`, params, options);
+        return createList(response, (cursor) => this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/related`, { ...params, cursor }, options));
+    }
+    /**
+     * Trademark-specific autocomplete suggestions.
+     *
+     * ```typescript
+     * const suggestions = await signa.trademarks.suggest({ q: 'apple' });
+     * ```
+     */
+    async suggest(params, options) {
+        const response = await this._getListResponse('/v1/trademarks/suggest', params, options);
+        return createList({ ...response, has_more: false }, () => Promise.resolve({ ...response, data: [], has_more: false }));
+    }
+    /** Source provenance metadata for a trademark. */
+    async source(id, options) {
+        return this._get(`/v1/trademarks/${encodeURIComponent(id)}/source`, undefined, options);
+    }
+    /** Madrid IR coverage (designation territories) for a trademark. */
+    async coverage(id, params, options) {
+        const response = await this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/coverage`, params, options);
+        return createList(response, (cursor) => this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/coverage`, { ...params, cursor }, options));
+    }
+    /** Proceedings (oppositions, cancellations) linked to a trademark. */
+    async proceedings(id, params, options) {
+        const response = await this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/proceedings`, params, options);
+        return createList(response, (cursor) => this._getListResponse(`/v1/trademarks/${encodeURIComponent(id)}/proceedings`, { ...params, cursor }, options));
+    }
+    /** Get the redirect URL for a trademark media asset (image, sound, etc). */
+    async media(id, mediaId, options) {
+        return this._getRedirectUrl(`/v1/trademarks/${encodeURIComponent(id)}/media/${encodeURIComponent(mediaId)}`, options);
+    }
+}
+//# sourceMappingURL=trademarks.js.map

package/dist/resources/trademarks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trademarks.js","sourceRoot":"","sources":["../../src/resources/trademarks.ts"],"names":[],"mappings":"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"}

package/dist/resources/watches.d.ts

@@ -0,0 +1,18 @@
+import { BaseResource } from '../resource.js';
+import { type SignaList } from '../pagination.js';
+import type { Watch, Alert, DeletedResponse, WatchCreateParams, WatchUpdateParams, WatchListParams, AlertListParams, RequestOptions } from '../types.js';
+export declare class Watches extends BaseResource {
+    /** Create a watch. */
+    create(body: WatchCreateParams, options?: RequestOptions): Promise<Watch>;
+    /** List organization's watches. */
+    list(params?: WatchListParams, options?: RequestOptions): Promise<SignaList<Watch>>;
+    /** Retrieve a watch. */
+    retrieve(id: string, options?: RequestOptions): Promise<Watch>;
+    /** Update a watch. */
+    update(id: string, body: WatchUpdateParams, options?: RequestOptions): Promise<Watch>;
+    /** Soft-delete a watch. */
+    delete(id: string, options?: RequestOptions): Promise<DeletedResponse>;
+    /** List alerts for a specific watch. */
+    alerts(id: string, params?: Omit<AlertListParams, 'watch_id'>, options?: RequestOptions): Promise<SignaList<Alert>>;
+}
+//# sourceMappingURL=watches.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watches.d.ts","sourceRoot":"","sources":["../../src/resources/watches.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,KAAK,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,qBAAa,OAAQ,SAAQ,YAAY;IACvC,sBAAsB;IAChB,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAI/E,mCAAmC;IAC7B,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAezF,wBAAwB;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpE,sBAAsB;IAChB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;IAI3F,2BAA2B;IACrB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAI5E,wCAAwC;IAClC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;CAc1H"}

package/dist/resources/watches.js

@@ -0,0 +1,31 @@
+import { BaseResource } from '../resource.js';
+import { createList } from '../pagination.js';
+export class Watches extends BaseResource {
+    /** Create a watch. */
+    async create(body, options) {
+        return this._post('/v1/watches', body, options);
+    }
+    /** List organization's watches. */
+    async list(params, options) {
+        const response = await this._getListResponse('/v1/watches', params, options);
+        return createList(response, (cursor) => this._getListResponse('/v1/watches', { ...params, cursor }, options));
+    }
+    /** Retrieve a watch. */
+    async retrieve(id, options) {
+        return this._get(`/v1/watches/${encodeURIComponent(id)}`, undefined, options);
+    }
+    /** Update a watch. */
+    async update(id, body, options) {
+        return this._patch(`/v1/watches/${encodeURIComponent(id)}`, body, options);
+    }
+    /** Soft-delete a watch. */
+    async delete(id, options) {
+        return this._delete(`/v1/watches/${encodeURIComponent(id)}`, options);
+    }
+    /** List alerts for a specific watch. */
+    async alerts(id, params, options) {
+        const response = await this._getListResponse(`/v1/watches/${encodeURIComponent(id)}/alerts`, params, options);
+        return createList(response, (cursor) => this._getListResponse(`/v1/watches/${encodeURIComponent(id)}/alerts`, { ...params, cursor }, options));
+    }
+}
+//# sourceMappingURL=watches.js.map

package/dist/resources/watches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watches.js","sourceRoot":"","sources":["../../src/resources/watches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAY9D,MAAM,OAAO,OAAQ,SAAQ,YAAY;IACvC,sBAAsB;IACtB,KAAK,CAAC,MAAM,CAAC,IAAuB,EAAE,OAAwB;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAQ,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,IAAI,CAAC,MAAwB,EAAE,OAAwB;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,aAAa,EACb,MAAiC,EACjC,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACrC,IAAI,CAAC,gBAAgB,CACnB,aAAa,EACb,EAAE,GAAG,MAAM,EAAE,MAAM,EAA6B,EAChD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,IAAI,CAAQ,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvF,CAAC;IAED,sBAAsB;IACtB,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAAuB,EAAE,OAAwB;QACxE,OAAO,IAAI,CAAC,MAAM,CAAQ,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAkB,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACzF,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,MAA0C,EAAE,OAAwB;QAC3F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,eAAe,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAC9C,MAAiC,EACjC,OAAO,CACR,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CACrC,IAAI,CAAC,gBAAgB,CACnB,eAAe,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAC9C,EAAE,GAAG,MAAM,EAAE,MAAM,EAA6B,EAChD,OAAO,CACR,CACF,CAAC;IACJ,CAAC;CACF"}