@airstore/sdk 0.1.0

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

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

package/dist/esm/resources/workspaces.js

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

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

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

package/dist/esm/types/connections.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connections.js.map

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

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

package/dist/esm/types/filesystem.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filesystem.js.map

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

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

package/dist/esm/types/index.js

@@ -0,0 +1,9 @@
+export * from './shared.js';
+export * from './workspaces.js';
+export * from './connections.js';
+export * from './smart-folders.js';
+export * from './tokens.js';
+export * from './members.js';
+export * from './oauth.js';
+export * from './filesystem.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/esm/types/members.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=members.js.map

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

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

package/dist/esm/types/oauth.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=oauth.js.map

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

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

package/dist/esm/types/shared.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shared.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=smart-folders.js.map

package/dist/esm/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/esm/types/tokens.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tokens.js.map

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

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

package/dist/esm/types/workspaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspaces.js.map

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

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

package/dist/esm/version.js

@@ -0,0 +1,3 @@
+/** SDK version. Injected during build. */
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

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

package/dist/types/airstore.d.ts

@@ -0,0 +1,114 @@
+import { CoreClient, type ClientOptions } 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 declare class Airstore extends CoreClient {
+    /**
+     * Manage workspaces.
+     *
+     * Workspaces are the top-level container for connections, smart folders,
+     * members, and the virtual filesystem.
+     */
+    readonly workspaces: Workspaces;
+    /**
+     * Manage connections (integrations) within a workspace.
+     *
+     * Pass existing OAuth tokens or API keys to connect external services
+     * like Gmail, GitHub, Notion, etc.
+     */
+    readonly connections: 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.
+     */
+    readonly smartFolders: SmartFolders;
+    /**
+     * Manage workspace-scoped authentication tokens.
+     *
+     * Tokens are used for CLI mounting and per-workspace programmatic access.
+     */
+    readonly tokens: Tokens;
+    /**
+     * Manage workspace members.
+     *
+     * Members are users with roles (admin, member, viewer) in a workspace.
+     */
+    readonly members: Members;
+    /**
+     * OAuth session management for interactive connection setup.
+     *
+     * Use this for browser-redirect flows where users authorize
+     * integrations themselves.
+     */
+    readonly oauth: OAuth;
+    /**
+     * Read-only access to the workspace virtual filesystem.
+     *
+     * Browse directories, read files, and inspect metadata across
+     * all connected integrations.
+     */
+    readonly fs: Filesystem;
+    /**
+     * 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?: ClientOptions);
+}
+export default Airstore;
+//# sourceMappingURL=airstore.d.ts.map

package/dist/types/airstore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"airstore.d.ts","sourceRoot":"","sources":["../../src/airstore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,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,qBAAa,QAAS,SAAQ,UAAU;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAElC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAEtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IAExB;;;;;;;OAOG;gBACS,IAAI,CAAC,EAAE,aAAa;CAUjC;AAED,eAAe,QAAQ,CAAC"}

package/dist/types/client.d.ts

@@ -0,0 +1,86 @@
+/** Per-request overrides. Every resource method accepts this as the last argument. */
+export interface RequestOptions {
+    /** Override the client-level timeout (ms). */
+    timeout?: number;
+    /** Override the client-level maxRetries. */
+    maxRetries?: number;
+    /** Abort signal for cancellation. */
+    signal?: AbortSignal;
+    /** Extra headers merged with client-level headers. */
+    headers?: Record<string, string>;
+}
+/** Configuration for the Airstore client. */
+export interface ClientOptions {
+    /**
+     * API key for authentication. Defaults to `process.env.AIRSTORE_API_KEY`.
+     * Organization tokens start with `org_`, workspace tokens with `tok_`.
+     */
+    apiKey?: string;
+    /**
+     * Base URL for the Airstore REST API.
+     * @default "https://api.airstore.ai/api/v1" or AIRSTORE_BASE_URL env
+     */
+    baseURL?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 60000
+     */
+    timeout?: number;
+    /**
+     * Maximum number of retries for failed requests (429, 5xx).
+     * @default 2
+     */
+    maxRetries?: number;
+    /** Default headers added to every request. */
+    defaultHeaders?: Record<string, string>;
+}
+/** Metadata attached to every response object. */
+export interface ResponseMeta {
+    statusCode: number;
+    headers: Headers;
+    requestId: string | undefined;
+}
+export declare function attachResponseMeta<T extends object>(obj: T, meta: ResponseMeta): T & {
+    lastResponse: ResponseMeta;
+};
+/**
+ * Core HTTP client for the Airstore API.
+ *
+ * Handles authentication, automatic retries with exponential backoff,
+ * timeout, and per-request option overrides.
+ */
+export declare class CoreClient {
+    readonly apiKey: string;
+    readonly baseURL: string;
+    readonly timeout: number;
+    readonly maxRetries: number;
+    readonly defaultHeaders: Record<string, string>;
+    constructor(opts?: ClientOptions);
+    /** Make an API request with retry and timeout. */
+    request<T>(method: string, path: string, body?: unknown, params?: Record<string, string>, reqOpts?: RequestOptions): Promise<T & {
+        lastResponse: ResponseMeta;
+    }>;
+    /**
+     * 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.
+     */
+    private _buildURL;
+    /** Build request headers. */
+    private _buildHeaders;
+    /** Calculate backoff with jitter. */
+    private _backoffMs;
+    /** Sleep helper. */
+    private _sleep;
+    /**
+     * Make a raw HTTP request to any API path.
+     * Escape hatch for endpoints not yet covered by the SDK.
+     */
+    rawRequest(method: string, path: string, opts?: {
+        body?: unknown;
+        params?: Record<string, string>;
+    } & RequestOptions): Promise<Response>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAQA,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,YAAY,GACjB,CAAC,GAAG;IAAE,YAAY,EAAE,YAAY,CAAA;CAAE,CAOpC;AAUD;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAEpC,IAAI,GAAE,aAAkB;IAwBpC,kDAAkD;IAC5C,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,GAAG;QAAE,YAAY,EAAE,YAAY,CAAA;KAAE,CAAC;IAqG9C;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAajB,6BAA6B;IAC7B,OAAO,CAAC,aAAa;IAUrB,qCAAqC;IACrC,OAAO,CAAC,UAAU;IAsBlB,oBAAoB;IACpB,OAAO,CAAC,MAAM;IAId;;;OAGG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,cAAc,GAC1E,OAAO,CAAC,QAAQ,CAAC;CA8BrB"}

package/dist/types/errors.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Base error for all Airstore SDK errors.
+ */
+export declare class AirstoreError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+/**
+ * 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 declare class APIError extends AirstoreError {
+    readonly status: number;
+    readonly headers: Headers;
+    readonly requestId: string | undefined;
+    constructor(status: number, message: string, headers: Headers, requestId: string | undefined);
+    /**
+     * Generate the appropriate APIError subclass for a given HTTP status.
+     */
+    static generate(status: number, errorBody: unknown, message: string, headers: Headers): APIError;
+}
+/** 401 - Invalid or missing API key. */
+export declare class AuthenticationError extends APIError {
+    constructor(message: string, headers: Headers, requestId: string | undefined);
+}
+/** 403 - Token lacks permission for this operation. */
+export declare class PermissionDeniedError extends APIError {
+    constructor(message: string, headers: Headers, requestId: string | undefined);
+}
+/** 404 - Resource not found. */
+export declare class NotFoundError extends APIError {
+    constructor(message: string, headers: Headers, requestId: string | undefined);
+}
+/** 409 - Conflicting operation. */
+export declare class ConflictError extends APIError {
+    constructor(message: string, headers: Headers, requestId: string | undefined);
+}
+/** 422 - Validation failed. */
+export declare class UnprocessableEntityError extends APIError {
+    constructor(message: string, headers: Headers, requestId: string | undefined);
+}
+/** 429 - Rate limit exceeded. Retry after the period indicated by Retry-After header. */
+export declare class RateLimitError extends APIError {
+    constructor(message: string, headers: Headers, requestId: string | undefined);
+}
+/** 5xx - Server-side error. Safe to retry with backoff. */
+export declare class InternalServerError extends APIError {
+    constructor(status: number, message: string, headers: Headers, requestId: string | undefined);
+}
+/** Network-level connection failure (DNS, TCP, TLS). */
+export declare class APIConnectionError extends AirstoreError {
+    constructor(message: string, cause?: unknown);
+}
+/** Request timed out. */
+export declare class APIConnectionTimeoutError extends APIConnectionError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aACO,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,aAAa;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS;IAS/B;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,QAAQ;CAcZ;AAED,wCAAwC;AACxC,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;CAI7E;AAED,uDAAuD;AACvD,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;CAI7E;AAED,gCAAgC;AAChC,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;CAI7E;AAED,mCAAmC;AACnC,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;CAI7E;AAED,+BAA+B;AAC/B,qBAAa,wBAAyB,SAAQ,QAAQ;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;CAI7E;AAED,yFAAyF;AACzF,qBAAa,cAAe,SAAQ,QAAQ;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;CAI7E;AAED,2DAA2D;AAC3D,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;CAI7F;AAED,wDAAwD;AACxD,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAI7C;AAED,yBAAyB;AACzB,qBAAa,yBAA0B,SAAQ,kBAAkB;gBACnD,OAAO,GAAE,MAA4B;CAIlD"}

package/dist/types/index.d.ts

@@ -0,0 +1,21 @@
+/** @module @airstore/sdk */
+export { Airstore, Airstore as default } from './airstore.js';
+export type { ClientOptions, RequestOptions, ResponseMeta } from './client.js';
+export { AirstoreError, APIError, AuthenticationError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, APIConnectionError, APIConnectionTimeoutError, } from './errors.js';
+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';
+export type { PaginatedList, IntegrationType, MemberRole, OutputFormat } from './types/shared.js';
+export type { Workspace, WorkspaceCreateParams } from './types/workspaces.js';
+export type { Connection, ConnectionCreateParams } from './types/connections.js';
+export type { SmartFolder, SmartFolderCreateParams, SmartFolderUpdateParams } from './types/smart-folders.js';
+export type { Token, TokenCreateParams, TokenCreated } from './types/tokens.js';
+export type { Member, MemberCreateParams } from './types/members.js';
+export type { OAuthSession, OAuthSessionCreateParams, OAuthSessionStatus, OAuthPollOptions } from './types/oauth.js';
+export type { VirtualFile, DirectoryListing, TreeListing } from './types/filesystem.js';
+export { VERSION } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAG5B,OAAO,EAAE,QAAQ,EAAE,QAAQ,IAAI,OAAO,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG/E,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;AAGrB,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;AAGvD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClG,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACjF,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC9G,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrH,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGxF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/resources/connections.d.ts

@@ -0,0 +1,50 @@
+import type { CoreClient, RequestOptions } from '../client.js';
+import type { Connection, ConnectionCreateParams } from '../types/connections.js';
+/**
+ * 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 declare class Connections {
+    private readonly client;
+    constructor(client: CoreClient);
+    /**
+     * 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.
+     */
+    create(workspaceId: string, params: ConnectionCreateParams, options?: RequestOptions): Promise<Connection>;
+    /**
+     * List all connections in a workspace.
+     *
+     * @param workspaceId - Workspace external ID.
+     * @param options - Per-request overrides.
+     * @returns Array of connections.
+     */
+    list(workspaceId: string, options?: RequestOptions): Promise<Connection[]>;
+    /**
+     * 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.
+     */
+    del(workspaceId: string, connectionId: string, options?: RequestOptions): Promise<void>;
+}
+//# sourceMappingURL=connections.d.ts.map

