json-rest-api 1.0.14 → 1.0.16

package/plugins/core/rest-api-positioning-plugin.js

@@ -3,30 +3,29 @@ import {
   getInitialPosition,
   isValidPosition,
   assignInitialPositions,
-} from './lib/fractional-positioning.js';
-import { createStorageAdapter } from './lib/storage/storage-adapter.js';
+} from './lib/fractional-positioning.js'
+import { createStorageAdapter } from './lib/storage/storage-adapter.js'
 
 export const PositioningPlugin = {
   name: 'positioning',
   dependencies: ['rest-api', 'rest-api-knex|rest-api-anyapi-knex'],
 
-  install({ api, addHook, vars, helpers, log, scopes, pluginOptions }) {
-
-    const installedPlugins = Array.from(api._installedPlugins || []);
-    const legacyStorageInstalled = installedPlugins.includes('rest-api-knex');
-    const canonicalStorageInstalled = installedPlugins.includes('rest-api-anyapi-knex');
+  install ({ api, addHook, vars, helpers, log, scopes, pluginOptions }) {
+    const installedPlugins = Array.from(api._installedPlugins || [])
+    const legacyStorageInstalled = installedPlugins.includes('rest-api-knex')
+    const canonicalStorageInstalled = installedPlugins.includes('rest-api-anyapi-knex')
     if (!legacyStorageInstalled && !canonicalStorageInstalled) {
       throw new Error(
         "Positioning plugin requires either 'rest-api-knex' or 'rest-api-anyapi-knex' to be installed before it."
-      );
+      )
     }
 
     if (!api.knex?.instance) {
-      throw new Error('Positioning plugin requires a storage plugin with knex support (rest-api-knex or rest-api-anyapi-knex)');
+      throw new Error('Positioning plugin requires a storage plugin with knex support (rest-api-knex or rest-api-anyapi-knex)')
     }
 
     // Get configuration - hooked-api namespaces options by plugin name
-    const positioningOptions = pluginOptions || {};
+    const positioningOptions = pluginOptions || {}
 
     // Store configuration in vars (data only) - inspired by multihome pattern
     vars.positioning = {
@@ -38,394 +37,394 @@ export const PositioningPlugin = {
       defaultPosition: positioningOptions.defaultPosition || 'last',
       autoIndex: positioningOptions.autoIndex !== undefined ? positioningOptions.autoIndex : true,
       rebalanceThreshold: positioningOptions.rebalanceThreshold || 50 // Max position string length
-    };
+    }
 
     const resolveStorageAdapter = (scopeName) => {
-      if (!scopeName) return null;
-      const scope = scopes[scopeName] || api.resources?.[scopeName];
-      const scopeVars = scope?.vars;
-      if (!scopeVars) return null;
+      if (!scopeName) return null
+      const scope = scopes[scopeName] || api.resources?.[scopeName]
+      const scopeVars = scope?.vars
+      if (!scopeVars) return null
 
       if (scopeVars.storageAdapter) {
-        return scopeVars.storageAdapter;
+        return scopeVars.storageAdapter
       }
 
       if (scopeVars.schemaInfo && api.knex?.instance) {
-        const adapter = createStorageAdapter({ knex: api.knex.instance, schemaInfo: scopeVars.schemaInfo });
-        scopeVars.storageAdapter = adapter;
-        return adapter;
+        const adapter = createStorageAdapter({ knex: api.knex.instance, schemaInfo: scopeVars.schemaInfo })
+        scopeVars.storageAdapter = adapter
+        return adapter
       }
 
-      return null;
-    };
+      return null
+    }
 
     // Validate configuration
     if (!['fractional', 'integer'].includes(vars.positioning.strategy)) {
-      throw new Error(`Invalid positioning strategy: ${vars.positioning.strategy}. Must be 'fractional' or 'integer'`);
+      throw new Error(`Invalid positioning strategy: ${vars.positioning.strategy}. Must be 'fractional' or 'integer'`)
     }
 
     if (vars.positioning.strategy === 'integer') {
-      throw new Error("Integer positioning strategy not yet implemented. Please use 'fractional'");
+      throw new Error("Integer positioning strategy not yet implemented. Please use 'fractional'")
     }
 
     // Helper to check if a resource should have positioning
-    function shouldHavePositioning(scopeName) {
-      return !vars.positioning.excludeResources.includes(scopeName);
+    function shouldHavePositioning (scopeName) {
+      return !vars.positioning.excludeResources.includes(scopeName)
     }
 
     // Helper to build filter conditions for position groups
-    function buildPositionFilterConditions(adapter, schemaInfo, {
+    function buildPositionFilterConditions (adapter, schemaInfo, {
       attributes = {},
       rawRecord = {},
       simplifiedRecord = {},
       inputRelationships = {},
       minimalRelationships = {},
     }) {
-      const conditions = {};
+      const conditions = {}
 
       log.debug('*** buildPositionFilterConditions', {
         filters: vars.positioning.filters,
         attributeKeys: Object.keys(attributes || {}),
         rawKeys: Object.keys(rawRecord || {}),
         simplifiedKeys: Object.keys(simplifiedRecord || {}),
-      });
+      })
 
-      const tryAssign = (holder, field) => (holder && field in holder ? holder[field] : undefined);
+      const tryAssign = (holder, field) => (holder && field in holder ? holder[field] : undefined)
 
       vars.positioning.filters.forEach((filterField) => {
-        const searchField = schemaInfo.searchSchemaStructure?.[filterField] || null;
-        const schemaField = schemaInfo.schemaStructure?.[filterField] || null;
+        const searchField = schemaInfo.searchSchemaStructure?.[filterField] || null
+        const schemaField = schemaInfo.schemaStructure?.[filterField] || null
         const isRelationship = Boolean(
-          searchField?.isRelationship
-          || schemaField?.belongsTo
-          || schemaField?.belongsToPolymorphic
-        );
+          searchField?.isRelationship ||
+          schemaField?.belongsTo ||
+          schemaField?.belongsToPolymorphic
+        )
 
         if (!searchField && !schemaField) {
-          log.warn(`Filter field '${filterField}' not found in search schema or resource schema for positioning`);
+          log.warn(`Filter field '${filterField}' not found in search schema or resource schema for positioning`)
         }
 
-        const dbField = searchField?.actualField || filterField;
-        let value;
+        const dbField = searchField?.actualField || filterField
+        let value
 
         const attempt = (candidate) => {
           if (value === undefined && candidate !== undefined) {
-            value = candidate;
+            value = candidate
           }
-        };
+        }
 
-        attempt(tryAssign(rawRecord, filterField));
-        attempt(tryAssign(simplifiedRecord, filterField));
-        attempt(tryAssign(rawRecord, dbField));
-        attempt(tryAssign(attributes, filterField));
-        attempt(tryAssign(attributes, dbField));
+        attempt(tryAssign(rawRecord, filterField))
+        attempt(tryAssign(simplifiedRecord, filterField))
+        attempt(tryAssign(rawRecord, dbField))
+        attempt(tryAssign(attributes, filterField))
+        attempt(tryAssign(attributes, dbField))
 
         if (isRelationship) {
-          attempt(inputRelationships?.[filterField]?.data?.id);
-          attempt(minimalRelationships?.[filterField]?.data?.id);
+          attempt(inputRelationships?.[filterField]?.data?.id)
+          attempt(minimalRelationships?.[filterField]?.data?.id)
           // Some contexts may expose relationship data under attributes
-          attempt(tryAssign(rawRecord?.relationships, filterField)?.data?.id);
+          attempt(tryAssign(rawRecord?.relationships, filterField)?.data?.id)
         }
 
-       if (value !== undefined) {
-         const column = adapter.translateColumn(dbField);
+        if (value !== undefined) {
+          const column = adapter.translateColumn(dbField)
           const normalizedValue = value === null
             ? null
-            : adapter.translateFilterValue(filterField, value);
-          conditions[column] = normalizedValue;
+            : adapter.translateFilterValue(filterField, value)
+          conditions[column] = normalizedValue
         }
-      });
+      })
 
