@greatwait/contracts 0.2.3 → 0.3.1

package/dist/scheduling.d.ts

@@ -1,3 +1,4 @@
+import { type OccurrenceState } from "./occurrence-states.js";
 import { z } from "./zod.js";
 import { type CursorBinding } from "./protocol.js";
 import type { FieldError } from "./problems.js";
@@ -36,9 +37,9 @@ import { type CallbackTrigger, type ResponseClass } from "./signatures.js";
  */
 export declare const SCHEDULE_STATUSES: readonly ["active", "paused", "cancelled", "completed"];
 export declare const scheduleStatusSchema: import("zod").ZodEnum<{
-    paused: "paused";
-    active: "active";
     cancelled: "cancelled";
+    active: "active";
+    paused: "paused";
     completed: "completed";
 }>;
 export type ScheduleStatus = z.infer<typeof scheduleStatusSchema>;
@@ -346,19 +347,7 @@ export type PartitionKey = z.infer<typeof partitionKeySchema>;
  * not `cancelled`: a customer who cancelled something and a customer whose
  * occurrence went stale need different explanations.
  */
-export declare const OCCURRENCE_STATES: readonly ["planned", "due", "dispatching", "retry_wait", "ambiguous", "succeeded", "terminal_failed", "cancelled", "skipped_stale"];
-export declare const occurrenceStateSchema: import("zod").ZodEnum<{
-    succeeded: "succeeded";
-    ambiguous: "ambiguous";
-    due: "due";
-    cancelled: "cancelled";
-    planned: "planned";
-    dispatching: "dispatching";
-    retry_wait: "retry_wait";
-    terminal_failed: "terminal_failed";
-    skipped_stale: "skipped_stale";
-}>;
-export type OccurrenceState = z.infer<typeof occurrenceStateSchema>;
+export { OCCURRENCE_STATES, occurrenceStateSchema, type OccurrenceState, } from "./occurrence-states.js";
 /**
  * One project-wide walk over retained occurrences, newest first.
  *
@@ -370,23 +359,35 @@ export type OccurrenceState = z.infer<typeof occurrenceStateSchema>;
 export declare const projectOccurrenceListRequestSchema: import("zod").ZodObject<{
     cursor: import("zod").ZodOptional<import("zod").ZodString>;
     limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-    endpoint: import("zod").ZodOptional<import("zod").ZodString>;
+    endpoint: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodLiteral<"none">]>>;
+    schedule: import("zod").ZodOptional<import("zod").ZodString>;
     external_identifier: import("zod").ZodOptional<import("zod").ZodString>;
     tag: import("zod").ZodOptional<import("zod").ZodString>;
+    status: import("zod").ZodOptional<import("zod").ZodEnum<{
+        cancelled: "cancelled";
+        active: "active";
+        paused: "paused";
+        completed: "completed";
+    }>>;
+    recurrence: import("zod").ZodOptional<import("zod").ZodEnum<{
+        at: "at";
+        every: "every";
+        cron: "cron";
+    }>>;
+    text: import("zod").ZodOptional<import("zod").ZodString>;
     from: import("zod").ZodOptional<import("zod").ZodString>;
+    to: import("zod").ZodOptional<import("zod").ZodString>;
     outcome: import("zod").ZodOptional<import("zod").ZodEnum<{
-        succeeded: "succeeded";
-        ambiguous: "ambiguous";
-        due: "due";
-        cancelled: "cancelled";
         planned: "planned";
+        due: "due";
         dispatching: "dispatching";
         retry_wait: "retry_wait";
+        ambiguous: "ambiguous";
+        succeeded: "succeeded";
         terminal_failed: "terminal_failed";
+        cancelled: "cancelled";
         skipped_stale: "skipped_stale";
     }>>;
-    schedule: import("zod").ZodOptional<import("zod").ZodString>;
-    to: import("zod").ZodOptional<import("zod").ZodString>;
 }, import("zod/v4/core").$strip>;
 export type ProjectOccurrenceListRequest = z.infer<typeof projectOccurrenceListRequestSchema>;
 export type ProjectOccurrenceListRequestParse = {
@@ -427,8 +428,8 @@ export declare function isTerminalOccurrenceState(state: OccurrenceState): boole
  */
 export declare const ATTEMPT_STATES: readonly ["succeeded", "retryable_failure", "terminal_failure", "ambiguous"];
 export declare const attemptStateSchema: import("zod").ZodEnum<{
-    succeeded: "succeeded";
     ambiguous: "ambiguous";
+    succeeded: "succeeded";
     retryable_failure: "retryable_failure";
     terminal_failure: "terminal_failure";
 }>;
@@ -803,9 +804,9 @@ export declare const scheduleSchema: import("zod").ZodObject<{
         timeZone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
     }, import("zod/v4/core").$strip>], "kind">;
     status: import("zod").ZodEnum<{
-        paused: "paused";
-        active: "active";
         cancelled: "cancelled";
+        active: "active";
+        paused: "paused";
         completed: "completed";
     }>;
     updatedAt: import("zod").ZodString;
