@wildo-ai/saas-models 1.1.5 → 1.1.7

package/dist/esm/billing/subscription.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/subscription.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subscription & Subscription Item Schemas (Shared) — Polymorphic\n *\n * Subscriptions are scope-expanded alongside BillingAccounts. Each subscription\n * variant gets the scope identity FK injected (organizationId / userId)\n * and keeps `billingAccountId` as the FK to its parent billing account variant.\n *\n * The polymorphic expansion produces 2 concrete resources:\n *   - organizationSubscriptions  (with organizationId + organizationBillingAccountId)\n *   - userSubscriptions          (with userId + userBillingAccountId)\n *\n *\n * @see polymorphic-scope-approach-A-expansion.md\n * @see billing-and-features-system.md §6.3 (Subscription & Subscription Items)\n */\n\nimport { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first —\n// never by the importer's luck (#966). A named import used only as a type would be elided and install nothing.\nimport '@wildo-ai/zod-decorators';\nimport { declarePolymorphicSchemas, optOutPolymorphicAutoBusinessKey } from '../resources/utils/resource-polymorphism.schemas';\nimport { BILLING_SCOPE_VARIANTS, BILLING_SCOPE_FK_VARIANTS } from './billing-account.shared.schemas';\nimport { SubscriptionStatus } from './billing-enums.shared.schemas';\n\n// ── Subscription Item ──────────────────────────────────────────────\n\n/**\n * A line item within a subscription (one product/price pair).\n */\nexport const SubscriptionItemSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey(),\n  /** Reference to the product */\n  productId: z.string().min(1).isForeignKey().isSummaryField({ populate: true }),\n  /** Reference to the specific price */\n  priceId: z.string().min(1).isForeignKey().isSummaryField({ populate: true }),\n  /** Quantity (e.g., number of seats) */\n  quantity: z.number().min(1).default(1).isSummaryField(),\n  /** Provider sync */\n  providerSubscriptionItemId: z.string().optional().isBackendOnly(),\n});\nexport type SubscriptionItem = z.infer<typeof SubscriptionItemSchema>;\n\n// ── Subscription Base Schema ───────────────────────────────────────\n\n/**\n * Subscription base schema — NO identity scope fields.\n * The polymorphic declaration injects the parent scope FK automatically per variant.\n * `billingAccountId` is kept as the FK to the parent billing account variant.\n */\nexport const BillingSubscriptionBaseSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  /** References the parent billing account (polymorphic FK — renamed per variant) */\n  billingAccountId: z.string().min(1).isForeignKey({ polymorphicVariants: BILLING_SCOPE_FK_VARIANTS }).isDBIndexed().isSummaryField(),\n\n  // `.isAuditEvidence()` — subscription status is the ENTITLEMENT gate: the feature resolver\n  // derives a scope's capabilities from it, so a transition to/from ACTIVE silently widens or\n  // narrows what the tenant may do. Recording the before/after states makes an entitlement\n  // dispute answerable from the trail instead of from the payment provider's own records.\n  // Marked on the STATUS only — the provider identifiers on this schema are `.isBackendOnly()`\n  // and the money/customer fields are not authorization evidence, so neither is marked.\n  // assurance-control: WILDO.ACCESS.PRIVILEGE_EVIDENCE — a subscription status transition widens or\n  // narrows tenant capability, so the before/after states are entitlement evidence.\n  status: z.enum(SubscriptionStatus).isDBIndexed().isSummaryField().systemEnum('SubscriptionStatus').isAuditEvidence(),\n\n  /** Subscription items (what products/prices are included) */\n  // FINANCIAL — see the note on `billing-account.shared.schemas.ts`. What the account holder pays\n  // for, at what quantity; the lifecycle `status` beside it is a state machine, not a datum.\n  // No `.dataCategories()`: this is an amount/term about the ACCOUNT, not a description of a person.\n  // The person is the scope foreign key, which the never-scrub floor preserves in every mode, and the\n  // value must survive erasure for the tax/audit obligation this family exists to serve — so it can be\n  // neither scrubbed nor honestly declared as personal data the row holds. See `retentionPolicy` on the\n  // resource config (#138).\n  items: z.array(SubscriptionItemSchema).min(1),\n\n  /** Period */\n  currentPeriodStart: z.date().isDBIndexed().isNotEditable(),\n  currentPeriodEnd: z.date().isDBIndexed().isSummaryField().isNotEditable(),\n\n  /** Trial */\n  trialStart: z.date().optional().isNotEditable(),\n  trialEnd: z.date().optional().isSummaryField().isNotEditable(),\n\n  /** Cancellation */\n  cancelAtPeriodEnd: z.boolean().default(false).isSummaryField(),\n  cancelledAt: z.date().optional().isNotEditable(),\n  cancellationReason: z.string().optional(),\n\n  /** Active discount from a coupon/promotion applied to this subscription (populated from provider) */\n  discount: z.object({\n    providerCouponId: z.string().optional(),\n    percentOff: z.number().optional(),\n    amountOff: z.number().optional(),\n    currency: z.string().optional(),\n    duration: z.string().optional(),\n    durationInMonths: z.number().optional(),\n    end: z.date().optional(),\n  }).optional().isNotEditable(),\n\n  /** Provider sync (payment methods are managed entirely by provider) */\n  providerSubscriptionId: z.string().optional().isBackendOnly(),\n\n  /**\n   * Open key-value bag for operational tagging (cost-centre, campaign ref, internal correlation id).\n   *\n   * ⚠️ **AUTHORING RULE — never store personal data here.** This row is RETAINED when its subject is\n   * erased: the billing-retention decision keeps the financial record for tax/audit obligations, and\n   * subject erasure scrubs the linked USER rather than these rows, because a billing row holds no\n   * personal data of its own — the person is a foreign key. An open bag is the one place that\n   * assumption can be broken by an app author, and nothing would catch it: the erasure scrub is\n   * field-directed (`.impersonalizeWith()`), and it cannot reach inside an arbitrary record whose\n   * keys it does not know.\n   *\n   * Concretely: no names, emails, phone numbers, addresses, free-text notes about a person, or\n   * anything else that identifies one. Personal data written here SURVIVES an erasure — a compliance\n   * breach that the retained label makes look intentional.\n   *\n   * Enforcement is deliberately NOT built (Q3, 2026-07-31): scrubbing these rows would require\n   * hide/freeze to become separable from scrub — a real capability change with no current consumer.\n   * Revisit only if an app is found using the bag this way.\n   */\n  metadata: z.record(z.string(), z.string()).optional(),\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n});\nexport type BillingSubscriptionBase = z.infer<typeof BillingSubscriptionBaseSchema>;\n\n// ── Polymorphic Declaration ────────────────────────────────────────\n\n/**\n * Polymorphic declaration for Subscriptions.\n * Produces 2 variants:\n *   - organizations  → organizationSubscriptions  (organizationId injected)\n *   - users          → userSubscriptions          (userId injected)\n *\n *\n * Each variant gets `billingAccountId` renamed to the scoped FK\n * (e.g., `organizationBillingAccountId`) via polymorphic FK transformation.\n */\nexport const billingSubscriptionsPolymorphicDeclaration = declarePolymorphicSchemas({\n  baseResourceType: 'subscriptions',\n  baseFieldIdentifier: 'subscriptionId',\n  baseEnumKey: 'SUBSCRIPTIONS',\n  baseSchema: BillingSubscriptionBaseSchema,\n  // Many subscriptions per scope (LIST/CREATE/UPDATE) — opt out of the\n  // polymorphism engine's singleton-per-scope business-key auto-default.\n  variants: BILLING_SCOPE_VARIANTS.map(optOutPolymorphicAutoBusinessKey),\n});\n\n"]}
+{"version":3,"file":"subscription.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/subscription.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subscription & Subscription Item Schemas (Shared) — Polymorphic\n *\n * Subscriptions are scope-expanded alongside BillingAccounts. Each subscription\n * variant gets the scope identity FK injected (organizationId / userId)\n * and keeps `billingAccountId` as the FK to its parent billing account variant.\n *\n * The polymorphic expansion produces 2 concrete resources:\n *   - organizationSubscriptions  (with organizationId + organizationBillingAccountId)\n *   - userSubscriptions          (with userId + userBillingAccountId)\n *\n *\n * @see polymorphic-scope-approach-A-expansion.md\n * @see billing-and-features-system.md §6.3 (Subscription & Subscription Items)\n */\n\nimport { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first —\n// never by the importer's luck (#966). A named import used only as a type would be elided and install nothing.\nimport '@wildo-ai/zod-decorators';\nimport { declarePolymorphicSchemas, optOutPolymorphicAutoBusinessKey } from '../resources/utils/resource-polymorphism.schemas';\nimport { BILLING_SCOPE_VARIANTS, BILLING_SCOPE_FK_VARIANTS } from './billing-account.shared.schemas';\nimport { PromotionDuration, SubscriptionStatus } from './billing-enums.shared.schemas';\n\n// ── Subscription Item ──────────────────────────────────────────────\n\n/**\n * A line item within a subscription (one product/price pair).\n */\nexport const SubscriptionItemSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey(),\n  /** Reference to the product */\n  productId: z.string().min(1).isForeignKey().isSummaryField({ populate: true }).describe(\"The id of the product this line bills for: the plan, or an add-on.\"),\n  /** Reference to the specific price */\n  priceId: z.string().min(1).isForeignKey().isSummaryField({ populate: true }).describe(\"The id of the price this line is billed at. It belongs to the line's product.\"),\n  /** Quantity (e.g., number of seats) */\n  quantity: z.number().min(1).default(1).isSummaryField().describe(\"How many units of the price are billed, such as seats. Defaults to 1.\"),\n  /** Provider sync */\n  providerSubscriptionItemId: z.string().optional().isBackendOnly(),\n});\nexport type SubscriptionItem = z.infer<typeof SubscriptionItemSchema>;\n\n/**\n * One line of the items a pending plan change will give the subscription (#1868). Unlike a {@link SubscriptionItemSchema}\n * line it carries the provider price: at renewal the provider's lines are matched to these by price and quantity, and a\n * changed line has no provider item id until the provider creates it.\n */\nexport const PendingPlanChangeItemSchema = z.object({\n  _id: z.string().min(1).describe(\"The line's id: the current line's id when the line carries over, a new id when the change adds it.\"),\n  productId: z.string().min(1).describe(\"The id of the product this line will bill for.\"),\n  priceId: z.string().min(1).describe(\"The id of the price this line will be billed at.\"),\n  quantity: z.number().min(1).describe(\"How many units of the price will be billed.\"),\n  providerPriceId: z.string().min(1).isBackendOnly(),\n});\nexport type PendingPlanChangeItem = z.infer<typeof PendingPlanChangeItemSchema>;\n\n/**\n * A plan change confirmed to take effect at the end of the current period (#1868): the plan the subscription moves to,\n * when, and the lines it will then carry. Present from the confirmation until renewal applies it — then the subscription's\n * `items` become these lines and this is cleared — or until the change is cancelled.\n */\nexport const PendingPlanChangeSchema = z.object({\n  productId: z.string().min(1).describe(\"The id of the plan the subscription moves to.\"),\n  priceId: z.string().min(1).describe(\"The id of the price the subscription moves to.\"),\n  effectiveAt: z.date().describe(\"When the change takes effect: the end of the billing period in which it was confirmed.\"),\n  items: z.array(PendingPlanChangeItemSchema).min(1).describe(\"The lines the subscription will carry once the change takes effect: the new plan and the add-ons that carry over.\"),\n  providerScheduleId: z.string().optional().isBackendOnly(),\n});\nexport type PendingPlanChange = z.infer<typeof PendingPlanChangeSchema>;\n\n/**\n * How long before a pending plan change's `effectiveAt` it stops being withdrawable (#1868).\n *\n * The provider moves the subscription onto the new lines at renewal, and releasing its schedule after that keeps them: a withdrawal then\n * would clear the pending change while the provider bills the new plan. The provider refuses a release once the next phase has begun,\n * but reading the phase and releasing are two calls. Refusing a few minutes early covers that window and any clock skew between the\n * engine and the provider, and it covers the time between renewal and the local realization, when the change is still recorded as\n * pending but has already happened. One value: the operation refuses by it, and a frontend withholds the action by it.\n */\nexport const PLAN_CHANGE_WITHDRAWAL_CUTOFF_MS = 5 * 60 * 1000;\n\n/**\n * Whether a pending plan change's renewal is still far enough off for it to be withdrawn at `now`. Time only: the backend also refuses a\n * change recorded with no schedule, which a client cannot see (`providerScheduleId` is backend-only).\n */\nexport function isPendingPlanChangeWithdrawable(pending: { effectiveAt: Date | string }, now: Date = new Date()): boolean {\n  return now.getTime() < new Date(pending.effectiveAt).getTime() - PLAN_CHANGE_WITHDRAWAL_CUTOFF_MS;\n}\n\n// ── Subscription Base Schema ───────────────────────────────────────\n\n/**\n * Subscription base schema — NO identity scope fields.\n * The polymorphic declaration injects the parent scope FK automatically per variant.\n * `billingAccountId` is kept as the FK to the parent billing account variant.\n */\nexport const BillingSubscriptionBaseSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n  /** References the parent billing account (polymorphic FK — renamed per variant) */\n  billingAccountId: z.string().min(1).isForeignKey({ polymorphicVariants: BILLING_SCOPE_FK_VARIANTS }).isDBIndexed().isSummaryField().describe(\"The id of the billing account this subscription belongs to.\"),\n\n  // `.isAuditEvidence()` — subscription status is the ENTITLEMENT gate: the feature resolver\n  // derives a scope's capabilities from it, so a transition to/from ACTIVE silently widens or\n  // narrows what the tenant may do. Recording the before/after states makes an entitlement\n  // dispute answerable from the trail instead of from the payment provider's own records.\n  // Marked on the STATUS only — the provider identifiers on this schema are `.isBackendOnly()`\n  // and the money/customer fields are not authorization evidence, so neither is marked.\n  // assurance-control: WILDO.ACCESS.PRIVILEGE_EVIDENCE — a subscription status transition widens or\n  // narrows tenant capability, so the before/after states are entitlement evidence.\n  status: z.enum(SubscriptionStatus).isDBIndexed().isSummaryField().systemEnum('SubscriptionStatus').isAuditEvidence(),\n\n  /** Subscription items (what products/prices are included) */\n  // FINANCIAL — see the note on `billing-account.shared.schemas.ts`. What the account holder pays\n  // for, at what quantity; the lifecycle `status` beside it is a state machine, not a datum.\n  // No `.dataCategories()`: this is an amount/term about the ACCOUNT, not a description of a person.\n  // The person is the scope foreign key, which the never-scrub floor preserves in every mode, and the\n  // value must survive erasure for the tax/audit obligation this family exists to serve — so it can be\n  // neither scrubbed nor honestly declared as personal data the row holds. See `retentionPolicy` on the\n  // resource config (#138).\n  items: z.array(SubscriptionItemSchema).min(1).describe(\"What the subscription bills for: one line for the plan and one for each add-on.\"),\n\n  /** Period */\n  currentPeriodStart: z.date().isDBIndexed().isNotEditable().describe(\"When the current billing period started, as the billing provider reports it.\"),\n  currentPeriodEnd: z.date().isDBIndexed().isSummaryField().isNotEditable().describe(\"When the current billing period ends, as the billing provider reports it. The subscription renews then, or ends if `cancelAtPeriodEnd` is set.\"),\n\n  /**\n   * Trial — copied from the billing provider (#1798). Nothing wrote either before, so every subscription\n   * reported no trial whatever the provider held. Both are kept after the trial is over: they describe\n   * the subscription's trial, and `status` says whether it is trialing now.\n   */\n  trialStart: z.date().optional().isNotEditable().describe(\"When the subscription's trial began, as the billing provider reports it. Absent when the subscription never had a trial.\"),\n  trialEnd: z.date().optional().isSummaryField().isNotEditable().describe(\"When the subscription's trial ends, or ended, as the billing provider reports it. Kept after the trial is over; `status` says whether the subscription is trialing now.\"),\n\n  /** Cancellation */\n  cancelAtPeriodEnd: z.boolean().default(false).isSummaryField().describe(\"Whether the subscription is set to end when the current billing period ends. Set by a cancellation at period end, cleared by resuming, and kept in step with the billing provider.\"),\n  cancelledAt: z.date().optional().isNotEditable().describe(\"When the subscription was cancelled through the cancel operation, whether it ended immediately or at period end. Cleared when a scheduled cancellation is resumed.\"),\n  cancellationReason: z.string().optional().describe(\"The reason given when the subscription was cancelled, if one was given. Cleared when a scheduled cancellation is resumed.\"),\n\n  /**\n   * The discounts the billing provider applies to this subscription, in the order it applies them (#1798, #1948).\n   * Copied from the provider by every provider event and the reconciliation sweep; absent when none applies, including\n   * after the last one ends.\n   *\n   * A LIST, because a subscription can carry several at once: a referral reward is added BESIDE a promotion code the\n   * checkout applied (#1802), and the provider charges both. This was one `discount`, which showed the first and hid the\n   * rest, so a customer was told about one discount and billed for two. Order is kept because it is the order the\n   * provider applies them in, and a percentage taken after a fixed amount is a different price from the reverse.\n   */\n  discounts: z.array(z.object({\n    providerCouponId: z.string().optional().describe(\"The billing provider's id for the coupon behind the discount.\"),\n    percentOff: z.number().optional().describe(\"The percentage taken off, for a percentage discount.\"),\n    amountOff: z.number().optional().describe(\"The amount taken off each invoice, in minor units of `currency`, for a fixed-amount discount.\"),\n    currency: z.string().optional().describe(\"The ISO 4217 currency of `amountOff`, upper-case.\"),\n    duration: z.enum(PromotionDuration).optional().describe(\"How long the discount applies: `once` (the first invoice), `repeating` (for `durationInMonths`) or `forever`.\"),\n    durationInMonths: z.number().optional().describe(\"For a `repeating` discount, how many months it applies.\"),\n    end: z.date().optional().describe(\"When the discount stops applying, if it ends.\"),\n  })).optional().isNotEditable().describe(\"The discounts the billing provider applies to this subscription, in the order it applies them. Absent when none applies, including after the last one ends.\"),\n\n  /**\n   * A plan change that takes effect at the end of the current period (#1868): written by a CHANGE_PLAN confirmation whose\n   * plan's policy says `at_period_end`, cleared when renewal applies it (the provider projection then writes `items`) or when\n   * CANCEL_PLAN_CHANGE withdraws it. While it is present the subscription's other changes are refused until it is withdrawn.\n   */\n  pendingPlanChange: PendingPlanChangeSchema.optional().isNotEditable().describe(\"A plan change confirmed to take effect at the end of the current period, with the plan, the date and the lines it will then carry. Absent when no change is pending.\"),\n\n  /** Provider sync (payment methods are managed entirely by provider) */\n  providerSubscriptionId: z.string().optional().isBackendOnly(),\n\n  /**\n   * Open key-value bag for operational tagging (cost-centre, campaign ref, internal correlation id).\n   *\n   * ⚠️ **AUTHORING RULE — never store personal data here.** This row is RETAINED when its subject is\n   * erased: the billing-retention decision keeps the financial record for tax/audit obligations, and\n   * subject erasure scrubs the linked USER rather than these rows, because a billing row holds no\n   * personal data of its own — the person is a foreign key. An open bag is the one place that\n   * assumption can be broken by an app author, and nothing would catch it: the erasure scrub is\n   * field-directed (`.impersonalizeWith()`), and it cannot reach inside an arbitrary record whose\n   * keys it does not know.\n   *\n   * Concretely: no names, emails, phone numbers, addresses, free-text notes about a person, or\n   * anything else that identifies one. Personal data written here SURVIVES an erasure — a compliance\n   * breach that the retained label makes look intentional.\n   *\n   * Enforcement is deliberately NOT built (Q3, 2026-07-31): scrubbing these rows would require\n   * hide/freeze to become separable from scrub — a real capability change with no current consumer.\n   * Revisit only if an app is found using the bag this way.\n   */\n  metadata: z.record(z.string(), z.string()).optional().describe(\"String tags the application's own code may attach to the subscription. Do not store personal data here: this record is kept when its owner is erased.\"),\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n});\nexport type BillingSubscriptionBase = z.infer<typeof BillingSubscriptionBaseSchema>;\n\n// ── Polymorphic Declaration ────────────────────────────────────────\n\n/**\n * Polymorphic declaration for Subscriptions.\n * Produces 2 variants:\n *   - organizations  → organizationSubscriptions  (organizationId injected)\n *   - users          → userSubscriptions          (userId injected)\n *\n *\n * Each variant gets `billingAccountId` renamed to the scoped FK\n * (e.g., `organizationBillingAccountId`) via polymorphic FK transformation.\n */\nexport const billingSubscriptionsPolymorphicDeclaration = declarePolymorphicSchemas({\n  baseResourceType: 'subscriptions',\n  baseFieldIdentifier: 'subscriptionId',\n  baseEnumKey: 'SUBSCRIPTIONS',\n  baseSchema: BillingSubscriptionBaseSchema,\n  // Many subscriptions per scope (LIST/CREATE/UPDATE) — opt out of the\n  // polymorphism engine's singleton-per-scope business-key auto-default.\n  variants: BILLING_SCOPE_VARIANTS.map(optOutPolymorphicAutoBusinessKey),\n});\n\n"]}