-      log.debug('*** Filter conditions built', { conditions });
-      return conditions;
+      log.debug('*** Filter conditions built', { conditions })
+      return conditions
     }
 
     // Validate that resources have position field when added
     addHook('scope:added', 'validate-position-field', {}, ({ context, vars }) => {
-      const { scopeName, scopeOptions } = context;
+      const { scopeName, scopeOptions } = context
 
       // Skip excluded resources
       if (!shouldHavePositioning(scopeName)) {
-        log.debug(`Resource ${scopeName} excluded from positioning`);
-        return;
+        log.debug(`Resource ${scopeName} excluded from positioning`)
+        return
       }
 
       // Check if schema has position field
-      const schema = scopeOptions.schema;
+      const schema = scopeOptions.schema
       if (schema && !schema[vars.positioning.field]) {
         throw new Error(
           `Resource '${scopeName}' must have '${vars.positioning.field}' field in schema to use positioning plugin`
-        );
+        )
       }
 
       // Validate filter fields exist (check both relationship names and actual field names)
       vars.positioning.filters.forEach(filterField => {
         // Check if it's a relationship field by looking for a field with matching 'as' property
-        let fieldExists = false;
-        
+        let fieldExists = false
+
         // First check if the field exists directly in the schema
         if (schema[filterField]) {
-          fieldExists = true;
+          fieldExists = true
         } else {
           // Check if it's a relationship name (as property)
           for (const [fieldName, fieldDef] of Object.entries(schema)) {
             if (fieldDef.as === filterField) {
-              fieldExists = true;
-              break;
+              fieldExists = true
+              break
             }
           }
         }
-        
+
         if (!fieldExists) {
           throw new Error(
             `Resource '${scopeName}' must have '${filterField}' field or relationship in schema for position filtering`
-          );
+          )
         }
-      });
-    });
+      })
+    })
 
     // Add index for position field if autoIndex is enabled
     addHook('scope:added', 'add-position-index', { afterFunction: 'validate-position-field' }, async ({ context, vars, scopes }) => {
-      const { scopeName } = context;
-      
+      const { scopeName } = context
+
       if (!shouldHavePositioning(scopeName) || !vars.positioning.autoIndex) {
-        return;
+        return
       }
 
-      const scope = scopes[scopeName];
-      const schemaInfo = scope.vars.schemaInfo;
-      
+      const scope = scopes[scopeName]
+      const schemaInfo = scope.vars.schemaInfo
+
       if (!schemaInfo || !api.knex?.instance) {
-        return; // Skip if no database connection
+        return // Skip if no database connection
       }
 
       try {
-        const adapter = resolveStorageAdapter(scopeName);
+        const adapter = resolveStorageAdapter(scopeName)
         if (adapter.isCanonical()) {
-          log.debug(`Skipping positioning index for canonical storage on ${scopeName}`);
-          return;
+          log.debug(`Skipping positioning index for canonical storage on ${scopeName}`)
+          return
         }
 
-        const knex = api.knex.instance;
-        const tableName = adapter.getTableName();
-        
+        const knex = api.knex.instance
+        const tableName = adapter.getTableName()
+
         // Check if table exists first
-        const tableExists = await knex.schema.hasTable(tableName);
+        const tableExists = await knex.schema.hasTable(tableName)
         if (!tableExists) {
-          log.debug(`Table ${tableName} doesn't exist yet, skipping index creation`);
-          return;
+          log.debug(`Table ${tableName} doesn't exist yet, skipping index creation`)
+          return
         }
-        
+
         // Build index columns: map filter fields to actual database columns
-        const indexColumns = new Set();
-        
+        const indexColumns = new Set()
+
         // Map each filter field to its database column
         vars.positioning.filters.forEach(filterField => {
-          const searchField = schemaInfo.searchSchemaStructure?.[filterField];
+          const searchField = schemaInfo.searchSchemaStructure?.[filterField]
           if (searchField) {
             // Use actualField if it exists (for relationships)
-            const dbField = searchField.actualField || filterField;
-            indexColumns.add(adapter.translateColumn(dbField));
+            const dbField = searchField.actualField || filterField
+            indexColumns.add(adapter.translateColumn(dbField))
           } else if (schemaInfo.schemaStructure[filterField]) {
             // Direct database field
-            indexColumns.add(adapter.translateColumn(filterField));
+            indexColumns.add(adapter.translateColumn(filterField))
           }
-        });
-        
+        })
+
         // Add the position field
-        indexColumns.add(adapter.translateColumn(vars.positioning.field));
+        indexColumns.add(adapter.translateColumn(vars.positioning.field))
+
+        const indexColumnList = [...indexColumns].filter(Boolean)
+
+        const indexName = `idx_${tableName}_positioning`
 
-        const indexColumnList = [...indexColumns].filter(Boolean);
-        
-        const indexName = `idx_${tableName}_positioning`;
-        
         // Check if index already exists
-        const hasIndex = await knex.schema.hasIndex(tableName, indexColumnList, indexName);
-        
+        const hasIndex = await knex.schema.hasIndex(tableName, indexColumnList, indexName)
+
         if (!hasIndex) {
           await knex.schema.table(tableName, table => {
-            table.index(indexColumnList, indexName);
-          });
-          
-          log.info(`Created positioning index on ${tableName}`, { columns: indexColumnList });
+            table.index(indexColumnList, indexName)
+          })
+
+          log.info(`Created positioning index on ${tableName}`, { columns: indexColumnList })
         }
       } catch (error) {
-        log.warn(`Could not create positioning index for ${scopeName}:`, error.message);
+        log.warn(`Could not create positioning index for ${scopeName}:`, error.message)
       }
