@wildo-ai/saas-models 1.0.1

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

@@ -0,0 +1,105 @@
+/**
+ * Promotions Resource Configuration
+ *
+ * Admin-managed: discount mechanisms synced to provider.
+ */
+import { z } from 'zod';
+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_ORG_ROLES } from '../security/authorizations/roles.shared.schemas.js';
+import { PromotionSchema } from './promotions.shared.schemas.js';
+// ── Custom Operations ────────────────────────────────────────────────
+export var Promotion_Operations;
+(function (Promotion_Operations) {
+    /** Apply a promotion code (validates and records usage) */
+    Promotion_Operations["APPLY"] = "apply";
+    /** Deactivate a promotion (sets isActive to false) */
+    Promotion_Operations["DEACTIVATE"] = "deactivate";
+})(Promotion_Operations || (Promotion_Operations = {}));
+export const promotionsResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
+    mainSchema: PromotionSchema,
+    resourceIdentifier: CoreResourceType.PROMOTIONS,
+    resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.PROMOTIONS],
+    resourceRelationships: resourcesRelationships,
+    isSystemResource: true,
+    customOperation: Promotion_Operations,
+    coreOperations: [
+        CoreResourceOperation.READ,
+        CoreResourceOperation.LIST,
+        CoreResourceOperation.SEARCH,
+        CoreResourceOperation.CREATE,
+        CoreResourceOperation.UPDATE,
+    ],
+    operationsConfiguration: {
+        [CoreResourceOperation.READ]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.LIST]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.SEARCH]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                    isSearchable: true,
+                    searchableFields: ['name', 'code'],
+                    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,
+                }],
+        },
+        [Promotion_Operations.APPLY]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_MEMBER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                    resourceOperationLike: CoreResourceOperation.UPDATE,
+                    requestDto: z.object({
+                        code: z.string().min(1),
+                    }),
+                }],
+        },
+        [Promotion_Operations.DEACTIVATE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.MEDIUM,
+                    resourceOperationLike: CoreResourceOperation.UPDATE,
+                    haveBulkOperation: true,
+                }],
+        },
+    },
+});
+//# sourceMappingURL=promotions.shared.resources-config.schemas.js.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * Promotion Schema (Shared)
+ *
+ * Promotions are APPLICATION-scoped, admin-managed discount mechanisms
+ * synced to the billing provider (as coupons + promotion codes).
+ *
+ * Types:
+ * - COUPON: Auto-applied or admin-applied discount
+ * - PROMOTION_CODE: User-entered code at checkout
+ * - REFERRAL: Generated by referral program (links to ReferralSchema)
+ * - DEAL: Custom negotiated deal (enterprise/sales-driven)
+ *
+ * @see billing-and-features-system.md §10 (Promotions)
+ */
+import { z } from 'zod';
+import { PromotionType, DiscountType, PromotionDuration } from './billing-enums.shared.schemas.js';
+export declare const PromotionSchema: 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 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 DiscountType>>>;
+    discountPercentage: z.ZodOptional<z.ZodNumber>;
+    discountFixedAmount: z.ZodOptional<import("@wildo-ai/zod-decorators").DecoratedMoneySchema>;
+    duration: z.ZodDefault<z.ZodEnum<typeof 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 type Promotion = z.infer<typeof PromotionSchema>;
+//# sourceMappingURL=promotions.shared.schemas.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * Referral Resource Configuration
+ *
+ * Operational: referral tracking between billing accounts.
+ */
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+import { ResourceRelationship } from '../resources/resources.shared.schemas.js';
+type ReferralsCoreOps = CoreResourceOperation.READ | CoreResourceOperation.LIST | CoreResourceOperation.CREATE | CoreResourceOperation.UPDATE;
+export declare const referralsResourceConfiguration_InitializationFactory: (resourcesRelationships: ResourceRelationship[]) => import("../index.js").ResourceConfiguration<undefined, ReferralsCoreOps, import("zod").ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
+    referrerBillingAccountId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>>;
+    referrerScopeType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").BillingScopeType>>;
+    referredBillingAccountId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodString>>>;
+    referredScopeType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").BillingScopeType>>>;
+    referralCode: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>>;
+    status: 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").ReferralStatus>>>>;
+    referrerReward: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodObject<{
+        type: import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").ReferrerRewardType>;
+        value: import("zod").ZodNumber;
+        creditPoolKey: import("zod").ZodOptional<import("zod").ZodString>;
+        featureKey: import("zod").ZodOptional<import("zod").ZodString>;
+        durationDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+        commissionPercentage: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>>;
+    referredReward: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodObject<{
+        type: import("zod").ZodEnum<typeof import("./billing-enums.shared.schemas.js").ReferredRewardType>;
+        value: import("zod").ZodNumber;
+        creditPoolKey: import("zod").ZodOptional<import("zod").ZodString>;
+        featureKey: import("zod").ZodOptional<import("zod").ZodString>;
+        durationDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+        trialExtensionDays: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip, core.$ZodObjectExtra>>>;
+    referrerRewardApplied: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodBoolean>>;
+    referredRewardApplied: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodBoolean>>;
+    acceptedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodDate>>;
+    convertedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodDate>>>;
+    expiresAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodDate>>>;
+    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=referral.shared.resources-config.schemas.d.ts.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * Referral Resource Configuration
+ *
+ * Operational: referral tracking between billing accounts.
+ */
+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_ORG_ROLES } from '../security/authorizations/roles.shared.schemas.js';
+import { ReferralSchema } from './referral.shared.schemas.js';
+export const referralsResourceConfiguration_InitializationFactory = (resourcesRelationships) => createResourceConfiguration_Initialization({
+    mainSchema: ReferralSchema,
+    resourceIdentifier: CoreResourceType.REFERRALS,
+    resourceFieldIdentifier: coreResourceShared_FieldIdentifier[CoreResourceType.REFERRALS],
+    resourceRelationships: resourcesRelationships,
+    isSystemResource: true,
+    coreOperations: [
+        CoreResourceOperation.READ,
+        CoreResourceOperation.LIST,
+        CoreResourceOperation.CREATE,
+        CoreResourceOperation.UPDATE,
+    ],
+    operationsConfiguration: {
+        [CoreResourceOperation.READ]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.LIST]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.CREATE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+        [CoreResourceOperation.UPDATE]: {
+            variants: [{
+                    variantType: ResourceOperationVariantType.REPOSITORY_ONLY,
+                    isDefault: true,
+                    roles: [CORE_ORG_ROLES.ORG_OWNER],
+                    riskLevel: ResourceOperationRiskLevel.LOW,
+                }],
+        },
+    },
+});
+//# sourceMappingURL=referral.shared.resources-config.schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"referral.shared.resources-config.schemas.js","sourceRoot":"","sources":["../../../src/billing/referral.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,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAQ3D,MAAM,CAAC,MAAM,oDAAoD,GAAG,CAClE,sBAA8C,EAC9C,EAAE,CAAC,0CAA0C,CAI7C;IACA,UAAU,EAAE,cAAc;IAC1B,kBAAkB,EAAE,gBAAgB,CAAC,SAAS;IAC9C,uBAAuB,EAAE,kCAAkC,CAAC,gBAAgB,CAAC,SAAS,CAAC;IACvF,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,SAAS,CAAC;oBACjC,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,SAAS,CAAC;oBACjC,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,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,GAAG;iBAC1C,CAAC;SACH;KACF;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,70 @@
+/**
+ * Referral Schema (Shared)
+ *
+ * Scope-agnostic referral tracking. Links a referrer billing account
+ * to a referred billing account, with reward configuration.
+ *
+ * Referral flow:
+ * 1. Referrer shares a referral link (contains referralCode)
+ * 2. Referred user signs up and creates a billing account
+ * 3. ReferralSchema is created with status: PENDING
+ * 4. On referred user's first subscription: status → CONVERTED
+ * 5. Rewards are applied to both parties
+ *
+ * @see billing-and-features-system.md §10 (Referrals)
+ */
+import { z } from 'zod';
+import { BillingScopeType, ReferralStatus, ReferrerRewardType, ReferredRewardType } from './billing-enums.shared.schemas.js';
+export declare const ReferrerRewardSchema: z.ZodObject<{
+    type: z.ZodEnum<typeof ReferrerRewardType>;
+    value: z.ZodNumber;
+    creditPoolKey: z.ZodOptional<z.ZodString>;
+    featureKey: z.ZodOptional<z.ZodString>;
+    durationDays: z.ZodOptional<z.ZodNumber>;
+    commissionPercentage: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type ReferrerReward = z.infer<typeof ReferrerRewardSchema>;
+export declare const ReferredRewardSchema: z.ZodObject<{
+    type: z.ZodEnum<typeof ReferredRewardType>;
+    value: z.ZodNumber;
+    creditPoolKey: z.ZodOptional<z.ZodString>;
+    featureKey: z.ZodOptional<z.ZodString>;
+    durationDays: z.ZodOptional<z.ZodNumber>;
+    trialExtensionDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type ReferredReward = z.infer<typeof ReferredRewardSchema>;
+export declare const ReferralSchema: z.ZodObject<{
+    _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>;
+    referrerBillingAccountId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
+    referrerScopeType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof BillingScopeType>>;
+    referredBillingAccountId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodString>>>;
+    referredScopeType: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodEnum<typeof BillingScopeType>>>;
+    referralCode: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodString>>>;
+    status: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodEnum<typeof ReferralStatus>>>>;
+    referrerReward: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<typeof ReferrerRewardType>;
+        value: z.ZodNumber;
+        creditPoolKey: z.ZodOptional<z.ZodString>;
+        featureKey: z.ZodOptional<z.ZodString>;
+        durationDays: z.ZodOptional<z.ZodNumber>;
+        commissionPercentage: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    referredReward: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<typeof ReferredRewardType>;
+        value: z.ZodNumber;
+        creditPoolKey: z.ZodOptional<z.ZodString>;
+        featureKey: z.ZodOptional<z.ZodString>;
+        durationDays: z.ZodOptional<z.ZodNumber>;
+        trialExtensionDays: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip, core.$ZodObjectExtra>>>;
+    referrerRewardApplied: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+    referredRewardApplied: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodDefault<z.ZodBoolean>>;
+    acceptedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodDate>>;
+    convertedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodDate>>>;
+    expiresAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<z.ZodOptional<z.ZodDate>>>;
+    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 Referral = z.infer<typeof ReferralSchema>;
+//# sourceMappingURL=referral.shared.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"referral.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/referral.shared.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AAIxC,eAAO,MAAM,oBAAoB;;;;;;;uCAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;;;uCAQ/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIlE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAyCzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

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

@@ -0,0 +1,75 @@
+/**
+ * Referral Schema (Shared)
+ *
+ * Scope-agnostic referral tracking. Links a referrer billing account
+ * to a referred billing account, with reward configuration.
+ *
+ * Referral flow:
+ * 1. Referrer shares a referral link (contains referralCode)
+ * 2. Referred user signs up and creates a billing account
+ * 3. ReferralSchema is created with status: PENDING
+ * 4. On referred user's first subscription: status → CONVERTED
+ * 5. Rewards are applied to both parties
+ *
+ * @see billing-and-features-system.md §10 (Referrals)
+ */
+import { z } from 'zod';
+import { BillingScopeType, ReferralStatus, ReferrerRewardType, ReferredRewardType, } from './billing-enums.shared.schemas.js';
+// ── Reward Definitions ──────────────────────────────────────────
+export const ReferrerRewardSchema = z.object({
+    type: z.enum(ReferrerRewardType),
+    /** Credit amount (for CREDIT type), discount percentage (for DISCOUNT), etc. */
+    value: z.number().min(0),
+    /** Credit pool key (for CREDIT type) */
+    creditPoolKey: z.string().optional(),
+    /** Feature key (for FEATURE type) */
+    featureKey: z.string().optional(),
+    /** Duration in days (for temporary rewards) */
+    durationDays: z.number().min(1).optional(),
+    /** Commission percentage (for COMMISSION type) */
+    commissionPercentage: z.number().min(0).max(100).optional(),
+});
+export const ReferredRewardSchema = z.object({
+    type: z.enum(ReferredRewardType),
+    value: z.number().min(0),
+    creditPoolKey: z.string().optional(),
+    featureKey: z.string().optional(),
+    durationDays: z.number().min(1).optional(),
+    /** Trial extension in days (for TRIAL_EXTENSION type) */
+    trialExtensionDays: z.number().min(1).optional(),
+});
+// ── Referral ────────────────────────────────────────────────────
+export const ReferralSchema = z.object({
+    _id: z.string().min(1).isPrimaryKey().isSummaryField(),
+    /** The billing account that created the referral */
+    referrerBillingAccountId: z.string().min(1).isForeignKey().isDBIndexed().isSummaryField(),
+    /** Scope type of the referrer's billing account (determines which polymorphic collection to query) */
+    referrerScopeType: z.enum(BillingScopeType).isDBIndexed(),
+    /** The billing account that was referred (set when they sign up) */
+    referredBillingAccountId: z.string().optional().isForeignKey().isDBIndexed(),
+    /** Scope type of the referred billing account (set together with referredBillingAccountId) */
+    referredScopeType: z.enum(BillingScopeType).optional().isDBIndexed(),
+    /** Unique referral code (shared by referrer) */
+    referralCode: z.string().min(1).isUnique({ scope: 'global' }).isDBIndexed().isSummaryField(),
+    /** Current status */
+    status: z.enum(ReferralStatus).isDBIndexed().isSummaryField().systemEnum('ReferralStatus'),
+    // ── Rewards ──
+    /** What the referrer gets when referral converts */
+    referrerReward: ReferrerRewardSchema.optional().isNotEditable(),
+    /** What the referred user gets */
+    referredReward: ReferredRewardSchema.optional().isNotEditable(),
+    /** Whether rewards have been applied */
+    referrerRewardApplied: z.boolean().default(false).isNotEditable(),
+    referredRewardApplied: z.boolean().default(false).isNotEditable(),
+    // ── Dates ──
+    /** When the referred user accepted the referral */
+    acceptedAt: z.date().optional().isNotEditable(),
+    /** When the referred user converted (first subscription) */
+    convertedAt: z.date().optional().isSummaryField().isNotEditable(),
+    /** When the referral expires */
+    expiresAt: z.date().optional().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=referral.shared.schemas.js.map

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * Subscription Resource Configuration — Polymorphic
+ *
+ * Produces 3 factory functions (one per scope variant) via the polymorphic factory.
+ * Spread into the registry factory map:
+ *   ...billingSubscriptionsPolymorphicFactories
+ *
+ * @see polymorphic-scope-approach-A-expansion.md — Phase 3
+ */
+import { z } from 'zod';
+import { CoreResourceOperation } from '../resources/resources.shared.core.definitions.js';
+export declare enum BillingSubscription_Operations {
+    /** Cancel the subscription (at period end or immediately) */
+    CANCEL = "cancel",
+    /** Resume a cancelled subscription before period end */
+    RESUME = "resume",
+    /** Change to a different plan (upgrade/downgrade) */
+    CHANGE_PLAN = "change_plan",
+    /** Add an addon product to the subscription */
+    ADD_ADDON = "add_addon",
+    /** Remove an addon product from the subscription */
+    REMOVE_ADDON = "remove_addon"
+}
+/** Request DTO for CANCEL operation — shared between resource config and custom impl */
+export declare const BillingSubscription_CancelRequestDto: z.ZodObject<{
+    cancelImmediately: z.ZodDefault<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/** Request DTO for CHANGE_PLAN operation — shared between resource config and custom impl */
+export declare const BillingSubscription_ChangePlanRequestDto: z.ZodObject<{
+    newProductKey: z.ZodString;
+    newPriceId: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/** Request DTO for ADD_ADDON operation — shared between resource config and custom impl */
+export declare const BillingSubscription_AddAddonRequestDto: z.ZodObject<{
+    addonProductKey: z.ZodString;
+    priceId: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/** Request DTO for REMOVE_ADDON operation — shared between resource config and custom impl */
+export declare const BillingSubscription_RemoveAddonRequestDto: z.ZodObject<{
+    addonProductKey: z.ZodString;
+}, z.core.$strip, core.$ZodObjectExtra>;
+/**
+ * Polymorphic factory map for subscriptions.
+ * Spread into `coreShared_ResourcesConfigurations_FactoryMap`:
+ *   ...billingSubscriptionsPolymorphicFactories
+ *
+ * Produces entries for:
+ *   - organizationSubscriptions
+ *   - userSubscriptions
+ */
+export declare const billingSubscriptionsPolymorphicFactories: Record<string, import("../index.js").ResourceConfiguration_InitializationFactory<typeof BillingSubscription_Operations, CoreResourceOperation.READ | CoreResourceOperation.UPDATE | CoreResourceOperation.CREATE | CoreResourceOperation.LIST, any>>;
+//# sourceMappingURL=subscription.shared.resources-config.schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.shared.resources-config.schemas.d.ts","sourceRoot":"","sources":["../../../src/billing/subscription.shared.resources-config.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAoB,MAAM,gDAAgD,CAAC;AAWzG,oBAAY,8BAA8B;IACxC,6DAA6D;IAC7D,MAAM,WAAW;IACjB,wDAAwD;IACxD,MAAM,WAAW;IACjB,qDAAqD;IACrD,WAAW,gBAAgB;IAC3B,+CAA+C;IAC/C,SAAS,cAAc;IACvB,oDAAoD;IACpD,YAAY,iBAAiB;CAC9B;AAID,wFAAwF;AACxF,eAAO,MAAM,oCAAoC;;;uCAG/C,CAAC;AAEH,6FAA6F;AAC7F,eAAO,MAAM,wCAAwC;;;uCAGnD,CAAC;AAEH,2FAA2F;AAC3F,eAAO,MAAM,sCAAsC;;;uCAGjD,CAAC;AAEH,8FAA8F;AAC9F,eAAO,MAAM,yCAAyC;;uCAEpD,CAAC;AAMH;;;;;;;;GAQG;AACH,eAAO,MAAM,wCAAwC,6OA0HpD,CAAC"}