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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { A as Attribute, S as StatusAttribute, a as SelectAttribute, M as MultiselectAttribute, P as Phone, C as Currency, L as Location, T as TextAttribute, b as TextAreaAttribute, N as NumberAttribute, c as CheckboxAttribute, D as DateAttribute, d as PhoneAttribute, e as CurrencyAttribute, O as Option, f as LocationAttribute, g as TimestampAttribute, F as FileAttribute, U as UserAttribute, h as SingleRelationAttribute, R as RelationOnDelete, i as MultiRelationAttribute, j as RelationTarget, k as RatingAttribute, l as ObjectDefinition, m as Field, n as AttributeGroupField, G as Group, V as ViewDefinition, o as Tab } from './runtime-yMql0npY.js';
-export { bS as AddAttributeInput, aa as AdvancedFilterState, bA as AttributeChange, r as AttributeGroup, p as AttributeType, bJ as AttributesRepository, B as BaseAttribute, Y as CheckboxFilterOperator, at as CompletionStatus, bR as CreateCustomObjectInput, cm as CreateDBAttribute, ci as CreateDBObject, cw as CreateDBView, K as CreateFile, cp as CreateObjectRecord, ay as CreateUserProfile, c2 as CreateViewInput, a3 as CurrencyFilterValue, aD as CustomTab, cl as DBAttribute, ch as DBObject, cv as DBView, cd as DEFAULT_LABEL_FALLBACK, bz as DatabaseAdapter, Z as DateFilterOperator, t as DateFormat, u as DateValue, x as DocumentFace, w as DocumentType, y as DocumentTypeConfig, J as File, cu as FileListOptions, bO as FileService, z as FileVerificationConfig, I as FileVisibility, bL as FilesRepository, a7 as FilterCombinator, a9 as FilterGroup, a1 as FilterOperator, a6 as FilterRule, a8 as FilterState, a5 as FilterValue, aB as FormTab, cb as FullSyncOptions, ca as FullSyncResult, ap as GeocodingAdapter, am as GeocodingAutocompleteParams, ao as GeocodingParams, bP as GeocodingService, al as GeocodingSuggestion, b$ as GetRelationOptionsParams, cs as GlobalSearchOptions, ct as GlobalSearchResultItem, bQ as GlobalSearchService, bB as HookContext, bC as HookDefinition, bD as HookHandler, bG as HookRegistry, bE as HookType, cq as ListOptions, v as LocationGranularity, $ as MultiselectFilterOperator, aj as NO_VALUE_OPERATORS, ai as NoValueOperator, aq as NoopGeocodingAdapter, bF as NoopHookRegistry, X as NumberFilterOperator, s as NumberUnit, ah as OPERATORS_BY_TYPE, as as ObjectAttribute, au as ObjectRecord, bM as ObjectRecordsRepository, bU as ObjectSchemaService, bI as ObjectsRepository, cz as OperationResult, a4 as PhoneFilterValue, ag as QueryState, bW as RecordService, bV as RecordServiceOptions, E as RelationAttribute, a0 as RelationFilterOperator, bZ as RelationOption, b_ as RelationOptionsResponse, c0 as RelationService, bY as RelationValidationError, bX as RelationValidationResult, a2 as RelativeDateValue, an as ReverseGeocodingParams, cr as SearchOptions, _ as SelectFilterOperator, ae as SortDirection, af as SortRule, q as StatusGroup, H as StorageProvider, c6 as SyncOptions, c5 as SyncResult, aA as TabType, aC as TableTab, aI as TenantId, W as TextFilterOperator, ar as Timestamps, cn as UpdateDBAttribute, cj as UpdateDBObject, cx as UpdateDBView, Q as UpdateFile, bT as UpdateObjectInput, az as UpdateUserProfile, c3 as UpdateViewInput, co as UpsertDBAttribute, ck as UpsertDBObject, cy as UpsertDBView, ax as UserProfile, c1 as UserProfileService, bK as UserProfilesRepository, av as UserRole, aw as UserStatus, aH as Uuid, bp as ValidationResult, c4 as ViewService, cB as ViewSyncOptions, cA as ViewSyncResult, bN as ViewsRepository, b1 as attributeConfigSchemas, aQ as checkboxConfigSchema, by as computeRecordStatus, bn as createAttributeValidator, b8 as createCheckboxValidator, bb as createCurrencyValidator, b9 as createDateValidator, bt as createDraftValidator, bh as createFileValidator, bf as createLocationValidator, bH as createMockAdapter, bk as createMultiRelationValidator, be as createMultiselectValidator, b7 as createNumberValidator, bo as createObjectValidator, ba as createPhoneValidator, bm as createRatingValidator, bl as createRelationValidator, bd as createSelectValidator, bj as createSingleRelationValidator, bc as createStatusValidator, b6 as createTextValidator, bg as createTimestampValidator, bi as createUserValidator, aT as currencyConfigSchema, aR as dateConfigSchema, cg as extractAttributeNames, aZ as fileConfigSchema, aJ as generateId, aK as generatePrefixedId, b2 as getAttributeConfigSchema, bw as getMissingRequiredAttributes, c9 as getSyncPreview, cE as getViewSyncPreview, ab as isAdvancedFilterState, aG as isCustomTab, aE as isFormTab, cf as isLabelExpression, ak as isNoValueOperator, bx as isRecordComplete, aF as isTableTab, aV as locationConfigSchema, aY as multiselectConfigSchema, aP as numberConfigSchema, b4 as parseAttributeConfig, aS as phoneConfigSchema, b0 as ratingConfigSchema, aL as registry, a$ as relationConfigSchema, ce as renderLabelExpression, b5 as safeParseAttributeConfig, aX as selectConfigSchema, aU as statusConfigSchema, cc as syncAll, c7 as syncNativeObjects, cC as syncNativeViews, aN as textConfigSchema, aO as textareaConfigSchema, aW as timestampConfigSchema, ac as toAdvancedFilterState, ad as toSimpleFilterState, a_ as userConfigSchema, bq as validateAttribute, b3 as validateAttributeConfig, bu as validateDraft, bv as validateDraftOrThrow, br as validateObject, bs as validateObjectOrThrow, c8 as verifyNativeObjectsSync, cD as verifyNativeViewsSync, aM as viewRegistry } from './runtime-yMql0npY.js';
-import { IconName, CountryIso3, CurrencyCode, MimeType } from '@stndrds/constants';
+import { A as Attribute, S as StatusAttribute, a as SelectAttribute, M as MultiselectAttribute, P as Phone, C as Currency, L as Location, b as SystemResource, c as SystemAction, O as ObjectAction, T as TextAttribute, d as TextAreaAttribute, N as NumberAttribute, e as CheckboxAttribute, D as DateAttribute, f as PhoneAttribute, g as CurrencyAttribute, h as Option, i as LocationAttribute, j as TimestampAttribute, F as FileAttribute, U as UserAttribute, k as SingleRelationAttribute, l as MultiRelationAttribute, R as RelationTarget, m as RatingAttribute, n as FlowDefinition, o as FlowPage, p as FlowRow, q as ObjectDefinition, r as Field, s as AttributeGroupField, G as Group, V as ViewDefinition, t as Tab } from './runtime-DlCiIIfr.js';
+export { ct as AddAttributeInput, an as AdvancedFilterState, aZ as AssignRoleInput, c3 as AttributeChange, w as AttributeGroup, u as AttributeType, cc as AttributesRepository, X as AuditAction, Y as AuditActorType, Z as AuditChange, a0 as AuditListOptions, _ as AuditLogEntry, ci as AuditRepository, W as AuditResourceType, cl as AuditService, a1 as AuditServiceOptions, B as BaseAttribute, a9 as CheckboxFilterOperator, aN as CompletionStatus, $ as CreateAuditLogInput, cs as CreateCustomObjectInput, d1 as CreateDBAttribute, df as CreateDBFlow, cZ as CreateDBObject, db as CreateDBView, a5 as CreateFile, cn as CreateFlowInput, d4 as CreateObjectRecord, aY as CreatePermissionInput, aW as CreateRoleInput, b1 as CreateUserProfile, cJ as CreateViewInput, ag as CurrencyFilterValue, b6 as CustomTab, d0 as DBAttribute, de as DBFlow, cY as DBObject, da as DBView, cU as DEFAULT_LABEL_FALLBACK, c2 as DatabaseAdapter, aa as DateFilterOperator, y as DateFormat, z as DateValue, I as DocumentFace, H as DocumentType, J as DocumentTypeConfig, aT as EffectivePermissions, a4 as File, d9 as FileListOptions, cm as FileService, K as FileVerificationConfig, a3 as FileVisibility, ce as FilesRepository, ak as FilterCombinator, am as FilterGroup, ae as FilterOperator, aj as FilterRule, al as FilterState, ai as FilterValue, aA as FlowRelation, az as FlowRowField, cp as FlowService, ay as FlowSlot, aB as FlowStatus, ch as FlowsRepository, b4 as FormTab, cS as FullSyncOptions, cR as FullSyncResult, aJ as GeocodingAdapter, aG as GeocodingAutocompleteParams, aI as GeocodingParams, cq as GeocodingService, aF as GeocodingSuggestion, cF as GetRelationOptionsParams, d7 as GlobalSearchOptions, d8 as GlobalSearchResultItem, cr as GlobalSearchService, c4 as HookContext, c5 as HookDefinition, c6 as HookHandler, c9 as HookRegistry, c7 as HookType, d5 as ListOptions, E as LocationGranularity, ac as MultiselectFilterOperator, aw as NO_VALUE_OPERATORS, av as NoValueOperator, aK as NoopGeocodingAdapter, c8 as NoopHookRegistry, a8 as NumberFilterOperator, x as NumberUnit, au as OPERATORS_BY_TYPE, aM as ObjectAttribute, aU as ObjectPermissions, aO as ObjectRecord, cf as ObjectRecordsRepository, cw as ObjectSchemaService, cv as ObjectSchemaServiceOptions, cb as ObjectsRepository, dh as OperationResult, aR as Permission, aP as PermissionScope, cy as PermissionService, cx as PermissionServiceOptions, cj as PermissionsRepository, ah as PhoneFilterValue, at as QueryState, cA as RecordService, cz as RecordServiceOptions, Q as RelationAttribute, ad as RelationFilterOperator, cD as RelationOption, cE as RelationOptionsResponse, cG as RelationService, cC as RelationValidationError, cB as RelationValidationResult, af as RelativeDateValue, aH as ReverseGeocodingParams, aQ as Role, d6 as SearchOptions, ab as SelectFilterOperator, ar as SortDirection, as as SortRule, v as StatusGroup, a2 as StorageProvider, cN as SyncOptions, cM as SyncResult, aV as SystemPermissions, b3 as TabType, b5 as TableTab, bb as TenantId, a7 as TextFilterOperator, aL as Timestamps, d2 as UpdateDBAttribute, dg as UpdateDBFlow, c_ as UpdateDBObject, dc as UpdateDBView, a6 as UpdateFile, co as UpdateFlowInput, cu as UpdateObjectInput, aX as UpdateRoleInput, b2 as UpdateUserProfile, cK as UpdateViewInput, d3 as UpsertDBAttribute, c$ as UpsertDBObject, dd as UpsertDBView, b0 as UserProfile, cI as UserProfileService, cH as UserProfileServiceOptions, cd as UserProfilesRepository, a_ as UserRole, aS as UserRoleAssignment, a$ as UserStatus, ba as Uuid, bU as ValidationResult, cL as ViewService, dj as ViewSyncOptions, di as ViewSyncResult, cg as ViewsRepository, bw as attributeConfigSchemas, ck as buildAuditChanges, bj as checkboxConfigSchema, c1 as computeRecordStatus, bS as createAttributeValidator, bD as createCheckboxValidator, bG as createCurrencyValidator, bE as createDateValidator, bY as createDraftValidator, bM as createFileValidator, bK as createLocationValidator, ca as createMockAdapter, bP as createMultiRelationValidator, bJ as createMultiselectValidator, bC as createNumberValidator, bT as createObjectValidator, bF as createPhoneValidator, bR as createRatingValidator, bQ as createRelationValidator, bI as createSelectValidator, bO as createSingleRelationValidator, bH as createStatusValidator, bB as createTextValidator, bL as createTimestampValidator, bN as createUserValidator, bm as currencyConfigSchema, bk as dateConfigSchema, cX as extractAttributeNames, bs as fileConfigSchema, bc as generateId, bd as generatePrefixedId, bx as getAttributeConfigSchema, b$ as getMissingRequiredAttributes, cQ as getSyncPreview, dm as getViewSyncPreview, ao as isAdvancedFilterState, b9 as isCustomTab, aC as isFlowDefinition, aD as isFlowPublished, b7 as isFormTab, cW as isLabelExpression, ax as isNoValueOperator, c0 as isRecordComplete, aE as isSystemFlow, b8 as isTableTab, bo as locationConfigSchema, br as multiselectConfigSchema, bi as numberConfigSchema, bz as parseAttributeConfig, bl as phoneConfigSchema, bv as ratingConfigSchema, be as registry, bu as relationConfigSchema, cV as renderLabelExpression, bA as safeParseAttributeConfig, bq as selectConfigSchema, bn as statusConfigSchema, cT as syncAll, cO as syncNativeObjects, dk as syncNativeViews, bg as textConfigSchema, bh as textareaConfigSchema, bp as timestampConfigSchema, ap as toAdvancedFilterState, aq as toSimpleFilterState, bt as userConfigSchema, bV as validateAttribute, by as validateAttributeConfig, bZ as validateDraft, b_ as validateDraftOrThrow, bW as validateObject, bX as validateObjectOrThrow, cP as verifyNativeObjectsSync, dl as verifyNativeViewsSync, bf as viewRegistry } from './runtime-DlCiIIfr.js';
+import { IconName, CountryIso3, CurrencyCode, MimeType, ColorId } from '@stndrds/constants';
 import 'zod';
 
 /**
@@ -19,6 +19,94 @@ interface BuilderConfig {
     label: string;
 }
 
+/**
+ * Reference information for a record that is blocking deletion.
+ */
+interface RecordReference {
+    /** Technical name of the object (e.g., "contacts") */
+    objectName: string;
+    /** Display label of the object (e.g., "Contacts") */
+    objectLabel: string;
+    /** Number of records referencing the target */
+    count: number;
+}
+/**
+ * Thrown when attempting to delete a record that is referenced by other records.
+ *
+ * This implements the "Restrict" behavior: deletion is blocked and the user
+ * must first remove or update the referencing records.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await recordService.deleteRecord(companyId);
+ * } catch (error) {
+ *   if (error instanceof RecordReferencedError) {
+ *     console.log(`Cannot delete: referenced by ${error.references.length} objects`);
+ *     // Show UI with details: error.references
+ *   }
+ * }
+ * ```
+ */
+declare class RecordReferencedError extends Error {
+    readonly recordId: string;
+    readonly references: RecordReference[];
+    readonly code: "RECORD_REFERENCED";
+    constructor(recordId: string, references: RecordReference[]);
+}
+/**
+ * Usage context where an attribute is being used.
+ */
+type AttributeUsage = "labelExpression" | "view" | "filter";
+/**
+ * Thrown when attempting to delete an attribute that is in use.
+ *
+ * Attributes cannot be deleted if they are referenced in:
+ * - The object's labelExpression template
+ * - A saved view's column configuration
+ * - A saved filter condition
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await schemaService.deleteAttribute(attributeId);
+ * } catch (error) {
+ *   if (error instanceof AttributeInUseError) {
+ *     console.log(`Cannot delete "${error.attributeName}": used in ${error.usage}`);
+ *   }
+ * }
+ * ```
+ */
+declare class AttributeInUseError extends Error {
+    readonly attributeName: string;
+    readonly usage: AttributeUsage;
+    readonly code: "ATTRIBUTE_IN_USE";
+    constructor(attributeName: string, usage: AttributeUsage);
+}
+/**
+ * Thrown when attempting to delete an object that is a relation target.
+ *
+ * Objects cannot be deleted if other objects have relation attributes
+ * pointing to them as a target.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await schemaService.deleteObject(objectId);
+ * } catch (error) {
+ *   if (error instanceof ObjectReferencedError) {
+ *     console.log(`Cannot delete "${error.objectName}": target of ${error.referencingObjects.join(", ")}`);
+ *   }
+ * }
+ * ```
+ */
+declare class ObjectReferencedError extends Error {
+    readonly objectName: string;
+    readonly referencingObjects: string[];
+    readonly code: "OBJECT_REFERENCED";
+    constructor(objectName: string, referencingObjects: string[]);
+}
+
 /**
  * Lookup table for primitive attribute types
  * Maps attribute type name to its runtime value type
@@ -212,6 +300,78 @@ type ExtractAttributes<TBuilder> = TBuilder extends {
     };
 } ? A : never;
 
+/**
+ * System resources that can be managed through permissions.
+ */
+declare const SYSTEM_RESOURCES: {
+    /** User profiles and invitations management */
+    readonly USERS: "users";
+    /** Object definitions and attributes management */
+    readonly SCHEMA: "schema";
+    /** Roles and permissions management */
+    readonly ROLES: "roles";
+    /** Tenant settings and configuration */
+    readonly SETTINGS: "settings";
+    /** Audit logs and activity trail */
+    readonly AUDIT: "audit";
+};
+/**
+ * All system resources as an array (for iteration)
+ */
+declare const ALL_SYSTEM_RESOURCES: SystemResource[];
+/**
+ * Human-readable labels for system resources
+ */
+declare const SYSTEM_RESOURCE_LABELS: Record<SystemResource, string>;
+/**
+ * Default role names that are created for every tenant.
+ */
+declare const DEFAULT_ROLES: {
+    /** Full platform access - can manage everything */
+    readonly ADMIN: "admin";
+    /** Standard user - can work with business data but not platform settings */
+    readonly MEMBER: "member";
+    /** Read-only access - can view but not modify */
+    readonly GUEST: "guest";
+};
+type DefaultRoleName = (typeof DEFAULT_ROLES)[keyof typeof DEFAULT_ROLES];
+/**
+ * Human-readable labels for default roles
+ */
+declare const DEFAULT_ROLE_LABELS: Record<DefaultRoleName, string>;
+/**
+ * Descriptions for default roles
+ */
+declare const DEFAULT_ROLE_DESCRIPTIONS: Record<DefaultRoleName, string>;
+/**
+ * Default permission configuration for each role.
+ * Used when initializing a new tenant.
+ */
+interface DefaultRolePermissionConfig {
+    /** System resource permissions (users, schema, roles, settings) */
+    system: Array<{
+        target: SystemResource | "*";
+        actions: SystemAction[];
+    }>;
+    /** Object permissions (business data) */
+    object: Array<{
+        target: string;
+        actions: ObjectAction[];
+    }>;
+}
+/**
+ * Default permissions for each built-in role.
+ *
+ * - **admin**: Full access to everything (system + objects)
+ * - **member**: No system access, full CRUD on objects (except delete)
+ * - **guest**: No system access, read-only on objects
+ */
+declare const DEFAULT_ROLE_PERMISSIONS: Record<DefaultRoleName, DefaultRolePermissionConfig>;
+/**
+ * Check if a role name is a default/built-in role
+ */
+declare function isDefaultRole(roleName: string): roleName is DefaultRoleName;
+
 /**
  * Error codes for schema exceptions
  */
