@wildo-ai/saas-models 1.0.1

package/dist/esm/billing/invoice-ref.shared.resources-config.schemas.js

@@ -0,0 +1,86 @@
+/**
+ * Invoice Reference Resource Configuration — Polymorphic
+ *
+ * Produces 3 factory functions (one per scope variant) via the polymorphic factory.
+ * Spread into the registry factory map:
+ *   ...invoiceRefsPolymorphicFactories
+ */
+import { CoreResourceOperation, CoreResourceType } from '../resources/resources.shared.core.definitions.js';
+import { ResourceOperationRiskLevel, ResourceOperationVariantType, } from '../resources/resources.shared.schemas.js';
+import { createPolymorphicResourceConfigurations } from '../resources/utils/resource-polymorphism.factory.js';
+import { CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas.js';
+import { invoiceRefsPolymorphicDeclaration } from './invoice-ref.shared.schemas.js';
+export const invoiceRefsPolymorphicFactories = createPolymorphicResourceConfigurations(invoiceRefsPolymorphicDeclaration, {
+    isSystemResource: true,
+    coreOperations: [
+        CoreResourceOperation.READ,
+        CoreResourceOperation.LIST,
+        CoreResourceOperation.SEARCH,
+        CoreResourceOperation.CREATE,
+        CoreResourceOperation.UPDATE,
+    ],
+    operationsConfiguration: {
+        [CoreResourceOperation.READ]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    polymorphicRole: {
+                        [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER],
+                        [CoreResourceType.USERS]: [],
+                    },
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.LIST]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    polymorphicRole: {
+                        [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER],
+                        [CoreResourceType.USERS]: [],
+                    },
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.SEARCH]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    polymorphicRole: {
+                        [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER],
+                        [CoreResourceType.USERS]: [],
+                    },
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                    isSearchable: true,
+                    searchableFields: ['status'],
+                    searchableOptions: { caseSensitive: false, fullMatchOnly: false },
+                    filterFields: {},
+                    sortFields: [],
+                    maxPaginatedResultPerPageLimit: 50,
+                }],
+        },
+        [CoreResourceOperation.CREATE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    polymorphicRole: {
+                        [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER],
+                        [CoreResourceType.USERS]: [],
+                    },
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.UPDATE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    polymorphicRole: {
+                        [CoreResourceType.ORGANIZATIONS]: [CORE_ORG_ROLES.ORG_OWNER],
+                        [CoreResourceType.USERS]: [],
+                    },
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+    },
+});
+//# sourceMappingURL=invoice-ref.shared.resources-config.schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ref.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/billing/invoice-ref.shared.resources-config.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/billing/invoice-ref.shared.schemas.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Invoice Reference Schema (Shared) — Polymorphic
+ *
+ * Thin reference synced FROM provider (webhook-driven), NOT created by Wildo.
+ * Only stores what's needed for: billing status checks, quick display, and provider links.
+ *
+ * POLYMORPHIC EXPANSION: Like subscriptions, invoice refs are scope-expanded.
+ * The `billingAccountId` FK is renamed per variant via polymorphic FK transformation:
+ *   - organizationInvoiceRefs  (with organizationId + organizationBillingAccountId)
+ *   - userInvoiceRefs          (with userId + userBillingAccountId)
+ *
+ *
+ * @see billing-and-features-system.md §6.4 (Invoice References)
+ */
+import { z } from 'zod';
+import { InvoiceStatus } from './billing-enums.shared.schemas.js';
+export declare const InvoiceRefSchema: z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    billingAccountId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    status: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof InvoiceStatus>>>>;
+    total: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>;
+    hostedInvoiceUrl: z.ZodOptional<z.ZodString>;
+    invoicePdfUrl: z.ZodOptional<z.ZodString>;
+    providerInvoiceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
+    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type InvoiceRef = z.infer<typeof InvoiceRefSchema>;
+export declare const invoiceRefsPolymorphicDeclaration: import("../index.js").PolymorphicSchemaDeclaration<z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    billingAccountId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    status: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof InvoiceStatus>>>>;
+    total: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>;
+    hostedInvoiceUrl: z.ZodOptional<z.ZodString>;
+    invoicePdfUrl: z.ZodOptional<z.ZodString>;
+    providerInvoiceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
+    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+    updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+}, z.core.$strip, core.$ZodObjectExtra>>;
+//# sourceMappingURL=invoice-ref.shared.schemas.d.ts.map

