clhq-postgres-module 1.1.0-alpha.97 → 1.1.0-alpha.98

package/dist/entities/credit-allocation.entity.d.ts

@@ -0,0 +1,23 @@
+import { User } from './user.entity';
+export declare enum CreditAllocationStatus {
+    ACTIVE = "active",
+    EXPIRED = "expired",
+    UPGRADED = "upgraded",
+    CANCELLED = "cancelled"
+}
+export declare class CreditAllocation {
+    id: string;
+    userId: string;
+    user: User;
+    planId: string;
+    creditsAllocated: number;
+    creditsRemaining: number;
+    aiCreditsAllocated: number;
+    aiCreditsRemaining: number;
+    periodStart: Date;
+    periodEnd: Date;
+    rolloverCredits: number;
+    status: CreditAllocationStatus;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/dist/entities/credit-allocation.entity.js

@@ -0,0 +1,91 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditAllocation = exports.CreditAllocationStatus = void 0;
+const typeorm_1 = require("typeorm");
+const user_entity_1 = require("./user.entity");
+var CreditAllocationStatus;
+(function (CreditAllocationStatus) {
+    CreditAllocationStatus["ACTIVE"] = "active";
+    CreditAllocationStatus["EXPIRED"] = "expired";
+    CreditAllocationStatus["UPGRADED"] = "upgraded";
+    CreditAllocationStatus["CANCELLED"] = "cancelled";
+})(CreditAllocationStatus || (exports.CreditAllocationStatus = CreditAllocationStatus = {}));
+let CreditAllocation = class CreditAllocation {
+};
+exports.CreditAllocation = CreditAllocation;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], CreditAllocation.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'user_id' }),
+    __metadata("design:type", String)
+], CreditAllocation.prototype, "userId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => user_entity_1.User),
+    (0, typeorm_1.JoinColumn)({ name: 'user_id' }),
+    __metadata("design:type", user_entity_1.User)
+], CreditAllocation.prototype, "user", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'plan_id', length: 50 }),
+    __metadata("design:type", String)
+], CreditAllocation.prototype, "planId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'credits_allocated' }),
+    __metadata("design:type", Number)
+], CreditAllocation.prototype, "creditsAllocated", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'credits_remaining' }),
+    __metadata("design:type", Number)
+], CreditAllocation.prototype, "creditsRemaining", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'ai_credits_allocated', default: 0 }),
+    __metadata("design:type", Number)
+], CreditAllocation.prototype, "aiCreditsAllocated", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'ai_credits_remaining', default: 0 }),
+    __metadata("design:type", Number)
+], CreditAllocation.prototype, "aiCreditsRemaining", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'period_start' }),
+    __metadata("design:type", Date)
+], CreditAllocation.prototype, "periodStart", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'period_end' }),
+    __metadata("design:type", Date)
+], CreditAllocation.prototype, "periodEnd", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'rollover_credits', default: 0 }),
+    __metadata("design:type", Number)
+], CreditAllocation.prototype, "rolloverCredits", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: CreditAllocationStatus,
+        default: CreditAllocationStatus.ACTIVE,
+    }),
+    __metadata("design:type", String)
+], CreditAllocation.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], CreditAllocation.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)({ name: 'updated_at' }),
+    __metadata("design:type", Date)
+], CreditAllocation.prototype, "updatedAt", void 0);
+exports.CreditAllocation = CreditAllocation = __decorate([
+    (0, typeorm_1.Entity)('credit_allocations'),
+    (0, typeorm_1.Index)(['userId'], { unique: false }),
+    (0, typeorm_1.Index)(['periodStart', 'periodEnd'], { unique: false }),
+    (0, typeorm_1.Index)(['status'], { unique: false })
+], CreditAllocation);

package/dist/entities/credit-consumption-log.entity.d.ts

