@greatwait/contracts 0.1.0-alpha.3 → 0.1.0-alpha.4

package/generated/v1/examples/endpoints.read.response.json

@@ -2,13 +2,13 @@
   "createdAt": "2026-08-05T15:00:00.000Z",
   "environmentKind": "test",
   "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "name": "https://hooks.example.com/greatwait",
   "project": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
   "signingKeys": {
     "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
   },
-  "status": "verified",
+  "status": "active",
   "updatedAt": "2026-08-05T15:01:00.000Z",
   "url": "https://hooks.example.com/greatwait",
-  "verifiedAt": "2026-08-05T15:01:00.000Z",
   "version": 2
 }

package/generated/v1/examples/endpoints.revealSigningSecret.response.json

@@ -0,0 +1,7 @@
+{
+  "current": {
+    "keyId": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8",
+    "secret": "ptsk_test_<the-current-endpoint-secret-here>"
+  },
+  "id": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8"
+}

package/generated/v1/examples/endpoints.rotateSigningKey.response.json

@@ -11,10 +11,9 @@
         "overlapEndsAt": "2026-08-06T15:05:00.000Z"
       }
     },
-    "status": "verified",
+    "status": "active",
     "updatedAt": "2026-08-05T15:05:00.000Z",
     "url": "https://hooks.example.com/greatwait",
-    "verifiedAt": "2026-08-05T15:01:00.000Z",
     "version": 3
   },
   "keyId": "csk_11h8xyz9k2m4n6p8r0t2v4w6y8",

package/generated/v1/examples/endpoints.update.response.json

@@ -6,7 +6,7 @@
   "signingKeys": {
     "current": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
   },
-  "status": "pending",
+  "status": "active",
   "updatedAt": "2026-08-05T16:00:00.000Z",
   "url": "https://hooks.example.com/replacement",
   "version": 3

package/generated/v1/examples/executions.list.response.json

@@ -0,0 +1,20 @@
+{
+  "data": [
+    {
+      "attemptCount": 1,
+      "generation": 1,
+      "id": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "plannedFor": "2026-07-28T15:00:00.000Z",
+      "schedule": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "sequence": 1,
+      "settledAt": "2026-07-28T15:00:01.000Z",
+      "state": "succeeded"
+    }
+  ],
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "retention": {
+    "from": "2026-07-21T15:00:00.000Z"
+  }
+}

package/generated/v1/examples/exports.cancel.response.json

@@ -0,0 +1,11 @@
+{
+  "cancelled": true,
+  "export": {
+    "createdAt": "2035-03-04T12:00:00.000Z",
+    "consistency": "creation-cutoff-current-values",
+    "cutoffAt": "2035-03-04T12:00:00.000Z",
+    "id": "exp_0123456789abcdefghjkmnpqrs",
+    "state": "cancelled",
+    "updatedAt": "2035-03-04T12:00:00.000Z"
+  }
+}

package/generated/v1/examples/exports.create.request.json

@@ -0,0 +1 @@
+{}

package/generated/v1/examples/exports.create.response.json

@@ -0,0 +1,8 @@
+{
+  "createdAt": "2035-03-04T12:00:00.000Z",
+  "consistency": "creation-cutoff-current-values",
+  "cutoffAt": "2035-03-04T12:00:00.000Z",
+  "id": "exp_0123456789abcdefghjkmnpqrs",
+  "state": "active",
+  "updatedAt": "2035-03-04T12:00:00.000Z"
+}

package/generated/v1/examples/exports.part.response.json

@@ -0,0 +1,5 @@
+{
+  "content": "{\"kind\":\"schedule\",\"value\":{\"id\":\"sch_0123456789abcdefghjkmnpq\"}}\n",
+  "fileName": "greatwait-export-exp_0123456789abcdefghjkmnpqrs.ndjson",
+  "mediaType": "application/x-ndjson"
+}

package/generated/v1/examples/exports.read.response.json

@@ -0,0 +1,8 @@
+{
+  "createdAt": "2035-03-04T12:00:00.000Z",
+  "consistency": "creation-cutoff-current-values",
+  "cutoffAt": "2035-03-04T12:00:00.000Z",
+  "id": "exp_0123456789abcdefghjkmnpqrs",
+  "state": "active",
+  "updatedAt": "2035-03-04T12:00:00.000Z"
+}

package/generated/v1/examples/occurrences.read.response.json

