@greatwait/contracts 0.3.0 → 0.3.2

package/dist/scheduling-records.d.ts

@@ -34,11 +34,21 @@ export declare const portableScheduleRecordSchema: import("zod").ZodObject<{
             name: import("zod").ZodString;
             suppressed: import("zod").ZodLiteral<true>;
         }, import("zod/v4/core").$strict>]>>;
-        encryptedTemplate: import("zod").ZodOptional<import("zod").ZodObject<{
+        encryptedTemplate: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodObject<{
             keyId: import("zod").ZodLiteral<"v1">;
             nonce: import("zod").ZodString;
             ciphertext: import("zod").ZodString;
-        }, import("zod/v4/core").$strict>>;
+        }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+            keyId: import("zod").ZodLiteral<"v1">;
+            nonce: import("zod").ZodString;
+            ciphertext: import("zod").ZodString;
+            version: import("zod").ZodLiteral<2>;
+            codec: import("zod").ZodEnum<{
+                identity: "identity";
+                gzip: "gzip";
+            }>;
+            originalBytes: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strict>]>>;
     }, import("zod/v4/core").$strict>>;
     httpTemplateRetentionDueAt: import("zod").ZodOptional<import("zod").ZodString>;
     authority: import("zod").ZodObject<{
@@ -106,9 +116,14 @@ export declare const portableScheduleRecordSchema: import("zod").ZodObject<{
     generation: import("zod").ZodNumber;
     id: import("zod").ZodString;
     latencyClass: import("zod").ZodEnum<{
-        realtime: "realtime";
         bulk: "bulk";
+        realtime: "realtime";
     }>;
+    requestedLatencyClass: import("zod").ZodOptional<import("zod").ZodEnum<{
+        bulk: "bulk";
+        realtime: "realtime";
+        auto: "auto";
+    }>>;
     lateness: import("zod").ZodObject<{
         maxStalenessSeconds: import("zod").ZodOptional<import("zod").ZodNumber>;
         policy: import("zod").ZodEnum<{
@@ -169,6 +184,7 @@ export declare const portableOccurrenceRecordSchema: import("zod").ZodObject<{
     id: import("zod").ZodString;
     plannedFor: import("zod").ZodString;
     schedule: import("zod").ZodString;
+    scheduleName: import("zod").ZodOptional<import("zod").ZodString>;
     sequence: import("zod").ZodNumber;
     settledAt: import("zod").ZodOptional<import("zod").ZodString>;
     state: import("zod").ZodEnum<{
@@ -269,6 +285,12 @@ export declare const portableAttemptRecordSchema: import("zod").ZodObject<{
         expired: "expired";
         not_captured: "not_captured";
     }>>;
+    requestUnavailable: import("zod").ZodOptional<import("zod").ZodEnum<{
+        schedule_changed: "schedule_changed";
+        endpoint_changed: "endpoint_changed";
+        endpoint_deleted: "endpoint_deleted";
+        payload_deleted: "payload_deleted";
+    }>>;
     responseHeaders: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
         name: import("zod").ZodString;
         value: import("zod").ZodString;
@@ -349,11 +371,21 @@ export declare const portableAttemptRecordSchema: import("zod").ZodObject<{
             name: import("zod").ZodString;
             suppressed: import("zod").ZodLiteral<true>;
         }, import("zod/v4/core").$strict>]>>;
-        encryptedTemplate: import("zod").ZodOptional<import("zod").ZodObject<{
+        encryptedTemplate: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodObject<{
             keyId: import("zod").ZodLiteral<"v1">;
             nonce: import("zod").ZodString;
             ciphertext: import("zod").ZodString;
-        }, import("zod/v4/core").$strict>>;
+        }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+            keyId: import("zod").ZodLiteral<"v1">;
+            nonce: import("zod").ZodString;
+            ciphertext: import("zod").ZodString;
+            version: import("zod").ZodLiteral<2>;
+            codec: import("zod").ZodEnum<{
+                identity: "identity";
+                gzip: "gzip";
+            }>;
+            originalBytes: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strict>]>>;
     }, import("zod/v4/core").$strict>>;
     httpPayloadRetentionDueAt: import("zod").ZodOptional<import("zod").ZodString>;
     authority: import("zod").ZodObject<{
@@ -371,7 +403,10 @@ export declare const portableAttemptRecordSchema: import("zod").ZodObject<{
 }, import("zod/v4/core").$strict>;
 export type PortableAttemptRecord = z.infer<typeof portableAttemptRecordSchema>;
 export declare const portableEncryptedPayloadRecordSchema: import("zod").ZodObject<{
-    aadVersion: import("zod").ZodLiteral<"greatwait.schedule-payload.v1">;
+    aadVersion: import("zod").ZodEnum<{
+        "greatwait.schedule-payload.v1": "greatwait.schedule-payload.v1";
+        "greatwait.schedule-payload.v2": "greatwait.schedule-payload.v2";
+    }>;
     authority: import("zod").ZodObject<{
         environment: import("zod").ZodString;
         environmentKind: import("zod").ZodEnum<{
@@ -381,11 +416,21 @@ export declare const portableEncryptedPayloadRecordSchema: import("zod").ZodObje
         organization: import("zod").ZodString;
         project: import("zod").ZodString;
     }, import("zod/v4/core").$strict>;
-    envelope: import("zod").ZodObject<{
+    envelope: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
         ciphertext: import("zod").ZodString;
         keyId: import("zod").ZodString;
         nonce: import("zod").ZodString;
-    }, import("zod/v4/core").$strict>;
+    }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+        ciphertext: import("zod").ZodString;
+        keyId: import("zod").ZodString;
+        nonce: import("zod").ZodString;
+        version: import("zod").ZodLiteral<2>;
+        codec: import("zod").ZodEnum<{
+            identity: "identity";
+            gzip: "gzip";
+        }>;
+        originalBytes: import("zod").ZodNumber;
+    }, import("zod/v4/core").$strict>]>;
     plaintextBytes: import("zod").ZodNumber;
     retentionDueAt: import("zod").ZodOptional<import("zod").ZodString>;
     schedule: import("zod").ZodString;
@@ -457,6 +502,12 @@ export declare const portableSchedulingRecordSetSchema: import("zod").ZodObject<
             expired: "expired";
             not_captured: "not_captured";
         }>>;
+        requestUnavailable: import("zod").ZodOptional<import("zod").ZodEnum<{
+            schedule_changed: "schedule_changed";
+            endpoint_changed: "endpoint_changed";
+            endpoint_deleted: "endpoint_deleted";
+            payload_deleted: "payload_deleted";
+        }>>;
         responseHeaders: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
             name: import("zod").ZodString;
             value: import("zod").ZodString;
@@ -537,11 +588,21 @@ export declare const portableSchedulingRecordSetSchema: import("zod").ZodObject<
                 name: import("zod").ZodString;
                 suppressed: import("zod").ZodLiteral<true>;
             }, import("zod/v4/core").$strict>]>>;
