payload 4.0.0-internal.fa345ef → 4.0.0-internal.ff27d6e

package/dist/utilities/telemetry/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utilities/telemetry/index.ts"],"sourcesContent":["import { execSync } from 'child_process'\nimport ciInfo from 'ci-info'\nimport { randomBytes } from 'crypto'\nimport fs from 'fs'\nimport path from 'path'\nimport { fileURLToPath } from 'url'\n\nimport type { Payload } from '../../types/index.js'\nimport type { AdminInitEvent } from './events/adminInit.js'\nimport type { ServerInitEvent } from './events/serverInit.js'\n\nimport { findUp } from '../findUp.js'\nimport { Conf } from './conf/index.js'\nimport { oneWayHash } from './oneWayHash.js'\n\nexport type BaseEvent = {\n  ciName: null | string\n  dbAdapter: string\n  emailAdapter: null | string\n  envID: string\n  isCI: boolean\n  locales: string[]\n  localizationDefaultLocale: null | string\n  localizationEnabled: boolean\n  nodeEnv: string\n  nodeVersion: string\n  payloadVersion: string\n  projectID: string\n  projectIDSource: 'cwd' | 'git' | 'packageJSON' | 'serverURL'\n  uploadAdapters: string[]\n}\n\ntype PackageJSON = {\n  dependencies: Record<string, string | undefined>\n  name: string\n}\n\ntype TelemetryEvent = AdminInitEvent | ServerInitEvent\n\ntype Args = {\n  event: TelemetryEvent\n  payload: Payload\n}\n\nlet baseEvent: BaseEvent | null = null\n\nexport const sendEvent = async ({ event, payload }: Args): Promise<void> => {\n  try {\n    if (payload.config.telemetry !== false) {\n      const { packageJSON, packageJSONPath } = await getPackageJSON()\n\n      // Only generate the base event once\n      if (!baseEvent) {\n        const { projectID, source: projectIDSource } = getProjectID(payload, packageJSON!)\n        baseEvent = {\n          ciName: ciInfo.isCI ? ciInfo.name : null,\n          envID: getEnvID(),\n          isCI: ciInfo.isCI,\n          nodeEnv: process.env.NODE_ENV || 'development',\n          nodeVersion: process.version,\n          payloadVersion: getPayloadVersion(packageJSON!),\n          projectID,\n          projectIDSource,\n          ...getLocalizationInfo(payload),\n          dbAdapter: payload.db.name,\n          emailAdapter: payload.email?.name || null,\n          uploadAdapters: payload.config.upload.adapters,\n        }\n      }\n\n      if (process.env.PAYLOAD_TELEMETRY_DEBUG) {\n        payload.logger.info({\n          event: { ...baseEvent, ...event, packageJSONPath },\n          msg: 'Telemetry Event',\n        })\n        return\n      }\n\n      await fetch('https://telemetry.payloadcms.com/events', {\n        body: JSON.stringify({ ...baseEvent, ...event }),\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        method: 'post',\n      })\n    }\n  } catch (_) {\n    // Eat any errors in sending telemetry event\n  }\n}\n\n/**\n * This is a quasi-persistent identifier used to dedupe recurring events. It's\n * generated from random data and completely anonymous.\n */\nconst getEnvID = (): string => {\n  const conf = new Conf()\n  const ENV_ID = 'envID'\n\n  const val = conf.get(ENV_ID)\n  if (val) {\n    return val as string\n  }\n\n  const generated = randomBytes(32).toString('hex')\n  conf.set(ENV_ID, generated)\n  return generated\n}\n\nconst getProjectID = (\n  payload: Payload,\n  packageJSON: PackageJSON,\n): { projectID: string; source: BaseEvent['projectIDSource'] } => {\n  const gitID = getGitID(payload)\n  if (gitID) {\n    return { projectID: oneWayHash(gitID, payload.secret), source: 'git' }\n  }\n\n  const packageJSONID = getPackageJSONID(payload, packageJSON)\n  if (packageJSONID) {\n    return { projectID: oneWayHash(packageJSONID, payload.secret), source: 'packageJSON' }\n  }\n\n  const serverURL = payload.config.serverURL\n  if (serverURL) {\n    return { projectID: oneWayHash(serverURL, payload.secret), source: 'serverURL' }\n  }\n\n  const cwd = process.cwd()\n  return { projectID: oneWayHash(cwd, payload.secret), source: 'cwd' }\n}\n\nconst getGitID = (payload: Payload) => {\n  try {\n    const originBuffer = execSync('git config --local --get remote.origin.url', {\n      stdio: 'pipe',\n      timeout: 1000,\n    })\n\n    return oneWayHash(String(originBuffer).trim(), payload.secret)\n  } catch (_) {\n    return null\n  }\n}\n\nconst getPackageJSON = async (): Promise<{\n  packageJSON?: PackageJSON\n  packageJSONPath: string\n}> => {\n  let packageJSONPath = path.resolve(process.cwd(), 'package.json')\n\n  if (!fs.existsSync(packageJSONPath)) {\n    // Old logic\n    const filename = fileURLToPath(import.meta.url)\n    const dirname = path.dirname(filename)\n    packageJSONPath = (await findUp({\n      dir: dirname,\n      fileNames: ['package.json'],\n    }))!\n  }\n\n  const jsonContentString = await fs.promises.readFile(packageJSONPath, 'utf-8')\n  const jsonContent: PackageJSON = JSON.parse(jsonContentString)\n  return { packageJSON: jsonContent, packageJSONPath }\n}\n\nconst getPackageJSONID = (payload: Payload, packageJSON: PackageJSON): string => {\n  return oneWayHash(packageJSON.name, payload.secret)\n}\n\nexport const getPayloadVersion = (packageJSON: PackageJSON): string => {\n  return packageJSON?.dependencies?.payload ?? ''\n}\n\nexport const getLocalizationInfo = (\n  payload: Payload,\n): Pick<BaseEvent, 'locales' | 'localizationDefaultLocale' | 'localizationEnabled'> => {\n  if (!payload.config.localization) {\n    return {\n      locales: [],\n      localizationDefaultLocale: null,\n      localizationEnabled: false,\n    }\n  }\n\n  return {\n    locales: payload.config.localization.localeCodes,\n    localizationDefaultLocale: payload.config.localization.defaultLocale,\n    localizationEnabled: true,\n  }\n}\n"],"names":["execSync","ciInfo","randomBytes","fs","path","fileURLToPath","findUp","Conf","oneWayHash","baseEvent","sendEvent","event","payload","config","telemetry","packageJSON","packageJSONPath","getPackageJSON","projectID","source","projectIDSource","getProjectID","ciName","isCI","name","envID","getEnvID","nodeEnv","process","env","NODE_ENV","nodeVersion","version","payloadVersion","getPayloadVersion","getLocalizationInfo","dbAdapter","db","emailAdapter","email","uploadAdapters","upload","adapters","PAYLOAD_TELEMETRY_DEBUG","logger","info","msg","fetch","body","JSON","stringify","headers","method","_","conf","ENV_ID","val","get","generated","toString","set","gitID","getGitID","secret","packageJSONID","getPackageJSONID","serverURL","cwd","originBuffer","stdio","timeout","String","trim","resolve","existsSync","filename","url","dirname","dir","fileNames","jsonContentString","promises","readFile","jsonContent","parse","dependencies","localization","locales","localizationDefaultLocale","localizationEnabled","localeCodes","defaultLocale"],"mappings":"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"}
+{"version":3,"sources":["../../../src/utilities/telemetry/index.ts"],"sourcesContent":["import { execSync } from 'child_process'\nimport ciInfo from 'ci-info'\nimport { randomBytes } from 'crypto'\nimport fs from 'fs'\nimport path from 'path'\nimport { fileURLToPath } from 'url'\n\nimport type { Payload } from '../../types/index.js'\nimport type { AdminInitEvent } from './events/adminInit.js'\nimport type { ServerInitEvent } from './events/serverInit.js'\nimport type { FeatureInfo } from './featureInfo/types.js'\nimport type { FigmaProduct, ProjectCohort } from './getProjectContext.js'\n\nimport { findUp } from '../findUp.js'\nimport { Conf } from './conf/index.js'\nimport { getFeatureInfo } from './featureInfo/getFeatureInfo.js'\nimport { getProjectContext } from './getProjectContext.js'\nimport { oneWayHash } from './oneWayHash.js'\n\nexport type BaseEvent = {\n  ciName: null | string\n  dbAdapter: string\n  emailAdapter: null | string\n  envID: string\n  figmaProduct?: FigmaProduct\n  frameworkAdapter: 'next' | 'tanstack-start' | 'unknown'\n  isCI: boolean\n  locales: string[]\n  localizationDefaultLocale: null | string\n  localizationEnabled: boolean\n  nodeEnv: string\n  nodeVersion: string\n  payloadVersion: string\n  /** Slugs of installed first-party (`@payloadcms/`) plugins. */\n  plugins: string[]\n  projectCohorts: ProjectCohort[]\n  projectID: string\n  projectIDSource: 'cwd' | 'git' | 'packageJSON' | 'serverURL'\n  uploadAdapters: string[]\n} & FeatureInfo\n\ntype PackageJSON = {\n  dependencies: Record<string, string | undefined>\n  name: string\n}\n\ntype TelemetryEvent = AdminInitEvent | ServerInitEvent\n\ntype Args<TEvent extends { type: string } = TelemetryEvent> = {\n  event: TEvent\n  payload: Payload\n}\n\nlet baseEvent: BaseEvent | null = null\n\nexport const sendTelemetryEvent = async <TEvent extends { type: string }>({\n  event,\n  payload,\n}: Args<TEvent>): Promise<void> => {\n  try {\n    if (payload.config.telemetry !== false) {\n      const { packageJSON, packageJSONPath } = await getPackageJSON()\n\n      // Only generate the base event once\n      if (!baseEvent) {\n        const { projectID, source: projectIDSource } = getProjectID(payload, packageJSON!)\n        const plugins = getInstalledPluginSlugs(payload)\n        const packages = Object.keys(packageJSON!.dependencies ?? {})\n        baseEvent = {\n          ciName: ciInfo.isCI ? ciInfo.name : null,\n          envID: getEnvID(),\n          isCI: ciInfo.isCI,\n          nodeEnv: process.env.NODE_ENV || 'development',\n          nodeVersion: process.version,\n          payloadVersion: getPayloadVersion(packageJSON!),\n          projectID,\n          projectIDSource,\n          ...getProjectContext({\n            packages,\n            payload,\n            plugins,\n          }),\n          frameworkAdapter: getFrameworkAdapter(packages),\n          ...getFeatureInfo(payload.config),\n          ...getLocalizationInfo(payload),\n          dbAdapter: payload.db.name,\n          emailAdapter: payload.email?.name || null,\n          plugins,\n          uploadAdapters: payload.config.upload.adapters,\n        }\n      }\n\n      if (process.env.PAYLOAD_TELEMETRY_DEBUG) {\n        payload.logger.info({\n          event: { ...baseEvent, ...event, packageJSONPath },\n          msg: 'Telemetry Event',\n        })\n        return\n      }\n\n      await fetch('https://telemetry.payloadcms.com/events', {\n        body: JSON.stringify({ ...baseEvent, ...event }),\n        headers: {\n          'Content-Type': 'application/json',\n        },\n        method: 'post',\n      })\n    }\n  } catch (_) {\n    // Eat any errors in sending telemetry event\n  }\n}\n\n/**\n * This is a quasi-persistent identifier used to dedupe recurring events. It's\n * generated from random data and completely anonymous.\n */\nconst getEnvID = (): string => {\n  const conf = new Conf()\n  const ENV_ID = 'envID'\n\n  const val = conf.get(ENV_ID)\n  if (val) {\n    return val as string\n  }\n\n  const generated = randomBytes(32).toString('hex')\n  conf.set(ENV_ID, generated)\n  return generated\n}\n\nconst getProjectID = (\n  payload: Payload,\n  packageJSON: PackageJSON,\n): { projectID: string; source: BaseEvent['projectIDSource'] } => {\n  const gitID = getGitID(payload)\n  if (gitID) {\n    return { projectID: oneWayHash(gitID, payload.secret), source: 'git' }\n  }\n\n  const packageJSONID = getPackageJSONID(payload, packageJSON)\n  if (packageJSONID) {\n    return { projectID: oneWayHash(packageJSONID, payload.secret), source: 'packageJSON' }\n  }\n\n  const serverURL = payload.config.serverURL\n  if (serverURL) {\n    return { projectID: oneWayHash(serverURL, payload.secret), source: 'serverURL' }\n  }\n\n  const cwd = process.cwd()\n  return { projectID: oneWayHash(cwd, payload.secret), source: 'cwd' }\n}\n\nconst getGitID = (payload: Payload) => {\n  try {\n    const originBuffer = execSync('git config --local --get remote.origin.url', {\n      stdio: 'pipe',\n      timeout: 1000,\n    })\n\n    return oneWayHash(String(originBuffer).trim(), payload.secret)\n  } catch (_) {\n    return null\n  }\n}\n\nconst getPackageJSON = async (): Promise<{\n  packageJSON?: PackageJSON\n  packageJSONPath: string\n}> => {\n  let packageJSONPath = path.resolve(process.cwd(), 'package.json')\n\n  if (!fs.existsSync(packageJSONPath)) {\n    // Old logic\n    const filename = fileURLToPath(import.meta.url)\n    const dirname = path.dirname(filename)\n    packageJSONPath = (await findUp({\n      dir: dirname,\n      fileNames: ['package.json'],\n    }))!\n  }\n\n  const jsonContentString = await fs.promises.readFile(packageJSONPath, 'utf-8')\n  const jsonContent: PackageJSON = JSON.parse(jsonContentString)\n  return { packageJSON: jsonContent, packageJSONPath }\n}\n\nconst getPackageJSONID = (payload: Payload, packageJSON: PackageJSON): string => {\n  return oneWayHash(packageJSON.name, payload.secret)\n}\n\nexport const getPayloadVersion = (packageJSON: PackageJSON): string => {\n  return packageJSON?.dependencies?.payload ?? ''\n}\n\nconst getFrameworkAdapter = (packages: string[]): 'next' | 'tanstack-start' | 'unknown' => {\n  if (packages.includes('@payloadcms/tanstack-start')) {\n    return 'tanstack-start'\n  }\n\n  if (packages.includes('@payloadcms/next')) {\n    return 'next'\n  }\n\n  return 'unknown'\n}\n\n/**\n * Slugs of installed first-party (`@payloadcms/`) plugins. Custom plugin slugs\n * are author-defined and can leak project details, so they are never collected.\n */\nexport const getInstalledPluginSlugs = (payload: Payload): string[] =>\n  (payload.config.plugins ?? [])\n    .map((plugin) => plugin.slug)\n    .filter((slug): slug is string => typeof slug === 'string' && slug.startsWith('@payloadcms/'))\n\nexport const getLocalizationInfo = (\n  payload: Payload,\n): Pick<BaseEvent, 'locales' | 'localizationDefaultLocale' | 'localizationEnabled'> => {\n  if (!payload.config.localization) {\n    return {\n      locales: [],\n      localizationDefaultLocale: null,\n      localizationEnabled: false,\n    }\n  }\n\n  return {\n    locales: payload.config.localization.localeCodes,\n    localizationDefaultLocale: payload.config.localization.defaultLocale,\n    localizationEnabled: true,\n  }\n}\n"],"names":["execSync","ciInfo","randomBytes","fs","path","fileURLToPath","findUp","Conf","getFeatureInfo","getProjectContext","oneWayHash","baseEvent","sendTelemetryEvent","event","payload","config","telemetry","packageJSON","packageJSONPath","getPackageJSON","projectID","source","projectIDSource","getProjectID","plugins","getInstalledPluginSlugs","packages","Object","keys","dependencies","ciName","isCI","name","envID","getEnvID","nodeEnv","process","env","NODE_ENV","nodeVersion","version","payloadVersion","getPayloadVersion","frameworkAdapter","getFrameworkAdapter","getLocalizationInfo","dbAdapter","db","emailAdapter","email","uploadAdapters","upload","adapters","PAYLOAD_TELEMETRY_DEBUG","logger","info","msg","fetch","body","JSON","stringify","headers","method","_","conf","ENV_ID","val","get","generated","toString","set","gitID","getGitID","secret","packageJSONID","getPackageJSONID","serverURL","cwd","originBuffer","stdio","timeout","String","trim","resolve","existsSync","filename","url","dirname","dir","fileNames","jsonContentString","promises","readFile","jsonContent","parse","includes","map","plugin","slug","filter","startsWith","localization","locales","localizationDefaultLocale","localizationEnabled","localeCodes","defaultLocale"],"mappings":"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"}

package/dist/utilities/telemetry/oneWayHash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oneWayHash.d.ts","sourceRoot":"","sources":["../../../src/utilities/telemetry/oneWayHash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAIxC,eAAO,MAAM,UAAU,GAAI,MAAM,UAAU,EAAE,QAAQ,MAAM,KAAG,MAU7D,CAAA"}
+{"version":3,"file":"oneWayHash.d.ts","sourceRoot":"","sources":["../../../src/utilities/telemetry/oneWayHash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAIxC,eAAO,MAAM,UAAU,SAAU,UAAU,UAAU,MAAM,KAAG,MAU7D,CAAA"}

package/dist/utilities/timestamp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../src/utilities/timestamp.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,SAMtC,CAAA"}
+{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../src/utilities/timestamp.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,UAAW,MAAM,SAMtC,CAAA"}

package/dist/utilities/toKebabCase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toKebabCase.d.ts","sourceRoot":"","sources":["../../src/utilities/toKebabCase.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,uBAIzB,CAAA"}
+{"version":3,"file":"toKebabCase.d.ts","sourceRoot":"","sources":["../../src/utilities/toKebabCase.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,YAAa,MAAM,uBAIzB,CAAA"}

package/dist/utilities/toValidationResult.d.ts

@@ -0,0 +1,13 @@
+import type { PayloadRequest } from '../types/index.js';
+import type { ValidationResult } from '../types/validation.js';
+/**
+ * Maps a caught `ValidationError` to a `ValidationResult`, tagging each field error with the
+ * request's locale. Rethrows any other error, since only field validation failures are part of
+ * the validate operation's contract. Meant to be called from a `catch` block around the
+ * `beforeValidate`/`beforeChange` hook sequence.
+ */
+export declare function toValidationResult({ error, req, }: {
+    error: unknown;
+    req: PayloadRequest;
+}): ValidationResult;
+//# sourceMappingURL=toValidationResult.d.ts.map

package/dist/utilities/toValidationResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toValidationResult.d.ts","sourceRoot":"","sources":["../../src/utilities/toValidationResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAI9D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,GAAG,GACJ,EAAE;IACD,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,cAAc,CAAA;CACpB,GAAG,gBAAgB,CAYnB"}

package/dist/utilities/toValidationResult.js

@@ -0,0 +1,20 @@
+import { ValidationError } from '../errors/index.js';
+/**
+ * Maps a caught `ValidationError` to a `ValidationResult`, tagging each field error with the
+ * request's locale. Rethrows any other error, since only field validation failures are part of
+ * the validate operation's contract. Meant to be called from a `catch` block around the
+ * `beforeValidate`/`beforeChange` hook sequence.
+ */ export function toValidationResult({ error, req }) {
+    if (!(error instanceof ValidationError)) {
+        throw error;
+    }
+    return {
+        errors: error.data.errors.map((validationError)=>({
+                ...validationError,
+                locale: req.locale ?? undefined
+            })),
+        valid: false
+    };
+}
+
+//# sourceMappingURL=toValidationResult.js.map

package/dist/utilities/toValidationResult.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/toValidationResult.ts"],"sourcesContent":["import type { PayloadRequest } from '../types/index.js'\nimport type { ValidationResult } from '../types/validation.js'\n\nimport { ValidationError } from '../errors/index.js'\n\n/**\n * Maps a caught `ValidationError` to a `ValidationResult`, tagging each field error with the\n * request's locale. Rethrows any other error, since only field validation failures are part of\n * the validate operation's contract. Meant to be called from a `catch` block around the\n * `beforeValidate`/`beforeChange` hook sequence.\n */\nexport function toValidationResult({\n  error,\n  req,\n}: {\n  error: unknown\n  req: PayloadRequest\n}): ValidationResult {\n  if (!(error instanceof ValidationError)) {\n    throw error\n  }\n\n  return {\n    errors: error.data.errors.map((validationError) => ({\n      ...validationError,\n      locale: req.locale ?? undefined,\n    })),\n    valid: false,\n  }\n}\n"],"names":["ValidationError","toValidationResult","error","req","errors","data","map","validationError","locale","undefined","valid"],"mappings":"AAGA,SAASA,eAAe,QAAQ,qBAAoB;AAEpD;;;;;CAKC,GACD,OAAO,SAASC,mBAAmB,EACjCC,KAAK,EACLC,GAAG,EAIJ;IACC,IAAI,CAAED,CAAAA,iBAAiBF,eAAc,GAAI;QACvC,MAAME;IACR;IAEA,OAAO;QACLE,QAAQF,MAAMG,IAAI,CAACD,MAAM,CAACE,GAAG,CAAC,CAACC,kBAAqB,CAAA;gBAClD,GAAGA,eAAe;gBAClBC,QAAQL,IAAIK,MAAM,IAAIC;YACxB,CAAA;QACAC,OAAO;IACT;AACF"}

package/dist/utilities/transactionCallbacks.d.ts

@@ -0,0 +1,77 @@
+import type { MarkRequired } from 'ts-essentials';
+import type { PayloadRequest } from '../types/index.js';
+type TransactionCallback = () => Promise<void>;
+type TransactionCallbackEntry = {
+    callback: TransactionCallback;
+    sequence: number;
+};
+type TransactionID = number | string;
+export type DeferredCleanupScope = {
+    callbacks: TransactionCallbackEntry[];
+    database: object;
+    parent: DeferredCleanupScope | null;
+    state: 'closed' | 'collecting' | 'flushing';
+    transactionID?: TransactionID;
+};
+export declare const deferredCleanupScopeContextKey = "_payloadDeferredCleanupScope";
+/** Creates a request context whose cleanup callbacks can be managed independently. */
+export declare const createIsolatedDeferredCleanupContext: ({ req, }: {
+    req: Partial<PayloadRequest>;
+}) => PayloadRequest['context'];
+export declare const hasActiveDeferredCleanupScope: ({ req }: {
+    req: Partial<PayloadRequest>;
+}) => boolean;
+/**
+ * Creates an operation-owned cleanup queue. Successful nested scopes transfer their cleanup to a
+ * parent for the same database and transaction. Root transaction scopes transfer their cleanup to
+ * the transaction queue. Failed scopes can therefore discard only the cleanup they still own.
+ */
+export declare const beginDeferredCleanupScope: ({ req, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+}) => Promise<DeferredCleanupScope>;
+/** Reuses an operation scope when a low-level cleanup helper does not need its own savepoint. */
+export declare const beginDeferredCleanupScopeIfNeeded: ({ req, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+}) => Promise<DeferredCleanupScope | null>;
+export declare const scheduleAfterTransactionCommit: ({ callback, req, }: {
+    callback: TransactionCallback;
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+}) => Promise<void>;
+export declare const scheduleAfterTransactionRollback: ({ callback, req, }: {
+    callback: TransactionCallback;
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+}) => Promise<void>;
+export declare const runTransactionCommitCallbacks: ({ req, transactionID, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+    transactionID: TransactionID;
+}) => Promise<void>;
+export declare const clearTransactionCommitCallbacks: ({ req, transactionID, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+    transactionID: TransactionID;
+}) => void;
+export declare const runTransactionRollbackCallbacks: ({ req, transactionID, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+    transactionID: TransactionID;
+}) => Promise<void>;
+export declare const clearTransactionRollbackCallbacks: ({ req, transactionID, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+    transactionID: TransactionID;
+}) => void;
+export declare const flushDeferredCleanupScope: ({ req, scope, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+    scope: DeferredCleanupScope;
+}) => Promise<void>;
+/**
+ * Flushes cleanup after an operation's database work has completed. A cleanup failure cannot undo
+ * that write, so report it with the same contract used after a committed transaction.
+ */
+export declare const flushDeferredCleanupScopeAfterOperation: ({ req, scope, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+    scope: DeferredCleanupScope;
+}) => Promise<void>;
+export declare const clearDeferredCleanupScope: ({ req, scope, }: {
+    req: MarkRequired<Partial<PayloadRequest>, 'payload'>;
+    scope: DeferredCleanupScope;
+}) => void;
+export {};
+//# sourceMappingURL=transactionCallbacks.d.ts.map

package/dist/utilities/transactionCallbacks.d.ts.map

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

package/dist/utilities/transactionCallbacks.js

@@ -0,0 +1,299 @@
+const callbacksByDatabase = new WeakMap();
+const rollbackCallbacksByDatabase = new WeakMap();
+export const deferredCleanupScopeContextKey = '_payloadDeferredCleanupScope';
+let nextTransactionCallbackSequence = 0;
+/** Creates a request context whose cleanup callbacks can be managed independently. */ export const createIsolatedDeferredCleanupContext = ({ req })=>{
+    const sourceContext = req.context ?? {};
+    const context = {};
+    for (const key of Reflect.ownKeys(sourceContext)){
+        if (key === deferredCleanupScopeContextKey) {
+            continue;
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(sourceContext, key);
+        if (descriptor?.enumerable) {
+            Object.defineProperty(context, key, descriptor);
+        }
+    }
+    return context;
+};
+export const hasActiveDeferredCleanupScope = ({ req })=>Boolean(req.context?.[deferredCleanupScopeContextKey]);
+/**
+ * Creates an operation-owned cleanup queue. Successful nested scopes transfer their cleanup to a
+ * parent for the same database and transaction. Root transaction scopes transfer their cleanup to
+ * the transaction queue. Failed scopes can therefore discard only the cleanup they still own.
+ */ export const beginDeferredCleanupScope = async ({ req })=>{
+    const transactionID = await resolveTransactionID({
+        req
+    });
+    return createDeferredCleanupScope({
+        req,
+        transactionID
+    });
+};
+/** Reuses an operation scope when a low-level cleanup helper does not need its own savepoint. */ export const beginDeferredCleanupScopeIfNeeded = async ({ req })=>{
+    const transactionID = await resolveTransactionID({
+        req
+    });
+    const activeScope = req.context?.[deferredCleanupScopeContextKey];
+    if (activeScope?.database === req.payload.db && activeScope.transactionID === (transactionID || undefined)) {
+        return null;
+    }
+    return createDeferredCleanupScope({
+        req,
+        transactionID
+    });
+};
+const createDeferredCleanupScope = ({ req, transactionID })=>{
+    req.context ??= {};
+    const parent = req.context[deferredCleanupScopeContextKey] ?? null;
+    const scope = {
+        callbacks: [],
+        database: req.payload.db,
+        parent,
+        state: 'collecting',
+        transactionID: transactionID ?? undefined
+    };
+    req.context[deferredCleanupScopeContextKey] = scope;
+    return scope;
+};
+const resolveTransactionID = async ({ req })=>req.transactionID instanceof Promise ? await req.transactionID : req.transactionID;
+export const scheduleAfterTransactionCommit = async ({ callback, req })=>{
+    const pendingTransactionID = req.transactionID;
+    const transactionID = pendingTransactionID instanceof Promise ? await pendingTransactionID : pendingTransactionID;
+    const scope = req.context?.[deferredCleanupScopeContextKey];
+    const callbackEntry = {
+        callback,
+        sequence: nextTransactionCallbackSequence++
+    };
+    if (scope?.database === req.payload.db && scope.transactionID === (transactionID ?? undefined)) {
+        if (scope.state === 'flushing') {
+            await callback();
+        } else {
+            scope.callbacks.push(callbackEntry);
+        }
+        return;
+    }
+    if (!transactionID) {
+        if (req.transactionID === pendingTransactionID) {
+            delete req.transactionID;
+        }
+        throw new Error('File cleanup requires an active transaction or deferred cleanup scope.');
+    }
+    getTransactionCallbacks({
+        database: req.payload.db,
+        transactionID
+    }).push(callbackEntry);
+};
+export const scheduleAfterTransactionRollback = async ({ callback, req })=>{
+    const pendingTransactionID = req.transactionID;
+    const transactionID = pendingTransactionID instanceof Promise ? await pendingTransactionID : pendingTransactionID;
+    if (!transactionID) {
+        throw new Error('Rollback callbacks require an active transaction.');
+    }
+    getRollbackCallbacks({
+        database: req.payload.db,
+        transactionID
+    }).push({
+        callback,
+        sequence: nextTransactionCallbackSequence++
+    });
+};
+export const runTransactionCommitCallbacks = async ({ req, transactionID })=>{
+    const callbacksByTransaction = callbacksByDatabase.get(req.payload.db);
+    const callbacks = callbacksByTransaction?.get(transactionID) ?? [];
+    const scopedCallbacks = closeTransactionScopes({
+        req,
+        transactionID
+    });
+    callbacksByTransaction?.delete(transactionID);
+    if (callbacksByTransaction?.size === 0) {
+        callbacksByDatabase.delete(req.payload.db);
+    }
+    if (callbacks.length === 0 && scopedCallbacks.length === 0) {
+        return;
+    }
+    await runCallbacks({
+        callbacks: [
+            ...callbacks,
+            ...scopedCallbacks
+        ]
+    });
+};
+export const clearTransactionCommitCallbacks = ({ req, transactionID })=>{
+    const callbacksByTransaction = callbacksByDatabase.get(req.payload.db);
+    closeTransactionScopes({
+        req,
+        transactionID
+    });
+    callbacksByTransaction?.delete(transactionID);
+    if (callbacksByTransaction?.size === 0) {
+        callbacksByDatabase.delete(req.payload.db);
+    }
+};
+export const runTransactionRollbackCallbacks = async ({ req, transactionID })=>{
+    const callbacksByTransaction = rollbackCallbacksByDatabase.get(req.payload.db);
+    const callbacks = callbacksByTransaction?.get(transactionID);
+    if (!callbacks) {
+        return;
+    }
+    callbacksByTransaction.delete(transactionID);
+    if (callbacksByTransaction.size === 0) {
+        rollbackCallbacksByDatabase.delete(req.payload.db);
+    }
+    await runCallbacks({
+        callbacks
+    });
+};
+export const clearTransactionRollbackCallbacks = ({ req, transactionID })=>{
+    const callbacksByTransaction = rollbackCallbacksByDatabase.get(req.payload.db);
+    callbacksByTransaction?.delete(transactionID);
+    if (callbacksByTransaction?.size === 0) {
+        rollbackCallbacksByDatabase.delete(req.payload.db);
+    }
+};
+export const flushDeferredCleanupScope = async ({ req, scope })=>{
+    if (scope.state === 'closed') {
+        return;
+    }
+    assertDeferredCleanupScopeIsActive({
+        req,
+        scope
+    });
+    if (scope.parent?.database === scope.database && scope.parent.transactionID === scope.transactionID) {
+        scope.parent.callbacks.push(...scope.callbacks);
+        scope.callbacks.length = 0;
+        popScope({
+            req,
+            scope
+        });
+        return;
+    }
+    if (scope.transactionID !== undefined) {
+        if (scope.callbacks.length > 0) {
+            getTransactionCallbacks({
+                database: scope.database,
+                transactionID: scope.transactionID
+            }).push(...scope.callbacks);
+        }
+        scope.callbacks.length = 0;
+        popScope({
+            req,
+            scope
+        });
+        return;
+    }
+    scope.state = 'flushing';
+    const callbacks = scope.callbacks.splice(0);
+    try {
+        await runCallbacks({
+            callbacks
+        });
+    } finally{
+        popScope({
+            req,
+            scope
+        });
+    }
+};
+/**
+ * Flushes cleanup after an operation's database work has completed. A cleanup failure cannot undo
+ * that write, so report it with the same contract used after a committed transaction.
+ */ export const flushDeferredCleanupScopeAfterOperation = async ({ req, scope })=>{
+    if (scope.state !== 'closed') {
+        assertDeferredCleanupScopeIsActive({
+            req,
+            scope
+        });
+    }
+    try {
+        await flushDeferredCleanupScope({
+            req,
+            scope
+        });
+    } catch (err) {
+        req.payload.logger.error({
+            err,
+            msg: 'A post-commit cleanup task failed.'
+        });
+    }
+};
+export const clearDeferredCleanupScope = ({ req, scope })=>{
+    if (scope.state === 'closed') {
+        return;
+    }
+    assertDeferredCleanupScopeIsActive({
+        req,
+        scope
+    });
+    scope.callbacks.length = 0;
+    popScope({
+        req,
+        scope
+    });
+};
+const assertDeferredCleanupScopeIsActive = ({ req, scope })=>{
+    if (req.context?.[deferredCleanupScopeContextKey] !== scope) {
+        throw new Error('The deferred cleanup scope is no longer active.');
+    }
+};
+const getTransactionCallbacks = ({ database, transactionID })=>{
+    const callbacksByTransaction = callbacksByDatabase.get(database) ?? new Map();
+    const callbacks = callbacksByTransaction.get(transactionID) ?? [];
+    callbacksByTransaction.set(transactionID, callbacks);
+    callbacksByDatabase.set(database, callbacksByTransaction);
+    return callbacks;
+};
+const getRollbackCallbacks = ({ database, transactionID })=>{
+    const callbacksByTransaction = rollbackCallbacksByDatabase.get(database) ?? new Map();
+    const callbacks = callbacksByTransaction.get(transactionID) ?? [];
+    callbacksByTransaction.set(transactionID, callbacks);
+    rollbackCallbacksByDatabase.set(database, callbacksByTransaction);
+    return callbacks;
+};
+const popScope = ({ req, scope })=>{
+    if (req.context?.[deferredCleanupScopeContextKey] !== scope) {
+        return;
+    }
+    if (scope.parent) {
+        req.context[deferredCleanupScopeContextKey] = scope.parent;
+    } else {
+        delete req.context[deferredCleanupScopeContextKey];
+    }
+    scope.state = 'closed';
+};
+const closeTransactionScopes = ({ req, transactionID })=>{
+    const scope = req.context?.[deferredCleanupScopeContextKey];
+    if (!scope || scope.transactionID !== transactionID) {
+        return [];
+    }
+    const callbacks = scope.callbacks.splice(0);
+    popScope({
+        req,
+        scope
+    });
+    return [
+        ...closeTransactionScopes({
+            req,
+            transactionID
+        }),
+        ...callbacks
+    ];
+};
+const runCallbacks = async ({ callbacks })=>{
+    const errors = [];
+    for (const { callback } of callbacks.sort((a, b)=>a.sequence - b.sequence)){
+        try {
+            await callback();
+        } catch (error) {
+            errors.push(error);
+        }
+    }
+    if (errors.length === 1) {
+        throw errors[0];
+    }
+    if (errors.length > 1) {
+        throw new AggregateError(errors, 'Multiple deferred cleanup callbacks failed.');
+    }
+};
+
+//# sourceMappingURL=transactionCallbacks.js.map

package/dist/utilities/transactionCallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/transactionCallbacks.ts"],"sourcesContent":["import type { MarkRequired } from 'ts-essentials'\n\nimport type { PayloadRequest } from '../types/index.js'\n\ntype TransactionCallback = () => Promise<void>\ntype TransactionCallbackEntry = {\n  callback: TransactionCallback\n  sequence: number\n}\ntype TransactionID = number | string\nexport type DeferredCleanupScope = {\n  callbacks: TransactionCallbackEntry[]\n  database: object\n  parent: DeferredCleanupScope | null\n  state: 'closed' | 'collecting' | 'flushing'\n  transactionID?: TransactionID\n}\n\nconst callbacksByDatabase = new WeakMap<object, Map<TransactionID, TransactionCallbackEntry[]>>()\nconst rollbackCallbacksByDatabase = new WeakMap<\n  object,\n  Map<TransactionID, TransactionCallbackEntry[]>\n>()\nexport const deferredCleanupScopeContextKey = '_payloadDeferredCleanupScope'\nlet nextTransactionCallbackSequence = 0\n\n/** Creates a request context whose cleanup callbacks can be managed independently. */\nexport const createIsolatedDeferredCleanupContext = ({\n  req,\n}: {\n  req: Partial<PayloadRequest>\n}): PayloadRequest['context'] => {\n  const sourceContext = req.context ?? {}\n  const context: PayloadRequest['context'] = {}\n\n  for (const key of Reflect.ownKeys(sourceContext)) {\n    if (key === deferredCleanupScopeContextKey) {\n      continue\n    }\n\n    const descriptor = Object.getOwnPropertyDescriptor(sourceContext, key)\n\n    if (descriptor?.enumerable) {\n      Object.defineProperty(context, key, descriptor)\n    }\n  }\n\n  return context\n}\n\nexport const hasActiveDeferredCleanupScope = ({ req }: { req: Partial<PayloadRequest> }): boolean =>\n  Boolean(req.context?.[deferredCleanupScopeContextKey])\n\n/**\n * Creates an operation-owned cleanup queue. Successful nested scopes transfer their cleanup to a\n * parent for the same database and transaction. Root transaction scopes transfer their cleanup to\n * the transaction queue. Failed scopes can therefore discard only the cleanup they still own.\n */\nexport const beginDeferredCleanupScope = async ({\n  req,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n}): Promise<DeferredCleanupScope> => {\n  const transactionID = await resolveTransactionID({ req })\n\n  return createDeferredCleanupScope({ req, transactionID })\n}\n\n/** Reuses an operation scope when a low-level cleanup helper does not need its own savepoint. */\nexport const beginDeferredCleanupScopeIfNeeded = async ({\n  req,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n}): Promise<DeferredCleanupScope | null> => {\n  const transactionID = await resolveTransactionID({ req })\n  const activeScope = req.context?.[deferredCleanupScopeContextKey] as\n    | DeferredCleanupScope\n    | undefined\n\n  if (\n    activeScope?.database === req.payload.db &&\n    activeScope.transactionID === (transactionID || undefined)\n  ) {\n    return null\n  }\n\n  return createDeferredCleanupScope({ req, transactionID })\n}\n\nconst createDeferredCleanupScope = ({\n  req,\n  transactionID,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  transactionID?: TransactionID\n}): DeferredCleanupScope => {\n  req.context ??= {}\n  const parent = (req.context[deferredCleanupScopeContextKey] as DeferredCleanupScope) ?? null\n  const scope: DeferredCleanupScope = {\n    callbacks: [],\n    database: req.payload.db,\n    parent,\n    state: 'collecting',\n    transactionID: transactionID ?? undefined,\n  }\n\n  req.context[deferredCleanupScopeContextKey] = scope\n\n  return scope\n}\n\nconst resolveTransactionID = async ({\n  req,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n}): Promise<TransactionID | undefined> =>\n  req.transactionID instanceof Promise ? await req.transactionID : req.transactionID\n\nexport const scheduleAfterTransactionCommit = async ({\n  callback,\n  req,\n}: {\n  callback: TransactionCallback\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n}): Promise<void> => {\n  const pendingTransactionID = req.transactionID\n  const transactionID =\n    pendingTransactionID instanceof Promise ? await pendingTransactionID : pendingTransactionID\n  const scope = req.context?.[deferredCleanupScopeContextKey] as DeferredCleanupScope | undefined\n  const callbackEntry = {\n    callback,\n    sequence: nextTransactionCallbackSequence++,\n  }\n\n  if (scope?.database === req.payload.db && scope.transactionID === (transactionID ?? undefined)) {\n    if (scope.state === 'flushing') {\n      await callback()\n    } else {\n      scope.callbacks.push(callbackEntry)\n    }\n\n    return\n  }\n\n  if (!transactionID) {\n    if (req.transactionID === pendingTransactionID) {\n      delete req.transactionID\n    }\n\n    throw new Error('File cleanup requires an active transaction or deferred cleanup scope.')\n  }\n\n  getTransactionCallbacks({ database: req.payload.db, transactionID }).push(callbackEntry)\n}\n\nexport const scheduleAfterTransactionRollback = async ({\n  callback,\n  req,\n}: {\n  callback: TransactionCallback\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n}): Promise<void> => {\n  const pendingTransactionID = req.transactionID\n  const transactionID =\n    pendingTransactionID instanceof Promise ? await pendingTransactionID : pendingTransactionID\n\n  if (!transactionID) {\n    throw new Error('Rollback callbacks require an active transaction.')\n  }\n\n  getRollbackCallbacks({ database: req.payload.db, transactionID }).push({\n    callback,\n    sequence: nextTransactionCallbackSequence++,\n  })\n}\n\nexport const runTransactionCommitCallbacks = async ({\n  req,\n  transactionID,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  transactionID: TransactionID\n}): Promise<void> => {\n  const callbacksByTransaction = callbacksByDatabase.get(req.payload.db)\n  const callbacks = callbacksByTransaction?.get(transactionID) ?? []\n  const scopedCallbacks = closeTransactionScopes({ req, transactionID })\n\n  callbacksByTransaction?.delete(transactionID)\n\n  if (callbacksByTransaction?.size === 0) {\n    callbacksByDatabase.delete(req.payload.db)\n  }\n\n  if (callbacks.length === 0 && scopedCallbacks.length === 0) {\n    return\n  }\n\n  await runCallbacks({ callbacks: [...callbacks, ...scopedCallbacks] })\n}\n\nexport const clearTransactionCommitCallbacks = ({\n  req,\n  transactionID,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  transactionID: TransactionID\n}): void => {\n  const callbacksByTransaction = callbacksByDatabase.get(req.payload.db)\n\n  closeTransactionScopes({ req, transactionID })\n  callbacksByTransaction?.delete(transactionID)\n\n  if (callbacksByTransaction?.size === 0) {\n    callbacksByDatabase.delete(req.payload.db)\n  }\n}\n\nexport const runTransactionRollbackCallbacks = async ({\n  req,\n  transactionID,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  transactionID: TransactionID\n}): Promise<void> => {\n  const callbacksByTransaction = rollbackCallbacksByDatabase.get(req.payload.db)\n  const callbacks = callbacksByTransaction?.get(transactionID)\n\n  if (!callbacks) {\n    return\n  }\n\n  callbacksByTransaction!.delete(transactionID)\n\n  if (callbacksByTransaction!.size === 0) {\n    rollbackCallbacksByDatabase.delete(req.payload.db)\n  }\n\n  await runCallbacks({ callbacks })\n}\n\nexport const clearTransactionRollbackCallbacks = ({\n  req,\n  transactionID,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  transactionID: TransactionID\n}): void => {\n  const callbacksByTransaction = rollbackCallbacksByDatabase.get(req.payload.db)\n\n  callbacksByTransaction?.delete(transactionID)\n\n  if (callbacksByTransaction?.size === 0) {\n    rollbackCallbacksByDatabase.delete(req.payload.db)\n  }\n}\n\nexport const flushDeferredCleanupScope = async ({\n  req,\n  scope,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  scope: DeferredCleanupScope\n}): Promise<void> => {\n  if (scope.state === 'closed') {\n    return\n  }\n\n  assertDeferredCleanupScopeIsActive({ req, scope })\n\n  if (\n    scope.parent?.database === scope.database &&\n    scope.parent.transactionID === scope.transactionID\n  ) {\n    scope.parent.callbacks.push(...scope.callbacks)\n    scope.callbacks.length = 0\n    popScope({ req, scope })\n    return\n  }\n\n  if (scope.transactionID !== undefined) {\n    if (scope.callbacks.length > 0) {\n      getTransactionCallbacks({\n        database: scope.database,\n        transactionID: scope.transactionID,\n      }).push(...scope.callbacks)\n    }\n    scope.callbacks.length = 0\n    popScope({ req, scope })\n    return\n  }\n\n  scope.state = 'flushing'\n  const callbacks = scope.callbacks.splice(0)\n\n  try {\n    await runCallbacks({ callbacks })\n  } finally {\n    popScope({ req, scope })\n  }\n}\n\n/**\n * Flushes cleanup after an operation's database work has completed. A cleanup failure cannot undo\n * that write, so report it with the same contract used after a committed transaction.\n */\nexport const flushDeferredCleanupScopeAfterOperation = async ({\n  req,\n  scope,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  scope: DeferredCleanupScope\n}): Promise<void> => {\n  if (scope.state !== 'closed') {\n    assertDeferredCleanupScopeIsActive({ req, scope })\n  }\n\n  try {\n    await flushDeferredCleanupScope({ req, scope })\n  } catch (err) {\n    req.payload.logger.error({ err, msg: 'A post-commit cleanup task failed.' })\n  }\n}\n\nexport const clearDeferredCleanupScope = ({\n  req,\n  scope,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  scope: DeferredCleanupScope\n}): void => {\n  if (scope.state === 'closed') {\n    return\n  }\n\n  assertDeferredCleanupScopeIsActive({ req, scope })\n  scope.callbacks.length = 0\n  popScope({ req, scope })\n}\n\nconst assertDeferredCleanupScopeIsActive = ({\n  req,\n  scope,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  scope: DeferredCleanupScope\n}): void => {\n  if (req.context?.[deferredCleanupScopeContextKey] !== scope) {\n    throw new Error('The deferred cleanup scope is no longer active.')\n  }\n}\n\nconst getTransactionCallbacks = ({\n  database,\n  transactionID,\n}: {\n  database: object\n  transactionID: TransactionID\n}): TransactionCallbackEntry[] => {\n  const callbacksByTransaction = callbacksByDatabase.get(database) ?? new Map()\n  const callbacks = callbacksByTransaction.get(transactionID) ?? []\n\n  callbacksByTransaction.set(transactionID, callbacks)\n  callbacksByDatabase.set(database, callbacksByTransaction)\n\n  return callbacks\n}\n\nconst getRollbackCallbacks = ({\n  database,\n  transactionID,\n}: {\n  database: object\n  transactionID: TransactionID\n}): TransactionCallbackEntry[] => {\n  const callbacksByTransaction = rollbackCallbacksByDatabase.get(database) ?? new Map()\n  const callbacks = callbacksByTransaction.get(transactionID) ?? []\n\n  callbacksByTransaction.set(transactionID, callbacks)\n  rollbackCallbacksByDatabase.set(database, callbacksByTransaction)\n\n  return callbacks\n}\nconst popScope = ({\n  req,\n  scope,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  scope: DeferredCleanupScope\n}): void => {\n  if (req.context?.[deferredCleanupScopeContextKey] !== scope) {\n    return\n  }\n\n  if (scope.parent) {\n    req.context[deferredCleanupScopeContextKey] = scope.parent\n  } else {\n    delete req.context[deferredCleanupScopeContextKey]\n  }\n\n  scope.state = 'closed'\n}\n\nconst closeTransactionScopes = ({\n  req,\n  transactionID,\n}: {\n  req: MarkRequired<Partial<PayloadRequest>, 'payload'>\n  transactionID: TransactionID\n}): TransactionCallbackEntry[] => {\n  const scope = req.context?.[deferredCleanupScopeContextKey] as DeferredCleanupScope | undefined\n\n  if (!scope || scope.transactionID !== transactionID) {\n    return []\n  }\n\n  const callbacks = scope.callbacks.splice(0)\n\n  popScope({ req, scope })\n\n  return [...closeTransactionScopes({ req, transactionID }), ...callbacks]\n}\n\nconst runCallbacks = async ({\n  callbacks,\n}: {\n  callbacks: TransactionCallbackEntry[]\n}): Promise<void> => {\n  const errors: unknown[] = []\n\n  for (const { callback } of callbacks.sort((a, b) => a.sequence - b.sequence)) {\n    try {\n      await callback()\n    } catch (error) {\n      errors.push(error)\n    }\n  }\n\n  if (errors.length === 1) {\n    throw errors[0]\n  }\n\n  if (errors.length > 1) {\n    throw new AggregateError(errors, 'Multiple deferred cleanup callbacks failed.')\n  }\n}\n"],"names":["callbacksByDatabase","WeakMap","rollbackCallbacksByDatabase","deferredCleanupScopeContextKey","nextTransactionCallbackSequence","createIsolatedDeferredCleanupContext","req","sourceContext","context","key","Reflect","ownKeys","descriptor","Object","getOwnPropertyDescriptor","enumerable","defineProperty","hasActiveDeferredCleanupScope","Boolean","beginDeferredCleanupScope","transactionID","resolveTransactionID","createDeferredCleanupScope","beginDeferredCleanupScopeIfNeeded","activeScope","database","payload","db","undefined","parent","scope","callbacks","state","Promise","scheduleAfterTransactionCommit","callback","pendingTransactionID","callbackEntry","sequence","push","Error","getTransactionCallbacks","scheduleAfterTransactionRollback","getRollbackCallbacks","runTransactionCommitCallbacks","callbacksByTransaction","get","scopedCallbacks","closeTransactionScopes","delete","size","length","runCallbacks","clearTransactionCommitCallbacks","runTransactionRollbackCallbacks","clearTransactionRollbackCallbacks","flushDeferredCleanupScope","assertDeferredCleanupScopeIsActive","popScope","splice","flushDeferredCleanupScopeAfterOperation","err","logger","error","msg","clearDeferredCleanupScope","Map","set","errors","sort","a","b","AggregateError"],"mappings":"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"}

package/dist/utilities/transactionMutationTracker.d.ts

@@ -0,0 +1,21 @@
+import type { BaseDatabaseAdapter } from '../database/types.js';
+import type { PayloadRequest } from '../types/index.js';
+type TransactionMutationState = {
+    hasTransactionWrite: boolean;
+    parent: TransactionMutationState | undefined;
+};
+export type TransactionMutationScope = {
+    state: TransactionMutationState;
+};
+export declare const runInTransactionMutationScope: <Value>({ adapter, callback, }: {
+    adapter?: BaseDatabaseAdapter;
+    callback: (scope: TransactionMutationScope) => Promise<Value>;
+}) => Promise<Value>;
+export declare const hasTransactionWrite: ({ scope }: {
+    scope: TransactionMutationScope;
+}) => boolean;
+export declare const markTransactionWrite: ({ req, }: {
+    req: Partial<PayloadRequest> | undefined;
+}) => void;
+export {};
+//# sourceMappingURL=transactionMutationTracker.d.ts.map

package/dist/utilities/transactionMutationTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionMutationTracker.d.ts","sourceRoot":"","sources":["../../src/utilities/transactionMutationTracker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,KAAK,wBAAwB,GAAG;IAC9B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,wBAAwB,CAAA;CAChC,CAAA;AAiED,eAAO,MAAM,6BAA6B,GAAU,KAAK,0BAGtD;IACD,OAAO,CAAC,EAAE,mBAAmB,CAAA;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;CAC9D,KAAG,OAAO,CAAC,KAAK,CAWhB,CAAA;AAED,eAAO,MAAM,mBAAmB,cAAe;IAAE,KAAK,EAAE,wBAAwB,CAAA;CAAE,KAAG,OACpD,CAAA;AAEjC,eAAO,MAAM,oBAAoB,aAE9B;IACD,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAAA;CACzC,KAAG,IAWH,CAAA"}

package/dist/utilities/transactionMutationTracker.js

@@ -0,0 +1,71 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const transactionMutationStorage = new AsyncLocalStorage();
+const trackedDatabaseMutationMethod = Symbol('trackedDatabaseMutationMethod');
+const databaseMutationMethodNames = [
+    'create',
+    'createGlobal',
+    'createGlobalVersion',
+    'createVersion',
+    'deleteBranchGlobal',
+    'deleteMany',
+    'deleteOne',
+    'deleteVersions',
+    'updateGlobal',
+    'updateGlobalVersion',
+    'updateJobs',
+    'updateMany',
+    'updateOne',
+    'updateVersion',
+    'upsert',
+    'upsertBranchGlobalChange'
+];
+const trackDatabaseAdapterMutations = ({ adapter })=>{
+    const adapterMethods = adapter;
+    for (const methodName of databaseMutationMethodNames){
+        const databaseMutationMethod = adapterMethods[methodName];
+        if (typeof databaseMutationMethod !== 'function' || databaseMutationMethod[trackedDatabaseMutationMethod]) {
+            continue;
+        }
+        const trackedMethod = async (...args)=>{
+            // Mark before invoking the adapter. A rejected multi-statement mutation can have written to
+            // the ambient transaction before it failed, so a caught document error must still abort it.
+            markTransactionWrite({
+                req: args[0]?.req
+            });
+            return Reflect.apply(databaseMutationMethod, adapter, args);
+        };
+        Object.defineProperty(trackedMethod, trackedDatabaseMutationMethod, {
+            value: true
+        });
+        if (!Reflect.set(adapterMethods, methodName, trackedMethod)) {
+            throw new TypeError(`Unable to track database mutation method "${methodName}".`);
+        }
+    }
+};
+export const runInTransactionMutationScope = async ({ adapter, callback })=>{
+    if (adapter) {
+        trackDatabaseAdapterMutations({
+            adapter
+        });
+    }
+    const state = {
+        hasTransactionWrite: false,
+        parent: transactionMutationStorage.getStore()
+    };
+    return transactionMutationStorage.run(state, ()=>callback({
+            state
+        }));
+};
+export const hasTransactionWrite = ({ scope })=>scope.state.hasTransactionWrite;
+export const markTransactionWrite = ({ req })=>{
+    if (!req?.transactionID) {
+        return;
+    }
+    let state = transactionMutationStorage.getStore();
+    while(state){
+        state.hasTransactionWrite = true;
+        state = state.parent;
+    }
+};
+
+//# sourceMappingURL=transactionMutationTracker.js.map