@soulbatical/tetra-core 0.1.8 → 0.1.9

package/dist/shared/affiliate/affiliateFeatureConfig.js

@@ -0,0 +1,242 @@
+export const defaultAffiliateFeatureConfig = {
+    // ─── Database ───────────────────────────────────────────
+    tableName: 'affiliates',
+    organizationIdField: 'organization_id',
+    // ─── RPC (v3.0 Window Function Pattern) ─────────────────
+    countsRpcName: 'get_affiliates_counts',
+    resultsRpcName: 'get_affiliates_results',
+    // ─── Search ─────────────────────────────────────────────
+    searchFields: ['contact_name', 'email', 'company_name', 'referral_code'],
+    // ─── Sorting ────────────────────────────────────────────
+    defaultSortField: 'created_at',
+    allowedSortFields: ['created_at', 'contact_name', 'email', 'total_sales', 'total_revenue', 'total_commission_earned'],
+    sortFields: [
+        {
+            field: 'created_at',
+            alias: 'date',
+            label: 'Join Date',
+            defaultDirection: 'desc',
+            ui: { ascLabel: 'Oldest first', descLabel: 'Newest first' },
+        },
+        {
+            field: 'contact_name',
+            alias: 'name',
+            label: 'Name',
+            defaultDirection: 'asc',
+            ui: { ascLabel: 'A-Z', descLabel: 'Z-A' },
+        },
+        {
+            field: 'total_sales',
+            alias: 'sales',
+            label: 'Sales',
+            defaultDirection: 'desc',
+            ui: { ascLabel: 'Low to High', descLabel: 'High to Low' },
+        },
+        {
+            field: 'total_revenue',
+            alias: 'revenue',
+            label: 'Revenue',
+            defaultDirection: 'desc',
+            ui: { ascLabel: 'Low to High', descLabel: 'High to Low' },
+        },
+        {
+            field: 'total_commission_earned',
+            alias: 'commission',
+            label: 'Commission',
+            defaultDirection: 'desc',
+            ui: { ascLabel: 'Low to High', descLabel: 'High to Low' },
+        },
+    ],
+    // ─── Pagination ─────────────────────────────────────────
+    pagination: {
+        defaultLimit: 20,
+        maxLimit: 100,
+        minLimit: 1,
+    },
+    // ─── Includes ───────────────────────────────────────────
+    includeMapping: {
+        users_public: {
+            foreignKey: 'affiliates_user_id_fkey',
+            tableName: 'users_public',
+            fields: ['id', 'firstname', 'lastname', 'email'],
+        },
+        organization: {
+            foreignKey: 'affiliates_organization_id_fkey',
+            tableName: 'organizations',
+            fields: ['id', 'name', 'custom_domain', 'slug'],
+        },
+    },
+    // ─── Filters ────────────────────────────────────────────
+    filters: [
+        {
+            name: 'ids',
+            type: 'array',
+            dbField: 'id',
+            rpcParam: 'ids',
+        },
+        {
+            name: 'status',
+            type: 'enum',
+            column: 'status',
+            values: ['pending', 'active', 'inactive', 'rejected'],
+            countsKey: 'byStatus',
+            ui: {
+                label: 'Status',
+                placeholder: 'Filter by status...',
+                options: [
+                    { value: 'all', label: 'All Statuses' },
+                    { value: 'pending', label: 'Pending Approval' },
+                    { value: 'active', label: 'Active' },
+                    { value: 'inactive', label: 'Inactive' },
+                    { value: 'rejected', label: 'Rejected' },
+                ],
+                order: 1,
+                defaultVisible: true,
+            },
+        },
+        {
+            name: 'tier',
+            type: 'enum',
+            column: 'tier',
+            values: ['starter', 'active'],
+            countsKey: 'byTier',
+            ui: {
+                label: 'Tier',
+                placeholder: 'Filter by tier...',
+                options: [
+                    { value: 'all', label: 'All Tiers' },
+                    { value: 'starter', label: 'Starter' },
+                    { value: 'active', label: 'Active' },
+                ],
+                order: 2,
+                defaultVisible: true,
+            },
+        },
+        {
+            name: 'search',
+            type: 'search',
+            sqlGeneration: {
+                searchFields: ['contact_name', 'email', 'company_name', 'referral_code'],
+            },
+            ui: {
+                label: 'Search',
+                placeholder: 'Search by name, email, company, or code...',
+                order: 0,
+                defaultVisible: true,
+            },
+        },
+        {
+            name: 'has_user',
+            type: 'nullable',
+            column: 'user_id',
+            countsKey: 'byUserAccount',
+            ui: {
+                label: 'User Account',
+                placeholder: 'Filter by user account...',
+                options: [
+                    { value: 'all', label: 'All Affiliates' },
+                    { value: 'with', label: 'With User Account' },
+                    { value: 'without', label: 'Without User Account' },
+                ],
+                order: 3,
+                defaultVisible: false,
+            },
+        },
+        {
+            name: 'time_period',
+            type: 'time',
+            dateField: 'created_at',
+            rpcParam: 'time_period',
+            countsKey: 'byTimePeriod',
+            ui: {
+                label: 'Join Date',
+                placeholder: 'Filter by join date...',
+                options: [
+                    { value: 'all', label: 'All Time' },
+                    { value: 'this-week', label: 'Last 7 Days' },
+                    { value: 'this-month', label: 'Last 30 Days' },
+                    { value: 'older', label: 'Older than 30 Days' },
+                ],
+                order: 4,
+                defaultVisible: false,
+            },
+        },
+    ],
+    // ─── Counts ─────────────────────────────────────────────
+    counts: {
+        total: { type: 'total' },
+        byStatus: { type: 'breakdown', column: 'status' },
+        byTier: { type: 'breakdown', column: 'tier' },
+        withUserAccount: { type: 'nullable', column: 'user_id', mode: 'with' },
+        withoutUserAccount: { type: 'nullable', column: 'user_id', mode: 'without' },
+        thisWeek: { type: 'time', period: 'week', column: 'created_at' },
+        thisMonth: { type: 'time', period: 'month', column: 'created_at' },
+        older: { type: 'time', period: 'older', column: 'created_at' },
+    },
+    // ─── Display ────────────────────────────────────────────
+    display: {
+        page: {
+            title: 'Affiliates',
+            entityName: 'affiliates',
+            entitySingular: 'affiliate',
+            entityPlural: 'affiliates',
+            createButton: {
+                label: 'Add Affiliate',
+                dialog: 'CreateAffiliateDialog',
+            },
+            viewModes: ['list'],
+            byIdsInclude: 'users_public',
+        },
+        list: {
+            type: 'grid',
+            emptyMessage: 'No affiliates found matching your filters',
+        },
+        card: {
+            title: {
+                template: '{{contact_name}}',
+                fallback: '{{email}}',
+            },
+            badges: [
+                {
+                    field: 'status',
+                    variantMap: {
+                        active: 'default',
+                        pending: 'secondary',
+                        inactive: 'outline',
+                        rejected: 'destructive',
+                    },
+                },
+                {
+                    field: 'tier',
+                    variant: 'outline',
+                },
+            ],
+            metadata: [
+                {
+                    type: 'text',
+                    field: 'email',
+                    className: 'text-sm text-gray-600',
+                },
+                {
+                    type: 'text',
+                    field: 'company_name',
+                    className: 'text-sm font-medium',
+                    showIf: { field: 'company_name', condition: 'exists' },
+                },
+                {
+                    type: 'text',
+                    template: 'Code: {{referral_code}}',
+                    className: 'text-xs text-gray-500 font-mono',
+                },
+                {
+                    type: 'text',
+                    template: '{{total_sales}} sales | {{total_revenue}} revenue',
+                    className: 'text-xs text-gray-500',
+                },
+            ],
+            navigationPanels: ['users_public'],
+            actions: [],
+        },
+    },
+};
+//# sourceMappingURL=affiliateFeatureConfig.js.map

