@ruya.sa/plugin-import-export 3.71.3

package/dist/utilities/getSchemaColumns.d.ts

@@ -0,0 +1,43 @@
+import type { SanitizedCollectionConfig } from '@ruya.sa/payload';
+export type GetSchemaColumnsArgs = {
+    /**
+     * The collection configuration to derive columns from
+     */
+    collectionConfig: SanitizedCollectionConfig;
+    /**
+     * Array of disabled field paths from plugin config
+     */
+    disabledFields?: string[];
+    /**
+     * User-selected fields to export. If provided, only these fields (and their nested fields) will be included.
+     */
+    fields?: string[];
+    /**
+     * The locale to export. When 'all', localized fields are expanded to include all locale suffixes.
+     */
+    locale?: null | string;
+    /**
+     * Available locale codes from config. Required when locale='all'.
+     */
+    localeCodes?: string[];
+};
+/**
+ * Derives CSV column names from the collection schema.
+ * This provides a base set of columns from field definitions.
+ *
+ * Note: For arrays/blocks with multiple items, the schema only generates index 0.
+ * Additional indices from actual data should be merged with these columns.
+ *
+ * Benefits:
+ * - Provides consistent base columns
+ * - Works for empty exports
+ * - Ensures proper column ordering
+ */
+export declare const getSchemaColumns: ({ collectionConfig, disabledFields, fields: selectedFields, locale, localeCodes, }: GetSchemaColumnsArgs) => string[];
+/**
+ * Merges schema-derived columns with data-discovered columns.
+ * Schema columns provide the base ordering, data columns add any additional
+ * columns (e.g., array indices beyond 0, dynamic fields).
+ */
+export declare const mergeColumns: (schemaColumns: string[], dataColumns: string[]) => string[];
+//# sourceMappingURL=getSchemaColumns.d.ts.map

package/dist/utilities/getSchemaColumns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSchemaColumns.d.ts","sourceRoot":"","sources":["../../src/utilities/getSchemaColumns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AAIjE,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,gBAAgB,EAAE,yBAAyB,CAAA;IAC3C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,uFAM1B,oBAAoB,KAAG,MAAM,EA4E/B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,kBAAmB,MAAM,EAAE,eAAe,MAAM,EAAE,KAAG,MAAM,EAoCnF,CAAA"}

package/dist/utilities/getSchemaColumns.js