package/dist/esm/billing/invoice-ref.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ref.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/invoice-ref.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,eAAO,MAAM,gBAAgB;;;;;;;;;;uCAmB3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,eAAO,MAAM,iCAAiC;;;;;;;;;;wCAM5C,CAAC"}

package/dist/esm/billing/invoice-ref.shared.schemas.js

@@ -0,0 +1,43 @@
+/**
+ * Invoice Reference Schema (Shared) — Polymorphic
+ *
+ * Thin reference synced FROM provider (webhook-driven), NOT created by Wildo.
+ * Only stores what's needed for: billing status checks, quick display, and provider links.
+ *
+ * POLYMORPHIC EXPANSION: Like subscriptions, invoice refs are scope-expanded.
+ * The `billingAccountId` FK is renamed per variant via polymorphic FK transformation:
+ *   - organizationInvoiceRefs  (with organizationId + organizationBillingAccountId)
+ *   - userInvoiceRefs          (with userId + userBillingAccountId)
+ *
+ *
+ * @see billing-and-features-system.md §6.4 (Invoice References)
+ */
+import { z } from 'zod';
+import { z_money, CurrencyAllowed } from '@wildo-ai/zod-decorators';
+import { declarePolymorphicSchemas } from '../resources/utils/resource-polymorphism.schemas.js';
+import { BILLING_SCOPE_VARIANTS, BILLING_SCOPE_FK_VARIANTS } from './billing-account.shared.schemas.js';
+import { InvoiceStatus } from './billing-enums.shared.schemas.js';
+export const InvoiceRefSchema = z.object({
+    _id: z.string().min(1).isPrimaryKey().isSummaryField(),
+    billingAccountId: z.string().min(1).isForeignKey({ polymorphicVariants: BILLING_SCOPE_FK_VARIANTS }).isDBIndexed(),
+    /** Status - needed for billing status checks (past_due detection, etc.) */
+    status: z.enum(InvoiceStatus).isDBIndexed().isSummaryField().systemEnum('InvoiceStatus'),
+    /** Total amount - needed for quick display in subscription overview */
+    total: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT] }).isSummaryField(),
+    /** Provider-hosted URLs (user clicks "View Invoice" → opens Stripe page) */
+    hostedInvoiceUrl: z.string().optional(),
+    invoicePdfUrl: z.string().optional(),
+    /** Provider reference */
+    providerInvoiceId: z.string().isBackendOnly(),
+    createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
+    updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
+});
+// ── Polymorphic Declaration ────────────────────────────────────────
+export const invoiceRefsPolymorphicDeclaration = declarePolymorphicSchemas({
+    baseResourceType: 'invoiceRefs',
+    baseFieldIdentifier: 'invoiceRefId',
+    baseEnumKey: 'INVOICE_REFS',
+    baseSchema: InvoiceRefSchema,
+    variants: BILLING_SCOPE_VARIANTS,
+});
+//# sourceMappingURL=invoice-ref.shared.schemas.js.map

