@baasix/baasix 0.1.0

package/dist/utils/errorHandler.js

@@ -0,0 +1,79 @@
+/**
+ * API Error class for standardized error handling
+ */
+export class APIError extends Error {
+    statusCode;
+    isOperational;
+    details;
+    constructor(message, statusCode = 500, details = null) {
+        super(message);
+        this.name = 'APIError';
+        this.statusCode = statusCode;
+        this.details = details;
+        this.isOperational = true;
+        // Capture stack trace
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Error handler middleware
+ */
+export function errorHandler(error, req, res, next) {
+    // Check for APIError by instanceof OR by properties (handles npm link scenarios)
+    const isAPIError = error instanceof APIError ||
+        error.name === 'APIError' ||
+        (typeof error.statusCode === 'number' && error.isOperational);
+    if (isAPIError) {
+        const apiError = error;
+        res.status(apiError.statusCode).json({
+            error: {
+                message: apiError.message,
+                details: apiError.details,
+                statusCode: apiError.statusCode
+            }
+        });
+    }
+    else {
+        // Handle PostgreSQL/database errors
+        const pgError = error;
+        // Unique constraint violation (PostgreSQL error code 23505)
+        if (pgError.code === '23505' || pgError.message?.includes('unique constraint') || pgError.message?.includes('duplicate key')) {
+            return res.status(409).json({
+                error: {
+                    message: 'Unique constraint violation',
+                    details: pgError.detail || pgError.message || 'A record with this value already exists',
+                    statusCode: 409
+                }
+            });
+        }
+        // Foreign key constraint violation (PostgreSQL error code 23503)
+        if (pgError.code === '23503' || pgError.message?.includes('foreign key constraint')) {
+            return res.status(409).json({
+                error: {
+                    message: 'Foreign key constraint violation',
+                    details: pgError.detail || pgError.message || 'Referenced record does not exist',
+                    statusCode: 409
+                }
+            });
+        }
+        // Not null constraint violation (PostgreSQL error code 23502)
+        if (pgError.code === '23502' || pgError.message?.includes('not null constraint')) {
+            return res.status(400).json({
+                error: {
+                    message: 'Required field missing',
+                    details: pgError.column || pgError.message || 'A required field was not provided',
+                    statusCode: 400
+                }
+            });
+        }
+        console.error('Unexpected error:', error);
+        res.status(500).json({
+            error: {
+                message: 'Internal server error',
+                details: pgError.message || error.message || 'An unexpected error occurred',
+                statusCode: 500
+            }
+        });
+    }
+}
+//# sourceMappingURL=errorHandler.js.map

package/dist/utils/errorHandler.js.map

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

package/dist/utils/fieldExpansion.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Field Expansion Utility
+ *
+ * Matches Sequelize implementation 1:1
+ */
+export declare class FieldExpansionUtil {
+    /**
+     * Get column names for a collection
+     * Uses schemaDefinitions to get field names since $inferSelect doesn't work for dynamic schemas
+     */
+    private static getColumnNames;
+    /**
+     * Expand field selectors like ["*", "author.*", "-password"]
+     */
+    static expandFields(fields: string[], collectionName: string): string[];
+    /**
+     * Expand wildcard field patterns
+     */
+    private static expandWildcardField;
+    /**
+     * Remove redundant fields (e.g., if we have "author" and "author.name", keep only "author")
+     */
+    private static removeRedundantFields;
+    /**
+     * Check if a field should be included based on selectors
+     */
+    static shouldIncludeField(field: string, selectors: string[]): boolean;
+}
+export default FieldExpansionUtil;
+//# sourceMappingURL=fieldExpansion.d.ts.map

package/dist/utils/fieldExpansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldExpansion.d.ts","sourceRoot":"","sources":["../../baasix/utils/fieldExpansion.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,qBAAa,kBAAkB;IAC7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAmB7B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE;IA8BvE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA2ElC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAOpC;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO;CAWvE;AAED,eAAe,kBAAkB,CAAC"}

package/dist/utils/fieldExpansion.js

@@ -0,0 +1,145 @@
+import { schemaManager } from './schemaManager.js';
+import { relationBuilder } from './relationUtils.js';
+/**
+ * Field Expansion Utility
+ *
+ * Matches Sequelize implementation 1:1
+ */
+export class FieldExpansionUtil {
+    /**
+     * Get column names for a collection
+     * Uses schemaDefinitions to get field names since $inferSelect doesn't work for dynamic schemas
+     */
+    static getColumnNames(collectionName) {
+        // First try to get from schema definition (JSON schema)
+        const schemaDef = schemaManager.schemaDefinitions?.get(collectionName);
+        if (schemaDef && schemaDef.schema && schemaDef.schema.fields) {
+            // Filter out pure relation fields (those with relType but no type)
+            return Object.entries(schemaDef.schema.fields)
+                .filter(([_, fieldSchema]) => !fieldSchema.relType || fieldSchema.type)
+                .map(([fieldName]) => fieldName);
+        }
+        // Fallback to $inferSelect (works for pre-defined schemas)
+        const table = schemaManager.getTable(collectionName);
+        if (table.$inferSelect) {
+            return Object.keys(table.$inferSelect);
+        }
+        return [];
+    }
+    /**
+     * Expand field selectors like ["*", "author.*", "-password"]
+     */
+    static expandFields(fields, collectionName) {
+        let expandedFields = [];
+        try {
+            const tableColumns = this.getColumnNames(collectionName);
+            for (const field of fields) {
+                if (field === '*') {
+                    // Wildcard - add all direct fields
+                    expandedFields.push(...tableColumns);
+                }
+                else if (field.includes('*')) {
+                    // Wildcard field like "author.*"
+                    this.expandWildcardField(field, collectionName, expandedFields);
+                }
+                else {
+                    // Direct field
+                    expandedFields.push(field);
+                }
+            }
+            // Remove duplicates
+            expandedFields = [...new Set(expandedFields)];
+            // Remove redundant fields
+            return this.removeRedundantFields(expandedFields);
+        }
+        catch (error) {
+            console.error(`Error expanding fields for ${collectionName}:`, error);
+            return fields;
+        }
+    }
+    /**
+     * Expand wildcard field patterns
+     */
+    static expandWildcardField(field, collectionName, expandedFields, prefix = '') {
+        const parts = field.split('.');
+        try {
+            let currentCollection = collectionName;
+            let currentPrefix = prefix;
+            for (let i = 0; i < parts.length; i++) {
+                const part = parts[i];
+                if (part === '*') {
+                    // Get all fields at this level using our helper
+                    const tableColumns = this.getColumnNames(currentCollection);
+                    if (i === parts.length - 1) {
+                        // Last part is wildcard - expand all fields at this level
+                        expandedFields.push(...tableColumns.map((attr) => `${currentPrefix}${attr}`));
+                    }
+                    else {
+                        // Intermediate wildcard - expand fields and recurse for associations
+                        expandedFields.push(...tableColumns.map((attr) => `${currentPrefix}${attr}`));
+                        // Expand associations
+                        const associations = relationBuilder.getAssociations(currentCollection);
+                        if (associations) {
+                            for (const [associationName, association] of Object.entries(associations)) {
+                                this.expandWildcardField(parts.slice(i + 1).join('.'), association.model, expandedFields, `${currentPrefix}${associationName}.`);
+                            }
+                        }
+                    }
+                    break;
+                }
+                else {
+                    // Check if it's a field or association
+                    const tableColumns = this.getColumnNames(currentCollection);
+                    if (tableColumns.includes(part)) {
+                        // It's a field
+                        expandedFields.push(currentPrefix + part);
+                        break;
+                    }
+                    else {
+                        // Check if it's an association
+                        const associations = relationBuilder.getAssociations(currentCollection);
+                        const association = associations?.[part];
+                        if (association) {
+                            currentPrefix += part + '.';
+                            currentCollection = association.model;
+                            if (i === parts.length - 1) {
+                                // Last part is an association - include all its fields
+                                const assocColumns = this.getColumnNames(currentCollection);
+                                expandedFields.push(...assocColumns.map((attr) => `${currentPrefix}${attr}`));
+                            }
+                        }
+                        else {
+                            // Not a field or association - add as-is (might be computed field)
+                            expandedFields.push(currentPrefix + part);
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.error(`Error expanding wildcard field ${field}:`, error);
+        }
+    }
+    /**
+     * Remove redundant fields (e.g., if we have "author" and "author.name", keep only "author")
+     */
+    static removeRedundantFields(fields) {
+        return fields.filter((field, index, self) => index === self.findIndex((t) => t === field || t.startsWith(`${field}.`)));
+    }
+    /**
+     * Check if a field should be included based on selectors
+     */
+    static shouldIncludeField(field, selectors) {
+        // If wildcard is present, include all fields unless explicitly excluded
+        if (selectors.includes('*')) {
+            // Check for exclusions (fields starting with -)
+            const exclusions = selectors.filter((s) => s.startsWith('-')).map((s) => s.substring(1));
+            return !exclusions.includes(field);
+        }
+        // Check if field is in selectors
+        return selectors.includes(field);
+    }
+}
+export default FieldExpansionUtil;
+//# sourceMappingURL=fieldExpansion.js.map

package/dist/utils/fieldExpansion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldExpansion.js","sourceRoot":"","sources":["../../baasix/utils/fieldExpansion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;GAIG;AAEH,MAAM,OAAO,kBAAkB;IAC7B;;;OAGG;IACK,MAAM,CAAC,cAAc,CAAC,cAAsB;QAClD,wDAAwD;QACxD,MAAM,SAAS,GAAI,aAAqB,CAAC,iBAAiB,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;QAChF,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC7D,mEAAmE;YACnE,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;iBAC3C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAgB,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC;iBACrF,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;QACrC,CAAC;QAED,2DAA2D;QAC3D,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACrD,IAAK,KAAa,CAAC,YAAY,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,IAAI,CAAE,KAAa,CAAC,YAAY,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAgB,EAAE,cAAsB;QAC1D,IAAI,cAAc,GAAa,EAAE,CAAC;QAElC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;YAEzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;oBAClB,mCAAmC;oBACnC,cAAc,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;gBACvC,CAAC;qBAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/B,iCAAiC;oBACjC,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;gBAClE,CAAC;qBAAM,CAAC;oBACN,eAAe;oBACf,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;YAED,oBAAoB;YACpB,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;YAE9C,0BAA0B;YAC1B,OAAO,IAAI,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,cAAc,GAAG,EAAE,KAAK,CAAC,CAAC;YACtE,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,mBAAmB,CAChC,KAAa,EACb,cAAsB,EACtB,cAAwB,EACxB,SAAiB,EAAE;QAEnB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,CAAC;YACH,IAAI,iBAAiB,GAAG,cAAc,CAAC;YACvC,IAAI,aAAa,GAAG,MAAM,CAAC;YAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAEtB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;oBACjB,gDAAgD;oBAChD,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;oBAE5D,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC3B,0DAA0D;wBAC1D,cAAc,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,aAAa,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;oBAChF,CAAC;yBAAM,CAAC;wBACN,qEAAqE;wBACrE,cAAc,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,aAAa,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;wBAE9E,sBAAsB;wBACtB,MAAM,YAAY,GAAG,eAAe,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;wBACxE,IAAI,YAAY,EAAE,CAAC;4BACjB,KAAK,MAAM,CAAC,eAAe,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gCAC1E,IAAI,CAAC,mBAAmB,CACtB,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAC5B,WAAW,CAAC,KAAK,EACjB,cAAc,EACd,GAAG,aAAa,GAAG,eAAe,GAAG,CACtC,CAAC;4BACJ,CAAC;wBACH,CAAC;oBACH,CAAC;oBACD,MAAM;gBACR,CAAC;qBAAM,CAAC;oBACN,uCAAuC;oBACvC,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;oBAE5D,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;wBAChC,eAAe;wBACf,cAAc,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;wBAC1C,MAAM;oBACR,CAAC;yBAAM,CAAC;wBACN,+BAA+B;wBAC/B,MAAM,YAAY,GAAG,eAAe,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC;wBACxE,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;wBAEzC,IAAI,WAAW,EAAE,CAAC;4BAChB,aAAa,IAAI,IAAI,GAAG,GAAG,CAAC;4BAC5B,iBAAiB,GAAG,WAAW,CAAC,KAAK,CAAC;4BAEtC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gCAC3B,uDAAuD;gCACvD,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;gCAC5D,cAAc,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,aAAa,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;4BAChF,CAAC;wBACH,CAAC;6BAAM,CAAC;4BACN,mEAAmE;4BACnE,cAAc,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;4BAC1C,MAAM;wBACR,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,qBAAqB,CAAC,MAAgB;QACnD,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACrB,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAC5E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAa,EAAE,SAAmB;QAC1D,wEAAwE;QACxE,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,gDAAgD;YAChD,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACzF,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,iCAAiC;QACjC,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF;AAED,eAAe,kBAAkB,CAAC"}

package/dist/utils/fieldUtils.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Field Utilities
+ *
+ * Consolidated utilities for field validation, processing, and manipulation.
+ * Brings together scattered field-related functions into a single module.
+ */
+import type { FieldInfo, FlattenedField } from '../types/index.js';
+export type { FieldInfo, FlattenedField };
+/**
+ * Field utilities object
+ */
+declare const fieldUtils: {
+    /**
+     * Get flattened list of all fields in a collection, including nested relations
+     * @param collectionName - Name of the collection
+     * @param prefix - Prefix for nested fields (used in recursion)
+     * @param visited - Set of visited collections to prevent circular references
+     * @returns Array of flattened field objects
+     *
+     * @example
+     * ```typescript
+     * const fields = fieldUtils.getFlattenedFields('users');
+     * // Returns: [
+     * //   { name: 'id', fullPath: 'id', type: 'integer', isRelation: false },
+     * //   { name: 'email', fullPath: 'email', type: 'string', isRelation: false },
+     * //   { name: 'posts', fullPath: 'posts', type: 'o2m', isRelation: true, relationCollection: 'posts' },
+     * //   { name: 'title', fullPath: 'posts.title', type: 'string', isRelation: false }
+     * // ]
+     * ```
+     */
+    getFlattenedFields(collectionName: string, prefix?: string, visited?: Set<string>): FlattenedField[];
+    /**
+     * Validate if a field exists in a collection
+     * @param collectionName - Name of the collection
+     * @param fieldPath - Field path (can include dots for nested fields)
+     * @returns True if field exists
+     *
+     * @example
+     * ```typescript
+     * fieldUtils.fieldExists('users', 'email'); // true
+     * fieldUtils.fieldExists('users', 'posts.title'); // true (if relation exists)
+     * fieldUtils.fieldExists('users', 'nonexistent'); // false
+     * ```
+     */
+    fieldExists(collectionName: string, fieldPath: string): boolean;
+    /**
+     * Get field type
+     * @param collectionName - Name of the collection
+     * @param fieldPath - Field path
+     * @returns Field type or null if not found
+     */
+    getFieldType(collectionName: string, fieldPath: string): string | null;
+    /**
+     * Validate field permissions for a user
+     * @param collectionName - Name of the collection
+     * @param fieldNames - Array of field names to check
+     * @param userPermissions - User's permissions object
+     * @returns Object with allowed and denied fields
+     *
+     * @example
+     * ```typescript
+     * const result = fieldUtils.validateFieldPermissions('users', ['email', 'password'], userPerms);
+     * // { allowed: ['email'], denied: ['password'] }
+     * ```
+     */
+    validateFieldPermissions(collectionName: string, fieldNames: string[], userPermissions: Record<string, any>): {
+        allowed: string[];
+        denied: string[];
+    };
+    /**
+     * Get required fields for a collection
+     * @param collectionName - Name of the collection
+     * @returns Array of required field names
+     */
+    getRequiredFields(collectionName: string): string[];
+    /**
+     * Get unique fields for a collection
+     * @param collectionName - Name of the collection
+     * @returns Array of unique field names
+     */
+    getUniqueFields(collectionName: string): string[];
+    /**
+     * Filter object to only include specified fields
+     * @param data - Data object
+     * @param allowedFields - Array of allowed field names
+     * @returns Filtered object
+     *
+     * @example
+     * ```typescript
+     * const data = { id: 1, email: 'test@test.com', password: 'secret' };
+     * const safe = fieldUtils.filterFields(data, ['id', 'email']);
+     * // { id: 1, email: 'test@test.com' }
+     * ```
+     */
+    filterFields<T extends Record<string, any>>(data: T, allowedFields: string[]): Partial<T>;
+    /**
+     * Remove specified fields from object
+     * @param data - Data object
+     * @param excludeFields - Array of field names to exclude
+     * @returns Object without excluded fields
+     */
+    excludeFields<T extends Record<string, any>>(data: T, excludeFields: string[]): Partial<T>;
+    /**
+     * Validate required fields are present in data
+     * @param collectionName - Name of the collection
+     * @param data - Data object to validate
+     * @returns Object with isValid flag and missing fields
+     */
+    validateRequiredFields(collectionName: string, data: Record<string, any>): {
+        isValid: boolean;
+        missing: string[];
+    };
+    /**
+     * Get default values for fields that have them
+     * @param collectionName - Name of the collection
+     * @returns Object with field names and default values
+     */
+    getDefaultValues(collectionName: string): Record<string, any>;
+    /**
+     * Apply default values to data object
+     * @param collectionName - Name of the collection
+     * @param data - Data object
+     * @returns Data object with defaults applied
+     */
+    applyDefaults(collectionName: string, data: Record<string, any>): Record<string, any>;
+    /**
+     * Get system fields (created_at, updated_at, deleted_at, etc.)
+     * @param collectionName - Name of the collection
+     * @returns Array of system field names
+     */
+    getSystemFields(collectionName: string): string[];
+    /**
+     * Get user-defined fields (excludes system fields)
+     * @param collectionName - Name of the collection
+     * @returns Array of user-defined field names
+     */
+    getUserFields(collectionName: string): string[];
+    /**
+     * Sanitize field name for safe use in queries
+     * @param fieldName - Field name to sanitize
+     * @returns Sanitized field name
+     */
+    sanitizeFieldName(fieldName: string): string;
+    /**
+     * Parse field path into parts
+     * @param fieldPath - Field path (e.g., "user.posts.title")
+     * @returns Array of path parts
+     */
+    parseFieldPath(fieldPath: string): string[];
+    /**
+     * Build field path from parts
+     * @param parts - Array of path parts
+     * @returns Field path string
+     */
+    buildFieldPath(parts: string[]): string;
+    /**
+     * Get list of hidden fields in a collection
+     * Hidden fields should never be returned in API responses
+     * @param collectionName - Name of the collection
+     * @returns Array of hidden field names
+     */
+    getHiddenFields(collectionName: string): string[];
+    /**
+     * Strip hidden fields from a record
+     * @param collectionName - Name of the collection
+     * @param record - Record to strip hidden fields from
+     * @returns Record without hidden fields
+     */
+    stripHiddenFields<T extends Record<string, any>>(collectionName: string, record: T): T;
+    /**
+     * Strip hidden fields from an array of records
+     * @param collectionName - Name of the collection
+     * @param records - Array of records to strip hidden fields from
+     * @returns Array of records without hidden fields
+     */
+    stripHiddenFieldsFromRecords<T extends Record<string, any>>(collectionName: string, records: T[]): T[];
+};
+export default fieldUtils;
+//# sourceMappingURL=fieldUtils.d.ts.map

package/dist/utils/fieldUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldUtils.d.ts","sourceRoot":"","sources":["../../baasix/utils/fieldUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AAE1C;;GAEG;AACH,QAAA,MAAM,UAAU;IACd;;;;;;;;;;;;;;;;;OAiBG;uCAEe,MAAM,WACd,MAAM,YACL,GAAG,CAAC,MAAM,CAAC,GACnB,cAAc,EAAE;IAgEnB;;;;;;;;;;;;OAYG;gCACyB,MAAM,aAAa,MAAM,GAAG,OAAO;IAyB/D;;;;;OAKG;iCAC0B,MAAM,aAAa,MAAM,GAAG,MAAM,GAAG,IAAI;IAqCtE;;;;;;;;;;;;OAYG;6CAEe,MAAM,cACV,MAAM,EAAE,mBACH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACnC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA8B1C;;;;OAIG;sCAC+B,MAAM,GAAG,MAAM,EAAE;IAiBnD;;;;OAIG;oCAC6B,MAAM,GAAG,MAAM,EAAE;IAiBjD;;;;;;;;;;;;OAYG;iBACU,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAClC,CAAC,iBACQ,MAAM,EAAE,GACtB,OAAO,CAAC,CAAC,CAAC;IAYb;;;;;OAKG;kBACW,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QACnC,CAAC,iBACQ,MAAM,EAAE,GACtB,OAAO,CAAC,CAAC,CAAC;IAUb;;;;;OAKG;2CAEe,MAAM,QAChB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAgB1C;;;;OAIG;qCAC8B,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAiB7D;;;;;OAKG;kCAC2B,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAarF;;;;OAIG;oCAC6B,MAAM,GAAG,MAAM,EAAE;IAWjD;;;;OAIG;kCAC2B,MAAM,GAAG,MAAM,EAAE;IAU/C;;;;OAIG;iCAC0B,MAAM,GAAG,MAAM;IAK5C;;;;OAIG;8BACuB,MAAM,GAAG,MAAM,EAAE;IAI3C;;;;OAIG;0BACmB,MAAM,EAAE,GAAG,MAAM;IAIvC;;;;;OAKG;oCAC6B,MAAM,GAAG,MAAM,EAAE;IAejD;;;;;OAKG;sBACe,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAC7B,MAAM,UACd,CAAC,GACR,CAAC;IAaJ;;;;;OAKG;iCAC0B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBACxC,MAAM,WACb,CAAC,EAAE,GACX,CAAC,EAAE;CAcP,CAAC;AAEF,eAAe,UAAU,CAAC"}