@nifrajs/core 2.14.1 → 3.2.0

package/dist/errors.d.ts

@@ -8,7 +8,7 @@ export declare class FrameworkError extends Error {
     constructor(code: string, message: string);
 }
 /** Stable codes for boot-time (L2) route configuration failures. */
-export type RouteConfigErrorCode = "DUPLICATE_ROUTE" | "DUPLICATE_PARAM" | "PARAM_NAME_CONFLICT" | "INVALID_PATH" | "INVALID_PARAM_NAME" | "WILDCARD_NOT_LAST" | "INVALID_METHOD" | "INVALID_ASSURANCE" | "INVALID_IDEMPOTENCY" | "INVALID_BODY_LIMIT";
+export type RouteConfigErrorCode = "DUPLICATE_ROUTE" | "DUPLICATE_PARAM" | "PARAM_NAME_CONFLICT" | "INVALID_PATH" | "INVALID_PARAM_NAME" | "WILDCARD_NOT_LAST" | "INVALID_METHOD" | "INVALID_ASSURANCE" | "INVALID_IDEMPOTENCY" | "INVALID_WS_SEND_VALIDATION" | "INVALID_BODY_LIMIT";
 /**
  * Thrown at route registration when a route is misconfigured. This is the
  * boot-time rejection layer: loud and early,

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,iBAAiB,GACjB,qBAAqB,GACrB,cAAc,GACd,oBAAoB,GACpB,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,CAAA;AAExB;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAElD,SAAiB,IAAI,EAAE,oBAAoB,CAAA;gBAE/B,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAIxD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,iBAAiB,GACjB,qBAAqB,GACrB,cAAc,GACd,oBAAoB,GACpB,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,4BAA4B,GAC5B,oBAAoB,CAAA;AAExB;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAElD,SAAiB,IAAI,EAAE,oBAAoB,CAAA;gBAE/B,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAIxD"}

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAQ;IAErB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC,CAAA;QACvC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAeD;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAIlD,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAQ;IAErB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC,CAAA;QACvC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAgBD;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAIlD,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF"}

package/dist/index.d.ts

@@ -3,13 +3,34 @@
  *
  * Nifra 2.0 keeps the package root intentionally lean. Optional systems live at documented
  * subpaths so importing the root cannot activate unrelated runtimes.
+ *
+ * Every named export below is re-exported in a SINGLE hop from the module that defines it -
+ * deliberately not `export * from "./server.js"`. A root binding that travels through a chained
+ * barrel can be dropped by a bundler that rewrites module loads (the single-copy plugin does
+ * exactly that), which surfaces as a runtime `ReferenceError` only in bundled output. The list
+ * must stay identical to `./server.ts`; `server-entry.test.ts` enforces the parity.
  */
 /**
  * Current package version. A hardcoded literal on purpose - core runs on the edge (no fs), so it can't
  * read its own package.json at runtime. `scripts/version.ts` rewrites it on every release bump and
  * `check:publish` asserts it equals `@nifrajs/core`'s package version.
  */
-export declare const VERSION: "2.14.1";
+export declare const VERSION: "3.2.0";
 export type Version = typeof VERSION;