package/dist/esm/billing/usage-flush-evidence.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-flush-evidence.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/usage-flush-evidence.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;iBAiBnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"usage-flush-evidence.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/usage-flush-evidence.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;iBAiBnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/esm/billing/usage-flush-evidence.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-flush-evidence.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/usage-flush-evidence.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACtD,qGAAqG;IACrG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACrC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;QACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC9B,CAAC,CAAC;IACH,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,4BAA4B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,8FAA8F;IAC9F,8BAA8B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,mDAAmD;IACnD,2BAA2B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACrD,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\n\nimport { UsageRecordUnreportableReason } from './billing-enums.shared.schemas';\n\n/**\n * # The usage flush's terminal states, summarized for an evidence reader\n *\n * assurance-control: WILDO.BILLING.USAGE_REPORTING — a usage row that can never be reported is marked\n * so with a reason, and the marking is answerable without reading any row.\n *\n * What `GET /assurance/usage-flush-evidence` returns for `evidence-requirement:usage-flush-run-record`\n * C3 (\"a row that can never be reported is marked unreportable with a reason, never reported and never\n * retried forever\"). The usage rows are the engine-owned store that answers it directly: each carries\n * its flush state, and an unreportable one its reason and the instant it was decided.\n *\n * ## A STATE, plus the decisions in the window\n *\n * The clause is about where rows STAND, so the counts are over every row the stores hold, not only\n * rows from the window: an unreportable row decided last year is still one that must never be\n * reported. The window adds one thing, how many rows were DECIDED unreportable inside it.\n *\n * ## The contradictions are counted apart\n *\n * Each is a way the clause can be broken while the totals look fine: an unreportable row with no\n * reason, one with no decision instant, and one that also carries `reportedAt`, which would mean a\n * quantity was both billed and declared unbillable. \"Never retried\" needs no count of its own: the\n * flush selects exactly `pending`, so a row in any other state is not work.\n *\n * Counts only: a usage row names a tenant or a person and a quantity, which an evidence reader has\n * no need to hold.\n */\nexport const UsageFlushEvidenceSchema = z.object({\n  window: z.object({ from: z.string(), to: z.string() }),\n  /** The usage stores measured. An application with billing off registers none, which is an answer. */\n  stores: z.array(z.string()),\n  pending: z.number().int().min(0),\n  reported: z.number().int().min(0),\n  unreportable: z.number().int().min(0),\n  unreportableByReason: z.array(z.object({\n    reason: z.enum(UsageRecordUnreportableReason).nullable(),\n    rows: z.number().int().min(0),\n  })),\n  unreportableWithoutReason: z.number().int().min(0),\n  unreportableWithoutDecidedAt: z.number().int().min(0),\n  /** Unreportable rows that ALSO carry `reportedAt`: billed and declared unbillable at once. */\n  unreportableAlsoMarkedReported: z.number().int().min(0),\n  /** Rows decided unreportable inside the window. */\n  unreportableDecidedInWindow: z.number().int().min(0),\n});\nexport type UsageFlushEvidence = z.infer<typeof UsageFlushEvidenceSchema>;\n"]}
+{"version":3,"file":"usage-flush-evidence.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/usage-flush-evidence.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IACtD,qGAAqG;IACrG,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACrC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,QAAQ,EAAE;QACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC9B,CAAC,CAAC;IACH,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,4BAA4B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,8FAA8F;IAC9F,8BAA8B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,mDAAmD;IACnD,2BAA2B,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACrD,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\n\nimport { UsageRecordUnreportableReason } from './billing-enums.shared.schemas';\n\n/**\n * # The usage flush's terminal states, summarized for an evidence reader\n *\n * assurance-control: WILDO.BILLING.USAGE_REPORTING — a usage row that can never be reported is marked\n * so with a reason, and the marking is answerable without reading any row.\n *\n * What `GET /assurance/usage-flush-evidence` returns for `evidence-requirement:usage-flush-run-record`\n * C3 (\"a row that can never be reported is marked unreportable with a reason, never reported and never\n * retried forever\"). The usage rows are the engine-owned store that answers it directly: each carries\n * its flush state, and an unreportable one its reason and the instant it was decided.\n *\n * ## A STATE, plus the decisions in the window\n *\n * The clause is about where rows STAND, so the counts are over every row the stores hold, not only\n * rows from the window: an unreportable row decided last year is still one that must never be\n * reported. The window adds one thing, how many rows were DECIDED unreportable inside it.\n *\n * ## The contradictions are counted apart\n *\n * Each is a way the clause can be broken while the totals look fine: an unreportable row with no\n * reason, one with no decision instant, and one that also carries `reportedAt`, which would mean a\n * quantity was both billed and declared unbillable. \"Never retried\" needs no count of its own: the\n * flush selects exactly `pending`, so a row in any other state is not work.\n *\n * Counts only: a usage row names a tenant or a person and a quantity, which an evidence reader has\n * no need to hold.\n */\nexport const UsageFlushEvidenceSchema = z.object({\n  window: z.object({ from: z.string(), to: z.string() }),\n  /** The usage stores measured. An application with billing off registers none, which is an answer. */\n  stores: z.array(z.string()),\n  pending: z.number().int().min(0),\n  reported: z.number().int().min(0),\n  unreportable: z.number().int().min(0),\n  unreportableByReason: z.array(z.object({\n    reason: z.enum(UsageRecordUnreportableReason).nullable(),\n    rows: z.number().int().min(0),\n  })),\n  unreportableWithoutReason: z.number().int().min(0),\n  unreportableWithoutDecidedAt: z.number().int().min(0),\n  /** Unreportable rows that ALSO carry `reportedAt`: billed and declared unbillable at once. */\n  unreportableAlsoMarkedReported: z.number().int().min(0),\n  /** Rows decided unreportable inside the window. */\n  unreportableDecidedInWindow: z.number().int().min(0),\n});\nexport type UsageFlushEvidence = z.infer<typeof UsageFlushEvidenceSchema>;\n"]}

