@gd-kirie/ipc 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# @gd-kirie/ipc
+
+Thin browser-side IPC transport for Kirie WebView pages.
+
+The package is imported by web content running inside a Kirie WebView. Native platforms continue to provide the low
+level bridge on `globalThis`, and this package only wraps that bridge with a small typed module API.
+
+## API
+
+```ts
+import { onIpcMessageReceived, sendIpcMessage } from "@gd-kirie/ipc";
+
+sendIpcMessage({
+  type: "web_ready",
+});
+
+const unsubscribe = onIpcMessageReceived((message) => {
+  console.log(message);
+});
+
+unsubscribe();
+```
+
+`sendIpcMessage()` serializes the message with `JSON.stringify()` and forwards the
+result to the current native bridge:
+
+- Android: `globalThis.KirieAndroidBridge.postMessage(...)`
+- iOS: `globalThis.webkit.messageHandlers.kirie.postMessage(...)`
+
+`onIpcMessageReceived()` listens for `kirie:ipc-message` events dispatched by the
+native bridge.

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+//#region src/index.d.ts
+type AndroidBridge = {
+  postMessage(messageJson: string): void;
+};
+type IosBridge = {
+  postMessage(messageJson: string): void;
+};
+declare global {
+  var KirieAndroidBridge: AndroidBridge | undefined;
+  var webkit: {
+    messageHandlers?: {
+      kirie?: IosBridge;
+    };
+  } | undefined;
+}
+type KirieIpcMessageHandler<TMessage = unknown> = (message: TMessage) => void;
+declare function sendIpcMessage(message: unknown): void;
+declare function onIpcMessageReceived<TMessage = unknown>(handler: KirieIpcMessageHandler<TMessage>): () => void;
+//#endregion
+export { KirieIpcMessageHandler, onIpcMessageReceived, sendIpcMessage };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";KAEK,aAAA;EACH,WAAA,CAAY,WAAA;AAAA;AAAA,KAGT,SAAA;EACH,WAAA,CAAY,WAAA;AAAA;AAAA;MAIR,kBAAA,EAAoB,aAAA;EAAA,IAEpB,MAAA;IAEE,eAAA;MACE,KAAA,GAAQ,SAAA;IAAA;EAAA;AAAA;AAAA,KAMN,sBAAA,wBAA8C,OAAA,EAAS,QAAA;AAAA,iBAEnD,cAAA,CAAe,OAAA;AAAA,iBAuBf,oBAAA,oBAAA,CACd,OAAA,EAAS,sBAAA,CAAuB,QAAA"}

package/dist/index.js

@@ -0,0 +1,30 @@
+//#region src/index.ts
+const IPC_MESSAGE_EVENT = "kirie:ipc-message";
+function sendIpcMessage(message) {
+	const messageJson = JSON.stringify(message);
+	if (messageJson === void 0) throw new TypeError("Kirie IPC message root must serialize to a JSON string. See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#description for details.");
+	const androidBridge = globalThis.KirieAndroidBridge;
+	if (androidBridge) {
+		androidBridge.postMessage(messageJson);
+		return;
+	}
+	const iosBridge = globalThis.webkit?.messageHandlers?.kirie;
+	if (iosBridge) {
+		iosBridge.postMessage(messageJson);
+		return;
+	}
+	throw new Error("Kirie native IPC bridge is not available.");
+}
+function onIpcMessageReceived(handler) {
+	const listener = (event) => {
+		handler(event.detail);
+	};
+	globalThis.addEventListener(IPC_MESSAGE_EVENT, listener);
+	return () => {
+		globalThis.removeEventListener(IPC_MESSAGE_EVENT, listener);
+	};
+}
+//#endregion
+export { onIpcMessageReceived, sendIpcMessage };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["const IPC_MESSAGE_EVENT = \"kirie:ipc-message\";\n\ntype AndroidBridge = {\n  postMessage(messageJson: string): void;\n};\n\ntype IosBridge = {\n  postMessage(messageJson: string): void;\n};\n\ndeclare global {\n  var KirieAndroidBridge: AndroidBridge | undefined;\n\n  var webkit:\n    | {\n        messageHandlers?: {\n          kirie?: IosBridge;\n        };\n      }\n    | undefined;\n}\n\nexport type KirieIpcMessageHandler<TMessage = unknown> = (message: TMessage) => void;\n\nexport function sendIpcMessage(message: unknown): void {\n  const messageJson = JSON.stringify(message);\n  if (messageJson === undefined) {\n    throw new TypeError(\n      \"Kirie IPC message root must serialize to a JSON string. See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#description for details.\",\n    );\n  }\n\n  const androidBridge = globalThis.KirieAndroidBridge;\n  if (androidBridge) {\n    androidBridge.postMessage(messageJson);\n    return;\n  }\n\n  const iosBridge = globalThis.webkit?.messageHandlers?.kirie;\n  if (iosBridge) {\n    iosBridge.postMessage(messageJson);\n    return;\n  }\n\n  throw new Error(\"Kirie native IPC bridge is not available.\");\n}\n\nexport function onIpcMessageReceived<TMessage = unknown>(\n  handler: KirieIpcMessageHandler<TMessage>,\n): () => void {\n  const listener = (event: Event) => {\n    handler((event as CustomEvent<TMessage>).detail);\n  };\n\n  globalThis.addEventListener(IPC_MESSAGE_EVENT, listener);\n\n  return () => {\n    globalThis.removeEventListener(IPC_MESSAGE_EVENT, listener);\n  };\n}\n"],"mappings":";AAAA,MAAM,oBAAoB;AAwB1B,SAAgB,eAAe,SAAwB;CACrD,MAAM,cAAc,KAAK,UAAU,QAAQ;AAC3C,KAAI,gBAAgB,KAAA,EAClB,OAAM,IAAI,UACR,uLACD;CAGH,MAAM,gBAAgB,WAAW;AACjC,KAAI,eAAe;AACjB,gBAAc,YAAY,YAAY;AACtC;;CAGF,MAAM,YAAY,WAAW,QAAQ,iBAAiB;AACtD,KAAI,WAAW;AACb,YAAU,YAAY,YAAY;AAClC;;AAGF,OAAM,IAAI,MAAM,4CAA4C;;AAG9D,SAAgB,qBACd,SACY;CACZ,MAAM,YAAY,UAAiB;AACjC,UAAS,MAAgC,OAAO;;AAGlD,YAAW,iBAAiB,mBAAmB,SAAS;AAExD,cAAa;AACX,aAAW,oBAAoB,mBAAmB,SAAS"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@gd-kirie/ipc",
+  "version": "0.1.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/moeru-ai/godot-kirie.git",
+    "directory": "packages/ipc"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsdown": "^0.21.10",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}