@greatwait/contracts 0.3.1 → 0.3.2

package/dist/tenancy.js

@@ -116,6 +116,31 @@ export const provisionedProjectSchema = z.object({
         .length(2, "a project has exactly two environments"),
     project: projectSchema,
 });
+/** Exactly what a permanent deletion of the project would destroy now. */
+export const projectDeletionCountsSchema = z.object({
+    endpoints: z.number().int().nonnegative(),
+    keys: z.number().int().nonnegative(),
+    runs: z.number().int().nonnegative(),
+    schedules: z.number().int().nonnegative(),
+});
+/**
+ * One project, with the exact counts a permanent deletion would destroy now.
+ *
+ * Returned by the single-project read (`projects.read`) and by the writes that
+ * answer with the project they changed. Never by the list: see
+ * `projectListItemSchema`.
+ */
+export const projectSummarySchema = z.object({
+    createdAt: timestampSchema.nullable(),
+    deletionCounts: projectDeletionCountsSchema,
+    environmentKinds: z
+        .array(environmentKindSchema)
+        .length(2, "a project has exactly two environments"),
+    id: projectIdSchema,
+    name: projectNameSchema,
+    status: projectStatusSchema.exclude(["deleted"]),
+    version: versionSchema,
+});
 /**
  * What a signed-in member is told about a project they may act in.
  *
@@ -130,24 +155,17 @@ export const provisionedProjectSchema = z.object({
  * list shows, the authority for a request is re-resolved from the member's
  * organization when the request arrives. Lifecycle state and version make an
  * archived row manageable without making it a valid work target.
+ *
+ * **No deletion counts (W9-88).** Counting a project's schedules and runs
+ * reads every one of them, so a list that counted every project cost the sum
+ * of the organization's whole history — 2.2 s for an organization with
+ * 290,000 schedules, longer than the API's pool would wait, and the landing
+ * page failed every time. Exact counts are a deletion preview; they belong to
+ * the one project somebody is about to delete: `projectSummarySchema`.
  */
