@yydb/sqlite 0.0.12 → 0.1.5

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yydb/sqlite",
-  "version": "0.0.12",
-  "description": "Bounded read-only SQLite format-3 snapshot reader, independent of YYDS storage.",
+  "version": "0.1.5",
+  "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,
@@ -18,7 +18,7 @@
     }
   },
   "bin": {
-    "sqlite3": "./bin/sqlite3.mjs"
+    "sqlite": "bin/sqlite3.mjs"
   },
   "files": [
     "bin",
@@ -31,24 +31,24 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/yy-database/yyds.git",
+    "url": "git+https://github.com/yy-database/yydb.git",
     "directory": "projects/packages/sqlite"
   },
-  "homepage": "https://github.com/yy-database/yyds/tree/dev/projects/packages/sqlite#readme",
+  "homepage": "https://github.com/yy-database/yydb/tree/dev/projects/packages/sqlite#readme",
   "bugs": {
-    "url": "https://github.com/yy-database/yyds/issues"
+    "url": "https://github.com/yy-database/yydb/issues"
   },
   "keywords": [
-    "yyds",
+    "yydb",
     "sqlite",
-    "disguise",
+    "format-3",
     "binary-compatible"
   ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@yydb/yyds": "0.0.12"
+    "@yydb/yydb": "0.1.5"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",

package/src/node.ts

@@ -1,27 +1,81 @@
-import { loadYydsSqliteNative } from "@yydb/yyds/node";
-import type {
-    SqliteDatabaseBinding,
-    SqliteDecodedRow,
-    SqliteReadLimits,
-    SqliteRecordValue,
-    SqliteSchemaObject,
-    SqliteSnapshotBinding,
-    SqliteTableRow,
-} from "@yydb/yyds/node";
-
-export type {
-    SqliteDatabaseBinding,
-    SqliteDecodedRow,
-    SqliteReadLimits,
-    SqliteRecordValue,
-    SqliteSchemaObject,
-    SqliteSnapshotBinding,
-    SqliteTableRow,
-} from "@yydb/yyds/node";
-
-/** Text encodings recognised by the SQLite header. */
+import { loadNative } from "@yydb/yydb";
+
+/**
+ * SQLite read-only binding types — declared locally since yydb-napi does not
+ * re-export them through the TS facade. The actual implementations live in
+ * the same native `.node` file loaded by `@yydb/yydb`.
+ */
+
+export interface SqliteReadLimits {
+    maxPages?: number;
+    maxRows?: number;
+    maxPayloadBytes?: number;
+    maxTotalPayloadBytes?: number;
+}
+
+export interface SqliteSchemaObject {
+    kind: string;
+    name: string;
+    tableName: string;
+    rootPage: number | null;
+    sql: string | null;
+}
+
+export interface SqliteTableRow {
+    rowid: number;
+    payload: Buffer;
+}
+
+export interface SqliteRecordValue {
+    kind: string;
+    valueInteger?: number | null;
+    valueReal?: number | null;
+    valueText?: string | null;
+    valueBlob?: Buffer | null;
+}
+
+export interface SqliteDecodedRow {
+    rowid: number;
+    columns: SqliteRecordValue[];
+}
+
+export interface SqliteSnapshotBinding {
+    schema(limits?: SqliteReadLimits): SqliteSchemaObject[];
+    table(name: string, limits?: SqliteReadLimits): SqliteTableRow[];
+    tableDecoded(name: string, limits?: SqliteReadLimits): SqliteDecodedRow[];
+    sqliteVersion(): string;
+    encoding(): string;
+    ping(): number;
+    pages(): Buffer;
+}
+
+export interface SqliteDatabaseBinding {
+    openInMemory(): SqliteDatabaseBinding;
+    open(path: string): SqliteDatabaseBinding;
+    path(): string | null;
+    ping(): number;
+    sqliteVersion(): string;
+    encoding(): string;
+    schema(limits?: SqliteReadLimits): SqliteSchemaObject[];
+    table(name: string, limits?: SqliteReadLimits): SqliteDecodedRow[];
+    tableRaw(name: string, limits?: SqliteReadLimits): SqliteTableRow[];
+    pages(): Buffer;
+}
+
 export type SqliteTextEncoding = "utf8" | "utf16le" | "utf16be";
 
+function loadSqliteNative() {
+    const native = loadNative() as Record<string, unknown>;
+    if (typeof native.SqliteSnapshot !== "function") {
+        throw new Error("Native addon lacks the SQLite snapshot reader. Rebuild the native package.");
+    }
+    return native as unknown as {
+        SqliteSnapshot: new (bytes: Buffer, maxSnapshotBytes: number) => SqliteSnapshotBinding;
+        SqliteDatabase: { openInMemory(): SqliteDatabaseBinding; open(path: string): SqliteDatabaseBinding };
+        decodeRecord: (payload: Buffer, encoding?: string) => SqliteRecordValue[];
+    };
+}
+
 /** Read-only, copied main-file bytes. WAL/journal recovery is not performed. */
 export class SqliteSnapshot {
     readonly #native: SqliteSnapshotBinding;
@@ -34,7 +88,7 @@ export class SqliteSnapshot {
         if (bytes.byteLength > maxSnapshotBytes) {
             throw new RangeError("sqlite snapshot byte limit exceeded");
         }
-        const native = loadYydsSqliteNative();
+        const native = loadSqliteNative();
         this.#native = new native.SqliteSnapshot(Buffer.from(bytes), maxSnapshotBytes);
     }
 
@@ -95,7 +149,7 @@ export class SqliteDatabase {
 
     /** Opens a blank in-memory SQLite format-3 snapshot. */
     static openInMemory(): SqliteDatabase {
-        const native = loadYydsSqliteNative();
+        const native = loadSqliteNative();
         return new SqliteDatabase(native.SqliteDatabase.openInMemory());
     }
 
@@ -104,7 +158,7 @@ export class SqliteDatabase {
         if (typeof path !== "string" || path.length === 0) {
             throw new TypeError("SQLite path must be a non-empty string");
         }
-        const native = loadYydsSqliteNative();
+        const native = loadSqliteNative();
         return new SqliteDatabase(native.SqliteDatabase.open(path));
     }
 
@@ -169,7 +223,7 @@ export function decodeRecord(
     if (!(payload instanceof Uint8Array)) {
         throw new TypeError("payload must be a Uint8Array or Buffer");
     }
-    const native = loadYydsSqliteNative();
+    const native = loadSqliteNative();
     const encArg: string | undefined =
         encoding === undefined ? undefined : encoding;
     return native.decodeRecord(Buffer.from(payload), encArg);