@relkit/runtime-hono 0.4.0 → 0.5.1

package/dist/jobs/handlers-validation.js

@@ -0,0 +1,119 @@
+import { createJobsControls, TASK_ITEM_MAX_BYTES, validateCanonicalInput, validateCanonicalOutput, } from "@relkit/jobs";
+import { optionalCursor, recordInput } from "./common.js";
+import { assertSafeRun } from "./projection-validation.js";
+import { jobError, scopedRuntime } from "./support.js";
+export async function validateCanonicalRun(descriptor, run) {
+    try {
+        assertSafeRun(run);
+        if (run.input !== undefined) {
+            await validateCanonicalInput(descriptor.task.input, run.input, descriptor.task.inputWire);
+        }
+        if (run.progress !== undefined && descriptor.task.progress !== undefined) {
+            await validateCanonicalOutput(descriptor.task.progress, run.progress, TASK_ITEM_MAX_BYTES);
+        }
+        if (run.resultAvailability === "available" && "output" in run) {
+            await validateCanonicalOutput(descriptor.task.output, run.output);
+        }
+    }
+    catch {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job run data is not available.");
+    }
+}
+export async function readRun(runtime, scope, runId, signal) {
+    try {
+        return await createJobsControls(scopedRuntime(runtime, scope)).get(runId, signal === undefined ? {} : { signal });
+    }
+    catch (error) {
+        if (signal?.aborted)
+            throw error;
+        throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job run was not found.");
+    }
+}
+export function queryInput(value) {
+    if (value === undefined)
+        return {};
+    const query = recordInput(value);
+    const allowed = new Set([
+        "status",
+        "taskId",
+        "taskVersion",
+        "buildId",
+        "acceptedFrom",
+        "acceptedTo",
+        "startedFrom",
+        "startedTo",
+        "completedFrom",
+        "completedTo",
+        "tags",
+        "tagMatch",
+        "correlationId",
+        "parentRunId",
+        "runId",
+        "limit",
+        "cursor",
+    ]);
+    if (Object.keys(query).some((key) => !allowed.has(key))) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job list query contains an unsupported field.");
+    }
+    if (query.status !== undefined &&
+        (!Array.isArray(query.status) ||
+            query.status.length > RUN_STATUSES.size ||
+            query.status.some((status) => !RUN_STATUSES.has(status)))) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job list status filter is invalid.");
+    }
+    for (const key of [
+        "taskId",
+        "taskVersion",
+        "buildId",
+        "acceptedFrom",
+        "acceptedTo",
+        "startedFrom",
+        "startedTo",
+        "completedFrom",
+        "completedTo",
+        "correlationId",
+        "parentRunId",
+        "runId",
+    ]) {
+        if (query[key] !== undefined)
+            boundedQueryText(query[key], key);
+    }
+    if (query.tags !== undefined &&
+        (!Array.isArray(query.tags) ||
+            query.tags.length > 20 ||
+            query.tags.some((tag) => boundedQueryText(tag, "tag") === undefined))) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job list tags are invalid.");
+    }
+    if (query.tagMatch !== undefined && query.tagMatch !== "all" && query.tagMatch !== "any") {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job list tag matching is invalid.");
+    }
+    const limit = query.limit;
+    if (limit !== undefined &&
+        (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job list limit is invalid.");
+    }
+    if (query.cursor !== undefined)
+        optionalCursor(query.cursor, "cursor");
+    return query;
+}
+const RUN_STATUSES = new Set([
+    "queued",
+    "delayed",
+    "running",
+    "sleeping",
+    "retrying",
+    "completed",
+    "failed",
+    "cancelled",
+    "timed-out",
+    "unknown",
+]);
+function boundedQueryText(value, name) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        new TextEncoder().encode(value).byteLength > 256) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", `Job list ${name} is invalid.`);
+    }
+    return value;
+}
+//# sourceMappingURL=handlers-validation.js.map

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

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

package/dist/jobs/handlers.d.ts

@@ -0,0 +1,4 @@
+export { cancelJobRun, retryJobRun, triggerJob } from "./handlers-mutations.js";
+export { getJobRun, listJobRuns, watchJobRun } from "./handlers-read.js";
+export { streamJobRun } from "./handlers-stream.js";
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/jobs/handlers.js

@@ -0,0 +1,4 @@
+export { cancelJobRun, retryJobRun, triggerJob } from "./handlers-mutations.js";
+export { getJobRun, listJobRuns, watchJobRun } from "./handlers-read.js";
+export { streamJobRun } from "./handlers-stream.js";
+//# sourceMappingURL=handlers.js.map

