@ontahi/runtime-nextjs 1.0.0-alpha.12 → 1.0.0-alpha.14

package/README.md

@@ -13,6 +13,8 @@ This package depends on `@ontahi/core` and owns the Next.js / `next-safe-action`
 4. `@ontahi/runtime-nextjs/graph-read`: an App Router adapter for policy-scoped remote data graph reads.
 5. `@ontahi/runtime-nextjs/runtime-protocol`: an App Router adapter for an injected common Runtime
    Protocol dispatcher and receiver-owned context factory.
+6. `@ontahi/runtime-nextjs/event-ingress`: an App Router adapter that passes the original `Request`
+   to a provider for authentication and normalization before ingesting a declared Event.
 
 New generic consumers should import action metadata and result helpers from `@ontahi/core/runtime/actions`. React hooks and operation bridge adapters live in `@ontahi/react/actions` so this package can stay focused on Next.js runtime concerns.
 
@@ -126,3 +128,34 @@ export const POST = createNextGraphReadRouteHandler({
 Malformed graph programs return `400`, denied reads return `403`, unavailable execution returns
 `503`, and successful reads return `200`. Caller-provided authority in the request body is never
 used to authorize dispatch.
+
+## Event ingress
+
+Bind one App Router endpoint to an explicit Event declaration identity, provider, and channel. The
+provider receives the original Web `Request`, so signature verification can use the unmodified raw
+body before returning a normalized domain payload:
+
+```ts
+import { createNextEventIngressRouteHandler } from '@ontahi/runtime-nextjs/event-ingress';
+
+import { TodoApplication, TodoListExportReady } from '@/application';
+import { githubWebhookProvider } from '@/github-webhooks';
+
+export const POST = createNextEventIngressRouteHandler({
+  events: TodoApplication.events,
+  route: {
+    eventId: TodoListExportReady.id,
+    eventVersion: TodoListExportReady.version,
+    method: 'POST',
+    route: '/api/events/export-ready',
+    provider: 'github-webhook',
+    channel: 'todo.export-ready',
+  },
+  providers: { 'github-webhook': githubWebhookProvider },
+});
+```
+
+The provider owns authentication and normalization. Ontahi matches the accepted provider identity
+and channel against the explicit route, validates the payload against the registered declaration,
+and only then creates the Event occurrence. Rejected or ignored deliveries never materialize an
+occurrence.

package/dist/event-ingress/index.d.ts

@@ -0,0 +1,3 @@
+export { createNextEventIngressRouteHandler, type CreateNextEventIngressRouteHandlerOptions, } from './route.js';
+export type { GraphHttpEventIngressRoute, GraphHttpIngressProvider, GraphHttpIngressProviderRegistry, } from '@ontahi/core/runtime/server/ingress';
+//# sourceMappingURL=index.d.ts.map

package/dist/event-ingress/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-ingress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,EAClC,KAAK,yCAAyC,GAC/C,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,qCAAqC,CAAC"}

package/dist/event-ingress/index.js

@@ -0,0 +1,2 @@
+export { createNextEventIngressRouteHandler, } from './route.js';
+//# sourceMappingURL=index.js.map

package/dist/event-ingress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/event-ingress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kCAAkC,GAEnC,MAAM,YAAY,CAAC","sourcesContent":["export {\n  createNextEventIngressRouteHandler,\n  type CreateNextEventIngressRouteHandlerOptions,\n} from './route.js';\n\nexport type {\n  GraphHttpEventIngressRoute,\n  GraphHttpIngressProvider,\n  GraphHttpIngressProviderRegistry,\n} from '@ontahi/core/runtime/server/ingress';\n"]}

package/dist/event-ingress/route.d.ts

@@ -0,0 +1,10 @@
+import type { AnyEventDeclaration, EventApplication } from '@ontahi/core/runtime/server';
+import { type GraphHttpEventIngressRoute, type GraphHttpIngressProviderRegistry } from '@ontahi/core/runtime/server/ingress';
+export type CreateNextEventIngressRouteHandlerOptions = {
+    events: EventApplication<readonly AnyEventDeclaration[]>;
+    route: GraphHttpEventIngressRoute;
+    providers: GraphHttpIngressProviderRegistry;
+    reportError?: (error: unknown, request: Request) => void;
+};
+export declare const createNextEventIngressRouteHandler: (options: CreateNextEventIngressRouteHandlerOptions) => (request: Request) => Promise<Response>;
+//# sourceMappingURL=route.d.ts.map

package/dist/event-ingress/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/event-ingress/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACtC,MAAM,qCAAqC,CAAC;AAE7C,MAAM,MAAM,yCAAyC,GAAG;IACtD,MAAM,EAAE,gBAAgB,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;IACzD,KAAK,EAAE,0BAA0B,CAAC;IAClC,SAAS,EAAE,gCAAgC,CAAC;IAC5C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D,CAAC;AAUF,eAAO,MAAM,kCAAkC,GAC7C,SAAS,yCAAyC,MAapC,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAYlD,CAAC"}

package/dist/event-ingress/route.js

@@ -0,0 +1,31 @@
+import { createGraphHttpEventIngressDispatcher, createGraphHttpEventIngressRouter, } from '@ontahi/core/runtime/server/ingress';
+const unavailableResponse = () => Response.json({ ok: false, error: 'Event ingress is temporarily unavailable.' }, { status: 500 });
+const responseError = async (response) => {
+    const body = (await response.clone().json());
+    return new Error(body.error);
+};
+export const createNextEventIngressRouteHandler = (options) => {
+    const reportError = options.reportError ??
+        ((error) => {
+            globalThis.console.error('Ontahi Next.js Event ingress failed.', error);
+        });
+    const router = createGraphHttpEventIngressRouter({
+        routes: [options.route],
+        providers: options.providers,
+        dispatch: createGraphHttpEventIngressDispatcher({ events: options.events }),
+    });
+    return async (request) => {
+        try {
+            const response = await router.handle(request);
+            if (response.status !== 500)
+                return response;
+            reportError(await responseError(response), request);
+            return unavailableResponse();
+        }
+        catch (error) {
+            reportError(error, request);
+            return unavailableResponse();
+        }
+    };
+};
+//# sourceMappingURL=route.js.map

package/dist/event-ingress/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/event-ingress/route.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qCAAqC,EACrC,iCAAiC,GAGlC,MAAM,qCAAqC,CAAC;AAS7C,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAEpG,MAAM,aAAa,GAAG,KAAK,EAAE,QAAkB,EAAE,EAAE;IACjD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAsB,CAAC;IAClE,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAChD,OAAkD,EAClD,EAAE;IACF,MAAM,WAAW,GACf,OAAO,CAAC,WAAW;QACnB,CAAC,CAAC,KAAc,EAAE,EAAE;YAClB,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,MAAM,MAAM,GAAG,iCAAiC,CAAC;QAC/C,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACvB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,qCAAqC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;KAC5E,CAAC,CAAC;IAEH,OAAO,KAAK,EAAE,OAAgB,EAAqB,EAAE;QACnD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,QAAQ,CAAC;YAE7C,WAAW,CAAC,MAAM,aAAa,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,mBAAmB,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5B,OAAO,mBAAmB,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import type { AnyEventDeclaration, EventApplication } from '@ontahi/core/runtime/server';\nimport {\n  createGraphHttpEventIngressDispatcher,\n  createGraphHttpEventIngressRouter,\n  type GraphHttpEventIngressRoute,\n  type GraphHttpIngressProviderRegistry,\n} from '@ontahi/core/runtime/server/ingress';\n\nexport type CreateNextEventIngressRouteHandlerOptions = {\n  events: EventApplication<readonly AnyEventDeclaration[]>;\n  route: GraphHttpEventIngressRoute;\n  providers: GraphHttpIngressProviderRegistry;\n  reportError?: (error: unknown, request: Request) => void;\n};\n\nconst unavailableResponse = () =>\n  Response.json({ ok: false, error: 'Event ingress is temporarily unavailable.' }, { status: 500 });\n\nconst responseError = async (response: Response) => {\n  const body = (await response.clone().json()) as { error: string };\n  return new Error(body.error);\n};\n\nexport const createNextEventIngressRouteHandler = (\n  options: CreateNextEventIngressRouteHandlerOptions,\n) => {\n  const reportError =\n    options.reportError ??\n    ((error: unknown) => {\n      globalThis.console.error('Ontahi Next.js Event ingress failed.', error);\n    });\n  const router = createGraphHttpEventIngressRouter({\n    routes: [options.route],\n    providers: options.providers,\n    dispatch: createGraphHttpEventIngressDispatcher({ events: options.events }),\n  });\n\n  return async (request: Request): Promise<Response> => {\n    try {\n      const response = await router.handle(request);\n      if (response.status !== 500) return response;\n\n      reportError(await responseError(response), request);\n      return unavailableResponse();\n    } catch (error) {\n      reportError(error, request);\n      return unavailableResponse();\n    }\n  };\n};\n"]}

package/dist/runtime-protocol/route.d.ts

@@ -1,9 +1,11 @@
 import { type RuntimeProtocolDispatcher } from '@ontahi/core/runtime/protocol';
+import type { ApplicationRuntimeProtocol } from '@ontahi/core/runtime/server';
 export type NextRuntimeProtocolContextFactory<TContext> = (request: Request) => TContext | Promise<TContext>;
 export type CreateNextRuntimeProtocolRouteHandlerOptions<TContext> = {
-    dispatcher: RuntimeProtocolDispatcher<TContext>;
+    dispatcher?: RuntimeProtocolDispatcher<TContext>;
+    receiver?: ApplicationRuntimeProtocol<TContext>;
     context: NextRuntimeProtocolContextFactory<TContext>;
     reportError?: (error: unknown, request: Request) => void;
 };
-export declare const createNextRuntimeProtocolRouteHandler: <TContext>({ dispatcher, context, reportError, }: CreateNextRuntimeProtocolRouteHandlerOptions<TContext>) => (request: Request) => Promise<Response>;
+export declare const createNextRuntimeProtocolRouteHandler: <TContext>({ dispatcher, receiver, context, reportError, }: CreateNextRuntimeProtocolRouteHandlerOptions<TContext>) => (request: Request) => Promise<Response>;
 //# sourceMappingURL=route.d.ts.map

package/dist/runtime-protocol/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/runtime-protocol/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,yBAAyB,EAC/B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,iCAAiC,CAAC,QAAQ,IAAI,CACxD,OAAO,EAAE,OAAO,KACb,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElC,MAAM,MAAM,4CAA4C,CAAC,QAAQ,IAAI;IACnE,UAAU,EAAE,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,EAAE,iCAAiC,CAAC,QAAQ,CAAC,CAAC;IACrD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D,CAAC;AAsBF,eAAO,MAAM,qCAAqC,GAC/C,QAAQ,EAAE,uCAIR,4CAA4C,CAAC,QAAQ,CAAC,MAClD,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAqBzC,CAAC"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/runtime-protocol/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,yBAAyB,EAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,MAAM,MAAM,iCAAiC,CAAC,QAAQ,IAAI,CACxD,OAAO,EAAE,OAAO,KACb,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElC,MAAM,MAAM,4CAA4C,CAAC,QAAQ,IAAI;IACnE,UAAU,CAAC,EAAE,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,EAAE,iCAAiC,CAAC,QAAQ,CAAC,CAAC;IACrD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D,CAAC;AAsBF,eAAO,MAAM,qCAAqC,GAAI,QAAQ,EAAE,iDAK7D,4CAA4C,CAAC,QAAQ,CAAC,MAIzC,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAwBlD,CAAC"}

package/dist/runtime-protocol/route.js

@@ -17,18 +17,25 @@ const responseStatus = (result) => {
     }
 };
 const registry = createRuntimeProtocolRegistry(runtimeProtocolFamilies);
