@soulbatical/tetra-core 0.1.0

package/dist/frontend/hooks/useFeature.js

@@ -0,0 +1,354 @@
+/**
+ * useFeature() — Config-driven React hook for feature data management
+ *
+ * Replaces ALL per-feature hooks (useOrdersList, useOrdersCounts, useVouchersList, etc.)
+ * with a single generic hook driven by FeatureConfig.
+ *
+ * Before (100+ lines boilerplate PER feature):
+ *   const { items } = useOrdersList(filters);
+ *   const { data: counts } = useOrdersCounts(filters);
+ *
+ * After (ZERO boilerplate):
+ *   const { data, counts, ... } = useFeature(ordersConfig, supabase);
+ *
+ * @module @tetra/core/frontend
+ * Created: February 20, 2026
+ */
+import { useState, useCallback, useMemo, useEffect, useRef } from 'react';
+// ─── Filter Defaults ────────────────────────────────────────
+function buildFilterDefaults(config) {
+    const defaults = {};
+    for (const filter of config.filters || []) {
+        if (filter.ui?.defaultValue !== undefined) {
+            defaults[filter.name] = filter.ui.defaultValue;
+        }
+        else {
+            defaults[filter.name] = 'all';
+        }
+    }
+    return defaults;
+}
+// ─── RPC Parameter Builder ──────────────────────────────────
+function buildRpcParams(filters, config, options) {
+    const params = {};
+    // Organization ID
+    if (options.organizationId) {
+        params.p_org_id = options.organizationId;
+    }
+    // Pagination
+    params.p_limit = options.limit;
+    params.p_offset = options.offset;
+    // Sorting
+    params.p_sort_field = options.sortField;
+    params.p_sort_direction = options.sortDirection;
+    // Search — use debounced value, respect min length
+    const searchValue = options.debouncedSearch ?? filters.search;
+    if (searchValue && searchValue.trim().length >= options.minSearchLength) {
+        params.p_search = searchValue.trim();
+    }
+    else {
+        params.p_search = null;
+    }
+    // Map all filters from config
+    for (const filter of config.filters || []) {
+        if (filter.type === 'search')
+            continue; // handled above
+        // Skip filters with custom RPC functions
+        if (filter.rpcFunction)
+            continue;
+        const value = filters[filter.name];
+        const rpcParamName = filter.rpcParam || filter.name;
+        const paramKey = `p_${rpcParamName}`;
+        // 'all' → null
+        if (value === 'all') {
+            params[paramKey] = null;
+            continue;
+        }
+        // undefined → null
+        if (value === undefined) {
+            params[paramKey] = null;
+            continue;
+        }
+        // Array values
+        if (Array.isArray(value)) {
+            params[paramKey] = value.length > 0 ? value : null;
+            continue;
+        }
+        // Single value
+        params[paramKey] = value;
+    }
+    return params;
+}
+function buildCountsRpcParams(filters, config, options) {
+    const params = {};
+    if (options.organizationId) {
+        params.p_org_id = options.organizationId;
+    }
+    // Search
+    const searchValue = options.debouncedSearch ?? filters.search;
+    if (searchValue && searchValue.trim().length >= options.minSearchLength) {
+        params.p_search = searchValue.trim();
+    }
+    else {
+        params.p_search = null;
+    }
+    // Map filters (same as results but without pagination/sorting)
+    for (const filter of config.filters || []) {
+        if (filter.type === 'search')
+            continue;
+        if (filter.rpcFunction)
+            continue;
+        const value = filters[filter.name];
+        const rpcParamName = filter.rpcParam || filter.name;
+        const paramKey = `p_${rpcParamName}`;
+        if (value === 'all' || value === undefined) {
+            params[paramKey] = null;
+            continue;
+        }
+        if (Array.isArray(value)) {
+            params[paramKey] = value.length > 0 ? value : null;
+            continue;
+        }
+        params[paramKey] = value;
+    }
+    return params;
+}
+// ─── Debounce Hook ──────────────────────────────────────────
+function useDebounce(value, delay) {
+    const [debouncedValue, setDebouncedValue] = useState(value);
+    useEffect(() => {
+        const timer = setTimeout(() => setDebouncedValue(value), delay);
+        return () => clearTimeout(timer);
+    }, [value, delay]);
+    return debouncedValue;
+}
+// ─── Main Hook ──────────────────────────────────────────────
+/**
+ * useFeature — Universal hook for config-driven feature data
+ *
+ * @param config - FeatureConfig with resultsRpcName and/or countsRpcName
+ * @param supabase - Supabase client instance
+ * @param options - Optional configuration
+ *
+ * @example
+ * ```tsx
+ * import { ordersConfig } from '@/config/features/orders.config';
+ * import { useFeature } from '@tetra/core/frontend';
+ *
+ * function OrdersPage() {
+ *   const {
+ *     data, counts, loading, error,
+ *     filters, setFilter, resetFilters,
+ *     page, setPage, pageCount,
+ *     sortField, sortDirection, setSort,
+ *     refetch
+ *   } = useFeature(ordersConfig, supabase, {
+ *     organizationId: user.organizationId,
+ *     pageSize: 25,
+ *   });
+ *
+ *   return <FeatureTable config={ordersConfig} data={data} />;
+ * }
+ * ```
+ */
+export function useFeature(config, supabase, options = {}) {
+    const { enabled = true, pageSize: initialPageSize, initialFilters, initialSortField, initialSortDirection = 'desc', searchDebounceMs = 300, minSearchLength = 2, organizationId, } = options;
+    // ─── Derived Defaults ─────────────────────────────
+    const defaultPageSize = initialPageSize ?? config.pagination?.defaultLimit ?? 20;
+    const defaultSortField = initialSortField ?? config.defaultSortField ?? 'created_at';
+    const filterDefaults = useMemo(() => ({
+        ...buildFilterDefaults(config),
+        ...initialFilters,
+    }), [config, initialFilters]);
+    // ─── State ────────────────────────────────────────
+    const [filters, setFiltersState] = useState(filterDefaults);
+    const [page, setPage] = useState(0);
+    const [pageSize] = useState(defaultPageSize);
+    const [sortField, setSortField] = useState(defaultSortField);
+    const [sortDirection, setSortDirection] = useState(initialSortDirection);
+    const [data, setData] = useState([]);
+    const [totalCount, setTotalCount] = useState(0);
+    const [counts, setCounts] = useState({});
+    const [loading, setLoading] = useState(false);
+    const [countsLoading, setCountsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    // Track mounted state for async safety
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => { mountedRef.current = false; };
+    }, []);
+    // Debounce search
+    const searchValue = filters.search || '';
+    const debouncedSearch = useDebounce(searchValue, searchDebounceMs);
+    // ─── Fetch Data ───────────────────────────────────
+    const fetchData = useCallback(async () => {
+        if (!enabled || !config.resultsRpcName)
+            return;
+        setLoading(true);
+        setError(null);
+        try {
+            const rpcParams = buildRpcParams(filters, config, {
+                organizationId,
+                limit: pageSize,
+                offset: page * pageSize,
+                sortField,
+                sortDirection,
+                debouncedSearch,
+                minSearchLength,
+            });
+            const { data: result, error: rpcError } = await supabase.rpc(config.resultsRpcName, rpcParams);
+            if (!mountedRef.current)
+                return;
+            if (rpcError) {
+                setError(rpcError.message);
+                setData([]);
+                setTotalCount(0);
+                return;
+            }
+            // Handle response: could be array of items, or object with items + total
+            if (Array.isArray(result)) {
+                setData(result);
+                // If the RPC returns a total_count in the first row (window function pattern)
+                if (result.length > 0 && 'total_count' in result[0]) {
+                    setTotalCount(result[0].total_count);
+                }
+            }
+            else if (result && typeof result === 'object') {
+                // Object response: { items: [], total: N }
+                const items = result.items || result.data || [];
+                setData(items);
+                setTotalCount(result.total || result.total_count || items.length);
+            }
+            else {
+                setData([]);
+                setTotalCount(0);
+            }
+        }
+        catch (err) {
+            if (!mountedRef.current)
+                return;
+            setError(err instanceof Error ? err.message : 'Failed to fetch data');
+            setData([]);
+        }
+        finally {
+            if (mountedRef.current) {
+                setLoading(false);
+            }
+        }
+    }, [
+        enabled, config, supabase, filters, organizationId,
+        pageSize, page, sortField, sortDirection, debouncedSearch, minSearchLength,
+    ]);
+    // ─── Fetch Counts ─────────────────────────────────
+    const fetchCounts = useCallback(async () => {
+        if (!enabled || !config.countsRpcName)
+            return;
+        setCountsLoading(true);
+        try {
+            const rpcParams = buildCountsRpcParams(filters, config, {
+                organizationId,
+                debouncedSearch,
+                minSearchLength,
+            });
+            const { data: result, error: rpcError } = await supabase.rpc(config.countsRpcName, rpcParams);
+            if (!mountedRef.current)
+                return;
+            if (rpcError) {
+                setCounts({});
+                return;
+            }
+            // Counts RPC typically returns a single object with total + breakdowns
+            if (result && typeof result === 'object' && !Array.isArray(result)) {
+                setCounts(result);
+                // Also update totalCount from counts if available
+                if ('total' in result) {
+                    setTotalCount(result.total);
+                }
+            }
+            else if (Array.isArray(result) && result.length === 1) {
+                // Some RPCs return single-row array
+                setCounts(result[0]);
+                if ('total' in result[0]) {
+                    setTotalCount(result[0].total);
+                }
+            }
+            else {
+                setCounts({});
+            }
+        }
+        catch {
+            if (mountedRef.current) {
+                setCounts({});
+            }
+        }
+        finally {
+            if (mountedRef.current) {
+                setCountsLoading(false);
+            }
+        }
+    }, [enabled, config, supabase, filters, organizationId, debouncedSearch, minSearchLength]);
+    // ─── Effects ──────────────────────────────────────
+    useEffect(() => {
+        fetchData();
+    }, [fetchData]);
+    useEffect(() => {
+        fetchCounts();
+    }, [fetchCounts]);
+    // ─── Filter Actions ───────────────────────────────
+    const setFilter = useCallback((name, value) => {
+        setFiltersState(prev => ({ ...prev, [name]: value }));
+        setPage(0); // Reset to first page on filter change
+    }, []);
+    const setFilters = useCallback((newFilters) => {
+        setFiltersState(prev => ({ ...prev, ...newFilters }));
+        setPage(0);
+    }, []);
+    const resetFilters = useCallback(() => {
+        setFiltersState(filterDefaults);
+        setPage(0);
+    }, [filterDefaults]);
+    // ─── Sort Action ──────────────────────────────────
+    const setSort = useCallback((field, direction) => {
+        setSortField(field);
+        if (direction) {
+            setSortDirection(direction);
+        }
+        else {
+            // Toggle direction if same field, default to desc for new field
+            setSortDirection(prev => field === sortField ? (prev === 'asc' ? 'desc' : 'asc') : 'desc');
+        }
+        setPage(0);
+    }, [sortField]);
+    // ─── Refetch ──────────────────────────────────────
+    const refetch = useCallback(async () => {
+        await Promise.all([fetchData(), fetchCounts()]);
+    }, [fetchData, fetchCounts]);
+    // ─── Computed ─────────────────────────────────────
+    const pageCount = Math.max(1, Math.ceil(totalCount / pageSize));
+    const hasPreviousPage = page > 0;
+    const hasNextPage = page < pageCount - 1;
+    return {
+        data,
+        totalCount,
+        counts,
+        loading,
+        countsLoading,
+        error,
+        filters,
+        setFilter,
+        setFilters,
+        resetFilters,
+        page,
+        setPage,
+        sortField,
+        sortDirection,
+        setSort,
+        refetch,
+        pageCount,
+        hasPreviousPage,
+        hasNextPage,
+        pageSize,
+    };
+}
+//# sourceMappingURL=useFeature.js.map