package/dist/jobs/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/jobs/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type JsonValue } from "@relkit/contracts";
+import type { NamedStreamFrame } from "@relkit/contracts/jobs";
+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

@@ -0,0 +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"}

package/dist/jobs/projection-stream.js

@@ -0,0 +1,82 @@
+import { assertJsonValue, canonicalJson, isJsonValue } from "@relkit/contracts";
+import { TASK_ITEM_MAX_BYTES } from "@relkit/jobs";
+import { jobError } from "./support.js";
+export function projectStreamFrame(frame, runId, name) {
+    if (!isRecord(frame) ||
+        frame.runId !== runId ||
+        frame.name !== name ||
+        !isStreamKind(frame.kind)) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream was not found.");
+    }
+    if (frame.kind === "chunk") {
+        if (typeof frame.sequence !== "number" ||
+            !Number.isSafeInteger(frame.sequence) ||
+            !isJsonValue(frame.item)) {
+            throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream frame is invalid.");
+        }
+        assertJsonValue(frame.item);
+        assertJsonSize(frame.item);
+        return Object.freeze({
+            kind: "chunk",
+            runId,
+            name,
+            attempt: boundedNumber(frame.attempt),
+            generation: boundedText(frame.generation),
+            schemaVersion: boundedText(frame.schemaVersion),
+            sequence: boundedNumber(frame.sequence),
+            item: frame.item,
+            ...(frame.cursor === undefined
+                ? {}
+                : { cursor: boundedText(frame.cursor, "stream cursor", 4096) }),
+        });
+    }
+    const reason = frame.kind === "reset" ? streamResetReason(frame.reason) : undefined;
+    return Object.freeze({
+        kind: frame.kind,
+        runId,
+        name,
+        attempt: boundedNumber(frame.attempt),
+        generation: boundedText(frame.generation),
+        schemaVersion: boundedText(frame.schemaVersion),
+        ...(reason === undefined ? {} : { reason }),
+    });
+}
+function isStreamKind(value) {
+    return value === "start" || value === "chunk" || value === "reset" || value === "end";
+}
+function boundedText(value, name = "stream frame text", maxBytes = 256) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        new TextEncoder().encode(value).byteLength > maxBytes) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", `Job ${name} is invalid.`);
+    }
+    return value;
+}
+function boundedNumber(value) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream frame is invalid.");
+    }
+    return value;
+}
+function streamResetReason(value) {
+    if (value !== "reconnected" && value !== "cursor-expired" && value !== "overflow") {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream frame is invalid.");
+    }
+    return value;
+}
+function assertJsonSize(value) {
+    try {
+        if (new TextEncoder().encode(canonicalJson(value)).byteLength > TASK_ITEM_MAX_BYTES) {
+            throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream item is too large.");
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === "Job stream item is too large.")
+            throw error;
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream item is invalid.");
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=projection-stream.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,5 @@
+import type { RunAvailability, RunSnapshot, RunWatchFrame } from "@relkit/contracts/jobs";
+export declare function assertSafeRun(value: unknown): asserts value is RunSnapshot;
+export declare function safeAvailability(value: readonly unknown[]): readonly RunAvailability[];
+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

@@ -0,0 +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"}

package/dist/jobs/projection-validation.js

@@ -0,0 +1,143 @@
+import { jobError } from "./support.js";
+const RUN_STATUSES = new Set([
+    "queued",
+    "delayed",
+    "running",
+    "sleeping",
+    "retrying",
+    "completed",
+    "failed",
+    "cancelled",
+    "timed-out",
+    "unknown",
+]);
+const RESULT_AVAILABILITY = new Set([
+    "pending",
+    "available",
+    "void",
+    "redacted",
+    "expired",
+    "not-selected",
+    "version-incompatible",
+    "unavailable",
+]);
+export function assertSafeRun(value) {
+    if (!isRecord(value) || value.accepted !== true)
+        invalidRun();
+    for (const key of [
+        "runId",
+        "jobId",
+        "taskId",
+        "taskVersion",
+        "acceptedAt",
+        "buildId",
+        "service",
+        "observedAt",
+    ]) {
+        boundedText(value[key], key);
+    }
+    if (typeof value.status !== "string" || !RUN_STATUSES.has(value.status))
+        invalidRun();
+    if (typeof value.resultAvailability !== "string" ||
+        !RESULT_AVAILABILITY.has(value.resultAvailability))
+        invalidRun();
+    if (value.scope !== undefined)
+        boundedText(value.scope, "scope");
+    for (const key of [
+        "inputHash",
+        "inputSchemaHash",
+        "acceptanceIdentity",
+        "parentRunId",
+        "retryOfRunId",
+        "scheduledFor",
+        "startedAt",
+        "completedAt",
+        "nextEligibleAt",
+    ]) {
+        if (value[key] !== undefined)
+            boundedText(value[key], key);
+    }
+    if (value.attempt !== undefined &&
+        (typeof value.attempt !== "number" || !Number.isSafeInteger(value.attempt) || value.attempt < 0))
+        invalidRun();
+    if (value.status === "completed" &&
+        value.resultAvailability === "available" &&
+        !hasOwn(value, "output"))
+        invalidRun();
+    if (value.status !== "completed" && hasOwn(value, "output"))
+        invalidRun();
+    if (value.cancellation !== undefined)
+        assertCancellation(value.cancellation);
+}
+export function safeAvailability(value) {
+    return value.map((entry) => {
+        if (!isRecord(entry))
+            invalidPage();
+        boundedText(entry.service, "availability service");
+        if (entry.state !== "available" && entry.state !== "unavailable")
+            invalidPage();
+        if (entry.reason !== undefined)
+            boundedText(entry.reason, "availability reason");
+        return Object.freeze({
+            service: entry.service,
+            state: entry.state,
+            ...(entry.reason === undefined ? {} : { reason: entry.reason }),
+        });
+    });
+}
+export function assertSafeWatchFrame(value) {
+    if (!isRecord(value) || !isWatchKind(value.kind))
+        invalidFrame();
+    assertSafeRun(value.run);
+    boundedText(value.observedAt, "observation timestamp");
+    boundedText(value.epoch, "observation epoch");
+    if (typeof value.sequence !== "number" ||
+        !Number.isSafeInteger(value.sequence) ||
+        value.sequence < 0)
+        invalidFrame();
+    if (value.cursor !== undefined)
+        boundedText(value.cursor, "cursor", 4096);
+    if (value.kind === "snapshot" && value.continuity !== "state" && value.continuity !== "history")
+        invalidFrame();
+    if (value.kind === "reset" &&
+        !["reconnected", "cursor-expired", "history-unavailable", "overflow"].includes(String(value.reason)))
+        invalidFrame();
+}
+function assertCancellation(value) {
+    if (!isRecord(value))
+        invalidRun();
+    boundedText(value.runId, "cancellation run ID");
+    boundedText(value.operationId, "cancellation operation ID");
+    if (value.outcome !== "requested" &&
+        value.outcome !== "already-terminal" &&
+        value.outcome !== "unsupported")
+        invalidRun();
+    if (value.requestedAt !== undefined)
+        boundedText(value.requestedAt, "cancellation timestamp");
+}
+function boundedText(value, name, maxBytes = 256) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        new TextEncoder().encode(value).byteLength > maxBytes) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", `Job ${name} is not available.`);
+    }
+}
+function invalidRun() {
+    throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job run data is not available.");
+}
+function invalidPage() {
+    throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job run page is unavailable.");
+}
+function invalidFrame() {
+    throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job observation frame is invalid.");
+}
+function isWatchKind(value) {
+    return value === "snapshot" || value === "update" || value === "reset";
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+//# sourceMappingURL=projection-validation.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,11 @@
+import type { RunCancellationReceipt, RunPage, RunRetryReceipt, RunSnapshot, RunWatchFrame } from "@relkit/contracts/jobs";
+import type { TaskJobNode } from "@relkit/graph";
+import type { JobDescriptorAny } from "@relkit/jobs";
+import type { JobPolicyProjection } from "./types.js";
+export declare function projectSnapshot(run: RunSnapshot, policy: JobPolicyProjection, descriptor?: JobDescriptorAny): RunSnapshot;
+export declare function projectPage(page: RunPage<RunSnapshot>, policy: JobPolicyProjection, descriptor?: JobDescriptorAny): RunPage<RunSnapshot>;
+export declare function projectWatchFrame(frame: RunWatchFrame<RunSnapshot>, policy: JobPolicyProjection, descriptor?: JobDescriptorAny): RunWatchFrame<RunSnapshot>;
+export declare function projectCancellation(receipt: RunCancellationReceipt, policy: JobPolicyProjection, descriptor?: JobDescriptorAny): RunCancellationReceipt;
+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

@@ -0,0 +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"}

package/dist/jobs/projection.js

@@ -0,0 +1,89 @@
+import { projectRunPage, projectRunSnapshot } from "@relkit/jobs";
+import { jobError } from "./support.js";
+import { assertSafeRun, assertSafeWatchFrame, safeAvailability } from "./projection-validation.js";
+export function projectSnapshot(run, policy, descriptor) {
+    try {
+        assertSafeRun(run);
+        return projectRunSnapshot(run, policy.fields, projectionOptions(descriptor));
+    }
+    catch {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job run was not found.");
+    }
+}
+export function projectPage(page, policy, descriptor) {
+    if (!Array.isArray(page.items) ||
+        !Array.isArray(page.availability) ||
+        typeof page.hasMore !== "boolean") {
+        throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job run page is unavailable.");
+    }
+    return projectRunPage({ ...page, availability: safeAvailability(page.availability) }, policy.fields, projectionOptions(descriptor));
+}
+export function projectWatchFrame(frame, policy, descriptor) {
+    assertSafeWatchFrame(frame);
+    const run = projectSnapshot(frame.run, policy, descriptor);
+    if (frame.kind === "snapshot") {
+        return Object.freeze({
+            kind: "snapshot",
+            run,
+            observedAt: frame.observedAt,
+            epoch: frame.epoch,
+            sequence: frame.sequence,
+            ...(frame.cursor === undefined ? {} : { cursor: frame.cursor }),
+            continuity: frame.continuity,
+        });
+    }
+    if (frame.kind === "update") {
+        return Object.freeze({
+            kind: "update",
+            run,
+            observedAt: frame.observedAt,
+            epoch: frame.epoch,
+            sequence: frame.sequence,
+            ...(frame.cursor === undefined ? {} : { cursor: frame.cursor }),
+        });
+    }
+    return Object.freeze({
+        kind: "reset",
+        run,
+        observedAt: frame.observedAt,
+        epoch: frame.epoch,
+        sequence: frame.sequence,
+        reason: frame.reason,
+        ...(frame.cursor === undefined ? {} : { cursor: frame.cursor }),
+    });
+}
+export function projectCancellation(receipt, policy, descriptor) {
+    return Object.freeze({
+        runId: receipt.runId,
+        operationId: receipt.operationId,
+        outcome: receipt.outcome,
+        ...(receipt.requestedAt === undefined ? {} : { requestedAt: receipt.requestedAt }),
+        ...(receipt.run === undefined ? {} : { run: projectSnapshot(receipt.run, policy, descriptor) }),
+    });
+}
+export function projectRetry(receipt, job) {
+    if (receipt.jobId !== job.jobId ||
+        receipt.taskId !== job.taskId ||
+        receipt.taskVersion !== job.taskVersion) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job retry receipt is unavailable.");
+    }
+    return Object.freeze({
+        accepted: true,
+        runId: receipt.runId,
+        jobId: receipt.jobId,
+        taskId: receipt.taskId,
+        taskVersion: receipt.taskVersion,
+        acceptedAt: receipt.acceptedAt,
+        retryOfRunId: receipt.retryOfRunId,
+        ...(receipt.duplicate === true ? { duplicate: true } : {}),
+        ...(receipt.idempotencyExpiresAt === undefined
+            ? {}
+            : { idempotencyExpiresAt: receipt.idempotencyExpiresAt }),
+    });
+}
+function projectionOptions(descriptor) {
+    const errors = descriptor?.task.errors;
+    return errors === undefined ? {} : { declaredErrorIds: errors.map((error) => error.id) };
+}
+export { projectStreamFrame } from "./projection-stream.js";
+//# sourceMappingURL=projection.js.map

