@osolmaz/pi-workflows 0.7.0 → 0.8.0

package/README.md

@@ -13,8 +13,9 @@ structured, validated output to route on. See the
 [design philosophy](docs/DESIGN_PHILOSOPHY.md) for the principles behind the
 engine and its public parts. Running steps can publish durable [workflow
 updates](docs/WORKFLOW_UPDATES.md), including progress counts and ETA data.
-Agent instructions use compact [workflow step
-messages](docs/WORKFLOW_STEP_MESSAGES.md), and the built-in
+Remote workers can publish the same tracks through the storage-neutral
+[durable job progress API](docs/JOB_PROGRESS.md). Agent instructions use compact
+[workflow step messages](docs/WORKFLOW_STEP_MESSAGES.md), and the built-in
 [monitor](docs/MONITOR.md) reports every check without starting an extra
 assistant turn.
 

package/dist/job-progress/index.d.ts

@@ -0,0 +1,3 @@
+export { createJobProgressReporter, estimateJobProgress, type JobProgressReporter, } from "./reporter.js";
+export { isTerminalJobProgressState, MAX_JOB_PROGRESS_BYTES, MAX_JOB_PROGRESS_TRACKS, validateJobProgressSnapshot, } from "./validation.js";
+export { JOB_PROGRESS_SCHEMA, type JobProgressCost, type JobProgressEstimate, type JobProgressIdentity, type JobProgressPublish, type JobProgressPublishResult, type JobProgressReporterOptions, type JobProgressSnapshot, type JobProgressState, type JobProgressTrack, type JobProgressUpdate, } from "./types.js";

package/dist/job-progress/index.js

