@wildo-ai/saas-models 1.1.9 → 1.1.10

package/dist/esm/charts/chart-definition-builder.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-definition-builder.shared.js","sourceRoot":"","sources":["../../../../src/charts/chart-definition-builder.shared.ts"],"names":[],"mappings":"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","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * ChartDefinitionBuilder — Fluent API for building ChartDefinitions\n *\n * Pure function that constructs a ChartDefinition object and validates\n * it against the schema. No backend/frontend deps.\n *\n * View wiring (scope, addressability, launcher) is composed separately\n * in frontend presets/config via InsertedChartDeclaration in saas-frontend-lib.\n * Charts are resource-owned inserted surfaces only; there is no app-level\n * chart view type.\n *\n * Usage:\n *   chartBuilder('orders-per-month', 'ORDERS')\n *     .type(ChartType.BAR)\n *     .timeDimension('createdAt', TimeGranularity.MONTH)\n *     .count()\n *     .build()\n * ────────────────────────────────────────────────────────────── */\n\nimport {\n  ChartType,\n  ChartDefinitionSchema,\n  type ChartDefinition,\n  type ChartSeriesDefinition,\n  type ChartAccessControl,\n  type ChartInputDefinition,\n  type ChartSplitConfig,\n  type ChartSeriesStyle,\n  type ChartAppearance,\n  type ChartTypeConfig,\n} from '../config/frontend/chart-definition.shared.schemas';\nimport {\n  AggregateFunction,\n  TimeGranularity,\n  ComparisonOperator,\n  ContextFilterSource,\n  SortDirection,\n  DimensionSortBy,\n  JoinType,\n  WindowFunctionType,\n} from './aggregation.shared.definitions';\nimport type {\n  Measure,\n  Dimension,\n  ContextFilter,\n  ResourceJoin,\n  HavingClause,\n  ComputedMeasure,\n  WindowFunction,\n  AggregationQuery,\n} from './aggregation-query.shared.schemas';\n\n// ── Builder Options Types ────────────────────────────────────\n\nexport interface MeasureOptions {\n  label?: string;\n  filter?: Record<string, unknown>;\n}\n\nexport interface DimensionOptions {\n  label?: string;\n  sort?: {\n    direction?: SortDirection;\n    by?: 'self' | 'measure';\n    measureRef?: string;\n  };\n  topN?: number;\n  groupOther?: boolean;\n}\n\nexport interface TimeDimensionOptions extends DimensionOptions {\n  fillMissingBuckets?: boolean;\n  dateRange?: { from?: string; to?: string };\n}\n\nexport interface SeriesOptions {\n  chartType?: ChartType;\n  yAxisIndex?: number;\n  style?: Partial<ChartSeriesStyle>;\n  hidden?: boolean;\n}\n\nexport interface JoinOptions {\n  selectFields?: string[];\n  joinType?: JoinType;\n}\n\nexport interface WindowFunctionOptions {\n  label?: string;\n  windowSize?: number;\n  partitionBy?: string;\n  orderBy?: string;\n}\n\n// ── Builder Class ────────────────────────────────────────────\n\nexport class ChartDefinitionBuilder {\n  private _chartType: ChartType = ChartType.BAR;\n  private _dimensions: Dimension[] = [];\n  private _measures: Measure[] = [];\n  private _series: ChartSeriesDefinition[] = [];\n  private _contextFilters: ContextFilter[] = [];\n  private _joins: ResourceJoin[] = [];\n  private _filters?: Record<string, unknown>;\n  private _accessControl?: ChartAccessControl;\n  private _refreshInterval?: number;\n  private _timezone?: string;\n  private _limit?: number;\n  private _orderBy?: Array<{ ref: string; direction: SortDirection }>;\n  private _splitByDimension?: string;\n  private _splitConfig?: ChartSplitConfig;\n  private _having: HavingClause[] = [];\n  private _computedMeasures: ComputedMeasure[] = [];\n  private _windowFunctions: WindowFunction[] = [];\n  private _appearance?: ChartAppearance;\n  private _chartTypeConfig?: ChartTypeConfig;\n  private _i18n?: ChartDefinition['i18n'];\n  private _inputs?: ChartInputDefinition[];\n\n  constructor(\n    private readonly _ref: string,\n    private readonly _mainResourceType: string,\n  ) {}\n\n  // ── Chart type ──\n\n  type(chartType: ChartType): this {\n    this._chartType = chartType;\n    return this;\n  }\n\n  // ── Dimensions ──\n\n  dimension(field: string, options?: DimensionOptions): this {\n    const ref = options?.label?.toLowerCase().replace(/\\s+/g, '_') || field;\n    this._dimensions.push({\n      ref,\n      field,\n      label: options?.label,\n      sort: options?.sort ? {\n        direction: options.sort.direction ?? SortDirection.ASC,\n        by: options.sort.by === 'measure' ? DimensionSortBy.MEASURE : DimensionSortBy.SELF,\n        measureRef: options.sort.measureRef,\n      } : undefined,\n      topN: options?.topN,\n      groupOther: options?.groupOther,\n    });\n    return this;\n  }\n\n  timeDimension(field: string, granularity: TimeGranularity, options?: TimeDimensionOptions): this {\n    const ref = options?.label?.toLowerCase().replace(/\\s+/g, '_') || field;\n    this._dimensions.push({\n      ref,\n      field,\n      label: options?.label,\n      timeGranularity: granularity,\n      fillMissingBuckets: options?.fillMissingBuckets ?? true, // default: true for time dimensions\n      dateRange: options?.dateRange,\n      sort: options?.sort ? {\n        direction: options.sort.direction ?? SortDirection.ASC,\n        by: options.sort.by === 'measure' ? DimensionSortBy.MEASURE : DimensionSortBy.SELF,\n        measureRef: options.sort.measureRef,\n      } : undefined,\n      topN: options?.topN,\n      groupOther: options?.groupOther,\n    });\n    return this;\n  }\n\n  // ── Measures (shorthands) ──\n\n  count(options?: MeasureOptions): this {\n    return this.measure('*', AggregateFunction.COUNT, {\n      ...options,\n      label: options?.label ?? 'Count',\n    });\n  }\n\n  sum(field: string, options?: MeasureOptions): this {\n    return this.measure(field, AggregateFunction.SUM, options);\n  }\n\n  avg(field: string, options?: MeasureOptions): this {\n    return this.measure(field, AggregateFunction.AVG, options);\n  }\n\n  min(field: string, options?: MeasureOptions): this {\n    return this.measure(field, AggregateFunction.MIN, options);\n  }\n\n  max(field: string, options?: MeasureOptions): this {\n    return this.measure(field, AggregateFunction.MAX, options);\n  }\n\n  measure(field: string, aggregate: AggregateFunction, options?: MeasureOptions): this {\n    const ref = field === '*' ? `*_${aggregate}` : `${field}_${aggregate}`;\n    this._measures.push({\n      ref,\n      field,\n      aggregate,\n      label: options?.label,\n      filter: options?.filter,\n    });\n    return this;\n  }\n\n  // ── Series (explicit) ──\n\n  series(ref: string, name: string, measureRef: string, options?: SeriesOptions): this {\n    const series: ChartSeriesDefinition = {\n      ref,\n      name,\n      measureRef,\n      chartType: options?.chartType,\n      yAxisIndex: options?.yAxisIndex,\n      hidden: options?.hidden,\n      style: options?.style ? { ...options.style } : undefined,\n    };\n    this._series.push(series);\n    return this;\n  }\n\n  // ── Split by dimension ──\n\n  splitBy(dimensionRef: string, config?: ChartSplitConfig): this {\n    this._splitByDimension = dimensionRef;\n    this._splitConfig = config;\n    return this;\n  }\n\n  // ── Access control ──\n\n  accessControl(config: ChartAccessControl): this {\n    this._accessControl = config;\n    return this;\n  }\n\n  // ── Filters ──\n\n  contextFilter(field: string, source: ContextFilterSource, options?: { operator?: ComparisonOperator; sourceField?: string }): this {\n    this._contextFilters.push({\n      field,\n      operator: options?.operator ?? ComparisonOperator.EQ,\n      source,\n      sourceField: options?.sourceField,\n    });\n    return this;\n  }\n\n  filter(filters: Record<string, unknown>): this {\n    this._filters = filters;\n    return this;\n  }\n\n  // ── Computed measures (post-aggregation) ──\n\n  /**\n   * Add a computed measure that evaluates an expression using other measure refs as variables.\n   *\n   * @param ref - Unique ref for this computed measure\n   * @param expression - Safe expression using measure refs (e.g., \"completed / total * 100\")\n   * @param dependsOn - Measure refs referenced in the expression\n   * @param label - Optional display label\n   *\n   * @example\n   * ```ts\n   * .count({ label: 'Total' })                     // ref: \"*_count\"\n   * .measure('status', AggregateFunction.COUNT, {   // ref: \"status_count\"\n   *   label: 'Completed',\n   *   filter: { status: 'completed' }\n   * })\n   * .computedMeasure('completion_rate', 'round(status_count / *_count * 100, 1)', ['status_count', '*_count'])\n   * ```\n   */\n  computedMeasure(ref: string, expression: string, dependsOn: string[], label?: string): this {\n    this._computedMeasures.push({\n      ref,\n      expression,\n      dependsOn,\n      label,\n    });\n    return this;\n  }\n\n  // ── Window functions (post-aggregation transforms) ──\n\n  /**\n   * Generic window function.\n   */\n  windowFunction(ref: string, sourceRef: string, type: WindowFunctionType, options?: WindowFunctionOptions): this {\n    this._windowFunctions.push({\n      ref,\n      sourceRef,\n      type,\n      label: options?.label,\n      windowSize: options?.windowSize,\n      partitionBy: options?.partitionBy,\n      orderBy: options?.orderBy,\n    });\n    return this;\n  }\n\n  /**\n   * Shorthand: running total (cumulative sum).\n   */\n  runningTotal(ref: string, sourceRef: string, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.RUNNING_TOTAL, options);\n  }\n\n  /**\n   * Shorthand: percent change from previous row.\n   */\n  percentChange(ref: string, sourceRef: string, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.PERCENT_CHANGE, options);\n  }\n\n  /**\n   * Shorthand: moving average over a window of N rows.\n   *\n   * @param windowSize - Number of rows in the moving window (default: 3)\n   */\n  movingAvg(ref: string, sourceRef: string, windowSize?: number, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.MOVING_AVG, {\n      ...options,\n      windowSize: windowSize ?? 3,\n    });\n  }\n\n  /**\n   * Shorthand: percent of total (value / sum * 100).\n   */\n  percentOfTotal(ref: string, sourceRef: string, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.PERCENT_OF_TOTAL, options);\n  }\n\n  /**\n   * Shorthand: difference from previous row.\n   */\n  difference(ref: string, sourceRef: string, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.DIFFERENCE, options);\n  }\n\n  // ── Cross-resource joins ──\n\n  join(resourceType: string, fkField: string, alias: string, options?: JoinOptions): this {\n    this._joins.push({\n      resourceType,\n      foreignKeyField: fkField,\n      alias,\n      selectFields: options?.selectFields,\n      joinType: options?.joinType ?? JoinType.LEFT,\n    });\n    return this;\n  }\n\n  // ── HAVING (filter on aggregated values) ──\n\n  /**\n   * Add a HAVING clause to filter on aggregated measure values.\n   *\n   * @param measureRef - Ref of the measure to filter on\n   * @param operator - Comparison operator (GT, GTE, LT, LTE, EQ, NEQ)\n   * @param value - Numeric value to compare against\n   *\n   * @example\n   * ```ts\n   * .count()\n   * .having('*_COUNT', ComparisonOperator.GT, 10)  // Only groups with count > 10\n   * ```\n   */\n  having(measureRef: string, operator: ComparisonOperator, value: number): this {\n    this._having.push({ measureRef, operator, value });\n    return this;\n  }\n\n  // ── Binned dimension shorthand ──\n\n  /**\n   * Add a numeric dimension with binning (step-based or boundary-based).\n   *\n   * @example\n   * ```ts\n   * // Step-based: 0-10, 10-20, 20-30, ...\n   * .binDimension('age', { step: 10 })\n   *\n   * // Boundary-based: <0, 0-50, 50-100, 100-500, ≥500\n   * .binDimension('price', { boundaries: [0, 50, 100, 500] })\n   * ```\n   */\n  binDimension(field: string, bin: { step: number } | { boundaries: number[] }, options?: DimensionOptions): this {\n    const ref = options?.label?.toLowerCase().replace(/\\s+/g, '_') || field;\n    this._dimensions.push({\n      ref,\n      field,\n      label: options?.label,\n      bin,\n      sort: options?.sort ? {\n        direction: options.sort.direction ?? SortDirection.ASC,\n        by: options.sort.by === 'measure' ? DimensionSortBy.MEASURE : DimensionSortBy.SELF,\n        measureRef: options.sort.measureRef,\n      } : undefined,\n      topN: options?.topN,\n      groupOther: options?.groupOther,\n    });\n    return this;\n  }\n\n  // ── Result shaping ──\n\n  timezone(tz: string): this {\n    this._timezone = tz;\n    return this;\n  }\n\n  refreshInterval(ms: number): this {\n    this._refreshInterval = ms;\n    return this;\n  }\n\n  limitResults(n: number): this {\n    this._limit = n;\n    return this;\n  }\n\n  orderBy(ref: string, direction: SortDirection = SortDirection.ASC): this {\n    if (!this._orderBy) this._orderBy = [];\n    this._orderBy.push({ ref, direction });\n    return this;\n  }\n\n  // ── Appearance & type config ──\n\n  appearance(config: ChartAppearance): this {\n    this._appearance = config;\n    return this;\n  }\n\n  chartTypeConfig(config: ChartTypeConfig): this {\n    this._chartTypeConfig = config;\n    return this;\n  }\n\n  /**\n   * Declare an explicit runtime input for this chart.\n   *\n   * Inputs replace raw caller-provided filter fragments with an authored\n   * contract that can only bind into approved query seams.\n   */\n  input(definition: ChartInputDefinition): this {\n    if (!this._inputs) {\n      this._inputs = [];\n    }\n\n    this._inputs.push(definition);\n    return this;\n  }\n\n  /**\n   * Set i18n labelling keys for chart-level text (title, axes, tooltips, split values).\n   * When resolved at render time, these keys replace hardcoded text with translated strings.\n   */\n  i18n(config: NonNullable<ChartDefinition['i18n']>): this {\n    this._i18n = config;\n    return this;\n  }\n\n  // ── Build ──\n\n  build(): ChartDefinition {\n    // Validate computed measure dependsOn refs against actual measure refs\n    if (this._computedMeasures.length > 0) {\n      const measureRefs = new Set(this._measures.map(m => m.ref));\n      // Also include other computed measure refs (for chained computations)\n      const computedRefs = new Set(this._computedMeasures.map(cm => cm.ref));\n\n      for (const cm of this._computedMeasures) {\n        for (const dep of cm.dependsOn) {\n          // Guard: a computed measure cannot reference itself\n          if (dep === cm.ref) {\n            throw new Error(\n              `ChartDefinitionBuilder: computed measure '${cm.ref}' references itself in dependsOn. ` +\n              `Self-referencing computed measures are not supported.`,\n            );\n          }\n          if (!measureRefs.has(dep) && !computedRefs.has(dep)) {\n            throw new Error(\n              `ChartDefinitionBuilder: computed measure '${cm.ref}' depends on '${dep}', ` +\n              `but no measure or computed measure with that ref exists. ` +\n              `Available measure refs: [${[...measureRefs].join(', ')}]`,\n            );\n          }\n        }\n      }\n    }\n\n    // Auto-generate series from measures if none were explicitly defined\n    const series = this._series.length > 0\n      ? this._series\n      : this._autoGenerateSeries();\n\n    // Apply splitByDimension to auto-generated series\n    const finalSeries = series.map(s => ({\n      ...s,\n      splitByDimension: s.splitByDimension ?? this._splitByDimension,\n      splitConfig: s.splitConfig ?? this._splitConfig,\n    }));\n\n    const dataQuery: AggregationQuery = {\n      mainResourceType: this._mainResourceType,\n      dimensions: this._dimensions,\n      measures: this._measures,\n      filters: this._filters,\n      contextFilters: this._contextFilters.length > 0 ? this._contextFilters : undefined,\n      computedMeasures: this._computedMeasures.length > 0 ? this._computedMeasures : undefined,\n      windowFunctions: this._windowFunctions.length > 0 ? this._windowFunctions : undefined,\n      joins: this._joins.length > 0 ? this._joins : undefined,\n      having: this._having.length > 0 ? this._having : undefined,\n      timezone: this._timezone,\n      limit: this._limit,\n      orderBy: this._orderBy,\n    };\n\n    const definition: Record<string, unknown> = {\n      ref: this._ref,\n      chartType: this._chartType,\n      dataQuery,\n      series: finalSeries,\n      inputs: this._inputs,\n      accessControl: this._accessControl,\n      refreshInterval: this._refreshInterval,\n      appearance: this._appearance,\n      chartTypeConfig: this._chartTypeConfig,\n      i18n: this._i18n,\n    };\n\n    const parsed = ChartDefinitionSchema.parse(definition);\n    return parsed as ChartDefinition;\n  }\n\n  // ── Private helpers ──\n\n  private _autoGenerateSeries(): ChartSeriesDefinition[] {\n    return this._measures.map(measure => ({\n      ref: `${measure.ref}_series`,\n      name: measure.label || measure.ref,\n      measureRef: measure.ref,\n    }));\n  }\n}\n\n// ── Factory function ─────────────────────────────────────────\n\n/**\n * Create a ChartDefinitionBuilder.\n *\n * @param ref - Unique chart reference used for registry lookup and the backend data endpoint `/charts/:chartRef/data`\n * @param mainResourceType - Primary resource type for the data query\n *\n * @example\n * ```ts\n * const chart = chartBuilder('orders-per-month', 'ORDERS')\n *   .type(ChartType.BAR)\n *   .timeDimension('createdAt', TimeGranularity.MONTH)\n *   .count()\n *   .build();\n * ```\n */\nexport function chartBuilder(ref: string, mainResourceType: string): ChartDefinitionBuilder {\n  return new ChartDefinitionBuilder(ref, mainResourceType);\n}\n"]}
+{"version":3,"file":"chart-definition-builder.shared.js","sourceRoot":"","sources":["../../../src/charts/chart-definition-builder.shared.ts"],"names":[],"mappings":"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","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * ChartDefinitionBuilder — Fluent API for building ChartDefinitions\n *\n * Pure function that constructs a ChartDefinition object and validates\n * it against the schema. No backend/frontend deps.\n *\n * View wiring (scope, addressability, launcher) is composed separately\n * in frontend presets/config via InsertedChartDeclaration in saas-frontend-lib.\n * Charts are resource-owned inserted surfaces only; there is no app-level\n * chart view type.\n *\n * Usage:\n *   chartBuilder('orders-per-month', 'ORDERS')\n *     .type(ChartType.BAR)\n *     .timeDimension('createdAt', TimeGranularity.MONTH)\n *     .count()\n *     .build()\n * ────────────────────────────────────────────────────────────── */\n\nimport {\n  ChartType,\n  ChartDefinitionSchema,\n  type ChartDefinition,\n  type ChartSeriesDefinition,\n  type ChartAccessControl,\n  type ChartInputDefinition,\n  type ChartSplitConfig,\n  type ChartSeriesStyle,\n  type ChartAppearance,\n  type ChartTypeConfig,\n} from '../config/frontend/chart-definition.shared.schemas';\nimport {\n  AggregateFunction,\n  TimeGranularity,\n  ComparisonOperator,\n  ContextFilterSource,\n  SortDirection,\n  DimensionSortBy,\n  JoinType,\n  WindowFunctionType,\n} from './aggregation.shared.definitions';\nimport type {\n  Measure,\n  Dimension,\n  ContextFilter,\n  ResourceJoin,\n  HavingClause,\n  ComputedMeasure,\n  WindowFunction,\n  AggregationQuery,\n} from './aggregation-query.shared.schemas';\n\n// ── Builder Options Types ────────────────────────────────────\n\nexport interface MeasureOptions {\n  label?: string;\n  filter?: Record<string, unknown>;\n}\n\nexport interface DimensionOptions {\n  label?: string;\n  sort?: {\n    direction?: SortDirection;\n    by?: 'self' | 'measure';\n    measureRef?: string;\n  };\n  topN?: number;\n  groupOther?: boolean;\n}\n\nexport interface TimeDimensionOptions extends DimensionOptions {\n  fillMissingBuckets?: boolean;\n  dateRange?: { from?: string; to?: string };\n}\n\nexport interface SeriesOptions {\n  chartType?: ChartType;\n  yAxisIndex?: number;\n  style?: Partial<ChartSeriesStyle>;\n  hidden?: boolean;\n}\n\nexport interface JoinOptions {\n  selectFields?: string[];\n  joinType?: JoinType;\n}\n\nexport interface WindowFunctionOptions {\n  label?: string;\n  windowSize?: number;\n  partitionBy?: string;\n  orderBy?: string;\n}\n\n// ── Builder Class ────────────────────────────────────────────\n\nexport class ChartDefinitionBuilder {\n  private _chartType: ChartType = ChartType.BAR;\n  private _dimensions: Dimension[] = [];\n  private _measures: Measure[] = [];\n  private _series: ChartSeriesDefinition[] = [];\n  private _contextFilters: ContextFilter[] = [];\n  private _joins: ResourceJoin[] = [];\n  private _filters?: Record<string, unknown>;\n  private _accessControl?: ChartAccessControl;\n  private _refreshInterval?: number;\n  private _timezone?: string;\n  private _limit?: number;\n  private _orderBy?: Array<{ ref: string; direction: SortDirection }>;\n  private _splitByDimension?: string;\n  private _splitConfig?: ChartSplitConfig;\n  private _having: HavingClause[] = [];\n  private _computedMeasures: ComputedMeasure[] = [];\n  private _windowFunctions: WindowFunction[] = [];\n  private _appearance?: ChartAppearance;\n  private _chartTypeConfig?: ChartTypeConfig;\n  private _i18n?: ChartDefinition['i18n'];\n  private _inputs?: ChartInputDefinition[];\n\n  constructor(\n    private readonly _ref: string,\n    private readonly _mainResourceType: string,\n  ) {}\n\n  // ── Chart type ──\n\n  type(chartType: ChartType): this {\n    this._chartType = chartType;\n    return this;\n  }\n\n  // ── Dimensions ──\n\n  dimension(field: string, options?: DimensionOptions): this {\n    const ref = options?.label?.toLowerCase().replace(/\\s+/g, '_') || field;\n    this._dimensions.push({\n      ref,\n      field,\n      label: options?.label,\n      sort: options?.sort ? {\n        direction: options.sort.direction ?? SortDirection.ASC,\n        by: options.sort.by === 'measure' ? DimensionSortBy.MEASURE : DimensionSortBy.SELF,\n        measureRef: options.sort.measureRef,\n      } : undefined,\n      topN: options?.topN,\n      groupOther: options?.groupOther,\n    });\n    return this;\n  }\n\n  timeDimension(field: string, granularity: TimeGranularity, options?: TimeDimensionOptions): this {\n    const ref = options?.label?.toLowerCase().replace(/\\s+/g, '_') || field;\n    this._dimensions.push({\n      ref,\n      field,\n      label: options?.label,\n      timeGranularity: granularity,\n      fillMissingBuckets: options?.fillMissingBuckets ?? true, // default: true for time dimensions\n      dateRange: options?.dateRange,\n      sort: options?.sort ? {\n        direction: options.sort.direction ?? SortDirection.ASC,\n        by: options.sort.by === 'measure' ? DimensionSortBy.MEASURE : DimensionSortBy.SELF,\n        measureRef: options.sort.measureRef,\n      } : undefined,\n      topN: options?.topN,\n      groupOther: options?.groupOther,\n    });\n    return this;\n  }\n\n  // ── Measures (shorthands) ──\n\n  count(options?: MeasureOptions): this {\n    return this.measure('*', AggregateFunction.COUNT, {\n      ...options,\n      label: options?.label ?? 'Count',\n    });\n  }\n\n  sum(field: string, options?: MeasureOptions): this {\n    return this.measure(field, AggregateFunction.SUM, options);\n  }\n\n  avg(field: string, options?: MeasureOptions): this {\n    return this.measure(field, AggregateFunction.AVG, options);\n  }\n\n  min(field: string, options?: MeasureOptions): this {\n    return this.measure(field, AggregateFunction.MIN, options);\n  }\n\n  max(field: string, options?: MeasureOptions): this {\n    return this.measure(field, AggregateFunction.MAX, options);\n  }\n\n  measure(field: string, aggregate: AggregateFunction, options?: MeasureOptions): this {\n    const ref = field === '*' ? `*_${aggregate}` : `${field}_${aggregate}`;\n    this._measures.push({\n      ref,\n      field,\n      aggregate,\n      label: options?.label,\n      filter: options?.filter,\n    });\n    return this;\n  }\n\n  // ── Series (explicit) ──\n\n  series(ref: string, name: string, measureRef: string, options?: SeriesOptions): this {\n    const series: ChartSeriesDefinition = {\n      ref,\n      name,\n      measureRef,\n      chartType: options?.chartType,\n      yAxisIndex: options?.yAxisIndex,\n      hidden: options?.hidden,\n      style: options?.style ? { ...options.style } : undefined,\n    };\n    this._series.push(series);\n    return this;\n  }\n\n  // ── Split by dimension ──\n\n  splitBy(dimensionRef: string, config?: ChartSplitConfig): this {\n    this._splitByDimension = dimensionRef;\n    this._splitConfig = config;\n    return this;\n  }\n\n  // ── Access control ──\n\n  accessControl(config: ChartAccessControl): this {\n    this._accessControl = config;\n    return this;\n  }\n\n  // ── Filters ──\n\n  contextFilter(field: string, source: ContextFilterSource, options?: { operator?: ComparisonOperator; sourceField?: string }): this {\n    this._contextFilters.push({\n      field,\n      operator: options?.operator ?? ComparisonOperator.EQ,\n      source,\n      sourceField: options?.sourceField,\n    });\n    return this;\n  }\n\n  filter(filters: Record<string, unknown>): this {\n    this._filters = filters;\n    return this;\n  }\n\n  // ── Computed measures (post-aggregation) ──\n\n  /**\n   * Add a computed measure that evaluates an expression using other measure refs as variables.\n   *\n   * @param ref - Unique ref for this computed measure\n   * @param expression - Safe expression using measure refs (e.g., \"completed / total * 100\")\n   * @param dependsOn - Measure refs referenced in the expression\n   * @param label - Optional display label\n   *\n   * @example\n   * ```ts\n   * .count({ label: 'Total' })                     // ref: \"*_count\"\n   * .measure('status', AggregateFunction.COUNT, {   // ref: \"status_count\"\n   *   label: 'Completed',\n   *   filter: { status: 'completed' }\n   * })\n   * .computedMeasure('completion_rate', 'round(status_count / *_count * 100, 1)', ['status_count', '*_count'])\n   * ```\n   */\n  computedMeasure(ref: string, expression: string, dependsOn: string[], label?: string): this {\n    this._computedMeasures.push({\n      ref,\n      expression,\n      dependsOn,\n      label,\n    });\n    return this;\n  }\n\n  // ── Window functions (post-aggregation transforms) ──\n\n  /**\n   * Generic window function.\n   */\n  windowFunction(ref: string, sourceRef: string, type: WindowFunctionType, options?: WindowFunctionOptions): this {\n    this._windowFunctions.push({\n      ref,\n      sourceRef,\n      type,\n      label: options?.label,\n      windowSize: options?.windowSize,\n      partitionBy: options?.partitionBy,\n      orderBy: options?.orderBy,\n    });\n    return this;\n  }\n\n  /**\n   * Shorthand: running total (cumulative sum).\n   */\n  runningTotal(ref: string, sourceRef: string, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.RUNNING_TOTAL, options);\n  }\n\n  /**\n   * Shorthand: percent change from previous row.\n   */\n  percentChange(ref: string, sourceRef: string, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.PERCENT_CHANGE, options);\n  }\n\n  /**\n   * Shorthand: moving average over a window of N rows.\n   *\n   * @param windowSize - Number of rows in the moving window (default: 3)\n   */\n  movingAvg(ref: string, sourceRef: string, windowSize?: number, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.MOVING_AVG, {\n      ...options,\n      windowSize: windowSize ?? 3,\n    });\n  }\n\n  /**\n   * Shorthand: percent of total (value / sum * 100).\n   */\n  percentOfTotal(ref: string, sourceRef: string, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.PERCENT_OF_TOTAL, options);\n  }\n\n  /**\n   * Shorthand: difference from previous row.\n   */\n  difference(ref: string, sourceRef: string, options?: Omit<WindowFunctionOptions, 'windowSize'>): this {\n    return this.windowFunction(ref, sourceRef, WindowFunctionType.DIFFERENCE, options);\n  }\n\n  // ── Cross-resource joins ──\n\n  join(resourceType: string, fkField: string, alias: string, options?: JoinOptions): this {\n    this._joins.push({\n      resourceType,\n      foreignKeyField: fkField,\n      alias,\n      selectFields: options?.selectFields,\n      joinType: options?.joinType ?? JoinType.LEFT,\n    });\n    return this;\n  }\n\n  // ── HAVING (filter on aggregated values) ──\n\n  /**\n   * Add a HAVING clause to filter on aggregated measure values.\n   *\n   * @param measureRef - Ref of the measure to filter on\n   * @param operator - Comparison operator (GT, GTE, LT, LTE, EQ, NEQ)\n   * @param value - Numeric value to compare against\n   *\n   * @example\n   * ```ts\n   * .count()\n   * .having('*_COUNT', ComparisonOperator.GT, 10)  // Only groups with count > 10\n   * ```\n   */\n  having(measureRef: string, operator: ComparisonOperator, value: number): this {\n    this._having.push({ measureRef, operator, value });\n    return this;\n  }\n\n  // ── Binned dimension shorthand ──\n\n  /**\n   * Add a numeric dimension with binning (step-based or boundary-based).\n   *\n   * @example\n   * ```ts\n   * // Step-based: 0-10, 10-20, 20-30, ...\n   * .binDimension('age', { step: 10 })\n   *\n   * // Boundary-based: <0, 0-50, 50-100, 100-500, ≥500\n   * .binDimension('price', { boundaries: [0, 50, 100, 500] })\n   * ```\n   */\n  binDimension(field: string, bin: { step: number } | { boundaries: number[] }, options?: DimensionOptions): this {\n    const ref = options?.label?.toLowerCase().replace(/\\s+/g, '_') || field;\n    this._dimensions.push({\n      ref,\n      field,\n      label: options?.label,\n      bin,\n      sort: options?.sort ? {\n        direction: options.sort.direction ?? SortDirection.ASC,\n        by: options.sort.by === 'measure' ? DimensionSortBy.MEASURE : DimensionSortBy.SELF,\n        measureRef: options.sort.measureRef,\n      } : undefined,\n      topN: options?.topN,\n      groupOther: options?.groupOther,\n    });\n    return this;\n  }\n\n  // ── Result shaping ──\n\n  timezone(tz: string): this {\n    this._timezone = tz;\n    return this;\n  }\n\n  refreshInterval(ms: number): this {\n    this._refreshInterval = ms;\n    return this;\n  }\n\n  limitResults(n: number): this {\n    this._limit = n;\n    return this;\n  }\n\n  orderBy(ref: string, direction: SortDirection = SortDirection.ASC): this {\n    if (!this._orderBy) this._orderBy = [];\n    this._orderBy.push({ ref, direction });\n    return this;\n  }\n\n  // ── Appearance & type config ──\n\n  appearance(config: ChartAppearance): this {\n    this._appearance = config;\n    return this;\n  }\n\n  chartTypeConfig(config: ChartTypeConfig): this {\n    this._chartTypeConfig = config;\n    return this;\n  }\n\n  /**\n   * Declare an explicit runtime input for this chart.\n   *\n   * Inputs replace raw caller-provided filter fragments with an authored\n   * contract that can only bind into approved query seams.\n   */\n  input(definition: ChartInputDefinition): this {\n    if (!this._inputs) {\n      this._inputs = [];\n    }\n\n    this._inputs.push(definition);\n    return this;\n  }\n\n  /**\n   * Set i18n labelling keys for chart-level text (title, axes, tooltips, split values).\n   * When resolved at render time, these keys replace hardcoded text with translated strings.\n   */\n  i18n(config: NonNullable<ChartDefinition['i18n']>): this {\n    this._i18n = config;\n    return this;\n  }\n\n  // ── Build ──\n\n  build(): ChartDefinition {\n    // Validate computed measure dependsOn refs against actual measure refs\n    if (this._computedMeasures.length > 0) {\n      const measureRefs = new Set(this._measures.map(m => m.ref));\n      // Also include other computed measure refs (for chained computations)\n      const computedRefs = new Set(this._computedMeasures.map(cm => cm.ref));\n\n      for (const cm of this._computedMeasures) {\n        for (const dep of cm.dependsOn) {\n          // Guard: a computed measure cannot reference itself\n          if (dep === cm.ref) {\n            throw new Error(\n              `ChartDefinitionBuilder: computed measure '${cm.ref}' references itself in dependsOn. ` +\n              `Self-referencing computed measures are not supported.`,\n            );\n          }\n          if (!measureRefs.has(dep) && !computedRefs.has(dep)) {\n            throw new Error(\n              `ChartDefinitionBuilder: computed measure '${cm.ref}' depends on '${dep}', ` +\n              `but no measure or computed measure with that ref exists. ` +\n              `Available measure refs: [${[...measureRefs].join(', ')}]`,\n            );\n          }\n        }\n      }\n    }\n\n    // Auto-generate series from measures if none were explicitly defined\n    const series = this._series.length > 0\n      ? this._series\n      : this._autoGenerateSeries();\n\n    // Apply splitByDimension to auto-generated series\n    const finalSeries = series.map(s => ({\n      ...s,\n      splitByDimension: s.splitByDimension ?? this._splitByDimension,\n      splitConfig: s.splitConfig ?? this._splitConfig,\n    }));\n\n    const dataQuery: AggregationQuery = {\n      mainResourceType: this._mainResourceType,\n      dimensions: this._dimensions,\n      measures: this._measures,\n      filters: this._filters,\n      contextFilters: this._contextFilters.length > 0 ? this._contextFilters : undefined,\n      computedMeasures: this._computedMeasures.length > 0 ? this._computedMeasures : undefined,\n      windowFunctions: this._windowFunctions.length > 0 ? this._windowFunctions : undefined,\n      joins: this._joins.length > 0 ? this._joins : undefined,\n      having: this._having.length > 0 ? this._having : undefined,\n      timezone: this._timezone,\n      limit: this._limit,\n      orderBy: this._orderBy,\n    };\n\n    const definition: Record<string, unknown> = {\n      ref: this._ref,\n      chartType: this._chartType,\n      dataQuery,\n      series: finalSeries,\n      inputs: this._inputs,\n      accessControl: this._accessControl,\n      refreshInterval: this._refreshInterval,\n      appearance: this._appearance,\n      chartTypeConfig: this._chartTypeConfig,\n      i18n: this._i18n,\n    };\n\n    const parsed = ChartDefinitionSchema.parse(definition);\n    return parsed as ChartDefinition;\n  }\n\n  // ── Private helpers ──\n\n  private _autoGenerateSeries(): ChartSeriesDefinition[] {\n    return this._measures.map(measure => ({\n      ref: `${measure.ref}_series`,\n      name: measure.label || measure.ref,\n      measureRef: measure.ref,\n    }));\n  }\n}\n\n// ── Factory function ─────────────────────────────────────────\n\n/**\n * Create a ChartDefinitionBuilder.\n *\n * @param ref - Unique chart reference used for registry lookup and the backend data endpoint `/charts/:chartRef/data`\n * @param mainResourceType - Primary resource type for the data query\n *\n * @example\n * ```ts\n * const chart = chartBuilder('orders-per-month', 'ORDERS')\n *   .type(ChartType.BAR)\n *   .timeDimension('createdAt', TimeGranularity.MONTH)\n *   .count()\n *   .build();\n * ```\n */\nexport function chartBuilder(ref: string, mainResourceType: string): ChartDefinitionBuilder {\n  return new ChartDefinitionBuilder(ref, mainResourceType);\n}\n"]}

