totalum-sdk 0.1.0-dev.4 → 0.1.0-dev.6

package/dist/d1/errors.d.ts

@@ -1,27 +0,0 @@
-import type { ErrorBody, ErrorCode } from '@speed-paradigm/totalum-contracts';
-/** Client-side codes of plan 05 §7.2 that never travel on the wire, so they are not in the contracts enum. */
-export type TotalumD1ClientCode = 'SDK_NOT_CONFIGURED' | 'NOT_SUPPORTED' | 'BATCH_FOREIGN_STATEMENT' | 'NETWORK_ERROR' | 'RESPONSE_PARSE_ERROR';
-export type TotalumD1ErrorCode = ErrorCode | TotalumD1ClientCode;
-/**
- * The database twin of `TotalumError` (plan 05 §3.5): `message` is `D1_ERROR: …`-shaped so it reads like a
- * native failure — byte-identical to the binding's message when the failure is SQLite's.
- */
-export declare class TotalumD1Error extends Error {
-    readonly name = "TotalumD1Error";
-    readonly errorCode: TotalumD1ErrorCode;
-    /** HTTP status; 0 for network errors, 500 for client-side refusals. */
-    readonly status: number;
-    readonly details: Record<string, unknown> | undefined;
-    readonly requestId: string | undefined;
-    constructor(errorCode: TotalumD1ErrorCode, message: string, options?: {
-        status?: number;
-        details?: Record<string, unknown>;
-        requestId?: string;
-    });
-    /** A client-side refusal (`D1_ERROR: <code>: <message>`). */
-    static client(errorCode: TotalumD1ClientCode | 'EXEC_REQUIRES_MIGRATE_MODE', message: string): TotalumD1Error;
-    /** The SDK-API error envelope → typed error; `SQL_ERROR` rebuilds the native message from `sqliteMessage`. */
-    static fromWire(errors: ErrorBody, status: number, requestId: string | undefined): TotalumD1Error;
-}
-export declare function isTotalumD1Error(e: unknown): e is TotalumD1Error;
-export declare function isRecord(v: unknown): v is Record<string, unknown>;

package/dist/d1/https.d.ts

@@ -1,10 +0,0 @@
-import type { Executor } from './types.js';
-export interface HttpsConfig {
-    apiUrl: string;
-    key: string;
-    env: 'dev' | 'live';
-    migrate: boolean;
-    destructive: boolean;
-}
-/** The `D1Database` half that speaks `POST /v1/db/query|batch` (plan 04 §3.2; contracts `db.ts`). */
-export declare function httpsExecutor(config: HttpsConfig): Executor;

package/dist/d1/lazy.d.ts

@@ -1,7 +0,0 @@
-import type { D1Database, Executor } from './types.js';
-/**
- * The object `totalumD1()` hands out: no I/O and no environment detection until the first statement runs;
- * the target is resolved once and cached (plan 05 §3.1). Statements remember `sql` + params and are
- * materialised on the resolved target when executed, so `drizzle(totalumD1())` at module scope is legal.
- */
-export declare function lazyD1(resolve: () => Promise<Executor>, migrate: boolean): D1Database;

package/dist/d1/libsql.d.ts

@@ -1,23 +0,0 @@
-import type { Executor } from './types.js';
-/** The slice of `@libsql/client`'s `Client` the adapter uses, declared structurally (no third-party types leak). */
-export interface LibsqlClient {
-    execute(statement: LibsqlStatement): Promise<LibsqlResultSet>;
-    batch(statements: LibsqlStatement[], mode: 'write'): Promise<LibsqlResultSet[]>;
-}
-export type LibsqlValue = string | number | bigint | boolean | null | ArrayBuffer | Uint8Array;
-export interface LibsqlStatement {
-    sql: string;
-    args: LibsqlValue[];
-}
-export interface LibsqlResultSet {
-    columns: string[];
-    rows: ArrayLike<unknown>[];
-    rowsAffected: number;
-    lastInsertRowid: bigint | undefined | null;
-}
-/**
- * The Turso path (A3.8, plan 05 §3.10): a `D1Database`-compatible executor over a libsql client created with
- * `intMode: 'bigint'` (integers beyond 2^53 then degrade to the same double D1 returns instead of throwing).
- * `meta` is synthesised from what libsql reports; `size_after` is not reported by libsql and is 0.
- */
-export declare function libsqlExecutor(client: LibsqlClient): Executor;