@@ -0,0 +1,32 @@
+import { User } from './user.entity';
+import { CreditAllocation } from './credit-allocation.entity';
+import { CreditTransaction } from './credit-transaction.entity';
+export declare enum ConsumptionStatus {
+    PENDING = "pending",
+    RESERVED = "reserved",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    REFUNDED = "refunded"
+}
+export declare class CreditConsumptionLog {
+    id: string;
+    userId: string;
+    user: User;
+    allocationId?: string;
+    allocation?: CreditAllocation;
+    transactionId?: string;
+    transaction?: CreditTransaction;
+    operationType: string;
+    operationId?: string;
+    baseCredits: number;
+    modifierCredits: number;
+    totalCredits: number;
+    operationParams: Record<string, any>;
+    status: ConsumptionStatus;
+    startedAt: Date;
+    completedAt?: Date;
+    resultUrl?: string;
+    errorMessage?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/dist/entities/credit-consumption-log.entity.js

@@ -0,0 +1,127 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditConsumptionLog = exports.ConsumptionStatus = void 0;
+const typeorm_1 = require("typeorm");
+const user_entity_1 = require("./user.entity");
+const credit_allocation_entity_1 = require("./credit-allocation.entity");
+const credit_transaction_entity_1 = require("./credit-transaction.entity");
+var ConsumptionStatus;
+(function (ConsumptionStatus) {
+    ConsumptionStatus["PENDING"] = "pending";
+    ConsumptionStatus["RESERVED"] = "reserved";
+    ConsumptionStatus["COMPLETED"] = "completed";
+    ConsumptionStatus["FAILED"] = "failed";
+    ConsumptionStatus["REFUNDED"] = "refunded";
+})(ConsumptionStatus || (exports.ConsumptionStatus = ConsumptionStatus = {}));
+let CreditConsumptionLog = class CreditConsumptionLog {
+};
+exports.CreditConsumptionLog = CreditConsumptionLog;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'user_id' }),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "userId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => user_entity_1.User),
+    (0, typeorm_1.JoinColumn)({ name: 'user_id' }),
+    __metadata("design:type", user_entity_1.User)
+], CreditConsumptionLog.prototype, "user", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'allocation_id', nullable: true }),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "allocationId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => credit_allocation_entity_1.CreditAllocation, { nullable: true }),
+    (0, typeorm_1.JoinColumn)({ name: 'allocation_id' }),
+    __metadata("design:type", credit_allocation_entity_1.CreditAllocation)
+], CreditConsumptionLog.prototype, "allocation", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'transaction_id', nullable: true }),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "transactionId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => credit_transaction_entity_1.CreditTransaction, { nullable: true }),
+    (0, typeorm_1.JoinColumn)({ name: 'transaction_id' }),
+    __metadata("design:type", credit_transaction_entity_1.CreditTransaction)
+], CreditConsumptionLog.prototype, "transaction", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'operation_type', length: 50 }),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "operationType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'operation_id', length: 100, nullable: true }),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "operationId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'base_credits', type: 'decimal', precision: 10, scale: 2 }),
+    __metadata("design:type", Number)
+], CreditConsumptionLog.prototype, "baseCredits", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        name: 'modifier_credits',
+        type: 'decimal',
+        precision: 10,
+        scale: 2,
+        default: 0,
+    }),
+    __metadata("design:type", Number)
+], CreditConsumptionLog.prototype, "modifierCredits", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'total_credits', type: 'decimal', precision: 10, scale: 2 }),
+    __metadata("design:type", Number)
+], CreditConsumptionLog.prototype, "totalCredits", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'operation_params', type: 'jsonb', default: {} }),
+    __metadata("design:type", Object)
+], CreditConsumptionLog.prototype, "operationParams", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ConsumptionStatus,
+        default: ConsumptionStatus.PENDING,
+    }),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'started_at', default: () => 'NOW()' }),
+    __metadata("design:type", Date)
+], CreditConsumptionLog.prototype, "startedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'completed_at', nullable: true }),
+    __metadata("design:type", Date)
+], CreditConsumptionLog.prototype, "completedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "resultUrl", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], CreditConsumptionLog.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], CreditConsumptionLog.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)({ name: 'updated_at' }),
+    __metadata("design:type", Date)
+], CreditConsumptionLog.prototype, "updatedAt", void 0);
+exports.CreditConsumptionLog = CreditConsumptionLog = __decorate([
+    (0, typeorm_1.Entity)('credit_consumption_log'),
+    (0, typeorm_1.Index)(['userId'], { unique: false }),
+    (0, typeorm_1.Index)(['operationType'], { unique: false }),
+    (0, typeorm_1.Index)(['status'], { unique: false }),
+    (0, typeorm_1.Index)(['createdAt'], { unique: false })
+], CreditConsumptionLog);

package/dist/entities/credit-transaction.entity.d.ts

