@gemigo/app-sdk 0.2.6 → 0.2.8

package/dist/gemigo-app-sdk.es.js

@@ -1,82 +1,82 @@
 import { i as tryGetHost, n as createRPCProxy, t as callHost } from "./connection-DwOg1Kh5.js";
 function createEventBus() {
-	let c = /* @__PURE__ */ new Map();
+	let f = /* @__PURE__ */ new Map();
 	return {
-		on(N, P) {
-			return c.has(N) || c.set(N, /* @__PURE__ */ new Set()), c.get(N).add(P), () => c.get(N)?.delete(P);
+		on(V, H) {
+			return f.has(V) || f.set(V, /* @__PURE__ */ new Set()), f.get(V).add(H), () => f.get(V)?.delete(H);
 		},
-		emit(N, ...P) {
-			c.get(N)?.forEach((c) => c(...P));
+		emit(V, ...H) {
+			f.get(V)?.forEach((f) => f(...H));
 		},
-		off(N) {
-			N ? c.delete(N) : c.clear();
+		off(V) {
+			V ? f.delete(V) : f.clear();
 		}
 	};
 }
 const sdkEventBus = createEventBus();
-function createUnifiedAPI(P) {
-	let F = tryGetHost, L = {}, R = {};
-	if (P.rpc) {
-		let c = createRPCProxy(P.rpc.methods, {
-			mapping: P.rpc.mapping,
-			fallbacks: P.rpc.fallbacks
+function createUnifiedAPI(H) {
+	let U = tryGetHost, G = {}, K = {};
+	if (H.rpc) {
+		let f = createRPCProxy(H.rpc.methods, {
+			mapping: H.rpc.mapping,
+			fallbacks: H.rpc.fallbacks
 		});
-		Object.assign(L, c);
+		Object.assign(G, f);
 	}
-	if (P.events) if (Array.isArray(P.events)) for (let c of P.events) {
-		let N = c;
-		L[c] = (c) => (F?.(), sdkEventBus.on(N, c)), R[c] = (...c) => {
-			sdkEventBus.emit(N, ...c);
+	if (H.events) if (Array.isArray(H.events)) for (let f of H.events) {
+		let V = f;
+		G[f] = (f) => (U?.(), sdkEventBus.on(V, f)), K[f] = (...f) => {
+			sdkEventBus.emit(V, ...f);
 		};
 	}
-	else for (let [c, N] of Object.entries(P.events)) {
-		if (!N) continue;
-		let P = N, z = typeof P == "string" ? P : P.event, B = typeof P == "object" && "childMethod" in P && P.childMethod ? P.childMethod : c;
-		L[c] = (c) => (F?.(), sdkEventBus.on(z, c)), R[B] = (...c) => {
-			sdkEventBus.emit(z, ...c);
+	else for (let [f, V] of Object.entries(H.events)) {
+		if (!V) continue;
+		let H = V, q = typeof H == "string" ? H : H.event, J = typeof H == "object" && "childMethod" in H && H.childMethod ? H.childMethod : f;
+		G[f] = (f) => (U?.(), sdkEventBus.on(q, f)), K[J] = (...f) => {
+			sdkEventBus.emit(q, ...f);
 		};
 	}
 	return {
-		api: L,
-		childMethods: R
+		api: G,
+		childMethods: K
 	};
 }
-function createRPCAction(c, N) {
-	return async (...F) => {
+function createRPCAction(f, V) {
+	return async (...U) => {
 		try {
-			let I = await callHost(c, N.transform ? N.transform(...F) : F);
-			return N.onSuccess ? N.onSuccess(I) : I;
+			let W = await callHost(f, V.transform ? V.transform(...U) : U);
+			return V.onSuccess ? V.onSuccess(W) : W;
 		} catch {
-			return N.fallback(...F);
+			return V.fallback(...U);
 		}
 	};
 }
-function createSDK(c) {
-	let N = c.statics ? { ...c.statics } : {}, P = {};
-	if (c.modules) for (let [F, I] of Object.entries(c.modules)) {
-		let { api: c, childMethods: R } = createUnifiedAPI(I);
-		N[F] = c, Object.assign(P, R);
+function createSDK(f) {
+	let V = f.statics ? { ...f.statics } : {}, H = {};
+	if (f.modules) for (let [U, W] of Object.entries(f.modules)) {
+		let { api: f, childMethods: K } = createUnifiedAPI(W);
+		V[U] = f, Object.assign(H, K);
 	}
-	if (c.actions) for (let [P, F] of Object.entries(c.actions)) {
-		let c = F;
-		N[P] = createRPCAction(c.method, c);
+	if (f.actions) for (let [H, U] of Object.entries(f.actions)) {
+		let f = U;
+		V[H] = createRPCAction(f.method, f);
 	}
-	if (c.getters) for (let [P, F] of Object.entries(c.getters)) Object.defineProperty(N, P, {
-		get: F,
+	if (f.getters) for (let [H, U] of Object.entries(f.getters)) Object.defineProperty(V, H, {
+		get: U,
 		enumerable: !0,
 		configurable: !0
 	});
 	return {
-		sdk: N,
-		childMethods: P
+		sdk: V,
+		childMethods: H
 	};
 }
-async function bootstrapSDK(N, P = {}) {
-	let { initConnection: F } = await import("./connection-C-IGR2wz.js");
-	F(N, P);
-	let I = await tryGetHost();
-	if (I && typeof I.getProtocolInfo == "function") try {
-		return await I.getProtocolInfo();
+async function bootstrapSDK(V, H = {}) {
+	let { initConnection: U } = await import("./connection-C-IGR2wz.js");
+	U(V, H);
+	let W = await tryGetHost();
+	if (W && typeof W.getProtocolInfo == "function") try {
+		return await W.getProtocolInfo();
 	} catch {
 		return null;
 	}
@@ -84,31 +84,31 @@ async function bootstrapSDK(N, P = {}) {
 }
 var localStoragePrefix = () => `gemigo:${typeof window > "u" ? "unknown" : window.location.origin.replace(/[:/]/g, "_")}:`;
 const fallbackStorage = {
-	get: async (c) => {
+	get: async (f) => {
 		if (typeof window > "u" || !window.localStorage) return null;
-		let N = window.localStorage.getItem(`${localStoragePrefix()}${c}`);
-		if (!N) return null;
+		let V = window.localStorage.getItem(`${localStoragePrefix()}${f}`);
+		if (!V) return null;
 		try {
-			return JSON.parse(N);
+			return JSON.parse(V);
 		} catch {
 			return null;
 		}
 	},
-	set: async (c, N) => {
-		typeof window > "u" || !window.localStorage || window.localStorage.setItem(`${localStoragePrefix()}${c}`, JSON.stringify(N));
+	set: async (f, V) => {
+		typeof window > "u" || !window.localStorage || window.localStorage.setItem(`${localStoragePrefix()}${f}`, JSON.stringify(V));
 	},
-	delete: async (c) => {
-		typeof window > "u" || !window.localStorage || window.localStorage.removeItem(`${localStoragePrefix()}${c}`);
+	delete: async (f) => {
+		typeof window > "u" || !window.localStorage || window.localStorage.removeItem(`${localStoragePrefix()}${f}`);
 	},
 	clear: async () => {
 		if (typeof window > "u" || !window.localStorage) return;
-		let c = localStoragePrefix();
-		for (let N = window.localStorage.length - 1; N >= 0; --N) {
-			let P = window.localStorage.key(N);
-			P && P.startsWith(c) && window.localStorage.removeItem(P);
+		let f = localStoragePrefix();
+		for (let V = window.localStorage.length - 1; V >= 0; --V) {
+			let H = window.localStorage.key(V);
+			H && H.startsWith(f) && window.localStorage.removeItem(H);
 		}
 	}
-}, fallbackNotify = async (c) => {
+}, fallbackNotify = async (f) => {
 	if (typeof window > "u" || typeof Notification > "u") return {
 		success: !1,
 		reason: "not_supported"
@@ -118,9 +118,9 @@ const fallbackStorage = {
 		reason: "permission_not_granted"
 	};
 	try {
-		return new Notification(c.title, {
-			body: c.message,
-			icon: c.icon
+		return new Notification(f.title, {
+			body: f.message,
+			icon: f.icon
 		}), { success: !0 };
 	} catch {
 		return {
@@ -128,114 +128,114 @@ const fallbackStorage = {
 			reason: "failed_to_notify"
 		};
 	}
-}, fallbackNetwork = { request: async (c, N) => {
-	let { method: P = "GET", headers: F, body: I, responseType: L } = N ?? {}, R = await fetch(c, {
-		method: P,
-		headers: F,
-		body: I ? typeof I == "string" ? I : JSON.stringify(I) : void 0
-	}), z = {};
-	R.headers.forEach((c, N) => z[N] = c);
-	let B = L === "text" ? await R.text() : L === "arraybuffer" ? await R.arrayBuffer() : await R.json();
+}, fallbackNetwork = { request: async (f, V) => {
+	let { method: H = "GET", headers: U, body: W, responseType: G } = V ?? {}, K = await fetch(f, {
+		method: H,
+		headers: U,
+		body: W ? typeof W == "string" ? W : JSON.stringify(W) : void 0
+	}), q = {};
+	K.headers.forEach((f, V) => q[V] = f);
+	let J = G === "text" ? await K.text() : G === "arraybuffer" ? await K.arrayBuffer() : await K.json();
 	return {
-		status: R.status,
-		data: B,
-		headers: z
+		status: K.status,
+		data: J,
+		headers: q
 	};
 } };
-var SDKError = class c extends Error {
-	constructor(N, P) {
-		super(P), this.code = N, this.name = "SDKError", Object.setPrototypeOf(this, c.prototype);
+var SDKError = class f extends Error {
+	constructor(V, H) {
+		super(H), this.code = V, this.name = "SDKError", Object.setPrototypeOf(this, f.prototype);
 	}
 }, currentToken = null, currentApiBaseUrl = null;
-function base64UrlEncode(c) {
-	let N = "";
-	for (let P of c) N += String.fromCharCode(P);
-	let P = globalThis.btoa;
-	if (!P) throw Error("base64 encoder not available");
-	return P(N).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
+function base64UrlEncode(f) {
+	let V = "";
+	for (let H of f) V += String.fromCharCode(H);
+	let H = globalThis.btoa;
+	if (!H) throw Error("base64 encoder not available");
+	return H(V).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
 }
-function randomString(c = 32) {
-	let N = new Uint8Array(c);
-	return crypto.getRandomValues(N), base64UrlEncode(N);
+function randomString(f = 32) {
+	let V = new Uint8Array(f);
+	return crypto.getRandomValues(V), base64UrlEncode(V);
 }
-async function sha256Base64Url(c) {
-	let N = new TextEncoder().encode(c), P = await crypto.subtle.digest("SHA-256", N);
-	return base64UrlEncode(new Uint8Array(P));
+async function sha256Base64Url(f) {
+	let V = new TextEncoder().encode(f), H = await crypto.subtle.digest("SHA-256", V);
+	return base64UrlEncode(new Uint8Array(H));
 }
 function deriveDefaultAppId() {
 	if (typeof window > "u") return "unknown";
-	let c = window.location.hostname.toLowerCase();
-	return c.endsWith(".gemigo.app") ? c.replace(/\.gemigo\.app$/, "") : c;
+	let f = window.location.hostname.toLowerCase();
+	return f.endsWith(".gemigo.app") ? f.replace(/\.gemigo\.app$/, "") : f;
 }
-function normalizeScopes(c) {
-	let N = (c ?? ["identity:basic"]).map((c) => String(c).trim()).filter(Boolean);
-	return N.length > 0 ? N : ["identity:basic"];
+function normalizeScopes(f) {
+	let V = (f ?? ["identity:basic"]).map((f) => String(f).trim()).filter(Boolean);
+	return V.length > 0 ? V : ["identity:basic"];
 }
-function buildBrokerUrl(c) {
-	let N = new URL("/sdk/broker", c.platformOrigin);
-	return N.searchParams.set("app_id", c.appId), N.searchParams.set("scope", c.scopes.join(" ")), N.searchParams.set("state", c.state), N.searchParams.set("code_challenge", c.codeChallenge), N.searchParams.set("code_challenge_method", "S256"), N.searchParams.set("origin", c.openerOrigin), N.toString();
+function buildBrokerUrl(f) {
+	let V = new URL("/sdk/broker", f.platformOrigin);
+	return V.searchParams.set("app_id", f.appId), V.searchParams.set("scope", f.scopes.join(" ")), V.searchParams.set("state", f.state), V.searchParams.set("code_challenge", f.codeChallenge), V.searchParams.set("code_challenge_method", "S256"), V.searchParams.set("origin", f.openerOrigin), V.toString();
 }
-async function exchangeCode(c, N, P) {
-	let F = await fetch(`${c.replace(/\/+$/, "")}/sdk/token`, {
+async function exchangeCode(f, V, H) {
+	let U = await fetch(`${f.replace(/\/+$/, "")}/sdk/token`, {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
-			code: N,
-			codeVerifier: P
+			code: V,
+			codeVerifier: H
 		})
 	});
-	if (!F.ok) {
-		let c = await F.json().catch(() => ({}));
-		throw Error(c.error || "Failed to exchange code");
+	if (!U.ok) {
+		let f = await U.json().catch(() => ({}));
+		throw Error(f.error || "Failed to exchange code");
 	}
-	return await F.json();
+	return await U.json();
 }
 function getWebApiBaseUrl() {
 	return currentApiBaseUrl || "https://gemigo.io/api/v1";
 }
 const webAuth = {
-	async login(c = {}) {
+	async login(f = {}) {
 		if (typeof window > "u") throw new SDKError("NOT_SUPPORTED", "auth.login is only supported in browser environments.");
-		let N = c.platformOrigin?.trim() || "https://gemigo.io", P = c.apiBaseUrl?.trim() || `${N.replace(/\/+$/, "")}/api/v1`, F = c.appId?.trim() || deriveDefaultAppId(), I = normalizeScopes(c.scopes), L = typeof c.timeoutMs == "number" ? c.timeoutMs : 120 * 1e3, R = randomString(16), z = randomString(48), B = window.location.origin, V = Math.max(0, (window.screen.width - 520) / 2), H = Math.max(0, (window.screen.height - 720) / 2), U = window.open("about:blank", "gemigo_sdk_auth", `popup=yes,width=520,height=720,left=${V},top=${H}`);
-		if (!U) throw Error("Popup blocked. Please allow popups and retry.");
+		let V = f.platformOrigin?.trim() || "https://gemigo.io", H = f.apiBaseUrl?.trim() || `${V.replace(/\/+$/, "")}/api/v1`, U = f.appId?.trim() || deriveDefaultAppId(), W = normalizeScopes(f.scopes), G = typeof f.timeoutMs == "number" ? f.timeoutMs : 120 * 1e3, K = randomString(16), q = randomString(48), J = window.location.origin, Y = Math.max(0, (window.screen.width - 520) / 2), X = Math.max(0, (window.screen.height - 720) / 2), Z = window.open("about:blank", "gemigo_sdk_auth", `popup=yes,width=520,height=720,left=${Y},top=${X}`);
+		if (!Z) throw Error("Popup blocked. Please allow popups and retry.");
 		try {
-			U.document.title = "GemiGo Auth", U.document.body.innerHTML = "<div style=\"font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;padding:24px;\">Loading…</div>";
+			Z.document.title = "GemiGo Auth", Z.document.body.innerHTML = "<div style=\"font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;padding:24px;\">Loading…</div>";
 		} catch {}
-		let W = buildBrokerUrl({
-			platformOrigin: N,
-			appId: F,
-			scopes: I,
-			state: R,
-			codeChallenge: await sha256Base64Url(z),
-			openerOrigin: B
+		let Q = buildBrokerUrl({
+			platformOrigin: V,
+			appId: U,
+			scopes: W,
+			state: K,
+			codeChallenge: await sha256Base64Url(q),
+			openerOrigin: J
 		});
 		try {
-			U.location.href = W;
+			Z.location.href = Q;
 		} catch {
-			if (!window.open(W, "gemigo_sdk_auth")) throw Error("Popup navigation failed. Please allow popups and retry.");
+			if (!window.open(Q, "gemigo_sdk_auth")) throw Error("Popup navigation failed. Please allow popups and retry.");
 		}
-		let G = await exchangeCode(P, (await new Promise((c, P) => {
-			let F = window.setTimeout(() => {
-				I(), P(/* @__PURE__ */ Error("Login timeout."));
-			}, L), I = () => {
-				window.clearTimeout(F), window.removeEventListener("message", z);
+		let $ = await exchangeCode(H, (await new Promise((f, H) => {
+			let U = window.setTimeout(() => {
+				W(), H(/* @__PURE__ */ Error("Login timeout."));
+			}, G), W = () => {
+				window.clearTimeout(U), window.removeEventListener("message", q);
 				try {
-					U.close();
+					Z.close();
 				} catch {}
-			}, z = (F) => {
-				if (F.origin !== new URL(N).origin) return;
-				let L = F.data;
-				if (!(!L || typeof L != "object") && L.state === R) {
-					if (L.type === "gemigo:sdk-auth-error") {
-						I(), P(Error(String(L.error || "auth_error")));
+			}, q = (U) => {
+				if (U.origin !== new URL(V).origin) return;
+				let G = U.data;
+				if (!(!G || typeof G != "object") && G.state === K) {
+					if (G.type === "gemigo:sdk-auth-error") {
+						W(), H(Error(String(G.error || "auth_error")));
 						return;
 					}
-					L.type === "gemigo:sdk-auth-code" && typeof L.code == "string" && (I(), c({ code: L.code }));
+					G.type === "gemigo:sdk-auth-code" && typeof G.code == "string" && (W(), f({ code: G.code }));
 				}
 			};
-			window.addEventListener("message", z);
-		})).code, z);
-		return currentToken = G, currentApiBaseUrl = P, G;
+			window.addEventListener("message", q);
+		})).code, q);
+		return currentToken = $, currentApiBaseUrl = H, $;
 	},
 	getAccessToken() {
 		return currentToken?.accessToken ?? null;
@@ -245,96 +245,96 @@ const webAuth = {
 	}
 };
 function requireAccessToken() {
-	let c = webAuth.getAccessToken();
-	if (!c) throw new SDKError("PERMISSION_DENIED", "Login required. Call gemigo.auth.login() first.");
-	return c;
+	let f = webAuth.getAccessToken();
+	if (!f) throw new SDKError("PERMISSION_DENIED", "Login required. Call gemigo.auth.login() first.");
+	return f;
 }
-async function fetchJson(c, N = {}) {
-	let P = requireAccessToken(), F = getWebApiBaseUrl().replace(/\/+$/, ""), I = await fetch(`${F}${c}`, {
-		...N,
+async function fetchJson(f, V = {}) {
+	let H = requireAccessToken(), U = getWebApiBaseUrl().replace(/\/+$/, ""), W = await fetch(`${U}${f}`, {
+		...V,
 		headers: {
-			...N.headers ?? {},
-			Authorization: `Bearer ${P}`
+			...V.headers ?? {},
+			Authorization: `Bearer ${H}`
 		}
 	});
-	if (!I.ok) {
-		let c = (await I.json().catch(() => ({}))).error || `Request failed: ${I.status}`;
-		throw I.status === 401 || I.status === 403 ? new SDKError("PERMISSION_DENIED", c) : new SDKError("INTERNAL_ERROR", c);
+	if (!W.ok) {
+		let f = (await W.json().catch(() => ({}))).error || `Request failed: ${W.status}`;
+		throw W.status === 401 || W.status === 403 ? new SDKError("PERMISSION_DENIED", f) : new SDKError("INTERNAL_ERROR", f);
 	}
-	return await I.json();
+	return await W.json();
 }
 var WebCloudKv = class {
-	async get(c) {
-		return fetchJson(`/cloud/kv/get?key=${encodeURIComponent(c)}`);
+	async get(f) {
+		return fetchJson(`/cloud/kv/get?key=${encodeURIComponent(f)}`);
 	}
-	async set(c, N, P) {
+	async set(f, V, H) {
 		return fetchJson("/cloud/kv/set", {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify({
-				key: c,
-				value: N,
-				ifMatch: P?.ifMatch
+				key: f,
+				value: V,
+				ifMatch: H?.ifMatch
 			})
 		});
 	}
-	async delete(c, N) {
+	async delete(f, V) {
 		await fetchJson("/cloud/kv/delete", {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify({
-				key: c,
-				ifMatch: N?.ifMatch
+				key: f,
+				ifMatch: V?.ifMatch
 			})
 		});
 	}
-	async list(c) {
-		let N = new URLSearchParams();
-		c?.prefix && N.set("prefix", c.prefix), typeof c?.limit == "number" && N.set("limit", String(c.limit)), c?.cursor && N.set("cursor", c.cursor);
-		let P = N.toString();
-		return fetchJson(`/cloud/kv/list${P ? `?${P}` : ""}`);
+	async list(f) {
+		let V = new URLSearchParams();
+		f?.prefix && V.set("prefix", f.prefix), typeof f?.limit == "number" && V.set("limit", String(f.limit)), f?.cursor && V.set("cursor", f.cursor);
+		let H = V.toString();
+		return fetchJson(`/cloud/kv/list${H ? `?${H}` : ""}`);
 	}
-}, WebCloudDbQueryBuilder = class c {
-	constructor(c, N) {
-		this.collectionName = c, this.state = {
-			where: N?.where ?? [],
-			orderBy: N?.orderBy ?? {
+}, WebCloudDbQueryBuilder = class f {
+	constructor(f, V) {
+		this.collectionName = f, this.state = {
+			where: V?.where ?? [],
+			orderBy: V?.orderBy ?? {
 				field: "createdAt",
 				direction: "desc"
 			},
-			limit: N?.limit ?? 20,
-			cursor: N?.cursor ?? null
+			limit: V?.limit ?? 20,
+			cursor: V?.cursor ?? null
 		};
 	}
-	where(N, P, F) {
-		return new c(this.collectionName, {
+	where(V, H, U) {
+		return new f(this.collectionName, {
 			...this.state,
 			where: [...this.state.where, {
-				field: N,
-				op: P,
-				value: F
+				field: V,
+				op: H,
+				value: U
 			}]
 		});
 	}
-	orderBy(N, P = "desc") {
-		return new c(this.collectionName, {
+	orderBy(V, H = "desc") {
+		return new f(this.collectionName, {
 			...this.state,
 			orderBy: {
-				field: N,
-				direction: P
+				field: V,
+				direction: H
 			}
 		});
 	}
-	limit(N) {
-		return new c(this.collectionName, {
+	limit(V) {
+		return new f(this.collectionName, {
 			...this.state,
-			limit: N
+			limit: V
 		});
 	}
-	startAfter(N) {
-		return new c(this.collectionName, {
+	startAfter(V) {
+		return new f(this.collectionName, {
 			...this.state,
-			cursor: N
+			cursor: V
 		});
 	}
 	async get() {
@@ -350,59 +350,372 @@ var WebCloudKv = class {
 		});
 	}
 }, WebCloudDbCollection = class {
-	constructor(c) {
-		this.name = c;
+	constructor(f) {
+		this.name = f;
 	}
-	async add(c, N) {
+	async add(f, V) {
 		return fetchJson(`/cloud/db/collections/${encodeURIComponent(this.name)}/docs`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify({
-				id: N?.id,
-				visibility: N?.visibility,
-				refType: N?.refType,
-				refId: N?.refId,
-				data: c
+				id: V?.id,
+				data: f
 			})
 		});
 	}
-	doc(c) {
-		let N = this.name;
+	doc(f) {
+		let V = this.name;
 		return {
-			get: async () => fetchJson(`/cloud/db/collections/${encodeURIComponent(N)}/docs/${encodeURIComponent(c)}`),
-			update: async (P, F) => fetchJson(`/cloud/db/collections/${encodeURIComponent(N)}/docs/${encodeURIComponent(c)}`, {
+			get: async () => fetchJson(`/cloud/db/collections/${encodeURIComponent(V)}/docs/${encodeURIComponent(f)}`),
+			set: async (H, U) => fetchJson(`/cloud/db/collections/${encodeURIComponent(V)}/docs/${encodeURIComponent(f)}`, {
+				method: "PUT",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({
+					data: H,
+					ifMatch: U?.ifMatch
+				})
+			}),
+			update: async (H, U) => fetchJson(`/cloud/db/collections/${encodeURIComponent(V)}/docs/${encodeURIComponent(f)}`, {
 				method: "PATCH",
 				headers: { "Content-Type": "application/json" },
 				body: JSON.stringify({
-					patch: P,
-					ifMatch: F?.ifMatch
+					patch: H,
+					ifMatch: U?.ifMatch
 				})
 			}),
-			delete: async () => fetchJson(`/cloud/db/collections/${encodeURIComponent(N)}/docs/${encodeURIComponent(c)}`, { method: "DELETE" }).then(() => void 0)
+			delete: async () => fetchJson(`/cloud/db/collections/${encodeURIComponent(V)}/docs/${encodeURIComponent(f)}`, { method: "DELETE" }).then(() => void 0)
 		};
 	}
 	query() {
 		return new WebCloudDbQueryBuilder(this.name);
 	}
 };
+function toWxDoc(f) {
+	return {
+		...f.data && typeof f.data == "object" && !Array.isArray(f.data) ? f.data : {},
+		_id: f.id,
+		_openid: f.ownerId
+	};
+}
+function isWxInternalSentinel(f) {
+	if (!f || typeof f != "object" || Array.isArray(f)) return !1;
+	let V = f;
+	return typeof V.__gemigoWxCmd == "string" || V.__gemigoWxType === "serverDate";
+}
+function assertNoWxSystemFields(f, V) {
+	if (!f || typeof f != "object") return;
+	if (Array.isArray(f)) {
+		for (let H of f) assertNoWxSystemFields(H, V);
+		return;
+	}
+	if (isWxInternalSentinel(f)) return;
+	let H = f;
+	for (let [f, U] of Object.entries(H)) {
+		if (f.startsWith("_") && !(V.allowId && f === "_id")) throw new SDKError("PERMISSION_DENIED", `Cannot write system field ${f}`);
+		assertNoWxSystemFields(U, V);
+	}
+}
+function createWxCommand() {
+	return {
+		eq: (f) => ({
+			__gemigoWxCmd: "eq",
+			value: f
+		}),
+		neq: (f) => ({
+			__gemigoWxCmd: "neq",
+			value: f
+		}),
+		gt: (f) => ({
+			__gemigoWxCmd: "gt",
+			value: f
+		}),
+		gte: (f) => ({
+			__gemigoWxCmd: "gte",
+			value: f
+		}),
+		lt: (f) => ({
+			__gemigoWxCmd: "lt",
+			value: f
+		}),
+		lte: (f) => ({
+			__gemigoWxCmd: "lte",
+			value: f
+		}),
+		in: (f) => ({
+			__gemigoWxCmd: "in",
+			value: Array.isArray(f) ? f : []
+		}),
+		nin: (f) => ({
+			__gemigoWxCmd: "nin",
+			value: Array.isArray(f) ? f : []
+		}),
+		inc: (f) => ({
+			__gemigoWxCmd: "inc",
+			value: f
+		}),
+		set: (f) => ({
+			__gemigoWxCmd: "set",
+			value: f
+		}),
+		remove: () => ({ __gemigoWxCmd: "remove" })
+	};
+}
+function createWxServerDate(f) {
+	let V = typeof f?.offset == "number" && Number.isFinite(f.offset) ? f.offset : void 0;
+	return V === void 0 ? { __gemigoWxType: "serverDate" } : {
+		__gemigoWxType: "serverDate",
+		offset: V
+	};
+}
+function normalizeWxDirection(f) {
+	return f === "asc" ? "asc" : "desc";
+}
+async function wxQueryPage(f, V, H, U) {
+	return fetchJson(`/cloud/db/collections/${encodeURIComponent(f)}/query`, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify({
+			where: V.where,
+			orderBy: V.orderBy,
+			limit: U,
+			cursor: H
+		})
+	});
+}
+function createWxQuery(f, V, H) {
+	let U = {
+		where: H?.where ?? {},
+		orderBy: H?.orderBy ?? {
+			field: "createdAt",
+			direction: "desc"
+		},
+		limit: H?.limit ?? 20,
+		skip: H?.skip ?? 0,
+		cursor: H?.cursor ?? null
+	};
+	return {
+		where(H) {
+			return createWxQuery(f, V, {
+				...U,
+				where: {
+					...U.where,
+					...H ?? {}
+				}
+			});
+		},
+		orderBy(H, W) {
+			return createWxQuery(f, V, {
+				...U,
+				orderBy: {
+					field: String(H),
+					direction: normalizeWxDirection(W)
+				}
+			});
+		},
+		limit(H) {
+			return createWxQuery(f, V, {
+				...U,
+				limit: Math.max(1, Math.floor(Number(H) || 0))
+			});
+		},
+		skip(H) {
+			return createWxQuery(f, V, {
+				...U,
+				skip: Math.max(0, Math.floor(Number(H) || 0))
+			});
+		},
+		startAfter(H) {
+			let W = String(H ?? "").trim();
+			if (!W) throw new SDKError("INTERNAL_ERROR", "startAfter(cursor) requires a non-empty cursor");
+			return createWxQuery(f, V, {
+				...U,
+				cursor: W
+			});
+		},
+		async count() {
+			return fetchJson(`/cloud/db/collections/${encodeURIComponent(f)}/count`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ where: U.where })
+			});
+		},
+		async update(V) {
+			let H = V?.data;
+			if (!H || typeof H != "object" || Array.isArray(H)) throw new SDKError("INTERNAL_ERROR", "update({data}) must be an object");
+			if ("_openid" in H) throw new SDKError("PERMISSION_DENIED", "Cannot write system field _openid");
+			return fetchJson(`/cloud/db/collections/${encodeURIComponent(f)}/update`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({
+					where: U.where,
+					data: H
+				})
+			});
+		},
+		async remove() {
+			return fetchJson(`/cloud/db/collections/${encodeURIComponent(f)}/remove`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ where: U.where })
+			});
+		},
+		async get() {
+			let V = Math.min(U.limit, 100), H = U.skip;
+			if (H > 1e3) throw new SDKError("NOT_SUPPORTED", "skip(n) is capped at 1000; use cursor pagination instead.");
+			let W = U.cursor ?? null, G = H, K = V, q = [], J = 0;
+			for (; (G > 0 || K > 0) && J < 30;) {
+				let V = await wxQueryPage(f, U, W, Math.min(100, G > 0 ? G : K));
+				if (J += 1, V.items.length === 0) break;
+				if (G > 0) {
+					let f = Math.min(G, V.items.length);
+					G -= f;
+					let H = V.items.slice(f);
+					if (G === 0 && K > 0 && H.length > 0) {
+						let f = Math.min(K, H.length);
+						q.push(...H.slice(0, f).map(toWxDoc)), K -= f;
+					}
+				} else q.push(...V.items.slice(0, K).map(toWxDoc)), K = Math.max(0, K - V.items.length);
+				if (W = V.nextCursor, !W) break;
+			}
+			if (J >= 30) throw new SDKError("NOT_SUPPORTED", "skip/limit query requires too many requests; narrow your query.");
+			return {
+				data: q,
+				_meta: { nextCursor: W }
+			};
+		}
+	};
+}
+function createWxDatabase() {
+	let f = createWxCommand();
+	return {
+		command: f,
+		serverDate: (f) => createWxServerDate(f),
+		collection(V) {
+			let H = String(V).trim();
+			if (!H) throw new SDKError("INTERNAL_ERROR", "collection name is required");
+			let U = createWxQuery(H, f);
+			return {
+				...U,
+				add: async (f) => {
+					let V = f?.data;
+					assertNoWxSystemFields(V, { allowId: !0 });
+					let U = V && typeof V == "object" && !Array.isArray(V) ? V._id : void 0, W = V && typeof V == "object" && !Array.isArray(V) ? { ...V } : V;
+					return W && typeof W == "object" && !Array.isArray(W) && delete W._id, { _id: (await webCloud.db.collection(H).add(W, { id: U ? String(U) : void 0 })).id };
+				},
+				doc: (f) => {
+					let V = webCloud.db.collection(H).doc(String(f));
+					return {
+						get: async () => ({ data: toWxDoc(await V.get()) }),
+						set: async (f) => {
+							let H = f?.data;
+							assertNoWxSystemFields(H, { allowId: !1 }), await V.set(f?.data);
+						},
+						update: async (f) => {
+							let H = f?.data ?? {};
+							if (!H || typeof H != "object" || Array.isArray(H)) throw new SDKError("INTERNAL_ERROR", "update({data}) must be an object");
+							assertNoWxSystemFields(H, { allowId: !1 }), await V.update(H);
+						},
+						remove: async () => (await V.delete(), { stats: { removed: 1 } })
+					};
+				},
+				get: async () => U.get()
+			};
+		}
+	};
+}
 const webCloud = {
 	kv: new WebCloudKv(),
-	db: { collection(c) {
-		let N = String(c).trim();
-		if (!N) throw new SDKError("INTERNAL_ERROR", "collection name is required");
-		return new WebCloudDbCollection(N);
+	db: { collection(f) {
+		let V = String(f).trim();
+		if (!V) throw new SDKError("INTERNAL_ERROR", "collection name is required");
+		return new WebCloudDbCollection(V);
 	} },
 	blob: {
-		async createUploadUrl() {
-			throw new SDKError("NOT_SUPPORTED", "cloud.blob is not implemented yet.");
+		async createUploadUrl(f) {
+			return fetchJson("/cloud/blob/upload-url", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({
+					path: f.path,
+					visibility: f.visibility,
+					contentType: f.contentType,
+					expiresIn: f.expiresIn
+				})
+			});
 		},
-		async getDownloadUrl() {
-			throw new SDKError("NOT_SUPPORTED", "cloud.blob is not implemented yet.");
+		async getDownloadUrl(f) {
+			return fetchJson("/cloud/blob/download-url", {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({
+					fileId: f.fileId,
+					expiresIn: f.expiresIn
+				})
+			});
 		}
 	},
-	functions: { async call() {
-		throw new SDKError("NOT_SUPPORTED", "cloud.functions is not implemented yet.");
-	} }
+	functions: { async call(f, V) {
+		return (await fetchJson("/cloud/functions/call", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				name: f,
+				data: V ?? null
+			})
+		})).data;
+	} },
+	init(f) {},
+	database() {
+		return createWxDatabase();
+	},
+	async callFunction(f) {
+		let V = String(f?.name ?? "").trim();
+		if (!V) throw new SDKError("INTERNAL_ERROR", "callFunction name is required");
+		return { result: await webCloud.functions.call(V, f?.data) };
+	},
+	async uploadFile(f) {
+		let V = String(f?.cloudPath ?? "").trim().replace(/^\/+/, "");
+		if (!V) throw new SDKError("INTERNAL_ERROR", "cloudPath is required");
+		let H = f?.filePath;
+		if (!H) throw new SDKError("INTERNAL_ERROR", "filePath is required");
+		let U = H.type ? String(H.type) : void 0, { fileId: W, uploadUrl: G } = await webCloud.blob.createUploadUrl({
+			path: V,
+			visibility: "private",
+			contentType: U
+		});
+		return await fetch(G, {
+			method: "PUT",
+			headers: U ? { "Content-Type": U } : void 0,
+			body: H
+		}), { fileID: W };
+	},
+	async getTempFileURL(f) {
+		let V = Array.isArray(f?.fileList) ? f.fileList : [];
+		return { fileList: await Promise.all(V.map(async (f) => {
+			let V = typeof f == "string" ? f : String(f?.fileID ?? "");
+			if (!V) return {
+				fileID: "",
+				tempFileURL: "",
+				status: 400,
+				errMsg: "fileID is required"
+			};
+			try {
+				let { url: f } = await webCloud.blob.getDownloadUrl({ fileId: V });
+				return {
+					fileID: V,
+					tempFileURL: f,
+					status: 0
+				};
+			} catch (f) {
+				return {
+					fileID: V,
+					tempFileURL: "",
+					status: 500,
+					errMsg: f instanceof Error ? f.message : String(f)
+				};
+			}
+		})) };
+	}
 };
 var hostInfo = null, defaultCapabilities = {
 	storage: !0,
@@ -421,12 +734,12 @@ var hostInfo = null, defaultCapabilities = {
 		capture: !1
 	}
 };
-const updateHostInfo = (c) => {
-	hostInfo = c;
+const updateHostInfo = (f) => {
+	hostInfo = f;
 };
-var throwNotSupported = (c) => {
-	throw new SDKError("NOT_SUPPORTED", `${c} is not supported in this environment.`);
-}, stubAsync = (c) => async () => throwNotSupported(c), stubHandler = (c) => () => throwNotSupported(c), aiAPI = {
+var throwNotSupported = (f) => {
+	throw new SDKError("NOT_SUPPORTED", `${f} is not supported in this environment.`);
+}, stubAsync = (f) => async () => throwNotSupported(f), stubHandler = (f) => () => throwNotSupported(f), aiAPI = {
 	chat: stubAsync("ai.chat"),
 	summarize: stubAsync("ai.summarize"),
 	translate: stubAsync("ai.translate")
@@ -525,8 +838,8 @@ const { sdk, childMethods } = createSDK({
 		onFileDrop
 	}
 });
-bootstrapSDK(childMethods, { timeoutMs: 1500 }).then((c) => {
-	c && updateHostInfo(c);
+bootstrapSDK(childMethods, { timeoutMs: 1500 }).then((f) => {
+	f && updateHostInfo(f);
 }), sdk.SDKError = SDKError;
 var src_default = sdk;
 export { src_default as default };

package/dist/gemigo-app-sdk.umd.js

@@ -1 +1 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?module.exports=t():typeof define==`function`&&define.amd?define([],t):(e=typeof globalThis<`u`?globalThis:e||self,e.gemigo=t())})(this,function(){var e=Object.defineProperty,t=(e,t)=>()=>(e&&(t=e(e=0)),t),n=t=>{let n={};for(var r in t)e(n,r,{get:t[r],enumerable:!0});return n},r,i,a,o,s,c=t((()=>{(function(e){e.Call=`call`,e.Reply=`reply`,e.Syn=`syn`,e.SynAck=`synAck`,e.Ack=`ack`})(r||={}),(function(e){e.Fulfilled=`fulfilled`,e.Rejected=`rejected`})(i||={}),(function(e){e.ConnectionDestroyed=`ConnectionDestroyed`,e.ConnectionTimeout=`ConnectionTimeout`,e.NoIframeSrc=`NoIframeSrc`})(a||={}),(function(e){e.DataCloneError=`DataCloneError`})(o||={}),(function(e){e.Message=`message`})(s||={})})),l,u=t((()=>{l=(e,t)=>{let n=[],r=!1;return{destroy(i){r||(r=!0,t(`${e}: Destroying connection`),n.forEach(e=>{e(i)}))},onDestroy(e){r?e():n.push(e)}}}})),d,f=t((()=>{d=e=>(...t)=>{e&&console.log(`[Penpal]`,...t)}})),p,m,h=t((()=>{p=({name:e,message:t,stack:n})=>({name:e,message:t,stack:n}),m=e=>{let t=Error();return Object.keys(e).forEach(n=>t[n]=e[n]),t}})),g,_=t((()=>{h(),c(),g=(e,t,n)=>{let{localName:a,local:c,remote:l,originForSending:u,originForReceiving:d}=e,f=!1,m=e=>{if(e.source!==l||e.data.penpal!==r.Call)return;if(d!==`*`&&e.origin!==d){n(`${a} received message from origin ${e.origin} which did not match expected origin ${d}`);return}let{methodName:s,args:c,id:m}=e.data;n(`${a}: Received ${s}() call`);let h=e=>t=>{if(n(`${a}: Sending ${s}() reply`),f){n(`${a}: Unable to send ${s}() reply due to destroyed connection`);return}let c={penpal:r.Reply,id:m,resolution:e,returnValue:t};e===i.Rejected&&t instanceof Error&&(c.returnValue=p(t),c.returnValueIsError=!0);try{l.postMessage(c,u)}catch(e){if(e.name===o.DataCloneError){let t={penpal:r.Reply,id:m,resolution:i.Rejected,returnValue:p(e),returnValueIsError:!0};l.postMessage(t,u)}throw e}};new Promise(e=>e(t[s].apply(t,c))).then(h(i.Fulfilled),h(i.Rejected))};return c.addEventListener(s.Message,m),()=>{f=!0,c.removeEventListener(s.Message,m)}}})),v,ee,te=t((()=>{v=0,ee=()=>++v})),y,b,ne,x,S,C,w,T=t((()=>{y=`.`,b=e=>e?e.split(y):[],ne=e=>e.join(y),x=(e,t)=>{let n=b(t||``);return n.push(e),ne(n)},S=(e,t,n)=>{let r=b(t);return r.reduce((e,t,i)=>(e[t]===void 0&&(e[t]={}),i===r.length-1&&(e[t]=n),e[t]),e),e},C=(e,t)=>{let n={};return Object.keys(e).forEach(r=>{let i=e[r],a=x(r,t);typeof i==`object`&&Object.assign(n,C(i,a)),typeof i==`function`&&(n[a]=i)}),n},w=e=>{let t={};for(let n in e)S(t,n,e[n]);return t}})),E,D=t((()=>{te(),h(),T(),c(),E=(e,t,n,o,c)=>{let{localName:l,local:u,remote:d,originForSending:f,originForReceiving:p}=t,h=!1;c(`${l}: Connecting call sender`);let g=e=>(...t)=>{c(`${l}: Sending ${e}() call`);let n;try{d.closed&&(n=!0)}catch{n=!0}if(n&&o(),h){let t=Error(`Unable to send ${e}() call due to destroyed connection`);throw t.code=a.ConnectionDestroyed,t}return new Promise((n,a)=>{let o=ee(),h=t=>{if(t.source!==d||t.data.penpal!==r.Reply||t.data.id!==o)return;if(p!==`*`&&t.origin!==p){c(`${l} received message from origin ${t.origin} which did not match expected origin ${p}`);return}let f=t.data;c(`${l}: Received ${e}() reply`),u.removeEventListener(s.Message,h);let g=f.returnValue;f.returnValueIsError&&(g=m(g)),(f.resolution===i.Fulfilled?n:a)(g)};u.addEventListener(s.Message,h);let g={penpal:r.Call,id:o,methodName:e,args:t};d.postMessage(g,f)})},_=n.reduce((e,t)=>(e[t]=g(t),e),{});return Object.assign(e,w(_)),()=>{h=!0}}})),re=t((()=>{_(),D()})),ie=t((()=>{c()})),O,k=t((()=>{c(),O=(e,t)=>{let n;return e!==void 0&&(n=window.setTimeout(()=>{let n=Error(`Connection timed out after ${e}ms`);n.code=a.ConnectionTimeout,t(n)},e)),()=>{clearTimeout(n)}}})),ae=t((()=>{c()})),oe=t((()=>{c(),re(),ie(),k(),ae()})),A,se=t((()=>{c(),_(),D(),A=(e,t,n,i)=>{let{destroy:a,onDestroy:o}=n;return n=>{if(!(e instanceof RegExp?e.test(n.origin):e===`*`||e===n.origin)){i(`Child: Handshake - Received SYN-ACK from origin ${n.origin} which did not match expected origin ${e}`);return}i(`Child: Handshake - Received SYN-ACK, responding with ACK`);let s=n.origin===`null`?`*`:n.origin,c={penpal:r.Ack,methodNames:Object.keys(t)};window.parent.postMessage(c,s);let l={localName:`Child`,local:window,remote:window.parent,originForSending:s,originForReceiving:n.origin};o(g(l,t,i));let u={};return o(E(u,l,n.data.methodNames,a,i)),u}}})),j,M,ce=t((()=>{u(),f(),c(),se(),T(),k(),j=()=>{try{clearTimeout()}catch{return!1}return!0},M=(e={})=>{let{parentOrigin:t=`*`,methods:n={},timeout:i,debug:a=!1}=e,o=d(a),c=l(`Child`,o),{destroy:u,onDestroy:f}=c,p=A(t,C(n),c,o),m=()=>{o(`Child: Handshake - Sending SYN`);let e={penpal:r.Syn},n=t instanceof RegExp?`*`:t;window.parent.postMessage(e,n)};return{promise:new Promise((e,t)=>{let n=O(i,u),a=t=>{if(j()&&!(t.source!==parent||!t.data)&&t.data.penpal===r.SynAck){let r=p(t);r&&(window.removeEventListener(s.Message,a),n(),e(r))}};window.addEventListener(s.Message,a),m(),f(e=>{window.removeEventListener(s.Message,a),e&&t(e)})}),destroy(){u()}}}})),le=t((()=>{oe(),ce(),c()})),ue=n({callHost:()=>P,createRPCProxy:()=>ge,getHost:()=>fe,hasConnectionFailed:()=>me,initConnection:()=>he,isConnected:()=>pe,tryGetHost:()=>N,withFallback:()=>_e});function de(){try{return window.self!==window.top}catch{return!0}}async function N(e,t){if(I)return I;if(L)return null;if(!de())return L=!0,null;if(!F){let n={},r=e??R;r&&Object.assign(n,r),F=M({methods:n,timeout:t?.timeoutMs??z}).promise.then(e=>(I=e,e)).catch(e=>(console.error(`[GemiGo Connection] Promise failed:`,e),L=!0,F=null,null))}return F}async function fe(){let e=await N();if(!e)throw Error(`Not connected to host. SDK may be running outside of a supported environment.`);return e}function pe(){return I!==null}function me(){return L}function he(e,t){R=e,N(e,t)}async function P(e,t=[],n){let r=await N();if(r&&typeof r[e]==`function`){let i=await r[e](...t);if(i?.success!==!1)return i?.data===void 0?i?.value===void 0?i:i.value:i.data;if(n)return n(...t);throw Error(i?.error||`Host method ${String(e)} failed`)}if(n)return n(...t);throw Error(`Method ${String(e)} not supported in this environment`)}function ge(e,t={}){let n={};for(let r of e){let e=t.mapping?.[r]||r,i=t.fallbacks?.[r];n[r]=(...t)=>P(e,t,i)}return n}function _e(e,t){return async(...n)=>{try{return await e(...n)}catch{return t(...n)}}}var F,I,L,R,z,B=t((()=>{le(),F=null,I=null,L=!1,z=1500}));B();function ve(){let e=new Map;return{on(t,n){return e.has(t)||e.set(t,new Set),e.get(t).add(n),()=>e.get(t)?.delete(n)},emit(t,...n){e.get(t)?.forEach(e=>e(...n))},off(t){t?e.delete(t):e.clear()}}}let V=ve();function ye(e){let t=N,n={},r={};if(e.rpc){let t=ge(e.rpc.methods,{mapping:e.rpc.mapping,fallbacks:e.rpc.fallbacks});Object.assign(n,t)}if(e.events)if(Array.isArray(e.events))for(let i of e.events){let e=i;n[i]=n=>(t?.(),V.on(e,n)),r[i]=(...t)=>{V.emit(e,...t)}}else for(let[i,a]of Object.entries(e.events)){if(!a)continue;let e=a,o=typeof e==`string`?e:e.event,s=typeof e==`object`&&`childMethod`in e&&e.childMethod?e.childMethod:i;n[i]=e=>(t?.(),V.on(o,e)),r[s]=(...e)=>{V.emit(o,...e)}}return{api:n,childMethods:r}}function be(e,t){return async(...n)=>{try{let r=await P(e,t.transform?t.transform(...n):n);return t.onSuccess?t.onSuccess(r):r}catch{return t.fallback(...n)}}}function xe(e){let t=e.statics?{...e.statics}:{},n={};if(e.modules)for(let[r,i]of Object.entries(e.modules)){let{api:e,childMethods:a}=ye(i);t[r]=e,Object.assign(n,a)}if(e.actions)for(let[n,r]of Object.entries(e.actions)){let e=r;t[n]=be(e.method,e)}if(e.getters)for(let[n,r]of Object.entries(e.getters))Object.defineProperty(t,n,{get:r,enumerable:!0,configurable:!0});return{sdk:t,childMethods:n}}async function Se(e,t={}){let{initConnection:n}=await Promise.resolve().then(()=>(B(),ue));n(e,t);let r=await N();if(r&&typeof r.getProtocolInfo==`function`)try{return await r.getProtocolInfo()}catch{return null}return null}B();var H=()=>`gemigo:${typeof window>`u`?`unknown`:window.location.origin.replace(/[:/]/g,`_`)}:`;let U={get:async e=>{if(typeof window>`u`||!window.localStorage)return null;let t=window.localStorage.getItem(`${H()}${e}`);if(!t)return null;try{return JSON.parse(t)}catch{return null}},set:async(e,t)=>{typeof window>`u`||!window.localStorage||window.localStorage.setItem(`${H()}${e}`,JSON.stringify(t))},delete:async e=>{typeof window>`u`||!window.localStorage||window.localStorage.removeItem(`${H()}${e}`)},clear:async()=>{if(typeof window>`u`||!window.localStorage)return;let e=H();for(let t=window.localStorage.length-1;t>=0;--t){let n=window.localStorage.key(t);n&&n.startsWith(e)&&window.localStorage.removeItem(n)}}},Ce=async e=>{if(typeof window>`u`||typeof Notification>`u`)return{success:!1,reason:`not_supported`};if(Notification.permission!==`granted`)return{success:!1,reason:`permission_not_granted`};try{return new Notification(e.title,{body:e.message,icon:e.icon}),{success:!0}}catch{return{success:!1,reason:`failed_to_notify`}}},we={request:async(e,t)=>{let{method:n=`GET`,headers:r,body:i,responseType:a}=t??{},o=await fetch(e,{method:n,headers:r,body:i?typeof i==`string`?i:JSON.stringify(i):void 0}),s={};o.headers.forEach((e,t)=>s[t]=e);let c=a===`text`?await o.text():a===`arraybuffer`?await o.arrayBuffer():await o.json();return{status:o.status,data:c,headers:s}}};var W=class e extends Error{constructor(t,n){super(n),this.code=t,this.name=`SDKError`,Object.setPrototypeOf(this,e.prototype)}},G=null,K=null;function q(e){let t=``;for(let n of e)t+=String.fromCharCode(n);let n=globalThis.btoa;if(!n)throw Error(`base64 encoder not available`);return n(t).replace(/\+/g,`-`).replace(/\//g,`_`).replace(/=+$/g,``)}function J(e=32){let t=new Uint8Array(e);return crypto.getRandomValues(t),q(t)}async function Te(e){let t=new TextEncoder().encode(e),n=await crypto.subtle.digest(`SHA-256`,t);return q(new Uint8Array(n))}function Ee(){if(typeof window>`u`)return`unknown`;let e=window.location.hostname.toLowerCase();return e.endsWith(`.gemigo.app`)?e.replace(/\.gemigo\.app$/,``):e}function De(e){let t=(e??[`identity:basic`]).map(e=>String(e).trim()).filter(Boolean);return t.length>0?t:[`identity:basic`]}function Oe(e){let t=new URL(`/sdk/broker`,e.platformOrigin);return t.searchParams.set(`app_id`,e.appId),t.searchParams.set(`scope`,e.scopes.join(` `)),t.searchParams.set(`state`,e.state),t.searchParams.set(`code_challenge`,e.codeChallenge),t.searchParams.set(`code_challenge_method`,`S256`),t.searchParams.set(`origin`,e.openerOrigin),t.toString()}async function ke(e,t,n){let r=await fetch(`${e.replace(/\/+$/,``)}/sdk/token`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({code:t,codeVerifier:n})});if(!r.ok){let e=await r.json().catch(()=>({}));throw Error(e.error||`Failed to exchange code`)}return await r.json()}function Ae(){return K||`https://gemigo.io/api/v1`}let Y={async login(e={}){if(typeof window>`u`)throw new W(`NOT_SUPPORTED`,`auth.login is only supported in browser environments.`);let t=e.platformOrigin?.trim()||`https://gemigo.io`,n=e.apiBaseUrl?.trim()||`${t.replace(/\/+$/,``)}/api/v1`,r=e.appId?.trim()||Ee(),i=De(e.scopes),a=typeof e.timeoutMs==`number`?e.timeoutMs:120*1e3,o=J(16),s=J(48),c=window.location.origin,l=Math.max(0,(window.screen.width-520)/2),u=Math.max(0,(window.screen.height-720)/2),d=window.open(`about:blank`,`gemigo_sdk_auth`,`popup=yes,width=520,height=720,left=${l},top=${u}`);if(!d)throw Error(`Popup blocked. Please allow popups and retry.`);try{d.document.title=`GemiGo Auth`,d.document.body.innerHTML=`<div style="font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;padding:24px;">Loading…</div>`}catch{}let f=Oe({platformOrigin:t,appId:r,scopes:i,state:o,codeChallenge:await Te(s),openerOrigin:c});try{d.location.href=f}catch{if(!window.open(f,`gemigo_sdk_auth`))throw Error(`Popup navigation failed. Please allow popups and retry.`)}let p=await ke(n,(await new Promise((e,n)=>{let r=window.setTimeout(()=>{i(),n(Error(`Login timeout.`))},a),i=()=>{window.clearTimeout(r),window.removeEventListener(`message`,s);try{d.close()}catch{}},s=r=>{if(r.origin!==new URL(t).origin)return;let a=r.data;if(!(!a||typeof a!=`object`)&&a.state===o){if(a.type===`gemigo:sdk-auth-error`){i(),n(Error(String(a.error||`auth_error`)));return}a.type===`gemigo:sdk-auth-code`&&typeof a.code==`string`&&(i(),e({code:a.code}))}};window.addEventListener(`message`,s)})).code,s);return G=p,K=n,p},getAccessToken(){return G?.accessToken??null},logout(){G=null}};function je(){let e=Y.getAccessToken();if(!e)throw new W(`PERMISSION_DENIED`,`Login required. Call gemigo.auth.login() first.`);return e}async function X(e,t={}){let n=je(),r=Ae().replace(/\/+$/,``),i=await fetch(`${r}${e}`,{...t,headers:{...t.headers??{},Authorization:`Bearer ${n}`}});if(!i.ok){let e=(await i.json().catch(()=>({}))).error||`Request failed: ${i.status}`;throw i.status===401||i.status===403?new W(`PERMISSION_DENIED`,e):new W(`INTERNAL_ERROR`,e)}return await i.json()}var Me=class{async get(e){return X(`/cloud/kv/get?key=${encodeURIComponent(e)}`)}async set(e,t,n){return X(`/cloud/kv/set`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({key:e,value:t,ifMatch:n?.ifMatch})})}async delete(e,t){await X(`/cloud/kv/delete`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({key:e,ifMatch:t?.ifMatch})})}async list(e){let t=new URLSearchParams;e?.prefix&&t.set(`prefix`,e.prefix),typeof e?.limit==`number`&&t.set(`limit`,String(e.limit)),e?.cursor&&t.set(`cursor`,e.cursor);let n=t.toString();return X(`/cloud/kv/list${n?`?${n}`:``}`)}},Ne=class e{constructor(e,t){this.collectionName=e,this.state={where:t?.where??[],orderBy:t?.orderBy??{field:`createdAt`,direction:`desc`},limit:t?.limit??20,cursor:t?.cursor??null}}where(t,n,r){return new e(this.collectionName,{...this.state,where:[...this.state.where,{field:t,op:n,value:r}]})}orderBy(t,n=`desc`){return new e(this.collectionName,{...this.state,orderBy:{field:t,direction:n}})}limit(t){return new e(this.collectionName,{...this.state,limit:t})}startAfter(t){return new e(this.collectionName,{...this.state,cursor:t})}async get(){return X(`/cloud/db/collections/${encodeURIComponent(this.collectionName)}/query`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({where:this.state.where,orderBy:this.state.orderBy,limit:this.state.limit,cursor:this.state.cursor})})}},Pe=class{constructor(e){this.name=e}async add(e,t){return X(`/cloud/db/collections/${encodeURIComponent(this.name)}/docs`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({id:t?.id,visibility:t?.visibility,refType:t?.refType,refId:t?.refId,data:e})})}doc(e){let t=this.name;return{get:async()=>X(`/cloud/db/collections/${encodeURIComponent(t)}/docs/${encodeURIComponent(e)}`),update:async(n,r)=>X(`/cloud/db/collections/${encodeURIComponent(t)}/docs/${encodeURIComponent(e)}`,{method:`PATCH`,headers:{"Content-Type":`application/json`},body:JSON.stringify({patch:n,ifMatch:r?.ifMatch})}),delete:async()=>X(`/cloud/db/collections/${encodeURIComponent(t)}/docs/${encodeURIComponent(e)}`,{method:`DELETE`}).then(()=>void 0)}}query(){return new Ne(this.name)}};let Fe={kv:new Me,db:{collection(e){let t=String(e).trim();if(!t)throw new W(`INTERNAL_ERROR`,`collection name is required`);return new Pe(t)}},blob:{async createUploadUrl(){throw new W(`NOT_SUPPORTED`,`cloud.blob is not implemented yet.`)},async getDownloadUrl(){throw new W(`NOT_SUPPORTED`,`cloud.blob is not implemented yet.`)}},functions:{async call(){throw new W(`NOT_SUPPORTED`,`cloud.functions is not implemented yet.`)}}};var Z=null,Ie={storage:!0,network:!1,scheduler:!1,fileWatch:!1,fileWrite:!1,notification:!0,clipboard:!1,ai:!1,shell:!1,extension:{read:!1,events:!1,modify:!1,capture:!1}};let Le=e=>{Z=e};var Re=e=>{throw new W(`NOT_SUPPORTED`,`${e} is not supported in this environment.`)},Q=e=>async()=>Re(e),$=e=>()=>Re(e),ze={chat:Q(`ai.chat`),summarize:Q(`ai.summarize`),translate:Q(`ai.translate`)},Be={readText:Q(`clipboard.readText`),writeText:Q(`clipboard.writeText`),readImage:Q(`clipboard.readImage`),writeImage:Q(`clipboard.writeImage`),onChange:$(`clipboard.onChange`)},Ve={openFile:Q(`dialog.openFile`),openDirectory:Q(`dialog.openDirectory`),saveFile:Q(`dialog.saveFile`),message:Q(`dialog.message`)},He={readText:Q(`file.readText`),readBinary:Q(`file.readBinary`),write:Q(`file.write`),append:Q(`file.append`),exists:Q(`file.exists`),stat:Q(`file.stat`),copy:Q(`file.copy`),move:Q(`file.move`),remove:Q(`file.remove`),list:Q(`file.list`),mkdir:Q(`file.mkdir`),persistPermission:Q(`file.persistPermission`)},Ue=$(`onNotificationAction`),We=$(`onFileDrop`);let{sdk:Ge,childMethods:Ke}=xe({getters:{platform:()=>Z?.platform??`web`,capabilities:()=>Z?.capabilities??Ie},modules:{storage:{rpc:{methods:[`get`,`set`,`delete`,`clear`],mapping:{get:`storageGet`,set:`storageSet`,delete:`storageDelete`,clear:`storageClear`},fallbacks:{get:U.get,set:U.set,delete:U.delete,clear:U.clear}}},network:{rpc:{methods:[`request`],mapping:{request:`networkRequest`},fallbacks:{request:we.request}}},extension:{rpc:{methods:[`getPageInfo`,`getPageHTML`,`getPageText`,`getSelection`,`extractArticle`,`extractLinks`,`extractImages`,`queryElement`,`highlight`,`removeHighlight`,`insertWidget`,`updateWidget`,`removeWidget`,`injectCSS`,`removeCSS`,`captureVisible`,`getContextMenuEvent`]},events:[`onContextMenu`,`onSelectionChange`]}},actions:{notify:{method:`notify`,fallback:Ce}},statics:{SDKError:W,auth:Y,cloud:Fe,ai:ze,clipboard:Be,dialog:Ve,file:He,onNotificationAction:Ue,onFileDrop:We}});return Se(Ke,{timeoutMs:1500}).then(e=>{e&&Le(e)}),Ge.SDKError=W,Ge});
+(function(e,t){typeof exports==`object`&&typeof module<`u`?module.exports=t():typeof define==`function`&&define.amd?define([],t):(e=typeof globalThis<`u`?globalThis:e||self,e.gemigo=t())})(this,function(){var e=Object.defineProperty,t=(e,t)=>()=>(e&&(t=e(e=0)),t),n=t=>{let n={};for(var r in t)e(n,r,{get:t[r],enumerable:!0});return n},r,i,a,o,s,c=t((()=>{(function(e){e.Call=`call`,e.Reply=`reply`,e.Syn=`syn`,e.SynAck=`synAck`,e.Ack=`ack`})(r||={}),(function(e){e.Fulfilled=`fulfilled`,e.Rejected=`rejected`})(i||={}),(function(e){e.ConnectionDestroyed=`ConnectionDestroyed`,e.ConnectionTimeout=`ConnectionTimeout`,e.NoIframeSrc=`NoIframeSrc`})(a||={}),(function(e){e.DataCloneError=`DataCloneError`})(o||={}),(function(e){e.Message=`message`})(s||={})})),l,u=t((()=>{l=(e,t)=>{let n=[],r=!1;return{destroy(i){r||(r=!0,t(`${e}: Destroying connection`),n.forEach(e=>{e(i)}))},onDestroy(e){r?e():n.push(e)}}}})),d,f=t((()=>{d=e=>(...t)=>{e&&console.log(`[Penpal]`,...t)}})),p,m,h=t((()=>{p=({name:e,message:t,stack:n})=>({name:e,message:t,stack:n}),m=e=>{let t=Error();return Object.keys(e).forEach(n=>t[n]=e[n]),t}})),g,_=t((()=>{h(),c(),g=(e,t,n)=>{let{localName:a,local:c,remote:l,originForSending:u,originForReceiving:d}=e,f=!1,m=e=>{if(e.source!==l||e.data.penpal!==r.Call)return;if(d!==`*`&&e.origin!==d){n(`${a} received message from origin ${e.origin} which did not match expected origin ${d}`);return}let{methodName:s,args:c,id:m}=e.data;n(`${a}: Received ${s}() call`);let h=e=>t=>{if(n(`${a}: Sending ${s}() reply`),f){n(`${a}: Unable to send ${s}() reply due to destroyed connection`);return}let c={penpal:r.Reply,id:m,resolution:e,returnValue:t};e===i.Rejected&&t instanceof Error&&(c.returnValue=p(t),c.returnValueIsError=!0);try{l.postMessage(c,u)}catch(e){if(e.name===o.DataCloneError){let t={penpal:r.Reply,id:m,resolution:i.Rejected,returnValue:p(e),returnValueIsError:!0};l.postMessage(t,u)}throw e}};new Promise(e=>e(t[s].apply(t,c))).then(h(i.Fulfilled),h(i.Rejected))};return c.addEventListener(s.Message,m),()=>{f=!0,c.removeEventListener(s.Message,m)}}})),ee,te,ne=t((()=>{ee=0,te=()=>++ee})),v,y,re,ie,ae,b,x,S=t((()=>{v=`.`,y=e=>e?e.split(v):[],re=e=>e.join(v),ie=(e,t)=>{let n=y(t||``);return n.push(e),re(n)},ae=(e,t,n)=>{let r=y(t);return r.reduce((e,t,i)=>(e[t]===void 0&&(e[t]={}),i===r.length-1&&(e[t]=n),e[t]),e),e},b=(e,t)=>{let n={};return Object.keys(e).forEach(r=>{let i=e[r],a=ie(r,t);typeof i==`object`&&Object.assign(n,b(i,a)),typeof i==`function`&&(n[a]=i)}),n},x=e=>{let t={};for(let n in e)ae(t,n,e[n]);return t}})),C,w=t((()=>{ne(),h(),S(),c(),C=(e,t,n,o,c)=>{let{localName:l,local:u,remote:d,originForSending:f,originForReceiving:p}=t,h=!1;c(`${l}: Connecting call sender`);let g=e=>(...t)=>{c(`${l}: Sending ${e}() call`);let n;try{d.closed&&(n=!0)}catch{n=!0}if(n&&o(),h){let t=Error(`Unable to send ${e}() call due to destroyed connection`);throw t.code=a.ConnectionDestroyed,t}return new Promise((n,a)=>{let o=te(),h=t=>{if(t.source!==d||t.data.penpal!==r.Reply||t.data.id!==o)return;if(p!==`*`&&t.origin!==p){c(`${l} received message from origin ${t.origin} which did not match expected origin ${p}`);return}let f=t.data;c(`${l}: Received ${e}() reply`),u.removeEventListener(s.Message,h);let g=f.returnValue;f.returnValueIsError&&(g=m(g)),(f.resolution===i.Fulfilled?n:a)(g)};u.addEventListener(s.Message,h);let g={penpal:r.Call,id:o,methodName:e,args:t};d.postMessage(g,f)})},_=n.reduce((e,t)=>(e[t]=g(t),e),{});return Object.assign(e,x(_)),()=>{h=!0}}})),oe=t((()=>{_(),w()})),se=t((()=>{c()})),T,E=t((()=>{c(),T=(e,t)=>{let n;return e!==void 0&&(n=window.setTimeout(()=>{let n=Error(`Connection timed out after ${e}ms`);n.code=a.ConnectionTimeout,t(n)},e)),()=>{clearTimeout(n)}}})),ce=t((()=>{c()})),le=t((()=>{c(),oe(),se(),E(),ce()})),D,ue=t((()=>{c(),_(),w(),D=(e,t,n,i)=>{let{destroy:a,onDestroy:o}=n;return n=>{if(!(e instanceof RegExp?e.test(n.origin):e===`*`||e===n.origin)){i(`Child: Handshake - Received SYN-ACK from origin ${n.origin} which did not match expected origin ${e}`);return}i(`Child: Handshake - Received SYN-ACK, responding with ACK`);let s=n.origin===`null`?`*`:n.origin,c={penpal:r.Ack,methodNames:Object.keys(t)};window.parent.postMessage(c,s);let l={localName:`Child`,local:window,remote:window.parent,originForSending:s,originForReceiving:n.origin};o(g(l,t,i));let u={};return o(C(u,l,n.data.methodNames,a,i)),u}}})),O,k,de=t((()=>{u(),f(),c(),ue(),S(),E(),O=()=>{try{clearTimeout()}catch{return!1}return!0},k=(e={})=>{let{parentOrigin:t=`*`,methods:n={},timeout:i,debug:a=!1}=e,o=d(a),c=l(`Child`,o),{destroy:u,onDestroy:f}=c,p=D(t,b(n),c,o),m=()=>{o(`Child: Handshake - Sending SYN`);let e={penpal:r.Syn},n=t instanceof RegExp?`*`:t;window.parent.postMessage(e,n)};return{promise:new Promise((e,t)=>{let n=T(i,u),a=t=>{if(O()&&!(t.source!==parent||!t.data)&&t.data.penpal===r.SynAck){let r=p(t);r&&(window.removeEventListener(s.Message,a),n(),e(r))}};window.addEventListener(s.Message,a),m(),f(e=>{window.removeEventListener(s.Message,a),e&&t(e)})}),destroy(){u()}}}})),fe=t((()=>{le(),de(),c()})),pe=n({callHost:()=>j,createRPCProxy:()=>ye,getHost:()=>he,hasConnectionFailed:()=>_e,initConnection:()=>ve,isConnected:()=>ge,tryGetHost:()=>A,withFallback:()=>be});function me(){try{return window.self!==window.top}catch{return!0}}async function A(e,t){if(N)return N;if(P)return null;if(!me())return P=!0,null;if(!M){let n={},r=e??xe;r&&Object.assign(n,r),M=k({methods:n,timeout:t?.timeoutMs??F}).promise.then(e=>(N=e,e)).catch(e=>(console.error(`[GemiGo Connection] Promise failed:`,e),P=!0,M=null,null))}return M}async function he(){let e=await A();if(!e)throw Error(`Not connected to host. SDK may be running outside of a supported environment.`);return e}function ge(){return N!==null}function _e(){return P}function ve(e,t){xe=e,A(e,t)}async function j(e,t=[],n){let r=await A();if(r&&typeof r[e]==`function`){let i=await r[e](...t);if(i?.success!==!1)return i?.data===void 0?i?.value===void 0?i:i.value:i.data;if(n)return n(...t);throw Error(i?.error||`Host method ${String(e)} failed`)}if(n)return n(...t);throw Error(`Method ${String(e)} not supported in this environment`)}function ye(e,t={}){let n={};for(let r of e){let e=t.mapping?.[r]||r,i=t.fallbacks?.[r];n[r]=(...t)=>j(e,t,i)}return n}function be(e,t){return async(...n)=>{try{return await e(...n)}catch{return t(...n)}}}var M,N,P,xe,F,I=t((()=>{fe(),M=null,N=null,P=!1,F=1500}));I();function Se(){let e=new Map;return{on(t,n){return e.has(t)||e.set(t,new Set),e.get(t).add(n),()=>e.get(t)?.delete(n)},emit(t,...n){e.get(t)?.forEach(e=>e(...n))},off(t){t?e.delete(t):e.clear()}}}let L=Se();function Ce(e){let t=A,n={},r={};if(e.rpc){let t=ye(e.rpc.methods,{mapping:e.rpc.mapping,fallbacks:e.rpc.fallbacks});Object.assign(n,t)}if(e.events)if(Array.isArray(e.events))for(let i of e.events){let e=i;n[i]=n=>(t?.(),L.on(e,n)),r[i]=(...t)=>{L.emit(e,...t)}}else for(let[i,a]of Object.entries(e.events)){if(!a)continue;let e=a,o=typeof e==`string`?e:e.event,s=typeof e==`object`&&`childMethod`in e&&e.childMethod?e.childMethod:i;n[i]=e=>(t?.(),L.on(o,e)),r[s]=(...e)=>{L.emit(o,...e)}}return{api:n,childMethods:r}}function we(e,t){return async(...n)=>{try{let r=await j(e,t.transform?t.transform(...n):n);return t.onSuccess?t.onSuccess(r):r}catch{return t.fallback(...n)}}}function Te(e){let t=e.statics?{...e.statics}:{},n={};if(e.modules)for(let[r,i]of Object.entries(e.modules)){let{api:e,childMethods:a}=Ce(i);t[r]=e,Object.assign(n,a)}if(e.actions)for(let[n,r]of Object.entries(e.actions)){let e=r;t[n]=we(e.method,e)}if(e.getters)for(let[n,r]of Object.entries(e.getters))Object.defineProperty(t,n,{get:r,enumerable:!0,configurable:!0});return{sdk:t,childMethods:n}}async function Ee(e,t={}){let{initConnection:n}=await Promise.resolve().then(()=>(I(),pe));n(e,t);let r=await A();if(r&&typeof r.getProtocolInfo==`function`)try{return await r.getProtocolInfo()}catch{return null}return null}I();var R=()=>`gemigo:${typeof window>`u`?`unknown`:window.location.origin.replace(/[:/]/g,`_`)}:`;let z={get:async e=>{if(typeof window>`u`||!window.localStorage)return null;let t=window.localStorage.getItem(`${R()}${e}`);if(!t)return null;try{return JSON.parse(t)}catch{return null}},set:async(e,t)=>{typeof window>`u`||!window.localStorage||window.localStorage.setItem(`${R()}${e}`,JSON.stringify(t))},delete:async e=>{typeof window>`u`||!window.localStorage||window.localStorage.removeItem(`${R()}${e}`)},clear:async()=>{if(typeof window>`u`||!window.localStorage)return;let e=R();for(let t=window.localStorage.length-1;t>=0;--t){let n=window.localStorage.key(t);n&&n.startsWith(e)&&window.localStorage.removeItem(n)}}},De=async e=>{if(typeof window>`u`||typeof Notification>`u`)return{success:!1,reason:`not_supported`};if(Notification.permission!==`granted`)return{success:!1,reason:`permission_not_granted`};try{return new Notification(e.title,{body:e.message,icon:e.icon}),{success:!0}}catch{return{success:!1,reason:`failed_to_notify`}}},Oe={request:async(e,t)=>{let{method:n=`GET`,headers:r,body:i,responseType:a}=t??{},o=await fetch(e,{method:n,headers:r,body:i?typeof i==`string`?i:JSON.stringify(i):void 0}),s={};o.headers.forEach((e,t)=>s[t]=e);let c=a===`text`?await o.text():a===`arraybuffer`?await o.arrayBuffer():await o.json();return{status:o.status,data:c,headers:s}}};var B=class e extends Error{constructor(t,n){super(n),this.code=t,this.name=`SDKError`,Object.setPrototypeOf(this,e.prototype)}},V=null,H=null;function U(e){let t=``;for(let n of e)t+=String.fromCharCode(n);let n=globalThis.btoa;if(!n)throw Error(`base64 encoder not available`);return n(t).replace(/\+/g,`-`).replace(/\//g,`_`).replace(/=+$/g,``)}function W(e=32){let t=new Uint8Array(e);return crypto.getRandomValues(t),U(t)}async function ke(e){let t=new TextEncoder().encode(e),n=await crypto.subtle.digest(`SHA-256`,t);return U(new Uint8Array(n))}function Ae(){if(typeof window>`u`)return`unknown`;let e=window.location.hostname.toLowerCase();return e.endsWith(`.gemigo.app`)?e.replace(/\.gemigo\.app$/,``):e}function je(e){let t=(e??[`identity:basic`]).map(e=>String(e).trim()).filter(Boolean);return t.length>0?t:[`identity:basic`]}function Me(e){let t=new URL(`/sdk/broker`,e.platformOrigin);return t.searchParams.set(`app_id`,e.appId),t.searchParams.set(`scope`,e.scopes.join(` `)),t.searchParams.set(`state`,e.state),t.searchParams.set(`code_challenge`,e.codeChallenge),t.searchParams.set(`code_challenge_method`,`S256`),t.searchParams.set(`origin`,e.openerOrigin),t.toString()}async function Ne(e,t,n){let r=await fetch(`${e.replace(/\/+$/,``)}/sdk/token`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({code:t,codeVerifier:n})});if(!r.ok){let e=await r.json().catch(()=>({}));throw Error(e.error||`Failed to exchange code`)}return await r.json()}function Pe(){return H||`https://gemigo.io/api/v1`}let G={async login(e={}){if(typeof window>`u`)throw new B(`NOT_SUPPORTED`,`auth.login is only supported in browser environments.`);let t=e.platformOrigin?.trim()||`https://gemigo.io`,n=e.apiBaseUrl?.trim()||`${t.replace(/\/+$/,``)}/api/v1`,r=e.appId?.trim()||Ae(),i=je(e.scopes),a=typeof e.timeoutMs==`number`?e.timeoutMs:120*1e3,o=W(16),s=W(48),c=window.location.origin,l=Math.max(0,(window.screen.width-520)/2),u=Math.max(0,(window.screen.height-720)/2),d=window.open(`about:blank`,`gemigo_sdk_auth`,`popup=yes,width=520,height=720,left=${l},top=${u}`);if(!d)throw Error(`Popup blocked. Please allow popups and retry.`);try{d.document.title=`GemiGo Auth`,d.document.body.innerHTML=`<div style="font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;padding:24px;">Loading…</div>`}catch{}let f=Me({platformOrigin:t,appId:r,scopes:i,state:o,codeChallenge:await ke(s),openerOrigin:c});try{d.location.href=f}catch{if(!window.open(f,`gemigo_sdk_auth`))throw Error(`Popup navigation failed. Please allow popups and retry.`)}let p=await Ne(n,(await new Promise((e,n)=>{let r=window.setTimeout(()=>{i(),n(Error(`Login timeout.`))},a),i=()=>{window.clearTimeout(r),window.removeEventListener(`message`,s);try{d.close()}catch{}},s=r=>{if(r.origin!==new URL(t).origin)return;let a=r.data;if(!(!a||typeof a!=`object`)&&a.state===o){if(a.type===`gemigo:sdk-auth-error`){i(),n(Error(String(a.error||`auth_error`)));return}a.type===`gemigo:sdk-auth-code`&&typeof a.code==`string`&&(i(),e({code:a.code}))}};window.addEventListener(`message`,s)})).code,s);return V=p,H=n,p},getAccessToken(){return V?.accessToken??null},logout(){V=null}};function Fe(){let e=G.getAccessToken();if(!e)throw new B(`PERMISSION_DENIED`,`Login required. Call gemigo.auth.login() first.`);return e}async function K(e,t={}){let n=Fe(),r=Pe().replace(/\/+$/,``),i=await fetch(`${r}${e}`,{...t,headers:{...t.headers??{},Authorization:`Bearer ${n}`}});if(!i.ok){let e=(await i.json().catch(()=>({}))).error||`Request failed: ${i.status}`;throw i.status===401||i.status===403?new B(`PERMISSION_DENIED`,e):new B(`INTERNAL_ERROR`,e)}return await i.json()}var Ie=class{async get(e){return K(`/cloud/kv/get?key=${encodeURIComponent(e)}`)}async set(e,t,n){return K(`/cloud/kv/set`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({key:e,value:t,ifMatch:n?.ifMatch})})}async delete(e,t){await K(`/cloud/kv/delete`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({key:e,ifMatch:t?.ifMatch})})}async list(e){let t=new URLSearchParams;e?.prefix&&t.set(`prefix`,e.prefix),typeof e?.limit==`number`&&t.set(`limit`,String(e.limit)),e?.cursor&&t.set(`cursor`,e.cursor);let n=t.toString();return K(`/cloud/kv/list${n?`?${n}`:``}`)}},Le=class e{constructor(e,t){this.collectionName=e,this.state={where:t?.where??[],orderBy:t?.orderBy??{field:`createdAt`,direction:`desc`},limit:t?.limit??20,cursor:t?.cursor??null}}where(t,n,r){return new e(this.collectionName,{...this.state,where:[...this.state.where,{field:t,op:n,value:r}]})}orderBy(t,n=`desc`){return new e(this.collectionName,{...this.state,orderBy:{field:t,direction:n}})}limit(t){return new e(this.collectionName,{...this.state,limit:t})}startAfter(t){return new e(this.collectionName,{...this.state,cursor:t})}async get(){return K(`/cloud/db/collections/${encodeURIComponent(this.collectionName)}/query`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({where:this.state.where,orderBy:this.state.orderBy,limit:this.state.limit,cursor:this.state.cursor})})}},Re=class{constructor(e){this.name=e}async add(e,t){return K(`/cloud/db/collections/${encodeURIComponent(this.name)}/docs`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({id:t?.id,data:e})})}doc(e){let t=this.name;return{get:async()=>K(`/cloud/db/collections/${encodeURIComponent(t)}/docs/${encodeURIComponent(e)}`),set:async(n,r)=>K(`/cloud/db/collections/${encodeURIComponent(t)}/docs/${encodeURIComponent(e)}`,{method:`PUT`,headers:{"Content-Type":`application/json`},body:JSON.stringify({data:n,ifMatch:r?.ifMatch})}),update:async(n,r)=>K(`/cloud/db/collections/${encodeURIComponent(t)}/docs/${encodeURIComponent(e)}`,{method:`PATCH`,headers:{"Content-Type":`application/json`},body:JSON.stringify({patch:n,ifMatch:r?.ifMatch})}),delete:async()=>K(`/cloud/db/collections/${encodeURIComponent(t)}/docs/${encodeURIComponent(e)}`,{method:`DELETE`}).then(()=>void 0)}}query(){return new Le(this.name)}};function q(e){return{...e.data&&typeof e.data==`object`&&!Array.isArray(e.data)?e.data:{},_id:e.id,_openid:e.ownerId}}function ze(e){if(!e||typeof e!=`object`||Array.isArray(e))return!1;let t=e;return typeof t.__gemigoWxCmd==`string`||t.__gemigoWxType===`serverDate`}function J(e,t){if(!e||typeof e!=`object`)return;if(Array.isArray(e)){for(let n of e)J(n,t);return}if(ze(e))return;let n=e;for(let[e,r]of Object.entries(n)){if(e.startsWith(`_`)&&!(t.allowId&&e===`_id`))throw new B(`PERMISSION_DENIED`,`Cannot write system field ${e}`);J(r,t)}}function Be(){return{eq:e=>({__gemigoWxCmd:`eq`,value:e}),neq:e=>({__gemigoWxCmd:`neq`,value:e}),gt:e=>({__gemigoWxCmd:`gt`,value:e}),gte:e=>({__gemigoWxCmd:`gte`,value:e}),lt:e=>({__gemigoWxCmd:`lt`,value:e}),lte:e=>({__gemigoWxCmd:`lte`,value:e}),in:e=>({__gemigoWxCmd:`in`,value:Array.isArray(e)?e:[]}),nin:e=>({__gemigoWxCmd:`nin`,value:Array.isArray(e)?e:[]}),inc:e=>({__gemigoWxCmd:`inc`,value:e}),set:e=>({__gemigoWxCmd:`set`,value:e}),remove:()=>({__gemigoWxCmd:`remove`})}}function Ve(e){let t=typeof e?.offset==`number`&&Number.isFinite(e.offset)?e.offset:void 0;return t===void 0?{__gemigoWxType:`serverDate`}:{__gemigoWxType:`serverDate`,offset:t}}function He(e){return e===`asc`?`asc`:`desc`}async function Ue(e,t,n,r){return K(`/cloud/db/collections/${encodeURIComponent(e)}/query`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({where:t.where,orderBy:t.orderBy,limit:r,cursor:n})})}function Y(e,t,n){let r={where:n?.where??{},orderBy:n?.orderBy??{field:`createdAt`,direction:`desc`},limit:n?.limit??20,skip:n?.skip??0,cursor:n?.cursor??null};return{where(n){return Y(e,t,{...r,where:{...r.where,...n??{}}})},orderBy(n,i){return Y(e,t,{...r,orderBy:{field:String(n),direction:He(i)}})},limit(n){return Y(e,t,{...r,limit:Math.max(1,Math.floor(Number(n)||0))})},skip(n){return Y(e,t,{...r,skip:Math.max(0,Math.floor(Number(n)||0))})},startAfter(n){let i=String(n??``).trim();if(!i)throw new B(`INTERNAL_ERROR`,`startAfter(cursor) requires a non-empty cursor`);return Y(e,t,{...r,cursor:i})},async count(){return K(`/cloud/db/collections/${encodeURIComponent(e)}/count`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({where:r.where})})},async update(t){let n=t?.data;if(!n||typeof n!=`object`||Array.isArray(n))throw new B(`INTERNAL_ERROR`,`update({data}) must be an object`);if(`_openid`in n)throw new B(`PERMISSION_DENIED`,`Cannot write system field _openid`);return K(`/cloud/db/collections/${encodeURIComponent(e)}/update`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({where:r.where,data:n})})},async remove(){return K(`/cloud/db/collections/${encodeURIComponent(e)}/remove`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({where:r.where})})},async get(){let t=Math.min(r.limit,100),n=r.skip;if(n>1e3)throw new B(`NOT_SUPPORTED`,`skip(n) is capped at 1000; use cursor pagination instead.`);let i=r.cursor??null,a=n,o=t,s=[],c=0;for(;(a>0||o>0)&&c<30;){let t=await Ue(e,r,i,Math.min(100,a>0?a:o));if(c+=1,t.items.length===0)break;if(a>0){let e=Math.min(a,t.items.length);a-=e;let n=t.items.slice(e);if(a===0&&o>0&&n.length>0){let e=Math.min(o,n.length);s.push(...n.slice(0,e).map(q)),o-=e}}else s.push(...t.items.slice(0,o).map(q)),o=Math.max(0,o-t.items.length);if(i=t.nextCursor,!i)break}if(c>=30)throw new B(`NOT_SUPPORTED`,`skip/limit query requires too many requests; narrow your query.`);return{data:s,_meta:{nextCursor:i}}}}}function We(){let e=Be();return{command:e,serverDate:e=>Ve(e),collection(t){let n=String(t).trim();if(!n)throw new B(`INTERNAL_ERROR`,`collection name is required`);let r=Y(n,e);return{...r,add:async e=>{let t=e?.data;J(t,{allowId:!0});let r=t&&typeof t==`object`&&!Array.isArray(t)?t._id:void 0,i=t&&typeof t==`object`&&!Array.isArray(t)?{...t}:t;return i&&typeof i==`object`&&!Array.isArray(i)&&delete i._id,{_id:(await X.db.collection(n).add(i,{id:r?String(r):void 0})).id}},doc:e=>{let t=X.db.collection(n).doc(String(e));return{get:async()=>({data:q(await t.get())}),set:async e=>{let n=e?.data;J(n,{allowId:!1}),await t.set(e?.data)},update:async e=>{let n=e?.data??{};if(!n||typeof n!=`object`||Array.isArray(n))throw new B(`INTERNAL_ERROR`,`update({data}) must be an object`);J(n,{allowId:!1}),await t.update(n)},remove:async()=>(await t.delete(),{stats:{removed:1}})}},get:async()=>r.get()}}}}let X={kv:new Ie,db:{collection(e){let t=String(e).trim();if(!t)throw new B(`INTERNAL_ERROR`,`collection name is required`);return new Re(t)}},blob:{async createUploadUrl(e){return K(`/cloud/blob/upload-url`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({path:e.path,visibility:e.visibility,contentType:e.contentType,expiresIn:e.expiresIn})})},async getDownloadUrl(e){return K(`/cloud/blob/download-url`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({fileId:e.fileId,expiresIn:e.expiresIn})})}},functions:{async call(e,t){return(await K(`/cloud/functions/call`,{method:`POST`,headers:{"Content-Type":`application/json`},body:JSON.stringify({name:e,data:t??null})})).data}},init(e){},database(){return We()},async callFunction(e){let t=String(e?.name??``).trim();if(!t)throw new B(`INTERNAL_ERROR`,`callFunction name is required`);return{result:await X.functions.call(t,e?.data)}},async uploadFile(e){let t=String(e?.cloudPath??``).trim().replace(/^\/+/,``);if(!t)throw new B(`INTERNAL_ERROR`,`cloudPath is required`);let n=e?.filePath;if(!n)throw new B(`INTERNAL_ERROR`,`filePath is required`);let r=n.type?String(n.type):void 0,{fileId:i,uploadUrl:a}=await X.blob.createUploadUrl({path:t,visibility:`private`,contentType:r});return await fetch(a,{method:`PUT`,headers:r?{"Content-Type":r}:void 0,body:n}),{fileID:i}},async getTempFileURL(e){let t=Array.isArray(e?.fileList)?e.fileList:[];return{fileList:await Promise.all(t.map(async e=>{let t=typeof e==`string`?e:String(e?.fileID??``);if(!t)return{fileID:``,tempFileURL:``,status:400,errMsg:`fileID is required`};try{let{url:e}=await X.blob.getDownloadUrl({fileId:t});return{fileID:t,tempFileURL:e,status:0}}catch(e){return{fileID:t,tempFileURL:``,status:500,errMsg:e instanceof Error?e.message:String(e)}}}))}}};var Z=null,Ge={storage:!0,network:!1,scheduler:!1,fileWatch:!1,fileWrite:!1,notification:!0,clipboard:!1,ai:!1,shell:!1,extension:{read:!1,events:!1,modify:!1,capture:!1}};let Ke=e=>{Z=e};var qe=e=>{throw new B(`NOT_SUPPORTED`,`${e} is not supported in this environment.`)},Q=e=>async()=>qe(e),$=e=>()=>qe(e),Je={chat:Q(`ai.chat`),summarize:Q(`ai.summarize`),translate:Q(`ai.translate`)},Ye={readText:Q(`clipboard.readText`),writeText:Q(`clipboard.writeText`),readImage:Q(`clipboard.readImage`),writeImage:Q(`clipboard.writeImage`),onChange:$(`clipboard.onChange`)},Xe={openFile:Q(`dialog.openFile`),openDirectory:Q(`dialog.openDirectory`),saveFile:Q(`dialog.saveFile`),message:Q(`dialog.message`)},Ze={readText:Q(`file.readText`),readBinary:Q(`file.readBinary`),write:Q(`file.write`),append:Q(`file.append`),exists:Q(`file.exists`),stat:Q(`file.stat`),copy:Q(`file.copy`),move:Q(`file.move`),remove:Q(`file.remove`),list:Q(`file.list`),mkdir:Q(`file.mkdir`),persistPermission:Q(`file.persistPermission`)},Qe=$(`onNotificationAction`),$e=$(`onFileDrop`);let{sdk:et,childMethods:tt}=Te({getters:{platform:()=>Z?.platform??`web`,capabilities:()=>Z?.capabilities??Ge},modules:{storage:{rpc:{methods:[`get`,`set`,`delete`,`clear`],mapping:{get:`storageGet`,set:`storageSet`,delete:`storageDelete`,clear:`storageClear`},fallbacks:{get:z.get,set:z.set,delete:z.delete,clear:z.clear}}},network:{rpc:{methods:[`request`],mapping:{request:`networkRequest`},fallbacks:{request:Oe.request}}},extension:{rpc:{methods:[`getPageInfo`,`getPageHTML`,`getPageText`,`getSelection`,`extractArticle`,`extractLinks`,`extractImages`,`queryElement`,`highlight`,`removeHighlight`,`insertWidget`,`updateWidget`,`removeWidget`,`injectCSS`,`removeCSS`,`captureVisible`,`getContextMenuEvent`]},events:[`onContextMenu`,`onSelectionChange`]}},actions:{notify:{method:`notify`,fallback:De}},statics:{SDKError:B,auth:G,cloud:X,ai:Je,clipboard:Ye,dialog:Xe,file:Ze,onNotificationAction:Qe,onFileDrop:$e}});return Ee(tt,{timeoutMs:1500}).then(e=>{e&&Ke(e)}),et.SDKError=B,et});

package/dist/types/cloud.d.ts

@@ -35,9 +35,6 @@ export interface CloudKvAPI {
 export interface CloudDbDoc<T = unknown> {
     id: string;
     ownerId: string;
-    visibility: CloudVisibility;
-    refType: string | null;
-    refId: string | null;
     data: T;
     createdAt: number;
     updatedAt: number;
@@ -45,9 +42,9 @@ export interface CloudDbDoc<T = unknown> {
 }
 export type CloudDbWhereOp = '==';
 export interface CloudDbWhere {
-    field: 'ownerId' | 'visibility' | 'refType' | 'refId';
+    field: string;
     op: CloudDbWhereOp;
-    value: string;
+    value: unknown;
 }
 export interface CloudDbQueryInput {
     where?: CloudDbWhere[];
@@ -64,13 +61,16 @@ export interface CloudDbQueryResult<T = unknown> {
 }
 export interface CloudDbDocumentRef<T = unknown> {
     get(): Promise<CloudDbDoc<T>>;
+    set(data: T, options?: {
+        ifMatch?: string;
+    }): Promise<CloudDbDoc<T>>;
     update(patch: Partial<T>, options?: {
         ifMatch?: string;
     }): Promise<CloudDbDoc<T>>;
     delete(): Promise<void>;
 }
 export interface CloudDbQueryBuilder<T = unknown> {
-    where(field: CloudDbWhere['field'], op: CloudDbWhereOp, value: string): CloudDbQueryBuilder<T>;
+    where(field: string, op: CloudDbWhereOp, value: unknown): CloudDbQueryBuilder<T>;
     orderBy(field: 'createdAt' | 'updatedAt', direction?: 'asc' | 'desc'): CloudDbQueryBuilder<T>;
     limit(n: number): CloudDbQueryBuilder<T>;
     startAfter(cursor: string): CloudDbQueryBuilder<T>;
@@ -79,9 +79,6 @@ export interface CloudDbQueryBuilder<T = unknown> {
 export interface CloudDbCollection<T = unknown> {
     add(data: T, options?: {
         id?: string;
-        visibility?: CloudVisibility;
-        refType?: string;
-        refId?: string;
     }): Promise<CloudDbDoc<T>>;
     doc(id: string): CloudDbDocumentRef<T>;
     query(): CloudDbQueryBuilder<T>;
@@ -90,15 +87,193 @@ export interface CloudDbAPI {
     collection<T = unknown>(name: string): CloudDbCollection<T>;
 }
 export interface CloudBlobAPI {
-    createUploadUrl(_input: unknown): Promise<never>;
-    getDownloadUrl(_input: unknown): Promise<never>;
+    createUploadUrl(input: {
+        path?: string;
+        visibility?: CloudVisibility;
+        contentType?: string;
+        expiresIn?: number;
+    }): Promise<{
+        fileId: string;
+        uploadUrl: string;
+        expiresIn: number;
+    }>;
+    getDownloadUrl(input: {
+        fileId: string;
+        expiresIn?: number;
+    }): Promise<{
+        fileId: string;
+        url: string;
+        expiresIn: number;
+    }>;
 }
 export interface CloudFunctionsAPI {
-    call(_name: string, _payload: unknown): Promise<never>;
+    call<T = unknown>(name: string, payload?: unknown): Promise<T>;
+}
+export type WxCloudQueryDirection = 'asc' | 'desc';
+export type WxCloudCommandExpr = {
+    __gemigoWxCmd: 'eq';
+    value: unknown;
+} | {
+    __gemigoWxCmd: 'neq';
+    value: unknown;
+} | {
+    __gemigoWxCmd: 'gt';
+    value: unknown;
+} | {
+    __gemigoWxCmd: 'gte';
+    value: unknown;
+} | {
+    __gemigoWxCmd: 'lt';
+    value: unknown;
+} | {
+    __gemigoWxCmd: 'lte';
+    value: unknown;
+} | {
+    __gemigoWxCmd: 'in';
+    value: unknown[];
+} | {
+    __gemigoWxCmd: 'nin';
+    value: unknown[];
+} | {
+    __gemigoWxCmd: 'inc';
+    value: number;
+} | {
+    __gemigoWxCmd: 'set';
+    value: unknown;
+} | {
+    __gemigoWxCmd: 'remove';
+};
+export interface WxCloudCommand {
+    eq(value: unknown): WxCloudCommandExpr;
+    neq(value: unknown): WxCloudCommandExpr;
+    gt(value: unknown): WxCloudCommandExpr;
+    gte(value: unknown): WxCloudCommandExpr;
+    lt(value: unknown): WxCloudCommandExpr;
+    lte(value: unknown): WxCloudCommandExpr;
+    in(list: unknown[]): WxCloudCommandExpr;
+    nin(list: unknown[]): WxCloudCommandExpr;
+    inc(n: number): WxCloudCommandExpr;
+    set(value: unknown): WxCloudCommandExpr;
+    remove(): WxCloudCommandExpr;
+}
+export type WxCloudServerDate = {
+    __gemigoWxType: 'serverDate';
+    offset?: number;
+};
+export interface WxCloudGetResult<TDoc = unknown> {
+    data: TDoc[];
+    /**
+     * GemiGo extension: opaque cursor for efficient pagination.
+     * - Kept in `_meta` to preserve wx.cloud-style `{ data }` shape.
+     */
+    _meta?: {
+        nextCursor: string | null;
+    };
+}
+export interface WxCloudAddResult {
+    _id: string;
+}
+export interface WxCloudRemoveResult {
+    stats: {
+        removed: number;
+    };
+}
+export interface WxCloudCountResult {
+    total: number;
+}
+export interface WxCloudUpdateResult {
+    stats: {
+        updated: number;
+    };
+}
+export interface WxCloudDocumentRef<TData = unknown> {
+    get(): Promise<{
+        data: (TData & {
+            _id: string;
+        });
+    }>;
+    set(input: {
+        data: TData;
+    }): Promise<void>;
+    update(input: {
+        data: Partial<TData>;
+    }): Promise<void>;
+    remove(): Promise<WxCloudRemoveResult>;
+}
+export interface WxCloudQuery<TData = unknown> {
+    where(condition: Record<string, unknown>): WxCloudQuery<TData>;
+    orderBy(field: string, direction?: WxCloudQueryDirection): WxCloudQuery<TData>;
+    limit(n: number): WxCloudQuery<TData>;
+    skip(n: number): WxCloudQuery<TData>;
+    /**
+     * GemiGo extension: cursor pagination (recommended over large skip).
+     * Cursor is obtained from `_meta.nextCursor` of a previous `get()`.
+     */
+    startAfter(cursor: string): WxCloudQuery<TData>;
+    get(): Promise<WxCloudGetResult<TData & {
+        _id: string;
+    }>>;
+    count(): Promise<WxCloudCountResult>;
+    update(input: {
+        data: Record<string, unknown>;
+    }): Promise<WxCloudUpdateResult>;
+    remove(): Promise<WxCloudRemoveResult>;
+}
+export interface WxCloudCollection<TData = unknown> extends WxCloudQuery<TData> {
+    add(input: {
+        data: TData;
+    }): Promise<WxCloudAddResult>;
+    doc(id: string): WxCloudDocumentRef<TData>;
+}
+export interface WxCloudDatabase {
+    readonly command: WxCloudCommand;
+    serverDate(options?: {
+        offset?: number;
+    }): WxCloudServerDate;
+    collection<TData = unknown>(name: string): WxCloudCollection<TData>;
+}
+export interface WxCloudCallFunctionInput {
+    name: string;
+    data?: unknown;
+}
+export interface WxCloudCallFunctionResult<TResult = unknown> {
+    result: TResult;
+}
+export interface WxCloudUploadFileInput {
+    cloudPath: string;
+    filePath: Blob;
+}
+export interface WxCloudUploadFileResult {
+    fileID: string;
+}
+export interface WxCloudGetTempFileURLInput {
+    fileList: Array<string | {
+        fileID: string;
+    }>;
+}
+export interface WxCloudGetTempFileURLResult {
+    fileList: Array<{
+        fileID: string;
+        tempFileURL: string;
+        status: number;
+        errMsg?: string;
+    }>;
 }
 export interface CloudAPI {
     kv: CloudKvAPI;
     db: CloudDbAPI;
     blob: CloudBlobAPI;
     functions: CloudFunctionsAPI;
+    /** wx.cloud.init-style facade (currently a no-op config holder) */
+    init(options?: {
+        env?: string;
+    }): void;
+    /** wx.cloud.database() facade */
+    database(): WxCloudDatabase;
+    /** wx.cloud.callFunction facade */
+    callFunction<TResult = unknown>(input: WxCloudCallFunctionInput): Promise<WxCloudCallFunctionResult<TResult>>;
+    /** wx.cloud.uploadFile facade (web accepts Blob/File) */
+    uploadFile(input: WxCloudUploadFileInput): Promise<WxCloudUploadFileResult>;
+    /** wx.cloud.getTempFileURL facade */
+    getTempFileURL(input: WxCloudGetTempFileURLInput): Promise<WxCloudGetTempFileURLResult>;
 }

package/dist/types/index.d.ts

@@ -19,7 +19,7 @@ export type { Platform, Capabilities, FileEntry, FileStat, RPCResult, RPCResultW
 export { SDKError } from './common';
 export type { StorageAPI } from './storage';
 export type { AuthAPI, AuthLoginOptions, AuthScope, AuthTokenResponse } from './auth';
-export type { CloudAPI, CloudScope, CloudVisibility, CloudKvAPI, CloudKvItemMeta, CloudDbAPI, CloudDbCollection, CloudDbDoc, CloudDbDocumentRef, CloudDbQueryBuilder, CloudDbQueryInput, CloudDbQueryResult, CloudDbWhere, CloudDbWhereOp, CloudBlobAPI, CloudFunctionsAPI, } from './cloud';
+export type { CloudAPI, CloudScope, CloudVisibility, WxCloudQueryDirection, WxCloudCommandExpr, WxCloudCommand, WxCloudServerDate, WxCloudGetResult, WxCloudAddResult, WxCloudRemoveResult, WxCloudDocumentRef, WxCloudQuery, WxCloudCollection, WxCloudDatabase, WxCloudCallFunctionInput, WxCloudCallFunctionResult, WxCloudUploadFileInput, WxCloudUploadFileResult, WxCloudGetTempFileURLInput, WxCloudGetTempFileURLResult, CloudKvAPI, CloudKvItemMeta, CloudDbAPI, CloudDbCollection, CloudDbDoc, CloudDbDocumentRef, CloudDbQueryBuilder, CloudDbQueryInput, CloudDbQueryResult, CloudDbWhere, CloudDbWhereOp, CloudBlobAPI, CloudFunctionsAPI, } from './cloud';
 export type { NotifyAction, NotifyOptions, NotifyResult, NotifyFn, NotificationActionHandler, } from './notify';
 export type { ChatMessage, ChatResponse, TranslateOptions, TranslateResult, AIAPI } from './ai';
 export type { ClipboardContent, ClipboardChangeCallback, ClipboardAPI } from './clipboard';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gemigo/app-sdk",
   "private": false,
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "module",
   "description": "GemiGo App SDK (auto-adapts for web/desktop/extension)",
   "main": "dist/gemigo-app-sdk.umd.js",