@strapi/data-transfer 5.48.0 → 5.48.1

package/dist/utils/transaction.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transaction.mjs","sources":["../../src/utils/transaction.ts"],"sourcesContent":["import { EventEmitter } from 'events';\nimport { randomUUID } from 'crypto';\nimport type { Core } from '@strapi/types';\n\nimport { Transaction, TransactionCallback } from '../../types/utils';\n\nexport const createTransaction = (strapi: Core.Strapi): Transaction => {\n  const fns: { fn: TransactionCallback; uuid: string }[] = [];\n\n  let done = false;\n  let resume: null | (() => void) = null;\n\n  const e = new EventEmitter();\n  e.on('spawn', (uuid, cb) => {\n    fns.push({ fn: cb, uuid });\n    resume?.();\n  });\n\n  e.on('close', () => {\n    e.removeAllListeners('rollback');\n    e.removeAllListeners('spawn');\n\n    done = true;\n    resume?.();\n  });\n\n  strapi.db.transaction(async ({ trx, rollback }) => {\n    e.once('rollback', async () => {\n      e.removeAllListeners('close');\n      e.removeAllListeners('spawn');\n\n      try {\n        await rollback();\n        e.emit('rollback_completed');\n      } catch {\n        e.emit('rollback_failed');\n      } finally {\n        done = true;\n        resume?.();\n      }\n    });\n\n    while (!done) {\n      while (fns.length) {\n        const item = fns.shift();\n\n        if (item) {\n          const { fn, uuid } = item;\n\n          try {\n            const res = await fn(trx);\n            e.emit(uuid, { data: res });\n          } catch (error) {\n            e.emit(uuid, { error });\n          }\n        }\n      }\n      if (!done && !fns.length) {\n        // eslint-disable-next-line @typescript-eslint/no-loop-func\n        await new Promise<void>((resolve) => {\n          resume = resolve;\n        });\n      }\n    }\n  });\n\n  return {\n    async attach<T = undefined>(callback: TransactionCallback): Promise<T | undefined> {\n      const uuid = randomUUID();\n      e.emit('spawn', uuid, callback);\n      return new Promise<T | undefined>((resolve, reject) => {\n        e.on(uuid, ({ data, error }) => {\n          if (data) {\n            resolve(data);\n          }\n\n          if (error) {\n            reject(error);\n          }\n          resolve(undefined);\n        });\n      });\n    },\n\n    end() {\n      return e.emit('close');\n    },\n\n    rollback() {\n      return new Promise<boolean>((resolve) => {\n        e.emit('rollback');\n\n        e.once('rollback_failed', () => resolve(false));\n        e.once('rollback_completed', () => resolve(true));\n      });\n    },\n  };\n};\n"],"names":["createTransaction","strapi","fns","done","resume","e","EventEmitter","on","uuid","cb","push","fn","removeAllListeners","db","transaction","trx","rollback","once","emit","length","item","shift","res","data","error","Promise","resolve","attach","callback","randomUUID","reject","undefined","end"],"mappings":"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"}
+{"version":3,"file":"transaction.mjs","sources":["../../src/utils/transaction.ts"],"sourcesContent":["import { EventEmitter } from 'events';\nimport { randomUUID } from 'crypto';\nimport type { Core } from '@strapi/types';\n\nimport { Transaction, TransactionCallback } from '../types/utils';\n\nexport const createTransaction = (strapi: Core.Strapi): Transaction => {\n  const fns: { fn: TransactionCallback; uuid: string }[] = [];\n\n  let done = false;\n  let resume: null | (() => void) = null;\n\n  const e = new EventEmitter();\n  e.on('spawn', (uuid, cb) => {\n    fns.push({ fn: cb, uuid });\n    resume?.();\n  });\n\n  e.on('close', () => {\n    e.removeAllListeners('rollback');\n    e.removeAllListeners('spawn');\n\n    done = true;\n    resume?.();\n  });\n\n  strapi.db.transaction(async ({ trx, rollback }) => {\n    e.once('rollback', async () => {\n      e.removeAllListeners('close');\n      e.removeAllListeners('spawn');\n\n      try {\n        await rollback();\n        e.emit('rollback_completed');\n      } catch {\n        e.emit('rollback_failed');\n      } finally {\n        done = true;\n        resume?.();\n      }\n    });\n\n    while (!done) {\n      while (fns.length) {\n        const item = fns.shift();\n\n        if (item) {\n          const { fn, uuid } = item;\n\n          try {\n            const res = await fn(trx);\n            e.emit(uuid, { data: res });\n          } catch (error) {\n            e.emit(uuid, { error });\n          }\n        }\n      }\n      if (!done && !fns.length) {\n        // eslint-disable-next-line @typescript-eslint/no-loop-func\n        await new Promise<void>((resolve) => {\n          resume = resolve;\n        });\n      }\n    }\n  });\n\n  return {\n    async attach<T = undefined>(callback: TransactionCallback): Promise<T | undefined> {\n      const uuid = randomUUID();\n      e.emit('spawn', uuid, callback);\n      return new Promise<T | undefined>((resolve, reject) => {\n        e.on(uuid, ({ data, error }) => {\n          if (data) {\n            resolve(data);\n          }\n\n          if (error) {\n            reject(error);\n          }\n          resolve(undefined);\n        });\n      });\n    },\n\n    end() {\n      return e.emit('close');\n    },\n\n    rollback() {\n      return new Promise<boolean>((resolve) => {\n        e.emit('rollback');\n\n        e.once('rollback_failed', () => resolve(false));\n        e.once('rollback_completed', () => resolve(true));\n      });\n    },\n  };\n};\n"],"names":["createTransaction","strapi","fns","done","resume","e","EventEmitter","on","uuid","cb","push","fn","removeAllListeners","db","transaction","trx","rollback","once","emit","length","item","shift","res","data","error","Promise","resolve","attach","callback","randomUUID","reject","undefined","end"],"mappings":"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"}

package/dist/utils/transfer-asset-chunk.d.ts

@@ -10,6 +10,28 @@ export declare function createTransferAssetStreamChunk(assetID: string, chunk: B
     encoding: 'base64';
     data: string;
 };
+/**
+ * Legacy asset-chunk shape for remotes that pre-date #23479 and do `Buffer.from(item.data.data)`
+ * in their push handler. Used only when init negotiation indicates the remote does not understand
+ * {@link createTransferAssetStreamChunk}'s `encoding: 'base64'` field (the base64 string on `data`
+ * would leave `item.data.data` undefined and crash those remotes with `Buffer.from(undefined)`).
+ *
+ * `buffer.toJSON()` returns `{ type: 'Buffer', data: number[] }` — a plain object the WebSocket
+ * replacer passes through untouched, so the receiver sees the same shape the old default
+ * `JSON.stringify(Buffer)` used to produce.
+ *
+ * Note: this shape is ~6× larger on the wire than base64 and allocates the full byte array during
+ * `JSON.parse`, which is what #23479 was fixing for large files. Only use this when negotiation
+ * proves the remote cannot decode base64.
+ */
+export declare function createTransferAssetStreamChunkLegacy(assetID: string, chunk: Buffer | Uint8Array): {
+    action: 'stream';
+    assetID: string;
+    data: {
+        type: 'Buffer';
+        data: number[];
+    };
+};
 /**
  * Decode a stream item from `TransferAssetFlow` after `JSON.parse` (shared by push + pull handlers
  * and the remote source provider).

package/dist/utils/transfer-asset-chunk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfer-asset-chunk.d.ts","sourceRoot":"","sources":["../../src/utils/transfer-asset-chunk.ts"],"names":[],"mappings":";;AAAA;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GAAG,UAAU,GACzB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAazE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,MAAM,CAKT;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAsBxF;AAED,yEAAyE;AACzE,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,MAAM,CAqBT"}
+{"version":3,"file":"transfer-asset-chunk.d.ts","sourceRoot":"","sources":["../../src/utils/transfer-asset-chunk.ts"],"names":[],"mappings":";;AAAA;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GAAG,UAAU,GACzB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAazE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GAAG,UAAU,GACzB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,CAYjF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,MAAM,CAKT;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAsBxF;AAED,yEAAyE;AACzE,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,MAAM,CAqBT"}

package/dist/utils/transfer-asset-chunk.js

@@ -15,6 +15,30 @@
         data: buffer.toString('base64')
     };
 }
+/**
+ * Legacy asset-chunk shape for remotes that pre-date #23479 and do `Buffer.from(item.data.data)`
+ * in their push handler. Used only when init negotiation indicates the remote does not understand
+ * {@link createTransferAssetStreamChunk}'s `encoding: 'base64'` field (the base64 string on `data`
+ * would leave `item.data.data` undefined and crash those remotes with `Buffer.from(undefined)`).
+ *
+ * `buffer.toJSON()` returns `{ type: 'Buffer', data: number[] }` — a plain object the WebSocket
+ * replacer passes through untouched, so the receiver sees the same shape the old default
+ * `JSON.stringify(Buffer)` used to produce.
+ *
+ * Note: this shape is ~6× larger on the wire than base64 and allocates the full byte array during
+ * `JSON.parse`, which is what #23479 was fixing for large files. Only use this when negotiation
+ * proves the remote cannot decode base64.
+ */ function createTransferAssetStreamChunkLegacy(assetID, chunk) {
+    if (chunk == null) {
+        throw new TypeError('Asset stream yielded a null/undefined chunk; refusing to encode (would trigger Buffer.from(undefined))');
+    }
+    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+    return {
+        action: 'stream',
+        assetID,
+        data: buffer.toJSON()
+    };
+}
 /**
  * Decode a stream item from `TransferAssetFlow` after `JSON.parse` (shared by push + pull handlers
  * and the remote source provider).
@@ -87,6 +111,7 @@ const getLegacyBufferJsonData = (value)=>{
 }
 
 exports.createTransferAssetStreamChunk = createTransferAssetStreamChunk;
+exports.createTransferAssetStreamChunkLegacy = createTransferAssetStreamChunkLegacy;
 exports.decodeTransferAssetStreamData = decodeTransferAssetStreamData;
 exports.decodeTransferAssetStreamItem = decodeTransferAssetStreamItem;
 exports.transferAssetStreamChunkByteLength = transferAssetStreamChunkByteLength;

package/dist/utils/transfer-asset-chunk.js.map

@@ -1 +1 @@
-{"version":3,"file":"transfer-asset-chunk.js","sources":["../../src/utils/transfer-asset-chunk.ts"],"sourcesContent":["/**\n * Canonical **outbound** asset chunk for WebSocket JSON (push and pull).\n * Base64 string `data` keeps `JSON.parse` heap bounded vs `{ type: 'Buffer', data: [n,…] }`.\n */\nexport function createTransferAssetStreamChunk(\n  assetID: string,\n  chunk: Buffer | Uint8Array\n): { action: 'stream'; assetID: string; encoding: 'base64'; data: string } {\n  if (chunk == null) {\n    throw new TypeError(\n      'Asset stream yielded a null/undefined chunk; refusing to encode (would trigger Buffer.from(undefined))'\n    );\n  }\n  const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n  return {\n    action: 'stream',\n    assetID,\n    encoding: 'base64',\n    data: buffer.toString('base64'),\n  };\n}\n\n/**\n * Decode a stream item from `TransferAssetFlow` after `JSON.parse` (shared by push + pull handlers\n * and the remote source provider).\n */\nexport function decodeTransferAssetStreamItem(item: {\n  action: 'stream';\n  data: unknown;\n  encoding?: 'base64';\n}): Buffer {\n  return decodeTransferAssetStreamData(\n    item.data,\n    item.encoding === 'base64' ? 'base64' : undefined\n  );\n}\n\nconst getLegacyBufferJsonData = (value: unknown): Uint8Array | readonly number[] | null => {\n  if (!value || typeof value !== 'object' || !('type' in value)) {\n    return null;\n  }\n  if ((value as { type: unknown }).type !== 'Buffer') {\n    return null;\n  }\n  const raw = (value as { data?: unknown }).data;\n  if (Array.isArray(raw) || ArrayBuffer.isView(raw)) {\n    return raw as Uint8Array | readonly number[];\n  }\n  return null;\n};\n\n/**\n * Decode binary payload for `TransferAssetFlow` `action: 'stream'` after JSON.parse.\n *\n * Supported shapes (receivers should accept all of these):\n * - **String `data`:** preferred wire form (`createTransferAssetStreamChunk` / `encoding: 'base64'`).\n * - **`{ type: 'Buffer', data: number[] | TypedArray }`:** legacy `Buffer.toJSON()` from default\n *   `JSON.stringify` (older clients/servers).\n * - **`Buffer` instance:** in-process only.\n *\n * Note: Node’s `JSON.stringify` runs `Buffer.toJSON()` before any replacer, so nested `Buffer`\n * values become the legacy object unless you pass a string (use `createTransferAssetStreamChunk`).\n */\nexport function decodeTransferAssetStreamData(data: unknown, encoding?: 'base64'): Buffer {\n  if (encoding === 'base64' && typeof data === 'string') {\n    return Buffer.from(data, 'base64');\n  }\n  // `encoding: 'base64'` with a non-string payload (or no encoding) uses the same fallbacks as\n  // legacy peers — avoids throwing when flags and payload disagree.\n\n  if (Buffer.isBuffer(data)) {\n    return Buffer.from(data);\n  }\n\n  const legacyBufferData = getLegacyBufferJsonData(data);\n  if (legacyBufferData) {\n    return Buffer.from(legacyBufferData);\n  }\n\n  // Wire base64 string (pull generator and any other path that stringifies a string payload).\n  if (typeof data === 'string') {\n    return Buffer.from(data, 'base64');\n  }\n\n  throw new TypeError('Invalid transfer asset stream chunk payload');\n}\n\n/** Approximate decoded byte size for batching (pull asset generator). */\nexport function transferAssetStreamChunkByteLength(chunk: {\n  action: string;\n  data?: unknown;\n  encoding?: 'base64';\n}): number {\n  if (chunk.action !== 'stream') {\n    return 0;\n  }\n  if (typeof chunk.data === 'string') {\n    return Math.floor((chunk.data.length * 3) / 4);\n  }\n  if (Buffer.isBuffer(chunk.data)) {\n    return chunk.data.byteLength;\n  }\n\n  const legacyBufferData = getLegacyBufferJsonData(chunk.data);\n  if (legacyBufferData) {\n    if (Array.isArray(legacyBufferData)) {\n      return legacyBufferData.length;\n    }\n    if (ArrayBuffer.isView(legacyBufferData)) {\n      return legacyBufferData.byteLength;\n    }\n  }\n  return 0;\n}\n"],"names":["createTransferAssetStreamChunk","assetID","chunk","TypeError","buffer","Buffer","isBuffer","from","action","encoding","data","toString","decodeTransferAssetStreamItem","item","decodeTransferAssetStreamData","undefined","getLegacyBufferJsonData","value","type","raw","Array","isArray","ArrayBuffer","isView","legacyBufferData","transferAssetStreamChunkByteLength","Math","floor","length","byteLength"],"mappings":"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"}
+{"version":3,"file":"transfer-asset-chunk.js","sources":["../../src/utils/transfer-asset-chunk.ts"],"sourcesContent":["/**\n * Canonical **outbound** asset chunk for WebSocket JSON (push and pull).\n * Base64 string `data` keeps `JSON.parse` heap bounded vs `{ type: 'Buffer', data: [n,…] }`.\n */\nexport function createTransferAssetStreamChunk(\n  assetID: string,\n  chunk: Buffer | Uint8Array\n): { action: 'stream'; assetID: string; encoding: 'base64'; data: string } {\n  if (chunk == null) {\n    throw new TypeError(\n      'Asset stream yielded a null/undefined chunk; refusing to encode (would trigger Buffer.from(undefined))'\n    );\n  }\n  const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n  return {\n    action: 'stream',\n    assetID,\n    encoding: 'base64',\n    data: buffer.toString('base64'),\n  };\n}\n\n/**\n * Legacy asset-chunk shape for remotes that pre-date #23479 and do `Buffer.from(item.data.data)`\n * in their push handler. Used only when init negotiation indicates the remote does not understand\n * {@link createTransferAssetStreamChunk}'s `encoding: 'base64'` field (the base64 string on `data`\n * would leave `item.data.data` undefined and crash those remotes with `Buffer.from(undefined)`).\n *\n * `buffer.toJSON()` returns `{ type: 'Buffer', data: number[] }` — a plain object the WebSocket\n * replacer passes through untouched, so the receiver sees the same shape the old default\n * `JSON.stringify(Buffer)` used to produce.\n *\n * Note: this shape is ~6× larger on the wire than base64 and allocates the full byte array during\n * `JSON.parse`, which is what #23479 was fixing for large files. Only use this when negotiation\n * proves the remote cannot decode base64.\n */\nexport function createTransferAssetStreamChunkLegacy(\n  assetID: string,\n  chunk: Buffer | Uint8Array\n): { action: 'stream'; assetID: string; data: { type: 'Buffer'; data: number[] } } {\n  if (chunk == null) {\n    throw new TypeError(\n      'Asset stream yielded a null/undefined chunk; refusing to encode (would trigger Buffer.from(undefined))'\n    );\n  }\n  const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n  return {\n    action: 'stream',\n    assetID,\n    data: buffer.toJSON(),\n  };\n}\n\n/**\n * Decode a stream item from `TransferAssetFlow` after `JSON.parse` (shared by push + pull handlers\n * and the remote source provider).\n */\nexport function decodeTransferAssetStreamItem(item: {\n  action: 'stream';\n  data: unknown;\n  encoding?: 'base64';\n}): Buffer {\n  return decodeTransferAssetStreamData(\n    item.data,\n    item.encoding === 'base64' ? 'base64' : undefined\n  );\n}\n\nconst getLegacyBufferJsonData = (value: unknown): Uint8Array | readonly number[] | null => {\n  if (!value || typeof value !== 'object' || !('type' in value)) {\n    return null;\n  }\n  if ((value as { type: unknown }).type !== 'Buffer') {\n    return null;\n  }\n  const raw = (value as { data?: unknown }).data;\n  if (Array.isArray(raw) || ArrayBuffer.isView(raw)) {\n    return raw as Uint8Array | readonly number[];\n  }\n  return null;\n};\n\n/**\n * Decode binary payload for `TransferAssetFlow` `action: 'stream'` after JSON.parse.\n *\n * Supported shapes (receivers should accept all of these):\n * - **String `data`:** preferred wire form (`createTransferAssetStreamChunk` / `encoding: 'base64'`).\n * - **`{ type: 'Buffer', data: number[] | TypedArray }`:** legacy `Buffer.toJSON()` from default\n *   `JSON.stringify` (older clients/servers).\n * - **`Buffer` instance:** in-process only.\n *\n * Note: Node’s `JSON.stringify` runs `Buffer.toJSON()` before any replacer, so nested `Buffer`\n * values become the legacy object unless you pass a string (use `createTransferAssetStreamChunk`).\n */\nexport function decodeTransferAssetStreamData(data: unknown, encoding?: 'base64'): Buffer {\n  if (encoding === 'base64' && typeof data === 'string') {\n    return Buffer.from(data, 'base64');\n  }\n  // `encoding: 'base64'` with a non-string payload (or no encoding) uses the same fallbacks as\n  // legacy peers — avoids throwing when flags and payload disagree.\n\n  if (Buffer.isBuffer(data)) {\n    return Buffer.from(data);\n  }\n\n  const legacyBufferData = getLegacyBufferJsonData(data);\n  if (legacyBufferData) {\n    return Buffer.from(legacyBufferData);\n  }\n\n  // Wire base64 string (pull generator and any other path that stringifies a string payload).\n  if (typeof data === 'string') {\n    return Buffer.from(data, 'base64');\n  }\n\n  throw new TypeError('Invalid transfer asset stream chunk payload');\n}\n\n/** Approximate decoded byte size for batching (pull asset generator). */\nexport function transferAssetStreamChunkByteLength(chunk: {\n  action: string;\n  data?: unknown;\n  encoding?: 'base64';\n}): number {\n  if (chunk.action !== 'stream') {\n    return 0;\n  }\n  if (typeof chunk.data === 'string') {\n    return Math.floor((chunk.data.length * 3) / 4);\n  }\n  if (Buffer.isBuffer(chunk.data)) {\n    return chunk.data.byteLength;\n  }\n\n  const legacyBufferData = getLegacyBufferJsonData(chunk.data);\n  if (legacyBufferData) {\n    if (Array.isArray(legacyBufferData)) {\n      return legacyBufferData.length;\n    }\n    if (ArrayBuffer.isView(legacyBufferData)) {\n      return legacyBufferData.byteLength;\n    }\n  }\n  return 0;\n}\n"],"names":["createTransferAssetStreamChunk","assetID","chunk","TypeError","buffer","Buffer","isBuffer","from","action","encoding","data","toString","createTransferAssetStreamChunkLegacy","toJSON","decodeTransferAssetStreamItem","item","decodeTransferAssetStreamData","undefined","getLegacyBufferJsonData","value","type","raw","Array","isArray","ArrayBuffer","isView","legacyBufferData","transferAssetStreamChunkByteLength","Math","floor","length","byteLength"],"mappings":"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"}

package/dist/utils/transfer-asset-chunk.mjs

@@ -13,6 +13,30 @@
         data: buffer.toString('base64')
     };
 }
+/**
+ * Legacy asset-chunk shape for remotes that pre-date #23479 and do `Buffer.from(item.data.data)`
+ * in their push handler. Used only when init negotiation indicates the remote does not understand
+ * {@link createTransferAssetStreamChunk}'s `encoding: 'base64'` field (the base64 string on `data`
+ * would leave `item.data.data` undefined and crash those remotes with `Buffer.from(undefined)`).
+ *
+ * `buffer.toJSON()` returns `{ type: 'Buffer', data: number[] }` — a plain object the WebSocket
+ * replacer passes through untouched, so the receiver sees the same shape the old default
+ * `JSON.stringify(Buffer)` used to produce.
+ *
+ * Note: this shape is ~6× larger on the wire than base64 and allocates the full byte array during
+ * `JSON.parse`, which is what #23479 was fixing for large files. Only use this when negotiation
+ * proves the remote cannot decode base64.
+ */ function createTransferAssetStreamChunkLegacy(assetID, chunk) {
+    if (chunk == null) {
+        throw new TypeError('Asset stream yielded a null/undefined chunk; refusing to encode (would trigger Buffer.from(undefined))');
+    }
+    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+    return {
+        action: 'stream',
+        assetID,
+        data: buffer.toJSON()
+    };
+}
 /**
  * Decode a stream item from `TransferAssetFlow` after `JSON.parse` (shared by push + pull handlers
  * and the remote source provider).
@@ -84,5 +108,5 @@ const getLegacyBufferJsonData = (value)=>{
     return 0;
 }
 
-export { createTransferAssetStreamChunk, decodeTransferAssetStreamData, decodeTransferAssetStreamItem, transferAssetStreamChunkByteLength };
+export { createTransferAssetStreamChunk, createTransferAssetStreamChunkLegacy, decodeTransferAssetStreamData, decodeTransferAssetStreamItem, transferAssetStreamChunkByteLength };
 //# sourceMappingURL=transfer-asset-chunk.mjs.map

package/dist/utils/transfer-asset-chunk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transfer-asset-chunk.mjs","sources":["../../src/utils/transfer-asset-chunk.ts"],"sourcesContent":["/**\n * Canonical **outbound** asset chunk for WebSocket JSON (push and pull).\n * Base64 string `data` keeps `JSON.parse` heap bounded vs `{ type: 'Buffer', data: [n,…] }`.\n */\nexport function createTransferAssetStreamChunk(\n  assetID: string,\n  chunk: Buffer | Uint8Array\n): { action: 'stream'; assetID: string; encoding: 'base64'; data: string } {\n  if (chunk == null) {\n    throw new TypeError(\n      'Asset stream yielded a null/undefined chunk; refusing to encode (would trigger Buffer.from(undefined))'\n    );\n  }\n  const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n  return {\n    action: 'stream',\n    assetID,\n    encoding: 'base64',\n    data: buffer.toString('base64'),\n  };\n}\n\n/**\n * Decode a stream item from `TransferAssetFlow` after `JSON.parse` (shared by push + pull handlers\n * and the remote source provider).\n */\nexport function decodeTransferAssetStreamItem(item: {\n  action: 'stream';\n  data: unknown;\n  encoding?: 'base64';\n}): Buffer {\n  return decodeTransferAssetStreamData(\n    item.data,\n    item.encoding === 'base64' ? 'base64' : undefined\n  );\n}\n\nconst getLegacyBufferJsonData = (value: unknown): Uint8Array | readonly number[] | null => {\n  if (!value || typeof value !== 'object' || !('type' in value)) {\n    return null;\n  }\n  if ((value as { type: unknown }).type !== 'Buffer') {\n    return null;\n  }\n  const raw = (value as { data?: unknown }).data;\n  if (Array.isArray(raw) || ArrayBuffer.isView(raw)) {\n    return raw as Uint8Array | readonly number[];\n  }\n  return null;\n};\n\n/**\n * Decode binary payload for `TransferAssetFlow` `action: 'stream'` after JSON.parse.\n *\n * Supported shapes (receivers should accept all of these):\n * - **String `data`:** preferred wire form (`createTransferAssetStreamChunk` / `encoding: 'base64'`).\n * - **`{ type: 'Buffer', data: number[] | TypedArray }`:** legacy `Buffer.toJSON()` from default\n *   `JSON.stringify` (older clients/servers).\n * - **`Buffer` instance:** in-process only.\n *\n * Note: Node’s `JSON.stringify` runs `Buffer.toJSON()` before any replacer, so nested `Buffer`\n * values become the legacy object unless you pass a string (use `createTransferAssetStreamChunk`).\n */\nexport function decodeTransferAssetStreamData(data: unknown, encoding?: 'base64'): Buffer {\n  if (encoding === 'base64' && typeof data === 'string') {\n    return Buffer.from(data, 'base64');\n  }\n  // `encoding: 'base64'` with a non-string payload (or no encoding) uses the same fallbacks as\n  // legacy peers — avoids throwing when flags and payload disagree.\n\n  if (Buffer.isBuffer(data)) {\n    return Buffer.from(data);\n  }\n\n  const legacyBufferData = getLegacyBufferJsonData(data);\n  if (legacyBufferData) {\n    return Buffer.from(legacyBufferData);\n  }\n\n  // Wire base64 string (pull generator and any other path that stringifies a string payload).\n  if (typeof data === 'string') {\n    return Buffer.from(data, 'base64');\n  }\n\n  throw new TypeError('Invalid transfer asset stream chunk payload');\n}\n\n/** Approximate decoded byte size for batching (pull asset generator). */\nexport function transferAssetStreamChunkByteLength(chunk: {\n  action: string;\n  data?: unknown;\n  encoding?: 'base64';\n}): number {\n  if (chunk.action !== 'stream') {\n    return 0;\n  }\n  if (typeof chunk.data === 'string') {\n    return Math.floor((chunk.data.length * 3) / 4);\n  }\n  if (Buffer.isBuffer(chunk.data)) {\n    return chunk.data.byteLength;\n  }\n\n  const legacyBufferData = getLegacyBufferJsonData(chunk.data);\n  if (legacyBufferData) {\n    if (Array.isArray(legacyBufferData)) {\n      return legacyBufferData.length;\n    }\n    if (ArrayBuffer.isView(legacyBufferData)) {\n      return legacyBufferData.byteLength;\n    }\n  }\n  return 0;\n}\n"],"names":["createTransferAssetStreamChunk","assetID","chunk","TypeError","buffer","Buffer","isBuffer","from","action","encoding","data","toString","decodeTransferAssetStreamItem","item","decodeTransferAssetStreamData","undefined","getLegacyBufferJsonData","value","type","raw","Array","isArray","ArrayBuffer","isView","legacyBufferData","transferAssetStreamChunkByteLength","Math","floor","length","byteLength"],"mappings":"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"}
+{"version":3,"file":"transfer-asset-chunk.mjs","sources":["../../src/utils/transfer-asset-chunk.ts"],"sourcesContent":["/**\n * Canonical **outbound** asset chunk for WebSocket JSON (push and pull).\n * Base64 string `data` keeps `JSON.parse` heap bounded vs `{ type: 'Buffer', data: [n,…] }`.\n */\nexport function createTransferAssetStreamChunk(\n  assetID: string,\n  chunk: Buffer | Uint8Array\n): { action: 'stream'; assetID: string; encoding: 'base64'; data: string } {\n  if (chunk == null) {\n    throw new TypeError(\n      'Asset stream yielded a null/undefined chunk; refusing to encode (would trigger Buffer.from(undefined))'\n    );\n  }\n  const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n  return {\n    action: 'stream',\n    assetID,\n    encoding: 'base64',\n    data: buffer.toString('base64'),\n  };\n}\n\n/**\n * Legacy asset-chunk shape for remotes that pre-date #23479 and do `Buffer.from(item.data.data)`\n * in their push handler. Used only when init negotiation indicates the remote does not understand\n * {@link createTransferAssetStreamChunk}'s `encoding: 'base64'` field (the base64 string on `data`\n * would leave `item.data.data` undefined and crash those remotes with `Buffer.from(undefined)`).\n *\n * `buffer.toJSON()` returns `{ type: 'Buffer', data: number[] }` — a plain object the WebSocket\n * replacer passes through untouched, so the receiver sees the same shape the old default\n * `JSON.stringify(Buffer)` used to produce.\n *\n * Note: this shape is ~6× larger on the wire than base64 and allocates the full byte array during\n * `JSON.parse`, which is what #23479 was fixing for large files. Only use this when negotiation\n * proves the remote cannot decode base64.\n */\nexport function createTransferAssetStreamChunkLegacy(\n  assetID: string,\n  chunk: Buffer | Uint8Array\n): { action: 'stream'; assetID: string; data: { type: 'Buffer'; data: number[] } } {\n  if (chunk == null) {\n    throw new TypeError(\n      'Asset stream yielded a null/undefined chunk; refusing to encode (would trigger Buffer.from(undefined))'\n    );\n  }\n  const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);\n  return {\n    action: 'stream',\n    assetID,\n    data: buffer.toJSON(),\n  };\n}\n\n/**\n * Decode a stream item from `TransferAssetFlow` after `JSON.parse` (shared by push + pull handlers\n * and the remote source provider).\n */\nexport function decodeTransferAssetStreamItem(item: {\n  action: 'stream';\n  data: unknown;\n  encoding?: 'base64';\n}): Buffer {\n  return decodeTransferAssetStreamData(\n    item.data,\n    item.encoding === 'base64' ? 'base64' : undefined\n  );\n}\n\nconst getLegacyBufferJsonData = (value: unknown): Uint8Array | readonly number[] | null => {\n  if (!value || typeof value !== 'object' || !('type' in value)) {\n    return null;\n  }\n  if ((value as { type: unknown }).type !== 'Buffer') {\n    return null;\n  }\n  const raw = (value as { data?: unknown }).data;\n  if (Array.isArray(raw) || ArrayBuffer.isView(raw)) {\n    return raw as Uint8Array | readonly number[];\n  }\n  return null;\n};\n\n/**\n * Decode binary payload for `TransferAssetFlow` `action: 'stream'` after JSON.parse.\n *\n * Supported shapes (receivers should accept all of these):\n * - **String `data`:** preferred wire form (`createTransferAssetStreamChunk` / `encoding: 'base64'`).\n * - **`{ type: 'Buffer', data: number[] | TypedArray }`:** legacy `Buffer.toJSON()` from default\n *   `JSON.stringify` (older clients/servers).\n * - **`Buffer` instance:** in-process only.\n *\n * Note: Node’s `JSON.stringify` runs `Buffer.toJSON()` before any replacer, so nested `Buffer`\n * values become the legacy object unless you pass a string (use `createTransferAssetStreamChunk`).\n */\nexport function decodeTransferAssetStreamData(data: unknown, encoding?: 'base64'): Buffer {\n  if (encoding === 'base64' && typeof data === 'string') {\n    return Buffer.from(data, 'base64');\n  }\n  // `encoding: 'base64'` with a non-string payload (or no encoding) uses the same fallbacks as\n  // legacy peers — avoids throwing when flags and payload disagree.\n\n  if (Buffer.isBuffer(data)) {\n    return Buffer.from(data);\n  }\n\n  const legacyBufferData = getLegacyBufferJsonData(data);\n  if (legacyBufferData) {\n    return Buffer.from(legacyBufferData);\n  }\n\n  // Wire base64 string (pull generator and any other path that stringifies a string payload).\n  if (typeof data === 'string') {\n    return Buffer.from(data, 'base64');\n  }\n\n  throw new TypeError('Invalid transfer asset stream chunk payload');\n}\n\n/** Approximate decoded byte size for batching (pull asset generator). */\nexport function transferAssetStreamChunkByteLength(chunk: {\n  action: string;\n  data?: unknown;\n  encoding?: 'base64';\n}): number {\n  if (chunk.action !== 'stream') {\n    return 0;\n  }\n  if (typeof chunk.data === 'string') {\n    return Math.floor((chunk.data.length * 3) / 4);\n  }\n  if (Buffer.isBuffer(chunk.data)) {\n    return chunk.data.byteLength;\n  }\n\n  const legacyBufferData = getLegacyBufferJsonData(chunk.data);\n  if (legacyBufferData) {\n    if (Array.isArray(legacyBufferData)) {\n      return legacyBufferData.length;\n    }\n    if (ArrayBuffer.isView(legacyBufferData)) {\n      return legacyBufferData.byteLength;\n    }\n  }\n  return 0;\n}\n"],"names":["createTransferAssetStreamChunk","assetID","chunk","TypeError","buffer","Buffer","isBuffer","from","action","encoding","data","toString","createTransferAssetStreamChunkLegacy","toJSON","decodeTransferAssetStreamItem","item","decodeTransferAssetStreamData","undefined","getLegacyBufferJsonData","value","type","raw","Array","isArray","ArrayBuffer","isView","legacyBufferData","transferAssetStreamChunkByteLength","Math","floor","length","byteLength"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strapi/data-transfer",
-  "version": "5.48.0",
+  "version": "5.48.1",
   "description": "Data transfer capabilities for Strapi",
   "keywords": [
     "strapi",
@@ -51,9 +51,9 @@
     "watch": "run -T rollup -c -w"
   },
   "dependencies": {
-    "@strapi/logger": "5.48.0",
-    "@strapi/types": "5.48.0",
-    "@strapi/utils": "5.48.0",
+    "@strapi/logger": "5.48.1",
+    "@strapi/types": "5.48.1",
+    "@strapi/utils": "5.48.1",
     "chalk": "4.1.2",
     "cli-table3": "0.6.5",
     "commander": "8.3.0",
@@ -64,13 +64,13 @@
     "resolve-cwd": "3.0.0",
     "semver": "7.7.4",
     "stream-chain": "2.2.5",
-    "stream-json": "1.8.0",
+    "stream-json": "1.9.1",
     "tar": "7.5.11",
     "tar-stream": "2.2.0",
     "ws": "8.20.1"
   },
   "devDependencies": {
-    "@strapi/database": "5.48.0",
+    "@strapi/database": "5.48.1",
     "@types/fs-extra": "11.0.4",
     "@types/jest": "29.5.2",
     "@types/koa": "2.13.4",
@@ -78,7 +78,7 @@
     "@types/node": "24.10.0",
     "@types/semver": "7.5.0",
     "@types/stream-chain": "2.0.1",
-    "@types/stream-json": "1.7.3",
+    "@types/stream-json": "1.7.8",
     "@types/tar-stream": "2.2.2",
     "@types/ws": "^8.5.4",
     "knex": "3.0.1",
@@ -87,7 +87,7 @@
     "typescript": "5.4.5"
   },
   "engines": {
-    "node": ">=20.0.0 <=24.x.x",
+    "node": ">=20.0.0 <=26.x.x",
     "npm": ">=6.0.0"
   }
 }