-export * from "./server.js";
+export { FrameworkError, RouteConfigError, type RouteConfigErrorCode } from "./errors.js";
+export { FRAMEWORK_NAME, type FrameworkName } from "./internal/brand.js";
+export { isSameOriginRequest } from "./internal/same-origin.js";
+export { METHODS, type Method, Router, type RouterMatch } from "./router/router.js";
+export type { InferInput, InferOutput, StandardIssue, StandardResult, StandardSchemaV1, StandardTypes, ValidationOutcome, } from "./schema/standard.js";
+export type { Context, Params, Platform, Prettify, ResponseControls, RouteSchema, } from "./server/context.js";
+export { type CookieOptions, type CookieSecret, cookieNamePrefix, parseCookies, serializeCookie, signValue, unsignValue, } from "./server/cookies.js";
+export { type DurableObjectNamespaceLike, type ExecutionContext, type ScheduledController, type ScheduledHandler, toFetchHandler, } from "./server/edge.js";
+export { isSameOriginPath, pathnameOf, type UrlParts, urlPartsOf } from "./server/http.js";
+export { commonSecretPatterns, jsonLogger, type LogFields, type Logger, type RedactOptions, redactLogFields, silentLogger, } from "./server/logger.js";
+export { type FetchApp, type LambdaEvent, type LambdaHandler, type LambdaResponse, type LambdaV1Event, type LambdaV2Event, type NetlifyEvent, type NetlifyHandler, type PlatformResponse, toLambdaHandler, toNetlifyHandler, toVercelHandler, type VercelHandler, } from "./server/platform-adapters.js";
+export type { Registry, ResponseMapFor, RouteInfo, RouteInfoFor } from "./server/registry.js";
+export { type PlainRender, type ResponseResult, type StatusResponse, status, } from "./server/runtime-core.js";
+export { type AdmissionController, type AdmissionDecision, type AnyServer, type ContextPlugin, type DefinePluginResult, defineContextPlugin, defineIdentityPlugin, definePlugin, defineRouterPlugin, type Handler, type IdentityPlugin, type McpPromptDescriptor, type McpResourceDescriptor, type Middleware, type NifraFeatureVersion, type NifraPlugin, type NodeRequestContext, type NodeRequestHook, type NodeResponseContext, type NodeResponseHook, type NodeServeOutcome, type OnRequestResult, type PluginTypeCollapsed, type PromptArgument, type PromptMessage, type ResponseBodyHook, type ResponseBodyReplacement, type ResponseFinalization, type ResponseHeadersHook, type ResponseHeadersView, type RouteDescriptor, type RunningServer, Server, type ServerOptions, server, type ToolAnnotations, } from "./server/server.js";
+export type { SSEContext, SSEInit, SSEMessage, SSEStream, TypedSSEStream, } from "./server/sse.js";
+export type { NifraWebSocket, StandardWebSocket, WebSocketContext, WebSocketData, WebSocketHandler, WebSocketUpgradeOutcome, } from "./server/websocket.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAG,QAAiB,CAAA;AAExC,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAA;AAEpC,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -3,12 +3,28 @@
  *
  * Nifra 2.0 keeps the package root intentionally lean. Optional systems live at documented
  * subpaths so importing the root cannot activate unrelated runtimes.
+ *
+ * Every named export below is re-exported in a SINGLE hop from the module that defines it -
+ * deliberately not `export * from "./server.ts"`. A root binding that travels through a chained
+ * barrel can be dropped by a bundler that rewrites module loads (the single-copy plugin does
+ * exactly that), which surfaces as a runtime `ReferenceError` only in bundled output. The list
+ * must stay identical to `./server.ts`; `server-entry.test.ts` enforces the parity.
  */
 /**
  * Current package version. A hardcoded literal on purpose - core runs on the edge (no fs), so it can't
  * read its own package.json at runtime. `scripts/version.ts` rewrites it on every release bump and
  * `check:publish` asserts it equals `@nifrajs/core`'s package version.
  */
-export const VERSION = "2.14.1";
-export * from "./server.js";
+export const VERSION = "3.2.0";
+export { FrameworkError, RouteConfigError } from "./errors.js";
+export { FRAMEWORK_NAME } from "./internal/brand.js";
+export { isSameOriginRequest } from "./internal/same-origin.js";
+export { METHODS, Router } from "./router/router.js";
+export { cookieNamePrefix, parseCookies, serializeCookie, signValue, unsignValue, } from "./server/cookies.js";
+export { toFetchHandler, } from "./server/edge.js";
+export { isSameOriginPath, pathnameOf, urlPartsOf } from "./server/http.js";
+export { commonSecretPatterns, jsonLogger, redactLogFields, silentLogger, } from "./server/logger.js";
+export { toLambdaHandler, toNetlifyHandler, toVercelHandler, } from "./server/platform-adapters.js";
+export { status, } from "./server/runtime-core.js";
+export { defineContextPlugin, defineIdentityPlugin, definePlugin, defineRouterPlugin, Server, server, } from "./server/server.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAiB,CAAA;AAIxC,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAgB,CAAA;AAIvC,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAA6B,MAAM,aAAa,CAAA;AACzF,OAAO,EAAE,cAAc,EAAsB,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAe,MAAM,EAAoB,MAAM,oBAAoB,CAAA;AAkBnF,OAAO,EAGL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,SAAS,EACT,WAAW,GACZ,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAKL,cAAc,GACf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAiB,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC1F,OAAO,EACL,oBAAoB,EACpB,UAAU,EAIV,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAUL,eAAe,EACf,gBAAgB,EAChB,eAAe,GAEhB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAIL,MAAM,GACP,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAML,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAwBlB,MAAM,EAEN,MAAM,GAEP,MAAM,oBAAoB,CAAA"}