@@ -4,6 +4,10 @@
   },
   "occurrence": {
     "attemptCount": 2,
+    "firstAttemptLatenessMs": 0,
+    "firstAttemptStartedAt": "2026-07-28T15:00:00.000Z",
+    "timingEligibility": "eligible",
+    "timingPolicyVersion": "payg-v1",
     "generation": 1,
     "id": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "plannedFor": "2026-07-28T15:00:00.000Z",

package/generated/v1/examples/organizations.close.request.json

@@ -0,0 +1,5 @@
+{
+  "expectedGeneration": 0,
+  "immediate": false,
+  "confirmation": "delete organization"
+}

package/generated/v1/examples/organizations.close.response.json

@@ -0,0 +1,10 @@
+{
+  "organizationId": "org_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "generation": 1,
+  "phase": "closed",
+  "requestedAt": "2026-09-12T12:00:00.000Z",
+  "reversibleUntil": "2026-09-19T12:00:00.000Z",
+  "purgeDeadline": "2026-10-12T12:00:00.000Z",
+  "immediate": false,
+  "converged": true
+}

package/generated/v1/examples/organizations.lifecycle.response.json

@@ -0,0 +1,10 @@
+{
+  "organizationId": "org_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "generation": 1,
+  "phase": "closed",
+  "requestedAt": "2026-09-12T12:00:00.000Z",
+  "reversibleUntil": "2026-09-19T12:00:00.000Z",
+  "purgeDeadline": "2026-10-12T12:00:00.000Z",
+  "immediate": false,
+  "converged": true
+}

package/generated/v1/examples/organizations.restore.request.json

@@ -0,0 +1,3 @@
+{
+  "expectedGeneration": 1
+}

package/generated/v1/examples/organizations.restore.response.json

@@ -0,0 +1,10 @@
+{
+  "organizationId": "org_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "generation": 2,
+  "phase": "active",
+  "requestedAt": "2026-09-12T12:00:00.000Z",
+  "reversibleUntil": "2026-09-19T12:00:00.000Z",
+  "purgeDeadline": "2026-10-12T12:00:00.000Z",
+  "immediate": false,
+  "converged": true
+}

package/generated/v1/examples/projects.archive.request.json

@@ -0,0 +1,3 @@
+{
+  "archived": true
+}

package/generated/v1/examples/projects.archive.response.json

@@ -0,0 +1,14 @@
+{
+  "createdAt": "2026-08-14T11:00:00.000Z",
+  "deletionCounts": {
+    "endpoints": 2,
+    "keys": 4,
+    "runs": 37,
+    "schedules": 5
+  },
+  "environmentKinds": ["test", "live"],
+  "id": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "name": "Customer reminders",
+  "status": "archived",
+  "version": 2
+}

package/generated/v1/examples/projects.create.response.json

@@ -1,5 +1,14 @@
 {
+  "createdAt": null,
+  "deletionCounts": {
+    "endpoints": 0,
+    "keys": 0,
+    "runs": 0,
+    "schedules": 0
+  },
   "environmentKinds": ["test", "live"],
   "id": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
-  "name": "Billing reminders"
+  "name": "Billing reminders",
+  "status": "active",
+  "version": 1
 }

package/generated/v1/examples/projects.delete.response.json

@@ -0,0 +1,9 @@
+{
+  "deleted": true,
+  "destroyed": {
+    "endpoints": 2,
+    "keys": 4,
+    "runs": 37,
+    "schedules": 5
+  }
+}

package/generated/v1/examples/projects.list.response.json

@@ -1,9 +1,19 @@
 {
   "data": [
     {
+      "createdAt": "2026-08-14T11:00:00.000Z",
+      "deletionCounts": {
+        "endpoints": 2,
+        "keys": 4,
+        "runs": 37,
+        "schedules": 5
+      },
       "environmentKinds": ["test", "live"],
       "id": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
-      "name": "Billing reminders"
+      "name": "Billing reminders",
+      "status": "active",
+      "version": 1
     }
-  ]
+  ],
+  "total": 1
 }

package/generated/v1/examples/projects.rename.request.json

@@ -0,0 +1,3 @@
+{
+  "name": "Customer reminders"
+}

package/generated/v1/examples/projects.rename.response.json

@@ -0,0 +1,14 @@
+{
+  "createdAt": "2026-08-14T11:00:00.000Z",
+  "deletionCounts": {
+    "endpoints": 2,
+    "keys": 4,
+    "runs": 37,
+    "schedules": 5
+  },
+  "environmentKinds": ["test", "live"],
+  "id": "proj_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "name": "Customer reminders",
+  "status": "active",
+  "version": 2
+}

