@pattern-stack/codegen 0.18.0 → 0.20.0

package/dist/{chunk-CFFTPWHM.js → chunk-KK5A7B2T.js}

@@ -625,6 +625,22 @@ var RetrySchema = z2.object({
   attempts: z2.number().int().min(0).max(20),
   backoff: z2.enum(EVENT_BACKOFF_STRATEGIES)
 }).strict();
+var DURATION_RE = /^\s*[0-9]*\.?[0-9]+\s*(ms|s|m|h|d)\s*$/;
+var ScheduleSchema = z2.object({
+  every: z2.union([
+    z2.string().regex(
+      DURATION_RE,
+      "schedule.every must be a duration like '1h', '30m', '15s', '500ms', '1d'"
+    ),
+    z2.number().positive().finite()
+  ]),
+  /** Epoch-anchored slot boundaries (default true). */
+  align: z2.boolean().optional().default(true),
+  /** Backfill missed slots on recovery (default false → run once). */
+  catchUp: z2.boolean().optional().default(false),
+  /** Upper bound on `catchUp` backfill (default 1000). */
+  maxCatchUpSlots: z2.number().int().positive().optional().default(1e3)
+}).strict();
 var SNAKE_CASE_RE = /^[a-z][a-z0-9_]*$/;
 var EventDefinitionSchemaCore = z2.object({
   type: z2.string().regex(
@@ -645,6 +661,9 @@ var EventDefinitionSchemaCore = z2.object({
     attempts: 3,
     backoff: "exponential"
   }),
+  // ADR-039 — declarative time-based emission. Optional; when present the
+  // platform emits this event on the given cadence (see ScheduleSchema).
+  schedule: ScheduleSchema.optional(),
   version: z2.number().int().min(1).optional().default(1),
   description: z2.string().optional()
 }).strict();
@@ -665,6 +684,13 @@ var EventDefinitionSchemaRefined = EventDefinitionSchemaCore.superRefine(
           path: ["direction"]
         });
       }
+      if (data.schedule !== void 0) {
+        ctx.addIssue({
+          code: z2.ZodIssueCode.custom,
+          message: `Event '${data.type}' is tier:audit; 'schedule' is not allowed on audit events (they route to no pool and cannot drive the bridge). Make it a domain event with a direction. See ADR-039.`,
+          path: ["schedule"]
+        });
+      }
       return;
     }
     if (data.direction === void 0) {
@@ -1011,6 +1037,12 @@ var ClientSchema = z5.object({
   class: ImportRefSchema,
   base_url: z5.string().url("client.base_url must be an absolute URL")
 }).strict();
+var DisplaySchema = z5.object({
+  category: z5.string().optional(),
+  blurb: z5.string().optional(),
+  // Sub-line shown on an unconnected ("available") tile.
+  hint: z5.string().optional()
+}).strict();
 var ProviderDefinitionSchema = z5.object({
   // Provider id — the canonical string used as detection: keys, audit rows,
   // subscription rows. kebab/lower; unique across definitions/providers/
@@ -1020,19 +1052,49 @@ var ProviderDefinitionSchema = z5.object({
     "slug must be kebab-case lower (e.g. 'google', 'hubspot')"
   ),
   display_name: z5.string().optional(),
-  auth: AuthSchema,
-  client: ClientSchema,
+  // Lifecycle: 'active' providers drive backend provider/adapter emission
+  // and require auth + client. 'planned' providers are roadmap stubs — they
+  // appear in the frontend catalog (as unconnectable tiles) but are skipped
+  // by all backend emission and by the surface/import cross-checks, so a
+  // stub can exist before its surface has entities or its strategy/client
+  // are written.
+  status: z5.enum(["active", "planned"]).default("active"),
+  // Frontend catalog presentation (see DisplaySchema).
+  display: DisplaySchema.optional(),
+  // Required iff status === 'active'; see superRefine below.
+  auth: AuthSchema.optional(),
+  client: ClientSchema.optional(),
   // Surfaces this provider serves (ADR-0006: surfaces span contexts — one
   // Google OAuth feeds calendar+mail+transcript). Each must reference a real
   // `surface:` declared on some entity; that cross-check is in
-  // validate-providers.ts. Non-empty enforced here.
+  // validate-providers.ts (skipped for 'planned'). Non-empty enforced here.
   surfaces: z5.array(z5.string()).min(1, "surfaces must list at least one surface"),
   // Optional auth lifecycle hints consumed by provider-module emission (D2).
   // `refresh_behavior` is left as a free string in D1 — its domain firms up
   // when D2 consumes it; carrying it now keeps the YAML lossless.
   token_lifetime: z5.number().int().positive().optional(),
   refresh_behavior: z5.string().optional()
-}).strict();
+}).strict().superRefine((def, ctx) => {
+  if (def.status === "active") {
+    if (!def.auth) {
+      ctx.addIssue({
+        code: z5.ZodIssueCode.custom,
+        message: "auth is required when status is 'active'",
+        path: ["auth"]
+      });
+    }
+    if (!def.client) {
+      ctx.addIssue({
+        code: z5.ZodIssueCode.custom,
+        message: "client is required when status is 'active'",
+        path: ["client"]
+      });
+    }
+  }
+});
+function isActiveProvider(def) {
+  return def.status !== "planned";
+}
 
 // src/utils/yaml-loader.ts
 function loadEntityFromYaml(filePath) {
@@ -1843,6 +1905,7 @@ function validateProviders(providers, opts) {
   }
   for (const { definition, filePath } of providers) {
     const { slug } = definition;
+    if (definition.status === "planned") continue;
     for (const surface of definition.surfaces) {
       if (!knownSurfaces.has(surface)) {
         const known = [...knownSurfaces].sort().join(", ") || "(none declared)";
@@ -1864,6 +1927,7 @@ function validateProviders(providers, opts) {
         sourceRoot: opts.sourceRoot,
         aliases: opts.aliases
       };
+      if (!isActiveProvider(definition)) continue;
       const refs = [
         { field: "auth.strategy", ref: definition.auth.strategy },
         { field: "client.class", ref: definition.client.class }
@@ -4064,6 +4128,7 @@ export {
   validateJunctionDefinition,
   safeValidateJunctionDefinition,
   parseImportRef,
+  isActiveProvider,
   loadEntityFromYaml,
   loadEntitiesFromYaml,
   loadRelationshipFromYaml,
@@ -4124,4 +4189,4 @@ export {
   analyzeDomain,
   validateEntities
 };
-//# sourceMappingURL=chunk-CFFTPWHM.js.map
+//# sourceMappingURL=chunk-KK5A7B2T.js.map