@@ -0,0 +1,163 @@
+import { getFlattenedFieldKeys } from './getFlattenedFieldKeys.js';
+/**
+ * Derives CSV column names from the collection schema.
+ * This provides a base set of columns from field definitions.
+ *
+ * Note: For arrays/blocks with multiple items, the schema only generates index 0.
+ * Additional indices from actual data should be merged with these columns.
+ *
+ * Benefits:
+ * - Provides consistent base columns
+ * - Works for empty exports
+ * - Ensures proper column ordering
+ */ export const getSchemaColumns = ({ collectionConfig, disabledFields = [], fields: selectedFields, locale, localeCodes })=>{
+    const hasVersions = Boolean(collectionConfig.versions);
+    // Determine if we need locale expansion
+    const expandLocales = locale === 'all' && localeCodes && localeCodes.length > 0;
+    // Get all possible columns from schema (excludes system fields like id, createdAt, updatedAt)
+    let schemaColumns = getFlattenedFieldKeys(collectionConfig.flattenedFields, '', expandLocales ? {
+        localeCodes
+    } : {});
+    // Add system fields that aren't in flattenedFields
+    const systemFields = [
+        'id',
+        'createdAt',
+        'updatedAt'
+    ];
+    schemaColumns = [
+        ...systemFields,
+        ...schemaColumns
+    ];
+    // Filter to user-selected fields if specified
+    if (selectedFields && selectedFields.length > 0) {
+        schemaColumns = filterToSelectedFields(schemaColumns, selectedFields);
+    }
+    // Remove disabled fields
+    if (disabledFields.length > 0) {
+        const disabledSet = new Set();
+        for (const path of disabledFields){
+            // Convert dot notation to underscore and add to set
+            disabledSet.add(path.replace(/\./g, '_'));
+        }
+        schemaColumns = schemaColumns.filter((col)=>{
+            // Check if column matches any disabled path
+            for (const disabled of disabledSet){
+                if (col === disabled || col.startsWith(`${disabled}_`)) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    // When user has selected specific fields, preserve their ordering
+    // filterToSelectedFields() already returns columns in user's specified order
+    if (selectedFields && selectedFields.length > 0) {
+        return schemaColumns;
+    }
+    // No fields selected - apply default ordering (id first, timestamps last)
+    const orderedColumns = [];
+    // 1. ID always first
+    if (schemaColumns.includes('id')) {
+        orderedColumns.push('id');
+    }
+    // 2. Status field for versioned collections
+    if (hasVersions) {
+        orderedColumns.push('_status');
+    }
+    // 3. All other fields (excluding id, timestamps, status)
+    const excludeFromMiddle = new Set([
+        '_status',
+        'createdAt',
+        'id',
+        'updatedAt'
+    ]);
+    for (const col of schemaColumns){
+        if (!excludeFromMiddle.has(col)) {
+            orderedColumns.push(col);
+        }
+    }
+    // 4. Timestamps at the end
+    if (schemaColumns.includes('createdAt')) {
+        orderedColumns.push('createdAt');
+    }
+    if (schemaColumns.includes('updatedAt')) {
+        orderedColumns.push('updatedAt');
+    }
+    return orderedColumns;
+};
+/**
+ * Merges schema-derived columns with data-discovered columns.
+ * Schema columns provide the base ordering, data columns add any additional
+ * columns (e.g., array indices beyond 0, dynamic fields).
+ */ export const mergeColumns = (schemaColumns, dataColumns)=>{
+    const result = [
+        ...schemaColumns
+    ];
+    const schemaSet = new Set(schemaColumns);
+    // Add any data columns not in schema (preserves schema ordering, appends new ones)
+    for (const col of dataColumns){
+        if (!schemaSet.has(col)) {
+            // Find the best position to insert this column
+            // For array indices (e.g., field_1_*), insert after field_0_*
+            const match = col.match(/^(.+?)_(\d+)(_.*)?$/);
+            if (match) {
+                const [, basePath, index, suffix] = match;
+                if (basePath && index) {
+                    const prevIndex = parseInt(index, 10) - 1;
+                    const prevCol = `${basePath}_${prevIndex}${suffix ?? ''}`;
+                    const prevIdx = result.indexOf(prevCol);
+                    if (prevIdx !== -1) {
+                        // Insert after the previous index column
+                        result.splice(prevIdx + 1, 0, col);
+                        schemaSet.add(col);
+                        continue;
+                    }
+                }
+            }
+            // Otherwise append at the end (before timestamps)
+            const createdAtIdx = result.indexOf('createdAt');
+            if (createdAtIdx !== -1) {
+                result.splice(createdAtIdx, 0, col);
+            } else {
+                result.push(col);
+            }
+            schemaSet.add(col);
+        }
+    }
+    return result;
+};
+/**
+ * Filters schema columns to only include those matching user-selected fields.
+ * Preserves the order specified by the user in selectedFields.
+ * Handles nested field selection (e.g., 'group.value' includes 'group_value' and 'group_value_*')
+ */ function filterToSelectedFields(columns, selectedFields) {
+    const result = [];
+    const columnsSet = new Set(columns);
+    // Convert selected fields to underscore notation patterns
+    const patterns = selectedFields.map((field)=>{
+        const underscored = field.replace(/\./g, '_');
+        return {
+            exact: underscored,
+            original: field,
+            prefix: `${underscored}_`
+        };
+    });
+    // Iterate through user-specified fields in order to preserve their ordering
+    for (const pattern of patterns){
+        // First add the exact match if it exists
+        if (columnsSet.has(pattern.exact)) {
+            result.push(pattern.exact);
+        }
+        // Then add any columns with the prefix (nested fields)
+        for (const column of columns){
+            if (column !== pattern.exact && column.startsWith(pattern.prefix)) {
+                if (!result.includes(column)) {
+                    result.push(column);
+                }
+            }
+        }
+    }
+    return result;
+}
+
+//# sourceMappingURL=getSchemaColumns.js.map

package/dist/utilities/getSchemaColumns.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getSchemaColumns.ts"],"sourcesContent":["import type { SanitizedCollectionConfig } from '@ruya.sa/payload'\n\nimport { getFlattenedFieldKeys } from './getFlattenedFieldKeys.js'\n\nexport type GetSchemaColumnsArgs = {\n  /**\n   * The collection configuration to derive columns from\n   */\n  collectionConfig: SanitizedCollectionConfig\n  /**\n   * Array of disabled field paths from plugin config\n   */\n  disabledFields?: string[]\n  /**\n   * User-selected fields to export. If provided, only these fields (and their nested fields) will be included.\n   */\n  fields?: string[]\n  /**\n   * The locale to export. When 'all', localized fields are expanded to include all locale suffixes.\n   */\n  locale?: null | string\n  /**\n   * Available locale codes from config. Required when locale='all'.\n   */\n  localeCodes?: string[]\n}\n\n/**\n * Derives CSV column names from the collection schema.\n * This provides a base set of columns from field definitions.\n *\n * Note: For arrays/blocks with multiple items, the schema only generates index 0.\n * Additional indices from actual data should be merged with these columns.\n *\n * Benefits:\n * - Provides consistent base columns\n * - Works for empty exports\n * - Ensures proper column ordering\n */\nexport const getSchemaColumns = ({\n  collectionConfig,\n  disabledFields = [],\n  fields: selectedFields,\n  locale,\n  localeCodes,\n}: GetSchemaColumnsArgs): string[] => {\n  const hasVersions = Boolean(collectionConfig.versions)\n\n  // Determine if we need locale expansion\n  const expandLocales = locale === 'all' && localeCodes && localeCodes.length > 0\n\n  // Get all possible columns from schema (excludes system fields like id, createdAt, updatedAt)\n  let schemaColumns = getFlattenedFieldKeys(\n    collectionConfig.flattenedFields,\n    '',\n    expandLocales ? { localeCodes } : {},\n  )\n\n  // Add system fields that aren't in flattenedFields\n  const systemFields = ['id', 'createdAt', 'updatedAt']\n  schemaColumns = [...systemFields, ...schemaColumns]\n\n  // Filter to user-selected fields if specified\n  if (selectedFields && selectedFields.length > 0) {\n    schemaColumns = filterToSelectedFields(schemaColumns, selectedFields)\n  }\n\n  // Remove disabled fields\n  if (disabledFields.length > 0) {\n    const disabledSet = new Set<string>()\n    for (const path of disabledFields) {\n      // Convert dot notation to underscore and add to set\n      disabledSet.add(path.replace(/\\./g, '_'))\n    }\n    schemaColumns = schemaColumns.filter((col) => {\n      // Check if column matches any disabled path\n      for (const disabled of disabledSet) {\n        if (col === disabled || col.startsWith(`${disabled}_`)) {\n          return false\n        }\n      }\n      return true\n    })\n  }\n\n  // When user has selected specific fields, preserve their ordering\n  // filterToSelectedFields() already returns columns in user's specified order\n  if (selectedFields && selectedFields.length > 0) {\n    return schemaColumns\n  }\n\n  // No fields selected - apply default ordering (id first, timestamps last)\n  const orderedColumns: string[] = []\n\n  // 1. ID always first\n  if (schemaColumns.includes('id')) {\n    orderedColumns.push('id')\n  }\n\n  // 2. Status field for versioned collections\n  if (hasVersions) {\n    orderedColumns.push('_status')\n  }\n\n  // 3. All other fields (excluding id, timestamps, status)\n  const excludeFromMiddle = new Set(['_status', 'createdAt', 'id', 'updatedAt'])\n  for (const col of schemaColumns) {\n    if (!excludeFromMiddle.has(col)) {\n      orderedColumns.push(col)\n    }\n  }\n\n  // 4. Timestamps at the end\n  if (schemaColumns.includes('createdAt')) {\n    orderedColumns.push('createdAt')\n  }\n  if (schemaColumns.includes('updatedAt')) {\n    orderedColumns.push('updatedAt')\n  }\n\n  return orderedColumns\n}\n\n/**\n * Merges schema-derived columns with data-discovered columns.\n * Schema columns provide the base ordering, data columns add any additional\n * columns (e.g., array indices beyond 0, dynamic fields).\n */\nexport const mergeColumns = (schemaColumns: string[], dataColumns: string[]): string[] => {\n  const result = [...schemaColumns]\n  const schemaSet = new Set(schemaColumns)\n\n  // Add any data columns not in schema (preserves schema ordering, appends new ones)\n  for (const col of dataColumns) {\n    if (!schemaSet.has(col)) {\n      // Find the best position to insert this column\n      // For array indices (e.g., field_1_*), insert after field_0_*\n      const match = col.match(/^(.+?)_(\\d+)(_.*)?$/)\n      if (match) {\n        const [, basePath, index, suffix] = match\n        if (basePath && index) {\n          const prevIndex = parseInt(index, 10) - 1\n          const prevCol = `${basePath}_${prevIndex}${suffix ?? ''}`\n          const prevIdx = result.indexOf(prevCol)\n          if (prevIdx !== -1) {\n            // Insert after the previous index column\n            result.splice(prevIdx + 1, 0, col)\n            schemaSet.add(col)\n            continue\n          }\n        }\n      }\n      // Otherwise append at the end (before timestamps)\n      const createdAtIdx = result.indexOf('createdAt')\n      if (createdAtIdx !== -1) {\n        result.splice(createdAtIdx, 0, col)\n      } else {\n        result.push(col)\n      }\n      schemaSet.add(col)\n    }\n  }\n\n  return result\n}\n\n/**\n * Filters schema columns to only include those matching user-selected fields.\n * Preserves the order specified by the user in selectedFields.\n * Handles nested field selection (e.g., 'group.value' includes 'group_value' and 'group_value_*')\n */\nfunction filterToSelectedFields(columns: string[], selectedFields: string[]): string[] {\n  const result: string[] = []\n  const columnsSet = new Set(columns)\n\n  // Convert selected fields to underscore notation patterns\n  const patterns = selectedFields.map((field) => {\n    const underscored = field.replace(/\\./g, '_')\n    return {\n      exact: underscored,\n      original: field,\n      prefix: `${underscored}_`,\n    }\n  })\n\n  // Iterate through user-specified fields in order to preserve their ordering\n  for (const pattern of patterns) {\n    // First add the exact match if it exists\n    if (columnsSet.has(pattern.exact)) {\n      result.push(pattern.exact)\n    }\n\n    // Then add any columns with the prefix (nested fields)\n    for (const column of columns) {\n      if (column !== pattern.exact && column.startsWith(pattern.prefix)) {\n        if (!result.includes(column)) {\n          result.push(column)\n        }\n      }\n    }\n  }\n\n  return result\n}\n"],"names":["getFlattenedFieldKeys","getSchemaColumns","collectionConfig","disabledFields","fields","selectedFields","locale","localeCodes","hasVersions","Boolean","versions","expandLocales","length","schemaColumns","flattenedFields","systemFields","filterToSelectedFields","disabledSet","Set","path","add","replace","filter","col","disabled","startsWith","orderedColumns","includes","push","excludeFromMiddle","has","mergeColumns","dataColumns","result","schemaSet","match","basePath","index","suffix","prevIndex","parseInt","prevCol","prevIdx","indexOf","splice","createdAtIdx","columns","columnsSet","patterns","map","field","underscored","exact","original","prefix","pattern","column"],"mappings":"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"}

package/dist/utilities/getSelect.d.ts

@@ -0,0 +1,11 @@
+import type { SelectIncludeType } from '@ruya.sa/payload';
+/**
+ * Takes an input of array of string paths in dot notation and returns a select object.
+ * Used for both export and import to build Payload's select query format.
+ *
+ * @example
+ * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])
+ * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }
+ */
+export declare const getSelect: (fields: string[]) => SelectIncludeType;
+//# sourceMappingURL=getSelect.d.ts.map

package/dist/utilities/getSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSelect.d.ts","sourceRoot":"","sources":["../../src/utilities/getSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,WAAY,MAAM,EAAE,KAAG,iBAoB5C,CAAA"}

package/dist/utilities/getSelect.js

@@ -0,0 +1,27 @@
+/**
+ * Takes an input of array of string paths in dot notation and returns a select object.
+ * Used for both export and import to build Payload's select query format.
+ *
+ * @example
+ * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])
+ * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }
+ */ export const getSelect = (fields)=>{
+    const select = {};
+    fields.forEach((field)=>{
+        const segments = field.split('.');
+        let selectRef = select;
+        segments.forEach((segment, i)=>{
+            if (i === segments.length - 1) {
+                selectRef[segment] = true;
+            } else {
+                if (!selectRef[segment]) {
+                    selectRef[segment] = {};
+                }
+                selectRef = selectRef[segment];
+            }
+        });
+    });
+    return select;
+};
+
+//# sourceMappingURL=getSelect.js.map

package/dist/utilities/getSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getSelect.ts"],"sourcesContent":["import type { SelectIncludeType } from '@ruya.sa/payload'\n\n/**\n * Takes an input of array of string paths in dot notation and returns a select object.\n * Used for both export and import to build Payload's select query format.\n *\n * @example\n * getSelect(['id', 'title', 'group.value', 'createdAt', 'updatedAt'])\n * // Returns: { id: true, title: true, group: { value: true }, createdAt: true, updatedAt: true }\n */\nexport const getSelect = (fields: string[]): SelectIncludeType => {\n  const select: SelectIncludeType = {}\n\n  fields.forEach((field) => {\n    const segments = field.split('.')\n    let selectRef = select\n\n    segments.forEach((segment, i) => {\n      if (i === segments.length - 1) {\n        selectRef[segment] = true\n      } else {\n        if (!selectRef[segment]) {\n          selectRef[segment] = {}\n        }\n        selectRef = selectRef[segment] as SelectIncludeType\n      }\n    })\n  })\n\n  return select\n}\n"],"names":["getSelect","fields","select","forEach","field","segments","split","selectRef","segment","i","length"],"mappings":"AAEA;;;;;;;CAOC,GACD,OAAO,MAAMA,YAAY,CAACC;IACxB,MAAMC,SAA4B,CAAC;IAEnCD,OAAOE,OAAO,CAAC,CAACC;QACd,MAAMC,WAAWD,MAAME,KAAK,CAAC;QAC7B,IAAIC,YAAYL;QAEhBG,SAASF,OAAO,CAAC,CAACK,SAASC;YACzB,IAAIA,MAAMJ,SAASK,MAAM,GAAG,GAAG;gBAC7BH,SAAS,CAACC,QAAQ,GAAG;YACvB,OAAO;gBACL,IAAI,CAACD,SAAS,CAACC,QAAQ,EAAE;oBACvBD,SAAS,CAACC,QAAQ,GAAG,CAAC;gBACxB;gBACAD,YAAYA,SAAS,CAACC,QAAQ;YAChC;QACF;IACF;IAEA,OAAON;AACT,EAAC"}

package/dist/utilities/getvalueAtPath.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Safely retrieves a deeply nested value from an object using a dot-notation path.
+ *
+ * Supports:
+ * - Indexed array access (e.g., "array.0.field1")
+ * - Polymorphic blocks or keyed unions (e.g., "blocks.0.hero.title"), where the block key
+ *   (e.g., "hero") maps to a nested object inside the block item.
+ *
+ *
+ * @param obj - The input object to traverse.
+ * @param path - A dot-separated string representing the path to retrieve.
+ * @returns The value at the specified path, or undefined if not found.
+ */
+export declare const getValueAtPath: (obj: unknown, path: string) => unknown;
+//# sourceMappingURL=getvalueAtPath.d.ts.map

package/dist/utilities/getvalueAtPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getvalueAtPath.d.ts","sourceRoot":"","sources":["../../src/utilities/getvalueAtPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,QAAS,OAAO,QAAQ,MAAM,KAAG,OA6C3D,CAAA"}

package/dist/utilities/getvalueAtPath.js

@@ -0,0 +1,49 @@
+/**
+ * Safely retrieves a deeply nested value from an object using a dot-notation path.
+ *
+ * Supports:
+ * - Indexed array access (e.g., "array.0.field1")
+ * - Polymorphic blocks or keyed unions (e.g., "blocks.0.hero.title"), where the block key
+ *   (e.g., "hero") maps to a nested object inside the block item.
+ *
+ *
+ * @param obj - The input object to traverse.
+ * @param path - A dot-separated string representing the path to retrieve.
+ * @returns The value at the specified path, or undefined if not found.
+ */ export const getValueAtPath = (obj, path)=>{
+    if (!obj || typeof obj !== 'object') {
+        return undefined;
+    }
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts){
+        if (current == null) {
+            return undefined;
+        }
+        // If the path part is a number, treat it as an array index
+        if (!isNaN(Number(part))) {
+            current = current[Number(part)];
+            continue;
+        }
+        // Special case: if current is an array of blocks like [{ hero: { title: '...' } }]
+        // and the path is "blocks.0.hero.title", then `part` would be "hero"
+        if (Array.isArray(current)) {
+            const idx = Number(parts[parts.indexOf(part) - 1]);
+            const blockItem = current[idx];
+            if (typeof blockItem === 'object') {
+                const keys = Object.keys(blockItem);
+                // Find the key (e.g., "hero") that maps to an object
+                const matchingBlock = keys.find((key)=>blockItem[key] && typeof blockItem[key] === 'object');
+                if (matchingBlock && part === matchingBlock) {
+                    current = blockItem[matchingBlock];
+                    continue;
+                }
+            }
+        }
+        // Fallback to plain object key access
+        current = current[part];
+    }
+    return current;
+};
+
+//# sourceMappingURL=getvalueAtPath.js.map

package/dist/utilities/getvalueAtPath.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/getvalueAtPath.ts"],"sourcesContent":["/**\n * Safely retrieves a deeply nested value from an object using a dot-notation path.\n *\n * Supports:\n * - Indexed array access (e.g., \"array.0.field1\")\n * - Polymorphic blocks or keyed unions (e.g., \"blocks.0.hero.title\"), where the block key\n *   (e.g., \"hero\") maps to a nested object inside the block item.\n *\n *\n * @param obj - The input object to traverse.\n * @param path - A dot-separated string representing the path to retrieve.\n * @returns The value at the specified path, or undefined if not found.\n */\nexport const getValueAtPath = (obj: unknown, path: string): unknown => {\n  if (!obj || typeof obj !== 'object') {\n    return undefined\n  }\n\n  const parts = path.split('.')\n  let current: any = obj\n\n  for (const part of parts) {\n    if (current == null) {\n      return undefined\n    }\n\n    // If the path part is a number, treat it as an array index\n    if (!isNaN(Number(part))) {\n      current = current[Number(part)]\n      continue\n    }\n\n    // Special case: if current is an array of blocks like [{ hero: { title: '...' } }]\n    // and the path is \"blocks.0.hero.title\", then `part` would be \"hero\"\n    if (Array.isArray(current)) {\n      const idx = Number(parts[parts.indexOf(part) - 1])\n      const blockItem = current[idx]\n\n      if (typeof blockItem === 'object') {\n        const keys = Object.keys(blockItem)\n\n        // Find the key (e.g., \"hero\") that maps to an object\n        const matchingBlock = keys.find(\n          (key) => blockItem[key] && typeof blockItem[key] === 'object',\n        )\n\n        if (matchingBlock && part === matchingBlock) {\n          current = blockItem[matchingBlock]\n          continue\n        }\n      }\n    }\n\n    // Fallback to plain object key access\n    current = current[part]\n  }\n\n  return current\n}\n"],"names":["getValueAtPath","obj","path","undefined","parts","split","current","part","isNaN","Number","Array","isArray","idx","indexOf","blockItem","keys","Object","matchingBlock","find","key"],"mappings":"AAAA;;;;;;;;;;;;CAYC,GACD,OAAO,MAAMA,iBAAiB,CAACC,KAAcC;IAC3C,IAAI,CAACD,OAAO,OAAOA,QAAQ,UAAU;QACnC,OAAOE;IACT;IAEA,MAAMC,QAAQF,KAAKG,KAAK,CAAC;IACzB,IAAIC,UAAeL;IAEnB,KAAK,MAAMM,QAAQH,MAAO;QACxB,IAAIE,WAAW,MAAM;YACnB,OAAOH;QACT;QAEA,2DAA2D;QAC3D,IAAI,CAACK,MAAMC,OAAOF,QAAQ;YACxBD,UAAUA,OAAO,CAACG,OAAOF,MAAM;YAC/B;QACF;QAEA,mFAAmF;QACnF,qEAAqE;QACrE,IAAIG,MAAMC,OAAO,CAACL,UAAU;YAC1B,MAAMM,MAAMH,OAAOL,KAAK,CAACA,MAAMS,OAAO,CAACN,QAAQ,EAAE;YACjD,MAAMO,YAAYR,OAAO,CAACM,IAAI;YAE9B,IAAI,OAAOE,cAAc,UAAU;gBACjC,MAAMC,OAAOC,OAAOD,IAAI,CAACD;gBAEzB,qDAAqD;gBACrD,MAAMG,gBAAgBF,KAAKG,IAAI,CAC7B,CAACC,MAAQL,SAAS,CAACK,IAAI,IAAI,OAAOL,SAAS,CAACK,IAAI,KAAK;gBAGvD,IAAIF,iBAAiBV,SAASU,eAAe;oBAC3CX,UAAUQ,SAAS,CAACG,cAAc;oBAClC;gBACF;YACF;QACF;QAEA,sCAAsC;QACtCX,UAAUA,OAAO,CAACC,KAAK;IACzB;IAEA,OAAOD;AACT,EAAC"}

package/dist/utilities/parseCSV.d.ts

@@ -0,0 +1,11 @@
+import type { PayloadRequest } from '@ruya.sa/payload';
+export type ParseCSVArgs = {
+    data: Buffer | string;
+    req: PayloadRequest;
+};
+/**
+ * Parses CSV data into an array of record objects.
+ * Handles type coercion for booleans, numbers, and null values.
+ */
+export declare const parseCSV: ({ data, req }: ParseCSVArgs) => Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=parseCSV.d.ts.map

package/dist/utilities/parseCSV.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseCSV.d.ts","sourceRoot":"","sources":["../../src/utilities/parseCSV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAItD,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,GAAG,EAAE,cAAc,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,kBAAyB,YAAY,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAmE7F,CAAA"}

package/dist/utilities/parseCSV.js

@@ -0,0 +1,67 @@
+import { parse } from 'csv-parse';
+/**
+ * Parses CSV data into an array of record objects.
+ * Handles type coercion for booleans, numbers, and null values.
+ */ export const parseCSV = async ({ data, req })=>{
+    return new Promise((resolve, reject)=>{
+        const records = [];
+        const parser = parse({
+            cast: (value, _context)=>{
+                // Empty strings should be undefined (field not present in update)
+                // This preserves existing data instead of overwriting with null
+                if (value === '') {
+                    return undefined;
+                }
+                // Handle booleans
+                if (value === 'true') {
+                    return true;
+                }
+                if (value === 'false') {
+                    return false;
+                }
+                // Handle explicit null - user must type "null" to set field to null
+                if (value === 'null' || value === 'NULL') {
+                    return null;
+                }
+                // Don't auto-convert to numbers if the value contains a comma
+                // This allows hasMany fields to use comma-separated values
+                if (value.includes(',')) {
+                    return value // Keep as string for comma-separated values
+                    ;
+                }
+                // Handle numbers (only after checking for commas)
+                if (!isNaN(Number(value)) && value !== '') {
+                    const num = Number(value);
+                    if (String(num) === value || value.includes('.')) {
+                        return num;
+                    }
+                }
+                // Return as string
+                return value;
+            },
+            columns: true,
+            skip_empty_lines: true,
+            trim: true
+        });
+        parser.on('readable', ()=>{
+            let record;
+            while((record = parser.read()) !== null){
+                records.push(record);
+            }
+        });
+        parser.on('error', (err)=>{
+            req.payload.logger.error({
+                err,
+                msg: 'Error parsing CSV'
+            });
+            reject(err);
+        });
+        parser.on('end', ()=>{
+            resolve(records);
+        });
+        parser.write(data);
+        parser.end();
+    });
+};
+
+//# sourceMappingURL=parseCSV.js.map

package/dist/utilities/parseCSV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/parseCSV.ts"],"sourcesContent":["import type { PayloadRequest } from '@ruya.sa/payload'\n\nimport { parse } from 'csv-parse'\n\nexport type ParseCSVArgs = {\n  data: Buffer | string\n  req: PayloadRequest\n}\n\n/**\n * Parses CSV data into an array of record objects.\n * Handles type coercion for booleans, numbers, and null values.\n */\nexport const parseCSV = async ({ data, req }: ParseCSVArgs): Promise<Record<string, unknown>[]> => {\n  return new Promise((resolve, reject) => {\n    const records: Record<string, unknown>[] = []\n\n    const parser = parse({\n      cast: (value, _context) => {\n        // Empty strings should be undefined (field not present in update)\n        // This preserves existing data instead of overwriting with null\n        if (value === '') {\n          return undefined\n        }\n\n        // Handle booleans\n        if (value === 'true') {\n          return true\n        }\n        if (value === 'false') {\n          return false\n        }\n\n        // Handle explicit null - user must type \"null\" to set field to null\n        if (value === 'null' || value === 'NULL') {\n          return null\n        }\n\n        // Don't auto-convert to numbers if the value contains a comma\n        // This allows hasMany fields to use comma-separated values\n        if (value.includes(',')) {\n          return value // Keep as string for comma-separated values\n        }\n\n        // Handle numbers (only after checking for commas)\n        if (!isNaN(Number(value)) && value !== '') {\n          const num = Number(value)\n\n          if (String(num) === value || value.includes('.')) {\n            return num\n          }\n        }\n\n        // Return as string\n        return value\n      },\n      columns: true,\n      skip_empty_lines: true,\n      trim: true,\n    })\n\n    parser.on('readable', () => {\n      let record\n      while ((record = parser.read()) !== null) {\n        records.push(record)\n      }\n    })\n\n    parser.on('error', (err) => {\n      req.payload.logger.error({ err, msg: 'Error parsing CSV' })\n      reject(err)\n    })\n\n    parser.on('end', () => {\n      resolve(records)\n    })\n\n    parser.write(data)\n    parser.end()\n  })\n}\n"],"names":["parse","parseCSV","data","req","Promise","resolve","reject","records","parser","cast","value","_context","undefined","includes","isNaN","Number","num","String","columns","skip_empty_lines","trim","on","record","read","push","err","payload","logger","error","msg","write","end"],"mappings":"AAEA,SAASA,KAAK,QAAQ,YAAW;AAOjC;;;CAGC,GACD,OAAO,MAAMC,WAAW,OAAO,EAAEC,IAAI,EAAEC,GAAG,EAAgB;IACxD,OAAO,IAAIC,QAAQ,CAACC,SAASC;QAC3B,MAAMC,UAAqC,EAAE;QAE7C,MAAMC,SAASR,MAAM;YACnBS,MAAM,CAACC,OAAOC;gBACZ,kEAAkE;gBAClE,gEAAgE;gBAChE,IAAID,UAAU,IAAI;oBAChB,OAAOE;gBACT;gBAEA,kBAAkB;gBAClB,IAAIF,UAAU,QAAQ;oBACpB,OAAO;gBACT;gBACA,IAAIA,UAAU,SAAS;oBACrB,OAAO;gBACT;gBAEA,oEAAoE;gBACpE,IAAIA,UAAU,UAAUA,UAAU,QAAQ;oBACxC,OAAO;gBACT;gBAEA,8DAA8D;gBAC9D,2DAA2D;gBAC3D,IAAIA,MAAMG,QAAQ,CAAC,MAAM;oBACvB,OAAOH,MAAM,4CAA4C;;gBAC3D;gBAEA,kDAAkD;gBAClD,IAAI,CAACI,MAAMC,OAAOL,WAAWA,UAAU,IAAI;oBACzC,MAAMM,MAAMD,OAAOL;oBAEnB,IAAIO,OAAOD,SAASN,SAASA,MAAMG,QAAQ,CAAC,MAAM;wBAChD,OAAOG;oBACT;gBACF;gBAEA,mBAAmB;gBACnB,OAAON;YACT;YACAQ,SAAS;YACTC,kBAAkB;YAClBC,MAAM;QACR;QAEAZ,OAAOa,EAAE,CAAC,YAAY;YACpB,IAAIC;YACJ,MAAO,AAACA,CAAAA,SAASd,OAAOe,IAAI,EAAC,MAAO,KAAM;gBACxChB,QAAQiB,IAAI,CAACF;YACf;QACF;QAEAd,OAAOa,EAAE,CAAC,SAAS,CAACI;YAClBtB,IAAIuB,OAAO,CAACC,MAAM,CAACC,KAAK,CAAC;gBAAEH;gBAAKI,KAAK;YAAoB;YACzDvB,OAAOmB;QACT;QAEAjB,OAAOa,EAAE,CAAC,OAAO;YACfhB,QAAQE;QACV;QAEAC,OAAOsB,KAAK,CAAC5B;QACbM,OAAOuB,GAAG;IACZ;AACF,EAAC"}

package/dist/utilities/parseCSV.spec.js

@@ -0,0 +1,169 @@
+import { parseCSV } from './parseCSV.js';
+import { describe, it, expect, vi } from 'vitest';
+describe('parseCSV', ()=>{
+    const mockReq = {
+        payload: {
+            logger: {
+                error: vi.fn()
+            }
+        }
+    };
+    describe('cast function behavior', ()=>{
+        it('should preserve comma-separated values as strings', async ()=>{
+            const csvData = Buffer.from('numbers,ids\n"1,2,3,5,8","id1,id2,id3"');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    numbers: '1,2,3,5,8',
+                    ids: 'id1,id2,id3'
+                }
+            ]);
+        });
+        it('should convert single numbers to numbers', async ()=>{
+            const csvData = Buffer.from('single,decimal\n"42","3.14"');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    single: 42,
+                    decimal: 3.14
+                }
+            ]);
+        });
+        it('should handle booleans correctly', async ()=>{
+            const csvData = Buffer.from('bool1,bool2,notBool\n"true","false","True"');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    bool1: true,
+                    bool2: false,
+                    notBool: 'True'
+                }
+            ]);
+        });
+        it('should convert empty strings to undefined', async ()=>{
+            const csvData = Buffer.from('field1,field2\n"","value"');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    // field1 is undefined (not present) - empty cells don't update fields
+                    field2: 'value'
+                }
+            ]);
+        });
+        it('should handle null strings', async ()=>{
+            const csvData = Buffer.from('field1,field2,field3\n"null","NULL","Null"');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    field1: null,
+                    field2: null,
+                    field3: 'Null'
+                }
+            ]);
+        });
+        it('should preserve spaces in comma-separated values', async ()=>{
+            const csvData = Buffer.from('numbers\n" 10 , 20 , 30 "');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    numbers: ' 10 , 20 , 30 '
+                }
+            ]);
+        });
+        it('should handle mixed comma-separated values with empty entries', async ()=>{
+            const csvData = Buffer.from('mixed\n"1,,3,,5"');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    mixed: '1,,3,,5'
+                }
+            ]);
+        });
+        it('should handle MongoDB ObjectIds as strings', async ()=>{
+            const csvData = Buffer.from('id\n"507f1f77bcf86cd799439011"');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    id: '507f1f77bcf86cd799439011'
+                }
+            ]);
+        });
+        it('should handle multiple rows with various data types', async ()=>{
+            const csvData = Buffer.from('title,count,tags,active\n' + '"Item 1","5","tag1,tag2,tag3","true"\n' + '"Item 2","","","false"\n' + '"Item 3","10","single",""\n');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    title: 'Item 1',
+                    count: 5,
+                    tags: 'tag1,tag2,tag3',
+                    active: true
+                },
+                {
+                    title: 'Item 2',
+                    // count is undefined (empty cell - field not updated)
+                    // tags is undefined (empty cell - field not updated)
+                    active: false
+                },
+                {
+                    title: 'Item 3',
+                    count: 10,
+                    tags: 'single'
+                }
+            ]);
+        });
+        it('should skip empty lines', async ()=>{
+            const csvData = Buffer.from('field\n"value1"\n\n"value2"\n\n');
+            const result = await parseCSV({
+                data: csvData,
+                req: mockReq
+            });
+            expect(result).toEqual([
+                {
+                    field: 'value1'
+                },
+                {
+                    field: 'value2'
+                }
+            ]);
+        });
+    });
+    describe('error handling', ()=>{
+        it('should handle parsing errors', async ()=>{
+            const invalidCsv = Buffer.from('field1,field2\n"value1');
+            await expect(parseCSV({
+                data: invalidCsv,
+                req: mockReq
+            })).rejects.toThrow();
+            expect(mockReq.payload.logger.error).toHaveBeenCalled();
+        });
+    });
+});
+
+//# sourceMappingURL=parseCSV.spec.js.map

