payload 4.0.0-internal.2fddfc0 → 4.0.0-internal.31ba7ee

package/dist/auth/types.d.ts

@@ -1,5 +1,4 @@
-import type { DeepRequired } from 'ts-essentials';
-import type { CollectionSlug, GlobalSlug, Payload, TypedUser } from '../index.js';
+import type { CollectionSlug, GlobalSlug, Payload, User } from '../index.js';
 import type { PayloadRequest, Where } from '../types/index.js';
 /**
  * A permission object that can be used to determine if a user has access to a specific operation.
@@ -89,28 +88,34 @@ export type SanitizedPermissions = {
         [globalSlug: string]: SanitizedGlobalPermission;
     };
 };
-type BaseUser = {
-    collection: string;
-    email?: string;
-    id: number | string;
-    sessions?: Array<UserSession>;
-    username?: string;
+/**
+ * Fields injected onto a user at authentication time. They are never stored in the database and
+ * never present on a plain document read (e.g. `payload.findByID`) - only on the authenticated
+ * user (`req.user`, login/auth/me results, auth strategies).
+ */
+export type AuthRuntimeFields = {
+    /**
+     * The session ID of the current request. May be present on request-authenticated users when
+     * sessions are enabled.
+     */
+    _sid?: string;
+    /**
+     * The name of the auth strategy that authenticated the request (e.g. `local-jwt`).
+     */
+    _strategy?: string;
 };
 /**
- * @deprecated Use `TypedUser` instead. This will be removed in 4.0.
+ * Note: AuthenticatedUser still carries the write-only `password` from `User` (always `undefined` at runtime).
+ * Stripping it cleanly isn't possible, because auth operations build the authenticated user
+ * from a read `User` doc, so a `never`-typed `password` would break those assignments
  */
-export type UntypedUser = {
-    [key: string]: any;
-} & BaseUser;
 /**
- * `collection` is not available one the client. It's only available on the server (req.user)
- * On the client, you can access the collection via config.admin.user. Config can be accessed using the useConfig() hook
+ * The signed-in user: the read user plus the runtime auth markers (`_strategy`, `_sid`).
+ * Server authentication APIs may retain complete fields, while response boundaries apply read access.
  */
-export type ClientUser = {
-    [key: string]: any;
-} & BaseUser;
+export type AuthenticatedUser = AuthRuntimeFields & User;
 export type UserSession = {
-    createdAt: Date | string;
+    createdAt?: Date | null | string;
     expiresAt: Date | string;
     id: string;
 };
