@signa-so/sdk 0.2.0

package/README.md

@@ -0,0 +1,180 @@
+# @signa/sdk
+
+Official TypeScript SDK for the Signa trademark intelligence API.
+
+## Installation
+
+```bash
+npm install @signa/sdk
+```
+
+## Quick Start
+
+```ts
+import Signa from '@signa/sdk';
+
+const signa = new Signa({ api_key: 'sig_live_xxx' });
+
+// Retrieve a trademark
+const tm = await signa.trademarks.retrieve('tm_abc123');
+
+// Search trademarks
+const results = await signa.search.query({ query: 'nike', office: 'USPTO' });
+
+// List with auto-pagination
+const page = await signa.trademarks.list({ limit: 50 });
+for (const tm of page.data) {
+  console.log(tm.mark_text);
+}
+```
+
+## Configuration
+
+```ts
+const signa = new Signa({
+  api_key: 'sig_live_xxx',       // Required (or set SIGNA_API_KEY env var)
+  base_url: 'https://api.signa.so',  // Default
+  timeout: 30_000,                    // 30s default
+  max_retries: 2,                     // Automatic retry with backoff
+  debug: false,                       // Log request/response details
+  fetch: customFetch,                 // Custom fetch implementation
+});
+```
+
+## Resources
+
+All resources follow the same pattern: `.retrieve(id)`, `.list(params)`, plus resource-specific methods.
+
+### `signa.trademarks`
+
+```ts
+await signa.trademarks.retrieve('tm_xxx');
+await signa.trademarks.retrieve('tm_xxx', { expand: ['owners', 'attorneys'] });
+await signa.trademarks.list({ office: 'USPTO', status: 'registered', limit: 50 });
+await signa.trademarks.history('tm_xxx');
+```
+
+### `signa.owners`
+
+```ts
+await signa.owners.retrieve('own_xxx');
+await signa.owners.list({ query: 'Nike', country: 'US' });
+await signa.owners.trademarks('own_xxx');
+```
+
+### `signa.attorneys`
+
+```ts
+await signa.attorneys.retrieve('att_xxx');
+await signa.attorneys.list({ query: 'Smith' });
+await signa.attorneys.trademarks('att_xxx');
+```
+
+### `signa.firms`
+
+```ts
+await signa.firms.retrieve('firm_xxx');
+await signa.firms.list({ query: 'Baker McKenzie' });
+await signa.firms.attorneys('firm_xxx');
+await signa.firms.trademarks('firm_xxx');
+```
+
+### `signa.proceedings`
+
+```ts
+await signa.proceedings.retrieve('prc_xxx');
+await signa.proceedings.list({ trademark_id: 'tm_xxx' });
+```
+
+### `signa.search`
+
+```ts
+await signa.search.query({
+  query: 'nike',
+  office: 'USPTO',
+  status: 'registered',
+  nice_class: [25, 35],
+  from: 0,
+  size: 20,
+});
+
+await signa.search.suggest({ query: 'nik', size: 5 });
+```
+
+### `signa.references`
+
+```ts
+await signa.references.classifications();   // Nice classes
+await signa.references.offices();           // Trademark offices
+await signa.references.jurisdictions();     // Jurisdictions
+await signa.references.statuses();          // Status codes
+await signa.references.eventTypes();        // Event types
+```
+
+## Error Handling
+
+All API errors throw typed exceptions for `instanceof` checks:
+
+```ts
+try {
+  await signa.trademarks.retrieve('tm_invalid');
+} catch (err) {
+  if (err instanceof Signa.NotFoundError) {
+    console.log('Not found:', err.message);
+  } else if (err instanceof Signa.RateLimitError) {
+    console.log('Rate limited, retry after:', err.retryAfter);
+  } else if (err instanceof Signa.AuthenticationError) {
+    console.log('Bad API key');
+  }
+}
+```
+
+**Error hierarchy:**
+
+| Class | HTTP Status | Description |
+|-------|-------------|-------------|
+| `SignaError` | — | Base class (network errors, timeouts) |
+| `SignaAPIError` | Any | Base for all API errors |
+| `BadRequestError` | 400 | Invalid parameters |
+| `AuthenticationError` | 401 | Missing or invalid API key |
+| `PermissionError` | 403 | Insufficient scope |
+| `NotFoundError` | 404 | Resource not found |
+| `RateLimitError` | 429 | Rate limit exceeded |
+| `InternalServerError` | 500 | Server error |
+| `ConnectionError` | — | Network connectivity failure |
+| `TimeoutError` | — | Request timeout |
+
+## Pagination
+
+List endpoints return a `SignaList` with cursor-based pagination:
+
+```ts
+const page = await signa.trademarks.list({ limit: 100 });
+
+console.log(page.data);        // Trademark[]
+console.log(page.has_more);    // boolean
+console.log(page.next_cursor); // string | null
+```
+
+## Type Generation
+
+The SDK auto-generates types from the API's OpenAPI spec:
+
+```bash
+bun run generate:types    # Regenerate from API OpenAPI spec
+bun run check:types-sync  # Verify types are up-to-date (CI check)
+```
+
+## Scripts
+
+```bash
+bun run build       # Compile TypeScript
+bun run test        # Run tests (uses msw for API mocking)
+bun run dev         # Watch mode
+bun run typecheck   # Type check
+```
+
+## Requirements
+
+- Node.js >= 18 (uses native `fetch`)
+- MIT License