package/dist/frontend/hooks/useFeature.js.map

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

package/dist/frontend/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @tetra/core/frontend — React hooks and components for config-driven features
+ *
+ * Usage:
+ * ```typescript
+ * import { useFeature, FeatureTable } from '@tetra/core/frontend';
+ * // or via main entry:
+ * import { useFeature, FeatureTable } from '@tetra/core';
+ * ```
+ */
+export { useFeature } from './hooks/useFeature.js';
+export type { UseFeatureOptions, UseFeatureResult } from './hooks/useFeature.js';
+export { FeatureTable } from './components/FeatureTable.js';
+export type { FeatureTableProps, CellRendererMap } from './components/FeatureTable.js';
+export { FeatureFilters } from './components/FeatureFilters.js';
+export type { FeatureFiltersProps } from './components/FeatureFilters.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/frontend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEvF,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/frontend/index.js

@@ -0,0 +1,14 @@
+/**
+ * @tetra/core/frontend — React hooks and components for config-driven features
+ *
+ * Usage:
+ * ```typescript
+ * import { useFeature, FeatureTable } from '@tetra/core/frontend';
+ * // or via main entry:
+ * import { useFeature, FeatureTable } from '@tetra/core';
+ * ```
+ */
+export { useFeature } from './hooks/useFeature.js';
+export { FeatureTable } from './components/FeatureTable.js';
+export { FeatureFilters } from './components/FeatureFilters.js';
+//# sourceMappingURL=index.js.map