package/dist/internal/durable-approval-protocol.d.ts

@@ -1,4 +1,4 @@
-import type { ApprovalConsumeResult, ApprovalRecord, ApprovalStore } from "../durable-execution.js";
+import type { ApprovalConsumeResult, ApprovalRecord, ApprovalStore } from "./durable-types.js";
 export type DurableApprovalDecisionInput = Parameters<ApprovalStore["decide"]>[0];
 export type DurableApprovalConsumeInput = Parameters<ApprovalStore["consume"]>[0];
 export interface DurableApprovalConsumeTransition {

package/dist/internal/durable-approval-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable-approval-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/durable-approval-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAGnG,MAAM,MAAM,4BAA4B,GAAG,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACjF,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEjF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CACJ,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,KAAK,EAAE,4BAA4B,GAClC,cAAc,GAAG,SAAS,CAAA;IAC7B,OAAO,CACL,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,KAAK,EAAE,2BAA2B,GACjC,gCAAgC,CAAA;CACpC;AAoED,eAAO,MAAM,uBAAuB,EAAE,uBAGpC,CAAA"}
+{"version":3,"file":"durable-approval-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/durable-approval-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAG9F,MAAM,MAAM,4BAA4B,GAAG,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACjF,MAAM,MAAM,2BAA2B,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEjF,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CACJ,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,KAAK,EAAE,4BAA4B,GAClC,cAAc,GAAG,SAAS,CAAA;IAC7B,OAAO,CACL,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,KAAK,EAAE,2BAA2B,GACjC,gCAAgC,CAAA;CACpC;AAoED,eAAO,MAAM,uBAAuB,EAAE,uBAGpC,CAAA"}

package/dist/internal/durable-effect-protocol.d.ts

@@ -1,4 +1,4 @@
-import type { DurableEffectRecord, DurableEffectState } from "../durable-execution.js";
+import type { DurableEffectRecord, DurableEffectState } from "./durable-types.js";
 export interface DurableEffectTransitionInput {
     readonly effectId: string;
     readonly version: number;

package/dist/internal/durable-effect-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable-effect-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/durable-effect-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEtF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CACR,OAAO,EAAE,mBAAmB,GAAG,SAAS,EACxC,KAAK,EAAE,4BAA4B,GAClC,mBAAmB,GAAG,SAAS,CAAA;CACnC;AAkBD,eAAO,MAAM,qBAAqB,EAAE,qBAElC,CAAA"}
+{"version":3,"file":"durable-effect-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/durable-effect-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEjF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CACR,OAAO,EAAE,mBAAmB,GAAG,SAAS,EACxC,KAAK,EAAE,4BAA4B,GAClC,mBAAmB,GAAG,SAAS,CAAA;CACnC;AAkBD,eAAO,MAAM,qBAAqB,EAAE,qBAElC,CAAA"}

package/dist/internal/durable-saga-protocol.d.ts

@@ -1,4 +1,4 @@
-import type { SagaRecord, SagaState, SagaStepRecord, SagaStore } from "../durable-execution.js";
+import type { SagaRecord, SagaState, SagaStepRecord, SagaStore } from "./durable-types.js";
 export type DurableSagaTransitionInput = Parameters<SagaStore["compareAndSet"]>[0];
 export interface DurableSagaProtocol {
     transition(current: SagaRecord | undefined, input: DurableSagaTransitionInput): SagaRecord | undefined;

package/dist/internal/durable-saga-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable-saga-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/durable-saga-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAE/F,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,mBAAmB;IAClC,UAAU,CACR,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,KAAK,EAAE,0BAA0B,GAChC,UAAU,GAAG,SAAS,CAAA;IACzB,QAAQ,CACN,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,GAChB,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;CAC/B;AAmCD,eAAO,MAAM,mBAAmB,EAAE,mBAGhC,CAAA"}
+{"version":3,"file":"durable-saga-protocol.d.ts","sourceRoot":"","sources":["../../src/internal/durable-saga-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAE1F,MAAM,MAAM,0BAA0B,GAAG,UAAU,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAElF,MAAM,WAAW,mBAAmB;IAClC,UAAU,CACR,OAAO,EAAE,UAAU,GAAG,SAAS,EAC/B,KAAK,EAAE,0BAA0B,GAChC,UAAU,GAAG,SAAS,CAAA;IACzB,QAAQ,CACN,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,SAAS,EAChB,SAAS,EAAE,MAAM,GAChB,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;CAC/B;AAmCD,eAAO,MAAM,mBAAmB,EAAE,mBAGhC,CAAA"}

package/dist/internal/durable-shared.d.ts

@@ -0,0 +1,26 @@
+import type { ReconciliationScanOptions, ReconciliationScanPage } from "./durable-types.js";
+export declare const TOKEN: RegExp;
+export declare const ERROR_CODE: RegExp;
+export declare const encoder: TextEncoder;
+export declare function assertToken(value: string, label: string, maxLength?: number): void;
+export declare function assertPositiveMs(value: number, label: string): void;
+export declare function assertTimestamp(value: number, label: string): void;
+export declare function readClock(clock: () => number, label: string): number;
+export declare function addDuration(timestamp: number, duration: number, label: string): number;
+export declare function bytesToBase64Url(bytes: Uint8Array): string;
+export declare function sha256(value: string): Promise<string>;
+export declare function cloneValue<T>(value: T): T;
+export declare const DEFAULT_RECONCILIATION_LIMIT = 100;
+export declare const MAX_RECONCILIATION_LIMIT = 1000;
+export declare function reconciliationLimit(value?: number): number;
+export declare function cursorOffset(cursor?: string): number;
+export declare function memoryScan<Record extends {
+    readonly state: State;
+    readonly updatedAt: number;
+}, State extends string>(source: Iterable<Record>, input: ReconciliationScanOptions<State>): ReconciliationScanPage<Record>;
+export declare function bucketAdd<State extends string>(byState: Map<State, Set<string>>, state: State, id: string): void;
+export declare function bucketMove<State extends string>(byState: Map<State, Set<string>>, from: State, to: State, id: string): void;
+export declare function indexedScan<Record extends {
+    readonly updatedAt: number;
+}, State extends string>(byState: Map<State, Set<string>>, resolve: (id: string) => Record | undefined, input: ReconciliationScanOptions<State>): ReconciliationScanPage<Record>;
+//# sourceMappingURL=durable-shared.d.ts.map

package/dist/internal/durable-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-shared.d.ts","sourceRoot":"","sources":["../../src/internal/durable-shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAE3F,eAAO,MAAM,KAAK,QAAa,CAAA;AAC/B,eAAO,MAAM,UAAU,QAA6B,CAAA;AACpD,eAAO,MAAM,OAAO,aAAoB,CAAA;AAExC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,IAAI,CAS/E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGnE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGlE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAItF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI1D;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3D;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEzC;AAED,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAC/C,eAAO,MAAM,wBAAwB,OAAQ,CAAA;AAE7C,wBAAgB,mBAAmB,CAAC,KAAK,SAA+B,GAAG,MAAM,CAKhF;AAED,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAgB,UAAU,CACxB,MAAM,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACpE,KAAK,SAAS,MAAM,EAEpB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,KAAK,EAAE,yBAAyB,CAAC,KAAK,CAAC,GACtC,sBAAsB,CAAC,MAAM,CAAC,CAqBhC;AAED,wBAAgB,SAAS,CAAC,KAAK,SAAS,MAAM,EAC5C,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAChC,KAAK,EAAE,KAAK,EACZ,EAAE,EAAE,MAAM,GACT,IAAI,CAON;AAED,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,EAC7C,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAChC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,KAAK,EACT,EAAE,EAAE,MAAM,GACT,IAAI,CAIN;AAED,wBAAgB,WAAW,CAAC,MAAM,SAAS;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,SAAS,MAAM,EAC7F,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAChC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAC3C,KAAK,EAAE,yBAAyB,CAAC,KAAK,CAAC,GACtC,sBAAsB,CAAC,MAAM,CAAC,CA0BhC"}

package/dist/internal/durable-shared.js

@@ -0,0 +1,131 @@
+export const TOKEN = /^[!-~]+$/;
+export const ERROR_CODE = /^[a-z][a-z0-9_.-]{0,63}$/;
+export const encoder = new TextEncoder();
+export function assertToken(value, label, maxLength = 255) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value.length > maxLength ||
+        !TOKEN.test(value)) {
+        throw new TypeError(`${label} must be a bounded printable token`);
+    }
+}
+export function assertPositiveMs(value, label) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new RangeError(`${label} must be a positive safe integer`);
+}
+export function assertTimestamp(value, label) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new RangeError(`${label} must be a non-negative safe integer timestamp`);
+}
+export function readClock(clock, label) {
+    const value = clock();
+    assertTimestamp(value, label);
+    return value;
+}
+export function addDuration(timestamp, duration, label) {
+    const result = timestamp + duration;
+    assertTimestamp(result, label);
+    return result;
+}
+export function bytesToBase64Url(bytes) {
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
+}
+export async function sha256(value) {
+    return bytesToBase64Url(new Uint8Array(await crypto.subtle.digest("SHA-256", encoder.encode(value))));
+}
+export function cloneValue(value) {
+    return structuredClone(value);
+}
+export const DEFAULT_RECONCILIATION_LIMIT = 100;
+export const MAX_RECONCILIATION_LIMIT = 1_000;
+export function reconciliationLimit(value = DEFAULT_RECONCILIATION_LIMIT) {
+    if (!Number.isSafeInteger(value) || value < 1 || value > MAX_RECONCILIATION_LIMIT) {
+        throw new RangeError(`reconciliation limit must be between 1 and ${MAX_RECONCILIATION_LIMIT}`);
+    }
+    return value;
+}
+export function cursorOffset(cursor) {
+    if (cursor === undefined)
+        return 0;
+    if (!/^(?:0|[1-9][0-9]*)$/u.test(cursor))
+        throw new TypeError("invalid reconciliation cursor");
+    const offset = Number(cursor);
+    if (!Number.isSafeInteger(offset))
+        throw new TypeError("invalid reconciliation cursor");
+    return offset;
+}
+export function memoryScan(source, input) {
+    const states = new Set(input.states);
+    const offset = cursorOffset(input.cursor);
+    const end = offset + input.limit;
+    const records = [];
+    let seen = 0;
+    let more = false;
+    for (const record of source) {
+        if (!states.has(record.state))
+            continue;
+        if (input.updatedBefore !== undefined && record.updatedAt > input.updatedBefore)
+            continue;
+        if (seen >= end) {
+            more = true;
+            break;
+        }
+        if (seen >= offset)
+            records.push(cloneValue(record));
+        seen++;
+    }
+    return Object.freeze({
+        records: Object.freeze(records),
+        ...(more ? { cursor: String(offset + records.length) } : {}),
+    });
+}
+export function bucketAdd(byState, state, id) {
+    let bucket = byState.get(state);
+    if (bucket === undefined) {
+        bucket = new Set();
+        byState.set(state, bucket);
+    }
+    bucket.add(id);
+}
+export function bucketMove(byState, from, to, id) {
+    if (from === to)
+        return;
+    byState.get(from)?.delete(id);
+    bucketAdd(byState, to, id);
+}
+export function indexedScan(byState, resolve, input) {
+    const offset = cursorOffset(input.cursor);
+    const end = offset + input.limit;
+    const records = [];
+    let seen = 0;
+    let more = false;
+    for (const state of new Set(input.states)) {
+        if (more)
+            break;
+        const bucket = byState.get(state);
+        if (bucket === undefined)
+            continue;
+        for (const id of bucket) {
+            const record = resolve(id);
+            if (record === undefined)
+                continue;
+            if (input.updatedBefore !== undefined && record.updatedAt > input.updatedBefore)
+                continue;
+            if (seen >= end) {
+                more = true;
+                break;
+            }
+            if (seen >= offset)
+                records.push(cloneValue(record));
+            seen++;
+        }
+    }
+    return Object.freeze({
+        records: Object.freeze(records),
+        ...(more ? { cursor: String(offset + records.length) } : {}),
+    });
+}
+//# sourceMappingURL=durable-shared.js.map

