@airstore/sdk 0.1.0

package/dist/cjs/resources/tokens.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tokens = void 0;
+/**
+ * Manage workspace-scoped authentication tokens.
+ *
+ * Tokens are used for CLI mounting (`airstore start --token <token>`)
+ * and per-workspace programmatic access.
+ *
+ * @example
+ * ```ts
+ * const token = await airstore.tokens.create("ws_abc", {
+ *   email: "agent@internal",
+ *   name: "vm-mount",
+ * });
+ * // token.token -> pass to: airstore start --token <this>
+ * ```
+ */
+class Tokens {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a workspace-scoped token.
+     *
+     * Either `memberId` or `email` must be provided. If `email` is given
+     * and no member with that email exists, one is auto-created.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param params - Token creation parameters.
+     * @param options - Per-request overrides.
+     * @returns The created token with raw value (shown once — store it safely).
+     */
+    async create(workspaceId, params, options) {
+        const body = {};
+        if (params.memberId !== undefined)
+            body['member_id'] = params.memberId;
+        if (params.email !== undefined)
+            body['email'] = params.email;
+        if (params.name !== undefined)
+            body['name'] = params.name;
+        if (params.expiresIn !== undefined)
+            body['expires_in'] = params.expiresIn;
+        return this.client.request('POST', `/workspaces/${workspaceId}/tokens`, body, undefined, options);
+    }
+    /**
+     * List tokens in a workspace.
+     *
+     * Raw token values are never returned — only metadata.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param options - Per-request overrides.
+     * @returns Array of token metadata.
+     */
+    async list(workspaceId, options) {
+        return this.client.request('GET', `/workspaces/${workspaceId}/tokens`, undefined, undefined, options);
+    }
+    /**
+     * Revoke (delete) a token. Once revoked, the token can no longer be used.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param tokenId - Token external ID.
+     * @param options - Per-request overrides.
+     *
+     * @throws {NotFoundError} If the token doesn't exist.
+     */
+    async revoke(workspaceId, tokenId, options) {
+        await this.client.request('DELETE', `/workspaces/${workspaceId}/tokens/${tokenId}`, undefined, undefined, options);
+    }
+}
+exports.Tokens = Tokens;
+//# sourceMappingURL=tokens.js.map

package/dist/cjs/resources/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/resources/tokens.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAa,MAAM;IACY;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,MAAyB,EACzB,OAAwB;QAExB,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QACvE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAC7D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QAC1D,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;QAE1E,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,eAAe,WAAW,SAAS,EACnC,IAAI,EACJ,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,SAAS,EACnC,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,OAAe,EACf,OAAwB;QAExB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,QAAQ,EACR,eAAe,WAAW,WAAW,OAAO,EAAE,EAC9C,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AA3ED,wBA2EC"}

package/dist/cjs/resources/workspaces.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Workspaces = void 0;
+/**
+ * Manage workspaces.
+ *
+ * Workspaces are the top-level container for connections, smart folders,
+ * members, and the virtual filesystem. When using an organization token,
+ * workspaces are automatically scoped to the token's tenant.
+ *
+ * @example
+ * ```ts
+ * const ws = await airstore.workspaces.create({ name: "user-123" });
+ * console.log(ws.external_id);
+ * ```
+ */
+class Workspaces {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new workspace.
+     *
+     * When called with an organization token, the workspace is automatically
+     * tagged with the token's `tenant_id`.
+     *
+     * @param params - Workspace creation parameters.
+     * @param options - Per-request overrides.
+     * @returns The newly created workspace.
+     *
+     * @throws {AuthenticationError} If the API key is invalid or missing.
+     * @throws {PermissionDeniedError} If the token lacks workspace creation rights.
+     */
+    async create(params, options) {
+        return this.client.request('POST', '/workspaces', params, undefined, options);
+    }
+    /**
+     * List all workspaces accessible to the authenticated token.
+     *
+     * Organization tokens only see workspaces belonging to their tenant.
+     * Cluster admin tokens see all workspaces.
+     *
+     * @param options - Per-request overrides.
+     * @returns Array of workspaces.
+     */
+    async list(options) {
+        return this.client.request('GET', '/workspaces', undefined, undefined, options);
+    }
+    /**
+     * Retrieve a workspace by its external ID.
+     *
+     * @param id - Workspace external ID (UUID).
+     * @param options - Per-request overrides.
+     * @returns The workspace.
+     *
+     * @throws {NotFoundError} If the workspace doesn't exist.
+     */
+    async retrieve(id, options) {
+        return this.client.request('GET', `/workspaces/${id}`, undefined, undefined, options);
+    }
+    /**
+     * Delete a workspace and all associated data.
+     *
+     * @param id - Workspace external ID (UUID).
+     * @param options - Per-request overrides.
+     *
+     * @throws {NotFoundError} If the workspace doesn't exist.
+     */
+    async del(id, options) {
+        await this.client.request('DELETE', `/workspaces/${id}`, undefined, undefined, options);
+    }
+}
+exports.Workspaces = Workspaces;
+//# sourceMappingURL=workspaces.js.map

