decap-cms-lib-util 3.8.2 → 3.9.0-beta.0

package/dist/esm/backendUtil.js

@@ -91,4 +91,29 @@ export async function getAllResponses(url, options = {}, linkHeaderRelName, next
 export function getPathDepth(path) {
   const depth = path.split('/').length;
   return depth;
+}
+
+/**
+ * Stable cache key for a files collection.
+ *
+ * decap-cms-core's `entriesByFiles` receives only the file list, never the
+ * collection name, so a backend that caches such a collection has to derive an
+ * identity from the paths themselves.
+ *
+ * Sorted before hashing so key identity does not depend on the order files
+ * happen to be listed in config.yml — reordering them must not orphan the
+ * cached rows. Hashed so a collection of many paths does not become a
+ * multi-kilobyte value repeated on every cached row.
+ *
+ * FNV-1a rather than a crypto digest: this needs to be deterministic, short and
+ * synchronous, not unforgeable. It lives here rather than in one backend
+ * because both Turbo backends need exactly the same key.
+ */
+export function collectionKeyForFiles(paths) {
+  let hash = 0x811c9dc5;
+  for (const char of [...paths].sort().join('\n')) {
+    hash ^= char.charCodeAt(0);
+    hash = Math.imul(hash, 0x01000193) >>> 0;
+  }
+  return `files:${paths.length}:${hash.toString(36)}`;
 }

package/dist/esm/index.js

@@ -6,7 +6,7 @@ import localForage from './localForage';
 import { isAbsolutePath, basename, fileExtensionWithSeparator, fileExtension } from './path';
 import { onlySuccessfulPromises, flowAsync, then } from './promise';
 import unsentRequest from './unsentRequest';
-import { filterByExtension, getAllResponses, parseLinkHeader, parseResponse, responseParser, getPathDepth } from './backendUtil';
+import { filterByExtension, collectionKeyForFiles, getAllResponses, parseLinkHeader, parseResponse, responseParser, getPathDepth } from './backendUtil';
 import loadScript from './loadScript';
 import getBlobSHA from './getBlobSHA';
 import { asyncLock } from './asyncLock';
@@ -29,6 +29,7 @@ export const DecapCmsLibUtil = {
   then,
   unsentRequest,
   filterByExtension,
+  collectionKeyForFiles,
   parseLinkHeader,
   parseResponse,
   responseParser,
@@ -68,4 +69,4 @@ export const DecapCmsLibUtil = {
   AccessTokenError,
   throwOnConflictingBranches
 };
-export { APIError, Cursor, CURSOR_COMPATIBILITY_SYMBOL, EditorialWorkflowError, EDITORIAL_WORKFLOW_ERROR, localForage, basename, fileExtensionWithSeparator, fileExtension, onlySuccessfulPromises, flowAsync, then, unsentRequest, filterByExtension, parseLinkHeader, getAllResponses, parseResponse, responseParser, loadScript, getBlobSHA, asyncLock, isAbsolutePath, getPathDepth, entriesByFiles, entriesByFolder, unpublishedEntries, getMediaDisplayURL, getMediaAsBlob, readFile, readFileMetadata, CMS_BRANCH_PREFIX, generateContentKey, isCMSLabel, labelToStatus, statusToLabel, DEFAULT_PR_BODY, MERGE_COMMIT_MESSAGE, isPreviewContext, getPreviewStatus, runWithLock, PreviewState, parseContentKey, createPointerFile, getLargeMediaFilteredMediaFiles, getLargeMediaPatternsFromGitAttributesFile, parsePointerFile, getPointerFileForMediaFileObj, branchFromContentKey, contentKeyFromBranch, blobToFileObj, requestWithBackoff, getDefaultBranchName, allEntriesByFolder, AccessTokenError, throwOnConflictingBranches };
+export { APIError, Cursor, CURSOR_COMPATIBILITY_SYMBOL, EditorialWorkflowError, EDITORIAL_WORKFLOW_ERROR, localForage, basename, fileExtensionWithSeparator, fileExtension, onlySuccessfulPromises, flowAsync, then, unsentRequest, filterByExtension, collectionKeyForFiles, parseLinkHeader, getAllResponses, parseResponse, responseParser, loadScript, getBlobSHA, asyncLock, isAbsolutePath, getPathDepth, entriesByFiles, entriesByFolder, unpublishedEntries, getMediaDisplayURL, getMediaAsBlob, readFile, readFileMetadata, CMS_BRANCH_PREFIX, generateContentKey, isCMSLabel, labelToStatus, statusToLabel, DEFAULT_PR_BODY, MERGE_COMMIT_MESSAGE, isPreviewContext, getPreviewStatus, runWithLock, PreviewState, parseContentKey, createPointerFile, getLargeMediaFilteredMediaFiles, getLargeMediaPatternsFromGitAttributesFile, parsePointerFile, getPointerFileForMediaFileObj, branchFromContentKey, contentKeyFromBranch, blobToFileObj, requestWithBackoff, getDefaultBranchName, allEntriesByFolder, AccessTokenError, throwOnConflictingBranches };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "decap-cms-lib-util",
   "description": "Shared utilities for Decap CMS.",
-  "version": "3.8.2",
+  "version": "3.9.0-beta.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/decaporg/decap-cms/tree/main/packages/decap-cms-lib-util"