flatsql 1.3.0 → 1.4.5

package/dist/index.d.ts

@@ -4,9 +4,8 @@ export * from './schema/index.js';
 export * from './core/index.js';
 export * from './cluster/index.js';
 export * from './flatbuffer-accessor.js';
-export * from './artifacts/index.js';
+export * from './artifacts/types.js';
 export * from './response/index.js';
-export * from './standalone/index.js';
 export { FlatSQLDatabase, QueryResult, FlatBufferAccessor } from './core/database.js';
 export { TableStore, TableRecord } from './core/table-store.js';
 export { BTree } from './btree/btree.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AAKzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -6,9 +6,12 @@ export * from './schema/index.js';
 export * from './core/index.js';
 export * from './cluster/index.js';
 export * from './flatbuffer-accessor.js';
-export * from './artifacts/index.js';
+// Node-only surfaces (artifacts builder: node:sqlite/node:os; standalone
+// runners: node:child_process/node:fs) live behind the 'flatsql/artifacts'
+// and 'flatsql/standalone/wasmedge' subpath exports so the root entry stays
+// loadable in a browser bundle. Only their type declarations are safe here.
+export * from './artifacts/types.js';
 export * from './response/index.js';
-export * from './standalone/index.js';
 // Re-export main types for convenience
 export { FlatSQLDatabase } from './core/database.js';
 export { TableStore } from './core/table-store.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,sEAAsE;AAEtE,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAEtC,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAmC,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAe,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAuC,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,sEAAsE;AAEtE,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,yEAAyE;AACzE,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AAEpC,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAmC,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAe,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAuC,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flatsql",
-  "version": "1.3.0",
+  "version": "1.4.5",
   "description": "SQL queries over raw FlatBuffer storage - zero conversion, real-time indexing, pure streaming",
   "type": "module",
   "main": "dist/index.js",
@@ -22,6 +22,14 @@
       "types": "./wasm/standalone.d.ts",
       "import": "./wasm/standalone.js"
     },
