@wildo-ai/saas-models 1.0.1 → 1.1.0

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

@@ -3,10 +3,10 @@
  *
  * 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<{
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions';
+import { ResourceRelationship } from '../resources/resources.shared.schemas';
+type PricesCoreOps = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE | CoreResourceOperation.DELETE;
+export declare const pricesResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("..").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>>>;
@@ -17,14 +17,14 @@ export declare const pricesResourceConfiguration_InitializationFactory: (resourc
         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>>>;
+    }, import("zod/v4/core").$strip>>>;
     packageSize: import("zod").ZodOptional<import("zod").ZodNumber>;
-    usageAggregation: import("zod").ZodOptional<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").UsageAggregationType>>;
+    usageAggregation: import("zod").ZodOptional<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas").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>>;
+}, import("zod/v4/core").$strip>>;
 export {};
 //# sourceMappingURL=price.shared.resources-config.schemas.d.ts.map

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

@@ -1 +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"}
+{"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,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,iDAAiD,GAC5D,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;iCAsE9C,CAAC"}

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

@@ -19,11 +19,16 @@ export const pricesResourceConfiguration_InitializationFactory = (resourcesRelat
         CoreResourceOperation.LIST,
         CoreResourceOperation.CREATE,
         CoreResourceOperation.UPDATE,
+        // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition
+        // onParentDelete cascade so price rows are physically removed when their
+        // owning product is deleted. Without it the cascade throws
+        // ErrorType.CONFIGURATION on any product that still has price rows.
+        CoreResourceOperation.DELETE,
     ],
     operationsConfiguration: {
         [CoreResourceOperation.READ]: {
             variants: [{
-                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    variantType: ResourceOperationVariantType.INTERNAL_CALL,
                     isDefault: true,
                     roles: [CORE_APP_ROLES.APP_USER],
                     riskLevel: ResourceOperationRiskLevel.LOW,
@@ -31,7 +36,7 @@ export const pricesResourceConfiguration_InitializationFactory = (resourcesRelat
         },
         [CoreResourceOperation.LIST]: {
             variants: [{
-                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    variantType: ResourceOperationVariantType.INTERNAL_CALL,
                     isDefault: true,
                     roles: [CORE_APP_ROLES.APP_USER],
                     riskLevel: ResourceOperationRiskLevel.LOW,
@@ -39,7 +44,7 @@ export const pricesResourceConfiguration_InitializationFactory = (resourcesRelat
         },
         [CoreResourceOperation.CREATE]: {
             variants: [{
-                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    variantType: ResourceOperationVariantType.INTERNAL_CALL,
                     isDefault: true,
                     roles: [CORE_ORG_ROLES.ORG_OWNER],
                     riskLevel: ResourceOperationRiskLevel.MEDIUM,
@@ -47,12 +52,25 @@ export const pricesResourceConfiguration_InitializationFactory = (resourcesRelat
         },
         [CoreResourceOperation.UPDATE]: {
             variants: [{
-                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    variantType: ResourceOperationVariantType.INTERNAL_CALL,
                     isDefault: true,
                     roles: [CORE_ORG_ROLES.ORG_OWNER],
                     riskLevel: ResourceOperationRiskLevel.MEDIUM,
                 }],
         },
+        // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition
+        // onParentDelete cascade so price rows are physically removed when their owning
+        // product is deleted. Without a DELETE op the cascade (deleteChildrenImmediate)
+        // throws ErrorType.CONFIGURATION on any product that still has price rows.
+        // ORG_OWNER/HIGH: mirrors the price write tier (billing catalog is org-owned).
+        [CoreResourceOperation.DELETE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.HIGH,
+                }],
+        },
     },
 });
-//# sourceMappingURL=price.shared.resources-config.schemas.js.map
+//# sourceMappingURL=price.shared.resources-config.schemas.js.map

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

@@ -1 +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"}
+{"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;AASrD,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;QAC5B,oEAAoE;QACpE,yEAAyE;QACzE,2DAA2D;QAC3D,oEAAoE;QACpE,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,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,aAAa;oBACvD,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,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;QAED,yEAAyE;QACzE,gFAAgF;QAChF,gFAAgF;QAChF,2EAA2E;QAC3E,+EAA+E;QAC/E,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,IAAI;iBAC3C,CAAC;SACH;KACF;CACF,CAAC,CAAC","sourcesContent":["/**\n * Price Resource Configuration\n *\n * Admin-managed: APPLICATION-scoped, linked to products.\n */\n\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 { PriceSchema } from './price.shared.schemas';\n\ntype PricesCoreOps =\n  | CoreResourceOperation.READ\n  | CoreResourceOperation.LIST\n  | CoreResourceOperation.CREATE\n  | CoreResourceOperation.UPDATE\n  | CoreResourceOperation.DELETE;\n\nexport const pricesResourceConfiguration_InitializationFactory = (\n  resourcesRelationships: ResourceRelationship[]\n) => createResourceConfiguration_Initialization<\n  undefined,\n  PricesCoreOps,\n  typeof PriceSchema\n>({\n  mainSchema: PriceSchema,\n  resourceIdentifier: CoreResourceType.PRICES,\n  resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.PRICES],\n  resourceRelationships: resourcesRelationships,\n  isSystemResource: true,\n  coreOperations: [\n    CoreResourceOperation.READ,\n    CoreResourceOperation.LIST,\n    CoreResourceOperation.CREATE,\n    CoreResourceOperation.UPDATE,\n    // DELETE is REPOSITORY_ONLY (no HTTP route): powers the composition\n    // onParentDelete cascade so price rows are physically removed when their\n    // owning product is deleted. Without it the cascade throws\n    // ErrorType.CONFIGURATION on any product that still has price rows.\n    CoreResourceOperation.DELETE,\n  ],\n  operationsConfiguration: {\n    [CoreResourceOperation.READ]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_APP_ROLES.APP_USER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\n      }],\n    },\n    [CoreResourceOperation.LIST]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.INTERNAL_CALL,\n        isDefault: true,\n        roles: [CORE_APP_ROLES.APP_USER],\n        riskLevel: ResourceOperationRiskLevel.LOW,\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\n    // Internal-only (REPOSITORY_ONLY, no HTTP route): powers the composition\n    // onParentDelete cascade so price rows are physically removed when their owning\n    // product is deleted. Without a DELETE op the cascade (deleteChildrenImmediate)\n    // throws ErrorType.CONFIGURATION on any product that still has price rows.\n    // ORG_OWNER/HIGH: mirrors the price write tier (billing catalog is org-owned).\n    [CoreResourceOperation.DELETE]: {\n      variants: [{\n        variantType: ResourceOperationVariantType.REPOSITORY_ONLY,\n        isDefault: true,\n        roles: [CORE_ORG_ROLES.ORG_OWNER],\n        riskLevel: ResourceOperationRiskLevel.HIGH,\n      }],\n    },\n  },\n});\n"]}

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

@@ -10,7 +10,7 @@
  * @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';
+import { PricingModel, BillingInterval, UsageAggregationType, TaxDisplayMode } from './billing-enums.shared.schemas';
 /**
  * A single tier in a tiered/graduated pricing model.
  * `upTo: null` means "infinity" (the final open-ended tier).
@@ -24,7 +24,7 @@ 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>;
+}, z.core.$strip>;
 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>>;
@@ -37,7 +37,7 @@ export declare const PriceSchema: 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>>>;
+    }, z.core.$strip>>>;
     packageSize: z.ZodOptional<z.ZodNumber>;
     usageAggregation: z.ZodOptional<z.ZodEnum<typeof UsageAggregationType>>;
     taxBehavior: z.ZodOptional<z.ZodEnum<typeof TaxDisplayMode>>;
@@ -45,6 +45,6 @@ export declare const PriceSchema: z.ZodObject<{
     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>;
+}, z.core.$strip>;
 export type Price = z.infer<typeof PriceSchema>;
 //# sourceMappingURL=price.shared.schemas.d.ts.map

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

@@ -1 +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"}
+{"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;;;;iBAO1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;iBA4CtB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

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

@@ -69,4 +69,4 @@ export const PriceSchema = z.object({
     isActive: z.boolean().default(true).isDBIndexed(),
     createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
 });
-//# sourceMappingURL=price.shared.schemas.js.map
+//# sourceMappingURL=price.shared.schemas.js.map

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

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

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

@@ -9,7 +9,7 @@
  * @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';
+import { LimitGrantMode, ProrationBehavior, BillingTiming, MeteringAggregationWindow } from './billing-enums.shared.schemas';
 /**
  * A limit grant from a product.
  *
@@ -27,7 +27,7 @@ import { LimitGrantMode, ProrationBehavior, BillingTiming, MeteringAggregationWi
 export declare const LimitGrantSchema: z.ZodObject<{
     value: z.ZodNumber;
     mode: z.ZodDefault<z.ZodEnum<typeof LimitGrantMode>>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type LimitGrant = z.infer<typeof LimitGrantSchema>;
 /**
  * Declarative configuration for how the billing provider and the engine
@@ -40,19 +40,19 @@ 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>>;
+    }, z.core.$strip>>;
     upgrade: z.ZodOptional<z.ZodObject<{
         proration: z.ZodDefault<z.ZodEnum<typeof ProrationBehavior>>;
         timing: z.ZodDefault<z.ZodEnum<typeof BillingTiming>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     downgrade: z.ZodOptional<z.ZodObject<{
         proration: z.ZodDefault<z.ZodEnum<typeof ProrationBehavior>>;
         timing: z.ZodDefault<z.ZodEnum<typeof BillingTiming>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     cancellation: z.ZodOptional<z.ZodObject<{
         allowImmediate: z.ZodDefault<z.ZodBoolean>;
         defaultBehavior: z.ZodDefault<z.ZodEnum<typeof BillingTiming>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     metering: z.ZodOptional<z.ZodObject<{
         flushIntervalMinutes: z.ZodDefault<z.ZodNumber>;
         aggregationWindow: z.ZodDefault<z.ZodEnum<typeof MeteringAggregationWindow>>;
@@ -60,8 +60,8 @@ export declare const ProductBehaviorPolicySchema: z.ZodObject<{
         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>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 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

@@ -1 +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"}
+{"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;;;iBAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqDtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

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

@@ -66,7 +66,15 @@ export const ProductBehaviorPolicySchema = z.object({
         /** Default cancellation timing when user cancels */
         defaultBehavior: z.enum(BillingTiming).default(BillingTiming.AT_PERIOD_END),
     }).optional(),
-    /** Metering policy (for METERED products only) */
+    /**
+     * Authored metering policy (for METERED products only).
+     *
+     * The current `UsageMeteringBackendService` does not yet consume these
+     * scheduling, aggregation-window or retry values: it groups every pending row
+     * by billing account and product whenever the externally scheduled flush runs.
+     * Keep this distinction visible so configuration documentation does not turn
+     * an accepted policy shape into a false runtime guarantee.
+     */
     metering: z.object({
         /** How often to flush aggregated usage to billing provider (minutes) */
         flushIntervalMinutes: z.number().min(1).default(60),
@@ -81,4 +89,4 @@ export const ProductBehaviorPolicySchema = z.object({
         }).default({ maxRetries: 3, backoffMultiplier: 2 }),
     }).optional(),
 });
-//# sourceMappingURL=product-behavior-policy.shared.schemas.js.map
+//# sourceMappingURL=product-behavior-policy.shared.schemas.js.map

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

@@ -1 +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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"}
+{"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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","sourcesContent":["/**\n * Product Behavior Policy & Limit Grant Schemas (Shared)\n *\n * Declarative configuration for how the billing provider and the engine\n * should handle product lifecycle (trial, proration, cancellation, metering).\n *\n * Also defines the LimitGrant schema that controls how product limits compose.\n *\n * @see billing-and-features-system.md §6.1 (LimitGrant), §6.1 (ProductBehaviorPolicy)\n */\n\nimport { z } from 'zod';\nimport {\n  LimitGrantMode,\n  ProrationBehavior,\n  BillingTiming,\n  MeteringAggregationWindow,\n} from './billing-enums.shared.schemas';\n\n// ── Limit Grant ────────────────────────────────────────────────────\n\n/**\n * A limit grant from a product.\n *\n * - SET mode: absolute value (replaces, used for PLAN base limits).\n *   Example: \"Professional plan gives you 50 projects.\"\n * - ADD mode: additive (stacks on top, used for ADDON bonus limits).\n *   Example: \"+10 extra projects.\"\n *\n * Aggregation algorithm in BillingFeatureSyncBackendService:\n *   1. Start with active PLAN's SET limits (only one active plan per billing account)\n *   2. For each active ADDON with ADD mode: sum onto current limit\n *   3. For each active ADDON with SET mode: take max(current, addon value)\n *   4. FEATURES_UNLIMITED always wins in any comparison\n */\nexport const LimitGrantSchema = z.object({\n  /** The limit value (count or -1 for FEATURES_UNLIMITED) */\n  value: z.number(),\n  /** How this grant composes with others */\n  mode: z.enum(LimitGrantMode).default(LimitGrantMode.SET),\n});\nexport type LimitGrant = z.infer<typeof LimitGrantSchema>;\n\n// ── Product Behavior Policy ────────────────────────────────────────\n\n/**\n * Declarative configuration for how the billing provider and the engine\n * should handle this product's lifecycle.\n *\n * This is the \"billing policy\" layer — NOT reimplementing provider logic,\n * but CONFIGURING the parameters that get passed to the provider's API.\n */\nexport const ProductBehaviorPolicySchema = z.object({\n  /** Trial configuration (overrides global BillingConfiguration.defaultTrialDays) */\n  trial: z.object({\n    /** Number of trial days (0 = no trial) */\n    days: z.number().min(0).default(0),\n    /** Whether to require a payment method before trial starts */\n    requirePaymentMethod: z.boolean().default(false),\n  }).optional(),\n\n  /** Upgrade behavior (when switching TO this plan from a lower tier) */\n  upgrade: z.object({\n    /** Proration passed to provider: create_prorations, none, always_invoice */\n    proration: z.enum(ProrationBehavior).default(ProrationBehavior.CREATE_PRORATIONS),\n    /** Apply immediately or at end of current period */\n    timing: z.enum(BillingTiming).default(BillingTiming.IMMEDIATE),\n  }).optional(),\n\n  /** Downgrade behavior (when switching FROM this plan to a lower tier) */\n  downgrade: z.object({\n    proration: z.enum(ProrationBehavior).default(ProrationBehavior.NONE),\n    timing: z.enum(BillingTiming).default(BillingTiming.AT_PERIOD_END),\n  }).optional(),\n\n  /** Cancellation behavior for subscriptions on this product */\n  cancellation: z.object({\n    /** Allow immediate cancellation (vs only at period end) */\n    allowImmediate: z.boolean().default(false),\n    /** Default cancellation timing when user cancels */\n    defaultBehavior: z.enum(BillingTiming).default(BillingTiming.AT_PERIOD_END),\n  }).optional(),\n\n  /**\n   * Authored metering policy (for METERED products only).\n   *\n   * The current `UsageMeteringBackendService` does not yet consume these\n   * scheduling, aggregation-window or retry values: it groups every pending row\n   * by billing account and product whenever the externally scheduled flush runs.\n   * Keep this distinction visible so configuration documentation does not turn\n   * an accepted policy shape into a false runtime guarantee.\n   */\n  metering: z.object({\n    /** How often to flush aggregated usage to billing provider (minutes) */\n    flushIntervalMinutes: z.number().min(1).default(60),\n    /** Aggregation window for usage records before flush */\n    aggregationWindow: z.enum(MeteringAggregationWindow).default(MeteringAggregationWindow.PER_FLUSH),\n    /** Aggregate locally before sending (sum up same-key records) */\n    preFlushAggregation: z.boolean().default(true),\n    /** Retry policy when provider flush fails */\n    retryPolicy: z.object({\n      maxRetries: z.number().default(3),\n      backoffMultiplier: z.number().default(2),\n    }).default({ maxRetries: 3, backoffMultiplier: 2 }),\n  }).optional(),\n});\nexport type ProductBehaviorPolicy = z.infer<typeof ProductBehaviorPolicySchema>;\n"]}

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

@@ -18,8 +18,8 @@
  * @see billing-and-features-system.md §6.2b (Product Definition)
  */
 import { z } from 'zod';
-import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
-import { ProductType, PricingModel, BillingInterval, UsageAggregationType, TaxDisplayMode } from './billing-enums.shared.schemas.js';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas';
+import { ProductType, PricingModel, BillingInterval, UsageAggregationType, TaxDisplayMode } from './billing-enums.shared.schemas';
 /**
  * Inline price definition for product catalog configuration.
  * Maps to a separate Price DB record when synced.
@@ -33,12 +33,12 @@ export declare const PriceDefinitionSchema: 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>>>;
+    }, z.core.$strip>>>;
     packageSize: z.ZodOptional<z.ZodNumber>;
     usageAggregation: z.ZodOptional<z.ZodEnum<typeof UsageAggregationType>>;
     taxBehavior: z.ZodOptional<z.ZodEnum<typeof TaxDisplayMode>>;
     isDefault: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+}, z.core.$strip>;
 export type PriceDefinition = z.infer<typeof PriceDefinitionSchema>;
 /**
  * ProductDefinition: what custom app developers write in their product catalog config.
@@ -48,11 +48,11 @@ export declare const ProductDefinitionSchema: z.ZodObject<{
     key: z.ZodString;
     type: z.ZodEnum<typeof ProductType>;
     targetScopes: z.ZodArray<z.ZodEnum<typeof ResourcePrimaryScope>>;
-    grantedFeatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    grantedLimits: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    grantedFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    grantedLimits: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         value: z.ZodNumber;
-        mode: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").LimitGrantMode>>;
-    }, z.core.$strip, core.$ZodObjectExtra>>>;
+        mode: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").LimitGrantMode>>;
+    }, z.core.$strip>>>;
     prices: z.ZodArray<z.ZodObject<{
         model: z.ZodEnum<typeof PricingModel>;
         unitPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
@@ -62,39 +62,39 @@ export declare const ProductDefinitionSchema: 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>>>;
+        }, z.core.$strip>>>;
         packageSize: z.ZodOptional<z.ZodNumber>;
         usageAggregation: z.ZodOptional<z.ZodEnum<typeof UsageAggregationType>>;
         taxBehavior: z.ZodOptional<z.ZodEnum<typeof TaxDisplayMode>>;
         isDefault: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip>>;
     behaviorPolicy: z.ZodOptional<z.ZodObject<{
         trial: z.ZodOptional<z.ZodObject<{
             days: z.ZodDefault<z.ZodNumber>;
             requirePaymentMethod: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip>>;
         upgrade: z.ZodOptional<z.ZodObject<{
-            proration: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").ProrationBehavior>>;
-            timing: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").BillingTiming>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
+            proration: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").ProrationBehavior>>;
+            timing: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").BillingTiming>>;
+        }, z.core.$strip>>;
         downgrade: z.ZodOptional<z.ZodObject<{
-            proration: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").ProrationBehavior>>;
-            timing: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").BillingTiming>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
+            proration: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").ProrationBehavior>>;
+            timing: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").BillingTiming>>;
+        }, z.core.$strip>>;
         cancellation: z.ZodOptional<z.ZodObject<{
             allowImmediate: z.ZodDefault<z.ZodBoolean>;
-            defaultBehavior: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").BillingTiming>>;
-        }, z.core.$strip, core.$ZodObjectExtra>>;
+            defaultBehavior: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").BillingTiming>>;
+        }, z.core.$strip>>;
         metering: z.ZodOptional<z.ZodObject<{
             flushIntervalMinutes: z.ZodDefault<z.ZodNumber>;
-            aggregationWindow: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").MeteringAggregationWindow>>;
+            aggregationWindow: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas").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>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     planTier: z.ZodOptional<z.ZodString>;
     planTierOrder: z.ZodOptional<z.ZodNumber>;
     requiredPlanTiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -103,9 +103,9 @@ export declare const ProductDefinitionSchema: z.ZodObject<{
         maxQuantityPerPurchase: z.ZodOptional<z.ZodNumber>;
         creditsPerUnit: z.ZodOptional<z.ZodNumber>;
         creditPoolKey: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip, core.$ZodObjectExtra>>;
-    sortOrder: z.ZodDefault<z.ZodNumber>;
-    isPublic: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip, core.$ZodObjectExtra>;
+    }, z.core.$strip>>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+    isPublic: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
 export type ProductDefinition = z.infer<typeof ProductDefinitionSchema>;
 //# sourceMappingURL=product-definition.shared.schemas.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"product-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/product-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,cAAc,EACf,MAAM,gCAAgC,CAAC;AAMxC;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;uCAuBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA6ClC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"product-definition.shared.schemas.d.ts","sourceRoot":"","sources":["../../../../src/billing/product-definition.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,cAAc,EACf,MAAM,gCAAgC,CAAC;AAMxC;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAuBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2ElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/esm/billing/product-definition.shared.schemas.js

@@ -63,10 +63,16 @@ export const ProductDefinitionSchema = z.object({
     type: z.enum(ProductType),
     /** Which scopes can subscribe/purchase this product */
     targetScopes: z.array(z.enum(ResourcePrimaryScope)).min(1),
-    /** Features this product grants (boolean features: present = enabled) */
-    grantedFeatures: z.array(z.string()).default([]),
-    /** Limits this product grants, with mode (SET for plans, ADD for addons) */
-    grantedLimits: z.record(z.string(), LimitGrantSchema).default({}),
+    /**
+     * Features this product grants (boolean features: present = enabled).
+     * Optional — omit to grant none. See the defaults note on `isPublic`.
+     */
+    grantedFeatures: z.array(z.string()).optional(),
+    /**
+     * Limits this product grants, with mode (SET for plans, ADD for addons).
+     * Optional — omit to grant none. See the defaults note on `isPublic`.
+     */
+    grantedLimits: z.record(z.string(), LimitGrantSchema).optional(),
     /** Inline price definitions (transformed into separate Price records on sync) */
     prices: z.array(PriceDefinitionSchema).min(1),
     /** Behavior policy (trial, proration, cancellation, metering) */
@@ -89,9 +95,33 @@ export const ProductDefinitionSchema = z.object({
         creditsPerUnit: z.number().min(1).optional(),
         creditPoolKey: z.string().optional(),
     }).optional(),
-    /** Sort order in pricing tables */
-    sortOrder: z.number().default(0),
-    /** Show in public pricing pages */
-    isPublic: z.boolean().default(true),
+    /**
+     * Sort order in pricing tables. Optional — see the defaults note on `isPublic`.
+     */
+    sortOrder: z.number().optional(),
+    /**
+     * Show in public pricing pages. Optional — omitting it yields a PUBLIC product,
+     * because the persisted resource defaults it to `true`.
+     *
+     * WHY `.optional()` AND NOT `.default(...)`
+     * This schema is a declarative authoring surface: an application hand-writes
+     * `const PLAN: ProductDefinition = { ... }` and nothing ever calls
+     * `ProductDefinitionSchema.parse()` on it. A `.default(...)` here would be dead
+     * code that never runs, while `z.infer` would still type the field as REQUIRED —
+     * so every app author was forced to hand-write `isPublic: true`, `grantedLimits: {}`
+     * and friends purely to satisfy the compiler.
+     *
+     * The real defaults live one layer down, on the PERSISTED `Product` resource
+     * (`product.shared.schemas.ts`), which mirrors all four of these fields with
+     * identical default values and IS parsed on write. `ProductCatalogSyncBackendService`
+     * maps this definition into a `Partial<Product>`, so an omitted field arrives as
+     * `undefined` and the resource default materializes it — `grantedFeatures: []`,
+     * `grantedLimits: {}`, `sortOrder: 0`, `isPublic: true`.
+     *
+     * Do NOT "restore" `.default(...)` here to make the type look tidier: that would
+     * re-assert a guarantee nothing enforces at this layer. Any consumer reading these
+     * straight off a `ProductDefinition` must apply the same fallback the resource does.
+     */
+    isPublic: z.boolean().optional(),
 });