@@ -7,6 +7,13 @@ export declare class CreditTransaction {
     type: string;
     description?: string;
     stripePaymentIntentId?: string;
+    source?: string;
+    referenceId?: string;
+    expiresAt?: Date;
+    operationType?: string;
+    operationId?: string;
+    reservationId?: string;
+    status: string;
     metadata: Record<string, any>;
     createdAt: Date;
     updatedAt: Date;

package/dist/entities/credit-transaction.entity.js

@@ -44,6 +44,34 @@ __decorate([
     (0, typeorm_1.Column)({ name: 'stripe_payment_intent_id', nullable: true }),
     __metadata("design:type", String)
 ], CreditTransaction.prototype, "stripePaymentIntentId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 50, nullable: true }),
+    __metadata("design:type", String)
+], CreditTransaction.prototype, "source", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'reference_id', type: 'uuid', nullable: true }),
+    __metadata("design:type", String)
+], CreditTransaction.prototype, "referenceId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'expires_at', type: 'timestamp', nullable: true }),
+    __metadata("design:type", Date)
+], CreditTransaction.prototype, "expiresAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'operation_type', length: 50, nullable: true }),
+    __metadata("design:type", String)
+], CreditTransaction.prototype, "operationType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'operation_id', length: 100, nullable: true }),
+    __metadata("design:type", String)
+], CreditTransaction.prototype, "operationId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'reservation_id', type: 'uuid', nullable: true }),
+    __metadata("design:type", String)
+], CreditTransaction.prototype, "reservationId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 20, default: 'completed' }),
+    __metadata("design:type", String)
+], CreditTransaction.prototype, "status", void 0);
 __decorate([
     (0, typeorm_1.Column)({ type: 'jsonb', default: {} }),
     __metadata("design:type", Object)

package/dist/entities/index.d.ts

@@ -14,7 +14,10 @@ export * from './subscription-usage.entity';
 export * from './payment-transaction.entity';
 export * from './stripe-webhook.entity';
 export * from './credit-transaction.entity';
+export * from './credit-allocation.entity';
+export * from './credit-consumption-log.entity';
 export * from './reward-rule.entity';
+export * from './referral-event.entity';
 export { AiUsage as AIUsage } from './ai-usage.entity';
 export * from './asset.entity';
 export * from './effect.entity';

package/dist/entities/index.js

@@ -31,7 +31,10 @@ __exportStar(require("./subscription-usage.entity"), exports);
 __exportStar(require("./payment-transaction.entity"), exports);
 __exportStar(require("./stripe-webhook.entity"), exports);
 __exportStar(require("./credit-transaction.entity"), exports);
+__exportStar(require("./credit-allocation.entity"), exports);
+__exportStar(require("./credit-consumption-log.entity"), exports);
 __exportStar(require("./reward-rule.entity"), exports);
+__exportStar(require("./referral-event.entity"), exports);
 var ai_usage_entity_1 = require("./ai-usage.entity");
 Object.defineProperty(exports, "AIUsage", { enumerable: true, get: function () { return ai_usage_entity_1.AiUsage; } });
 __exportStar(require("./asset.entity"), exports);

package/dist/entities/referral-event.entity.d.ts

@@ -0,0 +1,41 @@
+import { User } from './user.entity';
+export declare enum ReferralStatus {
+    SIGNUP = "signup",
+    EMAIL_VERIFIED = "email_verified",
+    FIRST_PROJECT = "first_project",
+    CONVERTED = "converted",
+    CHURNED = "churned"
+}
+export declare enum RewardStatus {
+    PENDING = "pending",
+    PROCESSING = "processing",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    EXPIRED = "expired"
+}
+export declare class ReferralEvent {
+    id: string;
+    referrerId: string;
+    referrer: User;
+    referredId: string;
+    referred: User;
+    referralCode: string;
+    status: ReferralStatus;
+    conversionType?: string;
+    conversionValue: number;
+    referrerRewardAmount: number;
+    referredRewardAmount: number;
+    rewardStatus: RewardStatus;
+    rewardProcessedAt?: Date;
+    attributionSource?: string;
+    utmSource?: string;
+    utmMedium?: string;
+    utmCampaign?: string;
+    metadata: Record<string, any>;
+    ipAddress?: string;
+    userAgent?: string;
+    signupAt: Date;
+    convertedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/dist/entities/referral-event.entity.js

@@ -0,0 +1,170 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferralEvent = exports.RewardStatus = exports.ReferralStatus = void 0;
+const typeorm_1 = require("typeorm");
+const user_entity_1 = require("./user.entity");
+var ReferralStatus;
+(function (ReferralStatus) {
+    ReferralStatus["SIGNUP"] = "signup";
+    ReferralStatus["EMAIL_VERIFIED"] = "email_verified";
+    ReferralStatus["FIRST_PROJECT"] = "first_project";
+    ReferralStatus["CONVERTED"] = "converted";
+    ReferralStatus["CHURNED"] = "churned";
+})(ReferralStatus || (exports.ReferralStatus = ReferralStatus = {}));
+var RewardStatus;
+(function (RewardStatus) {
+    RewardStatus["PENDING"] = "pending";
+    RewardStatus["PROCESSING"] = "processing";
+    RewardStatus["COMPLETED"] = "completed";
+    RewardStatus["FAILED"] = "failed";
+    RewardStatus["EXPIRED"] = "expired";
+})(RewardStatus || (exports.RewardStatus = RewardStatus = {}));
+let ReferralEvent = class ReferralEvent {
+};
+exports.ReferralEvent = ReferralEvent;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'referrer_id' }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "referrerId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => user_entity_1.User),
+    (0, typeorm_1.JoinColumn)({ name: 'referrer_id' }),
+    __metadata("design:type", user_entity_1.User)
+], ReferralEvent.prototype, "referrer", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'referred_id' }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "referredId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => user_entity_1.User),
+    (0, typeorm_1.JoinColumn)({ name: 'referred_id' }),
+    __metadata("design:type", user_entity_1.User)
+], ReferralEvent.prototype, "referred", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'referral_code', length: 50 }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "referralCode", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        type: 'enum',
+        enum: ReferralStatus,
+        default: ReferralStatus.SIGNUP,
+    }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'conversion_type', length: 50, nullable: true }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "conversionType", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        name: 'conversion_value',
+        type: 'decimal',
+        precision: 10,
+        scale: 2,
+        default: 0,
+    }),
+    __metadata("design:type", Number)
+], ReferralEvent.prototype, "conversionValue", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        name: 'referrer_reward_amount',
+        type: 'decimal',
+        precision: 10,
+        scale: 2,
+        default: 0,
+    }),
+    __metadata("design:type", Number)
+], ReferralEvent.prototype, "referrerRewardAmount", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        name: 'referred_reward_amount',
+        type: 'decimal',
+        precision: 10,
+        scale: 2,
+        default: 0,
+    }),
+    __metadata("design:type", Number)
+], ReferralEvent.prototype, "referredRewardAmount", void 0);
+__decorate([
+    (0, typeorm_1.Column)({
+        name: 'reward_status',
+        type: 'enum',
+        enum: RewardStatus,
+        default: RewardStatus.PENDING,
+    }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "rewardStatus", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'reward_processed_at', nullable: true }),
+    __metadata("design:type", Date)
+], ReferralEvent.prototype, "rewardProcessedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'attribution_source', length: 100, nullable: true }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "attributionSource", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'utm_source', length: 100, nullable: true }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "utmSource", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'utm_medium', length: 100, nullable: true }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "utmMedium", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'utm_campaign', length: 100, nullable: true }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "utmCampaign", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'jsonb', default: {} }),
+    __metadata("design:type", Object)
+], ReferralEvent.prototype, "metadata", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'ip_address', type: 'inet', nullable: true }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "ipAddress", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    __metadata("design:type", String)
+], ReferralEvent.prototype, "userAgent", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'signup_at' }),
+    __metadata("design:type", Date)
+], ReferralEvent.prototype, "signupAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ name: 'converted_at', nullable: true }),
+    __metadata("design:type", Date)
+], ReferralEvent.prototype, "convertedAt", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)({ name: 'created_at' }),
+    __metadata("design:type", Date)
+], ReferralEvent.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)({ name: 'updated_at' }),
+    __metadata("design:type", Date)
+], ReferralEvent.prototype, "updatedAt", void 0);
+exports.ReferralEvent = ReferralEvent = __decorate([
+    (0, typeorm_1.Entity)('referral_events'),
+    (0, typeorm_1.Index)(['referrerId'], { unique: false }),
+    (0, typeorm_1.Index)(['referredId'], { unique: false }),
+    (0, typeorm_1.Index)(['referralCode'], { unique: false }),
+    (0, typeorm_1.Index)(['status'], { unique: false }),
+    (0, typeorm_1.Index)(['createdAt'], { unique: false }),
+    (0, typeorm_1.Index)(['conversionType'], {
+        unique: false,
+        where: 'conversion_type IS NOT NULL',
+    })
+], ReferralEvent);

