@wildo-ai/saas-models 1.0.1

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

@@ -0,0 +1,111 @@
+/**
+ * Product Definition Schema (Shared)
+ *
+ * The bridge between what developers write in the product catalog config
+ * and the DB-level Product + Price schemas.
+ *
+ * Unlike ProductSchema (the DB record), ProductDefinition:
+ * - Has prices INLINE (not separate records)
+ * - Has no _id, providerProductId, or DB timestamps
+ * - Uses `key` as the unique identifier (maps to Product.key in DB)
+ *
+ * ProductCatalogSyncBackendService.ensureProductSynced(key):
+ *   1. Look up ProductDefinition from catalog config by key
+ *   2. Upsert Product DB record (key → _id mapping)
+ *   3. Upsert Price DB records for each inline price
+ *   4. On first provider use: sync to billing provider (fill providerProductId/providerPriceId)
+ *
+ * @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';
+/**
+ * Inline price definition for product catalog configuration.
+ * Maps to a separate Price DB record when synced.
+ */
+export declare const PriceDefinitionSchema: z.ZodObject<{
+    model: z.ZodEnum<typeof PricingModel>;
+    unitPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+    interval: 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>>;
+    isDefault: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type PriceDefinition = z.infer<typeof PriceDefinitionSchema>;
+/**
+ * ProductDefinition: what custom app developers write in their product catalog config.
+ * This is the declarative product definition that lives in shared-lib code.
+ */
+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<{
+        value: z.ZodNumber;
+        mode: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").LimitGrantMode>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    prices: z.ZodArray<z.ZodObject<{
+        model: z.ZodEnum<typeof PricingModel>;
+        unitPrice: import("@wildo-ai/zod-decorators").DecoratedMoneySchema;
+        interval: 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>>;
+        isDefault: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    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>>;
+        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>>;
+        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>>;
+        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>>;
+        metering: z.ZodOptional<z.ZodObject<{
+            flushIntervalMinutes: z.ZodDefault<z.ZodNumber>;
+            aggregationWindow: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").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>>;
+    planTier: z.ZodOptional<z.ZodString>;
+    planTierOrder: z.ZodOptional<z.ZodNumber>;
+    requiredPlanTiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    taxDisplayMode: z.ZodOptional<z.ZodEnum<typeof TaxDisplayMode>>;
+    purchaseConfig: z.ZodOptional<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>;
+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

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

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

@@ -0,0 +1,97 @@
+/**
+ * Product Definition Schema (Shared)
+ *
+ * The bridge between what developers write in the product catalog config
+ * and the DB-level Product + Price schemas.
+ *
+ * Unlike ProductSchema (the DB record), ProductDefinition:
+ * - Has prices INLINE (not separate records)
+ * - Has no _id, providerProductId, or DB timestamps
+ * - Uses `key` as the unique identifier (maps to Product.key in DB)
+ *
+ * ProductCatalogSyncBackendService.ensureProductSynced(key):
+ *   1. Look up ProductDefinition from catalog config by key
+ *   2. Upsert Product DB record (key → _id mapping)
+ *   3. Upsert Price DB records for each inline price
+ *   4. On first provider use: sync to billing provider (fill providerProductId/providerPriceId)
+ *
+ * @see billing-and-features-system.md §6.2b (Product Definition)
+ */
+import { z } from 'zod';
+import { z_money, CurrencyAllowed } from '@wildo-ai/zod-decorators';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { ProductType, PricingModel, BillingInterval, UsageAggregationType, TaxDisplayMode, } from './billing-enums.shared.schemas.js';
+import { LimitGrantSchema, ProductBehaviorPolicySchema } from './product-behavior-policy.shared.schemas.js';
+import { PriceTierSchema } from './price.shared.schemas.js';
+// ── Price Definition (inline in product config) ────────────────────
+/**
+ * Inline price definition for product catalog configuration.
+ * Maps to a separate Price DB record when synced.
+ */
+export const PriceDefinitionSchema = z.object({
+    /** Pricing model (flat, per_unit, tiered, graduated, package) */
+    model: z.enum(PricingModel),
+    /**
+     * Unit price for FLAT/PER_UNIT models.
+     * Uses z_money for consistent monetary representation across the billing system.
+     * Undefined for TIERED/GRADUATED models (use `tiers` instead).
+     */
+    unitPrice: z_money({ currenciesAllowed: [CurrencyAllowed.FIAT], minAmount: 0n }),
+    /** Billing interval (undefined = one-time) */
+    interval: z.enum(BillingInterval).optional(),
+    /** 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 */
+    packageSize: z.number().min(1).optional(),
+    /** Usage aggregation for metered prices */
+    usageAggregation: z.enum(UsageAggregationType).optional(),
+    /** Per-price tax behavior override */
+    taxBehavior: z.enum(TaxDisplayMode).optional(),
+    /** Whether this is the default price */
+    isDefault: z.boolean().default(true),
+});
+// ── Product Definition (what developers write) ─────────────────────
+/**
+ * ProductDefinition: what custom app developers write in their product catalog config.
+ * This is the declarative product definition that lives in shared-lib code.
+ */
+export const ProductDefinitionSchema = z.object({
+    /** Unique product key (matches Product.key in DB) */
+    key: z.string().min(1),
+    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({}),
+    /** Inline price definitions (transformed into separate Price records on sync) */
+    prices: z.array(PriceDefinitionSchema).min(1),
+    /** Behavior policy (trial, proration, cancellation, metering) */
+    behaviorPolicy: ProductBehaviorPolicySchema.optional(),
+    // ── PLAN-specific ──
+    /** Tier identifier for mutual exclusion (e.g., 'free', 'professional', 'enterprise') */
+    planTier: z.string().optional(),
+    /** Tier sort order (higher = higher tier, for upgrade/downgrade direction) */
+    planTierOrder: z.number().optional(),
+    // ── ADDON-specific ──
+    /** Required plan tiers to subscribe (empty/undefined = no restriction) */
+    requiredPlanTiers: z.array(z.string()).optional(),
+    // ── Tax ──
+    /** Per-product tax display override */
+    taxDisplayMode: z.enum(TaxDisplayMode).optional(),
+    // ── Non-subscription specific ──
+    /** Purchase config for ONE_TIME/CREDIT_PACK/ITEM products */
+    purchaseConfig: z.object({
+        maxQuantityPerPurchase: z.number().min(1).optional(),
+        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),
+});
+//# sourceMappingURL=product-definition.shared.schemas.js.map

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

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

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

@@ -0,0 +1,64 @@
+/**
+ * Product Resource Configuration
+ *
+ * Admin-managed: APPLICATION-scoped catalog (read-only in UI, code-driven).
+ */
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+import { ResourceRelationship } from '../resources/resources.shared.schemas.js';
+type ProductsCoreOps = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.SEARCH | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE;
+export declare const productsResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("../index.js").ResourceConfiguration<undefined, ProductsCoreOps, import("zod").ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
+    type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").ProductType>>>>>;
+    key: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>>;
+    targetScopes: import("zod").ZodArray<import("zod").ZodEnum<typeof import("../index.js").ResourcePrimaryScope>>;
+    grantedFeatures: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>>;
+    grantedLimits: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+        value: import("zod").ZodNumber;
+        mode: import("zod").ZodDefault<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").LimitGrantMode>>;
+    }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>>>;
+    planTier: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodString>>;
+    planTierOrder: import("zod").ZodOptional<import("zod").ZodNumber>;
+    requiredPlanTiers: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    taxDisplayMode: import("zod").ZodOptional<import("zod").ZodEnum<typeof import("@wildo-ai/external-connectors-models").TaxDisplayMode>>;
+    purchaseConfig: import("zod").ZodOptional<import("zod").ZodObject<{
+        maxQuantityPerPurchase: import("zod").ZodOptional<import("zod").ZodNumber>;
+        creditsPerUnit: import("zod").ZodOptional<import("zod").ZodNumber>;
+        creditPoolKey: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+    behaviorPolicy: import("zod").ZodOptional<import("zod").ZodObject<{
+        trial: import("zod").ZodOptional<import("zod").ZodObject<{
+            days: import("zod").ZodDefault<import("zod").ZodNumber>;
+            requirePaymentMethod: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+        upgrade: import("zod").ZodOptional<import("zod").ZodObject<{
+            proration: import("zod").ZodDefault<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").ProrationBehavior>>;
+            timing: import("zod").ZodDefault<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").BillingTiming>>;
+        }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+        downgrade: import("zod").ZodOptional<import("zod").ZodObject<{
+            proration: import("zod").ZodDefault<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").ProrationBehavior>>;
+            timing: import("zod").ZodDefault<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").BillingTiming>>;
+        }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+        cancellation: import("zod").ZodOptional<import("zod").ZodObject<{
+            allowImmediate: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            defaultBehavior: import("zod").ZodDefault<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").BillingTiming>>;
+        }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+        metering: import("zod").ZodOptional<import("zod").ZodObject<{
+            flushIntervalMinutes: import("zod").ZodDefault<import("zod").ZodNumber>;
+            aggregationWindow: import("zod").ZodDefault<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").MeteringAggregationWindow>>;
+            preFlushAggregation: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            retryPolicy: import("zod").ZodDefault<import("zod").ZodObject<{
+                maxRetries: import("zod").ZodDefault<import("zod").ZodNumber>;
+                backoffMultiplier: import("zod").ZodDefault<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+        }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+    }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>;
+    providerProductId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodString>>;
+    sortOrder: import("zod").ZodDefault<import("zod").ZodNumber>;
+    isPublic: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodBoolean>>;
+    isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodBoolean>>>;
+    metadata: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+    createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodDate>>>;
+    updatedAt: 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=product.shared.resources-config.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"product.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/product.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,eAAe,GAChB,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,IAAI,GAC1B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,GAC5B,qBAAqB,CAAC,MAAM,CAAC;AAEjC,eAAO,MAAM,mDAAmD,GAC9D,wBAAwB,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDAkE9C,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * Product Resource Configuration
+ *
+ * Admin-managed: APPLICATION-scoped catalog (read-only in UI, code-driven).
+ */
+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 { ProductSchema } from './product.shared.schemas.js';
+export const productsResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
+    mainSchema: ProductSchema,
+    resourceIdentifier: CoreResourceType.PRODUCTS,
+    resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.PRODUCTS],
+    resourceRelationships: resourcesRelationships,
+    isSystemResource: true,
+    coreOperations: [
+        CoreResourceOperation.READ,
+        CoreResourceOperation.LIST,
+        CoreResourceOperation.SEARCH,
+        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.SEARCH]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_APP_ROLES.APP_USER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                    isSearchable: true,
+                    searchableFields: ['key', 'type'],
+                    searchableOptions: { caseSensitive: false, fullMatchOnly: false },
+                    filterFields: {},
+                    sortFields: [],
+                    maxPaginatedResultPerPageLimit: 50,
+                }],
+        },
+        [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=product.shared.resources-config.schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"product.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/billing/product.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,aAAa,EAAE,MAAM,0BAA0B,CAAC;AASzD,MAAM,CAAC,MAAM,mDAAmD,GAAG,CACjE,sBAA8C,EAC9C,EAAE,CAAC,0CAA0C,CAI7C;IACA,UAAU,EAAE,aAAa;IACzB,kBAAkB,EAAE,gBAAgB,CAAC,QAAQ;IAC7C,uBAAuB,EAAE,kCAAkC,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IACtF,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,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,QAAQ,CAAC;oBAChC,SAAS,EAAE,0BAA0B,CAAC,GAAG;oBACzC,YAAY,EAAE,IAAI;oBAClB,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;oBACjC,iBAAiB,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;oBACjE,YAAY,EAAE,EAAE;oBAChB,UAAU,EAAE,EAAE;oBACd,8BAA8B,EAAE,EAAE;iBACnC,CAAC;SACH;QACD,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE;YAC9B,QAAQ,EAAE,CAAC;oBACT,WAAW,EAAE,4BAA4B,CAAC,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/product.shared.schemas.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Product Schema (Shared)
+ *
+ * Products define what you sell. They live in the DB as APPLICATION-scoped records,
+ * populated lazily from the code-defined ProductDefinition catalog.
+ *
+ * Config-driven, lazy-populated:
+ * 1. Config is the source of truth: Product definitions live in code (shared lib)
+ * 2. Populate on demand: DB records created on first checkout/admin view
+ * 3. Provider sync on demand: providerProductId filled when first used in provider ops
+ * 4. Bulk sync available: Admin action to pre-populate all products
+ * 5. Startup is lightweight: No blocking provider calls at boot
+ *
+ * The admin UI shows products as read-only resources (view + "Sync to Provider" action),
+ * NOT as CRUD-editable. Changes require code deployment.
+ *
+ * @see billing-and-features-system.md §6.2 (Product & Price Catalog)
+ */
+import { z } from 'zod';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { ProductType, TaxDisplayMode } from './billing-enums.shared.schemas.js';
+export declare const ProductSchema: z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof ProductType>>>>>;
+    key: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
+    targetScopes: z.ZodArray<z.ZodEnum<typeof ResourcePrimaryScope>>;
+    grantedFeatures: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    grantedLimits: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<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>>>>;
+    planTier: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    planTierOrder: z.ZodOptional<z.ZodNumber>;
+    requiredPlanTiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    taxDisplayMode: z.ZodOptional<z.ZodEnum<typeof TaxDisplayMode>>;
+    purchaseConfig: z.ZodOptional<z.ZodObject<{
+        maxQuantityPerPurchase: z.ZodOptional<z.ZodNumber>;
+        creditsPerUnit: z.ZodOptional<z.ZodNumber>;
+        creditPoolKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    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>>;
+        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>>;
+        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>>;
+        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>>;
+        metering: z.ZodOptional<z.ZodObject<{
+            flushIntervalMinutes: z.ZodDefault<z.ZodNumber>;
+            aggregationWindow: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").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>>;
+    providerProductId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    sortOrder: z.ZodDefault<z.ZodNumber>;
+    isPublic: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+    isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, 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 Product = z.infer<typeof ProductSchema>;
+//# sourceMappingURL=product.shared.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"product.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/product.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EACL,WAAW,EACX,cAAc,EACf,MAAM,gCAAgC,CAAC;AAIxC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAyExB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * Product Schema (Shared)
+ *
+ * Products define what you sell. They live in the DB as APPLICATION-scoped records,
+ * populated lazily from the code-defined ProductDefinition catalog.
+ *
+ * Config-driven, lazy-populated:
+ * 1. Config is the source of truth: Product definitions live in code (shared lib)
+ * 2. Populate on demand: DB records created on first checkout/admin view
+ * 3. Provider sync on demand: providerProductId filled when first used in provider ops
+ * 4. Bulk sync available: Admin action to pre-populate all products
+ * 5. Startup is lightweight: No blocking provider calls at boot
+ *
+ * The admin UI shows products as read-only resources (view + "Sync to Provider" action),
+ * NOT as CRUD-editable. Changes require code deployment.
+ *
+ * @see billing-and-features-system.md §6.2 (Product & Price Catalog)
+ */
+import { z } from 'zod';
+import { ResourcePrimaryScope } from '../resources/resources.shared.schemas.js';
+import { ProductType, TaxDisplayMode, } from './billing-enums.shared.schemas.js';
+import { LimitGrantSchema } from './product-behavior-policy.shared.schemas.js';
+import { ProductBehaviorPolicySchema } from './product-behavior-policy.shared.schemas.js';
+export const ProductSchema = z.object({
+    _id: z.string().min(1).isPrimaryKey().isSummaryField(),
+    type: z.enum(ProductType).isDBIndexed().isSummaryField().isNotEditable().systemEnum('ProductType'),
+    /** Unique product key (maps to ProductDefinition.key in code catalog) */
+    key: z.string().min(1).isUnique({ scope: 'global' }).isSummaryField().isNotEditable(),
+    /** Which scopes can subscribe to this product (code-driven, not user-editable) */
+    targetScopes: z.array(z.enum(ResourcePrimaryScope)).min(1),
+    /** Features this product grants (boolean: present = enabled) */
+    grantedFeatures: z.array(z.string()).default([]).isNotEditable(),
+    /**
+     * Limits this product grants, with aggregation mode.
+     * - SET: absolute value (for PLAN products: "Professional gives you 50 projects")
+     * - ADD: additive to current limits (for ADDON products: "+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
+     */
+    grantedLimits: z.record(z.string(), LimitGrantSchema).default({}).isNotEditable(),
+    /** For PLAN type: mutually exclusive tier ordering (higher number = higher tier) */
+    planTier: z.string().optional().isSummaryField(),
+    /** For PLAN type: tier sort order (used for upgrade/downgrade direction detection) */
+    planTierOrder: z.number().optional(),
+    /** For ADDON type: required plan tiers to subscribe to this addon (empty = no restriction) */
+    requiredPlanTiers: z.array(z.string()).optional(),
+    /**
+     * Tax display override for this product (overrides BillingConfiguration.tax.defaultDisplayMode).
+     * - 'exclusive': price amounts are HT (tax added at checkout)
+     * - 'inclusive': price amounts are TTC (tax embedded)
+     * When absent: uses global default from BillingConfiguration.
+     *
+     * Common pattern: org products → exclusive, user products → inclusive.
+     */
+    taxDisplayMode: z.enum(TaxDisplayMode).optional(),
+    /**
+     * Purchase configuration for non-subscription products (ONE_TIME, CREDIT_PACK, ITEM).
+     * Ignored for subscription products (PLAN, ADDON, METERED).
+     */
+    purchaseConfig: z.object({
+        /** Maximum quantity per purchase (for CREDIT_PACK/ITEM). undefined = no limit */
+        maxQuantityPerPurchase: z.number().min(1).optional(),
+        /** For CREDIT_PACK: how many credits per pack unit */
+        creditsPerUnit: z.number().min(1).optional(),
+        /** For CREDIT_PACK: which "credit pool" this feeds (e.g., 'ai_tokens', 'sms_credits') */
+        creditPoolKey: z.string().optional(),
+    }).optional(),
+    /** Behavior policy: trial, proration, cancellation, metering */
+    behaviorPolicy: ProductBehaviorPolicySchema.optional(),
+    /** Provider sync (lazy: populated on first checkout or sync action, NOT at startup) */
+    providerProductId: z.string().optional().isBackendOnly(),
+    /** Display sort order in pricing tables */
+    sortOrder: z.number().default(0),
+    /** Whether this product is visible to end users */
+    isPublic: z.boolean().default(true).isSummaryField(),
+    /** Whether this product is available for purchase */
+    isActive: z.boolean().default(true).isDBIndexed().isSummaryField(),
+    metadata: z.record(z.string(), z.string()).optional(),
+    createdAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
+    updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
+});
+//# sourceMappingURL=product.shared.schemas.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * Promotions Resource Configuration
+ *
+ * Admin-managed: discount mechanisms synced to provider.
+ */
+import { z } from 'zod';
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+import { ResourceRelationship } from '../resources/resources.shared.schemas.js';
+export declare enum Promotion_Operations {
+    /** Apply a promotion code (validates and records usage) */
+    APPLY = "apply",
+    /** Deactivate a promotion (sets isActive to false) */
+    DEACTIVATE = "deactivate"
+}
+type PromotionsCoreOps = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.SEARCH | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE;
+export declare const promotionsResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("../index.js").ResourceConfiguration<typeof Promotion_Operations, PromotionsCoreOps, z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    type: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").PromotionType>>>>;
+    name: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    code: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    discountType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").DiscountType>>>;
+    discountPercentage: z.ZodOptional<z.ZodNumber>;
+    discountFixedAmount: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>;
+    duration: z.ZodDefault<z.ZodEnum<typeof import("./billing-enums.shared.schemas.js").PromotionDuration>>;
+    durationInMonths: z.ZodOptional<z.ZodNumber>;
+    applicableProducts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    maxRedemptions: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    timesRedeemed: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodNumber>>;
+    validFrom: z.ZodOptional<z.ZodDate>;
+    validUntil: z.ZodOptional<z.ZodDate>;
+    isActive: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+    providerCouponId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    providerPromotionId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, 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 {};
+//# sourceMappingURL=promotions.shared.resources-config.schemas.d.ts.map

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

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