@relkit/runtime-hono 0.5.3 → 0.5.5

package/dist/jobs/handlers-stream.js

@@ -1,51 +1,82 @@
 import { TASK_ITEM_MAX_BYTES, validateCanonicalOutput } from "@relkit/jobs";
-import { authorizeJobOperation, assertGrantLive } from "./authorization.js";
+import { Context, Effect, Layer, Stream } from "effect";
+import { httpBoundary, HttpBoundaryError, httpIterable, observeHttp, runHttp, } from "../http-effect.js";
+import { assertGrantLive, authorizeJobOperation } from "./authorization.js";
 import { configFor, envelopeInput, guardJobRequest, optionalCursor, requiredText, } from "./common.js";
 import { decodeJobCursor, encodeJobCursor } from "./cursors.js";
+import { projectStreamFrame } from "./projection.js";
 import { descriptorFor, jobError, runtimeFor, trustedScopeFor } from "./support.js";
 import { jobPolicy } from "./types.js";
-import { projectStreamFrame } from "./projection.js";
-export async function streamJobRun(options, context, job, value, signal) {
+/** Authorizes and exposes a named job stream with validated projected frames.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param job - Registered job declaration and its client operation policy.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param signal - Cancellation signal inherited from the caller or owning scope.
+ * @returns An Effect yielding an authorized iterable with validated frames and signed resume cursors.
+ */
+const streamJobRunEffect = Effect.fn("JobStreams.streamJobRun")(function* (options, context, job, value, signal) {
     const input = envelopeInput(value, ["runId", "name", "after", "expectedIdentity"]);
-    await guardJobRequest(options, context, input, "stream");
+    yield* httpBoundary("jobs.streamJobRun", () => guardJobRequest(options, context, input, "stream"));
     const config = configFor(options);
-    const descriptor = await descriptorFor(config, job);
-    const runtime = await runtimeFor(config, job);
+    const descriptor = yield* httpBoundary("jobs.streamJobRun", () => descriptorFor(config, job));
+    const runtime = yield* httpBoundary("jobs.streamJobRun", () => runtimeFor(config, job));
     const runId = requiredText(input.runId, "run ID");
     const name = requiredText(input.name, "stream name");
     const policy = jobPolicy(job);
     if (!policy.streams.includes(name))
-        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream was not found.");
-    const trusted = await trustedScopeFor(config, context, job, "stream");
-    const authorized = await authorizeJobOperation(config, context, job, descriptor, "stream", undefined, undefined, signal, runId, name);
+        return yield* Effect.fail(new HttpBoundaryError({
+            operation: "jobs.streamJobRun",
+            cause: jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream was not found."),
+        }));
+    const trusted = yield* httpBoundary("jobs.streamJobRun", () => trustedScopeFor(config, context, job, "stream"));
+    const authorized = yield* httpBoundary("jobs.streamJobRun", () => authorizeJobOperation(config, context, job, descriptor, "stream", undefined, undefined, signal, runId, name));
     const owner = { ...trusted, scope: authorized.grant.scope };
     const filters = { runId, name };
     const after = decodeJobCursor(config, owner, job, "stream", filters, optionalCursor(input.after, "cursor"));
     const source = nativeStream(runtime, runId, name, after, signal, owner.scope);
-    return (async function* () {
-        for await (const frame of source) {
-            assertGrantLive(authorized.grant);
-            const streamSchema = descriptor.task.streams?.[name];
-            if (frameIsChunk(frame) && streamSchema !== undefined) {
-                try {
-                    await validateCanonicalOutput(streamSchema, frame.item, TASK_ITEM_MAX_BYTES);
-                }
-                catch {
-                    throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream data is not available.");
-                }
-            }
-            const projected = projectStreamFrame(frame, runId, name);
-            if (!("cursor" in projected) || projected.cursor === undefined) {
-                yield projected;
-                continue;
-            }
-            yield {
-                ...projected,
-                cursor: encodeJobCursor(config, owner, job, "stream", filters, projected.cursor),
-            };
+    return httpIterable(Stream.fromAsyncIterable(source, (cause) => new HttpBoundaryError({ operation: "jobs.stream.read", cause })).pipe(Stream.mapEffect(Effect.fn("JobStreams.projectFrame")(function* (frame) {
+        assertGrantLive(authorized.grant);
+        const streamSchema = descriptor.task.streams?.[name];
+        if (frameIsChunk(frame) && streamSchema !== undefined) {
+            yield* httpBoundary("jobs.stream.validate", () => validateCanonicalOutput(streamSchema, frame.item, TASK_ITEM_MAX_BYTES)).pipe(Effect.mapError(() => new HttpBoundaryError({
+                operation: "jobs.stream.validate",
+                cause: jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream data is not available."),
+            })));
         }
-    })();
+        const projected = projectStreamFrame(frame, runId, name);
+        if (!("cursor" in projected) || projected.cursor === undefined) {
+            return projected;
+        }
+        return {
+            ...projected,
+            cursor: encodeJobCursor(config, owner, job, "stream", filters, projected.cursor),
+        };
+    }))));
+});
+/** Runs stream job run through the request service, preserving the Promise API.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param context - Trusted Hono or oRPC request context containing request state and authentication.
+ * @param job - Registered job declaration and its client operation policy.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @param signal - Cancellation signal inherited from the caller or owning scope.
+ * @returns An authorized named-stream iterable whose frames are projected as they are consumed.
+ */
+export function streamJobRun(options, context, job, value, signal) {
+    return runHttp(Effect.gen(function* () {
+        const service = yield* JobStreams;
+        return yield* service.streamJobRun(options, context, job, value, signal);
+    }).pipe(Effect.provide(JobStreamsLive)));
 }
+/** Selects the provider's supported job stream method and validates its iterator contract.
+ * @param runtime - Configured runtime and provider dependencies.
+ * @param runId - Stable run identifier within the owning generation or provider scope.
+ * @param name - Declared field, header, stream or configuration key.
+ * @param after - Resume checkpoint after which observation continues.
+ * @param signal - Cancellation signal inherited from the caller or owning scope.
+ * @param scope - Authorized provider scope or lifetime scope owning the operation.
+ * @returns The provider's observation iterable, rejecting unsupported or invalid stream adapters.
+ */
 function nativeStream(runtime, runId, name, after, signal, scope) {
     const streams = runtime.adapter.streams;
     if (streams === undefined)
@@ -59,14 +90,29 @@ function nativeStream(runtime, runId, name, after, signal, scope) {
         throw jobError("RELKIT_JOB_STREAM_UNSUPPORTED", "Job stream is invalid.");
     return source;
 }
+/** Recognizes stream chunk frames before validating their public items.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
 function frameIsChunk(value) {
     return (value !== null &&
         typeof value === "object" &&
         value.kind === "chunk");
 }
+/** Recognizes a value that supplies the asynchronous iterator protocol.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
 function isAsyncIterable(value) {
     return (value !== null &&
         typeof value === "object" &&
         typeof value[Symbol.asyncIterator] === "function");
 }
+/** Effect workflow for validated and authorized job requests. */
+export class JobStreams extends Context.Service()("@relkit/runtime-hono/JobStreams") {
+}
+/** Live job workflows; replace the service layer for focused transport tests. */
+export const JobStreamsLive = Layer.succeed(JobStreams, {
+    streamJobRun: (...args) => observeHttp("jobs.streamJobRun", streamJobRunEffect(...args)),
+});
 //# sourceMappingURL=handlers-stream.js.map

package/dist/jobs/handlers-stream.js.map

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

package/dist/jobs/handlers-validation.d.ts

@@ -1,6 +1,22 @@
 import type { RunListQuery, RunSnapshot } from "@relkit/contracts/jobs";
 import { type JobDescriptorAny, type JobsRuntime } from "@relkit/jobs";
+/** Validate safe run metadata and declared input/progress/output schemas.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @param run - Persisted run being inspected.
+ * @returns Nothing for valid run data; otherwise a public access-denied failure.
+ */
 export declare function validateCanonicalRun(descriptor: JobDescriptorAny, run: RunSnapshot): Promise<void>;
+/** Read a run through controls constrained to the trusted scope.
+ * @param runtime - Native jobs runtime.
+ * @param scope - Execution scope used to partition the operation.
+ * @param runId - Selected run identifier.
+ * @param signal - Optional caller cancellation signal.
+ * @returns The snapshot; missing reads become a public not-found error.
+ */
 export declare function readRun(runtime: JobsRuntime, scope: string, runId: string, signal?: AbortSignal): Promise<RunSnapshot>;
+/** Validate supported list filters, bounded text, statuses and page size.
+ * @param value - Value to validate or project.
+ * @returns The accepted list query or an access-denied failure.
+ */
 export declare function queryInput(value: unknown): RunListQuery;
 //# sourceMappingURL=handlers-validation.d.ts.map

package/dist/jobs/handlers-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers-validation.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAKtB,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,gBAAgB,EAC5B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAsEvD"}
+{"version":3,"file":"handlers-validation.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAKtB;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,gBAAgB,EAC5B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAsEvD"}

package/dist/jobs/handlers-validation.js

@@ -2,6 +2,11 @@ import { createJobsControls, TASK_ITEM_MAX_BYTES, validateCanonicalInput, valida
 import { optionalCursor, recordInput } from "./common.js";
 import { assertSafeRun } from "./projection-validation.js";
 import { jobError, scopedRuntime } from "./support.js";
+/** Validate safe run metadata and declared input/progress/output schemas.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @param run - Persisted run being inspected.
+ * @returns Nothing for valid run data; otherwise a public access-denied failure.
+ */
 export async function validateCanonicalRun(descriptor, run) {
     try {
         assertSafeRun(run);
@@ -19,6 +24,13 @@ export async function validateCanonicalRun(descriptor, run) {
         throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job run data is not available.");
     }
 }
+/** Read a run through controls constrained to the trusted scope.
+ * @param runtime - Native jobs runtime.
+ * @param scope - Execution scope used to partition the operation.
+ * @param runId - Selected run identifier.
+ * @param signal - Optional caller cancellation signal.
+ * @returns The snapshot; missing reads become a public not-found error.
+ */
 export async function readRun(runtime, scope, runId, signal) {
     try {
         return await createJobsControls(scopedRuntime(runtime, scope)).get(runId, signal === undefined ? {} : { signal });
@@ -29,6 +41,10 @@ export async function readRun(runtime, scope, runId, signal) {
         throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job run was not found.");
     }
 }
+/** Validate supported list filters, bounded text, statuses and page size.
+ * @param value - Value to validate or project.
+ * @returns The accepted list query or an access-denied failure.
+ */
 export function queryInput(value) {
     if (value === undefined)
         return {};
@@ -108,6 +124,11 @@ const RUN_STATUSES = new Set([
     "timed-out",
     "unknown",
 ]);
+/** Require a nonempty list filter bounded to 256 UTF-8 bytes.
+ * @param value - Value to validate or project.
+ * @param name - Field, job or stream name.
+ * @returns The validated query text.
+ */
 function boundedQueryText(value, name) {
     if (typeof value !== "string" ||
         value.length === 0 ||

package/dist/jobs/handlers-validation.js.map

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

package/dist/jobs/projection-stream.d.ts

@@ -1,4 +1,15 @@
 import { type JsonValue } from "@relkit/contracts";
 import type { NamedStreamFrame } from "@relkit/contracts/jobs";
+/** Validate stream identity, metadata and bounded JSON chunk content.
+ * @param frame - Native frame to validate or encode.
+ * @param runId - Selected run identifier.
+ * @param name - Field, job or stream name.
+ * @returns A frozen public stream frame matching the requested run and stream.
+ * @example
+ * const frame = projectStreamFrame({ kind: "chunk", runId: "run-1", name: "tokens",
+ *   attempt: 1, generation: "gen-1", schemaVersion: "1", sequence: 0,
+ *   item: { text: "hello" }, privateDebug: "omitted" }, "run-1", "tokens");
+ * // frame contains the validated chunk and no privateDebug field.
+ */
 export declare function projectStreamFrame(frame: unknown, runId: string, name: string): NamedStreamFrame<JsonValue>;
 //# sourceMappingURL=projection-stream.d.ts.map

package/dist/jobs/projection-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection-stream.d.ts","sourceRoot":"","sources":["../../src/jobs/projection-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,SAAS,CAAC,CA2C7B"}
+{"version":3,"file":"projection-stream.d.ts","sourceRoot":"","sources":["../../src/jobs/projection-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,gBAAgB,CAAC,SAAS,CAAC,CA2C7B"}

package/dist/jobs/projection-stream.js

@@ -1,6 +1,17 @@
 import { assertJsonValue, canonicalJson, isJsonValue } from "@relkit/contracts";
 import { TASK_ITEM_MAX_BYTES } from "@relkit/jobs";
 import { jobError } from "./support.js";
+/** Validate stream identity, metadata and bounded JSON chunk content.
+ * @param frame - Native frame to validate or encode.
+ * @param runId - Selected run identifier.
+ * @param name - Field, job or stream name.
+ * @returns A frozen public stream frame matching the requested run and stream.
+ * @example
+ * const frame = projectStreamFrame({ kind: "chunk", runId: "run-1", name: "tokens",
+ *   attempt: 1, generation: "gen-1", schemaVersion: "1", sequence: 0,
+ *   item: { text: "hello" }, privateDebug: "omitted" }, "run-1", "tokens");
+ * // frame contains the validated chunk and no privateDebug field.
+ */
 export function projectStreamFrame(frame, runId, name) {
     if (!isRecord(frame) ||
         frame.runId !== runId ||
@@ -41,9 +52,19 @@ export function projectStreamFrame(frame, runId, name) {
         ...(reason === undefined ? {} : { reason }),
     });
 }
+/** Recognize the supported named stream lifecycle frame kinds.
+ * @param value - Value to validate or project.
+ * @returns Whether the kind is start, chunk, reset or end.
+ */
 function isStreamKind(value) {
     return value === "start" || value === "chunk" || value === "reset" || value === "end";
 }
+/** Require nonempty metadata within the supplied UTF-8 byte bound.
+ * @param value - Value to validate or project.
+ * @param name - Field, job or stream name.
+ * @param maxBytes - Maximum encoded UTF-8 byte length.
+ * @returns The validated text; unsupported metadata throws a public job error.
+ */
 function boundedText(value, name = "stream frame text", maxBytes = 256) {
     if (typeof value !== "string" ||
         value.length === 0 ||
@@ -52,18 +73,30 @@ function boundedText(value, name = "stream frame text", maxBytes = 256) {
     }
     return value;
 }
+/** Require a nonnegative safe integer for stream counters.
+ * @param value - Value to validate or project.
+ * @returns The validated integer.
+ */
 function boundedNumber(value) {
     if (!Number.isSafeInteger(value) || value < 0) {
         throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream frame is invalid.");
     }
     return value;
 }
+/** Validate a supported stream reset reason.
+ * @param value - Value to validate or project.
+ * @returns The reconnect, expired-cursor or overflow reason.
+ */
 function streamResetReason(value) {
     if (value !== "reconnected" && value !== "cursor-expired" && value !== "overflow") {
         throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream frame is invalid.");
     }
     return value;
 }
+/** Enforce the canonical JSON byte limit for one stream item.
+ * @param value - Value to validate or project.
+ * @returns Nothing for a bounded item; otherwise throws an access-denied error.
+ */
 function assertJsonSize(value) {
     try {
         if (new TextEncoder().encode(canonicalJson(value)).byteLength > TASK_ITEM_MAX_BYTES) {
@@ -76,6 +109,10 @@ function assertJsonSize(value) {
         throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream item is invalid.");
     }
 }
+/** Check whether a value is a non-null object suitable for field inspection.
+ * @param value - Value to validate or project.
+ * @returns Whether object fields can be inspected.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }

package/dist/jobs/projection-stream.js.map

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

package/dist/jobs/projection-validation.d.ts

@@ -1,5 +1,17 @@
 import type { RunAvailability, RunSnapshot, RunWatchFrame } from "@relkit/contracts/jobs";
+/** Validate run metadata, status, result consistency and cancellation fields.
+ * @param value - Value to validate or project.
+ * @returns Nothing when the value satisfies the supported public snapshot shape.
+ */
 export declare function assertSafeRun(value: unknown): asserts value is RunSnapshot;
+/** Validate and project per-service run availability metadata.
+ * @param value - Value to validate or project.
+ * @returns Frozen service availability entries containing supported fields.
+ */
 export declare function safeAvailability(value: readonly unknown[]): readonly RunAvailability[];
+/** Validate run observation metadata and snapshot/reset-specific fields.
+ * @param value - Value to validate or project.
+ * @returns Nothing when the watch frame is safe to project.
+ */
 export declare function assertSafeWatchFrame(value: unknown): asserts value is RunWatchFrame<RunSnapshot>;
 //# sourceMappingURL=projection-validation.d.ts.map

package/dist/jobs/projection-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection-validation.d.ts","sourceRoot":"","sources":["../../src/jobs/projection-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA2B1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CA+C1E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,eAAe,EAAE,CAYtF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,WAAW,CAAC,CAqBhG"}
+{"version":3,"file":"projection-validation.d.ts","sourceRoot":"","sources":["../../src/jobs/projection-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA2B1F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CA+C1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,eAAe,EAAE,CAYtF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,WAAW,CAAC,CAqBhG"}

package/dist/jobs/projection-validation.js

@@ -21,6 +21,10 @@ const RESULT_AVAILABILITY = new Set([
     "version-incompatible",
     "unavailable",
 ]);
+/** Validate run metadata, status, result consistency and cancellation fields.
+ * @param value - Value to validate or project.
+ * @returns Nothing when the value satisfies the supported public snapshot shape.
+ */
 export function assertSafeRun(value) {
     if (!isRecord(value) || value.accepted !== true)
         invalidRun();
@@ -69,6 +73,10 @@ export function assertSafeRun(value) {
     if (value.cancellation !== undefined)
         assertCancellation(value.cancellation);
 }
+/** Validate and project per-service run availability metadata.
+ * @param value - Value to validate or project.
+ * @returns Frozen service availability entries containing supported fields.
+ */
 export function safeAvailability(value) {
     return value.map((entry) => {
         if (!isRecord(entry))
@@ -85,6 +93,10 @@ export function safeAvailability(value) {
         });
     });
 }
+/** Validate run observation metadata and snapshot/reset-specific fields.
+ * @param value - Value to validate or project.
+ * @returns Nothing when the watch frame is safe to project.
+ */
 export function assertSafeWatchFrame(value) {
     if (!isRecord(value) || !isWatchKind(value.kind))
         invalidFrame();
@@ -103,6 +115,10 @@ export function assertSafeWatchFrame(value) {
         !["reconnected", "cursor-expired", "history-unavailable", "overflow"].includes(String(value.reason)))
         invalidFrame();
 }
+/** Validate cancellation receipt identity, outcome and optional timestamp.
+ * @param value - Value to validate or project.
+ * @returns Nothing when cancellation metadata has the supported shape.
+ */
 function assertCancellation(value) {
     if (!isRecord(value))
         invalidRun();
@@ -115,6 +131,12 @@ function assertCancellation(value) {
     if (value.requestedAt !== undefined)
         boundedText(value.requestedAt, "cancellation timestamp");
 }
+/** Require nonempty metadata within the supplied UTF-8 byte bound.
+ * @param value - Value to validate or project.
+ * @param name - Field, job or stream name.
+ * @param maxBytes - Maximum encoded UTF-8 byte length.
+ * @returns The validated text; unsupported metadata throws a public job error.
+ */
 function boundedText(value, name, maxBytes = 256) {
     if (typeof value !== "string" ||
         value.length === 0 ||
@@ -122,21 +144,43 @@ function boundedText(value, name, maxBytes = 256) {
         throw jobError("RELKIT_JOB_ACCESS_DENIED", `Job ${name} is not available.`);
     }
 }
+/** Reject unavailable or malformed public run data.
+ * @returns Never; throws a public access-denied error.
+ */
 function invalidRun() {
     throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job run data is not available.");
 }
+/** Reject malformed service availability or page metadata.
+ * @returns Never; throws a public run-not-found error.
+ */
 function invalidPage() {
     throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job run page is unavailable.");
 }
+/** Reject malformed watch observation metadata.
+ * @returns Never; throws a public run-not-found error.
+ */
 function invalidFrame() {
     throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job observation frame is invalid.");
 }
+/** Recognize the supported run watch frame kinds.
+ * @param value - Value to validate or project.
+ * @returns Whether the kind is snapshot, update or reset.
+ */
 function isWatchKind(value) {
     return value === "snapshot" || value === "update" || value === "reset";
 }
+/** Check whether a value is a non-null object suitable for field inspection.
+ * @param value - Value to validate or project.
+ * @returns Whether object fields can be inspected.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }
+/** Check a field without accepting inherited properties.
+ * @param value - Value to validate or project.
+ * @param key - Property or profile key to inspect.
+ * @returns Whether the object owns the requested key.
+ */
 function hasOwn(value, key) {
     return Object.prototype.hasOwnProperty.call(value, key);
 }

package/dist/jobs/projection-validation.js.map

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

package/dist/jobs/projection.d.ts

@@ -2,10 +2,39 @@ import type { RunCancellationReceipt, RunPage, RunRetryReceipt, RunSnapshot, Run
 import type { TaskJobNode } from "@relkit/graph";
 import type { JobDescriptorAny } from "@relkit/jobs";
 import type { JobPolicyProjection } from "./types.js";
+/** Validate and redact a run according to its public field policy.
+ * @param run - Persisted run being inspected.
+ * @param policy - Allowed public fields and operations.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns The public run snapshot with only selected fields.
+ */
 export declare function projectSnapshot(run: RunSnapshot, policy: JobPolicyProjection, descriptor?: JobDescriptorAny): RunSnapshot;
+/** Validate page metadata and apply the job's field projection.
+ * @param page - Provider page to validate or project.
+ * @param policy - Allowed public fields and operations.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns The public page with safe service availability metadata.
+ */
 export declare function projectPage(page: RunPage<RunSnapshot>, policy: JobPolicyProjection, descriptor?: JobDescriptorAny): RunPage<RunSnapshot>;
+/** Validate a watch frame and project its embedded run.
+ * @param frame - Native frame to validate or encode.
+ * @param policy - Allowed public fields and operations.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns A frozen frame containing only supported metadata and public run fields.
+ */
 export declare function projectWatchFrame(frame: RunWatchFrame<RunSnapshot>, policy: JobPolicyProjection, descriptor?: JobDescriptorAny): RunWatchFrame<RunSnapshot>;
+/** Project the optional run in a cancellation receipt.
+ * @param receipt - Provider cancellation or retry receipt.
+ * @param policy - Allowed public fields and operations.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns A frozen receipt with any run restricted to public fields.
+ */
 export declare function projectCancellation(receipt: RunCancellationReceipt, policy: JobPolicyProjection, descriptor?: JobDescriptorAny): RunCancellationReceipt;
+/** Verify retry identity and expose only supported acceptance fields.
+ * @param receipt - Provider cancellation or retry receipt.
+ * @param job - Compiled task job registration.
+ * @returns A frozen retry receipt matching the selected job/task version.
+ */
 export declare function projectRetry(receipt: RunRetryReceipt, job: Pick<TaskJobNode, "jobId" | "taskId" | "taskVersion">): RunRetryReceipt;
 export { projectStreamFrame } from "./projection-stream.js";
 //# sourceMappingURL=projection.d.ts.map

package/dist/jobs/projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/jobs/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,OAAO,EACP,eAAe,EACf,WAAW,EACX,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,WAAW,CAOb;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,EAC1B,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAatB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,EACjC,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,aAAa,CAAC,WAAW,CAAC,CAiC5B;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,sBAAsB,CAQxB;AAED,wBAAgB,YAAY,CAC1B,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC,GACzD,eAAe,CAqBjB;AAOD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/jobs/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,OAAO,EACP,eAAe,EACf,WAAW,EACX,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,WAAW,CAOb;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,EAC1B,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAatB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,EACjC,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,aAAa,CAAC,WAAW,CAAC,CAiC5B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,sBAAsB,CAQxB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC,GACzD,eAAe,CAqBjB;AAWD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}