package/dist/cjs/resources/workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../../src/resources/workspaces.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;GAYG;AACH,MAAa,UAAU;IACQ;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,MAAM,CACV,MAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,aAAa,EACb,MAAM,EACN,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CAAC,OAAwB;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,aAAa,EACb,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,EAAE,EAAE,EACnB,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,GAAG,CAAC,EAAU,EAAE,OAAwB;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,QAAQ,EACR,eAAe,EAAE,EAAE,EACnB,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;CACF;AApFD,gCAoFC"}

package/dist/cjs/types/connections.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=connections.js.map

package/dist/cjs/types/connections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.js","sourceRoot":"","sources":["../../../src/types/connections.ts"],"names":[],"mappings":""}

package/dist/cjs/types/filesystem.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=filesystem.js.map

package/dist/cjs/types/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../src/types/filesystem.ts"],"names":[],"mappings":""}

package/dist/cjs/types/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./shared.js"), exports);
+__exportStar(require("./workspaces.js"), exports);
+__exportStar(require("./connections.js"), exports);
+__exportStar(require("./smart-folders.js"), exports);
+__exportStar(require("./tokens.js"), exports);
+__exportStar(require("./members.js"), exports);
+__exportStar(require("./oauth.js"), exports);
+__exportStar(require("./filesystem.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,kDAAgC;AAChC,mDAAiC;AACjC,qDAAmC;AACnC,8CAA4B;AAC5B,+CAA6B;AAC7B,6CAA2B;AAC3B,kDAAgC"}

package/dist/cjs/types/members.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=members.js.map

package/dist/cjs/types/members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.js","sourceRoot":"","sources":["../../../src/types/members.ts"],"names":[],"mappings":""}

package/dist/cjs/types/oauth.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=oauth.js.map

package/dist/cjs/types/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../src/types/oauth.ts"],"names":[],"mappings":""}

package/dist/cjs/types/shared.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=shared.js.map

package/dist/cjs/types/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/types/shared.ts"],"names":[],"mappings":""}

package/dist/cjs/types/smart-folders.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=smart-folders.js.map

package/dist/cjs/types/smart-folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-folders.js","sourceRoot":"","sources":["../../../src/types/smart-folders.ts"],"names":[],"mappings":""}

package/dist/cjs/types/tokens.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tokens.js.map

package/dist/cjs/types/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../../src/types/tokens.ts"],"names":[],"mappings":""}

package/dist/cjs/types/workspaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=workspaces.js.map

package/dist/cjs/types/workspaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../../src/types/workspaces.ts"],"names":[],"mappings":""}

package/dist/cjs/version.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+/** SDK version. Injected during build. */
+exports.VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/cjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAAA,0CAA0C;AAC7B,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/esm/airstore.js

@@ -0,0 +1,123 @@
+import { CoreClient } from './client.js';
+import { Workspaces } from './resources/workspaces.js';
+import { Connections } from './resources/connections.js';
+import { SmartFolders } from './resources/smart-folders.js';
+import { Tokens } from './resources/tokens.js';
+import { Members } from './resources/members.js';
+import { OAuth } from './resources/oauth.js';
+import { Filesystem } from './resources/filesystem.js';
+/**
+ * The Airstore SDK client.
+ *
+ * Create an instance with your API key to interact with workspaces,
+ * connections, smart folders, tokens, members, the virtual filesystem,
+ * and OAuth sessions.
+ *
+ * @example Basic provisioning flow
+ * ```ts
+ * import Airstore from '@airstore/sdk';
+ *
+ * const airstore = new Airstore({ apiKey: 'org_...' });
+ *
+ * // 1. Create a workspace for a new user
+ * const ws = await airstore.workspaces.create({ name: 'user-123' });
+ *
+ * // 2. Connect their Gmail with existing OAuth tokens
+ * await airstore.connections.create(ws.external_id, {
+ *   integrationType: 'gmail',
+ *   accessToken: existingAccessToken,
+ *   refreshToken: existingRefreshToken,
+ * });
+ *
+ * // 3. Set up a smart folder
+ * await airstore.smartFolders.create(ws.external_id, {
+ *   integration: 'gmail',
+ *   name: 'Recent Emails',
+ *   guidance: 'Last 7 days of emails from the inbox',
+ * });
+ *
+ * // 4. Generate a mount token for the user's VM
+ * const token = await airstore.tokens.create(ws.external_id, {
+ *   email: 'agent@internal',
+ *   name: 'vm-mount',
+ * });
+ * // Pass token.token to: airstore start --token <token>
+ * ```
+ *
+ * @example Per-request options
+ * ```ts
+ * const ws = await airstore.workspaces.list({
+ *   timeout: 10_000,
+ *   maxRetries: 5,
+ * });
+ * ```
+ */
+export class Airstore extends CoreClient {
+    /**
+     * Manage workspaces.
+     *
+     * Workspaces are the top-level container for connections, smart folders,
+     * members, and the virtual filesystem.
+     */
+    workspaces;
+    /**
+     * Manage connections (integrations) within a workspace.
+     *
+     * Pass existing OAuth tokens or API keys to connect external services
+     * like Gmail, GitHub, Notion, etc.
+     */
+    connections;
+    /**
+     * Manage smart folders (filesystem queries).
+     *
+     * Smart folders use LLM inference to automatically organize and filter
+     * data from connected integrations into virtual folders or files.
+     */
+    smartFolders;
+    /**
+     * Manage workspace-scoped authentication tokens.
+     *
+     * Tokens are used for CLI mounting and per-workspace programmatic access.
+     */
+    tokens;
+    /**
+     * Manage workspace members.
+     *
+     * Members are users with roles (admin, member, viewer) in a workspace.
+     */
+    members;
+    /**
+     * OAuth session management for interactive connection setup.
+     *
+     * Use this for browser-redirect flows where users authorize
+     * integrations themselves.
+     */
+    oauth;
+    /**
+     * Read-only access to the workspace virtual filesystem.
+     *
+     * Browse directories, read files, and inspect metadata across
+     * all connected integrations.
+     */
+    fs;
+    /**
+     * Create a new Airstore SDK client.
+     *
+     * @param opts - Client configuration. At minimum, provide an `apiKey`
+     *   or set the `AIRSTORE_API_KEY` environment variable.
+     *
+     * @throws {AirstoreError} If no API key is provided.
+     */
+    constructor(opts) {
+        super(opts);
+        this.workspaces = new Workspaces(this);
+        this.connections = new Connections(this);
+        this.smartFolders = new SmartFolders(this);
+        this.tokens = new Tokens(this);
+        this.members = new Members(this);
+        this.oauth = new OAuth(this);
+        this.fs = new Filesystem(this);
+    }
+}
+export default Airstore;
+//# sourceMappingURL=airstore.js.map

package/dist/esm/airstore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"airstore.js","sourceRoot":"","sources":["../../src/airstore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,OAAO,QAAS,SAAQ,UAAU;IACtC;;;;;OAKG;IACM,UAAU,CAAa;IAEhC;;;;;OAKG;IACM,WAAW,CAAc;IAElC;;;;;OAKG;IACM,YAAY,CAAe;IAEpC;;;;OAIG;IACM,MAAM,CAAS;IAExB;;;;OAIG;IACM,OAAO,CAAU;IAE1B;;;;;OAKG;IACM,KAAK,CAAQ;IAEtB;;;;;OAKG;IACM,EAAE,CAAa;IAExB;;;;;;;OAOG;IACH,YAAY,IAAoB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,EAAE,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAED,eAAe,QAAQ,CAAC"}

package/dist/esm/client.js

@@ -0,0 +1,209 @@
+import { VERSION } from './version.js';
+import { APIError, APIConnectionError, APIConnectionTimeoutError, AirstoreError, } from './errors.js';
+export function attachResponseMeta(obj, meta) {
+    Object.defineProperty(obj, 'lastResponse', {
+        value: meta,
+        enumerable: false,
+        configurable: true,
+    });
+    return obj;
+}
+/** Retryable status codes. */
+const RETRYABLE_STATUS_CODES = new Set([408, 409, 429, 500, 502, 503, 504]);
+/** Base backoff in ms. */
+const BASE_BACKOFF_MS = 500;
+/** Max backoff in ms. */
+const MAX_BACKOFF_MS = 8000;
+/**
+ * Core HTTP client for the Airstore API.
+ *
+ * Handles authentication, automatic retries with exponential backoff,
+ * timeout, and per-request option overrides.
+ */
+export class CoreClient {
+    apiKey;
+    baseURL;
+    timeout;
+    maxRetries;
+    defaultHeaders;
+    constructor(opts = {}) {
+        this.apiKey =
+            opts.apiKey ??
+                (typeof process !== 'undefined' ? process.env?.['AIRSTORE_API_KEY'] ?? '' : '');
+        if (!this.apiKey) {
+            throw new AirstoreError('API key is required. Pass it via the `apiKey` option or set the AIRSTORE_API_KEY environment variable.');
+        }
+        const envBaseURL = typeof process !== 'undefined'
+            ? (process.env?.['AIRSTORE_BASE_URL'] ?? '')
+            : '';
+        this.baseURL = (opts.baseURL ?? (envBaseURL || 'https://api.airstore.ai/api/v1')).replace(/\/+$/, '');
+        this.timeout = opts.timeout ?? 60_000;
+        this.maxRetries = opts.maxRetries ?? 2;
+        this.defaultHeaders = opts.defaultHeaders ?? {};
+    }
+    /** Make an API request with retry and timeout. */
+    async request(method, path, body, params, reqOpts) {
+        const url = this._buildURL(path, params);
+        const timeout = reqOpts?.timeout ?? this.timeout;
+        const maxRetries = reqOpts?.maxRetries ?? this.maxRetries;
+        const headers = this._buildHeaders(reqOpts?.headers);
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            if (attempt > 0) {
+                await this._sleep(this._backoffMs(attempt, lastError));
+            }
+            const controller = new AbortController();
+            if (reqOpts?.signal) {
+                reqOpts.signal.addEventListener('abort', () => controller.abort(), { once: true });
+            }
+            const timeoutId = setTimeout(() => controller.abort(), timeout);
+            try {
+                const fetchOpts = {
+                    method,
+                    headers,
+                    signal: controller.signal,
+                };
+                if (body !== undefined && method !== 'GET' && method !== 'HEAD') {
+                    fetchOpts.body = JSON.stringify(body);
+                }
+                const response = await fetch(url, fetchOpts);
+                clearTimeout(timeoutId);
+                const meta = {
+                    statusCode: response.status,
+                    headers: response.headers,
+                    requestId: response.headers.get('x-request-id') ??
+                        response.headers.get('X-Request-Id') ??
+                        undefined,
+                };
+                if (response.ok) {
+                    const data = (await response.json());
+                    // Airstore API wraps responses in { success, data }
+                    const result = (data.data ?? data);
+                    return attachResponseMeta(result, meta);
+                }
+                // Non-retryable error
+                if (!RETRYABLE_STATUS_CODES.has(response.status) || attempt === maxRetries) {
+                    let errorMessage = `Request failed with status ${response.status}`;
+                    try {
+                        const errBody = await response.json();
+                        errorMessage = errBody?.error ?? errBody?.message ?? errorMessage;
+                    }
+                    catch {
+                        // ignore parse errors
+                    }
+                    throw APIError.generate(response.status, null, errorMessage, response.headers);
+                }
+                // Retryable — store error and continue
+                lastError = APIError.generate(response.status, null, `Retryable error (${response.status})`, response.headers);
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                if (err instanceof APIError) {
+                    if (!RETRYABLE_STATUS_CODES.has(err.status) || attempt === maxRetries) {
+                        throw err;
+                    }
+                    lastError = err;
+                    continue;
+                }
+                if (err instanceof DOMException && err.name === 'AbortError') {
+                    if (reqOpts?.signal?.aborted) {
+                        throw new AirstoreError('Request was cancelled');
+                    }
+                    throw new APIConnectionTimeoutError();
+                }
+                if (attempt === maxRetries) {
+                    throw new APIConnectionError(`Connection error: ${err instanceof Error ? err.message : String(err)}`, err);
+                }
+                lastError = err;
+            }
+        }
+        throw lastError ?? new AirstoreError('Request failed after retries');
+    }
+    /**
+     * Build full URL with query params.
+     *
+     * Uses string concatenation to preserve the base path prefix (e.g. `/api/v1`).
+     * `new URL(path, base)` would resolve absolute paths against the origin,
+     * dropping the base path — so we avoid it.
+     */
+    _buildURL(path, params) {
+        const suffix = path.startsWith('/') ? path : `/${path}`;
+        const url = new URL(`${this.baseURL}${suffix}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== '') {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        return url.toString();
+    }
+    /** Build request headers. */
+    _buildHeaders(extra) {
+        return {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.apiKey}`,
+            'User-Agent': `airstore-sdk-typescript/${VERSION}`,
+            ...this.defaultHeaders,
+            ...extra,
+        };
+    }
+    /** Calculate backoff with jitter. */
+    _backoffMs(attempt, lastError) {
+        // Respect Retry-After headers if present.
+        // retry-after-ms is already in milliseconds; retry-after is in seconds.
+        if (lastError instanceof APIError) {
+            const retryAfterMs = lastError.headers.get('retry-after-ms');
+            if (retryAfterMs) {
+                const ms = Number(retryAfterMs);
+                if (!isNaN(ms))
+                    return ms;
+            }
+            const retryAfter = lastError.headers.get('retry-after');
+            if (retryAfter) {
+                const seconds = Number(retryAfter);
+                if (!isNaN(seconds))
+                    return seconds * 1000;
+            }
+        }
+        const base = BASE_BACKOFF_MS * Math.pow(2, attempt - 1);
+        const jitter = Math.random() * base * 0.5;
+        return Math.min(base + jitter, MAX_BACKOFF_MS);
+    }
+    /** Sleep helper. */
+    _sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Make a raw HTTP request to any API path.
+     * Escape hatch for endpoints not yet covered by the SDK.
+     */
+    async rawRequest(method, path, opts) {
+        const url = this._buildURL(path, opts?.params);
+        const headers = this._buildHeaders(opts?.headers);
+        const controller = new AbortController();
+        if (opts?.signal) {
+            opts.signal.addEventListener('abort', () => controller.abort(), { once: true });
+        }
+        const timeoutMs = opts?.timeout ?? this.timeout;
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const fetchOpts = {
+                method,
+                headers,
+                signal: controller.signal,
+            };
+            if (opts?.body !== undefined) {
+                fetchOpts.body = JSON.stringify(opts.body);
+            }
+            const resp = await fetch(url, fetchOpts);
+            clearTimeout(timeoutId);
+            return resp;
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            throw new APIConnectionError(`Raw request failed: ${err instanceof Error ? err.message : String(err)}`, err);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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