payload 4.0.0-internal.fa345ef → 4.0.0-internal.fec2230

package/skills/payload/reference/QUERIES.md

@@ -0,0 +1,274 @@
+# Payload Querying Reference
+
+Complete reference for querying data across Local API, REST, and GraphQL.
+
+## Query Operators
+
+```ts
+import type { Where } from 'payload'
+
+// Equals
+const equalsQuery: Where = { color: { equals: 'blue' } }
+
+// Not equals
+const notEqualsQuery: Where = { status: { not_equals: 'draft' } }
+
+// Greater/less than
+const greaterThanQuery: Where = { price: { greater_than: 100 } }
+const lessThanEqualQuery: Where = { age: { less_than_equal: 65 } }
+
+// Contains (case-insensitive)
+const containsQuery: Where = { title: { contains: 'payload' } }
+
+// Like (all words present)
+const likeQuery: Where = { description: { like: 'cms headless' } }
+
+// In/not in
+const inQuery: Where = { category: { in: ['tech', 'news'] } }
+
+// Exists
+const existsQuery: Where = { image: { exists: true } }
+
+// Near (point fields)
+const nearQuery: Where = { location: { near: '-122.4194,37.7749,10000' } }
+```
+
+## AND/OR Logic
+
+```ts
+import type { Where } from 'payload'
+
+const complexQuery: Where = {
+  or: [
+    { color: { equals: 'mint' } },
+    {
+      and: [{ color: { equals: 'white' } }, { featured: { equals: false } }],
+    },
+  ],
+}
+```
+
+## Nested Properties
+
+```ts
+import type { Where } from 'payload'
+
+const nestedQuery: Where = {
+  'author.role': { equals: 'editor' },
+  'meta.featured': { exists: true },
+}
+```
+
+## Local API
+
+```ts
+// Find documents
+const posts = await payload.find({
+  collection: 'posts',
+  where: {
+    status: { equals: 'published' },
+    'author.name': { contains: 'john' },
+  },
+  depth: 2,
+  limit: 10,
+  page: 1,
+  sort: '-createdAt',
+  locale: 'en',
+  select: {
+    title: true,
+    author: true,
+  },
+})
+
+// Find by ID
+const post = await payload.findByID({
+  collection: 'posts',
+  id: '123',
+  depth: 2,
+})
+
+// Create
+const post = await payload.create({
+  collection: 'posts',
+  data: {
+    title: 'New Post',
+    status: 'draft',
+  },
+})
+
+// Update
+await payload.update({
+  collection: 'posts',
+  id: '123',
+  data: {
+    status: 'published',
+  },
+})
+
+// Delete
+await payload.delete({
+  collection: 'posts',
+  id: '123',
+})
+
+// Count
+const count = await payload.count({
+  collection: 'posts',
+  where: {
+    status: { equals: 'published' },
+  },
+})
+```
+
+### Threading req Parameter
+
+When performing operations in hooks or nested operations, pass the `req` parameter to maintain transaction context:
+
+```ts
+// ✅ CORRECT: Pass req for transaction safety
+const afterChange: CollectionAfterChangeHook = async ({ doc, req }) => {
+  await req.payload.create({
+    collection: 'audit-log',
+    data: { action: 'created', docId: doc.id },
+    req, // Maintains transaction atomicity
+  })
+}
+
+// ❌ WRONG: Missing req breaks transaction
+const afterChange: CollectionAfterChangeHook = async ({ doc, req }) => {
+  await req.payload.create({
+    collection: 'audit-log',
+    data: { action: 'created', docId: doc.id },
+    // Missing req - runs in separate transaction
+  })
+}
+```
+
+This is critical for MongoDB replica sets and Postgres. See [ADAPTERS.md#threading-req-through-operations](ADAPTERS.md#threading-req-through-operations) for details.
+
+### Access Control in Local API
+
+**Important**: Local API bypasses access control by default (`overrideAccess: true`). When passing a `user` parameter, you must explicitly set `overrideAccess: false` to respect that user's permissions.
+
+```ts
+// ❌ WRONG: User is passed but access control is bypassed
+const posts = await payload.find({
+  collection: 'posts',
+  user: currentUser,
+  // Missing: overrideAccess: false
+  // Result: Operation runs with ADMIN privileges, ignoring user's permissions
+})
+
+// ✅ CORRECT: Respects user's access control permissions
+const posts = await payload.find({
+  collection: 'posts',
+  user: currentUser,
+  overrideAccess: false, // Required to enforce access control
+  // Result: User only sees posts they have permission to read
+})
+
+// Administrative operation (intentionally bypass access control)
+const allPosts = await payload.find({
+  collection: 'posts',
+  // No user parameter
+  // overrideAccess defaults to true
+  // Result: Returns all posts regardless of access control
+})
+```
+
+**When to use `overrideAccess: false`:**
+
+- Performing operations on behalf of a user
+- Testing access control logic
+- API routes that should respect user permissions
+- Any operation where `user` parameter is provided
+
+**When `overrideAccess: true` is appropriate:**
+
+- Administrative operations (migrations, seeds, cron jobs)
+- Internal system operations
+- Operations explicitly intended to bypass access control
+
+See [ACCESS-CONTROL.md#important-notes](ACCESS-CONTROL.md#important-notes) for more details.
+
+## REST API
+
+```ts
+import { stringify } from 'qs-esm'
+
+const query = {
+  status: { equals: 'published' },
+}
+
+const queryString = stringify(
+  {
+    where: query,
+    depth: 2,
+    limit: 10,
+  },
+  { addQueryPrefix: true },
+)
+
+const response = await fetch(`https://api.example.com/api/posts${queryString}`)
+const data = await response.json()
+```
+
+### REST Endpoints
+
+```txt
+GET    /api/{collection}           - Find documents
+GET    /api/{collection}/{id}      - Find by ID
+POST   /api/{collection}           - Create
+PATCH  /api/{collection}/{id}      - Update
+DELETE /api/{collection}/{id}      - Delete
+GET    /api/{collection}/count     - Count documents
+
+GET    /api/globals/{slug}         - Get global
+POST   /api/globals/{slug}         - Update global
+```
+
+## GraphQL
+
+```graphql
+query {
+  Posts(where: { status: { equals: published } }, limit: 10, sort: "-createdAt") {
+    docs {
+      id
+      title
+      author {
+        name
+      }
+    }
+    totalDocs
+    hasNextPage
+  }
+}
+
+mutation {
+  createPost(data: { title: "New Post", status: draft }) {
+    id
+    title
+  }
+}
+
+mutation {
+  updatePost(id: "123", data: { status: published }) {
+    id
+    status
+  }
+}
+
+mutation {
+  deletePost(id: "123") {
+    id
+  }
+}
+```
+
+## Performance Best Practices
+
+- Set `maxDepth` on relationships to prevent over-fetching
+- Use `select` to limit returned fields
+- Index frequently queried fields
+- Use `virtual` fields for computed data
+- Cache expensive operations in hook `context`

package/dist/bin/build.d.ts

@@ -1,25 +0,0 @@
-import type { SanitizedConfig } from '../config/types.js';
-/**
- * `payload build` — generate the import map (and types) so they are on disk
- * before `next build` statically imports them, then run the project's Next.js
- * build, forwarding any extra CLI args verbatim.
- *
- * Owns its own process lifecycle: it exits with `next build`'s exit code, or
- * exits 1 if pre-build generation fails (never builds against a stale map).
- */
-export declare function build({ config }: {
-    config: SanitizedConfig;
-}): Promise<void>;
-/**
- * Resolve the project's `next` binary from its own manifest, robust to a future
- * `exports` field and to internal layout changes. Resolving from `cwd` (not
- * PATH) works whether `payload build` runs via an npm script or `npx`.
- */
-export declare function resolveNextBin(cwd?: string): string;
-/**
- * Forward the raw args that follow the `build` subcommand to `next build`,
- * dropping payload-only flags. Uses raw argv (not minimist) so flags like
- * `--turbopack` or `--experimental-build-mode` pass through verbatim.
- */
-export declare function getForwardedArgs(argv?: string[]): string[];
-//# sourceMappingURL=build.d.ts.map

package/dist/bin/build.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/bin/build.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAKzD;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,eAAe,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgClF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAmBlE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,MAAM,EAAE,CAIjF"}

package/dist/bin/build.js

@@ -1,80 +0,0 @@
-/* eslint-disable no-console */ import { spawn } from 'node:child_process';
-import { readFileSync } from 'node:fs';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { generateImportMap } from './generateImportMap/index.js';
-import { generateTypes } from './generateTypes.js';
-/**
- * `payload build` — generate the import map (and types) so they are on disk
- * before `next build` statically imports them, then run the project's Next.js
- * build, forwarding any extra CLI args verbatim.
- *
- * Owns its own process lifecycle: it exits with `next build`'s exit code, or
- * exits 1 if pre-build generation fails (never builds against a stale map).
- */ export async function build({ config }) {
-    const skipTypes = process.argv.includes('--no-types');
-    try {
-        await generateImportMap(config, {
-            log: true
-        });
-        if (!skipTypes) {
-            await generateTypes(config, {
-                log: true
-            });
-        }
-    } catch (err) {
-        console.error('Pre-build generation failed:');
-        console.error(err);
-        return process.exit(1);
-    }
-    const nextBin = resolveNextBin();
-    const forwardedArgs = getForwardedArgs();
-    const exitCode = await new Promise((resolve)=>{
-        const child = spawn(process.execPath, [
-            nextBin,
-            'build',
-            ...forwardedArgs
-        ], {
-            stdio: 'inherit'
-        });
-        child.on('error', (err)=>{
-            console.error('Failed to run next build:');
-            console.error(err);
-            resolve(1);
-        });
-        child.on('exit', (code)=>{
-            resolve(code ?? 0);
-        });
-    });
-    process.exit(exitCode);
-}
-/**
- * Resolve the project's `next` binary from its own manifest, robust to a future
- * `exports` field and to internal layout changes. Resolving from `cwd` (not
- * PATH) works whether `payload build` runs via an npm script or `npx`.
- */ export function resolveNextBin(cwd = process.cwd()) {
-    const require = createRequire(path.join(cwd, 'package.json'));
-    let nextPkgPath;
-    try {
-        nextPkgPath = require.resolve('next/package.json');
-    } catch  {
-        throw new Error('Could not resolve "next" from the current project. Is Next.js installed?');
-    }
-    const nextPkg = JSON.parse(readFileSync(nextPkgPath, 'utf8'));
-    const binField = typeof nextPkg.bin === 'string' ? nextPkg.bin : nextPkg.bin?.next;
-    if (!binField) {
-        throw new Error('Could not determine the "next" binary path from next/package.json.');
-    }
-    return path.join(path.dirname(nextPkgPath), binField);
-}
-/**
- * Forward the raw args that follow the `build` subcommand to `next build`,
- * dropping payload-only flags. Uses raw argv (not minimist) so flags like
- * `--turbopack` or `--experimental-build-mode` pass through verbatim.
- */ export function getForwardedArgs(argv = process.argv.slice(2)) {
-    const buildIndex = argv.indexOf('build');
-    const rest = buildIndex === -1 ? argv : argv.slice(buildIndex + 1);
-    return rest.filter((arg)=>arg !== '--no-types');
-}
-
-//# sourceMappingURL=build.js.map

package/dist/bin/build.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/bin/build.ts"],"sourcesContent":["/* eslint-disable no-console */\nimport { spawn } from 'node:child_process'\nimport { readFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport path from 'node:path'\n\nimport type { SanitizedConfig } from '../config/types.js'\n\nimport { generateImportMap } from './generateImportMap/index.js'\nimport { generateTypes } from './generateTypes.js'\n\n/**\n * `payload build` — generate the import map (and types) so they are on disk\n * before `next build` statically imports them, then run the project's Next.js\n * build, forwarding any extra CLI args verbatim.\n *\n * Owns its own process lifecycle: it exits with `next build`'s exit code, or\n * exits 1 if pre-build generation fails (never builds against a stale map).\n */\nexport async function build({ config }: { config: SanitizedConfig }): Promise<void> {\n  const skipTypes = process.argv.includes('--no-types')\n\n  try {\n    await generateImportMap(config, { log: true })\n    if (!skipTypes) {\n      await generateTypes(config, { log: true })\n    }\n  } catch (err) {\n    console.error('Pre-build generation failed:')\n    console.error(err)\n    return process.exit(1)\n  }\n\n  const nextBin = resolveNextBin()\n  const forwardedArgs = getForwardedArgs()\n\n  const exitCode = await new Promise<number>((resolve) => {\n    const child = spawn(process.execPath, [nextBin, 'build', ...forwardedArgs], {\n      stdio: 'inherit',\n    })\n    child.on('error', (err) => {\n      console.error('Failed to run next build:')\n      console.error(err)\n      resolve(1)\n    })\n    child.on('exit', (code) => {\n      resolve(code ?? 0)\n    })\n  })\n\n  process.exit(exitCode)\n}\n\n/**\n * Resolve the project's `next` binary from its own manifest, robust to a future\n * `exports` field and to internal layout changes. Resolving from `cwd` (not\n * PATH) works whether `payload build` runs via an npm script or `npx`.\n */\nexport function resolveNextBin(cwd: string = process.cwd()): string {\n  const require = createRequire(path.join(cwd, 'package.json'))\n\n  let nextPkgPath: string\n  try {\n    nextPkgPath = require.resolve('next/package.json')\n  } catch {\n    throw new Error('Could not resolve \"next\" from the current project. Is Next.js installed?')\n  }\n\n  const nextPkg = JSON.parse(readFileSync(nextPkgPath, 'utf8')) as {\n    bin?: Record<string, string> | string\n  }\n  const binField = typeof nextPkg.bin === 'string' ? nextPkg.bin : nextPkg.bin?.next\n  if (!binField) {\n    throw new Error('Could not determine the \"next\" binary path from next/package.json.')\n  }\n\n  return path.join(path.dirname(nextPkgPath), binField)\n}\n\n/**\n * Forward the raw args that follow the `build` subcommand to `next build`,\n * dropping payload-only flags. Uses raw argv (not minimist) so flags like\n * `--turbopack` or `--experimental-build-mode` pass through verbatim.\n */\nexport function getForwardedArgs(argv: string[] = process.argv.slice(2)): string[] {\n  const buildIndex = argv.indexOf('build')\n  const rest = buildIndex === -1 ? argv : argv.slice(buildIndex + 1)\n  return rest.filter((arg) => arg !== '--no-types')\n}\n"],"names":["spawn","readFileSync","createRequire","path","generateImportMap","generateTypes","build","config","skipTypes","process","argv","includes","log","err","console","error","exit","nextBin","resolveNextBin","forwardedArgs","getForwardedArgs","exitCode","Promise","resolve","child","execPath","stdio","on","code","cwd","require","join","nextPkgPath","Error","nextPkg","JSON","parse","binField","bin","next","dirname","slice","buildIndex","indexOf","rest","filter","arg"],"mappings":"AAAA,6BAA6B,GAC7B,SAASA,KAAK,QAAQ,qBAAoB;AAC1C,SAASC,YAAY,QAAQ,UAAS;AACtC,SAASC,aAAa,QAAQ,cAAa;AAC3C,OAAOC,UAAU,YAAW;AAI5B,SAASC,iBAAiB,QAAQ,+BAA8B;AAChE,SAASC,aAAa,QAAQ,qBAAoB;AAElD;;;;;;;CAOC,GACD,OAAO,eAAeC,MAAM,EAAEC,MAAM,EAA+B;IACjE,MAAMC,YAAYC,QAAQC,IAAI,CAACC,QAAQ,CAAC;IAExC,IAAI;QACF,MAAMP,kBAAkBG,QAAQ;YAAEK,KAAK;QAAK;QAC5C,IAAI,CAACJ,WAAW;YACd,MAAMH,cAAcE,QAAQ;gBAAEK,KAAK;YAAK;QAC1C;IACF,EAAE,OAAOC,KAAK;QACZC,QAAQC,KAAK,CAAC;QACdD,QAAQC,KAAK,CAACF;QACd,OAAOJ,QAAQO,IAAI,CAAC;IACtB;IAEA,MAAMC,UAAUC;IAChB,MAAMC,gBAAgBC;IAEtB,MAAMC,WAAW,MAAM,IAAIC,QAAgB,CAACC;QAC1C,MAAMC,QAAQxB,MAAMS,QAAQgB,QAAQ,EAAE;YAACR;YAAS;eAAYE;SAAc,EAAE;YAC1EO,OAAO;QACT;QACAF,MAAMG,EAAE,CAAC,SAAS,CAACd;YACjBC,QAAQC,KAAK,CAAC;YACdD,QAAQC,KAAK,CAACF;YACdU,QAAQ;QACV;QACAC,MAAMG,EAAE,CAAC,QAAQ,CAACC;YAChBL,QAAQK,QAAQ;QAClB;IACF;IAEAnB,QAAQO,IAAI,CAACK;AACf;AAEA;;;;CAIC,GACD,OAAO,SAASH,eAAeW,MAAcpB,QAAQoB,GAAG,EAAE;IACxD,MAAMC,UAAU5B,cAAcC,KAAK4B,IAAI,CAACF,KAAK;IAE7C,IAAIG;IACJ,IAAI;QACFA,cAAcF,QAAQP,OAAO,CAAC;IAChC,EAAE,OAAM;QACN,MAAM,IAAIU,MAAM;IAClB;IAEA,MAAMC,UAAUC,KAAKC,KAAK,CAACnC,aAAa+B,aAAa;IAGrD,MAAMK,WAAW,OAAOH,QAAQI,GAAG,KAAK,WAAWJ,QAAQI,GAAG,GAAGJ,QAAQI,GAAG,EAAEC;IAC9E,IAAI,CAACF,UAAU;QACb,MAAM,IAAIJ,MAAM;IAClB;IAEA,OAAO9B,KAAK4B,IAAI,CAAC5B,KAAKqC,OAAO,CAACR,cAAcK;AAC9C;AAEA;;;;CAIC,GACD,OAAO,SAASjB,iBAAiBV,OAAiBD,QAAQC,IAAI,CAAC+B,KAAK,CAAC,EAAE;IACrE,MAAMC,aAAahC,KAAKiC,OAAO,CAAC;IAChC,MAAMC,OAAOF,eAAe,CAAC,IAAIhC,OAAOA,KAAK+B,KAAK,CAACC,aAAa;IAChE,OAAOE,KAAKC,MAAM,CAAC,CAACC,MAAQA,QAAQ;AACtC"}

package/dist/bin/build.spec.js

@@ -1,170 +0,0 @@
-import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest';
-// Default fake child auto-fires `exit(0)` synchronously so ordering/generation
-// tests resolve. Specific tests override via `mockReturnValueOnce` to drive the
-// exit/error handlers manually.
-const spawnMock = vi.fn(()=>({
-        on (event, cb) {
-            if (event === 'exit') {
-                cb(0);
-            }
-            return this;
-        }
-    }));
-const generateImportMapMock = vi.fn(async ()=>{});
-const generateTypesMock = vi.fn(async ()=>{});
-vi.mock('node:child_process', ()=>({
-        spawn: spawnMock
-    }));
-vi.mock('./generateImportMap/index.js', ()=>({
-        generateImportMap: generateImportMapMock
-    }));
-vi.mock('./generateTypes.js', ()=>({
-        generateTypes: generateTypesMock
-    }));
-// Imported after mocks are registered
-const { build, getForwardedArgs, resolveNextBin } = await import('./build.js');
-const fakeConfig = {};
-describe('getForwardedArgs', ()=>{
-    it('returns args after the build token and strips --no-types', ()=>{
-        expect(getForwardedArgs([
-            'build',
-            '--turbopack',
-            '--no-types',
-            'foo'
-        ])).toEqual([
-            '--turbopack',
-            'foo'
-        ]);
-    });
-    it('returns empty array when only build is present', ()=>{
-        expect(getForwardedArgs([
-            'build'
-        ])).toEqual([]);
-    });
-});
-describe('resolveNextBin', ()=>{
-    it('resolves next bin from the current project', ()=>{
-        // next is installed at the repo root; resolving from cwd must succeed
-        const binPath = resolveNextBin(process.cwd());
-        expect(binPath).toMatch(/next[\\/].*bin[\\/]next$/);
-    });
-    it('throws a clear error when next cannot be resolved', ()=>{
-        expect(()=>resolveNextBin('/nonexistent-project-root')).toThrow(/next/i);
-    });
-});
-describe('build', ()=>{
-    let exitMock;
-    let originalArgv;
-    beforeEach(()=>{
-        spawnMock.mockClear();
-        generateImportMapMock.mockClear();
-        generateTypesMock.mockClear();
-        originalArgv = process.argv;
-        process.argv = [
-            'node',
-            'payload',
-            'build'
-        ];
-        exitMock = vi.spyOn(process, 'exit').mockImplementation(()=>undefined);
-    });
-    afterEach(()=>{
-        process.argv = originalArgv;
-        exitMock.mockRestore();
-    });
-    it('generates the import map before spawning, and generates types by default', async ()=>{
-        await build({
-            config: fakeConfig
-        });
-        expect(generateImportMapMock).toHaveBeenCalledTimes(1);
-        expect(generateTypesMock).toHaveBeenCalledTimes(1);
-        expect(spawnMock).toHaveBeenCalledTimes(1);
-        expect(generateImportMapMock.mock.invocationCallOrder[0]).toBeLessThan(spawnMock.mock.invocationCallOrder[0]);
-    });
-    it('skips type generation with --no-types', async ()=>{
-        process.argv = [
-            'node',
-            'payload',
-            'build',
-            '--no-types'
-        ];
-        await build({
-            config: fakeConfig
-        });
-        expect(generateImportMapMock).toHaveBeenCalledTimes(1);
-        expect(generateTypesMock).not.toHaveBeenCalled();
-        expect(spawnMock).toHaveBeenCalledTimes(1);
-    });
-    it('exits 1 and does not spawn when generation fails', async ()=>{
-        generateImportMapMock.mockRejectedValueOnce(new Error('boom'));
-        await build({
-            config: fakeConfig
-        });
-        expect(exitMock).toHaveBeenCalledWith(1);
-        expect(spawnMock).not.toHaveBeenCalled();
-    });
-    it('spawns next build with forwarded args and propagates the child exit code', async ()=>{
-        process.argv = [
-            'node',
-            'payload',
-            'build',
-            '--turbopack'
-        ];
-        let exitCb;
-        spawnMock.mockReturnValueOnce({
-            on (event, cb) {
-                if (event === 'exit') {
-                    exitCb = cb;
-                }
-                return this;
-            }
-        });
-        const buildPromise = build({
-            config: fakeConfig
-        });
-        // generation awaits before spawn; let those microtasks settle
-        await vi.waitFor(()=>expect(spawnMock).toHaveBeenCalledTimes(1));
-        const [execPath, spawnArgs, opts] = spawnMock.mock.calls[0];
-        expect(execPath).toBe(process.execPath);
-        expect(spawnArgs[1]).toBe('build');
-        expect(spawnArgs).toContain('--turbopack');
-        expect(opts).toEqual({
-            stdio: 'inherit'
-        });
-        // Simulate the child exiting with a non-zero code
-        exitCb?.(2);
-        await buildPromise;
-        expect(exitMock).toHaveBeenCalledWith(2);
-    });
-    it('does not exit until the spawned child exits, then propagates its code', async ()=>{
-        let exitCb;
-        spawnMock.mockReturnValueOnce({
-            on (event, cb) {
-                if (event === 'exit') {
-                    exitCb = cb;
-                }
-                return this;
-            }
-        });
-        let resolved = false;
-        const buildPromise = build({
-            config: fakeConfig
-        }).then(()=>{
-            resolved = true;
-        });
-        // Wait for generation to settle and the child to be spawned. build() must
-        // still be pending because the child has not exited yet.
-        await vi.waitFor(()=>expect(exitCb).toBeDefined());
-        // Flush all pending microtasks; the OLD (buggy) build() resolved here
-        // without awaiting the child, so this assertion catches the race.
-        await new Promise((r)=>setTimeout(r, 0));
-        expect(resolved).toBe(false);
-        expect(exitMock).not.toHaveBeenCalled();
-        // Child exits non-zero -> build() must exit with that exact code
-        exitCb?.(3);
-        await buildPromise;
-        expect(resolved).toBe(true);
-        expect(exitMock).toHaveBeenCalledWith(3);
-    });
-});
-
-//# sourceMappingURL=build.spec.js.map

package/dist/bin/build.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/bin/build.spec.ts"],"sourcesContent":["import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest'\n\n// Default fake child auto-fires `exit(0)` synchronously so ordering/generation\n// tests resolve. Specific tests override via `mockReturnValueOnce` to drive the\n// exit/error handlers manually.\nconst spawnMock = vi.fn(() => ({\n  on(event: string, cb: (arg?: never) => void) {\n    if (event === 'exit') {\n      cb(0 as never)\n    }\n    return this\n  },\n}))\nconst generateImportMapMock = vi.fn(async () => {})\nconst generateTypesMock = vi.fn(async () => {})\n\nvi.mock('node:child_process', () => ({ spawn: spawnMock }))\nvi.mock('./generateImportMap/index.js', () => ({ generateImportMap: generateImportMapMock }))\nvi.mock('./generateTypes.js', () => ({ generateTypes: generateTypesMock }))\n\n// Imported after mocks are registered\nconst { build, getForwardedArgs, resolveNextBin } = await import('./build.js')\n\nconst fakeConfig = {} as never\n\ndescribe('getForwardedArgs', () => {\n  it('returns args after the build token and strips --no-types', () => {\n    expect(getForwardedArgs(['build', '--turbopack', '--no-types', 'foo'])).toEqual([\n      '--turbopack',\n      'foo',\n    ])\n  })\n\n  it('returns empty array when only build is present', () => {\n    expect(getForwardedArgs(['build'])).toEqual([])\n  })\n})\n\ndescribe('resolveNextBin', () => {\n  it('resolves next bin from the current project', () => {\n    // next is installed at the repo root; resolving from cwd must succeed\n    const binPath = resolveNextBin(process.cwd())\n    expect(binPath).toMatch(/next[\\\\/].*bin[\\\\/]next$/)\n  })\n\n  it('throws a clear error when next cannot be resolved', () => {\n    expect(() => resolveNextBin('/nonexistent-project-root')).toThrow(/next/i)\n  })\n})\n\ndescribe('build', () => {\n  let exitMock: ReturnType<typeof vi.spyOn>\n  let originalArgv: string[]\n\n  beforeEach(() => {\n    spawnMock.mockClear()\n    generateImportMapMock.mockClear()\n    generateTypesMock.mockClear()\n    originalArgv = process.argv\n    process.argv = ['node', 'payload', 'build']\n    exitMock = vi.spyOn(process, 'exit').mockImplementation((() => undefined) as never)\n  })\n\n  afterEach(() => {\n    process.argv = originalArgv\n    exitMock.mockRestore()\n  })\n\n  it('generates the import map before spawning, and generates types by default', async () => {\n    await build({ config: fakeConfig })\n\n    expect(generateImportMapMock).toHaveBeenCalledTimes(1)\n    expect(generateTypesMock).toHaveBeenCalledTimes(1)\n    expect(spawnMock).toHaveBeenCalledTimes(1)\n    expect(generateImportMapMock.mock.invocationCallOrder[0]).toBeLessThan(\n      spawnMock.mock.invocationCallOrder[0],\n    )\n  })\n\n  it('skips type generation with --no-types', async () => {\n    process.argv = ['node', 'payload', 'build', '--no-types']\n\n    await build({ config: fakeConfig })\n\n    expect(generateImportMapMock).toHaveBeenCalledTimes(1)\n    expect(generateTypesMock).not.toHaveBeenCalled()\n    expect(spawnMock).toHaveBeenCalledTimes(1)\n  })\n\n  it('exits 1 and does not spawn when generation fails', async () => {\n    generateImportMapMock.mockRejectedValueOnce(new Error('boom'))\n\n    await build({ config: fakeConfig })\n\n    expect(exitMock).toHaveBeenCalledWith(1)\n    expect(spawnMock).not.toHaveBeenCalled()\n  })\n\n  it('spawns next build with forwarded args and propagates the child exit code', async () => {\n    process.argv = ['node', 'payload', 'build', '--turbopack']\n    let exitCb: ((code: number | null) => void) | undefined\n    spawnMock.mockReturnValueOnce({\n      on(event: string, cb: (code: number | null) => void) {\n        if (event === 'exit') {\n          exitCb = cb\n        }\n        return this\n      },\n    })\n\n    const buildPromise = build({ config: fakeConfig })\n\n    // generation awaits before spawn; let those microtasks settle\n    await vi.waitFor(() => expect(spawnMock).toHaveBeenCalledTimes(1))\n    const [execPath, spawnArgs, opts] = spawnMock.mock.calls[0]\n    expect(execPath).toBe(process.execPath)\n    expect(spawnArgs[1]).toBe('build')\n    expect(spawnArgs).toContain('--turbopack')\n    expect(opts).toEqual({ stdio: 'inherit' })\n\n    // Simulate the child exiting with a non-zero code\n    exitCb?.(2)\n    await buildPromise\n    expect(exitMock).toHaveBeenCalledWith(2)\n  })\n\n  it('does not exit until the spawned child exits, then propagates its code', async () => {\n    let exitCb: ((code: number | null) => void) | undefined\n    spawnMock.mockReturnValueOnce({\n      on(event: string, cb: (code: number | null) => void) {\n        if (event === 'exit') {\n          exitCb = cb\n        }\n        return this\n      },\n    })\n\n    let resolved = false\n    const buildPromise = build({ config: fakeConfig }).then(() => {\n      resolved = true\n    })\n\n    // Wait for generation to settle and the child to be spawned. build() must\n    // still be pending because the child has not exited yet.\n    await vi.waitFor(() => expect(exitCb).toBeDefined())\n    // Flush all pending microtasks; the OLD (buggy) build() resolved here\n    // without awaiting the child, so this assertion catches the race.\n    await new Promise((r) => setTimeout(r, 0))\n    expect(resolved).toBe(false)\n    expect(exitMock).not.toHaveBeenCalled()\n\n    // Child exits non-zero -> build() must exit with that exact code\n    exitCb?.(3)\n    await buildPromise\n    expect(resolved).toBe(true)\n    expect(exitMock).toHaveBeenCalledWith(3)\n  })\n})\n"],"names":["describe","expect","it","vi","beforeEach","afterEach","spawnMock","fn","on","event","cb","generateImportMapMock","generateTypesMock","mock","spawn","generateImportMap","generateTypes","build","getForwardedArgs","resolveNextBin","fakeConfig","toEqual","binPath","process","cwd","toMatch","toThrow","exitMock","originalArgv","mockClear","argv","spyOn","mockImplementation","undefined","mockRestore","config","toHaveBeenCalledTimes","invocationCallOrder","toBeLessThan","not","toHaveBeenCalled","mockRejectedValueOnce","Error","toHaveBeenCalledWith","exitCb","mockReturnValueOnce","buildPromise","waitFor","execPath","spawnArgs","opts","calls","toBe","toContain","stdio","resolved","then","toBeDefined","Promise","r","setTimeout"],"mappings":"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"}

package/dist/bin/generateImportMap/generateImportMap.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/bin/generateImportMap/generateImportMap.spec.ts"],"sourcesContent":["import { describe, beforeEach, expect, it, vitest } from 'vitest'\nimport type { PayloadComponent } from '../../index.js'\nimport { addPayloadComponentToImportMap } from './utilities/addPayloadComponentToImportMap.js'\nimport { getImportMapToBaseDirPath } from './utilities/getImportMapToBaseDirPath.js'\n\ndescribe('addPayloadComponentToImportMap', () => {\n  let importMap: Record<string, string>\n  let imports: Record<\n    string,\n    {\n      path: string\n      specifier: string\n    }\n  >\n\n  beforeEach(() => {\n    importMap = {}\n    imports = {}\n    vitest.restoreAllMocks()\n  })\n\n  function componentPathTest({\n    baseDir,\n    importMapFilePath,\n    payloadComponent,\n    expectedPath,\n    expectedSpecifier,\n    expectedImportMapToBaseDirPath,\n  }: {\n    baseDir: string\n    importMapFilePath: string\n    payloadComponent: PayloadComponent\n    expectedPath: string\n    expectedImportMapToBaseDirPath: string\n    expectedSpecifier: string\n  }) {\n    const importMapToBaseDirPath = getImportMapToBaseDirPath({\n      baseDir,\n      importMapPath: importMapFilePath,\n    })\n\n    expect(importMapToBaseDirPath).toBe(expectedImportMapToBaseDirPath)\n\n    const { path, specifier } =\n      addPayloadComponentToImportMap({\n        importMapToBaseDirPath,\n        importMap,\n        imports,\n        payloadComponent,\n      }) ?? {}\n\n    expect(path).toBe(expectedPath)\n    expect(specifier).toBe(expectedSpecifier)\n  }\n\n  it('relative path with import map partially in base dir', () => {\n    componentPathTest({\n      baseDir: '/myPackage/test/myTest',\n      importMapFilePath: '/myPackage/app/(payload)/importMap.js',\n      payloadComponent: './MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../../test/myTest/',\n      expectedPath: '../../test/myTest/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('relative path with import map partially in base dir 2', () => {\n    componentPathTest({\n      baseDir: '/myPackage/test/myTest',\n      importMapFilePath: '/myPackage/test/prod/app/(payload)/importMap.js',\n      payloadComponent: {\n        path: './MyComponent.js#MyExport',\n      },\n      expectedImportMapToBaseDirPath: '../../../myTest/',\n      expectedPath: '../../../myTest/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('relative path with import map partially in base dir 3', () => {\n    componentPathTest({\n      baseDir: '/myPackage/test/myTest',\n      importMapFilePath: '/myPackage/test/prod/app/(payload)/importMap.js',\n      payloadComponent: {\n        path: '../otherTest/MyComponent.js',\n        exportName: 'MyExport',\n      },\n      expectedImportMapToBaseDirPath: '../../../myTest/',\n      expectedPath: '../../../otherTest/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('relative path with import map within base dir', () => {\n    componentPathTest({\n      baseDir: '/myPackage/test/myTest',\n      importMapFilePath: '/myPackage/test/myTest/prod/app/(payload)/importMap.js',\n      payloadComponent: './MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../../../',\n      expectedPath: '../../../MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('relative path with import map not in base dir', () => {\n    componentPathTest({\n      baseDir: '/test/myTest',\n      importMapFilePath: '/app/(payload)/importMap.js',\n      payloadComponent: './MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../../test/myTest/',\n      expectedPath: '../../test/myTest/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('relative path with import map not in base dir 2', () => {\n    componentPathTest({\n      baseDir: '/test/myTest',\n      importMapFilePath: '/app/(payload)/importMap.js',\n      payloadComponent: '../myOtherTest/MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../../test/myTest/',\n      expectedPath: '../../test/myOtherTest/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('relative path with import map not in base dir, baseDir ending with slash', () => {\n    componentPathTest({\n      baseDir: '/test/myTest/',\n      importMapFilePath: '/app/(payload)/importMap.js',\n      payloadComponent: './MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../../test/myTest/',\n      expectedPath: '../../test/myTest/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('relative path with import map not in base dir, component starting with slash', () => {\n    componentPathTest({\n      baseDir: '/test/myTest',\n      importMapFilePath: '/app/(payload)/importMap.js',\n      payloadComponent: '/MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../../test/myTest/',\n      expectedPath: '../../test/myTest/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('aliased path', () => {\n    componentPathTest({\n      baseDir: '/test/myTest',\n      importMapFilePath: '/app/(payload)/importMap.js',\n      payloadComponent: '@components/MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../../test/myTest/',\n      expectedPath: '@components/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n  it('aliased path in PayloadComponent object', () => {\n    componentPathTest({\n      baseDir: '/test/',\n      importMapFilePath: '/app/(payload)/importMap.js',\n      payloadComponent: {\n        path: '@components/MyComponent.js',\n      },\n      expectedImportMapToBaseDirPath: '../../test/',\n      expectedPath: '@components/MyComponent.js',\n      expectedSpecifier: 'default',\n    })\n  })\n\n  it('relative path import starting with slash, going up', () => {\n    componentPathTest({\n      baseDir: '/test/myTest',\n      importMapFilePath: '/test/myTest/app/importMap.js',\n      payloadComponent: '/../MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../',\n      expectedPath: '../../MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('relative path import starting with dot-slash, going up', () => {\n    componentPathTest({\n      baseDir: '/test/myTest',\n      importMapFilePath: '/test/myTest/app/importMap.js',\n      payloadComponent: './../MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: '../',\n      expectedPath: '../../MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('importMap and baseDir in same directory', () => {\n    componentPathTest({\n      baseDir: '/test/myTest',\n      importMapFilePath: '/test/myTest/importMap.js',\n      payloadComponent: './MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: './',\n      expectedPath: './MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n\n  it('baseDir within importMap dir', () => {\n    componentPathTest({\n      baseDir: '/test/myTest/components',\n      importMapFilePath: '/test/myTest/importMap.js',\n      payloadComponent: './MyComponent.js#MyExport',\n      expectedImportMapToBaseDirPath: './components/',\n      expectedPath: './components/MyComponent.js',\n      expectedSpecifier: 'MyExport',\n    })\n  })\n})\n"],"names":["describe","beforeEach","expect","it","vitest","addPayloadComponentToImportMap","getImportMapToBaseDirPath","importMap","imports","restoreAllMocks","componentPathTest","baseDir","importMapFilePath","payloadComponent","expectedPath","expectedSpecifier","expectedImportMapToBaseDirPath","importMapToBaseDirPath","importMapPath","toBe","path","specifier","exportName"],"mappings":"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"}

package/dist/bin/generateImportMap/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bin/generateImportMap/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAQ9E,KAAK,gBAAgB,GAAG,MAAM,CAAA;AAC9B,KAAK,eAAe,GAAG,MAAM,CAAA;AAC7B,KAAK,UAAU,GAAG,MAAM,CAAA;AACxB,KAAK,cAAc,GAAG,MAAM,CAAA;AAE5B;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAAA;CACzC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,CAAC,UAAU,EAAE,gBAAgB,GAAG;QAC9B,IAAI,EAAE,UAAU,CAAA;QAChB,SAAS,EAAE,eAAe,CAAA;KAC3B,CAAA;CACF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,CAAC,IAAI,EAAE,cAAc,GAAG,GAAG,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,KAAK,IAAI,CAAA;AAE/F,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,OAAO,CAAA,CAAC;;;OAGb;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,GAAG,EAAE,OAAO,CAAA;CACb,GACA,OAAO,CAAC,IAAI,CAAC,CA+Ef;AAED,wBAAsB,cAAc,CAAC,EACnC,YAAY,EACZ,KAAK,EACL,SAAS,EACT,iBAAiB,EACjB,GAAG,GACJ,EAAE;IACD,YAAY,EAAE,iBAAiB,CAAA;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,GAAG,CAAC,EAAE,OAAO,CAAA;CACd,iBAqCA"}

package/dist/bin/generateImportMap/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/bin/generateImportMap/index.ts"],"sourcesContent":["import fs from 'fs/promises'\nimport process from 'node:process'\n\nimport type { PayloadComponent, SanitizedConfig } from '../../config/types.js'\n\nimport { getLogger } from '../../utilities/logger.js'\nimport { iterateConfig } from './iterateConfig.js'\nimport { addPayloadComponentToImportMap } from './utilities/addPayloadComponentToImportMap.js'\nimport { getImportMapToBaseDirPath } from './utilities/getImportMapToBaseDirPath.js'\nimport { resolveImportMapFilePath } from './utilities/resolveImportMapFilePath.js'\n\ntype ImportIdentifier = string\ntype ImportSpecifier = string\ntype ImportPath = string\ntype UserImportPath = string\n\n/**\n * Import Map before being written to the file. Only contains all paths\n */\nexport type InternalImportMap = {\n  [path: UserImportPath]: ImportIdentifier\n}\n\n/**\n * Imports of the import map.\n */\nexport type Imports = {\n  [identifier: ImportIdentifier]: {\n    path: ImportPath\n    specifier: ImportSpecifier\n  }\n}\n\n/**\n * Import Map after being imported from the actual import map. Contains all the actual imported components\n */\nexport type ImportMap = {\n  [path: UserImportPath]: any\n}\n\nexport type AddToImportMap = (payloadComponent?: PayloadComponent | PayloadComponent[]) => void\n\nexport async function generateImportMap(\n  config: SanitizedConfig,\n  options?: {\n    force?: boolean /**\n     * If true, will not throw an error if the import map file path cannot be resolved\n    Instead, it will return silently.\n     */\n    ignoreResolveError?: boolean\n    log: boolean\n  },\n): Promise<void> {\n  const logger = getLogger('payload', 'sync')\n  const shouldLog = options?.log ?? true\n\n  if (shouldLog) {\n    logger.info('Generating import map')\n  }\n\n  const importMap: InternalImportMap = {}\n  const imports: Imports = {}\n\n  // Determine the root directory of the project - usually the directory where the src or app folder is located\n  const rootDir = process.env.ROOT_DIR ?? process.cwd()\n\n  const baseDir = config.admin.importMap.baseDir ?? process.cwd()\n\n  const importMapFilePath = await resolveImportMapFilePath({\n    adminRoute: config.routes.admin,\n    importMapFile: config?.admin?.importMap?.importMapFile,\n    rootDir,\n  })\n\n  if (importMapFilePath instanceof Error) {\n    if (options?.ignoreResolveError) {\n      return\n    } else {\n      throw importMapFilePath\n    }\n  }\n\n  const importMapToBaseDirPath = getImportMapToBaseDirPath({\n    baseDir,\n    importMapPath: importMapFilePath,\n  })\n\n  const addToImportMap: AddToImportMap = (payloadComponent) => {\n    if (!payloadComponent) {\n      return\n    }\n\n    if (typeof payloadComponent !== 'object' && typeof payloadComponent !== 'string') {\n      logger.error(payloadComponent)\n      throw new Error('addToImportMap > Payload component must be an object or a string')\n    }\n\n    if (Array.isArray(payloadComponent)) {\n      for (const component of payloadComponent) {\n        addPayloadComponentToImportMap({\n          importMap,\n          importMapToBaseDirPath,\n          imports,\n          payloadComponent: component,\n        })\n      }\n    } else {\n      addPayloadComponentToImportMap({\n        importMap,\n        importMapToBaseDirPath,\n        imports,\n        payloadComponent,\n      })\n    }\n  }\n\n  iterateConfig({\n    addToImportMap,\n    baseDir: config.admin.importMap.baseDir,\n    config,\n    importMap,\n    imports,\n  })\n\n  await writeImportMap({\n    componentMap: importMap,\n    force: options?.force,\n    importMap: imports,\n    importMapFilePath,\n    log: shouldLog,\n  })\n}\n\nexport async function writeImportMap({\n  componentMap,\n  force,\n  importMap,\n  importMapFilePath,\n  log,\n}: {\n  componentMap: InternalImportMap\n  force?: boolean\n  importMap: Imports\n  importMapFilePath: string\n  log?: boolean\n}) {\n  const logger = getLogger('payload', 'sync')\n  const imports: string[] = []\n  for (const [identifier, { path, specifier }] of Object.entries(importMap)) {\n    imports.push(`import { ${specifier} as ${identifier} } from '${path}'`)\n  }\n\n  const mapKeys: string[] = []\n  for (const [userPath, identifier] of Object.entries(componentMap)) {\n    mapKeys.push(`  \"${userPath}\": ${identifier}`)\n  }\n\n  const importMapOutputFile = `${imports.join('\\n')}\n\n/** @type import('payload').ImportMap */\nexport const importMap = {\n${mapKeys.join(',\\n')}\n}\n`\n\n  if (!force) {\n    // Read current import map and check in the IMPORTS if there are any new imports. If not, don't write the file.\n    const currentImportMap = await fs.readFile(importMapFilePath, 'utf-8')\n\n    if (currentImportMap?.trim() === importMapOutputFile?.trim()) {\n      if (log) {\n        logger.info('No new imports found, skipping writing import map')\n      }\n      return\n    }\n  }\n\n  if (log) {\n    logger.info(`Writing import map to ${importMapFilePath}`)\n  }\n\n  await fs.writeFile(importMapFilePath, importMapOutputFile)\n}\n"],"names":["fs","process","getLogger","iterateConfig","addPayloadComponentToImportMap","getImportMapToBaseDirPath","resolveImportMapFilePath","generateImportMap","config","options","logger","shouldLog","log","info","importMap","imports","rootDir","env","ROOT_DIR","cwd","baseDir","admin","importMapFilePath","adminRoute","routes","importMapFile","Error","ignoreResolveError","importMapToBaseDirPath","importMapPath","addToImportMap","payloadComponent","error","Array","isArray","component","writeImportMap","componentMap","force","identifier","path","specifier","Object","entries","push","mapKeys","userPath","importMapOutputFile","join","currentImportMap","readFile","trim","writeFile"],"mappings":"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"}

package/dist/bin/generateImportMap/iterateCollections.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"iterateCollections.d.ts","sourceRoot":"","sources":["../../../src/bin/generateImportMap/iterateCollections.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAClF,OAAO,KAAK,EAAoB,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAI5E,wBAAgB,kBAAkB,CAAC,EACjC,cAAc,EACd,OAAO,EACP,WAAW,EACX,MAAM,EACN,SAAS,EACT,OAAO,GACR,EAAE;IACD,cAAc,EAAE,cAAc,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,yBAAyB,EAAE,CAAA;IACxC,MAAM,EAAE,eAAe,CAAA;IACvB,SAAS,EAAE,iBAAiB,CAAA;IAC5B,OAAO,EAAE,OAAO,CAAA;CACjB,QAgFA"}