@strapi/data-transfer 5.47.1 → 5.48.1

package/dist/types/remote/protocol/client/transfer/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../../../../src/types/remote/protocol/client/transfer/pull.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CACrD,MAAM,EACJ,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,GAC3C,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,GACtC,oBAAoB,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC,GACvD,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CACtD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE3D,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,gBAAgB,IAAI;KACjE,GAAG,IAAI,gBAAgB,GAAG;QACzB,MAAM,EAAE,QAAQ,CAAC;QACjB,IAAI,EAAE,GAAG,CAAC;KACX,GAAG,mBAAmB;CACxB,CAAC,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAC1B,CAAC,GACD,KAAK,CAAC;AAEV,KAAK,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAEnF,KAAK,gBAAgB,CAAC,CAAC,IAAI;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC"}

package/dist/types/remote/protocol/client/transfer/push.d.ts

@@ -0,0 +1,29 @@
+import type { CreateTransferMessage, TransferAssetFlow } from './utils';
+import type { IEntity, ILink, IConfiguration } from '../../../../common-entities';
+export type TransferPushMessage = CreateTransferMessage<'step', TransferStepCommands<'entities', IEntity[]> | TransferStepCommands<'links', ILink[]> | TransferStepCommands<'configuration', IConfiguration[]> | TransferStepCommands<'assets', TransferAssetFlow[]>>;
+export type GetTransferPushStreamData<T extends TransferPushStep> = {
+    [key in TransferPushStep]: {
+        action: 'stream';
+        step: key;
+    } & TransferPushMessage;
+}[T] extends {
+    data: infer U;
+} ? U extends any[] ? U : U[] : never;
+export type TransferPushStep = TransferPushMessage['step'];
+type TransferStepCommands<T extends string, U> = {
+    step: T;
+} & TransferStepFlow<U>;
+type TransferStepFlow<U> = {
+    action: 'start';
+} | {
+    action: 'stream';
+    data: U;
+} | {
+    action: 'end';
+};
+export type Stats = {
+    started: number;
+    finished: number;
+};
+export {};
+//# sourceMappingURL=push.d.ts.map

package/dist/types/remote/protocol/client/transfer/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../../../../src/types/remote/protocol/client/transfer/push.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElF,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CACrD,MAAM,EACJ,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,GAC3C,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,GACtC,oBAAoB,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC,GACvD,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CACtD,CAAC;AAEF,MAAM,MAAM,yBAAyB,CAAC,CAAC,SAAS,gBAAgB,IAAI;KACjE,GAAG,IAAI,gBAAgB,GAAG;QACzB,MAAM,EAAE,QAAQ,CAAC;QACjB,IAAI,EAAE,GAAG,CAAC;KACX,GAAG,mBAAmB;CACxB,CAAC,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAC1B,CAAC,SAAS,GAAG,EAAE,GACb,CAAC,GACD,CAAC,EAAE,GACL,KAAK,CAAC;AAEV,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAE3D,KAAK,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAEnF,KAAK,gBAAgB,CAAC,CAAC,IAAI;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnG,MAAM,MAAM,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types/remote/protocol/client/transfer/utils.d.ts

@@ -0,0 +1,49 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { IAsset } from '../../../../common-entities';
+export type CreateTransferMessage<T extends string, U = unknown> = {
+    type: 'transfer';
+    kind: T;
+    transferID: string;
+} & U;
+export type TransferAssetChecksum = {
+    algorithm: 'sha256';
+    value: string;
+};
+export type TransferAssetFlow = {
+    assetID: string;
+} & ({
+    action: 'start';
+    data: Omit<IAsset, 'stream'>;
+}
+/** Legacy in-process / default JSON: Buffer serializes to `{ type: 'Buffer'; data: number[] }` on the wire. */
+ | {
+    action: 'stream';
+    data: Buffer;
+    encoding?: undefined;
+}
+/**
+ * Legacy Buffer JSON shape sent by {@link createTransferAssetStreamChunkLegacy} for remotes that
+ * predate #23479 and do `Buffer.from(item.data.data)` directly in their push handler.
+ */
+ | {
+    action: 'stream';
+    data: {
+        type: 'Buffer';
+        data: number[];
+    };
+    encoding?: undefined;
+}
+/**
+ * Canonical wire form for asset bytes (push + pull). Built with `createTransferAssetStreamChunk`.
+ * Decoders also accept legacy Buffer JSON and plain base64 strings without `encoding`.
+ */
+ | {
+    action: 'stream';
+    data: string;
+    encoding?: 'base64';
+} | {
+    action: 'end';
+    checksum?: TransferAssetChecksum;
+});
+//# sourceMappingURL=utils.d.ts.map