package/dist/utilities/parseCSV.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/parseCSV.spec.ts"],"sourcesContent":["import { PayloadRequest } from '@ruya.sa/payload'\n\nimport { parseCSV } from './parseCSV.js'\nimport { describe, it, expect, vi } from 'vitest'\n\ndescribe('parseCSV', () => {\n  const mockReq = {\n    payload: {\n      logger: {\n        error: vi.fn(),\n      },\n    },\n  } as unknown as PayloadRequest\n\n  describe('cast function behavior', () => {\n    it('should preserve comma-separated values as strings', async () => {\n      const csvData = Buffer.from('numbers,ids\\n\"1,2,3,5,8\",\"id1,id2,id3\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          numbers: '1,2,3,5,8',\n          ids: 'id1,id2,id3',\n        },\n      ])\n    })\n\n    it('should convert single numbers to numbers', async () => {\n      const csvData = Buffer.from('single,decimal\\n\"42\",\"3.14\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          single: 42,\n          decimal: 3.14,\n        },\n      ])\n    })\n\n    it('should handle booleans correctly', async () => {\n      const csvData = Buffer.from('bool1,bool2,notBool\\n\"true\",\"false\",\"True\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          bool1: true,\n          bool2: false,\n          notBool: 'True', // Case-sensitive\n        },\n      ])\n    })\n\n    it('should convert empty strings to undefined', async () => {\n      const csvData = Buffer.from('field1,field2\\n\"\",\"value\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          // field1 is undefined (not present) - empty cells don't update fields\n          field2: 'value',\n        },\n      ])\n    })\n\n    it('should handle null strings', async () => {\n      const csvData = Buffer.from('field1,field2,field3\\n\"null\",\"NULL\",\"Null\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          field1: null,\n          field2: null,\n          field3: 'Null', // Case-sensitive for mixed case\n        },\n      ])\n    })\n\n    it('should preserve spaces in comma-separated values', async () => {\n      const csvData = Buffer.from('numbers\\n\" 10 , 20 , 30 \"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          numbers: ' 10 , 20 , 30 ', // CSV parser trims outer quotes but preserves the content\n        },\n      ])\n    })\n\n    it('should handle mixed comma-separated values with empty entries', async () => {\n      const csvData = Buffer.from('mixed\\n\"1,,3,,5\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          mixed: '1,,3,,5',\n        },\n      ])\n    })\n\n    it('should handle MongoDB ObjectIds as strings', async () => {\n      const csvData = Buffer.from('id\\n\"507f1f77bcf86cd799439011\"')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          id: '507f1f77bcf86cd799439011',\n        },\n      ])\n    })\n\n    it('should handle multiple rows with various data types', async () => {\n      const csvData = Buffer.from(\n        'title,count,tags,active\\n' +\n          '\"Item 1\",\"5\",\"tag1,tag2,tag3\",\"true\"\\n' +\n          '\"Item 2\",\"\",\"\",\"false\"\\n' +\n          '\"Item 3\",\"10\",\"single\",\"\"\\n',\n      )\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([\n        {\n          title: 'Item 1',\n          count: 5,\n          tags: 'tag1,tag2,tag3',\n          active: true,\n        },\n        {\n          title: 'Item 2',\n          // count is undefined (empty cell - field not updated)\n          // tags is undefined (empty cell - field not updated)\n          active: false,\n        },\n        {\n          title: 'Item 3',\n          count: 10,\n          tags: 'single',\n          // active is undefined (empty cell - field not updated)\n        },\n      ])\n    })\n\n    it('should skip empty lines', async () => {\n      const csvData = Buffer.from('field\\n\"value1\"\\n\\n\"value2\"\\n\\n')\n      const result = await parseCSV({ data: csvData, req: mockReq })\n\n      expect(result).toEqual([{ field: 'value1' }, { field: 'value2' }])\n    })\n  })\n\n  describe('error handling', () => {\n    it('should handle parsing errors', async () => {\n      const invalidCsv = Buffer.from('field1,field2\\n\"value1')\n\n      await expect(parseCSV({ data: invalidCsv, req: mockReq })).rejects.toThrow()\n      expect(mockReq.payload.logger.error).toHaveBeenCalled()\n    })\n  })\n})\n"],"names":["parseCSV","describe","it","expect","vi","mockReq","payload","logger","error","fn","csvData","Buffer","from","result","data","req","toEqual","numbers","ids","single","decimal","bool1","bool2","notBool","field2","field1","field3","mixed","id","title","count","tags","active","field","invalidCsv","rejects","toThrow","toHaveBeenCalled"],"mappings":"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"}