@ontahi/runtime-nextjs 0.1.0-alpha.0 → 0.1.0-alpha.1

package/README.md

@@ -9,3 +9,18 @@ This package depends on `@ontahi/core` and owns the Next.js / `next-safe-action`
 3. `@ontahi/runtime-nextjs/operation-invocation`: an App Router `Request`/`Response` adapter for the transport-neutral operation invocation protocol from `@ontahi/core`.
 
 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.
+
+The operation route can derive an Ontahi invocation context from each web request. Authentication
+remains a host concern; the adapter receives only the resulting Principal:
+
+```ts
+const POST = createNextOperationInvocationRouteHandler({
+  dispatcher,
+  invocationContext: async request => ({
+    principal: await resolvePrincipal(request),
+  }),
+});
+```
+
+The Principal and resource map remain scoped to that invocation and are visible to operation
+requirements, execution, nested operations, and permission checks.

package/dist/operation-invocation/index.d.ts

@@ -1,2 +1,2 @@
-export { createNextOperationInvocationRouteHandler, type CreateNextOperationInvocationRouteHandlerOptions, } from './route.js';
+export { createNextOperationInvocationRouteHandler, type CreateNextOperationInvocationRouteHandlerOptions, type NextInvocationContextFactory, } from './route.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/operation-invocation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operation-invocation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yCAAyC,EACzC,KAAK,gDAAgD,GACtD,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/operation-invocation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yCAAyC,EACzC,KAAK,gDAAgD,EACrD,KAAK,4BAA4B,GAClC,MAAM,YAAY,CAAC"}

package/dist/operation-invocation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operation-invocation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yCAAyC,GAE1C,MAAM,YAAY,CAAC","sourcesContent":["export {\n  createNextOperationInvocationRouteHandler,\n  type CreateNextOperationInvocationRouteHandlerOptions,\n} from './route.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/operation-invocation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yCAAyC,GAG1C,MAAM,YAAY,CAAC","sourcesContent":["export {\n  createNextOperationInvocationRouteHandler,\n  type CreateNextOperationInvocationRouteHandlerOptions,\n  type NextInvocationContextFactory,\n} from './route.js';\n"]}

package/dist/operation-invocation/route.d.ts

@@ -1,7 +1,10 @@
 import { type OperationInvocationDispatcher } from '@ontahi/core/runtime/operation-invocation';
+import { type InvocationContextInput } from '@ontahi/core/runtime/server';
+export type NextInvocationContextFactory = (request: Request) => InvocationContextInput | Promise<InvocationContextInput>;
 export type CreateNextOperationInvocationRouteHandlerOptions = {
     dispatcher: OperationInvocationDispatcher;
+    invocationContext?: NextInvocationContextFactory;
     reportError?: (error: unknown, request: Request) => void;
 };
-export declare const createNextOperationInvocationRouteHandler: ({ dispatcher, reportError }: CreateNextOperationInvocationRouteHandlerOptions) => (request: Request) => Promise<Response>;
+export declare const createNextOperationInvocationRouteHandler: ({ dispatcher, invocationContext, reportError, }: CreateNextOperationInvocationRouteHandlerOptions) => (request: Request) => Promise<Response>;
 //# sourceMappingURL=route.d.ts.map

package/dist/operation-invocation/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/operation-invocation/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,6BAA6B,EAEnC,MAAM,2CAA2C,CAAC;AAEnD,MAAM,MAAM,gDAAgD,GAAG;IAC7D,UAAU,EAAE,6BAA6B,CAAC;IAC1C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D,CAAC;AAKF,eAAO,MAAM,yCAAyC,GACnD,6BAA6B,gDAAgD,MACvE,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAsBzC,CAAC"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/operation-invocation/route.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,6BAA6B,EAEnC,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAEjG,MAAM,MAAM,4BAA4B,GAAG,CACzC,OAAO,EAAE,OAAO,KACb,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAE9D,MAAM,MAAM,gDAAgD,GAAG;IAC7D,UAAU,EAAE,6BAA6B,CAAC;IAC1C,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IACjD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D,CAAC;AAKF,eAAO,MAAM,yCAAyC,GACnD,iDAIE,gDAAgD,MAC5C,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAyBzC,CAAC"}

package/dist/operation-invocation/route.js

@@ -1,12 +1,16 @@
 import { operationInvocationProtocolError, parseOperationInvocationRequest, } from '@ontahi/core/runtime/operation-invocation';
+import { withInvocationContext } from '@ontahi/core/runtime/server';
 const responseStatus = (response) => response.kind === 'protocol-error' ? 500 : 200;
