@gd-kirie/ipc-eventa 0.1.2

package/README.md

@@ -0,0 +1,48 @@
+# @gd-kirie/ipc-eventa
+
+Eventa adapter for Kirie WebView pages.
+
+The package connects upstream `@moeru/eventa` contexts to Kirie's low-level
+text IPC lane. Eventa messages are serialized as JSON text and sent through
+`@gd-kirie/ipc`; Kirie core remains a transport layer and does not learn
+Eventa semantics.
+
+This first transport is debug-first and text-based. A later binary or structured
+transport should use Kirie's CBOR-backed data or binary lane directly, exposed
+as an explicit opt-in before it becomes the default.
+
+## Events
+
+```ts
+import { defineEventa } from "@moeru/eventa";
+import { createContext } from "@gd-kirie/ipc-eventa";
+
+const move = defineEventa<{ x: number; y: number }>("player:move");
+const { context, dispose } = createContext();
+
+context.on(move, ({ body }) => {
+  console.log(body.x, body.y);
+});
+
+context.emit(move, { x: 100, y: 200 });
+
+dispose();
+```
+
+## Unary RPC
+
+```ts
+import { defineInvoke, defineInvokeEventa } from "@moeru/eventa";
+import { createContext } from "@gd-kirie/ipc-eventa";
+
+const lookupUser = defineInvokeEventa<{ id: string }, { name: string }>("user:lookup");
+const { context } = createContext();
+const invokeLookupUser = defineInvoke(context, lookupUser);
+
+const user = await invokeLookupUser({ name: "alice" });
+console.log(user.id);
+```
+
+Validate payloads at application boundaries before sending them to untrusted
+peers. The adapter forwards Eventa payloads as JSON text and does not perform
+application schema validation.

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { EventContext, EventTag, Eventa } from "@moeru/eventa";
+
+//#region src/index.d.ts
+interface KirieEventaMessage {
+  id: string;
+  type: EventTag<unknown, unknown>;
+  payload: Eventa<unknown>;
+}
+interface KirieEventaRawMessage {
+  raw: {
+    message: string;
+  };
+}
+type KirieEventaContext = EventContext<unknown, KirieEventaRawMessage>;
+interface KirieEventaContextHandle {
+  context: KirieEventaContext;
+  dispose: () => void;
+}
+declare function createContext(): KirieEventaContextHandle;
+//#endregion
+export { KirieEventaContext, KirieEventaContextHandle, KirieEventaMessage, createContext };
+//# 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":";;;UAYiB,kBAAA;EACf,EAAA;EACA,IAAA,EAAM,QAAA;EACN,OAAA,EAAS,MAAA;AAAA;AAAA,UAGD,qBAAA;EACR,GAAA;IACE,OAAA;EAAA;AAAA;AAAA,KAQQ,kBAAA,GAAqB,YAAA,UAAsB,qBAAA;AAAA,UAEtC,wBAAA;EACf,OAAA,EAAS,kBAAA;EACT,OAAA;AAAA;AAAA,iBAcc,aAAA,IAAiB,wBAAA"}

package/dist/index.js