@@ -0,0 +1,4 @@
+export { createJobProgressReporter, estimateJobProgress, } from "./reporter.js";
+export { isTerminalJobProgressState, MAX_JOB_PROGRESS_BYTES, MAX_JOB_PROGRESS_TRACKS, validateJobProgressSnapshot, } from "./validation.js";
+export { JOB_PROGRESS_SCHEMA, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/job-progress/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/job-progress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,mBAAmB,GAWpB,MAAM,YAAY,CAAC"}

package/dist/job-progress/reporter.d.ts

@@ -0,0 +1,8 @@
+import { type JobProgressEstimate, type JobProgressPublishResult, type JobProgressReporterOptions, type JobProgressSnapshot, type JobProgressUpdate } from "./types.js";
+export type JobProgressReporter = {
+    report(update: JobProgressUpdate): Promise<JobProgressPublishResult>;
+    flush(): Promise<JobProgressPublishResult>;
+    snapshot(): JobProgressSnapshot;
+};
+export declare function createJobProgressReporter(options: JobProgressReporterOptions): JobProgressReporter;
+export declare function estimateJobProgress(snapshots: JobProgressSnapshot[], now?: Date): JobProgressEstimate;

package/dist/job-progress/reporter.js

@@ -0,0 +1,243 @@
+import { estimateProgress, } from "../workflows/index.js";
+import { JOB_PROGRESS_SCHEMA, } from "./types.js";
+import { isTerminalJobProgressState, validateJobProgressSnapshot } from "./validation.js";
+const DEFAULT_MINIMUM_INTERVAL_MS = 30_000;
+const DEFAULT_PUBLISH_TIMEOUT_MS = 15_000;
+export function createJobProgressReporter(options) {
+    const now = options.now ?? (() => new Date());
+    const minimumIntervalMs = nonNegativeInteger(options.minimumIntervalMs ?? DEFAULT_MINIMUM_INTERVAL_MS, "minimumIntervalMs");
+    const publishTimeoutMs = positiveInteger(options.publishTimeoutMs ?? DEFAULT_PUBLISH_TIMEOUT_MS, "publishTimeoutMs");
+    let current = options.previousSnapshot === undefined
+        ? validateJobProgressSnapshot({
+            schema: JOB_PROGRESS_SCHEMA,
+            application: options.application,
+            component: options.component,
+            jobId: options.jobId,
+            sourceRevision: options.sourceRevision,
+            contractHash: options.contractHash,
+            sequence: 0,
+            state: options.initialState ?? "running",
+            phase: options.initialPhase ?? "starting",
+            startedAt: options.startedAt,
+            updatedAt: options.startedAt,
+            ...(options.deadlineAt === undefined ? {} : { deadlineAt: options.deadlineAt }),
+            tracks: options.initialTracks,
+        })
+        : validatePreviousSnapshot(options, options.previousSnapshot);
+    const resumed = options.previousSnapshot !== undefined;
+    let lastQueuedAtMs = resumed ? Date.parse(current.updatedAt) : Number.NEGATIVE_INFINITY;
+    let lastQueuedSequence = -1;
+    let lastPublishedSequence = resumed ? current.sequence : -1;
+    let queuedOperation;
+    let tail = Promise.resolve();
+    const enqueue = (snapshot) => {
+        if (lastQueuedSequence === snapshot.sequence && queuedOperation !== undefined) {
+            return queuedOperation;
+        }
+        lastQueuedAtMs = Date.parse(snapshot.updatedAt);
+        lastQueuedSequence = snapshot.sequence;
+        const started = tail.then(() => startPublication(options.publish, cloneSnapshot(snapshot), publishTimeoutMs));
+        const operation = started.then(async (publication) => {
+            await publication.result;
+            lastPublishedSequence = Math.max(lastPublishedSequence, snapshot.sequence);
+        });
+        queuedOperation = operation;
+        tail = started.then((publication) => publication.settled).catch(() => undefined);
+        void operation
+            .finally(() => {
+            if (lastQueuedSequence === snapshot.sequence) {
+                lastQueuedSequence = -1;
+                queuedOperation = undefined;
+            }
+        })
+            .catch(() => undefined);
+        return operation;
+    };
+    return {
+        async report(update) {
+            if (isTerminalJobProgressState(current.state)) {
+                throw new Error("job progress cannot change after a terminal state");
+            }
+            if (current.sequence >= Number.MAX_SAFE_INTEGER) {
+                throw new Error("job progress sequence is exhausted");
+            }
+            const timestamp = now().toISOString();
+            const state = update.state ?? current.state;
+            const phase = update.phase ?? current.phase;
+            const finishedAt = isTerminalJobProgressState(state)
+                ? (update.finishedAt ?? timestamp)
+                : update.finishedAt;
+            const tracks = isTerminalJobProgressState(state)
+                ? terminalizeTracks(update.tracks ?? current.tracks, state)
+                : (update.tracks ?? current.tracks);
+            const next = validateJobProgressSnapshot({
+                ...current,
+                sequence: current.sequence + 1,
+                state,
+                phase,
+                updatedAt: timestamp,
+                tracks,
+                ...(update.cost === undefined ? {} : { cost: update.cost }),
+                ...(finishedAt === undefined ? {} : { finishedAt }),
+            });
+            assertMonotonicTracks(current, next);
+            const publishNow = update.force === true ||
+                phase !== current.phase ||
+                isTerminalJobProgressState(state) ||
+                Date.parse(timestamp) - lastQueuedAtMs >= minimumIntervalMs;
+            current = next;
+            if (!publishNow)
+                return { snapshot: cloneSnapshot(next), published: false };
+            await enqueue(next);
+            return { snapshot: cloneSnapshot(next), published: true };
+        },
+        async flush() {
+            const snapshot = current;
+            if (lastPublishedSequence >= snapshot.sequence) {
+                await tail;
+                return { snapshot: cloneSnapshot(snapshot), published: false };
+            }
+            await enqueue(snapshot);
+            return { snapshot: cloneSnapshot(snapshot), published: true };
+        },
+        snapshot() {
+            return cloneSnapshot(current);
+        },
+    };
+}
+export function estimateJobProgress(snapshots, now = new Date()) {
+    if (snapshots.length === 0)
+        throw new Error("job progress estimation requires at least one snapshot");
+    const validated = snapshots
+        .map(validateJobProgressSnapshot)
+        .sort((left, right) => left.sequence - right.sequence);
+    const latest = validated.at(-1);
+    for (const snapshot of validated)
+        assertSameIdentity(latest, snapshot);
+    for (let index = 1; index < validated.length; index += 1) {
+        const previous = validated[index - 1];
+        const current = validated[index];
+        if (previous.sequence === current.sequence) {
+            throw new Error(`job progress sequence ${current.sequence} is duplicated`);
+        }
+        if (Date.parse(previous.updatedAt) > Date.parse(current.updatedAt)) {
+            throw new Error("job progress updatedAt must not decrease as sequence increases");
+        }
+    }
+    const keys = latest.tracks.map((track) => track.key);
+    const tracks = keys.map((key) => {
+        const samples = validated.flatMap((snapshot) => {
+            const track = snapshot.tracks.find((candidate) => candidate.key === key);
+            return track === undefined ? [] : [{ at: snapshot.updatedAt, data: track.data }];
+        });
+        return { key, samples, estimate: estimateProgress(key, samples, now) };
+    });
+    return {
+        snapshot: cloneSnapshot(latest),
+        tracks,
+        estimates: tracks.map((track) => track.estimate),
+    };
+}
+function terminalizeTracks(tracks, state) {
+    return tracks.map((track) => ({
+        key: track.key,
+        data: {
+            ...track.data,
+            status: track.data.status === "completed" ||
+                track.data.status === "failed" ||
+                track.data.status === "cancelled"
+                ? track.data.status
+                : state,
+        },
+    }));
+}
+function assertMonotonicTracks(previous, next) {
+    if (previous.phase !== next.phase)
+        return;
+    for (const track of next.tracks) {
+        const prior = previous.tracks.find((candidate) => candidate.key === track.key);
+        if (prior === undefined || resetsTrack(prior, track))
+            continue;
+        if (prior.data.completed !== undefined &&
+            track.data.completed !== undefined &&
+            track.data.completed < prior.data.completed) {
+            throw new Error(`job progress track ${track.key} completed value must not decrease`);
+        }
+    }
+}
+function resetsTrack(previous, next) {
+    return (previous.data.phase !== next.data.phase ||
+        previous.data.unit !== next.data.unit ||
+        previous.data.total !== next.data.total);
+}
+function assertSameIdentity(expected, actual) {
+    for (const field of [
+        "application",
+        "component",
+        "jobId",
+        "sourceRevision",
+        "contractHash",
+        "startedAt",
+    ]) {
+        if (expected[field] !== actual[field]) {
+            throw new Error(`job progress sample ${field} does not match`);
+        }
+    }
+}
+function startPublication(publish, snapshot, timeoutMs) {
+    const controller = new AbortController();
+    let timeout;
+    const write = publish(snapshot, controller.signal);
+    const deadline = new Promise((_resolve, reject) => {
+        timeout = setTimeout(() => {
+            controller.abort();
+            reject(new Error(`job progress publication timed out after ${timeoutMs} ms`));
+        }, timeoutMs);
+    });
+    const result = Promise.race([write, deadline]).finally(() => {
+        if (timeout !== undefined)
+            clearTimeout(timeout);
+    });
+    return {
+        result,
+        settled: write.then(() => undefined, () => undefined),
+    };
+}
+function validatePreviousSnapshot(identity, previous) {
+    const validated = validateJobProgressSnapshot(previous);
+    for (const field of [
+        "application",
+        "component",
+        "jobId",
+        "sourceRevision",
+        "contractHash",
+        "startedAt",
+    ]) {
+        if (identity[field] !== validated[field]) {
+            throw new Error(`job progress previous snapshot ${field} does not match`);
+        }
+    }
+    if (isTerminalJobProgressState(validated.state)) {
+        throw new Error("job progress cannot resume from a terminal snapshot");
+    }
+    if (identity.deadlineAt !== validated.deadlineAt) {
+        throw new Error("job progress previous snapshot deadlineAt does not match");
+    }
+    return validated;
+}
+function cloneSnapshot(snapshot) {
+    return structuredClone(snapshot);
+}
+function nonNegativeInteger(value, field) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`${field} must be a non-negative safe integer`);
+    }
+    return value;
+}
+function positiveInteger(value, field) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new Error(`${field} must be a positive safe integer`);
+    }
+    return value;
+}
+//# sourceMappingURL=reporter.js.map