package/dist/internal/durable-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-shared.js","sourceRoot":"","sources":["../../src/internal/durable-shared.ts"],"names":[],"mappings":"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"}

package/dist/internal/durable-types.d.ts

@@ -0,0 +1,159 @@
+/** Type-only records and transition contracts shared by durable execution domains. */
+export type DurableEffectState = "admission" | "executing" | "committed" | "failed" | "unknown";
+export interface ReconciliationScanOptions<State extends string> {
+    readonly states: readonly State[];
+    readonly updatedBefore?: number;
+    readonly cursor?: string;
+    readonly limit: number;
+}
+export interface ReconciliationScanPage<Record> {
+    readonly records: readonly Record[];
+    readonly cursor?: string;
+}
+export interface ReconciliationPage<Finding> {
+    readonly findings: readonly Finding[];
+    readonly cursor?: string;
+}
+export interface DurableEffectRecord {
+    readonly effectId: string;
+    readonly capability: string;
+    readonly target?: string;
+    readonly digest?: string;
+    readonly tenantId?: string;
+    readonly principalId?: string;
+    readonly state: DurableEffectState;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly errorCode?: string;
+    readonly version: number;
+}
+export interface DurableEffectStore {
+    readonly durability?: "memory" | "durable";
+    create(record: DurableEffectRecord): boolean | Promise<boolean>;
+    get(effectId: string): DurableEffectRecord | undefined | Promise<DurableEffectRecord | undefined>;
+    /** Atomic compare-and-set; exactly one caller may advance the supplied `version` and `from` state. */
+    transition(input: {
+        readonly effectId: string;
+        readonly version: number;
+        readonly from: DurableEffectState;
+        readonly to: DurableEffectState;
+        readonly updatedAt: number;
+        readonly errorCode?: string;
+    }): boolean | Promise<boolean>;
+    /** Bounded operational scan. Transition-only stores do not need to implement reconciliation. */
+    scan?(input: ReconciliationScanOptions<DurableEffectState>): ReconciliationScanPage<DurableEffectRecord> | Promise<ReconciliationScanPage<DurableEffectRecord>>;
+    /** @deprecated Compatibility fallback; production reconciliation should implement `scan`. */
+    list?(): readonly DurableEffectRecord[] | Promise<readonly DurableEffectRecord[]>;
+}
+export type ApprovalState = "pending" | "approved" | "denied" | "consumed" | "expired";
+export interface ApprovalRecord {
+    readonly approvalId: string;
+    readonly effectId: string;
+    readonly capability: string;
+    readonly target?: string;
+    readonly digest?: string;
+    readonly tenantId: string;
+    readonly principalId: string;
+    readonly tokenHash: string;
+    readonly state: ApprovalState;
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly updatedAt: number;
+    readonly decidedBy?: string;
+    readonly version: number;
+}
+export type ApprovalConsumeResult = {
+    readonly state: "consumed";
+} | {
+    readonly state: "missing" | "pending" | "denied" | "expired" | "replay" | "binding" | "token";
+};
+export interface ApprovalStore {
+    readonly durability?: "memory" | "durable";
+    create(record: ApprovalRecord): boolean | Promise<boolean>;
+    get(approvalId: string): ApprovalRecord | undefined | Promise<ApprovalRecord | undefined>;
+    decide(input: {
+        readonly approvalId: string;
+        readonly tenantId: string;
+        readonly decision: "approved" | "denied";
+        readonly decidedBy: string;
+        readonly now: number;
+    }): boolean | Promise<boolean>;
+    /**
+     * Atomically validate binding/token/state and change `approved` to `consumed`. Two concurrent
+     * callers with one token must yield exactly one `consumed` and one `replay` result.
+     */
+    consume(input: {
+        readonly approvalId: string;
+        readonly tenantId: string;
+        readonly principalId: string;
+        readonly capability: string;
+        readonly target?: string;
+        readonly digest?: string;
+        readonly tokenHash: string;
+        readonly now: number;
+    }): ApprovalConsumeResult | Promise<ApprovalConsumeResult>;
+}
+export type SagaState = "running" | "compensating" | "completed" | "compensated" | "manual-review";
+export type SagaStepState = "executing" | "committed" | "failed" | "ambiguous" | "compensating" | "compensation-failed" | "compensated";
+export interface SagaStepRecord {
+    readonly name: string;
+    readonly effectId: string;
+    readonly compensationEffectId: string;
+    readonly state: SagaStepState;
+    readonly compensationArgs: unknown;
+    readonly result?: unknown;
+    readonly attempts: number;
+    readonly nextAttemptAt?: number;
+    readonly errorCode?: string;
+}
+export interface SagaRecord {
+    readonly sagaId: string;
+    readonly definition: string;
+    readonly state: SagaState;
+    readonly input: unknown;
+    readonly steps: readonly SagaStepRecord[];
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly version: number;
+}
+export interface SagaStore {
+    readonly durability?: "memory" | "durable";
+    create(record: SagaRecord): boolean | Promise<boolean>;
+    get(sagaId: string): SagaRecord | undefined | Promise<SagaRecord | undefined>;
+    /** Atomic version compare-and-set; this is the saga engine's crash/concurrency boundary. */
+    compareAndSet(input: {
+        readonly sagaId: string;
+        readonly version: number;
+        readonly record: SagaRecord;
+    }): boolean | Promise<boolean>;
+    /** Bounded operational scan. Transition-only stores do not need to implement reconciliation. */
+    scan?(input: ReconciliationScanOptions<SagaState>): ReconciliationScanPage<SagaRecord> | Promise<ReconciliationScanPage<SagaRecord>>;
+    /** @deprecated Compatibility fallback; production reconciliation should implement `scan`. */
+    list?(): readonly SagaRecord[] | Promise<readonly SagaRecord[]>;
+}
+export interface SagaStepExecutionContext {
+    readonly effectId: string;
+    readonly signal: AbortSignal;
+}
+export interface SagaCompensationContext {
+    readonly effectId: string;
+    readonly sagaId: string;
+    readonly attempt: number;
+    readonly signal: AbortSignal;
+}
+export interface SagaRunContext<C extends Record<string, unknown>> {
+    step<K extends keyof C & string, T>(name: K, compensationArgs: C[K], execute: (context: SagaStepExecutionContext) => T | PromiseLike<T>): Promise<T>;
+}
+export interface SagaDefinition<I, C extends Record<string, unknown>> {
+    readonly name: string;
+    readonly capability?: string;
+    readonly run: (context: SagaRunContext<C>, input: I) => void | PromiseLike<void>;
+    readonly compensators: {
+        readonly [K in keyof C]: (args: C[K], context: SagaCompensationContext) => void | PromiseLike<void>;
+    };
+    readonly retry?: {
+        readonly maxAttempts?: number;
+        readonly backoffMs?: (attempt: number) => number;
+    };
+}
+//# sourceMappingURL=durable-types.d.ts.map

