@payloadcms/plugin-cloud-storage 4.0.0-internal.7e57eed → 4.0.0-internal.8001944

package/dist/utilities/getFileKey.js

@@ -1,23 +0,0 @@
-import path from 'path';
-import { sanitizeFilename } from 'payload/shared';
-import { sanitizePrefix } from './sanitizePrefix.js';
-/**
- * Computes the file key (path) for storage.
- *
- * In non-composite mode (useCompositePrefixes: false), docPrefix overrides collectionPrefix.
- * In composite mode (useCompositePrefixes: true), both are combined.
- * Both prefixes are passed through {@link sanitizePrefix} so keys stay normalized.
- */ export function getFileKey({ collectionPrefix, docPrefix, filename, useCompositePrefixes = false }) {
-    const safeCollectionPrefix = sanitizePrefix(collectionPrefix || '');
-    const safeDocPrefix = sanitizePrefix(docPrefix || '');
-    const safeFilename = sanitizeFilename(filename);
-    const fileKey = useCompositePrefixes ? path.posix.join(safeCollectionPrefix, safeDocPrefix, safeFilename) : path.posix.join(safeDocPrefix || safeCollectionPrefix, safeFilename);
-    return {
-        fileKey,
-        sanitizedCollectionPrefix: safeCollectionPrefix,
-        sanitizedDocPrefix: safeDocPrefix,
-        sanitizedFilename: safeFilename
-    };
-}
-
-//# sourceMappingURL=getFileKey.js.map

package/dist/utilities/getFileKey.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utilities/getFileKey.ts"],"sourcesContent":["import path from 'path'\nimport { sanitizeFilename } from 'payload/shared'\n\nimport { sanitizePrefix } from './sanitizePrefix.js'\n\ntype GetFileKeyArgs = {\n  collectionPrefix?: string\n  docPrefix?: string\n  filename: string\n  useCompositePrefixes?: boolean\n}\n\ntype GetFileKeyResult = {\n  fileKey: string\n  sanitizedCollectionPrefix: string\n  sanitizedDocPrefix: string\n  sanitizedFilename: string\n}\n\n/**\n * Computes the file key (path) for storage.\n *\n * In non-composite mode (useCompositePrefixes: false), docPrefix overrides collectionPrefix.\n * In composite mode (useCompositePrefixes: true), both are combined.\n * Both prefixes are passed through {@link sanitizePrefix} so keys stay normalized.\n */\nexport function getFileKey({\n  collectionPrefix,\n  docPrefix,\n  filename,\n  useCompositePrefixes = false,\n}: GetFileKeyArgs): GetFileKeyResult {\n  const safeCollectionPrefix = sanitizePrefix(collectionPrefix || '')\n  const safeDocPrefix = sanitizePrefix(docPrefix || '')\n  const safeFilename = sanitizeFilename(filename)\n\n  const fileKey = useCompositePrefixes\n    ? path.posix.join(safeCollectionPrefix, safeDocPrefix, safeFilename)\n    : path.posix.join(safeDocPrefix || safeCollectionPrefix, safeFilename)\n\n  return {\n    fileKey,\n    sanitizedCollectionPrefix: safeCollectionPrefix,\n    sanitizedDocPrefix: safeDocPrefix,\n    sanitizedFilename: safeFilename,\n  }\n}\n"],"names":["path","sanitizeFilename","sanitizePrefix","getFileKey","collectionPrefix","docPrefix","filename","useCompositePrefixes","safeCollectionPrefix","safeDocPrefix","safeFilename","fileKey","posix","join","sanitizedCollectionPrefix","sanitizedDocPrefix","sanitizedFilename"],"mappings":"AAAA,OAAOA,UAAU,OAAM;AACvB,SAASC,gBAAgB,QAAQ,iBAAgB;AAEjD,SAASC,cAAc,QAAQ,sBAAqB;AAgBpD;;;;;;CAMC,GACD,OAAO,SAASC,WAAW,EACzBC,gBAAgB,EAChBC,SAAS,EACTC,QAAQ,EACRC,uBAAuB,KAAK,EACb;IACf,MAAMC,uBAAuBN,eAAeE,oBAAoB;IAChE,MAAMK,gBAAgBP,eAAeG,aAAa;IAClD,MAAMK,eAAeT,iBAAiBK;IAEtC,MAAMK,UAAUJ,uBACZP,KAAKY,KAAK,CAACC,IAAI,CAACL,sBAAsBC,eAAeC,gBACrDV,KAAKY,KAAK,CAACC,IAAI,CAACJ,iBAAiBD,sBAAsBE;IAE3D,OAAO;QACLC;QACAG,2BAA2BN;QAC3BO,oBAAoBN;QACpBO,mBAAmBN;IACrB;AACF"}

