@weapp-sqlite/devtools 0.0.0-stage → 0.1.0

package/dist/runtime.mjs

@@ -0,0 +1,394 @@
+import { c as isRecord, d as serializeDevtoolsError, f as validDatabaseNames, l as isSqliteDevtoolsMethod, m as encodeSqliteDevtoolsValue, o as SqliteDevtoolsError, p as decodeSqliteDevtoolsValue, s as isIdentifier, u as isSqliteDevtoolsWriteMethod } from "./protocol-nkWp0_XO.mjs";
+//#region src/socket.ts
+function toBinaryBytes(value) {
+	if (typeof ArrayBuffer !== "undefined" && value instanceof ArrayBuffer) return new Uint8Array(value);
+	if (typeof ArrayBuffer !== "undefined" && ArrayBuffer.isView(value)) {
+		const view = value;
+		return new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+	}
+}
+function decodeUtf8(value) {
+	if (typeof value === "string") return value;
+	const bytes = toBinaryBytes(value);
+	if (!bytes) return;
+	if (typeof TextDecoder !== "undefined") try {
+		return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+	} catch {
+		return;
+	}
+	let output = "";
+	for (let index = 0; index < bytes.length;) {
+		const first = bytes[index++] ?? -1;
+		if (first <= 127) {
+			output += String.fromCharCode(first);
+			continue;
+		}
+		const continuation = (count) => {
+			if (index + count > bytes.length) return;
+			let codePoint = 0;
+			for (let offset = 0; offset < count; offset++) {
+				const next = bytes[index++] ?? -1;
+				if ((next & 192) !== 128) return;
+				codePoint = codePoint << 6 | next & 63;
+			}
+			return codePoint;
+		};
+		let codePoint;
+		if (first >= 194 && first <= 223) {
+			const next = bytes[index++] ?? -1;
+			if ((next & 192) === 128) codePoint = (first & 31) << 6 | next & 63;
+		} else if (first >= 224 && first <= 239) {
+			const second = bytes[index++] ?? -1;
+			if (first === 224 && second >= 160 && second <= 191 || first === 237 && second >= 128 && second <= 159 || first !== 224 && first !== 237 && second >= 128 && second <= 191) {
+				const next = continuation(1);
+				if (next !== void 0) codePoint = (first & 15) << 12 | (second & 63) << 6 | next;
+			}
+		} else if (first >= 240 && first <= 244) {
+			const second = bytes[index++] ?? -1;
+			if (first === 240 && second >= 144 && second <= 191 || first === 244 && second >= 128 && second <= 143 || first !== 240 && first !== 244 && second >= 128 && second <= 191) {
+				const next = continuation(2);
+				if (next !== void 0) codePoint = (first & 7) << 18 | (second & 63) << 12 | next;
+			}
+		}
+		if (codePoint === void 0 || codePoint > 1114111 || codePoint >= 55296 && codePoint <= 57343) return;
+		output += String.fromCodePoint(codePoint);
+	}
+	return output;
+}
+function createWebSocketFactory(Constructor) {
+	return (url, handlers) => {
+		let socket;
+		let ended = false;
+		let underlyingClosed = false;
+		function closeUnderlying() {
+			if (!socket || underlyingClosed) return;
+			underlyingClosed = true;
+			try {
+				socket.close();
+			} catch {}
+		}
+		function fail() {
+			if (ended) return;
+			ended = true;
+			closeUnderlying();
+			handlers.error();
+		}
+		try {
+			socket = new Constructor(url);
+			socket.addEventListener("open", () => {
+				if (!ended) handlers.open();
+			});
+			socket.addEventListener("message", (event) => {
+				if (ended) return;
+				const data = decodeUtf8(event.data);
+				if (data === void 0) {
+					fail();
+					return;
+				}
+				handlers.message(data);
+			});
+			socket.addEventListener("close", () => {
+				if (ended) return;
+				ended = true;
+				handlers.close();
+			});
+			socket.addEventListener("error", fail);
+		} catch {
+			fail();
+		}
+		return {
+			send(data) {
+				if (ended || !socket) return;
+				try {
+					socket.send(data);
+				} catch {
+					fail();
+				}
+			},
+			close() {
+				if (ended) return;
+				ended = true;
+				closeUnderlying();
+			}
+		};
+	};
+}
+/** 直接使用 SocketTask，不依赖浏览器全局变量或动态求值。 */
+function createWeappSocketFactory(api) {
+	return (url, handlers) => {
+		let task;
+		let ended = false;
+		let underlyingClosed = false;
+		function closeUnderlying() {
+			if (!task || underlyingClosed) return;
+			underlyingClosed = true;
+			try {
+				task.close({
+					code: 1e3,
+					reason: "SQLite DevTools closed"
+				});
+			} catch {}
+		}
+		function fail() {
+			if (ended) return;
+			ended = true;
+			closeUnderlying();
+			handlers.error();
+		}
+		function handleMessage(event) {
+			if (ended) return;
+			const data = decodeUtf8(event.data);
+			if (data === void 0) {
+				fail();
+				return;
+			}
+			handlers.message(data);
+		}
+		try {
+			task = api.connectSocket({
+				url,
+				success: () => {},
+				fail
+			});
+			if (!task) throw new Error("wx.connectSocket did not return a SocketTask.");
+			if (ended) closeUnderlying();
+			else {
+				task.onOpen(() => {
+					if (!ended) handlers.open();
+				});
+				task.onMessage(handleMessage);
+				task.onClose(() => {
+					if (ended) return;
+					ended = true;
+					handlers.close();
+				});
+				task.onError(fail);
+			}
+		} catch {
+			fail();
+		}
+		return {
+			send(data) {
+				if (ended || !task) return;
+				try {
+					task.send({
+						data,
+						fail
+					});
+				} catch {
+					fail();
+				}
+			},
+			close() {
+				if (ended) return;
+				ended = true;
+				closeUnderlying();
+			}
+		};
+	};
+}
+//#endregion
+//#region src/runtime.ts
+function utf8ByteLength(value) {
+	if (typeof TextEncoder !== "undefined") return new TextEncoder().encode(value).byteLength;
+	let bytes = 0;
+	for (const character of value) {
+		const codePoint = character.codePointAt(0) ?? 0;
+		bytes += codePoint <= 127 ? 1 : codePoint <= 2047 ? 2 : codePoint <= 65535 ? 3 : 4;
+	}
+	return bytes;
+}
+/** 只登记和转发当前运行时的数据库，断线后不重放任何数据库操作。 */
+function connectSqliteDevtoolsRuntime(options) {
+	if (!/^ws:\/\/(?:127\.0\.0\.1|localhost|\[::1\])(?::\d+)?\//.test(options.endpoint) || !options.token || !isIdentifier(options.runtime.id) || !isIdentifier(options.runtime.label) || !isIdentifier(options.runtime.platform)) throw new SqliteDevtoolsError("SQLITE_DEVTOOLS_INVALID_CONFIG", "SQLite DevTools requires a loopback endpoint and valid runtime identity.");
+	let disposed = false;
+	let generation = 0;
+	let socket;
+	let reconnectTimer;
+	let authTimer;
+	let sessionId;
+	let allowWrite = false;
+	let requestIds = /* @__PURE__ */ new Set();
+	let reconnectAttempt = 0;
+	let releaseVersion = 0;
+	let releaseInProgress;
+	function databases() {
+		const names = [...options.listDatabases()];
+		if (!validDatabaseNames(names)) throw new SqliteDevtoolsError("SQLITE_DEVTOOLS_INVALID_CONFIG", "SQLite DevTools database names are invalid.");
+		return names;
+	}
+	function send(payload) {
+		const text = JSON.stringify(payload);
+		if (utf8ByteLength(text) > 16777216) throw new SqliteDevtoolsError("SQLITE_DEVTOOLS_PAYLOAD_LIMIT", "SQLite DevTools message exceeds the size limit.");
+		socket?.send(text);
+	}
+	function disconnect(current) {
+		if (current !== generation) return;
+		generation += 1;
+		sessionId = void 0;
+		requestIds.clear();
+		clearTimeout(authTimer);
+		const previous = socket;
+		socket = void 0;
+		try {
+			previous?.close();
+		} catch {}
+		Promise.resolve().then(() => options.onDisconnect?.()).catch(() => {});
+		if (!disposed && !reconnectTimer) {
+			const delay = Math.min(5e3, (options.reconnectDelayMs ?? 500) * 2 ** Math.min(reconnectAttempt++, 4));
+			reconnectTimer = setTimeout(() => {
+				reconnectTimer = void 0;
+				connect();
+			}, delay);
+		}
+	}
+	async function receive(text, current) {
+		if (disposed || current !== generation) return;
+		try {
+			if (utf8ByteLength(text) > 16777216) throw new Error("Oversized message");
+			const message = JSON.parse(text);
+			if (!isRecord(message)) throw new Error("Invalid message");
+			if (message.type === "ready" && isIdentifier(message.sessionId) && typeof message.allowWrite === "boolean") {
+				if (sessionId) throw new Error("Duplicate handshake");
+				clearTimeout(authTimer);
+				sessionId = message.sessionId;
+				allowWrite = message.allowWrite;
+				reconnectAttempt = 0;
+				return;
+			}
+			if (message.type === "release") {
+				if (!sessionId || message.sessionId !== sessionId || !isIdentifier(message.requestId)) throw new Error("Invalid runtime release");
+				const requestedSession = sessionId;
+				++releaseVersion;
+				const release = (async () => {
+					await options.onDisconnect?.();
+				})();
+				releaseInProgress = release;
+				try {
+					await release;
+					if (!disposed && current === generation && requestedSession === sessionId) send({
+						type: "release-result",
+						sessionId: requestedSession,
+						requestId: message.requestId,
+						result: {
+							ok: true,
+							value: encodeSqliteDevtoolsValue(void 0)
+						}
+					});
+				} catch (error) {
+					if (!disposed && current === generation && requestedSession === sessionId) send({
+						type: "release-result",
+						sessionId: requestedSession,
+						requestId: message.requestId,
+						result: {
+							ok: false,
+							error: serializeDevtoolsError(error)
+						}
+					});
+				} finally {
+					if (releaseInProgress === release) releaseInProgress = void 0;
+				}
+				return;
+			}
+			if (message.type !== "request" || !sessionId || message.sessionId !== sessionId || !isIdentifier(message.requestId)) throw new Error("Invalid runtime request");
+			if (requestIds.has(message.requestId) || requestIds.size >= 1e5) throw new Error("Duplicate or excessive request ids");
+			requestIds.add(message.requestId);
+			const requestId = message.requestId;
+			const requestedSession = sessionId;
+			const requestedReleaseVersion = releaseVersion;
+			let result;
+			try {
+				if (releaseInProgress) await releaseInProgress;
+				if (disposed || current !== generation || requestedSession !== sessionId || requestedReleaseVersion !== releaseVersion) return;
+				if (!isSqliteDevtoolsMethod(message.method) || message.method === "close" || !isIdentifier(message.databaseName) || !databases().includes(message.databaseName)) throw new SqliteDevtoolsError("SQLITE_DEVTOOLS_INVALID_REQUEST", "Unknown SQLite database or operation.");
+				if (!allowWrite && isSqliteDevtoolsWriteMethod(message.method)) throw new SqliteDevtoolsError("SQLITE_DEVTOOLS_READ_ONLY", "This SQLite DevTools session is read-only.");
+				const args = decodeSqliteDevtoolsValue(message.args);
+				if (!Array.isArray(args) || args.length > 8) throw new SqliteDevtoolsError("SQLITE_DEVTOOLS_INVALID_REQUEST", "SQLite operation arguments must be an array.");
+				const controller = await options.getController(message.databaseName);
+				if (disposed || current !== generation || requestedSession !== sessionId) return;
+				if (!databases().includes(message.databaseName)) throw new SqliteDevtoolsError("SQLITE_DEVTOOLS_DATABASE_CLOSED", "The selected SQLite database is no longer registered.");
+				const value = await controller[message.method].apply(controller, args);
+				result = {
+					ok: true,
+					value: encodeSqliteDevtoolsValue(value)
+				};
+			} catch (error) {
+				result = {
+					ok: false,
+					error: serializeDevtoolsError(error)
+				};
+			}
+			if (!disposed && current === generation && requestedSession === sessionId) send({
+				type: "result",
+				sessionId,
+				requestId,
+				result
+			});
+		} catch {
+			disconnect(current);
+		}
+	}
+	function connect() {
+		if (disposed) return;
+		const current = ++generation;
+		requestIds = /* @__PURE__ */ new Set();
+		try {
+			const created = options.createSocket(options.endpoint, {
+				open() {
+					queueMicrotask(() => {
+						if (disposed || current !== generation) return;
+						try {
+							send({
+								type: "hello",
+								protocol: 1,
+								token: options.token,
+								runtime: options.runtime,
+								databases: databases()
+							});
+							authTimer = setTimeout(disconnect, 5e3, current);
+						} catch {
+							disconnect(current);
+						}
+					});
+				},
+				message: (text) => {
+					receive(text, current);
+				},
+				close: () => disconnect(current),
+				error: () => disconnect(current)
+			});
+			if (disposed || current !== generation) {
+				try {
+					created.close();
+				} catch {}
+				return;
+			}
+			socket = created;
+		} catch {
+			disconnect(current);
+		}
+	}
+	connect();
+	return {
+		refresh() {
+			if (!disposed && sessionId) try {
+				send({
+					type: "databases",
+					sessionId,
+					databases: databases()
+				});
+			} catch {
+				disconnect(generation);
+			}
+		},
+		close() {
+			if (disposed) return;
+			disposed = true;
+			clearTimeout(reconnectTimer);
+			clearTimeout(authTimer);
+			disconnect(generation);
+		}
+	};
+}
+//#endregion
+export { connectSqliteDevtoolsRuntime, createWeappSocketFactory, createWebSocketFactory };

package/package.json

@@ -1,6 +1,93 @@
 {
   "name": "@weapp-sqlite/devtools",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "type": "module",
+  "version": "0.1.0",
+  "description": "连接 Web 与小程序实时 SQLite 数据库的 Devframe 开发工具",
+  "author": "weapp-sqlite contributors",
+  "license": "MIT",
+  "homepage": "https://github.com/weapp-sqlite/weapp-sqlite#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weapp-sqlite/weapp-sqlite.git",
+    "directory": "packages/devtools"
+  },
+  "bugs": {
+    "url": "https://github.com/weapp-sqlite/weapp-sqlite/issues"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.mts",
+      "import": "./dist/runtime.mjs",
+      "require": "./dist/runtime.cjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.mts",
+      "import": "./dist/client.mjs",
+      "require": "./dist/client.cjs"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.mts",
+      "import": "./dist/protocol.mjs",
+      "require": "./dist/protocol.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.22.1"
+  },
+  "tsd": {
+    "compilerOptions": {
+      "lib": [
+        "ESNext",
+        "DOM",
+        "DOM.Iterable"
+      ],
+      "module": "NodeNext",
+      "moduleResolution": "Bundler",
+      "baseUrl": ".",
+      "paths": {
+        "@weapp-sqlite/core": [
+          "../core/dist/index.d.mts"
+        ],
+        "@weapp-sqlite/debug": [
+          "../debug/dist/index.d.mts"
+        ]
+      },
+      "skipLibCheck": true
+    }
+  },
+  "dependencies": {
+    "@vitejs/devtools": "0.7.6",
+    "@vitejs/devtools-kit": "0.7.6",
+    "@weapp-sqlite/debug": "0.2.0",
+    "devframe": "1.2.0",
+    "vite": "8.3.2",
+    "ws": "^8.22.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsdown && tsx build-client.ts",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "tsc -p tsconfig.json",
+    "tsd": "pnpm build && tsd --typings dist/index.d.mts --files test-d/**/*.test-d.ts"
+  }
 }