@soulbatical/tetra-core 0.1.0

package/dist/shared/utils/parseInclude.js

@@ -0,0 +1,28 @@
+/**
+ * Parse ?include= query parameter
+ *
+ * Supports: ?include=booktemplate,humandesignchart,productionitem
+ * Returns array of include strings
+ *
+ * @example
+ * parseIncludeParam('users,orders') // ['users', 'orders']
+ * parseIncludeParam(['users', 'orders']) // ['users', 'orders']
+ * parseIncludeParam(undefined) // []
+ */
+export function parseIncludeParam(include) {
+    if (!include)
+        return [];
+    // Handle array (already parsed by Express)
+    if (Array.isArray(include)) {
+        return include.filter((item) => typeof item === 'string');
+    }
+    // Handle comma-separated string
+    if (typeof include === 'string') {
+        return include
+            .split(',')
+            .map(s => s.trim())
+            .filter(s => s.length > 0);
+    }
+    return [];
+}
+//# sourceMappingURL=parseInclude.js.map

package/dist/shared/utils/parseInclude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseInclude.js","sourceRoot":"","sources":["../../../src/shared/utils/parseInclude.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAyE;IACzG,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,2CAA2C;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAa,CAAC;IACxF,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO;aACX,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/shared/utils/queryHelpers.d.ts

@@ -0,0 +1,62 @@
+interface RequestWithValidatedQuery {
+    validatedQuery?: any;
+    query: any;
+}
+type AuthenticatedRequest = RequestWithValidatedQuery;
+/**
+ * Query Parameter Extraction Utilities
+ *
+ * Provides consistent fallback between validatedQuery and query
+ * Prevents inconsistent query parameter handling across controllers
+ */
+/**
+ * Get query parameters with fallback to validated query
+ *
+ * Use this at the start of controller methods for consistent behavior
+ *
+ * @param req - Authenticated request
+ * @returns Query parameters (validated if available, otherwise raw)
+ *
+ * @example
+ * const querySource = getValidatedQuery(req);
+ * const { limit = 50, offset = 0, search } = querySource;
+ */
+export declare function getValidatedQuery(req: AuthenticatedRequest): any;
+/**
+ * Parse query parameters with defaults
+ *
+ * Merges default values with query parameters
+ *
+ * @param query - Query object (from req.query or req.validatedQuery)
+ * @param defaults - Default values for parameters
+ * @returns Merged parameters with defaults
+ *
+ * @example
+ * const params = parseQueryParams(req.query, {
+ *   limit: 50,
+ *   offset: 0,
+ *   sortBy: 'created_at'
+ * });
+ * // Returns: { limit: 50, offset: 0, sortBy: 'created_at', ...req.query }
+ */
+export declare function parseQueryParams<T extends Record<string, any>>(query: any, defaults: T): T;
+/**
+ * Parse pagination parameters from query
+ *
+ * Extracts and validates limit/offset with defaults
+ *
+ * @param query - Query object
+ * @param defaultLimit - Default limit (default: 50)
+ * @param maxLimit - Maximum allowed limit (default: 100)
+ * @returns Pagination parameters
+ *
+ * @example
+ * const { limit, offset } = parsePaginationParams(req.query);
+ * // Returns: { limit: 50, offset: 0 } (or values from query)
+ */
+export declare function parsePaginationParams(query: any, defaultLimit?: number, maxLimit?: number): {
+    limit: number;
+    offset: number;
+};
+export {};
+//# sourceMappingURL=queryHelpers.d.ts.map

package/dist/shared/utils/queryHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryHelpers.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/queryHelpers.ts"],"names":[],"mappings":"AAAA,UAAU,yBAAyB;IACjC,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC;CACZ;AAED,KAAK,oBAAoB,GAAG,yBAAyB,CAAC;AAEtD;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,oBAAoB,GAAG,GAAG,CAEhE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5D,KAAK,EAAE,GAAG,EACV,QAAQ,EAAE,CAAC,GACV,CAAC,CAEH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,GAAG,EACV,YAAY,GAAE,MAAW,EACzB,QAAQ,GAAE,MAAY,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQnC"}