-//# sourceMappingURL=product-definition.shared.schemas.js.map
+//# sourceMappingURL=product-definition.shared.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"product-definition.shared.schemas.js","sourceRoot":"","sources":["../../../src/billing/product-definition.shared.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"product-definition.shared.schemas.js","sourceRoot":"","sources":["../../../../src/billing/product-definition.shared.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Product Definition Schema (Shared)\n *\n * The bridge between what developers write in the product catalog config\n * and the DB-level Product + Price schemas.\n *\n * Unlike ProductSchema (the DB record), ProductDefinition:\n * - Has prices INLINE (not separate records)\n * - Has no _id, providerProductId, or DB timestamps\n * - Uses `key` as the unique identifier (maps to Product.key in DB)\n *\n * ProductCatalogSyncBackendService.ensureProductSynced(key):\n *   1. Look up ProductDefinition from catalog config by key\n *   2. Upsert Product DB record (key → _id mapping)\n *   3. Upsert Price DB records for each inline price\n *   4. On first provider use: sync to billing provider (fill providerProductId/providerPriceId)\n *\n * @see billing-and-features-system.md §6.2b (Product Definition)\n */\n\nimport { z } from 'zod';\nimport { z_money, CurrencyAllowed } from '@wildo-ai/zod-decorators';\nimport { ResourcePrimaryScope } from '../resources/resources.shared.schemas';\nimport {\n  ProductType,\n  PricingModel,\n  BillingInterval,\n  UsageAggregationType,\n  TaxDisplayMode,\n} from './billing-enums.shared.schemas';\nimport { LimitGrantSchema, ProductBehaviorPolicySchema } from './product-behavior-policy.shared.schemas';\nimport { PriceTierSchema } from './price.shared.schemas';\n\n// ── Price Definition (inline in product config) ────────────────────\n\n/**\n * Inline price definition for product catalog configuration.\n * Maps to a separate Price DB record when synced.\n */\nexport const PriceDefinitionSchema = z.object({\n  /** Pricing model (flat, per_unit, tiered, graduated, package) */\n  model: z.enum(PricingModel),\n  /**\n   * Unit price for FLAT/PER_UNIT models.\n   * Uses z_money for consistent monetary representation across the billing system.\n   * Undefined for TIERED/GRADUATED models (use `tiers` instead).\n   */\n  unitPrice: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT], minAmount: 0n }),\n  /** Billing interval (undefined = one-time) */\n  interval: z.enum(BillingInterval).optional(),\n  /** Interval count (e.g., 3 for quarterly = interval:'month', intervalCount:3) */\n  intervalCount: z.number().min(1).default(1),\n  /** Tiers for TIERED/GRADUATED pricing models */\n  tiers: z.array(PriceTierSchema).optional(),\n  /** Package size for PACKAGE pricing model */\n  packageSize: z.number().min(1).optional(),\n  /** Usage aggregation for metered prices */\n  usageAggregation: z.enum(UsageAggregationType).optional(),\n  /** Per-price tax behavior override */\n  taxBehavior: z.enum(TaxDisplayMode).optional(),\n  /** Whether this is the default price */\n  isDefault: z.boolean().default(true),\n});\n\nexport type PriceDefinition = z.infer<typeof PriceDefinitionSchema>;\n\n// ── Product Definition (what developers write) ─────────────────────\n\n/**\n * ProductDefinition: what custom app developers write in their product catalog config.\n * This is the declarative product definition that lives in shared-lib code.\n */\nexport const ProductDefinitionSchema = z.object({\n  /** Unique product key (matches Product.key in DB) */\n  key: z.string().min(1),\n  type: z.enum(ProductType),\n\n  /** Which scopes can subscribe/purchase this product */\n  targetScopes: z.array(z.enum(ResourcePrimaryScope)).min(1),\n\n  /**\n   * Features this product grants (boolean features: present = enabled).\n   * Optional — omit to grant none. See the defaults note on `isPublic`.\n   */\n  grantedFeatures: z.array(z.string()).optional(),\n  /**\n   * Limits this product grants, with mode (SET for plans, ADD for addons).\n   * Optional — omit to grant none. See the defaults note on `isPublic`.\n   */\n  grantedLimits: z.record(z.string(), LimitGrantSchema).optional(),\n\n  /** Inline price definitions (transformed into separate Price records on sync) */\n  prices: z.array(PriceDefinitionSchema).min(1),\n\n  /** Behavior policy (trial, proration, cancellation, metering) */\n  behaviorPolicy: ProductBehaviorPolicySchema.optional(),\n\n  // ── PLAN-specific ──\n  /** Tier identifier for mutual exclusion (e.g., 'free', 'professional', 'enterprise') */\n  planTier: z.string().optional(),\n  /** Tier sort order (higher = higher tier, for upgrade/downgrade direction) */\n  planTierOrder: z.number().optional(),\n\n  // ── ADDON-specific ──\n  /** Required plan tiers to subscribe (empty/undefined = no restriction) */\n  requiredPlanTiers: z.array(z.string()).optional(),\n\n  // ── Tax ──\n  /** Per-product tax display override */\n  taxDisplayMode: z.enum(TaxDisplayMode).optional(),\n\n  // ── Non-subscription specific ──\n  /** Purchase config for ONE_TIME/CREDIT_PACK/ITEM products */\n  purchaseConfig: z.object({\n    maxQuantityPerPurchase: z.number().min(1).optional(),\n    creditsPerUnit: z.number().min(1).optional(),\n    creditPoolKey: z.string().optional(),\n  }).optional(),\n\n  /**\n   * Sort order in pricing tables. Optional — see the defaults note on `isPublic`.\n   */\n  sortOrder: z.number().optional(),\n  /**\n   * Show in public pricing pages. Optional — omitting it yields a PUBLIC product,\n   * because the persisted resource defaults it to `true`.\n   *\n   * WHY `.optional()` AND NOT `.default(...)`\n   * This schema is a declarative authoring surface: an application hand-writes\n   * `const PLAN: ProductDefinition = { ... }` and nothing ever calls\n   * `ProductDefinitionSchema.parse()` on it. A `.default(...)` here would be dead\n   * code that never runs, while `z.infer` would still type the field as REQUIRED —\n   * so every app author was forced to hand-write `isPublic: true`, `grantedLimits: {}`\n   * and friends purely to satisfy the compiler.\n   *\n   * The real defaults live one layer down, on the PERSISTED `Product` resource\n   * (`product.shared.schemas.ts`), which mirrors all four of these fields with\n   * identical default values and IS parsed on write. `ProductCatalogSyncBackendService`\n   * maps this definition into a `Partial<Product>`, so an omitted field arrives as\n   * `undefined` and the resource default materializes it — `grantedFeatures: []`,\n   * `grantedLimits: {}`, `sortOrder: 0`, `isPublic: true`.\n   *\n   * Do NOT \"restore\" `.default(...)` here to make the type look tidier: that would\n   * re-assert a guarantee nothing enforces at this layer. Any consumer reading these\n   * straight off a `ProductDefinition` must apply the same fallback the resource does.\n   */\n  isPublic: z.boolean().optional(),\n});\n\nexport type ProductDefinition = z.infer<typeof ProductDefinitionSchema>;\n"]}