package/dist/utilities/getFileKey.spec.js

@@ -1,174 +0,0 @@
-import { getFileKey } from './getFileKey.js';
-import { describe, expect, it } from 'vitest';
-describe('getFileKey', ()=>{
-    describe('non-composite mode (useCompositePrefixes: false)', ()=>{
-        it('should use docPrefix when provided, ignoring collectionPrefix', ()=>{
-            const result = getFileKey({
-                collectionPrefix: 'collection',
-                docPrefix: 'document',
-                filename: 'test.png',
-                useCompositePrefixes: false
-            });
-            expect(result).toEqual({
-                fileKey: 'document/test.png',
-                sanitizedCollectionPrefix: 'collection',
-                sanitizedDocPrefix: 'document',
-                sanitizedFilename: 'test.png'
-            });
-        });
-        it('should fallback to collectionPrefix when docPrefix is empty', ()=>{
-            const result = getFileKey({
-                collectionPrefix: 'collection',
-                docPrefix: '',
-                filename: 'test.png',
-                useCompositePrefixes: false
-            });
-            expect(result).toEqual({
-                fileKey: 'collection/test.png',
-                sanitizedCollectionPrefix: 'collection',
-                sanitizedDocPrefix: '',
-                sanitizedFilename: 'test.png'
-            });
-        });
-        it('should fallback to collectionPrefix when docPrefix is undefined', ()=>{
-            const result = getFileKey({
-                collectionPrefix: 'collection',
-                filename: 'test.png',
-                useCompositePrefixes: false
-            });
-            expect(result).toEqual({
-                fileKey: 'collection/test.png',
-                sanitizedCollectionPrefix: 'collection',
-                sanitizedDocPrefix: '',
-                sanitizedFilename: 'test.png'
-            });
-        });
-        it('should return only filename when both prefixes are empty', ()=>{
-            const result = getFileKey({
-                filename: 'test.png',
-                useCompositePrefixes: false
-            });
-            expect(result).toEqual({
-                fileKey: 'test.png',
-                sanitizedCollectionPrefix: '',
-                sanitizedDocPrefix: '',
-                sanitizedFilename: 'test.png'
-            });
-        });
-    });
-    describe('composite mode (useCompositePrefixes: true)', ()=>{
-        it('should combine collectionPrefix and docPrefix', ()=>{
-            const result = getFileKey({
-                collectionPrefix: 'collection',
-                docPrefix: 'document',
-                filename: 'test.png',
-                useCompositePrefixes: true
-            });
-            expect(result).toEqual({
-                fileKey: 'collection/document/test.png',
-                sanitizedCollectionPrefix: 'collection',
-                sanitizedDocPrefix: 'document',
-                sanitizedFilename: 'test.png'
-            });
-        });
-        it('should work with only collectionPrefix', ()=>{
-            const result = getFileKey({
-                collectionPrefix: 'collection',
-                filename: 'test.png',
-                useCompositePrefixes: true
-            });
-            expect(result).toEqual({
-                fileKey: 'collection/test.png',
-                sanitizedCollectionPrefix: 'collection',
-                sanitizedDocPrefix: '',
-                sanitizedFilename: 'test.png'
-            });
-        });
-        it('should work with only docPrefix', ()=>{
-            const result = getFileKey({
-                docPrefix: 'document',
-                filename: 'test.png',
-                useCompositePrefixes: true
-            });
-            expect(result).toEqual({
-                fileKey: 'document/test.png',
-                sanitizedCollectionPrefix: '',
-                sanitizedDocPrefix: 'document',
-                sanitizedFilename: 'test.png'
-            });
-        });
-        it('should return only filename when both prefixes are empty', ()=>{
-            const result = getFileKey({
-                filename: 'test.png',
-                useCompositePrefixes: true
-            });
-            expect(result).toEqual({
-                fileKey: 'test.png',
-                sanitizedCollectionPrefix: '',
-                sanitizedDocPrefix: '',
-                sanitizedFilename: 'test.png'
-            });
-        });
-    });
-    describe('sanitization', ()=>{
-        it('should remove path traversal segments from collectionPrefix', ()=>{
-            const result = getFileKey({
-                collectionPrefix: '../../../etc',
-                filename: 'test.png',
-                useCompositePrefixes: false
-            });
-            expect(result).toEqual({
-                fileKey: 'etc/test.png',
-                sanitizedCollectionPrefix: 'etc',
-                sanitizedDocPrefix: '',
-                sanitizedFilename: 'test.png'
-            });
-            expect(result.fileKey).not.toContain('..');
-        });
-        it('should remove path traversal segments from docPrefix', ()=>{
-            const result = getFileKey({
-                docPrefix: 'a/../../outside',
-                filename: 'test.png',
-                useCompositePrefixes: false
-            });
-            expect(result).toEqual({
-                fileKey: 'a/outside/test.png',
-                sanitizedCollectionPrefix: '',
-                sanitizedDocPrefix: 'a/outside',
-                sanitizedFilename: 'test.png'
-            });
-            expect(result.fileKey).not.toContain('..');
-        });
-        it('should remove control characters from prefixes', ()=>{
-            const result = getFileKey({
-                collectionPrefix: 'test\x00\x1fprefix',
-                filename: 'test.png',
-                useCompositePrefixes: false
-            });
-            expect(result).toEqual({
-                fileKey: 'testprefix/test.png',
-                sanitizedCollectionPrefix: 'testprefix',
-                sanitizedDocPrefix: '',
-                sanitizedFilename: 'test.png'
-            });
-            expect(result.fileKey).not.toMatch(/[\x00-\x1f]/);
-        });
-        it('should sanitize both prefixes in composite mode', ()=>{
-            const result = getFileKey({
-                collectionPrefix: '../collection',
-                docPrefix: '../../doc',
-                filename: 'test.png',
-                useCompositePrefixes: true
-            });
-            expect(result).toEqual({
-                fileKey: 'collection/doc/test.png',
-                sanitizedCollectionPrefix: 'collection',
-                sanitizedDocPrefix: 'doc',
-                sanitizedFilename: 'test.png'
-            });
-            expect(result.fileKey).not.toContain('..');
-        });
-    });
-});
-
-//# sourceMappingURL=getFileKey.spec.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utilities/getFileKey.spec.ts"],"sourcesContent":["import { getFileKey } from './getFileKey.js'\nimport { describe, expect, it } from 'vitest'\n\ndescribe('getFileKey', () => {\n  describe('non-composite mode (useCompositePrefixes: false)', () => {\n    it('should use docPrefix when provided, ignoring collectionPrefix', () => {\n      const result = getFileKey({\n        collectionPrefix: 'collection',\n        docPrefix: 'document',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        fileKey: 'document/test.png',\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: 'document',\n        sanitizedFilename: 'test.png',\n      })\n    })\n\n    it('should fallback to collectionPrefix when docPrefix is empty', () => {\n      const result = getFileKey({\n        collectionPrefix: 'collection',\n        docPrefix: '',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        fileKey: 'collection/test.png',\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n      })\n    })\n\n    it('should fallback to collectionPrefix when docPrefix is undefined', () => {\n      const result = getFileKey({\n        collectionPrefix: 'collection',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        fileKey: 'collection/test.png',\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n      })\n    })\n\n    it('should return only filename when both prefixes are empty', () => {\n      const result = getFileKey({\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        fileKey: 'test.png',\n        sanitizedCollectionPrefix: '',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n      })\n    })\n  })\n\n  describe('composite mode (useCompositePrefixes: true)', () => {\n    it('should combine collectionPrefix and docPrefix', () => {\n      const result = getFileKey({\n        collectionPrefix: 'collection',\n        docPrefix: 'document',\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        fileKey: 'collection/document/test.png',\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: 'document',\n        sanitizedFilename: 'test.png',\n      })\n    })\n\n    it('should work with only collectionPrefix', () => {\n      const result = getFileKey({\n        collectionPrefix: 'collection',\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        fileKey: 'collection/test.png',\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n      })\n    })\n\n    it('should work with only docPrefix', () => {\n      const result = getFileKey({\n        docPrefix: 'document',\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        fileKey: 'document/test.png',\n        sanitizedCollectionPrefix: '',\n        sanitizedDocPrefix: 'document',\n        sanitizedFilename: 'test.png',\n      })\n    })\n\n    it('should return only filename when both prefixes are empty', () => {\n      const result = getFileKey({\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        fileKey: 'test.png',\n        sanitizedCollectionPrefix: '',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n      })\n    })\n  })\n\n  describe('sanitization', () => {\n    it('should remove path traversal segments from collectionPrefix', () => {\n      const result = getFileKey({\n        collectionPrefix: '../../../etc',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        fileKey: 'etc/test.png',\n        sanitizedCollectionPrefix: 'etc',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n      })\n      expect(result.fileKey).not.toContain('..')\n    })\n\n    it('should remove path traversal segments from docPrefix', () => {\n      const result = getFileKey({\n        docPrefix: 'a/../../outside',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        fileKey: 'a/outside/test.png',\n        sanitizedCollectionPrefix: '',\n        sanitizedDocPrefix: 'a/outside',\n        sanitizedFilename: 'test.png',\n      })\n      expect(result.fileKey).not.toContain('..')\n    })\n\n    it('should remove control characters from prefixes', () => {\n      const result = getFileKey({\n        collectionPrefix: 'test\\x00\\x1fprefix',\n        filename: 'test.png',\n        useCompositePrefixes: false,\n      })\n      expect(result).toEqual({\n        fileKey: 'testprefix/test.png',\n        sanitizedCollectionPrefix: 'testprefix',\n        sanitizedDocPrefix: '',\n        sanitizedFilename: 'test.png',\n      })\n      expect(result.fileKey).not.toMatch(/[\\x00-\\x1f]/)\n    })\n\n    it('should sanitize both prefixes in composite mode', () => {\n      const result = getFileKey({\n        collectionPrefix: '../collection',\n        docPrefix: '../../doc',\n        filename: 'test.png',\n        useCompositePrefixes: true,\n      })\n      expect(result).toEqual({\n        fileKey: 'collection/doc/test.png',\n        sanitizedCollectionPrefix: 'collection',\n        sanitizedDocPrefix: 'doc',\n        sanitizedFilename: 'test.png',\n      })\n      expect(result.fileKey).not.toContain('..')\n    })\n  })\n})\n"],"names":["getFileKey","describe","expect","it","result","collectionPrefix","docPrefix","filename","useCompositePrefixes","toEqual","fileKey","sanitizedCollectionPrefix","sanitizedDocPrefix","sanitizedFilename","not","toContain","toMatch"],"mappings":"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"}