package/dist/jobs/projection.js.map

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

package/dist/jobs/rpc.d.ts

@@ -0,0 +1,5 @@
+import type { RouteMaterializationOptions } from "../materialize-routes.js";
+import { jobsErrorStatuses } from "./support.js";
+export { jobsErrorStatuses };
+export declare function jobsProcedures(options: RouteMaterializationOptions): Readonly<Record<string, unknown>>;
+//# sourceMappingURL=rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/jobs/rpc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAY5E,OAAO,EAA+B,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,wBAAgB,cAAc,CAC5B,OAAO,EAAE,2BAA2B,GACnC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMnC"}

package/dist/jobs/rpc.js

@@ -0,0 +1,115 @@
+import { asyncIteratorObject, ORPCError, os } from "@orpc/server";
+import { cancelJobRun, getJobRun, listJobRuns, retryJobRun, streamJobRun, triggerJob, watchJobRun, } from "./handlers.js";
+import { jobEnvelopeSchema, jobItemSchema } from "./common.js";
+import { exposedJobNodes, jobNodeFor, jobsErrorStatuses } from "./support.js";
+import { jobPolicy, jobsRuntime } from "./types.js";
+export { jobsErrorStatuses };
+export function jobsProcedures(options) {
+    if (jobsRuntime(options) === undefined)
+        return {};
+    const jobs = Object.fromEntries(exposedJobNodes(options).map((job) => [job.name, proceduresFor(options, job)]));
+    return Object.keys(jobs).length === 0 ? {} : { jobs };
+}
+function proceduresFor(options, job) {
+    const policy = jobPolicy(job);
+    const result = {};
+    if (policy.operations.includes("trigger")) {
+        result.trigger = call(options, job, "trigger", triggerJob);
+    }
+    const runs = {};
+    if (policy.operations.includes("get"))
+        runs.get = call(options, job, "get", getJobRun);
+    if (policy.operations.includes("list"))
+        runs.list = call(options, job, "list", listJobRuns);
+    if (policy.operations.includes("watch"))
+        runs.watch = streamCall(options, job, "watch", watchJobRun);
+    if (policy.operations.includes("stream"))
+        runs.stream = streamCall(options, job, "stream", streamJobRun);
+    if (policy.operations.includes("cancel"))
+        runs.cancel = call(options, job, "cancel", cancelJobRun);
+    if (policy.operations.includes("retry"))
+        runs.retry = call(options, job, "retry", retryJobRun);
+    if (Object.keys(runs).length > 0)
+        result.runs = runs;
+    return result;
+}
+function call(options, job, operation, handler) {
+    return os
+        .$context()
+        .errors(jobErrors)
+        .input(jobEnvelopeSchema)
+        .handler(({ input, context, signal }) => invoke(options, job, operation, () => handler(options, context, job, input, signal)));
+}
+function streamCall(options, job, operation, handler) {
+    return os
+        .$context()
+        .errors(jobErrors)
+        .input(jobEnvelopeSchema)
+        .output(asyncIteratorObject(jobItemSchema))
+        .handler(({ input, context, signal }) => invoke(options, job, operation, () => handler(options, context, job, input, signal)).then((value) => asAsyncIterator(value)));
+}
+async function invoke(options, job, operation, action) {
+    if (jobNodeFor(options, job.name) === undefined) {
+        throw new ORPCError("NOT_FOUND", { message: "Job was not found." });
+    }
+    try {
+        return await action();
+    }
+    catch (error) {
+        if (error instanceof ORPCError)
+            throw error;
+        const code = errorCode(error);
+        if (code !== undefined) {
+            const data = errorData(error);
+            throw new ORPCError(code, {
+                message: errorMessage(error),
+                ...(data === undefined ? {} : { data }),
+            });
+        }
+        throw error;
+    }
+}
+function errorData(value) {
+    if (!isRecord(value))
+        return undefined;
+    if ((value.code !== "RELKIT_JOB_SUBMISSION_UNKNOWN" &&
+        value.code !== "RELKIT_JOB_CONTROL_UNKNOWN") ||
+        value.outcome !== "unknown" ||
+        typeof value.operationId !== "string" ||
+        !isRecord(value.recovery) ||
+        (value.recovery.action !== "retry-with-same-key" &&
+            value.recovery.action !== "inspect-native" &&
+            value.recovery.action !== "unavailable")) {
+        return undefined;
+    }
+    return {
+        code: value.code,
+        outcome: "unknown",
+        operationId: value.operationId,
+        ...(typeof value.idempotencyKey === "string" ? { idempotencyKey: value.idempotencyKey } : {}),
+        recovery: {
+            action: value.recovery.action,
+            ...(typeof value.recovery.expiresAt === "string"
+                ? { expiresAt: value.recovery.expiresAt }
+                : {}),
+        },
+    };
+}
+const jobErrors = Object.fromEntries(Object.keys(jobsErrorStatuses).map((code) => [code, {}]));
+function asAsyncIterator(value) {
+    return value[Symbol.asyncIterator]();
+}
+function errorCode(value) {
+    return value !== null &&
+        typeof value === "object" &&
+        typeof value.code === "string"
+        ? value.code
+        : undefined;
+}
+function errorMessage(value) {
+    return value instanceof Error ? value.message : "Job operation failed.";
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object";
+}
+//# sourceMappingURL=rpc.js.map