@tinycloud/sdk-services 1.5.0 → 1.7.0

package/dist/duckdb/DuckDbDatabaseHandle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DuckDbDatabaseHandle - Handle for operations on a specific named database.
+ *
+ * Delegates all operations to the parent DuckDbService with the database name.
+ */
+import type { Result } from "../types";
+import type { IDuckDbDatabaseHandle } from "./IDuckDbService";
+import type { DuckDbService } from "./DuckDbService";
+import type { DuckDbValue, DuckDbStatement, QueryResponse, ExecuteResponse, BatchResponse, SchemaInfo, DuckDbQueryOptions, DuckDbExecuteOptions, DuckDbBatchOptions, DuckDbOptions } from "./types";
+export declare class DuckDbDatabaseHandle implements IDuckDbDatabaseHandle {
+    private service;
+    readonly name: string;
+    constructor(service: DuckDbService, name: string);
+    query<T = Record<string, unknown>>(sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<QueryResponse<T>>>;
+    queryArrow(sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<ArrayBuffer>>;
+    execute(sql: string, params?: DuckDbValue[], options?: DuckDbExecuteOptions): Promise<Result<ExecuteResponse>>;
+    batch(statements: DuckDbStatement[], options?: DuckDbBatchOptions): Promise<Result<BatchResponse>>;
+    executeStatement(name: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<QueryResponse | ExecuteResponse>>;
+    describe(options?: DuckDbOptions): Promise<Result<SchemaInfo>>;
+    export(options?: DuckDbOptions): Promise<Result<Blob>>;
+    import(data: Uint8Array, options?: DuckDbOptions): Promise<Result<void>>;
+}
+//# sourceMappingURL=DuckDbDatabaseHandle.d.ts.map

package/dist/duckdb/DuckDbDatabaseHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuckDbDatabaseHandle.d.ts","sourceRoot":"","sources":["../../src/duckdb/DuckDbDatabaseHandle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,OAAO,CAAC,OAAO,CAAgB;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM;IAK1C,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAI9B,UAAU,CACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAIzB,OAAO,CACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,EAAE,EACtB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAI7B,KAAK,CACT,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAI3B,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,EAAE,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,aAAa,GAAG,eAAe,CAAC,CAAC;IAI7C,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAI9D,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAItD,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CAG/E"}

package/dist/duckdb/DuckDbDatabaseHandle.js

@@ -0,0 +1,36 @@
+/**
+ * DuckDbDatabaseHandle - Handle for operations on a specific named database.
+ *
+ * Delegates all operations to the parent DuckDbService with the database name.
+ */
+export class DuckDbDatabaseHandle {
+    constructor(service, name) {
+        this.service = service;
+        this.name = name;
+    }
+    async query(sql, params, options) {
+        return this.service.queryOnDb(this.name, sql, params, options);
+    }
+    async queryArrow(sql, params, options) {
+        return this.service.queryArrowOnDb(this.name, sql, params, options);
+    }
+    async execute(sql, params, options) {
+        return this.service.executeOnDb(this.name, sql, params, options);
+    }
+    async batch(statements, options) {
+        return this.service.batchOnDb(this.name, statements, options);
+    }
+    async executeStatement(name, params, options) {
+        return this.service.executeStatementOnDb(this.name, name, params, options);
+    }
+    async describe(options) {
+        return this.service.describeDb(this.name, options);
+    }
+    async export(options) {
+        return this.service.exportOnDb(this.name, options);
+    }
+    async import(data, options) {
+        return this.service.importOnDb(this.name, data, options);
+    }
+}
+//# sourceMappingURL=DuckDbDatabaseHandle.js.map

package/dist/duckdb/DuckDbDatabaseHandle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DuckDbDatabaseHandle.js","sourceRoot":"","sources":["../../src/duckdb/DuckDbDatabaseHandle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,MAAM,OAAO,oBAAoB;IAI/B,YAAY,OAAsB,EAAE,IAAY;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK,CACT,GAAW,EACX,MAAsB,EACtB,OAA4B;QAE5B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAI,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,UAAU,CACd,GAAW,EACX,MAAsB,EACtB,OAA4B;QAE5B,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,OAAO,CACX,GAAW,EACX,MAAsB,EACtB,OAA8B;QAE9B,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,KAAK,CACT,UAA6B,EAC7B,OAA4B;QAE5B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,IAAY,EACZ,MAAsB,EACtB,OAA4B;QAE5B,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAuB;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAuB;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAgB,EAAE,OAAuB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/duckdb/DuckDbService.d.ts

@@ -0,0 +1,50 @@
+/**
+ * DuckDbService - DuckDB database service implementation.
+ *
+ * Platform-agnostic DuckDB service that works with both web-sdk and node-sdk.
+ * Uses dependency injection via IServiceContext for platform dependencies.
+ */
+import { BaseService } from "../base/BaseService";
+import { Result } from "../types";
+import type { IDuckDbService, IDuckDbDatabaseHandle } from "./IDuckDbService";
+import { type DuckDbServiceConfig, type DuckDbQueryOptions, type DuckDbExecuteOptions, type DuckDbBatchOptions, type DuckDbOptions, type DuckDbValue, type DuckDbStatement, type QueryResponse, type ExecuteResponse, type BatchResponse, type SchemaInfo } from "./types";
+export declare class DuckDbService extends BaseService implements IDuckDbService {
+    static readonly serviceName = "duckdb";
+    protected _config: DuckDbServiceConfig;
+    constructor(config?: DuckDbServiceConfig);
+    get config(): DuckDbServiceConfig;
+    private get defaultDbName();
+    private get host();
+    /**
+     * Get a handle to a named database.
+     */
+    db(name?: string): IDuckDbDatabaseHandle;
+    /**
+     * Shortcut: query the default database (JSON format).
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<QueryResponse<T>>>;
+    /**
+     * Shortcut: query the default database (Arrow IPC format).
+     */
+    queryArrow(sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<ArrayBuffer>>;
+    /**
+     * Shortcut: execute on the default database.
+     */
+    execute(sql: string, params?: DuckDbValue[], options?: DuckDbExecuteOptions): Promise<Result<ExecuteResponse>>;
+    /**
+     * Shortcut: batch on the default database.
+     */
+    batch(statements: DuckDbStatement[], options?: DuckDbBatchOptions): Promise<Result<BatchResponse>>;
+    queryOnDb<T = Record<string, unknown>>(dbName: string, sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<QueryResponse<T>>>;
+    queryArrowOnDb(dbName: string, sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<ArrayBuffer>>;
+    executeOnDb(dbName: string, sql: string, params?: DuckDbValue[], options?: DuckDbExecuteOptions): Promise<Result<ExecuteResponse>>;
+    batchOnDb(dbName: string, statements: DuckDbStatement[], options?: DuckDbBatchOptions): Promise<Result<BatchResponse>>;
+    executeStatementOnDb(dbName: string, name: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<QueryResponse | ExecuteResponse>>;
+    describeDb(dbName: string, options?: DuckDbOptions): Promise<Result<SchemaInfo>>;
+    exportOnDb(dbName: string, options?: DuckDbOptions): Promise<Result<Blob>>;
+    importOnDb(dbName: string, data: Uint8Array, options?: DuckDbOptions): Promise<Result<void>>;
+    private invokeDuckDb;
+    private handleErrorResponse;
+    private mapHttpStatusToErrorCode;
+}
+//# sourceMappingURL=DuckDbService.d.ts.map

package/dist/duckdb/DuckDbService.d.ts.map

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

package/dist/duckdb/DuckDbService.js

@@ -0,0 +1,285 @@
+/**
+ * DuckDbService - DuckDB database service implementation.
+ *
+ * Platform-agnostic DuckDB service that works with both web-sdk and node-sdk.
+ * Uses dependency injection via IServiceContext for platform dependencies.
+ */
+import { BaseService } from "../base/BaseService";
+import { ok, err, ErrorCodes, serviceError, } from "../types";
+import { authRequiredError, wrapError, parseAuthError } from "../errors";
+import { DuckDbDatabaseHandle } from "./DuckDbDatabaseHandle";
+import { DuckDbAction, } from "./types";
+export class DuckDbService extends BaseService {
+    constructor(config = {}) {
+        super();
+        this._config = config;
+    }
+    get config() {
+        return this._config;
+    }
+    get defaultDbName() {
+        return this._config.defaultDatabase ?? "default";
+    }
+    get host() {
+        return this.context.hosts[0];
+    }
+    /**
+     * Get a handle to a named database.
+     */
+    db(name) {
+        return new DuckDbDatabaseHandle(this, name ?? this.defaultDbName);
+    }
+    /**
+     * Shortcut: query the default database (JSON format).
+     */
+    async query(sql, params, options) {
+        return this.queryOnDb(this.defaultDbName, sql, params, options);
+    }
+    /**
+     * Shortcut: query the default database (Arrow IPC format).
+     */
+    async queryArrow(sql, params, options) {
+        return this.queryArrowOnDb(this.defaultDbName, sql, params, options);
+    }
+    /**
+     * Shortcut: execute on the default database.
+     */
+    async execute(sql, params, options) {
+        return this.executeOnDb(this.defaultDbName, sql, params, options);
+    }
+    /**
+     * Shortcut: batch on the default database.
+     */
+    async batch(statements, options) {
+        return this.batchOnDb(this.defaultDbName, statements, options);
+    }
+    // === Internal methods called by DuckDbDatabaseHandle ===
+    async queryOnDb(dbName, sql, params, options) {
+        return this.withTelemetry("query", dbName, async () => {
+            if (!this.requireAuth()) {
+                return err(authRequiredError("duckdb"));
+            }
+            try {
+                const response = await this.invokeDuckDb(dbName, DuckDbAction.READ, { action: "query", sql, params: params ?? [] }, options?.signal);
+                if (!response.ok) {
+                    return this.handleErrorResponse(response, "query");
+                }
+                const data = (await response.json());
+                return ok(data);
+            }
+            catch (error) {
+                return err(wrapError("duckdb", error));
+            }
+        });
+    }
+    async queryArrowOnDb(dbName, sql, params, options) {
+        return this.withTelemetry("queryArrow", dbName, async () => {
+            if (!this.requireAuth()) {
+                return err(authRequiredError("duckdb"));
+            }
+            try {
+                const response = await this.invokeDuckDb(dbName, DuckDbAction.READ, { action: "query", sql, params: params ?? [] }, options?.signal, { Accept: "application/vnd.apache.arrow.stream" });
+                if (!response.ok) {
+                    return this.handleErrorResponse(response, "queryArrow");
+                }
+                const buffer = await response.arrayBuffer();
+                return ok(buffer);
+            }
+            catch (error) {
+                return err(wrapError("duckdb", error));
+            }
+        });
+    }
+    async executeOnDb(dbName, sql, params, options) {
+        return this.withTelemetry("execute", dbName, async () => {
+            if (!this.requireAuth()) {
+                return err(authRequiredError("duckdb"));
+            }
+            try {
+                const body = {
+                    action: "execute",
+                    sql,
+                    params: params ?? [],
+                };
+                if (options?.schema) {
+                    body.schema = options.schema;
+                }
+                const response = await this.invokeDuckDb(dbName, DuckDbAction.WRITE, body, options?.signal);
+                if (!response.ok) {
+                    return this.handleErrorResponse(response, "execute");
+                }
+                const data = (await response.json());
+                return ok(data);
+            }
+            catch (error) {
+                return err(wrapError("duckdb", error));
+            }
+        });
+    }
+    async batchOnDb(dbName, statements, options) {
+        return this.withTelemetry("batch", dbName, async () => {
+            if (!this.requireAuth()) {
+                return err(authRequiredError("duckdb"));
+            }
+            try {
+                const body = {
+                    action: "batch",
+                    statements,
+                };
+                if (options?.transactional !== undefined) {
+                    body.transactional = options.transactional;
+                }
+                const response = await this.invokeDuckDb(dbName, DuckDbAction.WRITE, body, options?.signal);
+                if (!response.ok) {
+                    return this.handleErrorResponse(response, "batch");
+                }
+                const data = (await response.json());
+                return ok(data);
+            }
+            catch (error) {
+                return err(wrapError("duckdb", error));
+            }
+        });
+    }
+    async executeStatementOnDb(dbName, name, params, options) {
+        return this.withTelemetry("executeStatement", dbName, async () => {
+            if (!this.requireAuth()) {
+                return err(authRequiredError("duckdb"));
+            }
+            try {
+                const response = await this.invokeDuckDb(dbName, DuckDbAction.EXECUTE, { action: "executeStatement", name, params: params ?? [] }, options?.signal);
+                if (!response.ok) {
+                    return this.handleErrorResponse(response, "executeStatement");
+                }
+                const data = (await response.json());
+                return ok(data);
+            }
+            catch (error) {
+                return err(wrapError("duckdb", error));
+            }
+        });
+    }
+    async describeDb(dbName, options) {
+        return this.withTelemetry("describe", dbName, async () => {
+            if (!this.requireAuth()) {
+                return err(authRequiredError("duckdb"));
+            }
+            try {
+                const response = await this.invokeDuckDb(dbName, DuckDbAction.DESCRIBE, { action: "describe" }, options?.signal);
+                if (!response.ok) {
+                    return this.handleErrorResponse(response, "describe");
+                }
+                const data = (await response.json());
+                return ok(data);
+            }
+            catch (error) {
+                return err(wrapError("duckdb", error));
+            }
+        });
+    }
+    async exportOnDb(dbName, options) {
+        return this.withTelemetry("export", dbName, async () => {
+            if (!this.requireAuth()) {
+                return err(authRequiredError("duckdb"));
+            }
+            try {
+                const response = await this.invokeDuckDb(dbName, DuckDbAction.EXPORT, { action: "export" }, options?.signal);
+                if (!response.ok) {
+                    return this.handleErrorResponse(response, "export");
+                }
+                const blob = await response.blob();
+                return ok(blob);
+            }
+            catch (error) {
+                return err(wrapError("duckdb", error));
+            }
+        });
+    }
+    async importOnDb(dbName, data, options) {
+        return this.withTelemetry("import", dbName, async () => {
+            if (!this.requireAuth()) {
+                return err(authRequiredError("duckdb"));
+            }
+            try {
+                const session = this.context.session;
+                const headers = this.context.invoke(session, "duckdb", dbName, DuckDbAction.IMPORT);
+                const response = await this.context.fetch(`${this.host}/invoke`, {
+                    method: "POST",
+                    headers: {
+                        ...headers,
+                        "Content-Type": "application/x-duckdb",
+                    },
+                    body: new Blob([data]),
+                    signal: this.combineSignals(options?.signal),
+                });
+                if (!response.ok) {
+                    return this.handleErrorResponse(response, "import");
+                }
+                return ok(undefined);
+            }
+            catch (error) {
+                return err(wrapError("duckdb", error));
+            }
+        });
+    }
+    // === Private helpers ===
+    async invokeDuckDb(dbName, action, body, signal, extraHeaders) {
+        const session = this.context.session;
+        const headers = this.context.invoke(session, "duckdb", dbName, action);
+        return this.context.fetch(`${this.host}/invoke`, {
+            method: "POST",
+            headers: {
+                ...headers,
+                "Content-Type": "application/json",
+                ...extraHeaders,
+            },
+            body: JSON.stringify(body),
+            signal: this.combineSignals(signal),
+        });
+    }
+    async handleErrorResponse(response, operation) {
+        const errorText = await response.text();
+        let errorBody = {};
+        try {
+            errorBody = JSON.parse(errorText);
+        }
+        catch {
+            // Not JSON
+        }
+        const errorCode = this.mapHttpStatusToErrorCode(response.status, errorBody.error);
+        const message = errorBody.message ||
+            `DuckDB ${operation} failed: ${response.status} - ${errorText}`;
+        const meta = { status: response.status, statusText: response.statusText };
+        if (response.status === 401) {
+            const { resource, action } = parseAuthError(errorText);
+            if (action)
+                meta.requiredAction = action;
+            if (resource)
+                meta.resource = resource;
+        }
+        return err(serviceError(errorCode, message, "duckdb", { meta }));
+    }
+    mapHttpStatusToErrorCode(status, serverError) {
+        switch (status) {
+            case 400:
+                return ErrorCodes.DUCKDB_ERROR;
+            case 401:
+                return ErrorCodes.AUTH_UNAUTHORIZED;
+            case 403:
+                if (serverError === "duckdb_readonly_violation") {
+                    return ErrorCodes.DUCKDB_READONLY_VIOLATION;
+                }
+                return ErrorCodes.DUCKDB_PERMISSION_DENIED;
+            case 404:
+                return ErrorCodes.DUCKDB_DATABASE_NOT_FOUND;
+            case 413:
+                return ErrorCodes.DUCKDB_RESPONSE_TOO_LARGE;
+            case 429:
+                return ErrorCodes.DUCKDB_QUOTA_EXCEEDED;
+            default:
+                return ErrorCodes.NETWORK_ERROR;
+        }
+    }
+}
+DuckDbService.serviceName = "duckdb";
+//# sourceMappingURL=DuckDbService.js.map

package/dist/duckdb/DuckDbService.js.map

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

package/dist/duckdb/IDuckDbService.d.ts

@@ -0,0 +1,84 @@
+/**
+ * IDuckDbService - Interface for DuckDB service.
+ *
+ * Platform-agnostic interface for DuckDB database operations.
+ */
+import type { IService, Result } from "../types";
+import type { DuckDbServiceConfig, DuckDbQueryOptions, DuckDbExecuteOptions, DuckDbBatchOptions, DuckDbOptions, DuckDbValue, DuckDbStatement, QueryResponse, ExecuteResponse, BatchResponse, SchemaInfo } from "./types";
+/**
+ * Database handle interface for operations on a specific named database.
+ */
+export interface IDuckDbDatabaseHandle {
+    /** The database name */
+    readonly name: string;
+    /**
+     * Execute a DuckDB query and return rows as JSON.
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<QueryResponse<T>>>;
+    /**
+     * Execute a DuckDB query and return results as Arrow IPC stream.
+     */
+    queryArrow(sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<ArrayBuffer>>;
+    /**
+     * Execute a DuckDB statement and return change count.
+     */
+    execute(sql: string, params?: DuckDbValue[], options?: DuckDbExecuteOptions): Promise<Result<ExecuteResponse>>;
+    /**
+     * Execute multiple statements in a batch.
+     */
+    batch(statements: DuckDbStatement[], options?: DuckDbBatchOptions): Promise<Result<BatchResponse>>;
+    /**
+     * Execute a named prepared statement from delegation caveats.
+     */
+    executeStatement(name: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<QueryResponse | ExecuteResponse>>;
+    /**
+     * Describe the database schema.
+     */
+    describe(options?: DuckDbOptions): Promise<Result<SchemaInfo>>;
+    /**
+     * Export the database as a Blob.
+     */
+    export(options?: DuckDbOptions): Promise<Result<Blob>>;
+    /**
+     * Import a binary DuckDB database file.
+     */
+    import(data: Uint8Array, options?: DuckDbOptions): Promise<Result<void>>;
+}
+/**
+ * DuckDB service interface.
+ *
+ * Provides DuckDB database operations with:
+ * - Result type pattern (no throwing)
+ * - Named database handles
+ * - Configurable timeouts
+ * - Abort signal support
+ * - Arrow format support via queryArrow()
+ */
+export interface IDuckDbService extends IService {
+    /**
+     * Get a handle to a named database.
+     * @param name - Database name (defaults to "default")
+     */
+    db(name?: string): IDuckDbDatabaseHandle;
+    /**
+     * Shortcut: query the default database (JSON format).
+     */
+    query<T = Record<string, unknown>>(sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<QueryResponse<T>>>;
+    /**
+     * Shortcut: query the default database (Arrow IPC format).
+     */
+    queryArrow(sql: string, params?: DuckDbValue[], options?: DuckDbQueryOptions): Promise<Result<ArrayBuffer>>;
+    /**
+     * Shortcut: execute on the default database.
+     */
+    execute(sql: string, params?: DuckDbValue[], options?: DuckDbExecuteOptions): Promise<Result<ExecuteResponse>>;
+    /**
+     * Shortcut: batch on the default database.
+     */
+    batch(statements: DuckDbStatement[], options?: DuckDbBatchOptions): Promise<Result<BatchResponse>>;
+    /**
+     * Service configuration.
+     */
+    readonly config: DuckDbServiceConfig;
+}
+//# sourceMappingURL=IDuckDbService.d.ts.map

package/dist/duckdb/IDuckDbService.d.ts.map

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

package/dist/duckdb/IDuckDbService.js

@@ -0,0 +1,7 @@
+/**
+ * IDuckDbService - Interface for DuckDB service.
+ *
+ * Platform-agnostic interface for DuckDB database operations.
+ */
+export {};
+//# sourceMappingURL=IDuckDbService.js.map

package/dist/duckdb/IDuckDbService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDuckDbService.js","sourceRoot":"","sources":["../../src/duckdb/IDuckDbService.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/duckdb/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * DuckDB Service Module
+ *
+ * Provides DuckDB database operations for TinyCloud.
+ */
+export { DuckDbService } from "./DuckDbService";
+export { DuckDbDatabaseHandle } from "./DuckDbDatabaseHandle";
+export type { IDuckDbService, IDuckDbDatabaseHandle } from "./IDuckDbService";
+export { DuckDbAction, type DuckDbActionType, type DuckDbServiceConfig, type DuckDbQueryOptions, type DuckDbExecuteOptions, type DuckDbBatchOptions, type DuckDbOptions, type DuckDbValue, type DuckDbStatement, type QueryResponse as DuckDbQueryResponse, type ExecuteResponse as DuckDbExecuteResponse, type BatchResponse as DuckDbBatchResponse, type SchemaInfo, type TableInfo, type ColumnInfo, type ViewInfo, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/duckdb/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,IAAI,mBAAmB,EACzC,KAAK,eAAe,IAAI,qBAAqB,EAC7C,KAAK,aAAa,IAAI,mBAAmB,EACzC,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,SAAS,CAAC"}

package/dist/duckdb/index.js

@@ -0,0 +1,9 @@
+/**
+ * DuckDB Service Module
+ *
+ * Provides DuckDB database operations for TinyCloud.
+ */
+export { DuckDbService } from "./DuckDbService";
+export { DuckDbDatabaseHandle } from "./DuckDbDatabaseHandle";
+export { DuckDbAction, } from "./types";
+//# sourceMappingURL=index.js.map

package/dist/duckdb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/duckdb/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EACL,YAAY,GAgBb,MAAM,SAAS,CAAC"}