@yydb/sqlite 0.0.0 → 0.0.1

package/README.md

@@ -1,3 +1,6 @@
-# @yydb/sqlite
-
-Placeholder package (0.0.0). Reserved for SQL Studio (@yydb/*) Developer Preview.
+# 🪶 `@yydb/sqlite`
+
+SQLite for **SQL Studio**. Conditional exports isolate WASM vs file backends:
+
+- `@yydb/sqlite/wasm` — browser
+- `@yydb/sqlite/node` — server file database

package/package.json

@@ -1,10 +1,46 @@
 {
   "name": "@yydb/sqlite",
-  "version": "0.0.0",
-  "description": "SQL Studio placeholder — not for production use.",
-  "license": "MIT",
-  "private": false,
+  "version": "0.0.1",
+  "description": "SQLite driver for SQL Studio / sql-studio-orm — 0.0.1 Developer Preview",
+  "type": "module",
+  "license": "MPL-2.0",
+  "sideEffects": false,
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./wasm": {
+      "types": "./src/wasm.ts",
+      "import": "./src/wasm.ts",
+      "default": "./src/wasm.ts"
+    },
+    "./node": {
+      "types": "./src/node.ts",
+      "import": "./src/node.ts",
+      "node": "./src/node.ts",
+      "default": "./src/node.ts"
+    }
+  },
   "files": [
+    "src",
     "README.md"
-  ]
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "@yydb/sql-studio-orm": "0.0.1",
+    "@yydb/sql-studio-protocol": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "dev"
+  }
 }

package/src/index.ts

@@ -0,0 +1,69 @@
+/**
+ * `@yydb/sqlite` — SQLite SqlDriver + Studio registration.
+ * Use `./wasm` or `./node` for concrete backends.
+ */
+
+import type {
+    CompiledQuery,
+    ExecuteOptions,
+    QueryChunk,
+    QueryResult,
+    SqlConnection,
+    SqlDriver,
+    SqlTransaction,
+    StreamOptions,
+    TransactionOptions,
+} from "@yydb/sql-studio-orm";
+import type { StudioDriverRegistration } from "@yydb/sql-studio-protocol";
+
+export const DRIVER_ID = "sqlite" as const;
+
+export type SqliteDriverOptions = {
+    path: string;
+};
+
+export type SqliteStudioOptions = SqliteDriverOptions & {
+    id: string;
+};
+
+class NotImplementedConnection implements SqlConnection {
+    async execute<R>(_query: CompiledQuery, _options?: ExecuteOptions): Promise<QueryResult<R>> {
+        throw new Error("@yydb/sqlite: execute not implemented yet");
+    }
+
+    stream<R>(_query: CompiledQuery, _options?: StreamOptions): AsyncIterable<QueryChunk<R>> {
+        throw new Error("@yydb/sqlite: stream not implemented yet");
+    }
+
+    async begin(_options?: TransactionOptions): Promise<SqlTransaction> {
+        throw new Error("@yydb/sqlite: transactions not implemented yet");
+    }
+}
+
+class SqliteDriver implements SqlDriver {
+    readonly dialect = "sqlite" as const;
+    readonly path: string;
+
+    constructor(options: SqliteDriverOptions) {
+        this.path = options.path;
+    }
+
+    async acquire(): Promise<SqlConnection> {
+        return new NotImplementedConnection();
+    }
+
+    async destroy(): Promise<void> {}
+}
+
+export function sqlite(options: SqliteDriverOptions): SqlDriver;
+export function sqlite(options: SqliteStudioOptions): StudioDriverRegistration;
+export function sqlite(options: SqliteDriverOptions | SqliteStudioOptions): SqlDriver | StudioDriverRegistration {
+    if ("id" in options && options.id) {
+        return {
+            id: options.id,
+            kind: "sqlite",
+            driver: new SqliteDriver(options),
+        };
+    }
+    return new SqliteDriver(options);
+}

package/src/node.ts

@@ -0,0 +1,7 @@
+/**
+ * Node / Bun / Deno file SQLite surface.
+ */
+
+export function openSqliteFile(_path: string): Promise<never> {
+    return Promise.reject(new Error("@yydb/sqlite/node: file backend not implemented yet"));
+}

package/src/wasm.ts

@@ -0,0 +1,7 @@
+/**
+ * Browser / WASM SQLite surface (sql.js or native WASM later).
+ */
+
+export function openSqliteWasm(_options: { wasmUrl?: string }): Promise<never> {
+    return Promise.reject(new Error("@yydb/sqlite/wasm: not implemented yet"));
+}