package/dist/esm/companion/artifact-placement.shared.definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-placement.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/companion/artifact-placement.shared.definitions.ts"],"names":[],"mappings":"AAAA,oBAAY,sBAAsB;IAChC,aAAa,kBAAkB;IAC/B,MAAM,WAAW;IACjB,aAAa,kBAAkB;CAChC;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,sBAAsB,CAAC;IACtC,WAAW,EAAE,+BAA+B,CAAC;CAC9C;AAED,MAAM,WAAW,oCACf,SAAQ,oCAAoC;IAC5C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,yCACf,SAAQ,oCAAoC;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}
+{"version":3,"file":"artifact-placement.shared.definitions.d.ts","sourceRoot":"","sources":["../../../src/companion/artifact-placement.shared.definitions.ts"],"names":[],"mappings":"AAAA,oBAAY,sBAAsB;IAChC,aAAa,kBAAkB;IAC/B,MAAM,WAAW;IACjB,aAAa,kBAAkB;CAChC;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,sBAAsB,CAAC;IACtC,WAAW,EAAE,+BAA+B,CAAC;CAC9C;AAED,MAAM,WAAW,oCACf,SAAQ,oCAAoC;IAC5C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,yCACf,SAAQ,oCAAoC;IAC5C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/esm/companion/artifact-placement.shared.definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact-placement.shared.definitions.js","sourceRoot":"","sources":["../../../../src/companion/artifact-placement.shared.definitions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,yDAA+B,CAAA;IAC/B,2CAAiB,CAAA;IACjB,yDAA+B,CAAA;AACjC,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC","sourcesContent":["export enum CompanionArtifactClass {\n  DOMAIN_MODULE = 'domain-module',\n  ENGINE = 'engine',\n  FRONTEND_ONLY = 'frontend-only',\n}\n\nexport interface CompanionArtifactPlacementRoots {\n  shared?: string;\n  backend?: string;\n  frontend?: string;\n}\n\n/**\n * Tooling-facing ownership descriptor for generated artifacts such as\n * translations or email label files.\n *\n * `ownerId` is intentionally broader than `moduleId`: some generated artifacts\n * belong to engine/frontend-only buckets that are not business\n * modules, but still need a stable owner identity and placement contract.\n */\nexport interface CompanionArtifactPlacementDescriptor {\n  ownerId: string;\n  artifactClass: CompanionArtifactClass;\n  rootsByRole: CompanionArtifactPlacementRoots;\n}\n\nexport interface CompanionResourceOwnershipDescriptor\n  extends CompanionArtifactPlacementDescriptor {\n  resourceTypes: string[];\n}\n\nexport interface CompanionEmailTemplateOwnershipDescriptor\n  extends CompanionArtifactPlacementDescriptor {\n  templateRefs: string[];\n}\n"]}
+{"version":3,"file":"artifact-placement.shared.definitions.js","sourceRoot":"","sources":["../../../src/companion/artifact-placement.shared.definitions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,yDAA+B,CAAA;IAC/B,2CAAiB,CAAA;IACjB,yDAA+B,CAAA;AACjC,CAAC,EAJW,sBAAsB,KAAtB,sBAAsB,QAIjC","sourcesContent":["export enum CompanionArtifactClass {\n  DOMAIN_MODULE = 'domain-module',\n  ENGINE = 'engine',\n  FRONTEND_ONLY = 'frontend-only',\n}\n\nexport interface CompanionArtifactPlacementRoots {\n  shared?: string;\n  backend?: string;\n  frontend?: string;\n}\n\n/**\n * Tooling-facing ownership descriptor for generated artifacts such as\n * translations or email label files.\n *\n * `ownerId` is intentionally broader than `moduleId`: some generated artifacts\n * belong to engine/frontend-only buckets that are not business\n * modules, but still need a stable owner identity and placement contract.\n */\nexport interface CompanionArtifactPlacementDescriptor {\n  ownerId: string;\n  artifactClass: CompanionArtifactClass;\n  rootsByRole: CompanionArtifactPlacementRoots;\n}\n\nexport interface CompanionResourceOwnershipDescriptor\n  extends CompanionArtifactPlacementDescriptor {\n  resourceTypes: string[];\n}\n\nexport interface CompanionEmailTemplateOwnershipDescriptor\n  extends CompanionArtifactPlacementDescriptor {\n  templateRefs: string[];\n}\n"]}

package/dist/esm/companion/provider-discovery.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-discovery.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/companion/provider-discovery.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAE5F,OAAO,EAAgD,YAAY,EAAE,MAAM,wDAAwD,CAAC;AAGpI;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0CAA0C;;;kBAGrD,CAAC;AACH,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;AAE9G,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;4BAgB/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAElG;;;;;;GAMG;AACH,eAAO,MAAM,sCAAsC;;;;;kBAKjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC;;;;;mBA+B5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC;;IAE9C;;;;;;OAMG;;;;;;;;;;;;;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;IAOH;;;;;;;;;;;OAWG;;IAEH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;IAEH;;;;;;;;OAQG;;;;;;IAMH;;;;;;;OAOG;;IAEH;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;;;;;iBAEH,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sCAAsC;IACjD,wGAAwG;;IAExG,0EAA0E;;IAE1E,yFAAyF;;;;;;;;;;IAGzF,iGAAiG;;IAEjG,mFAAmF;;IAEnF,gGAAgG;;iBAUhG,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG,MAAM,WAAW,4BAA4B;IAC3C,qBAAqB,CAAC,EAAE,6BAA6B,EAAE,CAAC;IACxD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,gCAAgC,EAAE,CAAC;CAC5D"}
+{"version":3,"file":"provider-discovery.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/companion/provider-discovery.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAE5F,OAAO,EAAgD,YAAY,EAAE,MAAM,wDAAwD,CAAC;AAGpI;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0CAA0C;;;kBAGrD,CAAC;AACH,MAAM,MAAM,oCAAoC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;AAE9G,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;4BAgB/C,CAAC;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;AAElG;;;;;;GAMG;AACH,eAAO,MAAM,sCAAsC;;;;;kBAKjD,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG;;;;;;;;;GASG;AACH,eAAO,MAAM,iCAAiC;;;;;mBA+B5C,CAAC;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F;;;;;;;;;GASG;AACH,eAAO,MAAM,mCAAmC;;IAE9C;;;;;;OAMG;;;;;;;;;;;;;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;IAOH;;;;;;;;;;;OAWG;;IAEH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEH;;;OAGG;;IAEH;;;;;;;;OAQG;;;;;;IAMH;;;;;;;OAOG;;IAEH;;;;;;;;OAQG;;;;;;;;;;;;;;;;;;;;;;;iBAEH,CAAC;AACH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sCAAsC;IACjD,wGAAwG;;IAExG,0EAA0E;;IAE1E,yFAAyF;;;;;;;;;;IAGzF,iGAAiG;;IAEjG,mFAAmF;;IAEnF,gGAAgG;;iBAUhG,CAAC;AACH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAEtG,MAAM,WAAW,4BAA4B;IAC3C,qBAAqB,CAAC,EAAE,6BAA6B,EAAE,CAAC;IACxD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,gCAAgC,EAAE,CAAC;CAC5D"}

package/dist/esm/companion/provider-discovery.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-discovery.shared.schemas.js","sourceRoot":"","sources":["../../../../src/companion/provider-discovery.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { AppFrontendType } from '../config/app-frontend-type.shared.schemas';\nimport { EngineCapability } from '../external-providers/engine-capabilities.shared.schemas';\nimport { FrontendProviderEntrySchema } from '../external-providers/frontend-bootstrap.shared.schemas';\nimport { ProviderIdentitySchema, ProviderOriginSchema, ProviderTier } from '../external-providers/provider-metadata.shared.schemas';\nimport { ProviderComplianceProfileSchema } from '../external-providers/provider-compliance-profile.shared.schemas';\n\n/**\n * Companion-safe provider implementation declaration.\n *\n * App/runtime-owner packages expose these entries through their `./companion`\n * default export so tooling can discover which provider refs are actually\n * reachable from which runtime owners before materializing generated artifacts.\n */\n\n/**\n * Discriminator branch for `frontendService` runtime targets.\n *\n * Targets a frontend service by its `AppFrontendType` (the closed kind set\n * — SAAS_APP, STATIC_WEBSITE, TECH_DOC) rather than by an app-defined\n * `serviceKey` string. Engine-shipped packages (`external-connectors-public`,\n * etc.) have no way to know app-defined service keys, so the discovery\n * contract is keyed on the type. Apps with multiple frontend services of\n * the same type currently broadcast the contribution to all of them; if\n * per-service-key targeting becomes a need, add a second variant.\n */\nexport const ProviderFrontendServiceRuntimeTargetSchema = z.strictObject({\n  kind: z.literal('frontendService'),\n  serviceType: z.enum(AppFrontendType),\n});\nexport type ProviderFrontendServiceRuntimeTarget = z.infer<typeof ProviderFrontendServiceRuntimeTargetSchema>;\n\nexport const ProviderCompanionRuntimeTargetSchema = z.discriminatedUnion('kind', [\n  z.strictObject({\n    kind: z.literal('backend'),\n  }),\n  z.strictObject({\n    kind: z.literal('companion'),\n  }),\n  ProviderFrontendServiceRuntimeTargetSchema,\n  z.strictObject({\n    kind: z.literal('minion'),\n    minionKey: z.string().min(1),\n  }),\n  z.strictObject({\n    kind: z.literal('worker'),\n    workerKey: z.string().min(1),\n  }),\n]);\nexport type ProviderCompanionRuntimeTarget = z.infer<typeof ProviderCompanionRuntimeTargetSchema>;\n\n/**\n * Values-free projection of one backend provider secret requirement.\n *\n * The stable provider-owned `slug` is preserved separately from the concrete\n * environment-variable name so a rename on either axis changes the lockfile\n * integrity digest. Secret values never cross this companion-safe boundary.\n */\nexport const ProviderSecretContractShapeEntrySchema = z.strictObject({\n  slug: z.string().min(1),\n  envVarName: z.string().min(1),\n  required: z.boolean(),\n  description: z.string().min(1),\n});\nexport type ProviderSecretContractShapeEntry = z.infer<typeof ProviderSecretContractShapeEntrySchema>;\n\n/**\n * Deterministic, values-free secret-contract shape used by provider discovery\n * and lockfile integrity checks.\n *\n * Every contribution must declare this field. `[]` means the provider is\n * authoritatively known to require no secrets; omission is rejected rather\n * than being silently interpreted as an empty contract. Entries must be\n * sorted by `slug`, and both slugs and environment-variable names are unique,\n * so independently contributed facets cannot produce order-dependent digests.\n */\nexport const ProviderSecretContractShapeSchema = z.array(ProviderSecretContractShapeEntrySchema).superRefine((entries, context) => {\n  const seenSlugs = new Set<string>();\n  const seenEnvVarNames = new Set<string>();\n\n  for (const [index, entry] of entries.entries()) {\n    if (seenSlugs.has(entry.slug)) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'slug'],\n        message: `Duplicate provider secret-contract slug \"${entry.slug}\".`,\n      });\n    }\n    seenSlugs.add(entry.slug);\n\n    if (seenEnvVarNames.has(entry.envVarName)) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'envVarName'],\n        message: `Duplicate provider secret-contract envVarName \"${entry.envVarName}\".`,\n      });\n    }\n    seenEnvVarNames.add(entry.envVarName);\n\n    if (index > 0 && entries[index - 1].slug.localeCompare(entry.slug) >= 0) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'slug'],\n        message: 'Provider secret-contract entries must be sorted by slug.',\n      });\n    }\n  }\n});\nexport type ProviderSecretContractShape = z.infer<typeof ProviderSecretContractShapeSchema>;\n\n/**\n * A contribution is a wire record produced by one package version and read by\n * another (the CLI, the companion, a generated artifact), so it is a LOOSE\n * object: an additive field from a newer producer rides through an older\n * consumer instead of hard-failing the parse (#328 — it used to be strict,\n * which made every additive field a five-surface change and every old/new\n * mix a boot failure). Required fields stay required; only UNKNOWN keys are\n * tolerated, and they are kept rather than stripped so a re-emitting\n * consumer does not silently drop what it did not understand.\n */\nexport const ProviderCompanionContributionSchema = z.looseObject({\n  ref: z.string().min(1),\n  /**\n   * The provider's identity (package, tier, vendor, origin) as declared on\n   * its module metadata, so tooling can display tiers and group vendors\n   * without loading the runtime module. Optional on the wire for one\n   * reason only: contributions emitted before #328 carry none, and a\n   * discovery walk must still read them.\n   */\n  identity: ProviderIdentitySchema.optional(),\n  /**\n   * Stable package import path that makes the provider implementation reachable\n   * from the contributing package at runtime. This validates owner-package\n   * reachability without coupling discovery to source-file paths.\n   */\n  runtimeImportPath: z.string().min(1),\n  runtimeTargets: z.array(ProviderCompanionRuntimeTargetSchema).min(1),\n  engineCapabilities: z.array(z.enum(EngineCapability)).default([]),\n  providerCapabilities: z.array(z.string().min(1)).default([]),\n  protocols: z.array(z.string().min(1)).default([]),\n  secretsContractShape: ProviderSecretContractShapeSchema,\n  /**\n   * Per protocol, the environment variable its API key is read from — the DEFAULT `authConfig.secretRef`\n   * a running host derives from the binding's runtime contract, so the value `getProviderApiKey` reads\n   * before it refuses a call for a missing key (#2229). Keyed by the same protocol strings as `protocols`;\n   * a protocol absent from the map authenticates with nothing a host must hold.\n   *\n   * Carried so tooling can predict that refusal from discovery without loading a provider module — the\n   * creation preflight names the ONE key a step needs, where `secretsContractShape` lists every key the\n   * provider may use (Stripe's webhook secret is required by its shape and read by no boot refusal).\n   * Values-free, and optional on the wire because a contribution emitted before #2229 carries none; a\n   * reader then falls back to the required entries of `secretsContractShape`.\n   */\n  protocolSecretRefs: z.record(z.string().min(1), z.string().min(1)).optional(),\n  /**\n   * Optional frontend-safe provider payload for `frontendService` runtime\n   * targets. Tooling materializes this into generated runtime artifacts so the\n   * backend bootstrap endpoint can serve app-owned public providers without\n   * importing frontend packages at runtime.\n   */\n  frontendEntry: FrontendProviderEntrySchema.optional(),\n  /**\n   * Optional app module owner when the provider implementation belongs to one\n   * concrete module instead of the whole package/runtime.\n   */\n  sourceModuleId: z.string().min(1).optional(),\n  /**\n   * The hosts the provider's OAuth2 TOKEN endpoint may resolve to (#1725) — derived by the producer with\n   * `describeProviderOAuth2TokenEndpointHosts`, absent when the provider runs no OAuth2 connected account.\n   *\n   * Carried so `wildo config sync` can refuse a declared shared connection whose member names a different\n   * authorization server than its base, without loading either module. Values-free: a login host is not a\n   * secret. Optional on the wire because a contribution emitted before #1725 carries none; the registry then\n   * makes the same comparison on the loaded modules at boot.\n   */\n  oauth2TokenEndpointHosts: z.strictObject({\n    exact: z.array(z.string().min(1)),\n    suffixes: z.array(z.string().min(1)),\n    undeterminable: z.boolean(),\n  }).optional(),\n  /**\n   * The secrets-contract SLUGS holding the provider's connected-account OAuth2 client registration — its client id\n   * and client secret (#1725). Absent when the provider runs no OAuth2 connected account.\n   *\n   * Carried so `wildo secrets` can tell an operator which registration a declared shared connection actually needs:\n   * the BASE's slots are then required, and a MEMBER's own slots are inert — reported, never required — because the\n   * base's client connects and refreshes the one grant.\n   */\n  oauth2ClientSlotSlugs: z.array(z.string().min(1)).optional(),\n  /**\n   * What the provider's BACKEND module declares about who runs it and where it processes (#1708) — ESTABLISHED\n   * facts, or UNDETERMINED. A frontend facet's profile rides `frontendEntry.complianceProfile` instead (#1743).\n   *\n   * Carried so the compliance readers (the evidence collector, the companion's drafting brief) learn every\n   * declared provider's profile from discovery, WITHOUT loading a provider module — the same reason\n   * `oauth2TokenEndpointHosts` is here. Values-free: a vendor's region list is not a secret. Optional on the wire\n   * because a contribution emitted before #1708 carries none, which a reader reports as \"no profile\".\n   */\n  complianceProfile: ProviderComplianceProfileSchema.optional(),\n});\nexport type ProviderCompanionContribution = z.infer<typeof ProviderCompanionContributionSchema>;\n\n/**\n * A package's declaration that it ADDS OPERATIONS to a provider it does not own (#1672).\n *\n * ## Why this is its own record and not a `ProviderCompanionContribution`\n *\n * A contribution says \"this package OWNS provider X\": identity, secrets contract, protocols, the runtimes\n * it reaches. Discovery keeps one owner per ref and compares every contribution's secrets-contract shape\n * against the others. An augmentation owns none of that — the base keeps identity, tier, secrets contract,\n * OAuth2 block and connection — so recording it as a second contribution of the same ref would make the\n * shape comparison treat it as a second owner, and the import map would pick one of the two by sort order.\n * A separate record is what lets the base stay the base.\n *\n * ## What it carries, and why each field is STATIC\n *\n * `operationIds` and `requiredScopes` are stated here rather than read from the catalogue because a\n * catalogue is a LAZY loader that tooling must never call (`ProviderRestOperationCatalogueLoader`). So\n * `wildo config sync` can refuse an operation-id collision and record which scopes an augmentation may ask\n * for without evaluating any vendor code; the runtime then checks that what the loader delivers is exactly\n * what was declared here, and refuses the augmentation otherwise.\n *\n * INERT until an application opts it in under `providers.augmentations.<augments>` — installing a package\n * never adds an operation to a provider on its own.\n *\n * Loose for the reason `ProviderCompanionContributionSchema` is: a newer producer's additive field must ride\n * through an older consumer.\n */\nexport const ProviderAugmentationContributionSchema = z.looseObject({\n  /** The ref of the provider this package adds operations to — owned by the engine or another package. */\n  augments: z.string().min(1),\n  /** The augmentation package's own npm name, as its manifest states it. */\n  packageName: z.string().min(1),\n  /** Always `CATALOGUE`: an augmentation binds no engine slot and adds only operations. */\n  tier: z.literal(ProviderTier.CATALOGUE),\n  origin: ProviderOriginSchema,\n  /** The specifier a host imports to read the augmentation (`<package>/backend` by convention). */\n  runtimeImportPath: z.string().min(1),\n  /** Every operation id the augmentation contributes — sorted, unique, non-empty. */\n  operationIds: z.array(z.string().min(1)).min(1),\n  /** Every vendor scope any of those operations declares in `requiredScopes` — sorted, unique. */\n  requiredScopes: z.array(z.string().min(1)).default([]),\n}).superRefine((contribution, ctx) => {\n  for (const [field, values] of [['operationIds', contribution.operationIds], ['requiredScopes', contribution.requiredScopes]] as const) {\n    for (let index = 1; index < values.length; index += 1) {\n      if (values[index - 1].localeCompare(values[index]) >= 0) {\n        ctx.addIssue({ code: 'custom', path: [field, index], message: `${field} must be sorted and unique (\"${values[index]}\" follows \"${values[index - 1]}\").` });\n      }\n    }\n  }\n});\nexport type ProviderAugmentationContribution = z.infer<typeof ProviderAugmentationContributionSchema>;\n\nexport interface RuntimeOwnerCompanionExports {\n  providerContributions?: ProviderCompanionContribution[];\n  /**\n   * Operation augmentations of providers this package does not own (#1672). Separate from\n   * `providerContributions` on purpose — see {@link ProviderAugmentationContributionSchema}.\n   */\n  providerAugmentations?: ProviderAugmentationContribution[];\n}\n"]}
+{"version":3,"file":"provider-discovery.shared.schemas.js","sourceRoot":"","sources":["../../../src/companion/provider-discovery.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { AppFrontendType } from '../config/app-frontend-type.shared.schemas';\nimport { EngineCapability } from '../external-providers/engine-capabilities.shared.schemas';\nimport { FrontendProviderEntrySchema } from '../external-providers/frontend-bootstrap.shared.schemas';\nimport { ProviderIdentitySchema, ProviderOriginSchema, ProviderTier } from '../external-providers/provider-metadata.shared.schemas';\nimport { ProviderComplianceProfileSchema } from '../external-providers/provider-compliance-profile.shared.schemas';\n\n/**\n * Companion-safe provider implementation declaration.\n *\n * App/runtime-owner packages expose these entries through their `./companion`\n * default export so tooling can discover which provider refs are actually\n * reachable from which runtime owners before materializing generated artifacts.\n */\n\n/**\n * Discriminator branch for `frontendService` runtime targets.\n *\n * Targets a frontend service by its `AppFrontendType` (the closed kind set\n * — SAAS_APP, STATIC_WEBSITE, TECH_DOC) rather than by an app-defined\n * `serviceKey` string. Engine-shipped packages (`external-connectors-public`,\n * etc.) have no way to know app-defined service keys, so the discovery\n * contract is keyed on the type. Apps with multiple frontend services of\n * the same type currently broadcast the contribution to all of them; if\n * per-service-key targeting becomes a need, add a second variant.\n */\nexport const ProviderFrontendServiceRuntimeTargetSchema = z.strictObject({\n  kind: z.literal('frontendService'),\n  serviceType: z.enum(AppFrontendType),\n});\nexport type ProviderFrontendServiceRuntimeTarget = z.infer<typeof ProviderFrontendServiceRuntimeTargetSchema>;\n\nexport const ProviderCompanionRuntimeTargetSchema = z.discriminatedUnion('kind', [\n  z.strictObject({\n    kind: z.literal('backend'),\n  }),\n  z.strictObject({\n    kind: z.literal('companion'),\n  }),\n  ProviderFrontendServiceRuntimeTargetSchema,\n  z.strictObject({\n    kind: z.literal('minion'),\n    minionKey: z.string().min(1),\n  }),\n  z.strictObject({\n    kind: z.literal('worker'),\n    workerKey: z.string().min(1),\n  }),\n]);\nexport type ProviderCompanionRuntimeTarget = z.infer<typeof ProviderCompanionRuntimeTargetSchema>;\n\n/**\n * Values-free projection of one backend provider secret requirement.\n *\n * The stable provider-owned `slug` is preserved separately from the concrete\n * environment-variable name so a rename on either axis changes the lockfile\n * integrity digest. Secret values never cross this companion-safe boundary.\n */\nexport const ProviderSecretContractShapeEntrySchema = z.strictObject({\n  slug: z.string().min(1),\n  envVarName: z.string().min(1),\n  required: z.boolean(),\n  description: z.string().min(1),\n});\nexport type ProviderSecretContractShapeEntry = z.infer<typeof ProviderSecretContractShapeEntrySchema>;\n\n/**\n * Deterministic, values-free secret-contract shape used by provider discovery\n * and lockfile integrity checks.\n *\n * Every contribution must declare this field. `[]` means the provider is\n * authoritatively known to require no secrets; omission is rejected rather\n * than being silently interpreted as an empty contract. Entries must be\n * sorted by `slug`, and both slugs and environment-variable names are unique,\n * so independently contributed facets cannot produce order-dependent digests.\n */\nexport const ProviderSecretContractShapeSchema = z.array(ProviderSecretContractShapeEntrySchema).superRefine((entries, context) => {\n  const seenSlugs = new Set<string>();\n  const seenEnvVarNames = new Set<string>();\n\n  for (const [index, entry] of entries.entries()) {\n    if (seenSlugs.has(entry.slug)) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'slug'],\n        message: `Duplicate provider secret-contract slug \"${entry.slug}\".`,\n      });\n    }\n    seenSlugs.add(entry.slug);\n\n    if (seenEnvVarNames.has(entry.envVarName)) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'envVarName'],\n        message: `Duplicate provider secret-contract envVarName \"${entry.envVarName}\".`,\n      });\n    }\n    seenEnvVarNames.add(entry.envVarName);\n\n    if (index > 0 && entries[index - 1].slug.localeCompare(entry.slug) >= 0) {\n      context.addIssue({\n        code: 'custom',\n        path: [index, 'slug'],\n        message: 'Provider secret-contract entries must be sorted by slug.',\n      });\n    }\n  }\n});\nexport type ProviderSecretContractShape = z.infer<typeof ProviderSecretContractShapeSchema>;\n\n/**\n * A contribution is a wire record produced by one package version and read by\n * another (the CLI, the companion, a generated artifact), so it is a LOOSE\n * object: an additive field from a newer producer rides through an older\n * consumer instead of hard-failing the parse (#328 — it used to be strict,\n * which made every additive field a five-surface change and every old/new\n * mix a boot failure). Required fields stay required; only UNKNOWN keys are\n * tolerated, and they are kept rather than stripped so a re-emitting\n * consumer does not silently drop what it did not understand.\n */\nexport const ProviderCompanionContributionSchema = z.looseObject({\n  ref: z.string().min(1),\n  /**\n   * The provider's identity (package, tier, vendor, origin) as declared on\n   * its module metadata, so tooling can display tiers and group vendors\n   * without loading the runtime module. Optional on the wire for one\n   * reason only: contributions emitted before #328 carry none, and a\n   * discovery walk must still read them.\n   */\n  identity: ProviderIdentitySchema.optional(),\n  /**\n   * Stable package import path that makes the provider implementation reachable\n   * from the contributing package at runtime. This validates owner-package\n   * reachability without coupling discovery to source-file paths.\n   */\n  runtimeImportPath: z.string().min(1),\n  runtimeTargets: z.array(ProviderCompanionRuntimeTargetSchema).min(1),\n  engineCapabilities: z.array(z.enum(EngineCapability)).default([]),\n  providerCapabilities: z.array(z.string().min(1)).default([]),\n  protocols: z.array(z.string().min(1)).default([]),\n  secretsContractShape: ProviderSecretContractShapeSchema,\n  /**\n   * Per protocol, the environment variable its API key is read from — the DEFAULT `authConfig.secretRef`\n   * a running host derives from the binding's runtime contract, so the value `getProviderApiKey` reads\n   * before it refuses a call for a missing key (#2229). Keyed by the same protocol strings as `protocols`;\n   * a protocol absent from the map authenticates with nothing a host must hold.\n   *\n   * Carried so tooling can predict that refusal from discovery without loading a provider module — the\n   * creation preflight names the ONE key a step needs, where `secretsContractShape` lists every key the\n   * provider may use (Stripe's webhook secret is required by its shape and read by no boot refusal).\n   * Values-free, and optional on the wire because a contribution emitted before #2229 carries none; a\n   * reader then falls back to the required entries of `secretsContractShape`.\n   */\n  protocolSecretRefs: z.record(z.string().min(1), z.string().min(1)).optional(),\n  /**\n   * Optional frontend-safe provider payload for `frontendService` runtime\n   * targets. Tooling materializes this into generated runtime artifacts so the\n   * backend bootstrap endpoint can serve app-owned public providers without\n   * importing frontend packages at runtime.\n   */\n  frontendEntry: FrontendProviderEntrySchema.optional(),\n  /**\n   * Optional app module owner when the provider implementation belongs to one\n   * concrete module instead of the whole package/runtime.\n   */\n  sourceModuleId: z.string().min(1).optional(),\n  /**\n   * The hosts the provider's OAuth2 TOKEN endpoint may resolve to (#1725) — derived by the producer with\n   * `describeProviderOAuth2TokenEndpointHosts`, absent when the provider runs no OAuth2 connected account.\n   *\n   * Carried so `wildo config sync` can refuse a declared shared connection whose member names a different\n   * authorization server than its base, without loading either module. Values-free: a login host is not a\n   * secret. Optional on the wire because a contribution emitted before #1725 carries none; the registry then\n   * makes the same comparison on the loaded modules at boot.\n   */\n  oauth2TokenEndpointHosts: z.strictObject({\n    exact: z.array(z.string().min(1)),\n    suffixes: z.array(z.string().min(1)),\n    undeterminable: z.boolean(),\n  }).optional(),\n  /**\n   * The secrets-contract SLUGS holding the provider's connected-account OAuth2 client registration — its client id\n   * and client secret (#1725). Absent when the provider runs no OAuth2 connected account.\n   *\n   * Carried so `wildo secrets` can tell an operator which registration a declared shared connection actually needs:\n   * the BASE's slots are then required, and a MEMBER's own slots are inert — reported, never required — because the\n   * base's client connects and refreshes the one grant.\n   */\n  oauth2ClientSlotSlugs: z.array(z.string().min(1)).optional(),\n  /**\n   * What the provider's BACKEND module declares about who runs it and where it processes (#1708) — ESTABLISHED\n   * facts, or UNDETERMINED. A frontend facet's profile rides `frontendEntry.complianceProfile` instead (#1743).\n   *\n   * Carried so the compliance readers (the evidence collector, the companion's drafting brief) learn every\n   * declared provider's profile from discovery, WITHOUT loading a provider module — the same reason\n   * `oauth2TokenEndpointHosts` is here. Values-free: a vendor's region list is not a secret. Optional on the wire\n   * because a contribution emitted before #1708 carries none, which a reader reports as \"no profile\".\n   */\n  complianceProfile: ProviderComplianceProfileSchema.optional(),\n});\nexport type ProviderCompanionContribution = z.infer<typeof ProviderCompanionContributionSchema>;\n\n/**\n * A package's declaration that it ADDS OPERATIONS to a provider it does not own (#1672).\n *\n * ## Why this is its own record and not a `ProviderCompanionContribution`\n *\n * A contribution says \"this package OWNS provider X\": identity, secrets contract, protocols, the runtimes\n * it reaches. Discovery keeps one owner per ref and compares every contribution's secrets-contract shape\n * against the others. An augmentation owns none of that — the base keeps identity, tier, secrets contract,\n * OAuth2 block and connection — so recording it as a second contribution of the same ref would make the\n * shape comparison treat it as a second owner, and the import map would pick one of the two by sort order.\n * A separate record is what lets the base stay the base.\n *\n * ## What it carries, and why each field is STATIC\n *\n * `operationIds` and `requiredScopes` are stated here rather than read from the catalogue because a\n * catalogue is a LAZY loader that tooling must never call (`ProviderRestOperationCatalogueLoader`). So\n * `wildo config sync` can refuse an operation-id collision and record which scopes an augmentation may ask\n * for without evaluating any vendor code; the runtime then checks that what the loader delivers is exactly\n * what was declared here, and refuses the augmentation otherwise.\n *\n * INERT until an application opts it in under `providers.augmentations.<augments>` — installing a package\n * never adds an operation to a provider on its own.\n *\n * Loose for the reason `ProviderCompanionContributionSchema` is: a newer producer's additive field must ride\n * through an older consumer.\n */\nexport const ProviderAugmentationContributionSchema = z.looseObject({\n  /** The ref of the provider this package adds operations to — owned by the engine or another package. */\n  augments: z.string().min(1),\n  /** The augmentation package's own npm name, as its manifest states it. */\n  packageName: z.string().min(1),\n  /** Always `CATALOGUE`: an augmentation binds no engine slot and adds only operations. */\n  tier: z.literal(ProviderTier.CATALOGUE),\n  origin: ProviderOriginSchema,\n  /** The specifier a host imports to read the augmentation (`<package>/backend` by convention). */\n  runtimeImportPath: z.string().min(1),\n  /** Every operation id the augmentation contributes — sorted, unique, non-empty. */\n  operationIds: z.array(z.string().min(1)).min(1),\n  /** Every vendor scope any of those operations declares in `requiredScopes` — sorted, unique. */\n  requiredScopes: z.array(z.string().min(1)).default([]),\n}).superRefine((contribution, ctx) => {\n  for (const [field, values] of [['operationIds', contribution.operationIds], ['requiredScopes', contribution.requiredScopes]] as const) {\n    for (let index = 1; index < values.length; index += 1) {\n      if (values[index - 1].localeCompare(values[index]) >= 0) {\n        ctx.addIssue({ code: 'custom', path: [field, index], message: `${field} must be sorted and unique (\"${values[index]}\" follows \"${values[index - 1]}\").` });\n      }\n    }\n  }\n});\nexport type ProviderAugmentationContribution = z.infer<typeof ProviderAugmentationContributionSchema>;\n\nexport interface RuntimeOwnerCompanionExports {\n  providerContributions?: ProviderCompanionContribution[];\n  /**\n   * Operation augmentations of providers this package does not own (#1672). Separate from\n   * `providerContributions` on purpose — see {@link ProviderAugmentationContributionSchema}.\n   */\n  providerAugmentations?: ProviderAugmentationContribution[];\n}\n"]}