package/dist/esm/billing/invoice-ref.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice-ref.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/invoice-ref.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE;IACtD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,CAAC,CAAC,WAAW,EAAE;IAElH,2EAA2E;IAC3E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC,cAAc,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC;IAExF,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,cAAc,EAAE;IAE9E,4EAA4E;IAC5E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEpC,yBAAyB;IACzB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE;IAE7C,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;IACrF,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;CACtF,CAAC,CAAC;AAGH,sEAAsE;AAEtE,MAAM,CAAC,MAAM,iCAAiC,GAAG,yBAAyB,CAAC;IACzE,gBAAgB,EAAE,aAAa;IAC/B,mBAAmB,EAAE,cAAc;IACnC,WAAW,EAAE,cAAc;IAC3B,UAAU,EAAE,gBAAgB;IAC5B,QAAQ,EAAE,sBAAsB;CACjC,CAAC,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Price Resource Configuration
+ *
+ * Admin-managed: APPLICATION-scoped, linked to products.
+ */
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+import { ResourceRelationship } from '../resources/resources.shared.schemas.js';
+type PricesCoreOps = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE;
+export declare const pricesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("../index.js").ResourceConfiguration<undefined, PricesCoreOps, import("zod").ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
+    productId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
+    model: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodEnum<typeof import("@wildo-ai/external-connectors-models").PricingModel>>>;
+    unitPrice: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>;
+    interval: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodEnum<typeof import("@wildo-ai/external-connectors-models").BillingInterval>>>;
+    intervalCount: import("zod").ZodDefault<import("zod").ZodNumber>;
+    tiers: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        upTo: import("zod").ZodNullable<import("zod").ZodNumber>;
+        unitPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+        flatPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+    }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>>;
+    packageSize: import("zod").ZodOptional<import("zod").ZodNumber>;
+    usageAggregation: import("zod").ZodOptional<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").UsageAggregationType>>;
+    taxBehavior: import("zod").ZodOptional<import("zod").ZodEnum<typeof import("@wildo-ai/external-connectors-models").TaxDisplayMode>>;
+    providerPriceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodString>>;
+    isDefault: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodBoolean>>;
+    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodDate>>>;
+}, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+export {};
+//# sourceMappingURL=price.shared.resources-config.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"price.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/price.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,qBAAqB,EAAwD,MAAM,gDAAgD,CAAC;AAC7I,OAAO,EAGL,oBAAoB,EACrB,MAAM,uCAAuC,CAAC;AAI/C,KAAK,aAAa,GACd,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,iDAAiD,GAC5D,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;uDAmD9C,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * Price Resource Configuration
+ *
+ * Admin-managed: APPLICATION-scoped, linked to products.
+ */
+import { createResourceConfiguration_Initialization } from '../resources/resources-config.shared.factory.js';
+import { CoreResourceOperation, CoreResourceType, coreResourceShared_FieldIdentifier } from '../resources/resources.shared.core.definitions.js';
+import { ResourceOperationRiskLevel, ResourceOperationVariantType, } from '../resources/resources.shared.schemas.js';
+import { CORE_APP_ROLES, CORE_ORG_ROLES } from '../security/authorizations/roles.shared.schemas.js';
+import { PriceSchema } from './price.shared.schemas.js';
+export const pricesResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
+    mainSchema: PriceSchema,
+    resourceIdentifier: CoreResourceType.PRICES,
+    resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.PRICES],
+    resourceRelationships: resourcesRelationships,
+    isSystemResource: true,
+    coreOperations: [
+        CoreResourceOperation.READ,
+        CoreResourceOperation.LIST,
+        CoreResourceOperation.CREATE,
+        CoreResourceOperation.UPDATE,
+    ],
+    operationsConfiguration: {
+        [CoreResourceOperation.READ]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_USER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.LIST]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_USER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.CREATE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.MEDIUM,
+                }],
+        },
+        [CoreResourceOperation.UPDATE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.MEDIUM,
+                }],
+        },
+    },
+});
+//# sourceMappingURL=price.shared.resources-config.schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"price.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/billing/price.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,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,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAQrD,MAAM,CAAC,MAAM,iDAAiD,GAAG,CAC/D,sBAA8C,EAC9C,EAAE,CAAC,0CAA0C,CAI7C;IACA,UAAU,EAAE,WAAW;IACvB,kBAAkB,EAAE,gBAAgB,CAAC,MAAM;IAC3C,uBAAuB,EAAE,kCAAkC,CAAC,gBAAgB,CAAC,MAAM,CAAC;IACpF,qBAAqB,EAAE,sBAAsB;IAC7C,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE;QACd,qBAAqB,CAAC,IAAI;QAC1B,qBAAqB,CAAC,IAAI;QAC1B,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,eAAe;oBACzD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC;oBAChC,SAAS,EAAE,0BAA0B,CAAC,GAAG;iBAC1C,CAAC;SACH;QACD,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE;YAC5B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,eAAe;oBACzD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC;oBAChC,SAAS,EAAE,0BAA0B,CAAC,GAAG;iBAC1C,CAAC;SACH;QACD,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE;YAC9B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,eAAe;oBACzD,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,eAAe;oBACzD,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;oBACjC,SAAS,EAAE,0BAA0B,CAAC,MAAM;iBAC7C,CAAC;SACH;KACF;CACF,CAAC,CAAC"}