-            encryptedTemplate: import("zod").ZodOptional<import("zod").ZodObject<{
+            encryptedTemplate: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodObject<{
                 keyId: import("zod").ZodLiteral<"v1">;
                 nonce: import("zod").ZodString;
                 ciphertext: import("zod").ZodString;
-            }, import("zod/v4/core").$strict>>;
+            }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+                keyId: import("zod").ZodLiteral<"v1">;
+                nonce: import("zod").ZodString;
+                ciphertext: import("zod").ZodString;
+                version: import("zod").ZodLiteral<2>;
+                codec: import("zod").ZodEnum<{
+                    identity: "identity";
+                    gzip: "gzip";
+                }>;
+                originalBytes: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strict>]>>;
         }, import("zod/v4/core").$strict>>;
         httpPayloadRetentionDueAt: import("zod").ZodOptional<import("zod").ZodString>;
         authority: import("zod").ZodObject<{
@@ -562,6 +623,7 @@ export declare const portableSchedulingRecordSetSchema: import("zod").ZodObject<
         id: import("zod").ZodString;
         plannedFor: import("zod").ZodString;
         schedule: import("zod").ZodString;
+        scheduleName: import("zod").ZodOptional<import("zod").ZodString>;
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
@@ -599,7 +661,10 @@ export declare const portableSchedulingRecordSetSchema: import("zod").ZodObject<
         updatedAt: import("zod").ZodString;
     }, import("zod/v4/core").$strict>>;
     payload: import("zod").ZodOptional<import("zod").ZodObject<{
-        aadVersion: import("zod").ZodLiteral<"greatwait.schedule-payload.v1">;
+        aadVersion: import("zod").ZodEnum<{
+            "greatwait.schedule-payload.v1": "greatwait.schedule-payload.v1";
+            "greatwait.schedule-payload.v2": "greatwait.schedule-payload.v2";
+        }>;
         authority: import("zod").ZodObject<{
             environment: import("zod").ZodString;
             environmentKind: import("zod").ZodEnum<{
@@ -609,11 +674,21 @@ export declare const portableSchedulingRecordSetSchema: import("zod").ZodObject<
             organization: import("zod").ZodString;
             project: import("zod").ZodString;
         }, import("zod/v4/core").$strict>;
-        envelope: import("zod").ZodObject<{
+        envelope: import("zod").ZodUnion<readonly [import("zod").ZodObject<{
             ciphertext: import("zod").ZodString;
             keyId: import("zod").ZodString;
             nonce: import("zod").ZodString;
-        }, import("zod/v4/core").$strict>;
+        }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
+            ciphertext: import("zod").ZodString;
+            keyId: import("zod").ZodString;
+            nonce: import("zod").ZodString;
+            version: import("zod").ZodLiteral<2>;
+            codec: import("zod").ZodEnum<{
+                identity: "identity";
+                gzip: "gzip";
+            }>;
+            originalBytes: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strict>]>;
         plaintextBytes: import("zod").ZodNumber;
         retentionDueAt: import("zod").ZodOptional<import("zod").ZodString>;
         schedule: import("zod").ZodString;
@@ -677,11 +752,21 @@ export declare const portableSchedulingRecordSetSchema: import("zod").ZodObject<
                 name: import("zod").ZodString;
                 suppressed: import("zod").ZodLiteral<true>;
             }, import("zod/v4/core").$strict>]>>;
