@lumenkey/cli 0.3.0 → 0.4.0-rc.1

package/dist/studio/output-save-contract.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { uuid, isoDate, errorCode } from './run-journal.js';
+const integer = z.number().int().nonnegative().safe();
+export const saveState = z.enum(['ACCEPTED', 'SAVING', 'SAVED', 'FAILED', 'RECOVERY_REQUIRED', 'BLOCKED']);
+export const saveStage = z.enum(['QUEUED', 'DOWNLOADING', 'FILE_READY', 'REGISTERED', 'LINKED', 'RECONCILING']);
+export const saveFacts = z.object({ file: z.enum(['NOT_CHECKED', 'ABSENT', 'PARTIAL', 'MISSING', 'UNSAFE', 'UNKNOWN']), registration: z.enum(['ABSENT', 'PRESENT', 'UNKNOWN']), relation: z.enum(['ABSENT', 'PRESENT', 'UNKNOWN']) }).strict();
+const diagnostic = z.object({ code: errorCode, message: z.string().max(1000), type: z.string().max(80), httpStatus: z.number().int().min(400).max(599).optional(), retryable: z.boolean(), mayAlreadyBeSaved: z.boolean().nullable() }).strict();
+const asset = z.object({ assetId: uuid, displayName: z.string().min(1).max(300), mediaType: z.enum(['image/png', 'image/jpeg', 'image/webp', 'video/mp4', 'video/webm']), byteLength: integer.positive(), sha256: z.string().regex(/^[a-f0-9]{64}$/), relativePath: z.string().min(1), absolutePath: z.string().min(1), contentUrl: z.string().min(1) }).strict();
+export const saveMutable = z.object({ state: saveState, stage: saveStage, attempt: integer, facts: saveFacts, asset: asset.nullable(), error: diagnostic.nullable(), retryable: z.boolean(), safeRetry: z.boolean(), mayAlreadyBeSaved: z.boolean().nullable(), checkedAt: z.null() }).strict();
+// Ordinary writers retain the p2 restrictions above. Only the integrity proof
+// path may publish these additive p3 observation fields. Progress is volatile.
+export const integrityFact = z.enum(['NOT_CHECKED', 'ABSENT', 'PARTIAL', 'VERIFIED', 'MISSING', 'MODIFIED', 'UNSAFE', 'UNKNOWN']);
+export const saveReceiptSnapshot = saveMutable.extend({ facts: saveFacts.extend({ file: integrityFact }), checkedAt: isoDate.nullable(), integrityCheck: z.enum(['IDLE', 'PENDING']).default('IDLE'), operationId: uuid, revision: integer.positive(), localOutputId: uuid, runId: uuid, jobId: uuid, gatewayAssetId: uuid, createdAt: isoDate, updatedAt: isoDate }).strict();
+// Private transport evidence: committed before publishing bytes, never sent on HTTP.
+export const saveTransfer = z.object({ temporaryName: z.string().regex(/^[a-f0-9-]{36}\.\d+\.part$/), owner: z.object({ dev: z.string().regex(/^\d+$/), ino: z.string().regex(/^[1-9]\d*$/), birthtimeMs: z.number().nonnegative().finite() }).strict().optional(), completed: z.object({ mediaType: asset.shape.mediaType, byteLength: integer.positive(), sha256: asset.shape.sha256, relativePath: z.string() }).strict().optional() }).strict();
+export const saveOperation = z.object({ connectionId: uuid, requestIds: z.array(uuid).min(1).max(1000).refine(v => new Set(v).size === v.length), assetId: uuid, executionRevision: integer.positive().default(1), transfer: saveTransfer.optional(), receipt: saveReceiptSnapshot }).strict().refine(o => {
+    // Local reconciliation increments the execution attempt but retains the byte
+    // owner's original temp identity. It cannot adopt a future/zero attempt.
+    const ownerAttempt = o.transfer ? Number(o.transfer.temporaryName.split('.').at(-2)) : 0;
+    return (!o.transfer || (Number.isSafeInteger(ownerAttempt) && ownerAttempt > 0 && ownerAttempt <= o.receipt.attempt && o.transfer.temporaryName === `${o.assetId}.${ownerAttempt}.part`)) && (!o.transfer?.completed || o.transfer.completed.relativePath === `assets/${o.assetId}.${{ 'image/png': 'png', 'image/jpeg': 'jpg', 'image/webp': 'webp', 'video/mp4': 'mp4', 'video/webm': 'webm' }[o.transfer.completed.mediaType]}`) && (!o.receipt.asset || o.receipt.asset.assetId === o.assetId) && (o.receipt.facts.file !== 'VERIFIED' || (o.receipt.asset && o.receipt.checkedAt !== null && o.receipt.integrityCheck === 'IDLE')) && (o.receipt.integrityCheck !== 'PENDING' || (o.receipt.facts.file === 'NOT_CHECKED' && !o.receipt.safeRetry)) && (o.receipt.state !== 'SAVED' || (o.receipt.stage === 'LINKED' && o.receipt.asset && o.receipt.facts.registration === 'PRESENT' && o.receipt.facts.relation === 'PRESENT'));
+});
+// Validate schema1 under its actual p2 vocabulary before applying p3 defaults.
+// Otherwise malformed old files could introduce VERIFIED or a stuck PENDING.
+export const legacySaveOperation = saveOperation.innerType().omit({ executionRevision: true }).extend({ receipt: saveReceiptSnapshot.omit({ integrityCheck: true }).extend({ facts: saveFacts, checkedAt: z.null() }).strict() }).strict().refine(o => saveOperation.safeParse(o).success && (o.receipt.state !== 'SAVED' || o.receipt.facts.file === 'NOT_CHECKED'));
+export const saveAcceptInput = z.object({ connectionId: uuid, requestId: uuid, localOutputId: uuid, runId: uuid, jobId: uuid, gatewayAssetId: uuid }).strict();
+//# sourceMappingURL=output-save-contract.js.map