package/dist/esm/billing/price.shared.schemas.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Price & Price Tier Schemas (Shared)
+ *
+ * Prices define how much a product costs. A product can have multiple prices
+ * (e.g., monthly vs. yearly, different currencies).
+ *
+ * Prices are APPLICATION-scoped, linked to a Product via productId.
+ * Like products, they are populated lazily from the code-defined catalog.
+ *
+ * @see billing-and-features-system.md §6.2 (Product & Price Catalog)
+ */
+import { z } from 'zod';
+import { PricingModel, BillingInterval, UsageAggregationType, TaxDisplayMode } from './billing-enums.shared.schemas.js';
+/**
+ * A single tier in a tiered/graduated pricing model.
+ * `upTo: null` means "infinity" (the final open-ended tier).
+ *
+ * Tier amounts carry their own currency via z_money for:
+ * - Self-describing data (no implicit dependency on parent Price's currency)
+ * - Proper money input rendering in forms
+ * - Bigint precision for all monetary values
+ */
+export declare const PriceTierSchema: z.ZodObject<{
+    upTo: z.ZodNullable<z.ZodNumber>;
+    unitPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+    flatPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type PriceTier = z.infer<typeof PriceTierSchema>;
+export declare const PriceSchema: z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    productId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    model: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof PricingModel>>>;
+    unitPrice: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>;
+    interval: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<typeof BillingInterval>>>;
+    intervalCount: z.ZodDefault<z.ZodNumber>;
+    tiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        upTo: z.ZodNullable<z.ZodNumber>;
+        unitPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+        flatPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    packageSize: z.ZodOptional<z.ZodNumber>;
+    usageAggregation: z.ZodOptional<z.ZodEnum<typeof UsageAggregationType>>;
+    taxBehavior: z.ZodOptional<z.ZodEnum<typeof TaxDisplayMode>>;
+    providerPriceId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    isDefault: z.ZodDefault<z.ZodBoolean>;
+    isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodDate>>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type Price = z.infer<typeof PriceSchema>;
+//# sourceMappingURL=price.shared.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"price.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/price.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,cAAc,EACf,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;uCAO1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;uCA2CtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/esm/billing/price.shared.schemas.js

@@ -0,0 +1,72 @@
+/**
+ * Price & Price Tier Schemas (Shared)
+ *
+ * Prices define how much a product costs. A product can have multiple prices
+ * (e.g., monthly vs. yearly, different currencies).
+ *
+ * Prices are APPLICATION-scoped, linked to a Product via productId.
+ * Like products, they are populated lazily from the code-defined catalog.
+ *
+ * @see billing-and-features-system.md §6.2 (Product & Price Catalog)
+ */
+import { z } from 'zod';
+import { z_money, CurrencyAllowed } from '@wildo-ai/zod-decorators';
+import { PricingModel, BillingInterval, UsageAggregationType, TaxDisplayMode, } from './billing-enums.shared.schemas.js';
+// ── Price Tier ─────────────────────────────────────────────────────
+/**
+ * A single tier in a tiered/graduated pricing model.
+ * `upTo: null` means "infinity" (the final open-ended tier).
+ *
+ * Tier amounts carry their own currency via z_money for:
+ * - Self-describing data (no implicit dependency on parent Price's currency)
+ * - Proper money input rendering in forms
+ * - Bigint precision for all monetary values
+ */
+export const PriceTierSchema = z.object({
+    /** Upper bound for this tier (null = infinity, i.e. the last tier) */
+    upTo: z.number().nullable(),
+    /** Per-unit price for this tier */
+    unitPrice: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT], minAmount: 0n }),
+    /** Flat price added to this tier (on top of unit pricing) */
+    flatPrice: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT], minAmount: 0n }),
+});
+// ── Price ──────────────────────────────────────────────────────────
+export const PriceSchema = z.object({
+    _id: z.string().min(1).isPrimaryKey().isSummaryField(),
+    /** Reference to the parent product */
+    productId: z.string().min(1).isForeignKey().isDBIndexed(),
+    /** Pricing model (flat, per_unit, tiered, graduated, package) */
+    model: z.enum(PricingModel).isSummaryField().systemEnum('PricingModel'),
+    /**
+     * Unit price for FLAT/PER_UNIT models.
+     * Uses z_money for bigint precision, self-contained currency, and proper form rendering.
+     * Undefined for TIERED/GRADUATED models (use `tiers` instead).
+     */
+    unitPrice: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT], minAmount: 0n }).isSummaryField(),
+    /** Billing interval (undefined for one-time prices) */
+    interval: z.enum(BillingInterval).optional().isSummaryField(),
+    /** Interval count (e.g., 3 for quarterly = interval:'month', intervalCount:3) */
+    intervalCount: z.number().min(1).default(1),
+    /** Tiers for TIERED/GRADUATED pricing models */
+    tiers: z.array(PriceTierSchema).optional(),
+    /** Package size for PACKAGE pricing model (price per N units) */
+    packageSize: z.number().min(1).optional(),
+    /** Usage aggregation type for metered prices */
+    usageAggregation: z.enum(UsageAggregationType).optional(),
+    /**
+     * Tax behavior for this price (maps to Stripe's price.tax_behavior).
+     * Resolved from: price-level override > product.taxDisplayMode > BillingConfiguration.tax.defaultDisplayMode.
+     * - 'exclusive': amount is HT, tax added on top
+     * - 'inclusive': amount is TTC, tax embedded
+     * When absent: inherits from product, then from global config.
+     */
+    taxBehavior: z.enum(TaxDisplayMode).optional(),
+    /** Provider sync (lazy: populated on first use, not at startup) */
+    providerPriceId: z.string().optional().isBackendOnly(),
+    /** Whether this is the default price for the product (shown first in UI) */
+    isDefault: z.boolean().default(true),
+    /** Whether this price is available for purchase */
+    isActive: z.boolean().default(true).isDBIndexed(),
+    createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
+});
+//# sourceMappingURL=price.shared.schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"price.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/price.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,cAAc,GACf,MAAM,gCAAgC,CAAC;AAExC,sEAAsE;AAEtE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,sEAAsE;IACtE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAChF,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;CACjF,CAAC,CAAC;AAGH,sEAAsE;AAEtE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,cAAc,EAAE;IACtD,sCAAsC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,WAAW,EAAE;IAEzD,iEAAiE;IACjE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,cAAc,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC;IACvE;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,cAAc,EAAE;IAEjG,uDAAuD;IACvD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE,CAAC,cAAc,EAAE;IAC7D,iFAAiF;IACjF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAE3C,gDAAgD;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC1C,iEAAiE;IACjE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,gDAAgD;IAChD,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;IAEzD;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IAE9C,mEAAmE;IACnE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,aAAa,EAAE;IACtD,4EAA4E;IAC5E,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACpC,mDAAmD;IACnD,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;IAEjD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,iBAAiB,EAAE,CAAC,iBAAiB,EAAE;CACtF,CAAC,CAAC"}