package/dist/_internals/fetch-with-retry.d.ts

@@ -0,0 +1,31 @@
+import type { RequestOptions } from '../types.js';
+export interface FetchConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeout: number;
+    maxRetries: number;
+    debug: boolean;
+    fetch: typeof globalThis.fetch;
+}
+export interface FetchRequest {
+    method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    path: string;
+    body?: unknown;
+    options?: RequestOptions;
+    /** Override the default Accept header (e.g., 'text/calendar' for iCal). */
+    accept?: string;
+    /** When true, return the raw response text instead of parsing JSON. */
+    rawResponse?: boolean;
+    /** Set to 'manual' to capture redirect URLs instead of following them. */
+    redirect?: 'follow' | 'manual';
+}
+/**
+ * Execute an HTTP request with timeout, retries, and error mapping.
+ * Returns the parsed JSON body.
+ */
+export declare function fetchWithRetry(config: FetchConfig, request: FetchRequest): Promise<{
+    body: unknown;
+    headers: Headers;
+    status: number;
+}>;
+//# sourceMappingURL=fetch-with-retry.d.ts.map

package/dist/_internals/fetch-with-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-with-retry.d.ts","sourceRoot":"","sources":["../../src/_internals/fetch-with-retry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA+H9D"}

package/dist/_internals/fetch-with-retry.js