-    });
+    })
 
     // Process beforeId parameter in requests
     addHook('beforeSchemaValidate', 'process-beforeid', {}, async ({ context, scopeName, vars }) => {
-      log.debug('*** beforeSchemaValidate positioning hook', { 
-        scopeName, 
+      log.debug('*** beforeSchemaValidate positioning hook', {
+        scopeName,
         method: context.method,
         shouldHavePositioning: shouldHavePositioning(scopeName)
-      });
-      
+      })
+
       // Skip excluded resources
       if (!shouldHavePositioning(scopeName)) {
-        log.debug('*** Skipping beforeId processing - excluded resource');
-        return;
+        log.debug('*** Skipping beforeId processing - excluded resource')
+        return
       }
 
       // Skip if no positioning context needed
-      const method = context.method;
+      const method = context.method
       if (!['post', 'put', 'patch'].includes(method)) {
-        log.debug('*** Skipping beforeId processing - wrong method', { method });
-        return;
+        log.debug('*** Skipping beforeId processing - wrong method', { method })
+        return
       }
 
       // Check if resource has position field
-      const scope = scopes[scopeName];
-      const hasPositionField = scope?.vars?.schemaInfo?.schemaStructure?.[vars.positioning.field];
-      
+      const scope = scopes[scopeName]
+      const hasPositionField = scope?.vars?.schemaInfo?.schemaStructure?.[vars.positioning.field]
+
       if (!hasPositionField) {
-        return;
+        return
       }
 
       // Extract beforeId from JSON:API format attributes
-      const attributes = context.inputRecord?.data?.attributes
-        || (context.simplified && context.inputRecord && typeof context.inputRecord === 'object'
+      const attributes = context.inputRecord?.data?.attributes ||
+        (context.simplified && context.inputRecord && typeof context.inputRecord === 'object'
           ? context.inputRecord
-          : {});
-      const beforeId = attributes[vars.positioning.beforeIdField];
+          : {})
+      const beforeId = attributes[vars.positioning.beforeIdField]
 
       // Store beforeId in context for later use
       if (beforeId !== undefined) {
-        context.positioningBeforeId = beforeId;
+        context.positioningBeforeId = beforeId
 
         // Remove beforeId from attributes so it doesn't get stored
-        delete attributes[vars.positioning.beforeIdField];
+        delete attributes[vars.positioning.beforeIdField]
 
         if (context.simplified && context.inputRecord && typeof context.inputRecord === 'object') {
-          delete context.inputRecord[vars.positioning.beforeIdField];
+          delete context.inputRecord[vars.positioning.beforeIdField]
         }
       }
 
       // Remove any manually provided position field - position is managed by this plugin
       if (attributes[vars.positioning.field] !== undefined) {
-        delete attributes[vars.positioning.field];
+        delete attributes[vars.positioning.field]
 
-        log.debug('Positioning beforeId extracted', { 
-          scopeName, 
+        log.debug('Positioning beforeId extracted', {
+          scopeName,
           beforeId,
           method
-        });
+        })
 
         if (context.simplified && context.inputRecord && typeof context.inputRecord === 'object') {
-          delete context.inputRecord[vars.positioning.field];
+          delete context.inputRecord[vars.positioning.field]
         }
       }
 
       // For new records without explicit position, mark for positioning
       if (method === 'post' && !attributes[vars.positioning.field]) {
-        context.needsPositioning = true;
+        context.needsPositioning = true
       }
-    });
+    })
 
     // Calculate and set position before create/update
     addHook('beforeDataCallPost', 'calculate-position-post', {}, async ({ context, scopeName, vars, helpers }) => {
-      log.debug('*** beforeDataCallPost hook fired for positioning', { scopeName, method: context.method });
-      await calculateAndSetPosition(context, scopeName, vars, helpers, log, scopes, api);
-    });
+      log.debug('*** beforeDataCallPost hook fired for positioning', { scopeName, method: context.method })
+      await calculateAndSetPosition(context, scopeName, vars, helpers, log, scopes, api)
+    })
 
     addHook('beforeDataCallPut', 'calculate-position-put', {}, async ({ context, scopeName, vars, helpers }) => {
-      log.debug('*** beforeDataCallPut hook fired for positioning', { scopeName, method: context.method });
+      log.debug('*** beforeDataCallPut hook fired for positioning', { scopeName, method: context.method })
       // Only process if beforeId was provided or it's a new record
       if (context.positioningBeforeId !== undefined || context.needsPositioning) {
-        await calculateAndSetPosition(context, scopeName, vars, helpers, log, scopes, api);
+        await calculateAndSetPosition(context, scopeName, vars, helpers, log, scopes, api)
       }
-    });
+    })
 
     addHook('beforeDataCallPatch', 'calculate-position-patch', {}, async ({ context, scopeName, vars, helpers }) => {
-      log.debug('*** beforeDataCallPatch hook fired for positioning', { scopeName, method: context.method });
+      log.debug('*** beforeDataCallPatch hook fired for positioning', { scopeName, method: context.method })
       // Only process if beforeId was provided
       if (context.positioningBeforeId !== undefined) {
-        await calculateAndSetPosition(context, scopeName, vars, helpers, log, scopes, api);
+        await calculateAndSetPosition(context, scopeName, vars, helpers, log, scopes, api)
       }
-    });
+    })
 
     // Helper function to calculate and set position
