@baasix/baasix 0.1.0

package/dist/utils/seed.js

@@ -0,0 +1,248 @@
+/**
+ * Database Seeding Utility
+ *
+ * Provides utilities for seeding the database with initial data.
+ * Useful for development, testing, and setting up new environments.
+ */
+import { ItemsService } from '../services/ItemsService.js';
+import { schemaManager } from './schemaManager.js';
+/**
+ * Seeding utility class
+ */
+class SeedUtility {
+    /**
+     * Seed a single collection
+     */
+    async seedCollection(options) {
+        const { collection, data, clearBefore = false, skipDuplicates = true } = options;
+        const result = {
+            collection,
+            created: 0,
+            skipped: 0,
+            errors: 0,
+            errorDetails: [],
+        };
+        try {
+            const service = new ItemsService(collection);
+            // Clear existing data if requested
+            if (clearBefore) {
+                console.log(`[Seed] Clearing existing data in ${collection}...`);
+                const existing = await service.readByQuery({});
+                for (const item of existing.data) {
+                    await service.deleteOne(item.id, { force: true });
+                }
+                console.log(`[Seed] Cleared ${existing.data.length} items from ${collection}`);
+            }
+            // Normalize data to array
+            const dataArray = Array.isArray(data) ? data : [data];
+            // Get unique fields for duplicate checking
+            const uniqueFields = skipDuplicates ? this.getUniqueFields(collection) : [];
+            // Seed each item
+            for (const item of dataArray) {
+                try {
+                    // Check for duplicates
+                    if (skipDuplicates && uniqueFields.length > 0) {
+                        const isDuplicate = await this.checkDuplicate(service, item, uniqueFields);
+                        if (isDuplicate) {
+                            result.skipped++;
+                            console.log(`[Seed] Skipped duplicate in ${collection}:`, item);
+                            continue;
+                        }
+                    }
+                    // Create item
+                    await service.createOne(item);
+                    result.created++;
+                }
+                catch (error) {
+                    result.errors++;
+                    result.errorDetails.push({
+                        item,
+                        error: error.message,
+                    });
+                    console.error(`[Seed] Error creating item in ${collection}:`, error.message);
+                }
+            }
+            console.log(`[Seed] Completed ${collection}: created=${result.created}, skipped=${result.skipped}, errors=${result.errors}`);
+            return result;
+        }
+        catch (error) {
+            console.error(`[Seed] Fatal error seeding ${collection}:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Seed multiple collections
+     */
+    async seedMultiple(seeds) {
+        const results = [];
+        console.log(`[Seed] Starting to seed ${seeds.length} collections...`);
+        for (const seed of seeds) {
+            const result = await this.seedCollection(seed);
+            results.push(result);
+        }
+        console.log('[Seed] All collections seeded successfully');
+        return results;
+    }
+    /**
+     * Get unique fields for a collection
+     */
+    getUniqueFields(collection) {
+        const schema = schemaManager.getSchema(collection);
+        if (!schema) {
+            return [];
+        }
+        const uniqueFields = [];
+        for (const [fieldName, fieldDef] of Object.entries(schema.columns)) {
+            const fieldDefTyped = fieldDef;
+            if (fieldDefTyped.isUnique || fieldDefTyped.primaryKey) {
+                uniqueFields.push(fieldName);
+            }
+        }
+        return uniqueFields;
+    }
+    /**
+     * Check if item already exists based on unique fields
+     */
+    async checkDuplicate(service, item, uniqueFields) {
+        for (const field of uniqueFields) {
+            if (field in item && item[field] != null) {
+                try {
+                    const existing = await service.readByQuery({
+                        filter: { [field]: item[field] },
+                        limit: 1,
+                    });
+                    if (existing.data.length > 0) {
+                        return true;
+                    }
+                }
+                catch {
+                    // Ignore errors
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Create seed data template for a collection
+     */
+    generateTemplate(collection, count = 5) {
+        const schema = schemaManager.getSchema(collection);
+        if (!schema) {
+            console.error(`Schema not found for collection: ${collection}`);
+            return [];
+        }
+        const templates = [];
+        for (let i = 0; i < count; i++) {
+            const template = {};
+            for (const [fieldName, fieldDef] of Object.entries(schema.columns)) {
+                const fieldDefTyped = fieldDef;
+                const dataType = fieldDefTyped.dataType;
+                // Skip auto-increment and timestamp fields
+                if (fieldDefTyped.primaryKey && fieldDefTyped.generated)
+                    continue;
+                if (['createdAt', 'updatedAt', 'deletedAt'].includes(fieldName))
+                    continue;
+                // Generate sample data based on type
+                template[fieldName] = this.generateSampleValue(fieldName, dataType, i);
+            }
+            templates.push(template);
+        }
+        return templates;
+    }
+    /**
+     * Generate sample value for a field
+     */
+    generateSampleValue(fieldName, dataType, index) {
+        const lowerFieldName = fieldName.toLowerCase();
+        // Generate based on field name
+        if (lowerFieldName.includes('email')) {
+            return `user${index + 1}@example.com`;
+        }
+        if (lowerFieldName.includes('name')) {
+            return `Sample Name ${index + 1}`;
+        }
+        if (lowerFieldName.includes('title')) {
+            return `Sample Title ${index + 1}`;
+        }
+        if (lowerFieldName.includes('description')) {
+            return `Sample description for item ${index + 1}`;
+        }
+        if (lowerFieldName.includes('url')) {
+            return `https://example.com/item-${index + 1}`;
+        }
+        if (lowerFieldName.includes('phone')) {
+            return `+1-555-${String(index + 1).padStart(4, '0')}`;
+        }
+        // Generate based on data type
+        switch (dataType) {
+            case 'string':
+            case 'text':
+                return `Sample ${fieldName} ${index + 1}`;
+            case 'integer':
+            case 'bigInteger':
+                return index + 1;
+            case 'float':
+            case 'decimal':
+                return (index + 1) * 1.5;
+            case 'boolean':
+                return index % 2 === 0;
+            case 'date':
+            case 'datetime':
+            case 'timestamp':
+                const date = new Date();
+                date.setDate(date.getDate() + index);
+                return date;
+            case 'json':
+            case 'jsonb':
+                return { sample: true, index: index + 1 };
+            case 'array':
+                return [`item${index + 1}`, `value${index + 1}`];
+            case 'uuid':
+                return null; // Let database generate
+            default:
+                return null;
+        }
+    }
+    /**
+     * Print seed summary
+     */
+    printSummary(results) {
+        console.log('\n' + '='.repeat(60));
+        console.log('SEED SUMMARY');
+        console.log('='.repeat(60));
+        let totalCreated = 0;
+        let totalSkipped = 0;
+        let totalErrors = 0;
+        for (const result of results) {
+            console.log(`\n${result.collection}:`);
+            console.log(`  Created: ${result.created}`);
+            console.log(`  Skipped: ${result.skipped}`);
+            console.log(`  Errors:  ${result.errors}`);
+            if (result.errorDetails.length > 0) {
+                console.log(`  Error Details:`);
+                for (const detail of result.errorDetails.slice(0, 3)) {
+                    console.log(`    - ${detail.error}`);
+                }
+                if (result.errorDetails.length > 3) {
+                    console.log(`    ... and ${result.errorDetails.length - 3} more`);
+                }
+            }
+            totalCreated += result.created;
+            totalSkipped += result.skipped;
+            totalErrors += result.errors;
+        }
+        console.log('\n' + '-'.repeat(60));
+        console.log(`TOTALS:`);
+        console.log(`  Collections: ${results.length}`);
+        console.log(`  Created:     ${totalCreated}`);
+        console.log(`  Skipped:     ${totalSkipped}`);
+        console.log(`  Errors:      ${totalErrors}`);
+        console.log('='.repeat(60) + '\n');
+    }
+}
+// Export singleton instance
+const seedUtility = new SeedUtility();
+export default seedUtility;
+// Export convenience functions
+export const { seedCollection, seedMultiple, generateTemplate, printSummary, } = seedUtility;
+//# sourceMappingURL=seed.js.map

package/dist/utils/seed.js.map

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

package/dist/utils/sessionCleanup.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Clean up expired sessions from the database
+ */
+declare function cleanupSessions(): Promise<number>;
+/**
+ * Start periodic cleanup of expired sessions
+ */
+export declare function startSessionCleanup(): void;
+export default cleanupSessions;
+//# sourceMappingURL=sessionCleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionCleanup.d.ts","sourceRoot":"","sources":["../../baasix/utils/sessionCleanup.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,iBAAe,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAgChD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAY1C;AAED,eAAe,eAAe,CAAC"}

package/dist/utils/sessionCleanup.js

@@ -0,0 +1,49 @@
+import { db } from './db.js';
+import { schemaManager } from './schemaManager.js';
+import { lt } from 'drizzle-orm';
+/**
+ * Clean up expired sessions from the database
+ */
+async function cleanupSessions() {
+    try {
+        const sessionsTable = schemaManager.getTable('baasix_Sessions');
+        if (!sessionsTable) {
+            console.warn('baasix_Sessions table not found, skipping session cleanup');
+            return 0;
+        }
+        // Delete sessions where expiresAt is less than current time
+        const expiresAtColumn = sessionsTable['expiresAt'];
+        if (!expiresAtColumn) {
+            console.warn('expiresAt column not found in baasix_Sessions, skipping cleanup');
+            return 0;
+        }
+        const result = await db
+            .delete(sessionsTable)
+            .where(lt(expiresAtColumn, new Date()));
+        const deletedCount = result.rowCount || 0;
+        if (deletedCount > 0) {
+            console.info(`Session cleanup: removed ${deletedCount} expired session(s)`);
+        }
+        return deletedCount;
+    }
+    catch (error) {
+        console.error('Error during session cleanup:', error.message);
+        return 0;
+    }
+}
+/**
+ * Start periodic cleanup of expired sessions
+ */
+export function startSessionCleanup() {
+    console.info('Session cleanup service started');
+    // Run initial cleanup after a short delay (to ensure tables are ready)
+    setTimeout(() => {
+        cleanupSessions();
+    }, 5000);
+    // Clean up every hour
+    setInterval(async () => {
+        await cleanupSessions();
+    }, 3600000); // Every hour
+}
+export default cleanupSessions;
+//# sourceMappingURL=sessionCleanup.js.map

package/dist/utils/sessionCleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionCleanup.js","sourceRoot":"","sources":["../../baasix/utils/sessionCleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEjC;;GAEG;AACH,KAAK,UAAU,eAAe;IAC5B,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAEhE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YAC1E,OAAO,CAAC,CAAC;QACX,CAAC;QAED,4DAA4D;QAC5D,MAAM,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;QAEnD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;YAChF,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,EAAE;aACpB,MAAM,CAAC,aAAa,CAAC;aACrB,KAAK,CAAC,EAAE,CAAC,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAE1C,MAAM,YAAY,GAAI,MAAc,CAAC,QAAQ,IAAI,CAAC,CAAC;QAEnD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,4BAA4B,YAAY,qBAAqB,CAAC,CAAC;QAC9E,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAEhD,uEAAuE;IACvE,UAAU,CAAC,GAAG,EAAE;QACd,eAAe,EAAE,CAAC;IACpB,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,sBAAsB;IACtB,WAAW,CAAC,KAAK,IAAI,EAAE;QACrB,MAAM,eAAe,EAAE,CAAC;IAC1B,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa;AAC5B,CAAC;AAED,eAAe,eAAe,CAAC"}

package/dist/utils/sortUtils.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Sort Utilities
+ *
+ * Provides functions for sorting items within collections.
+ * Can be used by routes and extensions.
+ */
+export interface SortOptions {
+    /**
+     * Collection name
+     */
+    collection: string;
+    /**
+     * ID of the item to move
+     */
+    item: string | number;
+    /**
+     * ID of the target item to move before/after
+     */
+    to: string | number;
+    /**
+     * Position mode: 'before' places item before target, 'after' places item after target
+     * @default 'before'
+     */
+    mode?: 'before' | 'after';
+    /**
+     * Accountability object from request (for permission checks)
+     * If not provided, bypassPermissions must be true
+     */
+    accountability?: {
+        user?: any;
+        role?: any;
+        roles?: string[];
+        permissions?: any[];
+        tenant?: string | null;
+    };
+    /**
+     * Whether to skip permission checks (for internal use)
+     * @default false
+     */
+    bypassPermissions?: boolean;
+    /**
+     * Database transaction to use
+     */
+    transaction?: any;
+}
+export interface SortResult {
+    item: string | number;
+    collection: string;
+    newSort: number;
+}
+/**
+ * Sort an item within a collection by moving it before another item.
+ * This updates the sort field of the target item and all items after it.
+ *
+ * @example
+ * ```typescript
+ * import { sortItems } from '@baasix/utils';
+ *
+ * // Move item 'abc' before item 'xyz' in the 'tasks' collection
+ * const result = await sortItems({
+ *   collection: 'tasks',
+ *   item: 'abc',
+ *   to: 'xyz',
+ *   accountability: req.accountability, // Pass accountability for permission checks
+ * });
+ *
+ * // Or bypass permissions for internal operations
+ * const result = await sortItems({
+ *   collection: 'tasks',
+ *   item: 'abc',
+ *   to: 'xyz',
+ *   bypassPermissions: true,
+ * });
+ * ```
+ */
+export declare function sortItems(options: SortOptions): Promise<SortResult>;
+/**
+ * Reorder items in a collection by setting their sort values in order.
+ * Useful for bulk reordering operations.
+ *
+ * @example
+ * ```typescript
+ * import { reorderItems } from '@baasix/utils';
+ *
+ * // Reorder items in the specified order
+ * await reorderItems({
+ *   collection: 'tasks',
+ *   items: ['id1', 'id2', 'id3'], // Items will be sorted in this order
+ * });
+ * ```
+ */
+export declare function reorderItems(options: {
+    collection: string;
+    items: (string | number)[];
+    startSort?: number;
+    transaction?: any;
+}): Promise<void>;
+/**
+ * Get the next available sort value for a collection.
+ * Useful when adding new items to the end of a sorted list.
+ *
+ * @example
+ * ```typescript
+ * import { getNextSortValue } from '@baasix/utils';
+ *
+ * const nextSort = await getNextSortValue('tasks');
+ * // Use nextSort when creating a new item
+ * ```
+ */
+export declare function getNextSortValue(collection: string, transaction?: any): Promise<number>;
+declare const _default: {
+    sortItems: typeof sortItems;
+    reorderItems: typeof reorderItems;
+    getNextSortValue: typeof getNextSortValue;
+};
+export default _default;
+//# sourceMappingURL=sortUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sortUtils.d.ts","sourceRoot":"","sources":["../../baasix/utils/sortUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB;;OAEG;IACH,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,GAAG,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IACF;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsIzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB7F;;;;;;AAED,wBAIE"}

package/dist/utils/sortUtils.js

@@ -0,0 +1,232 @@
+/**
+ * Sort Utilities
+ *
+ * Provides functions for sorting items within collections.
+ * Can be used by routes and extensions.
+ */
+import { schemaManager } from "./schemaManager.js";
+import { db as dbInstance } from "./db.js";
+import { eq, sql } from "drizzle-orm";
+import { APIError } from "./errorHandler.js";
+import { invalidateCollection } from "../services/CacheService.js";
+import { isAdmin } from "./auth.js";
+import permissionService from "../services/PermissionService.js";
+/**
+ * Sort an item within a collection by moving it before another item.
+ * This updates the sort field of the target item and all items after it.
+ *
+ * @example
+ * ```typescript
+ * import { sortItems } from '@baasix/utils';
+ *
+ * // Move item 'abc' before item 'xyz' in the 'tasks' collection
+ * const result = await sortItems({
+ *   collection: 'tasks',
+ *   item: 'abc',
+ *   to: 'xyz',
+ *   accountability: req.accountability, // Pass accountability for permission checks
+ * });
+ *
+ * // Or bypass permissions for internal operations
+ * const result = await sortItems({
+ *   collection: 'tasks',
+ *   item: 'abc',
+ *   to: 'xyz',
+ *   bypassPermissions: true,
+ * });
+ * ```
+ */
+export async function sortItems(options) {
+    const { collection, item, to, accountability, bypassPermissions = false, transaction, mode = 'before' } = options;
+    const db = transaction || dbInstance;
+    // Validate inputs
+    if (!item) {
+        throw new APIError("Missing item ID to sort", 400);
+    }
+    if (!to) {
+        throw new APIError("Missing target ID to sort to", 400);
+    }
+    // Check if the collection exists
+    let schemaInfo;
+    try {
+        schemaInfo = schemaManager.getSchema(collection);
+        if (!schemaInfo) {
+            throw new APIError(`Collection '${collection}' does not exist`, 404);
+        }
+    }
+    catch (error) {
+        throw new APIError(`Collection '${collection}' does not exist`, 404);
+    }
+    // Permission checks (unless bypassed)
+    if (!bypassPermissions) {
+        if (!accountability) {
+            throw new APIError("Accountability is required for permission checks. Use bypassPermissions: true for internal operations.", 400);
+        }
+        // Check if user is admin
+        const userIsAdmin = isAdmin({ accountability });
+        if (!userIsAdmin) {
+            // Check if user is authenticated (not public role)
+            const roleName = typeof accountability.role === 'object'
+                ? accountability.role?.name
+                : accountability.role;
+            if (!accountability.user || roleName === 'public') {
+                throw new APIError("Authentication required", 401);
+            }
+            // Check if user has sort permission for this collection
+            const role = accountability.role;
+            const roleId = typeof role === 'object' ? role.id : role;
+            const hasAccess = await permissionService.canAccess(roleId, collection, "update", ["sort"]);
+            if (!hasAccess) {
+                throw new APIError(`You don't have permission to sort items in '${collection}'`, 403);
+            }
+        }
+    }
+    // Get the table
+    const table = schemaManager.getTable(collection);
+    const primaryKeyField = schemaManager.getPrimaryKey(collection);
+    // Check if the table has a sort field
+    if (!table || !table.sort) {
+        throw new APIError(`Collection '${collection}' does not have a sort field`, 400);
+    }
+    // Find the item to move and the target item
+    const itemToMove = await db
+        .select()
+        .from(table)
+        .where(eq(table[primaryKeyField], item))
+        .limit(1);
+    const targetItem = await db
+        .select()
+        .from(table)
+        .where(eq(table[primaryKeyField], to))
+        .limit(1);
+    if (!itemToMove || itemToMove.length === 0) {
+        throw new APIError(`Item with ID ${item} not found`, 404);
+    }
+    if (!targetItem || targetItem.length === 0) {
+        throw new APIError(`Target item with ID ${to} not found`, 404);
+    }
+    // Get the current sort value of the target item
+    const targetSort = targetItem[0].sort || 0;
+    // Calculate the new sort value based on mode
+    let newSortValue;
+    if (mode === 'after') {
+        // Place after target: newSort = targetSort + 1, shift items >= newSort
+        newSortValue = targetSort + 1;
+        // Update all items with sort value >= newSortValue (increment by 1)
+        await db.execute(sql `
+      UPDATE "${sql.raw(collection)}"
+      SET "sort" = "sort" + 1
+      WHERE "sort" >= ${newSortValue}
+      AND "${sql.raw(primaryKeyField)}" != ${item}
+    `);
+    }
+    else {
+        // Place before target (default): newSort = targetSort, shift items >= targetSort
+        newSortValue = targetSort;
+        // Update all items with sort value >= targetSort (increment by 1)
+        await db.execute(sql `
+      UPDATE "${sql.raw(collection)}"
+      SET "sort" = "sort" + 1
+      WHERE "sort" >= ${targetSort}
+      AND "${sql.raw(primaryKeyField)}" != ${item}
+    `);
+    }
+    // Update the sort value of the item we're moving
+    await db.execute(sql `
+    UPDATE "${sql.raw(collection)}"
+    SET "sort" = ${newSortValue}
+    WHERE "${sql.raw(primaryKeyField)}" = ${item}
+  `);
+    // Invalidate collection cache after sort changes
+    await invalidateCollection(collection);
+    return {
+        item,
+        collection,
+        newSort: newSortValue,
+    };
+}
+/**
+ * Reorder items in a collection by setting their sort values in order.
+ * Useful for bulk reordering operations.
+ *
+ * @example
+ * ```typescript
+ * import { reorderItems } from '@baasix/utils';
+ *
+ * // Reorder items in the specified order
+ * await reorderItems({
+ *   collection: 'tasks',
+ *   items: ['id1', 'id2', 'id3'], // Items will be sorted in this order
+ * });
+ * ```
+ */
+export async function reorderItems(options) {
+    const { collection, items, startSort = 1, transaction } = options;
+    const db = transaction || dbInstance;
+    if (!items || items.length === 0) {
+        throw new APIError("Missing items array to reorder", 400);
+    }
+    // Check if the collection exists
+    const schemaInfo = schemaManager.getSchema(collection);
+    if (!schemaInfo) {
+        throw new APIError(`Collection '${collection}' does not exist`, 404);
+    }
+    // Get the table
+    const table = schemaManager.getTable(collection);
+    const primaryKeyField = schemaManager.getPrimaryKey(collection);
+    // Check if the table has a sort field
+    if (!table || !table.sort) {
+        throw new APIError(`Collection '${collection}' does not have a sort field`, 400);
+    }
+    // Update each item's sort value
+    for (let i = 0; i < items.length; i++) {
+        const itemId = items[i];
+        const sortValue = startSort + i;
+        await db.execute(sql `
+      UPDATE "${sql.raw(collection)}"
+      SET "sort" = ${sortValue}
+      WHERE "${sql.raw(primaryKeyField)}" = ${itemId}
+    `);
+    }
+    // Invalidate collection cache after sort changes
+    await invalidateCollection(collection);
+}
+/**
+ * Get the next available sort value for a collection.
+ * Useful when adding new items to the end of a sorted list.
+ *
+ * @example
+ * ```typescript
+ * import { getNextSortValue } from '@baasix/utils';
+ *
+ * const nextSort = await getNextSortValue('tasks');
+ * // Use nextSort when creating a new item
+ * ```
+ */
+export async function getNextSortValue(collection, transaction) {
+    const db = transaction || dbInstance;
+    // Check if the collection exists
+    const schemaInfo = schemaManager.getSchema(collection);
+    if (!schemaInfo) {
+        throw new APIError(`Collection '${collection}' does not exist`, 404);
+    }
+    // Get the table
+    const table = schemaManager.getTable(collection);
+    // Check if the table has a sort field
+    if (!table || !table.sort) {
+        throw new APIError(`Collection '${collection}' does not have a sort field`, 400);
+    }
+    // Get the maximum sort value
+    const result = await db.execute(sql `
+    SELECT COALESCE(MAX("sort"), 0) + 1 as next_sort
+    FROM "${sql.raw(collection)}"
+  `);
+    const rows = result.rows || result;
+    return rows[0]?.next_sort || 1;
+}
+export default {
+    sortItems,
+    reorderItems,
+    getNextSortValue,
+};
+//# sourceMappingURL=sortUtils.js.map