@prophet-ontology/events-runtime 0.1.0

package/README.md

@@ -0,0 +1,85 @@
+# @prophet-ontology/events-runtime
+
+`@prophet-ontology/events-runtime` is the shared Node runtime contract used by Prophet-generated action services.
+
+It defines:
+- an async `EventPublisher` interface
+- a canonical `EventWireEnvelope` shape
+- utility helpers (`createEventId`, `nowIso`)
+- a `NoOpEventPublisher` for local wiring and tests
+
+## Install
+
+```bash
+npm install @prophet-ontology/events-runtime
+```
+
+## API
+
+```ts
+export interface EventWireEnvelope {
+  event_id: string;
+  trace_id: string;
+  event_type: string;
+  schema_version: string;
+  occurred_at: string;
+  source: string;
+  payload: Record<string, unknown>;
+  attributes?: Record<string, string>;
+}
+
+export interface EventPublisher {
+  publish(envelope: EventWireEnvelope): Promise<void>;
+  publishBatch(envelopes: EventWireEnvelope[]): Promise<void>;
+}
+```
+
+Exports:
+- `createEventId(): string`
+- `nowIso(): string`
+- `NoOpEventPublisher`
+
+## Implement a Platform Publisher
+
+```ts
+import type { EventPublisher, EventWireEnvelope } from "@prophet-ontology/events-runtime";
+
+type PlatformClient = {
+  sendEvent(payload: unknown): Promise<void>;
+  sendEvents(payloads: unknown[]): Promise<void>;
+};
+
+export class PlatformEventPublisher implements EventPublisher {
+  constructor(private readonly client: PlatformClient) {}
+
+  async publish(envelope: EventWireEnvelope): Promise<void> {
+    await this.client.sendEvent(envelope);
+  }
+
+  async publishBatch(envelopes: EventWireEnvelope[]): Promise<void> {
+    await this.client.sendEvents(envelopes);
+  }
+}
+```
+
+## With Prophet-Generated Code
+
+Generated Node action services call `publish`/`publishBatch` after successful handler execution.
+If you do not provide an implementation, you can wire `NoOpEventPublisher` for local development.
+
+## Local Validation
+
+From repository root:
+
+```bash
+npm --prefix prophet-lib/javascript test
+npm --prefix prophet-lib/javascript pack --dry-run
+```
+
+## More Information
+
+- Runtime index: https://github.com/Chainso/prophet/tree/main/prophet-lib
+- Event wire contract: https://github.com/Chainso/prophet/tree/main/prophet-lib/specs/wire-contract.md
+- Event wire JSON schema: https://github.com/Chainso/prophet/tree/main/prophet-lib/specs/wire-event-envelope.schema.json
+- Node/Express reference: https://github.com/Chainso/prophet/tree/main/docs/reference/node-express.md
+- Example app: https://github.com/Chainso/prophet/tree/main/examples/node/prophet_example_express_prisma

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export interface EventWireEnvelope {
+  event_id: string;
+  trace_id: string;
+  event_type: string;
+  schema_version: string;
+  occurred_at: string;
+  source: string;
+  payload: Record<string, unknown>;
+  attributes?: Record<string, string>;
+}
+
+export interface EventPublisher {
+  publish(envelope: EventWireEnvelope): Promise<void>;
+  publishBatch(envelopes: EventWireEnvelope[]): Promise<void>;
+}
+
+export declare function createEventId(): string;
+export declare function nowIso(): string;
+
+export declare class NoOpEventPublisher implements EventPublisher {
+  publish(envelope: EventWireEnvelope): Promise<void>;
+  publishBatch(envelopes: EventWireEnvelope[]): Promise<void>;
+}

package/dist/index.js

@@ -0,0 +1,19 @@
+import { randomUUID } from 'node:crypto';
+
+export function createEventId() {
+  return randomUUID();
+}
+
+export function nowIso() {
+  return new Date().toISOString();
+}
+
+export class NoOpEventPublisher {
+  async publish(_envelope) {
+    return;
+  }
+
+  async publishBatch(_envelopes) {
+    return;
+  }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@prophet-ontology/events-runtime",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "node --test"
+  }
+}