@airstore/sdk 0.1.0

package/dist/esm/errors.js

@@ -0,0 +1,115 @@
+/**
+ * Base error for all Airstore SDK errors.
+ */
+export class AirstoreError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'AirstoreError';
+    }
+}
+/**
+ * Error returned by the Airstore API.
+ *
+ * Contains the HTTP status code, response headers, and optional request ID
+ * for debugging. Use the semantic subclasses (AuthenticationError, NotFoundError, etc.)
+ * for targeted catch blocks.
+ */
+export class APIError extends AirstoreError {
+    status;
+    headers;
+    requestId;
+    constructor(status, message, headers, requestId) {
+        super(message);
+        this.name = 'APIError';
+        this.status = status;
+        this.headers = headers;
+        this.requestId = requestId;
+    }
+    /**
+     * Generate the appropriate APIError subclass for a given HTTP status.
+     */
+    static generate(status, errorBody, message, headers) {
+        const requestId = headers.get('x-request-id') ?? headers.get('X-Request-Id') ?? undefined;
+        if (status === 401)
+            return new AuthenticationError(message, headers, requestId);
+        if (status === 403)
+            return new PermissionDeniedError(message, headers, requestId);
+        if (status === 404)
+            return new NotFoundError(message, headers, requestId);
+        if (status === 409)
+            return new ConflictError(message, headers, requestId);
+        if (status === 422)
+            return new UnprocessableEntityError(message, headers, requestId);
+        if (status === 429)
+            return new RateLimitError(message, headers, requestId);
+        if (status >= 500)
+            return new InternalServerError(status, message, headers, requestId);
+        return new APIError(status, message, headers, requestId);
+    }
+}
+/** 401 - Invalid or missing API key. */
+export class AuthenticationError extends APIError {
+    constructor(message, headers, requestId) {
+        super(401, message, headers, requestId);
+        this.name = 'AuthenticationError';
+    }
+}
+/** 403 - Token lacks permission for this operation. */
+export class PermissionDeniedError extends APIError {
+    constructor(message, headers, requestId) {
+        super(403, message, headers, requestId);
+        this.name = 'PermissionDeniedError';
+    }
+}
+/** 404 - Resource not found. */
+export class NotFoundError extends APIError {
+    constructor(message, headers, requestId) {
+        super(404, message, headers, requestId);
+        this.name = 'NotFoundError';
+    }
+}
+/** 409 - Conflicting operation. */
+export class ConflictError extends APIError {
+    constructor(message, headers, requestId) {
+        super(409, message, headers, requestId);
+        this.name = 'ConflictError';
+    }
+}
+/** 422 - Validation failed. */
+export class UnprocessableEntityError extends APIError {
+    constructor(message, headers, requestId) {
+        super(422, message, headers, requestId);
+        this.name = 'UnprocessableEntityError';
+    }
+}
+/** 429 - Rate limit exceeded. Retry after the period indicated by Retry-After header. */
+export class RateLimitError extends APIError {
+    constructor(message, headers, requestId) {
+        super(429, message, headers, requestId);
+        this.name = 'RateLimitError';
+    }
+}
+/** 5xx - Server-side error. Safe to retry with backoff. */
+export class InternalServerError extends APIError {
+    constructor(status, message, headers, requestId) {
+        super(status, message, headers, requestId);
+        this.name = 'InternalServerError';
+    }
+}
+/** Network-level connection failure (DNS, TCP, TLS). */
+export class APIConnectionError extends AirstoreError {
+    constructor(message, cause) {
+        super(message, cause);
+        this.name = 'APIConnectionError';
+    }
+}
+/** Request timed out. */
+export class APIConnectionTimeoutError extends APIConnectionError {
+    constructor(message = 'Request timed out') {
+        super(message);
+        this.name = 'APIConnectionTimeoutError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,16 @@
+/** @module @airstore/sdk */
+// ── Main client ──────────────────────────────────────────────────────────────
+export { Airstore, Airstore as default } from './airstore.js';
+// ── Errors ───────────────────────────────────────────────────────────────────
+export { AirstoreError, APIError, AuthenticationError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, APIConnectionError, APIConnectionTimeoutError, } from './errors.js';
+// ── Resource classes ─────────────────────────────────────────────────────────
+export { Workspaces } from './resources/workspaces.js';
+export { Connections } from './resources/connections.js';
+export { SmartFolders } from './resources/smart-folders.js';
+export { Tokens } from './resources/tokens.js';
+export { Members } from './resources/members.js';
+export { OAuth } from './resources/oauth.js';
+export { Filesystem } from './resources/filesystem.js';
+// ── Version ──────────────────────────────────────────────────────────────────
+export { VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,gFAAgF;AAChF,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC;AAG9D,gFAAgF;AAChF,OAAO,EACL,aAAa,EACb,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,gFAAgF;AAChF,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;AAYvD,gFAAgF;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/resources/connections.js

@@ -0,0 +1,70 @@
+/**
+ * Manage connections (integrations) within a workspace.
+ *
+ * Connections store OAuth tokens or API keys for external services like
+ * Gmail, GitHub, Notion, etc. Pass existing tokens directly to avoid
+ * requiring users to re-authenticate.
+ *
+ * @example
+ * ```ts
+ * await airstore.connections.create("ws_abc", {
+ *   integrationType: "gmail",
+ *   accessToken: existingAccessToken,
+ *   refreshToken: existingRefreshToken,
+ * });
+ * ```
+ */
+export class Connections {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a connection by passing existing OAuth credentials or API keys.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param params - Connection creation parameters.
+     * @param options - Per-request overrides.
+     * @returns The created connection.
+     */
+    async create(workspaceId, params, options) {
+        const body = {
+            integration_type: params.integrationType,
+        };
+        if (params.accessToken !== undefined)
+            body['access_token'] = params.accessToken;
+        if (params.refreshToken !== undefined)
+            body['refresh_token'] = params.refreshToken;
+        if (params.apiKey !== undefined)
+            body['api_key'] = params.apiKey;
+        if (params.scope !== undefined)
+            body['scope'] = params.scope;
+        if (params.extra !== undefined)
+            body['extra'] = params.extra;
+        return this.client.request('POST', `/workspaces/${workspaceId}/connections`, body, undefined, options);
+    }
+    /**
+     * List all connections in a workspace.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param options - Per-request overrides.
+     * @returns Array of connections.
+     */
+    async list(workspaceId, options) {
+        const result = await this.client.request('GET', `/workspaces/${workspaceId}/connections`, undefined, undefined, options);
+        return Array.isArray(result) ? result : [];
+    }
+    /**
+     * Delete a connection.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param connectionId - Connection external ID.
+     * @param options - Per-request overrides.
+     *
+     * @throws {NotFoundError} If the connection doesn't exist.
+     */
+    async del(workspaceId, connectionId, options) {
+        await this.client.request('DELETE', `/workspaces/${workspaceId}/connections/${connectionId}`, undefined, undefined, options);
+    }
+}
+//# sourceMappingURL=connections.js.map

package/dist/esm/resources/connections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.js","sourceRoot":"","sources":["../../../src/resources/connections.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,MAA8B,EAC9B,OAAwB;QAExB,MAAM,IAAI,GAA4B;YACpC,gBAAgB,EAAE,MAAM,CAAC,eAAe;SACzC,CAAC;QACF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;QAChF,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;QACnF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACjE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAC7D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAE7D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,eAAe,WAAW,cAAc,EACxC,IAAI,EACJ,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB,EAAE,OAAwB;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACtC,KAAK,EACL,eAAe,WAAW,cAAc,EACxC,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;QACF,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CACP,WAAmB,EACnB,YAAoB,EACpB,OAAwB;QAExB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,QAAQ,EACR,eAAe,WAAW,gBAAgB,YAAY,EAAE,EACxD,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/resources/filesystem.js

@@ -0,0 +1,97 @@
+/**
+ * Read-only access to the workspace virtual filesystem.
+ *
+ * The filesystem provides a unified view of all connected integrations,
+ * smart folders, tools, and user-uploaded files.
+ *
+ * @example
+ * ```ts
+ * const listing = await airstore.fs.list("ws_abc", { path: "/" });
+ * const content = await airstore.fs.read("ws_abc", {
+ *   path: "/Sources/gmail/inbox/email.txt",
+ * });
+ * ```
+ */
+export class Filesystem {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List directory contents.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param opts - Listing options.
+     * @param opts.path - Directory path to list. Defaults to root.
+     * @param options - Per-request overrides.
+     * @returns Array of files and directories.
+     */
+    async list(workspaceId, opts = {}, options) {
+        const params = {};
+        if (opts.path !== undefined)
+            params['path'] = opts.path;
+        const result = await this.client.request('GET', `/workspaces/${workspaceId}/fs/list`, undefined, params, options);
+        return result.entries ?? [];
+    }
+    /**
+     * Read file contents as a string.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param opts - Read options.
+     * @param opts.path - File path to read.
+     * @param opts.offset - Byte offset to start reading from.
+     * @param opts.length - Number of bytes to read.
+     * @param options - Per-request overrides.
+     * @returns File contents as a string.
+     *
+     * @throws {NotFoundError} If the file doesn't exist.
+     */
+    async read(workspaceId, opts, options) {
+        const params = { path: opts.path };
+        if (opts.offset !== undefined)
+            params['offset'] = String(opts.offset);
+        if (opts.length !== undefined)
+            params['length'] = String(opts.length);
+        const resp = await this.client.rawRequest('GET', `/workspaces/${workspaceId}/fs/read`, { params, ...options });
+        return resp.text();
+    }
+    /**
+     * Get a directory tree for efficient prefetching.
+     *
+     * Returns a flat list of all entries under the given path. Supports
+     * pagination via `continuationToken` for large directories.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param opts - Tree options.
+     * @param opts.path - Root path for the tree. Defaults to root.
+     * @param opts.maxKeys - Maximum number of entries to return.
+     * @param opts.continuationToken - Token from a previous truncated response.
+     * @param options - Per-request overrides.
+     * @returns Tree listing with entries and pagination info.
+     */
+    async tree(workspaceId, opts = {}, options) {
+        const params = {};
+        if (opts.path !== undefined)
+            params['path'] = opts.path;
+        if (opts.maxKeys !== undefined)
+            params['max_keys'] = String(opts.maxKeys);
+        if (opts.continuationToken !== undefined) {
+            params['continuation_token'] = opts.continuationToken;
+        }
+        return this.client.request('GET', `/workspaces/${workspaceId}/fs/tree`, undefined, params, options);
+    }
+    /**
+     * Get file or directory metadata.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param path - Absolute path to stat.
+     * @param options - Per-request overrides.
+     * @returns File metadata.
+     *
+     * @throws {NotFoundError} If the path doesn't exist.
+     */
+    async stat(workspaceId, path, options) {
+        return this.client.request('GET', `/workspaces/${workspaceId}/fs/stat`, undefined, { path }, options);
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/esm/resources/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../src/resources/filesystem.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAA0B,EAAE,EAC5B,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAExD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACtC,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,MAAM,EACN,OAAO,CACR,CAAC;QACF,OAAQ,MAA2B,CAAC,OAAO,IAAI,EAAE,CAAC;IACpD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,IAAwD,EACxD,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEtE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CACvC,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CACvB,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAAwE,EAAE,EAC1E,OAAwB;QAExB,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACxD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACxD,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,MAAM,EACN,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,IAAY,EACZ,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,EAAE,IAAI,EAAE,EACR,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/resources/index.js

@@ -0,0 +1,8 @@
+export { Workspaces } from './workspaces.js';
+export { Connections } from './connections.js';
+export { SmartFolders } from './smart-folders.js';
+export { Tokens } from './tokens.js';
+export { Members } from './members.js';
+export { OAuth } from './oauth.js';
+export { Filesystem } from './filesystem.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/esm/resources/members.js

@@ -0,0 +1,59 @@
+/**
+ * Manage workspace members.
+ *
+ * Members are users with roles (admin, member, viewer) in a workspace.
+ * Tokens are always associated with a member.
+ *
+ * @example
+ * ```ts
+ * const member = await airstore.members.create("ws_abc", {
+ *   email: "agent@internal",
+ *   name: "Agent",
+ *   role: "member",
+ * });
+ * ```
+ */
+export class Members {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Add a member to a workspace.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param params - Member creation parameters.
+     * @param options - Per-request overrides.
+     * @returns The created member.
+     */
+    async create(workspaceId, params, options) {
+        return this.client.request('POST', `/workspaces/${workspaceId}/members`, {
+            email: params.email,
+            name: params.name,
+            role: params.role ?? 'member',
+        }, undefined, options);
+    }
+    /**
+     * List members of a workspace.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param options - Per-request overrides.
+     * @returns Array of members.
+     */
+    async list(workspaceId, options) {
+        return this.client.request('GET', `/workspaces/${workspaceId}/members`, undefined, undefined, options);
+    }
+    /**
+     * Remove a member from a workspace.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param memberId - Member external ID.
+     * @param options - Per-request overrides.
+     *
+     * @throws {NotFoundError} If the member doesn't exist.
+     */
+    async del(workspaceId, memberId, options) {
+        await this.client.request('DELETE', `/workspaces/${workspaceId}/members/${memberId}`, undefined, undefined, options);
+    }
+}
+//# sourceMappingURL=members.js.map

package/dist/esm/resources/members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.js","sourceRoot":"","sources":["../../../src/resources/members.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,MAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,eAAe,WAAW,UAAU,EACpC;YACE,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,QAAQ;SAC9B,EACD,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,WAAmB,EAAE,OAAwB;QACtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,UAAU,EACpC,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CACP,WAAmB,EACnB,QAAgB,EAChB,OAAwB;QAExB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,QAAQ,EACR,eAAe,WAAW,YAAY,QAAQ,EAAE,EAChD,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/resources/oauth.js

@@ -0,0 +1,81 @@
+import { AirstoreError } from '../errors.js';
+/**
+ * Manage OAuth sessions for interactive connection setup.
+ *
+ * Use this when you want users to authorize via browser redirect
+ * rather than passing tokens directly.
+ *
+ * @example
+ * ```ts
+ * const session = await airstore.oauth.createSession({
+ *   integrationType: "gmail",
+ *   returnTo: "https://myapp.com/callback",
+ * });
+ * console.log(session.authorize_url); // redirect user here
+ * const completed = await airstore.oauth.poll(session.session_id);
+ * ```
+ */
+export class OAuth {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create an OAuth session to initiate the authorization flow.
+     *
+     * Returns a session with an `authorize_url` that the user should be
+     * redirected to. Once they complete authorization, poll the session
+     * for the resulting connection ID.
+     *
+     * @param params - Session creation parameters.
+     * @param options - Per-request overrides.
+     * @returns The session with authorize_url to redirect the user to.
+     */
+    async createSession(params, options) {
+        const body = {
+            integration_type: params.integrationType,
+        };
+        if (params.returnTo !== undefined)
+            body['return_to'] = params.returnTo;
+        return this.client.request('POST', '/oauth/sessions', body, undefined, options);
+    }
+    /**
+     * Get the current status of an OAuth session.
+     *
+     * @param sessionId - Session ID from createSession.
+     * @param options - Per-request overrides.
+     * @returns The session status.
+     */
+    async getSession(sessionId, options) {
+        return this.client.request('GET', `/oauth/sessions/${sessionId}`, undefined, undefined, options);
+    }
+    /**
+     * Poll an OAuth session until completion or timeout.
+     *
+     * Repeatedly checks session status at the specified interval until
+     * the session completes, errors, or the timeout is reached.
+     *
+     * @param sessionId - Session ID from createSession.
+     * @param pollOpts - Polling configuration (timeout, interval).
+     * @param options - Per-request overrides.
+     * @returns The completed session status with connection_id.
+     *
+     * @throws {AirstoreError} If the session errors or times out.
+     */
+    async poll(sessionId, pollOpts, options) {
+        const timeout = pollOpts?.timeout ?? 300_000;
+        const interval = pollOpts?.interval ?? 2_000;
+        const deadline = Date.now() + timeout;
+        while (Date.now() < deadline) {
+            const status = await this.getSession(sessionId, options);
+            if (status.status === 'complete')
+                return status;
+            if (status.status === 'error') {
+                throw new AirstoreError(`OAuth session failed: ${status.error ?? 'unknown error'}`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, interval));
+        }
+        throw new AirstoreError(`OAuth session timed out after ${timeout}ms`);
+    }
+}
+//# sourceMappingURL=oauth.js.map

package/dist/esm/resources/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../src/resources/oauth.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,KAAK;IACa;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;;;;OAUG;IACH,KAAK,CAAC,aAAa,CACjB,MAAgC,EAChC,OAAwB;QAExB,MAAM,IAAI,GAA4B;YACpC,gBAAgB,EAAE,MAAM,CAAC,eAAe;SACzC,CAAC;QACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEvE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CACd,SAAiB,EACjB,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,mBAAmB,SAAS,EAAE,EAC9B,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,IAAI,CACR,SAAiB,EACjB,QAA2B,EAC3B,OAAwB;QAExB,MAAM,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,OAAO,CAAC;QAC7C,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAAQ,IAAI,KAAK,CAAC;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAEtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAEzD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,MAAM,CAAC;YAChD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9B,MAAM,IAAI,aAAa,CACrB,yBAAyB,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAC3D,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,aAAa,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/esm/resources/smart-folders.js

@@ -0,0 +1,98 @@
+/**
+ * Manage smart folders (filesystem queries) within a workspace.
+ *
+ * Smart folders use LLM inference to automatically organize and filter
+ * data from connected integrations into virtual folders or files.
+ *
+ * @example
+ * ```ts
+ * await airstore.smartFolders.create("ws_abc", {
+ *   integration: "gmail",
+ *   name: "Recent Emails",
+ *   guidance: "Last 7 days of emails",
+ * });
+ * ```
+ */
+export class SmartFolders {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new smart folder.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param params - Smart folder creation parameters.
+     * @param options - Per-request overrides.
+     * @returns The created smart folder.
+     */
+    async create(workspaceId, params, options) {
+        const body = {
+            integration: params.integration,
+            name: params.name,
+            output_format: params.outputFormat ?? 'folder',
+        };
+        if (params.guidance !== undefined)
+            body['guidance'] = params.guidance;
+        if (params.fileExt !== undefined)
+            body['file_ext'] = params.fileExt;
+        return this.client.request('POST', `/workspaces/${workspaceId}/fs/queries`, body, undefined, options);
+    }
+    /**
+     * List all smart folders in a workspace.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param options - Per-request overrides.
+     * @returns Array of smart folders.
+     */
+    async list(workspaceId, options) {
+        // API may return { queries: [...] } or a direct array depending on version
+        const result = await this.client.request('GET', `/workspaces/${workspaceId}/fs/queries/list`, undefined, undefined, options);
+        if (Array.isArray(result))
+            return result;
+        return result.queries ?? [];
+    }
+    /**
+     * Retrieve a smart folder by its virtual filesystem path.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param queryPath - Virtual path of the smart folder.
+     * @param options - Per-request overrides.
+     * @returns The smart folder.
+     *
+     * @throws {NotFoundError} If the smart folder doesn't exist.
+     */
+    async retrieve(workspaceId, queryPath, options) {
+        return this.client.request('GET', `/workspaces/${workspaceId}/fs/queries`, undefined, { path: queryPath }, options);
+    }
+    /**
+     * Update an existing smart folder.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param queryId - Smart folder external ID.
+     * @param params - Fields to update.
+     * @param options - Per-request overrides.
+     * @returns The updated smart folder.
+     */
+    async update(workspaceId, queryId, params, options) {
+        const body = {};
+        if (params.name !== undefined)
+            body['name'] = params.name;
+        if (params.guidance !== undefined)
+            body['guidance'] = params.guidance;
+        return this.client.request('PUT', `/workspaces/${workspaceId}/fs/queries/${queryId}`, body, undefined, options);
+    }
+    /**
+     * Delete a smart folder.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param queryId - Smart folder external ID.
+     * @param options - Per-request overrides.
+     *
+     * @throws {NotFoundError} If the smart folder doesn't exist.
+     */
+    async del(workspaceId, queryId, options) {
+        await this.client.request('DELETE', `/workspaces/${workspaceId}/fs/queries/${queryId}`, undefined, undefined, options);
+    }
+}
+//# sourceMappingURL=smart-folders.js.map

package/dist/esm/resources/smart-folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-folders.js","sourceRoot":"","sources":["../../../src/resources/smart-folders.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,MAA+B,EAC/B,OAAwB;QAExB,MAAM,IAAI,GAA4B;YACpC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,aAAa,EAAE,MAAM,CAAC,YAAY,IAAI,QAAQ;SAC/C,CAAC;QACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QACtE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QAEpE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,eAAe,WAAW,aAAa,EACvC,IAAI,EACJ,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAAwB;QAExB,2EAA2E;QAC3E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACtC,KAAK,EACL,eAAe,WAAW,kBAAkB,EAC5C,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACzC,OAAQ,MAAqC,CAAC,OAAO,IAAI,EAAE,CAAC;IAC9D,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,QAAQ,CACZ,WAAmB,EACnB,SAAiB,EACjB,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,aAAa,EACvC,SAAS,EACT,EAAE,IAAI,EAAE,SAAS,EAAE,EACnB,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,OAAe,EACf,MAA+B,EAC/B,OAAwB;QAExB,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QAC1D,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEtE,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,eAAe,WAAW,eAAe,OAAO,EAAE,EAClD,IAAI,EACJ,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,GAAG,CACP,WAAmB,EACnB,OAAe,EACf,OAAwB;QAExB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CACvB,QAAQ,EACR,eAAe,WAAW,eAAe,OAAO,EAAE,EAClD,SAAS,EACT,SAAS,EACT,OAAO,CACR,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/resources/tokens.js

@@ -0,0 +1,69 @@
+/**
+ * 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>
+ * ```
+ */
+export 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);
+    }
+}
+//# sourceMappingURL=tokens.js.map