package/dist/shared/utils/queryHelpers.js

@@ -0,0 +1,61 @@
+/**
+ * Query Parameter Extraction Utilities
+ *
+ * Provides consistent fallback between validatedQuery and query
+ * Prevents inconsistent query parameter handling across controllers
+ */
+/**
+ * Get query parameters with fallback to validated query
+ *
+ * Use this at the start of controller methods for consistent behavior
+ *
+ * @param req - Authenticated request
+ * @returns Query parameters (validated if available, otherwise raw)
+ *
+ * @example
+ * const querySource = getValidatedQuery(req);
+ * const { limit = 50, offset = 0, search } = querySource;
+ */
+export function getValidatedQuery(req) {
+    return req.validatedQuery || req.query;
+}
+/**
+ * Parse query parameters with defaults
+ *
+ * Merges default values with query parameters
+ *
+ * @param query - Query object (from req.query or req.validatedQuery)
+ * @param defaults - Default values for parameters
+ * @returns Merged parameters with defaults
+ *
+ * @example
+ * const params = parseQueryParams(req.query, {
+ *   limit: 50,
+ *   offset: 0,
+ *   sortBy: 'created_at'
+ * });
+ * // Returns: { limit: 50, offset: 0, sortBy: 'created_at', ...req.query }
+ */
+export function parseQueryParams(query, defaults) {
+    return { ...defaults, ...query };
+}
+/**
+ * Parse pagination parameters from query
+ *
+ * Extracts and validates limit/offset with defaults
+ *
+ * @param query - Query object
+ * @param defaultLimit - Default limit (default: 50)
+ * @param maxLimit - Maximum allowed limit (default: 100)
+ * @returns Pagination parameters
+ *
+ * @example
+ * const { limit, offset } = parsePaginationParams(req.query);
+ * // Returns: { limit: 50, offset: 0 } (or values from query)
+ */
+export function parsePaginationParams(query, defaultLimit = 50, maxLimit = 100) {
+    const limit = Math.min(parseInt(String(query.limit)) || defaultLimit, maxLimit);
+    const offset = parseInt(String(query.offset)) || 0;
+    return { limit, offset };
+}
+//# sourceMappingURL=queryHelpers.js.map

package/dist/shared/utils/queryHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryHelpers.js","sourceRoot":"","sources":["../../../src/shared/utils/queryHelpers.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAyB;IACzD,OAAO,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,KAAK,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAU,EACV,QAAW;IAEX,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAU,EACV,eAAuB,EAAE,EACzB,WAAmB,GAAG;IAEtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,YAAY,EAC7C,QAAQ,CACT,CAAC;IACF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;IAEnD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/shared/utils/response-mapper.d.ts