package/dist/frontend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/frontend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @tetra/core — The foundation framework for platform projects
+ *
+ * Config-driven Express + Supabase + TypeScript
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   // Types
+ *   FeatureConfig, AuthenticatedRequest,
+ *   // Controllers
+ *   BaseQueryController, BaseMutationController, createFilterConfigController,
+ *   // Factories
+ *   createQueryService, addQueryRoutes, addMutationRoutes, addBatchRoutes, addPhaseRoutes,
+ *   // Services
+ *   SimpleRPCQueryService, BaseCronService, CronRegistry,
+ *   // Middleware
+ *   authenticateToken, configureAuth, validateQueryParams,
+ *   // Utils
+ *   createLogger, RFC7807ErrorResponse,
+ *   // DB
+ *   createSupabaseClient,
+ *   // Validators
+ *   validateUUID, validateOrganization,
+ * } from '@tetra/core';
+ * ```
+ */
+export type { FeatureConfig, FilterConfig, FilterUIConfig, CountConfig, CountConfigItem, ComputedFieldConfig, SQLComputedFieldConfig, ValidatorMapping, SortFieldConfig, PaginationConfig, EnrichmentConfig, DisplayConfig, PageDisplayConfig, ListDisplayConfig, CardDisplayConfig, CardAction, CreatorVisibilityConfig, ColumnConfig, FormFieldConfig } from './shared/types/feature-config.js';
+export { generateValidators } from './shared/types/feature-config.js';
+export type { IncludeConfig, QueryConfig } from './shared/types/query-config.js';
+export type { AutoBoundQueryController, MethodNamesConfig } from './shared/controllers/types.js';
+export type { CustomValidators, QueryRouteConfig, MutationRouteConfig, PhaseRouteConfig, BatchRouteConfig, BatchOperation } from './shared/factories/types.js';
+export type { RFC7807ProblemDetails } from './shared/rfc7807ErrorResponse.js';
+export { BaseQueryController } from './shared/controllers/BaseQueryController.js';
+export { BaseMutationController } from './shared/controllers/BaseMutationController.js';
+export { createFilterConfigController } from './shared/controllers/FilterConfigController.js';
+export { createQueryService, createQueryServiceInstance } from './shared/factories/QueryServiceFactory.js';
+export type { InferFilters, InferItem, CountsResult } from './shared/factories/QueryServiceFactory.js';
+export { addQueryRoutes, getFactoryWarnings } from './shared/factories/QueryRouteFactory.js';
+export { addMutationRoutes } from './shared/factories/MutationRouteFactory.js';
+export { addBatchRoutes } from './shared/factories/BatchRouteFactory.js';
+export { addPhaseRoutes } from './shared/factories/PhaseRouteFactory.js';
+export { SimpleRPCQueryService } from './shared/services/SimpleRPCQueryService.js';
+export { BaseCronService } from './shared/services/BaseCronService.js';
+export type { CronServiceConfig as CronConfig, CronJobResult } from './shared/services/BaseCronService.js';
+export { BasePhaseService } from './shared/services/BasePhaseService.js';
+export type { BatchUpdateResult, PhaseUpdateData, PhaseUpdateResult } from './shared/services/BasePhaseService.js';
+export { CronRegistry } from './shared/services/CronRegistry.js';
+export { authenticateToken, authenticateTokenOnly, optionalAuth, requireSuperAdmin, requireOrgAdmin, requireOrganizationAdmin, requireRole, validateOrganizationAccess, configureAuth } from './middleware/authMiddleware.js';
+export type { AuthenticatedRequest, AuthenticatedUser, UserContext, AuthConfig } from './middleware/authMiddleware.js';
+export { validateQueryParams, sanitizeSearchTerm, validatePagination, validateSort, validateFields } from './middleware/validateQueryParams.js';
+export { registerFeatureValidators, batchRegisterValidators } from './middleware/autoRegisterValidators.js';
+export { createLogger, rootLogger } from './utils/logger.js';
+export type { Logger } from './utils/logger.js';
+export { RFC7807ErrorResponse } from './shared/rfc7807ErrorResponse.js';
+export { parseQueryFromConfig, parseFiltersFromConfig, mapFiltersToRPC, validateFilters, getFilterDefaults, parsePaginationParams, parseSortingFromConfig, parseIncludesFromConfig } from './shared/utils/config-driven-filters.js';
+export type { ParsedFilters, PaginationParams, SortingParams, ParsedQuery, GenerateFiltersFromConfig } from './shared/utils/config-driven-filters.js';
+export { handleControllerError, withErrorHandling } from './shared/utils/controllerErrorHandler.js';
+export { parseIncludeParam } from './shared/utils/parseInclude.js';
+export { getValidatedQuery, parseQueryParams } from './shared/utils/queryHelpers.js';
+export { mapCountsFromRPC } from './shared/utils/response-mapper.js';
+export { buildPaginatedResponse, buildSingleResponse, buildErrorResponse } from './shared/utils/responseBuilder.js';
+export type { PaginationMeta, ResponseOptions } from './shared/utils/responseBuilder.js';
+export { validateUUID, validateUUIDOrThrow, validateUUIDs, filterValidUUIDs } from './shared/validators/uuidValidator.js';
+export { validateOrganization, validateOrganizationOrRespond, hasOrganization } from './shared/validators/organizationValidator.js';
+export type { ContentOwnershipType, UserRole, OwnershipFieldMapping, EntityOwnershipConfig, OwnershipValidationResult, OwnershipUserContext } from './shared/ownership/types.js';
+export { useFeature } from './frontend/hooks/useFeature.js';
+export type { UseFeatureOptions, UseFeatureResult } from './frontend/hooks/useFeature.js';
+export { FeatureTable } from './frontend/components/FeatureTable.js';
+export type { FeatureTableProps, CellRendererMap } from './frontend/components/FeatureTable.js';
+export { publicDB } from './core/publicDb.js';
+export { systemDB, addWhitelistedContexts } from './core/systemDb.js';
+export { adminDB } from './core/adminDb.js';
+export { userDB } from './core/userDb.js';
+export { superadminDB } from './core/superadminDb.js';
+export { webhookDB } from './core/webhookDb.js';
+export { SupabaseUserClient } from './core/SupabaseUserClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,71 @@
+/**
+ * @tetra/core — The foundation framework for platform projects
+ *
+ * Config-driven Express + Supabase + TypeScript
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   // Types
+ *   FeatureConfig, AuthenticatedRequest,
+ *   // Controllers
+ *   BaseQueryController, BaseMutationController, createFilterConfigController,
+ *   // Factories
+ *   createQueryService, addQueryRoutes, addMutationRoutes, addBatchRoutes, addPhaseRoutes,
+ *   // Services
+ *   SimpleRPCQueryService, BaseCronService, CronRegistry,
+ *   // Middleware
+ *   authenticateToken, configureAuth, validateQueryParams,
+ *   // Utils
+ *   createLogger, RFC7807ErrorResponse,
+ *   // DB
+ *   createSupabaseClient,
+ *   // Validators
+ *   validateUUID, validateOrganization,
+ * } from '@tetra/core';
+ * ```
+ */
+export { generateValidators } from './shared/types/feature-config.js';
+// ─── Controllers ────────────────────────────────────────────
+export { BaseQueryController } from './shared/controllers/BaseQueryController.js';
+export { BaseMutationController } from './shared/controllers/BaseMutationController.js';
+export { createFilterConfigController } from './shared/controllers/FilterConfigController.js';
+// ─── Factories ──────────────────────────────────────────────
+export { createQueryService, createQueryServiceInstance } from './shared/factories/QueryServiceFactory.js';
+export { addQueryRoutes, getFactoryWarnings } from './shared/factories/QueryRouteFactory.js';
+export { addMutationRoutes } from './shared/factories/MutationRouteFactory.js';
+export { addBatchRoutes } from './shared/factories/BatchRouteFactory.js';
+export { addPhaseRoutes } from './shared/factories/PhaseRouteFactory.js';
+// ─── Services ───────────────────────────────────────────────
+export { SimpleRPCQueryService } from './shared/services/SimpleRPCQueryService.js';
+export { BaseCronService } from './shared/services/BaseCronService.js';
+export { BasePhaseService } from './shared/services/BasePhaseService.js';
+export { CronRegistry } from './shared/services/CronRegistry.js';
+// ─── Middleware ──────────────────────────────────────────────
+export { authenticateToken, authenticateTokenOnly, optionalAuth, requireSuperAdmin, requireOrgAdmin, requireOrganizationAdmin, requireRole, validateOrganizationAccess, configureAuth } from './middleware/authMiddleware.js';
+export { validateQueryParams, sanitizeSearchTerm, validatePagination, validateSort, validateFields } from './middleware/validateQueryParams.js';
+export { registerFeatureValidators, batchRegisterValidators } from './middleware/autoRegisterValidators.js';
+// ─── Utils ──────────────────────────────────────────────────
+export { createLogger, rootLogger } from './utils/logger.js';
+export { RFC7807ErrorResponse } from './shared/rfc7807ErrorResponse.js';
+export { parseQueryFromConfig, parseFiltersFromConfig, mapFiltersToRPC, validateFilters, getFilterDefaults, parsePaginationParams, parseSortingFromConfig, parseIncludesFromConfig } from './shared/utils/config-driven-filters.js';
+export { handleControllerError, withErrorHandling } from './shared/utils/controllerErrorHandler.js';
+export { parseIncludeParam } from './shared/utils/parseInclude.js';
+export { getValidatedQuery, parseQueryParams } from './shared/utils/queryHelpers.js';
+export { mapCountsFromRPC } from './shared/utils/response-mapper.js';
+export { buildPaginatedResponse, buildSingleResponse, buildErrorResponse } from './shared/utils/responseBuilder.js';
+// ─── Validators ─────────────────────────────────────────────
+export { validateUUID, validateUUIDOrThrow, validateUUIDs, filterValidUUIDs } from './shared/validators/uuidValidator.js';
+export { validateOrganization, validateOrganizationOrRespond, hasOrganization } from './shared/validators/organizationValidator.js';
+// ─── Frontend (React hooks + components) ─────────────────────
+export { useFeature } from './frontend/hooks/useFeature.js';
+export { FeatureTable } from './frontend/components/FeatureTable.js';
+// ─── Core (DB clients) ─────────────────────────────────────
+export { publicDB } from './core/publicDb.js';
+export { systemDB, addWhitelistedContexts } from './core/systemDb.js';
+export { adminDB } from './core/adminDb.js';
+export { userDB } from './core/userDb.js';
+export { superadminDB } from './core/superadminDb.js';
+export { webhookDB } from './core/webhookDb.js';
+export { SupabaseUserClient } from './core/SupabaseUserClient.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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