package/dist/esm/companion/shared-library-companion.shared.definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared-library-companion.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/companion/shared-library-companion.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAExF,MAAM,WAAW,6BAA6B,CAC5C,aAAa,SAAS,gBAAgB,GAAG,gBAAgB,CACzD,SAAQ,4BAA4B;IACpC,iBAAiB,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CACnD"}
+{"version":3,"file":"shared-library-companion.shared.definitions.d.ts","sourceRoot":"","sources":["../../../src/companion/shared-library-companion.shared.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAExF,MAAM,WAAW,6BAA6B,CAC5C,aAAa,SAAS,gBAAgB,GAAG,gBAAgB,CACzD,SAAQ,4BAA4B;IACpC,iBAAiB,EAAE,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CACnD"}

package/dist/esm/companion/shared-library-companion.shared.definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared-library-companion.shared.definitions.js","sourceRoot":"","sources":["../../../../src/companion/shared-library-companion.shared.definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { SharedSaaSModule } from '../runtime/domain-module.shared.definitions';\nimport type { RuntimeOwnerCompanionExports } from './provider-discovery.shared.schemas';\n\nexport interface SharedLibraryCompanionExports<\n  TSharedModule extends SharedSaaSModule = SharedSaaSModule,\n> extends RuntimeOwnerCompanionExports {\n  loadSharedModules: () => Promise<TSharedModule[]>;\n}\n"]}
+{"version":3,"file":"shared-library-companion.shared.definitions.js","sourceRoot":"","sources":["../../../src/companion/shared-library-companion.shared.definitions.ts"],"names":[],"mappings":"","sourcesContent":["import type { SharedSaaSModule } from '../runtime/domain-module.shared.definitions';\nimport type { RuntimeOwnerCompanionExports } from './provider-discovery.shared.schemas';\n\nexport interface SharedLibraryCompanionExports<\n  TSharedModule extends SharedSaaSModule = SharedSaaSModule,\n> extends RuntimeOwnerCompanionExports {\n  loadSharedModules: () => Promise<TSharedModule[]>;\n}\n"]}

package/dist/esm/companion-exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"companion-exports.d.ts","sourceRoot":"","sources":["../../../src/companion-exports.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC;AAClE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,yDAAyD,CAAC"}
+{"version":3,"file":"companion-exports.d.ts","sourceRoot":"","sources":["../../src/companion-exports.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC;AAClE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,yDAAyD,CAAC"}

package/dist/esm/companion-exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"companion-exports.js","sourceRoot":"","sources":["../../../src/companion-exports.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC;AAClE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,yDAAyD,CAAC","sourcesContent":["export * from './companion/artifact-placement.shared.definitions';\nexport * from './companion/provider-discovery.shared.schemas';\nexport * from './companion/shared-library-companion.shared.definitions';\n"]}
+{"version":3,"file":"companion-exports.js","sourceRoot":"","sources":["../../src/companion-exports.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC;AAClE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,yDAAyD,CAAC","sourcesContent":["export * from './companion/artifact-placement.shared.definitions';\nexport * from './companion/provider-discovery.shared.schemas';\nexport * from './companion/shared-library-companion.shared.definitions';\n"]}

package/dist/esm/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { AuditEventCategory, AuditEventSeverity } from './auditable-events.shared.schema';
+import { AuditEventCategory, AuditEventSeverity } from './audit-event-classification.shared';
 import { CoreResourceOperation } from '../../resources/resources.shared.core.definitions';
 import { ResourceOperationRiskLevel, ResourceRelationship } from '../../resources/resources.shared.schemas';
 import { CORE_APP_ROLES } from '../../security/authorizations/roles.shared.schemas';

package/dist/esm/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application-audit-logs.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAA6B,MAAM,kCAAkC,CAAC;AAErH,OAAO,EAAE,qBAAqB,EAAwD,MAAM,mDAAmD,CAAC;AAChJ,OAAO,EAAE,0BAA0B,EAAgC,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAC1I,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AAGpF;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,EAAE,SAAS,cAAc,EAGpE,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,+DAA+D,GAC1E,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmG9C,CAAC"}
+{"version":3,"file":"application-audit-logs.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAG7F,OAAO,EAAE,qBAAqB,EAAwD,MAAM,mDAAmD,CAAC;AAChJ,OAAO,EAAE,0BAA0B,EAAgC,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAC1I,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AAGpF;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC,EAAE,SAAS,cAAc,EAGpE,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,+DAA+D,GAC1E,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqG9C,CAAC"}

package/dist/esm/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { AuditEventCategory, AuditEventSeverity, AuditableEvent_BaseSchema } from './auditable-events.shared.schema.js';
+import { AuditEventCategory, AuditEventSeverity } from './audit-event-classification.shared.js';
+import { AuditableEvent_BaseSchema } from './auditable-events.shared.schema.js';
 import { createResourceConfiguration_Initialization } from '../../resources/resources-config.shared.factory.js';
 import { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../../resources/resources.shared.core.definitions.js';
 import { ResourceOperationRiskLevel, ResourceOperationVariantType } from '../../resources/resources.shared.schemas.js';
@@ -151,7 +152,9 @@ export const applicationAuditLogsResourceConfiguration_InitializationFactory = (
                     riskLevel: ResourceOperationRiskLevel.MEDIUM,
                     /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */
                     admitsCrossTenantPlatformAdministration: true,
-                    isSearchable: true,
+                    // Filters and sorts only, like the organization audit log (#2510): it declared itself searchable over no
+                    // field, which on MongoDB ran a `$text` search against an index nothing creates.
+                    isSearchable: false,
                     searchableFields: [],
                     filterFields: {
                         applicationId: z.string(),

package/dist/esm/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"application-audit-logs.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { AuditEventCategory, AuditEventSeverity, AuditableEvent_BaseSchema } from './auditable-events.shared.schema';\nimport { createResourceConfiguration_Initialization } from '../../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourceOperationVariantType, ResourceRelationship } from '../../resources/resources.shared.schemas';\nimport { CORE_APP_ROLES } from '../../security/authorizations/roles.shared.schemas';\nimport { ResourceSystemAccessMode } from '../../resources/resources-config.shared.schemas';\n\n/**\n * The roles the application audit door's READ, LIST and SEARCH accept — ONE list, so the three verbs\n * cannot disagree about who may read the trail.\n *\n * `APP_ADMIN_SUPER_ADMIN` for the operator who investigates and then acts; `APP_AUDIT_EVIDENCE_READER`\n * for a party that must read and must NOT act — an assurance collector's machine credential, an\n * external auditor. Neither is an organization role: the rows behind this door span every tenant.\n */\nexport const APPLICATION_AUDIT_LOG_READ_ROLES: readonly CORE_APP_ROLES[] = Object.freeze([\n  CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN,\n  CORE_APP_ROLES.APP_AUDIT_EVIDENCE_READER,\n]);\n\n/**\n * The APPLICATION-scoped door onto the audit trail.\n *\n * ## Why this exists at all\n *\n * `AUDIT_LOGS` is organization-scoped and its only route is\n * `/organizations/{organizationId}/audit-logs`, so it returns exactly the rows carrying that\n * tenant. A large share of security events carry NO organization by design — `logUserLogin` takes\n * `organizationId` as optional because no organization is selected at login, and the same is true\n * of session eviction, token refresh and application-wide authentication-policy changes. Measured\n * on a dogfood application (#317): **94 of 127 rows had no organization**, and were reachable\n * through no API. An operator could see 26% of the trail and could not attest the rest, while a\n * reader querying the only available surface saw `user_login: 0` for a control that had emitted 21.\n *\n * ## Why a SEPARATE resource type rather than a second route\n *\n * `generateParentCombinations` composes every URL as\n * `[...primaryScope, ...mandatoryContext, ...optionalCombo]`, so a routed application edge on\n * `AUDIT_LOGS` would appear in EVERY combination and rewrite the organization route to\n * `/applications/{applicationId}/organizations/{organizationId}/audit-logs` — breaking all eight of\n * its documented paths and their consumers. Making the organization edge optional does not help:\n * the empty combination is skipped whenever any parent exists, so no bare route is emitted either.\n * A sibling type carrying ONE application parent takes the route it needs and leaves the existing\n * door byte-identical. The pattern is the engine's own: notification badges are dual-scope with a\n * type per scope, `APPLICATION_API_KEYS` shows the application routing shape, and `USER_SELF`\n * shows a distinct type addressing another's rows.\n *\n * ## Two doors, ONE record set — the security contract\n *\n * Both types resolve to the `auditLogs` collection through\n * `RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES`. That makes the isolation properties a\n * per-DOOR obligation rather than a property of the rows:\n *\n * - the organization door keeps its tenant filter and its organization roles, unchanged;\n * - this door accepts {@link APPLICATION_AUDIT_LOG_READ_ROLES} and nothing else — `APP_ADMIN_SUPER_ADMIN`\n *   or the read-only `APP_AUDIT_EVIDENCE_READER`. An organization role must never reach it — the rows\n *   behind it span every tenant;\n * - a read here that touches a tenant-attributed row is a CROSS-TENANT read and OWES an audit\n *   emission. **It is wired**, by the two halves below acting together, and neither is optional:\n *   each read variant declares `admitsCrossTenantPlatformAdministration`, and\n *   `ServicesRegistryHandler.recordCrossTenantReadAccess` observes every enrolled read and emits\n *   `CROSS_TENANT_ADMINISTRATIVE_ACCESS` once per TENANT the returned rows belong to. The\n *   declaration is what enrols the read: `authorizeOrganizations` — where that event is otherwise\n *   emitted — runs only for ORGANIZATIONS-scoped resources and decides on ONE fetched row, so it\n *   never sees this door at all. Grouping per tenant is what makes the crossing visible to the\n *   REACHED tenant, in its own organization-scoped viewer, rather than only to the operator.\n *   `.claude/rules/administrative-continuity-floors.md` requires every crossing to be named in the\n *   trail, and the trail is the worst possible surface on which to make an operator read invisible.\n *   See `security/authorizations/cross-tenant-read-observation.backend.ts` for why an UNDECLARED\n *   door is deliberately not observed instead of being observed with a false `admissionDeclared`.\n *\n * ## Deliberately mirrored from the organization resource\n *\n * `isSystemResource`, `systemAccessPolicy.exportSubject: FORBIDDEN` and the ABSENCE of a\n * `retentionPolicy` are copied ON PURPOSE. They are properties of the ROWS, and the rows are the\n * same ones — a second door that disagreed about whether the audit trail is subject-exportable, or\n * about how long it is kept, would be a policy fork over one record set. See the organization\n * config for the reasoning behind each; do not change one without the other.\n *\n * ## Deliberately NOT mirrored\n *\n * There is no CREATE. The organization resource carries a `REPOSITORY_ONLY` CREATE because that is\n * how audit rows are written; writing is not a scope question and must keep exactly one door.\n */\nexport const applicationAuditLogsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  undefined,\n  CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.SEARCH,\n  typeof AuditableEvent_BaseSchema\n>({\n  mainSchema: AuditableEvent_BaseSchema,\n  resourceIdentifier: CoreResourceType.APPLICATION_AUDIT_LOGS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION_AUDIT_LOGS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  /** Mirrored from the organization door — the same rows, so the same answer. Disclosing the monitoring trail to its own subject is self-defeating and out of Art. 20 scope. */\n  systemAccessPolicy: { exportSubject: ResourceSystemAccessMode.FORBIDDEN },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n  ],\n\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /**\n         * Reading ONE tenant's audit row through the application door IS a crossing, so the cheapest\n         * reach — fetch by id — is declared and audited exactly like the collection verbs. Declaring\n         * it is also what stops `assignInitiatorOrganizationConfinementToFilter` silently narrowing\n         * this door to an operator who happens to carry an ambient organization, which would make a\n         * surface documented as spanning every tenant return one tenant and report success.\n         */\n        admitsCrossTenantPlatformAdministration: true,\n      }],\n    },\n\n    [CoreResourceOperation.LIST]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */\n        admitsCrossTenantPlatformAdministration: true,\n        filterFields: {\n          applicationId: z.string(),\n          eventType: z.string(),\n          eventCategory: z.enum(AuditEventCategory),\n          severity: z.enum(AuditEventSeverity),\n          userId: z.string(),\n          /**\n           * Filterable so an operator can narrow to one tenant THROUGH this door, which is the\n           * cross-tenant investigation this surface exists for. It is a FILTER, never the isolation\n           * boundary: isolation on this door is the role gate above, and narrowing to a tenant does\n           * not make the read any less cross-tenant for audit purposes.\n           */\n          organizationId: z.string(),\n          correlationId: z.string(),\n          // #1597 — \"what did firm X do here?\": a client filters its own trail by the relationship its firm acted through.\n          actingViaServiceProviderRelationshipId: z.string(),\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        /** `eventId` last, as the keyset tie-breaker — `createdAt` is not unique under boot/seed bursts. Mirrors the organization door; removing it reintroduces a paging data-loss path. */\n        sortFields: ['createdAt', 'severity', 'eventType', 'eventId'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */\n        admitsCrossTenantPlatformAdministration: true,\n        isSearchable: true,\n        searchableFields: [],\n        filterFields: {\n          applicationId: z.string(),\n          eventType: z.string(),\n          eventCategory: z.enum(AuditEventCategory),\n          severity: z.enum(AuditEventSeverity),\n          userId: z.string(),\n          organizationId: z.string(),\n          correlationId: z.string(),\n          // #1597 — \"what did firm X do here?\": a client filters its own trail by the relationship its firm acted through.\n          actingViaServiceProviderRelationshipId: z.string(),\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        sortFields: ['createdAt', 'severity', 'eventType'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n  },\n});\n"]}
+{"version":3,"file":"application-audit-logs.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/compliance/audit-trails/application-audit-logs.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { AuditEventCategory, AuditEventSeverity } from './audit-event-classification.shared';\nimport { AuditableEvent_BaseSchema } from './auditable-events.shared.schema';\nimport { createResourceConfiguration_Initialization } from '../../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../../resources/resources.shared.core.definitions';\nimport { ResourceOperationRiskLevel, ResourceOperationVariantType, ResourceRelationship } from '../../resources/resources.shared.schemas';\nimport { CORE_APP_ROLES } from '../../security/authorizations/roles.shared.schemas';\nimport { ResourceSystemAccessMode } from '../../resources/resources-config.shared.schemas';\n\n/**\n * The roles the application audit door's READ, LIST and SEARCH accept — ONE list, so the three verbs\n * cannot disagree about who may read the trail.\n *\n * `APP_ADMIN_SUPER_ADMIN` for the operator who investigates and then acts; `APP_AUDIT_EVIDENCE_READER`\n * for a party that must read and must NOT act — an assurance collector's machine credential, an\n * external auditor. Neither is an organization role: the rows behind this door span every tenant.\n */\nexport const APPLICATION_AUDIT_LOG_READ_ROLES: readonly CORE_APP_ROLES[] = Object.freeze([\n  CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN,\n  CORE_APP_ROLES.APP_AUDIT_EVIDENCE_READER,\n]);\n\n/**\n * The APPLICATION-scoped door onto the audit trail.\n *\n * ## Why this exists at all\n *\n * `AUDIT_LOGS` is organization-scoped and its only route is\n * `/organizations/{organizationId}/audit-logs`, so it returns exactly the rows carrying that\n * tenant. A large share of security events carry NO organization by design — `logUserLogin` takes\n * `organizationId` as optional because no organization is selected at login, and the same is true\n * of session eviction, token refresh and application-wide authentication-policy changes. Measured\n * on a dogfood application (#317): **94 of 127 rows had no organization**, and were reachable\n * through no API. An operator could see 26% of the trail and could not attest the rest, while a\n * reader querying the only available surface saw `user_login: 0` for a control that had emitted 21.\n *\n * ## Why a SEPARATE resource type rather than a second route\n *\n * `generateParentCombinations` composes every URL as\n * `[...primaryScope, ...mandatoryContext, ...optionalCombo]`, so a routed application edge on\n * `AUDIT_LOGS` would appear in EVERY combination and rewrite the organization route to\n * `/applications/{applicationId}/organizations/{organizationId}/audit-logs` — breaking all eight of\n * its documented paths and their consumers. Making the organization edge optional does not help:\n * the empty combination is skipped whenever any parent exists, so no bare route is emitted either.\n * A sibling type carrying ONE application parent takes the route it needs and leaves the existing\n * door byte-identical. The pattern is the engine's own: notification badges are dual-scope with a\n * type per scope, `APPLICATION_API_KEYS` shows the application routing shape, and `USER_SELF`\n * shows a distinct type addressing another's rows.\n *\n * ## Two doors, ONE record set — the security contract\n *\n * Both types resolve to the `auditLogs` collection through\n * `RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES`. That makes the isolation properties a\n * per-DOOR obligation rather than a property of the rows:\n *\n * - the organization door keeps its tenant filter and its organization roles, unchanged;\n * - this door accepts {@link APPLICATION_AUDIT_LOG_READ_ROLES} and nothing else — `APP_ADMIN_SUPER_ADMIN`\n *   or the read-only `APP_AUDIT_EVIDENCE_READER`. An organization role must never reach it — the rows\n *   behind it span every tenant;\n * - a read here that touches a tenant-attributed row is a CROSS-TENANT read and OWES an audit\n *   emission. **It is wired**, by the two halves below acting together, and neither is optional:\n *   each read variant declares `admitsCrossTenantPlatformAdministration`, and\n *   `ServicesRegistryHandler.recordCrossTenantReadAccess` observes every enrolled read and emits\n *   `CROSS_TENANT_ADMINISTRATIVE_ACCESS` once per TENANT the returned rows belong to. The\n *   declaration is what enrols the read: `authorizeOrganizations` — where that event is otherwise\n *   emitted — runs only for ORGANIZATIONS-scoped resources and decides on ONE fetched row, so it\n *   never sees this door at all. Grouping per tenant is what makes the crossing visible to the\n *   REACHED tenant, in its own organization-scoped viewer, rather than only to the operator.\n *   `.claude/rules/administrative-continuity-floors.md` requires every crossing to be named in the\n *   trail, and the trail is the worst possible surface on which to make an operator read invisible.\n *   See `security/authorizations/cross-tenant-read-observation.backend.ts` for why an UNDECLARED\n *   door is deliberately not observed instead of being observed with a false `admissionDeclared`.\n *\n * ## Deliberately mirrored from the organization resource\n *\n * `isSystemResource`, `systemAccessPolicy.exportSubject: FORBIDDEN` and the ABSENCE of a\n * `retentionPolicy` are copied ON PURPOSE. They are properties of the ROWS, and the rows are the\n * same ones — a second door that disagreed about whether the audit trail is subject-exportable, or\n * about how long it is kept, would be a policy fork over one record set. See the organization\n * config for the reasoning behind each; do not change one without the other.\n *\n * ## Deliberately NOT mirrored\n *\n * There is no CREATE. The organization resource carries a `REPOSITORY_ONLY` CREATE because that is\n * how audit rows are written; writing is not a scope question and must keep exactly one door.\n */\nexport const applicationAuditLogsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  undefined,\n  CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.SEARCH,\n  typeof AuditableEvent_BaseSchema\n>({\n  mainSchema: AuditableEvent_BaseSchema,\n  resourceIdentifier: CoreResourceType.APPLICATION_AUDIT_LOGS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.APPLICATION_AUDIT_LOGS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  /** Mirrored from the organization door — the same rows, so the same answer. Disclosing the monitoring trail to its own subject is self-defeating and out of Art. 20 scope. */\n  systemAccessPolicy: { exportSubject: ResourceSystemAccessMode.FORBIDDEN },\n\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n  ],\n\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /**\n         * Reading ONE tenant's audit row through the application door IS a crossing, so the cheapest\n         * reach — fetch by id — is declared and audited exactly like the collection verbs. Declaring\n         * it is also what stops `assignInitiatorOrganizationConfinementToFilter` silently narrowing\n         * this door to an operator who happens to carry an ambient organization, which would make a\n         * surface documented as spanning every tenant return one tenant and report success.\n         */\n        admitsCrossTenantPlatformAdministration: true,\n      }],\n    },\n\n    [CoreResourceOperation.LIST]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */\n        admitsCrossTenantPlatformAdministration: true,\n        filterFields: {\n          applicationId: z.string(),\n          eventType: z.string(),\n          eventCategory: z.enum(AuditEventCategory),\n          severity: z.enum(AuditEventSeverity),\n          userId: z.string(),\n          /**\n           * Filterable so an operator can narrow to one tenant THROUGH this door, which is the\n           * cross-tenant investigation this surface exists for. It is a FILTER, never the isolation\n           * boundary: isolation on this door is the role gate above, and narrowing to a tenant does\n           * not make the read any less cross-tenant for audit purposes.\n           */\n          organizationId: z.string(),\n          correlationId: z.string(),\n          // #1597 — \"what did firm X do here?\": a client filters its own trail by the relationship its firm acted through.\n          actingViaServiceProviderRelationshipId: z.string(),\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        /** `eventId` last, as the keyset tie-breaker — `createdAt` is not unique under boot/seed bursts. Mirrors the organization door; removing it reintroduces a paging data-loss path. */\n        sortFields: ['createdAt', 'severity', 'eventType', 'eventId'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [...APPLICATION_AUDIT_LOG_READ_ROLES],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        /** The declared crossing — see READ. Every enrolled read emits one crossing per tenant reached. */\n        admitsCrossTenantPlatformAdministration: true,\n        // Filters and sorts only, like the organization audit log (#2510): it declared itself searchable over no\n        // field, which on MongoDB ran a `$text` search against an index nothing creates.\n        isSearchable: false,\n        searchableFields: [],\n        filterFields: {\n          applicationId: z.string(),\n          eventType: z.string(),\n          eventCategory: z.enum(AuditEventCategory),\n          severity: z.enum(AuditEventSeverity),\n          userId: z.string(),\n          organizationId: z.string(),\n          correlationId: z.string(),\n          // #1597 — \"what did firm X do here?\": a client filters its own trail by the relationship its firm acted through.\n          actingViaServiceProviderRelationshipId: z.string(),\n          clientInstanceId: z.string(),\n          createdAt: z.date(),\n        },\n        sortFields: ['createdAt', 'severity', 'eventType'] as const,\n        maxPaginatedResultPerPageLimit: 100,\n      }],\n    },\n  },\n});\n"]}

package/dist/esm/compliance/audit-trails/audit-actor.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-actor.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/audit-actor.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,oBAAY,kBAAkB;IAC5B;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;;OAKG;IACH,OAAO,YAAY;IACnB;;;;OAIG;IACH,YAAY,iBAAiB;CAC9B;AAED,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAqD,CAAC;AAEzG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,oJAAoJ;AACpJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,oBAAY,cAAc;IACxB,wFAAwF;IACxF,IAAI,SAAS;IACb;;;;OAIG;IACH,gBAAgB,qBAAqB;IACrC,iIAAiI;IACjI,OAAO,YAAY;IACnB;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;OAIG;IACH,eAAe,oBAAoB;IACnC,kGAAkG;IAClG,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAuBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,wEAAwE"}
+{"version":3,"file":"audit-actor.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/compliance/audit-trails/audit-actor.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,oBAAY,kBAAkB;IAC5B;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;;OAKG;IACH,OAAO,YAAY;IACnB;;;;OAIG;IACH,YAAY,iBAAiB;CAC9B;AAED,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAqD,CAAC;AAEzG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,oJAAoJ;AACpJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,oBAAY,cAAc;IACxB,wFAAwF;IACxF,IAAI,SAAS;IACb;;;;OAIG;IACH,gBAAgB,qBAAqB;IACrC,iIAAiI;IACjI,OAAO,YAAY;IACnB;;;;OAIG;IACH,MAAM,WAAW;IACjB;;;;OAIG;IACH,eAAe,oBAAoB;IACnC,kGAAkG;IAClG,YAAY,iBAAiB;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB;;;;;;iBAuBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,wEAAwE"}

package/dist/esm/compliance/audit-trails/audit-actor.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit-actor.shared.schemas.js","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/audit-actor.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAN,IAAY,kBAoBX;AApBD,WAAY,kBAAkB;IAC5B;;;;OAIG;IACH,uCAAiB,CAAA;IACjB;;;;;OAKG;IACH,yCAAmB,CAAA;IACnB;;;;OAIG;IACH,mDAA6B,CAAA;AAC/B,CAAC,EApBW,kBAAkB,KAAlB,kBAAkB,QAoB7B;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAEzG;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,qBAAqB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,oJAAoJ;AACpJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAN,IAAY,cAyBX;AAzBD,WAAY,cAAc;IACxB,wFAAwF;IACxF,+BAAa,CAAA;IACb;;;;OAIG;IACH,uDAAqC,CAAA;IACrC,iIAAiI;IACjI,qCAAmB,CAAA;IACnB;;;;OAIG;IACH,mCAAiB,CAAA;IACjB;;;;OAIG;IACH,qDAAmC,CAAA;IACnC,kGAAkG;IAClG,+CAA6B,CAAA;AAC/B,CAAC,EAzBW,cAAc,KAAd,cAAc,QAyBzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,kFAAkF;IAClF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mEAAmE,CAAC;IACzG;;;;OAIG;IACH,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,iGAAiG,CAAC;IAC9G,2DAA2D;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAC1G,gHAAgH;IAChH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sGAAsG,CAAC;IACvJ,+EAA+E;IAC/E,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,0FAA0F,CAAC;CACxG,CAAC,CAAC;AAEH,wEAAwE","sourcesContent":["/**\n * Audit ACTOR vocabulary — what goes in an audit event's `*By` field when there is no acting user.\n *\n * Every auditable-event payload carries an actor field (`deletedBy`, `changedBy`, `removedBy`,\n * `requestedBy`, …) typed as a plain string, whose contract is: **the acting user's id, or a\n * sentinel from this enum saying why there is no user.** A reader can always tell the two apart —\n * these values are not id-shaped.\n *\n * ## Why this exists\n *\n * Every emitter used to fall back to the bare literal `'unknown'`, which merged three genuinely\n * different facts into one token:\n *\n * - the scheduled `organization-purge` batch destroying a tenant — the actor is precisely known, it\n *   is the system;\n * - a machine principal acting on an API key or OAuth client — non-human, but attributable;\n * - a request that should have carried a principal and did not — a real anomaly.\n *\n * An auditor reading `'unknown'` cannot distinguish \"routine automation\" from \"we failed to\n * attribute a privileged action\", so the one case worth investigating was hidden inside the two that\n * are not. Merging semantically distinct concepts because they share a wire value is exactly what\n * the framework forbids; naming them separately restores the distinction.\n *\n * Discovered 2026-08-04 by the `organization-purge-batch-audit` e2e lane, which observed a\n * batch-purged tenant recorded as deleted by `'unknown'`.\n *\n * assurance-control: WILDO.AUDIT.ATTRIBUTION — a security-relevant action must record who performed\n * it, and must not disguise an unattributable action as an ordinary automated one.\n */\n\nimport { z } from 'zod';\n\n/**\n * Sentinel actors for audit `*By` fields. Resolve one with\n * `resolveAuditActorId(executionContext)` from `@wildo-ai/saas-backend-lib` rather than choosing by\n * hand — the mapping from execution type to sentinel belongs in one place.\n */\nexport enum AuditActorSentinel {\n  /**\n   * The system acted with no human principal BY DESIGN — a scheduled batch, a cron job, or an\n   * internally initiated workflow. This is an ATTRIBUTED outcome: the actor is the application\n   * itself, and a reviewer should read it as routine automation.\n   */\n  SYSTEM = 'system',\n  /**\n   * A machine principal acted: an organization or application API key, or an OAuth client. Non-human\n   * but legitimate and traceable — the specific credential is recorded on the execution context\n   * (`initiatorIds.machineCredential`) and on the machine-authentication event trail, so this field\n   * records the KIND of actor rather than duplicating a second id shape into a user-id slot.\n   */\n  MACHINE = 'machine',\n  /**\n   * A principal was expected and could not be resolved. Unlike the two above this is an ANOMALY, and\n   * it is the value a reviewer should alert on: a privileged action happened and the trail cannot\n   * say who performed it.\n   */\n  UNATTRIBUTED = 'unattributed',\n}\n\n/** Every sentinel value, for consumers that need to tell a sentinel from a real user id. */\nexport const AUDIT_ACTOR_SENTINELS: readonly string[] = Object.freeze(Object.values(AuditActorSentinel));\n\n/**\n * Whether an audit `*By` value is a sentinel rather than a user id.\n *\n * Use this instead of comparing against literals at a call site — a consumer that hard-codes\n * `=== 'system'` silently stops matching if the vocabulary grows.\n */\nexport function isAuditActorSentinel(actorId: string): boolean {\n  return AUDIT_ACTOR_SENTINELS.includes(actorId);\n}\n\n/** @wildo_source:part:start saas.models.audit-trails.actor-attribution facet:layer:shared facet:family:audit-trails facet:audience:app-developer */\n/**\n * The KIND of principal whose authority an audited action used — recorded on every audit row as\n * `actorKind`, beside `userId`.\n *\n * It answers ONE question and nothing else: *under whose authority did this happen?* Whether an AI\n * agent performed the action is a different question, answered by the presence of the row's\n * `agentActor` ({@link AuditAgentActorSchema}). An agent is never a principal: it always acts under a\n * user's, a machine's, or the application's own authority, so there is deliberately no `AGENT` member.\n * Folding the two into one field would make it answer two questions and a reader could no longer tell\n * \"the user did it\" from \"an agent did it with the user's authority\".\n *\n * The framework fills it on every row, so an application never writes it. An application emitting its\n * own event through `AuditLogsBackendService.logEvent` passes its request context, and with none names\n * the principal instead: `userAuditPrincipal(userId)`, `SYSTEM_AUDIT_PRINCIPAL`,\n * `UNAUTHENTICATED_AUDIT_PRINCIPAL` or `machineCredentialAuditPrincipal(...)`, all exported by\n * `@wildo-ai/saas-backend-lib`. With neither, the kind is read off the `userId` the event carries — right\n * only when that id is the actor, not the subject.\n *\n * assurance-control: WILDO.AUDIT.ATTRIBUTION — every audit row names the kind of principal whose\n * authority was used, so an unattributed action stays distinguishable from routine automation.\n */\nexport enum AuditActorKind {\n  /** A signed-in person acting through a first-party session. `userId` is that person. */\n  USER = 'user',\n  /**\n   * A person's authority, exercised by an EXTERNAL OAuth client they delegated to (an A2A or MCP\n   * client). `userId` is the delegating person and `delegatingClientId` names the client, taken from\n   * the verified token's `azp`.\n   */\n  DELEGATED_CLIENT = 'delegated_client',\n  /** An organization or application machine credential (API key or OAuth client credentials). `principalCredentialId` names it. */\n  MACHINE = 'machine',\n  /**\n   * The application acting on its own behalf by design — a batch, a cron job, an internal workflow, a\n   * system-door read or write, or application code handling a signature-verified inbound message or\n   * webhook (the sender holds a shared secret, not a credential this application issued).\n   */\n  SYSTEM = 'system',\n  /**\n   * Nobody was authenticated, and none was expected: a sign-in or recovery attempt before any factor\n   * succeeded, a public operation, an anonymous visitor session. Routine traffic — kept apart from\n   * `UNATTRIBUTED` so that a failed login is not reported as the anomaly reviewers alert on.\n   */\n  UNAUTHENTICATED = 'unauthenticated',\n  /** A principal was expected and could not be resolved. The anomaly a reviewer should alert on. */\n  UNATTRIBUTED = 'unattributed',\n}\n\n/**\n * Which AI agent performed an audited action, and in which execution — present on an audit row ONLY\n * when an agent acted. Its presence is how the trail says \"an agent did this\"; `actorKind` still names\n * the principal whose authority the agent used.\n *\n * Evidence only: nothing in the framework authorizes on it. It carries identifiers, never the\n * conversation's text, the tool's argument values, or digests of them — a digest of a short argument\n * can be reversed by enumeration, and the audit ledger cannot be scrubbed.\n *\n * Filled by the framework: every write an agent's tool makes — through a resource tool, a hand-written\n * tool, or a system write inside a tool — carries it automatically.\n */\nexport const AuditAgentActorSchema = z.object({\n  /** The agent's declared `ref` (a configuration identifier, not personal data). */\n  agentRef: z.string().min(1).describe('The declared reference of the AI agent that performed the action.'),\n  /**\n   * The conversational execution the action belongs to — a pseudonymous key into a transcript the\n   * user owns. Absent when an agent was invoked outside any conversational execution: the framework\n   * records the agent it knows rather than invent an execution id.\n   */\n  agentExecutionId: z\n    .string()\n    .min(1)\n    .optional()\n    .describe('The conversation run the action belongs to. Absent when the agent acted outside a conversation.'),\n  /** The actors system the execution runs in, when known. */\n  systemRef: z.string().min(1).optional().describe('The actor system the conversation runs in, when known.'),\n  /** The tool the agent called: the `functionRef` of a function tool, or the model-facing name of an MCP tool. */\n  toolName: z.string().min(1).optional().describe('The tool the agent called to perform the action: a function tool’s reference, or an MCP tool’s name.'),\n  /** The human decision that authorised the call, for an approval-gated tool. */\n  decisionRef: z\n    .string()\n    .min(1)\n    .optional()\n    .describe('For a tool that requires approval, the id of the human decision that approved this call.'),\n});\nexport type AuditAgentActor = z.infer<typeof AuditAgentActorSchema>;\n/** @wildo_source:part:end saas.models.audit-trails.actor-attribution */\n"]}
+{"version":3,"file":"audit-actor.shared.schemas.js","sourceRoot":"","sources":["../../../../src/compliance/audit-trails/audit-actor.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAN,IAAY,kBAoBX;AApBD,WAAY,kBAAkB;IAC5B;;;;OAIG;IACH,uCAAiB,CAAA;IACjB;;;;;OAKG;IACH,yCAAmB,CAAA;IACnB;;;;OAIG;IACH,mDAA6B,CAAA;AAC/B,CAAC,EApBW,kBAAkB,KAAlB,kBAAkB,QAoB7B;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAEzG;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,qBAAqB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,oJAAoJ;AACpJ;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAN,IAAY,cAyBX;AAzBD,WAAY,cAAc;IACxB,wFAAwF;IACxF,+BAAa,CAAA;IACb;;;;OAIG;IACH,uDAAqC,CAAA;IACrC,iIAAiI;IACjI,qCAAmB,CAAA;IACnB;;;;OAIG;IACH,mCAAiB,CAAA;IACjB;;;;OAIG;IACH,qDAAmC,CAAA;IACnC,kGAAkG;IAClG,+CAA6B,CAAA;AAC/B,CAAC,EAzBW,cAAc,KAAd,cAAc,QAyBzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,kFAAkF;IAClF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mEAAmE,CAAC;IACzG;;;;OAIG;IACH,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,iGAAiG,CAAC;IAC9G,2DAA2D;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAC1G,gHAAgH;IAChH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sGAAsG,CAAC;IACvJ,+EAA+E;IAC/E,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,0FAA0F,CAAC;CACxG,CAAC,CAAC;AAEH,wEAAwE","sourcesContent":["/**\n * Audit ACTOR vocabulary — what goes in an audit event's `*By` field when there is no acting user.\n *\n * Every auditable-event payload carries an actor field (`deletedBy`, `changedBy`, `removedBy`,\n * `requestedBy`, …) typed as a plain string, whose contract is: **the acting user's id, or a\n * sentinel from this enum saying why there is no user.** A reader can always tell the two apart —\n * these values are not id-shaped.\n *\n * ## Why this exists\n *\n * Every emitter used to fall back to the bare literal `'unknown'`, which merged three genuinely\n * different facts into one token:\n *\n * - the scheduled `organization-purge` batch destroying a tenant — the actor is precisely known, it\n *   is the system;\n * - a machine principal acting on an API key or OAuth client — non-human, but attributable;\n * - a request that should have carried a principal and did not — a real anomaly.\n *\n * An auditor reading `'unknown'` cannot distinguish \"routine automation\" from \"we failed to\n * attribute a privileged action\", so the one case worth investigating was hidden inside the two that\n * are not. Merging semantically distinct concepts because they share a wire value is exactly what\n * the framework forbids; naming them separately restores the distinction.\n *\n * Discovered 2026-08-04 by the `organization-purge-batch-audit` e2e lane, which observed a\n * batch-purged tenant recorded as deleted by `'unknown'`.\n *\n * assurance-control: WILDO.AUDIT.ATTRIBUTION — a security-relevant action must record who performed\n * it, and must not disguise an unattributable action as an ordinary automated one.\n */\n\nimport { z } from 'zod';\n\n/**\n * Sentinel actors for audit `*By` fields. Resolve one with\n * `resolveAuditActorId(executionContext)` from `@wildo-ai/saas-backend-lib` rather than choosing by\n * hand — the mapping from execution type to sentinel belongs in one place.\n */\nexport enum AuditActorSentinel {\n  /**\n   * The system acted with no human principal BY DESIGN — a scheduled batch, a cron job, or an\n   * internally initiated workflow. This is an ATTRIBUTED outcome: the actor is the application\n   * itself, and a reviewer should read it as routine automation.\n   */\n  SYSTEM = 'system',\n  /**\n   * A machine principal acted: an organization or application API key, or an OAuth client. Non-human\n   * but legitimate and traceable — the specific credential is recorded on the execution context\n   * (`initiatorIds.machineCredential`) and on the machine-authentication event trail, so this field\n   * records the KIND of actor rather than duplicating a second id shape into a user-id slot.\n   */\n  MACHINE = 'machine',\n  /**\n   * A principal was expected and could not be resolved. Unlike the two above this is an ANOMALY, and\n   * it is the value a reviewer should alert on: a privileged action happened and the trail cannot\n   * say who performed it.\n   */\n  UNATTRIBUTED = 'unattributed',\n}\n\n/** Every sentinel value, for consumers that need to tell a sentinel from a real user id. */\nexport const AUDIT_ACTOR_SENTINELS: readonly string[] = Object.freeze(Object.values(AuditActorSentinel));\n\n/**\n * Whether an audit `*By` value is a sentinel rather than a user id.\n *\n * Use this instead of comparing against literals at a call site — a consumer that hard-codes\n * `=== 'system'` silently stops matching if the vocabulary grows.\n */\nexport function isAuditActorSentinel(actorId: string): boolean {\n  return AUDIT_ACTOR_SENTINELS.includes(actorId);\n}\n\n/** @wildo_source:part:start saas.models.audit-trails.actor-attribution facet:layer:shared facet:family:audit-trails facet:audience:app-developer */\n/**\n * The KIND of principal whose authority an audited action used — recorded on every audit row as\n * `actorKind`, beside `userId`.\n *\n * It answers ONE question and nothing else: *under whose authority did this happen?* Whether an AI\n * agent performed the action is a different question, answered by the presence of the row's\n * `agentActor` ({@link AuditAgentActorSchema}). An agent is never a principal: it always acts under a\n * user's, a machine's, or the application's own authority, so there is deliberately no `AGENT` member.\n * Folding the two into one field would make it answer two questions and a reader could no longer tell\n * \"the user did it\" from \"an agent did it with the user's authority\".\n *\n * The framework fills it on every row, so an application never writes it. An application emitting its\n * own event through `AuditLogsBackendService.logEvent` passes its request context, and with none names\n * the principal instead: `userAuditPrincipal(userId)`, `SYSTEM_AUDIT_PRINCIPAL`,\n * `UNAUTHENTICATED_AUDIT_PRINCIPAL` or `machineCredentialAuditPrincipal(...)`, all exported by\n * `@wildo-ai/saas-backend-lib`. With neither, the kind is read off the `userId` the event carries — right\n * only when that id is the actor, not the subject.\n *\n * assurance-control: WILDO.AUDIT.ATTRIBUTION — every audit row names the kind of principal whose\n * authority was used, so an unattributed action stays distinguishable from routine automation.\n */\nexport enum AuditActorKind {\n  /** A signed-in person acting through a first-party session. `userId` is that person. */\n  USER = 'user',\n  /**\n   * A person's authority, exercised by an EXTERNAL OAuth client they delegated to (an A2A or MCP\n   * client). `userId` is the delegating person and `delegatingClientId` names the client, taken from\n   * the verified token's `azp`.\n   */\n  DELEGATED_CLIENT = 'delegated_client',\n  /** An organization or application machine credential (API key or OAuth client credentials). `principalCredentialId` names it. */\n  MACHINE = 'machine',\n  /**\n   * The application acting on its own behalf by design — a batch, a cron job, an internal workflow, a\n   * system-door read or write, or application code handling a signature-verified inbound message or\n   * webhook (the sender holds a shared secret, not a credential this application issued).\n   */\n  SYSTEM = 'system',\n  /**\n   * Nobody was authenticated, and none was expected: a sign-in or recovery attempt before any factor\n   * succeeded, a public operation, an anonymous visitor session. Routine traffic — kept apart from\n   * `UNATTRIBUTED` so that a failed login is not reported as the anomaly reviewers alert on.\n   */\n  UNAUTHENTICATED = 'unauthenticated',\n  /** A principal was expected and could not be resolved. The anomaly a reviewer should alert on. */\n  UNATTRIBUTED = 'unattributed',\n}\n\n/**\n * Which AI agent performed an audited action, and in which execution — present on an audit row ONLY\n * when an agent acted. Its presence is how the trail says \"an agent did this\"; `actorKind` still names\n * the principal whose authority the agent used.\n *\n * Evidence only: nothing in the framework authorizes on it. It carries identifiers, never the\n * conversation's text, the tool's argument values, or digests of them — a digest of a short argument\n * can be reversed by enumeration, and the audit ledger cannot be scrubbed.\n *\n * Filled by the framework: every write an agent's tool makes — through a resource tool, a hand-written\n * tool, or a system write inside a tool — carries it automatically.\n */\nexport const AuditAgentActorSchema = z.object({\n  /** The agent's declared `ref` (a configuration identifier, not personal data). */\n  agentRef: z.string().min(1).describe('The declared reference of the AI agent that performed the action.'),\n  /**\n   * The conversational execution the action belongs to — a pseudonymous key into a transcript the\n   * user owns. Absent when an agent was invoked outside any conversational execution: the framework\n   * records the agent it knows rather than invent an execution id.\n   */\n  agentExecutionId: z\n    .string()\n    .min(1)\n    .optional()\n    .describe('The conversation run the action belongs to. Absent when the agent acted outside a conversation.'),\n  /** The actors system the execution runs in, when known. */\n  systemRef: z.string().min(1).optional().describe('The actor system the conversation runs in, when known.'),\n  /** The tool the agent called: the `functionRef` of a function tool, or the model-facing name of an MCP tool. */\n  toolName: z.string().min(1).optional().describe('The tool the agent called to perform the action: a function tool’s reference, or an MCP tool’s name.'),\n  /** The human decision that authorised the call, for an approval-gated tool. */\n  decisionRef: z\n    .string()\n    .min(1)\n    .optional()\n    .describe('For a tool that requires approval, the id of the human decision that approved this call.'),\n});\nexport type AuditAgentActor = z.infer<typeof AuditAgentActorSchema>;\n/** @wildo_source:part:end saas.models.audit-trails.actor-attribution */\n"]}

package/dist/esm/compliance/audit-trails/audit-event-classification.shared.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The two vocabularies an audit event is classified by: what KIND of activity it records, and how much attention it
+ * deserves. Every row carries both (`eventCategory`, `severity`), and they are what SIEM routing, the per-destination
+ * event filter and the audit views sort by.
+ *
+ * Kept in a module of their own, with no imports, because two different places classify: the engine's map of its own
+ * event types (`security-audit-event-envelope.shared.schema.ts`) and an APPLICATION's declaration of its own event types
+ * (`auditTrail.applicationEventTypes`, in `audit-trail-config.shared.schemas.ts`). The audit-event schemas already import
+ * that configuration module, so the vocabularies cannot live beside them without an import cycle — and an enum read
+ * while its module is still initializing is `undefined`.
+ *
+ * Their words are `AUDIT_EVENT_CATEGORY_MEANINGS` and `AUDIT_EVENT_SEVERITY_MEANINGS`, in `auditable-events.shared.schema.ts`.
+ */
+/** What kind of activity an audit event records. */
+export declare enum AuditEventCategory {
+    AUTHENTICATION = "authentication",
+    AUTHORIZATION = "authorization",
+    USER_LIFECYCLE = "user_lifecycle",
+    ORG_MANAGEMENT = "org_management",
+    DATA_ACCESS = "data_access"
+}
+/** How much attention an audit event deserves. */
+export declare enum AuditEventSeverity {
+    INFO = "info",
+    WARNING = "warning",
+    CRITICAL = "critical"
+}
+//# sourceMappingURL=audit-event-classification.shared.d.ts.map

package/dist/esm/compliance/audit-trails/audit-event-classification.shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-event-classification.shared.d.ts","sourceRoot":"","sources":["../../../../src/compliance/audit-trails/audit-event-classification.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oDAAoD;AACpD,oBAAY,kBAAkB;IAC5B,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,cAAc,mBAAmB;IACjC,WAAW,gBAAgB;CAC5B;AAED,kDAAkD;AAClD,oBAAY,kBAAkB;IAC5B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB"}

package/dist/esm/compliance/audit-trails/audit-event-classification.shared.js

@@ -0,0 +1,30 @@
+/**
+ * The two vocabularies an audit event is classified by: what KIND of activity it records, and how much attention it
+ * deserves. Every row carries both (`eventCategory`, `severity`), and they are what SIEM routing, the per-destination
+ * event filter and the audit views sort by.
+ *
+ * Kept in a module of their own, with no imports, because two different places classify: the engine's map of its own
+ * event types (`security-audit-event-envelope.shared.schema.ts`) and an APPLICATION's declaration of its own event types
+ * (`auditTrail.applicationEventTypes`, in `audit-trail-config.shared.schemas.ts`). The audit-event schemas already import
+ * that configuration module, so the vocabularies cannot live beside them without an import cycle — and an enum read
+ * while its module is still initializing is `undefined`.
+ *
+ * Their words are `AUDIT_EVENT_CATEGORY_MEANINGS` and `AUDIT_EVENT_SEVERITY_MEANINGS`, in `auditable-events.shared.schema.ts`.
+ */
+/** What kind of activity an audit event records. */
+export var AuditEventCategory;
+(function (AuditEventCategory) {
+    AuditEventCategory["AUTHENTICATION"] = "authentication";
+    AuditEventCategory["AUTHORIZATION"] = "authorization";
+    AuditEventCategory["USER_LIFECYCLE"] = "user_lifecycle";
+    AuditEventCategory["ORG_MANAGEMENT"] = "org_management";
+    AuditEventCategory["DATA_ACCESS"] = "data_access";
+})(AuditEventCategory || (AuditEventCategory = {}));
+/** How much attention an audit event deserves. */
+export var AuditEventSeverity;
+(function (AuditEventSeverity) {
+    AuditEventSeverity["INFO"] = "info";
+    AuditEventSeverity["WARNING"] = "warning";
+    AuditEventSeverity["CRITICAL"] = "critical";
+})(AuditEventSeverity || (AuditEventSeverity = {}));
+//# sourceMappingURL=audit-event-classification.shared.js.map

package/dist/esm/compliance/audit-trails/audit-event-classification.shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-event-classification.shared.js","sourceRoot":"","sources":["../../../../src/compliance/audit-trails/audit-event-classification.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,oDAAoD;AACpD,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,uDAAiC,CAAA;IACjC,qDAA+B,CAAA;IAC/B,uDAAiC,CAAA;IACjC,uDAAiC,CAAA;IACjC,iDAA2B,CAAA;AAC7B,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B;AAED,kDAAkD;AAClD,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,yCAAmB,CAAA;IACnB,2CAAqB,CAAA;AACvB,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B","sourcesContent":["/**\n * The two vocabularies an audit event is classified by: what KIND of activity it records, and how much attention it\n * deserves. Every row carries both (`eventCategory`, `severity`), and they are what SIEM routing, the per-destination\n * event filter and the audit views sort by.\n *\n * Kept in a module of their own, with no imports, because two different places classify: the engine's map of its own\n * event types (`security-audit-event-envelope.shared.schema.ts`) and an APPLICATION's declaration of its own event types\n * (`auditTrail.applicationEventTypes`, in `audit-trail-config.shared.schemas.ts`). The audit-event schemas already import\n * that configuration module, so the vocabularies cannot live beside them without an import cycle — and an enum read\n * while its module is still initializing is `undefined`.\n *\n * Their words are `AUDIT_EVENT_CATEGORY_MEANINGS` and `AUDIT_EVENT_SEVERITY_MEANINGS`, in `auditable-events.shared.schema.ts`.\n */\n\n/** What kind of activity an audit event records. */\nexport enum AuditEventCategory {\n  AUTHENTICATION = 'authentication',\n  AUTHORIZATION = 'authorization',\n  USER_LIFECYCLE = 'user_lifecycle',\n  ORG_MANAGEMENT = 'org_management',\n  DATA_ACCESS = 'data_access',\n}\n\n/** How much attention an audit event deserves. */\nexport enum AuditEventSeverity {\n  INFO = 'info',\n  WARNING = 'warning',\n  CRITICAL = 'critical',\n}\n"]}

package/dist/esm/compliance/audit-trails/audit-export-projection.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-export-projection.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/compliance/audit-trails/audit-export-projection.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audit-export-projection.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/compliance/audit-trails/audit-export-projection.shared.schemas.ts"],"names":[],"mappings":"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"}