@eide/foir-cli 0.1.3 → 0.1.5

package/dist/cli.js

@@ -19,6 +19,7 @@ import { registerRecordsCommands } from './commands/records.js';
 import { registerModelsCommands } from './commands/models.js';
 import { registerSearchCommands } from './commands/search.js';
 import { registerCustomersCommands } from './commands/customers.js';
+import { registerCustomerProfilesCommands } from './commands/customer-profiles.js';
 import { registerSegmentsCommands } from './commands/segments.js';
 import { registerExperimentsCommands } from './commands/experiments.js';
 import { registerSettingsCommands } from './commands/settings.js';
@@ -61,6 +62,7 @@ registerRecordsCommands(program, getGlobalOpts);
 registerModelsCommands(program, getGlobalOpts);
 registerSearchCommands(program, getGlobalOpts);
 registerCustomersCommands(program, getGlobalOpts);
+registerCustomerProfilesCommands(program, getGlobalOpts);
 registerSegmentsCommands(program, getGlobalOpts);
 registerExperimentsCommands(program, getGlobalOpts);
 registerSettingsCommands(program, getGlobalOpts);

package/dist/codegen/fetch-customer-profile-schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fetches the customer profile schema from the platform GraphQL API for codegen.
+ */
+import type { GraphQLClient } from 'graphql-request';
+import type { FieldSchemaForGen } from './field-mapping.js';
+export interface CodegenCustomerProfileSchema {
+    id: string;
+    fields: FieldSchemaForGen[];
+    version: number;
+}
+export declare function fetchCustomerProfileSchema(client: GraphQLClient): Promise<CodegenCustomerProfileSchema | null>;
+//# sourceMappingURL=fetch-customer-profile-schema.d.ts.map

package/dist/codegen/fetch-customer-profile-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-customer-profile-schema.d.ts","sourceRoot":"","sources":["../../src/codegen/fetch-customer-profile-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAqBD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAiB9C"}

package/dist/codegen/fetch-customer-profile-schema.js

@@ -0,0 +1,21 @@
+/**
+ * Fetches the customer profile schema from the platform GraphQL API for codegen.
+ */
+import { CUSTOMER_PROFILE_SCHEMA } from '../graphql/queries.js';
+export async function fetchCustomerProfileSchema(client) {
+    const data = await client.request(CUSTOMER_PROFILE_SCHEMA);
+    if (!data.customerProfileSchema)
+        return null;
+    return {
+        id: data.customerProfileSchema.id,
+        version: data.customerProfileSchema.version,
+        fields: (data.customerProfileSchema.fields ?? []).map((f) => ({
+            key: f.key,
+            type: f.type,
+            label: f.label,
+            required: f.required,
+            helpText: f.helpText,
+            options: f.config,
+        })),
+    };
+}

