npm - @wildo-ai/saas-models - Versions diffs - 1.1.5 → 1.1.7 - Mend

@wildo-ai/saas-models 1.1.5 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1295) hide show

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

@@ -122,17 +122,17 @@ export const promotionsResourceConfiguration_InitializationFactory = (resourcesR
                     // NOT the Promotion resource row. Without this the service output fails
                     // `transformOutput`'s `internalDto.parse` against the resource schema → 500.
                     customResponseDto: z.object({
-                        valid: z.boolean(),
-                        promotionId: z.string(),
-                        providerCouponId: z.string().nullish(),
-                        providerPromotionId: z.string().nullish(),
+                        valid: z.boolean().describe("Always `true`. A promotion that cannot be used is refused with an error instead."),
+                        promotionId: z.string().describe("The id of the promotion that was checked."),
+                        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."),
+                        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."),
                         discount: z.object({
-                            type: z.string(),
-                            percentage: z.number().optional(),
+                            type: z.string().describe("The kind of discount: `percentage` or `fixed_amount`."),
+                            percentage: z.number().optional().describe("For a `percentage` discount, the percentage taken off, from 0 to 100."),
                             // `amount` is a MoneyValue (z_money) — modelled permissively to avoid
                             // pulling the money factory into this response contract.
-                            amount: z.unknown().optional(),
-                        }),
+                            amount: z.unknown().optional().describe("For a `fixed_amount` discount, the amount taken off, as a money value with `amount`, `currency` and `decimals`."),
+                        }).describe("The discount the promotion gives. Checking a code does not redeem it: a redemption is counted when a checkout using the code completes."),
                     }),
                 }],
         },

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

	@@ -1 +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(),\n promotionId: z.string(),\n providerCouponId: z.string().nullish(),\n providerPromotionId: z.string().nullish(),\n discount: z.object({\n type: z.string(),\n percentage: z.number().optional(),\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(),\n }),\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"]}
