@pattern-stack/codegen 0.11.0 → 0.12.0

package/dist/src/index.d.ts

@@ -1692,6 +1692,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             value?: unknown;
         }[] | undefined;
     }>]>>>;
+    surface: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodString>;
     events: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         queue: z.ZodString;
@@ -1955,6 +1957,16 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         measure_packs?: string[] | undefined;
         cube_name?: string | undefined;
     }>>;
+    unique_indexes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        fields: z.ZodArray<z.ZodString, "many">;
+        name: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        fields: string[];
+        name?: string | undefined;
+    }, {
+        fields: string[];
+        name?: string | undefined;
+    }>, "many">>;
 }, "strict", z.ZodTypeAny, {
     fields: Record<string, {
         type: "string" | "boolean" | "integer" | "date" | "json" | "decimal" | "uuid" | "datetime" | "entity_ref" | "string_array" | "enum";
@@ -2100,6 +2112,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             value?: unknown;
         }[];
     }> | undefined;
+    surface?: string | undefined;
+    context?: string | undefined;
     events?: {
         name: string;
         queue: string;
@@ -2153,6 +2167,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         measure_packs?: string[] | undefined;
         cube_name?: string | undefined;
     } | undefined;
+    unique_indexes?: {
+        fields: string[];
+        name?: string | undefined;
+    }[] | undefined;
 }, {
     fields: Record<string, {
         type: "string" | "boolean" | "integer" | "date" | "json" | "decimal" | "uuid" | "datetime" | "entity_ref" | "string_array" | "enum";
@@ -2298,6 +2316,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             value?: unknown;
         }[] | undefined;
     }> | undefined;
+    surface?: string | undefined;
+    context?: string | undefined;
     events?: {
         name: string;
         queue: string;
@@ -2351,6 +2371,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         measure_packs?: string[] | undefined;
         cube_name?: string | undefined;
     } | undefined;
+    unique_indexes?: {
+        fields: string[];
+        name?: string | undefined;
+    }[] | undefined;
 }>, {
     fields: Record<string, {
         type: "string" | "boolean" | "integer" | "date" | "json" | "decimal" | "uuid" | "datetime" | "entity_ref" | "string_array" | "enum";
@@ -2496,6 +2520,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             value?: unknown;
         }[];
     }> | undefined;
+    surface?: string | undefined;
+    context?: string | undefined;
     events?: {
         name: string;
         queue: string;
@@ -2549,6 +2575,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         measure_packs?: string[] | undefined;
         cube_name?: string | undefined;
     } | undefined;
+    unique_indexes?: {
+        fields: string[];
+        name?: string | undefined;
+    }[] | undefined;
 }, {
     fields: Record<string, {
         type: "string" | "boolean" | "integer" | "date" | "json" | "decimal" | "uuid" | "datetime" | "entity_ref" | "string_array" | "enum";
@@ -2694,6 +2724,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             value?: unknown;
         }[] | undefined;
     }> | undefined;
+    surface?: string | undefined;
+    context?: string | undefined;
     events?: {
         name: string;
         queue: string;
@@ -2747,6 +2779,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         measure_packs?: string[] | undefined;
         cube_name?: string | undefined;
     } | undefined;
+    unique_indexes?: {
+        fields: string[];
+        name?: string | undefined;
+    }[] | undefined;
 }>, {
     fields: Record<string, {
         type: "string" | "boolean" | "integer" | "date" | "json" | "decimal" | "uuid" | "datetime" | "entity_ref" | "string_array" | "enum";
@@ -2892,6 +2928,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             value?: unknown;
         }[];
     }> | undefined;
+    surface?: string | undefined;
+    context?: string | undefined;
     events?: {
         name: string;
         queue: string;
@@ -2945,6 +2983,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         measure_packs?: string[] | undefined;
         cube_name?: string | undefined;
     } | undefined;
+    unique_indexes?: {
+        fields: string[];
+        name?: string | undefined;
+    }[] | undefined;
 }, {
     fields: Record<string, {
         type: "string" | "boolean" | "integer" | "date" | "json" | "decimal" | "uuid" | "datetime" | "entity_ref" | "string_array" | "enum";
@@ -3090,6 +3132,8 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
             value?: unknown;
         }[] | undefined;
     }> | undefined;
+    surface?: string | undefined;
+    context?: string | undefined;
     events?: {
         name: string;
         queue: string;
@@ -3143,6 +3187,10 @@ declare const EntityDefinitionSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
         measure_packs?: string[] | undefined;
         cube_name?: string | undefined;
     } | undefined;
+    unique_indexes?: {
+        fields: string[];
+        name?: string | undefined;
+    }[] | undefined;
 }>;
 type EntityDefinition = z.infer<typeof EntityDefinitionSchema>;
 

package/dist/src/index.js