-            encryptedTemplate: import("zod").ZodOptional<import("zod").ZodObject<{
+            encryptedTemplate: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+                keyId: import("zod").ZodLiteral<"v1">;
+                nonce: import("zod").ZodString;
+                ciphertext: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
                 keyId: import("zod").ZodLiteral<"v1">;
                 nonce: import("zod").ZodString;
                 ciphertext: import("zod").ZodString;
-            }, import("zod/v4/core").$strict>>;
+                version: import("zod").ZodLiteral<2>;
+                codec: import("zod").ZodEnum<{
+                    identity: "identity";
+                    gzip: "gzip";
+                }>;
+                originalBytes: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strict>]>>;
         }, import("zod/v4/core").$strict>>;
         httpTemplateRetentionDueAt: import("zod").ZodOptional<import("zod").ZodString>;
         authority: import("zod").ZodObject<{
@@ -749,9 +834,14 @@ export declare const portableSchedulingRecordSetSchema: import("zod").ZodObject<
         generation: import("zod").ZodNumber;
         id: import("zod").ZodString;
         latencyClass: import("zod").ZodEnum<{
-            realtime: "realtime";
             bulk: "bulk";
+            realtime: "realtime";
         }>;
+        requestedLatencyClass: import("zod").ZodOptional<import("zod").ZodEnum<{
+            bulk: "bulk";
+            realtime: "realtime";
+            auto: "auto";
+        }>>;
         lateness: import("zod").ZodObject<{
             maxStalenessSeconds: import("zod").ZodOptional<import("zod").ZodNumber>;
             policy: import("zod").ZodEnum<{

package/dist/scheduling-records.js

@@ -116,19 +116,35 @@ const base64UrlBytesSchema = z
     .refine((value) => decodeBase64UrlBytes(value) !== undefined, {
     message: "must canonically encode base64url bytes",
 });
+const portableLegacyPayloadEnvelopeSchema = z.strictObject({
+    ciphertext: base64UrlBytesSchema,
+    keyId: z
+        .string()
+        .min(1)
+        .max(128)
+        .regex(/^[A-Za-z0-9._:-]+$/u, "must be a safe key identifier"),
+    nonce: base64UrlBytesSchema.refine((value) => decodeBase64UrlBytes(value)?.length === 12, { message: "must encode exactly 12 bytes" }),
+});
+const portableV2PayloadEnvelopeSchema = portableLegacyPayloadEnvelopeSchema.extend({
+    version: z.literal(2),
+    codec: z.enum(["identity", "gzip"]),
+    originalBytes: z
+        .number()
+        .int()
+        .nonnegative()
+        .max(SCHEDULING_BOUNDS.payloadBytes),
+});
 export const portableEncryptedPayloadRecordSchema = z
     .strictObject({
-    aadVersion: z.literal(SCHEDULE_PAYLOAD_AAD_VERSION),
+    aadVersion: z.enum([
+        SCHEDULE_PAYLOAD_AAD_VERSION,
+        "greatwait.schedule-payload.v2",
+    ]),
     authority: portableAuthoritySchema,
-    envelope: z.strictObject({
-        ciphertext: base64UrlBytesSchema,
-        keyId: z
-            .string()
-            .min(1)
-            .max(128)
-            .regex(/^[A-Za-z0-9._:-]+$/u, "must be a safe key identifier"),
-        nonce: base64UrlBytesSchema.refine((value) => decodeBase64UrlBytes(value)?.length === 12, { message: "must encode exactly 12 bytes" }),
-    }),
+    envelope: z.union([
+        portableLegacyPayloadEnvelopeSchema,
+        portableV2PayloadEnvelopeSchema,
+    ]),
     plaintextBytes: z
         .number()
         .int()
@@ -142,10 +158,18 @@ export const portableEncryptedPayloadRecordSchema = z
     .superRefine((payload, context) => {
     const ciphertext = decodeBase64UrlBytes(payload.envelope.ciphertext);
     if (ciphertext !== undefined &&
-        ciphertext.length !== payload.plaintextBytes + 16) {
+        ("version" in payload.envelope
+            ? payload.aadVersion !== "greatwait.schedule-payload.v2" ||
+                payload.envelope.originalBytes !== payload.plaintextBytes ||
+                ciphertext.length < 16 ||
+                ciphertext.length > payload.plaintextBytes + 16 ||
+                (payload.envelope.codec === "identity" &&
+                    ciphertext.length !== payload.plaintextBytes + 16)
+            : payload.aadVersion !== SCHEDULE_PAYLOAD_AAD_VERSION ||
+                ciphertext.length !== payload.plaintextBytes + 16)) {
         context.addIssue({
             code: "custom",
-            message: "ciphertext must contain the plaintext bytes and a 16-byte AES-GCM tag",
+            message: "ciphertext and authenticated envelope metadata must match the payload version and size",
             path: ["envelope", "ciphertext"],
         });
     }