payload 4.0.0-internal.bc5cf8c → 4.0.0-internal.bf4bcce

package/skills/payload/reference/QUERIES.md

@@ -0,0 +1,282 @@
+# 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',
+  overrideAccess: true,
+  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',
+  overrideAccess: true,
+  id: '123',
+  depth: 2,
+})
+
+// Create
+const post = await payload.create({
+  collection: 'posts',
+  overrideAccess: true,
+  data: {
+    title: 'New Post',
+    status: 'draft',
+  },
+})
+
+// Update
+await payload.update({
+  collection: 'posts',
+  overrideAccess: true,
+  id: '123',
+  data: {
+    status: 'published',
+  },
+})
+
+// Delete
+await payload.delete({
+  collection: 'posts',
+  overrideAccess: true,
+  id: '123',
+})
+
+// Count
+const count = await payload.count({
+  collection: 'posts',
+  overrideAccess: true,
+  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',
+    overrideAccess: true,
+    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',
+    overrideAccess: true,
+    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**: Where `overrideAccess` is optional, it defaults to `false` — Local API respects access control unless told otherwise. Set it to `true` to bypass access control.
+
+```ts
+// ❌ WRONG: User is passed but access control is bypassed anyway
+const posts = await payload.find({
+  collection: 'posts',
+  user: currentUser,
+  overrideAccess: true,
+  // 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, // 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: 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/auth/cookies.spec.js

@@ -1,34 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { parseCookies } from './cookies.js';
-describe('parseCookies', ()=>{
-    it('parses cookie attributes without values', ()=>{
-        const fakeHeaders = new Map();
-        fakeHeaders.set('Cookie', 'my_value=true; Secure; HttpOnly');
-        const parsed = parseCookies(fakeHeaders);
-        expect(parsed.get('my_value')).toBe('true');
-        expect(parsed.get('Secure')).toBe('true');
-        expect(parsed.get('HttpOnly')).toBe('true');
-        expect(parsed.size).toBe(3);
-    });
-    it('strips whitespace', ()=>{
-        const fakeHeaders = new Map();
-        fakeHeaders.set('Cookie', 'my_value=true; ');
-        const parsed = parseCookies(fakeHeaders);
-        expect(parsed.get('my_value')).toBe('true');
-        expect(parsed.size).toBe(1);
-    });
-    it('ensure invalid cookies are ignored', ()=>{
-        const fakeHeaders = new Map();
-        fakeHeaders.set('Cookie', 'my_value=true; invalid_cookie=%E0%A4%A');
-        const parsed = parseCookies(fakeHeaders);
-        expect(parsed.get('my_value')).toBe('true');
-        expect(parsed.size).toBe(1);
-    });
-    it('ensure empty map is returned if there are no cookies', ()=>{
-        const fakeHeaders = new Map();
-        const parsed = parseCookies(fakeHeaders);
-        expect(parsed.size).toBe(0);
-    });
-});
-
-//# sourceMappingURL=cookies.spec.js.map

package/dist/auth/cookies.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/auth/cookies.spec.ts"],"sourcesContent":["import { describe, it, expect } from 'vitest'\nimport { parseCookies } from './cookies.js'\n\ndescribe('parseCookies', () => {\n  it('parses cookie attributes without values', () => {\n    const fakeHeaders = new Map()\n    fakeHeaders.set('Cookie', 'my_value=true; Secure; HttpOnly')\n\n    const parsed = parseCookies(fakeHeaders as unknown as Request['headers'])\n\n    expect(parsed.get('my_value')).toBe('true')\n    expect(parsed.get('Secure')).toBe('true')\n    expect(parsed.get('HttpOnly')).toBe('true')\n    expect(parsed.size).toBe(3)\n  })\n  it('strips whitespace', () => {\n    const fakeHeaders = new Map()\n    fakeHeaders.set('Cookie', 'my_value=true; ')\n\n    const parsed = parseCookies(fakeHeaders as unknown as Request['headers'])\n\n    expect(parsed.get('my_value')).toBe('true')\n    expect(parsed.size).toBe(1)\n  })\n\n  it('ensure invalid cookies are ignored', () => {\n    const fakeHeaders = new Map()\n    fakeHeaders.set('Cookie', 'my_value=true; invalid_cookie=%E0%A4%A')\n\n    const parsed = parseCookies(fakeHeaders as unknown as Request['headers'])\n\n    expect(parsed.get('my_value')).toBe('true')\n    expect(parsed.size).toBe(1)\n  })\n\n  it('ensure empty map is returned if there are no cookies', () => {\n    const fakeHeaders = new Map()\n\n    const parsed = parseCookies(fakeHeaders as unknown as Request['headers'])\n\n    expect(parsed.size).toBe(0)\n  })\n})\n"],"names":["describe","it","expect","parseCookies","fakeHeaders","Map","set","parsed","get","toBe","size"],"mappings":"AAAA,SAASA,QAAQ,EAAEC,EAAE,EAAEC,MAAM,QAAQ,SAAQ;AAC7C,SAASC,YAAY,QAAQ,eAAc;AAE3CH,SAAS,gBAAgB;IACvBC,GAAG,2CAA2C;QAC5C,MAAMG,cAAc,IAAIC;QACxBD,YAAYE,GAAG,CAAC,UAAU;QAE1B,MAAMC,SAASJ,aAAaC;QAE5BF,OAAOK,OAAOC,GAAG,CAAC,aAAaC,IAAI,CAAC;QACpCP,OAAOK,OAAOC,GAAG,CAAC,WAAWC,IAAI,CAAC;QAClCP,OAAOK,OAAOC,GAAG,CAAC,aAAaC,IAAI,CAAC;QACpCP,OAAOK,OAAOG,IAAI,EAAED,IAAI,CAAC;IAC3B;IACAR,GAAG,qBAAqB;QACtB,MAAMG,cAAc,IAAIC;QACxBD,YAAYE,GAAG,CAAC,UAAU;QAE1B,MAAMC,SAASJ,aAAaC;QAE5BF,OAAOK,OAAOC,GAAG,CAAC,aAAaC,IAAI,CAAC;QACpCP,OAAOK,OAAOG,IAAI,EAAED,IAAI,CAAC;IAC3B;IAEAR,GAAG,sCAAsC;QACvC,MAAMG,cAAc,IAAIC;QACxBD,YAAYE,GAAG,CAAC,UAAU;QAE1B,MAAMC,SAASJ,aAAaC;QAE5BF,OAAOK,OAAOC,GAAG,CAAC,aAAaC,IAAI,CAAC;QACpCP,OAAOK,OAAOG,IAAI,EAAED,IAAI,CAAC;IAC3B;IAEAR,GAAG,wDAAwD;QACzD,MAAMG,cAAc,IAAIC;QAExB,MAAME,SAASJ,aAAaC;QAE5BF,OAAOK,OAAOG,IAAI,EAAED,IAAI,CAAC;IAC3B;AACF"}

package/dist/auth/strategies/local/authenticate.spec.js

@@ -1,83 +0,0 @@
-import crypto from 'crypto';
-import { describe, expect, it } from 'vitest';
-import { authenticateLocalStrategy } from './authenticate.js';
-// Helper to generate hash/salt like Payload does
-const generateHashAndSalt = (password)=>{
-    const salt = crypto.randomBytes(32).toString('hex');
-    const hash = crypto.pbkdf2Sync(password, salt, 25000, 512, 'sha256').toString('hex');
-    return {
-        hash,
-        salt
-    };
-};
-describe('authenticateLocalStrategy', ()=>{
-    it('should return doc when password is valid', async ()=>{
-        const password = 'test-password';
-        const { hash, salt } = generateHashAndSalt(password);
-        const doc = {
-            id: 1,
-            hash,
-            salt
-        };
-        const result = await authenticateLocalStrategy({
-            doc,
-            password
-        });
-        expect(result).toEqual(doc);
-    });
-    it('should return null when password is invalid', async ()=>{
-        const { hash, salt } = generateHashAndSalt('correct-password');
-        const doc = {
-            id: 1,
-            hash,
-            salt
-        };
-        const result = await authenticateLocalStrategy({
-            doc,
-            password: 'wrong-password'
-        });
-        expect(result).toBeNull();
-    });
-    it('should return null when salt is missing', async ()=>{
-        const { hash } = generateHashAndSalt('test-password');
-        const doc = {
-            id: 1,
-            hash
-        };
-        const result = await authenticateLocalStrategy({
-            doc,
-            password: 'test-password'
-        });
-        expect(result).toBeNull();
-    });
-    it('should return null when hash is missing', async ()=>{
-        const { salt } = generateHashAndSalt('test-password');
-        const doc = {
-            id: 1,
-            salt
-        };
-        const result = await authenticateLocalStrategy({
-            doc,
-            password: 'test-password'
-        });
-        expect(result).toBeNull();
-    });
-    it('should return null when hash has different length (tampered)', async ()=>{
-        const password = 'test-password';
-        const { salt } = generateHashAndSalt(password);
-        // Truncated hash - different length than expected 512 bytes
-        const shortHash = 'abcd1234';
-        const doc = {
-            id: 1,
-            hash: shortHash,
-            salt
-        };
-        const result = await authenticateLocalStrategy({
-            doc,
-            password
-        });
-        expect(result).toBeNull();
-    });
-});
-
-//# sourceMappingURL=authenticate.spec.js.map

package/dist/auth/strategies/local/authenticate.spec.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/auth/strategies/local/authenticate.spec.ts"],"sourcesContent":["import crypto from 'crypto'\n\nimport { describe, expect, it } from 'vitest'\n\nimport { authenticateLocalStrategy } from './authenticate.js'\n\n// Helper to generate hash/salt like Payload does\nconst generateHashAndSalt = (password: string): { hash: string; salt: string } => {\n  const salt = crypto.randomBytes(32).toString('hex')\n  const hash = crypto.pbkdf2Sync(password, salt, 25000, 512, 'sha256').toString('hex')\n  return { hash, salt }\n}\n\ndescribe('authenticateLocalStrategy', () => {\n  it('should return doc when password is valid', async () => {\n    const password = 'test-password'\n    const { hash, salt } = generateHashAndSalt(password)\n    const doc = { id: 1, hash, salt }\n\n    const result = await authenticateLocalStrategy({ doc, password })\n\n    expect(result).toEqual(doc)\n  })\n\n  it('should return null when password is invalid', async () => {\n    const { hash, salt } = generateHashAndSalt('correct-password')\n    const doc = { id: 1, hash, salt }\n\n    const result = await authenticateLocalStrategy({ doc, password: 'wrong-password' })\n\n    expect(result).toBeNull()\n  })\n\n  it('should return null when salt is missing', async () => {\n    const { hash } = generateHashAndSalt('test-password')\n    const doc = { id: 1, hash }\n\n    const result = await authenticateLocalStrategy({ doc, password: 'test-password' })\n\n    expect(result).toBeNull()\n  })\n\n  it('should return null when hash is missing', async () => {\n    const { salt } = generateHashAndSalt('test-password')\n    const doc = { id: 1, salt }\n\n    const result = await authenticateLocalStrategy({ doc, password: 'test-password' })\n\n    expect(result).toBeNull()\n  })\n\n  it('should return null when hash has different length (tampered)', async () => {\n    const password = 'test-password'\n    const { salt } = generateHashAndSalt(password)\n    // Truncated hash - different length than expected 512 bytes\n    const shortHash = 'abcd1234'\n    const doc = { id: 1, hash: shortHash, salt }\n\n    const result = await authenticateLocalStrategy({ doc, password })\n\n    expect(result).toBeNull()\n  })\n})\n"],"names":["crypto","describe","expect","it","authenticateLocalStrategy","generateHashAndSalt","password","salt","randomBytes","toString","hash","pbkdf2Sync","doc","id","result","toEqual","toBeNull","shortHash"],"mappings":"AAAA,OAAOA,YAAY,SAAQ;AAE3B,SAASC,QAAQ,EAAEC,MAAM,EAAEC,EAAE,QAAQ,SAAQ;AAE7C,SAASC,yBAAyB,QAAQ,oBAAmB;AAE7D,iDAAiD;AACjD,MAAMC,sBAAsB,CAACC;IAC3B,MAAMC,OAAOP,OAAOQ,WAAW,CAAC,IAAIC,QAAQ,CAAC;IAC7C,MAAMC,OAAOV,OAAOW,UAAU,CAACL,UAAUC,MAAM,OAAO,KAAK,UAAUE,QAAQ,CAAC;IAC9E,OAAO;QAAEC;QAAMH;IAAK;AACtB;AAEAN,SAAS,6BAA6B;IACpCE,GAAG,4CAA4C;QAC7C,MAAMG,WAAW;QACjB,MAAM,EAAEI,IAAI,EAAEH,IAAI,EAAE,GAAGF,oBAAoBC;QAC3C,MAAMM,MAAM;YAAEC,IAAI;YAAGH;YAAMH;QAAK;QAEhC,MAAMO,SAAS,MAAMV,0BAA0B;YAAEQ;YAAKN;QAAS;QAE/DJ,OAAOY,QAAQC,OAAO,CAACH;IACzB;IAEAT,GAAG,+CAA+C;QAChD,MAAM,EAAEO,IAAI,EAAEH,IAAI,EAAE,GAAGF,oBAAoB;QAC3C,MAAMO,MAAM;YAAEC,IAAI;YAAGH;YAAMH;QAAK;QAEhC,MAAMO,SAAS,MAAMV,0BAA0B;YAAEQ;YAAKN,UAAU;QAAiB;QAEjFJ,OAAOY,QAAQE,QAAQ;IACzB;IAEAb,GAAG,2CAA2C;QAC5C,MAAM,EAAEO,IAAI,EAAE,GAAGL,oBAAoB;QACrC,MAAMO,MAAM;YAAEC,IAAI;YAAGH;QAAK;QAE1B,MAAMI,SAAS,MAAMV,0BAA0B;YAAEQ;YAAKN,UAAU;QAAgB;QAEhFJ,OAAOY,QAAQE,QAAQ;IACzB;IAEAb,GAAG,2CAA2C;QAC5C,MAAM,EAAEI,IAAI,EAAE,GAAGF,oBAAoB;QACrC,MAAMO,MAAM;YAAEC,IAAI;YAAGN;QAAK;QAE1B,MAAMO,SAAS,MAAMV,0BAA0B;YAAEQ;YAAKN,UAAU;QAAgB;QAEhFJ,OAAOY,QAAQE,QAAQ;IACzB;IAEAb,GAAG,gEAAgE;QACjE,MAAMG,WAAW;QACjB,MAAM,EAAEC,IAAI,EAAE,GAAGF,oBAAoBC;QACrC,4DAA4D;QAC5D,MAAMW,YAAY;QAClB,MAAML,MAAM;YAAEC,IAAI;YAAGH,MAAMO;YAAWV;QAAK;QAE3C,MAAMO,SAAS,MAAMV,0BAA0B;YAAEQ;YAAKN;QAAS;QAE/DJ,OAAOY,QAAQE,QAAQ;IACzB;AACF"}

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"}