package/dist/utilities/getFilePrefix.spec.js

@@ -1,105 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { getFilePrefix } from './getFilePrefix.js';
-const makeReq = (docs = [])=>({
-        payload: {
-            find: vi.fn().mockResolvedValue({
-                docs
-            })
-        }
-    });
-const makeCollection = ()=>({
-        slug: 'media',
-        upload: {}
-    });
-describe('getFilePrefix', ()=>{
-    describe('prefixQueryParam shortcut', ()=>{
-        it('should return prefixQueryParam immediately without querying the database', async ()=>{
-            const req = makeReq();
-            const result = await getFilePrefix({
-                collection: makeCollection(),
-                prefixQueryParam: 'uuid-prefix',
-                filename: 'logo.png',
-                req
-            });
-            expect(result).toBe('uuid-prefix');
-            expect(req.payload.find).not.toHaveBeenCalled();
-        });
-        it('should return an empty string when prefixQueryParam is an empty string', async ()=>{
-            const req = makeReq();
-            const result = await getFilePrefix({
-                collection: makeCollection(),
-                prefixQueryParam: '',
-                filename: 'logo.png',
-                req
-            });
-            expect(result).toBe('');
-            expect(req.payload.find).not.toHaveBeenCalled();
-        });
-        it('should reject multi-encoded values', async ()=>{
-            const req = makeReq();
-            const result = await getFilePrefix({
-                collection: makeCollection(),
-                prefixQueryParam: '%252e%252e%252fsecret%252f..%252fok',
-                filename: 'logo.png',
-                req
-            });
-            expect(result).toBe('');
-            expect(req.payload.find).not.toHaveBeenCalled();
-        });
-        it('should reject malformed percent-encoding', async ()=>{
-            const req = makeReq();
-            const result = await getFilePrefix({
-                collection: makeCollection(),
-                prefixQueryParam: '%E0%A4%A',
-                filename: 'logo.png',
-                req
-            });
-            expect(result).toBe('');
-            expect(req.payload.find).not.toHaveBeenCalled();
-        });
-    });
-    describe('database fallback', ()=>{
-        it('should query the database when prefixQueryParam is not provided', async ()=>{
-            const req = makeReq([
-                {
-                    prefix: 'db-prefix'
-                }
-            ]);
-            const result = await getFilePrefix({
-                collection: makeCollection(),
-                filename: 'logo.png',
-                req
-            });
-            expect(result).toBe('db-prefix');
-            expect(req.payload.find).toHaveBeenCalledOnce();
-        });
-        it('should return empty string when no document is found', async ()=>{
-            const req = makeReq([]);
-            const result = await getFilePrefix({
-                collection: makeCollection(),
-                filename: 'logo.png',
-                req
-            });
-            expect(result).toBe('');
-        });
-        it('should prioritize the upload reference prefix over the database query', async ()=>{
-            const req = makeReq([
-                {
-                    prefix: 'db-prefix'
-                }
-            ]);
-            const result = await getFilePrefix({
-                collection: makeCollection(),
-                uploadReference: {
-                    prefix: 'context-prefix'
-                },
-                filename: 'logo.png',
-                req
-            });
-            expect(result).toBe('context-prefix');
-            expect(req.payload.find).not.toHaveBeenCalled();
-        });
-    });
-});
-
-//# sourceMappingURL=getFilePrefix.spec.js.map

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/utilities/getFilePrefix.spec.ts"],"sourcesContent":["import { describe, expect, it, vi } from 'vitest'\n\nimport type { CollectionConfig, PayloadRequest } from 'payload'\n\nimport { getFilePrefix } from './getFilePrefix.js'\n\nconst makeReq = (docs: unknown[] = []) =>\n  ({\n    payload: {\n      find: vi.fn().mockResolvedValue({ docs }),\n    },\n  }) as unknown as PayloadRequest\n\nconst makeCollection = (): CollectionConfig =>\n  ({ slug: 'media', upload: {} }) as unknown as CollectionConfig\n\ndescribe('getFilePrefix', () => {\n  describe('prefixQueryParam shortcut', () => {\n    it('should return prefixQueryParam immediately without querying the database', async () => {\n      const req = makeReq()\n\n      const result = await getFilePrefix({\n        collection: makeCollection(),\n        prefixQueryParam: 'uuid-prefix',\n        filename: 'logo.png',\n        req,\n      })\n\n      expect(result).toBe('uuid-prefix')\n      expect(req.payload.find).not.toHaveBeenCalled()\n    })\n\n    it('should return an empty string when prefixQueryParam is an empty string', async () => {\n      const req = makeReq()\n\n      const result = await getFilePrefix({\n        collection: makeCollection(),\n        prefixQueryParam: '',\n        filename: 'logo.png',\n        req,\n      })\n\n      expect(result).toBe('')\n      expect(req.payload.find).not.toHaveBeenCalled()\n    })\n\n    it('should reject multi-encoded values', async () => {\n      const req = makeReq()\n\n      const result = await getFilePrefix({\n        collection: makeCollection(),\n        prefixQueryParam: '%252e%252e%252fsecret%252f..%252fok',\n        filename: 'logo.png',\n        req,\n      })\n\n      expect(result).toBe('')\n      expect(req.payload.find).not.toHaveBeenCalled()\n    })\n\n    it('should reject malformed percent-encoding', async () => {\n      const req = makeReq()\n\n      const result = await getFilePrefix({\n        collection: makeCollection(),\n        prefixQueryParam: '%E0%A4%A',\n        filename: 'logo.png',\n        req,\n      })\n\n      expect(result).toBe('')\n      expect(req.payload.find).not.toHaveBeenCalled()\n    })\n  })\n\n  describe('database fallback', () => {\n    it('should query the database when prefixQueryParam is not provided', async () => {\n      const req = makeReq([{ prefix: 'db-prefix' }])\n\n      const result = await getFilePrefix({\n        collection: makeCollection(),\n        filename: 'logo.png',\n        req,\n      })\n\n      expect(result).toBe('db-prefix')\n      expect(req.payload.find).toHaveBeenCalledOnce()\n    })\n\n    it('should return empty string when no document is found', async () => {\n      const req = makeReq([])\n\n      const result = await getFilePrefix({\n        collection: makeCollection(),\n        filename: 'logo.png',\n        req,\n      })\n\n      expect(result).toBe('')\n    })\n\n    it('should prioritize the upload reference prefix over the database query', async () => {\n      const req = makeReq([{ prefix: 'db-prefix' }])\n\n      const result = await getFilePrefix({\n        collection: makeCollection(),\n        uploadReference: { prefix: 'context-prefix' },\n        filename: 'logo.png',\n        req,\n      })\n\n      expect(result).toBe('context-prefix')\n      expect(req.payload.find).not.toHaveBeenCalled()\n    })\n  })\n})\n"],"names":["describe","expect","it","vi","getFilePrefix","makeReq","docs","payload","find","fn","mockResolvedValue","makeCollection","slug","upload","req","result","collection","prefixQueryParam","filename","toBe","not","toHaveBeenCalled","prefix","toHaveBeenCalledOnce","uploadReference"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,MAAM,EAAEC,EAAE,EAAEC,EAAE,QAAQ,SAAQ;AAIjD,SAASC,aAAa,QAAQ,qBAAoB;AAElD,MAAMC,UAAU,CAACC,OAAkB,EAAE,GAClC,CAAA;QACCC,SAAS;YACPC,MAAML,GAAGM,EAAE,GAAGC,iBAAiB,CAAC;gBAAEJ;YAAK;QACzC;IACF,CAAA;AAEF,MAAMK,iBAAiB,IACpB,CAAA;QAAEC,MAAM;QAASC,QAAQ,CAAC;IAAE,CAAA;AAE/Bb,SAAS,iBAAiB;IACxBA,SAAS,6BAA6B;QACpCE,GAAG,4EAA4E;YAC7E,MAAMY,MAAMT;YAEZ,MAAMU,SAAS,MAAMX,cAAc;gBACjCY,YAAYL;gBACZM,kBAAkB;gBAClBC,UAAU;gBACVJ;YACF;YAEAb,OAAOc,QAAQI,IAAI,CAAC;YACpBlB,OAAOa,IAAIP,OAAO,CAACC,IAAI,EAAEY,GAAG,CAACC,gBAAgB;QAC/C;QAEAnB,GAAG,0EAA0E;YAC3E,MAAMY,MAAMT;YAEZ,MAAMU,SAAS,MAAMX,cAAc;gBACjCY,YAAYL;gBACZM,kBAAkB;gBAClBC,UAAU;gBACVJ;YACF;YAEAb,OAAOc,QAAQI,IAAI,CAAC;YACpBlB,OAAOa,IAAIP,OAAO,CAACC,IAAI,EAAEY,GAAG,CAACC,gBAAgB;QAC/C;QAEAnB,GAAG,sCAAsC;YACvC,MAAMY,MAAMT;YAEZ,MAAMU,SAAS,MAAMX,cAAc;gBACjCY,YAAYL;gBACZM,kBAAkB;gBAClBC,UAAU;gBACVJ;YACF;YAEAb,OAAOc,QAAQI,IAAI,CAAC;YACpBlB,OAAOa,IAAIP,OAAO,CAACC,IAAI,EAAEY,GAAG,CAACC,gBAAgB;QAC/C;QAEAnB,GAAG,4CAA4C;YAC7C,MAAMY,MAAMT;YAEZ,MAAMU,SAAS,MAAMX,cAAc;gBACjCY,YAAYL;gBACZM,kBAAkB;gBAClBC,UAAU;gBACVJ;YACF;YAEAb,OAAOc,QAAQI,IAAI,CAAC;YACpBlB,OAAOa,IAAIP,OAAO,CAACC,IAAI,EAAEY,GAAG,CAACC,gBAAgB;QAC/C;IACF;IAEArB,SAAS,qBAAqB;QAC5BE,GAAG,mEAAmE;YACpE,MAAMY,MAAMT,QAAQ;gBAAC;oBAAEiB,QAAQ;gBAAY;aAAE;YAE7C,MAAMP,SAAS,MAAMX,cAAc;gBACjCY,YAAYL;gBACZO,UAAU;gBACVJ;YACF;YAEAb,OAAOc,QAAQI,IAAI,CAAC;YACpBlB,OAAOa,IAAIP,OAAO,CAACC,IAAI,EAAEe,oBAAoB;QAC/C;QAEArB,GAAG,wDAAwD;YACzD,MAAMY,MAAMT,QAAQ,EAAE;YAEtB,MAAMU,SAAS,MAAMX,cAAc;gBACjCY,YAAYL;gBACZO,UAAU;gBACVJ;YACF;YAEAb,OAAOc,QAAQI,IAAI,CAAC;QACtB;QAEAjB,GAAG,yEAAyE;YAC1E,MAAMY,MAAMT,QAAQ;gBAAC;oBAAEiB,QAAQ;gBAAY;aAAE;YAE7C,MAAMP,SAAS,MAAMX,cAAc;gBACjCY,YAAYL;gBACZa,iBAAiB;oBAAEF,QAAQ;gBAAiB;gBAC5CJ,UAAU;gBACVJ;YACF;YAEAb,OAAOc,QAAQI,IAAI,CAAC;YACpBlB,OAAOa,IAAIP,OAAO,CAACC,IAAI,EAAEY,GAAG,CAACC,gBAAgB;QAC/C;IACF;AACF"}