package/dist/repositories/index.d.ts

@@ -16,6 +16,7 @@ export { PaymentTransactionRepository } from './payment-transaction.repository';
 export { StripeWebhookRepository } from './stripe-webhook.repository';
 export { CreditTransactionRepository } from './credit-transaction.repository';
 export { RewardRuleRepository } from './reward-rule.repository';
+export { ReferralEventRepository } from './referral-event.repository';
 export { AiUsageRepository } from './ai-usage.repository';
 export { AssetRepository } from './asset.repository';
 export { EffectRepository } from './effect.repository';

package/dist/repositories/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AudioWaveformRepository = exports.VideoFilmstripRepository = exports.VideoRenderRepository = exports.VideoTranscodeRepository = exports.EffectRepository = exports.AssetRepository = exports.AiUsageRepository = exports.RewardRuleRepository = exports.CreditTransactionRepository = exports.StripeWebhookRepository = exports.PaymentTransactionRepository = exports.SubscriptionUsageRepository = exports.UserSubscriptionRepository = exports.PlanRepository = exports.SubscriptionPlanRepository = exports.CommentRepository = exports.EditorProjectRepository = exports.InviteRepository = exports.WorkspaceMemberRepository = exports.WorkspaceRepository = exports.AuthSessionRepository = exports.UserOnboardingRepository = exports.UserProfileRepository = exports.UserRepository = exports.BaseRepository = void 0;
+exports.AudioWaveformRepository = exports.VideoFilmstripRepository = exports.VideoRenderRepository = exports.VideoTranscodeRepository = exports.EffectRepository = exports.AssetRepository = exports.AiUsageRepository = exports.ReferralEventRepository = exports.RewardRuleRepository = exports.CreditTransactionRepository = exports.StripeWebhookRepository = exports.PaymentTransactionRepository = exports.SubscriptionUsageRepository = exports.UserSubscriptionRepository = exports.PlanRepository = exports.SubscriptionPlanRepository = exports.CommentRepository = exports.EditorProjectRepository = exports.InviteRepository = exports.WorkspaceMemberRepository = exports.WorkspaceRepository = exports.AuthSessionRepository = exports.UserOnboardingRepository = exports.UserProfileRepository = exports.UserRepository = exports.BaseRepository = void 0;
 var base_repository_1 = require("./base.repository");
 Object.defineProperty(exports, "BaseRepository", { enumerable: true, get: function () { return base_repository_1.BaseRepository; } });
 var user_repository_1 = require("./user.repository");
