@tinycloud/sdk-services 3.8.0-beta.16 → 3.8.0-beta.18

package/dist/ISQLService-BOgWzHLT.d.cts

@@ -0,0 +1,242 @@
+import { f as Result, c as IService } from './types-CSd0RYir.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;
+    /** Redact query failure details before return and ordinary service-error events. */
+    redactErrors?: boolean;
+}
+/**
+ * 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;
+    /** Redact execute failure details before return and ordinary service-error events. */
+    redactErrors?: boolean;
+}
+/**
+ * Options for SQL batch operations.
+ */
+interface BatchOptions {
+    /**
+     * Custom abort signal for this operation.
+     */
+    signal?: AbortSignal;
+    /** Redact batch failure details before return and ordinary service-error events. */
+    redactErrors?: boolean;
+}
+/**
+ * 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;
+}
+
+export { type BatchOptions as B, type ExecuteOptions as E, type IDatabaseHandle as I, type QueryOptions as Q, SQLAction as S, type BatchResponse as a, type ExecuteResponse as b, type ISQLMigrations as c, type ISQLService as d, type QueryResponse as e, type SQLActionType as f, type SQLServiceConfig as g, type SqlMigration as h, type SqlMigrationApplyOptions as i, type SqlMigrationApplyResponse as j, type SqlStatement as k, type SqlValue as l };

package/dist/context.d.cts

@@ -1,4 +1,4 @@
-import { I as IServiceContext, a as InvokeFunction, b as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, R as RetryPolicy, T as TelemetryConfig, c as IService, E as EventHandler, d as FetchRequestInit, e as FetchResponse } from './types-DAOyIbXu.cjs';
+import { I as IServiceContext, a as InvokeFunction, b as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, R as RetryPolicy, T as TelemetryConfig, c as IService, E as EventHandler, d as FetchRequestInit, e as FetchResponse } from './types-CSd0RYir.cjs';
 
 /**
  * ServiceContext implementation for TinyCloud SDK Services

package/dist/context.d.ts

@@ -1,4 +1,4 @@
-import { I as IServiceContext, a as InvokeFunction, b as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, R as RetryPolicy, T as TelemetryConfig, c as IService, E as EventHandler, d as FetchRequestInit, e as FetchResponse } from './types-DAOyIbXu.js';
+import { I as IServiceContext, a as InvokeFunction, b as InvokeAnyFunction, F as FetchFunction, S as ServiceSession, R as RetryPolicy, T as TelemetryConfig, c as IService, E as EventHandler, d as FetchRequestInit, e as FetchResponse } from './types-CSd0RYir.js';
 
 /**
  * ServiceContext implementation for TinyCloud SDK Services

package/dist/encryption/index.d.cts

@@ -1,7 +1,7 @@
-import { B as BaseService } from '../BaseService-D-29xShG.cjs';
-import { c as IService, h as Result } from '../types-DAOyIbXu.cjs';
-import { N as NetworkDescriptor, n as EncryptionError, I as InlineEncryptedEnvelope, D as DecryptCapabilityProof, j as DecryptResponseBody, E as EncryptionCrypto, h as DecryptInvocationSigner, p as ReceiverKeySigner, R as ReceiverKeyPair, i as DecryptRequestBody, g as DecryptInvocationFact, B as BuildDecryptInvocationInput, a as BuiltDecryptInvocation } from '../types-CBKrdtP8.cjs';
-export { C as CanonicalJson, b as DECRYPT_ACTION, c as DECRYPT_FACT_TYPE, d as DECRYPT_RESULT_TYPE, e as DEFAULT_ENCRYPTION_ALG, f as DEFAULT_KEY_VERSION, k as ENCRYPTION_SERVICE, l as ENCRYPTION_SERVICE_SHORT, m as ENVELOPE_VERSION, o as EncryptionErrorInput, J as Json, q as base64Decode, r as base64Encode, s as canonicalHashHex, t as canonicalize, u as encryptionError, v as hexDecode, w as hexEncode, x as utf8Decode, y as utf8Encode } from '../types-CBKrdtP8.cjs';
+import { B as BaseService } from '../BaseService-O0iyuFLk.cjs';
+import { c as IService, f as Result } from '../types-CSd0RYir.cjs';
+import { N as NetworkDescriptor, n as EncryptionError, I as InlineEncryptedEnvelope, D as DecryptCapabilityProof, j as DecryptResponseBody, E as EncryptionCrypto, h as DecryptInvocationSigner, p as ReceiverKeySigner, R as ReceiverKeyPair, i as DecryptRequestBody, g as DecryptInvocationFact, B as BuildDecryptInvocationInput, a as BuiltDecryptInvocation } from '../types-D4XbIfFJ.cjs';
+export { C as CanonicalJson, b as DECRYPT_ACTION, c as DECRYPT_FACT_TYPE, d as DECRYPT_RESULT_TYPE, e as DEFAULT_ENCRYPTION_ALG, f as DEFAULT_KEY_VERSION, k as ENCRYPTION_SERVICE, l as ENCRYPTION_SERVICE_SHORT, m as ENVELOPE_VERSION, o as EncryptionErrorInput, J as Json, q as base64Decode, r as base64Encode, s as canonicalHashHex, t as canonicalize, u as encryptionError, v as hexDecode, w as hexEncode, x as utf8Decode, y as utf8Encode } from '../types-D4XbIfFJ.cjs';
 export { DecryptTransportResponseError } from '@tinycloud/sdk-services/internal/decrypt-transport-response-error';
 
 /**

package/dist/encryption/index.d.ts

@@ -1,7 +1,7 @@
-import { B as BaseService } from '../BaseService-DO7vZ67k.js';
-import { c as IService, h as Result } from '../types-DAOyIbXu.js';
-import { N as NetworkDescriptor, n as EncryptionError, I as InlineEncryptedEnvelope, D as DecryptCapabilityProof, j as DecryptResponseBody, E as EncryptionCrypto, h as DecryptInvocationSigner, p as ReceiverKeySigner, R as ReceiverKeyPair, i as DecryptRequestBody, g as DecryptInvocationFact, B as BuildDecryptInvocationInput, a as BuiltDecryptInvocation } from '../types-DZBExWAf.js';
-export { C as CanonicalJson, b as DECRYPT_ACTION, c as DECRYPT_FACT_TYPE, d as DECRYPT_RESULT_TYPE, e as DEFAULT_ENCRYPTION_ALG, f as DEFAULT_KEY_VERSION, k as ENCRYPTION_SERVICE, l as ENCRYPTION_SERVICE_SHORT, m as ENVELOPE_VERSION, o as EncryptionErrorInput, J as Json, q as base64Decode, r as base64Encode, s as canonicalHashHex, t as canonicalize, u as encryptionError, v as hexDecode, w as hexEncode, x as utf8Decode, y as utf8Encode } from '../types-DZBExWAf.js';
+import { B as BaseService } from '../BaseService-Ma2MwJAd.js';
+import { c as IService, f as Result } from '../types-CSd0RYir.js';
+import { N as NetworkDescriptor, n as EncryptionError, I as InlineEncryptedEnvelope, D as DecryptCapabilityProof, j as DecryptResponseBody, E as EncryptionCrypto, h as DecryptInvocationSigner, p as ReceiverKeySigner, R as ReceiverKeyPair, i as DecryptRequestBody, g as DecryptInvocationFact, B as BuildDecryptInvocationInput, a as BuiltDecryptInvocation } from '../types-Bf91gup6.js';
+export { C as CanonicalJson, b as DECRYPT_ACTION, c as DECRYPT_FACT_TYPE, d as DECRYPT_RESULT_TYPE, e as DEFAULT_ENCRYPTION_ALG, f as DEFAULT_KEY_VERSION, k as ENCRYPTION_SERVICE, l as ENCRYPTION_SERVICE_SHORT, m as ENVELOPE_VERSION, o as EncryptionErrorInput, J as Json, q as base64Decode, r as base64Encode, s as canonicalHashHex, t as canonicalize, u as encryptionError, v as hexDecode, w as hexEncode, x as utf8Decode, y as utf8Encode } from '../types-Bf91gup6.js';
 export { DecryptTransportResponseError } from '@tinycloud/sdk-services/internal/decrypt-transport-response-error';
 
 /**

package/dist/encryption/named-keys.d.cts

@@ -1,6 +1,6 @@
-import { E as EncryptionCrypto, I as InlineEncryptedEnvelope, J as Json } from '../types-CBKrdtP8.cjs';
+import { E as EncryptionCrypto, I as InlineEncryptedEnvelope, J as Json } from '../types-D4XbIfFJ.cjs';
 import { ParsedKeyResource } from './resource.cjs';
-import '../types-DAOyIbXu.cjs';
+import '../types-CSd0RYir.cjs';
 
 /**
  * Named-key client: key admin, descriptor reads, `ensureKey` and key-scoped

package/dist/encryption/named-keys.d.ts

@@ -1,6 +1,6 @@
-import { E as EncryptionCrypto, I as InlineEncryptedEnvelope, J as Json } from '../types-DZBExWAf.js';
+import { E as EncryptionCrypto, I as InlineEncryptedEnvelope, J as Json } from '../types-Bf91gup6.js';
 import { ParsedKeyResource } from './resource.js';
-import '../types-DAOyIbXu.js';
+import '../types-CSd0RYir.js';
 
 /**
  * Named-key client: key admin, descriptor reads, `ensureKey` and key-scoped