-    async function calculateAndSetPosition(context, scopeName, vars, helpers, log, scopes, api) {
-      log.debug('*** calculateAndSetPosition called', { 
-        scopeName, 
+    async function calculateAndSetPosition (context, scopeName, vars, helpers, log, scopes, api) {
+      log.debug('*** calculateAndSetPosition called', {
+        scopeName,
         method: context.method,
         shouldHavePositioning: shouldHavePositioning(scopeName),
         beforeId: context.positioningBeforeId,
         needsPositioning: context.needsPositioning
-      });
-      
+      })
+
       // Skip if no positioning needed
       if (!shouldHavePositioning(scopeName)) {
-        log.debug('*** Skipping - resource excluded from positioning');
-        return;
+        log.debug('*** Skipping - resource excluded from positioning')
+        return
       }
 
-      const beforeId = context.positioningBeforeId;
-      const needsPositioning = context.needsPositioning;
-      
+      const beforeId = context.positioningBeforeId
+      const needsPositioning = context.needsPositioning
+
       // Skip if no positioning action needed
       if (beforeId === undefined && !needsPositioning) {
-        log.debug('*** Skipping - no positioning needed', { beforeId, needsPositioning });
-        return;
+        log.debug('*** Skipping - no positioning needed', { beforeId, needsPositioning })
+        return
       }
 
       const recordData = (() => {
         if (context.inputRecord?.data?.attributes) {
-          return { ...context.inputRecord.data.attributes };
+          return { ...context.inputRecord.data.attributes }
         }
         if (context.simplified && context.inputRecord && typeof context.inputRecord === 'object') {
-          return { ...context.inputRecord };
+          return { ...context.inputRecord }
         }
-        return {};
-      })();
-        
-      log.debug('*** Record data for positioning', { 
+        return {}
+      })()
+
+      log.debug('*** Record data for positioning', {
         recordData,
         simplified: context.simplified,
         inputRecord: context.inputRecord
-      });
+      })
 