@@ -37,6 +37,8 @@ var credit_transaction_repository_1 = require("./credit-transaction.repository")
 Object.defineProperty(exports, "CreditTransactionRepository", { enumerable: true, get: function () { return credit_transaction_repository_1.CreditTransactionRepository; } });
 var reward_rule_repository_1 = require("./reward-rule.repository");
 Object.defineProperty(exports, "RewardRuleRepository", { enumerable: true, get: function () { return reward_rule_repository_1.RewardRuleRepository; } });
+var referral_event_repository_1 = require("./referral-event.repository");
+Object.defineProperty(exports, "ReferralEventRepository", { enumerable: true, get: function () { return referral_event_repository_1.ReferralEventRepository; } });
 var ai_usage_repository_1 = require("./ai-usage.repository");
 Object.defineProperty(exports, "AiUsageRepository", { enumerable: true, get: function () { return ai_usage_repository_1.AiUsageRepository; } });
 var asset_repository_1 = require("./asset.repository");

package/dist/repositories/referral-event.repository.d.ts

@@ -0,0 +1,37 @@
+import { Repository } from 'typeorm';
+import { BaseRepository } from './base.repository';
+import { ReferralEvent, ReferralStatus, RewardStatus } from '../entities/referral-event.entity';
+export declare class ReferralEventRepository extends BaseRepository<ReferralEvent> {
+    protected repository: Repository<ReferralEvent>;
+    constructor(repository: Repository<ReferralEvent>);
+    findByReferrerId(referrerId: string, options?: {
+        status?: ReferralStatus;
+        limit?: number;
+        offset?: number;
+    }): Promise<ReferralEvent[]>;
+    findByReferredId(referredId: string): Promise<ReferralEvent[]>;
+    findByReferralPair(referrerId: string, referredId: string): Promise<ReferralEvent | null>;
+    findByReferralCode(referralCode: string): Promise<ReferralEvent[]>;
+    countConversionsByReferrer(referrerId: string): Promise<number>;
+    countSignupsByReferrer(referrerId: string): Promise<number>;
+    getReferralStats(referrerId: string): Promise<{
+        totalSignups: number;
+        totalConversions: number;
+        conversionRate: number;
+        totalRewardAmount: number;
+    }>;
+    updateStatus(id: string, status: ReferralStatus, additionalData?: {
+        conversionType?: string;
+        conversionValue?: number;
+        convertedAt?: Date;
+    }): Promise<ReferralEvent | null>;
+    updateRewardStatus(id: string, rewardStatus: RewardStatus, rewardAmount?: number, rewardProcessedAt?: Date): Promise<ReferralEvent | null>;
+    getPendingRewards(): Promise<ReferralEvent[]>;
+    getConversionFunnel(startDate: Date, endDate: Date): Promise<{
+        signup: number;
+        emailVerified: number;
+        firstProject: number;
+        converted: number;
+    }>;
+    getAttributionBreakdown(startDate: Date, endDate: Date): Promise<Record<string, number>>;
+}