package/dist/esm/billing/usage-record.shared.resources-config.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-record.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/usage-record.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,qBAAqB,EAAoB,MAAM,gDAAgD,CAAC;AAYzG,eAAO,MAAM,gCAAgC,qPA0G5C,CAAC"}
+{"version":3,"file":"usage-record.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/usage-record.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,qBAAqB,EAAoB,MAAM,gDAAgD,CAAC;AAYzG,eAAO,MAAM,gCAAgC,qPA0G5C,CAAC"}

package/dist/esm/billing/usage-record.shared.resources-config.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-record.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/billing/usage-record.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Usage Record Resource Configuration — Polymorphic\n *\n * Produces 3 factory functions (one per scope variant) via the polymorphic factory.\n * Spread into the registry factory map:\n *   ...usageRecordsPolymorphicFactories\n */\n\nimport { CoreResourceOperation, CoreResourceType } from '../resources/resources.shared.core.definitions';\nimport {\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n} from '../resources/resources.shared.schemas';\nimport { createPolymorphicResourceConfigurations } from '../resources/utils/resource-polymorphism.factory';\nimport { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { usageRecordsPolymorphicDeclaration } from './usage-record.shared.schemas';\nimport { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas';\nimport { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas';\nimport { ErasureRetentionMode, ResourceDataSubjectKind } from '../compliance/privacy/impersonalization.shared.schemas';\n\nexport const usageRecordsPolymorphicFactories = createPolymorphicResourceConfigurations(\n  usageRecordsPolymorphicDeclaration,\n  {\n    isSystemResource: true,\n    /** Subject-export disclosure. The subject's own usage records. Secrets and backend-only values are withheld by the export's security floor regardless of this grant. On a polymorphic resource this grant applies to EVERY generated variant, which is the documented intent of the shared config. */\n    systemAccessPolicy: { exportSubject: ResourceSystemAccessMode.ALLOWED },\n    portabilityPolicy: { defaultProvenance: DataPortabilityProvenance.OBSERVED },\n\n    /**\n     * Subject erasure RETAINS this row and scrubs nothing, because there is nothing here to scrub.\n *\n * `RETAIN_ONLY` is a positive ASSERTION that this resource holds no personal data of its own. The row is\n * metered usage — a product key, a quantity and a period — amounts and contract terms about the ACCOUNT. They\n * describe nobody once the linked USER row is scrubbed, and they must survive erasure for the tax/audit\n * obligation this family exists to serve, so they can be neither scrubbed nor honestly declared as\n * personal data the row holds. The person is the scope foreign key, which the never-scrub floor protects.\n *\n * The assertion is CHECKED in both directions: the factory refuses `RETAIN_ONLY` if any field declares an\n * impersonalize treatment, and (since 2026-08-31) if any non-floor field declares `.dataCategories()`.\n     */\n    retentionPolicy: {\n      mode: ErasureRetentionMode.RETAIN_ONLY,\n    },\n\n    /**\n     * Erasing one of these rows revokes NO session. The row is not a person — its owner FK names the ACTOR the\n *  record belongs to — and the enum prescribes `NO_PRINCIPAL` for exactly that shape. The subject's own\n *  session ends through the `USERS` row, which is `SELF_PRINCIPAL`.\n     */\n    dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },\n\n    coreOperations: [\n      CoreResourceOperation.READ,\n      CoreResourceOperation.LIST,\n      CoreResourceOperation.CREATE,\n      CoreResourceOperation.UPDATE,\n      // Route-less; `retentionPolicy` requires READ + LIST + UPDATE_MANY.\n      CoreResourceOperation.UPDATE_MANY,\n    ],\n    operationsConfiguration: {\n      /*\n       * Route-less retention plumbing — INTERNAL_CALL registers no route, so no API surface is added, and it\n       * must not be REPOSITORY_ONLY: the retention primitives resolve through `getServiceOperationPathDefault`,\n       * which matches only INTERNAL_CALL / API_CALL. LIST is LOW (a read-shaped op may not claim the\n       * HIGH/CRITICAL band, which carries an audit-emission obligation); UPDATE_MANY is CRITICAL — it is the\n       * verb the impersonalize writer uses to stamp the retention markers.\n       */\n      [CoreResourceOperation.UPDATE_MANY]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.CRITICAL,\n        }],\n      },\n\n      [CoreResourceOperation.READ]: {\n        variants: [{\n          // API_CALL: usage records are a user-facing collection (Settings Hub → Billing →\n          // Usage, and the resource presets' LIST/READ views). REPOSITORY_ONLY would strip\n          // the op from the frontend registry and register no HTTP route. Writes are\n          // INTERNAL_CALL (service-pipeline; metered internally / by webhooks, not by users).\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          polymorphicRole: {\n            [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN],\n            [CoreResourceType.USERS]: [CORE_APP_ROLES.APP_USER],\n          },\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }],\n      },\n      [CoreResourceOperation.LIST]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          polymorphicRole: {\n            [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN],\n            [CoreResourceType.USERS]: [CORE_APP_ROLES.APP_USER],\n          },\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }],\n      },\n      [CoreResourceOperation.CREATE]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          polymorphicRole: {\n            [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN],\n            [CoreResourceType.USERS]: [CORE_APP_ROLES.APP_USER],\n          },\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }],\n      },\n      [CoreResourceOperation.UPDATE]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          polymorphicRole: {\n            [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN],\n            [CoreResourceType.USERS]: [CORE_APP_ROLES.APP_USER],\n          },\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }],\n      },\n    },\n  },\n);\n"]}
+{"version":3,"file":"usage-record.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/billing/usage-record.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Usage Record Resource Configuration — Polymorphic\n *\n * Produces 3 factory functions (one per scope variant) via the polymorphic factory.\n * Spread into the registry factory map:\n *   ...usageRecordsPolymorphicFactories\n */\n\nimport { CoreResourceOperation, CoreResourceType } from '../resources/resources.shared.core.definitions';\nimport {\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n} from '../resources/resources.shared.schemas';\nimport { createPolymorphicResourceConfigurations } from '../resources/utils/resource-polymorphism.factory';\nimport { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { usageRecordsPolymorphicDeclaration } from './usage-record.shared.schemas';\nimport { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas';\nimport { DataPortabilityProvenance } from '../compliance/privacy/subject-export.shared.schemas';\nimport { ErasureRetentionMode, ResourceDataSubjectKind } from '../compliance/privacy/impersonalization.shared.schemas';\n\nexport const usageRecordsPolymorphicFactories = createPolymorphicResourceConfigurations(\n  usageRecordsPolymorphicDeclaration,\n  {\n    isSystemResource: true,\n    /** Subject-export disclosure. The subject's own usage records. Secrets and backend-only values are withheld by the export's security floor regardless of this grant. On a polymorphic resource this grant applies to EVERY generated variant, which is the documented intent of the shared config. */\n    systemAccessPolicy: { exportSubject: ResourceSystemAccessMode.ALLOWED },\n    portabilityPolicy: { defaultProvenance: DataPortabilityProvenance.OBSERVED },\n\n    /**\n     * Subject erasure RETAINS this row and scrubs nothing, because there is nothing here to scrub.\n *\n * `RETAIN_ONLY` is a positive ASSERTION that this resource holds no personal data of its own. The row is\n * metered usage — a product key, a quantity and a period — amounts and contract terms about the ACCOUNT. They\n * describe nobody once the linked USER row is scrubbed, and they must survive erasure for the tax/audit\n * obligation this family exists to serve, so they can be neither scrubbed nor honestly declared as\n * personal data the row holds. The person is the scope foreign key, which the never-scrub floor protects.\n *\n * The assertion is CHECKED in both directions: the factory refuses `RETAIN_ONLY` if any field declares an\n * impersonalize treatment, and (since 2026-08-31) if any non-floor field declares `.dataCategories()`.\n     */\n    retentionPolicy: {\n      mode: ErasureRetentionMode.RETAIN_ONLY,\n    },\n\n    /**\n     * Erasing one of these rows revokes NO session. The row is not a person — its owner FK names the ACTOR the\n *  record belongs to — and the enum prescribes `NO_PRINCIPAL` for exactly that shape. The subject's own\n *  session ends through the `USERS` row, which is `SELF_PRINCIPAL`.\n     */\n    dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },\n\n    coreOperations: [\n      CoreResourceOperation.READ,\n      CoreResourceOperation.LIST,\n      CoreResourceOperation.CREATE,\n      CoreResourceOperation.UPDATE,\n      // Route-less; `retentionPolicy` requires READ + LIST + UPDATE_MANY.\n      CoreResourceOperation.UPDATE_MANY,\n    ],\n    operationsConfiguration: {\n      /*\n       * Route-less retention plumbing — INTERNAL_CALL registers no route, so no API surface is added, and it\n       * must not be REPOSITORY_ONLY: the retention primitives resolve through `getServiceOperationPathDefault`,\n       * which matches only INTERNAL_CALL / API_CALL. LIST is LOW (a read-shaped op may not claim the\n       * HIGH/CRITICAL band, which carries an audit-emission obligation); UPDATE_MANY is CRITICAL — it is the\n       * verb the impersonalize writer uses to stamp the retention markers.\n       */\n      [CoreResourceOperation.UPDATE_MANY]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n          riskLevel: ResourceOperationRiskLevel.CRITICAL,\n        }],\n      },\n\n      [CoreResourceOperation.READ]: {\n        variants: [{\n          // API_CALL: usage records are a user-facing collection (Settings Hub → Billing →\n          // Usage, and the resource presets' LIST/READ views). REPOSITORY_ONLY would strip\n          // the op from the frontend registry and register no HTTP route. Writes are\n          // INTERNAL_CALL (service-pipeline; metered internally / by webhooks, not by users).\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          polymorphicRole: {\n            [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN],\n            [CoreResourceType.USERS]: [CORE_APP_ROLES.APP_USER],\n          },\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }],\n      },\n      [CoreResourceOperation.LIST]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.API_CALL,\n          isDefault: true,\n          polymorphicRole: {\n            [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN],\n            [CoreResourceType.USERS]: [CORE_APP_ROLES.APP_USER],\n          },\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }],\n      },\n      [CoreResourceOperation.CREATE]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          polymorphicRole: {\n            [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN],\n            [CoreResourceType.USERS]: [CORE_APP_ROLES.APP_USER],\n          },\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }],\n      },\n      [CoreResourceOperation.UPDATE]: {\n        variants: [{\n          variantType: ResourceOperationVariantType.INTERNAL_CALL,\n          isDefault: true,\n          polymorphicRole: {\n            [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN],\n            [CoreResourceType.USERS]: [CORE_APP_ROLES.APP_USER],\n          },\n          riskLevel: ResourceOperationRiskLevel.LOW,\n        }],\n      },\n    },\n  },\n);\n"]}

package/dist/esm/billing/usage-record.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-record.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/usage-record.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,0BAA0B,CAAC;AAGlC,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEvH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;iBAsE5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;kBAQ7C,CAAC"}
+{"version":3,"file":"usage-record.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/usage-record.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,0BAA0B,CAAC;AAGlC,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEvH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;iBAsE5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;kBAQ7C,CAAC"}

package/dist/esm/billing/usage-record.shared.schemas.js

@@ -24,7 +24,7 @@ import { BILLING_SCOPE_VARIANTS, BILLING_SCOPE_FK_VARIANTS } from './billing-acc
 import { UsageRecordFlushState, UsageRecordUnreportableReason, UsageSourceType } from './billing-enums.shared.schemas.js';
 export const UsageRecordSchema = z.object({
     _id: z.string().min(1).isPrimaryKey(),
-    billingAccountId: z.string().min(1).isForeignKey({ polymorphicVariants: BILLING_SCOPE_FK_VARIANTS }).isDBIndexed().isSummaryField(),
+    billingAccountId: z.string().min(1).isForeignKey({ polymorphicVariants: BILLING_SCOPE_FK_VARIANTS }).isDBIndexed().isSummaryField().describe("The id of the billing account this usage is billed to."),
     /** Product key for grouping/lookup (matches ProductDefinition.key) */
     // No `.dataCategories()`: this is an amount/term about the ACCOUNT, not a description of a person.
     // The person is the scope foreign key, which the never-scrub floor preserves in every mode, and the
@@ -40,10 +40,10 @@ export const UsageRecordSchema = z.object({
     timestamp: z.date().isDBIndexed().isSummaryField().isNotEditable(),
     /** What generated this usage */
     source: z.object({
-        type: z.enum(UsageSourceType),
-        resourceType: z.string().optional(),
-        operationIdentifier: z.string().optional(),
-        description: z.string().optional(),
+        type: z.enum(UsageSourceType).describe("What recorded the usage. `operation` is usage a resource operation declares and records when it succeeds; the other values are for usage the application records itself."),
+        resourceType: z.string().optional().describe("For `operation` usage, the resource whose operation recorded it."),
+        operationIdentifier: z.string().optional().describe("For `operation` usage, the operation that recorded it."),
+        description: z.string().optional().describe("A short note on what generated the usage."),
     }).optional().isNotEditable(),
     /**
      * Where this row stands with respect to the provider flush.

package/dist/esm/billing/usage-record.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-record.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/usage-record.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Usage Record Schema (Shared) — Polymorphic\n *\n * Tracks metered usage for METERED products. The current metering service groups\n * unreported rows by billing account and product when its scheduled flush runs.\n * `ProductBehaviorPolicy.metering` is an authored policy surface, but the current\n * flush scheduler does not consume its interval, window or retry members; do not\n * present those values as an effective reporting schedule until that runtime join exists.\n *\n * POLYMORPHIC EXPANSION: Like subscriptions, usage records are scope-expanded.\n * The `billingAccountId` FK is renamed per variant via polymorphic FK transformation:\n *   - organizationUsageRecords  (with organizationId + organizationBillingAccountId)\n *   - userUsageRecords          (with userId + userBillingAccountId)\n *\n *\n * @see billing-and-features-system.md §6.6 (Usage Records)\n */\n\nimport { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first —\n// never by the importer's luck (#966). A named import used only as a type would be elided and install nothing.\nimport '@wildo-ai/zod-decorators';\nimport { declarePolymorphicSchemas, optOutPolymorphicAutoBusinessKey } from '../resources/utils/resource-polymorphism.schemas';\nimport { BILLING_SCOPE_VARIANTS, BILLING_SCOPE_FK_VARIANTS } from './billing-account.shared.schemas';\nimport { UsageRecordFlushState, UsageRecordUnreportableReason, UsageSourceType } from './billing-enums.shared.schemas';\n\nexport const UsageRecordSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey(),\n  billingAccountId: z.string().min(1).isForeignKey({ polymorphicVariants: BILLING_SCOPE_FK_VARIANTS }).isDBIndexed().isSummaryField(),\n  /** Product key for grouping/lookup (matches ProductDefinition.key) */\n  // No `.dataCategories()`: this is an amount/term about the ACCOUNT, not a description of a person.\n  // The person is the scope foreign key, which the never-scrub floor preserves in every mode, and the\n  // value must survive erasure for the tax/audit obligation this family exists to serve — so it can be\n  // neither scrubbed nor honestly declared as personal data the row holds. See `retentionPolicy` on the\n  // resource config (#138).\n  productKey: z.string().min(1).isDBIndexed().isSummaryField().isNotEditable(),\n\n  /** Usage quantity */\n  // USAGE, not FINANCIAL. A metered quantity is what the person DID in the product; the money it\n  // becomes lives on the invoice. Two different sentences in a notice, and they read differently.\n  quantity: z.number().min(0).isSummaryField(),\n  /** When the usage occurred */\n  timestamp: z.date().isDBIndexed().isSummaryField().isNotEditable(),\n\n  /** What generated this usage */\n  source: z.object({\n    type: z.enum(UsageSourceType),\n    resourceType: z.string().optional(),\n    operationIdentifier: z.string().optional(),\n    description: z.string().optional(),\n  }).optional().isNotEditable(),\n\n  /**\n   * Where this row stands with respect to the provider flush.\n   *\n   * The flush selects exactly `PENDING`, so this ONE indexed field decides whether a row is still\n   * work. It replaced a `reportedToProvider` boolean on 2026-09-09 (#512): a boolean has no way to\n   * say \"this can never be reported\", so rows whose billing account had been deleted were\n   * re-selected by every run forever. See {@link UsageRecordFlushState} for why all three states are\n   * semantically distinct and why the shortcut of marking them reported was refused.\n   */\n  flushState: z.enum(UsageRecordFlushState).default(UsageRecordFlushState.PENDING).isDBIndexed().isNotEditable().systemEnum('UsageRecordFlushState'),\n  /** When the PROVIDER acknowledged the quantity. Set only alongside `flushState: reported`. */\n  reportedAt: z.date().optional().isNotEditable(),\n  /**\n   * Why this row can never be reported. Set only alongside `flushState: unreportable`.\n   *\n   * Separate from `reportedAt` on purpose: that timestamp records an acknowledgement by the\n   * provider, this pair records a determination made locally, and merging them would put two\n   * different events under one name.\n   */\n  unreportableReason: z.enum(UsageRecordUnreportableReason).optional().isNotEditable().systemEnum('UsageRecordUnreportableReason'),\n  /** When the flush determined this row unreportable. Set only alongside `unreportableReason`. */\n  unreportableAt: z.date().optional().isNotEditable(),\n\n  /**\n   * Open key-value bag for operational tagging (cost-centre, campaign ref, internal correlation id).\n   *\n   * ⚠️ **AUTHORING RULE — never store personal data here.** This row is RETAINED when its subject is\n   * erased: the billing-retention decision keeps the financial record for tax/audit obligations, and\n   * subject erasure scrubs the linked USER rather than these rows, because a billing row holds no\n   * personal data of its own — the person is a foreign key. An open bag is the one place that\n   * assumption can be broken by an app author, and nothing would catch it: the erasure scrub is\n   * field-directed (`.impersonalizeWith()`), and it cannot reach inside an arbitrary record whose\n   * keys it does not know.\n   *\n   * Concretely: no names, emails, phone numbers, addresses, free-text notes about a person, or\n   * anything else that identifies one. Personal data written here SURVIVES an erasure — a compliance\n   * breach that the retained label makes look intentional.\n   *\n   * Enforcement is deliberately NOT built (Q3, 2026-07-31): scrubbing these rows would require\n   * hide/freeze to become separable from scrub — a real capability change with no current consumer.\n   * Revisit only if an app is found using the bag this way.\n   */\n  metadata: z.record(z.string(), z.string()).optional(),\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n});\nexport type UsageRecord = z.infer<typeof UsageRecordSchema>;\n\n// ── Polymorphic Declaration ────────────────────────────────────────\n\nexport const usageRecordsPolymorphicDeclaration = declarePolymorphicSchemas({\n  baseResourceType: 'usageRecords',\n  baseFieldIdentifier: 'usageRecordId',\n  baseEnumKey: 'USAGE_RECORDS',\n  baseSchema: UsageRecordSchema,\n  // Many metered usage rows per scope — opt out of the polymorphism engine's\n  // singleton-per-scope business-key auto-default.\n  variants: BILLING_SCOPE_VARIANTS.map(optOutPolymorphicAutoBusinessKey),\n});\n"]}
+{"version":3,"file":"usage-record.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/usage-record.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Usage Record Schema (Shared) — Polymorphic\n *\n * Tracks metered usage for METERED products. The current metering service groups\n * unreported rows by billing account and product when its scheduled flush runs.\n * `ProductBehaviorPolicy.metering` is an authored policy surface, but the current\n * flush scheduler does not consume its interval, window or retry members; do not\n * present those values as an effective reporting schedule until that runtime join exists.\n *\n * POLYMORPHIC EXPANSION: Like subscriptions, usage records are scope-expanded.\n * The `billingAccountId` FK is renamed per variant via polymorphic FK transformation:\n *   - organizationUsageRecords  (with organizationId + organizationBillingAccountId)\n *   - userUsageRecords          (with userId + userBillingAccountId)\n *\n *\n * @see billing-and-features-system.md §6.6 (Usage Records)\n */\n\nimport { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first —\n// never by the importer's luck (#966). A named import used only as a type would be elided and install nothing.\nimport '@wildo-ai/zod-decorators';\nimport { declarePolymorphicSchemas, optOutPolymorphicAutoBusinessKey } from '../resources/utils/resource-polymorphism.schemas';\nimport { BILLING_SCOPE_VARIANTS, BILLING_SCOPE_FK_VARIANTS } from './billing-account.shared.schemas';\nimport { UsageRecordFlushState, UsageRecordUnreportableReason, UsageSourceType } from './billing-enums.shared.schemas';\n\nexport const UsageRecordSchema = z.object({\n  _id: z.string().min(1).isPrimaryKey(),\n  billingAccountId: z.string().min(1).isForeignKey({ polymorphicVariants: BILLING_SCOPE_FK_VARIANTS }).isDBIndexed().isSummaryField().describe(\"The id of the billing account this usage is billed to.\"),\n  /** Product key for grouping/lookup (matches ProductDefinition.key) */\n  // No `.dataCategories()`: this is an amount/term about the ACCOUNT, not a description of a person.\n  // The person is the scope foreign key, which the never-scrub floor preserves in every mode, and the\n  // value must survive erasure for the tax/audit obligation this family exists to serve — so it can be\n  // neither scrubbed nor honestly declared as personal data the row holds. See `retentionPolicy` on the\n  // resource config (#138).\n  productKey: z.string().min(1).isDBIndexed().isSummaryField().isNotEditable(),\n\n  /** Usage quantity */\n  // USAGE, not FINANCIAL. A metered quantity is what the person DID in the product; the money it\n  // becomes lives on the invoice. Two different sentences in a notice, and they read differently.\n  quantity: z.number().min(0).isSummaryField(),\n  /** When the usage occurred */\n  timestamp: z.date().isDBIndexed().isSummaryField().isNotEditable(),\n\n  /** What generated this usage */\n  source: z.object({\n    type: z.enum(UsageSourceType).describe(\"What recorded the usage. `operation` is usage a resource operation declares and records when it succeeds; the other values are for usage the application records itself.\"),\n    resourceType: z.string().optional().describe(\"For `operation` usage, the resource whose operation recorded it.\"),\n    operationIdentifier: z.string().optional().describe(\"For `operation` usage, the operation that recorded it.\"),\n    description: z.string().optional().describe(\"A short note on what generated the usage.\"),\n  }).optional().isNotEditable(),\n\n  /**\n   * Where this row stands with respect to the provider flush.\n   *\n   * The flush selects exactly `PENDING`, so this ONE indexed field decides whether a row is still\n   * work. It replaced a `reportedToProvider` boolean on 2026-09-09 (#512): a boolean has no way to\n   * say \"this can never be reported\", so rows whose billing account had been deleted were\n   * re-selected by every run forever. See {@link UsageRecordFlushState} for why all three states are\n   * semantically distinct and why the shortcut of marking them reported was refused.\n   */\n  flushState: z.enum(UsageRecordFlushState).default(UsageRecordFlushState.PENDING).isDBIndexed().isNotEditable().systemEnum('UsageRecordFlushState'),\n  /** When the PROVIDER acknowledged the quantity. Set only alongside `flushState: reported`. */\n  reportedAt: z.date().optional().isNotEditable(),\n  /**\n   * Why this row can never be reported. Set only alongside `flushState: unreportable`.\n   *\n   * Separate from `reportedAt` on purpose: that timestamp records an acknowledgement by the\n   * provider, this pair records a determination made locally, and merging them would put two\n   * different events under one name.\n   */\n  unreportableReason: z.enum(UsageRecordUnreportableReason).optional().isNotEditable().systemEnum('UsageRecordUnreportableReason'),\n  /** When the flush determined this row unreportable. Set only alongside `unreportableReason`. */\n  unreportableAt: z.date().optional().isNotEditable(),\n\n  /**\n   * Open key-value bag for operational tagging (cost-centre, campaign ref, internal correlation id).\n   *\n   * ⚠️ **AUTHORING RULE — never store personal data here.** This row is RETAINED when its subject is\n   * erased: the billing-retention decision keeps the financial record for tax/audit obligations, and\n   * subject erasure scrubs the linked USER rather than these rows, because a billing row holds no\n   * personal data of its own — the person is a foreign key. An open bag is the one place that\n   * assumption can be broken by an app author, and nothing would catch it: the erasure scrub is\n   * field-directed (`.impersonalizeWith()`), and it cannot reach inside an arbitrary record whose\n   * keys it does not know.\n   *\n   * Concretely: no names, emails, phone numbers, addresses, free-text notes about a person, or\n   * anything else that identifies one. Personal data written here SURVIVES an erasure — a compliance\n   * breach that the retained label makes look intentional.\n   *\n   * Enforcement is deliberately NOT built (Q3, 2026-07-31): scrubbing these rows would require\n   * hide/freeze to become separable from scrub — a real capability change with no current consumer.\n   * Revisit only if an app is found using the bag this way.\n   */\n  metadata: z.record(z.string(), z.string()).optional(),\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n});\nexport type UsageRecord = z.infer<typeof UsageRecordSchema>;\n\n// ── Polymorphic Declaration ────────────────────────────────────────\n\nexport const usageRecordsPolymorphicDeclaration = declarePolymorphicSchemas({\n  baseResourceType: 'usageRecords',\n  baseFieldIdentifier: 'usageRecordId',\n  baseEnumKey: 'USAGE_RECORDS',\n  baseSchema: UsageRecordSchema,\n  // Many metered usage rows per scope — opt out of the polymorphism engine's\n  // singleton-per-scope business-key auto-default.\n  variants: BILLING_SCOPE_VARIANTS.map(optOutPolymorphicAutoBusinessKey),\n});\n"]}

package/dist/esm/charts/aggregation-query.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregation-query.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/charts/aggregation-query.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAI1C,eAAO,MAAM,aAAa;;;;;;;;;iBAqBxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIpD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;iBAwC1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,qBAAqB;;;;;iBAkBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,oBAAoB;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,kBAAkB;;;;;;iBAW7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,kBAAkB;;;;iBAO7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,mBAAmB;;;;;iBAO9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AA0ChE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaE,CAAC;AACtC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,iCAAiC,wCAAoC,CAAC;AACnF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,0BAA0B;;;;;iBASrC,CAAC;AAKH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,8BAA8B;;;;;;;;iBAKzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}
+{"version":3,"file":"aggregation-query.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/charts/aggregation-query.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAI1C,eAAO,MAAM,aAAa;;;;;;;;;iBAqBxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIpD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;iBAwC1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,qBAAqB;;;;;iBAkBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,oBAAoB;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,kBAAkB;;;;;;iBAW7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,kBAAkB;;;;iBAO7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,mBAAmB;;;;;iBAO9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AA0ChE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaE,CAAC;AACtC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,iCAAiC,wCAAoC,CAAC;AACnF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,0BAA0B;;;;;iBASrC,CAAC;AAKH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,8BAA8B;;;;;;;;iBAKzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/esm/charts/aggregation-query.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregation-query.shared.schemas.js","sourceRoot":"","sources":["../../../../src/charts/aggregation-query.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * Aggregation Query Schemas\n * \n * Declarative data query spec — database-agnostic.\n * Charts are the first consumer; other consumers (counts, facets, exports)\n * use AggregationQuerySchema directly.\n * ────────────────────────────────────────────────────────────── */\n\nimport { z } from 'zod';\nimport {\n  AggregateFunction,\n  TimeGranularity,\n  SortDirection,\n  ComparisonOperator,\n  JoinType,\n  ContextFilterSource,\n  WindowFunctionType,\n  DimensionSortBy,\n} from './aggregation.shared.definitions';\n\n// ── Measure Schema ───────────────────────────────────────────\n\nexport const MeasureSchema = z.object({\n  /** Unique ref for this measure (used in computed measures, orderBy, series mapping) */\n  ref: z.string(),\n  /** Field to aggregate. Use '*' for COUNT(*). Use dot notation for joined fields. */\n  field: z.string(),\n  /** Aggregation function */\n  aggregate: z.enum(AggregateFunction),\n  /** Display label */\n  label: z.string().optional(),\n\n  // Function-specific params\n  /** For PERCENTILE: which percentile (0-100) */\n  percentileValue: z.number().min(0).max(100).optional(),\n  /** For STRING_AGG: separator */\n  separator: z.string().optional(),\n  /** For ARRAY_AGG: max items */\n  arrayLimit: z.number().positive().optional(),\n\n  // Measure-level filter\n  /** Filter applied ONLY to this measure (SQL FILTER WHERE / MongoDB $cond) */\n  filter: z.record(z.string(), z.unknown()).optional(),\n});\nexport type Measure = z.infer<typeof MeasureSchema>;\n\n// ── Dimension Schema ─────────────────────────────────────────\n\nexport const DimensionSchema = z.object({\n  /** Unique ref for this dimension */\n  ref: z.string(),\n  /** Field to group by. Dot notation for joined fields. */\n  field: z.string(),\n  /** Display label */\n  label: z.string().optional(),\n\n  // Time dimension\n  /** For temporal fields: bucket granularity */\n  timeGranularity: z.enum(TimeGranularity).optional(),\n  /** For time: fill empty buckets with zero/null */\n  fillMissingBuckets: z.boolean().optional(),\n  /** For time: custom date range (overrides global filter) */\n  dateRange: z.object({\n    from: z.string().optional(),\n    to: z.string().optional(),\n  }).optional(),\n\n  // Bucketing (non-time)\n  /** Numeric binning: { step: 10 } or { boundaries: [0, 50, 100, 500] } */\n  bin: z.union([\n    z.object({ step: z.number().positive() }),\n    z.object({ boundaries: z.array(z.number()) }),\n  ]).optional(),\n\n  // Sorting\n  sort: z.object({\n    direction: z.enum(SortDirection).default(SortDirection.ASC),\n    /** Sort by this dimension's values, or by a measure ref */\n    by: z.enum(DimensionSortBy).default(DimensionSortBy.SELF),\n    /** If by='measure': which measure ref to sort by */\n    measureRef: z.string().optional(),\n  }).optional(),\n\n  // Limiting / top-N\n  /** Only return top N values for this dimension */\n  topN: z.number().positive().optional(),\n  /** Group remaining values into \"Other\" bucket */\n  groupOther: z.boolean().optional(),\n});\nexport type Dimension = z.infer<typeof DimensionSchema>;\n\n// ── Computed Measure Schema (post-aggregation) ───────────────\n\nexport const ComputedMeasureSchema = z.object({\n  /** Unique ref */\n  ref: z.string(),\n  /** Display label */\n  label: z.string().optional(),\n  /**\n   * Expression using measure refs as variables.\n   * Supported operators: +, -, *, /, %, (, )\n   * Built-in functions: round(x, decimals), abs(x), coalesce(x, fallback), min(x, y), max(x, y)\n   * \n   * Examples:\n   *   \"completed_count / total_count * 100\"\n   *   \"round(revenue / order_count, 2)\"\n   *   \"coalesce(returning_users / total_users * 100, 0)\"\n   */\n  expression: z.string(),\n  /** Measure refs used in the expression (for validation) */\n  dependsOn: z.array(z.string()),\n});\nexport type ComputedMeasure = z.infer<typeof ComputedMeasureSchema>;\n\n// ── Window Function Schema ───────────────────────────────────\n\nexport const WindowFunctionSchema = z.object({\n  ref: z.string(),\n  label: z.string().optional(),\n  /** The base measure or dimension ref to transform */\n  sourceRef: z.string(),\n  type: z.enum(WindowFunctionType),\n  /** For moving_avg: window size */\n  windowSize: z.number().positive().optional(),\n  /** Partition by dimension ref (for segmented windows) */\n  partitionBy: z.string().optional(),\n  /** Order by dimension ref (defaults to first time dimension) */\n  orderBy: z.string().optional(),\n});\nexport type WindowFunction = z.infer<typeof WindowFunctionSchema>;\n\n// ── Cross-Resource Join Schema ───────────────────────────────\n\nexport const ResourceJoinSchema = z.object({\n  /** Resource type to join */\n  resourceType: z.string(),\n  /** FK field on the source side (must exist in ResourceRelationship definitions) */\n  foreignKeyField: z.string(),\n  /** Alias prefix for joined fields (e.g., \"customer\" → \"customer.name\") */\n  alias: z.string(),\n  /** Optional: only include specific fields from joined resource */\n  selectFields: z.array(z.string()).optional(),\n  /** Join type — defaults to LEFT (null-safe for aggregation) */\n  joinType: z.enum(JoinType).default(JoinType.LEFT),\n});\nexport type ResourceJoin = z.infer<typeof ResourceJoinSchema>;\n\n// ── HAVING Clause ────────────────────────────────────────────\n\nexport const HavingClauseSchema = z.object({\n  /** Measure ref to filter on */\n  measureRef: z.string(),\n  /** Comparison operator */\n  operator: z.enum(ComparisonOperator),\n  /** Value to compare against */\n  value: z.number(),\n});\nexport type HavingClause = z.infer<typeof HavingClauseSchema>;\n\n// ── Context Filter Schema ────────────────────────────────────\n\nexport const ContextFilterSchema = z.object({\n  field: z.string(),\n  /** Comparison operator — defaults to EQ. Use GTE/LTE for date ranges. */\n  operator: z.enum(ComparisonOperator).default(ComparisonOperator.EQ),\n  source: z.enum(ContextFilterSource),\n  /** Source field name (URL param name, parent field name, user field name) */\n  sourceField: z.string().optional(),\n});\nexport type ContextFilter = z.infer<typeof ContextFilterSchema>;\n\n// ── The Complete AggregationQuery Schema ─────────────────────\n\nconst AggregationQueryObjectSchema = z.object({\n  /** Primary resource */\n  mainResourceType: z.string(),\n\n  /** Static filters (ResourceFilter syntax — same as LIST/SEARCH) */\n  filters: z.record(z.string(), z.unknown()).optional(),\n  /** Context-injected filters (resolved at query time) */\n  contextFilters: z.array(ContextFilterSchema).optional(),\n\n  /** Dimensions & Measures */\n  dimensions: z.array(DimensionSchema).min(1),\n  measures: z.array(MeasureSchema).min(1),\n\n  /** Post-aggregation */\n  computedMeasures: z.array(ComputedMeasureSchema).optional(),\n  windowFunctions: z.array(WindowFunctionSchema).optional(),\n\n  /** Cross-resource */\n  joins: z.array(ResourceJoinSchema).optional(),\n\n  /** Result shaping */\n  having: z.array(HavingClauseSchema).optional(),\n  limit: z.number().positive().max(10000).optional(),\n  orderBy: z.array(z.object({\n    ref: z.string(),\n    direction: z.enum(SortDirection).default(SortDirection.ASC),\n  })).optional(),\n\n  /** Max query execution time in ms. Default: 30000 (30s). Max: 60000 (60s). */\n  timeoutMs: z.number().positive().max(60_000).default(30_000).optional(),\n\n  /**\n   * IANA timezone for time dimension bucketing (e.g., 'Europe/Paris', 'America/New_York').\n   * If omitted, resolved at query time from the user's session/organization settings.\n   */\n  timezone: z.string().optional(),\n});\n\n/**\n * `refreshInterval` used to sit on `AggregationQuery`, but polling semantics are\n * owned by `ChartDefinition`. Reject the legacy nested field explicitly so\n * hand-authored configs fail fast instead of being silently stripped.\n */\nexport const AggregationQuerySchema = z.unknown().superRefine((value, ctx) => {\n  if (\n    value &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    Object.prototype.hasOwnProperty.call(value, 'refreshInterval')\n  ) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['refreshInterval'],\n      message: 'AggregationQuery.refreshInterval has been removed. Use ChartDefinition.refreshInterval instead.',\n    });\n  }\n}).pipe(AggregationQueryObjectSchema);\nexport type AggregationQuery = z.infer<typeof AggregationQuerySchema>;\n\n// ── Aggregation Query Response Schemas ───────────────────────\n\nexport const AggregationQueryResponseRowSchema = z.record(z.string(), z.unknown());\nexport type AggregationQueryResponseRow = z.infer<typeof AggregationQueryResponseRowSchema>;\n\nexport const AggregationQueryMetaSchema = z.object({\n  /** Server-side execution time in ms */\n  executionTimeMs: z.number().optional(),\n  /** Total rows returned (before limit) */\n  totalRows: z.number().optional(),\n  /** Whether result was truncated by limit */\n  truncated: z.boolean().optional(),\n  /** Resolved timezone used for bucketing */\n  resolvedTimezone: z.string().optional(),\n});\n// Meta fields are diagnostic/advisory — a chart renders from `data` alone. They are\n// OPTIONAL so a valid `data` payload is never rejected because the producer omitted a\n// meta field (the frontend validates the whole response and would otherwise blank a\n// good chart over a missing `executionTimeMs`/`truncated`/etc.).\nexport type AggregationQueryMeta = z.infer<typeof AggregationQueryMetaSchema>;\n\nexport const AggregationQueryResponseSchema = z.object({\n  /** Result rows — each row is a record keyed by dimension/measure ref */\n  data: z.array(AggregationQueryResponseRowSchema),\n  /** Query execution metadata */\n  queryMeta: AggregationQueryMetaSchema,\n});\nexport type AggregationQueryResponse = z.infer<typeof AggregationQueryResponseSchema>;\n"]}
+{"version":3,"file":"aggregation-query.shared.schemas.js","sourceRoot":"","sources":["../../../src/charts/aggregation-query.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * Aggregation Query Schemas\n * \n * Declarative data query spec — database-agnostic.\n * Charts are the first consumer; other consumers (counts, facets, exports)\n * use AggregationQuerySchema directly.\n * ────────────────────────────────────────────────────────────── */\n\nimport { z } from 'zod';\nimport {\n  AggregateFunction,\n  TimeGranularity,\n  SortDirection,\n  ComparisonOperator,\n  JoinType,\n  ContextFilterSource,\n  WindowFunctionType,\n  DimensionSortBy,\n} from './aggregation.shared.definitions';\n\n// ── Measure Schema ───────────────────────────────────────────\n\nexport const MeasureSchema = z.object({\n  /** Unique ref for this measure (used in computed measures, orderBy, series mapping) */\n  ref: z.string(),\n  /** Field to aggregate. Use '*' for COUNT(*). Use dot notation for joined fields. */\n  field: z.string(),\n  /** Aggregation function */\n  aggregate: z.enum(AggregateFunction),\n  /** Display label */\n  label: z.string().optional(),\n\n  // Function-specific params\n  /** For PERCENTILE: which percentile (0-100) */\n  percentileValue: z.number().min(0).max(100).optional(),\n  /** For STRING_AGG: separator */\n  separator: z.string().optional(),\n  /** For ARRAY_AGG: max items */\n  arrayLimit: z.number().positive().optional(),\n\n  // Measure-level filter\n  /** Filter applied ONLY to this measure (SQL FILTER WHERE / MongoDB $cond) */\n  filter: z.record(z.string(), z.unknown()).optional(),\n});\nexport type Measure = z.infer<typeof MeasureSchema>;\n\n// ── Dimension Schema ─────────────────────────────────────────\n\nexport const DimensionSchema = z.object({\n  /** Unique ref for this dimension */\n  ref: z.string(),\n  /** Field to group by. Dot notation for joined fields. */\n  field: z.string(),\n  /** Display label */\n  label: z.string().optional(),\n\n  // Time dimension\n  /** For temporal fields: bucket granularity */\n  timeGranularity: z.enum(TimeGranularity).optional(),\n  /** For time: fill empty buckets with zero/null */\n  fillMissingBuckets: z.boolean().optional(),\n  /** For time: custom date range (overrides global filter) */\n  dateRange: z.object({\n    from: z.string().optional(),\n    to: z.string().optional(),\n  }).optional(),\n\n  // Bucketing (non-time)\n  /** Numeric binning: { step: 10 } or { boundaries: [0, 50, 100, 500] } */\n  bin: z.union([\n    z.object({ step: z.number().positive() }),\n    z.object({ boundaries: z.array(z.number()) }),\n  ]).optional(),\n\n  // Sorting\n  sort: z.object({\n    direction: z.enum(SortDirection).default(SortDirection.ASC),\n    /** Sort by this dimension's values, or by a measure ref */\n    by: z.enum(DimensionSortBy).default(DimensionSortBy.SELF),\n    /** If by='measure': which measure ref to sort by */\n    measureRef: z.string().optional(),\n  }).optional(),\n\n  // Limiting / top-N\n  /** Only return top N values for this dimension */\n  topN: z.number().positive().optional(),\n  /** Group remaining values into \"Other\" bucket */\n  groupOther: z.boolean().optional(),\n});\nexport type Dimension = z.infer<typeof DimensionSchema>;\n\n// ── Computed Measure Schema (post-aggregation) ───────────────\n\nexport const ComputedMeasureSchema = z.object({\n  /** Unique ref */\n  ref: z.string(),\n  /** Display label */\n  label: z.string().optional(),\n  /**\n   * Expression using measure refs as variables.\n   * Supported operators: +, -, *, /, %, (, )\n   * Built-in functions: round(x, decimals), abs(x), coalesce(x, fallback), min(x, y), max(x, y)\n   * \n   * Examples:\n   *   \"completed_count / total_count * 100\"\n   *   \"round(revenue / order_count, 2)\"\n   *   \"coalesce(returning_users / total_users * 100, 0)\"\n   */\n  expression: z.string(),\n  /** Measure refs used in the expression (for validation) */\n  dependsOn: z.array(z.string()),\n});\nexport type ComputedMeasure = z.infer<typeof ComputedMeasureSchema>;\n\n// ── Window Function Schema ───────────────────────────────────\n\nexport const WindowFunctionSchema = z.object({\n  ref: z.string(),\n  label: z.string().optional(),\n  /** The base measure or dimension ref to transform */\n  sourceRef: z.string(),\n  type: z.enum(WindowFunctionType),\n  /** For moving_avg: window size */\n  windowSize: z.number().positive().optional(),\n  /** Partition by dimension ref (for segmented windows) */\n  partitionBy: z.string().optional(),\n  /** Order by dimension ref (defaults to first time dimension) */\n  orderBy: z.string().optional(),\n});\nexport type WindowFunction = z.infer<typeof WindowFunctionSchema>;\n\n// ── Cross-Resource Join Schema ───────────────────────────────\n\nexport const ResourceJoinSchema = z.object({\n  /** Resource type to join */\n  resourceType: z.string(),\n  /** FK field on the source side (must exist in ResourceRelationship definitions) */\n  foreignKeyField: z.string(),\n  /** Alias prefix for joined fields (e.g., \"customer\" → \"customer.name\") */\n  alias: z.string(),\n  /** Optional: only include specific fields from joined resource */\n  selectFields: z.array(z.string()).optional(),\n  /** Join type — defaults to LEFT (null-safe for aggregation) */\n  joinType: z.enum(JoinType).default(JoinType.LEFT),\n});\nexport type ResourceJoin = z.infer<typeof ResourceJoinSchema>;\n\n// ── HAVING Clause ────────────────────────────────────────────\n\nexport const HavingClauseSchema = z.object({\n  /** Measure ref to filter on */\n  measureRef: z.string(),\n  /** Comparison operator */\n  operator: z.enum(ComparisonOperator),\n  /** Value to compare against */\n  value: z.number(),\n});\nexport type HavingClause = z.infer<typeof HavingClauseSchema>;\n\n// ── Context Filter Schema ────────────────────────────────────\n\nexport const ContextFilterSchema = z.object({\n  field: z.string(),\n  /** Comparison operator — defaults to EQ. Use GTE/LTE for date ranges. */\n  operator: z.enum(ComparisonOperator).default(ComparisonOperator.EQ),\n  source: z.enum(ContextFilterSource),\n  /** Source field name (URL param name, parent field name, user field name) */\n  sourceField: z.string().optional(),\n});\nexport type ContextFilter = z.infer<typeof ContextFilterSchema>;\n\n// ── The Complete AggregationQuery Schema ─────────────────────\n\nconst AggregationQueryObjectSchema = z.object({\n  /** Primary resource */\n  mainResourceType: z.string(),\n\n  /** Static filters (ResourceFilter syntax — same as LIST/SEARCH) */\n  filters: z.record(z.string(), z.unknown()).optional(),\n  /** Context-injected filters (resolved at query time) */\n  contextFilters: z.array(ContextFilterSchema).optional(),\n\n  /** Dimensions & Measures */\n  dimensions: z.array(DimensionSchema).min(1),\n  measures: z.array(MeasureSchema).min(1),\n\n  /** Post-aggregation */\n  computedMeasures: z.array(ComputedMeasureSchema).optional(),\n  windowFunctions: z.array(WindowFunctionSchema).optional(),\n\n  /** Cross-resource */\n  joins: z.array(ResourceJoinSchema).optional(),\n\n  /** Result shaping */\n  having: z.array(HavingClauseSchema).optional(),\n  limit: z.number().positive().max(10000).optional(),\n  orderBy: z.array(z.object({\n    ref: z.string(),\n    direction: z.enum(SortDirection).default(SortDirection.ASC),\n  })).optional(),\n\n  /** Max query execution time in ms. Default: 30000 (30s). Max: 60000 (60s). */\n  timeoutMs: z.number().positive().max(60_000).default(30_000).optional(),\n\n  /**\n   * IANA timezone for time dimension bucketing (e.g., 'Europe/Paris', 'America/New_York').\n   * If omitted, resolved at query time from the user's session/organization settings.\n   */\n  timezone: z.string().optional(),\n});\n\n/**\n * `refreshInterval` used to sit on `AggregationQuery`, but polling semantics are\n * owned by `ChartDefinition`. Reject the legacy nested field explicitly so\n * hand-authored configs fail fast instead of being silently stripped.\n */\nexport const AggregationQuerySchema = z.unknown().superRefine((value, ctx) => {\n  if (\n    value &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    Object.prototype.hasOwnProperty.call(value, 'refreshInterval')\n  ) {\n    ctx.addIssue({\n      code: 'custom',\n      path: ['refreshInterval'],\n      message: 'AggregationQuery.refreshInterval has been removed. Use ChartDefinition.refreshInterval instead.',\n    });\n  }\n}).pipe(AggregationQueryObjectSchema);\nexport type AggregationQuery = z.infer<typeof AggregationQuerySchema>;\n\n// ── Aggregation Query Response Schemas ───────────────────────\n\nexport const AggregationQueryResponseRowSchema = z.record(z.string(), z.unknown());\nexport type AggregationQueryResponseRow = z.infer<typeof AggregationQueryResponseRowSchema>;\n\nexport const AggregationQueryMetaSchema = z.object({\n  /** Server-side execution time in ms */\n  executionTimeMs: z.number().optional(),\n  /** Total rows returned (before limit) */\n  totalRows: z.number().optional(),\n  /** Whether result was truncated by limit */\n  truncated: z.boolean().optional(),\n  /** Resolved timezone used for bucketing */\n  resolvedTimezone: z.string().optional(),\n});\n// Meta fields are diagnostic/advisory — a chart renders from `data` alone. They are\n// OPTIONAL so a valid `data` payload is never rejected because the producer omitted a\n// meta field (the frontend validates the whole response and would otherwise blank a\n// good chart over a missing `executionTimeMs`/`truncated`/etc.).\nexport type AggregationQueryMeta = z.infer<typeof AggregationQueryMetaSchema>;\n\nexport const AggregationQueryResponseSchema = z.object({\n  /** Result rows — each row is a record keyed by dimension/measure ref */\n  data: z.array(AggregationQueryResponseRowSchema),\n  /** Query execution metadata */\n  queryMeta: AggregationQueryMetaSchema,\n});\nexport type AggregationQueryResponse = z.infer<typeof AggregationQueryResponseSchema>;\n"]}

package/dist/esm/charts/aggregation.shared.definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregation.shared.definitions.d.ts","sourceRoot":"","sources":["../../../../src/charts/aggregation.shared.definitions.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAIpE,oBAAY,iBAAiB;IAE3B,KAAK,UAAU;IACf,cAAc,mBAAmB;IACjC,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IAGX,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,QAAQ,aAAa;IAGrB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,OAAO,YAAY;IAGnB,SAAS,cAAc;IACvB,UAAU,eAAe;CAC1B;AAID,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAID,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAID,oBAAY,kBAAkB;IAC5B,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,GAAG,QAAQ;CACZ;AAID,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAID,oBAAY,mBAAmB;IAC7B,YAAY,gBAAgB;IAC5B,oBAAoB,wBAAwB;IAC5C,SAAS,aAAa;IACtB,eAAe,mBAAmB;CACnC;AAID,oBAAY,kBAAkB;IAC5B,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;IACrC,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,UAAU,eAAe;CAC1B;AAID,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAKD,oBAAY,oBAAoB;IAC9B,eAAe,oBAAoB;IACnC,mBAAmB,wBAAwB;IAC3C,gCAAgC,qCAAqC;IACrE,+BAA+B,oCAAoC;IACnE,qCAAqC,0CAA0C;IAC/E,8BAA8B,mCAAmC;CAClE"}
+{"version":3,"file":"aggregation.shared.definitions.d.ts","sourceRoot":"","sources":["../../../src/charts/aggregation.shared.definitions.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAIpE,oBAAY,iBAAiB;IAE3B,KAAK,UAAU;IACf,cAAc,mBAAmB;IACjC,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IAGX,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,QAAQ,aAAa;IAGrB,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,OAAO,YAAY;IAGnB,SAAS,cAAc;IACvB,UAAU,eAAe;CAC1B;AAID,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAID,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAID,oBAAY,kBAAkB;IAC5B,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,GAAG,QAAQ;CACZ;AAID,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAID,oBAAY,mBAAmB;IAC7B,YAAY,gBAAgB;IAC5B,oBAAoB,wBAAwB;IAC5C,SAAS,aAAa;IACtB,eAAe,mBAAmB;CACnC;AAID,oBAAY,kBAAkB;IAC5B,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,gBAAgB,qBAAqB;IACrC,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,UAAU,eAAe;CAC1B;AAID,oBAAY,eAAe;IACzB,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAKD,oBAAY,oBAAoB;IAC9B,eAAe,oBAAoB;IACnC,mBAAmB,wBAAwB;IAC3C,gCAAgC,qCAAqC;IACrE,+BAA+B,oCAAoC;IACnE,qCAAqC,0CAA0C;IAC/E,8BAA8B,mCAAmC;CAClE"}

package/dist/esm/charts/aggregation.shared.definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregation.shared.definitions.js","sourceRoot":"","sources":["../../../../src/charts/aggregation.shared.definitions.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAEpE,gEAAgE;AAEhE,MAAM,CAAN,IAAY,iBAuBX;AAvBD,WAAY,iBAAiB;IAC3B,QAAQ;IACR,oCAAe,CAAA;IACf,sDAAiC,CAAA;IACjC,gCAAW,CAAA;IACX,gCAAW,CAAA;IACX,gCAAW,CAAA;IACX,gCAAW,CAAA;IAEX,cAAc;IACd,sCAAiB,CAAA;IACjB,8CAAyB,CAAA;IACzB,sCAAiB,CAAA;IACjB,0CAAqB,CAAA;IAErB,sBAAsB;IACtB,4CAAuB,CAAA;IACvB,0CAAqB,CAAA;IACrB,wCAAmB,CAAA;IAEnB,QAAQ;IACR,4CAAuB,CAAA;IACvB,8CAAyB,CAAA;AAC3B,CAAC,EAvBW,iBAAiB,KAAjB,iBAAiB,QAuB5B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,gCAAa,CAAA;IACb,8BAAW,CAAA;IACX,gCAAa,CAAA;IACb,kCAAe,CAAA;IACf,sCAAmB,CAAA;IACnB,gCAAa,CAAA;AACf,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,8BAAa,CAAA;AACf,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,+BAAS,CAAA;IACT,+BAAS,CAAA;IACT,+BAAS,CAAA;IACT,iCAAW,CAAA;IACX,+BAAS,CAAA;IACT,iCAAW,CAAA;AACb,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;AACf,CAAC,EAHW,QAAQ,KAAR,QAAQ,QAGnB;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,mDAA4B,CAAA;IAC5B,mEAA4C,CAAA;IAC5C,6CAAsB,CAAA;IACtB,yDAAkC,CAAA;AACpC,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC5B,qDAA+B,CAAA;IAC/B,iDAA2B,CAAA;IAC3B,2DAAqC,CAAA;IACrC,mCAAa,CAAA;IACb,+CAAyB,CAAA;IACzB,iCAAW,CAAA;IACX,mCAAa,CAAA;IACb,+CAAyB,CAAA;IACzB,uDAAiC,CAAA;IACjC,+CAAyB,CAAA;AAC3B,CAAC,EAXW,kBAAkB,KAAlB,kBAAkB,QAW7B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,sCAAmB,CAAA;AACrB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED,gEAAgE;AAChE,6EAA6E;AAE7E,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,2DAAmC,CAAA;IACnC,mEAA2C,CAAA;IAC3C,6FAAqE,CAAA;IACrE,2FAAmE,CAAA;IACnE,uGAA+E,CAAA;IAC/E,yFAAiE,CAAA;AACnE,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * Aggregation Engine — Enums & Definitions\n * \n * Generic aggregation enums used by the chart system and any future\n * aggregation consumers (resource counts, facets, report exports).\n * All constant sets are TypeScript enums — Zod 4 accepts enums via z.enum(MyEnum).\n * ────────────────────────────────────────────────────────────── */\n\n// ── Aggregate Functions ──────────────────────────────────────\n\nexport enum AggregateFunction {\n  // Basic\n  COUNT = 'count',\n  COUNT_DISTINCT = 'count_distinct',\n  SUM = 'sum',\n  AVG = 'avg',\n  MIN = 'min',\n  MAX = 'max',\n\n  // Statistical\n  MEDIAN = 'median',\n  PERCENTILE = 'percentile',\n  STDDEV = 'stddev',\n  VARIANCE = 'variance',\n\n  // Boolean / existence\n  ANY_VALUE = 'any_value',\n  BOOL_AND = 'bool_and',\n  BOOL_OR = 'bool_or',\n\n  // Array\n  ARRAY_AGG = 'array_agg',\n  STRING_AGG = 'string_agg',\n}\n\n// ── Time Granularity ─────────────────────────────────────────\n\nexport enum TimeGranularity {\n  MINUTE = 'minute',\n  HOUR = 'hour',\n  DAY = 'day',\n  WEEK = 'week',\n  MONTH = 'month',\n  QUARTER = 'quarter',\n  YEAR = 'year',\n}\n\n// ── Sort Direction ───────────────────────────────────────────\n\nexport enum SortDirection {\n  ASC = 'asc',\n  DESC = 'desc',\n}\n\n// ── Comparison Operator ──────────────────────────────────────\n\nexport enum ComparisonOperator {\n  EQ = 'eq',\n  NE = 'ne',\n  GT = 'gt',\n  GTE = 'gte',\n  LT = 'lt',\n  LTE = 'lte',\n}\n\n// ── Join Type ────────────────────────────────────────────────\n\nexport enum JoinType {\n  INNER = 'inner',\n  LEFT = 'left',\n}\n\n// ── Context Filter Source ────────────────────────────────────\n\nexport enum ContextFilterSource {\n  CURRENT_USER = 'currentUser',\n  CURRENT_ORGANIZATION = 'currentOrganization',\n  URL_PARAM = 'urlParam',\n  PARENT_RESOURCE = 'parentResource',\n}\n\n// ── Window Function Type ─────────────────────────────────────\n\nexport enum WindowFunctionType {\n  RUNNING_TOTAL = 'running_total',\n  RUNNING_AVG = 'running_avg',\n  PERCENT_OF_TOTAL = 'percent_of_total',\n  RANK = 'rank',\n  DENSE_RANK = 'dense_rank',\n  LAG = 'lag',\n  LEAD = 'lead',\n  DIFFERENCE = 'difference',\n  PERCENT_CHANGE = 'percent_change',\n  MOVING_AVG = 'moving_avg',\n}\n\n// ── Dimension Sort By ────────────────────────────────────────\n\nexport enum DimensionSortBy {\n  SELF = 'self',\n  MEASURE = 'measure',\n}\n\n// ── Aggregation Error Codes ──────────────────────────────────\n// Used by ErrorBuilderBackendService and frontend ChartErrorState component.\n\nexport enum AggregationErrorCode {\n  CHART_NOT_FOUND = 'chart_not_found',\n  AGGREGATION_TIMEOUT = 'aggregation_timeout',\n  AGGREGATION_MAX_BUCKETS_EXCEEDED = 'aggregation_max_buckets_exceeded',\n  AGGREGATION_FIELD_ACCESS_DENIED = 'aggregation_field_access_denied',\n  AGGREGATION_COMPUTED_EXPRESSION_ERROR = 'aggregation_computed_expression_error',\n  AGGREGATION_JOIN_ACCESS_DENIED = 'aggregation_join_access_denied',\n}\n"]}
+{"version":3,"file":"aggregation.shared.definitions.js","sourceRoot":"","sources":["../../../src/charts/aggregation.shared.definitions.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAEpE,gEAAgE;AAEhE,MAAM,CAAN,IAAY,iBAuBX;AAvBD,WAAY,iBAAiB;IAC3B,QAAQ;IACR,oCAAe,CAAA;IACf,sDAAiC,CAAA;IACjC,gCAAW,CAAA;IACX,gCAAW,CAAA;IACX,gCAAW,CAAA;IACX,gCAAW,CAAA;IAEX,cAAc;IACd,sCAAiB,CAAA;IACjB,8CAAyB,CAAA;IACzB,sCAAiB,CAAA;IACjB,0CAAqB,CAAA;IAErB,sBAAsB;IACtB,4CAAuB,CAAA;IACvB,0CAAqB,CAAA;IACrB,wCAAmB,CAAA;IAEnB,QAAQ;IACR,4CAAuB,CAAA;IACvB,8CAAyB,CAAA;AAC3B,CAAC,EAvBW,iBAAiB,KAAjB,iBAAiB,QAuB5B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,gCAAa,CAAA;IACb,8BAAW,CAAA;IACX,gCAAa,CAAA;IACb,kCAAe,CAAA;IACf,sCAAmB,CAAA;IACnB,gCAAa,CAAA;AACf,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,8BAAa,CAAA;AACf,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,+BAAS,CAAA;IACT,+BAAS,CAAA;IACT,+BAAS,CAAA;IACT,iCAAW,CAAA;IACX,+BAAS,CAAA;IACT,iCAAW,CAAA;AACb,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,yBAAa,CAAA;AACf,CAAC,EAHW,QAAQ,KAAR,QAAQ,QAGnB;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,mDAA4B,CAAA;IAC5B,mEAA4C,CAAA;IAC5C,6CAAsB,CAAA;IACtB,yDAAkC,CAAA;AACpC,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,kBAWX;AAXD,WAAY,kBAAkB;IAC5B,qDAA+B,CAAA;IAC/B,iDAA2B,CAAA;IAC3B,2DAAqC,CAAA;IACrC,mCAAa,CAAA;IACb,+CAAyB,CAAA;IACzB,iCAAW,CAAA;IACX,mCAAa,CAAA;IACb,+CAAyB,CAAA;IACzB,uDAAiC,CAAA;IACjC,+CAAyB,CAAA;AAC3B,CAAC,EAXW,kBAAkB,KAAlB,kBAAkB,QAW7B;AAED,gEAAgE;AAEhE,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,gCAAa,CAAA;IACb,sCAAmB,CAAA;AACrB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED,gEAAgE;AAChE,6EAA6E;AAE7E,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,2DAAmC,CAAA;IACnC,mEAA2C,CAAA;IAC3C,6FAAqE,CAAA;IACrE,2FAAmE,CAAA;IACnE,uGAA+E,CAAA;IAC/E,yFAAiE,CAAA;AACnE,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B","sourcesContent":["/** ──────────────────────────────────────────────────────────────\n * Aggregation Engine — Enums & Definitions\n * \n * Generic aggregation enums used by the chart system and any future\n * aggregation consumers (resource counts, facets, report exports).\n * All constant sets are TypeScript enums — Zod 4 accepts enums via z.enum(MyEnum).\n * ────────────────────────────────────────────────────────────── */\n\n// ── Aggregate Functions ──────────────────────────────────────\n\nexport enum AggregateFunction {\n  // Basic\n  COUNT = 'count',\n  COUNT_DISTINCT = 'count_distinct',\n  SUM = 'sum',\n  AVG = 'avg',\n  MIN = 'min',\n  MAX = 'max',\n\n  // Statistical\n  MEDIAN = 'median',\n  PERCENTILE = 'percentile',\n  STDDEV = 'stddev',\n  VARIANCE = 'variance',\n\n  // Boolean / existence\n  ANY_VALUE = 'any_value',\n  BOOL_AND = 'bool_and',\n  BOOL_OR = 'bool_or',\n\n  // Array\n  ARRAY_AGG = 'array_agg',\n  STRING_AGG = 'string_agg',\n}\n\n// ── Time Granularity ─────────────────────────────────────────\n\nexport enum TimeGranularity {\n  MINUTE = 'minute',\n  HOUR = 'hour',\n  DAY = 'day',\n  WEEK = 'week',\n  MONTH = 'month',\n  QUARTER = 'quarter',\n  YEAR = 'year',\n}\n\n// ── Sort Direction ───────────────────────────────────────────\n\nexport enum SortDirection {\n  ASC = 'asc',\n  DESC = 'desc',\n}\n\n// ── Comparison Operator ──────────────────────────────────────\n\nexport enum ComparisonOperator {\n  EQ = 'eq',\n  NE = 'ne',\n  GT = 'gt',\n  GTE = 'gte',\n  LT = 'lt',\n  LTE = 'lte',\n}\n\n// ── Join Type ────────────────────────────────────────────────\n\nexport enum JoinType {\n  INNER = 'inner',\n  LEFT = 'left',\n}\n\n// ── Context Filter Source ────────────────────────────────────\n\nexport enum ContextFilterSource {\n  CURRENT_USER = 'currentUser',\n  CURRENT_ORGANIZATION = 'currentOrganization',\n  URL_PARAM = 'urlParam',\n  PARENT_RESOURCE = 'parentResource',\n}\n\n// ── Window Function Type ─────────────────────────────────────\n\nexport enum WindowFunctionType {\n  RUNNING_TOTAL = 'running_total',\n  RUNNING_AVG = 'running_avg',\n  PERCENT_OF_TOTAL = 'percent_of_total',\n  RANK = 'rank',\n  DENSE_RANK = 'dense_rank',\n  LAG = 'lag',\n  LEAD = 'lead',\n  DIFFERENCE = 'difference',\n  PERCENT_CHANGE = 'percent_change',\n  MOVING_AVG = 'moving_avg',\n}\n\n// ── Dimension Sort By ────────────────────────────────────────\n\nexport enum DimensionSortBy {\n  SELF = 'self',\n  MEASURE = 'measure',\n}\n\n// ── Aggregation Error Codes ──────────────────────────────────\n// Used by ErrorBuilderBackendService and frontend ChartErrorState component.\n\nexport enum AggregationErrorCode {\n  CHART_NOT_FOUND = 'chart_not_found',\n  AGGREGATION_TIMEOUT = 'aggregation_timeout',\n  AGGREGATION_MAX_BUCKETS_EXCEEDED = 'aggregation_max_buckets_exceeded',\n  AGGREGATION_FIELD_ACCESS_DENIED = 'aggregation_field_access_denied',\n  AGGREGATION_COMPUTED_EXPRESSION_ERROR = 'aggregation_computed_expression_error',\n  AGGREGATION_JOIN_ACCESS_DENIED = 'aggregation_join_access_denied',\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"chart-definition-builder.shared.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-definition-builder.shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chart-definition-builder.shared.d.ts","sourceRoot":"","sources":["../../../src/charts/chart-definition-builder.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;oEAiBoE;AAEpE,OAAO,EACL,SAAS,EAET,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EAEb,QAAQ,EACR,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAc1C,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,aAAa,CAAC;QAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,sBAAsB;IAwB/B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAxBpC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAC,CAA0B;IAC3C,OAAO,CAAC,cAAc,CAAC,CAAqB;IAC5C,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,CAAmD;IACpE,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,YAAY,CAAC,CAAmB;IACxC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,OAAO,CAAC,gBAAgB,CAAC,CAAkB;IAC3C,OAAO,CAAC,KAAK,CAAC,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAC,CAAyB;gBAGtB,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,MAAM;IAK5C,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAOhC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAiB1D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAsBhG,KAAK,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAOrC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAIlD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAIlD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAIlD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAIlD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAcpF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAgBpF,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAQ9D,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAO/C,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,kBAAkB,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAUlI,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAO9C;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAY3F;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAa/G;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,GAAG,IAAI;IAIvG;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,GAAG,IAAI;IAIxG;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,GAAG,IAAI;IAOzH;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,GAAG,IAAI;IAIzG;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,GAAG,IAAI;IAMrG,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAavF;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAO7E;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAoB/G,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK1B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKjC,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAK7B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,aAAiC,GAAG,IAAI;IAQxE,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAKzC,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAK9C;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI;IAS7C;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI;IAOxD,KAAK,IAAI,eAAe;IAyExB,OAAO,CAAC,mBAAmB;CAO5B;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,sBAAsB,CAE1F"}

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"]}