skedyul 0.1.38 → 0.1.40

package/dist/.build-stamp

@@ -1 +1 @@
-1768437850820
+1768537680901

package/dist/config.d.ts

@@ -127,12 +127,27 @@ export interface ChannelToolBindings {
 }
 /** Scope of a model: INTERNAL (app-owned) or SHARED (user-mapped) */
 export type ResourceScope = 'INTERNAL' | 'SHARED';
+/**
+ * Field-level data ownership.
+ * APP: App exclusively controls this data (e.g., status field set by webhook)
+ * WORKPLACE: User/organization provides this data (e.g., file upload)
+ * BOTH: Collaborative - either can update
+ */
+export type FieldOwner = 'APP' | 'WORKPLACE' | 'BOTH';
+/**
+ * StructuredFilter for conditional dependencies.
+ * Format: { fieldHandle: { operator: value | value[] } }
+ * Operators: eq, neq, gt, gte, lt, lte, contains, etc.
+ */
+export type StructuredFilter = Record<string, Record<string, string | number | boolean | (string | number | boolean)[]>>;
 /** Model dependency reference */
 export interface ModelDependency {
     /** Handle of the model being depended upon */
     model: string;
     /** Specific fields required (undefined = all fields) */
     fields?: string[];
+    /** Conditions the dependency instance must satisfy (StructuredFilter format) */
+    where?: StructuredFilter;
 }
 /** Channel dependency reference */
 export interface ChannelDependency {
@@ -146,6 +161,37 @@ export interface WorkflowDependency {
 }
 /** Union of all resource dependency types */
 export type ResourceDependency = ModelDependency | ChannelDependency | WorkflowDependency;
+/** Option for choice/enum fields */
+export interface FieldOption {
+    /** Display label */
+    label: string;
+    /** Value stored in database */
+    value: string;
+    /** Optional color for UI display */
+    color?: string;
+}
+/**
+ * Inline field definition (constraints, options, etc.)
+ * Allows defining field behavior without referencing a metafield definition.
+ */
+export interface InlineFieldDefinition {
+    /** For choice fields: number of selections allowed (1 = single select, >1 = multi) */
+    limitChoices?: number;
+    /** For choice fields: available options */
+    options?: FieldOption[];
+    /** For string fields: min length */
+    minLength?: number;
+    /** For string fields: max length */
+    maxLength?: number;
+    /** For number fields: min value */
+    min?: number;
+    /** For number fields: max value */
+    max?: number;
+    /** For relation fields: target model handle */
+    relatedModel?: string;
+    /** Validation regex pattern */
+    pattern?: string;
+}
 /** Field definition for unified models (works for INTERNAL and SHARED) */
 export interface ModelFieldDefinition {
     /** Field handle (unique within model) */
@@ -154,8 +200,10 @@ export interface ModelFieldDefinition {
     label: string;
     /** Data type (required for INTERNAL, optional for SHARED) */
     type?: InternalFieldDataType;
-    /** Field definition handle for SHARED fields */
+    /** Field definition handle for SHARED fields (references a metafield definition) */
     definitionHandle?: string;
+    /** Inline field definition (alternative to definitionHandle for INTERNAL fields) */
+    definition?: InlineFieldDefinition;
     /** Whether field is required */
     required?: boolean;
     /** Whether field must be unique */
@@ -172,6 +220,8 @@ export interface ModelFieldDefinition {
     description?: string;
     /** Visibility settings (for SHARED fields) */
     visibility?: AppFieldVisibility;
+    /** Data ownership: APP (app controls), WORKPLACE (user provides), BOTH (collaborative) */
+    owner?: FieldOwner;
 }
 /** Unified model definition (supports both INTERNAL and SHARED) */
 export interface ModelDefinition {
@@ -189,6 +239,32 @@ export interface ModelDefinition {
     description?: string;
     /** Field definitions */
     fields: ModelFieldDefinition[];
+    /** Model-level dependencies - other models this model requires to be provisioned */
+    requires?: ResourceDependency[];
+}
+/** Relationship cardinality */
+export type RelationshipCardinality = 'ONE_TO_ONE' | 'ONE_TO_MANY' | 'MANY_TO_ONE' | 'MANY_TO_MANY';
+/** On-delete behavior for relationships */
+export type OnDeleteBehavior = 'NONE' | 'CASCADE' | 'RESTRICT';
+/** One side of a relationship */
+export interface RelationshipLink {
+    /** Model handle for this side */
+    model: string;
+    /** Field handle on this model */
+    field: string;
+    /** Field label for display */
+    label: string;
+    /** Cardinality from this side */
+    cardinality: RelationshipCardinality;
+    /** On-delete behavior */
+    onDelete?: OnDeleteBehavior;
+}
+/** Bidirectional relationship definition between two models */
+export interface RelationshipDefinition {
+    /** Source side of the relationship */
+    source: RelationshipLink;
+    /** Target side of the relationship */
+    target: RelationshipLink;
 }
 export type ChannelIdentifierType = 'DEDICATED_PHONE' | 'TEXT' | 'EMAIL';
 export interface ChannelIdentifierValue {
@@ -398,6 +474,34 @@ export interface SkedyulConfig {
      * ```
      */
     models?: ModelDefinition[];
+    /**
+     * Relationships between models.
+     * Defines bidirectional links between INTERNAL models.
+     * Creates relationship fields on both sides automatically.
+     *
+     * @example
+     * ```typescript
+     * relationships: [
+     *   {
+     *     source: {
+     *       model: 'phone_number',
+     *       field: 'compliance_record',
+     *       label: 'Compliance Record',
+     *       cardinality: 'MANY_TO_ONE',
+     *       onDelete: 'RESTRICT',
+     *     },
+     *     target: {
+     *       model: 'compliance_record',
+     *       field: 'phone_numbers',
+     *       label: 'Phone Numbers',
+     *       cardinality: 'ONE_TO_MANY',
+     *       onDelete: 'NONE',
+     *     },
+     *   },
+     * ]
+     * ```
+     */
+    relationships?: RelationshipDefinition[];
     /**
      * Communication channels this app provides (new syntax).
      * Uses typed `requires` for dependencies.

package/dist/schemas.d.ts

@@ -125,6 +125,19 @@ export declare const ResourceScopeSchema: z.ZodEnum<{
     INTERNAL: "INTERNAL";
     SHARED: "SHARED";
 }>;
+/**
+ * Schema for field-level data ownership.
+ * Describes who owns/controls the data in a field.
+ * APP: App exclusively controls this data (e.g., status field set by webhook)
+ * WORKPLACE: User/organization provides this data (e.g., file upload)
+ * BOTH: Collaborative - either can update
+ */
+export declare const FieldOwnerSchema: z.ZodEnum<{
+    APP: "APP";
+    WORKPLACE: "WORKPLACE";
+    BOTH: "BOTH";
+}>;
+export declare const StructuredFilterSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>;
 /**
  * Schema for a model dependency reference.
  * Used in `requires` arrays to specify model dependencies.
@@ -132,6 +145,7 @@ export declare const ResourceScopeSchema: z.ZodEnum<{
 export declare const ModelDependencySchema: z.ZodObject<{
     model: z.ZodString;
     fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
 }, z.core.$strip>;
 /**
  * Schema for a channel dependency reference.
@@ -154,6 +168,7 @@ export declare const WorkflowDependencySchema: z.ZodObject<{
 export declare const ResourceDependencySchema: z.ZodUnion<readonly [z.ZodObject<{
     model: z.ZodString;
     fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
 }, z.core.$strip>, z.ZodObject<{
     channel: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
@@ -198,6 +213,7 @@ export declare const CommunicationChannelDefinitionSchema: z.ZodObject<{
     requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         model: z.ZodString;
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
     }, z.core.$strip>, z.ZodObject<{
         channel: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
@@ -243,6 +259,7 @@ export declare const ChannelDefinitionSchema: z.ZodObject<{
     requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         model: z.ZodString;
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
     }, z.core.$strip>, z.ZodObject<{
         channel: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
@@ -290,6 +307,7 @@ export declare const WorkflowDefinitionSchema: z.ZodObject<{
     requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
         model: z.ZodString;
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
     }, z.core.$strip>, z.ZodObject<{
         channel: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
@@ -335,6 +353,106 @@ export declare const FieldDataTypeSchema: z.ZodEnum<{
     RELATION: "RELATION";
     OBJECT: "OBJECT";
 }>;
+/**
+ * Schema for an option in a choice/enum field.
+ */
+export declare const FieldOptionSchema: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for relationship cardinality.
+ * Defines how many records can be linked on each side.
+ */
+export declare const RelationshipCardinalitySchema: z.ZodEnum<{
+    ONE_TO_ONE: "ONE_TO_ONE";
+    ONE_TO_MANY: "ONE_TO_MANY";
+    MANY_TO_ONE: "MANY_TO_ONE";
+    MANY_TO_MANY: "MANY_TO_MANY";
+}>;
+/**
+ * Schema for on-delete behavior in relationships.
+ */
+export declare const OnDeleteBehaviorSchema: z.ZodEnum<{
+    NONE: "NONE";
+    CASCADE: "CASCADE";
+    RESTRICT: "RESTRICT";
+}>;
+/**
+ * Schema for a relationship link (one side of a relationship).
+ */
+export declare const RelationshipLinkSchema: z.ZodObject<{
+    model: z.ZodString;
+    field: z.ZodString;
+    label: z.ZodString;
+    cardinality: z.ZodEnum<{
+        ONE_TO_ONE: "ONE_TO_ONE";
+        ONE_TO_MANY: "ONE_TO_MANY";
+        MANY_TO_ONE: "MANY_TO_ONE";
+        MANY_TO_MANY: "MANY_TO_MANY";
+    }>;
+    onDelete: z.ZodDefault<z.ZodEnum<{
+        NONE: "NONE";
+        CASCADE: "CASCADE";
+        RESTRICT: "RESTRICT";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Schema for a relationship definition.
+ * Relationships are bidirectional - they define links from both sides.
+ */
+export declare const RelationshipDefinitionSchema: z.ZodObject<{
+    source: z.ZodObject<{
+        model: z.ZodString;
+        field: z.ZodString;
+        label: z.ZodString;
+        cardinality: z.ZodEnum<{
+            ONE_TO_ONE: "ONE_TO_ONE";
+            ONE_TO_MANY: "ONE_TO_MANY";
+            MANY_TO_ONE: "MANY_TO_ONE";
+            MANY_TO_MANY: "MANY_TO_MANY";
+        }>;
+        onDelete: z.ZodDefault<z.ZodEnum<{
+            NONE: "NONE";
+            CASCADE: "CASCADE";
+            RESTRICT: "RESTRICT";
+        }>>;
+    }, z.core.$strip>;
+    target: z.ZodObject<{
+        model: z.ZodString;
+        field: z.ZodString;
+        label: z.ZodString;
+        cardinality: z.ZodEnum<{
+            ONE_TO_ONE: "ONE_TO_ONE";
+            ONE_TO_MANY: "ONE_TO_MANY";
+            MANY_TO_ONE: "MANY_TO_ONE";
+            MANY_TO_MANY: "MANY_TO_MANY";
+        }>;
+        onDelete: z.ZodDefault<z.ZodEnum<{
+            NONE: "NONE";
+            CASCADE: "CASCADE";
+            RESTRICT: "RESTRICT";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Schema for inline field definition (constraints, options, etc.)
+ * This allows defining field behavior without referencing a metafield definition.
+ */
+export declare const InlineFieldDefinitionSchema: z.ZodObject<{
+    limitChoices: z.ZodOptional<z.ZodNumber>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        value: z.ZodString;
+        color: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    pattern: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /**
  * Schema for a field within a model.
  * Works for both INTERNAL and SHARED models.
@@ -356,6 +474,19 @@ export declare const ModelFieldDefinitionSchema: z.ZodObject<{
         OBJECT: "OBJECT";
     }>>;
     definitionHandle: z.ZodOptional<z.ZodString>;
+    definition: z.ZodOptional<z.ZodObject<{
+        limitChoices: z.ZodOptional<z.ZodNumber>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            value: z.ZodString;
+            color: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        pattern: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     required: z.ZodOptional<z.ZodBoolean>;
     unique: z.ZodOptional<z.ZodBoolean>;
     system: z.ZodOptional<z.ZodBoolean>;
@@ -369,6 +500,11 @@ export declare const ModelFieldDefinitionSchema: z.ZodObject<{
         list: z.ZodOptional<z.ZodBoolean>;
         filters: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    owner: z.ZodOptional<z.ZodEnum<{
+        APP: "APP";
+        WORKPLACE: "WORKPLACE";
+        BOTH: "BOTH";
+    }>>;
 }, z.core.$strip>;
 /**
  * Schema for a unified model definition.
@@ -401,6 +537,19 @@ export declare const ModelDefinitionSchema: z.ZodObject<{
             OBJECT: "OBJECT";
         }>>;
         definitionHandle: z.ZodOptional<z.ZodString>;
+        definition: z.ZodOptional<z.ZodObject<{
+            limitChoices: z.ZodOptional<z.ZodNumber>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                value: z.ZodString;
+                color: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         required: z.ZodOptional<z.ZodBoolean>;
         unique: z.ZodOptional<z.ZodBoolean>;
         system: z.ZodOptional<z.ZodBoolean>;
@@ -414,7 +563,21 @@ export declare const ModelDefinitionSchema: z.ZodObject<{
             list: z.ZodOptional<z.ZodBoolean>;
             filters: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        owner: z.ZodOptional<z.ZodEnum<{
+            APP: "APP";
+            WORKPLACE: "WORKPLACE";
+            BOTH: "BOTH";
+        }>>;
     }, z.core.$strip>>;
+    requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        model: z.ZodString;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        channel: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        workflow: z.ZodString;
+    }, z.core.$strip>]>>>;
 }, z.core.$strip>;
 /**
  * @deprecated Use FieldDataTypeSchema instead
@@ -598,6 +761,19 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                 OBJECT: "OBJECT";
             }>>;
             definitionHandle: z.ZodOptional<z.ZodString>;
+            definition: z.ZodOptional<z.ZodObject<{
+                limitChoices: z.ZodOptional<z.ZodNumber>;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    label: z.ZodString;
+                    value: z.ZodString;
+                    color: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
+                minLength: z.ZodOptional<z.ZodNumber>;
+                maxLength: z.ZodOptional<z.ZodNumber>;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                pattern: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
             required: z.ZodOptional<z.ZodBoolean>;
             unique: z.ZodOptional<z.ZodBoolean>;
             system: z.ZodOptional<z.ZodBoolean>;
@@ -611,7 +787,55 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
                 list: z.ZodOptional<z.ZodBoolean>;
                 filters: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
+            owner: z.ZodOptional<z.ZodEnum<{
+                APP: "APP";
+                WORKPLACE: "WORKPLACE";
+                BOTH: "BOTH";
+            }>>;
         }, z.core.$strip>>;
+        requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            channel: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            workflow: z.ZodString;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>>;
+    relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodObject<{
+            model: z.ZodString;
+            field: z.ZodString;
+            label: z.ZodString;
+            cardinality: z.ZodEnum<{
+                ONE_TO_ONE: "ONE_TO_ONE";
+                ONE_TO_MANY: "ONE_TO_MANY";
+                MANY_TO_ONE: "MANY_TO_ONE";
+                MANY_TO_MANY: "MANY_TO_MANY";
+            }>;
+            onDelete: z.ZodDefault<z.ZodEnum<{
+                NONE: "NONE";
+                CASCADE: "CASCADE";
+                RESTRICT: "RESTRICT";
+            }>>;
+        }, z.core.$strip>;
+        target: z.ZodObject<{
+            model: z.ZodString;
+            field: z.ZodString;
+            label: z.ZodString;
+            cardinality: z.ZodEnum<{
+                ONE_TO_ONE: "ONE_TO_ONE";
+                ONE_TO_MANY: "ONE_TO_MANY";
+                MANY_TO_ONE: "MANY_TO_ONE";
+                MANY_TO_MANY: "MANY_TO_MANY";
+            }>;
+            onDelete: z.ZodDefault<z.ZodEnum<{
+                NONE: "NONE";
+                CASCADE: "CASCADE";
+                RESTRICT: "RESTRICT";
+            }>>;
+        }, z.core.$strip>;
     }, z.core.$strip>>>;
     channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
         handle: z.ZodString;
@@ -649,6 +873,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
         requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             model: z.ZodString;
             fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
         }, z.core.$strip>, z.ZodObject<{
             channel: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
@@ -691,6 +916,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
         requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             model: z.ZodString;
             fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
         }, z.core.$strip>, z.ZodObject<{
             channel: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
@@ -705,6 +931,7 @@ export declare const SkedyulConfigSchema: z.ZodObject<{
         requires: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
             model: z.ZodString;
             fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            where: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>]>>>>;
         }, z.core.$strip>, z.ZodObject<{
             channel: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
@@ -770,6 +997,22 @@ export type ParsedSkedyulConfig = z.infer<typeof SkedyulConfigSchema>;
 export declare function safeParseConfig(data: unknown): ParsedSkedyulConfig | null;
 /** Resource scope type */
 export type ResourceScope = z.infer<typeof ResourceScopeSchema>;
+/** Field owner type (data ownership) */
+export type FieldOwner = z.infer<typeof FieldOwnerSchema>;
+/** StructuredFilter type for conditional dependencies */
+export type StructuredFilter = z.infer<typeof StructuredFilterSchema>;
+/** Field option for choice/enum fields */
+export type FieldOption = z.infer<typeof FieldOptionSchema>;
+/** Inline field definition (constraints, options, etc.) */
+export type InlineFieldDefinition = z.infer<typeof InlineFieldDefinitionSchema>;
+/** Relationship cardinality type */
+export type RelationshipCardinality = z.infer<typeof RelationshipCardinalitySchema>;
+/** On-delete behavior type */
+export type OnDeleteBehavior = z.infer<typeof OnDeleteBehaviorSchema>;
+/** Relationship link (one side of a relationship) */
+export type RelationshipLink = z.infer<typeof RelationshipLinkSchema>;
+/** Relationship definition */
+export type RelationshipDefinition = z.infer<typeof RelationshipDefinitionSchema>;
 /** Model dependency reference */
 export type ModelDependency = z.infer<typeof ModelDependencySchema>;
 /** Channel dependency reference */

package/dist/schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SkedyulConfigSchema = exports.InternalModelDefinitionSchema = exports.InternalFieldDefinitionSchema = exports.InternalFieldDataTypeSchema = exports.ModelDefinitionSchema = exports.ModelFieldDefinitionSchema = exports.FieldDataTypeSchema = exports.ComputeLayerTypeSchema = exports.WorkflowDefinitionSchema = exports.WorkflowActionSchema = exports.WorkflowActionInputSchema = exports.ChannelDefinitionSchema = exports.CommunicationChannelDefinitionSchema = exports.ResourceDependencySchema = exports.WorkflowDependencySchema = exports.ChannelDependencySchema = exports.ModelDependencySchema = exports.ResourceScopeSchema = exports.ChannelIdentifierValueSchema = exports.ChannelIdentifierTypeSchema = exports.ChannelToolBindingsSchema = exports.AppFieldDefinitionSchema = exports.AppFieldVisibilitySchema = exports.InstallConfigSchema = exports.AppModelDefinitionSchema = exports.EnvSchemaSchema = exports.EnvVariableDefinitionSchema = exports.EnvVisibilitySchema = void 0;
+exports.SkedyulConfigSchema = exports.InternalModelDefinitionSchema = exports.InternalFieldDefinitionSchema = exports.InternalFieldDataTypeSchema = exports.ModelDefinitionSchema = exports.ModelFieldDefinitionSchema = exports.InlineFieldDefinitionSchema = exports.RelationshipDefinitionSchema = exports.RelationshipLinkSchema = exports.OnDeleteBehaviorSchema = exports.RelationshipCardinalitySchema = exports.FieldOptionSchema = exports.FieldDataTypeSchema = exports.ComputeLayerTypeSchema = exports.WorkflowDefinitionSchema = exports.WorkflowActionSchema = exports.WorkflowActionInputSchema = exports.ChannelDefinitionSchema = exports.CommunicationChannelDefinitionSchema = exports.ResourceDependencySchema = exports.WorkflowDependencySchema = exports.ChannelDependencySchema = exports.ModelDependencySchema = exports.StructuredFilterSchema = exports.FieldOwnerSchema = exports.ResourceScopeSchema = exports.ChannelIdentifierValueSchema = exports.ChannelIdentifierTypeSchema = exports.ChannelToolBindingsSchema = exports.AppFieldDefinitionSchema = exports.AppFieldVisibilitySchema = exports.InstallConfigSchema = exports.AppModelDefinitionSchema = exports.EnvSchemaSchema = exports.EnvVariableDefinitionSchema = exports.EnvVisibilitySchema = void 0;
 exports.safeParseConfig = safeParseConfig;
 exports.isModelDependency = isModelDependency;
 exports.isChannelDependency = isChannelDependency;
@@ -99,6 +99,21 @@ exports.ChannelIdentifierValueSchema = zod_1.z.object({
  * SHARED: Maps to user's existing resource, requires user selection
  */
 exports.ResourceScopeSchema = zod_1.z.enum(['INTERNAL', 'SHARED']);
+/**
+ * Schema for field-level data ownership.
+ * Describes who owns/controls the data in a field.
+ * APP: App exclusively controls this data (e.g., status field set by webhook)
+ * WORKPLACE: User/organization provides this data (e.g., file upload)
+ * BOTH: Collaborative - either can update
+ */
+exports.FieldOwnerSchema = zod_1.z.enum(['APP', 'WORKPLACE', 'BOTH']);
+/**
+ * Schema for StructuredFilter conditions.
+ * Used for conditional dependencies (e.g., require model where status = APPROVED)
+ * Format: { fieldHandle: { operator: value } }
+ */
+const PrimitiveSchema = zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean()]);
+exports.StructuredFilterSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.union([PrimitiveSchema, zod_1.z.array(PrimitiveSchema)])));
 /**
  * Schema for a model dependency reference.
  * Used in `requires` arrays to specify model dependencies.
@@ -108,6 +123,8 @@ exports.ModelDependencySchema = zod_1.z.object({
     model: zod_1.z.string(),
     /** Specific fields required (undefined = all fields) */
     fields: zod_1.z.array(zod_1.z.string()).optional(),
+    /** Conditions the dependency instance must satisfy (StructuredFilter format) */
+    where: exports.StructuredFilterSchema.optional(),
 });
 /**
  * Schema for a channel dependency reference.
@@ -217,6 +234,80 @@ exports.FieldDataTypeSchema = zod_1.z.enum([
     'RELATION',
     'OBJECT',
 ]);
+/**
+ * Schema for an option in a choice/enum field.
+ */
+exports.FieldOptionSchema = zod_1.z.object({
+    /** Display label */
+    label: zod_1.z.string(),
+    /** Value stored in database */
+    value: zod_1.z.string(),
+    /** Optional color for UI display */
+    color: zod_1.z.string().optional(),
+});
+/**
+ * Schema for relationship cardinality.
+ * Defines how many records can be linked on each side.
+ */
+exports.RelationshipCardinalitySchema = zod_1.z.enum([
+    'ONE_TO_ONE',
+    'ONE_TO_MANY',
+    'MANY_TO_ONE',
+    'MANY_TO_MANY',
+]);
+/**
+ * Schema for on-delete behavior in relationships.
+ */
+exports.OnDeleteBehaviorSchema = zod_1.z.enum([
+    'NONE', // No action
+    'CASCADE', // Delete related records
+    'RESTRICT', // Prevent deletion
+]);
+/**
+ * Schema for a relationship link (one side of a relationship).
+ */
+exports.RelationshipLinkSchema = zod_1.z.object({
+    /** Model handle for this side of the relationship */
+    model: zod_1.z.string(),
+    /** Field handle on this model */
+    field: zod_1.z.string(),
+    /** Field label for display */
+    label: zod_1.z.string(),
+    /** Cardinality from this side */
+    cardinality: exports.RelationshipCardinalitySchema,
+    /** On-delete behavior */
+    onDelete: exports.OnDeleteBehaviorSchema.default('NONE'),
+});
+/**
+ * Schema for a relationship definition.
+ * Relationships are bidirectional - they define links from both sides.
+ */
+exports.RelationshipDefinitionSchema = zod_1.z.object({
+    /** Source side of the relationship */
+    source: exports.RelationshipLinkSchema,
+    /** Target side of the relationship */
+    target: exports.RelationshipLinkSchema,
+});
+/**
+ * Schema for inline field definition (constraints, options, etc.)
+ * This allows defining field behavior without referencing a metafield definition.
+ */
+exports.InlineFieldDefinitionSchema = zod_1.z.object({
+    /** For choice fields: number of selections allowed (1 = single select, >1 = multi) */
+    limitChoices: zod_1.z.number().optional(),
+    /** For choice fields: available options */
+    options: zod_1.z.array(exports.FieldOptionSchema).optional(),
+    /** For string fields: min length */
+    minLength: zod_1.z.number().optional(),
+    /** For string fields: max length */
+    maxLength: zod_1.z.number().optional(),
+    /** For number fields: min value */
+    min: zod_1.z.number().optional(),
+    /** For number fields: max value */
+    max: zod_1.z.number().optional(),
+    /** Validation regex pattern */
+    pattern: zod_1.z.string().optional(),
+});
 /**
  * Schema for a field within a model.
  * Works for both INTERNAL and SHARED models.
@@ -228,8 +319,10 @@ exports.ModelFieldDefinitionSchema = zod_1.z.object({
     label: zod_1.z.string(),
     /** Data type (required for INTERNAL, optional for SHARED) */
     type: exports.FieldDataTypeSchema.optional(),
-    /** Field definition handle for SHARED fields */
+    /** Field definition handle for SHARED fields (references a metafield definition) */
     definitionHandle: zod_1.z.string().optional(),
+    /** Inline field definition (alternative to definitionHandle for INTERNAL fields) */
+    definition: exports.InlineFieldDefinitionSchema.optional(),
     /** Whether field is required */
     required: zod_1.z.boolean().optional(),
     /** Whether field must be unique */
@@ -244,6 +337,8 @@ exports.ModelFieldDefinitionSchema = zod_1.z.object({
     description: zod_1.z.string().optional(),
     /** Visibility settings for SHARED fields */
     visibility: exports.AppFieldVisibilitySchema.optional(),
+    /** Data ownership: APP (app controls), WORKPLACE (user provides), BOTH (collaborative) */
+    owner: exports.FieldOwnerSchema.optional(),
 });
 /**
  * Schema for a unified model definition.
@@ -264,6 +359,8 @@ exports.ModelDefinitionSchema = zod_1.z.object({
     description: zod_1.z.string().optional(),
     /** Field definitions */
     fields: zod_1.z.array(exports.ModelFieldDefinitionSchema),
+    /** Model-level dependencies - other models this model requires to be provisioned */
+    requires: zod_1.z.array(exports.ResourceDependencySchema).optional(),
 });
 // ─────────────────────────────────────────────────────────────────────────────
 // Legacy Internal Model Schemas (deprecated - use ModelDefinitionSchema)
@@ -329,6 +426,8 @@ exports.SkedyulConfigSchema = zod_1.z.object({
         .optional(),
     // New unified model definitions (INTERNAL + SHARED)
     models: zod_1.z.array(exports.ModelDefinitionSchema).optional(),
+    // Relationships between models
+    relationships: zod_1.z.array(exports.RelationshipDefinitionSchema).optional(),
     // New channel syntax (alias for communicationChannels)
     channels: zod_1.z.array(exports.ChannelDefinitionSchema).optional(),
     // Legacy: communication channels (deprecated - use channels)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",