payload 3.84.1 → 4.0.0-internal.38b7f1d

package/dist/hierarchy/buildParentField.d.ts

@@ -0,0 +1,11 @@
+import type { SingleRelationshipField } from '../fields/config/types.js';
+export declare const buildParentField: ({ collectionSlug, injectHeaderButton, overrides, parentFieldName, }: {
+    collectionSlug: string;
+    /**
+     * When true, uses NullField and injects a header button for parent selection
+     */
+    injectHeaderButton?: boolean;
+    overrides?: Partial<SingleRelationshipField>;
+    parentFieldName: string;
+}) => SingleRelationshipField;
+//# sourceMappingURL=buildParentField.d.ts.map

package/dist/hierarchy/buildParentField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildParentField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/buildParentField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAExE,eAAO,MAAM,gBAAgB,wEAK1B;IACD,cAAc,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC5C,eAAe,EAAE,MAAM,CAAA;CACxB,KAAG,uBA0CH,CAAA"}

package/dist/hierarchy/buildParentField.js

@@ -0,0 +1,42 @@
+export const buildParentField = ({ collectionSlug, injectHeaderButton = false, overrides = {}, parentFieldName })=>{
+    const field = {
+        name: parentFieldName,
+        type: 'relationship',
+        admin: {
+            ...injectHeaderButton && {
+                components: {
+                    Field: '@payloadcms/ui#NullField'
+                }
+            },
+            position: 'sidebar'
+        },
+        hasMany: false,
+        index: true,
+        label: 'Parent',
+        localized: false,
+        relationTo: collectionSlug,
+        ...injectHeaderButton && {
+            custom: {
+                hierarchy: {
+                    // Inform hierarchy UI to inject the header button for this parent field
+                    injectHeaderButton: true
+                }
+            }
+        }
+    };
+    if (overrides?.admin) {
+        field.admin = {
+            ...field.admin || {},
+            ...overrides.admin
+        };
+        if (overrides.admin.components && field.admin) {
+            field.admin.components = {
+                ...field.admin.components || {},
+                ...overrides.admin.components
+            };
+        }
+    }
+    return field;
+};
+
+//# sourceMappingURL=buildParentField.js.map

