@eide/foir-cli 0.1.31 → 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/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAgBtD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,aAAa,GAC9B,IAAI,CAuON"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAgBtD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,aAAa,GAC9B,IAAI,CAoRN"}

package/dist/commands/hooks.js

@@ -4,7 +4,9 @@ import { formatOutput, formatList, timeAgo, success } from '../lib/output.js';
 import { parseInputData, confirmAction } from '../lib/input.js';
 import { ListHooksDocument, GetHookByKeyDocument, CreateHookDocument, UpdateHookDocument, DeleteHookDocument, HookDeliveriesDocument, RetryHookDeliveryDocument, TestHookDocument, } from '../graphql/generated.js';
 export function registerHooksCommands(program, globalOpts) {
-    const hooks = program.command('hooks').description('Manage event hooks');
+    const hooks = program
+        .command('hooks')
+        .description('Manage event hooks — triggers that run operations or send notifications when platform events occur');
     // list
     hooks
         .command('list')
@@ -25,6 +27,12 @@ export function registerHooksCommands(program, globalOpts) {
                 { key: 'key', header: 'Key', width: 24 },
                 { key: 'name', header: 'Name', width: 20 },
                 { key: 'event', header: 'Event', width: 24 },
+                {
+                    key: 'targetType',
+                    header: 'Target',
+                    width: 14,
+                    format: (v) => v === 'notification' ? 'notification' : 'operation',
+                },
                 { key: 'operationKey', header: 'Operation', width: 20 },
                 {
                     key: 'isActive',
@@ -57,7 +65,34 @@ export function registerHooksCommands(program, globalOpts) {
     // create
     hooks
         .command('create')
-        .description('Create a hook')
+        .description(`Create a hook
+
+  Required fields: key, name, event
+  Optional fields: targetType (operation|notification), operationKey, notificationConfig,
+                   filter { modelKey, customerSegmentKey, condition }, isActive
+
+  Events: RECORD_CREATED, RECORD_UPDATED, RECORD_DELETED, RECORD_PUBLISHED,
+          RECORD_UNPUBLISHED, CUSTOMER_REGISTERED, CUSTOMER_DELETED,
+          CUSTOMER_PROFILE_UPDATED, EXTENSION_INITIALIZED, and more.
+
+  Conditions use rule expressions (JSON) to filter when the hook fires.
+  Example with condition:
+    foir hooks create -d '{
+      "key": "notify-pro-publish",
+      "name": "Notify on Pro Publish",
+      "event": "RECORD_PUBLISHED",
+      "targetType": "operation",
+      "operationKey": "my-webhook",
+      "filter": {
+        "modelKey": "blog_post",
+        "condition": {
+          "type": "condition",
+          "left": { "type": "context", "path": "customer.profile.plan" },
+          "operator": "in",
+          "right": { "type": "literal", "value": ["pro", "enterprise"] }
+        }
+      }
+    }'`)
         .option('-d, --data <json>', 'Hook data as JSON')
         .option('-f, --file <path>', 'Read input from file')
         .action(withErrorHandler(globalOpts, async (cmdOpts) => {
@@ -73,7 +108,10 @@ export function registerHooksCommands(program, globalOpts) {
     // update
     hooks
         .command('update <id>')
-        .description('Update a hook')
+        .description(`Update a hook
+
+  All fields are optional. Supports: name, event, targetType, operationKey,
+  notificationConfig, filter (with condition), isActive.`)
         .option('-d, --data <json>', 'Update data as JSON')
         .option('-f, --file <path>', 'Read input from file')
         .action(withErrorHandler(globalOpts, async (id, cmdOpts) => {

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