@gemigo/extension-sdk 0.2.0 → 0.2.1

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

@@ -18,160 +18,160 @@ var NativeEventType;
 (function(e) {
 	e.Message = "message";
 })(NativeEventType ||= {});
-var createDestructor_default = (e, f) => {
-	let p = [], m = !1;
+var createDestructor_default = (e, v) => {
+	let y = [], b = !1;
 	return {
-		destroy(h) {
-			m || (m = !0, f(`${e}: Destroying connection`), p.forEach((e) => {
-				e(h);
+		destroy(x) {
+			b || (b = !0, v(`${e}: Destroying connection`), y.forEach((e) => {
+				e(x);
 			}));
 		},
 		onDestroy(e) {
-			m ? e() : p.push(e);
+			b ? e() : y.push(e);
 		}
 	};
-}, createLogger_default = (e) => (...f) => {
-	e && console.log("[Penpal]", ...f);
+}, createLogger_default = (e) => (...v) => {
+	e && console.log("[Penpal]", ...v);
 };
-const serializeError = ({ name: e, message: f, stack: p }) => ({
+const serializeError = ({ name: e, message: v, stack: y }) => ({
 	name: e,
-	message: f,
-	stack: p
+	message: v,
+	stack: y
 }), deserializeError = (e) => {
-	let f = /* @__PURE__ */ Error();
-	return Object.keys(e).forEach((p) => f[p] = e[p]), f;
+	let v = /* @__PURE__ */ Error();
+	return Object.keys(e).forEach((y) => v[y] = e[y]), v;
 };
-var connectCallReceiver_default = (p, g, _) => {
-	let { localName: y, local: b, remote: x, originForSending: S, originForReceiving: C } = p, w = !1, T = (p) => {
-		if (p.source !== x || p.data.penpal !== MessageType.Call) return;
-		if (C !== "*" && p.origin !== C) {
-			_(`${y} received message from origin ${p.origin} which did not match expected origin ${C}`);
+var connectCallReceiver_default = (y, S, C) => {
+	let { localName: T, local: E, remote: D, originForSending: O, originForReceiving: k } = y, A = !1, j = (y) => {
+		if (y.source !== D || y.data.penpal !== MessageType.Call) return;
+		if (k !== "*" && y.origin !== k) {
+			C(`${T} received message from origin ${y.origin} which did not match expected origin ${k}`);
 			return;
 		}
-		let { methodName: h, args: b, id: T } = p.data;
-		_(`${y}: Received ${h}() call`);
-		let E = (p) => (g) => {
-			if (_(`${y}: Sending ${h}() reply`), w) {
-				_(`${y}: Unable to send ${h}() reply due to destroyed connection`);
+		let { methodName: x, args: E, id: j } = y.data;
+		C(`${T}: Received ${x}() call`);
+		let M = (y) => (S) => {
+			if (C(`${T}: Sending ${x}() reply`), A) {
+				C(`${T}: Unable to send ${x}() reply due to destroyed connection`);
 				return;
 			}
-			let b = {
+			let E = {
 				penpal: MessageType.Reply,
-				id: T,
-				resolution: p,
-				returnValue: g
+				id: j,
+				resolution: y,
+				returnValue: S
 			};
-			p === Resolution.Rejected && g instanceof Error && (b.returnValue = serializeError(g), b.returnValueIsError = !0);
+			y === Resolution.Rejected && S instanceof Error && (E.returnValue = serializeError(S), E.returnValueIsError = !0);
 			try {
-				x.postMessage(b, S);
-			} catch (p) {
-				if (p.name === NativeErrorName.DataCloneError) {
-					let m = {
+				D.postMessage(E, O);
+			} catch (y) {
+				if (y.name === NativeErrorName.DataCloneError) {
+					let b = {
 						penpal: MessageType.Reply,
-						id: T,
+						id: j,
 						resolution: Resolution.Rejected,
-						returnValue: serializeError(p),
+						returnValue: serializeError(y),
 						returnValueIsError: !0
 					};
-					x.postMessage(m, S);
+					D.postMessage(b, O);
 				}
-				throw p;
+				throw y;
 			}
 		};
-		new Promise((e) => e(g[h].apply(g, b))).then(E(Resolution.Fulfilled), E(Resolution.Rejected));
+		new Promise((e) => e(S[x].apply(S, E))).then(M(Resolution.Fulfilled), M(Resolution.Rejected));
 	};
-	return b.addEventListener(NativeEventType.Message, T), () => {
-		w = !0, b.removeEventListener(NativeEventType.Message, T);
+	return E.addEventListener(NativeEventType.Message, j), () => {
+		A = !0, E.removeEventListener(NativeEventType.Message, j);
 	};
-}, id = 0, generateId_default = () => ++id, KEY_PATH_DELIMITER = ".", keyPathToSegments = (e) => e ? e.split(KEY_PATH_DELIMITER) : [], segmentsToKeyPath = (e) => e.join(KEY_PATH_DELIMITER), createKeyPath = (e, f) => {
-	let p = keyPathToSegments(f || "");
-	return p.push(e), segmentsToKeyPath(p);
+}, id = 0, generateId_default = () => ++id, KEY_PATH_DELIMITER = ".", keyPathToSegments = (e) => e ? e.split(KEY_PATH_DELIMITER) : [], segmentsToKeyPath = (e) => e.join(KEY_PATH_DELIMITER), createKeyPath = (e, v) => {
+	let y = keyPathToSegments(v || "");
+	return y.push(e), segmentsToKeyPath(y);
 };
-const setAtKeyPath = (e, f, p) => {
-	let m = keyPathToSegments(f);
-	return m.reduce((e, f, h) => (e[f] === void 0 && (e[f] = {}), h === m.length - 1 && (e[f] = p), e[f]), e), e;
-}, serializeMethods = (e, f) => {
-	let p = {};
-	return Object.keys(e).forEach((m) => {
-		let h = e[m], g = createKeyPath(m, f);
-		typeof h == "object" && Object.assign(p, serializeMethods(h, g)), typeof h == "function" && (p[g] = h);
-	}), p;
+const setAtKeyPath = (e, v, y) => {
+	let b = keyPathToSegments(v);
+	return b.reduce((e, v, x) => (e[v] === void 0 && (e[v] = {}), x === b.length - 1 && (e[v] = y), e[v]), e), e;
+}, serializeMethods = (e, v) => {
+	let y = {};
+	return Object.keys(e).forEach((b) => {
+		let x = e[b], S = createKeyPath(b, v);
+		typeof x == "object" && Object.assign(y, serializeMethods(x, S)), typeof x == "function" && (y[S] = x);
+	}), y;
 }, deserializeMethods = (e) => {
-	let f = {};
-	for (let p in e) setAtKeyPath(f, p, e[p]);
-	return f;
+	let v = {};
+	for (let y in e) setAtKeyPath(v, y, e[y]);
+	return v;
 };
-var connectCallSender_default = (m, g, _, v, b) => {
-	let { localName: x, local: C, remote: w, originForSending: T, originForReceiving: E } = g, D = !1;
-	b(`${x}: Connecting call sender`);
-	let O = (m) => (...g) => {
-		b(`${x}: Sending ${m}() call`);
-		let _;
+var connectCallSender_default = (b, S, C, w, E) => {
+	let { localName: D, local: k, remote: A, originForSending: j, originForReceiving: M } = S, N = !1;
+	E(`${D}: Connecting call sender`);
+	let P = (b) => (...S) => {
+		E(`${D}: Sending ${b}() call`);
+		let C;
 		try {
-			w.closed && (_ = !0);
+			A.closed && (C = !0);
 		} catch {
-			_ = !0;
+			C = !0;
 		}
-		if (_ && v(), D) {
-			let e = /* @__PURE__ */ Error(`Unable to send ${m}() call due to destroyed connection`);
+		if (C && w(), N) {
+			let e = /* @__PURE__ */ Error(`Unable to send ${b}() call due to destroyed connection`);
 			throw e.code = ErrorCode.ConnectionDestroyed, e;
 		}
-		return new Promise((p, _) => {
-			let v = generateId_default(), D = (g) => {
-				if (g.source !== w || g.data.penpal !== MessageType.Reply || g.data.id !== v) return;
-				if (E !== "*" && g.origin !== E) {
-					b(`${x} received message from origin ${g.origin} which did not match expected origin ${E}`);
+		return new Promise((y, C) => {
+			let w = generateId_default(), N = (S) => {
+				if (S.source !== A || S.data.penpal !== MessageType.Reply || S.data.id !== w) return;
+				if (M !== "*" && S.origin !== M) {
+					E(`${D} received message from origin ${S.origin} which did not match expected origin ${M}`);
 					return;
 				}
-				let S = g.data;
-				b(`${x}: Received ${m}() reply`), C.removeEventListener(NativeEventType.Message, D);
-				let T = S.returnValue;
-				S.returnValueIsError && (T = deserializeError(T)), (S.resolution === Resolution.Fulfilled ? p : _)(T);
+				let O = S.data;
+				E(`${D}: Received ${b}() reply`), k.removeEventListener(NativeEventType.Message, N);
+				let j = O.returnValue;
+				O.returnValueIsError && (j = deserializeError(j)), (O.resolution === Resolution.Fulfilled ? y : C)(j);
 			};
-			C.addEventListener(NativeEventType.Message, D);
-			let O = {
+			k.addEventListener(NativeEventType.Message, N);
+			let P = {
 				penpal: MessageType.Call,
-				id: v,
-				methodName: m,
-				args: g
+				id: w,
+				methodName: b,
+				args: S
 			};
-			w.postMessage(O, T);
+			A.postMessage(P, j);
 		});
-	}, k = _.reduce((e, f) => (e[f] = O(f), e), {});
-	return Object.assign(m, deserializeMethods(k)), () => {
-		D = !0;
+	}, F = C.reduce((e, v) => (e[v] = P(v), e), {});
+	return Object.assign(b, deserializeMethods(F)), () => {
+		N = !0;
 	};
-}, startConnectionTimeout_default = (e, f) => {
-	let m;
-	return e !== void 0 && (m = window.setTimeout(() => {
-		let m = /* @__PURE__ */ Error(`Connection timed out after ${e}ms`);
-		m.code = ErrorCode.ConnectionTimeout, f(m);
+}, startConnectionTimeout_default = (e, v) => {
+	let b;
+	return e !== void 0 && (b = window.setTimeout(() => {
+		let b = /* @__PURE__ */ Error(`Connection timed out after ${e}ms`);
+		b.code = ErrorCode.ConnectionTimeout, v(b);
 	}, e)), () => {
-		clearTimeout(m);
+		clearTimeout(b);
 	};
-}, handleSynAckMessageFactory_default = (f, p, m, h) => {
-	let { destroy: g, onDestroy: _ } = m;
-	return (m) => {
-		if (!(f instanceof RegExp ? f.test(m.origin) : f === "*" || f === m.origin)) {
-			h(`Child: Handshake - Received SYN-ACK from origin ${m.origin} which did not match expected origin ${f}`);
+}, handleSynAckMessageFactory_default = (v, y, b, x) => {
+	let { destroy: S, onDestroy: C } = b;
+	return (b) => {
+		if (!(v instanceof RegExp ? v.test(b.origin) : v === "*" || v === b.origin)) {
+			x(`Child: Handshake - Received SYN-ACK from origin ${b.origin} which did not match expected origin ${v}`);
 			return;
 		}
-		h("Child: Handshake - Received SYN-ACK, responding with ACK");
-		let v = m.origin === "null" ? "*" : m.origin, y = {
+		x("Child: Handshake - Received SYN-ACK, responding with ACK");
+		let w = b.origin === "null" ? "*" : b.origin, T = {
 			penpal: MessageType.Ack,
-			methodNames: Object.keys(p)
+			methodNames: Object.keys(y)
 		};
-		window.parent.postMessage(y, v);
-		let x = {
+		window.parent.postMessage(T, w);
+		let D = {
 			localName: "Child",
 			local: window,
 			remote: window.parent,
-			originForSending: v,
-			originForReceiving: m.origin
+			originForSending: w,
+			originForReceiving: b.origin
 		};
-		_(connectCallReceiver_default(x, p, h));
-		let S = {};
-		return _(connectCallSender_default(S, x, m.data.methodNames, g, h)), S;
+		C(connectCallReceiver_default(D, y, x));
+		let O = {};
+		return C(connectCallSender_default(O, D, b.data.methodNames, S, x)), O;
 	};
 }, areGlobalsAccessible = () => {
 	try {
@@ -180,29 +180,29 @@ var connectCallSender_default = (m, g, _, v, b) => {
 		return !1;
 	}
 	return !0;
-}, connectToParent_default = (f = {}) => {
-	let { parentOrigin: p = "*", methods: m = {}, timeout: v, debug: y = !1 } = f, b = createLogger_default(y), x = createDestructor_default("Child", b), { destroy: S, onDestroy: C } = x, w = handleSynAckMessageFactory_default(p, serializeMethods(m), x, b), T = () => {
-		b("Child: Handshake - Sending SYN");
-		let f = { penpal: MessageType.Syn }, m = p instanceof RegExp ? "*" : p;
-		window.parent.postMessage(f, m);
+}, connectToParent_default = (v = {}) => {
+	let { parentOrigin: y = "*", methods: b = {}, timeout: w, debug: T = !1 } = v, E = createLogger_default(T), D = createDestructor_default("Child", E), { destroy: O, onDestroy: k } = D, A = handleSynAckMessageFactory_default(y, serializeMethods(b), D, E), j = () => {
+		E("Child: Handshake - Sending SYN");
+		let v = { penpal: MessageType.Syn }, b = y instanceof RegExp ? "*" : y;
+		window.parent.postMessage(v, b);
 	};
 	return {
-		promise: new Promise((f, p) => {
-			let m = startConnectionTimeout_default(v, S), g = (p) => {
-				if (areGlobalsAccessible() && !(p.source !== parent || !p.data) && p.data.penpal === MessageType.SynAck) {
-					let e = w(p);
-					e && (window.removeEventListener(NativeEventType.Message, g), m(), f(e));
+		promise: new Promise((v, y) => {
+			let b = startConnectionTimeout_default(w, O), S = (y) => {
+				if (areGlobalsAccessible() && !(y.source !== parent || !y.data) && y.data.penpal === MessageType.SynAck) {
+					let e = A(y);
+					e && (window.removeEventListener(NativeEventType.Message, S), b(), v(e));
 				}
 			};
-			window.addEventListener(NativeEventType.Message, g), T(), C((e) => {
-				window.removeEventListener(NativeEventType.Message, g), e && p(e);
+			window.addEventListener(NativeEventType.Message, S), j(), k((e) => {
+				window.removeEventListener(NativeEventType.Message, S), e && y(e);
 			});
 		}),
 		destroy() {
-			S();
+			O();
 		}
 	};
-}, eventHandlers = { contextMenu: [] }, connectionPromise = null;
+}, connectionPromise = null;
 function isInIframe() {
 	try {
 		return window.self !== window.top;
@@ -210,38 +210,86 @@ function isInIframe() {
 		return !0;
 	}
 }
-function getHost() {
-	return connectionPromise || (isInIframe() || console.warn("[GemiGo SDK] Not running in iframe. SDK calls will verify connection forever."), connectionPromise = connectToParent_default({ methods: { onContextMenuEvent(e) {
-		eventHandlers.contextMenu.forEach((f) => {
-			try {
-				f(e);
-			} catch (e) {
-				console.error("[GemiGo SDK] Error in contextMenu handler:", e);
-			}
-		});
-	} } }).promise, connectionPromise);
+function getHost(e) {
+	if (connectionPromise) return connectionPromise;
+	isInIframe() || console.warn("[GemiGo SDK] Not running in iframe. SDK calls will not work.");
+	let v = {};
+	return e && Object.assign(v, e), connectionPromise = connectToParent_default({ methods: v }).promise, connectionPromise;
+}
+function initConnection(e) {
+	getHost(e).catch((e) => {
+		console.debug("[GemiGo SDK] Auto-connect waiting...", e);
+	});
+}
+var handlers = {
+	contextMenu: [],
+	selectionChange: []
+};
+function on(e, v) {
+	return handlers[e].push(v), () => {
+		let y = handlers[e].indexOf(v);
+		y > -1 && handlers[e].splice(y, 1);
+	};
+}
+function emit(e, v) {
+	handlers[e].forEach((y) => {
+		try {
+			y(v);
+		} catch (v) {
+			console.error(`[GemiGo SDK] Error in ${e} handler:`, v);
+		}
+	});
+}
+function getChildMethods() {
+	return {
+		onContextMenuEvent(e) {
+			emit("contextMenu", e);
+		},
+		onSelectionChange(e, v) {
+			handlers.selectionChange.forEach((y) => {
+				try {
+					y(e, v);
+				} catch (e) {
+					console.error("[GemiGo SDK] Error in selectionChange handler:", e);
+				}
+			});
+		}
+	};
 }
-var sdkInstance = {
+const extensionAPI = {
 	getPageInfo: () => getHost().then((e) => e.getPageInfo()),
-	notify: (e, f) => getHost().then((p) => p.notify({
-		title: e,
-		message: f
+	getPageHTML: () => getHost().then((e) => e.getPageHTML()),
+	getPageText: () => getHost().then((e) => e.getPageText()),
+	getSelection: () => getHost().then((e) => e.getSelection()),
+	extractArticle: () => getHost().then((e) => e.extractArticle()),
+	highlight: (e, v) => getHost().then((y) => y.highlight(e, v)),
+	removeHighlight: (e) => getHost().then((v) => v.removeHighlight(e)),
+	insertWidget: (e, v = "bottom-right") => getHost().then((y) => y.insertWidget({
+		html: e,
+		position: v
 	})),
-	extension: {
-		getPageHTML: () => getHost().then((e) => e.getPageHTML()),
-		getPageText: () => getHost().then((e) => e.getPageText()),
-		getSelection: () => getHost().then((e) => e.getSelection()),
-		highlight: (e, f) => getHost().then((p) => p.highlight(e, f)),
-		extractArticle: () => getHost().then((e) => e.extractArticle()),
-		captureVisible: () => getHost().then((e) => e.captureVisible()),
-		getContextMenuEvent: () => getHost().then((e) => e.getContextMenuEvent()),
-		onContextMenu(e) {
-			getHost(), eventHandlers.contextMenu.push(e);
-		}
-	}
+	updateWidget: (e, v) => getHost().then((y) => y.updateWidget(e, v)),
+	removeWidget: (e) => getHost().then((v) => v.removeWidget(e)),
+	injectCSS: (e) => getHost().then((v) => v.injectCSS(e)),
+	removeCSS: (e) => getHost().then((v) => v.removeCSS(e)),
+	extractLinks: () => getHost().then((e) => e.extractLinks()),
+	extractImages: () => getHost().then((e) => e.extractImages()),
+	queryElement: (e, v) => getHost().then((y) => y.queryElement(e, v)),
+	captureVisible: () => getHost().then((e) => e.captureVisible()),
+	getContextMenuEvent: () => getHost().then((e) => e.getContextMenuEvent()),
+	onContextMenu: (e) => (getHost(), on("contextMenu", e)),
+	onSelectionChange: (e) => (getHost(), on("selectionChange", e))
 };
-getHost().catch((e) => {
-	console.debug("[GemiGo SDK] Auto-connect waiting...", e);
-});
-var src_default = sdkInstance;
-export { src_default as default };
+function createSDK() {
+	return {
+		notify: (e, v) => getHost().then((y) => y.notify({
+			title: e,
+			message: v
+		})),
+		extension: extensionAPI
+	};
+}
+var sdk = createSDK();
+initConnection(getChildMethods());
+var sdk_default = sdk;
+export { sdk_default as default };

package/dist/gemigo-extension-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;(function(e){e.Call=`call`,e.Reply=`reply`,e.Syn=`syn`,e.SynAck=`synAck`,e.Ack=`ack`})(e||={});var t;(function(e){e.Fulfilled=`fulfilled`,e.Rejected=`rejected`})(t||={});var n;(function(e){e.ConnectionDestroyed=`ConnectionDestroyed`,e.ConnectionTimeout=`ConnectionTimeout`,e.NoIframeSrc=`NoIframeSrc`})(n||={});var r;(function(e){e.DataCloneError=`DataCloneError`})(r||={});var i;(function(e){e.Message=`message`})(i||={});var a=(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)}}},o=e=>(...t)=>{e&&console.log(`[Penpal]`,...t)};let s=({name:e,message:t,stack:n})=>({name:e,message:t,stack:n}),c=e=>{let t=Error();return Object.keys(e).forEach(n=>t[n]=e[n]),t};var l=(n,a,o)=>{let{localName:c,local:l,remote:u,originForSending:d,originForReceiving:f}=n,p=!1,m=n=>{if(n.source!==u||n.data.penpal!==e.Call)return;if(f!==`*`&&n.origin!==f){o(`${c} received message from origin ${n.origin} which did not match expected origin ${f}`);return}let{methodName:i,args:l,id:m}=n.data;o(`${c}: Received ${i}() call`);let h=n=>a=>{if(o(`${c}: Sending ${i}() reply`),p){o(`${c}: Unable to send ${i}() reply due to destroyed connection`);return}let l={penpal:e.Reply,id:m,resolution:n,returnValue:a};n===t.Rejected&&a instanceof Error&&(l.returnValue=s(a),l.returnValueIsError=!0);try{u.postMessage(l,d)}catch(n){if(n.name===r.DataCloneError){let r={penpal:e.Reply,id:m,resolution:t.Rejected,returnValue:s(n),returnValueIsError:!0};u.postMessage(r,d)}throw n}};new Promise(e=>e(a[i].apply(a,l))).then(h(t.Fulfilled),h(t.Rejected))};return l.addEventListener(i.Message,m),()=>{p=!0,l.removeEventListener(i.Message,m)}},u=0,d=()=>++u,f=`.`,p=e=>e?e.split(f):[],m=e=>e.join(f),h=(e,t)=>{let n=p(t||``);return n.push(e),m(n)};let g=(e,t,n)=>{let r=p(t);return r.reduce((e,t,i)=>(e[t]===void 0&&(e[t]={}),i===r.length-1&&(e[t]=n),e[t]),e),e},_=(e,t)=>{let n={};return Object.keys(e).forEach(r=>{let i=e[r],a=h(r,t);typeof i==`object`&&Object.assign(n,_(i,a)),typeof i==`function`&&(n[a]=i)}),n},v=e=>{let t={};for(let n in e)g(t,n,e[n]);return t};var y=(r,a,o,s,l)=>{let{localName:u,local:f,remote:p,originForSending:m,originForReceiving:h}=a,g=!1;l(`${u}: Connecting call sender`);let _=r=>(...a)=>{l(`${u}: Sending ${r}() call`);let o;try{p.closed&&(o=!0)}catch{o=!0}if(o&&s(),g){let e=Error(`Unable to send ${r}() call due to destroyed connection`);throw e.code=n.ConnectionDestroyed,e}return new Promise((n,o)=>{let s=d(),g=a=>{if(a.source!==p||a.data.penpal!==e.Reply||a.data.id!==s)return;if(h!==`*`&&a.origin!==h){l(`${u} received message from origin ${a.origin} which did not match expected origin ${h}`);return}let d=a.data;l(`${u}: Received ${r}() reply`),f.removeEventListener(i.Message,g);let m=d.returnValue;d.returnValueIsError&&(m=c(m)),(d.resolution===t.Fulfilled?n:o)(m)};f.addEventListener(i.Message,g);let _={penpal:e.Call,id:s,methodName:r,args:a};p.postMessage(_,m)})},y=o.reduce((e,t)=>(e[t]=_(t),e),{});return Object.assign(r,v(y)),()=>{g=!0}},b=(e,t)=>{let r;return e!==void 0&&(r=window.setTimeout(()=>{let r=Error(`Connection timed out after ${e}ms`);r.code=n.ConnectionTimeout,t(r)},e)),()=>{clearTimeout(r)}},x=(t,n,r,i)=>{let{destroy:a,onDestroy:o}=r;return r=>{if(!(t instanceof RegExp?t.test(r.origin):t===`*`||t===r.origin)){i(`Child: Handshake - Received SYN-ACK from origin ${r.origin} which did not match expected origin ${t}`);return}i(`Child: Handshake - Received SYN-ACK, responding with ACK`);let s=r.origin===`null`?`*`:r.origin,c={penpal:e.Ack,methodNames:Object.keys(n)};window.parent.postMessage(c,s);let u={localName:`Child`,local:window,remote:window.parent,originForSending:s,originForReceiving:r.origin};o(l(u,n,i));let d={};return o(y(d,u,r.data.methodNames,a,i)),d}},S=()=>{try{clearTimeout()}catch{return!1}return!0},C=(t={})=>{let{parentOrigin:n=`*`,methods:r={},timeout:s,debug:c=!1}=t,l=o(c),u=a(`Child`,l),{destroy:d,onDestroy:f}=u,p=x(n,_(r),u,l),m=()=>{l(`Child: Handshake - Sending SYN`);let t={penpal:e.Syn},r=n instanceof RegExp?`*`:n;window.parent.postMessage(t,r)};return{promise:new Promise((t,n)=>{let r=b(s,d),a=n=>{if(S()&&!(n.source!==parent||!n.data)&&n.data.penpal===e.SynAck){let e=p(n);e&&(window.removeEventListener(i.Message,a),r(),t(e))}};window.addEventListener(i.Message,a),m(),f(e=>{window.removeEventListener(i.Message,a),e&&n(e)})}),destroy(){d()}}},w={contextMenu:[]},T=null;function E(){try{return window.self!==window.top}catch{return!0}}function D(){return T||(E()||console.warn(`[GemiGo SDK] Not running in iframe. SDK calls will verify connection forever.`),T=C({methods:{onContextMenuEvent(e){w.contextMenu.forEach(t=>{try{t(e)}catch(e){console.error(`[GemiGo SDK] Error in contextMenu handler:`,e)}})}}}).promise,T)}return D().catch(e=>{console.debug(`[GemiGo SDK] Auto-connect waiting...`,e)}),{getPageInfo:()=>D().then(e=>e.getPageInfo()),notify:(e,t)=>D().then(n=>n.notify({title:e,message:t})),extension:{getPageHTML:()=>D().then(e=>e.getPageHTML()),getPageText:()=>D().then(e=>e.getPageText()),getSelection:()=>D().then(e=>e.getSelection()),highlight:(e,t)=>D().then(n=>n.highlight(e,t)),extractArticle:()=>D().then(e=>e.extractArticle()),captureVisible:()=>D().then(e=>e.captureVisible()),getContextMenuEvent:()=>D().then(e=>e.getContextMenuEvent()),onContextMenu(e){D(),w.contextMenu.push(e)}}}});
+(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;(function(e){e.Call=`call`,e.Reply=`reply`,e.Syn=`syn`,e.SynAck=`synAck`,e.Ack=`ack`})(e||={});var t;(function(e){e.Fulfilled=`fulfilled`,e.Rejected=`rejected`})(t||={});var n;(function(e){e.ConnectionDestroyed=`ConnectionDestroyed`,e.ConnectionTimeout=`ConnectionTimeout`,e.NoIframeSrc=`NoIframeSrc`})(n||={});var r;(function(e){e.DataCloneError=`DataCloneError`})(r||={});var i;(function(e){e.Message=`message`})(i||={});var a=(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)}}},o=e=>(...t)=>{e&&console.log(`[Penpal]`,...t)};let s=({name:e,message:t,stack:n})=>({name:e,message:t,stack:n}),c=e=>{let t=Error();return Object.keys(e).forEach(n=>t[n]=e[n]),t};var l=(n,a,o)=>{let{localName:c,local:l,remote:u,originForSending:d,originForReceiving:f}=n,p=!1,m=n=>{if(n.source!==u||n.data.penpal!==e.Call)return;if(f!==`*`&&n.origin!==f){o(`${c} received message from origin ${n.origin} which did not match expected origin ${f}`);return}let{methodName:i,args:l,id:m}=n.data;o(`${c}: Received ${i}() call`);let h=n=>a=>{if(o(`${c}: Sending ${i}() reply`),p){o(`${c}: Unable to send ${i}() reply due to destroyed connection`);return}let l={penpal:e.Reply,id:m,resolution:n,returnValue:a};n===t.Rejected&&a instanceof Error&&(l.returnValue=s(a),l.returnValueIsError=!0);try{u.postMessage(l,d)}catch(n){if(n.name===r.DataCloneError){let r={penpal:e.Reply,id:m,resolution:t.Rejected,returnValue:s(n),returnValueIsError:!0};u.postMessage(r,d)}throw n}};new Promise(e=>e(a[i].apply(a,l))).then(h(t.Fulfilled),h(t.Rejected))};return l.addEventListener(i.Message,m),()=>{p=!0,l.removeEventListener(i.Message,m)}},u=0,d=()=>++u,f=`.`,p=e=>e?e.split(f):[],m=e=>e.join(f),h=(e,t)=>{let n=p(t||``);return n.push(e),m(n)};let g=(e,t,n)=>{let r=p(t);return r.reduce((e,t,i)=>(e[t]===void 0&&(e[t]={}),i===r.length-1&&(e[t]=n),e[t]),e),e},_=(e,t)=>{let n={};return Object.keys(e).forEach(r=>{let i=e[r],a=h(r,t);typeof i==`object`&&Object.assign(n,_(i,a)),typeof i==`function`&&(n[a]=i)}),n},v=e=>{let t={};for(let n in e)g(t,n,e[n]);return t};var y=(r,a,o,s,l)=>{let{localName:u,local:f,remote:p,originForSending:m,originForReceiving:h}=a,g=!1;l(`${u}: Connecting call sender`);let _=r=>(...a)=>{l(`${u}: Sending ${r}() call`);let o;try{p.closed&&(o=!0)}catch{o=!0}if(o&&s(),g){let e=Error(`Unable to send ${r}() call due to destroyed connection`);throw e.code=n.ConnectionDestroyed,e}return new Promise((n,o)=>{let s=d(),g=a=>{if(a.source!==p||a.data.penpal!==e.Reply||a.data.id!==s)return;if(h!==`*`&&a.origin!==h){l(`${u} received message from origin ${a.origin} which did not match expected origin ${h}`);return}let d=a.data;l(`${u}: Received ${r}() reply`),f.removeEventListener(i.Message,g);let m=d.returnValue;d.returnValueIsError&&(m=c(m)),(d.resolution===t.Fulfilled?n:o)(m)};f.addEventListener(i.Message,g);let _={penpal:e.Call,id:s,methodName:r,args:a};p.postMessage(_,m)})},y=o.reduce((e,t)=>(e[t]=_(t),e),{});return Object.assign(r,v(y)),()=>{g=!0}},b=(e,t)=>{let r;return e!==void 0&&(r=window.setTimeout(()=>{let r=Error(`Connection timed out after ${e}ms`);r.code=n.ConnectionTimeout,t(r)},e)),()=>{clearTimeout(r)}},x=(t,n,r,i)=>{let{destroy:a,onDestroy:o}=r;return r=>{if(!(t instanceof RegExp?t.test(r.origin):t===`*`||t===r.origin)){i(`Child: Handshake - Received SYN-ACK from origin ${r.origin} which did not match expected origin ${t}`);return}i(`Child: Handshake - Received SYN-ACK, responding with ACK`);let s=r.origin===`null`?`*`:r.origin,c={penpal:e.Ack,methodNames:Object.keys(n)};window.parent.postMessage(c,s);let u={localName:`Child`,local:window,remote:window.parent,originForSending:s,originForReceiving:r.origin};o(l(u,n,i));let d={};return o(y(d,u,r.data.methodNames,a,i)),d}},S=()=>{try{clearTimeout()}catch{return!1}return!0},C=(t={})=>{let{parentOrigin:n=`*`,methods:r={},timeout:s,debug:c=!1}=t,l=o(c),u=a(`Child`,l),{destroy:d,onDestroy:f}=u,p=x(n,_(r),u,l),m=()=>{l(`Child: Handshake - Sending SYN`);let t={penpal:e.Syn},r=n instanceof RegExp?`*`:n;window.parent.postMessage(t,r)};return{promise:new Promise((t,n)=>{let r=b(s,d),a=n=>{if(S()&&!(n.source!==parent||!n.data)&&n.data.penpal===e.SynAck){let e=p(n);e&&(window.removeEventListener(i.Message,a),r(),t(e))}};window.addEventListener(i.Message,a),m(),f(e=>{window.removeEventListener(i.Message,a),e&&n(e)})}),destroy(){d()}}},w=null;function T(){try{return window.self!==window.top}catch{return!0}}function E(e){if(w)return w;T()||console.warn(`[GemiGo SDK] Not running in iframe. SDK calls will not work.`);let t={};return e&&Object.assign(t,e),w=C({methods:t}).promise,w}function D(e){E(e).catch(e=>{console.debug(`[GemiGo SDK] Auto-connect waiting...`,e)})}var O={contextMenu:[],selectionChange:[]};function k(e,t){return O[e].push(t),()=>{let n=O[e].indexOf(t);n>-1&&O[e].splice(n,1)}}function A(e,t){O[e].forEach(n=>{try{n(t)}catch(t){console.error(`[GemiGo SDK] Error in ${e} handler:`,t)}})}function j(){return{onContextMenuEvent(e){A(`contextMenu`,e)},onSelectionChange(e,t){O.selectionChange.forEach(n=>{try{n(e,t)}catch(e){console.error(`[GemiGo SDK] Error in selectionChange handler:`,e)}})}}}let M={getPageInfo:()=>E().then(e=>e.getPageInfo()),getPageHTML:()=>E().then(e=>e.getPageHTML()),getPageText:()=>E().then(e=>e.getPageText()),getSelection:()=>E().then(e=>e.getSelection()),extractArticle:()=>E().then(e=>e.extractArticle()),highlight:(e,t)=>E().then(n=>n.highlight(e,t)),removeHighlight:e=>E().then(t=>t.removeHighlight(e)),insertWidget:(e,t=`bottom-right`)=>E().then(n=>n.insertWidget({html:e,position:t})),updateWidget:(e,t)=>E().then(n=>n.updateWidget(e,t)),removeWidget:e=>E().then(t=>t.removeWidget(e)),injectCSS:e=>E().then(t=>t.injectCSS(e)),removeCSS:e=>E().then(t=>t.removeCSS(e)),extractLinks:()=>E().then(e=>e.extractLinks()),extractImages:()=>E().then(e=>e.extractImages()),queryElement:(e,t)=>E().then(n=>n.queryElement(e,t)),captureVisible:()=>E().then(e=>e.captureVisible()),getContextMenuEvent:()=>E().then(e=>e.getContextMenuEvent()),onContextMenu:e=>(E(),k(`contextMenu`,e)),onSelectionChange:e=>(E(),k(`selectionChange`,e))};function N(){return{notify:(e,t)=>E().then(n=>n.notify({title:e,message:t})),extension:M}}var P=N();return D(j()),P});

package/dist/index.d.ts

@@ -6,10 +6,9 @@
  * Usage (CDN):
  *   <script src="https://unpkg.com/@gemigo/extension-sdk/dist/gemigo-extension-sdk.umd.js"></script>
  *   <script>
- *     // No connect() needed - just use the global gemigo object directly
  *     gemigo.getPageInfo().then(console.log);
  *
- *     gemigo.on('contextMenu', (event) => {
+ *     gemigo.extension.onContextMenu((event) => {
  *       console.log('Context menu clicked:', event);
  *     });
  *   </script>
@@ -19,64 +18,6 @@
  *
  *   const pageInfo = await gemigo.getPageInfo();
  */
-type ContextMenuEventHandler = (event: {
-    menuId: string;
-    selectionText?: string;
-    pageUrl?: string;
-}) => void;
-export interface GemigoSDK {
-    /** Get current page information */
-    getPageInfo(): Promise<{
-        url: string;
-        title: string;
-        favIconUrl?: string;
-    }>;
-    /** Send system notification */
-    notify(title: string, message: string): Promise<{
-        success: boolean;
-    }>;
-    /** Extension-specific APIs */
-    extension: {
-        /** Get full page HTML */
-        getPageHTML(): Promise<string>;
-        /** Get page text content */
-        getPageText(): Promise<string>;
-        /** Get selected text on page */
-        getSelection(): Promise<string>;
-        /** Highlight elements matching selector */
-        highlight(selector: string, color?: string): Promise<{
-            success: boolean;
-            count?: number;
-        }>;
-        /** Extract article content from page */
-        extractArticle(): Promise<{
-            success: boolean;
-            title?: string;
-            content?: string;
-            excerpt?: string;
-            url?: string;
-        }>;
-        /** Capture visible tab screenshot */
-        captureVisible(): Promise<{
-            success: boolean;
-            dataUrl?: string;
-            error?: string;
-        }>;
-        /** Get pending context menu event (if any) */
-        getContextMenuEvent(): Promise<{
-            success: boolean;
-            event?: {
-                menuId: string;
-                selectionText?: string;
-                pageUrl?: string;
-            };
-        }>;
-        /** Register context menu event handler */
-        onContextMenu(handler: ContextMenuEventHandler): void;
-    };
-}
-/**
- * Proxy handler to auto-connect on method calls
- */
-declare const sdkInstance: GemigoSDK;
-export default sdkInstance;
+export * from './types';
+export { default } from './sdk';
+export type { SDKInstance } from './sdk';

package/dist/sdk.d.ts

@@ -0,0 +1,15 @@
+import { extensionAPI } from './apis';
+/**
+ * SDK interface for current implementation
+ * (Subset of full GemigoSDK - only extension platform is implemented)
+ */
+export interface SDKInstance {
+    /** Send system notification */
+    notify(title: string, message: string): Promise<{
+        success: boolean;
+    }>;
+    /** Extension-specific APIs */
+    extension: typeof extensionAPI;
+}
+declare const sdk: SDKInstance;
+export default sdk;

package/dist/types/ai.d.ts

@@ -0,0 +1,48 @@
+/**
+ * AI API types
+ */
+/** Chat message */
+export interface ChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+/** Chat response */
+export interface ChatResponse {
+    role: 'assistant';
+    content: string;
+}
+/** Translation options */
+export interface TranslateOptions {
+    /** Source language (auto-detect if not specified) */
+    from?: string;
+    /** Target language (required) */
+    to: string;
+}
+/** Translation result */
+export interface TranslateResult {
+    text: string;
+    from: string;
+    to: string;
+}
+/** AI API for cloud model integration */
+export interface AIAPI {
+    /**
+     * Multi-turn conversation
+     * @param messages - Conversation history
+     * @returns Assistant response
+     */
+    chat(messages: ChatMessage[]): Promise<ChatResponse>;
+    /**
+     * Summarize text content
+     * @param text - Text to summarize
+     * @returns Summary text
+     */
+    summarize(text: string): Promise<string>;
+    /**
+     * Translate text
+     * @param text - Text to translate
+     * @param options - Translation options
+     * @returns Translation result
+     */
+    translate(text: string, options: TranslateOptions): Promise<TranslateResult>;
+}

package/dist/types/clipboard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Clipboard API types
+ */
+/** Clipboard content */
+export interface ClipboardContent {
+    text?: string;
+    image?: Blob;
+}
+/** Clipboard change callback */
+export type ClipboardChangeCallback = (content: ClipboardContent) => void;
+/** Clipboard API */
+export interface ClipboardAPI {
+    /**
+     * Read text from clipboard
+     * @returns Clipboard text content
+     */
+    readText(): Promise<string>;
+    /**
+     * Write text to clipboard
+     * @param text - Text to write
+     */
+    writeText(text: string): Promise<void>;
+    /**
+     * Read image from clipboard
+     * @returns Image blob or null
+     */
+    readImage(): Promise<Blob | null>;
+    /**
+     * Write image to clipboard
+     * @param blob - Image blob to write
+     */
+    writeImage(blob: Blob): Promise<void>;
+    /**
+     * Listen for clipboard content changes (desktop only)
+     * @param callback - Change callback
+     * @returns Unsubscribe function
+     */
+    onChange(callback: ClipboardChangeCallback): () => void;
+}