package/dist/job-progress/reporter.js.map

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

package/dist/job-progress/types.d.ts

@@ -0,0 +1,65 @@
+import type { ProgressEstimate, ProgressTrackState, WorkflowProgressData } from "../workflows/index.js";
+export declare const JOB_PROGRESS_SCHEMA: "pi-workflows.job-progress.v1";
+export type JobProgressState = "queued" | "running" | "waiting" | "blocked" | "completed" | "failed" | "cancelled" | "unknown";
+export type JobProgressTrack = {
+    key: string;
+    data: WorkflowProgressData;
+};
+export type JobProgressCost = {
+    settledUsd: number;
+    reservedUsd: number;
+};
+export type JobProgressSnapshot = {
+    schema: typeof JOB_PROGRESS_SCHEMA;
+    application: string;
+    component: string;
+    jobId: string;
+    sourceRevision: string;
+    contractHash: string;
+    sequence: number;
+    state: JobProgressState;
+    phase: string;
+    startedAt: string;
+    updatedAt: string;
+    deadlineAt?: string;
+    finishedAt?: string;
+    tracks: JobProgressTrack[];
+    cost?: JobProgressCost;
+};
+export type JobProgressIdentity = Pick<JobProgressSnapshot, "application" | "component" | "jobId" | "sourceRevision" | "contractHash" | "startedAt"> & {
+    deadlineAt?: string;
+};
+export type JobProgressUpdate = {
+    state?: JobProgressState;
+    phase?: string;
+    tracks?: JobProgressTrack[];
+    cost?: JobProgressCost;
+    finishedAt?: string;
+    force?: boolean;
+};
+export type JobProgressPublish = (snapshot: JobProgressSnapshot, signal: AbortSignal) => Promise<void>;
+type JobProgressReporterBaseOptions = JobProgressIdentity & {
+    initialState?: Exclude<JobProgressState, "completed" | "failed" | "cancelled">;
+    initialPhase?: string;
+    publish: JobProgressPublish;
+    minimumIntervalMs?: number;
+    publishTimeoutMs?: number;
+    now?: () => Date;
+};
+export type JobProgressReporterOptions = JobProgressReporterBaseOptions & ({
+    initialTracks: JobProgressTrack[];
+    previousSnapshot?: never;
+} | {
+    initialTracks?: JobProgressTrack[];
+    previousSnapshot: JobProgressSnapshot;
+});
+export type JobProgressPublishResult = {
+    snapshot: JobProgressSnapshot;
+    published: boolean;
+};
+export type JobProgressEstimate = {
+    snapshot: JobProgressSnapshot;
+    tracks: ProgressTrackState[];
+    estimates: ProgressEstimate[];
+};
+export {};

