@wildo-ai/saas-models 1.1.8 → 1.1.10

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

@@ -1 +1 @@
-{"version":3,"file":"product.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/product.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Product Schema (Shared)\n *\n * Products define what you sell. They live in the DB as APPLICATION-scoped records,\n * populated lazily from the code-defined ProductDefinition catalog.\n *\n * Config-driven, lazy-populated:\n * 1. Config is the source of truth: Product definitions live in code (shared lib)\n * 2. Populate on demand: DB records created on first checkout/admin view\n * 3. Provider sync on demand: providerProductId filled when first used in provider ops\n * 4. Bulk sync available: Admin action to pre-populate all products\n * 5. Startup is lightweight: No blocking provider calls at boot\n *\n * The admin UI shows products as read-only resources (view + \"Sync to Provider\" action),\n * NOT as CRUD-editable. Changes require code deployment.\n *\n * @see billing-and-features-system.md §6.2 (Product & Price Catalog)\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 { SectionedVocabulary } from '@wildo-ai/presets-components-models';\nimport { ResourcePrimaryScope } from '../resources/resources.shared.schemas';\nimport {\n  ProductType,\n  TaxDisplayMode,\n} from './billing-enums.shared.schemas';\nimport { ProductPriceDisclosure, ProductAvailability } from './public-pricing-catalog.shared.atoms';\nimport { LimitGrantSchema } from './product-behavior-policy.shared.schemas';\nimport { ProductBehaviorPolicySchema } from './product-behavior-policy.shared.schemas';\n\nexport const ProductSchema = z.object({\n\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  type: z.enum(ProductType).isDBIndexed().isSummaryField().isNotEditable().systemEnum('ProductType'),\n  /** Unique product key (maps to ProductDefinition.key in code catalog) */\n  key: z.string().min(1).isUnique({ scope: 'global' }).isSummaryField().isNotEditable(),\n\n  /** Which scopes can subscribe to this product (code-driven, not user-editable) */\n  targetScopes: z.array(z.enum(ResourcePrimaryScope)).min(1),\n\n  /** Features this product grants (boolean: present = enabled) */\n  grantedFeatures: z.array(z.string().systemEnum(SectionedVocabulary.FEATURE)).default([]).isNotEditable(),\n\n  /**\n   * Limits this product grants, with aggregation mode.\n   * - SET: absolute value (for PLAN products: \"Professional gives you 50 projects\")\n   * - ADD: additive to current limits (for ADDON products: \"+10 extra projects\")\n   *\n   * Aggregation algorithm in BillingFeatureSyncBackendService:\n   *   1. Start with active PLAN's SET limits (only one active plan per billing account)\n   *   2. For each active ADDON with ADD mode: sum onto current limit\n   *   3. For each active ADDON with SET mode: take max(current, addon value)\n   *   4. FEATURES_UNLIMITED always wins in any comparison\n   */\n  grantedLimits: z.record(z.string().systemEnum(SectionedVocabulary.LIMIT), LimitGrantSchema).default({}).isNotEditable(),\n\n  /** For PLAN type: mutually exclusive tier ordering (higher number = higher tier) */\n  planTier: z.string().optional().isSummaryField(),\n  /** For PLAN type: tier sort order (used for upgrade/downgrade direction detection) */\n  planTierOrder: z.number().optional(),\n\n  /** For ADDON type: required plan tiers to subscribe to this addon (empty = no restriction) */\n  requiredPlanTiers: z.array(z.string()).optional(),\n\n  /**\n   * Tax display intent for this product, recorded on the product row.\n   * - 'exclusive': price amounts are HT (tax added at checkout)\n   * - 'inclusive': price amounts are TTC (tax embedded)\n   *\n   * It is DECLARATIVE ONLY and does not reach the billing provider. The catalog sync stores it on\n   * the product and then sends each price's own `taxBehavior` unchanged, so a price that declares\n   * none is created without `tax_behavior` regardless of what this field says. To make the\n   * intention effective, set `taxBehavior` on the prices as well.\n   *\n   * Common pattern: org products exclusive, user products inclusive.\n   */\n  taxDisplayMode: z.enum(TaxDisplayMode).optional(),\n\n  /**\n   * Purchase configuration for non-subscription products (ONE_TIME, CREDIT_PACK, ITEM).\n   * Ignored for subscription products (PLAN, ADDON, METERED).\n   */\n  purchaseConfig: z.object({\n    /**\n     * The most units one purchase may carry (for ONE_TIME/CREDIT_PACK/ITEM). Absent means no cap beyond the\n     * checkout's own bound. ENFORCED since #1798: opening a checkout for more is refused with\n     * `BILLING_PURCHASE_QUANTITY_EXCEEDS_LIMIT` (422). Nothing read it before.\n     */\n    maxQuantityPerPurchase: z.number().int().min(1).optional().describe(\"The most units one purchase of this product may carry. Opening a checkout for more is refused. Absent means no cap beyond the checkout's own bound. Ignored for subscription products.\"),\n    /** For CREDIT_PACK: how many credits per pack unit */\n    creditsPerUnit: z.number().min(1).optional().describe(\"For a credit pack, how many credits each unit bought adds to the credit pool. Defaults to 1.\"),\n    /** For CREDIT_PACK: which \"credit pool\" this feeds (e.g., 'ai_tokens', 'sms_credits') */\n    creditPoolKey: z.string().optional().describe(\"For a credit pack, the key of the credit pool a completed purchase adds credits to. A credit pack without one grants no credits.\"),\n  }).optional(),\n\n  /** Behavior policy: trial, proration, cancellation, metering */\n  behaviorPolicy: ProductBehaviorPolicySchema.optional(),\n\n  /** Provider sync (lazy: populated on first checkout or sync action, NOT at startup) */\n  providerProductId: z.string().optional().isBackendOnly(),\n\n  /** Display sort order in pricing tables */\n  sortOrder: z.number().default(0),\n  /** Whether this product is visible to end users */\n  isPublic: z.boolean().default(true).isSummaryField(),\n  /**\n   * Whether this product is RETIRED (`false`): withdrawn from the code catalogue, no longer sold or\n   * offered. Not the same question as `availability`, which announces a product not yet on sale.\n   */\n  isActive: z.boolean().default(true).isDBIndexed().isSummaryField(),\n\n  /** The plan this application recommends on pricing surfaces — a recommendation, never a popularity claim. */\n  isRecommended: z.boolean().default(false).isNotEditable().isSummaryField(),\n  /** How much of this product's price a pricing surface may state (display only; not an acquisition gate). */\n  priceDisclosure: z.enum(ProductPriceDisclosure).default(ProductPriceDisclosure.LISTED).isNotEditable().systemEnum('ProductPriceDisclosure'),\n  /** Whether this product can be bought today; `UPCOMING` is listed and refused at every acquisition door. */\n  availability: z.enum(ProductAvailability).default(ProductAvailability.AVAILABLE).isNotEditable().isSummaryField().systemEnum('ProductAvailability'),\n  metadata: z.record(z.string(), z.string()).optional(),\n\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n});\nexport type Product = z.infer<typeof ProductSchema>;\n"]}
+{"version":3,"file":"product.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/product.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Product Schema (Shared)\n *\n * Products define what you sell. They live in the DB as APPLICATION-scoped records,\n * populated lazily from the code-defined ProductDefinition catalog.\n *\n * Config-driven, lazy-populated:\n * 1. Config is the source of truth: Product definitions live in code (shared lib)\n * 2. Populate on demand: DB records created on first checkout/admin view\n * 3. Provider sync on demand: providerProductId filled when first used in provider ops\n * 4. Bulk sync available: Admin action to pre-populate all products\n * 5. Startup is lightweight: No blocking provider calls at boot\n *\n * The admin UI shows products as read-only resources (view + \"Sync to Provider\" action),\n * NOT as CRUD-editable. Changes require code deployment.\n *\n * @see billing-and-features-system.md §6.2 (Product & Price Catalog)\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 { SectionedVocabulary } from '@wildo-ai/presets-components-models';\nimport { ResourcePrimaryScope } from '../resources/resources.shared.schemas';\nimport {\n  ProductType,\n  TaxDisplayMode,\n} from './billing-enums.shared.schemas';\nimport { ProductPriceDisclosure, ProductAvailability } from './public-pricing-catalog.shared.atoms';\nimport { LimitGrantSchema } from './product-behavior-policy.shared.schemas';\nimport { ProductBehaviorPolicySchema } from './product-behavior-policy.shared.schemas';\n\nexport const ProductSchema = z.object({\n\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  type: z.enum(ProductType).isDBIndexed().isSummaryField().isNotEditable().systemEnum('ProductType'),\n  /** Unique product key (maps to ProductDefinition.key in code catalog) */\n  key: z.string().min(1).isUnique({ scope: 'global' }).isSummaryField().isNotEditable(),\n\n  /** Which scopes can subscribe to this product (code-driven, not user-editable) */\n  targetScopes: z.array(z.enum(ResourcePrimaryScope)).min(1),\n\n  /** Features this product grants (boolean: present = enabled) */\n  grantedFeatures: z.array(z.string().systemEnum(SectionedVocabulary.FEATURE)).default([]).isNotEditable(),\n\n  /**\n   * Limits this product grants, with aggregation mode.\n   * - SET: absolute value (for PLAN products: \"Professional gives you 50 projects\")\n   * - ADD: additive to current limits (for ADDON products: \"+10 extra projects\")\n   *\n   * Aggregation algorithm in BillingFeatureSyncBackendService:\n   *   1. Start with active PLAN's SET limits (only one active plan per billing account)\n   *   2. For each active ADDON with ADD mode: sum onto current limit\n   *   3. For each active ADDON with SET mode: take max(current, addon value)\n   *   4. FEATURES_UNLIMITED always wins in any comparison\n   */\n  grantedLimits: z.record(z.string().systemEnum(SectionedVocabulary.LIMIT), LimitGrantSchema).default({}).isNotEditable(),\n\n  /** For PLAN type: mutually exclusive tier ordering (higher number = higher tier) */\n  planTier: z.string().optional().isSummaryField(),\n  /** For PLAN type: tier sort order (used for upgrade/downgrade direction detection) */\n  planTierOrder: z.number().optional(),\n\n  /** For ADDON type: required plan tiers to subscribe to this addon (empty = no restriction) */\n  requiredPlanTiers: z.array(z.string()).optional(),\n\n  /**\n   * Tax display intent for this product, recorded on the product row.\n   * - 'exclusive': price amounts are HT (tax added at checkout)\n   * - 'inclusive': price amounts are TTC (tax embedded)\n   *\n   * It is DECLARATIVE ONLY and does not reach the billing provider. The catalog sync stores it on\n   * the product and then sends each price's own `taxBehavior` unchanged, so a price that declares\n   * none is created without `tax_behavior` regardless of what this field says. To make the\n   * intention effective, set `taxBehavior` on the prices as well.\n   *\n   * Common pattern: org products exclusive, user products inclusive.\n   */\n  taxDisplayMode: z.enum(TaxDisplayMode).optional(),\n\n  /**\n   * Purchase configuration for non-subscription products (ONE_TIME, CREDIT_PACK, ITEM).\n   * Ignored for subscription products (PLAN, ADDON, METERED).\n   */\n  purchaseConfig: z.object({\n    /**\n     * The most units one purchase may carry (for ONE_TIME/CREDIT_PACK/ITEM). Absent means no cap beyond the\n     * checkout's own bound. ENFORCED since #1798: opening a checkout for more is refused with\n     * `BILLING_PURCHASE_QUANTITY_EXCEEDS_LIMIT` (422). Nothing read it before.\n     */\n    maxQuantityPerPurchase: z.number().int().min(1).optional().describe(\"The most units one purchase of this product may carry. Opening a checkout for more is refused. Absent means no cap beyond the checkout's own bound. Ignored for subscription products.\"),\n    /** For CREDIT_PACK: how many credits per pack unit */\n    creditsPerUnit: z.number().min(1).optional().describe(\"For a credit pack, how many credits each unit bought adds to the credit pool. Defaults to 1.\"),\n    /** For CREDIT_PACK: which \"credit pool\" this feeds (e.g., 'ai_tokens', 'sms_credits') */\n    creditPoolKey: z.string().optional().describe(\"For a credit pack, the key of the credit pool a completed purchase adds credits to. A credit pack without one grants no credits.\"),\n  }).optional(),\n\n  /** Behavior policy: trial, proration, cancellation, metering */\n  behaviorPolicy: ProductBehaviorPolicySchema.optional(),\n\n  /** Provider sync (lazy: populated on first checkout or sync action, NOT at startup) */\n  providerProductId: z.string().optional().isBackendOnly(),\n\n  /** Display sort order in pricing tables */\n  sortOrder: z.number().default(0),\n  /** Whether this product is visible to end users */\n  isPublic: z.boolean().default(true).isSummaryField(),\n  /**\n   * Whether this product is RETIRED (`false`): withdrawn from the code catalogue, no longer sold or\n   * offered. Not the same question as `availability`, which announces a product not yet on sale.\n   */\n  isActive: z.boolean().default(true).isDBIndexed().isSummaryField(),\n\n  /** The plan this application recommends on pricing surfaces — a recommendation, never a popularity claim. */\n  isRecommended: z.boolean().default(false).isNotEditable().isSummaryField(),\n  /** How much of this product's price a pricing surface may state (display only; not an acquisition gate). */\n  priceDisclosure: z.enum(ProductPriceDisclosure).default(ProductPriceDisclosure.LISTED).isNotEditable().systemEnum('ProductPriceDisclosure'),\n  /** Whether this product can be bought today; `UPCOMING` is listed and refused at every acquisition door. */\n  availability: z.enum(ProductAvailability).default(ProductAvailability.AVAILABLE).isNotEditable().isSummaryField().systemEnum('ProductAvailability'),\n  metadata: z.record(z.string(), z.string()).optional(),\n\n  createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n  updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),\n});\nexport type Product = z.infer<typeof ProductSchema>;\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"promotions.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/promotions.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAwD,MAAM,gDAAgD,CAAC;AAC7I,OAAO,EAGL,oBAAoB,EACrB,MAAM,uCAAuC,CAAC;AAM/C,oBAAY,oBAAoB;IAC9B,2DAA2D;IAC3D,KAAK,UAAU;IACf,sDAAsD;IACtD,UAAU,eAAe;CAC1B;AAED,KAAK,iBAAiB,GAClB,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,qDAAqD,GAChE,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;kBAmJ9C,CAAC"}
+{"version":3,"file":"promotions.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/promotions.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAwD,MAAM,gDAAgD,CAAC;AAC7I,OAAO,EAGL,oBAAoB,EACrB,MAAM,uCAAuC,CAAC;AAM/C,oBAAY,oBAAoB;IAC9B,2DAA2D;IAC3D,KAAK,UAAU;IACf,sDAAsD;IACtD,UAAU,eAAe;CAC1B;AAED,KAAK,iBAAiB,GAClB,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,qDAAqD,GAChE,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;kBAmJ9C,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"promotions.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/billing/promotions.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Promotions Resource Configuration\n *\n * Admin-managed: discount mechanisms synced to provider.\n */\n\nimport { z } from 'zod';\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport {\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n  ResourceRelationship,\n} from '../resources/resources.shared.schemas';\nimport { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { PromotionSchema } from './promotions.shared.schemas';\n\n// ── Custom Operations ────────────────────────────────────────────────\n\nexport enum Promotion_Operations {\n  /** Apply a promotion code (validates and records usage) */\n  APPLY = 'apply',\n  /** Deactivate a promotion (sets isActive to false) */\n  DEACTIVATE = 'deactivate',\n}\n\ntype PromotionsCoreOps =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE;\n\nexport const promotionsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  typeof Promotion_Operations,\n  PromotionsCoreOps,\n  typeof PromotionSchema\n>({\n  mainSchema: PromotionSchema,\n  resourceIdentifier: CoreResourceType.PROMOTIONS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.PROMOTIONS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  customOperation: Promotion_Operations,\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n  ],\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    [CoreResourceOperation.LIST]: {\n      variants: [\n      {\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      },\n      {\n        /*\n         * The OPERATOR's door onto the catalogue — added 2026-09-18 for issue #1295.\n         *\n         * The `INTERNAL_CALL` variant above is route-less by design: the billing back-office drives\n         * this resource through the service pipeline, and states that these catalog reads have \"NO\n         * HTTP surface\". That stays true and stays the DEFAULT, so `createForInternalServiceOperation`\n         * keeps resolving it and no internal seam moves.\n         *\n         * What was missing is the surface an application ADMINISTRATOR needs. The `billing-catalog`\n         * settings destination targets `promotions.list` and could never load — the rail entry, the tab and the\n         * heading all rendered, and every request 404'd at the ROUTER, because no route was ever\n         * mounted. An operator cannot price what they cannot see.\n         *\n         * Gated on `APP_ADMIN_SUPER_ADMIN`, exactly what that destination already requires. Not a\n         * widening: the aggregated billing state already ships products, prices and active promotions\n         * to EVERY authenticated client, so an admin-only list is strictly narrower than what the\n         * application discloses today.\n         *\n         * Two `isDefault: true` variants is the shape `organizations.CREATE` already uses — default is\n         * per variant TYPE, so the internal door and the HTTP door each stay the default of their own\n         * transport and the HTTP one needs no `variantKey` in its URL.\n         */\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      },\n      ],\n    },\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        isSearchable: true,\n        searchableFields: ['name', 'code'],\n        searchableOptions: { caseSensitive: false, fullMatchOnly: false },\n        filterFields: {},\n        sortFields: [],\n        maxPaginatedResultPerPageLimit: 50,\n      }],\n    },\n    [CoreResourceOperation.CREATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n      }],\n    },\n    [CoreResourceOperation.UPDATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n      }],\n    },\n    [Promotion_Operations.APPLY]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_MEMBER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        resourceOperationLike: CoreResourceOperation.UPDATE,\n        requestDto: z.object({\n          code: z.string().min(1),\n        }),\n        // Borrows UPDATE for its route/verb but returns discount info for the caller,\n        // NOT the Promotion resource row. Without this the service output fails\n        // `transformOutput`'s `internalDto.parse` against the resource schema → 500.\n        customResponseDto: z.object({\n          valid: z.boolean().describe(\"Always `true`. A promotion that cannot be used is refused with an error instead.\"),\n          promotionId: z.string().describe(\"The id of the promotion that was checked.\"),\n          providerCouponId: z.string().nullish().describe(\"The billing provider's id for the coupon behind the promotion. Absent when the promotion is not set up with the provider, in which case checkout refuses its code.\"),\n          providerPromotionId: z.string().nullish().describe(\"The billing provider's id for the promotion code. Present only for a promotion with a code that is set up with the provider.\"),\n          discount: z.object({\n            type: z.string().describe(\"The kind of discount: `percentage` or `fixed_amount`.\"),\n            percentage: z.number().optional().describe(\"For a `percentage` discount, the percentage taken off, from 0 to 100.\"),\n            // `amount` is a MoneyValue (z_money) — modelled permissively to avoid\n            // pulling the money factory into this response contract.\n            amount: z.unknown().optional().describe(\"For a `fixed_amount` discount, the amount taken off, as a money value with `amount`, `currency` and `decimals`.\"),\n          }).describe(\"The discount the promotion gives. Checking a code does not redeem it: a redemption is counted when a checkout using the code completes.\"),\n        }),\n      }],\n    },\n    [Promotion_Operations.DEACTIVATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        resourceOperationLike: CoreResourceOperation.UPDATE,\n        haveBulkOperation: true,\n        // DEACTIVATE forces `isActive: false` from its prefix implementation and takes no\n        // caller input. Omitting `requestDto` would auto-derive the FULL promotion update DTO\n        // — including `isActive` itself (so \"deactivate\" could re-activate), plus `code`,\n        // `discountPercentage` and `maxRedemptions`. The prefix's return is MERGED onto the\n        // caller payload rather than replacing it, so narrowing here is what actually\n        // constrains the write.\n        requestDto: z.object({}),\n        // Borrows UPDATE for its route/verb but returns a bare `{ isActive }` ack,\n        // NOT the Promotion resource row.\n        customResponseDto: z.object({\n          isActive: z.boolean(),\n        }),\n      }],\n    },\n  },\n});\n"]}
+{"version":3,"file":"promotions.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/billing/promotions.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Promotions Resource Configuration\n *\n * Admin-managed: discount mechanisms synced to provider.\n */\n\nimport { z } from 'zod';\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport {\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n  ResourceRelationship,\n} from '../resources/resources.shared.schemas';\nimport { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { PromotionSchema } from './promotions.shared.schemas';\n\n// ── Custom Operations ────────────────────────────────────────────────\n\nexport enum Promotion_Operations {\n  /** Apply a promotion code (validates and records usage) */\n  APPLY = 'apply',\n  /** Deactivate a promotion (sets isActive to false) */\n  DEACTIVATE = 'deactivate',\n}\n\ntype PromotionsCoreOps =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.SEARCH\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE;\n\nexport const promotionsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  typeof Promotion_Operations,\n  PromotionsCoreOps,\n  typeof PromotionSchema\n>({\n  mainSchema: PromotionSchema,\n  resourceIdentifier: CoreResourceType.PROMOTIONS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.PROMOTIONS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  customOperation: Promotion_Operations,\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.SEARCH,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n  ],\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    [CoreResourceOperation.LIST]: {\n      variants: [\n      {\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      },\n      {\n        /*\n         * The OPERATOR's door onto the catalogue — added 2026-09-18 for issue #1295.\n         *\n         * The `INTERNAL_CALL` variant above is route-less by design: the billing back-office drives\n         * this resource through the service pipeline, and states that these catalog reads have \"NO\n         * HTTP surface\". That stays true and stays the DEFAULT, so `createForInternalServiceOperation`\n         * keeps resolving it and no internal seam moves.\n         *\n         * What was missing is the surface an application ADMINISTRATOR needs. The `billing-catalog`\n         * settings destination targets `promotions.list` and could never load — the rail entry, the tab and the\n         * heading all rendered, and every request 404'd at the ROUTER, because no route was ever\n         * mounted. An operator cannot price what they cannot see.\n         *\n         * Gated on `APP_ADMIN_SUPER_ADMIN`, exactly what that destination already requires. Not a\n         * widening: the aggregated billing state already ships products, prices and active promotions\n         * to EVERY authenticated client, so an admin-only list is strictly narrower than what the\n         * application discloses today.\n         *\n         * Two `isDefault: true` variants is the shape `organizations.CREATE` already uses — default is\n         * per variant TYPE, so the internal door and the HTTP door each stay the default of their own\n         * transport and the HTTP one needs no `variantKey` in its URL.\n         */\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      },\n      ],\n    },\n    [CoreResourceOperation.SEARCH]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        isSearchable: true,\n        searchableFields: ['name', 'code'],\n        searchableOptions: { caseSensitive: false, fullMatchOnly: false },\n        filterFields: {},\n        sortFields: [],\n        maxPaginatedResultPerPageLimit: 50,\n      }],\n    },\n    [CoreResourceOperation.CREATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n      }],\n    },\n    [CoreResourceOperation.UPDATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n      }],\n    },\n    [Promotion_Operations.APPLY]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_MEMBER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        resourceOperationLike: CoreResourceOperation.UPDATE,\n        requestDto: z.object({\n          code: z.string().min(1),\n        }),\n        // Borrows UPDATE for its route/verb but returns discount info for the caller,\n        // NOT the Promotion resource row. Without this the service output fails\n        // `transformOutput`'s `internalDto.parse` against the resource schema → 500.\n        customResponseDto: z.object({\n          valid: z.boolean().describe(\"Always `true`. A promotion that cannot be used is refused with an error instead.\"),\n          promotionId: z.string().describe(\"The id of the promotion that was checked.\"),\n          providerCouponId: z.string().nullish().describe(\"The billing provider's id for the coupon behind the promotion. Absent when the promotion is not set up with the provider, in which case checkout refuses its code.\"),\n          providerPromotionId: z.string().nullish().describe(\"The billing provider's id for the promotion code. Present only for a promotion with a code that is set up with the provider.\"),\n          discount: z.object({\n            type: z.string().describe(\"The kind of discount: `percentage` or `fixed_amount`.\"),\n            percentage: z.number().optional().describe(\"For a `percentage` discount, the percentage taken off, from 0 to 100.\"),\n            // `amount` is a MoneyValue (z_money) — modelled permissively to avoid\n            // pulling the money factory into this response contract.\n            amount: z.unknown().optional().describe(\"For a `fixed_amount` discount, the amount taken off, as a money value with `amount`, `currency` and `decimals`.\"),\n          }).describe(\"The discount the promotion gives. Checking a code does not redeem it: a redemption is counted when a checkout using the code completes.\"),\n        }),\n      }],\n    },\n    [Promotion_Operations.DEACTIVATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        resourceOperationLike: CoreResourceOperation.UPDATE,\n        haveBulkOperation: true,\n        // DEACTIVATE forces `isActive: false` from its prefix implementation and takes no\n        // caller input. Omitting `requestDto` would auto-derive the FULL promotion update DTO\n        // — including `isActive` itself (so \"deactivate\" could re-activate), plus `code`,\n        // `discountPercentage` and `maxRedemptions`. The prefix's return is MERGED onto the\n        // caller payload rather than replacing it, so narrowing here is what actually\n        // constrains the write.\n        requestDto: z.object({}),\n        // Borrows UPDATE for its route/verb but returns a bare `{ isActive }` ack,\n        // NOT the Promotion resource row.\n        customResponseDto: z.object({\n          isActive: z.boolean(),\n        }),\n      }],\n    },\n  },\n});\n"]}

package/dist/esm/billing/promotions.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promotions.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/promotions.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AAExC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;iBAkE1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}
+{"version":3,"file":"promotions.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/promotions.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AAExC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;iBAkE1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"promotions.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/promotions.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Promotion Schema (Shared)\n *\n * Promotions are APPLICATION-scoped, admin-managed discount mechanisms\n * synced to the billing provider (as coupons + promotion codes).\n *\n * Types:\n * - COUPON: Auto-applied or admin-applied discount\n * - PROMOTION_CODE: User-entered code at checkout\n * - REFERRAL: Generated by referral program (links to ReferralSchema)\n * - DEAL: Custom negotiated deal (enterprise/sales-driven)\n *\n * @see billing-and-features-system.md §10 (Promotions)\n */\n\nimport { z } from 'zod';\nimport { z_money, CurrencyAllowed } from '@wildo-ai/zod-decorators';\nimport {\n  PromotionType,\n  DiscountType,\n  PromotionDuration,\n} from './billing-enums.shared.schemas';\n\nexport const PromotionSchema = z.object({\n\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  /** Promotion type */\n  type: z.enum(PromotionType).isDBIndexed().isSummaryField().systemEnum('PromotionType'),\n\n  /** Human-readable name (admin display) */\n  name: z.string().min(1).max(200).isSummaryField(),\n  /** Optional description */\n  description: z.string().max(500).optional(),\n\n  /** The user-facing promotion code (for PROMOTION_CODE type) */\n  code: z.string().min(1).max(50).optional().isDBIndexed(),\n\n  // ── Discount ──\n\n  /** Discount type (percentage or fixed amount) */\n  discountType: z.enum(DiscountType).isSummaryField().systemEnum('DiscountType'),\n  /**\n   * Discount percentage (0-100), for PERCENTAGE discount type.\n   * Mutually exclusive with discountFixedAmount.\n   */\n  discountPercentage: z.number().min(0).max(100).optional(),\n  /**\n   * Fixed discount amount, for FIXED_AMOUNT discount type.\n   * Uses z_money for proper monetary representation with bigint precision.\n   * Mutually exclusive with discountPercentage.\n   */\n  discountFixedAmount: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT], minAmount: 0n }).optional(),\n\n  // ── Duration ──\n\n  /** How long the discount applies */\n  duration: z.enum(PromotionDuration).default(PromotionDuration.ONCE),\n  /** For REPEATING duration: number of months */\n  durationInMonths: z.number().min(1).optional(),\n\n  // ── Applicability ──\n\n  /** Product keys this promotion applies to (empty = all products) */\n  applicableProducts: z.array(z.string()).default([]),\n  /** Maximum number of redemptions (null = unlimited) */\n  maxRedemptions: z.number().min(1).nullable().default(null),\n  /** Current redemption count */\n  timesRedeemed: z.number().min(0).default(0).isNotEditable(),\n\n  // ── Validity ──\n\n  /** Start date (promotion is not active before this) */\n  validFrom: z.date().optional(),\n  /** End date (promotion expires after this) */\n  validUntil: z.date().optional(),\n  /** Whether this promotion is currently active */\n  isActive: z.boolean().default(true).isDBIndexed(),\n\n  // ── Provider sync ──\n\n  /** Provider coupon ID (synced on creation) */\n  providerCouponId: z.string().optional().isBackendOnly(),\n  /** Provider promotion code ID (for PROMOTION_CODE type) */\n  providerPromotionId: z.string().optional().isBackendOnly(),\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 Promotion = z.infer<typeof PromotionSchema>;\n"]}
+{"version":3,"file":"promotions.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/promotions.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Promotion Schema (Shared)\n *\n * Promotions are APPLICATION-scoped, admin-managed discount mechanisms\n * synced to the billing provider (as coupons + promotion codes).\n *\n * Types:\n * - COUPON: Auto-applied or admin-applied discount\n * - PROMOTION_CODE: User-entered code at checkout\n * - REFERRAL: Generated by referral program (links to ReferralSchema)\n * - DEAL: Custom negotiated deal (enterprise/sales-driven)\n *\n * @see billing-and-features-system.md §10 (Promotions)\n */\n\nimport { z } from 'zod';\nimport { z_money, CurrencyAllowed } from '@wildo-ai/zod-decorators';\nimport {\n  PromotionType,\n  DiscountType,\n  PromotionDuration,\n} from './billing-enums.shared.schemas';\n\nexport const PromotionSchema = z.object({\n\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  /** Promotion type */\n  type: z.enum(PromotionType).isDBIndexed().isSummaryField().systemEnum('PromotionType'),\n\n  /** Human-readable name (admin display) */\n  name: z.string().min(1).max(200).isSummaryField(),\n  /** Optional description */\n  description: z.string().max(500).optional(),\n\n  /** The user-facing promotion code (for PROMOTION_CODE type) */\n  code: z.string().min(1).max(50).optional().isDBIndexed(),\n\n  // ── Discount ──\n\n  /** Discount type (percentage or fixed amount) */\n  discountType: z.enum(DiscountType).isSummaryField().systemEnum('DiscountType'),\n  /**\n   * Discount percentage (0-100), for PERCENTAGE discount type.\n   * Mutually exclusive with discountFixedAmount.\n   */\n  discountPercentage: z.number().min(0).max(100).optional(),\n  /**\n   * Fixed discount amount, for FIXED_AMOUNT discount type.\n   * Uses z_money for proper monetary representation with bigint precision.\n   * Mutually exclusive with discountPercentage.\n   */\n  discountFixedAmount: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT], minAmount: 0n }).optional(),\n\n  // ── Duration ──\n\n  /** How long the discount applies */\n  duration: z.enum(PromotionDuration).default(PromotionDuration.ONCE),\n  /** For REPEATING duration: number of months */\n  durationInMonths: z.number().min(1).optional(),\n\n  // ── Applicability ──\n\n  /** Product keys this promotion applies to (empty = all products) */\n  applicableProducts: z.array(z.string()).default([]),\n  /** Maximum number of redemptions (null = unlimited) */\n  maxRedemptions: z.number().min(1).nullable().default(null),\n  /** Current redemption count */\n  timesRedeemed: z.number().min(0).default(0).isNotEditable(),\n\n  // ── Validity ──\n\n  /** Start date (promotion is not active before this) */\n  validFrom: z.date().optional(),\n  /** End date (promotion expires after this) */\n  validUntil: z.date().optional(),\n  /** Whether this promotion is currently active */\n  isActive: z.boolean().default(true).isDBIndexed(),\n\n  // ── Provider sync ──\n\n  /** Provider coupon ID (synced on creation) */\n  providerCouponId: z.string().optional().isBackendOnly(),\n  /** Provider promotion code ID (for PROMOTION_CODE type) */\n  providerPromotionId: z.string().optional().isBackendOnly(),\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 Promotion = z.infer<typeof PromotionSchema>;\n"]}

package/dist/esm/billing/public-pricing-catalog.shared.atoms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-pricing-catalog.shared.atoms.d.ts","sourceRoot":"","sources":["../../../../src/billing/public-pricing-catalog.shared.atoms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wHAAwH;AACxH;;;;;;;;;;;;;;GAcG;AACH,oBAAY,sBAAsB;IAChC,yGAAyG;IACzG,MAAM,WAAW;IACjB;;;;OAIG;IACH,WAAW,gBAAgB;IAC3B,mFAAmF;IACnF,UAAU,eAAe;CAC1B;AAED;;;;;;;GAOG;AACH,oBAAY,mBAAmB;IAC7B,wEAAwE;IACxE,SAAS,cAAc;IACvB,iGAAiG;IACjG,QAAQ,aAAa;CACtB;AACD,sEAAsE;AAEtE;;;;;;;GAOG;AACH,oBAAY,2BAA2B;IACrC,iCAAiC;IACjC,QAAQ,aAAa;IACrB,mCAAmC;IACnC,KAAK,UAAU;IACf,kCAAkC;IAClC,IAAI,SAAS;CACd;AAED;;;;;;GAMG;AACH,oBAAY,wBAAwB;IAClC,oDAAoD;IACpD,IAAI,SAAS;IACb,gEAAgE;IAChE,QAAQ,aAAa;IACrB,iGAAiG;IACjG,QAAQ,aAAa;CACtB;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5F,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,wGAAwG;AACxG,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChD;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,UAAU,CAAC,GAAG,MAAM,CAQ9G"}
+{"version":3,"file":"public-pricing-catalog.shared.atoms.d.ts","sourceRoot":"","sources":["../../../src/billing/public-pricing-catalog.shared.atoms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wHAAwH;AACxH;;;;;;;;;;;;;;GAcG;AACH,oBAAY,sBAAsB;IAChC,yGAAyG;IACzG,MAAM,WAAW;IACjB;;;;OAIG;IACH,WAAW,gBAAgB;IAC3B,mFAAmF;IACnF,UAAU,eAAe;CAC1B;AAED;;;;;;;GAOG;AACH,oBAAY,mBAAmB;IAC7B,wEAAwE;IACxE,SAAS,cAAc;IACvB,iGAAiG;IACjG,QAAQ,aAAa;CACtB;AACD,sEAAsE;AAEtE;;;;;;;GAOG;AACH,oBAAY,2BAA2B;IACrC,iCAAiC;IACjC,QAAQ,aAAa;IACrB,mCAAmC;IACnC,KAAK,UAAU;IACf,kCAAkC;IAClC,IAAI,SAAS;CACd;AAED;;;;;;GAMG;AACH,oBAAY,wBAAwB;IAClC,oDAAoD;IACpD,IAAI,SAAS;IACb,gEAAgE;IAChE,QAAQ,aAAa;IACrB,iGAAiG;IACjG,QAAQ,aAAa;CACtB;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5F,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,wGAAwG;AACxG,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChD;AAED,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,aAAa,GAAG,UAAU,CAAC,GAAG,MAAM,CAQ9G"}

package/dist/esm/billing/public-pricing-catalog.shared.atoms.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-pricing-catalog.shared.atoms.js","sourceRoot":"","sources":["../../../../src/billing/public-pricing-catalog.shared.atoms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wHAAwH;AACxH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,sBAWX;AAXD,WAAY,sBAAsB;IAChC,yGAAyG;IACzG,2CAAiB,CAAA;IACjB;;;;OAIG;IACH,qDAA2B,CAAA;IAC3B,mFAAmF;IACnF,mDAAyB,CAAA;AAC3B,CAAC,EAXW,sBAAsB,KAAtB,sBAAsB,QAWjC;AAED;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,wEAAwE;IACxE,8CAAuB,CAAA;IACvB,iGAAiG;IACjG,4CAAqB,CAAA;AACvB,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AACD,sEAAsE;AAEtE;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,2BAOX;AAPD,WAAY,2BAA2B;IACrC,iCAAiC;IACjC,oDAAqB,CAAA;IACrB,mCAAmC;IACnC,8CAAe,CAAA;IACf,kCAAkC;IAClC,4CAAa,CAAA;AACf,CAAC,EAPW,2BAA2B,KAA3B,2BAA2B,QAOtC;AAED;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,wBAOX;AAPD,WAAY,wBAAwB;IAClC,oDAAoD;IACpD,yCAAa,CAAA;IACb,gEAAgE;IAChE,iDAAqB,CAAA;IACrB,iGAAiG;IACjG,iDAAqB,CAAA;AACvB,CAAC,EAPW,wBAAwB,KAAxB,wBAAwB,QAOnC;AAsCD;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAA2D;IACpG,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACpG,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC;QAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjF,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACtF,CAAC","sourcesContent":["/**\n * The PUBLIC pricing catalogue: what a pricing surface outside the application (the public website)\n * may know about the application's billing catalogue, as plain JSON-safe data (#1835).\n *\n * ## Why this file imports nothing\n *\n * It is an ATOM on the `@wildo-ai/saas-models/public-runtime` seam. The website's pricing section is a\n * browser island, and the billing vocabulary it would otherwise need (`ProductType`, `BillingInterval`,\n * `PricingModel`) lives behind the decorator-framework root barrel and the provider models, neither of\n * which may reach a browser bundle. So the catalogue is DERIVED on the build side, where those\n * vocabularies are available (`derivePublicPricingCatalog` in `./public-pricing-catalog.shared`), and\n * crosses into the browser as the plain shape declared here.\n *\n * ## Why a price carries `amountMinor` as a STRING\n *\n * A `z_money` amount is a `bigint` in minor units. A bigint does not survive `JSON.stringify` (it\n * throws), and the catalogue crosses Astro's island serialization boundary, so it travels as the\n * decimal digits of that integer — lossless, where a `number` would not be for large amounts.\n */\n\n/** @wildo_source:part:start saas.models.billing.catalog-vocabularies facet:layer:shared facet:audience:app-developer */\n/**\n * How much of a product's price a pricing surface may state.\n *\n * The catalogue always carries typed prices — a product cannot sync to the billing provider\n * without one — but a commercial offer is not always fully decided by them. A plan sold as \"per\n * member, plus a platform fee we quote\" has a real unit price and an unsettled total; an\n * enterprise plan sold by a sales conversation may carry a placeholder price nobody should read.\n * Before this vocabulary existed, every pricing surface either printed that price as if it were\n * the whole offer, or kept its own hand-written list of exceptions (#1835).\n *\n * This is a DISPLAY fact and deliberately NOT an acquisition gate: a customer handed a checkout\n * link for an on-request plan by a salesperson must still be able to pay it, for the same reason a\n * private-but-active plan stays purchasable. Whether the product can\n * be bought today is {@link ProductAvailability}'s question.\n */\nexport enum ProductPriceDisclosure {\n  /** The listed prices ARE the offer: a pricing page states them, and structured data may publish them. */\n  LISTED = 'listed',\n  /**\n   * The listed price is a FLOOR: part of the total is not settled (a quoted fee, a volume term).\n   * A pricing page states it as a starting price, and structured data must not publish it as the\n   * price, because a search engine would show it as the whole offer.\n   */\n  STARTING_AT = 'starting_at',\n  /** No price is stated: the offer is quoted on request (a \"contact sales\" plan). */\n  ON_REQUEST = 'on_request',\n}\n\n/**\n * Whether a product can be bought today.\n *\n * Distinct from `Product.isActive`, which is RETIREMENT — a product the catalogue withdrew, no\n * longer sold and no longer offered. An UPCOMING product is the opposite end of the same life: it is\n * announced on pricing surfaces so a visitor can see where the product is going, and it cannot be\n * bought yet. Folding it into `isActive: false` would hide it from the very pages that announce it.\n */\nexport enum ProductAvailability {\n  /** On sale: the acquisition doors accept it (subject to retirement). */\n  AVAILABLE = 'available',\n  /** Announced, not yet on sale: listed on pricing surfaces, refused at every acquisition door. */\n  UPCOMING = 'upcoming',\n}\n/** @wildo_source:part:end saas.models.billing.catalog-vocabularies */\n\n/**\n * How a public price RECURS, as a pricing page states it.\n *\n * Not a copy of the provider's `BillingInterval`: that vocabulary has no member for a one-time price\n * (an absent interval means one-time), and this one must name it, because \"once\" and \"per month\" are\n * different sentences on a pricing page. Every `BillingInterval` member maps onto one of these in\n * `derivePublicPricingCatalog`, through a table that is total over it.\n */\nexport enum PublicPricingRecurrenceUnit {\n  /** Paid once — no recurrence. */\n  ONE_TIME = 'one_time',\n  /** Recurs every `count` months. */\n  MONTH = 'month',\n  /** Recurs every `count` years. */\n  YEAR = 'year',\n}\n\n/**\n * What one public price amount MEANS.\n *\n * A single amount can state a flat price or a per-unit price. It cannot state a tiered, graduated or\n * package price, whose total depends on quantity; for those the amount is indicative only, so no\n * surface may present it — or publish it in structured data — as the price.\n */\nexport enum PublicPricingAmountBasis {\n  /** The amount is the whole price for the period. */\n  FLAT = 'flat',\n  /** The amount is per unit (a seat, a member) for the period. */\n  PER_UNIT = 'per_unit',\n  /** The total depends on quantity (tiered, graduated, package): the amount is indicative only. */\n  VARIABLE = 'variable',\n}\n\n/** One public price of a plan. */\nexport interface PublicPricingPrice {\n  /** The price amount in the currency's MINOR units, as decimal digits (see the file header). */\n  readonly amountMinor: string;\n  /** How many decimal places `amountMinor` carries: the value is `amountMinor / 10 ** decimals`. */\n  readonly decimals: number;\n  /** ISO 4217 currency code. */\n  readonly currency: string;\n  readonly recurrence: { readonly unit: PublicPricingRecurrenceUnit; readonly count: number };\n  readonly amountBasis: PublicPricingAmountBasis;\n  /** The price the catalogue marks as the plan's default. */\n  readonly isDefault: boolean;\n}\n\n/** One public plan: a product the catalogue lists publicly, with its pricing-surface facts resolved. */\nexport interface PublicPricingPlan {\n  /** The catalogue key — also the label namespace a surface names the plan by. */\n  readonly key: string;\n  readonly planTier?: string;\n  /** Ascending order on a pricing surface. */\n  readonly sortOrder: number;\n  /** The scopes that may subscribe (wire values of `ResourcePrimaryScope`). */\n  readonly targetScopes: readonly string[];\n  readonly isRecommended: boolean;\n  readonly priceDisclosure: ProductPriceDisclosure;\n  readonly availability: ProductAvailability;\n  /** Free-trial length when the plan offers one. */\n  readonly trialDays?: number;\n  readonly prices: readonly PublicPricingPrice[];\n}\n\n/** The public pricing catalogue: every publicly listed plan, in display order. */\nexport interface PublicPricingCatalog {\n  readonly plans: readonly PublicPricingPlan[];\n}\n\n/**\n * The amount of a public price as a plain decimal string (`\"4\"`, `\"29.9\"`, `\"0.0001\"`), exact — no\n * floating point. What structured data publishes as `price`, and what a surface formats for display.\n */\nexport function publicPricingAmountDecimal(price: Pick<PublicPricingPrice, 'amountMinor' | 'decimals'>): string {\n  const negative = price.amountMinor.startsWith('-');\n  const digits = (negative ? price.amountMinor.slice(1) : price.amountMinor).replace(/^0+(?=\\d)/, '');\n  if (price.decimals <= 0) return `${negative ? '-' : ''}${digits}`;\n  const padded = digits.padStart(price.decimals + 1, '0');\n  const whole = padded.slice(0, padded.length - price.decimals);\n  const fraction = padded.slice(padded.length - price.decimals).replace(/0+$/, '');\n  return `${negative ? '-' : ''}${whole}${fraction.length > 0 ? `.${fraction}` : ''}`;\n}\n"]}
+{"version":3,"file":"public-pricing-catalog.shared.atoms.js","sourceRoot":"","sources":["../../../src/billing/public-pricing-catalog.shared.atoms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wHAAwH;AACxH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,sBAWX;AAXD,WAAY,sBAAsB;IAChC,yGAAyG;IACzG,2CAAiB,CAAA;IACjB;;;;OAIG;IACH,qDAA2B,CAAA;IAC3B,mFAAmF;IACnF,mDAAyB,CAAA;AAC3B,CAAC,EAXW,sBAAsB,KAAtB,sBAAsB,QAWjC;AAED;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,wEAAwE;IACxE,8CAAuB,CAAA;IACvB,iGAAiG;IACjG,4CAAqB,CAAA;AACvB,CAAC,EALW,mBAAmB,KAAnB,mBAAmB,QAK9B;AACD,sEAAsE;AAEtE;;;;;;;GAOG;AACH,MAAM,CAAN,IAAY,2BAOX;AAPD,WAAY,2BAA2B;IACrC,iCAAiC;IACjC,oDAAqB,CAAA;IACrB,mCAAmC;IACnC,8CAAe,CAAA;IACf,kCAAkC;IAClC,4CAAa,CAAA;AACf,CAAC,EAPW,2BAA2B,KAA3B,2BAA2B,QAOtC;AAED;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,wBAOX;AAPD,WAAY,wBAAwB;IAClC,oDAAoD;IACpD,yCAAa,CAAA;IACb,gEAAgE;IAChE,iDAAqB,CAAA;IACrB,iGAAiG;IACjG,iDAAqB,CAAA;AACvB,CAAC,EAPW,wBAAwB,KAAxB,wBAAwB,QAOnC;AAsCD;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAA2D;IACpG,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACpG,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC;QAAE,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjF,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACtF,CAAC","sourcesContent":["/**\n * The PUBLIC pricing catalogue: what a pricing surface outside the application (the public website)\n * may know about the application's billing catalogue, as plain JSON-safe data (#1835).\n *\n * ## Why this file imports nothing\n *\n * It is an ATOM on the `@wildo-ai/saas-models/public-runtime` seam. The website's pricing section is a\n * browser island, and the billing vocabulary it would otherwise need (`ProductType`, `BillingInterval`,\n * `PricingModel`) lives behind the decorator-framework root barrel and the provider models, neither of\n * which may reach a browser bundle. So the catalogue is DERIVED on the build side, where those\n * vocabularies are available (`derivePublicPricingCatalog` in `./public-pricing-catalog.shared`), and\n * crosses into the browser as the plain shape declared here.\n *\n * ## Why a price carries `amountMinor` as a STRING\n *\n * A `z_money` amount is a `bigint` in minor units. A bigint does not survive `JSON.stringify` (it\n * throws), and the catalogue crosses Astro's island serialization boundary, so it travels as the\n * decimal digits of that integer — lossless, where a `number` would not be for large amounts.\n */\n\n/** @wildo_source:part:start saas.models.billing.catalog-vocabularies facet:layer:shared facet:audience:app-developer */\n/**\n * How much of a product's price a pricing surface may state.\n *\n * The catalogue always carries typed prices — a product cannot sync to the billing provider\n * without one — but a commercial offer is not always fully decided by them. A plan sold as \"per\n * member, plus a platform fee we quote\" has a real unit price and an unsettled total; an\n * enterprise plan sold by a sales conversation may carry a placeholder price nobody should read.\n * Before this vocabulary existed, every pricing surface either printed that price as if it were\n * the whole offer, or kept its own hand-written list of exceptions (#1835).\n *\n * This is a DISPLAY fact and deliberately NOT an acquisition gate: a customer handed a checkout\n * link for an on-request plan by a salesperson must still be able to pay it, for the same reason a\n * private-but-active plan stays purchasable. Whether the product can\n * be bought today is {@link ProductAvailability}'s question.\n */\nexport enum ProductPriceDisclosure {\n  /** The listed prices ARE the offer: a pricing page states them, and structured data may publish them. */\n  LISTED = 'listed',\n  /**\n   * The listed price is a FLOOR: part of the total is not settled (a quoted fee, a volume term).\n   * A pricing page states it as a starting price, and structured data must not publish it as the\n   * price, because a search engine would show it as the whole offer.\n   */\n  STARTING_AT = 'starting_at',\n  /** No price is stated: the offer is quoted on request (a \"contact sales\" plan). */\n  ON_REQUEST = 'on_request',\n}\n\n/**\n * Whether a product can be bought today.\n *\n * Distinct from `Product.isActive`, which is RETIREMENT — a product the catalogue withdrew, no\n * longer sold and no longer offered. An UPCOMING product is the opposite end of the same life: it is\n * announced on pricing surfaces so a visitor can see where the product is going, and it cannot be\n * bought yet. Folding it into `isActive: false` would hide it from the very pages that announce it.\n */\nexport enum ProductAvailability {\n  /** On sale: the acquisition doors accept it (subject to retirement). */\n  AVAILABLE = 'available',\n  /** Announced, not yet on sale: listed on pricing surfaces, refused at every acquisition door. */\n  UPCOMING = 'upcoming',\n}\n/** @wildo_source:part:end saas.models.billing.catalog-vocabularies */\n\n/**\n * How a public price RECURS, as a pricing page states it.\n *\n * Not a copy of the provider's `BillingInterval`: that vocabulary has no member for a one-time price\n * (an absent interval means one-time), and this one must name it, because \"once\" and \"per month\" are\n * different sentences on a pricing page. Every `BillingInterval` member maps onto one of these in\n * `derivePublicPricingCatalog`, through a table that is total over it.\n */\nexport enum PublicPricingRecurrenceUnit {\n  /** Paid once — no recurrence. */\n  ONE_TIME = 'one_time',\n  /** Recurs every `count` months. */\n  MONTH = 'month',\n  /** Recurs every `count` years. */\n  YEAR = 'year',\n}\n\n/**\n * What one public price amount MEANS.\n *\n * A single amount can state a flat price or a per-unit price. It cannot state a tiered, graduated or\n * package price, whose total depends on quantity; for those the amount is indicative only, so no\n * surface may present it — or publish it in structured data — as the price.\n */\nexport enum PublicPricingAmountBasis {\n  /** The amount is the whole price for the period. */\n  FLAT = 'flat',\n  /** The amount is per unit (a seat, a member) for the period. */\n  PER_UNIT = 'per_unit',\n  /** The total depends on quantity (tiered, graduated, package): the amount is indicative only. */\n  VARIABLE = 'variable',\n}\n\n/** One public price of a plan. */\nexport interface PublicPricingPrice {\n  /** The price amount in the currency's MINOR units, as decimal digits (see the file header). */\n  readonly amountMinor: string;\n  /** How many decimal places `amountMinor` carries: the value is `amountMinor / 10 ** decimals`. */\n  readonly decimals: number;\n  /** ISO 4217 currency code. */\n  readonly currency: string;\n  readonly recurrence: { readonly unit: PublicPricingRecurrenceUnit; readonly count: number };\n  readonly amountBasis: PublicPricingAmountBasis;\n  /** The price the catalogue marks as the plan's default. */\n  readonly isDefault: boolean;\n}\n\n/** One public plan: a product the catalogue lists publicly, with its pricing-surface facts resolved. */\nexport interface PublicPricingPlan {\n  /** The catalogue key — also the label namespace a surface names the plan by. */\n  readonly key: string;\n  readonly planTier?: string;\n  /** Ascending order on a pricing surface. */\n  readonly sortOrder: number;\n  /** The scopes that may subscribe (wire values of `ResourcePrimaryScope`). */\n  readonly targetScopes: readonly string[];\n  readonly isRecommended: boolean;\n  readonly priceDisclosure: ProductPriceDisclosure;\n  readonly availability: ProductAvailability;\n  /** Free-trial length when the plan offers one. */\n  readonly trialDays?: number;\n  readonly prices: readonly PublicPricingPrice[];\n}\n\n/** The public pricing catalogue: every publicly listed plan, in display order. */\nexport interface PublicPricingCatalog {\n  readonly plans: readonly PublicPricingPlan[];\n}\n\n/**\n * The amount of a public price as a plain decimal string (`\"4\"`, `\"29.9\"`, `\"0.0001\"`), exact — no\n * floating point. What structured data publishes as `price`, and what a surface formats for display.\n */\nexport function publicPricingAmountDecimal(price: Pick<PublicPricingPrice, 'amountMinor' | 'decimals'>): string {\n  const negative = price.amountMinor.startsWith('-');\n  const digits = (negative ? price.amountMinor.slice(1) : price.amountMinor).replace(/^0+(?=\\d)/, '');\n  if (price.decimals <= 0) return `${negative ? '-' : ''}${digits}`;\n  const padded = digits.padStart(price.decimals + 1, '0');\n  const whole = padded.slice(0, padded.length - price.decimals);\n  const fraction = padded.slice(padded.length - price.decimals).replace(/0+$/, '');\n  return `${negative ? '-' : ''}${whole}${fraction.length > 0 ? `.${fraction}` : ''}`;\n}\n"]}

package/dist/esm/billing/public-pricing-catalog.shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-pricing-catalog.shared.d.ts","sourceRoot":"","sources":["../../../../src/billing/public-pricing-catalog.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAG9F,OAAO,EAGL,KAAK,oBAAoB,EAG1B,MAAM,uCAAuC,CAAC;AAiB/C,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,iBAAiB,EAAE,EACzC,OAAO,GAAE,iCAAsC,GAC9C,oBAAoB,CAsBtB"}
+{"version":3,"file":"public-pricing-catalog.shared.d.ts","sourceRoot":"","sources":["../../../src/billing/public-pricing-catalog.shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAG9F,OAAO,EAGL,KAAK,oBAAoB,EAG1B,MAAM,uCAAuC,CAAC;AAiB/C,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,SAAS,iBAAiB,EAAE,EACzC,OAAO,GAAE,iCAAsC,GAC9C,oBAAoB,CAsBtB"}

package/dist/esm/billing/public-pricing-catalog.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-pricing-catalog.shared.js","sourceRoot":"","sources":["../../../../src/billing/public-pricing-catalog.shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `derivePublicPricingCatalog` — the billing catalogue as a public pricing surface may state it (#1835).\n *\n * The public website must not keep its own copy of the prices it advertises: before this, every\n * application's pricing section re-typed its prices by hand, and Wonder Todos' site published a $12\n * tier its own catalogue does not sell. So the website reads THIS, derived from the same\n * `ProductDefinition[]` the backend syncs to the billing provider — one catalogue, two surfaces.\n *\n * It lives on the root barrel, not beside the plain types in `./public-pricing-catalog.shared.atoms`,\n * because it needs the billing vocabularies (`ProductType`, `BillingInterval`, `PricingModel`) that\n * may not reach a browser bundle. It runs on the build side and hands the browser plain data.\n *\n * ## What is public\n *\n * PLAN products the catalogue lists publicly (`isPublic` not `false`) — the same visibility rule the\n * application's own pricing table applies. Add-ons, metered products and one-off purchases are not\n * plans a visitor chooses between. RETIRED products never reach this function: it reads the code\n * catalogue, and a product retired from the catalogue is by definition no longer in it.\n */\nimport type { PriceDefinition, ProductDefinition } from './product-definition.shared.schemas';\nimport { resolveProductPricingSurfaceFacts } from './product-definition.shared.schemas';\nimport { ProductType, PricingModel, BillingInterval } from './billing-enums.shared.schemas';\nimport {\n  PublicPricingAmountBasis,\n  PublicPricingRecurrenceUnit,\n  type PublicPricingCatalog,\n  type PublicPricingPlan,\n  type PublicPricingPrice,\n} from './public-pricing-catalog.shared.atoms';\n\n/** Total over `BillingInterval`: a member added there is a compile error here until it is mapped. */\nconst RECURRENCE_BY_BILLING_INTERVAL: Record<BillingInterval, PublicPricingRecurrenceUnit> = {\n  [BillingInterval.MONTH]: PublicPricingRecurrenceUnit.MONTH,\n  [BillingInterval.YEAR]: PublicPricingRecurrenceUnit.YEAR,\n};\n\n/** Total over `PricingModel`: which models a single amount can state (see `PublicPricingAmountBasis`). */\nconst AMOUNT_BASIS_BY_PRICING_MODEL: Record<PricingModel, PublicPricingAmountBasis> = {\n  [PricingModel.FLAT]: PublicPricingAmountBasis.FLAT,\n  [PricingModel.PER_UNIT]: PublicPricingAmountBasis.PER_UNIT,\n  [PricingModel.TIERED]: PublicPricingAmountBasis.VARIABLE,\n  [PricingModel.GRADUATED]: PublicPricingAmountBasis.VARIABLE,\n  [PricingModel.PACKAGE]: PublicPricingAmountBasis.VARIABLE,\n};\n\nexport interface DerivePublicPricingCatalogOptions {\n  /**\n   * Keep only plans this scope may subscribe to (a `ResourcePrimaryScope` wire value). Omit to keep\n   * every public plan — the right answer for a site whose catalogue sells to one audience.\n   */\n  readonly targetScope?: string;\n}\n\nexport function derivePublicPricingCatalog(\n  definitions: readonly ProductDefinition[],\n  options: DerivePublicPricingCatalogOptions = {},\n): PublicPricingCatalog {\n  const plans = definitions\n    .filter((definition) => definition.type === ProductType.PLAN && definition.isPublic !== false)\n    .filter((definition) => options.targetScope === undefined || definition.targetScopes.some((scope) => scope === options.targetScope))\n    .map((definition): PublicPricingPlan => {\n      const facts = resolveProductPricingSurfaceFacts(definition);\n      const trialDays = definition.behaviorPolicy?.trial?.days;\n      return {\n        key: definition.key,\n        ...(definition.planTier === undefined ? {} : { planTier: definition.planTier }),\n        // The persisted `Product` resource defaults `sortOrder` to 0; apply the same fallback.\n        sortOrder: definition.sortOrder ?? 0,\n        targetScopes: [...definition.targetScopes],\n        isRecommended: facts.isRecommended,\n        priceDisclosure: facts.priceDisclosure,\n        availability: facts.availability,\n        ...(trialDays === undefined || trialDays <= 0 ? {} : { trialDays }),\n        prices: definition.prices.map(toPublicPricingPrice),\n      };\n    });\n  // Stable: equal `sortOrder`s keep catalogue order, so the page does not reorder on an unrelated edit.\n  return { plans: [...plans].sort((left, right) => left.sortOrder - right.sortOrder) };\n}\n\nfunction toPublicPricingPrice(price: PriceDefinition): PublicPricingPrice {\n  return {\n    amountMinor: price.unitPrice.amount.toString(),\n    decimals: price.unitPrice.decimals,\n    currency: String(price.unitPrice.currency),\n    recurrence: price.interval === undefined\n      ? { unit: PublicPricingRecurrenceUnit.ONE_TIME, count: 1 }\n      : { unit: RECURRENCE_BY_BILLING_INTERVAL[price.interval], count: price.intervalCount ?? 1 },\n    amountBasis: AMOUNT_BASIS_BY_PRICING_MODEL[price.model],\n    // `PriceDefinitionSchema` defaults `isDefault` to true; a hand-authored definition that omits it means the same.\n    isDefault: price.isDefault ?? true,\n  };\n}\n"]}
+{"version":3,"file":"public-pricing-catalog.shared.js","sourceRoot":"","sources":["../../../src/billing/public-pricing-catalog.shared.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `derivePublicPricingCatalog` — the billing catalogue as a public pricing surface may state it (#1835).\n *\n * The public website must not keep its own copy of the prices it advertises: before this, every\n * application's pricing section re-typed its prices by hand, and Wonder Todos' site published a $12\n * tier its own catalogue does not sell. So the website reads THIS, derived from the same\n * `ProductDefinition[]` the backend syncs to the billing provider — one catalogue, two surfaces.\n *\n * It lives on the root barrel, not beside the plain types in `./public-pricing-catalog.shared.atoms`,\n * because it needs the billing vocabularies (`ProductType`, `BillingInterval`, `PricingModel`) that\n * may not reach a browser bundle. It runs on the build side and hands the browser plain data.\n *\n * ## What is public\n *\n * PLAN products the catalogue lists publicly (`isPublic` not `false`) — the same visibility rule the\n * application's own pricing table applies. Add-ons, metered products and one-off purchases are not\n * plans a visitor chooses between. RETIRED products never reach this function: it reads the code\n * catalogue, and a product retired from the catalogue is by definition no longer in it.\n */\nimport type { PriceDefinition, ProductDefinition } from './product-definition.shared.schemas';\nimport { resolveProductPricingSurfaceFacts } from './product-definition.shared.schemas';\nimport { ProductType, PricingModel, BillingInterval } from './billing-enums.shared.schemas';\nimport {\n  PublicPricingAmountBasis,\n  PublicPricingRecurrenceUnit,\n  type PublicPricingCatalog,\n  type PublicPricingPlan,\n  type PublicPricingPrice,\n} from './public-pricing-catalog.shared.atoms';\n\n/** Total over `BillingInterval`: a member added there is a compile error here until it is mapped. */\nconst RECURRENCE_BY_BILLING_INTERVAL: Record<BillingInterval, PublicPricingRecurrenceUnit> = {\n  [BillingInterval.MONTH]: PublicPricingRecurrenceUnit.MONTH,\n  [BillingInterval.YEAR]: PublicPricingRecurrenceUnit.YEAR,\n};\n\n/** Total over `PricingModel`: which models a single amount can state (see `PublicPricingAmountBasis`). */\nconst AMOUNT_BASIS_BY_PRICING_MODEL: Record<PricingModel, PublicPricingAmountBasis> = {\n  [PricingModel.FLAT]: PublicPricingAmountBasis.FLAT,\n  [PricingModel.PER_UNIT]: PublicPricingAmountBasis.PER_UNIT,\n  [PricingModel.TIERED]: PublicPricingAmountBasis.VARIABLE,\n  [PricingModel.GRADUATED]: PublicPricingAmountBasis.VARIABLE,\n  [PricingModel.PACKAGE]: PublicPricingAmountBasis.VARIABLE,\n};\n\nexport interface DerivePublicPricingCatalogOptions {\n  /**\n   * Keep only plans this scope may subscribe to (a `ResourcePrimaryScope` wire value). Omit to keep\n   * every public plan — the right answer for a site whose catalogue sells to one audience.\n   */\n  readonly targetScope?: string;\n}\n\nexport function derivePublicPricingCatalog(\n  definitions: readonly ProductDefinition[],\n  options: DerivePublicPricingCatalogOptions = {},\n): PublicPricingCatalog {\n  const plans = definitions\n    .filter((definition) => definition.type === ProductType.PLAN && definition.isPublic !== false)\n    .filter((definition) => options.targetScope === undefined || definition.targetScopes.some((scope) => scope === options.targetScope))\n    .map((definition): PublicPricingPlan => {\n      const facts = resolveProductPricingSurfaceFacts(definition);\n      const trialDays = definition.behaviorPolicy?.trial?.days;\n      return {\n        key: definition.key,\n        ...(definition.planTier === undefined ? {} : { planTier: definition.planTier }),\n        // The persisted `Product` resource defaults `sortOrder` to 0; apply the same fallback.\n        sortOrder: definition.sortOrder ?? 0,\n        targetScopes: [...definition.targetScopes],\n        isRecommended: facts.isRecommended,\n        priceDisclosure: facts.priceDisclosure,\n        availability: facts.availability,\n        ...(trialDays === undefined || trialDays <= 0 ? {} : { trialDays }),\n        prices: definition.prices.map(toPublicPricingPrice),\n      };\n    });\n  // Stable: equal `sortOrder`s keep catalogue order, so the page does not reorder on an unrelated edit.\n  return { plans: [...plans].sort((left, right) => left.sortOrder - right.sortOrder) };\n}\n\nfunction toPublicPricingPrice(price: PriceDefinition): PublicPricingPrice {\n  return {\n    amountMinor: price.unitPrice.amount.toString(),\n    decimals: price.unitPrice.decimals,\n    currency: String(price.unitPrice.currency),\n    recurrence: price.interval === undefined\n      ? { unit: PublicPricingRecurrenceUnit.ONE_TIME, count: 1 }\n      : { unit: RECURRENCE_BY_BILLING_INTERVAL[price.interval], count: price.intervalCount ?? 1 },\n    amountBasis: AMOUNT_BASIS_BY_PRICING_MODEL[price.model],\n    // `PriceDefinitionSchema` defaults `isDefault` to true; a hand-authored definition that omits it means the same.\n    isDefault: price.isDefault ?? true,\n  };\n}\n"]}

package/dist/esm/billing/referral-reward.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"referral-reward.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/referral-reward.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAE3G;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAIjG,CAAC;AAkBF,sDAAsD;AACtD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,kBAAkB,CAI5G;AAoCD,oHAAoH;AACpH,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB;;;;;;;;;iBAGA,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAIA,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,kEAAkE"}
+{"version":3,"file":"referral-reward.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/referral-reward.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,0BAA0B,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAE3G;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAIjG,CAAC;AAkBF,sDAAsD;AACtD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,kBAAkB,CAI5G;AAoCD,oHAAoH;AACpH,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB;;;;;;;;;iBAGA,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAIA,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,kEAAkE"}

package/dist/esm/billing/referral-reward.shared.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"referral-reward.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/referral-reward.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Referral rewards (#1802) — what each side of a referral receives, and the fields each kind reads.\n *\n * One object per side, with a `type` and the fields that type needs. A refinement requires exactly\n * those fields and refuses the others, so a reward cannot carry a `featureKey` it will never use, and\n * what each field means is stated here rather than in a comment beside a generic `value`.\n *\n * Rewards are SERVER policy: the application declares them in `billing.referrals`, and a referral\n * copies them when it is issued. A caller never supplies them, because a caller who could would\n * grant itself anything.\n */\n\nimport { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first (#966).\nimport '@wildo-ai/zod-decorators';\nimport { PromotionDuration, ReferredRewardType, ReferrerRewardType } from './billing-enums.shared.schemas';\n\n/**\n * The referred kind each referrer kind is delivered as. The two vocabularies stay distinct — they are\n * different sides' promises — but a referrer's credit, discount or feature is read and granted exactly\n * as the referred side's is. A `Record` over the referrer enum, so a new referrer kind cannot ship\n * without saying which delivery it shares.\n */\nexport const REFERRER_REWARD_DELIVERED_AS: Readonly<Record<ReferrerRewardType, ReferredRewardType>> = {\n  [ReferrerRewardType.CREDIT]: ReferredRewardType.CREDIT,\n  [ReferrerRewardType.DISCOUNT]: ReferredRewardType.DISCOUNT,\n  [ReferrerRewardType.FEATURE]: ReferredRewardType.FEATURE,\n};\n\n/** The fields each reward kind reads, keyed by the delivery kind. */\nconst REWARD_FIELDS_BY_TYPE: Readonly<Record<ReferredRewardType, readonly string[]>> = {\n  [ReferredRewardType.CREDIT]: ['credits', 'creditPoolKey'],\n  [ReferredRewardType.FEATURE]: ['featureKey', 'durationDays'],\n  [ReferredRewardType.DISCOUNT]: ['percentOff', 'discountDuration', 'discountDurationInMonths'],\n  [ReferredRewardType.TRIAL_EXTENSION]: ['trialExtensionDays'],\n};\n\n/** Fields a kind MUST carry (a subset of {@link REWARD_FIELDS_BY_TYPE}). */\nconst REQUIRED_REWARD_FIELDS_BY_TYPE: Readonly<Record<ReferredRewardType, readonly string[]>> = {\n  [ReferredRewardType.CREDIT]: ['credits', 'creditPoolKey'],\n  [ReferredRewardType.FEATURE]: ['featureKey'],\n  [ReferredRewardType.DISCOUNT]: ['percentOff', 'discountDuration'],\n  [ReferredRewardType.TRIAL_EXTENSION]: ['trialExtensionDays'],\n};\n\n/** The delivery kind of either side's reward type. */\nexport function referralRewardDeliveryKind(type: ReferrerRewardType | ReferredRewardType): ReferredRewardType {\n  return Object.hasOwn(REFERRER_REWARD_DELIVERED_AS, type)\n    ? REFERRER_REWARD_DELIVERED_AS[type as ReferrerRewardType]\n    : type as ReferredRewardType;\n}\n\nconst ALL_REWARD_FIELDS = ['credits', 'creditPoolKey', 'featureKey', 'durationDays', 'percentOff', 'discountDuration', 'discountDurationInMonths', 'trialExtensionDays'] as const;\n\nconst rewardFields = {\n  credits: z.number().int().min(1).optional().describe('For a `credit` reward: how many credits are added to the pool.'),\n  creditPoolKey: z.string().min(1).optional().describe('For a `credit` reward: the key of the credit pool the credits are added to. The pool is created if the account has none.'),\n  featureKey: z.string().min(1).optional().describe('For a `feature` reward: the boolean feature the account is granted.'),\n  durationDays: z.number().int().min(1).optional().describe('For a `feature` reward: how many days after conversion the feature lasts. Absent means it does not expire.'),\n  percentOff: z.number().min(1).max(100).optional().describe('For a `discount` reward: the percentage taken off the subscription\\'s invoices.'),\n  discountDuration: z.enum(PromotionDuration).optional().describe('For a `discount` reward: how long it applies — `once` (the next invoice), `repeating` (for `discountDurationInMonths`) or `forever`.'),\n  discountDurationInMonths: z.number().int().min(1).optional().describe('For a `repeating` discount: how many months it applies.'),\n};\n\n/** Refuses a reward missing a field its kind needs, or carrying one its kind never reads. */\nfunction refineRewardShape(reward: Record<string, unknown> & { type: string }, context: z.RefinementCtx): void {\n  const type = reward.type as ReferrerRewardType | ReferredRewardType;\n  const kind = referralRewardDeliveryKind(type);\n  const allowed = REWARD_FIELDS_BY_TYPE[kind] ?? [];\n  for (const field of REQUIRED_REWARD_FIELDS_BY_TYPE[kind] ?? []) {\n    if (reward[field] === undefined) context.addIssue({ code: 'custom', path: [field], message: `A '${type}' reward needs '${field}'.` });\n  }\n  for (const field of ALL_REWARD_FIELDS) {\n    if (reward[field] !== undefined && !allowed.includes(field)) {\n      context.addIssue({ code: 'custom', path: [field], message: `A '${type}' reward does not read '${field}'.` });\n    }\n  }\n  const repeating = reward.discountDuration === PromotionDuration.REPEATING;\n  if (kind === ReferredRewardType.DISCOUNT && repeating !== (reward.discountDurationInMonths !== undefined)) {\n    context.addIssue({\n      code: 'custom', path: ['discountDurationInMonths'],\n      message: 'A repeating discount needs discountDurationInMonths, and only a repeating discount takes it.',\n    });\n  }\n}\n\n/** @wildo_source:part:start saas.models.billing.referral-program facet:layer:shared facet:audience:app-developer */\n/** What the referrer receives when the referral converts. */\nexport const ReferrerRewardSchema = z.object({\n  type: z.enum(ReferrerRewardType).systemEnum('ReferrerRewardType').describe('What the referrer receives: `credit`, `discount` or `feature`.'),\n  ...rewardFields,\n}).superRefine(refineRewardShape);\nexport type ReferrerReward = z.infer<typeof ReferrerRewardSchema>;\n\n/** What the referred account receives. */\nexport const ReferredRewardSchema = z.object({\n  type: z.enum(ReferredRewardType).systemEnum('ReferredRewardType').describe('What the referred account receives: `credit`, `discount`, `feature` or `trial_extension`.'),\n  ...rewardFields,\n  trialExtensionDays: z.number().int().min(1).optional().describe('For a `trial_extension` reward: the days added to the trial of a subscription checkout the referred account opens while the referral is accepted.'),\n}).superRefine(refineRewardShape);\nexport type ReferredReward = z.infer<typeof ReferredRewardSchema>;\n/** @wildo_source:part:end saas.models.billing.referral-program */\n"]}
+{"version":3,"file":"referral-reward.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/referral-reward.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Referral rewards (#1802) — what each side of a referral receives, and the fields each kind reads.\n *\n * One object per side, with a `type` and the fields that type needs. A refinement requires exactly\n * those fields and refuses the others, so a reward cannot carry a `featureKey` it will never use, and\n * what each field means is stated here rather than in a comment beside a generic `value`.\n *\n * Rewards are SERVER policy: the application declares them in `billing.referrals`, and a referral\n * copies them when it is issued. A caller never supplies them, because a caller who could would\n * grant itself anything.\n */\n\nimport { z } from 'zod';\n// Side-effect import: this module calls `.systemEnum()` at load, so the decorators must be installed first (#966).\nimport '@wildo-ai/zod-decorators';\nimport { PromotionDuration, ReferredRewardType, ReferrerRewardType } from './billing-enums.shared.schemas';\n\n/**\n * The referred kind each referrer kind is delivered as. The two vocabularies stay distinct — they are\n * different sides' promises — but a referrer's credit, discount or feature is read and granted exactly\n * as the referred side's is. A `Record` over the referrer enum, so a new referrer kind cannot ship\n * without saying which delivery it shares.\n */\nexport const REFERRER_REWARD_DELIVERED_AS: Readonly<Record<ReferrerRewardType, ReferredRewardType>> = {\n  [ReferrerRewardType.CREDIT]: ReferredRewardType.CREDIT,\n  [ReferrerRewardType.DISCOUNT]: ReferredRewardType.DISCOUNT,\n  [ReferrerRewardType.FEATURE]: ReferredRewardType.FEATURE,\n};\n\n/** The fields each reward kind reads, keyed by the delivery kind. */\nconst REWARD_FIELDS_BY_TYPE: Readonly<Record<ReferredRewardType, readonly string[]>> = {\n  [ReferredRewardType.CREDIT]: ['credits', 'creditPoolKey'],\n  [ReferredRewardType.FEATURE]: ['featureKey', 'durationDays'],\n  [ReferredRewardType.DISCOUNT]: ['percentOff', 'discountDuration', 'discountDurationInMonths'],\n  [ReferredRewardType.TRIAL_EXTENSION]: ['trialExtensionDays'],\n};\n\n/** Fields a kind MUST carry (a subset of {@link REWARD_FIELDS_BY_TYPE}). */\nconst REQUIRED_REWARD_FIELDS_BY_TYPE: Readonly<Record<ReferredRewardType, readonly string[]>> = {\n  [ReferredRewardType.CREDIT]: ['credits', 'creditPoolKey'],\n  [ReferredRewardType.FEATURE]: ['featureKey'],\n  [ReferredRewardType.DISCOUNT]: ['percentOff', 'discountDuration'],\n  [ReferredRewardType.TRIAL_EXTENSION]: ['trialExtensionDays'],\n};\n\n/** The delivery kind of either side's reward type. */\nexport function referralRewardDeliveryKind(type: ReferrerRewardType | ReferredRewardType): ReferredRewardType {\n  return Object.hasOwn(REFERRER_REWARD_DELIVERED_AS, type)\n    ? REFERRER_REWARD_DELIVERED_AS[type as ReferrerRewardType]\n    : type as ReferredRewardType;\n}\n\nconst ALL_REWARD_FIELDS = ['credits', 'creditPoolKey', 'featureKey', 'durationDays', 'percentOff', 'discountDuration', 'discountDurationInMonths', 'trialExtensionDays'] as const;\n\nconst rewardFields = {\n  credits: z.number().int().min(1).optional().describe('For a `credit` reward: how many credits are added to the pool.'),\n  creditPoolKey: z.string().min(1).optional().describe('For a `credit` reward: the key of the credit pool the credits are added to. The pool is created if the account has none.'),\n  featureKey: z.string().min(1).optional().describe('For a `feature` reward: the boolean feature the account is granted.'),\n  durationDays: z.number().int().min(1).optional().describe('For a `feature` reward: how many days after conversion the feature lasts. Absent means it does not expire.'),\n  percentOff: z.number().min(1).max(100).optional().describe('For a `discount` reward: the percentage taken off the subscription\\'s invoices.'),\n  discountDuration: z.enum(PromotionDuration).optional().describe('For a `discount` reward: how long it applies — `once` (the next invoice), `repeating` (for `discountDurationInMonths`) or `forever`.'),\n  discountDurationInMonths: z.number().int().min(1).optional().describe('For a `repeating` discount: how many months it applies.'),\n};\n\n/** Refuses a reward missing a field its kind needs, or carrying one its kind never reads. */\nfunction refineRewardShape(reward: Record<string, unknown> & { type: string }, context: z.RefinementCtx): void {\n  const type = reward.type as ReferrerRewardType | ReferredRewardType;\n  const kind = referralRewardDeliveryKind(type);\n  const allowed = REWARD_FIELDS_BY_TYPE[kind] ?? [];\n  for (const field of REQUIRED_REWARD_FIELDS_BY_TYPE[kind] ?? []) {\n    if (reward[field] === undefined) context.addIssue({ code: 'custom', path: [field], message: `A '${type}' reward needs '${field}'.` });\n  }\n  for (const field of ALL_REWARD_FIELDS) {\n    if (reward[field] !== undefined && !allowed.includes(field)) {\n      context.addIssue({ code: 'custom', path: [field], message: `A '${type}' reward does not read '${field}'.` });\n    }\n  }\n  const repeating = reward.discountDuration === PromotionDuration.REPEATING;\n  if (kind === ReferredRewardType.DISCOUNT && repeating !== (reward.discountDurationInMonths !== undefined)) {\n    context.addIssue({\n      code: 'custom', path: ['discountDurationInMonths'],\n      message: 'A repeating discount needs discountDurationInMonths, and only a repeating discount takes it.',\n    });\n  }\n}\n\n/** @wildo_source:part:start saas.models.billing.referral-program facet:layer:shared facet:audience:app-developer */\n/** What the referrer receives when the referral converts. */\nexport const ReferrerRewardSchema = z.object({\n  type: z.enum(ReferrerRewardType).systemEnum('ReferrerRewardType').describe('What the referrer receives: `credit`, `discount` or `feature`.'),\n  ...rewardFields,\n}).superRefine(refineRewardShape);\nexport type ReferrerReward = z.infer<typeof ReferrerRewardSchema>;\n\n/** What the referred account receives. */\nexport const ReferredRewardSchema = z.object({\n  type: z.enum(ReferredRewardType).systemEnum('ReferredRewardType').describe('What the referred account receives: `credit`, `discount`, `feature` or `trial_extension`.'),\n  ...rewardFields,\n  trialExtensionDays: z.number().int().min(1).optional().describe('For a `trial_extension` reward: the days added to the trial of a subscription checkout the referred account opens while the referral is accepted.'),\n}).superRefine(refineRewardShape);\nexport type ReferredReward = z.infer<typeof ReferredRewardSchema>;\n/** @wildo_source:part:end saas.models.billing.referral-program */\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"referral.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/referral.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAwD,MAAM,gDAAgD,CAAC;AAC7I,OAAO,EAGL,oBAAoB,EACrB,MAAM,uCAAuC,CAAC;AAK/C;;;;GAIG;AACH,oBAAY,mBAAmB;IAC7B,+EAA+E;IAC/E,KAAK,UAAU;IACf,kDAAkD;IAClD,MAAM,WAAW;CAClB;AAED,sHAAsH;AACtH,eAAO,MAAM,wBAAwB,iCAAqB,CAAC;AAE3D,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,iCAAqB,CAAC;AAE5D,KAAK,gBAAgB,GACjB,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,oDAAoD,GAC/D,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2G9C,CAAC"}
+{"version":3,"file":"referral.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/referral.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAwD,MAAM,gDAAgD,CAAC;AAC7I,OAAO,EAGL,oBAAoB,EACrB,MAAM,uCAAuC,CAAC;AAK/C;;;;GAIG;AACH,oBAAY,mBAAmB;IAC7B,+EAA+E;IAC/E,KAAK,UAAU;IACf,kDAAkD;IAClD,MAAM,WAAW;CAClB;AAED,sHAAsH;AACtH,eAAO,MAAM,wBAAwB,iCAAqB,CAAC;AAE3D,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,iCAAqB,CAAC;AAE5D,KAAK,gBAAgB,GACjB,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,oDAAoD,GAC/D,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2G9C,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"referral.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../../src/billing/referral.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Referral Resource Configuration\n *\n * Operational: referral tracking between billing accounts.\n */\n\nimport { z } from 'zod';\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport {\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n  ResourceRelationship,\n} from '../resources/resources.shared.schemas';\nimport { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas';\nimport { ReferralSchema } from './referral.shared.schemas';\n\n/**\n * The referral program's own verbs (#1802). The lifecycle's other steps have no route: a code is redeemed\n * from the REDEEMING account (`BillingAccount_Operations.REDEEM_REFERRAL`), and conversion happens when that\n * account pays its first invoice.\n */\nexport enum Referral_Operations {\n  /** Issue a single-use referral code for the organization's billing account. */\n  ISSUE = 'issue',\n  /** Withdraw a referral that has not converted. */\n  CANCEL = 'cancel',\n}\n\n/** ISSUE takes nothing: the referrer is the organization's own billing account, and the rewards are server policy. */\nexport const Referral_IssueRequestDto = z.strictObject({});\n\n/** CANCEL takes nothing: the referral in the path is the one withdrawn. */\nexport const Referral_CancelRequestDto = z.strictObject({});\n\ntype ReferralsCoreOps =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE;\n\nexport const referralsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  typeof Referral_Operations,\n  ReferralsCoreOps,\n  typeof ReferralSchema\n>({\n  mainSchema: ReferralSchema,\n  resourceIdentifier: CoreResourceType.REFERRALS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.REFERRALS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  // The referral program (#1802) writes the row it issues as the system: the owner asked for a code, and the row's\n  // rewards, code and status are server-set. Its scope FK is the routed organization, carried on the data.\n  systemAccessPolicy: { create: ResourceSystemAccessMode.ALLOWED },\n  customOperation: Referral_Operations,\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n  ],\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    [CoreResourceOperation.LIST]: {\n      variants: [\n      {\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      },\n      {\n        /*\n         * The TENANT's door onto its own referrals — added 2026-09-18 for issue #1295.\n         *\n         * The `INTERNAL_CALL` variant above is route-less and stays the DEFAULT, so the billing\n         * back-office's service-pipeline reads are untouched. The `organization-referrals` settings\n         * destination targets this operation and could never load: no route was mounted, so the rail\n         * entry existed and every request 404'd at the ROUTER.\n         *\n         * `ORG_OWNER` matches that destination's own `requiredRoles` exactly. The resource is\n         * ORGANIZATIONS-scoped and routed under the organization (`/organizations/{organizationId}/referrals`),\n         * so the contextual filter confines the answer to the caller's own tenant — this door shows an\n         * owner their own referrals and nobody else's.\n         *\n         * The route only exists since 2026-09-28. Adding this variant fixed the 404 but not the page: the\n         * ORGANIZATIONS edge was then a STANDALONE anchor, so the route mounted at `/api/v1/referrals`,\n         * carried no organization, and every request answered 403. See the edge in the core registry.\n         */\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      },\n      ],\n    },\n    [CoreResourceOperation.CREATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    [CoreResourceOperation.UPDATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    /*\n     * #1802 — an organization owner issues a code for the organization's billing account. The rewards it\n     * carries are copied from `billing.referrals` and never taken from the request, which is why the request\n     * DTO is empty and strict. MEDIUM: a code promises the application's money (credits, discounts) to\n     * whoever redeems it.\n     */\n    [Referral_Operations.ISSUE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        resourceOperationLike: CoreResourceOperation.CREATE,\n        requestDto: Referral_IssueRequestDto,\n      }],\n    },\n    /** #1802 — the owner withdraws a PENDING or ACCEPTED referral; a converted one has been paid out and stays. */\n    [Referral_Operations.CANCEL]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        resourceOperationLike: CoreResourceOperation.UPDATE,\n        requestDto: Referral_CancelRequestDto,\n      }],\n    },\n  },\n});\n"]}
+{"version":3,"file":"referral.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/billing/referral.shared.resources-config.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Referral Resource Configuration\n *\n * Operational: referral tracking between billing accounts.\n */\n\nimport { z } from 'zod';\nimport { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory';\nimport { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions';\nimport {\n  ResourceOperationRiskLevel,\n  ResourceOperationVariantType,\n  ResourceRelationship,\n} from '../resources/resources.shared.schemas';\nimport { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas';\nimport { ResourceSystemAccessMode } from '../resources/resources-config.shared.schemas';\nimport { ReferralSchema } from './referral.shared.schemas';\n\n/**\n * The referral program's own verbs (#1802). The lifecycle's other steps have no route: a code is redeemed\n * from the REDEEMING account (`BillingAccount_Operations.REDEEM_REFERRAL`), and conversion happens when that\n * account pays its first invoice.\n */\nexport enum Referral_Operations {\n  /** Issue a single-use referral code for the organization's billing account. */\n  ISSUE = 'issue',\n  /** Withdraw a referral that has not converted. */\n  CANCEL = 'cancel',\n}\n\n/** ISSUE takes nothing: the referrer is the organization's own billing account, and the rewards are server policy. */\nexport const Referral_IssueRequestDto = z.strictObject({});\n\n/** CANCEL takes nothing: the referral in the path is the one withdrawn. */\nexport const Referral_CancelRequestDto = z.strictObject({});\n\ntype ReferralsCoreOps =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE;\n\nexport const referralsResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  typeof Referral_Operations,\n  ReferralsCoreOps,\n  typeof ReferralSchema\n>({\n  mainSchema: ReferralSchema,\n  resourceIdentifier: CoreResourceType.REFERRALS,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.REFERRALS],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  // The referral program (#1802) writes the row it issues as the system: the owner asked for a code, and the row's\n  // rewards, code and status are server-set. Its scope FK is the routed organization, carried on the data.\n  systemAccessPolicy: { create: ResourceSystemAccessMode.ALLOWED },\n  customOperation: Referral_Operations,\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n  ],\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    [CoreResourceOperation.LIST]: {\n      variants: [\n      {\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      },\n      {\n        /*\n         * The TENANT's door onto its own referrals — added 2026-09-18 for issue #1295.\n         *\n         * The `INTERNAL_CALL` variant above is route-less and stays the DEFAULT, so the billing\n         * back-office's service-pipeline reads are untouched. The `organization-referrals` settings\n         * destination targets this operation and could never load: no route was mounted, so the rail\n         * entry existed and every request 404'd at the ROUTER.\n         *\n         * `ORG_OWNER` matches that destination's own `requiredRoles` exactly. The resource is\n         * ORGANIZATIONS-scoped and routed under the organization (`/organizations/{organizationId}/referrals`),\n         * so the contextual filter confines the answer to the caller's own tenant — this door shows an\n         * owner their own referrals and nobody else's.\n         *\n         * The route only exists since 2026-09-28. Adding this variant fixed the 404 but not the page: the\n         * ORGANIZATIONS edge was then a STANDALONE anchor, so the route mounted at `/api/v1/referrals`,\n         * carried no organization, and every request answered 403. See the edge in the core registry.\n         */\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      },\n      ],\n    },\n    [CoreResourceOperation.CREATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    [CoreResourceOperation.UPDATE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    /*\n     * #1802 — an organization owner issues a code for the organization's billing account. The rewards it\n     * carries are copied from `billing.referrals` and never taken from the request, which is why the request\n     * DTO is empty and strict. MEDIUM: a code promises the application's money (credits, discounts) to\n     * whoever redeems it.\n     */\n    [Referral_Operations.ISSUE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.MEDIUM,\n        resourceOperationLike: CoreResourceOperation.CREATE,\n        requestDto: Referral_IssueRequestDto,\n      }],\n    },\n    /** #1802 — the owner withdraws a PENDING or ACCEPTED referral; a converted one has been paid out and stays. */\n    [Referral_Operations.CANCEL]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.API_CALL,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n        resourceOperationLike: CoreResourceOperation.UPDATE,\n        requestDto: Referral_CancelRequestDto,\n      }],\n    },\n  },\n});\n"]}

package/dist/esm/billing/referral.shared.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"referral.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/referral.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAMlF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwEzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"referral.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/referral.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAMlF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwEzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"referral.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/referral.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Referral Schema (Shared) — one single-use referral code, from one referrer to one referred account (#1802).\n *\n * The lifecycle, and who moves it:\n * 1. PENDING — an organization's billing account issues the code (`ISSUE`). The rewards are\n *    copied from the application's `billing.referrals` policy at that moment, never taken from the caller.\n * 2. ACCEPTED — another billing account redeems the code (`REDEEM_REFERRAL`) before `expiresAt`. It must\n *    be a new customer: never subscribed, not already referred, and not the referrer.\n * 3. CONVERTED — the referred account's first paid invoice. Both sides' rewards are granted once each,\n *    and `referrerRewardApplied` / `referredRewardApplied` record the delivery.\n * EXPIRED — a code redeemed after `expiresAt` is refused and marked so. CANCELLED — the referrer\n * withdrew a PENDING or ACCEPTED referral.\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 { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport { BillingScopeType, ReferralStatus } from './billing-enums.shared.schemas';\nimport { ReferredRewardSchema, ReferrerRewardSchema } from './referral-reward.shared.schemas';\nimport { BILLING_SCOPE_DISCRIMINATED_FK_VARIANTS } from './billing-account.shared.schemas';\n\n// ── Referral ────────────────────────────────────────────────────\n\nexport const ReferralSchema = z.object({\n\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  /**\n   * The billing account that created the referral.\n   *\n   * Per-record DISCRIMINATED polymorphic FK: it references EITHER a\n   * `userBillingAccounts` or an `organizationBillingAccounts` record, chosen per\n   * record by the sibling `referrerScopeType`. Resolution/display/links consult\n   * the discriminator (via {@link BILLING_SCOPE_DISCRIMINATED_FK_VARIANTS}); the\n   * single-valued registry FK→type map only holds a NON-AUTHORITATIVE\n   * representative for this field.\n   */\n  referrerBillingAccountId: z.string().min(1).isForeignKey({\n    polymorphicVariants: BILLING_SCOPE_DISCRIMINATED_FK_VARIANTS,\n    polymorphicDiscriminatorField: 'referrerScopeType',\n  }).isDBIndexed().isSummaryField(),\n  /** Scope type of the referrer's billing account — the discriminator that selects the polymorphic billing-account branch for `referrerBillingAccountId`. */\n  referrerScopeType: z.enum(BillingScopeType).isDBIndexed(),\n  /**\n   * The billing account that was referred (set when they sign up).\n   *\n   * Per-record DISCRIMINATED polymorphic FK like `referrerBillingAccountId`,\n   * with the branch chosen by the sibling `referredScopeType`.\n   */\n  referredBillingAccountId: z.string().optional().isForeignKey({\n    polymorphicVariants: BILLING_SCOPE_DISCRIMINATED_FK_VARIANTS,\n    polymorphicDiscriminatorField: 'referredScopeType',\n  }).isDBIndexed(),\n  /** Scope type of the referred billing account (set together with referredBillingAccountId) — the discriminator that selects the branch for `referredBillingAccountId`. */\n  referredScopeType: z.enum(BillingScopeType).optional().isDBIndexed(),\n\n  /** Unique referral code (shared by referrer) */\n  // USAGE — a referral records that one account introduced another, and when both are USER-scoped\n  // billing accounts that is a social link between two people. The code itself is the identifier the\n  // link is made through. Declared even though the resource is scope-polymorphic, for the same\n  // reason as the billing family: an org variant at worst over-reports, a missing declaration\n  // silently under-reports.\n  referralCode: z.string().min(1).isUnique({ scope: 'global' }).isDBIndexed().isSummaryField()\n    .dataCategories(PersonalDataCategory.USAGE),\n\n  /** Current status */\n  status: z.enum(ReferralStatus).isDBIndexed().isSummaryField().systemEnum('ReferralStatus'),\n\n  // ── Rewards ──\n\n  /** What the referrer receives on conversion — copied from `billing.referrals` when the code is issued. */\n  referrerReward: ReferrerRewardSchema.optional().isNotEditable().describe('What the referrer receives when the referral converts, copied from the application\\'s referral policy when the code was issued. Absent when the policy gives the referrer nothing.'),\n  /** What the referred account receives — copied the same way. */\n  referredReward: ReferredRewardSchema.optional().isNotEditable().describe('What the referred account receives, copied from the application\\'s referral policy when the code was issued. Absent when the policy gives it nothing.'),\n\n  /**\n   * Whether each side's reward was delivered. Set once the grant has landed: a credit top-up, a\n   * discount on the account's subscription, or a feature grant starting. A discount waiting for the\n   * account to have an active subscription leaves it `false` until then.\n   */\n  referrerRewardApplied: z.boolean().default(false).isNotEditable().describe('Whether the referrer\\'s reward has been delivered.'),\n  referredRewardApplied: z.boolean().default(false).isNotEditable().describe('Whether the referred account\\'s reward has been delivered.'),\n\n  // ── Dates ──\n\n  /** When the referred user accepted the referral */\n  acceptedAt: z.date().optional().isNotEditable(),\n  /** When the referral converted: the referred account's first paid invoice with money on it. */\n  convertedAt: z.date().optional().isSummaryField().isNotEditable(),\n  /** When the referral expires */\n  expiresAt: z.date().optional().isDBIndexed().isSummaryField(),\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 Referral = z.infer<typeof ReferralSchema>;\n"]}
+{"version":3,"file":"referral.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/referral.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Referral Schema (Shared) — one single-use referral code, from one referrer to one referred account (#1802).\n *\n * The lifecycle, and who moves it:\n * 1. PENDING — an organization's billing account issues the code (`ISSUE`). The rewards are\n *    copied from the application's `billing.referrals` policy at that moment, never taken from the caller.\n * 2. ACCEPTED — another billing account redeems the code (`REDEEM_REFERRAL`) before `expiresAt`. It must\n *    be a new customer: never subscribed, not already referred, and not the referrer.\n * 3. CONVERTED — the referred account's first paid invoice. Both sides' rewards are granted once each,\n *    and `referrerRewardApplied` / `referredRewardApplied` record the delivery.\n * EXPIRED — a code redeemed after `expiresAt` is refused and marked so. CANCELLED — the referrer\n * withdrew a PENDING or ACCEPTED referral.\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 { PersonalDataCategory } from '../compliance/privacy/personal-data-category.shared.schemas';\nimport { BillingScopeType, ReferralStatus } from './billing-enums.shared.schemas';\nimport { ReferredRewardSchema, ReferrerRewardSchema } from './referral-reward.shared.schemas';\nimport { BILLING_SCOPE_DISCRIMINATED_FK_VARIANTS } from './billing-account.shared.schemas';\n\n// ── Referral ────────────────────────────────────────────────────\n\nexport const ReferralSchema = z.object({\n\n  _id: z.string().min(1).isPrimaryKey().isSummaryField(),\n\n  /**\n   * The billing account that created the referral.\n   *\n   * Per-record DISCRIMINATED polymorphic FK: it references EITHER a\n   * `userBillingAccounts` or an `organizationBillingAccounts` record, chosen per\n   * record by the sibling `referrerScopeType`. Resolution/display/links consult\n   * the discriminator (via {@link BILLING_SCOPE_DISCRIMINATED_FK_VARIANTS}); the\n   * single-valued registry FK→type map only holds a NON-AUTHORITATIVE\n   * representative for this field.\n   */\n  referrerBillingAccountId: z.string().min(1).isForeignKey({\n    polymorphicVariants: BILLING_SCOPE_DISCRIMINATED_FK_VARIANTS,\n    polymorphicDiscriminatorField: 'referrerScopeType',\n  }).isDBIndexed().isSummaryField(),\n  /** Scope type of the referrer's billing account — the discriminator that selects the polymorphic billing-account branch for `referrerBillingAccountId`. */\n  referrerScopeType: z.enum(BillingScopeType).isDBIndexed(),\n  /**\n   * The billing account that was referred (set when they sign up).\n   *\n   * Per-record DISCRIMINATED polymorphic FK like `referrerBillingAccountId`,\n   * with the branch chosen by the sibling `referredScopeType`.\n   */\n  referredBillingAccountId: z.string().optional().isForeignKey({\n    polymorphicVariants: BILLING_SCOPE_DISCRIMINATED_FK_VARIANTS,\n    polymorphicDiscriminatorField: 'referredScopeType',\n  }).isDBIndexed(),\n  /** Scope type of the referred billing account (set together with referredBillingAccountId) — the discriminator that selects the branch for `referredBillingAccountId`. */\n  referredScopeType: z.enum(BillingScopeType).optional().isDBIndexed(),\n\n  /** Unique referral code (shared by referrer) */\n  // USAGE — a referral records that one account introduced another, and when both are USER-scoped\n  // billing accounts that is a social link between two people. The code itself is the identifier the\n  // link is made through. Declared even though the resource is scope-polymorphic, for the same\n  // reason as the billing family: an org variant at worst over-reports, a missing declaration\n  // silently under-reports.\n  referralCode: z.string().min(1).isUnique({ scope: 'global' }).isDBIndexed().isSummaryField()\n    .dataCategories(PersonalDataCategory.USAGE),\n\n  /** Current status */\n  status: z.enum(ReferralStatus).isDBIndexed().isSummaryField().systemEnum('ReferralStatus'),\n\n  // ── Rewards ──\n\n  /** What the referrer receives on conversion — copied from `billing.referrals` when the code is issued. */\n  referrerReward: ReferrerRewardSchema.optional().isNotEditable().describe('What the referrer receives when the referral converts, copied from the application\\'s referral policy when the code was issued. Absent when the policy gives the referrer nothing.'),\n  /** What the referred account receives — copied the same way. */\n  referredReward: ReferredRewardSchema.optional().isNotEditable().describe('What the referred account receives, copied from the application\\'s referral policy when the code was issued. Absent when the policy gives it nothing.'),\n\n  /**\n   * Whether each side's reward was delivered. Set once the grant has landed: a credit top-up, a\n   * discount on the account's subscription, or a feature grant starting. A discount waiting for the\n   * account to have an active subscription leaves it `false` until then.\n   */\n  referrerRewardApplied: z.boolean().default(false).isNotEditable().describe('Whether the referrer\\'s reward has been delivered.'),\n  referredRewardApplied: z.boolean().default(false).isNotEditable().describe('Whether the referred account\\'s reward has been delivered.'),\n\n  // ── Dates ──\n\n  /** When the referred user accepted the referral */\n  acceptedAt: z.date().optional().isNotEditable(),\n  /** When the referral converted: the referred account's first paid invoice with money on it. */\n  convertedAt: z.date().optional().isSummaryField().isNotEditable(),\n  /** When the referral expires */\n  expiresAt: z.date().optional().isDBIndexed().isSummaryField(),\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 Referral = z.infer<typeof ReferralSchema>;\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"subscription.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/subscription.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAoB,MAAM,gDAAgD,CAAC;AAYzG,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAI/D,oBAAY,8BAA8B;IACxC,6DAA6D;IAC7D,MAAM,WAAW;IACjB,wDAAwD;IACxD,MAAM,WAAW;IACjB,qDAAqD;IACrD,WAAW,gBAAgB;IAC3B,+EAA+E;IAC/E,mBAAmB,wBAAwB;IAC3C,+CAA+C;IAC/C,SAAS,cAAc;IACvB,oDAAoD;IACpD,YAAY,iBAAiB;IAC7B;;;OAGG;IACH,kBAAkB,uBAAuB;CAC1C;AAID,wFAAwF;AACxF,eAAO,MAAM,oCAAoC;;;iBAiB/C,CAAC;AAEH,sFAAsF;AACtF,eAAO,MAAM,+CAA+C;;;iBAG1D,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,wCAAwC;;;;iBAEnD,CAAC;AAEH,6GAA6G;AAC7G,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;iBAmB3D,CAAC;AAEH,2FAA2F;AAC3F,eAAO,MAAM,sCAAsC;;;iBAGjD,CAAC;AAEH,8FAA8F;AAC9F,eAAO,MAAM,yCAAyC;;iBAEpD,CAAC;AAMH;;;;;;;;GAQG;AACH,eAAO,MAAM,wCAAwC,iRAyOpD,CAAC"}
+{"version":3,"file":"subscription.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/subscription.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAoB,MAAM,gDAAgD,CAAC;AAYzG,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAI/D,oBAAY,8BAA8B;IACxC,6DAA6D;IAC7D,MAAM,WAAW;IACjB,wDAAwD;IACxD,MAAM,WAAW;IACjB,qDAAqD;IACrD,WAAW,gBAAgB;IAC3B,+EAA+E;IAC/E,mBAAmB,wBAAwB;IAC3C,+CAA+C;IAC/C,SAAS,cAAc;IACvB,oDAAoD;IACpD,YAAY,iBAAiB;IAC7B;;;OAGG;IACH,kBAAkB,uBAAuB;CAC1C;AAID,wFAAwF;AACxF,eAAO,MAAM,oCAAoC;;;iBAiB/C,CAAC;AAEH,sFAAsF;AACtF,eAAO,MAAM,+CAA+C;;;iBAG1D,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,wCAAwC;;;;iBAEnD,CAAC;AAEH,6GAA6G;AAC7G,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;iBAmB3D,CAAC;AAEH,2FAA2F;AAC3F,eAAO,MAAM,sCAAsC;;;iBAGjD,CAAC;AAEH,8FAA8F;AAC9F,eAAO,MAAM,yCAAyC;;iBAEpD,CAAC;AAMH;;;;;;;;GAQG;AACH,eAAO,MAAM,wCAAwC,iRAyOpD,CAAC"}