-      const jsonApiRecord = context.inputRecord?.data || {};
-      const inputRelationships = jsonApiRecord.relationships || {};
+      const jsonApiRecord = context.inputRecord?.data || {}
+      const inputRelationships = jsonApiRecord.relationships || {}
       const simplifiedRecord = context.simplified && context.inputRecord && typeof context.inputRecord === 'object'
         ? context.inputRecord
-        : {};
+        : {}
 
-      const minimalAttributes = context.minimalRecord?.attributes || {};
-      const minimalRelationships = context.minimalRecord?.relationships || {};
+      const minimalAttributes = context.minimalRecord?.attributes || {}
+      const minimalRelationships = context.minimalRecord?.relationships || {}
 
       const combinedAttributes = {
         ...minimalAttributes,
         ...recordData,
-      };
+      }
 
       // Build filter conditions for the position group
-      const schemaInfo = context.schemaInfo;
-      const adapter = context.storageAdapter || resolveStorageAdapter(scopeName);
+      const schemaInfo = context.schemaInfo
+      const adapter = context.storageAdapter || resolveStorageAdapter(scopeName)
 
       if (!adapter) {
-        log.warn('*** Positioning skipped - no storage adapter available', { scopeName });
-        return;
+        log.warn('*** Positioning skipped - no storage adapter available', { scopeName })
+        return
       }