package/dist/types/resources/connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections.d.ts","sourceRoot":"","sources":["../../../src/resources/connections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAElF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;OAOG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC;IAmBtB;;;;;;OAMG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAWhF;;;;;;;;OAQG;IACG,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CASjB"}

package/dist/types/resources/filesystem.d.ts

@@ -0,0 +1,81 @@
+import type { CoreClient, RequestOptions } from '../client.js';
+import type { VirtualFile, TreeListing } from '../types/filesystem.js';
+/**
+ * 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 declare class Filesystem {
+    private readonly client;
+    constructor(client: CoreClient);
+    /**
+     * 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.
+     */
+    list(workspaceId: string, opts?: {
+        path?: string;
+    }, options?: RequestOptions): Promise<VirtualFile[]>;
+    /**
+     * 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.
+     */
+    read(workspaceId: string, opts: {
+        path: string;
+        offset?: number;
+        length?: number;
+    }, options?: RequestOptions): Promise<string>;
+    /**
+     * 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.
+     */
+    tree(workspaceId: string, opts?: {
+        path?: string;
+        maxKeys?: number;
+        continuationToken?: string;
+    }, options?: RequestOptions): Promise<TreeListing>;
+    /**
+     * 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.
+     */
+    stat(workspaceId: string, path: string, options?: RequestOptions): Promise<VirtualFile>;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/types/resources/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/resources/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAoB,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEzF;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;;;;;;;OAQG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,EAC5B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC;IAczB;;;;;;;;;;;;OAYG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EACxD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;IAalB;;;;;;;;;;;;;OAaG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO,EAC1E,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;IAiBvB;;;;;;;;;OASG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC;CASxB"}

package/dist/types/resources/index.d.ts

@@ -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.d.ts.map

package/dist/types/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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"}