@@ -0,0 +1,42 @@
+/**
+ * response-mapper.ts
+ *
+ * Generic response mapper for config-driven counts responses.
+ * Keeps RPC JSON structure nested - NO FLATTENING!
+ *
+ * ✅ Works for ALL features (orders, vouchers, products, etc.)
+ * ✅ 100% config-driven - no hardcoding
+ * ✅ Single source of truth
+ * ✅ Consistent nested format: byXxx: { option1: count1, option2: count2 }
+ */
+import { FeatureConfig } from '../types/feature-config.js';
+/**
+ * Map RPC counts response to API response format
+ *
+ * ✨ ENFORCES POSTGRESQL STANDARD: snake_case keys in RPC (SQL industry standard)
+ *
+ * RPC MUST return snake_case keys, mapper transforms to option.value for frontend:
+ * - Enum filters: byStatus: { 'paid': 10, 'pending': 0 } → API: { paid: 10, pending: 0 }
+ * - Related filters: byVoucher: { 'with': 10, 'without': 0 } → API: { with: 10, without: 0 }
+ * - Time filters: byTimePeriod: { 'this_week': 10, 'this_month': 20 } → API: { 'this-week': 10, 'this-month': 20 }
+ *
+ * ✅ STRICT VALIDATION - Fails fast with clear error if RPC keys don't match expected format
+ *
+ * @param rpcData - Raw data from RPC function (snake_case keys)
+ * @param featureConfig - Feature configuration with filter definitions
+ * @returns Nested response object (option.value keys for frontend)
+ * @throws Error if RPC missing required counts or using wrong key format
+ */
+export declare function mapCountsFromRPC(rpcData: any, featureConfig: FeatureConfig): Record<string, any>;
+/**
+ * Example usage:
+ *
+ * // In OrderQueryService:
+ * const rpcData = await this.supabase.rpc('get_order_counts_simple', rpcParams);
+ * return mapCountsFromRPC(rpcData, ordersFeatureConfig);
+ *
+ * // Works for ANY feature!
+ * const rpcData = await this.supabase.rpc('get_voucher_counts_simple', rpcParams);
+ * return mapCountsFromRPC(rpcData, vouchersFeatureConfig);
+ */
+//# sourceMappingURL=response-mapper.d.ts.map

package/dist/shared/utils/response-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-mapper.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/response-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAgB,MAAM,4BAA4B,CAAC;AA0BzE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,GAAG,EACZ,aAAa,EAAE,aAAa,GAC3B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAyIrB;AAED;;;;;;;;;;GAUG"}

package/dist/shared/utils/response-mapper.js

