@rindle/sql-client 0.6.4

package/dist/types.d.ts

@@ -0,0 +1,204 @@
+/** A value accepted by Rindle SQL's v1 client. Binary values are deliberately unsupported. */
+export type SqlValue = null | string | number | bigint | boolean;
+export type SqlArgs = readonly SqlValue[] | Readonly<Record<string, SqlValue>>;
+export interface Statement {
+    sql: string;
+    args?: SqlArgs;
+    wantRows?: boolean;
+}
+export interface Column {
+    name: string;
+    decltype: string | null;
+}
+export interface StatementResult {
+    columns: Column[];
+    rows: SqlValue[][];
+    rowsAffected: number;
+    lastInsertRowid: string | null;
+    rowsRead: number | null;
+    rowsWritten: number | null;
+}
+export interface RoutingMetadata {
+    servedBy: "master" | "follower";
+    appliedLagMs: number | null;
+    fenceFallback: boolean;
+}
+export interface ExecuteResult {
+    result: StatementResult;
+    commitCursor: string | null;
+    routing: RoutingMetadata;
+}
+export interface BatchResult {
+    results: StatementResult[];
+    commitCursor: string | null;
+    routing: RoutingMetadata;
+}
+export interface MigrationInput {
+    id: string;
+    checksum: string;
+    statements: string[];
+}
+export interface MigrationResult {
+    applied: boolean;
+    commitCursor: string;
+}
+export type ReadConsistency = "session" | "strong" | "eventual";
+export type IntMode = "bigint" | "number" | "string";
+export type RetryScope = "request" | "transaction" | "closure" | "never";
+export type TransactionState = "open" | "closed" | "unknown";
+export interface OperationOptions {
+    signal?: AbortSignal;
+}
+export interface ExecuteOptions extends OperationOptions {
+    consistency?: ReadConsistency;
+    sessionCursor?: string | null;
+}
+export type BatchOptions = ExecuteOptions;
+export interface TransactionOptions extends OperationOptions {
+    readOnly?: boolean;
+    isolation?: "serializable" | "snapshot";
+    consistency?: ReadConsistency;
+    sessionCursor?: string | null;
+}
+/** The optimistic mutation whose effects a mutation-aware SQL transaction commits. `mid` is the
+ *  requested mutation id; `lmid` is server-owned state and therefore only appears in receipts. */
+export interface MutationIdentity {
+    clientId: string;
+    mid: number;
+}
+/** The authoritative outcome of a mutation commit or lmid-only rejection. */
+export interface MutationReceipt {
+    applied: boolean;
+    lmid: number;
+    commitCursor: string | null;
+}
+/** Positional rows returned by a read inside an open mutation transaction. */
+export interface MutationRows {
+    columns: string[];
+    rows: SqlValue[][];
+}
+export interface ExecuteMutationInput extends MutationIdentity {
+    /** May be empty: an accepted no-op must still advance lmid and retire the prediction. */
+    statements: Statement[];
+}
+export interface BeginMutationInput extends MutationIdentity {
+    /** A pure-write prefix accumulated before the mutator's first read. */
+    statements?: Statement[];
+    /** Optional first read, coalesced with begin to preserve the mutation fast path. */
+    query?: Statement | string;
+}
+export interface RejectMutationInput extends MutationIdentity {
+    reason?: string;
+}
+export interface SqlMutationTransaction {
+    execute(statement: Statement | string, options?: OperationOptions): Promise<void>;
+    batch(statements: Statement[], options?: OperationOptions): Promise<void>;
+    query(statement: Statement | string, options?: OperationOptions): Promise<MutationRows>;
+    commit(options?: OperationOptions): Promise<MutationReceipt>;
+    rollback(options?: OperationOptions): Promise<void>;
+}
+/** Begin-time mid dedup can absorb a replay without opening a transaction; callers must skip the
+ *  mutator body in that branch. */
+export type BeginMutationResult = {
+    absorbed: true;
+    receipt: MutationReceipt;
+} | {
+    absorbed: false;
+    transaction: SqlMutationTransaction;
+    read?: MutationRows;
+};
+export interface RetryOptions extends TransactionOptions {
+    /** Total closure attempts, including the first. Defaults to 5. */
+    maxAttempts?: number;
+    /** Initial closure-retry delay. Defaults to 10ms. */
+    baseDelayMs?: number;
+    /** Maximum closure-retry delay. Defaults to 250ms. */
+    maxDelayMs?: number;
+}
+/** Portable subset of the WHATWG fetch signature used by the client. Keeping the input to the
+ *  URL forms we actually emit avoids leaking the DOM-only `RequestInfo` alias into Node/Worker
+ *  consumers that compile this package from source. */
+export type Fetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export interface ClientOptions {
+    url: string;
+    authToken: string;
+    consistency?: ReadConsistency;
+    sessionCursor?: string | null;
+    intMode?: IntMode;
+    /** Test/service-binding seam. The default is the runtime's global fetch. */
+    fetch?: Fetch;
+}
+export interface SqlTransaction {
+    execute(statement: Statement | string, options?: OperationOptions): Promise<StatementResult>;
+    batch(statements: Statement[], options?: OperationOptions): Promise<StatementResult[]>;
+    commit(options?: OperationOptions): Promise<{
+        commitCursor: string | null;
+    }>;
+    rollback(options?: OperationOptions): Promise<void>;
+}
+export interface SqlSession {
+    execute(statement: Statement | string, options?: ExecuteOptions): Promise<ExecuteResult>;
+    batch(statements: Statement[], options?: BatchOptions): Promise<BatchResult>;
+    begin(options?: TransactionOptions): Promise<SqlTransaction>;
+    withTransaction<T>(fn: (tx: SqlTransaction) => Promise<T>, options?: TransactionOptions): Promise<T>;
+    withTransactionRetry<T>(fn: (tx: SqlTransaction) => Promise<T>, options?: RetryOptions): Promise<T>;
+    /** One-round-trip optimistic mutation commit (effects + lmid in the same atomic unit). */
+    executeMutation(input: ExecuteMutationInput, options?: OperationOptions): Promise<MutationReceipt>;
+    /** Open an interactive optimistic mutation transaction, or absorb a replay before it runs. */
+    beginMutation(input: BeginMutationInput, options?: OperationOptions): Promise<BeginMutationResult>;
+    /** Process a business/pre-flight rejection as an lmid-only commit. */
+    rejectMutation(input: RejectMutationInput, options?: OperationOptions): Promise<MutationReceipt>;
+    executeDdl(sql: string, options?: OperationOptions): Promise<ExecuteResult>;
+    migrate(input: MigrationInput, options?: OperationOptions): Promise<MigrationResult>;
+    executeMultiple(sql: string, options?: OperationOptions): Promise<void>;
+    session(cursor?: string | null): SqlSession;
+    getSessionCursor(): string | null;
+    resetSessionCursor(): void;
+    ping(options?: OperationOptions): Promise<void>;
+}
+export interface SqlClient extends SqlSession {
+    close(): void;
+}
+export interface WireI64 {
+    $rindle: "i64";
+    value: string;
+}
+export interface WireFloat {
+    $rindle: "float";
+    value: "Infinity" | "-Infinity";
+}
+export type WireSqlValue = null | string | number | WireI64 | WireFloat;
+export type WireArgs = WireSqlValue[] | Record<string, WireSqlValue>;
+export interface WireStatement {
+    sql: string;
+    args?: WireArgs;
+    want_rows?: boolean;
+}
+export interface WireColumn {
+    name: string;
+    decltype: string | null;
+}
+export interface WireStatementResult {
+    columns: WireColumn[];
+    rows: WireSqlValue[][];
+    rows_affected: number;
+    last_insert_rowid: string | null;
+    rows_read: number | null;
+    rows_written: number | null;
+}
+export interface WireRoutingMetadata {
+    served_by: "master" | "follower";
+    applied_lag_ms: number | null;
+    fence_fallback: boolean;
+}
+export interface WireExecuteResponse {
+    result: WireStatementResult;
+    commit_cursor: string | null;
+    routing: WireRoutingMetadata;
+}
+export interface WireBatchResponse {
+    results: WireStatementResult[];
+    commit_cursor: string | null;
+    routing: WireRoutingMetadata;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/value.d.ts

@@ -0,0 +1,8 @@
+import type { IntMode, SqlArgs, SqlValue, Statement, WireArgs, WireSqlValue, WireStatement } from "./types.ts";
+/** Encode one public SDK value into the frozen v1 tagged JSON representation. */
+export declare function encodeSqlValue(value: SqlValue): WireSqlValue;
+/** Decode one frozen v1 tagged JSON value using the client's integer policy. */
+export declare function decodeSqlValue(value: unknown, intMode?: IntMode): SqlValue;
+export declare function encodeArgs(args: SqlArgs): WireArgs;
+export declare function encodeStatement(statement: Statement | string): WireStatement;
+//# sourceMappingURL=value.d.ts.map

package/dist/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../src/value.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqB/G,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,CAuB5D;AAkBD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,OAAkB,GAAG,QAAQ,CA0BpF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAMlD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,aAAa,CAU5E"}

package/dist/value.js

@@ -0,0 +1,122 @@
+import { protocolError, valueUnsupported } from "./errors.js";
+const I64_MIN = -(1n << 63n);
+const I64_MAX = (1n << 63n) - 1n;
+const DECIMAL_I64 = /^(?:0|-[1-9][0-9]*|[1-9][0-9]*)$/;
+function binaryKind(value) {
+    if (typeof ArrayBuffer !== "undefined") {
+        if (value instanceof ArrayBuffer)
+            return "ArrayBuffer";
+        if (ArrayBuffer.isView(value))
+            return value?.constructor?.name ?? "binary view";
+    }
+    if (typeof Blob !== "undefined" && value instanceof Blob)
+        return "Blob";
+    return null;
+}
+function assertI64(value, source) {
+    if (value < I64_MIN || value > I64_MAX) {
+        throw valueUnsupported(`${source} is outside SQLite's signed 64-bit integer range`);
+    }
+}
+/** Encode one public SDK value into the frozen v1 tagged JSON representation. */
+export function encodeSqlValue(value) {
+    if (value === null || typeof value === "string")
+        return value;
+    if (typeof value === "boolean")
+        return { $rindle: "i64", value: value ? "1" : "0" };
+    if (typeof value === "bigint") {
+        assertI64(value, `integer ${value.toString()}`);
+        return { $rindle: "i64", value: value.toString() };
+    }
+    if (typeof value === "number") {
+        if (Number.isNaN(value))
+            throw valueUnsupported("NaN is not a supported SQLite value");
+        if (value === Infinity)
+            return { $rindle: "float", value: "Infinity" };
+        if (value === -Infinity)
+            return { $rindle: "float", value: "-Infinity" };
+        // JavaScript has one number type, but SQLite distinguishes INTEGER and REAL storage classes.
+        // Safe integral numbers carry the exact i64 tag; non-integral and larger numeric values remain
+        // REALs. Callers that need a larger integer must use bigint so intent and precision are explicit.
+        if (Number.isSafeInteger(value)) {
+            return { $rindle: "i64", value: BigInt(value).toString() };
+        }
+        return value;
+    }
+    const kind = binaryKind(value);
+    if (kind !== null)
+        throw valueUnsupported(`${kind} bind values are not supported in Rindle SQL v1`);
+    throw valueUnsupported(`unsupported bind value of type ${typeof value}`);
+}
+function parseWireI64(decimal) {
+    if (typeof decimal !== "string" || !DECIMAL_I64.test(decimal)) {
+        throw protocolError("server returned a malformed tagged i64 value");
+    }
+    let value;
+    try {
+        value = BigInt(decimal);
+    }
+    catch (cause) {
+        throw protocolError("server returned a malformed tagged i64 value", cause);
+    }
+    if (value < I64_MIN || value > I64_MAX) {
+        throw protocolError("server returned an out-of-range tagged i64 value");
+    }
+    return value;
+}
+/** Decode one frozen v1 tagged JSON value using the client's integer policy. */
+export function decodeSqlValue(value, intMode = "bigint") {
+    if (value === null || typeof value === "string")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw protocolError("server returned a non-finite untagged JSON number");
+        return value;
+    }
+    if (typeof value !== "object" || Array.isArray(value)) {
+        throw protocolError("server returned a malformed SQL value");
+    }
+    const tagged = value;
+    if (tagged.$rindle === "float") {
+        if (tagged.value === "Infinity")
+            return Infinity;
+        if (tagged.value === "-Infinity")
+            return -Infinity;
+        throw protocolError("server returned a malformed tagged float value");
+    }
+    if (tagged.$rindle !== "i64")
+        throw protocolError("server returned an unknown tagged SQL value");
+    const integer = parseWireI64(tagged.value);
+    if (intMode === "bigint")
+        return integer;
+    if (intMode === "string")
+        return integer.toString();
+    const number = Number(integer);
+    if (!Number.isSafeInteger(number)) {
+        throw valueUnsupported(`integer ${integer.toString()} is outside Number's safe integer range`);
+    }
+    return number;
+}
+export function encodeArgs(args) {
+    if (Array.isArray(args))
+        return args.map((value) => encodeSqlValue(value));
+    if (args === null || typeof args !== "object") {
+        throw valueUnsupported("statement args must be a positional array or named object");
+    }
+    return Object.fromEntries(Object.entries(args).map(([name, value]) => [name, encodeSqlValue(value)]));
+}
+export function encodeStatement(statement) {
+    const normalized = typeof statement === "string" ? { sql: statement } : statement;
+    if (normalized === null || typeof normalized !== "object" || typeof normalized.sql !== "string") {
+        throw new TypeError("statement must be a SQL string or an object with a string sql field");
+    }
+    if (normalized.sql.length === 0)
+        throw new TypeError("statement sql must not be empty");
+    const wire = { sql: normalized.sql };
+    if (normalized.args !== undefined)
+        wire.args = encodeArgs(normalized.args);
+    if (normalized.wantRows !== undefined)
+        wire.want_rows = normalized.wantRows;
+    return wire;
+}
+//# sourceMappingURL=value.js.map

package/dist/value.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@rindle/sql-client",
+  "version": "0.6.4",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rindle-sh/rindle.git",
+    "directory": "packages/sql-client"
+  },
+  "type": "module",
+  "description": "Fetch-native TypeScript client for Rindle SQL.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "@rindle/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./drizzle": {
+      "@rindle/source": "./src/drizzle.ts",
+      "types": "./dist/drizzle.d.ts",
+      "default": "./dist/drizzle.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "drizzle-orm": "0.44.7"
+  },
+  "peerDependenciesMeta": {
+    "drizzle-orm": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "drizzle-orm": "0.44.7",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc --noEmit && node --conditions=@rindle/source --test test/*.test.ts",
+    "test:rust-daemon": "node --conditions=@rindle/source test/live-server.e2e.mjs"
+  }
+}