-      
+
       const filterConditions = buildPositionFilterConditions(adapter, schemaInfo, {
         attributes: combinedAttributes,
         rawRecord: recordData,
         simplifiedRecord,
         inputRelationships,
         minimalRelationships,
-      });
+      })
 
-      log.debug('*** Position filter conditions', { scopeName, filterConditions });
+      log.debug('*** Position filter conditions', { scopeName, filterConditions })
 
       // Query existing items in the same position group
-      const knex = api.knex.instance;
-      const tableName = adapter.getTableName();
-      const idProperty = schemaInfo.idProperty;
-      const idColumn = adapter.getIdColumn();
-      const positionColumn = adapter.translateColumn(vars.positioning.field);
-      
+      const knex = api.knex.instance
+      const tableName = adapter.getTableName()
+      const idProperty = schemaInfo.idProperty
+      const idColumn = adapter.getIdColumn()
+      const positionColumn = adapter.translateColumn(vars.positioning.field)
+
       log.debug('*** Building position query', {
         tableName,
         idProperty,
@@ -433,117 +432,117 @@ export const PositioningPlugin = {
         positionField: vars.positioning.field,
         positionColumn,
         filterConditions
-      });
-      
+      })
+
       // Check if we have a transaction to use
       // Build base query with filter conditions
-      const baseQuery = adapter.buildBaseQuery({ transaction: context.transaction });
+      const baseQuery = adapter.buildBaseQuery({ transaction: context.transaction })
       Object.entries(filterConditions).forEach(([column, value]) => {
         if (value === null) {
-          baseQuery.whereNull(column);
+          baseQuery.whereNull(column)
         } else {
-          baseQuery.where(column, value);
+          baseQuery.where(column, value)
         }
-      });
+      })
 
       // For updates, exclude the current record
       if ((context.method === 'patch' || context.method === 'put') && context.id) {
-        const translatedId = adapter.translateFilterValue(idProperty, context.id);
-        baseQuery.whereNot(idColumn, translatedId);
+        const translatedId = adapter.translateFilterValue(idProperty, context.id)
+        baseQuery.whereNot(idColumn, translatedId)
       }
