@weapp-sqlite/devtools 0.0.0-init.0 → 0.1.0

package/dist/runtime.cjs

@@ -0,0 +1,397 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_protocol = require("./protocol-Cl3y675u.cjs");
+//#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 || !require_protocol.isIdentifier(options.runtime.id) || !require_protocol.isIdentifier(options.runtime.label) || !require_protocol.isIdentifier(options.runtime.platform)) throw new require_protocol.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 (!require_protocol.validDatabaseNames(names)) throw new require_protocol.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 require_protocol.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 (!require_protocol.isRecord(message)) throw new Error("Invalid message");
+			if (message.type === "ready" && require_protocol.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 || !require_protocol.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: require_protocol.encodeSqliteDevtoolsValue(void 0)
+						}
+					});
+				} catch (error) {
+					if (!disposed && current === generation && requestedSession === sessionId) send({
+						type: "release-result",
+						sessionId: requestedSession,
+						requestId: message.requestId,
+						result: {
+							ok: false,
+							error: require_protocol.serializeDevtoolsError(error)
+						}
+					});
+				} finally {
+					if (releaseInProgress === release) releaseInProgress = void 0;
+				}
+				return;
+			}
+			if (message.type !== "request" || !sessionId || message.sessionId !== sessionId || !require_protocol.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 (!require_protocol.isSqliteDevtoolsMethod(message.method) || message.method === "close" || !require_protocol.isIdentifier(message.databaseName) || !databases().includes(message.databaseName)) throw new require_protocol.SqliteDevtoolsError("SQLITE_DEVTOOLS_INVALID_REQUEST", "Unknown SQLite database or operation.");
+				if (!allowWrite && require_protocol.isSqliteDevtoolsWriteMethod(message.method)) throw new require_protocol.SqliteDevtoolsError("SQLITE_DEVTOOLS_READ_ONLY", "This SQLite DevTools session is read-only.");
+				const args = require_protocol.decodeSqliteDevtoolsValue(message.args);
+				if (!Array.isArray(args) || args.length > 8) throw new require_protocol.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 require_protocol.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: require_protocol.encodeSqliteDevtoolsValue(value)
+				};
+			} catch (error) {
+				result = {
+					ok: false,
+					error: require_protocol.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
+exports.connectSqliteDevtoolsRuntime = connectSqliteDevtoolsRuntime;
+exports.createWeappSocketFactory = createWeappSocketFactory;
+exports.createWebSocketFactory = createWebSocketFactory;

package/dist/runtime.d.cts

@@ -0,0 +1,68 @@
+import { f as SqliteDevtoolsRuntime } from "./protocol-BhfjLrSe.cjs";
+import { SqliteDebugController } from "@weapp-sqlite/debug";
+//#region src/socket.d.ts
+interface SqliteDevtoolsSocketHandlers {
+  readonly open: () => void;
+  readonly message: (data: string) => void;
+  readonly close: () => void;
+  readonly error: () => void;
+}
+interface SqliteDevtoolsSocket {
+  send: (data: string) => void;
+  close: () => void;
+}
+type SqliteDevtoolsSocketFactory = (url: string, handlers: SqliteDevtoolsSocketHandlers) => SqliteDevtoolsSocket;
+interface SqliteDevtoolsWebSocket {
+  send: (data: string) => void;
+  close: () => void;
+  addEventListener: (type: string, listener: (event: {
+    data?: unknown;
+  }) => void) => void;
+}
+export declare function createWebSocketFactory(Constructor: new (url: string) => SqliteDevtoolsWebSocket): SqliteDevtoolsSocketFactory;
+interface SqliteDevtoolsWeappSocketTask {
+  send: (options: {
+    data: string;
+    fail?: () => void;
+  }) => void;
+  close: (options: {
+    code: number;
+    reason: string;
+  }) => void;
+  onOpen: (handler: () => void) => void;
+  onMessage: (handler: (event: {
+    data: string | ArrayBuffer;
+  }) => void) => void;
+  onClose: (handler: () => void) => void;
+  onError: (handler: () => void) => void;
+}
+interface SqliteDevtoolsWeappSocketApi {
+  connectSocket: (options: {
+    url: string;
+    success: () => void;
+    fail: () => void;
+  }) => SqliteDevtoolsWeappSocketTask;
+}
+/** 直接使用 SocketTask，不依赖浏览器全局变量或动态求值。 */
+export declare function createWeappSocketFactory(api: SqliteDevtoolsWeappSocketApi): SqliteDevtoolsSocketFactory;
+//#endregion
+//#region src/runtime.d.ts
+export interface ConnectSqliteDevtoolsRuntimeOptions {
+  readonly endpoint: string;
+  readonly token: string;
+  readonly runtime: SqliteDevtoolsRuntime;
+  readonly listDatabases: () => readonly string[];
+  readonly getController: (databaseName: string) => SqliteDebugController | Promise<SqliteDebugController>;
+  readonly createSocket: SqliteDevtoolsSocketFactory;
+  /** Releases debug-only resources without closing application database handles. */
+  readonly onDisconnect?: () => void | Promise<void>;
+  readonly reconnectDelayMs?: number;
+}
+export interface SqliteDevtoolsRuntimeConnection {
+  refresh: () => void;
+  close: () => void;
+}
+/** 只登记和转发当前运行时的数据库，断线后不重放任何数据库操作。 */
+export declare function connectSqliteDevtoolsRuntime(options: ConnectSqliteDevtoolsRuntimeOptions): SqliteDevtoolsRuntimeConnection;
+//#endregion
+export type { SqliteDevtoolsSocket, SqliteDevtoolsSocketFactory, SqliteDevtoolsSocketHandlers, SqliteDevtoolsWeappSocketApi, SqliteDevtoolsWeappSocketTask, SqliteDevtoolsWebSocket };

package/dist/runtime.d.mts

@@ -0,0 +1,68 @@
+import { f as SqliteDevtoolsRuntime } from "./protocol-BhfjLrSe.mjs";
+import { SqliteDebugController } from "@weapp-sqlite/debug";
+//#region src/socket.d.ts
+interface SqliteDevtoolsSocketHandlers {
+  readonly open: () => void;
+  readonly message: (data: string) => void;
+  readonly close: () => void;
+  readonly error: () => void;
+}
+interface SqliteDevtoolsSocket {
+  send: (data: string) => void;
+  close: () => void;
+}
+type SqliteDevtoolsSocketFactory = (url: string, handlers: SqliteDevtoolsSocketHandlers) => SqliteDevtoolsSocket;
+interface SqliteDevtoolsWebSocket {
+  send: (data: string) => void;
+  close: () => void;
+  addEventListener: (type: string, listener: (event: {
+    data?: unknown;
+  }) => void) => void;
+}
+export declare function createWebSocketFactory(Constructor: new (url: string) => SqliteDevtoolsWebSocket): SqliteDevtoolsSocketFactory;
+interface SqliteDevtoolsWeappSocketTask {
+  send: (options: {
+    data: string;
+    fail?: () => void;
+  }) => void;
+  close: (options: {
+    code: number;
+    reason: string;
+  }) => void;
+  onOpen: (handler: () => void) => void;
+  onMessage: (handler: (event: {
+    data: string | ArrayBuffer;
+  }) => void) => void;
+  onClose: (handler: () => void) => void;
+  onError: (handler: () => void) => void;
+}
+interface SqliteDevtoolsWeappSocketApi {
+  connectSocket: (options: {
+    url: string;
+    success: () => void;
+    fail: () => void;
+  }) => SqliteDevtoolsWeappSocketTask;
+}
+/** 直接使用 SocketTask，不依赖浏览器全局变量或动态求值。 */
+export declare function createWeappSocketFactory(api: SqliteDevtoolsWeappSocketApi): SqliteDevtoolsSocketFactory;
+//#endregion
+//#region src/runtime.d.ts
+export interface ConnectSqliteDevtoolsRuntimeOptions {
+  readonly endpoint: string;
+  readonly token: string;
+  readonly runtime: SqliteDevtoolsRuntime;
+  readonly listDatabases: () => readonly string[];
+  readonly getController: (databaseName: string) => SqliteDebugController | Promise<SqliteDebugController>;
+  readonly createSocket: SqliteDevtoolsSocketFactory;
+  /** Releases debug-only resources without closing application database handles. */
+  readonly onDisconnect?: () => void | Promise<void>;
+  readonly reconnectDelayMs?: number;
+}
+export interface SqliteDevtoolsRuntimeConnection {
+  refresh: () => void;
+  close: () => void;
+}
+/** 只登记和转发当前运行时的数据库，断线后不重放任何数据库操作。 */
+export declare function connectSqliteDevtoolsRuntime(options: ConnectSqliteDevtoolsRuntimeOptions): SqliteDevtoolsRuntimeConnection;
+//#endregion
+export type { SqliteDevtoolsSocket, SqliteDevtoolsSocketFactory, SqliteDevtoolsSocketHandlers, SqliteDevtoolsWeappSocketApi, SqliteDevtoolsWeappSocketTask, SqliteDevtoolsWebSocket };