@yydb/sqlite 0.1.6 → 0.1.7

package/bin/sqlite3.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 
 import { SqliteDatabase, SqliteSnapshot } from "../src/node.ts";
 
@@ -107,6 +107,9 @@ function main(args) {
     if (!command.startsWith(".")) {
         throw new Error("SQL execution is not available; use a dot command");
     }
+    if (!existsSync(path)) {
+        throw new Error(`database file not found: ${path}`);
+    }
     const database = SqliteDatabase.open(path);
     runDotCommand(database, command);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yydb/sqlite",
-  "version": "0.1.6",
-  "description": "Bounded read-only SQLite format-3 snapshot reader for YYDB — schema inspection, typed record decoding, and blank database creation.",
+  "version": "0.1.7",
+  "description": "Bounded read-only SQLite format-3 snapshot reader for YYDB - schema inspection, typed record decoding, and blank database creation.",
   "license": "MPL-2.0",
   "type": "module",
   "sideEffects": false,
@@ -32,9 +32,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/yy-database/yydb.git",
-    "directory": "projects/packages/sqlite"
+    "directory": "projects/yydb.ts/emulators/sqlite"
   },
-  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/packages/sqlite#readme",
+  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/yydb.ts/emulators/sqlite#readme",
   "bugs": {
     "url": "https://github.com/yy-database/yydb/issues"
   },
@@ -48,7 +48,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@yydb/yydb": "0.1.6"
+    "@yydb/yydb": "0.1.7"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",

package/readme.md

@@ -4,14 +4,31 @@ Read-only inspection of SQLite format-3 main files. Copies bytes into memory, li
 
 SQLite files are not YYDS storage. They are not routed through `.yyds` catalogs or `.yykv` shards.
 
+## Scope
+
+Supported:
+
+- Format-3 main files with page sizes from 512 to 65536 bytes, including UTF-8, UTF-16le, and UTF-16be text.
+- `sqlite_master` / `sqlite_schema` reads with `CREATE` source preserved as opaque text.
+- Rowid-table B-tree scans, including interior pages, implicit rowids, `INTEGER PRIMARY KEY` aliases, composite-key rowid tables, and overflow payloads.
+- Storage-class record decoding (`NULL`, integer, real, text, blob) through `tableDecoded` and `decodeRecord`.
+
+Not supported:
+
+- SQL execution of any kind, including `SELECT`, views, triggers, and virtual tables.
+- Writes, transactional paging, journals, WAL recovery, and live-database consistency. A snapshot is the copied main-file bytes at the moment of reading.
+- Encrypted or non-format-3 files, and index B-tree scans such as `WITHOUT ROWID` tables.
+
+Values are on-disk storage classes, not SQL-projected results. `NULL` and the empty string stay distinct, an `INTEGER PRIMARY KEY` alias column is returned as `NULL` rather than substituted with the rowid, and REAL affinity is not applied, so an integral REAL input can decode as an integer. Use the schema `sql` source to map aliases and declared types.
+
 ## Exports
 
 | Subpath | Use |
 |---------|-----|
-| `@yydb/sqlite` | Types only |
-| `@yydb/sqlite/node` | `SqliteSnapshot` (requires the `@yydb/yyds` native addon) |
+| `@yydb/sqlite` | Types plus `SqliteSnapshot`, `SqliteDatabase`, and `decodeRecord` |
+| `@yydb/sqlite/node` | The same reader surface (requires the `@yydb/yydb` platform addon at call time) |
 
-The `sqlite3` command supports `.tables` and `.schema` on a file path. It does not run SQL statements.
+The `sqlite3` command supports `.tables`, `.schema`, `.dump`, `.ping`, `.encoding`, and `.version` on a file path. It does not run SQL statements.
 
 ## Example
 
@@ -24,8 +41,8 @@ const tables = snapshot.schema().filter((o) => o.kind === "table");
 const rows = snapshot.table("samples", { maxRows: 100 });
 ```
 
-Each row is `{ rowid: bigint, payload: Buffer }` — storage bytes, not SQL-projected values. Schema `sql` fields are opaque CREATE text. The default snapshot size cap is 256 MiB; each scan accepts `maxPages`, `maxRows`, `maxPayloadBytes`, and `maxTotalPayloadBytes`.
+Each row is `{ rowid: bigint, payload: Buffer }` �?storage bytes, not SQL-projected values. Schema `sql` fields are opaque CREATE text. The default snapshot size cap is 256 MiB; each scan accepts `maxPages`, `maxRows`, `maxPayloadBytes`, and `maxTotalPayloadBytes`.
 
 ## Related packages
 
-- [`@yydb/yyds`](https://github.com/yy-database/yyds/tree/dev/projects/packages/yyds) — hosts the native `SqliteSnapshot` binding
+- [`@yydb/yydb`](https://github.com/yy-database/yydb/tree/dev/projects/yydb.ts/packages/yydb) �?hosts the native `SqliteSnapshot` binding through its platform addon

package/src/node.ts

@@ -22,20 +22,20 @@ export interface SqliteSchemaObject {
 }
 
 export interface SqliteTableRow {
-    rowid: number;
+    rowid: bigint;
     payload: Buffer;
 }
 
 export interface SqliteRecordValue {
     kind: string;
-    valueInteger?: number | null;
+    valueInteger?: bigint | null;
     valueReal?: number | null;
     valueText?: string | null;
     valueBlob?: Buffer | null;
 }
 
 export interface SqliteDecodedRow {
-    rowid: number;
+    rowid: bigint;
     columns: SqliteRecordValue[];
 }
 
@@ -65,7 +65,7 @@ export interface SqliteDatabaseBinding {
 export type SqliteTextEncoding = "utf8" | "utf16le" | "utf16be";
 
 function loadSqliteNative() {
-    const native = loadNative() as Record<string, unknown>;
+    const native = loadNative() as unknown as Record<string, unknown>;
     if (typeof native.SqliteSnapshot !== "function") {
         throw new Error("Native addon lacks the SQLite snapshot reader. Rebuild the native package.");
     }