-      
+
       // Calculate effective beforeId first
-      let effectiveBeforeId = beforeId;
-      
+      let effectiveBeforeId = beforeId
+
       // Handle default positioning when no beforeId is provided
       if (beforeId === undefined) {
         if (vars.positioning.defaultPosition === 'last') {
-          effectiveBeforeId = null; // null means position at end
+          effectiveBeforeId = null // null means position at end
         } else if (vars.positioning.defaultPosition === 'first') {
-          effectiveBeforeId = 'FIRST'; // Special marker for first position
+          effectiveBeforeId = 'FIRST' // Special marker for first position
         }
       }
-      
-      let items = [];
-      
+
+      let items = []
+
       const selectColumns = {
         [idProperty]: idColumn,
         [vars.positioning.field]: positionColumn,
-      };
-      const selectWithAliases = (builder) => adapter.selectColumns(builder, selectColumns);
+      }
+      const selectWithAliases = (builder) => adapter.selectColumns(builder, selectColumns)
 
       try {
         log.debug('*** Positioning query start', {
           effectiveBeforeId,
           selectColumns,
-        });
+        })
         if (effectiveBeforeId === null) {
           // Positioning at end - only get the last item
           const lastItem = await selectWithAliases(baseQuery
             .clone())
             .orderBy(positionColumn, 'desc')
-            .first();
-          
+            .first()
+
           if (lastItem) {
-            items = [lastItem];
+            items = [lastItem]
           }
         } else if (effectiveBeforeId === 'FIRST') {
           // Positioning at beginning - get the first item
           const firstItem = await selectWithAliases(baseQuery
             .clone())
             .orderBy(positionColumn, 'asc')
-            .first();
-          
+            .first()
+
           if (firstItem) {
-            items = [firstItem];
-            effectiveBeforeId = firstItem[idProperty];
+            items = [firstItem]
+            effectiveBeforeId = firstItem[idProperty]
           } else {
-            effectiveBeforeId = null;
+            effectiveBeforeId = null
           }
         } else if (effectiveBeforeId) {
           // Positioning before a specific item - get that item and the one before it
-          const normalizedTargetId = adapter.translateFilterValue(idProperty, effectiveBeforeId);
+          const normalizedTargetId = adapter.translateFilterValue(idProperty, effectiveBeforeId)
           const targetItem = await selectWithAliases(baseQuery
             .clone())
             .where(idColumn, normalizedTargetId)
-            .first();
-          
+            .first()
+
           if (targetItem) {
             // Get the item immediately before the target
             const prevItem = await selectWithAliases(baseQuery
               .clone())
               .where(positionColumn, '<', targetItem[vars.positioning.field])
               .orderBy(positionColumn, 'desc')
-              .first();
-            
-            items = prevItem ? [prevItem, targetItem] : [targetItem];
+              .first()
+
+            items = prevItem ? [prevItem, targetItem] : [targetItem]
           }
         } else {
           // First item in group - no items needed
-          items = [];
+          items = []
         }
-        
-        log.debug('*** Query completed', { itemCount: items.length, items });
+
+        log.debug('*** Query completed', { itemCount: items.length, items })
       } catch (error) {
-        log.error('*** Query failed', { error: error.message, stack: error.stack });
-        throw error;
+        log.error('*** Query failed', { error: error.message, stack: error.stack })
+        throw error
       }
-      
+
       // Calculate new position
-      const newPosition = items.length === 0 
+      const newPosition = items.length === 0
         ? getInitialPosition()