@@ -0,0 +1,113 @@
+import { ConnectionError, TimeoutError, createAPIError } from '../errors.js';
+import { shouldRetry, getRetryDelay, sleep } from './retry.js';
+import { SDK_VERSION } from '../version.js';
+/**
+ * Execute an HTTP request with timeout, retries, and error mapping.
+ * Returns the parsed JSON body.
+ */
+export async function fetchWithRetry(config, request) {
+    const timeout = request.options?.timeout ?? config.timeout;
+    const maxRetries = request.options?.max_retries ?? config.maxRetries;
+    const url = `${config.baseUrl}${request.path}`;
+    const headers = {
+        'Authorization': `Bearer ${config.apiKey}`,
+        'Accept': request.accept ?? 'application/json',
+        'User-Agent': `signa-sdk-typescript/${SDK_VERSION}`,
+        'X-Signa-Client': `typescript/${SDK_VERSION}`,
+        ...(request.body !== undefined && { 'Content-Type': 'application/json' }),
+        ...request.options?.headers,
+    };
+    if (request.options?.idempotency_key) {
+        headers['Idempotency-Key'] = request.options.idempotency_key;
+    }
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        if (attempt > 0) {
+            const delay = getRetryDelay(lastError, attempt - 1);
+            if (config.debug) {
+                console.error(`[signa] Retrying in ${Math.round(delay)}ms (attempt ${attempt + 1}/${maxRetries + 1})`);
+            }
+            await sleep(delay);
+        }
+        // ── 1. Fire the request (catch only network/timeout errors) ─────
+        let response;
+        try {
+            if (config.debug) {
+                console.error(`[signa] → ${request.method} ${url} (attempt ${attempt + 1}/${maxRetries + 1})`);
+            }
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            try {
+                response = await config.fetch(url, {
+                    method: request.method,
+                    headers,
+                    body: request.body !== undefined ? JSON.stringify(request.body) : undefined,
+                    signal: controller.signal,
+                    redirect: request.redirect ?? 'follow',
+                });
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+        catch (e) {
+            // AbortController abort → timeout
+            if (e instanceof DOMException && e.name === 'AbortError') {
+                const timeoutError = new TimeoutError(timeout);
+                if (shouldRetry(timeoutError, attempt, maxRetries)) {
+                    lastError = timeoutError;
+                    continue;
+                }
+                throw timeoutError;
+            }
+            // Network error (DNS failure, connection refused, etc.)
+            const connError = new ConnectionError(`Connection failed: ${e instanceof Error ? e.message : String(e)}`, e instanceof Error ? e : undefined);
+            if (shouldRetry(connError, attempt, maxRetries)) {
+                lastError = connError;
+                continue;
+            }
+            throw connError;
+        }
+        // ── 2. Handle the response (no try/catch — errors throw directly) ─
+        if (config.debug) {
+            const reqId = response.headers.get('x-request-id') ?? '';
+            console.error(`[signa] ← ${response.status} ${response.statusText} ${reqId}`);
+        }
+        // Handle manual redirects — return the Location header as body
+        if (request.redirect === 'manual' && response.status >= 300 && response.status < 400) {
+            const location = response.headers.get('location') ?? '';
+            return { body: location, headers: response.headers, status: response.status };
+        }
+        if (response.ok) {
+            const body = request.rawResponse
+                ? await response.text()
+                : await response.json();
+            return { body, headers: response.headers, status: response.status };
+        }
+        // Error response — parse body and create typed error
+        let errorBody;
+        try {
+            errorBody = await response.json();
+        }
+        catch {
+            errorBody = {
+                error: {
+                    type: 'https://api.signa.so/errors/unknown',
+                    title: 'Unknown Error',
+                    status: response.status,
+                    detail: `HTTP ${response.status} ${response.statusText}`,
+                },
+                request_id: response.headers.get('x-request-id') ?? 'unknown',
+            };
+        }
+        const apiError = createAPIError(response.status, errorBody, response.headers);
+        if (shouldRetry(apiError, attempt, maxRetries)) {
+            lastError = apiError;
+            continue;
+        }
+        throw apiError;
+    }
+    // Should not reach here, but if it does, throw the last error
+    throw lastError;
+}
+//# sourceMappingURL=fetch-with-retry.js.map

package/dist/_internals/fetch-with-retry.js.map

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

package/dist/_internals/query-string.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Build a URL query string from a params object.
+ * - Undefined/null values are omitted
+ * - Arrays with bracket keys (e.g., `jurisdictions[]`) emit repeated params
+ * - Other arrays are serialized as comma-separated (e.g., `include`)
+ * - Numbers are stringified
+ * - Bracket-notation keys like 'filing_date[gte]' pass through as-is
+ */
+export declare function buildQueryString(params: Record<string, unknown>): string;
+//# sourceMappingURL=query-string.d.ts.map

package/dist/_internals/query-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-string.d.ts","sourceRoot":"","sources":["../../src/_internals/query-string.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAwBxE"}

package/dist/_internals/query-string.js

@@ -0,0 +1,34 @@
+/**
+ * Build a URL query string from a params object.
+ * - Undefined/null values are omitted
+ * - Arrays with bracket keys (e.g., `jurisdictions[]`) emit repeated params
+ * - Other arrays are serialized as comma-separated (e.g., `include`)
+ * - Numbers are stringified
+ * - Bracket-notation keys like 'filing_date[gte]' pass through as-is
+ */
+export function buildQueryString(params) {
+    const parts = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            if (value.length > 0) {
+                if (key.endsWith('[]')) {
+                    // Repeated params for bracket-notation array keys
+                    for (const item of value) {
+                        parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`);
+                    }
+                }
+                else {
+                    // Comma-separated for non-bracket keys (e.g., include)
+                    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(value.join(','))}`);
+                }
+            }
+        }
+        else {
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+        }
+    }
+    return parts.length > 0 ? `?${parts.join('&')}` : '';
+}
+//# sourceMappingURL=query-string.js.map