-export const createNextOperationInvocationRouteHandler = ({ dispatcher, reportError }) => async (request) => {
+export const createNextOperationInvocationRouteHandler = ({ dispatcher, invocationContext, reportError, }) => async (request) => {
     const parsedRequest = parseOperationInvocationRequest(await request.json().catch(() => null));
     if (!parsedRequest.success) {
         return Response.json(parsedRequest.error, { status: 400 });
     }
     try {
-        const response = await dispatcher(parsedRequest.request);
+        const dispatch = () => dispatcher(parsedRequest.request);
+        const response = invocationContext
+            ? await withInvocationContext(await invocationContext(request), dispatch)
+            : await dispatch();
         return Response.json(response, { status: responseStatus(response) });
     }
     catch (error) {

package/dist/operation-invocation/route.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/operation-invocation/route.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,+BAA+B,GAGhC,MAAM,2CAA2C,CAAC;AAOnD,MAAM,cAAc,GAAG,CAAC,QAA6C,EAAE,EAAE,CACvE,QAAQ,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAEjD,MAAM,CAAC,MAAM,yCAAyC,GACpD,CAAC,EAAE,UAAU,EAAE,WAAW,EAAoD,EAAE,EAAE,CAClF,KAAK,EAAE,OAAgB,EAAqB,EAAE;IAC5C,MAAM,aAAa,GAAG,+BAA+B,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9F,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEzD,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAE9B,OAAO,QAAQ,CAAC,IAAI,CAClB,gCAAgC,CAC9B,wBAAwB,EACxB,kDAAkD,CACnD,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;AACH,CAAC,CAAC","sourcesContent":["import {\n  operationInvocationProtocolError,\n  parseOperationInvocationRequest,\n  type OperationInvocationDispatcher,\n  type OperationInvocationProtocolResponse,\n} from '@ontahi/core/runtime/operation-invocation';\n\nexport type CreateNextOperationInvocationRouteHandlerOptions = {\n  dispatcher: OperationInvocationDispatcher;\n  reportError?: (error: unknown, request: Request) => void;\n};\n\nconst responseStatus = (response: OperationInvocationProtocolResponse) =>\n  response.kind === 'protocol-error' ? 500 : 200;\n\nexport const createNextOperationInvocationRouteHandler =\n  ({ dispatcher, reportError }: CreateNextOperationInvocationRouteHandlerOptions) =>\n  async (request: Request): Promise<Response> => {\n    const parsedRequest = parseOperationInvocationRequest(await request.json().catch(() => null));\n\n    if (!parsedRequest.success) {\n      return Response.json(parsedRequest.error, { status: 400 });\n    }\n\n    try {\n      const response = await dispatcher(parsedRequest.request);\n\n      return Response.json(response, { status: responseStatus(response) });\n    } catch (error) {\n      reportError?.(error, request);\n\n      return Response.json(\n        operationInvocationProtocolError(\n          'invocation_unavailable',\n          'Operation invocation is temporarily unavailable.',\n        ),\n        { status: 500 },\n      );\n    }\n  };\n"]}
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/operation-invocation/route.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,+BAA+B,GAGhC,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAA+B,MAAM,6BAA6B,CAAC;AAYjG,MAAM,cAAc,GAAG,CAAC,QAA6C,EAAE,EAAE,CACvE,QAAQ,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAEjD,MAAM,CAAC,MAAM,yCAAyC,GACpD,CAAC,EACC,UAAU,EACV,iBAAiB,EACjB,WAAW,GACsC,EAAE,EAAE,CACvD,KAAK,EAAE,OAAgB,EAAqB,EAAE;IAC5C,MAAM,aAAa,GAAG,+BAA+B,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9F,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,iBAAiB;YAChC,CAAC,CAAC,MAAM,qBAAqB,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;YACzE,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC;QAErB,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAE9B,OAAO,QAAQ,CAAC,IAAI,CAClB,gCAAgC,CAC9B,wBAAwB,EACxB,kDAAkD,CACnD,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;IACJ,CAAC;AACH,CAAC,CAAC","sourcesContent":["import {\n  operationInvocationProtocolError,\n  parseOperationInvocationRequest,\n  type OperationInvocationDispatcher,\n  type OperationInvocationProtocolResponse,\n} from '@ontahi/core/runtime/operation-invocation';\nimport { withInvocationContext, type InvocationContextInput } from '@ontahi/core/runtime/server';\n\nexport type NextInvocationContextFactory = (\n  request: Request,\n) => InvocationContextInput | Promise<InvocationContextInput>;\n\nexport type CreateNextOperationInvocationRouteHandlerOptions = {\n  dispatcher: OperationInvocationDispatcher;\n  invocationContext?: NextInvocationContextFactory;\n  reportError?: (error: unknown, request: Request) => void;\n};\n\nconst responseStatus = (response: OperationInvocationProtocolResponse) =>\n  response.kind === 'protocol-error' ? 500 : 200;\n\nexport const createNextOperationInvocationRouteHandler =\n  ({\n    dispatcher,\n    invocationContext,\n    reportError,\n  }: CreateNextOperationInvocationRouteHandlerOptions) =>\n  async (request: Request): Promise<Response> => {\n    const parsedRequest = parseOperationInvocationRequest(await request.json().catch(() => null));\n\n    if (!parsedRequest.success) {\n      return Response.json(parsedRequest.error, { status: 400 });\n    }\n\n    try {\n      const dispatch = () => dispatcher(parsedRequest.request);\n      const response = invocationContext\n        ? await withInvocationContext(await invocationContext(request), dispatch)\n        : await dispatch();\n\n      return Response.json(response, { status: responseStatus(response) });\n    } catch (error) {\n      reportError?.(error, request);\n\n      return Response.json(\n        operationInvocationProtocolError(\n          'invocation_unavailable',\n          'Operation invocation is temporarily unavailable.',\n        ),\n        { status: 500 },\n      );\n    }\n  };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontahi/runtime-nextjs",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.1",
   "description": "Next.js action runtime and transport helpers for Ontahi applications",
   "homepage": "https://github.com/javifernandes/ontahi/tree/main/packages/runtime-nextjs",
   "license": "Apache-2.0",
@@ -49,7 +49,7 @@
     "next-safe-action": "^8.3.0",
     "server-only": "^0.0.1",
     "zod": "^4.3.6",
-    "@ontahi/core": "0.1.0-alpha.0"
+    "@ontahi/core": "0.1.0-alpha.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",