package/dist/types/remote/protocol/client/transfer/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../src/types/remote/protocol/client/transfer/utils.ts"],"names":[],"mappings":";;AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,OAAO,IAAI;IACjE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC;IACR,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,CAAC,CAAC;AAEN,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,QAAQ,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,CAClD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CAAE;AACnD,+GAA+G;GAC7G;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE;AAC1D;;;GAGG;GACD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE;AACtF;;;GAGG;GACD;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAA;CAAE,CACtD,CAAC"}

package/dist/types/remote/protocol/index.d.ts

@@ -0,0 +1,4 @@
+export * as Client from './client';
+export * as Server from './server';
+export * as Auth from './auth';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/remote/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/remote/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC"}

package/dist/types/remote/protocol/server/error.d.ts

@@ -0,0 +1,18 @@
+export declare enum ErrorKind {
+    Unknown = 0,
+    DiscardChunk = 1,
+    InvalidChunkFormat = 2
+}
+export declare class ServerError extends Error {
+    code: ErrorKind;
+    message: string;
+    details?: Record<string, unknown> | null | undefined;
+    constructor(code: ErrorKind, message: string, details?: Record<string, unknown> | null | undefined);
+}
+export declare class UnknownError extends ServerError {
+    constructor(message: string, details?: Record<string, unknown> | null);
+}
+export declare class DiscardChunkError extends ServerError {
+    constructor(message: string, details?: Record<string, unknown> | null);
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/types/remote/protocol/server/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../../src/types/remote/protocol/server/error.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IAEnB,OAAO,IAAI;IAEX,YAAY,IAAI;IAChB,kBAAkB,IAAI;CACvB;AAED,qBAAa,WAAY,SAAQ,KAAK;IAE3B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,MAAM;IACf,OAAO,CAAC;gBAFR,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,4CAAgC;CAIlD;AAED,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGtE;AAED,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGtE"}

package/dist/types/remote/protocol/server/index.d.ts

@@ -0,0 +1,3 @@
+export * from './messaging';
+export * as error from './error';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/remote/protocol/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/remote/protocol/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC"}

package/dist/types/remote/protocol/server/messaging.d.ts

@@ -0,0 +1,37 @@
+import { TransferKind } from '../client';
+import type { ServerError } from './error';
+import type { Diagnostic } from '../../../../utils/diagnostic';
+export type Message<T = unknown> = {
+    uuid?: string;
+    data?: T | null;
+    error?: ServerError | null;
+    diagnostic?: Diagnostic;
+};
+export type OKMessage = Message<{
+    ok: true;
+}>;
+export type InitMessage = Message<{
+    transferID: string;
+    checksums?: boolean;
+    /**
+     * Echoed back by the push handler when the client requests `assetEncoding: 'base64'` and the
+     * remote understands the compact base64 wire format. When absent, the client falls back to the
+     * legacy `{ type: 'Buffer', data: number[] }` asset-chunk shape so pre-#23479 remotes that do
+     * `Buffer.from(item.data.data)` directly can still receive pushes.
+     */
+    assetEncoding?: 'base64';
+}>;
+export type EndMessage = OKMessage;
+export type StatusMessage = Message<{
+    active: true;
+    kind: TransferKind;
+    startedAt: number;
+    elapsed: number;
+} | {
+    active: false;
+    kind: null;
+    startedAt: null;
+    elapsed: null;
+}>;
+export type Payload<T extends Message> = T['data'];
+//# sourceMappingURL=messaging.d.ts.map

package/dist/types/remote/protocol/server/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../../../../src/types/remote/protocol/server/messaging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,OAAO,IAAI;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAGF,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AAC9C,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,QAAQ,CAAC;CAC1B,CAAC,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC;AACnC,MAAM,MAAM,aAAa,GAAG,OAAO,CAC/B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAChE,CAAC;AAEF,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/types/transfer-engine.d.ts

@@ -0,0 +1,149 @@
+/// <reference types="node" />
+import type { PassThrough } from 'stream';
+import type { ITransferResults, TransferTransforms, TransferProgress } from './utils';
+import type { ISourceProvider, IDestinationProvider } from './providers';
+import type { IDiagnosticReporter } from '../utils/diagnostic';
+import type { Diff } from '../utils/json';
+export type TransferFilterPreset = 'content' | 'files' | 'config';
+export type NextMiddleware<T> = (context: T) => void | Promise<void>;
+export type Middleware<T> = (context: T, next: NextMiddleware<T>) => Promise<void> | void;
+export type SchemaDiffHandlerContext = {
+    ignoredDiffs: Record<string, Diff[]>;
+    diffs: Record<string, Diff[]>;
+    source: ISourceProvider;
+    destination: IDestinationProvider;
+};
+export type SchemaDiffHandler = Middleware<SchemaDiffHandlerContext>;
+export type ErrorHandlerContext = {
+    ignore?: boolean;
+};
+export type ErrorHandler<T extends ErrorHandlerContext = ErrorHandlerContext> = Middleware<T>;
+export type ErrorCode = 'ASSETS_DIRECTORY_ERR';
+export type ErrorHandlers = {
+    [k in ErrorCode]: ErrorHandler[];
+};
+/**
+ * Defines the capabilities and properties of the transfer engine
+ */
+export interface ITransferEngine<S extends ISourceProvider = ISourceProvider, D extends IDestinationProvider = IDestinationProvider> {
+    /**
+     * Provider used as a source which that will stream its data to the transfer engine
+     */
+    sourceProvider: ISourceProvider;
+    /**
+     * Provider used as a destination that will receive its data from the transfer engine
+     */
+    destinationProvider: IDestinationProvider;
+    /**
+     * The options used to customize the behavio of the transfer engine
+     */
+    options: ITransferEngineOptions;
+    /**
+     * A diagnostic reporter instance used to gather information about
+     * errors, warnings and information emitted by the engine
+     */
+    diagnostics: IDiagnosticReporter;
+    /**
+     * Utilities used to retrieve transfer progress data
+     */
+    progress: {
+        data: TransferProgress;
+        stream: PassThrough;
+    };
+    /**
+     * Runs the integrity check which will make sure it's possible
+     * to transfer data from the source to the provider.
+     *
+     * Note: It requires to read the content of the source & destination metadata files
+     */
+    integrityCheck(): Promise<void | never>;
+    /**
+     * Start streaming selected data from the source to the destination
+     */
+    transfer(): Promise<ITransferResults<S, D>>;
+    /**
+     * Run the bootstrap lifecycle method of each provider
+     *
+     * Note: The bootstrap method can be used to initialize database
+     * connections, open files, etc...
+     */
+    bootstrap(): Promise<void>;
+    /**
+     * Abort the transfer process
+     */
+    abortTransfer(): Promise<void>;
+    /**
+     * Run the integrity check which will make sure it's possible
+     */
+    reportWarning(message: string, origin?: string): void;
+    /**
+     * Engine init step. Must be called after the providers bootstrap.
+     */
+    init(): Promise<void>;
+    /**
+     * Run the close lifecycle method of each provider
+     *
+     * Note: The close method can be used to gracefully close connections, cleanup the filesystem, etc..
+     */
+    close(): Promise<void>;
+    /**
+     * Run the preparations before starting a transfer for each provider
+     *
+     * related source and destination providers
+     */
+    beforeTransfer(): Promise<void>;
+    /**
+     * Start the schemas transfer by connecting the
+     * related source and destination providers streams
+     */
+    transferSchemas(): Promise<void>;
+    /**
+     * Start the entities transfer by connecting the
+     * related source and destination providers streams
+     */
+    transferEntities(): Promise<void>;
+    /**
+     * Start the links transfer by connecting the
+     * related source and destination providers streams
+     */
+    transferLinks(): Promise<void>;
+    /**
+     * Start the asset transfer by connecting the
+     * related source and destination providers streams
+     */
+    transferAssets(): Promise<void>;
+    /**
+     * Start the configuration transfer by connecting the
+     * related source and destination providers streams
+     */
+    transferConfiguration(): Promise<void>;
+}
+/**
+ * Options used to customize the TransferEngine behavior
+ *
+ * Note: Please add your suggestions. Also, we'll need to consider matching what is
+ * written for the CLI with those options at one point
+ *
+ * Note: here, we're listing the TransferEngine options, not the individual providers' options
+ */
+export interface ITransferEngineOptions {
+    /**
+     * What kind of version matching should be done between the source and the destination metadata?
+     * @example
+     * "exact" // must be a strict equality, whatever the format used
+     * "ignore" // do not check if versions match
+     * "major" // only the major version should match. 4.3.9 and 4.4.1 will work, while 3.3.2 and 4.3.2 won't
+     * "minor" // both the major and minor version should match. 4.3.9 and 4.3.11 will work, while 4.3.9 and 4.4.1 won't
+     * "patch" // every part of the version should match. Similar to "exact" but only work on semver.
+     */
+    versionStrategy: 'exact' | 'ignore' | 'major' | 'minor' | 'patch';
+    /**
+     * Strategy used to do the schema matching in the integrity checks
+     */
+    schemaStrategy: 'exact' | 'strict' | 'ignore';
+    transforms?: TransferTransforms;
+    exclude?: TransferFilterPreset[];
+    only?: TransferFilterPreset[];
+    throttle?: number;
+}
+//# sourceMappingURL=transfer-engine.d.ts.map

package/dist/types/transfer-engine.d.ts.map

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

package/dist/types/utils.d.ts

@@ -0,0 +1,83 @@
+/// <reference types="node" />
+import type { Duplex, Readable, Transform, Writable } from 'stream';
+import type { Knex } from 'knex';
+import type { Struct } from '@strapi/types';
+import type { IAsset, IEntity, ILink } from './common-entities';
+import type { IDestinationProvider, ISourceProvider } from './providers';
+export type MaybePromise<T> = T | Promise<T>;
+export type TransferStageTypeMap = {
+    schemas: Struct.Schema;
+    entities: IEntity;
+    links: ILink;
+    assets: IAsset;
+    configuration: unknown;
+};
+/**
+ * Define a transfer transform which will be used to intercept
+ * and potentially discard or modify the transferred data
+ */
+export type TransferTransform<T> = TransferFilter<T> | TransferMap<T>;
+export type TransferFilter<T> = {
+    filter: (data: T) => boolean;
+};
+export type TransferMap<T> = {
+    map: (data: T) => T;
+};
+export type Stream = Readable | Writable | Duplex | Transform;
+export type TransformFunction = (chunk: unknown, encoding?: string) => unknown;
+export type StreamItem = Stream | TransformFunction;
+export type TransferTransformsTypeMap = TransferStageTypeMap & {
+    global: unknown;
+};
+export type TransferStage = keyof TransferStageTypeMap;
+export type TransferTransformArray<T extends TransferTransformOption> = TransferTransform<TransferTransformsTypeMap[T]>[];
+export type TransferTransformOption = keyof TransferTransformsTypeMap;
+export type TransferTransforms = {
+    [key in TransferTransformOption]?: TransferTransformArray<key>;
+};
+export type TransferFilterArray<T extends TransferTransformOption> = TransferFilter<TransferTransforms[T]>[];
+export type TransferFilters = {
+    [key in TransferTransformOption]?: boolean | TransferFilterArray<key>;
+};
+export type StageTotalsEstimate = {
+    totalBytes?: number;
+    totalCount?: number;
+};
+/**
+ * Per-stage running progress. For `assets`, optional totals describe the full transfer when known
+ * (same basis as streamed data: one count per IAsset including formats; bytes = sum of binary file sizes).
+ */
+export type StageProgress = {
+    count: number;
+    bytes: number;
+    startTime: number;
+    endTime?: number;
+    /** Present when the source can estimate full stage size before/during streaming (e.g. asset library). */
+    totalBytes?: number;
+    /** Present when the source can estimate how many items the stage will emit. */
+    totalCount?: number;
+    aggregates?: {
+        [key: string]: {
+            count: number;
+            bytes: number;
+        };
+    };
+};
+export type TransferProgress = {
+    [key in TransferStage]?: StageProgress;
+};
+export interface ITransferResults<S extends ISourceProvider, D extends IDestinationProvider> {
+    source?: S['results'];
+    destination?: D['results'];
+    engine?: TransferProgress;
+}
+export type IProviderTransferResults = {};
+export type ISourceProviderTransferResults = {};
+export type IDestinationProviderTransferResults = {};
+export type TransactionCallback = (trx?: Knex.Transaction) => Promise<void>;
+export type Transaction = {
+    attach<T = undefined>(callback: TransactionCallback): Promise<T | undefined>;
+    end(): boolean;
+    rollback(): Promise<boolean>;
+};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/types/utils.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAG7C,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAEtE,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;AAC/E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAEpD,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,GAAG;IAC7D,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,uBAAuB,IAAI,iBAAiB,CACvF,yBAAyB,CAAC,CAAC,CAAC,CAC7B,EAAE,CAAC;AAEJ,MAAM,MAAM,uBAAuB,GAAG,MAAM,yBAAyB,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG;KAC9B,GAAG,IAAI,uBAAuB,CAAC,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAC;CAC/D,CAAC;AAKF,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,uBAAuB,IAAI,cAAc,CACjF,kBAAkB,CAAC,CAAC,CAAC,CACtB,EAAE,CAAC;AAEJ,MAAM,MAAM,eAAe,GAAG;KAC3B,GAAG,IAAI,uBAAuB,CAAC,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC;CACtE,CAAC;AAKF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE;QACX,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,KAAK,EAAE,MAAM,CAAC;YACd,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;KAC5B,GAAG,IAAI,aAAa,CAAC,CAAC,EAAE,aAAa;CACvC,CAAC;AAEF,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,SAAS,oBAAoB;IACzF,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAGD,MAAM,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC1C,MAAM,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAChD,MAAM,MAAM,mCAAmC,GAAG,EAAE,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7E,GAAG,IAAI,OAAO,CAAC;IACf,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B,CAAC"}

package/dist/utils/components.d.ts

@@ -16,6 +16,26 @@ declare const deleteComponents: <TUID extends UID.Schema, TEntity extends Data.E
     loadComponents?: boolean | undefined;
 }) => Promise<void>;
 declare const deleteComponent: <TUID extends `${string}.${string}`>(uid: TUID, componentToDelete: Data.Component<TUID>) => Promise<void>;