@@ -1427,6 +1427,36 @@ var EntityDefinitionSchema = z3.object({
   // appear in `integration.providers` — see the superRefine on
   // `EntityDefinitionSchema` below.
   detection: z3.record(z3.string(), DetectionConfigSchema).optional(),
+  // RFC-0001 §1/§8: the integration *surface* this entity belongs to
+  // (e.g. 'calendar', 'mail', 'crm'). Surfaces span provider contexts
+  // (ADR-0006) — one Google OAuth feeds calendar+mail+transcript. The union
+  // of `surface:` values across all entity YAML is the closed set that a
+  // provider's `surfaces:` must be a subset of (cross-checked in
+  // src/parser/validate-providers.ts). Optional: entities without an
+  // integration surface omit it. The surface-package *emission* convention
+  // is Track C (#329); this field is only the declarative input both tracks
+  // read.
+  surface: z3.string().optional(),
+  // Bounded-context declaration (ADR-0004) — "which bounded context this
+  // entity belongs to". This is the DURABLE decision; it is a plain
+  // bounded-context slug, NOT a folder knob. Different features consume it:
+  //
+  //   - #403 (this PR, the FIRST consumer): drives the generated code's
+  //     module output folder. clean-lite-ps nests the entity's module under
+  //     `<modules>/<context>/<entity>/` so same-context entities group
+  //     together; untagged entities stay flat (`<modules>/<entity>/`).
+  //   - ADR-0004 (deferred): a later `naming: prefix | schema` knob reads
+  //     this SAME field to drive the Postgres physical layout —
+  //     `prefix` → `pgTable('<context>__<table>')`, then the flip to
+  //     `schema` → `pgSchema('<context>').table('<table>')`. NOT wired here;
+  //     #403 makes no table/column/schema changes.
+  //
+  // Sibling to `surface:` and orthogonal to it (ADR-0006): context = model
+  // cohesion (which domain), surface = vendor composition (which integration).
+  context: z3.string().regex(
+    /^[a-z][a-z0-9_]*$/,
+    "context must be lowercase snake_case (e.g. 'integration')"
+  ).optional(),
   // v2: Domain event declarations (CODEGEN-EVOLUTION-PLAN Phase 2)
   // Generates typed event classes, handlers, and queue registration
   events: z3.array(EventDeclarationSchema).optional(),
@@ -1445,7 +1475,18 @@ var EntityDefinitionSchema = z3.object({
   ).optional(),
   // v2: Analytics / semantic layer configuration
   // Cube.js measure packs, custom cube name, and metric definitions
-  analytics: AnalyticsBlockSchema.optional()
+  analytics: AnalyticsBlockSchema.optional(),
+  // Composite (multi-column) unique indexes (#356). Single-column uniqueness
+  // is `unique: true` on the field itself; this declares constraints that
+  // span 2+ columns, e.g. UNIQUE (conversation_id, sequence). Emitted as a
+  // `uniqueIndex(...).on(...)` entry in the generated entity's pgTable
+  // extra-config callback. `name` defaults to <table>_<col1>_<col2>_uniq.
+  unique_indexes: z3.array(
+    z3.object({
+      fields: z3.array(z3.string()).min(2, "unique_indexes entries span 2+ columns \u2014 use `unique: true` on the field for single-column uniqueness"),
+      name: z3.string().optional()
+    }).strict()
+  ).optional()
 }).strict().refine(
   (data) => !data.eav_value_table || typeof data.eav_definition_table === "string",
   {
@@ -1882,6 +1923,56 @@ function safeValidateJunctionDefinition(data) {
   return { success: false, error: result.error };
 }
 
+// src/schema/provider-definition.schema.ts
+import { z as z7 } from "zod";
+var IMPORT_REF_RE = /^[^#\s]+#[A-Za-z_$][A-Za-z0-9_$]*$/;
+var ImportRefSchema = z7.string().regex(
+  IMPORT_REF_RE,
+  "must be an 'import-path#Export' reference (e.g. '@app/foo/bar.strategy#BarStrategy')"
+);
+var AuthTypeSchema = z7.enum(["oauth2", "api-key", "app-password"]);
+var AuthSchema = z7.object({
+  type: AuthTypeSchema,
+  // Class implementing the auth subsystem's strategy contract (ADR-031).
+  // Pre-flight verified against a real export at codegen time.
+  strategy: ImportRefSchema,
+  // Required (and non-empty) iff type === 'oauth2'; see refine below.
+  scopes: z7.array(z7.string()).optional()
+}).strict().refine(
+  (a) => a.type !== "oauth2" || a.scopes !== void 0 && a.scopes.length > 0,
+  {
+    message: "auth.scopes is required and must be non-empty when auth.type is 'oauth2'",
+    path: ["scopes"]
+  }
+);
+var ClientSchema = z7.object({
+  // API client class. Pre-flight verified against a real export.
+  class: ImportRefSchema,
+  base_url: z7.string().url("client.base_url must be an absolute URL")
+}).strict();
+var ProviderDefinitionSchema = z7.object({
+  // Provider id — the canonical string used as detection: keys, audit rows,
+  // subscription rows. kebab/lower; unique across definitions/providers/
+  // (uniqueness is a cross-file check in validate-providers.ts).
+  slug: z7.string().regex(
+    /^[a-z][a-z0-9-]*$/,
+    "slug must be kebab-case lower (e.g. 'google', 'hubspot')"
+  ),
+  display_name: z7.string().optional(),
+  auth: AuthSchema,
+  client: ClientSchema,
+  // 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.
+  surfaces: z7.array(z7.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: z7.number().int().positive().optional(),
+  refresh_behavior: z7.string().optional()
+}).strict();
+
 // src/utils/yaml-loader.ts
 function loadEntityFromYaml(filePath) {
   if (!existsSync(filePath)) {
@@ -2389,6 +2480,11 @@ function resolveRelationshipReferences(relationshipDefs, entities) {
   return issues;
 }
 
+// src/parser/validate-providers.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2, statSync } from "fs";
+import { isAbsolute, join as join2, resolve as resolve3 } from "path";
+import ts from "typescript";
+
 // src/analyzer/graph-builder.ts
 function inferCardinality(type) {
   switch (type) {
@@ -3928,8 +4024,8 @@ var BasePattern = definePattern({
 });
 
 // src/patterns/library/junction.pattern.ts
-import { z as z7 } from "zod";
-var JunctionPatternConfigSchema = z7.object({}).strict();
+import { z as z8 } from "zod";
+var JunctionPatternConfigSchema = z8.object({}).strict();
 var JunctionPattern = definePattern({
   name: "Junction",
   description: "Explicit many-to-many junction with role + temporal + sourcing metadata",