+    "./io": {
+      "types": "./wasm/flatsql-io.d.ts",
+      "import": "./wasm/flatsql-io.js"
+    },
+    "./artifacts": {
+      "types": "./dist/artifacts/index.d.ts",
+      "import": "./dist/artifacts/index.js"
+    },
     "./artifacts/standalone": {
       "types": "./dist/artifacts/standalone-builder.d.ts",
       "import": "./dist/artifacts/standalone-builder.js"
@@ -68,10 +76,11 @@
     "dev": "tsc --watch",
     "serve": "vite docs --port 8081",
     "check:nav": "node scripts/check-sdn-stack-nav.mjs flatsql docs/index.html",
+    "check:dist": "node scripts/check-dist-tracked.mjs",
     "bench": "node bench/flatsql-perf.mjs",
     "bench:perf": "node bench/flatsql-perf.mjs",
     "bench:perf:profile": "node bench/flatsql-perf.mjs --profile",
-    "prepublishOnly": "npm run build && npm run test:wasi && npm run test:wasmedge && npm test -- --runInBand --runTestsByPath test/package-exports.test.ts test/wasm-generic-extractor.test.ts test/wasm-pointer.test.ts",
+    "prepublishOnly": "npm run build && npm run check:dist && npm run test:wasi && npm run test:wasmedge && npm test -- --runInBand --runTestsByPath test/package-exports.test.ts test/wasm-generic-extractor.test.ts test/wasm-pointer.test.ts",
     "emsdk:install": "bash scripts/install-emsdk.sh",
     "emsdk:env": "echo 'Run: source packages/emsdk/emsdk_env.sh'",
     "test:wasi": "node --experimental-wasm-exnref --experimental-vm-modules node_modules/jest/bin/jest.js --runTestsByPath test/wasi.test.ts test/standalone-wasm-imports.test.ts",
@@ -82,7 +91,9 @@
     "stress:sds:docker-smoke": "bash scripts/stress-docker.sh docker-smoke",
     "stress:sds:docker-fleet": "bash scripts/stress-docker.sh docker-fleet",
     "stress:sds:full-config": "bash scripts/stress-docker.sh full-config",
-    "stress:sds:full": "bash scripts/stress-docker.sh full"
+    "stress:sds:full": "bash scripts/stress-docker.sh full",
+    "check:imports": "node scripts/check-wasm-imports.mjs",
+    "test:io": "node wasm/test-io-persistence.mjs"
   },
   "repository": {
     "type": "git",

package/wasm/flatsql-io.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Types for the FlatSQL host I/O contract (cpp/include/flatsql/flatsql_io.h).
+ *
+ * These live in the flatsql package on purpose: the seven-call shape is an ABI,
+ * and an ABI that each consumer re-declares locally is an ABI that drifts.
+ */
+
+export declare const FLATSQL_IO_READ: number;
+export declare const FLATSQL_IO_WRITE: number;
+export declare const FLATSQL_IO_CREATE: number;
+export declare const FLATSQL_IO_EXCL: number;
+export declare const FLATSQL_IO_TRUNC: number;
+export declare const FLATSQL_IO_DELETE_ON_CLOSE: number;
+/** Namespace op: does the path exist? Returns a status, allocates no handle. */
+export declare const FLATSQL_IO_PROBE: number;
+/** Namespace op: remove the path. Returns a status, allocates no handle. */
+export declare const FLATSQL_IO_UNLINK: number;
+
+export declare const FLATSQL_IO_ERR_GENERIC: number;
+export declare const FLATSQL_IO_ERR_NOENT: number;
+export declare const FLATSQL_IO_ERR_ACCESS: number;
+export declare const FLATSQL_IO_ERR_IO: number;
+export declare const FLATSQL_IO_ERR_NOSPACE: number;
+export declare const FLATSQL_IO_ERR_BADHANDLE: number;
+
+export declare const DEFAULT_CHUNK_BYTES: number;
+
+/**
+ * A backend answers the seven imports SYNCHRONOUSLY, because a wasm import is
+ * synchronous. Offsets and sizes are plain numbers (f64 on the wire — never
+ * i64, which emscripten legalizes differently in the two lanes).
+ */
+export interface FlatSqlIoBackend {
+  /** Returns a handle, or a negative status. PROBE/UNLINK return a status. */
+  open(path: string, flags: number): number;
+  /** Bytes read; may be short at EOF. Never moves an implicit cursor. */
+  read(handle: number, dst: Uint8Array, offset: number): number;
+  /** Bytes written. Writing past EOF extends; the gap reads as zeroes. */
+  write(handle: number, src: Uint8Array, offset: number): number;
+  truncate(handle: number, size: number): number;
+  /**
+   * Durability barrier. On a synchronous backend bytes are durable at return;
+   * on an async store they become durable when the caller awaits flush().
+   */
+  sync(handle: number): number;
+  size(handle: number): number;
+  close(handle: number): number;
+
+  /** Pull a file into the synchronous cache BEFORE the engine opens it. */
+  hydrate(path: string): Promise<unknown>;
+  /** Persist dirty state. No-op on synchronous backends. */
+  flush(): Promise<void>;
+  /** Remove a file and every key backing it. */
+  drop(path: string): Promise<void>;
+
+  readonly kind?: string;
+}
+
+export interface FlatSqlIoChunkOptions {
+  /** Page-group size in bytes. */
+  chunkBytes?: number;
+  /** Key namespace inside the store. */
+  prefix?: string;
+  /** Paths already known to exist. */
+  knownPaths?: string[];
+}
+
+/** Flat key -> bytes store: the shape every browser persistence store has. */
+export interface FlatSqlKeyValueStore {
+  readBytes(key: string): Promise<Uint8Array | null>;
+  writeBytes(key: string, bytes: Uint8Array): Promise<void>;
+  deleteKey(key: string): Promise<void>;
+}
+
+export declare function createMemoryBackend(
+  options?: { chunkBytes?: number },
+): FlatSqlIoBackend;
+
+export declare function createNodeFsBackend(
+  fs: unknown,
+  options?: { root?: string },
+): FlatSqlIoBackend;
+
+/**
+ * Give a flat key -> bytes store real pread/pwrite semantics by addressing
+ * fixed-size page groups. A flush costs O(dirty chunks), not O(file).
+ */
+export declare function createChunkedStoreBackend(
+  store: FlatSqlKeyValueStore,
+  options?: FlatSqlIoChunkOptions,
+): FlatSqlIoBackend & { knownPaths(): string[]; chunkBytes: number };
+
+/** Build the `env` import object for a directly-instantiated (WASI) module. */
+export declare function createFlatSqlIoImports(
+  backend: FlatSqlIoBackend,
+  memoryRef: () => WebAssembly.Memory,
+): Record<string, (...args: number[]) => number>;