1	+ {"version":3,"file":"promotions.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/billing/promotions.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0CAA0C,EAAE,MAAM,8CAA8C,CAAC;AAC1G,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,kCAAkC,EAAE,MAAM,gDAAgD,CAAC;AAC7I,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAE7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,wEAAwE;AAExE,MAAM,CAAN,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,2DAA2D;IAC3D,uCAAe,CAAA;IACf,sDAAsD;IACtD,iDAAyB,CAAA;AAC3B,CAAC,EALW,oBAAoB,KAApB,oBAAoB,QAK/B;AASD,MAAM,CAAC,MAAM,qDAAqD,GAAG,CACnE,sBAA8C,EAC9C,EAAE,CAAC,0CAA0C,CAI7C;IACA,UAAU,EAAE,eAAe;IAC3B,kBAAkB,EAAE,gBAAgB,CAAC,UAAU;IAC/C,uBAAuB,EAAE,kCAAkC,CAAC,gBAAgB,CAAC,UAAU,CAAC;IACxF,qBAAqB,EAAE,sBAAsB;IAC7C,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,oBAAoB;IACrC,cAAc,EAAE;QACd,qBAAqB,CAAC,IAAI;QAC1B,qBAAqB,CAAC,IAAI;QAC1B,qBAAqB,CAAC,MAAM;QAC5B,qBAAqB,CAAC,MAAM;QAC5B,qBAAqB,CAAC,MAAM;KAC7B;IACD,uBAAuB,EAAE;QACvB,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE;YAC5B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,aAAa;oBACvD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;oBACjC,SAAS,EAAE,0BAA0B,CAAC,GAAG;iBAC1C,CAAC;SACH;QACD,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE;YAC5B,QAAQ,EAAE;gBACV;oBACE,WAAW,EAAE,4BAA4B,CAAC,aAAa;oBACvD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;oBACjC,SAAS,EAAE,0BAA0B,CAAC,GAAG;iBAC1C;gBACD;oBACE;;;;;;;;;;;;;;;;;;;;;uBAqBG;oBACH,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,qBAAqB,CAAC;oBAC7C,SAAS,EAAE,0BAA0B,CAAC,GAAG;iBAC1C;aACA;SACF;QACD,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE;YAC9B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,aAAa;oBACvD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;oBACjC,SAAS,EAAE,0BAA0B,CAAC,GAAG;oBACzC,YAAY,EAAE,IAAI;oBAClB,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;oBAClC,iBAAiB,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;oBACjE,YAAY,EAAE,EAAE;oBAChB,UAAU,EAAE,EAAE;oBACd,8BAA8B,EAAE,EAAE;iBACnC,CAAC;SACH;QACD,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE;YAC9B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,aAAa;oBACvD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;oBACjC,SAAS,EAAE,0BAA0B,CAAC,MAAM;iBAC7C,CAAC;SACH;QACD,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE;YAC9B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,aAAa;oBACvD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;oBACjC,SAAS,EAAE,0BAA0B,CAAC,MAAM;iBAC7C,CAAC;SACH;QACD,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE;YAC5B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC;oBAC5D,SAAS,EAAE,0BAA0B,CAAC,GAAG;oBACzC,qBAAqB,EAAE,qBAAqB,CAAC,MAAM;oBACnD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;wBACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;qBACxB,CAAC;oBACF,8EAA8E;oBAC9E,wEAAwE;oBACxE,6EAA6E;oBAC7E,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC;wBAC1B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,kFAAkF,CAAC;wBAC/G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;wBAC7E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,oKAAoK,CAAC;wBACrN,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,8HAA8H,CAAC;wBAClL,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;4BACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;4BAClF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;4BACnH,sEAAsE;4BACtE,yDAAyD;4BACzD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iHAAiH,CAAC;yBAC3J,CAAC,CAAC,QAAQ,CAAC,yIAAyI,CAAC;qBACvJ,CAAC;iBACH,CAAC;SACH;QACD,CAAC,oBAAoB,CAAC,UAAU,CAAC,EAAE;YACjC,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;oBACjC,SAAS,EAAE,0BAA0B,CAAC,MAAM;oBAC5C,qBAAqB,EAAE,qBAAqB,CAAC,MAAM;oBACnD,iBAAiB,EAAE,IAAI;oBACvB,kFAAkF;oBAClF,sFAAsF;oBACtF,kFAAkF;oBAClF,oFAAoF;oBACpF,8EAA8E;oBAC9E,wBAAwB;oBACxB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;oBACxB,2EAA2E;oBAC3E,kCAAkC;oBAClC,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC;wBAC1B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;qBACtB,CAAC;iBACH,CAAC;SACH;KACF;CACF,CAAC,CAAC","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 CHANGED Viewed

	@@ -1 +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"}
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"}

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

	@@ -1 +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"]}
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"]}

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

@@ -0,0 +1,135 @@
+/**
+ * The PUBLIC pricing catalogue: what a pricing surface outside the application (the public website)
+ * may know about the application's billing catalogue, as plain JSON-safe data (#1835).
+ *
+ * ## Why this file imports nothing
+ *
+ * It is an ATOM on the `@wildo-ai/saas-models/public-runtime` seam. The website's pricing section is a
+ * browser island, and the billing vocabulary it would otherwise need (`ProductType`, `BillingInterval`,
+ * `PricingModel`) lives behind the decorator-framework root barrel and the provider models, neither of
+ * which may reach a browser bundle. So the catalogue is DERIVED on the build side, where those
+ * vocabularies are available (`derivePublicPricingCatalog` in `./public-pricing-catalog.shared`), and
+ * crosses into the browser as the plain shape declared here.
+ *
+ * ## Why a price carries `amountMinor` as a STRING
+ *
+ * A `z_money` amount is a `bigint` in minor units. A bigint does not survive `JSON.stringify` (it
+ * throws), and the catalogue crosses Astro's island serialization boundary, so it travels as the
+ * decimal digits of that integer — lossless, where a `number` would not be for large amounts.
+ */
+/** @wildo_source:part:start saas.models.billing.catalog-vocabularies facet:layer:shared facet:audience:app-developer */
+/**
+ * How much of a product's price a pricing surface may state.
+ *
+ * The catalogue always carries typed prices — a product cannot sync to the billing provider
+ * without one — but a commercial offer is not always fully decided by them. A plan sold as "per
+ * member, plus a platform fee we quote" has a real unit price and an unsettled total; an
+ * enterprise plan sold by a sales conversation may carry a placeholder price nobody should read.
+ * Before this vocabulary existed, every pricing surface either printed that price as if it were
+ * the whole offer, or kept its own hand-written list of exceptions (#1835).
+ *
+ * This is a DISPLAY fact and deliberately NOT an acquisition gate: a customer handed a checkout
+ * link for an on-request plan by a salesperson must still be able to pay it, for the same reason a
+ * private-but-active plan stays purchasable. Whether the product can
+ * be bought today is {@link ProductAvailability}'s question.
+ */
+export declare enum ProductPriceDisclosure {
+    /** The listed prices ARE the offer: a pricing page states them, and structured data may publish them. */
+    LISTED = "listed",
+    /**
+     * The listed price is a FLOOR: part of the total is not settled (a quoted fee, a volume term).
+     * A pricing page states it as a starting price, and structured data must not publish it as the
+     * price, because a search engine would show it as the whole offer.
+     */
+    STARTING_AT = "starting_at",
+    /** No price is stated: the offer is quoted on request (a "contact sales" plan). */
+    ON_REQUEST = "on_request"
+}
+/**
+ * Whether a product can be bought today.
+ *
+ * Distinct from `Product.isActive`, which is RETIREMENT — a product the catalogue withdrew, no
+ * longer sold and no longer offered. An UPCOMING product is the opposite end of the same life: it is
+ * announced on pricing surfaces so a visitor can see where the product is going, and it cannot be
+ * bought yet. Folding it into `isActive: false` would hide it from the very pages that announce it.
+ */
+export declare enum ProductAvailability {
+    /** On sale: the acquisition doors accept it (subject to retirement). */
+    AVAILABLE = "available",
+    /** Announced, not yet on sale: listed on pricing surfaces, refused at every acquisition door. */
+    UPCOMING = "upcoming"
+}
+/** @wildo_source:part:end saas.models.billing.catalog-vocabularies */
+/**
+ * How a public price RECURS, as a pricing page states it.
+ *
+ * Not a copy of the provider's `BillingInterval`: that vocabulary has no member for a one-time price
+ * (an absent interval means one-time), and this one must name it, because "once" and "per month" are
+ * different sentences on a pricing page. Every `BillingInterval` member maps onto one of these in
+ * `derivePublicPricingCatalog`, through a table that is total over it.
+ */
+export declare enum PublicPricingRecurrenceUnit {
+    /** Paid once — no recurrence. */
+    ONE_TIME = "one_time",
+    /** Recurs every `count` months. */
+    MONTH = "month",
+    /** Recurs every `count` years. */
+    YEAR = "year"
+}
+/**
+ * What one public price amount MEANS.
+ *
+ * A single amount can state a flat price or a per-unit price. It cannot state a tiered, graduated or
+ * package price, whose total depends on quantity; for those the amount is indicative only, so no
+ * surface may present it — or publish it in structured data — as the price.
+ */
+export declare enum PublicPricingAmountBasis {
+    /** The amount is the whole price for the period. */
+    FLAT = "flat",
+    /** The amount is per unit (a seat, a member) for the period. */
+    PER_UNIT = "per_unit",
+    /** The total depends on quantity (tiered, graduated, package): the amount is indicative only. */
+    VARIABLE = "variable"
+}
+/** One public price of a plan. */
+export interface PublicPricingPrice {
+    /** The price amount in the currency's MINOR units, as decimal digits (see the file header). */
+    readonly amountMinor: string;
+    /** How many decimal places `amountMinor` carries: the value is `amountMinor / 10 ** decimals`. */
+    readonly decimals: number;
+    /** ISO 4217 currency code. */
+    readonly currency: string;
+    readonly recurrence: {
+        readonly unit: PublicPricingRecurrenceUnit;
+        readonly count: number;
+    };
+    readonly amountBasis: PublicPricingAmountBasis;
+    /** The price the catalogue marks as the plan's default. */
+    readonly isDefault: boolean;
+}
+/** One public plan: a product the catalogue lists publicly, with its pricing-surface facts resolved. */
+export interface PublicPricingPlan {
+    /** The catalogue key — also the label namespace a surface names the plan by. */
+    readonly key: string;
+    readonly planTier?: string;
+    /** Ascending order on a pricing surface. */
+    readonly sortOrder: number;
+    /** The scopes that may subscribe (wire values of `ResourcePrimaryScope`). */
+    readonly targetScopes: readonly string[];
+    readonly isRecommended: boolean;
+    readonly priceDisclosure: ProductPriceDisclosure;
+    readonly availability: ProductAvailability;
+    /** Free-trial length when the plan offers one. */
+    readonly trialDays?: number;
+    readonly prices: readonly PublicPricingPrice[];
+}
+/** The public pricing catalogue: every publicly listed plan, in display order. */
+export interface PublicPricingCatalog {
+    readonly plans: readonly PublicPricingPlan[];
+}
+/**
+ * The amount of a public price as a plain decimal string (`"4"`, `"29.9"`, `"0.0001"`), exact — no
+ * floating point. What structured data publishes as `price`, and what a surface formats for display.
+ */
+export declare function publicPricingAmountDecimal(price: Pick<PublicPricingPrice, 'amountMinor' | 'decimals'>): string;
+//# sourceMappingURL=public-pricing-catalog.shared.atoms.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,112 @@
+/**
+ * The PUBLIC pricing catalogue: what a pricing surface outside the application (the public website)
+ * may know about the application's billing catalogue, as plain JSON-safe data (#1835).
+ *
+ * ## Why this file imports nothing
+ *
+ * It is an ATOM on the `@wildo-ai/saas-models/public-runtime` seam. The website's pricing section is a
+ * browser island, and the billing vocabulary it would otherwise need (`ProductType`, `BillingInterval`,
+ * `PricingModel`) lives behind the decorator-framework root barrel and the provider models, neither of
+ * which may reach a browser bundle. So the catalogue is DERIVED on the build side, where those
+ * vocabularies are available (`derivePublicPricingCatalog` in `./public-pricing-catalog.shared`), and
+ * crosses into the browser as the plain shape declared here.
+ *
+ * ## Why a price carries `amountMinor` as a STRING
+ *
+ * A `z_money` amount is a `bigint` in minor units. A bigint does not survive `JSON.stringify` (it
+ * throws), and the catalogue crosses Astro's island serialization boundary, so it travels as the
+ * decimal digits of that integer — lossless, where a `number` would not be for large amounts.
+ */
+/** @wildo_source:part:start saas.models.billing.catalog-vocabularies facet:layer:shared facet:audience:app-developer */
+/**
+ * How much of a product's price a pricing surface may state.
+ *
+ * The catalogue always carries typed prices — a product cannot sync to the billing provider
+ * without one — but a commercial offer is not always fully decided by them. A plan sold as "per
+ * member, plus a platform fee we quote" has a real unit price and an unsettled total; an
+ * enterprise plan sold by a sales conversation may carry a placeholder price nobody should read.
+ * Before this vocabulary existed, every pricing surface either printed that price as if it were
+ * the whole offer, or kept its own hand-written list of exceptions (#1835).
+ *
+ * This is a DISPLAY fact and deliberately NOT an acquisition gate: a customer handed a checkout
+ * link for an on-request plan by a salesperson must still be able to pay it, for the same reason a
+ * private-but-active plan stays purchasable. Whether the product can
+ * be bought today is {@link ProductAvailability}'s question.
+ */
+export var ProductPriceDisclosure;
+(function (ProductPriceDisclosure) {
+    /** The listed prices ARE the offer: a pricing page states them, and structured data may publish them. */
+    ProductPriceDisclosure["LISTED"] = "listed";
+    /**
+     * The listed price is a FLOOR: part of the total is not settled (a quoted fee, a volume term).
+     * A pricing page states it as a starting price, and structured data must not publish it as the
+     * price, because a search engine would show it as the whole offer.
+     */
+    ProductPriceDisclosure["STARTING_AT"] = "starting_at";
+    /** No price is stated: the offer is quoted on request (a "contact sales" plan). */
+    ProductPriceDisclosure["ON_REQUEST"] = "on_request";
+})(ProductPriceDisclosure || (ProductPriceDisclosure = {}));
+/**
+ * Whether a product can be bought today.
+ *
+ * Distinct from `Product.isActive`, which is RETIREMENT — a product the catalogue withdrew, no
+ * longer sold and no longer offered. An UPCOMING product is the opposite end of the same life: it is
+ * announced on pricing surfaces so a visitor can see where the product is going, and it cannot be
+ * bought yet. Folding it into `isActive: false` would hide it from the very pages that announce it.
+ */
+export var ProductAvailability;
+(function (ProductAvailability) {
+    /** On sale: the acquisition doors accept it (subject to retirement). */
+    ProductAvailability["AVAILABLE"] = "available";
+    /** Announced, not yet on sale: listed on pricing surfaces, refused at every acquisition door. */
+    ProductAvailability["UPCOMING"] = "upcoming";
+})(ProductAvailability || (ProductAvailability = {}));
+/** @wildo_source:part:end saas.models.billing.catalog-vocabularies */
+/**
+ * How a public price RECURS, as a pricing page states it.
+ *
+ * Not a copy of the provider's `BillingInterval`: that vocabulary has no member for a one-time price
+ * (an absent interval means one-time), and this one must name it, because "once" and "per month" are
+ * different sentences on a pricing page. Every `BillingInterval` member maps onto one of these in
+ * `derivePublicPricingCatalog`, through a table that is total over it.
+ */
+export var PublicPricingRecurrenceUnit;
+(function (PublicPricingRecurrenceUnit) {
+    /** Paid once — no recurrence. */
+    PublicPricingRecurrenceUnit["ONE_TIME"] = "one_time";
+    /** Recurs every `count` months. */
+    PublicPricingRecurrenceUnit["MONTH"] = "month";
+    /** Recurs every `count` years. */
+    PublicPricingRecurrenceUnit["YEAR"] = "year";
+})(PublicPricingRecurrenceUnit || (PublicPricingRecurrenceUnit = {}));
+/**
+ * What one public price amount MEANS.
+ *
+ * A single amount can state a flat price or a per-unit price. It cannot state a tiered, graduated or
+ * package price, whose total depends on quantity; for those the amount is indicative only, so no
+ * surface may present it — or publish it in structured data — as the price.
+ */
+export var PublicPricingAmountBasis;
+(function (PublicPricingAmountBasis) {
+    /** The amount is the whole price for the period. */
+    PublicPricingAmountBasis["FLAT"] = "flat";
+    /** The amount is per unit (a seat, a member) for the period. */
+    PublicPricingAmountBasis["PER_UNIT"] = "per_unit";
+    /** The total depends on quantity (tiered, graduated, package): the amount is indicative only. */
+    PublicPricingAmountBasis["VARIABLE"] = "variable";
+})(PublicPricingAmountBasis || (PublicPricingAmountBasis = {}));
+/**
+ * The amount of a public price as a plain decimal string (`"4"`, `"29.9"`, `"0.0001"`), exact — no
+ * floating point. What structured data publishes as `price`, and what a surface formats for display.
+ */
+export function publicPricingAmountDecimal(price) {
+    const negative = price.amountMinor.startsWith('-');
+    const digits = (negative ? price.amountMinor.slice(1) : price.amountMinor).replace(/^0+(?=\d)/, '');
+    if (price.decimals <= 0)
+        return `${negative ? '-' : ''}${digits}`;
+    const padded = digits.padStart(price.decimals + 1, '0');
+    const whole = padded.slice(0, padded.length - price.decimals);
+    const fraction = padded.slice(padded.length - price.decimals).replace(/0+$/, '');
+    return `${negative ? '-' : ''}${whole}${fraction.length > 0 ? `.${fraction}` : ''}`;
+}
+//# sourceMappingURL=public-pricing-catalog.shared.atoms.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,30 @@
+/**
+ * `derivePublicPricingCatalog` — the billing catalogue as a public pricing surface may state it (#1835).
+ *
+ * The public website must not keep its own copy of the prices it advertises: before this, every
+ * application's pricing section re-typed its prices by hand, and Wonder Todos' site published a $12
+ * tier its own catalogue does not sell. So the website reads THIS, derived from the same
+ * `ProductDefinition[]` the backend syncs to the billing provider — one catalogue, two surfaces.
+ *
+ * It lives on the root barrel, not beside the plain types in `./public-pricing-catalog.shared.atoms`,
+ * because it needs the billing vocabularies (`ProductType`, `BillingInterval`, `PricingModel`) that
+ * may not reach a browser bundle. It runs on the build side and hands the browser plain data.
+ *
+ * ## What is public
+ *
+ * PLAN products the catalogue lists publicly (`isPublic` not `false`) — the same visibility rule the
+ * application's own pricing table applies. Add-ons, metered products and one-off purchases are not
+ * plans a visitor chooses between. RETIRED products never reach this function: it reads the code
+ * catalogue, and a product retired from the catalogue is by definition no longer in it.
+ */
+import type { ProductDefinition } from './product-definition.shared.schemas';
+import { type PublicPricingCatalog } from './public-pricing-catalog.shared.atoms';
+export interface DerivePublicPricingCatalogOptions {
+    /**
+     * Keep only plans this scope may subscribe to (a `ResourcePrimaryScope` wire value). Omit to keep
+     * every public plan — the right answer for a site whose catalogue sells to one audience.
+     */
+    readonly targetScope?: string;
+}
+export declare function derivePublicPricingCatalog(definitions: readonly ProductDefinition[], options?: DerivePublicPricingCatalogOptions): PublicPricingCatalog;
+//# sourceMappingURL=public-pricing-catalog.shared.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,53 @@
+import { resolveProductPricingSurfaceFacts } from './product-definition.shared.schemas.js';
+import { ProductType, PricingModel, BillingInterval } from './billing-enums.shared.schemas.js';
+import { PublicPricingAmountBasis, PublicPricingRecurrenceUnit, } from './public-pricing-catalog.shared.atoms.js';
+/** Total over `BillingInterval`: a member added there is a compile error here until it is mapped. */
+const RECURRENCE_BY_BILLING_INTERVAL = {
+    [BillingInterval.MONTH]: PublicPricingRecurrenceUnit.MONTH,
+    [BillingInterval.YEAR]: PublicPricingRecurrenceUnit.YEAR,
+};
+/** Total over `PricingModel`: which models a single amount can state (see `PublicPricingAmountBasis`). */
+const AMOUNT_BASIS_BY_PRICING_MODEL = {
+    [PricingModel.FLAT]: PublicPricingAmountBasis.FLAT,
+    [PricingModel.PER_UNIT]: PublicPricingAmountBasis.PER_UNIT,
+    [PricingModel.TIERED]: PublicPricingAmountBasis.VARIABLE,
+    [PricingModel.GRADUATED]: PublicPricingAmountBasis.VARIABLE,
+    [PricingModel.PACKAGE]: PublicPricingAmountBasis.VARIABLE,
+};
+export function derivePublicPricingCatalog(definitions, options = {}) {
+    const plans = definitions
+        .filter((definition) => definition.type === ProductType.PLAN && definition.isPublic !== false)
+        .filter((definition) => options.targetScope === undefined || definition.targetScopes.some((scope) => scope === options.targetScope))
+        .map((definition) => {
+        const facts = resolveProductPricingSurfaceFacts(definition);
+        const trialDays = definition.behaviorPolicy?.trial?.days;
+        return {
+            key: definition.key,
+            ...(definition.planTier === undefined ? {} : { planTier: definition.planTier }),
+            // The persisted `Product` resource defaults `sortOrder` to 0; apply the same fallback.
+            sortOrder: definition.sortOrder ?? 0,
+            targetScopes: [...definition.targetScopes],
+            isRecommended: facts.isRecommended,
+            priceDisclosure: facts.priceDisclosure,
+            availability: facts.availability,
+            ...(trialDays === undefined || trialDays <= 0 ? {} : { trialDays }),
+            prices: definition.prices.map(toPublicPricingPrice),
+        };
+    });
+    // Stable: equal `sortOrder`s keep catalogue order, so the page does not reorder on an unrelated edit.
+    return { plans: [...plans].sort((left, right) => left.sortOrder - right.sortOrder) };
+}
+function toPublicPricingPrice(price) {
+    return {
+        amountMinor: price.unitPrice.amount.toString(),
+        decimals: price.unitPrice.decimals,
+        currency: String(price.unitPrice.currency),
+        recurrence: price.interval === undefined
+            ? { unit: PublicPricingRecurrenceUnit.ONE_TIME, count: 1 }
+            : { unit: RECURRENCE_BY_BILLING_INTERVAL[price.interval], count: price.intervalCount ?? 1 },
+        amountBasis: AMOUNT_BASIS_BY_PRICING_MODEL[price.model],
+        // `PriceDefinitionSchema` defaults `isDefault` to true; a hand-authored definition that omits it means the same.
+        isDefault: price.isDefault ?? true,
+    };
+}
+//# sourceMappingURL=public-pricing-catalog.shared.js.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,51 @@
+/**
+ * Referral rewards (#1802) — what each side of a referral receives, and the fields each kind reads.
+ *
+ * One object per side, with a `type` and the fields that type needs. A refinement requires exactly
+ * those fields and refuses the others, so a reward cannot carry a `featureKey` it will never use, and
+ * what each field means is stated here rather than in a comment beside a generic `value`.
+ *
+ * Rewards are SERVER policy: the application declares them in `billing.referrals`, and a referral
+ * copies them when it is issued. A caller never supplies them, because a caller who could would
+ * grant itself anything.
+ */
+import { z } from 'zod';
+import '@wildo-ai/zod-decorators';
+import { PromotionDuration, ReferredRewardType, ReferrerRewardType } from './billing-enums.shared.schemas';
+/**
+ * The referred kind each referrer kind is delivered as. The two vocabularies stay distinct — they are
+ * different sides' promises — but a referrer's credit, discount or feature is read and granted exactly
+ * as the referred side's is. A `Record` over the referrer enum, so a new referrer kind cannot ship
+ * without saying which delivery it shares.
+ */
+export declare const REFERRER_REWARD_DELIVERED_AS: Readonly<Record<ReferrerRewardType, ReferredRewardType>>;
+/** The delivery kind of either side's reward type. */
+export declare function referralRewardDeliveryKind(type: ReferrerRewardType | ReferredRewardType): ReferredRewardType;
+/** @wildo_source:part:start saas.models.billing.referral-program facet:layer:shared facet:audience:app-developer */
+/** What the referrer receives when the referral converts. */
+export declare const ReferrerRewardSchema: z.ZodObject<{
+    credits: z.ZodOptional<z.ZodNumber>;
+    creditPoolKey: z.ZodOptional<z.ZodString>;
+    featureKey: z.ZodOptional<z.ZodString>;
+    durationDays: z.ZodOptional<z.ZodNumber>;
+    percentOff: z.ZodOptional<z.ZodNumber>;
+    discountDuration: z.ZodOptional<z.ZodEnum<typeof PromotionDuration>>;
+    discountDurationInMonths: z.ZodOptional<z.ZodNumber>;
+    type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof ReferrerRewardType>>;
+}, z.core.$strip>;
+export type ReferrerReward = z.infer<typeof ReferrerRewardSchema>;
+/** What the referred account receives. */
+export declare const ReferredRewardSchema: z.ZodObject<{
+    trialExtensionDays: z.ZodOptional<z.ZodNumber>;
+    credits: z.ZodOptional<z.ZodNumber>;
+    creditPoolKey: z.ZodOptional<z.ZodString>;
+    featureKey: z.ZodOptional<z.ZodString>;
+    durationDays: z.ZodOptional<z.ZodNumber>;
+    percentOff: z.ZodOptional<z.ZodNumber>;
+    discountDuration: z.ZodOptional<z.ZodEnum<typeof PromotionDuration>>;
+    discountDurationInMonths: z.ZodOptional<z.ZodNumber>;
+    type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof ReferredRewardType>>;
+}, z.core.$strip>;
+export type ReferredReward = z.infer<typeof ReferredRewardSchema>;
+/** @wildo_source:part:end saas.models.billing.referral-program */
+//# sourceMappingURL=referral-reward.shared.schemas.d.ts.map

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

@@ -0,0 +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"}