package/dist/job-progress/types.js

@@ -0,0 +1,2 @@
+export const JOB_PROGRESS_SCHEMA = "pi-workflows.job-progress.v1";
+//# sourceMappingURL=types.js.map

package/dist/job-progress/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/job-progress/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAAuC,CAAC"}

package/dist/job-progress/validation.d.ts

@@ -0,0 +1,5 @@
+import { type JobProgressSnapshot, type JobProgressState } from "./types.js";
+export declare const MAX_JOB_PROGRESS_BYTES: number;
+export declare const MAX_JOB_PROGRESS_TRACKS = 128;
+export declare function validateJobProgressSnapshot(value: unknown): JobProgressSnapshot;
+export declare function isTerminalJobProgressState(state: JobProgressState): state is "completed" | "failed" | "cancelled";

package/dist/job-progress/validation.js

@@ -0,0 +1,227 @@
+import { validateProgressData } from "../workflows/index.js";
+import { JOB_PROGRESS_SCHEMA, } from "./types.js";
+export const MAX_JOB_PROGRESS_BYTES = 64 * 1024;
+export const MAX_JOB_PROGRESS_TRACKS = 128;
+const SNAPSHOT_FIELDS = new Set([
+    "schema",
+    "application",
+    "component",
+    "jobId",
+    "sourceRevision",
+    "contractHash",
+    "sequence",
+    "state",
+    "phase",
+    "startedAt",
+    "updatedAt",
+    "deadlineAt",
+    "finishedAt",
+    "tracks",
+    "cost",
+]);
+const TRACK_FIELDS = new Set(["key", "data"]);
+const COST_FIELDS = new Set(["settledUsd", "reservedUsd"]);
+const STATES = new Set([
+    "queued",
+    "running",
+    "waiting",
+    "blocked",
+    "completed",
+    "failed",
+    "cancelled",
+    "unknown",
+]);
+const KEY_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/;
+const RFC_3339_PATTERN = /^(\d{4})-(\d{2})-(\d{2})T(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/;
+export function validateJobProgressSnapshot(value) {
+    const bytes = jsonBytes(value);
+    if (bytes > MAX_JOB_PROGRESS_BYTES) {
+        throw new Error(`job progress snapshot must be at most ${MAX_JOB_PROGRESS_BYTES} bytes`);
+    }
+    if (!isRecord(value))
+        throw new Error("job progress snapshot must be an object");
+    rejectUnknown(value, SNAPSHOT_FIELDS, "job progress");
+    if (value.schema !== JOB_PROGRESS_SCHEMA) {
+        throw new Error(`job progress.schema must equal ${JOB_PROGRESS_SCHEMA}`);
+    }
+    const application = requiredText(value.application, "job progress.application", 100);
+    const component = requiredText(value.component, "job progress.component", 100);
+    const jobId = requiredText(value.jobId, "job progress.jobId", 200);
+    const sourceRevision = requiredText(value.sourceRevision, "job progress.sourceRevision", 200);
+    const contractHash = requiredText(value.contractHash, "job progress.contractHash", 200);
+    const sequence = requiredInteger(value.sequence, "job progress.sequence");
+    const state = requiredState(value.state);
+    const phase = requiredText(value.phase, "job progress.phase", 100);
+    const startedAt = requiredTimestamp(value.startedAt, "job progress.startedAt");
+    const updatedAt = requiredTimestamp(value.updatedAt, "job progress.updatedAt");
+    const deadlineAt = optionalTimestamp(value.deadlineAt, "job progress.deadlineAt");
+    const finishedAt = optionalTimestamp(value.finishedAt, "job progress.finishedAt");
+    const tracks = requiredTracks(value.tracks);
+    const cost = optionalCost(value.cost);
+    if (Date.parse(updatedAt) < Date.parse(startedAt)) {
+        throw new Error("job progress.updatedAt must not be before startedAt");
+    }
+    if (deadlineAt !== undefined && Date.parse(deadlineAt) <= Date.parse(startedAt)) {
+        throw new Error("job progress.deadlineAt must be after startedAt");
+    }
+    if (finishedAt !== undefined && Date.parse(finishedAt) < Date.parse(startedAt)) {
+        throw new Error("job progress.finishedAt must not be before startedAt");
+    }
+    if (finishedAt !== undefined && Date.parse(finishedAt) > Date.parse(updatedAt)) {
+        throw new Error("job progress.finishedAt must not be after updatedAt");
+    }
+    if (isTerminal(state) && finishedAt === undefined) {
+        throw new Error("job progress.finishedAt is required for a terminal state");
+    }
+    if (!isTerminal(state) && finishedAt !== undefined) {
+        throw new Error("job progress.finishedAt is allowed only for a terminal state");
+    }
+    if (isTerminal(state) && tracks.some((track) => !isTerminalTrack(track))) {
+        throw new Error("job progress tracks must be terminal when the job state is terminal");
+    }
+    return {
+        schema: JOB_PROGRESS_SCHEMA,
+        application,
+        component,
+        jobId,
+        sourceRevision,
+        contractHash,
+        sequence,
+        state,
+        phase,
+        startedAt,
+        updatedAt,
+        ...(deadlineAt === undefined ? {} : { deadlineAt }),
+        ...(finishedAt === undefined ? {} : { finishedAt }),
+        tracks,
+        ...(cost === undefined ? {} : { cost }),
+    };
+}
+export function isTerminalJobProgressState(state) {
+    return isTerminal(state);
+}
+function requiredTracks(value) {
+    if (!Array.isArray(value))
+        throw new Error("job progress.tracks must be an array");
+    if (value.length < 1)
+        throw new Error("job progress.tracks must contain at least one entry");
+    if (value.length > MAX_JOB_PROGRESS_TRACKS) {
+        throw new Error(`job progress.tracks must contain at most ${MAX_JOB_PROGRESS_TRACKS} entries`);
+    }
+    const keys = new Set();
+    return value.map((item, index) => {
+        if (!isRecord(item))
+            throw new Error(`job progress.tracks[${index}] must be an object`);
+        rejectUnknown(item, TRACK_FIELDS, `job progress.tracks[${index}]`);
+        if (typeof item.key !== "string" || !KEY_PATTERN.test(item.key)) {
+            throw new Error(`job progress.tracks[${index}].key must match [A-Za-z0-9][A-Za-z0-9._:/-]{0,127}`);
+        }
+        if (keys.has(item.key))
+            throw new Error(`job progress track key ${item.key} is duplicated`);
+        keys.add(item.key);
+        if (!isRecord(item.data)) {
+            throw new Error(`job progress.tracks[${index}].data must be an object`);
+        }
+        return { key: item.key, data: structuredClone(validateProgressData(item.data)) };
+    });
+}
+function optionalCost(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw new Error("job progress.cost must be an object");
+    rejectUnknown(value, COST_FIELDS, "job progress.cost");
+    return {
+        settledUsd: requiredNonNegative(value.settledUsd, "job progress.cost.settledUsd"),
+        reservedUsd: requiredNonNegative(value.reservedUsd, "job progress.cost.reservedUsd"),
+    };
+}
+function requiredState(value) {
+    if (typeof value !== "string" || !STATES.has(value)) {
+        throw new Error("job progress.state is invalid");
+    }
+    return value;
+}
+function requiredText(value, field, max) {
+    if (typeof value !== "string" || value.trim().length < 1 || value.trim().length > max) {
+        throw new Error(`${field} must be 1 to ${max} characters`);
+    }
+    if ([...value].some(isControlCharacter))
+        throw new Error(`${field} must not contain control characters`);
+    return value;
+}
+function requiredInteger(value, field) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`${field} must be a non-negative safe integer`);
+    }
+    return value;
+}
+function requiredNonNegative(value, field) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new Error(`${field} must be a finite non-negative number`);
+    }
+    return value;
+}
+function requiredTimestamp(value, field) {
+    const parsed = optionalTimestamp(value, field);
+    if (parsed === undefined)
+        throw new Error(`${field} is required`);
+    return parsed;
+}
+function optionalTimestamp(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string") {
+        throw new Error(`${field} must be an RFC 3339 timestamp with an offset`);
+    }
+    const match = RFC_3339_PATTERN.exec(value);
+    if (match === null || !validCalendarDate(match[1], match[2], match[3])) {
+        throw new Error(`${field} must be an RFC 3339 timestamp with an offset`);
+    }
+    return value;
+}
+function validCalendarDate(yearText, monthText, dayText) {
+    const year = Number(yearText);
+    const month = Number(monthText);
+    const day = Number(dayText);
+    if (!Number.isInteger(year) || year < 1 || month < 1 || month > 12 || day < 1)
+        return false;
+    return day <= new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+function rejectUnknown(value, allowed, field) {
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key))
+            throw new Error(`${field}.${key} is not supported`);
+    }
+}
+function isRecord(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function jsonBytes(value) {
+    let encoded;
+    try {
+        encoded = JSON.stringify(value);
+    }
+    catch {
+        throw new Error("job progress snapshot must be JSON serializable");
+    }
+    if (encoded === undefined)
+        throw new Error("job progress snapshot must be JSON serializable");
+    return Buffer.byteLength(encoded, "utf8");
+}
+function isControlCharacter(character) {
+    const code = character.codePointAt(0) ?? 0;
+    return code < 32 || (code >= 127 && code <= 159);
+}
+function isTerminal(state) {
+    return state === "completed" || state === "failed" || state === "cancelled";
+}
+function isTerminalTrack(track) {
+    return (track.data.status === "completed" ||
+        track.data.status === "failed" ||
+        track.data.status === "cancelled");
+}
+//# sourceMappingURL=validation.js.map

package/dist/job-progress/validation.js.map

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