payload 4.0.0-internal.ea6e8f8 → 4.0.0-internal.ee5d8bd
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin/adapters/router.d.ts +1 -1
- package/dist/admin/adapters/router.d.ts.map +1 -1
- package/dist/admin/adapters/router.js.map +1 -1
- package/dist/admin/forms/Diff.d.ts +0 -4
- package/dist/admin/forms/Diff.d.ts.map +1 -1
- package/dist/admin/forms/Diff.js.map +1 -1
- package/dist/admin/forms/Form.d.ts +0 -2
- package/dist/admin/forms/Form.d.ts.map +1 -1
- package/dist/admin/forms/Form.js.map +1 -1
- package/dist/admin/initAdminContext.d.ts.map +1 -1
- package/dist/admin/initAdminContext.js +0 -10
- package/dist/admin/initAdminContext.js.map +1 -1
- package/dist/auth/createAuthToken.d.ts +26 -0
- package/dist/auth/createAuthToken.d.ts.map +1 -0
- package/dist/auth/createAuthToken.js +39 -0
- package/dist/auth/createAuthToken.js.map +1 -0
- package/dist/auth/endpoints/refresh.d.ts.map +1 -1
- package/dist/auth/endpoints/refresh.js +2 -1
- package/dist/auth/endpoints/refresh.js.map +1 -1
- package/dist/auth/getFieldsToSign.js.map +1 -1
- package/dist/auth/loginWithCookie.d.ts.map +1 -1
- package/dist/auth/loginWithCookie.js +1 -0
- package/dist/auth/loginWithCookie.js.map +1 -1
- package/dist/auth/operations/local/login.d.ts.map +1 -1
- package/dist/auth/operations/local/login.js +1 -0
- package/dist/auth/operations/local/login.js.map +1 -1
- package/dist/auth/operations/login.d.ts +2 -0
- package/dist/auth/operations/login.d.ts.map +1 -1
- package/dist/auth/operations/login.js +6 -19
- package/dist/auth/operations/login.js.map +1 -1
- package/dist/auth/operations/refresh.d.ts +8 -0
- package/dist/auth/operations/refresh.d.ts.map +1 -1
- package/dist/auth/operations/refresh.js +50 -19
- package/dist/auth/operations/refresh.js.map +1 -1
- package/dist/auth/operations/resetPassword.d.ts.map +1 -1
- package/dist/auth/operations/resetPassword.js +54 -20
- package/dist/auth/operations/resetPassword.js.map +1 -1
- package/dist/auth/refreshAuthToken.d.ts +32 -0
- package/dist/auth/refreshAuthToken.d.ts.map +1 -0
- package/dist/auth/refreshAuthToken.js +113 -0
- package/dist/auth/refreshAuthToken.js.map +1 -0
- package/dist/auth/serverFunctions/cookies.js.map +1 -1
- package/dist/auth/serverFunctions/login.js.map +1 -1
- package/dist/auth/sessions.d.ts +9 -2
- package/dist/auth/sessions.d.ts.map +1 -1
- package/dist/auth/sessions.js +6 -5
- package/dist/auth/sessions.js.map +1 -1
- package/dist/auth/types.d.ts +25 -1
- package/dist/auth/types.d.ts.map +1 -1
- package/dist/auth/types.js.map +1 -1
- package/dist/cli/commands/data/utilities.d.ts +1 -1
- package/dist/cli/commands/data/utilities.d.ts.map +1 -1
- package/dist/cli/commands/data/utilities.js.map +1 -1
- package/dist/cli/defineCLICommand.js +1 -1
- package/dist/cli/defineCLICommand.js.map +1 -1
- package/dist/collections/config/client.d.ts +1 -1
- package/dist/collections/config/client.d.ts.map +1 -1
- package/dist/collections/config/client.js +0 -1
- package/dist/collections/config/client.js.map +1 -1
- package/dist/collections/config/defaults.d.ts +2 -0
- package/dist/collections/config/defaults.d.ts.map +1 -1
- package/dist/collections/config/defaults.js +4 -0
- package/dist/collections/config/defaults.js.map +1 -1
- package/dist/collections/config/sanitize.d.ts.map +1 -1
- package/dist/collections/config/sanitize.js +3 -0
- package/dist/collections/config/sanitize.js.map +1 -1
- package/dist/collections/config/sanitizeCompoundIndexes.d.ts.map +1 -1
- package/dist/collections/config/sanitizeCompoundIndexes.js +0 -9
- package/dist/collections/config/sanitizeCompoundIndexes.js.map +1 -1
- package/dist/collections/config/types.d.ts +4 -21
- package/dist/collections/config/types.d.ts.map +1 -1
- package/dist/collections/config/types.js.map +1 -1
- package/dist/collections/dataloader.d.ts +1 -10
- package/dist/collections/dataloader.d.ts.map +1 -1
- package/dist/collections/dataloader.js +6 -14
- package/dist/collections/dataloader.js.map +1 -1
- package/dist/collections/operations/create.d.ts.map +1 -1
- package/dist/collections/operations/create.js +0 -13
- package/dist/collections/operations/create.js.map +1 -1
- package/dist/collections/operations/delete.d.ts.map +1 -1
- package/dist/collections/operations/delete.js +121 -638
- package/dist/collections/operations/delete.js.map +1 -1
- package/dist/collections/operations/deleteByID.d.ts.map +1 -1
- package/dist/collections/operations/deleteByID.js +32 -238
- package/dist/collections/operations/deleteByID.js.map +1 -1
- package/dist/collections/operations/findByID.d.ts.map +1 -1
- package/dist/collections/operations/findByID.js +0 -6
- package/dist/collections/operations/findByID.js.map +1 -1
- package/dist/collections/operations/findDistinct.d.ts.map +1 -1
- package/dist/collections/operations/findDistinct.js +6 -7
- package/dist/collections/operations/findDistinct.js.map +1 -1
- package/dist/collections/operations/findVersionByID.d.ts.map +1 -1
- package/dist/collections/operations/findVersionByID.js +7 -0
- package/dist/collections/operations/findVersionByID.js.map +1 -1
- package/dist/collections/operations/findVersions.d.ts.map +1 -1
- package/dist/collections/operations/findVersions.js +5 -0
- package/dist/collections/operations/findVersions.js.map +1 -1
- package/dist/collections/operations/local/count.d.ts +4 -9
- package/dist/collections/operations/local/count.d.ts.map +1 -1
- package/dist/collections/operations/local/count.js.map +1 -1
- package/dist/collections/operations/local/countVersions.d.ts +0 -4
- package/dist/collections/operations/local/countVersions.d.ts.map +1 -1
- package/dist/collections/operations/local/countVersions.js.map +1 -1
- package/dist/collections/operations/local/create.d.ts +4 -9
- package/dist/collections/operations/local/create.d.ts.map +1 -1
- package/dist/collections/operations/local/create.js.map +1 -1
- package/dist/collections/operations/local/delete.d.ts +4 -9
- package/dist/collections/operations/local/delete.d.ts.map +1 -1
- package/dist/collections/operations/local/delete.js.map +1 -1
- package/dist/collections/operations/local/duplicate.d.ts +0 -5
- package/dist/collections/operations/local/duplicate.d.ts.map +1 -1
- package/dist/collections/operations/local/duplicate.js.map +1 -1
- package/dist/collections/operations/local/find.d.ts +4 -9
- package/dist/collections/operations/local/find.d.ts.map +1 -1
- package/dist/collections/operations/local/find.js.map +1 -1
- package/dist/collections/operations/local/findByID.d.ts +4 -9
- package/dist/collections/operations/local/findByID.d.ts.map +1 -1
- package/dist/collections/operations/local/findByID.js.map +1 -1
- package/dist/collections/operations/local/findDistinct.d.ts +0 -5
- package/dist/collections/operations/local/findDistinct.d.ts.map +1 -1
- package/dist/collections/operations/local/findDistinct.js.map +1 -1
- package/dist/collections/operations/local/findVersionByID.d.ts +0 -5
- package/dist/collections/operations/local/findVersionByID.d.ts.map +1 -1
- package/dist/collections/operations/local/findVersionByID.js.map +1 -1
- package/dist/collections/operations/local/findVersions.d.ts +0 -5
- package/dist/collections/operations/local/findVersions.d.ts.map +1 -1
- package/dist/collections/operations/local/findVersions.js.map +1 -1
- package/dist/collections/operations/local/restoreVersion.d.ts +0 -5
- package/dist/collections/operations/local/restoreVersion.d.ts.map +1 -1
- package/dist/collections/operations/local/restoreVersion.js.map +1 -1
- package/dist/collections/operations/local/update.d.ts +4 -9
- package/dist/collections/operations/local/update.d.ts.map +1 -1
- package/dist/collections/operations/local/update.js.map +1 -1
- package/dist/collections/operations/renameFile.js +1 -1
- package/dist/collections/operations/renameFile.js.map +1 -1
- package/dist/collections/operations/restoreVersion.d.ts.map +1 -1
- package/dist/collections/operations/restoreVersion.js +76 -157
- package/dist/collections/operations/restoreVersion.js.map +1 -1
- package/dist/collections/operations/update.d.ts.map +1 -1
- package/dist/collections/operations/update.js +171 -357
- package/dist/collections/operations/update.js.map +1 -1
- package/dist/collections/operations/updateByID.d.ts +0 -15
- package/dist/collections/operations/updateByID.d.ts.map +1 -1
- package/dist/collections/operations/updateByID.js +60 -265
- package/dist/collections/operations/updateByID.js.map +1 -1
- package/dist/collections/operations/utilities/buildBeforeOperation.d.ts.map +1 -1
- package/dist/collections/operations/utilities/buildBeforeOperation.js +0 -7
- package/dist/collections/operations/utilities/buildBeforeOperation.js.map +1 -1
- package/dist/collections/operations/utilities/update.d.ts +1 -14
- package/dist/collections/operations/utilities/update.d.ts.map +1 -1
- package/dist/collections/operations/utilities/update.js +20 -92
- package/dist/collections/operations/utilities/update.js.map +1 -1
- package/dist/collections/operations/validate.js +4 -4
- package/dist/collections/operations/validate.js.map +1 -1
- package/dist/config/client.d.ts +1 -3
- package/dist/config/client.d.ts.map +1 -1
- package/dist/config/client.js +1 -9
- package/dist/config/client.js.map +1 -1
- package/dist/config/defaults.d.ts.map +1 -1
- package/dist/config/defaults.js +1 -0
- package/dist/config/defaults.js.map +1 -1
- package/dist/config/definePlugin.js.map +1 -1
- package/dist/config/sanitize.d.ts.map +1 -1
- package/dist/config/sanitize.js +2 -40
- package/dist/config/sanitize.js.map +1 -1
- package/dist/config/types.d.ts +13 -21
- package/dist/config/types.d.ts.map +1 -1
- package/dist/config/types.js.map +1 -1
- package/dist/database/defaultCopy.d.ts.map +1 -1
- package/dist/database/defaultCopy.js +0 -1
- package/dist/database/defaultCopy.js.map +1 -1
- package/dist/database/types.d.ts +4 -75
- package/dist/database/types.d.ts.map +1 -1
- package/dist/database/types.js.map +1 -1
- package/dist/exports/build-config.d.ts +9 -0
- package/dist/exports/build-config.d.ts.map +1 -0
- package/dist/exports/build-config.js +38 -0
- package/dist/exports/build-config.js.map +1 -0
- package/dist/exports/shared.d.ts +0 -2
- package/dist/exports/shared.d.ts.map +1 -1
- package/dist/exports/shared.js +0 -2
- package/dist/exports/shared.js.map +1 -1
- package/dist/fields/baseFields/authorship/index.d.ts +1 -2
- package/dist/fields/baseFields/authorship/index.d.ts.map +1 -1
- package/dist/fields/baseFields/authorship/index.js +0 -12
- package/dist/fields/baseFields/authorship/index.js.map +1 -1
- package/dist/fields/config/client.js.map +1 -1
- package/dist/fields/config/reservedFieldNames.d.ts.map +1 -1
- package/dist/fields/config/reservedFieldNames.js.map +1 -1
- package/dist/fields/config/types.d.ts.map +1 -1
- package/dist/fields/config/types.js.map +1 -1
- package/dist/fields/hooks/afterChange/promise.js.map +1 -1
- package/dist/fields/hooks/afterRead/index.d.ts +0 -8
- package/dist/fields/hooks/afterRead/index.d.ts.map +1 -1
- package/dist/fields/hooks/afterRead/index.js +2 -6
- package/dist/fields/hooks/afterRead/index.js.map +1 -1
- package/dist/fields/hooks/afterRead/promise.d.ts +1 -3
- package/dist/fields/hooks/afterRead/promise.d.ts.map +1 -1
- package/dist/fields/hooks/afterRead/promise.js +17 -41
- package/dist/fields/hooks/afterRead/promise.js.map +1 -1
- package/dist/fields/hooks/afterRead/relationshipPopulationPromise.d.ts.map +1 -1
- package/dist/fields/hooks/afterRead/relationshipPopulationPromise.js +0 -2
- package/dist/fields/hooks/afterRead/relationshipPopulationPromise.js.map +1 -1
- package/dist/fields/hooks/afterRead/traverseFields.d.ts +1 -3
- package/dist/fields/hooks/afterRead/traverseFields.d.ts.map +1 -1
- package/dist/fields/hooks/afterRead/traverseFields.js +2 -4
- package/dist/fields/hooks/afterRead/traverseFields.js.map +1 -1
- package/dist/fields/hooks/afterRead/virtualFieldPopulationPromise.d.ts.map +1 -1
- package/dist/fields/hooks/afterRead/virtualFieldPopulationPromise.js +0 -3
- package/dist/fields/hooks/afterRead/virtualFieldPopulationPromise.js.map +1 -1
- package/dist/fields/hooks/beforeChange/flattenValidationData.d.ts +14 -0
- package/dist/fields/hooks/beforeChange/flattenValidationData.d.ts.map +1 -0
- package/dist/fields/hooks/beforeChange/flattenValidationData.js +36 -0
- package/dist/fields/hooks/beforeChange/flattenValidationData.js.map +1 -0
- package/dist/fields/hooks/beforeChange/promise.d.ts +2 -1
- package/dist/fields/hooks/beforeChange/promise.d.ts.map +1 -1
- package/dist/fields/hooks/beforeChange/promise.js +96 -22
- package/dist/fields/hooks/beforeChange/promise.js.map +1 -1
- package/dist/fields/hooks/beforeChange/traverseFields.d.ts +2 -1
- package/dist/fields/hooks/beforeChange/traverseFields.d.ts.map +1 -1
- package/dist/fields/hooks/beforeChange/traverseFields.js +2 -1
- package/dist/fields/hooks/beforeChange/traverseFields.js.map +1 -1
- package/dist/fields/hooks/beforeValidate/promise.d.ts.map +1 -1
- package/dist/fields/hooks/beforeValidate/promise.js +0 -8
- package/dist/fields/hooks/beforeValidate/promise.js.map +1 -1
- package/dist/fields/validations.d.ts.map +1 -1
- package/dist/fields/validations.js +4 -1
- package/dist/fields/validations.js.map +1 -1
- package/dist/globals/config/types.d.ts +2 -6
- package/dist/globals/config/types.d.ts.map +1 -1
- package/dist/globals/config/types.js.map +1 -1
- package/dist/globals/operations/countGlobalVersions.d.ts.map +1 -1
- package/dist/globals/operations/countGlobalVersions.js +0 -7
- package/dist/globals/operations/countGlobalVersions.js.map +1 -1
- package/dist/globals/operations/findOne.d.ts.map +1 -1
- package/dist/globals/operations/findOne.js +0 -7
- package/dist/globals/operations/findOne.js.map +1 -1
- package/dist/globals/operations/findVersionByID.d.ts.map +1 -1
- package/dist/globals/operations/findVersionByID.js +6 -6
- package/dist/globals/operations/findVersionByID.js.map +1 -1
- package/dist/globals/operations/findVersions.d.ts.map +1 -1
- package/dist/globals/operations/findVersions.js +4 -6
- package/dist/globals/operations/findVersions.js.map +1 -1
- package/dist/globals/operations/local/countVersions.d.ts +0 -5
- package/dist/globals/operations/local/countVersions.d.ts.map +1 -1
- package/dist/globals/operations/local/countVersions.js.map +1 -1
- package/dist/globals/operations/local/findOne.d.ts +0 -5
- package/dist/globals/operations/local/findOne.d.ts.map +1 -1
- package/dist/globals/operations/local/findOne.js.map +1 -1
- package/dist/globals/operations/local/findVersionByID.d.ts +0 -5
- package/dist/globals/operations/local/findVersionByID.d.ts.map +1 -1
- package/dist/globals/operations/local/findVersionByID.js.map +1 -1
- package/dist/globals/operations/local/findVersions.d.ts +0 -5
- package/dist/globals/operations/local/findVersions.d.ts.map +1 -1
- package/dist/globals/operations/local/findVersions.js.map +1 -1
- package/dist/globals/operations/local/restoreVersion.d.ts +0 -5
- package/dist/globals/operations/local/restoreVersion.d.ts.map +1 -1
- package/dist/globals/operations/local/restoreVersion.js.map +1 -1
- package/dist/globals/operations/local/update.d.ts +0 -5
- package/dist/globals/operations/local/update.d.ts.map +1 -1
- package/dist/globals/operations/local/update.js +18 -61
- package/dist/globals/operations/local/update.js.map +1 -1
- package/dist/globals/operations/restoreVersion.d.ts +2 -3
- package/dist/globals/operations/restoreVersion.d.ts.map +1 -1
- package/dist/globals/operations/restoreVersion.js +24 -61
- package/dist/globals/operations/restoreVersion.js.map +1 -1
- package/dist/globals/operations/update.d.ts.map +1 -1
- package/dist/globals/operations/update.js +8 -86
- package/dist/globals/operations/update.js.map +1 -1
- package/dist/globals/operations/validate.js +1 -1
- package/dist/globals/operations/validate.js.map +1 -1
- package/dist/hierarchy/addHierarchyToCollection.d.ts.map +1 -1
- package/dist/hierarchy/addHierarchyToCollection.js +32 -21
- package/dist/hierarchy/addHierarchyToCollection.js.map +1 -1
- package/dist/hierarchy/createFolderField.js.map +1 -1
- package/dist/hierarchy/getInitialTreeData.d.ts +1 -3
- package/dist/hierarchy/getInitialTreeData.d.ts.map +1 -1
- package/dist/hierarchy/getInitialTreeData.js +1 -4
- package/dist/hierarchy/getInitialTreeData.js.map +1 -1
- package/dist/hierarchy/resolveHierarchyCollections.js +9 -3
- package/dist/hierarchy/resolveHierarchyCollections.js.map +1 -1
- package/dist/hierarchy/utils/computePaths.d.ts.map +1 -1
- package/dist/hierarchy/utils/computePaths.js.map +1 -1
- package/dist/index.bundled.d.ts +4336 -5501
- package/dist/index.d.ts +27 -51
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +14 -37
- package/dist/index.js.map +1 -1
- package/dist/llm-instructions/getInstructionsCollection.d.ts.map +1 -1
- package/dist/llm-instructions/getInstructionsCollection.js +2 -0
- package/dist/llm-instructions/getInstructionsCollection.js.map +1 -1
- package/dist/preferences/keys.d.ts +4 -11
- package/dist/preferences/keys.d.ts.map +1 -1
- package/dist/preferences/keys.js +3 -10
- package/dist/preferences/keys.js.map +1 -1
- package/dist/preferences/types.d.ts +0 -19
- package/dist/preferences/types.d.ts.map +1 -1
- package/dist/preferences/types.js.map +1 -1
- package/dist/queues/operations/runJobs/runJob/getRunTaskFunction.js +1 -1
- package/dist/queues/operations/runJobs/runJob/getRunTaskFunction.js.map +1 -1
- package/dist/types/index.d.ts +0 -13
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js.map +1 -1
- package/dist/uploads/deleteAssociatedFiles.d.ts.map +1 -1
- package/dist/uploads/deleteAssociatedFiles.js +29 -108
- package/dist/uploads/deleteAssociatedFiles.js.map +1 -1
- package/dist/uploads/endpoints/getFile.d.ts.map +1 -1
- package/dist/uploads/endpoints/getFile.js +0 -5
- package/dist/uploads/endpoints/getFile.js.map +1 -1
- package/dist/uploads/fileExists.d.ts.map +1 -1
- package/dist/uploads/fileExists.js +2 -5
- package/dist/uploads/fileExists.js.map +1 -1
- package/dist/uploads/fileVersioning/archive.d.ts.map +1 -1
- package/dist/uploads/fileVersioning/archive.js +1 -15
- package/dist/uploads/fileVersioning/archive.js.map +1 -1
- package/dist/uploads/fileVersioning/cleanup.d.ts +0 -7
- package/dist/uploads/fileVersioning/cleanup.d.ts.map +1 -1
- package/dist/uploads/fileVersioning/cleanup.js +0 -12
- package/dist/uploads/fileVersioning/cleanup.js.map +1 -1
- package/dist/uploads/fileVersioning/cloudStorage.d.ts.map +1 -1
- package/dist/uploads/fileVersioning/cloudStorage.js +1 -16
- package/dist/uploads/fileVersioning/cloudStorage.js.map +1 -1
- package/dist/uploads/fileVersioning/resolveHistoricalFile.js.map +1 -1
- package/dist/uploads/formatFilesize.js +1 -1
- package/dist/uploads/formatFilesize.js.map +1 -1
- package/dist/uploads/generateFileData.d.ts +0 -5
- package/dist/uploads/generateFileData.d.ts.map +1 -1
- package/dist/uploads/generateFileData.js +2 -74
- package/dist/uploads/generateFileData.js.map +1 -1
- package/dist/uploads/getBaseFields.d.ts.map +1 -1
- package/dist/uploads/getBaseFields.js +29 -46
- package/dist/uploads/getBaseFields.js.map +1 -1
- package/dist/uploads/getFileContentRequirement.js.map +1 -1
- package/dist/uploads/getFileFromUploadInstructions.js.map +1 -1
- package/dist/uploads/getSafeFilename.d.ts.map +1 -1
- package/dist/uploads/getSafeFilename.js +3 -5
- package/dist/uploads/getSafeFilename.js.map +1 -1
- package/dist/uploads/safeFetch.js.map +1 -1
- package/dist/uploads/stagedUpload.js.map +1 -1
- package/dist/uploads/transformers/handleDynamicFileRequest.js +11 -2
- package/dist/uploads/transformers/handleDynamicFileRequest.js.map +1 -1
- package/dist/uploads/types.d.ts +0 -11
- package/dist/uploads/types.d.ts.map +1 -1
- package/dist/uploads/types.js.map +1 -1
- package/dist/uploads/uploadFiles.d.ts +1 -4
- package/dist/uploads/uploadFiles.d.ts.map +1 -1
- package/dist/uploads/uploadFiles.js +5 -29
- package/dist/uploads/uploadFiles.js.map +1 -1
- package/dist/utilities/addSelectGenericsToGeneretedTypes.d.ts.map +1 -1
- package/dist/utilities/addSelectGenericsToGeneretedTypes.js +0 -1
- package/dist/utilities/addSelectGenericsToGeneretedTypes.js.map +1 -1
- package/dist/utilities/appendDateTimezoneSelectFields.js.map +1 -1
- package/dist/utilities/assertNoValidationWrite.d.ts.map +1 -1
- package/dist/utilities/assertNoValidationWrite.js +0 -4
- package/dist/utilities/assertNoValidationWrite.js.map +1 -1
- package/dist/utilities/checkDocumentLockStatus.d.ts +6 -15
- package/dist/utilities/checkDocumentLockStatus.d.ts.map +1 -1
- package/dist/utilities/checkDocumentLockStatus.js +11 -44
- package/dist/utilities/checkDocumentLockStatus.js.map +1 -1
- package/dist/utilities/cloneValidationRequest.js.map +1 -1
- package/dist/utilities/commitTransaction.d.ts +0 -4
- package/dist/utilities/commitTransaction.d.ts.map +1 -1
- package/dist/utilities/commitTransaction.js +1 -41
- package/dist/utilities/commitTransaction.js.map +1 -1
- package/dist/utilities/configToJSONSchema.d.ts.map +1 -1
- package/dist/utilities/configToJSONSchema.js +2 -18
- package/dist/utilities/configToJSONSchema.js.map +1 -1
- package/dist/utilities/createPayloadRequest.d.ts +0 -5
- package/dist/utilities/createPayloadRequest.d.ts.map +1 -1
- package/dist/utilities/createPayloadRequest.js +3 -50
- package/dist/utilities/createPayloadRequest.js.map +1 -1
- package/dist/utilities/createPayloadRequestFromWebRequest.d.ts +12 -1
- package/dist/utilities/createPayloadRequestFromWebRequest.d.ts.map +1 -1
- package/dist/utilities/createPayloadRequestFromWebRequest.js +9 -5
- package/dist/utilities/createPayloadRequestFromWebRequest.js.map +1 -1
- package/dist/utilities/deepCopyObject.js.map +1 -1
- package/dist/utilities/documentMatchingWhereExists.js +1 -1
- package/dist/utilities/documentMatchingWhereExists.js.map +1 -1
- package/dist/utilities/entityInputSchema/validateEntityData.d.ts.map +1 -1
- package/dist/utilities/entityInputSchema/validateEntityData.js.map +1 -1
- package/dist/utilities/filterDataToSelectedLocales.js.map +1 -1
- package/dist/utilities/getEntityPermissions/getEntityPermissions.d.ts.map +1 -1
- package/dist/utilities/getEntityPermissions/getEntityPermissions.js +1 -0
- package/dist/utilities/getEntityPermissions/getEntityPermissions.js.map +1 -1
- package/dist/utilities/getEntityPermissions/populateFieldPermissions.js.map +1 -1
- package/dist/utilities/getVersionsConfig.d.ts +4 -0
- package/dist/utilities/getVersionsConfig.d.ts.map +1 -1
- package/dist/utilities/getVersionsConfig.js +5 -0
- package/dist/utilities/getVersionsConfig.js.map +1 -1
- package/dist/utilities/handleEndpoints.d.ts.map +1 -1
- package/dist/utilities/handleEndpoints.js +10 -9
- package/dist/utilities/handleEndpoints.js.map +1 -1
- package/dist/utilities/httpStatus.d.ts +0 -2
- package/dist/utilities/httpStatus.d.ts.map +1 -1
- package/dist/utilities/httpStatus.js +1 -3
- package/dist/utilities/httpStatus.js.map +1 -1
- package/dist/utilities/initTransaction.d.ts.map +1 -1
- package/dist/utilities/initTransaction.js +7 -35
- package/dist/utilities/initTransaction.js.map +1 -1
- package/dist/utilities/killTransaction.d.ts.map +1 -1
- package/dist/utilities/killTransaction.js +0 -27
- package/dist/utilities/killTransaction.js.map +1 -1
- package/dist/utilities/parseParams/index.js.map +1 -1
- package/dist/utilities/parseValidationLocale.js.map +1 -1
- package/dist/utilities/sanitizePopulateParam.js.map +1 -1
- package/dist/utilities/telemetry/conf/index.d.ts +4 -1
- package/dist/utilities/telemetry/conf/index.d.ts.map +1 -1
- package/dist/utilities/telemetry/conf/index.js.map +1 -1
- package/dist/utilities/telemetry/featureInfo/getFeatureInfo.js.map +1 -1
- package/dist/versions/allLocalesPublicationStatus.js.map +1 -1
- package/dist/versions/buildCollectionFields.d.ts.map +1 -1
- package/dist/versions/buildCollectionFields.js +0 -23
- package/dist/versions/buildCollectionFields.js.map +1 -1
- package/dist/versions/buildGlobalFields.d.ts.map +1 -1
- package/dist/versions/buildGlobalFields.js +0 -14
- package/dist/versions/buildGlobalFields.js.map +1 -1
- package/dist/versions/buildVersionCompoundIndexes.d.ts.map +1 -1
- package/dist/versions/buildVersionCompoundIndexes.js +2 -8
- package/dist/versions/buildVersionCompoundIndexes.js.map +1 -1
- package/dist/versions/deleteCollectionVersions.d.ts +1 -2
- package/dist/versions/deleteCollectionVersions.d.ts.map +1 -1
- package/dist/versions/deleteCollectionVersions.js +8 -37
- package/dist/versions/deleteCollectionVersions.js.map +1 -1
- package/dist/versions/deleteScheduledPublishJobs.d.ts.map +1 -1
- package/dist/versions/deleteScheduledPublishJobs.js +0 -4
- package/dist/versions/deleteScheduledPublishJobs.js.map +1 -1
- package/dist/versions/drafts/appendVersionToQueryKey.d.ts.map +1 -1
- package/dist/versions/drafts/appendVersionToQueryKey.js +1 -9
- package/dist/versions/drafts/appendVersionToQueryKey.js.map +1 -1
- package/dist/versions/drafts/replaceWithDraftIfAvailable.d.ts.map +1 -1
- package/dist/versions/drafts/replaceWithDraftIfAvailable.js +1 -8
- package/dist/versions/drafts/replaceWithDraftIfAvailable.js.map +1 -1
- package/dist/versions/enforceMaxVersions.d.ts +0 -1
- package/dist/versions/enforceMaxVersions.d.ts.map +1 -1
- package/dist/versions/enforceMaxVersions.js +6 -22
- package/dist/versions/enforceMaxVersions.js.map +1 -1
- package/dist/versions/getLatestCollectionVersion.d.ts.map +1 -1
- package/dist/versions/getLatestCollectionVersion.js +2 -10
- package/dist/versions/getLatestCollectionVersion.js.map +1 -1
- package/dist/versions/getLatestGlobalVersion.d.ts +2 -6
- package/dist/versions/getLatestGlobalVersion.d.ts.map +1 -1
- package/dist/versions/getLatestGlobalVersion.js +21 -65
- package/dist/versions/getLatestGlobalVersion.js.map +1 -1
- package/dist/versions/isInheritedReadVersionsAccess.js.map +1 -1
- package/dist/versions/saveVersion.d.ts +0 -7
- package/dist/versions/saveVersion.d.ts.map +1 -1
- package/dist/versions/saveVersion.js +4 -27
- package/dist/versions/saveVersion.js.map +1 -1
- package/dist/versions/updateLatestVersion.d.ts +0 -1
- package/dist/versions/updateLatestVersion.d.ts.map +1 -1
- package/dist/versions/updateLatestVersion.js +7 -24
- package/dist/versions/updateLatestVersion.js.map +1 -1
- package/package.json +30 -28
- package/skills/payload/reference/ENDPOINTS.md +3 -9
- package/skills/payload/reference/PLUGIN-DEVELOPMENT.md +4 -4
- package/dist/admin/getAdminPreferences.d.ts +0 -10
- package/dist/admin/getAdminPreferences.d.ts.map +0 -1
- package/dist/admin/getAdminPreferences.js +0 -53
- package/dist/admin/getAdminPreferences.js.map +0 -1
- package/dist/admin/getRequestBranch.d.ts +0 -6
- package/dist/admin/getRequestBranch.d.ts.map +0 -1
- package/dist/admin/getRequestBranch.js +0 -17
- package/dist/admin/getRequestBranch.js.map +0 -1
- package/dist/branching/appendBranchFilter.d.ts +0 -30
- package/dist/branching/appendBranchFilter.d.ts.map +0 -1
- package/dist/branching/appendBranchFilter.js +0 -105
- package/dist/branching/appendBranchFilter.js.map +0 -1
- package/dist/branching/assertBranchAccess.d.ts +0 -10
- package/dist/branching/assertBranchAccess.d.ts.map +0 -1
- package/dist/branching/assertBranchAccess.js +0 -36
- package/dist/branching/assertBranchAccess.js.map +0 -1
- package/dist/branching/assertBranchActionAccess.d.ts +0 -10
- package/dist/branching/assertBranchActionAccess.d.ts.map +0 -1
- package/dist/branching/assertBranchActionAccess.js +0 -15
- package/dist/branching/assertBranchActionAccess.js.map +0 -1
- package/dist/branching/assertBranchCreatedDocumentsUnreferenced.d.ts +0 -53
- package/dist/branching/assertBranchCreatedDocumentsUnreferenced.d.ts.map +0 -1
- package/dist/branching/assertBranchCreatedDocumentsUnreferenced.js +0 -833
- package/dist/branching/assertBranchCreatedDocumentsUnreferenced.js.map +0 -1
- package/dist/branching/assertBranchReadable.d.ts +0 -36
- package/dist/branching/assertBranchReadable.d.ts.map +0 -1
- package/dist/branching/assertBranchReadable.js +0 -83
- package/dist/branching/assertBranchReadable.js.map +0 -1
- package/dist/branching/assertBranchUpdateAccess.d.ts +0 -8
- package/dist/branching/assertBranchUpdateAccess.d.ts.map +0 -1
- package/dist/branching/assertBranchUpdateAccess.js +0 -12
- package/dist/branching/assertBranchUpdateAccess.js.map +0 -1
- package/dist/branching/assertBranchWritable.d.ts +0 -18
- package/dist/branching/assertBranchWritable.d.ts.map +0 -1
- package/dist/branching/assertBranchWritable.js +0 -46
- package/dist/branching/assertBranchWritable.js.map +0 -1
- package/dist/branching/branchIDs.d.ts +0 -38
- package/dist/branching/branchIDs.d.ts.map +0 -1
- package/dist/branching/branchIDs.js +0 -113
- package/dist/branching/branchIDs.js.map +0 -1
- package/dist/branching/branchSelect.d.ts +0 -42
- package/dist/branching/branchSelect.d.ts.map +0 -1
- package/dist/branching/branchSelect.js +0 -97
- package/dist/branching/branchSelect.js.map +0 -1
- package/dist/branching/checkFieldAccess.d.ts +0 -21
- package/dist/branching/checkFieldAccess.d.ts.map +0 -1
- package/dist/branching/checkFieldAccess.js +0 -238
- package/dist/branching/checkFieldAccess.js.map +0 -1
- package/dist/branching/collections.d.ts +0 -14
- package/dist/branching/collections.d.ts.map +0 -1
- package/dist/branching/collections.js +0 -713
- package/dist/branching/collections.js.map +0 -1
- package/dist/branching/combineBranchAccess.d.ts +0 -6
- package/dist/branching/combineBranchAccess.d.ts.map +0 -1
- package/dist/branching/combineBranchAccess.js +0 -22
- package/dist/branching/combineBranchAccess.js.map +0 -1
- package/dist/branching/copyUploadFilesToBranch.d.ts +0 -9
- package/dist/branching/copyUploadFilesToBranch.d.ts.map +0 -1
- package/dist/branching/copyUploadFilesToBranch.js +0 -126
- package/dist/branching/copyUploadFilesToBranch.js.map +0 -1
- package/dist/branching/createShadowRow.d.ts +0 -70
- package/dist/branching/createShadowRow.d.ts.map +0 -1
- package/dist/branching/createShadowRow.js +0 -296
- package/dist/branching/createShadowRow.js.map +0 -1
- package/dist/branching/discard.d.ts +0 -52
- package/dist/branching/discard.d.ts.map +0 -1
- package/dist/branching/discard.js +0 -428
- package/dist/branching/discard.js.map +0 -1
- package/dist/branching/effectiveOperations.d.ts +0 -55
- package/dist/branching/effectiveOperations.d.ts.map +0 -1
- package/dist/branching/effectiveOperations.js +0 -472
- package/dist/branching/effectiveOperations.js.map +0 -1
- package/dist/branching/endpoints/discard.d.ts +0 -15
- package/dist/branching/endpoints/discard.d.ts.map +0 -1
- package/dist/branching/endpoints/discard.js +0 -55
- package/dist/branching/endpoints/discard.js.map +0 -1
- package/dist/branching/endpoints/merge.d.ts +0 -34
- package/dist/branching/endpoints/merge.d.ts.map +0 -1
- package/dist/branching/endpoints/merge.js +0 -119
- package/dist/branching/endpoints/merge.js.map +0 -1
- package/dist/branching/forkDocument.d.ts +0 -20
- package/dist/branching/forkDocument.d.ts.map +0 -1
- package/dist/branching/forkDocument.js +0 -169
- package/dist/branching/forkDocument.js.map +0 -1
- package/dist/branching/globalMergeWrites.d.ts +0 -21
- package/dist/branching/globalMergeWrites.d.ts.map +0 -1
- package/dist/branching/globalMergeWrites.js +0 -146
- package/dist/branching/globalMergeWrites.js.map +0 -1
- package/dist/branching/globals.d.ts +0 -49
- package/dist/branching/globals.d.ts.map +0 -1
- package/dist/branching/globals.js +0 -197
- package/dist/branching/globals.js.map +0 -1
- package/dist/branching/hooks.d.ts +0 -24
- package/dist/branching/hooks.d.ts.map +0 -1
- package/dist/branching/hooks.js +0 -92
- package/dist/branching/hooks.js.map +0 -1
- package/dist/branching/injectBranchFields.d.ts +0 -40
- package/dist/branching/injectBranchFields.d.ts.map +0 -1
- package/dist/branching/injectBranchFields.js +0 -229
- package/dist/branching/injectBranchFields.js.map +0 -1
- package/dist/branching/merge/applyMergeChange.d.ts +0 -27
- package/dist/branching/merge/applyMergeChange.d.ts.map +0 -1
- package/dist/branching/merge/applyMergeChange.js +0 -853
- package/dist/branching/merge/applyMergeChange.js.map +0 -1
- package/dist/branching/merge/branchMergeStatus.d.ts +0 -12
- package/dist/branching/merge/branchMergeStatus.d.ts.map +0 -1
- package/dist/branching/merge/branchMergeStatus.js +0 -74
- package/dist/branching/merge/branchMergeStatus.js.map +0 -1
- package/dist/branching/merge/executeMerge.d.ts +0 -22
- package/dist/branching/merge/executeMerge.d.ts.map +0 -1
- package/dist/branching/merge/executeMerge.js +0 -600
- package/dist/branching/merge/executeMerge.js.map +0 -1
- package/dist/branching/merge/finalizeMerge.d.ts +0 -40
- package/dist/branching/merge/finalizeMerge.d.ts.map +0 -1
- package/dist/branching/merge/finalizeMerge.js +0 -237
- package/dist/branching/merge/finalizeMerge.js.map +0 -1
- package/dist/branching/merge/mergeLedger.d.ts +0 -40
- package/dist/branching/merge/mergeLedger.d.ts.map +0 -1
- package/dist/branching/merge/mergeLedger.js +0 -130
- package/dist/branching/merge/mergeLedger.js.map +0 -1
- package/dist/branching/merge/prepareMerge.d.ts +0 -41
- package/dist/branching/merge/prepareMerge.d.ts.map +0 -1
- package/dist/branching/merge/prepareMerge.js +0 -234
- package/dist/branching/merge/prepareMerge.js.map +0 -1
- package/dist/branching/merge/recoverMerge.d.ts +0 -16
- package/dist/branching/merge/recoverMerge.d.ts.map +0 -1
- package/dist/branching/merge/recoverMerge.js +0 -199
- package/dist/branching/merge/recoverMerge.js.map +0 -1
- package/dist/branching/merge/retryFailedCleanups.d.ts +0 -36
- package/dist/branching/merge/retryFailedCleanups.d.ts.map +0 -1
- package/dist/branching/merge/retryFailedCleanups.js +0 -335
- package/dist/branching/merge/retryFailedCleanups.js.map +0 -1
- package/dist/branching/merge/utilities.d.ts +0 -35
- package/dist/branching/merge/utilities.d.ts.map +0 -1
- package/dist/branching/merge/utilities.js +0 -54
- package/dist/branching/merge/utilities.js.map +0 -1
- package/dist/branching/merge.d.ts +0 -88
- package/dist/branching/merge.d.ts.map +0 -1
- package/dist/branching/merge.js +0 -163
- package/dist/branching/merge.js.map +0 -1
- package/dist/branching/mergeWriteGuard.d.ts +0 -20
- package/dist/branching/mergeWriteGuard.d.ts.map +0 -1
- package/dist/branching/mergeWriteGuard.js +0 -27
- package/dist/branching/mergeWriteGuard.js.map +0 -1
- package/dist/branching/preflight.d.ts +0 -71
- package/dist/branching/preflight.d.ts.map +0 -1
- package/dist/branching/preflight.js +0 -757
- package/dist/branching/preflight.js.map +0 -1
- package/dist/branching/readLocalizedBranchWrite.d.ts +0 -14
- package/dist/branching/readLocalizedBranchWrite.d.ts.map +0 -1
- package/dist/branching/readLocalizedBranchWrite.js +0 -90
- package/dist/branching/readLocalizedBranchWrite.js.map +0 -1
- package/dist/branching/readMergeSnapshot.d.ts +0 -18
- package/dist/branching/readMergeSnapshot.d.ts.map +0 -1
- package/dist/branching/readMergeSnapshot.js +0 -99
- package/dist/branching/readMergeSnapshot.js.map +0 -1
- package/dist/branching/resolveBranch.d.ts +0 -153
- package/dist/branching/resolveBranch.d.ts.map +0 -1
- package/dist/branching/resolveBranch.js +0 -363
- package/dist/branching/resolveBranch.js.map +0 -1
- package/dist/branching/resolveBranchActionAccess.d.ts +0 -8
- package/dist/branching/resolveBranchActionAccess.d.ts.map +0 -1
- package/dist/branching/resolveBranchActionAccess.js +0 -9
- package/dist/branching/resolveBranchActionAccess.js.map +0 -1
- package/dist/branching/resolveBranchQuery.d.ts +0 -48
- package/dist/branching/resolveBranchQuery.d.ts.map +0 -1
- package/dist/branching/resolveBranchQuery.js +0 -115
- package/dist/branching/resolveBranchQuery.js.map +0 -1
- package/dist/branching/resolveBranchRowID.d.ts +0 -22
- package/dist/branching/resolveBranchRowID.d.ts.map +0 -1
- package/dist/branching/resolveBranchRowID.js +0 -70
- package/dist/branching/resolveBranchRowID.js.map +0 -1
- package/dist/branching/sanitizeBranchingConfig.d.ts +0 -31
- package/dist/branching/sanitizeBranchingConfig.d.ts.map +0 -1
- package/dist/branching/sanitizeBranchingConfig.js +0 -110
- package/dist/branching/sanitizeBranchingConfig.js.map +0 -1
- package/dist/branching/schedule/job.d.ts +0 -51
- package/dist/branching/schedule/job.d.ts.map +0 -1
- package/dist/branching/schedule/job.js +0 -151
- package/dist/branching/schedule/job.js.map +0 -1
- package/dist/branching/selectBranchChanges.d.ts +0 -8
- package/dist/branching/selectBranchChanges.d.ts.map +0 -1
- package/dist/branching/selectBranchChanges.js +0 -9
- package/dist/branching/selectBranchChanges.js.map +0 -1
- package/dist/branching/stripBranchMergeData.d.ts +0 -11
- package/dist/branching/stripBranchMergeData.d.ts.map +0 -1
- package/dist/branching/stripBranchMergeData.js +0 -20
- package/dist/branching/stripBranchMergeData.js.map +0 -1
- package/dist/branching/tombstone.d.ts +0 -91
- package/dist/branching/tombstone.d.ts.map +0 -1
- package/dist/branching/tombstone.js +0 -546
- package/dist/branching/tombstone.js.map +0 -1
- package/dist/branching/types.d.ts +0 -158
- package/dist/branching/types.d.ts.map +0 -1
- package/dist/branching/types.js +0 -54
- package/dist/branching/types.js.map +0 -1
- package/dist/branching/validation.d.ts +0 -47
- package/dist/branching/validation.d.ts.map +0 -1
- package/dist/branching/validation.js +0 -272
- package/dist/branching/validation.js.map +0 -1
- package/dist/branching/versions.d.ts +0 -131
- package/dist/branching/versions.d.ts.map +0 -1
- package/dist/branching/versions.js +0 -572
- package/dist/branching/versions.js.map +0 -1
- package/dist/collections/operations/utilities/createOperationRetryRequest.d.ts +0 -23
- package/dist/collections/operations/utilities/createOperationRetryRequest.d.ts.map +0 -1
- package/dist/collections/operations/utilities/createOperationRetryRequest.js +0 -683
- package/dist/collections/operations/utilities/createOperationRetryRequest.js.map +0 -1
- package/dist/fields/hooks/beforeValidate/throwOnAccessDenied.d.ts +0 -3
- package/dist/fields/hooks/beforeValidate/throwOnAccessDenied.d.ts.map +0 -1
- package/dist/fields/hooks/beforeValidate/throwOnAccessDenied.js +0 -3
- package/dist/fields/hooks/beforeValidate/throwOnAccessDenied.js.map +0 -1
- package/dist/uploads/appendBranchToFileURL.d.ts +0 -6
- package/dist/uploads/appendBranchToFileURL.d.ts.map +0 -1
- package/dist/uploads/appendBranchToFileURL.js +0 -24
- package/dist/uploads/appendBranchToFileURL.js.map +0 -1
- package/dist/uploads/deleteUploadFilesExclusiveToDocument.d.ts +0 -15
- package/dist/uploads/deleteUploadFilesExclusiveToDocument.d.ts.map +0 -1
- package/dist/uploads/deleteUploadFilesExclusiveToDocument.js +0 -62
- package/dist/uploads/deleteUploadFilesExclusiveToDocument.js.map +0 -1
- package/dist/uploads/fileIdentity.d.ts +0 -24
- package/dist/uploads/fileIdentity.d.ts.map +0 -1
- package/dist/uploads/fileIdentity.js +0 -36
- package/dist/uploads/fileIdentity.js.map +0 -1
- package/dist/uploads/fileQuarantine.d.ts +0 -17
- package/dist/uploads/fileQuarantine.d.ts.map +0 -1
- package/dist/uploads/fileQuarantine.js +0 -52
- package/dist/uploads/fileQuarantine.js.map +0 -1
- package/dist/uploads/linkFileWithoutOverwrite.d.ts +0 -13
- package/dist/uploads/linkFileWithoutOverwrite.d.ts.map +0 -1
- package/dist/uploads/linkFileWithoutOverwrite.js +0 -13
- package/dist/uploads/linkFileWithoutOverwrite.js.map +0 -1
- package/dist/uploads/uploadFileRollback.d.ts +0 -31
- package/dist/uploads/uploadFileRollback.d.ts.map +0 -1
- package/dist/uploads/uploadFileRollback.js +0 -269
- package/dist/uploads/uploadFileRollback.js.map +0 -1
- package/dist/utilities/extractRelationshipID.d.ts +0 -4
- package/dist/utilities/extractRelationshipID.d.ts.map +0 -1
- package/dist/utilities/extractRelationshipID.js +0 -14
- package/dist/utilities/extractRelationshipID.js.map +0 -1
- package/dist/utilities/transactionCallbacks.d.ts +0 -77
- package/dist/utilities/transactionCallbacks.d.ts.map +0 -1
- package/dist/utilities/transactionCallbacks.js +0 -299
- package/dist/utilities/transactionCallbacks.js.map +0 -1
- package/dist/utilities/transactionMutationTracker.d.ts +0 -21
- package/dist/utilities/transactionMutationTracker.d.ts.map +0 -1
- package/dist/utilities/transactionMutationTracker.js +0 -71
- package/dist/utilities/transactionMutationTracker.js.map +0 -1
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/branching/createShadowRow.ts"],"sourcesContent":["import type { PayloadRequest } from '../types/index.js'\nimport type { BranchOperation } from './types.js'\n\nimport { APIError } from '../errors/index.js'\nimport { ValidationError } from '../errors/ValidationError.js'\nimport { shareFileOperationScope } from '../uploads/fileVersioning/fileOperationManager.js'\nimport {\n commitTransaction,\n isUnknownTransactionCommitResult,\n} from '../utilities/commitTransaction.js'\nimport { initTransaction } from '../utilities/initTransaction.js'\nimport { isolateObjectProperty } from '../utilities/isolateObjectProperty.js'\nimport { killTransaction } from '../utilities/killTransaction.js'\nimport { branchChangesCollectionSlug, branchDocIDField, branchField } from './types.js'\n\ntype ShadowSource = {\n branch: string\n id: number | string\n}\n\ntype Args = {\n branch: string\n collectionSlug: string\n data: Record<string, unknown>\n /** The canonical document this row represents, for the recovery read on conflict. */\n docID: number | string\n /**\n * Runs only when this call creates the row, inside the same transaction\n * as the row create — typically the accompanying\n * `payload-branch-changes` entry. Never called on the losing side, whose\n * caller already created (or is creating) its own.\n */\n onCreated: (req: PayloadRequest, shadow: Record<string, unknown>) => Promise<unknown>\n req: PayloadRequest\n /** Copies an exact logical source document instead of creating from data alone. */\n source?: ShadowSource\n /** Uses the request's existing transaction and leaves commit or rollback to its owner. */\n useAmbientTransaction?: boolean\n}\n\nconst isShadowUniquenessError = (error: unknown): error is ValidationError =>\n error instanceof ValidationError &&\n error.data.errors.some(({ path }) =>\n path\n .split(',')\n .map((fieldPath) => fieldPath.trim())\n .some(\n (fieldPath) =>\n fieldPath === branchDocIDField ||\n fieldPath === '_branch_doc_id' ||\n fieldPath === '_branchdocid_id' ||\n fieldPath === 'documentID' ||\n fieldPath === branchField,\n ),\n )\n\nconst isTransientTransactionError = (error: unknown): boolean => {\n if (isUnknownTransactionCommitResult(error)) {\n return false\n }\n\n if (!error || typeof error !== 'object') {\n return false\n }\n\n const labeledError = error as {\n errorLabels?: string[]\n hasErrorLabel?: (label: string) => boolean\n }\n\n return (\n labeledError.hasErrorLabel?.('TransientTransactionError') === true ||\n labeledError.errorLabels?.includes('TransientTransactionError') === true\n )\n}\n\nexport const isRecoverableConcurrentShadowError = (error: unknown): boolean =>\n isShadowUniquenessError(error) || isTransientTransactionError(error)\n\nconst concurrentShadowOperationErrors = new WeakSet<object>()\n\nconst markConcurrentShadowOperationError = (error: unknown): void => {\n if (error && typeof error === 'object') {\n concurrentShadowOperationErrors.add(error)\n }\n}\n\nexport const isConcurrentShadowOperationError = (error: unknown): boolean =>\n Boolean(error && typeof error === 'object' && concurrentShadowOperationErrors.has(error))\n\nconst maximumConcurrentShadowAttempts = 8\n\nexport const waitForConcurrentShadowRetry = async ({\n retryIndex,\n}: {\n retryIndex: number\n}): Promise<void> => {\n const delayMilliseconds = Math.min(25 * 2 ** retryIndex, 100)\n\n await new Promise((resolve) => setTimeout(resolve, delayMilliseconds))\n}\n\nexport const retryConcurrentShadowOperation = async <Result>({\n onRetry,\n operation,\n shouldRetry,\n waitForRetry = waitForConcurrentShadowRetry,\n}: {\n onRetry?: (args: { error: unknown; retryIndex: number }) => Promise<void> | void\n operation: () => Promise<Result>\n shouldRetry: ((args: { error: unknown }) => boolean) | boolean\n waitForRetry?: (args: { retryIndex: number }) => Promise<void>\n}): Promise<Result> => {\n for (let attemptIndex = 0; attemptIndex < maximumConcurrentShadowAttempts; attemptIndex++) {\n try {\n return await operation()\n } catch (error) {\n const hasAnotherAttempt = attemptIndex < maximumConcurrentShadowAttempts - 1\n const isRetryAllowed =\n typeof shouldRetry === 'function' ? shouldRetry({ error }) : shouldRetry\n\n if (!isRetryAllowed || !hasAnotherAttempt || !isRecoverableConcurrentShadowError(error)) {\n throw error\n }\n\n await onRetry?.({ error, retryIndex: attemptIndex })\n await waitForRetry({ retryIndex: attemptIndex })\n }\n }\n\n throw new Error('Concurrent shadow retry attempts were exhausted.')\n}\n\nexport const findCompetingShadow = async ({\n branch,\n collectionSlug,\n docID,\n operation,\n req,\n}: {\n branch: string\n collectionSlug: string\n docID: number | string\n operation?: BranchOperation\n req: PayloadRequest\n}): Promise<null | Record<string, unknown>> => {\n // A caller transaction keeps its earlier snapshot and cannot observe the winner. Read without\n // that transaction, and allow a short bounded period for the winner to become visible.\n const recoveryReq = isolateObjectProperty(req, ['transactionID'])\n\n delete recoveryReq.transactionID\n\n for (let attemptIndex = 0; attemptIndex < maximumConcurrentShadowAttempts; attemptIndex++) {\n if (attemptIndex > 0) {\n await waitForConcurrentShadowRetry({ retryIndex: attemptIndex - 1 })\n }\n\n const winner = (await req.payload.db.findOne({\n branch: false,\n collection: collectionSlug,\n req: recoveryReq,\n where: {\n and: [{ [branchField]: { equals: branch } }, { [branchDocIDField]: { equals: docID } }],\n },\n })) as null | Record<string, unknown>\n\n if (winner) {\n const change = await req.payload.db.findOne({\n collection: branchChangesCollectionSlug,\n req: recoveryReq,\n where: {\n and: [\n { branch: { equals: branch } },\n { collectionSlug: { equals: collectionSlug } },\n { documentID: { equals: String(docID) } },\n ],\n },\n })\n\n if (!change) {\n if (attemptIndex < maximumConcurrentShadowAttempts - 1) {\n continue\n }\n\n throw new APIError(\n `The ${collectionSlug} branch row for document ${String(docID)} has no change record.`,\n 409,\n )\n }\n\n const authoritativeOperation = (change as { operation?: BranchOperation }).operation\n\n if (operation && authoritativeOperation !== operation) {\n return null\n }\n\n return winner\n }\n }\n\n return null\n}\n\n/**\n * Creates a branch's shadow row for a document, safe against two concurrent\n * first-edits of the same document on the same branch racing to create it.\n *\n * The unique index on `(_branchDocID, _branch)` is what turns the losing side\n * into a rejection instead of a second, duplicate shadow row — but the create\n * runs in a transaction of its own, isolated from the caller's, rather than\n * the caller's ambient one. A losing race has to recover with a plain read,\n * and Postgres refuses any further command on a transaction once one\n * statement inside it fails — including that read — until it is rolled back.\n * A transaction of its own can be rolled back and moved past without\n * disturbing the write the caller is in the middle of.\n *\n * An operation that owns the request's existing transaction can opt into\n * creating the shadow and registry there instead. Errors on that path remain\n * with the operation owner, which can roll back and retry the full lifecycle.\n */\nexport const createShadowRow = async ({\n branch,\n collectionSlug,\n data,\n docID,\n onCreated,\n req,\n source,\n useAmbientTransaction = false,\n}: Args): Promise<Record<string, unknown>> => {\n if (useAmbientTransaction) {\n const ambient = isolateObjectProperty(req, ['file'])\n const transactionID = await ambient.transactionID\n\n if (!transactionID) {\n throw new Error('Ambient shadow creation requires an active transaction.')\n }\n\n shareFileOperationScope({ owner: req, req: ambient })\n\n try {\n const shadow = await createShadowContent({\n branch,\n collectionSlug,\n data,\n req: ambient,\n source,\n })\n\n await onCreated(ambient, shadow)\n\n return shadow\n } catch (error) {\n if (isRecoverableConcurrentShadowError(error)) {\n markConcurrentShadowOperationError(error)\n }\n\n throw error\n }\n }\n\n // Registry writes use the same request so that they share the branch fork's transaction.\n // A nested Local API create clears `req.file` when no file is supplied, so isolate that\n // property as well or an upload replacement disappears before the real branch update runs.\n const isolated = isolateObjectProperty(req, ['file', 'transactionID'])\n\n delete isolated.transactionID\n\n const shouldCommit = await initTransaction(isolated)\n\n if (!shouldCommit) {\n shareFileOperationScope({ owner: req, req: isolated })\n }\n\n let shadow: Record<string, unknown>\n\n try {\n shadow = await createShadowContent({\n branch,\n collectionSlug,\n data,\n req: isolated,\n source,\n })\n } catch (error) {\n await killTransaction(isolated)\n\n if (!isRecoverableConcurrentShadowError(error)) {\n throw error\n }\n\n const winner = await findCompetingShadow({ branch, collectionSlug, docID, req })\n\n if (!winner) {\n markConcurrentShadowOperationError(error)\n throw error\n }\n\n return winner\n }\n\n try {\n await onCreated(isolated, shadow)\n\n if (shouldCommit) {\n await commitTransaction(isolated)\n }\n\n return shadow\n } catch (error) {\n await killTransaction(isolated)\n\n if (shouldCommit && isRecoverableConcurrentShadowError(error)) {\n const winner = await findCompetingShadow({ branch, collectionSlug, docID, req })\n\n if (winner) {\n return winner\n }\n\n markConcurrentShadowOperationError(error)\n }\n\n const shadowID = shadow.id\n\n if (!shouldCommit && (typeof shadowID === 'string' || typeof shadowID === 'number')) {\n try {\n await isolated.payload.db.deleteOne({\n branch: false,\n collection: collectionSlug,\n req: isolated,\n where: { id: { equals: shadowID } },\n })\n } catch {\n // The callback error remains the reason this operation failed.\n }\n }\n\n throw error\n }\n}\n\nconst createShadowContent = async ({\n branch,\n collectionSlug,\n data,\n req,\n source,\n}: {\n branch: string\n collectionSlug: string\n data: Record<string, unknown>\n req: PayloadRequest\n source?: ShadowSource\n}): Promise<Record<string, unknown>> => {\n if (source) {\n return req.payload.db.copy({\n collection: collectionSlug,\n data: {\n ...data,\n [branchDocIDField]: source.id,\n [branchField]: branch,\n },\n req,\n where: {\n and: [\n { [branchField]: { equals: source.branch } },\n {\n or: [{ id: { equals: source.id } }, { [branchDocIDField]: { equals: source.id } }],\n },\n ],\n },\n }) as Promise<Record<string, unknown>>\n }\n\n return req.payload.db.create({\n collection: collectionSlug,\n data,\n req,\n }) as Promise<Record<string, unknown>>\n}\n"],"names":["APIError","ValidationError","shareFileOperationScope","commitTransaction","isUnknownTransactionCommitResult","initTransaction","isolateObjectProperty","killTransaction","branchChangesCollectionSlug","branchDocIDField","branchField","isShadowUniquenessError","error","data","errors","some","path","split","map","fieldPath","trim","isTransientTransactionError","labeledError","hasErrorLabel","errorLabels","includes","isRecoverableConcurrentShadowError","concurrentShadowOperationErrors","WeakSet","markConcurrentShadowOperationError","add","isConcurrentShadowOperationError","Boolean","has","maximumConcurrentShadowAttempts","waitForConcurrentShadowRetry","retryIndex","delayMilliseconds","Math","min","Promise","resolve","setTimeout","retryConcurrentShadowOperation","onRetry","operation","shouldRetry","waitForRetry","attemptIndex","hasAnotherAttempt","isRetryAllowed","Error","findCompetingShadow","branch","collectionSlug","docID","req","recoveryReq","transactionID","winner","payload","db","findOne","collection","where","and","equals","change","documentID","String","authoritativeOperation","createShadowRow","onCreated","source","useAmbientTransaction","ambient","owner","shadow","createShadowContent","isolated","shouldCommit","shadowID","id","deleteOne","copy","or","create"],"mappings":"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"}
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
import type { Payload, PayloadRequest } from '../types/index.js';
|
|
2
|
-
import type { BranchOperation } from './types.js';
|
|
3
|
-
export type DiscardedChange = {
|
|
4
|
-
changeID: number | string;
|
|
5
|
-
/** Absent for a global. */
|
|
6
|
-
collectionSlug?: string;
|
|
7
|
-
/** Absent for a global. */
|
|
8
|
-
docID?: number | string;
|
|
9
|
-
entityType: 'collection' | 'global';
|
|
10
|
-
globalSlug?: string;
|
|
11
|
-
operation: BranchOperation;
|
|
12
|
-
};
|
|
13
|
-
export type DiscardResult = {
|
|
14
|
-
discarded: DiscardedChange[];
|
|
15
|
-
};
|
|
16
|
-
export type DiscardOptions = {
|
|
17
|
-
branch: string;
|
|
18
|
-
/** Change IDs to discard. Omit to discard everything pending on the branch. */
|
|
19
|
-
changes?: (number | string)[];
|
|
20
|
-
/**
|
|
21
|
-
* Skip branch read and discard access checks.
|
|
22
|
-
*
|
|
23
|
-
* @default false
|
|
24
|
-
*/
|
|
25
|
-
overrideAccess?: boolean;
|
|
26
|
-
req?: PayloadRequest;
|
|
27
|
-
user?: NonNullable<PayloadRequest['user']>;
|
|
28
|
-
};
|
|
29
|
-
/**
|
|
30
|
-
* Throws away a branch's changes, returning the documents to main's state.
|
|
31
|
-
*
|
|
32
|
-
* The mirror of merge, and structurally simpler: merge has to reconcile with
|
|
33
|
-
* production, while discard only has to forget. Every operation reduces to the same
|
|
34
|
-
* act — drop the branch's row — because the branch's row *is* the change:
|
|
35
|
-
*
|
|
36
|
-
* - **create** — the row is the document, so dropping it removes it from the branch.
|
|
37
|
-
* - **update** — the row is the branch's copy, so dropping it makes the branch read
|
|
38
|
-
* through to main again.
|
|
39
|
-
* - **delete** — the row is the tombstone, so dropping it un-hides main's document.
|
|
40
|
-
*
|
|
41
|
-
* Nothing on `main` is touched in any of the three, which is why this needs no
|
|
42
|
-
* per-document preflight the way merge does (§13): a branch is a proposal, and
|
|
43
|
-
* withdrawing a proposal is not a production write.
|
|
44
|
-
*
|
|
45
|
-
* Before a branch-created row is removed, reference checks verify that no surviving
|
|
46
|
-
* document, global or version still points to it. Rows removed by the same discard
|
|
47
|
-
* are excluded from that check.
|
|
48
|
-
*/
|
|
49
|
-
export declare const discardBranchChanges: (payload: Payload, options: DiscardOptions) => Promise<DiscardResult>;
|
|
50
|
-
/** Removes all state for a branch that its owning collection row is about to delete. */
|
|
51
|
-
export declare const discardBranchChangesBeforeBranchDeletion: (payload: Payload, { branch, req }: Pick<DiscardOptions, 'branch' | 'req'>) => Promise<DiscardResult>;
|
|
52
|
-
//# sourceMappingURL=discard.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"discard.d.ts","sourceRoot":"","sources":["../../src/branching/discard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA+BjD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,UAAU,EAAE,YAAY,GAAG,QAAQ,CAAA;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,eAAe,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,eAAe,EAAE,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,IAAI,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;CAC3C,CAAA;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,YACtB,OAAO,WACP,cAAc,KACtB,OAAO,CAAC,aAAa,CACgE,CAAA;AAExF,wFAAwF;AACxF,eAAO,MAAM,wCAAwC,YAC1C,OAAO,mBACC,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,KAAK,CAAC,KACtD,OAAO,CAAC,aAAa,CAMpB,CAAA"}
|
|
@@ -1,428 +0,0 @@
|
|
|
1
|
-
import { deleteUploadFilesExclusiveToDocument } from '../uploads/deleteUploadFilesExclusiveToDocument.js';
|
|
2
|
-
import { collectStoredFiles, scheduleUnreferencedFileCleanup } from '../uploads/fileVersioning/cleanup.js';
|
|
3
|
-
import { commitTransaction } from '../utilities/commitTransaction.js';
|
|
4
|
-
import { createPayloadRequest } from '../utilities/createPayloadRequest.js';
|
|
5
|
-
import { initTransaction } from '../utilities/initTransaction.js';
|
|
6
|
-
import { killTransaction } from '../utilities/killTransaction.js';
|
|
7
|
-
import { beginDeferredCleanupScope, clearDeferredCleanupScope, flushDeferredCleanupScope } from '../utilities/transactionCallbacks.js';
|
|
8
|
-
import { assertBranchActionAccess } from './assertBranchActionAccess.js';
|
|
9
|
-
import { assertBranchCreatedDocumentsUnreferenced } from './assertBranchCreatedDocumentsUnreferenced.js';
|
|
10
|
-
import { assertBranchWritable } from './assertBranchWritable.js';
|
|
11
|
-
import { refreshBranchState, resetBranchState, withoutBranch } from './resolveBranch.js';
|
|
12
|
-
import { selectBranchChanges } from './selectBranchChanges.js';
|
|
13
|
-
import { branchChangesCollectionSlug, branchDocIDField, branchesCollectionSlug, branchField, branchParentField, MAIN_BRANCH } from './types.js';
|
|
14
|
-
import { deleteBranchGlobalVersionChain, deleteBranchVersionChain } from './versions.js';
|
|
15
|
-
/**
|
|
16
|
-
* Throws away a branch's changes, returning the documents to main's state.
|
|
17
|
-
*
|
|
18
|
-
* The mirror of merge, and structurally simpler: merge has to reconcile with
|
|
19
|
-
* production, while discard only has to forget. Every operation reduces to the same
|
|
20
|
-
* act — drop the branch's row — because the branch's row *is* the change:
|
|
21
|
-
*
|
|
22
|
-
* - **create** — the row is the document, so dropping it removes it from the branch.
|
|
23
|
-
* - **update** — the row is the branch's copy, so dropping it makes the branch read
|
|
24
|
-
* through to main again.
|
|
25
|
-
* - **delete** — the row is the tombstone, so dropping it un-hides main's document.
|
|
26
|
-
*
|
|
27
|
-
* Nothing on `main` is touched in any of the three, which is why this needs no
|
|
28
|
-
* per-document preflight the way merge does (§13): a branch is a proposal, and
|
|
29
|
-
* withdrawing a proposal is not a production write.
|
|
30
|
-
*
|
|
31
|
-
* Before a branch-created row is removed, reference checks verify that no surviving
|
|
32
|
-
* document, global or version still points to it. Rows removed by the same discard
|
|
33
|
-
* are excluded from that check.
|
|
34
|
-
*/ export const discardBranchChanges = async (payload, options)=>discardBranchChangesInternal(payload, {
|
|
35
|
-
...options,
|
|
36
|
-
shouldCheckBranchWritable: true
|
|
37
|
-
});
|
|
38
|
-
/** Removes all state for a branch that its owning collection row is about to delete. */ export const discardBranchChangesBeforeBranchDeletion = async (payload, { branch, req })=>discardBranchChangesInternal(payload, {
|
|
39
|
-
branch,
|
|
40
|
-
overrideAccess: true,
|
|
41
|
-
req,
|
|
42
|
-
shouldCheckBranchWritable: false
|
|
43
|
-
});
|
|
44
|
-
const discardBranchChangesInternal = async (payload, { branch, changes: selected, overrideAccess = false, req: incomingReq, shouldCheckBranchWritable, user })=>{
|
|
45
|
-
// `branch: false` throughout, as with merge: the rows being dropped are addressed
|
|
46
|
-
// by their real primary keys, so the read predicate must not be in the way.
|
|
47
|
-
const req = incomingReq ? withoutBranch(incomingReq) : await createPayloadRequest({
|
|
48
|
-
branch: false,
|
|
49
|
-
payload,
|
|
50
|
-
user
|
|
51
|
-
});
|
|
52
|
-
if (user && !req.user) {
|
|
53
|
-
req.user = user;
|
|
54
|
-
}
|
|
55
|
-
const branchDocs = await payload.find({
|
|
56
|
-
collection: branchesCollectionSlug,
|
|
57
|
-
limit: 1,
|
|
58
|
-
overrideAccess,
|
|
59
|
-
pagination: false,
|
|
60
|
-
req,
|
|
61
|
-
where: {
|
|
62
|
-
slug: {
|
|
63
|
-
equals: branch
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
});
|
|
67
|
-
if (!branchDocs.docs[0]) {
|
|
68
|
-
throw new Error(`Branch "${branch}" was not found.`);
|
|
69
|
-
}
|
|
70
|
-
const branchDoc = branchDocs.docs[0];
|
|
71
|
-
if (!overrideAccess) {
|
|
72
|
-
await assertBranchActionAccess({
|
|
73
|
-
action: 'discardBranch',
|
|
74
|
-
branchDoc,
|
|
75
|
-
req
|
|
76
|
-
});
|
|
77
|
-
}
|
|
78
|
-
// Discarding is a write, so a closed branch refuses it — its archive is a record,
|
|
79
|
-
// and a record that can be edited is not one.
|
|
80
|
-
if (shouldCheckBranchWritable) {
|
|
81
|
-
await assertBranchWritable({
|
|
82
|
-
branch,
|
|
83
|
-
req
|
|
84
|
-
});
|
|
85
|
-
}
|
|
86
|
-
const allChanges = await payload.find({
|
|
87
|
-
collection: branchChangesCollectionSlug,
|
|
88
|
-
overrideAccess: true,
|
|
89
|
-
pagination: false,
|
|
90
|
-
req,
|
|
91
|
-
sort: 'createdAt',
|
|
92
|
-
where: {
|
|
93
|
-
branch: {
|
|
94
|
-
equals: branch
|
|
95
|
-
}
|
|
96
|
-
}
|
|
97
|
-
});
|
|
98
|
-
const applicable = selectBranchChanges({
|
|
99
|
-
changes: allChanges.docs,
|
|
100
|
-
selected
|
|
101
|
-
});
|
|
102
|
-
const result = {
|
|
103
|
-
discarded: []
|
|
104
|
-
};
|
|
105
|
-
if (!applicable.length) {
|
|
106
|
-
return result;
|
|
107
|
-
}
|
|
108
|
-
// Gated on `req.transactionID`, not on whether a `req` was passed in: a discard
|
|
109
|
-
// triggered over HTTP hands in a `req` of its own that has no transaction on it
|
|
110
|
-
// yet, and it must get one just as much as a Local API call would.
|
|
111
|
-
const shouldCommit = await initTransaction(req);
|
|
112
|
-
const cleanupScope = await beginDeferredCleanupScope({
|
|
113
|
-
req
|
|
114
|
-
});
|
|
115
|
-
const uploadCleanupPlans = [];
|
|
116
|
-
const plannedUploadIdentities = new Set();
|
|
117
|
-
try {
|
|
118
|
-
const shadowsByChangeID = new Map();
|
|
119
|
-
const ignoredGlobalOwnerBranches = new Map();
|
|
120
|
-
const ignoredOwnerRowIDs = new Map();
|
|
121
|
-
for (const change of applicable){
|
|
122
|
-
if (change.entityType === 'global') {
|
|
123
|
-
if (typeof change.globalSlug === 'string') {
|
|
124
|
-
ignoredGlobalOwnerBranches.set(change.globalSlug, new Set([
|
|
125
|
-
branch
|
|
126
|
-
]));
|
|
127
|
-
}
|
|
128
|
-
continue;
|
|
129
|
-
}
|
|
130
|
-
const collectionSlug = change.collectionSlug;
|
|
131
|
-
const docID = change.doc?.value ?? change.doc;
|
|
132
|
-
const shadow = await payload.db.findOne({
|
|
133
|
-
branch: false,
|
|
134
|
-
collection: collectionSlug,
|
|
135
|
-
req,
|
|
136
|
-
where: {
|
|
137
|
-
and: [
|
|
138
|
-
{
|
|
139
|
-
[branchField]: {
|
|
140
|
-
equals: branch
|
|
141
|
-
}
|
|
142
|
-
},
|
|
143
|
-
{
|
|
144
|
-
or: [
|
|
145
|
-
{
|
|
146
|
-
id: {
|
|
147
|
-
equals: docID
|
|
148
|
-
}
|
|
149
|
-
},
|
|
150
|
-
{
|
|
151
|
-
[branchDocIDField]: {
|
|
152
|
-
equals: docID
|
|
153
|
-
}
|
|
154
|
-
}
|
|
155
|
-
]
|
|
156
|
-
}
|
|
157
|
-
]
|
|
158
|
-
}
|
|
159
|
-
});
|
|
160
|
-
shadowsByChangeID.set(String(change.id), shadow);
|
|
161
|
-
if (shadow?.id !== undefined && shadow.id !== null) {
|
|
162
|
-
const ignoredIDs = ignoredOwnerRowIDs.get(collectionSlug) ?? new Set();
|
|
163
|
-
ignoredIDs.add(shadow.id);
|
|
164
|
-
ignoredOwnerRowIDs.set(collectionSlug, ignoredIDs);
|
|
165
|
-
}
|
|
166
|
-
}
|
|
167
|
-
await assertBranchCreatedDocumentsUnreferenced({
|
|
168
|
-
ignoredGlobalOwnerBranches,
|
|
169
|
-
ignoredOwnerBranch: selected ? undefined : branch,
|
|
170
|
-
ignoredOwnerRowIDs,
|
|
171
|
-
req,
|
|
172
|
-
targets: applicable.flatMap((change)=>{
|
|
173
|
-
if (change.entityType === 'global' || change.operation !== 'create' || typeof change.collectionSlug !== 'string') {
|
|
174
|
-
return [];
|
|
175
|
-
}
|
|
176
|
-
const docID = change.doc?.value ?? change.doc;
|
|
177
|
-
return typeof docID === 'number' || typeof docID === 'string' ? [
|
|
178
|
-
{
|
|
179
|
-
collectionSlug: change.collectionSlug,
|
|
180
|
-
docID
|
|
181
|
-
}
|
|
182
|
-
] : [];
|
|
183
|
-
})
|
|
184
|
-
});
|
|
185
|
-
for (const change of applicable){
|
|
186
|
-
// A global has no shadow row to look up and no tombstone to undo: its branch copy
|
|
187
|
-
// *is* the change, so dropping the copy is the entire discard, and the branch reads
|
|
188
|
-
// through to main again immediately.
|
|
189
|
-
if (change.entityType === 'global') {
|
|
190
|
-
const globalSlug = change.globalSlug;
|
|
191
|
-
if (!payload.db.deleteBranchGlobal) {
|
|
192
|
-
throw new Error(`The database adapter cannot remove a branch's copy of a global, so "${globalSlug}" cannot be discarded.`);
|
|
193
|
-
}
|
|
194
|
-
await deleteBranchGlobalVersionChain({
|
|
195
|
-
branch,
|
|
196
|
-
globalSlug,
|
|
197
|
-
payload,
|
|
198
|
-
req
|
|
199
|
-
});
|
|
200
|
-
await payload.db.deleteBranchGlobal({
|
|
201
|
-
branch,
|
|
202
|
-
globalSlug,
|
|
203
|
-
req
|
|
204
|
-
});
|
|
205
|
-
await payload.delete({
|
|
206
|
-
id: change.id,
|
|
207
|
-
collection: branchChangesCollectionSlug,
|
|
208
|
-
overrideAccess: true,
|
|
209
|
-
req
|
|
210
|
-
});
|
|
211
|
-
result.discarded.push({
|
|
212
|
-
changeID: change.id,
|
|
213
|
-
entityType: 'global',
|
|
214
|
-
globalSlug,
|
|
215
|
-
operation: 'update'
|
|
216
|
-
});
|
|
217
|
-
continue;
|
|
218
|
-
}
|
|
219
|
-
const collectionSlug = change.collectionSlug;
|
|
220
|
-
const docID = change.doc?.value ?? change.doc;
|
|
221
|
-
const shadow = shadowsByChangeID.get(String(change.id));
|
|
222
|
-
if (shadow) {
|
|
223
|
-
const collectionConfig = payload.collections[collectionSlug].config;
|
|
224
|
-
if (collectionConfig.upload) {
|
|
225
|
-
const retainedDoc = change.operation === 'create' ? null : await payload.db.findOne({
|
|
226
|
-
branch: false,
|
|
227
|
-
collection: collectionSlug,
|
|
228
|
-
req,
|
|
229
|
-
where: {
|
|
230
|
-
and: [
|
|
231
|
-
{
|
|
232
|
-
[branchField]: {
|
|
233
|
-
equals: MAIN_BRANCH
|
|
234
|
-
}
|
|
235
|
-
},
|
|
236
|
-
{
|
|
237
|
-
id: {
|
|
238
|
-
equals: docID
|
|
239
|
-
}
|
|
240
|
-
}
|
|
241
|
-
]
|
|
242
|
-
}
|
|
243
|
-
});
|
|
244
|
-
const versionDocuments = await readBranchVersionDocuments({
|
|
245
|
-
branch,
|
|
246
|
-
collectionSlug,
|
|
247
|
-
payload,
|
|
248
|
-
req,
|
|
249
|
-
rowID: shadow.id
|
|
250
|
-
});
|
|
251
|
-
const sourceDocuments = change.operation === 'create' ? versionDocuments : [
|
|
252
|
-
shadow,
|
|
253
|
-
...versionDocuments
|
|
254
|
-
];
|
|
255
|
-
if (change.operation === 'create') {
|
|
256
|
-
plannedUploadIdentities.add(`${collectionSlug}:${getUploadIdentity(shadow)}`);
|
|
257
|
-
}
|
|
258
|
-
for (const sourceDoc of sourceDocuments){
|
|
259
|
-
const identity = `${collectionSlug}:${getUploadIdentity(sourceDoc)}`;
|
|
260
|
-
if (!plannedUploadIdentities.has(identity)) {
|
|
261
|
-
plannedUploadIdentities.add(identity);
|
|
262
|
-
uploadCleanupPlans.push({
|
|
263
|
-
collectionSlug,
|
|
264
|
-
retainedDoc,
|
|
265
|
-
sourceDoc
|
|
266
|
-
});
|
|
267
|
-
}
|
|
268
|
-
}
|
|
269
|
-
}
|
|
270
|
-
if (change.operation === 'create') {
|
|
271
|
-
await payload.delete({
|
|
272
|
-
id: shadow.id,
|
|
273
|
-
branch: false,
|
|
274
|
-
collection: collectionSlug,
|
|
275
|
-
overrideAccess: true,
|
|
276
|
-
req,
|
|
277
|
-
trash: true
|
|
278
|
-
});
|
|
279
|
-
} else {
|
|
280
|
-
await deleteBranchVersionChain({
|
|
281
|
-
branch,
|
|
282
|
-
collectionSlug,
|
|
283
|
-
payload,
|
|
284
|
-
req,
|
|
285
|
-
rowID: shadow.id
|
|
286
|
-
});
|
|
287
|
-
await payload.db.deleteOne({
|
|
288
|
-
branch: false,
|
|
289
|
-
collection: collectionSlug,
|
|
290
|
-
req,
|
|
291
|
-
where: {
|
|
292
|
-
id: {
|
|
293
|
-
equals: shadow.id
|
|
294
|
-
}
|
|
295
|
-
}
|
|
296
|
-
});
|
|
297
|
-
}
|
|
298
|
-
}
|
|
299
|
-
await payload.delete({
|
|
300
|
-
id: change.id,
|
|
301
|
-
collection: branchChangesCollectionSlug,
|
|
302
|
-
overrideAccess: true,
|
|
303
|
-
req
|
|
304
|
-
});
|
|
305
|
-
result.discarded.push({
|
|
306
|
-
changeID: change.id,
|
|
307
|
-
collectionSlug,
|
|
308
|
-
docID: docID,
|
|
309
|
-
entityType: 'collection',
|
|
310
|
-
operation: change.operation
|
|
311
|
-
});
|
|
312
|
-
}
|
|
313
|
-
for (const { collectionSlug, retainedDoc, sourceDoc } of uploadCleanupPlans){
|
|
314
|
-
const collectionConfig = payload.collections[collectionSlug].config;
|
|
315
|
-
const candidates = await collectStoredFiles({
|
|
316
|
-
collection: collectionConfig,
|
|
317
|
-
doc: sourceDoc,
|
|
318
|
-
req
|
|
319
|
-
});
|
|
320
|
-
if (candidates.length) {
|
|
321
|
-
await scheduleUnreferencedFileCleanup({
|
|
322
|
-
candidates,
|
|
323
|
-
collection: collectionConfig,
|
|
324
|
-
req
|
|
325
|
-
});
|
|
326
|
-
if (!collectionConfig.upload.fileOperations) {
|
|
327
|
-
await collectionConfig.upload.deleteFiles?.({
|
|
328
|
-
req,
|
|
329
|
-
retainedDoc,
|
|
330
|
-
sourceDoc
|
|
331
|
-
});
|
|
332
|
-
}
|
|
333
|
-
} else {
|
|
334
|
-
await deleteUploadFilesExclusiveToDocument({
|
|
335
|
-
collectionConfig,
|
|
336
|
-
config: payload.config,
|
|
337
|
-
req,
|
|
338
|
-
retainedDoc,
|
|
339
|
-
sourceDoc
|
|
340
|
-
});
|
|
341
|
-
}
|
|
342
|
-
}
|
|
343
|
-
if (cleanupScope) {
|
|
344
|
-
await flushDeferredCleanupScope({
|
|
345
|
-
req,
|
|
346
|
-
scope: cleanupScope
|
|
347
|
-
});
|
|
348
|
-
}
|
|
349
|
-
if (shouldCommit) {
|
|
350
|
-
await commitTransaction(req);
|
|
351
|
-
}
|
|
352
|
-
} catch (error) {
|
|
353
|
-
if (cleanupScope) {
|
|
354
|
-
clearDeferredCleanupScope({
|
|
355
|
-
req,
|
|
356
|
-
scope: cleanupScope
|
|
357
|
-
});
|
|
358
|
-
}
|
|
359
|
-
if (shouldCommit) {
|
|
360
|
-
await killTransaction(req);
|
|
361
|
-
}
|
|
362
|
-
throw error;
|
|
363
|
-
} finally{
|
|
364
|
-
if (incomingReq) {
|
|
365
|
-
refreshBranchState(incomingReq);
|
|
366
|
-
}
|
|
367
|
-
}
|
|
368
|
-
// The manifest this request memoized still lists the discarded documents as
|
|
369
|
-
// shadowed, which would hide main's copies from any later read on this request.
|
|
370
|
-
resetBranchState(req);
|
|
371
|
-
return result;
|
|
372
|
-
};
|
|
373
|
-
const readBranchVersionDocuments = async ({ branch, collectionSlug, payload, req, rowID })=>{
|
|
374
|
-
if (!payload.collections[collectionSlug]?.config.versions) {
|
|
375
|
-
return [];
|
|
376
|
-
}
|
|
377
|
-
const { docs } = await payload.db.findVersions({
|
|
378
|
-
branch: false,
|
|
379
|
-
collection: collectionSlug,
|
|
380
|
-
limit: 0,
|
|
381
|
-
pagination: false,
|
|
382
|
-
req,
|
|
383
|
-
where: {
|
|
384
|
-
and: [
|
|
385
|
-
{
|
|
386
|
-
parent: {
|
|
387
|
-
equals: rowID
|
|
388
|
-
}
|
|
389
|
-
},
|
|
390
|
-
{
|
|
391
|
-
[branchField]: {
|
|
392
|
-
equals: branch
|
|
393
|
-
}
|
|
394
|
-
},
|
|
395
|
-
{
|
|
396
|
-
[branchParentField]: {
|
|
397
|
-
exists: true
|
|
398
|
-
}
|
|
399
|
-
}
|
|
400
|
-
]
|
|
401
|
-
}
|
|
402
|
-
});
|
|
403
|
-
return docs.flatMap((version)=>version.version && typeof version.version === 'object' && !Array.isArray(version.version) ? [
|
|
404
|
-
version.version
|
|
405
|
-
] : []);
|
|
406
|
-
};
|
|
407
|
-
const getUploadIdentity = (doc)=>{
|
|
408
|
-
const variantFilenames = doc.variants && typeof doc.variants === 'object' && !Array.isArray(doc.variants) ? Object.entries(doc.variants).flatMap(([name, variant])=>{
|
|
409
|
-
if (!variant || typeof variant !== 'object' || Array.isArray(variant)) {
|
|
410
|
-
return [];
|
|
411
|
-
}
|
|
412
|
-
const filename = variant.filename;
|
|
413
|
-
return typeof filename === 'string' ? [
|
|
414
|
-
[
|
|
415
|
-
name,
|
|
416
|
-
filename
|
|
417
|
-
]
|
|
418
|
-
] : [];
|
|
419
|
-
}).sort(([left], [right])=>left.localeCompare(right)) : [];
|
|
420
|
-
return JSON.stringify({
|
|
421
|
-
filename: doc.filename,
|
|
422
|
-
objectKey: doc._objectKey,
|
|
423
|
-
prefix: doc.prefix,
|
|
424
|
-
variants: variantFilenames
|
|
425
|
-
});
|
|
426
|
-
};
|
|
427
|
-
|
|
428
|
-
//# sourceMappingURL=discard.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/branching/discard.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from '../types/index.js'\nimport type { BranchOperation } from './types.js'\n\nimport { deleteUploadFilesExclusiveToDocument } from '../uploads/deleteUploadFilesExclusiveToDocument.js'\nimport {\n collectStoredFiles,\n scheduleUnreferencedFileCleanup,\n} from '../uploads/fileVersioning/cleanup.js'\nimport { commitTransaction } from '../utilities/commitTransaction.js'\nimport { createPayloadRequest } from '../utilities/createPayloadRequest.js'\nimport { initTransaction } from '../utilities/initTransaction.js'\nimport { killTransaction } from '../utilities/killTransaction.js'\nimport {\n beginDeferredCleanupScope,\n clearDeferredCleanupScope,\n flushDeferredCleanupScope,\n} from '../utilities/transactionCallbacks.js'\nimport { assertBranchActionAccess } from './assertBranchActionAccess.js'\nimport { assertBranchCreatedDocumentsUnreferenced } from './assertBranchCreatedDocumentsUnreferenced.js'\nimport { assertBranchWritable } from './assertBranchWritable.js'\nimport { refreshBranchState, resetBranchState, withoutBranch } from './resolveBranch.js'\nimport { selectBranchChanges } from './selectBranchChanges.js'\nimport {\n branchChangesCollectionSlug,\n branchDocIDField,\n branchesCollectionSlug,\n branchField,\n branchParentField,\n MAIN_BRANCH,\n} from './types.js'\nimport { deleteBranchGlobalVersionChain, deleteBranchVersionChain } from './versions.js'\n\nexport type DiscardedChange = {\n changeID: number | string\n /** Absent for a global. */\n collectionSlug?: string\n /** Absent for a global. */\n docID?: number | string\n entityType: 'collection' | 'global'\n globalSlug?: string\n operation: BranchOperation\n}\n\nexport type DiscardResult = {\n discarded: DiscardedChange[]\n}\n\nexport type DiscardOptions = {\n branch: string\n /** Change IDs to discard. Omit to discard everything pending on the branch. */\n changes?: (number | string)[]\n /**\n * Skip branch read and discard access checks.\n *\n * @default false\n */\n overrideAccess?: boolean\n req?: PayloadRequest\n user?: NonNullable<PayloadRequest['user']>\n}\n\ntype DiscardInternalOptions = {\n shouldCheckBranchWritable: boolean\n} & DiscardOptions\n\n/**\n * Throws away a branch's changes, returning the documents to main's state.\n *\n * The mirror of merge, and structurally simpler: merge has to reconcile with\n * production, while discard only has to forget. Every operation reduces to the same\n * act — drop the branch's row — because the branch's row *is* the change:\n *\n * - **create** — the row is the document, so dropping it removes it from the branch.\n * - **update** — the row is the branch's copy, so dropping it makes the branch read\n * through to main again.\n * - **delete** — the row is the tombstone, so dropping it un-hides main's document.\n *\n * Nothing on `main` is touched in any of the three, which is why this needs no\n * per-document preflight the way merge does (§13): a branch is a proposal, and\n * withdrawing a proposal is not a production write.\n *\n * Before a branch-created row is removed, reference checks verify that no surviving\n * document, global or version still points to it. Rows removed by the same discard\n * are excluded from that check.\n */\nexport const discardBranchChanges = async (\n payload: Payload,\n options: DiscardOptions,\n): Promise<DiscardResult> =>\n discardBranchChangesInternal(payload, { ...options, shouldCheckBranchWritable: true })\n\n/** Removes all state for a branch that its owning collection row is about to delete. */\nexport const discardBranchChangesBeforeBranchDeletion = async (\n payload: Payload,\n { branch, req }: Pick<DiscardOptions, 'branch' | 'req'>,\n): Promise<DiscardResult> =>\n discardBranchChangesInternal(payload, {\n branch,\n overrideAccess: true,\n req,\n shouldCheckBranchWritable: false,\n })\n\nconst discardBranchChangesInternal = async (\n payload: Payload,\n {\n branch,\n changes: selected,\n overrideAccess = false,\n req: incomingReq,\n shouldCheckBranchWritable,\n user,\n }: DiscardInternalOptions,\n): Promise<DiscardResult> => {\n // `branch: false` throughout, as with merge: the rows being dropped are addressed\n // by their real primary keys, so the read predicate must not be in the way.\n const req = incomingReq\n ? withoutBranch(incomingReq)\n : await createPayloadRequest({ branch: false, payload, user })\n\n if (user && !req.user) {\n req.user = user\n }\n\n const branchDocs = await payload.find({\n collection: branchesCollectionSlug,\n limit: 1,\n overrideAccess,\n pagination: false,\n req,\n where: { slug: { equals: branch } },\n })\n\n if (!branchDocs.docs[0]) {\n throw new Error(`Branch \"${branch}\" was not found.`)\n }\n\n const branchDoc = branchDocs.docs[0]\n\n if (!overrideAccess) {\n await assertBranchActionAccess({ action: 'discardBranch', branchDoc, req })\n }\n\n // Discarding is a write, so a closed branch refuses it — its archive is a record,\n // and a record that can be edited is not one.\n if (shouldCheckBranchWritable) {\n await assertBranchWritable({ branch, req })\n }\n\n const allChanges = await payload.find({\n collection: branchChangesCollectionSlug,\n overrideAccess: true,\n pagination: false,\n req,\n sort: 'createdAt',\n where: {\n branch: { equals: branch },\n },\n })\n\n const applicable = selectBranchChanges({ changes: allChanges.docs, selected })\n\n const result: DiscardResult = { discarded: [] }\n\n if (!applicable.length) {\n return result\n }\n\n // Gated on `req.transactionID`, not on whether a `req` was passed in: a discard\n // triggered over HTTP hands in a `req` of its own that has no transaction on it\n // yet, and it must get one just as much as a Local API call would.\n const shouldCommit = await initTransaction(req)\n const cleanupScope = await beginDeferredCleanupScope({ req })\n const uploadCleanupPlans: {\n collectionSlug: string\n retainedDoc: null | Record<string, unknown>\n sourceDoc: Record<string, unknown>\n }[] = []\n const plannedUploadIdentities = new Set<string>()\n\n try {\n const shadowsByChangeID = new Map<string, null | Record<string, unknown>>()\n const ignoredGlobalOwnerBranches = new Map<string, Set<string>>()\n const ignoredOwnerRowIDs = new Map<string, Set<number | string>>()\n\n for (const change of applicable) {\n if (change.entityType === 'global') {\n if (typeof change.globalSlug === 'string') {\n ignoredGlobalOwnerBranches.set(change.globalSlug, new Set([branch]))\n }\n\n continue\n }\n\n const collectionSlug = change.collectionSlug as string\n const docID = (change.doc as { value?: number | string })?.value ?? change.doc\n const shadow = (await payload.db.findOne({\n branch: false,\n collection: collectionSlug,\n req,\n where: {\n and: [\n { [branchField]: { equals: branch } },\n { or: [{ id: { equals: docID } }, { [branchDocIDField]: { equals: docID } }] },\n ],\n },\n })) as null | Record<string, unknown>\n\n shadowsByChangeID.set(String(change.id), shadow)\n\n if (shadow?.id !== undefined && shadow.id !== null) {\n const ignoredIDs = ignoredOwnerRowIDs.get(collectionSlug) ?? new Set<number | string>()\n\n ignoredIDs.add(shadow.id as number | string)\n ignoredOwnerRowIDs.set(collectionSlug, ignoredIDs)\n }\n }\n\n await assertBranchCreatedDocumentsUnreferenced({\n ignoredGlobalOwnerBranches,\n ignoredOwnerBranch: selected ? undefined : branch,\n ignoredOwnerRowIDs,\n req,\n targets: applicable.flatMap((change) => {\n if (\n change.entityType === 'global' ||\n change.operation !== 'create' ||\n typeof change.collectionSlug !== 'string'\n ) {\n return []\n }\n\n const docID = (change.doc as { value?: number | string })?.value ?? change.doc\n\n return typeof docID === 'number' || typeof docID === 'string'\n ? [{ collectionSlug: change.collectionSlug, docID }]\n : []\n }),\n })\n\n for (const change of applicable) {\n // A global has no shadow row to look up and no tombstone to undo: its branch copy\n // *is* the change, so dropping the copy is the entire discard, and the branch reads\n // through to main again immediately.\n if (change.entityType === 'global') {\n const globalSlug = change.globalSlug as string\n\n if (!payload.db.deleteBranchGlobal) {\n throw new Error(\n `The database adapter cannot remove a branch's copy of a global, so \"${globalSlug}\" cannot be discarded.`,\n )\n }\n\n await deleteBranchGlobalVersionChain({ branch, globalSlug, payload, req })\n await payload.db.deleteBranchGlobal({ branch, globalSlug, req })\n\n await payload.delete({\n id: change.id,\n collection: branchChangesCollectionSlug,\n overrideAccess: true,\n req,\n })\n\n result.discarded.push({\n changeID: change.id,\n entityType: 'global',\n globalSlug,\n operation: 'update',\n })\n\n continue\n }\n\n const collectionSlug = change.collectionSlug as string\n const docID = (change.doc as { value?: number | string })?.value ?? change.doc\n const shadow = shadowsByChangeID.get(String(change.id))\n\n if (shadow) {\n const collectionConfig = payload.collections[collectionSlug]!.config\n\n if (collectionConfig.upload) {\n const retainedDoc =\n change.operation === 'create'\n ? null\n : ((await payload.db.findOne({\n branch: false,\n collection: collectionSlug,\n req,\n where: {\n and: [{ [branchField]: { equals: MAIN_BRANCH } }, { id: { equals: docID } }],\n },\n })) as null | Record<string, unknown>)\n const versionDocuments = await readBranchVersionDocuments({\n branch,\n collectionSlug,\n payload,\n req,\n rowID: shadow.id as number | string,\n })\n const sourceDocuments =\n change.operation === 'create' ? versionDocuments : [shadow, ...versionDocuments]\n\n if (change.operation === 'create') {\n plannedUploadIdentities.add(`${collectionSlug}:${getUploadIdentity(shadow)}`)\n }\n\n for (const sourceDoc of sourceDocuments) {\n const identity = `${collectionSlug}:${getUploadIdentity(sourceDoc)}`\n\n if (!plannedUploadIdentities.has(identity)) {\n plannedUploadIdentities.add(identity)\n uploadCleanupPlans.push({ collectionSlug, retainedDoc, sourceDoc })\n }\n }\n }\n\n if (change.operation === 'create') {\n await payload.delete({\n id: shadow.id as number | string,\n branch: false,\n collection: collectionSlug,\n overrideAccess: true,\n req,\n trash: true,\n })\n } else {\n await deleteBranchVersionChain({\n branch,\n collectionSlug,\n payload,\n req,\n rowID: shadow.id as number | string,\n })\n\n await payload.db.deleteOne({\n branch: false,\n collection: collectionSlug,\n req,\n where: { id: { equals: shadow.id } },\n })\n }\n }\n\n await payload.delete({\n id: change.id,\n collection: branchChangesCollectionSlug,\n overrideAccess: true,\n req,\n })\n\n result.discarded.push({\n changeID: change.id,\n collectionSlug,\n docID: docID as number | string,\n entityType: 'collection',\n operation: change.operation as BranchOperation,\n })\n }\n\n for (const { collectionSlug, retainedDoc, sourceDoc } of uploadCleanupPlans) {\n const collectionConfig = payload.collections[collectionSlug]!.config\n const candidates = await collectStoredFiles({\n collection: collectionConfig,\n doc: sourceDoc,\n req,\n })\n\n if (candidates.length) {\n await scheduleUnreferencedFileCleanup({ candidates, collection: collectionConfig, req })\n\n if (!collectionConfig.upload.fileOperations) {\n await collectionConfig.upload.deleteFiles?.({ req, retainedDoc, sourceDoc })\n }\n } else {\n await deleteUploadFilesExclusiveToDocument({\n collectionConfig,\n config: payload.config,\n req,\n retainedDoc,\n sourceDoc,\n })\n }\n }\n\n if (cleanupScope) {\n await flushDeferredCleanupScope({ req, scope: cleanupScope })\n }\n if (shouldCommit) {\n await commitTransaction(req)\n }\n } catch (error) {\n if (cleanupScope) {\n clearDeferredCleanupScope({ req, scope: cleanupScope })\n }\n\n if (shouldCommit) {\n await killTransaction(req)\n }\n throw error\n } finally {\n if (incomingReq) {\n refreshBranchState(incomingReq)\n }\n }\n\n // The manifest this request memoized still lists the discarded documents as\n // shadowed, which would hide main's copies from any later read on this request.\n resetBranchState(req)\n\n return result\n}\n\nconst readBranchVersionDocuments = async ({\n branch,\n collectionSlug,\n payload,\n req,\n rowID,\n}: {\n branch: string\n collectionSlug: string\n payload: Payload\n req: PayloadRequest\n rowID: number | string\n}): Promise<Record<string, unknown>[]> => {\n if (!payload.collections[collectionSlug]?.config.versions) {\n return []\n }\n\n const { docs } = await payload.db.findVersions({\n branch: false,\n collection: collectionSlug,\n limit: 0,\n pagination: false,\n req,\n where: {\n and: [\n { parent: { equals: rowID } },\n { [branchField]: { equals: branch } },\n { [branchParentField]: { exists: true } },\n ],\n },\n })\n\n return docs.flatMap((version) =>\n version.version && typeof version.version === 'object' && !Array.isArray(version.version)\n ? [version.version as Record<string, unknown>]\n : [],\n )\n}\n\nconst getUploadIdentity = (doc: Record<string, unknown>): string => {\n const variantFilenames =\n doc.variants && typeof doc.variants === 'object' && !Array.isArray(doc.variants)\n ? Object.entries(doc.variants)\n .flatMap(([name, variant]) => {\n if (!variant || typeof variant !== 'object' || Array.isArray(variant)) {\n return []\n }\n\n const filename = (variant as Record<string, unknown>).filename\n\n return typeof filename === 'string' ? [[name, filename] as [string, string]] : []\n })\n .sort(([left], [right]) => left.localeCompare(right))\n : []\n\n return JSON.stringify({\n filename: doc.filename,\n objectKey: doc._objectKey,\n prefix: doc.prefix,\n variants: variantFilenames,\n })\n}\n"],"names":["deleteUploadFilesExclusiveToDocument","collectStoredFiles","scheduleUnreferencedFileCleanup","commitTransaction","createPayloadRequest","initTransaction","killTransaction","beginDeferredCleanupScope","clearDeferredCleanupScope","flushDeferredCleanupScope","assertBranchActionAccess","assertBranchCreatedDocumentsUnreferenced","assertBranchWritable","refreshBranchState","resetBranchState","withoutBranch","selectBranchChanges","branchChangesCollectionSlug","branchDocIDField","branchesCollectionSlug","branchField","branchParentField","MAIN_BRANCH","deleteBranchGlobalVersionChain","deleteBranchVersionChain","discardBranchChanges","payload","options","discardBranchChangesInternal","shouldCheckBranchWritable","discardBranchChangesBeforeBranchDeletion","branch","req","overrideAccess","changes","selected","incomingReq","user","branchDocs","find","collection","limit","pagination","where","slug","equals","docs","Error","branchDoc","action","allChanges","sort","applicable","result","discarded","length","shouldCommit","cleanupScope","uploadCleanupPlans","plannedUploadIdentities","Set","shadowsByChangeID","Map","ignoredGlobalOwnerBranches","ignoredOwnerRowIDs","change","entityType","globalSlug","set","collectionSlug","docID","doc","value","shadow","db","findOne","and","or","id","String","undefined","ignoredIDs","get","add","ignoredOwnerBranch","targets","flatMap","operation","deleteBranchGlobal","delete","push","changeID","collectionConfig","collections","config","upload","retainedDoc","versionDocuments","readBranchVersionDocuments","rowID","sourceDocuments","getUploadIdentity","sourceDoc","identity","has","trash","deleteOne","candidates","fileOperations","deleteFiles","scope","error","versions","findVersions","parent","exists","version","Array","isArray","variantFilenames","variants","Object","entries","name","variant","filename","left","right","localeCompare","JSON","stringify","objectKey","_objectKey","prefix"],"mappings":"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"}
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
import type { Payload, PayloadRequest } from '../types/index.js';
|
|
2
|
-
/**
|
|
3
|
-
* What a change will actually do to `main` when merged, which is not always what
|
|
4
|
-
* it did on the branch. Editing a published document on a branch is a `publish`
|
|
5
|
-
* against main and needs publish permission; saving a draft on that same
|
|
6
|
-
* document is an ordinary `update` that must leave main's published row alone.
|
|
7
|
-
*/
|
|
8
|
-
export type EffectiveOperation = 'create' | 'delete' | 'publish' | 'update';
|
|
9
|
-
/** One write against main for the selected source state or its Trash transition. */
|
|
10
|
-
export type EffectiveWrite = {
|
|
11
|
-
/** The document state to write. */
|
|
12
|
-
data: Record<string, unknown>;
|
|
13
|
-
/** Whether the write is a draft save rather than a publish. */
|
|
14
|
-
draft: boolean;
|
|
15
|
-
operation: EffectiveOperation;
|
|
16
|
-
/**
|
|
17
|
-
* A row-level Trash transition that accompanies versioned content.
|
|
18
|
-
*
|
|
19
|
-
* `apply` updates main. `access` only adds the required permission check
|
|
20
|
-
* because a later published write already carries the same `deletedAt` state.
|
|
21
|
-
*/
|
|
22
|
-
trashState?: 'access' | 'apply';
|
|
23
|
-
};
|
|
24
|
-
export type ResolvedChange = {
|
|
25
|
-
change: Record<string, any>;
|
|
26
|
-
collectionSlug: string;
|
|
27
|
-
docID: number | string;
|
|
28
|
-
shadow: null | Record<string, unknown>;
|
|
29
|
-
/** The latest source-state write and any separate Trash transition. */
|
|
30
|
-
writes: EffectiveWrite[];
|
|
31
|
-
};
|
|
32
|
-
/**
|
|
33
|
-
* Resolves what each pending change will do to main.
|
|
34
|
-
*
|
|
35
|
-
* The shadow row alone cannot answer this. A fork copies main's row wholesale, so
|
|
36
|
-
* a document forked from a published main row carries `_status: 'published'` even
|
|
37
|
-
* when every edit made on the branch was a draft save — and draft saves never
|
|
38
|
-
* touch the main row (§7), so the row still holds main's own pre-fork values.
|
|
39
|
-
* Reading only the row therefore reports a `publish` of values main already has:
|
|
40
|
-
* a merge that claims success and changes nothing.
|
|
41
|
-
*
|
|
42
|
-
* The branch's newest *version* is the missing half. `baseUpdatedAt`, recorded on
|
|
43
|
-
* the registry row at fork time, separates the two cases the row cannot: the
|
|
44
|
-
* shadow row's `updatedAt` still matching it means the branch never published,
|
|
45
|
-
* because only a publish rewrites that row.
|
|
46
|
-
*/
|
|
47
|
-
export declare const resolveEffectiveOperations: ({ branch, changes, payload, req, }: {
|
|
48
|
-
branch: string;
|
|
49
|
-
changes: Record<string, any>[];
|
|
50
|
-
payload: Payload;
|
|
51
|
-
req: PayloadRequest;
|
|
52
|
-
}) => Promise<ResolvedChange[]>;
|
|
53
|
-
/** The distinct operations a change needs permission for. */
|
|
54
|
-
export declare const operationsForChange: (resolved: ResolvedChange) => EffectiveOperation[];
|
|
55
|
-
//# sourceMappingURL=effectiveOperations.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"effectiveOperations.d.ts","sourceRoot":"","sources":["../../src/branching/effectiveOperations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAS,MAAM,mBAAmB,CAAA;AAUvE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE3E,oFAAoF;AACpF,MAAM,MAAM,cAAc,GAAG;IAC3B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,kBAAkB,CAAA;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,uEAAuE;IACvE,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B,uCAKpC;IACD,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAA;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,cAAc,CAAA;CACpB,KAAG,OAAO,CAAC,cAAc,EAAE,CA0B3B,CAAA;AA6bD,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,aAAc,cAAc,KAAG,kBAAkB,EAEhF,CAAA"}
|