package/dist/repositories/referral-event.repository.js

@@ -0,0 +1,154 @@
+"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 });
+exports.ReferralEventRepository = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const typeorm_2 = require("typeorm");
+const base_repository_1 = require("./base.repository");
+const referral_event_entity_1 = require("../entities/referral-event.entity");
+let ReferralEventRepository = class ReferralEventRepository extends base_repository_1.BaseRepository {
+    constructor(repository) {
+        super(repository);
+        this.repository = repository;
+    }
+    async findByReferrerId(referrerId, options) {
+        const query = this.repository
+            .createQueryBuilder('re')
+            .where('re.referrer_id = :referrerId', { referrerId })
+            .leftJoinAndSelect('re.referred', 'referred')
+            .orderBy('re.signup_at', 'DESC');
+        if (options?.status) {
+            query.andWhere('re.status = :status', { status: options.status });
+        }
+        if (options?.limit) {
+            query.take(options.limit);
+        }
+        if (options?.offset) {
+            query.skip(options.offset);
+        }
+        return query.getMany();
+    }
+    async findByReferredId(referredId) {
+        return this.repository.find({
+            where: { referredId },
+            relations: ['referrer'],
+            order: { signupAt: 'DESC' },
+        });
+    }
+    async findByReferralPair(referrerId, referredId) {
+        return this.repository.findOne({
+            where: { referrerId, referredId },
+            relations: ['referrer', 'referred'],
+        });
+    }
+    async findByReferralCode(referralCode) {
+        return this.repository.find({
+            where: { referralCode },
+            relations: ['referrer', 'referred'],
+            order: { signupAt: 'DESC' },
+        });
+    }
+    async countConversionsByReferrer(referrerId) {
+        return this.repository.count({
+            where: {
+                referrerId,
+                status: referral_event_entity_1.ReferralStatus.CONVERTED,
+            },
+        });
+    }
+    async countSignupsByReferrer(referrerId) {
+        return this.repository.count({
+            where: { referrerId },
+        });
+    }
+    async getReferralStats(referrerId) {
+        const stats = await this.repository
+            .createQueryBuilder('re')
+            .select([
+            'COUNT(*) as totalSignups',
+            'COUNT(CASE WHEN re.status = :converted THEN 1 END) as totalConversions',
+            'SUM(re.referrer_reward_amount) as totalRewardAmount',
+        ])
+            .where('re.referrer_id = :referrerId', { referrerId })
+            .setParameters({ converted: referral_event_entity_1.ReferralStatus.CONVERTED })
+            .getRawOne();
+        const totalSignups = Number(stats.totalSignups) || 0;
+        const totalConversions = Number(stats.totalConversions) || 0;
+        const conversionRate = totalSignups > 0 ? (totalConversions / totalSignups) * 100 : 0;
+        const totalRewardAmount = Number(stats.totalRewardAmount) || 0;
+        return {
+            totalSignups,
+            totalConversions,
+            conversionRate,
+            totalRewardAmount,
+        };
+    }
+    async updateStatus(id, status, additionalData) {
+        const updateData = { status };
+        if (additionalData) {
+            Object.assign(updateData, additionalData);
+        }
+        return this.update(id, updateData);
+    }
+    async updateRewardStatus(id, rewardStatus, rewardAmount, rewardProcessedAt) {
+        const updateData = { rewardStatus };
+        if (rewardAmount !== undefined) {
+            updateData.referrerRewardAmount = rewardAmount;
+        }
+        if (rewardProcessedAt) {
+            updateData.rewardProcessedAt = rewardProcessedAt;
+        }
+        return this.update(id, updateData);
+    }
+    async getPendingRewards() {
+        return this.repository.find({
+            where: { rewardStatus: referral_event_entity_1.RewardStatus.PENDING },
+            relations: ['referrer', 'referred'],
+            order: { signupAt: 'ASC' },
+        });
+    }
+    async getConversionFunnel(startDate, endDate) {
+        const funnelData = await this.repository
+            .createQueryBuilder('re')
+            .select('re.status', 'status')
+            .addSelect('COUNT(*)', 'count')
+            .where('re.signup_at BETWEEN :start AND :end', { start: startDate, end: endDate })
+            .groupBy('re.status')
+            .getRawMany();
+        const counts = Object.fromEntries(funnelData.map((f) => [f.status, Number(f.count)]));
+        return {
+            signup: counts[referral_event_entity_1.ReferralStatus.SIGNUP] || 0,
+            emailVerified: counts[referral_event_entity_1.ReferralStatus.EMAIL_VERIFIED] || 0,
+            firstProject: counts[referral_event_entity_1.ReferralStatus.FIRST_PROJECT] || 0,
+            converted: counts[referral_event_entity_1.ReferralStatus.CONVERTED] || 0,
+        };
+    }
+    async getAttributionBreakdown(startDate, endDate) {
+        const attributionData = await this.repository
+            .createQueryBuilder('re')
+            .select('COALESCE(re.attribution_source, \'unknown\')', 'source')
+            .addSelect('COUNT(*)', 'count')
+            .where('re.signup_at BETWEEN :start AND :end', { start: startDate, end: endDate })
+            .groupBy('re.attribution_source')
+            .getRawMany();
+        return Object.fromEntries(attributionData.map((a) => [a.source, Number(a.count)]));
+    }
+};
+exports.ReferralEventRepository = ReferralEventRepository;
+exports.ReferralEventRepository = ReferralEventRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, typeorm_1.InjectRepository)(referral_event_entity_1.ReferralEvent)),
+    __metadata("design:paramtypes", [typeorm_2.Repository])
+], ReferralEventRepository);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clhq-postgres-module",
-  "version": "1.1.0-alpha.97",
+  "version": "1.1.0-alpha.98",
   "description": "PostgreSQL module using TypeORM for Clippy",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,6 +30,12 @@
     "db:migrate:004": "npx ts-node scripts/run-migrations.ts 004",
     "db:migrate:008": "npx ts-node scripts/run-migrations.ts 008",
     "db:migrate:009": "npx ts-node scripts/run-migrations.ts 009",
+    "db:migrate:011": "npx ts-node scripts/run-migrations.ts 011",
+    "db:migrate:012": "npx ts-node scripts/run-migrations.ts 012",
+    "db:migrate:013": "npx ts-node scripts/run-migrations.ts 013",
+    "db:migrate:014": "npx ts-node scripts/run-migrations.ts 014",
+    "db:migrate:015": "npx ts-node scripts/run-migrations.ts 015",
+    "db:migrate:016": "npx ts-node scripts/run-migrations.ts 016",
     "db:verify": "env-cmd -f ../../.env.dev  npx ts-node scripts/verify-tables.ts",
     "db:test": "env-cmd -f ../../.env.dev  npx ts-node scripts/test-connections.ts",
     "db:sync": "env-cmd -f ../../.env.dev  npm run typeorm schema:sync -- -d src/config/data-source.ts",