@@ -222,11 +382,14 @@ declare const SchemaErrorCode: {
     readonly RECORD_NOT_FOUND: "SCHEMA_RECORD_NOT_FOUND";
     readonly USER_PROFILE_NOT_FOUND: "SCHEMA_USER_PROFILE_NOT_FOUND";
     readonly FILE_NOT_FOUND: "SCHEMA_FILE_NOT_FOUND";
+    readonly ROLE_NOT_FOUND: "SCHEMA_ROLE_NOT_FOUND";
     readonly VALIDATION_FAILED: "SCHEMA_VALIDATION_FAILED";
     readonly INVALID_ATTRIBUTE_NAME: "SCHEMA_INVALID_ATTRIBUTE_NAME";
     readonly INVALID_OBJECT_NAME: "SCHEMA_INVALID_OBJECT_NAME";
     readonly PROTECTED_OBJECT: "SCHEMA_PROTECTED_OBJECT";
     readonly PROTECTED_ATTRIBUTE: "SCHEMA_PROTECTED_ATTRIBUTE";
+    readonly PROTECTED_ROLE: "SCHEMA_PROTECTED_ROLE";
+    readonly FORBIDDEN: "SCHEMA_FORBIDDEN";
     readonly SYNC_FAILED: "SCHEMA_SYNC_FAILED";
     readonly NOT_SYSTEM_OBJECT: "SCHEMA_NOT_SYSTEM_OBJECT";
     readonly DUPLICATE_OBJECT: "SCHEMA_DUPLICATE_OBJECT";
@@ -355,6 +518,33 @@ declare function isValidationError(error: unknown): error is ValidationError;
  * Check if an error is a ProtectedResourceError
  */
 declare function isProtectedResourceError(error: unknown): error is ProtectedResourceError;
+/**
+ * Error thrown when a user lacks permission to perform an action
+ */
+declare class ForbiddenError extends SchemaError {
+    readonly objectName: string;
+    readonly action: string;
+    readonly userId?: string;
+    constructor(objectName: string, action: string, userId?: string);
+}
+/**
+ * Error thrown when trying to modify a protected role
+ */
+declare class ProtectedRoleError extends SchemaError {
+    readonly roleName: string;
+    readonly operation: "delete" | "modify";
+    constructor(roleName: string, operation: "delete" | "modify");
+}
+/**
+ * Role not found error
+ */
+declare class RoleNotFoundError extends NotFoundError {
+    constructor(roleId: string);
+}
+/**
+ * Check if an error is a ForbiddenError
+ */
+declare function isForbiddenError(error: unknown): error is ForbiddenError;
 
 /**
  * Builder config with literal name type preservation
@@ -614,7 +804,6 @@ interface RelationTargetOptions {
  */
 interface RelationBuilderInitOptions {
     targets?: RelationTarget[];
-    onDelete?: RelationOnDelete;
     isRequired?: boolean;
 }
 /**
@@ -633,11 +822,6 @@ declare class SingleRelationAttributeBuilder<TName extends string, TRequired ext
      * @param options - Display template and filter options
      */
     to(objectName: string, options?: RelationTargetOptions): this;
-    /**
-     * Set the deletion strategy when target record is deleted
-     * @param strategy - "restrict" (default), "cascade", or "set_null"
-     */
-    onDelete(strategy: RelationOnDelete): this;
     /**
      * Convert to a multi-relation (cardinality: "many")
      */
@@ -661,11 +845,6 @@ declare class MultiRelationAttributeBuilder<TName extends string, TRequired exte
      * @param options - Display template and filter options
      */
     to(objectName: string, options?: RelationTargetOptions): this;
-    /**
-     * Set the deletion strategy when target record is deleted
-     * @param strategy - "restrict" (default), "cascade", or "set_null"
-     */
-    onDelete(strategy: RelationOnDelete): this;
     /**
      * Set minimum number of relations required
      */
@@ -701,7 +880,6 @@ declare class MultiRelationAttributeBuilder<TName extends string, TRequired exte
  *   .to("companies")
  *   .to("contacts")
  *   .many()
- *   .onDelete("cascade")
  * ```
  */
 declare function relation<TName extends string>(config: TypedBuilderConfig<TName>): SingleRelationAttributeBuilder<TName, false>;
@@ -739,6 +917,231 @@ type ExtractAttributeRequired<T> = T extends {
     };
 } ? R : false;
 
+/**
+ * Builder for creating flow rows with fields
+ */
+declare class FlowRowBuilder {
+    private pageBuilder;
+    private rowData;
+    /** @internal */
+    constructor(pageBuilder: FlowPageBuilder, id: string, order: number);
+    /**
+     * 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: string, attribute: string, options?: {
+        label?: string;
+        required?: boolean;
+    }): this;
+    /**
+     * Start a new row on the same page
+     */
+    row(id: string): FlowRowBuilder;
+    /**
+     * Start a new page
+     */
+    page(id: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build the final flow definition
+     */
+    build(): FlowDefinition;
+}
+/**
+ * Builder for creating flow pages with rows
+ */
+declare class FlowPageBuilder {
+    private flow;
+    private pageData;
+    private rowOrder;
+    /** @internal */
+    constructor(flow: FlowBuilder, id: string, label: string, description?: string);
+    /**
+     * 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: string): FlowRowBuilder;
+    /**
+     * Start a new page
+     */
+    page(id: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build the final flow definition
+     */
+    build(): FlowDefinition;
+    /** @internal */
+    _finalizeRow(row: FlowRow): this;
+    /** @internal */
+    _getFlow(): FlowBuilder;
+    /** @internal */
+    _getPageData(): FlowPage;
+}
+/**
+ * Fluent builder for creating FlowDefinition with validation
+ *
+ * @example
+ * ```typescript
+ * const COUPLE_FLOW = flow("couple-creation", "Création Couple")
+ *   .description("Create a couple with company")
+ *   .slot("mr", "contacts", "Monsieur", { color: "blue" })
+ *   .slot("mme", "contacts", "Madame", { color: "pink" })
+ *   .slot("company", "companies", "Entreprise", { color: "green" })
+ *   .relation("mr", "company", "company")
+ *   .relation("mme", "company", "company")
+ *   .page("identity", "Identité")
+ *     .row("mr-name")
+ *       .field("mr", "firstName")
+ *       .field("mr", "lastName")
+ *     .row("mme-name")
+ *       .field("mme", "firstName")
+ *       .field("mme", "lastName")
+ *   .page("company", "Entreprise")
+ *     .row("company-name")
+ *       .field("company", "name")
+ *     .row("company-siret")
+ *       .field("company", "siret")
+ *   .build();
+ * ```
+ */
+declare class FlowBuilder {
+    private data;
+    constructor(name: string, label: string);
+    /**
+     * Set flow description
+     */
+    description(value: string): this;
+    /**
+     * Set flow icon
+     */
+    icon(value: IconName): this;
+    /**
+     * Set extensible metadata
+     */
+    metadata(value: Record<string, unknown>): 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: string, objectName: string, label: string, options?: {
+        color?: ColorId;
+        icon?: IconName;
+    }): 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: string, sourceAttribute: string, targetSlotId: string): 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: string, label: string, description?: string): FlowPageBuilder;
+    /**
+     * Build and validate the flow definition
+     *
+     * @throws Error if validation fails
+     */
+    build(): FlowDefinition;
+    /**
+     * Validate that required data is present
+     */
+    private validateRequiredData;
+    /**
+     * Validate that all field slotId references exist
+     */
+    private validateFieldReferences;
+    /**
+     * Validate that all relation references exist and are valid
+     */
+    private validateRelationReferences;
+    /**
+     * @internal Used by FlowPageBuilder to finalize a page
+     */
+    _finalizePage(page: FlowPage): this;
+    /**
+     * Validate flow name format (kebab-case)
+     */
+    private validateName;
+    /**
+     * Validate that there are no circular dependencies in relations
+     * Uses DFS to detect cycles in the dependency graph
+     */
+    private validateNoCircularDependencies;
+}
+/**
+ * Create a new flow builder
+ *
+ * @param name - Flow name (kebab-case)
+ * @param label - Display label
+ *
+ * @example
+ * ```typescript
+ * const COUPLE_FLOW = flow("couple-creation", "Création Couple")
+ *   .slot("mr", "contacts", "Monsieur")
+ *   .slot("mme", "contacts", "Madame")
+ *   .page("identity", "Identité")
+ *     .row("mr-name")
+ *       .field("mr", "firstName")
+ *       .field("mr", "lastName")
+ *     .row("mme-name")
+ *       .field("mme", "firstName")
+ *       .field("mme", "lastName")
+ *   .build();
+ * ```
+ */
+declare function flow(name: string, label: string): FlowBuilder;
+
 /**
  * Extract attribute info from a builder instance
  */
@@ -1219,4 +1622,4 @@ declare function view(name: string, label: string): ViewBuilder;
  */
 declare function group(id: string, label: string): GroupBuilder;
 
-export { type AddAttribute$1 as AddAttribute, type AnyAttributeBuilder, Attribute, AttributeGroupField, type AttributeMap, AttributeNotFoundError, type AttributeSchema, type BuilderConfig, CheckboxAttribute, Currency, CurrencyAttribute, type CustomAttributeValue, CustomTabConfig, DateAttribute, DuplicateError, type ExtractAttributeName, type ExtractAttributeRequired, type ExtractAttributes, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, Field, FileAttribute, FileNotFoundError, Group, GroupBuilder, type InferAttributeValue, type InferRecord, type InferRecordFromSchema, type InferRecordInput, type InferRecordUpdate, type InferRecordWithRequirements, Location, LocationAttribute, MultiRelationAttribute, MultiselectAttribute, NotFoundError, NotSystemObjectError, NumberAttribute, ObjectBuilder, ObjectDefinition, ObjectNotFoundError, Option, Phone, PhoneAttribute, ProtectedResourceError, RatingAttribute, RecordNotFoundError, RelationOnDelete, RelationTarget, SchemaError, SchemaErrorCode, SelectAttribute, SingleRelationAttribute, StatusAttribute, SyncError, Tab, TabBuilder, TableTabConfig, TextAreaAttribute, TextAttribute, TimestampAttribute, type TypedAttribute, type TypedBuilderConfig, UserAttribute, UserProfileNotFoundError, ValidationError, type ValidationErrorDetail, ViewBuilder, ViewDefinition, type WithCustomAttributes, checkbox, currency, date, file, group, isNotFoundError, isProtectedResourceError, isSchemaError, isValidationError, location, multiselect, number, object, phone, rating, relation, select, status, text, textarea, timestamp, user, view };
+export { ALL_SYSTEM_RESOURCES, type AddAttribute$1 as AddAttribute, type AnyAttributeBuilder, Attribute, AttributeGroupField, AttributeInUseError, type AttributeMap, AttributeNotFoundError, type AttributeSchema, type AttributeUsage, type BuilderConfig, CheckboxAttribute, Currency, CurrencyAttribute, type CustomAttributeValue, CustomTabConfig, DEFAULT_ROLES, DEFAULT_ROLE_DESCRIPTIONS, DEFAULT_ROLE_LABELS, DEFAULT_ROLE_PERMISSIONS, DateAttribute, type DefaultRoleName, type DefaultRolePermissionConfig, DuplicateError, type ExtractAttributeName, type ExtractAttributeRequired, type ExtractAttributes, type ExtractRecord, type ExtractRecordInput, type ExtractRecordInputStrict, type ExtractRecordStrict, type ExtractRecordUpdate, type ExtractRecordUpdateStrict, Field, FileAttribute, FileNotFoundError, FlowBuilder, FlowDefinition, FlowPage, FlowPageBuilder, FlowRow, FlowRowBuilder, ForbiddenError, Group, GroupBuilder, type InferAttributeValue, type InferRecord, type InferRecordFromSchema, type InferRecordInput, type InferRecordUpdate, type InferRecordWithRequirements, Location, LocationAttribute, MultiRelationAttribute, MultiselectAttribute, NotFoundError, NotSystemObjectError, NumberAttribute, ObjectAction, ObjectBuilder, ObjectDefinition, ObjectNotFoundError, ObjectReferencedError, Option, Phone, PhoneAttribute, ProtectedResourceError, ProtectedRoleError, RatingAttribute, RecordNotFoundError, type RecordReference, RecordReferencedError, RelationTarget, RoleNotFoundError, SYSTEM_RESOURCES, SYSTEM_RESOURCE_LABELS, SchemaError, SchemaErrorCode, SelectAttribute, SingleRelationAttribute, StatusAttribute, SyncError, SystemAction, SystemResource, Tab, TabBuilder, TableTabConfig, TextAreaAttribute, TextAttribute, TimestampAttribute, type TypedAttribute, type TypedBuilderConfig, UserAttribute, UserProfileNotFoundError, ValidationError, type ValidationErrorDetail, ViewBuilder, ViewDefinition, type WithCustomAttributes, checkbox, currency, date, file, flow, group, isDefaultRole, isForbiddenError, isNotFoundError, isProtectedResourceError, isSchemaError, isValidationError, location, multiselect, number, object, phone, rating, relation, select, status, text, textarea, timestamp, user, view };