package/dist/_internals/query-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-string.js","sourceRoot":"","sources":["../../src/_internals/query-string.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA+B;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAEpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,kDAAkD;oBAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC/E,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,uDAAuD;oBACvD,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC"}

package/dist/_internals/retry.d.ts

@@ -0,0 +1,7 @@
+/** Calculate backoff delay with jitter. */
+export declare function calculateBackoff(attempt: number): number;
+/** Get the delay before the next retry attempt. */
+export declare function getRetryDelay(error: unknown, attempt: number): number;
+export declare function shouldRetry(error: unknown, attempt: number, maxRetries: number): boolean;
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/_internals/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/_internals/retry.ts"],"names":[],"mappings":"AAEA,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAGxF;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/_internals/retry.js

@@ -0,0 +1,23 @@
+import { isRetryable, RateLimitError } from '../errors.js';
+/** Calculate backoff delay with jitter. */
+export function calculateBackoff(attempt) {
+    const base = Math.min(500 * 2 ** attempt, 8000);
+    const jitter = Math.random() * 500;
+    return base + jitter;
+}
+/** Get the delay before the next retry attempt. */
+export function getRetryDelay(error, attempt) {
+    if (error instanceof RateLimitError && error.retry_after > 0) {
+        return error.retry_after * 1000;
+    }
+    return calculateBackoff(attempt);
+}
+export function shouldRetry(error, attempt, maxRetries) {
+    if (attempt >= maxRetries)
+        return false;
+    return isRetryable(error);
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/_internals/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/_internals/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE3D,2CAA2C;AAC3C,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,OAAO,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;IACnC,OAAO,IAAI,GAAG,MAAM,CAAC;AACvB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,OAAe;IAC3D,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;IAClC,CAAC;IACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,OAAe,EAAE,UAAkB;IAC7E,IAAI,OAAO,IAAI,UAAU;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,68 @@
+import type { ClientOptions } from './types.js';
+import { SignaError, SignaAPIError, BadRequestError, AuthenticationError, PermissionError, NotFoundError, ConflictError, RateLimitError, InternalServerError, ConnectionError, TimeoutError } from './errors.js';
+import { Trademarks } from './resources/trademarks.js';
+import { Owners } from './resources/owners.js';
+import { Attorneys } from './resources/attorneys.js';
+import { Firms } from './resources/firms.js';
+import { Proceedings } from './resources/proceedings.js';
+import { Search } from './resources/search.js';
+import { References } from './resources/references.js';
+import { Portfolios } from './resources/portfolios.js';
+import { SavedSearches } from './resources/saved-searches.js';
+import { Watches } from './resources/watches.js';
+import { Alerts } from './resources/alerts.js';
+import { Events } from './resources/events.js';
+import { Platform } from './resources/platform.js';
+/**
+ * Signa API client.
+ *
+ * ```typescript
+ * import Signa from '@signa/sdk';
+ *
+ * const signa = new Signa({ api_key: 'sig_live_xxx' });
+ * const tm = await signa.trademarks.retrieve('tm_abc123');
+ * ```
+ */
+export declare class Signa {
+    static readonly SignaError: typeof SignaError;
+    static readonly SignaAPIError: typeof SignaAPIError;
+    static readonly BadRequestError: typeof BadRequestError;
+    static readonly AuthenticationError: typeof AuthenticationError;
+    static readonly PermissionError: typeof PermissionError;
+    static readonly NotFoundError: typeof NotFoundError;
+    static readonly ConflictError: typeof ConflictError;
+    static readonly RateLimitError: typeof RateLimitError;
+    static readonly InternalServerError: typeof InternalServerError;
+    static readonly ConnectionError: typeof ConnectionError;
+    static readonly TimeoutError: typeof TimeoutError;
+    /** Trademark operations: retrieve, list, history. */
+    readonly trademarks: Trademarks;
+    /** Owner operations: retrieve, list, trademarks. */
+    readonly owners: Owners;
+    /** Attorney operations: retrieve, list, trademarks. */
+    readonly attorneys: Attorneys;
+    /** Firm operations: retrieve, list, attorneys, trademarks. */
+    readonly firms: Firms;
+    /** Proceeding operations: retrieve, list. */
+    readonly proceedings: Proceedings;
+    /** Search operations: query, suggest. */
+    readonly search: Search;
+    /** Reference data: classifications, offices, jurisdictions, statuses, event types, design codes. */
+    readonly references: References;
+    /** Portfolio management: CRUD, marks, deadlines. */
+    readonly portfolios: Portfolios;
+    /** Saved search management: CRUD, re-execute. */
+    readonly savedSearches: SavedSearches;
+    /** Watch management: CRUD, watch-scoped alerts. */
+    readonly watches: Watches;
+    /** Alert operations: list, retrieve, acknowledge, dismiss, batch. */
+    readonly alerts: Alerts;
+    /** Event stream: list, retrieve with diffs. */
+    readonly events: Events;
+    /** Platform: identity, usage, API key management. */
+    readonly platform: Platform;
+    /** @internal */
+    private readonly _config;
+    constructor(opts?: ClientOptions);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EACL,UAAU,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAMnD;;;;;;;;;GASG;AACH,qBAAa,KAAK;IAEhB,MAAM,CAAC,QAAQ,CAAC,UAAU,oBAAc;IACxC,MAAM,CAAC,QAAQ,CAAC,aAAa,uBAAiB;IAC9C,MAAM,CAAC,QAAQ,CAAC,eAAe,yBAAmB;IAClD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,6BAAuB;IAC1D,MAAM,CAAC,QAAQ,CAAC,eAAe,yBAAmB;IAClD,MAAM,CAAC,QAAQ,CAAC,aAAa,uBAAiB;IAC9C,MAAM,CAAC,QAAQ,CAAC,aAAa,uBAAiB;IAC9C,MAAM,CAAC,QAAQ,CAAC,cAAc,wBAAkB;IAChD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,6BAAuB;IAC1D,MAAM,CAAC,QAAQ,CAAC,eAAe,yBAAmB;IAClD,MAAM,CAAC,QAAQ,CAAC,YAAY,sBAAgB;IAE5C,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,oGAAoG;IACpG,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,iDAAiD;IACjD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE5B,gBAAgB;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,IAAI,GAAE,aAAkB;CA+BrC"}

package/dist/client.js

@@ -0,0 +1,104 @@
+import { SignaError, SignaAPIError, BadRequestError, AuthenticationError, PermissionError, NotFoundError, ConflictError, RateLimitError, InternalServerError, ConnectionError, TimeoutError, } from './errors.js';
+import { Trademarks } from './resources/trademarks.js';
+import { Owners } from './resources/owners.js';
+import { Attorneys } from './resources/attorneys.js';
+import { Firms } from './resources/firms.js';
+import { Proceedings } from './resources/proceedings.js';
+import { Search } from './resources/search.js';
+import { References } from './resources/references.js';
+import { Portfolios } from './resources/portfolios.js';
+import { SavedSearches } from './resources/saved-searches.js';
+import { Watches } from './resources/watches.js';
+import { Alerts } from './resources/alerts.js';
+import { Events } from './resources/events.js';
+import { Platform } from './resources/platform.js';
+const DEFAULT_BASE_URL = 'https://api.signa.so';
+const DEFAULT_TIMEOUT = 30_000;
+const DEFAULT_MAX_RETRIES = 2;
+/**
+ * Signa API client.
+ *
+ * ```typescript
+ * import Signa from '@signa/sdk';
+ *
+ * const signa = new Signa({ api_key: 'sig_live_xxx' });
+ * const tm = await signa.trademarks.retrieve('tm_abc123');
+ * ```
+ */
+export class Signa {
+    // ── Static error classes (enables Signa.NotFoundError pattern) ────
+    static SignaError = SignaError;
+    static SignaAPIError = SignaAPIError;
+    static BadRequestError = BadRequestError;
+    static AuthenticationError = AuthenticationError;
+    static PermissionError = PermissionError;
+    static NotFoundError = NotFoundError;
+    static ConflictError = ConflictError;
+    static RateLimitError = RateLimitError;
+    static InternalServerError = InternalServerError;
+    static ConnectionError = ConnectionError;
+    static TimeoutError = TimeoutError;
+    /** Trademark operations: retrieve, list, history. */
+    trademarks;
+    /** Owner operations: retrieve, list, trademarks. */
+    owners;
+    /** Attorney operations: retrieve, list, trademarks. */
+    attorneys;
+    /** Firm operations: retrieve, list, attorneys, trademarks. */
+    firms;
+    /** Proceeding operations: retrieve, list. */
+    proceedings;
+    /** Search operations: query, suggest. */
+    search;
+    /** Reference data: classifications, offices, jurisdictions, statuses, event types, design codes. */
+    references;
+    /** Portfolio management: CRUD, marks, deadlines. */
+    portfolios;
+    /** Saved search management: CRUD, re-execute. */
+    savedSearches;
+    /** Watch management: CRUD, watch-scoped alerts. */
+    watches;
+    /** Alert operations: list, retrieve, acknowledge, dismiss, batch. */
+    alerts;
+    /** Event stream: list, retrieve with diffs. */
+    events;
+    /** Platform: identity, usage, API key management. */
+    platform;
+    /** @internal */
+    _config;
+    constructor(opts = {}) {
+        const apiKey = opts.api_key ?? readEnv('SIGNA_API_KEY');
+        if (!apiKey) {
+            throw new SignaError('API key is required. Pass { api_key: "sig_live_..." } or set the SIGNA_API_KEY environment variable.');
+        }
+        this._config = {
+            apiKey,
+            baseUrl: (opts.base_url ?? DEFAULT_BASE_URL).replace(/\/+$/, ''),
+            timeout: opts.timeout ?? DEFAULT_TIMEOUT,
+            maxRetries: opts.max_retries ?? DEFAULT_MAX_RETRIES,
+            debug: opts.debug ?? false,
+            fetch: opts.fetch ?? globalThis.fetch,
+        };
+        this.trademarks = new Trademarks(this._config);
+        this.owners = new Owners(this._config);
+        this.attorneys = new Attorneys(this._config);
+        this.firms = new Firms(this._config);
+        this.proceedings = new Proceedings(this._config);
+        this.search = new Search(this._config);
+        this.references = new References(this._config);
+        this.portfolios = new Portfolios(this._config);
+        this.savedSearches = new SavedSearches(this._config);
+        this.watches = new Watches(this._config);
+        this.alerts = new Alerts(this._config);
+        this.events = new Events(this._config);
+        this.platform = new Platform(this._config);
+    }
+}
+/** Safely read an env var (works in Node, Bun, Deno; no-op in browsers/edge). */
+function readEnv(name) {
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env[name];
+    }
+    return undefined;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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