@@ -142,6 +147,8 @@ export type AuthStrategyFunctionArgs = {
     headers: Request['headers'];
     isGraphQL?: boolean;
     payload: Payload;
+    /** The request that initiated authentication, when available. */
+    req?: PayloadRequest;
     /**
      * The AuthStrategy name property from the payload config.
      */
@@ -149,10 +156,7 @@ export type AuthStrategyFunctionArgs = {
 };
 export type AuthStrategyResult = {
     responseHeaders?: Headers;
-    user: ({
-        _strategy?: string;
-        collection?: string;
-    } & TypedUser) | null;
+    user: AuthenticatedUser | null;
 };
 export type AuthStrategyFunction = (args: AuthStrategyFunctionArgs) => AuthStrategyResult | Promise<AuthStrategyResult>;
 export type AuthStrategy = {
@@ -168,22 +172,28 @@ export type LoginWithUsernameOptions = {
     requireEmail?: boolean;
     requireUsername?: boolean;
 };
+type AuthCookies = {
+    domain?: string;
+    sameSite?: 'Lax' | 'None' | 'Strict' | boolean;
+    secure?: boolean;
+};
 export interface IncomingAuthType {
     /**
      * Set cookie options, including secure, sameSite, and domain. For advanced users.
      */
-    cookies?: {
-        domain?: string;
-        sameSite?: 'Lax' | 'None' | 'Strict' | boolean;
-        secure?: boolean;
-    };
+    cookies?: AuthCookies;
     /**
      * How many levels deep a user document should be populated when creating the JWT and binding the user to the req. Defaults to 0 and should only be modified if absolutely necessary, as this will affect performance.
      * @default 0
      */
     depth?: number;
     /**
-     * Advanced - disable Payload's built-in local auth strategy. Only use this property if you have replaced Payload's auth mechanisms with your own.
+     * Controls whether Payload's built-in local auth strategy is disabled. Set to `true` to disable
+     * local authentication or `false` to keep it enabled.
+     *
+     * Pass an object to disable local authentication while configuring how its fields are retained.
+     * Only disable local authentication if you have replaced Payload's auth mechanisms with your own.
+     * @default false
      */
     disableLocalStrategy?: {
         /**
@@ -191,8 +201,11 @@ export interface IncomingAuthType {
          * Useful when you do not want the database or types to vary depending on the auth configuration.
          */
         enableFields?: true;
+        /**
+         * When auth fields are retained, make the password field optional.
+         */
         optionalPassword?: true;
-    } | true;
+    } | boolean;
     /**
      * Customize the way that the forgotPassword operation functions.
      * @link https://payloadcms.com/docs/authentication/email#forgot-password
@@ -205,6 +218,12 @@ export interface IncomingAuthType {
         expiration?: number;
         generateEmailHTML?: GenerateForgotPasswordEmailHTML;
         generateEmailSubject?: GenerateForgotPasswordEmailSubject;
+        /**
+         * The minimum number of milliseconds between password reset emails for the same user.
+         * @default 15000
+         * Set to 0 to disable.
+         */
+        minRequestInterval?: number;
     };
     /**
      * Set the time (in milliseconds) that a user should be locked out if they fail authentication more times than maxLoginAttempts allows for.
@@ -240,7 +259,13 @@ export interface IncomingAuthType {
      * @default false
      * @link https://payloadcms.com/docs/authentication/api-keys
      */
-    useAPIKey?: boolean;
+    useAPIKey?: {
+        /**
+         * Allows administrators to reveal stored API keys from the Admin Panel.
+         * @default false
+         */
+        reveal?: boolean;
+    } | boolean;
     /**
      * Use sessions for authentication. Enabled by default.
      * @default true
@@ -259,14 +284,9 @@ export type VerifyConfig = {
     generateEmailHTML?: GenerateVerifyEmailHTML;
     generateEmailSubject?: GenerateVerifyEmailSubject;
 };
-export interface Auth extends Omit<DeepRequired<IncomingAuthType>, 'forgotPassword' | 'loginWithUsername' | 'verify'> {
-    forgotPassword?: {
-        expiration?: number;
-        generateEmailHTML?: GenerateForgotPasswordEmailHTML;
-        generateEmailSubject?: GenerateForgotPasswordEmailSubject;
-    };
-    loginWithUsername: false | LoginWithUsernameOptions;
-    verify?: boolean | VerifyConfig;
+export interface Auth extends Omit<IncomingAuthType, 'cookies' | 'forgotPassword' | 'lockTime' | 'loginWithUsername' | 'maxLoginAttempts' | 'strategies' | 'tokenExpiration' | 'useSessions' | 'verify'>, Required<Pick<IncomingAuthType, 'forgotPassword' | 'lockTime' | 'maxLoginAttempts' | 'strategies' | 'tokenExpiration' | 'useSessions' | 'verify'>> {
+    cookies: Pick<AuthCookies, 'domain'> & Required<Pick<AuthCookies, 'sameSite' | 'secure'>>;
+    loginWithUsername: false | Required<LoginWithUsernameOptions>;
 }
 export declare function hasWhereAccessResult(result: boolean | Where): result is Where;
 export {};

package/dist/auth/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"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"}

package/dist/auth/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/auth/types.ts"],"sourcesContent":["import type { DeepRequired } from 'ts-essentials'\n\nimport type { CollectionSlug, GlobalSlug, Payload, TypedUser } from '../index.js'\nimport type { PayloadRequest, Where } from '../types/index.js'\n\n/**\n * A permission object that can be used to determine if a user has access to a specific operation.\n */\nexport type Permission = {\n  permission: boolean\n  where?: Where\n}\n\nexport type FieldsPermissions = {\n  [fieldName: string]: FieldPermissions\n}\n\nexport type BlockPermissions = {\n  create: Permission\n  fields: FieldsPermissions\n  read: Permission\n  update: Permission\n}\n\nexport type SanitizedBlockPermissions =\n  | {\n      fields: SanitizedFieldsPermissions\n    }\n  | true\n\nexport type BlocksPermissions = {\n  [blockSlug: string]: BlockPermissions\n}\n\nexport type SanitizedBlocksPermissions =\n  | {\n      [blockSlug: string]: SanitizedBlockPermissions\n    }\n  | true\n\nexport type FieldPermissions = {\n  blocks?: BlocksPermissions\n  create?: Permission\n  fields?: FieldsPermissions\n  read?: Permission\n  update?: Permission\n}\n\nexport type SanitizedFieldPermissions =\n  | {\n      blocks?: SanitizedBlocksPermissions\n      create: true\n      fields?: SanitizedFieldsPermissions\n      read: true\n      update: true\n    }\n  | true\n\nexport type SanitizedFieldsPermissions =\n  | {\n      [fieldName: string]: SanitizedFieldPermissions\n    }\n  | true\n\nexport type CollectionPermission = {\n  create?: Permission\n  delete?: Permission\n  fields: FieldsPermissions\n  read?: Permission\n  readVersions?: Permission\n  // Auth-enabled Collections only\n  unlock?: Permission\n  update?: Permission\n}\n\nexport type SanitizedCollectionPermission = {\n  create?: true\n  delete?: true\n  fields: SanitizedFieldsPermissions\n  read?: true\n  readVersions?: true\n  // Auth-enabled Collections only\n  unlock?: true\n  update?: true\n}\n\nexport type GlobalPermission = {\n  fields: FieldsPermissions\n  read?: Permission\n  readVersions?: Permission\n  update?: Permission\n}\n\nexport type SanitizedGlobalPermission = {\n  fields: SanitizedFieldsPermissions\n  read?: true\n  readVersions?: true\n  update?: true\n}\n\nexport type DocumentPermissions = CollectionPermission | GlobalPermission\n\nexport type SanitizedDocumentPermissions = SanitizedCollectionPermission | SanitizedGlobalPermission\n\nexport type Permissions = {\n  canAccessAdmin: boolean\n  collections?: Record<CollectionSlug, CollectionPermission>\n  globals?: Record<GlobalSlug, GlobalPermission>\n}\n\nexport type SanitizedPermissions = {\n  canAccessAdmin?: boolean\n  collections?: {\n    [collectionSlug: string]: SanitizedCollectionPermission\n  }\n  globals?: {\n    [globalSlug: string]: SanitizedGlobalPermission\n  }\n}\n\ntype BaseUser = {\n  collection: string\n  email?: string\n  id: number | string\n  sessions?: Array<UserSession>\n  username?: string\n}\n\n/**\n * @deprecated Use `TypedUser` instead. This will be removed in 4.0.\n */\nexport type UntypedUser = {\n  [key: string]: any\n} & BaseUser\n\n/**\n * `collection` is not available one the client. It's only available on the server (req.user)\n * On the client, you can access the collection via config.admin.user. Config can be accessed using the useConfig() hook\n */\nexport type ClientUser = {\n  [key: string]: any\n} & BaseUser\n\nexport type UserSession = { createdAt: Date | string; expiresAt: Date | string; id: string }\ntype GenerateVerifyEmailHTML<TUser = any> = (args: {\n  req: PayloadRequest\n  token: string\n  user: TUser\n}) => Promise<string> | string\n\ntype GenerateVerifyEmailSubject<TUser = any> = (args: {\n  req: PayloadRequest\n  token: string\n  user: TUser\n}) => Promise<string> | string\n\ntype GenerateForgotPasswordEmailHTML<TUser = any> = (args?: {\n  req?: PayloadRequest\n  token?: string\n  user?: TUser\n}) => Promise<string> | string\n\ntype GenerateForgotPasswordEmailSubject<TUser = any> = (args?: {\n  req?: PayloadRequest\n  token?: string\n  user?: TUser\n}) => Promise<string> | string\n\nexport type AuthStrategyFunctionArgs = {\n  /**\n   * Specifies whether or not response headers can be set from this strategy.\n   */\n  canSetHeaders?: boolean\n  headers: Request['headers']\n  isGraphQL?: boolean\n  payload: Payload\n  /**\n   * The AuthStrategy name property from the payload config.\n   */\n  strategyName?: string\n}\n\nexport type AuthStrategyResult = {\n  responseHeaders?: Headers\n  user:\n    | ({\n        _strategy?: string\n        collection?: string\n      } & TypedUser)\n    | null\n}\n\nexport type AuthStrategyFunction = (\n  args: AuthStrategyFunctionArgs,\n) => AuthStrategyResult | Promise<AuthStrategyResult>\nexport type AuthStrategy = {\n  authenticate: AuthStrategyFunction\n  name: string\n}\n\nexport type LoginWithUsernameOptions =\n  | {\n      allowEmailLogin?: false\n      requireEmail?: boolean\n      // If `allowEmailLogin` is false, `requireUsername` must be true (default: true)\n      requireUsername?: true\n    }\n  | {\n      allowEmailLogin?: true\n      requireEmail?: boolean\n      requireUsername?: boolean\n    }\n\nexport interface IncomingAuthType {\n  /**\n   * Set cookie options, including secure, sameSite, and domain. For advanced users.\n   */\n  cookies?: {\n    domain?: string\n    sameSite?: 'Lax' | 'None' | 'Strict' | boolean\n    secure?: boolean\n  }\n  /**\n   * How many levels deep a user document should be populated when creating the JWT and binding the user to the req. Defaults to 0 and should only be modified if absolutely necessary, as this will affect performance.\n   * @default 0\n   */\n  depth?: number\n  /**\n   * Advanced - disable Payload's built-in local auth strategy. Only use this property if you have replaced Payload's auth mechanisms with your own.\n   */\n  disableLocalStrategy?:\n    | {\n        /**\n         * Include auth fields on the collection even though the local strategy is disabled.\n         * Useful when you do not want the database or types to vary depending on the auth configuration.\n         */\n        enableFields?: true\n        optionalPassword?: true\n      }\n    | true\n  /**\n   * Customize the way that the forgotPassword operation functions.\n   * @link https://payloadcms.com/docs/authentication/email#forgot-password\n   */\n  forgotPassword?: {\n    /**\n     * The number of milliseconds that the forgot password token should be valid for.\n     * @default 3600000 // 1 hour\n     */\n    expiration?: number\n    generateEmailHTML?: GenerateForgotPasswordEmailHTML\n    generateEmailSubject?: GenerateForgotPasswordEmailSubject\n  }\n  /**\n   * Set the time (in milliseconds) that a user should be locked out if they fail authentication more times than maxLoginAttempts allows for.\n   */\n  lockTime?: number\n  /**\n   * Ability to allow users to login with username/password.\n   *\n   * @link https://payloadcms.com/docs/authentication/overview#login-with-username\n   */\n  loginWithUsername?: boolean | LoginWithUsernameOptions\n  /**\n   * Only allow a user to attempt logging in X amount of times. Automatically locks out a user from authenticating if this limit is passed. Set to 0 to disable.\n   */\n  maxLoginAttempts?: number\n  /***\n   * Set to true if you want to remove the token from the returned authentication API responses such as login or refresh.\n   */\n  removeTokenFromResponses?: true\n  /**\n   * Advanced - an array of custom authentification strategies to extend this collection's authentication with.\n   * @link https://payloadcms.com/docs/authentication/custom-strategies\n   */\n  strategies?: AuthStrategy[]\n  /**\n   * Controls how many seconds the token will be valid for. Default is 2 hours.\n   * @default 7200\n   * @link https://payloadcms.com/docs/authentication/overview#config-options\n   */\n  tokenExpiration?: number\n  /**\n   * Payload Authentication provides for API keys to be set on each user within an Authentication-enabled Collection.\n   * @default false\n   * @link https://payloadcms.com/docs/authentication/api-keys\n   */\n  useAPIKey?: boolean\n\n  /**\n   * Use sessions for authentication. Enabled by default.\n   * @default true\n   */\n  useSessions?: boolean\n\n  /**\n   * Set to true or pass an object with verification options to require users to verify by email before they are allowed to log into your app.\n   * @link https://payloadcms.com/docs/authentication/email#email-verification\n   */\n  verify?:\n    | {\n        generateEmailHTML?: GenerateVerifyEmailHTML\n        generateEmailSubject?: GenerateVerifyEmailSubject\n      }\n    | boolean\n}\n\nexport type VerifyConfig = {\n  generateEmailHTML?: GenerateVerifyEmailHTML\n  generateEmailSubject?: GenerateVerifyEmailSubject\n}\n\nexport interface Auth\n  extends Omit<DeepRequired<IncomingAuthType>, 'forgotPassword' | 'loginWithUsername' | 'verify'> {\n  forgotPassword?: {\n    expiration?: number\n    generateEmailHTML?: GenerateForgotPasswordEmailHTML\n    generateEmailSubject?: GenerateForgotPasswordEmailSubject\n  }\n  loginWithUsername: false | LoginWithUsernameOptions\n  verify?: boolean | VerifyConfig\n}\n\nexport function hasWhereAccessResult(result: boolean | Where): result is Where {\n  return result && typeof result === 'object'\n}\n"],"names":["hasWhereAccessResult","result"],"mappings":"AAmUA,OAAO,SAASA,qBAAqBC,MAAuB;IAC1D,OAAOA,UAAU,OAAOA,WAAW;AACrC"}
+{"version":3,"sources":["../../src/auth/types.ts"],"sourcesContent":["import type { CollectionSlug, GlobalSlug, Payload, User } from '../index.js'\nimport type { PayloadRequest, Where } from '../types/index.js'\n\n/**\n * A permission object that can be used to determine if a user has access to a specific operation.\n */\nexport type Permission = {\n  permission: boolean\n  where?: Where\n}\n\nexport type FieldsPermissions = {\n  [fieldName: string]: FieldPermissions\n}\n\nexport type BlockPermissions = {\n  create: Permission\n  fields: FieldsPermissions\n  read: Permission\n  update: Permission\n}\n\nexport type SanitizedBlockPermissions =\n  | {\n      fields: SanitizedFieldsPermissions\n    }\n  | true\n\nexport type BlocksPermissions = {\n  [blockSlug: string]: BlockPermissions\n}\n\nexport type SanitizedBlocksPermissions =\n  | {\n      [blockSlug: string]: SanitizedBlockPermissions\n    }\n  | true\n\nexport type FieldPermissions = {\n  blocks?: BlocksPermissions\n  create?: Permission\n  fields?: FieldsPermissions\n  read?: Permission\n  update?: Permission\n}\n\nexport type SanitizedFieldPermissions =\n  | {\n      blocks?: SanitizedBlocksPermissions\n      create: true\n      fields?: SanitizedFieldsPermissions\n      read: true\n      update: true\n    }\n  | true\n\nexport type SanitizedFieldsPermissions =\n  | {\n      [fieldName: string]: SanitizedFieldPermissions\n    }\n  | true\n\nexport type CollectionPermission = {\n  create?: Permission\n  delete?: Permission\n  fields: FieldsPermissions\n  read?: Permission\n  readVersions?: Permission\n  // Auth-enabled Collections only\n  unlock?: Permission\n  update?: Permission\n}\n\nexport type SanitizedCollectionPermission = {\n  create?: true\n  delete?: true\n  fields: SanitizedFieldsPermissions\n  read?: true\n  readVersions?: true\n  // Auth-enabled Collections only\n  unlock?: true\n  update?: true\n}\n\nexport type GlobalPermission = {\n  fields: FieldsPermissions\n  read?: Permission\n  readVersions?: Permission\n  update?: Permission\n}\n\nexport type SanitizedGlobalPermission = {\n  fields: SanitizedFieldsPermissions\n  read?: true\n  readVersions?: true\n  update?: true\n}\n\nexport type DocumentPermissions = CollectionPermission | GlobalPermission\n\nexport type SanitizedDocumentPermissions = SanitizedCollectionPermission | SanitizedGlobalPermission\n\nexport type Permissions = {\n  canAccessAdmin: boolean\n  collections?: Record<CollectionSlug, CollectionPermission>\n  globals?: Record<GlobalSlug, GlobalPermission>\n}\n\nexport type SanitizedPermissions = {\n  canAccessAdmin?: boolean\n  collections?: {\n    [collectionSlug: string]: SanitizedCollectionPermission\n  }\n  globals?: {\n    [globalSlug: string]: SanitizedGlobalPermission\n  }\n}\n\n/**\n * Fields injected onto a user at authentication time. They are never stored in the database and\n * never present on a plain document read (e.g. `payload.findByID`) - only on the authenticated\n * user (`req.user`, login/auth/me results, auth strategies).\n */\nexport type AuthRuntimeFields = {\n  /**\n   * The session ID of the current request. May be present on request-authenticated users when\n   * sessions are enabled.\n   */\n  _sid?: string\n  /**\n   * The name of the auth strategy that authenticated the request (e.g. `local-jwt`).\n   */\n  _strategy?: string\n}\n\n/**\n * Note: AuthenticatedUser still carries the write-only `password` from `User` (always `undefined` at runtime).\n * Stripping it cleanly isn't possible, because auth operations build the authenticated user\n * from a read `User` doc, so a `never`-typed `password` would break those assignments\n */\n/**\n * The signed-in user: the read user plus the runtime auth markers (`_strategy`, `_sid`).\n * Server authentication APIs may retain complete fields, while response boundaries apply read access.\n */\nexport type AuthenticatedUser = AuthRuntimeFields & User\n\nexport type UserSession = {\n  createdAt?: Date | null | string\n  expiresAt: Date | string\n  id: string\n}\ntype GenerateVerifyEmailHTML<TUser = any> = (args: {\n  req: PayloadRequest\n  token: string\n  user: TUser\n}) => Promise<string> | string\n\ntype GenerateVerifyEmailSubject<TUser = any> = (args: {\n  req: PayloadRequest\n  token: string\n  user: TUser\n}) => Promise<string> | string\n\ntype GenerateForgotPasswordEmailHTML<TUser = any> = (args?: {\n  req?: PayloadRequest\n  token?: string\n  user?: TUser\n}) => Promise<string> | string\n\ntype GenerateForgotPasswordEmailSubject<TUser = any> = (args?: {\n  req?: PayloadRequest\n  token?: string\n  user?: TUser\n}) => Promise<string> | string\n\nexport type AuthStrategyFunctionArgs = {\n  /**\n   * Specifies whether or not response headers can be set from this strategy.\n   */\n  canSetHeaders?: boolean\n  headers: Request['headers']\n  isGraphQL?: boolean\n  payload: Payload\n  /** The request that initiated authentication, when available. */\n  req?: PayloadRequest\n  /**\n   * The AuthStrategy name property from the payload config.\n   */\n  strategyName?: string\n}\n\nexport type AuthStrategyResult = {\n  responseHeaders?: Headers\n  user: AuthenticatedUser | null\n}\n\nexport type AuthStrategyFunction = (\n  args: AuthStrategyFunctionArgs,\n) => AuthStrategyResult | Promise<AuthStrategyResult>\nexport type AuthStrategy = {\n  authenticate: AuthStrategyFunction\n  name: string\n}\n\nexport type LoginWithUsernameOptions =\n  | {\n      allowEmailLogin?: false\n      requireEmail?: boolean\n      // If `allowEmailLogin` is false, `requireUsername` must be true (default: true)\n      requireUsername?: true\n    }\n  | {\n      allowEmailLogin?: true\n      requireEmail?: boolean\n      requireUsername?: boolean\n    }\n\ntype AuthCookies = {\n  domain?: string\n  sameSite?: 'Lax' | 'None' | 'Strict' | boolean\n  secure?: boolean\n}\n\nexport interface IncomingAuthType {\n  /**\n   * Set cookie options, including secure, sameSite, and domain. For advanced users.\n   */\n  cookies?: AuthCookies\n  /**\n   * How many levels deep a user document should be populated when creating the JWT and binding the user to the req. Defaults to 0 and should only be modified if absolutely necessary, as this will affect performance.\n   * @default 0\n   */\n  depth?: number\n  /**\n   * Controls whether Payload's built-in local auth strategy is disabled. Set to `true` to disable\n   * local authentication or `false` to keep it enabled.\n   *\n   * Pass an object to disable local authentication while configuring how its fields are retained.\n   * Only disable local authentication if you have replaced Payload's auth mechanisms with your own.\n   * @default false\n   */\n  disableLocalStrategy?:\n    | {\n        /**\n         * Include auth fields on the collection even though the local strategy is disabled.\n         * Useful when you do not want the database or types to vary depending on the auth configuration.\n         */\n        enableFields?: true\n        /**\n         * When auth fields are retained, make the password field optional.\n         */\n        optionalPassword?: true\n      }\n    | boolean\n  /**\n   * Customize the way that the forgotPassword operation functions.\n   * @link https://payloadcms.com/docs/authentication/email#forgot-password\n   */\n  forgotPassword?: {\n    /**\n     * The number of milliseconds that the forgot password token should be valid for.\n     * @default 3600000 // 1 hour\n     */\n    expiration?: number\n    generateEmailHTML?: GenerateForgotPasswordEmailHTML\n    generateEmailSubject?: GenerateForgotPasswordEmailSubject\n    /**\n     * The minimum number of milliseconds between password reset emails for the same user.\n     * @default 15000\n     * Set to 0 to disable.\n     */\n    minRequestInterval?: number\n  }\n  /**\n   * Set the time (in milliseconds) that a user should be locked out if they fail authentication more times than maxLoginAttempts allows for.\n   */\n  lockTime?: number\n  /**\n   * Ability to allow users to login with username/password.\n   *\n   * @link https://payloadcms.com/docs/authentication/overview#login-with-username\n   */\n  loginWithUsername?: boolean | LoginWithUsernameOptions\n  /**\n   * Only allow a user to attempt logging in X amount of times. Automatically locks out a user from authenticating if this limit is passed. Set to 0 to disable.\n   */\n  maxLoginAttempts?: number\n  /***\n   * Set to true if you want to remove the token from the returned authentication API responses such as login or refresh.\n   */\n  removeTokenFromResponses?: true\n  /**\n   * Advanced - an array of custom authentification strategies to extend this collection's authentication with.\n   * @link https://payloadcms.com/docs/authentication/custom-strategies\n   */\n  strategies?: AuthStrategy[]\n  /**\n   * Controls how many seconds the token will be valid for. Default is 2 hours.\n   * @default 7200\n   * @link https://payloadcms.com/docs/authentication/overview#config-options\n   */\n  tokenExpiration?: number\n  /**\n   * Payload Authentication provides for API keys to be set on each user within an Authentication-enabled Collection.\n   * @default false\n   * @link https://payloadcms.com/docs/authentication/api-keys\n   */\n  useAPIKey?:\n    | {\n        /**\n         * Allows administrators to reveal stored API keys from the Admin Panel.\n         * @default false\n         */\n        reveal?: boolean\n      }\n    | boolean\n\n  /**\n   * Use sessions for authentication. Enabled by default.\n   * @default true\n   */\n  useSessions?: boolean\n\n  /**\n   * Set to true or pass an object with verification options to require users to verify by email before they are allowed to log into your app.\n   * @link https://payloadcms.com/docs/authentication/email#email-verification\n   */\n  verify?:\n    | {\n        generateEmailHTML?: GenerateVerifyEmailHTML\n        generateEmailSubject?: GenerateVerifyEmailSubject\n      }\n    | boolean\n}\n\nexport type VerifyConfig = {\n  generateEmailHTML?: GenerateVerifyEmailHTML\n  generateEmailSubject?: GenerateVerifyEmailSubject\n}\n\nexport interface Auth\n  extends Omit<\n      IncomingAuthType,\n      | 'cookies'\n      | 'forgotPassword'\n      | 'lockTime'\n      | 'loginWithUsername'\n      | 'maxLoginAttempts'\n      | 'strategies'\n      | 'tokenExpiration'\n      | 'useSessions'\n      | 'verify'\n    >,\n    Required<\n      Pick<\n        IncomingAuthType,\n        | 'forgotPassword'\n        | 'lockTime'\n        | 'maxLoginAttempts'\n        | 'strategies'\n        | 'tokenExpiration'\n        | 'useSessions'\n        | 'verify'\n      >\n    > {\n  cookies: Pick<AuthCookies, 'domain'> & Required<Pick<AuthCookies, 'sameSite' | 'secure'>>\n  loginWithUsername: false | Required<LoginWithUsernameOptions>\n}\n\nexport function hasWhereAccessResult(result: boolean | Where): result is Where {\n  return result && typeof result === 'object'\n}\n"],"names":["hasWhereAccessResult","result"],"mappings":"AAiXA,OAAO,SAASA,qBAAqBC,MAAuB;IAC1D,OAAOA,UAAU,OAAOA,WAAW;AACrC"}

package/dist/auth/withBaseAccess.d.ts

@@ -0,0 +1,22 @@
+import type { CollectionAccess } from '../collections/config/types.js';
+import type { Access } from '../config/types.js';
+import type { GlobalAccess } from '../globals/config/types.js';
+type CommonArgs = {
+    access?: Access;
+    slug: string;
+};
+type AdminAccess = NonNullable<CollectionAccess['admin']>;
+type Args = ({
+    entityType: 'collection';
+    operation: Exclude<keyof CollectionAccess, 'admin'>;
+} | {
+    entityType: 'global';
+    operation: keyof GlobalAccess;
+}) & CommonArgs;
+export declare const withBaseAccess: (options: Args) => Access;
+export declare const withBaseAdminAccess: ({ slug, access, }: {
+    access?: AdminAccess;
+    slug: string;
+}) => AdminAccess;
+export {};
+//# sourceMappingURL=withBaseAccess.d.ts.map

package/dist/auth/withBaseAccess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withBaseAccess.d.ts","sourceRoot":"","sources":["../../src/auth/withBaseAccess.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,MAAM,EAA4B,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,KAAK,UAAU,GAAG;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,KAAK,WAAW,GAAG,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;AAEzD,KAAK,IAAI,GAAG,CACR;IACE,UAAU,EAAE,YAAY,CAAA;IACxB,SAAS,EAAE,OAAO,CAAC,MAAM,gBAAgB,EAAE,OAAO,CAAC,CAAA;CACpD,GACD;IACE,UAAU,EAAE,QAAQ,CAAA;IACpB,SAAS,EAAE,MAAM,YAAY,CAAA;CAC9B,CACJ,GACC,UAAU,CAAA;AAIZ,eAAO,MAAM,cAAc,YAAa,IAAI,KAAG,MAkD9C,CAAA;AAED,eAAO,MAAM,mBAAmB,sBAG7B;IACD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb,KAAG,WA2BH,CAAA"}

package/dist/auth/withBaseAccess.js

@@ -0,0 +1,61 @@
+const authenticatedAccess = ({ req })=>Boolean(req.user);
+export const withBaseAccess = (options)=>{
+    const documentAccess = options.access ?? authenticatedAccess;
+    return async (args)=>{
+        const accessArgs = {
+            ...args,
+            slug: options.slug
+        };
+        const { baseAccess } = args.req.payload.config;
+        const baseAccessFunction = options.entityType === 'collection' ? baseAccess?.collections?.[options.operation] : baseAccess?.globals?.[options.operation];
+        if (!baseAccessFunction) {
+            return documentAccess(accessArgs);
+        }
+        const baseResult = await baseAccessFunction(accessArgs);
+        if (!baseResult) {
+            return false;
+        }
+        if (options.entityType === 'collection' && options.operation === 'create' && typeof baseResult === 'object') {
+            throw new Error('baseAccess must return a boolean for collection create operations.');
+        }
+        const documentResult = await documentAccess(accessArgs);
+        if (!documentResult) {
+            return false;
+        }
+        if (baseResult === true) {
+            return documentResult;
+        }
+        if (documentResult === true) {
+            return baseResult;
+        }
+        return {
+            and: [
+                baseResult,
+                documentResult
+            ]
+        };
+    };
+};
+export const withBaseAdminAccess = ({ slug, access })=>{
+    const documentAccess = access ?? (({ req })=>Boolean(req.user && req.payload.config.admin.user === slug));
+    return async (args)=>{
+        const accessArgs = {
+            ...args,
+            slug
+        };
+        const baseAccessFunction = args.req.payload.config.baseAccess?.collections?.admin;
+        if (!baseAccessFunction) {
+            return documentAccess(accessArgs);
+        }
+        const baseResult = await baseAccessFunction(accessArgs);
+        if (!baseResult) {
+            return false;
+        }
+        if (typeof baseResult === 'object') {
+            throw new Error('baseAccess must return a boolean for collection admin operations.');
+        }
+        return documentAccess(accessArgs);
+    };
+};
+
+//# sourceMappingURL=withBaseAccess.js.map

package/dist/auth/withBaseAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/auth/withBaseAccess.ts"],"sourcesContent":["import type { CollectionAccess } from '../collections/config/types.js'\nimport type { Access, AccessArgs, AccessResult } from '../config/types.js'\nimport type { GlobalAccess } from '../globals/config/types.js'\n\ntype CommonArgs = {\n  access?: Access\n  slug: string\n}\n\ntype AdminAccess = NonNullable<CollectionAccess['admin']>\n\ntype Args = (\n  | {\n      entityType: 'collection'\n      operation: Exclude<keyof CollectionAccess, 'admin'>\n    }\n  | {\n      entityType: 'global'\n      operation: keyof GlobalAccess\n    }\n) &\n  CommonArgs\n\nconst authenticatedAccess: Access = ({ req }) => Boolean(req.user)\n\nexport const withBaseAccess = (options: Args): Access => {\n  const documentAccess = options.access ?? authenticatedAccess\n\n  return async (args: AccessArgs): Promise<AccessResult> => {\n    const accessArgs = {\n      ...args,\n      slug: options.slug,\n    }\n    const { baseAccess } = args.req.payload.config\n    const baseAccessFunction =\n      options.entityType === 'collection'\n        ? baseAccess?.collections?.[options.operation]\n        : baseAccess?.globals?.[options.operation]\n\n    if (!baseAccessFunction) {\n      return documentAccess(accessArgs)\n    }\n\n    const baseResult = await baseAccessFunction(accessArgs)\n\n    if (!baseResult) {\n      return false\n    }\n\n    if (\n      options.entityType === 'collection' &&\n      options.operation === 'create' &&\n      typeof baseResult === 'object'\n    ) {\n      throw new Error('baseAccess must return a boolean for collection create operations.')\n    }\n\n    const documentResult = await documentAccess(accessArgs)\n\n    if (!documentResult) {\n      return false\n    }\n\n    if (baseResult === true) {\n      return documentResult\n    }\n\n    if (documentResult === true) {\n      return baseResult\n    }\n\n    return {\n      and: [baseResult, documentResult],\n    }\n  }\n}\n\nexport const withBaseAdminAccess = ({\n  slug,\n  access,\n}: {\n  access?: AdminAccess\n  slug: string\n}): AdminAccess => {\n  const documentAccess =\n    access ?? (({ req }) => Boolean(req.user && req.payload.config.admin.user === slug))\n\n  return async (args) => {\n    const accessArgs = {\n      ...args,\n      slug,\n    }\n    const baseAccessFunction = args.req.payload.config.baseAccess?.collections?.admin\n\n    if (!baseAccessFunction) {\n      return documentAccess(accessArgs)\n    }\n\n    const baseResult = await baseAccessFunction(accessArgs)\n\n    if (!baseResult) {\n      return false\n    }\n\n    if (typeof baseResult === 'object') {\n      throw new Error('baseAccess must return a boolean for collection admin operations.')\n    }\n\n    return documentAccess(accessArgs)\n  }\n}\n"],"names":["authenticatedAccess","req","Boolean","user","withBaseAccess","options","documentAccess","access","args","accessArgs","slug","baseAccess","payload","config","baseAccessFunction","entityType","collections","operation","globals","baseResult","Error","documentResult","and","withBaseAdminAccess","admin"],"mappings":"AAuBA,MAAMA,sBAA8B,CAAC,EAAEC,GAAG,EAAE,GAAKC,QAAQD,IAAIE,IAAI;AAEjE,OAAO,MAAMC,iBAAiB,CAACC;IAC7B,MAAMC,iBAAiBD,QAAQE,MAAM,IAAIP;IAEzC,OAAO,OAAOQ;QACZ,MAAMC,aAAa;YACjB,GAAGD,IAAI;YACPE,MAAML,QAAQK,IAAI;QACpB;QACA,MAAM,EAAEC,UAAU,EAAE,GAAGH,KAAKP,GAAG,CAACW,OAAO,CAACC,MAAM;QAC9C,MAAMC,qBACJT,QAAQU,UAAU,KAAK,eACnBJ,YAAYK,aAAa,CAACX,QAAQY,SAAS,CAAC,GAC5CN,YAAYO,SAAS,CAACb,QAAQY,SAAS,CAAC;QAE9C,IAAI,CAACH,oBAAoB;YACvB,OAAOR,eAAeG;QACxB;QAEA,MAAMU,aAAa,MAAML,mBAAmBL;QAE5C,IAAI,CAACU,YAAY;YACf,OAAO;QACT;QAEA,IACEd,QAAQU,UAAU,KAAK,gBACvBV,QAAQY,SAAS,KAAK,YACtB,OAAOE,eAAe,UACtB;YACA,MAAM,IAAIC,MAAM;QAClB;QAEA,MAAMC,iBAAiB,MAAMf,eAAeG;QAE5C,IAAI,CAACY,gBAAgB;YACnB,OAAO;QACT;QAEA,IAAIF,eAAe,MAAM;YACvB,OAAOE;QACT;QAEA,IAAIA,mBAAmB,MAAM;YAC3B,OAAOF;QACT;QAEA,OAAO;YACLG,KAAK;gBAACH;gBAAYE;aAAe;QACnC;IACF;AACF,EAAC;AAED,OAAO,MAAME,sBAAsB,CAAC,EAClCb,IAAI,EACJH,MAAM,EAIP;IACC,MAAMD,iBACJC,UAAW,CAAA,CAAC,EAAEN,GAAG,EAAE,GAAKC,QAAQD,IAAIE,IAAI,IAAIF,IAAIW,OAAO,CAACC,MAAM,CAACW,KAAK,CAACrB,IAAI,KAAKO,KAAI;IAEpF,OAAO,OAAOF;QACZ,MAAMC,aAAa;YACjB,GAAGD,IAAI;YACPE;QACF;QACA,MAAMI,qBAAqBN,KAAKP,GAAG,CAACW,OAAO,CAACC,MAAM,CAACF,UAAU,EAAEK,aAAaQ;QAE5E,IAAI,CAACV,oBAAoB;YACvB,OAAOR,eAAeG;QACxB;QAEA,MAAMU,aAAa,MAAML,mBAAmBL;QAE5C,IAAI,CAACU,YAAY;YACf,OAAO;QACT;QAEA,IAAI,OAAOA,eAAe,UAAU;YAClC,MAAM,IAAIC,MAAM;QAClB;QAEA,OAAOd,eAAeG;IACxB;AACF,EAAC"}

package/dist/cli/commands/build/build.d.ts

@@ -0,0 +1,44 @@
+import type { SanitizedConfig } from '../../../config/types.js';
+type Framework = 'next' | 'tanstack-start';
+/**
+ * `payload build` — generate the import map (and types) so they are on disk
+ * before the framework build statically imports them, then detect the project's
+ * framework (Next.js or TanStack Start) and run its build, forwarding any extra
+ * CLI args verbatim.
+ *
+ * Returns the framework build's exit code, or 1 if pre-build generation or
+ * framework detection fails.
+ */
+export declare function build({ config, forwardedArgs, isJSON, skipTypes, }: {
+    config: SanitizedConfig;
+    forwardedArgs?: string[];
+    isJSON?: boolean;
+    skipTypes?: boolean;
+}): Promise<number>;
+/**
+ * Determine whether the project builds with Next.js or TanStack Start. An explicit
+ * `PAYLOAD_FRAMEWORK` env wins; otherwise tries the most intentional signals first
+ * — declared dependencies, then framework config files, then Payload's
+ * admin-route folder conventions — falling through when a layer is inconclusive.
+ * Throws with guidance for an unsupported override or when no single framework can
+ * be determined.
+ */
+export declare function detectFramework(cwd?: string): Framework;
+/** Resolve the project's `next` binary — see {@link resolveBin}. */
+export declare function resolveNextBin(cwd?: string): string;
+/** Resolve the project's `vite` binary — see {@link resolveBin}. */
+export declare function resolveViteBin(cwd?: string): string;
+/**
+ * Map a detected framework to the resolved binary and argument list to spawn.
+ * Both frameworks take the `build` subcommand followed by the forwarded args.
+ */
+export declare function resolveBuildCommand({ cwd, forwardedArgs, framework, }: {
+    cwd?: string;
+    forwardedArgs: string[];
+    framework: Framework;
+}): {
+    args: string[];
+    bin: string;
+};
+export {};
+//# sourceMappingURL=build.d.ts.map

package/dist/cli/commands/build/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/build/build.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAS/D,KAAK,SAAS,GAAG,MAAM,GAAG,gBAAgB,CAAA;AAY1C;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,EAC1B,MAAM,EACN,aAAkB,EAClB,MAAc,EACd,SAAiB,GAClB,EAAE;IACD,MAAM,EAAE,eAAe,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ClB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,SAAS,CAuDtE;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAElE;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,GAAmB,EACnB,aAAa,EACb,SAAS,GACV,EAAE;IACD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,SAAS,EAAE,SAAS,CAAA;CACrB,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAGlC"}

package/dist/cli/commands/build/build.js

@@ -0,0 +1,225 @@
+/* eslint-disable no-console */ import { spawn } from 'node:child_process';
+import fs, { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { NEXT_PAYLOAD_ROUTE_GROUP, TANSTACK_PAYLOAD_DIR } from '../generateImportMap/frameworkConventions.js';
+import { generateImportMap } from '../generateImportMap/generateImportMap.js';
+import { generateTypes } from '../generateTypes.js';
+const NEXT_CONFIG_FILES = [
+    'next.config.js',
+    'next.config.ts',
+    'next.config.mjs',
+    'next.config.cjs'
+];
+const VITE_CONFIG_FILES = [
+    'vite.config.js',
+    'vite.config.ts',
+    'vite.config.mjs',
+    'vite.config.cjs',
+    'vite.config.cts',
+    'vite.config.mts'
+];
+/**
+ * `payload build` — generate the import map (and types) so they are on disk
+ * before the framework build statically imports them, then detect the project's
+ * framework (Next.js or TanStack Start) and run its build, forwarding any extra
+ * CLI args verbatim.
+ *
+ * Returns the framework build's exit code, or 1 if pre-build generation or
+ * framework detection fails.
+ */ export async function build({ config, forwardedArgs = [], isJSON = false, skipTypes = false }) {
+    try {
+        await generateImportMap(config, {
+            log: !isJSON
+        });
+        if (!skipTypes) {
+            await generateTypes(config, {
+                log: !isJSON
+            });
+        }
+    } catch (err) {
+        console.error('Pre-build generation failed:');
+        console.error(err);
+        return 1;
+    }
+    let bin;
+    let args;
+    try {
+        const framework = detectFramework();
+        ({ args, bin } = resolveBuildCommand({
+            forwardedArgs,
+            framework
+        }));
+    } catch (err) {
+        console.error(err instanceof Error ? err.message : err);
+        return 1;
+    }
+    const exitCode = await new Promise((resolve)=>{
+        const child = spawn(process.execPath, [
+            bin,
+            ...args
+        ], {
+            stdio: isJSON ? [
+                'inherit',
+                2,
+                2
+            ] : 'inherit'
+        });
+        child.on('error', (err)=>{
+            console.error('Failed to run build:');
+            console.error(err);
+            resolve(1);
+        });
+        // A signal kill (e.g. SIGKILL from an OOM) reports `code === null`; treat any
+        // missing code as failure so an abnormal termination never reports success.
+        child.once('close', (code, signal)=>{
+            if (signal) {
+                console.error(`Build terminated by signal ${signal}`);
+                resolve(1);
+                return;
+            }
+            resolve(code ?? 1);
+        });
+    });
+    return exitCode;
+}
+/**
+ * Determine whether the project builds with Next.js or TanStack Start. An explicit
+ * `PAYLOAD_FRAMEWORK` env wins; otherwise tries the most intentional signals first
+ * — declared dependencies, then framework config files, then Payload's
+ * admin-route folder conventions — falling through when a layer is inconclusive.
+ * Throws with guidance for an unsupported override or when no single framework can
+ * be determined.
+ */ export function detectFramework(cwd = process.cwd()) {
+    const override = process.env.PAYLOAD_FRAMEWORK;
+    if (override) {
+        if (isFramework(override)) {
+            return override;
+        }
+        throw new Error(`PAYLOAD_FRAMEWORK is set to "${override}", which is not supported. Use one of: next, tanstack-start.`);
+    }
+    const deps = readProjectDependencies(cwd);
+    const hasNextDep = Boolean(deps.next);
+    const hasTanstackDep = Boolean(deps['@tanstack/react-start']);
+    if (hasNextDep && !hasTanstackDep) {
+        return 'next';
+    }
+    if (hasTanstackDep && !hasNextDep) {
+        return 'tanstack-start';
+    }
+    const hasNextConfig = NEXT_CONFIG_FILES.some((file)=>fs.existsSync(path.join(cwd, file)));
+    const hasViteConfig = VITE_CONFIG_FILES.some((file)=>fs.existsSync(path.join(cwd, file)));
+    if (hasNextConfig && !hasViteConfig) {
+        return 'next';
+    }
+    if (hasViteConfig && !hasNextConfig) {
+        return 'tanstack-start';
+    }
+    const hasNextFolder = [
+        path.join(cwd, 'app', NEXT_PAYLOAD_ROUTE_GROUP),
+        path.join(cwd, 'src', 'app', NEXT_PAYLOAD_ROUTE_GROUP)
+    ].some((dir)=>fs.existsSync(dir));
+    const hasTanstackFolder = [
+        path.join(cwd, 'app', TANSTACK_PAYLOAD_DIR),
+        path.join(cwd, 'src', 'app', TANSTACK_PAYLOAD_DIR)
+    ].some((dir)=>fs.existsSync(dir));
+    if (hasNextFolder && !hasTanstackFolder) {
+        return 'next';
+    }
+    if (hasTanstackFolder && !hasNextFolder) {
+        return 'tanstack-start';
+    }
+    throw new Error(buildDetectionError({
+        hasNextConfig,
+        hasNextDep,
+        hasNextFolder,
+        hasTanstackDep,
+        hasTanstackFolder,
+        hasViteConfig
+    }));
+}
+/** Resolve the project's `next` binary — see {@link resolveBin}. */ export function resolveNextBin(cwd = process.cwd()) {
+    return resolveBin({
+        cwd,
+        displayName: 'Next.js',
+        packageName: 'next'
+    });
+}
+/** Resolve the project's `vite` binary — see {@link resolveBin}. */ export function resolveViteBin(cwd = process.cwd()) {
+    return resolveBin({
+        cwd,
+        displayName: 'Vite',
+        packageName: 'vite'
+    });
+}
+/**
+ * Map a detected framework to the resolved binary and argument list to spawn.
+ * Both frameworks take the `build` subcommand followed by the forwarded args.
+ */ export function resolveBuildCommand({ cwd = process.cwd(), forwardedArgs, framework }) {
+    const bin = framework === 'next' ? resolveNextBin(cwd) : resolveViteBin(cwd);
+    return {
+        args: [
+            'build',
+            ...forwardedArgs
+        ],
+        bin
+    };
+}
+function isFramework(value) {
+    return value === 'next' || value === 'tanstack-start';
+}
+function readProjectDependencies(cwd) {
+    try {
+        const pkg = JSON.parse(readFileSync(path.join(cwd, 'package.json'), 'utf8'));
+        return {
+            ...pkg.dependencies,
+            ...pkg.devDependencies
+        };
+    } catch  {
+        return {};
+    }
+}
+function buildDetectionError(signals) {
+    const conflicts = [];
+    if (signals.hasNextDep && signals.hasTanstackDep) {
+        conflicts.push('dependencies (`next` and `@tanstack/react-start`)');
+    }
+    if (signals.hasNextConfig && signals.hasViteConfig) {
+        conflicts.push('config files (next.config.* and vite.config.*)');
+    }
+    if (signals.hasNextFolder && signals.hasTanstackFolder) {
+        conflicts.push('app folders (app/(payload) and app/_payload)');
+    }
+    if (conflicts.length) {
+        return `Could not determine your framework for \`payload build\`: conflicting signals found in ${conflicts.join(', ')}. Resolve the conflict so only one framework is indicated.`;
+    }
+    return [
+        'Could not determine your framework for `payload build`.',
+        'Checked:',
+        '  • dependencies: no `next` or `@tanstack/react-start` in package.json',
+        '  • config files: no next.config.* or vite.config.*',
+        '  • app folders:  no app/(payload) or app/_payload',
+        'Install your framework (Next.js or TanStack Start) and try again.'
+    ].join('\n');
+}
+/**
+ * Resolve a framework's binary path from its own package 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`.
+ */ function resolveBin({ cwd, displayName, packageName }) {
+    const require = createRequire(path.join(cwd, 'package.json'));
+    let pkgPath;
+    try {
+        pkgPath = require.resolve(`${packageName}/package.json`);
+    } catch  {
+        throw new Error(`Could not resolve "${packageName}" from the current project. Is ${displayName} installed?`);
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    const binField = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.[packageName];
+    if (!binField) {
+        throw new Error(`Could not determine the "${packageName}" binary path from ${packageName}/package.json.`);
+    }
+    return path.join(path.dirname(pkgPath), binField);
+}
+
+//# sourceMappingURL=build.js.map