@eide/foir-cli 0.1.32 → 0.1.34

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

@@ -20,6 +20,11 @@ export interface FieldSchemaForGen {
 }
 export declare function getFieldType(field: FieldSchemaForGen, mode?: 'output' | 'input'): string;
 export declare function getRequiredImports(fields: FieldSchemaForGen[]): Set<string>;
+/**
+ * Extract model keys referenced by reference-type fields via `referenceTypes`.
+ * Used to generate parameterized `ReferenceValue<Partial<ModelData>>` types.
+ */
+export declare function getReferenceTypeModelRefs(fields: FieldSchemaForGen[]): Set<string>;
 export declare function getInlineSchemaReferences(fields: FieldSchemaForGen[]): Set<string>;
 export declare function toCamelCase(str: string): string;
 export declare function toPascalCase(str: string): string;

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,aAoBhC,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAoD1D,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,CACvC,MAAM,EAAE,iBAAiB,EAAE,GAC1B,GAAG,CAAC,MAAM,CAAC,CAcb;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA2EjE"}
+{"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,aAqBhC,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAqD1D,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;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EAAE,GAC1B,GAAG,CAAC,MAAM,CAAC,CAUb;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EAAE,GAC1B,GAAG,CAAC,MAAM,CAAC,CAcb;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA2EjE"}

package/dist/codegen/field-mapping.js

@@ -22,6 +22,7 @@ export const PRIMITIVE_FIELD_TYPES = new Set([
     'reference',
     'link',
     'flexible',
+    'model',
 ]);
 export function isPrimitiveFieldType(type) {
     return PRIMITIVE_FIELD_TYPES.has(type);
@@ -78,6 +79,7 @@ export const FIELD_TYPE_MAPPING = {
         inputType: 'LinkValue',
         needsImport: 'field-types',
     },
+    model: { outputType: 'string', inputType: 'string' },
 };
 export function getFieldType(field, mode = 'output') {
     if (!field?.type)
@@ -127,6 +129,21 @@ export function getRequiredImports(fields) {
     }
     return imports;
 }