@@ -905,9 +906,9 @@ export declare const schedulePageSchema: import("zod").ZodObject<{
             timeZone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
         }, import("zod/v4/core").$strip>], "kind">;
         status: import("zod").ZodEnum<{
-            paused: "paused";
-            active: "active";
             cancelled: "cancelled";
+            active: "active";
+            paused: "paused";
             completed: "completed";
         }>;
         updatedAt: import("zod").ZodString;
@@ -939,14 +940,14 @@ export declare const occurrenceSchema: import("zod").ZodObject<{
     sequence: import("zod").ZodNumber;
     settledAt: import("zod").ZodOptional<import("zod").ZodString>;
     state: import("zod").ZodEnum<{
-        succeeded: "succeeded";
-        ambiguous: "ambiguous";
-        due: "due";
-        cancelled: "cancelled";
         planned: "planned";
+        due: "due";
         dispatching: "dispatching";
         retry_wait: "retry_wait";
+        ambiguous: "ambiguous";
+        succeeded: "succeeded";
         terminal_failed: "terminal_failed";
+        cancelled: "cancelled";
         skipped_stale: "skipped_stale";
     }>;
     firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1013,8 +1014,8 @@ export type AttemptFailureSnippet = z.infer<typeof attemptFailureSnippetSchema>;
 export declare const attemptCapturedBodySchema: import("zod").ZodObject<{
     contentType: import("zod").ZodString;
     encoding: import("zod").ZodEnum<{
-        utf8: "utf8";
         base64: "base64";
+        utf8: "utf8";
     }>;
     content: import("zod").ZodString;
     capturedBytes: import("zod").ZodInt;
@@ -1038,8 +1039,8 @@ export declare const attemptResponseSchema: import("zod").ZodObject<{
     body: import("zod").ZodOptional<import("zod").ZodObject<{
         contentType: import("zod").ZodString;
         encoding: import("zod").ZodEnum<{
-            utf8: "utf8";
             base64: "base64";
+            utf8: "utf8";
         }>;
         content: import("zod").ZodString;
         capturedBytes: import("zod").ZodInt;
@@ -1064,6 +1065,51 @@ export declare const attemptRequestSchema: import("zod").ZodObject<{
     body: import("zod").ZodString;
 }, import("zod/v4/core").$strip>;
 export type AttemptRequest = z.infer<typeof attemptRequestSchema>;
+/** Shared validators for attempt search summaries and full attempt details. */
+export declare const attemptSearchSummaryShape: {
+    attemptNumber: import("zod").ZodNumber;
+    classifiedAt: import("zod").ZodOptional<import("zod").ZodString>;
+    diagnostic: import("zod").ZodOptional<import("zod").ZodEnum<{
+        rate_limited: "rate_limited";
+        completion_timed_out: "completion_timed_out";
+        delivered: "delivered";
+        duplicate_inflight: "duplicate_inflight";
+        endpoint_unavailable: "endpoint_unavailable";
+        endpoint_unsafe: "endpoint_unsafe";
+        http_refused: "http_refused";
+        http_retryable: "http_retryable";
+        http_terminal: "http_terminal";
+        identity_conflict: "identity_conflict";
+        network_ambiguous: "network_ambiguous";
+        payload_unavailable: "payload_unavailable";
+    }>>;
+    durationMs: import("zod").ZodOptional<import("zod").ZodNumber>;
+    id: import("zod").ZodString;
+    occurrence: import("zod").ZodString;
+    remediation: import("zod").ZodOptional<import("zod").ZodEnum<{
+        none: "none";
+        review_retry_policy: "review_retry_policy";
+        inspect_receiver: "inspect_receiver";
+        review_endpoint: "review_endpoint";
+        replace_payload: "replace_payload";
+        contact_support: "contact_support";
+        review_before_redelivery: "review_before_redelivery";
+    }>>;
+    responseStatus: import("zod").ZodOptional<import("zod").ZodNumber>;
+    startedAt: import("zod").ZodString;
+    state: import("zod").ZodOptional<import("zod").ZodEnum<{
+        ambiguous: "ambiguous";
+        succeeded: "succeeded";
+        retryable_failure: "retryable_failure";
+        terminal_failure: "terminal_failure";
+    }>>;
+    trigger: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+        kind: import("zod").ZodLiteral<"automatic">;
+    }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+        kind: import("zod").ZodLiteral<"redelivery">;
+        sourceAttemptId: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>], "kind">;
+};
 export declare const attemptSchema: import("zod").ZodObject<{
     id: import("zod").ZodString;
     localReceiptRecoveries: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1098,8 +1144,8 @@ export declare const attemptSchema: import("zod").ZodObject<{
         body: import("zod").ZodOptional<import("zod").ZodObject<{
             contentType: import("zod").ZodString;
             encoding: import("zod").ZodEnum<{
-                utf8: "utf8";
                 base64: "base64";
+                utf8: "utf8";
             }>;
             content: import("zod").ZodString;
             capturedBytes: import("zod").ZodInt;
@@ -1134,8 +1180,8 @@ export declare const attemptSchema: import("zod").ZodObject<{
     responseStatus: import("zod").ZodOptional<import("zod").ZodNumber>;
     startedAt: import("zod").ZodString;
     state: import("zod").ZodOptional<import("zod").ZodEnum<{
-        succeeded: "succeeded";
         ambiguous: "ambiguous";
+        succeeded: "succeeded";
         retryable_failure: "retryable_failure";
         terminal_failure: "terminal_failure";
     }>>;
@@ -1185,14 +1231,14 @@ export declare const occurrencePageSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1222,14 +1268,14 @@ export declare const projectOccurrencePageSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1265,14 +1311,14 @@ export declare const occurrenceViewSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1324,8 +1370,8 @@ export declare const attemptPageSchema: import("zod").ZodObject<{
             body: import("zod").ZodOptional<import("zod").ZodObject<{
                 contentType: import("zod").ZodString;
                 encoding: import("zod").ZodEnum<{
-                    utf8: "utf8";
                     base64: "base64";
+                    utf8: "utf8";
                 }>;
                 content: import("zod").ZodString;
                 capturedBytes: import("zod").ZodInt;
@@ -1360,8 +1406,8 @@ export declare const attemptPageSchema: import("zod").ZodObject<{
         responseStatus: import("zod").ZodOptional<import("zod").ZodNumber>;
         startedAt: import("zod").ZodString;
         state: import("zod").ZodOptional<import("zod").ZodEnum<{
-            succeeded: "succeeded";
             ambiguous: "ambiguous";
+            succeeded: "succeeded";
             retryable_failure: "retryable_failure";
             terminal_failure: "terminal_failure";
         }>>;
@@ -1442,8 +1488,8 @@ export declare const attemptViewSchema: import("zod").ZodObject<{
             body: import("zod").ZodOptional<import("zod").ZodObject<{
                 contentType: import("zod").ZodString;
                 encoding: import("zod").ZodEnum<{
-                    utf8: "utf8";
                     base64: "base64";
+                    utf8: "utf8";
                 }>;
                 content: import("zod").ZodString;
                 capturedBytes: import("zod").ZodInt;
@@ -1478,8 +1524,8 @@ export declare const attemptViewSchema: import("zod").ZodObject<{
         responseStatus: import("zod").ZodOptional<import("zod").ZodNumber>;
         startedAt: import("zod").ZodString;
         state: import("zod").ZodOptional<import("zod").ZodEnum<{
-            succeeded: "succeeded";
             ambiguous: "ambiguous";
+            succeeded: "succeeded";
             retryable_failure: "retryable_failure";
             terminal_failure: "terminal_failure";
         }>>;
@@ -1540,14 +1586,14 @@ export declare const scheduleViewSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1643,9 +1689,9 @@ export declare const scheduleViewSchema: import("zod").ZodObject<{
             timeZone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
         }, import("zod/v4/core").$strip>], "kind">;
         status: import("zod").ZodEnum<{
-            paused: "paused";
-            active: "active";
             cancelled: "cancelled";
+            active: "active";
+            paused: "paused";
             completed: "completed";
         }>;
         updatedAt: import("zod").ZodString;
@@ -1668,14 +1714,14 @@ export declare const scheduleWrittenViewSchema: import("zod").ZodObject<{
         sequence: import("zod").ZodNumber;
         settledAt: import("zod").ZodOptional<import("zod").ZodString>;
         state: import("zod").ZodEnum<{
-            succeeded: "succeeded";
-            ambiguous: "ambiguous";
-            due: "due";
-            cancelled: "cancelled";
             planned: "planned";
+            due: "due";
             dispatching: "dispatching";
             retry_wait: "retry_wait";
+            ambiguous: "ambiguous";
+            succeeded: "succeeded";
             terminal_failed: "terminal_failed";
+            cancelled: "cancelled";
             skipped_stale: "skipped_stale";
         }>;
         firstAttemptLatenessMs: import("zod").ZodOptional<import("zod").ZodInt>;
@@ -1771,9 +1817,9 @@ export declare const scheduleWrittenViewSchema: import("zod").ZodObject<{
             timeZone: import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<string, string>>;
         }, import("zod/v4/core").$strip>], "kind">;
         status: import("zod").ZodEnum<{
-            paused: "paused";
-            active: "active";
             cancelled: "cancelled";
+            active: "active";
+            paused: "paused";
             completed: "completed";
         }>;
         updatedAt: import("zod").ZodString;