package/dist/esm/billing/product-behavior-policy.shared.schemas.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Product Behavior Policy & Limit Grant Schemas (Shared)
+ *
+ * Declarative configuration for how the billing provider and the engine
+ * should handle product lifecycle (trial, proration, cancellation, metering).
+ *
+ * Also defines the LimitGrant schema that controls how product limits compose.
+ *
+ * @see billing-and-features-system.md §6.1 (LimitGrant), §6.1 (ProductBehaviorPolicy)
+ */
+import { z } from 'zod';
+import { LimitGrantMode, ProrationBehavior, BillingTiming, MeteringAggregationWindow } from './billing-enums.shared.schemas.js';
+/**
+ * A limit grant from a product.
+ *
+ * - SET mode: absolute value (replaces, used for PLAN base limits).
+ *   Example: "Professional plan gives you 50 projects."
+ * - ADD mode: additive (stacks on top, used for ADDON bonus limits).
+ *   Example: "+10 extra projects."
+ *
+ * Aggregation algorithm in BillingFeatureSyncBackendService:
+ *   1. Start with active PLAN's SET limits (only one active plan per billing account)
+ *   2. For each active ADDON with ADD mode: sum onto current limit
+ *   3. For each active ADDON with SET mode: take max(current, addon value)
+ *   4. FEATURES_UNLIMITED always wins in any comparison
+ */
+export declare const LimitGrantSchema: z.ZodObject<{
+    value: z.ZodNumber;
+    mode: z.ZodDefault<z.ZodEnum<typeof LimitGrantMode>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type LimitGrant = z.infer<typeof LimitGrantSchema>;
+/**
+ * Declarative configuration for how the billing provider and the engine
+ * should handle this product's lifecycle.
+ *
+ * This is the "billing policy" layer — NOT reimplementing provider logic,
+ * but CONFIGURING the parameters that get passed to the provider's API.
+ */
+export declare const ProductBehaviorPolicySchema: z.ZodObject<{
+    trial: z.ZodOptional<z.ZodObject<{
+        days: z.ZodDefault<z.ZodNumber>;
+        requirePaymentMethod: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    upgrade: z.ZodOptional<z.ZodObject<{
+        proration: z.ZodDefault<z.ZodEnum<typeof ProrationBehavior>>;
+        timing: z.ZodDefault<z.ZodEnum<typeof BillingTiming>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    downgrade: z.ZodOptional<z.ZodObject<{
+        proration: z.ZodDefault<z.ZodEnum<typeof ProrationBehavior>>;
+        timing: z.ZodDefault<z.ZodEnum<typeof BillingTiming>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    cancellation: z.ZodOptional<z.ZodObject<{
+        allowImmediate: z.ZodDefault<z.ZodBoolean>;
+        defaultBehavior: z.ZodDefault<z.ZodEnum<typeof BillingTiming>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    metering: z.ZodOptional<z.ZodObject<{
+        flushIntervalMinutes: z.ZodDefault<z.ZodNumber>;
+        aggregationWindow: z.ZodDefault<z.ZodEnum<typeof MeteringAggregationWindow>>;
+        preFlushAggregation: z.ZodDefault<z.ZodBoolean>;
+        retryPolicy: z.ZodDefault<z.ZodObject<{
+            maxRetries: z.ZodDefault<z.ZodNumber>;
+            backoffMultiplier: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type ProductBehaviorPolicy = z.infer<typeof ProductBehaviorPolicySchema>;
+//# sourceMappingURL=product-behavior-policy.shared.schemas.d.ts.map

package/dist/esm/billing/product-behavior-policy.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-behavior-policy.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/product-behavior-policy.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AAIxC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB;;;uCAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;uCA6CtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/esm/billing/product-behavior-policy.shared.schemas.js

@@ -0,0 +1,84 @@
+/**
+ * Product Behavior Policy & Limit Grant Schemas (Shared)
+ *
+ * Declarative configuration for how the billing provider and the engine
+ * should handle product lifecycle (trial, proration, cancellation, metering).
+ *
+ * Also defines the LimitGrant schema that controls how product limits compose.
+ *
+ * @see billing-and-features-system.md §6.1 (LimitGrant), §6.1 (ProductBehaviorPolicy)
+ */
+import { z } from 'zod';
+import { LimitGrantMode, ProrationBehavior, BillingTiming, MeteringAggregationWindow, } from './billing-enums.shared.schemas.js';
+// ── Limit Grant ────────────────────────────────────────────────────
+/**
+ * A limit grant from a product.
+ *
+ * - SET mode: absolute value (replaces, used for PLAN base limits).
+ *   Example: "Professional plan gives you 50 projects."
+ * - ADD mode: additive (stacks on top, used for ADDON bonus limits).
+ *   Example: "+10 extra projects."
+ *
+ * Aggregation algorithm in BillingFeatureSyncBackendService:
+ *   1. Start with active PLAN's SET limits (only one active plan per billing account)
+ *   2. For each active ADDON with ADD mode: sum onto current limit
+ *   3. For each active ADDON with SET mode: take max(current, addon value)
+ *   4. FEATURES_UNLIMITED always wins in any comparison
+ */
+export const LimitGrantSchema = z.object({
+    /** The limit value (count or -1 for FEATURES_UNLIMITED) */
+    value: z.number(),
+    /** How this grant composes with others */
+    mode: z.enum(LimitGrantMode).default(LimitGrantMode.SET),
+});
+// ── Product Behavior Policy ────────────────────────────────────────
+/**
+ * Declarative configuration for how the billing provider and the engine
+ * should handle this product's lifecycle.
+ *
+ * This is the "billing policy" layer — NOT reimplementing provider logic,
+ * but CONFIGURING the parameters that get passed to the provider's API.
+ */
+export const ProductBehaviorPolicySchema = z.object({
+    /** Trial configuration (overrides global BillingConfiguration.defaultTrialDays) */
+    trial: z.object({
+        /** Number of trial days (0 = no trial) */
+        days: z.number().min(0).default(0),
+        /** Whether to require a payment method before trial starts */
+        requirePaymentMethod: z.boolean().default(false),
+    }).optional(),
+    /** Upgrade behavior (when switching TO this plan from a lower tier) */
+    upgrade: z.object({
+        /** Proration passed to provider: create_prorations, none, always_invoice */
+        proration: z.enum(ProrationBehavior).default(ProrationBehavior.CREATE_PRORATIONS),
+        /** Apply immediately or at end of current period */
+        timing: z.enum(BillingTiming).default(BillingTiming.IMMEDIATE),
+    }).optional(),
+    /** Downgrade behavior (when switching FROM this plan to a lower tier) */
+    downgrade: z.object({
+        proration: z.enum(ProrationBehavior).default(ProrationBehavior.NONE),
+        timing: z.enum(BillingTiming).default(BillingTiming.AT_PERIOD_END),
+    }).optional(),
+    /** Cancellation behavior for subscriptions on this product */
+    cancellation: z.object({
+        /** Allow immediate cancellation (vs only at period end) */
+        allowImmediate: z.boolean().default(false),
+        /** Default cancellation timing when user cancels */
+        defaultBehavior: z.enum(BillingTiming).default(BillingTiming.AT_PERIOD_END),
+    }).optional(),
+    /** Metering policy (for METERED products only) */
+    metering: z.object({
+        /** How often to flush aggregated usage to billing provider (minutes) */
+        flushIntervalMinutes: z.number().min(1).default(60),
+        /** Aggregation window for usage records before flush */
+        aggregationWindow: z.enum(MeteringAggregationWindow).default(MeteringAggregationWindow.PER_FLUSH),
+        /** Aggregate locally before sending (sum up same-key records) */
+        preFlushAggregation: z.boolean().default(true),
+        /** Retry policy when provider flush fails */
+        retryPolicy: z.object({
+            maxRetries: z.number().default(3),
+            backoffMultiplier: z.number().default(2),
+        }).default({ maxRetries: 3, backoffMultiplier: 2 }),
+    }).optional(),
+});
+//# sourceMappingURL=product-behavior-policy.shared.schemas.js.map

package/dist/esm/billing/product-behavior-policy.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-behavior-policy.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/product-behavior-policy.shared.schemas.ts"],"names":[],"mappings":"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"}