-        : calculatePosition(items, effectiveBeforeId, idProperty, vars.positioning.field);
-      
+        : calculatePosition(items, effectiveBeforeId, idProperty, vars.positioning.field)
+
       // Set the position on the incoming payload so downstream steps persist it
       if (context.inputRecord?.data) {
-        context.inputRecord.data.attributes = context.inputRecord.data.attributes || {};
-        context.inputRecord.data.attributes[vars.positioning.field] = newPosition;
+        context.inputRecord.data.attributes = context.inputRecord.data.attributes || {}
+        context.inputRecord.data.attributes[vars.positioning.field] = newPosition
       }
 
       if (context.simplified && context.inputRecord && typeof context.inputRecord === 'object') {
-        context.inputRecord[vars.positioning.field] = newPosition;
+        context.inputRecord[vars.positioning.field] = newPosition
       }
-      
+
       log.debug('Position calculated', {
         scopeName,
         newPosition,
@@ -552,7 +551,7 @@ export const PositioningPlugin = {
         itemCount: items.length,
         method: context.method,
         id: context.id
-      });
+      })
     }
 
     // Add positioning info back to response
@@ -560,34 +559,34 @@ export const PositioningPlugin = {
       // Only add if beforeId was in the original request
       if (context.positioningBeforeId !== undefined && context.record) {
         if (context.simplified) {
-          context.record[vars.positioning.beforeIdField] = context.positioningBeforeId;
+          context.record[vars.positioning.beforeIdField] = context.positioningBeforeId
         } else {
           // For JSON:API, add to meta
-          context.meta = context.meta || {};
+          context.meta = context.meta || {}
           context.meta.positioning = {
             [vars.positioning.beforeIdField]: context.positioningBeforeId
-          };
+          }
         }
       }
-    });
+    })
 
     // Apply default sort by position if no other sort specified
     addHook('beforeQuery', 'apply-position-sort', {}, async ({ context, scopeName, vars }) => {
       if (!shouldHavePositioning(scopeName)) {
-        return;
+        return
       }
 
       // Check if sort is already specified
-      const hasSort = context.queryParams?.sort && context.queryParams.sort.length > 0;
-      
+      const hasSort = context.queryParams?.sort && context.queryParams.sort.length > 0
+
       if (!hasSort) {
         // Apply position sort
-        context.queryParams = context.queryParams || {};
-        context.queryParams.sort = [vars.positioning.field];
-        
-        log.trace('Applied default position sort', { scopeName });
+        context.queryParams = context.queryParams || {}
+        context.queryParams.sort = [vars.positioning.field]
+
+        log.trace('Applied default position sort', { scopeName })
       }
-    });
+    })
 
     // API methods for positioning operations
     api.positioning = {
@@ -597,41 +596,41 @@ export const PositioningPlugin = {
        * @param {Array} positions - Array of {id, position} or {id, beforeId}
        * @param {Object} filters - Filter conditions for position group
        */
-      async reorder(scopeName, positions, filters = {}) {
-        const scope = scopes[scopeName];
+      async reorder (scopeName, positions, filters = {}) {
+        const scope = scopes[scopeName]
         if (!scope) {
-          throw new Error(`Unknown resource: ${scopeName}`);
+          throw new Error(`Unknown resource: ${scopeName}`)
         }
 
         // Implementation would go here for bulk reordering
-        log.info('Bulk reorder requested', { scopeName, count: positions.length });
+        log.info('Bulk reorder requested', { scopeName, count: positions.length })
       },
 
       /**
        * Get positioning configuration
        */
-      getConfig() {
-        return { ...vars.positioning };
+      getConfig () {
+        return { ...vars.positioning }
       },
 
       /**
        * Check if a resource has positioning enabled
        */
-      isEnabled(scopeName) {
-        return shouldHavePositioning(scopeName);
+      isEnabled (scopeName) {
+        return shouldHavePositioning(scopeName)
       }
-    };
+    }
 
     log.info('Positioning plugin installed', {
       field: vars.positioning.field,
       strategy: vars.positioning.strategy,
       filters: vars.positioning.filters,
       excludedResources: vars.positioning.excludeResources
-    });
+    })
   }
-};
+}
 
-/* 
+/*
 Usage examples:
 
 // Basic usage - positioning for all resources