package/dist/hierarchy/buildParentField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/buildParentField.ts"],"sourcesContent":["import type { SingleRelationshipField } from '../fields/config/types.js'\n\nexport const buildParentField = ({\n  collectionSlug,\n  injectHeaderButton = false,\n  overrides = {},\n  parentFieldName,\n}: {\n  collectionSlug: string\n  /**\n   * When true, uses NullField and injects a header button for parent selection\n   */\n  injectHeaderButton?: boolean\n  overrides?: Partial<SingleRelationshipField>\n  parentFieldName: string\n}): SingleRelationshipField => {\n  const field: SingleRelationshipField = {\n    name: parentFieldName,\n    type: 'relationship',\n    admin: {\n      ...(injectHeaderButton && {\n        components: {\n          Field: '@payloadcms/ui#NullField',\n        },\n      }),\n      position: 'sidebar',\n    },\n    hasMany: false,\n    index: true,\n    label: 'Parent',\n    localized: false,\n    relationTo: collectionSlug, // Always self-referential\n    ...(injectHeaderButton && {\n      custom: {\n        hierarchy: {\n          // Inform hierarchy UI to inject the header button for this parent field\n          injectHeaderButton: true,\n        },\n      },\n    }),\n  }\n\n  if (overrides?.admin) {\n    field.admin = {\n      ...(field.admin || {}),\n      ...overrides.admin,\n    }\n\n    if (overrides.admin.components && field.admin) {\n      field.admin.components = {\n        ...(field.admin.components || {}),\n        ...overrides.admin.components,\n      }\n    }\n  }\n\n  return field\n}\n"],"names":["buildParentField","collectionSlug","injectHeaderButton","overrides","parentFieldName","field","name","type","admin","components","Field","position","hasMany","index","label","localized","relationTo","custom","hierarchy"],"mappings":"AAEA,OAAO,MAAMA,mBAAmB,CAAC,EAC/BC,cAAc,EACdC,qBAAqB,KAAK,EAC1BC,YAAY,CAAC,CAAC,EACdC,eAAe,EAShB;IACC,MAAMC,QAAiC;QACrCC,MAAMF;QACNG,MAAM;QACNC,OAAO;YACL,GAAIN,sBAAsB;gBACxBO,YAAY;oBACVC,OAAO;gBACT;YACF,CAAC;YACDC,UAAU;QACZ;QACAC,SAAS;QACTC,OAAO;QACPC,OAAO;QACPC,WAAW;QACXC,YAAYf;QACZ,GAAIC,sBAAsB;YACxBe,QAAQ;gBACNC,WAAW;oBACT,wEAAwE;oBACxEhB,oBAAoB;gBACtB;YACF;QACF,CAAC;IACH;IAEA,IAAIC,WAAWK,OAAO;QACpBH,MAAMG,KAAK,GAAG;YACZ,GAAIH,MAAMG,KAAK,IAAI,CAAC,CAAC;YACrB,GAAGL,UAAUK,KAAK;QACpB;QAEA,IAAIL,UAAUK,KAAK,CAACC,UAAU,IAAIJ,MAAMG,KAAK,EAAE;YAC7CH,MAAMG,KAAK,CAACC,UAAU,GAAG;gBACvB,GAAIJ,MAAMG,KAAK,CAACC,UAAU,IAAI,CAAC,CAAC;gBAChC,GAAGN,UAAUK,KAAK,CAACC,UAAU;YAC/B;QACF;IACF;IAEA,OAAOJ;AACT,EAAC"}

package/dist/hierarchy/constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default field names and constants for hierarchy feature
+ */
+export declare const HIERARCHY_SLUG_PATH_FIELD = "_h_slugPath";
+export declare const HIERARCHY_TITLE_PATH_FIELD = "_h_titlePath";
+export declare const HIERARCHY_DEFAULT_LOCALE = "en";
+/** Default limit for hierarchy tree queries */
+export declare const DEFAULT_HIERARCHY_TREE_LIMIT = 100;
+/** Default limit for hierarchy list view table queries */
+export declare const DEFAULT_HIERARCHY_LIST_LIMIT = 25;
+/** Default value for allowing hasMany on hierarchy fields */
+export declare const DEFAULT_ALLOW_HAS_MANY = true;
+/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */
+export declare const getHierarchyFieldName: (hierarchySlug: string) => string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/hierarchy/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/hierarchy/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,yBAAyB,gBAAgB,CAAA;AACtD,eAAO,MAAM,0BAA0B,iBAAiB,CAAA;AACxD,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAE5C,+CAA+C;AAC/C,eAAO,MAAM,4BAA4B,MAAM,CAAA;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAE9C,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAE1C,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB,kBAAmB,MAAM,KAAG,MAA+B,CAAA"}

package/dist/hierarchy/constants.js

@@ -0,0 +1,11 @@
+/**
+ * Default field names and constants for hierarchy feature
+ */ export const HIERARCHY_SLUG_PATH_FIELD = '_h_slugPath';
+export const HIERARCHY_TITLE_PATH_FIELD = '_h_titlePath';
+export const HIERARCHY_DEFAULT_LOCALE = 'en';
+/** Default limit for hierarchy tree queries */ export const DEFAULT_HIERARCHY_TREE_LIMIT = 100;
+/** Default limit for hierarchy list view table queries */ export const DEFAULT_HIERARCHY_LIST_LIMIT = 25;
+/** Default value for allowing hasMany on hierarchy fields */ export const DEFAULT_ALLOW_HAS_MANY = true;
+/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */ export const getHierarchyFieldName = (hierarchySlug)=>`_h_${hierarchySlug}`;
+
+//# sourceMappingURL=constants.js.map

package/dist/hierarchy/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/constants.ts"],"sourcesContent":["/**\n * Default field names and constants for hierarchy feature\n */\n\nexport const HIERARCHY_SLUG_PATH_FIELD = '_h_slugPath'\nexport const HIERARCHY_TITLE_PATH_FIELD = '_h_titlePath'\nexport const HIERARCHY_DEFAULT_LOCALE = 'en'\n\n/** Default limit for hierarchy tree queries */\nexport const DEFAULT_HIERARCHY_TREE_LIMIT = 100\n\n/** Default limit for hierarchy list view table queries */\nexport const DEFAULT_HIERARCHY_LIST_LIMIT = 25\n\n/** Default value for allowing hasMany on hierarchy fields */\nexport const DEFAULT_ALLOW_HAS_MANY = true\n\n/** Generate a hierarchy field name from a hierarchy slug (e.g., 'folders' -> '_h_folders') */\nexport const getHierarchyFieldName = (hierarchySlug: string): string => `_h_${hierarchySlug}`\n"],"names":["HIERARCHY_SLUG_PATH_FIELD","HIERARCHY_TITLE_PATH_FIELD","HIERARCHY_DEFAULT_LOCALE","DEFAULT_HIERARCHY_TREE_LIMIT","DEFAULT_HIERARCHY_LIST_LIMIT","DEFAULT_ALLOW_HAS_MANY","getHierarchyFieldName","hierarchySlug"],"mappings":"AAAA;;CAEC,GAED,OAAO,MAAMA,4BAA4B,cAAa;AACtD,OAAO,MAAMC,6BAA6B,eAAc;AACxD,OAAO,MAAMC,2BAA2B,KAAI;AAE5C,6CAA6C,GAC7C,OAAO,MAAMC,+BAA+B,IAAG;AAE/C,wDAAwD,GACxD,OAAO,MAAMC,+BAA+B,GAAE;AAE9C,2DAA2D,GAC3D,OAAO,MAAMC,yBAAyB,KAAI;AAE1C,4FAA4F,GAC5F,OAAO,MAAMC,wBAAwB,CAACC,gBAAkC,CAAC,GAAG,EAAEA,eAAe,CAAA"}

package/dist/hierarchy/createFolderField.d.ts

@@ -0,0 +1,39 @@
+import type { RelationshipField, SingleRelationshipField } from '../fields/config/types.js';
+/**
+ * Options for creating a folder relationship field.
+ * All SingleRelationshipField properties are available except name, type, relationTo, and hasMany
+ * which are managed by the folder system.
+ */
+export type CreateFolderFieldOptions = {
+    /**
+     * The slug of the hierarchy collection this field references (e.g., 'folders')
+     */
+    relationTo: string;
+} & Pick<Partial<SingleRelationshipField>, 'admin' | 'label' | 'required'>;
+/**
+ * Creates a relationship field for folder-style hierarchies (single-select).
+ *
+ * This field:
+ * - Has hasMany:false (single folder selection)
+ * - Uses NullField to render nothing in the form (no DOM output)
+ * - Injects a header button for folder selection via miller columns UI
+ *
+ * Use this in your collection's fields array to add a folder relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createFolderField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createFolderField({
+ *       relationTo: 'folders',
+ *       label: 'Folder',
+ *     }),
+ *   ],
+ * }
+ */
+export declare function createFolderField(options: CreateFolderFieldOptions): RelationshipField;
+//# sourceMappingURL=createFolderField.d.ts.map

package/dist/hierarchy/createFolderField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFolderField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/createFolderField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAI3F;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,CAAA;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CA2BtF"}

package/dist/hierarchy/createFolderField.js

@@ -0,0 +1,54 @@
+import { getHierarchyFieldName } from './constants.js';
+/**
+ * Creates a relationship field for folder-style hierarchies (single-select).
+ *
+ * This field:
+ * - Has hasMany:false (single folder selection)
+ * - Uses NullField to render nothing in the form (no DOM output)
+ * - Injects a header button for folder selection via miller columns UI
+ *
+ * Use this in your collection's fields array to add a folder relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createFolderField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createFolderField({
+ *       relationTo: 'folders',
+ *       label: 'Folder',
+ *     }),
+ *   ],
+ * }
+ */ export function createFolderField(options) {
+    const { admin: adminOverrides, label, relationTo, ...restOptions } = options;
+    const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {};
+    return {
+        name: getHierarchyFieldName(relationTo),
+        type: 'relationship',
+        admin: {
+            position: 'sidebar',
+            ...restAdminOverrides,
+            components: {
+                // NullField renders nothing - the header button handles the UI
+                Field: '@payloadcms/ui#NullField',
+                ...componentOverrides
+            }
+        },
+        custom: {
+            hierarchy: {
+                injectHeaderButton: true
+            }
+        },
+        hasMany: false,
+        index: true,
+        label: label ?? 'Folder',
+        relationTo,
+        ...restOptions
+    };
+}
+
+//# sourceMappingURL=createFolderField.js.map

package/dist/hierarchy/createFolderField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/createFolderField.ts"],"sourcesContent":["import type { RelationshipField, SingleRelationshipField } from '../fields/config/types.js'\n\nimport { getHierarchyFieldName } from './constants.js'\n\n/**\n * Options for creating a folder relationship field.\n * All SingleRelationshipField properties are available except name, type, relationTo, and hasMany\n * which are managed by the folder system.\n */\nexport type CreateFolderFieldOptions = {\n  /**\n   * The slug of the hierarchy collection this field references (e.g., 'folders')\n   */\n  relationTo: string\n} & Pick<Partial<SingleRelationshipField>, 'admin' | 'label' | 'required'>\n\n/**\n * Creates a relationship field for folder-style hierarchies (single-select).\n *\n * This field:\n * - Has hasMany:false (single folder selection)\n * - Uses NullField to render nothing in the form (no DOM output)\n * - Injects a header button for folder selection via miller columns UI\n *\n * Use this in your collection's fields array to add a folder relationship.\n * The field name is automatically generated based on the hierarchy slug.\n *\n * @example\n * import { createFolderField } from 'payload'\n *\n * const Posts: CollectionConfig = {\n *   slug: 'posts',\n *   fields: [\n *     { name: 'title', type: 'text' },\n *     createFolderField({\n *       relationTo: 'folders',\n *       label: 'Folder',\n *     }),\n *   ],\n * }\n */\nexport function createFolderField(options: CreateFolderFieldOptions): RelationshipField {\n  const { admin: adminOverrides, label, relationTo, ...restOptions } = options\n  const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {}\n\n  return {\n    name: getHierarchyFieldName(relationTo),\n    type: 'relationship',\n    admin: {\n      position: 'sidebar',\n      ...restAdminOverrides,\n      components: {\n        // NullField renders nothing - the header button handles the UI\n        Field: '@payloadcms/ui#NullField',\n        ...componentOverrides,\n      },\n    },\n    custom: {\n      hierarchy: {\n        injectHeaderButton: true,\n      },\n    },\n    hasMany: false,\n    index: true,\n    label: label ?? 'Folder',\n    relationTo,\n    ...restOptions,\n  } as RelationshipField\n}\n"],"names":["getHierarchyFieldName","createFolderField","options","admin","adminOverrides","label","relationTo","restOptions","components","componentOverrides","restAdminOverrides","name","type","position","Field","custom","hierarchy","injectHeaderButton","hasMany","index"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iBAAgB;AActD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,kBAAkBC,OAAiC;IACjE,MAAM,EAAEC,OAAOC,cAAc,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGC,aAAa,GAAGL;IACrE,MAAM,EAAEM,YAAYC,kBAAkB,EAAE,GAAGC,oBAAoB,GAAGN,kBAAkB,CAAC;IAErF,OAAO;QACLO,MAAMX,sBAAsBM;QAC5BM,MAAM;QACNT,OAAO;YACLU,UAAU;YACV,GAAGH,kBAAkB;YACrBF,YAAY;gBACV,+DAA+D;gBAC/DM,OAAO;gBACP,GAAGL,kBAAkB;YACvB;QACF;QACAM,QAAQ;YACNC,WAAW;gBACTC,oBAAoB;YACtB;QACF;QACAC,SAAS;QACTC,OAAO;QACPd,OAAOA,SAAS;QAChBC;QACA,GAAGC,WAAW;IAChB;AACF"}

package/dist/hierarchy/createTagField.d.ts

@@ -0,0 +1,44 @@
+import type { RelationshipField } from '../fields/config/types.js';
+/**
+ * Options for creating a tag relationship field.
+ * All RelationshipFieldMany properties are available except name, type, and relationTo
+ * which are managed by the tag system.
+ */
+export type CreateTagFieldOptions = {
+    /**
+     * Whether to allow multiple tags (defaults to true)
+     * @default true
+     */
+    hasMany?: boolean;
+    /**
+     * The slug of the hierarchy collection this field references (e.g., 'tags')
+     */
+    relationTo: string;
+} & Pick<Partial<RelationshipField>, 'admin' | 'label' | 'required'>;
+/**
+ * Creates a relationship field for tag-style hierarchies (multi-select by default).
+ *
+ * This field:
+ * - Has hasMany:true by default (multiple tag selection)
+ * - Is positioned in the sidebar by default
+ * - Does NOT inject a header button (tags use standard relationship UI)
+ *
+ * Use this in your collection's fields array to add a tag relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createTagField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createTagField({
+ *       relationTo: 'tags',
+ *       label: 'Tags',
+ *     }),
+ *   ],
+ * }
+ */
+export declare function createTagField(options: CreateTagFieldOptions): RelationshipField;
+//# sourceMappingURL=createTagField.d.ts.map

package/dist/hierarchy/createTagField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTagField.d.ts","sourceRoot":"","sources":["../../src/hierarchy/createTagField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAIlE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAqBhF"}

package/dist/hierarchy/createTagField.js

@@ -0,0 +1,48 @@
+import { getHierarchyFieldName } from './constants.js';
+/**
+ * Creates a relationship field for tag-style hierarchies (multi-select by default).
+ *
+ * This field:
+ * - Has hasMany:true by default (multiple tag selection)
+ * - Is positioned in the sidebar by default
+ * - Does NOT inject a header button (tags use standard relationship UI)
+ *
+ * Use this in your collection's fields array to add a tag relationship.
+ * The field name is automatically generated based on the hierarchy slug.
+ *
+ * @example
+ * import { createTagField } from 'payload'
+ *
+ * const Posts: CollectionConfig = {
+ *   slug: 'posts',
+ *   fields: [
+ *     { name: 'title', type: 'text' },
+ *     createTagField({
+ *       relationTo: 'tags',
+ *       label: 'Tags',
+ *     }),
+ *   ],
+ * }
+ */ export function createTagField(options) {
+    const { admin: adminOverrides, hasMany = true, label, relationTo, ...restOptions } = options;
+    const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {};
+    return {
+        name: getHierarchyFieldName(relationTo),
+        type: 'relationship',
+        admin: {
+            position: 'sidebar',
+            ...restAdminOverrides,
+            components: {
+                Field: '@payloadcms/ui/rsc#HierarchyField',
+                ...componentOverrides
+            }
+        },
+        hasMany,
+        index: true,
+        label: label ?? 'Tags',
+        relationTo,
+        ...restOptions
+    };
+}
+
+//# sourceMappingURL=createTagField.js.map

package/dist/hierarchy/createTagField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/createTagField.ts"],"sourcesContent":["import type { RelationshipField } from '../fields/config/types.js'\n\nimport { getHierarchyFieldName } from './constants.js'\n\n/**\n * Options for creating a tag relationship field.\n * All RelationshipFieldMany properties are available except name, type, and relationTo\n * which are managed by the tag system.\n */\nexport type CreateTagFieldOptions = {\n  /**\n   * Whether to allow multiple tags (defaults to true)\n   * @default true\n   */\n  hasMany?: boolean\n  /**\n   * The slug of the hierarchy collection this field references (e.g., 'tags')\n   */\n  relationTo: string\n} & Pick<Partial<RelationshipField>, 'admin' | 'label' | 'required'>\n\n/**\n * Creates a relationship field for tag-style hierarchies (multi-select by default).\n *\n * This field:\n * - Has hasMany:true by default (multiple tag selection)\n * - Is positioned in the sidebar by default\n * - Does NOT inject a header button (tags use standard relationship UI)\n *\n * Use this in your collection's fields array to add a tag relationship.\n * The field name is automatically generated based on the hierarchy slug.\n *\n * @example\n * import { createTagField } from 'payload'\n *\n * const Posts: CollectionConfig = {\n *   slug: 'posts',\n *   fields: [\n *     { name: 'title', type: 'text' },\n *     createTagField({\n *       relationTo: 'tags',\n *       label: 'Tags',\n *     }),\n *   ],\n * }\n */\nexport function createTagField(options: CreateTagFieldOptions): RelationshipField {\n  const { admin: adminOverrides, hasMany = true, label, relationTo, ...restOptions } = options\n  const { components: componentOverrides, ...restAdminOverrides } = adminOverrides || {}\n\n  return {\n    name: getHierarchyFieldName(relationTo),\n    type: 'relationship',\n    admin: {\n      position: 'sidebar',\n      ...restAdminOverrides,\n      components: {\n        Field: '@payloadcms/ui/rsc#HierarchyField',\n        ...componentOverrides,\n      },\n    },\n    hasMany,\n    index: true,\n    label: label ?? 'Tags',\n    relationTo,\n    ...restOptions,\n  } as RelationshipField\n}\n"],"names":["getHierarchyFieldName","createTagField","options","admin","adminOverrides","hasMany","label","relationTo","restOptions","components","componentOverrides","restAdminOverrides","name","type","position","Field","index"],"mappings":"AAEA,SAASA,qBAAqB,QAAQ,iBAAgB;AAmBtD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,SAASC,eAAeC,OAA8B;IAC3D,MAAM,EAAEC,OAAOC,cAAc,EAAEC,UAAU,IAAI,EAAEC,KAAK,EAAEC,UAAU,EAAE,GAAGC,aAAa,GAAGN;IACrF,MAAM,EAAEO,YAAYC,kBAAkB,EAAE,GAAGC,oBAAoB,GAAGP,kBAAkB,CAAC;IAErF,OAAO;QACLQ,MAAMZ,sBAAsBO;QAC5BM,MAAM;QACNV,OAAO;YACLW,UAAU;YACV,GAAGH,kBAAkB;YACrBF,YAAY;gBACVM,OAAO;gBACP,GAAGL,kBAAkB;YACvB;QACF;QACAL;QACAW,OAAO;QACPV,OAAOA,SAAS;QAChBC;QACA,GAAGC,WAAW;IAChB;AACF"}

package/dist/hierarchy/getInitialTreeData.d.ts

@@ -0,0 +1,27 @@
+import type { TypeWithID } from '../collections/config/types.js';
+import type { PayloadRequest, Where } from '../types/index.js';
+export type GetInitialTreeDataArgs = {
+    /** Base filter to apply to all queries (e.g., tenant filter) */
+    baseFilter?: null | Where;
+    collectionSlug: string;
+    expandedNodeIds?: (number | string)[];
+    /** Filter tree to only show folders that allow these collection types (or are unrestricted) */
+    filterByCollections?: string[];
+    limit?: number;
+    payload: PayloadRequest['payload'];
+    /** The currently selected node ID. When provided, ensures siblings are loaded to include this node. */
+    selectedNodeId?: null | number | string;
+    /** The parent ID of the selected node. Required when selectedNodeId is provided. */
+    selectedNodeParentId?: null | number | string;
+    user: PayloadRequest['user'];
+};
+export type InitialTreeData = {
+    docs: TypeWithID[];
+    loadedParents: Record<string, {
+        hasMore: boolean;
+        loadedCount?: number;
+        totalDocs: number;
+    }>;
+};
+export declare const getInitialTreeData: ({ baseFilter, collectionSlug, expandedNodeIds, filterByCollections, limit, payload, selectedNodeId, selectedNodeParentId, user, }: GetInitialTreeDataArgs) => Promise<InitialTreeData>;
+//# sourceMappingURL=getInitialTreeData.d.ts.map

package/dist/hierarchy/getInitialTreeData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInitialTreeData.d.ts","sourceRoot":"","sources":["../../src/hierarchy/getInitialTreeData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAI9D,MAAM,MAAM,sBAAsB,GAAG;IACnC,gEAAgE;IAChE,UAAU,CAAC,EAAE,IAAI,GAAG,KAAK,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IACrC,+FAA+F;IAC/F,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAA;IAClC,uGAAuG;IACvG,cAAc,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IACvC,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAA;IAC7C,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,UAAU,EAAE,CAAA;IAElB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7F,CAAA;AAED,eAAO,MAAM,kBAAkB,sIAU5B,sBAAsB,KAAG,OAAO,CAAC,eAAe,CA0IlD,CAAA"}

package/dist/hierarchy/getInitialTreeData.js

@@ -0,0 +1,125 @@
+import { DEFAULT_HIERARCHY_TREE_LIMIT } from '../hierarchy/constants.js';
+export const getInitialTreeData = async ({ baseFilter, collectionSlug, expandedNodeIds = [], filterByCollections, limit, payload, selectedNodeId, selectedNodeParentId, user })=>{
+    const collectionConfig = payload.collections[collectionSlug]?.config;
+    if (!collectionConfig || !collectionConfig.hierarchy) {
+        throw new Error(`Collection ${collectionSlug} is not a hierarchy`);
+    }
+    const hierarchyConfig = collectionConfig.hierarchy;
+    const parentFieldName = hierarchyConfig.parentFieldName;
+    const useAsTitle = collectionConfig.admin?.useAsTitle ?? 'id';
+    // Get typeFieldName for filtering
+    const typeFieldName = hierarchyConfig.collectionSpecific && typeof hierarchyConfig.collectionSpecific === 'object' ? hierarchyConfig.collectionSpecific.fieldName : undefined;
+    // Build filter condition if filterByCollections is provided
+    // Exclude the hierarchy collection itself (folders always show folders)
+    const filteredTypes = filterByCollections?.filter((t)=>t !== collectionSlug);
+    // Get all possible type values from relatedCollections for detecting empty arrays
+    const allPossibleTypes = hierarchyConfig.relatedCollections ? Object.keys(hierarchyConfig.relatedCollections) : [];
+    const filterCondition = filteredTypes?.length && typeFieldName ? {
+        or: [
+            {
+                [typeFieldName]: {
+                    in: filteredTypes
+                }
+            },
+            {
+                [typeFieldName]: {
+                    exists: false
+                }
+            },
+            // Include unrestricted folders with empty allowedTypes array
+            // Using not_in with all possible values matches empty arrays in both MongoDB and Postgres
+            ...allPossibleTypes.length > 0 ? [
+                {
+                    [typeFieldName]: {
+                        not_in: allPossibleTypes
+                    }
+                }
+            ] : []
+        ]
+    } : null;
+    // Use limit from config if not provided, fallback to config's treeLimit
+    const effectiveLimit = limit ?? hierarchyConfig.admin?.treeLimit ?? DEFAULT_HIERARCHY_TREE_LIMIT;
+    const allDocs = [];
+    const loadedParents = {};
+    // Normalize selectedNodeParentId: treat null/undefined as 'null' (root level)
+    const normalizedSelectedParentId = selectedNodeParentId === null || selectedNodeParentId === undefined ? 'null' : String(selectedNodeParentId);
+    // Helper to check if selectedNodeId is among siblings at a given parent level
+    const needsSelectedNodeIncluded = (parentKey)=>{
+        return !!selectedNodeId && normalizedSelectedParentId === parentKey;
+    };
+    // Helper to fetch children with optional selectedNodeId inclusion
+    const fetchChildrenForParent = async (parentKey, parentCondition)=>{
+        const mustIncludeSelected = needsSelectedNodeIncluded(parentKey);
+        let accumulatedDocs = [];
+        let currentPage = 1;
+        let hasMore = true;
+        let totalDocs = 0;
+        let foundSelected = false;
+        // Combine parent condition with filter condition and baseFilter
+        const conditions = [
+            parentCondition
+        ];
+        if (filterCondition) {
+            conditions.push(filterCondition);
+        }
+        if (baseFilter) {
+            conditions.push(baseFilter);
+        }
+        const whereClause = conditions.length > 1 ? {
+            and: conditions
+        } : parentCondition;
+        while(hasMore){
+            const result = await payload.find({
+                collection: collectionSlug,
+                depth: 0,
+                limit: effectiveLimit,
+                overrideAccess: false,
+                page: currentPage,
+                sort: useAsTitle,
+                user,
+                where: whereClause
+            });
+            accumulatedDocs = [
+                ...accumulatedDocs,
+                ...result.docs
+            ];
+            totalDocs = result.totalDocs;
+            hasMore = result.hasNextPage;
+            // Check if selectedNodeId is in this page's results
+            if (mustIncludeSelected && !foundSelected) {
+                foundSelected = result.docs.some((doc)=>String(doc.id) === String(selectedNodeId));
+            }
+            // Stop if we've found the selected node OR we only need first page
+            if (!mustIncludeSelected || foundSelected || !hasMore) {
+                break;
+            }
+            currentPage++;
+        }
+        allDocs.push(...accumulatedDocs);
+        loadedParents[parentKey] = {
+            hasMore,
+            loadedCount: accumulatedDocs.length,
+            totalDocs
+        };
+    };
+    // Query 1: Fetch root nodes
+    await fetchChildrenForParent('null', {
+        [parentFieldName]: {
+            exists: false
+        }
+    });
+    // Query 2: For each expanded node, fetch its children
+    for (const parentId of expandedNodeIds){
+        await fetchChildrenForParent(String(parentId), {
+            [parentFieldName]: {
+                equals: parentId
+            }
+        });
+    }
+    return {
+        docs: allDocs,
+        loadedParents
+    };
+};
+
+//# sourceMappingURL=getInitialTreeData.js.map

package/dist/hierarchy/getInitialTreeData.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hierarchy/getInitialTreeData.ts"],"sourcesContent":["import type { TypeWithID } from '../collections/config/types.js'\nimport type { PayloadRequest, Where } from '../types/index.js'\n\nimport { DEFAULT_HIERARCHY_TREE_LIMIT } from '../hierarchy/constants.js'\n\nexport type GetInitialTreeDataArgs = {\n  /** Base filter to apply to all queries (e.g., tenant filter) */\n  baseFilter?: null | Where\n  collectionSlug: string\n  expandedNodeIds?: (number | string)[]\n  /** Filter tree to only show folders that allow these collection types (or are unrestricted) */\n  filterByCollections?: string[]\n  limit?: number\n  payload: PayloadRequest['payload']\n  /** The currently selected node ID. When provided, ensures siblings are loaded to include this node. */\n  selectedNodeId?: null | number | string\n  /** The parent ID of the selected node. Required when selectedNodeId is provided. */\n  selectedNodeParentId?: null | number | string\n  user: PayloadRequest['user']\n}\n\nexport type InitialTreeData = {\n  docs: TypeWithID[]\n  // Metadata about what was loaded - keyed by parent ID ('null' for root)\n  loadedParents: Record<string, { hasMore: boolean; loadedCount?: number; totalDocs: number }>\n}\n\nexport const getInitialTreeData = async ({\n  baseFilter,\n  collectionSlug,\n  expandedNodeIds = [],\n  filterByCollections,\n  limit,\n  payload,\n  selectedNodeId,\n  selectedNodeParentId,\n  user,\n}: GetInitialTreeDataArgs): Promise<InitialTreeData> => {\n  const collectionConfig = payload.collections[collectionSlug]?.config\n\n  if (!collectionConfig || !collectionConfig.hierarchy) {\n    throw new Error(`Collection ${collectionSlug} is not a hierarchy`)\n  }\n\n  const hierarchyConfig = collectionConfig.hierarchy\n  const parentFieldName = hierarchyConfig.parentFieldName\n  const useAsTitle = collectionConfig.admin?.useAsTitle ?? 'id'\n\n  // Get typeFieldName for filtering\n  const typeFieldName =\n    hierarchyConfig.collectionSpecific && typeof hierarchyConfig.collectionSpecific === 'object'\n      ? hierarchyConfig.collectionSpecific.fieldName\n      : undefined\n\n  // Build filter condition if filterByCollections is provided\n  // Exclude the hierarchy collection itself (folders always show folders)\n  const filteredTypes = filterByCollections?.filter((t) => t !== collectionSlug)\n\n  // Get all possible type values from relatedCollections for detecting empty arrays\n  const allPossibleTypes = hierarchyConfig.relatedCollections\n    ? Object.keys(hierarchyConfig.relatedCollections)\n    : []\n\n  const filterCondition =\n    filteredTypes?.length && typeFieldName\n      ? {\n          or: [\n            { [typeFieldName]: { in: filteredTypes } },\n            { [typeFieldName]: { exists: false } }, // Include unrestricted folders (field doesn't exist)\n            // Include unrestricted folders with empty allowedTypes array\n            // Using not_in with all possible values matches empty arrays in both MongoDB and Postgres\n            ...(allPossibleTypes.length > 0\n              ? [{ [typeFieldName]: { not_in: allPossibleTypes } }]\n              : []),\n          ],\n        }\n      : null\n\n  // Use limit from config if not provided, fallback to config's treeLimit\n  const effectiveLimit = limit ?? hierarchyConfig.admin?.treeLimit ?? DEFAULT_HIERARCHY_TREE_LIMIT\n\n  const allDocs: TypeWithID[] = []\n  const loadedParents: Record<\n    string,\n    { hasMore: boolean; loadedCount: number; totalDocs: number }\n  > = {}\n\n  // Normalize selectedNodeParentId: treat null/undefined as 'null' (root level)\n  const normalizedSelectedParentId =\n    selectedNodeParentId === null || selectedNodeParentId === undefined\n      ? 'null'\n      : String(selectedNodeParentId)\n\n  // Helper to check if selectedNodeId is among siblings at a given parent level\n  const needsSelectedNodeIncluded = (parentKey: string): boolean => {\n    return !!selectedNodeId && normalizedSelectedParentId === parentKey\n  }\n\n  // Helper to fetch children with optional selectedNodeId inclusion\n  const fetchChildrenForParent = async (\n    parentKey: string,\n    parentCondition: Where,\n  ): Promise<void> => {\n    const mustIncludeSelected = needsSelectedNodeIncluded(parentKey)\n    let accumulatedDocs: TypeWithID[] = []\n    let currentPage = 1\n    let hasMore = true\n    let totalDocs = 0\n    let foundSelected = false\n\n    // Combine parent condition with filter condition and baseFilter\n    const conditions: Where[] = [parentCondition]\n    if (filterCondition) {\n      conditions.push(filterCondition)\n    }\n    if (baseFilter) {\n      conditions.push(baseFilter)\n    }\n    const whereClause = conditions.length > 1 ? { and: conditions } : parentCondition\n\n    while (hasMore) {\n      const result = await payload.find({\n        collection: collectionSlug,\n        depth: 0,\n        limit: effectiveLimit,\n        overrideAccess: false,\n        page: currentPage,\n        sort: useAsTitle,\n        user,\n        where: whereClause,\n      })\n\n      accumulatedDocs = [...accumulatedDocs, ...result.docs]\n      totalDocs = result.totalDocs\n      hasMore = result.hasNextPage\n\n      // Check if selectedNodeId is in this page's results\n      if (mustIncludeSelected && !foundSelected) {\n        foundSelected = result.docs.some(\n          (doc: TypeWithID) => String(doc.id) === String(selectedNodeId),\n        )\n      }\n\n      // Stop if we've found the selected node OR we only need first page\n      if (!mustIncludeSelected || foundSelected || !hasMore) {\n        break\n      }\n\n      currentPage++\n    }\n\n    allDocs.push(...accumulatedDocs)\n    loadedParents[parentKey] = {\n      hasMore,\n      loadedCount: accumulatedDocs.length,\n      totalDocs,\n    }\n  }\n\n  // Query 1: Fetch root nodes\n  await fetchChildrenForParent('null', {\n    [parentFieldName]: { exists: false },\n  })\n\n  // Query 2: For each expanded node, fetch its children\n  for (const parentId of expandedNodeIds) {\n    await fetchChildrenForParent(String(parentId), {\n      [parentFieldName]: { equals: parentId },\n    })\n  }\n\n  return {\n    docs: allDocs,\n    loadedParents,\n  }\n}\n"],"names":["DEFAULT_HIERARCHY_TREE_LIMIT","getInitialTreeData","baseFilter","collectionSlug","expandedNodeIds","filterByCollections","limit","payload","selectedNodeId","selectedNodeParentId","user","collectionConfig","collections","config","hierarchy","Error","hierarchyConfig","parentFieldName","useAsTitle","admin","typeFieldName","collectionSpecific","fieldName","undefined","filteredTypes","filter","t","allPossibleTypes","relatedCollections","Object","keys","filterCondition","length","or","in","exists","not_in","effectiveLimit","treeLimit","allDocs","loadedParents","normalizedSelectedParentId","String","needsSelectedNodeIncluded","parentKey","fetchChildrenForParent","parentCondition","mustIncludeSelected","accumulatedDocs","currentPage","hasMore","totalDocs","foundSelected","conditions","push","whereClause","and","result","find","collection","depth","overrideAccess","page","sort","where","docs","hasNextPage","some","doc","id","loadedCount","parentId","equals"],"mappings":"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"}

package/dist/hierarchy/hooks/collectionAfterDelete.d.ts

@@ -0,0 +1,14 @@
+/**
+ * afterDelete Hook Responsibilities:
+ * - Clear folder references from related documents when folder is deleted
+ */
+import type { CollectionAfterDeleteHook } from '../../index.js';
+type Args = {
+    /**
+     * Map of collection slugs to their field names
+     */
+    relatedCollections: Record<string, string>;
+};
+export declare const hierarchyCollectionAfterDelete: ({ relatedCollections }: Args) => CollectionAfterDeleteHook;
+export {};
+//# sourceMappingURL=collectionAfterDelete.d.ts.map

package/dist/hierarchy/hooks/collectionAfterDelete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectionAfterDelete.d.ts","sourceRoot":"","sources":["../../../src/hierarchy/hooks/collectionAfterDelete.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAE/D,KAAK,IAAI,GAAG;IACV;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3C,CAAA;AAED,eAAO,MAAM,8BAA8B,2BAChB,IAAI,KAAG,yBAgB/B,CAAA"}

package/dist/hierarchy/hooks/collectionAfterDelete.js

@@ -0,0 +1,21 @@
+/**
+ * afterDelete Hook Responsibilities:
+ * - Clear folder references from related documents when folder is deleted
+ */ export const hierarchyCollectionAfterDelete = ({ relatedCollections })=>async ({ id, req })=>{
+        for (const [collectionSlug, fieldName] of Object.entries(relatedCollections)){
+            await req.payload.update({
+                collection: collectionSlug,
+                data: {
+                    [fieldName]: null
+                },
+                req,
+                where: {
+                    [fieldName]: {
+                        equals: id
+                    }
+                }
+            });
+        }
+    };
+
+//# sourceMappingURL=collectionAfterDelete.js.map

package/dist/hierarchy/hooks/collectionAfterDelete.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/hierarchy/hooks/collectionAfterDelete.ts"],"sourcesContent":["/**\n * afterDelete Hook Responsibilities:\n * - Clear folder references from related documents when folder is deleted\n */\n\nimport type { CollectionAfterDeleteHook } from '../../index.js'\n\ntype Args = {\n  /**\n   * Map of collection slugs to their field names\n   */\n  relatedCollections: Record<string, string>\n}\n\nexport const hierarchyCollectionAfterDelete =\n  ({ relatedCollections }: Args): CollectionAfterDeleteHook =>\n  async ({ id, req }) => {\n    for (const [collectionSlug, fieldName] of Object.entries(relatedCollections)) {\n      await req.payload.update({\n        collection: collectionSlug,\n        data: {\n          [fieldName]: null,\n        },\n        req,\n        where: {\n          [fieldName]: {\n            equals: id,\n          },\n        },\n      })\n    }\n  }\n"],"names":["hierarchyCollectionAfterDelete","relatedCollections","id","req","collectionSlug","fieldName","Object","entries","payload","update","collection","data","where","equals"],"mappings":"AAAA;;;CAGC,GAWD,OAAO,MAAMA,iCACX,CAAC,EAAEC,kBAAkB,EAAQ,GAC7B,OAAO,EAAEC,EAAE,EAAEC,GAAG,EAAE;QAChB,KAAK,MAAM,CAACC,gBAAgBC,UAAU,IAAIC,OAAOC,OAAO,CAACN,oBAAqB;YAC5E,MAAME,IAAIK,OAAO,CAACC,MAAM,CAAC;gBACvBC,YAAYN;gBACZO,MAAM;oBACJ,CAACN,UAAU,EAAE;gBACf;gBACAF;gBACAS,OAAO;oBACL,CAACP,UAAU,EAAE;wBACXQ,QAAQX;oBACV;gBACF;YACF;QACF;IACF,EAAC"}

package/dist/hierarchy/hooks/collectionAfterRead.d.ts

@@ -0,0 +1,27 @@
+/**
+ * afterRead Hook Responsibilities:
+ * - Automatically compute and attach _h_slugPath and _h_titlePath to documents
+ * - Use cached ancestors to optimize queries when reading multiple documents
+ * - Only computes when explicitly requested via:
+ *   1. context.computeHierarchyPaths flag
+ *   2. ?computeHierarchyPaths=true query param
+ *   3. Selecting path fields in query (select parameter)
+ */
+import type { CollectionAfterReadHook } from '../../index.js';
+type Args = {
+    /**
+     * The name of the field that contains the parent document ID
+     */
+    parentFieldName: string;
+    /**
+     * The name of the field to populate with the slug-based path
+     */
+    slugPathFieldName: string;
+    /**
+     * The name of the field to populate with the title-based path
+     */
+    titlePathFieldName: string;
+};
+export declare const hierarchyCollectionAfterRead: ({ parentFieldName, slugPathFieldName, titlePathFieldName }: Args) => CollectionAfterReadHook;
+export {};
+//# sourceMappingURL=collectionAfterRead.d.ts.map

package/dist/hierarchy/hooks/collectionAfterRead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectionAfterRead.d.ts","sourceRoot":"","sources":["../../../src/hierarchy/hooks/collectionAfterRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAkB,MAAM,gBAAgB,CAAA;AAgC7E,KAAK,IAAI,GAAG;IACV;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,eAAO,MAAM,4BAA4B,+DACsB,IAAI,KAAG,uBAuDnE,CAAA"}