-export const projectSummarySchema = z.object({
-    createdAt: timestampSchema.nullable(),
-    deletionCounts: z.object({
-        endpoints: z.number().int().nonnegative(),
-        keys: z.number().int().nonnegative(),
-        runs: z.number().int().nonnegative(),
-        schedules: z.number().int().nonnegative(),
-    }),
-    environmentKinds: z
-        .array(environmentKindSchema)
-        .length(2, "a project has exactly two environments"),
-    id: projectIdSchema,
-    name: projectNameSchema,
-    status: projectStatusSchema.exclude(["deleted"]),
-    version: versionSchema,
+export const projectListItemSchema = projectSummarySchema.omit({
+    deletionCounts: true,
 });
-export const projectDeletionCountsSchema = projectSummarySchema.shape.deletionCounts;
 /**
  * Every active or archived project the member can access. Administrators see all.
  *
@@ -162,7 +180,7 @@ export const projectDeletionCountsSchema = projectSummarySchema.shape.deletionCo
 export const PROJECT_LIST_LIMIT = 200;
 export const projectListSchema = z.object({
     data: z
-        .array(projectSummarySchema)
+        .array(projectListItemSchema)
         .max(PROJECT_LIST_LIMIT, "more projects than this response can carry; paging is required"),
     /** Active and archived projects occupy a plan slot; deleted projects do not. */
     total: z.number().int().nonnegative().max(PROJECT_LIST_LIMIT),

package/dist/timing.d.ts

@@ -1,4 +1,5 @@
 import { z } from "./zod.js";
+export declare const DELIVERY_TIMING_POLICY_VERSION = "timing-v2-service-bands";
 export declare const DELIVERY_TIMING_TARGETS_MS: readonly [5000, 15000];
 export declare const DELIVERY_TIMING_VERDICTS: readonly ["met", "missed", "unknown"];
 export declare const timingThresholdSummarySchema: import("zod").ZodObject<{
@@ -15,6 +16,26 @@ export declare const timingThresholdSummarySchema: import("zod").ZodObject<{
     withinTargetCount: import("zod").ZodInt;
 }, import("zod/v4/core").$strip>;
 export type TimingThresholdView = z.infer<typeof timingThresholdSummarySchema>;
+/** One concrete band's first-outbound p95 objective, measured from plannedFor. */
+export declare const bandTimingSummarySchema: import("zod").ZodObject<{
+    serviceBand: import("zod").ZodEnum<{
+        short_bulk: "short_bulk";
+        bulk: "bulk";
+        realtime: "realtime";
+    }>;
+    targetMs: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<1000>, import("zod").ZodLiteral<10000>, import("zod").ZodLiteral<60000>]>;
+    breachCount: import("zod").ZodInt;
+    customerBlockedCount: import("zod").ZodInt;
+    eligibleOutstandingBreachCount: import("zod").ZodInt;
+    maturedCount: import("zod").ZodInt;
+    verdict: import("zod").ZodEnum<{
+        unknown: "unknown";
+        met: "met";
+        missed: "missed";
+    }>;
+    withinTargetCount: import("zod").ZodInt;
+}, import("zod/v4/core").$strip>;
+export type BandTimingSummaryView = z.infer<typeof bandTimingSummarySchema>;
 /**
  * Exact rolling 24-hour due-time cohort for one project and timing policy.
  *
@@ -23,6 +44,24 @@ export type TimingThresholdView = z.infer<typeof timingThresholdSummarySchema>;
  * samples only and remain separate from the exact threshold counters.
  */
 export declare const deliveryTimingSummarySchema: import("zod").ZodObject<{
+    bandTargets: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        serviceBand: import("zod").ZodEnum<{
+            short_bulk: "short_bulk";
+            bulk: "bulk";
+            realtime: "realtime";
+        }>;
+        targetMs: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<1000>, import("zod").ZodLiteral<10000>, import("zod").ZodLiteral<60000>]>;
+        breachCount: import("zod").ZodInt;
+        customerBlockedCount: import("zod").ZodInt;
+        eligibleOutstandingBreachCount: import("zod").ZodInt;
+        maturedCount: import("zod").ZodInt;
+        verdict: import("zod").ZodEnum<{
+            unknown: "unknown";
+            met: "met";
+            missed: "missed";
+        }>;
+        withinTargetCount: import("zod").ZodInt;
+    }, import("zod/v4/core").$strip>>>;
     customerBlockedCount: import("zod").ZodInt;
     deliveredSampleCount: import("zod").ZodInt;
     freshness: import("zod").ZodObject<{

package/dist/timing.js

@@ -1,5 +1,8 @@
 import { z } from "./zod.js";
 import { timestampSchema } from "./time.js";
+import { SERVICE_MODE_POLICY } from "./operational-config.js";
+import { SERVICE_BANDS } from "./service-mode.js";
+export const DELIVERY_TIMING_POLICY_VERSION = "timing-v2-service-bands";
 export const DELIVERY_TIMING_TARGETS_MS = [5_000, 15_000];
 export const DELIVERY_TIMING_VERDICTS = ["met", "missed", "unknown"];
 const integerSchema = z.int();
@@ -49,6 +52,41 @@ export const timingThresholdSummarySchema = z
         });
     }
 });
