@wopr-network/platform-core 0.1.0

package/dist/db/schema/credits.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Credit transaction ledger — every credit/debit is an immutable row.
+ * Positive amount = credit (money in), negative = debit (money out).
+ */
+export declare const creditTransactions: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "credit_transactions";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        tenantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tenant_id";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        amount: import("drizzle-orm/pg-core").PgColumn<{
+            name: "amount_credits";
+            tableName: "credit_transactions";
+            dataType: "custom";
+            columnType: "PgCustomColumn";
+            data: import("../../index.js").Credit;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            pgColumnBuilderBrand: "PgCustomColumnBuilderBrand";
+        }>;
+        balanceAfter: import("drizzle-orm/pg-core").PgColumn<{
+            name: "balance_after_credits";
+            tableName: "credit_transactions";
+            dataType: "custom";
+            columnType: "PgCustomColumn";
+            data: import("../../index.js").Credit;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            pgColumnBuilderBrand: "PgCustomColumnBuilderBrand";
+        }>;
+        type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "type";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        description: import("drizzle-orm/pg-core").PgColumn<{
+            name: "description";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        referenceId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "reference_id";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        fundingSource: import("drizzle-orm/pg-core").PgColumn<{
+            name: "funding_source";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        attributedUserId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "attributed_user_id";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        expiresAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "expires_at";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        stripeFingerprint: import("drizzle-orm/pg-core").PgColumn<{
+            name: "stripe_fingerprint";
+            tableName: "credit_transactions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * Denormalized credit balance per tenant — updated atomically alongside
+ * every credit_transactions insert via a Drizzle transaction.
+ */
+export declare const creditBalances: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "credit_balances";
+    schema: undefined;
+    columns: {
+        tenantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tenant_id";
+            tableName: "credit_balances";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        balance: import("drizzle-orm/pg-core").PgColumn<{
+            name: "balance_credits";
+            tableName: "credit_balances";
+            dataType: "custom";
+            columnType: "PgCustomColumn";
+            data: import("../../index.js").Credit;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            pgColumnBuilderBrand: "PgCustomColumnBuilderBrand";
+        }>;
+        lastUpdated: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_updated";
+            tableName: "credit_balances";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/db/schema/credits.js

@@ -0,0 +1,38 @@
+import { sql } from "drizzle-orm";
+import { index, pgTable, text } from "drizzle-orm/pg-core";
+import { creditColumn } from "../credit-column.js";
+/**
+ * Credit transaction ledger — every credit/debit is an immutable row.
+ * Positive amount = credit (money in), negative = debit (money out).
+ */
+export const creditTransactions = pgTable("credit_transactions", {
+    id: text("id").primaryKey(),
+    tenantId: text("tenant_id").notNull(),
+    amount: creditColumn("amount_credits").notNull(),
+    balanceAfter: creditColumn("balance_after_credits").notNull(),
+    type: text("type").notNull(), // signup_grant | purchase | bounty | referral | promo | community_dividend | bot_runtime | adapter_usage | addon | refund | correction
+    description: text("description"),
+    referenceId: text("reference_id").unique(),
+    fundingSource: text("funding_source"), // "stripe" | "payram" | null (null = legacy/signup)
+    attributedUserId: text("attributed_user_id"), // nullable — null for system/bot charges
+    createdAt: text("created_at").notNull().default(sql `(now())`),
+    expiresAt: text("expires_at"), // nullable — null means never expires
+    stripeFingerprint: text("stripe_fingerprint"),
+}, (table) => [
+    index("idx_credit_tx_tenant").on(table.tenantId),
+    index("idx_credit_tx_type").on(table.type),
+    index("idx_credit_tx_ref").on(table.referenceId),
+    index("idx_credit_tx_created").on(table.createdAt),
+    index("idx_credit_tx_tenant_created").on(table.tenantId, table.createdAt),
+    index("idx_credit_tx_expires").on(table.expiresAt),
+    index("idx_credit_tx_fingerprint").on(table.stripeFingerprint).where(sql `${table.stripeFingerprint} IS NOT NULL`),
+]);
+/**
+ * Denormalized credit balance per tenant — updated atomically alongside
+ * every credit_transactions insert via a Drizzle transaction.
+ */
+export const creditBalances = pgTable("credit_balances", {
+    tenantId: text("tenant_id").primaryKey(),
+    balance: creditColumn("balance_credits").notNull().default(sql `0`),
+    lastUpdated: text("last_updated").notNull().default(sql `(now())`),
+});

package/dist/db/schema/dividend-distributions.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Dividend distribution ledger — one row per tenant per day when a dividend is paid.
+ * Written by the nightly dividend cron; read by the dividend API endpoints.
+ */
+export declare const dividendDistributions: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "dividend_distributions";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "dividend_distributions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        tenantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tenant_id";
+            tableName: "dividend_distributions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        date: import("drizzle-orm/pg-core").PgColumn<{
+            name: "date";
+            tableName: "dividend_distributions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        amountCents: import("drizzle-orm/pg-core").PgColumn<{
+            name: "amount_cents";
+            tableName: "dividend_distributions";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        poolCents: import("drizzle-orm/pg-core").PgColumn<{
+            name: "pool_cents";
+            tableName: "dividend_distributions";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        activeUsers: import("drizzle-orm/pg-core").PgColumn<{
+            name: "active_users";
+            tableName: "dividend_distributions";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        createdAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "dividend_distributions";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/db/schema/dividend-distributions.js

@@ -0,0 +1,19 @@
+import { sql } from "drizzle-orm";
+import { index, integer, pgTable, text } from "drizzle-orm/pg-core";
+/**
+ * Dividend distribution ledger — one row per tenant per day when a dividend is paid.
+ * Written by the nightly dividend cron; read by the dividend API endpoints.
+ */
+export const dividendDistributions = pgTable("dividend_distributions", {
+    id: text("id").primaryKey(),
+    tenantId: text("tenant_id").notNull(),
+    date: text("date").notNull(),
+    amountCents: integer("amount_cents").notNull(),
+    poolCents: integer("pool_cents").notNull(),
+    activeUsers: integer("active_users").notNull(),
+    createdAt: text("created_at").notNull().default(sql `(now())`),
+}, (table) => [
+    index("idx_dividend_dist_tenant").on(table.tenantId),
+    index("idx_dividend_dist_date").on(table.date),
+    index("idx_dividend_dist_tenant_date").on(table.tenantId, table.date),
+]);

package/dist/db/schema/email-notifications.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Email notification deduplication table.
+ *
+ * Tracks which billing emails have been sent to prevent duplicates.
+ * Unique constraint on (tenantId, emailType, sentDate) ensures max 1
+ * email per type per day per tenant.
+ */
+export declare const emailNotifications: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "email_notifications";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "email_notifications";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        tenantId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "tenant_id";
+            tableName: "email_notifications";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        emailType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "email_type";
+            tableName: "email_notifications";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sentAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "sent_at";
+            tableName: "email_notifications";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sentDate: import("drizzle-orm/pg-core").PgColumn<{
+            name: "sent_date";
+            tableName: "email_notifications";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;

package/dist/db/schema/email-notifications.js

@@ -0,0 +1,21 @@
+import { sql } from "drizzle-orm";
+import { index, pgTable, text, unique } from "drizzle-orm/pg-core";
+/**
+ * Email notification deduplication table.
+ *
+ * Tracks which billing emails have been sent to prevent duplicates.
+ * Unique constraint on (tenantId, emailType, sentDate) ensures max 1
+ * email per type per day per tenant.
+ */
+export const emailNotifications = pgTable("email_notifications", {
+    id: text("id").primaryKey(),
+    tenantId: text("tenant_id").notNull(),
+    emailType: text("email_type").notNull(),
+    sentAt: text("sent_at").notNull().default(sql `(now())`),
+    /** Date string (YYYY-MM-DD) extracted from sentAt for dedup constraint. */
+    sentDate: text("sent_date").notNull(),
+}, (table) => [
+    unique("uniq_email_per_day").on(table.tenantId, table.emailType, table.sentDate),
+    index("idx_email_notif_tenant").on(table.tenantId),
+    index("idx_email_notif_type").on(table.emailType),
+]);

package/dist/db/schema/index.d.ts

@@ -0,0 +1,33 @@
+export * from "./account-deletion-requests.js";
+export * from "./account-export-requests.js";
+export * from "./admin-audit.js";
+export * from "./admin-users.js";
+export * from "./affiliate.js";
+export * from "./affiliate-fraud.js";
+export * from "./coupon-codes.js";
+export * from "./credits.js";
+export * from "./credit-auto-topup.js";
+export * from "./credit-auto-topup-settings.js";
+export * from "./dividend-distributions.js";
+export * from "./email-notifications.js";
+export * from "./meter-events.js";
+export * from "./notification-preferences.js";
+export * from "./notification-queue.js";
+export * from "./org-memberships.js";
+export * from "./organization-members.js";
+export * from "./payram.js";
+export * from "./platform-api-keys.js";
+export * from "./promotion-redemptions.js";
+export * from "./promotions.js";
+export * from "./provider-credentials.js";
+export * from "./rate-limit-entries.js";
+export * from "./secret-audit-log.js";
+export * from "./session-usage.js";
+export * from "./spending-limits.js";
+export * from "./tenant-addons.js";
+export * from "./tenant-api-keys.js";
+export * from "./tenant-capability-settings.js";
+export * from "./tenant-customers.js";
+export * from "./tenants.js";
+export * from "./user-roles.js";
+export * from "./webhook-seen-events.js";

package/dist/db/schema/index.js

@@ -0,0 +1,33 @@
+export * from "./account-deletion-requests.js";
+export * from "./account-export-requests.js";
+export * from "./admin-audit.js";
+export * from "./admin-users.js";
+export * from "./affiliate.js";
+export * from "./affiliate-fraud.js";
+export * from "./coupon-codes.js";
+export * from "./credits.js";
+export * from "./credit-auto-topup.js";
+export * from "./credit-auto-topup-settings.js";
+export * from "./dividend-distributions.js";
+export * from "./email-notifications.js";
+export * from "./meter-events.js";
+export * from "./notification-preferences.js";
+export * from "./notification-queue.js";
+export * from "./org-memberships.js";
+export * from "./organization-members.js";
+export * from "./payram.js";
+export * from "./platform-api-keys.js";
+export * from "./promotion-redemptions.js";
+export * from "./promotions.js";
+export * from "./provider-credentials.js";
+export * from "./rate-limit-entries.js";
+export * from "./secret-audit-log.js";
+export * from "./session-usage.js";
+export * from "./spending-limits.js";
+export * from "./tenant-addons.js";
+export * from "./tenant-api-keys.js";
+export * from "./tenant-capability-settings.js";
+export * from "./tenant-customers.js";
+export * from "./tenants.js";
+export * from "./user-roles.js";
+export * from "./webhook-seen-events.js";