package/dist/shared/affiliate/affiliateFeatureConfig.js.map

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

package/dist/shared/affiliate/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Affiliate Module — Barrel Export
+ *
+ * @module @soulbatical/tetra-core/affiliate
+ */
+export { AffiliateAttributionService } from './AffiliateAttributionService.js';
+export { AffiliateClickService } from './AffiliateClickService.js';
+export { defaultAffiliateFeatureConfig } from './affiliateFeatureConfig.js';
+export { addAffiliateAdminRoutes, addAffiliateUserRoutes, addAffiliatePublicRoutes } from './routes.js';
+export type { AffiliateConfig, AffiliateTierConfig, AffiliateAttribution, AffiliateOrder, Affiliate, AffiliateCommission, AffiliateClick, AffiliatePayment, AffiliateTierHistory, AffiliateFilters, AffiliateDashboard, AffiliateDashboardStats, AffiliateDashboardCommission, AffiliateTierProgress, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/affiliate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/affiliate/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAG5E,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAGxG,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/shared/affiliate/index.js

@@ -0,0 +1,13 @@
+/**
+ * Affiliate Module — Barrel Export
+ *
+ * @module @soulbatical/tetra-core/affiliate
+ */
+// Services
+export { AffiliateAttributionService } from './AffiliateAttributionService.js';
+export { AffiliateClickService } from './AffiliateClickService.js';
+// Config
+export { defaultAffiliateFeatureConfig } from './affiliateFeatureConfig.js';
+// Routes
+export { addAffiliateAdminRoutes, addAffiliateUserRoutes, addAffiliatePublicRoutes } from './routes.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/affiliate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/affiliate/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,WAAW;AACX,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,SAAS;AACT,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAE5E,SAAS;AACT,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/shared/affiliate/routes.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Affiliate Route Helpers
+ *
+ * Factory functions that generate standard affiliate routes.
+ * Projects call these in their route setup to get admin, user, and public endpoints.
+ *
+ * Usage:
+ * ```typescript
+ * import { addAffiliateAdminRoutes, addAffiliatePublicRoutes } from '@soulbatical/tetra-core';
+ *
+ * // In admin routes file:
+ * const router = Router();
+ * router.use(authenticateToken, requireOrganizationAdmin);
+ * addAffiliateAdminRoutes(router, { featureConfig, queryController, filterController, crudController });
+ *
+ * // In public routes file:
+ * const publicRouter = Router();
+ * addAffiliatePublicRoutes(publicRouter, { config: { defaultCommissionPercentage: 20, ... } });
+ * ```
+ *
+ * @module @soulbatical/tetra-core/affiliate
+ */
+import { Router, Request, Response } from 'express';
+import type { SupabaseClient } from '@supabase/supabase-js';
+import type { FeatureConfig } from '../types/feature-config.js';
+import type { AffiliateConfig } from './types.js';
+interface PublicRouteOptions {
+    /** Affiliate config for defaults */
+    config?: Partial<AffiliateConfig>;
+    /** Function to get systemDB client */
+    getSystemDB: () => SupabaseClient;
+    /** Function to resolve organization_id from request (for multi-tenant) */
+    resolveOrganizationId?: (req: Request) => Promise<string | null>;
+}
+/**
+ * Add public affiliate routes (no auth required).
+ *
+ * Routes:
+ * - POST /click — Register affiliate click
+ * - POST /apply — Submit affiliate application
+ */
+export declare function addAffiliatePublicRoutes(router: Router, options: PublicRouteOptions): void;
+interface UserRouteOptions {
+    /** Function to get a Supabase client for the authenticated user */
+    getUserDB: (req: any) => Promise<SupabaseClient>;
+    /** Tier config for progress calculation */
+    tiers?: AffiliateConfig['tiers'];
+}
+/**
+ * Add user affiliate routes (authenticated user).
+ *
+ * Routes:
+ * - GET /dashboard — Dashboard stats
+ * - GET /profile — Affiliate profile
+ * - GET /commissions — Commission history
+ */
+export declare function addAffiliateUserRoutes(router: Router, options: UserRouteOptions): void;
+interface AdminRouteOptions {
+    /** FeatureConfig for the affiliate feature */
+    featureConfig: FeatureConfig;
+    /** Query controller (auto-bound via BaseQueryController) */
+    queryController: any;
+    /** Filter controller (created via createFilterConfigController) */
+    filterController: any;
+    /** CRUD controller with create/update/delete methods */
+    crudController: {
+        create: (req: any, res: Response) => Promise<any>;
+        update: (req: any, res: Response) => Promise<any>;
+        delete: (req: any, res: Response) => Promise<any>;
+    };
+}
+/**
+ * Add admin affiliate routes (requires admin auth).
+ *
+ * Routes:
+ * - POST / — Create affiliate
+ * - PUT /:id — Update affiliate
+ * - DELETE /:id — Delete affiliate
+ * - GET /filters — Filter configurations
+ * - GET /by-ids — Get by IDs
+ * - GET /counts — Get counts
+ * - GET / — List affiliates
+ * - GET /:id — Get single affiliate
+ */
+export declare function addAffiliateAdminRoutes(router: Router, options: AdminRouteOptions): void;
+export {};
+//# sourceMappingURL=routes.d.ts.map

package/dist/shared/affiliate/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/shared/affiliate/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAgB,MAAM,SAAS,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAUlD,UAAU,kBAAkB;IAC1B,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,sCAAsC;IACtC,WAAW,EAAE,MAAM,cAAc,CAAC;IAClC,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CA8NN;AAID,UAAU,gBAAgB;IACxB,mEAAmE;IACnE,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACjD,2CAA2C;IAC3C,KAAK,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAmJN;AAID,UAAU,iBAAiB;IACzB,8CAA8C;IAC9C,aAAa,EAAE,aAAa,CAAC;IAC7B,4DAA4D;IAC5D,eAAe,EAAE,GAAG,CAAC;IACrB,mEAAmE;IACnE,gBAAgB,EAAE,GAAG,CAAC;IACtB,wDAAwD;IACxD,cAAc,EAAE;QACd,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACnD,CAAC;CACH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAqBN"}