@stndrds/schema 0.1.0-alpha.15 → 0.1.0-alpha.16

package/dist/index.js

@@ -131,6 +131,10 @@ __export(index_exports, {
   DuplicateError: () => DuplicateError,
   FileNotFoundError: () => FileNotFoundError,
   FileService: () => FileService,
+  FlowBuilder: () => FlowBuilder,
+  FlowPageBuilder: () => FlowPageBuilder,
+  FlowRowBuilder: () => FlowRowBuilder,
+  FlowService: () => FlowService,
   ForbiddenError: () => ForbiddenError,
   GeocodingService: () => GeocodingService,
   GlobalSearchService: () => GlobalSearchService,
@@ -198,6 +202,7 @@ __export(index_exports, {
   extractAttributeNames: () => extractAttributeNames,
   file: () => file,
   fileConfigSchema: () => fileConfigSchema,
+  flow: () => flow,
   generateId: () => generateId,
   generatePrefixedId: () => generatePrefixedId,
   getAttributeConfigSchema: () => getAttributeConfigSchema,
@@ -208,6 +213,8 @@ __export(index_exports, {
   isAdvancedFilterState: () => isAdvancedFilterState,
   isCustomTab: () => isCustomTab,
   isDefaultRole: () => isDefaultRole,
+  isFlowDefinition: () => isFlowDefinition,
+  isFlowPublished: () => isFlowPublished,
   isForbiddenError: () => isForbiddenError,
   isFormTab: () => isFormTab,
   isLabelExpression: () => isLabelExpression,
@@ -216,6 +223,7 @@ __export(index_exports, {
   isProtectedResourceError: () => isProtectedResourceError,
   isRecordComplete: () => isRecordComplete,
   isSchemaError: () => isSchemaError,
+  isSystemFlow: () => isSystemFlow,
   isTableTab: () => isTableTab,
   isValidationError: () => isValidationError,
   location: () => location,
@@ -392,6 +400,17 @@ function isNoValueOperator(operator) {
   return NO_VALUE_OPERATORS.includes(operator);
 }
 
+// src/types/flows.ts
+function isFlowDefinition(obj) {
+  return typeof obj === "object" && obj !== null && "slots" in obj && "pages" in obj && "relations" in obj && "status" in obj;
+}
+function isFlowPublished(flow2) {
+  return flow2.status === "published";
+}
+function isSystemFlow(flow2) {
+  return flow2.system === true;
+}
+
 // src/types/geocoding.ts
 var NoopGeocodingAdapter = class {
   async autocomplete() {
@@ -1284,8 +1303,361 @@ function rating(config) {
   return new RatingAttributeBuilder(config.name, config.label);
 }
 
+// src/builders/flow-builder.ts
+var import_zod = require("zod");
+var FlowRowBuilder = class {
+  /** @internal */
+  constructor(pageBuilder, id, order) {
+    this.pageBuilder = pageBuilder;
+    this.rowData = {
+      id,
+      order,
+      fields: []
+    };
+  }
+  /**
+   * Add a field to the current row
+   *
+   * @param slotId - Reference to a slot defined with .slot()
+   * @param attribute - Attribute name on the object
+   * @param options - Optional field configuration
+   *
+   * @example
+   * ```typescript
+   * .row("row-1")
+   *   .field("mr", "firstName")
+   *   .field("mr", "lastName")
+   * ```
+   */
+  field(slotId, attribute, options) {
+    const field = {
+      id: `${this.rowData.id}-${slotId}-${attribute}`,
+      slotId,
+      attribute,
+      label: options?.label,
+      required: options?.required
+    };
+    this.rowData.fields.push(field);
+    return this;
+  }
+  /**
+   * Start a new row on the same page
+   */
+  row(id) {
+    return this.pageBuilder._finalizeRow(this.rowData).row(id);
+  }
+  /**
+   * Start a new page
+   */
+  page(id, label, description) {
+    return this.pageBuilder._finalizeRow(this.rowData)._getFlow().page(id, label, description);
+  }
+  /**
+   * Build the final flow definition
+   */
+  build() {
+    return this.pageBuilder._finalizeRow(this.rowData)._getFlow().build();
+  }
+};
+var FlowPageBuilder = class {
+  /** @internal */
+  constructor(flow2, id, label, description) {
+    this.rowOrder = 0;
+    this.flow = flow2;
+    this.pageData = {
+      id,
+      label,
+      description,
+      order: 0,
+      // Will be set when finalized
+      rows: []
+    };
+  }
+  /**
+   * Add a row to the current page
+   *
+   * @param id - Unique row identifier
+   *
+   * @example
+   * ```typescript
+   * .page("identity", "Identité")
+   *   .row("name-row")
+   *     .field("mr", "firstName")
+   *     .field("mr", "lastName")
+   *   .row("email-row")
+   *     .field("mr", "email")
+   * ```
+   */
+  row(id) {
+    this.rowOrder++;
+    return new FlowRowBuilder(this, id, this.rowOrder);
+  }
+  /**
+   * Start a new page
+   */
+  page(id, label, description) {
+    return this.flow._finalizePage(this.pageData).page(id, label, description);
+  }
+  /**
+   * Build the final flow definition
+   */
+  build() {
+    return this.flow._finalizePage(this.pageData).build();
+  }
+  /** @internal */
+  _finalizeRow(row) {
+    if (row.id && row.fields.length > 0) {
+      this.pageData.rows?.push(row);
+    }
+    return this;
+  }
+  /** @internal */
+  _getFlow() {
+    return this.flow._finalizePage(this.pageData);
+  }
+  /** @internal */
+  _getPageData() {
+    return this.pageData;
+  }
+};
+var FlowBuilder = class {
+  constructor(name, label) {
+    this.data = {
+      slots: [],
+      pages: [],
+      relations: [],
+      status: "published",
+      // System flows are always published
+      version: 1,
+      system: true
+    };
+    this.validateName(name);
+    this.data.name = name;
+    this.data.label = label;
+  }
+  /**
+   * Set flow description
+   */
+  description(value) {
+    this.data.description = value;
+    return this;
+  }
+  /**
+   * Set flow icon
+   */
+  icon(value) {
+    this.data.icon = value;
+    return this;
+  }
+  /**
+   * Set extensible metadata
+   */
+  metadata(value) {
+    this.data.metadata = value;
+    return this;
+  }
+  /**
+   * Add a slot (object to create in the flow)
+   *
+   * @param id - Unique slot identifier (used to reference in fields and relations)
+   * @param objectName - Name of the object to create
+   * @param label - Display label for the slot
+   * @param options - Optional slot configuration
+   *
+   * @example
+   * ```typescript
+   * .slot("mr", "contacts", "Monsieur", { color: "blue", icon: "user" })
+   * .slot("company", "companies", "Entreprise", { color: "green" })
+   * ```
+   */
+  slot(id, objectName, label, options) {
+    if (this.data.slots?.some((s) => s.id === id)) {
+      throw new Error(`[FlowBuilder] Duplicate slot id: "${id}"`);
+    }
+    this.data.slots?.push({
+      id,
+      objectName,
+      label,
+      color: options?.color,
+      icon: options?.icon
+    });
+    return this;
+  }
+  /**
+   * Define a relation between two slots
+   * The source slot will be linked to the target slot via the specified attribute
+   *
+   * @param sourceSlotId - Slot that has the relation attribute
+   * @param sourceAttribute - Relation attribute name on the source
+   * @param targetSlotId - Target slot to link to
+   *
+   * @example
+   * ```typescript
+   * // mr.company → company (the contact's company field will be set to the created company)
+   * .relation("mr", "company", "company")
+   * ```
+   */
+  relation(sourceSlotId, sourceAttribute, targetSlotId) {
+    this.data.relations?.push({
+      id: `${sourceSlotId}-${sourceAttribute}-${targetSlotId}`,
+      sourceSlotId,
+      sourceAttribute,
+      targetSlotId
+    });
+    return this;
+  }
+  /**
+   * Start a new page/step in the flow
+   *
+   * @param id - Unique page identifier
+   * @param label - Display label
+   * @param description - Optional description
+   *
+   * @example
+   * ```typescript
+   * .page("identity", "Identité", "Informations personnelles")
+   *   .row("name")
+   *     .field("mr", "firstName")
+   *     .field("mr", "lastName")
+   * ```
+   */
+  page(id, label, description) {
+    return new FlowPageBuilder(this, id, label, description);
+  }
+  /**
+   * Build and validate the flow definition
+   *
+   * @throws Error if validation fails
+   */
+  build() {
+    this.validateRequiredData();
+    const slotIds = new Set(this.data.slots?.map((s) => s.id) ?? []);
+    this.validateFieldReferences(slotIds);
+    this.validateRelationReferences(slotIds);
+    this.validateNoCircularDependencies();
+    return this.data;
+  }
+  /**
+   * Validate that required data is present
+   */
+  validateRequiredData() {
+    if (!this.data.slots || this.data.slots.length === 0) {
+      throw new Error("[FlowBuilder] At least one slot is required. Use .slot() to add slots.");
+    }
+    if (!this.data.pages || this.data.pages.length === 0) {
+      throw new Error("[FlowBuilder] At least one page is required. Use .page() to add pages.");
+    }
+  }
+  /**
+   * Validate that all field slotId references exist
+   */
+  validateFieldReferences(slotIds) {
+    for (const page of this.data.pages ?? []) {
+      for (const row of page.rows) {
+        for (const field of row.fields) {
+          if (!slotIds.has(field.slotId)) {
+            throw new Error(
+              `[FlowBuilder] Field "${field.id}" references unknown slot "${field.slotId}" in page "${page.id}". Available slots: ${[...slotIds].join(", ")}`
+            );
+          }
+        }
+      }
+    }
+  }
+  /**
+   * Validate that all relation references exist and are valid
+   */
+  validateRelationReferences(slotIds) {
+    for (const relation2 of this.data.relations ?? []) {
+      if (!slotIds.has(relation2.sourceSlotId)) {
+        throw new Error(
+          `[FlowBuilder] Relation references unknown source slot "${relation2.sourceSlotId}". Available slots: ${[...slotIds].join(", ")}`
+        );
+      }
+      if (!slotIds.has(relation2.targetSlotId)) {
+        throw new Error(
+          `[FlowBuilder] Relation references unknown target slot "${relation2.targetSlotId}". Available slots: ${[...slotIds].join(", ")}`
+        );
+      }
+      if (relation2.sourceSlotId === relation2.targetSlotId) {
+        throw new Error(
+          `[FlowBuilder] Relation cannot link a slot to itself: "${relation2.sourceSlotId}"`
+        );
+      }
+    }
+  }
+  /**
+   * @internal Used by FlowPageBuilder to finalize a page
+   */
+  _finalizePage(page) {
+    if (page.id) {
+      page.order = (this.data.pages?.length ?? 0) + 1;
+      this.data.pages?.push(page);
+    }
+    return this;
+  }
+  /**
+   * Validate flow name format (kebab-case)
+   */
+  validateName(name) {
+    const flowNameSchema = import_zod.z.string().min(1, "Flow name cannot be empty").max(63, "Flow name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
+      message: "Invalid flow name format.\nName must be in kebab-case:\n  \u2705 Valid: 'couple-creation', 'new-contact', 'onboarding-flow'\n  \u274C Invalid: 'CoupleCreation', 'new_contact', 'Onboarding Flow'"
+    });
+    try {
+      flowNameSchema.parse(name);
+    } catch (error) {
+      if (error instanceof import_zod.z.ZodError) {
+        throw new Error(`[FlowBuilder] ${error.issues[0].message}`);
+      }
+      throw error;
+    }
+  }
+  /**
+   * Validate that there are no circular dependencies in relations
+   * Uses DFS to detect cycles in the dependency graph
+   */
+  validateNoCircularDependencies() {
+    const relations = this.data.relations ?? [];
+    if (relations.length === 0) return;
+    const dependsOn = /* @__PURE__ */ new Map();
+    for (const slot of this.data.slots ?? []) {
+      dependsOn.set(slot.id, /* @__PURE__ */ new Set());
+    }
+    for (const rel of relations) {
+      dependsOn.get(rel.sourceSlotId)?.add(rel.targetSlotId);
+    }
+    const visited = /* @__PURE__ */ new Set();
+    const recursionStack = /* @__PURE__ */ new Set();
+    const hasCycle = (slotId) => {
+      visited.add(slotId);
+      recursionStack.add(slotId);
+      for (const dependency of dependsOn.get(slotId) ?? []) {
+        if (!visited.has(dependency)) {
+          if (hasCycle(dependency)) return true;
+        } else if (recursionStack.has(dependency)) {
+          return true;
+        }
+      }
+      recursionStack.delete(slotId);
+      return false;
+    };
+    for (const slot of this.data.slots ?? []) {
+      if (!visited.has(slot.id)) {
+        if (hasCycle(slot.id)) {
+          throw new Error(
+            "[FlowBuilder] Circular dependency detected in relations. Slots cannot have circular dependencies."
+          );
+        }
+      }
+    }
+  }
+};
+function flow(name, label) {
+  return new FlowBuilder(name, label);
+}
+
 // src/builders/object-builder.ts
-var import_zod = __toESM(require("zod"));
+var import_zod2 = __toESM(require("zod"));
 var ObjectBuilder = class {
   constructor(config) {
     this.validateName(config.name);
@@ -1418,14 +1790,14 @@ The labelExpression defines how records are displayed in lists and relations.
     if (name === void 0) {
       return;
     }
-    const objectNameSchema = import_zod.default.string().min(1, "Object name cannot be empty").max(63, "Object name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
+    const objectNameSchema = import_zod2.default.string().min(1, "Object name cannot be empty").max(63, "Object name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
       message: "Invalid object name format.\nName must be in kebab-case (slug format):\n  \u2705 Valid: 'products', 'user-profiles', 'order-items'\n  \u274C Invalid: 'Products', 'userProfiles', 'user_profiles'"
     });
     try {
       objectNameSchema.parse(name);
     } catch (error) {
-      if (error instanceof import_zod.default.ZodError) {
-        throw new Error(`[ObjectBuilder] ${error.errors[0].message}`);
+      if (error instanceof import_zod2.default.ZodError) {
+        throw new Error(`[ObjectBuilder] ${error.issues[0].message}`);
       }
       throw error;
     }
@@ -1436,7 +1808,7 @@ function object(config) {
 }
 
 // src/builders/view-builder.ts
-var import_zod2 = require("zod");
+var import_zod3 = require("zod");
 var GroupBuilder = class {
   constructor(id, label) {
     this.data = { fields: [] };
@@ -1792,14 +2164,14 @@ var ViewBuilder = class {
    * Validate view name format (kebab-case)
    */
   validateName(name) {
-    const viewNameSchema = import_zod2.z.string().min(1, "View name cannot be empty").max(63, "View name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
+    const viewNameSchema = import_zod3.z.string().min(1, "View name cannot be empty").max(63, "View name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
       message: "Invalid view name format.\nName must be in kebab-case:\n  \u2705 Valid: 'detail', 'list-view', 'company-detail'\n  \u274C Invalid: 'Detail', 'listView', 'list_view'"
     });
     try {
       viewNameSchema.parse(name);
     } catch (error) {
-      if (error instanceof import_zod2.z.ZodError) {
-        throw new Error(`[ViewBuilder] ${error.errors[0].message}`);
+      if (error instanceof import_zod3.z.ZodError) {
+        throw new Error(`[ViewBuilder] ${error.issues[0].message}`);
       }
       throw error;
     }
@@ -2097,35 +2469,35 @@ Available views: ${availableNames}`
 var viewRegistry = new ViewRegistry();
 
 // src/validation/validators.ts
-var import_zod3 = require("zod");
-var baseConfigSchema = import_zod3.z.object({
-  disabled: import_zod3.z.boolean().optional(),
-  placeholder: import_zod3.z.string().optional(),
-  description: import_zod3.z.string().optional(),
-  defaultValue: import_zod3.z.unknown().optional(),
-  icon: import_zod3.z.string().optional(),
-  order: import_zod3.z.number().int().optional(),
-  hidden: import_zod3.z.boolean().optional(),
-  archived: import_zod3.z.boolean().optional(),
-  deprecated: import_zod3.z.boolean().optional(),
-  metadata: import_zod3.z.record(import_zod3.z.unknown()).optional()
+var import_zod4 = require("zod");
+var baseConfigSchema = import_zod4.z.object({
+  disabled: import_zod4.z.boolean().optional(),
+  placeholder: import_zod4.z.string().optional(),
+  description: import_zod4.z.string().optional(),
+  defaultValue: import_zod4.z.unknown().optional(),
+  icon: import_zod4.z.string().optional(),
+  order: import_zod4.z.number().int().optional(),
+  hidden: import_zod4.z.boolean().optional(),
+  archived: import_zod4.z.boolean().optional(),
+  deprecated: import_zod4.z.boolean().optional(),
+  metadata: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional()
 });
-var optionSchema = import_zod3.z.object({
-  id: import_zod3.z.string().min(1),
-  label: import_zod3.z.string().min(1),
-  value: import_zod3.z.string().min(1),
-  color: import_zod3.z.string().optional(),
-  icon: import_zod3.z.string().optional(),
-  description: import_zod3.z.string().optional(),
-  group: import_zod3.z.enum(["idle", "in_progress", "finished"]).optional()
+var optionSchema = import_zod4.z.object({
+  id: import_zod4.z.string().min(1),
+  label: import_zod4.z.string().min(1),
+  value: import_zod4.z.string().min(1),
+  color: import_zod4.z.string().optional(),
+  icon: import_zod4.z.string().optional(),
+  description: import_zod4.z.string().optional(),
+  group: import_zod4.z.enum(["idle", "in_progress", "finished"]).optional()
 });
-var relationTargetSchema = import_zod3.z.object({
-  object: import_zod3.z.string().min(1),
-  displayTemplate: import_zod3.z.string().optional(),
-  filter: import_zod3.z.record(import_zod3.z.unknown()).optional()
+var relationTargetSchema = import_zod4.z.object({
+  object: import_zod4.z.string().min(1),
+  displayTemplate: import_zod4.z.string().optional(),
+  filter: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional()
 });
-var documentTypeConfigSchema = import_zod3.z.object({
-  type: import_zod3.z.enum([
+var documentTypeConfigSchema = import_zod4.z.object({
+  type: import_zod4.z.enum([
     "id_card",
     "passport",
     "incorporation_certificate",
@@ -2136,86 +2508,86 @@ var documentTypeConfigSchema = import_zod3.z.object({
     "proof_of_address",
     "custom"
   ]),
-  label: import_zod3.z.string(),
-  faces: import_zod3.z.array(import_zod3.z.enum(["front", "back", "single"])),
-  attributeMapping: import_zod3.z.array(
-    import_zod3.z.object({
-      attributeId: import_zod3.z.string(),
-      extractedKey: import_zod3.z.string(),
-      face: import_zod3.z.enum(["front", "back", "single"]).optional(),
-      required: import_zod3.z.boolean().optional()
+  label: import_zod4.z.string(),
+  faces: import_zod4.z.array(import_zod4.z.enum(["front", "back", "single"])),
+  attributeMapping: import_zod4.z.array(
+    import_zod4.z.object({
+      attributeId: import_zod4.z.string(),
+      extractedKey: import_zod4.z.string(),
+      face: import_zod4.z.enum(["front", "back", "single"]).optional(),
+      required: import_zod4.z.boolean().optional()
     })
   ).optional()
 });
-var fileVerificationConfigSchema = import_zod3.z.object({
-  enabled: import_zod3.z.boolean(),
-  documentTypes: import_zod3.z.array(documentTypeConfigSchema),
-  autoExtract: import_zod3.z.boolean().optional(),
-  autoValidate: import_zod3.z.boolean().optional()
+var fileVerificationConfigSchema = import_zod4.z.object({
+  enabled: import_zod4.z.boolean(),
+  documentTypes: import_zod4.z.array(documentTypeConfigSchema),
+  autoExtract: import_zod4.z.boolean().optional(),
+  autoValidate: import_zod4.z.boolean().optional()
 });
 var textConfigSchema = baseConfigSchema.extend({
-  minLength: import_zod3.z.number().int().min(0).optional(),
-  maxLength: import_zod3.z.number().int().min(1).optional(),
-  pattern: import_zod3.z.string().optional()
+  minLength: import_zod4.z.number().int().min(0).optional(),
+  maxLength: import_zod4.z.number().int().min(1).optional(),
+  pattern: import_zod4.z.string().optional()
 });
 var textareaConfigSchema = baseConfigSchema;
 var numberConfigSchema = baseConfigSchema.extend({
-  min: import_zod3.z.number().optional(),
-  max: import_zod3.z.number().optional(),
-  unit: import_zod3.z.enum(["integer", "decimal", "percentage"]).optional(),
-  decimals: import_zod3.z.number().int().min(0).optional()
+  min: import_zod4.z.number().optional(),
+  max: import_zod4.z.number().optional(),
+  unit: import_zod4.z.enum(["integer", "decimal", "percentage"]).optional(),
+  decimals: import_zod4.z.number().int().min(0).optional()
 });
 var checkboxConfigSchema = baseConfigSchema;
 var dateConfigSchema = baseConfigSchema.extend({
-  dateFormat: import_zod3.z.enum(["short", "long", "full", "relative"]).optional(),
-  minDate: import_zod3.z.string().optional(),
-  maxDate: import_zod3.z.string().optional()
+  dateFormat: import_zod4.z.enum(["short", "long", "full", "relative"]).optional(),
+  minDate: import_zod4.z.string().optional(),
+  maxDate: import_zod4.z.string().optional()
 });
 var phoneConfigSchema = baseConfigSchema.extend({
-  defaultCountryCode: import_zod3.z.string().length(3).optional()
+  defaultCountryCode: import_zod4.z.string().length(3).optional()
 });
 var currencyConfigSchema = baseConfigSchema.extend({
-  defaultCurrency: import_zod3.z.string().length(3).optional(),
-  allowedCurrencies: import_zod3.z.array(import_zod3.z.string().length(3)).optional()
+  defaultCurrency: import_zod4.z.string().length(3).optional(),
+  allowedCurrencies: import_zod4.z.array(import_zod4.z.string().length(3)).optional()
 });
 var statusConfigSchema = baseConfigSchema.extend({
-  options: import_zod3.z.array(optionSchema).min(1)
+  options: import_zod4.z.array(optionSchema).min(1)
 });
 var locationConfigSchema = baseConfigSchema.extend({
-  granularity: import_zod3.z.enum(["full", "address", "city", "state", "country", "coordinates"]),
-  enableAutocomplete: import_zod3.z.boolean().optional(),
-  enableMap: import_zod3.z.boolean().optional(),
-  defaultCountry: import_zod3.z.string().length(3).optional(),
-  allowedCountries: import_zod3.z.array(import_zod3.z.string().length(3)).optional(),
-  displayFormat: import_zod3.z.enum(["single_line", "multi_line", "compact"]).optional()
+  granularity: import_zod4.z.enum(["full", "address", "city", "state", "country", "coordinates"]),
+  enableAutocomplete: import_zod4.z.boolean().optional(),
+  enableMap: import_zod4.z.boolean().optional(),
+  defaultCountry: import_zod4.z.string().length(3).optional(),
+  allowedCountries: import_zod4.z.array(import_zod4.z.string().length(3)).optional(),
+  displayFormat: import_zod4.z.enum(["single_line", "multi_line", "compact"]).optional()
 });
 var timestampConfigSchema = baseConfigSchema.extend({
-  autoUpdate: import_zod3.z.boolean().optional()
+  autoUpdate: import_zod4.z.boolean().optional()
 });
 var selectConfigSchema = baseConfigSchema.extend({
-  options: import_zod3.z.array(optionSchema).min(1)
+  options: import_zod4.z.array(optionSchema).min(1)
 });
 var multiselectConfigSchema = baseConfigSchema.extend({
-  options: import_zod3.z.array(optionSchema).min(1)
+  options: import_zod4.z.array(optionSchema).min(1)
 });
 var fileConfigSchema = baseConfigSchema.extend({
-  maxFiles: import_zod3.z.number().int().min(1).optional(),
-  maxSize: import_zod3.z.number().int().min(1).optional(),
-  allowedTypes: import_zod3.z.array(import_zod3.z.string()).optional(),
+  maxFiles: import_zod4.z.number().int().min(1).optional(),
+  maxSize: import_zod4.z.number().int().min(1).optional(),
+  allowedTypes: import_zod4.z.array(import_zod4.z.string()).optional(),
   verification: fileVerificationConfigSchema.optional()
 });
 var userConfigSchema = baseConfigSchema.extend({
-  allowedRoles: import_zod3.z.array(import_zod3.z.string()).optional()
+  allowedRoles: import_zod4.z.array(import_zod4.z.string()).optional()
 });
 var relationConfigSchema = baseConfigSchema.extend({
-  targets: import_zod3.z.array(relationTargetSchema).min(1),
-  cardinality: import_zod3.z.enum(["one", "many"]),
-  minItems: import_zod3.z.number().int().min(0).optional(),
-  maxItems: import_zod3.z.number().int().min(1).optional()
+  targets: import_zod4.z.array(relationTargetSchema).min(1),
+  cardinality: import_zod4.z.enum(["one", "many"]),
+  minItems: import_zod4.z.number().int().min(0).optional(),
+  maxItems: import_zod4.z.number().int().min(1).optional()
 });
 var ratingConfigSchema = baseConfigSchema.extend({
-  max: import_zod3.z.number().int().min(1).optional(),
-  iconType: import_zod3.z.enum(["star", "heart", "thumbs", "number"]).optional()
+  max: import_zod4.z.number().int().min(1).optional(),
+  iconType: import_zod4.z.enum(["star", "heart", "thumbs", "number"]).optional()
 });
 var attributeConfigSchemas = {
   text: textConfigSchema,
@@ -2246,7 +2618,7 @@ function validateAttributeConfig(type, config) {
   }
   return {
     success: false,
-    errors: result.error.errors.map((err) => `${err.path.join(".")}: ${err.message}`)
+    errors: result.error.issues.map((err) => `${err.path.join(".")}: ${err.message}`)
   };
 }
 function parseAttributeConfig(type, config) {
@@ -2259,7 +2631,7 @@ function safeParseAttributeConfig(type, config) {
   return result.success ? result.data : void 0;
 }
 function createTextValidator(attr) {
-  let schema = import_zod3.z.string();
+  let schema = import_zod4.z.string();
   if (attr.minLength !== void 0) {
     schema = schema.min(
       attr.minLength,
@@ -2278,7 +2650,7 @@ function createTextValidator(attr) {
   return schema;
 }
 function createNumberValidator(attr) {
-  let schema = import_zod3.z.number();
+  let schema = import_zod4.z.number();
   if (attr.min !== void 0) {
     schema = schema.min(attr.min, `${attr.label} must be at least ${attr.min}`);
   }
@@ -2291,81 +2663,75 @@ function createNumberValidator(attr) {
   return schema;
 }
 function createCheckboxValidator(_attr) {
-  return import_zod3.z.boolean();
+  return import_zod4.z.boolean();
 }
 function createDateValidator(attr) {
-  return import_zod3.z.string().datetime({ message: `${attr.label} must be a valid ISO date` });
+  return import_zod4.z.string().datetime({ message: `${attr.label} must be a valid ISO date` });
 }
 function createPhoneValidator(_attr) {
-  return import_zod3.z.object({
-    countryCode: import_zod3.z.string().length(3),
-    phoneNumber: import_zod3.z.string().min(1)
+  return import_zod4.z.object({
+    countryCode: import_zod4.z.string().length(3),
+    phoneNumber: import_zod4.z.string().min(1)
   });
 }
 function createCurrencyValidator(_attr) {
-  return import_zod3.z.object({
-    code: import_zod3.z.string().length(3),
-    value: import_zod3.z.number().min(0)
+  return import_zod4.z.object({
+    code: import_zod4.z.string().length(3),
+    value: import_zod4.z.number().min(0)
   });
 }
 function createStatusValidator(attr) {
   const validValues = attr.options.map((opt) => opt.value);
-  return import_zod3.z.enum(validValues, {
-    errorMap: () => ({
-      message: `${attr.label} must be one of: ${validValues.join(", ")}`
-    })
+  return import_zod4.z.enum(validValues, {
+    error: `${attr.label} must be one of: ${validValues.join(", ")}`
   });
 }
 function createSelectValidator(attr) {
   const validValues = attr.options.map((opt) => opt.value);
-  return import_zod3.z.enum(validValues, {
-    errorMap: () => ({
-      message: `${attr.label} must be one of: ${validValues.join(", ")}`
-    })
+  return import_zod4.z.enum(validValues, {
+    error: `${attr.label} must be one of: ${validValues.join(", ")}`
   });
 }
 function createMultiselectValidator(attr) {
   const validValues = attr.options.map((opt) => opt.value);
-  return import_zod3.z.array(
-    import_zod3.z.enum(validValues, {
-      errorMap: () => ({
-        message: `Each value must be one of: ${validValues.join(", ")}`
-      })
+  return import_zod4.z.array(
+    import_zod4.z.enum(validValues, {
+      error: `Each value must be one of: ${validValues.join(", ")}`
     })
   );
 }
 function createLocationValidator(_attr) {
-  return import_zod3.z.object({
-    address: import_zod3.z.string().optional(),
-    address2: import_zod3.z.string().optional(),
-    city: import_zod3.z.string().optional(),
-    state: import_zod3.z.string().optional(),
-    postalCode: import_zod3.z.string().optional(),
-    country: import_zod3.z.string().length(3).optional(),
-    latitude: import_zod3.z.number().optional(),
-    longitude: import_zod3.z.number().optional()
+  return import_zod4.z.object({
+    address: import_zod4.z.string().optional(),
+    address2: import_zod4.z.string().optional(),
+    city: import_zod4.z.string().optional(),
+    state: import_zod4.z.string().optional(),
+    postalCode: import_zod4.z.string().optional(),
+    country: import_zod4.z.string().length(3).optional(),
+    latitude: import_zod4.z.number().optional(),
+    longitude: import_zod4.z.number().optional()
   });
 }
 function createTimestampValidator(_attr) {
-  return import_zod3.z.number().int().positive();
+  return import_zod4.z.number().int().positive();
 }
 function createFileValidator(_attr) {
-  return import_zod3.z.string().uuid();
+  return import_zod4.z.string().uuid();
 }
 function createUserValidator(_attr) {
-  return import_zod3.z.string().uuid();
+  return import_zod4.z.string().uuid();
 }
 function createSingleRelationValidator(attr) {
-  const uuidSchema = import_zod3.z.string().uuid({
+  const uuidSchema = import_zod4.z.string().uuid({
     message: `${attr.label} must be a valid record ID`
   });
-  return import_zod3.z.union([uuidSchema, import_zod3.z.null()]);
+  return import_zod4.z.union([uuidSchema, import_zod4.z.null()]);
 }
 function createMultiRelationValidator(attr) {
-  const uuidSchema = import_zod3.z.string().uuid({
+  const uuidSchema = import_zod4.z.string().uuid({
     message: `Each ${attr.label} item must be a valid record ID`
   });
-  let arraySchema = import_zod3.z.array(uuidSchema);
+  let arraySchema = import_zod4.z.array(uuidSchema);
   if (attr.minItems !== void 0) {
     arraySchema = arraySchema.min(
       attr.minItems,
@@ -2387,7 +2753,7 @@ function createRelationValidator(attr) {
   return createSingleRelationValidator(attr);
 }
 function createRatingValidator(attr) {
-  let schema = import_zod3.z.number().int().min(0);
+  let schema = import_zod4.z.number().int().min(0);
   if (attr.max !== void 0) {
     schema = schema.max(attr.max, `${attr.label} must be at most ${attr.max}`);
   }
@@ -2426,7 +2792,7 @@ function createAttributeValidator(attr) {
     case "rating":
       return createRatingValidator(attr);
     default:
-      return import_zod3.z.unknown();
+      return import_zod4.z.unknown();
   }
 }
 function createObjectValidator(objectDef) {
@@ -2438,7 +2804,7 @@ function createObjectValidator(objectDef) {
     }
     shape[attr.name] = validator;
   }
-  return import_zod3.z.object(shape);
+  return import_zod4.z.object(shape);
 }
 function validateAttribute(attr, value) {
   const validator = createAttributeValidator(attr);
@@ -2454,7 +2820,7 @@ function validateAttribute(attr, value) {
   }
   return {
     success: false,
-    errors: result.error.errors.map((err) => ({
+    errors: result.error.issues.map((err) => ({
       path: [attr.name, ...err.path.map(String)],
       message: err.message
     }))
@@ -2471,7 +2837,7 @@ function validateObject(objectDef, data) {
   }
   return {
     success: false,
-    errors: result.error.errors.map((err) => ({
+    errors: result.error.issues.map((err) => ({
       path: err.path.map(String),
       message: err.message
     }))
@@ -2492,7 +2858,7 @@ function createDraftValidator(objectDef) {
     const validator = createAttributeValidator(attr).optional();
     shape[attr.name] = validator;
   }
-  return import_zod3.z.object(shape);
+  return import_zod4.z.object(shape);
 }
 function validateDraft(objectDef, data) {
   const validator = createDraftValidator(objectDef);
@@ -2505,7 +2871,7 @@ function validateDraft(objectDef, data) {
   }
   return {
     success: false,
-    errors: result.error.errors.map((err) => ({
+    errors: result.error.issues.map((err) => ({
       path: err.path.map(String),
       message: err.message
     }))
@@ -3925,6 +4291,273 @@ var FileService = class {
   }
 };
 
+// src/runtime/services/flow.service.ts
+var FlowService = class {
+  constructor(adapter, systemFlows = []) {
+    this.adapter = adapter;
+    this.systemFlows = new Map(systemFlows.map((f) => [f.name, f]));
+  }
+  /**
+   * Get all flows for a tenant (system + custom)
+   */
+  async getAllFlows(tenantId) {
+    const systemFlowsList = Array.from(this.systemFlows.values());
+    if (!this.adapter.flows) {
+      return systemFlowsList;
+    }
+    const dbFlows = await this.adapter.flows.findAllForTenant(tenantId);
+    const customFlows = dbFlows.filter((f) => !f.system).map(this.convertDBFlowToDefinition);
+    return [...systemFlowsList, ...customFlows];
+  }
+  /**
+   * Get published flows only
+   */
+  async getPublishedFlows(tenantId) {
+    const allFlows = await this.getAllFlows(tenantId);
+    return allFlows.filter((f) => f.status === "published");
+  }
+  /**
+   * Get a specific flow by name
+   */
+  async getFlow(name, tenantId) {
+    const systemFlow = this.systemFlows.get(name);
+    if (systemFlow) {
+      return systemFlow;
+    }
+    if (!this.adapter.flows) {
+      return null;
+    }
+    const dbFlow = await this.adapter.flows.findByName(tenantId, name);
+    if (dbFlow) {
+      return this.convertDBFlowToDefinition(dbFlow);
+    }
+    return null;
+  }
+  /**
+   * Get a flow by ID
+   */
+  async getFlowById(flowId) {
+    if (!this.adapter.flows) {
+      return null;
+    }
+    const dbFlow = await this.adapter.flows.findById(flowId);
+    if (dbFlow) {
+      return this.convertDBFlowToDefinition(dbFlow);
+    }
+    return null;
+  }
+  /**
+   * Create a new custom flow (as draft)
+   */
+  async createFlow(input, tenantId) {
+    if (!this.adapter.flows) {
+      throw new Error("Flows feature is not enabled. Database adapter does not support flows.");
+    }
+    this.validateFlowName(input.name);
+    const existing = await this.adapter.flows.findByName(tenantId, input.name);
+    if (existing) {
+      throw new Error(`Flow "${input.name}" already exists`);
+    }
+    if (this.systemFlows.has(input.name)) {
+      throw new Error(
+        `Cannot create flow "${input.name}": a system flow with this name already exists`
+      );
+    }
+    this.validateFlowStructure(input);
+    const dbFlow = await this.adapter.flows.create({
+      tenantId,
+      name: input.name,
+      label: input.label,
+      description: input.description,
+      icon: input.icon,
+      status: "draft",
+      version: 1,
+      slots: input.slots,
+      pages: input.pages,
+      relations: input.relations,
+      system: false,
+      metadata: input.metadata
+    });
+    return this.convertDBFlowToDefinition(dbFlow);
+  }
+  /**
+   * Update a custom flow
+   */
+  async updateFlow(flowId, input) {
+    if (!this.adapter.flows) {
+      throw new Error("Flows feature is not enabled.");
+    }
+    const dbFlow = await this.adapter.flows.findById(flowId);
+    if (!dbFlow) {
+      throw new Error(`Flow with id "${flowId}" not found`);
+    }
+    if (dbFlow.system) {
+      throw new Error("Cannot modify system flows. System flows are protected.");
+    }
+    if (input.slots || input.pages || input.relations) {
+      this.validateFlowStructure({
+        name: dbFlow.name,
+        label: input.label ?? dbFlow.label,
+        slots: input.slots ?? dbFlow.slots,
+        pages: input.pages ?? dbFlow.pages,
+        relations: input.relations ?? dbFlow.relations
+      });
+    }
+    const updated = await this.adapter.flows.update(flowId, {
+      label: input.label,
+      description: input.description,
+      icon: input.icon,
+      slots: input.slots,
+      pages: input.pages,
+      relations: input.relations,
+      metadata: input.metadata
+    });
+    return this.convertDBFlowToDefinition(updated);
+  }
+  /**
+   * Publish a flow
+   */
+  async publishFlow(flowId) {
+    if (!this.adapter.flows) {
+      throw new Error("Flows feature is not enabled.");
+    }
+    const dbFlow = await this.adapter.flows.findById(flowId);
+    if (!dbFlow) {
+      throw new Error(`Flow with id "${flowId}" not found`);
+    }
+    if (dbFlow.system) {
+      throw new Error("Cannot publish system flows. They are always published.");
+    }
+    if (dbFlow.status === "published") {
+      return this.convertDBFlowToDefinition(dbFlow);
+    }
+    this.validateFlowStructure({
+      name: dbFlow.name,
+      label: dbFlow.label,
+      slots: dbFlow.slots,
+      pages: dbFlow.pages,
+      relations: dbFlow.relations
+    });
+    const updated = await this.adapter.flows.update(flowId, {
+      status: "published",
+      version: dbFlow.version + 1
+    });
+    return this.convertDBFlowToDefinition(updated);
+  }
+  /**
+   * Archive a flow
+   */
+  async archiveFlow(flowId) {
+    if (!this.adapter.flows) {
+      throw new Error("Flows feature is not enabled.");
+    }
+    const dbFlow = await this.adapter.flows.findById(flowId);
+    if (!dbFlow) {
+      throw new Error(`Flow with id "${flowId}" not found`);
+    }
+    if (dbFlow.system) {
+      throw new Error("Cannot archive system flows.");
+    }
+    const updated = await this.adapter.flows.update(flowId, {
+      status: "archived"
+    });
+    return this.convertDBFlowToDefinition(updated);
+  }
+  /**
+   * Delete a custom flow
+   */
+  async deleteFlow(flowId) {
+    if (!this.adapter.flows) {
+      throw new Error("Flows feature is not enabled.");
+    }
+    const dbFlow = await this.adapter.flows.findById(flowId);
+    if (!dbFlow) {
+      throw new Error(`Flow with id "${flowId}" not found`);
+    }
+    if (dbFlow.system) {
+      throw new Error("Cannot delete system flows. System flows are protected.");
+    }
+    await this.adapter.flows.delete(flowId);
+  }
+  // ============================================================================
+  // PRIVATE HELPERS
+  // ============================================================================
+  /**
+   * Validate flow name format (kebab-case)
+   */
+  validateFlowName(name) {
+    if (!name || name.length === 0) {
+      throw new Error("Flow name cannot be empty");
+    }
+    if (name.length > 63) {
+      throw new Error("Flow name is too long (max 63 characters)");
+    }
+    const kebabCaseRegex = /^[a-z][a-z0-9-]*$/;
+    if (!kebabCaseRegex.test(name)) {
+      throw new Error(
+        "Invalid flow name format. Name must be in kebab-case (e.g., 'couple-creation', 'new-contact')"
+      );
+    }
+  }
+  /**
+   * Validate flow structure (slots, pages, relations)
+   */
+  validateFlowStructure(input) {
+    if (!input.slots || input.slots.length === 0) {
+      throw new Error("Flow must have at least one slot");
+    }
+    if (!input.pages || input.pages.length === 0) {
+      throw new Error("Flow must have at least one page");
+    }
+    const slotIds = new Set(input.slots.map((s) => s.id));
+    if (slotIds.size !== input.slots.length) {
+      throw new Error("Duplicate slot IDs detected");
+    }
+    for (const page of input.pages) {
+      for (const row of page.rows) {
+        for (const field of row.fields) {
+          if (!slotIds.has(field.slotId)) {
+            throw new Error(`Field "${field.id}" references unknown slot "${field.slotId}"`);
+          }
+        }
+      }
+    }
+    for (const relation2 of input.relations) {
+      if (!slotIds.has(relation2.sourceSlotId)) {
+        throw new Error(`Relation references unknown source slot "${relation2.sourceSlotId}"`);
+      }
+      if (!slotIds.has(relation2.targetSlotId)) {
+        throw new Error(`Relation references unknown target slot "${relation2.targetSlotId}"`);
+      }
+      if (relation2.sourceSlotId === relation2.targetSlotId) {
+        throw new Error(`Relation cannot link a slot to itself: "${relation2.sourceSlotId}"`);
+      }
+    }
+  }
+  /**
+   * Convert database flow to FlowDefinition
+   */
+  convertDBFlowToDefinition(dbFlow) {
+    return {
+      id: dbFlow.id,
+      name: dbFlow.name,
+      label: dbFlow.label,
+      description: dbFlow.description,
+      icon: dbFlow.icon,
+      status: dbFlow.status,
+      version: dbFlow.version,
+      slots: dbFlow.slots,
+      pages: dbFlow.pages,
+      relations: dbFlow.relations,
+      system: dbFlow.system,
+      tenantId: dbFlow.tenantId,
+      metadata: dbFlow.metadata,
+      createdAt: dbFlow.createdAt,
+      updatedAt: dbFlow.updatedAt
+    };
+  }
+};
+
 // src/runtime/services/geocoding.service.ts
 var GeocodingService = class {
   constructor(adapter) {
@@ -6262,9 +6895,6 @@ var ViewService = class {
         `Cannot create view "${input.name}": a system view with this name already exists`
       );
     }
-    if (!input.tabs || input.tabs.length === 0) {
-      throw new Error("View must have at least one tab");
-    }
     const dbView = await this.adapter.views.create({
       tenantId,
       objectName: input.objectName,
@@ -6272,7 +6902,7 @@ var ViewService = class {
       label: input.label,
       description: input.description,
       icon: input.icon,
-      tabs: input.tabs,
+      tabs: input.tabs ?? [],
       default: input.default ?? false,
       system: false,
       // Custom views are never system
@@ -6295,9 +6925,6 @@ var ViewService = class {
     if (dbView.system) {
       throw new Error("Cannot modify system views. System views are protected.");
     }
-    if (input.tabs && input.tabs.length === 0) {
-      throw new Error("View must have at least one tab");
-    }
     const updated = await this.adapter.views.update(viewId, {
       label: input.label,
       description: input.description,
@@ -6725,6 +7352,10 @@ async function syncAll(adapter, objectRegistry, nativeViewRegistry, options = {}
   DuplicateError,
   FileNotFoundError,
   FileService,
+  FlowBuilder,
+  FlowPageBuilder,
+  FlowRowBuilder,
+  FlowService,
   ForbiddenError,
   GeocodingService,
   GlobalSearchService,
@@ -6792,6 +7423,7 @@ async function syncAll(adapter, objectRegistry, nativeViewRegistry, options = {}
   extractAttributeNames,
   file,
   fileConfigSchema,
+  flow,
   generateId,
   generatePrefixedId,
   getAttributeConfigSchema,
@@ -6802,6 +7434,8 @@ async function syncAll(adapter, objectRegistry, nativeViewRegistry, options = {}
   isAdvancedFilterState,
   isCustomTab,
   isDefaultRole,
+  isFlowDefinition,
+  isFlowPublished,
   isForbiddenError,
   isFormTab,
   isLabelExpression,
@@ -6810,6 +7444,7 @@ async function syncAll(adapter, objectRegistry, nativeViewRegistry, options = {}
   isProtectedResourceError,
   isRecordComplete,
   isSchemaError,
+  isSystemFlow,
   isTableTab,
   isValidationError,
   location,