+/** One concrete band's first-outbound p95 objective, measured from plannedFor. */
+export const bandTimingSummarySchema = z
+    .object({
+    serviceBand: z.enum(SERVICE_BANDS),
+    targetMs: z.union([
+        z.literal(SERVICE_MODE_POLICY.firstOutboundP95TargetMs.realtime),
+        z.literal(SERVICE_MODE_POLICY.firstOutboundP95TargetMs.short_bulk),
+        z.literal(SERVICE_MODE_POLICY.firstOutboundP95TargetMs.bulk),
+    ]),
+    breachCount: countSchema,
+    customerBlockedCount: countSchema,
+    eligibleOutstandingBreachCount: countSchema,
+    maturedCount: countSchema,
+    verdict: z.enum(DELIVERY_TIMING_VERDICTS),
+    withinTargetCount: countSchema,
+})
+    .superRefine((value, context) => {
+    const matured = BigInt(value.maturedCount);
+    const within = BigInt(value.withinTargetCount);
+    const expected = matured === 0n
+        ? "unknown"
+        : within * 100n >= matured * 95n
+            ? "met"
+            : "missed";
+    if (value.targetMs !==
+        SERVICE_MODE_POLICY.firstOutboundP95TargetMs[value.serviceBand] ||
+        within + BigInt(value.breachCount) !== matured ||
+        value.eligibleOutstandingBreachCount > value.breachCount ||
+        value.verdict !== expected) {
+        context.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "band target and verdict must match the exact service-band counts",
+        });
+    }
+});
 /**
  * Exact rolling 24-hour due-time cohort for one project and timing policy.
  *
@@ -57,6 +95,19 @@ export const timingThresholdSummarySchema = z
  * samples only and remain separate from the exact threshold counters.
  */
 export const deliveryTimingSummarySchema = z.object({
+    /** Present on timing-v2: banded work is judged here, legacy work in targets. */
+    bandTargets: z
+        .array(bandTimingSummarySchema)
+        .length(3)
+        .superRefine((targets, context) => {
+        if (targets.some((target, index) => target.serviceBand !== SERVICE_BANDS[index])) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "band targets must contain realtime, short_bulk and bulk in order",
+            });
+        }
+    })
+        .optional(),
     customerBlockedCount: countSchema,
     deliveredSampleCount: countSchema,
     freshness: z.object({ kind: z.literal("authoritative") }),

package/dist/zod-values.d.ts

@@ -1,3 +1,3 @@
-/** The exact Zod constructors used by delivery-runtime contract modules. */
+/** The exact Zod constructors the contract modules use. */
 export { ZodError, ZodIssueCode, array, boolean, discriminatedUnion, enum, int, json, literal, number, never, object, partialRecord, record, strictObject, string, toJSONSchema, tuple, union, unknown, url, } from "zod";
 export type { RefinementCtx, ZodType, ZodTypeAny, infer, input } from "zod";

package/dist/zod-values.js

@@ -1,2 +1,2 @@
-/** The exact Zod constructors used by delivery-runtime contract modules. */
+/** The exact Zod constructors the contract modules use. */
 export { ZodError, ZodIssueCode, array, boolean, discriminatedUnion, enum, int, json, literal, number, never, object, partialRecord, record, strictObject, string, toJSONSchema, tuple, union, unknown, url, } from "zod";

package/dist/zod.d.ts

@@ -1,2 +1,2 @@
-/** Tree-shakeable namespace for delivery-runtime contract modules. */
+/** Tree-shakeable Zod namespace for the contract modules. */
 export * as z from "./zod-values.js";

package/dist/zod.js

@@ -1,2 +1,2 @@
-/** Tree-shakeable namespace for delivery-runtime contract modules. */
+/** Tree-shakeable Zod namespace for the contract modules. */
 export * as z from "./zod-values.js";

package/generated/v1/examples/billing.noticesdismiss.request.json

@@ -0,0 +1,3 @@
+{
+  "through": "2026-09-10T12:00:00.000Z"
+}

package/generated/v1/examples/billing.noticesdismiss.response.json

@@ -0,0 +1,6 @@
+{
+  "dismissed": 3,
+  "freshness": {
+    "kind": "authoritative"
+  }
+}

package/generated/v1/examples/billing.reconcile.response.json

@@ -3,6 +3,18 @@
     "boundary": "2026-09-01T00:00:00.000Z",
     "mode": "shadow"
   },