package/dist/internal/durable-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-types.d.ts","sourceRoot":"","sources":["../../src/internal/durable-types.ts"],"names":[],"mappings":"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"}

package/dist/internal/durable-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=durable-types.js.map

package/dist/internal/durable-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-types.js","sourceRoot":"","sources":["../../src/internal/durable-types.ts"],"names":[],"mappings":""}

package/dist/internal/route-compiler.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Registration-time route compilation.
+ *
+ * This module owns the policy decisions that turn a route declaration into the immutable facts the
+ * execution-plan builder and the route catalog consume. It deliberately runs only from `Server.register`
+ * and `Server.registerBatch`; no function here is reachable from the request path.
+ *
+ * The public Server remains the fluent registration surface. This module is the deep implementation seam
+ * behind that surface: body limits, capability and assurance evidence, optional runtimes, decorations, and
+ * lane selection are resolved once, together, so adding a new route policy does not require editing the
+ * kernel's dispatch code.
+ */
+import type { EffectLifecycleObserver } from "../effect-lifecycle.js";
+import { type CompiledRoutePattern } from "../router/pattern.js";
+import type { Method } from "../router/router.js";
+import type { StandardSchemaV1 } from "../schema/standard.js";
+import type { RouteSchema } from "../server/context.js";
+import type { IdempotencyRuntime, ResolvedIdempotency } from "../server/idempotency-lane.js";
+import type { EffectLedgerRuntime, ResolvedEffectLedger } from "../server/ledger-lane.js";
+import type { ResponseContractRuntime } from "../server/response-contract-lane.js";
+import { type CapabilityUseEvent, type RegisteredCapabilityInterceptor } from "./capability-runtime.js";
+import { type AssuranceDeclaration } from "./route-assurance.js";
+import type { RawAfterHandle, RawAround, RawBeforeHandle, RawDerive, RawErrorHandler } from "./route-execution.js";
+import { type RouteLaneSelection } from "./route-lanes.js";
+export interface RouteCompilerContext {
+    readonly maxBodyBytes: number;
+    readonly activeAssurance: readonly AssuranceDeclaration[];
+    readonly globalAssurance: readonly AssuranceDeclaration[];
+    readonly decorations: Record<string, unknown>;
+    readonly onCapabilityUse: ((event: CapabilityUseEvent) => void) | undefined;
+    readonly capabilityInterceptors: readonly RegisteredCapabilityInterceptor[];
+    readonly capabilityObservers: readonly EffectLifecycleObserver[];
+    readonly effectLedgerRuntime: EffectLedgerRuntime | undefined;
+    readonly idempotencyRuntime: IdempotencyRuntime | undefined;
+    readonly responseContractRuntime: ResponseContractRuntime | undefined;
+    readonly derives: readonly RawDerive[];
+    readonly beforeHandleHooks: readonly RawBeforeHandle[];
+    readonly afterHandleHooks: readonly RawAfterHandle[];
+    readonly onErrorHooks: readonly RawErrorHandler[];
+    readonly aroundHooks: readonly RawAround[];
+    readonly defaultOnValidationError: RouteSchema["onValidationError"] | undefined;
+}
+export interface CompiledRouteOptions {
+    readonly pattern: CompiledRoutePattern;
+    readonly bodyLimit: number | undefined;
+    readonly capabilities: readonly string[];
+    readonly handlerAssurance: readonly AssuranceDeclaration[];
+    readonly routeDecorations: Record<PropertyKey, unknown>;
+    readonly hasDecorations: boolean;
+    readonly idempotent: ResolvedIdempotency | undefined;
+    readonly ledgered: ResolvedEffectLedger | undefined;
+    readonly responseContract: {
+        readonly runtime: ResponseContractRuntime;
+        readonly schema: StandardSchemaV1;
+    } | undefined;
+    readonly lanes: RouteLaneSelection;
+    readonly routeAssurance: readonly AssuranceDeclaration[];
+}
+/** Resolve all registration-time policy and lane facts for one route. */
+export declare function compileRouteOptions(context: RouteCompilerContext, method: Method, path: string, schema: RouteSchema | undefined, handler: (context: never) => unknown): CompiledRouteOptions;
+//# sourceMappingURL=route-compiler.d.ts.map

package/dist/internal/route-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-compiler.d.ts","sourceRoot":"","sources":["../../src/internal/route-compiler.ts"],"names":[],"mappings":"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"}