@statewalker/webrun-files-sqlite 0.10.0

package/dist/codec.d.ts

@@ -0,0 +1,47 @@
+/**
+ * SQLAR compression.
+ *
+ * The format mandates zlib-wrapped Deflate (RFC 1950, the `78 xx` header) —
+ * what zlib's `compress()` writes. Every codec here writes exactly that, so an
+ * archive written by one is read by any other, and by other SQLAR tools.
+ */
+export interface Codec {
+    name: string;
+    /**
+     * Inputs shorter than this are stored plaintext without a deflate attempt:
+     * deflating a short input makes it longer.
+     */
+    minSize: number;
+    deflate(bytes: Uint8Array): Uint8Array | Promise<Uint8Array>;
+    inflate(data: Uint8Array): Uint8Array | Promise<Uint8Array>;
+}
+/** Compression Streams — browsers, Node, Workers. No dependency. */
+export declare function webCodec(opts?: {
+    minSize?: number;
+}): Codec;
+/** The part of the `pako` module this codec uses. */
+export interface PakoModule {
+    deflate(data: Uint8Array, opts?: {
+        level?: number;
+    }): Uint8Array;
+    inflate(data: Uint8Array): Uint8Array;
+}
+/**
+ * pako — synchronous, for runtimes without a usable CompressionStream. The
+ * module is injected so this package does not depend on it:
+ *
+ *     import * as pako from "pako";
+ *     new SqlarFilesApi(driver, { codec: pakoCodec(pako) });
+ */
+export declare function pakoCodec(pako: PakoModule, opts?: {
+    minSize?: number;
+    level?: number;
+}): Codec;
+/**
+ * No compression — still a valid archive. Reading a compressed row through it
+ * throws rather than returning deflate bytes as file content.
+ */
+export declare function rawCodec(): Codec;
+/** webCodec where CompressionStream exists, rawCodec elsewhere. */
+export declare function defaultCodec(): Codec;
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7D;AAID,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,KAAK,CAW/D;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,CAAC;IACjE,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,UAAU,EAChB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9C,KAAK,CASP;AAED;;;GAGG;AACH,wBAAgB,QAAQ,IAAI,KAAK,CAShC;AAED,mEAAmE;AACnE,wBAAgB,YAAY,IAAI,KAAK,CAEpC"}

package/dist/drivers.d.ts

@@ -0,0 +1,73 @@
+import type { SqlDriver, SqlStatement } from "./sql.types.js";
+/** The subset of node:sqlite's `DatabaseSync` this driver uses. */
+export interface NodeSqliteDatabase {
+    exec(sql: string): void;
+    prepare(sql: string): {
+        all(...params: never[]): unknown[];
+        run(...params: never[]): {
+            changes: number | bigint;
+        };
+    };
+}
+/** node:sqlite — local development, tests and any Node deployment. */
+export declare class NodeSqlDriver implements SqlDriver {
+    #private;
+    constructor(db: NodeSqliteDatabase);
+    all<T>(sql: string, ...params: unknown[]): T[];
+    run(sql: string, ...params: unknown[]): void;
+    /** Synchronous from BEGIN to COMMIT, so no other call can interleave on the connection. */
+    transaction(statements: SqlStatement[]): number[];
+}
+/** The subset of a Durable Object's `ctx.storage` this driver uses. */
+export interface DoStorage {
+    sql: {
+        exec(query: string, ...bindings: unknown[]): {
+            toArray(): unknown[];
+        };
+    };
+    transactionSync<T>(fn: () => T): T;
+}
+/**
+ * Durable Object SQLite storage: pass `ctx.storage`. Synchronous; BLOBs come
+ * back as ArrayBuffer. Transactions use `transactionSync`, since `sql.exec`
+ * rejects `BEGIN`.
+ */
+export declare class DoSqlDriver implements SqlDriver {
+    #private;
+    constructor(storage: DoStorage);
+    all<T>(sql: string, ...params: unknown[]): T[];
+    run(sql: string, ...params: unknown[]): void;
+    /**
+     * Counts come from SQLite's `changes()` on the same connection, not from the
+     * cursor's `rowsWritten`, which also counts every index row a write touches.
+     */
+    transaction(statements: SqlStatement[]): number[];
+}
+/** The subset of a `D1Database` this driver uses. */
+export interface D1Database {
+    prepare(query: string): D1PreparedStatement;
+    batch(statements: D1BoundStatement[]): Promise<{
+        meta: {
+            changes: number;
+        };
+    }[]>;
+}
+interface D1PreparedStatement {
+    bind(...values: unknown[]): D1BoundStatement;
+}
+interface D1BoundStatement {
+    all(): Promise<{
+        results: unknown[];
+    }>;
+    run(): Promise<unknown>;
+}
+/** Cloudflare D1. Asynchronous; BLOBs come back as number[]; transactions are `batch()`. */
+export declare class D1SqlDriver implements SqlDriver {
+    #private;
+    constructor(db: D1Database);
+    all<T>(sql: string, ...params: unknown[]): Promise<T[]>;
+    run(sql: string, ...params: unknown[]): Promise<void>;
+    transaction(statements: SqlStatement[]): Promise<number[]>;
+}
+export {};
+//# sourceMappingURL=drivers.d.ts.map

package/dist/drivers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drivers.d.ts","sourceRoot":"","sources":["../src/drivers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9D,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QACpB,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC;QACnC,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG;YAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;KACvD,CAAC;CACH;AAED,sEAAsE;AACtE,qBAAa,aAAc,YAAW,SAAS;;IAG7C,YAAY,EAAE,EAAE,kBAAkB,EAEjC;IAED,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAE7C;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAE3C;IAED,2FAA2F;IAC3F,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAYhD;CACF;AAED,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE;QACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG;YAAE,OAAO,IAAI,OAAO,EAAE,CAAA;SAAE,CAAC;KACvE,CAAC;IACF,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,qBAAa,WAAY,YAAW,SAAS;;IAG3C,YAAY,OAAO,EAAE,SAAS,EAE7B;IAED,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAE7C;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAG3C;IAED;;;OAGG;IACH,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAQhD;CACF;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAAC;IAC5C,KAAK,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,CAAC,CAAC;CACjF;AAED,UAAU,mBAAmB;IAC3B,IAAI,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC;CAC9C;AAED,UAAU,gBAAgB;IACxB,GAAG,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACvC,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,4FAA4F;AAC5F,qBAAa,WAAY,YAAW,SAAS;;IAG3C,YAAY,EAAE,EAAE,UAAU,EAEzB;IAEK,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAM5D;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1D;IAEK,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM/D;CACF"}