@@ -0,0 +1,176 @@
+/**
+ * response-mapper.ts
+ *
+ * Generic response mapper for config-driven counts responses.
+ * Keeps RPC JSON structure nested - NO FLATTENING!
+ *
+ * ✅ Works for ALL features (orders, vouchers, products, etc.)
+ * ✅ 100% config-driven - no hardcoding
+ * ✅ Single source of truth
+ * ✅ Consistent nested format: byXxx: { option1: count1, option2: count2 }
+ */
+import { createLogger } from '../../utils/logger.js';
+const logger = createLogger('utils:response-mapper');
+/**
+ * Capitalize first letter of string
+ */
+// Removed unused capitalize function
+/**
+ * Convert option.value (kebab-case) to RPC key (snake_case)
+ *
+ * PostgreSQL Standard: Database functions use snake_case (industry standard for SQL)
+ * Config uses kebab-case for UI ('this-week'), RPC uses snake_case ('this_week')
+ *
+ * Examples:
+ * - 'this-week' → 'this_week'
+ * - 'with' → 'with' (no change)
+ * - 'paid' → 'paid' (no change)
+ */
+function optionValueToRpcKey(optionValue) {
+    return optionValue.replace(/-/g, '_');
+}
+/**
+ * Map RPC counts response to API response format
+ *
+ * ✨ ENFORCES POSTGRESQL STANDARD: snake_case keys in RPC (SQL industry standard)
+ *
+ * RPC MUST return snake_case keys, mapper transforms to option.value for frontend:
+ * - Enum filters: byStatus: { 'paid': 10, 'pending': 0 } → API: { paid: 10, pending: 0 }
+ * - Related filters: byVoucher: { 'with': 10, 'without': 0 } → API: { with: 10, without: 0 }
+ * - Time filters: byTimePeriod: { 'this_week': 10, 'this_month': 20 } → API: { 'this-week': 10, 'this-month': 20 }
+ *
+ * ✅ STRICT VALIDATION - Fails fast with clear error if RPC keys don't match expected format
+ *
+ * @param rpcData - Raw data from RPC function (snake_case keys)
+ * @param featureConfig - Feature configuration with filter definitions
+ * @returns Nested response object (option.value keys for frontend)
+ * @throws Error if RPC missing required counts or using wrong key format
+ */
+export function mapCountsFromRPC(rpcData, featureConfig) {
+    if (!rpcData) {
+        logger.warn('No RPC data provided to mapper');
+        return { total: 0 };
+    }
+    const result = {
+        total: rpcData.total || 0
+    };
+    logger.debug({
+        filterCount: featureConfig.filters.length,
+        rpcKeys: Object.keys(rpcData)
+    }, '🗺️  Mapping RPC response to API format');
+    // Process each filter in config
+    featureConfig.filters.forEach((filter) => {
+        const countsKey = filter.countsKey;
+        if (!countsKey) {
+            // Filter has no counts (e.g., search filter)
+            return;
+        }
+        const countsData = rpcData[countsKey];
+        // ✨ UNIVERSAL PATTERN - Works for ALL filter types!
+        // Initialize all options from config with 0, then merge RPC data
+        // RPC: { byXxx: { option1: 10 } }
+        // API: { byXxx: { option1: 10, option2: 0, option3: 0 } }
+        if (!filter.ui?.options) {
+            // No options defined - just copy data as-is
+            result[countsKey] = countsData || {};
+            logger.debug({ filter: filter.name, countsKey }, '✅ Mapped filter (no options)');
+            return;
+        }
+        // Initialize with 0 for all defined options
+        const initializedCounts = {};
+        filter.ui.options.forEach(option => {
+            // Skip 'all' option - it's not a real count
+            if (option.value === 'all')
+                return;
+            // ✅ KEEP EXACT MATCH - No transformation!
+            // AutoFilter does direct lookup: countsData[option.value]
+            // So keys MUST match option values exactly:
+            // 'this-week' → 'this-week', 'with' → 'with', 'paid' → 'paid'
+            const optionKey = option.value;
+            initializedCounts[optionKey] = 0;
+        });
+        // ✅ STRICT VALIDATION - Enforce industry standard (camelCase keys in JSON)
+        const transformedData = {};
+        if (countsData && typeof countsData === 'object') {
+            filter.ui.options.forEach(option => {
+                if (option.value === 'all')
+                    return;
+                const optionKey = option.value; // e.g., 'this-week', 'paid', 'with', 'EN-GB'
+                const rpcKey = optionValueToRpcKey(optionKey); // e.g., 'this_week', 'paid', 'with', 'EN_GB'
+                // ✅ RPC can return snake_case OR original keys (for special values like ISO language codes)
+                // Try snake_case first (PostgreSQL standard), then fallback to original key
+                const actualRpcKey = countsData[rpcKey] !== undefined ? rpcKey : optionKey;
+                if (countsData[actualRpcKey] === undefined) {
+                    // ❌ FAIL FAST - Missing count in RPC response!
+                    throw new Error(`❌ RPC response missing count for filter option!\n` +
+                        `Filter: "${filter.name}" (${filter.type})\n` +
+                        `Expected counts key: "${countsKey}"\n` +
+                        `Missing RPC key: "${rpcKey}" (for option "${optionKey}")\n` +
+                        `RPC returned keys in ${countsKey}: ${Object.keys(countsData).join(', ')}\n` +
+                        `\n` +
+                        `💡 FIX: Update your RPC function to use snake_case keys (PostgreSQL standard):\n` +
+                        `   ${countsKey}: jsonb_build_object(\n` +
+                        `     ${filter.ui.options.filter(o => o.value !== 'all').map(o => `'${optionValueToRpcKey(o.value)}', COUNT(...)`).join(',\n     ')}\n` +
+                        `   )\n` +
+                        `\n` +
+                        `   Example for your filter:\n` +
+                        `   ${countsKey}: jsonb_build_object('${rpcKey}', COUNT(...))`);
+                }
+                // Store with UI key (option.value) for frontend consistency
+                transformedData[optionKey] = countsData[actualRpcKey];
+            });
+        }
+        else if (filter.type !== 'search') {
+            // ❌ FAIL FAST - RPC missing entire counts object!
+            throw new Error(`❌ RPC response missing counts object!\n` +
+                `Filter: "${filter.name}" (${filter.type})\n` +
+                `Expected counts key: "${countsKey}"\n` +
+                `RPC returned keys: ${Object.keys(rpcData).join(', ')}\n` +
+                `\n` +
+                `💡 FIX: Update your RPC function to return (camelCase keys - industry standard):\n` +
+                `   ${countsKey}: jsonb_build_object(\n` +
+                `     ${filter.ui.options.filter(o => o.value !== 'all').map(o => `'${optionValueToRpcKey(o.value)}', COUNT(...)`).join(',\n     ')}\n` +
+                `   )`);
+        }
+        // Merge transformed RPC data with initialized counts
+        result[countsKey] = { ...initializedCounts, ...transformedData };
+        logger.debug({
+            filter: filter.name,
+            type: filter.type,
+            countsKey,
+            optionsCount: Object.keys(initializedCounts).length
+        }, '✅ Mapped filter (nested, zero-initialized)');
+    });
+    // ✨ ALSO MAP STANDALONE COUNTS (not tied to filters)
+    // These are passive counts that are always returned (e.g., time-based counts)
+    if (featureConfig.counts) {
+        Object.keys(featureConfig.counts).forEach(countKey => {
+            // Skip if already mapped from filter or is 'total'
+            if (countKey === 'total' || result[countKey] !== undefined) {
+                return;
+            }
+            // Copy standalone count directly from RPC response
+            if (rpcData[countKey] !== undefined) {
+                result[countKey] = rpcData[countKey];
+                logger.debug({ countKey, value: rpcData[countKey] }, '✅ Mapped standalone count');
+            }
+        });
+    }
+    logger.debug({
+        resultKeys: Object.keys(result),
+        total: result.total
+    }, '✅ Response mapping complete');
+    return result;
+}
+/**
+ * Example usage:
+ *
+ * // In OrderQueryService:
+ * const rpcData = await this.supabase.rpc('get_order_counts_simple', rpcParams);
+ * return mapCountsFromRPC(rpcData, ordersFeatureConfig);
+ *
+ * // Works for ANY feature!
+ * const rpcData = await this.supabase.rpc('get_voucher_counts_simple', rpcParams);
+ * return mapCountsFromRPC(rpcData, vouchersFeatureConfig);
+ */
+//# sourceMappingURL=response-mapper.js.map