-export const createNextRuntimeProtocolRouteHandler = ({ dispatcher, context, reportError, }) => async (request) => {
-    const parsed = registry.parseRequest(await request.json().catch(() => null));
-    if (!parsed.success) {
-        return Response.json(parsed.error, { status: responseStatus(parsed.error) });
-    }
-    try {
-        const result = await dispatcher(parsed.request, await context(request));
-        return Response.json(result, { status: responseStatus(result) });
-    }
-    catch (error) {
-        reportError?.(error, request);
-        return Response.json(runtimeProtocolError('dispatch_unavailable', 'Runtime Protocol dispatch is temporarily unavailable.', { id: parsed.request.id, family: parsed.request.family }), { status: 503 });
-    }
+export const createNextRuntimeProtocolRouteHandler = ({ dispatcher, receiver, context, reportError, }) => {
+    const dispatch = receiver?.dispatcher ?? dispatcher;
+    if (!dispatch)
+        throw new TypeError('Runtime Protocol requires a receiver or dispatcher.');
+    return async (request) => {
+        const parsed = registry.parseRequest(await request.json().catch(() => null));
+        if (!parsed.success) {
+            return Response.json(parsed.error, { status: responseStatus(parsed.error) });
+        }
+        try {
+            const result = await dispatch(parsed.request, await context(request), {
+                signal: request.signal,
+            });
+            return Response.json(result, { status: responseStatus(result) });
+        }
+        catch (error) {
+            reportError?.(error, request);
+            return Response.json(runtimeProtocolError('dispatch_unavailable', 'Runtime Protocol dispatch is temporarily unavailable.', { id: parsed.request.id, family: parsed.request.family }), { status: 503 });
+        }
+    };
 };
 //# sourceMappingURL=route.js.map

package/dist/runtime-protocol/route.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/runtime-protocol/route.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,uBAAuB,GAGxB,MAAM,+BAA+B,CAAC;AAYvC,MAAM,cAAc,GAAG,CAAC,MAAqC,EAAE,EAAE;IAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,GAAG,CAAC;IAEjD,QAAQ,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,kBAAkB,CAAC;QACxB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,gBAAgB,CAAC;QACtB,KAAK,wBAAwB;YAC3B,OAAO,GAAG,CAAC;QACb,KAAK,oBAAoB;YACvB,OAAO,GAAG,CAAC;QACb,KAAK,sBAAsB;YACzB,OAAO,GAAG,CAAC;QACb,KAAK,kBAAkB;YACrB,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,6BAA6B,CAAC,uBAAuB,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,qCAAqC,GAChD,CAAW,EACT,UAAU,EACV,OAAO,EACP,WAAW,GAC4C,EAAE,EAAE,CAC7D,KAAK,EAAE,OAAgB,EAAqB,EAAE;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACxE,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAE9B,OAAO,QAAQ,CAAC,IAAI,CAClB,oBAAoB,CAClB,sBAAsB,EACtB,uDAAuD,EACvD,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CACzD,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;AACH,CAAC,CAAC","sourcesContent":["import {\n  createRuntimeProtocolRegistry,\n  runtimeProtocolError,\n  runtimeProtocolFamilies,\n  type RuntimeProtocolDispatchResult,\n  type RuntimeProtocolDispatcher,\n} from '@ontahi/core/runtime/protocol';\n\nexport type NextRuntimeProtocolContextFactory<TContext> = (\n  request: Request,\n) => TContext | Promise<TContext>;\n\nexport type CreateNextRuntimeProtocolRouteHandlerOptions<TContext> = {\n  dispatcher: RuntimeProtocolDispatcher<TContext>;\n  context: NextRuntimeProtocolContextFactory<TContext>;\n  reportError?: (error: unknown, request: Request) => void;\n};\n\nconst responseStatus = (result: RuntimeProtocolDispatchResult) => {\n  if (result.kind !== 'protocol-error') return 200;\n\n  switch (result.error.code) {\n    case 'invalid_envelope':\n    case 'unsupported_version':\n    case 'unknown_family':\n    case 'invalid_family_request':\n      return 400;\n    case 'family_unavailable':\n      return 501;\n    case 'dispatch_unavailable':\n      return 503;\n    case 'invalid_response':\n      return 502;\n  }\n};\n\nconst registry = createRuntimeProtocolRegistry(runtimeProtocolFamilies);\n\nexport const createNextRuntimeProtocolRouteHandler =\n  <TContext>({\n    dispatcher,\n    context,\n    reportError,\n  }: CreateNextRuntimeProtocolRouteHandlerOptions<TContext>) =>\n  async (request: Request): Promise<Response> => {\n    const parsed = registry.parseRequest(await request.json().catch(() => null));\n    if (!parsed.success) {\n      return Response.json(parsed.error, { status: responseStatus(parsed.error) });\n    }\n\n    try {\n      const result = await dispatcher(parsed.request, await context(request));\n      return Response.json(result, { status: responseStatus(result) });\n    } catch (error) {\n      reportError?.(error, request);\n\n      return Response.json(\n        runtimeProtocolError(\n          'dispatch_unavailable',\n          'Runtime Protocol dispatch is temporarily unavailable.',\n          { id: parsed.request.id, family: parsed.request.family },\n        ),\n        { status: 503 },\n      );\n    }\n  };\n"]}
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/runtime-protocol/route.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,EACpB,uBAAuB,GAGxB,MAAM,+BAA+B,CAAC;AAcvC,MAAM,cAAc,GAAG,CAAC,MAAqC,EAAE,EAAE;IAC/D,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,GAAG,CAAC;IAEjD,QAAQ,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1B,KAAK,kBAAkB,CAAC;QACxB,KAAK,qBAAqB,CAAC;QAC3B,KAAK,gBAAgB,CAAC;QACtB,KAAK,wBAAwB;YAC3B,OAAO,GAAG,CAAC;QACb,KAAK,oBAAoB;YACvB,OAAO,GAAG,CAAC;QACb,KAAK,sBAAsB;YACzB,OAAO,GAAG,CAAC;QACb,KAAK,kBAAkB;YACrB,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,6BAA6B,CAAC,uBAAuB,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAW,EAC9D,UAAU,EACV,QAAQ,EACR,OAAO,EACP,WAAW,GAC4C,EAAE,EAAE;IAC3D,MAAM,QAAQ,GAAG,QAAQ,EAAE,UAAU,IAAI,UAAU,CAAC;IACpD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAE1F,OAAO,KAAK,EAAE,OAAgB,EAAqB,EAAE;QACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE;gBACpE,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE9B,OAAO,QAAQ,CAAC,IAAI,CAClB,oBAAoB,CAClB,sBAAsB,EACtB,uDAAuD,EACvD,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CACzD,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import {\n  createRuntimeProtocolRegistry,\n  runtimeProtocolError,\n  runtimeProtocolFamilies,\n  type RuntimeProtocolDispatchResult,\n  type RuntimeProtocolDispatcher,\n} from '@ontahi/core/runtime/protocol';\nimport type { ApplicationRuntimeProtocol } from '@ontahi/core/runtime/server';\n\nexport type NextRuntimeProtocolContextFactory<TContext> = (\n  request: Request,\n) => TContext | Promise<TContext>;\n\nexport type CreateNextRuntimeProtocolRouteHandlerOptions<TContext> = {\n  dispatcher?: RuntimeProtocolDispatcher<TContext>;\n  receiver?: ApplicationRuntimeProtocol<TContext>;\n  context: NextRuntimeProtocolContextFactory<TContext>;\n  reportError?: (error: unknown, request: Request) => void;\n};\n\nconst responseStatus = (result: RuntimeProtocolDispatchResult) => {\n  if (result.kind !== 'protocol-error') return 200;\n\n  switch (result.error.code) {\n    case 'invalid_envelope':\n    case 'unsupported_version':\n    case 'unknown_family':\n    case 'invalid_family_request':\n      return 400;\n    case 'family_unavailable':\n      return 501;\n    case 'dispatch_unavailable':\n      return 503;\n    case 'invalid_response':\n      return 502;\n  }\n};\n\nconst registry = createRuntimeProtocolRegistry(runtimeProtocolFamilies);\n\nexport const createNextRuntimeProtocolRouteHandler = <TContext>({\n  dispatcher,\n  receiver,\n  context,\n  reportError,\n}: CreateNextRuntimeProtocolRouteHandlerOptions<TContext>) => {\n  const dispatch = receiver?.dispatcher ?? dispatcher;\n  if (!dispatch) throw new TypeError('Runtime Protocol requires a receiver or dispatcher.');\n\n  return async (request: Request): Promise<Response> => {\n    const parsed = registry.parseRequest(await request.json().catch(() => null));\n    if (!parsed.success) {\n      return Response.json(parsed.error, { status: responseStatus(parsed.error) });\n    }\n\n    try {\n      const result = await dispatch(parsed.request, await context(request), {\n        signal: request.signal,\n      });\n      return Response.json(result, { status: responseStatus(result) });\n    } catch (error) {\n      reportError?.(error, request);\n\n      return Response.json(\n        runtimeProtocolError(\n          'dispatch_unavailable',\n          'Runtime Protocol dispatch is temporarily unavailable.',\n          { id: parsed.request.id, family: parsed.request.family },\n        ),\n        { status: 503 },\n      );\n    }\n  };\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontahi/runtime-nextjs",
-  "version": "1.0.0-alpha.12",
+  "version": "1.0.0-alpha.14",
   "description": "Next.js runtime and transport adapters for Ontahi applications",
   "homepage": "https://github.com/javifernandes/ontahi/tree/main/packages/runtime-nextjs",
   "license": "Apache-2.0",
@@ -48,6 +48,11 @@
       "types": "./dist/runtime-protocol/index.d.ts",
       "import": "./dist/runtime-protocol/index.js",
       "require": "./dist/runtime-protocol/index.js"
+    },
+    "./event-ingress": {
+      "types": "./dist/event-ingress/index.d.ts",
+      "import": "./dist/event-ingress/index.js",
+      "require": "./dist/event-ingress/index.js"
     }
   },
   "publishConfig": {
@@ -55,15 +60,15 @@
     "provenance": true
   },
   "dependencies": {
-    "@ontahi/core": "1.0.0-alpha.12",
+    "@ontahi/core": "1.0.0-alpha.14",
     "effect": "^3.21.0",
     "next-safe-action": "^8.3.0",
     "server-only": "^0.0.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@ontahi/react": "1.0.0-alpha.12",
-    "@ontahi/runtime-express": "1.0.0-alpha.12",
+    "@ontahi/react": "1.0.0-alpha.14",
+    "@ontahi/runtime-express": "1.0.0-alpha.14",
     "@types/node": "^20.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",