@etohq/ambassador 1.5.1-alpha.4

package/dist/services/program-enrollment-service.d.ts

@@ -0,0 +1,39 @@
+import { Context, DAL, FindConfig } from "@etohq/framework/types";
+import { EnrollAmbassadorDTO, FilterableProgramEnrollmentProps, ProgramEnrollmentDTO, ProgramEnrollmentStatus } from "@etohq/framework/types";
+type InjectedDependencies = {
+    programEnrollmentRepository: DAL.RepositoryService;
+};
+declare const ProgramEnrollmentService_base: new (container: InjectedDependencies) => import("@etohq/framework/types").IEtoInternalService<{
+    id: string;
+    ambassador_id: string;
+    program_id: string;
+    tenant_id: string | null;
+    group_id: string | null;
+    application_id: string | null;
+    click_reward_id: string | null;
+    lead_reward_id: string | null;
+    sale_reward_id: string | null;
+    access_reward_id: string | null;
+    discount_id: string | null;
+    application_message: string | null;
+    invited_by: string | null;
+    source: string | null;
+    metadata: Record<string, unknown> | null;
+    status: "pending" | "approved" | "rejected" | "invited" | "declined" | "banned" | "archived";
+    total_commissions: number;
+    banned_at: Date | null;
+    banned_reason: "tos_violation" | "inappropriate_content" | "fake_traffic" | "fraud" | "spam" | "brand_abuse" | null;
+    created_at: Date;
+    updated_at: Date;
+    deleted_at: Date | null;
+}, InjectedDependencies>;
+export default class ProgramEnrollmentService extends ProgramEnrollmentService_base {
+    protected readonly programEnrollmentRepository_: DAL.RepositoryService;
+    constructor(container: InjectedDependencies);
+    enrollAmbassador(data: EnrollAmbassadorDTO, autoApprove?: boolean, sharedContext?: Context): Promise<ProgramEnrollmentDTO>;
+    getEnrollmentOrThrow(ambassadorId: string, programId: string, sharedContext?: Context): Promise<ProgramEnrollmentDTO>;
+    updateEnrollmentStatus(enrollmentId: string, status: ProgramEnrollmentStatus, sharedContext?: Context): Promise<ProgramEnrollmentDTO>;
+    getEnrollmentsByProgram(programId: string, filters?: FilterableProgramEnrollmentProps, config?: FindConfig<ProgramEnrollmentDTO>, sharedContext?: Context): Promise<ProgramEnrollmentDTO[]>;
+}
+export {};
+//# sourceMappingURL=program-enrollment-service.d.ts.map

package/dist/services/program-enrollment-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-enrollment-service.d.ts","sourceRoot":"","sources":["../../src/services/program-enrollment-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,GAAG,EACH,UAAU,EAEX,MAAM,wBAAwB,CAAA;AAS/B,OAAO,EACL,mBAAmB,EACnB,gCAAgC,EAChC,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,wBAAwB,CAAA;AAI/B,KAAK,oBAAoB,GAAG;IAC1B,2BAA2B,EAAE,GAAG,CAAC,iBAAiB,CAAA;CACnD,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAED,MAAM,CAAC,OAAO,OAAO,wBAAyB,SAAQ,6BAGlC;IAClB,SAAS,CAAC,QAAQ,CAAC,4BAA4B,EAAE,GAAG,CAAC,iBAAiB,CAAA;gBAE1D,SAAS,EAAE,oBAAoB;IAOrC,gBAAgB,CACpB,IAAI,EAAE,mBAAmB,EACzB,WAAW,GAAE,OAAe,EACd,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,oBAAoB,CAAC;IAiC1B,oBAAoB,CACxB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACH,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,oBAAoB,CAAC;IAmB1B,sBAAsB,CAC1B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,uBAAuB,EACjB,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,oBAAoB,CAAC;IAe1B,uBAAuB,CAC3B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gCAAqC,EAC9C,MAAM,GAAE,UAAU,CAAC,oBAAoB,CAAM,EAC/B,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAUnC"}

package/dist/services/program-enrollment-service.js