+/**
+ * Extract model keys referenced by reference-type fields via `referenceTypes`.
+ * Used to generate parameterized `ReferenceValue<Partial<ModelData>>` types.
+ */
+export function getReferenceTypeModelRefs(fields) {
+    const refs = new Set();
+    for (const field of fields) {
+        if (field.type === 'reference' && field.options?.referenceTypes) {
+            for (const rt of field.options.referenceTypes) {
+                refs.add(rt);
+            }
+        }
+    }
+    return refs;
+}
 export function getInlineSchemaReferences(fields) {
     const refs = new Set();
     for (const field of fields) {

package/dist/codegen/generators/config.js

@@ -10,7 +10,7 @@ export function generateConfigFile() {
  * @generated by foir — DO NOT EDIT MANUALLY
  */
 
-import type { FieldDef } from './field-types.js';
+import type { FieldDef, JsonValue } from './field-types.js';
 
 /**
  * Model configuration
@@ -66,7 +66,7 @@ export interface ModelConfig {
   };
 
   /** Lifecycle hooks configuration */
-  hooks?: Record<string, unknown>;
+  hooks?: Record<string, JsonValue>;
 
   /** Field definitions */
   fieldDefs: readonly FieldDef[];

package/dist/codegen/generators/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAiGlE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAoBhD"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAyGlE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAoBhD"}

package/dist/codegen/generators/documents.js

@@ -25,10 +25,10 @@ fragment ${typeName}Fields on Record {
   updatedAt
 }
 
-query Get${typeName}($id: ID!, $locale: String, $preview: Boolean) {
+query Get${typeName}($id: ID!, $locale: String, $preview: Boolean, $fields: FieldSelectionInput) {
   record(id: $id) {
     ...${typeName}Fields
-    resolved(locale: $locale, preview: $preview) {
+    resolved(locale: $locale, preview: $preview, fields: $fields) {
       content
       record { id modelKey naturalKey }
       version { id versionNumber }
@@ -36,10 +36,10 @@ query Get${typeName}($id: ID!, $locale: String, $preview: Boolean) {
   }
 }
 
-query Get${typeName}ByKey($naturalKey: String!, $locale: String, $preview: Boolean) {
+query Get${typeName}ByKey($naturalKey: String!, $locale: String, $preview: Boolean, $fields: FieldSelectionInput) {
   recordByKey(modelKey: "${model.key}", naturalKey: $naturalKey) {
     ...${typeName}Fields
-    resolved(locale: $locale, preview: $preview) {
+    resolved(locale: $locale, preview: $preview, fields: $fields) {
       content
       record { id modelKey naturalKey }
       version { id versionNumber }
@@ -52,6 +52,9 @@ query List${pluralName}(
   $offset: Int
   $filters: [FilterInput!]
   $sort: SortInput
+  $locale: String
+  $preview: Boolean
+  $fields: FieldSelectionInput
 ) {
   records(
     modelKey: "${model.key}"
@@ -62,6 +65,11 @@ query List${pluralName}(
   ) {
     items {
       ...${typeName}Fields
+      resolved(locale: $locale, preview: $preview, fields: $fields) {
+        content
+        record { id modelKey naturalKey }
+        version { id versionNumber }
+      }
     }
     total
   }

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

@@ -1 +1 @@
-{"version":3,"file":"field-types.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/field-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,sBAAsB,IAAI,MAAM,CA+U/C"}
+{"version":3,"file":"field-types.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/field-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,sBAAsB,IAAI,MAAM,CAsV/C"}

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

@@ -10,12 +10,19 @@ export function generateFieldTypesFile() {
  * @generated by foir — DO NOT EDIT MANUALLY
  */
 
+// =============================================================================
+// JSON-SAFE BASE TYPE
+// =============================================================================
+
+/** Recursive JSON-serializable value type. Safe for TanStack Router, Remix, RSC, and other serialization boundaries. */
+export type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };
+
 // =============================================================================
 // VALUE TYPES
 // =============================================================================
 
 /** Rich text content (Lexical JSON format) */
-export type RichtextValue = unknown;
+export type RichtextValue = JsonValue;
 
 /** Currency value with amount and ISO 4217 code */
 export interface CurrencyValue {
@@ -63,19 +70,19 @@ export interface LinkRecordReference {
   naturalKey: string;
 }
 
-/** Record reference value */
-export interface ReferenceValue {
+/** Record reference value (generic TPreview for typed preview data when reference target is known) */
+export interface ReferenceValue<TPreview = Record<string, JsonValue>> {
   _type: 'reference';
   _schema: string;
   naturalKey: string;
-  _preview?: Record<string, unknown>;
+  _preview?: TPreview;
 }
 
 /** Composite/inline value */
 export interface CompositeValue {
   _type: 'composite';
   _schema: string;
-  fields: Record<string, unknown>;
+  fields: Record<string, JsonValue>;
 }
 
 /** A single item in a flexible field array */
@@ -86,8 +93,8 @@ export interface FlexibleFieldItem {
   _label: string;
   _required?: boolean;
   _helpText?: string;
-  _config?: Record<string, unknown>;
-  value: unknown;
+  _config?: Record<string, JsonValue>;
+  value: JsonValue;
 }
 
 // =============================================================================
@@ -159,7 +166,7 @@ export interface ReferenceFilter {
 export interface FilterInput {
   field: string;
   operator: string;
-  value: unknown;
+  value: JsonValue;
 }
 
 export interface SortInput {
@@ -176,7 +183,7 @@ export interface VariantContext {
   locale?: string;
   device?: string;
   region?: string;
-  contexts?: Record<string, unknown>;
+  contexts?: Record<string, JsonValue>;
 }
 
 /** Reference resolution options */
@@ -191,7 +198,7 @@ export interface ResolvedRecord {
   id: string;
   modelKey: string;
   naturalKey: string | null;
-  metadata?: Record<string, unknown>;
+  metadata?: Record<string, JsonValue>;
 }
 
 /** Resolved variant info */
@@ -206,7 +213,7 @@ export interface ResolvedField {
   type: string;
   label?: string;
   required?: boolean;
-  value: unknown;
+  value: JsonValue;
 }
 
 /** Resolved content */
@@ -217,7 +224,7 @@ export interface ResolvedContent {
 /** Resolution context output */
 export interface ResolutionContext {
   locale: string;
-  contexts: Record<string, unknown>;
+  contexts: Record<string, JsonValue>;
 }
 
 /** Base resolved record content */
@@ -237,7 +244,7 @@ export interface BaseFieldDef {
   label: string;
   required?: boolean;
   helpText?: string;
-  defaultValue?: unknown;
+  defaultValue?: JsonValue;
 }
 
 export interface TextFieldDef extends BaseFieldDef {

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,CAyBR"}
+{"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;AAiBvD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,YAAY,EAAE,GACxB,MAAM,CA2BR"}

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

@@ -1,7 +1,7 @@
 /**
  * Generates per-model TypeScript files with config object + data interface.
  */
-import { getFieldType, getInlineSchemaReferences, generateFieldDef, sanitizeFieldName, toPascalCase, toCamelCase, FIELD_TYPE_MAPPING, } from '../field-mapping.js';
+import { getFieldType, getInlineSchemaReferences, getReferenceTypeModelRefs, generateFieldDef, sanitizeFieldName, toPascalCase, toCamelCase, FIELD_TYPE_MAPPING, } from '../field-mapping.js';
 function isInlineOnlyModel(model) {
     return model.config.inline && !model.config.records;
 }
@@ -17,7 +17,8 @@ export function generateModelTypes(model, allModels) {
     const fields = model.fields ?? [];
     const fieldTypeImports = getFieldTypeImportsForFields(fields);
     const inlineSchemaRefs = getInlineSchemaReferences(fields);
-    let code = buildImportStatements(model, fieldTypeImports, inlineSchemaRefs, allModels);
+    const referenceModelRefs = getReferenceTypeModelRefs(fields);
+    let code = buildImportStatements(model, fieldTypeImports, inlineSchemaRefs, referenceModelRefs, allModels);
     if (isInlineOnlyModel(model)) {
         code += generateDataInterface(model, fields, typeName, allModels);
         return code;
@@ -27,7 +28,7 @@ export function generateModelTypes(model, allModels) {
     code += generateDataInterface(model, fields, typeName + 'Data', allModels);
     return code;
 }
-function buildImportStatements(model, fieldTypeImports, inlineSchemaRefs, allModels) {
+function buildImportStatements(model, fieldTypeImports, inlineSchemaRefs, referenceModelRefs, allModels) {
     const imports = [];
     if (!isInlineOnlyModel(model)) {
         imports.push("import type { ModelConfig } from '../config.js';");
@@ -36,7 +37,12 @@ function buildImportStatements(model, fieldTypeImports, inlineSchemaRefs, allMod
         const types = Array.from(fieldTypeImports).sort().join(', ');
         imports.push(`import type { ${types} } from '../field-types.js';`);
     }
-    for (const refKey of inlineSchemaRefs) {
+    // Collect all model refs (inline schemas + reference type targets) to avoid duplicate imports
+    const allModelRefKeys = new Set([
+        ...inlineSchemaRefs,
+        ...referenceModelRefs,
+    ]);
+    for (const refKey of allModelRefKeys) {
         if (refKey === model.key)
             continue; // skip self-reference
         const refModel = allModels.find((m) => m.key === refKey);
@@ -127,6 +133,24 @@ function generateDataInterface(model, fields, interfaceName, allModels) {
                 fieldType = toPascalCase(field.options.itemType) + 'Data[]';
             }
         }
+        // Parameterize ReferenceValue with known reference target types for typed _preview
+        if (field.type === 'reference' && field.options?.referenceTypes) {
+            const refTypes = field.options.referenceTypes;
+            const resolvedPreviewTypes = [];
+            for (const refKey of refTypes) {
+                const targetModel = allModels.find((m) => m.key === refKey);
+                if (targetModel) {
+                    const targetTypeName = isInlineOnlyModel(targetModel)
+                        ? toPascalCase(refKey)
+                        : toPascalCase(refKey) + 'Data';
+                    resolvedPreviewTypes.push(`Partial<${targetTypeName}>`);
+                }
+            }
+            // Only parameterize if all targets resolved — otherwise keep default generic
+            if (resolvedPreviewTypes.length === refTypes.length && resolvedPreviewTypes.length > 0) {
+                fieldType = `ReferenceValue<${resolvedPreviewTypes.join(' | ')}>`;
+            }
+        }
         const optional = field.required ? '' : '?';
         const comment = field.helpText ? `  /** ${field.helpText} */\n` : '';
         lines.push(comment + `  ${fieldName}${optional}: ${fieldType};`);

package/dist/codegen/generators/typed-operations-common.d.ts

@@ -2,5 +2,5 @@
  * Generates the shared _common.ts file for typed operations.
  * Contains generic wrapper types used by all per-model operation modules.
  */
-export declare function generateTypedOperationsCommon(): string;
+export declare function generateTypedOperationsCommon(typesRelPath: string): string;
 //# sourceMappingURL=typed-operations-common.d.ts.map

package/dist/codegen/generators/typed-operations-common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-operations-common.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/typed-operations-common.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,6BAA6B,IAAI,MAAM,CAqEtD"}
+{"version":3,"file":"typed-operations-common.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/typed-operations-common.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA+E1E"}

package/dist/codegen/generators/typed-operations-common.js

@@ -2,20 +2,22 @@
  * Generates the shared _common.ts file for typed operations.
  * Contains generic wrapper types used by all per-model operation modules.
  */
-export function generateTypedOperationsCommon() {
+export function generateTypedOperationsCommon(typesRelPath) {
     return `/**
  * Shared types for typed GraphQL operations.
  *
  * @generated by foir — DO NOT EDIT MANUALLY
  */
 
+import type { JsonValue } from '${typesRelPath}/field-types.js';
+
 /** A record with strongly-typed data. */
 export interface BaseRecord<T> {
   id: string;
   modelKey: string;
   naturalKey: string | null;
   data: T;
-  metadata: Record<string, unknown> | null;
+  metadata: Record<string, JsonValue> | null;
   publishedVersionNumber: number | null;
   publishedAt: string | null;
   versionNumber: number | null;
@@ -33,7 +35,7 @@ export interface ResolvedContent<T> {
 
 /** Paginated list result. */
 export interface PaginatedResult<T> {
-  items: BaseRecord<T>[];
+  items: (BaseRecord<T> & { resolved: ResolvedContent<T> | null })[];
   total: number;
 }
 
@@ -70,5 +72,13 @@ export interface ShareResult {
 export interface ShareWithRecord<T> extends ShareResult {
   record: BaseRecord<T>;
 }
+
+/** Field selection for resolved content — pick or omit specific fields. */
+export interface FieldSelection<T = Record<string, unknown>> {
+  /** Include only these field keys (mutually exclusive with omit) */
+  pick?: (keyof T & string)[];
+  /** Exclude these field keys (mutually exclusive with omit) */
+  omit?: (keyof T & string)[];
+}
 `;
 }

package/dist/codegen/generators/typed-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-operations.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/typed-operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CA4QR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5E"}
+{"version":3,"file":"typed-operations.d.ts","sourceRoot":"","sources":["../../../src/codegen/generators/typed-operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAwRR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5E"}

package/dist/codegen/generators/typed-operations.js

@@ -21,6 +21,7 @@ export function generateTypedOperations(model, typesRelPath) {
  * @generated by foir — DO NOT EDIT MANUALLY
  */
 
+import type { JsonValue } from '${typesRelPath}/field-types.js';
 import type { ${dataType} } from '${typesRelPath}/models/${model.key}.js';
 import type {
   BaseRecord,
@@ -28,7 +29,8 @@ import type {
   PaginatedResult,
   CreateRecordResult,
   UpdateRecordResult,
-  DeleteRecordResult,${model.config.sharing?.enabled ? '\n  ShareResult,\n  ShareWithRecord,' : ''}
+  DeleteRecordResult,
+  FieldSelection,${model.config.sharing?.enabled ? '\n  ShareResult,\n  ShareWithRecord,' : ''}
 } from './_common.js';
 `);
     // Type alias
@@ -36,12 +38,12 @@ import type {
     lines.push('');
     // GET query
     lines.push(`export const GET_${upperSnake} = \`
-  query Get${typeName}($id: ID!, $locale: String, $preview: Boolean) {
+  query Get${typeName}($id: ID!, $locale: String, $preview: Boolean, $fields: FieldSelectionInput) {
     record(id: $id) {
       id modelKey naturalKey data metadata
       publishedVersionNumber publishedAt versionNumber changeDescription
       createdAt updatedAt
-      resolved(locale: $locale, preview: $preview) {
+      resolved(locale: $locale, preview: $preview, fields: $fields) {
         content
         record { id modelKey naturalKey }
         version { id versionNumber }
@@ -54,6 +56,7 @@ import type {
   id: string;
   locale?: string;
   preview?: boolean;
+  fields?: FieldSelection<${dataType}>;
 }`);
     lines.push('');
     lines.push(`export interface Get${typeName}Result {
@@ -64,12 +67,12 @@ import type {
     lines.push('');
     // GET BY KEY query
     lines.push(`export const GET_${upperSnake}_BY_KEY = \`
-  query Get${typeName}ByKey($naturalKey: String!, $locale: String, $preview: Boolean) {
+  query Get${typeName}ByKey($naturalKey: String!, $locale: String, $preview: Boolean, $fields: FieldSelectionInput) {
     recordByKey(modelKey: "${model.key}", naturalKey: $naturalKey) {
       id modelKey naturalKey data metadata
       publishedVersionNumber publishedAt versionNumber changeDescription
       createdAt updatedAt
-      resolved(locale: $locale, preview: $preview) {
+      resolved(locale: $locale, preview: $preview, fields: $fields) {
         content
         record { id modelKey naturalKey }
         version { id versionNumber }
@@ -82,6 +85,7 @@ import type {
   naturalKey: string;
   locale?: string;
   preview?: boolean;
+  fields?: FieldSelection<${dataType}>;
 }`);
     lines.push('');
     lines.push(`export interface Get${typeName}ByKeyResult {
@@ -92,12 +96,17 @@ import type {
     lines.push('');
     // LIST query
     lines.push(`export const LIST_${pluralUpperSnake} = \`
-  query List${pluralName}($limit: Int, $offset: Int, $filters: [FilterInput!], $sort: SortInput) {
+  query List${pluralName}($limit: Int, $offset: Int, $filters: [FilterInput!], $sort: SortInput, $locale: String, $preview: Boolean, $fields: FieldSelectionInput) {
     records(modelKey: "${model.key}", limit: $limit, offset: $offset, filters: $filters, sort: $sort) {
       items {
         id modelKey naturalKey data metadata
         publishedVersionNumber publishedAt versionNumber changeDescription
         createdAt updatedAt
+        resolved(locale: $locale, preview: $preview, fields: $fields) {
+          content
+          record { id modelKey naturalKey }
+          version { id versionNumber }
+        }
       }
       total
     }
@@ -107,8 +116,11 @@ import type {
     lines.push(`export interface List${pluralName}Variables {
   limit?: number;
   offset?: number;
-  filters?: Array<{ field: string; operator: string; value: unknown }>;
+  filters?: Array<{ field: string; operator: string; value: JsonValue }>;
   sort?: { field: string; direction: 'ASC' | 'DESC' };
+  locale?: string;
+  preview?: boolean;
+  fields?: FieldSelection<${dataType}>;
 }`);
     lines.push('');
     lines.push(`export interface List${pluralName}Result {
@@ -131,7 +143,7 @@ import type {
     modelKey: string;
     naturalKey?: string;
     data: Partial<${dataType}>;
-    metadata?: Record<string, unknown>;
+    metadata?: Record<string, JsonValue>;
   };
 }`);
     lines.push('');
@@ -155,7 +167,7 @@ import type {
   input: {
     id: string;
     data?: Partial<${dataType}>;
-    metadata?: Record<string, unknown>;
+    metadata?: Record<string, JsonValue>;
     changeDescription?: string;
   };
 }`);

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

@@ -1 +1 @@
-{"version":3,"file":"swift-field-mapping.d.ts","sourceRoot":"","sources":["../../src/codegen/swift-field-mapping.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAwHrE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACvC,CAeA"}
+{"version":3,"file":"swift-field-mapping.d.ts","sourceRoot":"","sources":["../../src/codegen/swift-field-mapping.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,cAAc,EAAE,OAAO,CAAC;IACxB,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CA8HrE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACvC,CAeA"}

package/dist/codegen/swift-field-mapping.js

@@ -124,6 +124,12 @@ export const SWIFT_FIELD_TYPE_MAPPING = {
         castExpression: 'as? [String: Any]',
         needsSharedType: true,
     },
+    model: {
+        type: 'String',
+        alwaysOptional: true,
+        defaultValue: '""',
+        castExpression: 'as? String',
+    },
 };
 /**
  * Get the Swift type for a field.

package/dist/commands/operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/commands/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAkBtD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,aAAa,GAC9B,IAAI,CAsVN"}
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/commands/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAkBtD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,aAAa,GAC9B,IAAI,CA8ZN"}

package/dist/commands/operations.js

@@ -154,6 +154,61 @@ export function registerOperationsCommands(program, globalOpts) {
             }
         }
     }));
+    // quota
+    operations
+        .command('quota <key>')
+        .description('Show quota usage for an operation')
+        .option('--json', 'JSON output')
+        .action(withErrorHandler(globalOpts, async (key) => {
+        const opts = globalOpts();
+        const client = await createClient(opts);
+        // First get the operation to see its quota rules
+        const opData = await client.request(GetOperationDocument, { key });
+        if (!opData.operation)
+            throw new Error(`Operation "${key}" not found.`);
+        const quotas = opData.operation.quotas;
+        if (!quotas || quotas.length === 0) {
+            if (opts.json || opts.jsonl)
+                formatOutput({
+                    operationKey: key,
+                    quotas: [],
+                    message: 'No quotas configured',
+                }, opts);
+            else
+                console.log('No quotas configured for this operation.');
+            return;
+        }
+        if (opts.json || opts.jsonl) {
+            formatOutput({ operationKey: key, quotas }, opts);
+        }
+        else {
+            console.log(`\nQuota rules for "${key}":\n`);
+            const header = [
+                'Segment'.padEnd(20),
+                'Scope'.padEnd(10),
+                'Limit'.padEnd(8),
+                'Window'.padEnd(10),
+            ].join(' | ');
+            console.log(header);
+            console.log('-'.repeat(header.length));
+            for (const q of quotas) {
+                const segment = q.segmentKey ?? '(default)';
+                const limit = q.points === 0 ? '\u221e' : String(q.points);
+                const window = q.duration >= 86400
+                    ? `${q.duration / 86400}d`
+                    : q.duration >= 3600
+                        ? `${q.duration / 3600}h`
+                        : `${q.duration}s`;
+                console.log([
+                    segment.padEnd(20),
+                    q.scope.padEnd(10),
+                    limit.padEnd(8),
+                    window.padEnd(10),
+                ].join(' | '));
+            }
+            console.log('');
+        }
+    }));
     // stats
     operations
         .command('stats <key>')

package/dist/commands/pull.js

@@ -157,7 +157,7 @@ export function registerPullCommand(program, globalOpts) {
         const typesRelPath = computeTypesRelPath(opsDir, typesDir);
         files.push({
             path: resolve(opsDir, '_common.ts'),
-            content: generateTypedOperationsCommon(),
+            content: generateTypedOperationsCommon(typesRelPath),
         });
         // 7a. Per-model typed operations
         for (const model of publicModels) {