package/dist/d1/sql.d.ts

@@ -1,9 +0,0 @@
-/** Native D1 refuses these at `bind()` time with `D1_TYPE_ERROR`; both non-native paths do the same, synchronously. */
-export declare function assertBindable(values: unknown[]): void;
-/** `first(col)` as the binding does it: `null` on no rows, `D1_COLUMN_NOTFOUND` on an unknown column. */
-export declare function pickFirst(results: unknown[], colName: string | undefined): unknown;
-/**
- * Splits an `exec()` script on statement boundaries — `;` inside string literals, quoted identifiers and
- * comments is not a boundary (plan 05 §3.4). Empty trailing fragments are dropped.
- */
-export declare function splitStatements(script: string): string[];

package/dist/d1/types.d.ts

@@ -1,72 +0,0 @@
-/**
- * Cloudflare's `D1Database` surface, re-declared structurally so an app needs no Cloudflare types to compile
- * and `drizzle-orm/d1` accepts the object (plan 05 §1, §3.1). `D1Meta` is Cloudflare's own interface
- * (`size_after` required); the contracts wire shape is looser and every value here satisfies it (type-tested).
- */
-export type D1Meta = {
-    duration: number;
-    size_after: number;
-    rows_read: number;
-    rows_written: number;
-    last_row_id: number;
-    changed_db: boolean;
-    changes: number;
-    served_by_region?: string;
-    served_by_primary?: boolean;
-};
-export interface D1Result<T = Record<string, unknown>> {
-    results: T[];
-    success: true;
-    meta: D1Meta;
-}
-export interface D1ExecResult {
-    count: number;
-    duration: number;
-}
-export interface D1PreparedStatement {
-    bind(...values: unknown[]): D1PreparedStatement;
-    first<T = Record<string, unknown>>(colName?: string): Promise<T | null>;
-    run<T = Record<string, unknown>>(): Promise<D1Result<T>>;
-    all<T = Record<string, unknown>>(): Promise<D1Result<T>>;
-    raw<T = unknown[]>(options: {
-        columnNames: true;
-    }): Promise<[string[], ...T[]]>;
-    raw<T = unknown[]>(options?: {
-        columnNames?: false;
-    }): Promise<T[]>;
-}
-export interface D1DatabaseSession {
-    prepare(sql: string): D1PreparedStatement;
-    batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
-    getBookmark(): string | null;
-}
-export interface D1Database {
-    prepare(sql: string): D1PreparedStatement;
-    batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
-    exec(sql: string): Promise<D1ExecResult>;
-    dump(): Promise<ArrayBuffer>;
-    withSession(constraintOrBookmark?: string): D1DatabaseSession;
-}
-/** What a resolved target must offer; a native binding satisfies it, the HTTPS and libsql executors implement it. */
-export interface Executor {
-    prepare(sql: string): D1PreparedStatement;
-    batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
-    /** Native only: the binding's own line-based `exec`. Executors without it run `exec` as one atomic batch. */
-    exec?(sql: string): Promise<D1ExecResult>;
-}
-export interface TotalumD1Options {
-    /** `'migrate'` (scripts/migrate.ts only) sends `x-totalum-migrate: 1` and enables `exec()`; default `'query'`. */
-    mode?: 'query' | 'migrate';
-    /** Migrate mode only: sends `x-totalum-migrate-destructive: 1` (A10.4). */
-    destructive?: boolean;
-    /** HTTPS path only; default `TOTALUM_ENV`, then `'live'`. */
-    env?: 'dev' | 'live';
-    /** Default `TOTALUM_SDK_API_URL`, then `https://sdk-api.totalum.app`. */
-    apiUrl?: string;
-    /** Default `TOTALUM_PROJECT_KEY`. */
-    key?: string;
-    /** An explicit binding wins over detection (plain Workers: `env.TOTALUM_DB`; tests: a Miniflare D1). */
-    binding?: D1Database;
-    /** `'https'` forces the HTTPS path even inside a Worker (the conformance corpus); default `'auto'`. */
-    transport?: 'auto' | 'https';
-}