package/dist/codegen/fetch-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-models.d.ts","sourceRoot":"","sources":["../../src/codegen/fetch-models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAC1F;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAgCD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD,YAAY,EAAE,CAahB"}
+{"version":3,"file":"fetch-models.d.ts","sourceRoot":"","sources":["../../src/codegen/fetch-models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvD,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAgCD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,YAAY,EAAE,CAAC,CAezB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EAAE,EACtB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD,YAAY,EAAE,CAahB"}

package/dist/codegen/field-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-mapping.d.ts","sourceRoot":"","sources":["../../src/codegen/field-mapping.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,qBAAqB,aAsBhC,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAsB1D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,IAAI,GAAE,QAAQ,GAAG,OAAkB,GAClC,MAAM,CAqCR;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAW3E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAclF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAyDjE"}
+{"version":3,"file":"field-mapping.d.ts","sourceRoot":"","sources":["../../src/codegen/field-mapping.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,qBAAqB,aAsBhC,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA0D1D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,iBAAiB,EACxB,IAAI,GAAE,QAAQ,GAAG,OAAkB,GAClC,MAAM,CAwCR;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAc3E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EAAE,GAC1B,GAAG,CAAC,MAAM,CAAC,CAiBb;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAiFjE"}

package/dist/codegen/field-mapping.js

@@ -30,26 +30,62 @@ export function isPrimitiveFieldType(type) {
 }
 export const FIELD_TYPE_MAPPING = {
     text: { outputType: 'string', inputType: 'string' },
-    richtext: { outputType: 'RichtextValue', inputType: 'RichtextValue', needsImport: 'field-types' },
+    richtext: {
+        outputType: 'RichtextValue',
+        inputType: 'RichtextValue',
+        needsImport: 'field-types',
+    },
     number: { outputType: 'number', inputType: 'number' },
     boolean: { outputType: 'boolean', inputType: 'boolean' },
     email: { outputType: 'string', inputType: 'string' },
     phone: { outputType: 'string', inputType: 'string' },
     url: { outputType: 'string', inputType: 'string' },
     date: { outputType: 'Date', inputType: 'string' },
-    image: { outputType: 'ImageValue', inputType: 'string', needsImport: 'field-types' },
-    video: { outputType: 'VideoValue', inputType: 'string', needsImport: 'field-types' },
-    file: { outputType: 'FileValue', inputType: 'string', needsImport: 'field-types' },
-    currency: { outputType: 'CurrencyValue', inputType: 'CurrencyValue', needsImport: 'field-types' },
+    image: {
+        outputType: 'ImageValue',
+        inputType: 'string',
+        needsImport: 'field-types',
+    },
+    video: {
+        outputType: 'VideoValue',
+        inputType: 'string',
+        needsImport: 'field-types',
+    },
+    file: {
+        outputType: 'FileValue',
+        inputType: 'string',
+        needsImport: 'field-types',
+    },
+    currency: {
+        outputType: 'CurrencyValue',
+        inputType: 'CurrencyValue',
+        needsImport: 'field-types',
+    },
     select: { outputType: 'string', inputType: 'string' },
     multiselect: { outputType: 'string[]', inputType: 'string[]' },
     json: { outputType: 'unknown', inputType: 'unknown' },
     list: { outputType: 'unknown[]', inputType: 'unknown[]' },
     tree: { outputType: 'unknown[]', inputType: 'unknown[]' },
-    flexible: { outputType: 'FlexibleFieldItem[]', inputType: 'FlexibleFieldItem[]', needsImport: 'field-types' },
-    'entity-reference': { outputType: 'ReferenceValue', inputType: 'ReferenceValue', needsImport: 'field-types' },
-    reference: { outputType: 'ReferenceValue', inputType: 'ReferenceValue', needsImport: 'field-types' },
-    link: { outputType: 'LinkValue', inputType: 'LinkValue', needsImport: 'field-types' },
+    flexible: {
+        outputType: 'FlexibleFieldItem[]',
+        inputType: 'FlexibleFieldItem[]',
+        needsImport: 'field-types',
+    },
+    'entity-reference': {
+        outputType: 'ReferenceValue',
+        inputType: 'ReferenceValue',
+        needsImport: 'field-types',
+    },
+    reference: {
+        outputType: 'ReferenceValue',
+        inputType: 'ReferenceValue',
+        needsImport: 'field-types',
+    },
+    link: {
+        outputType: 'LinkValue',
+        inputType: 'LinkValue',
+        needsImport: 'field-types',
+    },
 };
 export function getFieldType(field, mode = 'output') {
     if (!field?.type)
@@ -73,7 +109,8 @@ export function getFieldType(field, mode = 'output') {
             tsType = `(${options.map((o) => `'${o.value}'`).join(' | ')})[]`;
         }
     }
-    if ((field.type === 'list' || field.type === 'tree') && field.options?.itemType) {
+    if ((field.type === 'list' || field.type === 'tree') &&
+        field.options?.itemType) {
         const itemType = field.options.itemType;
         const itemMapping = FIELD_TYPE_MAPPING[itemType];
         if (itemMapping) {
@@ -91,7 +128,8 @@ export function getRequiredImports(fields) {
         const mapping = FIELD_TYPE_MAPPING[field.type];
         if (mapping?.needsImport)
             imports.add(mapping.needsImport);
-        if ((field.type === 'list' || field.type === 'tree') && field.options?.itemType) {
+        if ((field.type === 'list' || field.type === 'tree') &&
+            field.options?.itemType) {
             const itemMapping = FIELD_TYPE_MAPPING[field.options.itemType];
             if (itemMapping?.needsImport)
                 imports.add(itemMapping.needsImport);
@@ -105,7 +143,8 @@ export function getInlineSchemaReferences(fields) {
         if (!isPrimitiveFieldType(field.type) && !FIELD_TYPE_MAPPING[field.type]) {
             refs.add(field.type);
         }
-        if ((field.type === 'list' || field.type === 'tree') && field.options?.itemType) {
+        if ((field.type === 'list' || field.type === 'tree') &&
+            field.options?.itemType) {
             const itemType = field.options.itemType;
             if (!isPrimitiveFieldType(itemType) && !FIELD_TYPE_MAPPING[itemType]) {
                 refs.add(itemType);
@@ -156,7 +195,8 @@ export function generateFieldDef(field) {
         if (field.options.step !== undefined)
             parts.push(`step: ${field.options.step}`);
     }
-    if ((field.type === 'select' || field.type === 'multiselect') && field.options?.options) {
+    if ((field.type === 'select' || field.type === 'multiselect') &&
+        field.options?.options) {
         const options = field.options.options;
         const optionsStr = options
             .filter((o) => o.value !== undefined)
@@ -168,20 +208,24 @@ export function generateFieldDef(field) {
             .join(', ');
         parts.push(`options: [${optionsStr}]`);
     }
-    if ((field.type === 'entity-reference' || field.type === 'reference') && field.options?.referenceTypes) {
+    if ((field.type === 'entity-reference' || field.type === 'reference') &&
+        field.options?.referenceTypes) {
         const refTypes = field.options.referenceTypes;
         parts.push(`referenceTypes: [${refTypes.map((t) => `'${t}'`).join(', ')}]`);
         if (field.options.multiple)
             parts.push('multiple: true');
     }
-    if ((field.type === 'list' || field.type === 'tree') && field.options?.itemType) {
+    if ((field.type === 'list' || field.type === 'tree') &&
+        field.options?.itemType) {
         parts.push(`itemType: '${field.options.itemType}'`);
         if (field.options.minItems !== undefined)
             parts.push(`minItems: ${field.options.minItems}`);
         if (field.options.maxItems !== undefined)
             parts.push(`maxItems: ${field.options.maxItems}`);
     }
-    if ((field.type === 'image' || field.type === 'video' || field.type === 'file') &&
+    if ((field.type === 'image' ||
+        field.type === 'video' ||
+        field.type === 'file') &&
         field.options) {
         if (field.options.allowedTypes) {
             const types = field.options.allowedTypes;

package/dist/codegen/generators/customer-profile-types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates TypeScript types for the customer profile schema.
+ */
+import type { CodegenCustomerProfileSchema } from '../fetch-customer-profile-schema.js';
+export declare function generateCustomerProfileTypes(schema: CodegenCustomerProfileSchema): string;
+//# sourceMappingURL=customer-profile-types.d.ts.map

package/dist/codegen/generators/customer-profile-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-profile-types.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/customer-profile-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAQxF,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,4BAA4B,GACnC,MAAM,CAqCR"}

package/dist/codegen/generators/customer-profile-types.js

@@ -0,0 +1,45 @@
+/**
+ * Generates TypeScript types for the customer profile schema.
+ */
+import { getFieldType, sanitizeFieldName, FIELD_TYPE_MAPPING, } from '../field-mapping.js';
+export function generateCustomerProfileTypes(schema) {
+    const fields = schema.fields ?? [];
+    const fieldTypeImports = getFieldTypeImportsForFields(fields);
+    let code = `/**
+ * Customer Profile Types
+ *
+ * @generated by foir from customer profile schema (version ${schema.version}) — DO NOT EDIT MANUALLY
+ */\n\n`;
+    if (fieldTypeImports.size > 0) {
+        const types = Array.from(fieldTypeImports).sort().join(', ');
+        code += `import type { ${types} } from '../field-types.js';\n\n`;
+    }
+    code += `/**
+ * Customer Profile Data
+ * Typed field values for customer profiles
+ *
+ * @generated from customer profile schema (version ${schema.version})
+ */\n`;
+    code += `export interface CustomerProfileData {\n`;
+    for (const field of fields) {
+        const fieldName = sanitizeFieldName(field.key);
+        const fieldType = getFieldType(field, 'output');
+        const optional = field.required ? '' : '?';
+        if (field.helpText) {
+            code += `  /** ${field.helpText} */\n`;
+        }
+        code += `  ${fieldName}${optional}: ${fieldType};\n`;
+    }
+    code += `}\n`;
+    return code;
+}
+function getFieldTypeImportsForFields(fields) {
+    const imports = new Set();
+    for (const field of fields) {
+        const mapping = FIELD_TYPE_MAPPING[field.type];
+        if (mapping?.needsImport === 'field-types') {
+            imports.add(mapping.outputType);
+        }
+    }
+    return imports;
+}

package/dist/codegen/generators/model-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-types.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/model-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgBvD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,YAAY,EAAE,GACxB,MAAM,CAoBR"}
+{"version":3,"file":"model-types.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/model-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAgBvD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,YAAY,EAAE,GACxB,MAAM,CAyBR"}

package/dist/codegen/generators/model-types.js

@@ -119,7 +119,8 @@ function generateDataInterface(model, fields, interfaceName, allModels) {
             fieldType = toPascalCase(field.type) + 'Data';
         }
         // Handle list/tree itemType refs
-        if ((field.type === 'list' || field.type === 'tree') && field.options?.itemType) {
+        if ((field.type === 'list' || field.type === 'tree') &&
+            field.options?.itemType) {
             const itemRefModel = allModels.find((m) => m.key === field.options.itemType);
             if (itemRefModel && !isInlineOnlyModel(itemRefModel)) {
                 fieldType = toPascalCase(field.options.itemType) + 'Data[]';
@@ -139,7 +140,8 @@ function getFieldTypeImportsForFields(fields) {
         if (mapping?.needsImport === 'field-types') {
             imports.add(mapping.outputType);
         }
-        if ((field.type === 'list' || field.type === 'tree') && field.options?.itemType) {
+        if ((field.type === 'list' || field.type === 'tree') &&
+            field.options?.itemType) {
             const itemMapping = FIELD_TYPE_MAPPING[field.options.itemType];
             if (itemMapping?.needsImport === 'field-types') {
                 imports.add(itemMapping.outputType);

package/dist/codegen/generators/swift-field-types.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generates the shared FieldTypes.swift file with platform value type structs.
+ */
+export declare function generateSwiftFieldTypesFile(): string;
+//# sourceMappingURL=swift-field-types.d.ts.map

package/dist/codegen/generators/swift-field-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swift-field-types.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/swift-field-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,2BAA2B,IAAI,MAAM,CA6IpD"}

package/dist/codegen/generators/swift-field-types.js

@@ -0,0 +1,145 @@
+/**
+ * Generates the shared FieldTypes.swift file with platform value type structs.
+ */
+export function generateSwiftFieldTypesFile() {
+    return `//
+//  FieldTypes.swift
+//
+//  Shared value types for platform sync data.
+//
+//  @generated by foir \u2014 DO NOT EDIT MANUALLY
+//
+
+import Foundation
+
+// MARK: - Image
+
+struct ImageValue {
+    let id: String
+    let url: String
+    var alt: String?
+    var width: Int?
+    var height: Int?
+
+    func toSyncData() -> [String: Any] {
+        var data: [String: Any] = ["id": id, "url": url]
+        if let alt { data["alt"] = alt }
+        if let width { data["width"] = width }
+        if let height { data["height"] = height }
+        return data
+    }
+
+    static func fromSyncData(_ data: [String: Any]) -> ImageValue {
+        ImageValue(
+            id: data["id"] as? String ?? "",
+            url: data["url"] as? String ?? "",
+            alt: data["alt"] as? String,
+            width: data["width"] as? Int,
+            height: data["height"] as? Int
+        )
+    }
+}
+
+// MARK: - Video
+
+struct VideoValue {
+    let id: String
+    let url: String
+    var thumbnail: String?
+    var duration: Double?
+
+    func toSyncData() -> [String: Any] {
+        var data: [String: Any] = ["id": id, "url": url]
+        if let thumbnail { data["thumbnail"] = thumbnail }
+        if let duration { data["duration"] = duration }
+        return data
+    }
+
+    static func fromSyncData(_ data: [String: Any]) -> VideoValue {
+        VideoValue(
+            id: data["id"] as? String ?? "",
+            url: data["url"] as? String ?? "",
+            thumbnail: data["thumbnail"] as? String,
+            duration: data["duration"] as? Double
+        )
+    }
+}
+
+// MARK: - File
+
+struct FileValue {
+    let id: String
+    let url: String
+    let name: String
+    let size: Int
+    let mimeType: String
+
+    func toSyncData() -> [String: Any] {
+        [
+            "id": id,
+            "url": url,
+            "name": name,
+            "size": size,
+            "mimeType": mimeType,
+        ]
+    }
+
+    static func fromSyncData(_ data: [String: Any]) -> FileValue {
+        FileValue(
+            id: data["id"] as? String ?? "",
+            url: data["url"] as? String ?? "",
+            name: data["name"] as? String ?? "",
+            size: data["size"] as? Int ?? 0,
+            mimeType: data["mimeType"] as? String ?? ""
+        )
+    }
+}
+
+// MARK: - Currency
+
+struct CurrencyValue {
+    let amount: Double
+    let currency: String
+
+    func toSyncData() -> [String: Any] {
+        ["amount": amount, "currency": currency]
+    }
+
+    static func fromSyncData(_ data: [String: Any]) -> CurrencyValue {
+        CurrencyValue(
+            amount: data["amount"] as? Double ?? 0,
+            currency: data["currency"] as? String ?? ""
+        )
+    }
+}
+
+// MARK: - Link
+
+struct LinkValue {
+    let type: String
+    var entityModelKey: String?
+    var entityNaturalKey: String?
+    var url: String?
+    var target: String?
+
+    func toSyncData() -> [String: Any] {
+        var data: [String: Any] = ["type": type]
+        if let entityModelKey { data["entityModelKey"] = entityModelKey }
+        if let entityNaturalKey { data["entityNaturalKey"] = entityNaturalKey }
+        if let url { data["url"] = url }
+        if let target { data["target"] = target }
+        return data
+    }
+
+    static func fromSyncData(_ data: [String: Any]) -> LinkValue {
+        LinkValue(
+            type: data["type"] as? String ?? "",
+            entityModelKey: data["entityModelKey"] as? String,
+            entityNaturalKey: data["entityNaturalKey"] as? String,
+            url: data["url"] as? String,
+            target: data["target"] as? String
+        )
+    }
+}
+`;
+}

package/dist/codegen/generators/swift-model-keys.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates ModelKeys.swift with all model key constants in one enum.
+ */
+import type { CodegenModel } from '../fetch-models.js';
+export declare function generateSwiftModelKeys(models: CodegenModel[]): string;
+//# sourceMappingURL=swift-model-keys.d.ts.map

package/dist/codegen/generators/swift-model-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swift-model-keys.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/swift-model-keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAwBrE"}

package/dist/codegen/generators/swift-model-keys.js

@@ -0,0 +1,25 @@
+/**
+ * Generates ModelKeys.swift with all model key constants in one enum.
+ */
+import { toCamelCase } from '../field-mapping.js';
+export function generateSwiftModelKeys(models) {
+    const lines = [];
+    lines.push('//');
+    lines.push('//  ModelKeys.swift');
+    lines.push('//');
+    lines.push('//  All model key constants.');
+    lines.push('//');
+    lines.push('//  @generated by foir \u2014 DO NOT EDIT MANUALLY');
+    lines.push('//');
+    lines.push('');
+    lines.push('import Foundation');
+    lines.push('');
+    lines.push('enum ModelKeys {');
+    for (const model of models) {
+        const propName = toCamelCase(model.key);
+        lines.push(`    static let ${propName} = "${model.key}"`);
+    }
+    lines.push('}');
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/codegen/generators/swift-types.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generates per-model Swift files with:
+ * - Field key enum (compile-time safe field keys)
+ * - Data struct (typed representation)
+ * - Serialization helpers (toSyncData / fromSyncData)
+ * - Model config constant
+ */
+import type { CodegenModel } from '../fetch-models.js';
+/**
+ * Generate a complete Swift file for a single model.
+ */
+export declare function generateSwiftModelFile(model: CodegenModel): string;
+//# sourceMappingURL=swift-types.d.ts.map

package/dist/codegen/generators/swift-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swift-types.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/swift-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQvD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAkClE"}