@tinycloud/sdk-services 3.8.0-beta.2 → 3.8.0-beta.22

package/dist/sql/index.d.cts

@@ -1,238 +1,7 @@
-import { B as BaseService } from '../BaseService-D-29xShG.cjs';
-import { h as Result, c as IService } from '../types-DAOyIbXu.cjs';
-
-/**
- * SQL Service Types
- *
- * Type definitions for the SQL service operations.
- */
-/**
- * Configuration for SQLService.
- */
-interface SQLServiceConfig {
-    /**
-     * Default database name.
-     * If not set, operations default to "default".
-     */
-    defaultDatabase?: string;
-    /**
-     * Timeout in milliseconds for each SQL request, including reading the
-     * response body. When it elapses the request is aborted and the operation
-     * returns an `ErrorCodes.TIMEOUT` error. Unset (the default), `0`, or
-     * `Infinity` means no timeout.
-     */
-    timeout?: number;
-    /** Allow additional config properties */
-    [key: string]: unknown;
-}
-/**
- * Options for SQL query operations.
- */
-interface QueryOptions {
-    /**
-     * Custom abort signal for this operation.
-     */
-    signal?: AbortSignal;
-    /** Maximum rows the node may return. Nodes without limit support ignore it. */
-    maxRows?: number;
-    /** Maximum serialized result bytes the node may return. */
-    maxBytes?: number;
-}
-/**
- * Options for SQL execute operations.
- */
-interface ExecuteOptions {
-    /**
-     * Schema initialization statements (CREATE TABLE IF NOT EXISTS ...).
-     * Executed before the main statement on first write.
-     */
-    schema?: string[];
-    /**
-     * Custom abort signal for this operation.
-     */
-    signal?: AbortSignal;
-}
-/**
- * Options for SQL batch operations.
- */
-interface BatchOptions {
-    /**
-     * Custom abort signal for this operation.
-     */
-    signal?: AbortSignal;
-}
-/**
- * A SQL value: null, number, string, or binary data.
- */
-type SqlValue = null | number | string | Uint8Array;
-/**
- * A SQL statement with optional parameters.
- */
-interface SqlStatement {
-    sql: string;
-    params?: SqlValue[];
-}
-/**
- * Response from SQL query operations.
- */
-interface QueryResponse<T = Record<string, unknown>> {
-    columns: string[];
-    rows: T[][];
-    rowCount: number;
-}
-/**
- * Response from SQL execute operations.
- */
-interface ExecuteResponse {
-    changes: number;
-    lastInsertRowId: number | null;
-}
-/**
- * Response from SQL batch operations.
- */
-interface BatchResponse {
-    results: ExecuteResponse[];
-}
-/**
- * A versioned SQL migration owned by an application or SDK subsystem.
- */
-interface SqlMigration {
-    /**
-     * Stable migration id within the namespace, e.g. "001_initial".
-     */
-    id: string;
-    /**
-     * SQL statements to apply when this migration has not been recorded.
-     * Statements should be idempotent where SQLite supports it.
-     */
-    sql: Array<string | SqlStatement>;
-}
-/**
- * Options for applying SQL migrations.
- */
-interface SqlMigrationApplyOptions {
-    /**
-     * Namespace for this migration set, usually an app id or SDK subsystem.
-     */
-    namespace: string;
-    /**
-     * Ordered migration list.
-     */
-    migrations: SqlMigration[];
-    /**
-     * Custom abort signal for migration operations.
-     */
-    signal?: AbortSignal;
-}
-/**
- * Result from applying SQL migrations.
- */
-interface SqlMigrationApplyResponse {
-    database: string;
-    namespace: string;
-    status: "already_current" | "applied";
-    applied: string[];
-    skipped: string[];
-}
-/**
- * SQL service action types.
- *
- * URNs derive from the canonical capability registry in `@tinycloud/bootstrap`
- * (TC-112 single source of truth, vendored from tinycloud-node). `insert`,
- * `update`, and `delete` were dropped — zero client refs and never accepted
- * node-side. `select` is a deprecated alias of `read`. `execute`/`export` are
- * request-kind artifacts, not grantable capabilities: the node routes them by
- * request-body kind, so they are absent from the registry but kept here as the
- * invocation ability the client sends today (wire alignment tracked in TC-114).
- */
-declare const SQLAction: {
-    readonly READ: "tinycloud.sql/read";
-    readonly WRITE: "tinycloud.sql/write";
-    readonly SCHEMA: "tinycloud.sql/schema";
-    readonly ADMIN: "tinycloud.sql/admin";
-    readonly SELECT: "tinycloud.sql/select";
-    readonly EXECUTE: "tinycloud.sql/execute";
-    readonly EXPORT: "tinycloud.sql/export";
-    readonly ALL: "tinycloud.sql/*";
-};
-type SQLActionType = (typeof SQLAction)[keyof typeof SQLAction];
-
-/**
- * ISQLService - Interface for SQL service.
- *
- * Platform-agnostic interface for SQL database operations.
- */
-
-/**
- * Migration helper bound to a specific database.
- */
-interface ISQLMigrations {
-    /**
-     * Apply ordered, app-owned migrations and record completed ids.
-     */
-    apply(options: SqlMigrationApplyOptions): Promise<Result<SqlMigrationApplyResponse>>;
-}
-/**
- * Database handle interface for operations on a specific named database.
- */
-interface IDatabaseHandle {
-    /** The database name */
-    readonly name: string;
-    /** Versioned schema migration helper. */
-    readonly migrations: ISQLMigrations;
-    /**
-     * Execute a SQL query and return rows.
-     */
-    query<T = Record<string, unknown>>(sql: string, params?: SqlValue[], options?: QueryOptions): Promise<Result<QueryResponse<T>>>;
-    /**
-     * Execute a SQL statement and return change count.
-     */
-    execute(sql: string, params?: SqlValue[], options?: ExecuteOptions): Promise<Result<ExecuteResponse>>;
-    /**
-     * Execute multiple statements in a transaction.
-     */
-    batch(statements: SqlStatement[], options?: BatchOptions): Promise<Result<BatchResponse>>;
-    /**
-     * Execute a named prepared statement from delegation caveats.
-     */
-    executeStatement(name: string, params?: SqlValue[], options?: QueryOptions): Promise<Result<QueryResponse | ExecuteResponse>>;
-    /**
-     * Export the raw SQLite database file.
-     */
-    export(options?: QueryOptions): Promise<Result<Blob>>;
-}
-/**
- * SQL service interface.
- *
- * Provides SQL database operations with:
- * - Result type pattern (no throwing)
- * - Named database handles
- * - Configurable timeouts
- * - Abort signal support
- */
-interface ISQLService extends IService {
-    /**
-     * Get a handle to a named database.
-     * @param name - Database name (defaults to "default")
-     */
-    db(name?: string): IDatabaseHandle;
-    /**
-     * Shortcut: query the default database.
-     */
-    query<T = Record<string, unknown>>(sql: string, params?: SqlValue[], options?: QueryOptions): Promise<Result<QueryResponse<T>>>;
-    /**
-     * Shortcut: execute on the default database.
-     */
-    execute(sql: string, params?: SqlValue[], options?: ExecuteOptions): Promise<Result<ExecuteResponse>>;
-    /**
-     * Shortcut: batch on the default database.
-     */
-    batch(statements: SqlStatement[], options?: BatchOptions): Promise<Result<BatchResponse>>;
-    /**
-     * Service configuration.
-     */
-    readonly config: SQLServiceConfig;
-}
+import { B as BaseService } from '../BaseService-O0iyuFLk.cjs';
+import { f as Result } from '../types-CSd0RYir.cjs';
+import { d as ISQLService, g as SQLServiceConfig, I as IDatabaseHandle, l as SqlValue, Q as QueryOptions, e as QueryResponse, E as ExecuteOptions, b as ExecuteResponse, k as SqlStatement, B as BatchOptions, a as BatchResponse, i as SqlMigrationApplyOptions, j as SqlMigrationApplyResponse, c as ISQLMigrations } from '../ISQLService-BOgWzHLT.cjs';
+export { S as SQLAction, f as SQLActionType, h as SqlMigration } from '../ISQLService-BOgWzHLT.cjs';
 
 /**
  * SQLService - SQL database service implementation.
@@ -279,6 +48,7 @@ declare class SQLService extends BaseService implements ISQLService {
     private actionsForSqlBatch;
     private dedupeActions;
     private invokeSQLAny;
+    private redactFailure;
     private handleErrorResponse;
     private mapHttpStatusToErrorCode;
 }
@@ -308,4 +78,4 @@ declare class SQLMigrations implements ISQLMigrations {
     apply(options: SqlMigrationApplyOptions): Promise<Result<SqlMigrationApplyResponse>>;
 }
 
-export { type BatchOptions, type BatchResponse, DatabaseHandle, type ExecuteOptions, type ExecuteResponse, type IDatabaseHandle, type ISQLMigrations, type ISQLService, type QueryOptions, type QueryResponse, SQLAction, type SQLActionType, SQLMigrations, SQLService, type SQLServiceConfig, type SqlMigration, type SqlMigrationApplyOptions, type SqlMigrationApplyResponse, type SqlStatement, type SqlValue };
+export { BatchOptions, BatchResponse, DatabaseHandle, ExecuteOptions, ExecuteResponse, IDatabaseHandle, ISQLMigrations, ISQLService, QueryOptions, QueryResponse, SQLMigrations, SQLService, SQLServiceConfig, SqlMigrationApplyOptions, SqlMigrationApplyResponse, SqlStatement, SqlValue };

package/dist/sql/index.d.ts

@@ -1,238 +1,7 @@
-import { B as BaseService } from '../BaseService-DO7vZ67k.js';
-import { h as Result, c as IService } from '../types-DAOyIbXu.js';
-
-/**
- * SQL Service Types
- *
- * Type definitions for the SQL service operations.
- */
-/**
- * Configuration for SQLService.
- */
-interface SQLServiceConfig {
-    /**
-     * Default database name.
-     * If not set, operations default to "default".
-     */
-    defaultDatabase?: string;
-    /**
-     * Timeout in milliseconds for each SQL request, including reading the
-     * response body. When it elapses the request is aborted and the operation
-     * returns an `ErrorCodes.TIMEOUT` error. Unset (the default), `0`, or
-     * `Infinity` means no timeout.
-     */
-    timeout?: number;
-    /** Allow additional config properties */
-    [key: string]: unknown;
-}
-/**
- * Options for SQL query operations.
- */
-interface QueryOptions {
-    /**
-     * Custom abort signal for this operation.
-     */
-    signal?: AbortSignal;
-    /** Maximum rows the node may return. Nodes without limit support ignore it. */
-    maxRows?: number;
-    /** Maximum serialized result bytes the node may return. */
-    maxBytes?: number;
-}
-/**
- * Options for SQL execute operations.
- */
-interface ExecuteOptions {
-    /**
-     * Schema initialization statements (CREATE TABLE IF NOT EXISTS ...).
-     * Executed before the main statement on first write.
-     */
-    schema?: string[];
-    /**
-     * Custom abort signal for this operation.
-     */
-    signal?: AbortSignal;
-}
-/**
- * Options for SQL batch operations.
- */
-interface BatchOptions {
-    /**
-     * Custom abort signal for this operation.
-     */
-    signal?: AbortSignal;
-}
-/**
- * A SQL value: null, number, string, or binary data.
- */
-type SqlValue = null | number | string | Uint8Array;
-/**
- * A SQL statement with optional parameters.
- */
-interface SqlStatement {
-    sql: string;
-    params?: SqlValue[];
-}
-/**
- * Response from SQL query operations.
- */
-interface QueryResponse<T = Record<string, unknown>> {
-    columns: string[];
-    rows: T[][];
-    rowCount: number;
-}
-/**
- * Response from SQL execute operations.
- */
-interface ExecuteResponse {
-    changes: number;
-    lastInsertRowId: number | null;
-}
-/**
- * Response from SQL batch operations.
- */
-interface BatchResponse {
-    results: ExecuteResponse[];
-}
-/**
- * A versioned SQL migration owned by an application or SDK subsystem.
- */
-interface SqlMigration {
-    /**
-     * Stable migration id within the namespace, e.g. "001_initial".
-     */
-    id: string;
-    /**
-     * SQL statements to apply when this migration has not been recorded.
-     * Statements should be idempotent where SQLite supports it.
-     */
-    sql: Array<string | SqlStatement>;
-}
-/**
- * Options for applying SQL migrations.
- */
-interface SqlMigrationApplyOptions {
-    /**
-     * Namespace for this migration set, usually an app id or SDK subsystem.
-     */
-    namespace: string;
-    /**
-     * Ordered migration list.
-     */
-    migrations: SqlMigration[];
-    /**
-     * Custom abort signal for migration operations.
-     */
-    signal?: AbortSignal;
-}
-/**
- * Result from applying SQL migrations.
- */
-interface SqlMigrationApplyResponse {
-    database: string;
-    namespace: string;
-    status: "already_current" | "applied";
-    applied: string[];
-    skipped: string[];
-}
-/**
- * SQL service action types.
- *
- * URNs derive from the canonical capability registry in `@tinycloud/bootstrap`
- * (TC-112 single source of truth, vendored from tinycloud-node). `insert`,
- * `update`, and `delete` were dropped — zero client refs and never accepted
- * node-side. `select` is a deprecated alias of `read`. `execute`/`export` are
- * request-kind artifacts, not grantable capabilities: the node routes them by
- * request-body kind, so they are absent from the registry but kept here as the
- * invocation ability the client sends today (wire alignment tracked in TC-114).
- */
-declare const SQLAction: {
-    readonly READ: "tinycloud.sql/read";
-    readonly WRITE: "tinycloud.sql/write";
-    readonly SCHEMA: "tinycloud.sql/schema";
-    readonly ADMIN: "tinycloud.sql/admin";
-    readonly SELECT: "tinycloud.sql/select";
-    readonly EXECUTE: "tinycloud.sql/execute";
-    readonly EXPORT: "tinycloud.sql/export";
-    readonly ALL: "tinycloud.sql/*";
-};
-type SQLActionType = (typeof SQLAction)[keyof typeof SQLAction];
-
-/**
- * ISQLService - Interface for SQL service.
- *
- * Platform-agnostic interface for SQL database operations.
- */
-
-/**
- * Migration helper bound to a specific database.
- */
-interface ISQLMigrations {
-    /**
-     * Apply ordered, app-owned migrations and record completed ids.
-     */
-    apply(options: SqlMigrationApplyOptions): Promise<Result<SqlMigrationApplyResponse>>;
-}
-/**
- * Database handle interface for operations on a specific named database.
- */
-interface IDatabaseHandle {
-    /** The database name */
-    readonly name: string;
-    /** Versioned schema migration helper. */
-    readonly migrations: ISQLMigrations;
-    /**
-     * Execute a SQL query and return rows.
-     */
-    query<T = Record<string, unknown>>(sql: string, params?: SqlValue[], options?: QueryOptions): Promise<Result<QueryResponse<T>>>;
-    /**
-     * Execute a SQL statement and return change count.
-     */
-    execute(sql: string, params?: SqlValue[], options?: ExecuteOptions): Promise<Result<ExecuteResponse>>;
-    /**
-     * Execute multiple statements in a transaction.
-     */
-    batch(statements: SqlStatement[], options?: BatchOptions): Promise<Result<BatchResponse>>;
-    /**
-     * Execute a named prepared statement from delegation caveats.
-     */
-    executeStatement(name: string, params?: SqlValue[], options?: QueryOptions): Promise<Result<QueryResponse | ExecuteResponse>>;
-    /**
-     * Export the raw SQLite database file.
-     */
-    export(options?: QueryOptions): Promise<Result<Blob>>;
-}
-/**
- * SQL service interface.
- *
- * Provides SQL database operations with:
- * - Result type pattern (no throwing)
- * - Named database handles
- * - Configurable timeouts
- * - Abort signal support
- */
-interface ISQLService extends IService {
-    /**
-     * Get a handle to a named database.
-     * @param name - Database name (defaults to "default")
-     */
-    db(name?: string): IDatabaseHandle;
-    /**
-     * Shortcut: query the default database.
-     */
-    query<T = Record<string, unknown>>(sql: string, params?: SqlValue[], options?: QueryOptions): Promise<Result<QueryResponse<T>>>;
-    /**
-     * Shortcut: execute on the default database.
-     */
-    execute(sql: string, params?: SqlValue[], options?: ExecuteOptions): Promise<Result<ExecuteResponse>>;
-    /**
-     * Shortcut: batch on the default database.
-     */
-    batch(statements: SqlStatement[], options?: BatchOptions): Promise<Result<BatchResponse>>;
-    /**
-     * Service configuration.
-     */
-    readonly config: SQLServiceConfig;
-}
+import { B as BaseService } from '../BaseService-Ma2MwJAd.js';
+import { f as Result } from '../types-CSd0RYir.js';
+import { d as ISQLService, g as SQLServiceConfig, I as IDatabaseHandle, l as SqlValue, Q as QueryOptions, e as QueryResponse, E as ExecuteOptions, b as ExecuteResponse, k as SqlStatement, B as BatchOptions, a as BatchResponse, i as SqlMigrationApplyOptions, j as SqlMigrationApplyResponse, c as ISQLMigrations } from '../ISQLService-Aly1CBsW.js';
+export { S as SQLAction, f as SQLActionType, h as SqlMigration } from '../ISQLService-Aly1CBsW.js';
 
 /**
  * SQLService - SQL database service implementation.
@@ -279,6 +48,7 @@ declare class SQLService extends BaseService implements ISQLService {
     private actionsForSqlBatch;
     private dedupeActions;
     private invokeSQLAny;
+    private redactFailure;
     private handleErrorResponse;
     private mapHttpStatusToErrorCode;
 }
@@ -308,4 +78,4 @@ declare class SQLMigrations implements ISQLMigrations {
     apply(options: SqlMigrationApplyOptions): Promise<Result<SqlMigrationApplyResponse>>;
 }
 
-export { type BatchOptions, type BatchResponse, DatabaseHandle, type ExecuteOptions, type ExecuteResponse, type IDatabaseHandle, type ISQLMigrations, type ISQLService, type QueryOptions, type QueryResponse, SQLAction, type SQLActionType, SQLMigrations, SQLService, type SQLServiceConfig, type SqlMigration, type SqlMigrationApplyOptions, type SqlMigrationApplyResponse, type SqlStatement, type SqlValue };
+export { BatchOptions, BatchResponse, DatabaseHandle, ExecuteOptions, ExecuteResponse, IDatabaseHandle, ISQLMigrations, ISQLService, QueryOptions, QueryResponse, SQLMigrations, SQLService, SQLServiceConfig, SqlMigrationApplyOptions, SqlMigrationApplyResponse, SqlStatement, SqlValue };

package/dist/sql/index.js

@@ -741,12 +741,13 @@ var SQLService = class extends BaseService {
           request.signal
         );
         if (!response.ok) {
-          return await this.handleErrorResponse(response, "query", dbName, [action]);
+          const failure = await this.handleErrorResponse(response, "query", dbName, [action]);
+          return this.redactFailure(failure, options?.redactErrors, response.status);
         }
         const data = await response.json();
         return ok(data);
       } catch (error) {
-        return err(wrapError("sql", error));
+        return this.redactFailure(err(wrapError("sql", error)), options?.redactErrors);
       } finally {
         request.dispose();
       }
@@ -781,12 +782,13 @@ var SQLService = class extends BaseService {
           request.signal
         );
         if (!response.ok) {
-          return await this.handleErrorResponse(response, "execute", dbName, requestedActions);
+          const failure = await this.handleErrorResponse(response, "execute", dbName, requestedActions);
+          return this.redactFailure(failure, options?.redactErrors, response.status);
         }
         const data = await response.json();
         return ok(data);
       } catch (error) {
-        return err(wrapError("sql", error));
+        return this.redactFailure(err(wrapError("sql", error)), options?.redactErrors);
       } finally {
         request.dispose();
       }
@@ -807,12 +809,13 @@ var SQLService = class extends BaseService {
           request.signal
         );
         if (!response.ok) {
-          return await this.handleErrorResponse(response, "batch", dbName, requestedActions);
+          const failure = await this.handleErrorResponse(response, "batch", dbName, requestedActions);
+          return this.redactFailure(failure, options?.redactErrors, response.status);
         }
         const data = await response.json();
         return ok(data);
       } catch (error) {
-        return err(wrapError("sql", error));
+        return this.redactFailure(err(wrapError("sql", error)), options?.redactErrors);
       } finally {
         request.dispose();
       }
@@ -1008,6 +1011,18 @@ var SQLService = class extends BaseService {
       }))
     );
   }
+  redactFailure(result, redactErrors, status) {
+    if (!redactErrors || result.ok) return result;
+    const candidate = result.error.code;
+    const code = typeof candidate === "string" && Object.prototype.hasOwnProperty.call(ErrorCodes, candidate) ? candidate : ErrorCodes.SQL_ERROR;
+    const safeStatus = typeof status === "number" && Number.isInteger(status) && status >= 400 && status <= 599 ? status : void 0;
+    return err(serviceError(
+      code,
+      "SQL operation failed",
+      "sql",
+      safeStatus === void 0 ? void 0 : { meta: { status: safeStatus } }
+    ));
+  }
   async handleErrorResponse(response, operation, dbName, requestedActions) {
     const errorText = await response.text();
     const meta = responseErrorMeta(response.status, response.statusText, errorText);