@@ -0,0 +1,40 @@
+import { onTextReceived, sendText } from "@gd-kirie/ipc";
+import { EventaFlowDirection, and, createContext as createContext$1, defineInboundEventa, defineOutboundEventa, matchBy, nanoid } from "@moeru/eventa";
+//#region src/index.ts
+function createMessage(event) {
+	return {
+		id: nanoid(),
+		payload: {
+			...defineOutboundEventa(event.type),
+			...event
+		},
+		type: event.id
+	};
+}
+function createContext() {
+	const context = createContext$1();
+	const offOutbound = context.on(and(matchBy((event) => {
+		return event._flowDirection === EventaFlowDirection.Outbound || !event._flowDirection;
+	}), matchBy("*")), (event) => {
+		sendText(JSON.stringify(createMessage(event)));
+	});
+	const offInbound = onTextReceived((message) => {
+		try {
+			const parsed = JSON.parse(message);
+			context.emit(defineInboundEventa(parsed.type), parsed.payload.body, { raw: { message } });
+		} catch (error) {
+			console.error("Failed to parse Kirie Eventa message:", error);
+		}
+	});
+	return {
+		context,
+		dispose: () => {
+			offOutbound();
+			offInbound();
+		}
+	};
+}
+//#endregion
+export { createContext };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["createEventaContext"],"sources":["../src/index.ts"],"sourcesContent":["import { onTextReceived, sendText } from \"@gd-kirie/ipc\";\nimport type { Eventa, EventContext, EventTag } from \"@moeru/eventa\";\nimport {\n  and,\n  createContext as createEventaContext,\n  defineInboundEventa,\n  defineOutboundEventa,\n  EventaFlowDirection,\n  matchBy,\n  nanoid,\n} from \"@moeru/eventa\";\n\nexport interface KirieEventaMessage {\n  id: string;\n  type: EventTag<unknown, unknown>;\n  payload: Eventa<unknown>;\n}\n\ninterface KirieEventaRawMessage {\n  raw: {\n    message: string;\n  };\n}\n\ntype KirieDirectionalEvent = Eventa<unknown> & {\n  _flowDirection?: EventaFlowDirection;\n};\n\nexport type KirieEventaContext = EventContext<unknown, KirieEventaRawMessage>;\n\nexport interface KirieEventaContextHandle {\n  context: KirieEventaContext;\n  dispose: () => void;\n}\n\nfunction createMessage(event: Eventa<unknown>): KirieEventaMessage {\n  return {\n    id: nanoid(),\n    payload: {\n      ...defineOutboundEventa(event.type),\n      ...event,\n    },\n    type: event.id,\n  };\n}\n\nexport function createContext(): KirieEventaContextHandle {\n  const context = createEventaContext<unknown, KirieEventaRawMessage>();\n  const offOutbound = context.on(\n    and(\n      matchBy((event: KirieDirectionalEvent) => {\n        return event._flowDirection === EventaFlowDirection.Outbound || !event._flowDirection;\n      }),\n      matchBy(\"*\"),\n    ),\n    (event) => {\n      sendText(JSON.stringify(createMessage(event)));\n    },\n  );\n\n  const offInbound = onTextReceived((message) => {\n    try {\n      const parsed = JSON.parse(message) as KirieEventaMessage;\n      context.emit(defineInboundEventa(parsed.type), parsed.payload.body, {\n        raw: {\n          message,\n        },\n      });\n    } catch (error) {\n      console.error(\"Failed to parse Kirie Eventa message:\", error);\n    }\n  });\n\n  return {\n    context,\n    dispose: () => {\n      offOutbound();\n      offInbound();\n    },\n  };\n}\n"],"mappings":";;;AAmCA,SAAS,cAAc,OAA4C;CACjE,OAAO;EACL,IAAI,OAAO;EACX,SAAS;GACP,GAAG,qBAAqB,MAAM,IAAI;GAClC,GAAG;EACL;EACA,MAAM,MAAM;CACd;AACF;AAEA,SAAgB,gBAA0C;CACxD,MAAM,UAAUA,gBAAoD;CACpE,MAAM,cAAc,QAAQ,GAC1B,IACE,SAAS,UAAiC;EACxC,OAAO,MAAM,mBAAmB,oBAAoB,YAAY,CAAC,MAAM;CACzE,CAAC,GACD,QAAQ,GAAG,CACb,IACC,UAAU;EACT,SAAS,KAAK,UAAU,cAAc,KAAK,CAAC,CAAC;CAC/C,CACF;CAEA,MAAM,aAAa,gBAAgB,YAAY;EAC7C,IAAI;GACF,MAAM,SAAS,KAAK,MAAM,OAAO;GACjC,QAAQ,KAAK,oBAAoB,OAAO,IAAI,GAAG,OAAO,QAAQ,MAAM,EAClE,KAAK,EACH,QACF,EACF,CAAC;EACH,SAAS,OAAO;GACd,QAAQ,MAAM,yCAAyC,KAAK;EAC9D;CACF,CAAC;CAED,OAAO;EACL;EACA,eAAe;GACb,YAAY;GACZ,WAAW;EACb;CACF;AACF"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@gd-kirie/ipc-eventa",
+  "version": "0.1.2",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/moeru-ai/godot-kirie.git",
+    "directory": "packages/ipc-eventa"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@moeru/eventa": "^1.0.0-beta.3",
+    "@gd-kirie/ipc": "0.1.2"
+  },
+  "devDependencies": {
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.15"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test:run": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}