+  "attemptPrice": {
+    "bulk": {
+      "currency": "USD",
+      "microdollars": "10",
+      "scale": 6
+    },
+    "realtime": {
+      "currency": "USD",
+      "microdollars": "10",
+      "scale": 6
+    }
+  },
   "blockingReasons": [],
   "budgetPolicy": {
     "desired": {

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

@@ -3,6 +3,18 @@
     "boundary": "2026-09-01T00:00:00.000Z",
     "mode": "shadow"
   },
+  "attemptPrice": {
+    "bulk": {
+      "currency": "USD",
+      "microdollars": "10",
+      "scale": 6
+    },
+    "realtime": {
+      "currency": "USD",
+      "microdollars": "10",
+      "scale": 6
+    }
+  },
   "blockingReasons": [],
   "budgetPolicy": {
     "desired": {

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

@@ -6,6 +6,7 @@
       "id": "occ_01h8xyz9k2m4n6p8r0t2v4w6y8",
       "plannedFor": "2026-07-28T15:00:00.000Z",
       "schedule": "sch_01h8xyz9k2m4n6p8r0t2v4w6y8",
+      "scheduleName": "Nightly report",
       "sequence": 1,
       "settledAt": "2026-07-28T15:00:01.000Z",
       "state": "succeeded"

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

@@ -1,6 +1,6 @@
 {
   "limits": {
-    "inlinePayloadBytes": 65536,
+    "inlinePayloadBytes": 8192,
     "forecastHorizonSeconds": 90000,
     "usageWindowDays": 366
   },

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

@@ -13,6 +13,7 @@
     "statusWebhook": {
       "url": "https://hooks.example.com/status",
       "events": ["failed"],
+      "endpoint": "ep_01h8xyz9k2m4n6p8r0t2v4w6y8",
       "signingKey": {
         "id": "csk_01h8xyz9k2m4n6p8r0t2v4w6y8"
       },

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

@@ -2,12 +2,6 @@
   "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",

package/generated/v1/examples/projects.read.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": "Billing reminders",
+  "status": "archived",
+  "version": 2
+}

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

@@ -18,9 +18,7 @@
     }
   ],
   "freshness": {
-    "asOf": "2026-07-28T15:00:00.000Z",
-    "kind": "projected",
-    "lagSeconds": 0
+    "kind": "authoritative"
   },
   "nextCursor": "eyJhIjoxNzg1MjUwODAwMDAwLCJpIjoic2NoXzAxaDh4eXo5azJtNG42cDhyMHQydjR3Nnk4IiwiayI6Ijk1MTM1NDZmIn0"
 }

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

@@ -0,0 +1,174 @@
+{
+  "counts": {
+    "active": 4863,
+    "paused": 3,
+    "completed": 148738,
+    "cancelled": 212
+  },
+  "pausedAfterFailures": {
+    "count": 0,
+    "schedules": []
+  },
+  "days": [
+    {
+      "date": "2026-09-25",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-09-26",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-09-27",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-09-28",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-09-29",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-09-30",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-01",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-02",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-03",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-04",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-05",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-06",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-07",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-08",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-09",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-10",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-11",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-12",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-13",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-14",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-15",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-16",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-17",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-18",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-19",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-20",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-21",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-22",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-23",
+      "created": 0,
+      "finished": 0
+    },
+    {
+      "date": "2026-10-24",
+      "created": 5,
+      "finished": 2
+    }
+  ],
+  "window": {
+    "from": "2026-09-25",
+    "to": "2026-10-24",
+    "timeZone": "America/Chicago"
+  },
+  "freshness": {
+    "asOf": "2026-10-24T14:58:00.000Z",
+    "kind": "projected",
+    "lagSeconds": 120
+  }
+}

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

@@ -1,4 +1,36 @@
 {
+  "bandTargets": [
+    {
+      "serviceBand": "realtime",
+      "targetMs": 1000,
+      "breachCount": 0,
+      "customerBlockedCount": 0,
+      "eligibleOutstandingBreachCount": 0,
+      "maturedCount": 0,
+      "verdict": "unknown",
+      "withinTargetCount": 0
+    },
+    {
+      "serviceBand": "short_bulk",
+      "targetMs": 10000,
+      "breachCount": 0,
+      "customerBlockedCount": 0,
+      "eligibleOutstandingBreachCount": 0,
+      "maturedCount": 0,
+      "verdict": "unknown",
+      "withinTargetCount": 0
+    },
+    {
+      "serviceBand": "bulk",
+      "targetMs": 60000,
+      "breachCount": 0,
+      "customerBlockedCount": 0,
+      "eligibleOutstandingBreachCount": 0,
+      "maturedCount": 0,
+      "verdict": "unknown",
+      "withinTargetCount": 0
+    }
+  ],
   "customerBlockedCount": 2,
   "deliveredSampleCount": 98,
   "freshness": {
@@ -8,7 +40,7 @@
   "p95LatenessMs": 4200,
   "p99LatenessMs": 12000,
   "platformBlockedCount": 1,
-  "policyVersion": "timing-v1",
+  "policyVersion": "timing-v2-service-bands",
   "skippedCount": 3,
   "targets": [
     {