package/generated/v1/examples/schedules.archive.response.json

@@ -15,6 +15,9 @@
     "generation": 1,
     "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "latencyClass": "realtime",
+    "lateness": {
+      "policy": "catchUp"
+    },
     "recurrence": {
       "kind": "at"
     },

package/generated/v1/examples/schedules.cancel.response.json

@@ -14,6 +14,9 @@
     "generation": 1,
     "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "latencyClass": "realtime",
+    "lateness": {
+      "policy": "catchUp"
+    },
     "recurrence": {
       "kind": "at"
     },

package/generated/v1/examples/schedules.create.request.json

@@ -4,6 +4,10 @@
     "report": "daily"
   },
   "endpoint": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "lateness": {
+    "maxStalenessSeconds": 3600,
+    "policy": "catchUp"
+  },
   "partitionKey": "campaign.spring",
   "timeZone": "Europe/London"
 }

package/generated/v1/examples/schedules.create.response.json

@@ -14,6 +14,9 @@
     "generation": 1,
     "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "latencyClass": "realtime",
+    "lateness": {
+      "policy": "catchUp"
+    },
     "partitionKey": "campaign.spring",
     "recurrence": {
       "kind": "at"

package/generated/v1/examples/schedules.list.response.json

@@ -6,6 +6,9 @@
       "generation": 1,
       "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
       "latencyClass": "realtime",
+      "lateness": {
+        "policy": "catchUp"
+      },
       "recurrence": {
         "kind": "at"
       },

package/generated/v1/examples/schedules.pause.response.json

@@ -13,6 +13,9 @@
     "generation": 1,
     "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "latencyClass": "realtime",
+    "lateness": {
+      "policy": "catchUp"
+    },
     "recurrence": {
       "kind": "at"
     },

package/generated/v1/examples/schedules.read.response.json

@@ -9,11 +9,17 @@
     "state": "planned"
   },
   "schedule": {
+    "data": {
+      "report": "daily"
+    },
     "createdAt": "2026-07-28T14:59:00.000Z",
     "endpoint": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "generation": 1,
     "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "latencyClass": "realtime",
+    "lateness": {
+      "policy": "catchUp"
+    },
     "partitionKey": "campaign.spring",
     "recurrence": {
       "kind": "at"

package/generated/v1/examples/schedules.replace.request.json

@@ -4,5 +4,9 @@
   },
   "everySeconds": 86400,
   "endpoint": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
+  "lateness": {
+    "maxStalenessSeconds": 7200,
+    "policy": "catchUp"
+  },
   "partitionKey": "campaign.spring"
 }

package/generated/v1/examples/schedules.replace.response.json

@@ -14,6 +14,9 @@
     "generation": 2,
     "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "latencyClass": "realtime",