@@ -0,0 +1,102 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@etohq/framework/utils");
+const _models_1 = require("../models");
+class ProgramEnrollmentService extends utils_1.ModulesSdkUtils.EtoInternalService(_models_1.ProgramEnrollment) {
+    constructor(container) {
+        // @ts-ignore
+        super(...arguments);
+        this.programEnrollmentRepository_ = container.programEnrollmentRepository;
+    }
+    async enrollAmbassador(data, autoApprove = false, sharedContext = {}) {
+        // Check if already enrolled 
+        const existing = await this.list({
+            ambassador_id: data.ambassador_id,
+            program_id: data.program_id
+        }, {}, sharedContext);
+        if (existing.length > 0) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.DUPLICATE_ERROR, "Ambassador already enrolled in this program");
+        }
+        const enrollmentData = {
+            id: (0, utils_1.generateEntityId)("", "enr"),
+            ...data,
+            status: autoApprove
+                ? "approved"
+                : "pending",
+            total_commissions: 0,
+            enrolled_at: autoApprove ? new Date() : undefined,
+        };
+        const [enrollment] = await this.create([enrollmentData], sharedContext);
+        return enrollment;
+    }
+    async getEnrollmentOrThrow(ambassadorId, programId, sharedContext = {}) {
+        // Support both ID and slug lookup (Dub pattern)
+        const filters = programId.startsWith("prog_")
+            ? { ambassador_id: ambassadorId, program_id: programId }
+            : { ambassador_id: ambassadorId, program: { slug: programId } };
+        const enrollments = await this.list(filters, {}, sharedContext);
+        if (enrollments.length === 0) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.NOT_FOUND, "You are not enrolled in this program. Contact your program admin to get enrolled.");
+        }
+        return enrollments[0];
+    }
+    async updateEnrollmentStatus(enrollmentId, status, sharedContext = {}) {
+        const updateData = {
+            id: enrollmentId,
+            status
+        };
+        if (status === "approved") {
+            updateData.enrolled_at = new Date();
+        }
+        const [updated] = await this.update([updateData], sharedContext);
+        return updated;
+    }
+    async getEnrollmentsByProgram(programId, filters = {}, config = {}, sharedContext = {}) {
+        return await this.list({
+            program_id: programId,
+            ...filters
+        }, config, sharedContext);
+    }
+}
+exports.default = ProgramEnrollmentService;
+__decorate([
+    (0, utils_1.InjectManager)("programEnrollmentRepository_"),
+    __param(2, (0, utils_1.EtoContext)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Boolean, Object]),
+    __metadata("design:returntype", Promise)
+], ProgramEnrollmentService.prototype, "enrollAmbassador", null);
+__decorate([
+    (0, utils_1.InjectManager)("programEnrollmentRepository_"),
+    __param(2, (0, utils_1.EtoContext)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Object]),
+    __metadata("design:returntype", Promise)
+], ProgramEnrollmentService.prototype, "getEnrollmentOrThrow", null);
+__decorate([
+    (0, utils_1.InjectManager)("programEnrollmentRepository_"),
+    __param(2, (0, utils_1.EtoContext)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Object]),
+    __metadata("design:returntype", Promise)
+], ProgramEnrollmentService.prototype, "updateEnrollmentStatus", null);
+__decorate([
+    (0, utils_1.InjectManager)("programEnrollmentRepository_"),
+    __param(3, (0, utils_1.EtoContext)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], ProgramEnrollmentService.prototype, "getEnrollmentsByProgram", null);
+//# sourceMappingURL=program-enrollment-service.js.map

package/dist/services/program-enrollment-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-enrollment-service.js","sourceRoot":"","sources":["../../src/services/program-enrollment-service.ts"],"names":[],"mappings":"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"}

package/dist/services/program-service.d.ts

@@ -0,0 +1,78 @@
+import { Context, DAL, FindConfig, RewardDTO } from "@etohq/framework/types";
+import { CreateProgramDTO, UpdateProgramDTO, FilterableProgramProps, ProgramDTO } from "@etohq/framework/types";
+type InjectedDependencies = {
+    programRepository: DAL.RepositoryService;
+};
+declare const ProgramService_base: new (container: InjectedDependencies) => import("@etohq/framework/types").IEtoInternalService<{
+    id: string;
+    owner_id: string;
+    owner_type: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    logo: string | null;
+    brand_color: string | null;
+    domain: string | null;
+    url: string | null;
+    wordmark: string | null;
+    primary_category: string;
+    commission_type: "percentage" | "fixed";
+    commission_rate: number;
+    cookie_length: number;
+    holding_period_days: number;
+    min_payout_amount: number;
+    auto_approve_ambassadors: boolean;
+    auto_approve_ambassadors_enabled_at: Date | null;
+    max_ambassador_links: number;
+    url_validation_mode: "domain" | "exact";
+    link_structure: "short" | "query" | "path";
+    link_parameter: string | null;
+    age_verification: number | null;
+    default_folder_id: string | null;
+    default_group_id: string | null;
+    lander_published_at: Date | null;
+    category: string | null;
+    tags: string[] | null;
+    target_audience: string | null;
+    commission_summary: string | null;
+    program_benefits: Record<string, unknown> | null;
+    requirements: Record<string, unknown> | null;
+    campaign_id: string | null;
+    active_promotion_ids: string[] | null;
+    promotion_integration_enabled: boolean;
+    discounts: Record<string, unknown> | null;
+    rewards: Record<string, unknown> | null;
+    discount_enabled: boolean;
+    discount_type: "percentage" | "flat";
+    discount_amount: number;
+    discount_max_duration: number | null;
+    terms_url: string | null;
+    help_url: string | null;
+    support_email: string | null;
+    revenue_sharing_mode: "default" | "custom" | "negotiated";
+    status: "active" | "inactive" | "suspended";
+    metadata: Record<string, unknown> | null;
+    raw_age_verification: Record<string, unknown> | null;
+    raw_discount_max_duration: Record<string, unknown> | null;
+    created_at: Date;
+    updated_at: Date;
+    deleted_at: Date | null;
+} & {
+    rewards: RewardDTO[];
+}, InjectedDependencies>;
+export default class ProgramService extends ProgramService_base {
+    protected readonly programRepository_: DAL.RepositoryService;
+    constructor(container: InjectedDependencies);
+    createProgramWithValidation(data: CreateProgramDTO, sharedContext?: Context): Promise<ProgramDTO>;
+    getProgramOrThrow(programId: string, ownerId?: string, ownerType?: string, sharedContext?: Context): Promise<ProgramDTO>;
+    listProgramsByOwner(ownerId: string, ownerType: string, filters?: FilterableProgramProps, config?: FindConfig<ProgramDTO>, sharedContext?: Context): Promise<ProgramDTO[]>;
+    updateProgramWithValidation(data: UpdateProgramDTO, sharedContext?: Context): Promise<ProgramDTO>;
+    private validateProgramData;
+    private validateCommissionRate;
+    private validatePayoutAmount;
+    private validateHoldingPeriod;
+    private validateCookieLength;
+    private validateMaxAmbassadorLinks;
+}
+export {};
+//# sourceMappingURL=program-service.d.ts.map

package/dist/services/program-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program-service.d.ts","sourceRoot":"","sources":["../../src/services/program-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,GAAG,EACH,UAAU,EAEV,SAAS,EACV,MAAM,wBAAwB,CAAA;AAS/B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,UAAU,EACX,MAAM,wBAAwB,CAAA;AAI/B,KAAK,oBAAoB,GAAG;IAC1B,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,CAAA;CACzC,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAI8C,SAAS,EAAE;;AAF1D,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,mBAGlC;IACR,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,CAAC,iBAAiB,CAAA;gBAEhD,SAAS,EAAE,oBAAoB;IAOrC,2BAA2B,CAC/B,IAAI,EAAE,gBAAgB,EACR,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,UAAU,CAAC;IA2ChB,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EACJ,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,UAAU,CAAC;IAmBhB,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,sBAA2B,EACpC,MAAM,GAAE,UAAU,CAAC,UAAU,CAAM,EACrB,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,UAAU,EAAE,CAAC;IAalB,2BAA2B,CAC/B,IAAI,EAAE,gBAAgB,EACR,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,UAAU,CAAC;IA6BtB,OAAO,CAAC,mBAAmB;IAiC3B,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,0BAA0B;CASnC"}

package/dist/services/program-service.js

@@ -0,0 +1,180 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@etohq/framework/utils");
+const _models_1 = require("../models");
+class ProgramService extends utils_1.ModulesSdkUtils.EtoInternalService(_models_1.Program) {
+    constructor(container) {
+        // @ts-ignore
+        super(...arguments);
+        this.programRepository_ = container.programRepository;
+    }
+    async createProgramWithValidation(data, sharedContext = {}) {
+        // Dub business logic validation
+        this.validateProgramData(data);
+        // Check slug uniqueness (Dub pattern)
+        const existingBySlug = await this.list({ slug: data.slug }, {}, sharedContext);
+        if (existingBySlug.length > 0) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.DUPLICATE_ERROR, `Program with slug '${data.slug}' already exists`);
+        }
+        // Create with Dub defaults
+        const programData = {
+            id: (0, utils_1.generateEntityId)("", "prog"),
+            ...data,
+            // Dub defaults
+            cookie_length: data.cookie_length || 30,
+            holding_period_days: data.holding_period_days || 0,
+            min_payout_amount: data.min_payout_amount || 500000, // N5000
+            auto_approve_ambassadors: data.auto_approve_ambassadors || false,
+            max_ambassador_links: data.max_ambassador_links || 10,
+            url_validation_mode: data.url_validation_mode || "domain",
+            link_structure: data.link_structure || "short",
+            promotion_integration_enabled: data.promotion_integration_enabled !== false,
+            discount_enabled: data.discount_enabled || false,
+            discount_type: data.discount_type || "percentage",
+            discount_amount: data.discount_amount || 0,
+            status: "active",
+        };
+        const [program] = await this.create([programData], sharedContext);
+        return program;
+    }
+    async getProgramOrThrow(programId, ownerId, ownerType, sharedContext = {}) {
+        const filters = { id: programId };
+        // Owner validation (our universal owner pattern)
+        if (ownerId && ownerType) {
+            filters.owner_id = ownerId;
+            filters.owner_type = ownerType;
+        }
+        const programs = await this.list(filters, {}, sharedContext);
+        if (programs.length === 0) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.NOT_FOUND, "Program not found");
+        }
+        return programs[0];
+    }
+    async listProgramsByOwner(ownerId, ownerType, filters = {}, config = {}, sharedContext = {}) {
+        return await this.list({
+            owner_id: ownerId,
+            owner_type: ownerType,
+            ...filters,
+        }, config, sharedContext);
+    }
+    async updateProgramWithValidation(data, sharedContext = {}) {
+        // Validate update data
+        if (data.commission_rate !== undefined) {
+            this.validateCommissionRate(data.commission_rate);
+        }
+        if (data.min_payout_amount !== undefined && data.min_payout_amount !== null) {
+            this.validatePayoutAmount(data.min_payout_amount);
+        }
+        if (data.holding_period_days !== undefined && data.holding_period_days !== null) {
+            this.validateHoldingPeriod(data.holding_period_days);
+        }
+        if (data.cookie_length !== undefined && data.cookie_length !== null) {
+            this.validateCookieLength(data.cookie_length);
+        }
+        if (data.max_ambassador_links !== undefined && data.max_ambassador_links !== null) {
+            this.validateMaxAmbassadorLinks(data.max_ambassador_links);
+        }
+        const [updated] = await this.update([data], sharedContext);
+        return updated;
+    }
+    // ===== VALIDATION METHODS (Dub Business Logic) =====
+    validateProgramData(data) {
+        // Commission rate validation (Dub pattern)
+        this.validateCommissionRate(data.commission_rate);
+        // Slug validation (Dub pattern)
+        if (!data.slug || data.slug.length < 3) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.INVALID_DATA, "Program slug must be at least 3 characters");
+        }
+        // Payout amount validation (Dub pattern)
+        if (data.min_payout_amount) {
+            this.validatePayoutAmount(data.min_payout_amount);
+        }
+        // Holding period validation (Dub pattern)
+        if (data.holding_period_days) {
+            this.validateHoldingPeriod(data.holding_period_days);
+        }
+        // Cookie length validation (Dub pattern)
+        if (data.cookie_length) {
+            this.validateCookieLength(data.cookie_length);
+        }
+        // Max ambassador links validation (Dub pattern)
+        if (data.max_ambassador_links) {
+            this.validateMaxAmbassadorLinks(data.max_ambassador_links);
+        }
+    }
+    validateCommissionRate(rate) {
+        if (rate < 0 || rate > 100) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.INVALID_DATA, "Commission rate must be between 0 and 100");
+        }
+    }
+    validatePayoutAmount(amount) {
+        // Dub exact payout amounts (NOT withdrawal amounts)
+        const allowedPayoutAmounts = [0, 2000, 5000, 10000]; // $0, $20, $50, $100
+        if (!allowedPayoutAmounts.includes(amount)) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.INVALID_DATA, `Invalid minimum payout amount. Allowed values: ${allowedPayoutAmounts
+                .map((a) => `$${a / 100}`)
+                .join(", ")}`);
+        }
+    }
+    validateHoldingPeriod(days) {
+        // Dub allowed holding periods
+        const allowedHoldingPeriods = [0, 7, 14, 30, 60, 90];
+        if (!allowedHoldingPeriods.includes(days)) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.INVALID_DATA, `Invalid holding period. Allowed values: ${allowedHoldingPeriods.join(", ")} days`);
+        }
+    }
+    validateCookieLength(days) {
+        // Dub cookie length validation: 1-180 days
+        if (days < 1 || days > 180) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.INVALID_DATA, "Cookie length must be between 1 and 180 days");
+        }
+    }
+    validateMaxAmbassadorLinks(count) {
+        // Dub max partner links validation: 1-999
+        if (count < 1 || count > 999) {
+            throw new utils_1.EtoError(utils_1.EtoError.Types.INVALID_DATA, "Max ambassador links must be between 1 and 999");
+        }
+    }
+}
+exports.default = ProgramService;
+__decorate([
+    (0, utils_1.InjectManager)("programRepository_"),
+    __param(1, (0, utils_1.EtoContext)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], ProgramService.prototype, "createProgramWithValidation", null);
+__decorate([
+    (0, utils_1.InjectManager)("programRepository_"),
+    __param(3, (0, utils_1.EtoContext)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, String, Object]),
+    __metadata("design:returntype", Promise)
+], ProgramService.prototype, "getProgramOrThrow", null);
+__decorate([
+    (0, utils_1.InjectManager)("programRepository_"),
+    __param(4, (0, utils_1.EtoContext)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, String, Object, Object, Object]),
+    __metadata("design:returntype", Promise)
+], ProgramService.prototype, "listProgramsByOwner", null);
+__decorate([
+    (0, utils_1.InjectManager)("programRepository_"),
+    __param(1, (0, utils_1.EtoContext)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], ProgramService.prototype, "updateProgramWithValidation", null);
+//# sourceMappingURL=program-service.js.map

package/dist/services/program-service.js.map

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

package/dist/services/revenue-rule-resolver.d.ts

@@ -0,0 +1,15 @@
+import { Context } from "@etohq/framework/types";
+import { RevenueEvent, RevenueDistribution } from "@etohq/framework/types";
+export default class RevenueRuleResolver {
+    private programService_;
+    private revenueShareRuleService_;
+    constructor(dependencies: {
+        programService: any;
+        revenueShareRuleService: any;
+    });
+    resolveRevenueRules(event: RevenueEvent, sharedContext?: Context): Promise<RevenueDistribution>;
+    private applyPlanBonus;
+    private getPlatformDefault;
+    private getMaterializedRule;
+}
+//# sourceMappingURL=revenue-rule-resolver.d.ts.map

package/dist/services/revenue-rule-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenue-rule-resolver.d.ts","sourceRoot":"","sources":["../../src/services/revenue-rule-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhD,OAAO,EACL,YAAY,EACZ,mBAAmB,EAKpB,MAAM,wBAAwB,CAAA;AA6tB/B,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACtC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,wBAAwB,CAAK;gBAEzB,YAAY,EAAE;QACxB,cAAc,EAAE,GAAG,CAAA;QACnB,uBAAuB,EAAE,GAAG,CAAA;KAC7B;IAMK,mBAAmB,CACvB,KAAK,EAAE,YAAY,EACL,aAAa,GAAE,OAAY,GACxC,OAAO,CAAC,mBAAmB,CAAC;IA2D/B,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,kBAAkB;YAaZ,mBAAmB;CAsClC"}