package/dist/shared/utils/response-mapper.js.map

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

package/dist/shared/utils/responseBuilder.d.ts

@@ -0,0 +1,103 @@
+/**
+ * API Response Builder Utilities
+ *
+ * Provides consistent response format across all endpoints
+ * Prevents:
+ * - hasNextPage vs hasMore inconsistency
+ * - data: items vs data: { items } wrapping confusion
+ * - Missing/inconsistent pagination fields
+ * - Different message field usage
+ */
+export interface PaginationMeta {
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface ResponseOptions {
+    /**
+     * Wrap data in object with key
+     * @example { dataKey: 'books' } → data: { books: [...] }
+     * @example undefined → data: [...]
+     */
+    dataKey?: string;
+    /**
+     * Success message to include
+     * @example "Books retrieved successfully"
+     */
+    message?: string;
+    /**
+     * Include hasPreviousPage (default: true)
+     */
+    includePreviousPage?: boolean;
+}
+/**
+ * Build paginated API response with consistent format
+ *
+ * Standard format:
+ * {
+ *   success: true,
+ *   data: [...],
+ *   meta: {
+ *     total: 100,
+ *     limit: 20,
+ *     offset: 0,
+ *     hasMore: true,
+ *     hasNextPage: true,
+ *     hasPreviousPage: false
+ *   }
+ * }
+ *
+ * @param data - Array of items to return
+ * @param meta - Pagination metadata
+ * @param options - Optional customization
+ * @returns Standardized API response
+ *
+ * @example
+ * // Simple response
+ * buildPaginatedResponse(orders, { total: 100, limit: 20, offset: 0 })
+ *
+ * // With wrapped data
+ * buildPaginatedResponse(
+ *   books,
+ *   { total: 50, limit: 10, offset: 0 },
+ *   { dataKey: 'books', message: 'Books retrieved successfully' }
+ * )
+ */
+export declare function buildPaginatedResponse<T>(data: T[], meta: PaginationMeta, options?: ResponseOptions): any;
+/**
+ * Build single item response
+ *
+ * Standard format:
+ * {
+ *   success: true,
+ *   data: { ... }
+ * }
+ *
+ * @param data - Single item to return
+ * @param message - Optional success message
+ * @returns Standardized API response
+ *
+ * @example
+ * buildSingleResponse(order)
+ * buildSingleResponse(book, 'Book retrieved successfully')
+ */
+export declare function buildSingleResponse<T>(data: T, message?: string): any;
+/**
+ * Build error response (for RFC 7807 compliance, use RFC7807ErrorResponse instead)
+ *
+ * Simple error format:
+ * {
+ *   success: false,
+ *   message: "Error message"
+ * }
+ *
+ * @param message - Error message
+ * @param details - Optional error details
+ * @returns Standardized error response
+ *
+ * @example
+ * buildErrorResponse('Resource not found')
+ * buildErrorResponse('Validation failed', { field: 'email' })
+ */
+export declare function buildErrorResponse(message: string, details?: any): any;
+//# sourceMappingURL=responseBuilder.d.ts.map

package/dist/shared/utils/responseBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseBuilder.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/responseBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,IAAI,EAAE,CAAC,EAAE,EACT,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,eAAe,OAsC1B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,MAAM,OAYjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,GAAG,OAYd"}

package/dist/shared/utils/responseBuilder.js

@@ -0,0 +1,131 @@
+/**
+ * API Response Builder Utilities
+ *
+ * Provides consistent response format across all endpoints
+ * Prevents:
+ * - hasNextPage vs hasMore inconsistency
+ * - data: items vs data: { items } wrapping confusion
+ * - Missing/inconsistent pagination fields
+ * - Different message field usage
+ */
+/**
+ * Build paginated API response with consistent format
+ *
+ * Standard format:
+ * {
+ *   success: true,
+ *   data: [...],
+ *   meta: {
+ *     total: 100,
+ *     limit: 20,
+ *     offset: 0,
+ *     hasMore: true,
+ *     hasNextPage: true,
+ *     hasPreviousPage: false
+ *   }
+ * }
+ *
+ * @param data - Array of items to return
+ * @param meta - Pagination metadata
+ * @param options - Optional customization
+ * @returns Standardized API response
+ *
+ * @example
+ * // Simple response
+ * buildPaginatedResponse(orders, { total: 100, limit: 20, offset: 0 })
+ *
+ * // With wrapped data
+ * buildPaginatedResponse(
+ *   books,
+ *   { total: 50, limit: 10, offset: 0 },
+ *   { dataKey: 'books', message: 'Books retrieved successfully' }
+ * )
+ */
+export function buildPaginatedResponse(data, meta, options) {
+    const hasMore = meta.offset + meta.limit < meta.total;
+    const hasPreviousPage = meta.offset > 0;
+    const response = {
+        success: true
+    };
+    // Add optional message
+    if (options?.message) {
+        response.message = options.message;
+    }
+    // Wrap data if dataKey provided
+    if (options?.dataKey) {
+        response.data = {
+            [options.dataKey]: data
+        };
+    }
+    else {
+        response.data = data;
+    }
+    // Add pagination metadata
+    response.meta = {
+        total: meta.total,
+        limit: meta.limit,
+        offset: meta.offset,
+        hasMore,
+        hasNextPage: hasMore, // Include both for compatibility
+    };
+    // Add hasPreviousPage if requested (default: true)
+    if (options?.includePreviousPage !== false) {
+        response.meta.hasPreviousPage = hasPreviousPage;
+    }
+    return response;
+}
+/**
+ * Build single item response
+ *
+ * Standard format:
+ * {
+ *   success: true,
+ *   data: { ... }
+ * }
+ *
+ * @param data - Single item to return
+ * @param message - Optional success message
+ * @returns Standardized API response
+ *
+ * @example
+ * buildSingleResponse(order)
+ * buildSingleResponse(book, 'Book retrieved successfully')
+ */
+export function buildSingleResponse(data, message) {
+    const response = {
+        success: true,
+        data
+    };
+    if (message) {
+        response.message = message;
+    }
+    return response;
+}
+/**
+ * Build error response (for RFC 7807 compliance, use RFC7807ErrorResponse instead)
+ *
+ * Simple error format:
+ * {
+ *   success: false,
+ *   message: "Error message"
+ * }
+ *
+ * @param message - Error message
+ * @param details - Optional error details
+ * @returns Standardized error response
+ *
+ * @example
+ * buildErrorResponse('Resource not found')
+ * buildErrorResponse('Validation failed', { field: 'email' })
+ */
+export function buildErrorResponse(message, details) {
+    const response = {
+        success: false,
+        message
+    };
+    if (details) {
+        response.details = details;
+    }
+    return response;
+}
+//# sourceMappingURL=responseBuilder.js.map

package/dist/shared/utils/responseBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseBuilder.js","sourceRoot":"","sources":["../../../src/shared/utils/responseBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4BH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAS,EACT,IAAoB,EACpB,OAAyB;IAEzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACtD,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAExC,MAAM,QAAQ,GAAQ;QACpB,OAAO,EAAE,IAAI;KACd,CAAC;IAEF,uBAAuB;IACvB,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACrC,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,GAAG;YACd,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI;SACxB,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,GAAG;QACd,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO;QACP,WAAW,EAAE,OAAO,EAAE,iCAAiC;KACxD,CAAC;IAEF,mDAAmD;IACnD,IAAI,OAAO,EAAE,mBAAmB,KAAK,KAAK,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IAClD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAO,EACP,OAAgB;IAEhB,MAAM,QAAQ,GAAQ;QACpB,OAAO,EAAE,IAAI;QACb,IAAI;KACL,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC7B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,OAAa;IAEb,MAAM,QAAQ,GAAQ;QACpB,OAAO,EAAE,KAAK;QACd,OAAO;KACR,CAAC;IAEF,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;IAC7B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/shared/validators/featureConfigValidator.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Feature Config Validator
+ *
+ * Validates feature configurations at startup to catch common mistakes early.
+ * Runs during RouteManager initialization to fail fast with clear error messages.
+ */
+import { FeatureConfig } from '../types/feature-config.js';
+/**
+ * Register known wrong table name mappings for validation.
+ * @example addWrongTableNames({ 'userspublic': 'users_public' });
+ */
+export declare function addWrongTableNames(mappings: Record<string, string>): void;
+/**
+ * Validate a feature configuration
+ * @throws Error if validation fails (fail-fast approach)
+ */
+export declare function validateFeatureConfig(config: FeatureConfig, featureName: string): void;
+/**
+ * Validate all feature configs
+ * Call this during application startup
+ */
+export declare function validateAllFeatureConfigs(configs: Record<string, FeatureConfig>): void;
+//# sourceMappingURL=featureConfigValidator.d.ts.map

package/dist/shared/validators/featureConfigValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureConfigValidator.d.ts","sourceRoot":"","sources":["../../../src/shared/validators/featureConfigValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAU3D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEzE;AASD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAkHtF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,CAiBtF"}