@eide/foir-cli 0.1.32 → 0.1.33

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,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;;;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

@@ -127,6 +127,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/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,CAuE1E"}

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;

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,CA6QR;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,
@@ -107,7 +108,7 @@ 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' };
 }`);
     lines.push('');
@@ -131,7 +132,7 @@ import type {
     modelKey: string;
     naturalKey?: string;
     data: Partial<${dataType}>;
-    metadata?: Record<string, unknown>;
+    metadata?: Record<string, JsonValue>;
   };
 }`);
     lines.push('');
@@ -155,7 +156,7 @@ import type {
   input: {
     id: string;
     data?: Partial<${dataType}>;
-    metadata?: Record<string, unknown>;
+    metadata?: Record<string, JsonValue>;
     changeDescription?: string;
   };
 }`);

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) {

package/dist/graphql/generated.d.ts

@@ -760,6 +760,7 @@ export type CreateOperationInput = {
     models?: InputMaybe<Array<Scalars['String']['input']>>;
     name: Scalars['String']['input'];
     outputSchema?: InputMaybe<Scalars['JSON']['input']>;
+    quotas?: InputMaybe<Array<OperationQuotaInput>>;
     retryPolicy?: InputMaybe<Scalars['JSON']['input']>;
     streamConfig?: InputMaybe<OperationStreamConfigInput>;
     timeoutMs?: InputMaybe<Scalars['Int']['input']>;
@@ -2162,6 +2163,11 @@ export type Mutation = {
      * Promotes winning content to the target variant and cleans up experiment artifacts.
      */
     applyExperimentWinner: ApplyWinnerResult;
+    /**
+     * Assign a custom package to a tenant's subscription. Platform admin only.
+     * Creates a minimal subscription if the tenant doesn't have one (no Stripe required).
+     */
+    assignBillingCustomPackage: BillingSubscription;
     batchPublishVersions: BatchPublishResult;
     batchRecordOperations: BatchRecordOperationsResult;
     bulkUpdateRecords: BulkUpdateRecordsResult;
@@ -2614,6 +2620,10 @@ export type MutationApplyExperimentWinnerArgs = {
     experimentId: Scalars['ID']['input'];
     winnerId: Scalars['String']['input'];
 };
+export type MutationAssignBillingCustomPackageArgs = {
+    customPackageId: Scalars['ID']['input'];
+    tenantId: Scalars['ID']['input'];
+};
 export type MutationBatchPublishVersionsArgs = {
     batchId?: InputMaybe<Scalars['String']['input']>;
     versionIds: Array<Scalars['ID']['input']>;
@@ -3446,6 +3456,8 @@ export type Operation = {
     models?: Maybe<Array<Scalars['String']['output']>>;
     name: Scalars['String']['output'];
     outputSchema?: Maybe<Scalars['JSON']['output']>;
+    /** Quota rules for rate-limiting operation executions per scope. */
+    quotas?: Maybe<Array<Scalars['JSON']['output']>>;
     retryPolicy?: Maybe<Scalars['JSON']['output']>;
     /** Streaming configuration. Operations with this set support STREAM execution mode. */
     streamConfig?: Maybe<OperationStreamConfig>;
@@ -3495,6 +3507,27 @@ export type OperationList = {
     items: Array<Operation>;
     total: Scalars['Int']['output'];
 };
+/** Quota rule input for operation create/update */
+export type OperationQuotaInput = {
+    /** Optional condition expression (RuleExpression as JSON) */
+    condition?: InputMaybe<Scalars['JSON']['input']>;
+    /** Duration window in seconds */
+    duration: Scalars['Int']['input'];
+    /** Max points per duration window (0 = unlimited) */
+    points: Scalars['Int']['input'];
+    /** Scope for quota tracking: customer, user, or tenant */
+    scope: Scalars['String']['input'];
+    /** Segment key to match (null = default/fallback rule) */
+    segmentKey?: InputMaybe<Scalars['String']['input']>;
+};
+/** Operation quota usage for the current context */
+export type OperationQuotaUsage = {
+    consumed: Scalars['Int']['output'];
+    limit?: Maybe<Scalars['Int']['output']>;
+    operationKey: Scalars['String']['output'];
+    remaining?: Maybe<Scalars['Int']['output']>;
+    resetsAt?: Maybe<Scalars['DateTime']['output']>;
+};
 /** Streaming configuration for an operation */
 export type OperationStreamConfig = {
     /** Max gap between callback chunks in ms (default: 30000) */
@@ -3995,6 +4028,8 @@ export type Query = {
     operationExecutionStats: OperationExecutionStats;
     /** List operation executions with filtering. */
     operationExecutions: OperationExecutionList;
+    /** Get quota usage for an operation in the current context. */
+    operationQuotaUsage?: Maybe<OperationQuotaUsage>;
     /** List operations for the current project. */
     operations: OperationList;
     /** Get the operations signing secret status (masked). */
@@ -4476,6 +4511,9 @@ export type QueryOperationExecutionsArgs = {
     operationKey?: InputMaybe<Scalars['String']['input']>;
     status?: InputMaybe<OperationExecutionStatus>;
 };
+export type QueryOperationQuotaUsageArgs = {
+    operationKey: Scalars['String']['input'];
+};
 export type QueryOperationsArgs = {
     category?: InputMaybe<Scalars['String']['input']>;
     isActive?: InputMaybe<Scalars['Boolean']['input']>;
@@ -5714,6 +5752,7 @@ export type UpdateOperationInput = {
     models?: InputMaybe<Array<Scalars['String']['input']>>;
     name?: InputMaybe<Scalars['String']['input']>;
     outputSchema?: InputMaybe<Scalars['JSON']['input']>;
+    quotas?: InputMaybe<Array<OperationQuotaInput>>;
     retryPolicy?: InputMaybe<Scalars['JSON']['input']>;
     streamConfig?: InputMaybe<OperationStreamConfigInput>;
     timeoutMs?: InputMaybe<Scalars['Int']['input']>;