+    "lateness": {
+      "policy": "catchUp"
+    },
     "partitionKey": "campaign.spring",
     "recurrence": {
       "kind": "at"

package/generated/v1/examples/schedules.resume.response.json

@@ -13,6 +13,9 @@
     "generation": 1,
     "id": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
     "latencyClass": "realtime",
+    "lateness": {
+      "policy": "catchUp"
+    },
     "recurrence": {
       "kind": "at"
     },

package/generated/v1/examples/timing.summary.response.json

@@ -0,0 +1,35 @@
+{
+  "customerBlockedCount": 2,
+  "deliveredSampleCount": 98,
+  "freshness": {
+    "kind": "authoritative"
+  },
+  "missingEvidenceCount": 1,
+  "p95LatenessMs": 4200,
+  "p99LatenessMs": 12000,
+  "platformBlockedCount": 1,
+  "policyVersion": "timing-v1",
+  "skippedCount": 3,
+  "targets": [
+    {
+      "breachCount": 5,
+      "customerBlockedCount": 2,
+      "eligibleOutstandingBreachCount": 1,
+      "maturedCount": 100,
+      "targetMs": 5000,
+      "verdict": "met",
+      "withinTargetCount": 95
+    },
+    {
+      "breachCount": 1,
+      "customerBlockedCount": 2,
+      "eligibleOutstandingBreachCount": 1,
+      "maturedCount": 100,
+      "targetMs": 15000,
+      "verdict": "met",
+      "withinTargetCount": 99
+    }
+  ],
+  "windowEnd": "2026-09-09T12:00:00.000Z",
+  "windowStart": "2026-09-08T12:00:00.000Z"
+}

package/generated/v1/examples/usage.read.response.json

@@ -1,4 +1,5 @@
 {
+  "bucketSeconds": 86400,
   "days": [
     {
       "billableOccurrences": 42,

package/generated/v1/first-value-journey.json

@@ -79,6 +79,7 @@
         "credential_expired",
         "credential_revoked",
         "invalid_request",
+        "project_archived",
         "rate_limited",
         "scope_missing",
         "service_unavailable"
@@ -128,9 +129,11 @@
         "credential_revoked",
         "invalid_request",
         "plan_limit_reached",
+        "project_archived",
         "rate_limited",
         "scope_missing",
-        "service_unavailable"
+        "service_unavailable",
+        "state_conflict"
       ],
       "scopes": ["endpoints:write"],
       "successStatus": 201,
@@ -160,12 +163,12 @@
       "purpose": "Creates the one-shot. The delay is converted to an absolute instant when the request is accepted, so the schedule reads back the same afterwards however it was expressed.",
       "recovery": [
         {
-          "nextMove": "This deployment requires a destination to answer its ownership challenge before anything is delivered there, and yours has not. Answer the challenge with the secret the create call returned, then create the schedule.",
-          "when": "endpoint_unverified"
+          "nextMove": "The endpoint identifier is not one this credential's project can deliver to — it belongs to another project, or there is no such endpoint. Create a destination in this project, or check the identifier.",
+          "when": "not_found"
         },
         {
-          "nextMove": "The endpoint identifier is not one this credential's project can deliver to — it belongs to another project, or it has been disabled. Disabling is terminal, so create a new destination rather than trying to re-enable that one.",
-          "when": "not_found"
+          "nextMove": "The endpoint is disabled. Enable it with `endpoints.enable` and the schedule is accepted as sent, or point the schedule at another destination.",
+          "when": "state_conflict"
         },
         {
           "nextMove": "The same idempotency key was used for a different request. Use a new key, or send the byte-identical body the key was first used with.",
@@ -198,14 +201,15 @@
         "authentication_required",
         "credential_expired",
         "credential_revoked",
-        "endpoint_unverified",
         "idempotency_key_reused",
         "invalid_request",
         "not_found",
         "plan_limit_reached",
+        "project_archived",
         "rate_limited",
         "scope_missing",
-        "service_unavailable"
+        "service_unavailable",
+        "state_conflict"
       ],
       "scopes": ["schedules:write"],
       "successStatus": 201,
@@ -253,14 +257,15 @@
         "authentication_required",
         "credential_expired",
         "credential_revoked",
-        "endpoint_unverified",
         "idempotency_key_reused",
         "invalid_request",
         "not_found",
         "plan_limit_reached",
+        "project_archived",
         "rate_limited",
         "scope_missing",
-        "service_unavailable"
+        "service_unavailable",
+        "state_conflict"
       ],
       "scopes": ["schedules:write"],
       "successStatus": 201,
@@ -287,6 +292,7 @@
         "credential_revoked",
         "invalid_request",
         "not_found",
+        "project_archived",
         "rate_limited",
         "scope_missing",
         "service_unavailable"
@@ -321,6 +327,7 @@
         "credential_revoked",
         "invalid_request",
         "not_found",
+        "project_archived",
         "rate_limited",
         "scope_missing",
         "service_unavailable"
@@ -354,6 +361,7 @@
         "credential_revoked",
         "invalid_request",
         "not_found",
+        "project_archived",
         "rate_limited",
         "scope_missing",
         "service_unavailable"
@@ -370,7 +378,7 @@
       "observe": "The endpoint in status `disabled`. Nothing further is delivered to it, and it stays readable so the attempts above keep their context.",
       "operationId": "endpoints.disable",
       "path": "/v1/endpoints/{endpointId}",
-      "purpose": "Stops delivery to the destination you registered for this walkthrough. Disabling is terminal and deliberate: it leaves the history intact rather than deleting evidence of what happened.",
+      "purpose": "Stops delivery to the destination you registered for this walkthrough. Disabling is deliberate rather than final: it leaves the history intact rather than deleting evidence of what happened, and `endpoints.enable` turns the destination back on if you want it again.",
       "recovery": [
         {
           "nextMove": "Already gone, or never in this project. Nothing to clean up.",
@@ -383,6 +391,7 @@
         "credential_revoked",
         "invalid_request",
         "not_found",
+        "project_archived",
         "rate_limited",
         "scope_missing",
         "service_unavailable"