+interface IComponentIdMapping {
+    uid: UID.Component;
+    oldID: number;
+    newID: number;
+}
+/**
+ * Walk the source data and the newly created entity in parallel and collect
+ * the [old ID, new ID] couple of every component instance found in both trees
+ * (components & dynamic zones, including nested ones).
+ *
+ * Unlike a JSON diff, couples are also collected when the ID did not change,
+ * so the result is an exhaustive map of every component instance that was
+ * re-created with the entity.
+ */
+declare const collectComponentIdMappings: ({ data, created, schema, strapi, }: {
+    data: any;
+    created: any;
+    schema: Schema.Schema;
+    strapi: Core.Strapi;
+}) => IComponentIdMapping[];
 /**
  * Resolve the component UID of an entity's attribute based
  * on a given path (components & dynamic zones only)
@@ -26,5 +46,5 @@ declare const resolveComponentUID: ({ paths, strapi, data, contentType, }: {
     data: any;
     contentType: Schema.ContentType;
 }) => UID.Schema | undefined;
-export { omitComponentData, getComponents, createComponents, updateComponents, deleteComponents, deleteComponent, resolveComponentUID, };
+export { omitComponentData, getComponents, createComponents, updateComponents, deleteComponents, deleteComponent, collectComponentIdMappings, resolveComponentUID, };
 //# sourceMappingURL=components.d.ts.map

package/dist/utils/components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/utils/components.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAS,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE7E,KAAK,gBAAgB,CAAC,IAAI,SAAS,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAC1D,IAAI,EACJ,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAAC,CAC/D,CAAC;AAMF,KAAK,aAAa,GAAG;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CACjC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,GAChD,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAC/C,MAAM,CAAC,SAAS,CAAC,WAAW,CAC/B,CAAC;CACH,CAAC;AAIF,iBAAS,iBAAiB,CACxB,WAAW,EAAE,MAAM,CAAC,WAAW,EAC/B,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GACvE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC/E,iBAAS,iBAAiB,CACxB,WAAW,EAAE,MAAM,CAAC,SAAS,EAC7B,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GACrE,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAgB7E,QAAA,MAAM,gBAAgB,8FAIf,IAAI,QACH,KAAK,2BAgGZ,CAAC;AAEF,QAAA,MAAM,aAAa,iCACZ,IAAI,UACD;IAAE,EAAE,EAAE,QAAQ,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAA;CAAE,KACxD,QAAQ,iBAAiB,IAAI,CAAC,CAQhC,CAAC;AAMF,QAAA,MAAM,gBAAgB,uGAIf,IAAI,kBACO;IAAE,EAAE,EAAE,QAAQ,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAA;CAAE,QAC3D,KAAK,2BA0FZ,CAAC;AAkGF,QAAA,MAAM,gBAAgB,oHACf,IAAI,kBACO,OAAO;;mBA6CxB,CAAC;AA8DF,QAAA,MAAM,eAAe,4CACd,IAAI,qBACU,KAAK,SAAS,CAAC,IAAI,CAAC,kBAIxC,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,mBAAmB,0CAKtB;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,KAAK,MAAM,CAAC;IACpB,IAAI,EAAE,GAAG,CAAC;IACV,WAAW,EAAE,OAAO,WAAW,CAAC;CACjC,KAAG,IAAI,MAAM,GAAG,SAiChB,CAAC;AAEF,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,CAAC"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/utils/components.ts"],"names":[],"mappings":"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"}

package/dist/utils/components.js

@@ -141,38 +141,86 @@ const deleteComponent = async (uid, componentToDelete)=>{
     });
 };
 /**
- * Resolve the component UID of an entity's attribute based
- * on a given path (components & dynamic zones only)
- */ const resolveComponentUID = ({ paths, strapi: strapi1, data, contentType })=>{
-    let value = data;
-    let cType = contentType;
-    for (const path of paths){
-        value = fp.get(path, value);
-        // Needed when the value of cType should be computed
-        // based on the next value (eg: dynamic zones)
-        if (typeof cType === 'function') {
-            cType = cType(value);
+ * Walk the source data and the newly created entity in parallel and collect
+ * the [old ID, new ID] couple of every component instance found in both trees
+ * (components & dynamic zones, including nested ones).
+ *
+ * Unlike a JSON diff, couples are also collected when the ID did not change,
+ * so the result is an exhaustive map of every component instance that was
+ * re-created with the entity.
+ */ const collectComponentIdMappings = ({ data, created, schema, strapi: strapi1 })=>{
+    const mappings = [];
+    const visitComponent = (uid, oldValue, newValue)=>{
+        if (!_.isObjectLike(oldValue) || !_.isObjectLike(newValue)) {
+            return;
         }
-        if (path in cType.attributes) {
-            const attribute = cType.attributes[path];
+        if (typeof oldValue.id === 'number' && typeof newValue.id === 'number') {
+            mappings.push({
+                uid,
+                oldID: oldValue.id,
+                newID: newValue.id
+            });
+        }
+        const componentSchema = strapi1.getModel(uid);
+        // Collect nested components & dynamic zones
+        if (componentSchema) {
+            visitSchema(componentSchema, oldValue, newValue);
+        }
+    };
+    const visitSchema = (currentSchema, oldData, newData)=>{
+        if (!_.isObjectLike(oldData) || !_.isObjectLike(newData)) {
+            return;
+        }
+        const { attributes = {} } = currentSchema;
+        for (const [attributeName, attribute] of Object.entries(attributes)){
+            const oldValue = oldData[attributeName];
+            const newValue = newData[attributeName];
+            if (_.isNil(oldValue) || _.isNil(newValue)) {
+                continue;
+            }
             if (attribute.type === 'component') {
-                cType = strapi1.getModel(attribute.component);
+                const { component: componentUID, repeatable = false } = attribute;
+                if (repeatable === true) {
+                    if (!Array.isArray(oldValue) || !Array.isArray(newValue)) {
+                        continue;
+                    }
+                    // Components are created (and thus populated back) in the same
+                    // order as the source data, pair them by index
+                    const length = Math.min(oldValue.length, newValue.length);
+                    for(let i = 0; i < length; i += 1){
+                        visitComponent(componentUID, oldValue[i], newValue[i]);
+                    }
+                } else {
+                    visitComponent(componentUID, oldValue, newValue);
+                }
             }
             if (attribute.type === 'dynamiczone') {
-                cType = ({ __component })=>strapi1.getModel(__component);
+                if (!Array.isArray(oldValue) || !Array.isArray(newValue)) {
+                    continue;
+                }
+                const length = Math.min(oldValue.length, newValue.length);
+                for(let i = 0; i < length; i += 1){
+                    const oldItem = oldValue[i];
+                    const newItem = newValue[i];
+                    const componentUID = oldItem?.__component;
+                    // Both items must reference the same dynamic zone component for the
+                    // ID couple to be meaningful
+                    if (!componentUID || newItem?.__component && newItem.__component !== componentUID) {
+                        continue;
+                    }
+                    visitComponent(componentUID, oldItem, newItem);
+                }
             }
         }
-    }
-    if ('uid' in cType) {
-        return cType.uid;
-    }
-    return undefined;
+    };
+    visitSchema(schema, data, created);
+    return mappings;
 };
 
+exports.collectComponentIdMappings = collectComponentIdMappings;
 exports.createComponents = createComponents;
 exports.deleteComponent = deleteComponent;
 exports.deleteComponents = deleteComponents;
 exports.getComponents = getComponents;
 exports.omitComponentData = omitComponentData;
-exports.resolveComponentUID = resolveComponentUID;
 //# sourceMappingURL=components.js.map