@strapi/data-transfer 5.48.0 → 5.49.0

package/dist/strapi/utils/project-settings-logos.mjs

@@ -0,0 +1,169 @@
+import { join } from 'path';
+import { Readable } from 'stream';
+import { pick } from 'lodash/fp';
+import { readFile } from 'fs-extra';
+import { lookup } from 'mime-types';
+
+const PROJECT_SETTINGS_CORE_STORE_KEY = 'core_admin_project-settings';
+// The shape persisted back to core-store, matching what the admin project-settings
+// service stores (so the admin UI keeps behaving identically after a transfer).
+const LOGO_PERSISTED_FIELDS = [
+    'name',
+    'hash',
+    'url',
+    'width',
+    'height',
+    'ext',
+    'size',
+    'provider'
+];
+const isProjectSettingsRow = (row)=>row.key === PROJECT_SETTINGS_CORE_STORE_KEY;
+const getConfiguredUploadProvider = (strapi)=>strapi.config.get('plugin::upload')?.provider;
+// Admin logos with no provider were uploaded with the local provider (the default).
+const isLocalProviderLogo = (logo)=>!logo.provider || logo.provider === 'local';
+// Best-effort mime type for a logo so that remote providers (S3, Cloudinary, …)
+// store the correct Content-Type and the image renders instead of downloading.
+// The admin does not persist the mime type, so it is reconstructed from the
+// file extension (falling back to the file name).
+const getLogoMimeType = (logo)=>{
+    const fromExt = logo.ext ? lookup(logo.ext) : false;
+    if (fromExt) {
+        return fromExt;
+    }
+    const fromName = logo.name ? lookup(logo.name) : false;
+    if (fromName) {
+        return fromName;
+    }
+    return undefined;
+};
+/**
+ * Resolve the URL to read a non-local logo from during export.
+ *
+ * Mirrors the media-library asset export: when the file lives on the
+ * currently-configured provider and that provider serves private files,
+ * a signed URL is generated so the bytes can be fetched.
+ */ const getRemoteLogoUrl = async (strapi, logo)=>{
+    const { provider } = strapi.plugins.upload;
+    const providerName = getConfiguredUploadProvider(strapi);
+    if (logo.provider === providerName && typeof provider?.isPrivate === 'function' && typeof provider?.getSignedUrl === 'function' && await provider.isPrivate()) {
+        const { url } = await provider.getSignedUrl(logo);
+        return url;
+    }
+    return logo.url;
+};
+const logoLabel = (logo)=>logo.name ?? logo.hash ?? 'unknown';
+const readLocalLogoBuffer = async (strapi, logo)=>{
+    const filepath = join(strapi.dirs.static.public, logo.url);
+    try {
+        const buffer = await readFile(filepath);
+        return buffer.toString('base64');
+    } catch (error) {
+        const code = error && typeof error === 'object' && 'code' in error ? error.code : undefined;
+        if (code === 'ENOENT') {
+            strapi.log.warn(`[Data transfer] Admin logo "${logoLabel(logo)}" exists in project settings but no corresponding file was found to transfer. Path: ${filepath}`);
+            return undefined;
+        }
+        throw error;
+    }
+};
+const readRemoteLogoBuffer = async (strapi, logo)=>{
+    const url = await getRemoteLogoUrl(strapi, logo);
+    const response = await strapi.fetch(url);
+    if (response.status !== 200 || !response.body) {
+        strapi.log.warn(`[Data transfer] Admin logo "${logoLabel(logo)}" exists in project settings but could not be fetched for transfer. URL: ${url} (status: ${response.status})`);
+        return undefined;
+    }
+    const chunks = [];
+    for await (const chunk of Readable.fromWeb(response.body)){
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('base64');
+};
+const readLogoTransferBuffer = async (strapi, logo)=>{
+    if (!logo.url) {
+        return undefined;
+    }
+    if (isLocalProviderLogo(logo)) {
+        return readLocalLogoBuffer(strapi, logo);
+    }
+    return readRemoteLogoBuffer(strapi, logo);
+};
+const enrichLogoForExport = async (strapi, logo)=>{
+    if (!logo?.url) {
+        return logo;
+    }
+    const transferBuffer = await readLogoTransferBuffer(strapi, logo);
+    if (!transferBuffer) {
+        return logo;
+    }
+    return {
+        ...logo,
+        __transferBuffer: transferBuffer
+    };
+};
+const enrichProjectSettingsForExport = async (strapi, row)=>{
+    if (!isProjectSettingsRow(row)) {
+        return row;
+    }
+    const settings = row.value;
+    const [menuLogo, authLogo] = await Promise.all([
+        enrichLogoForExport(strapi, settings.menuLogo),
+        enrichLogoForExport(strapi, settings.authLogo)
+    ]);
+    return {
+        ...row,
+        value: {
+            ...settings,
+            menuLogo,
+            authLogo
+        }
+    };
+};
+/**
+ * Re-upload a transferred logo to the destination's configured upload provider.
+ *
+ * The file is always re-uploaded through the destination provider, so the
+ * persisted `url` and `provider` reflect the destination (matching how the
+ * media-library asset restore behaves). A best-effort mime type is supplied so
+ * remote providers serve the logo with the correct Content-Type.
+ */ const uploadLogoFromTransferBuffer = async (strapi, logo)=>{
+    if (!logo.__transferBuffer) {
+        return logo;
+    }
+    const { __transferBuffer, ...logoWithoutBuffer } = logo;
+    const provider = getConfiguredUploadProvider(strapi);
+    const mime = getLogoMimeType(logoWithoutBuffer);
+    const file = {
+        ...logoWithoutBuffer,
+        ...mime ? {
+            mime
+        } : {},
+        stream: Readable.from(Buffer.from(__transferBuffer, 'base64')),
+        provider
+    };
+    await strapi.plugin('upload').provider.uploadStream(file);
+    return pick(LOGO_PERSISTED_FIELDS, file);
+};
+const restoreProjectSettingsLogos = async (strapi, settings)=>{
+    const [menuLogo, authLogo] = await Promise.all([
+        settings.menuLogo ? uploadLogoFromTransferBuffer(strapi, settings.menuLogo) : settings.menuLogo,
+        settings.authLogo ? uploadLogoFromTransferBuffer(strapi, settings.authLogo) : settings.authLogo
+    ]);
+    return {
+        ...settings,
+        menuLogo,
+        authLogo
+    };
+};
+const restoreProjectSettingsRow = async (strapi, row)=>{
+    if (!isProjectSettingsRow(row)) {
+        return row;
+    }
+    return {
+        ...row,
+        value: await restoreProjectSettingsLogos(strapi, row.value)
+    };
+};
+
+export { PROJECT_SETTINGS_CORE_STORE_KEY, enrichProjectSettingsForExport, restoreProjectSettingsLogos, restoreProjectSettingsRow };
+//# sourceMappingURL=project-settings-logos.mjs.map

package/dist/strapi/utils/project-settings-logos.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-settings-logos.mjs","sources":["../../../src/strapi/utils/project-settings-logos.ts"],"sourcesContent":["import { join } from 'path';\nimport { Readable } from 'stream';\nimport { pick } from 'lodash/fp';\nimport { readFile } from 'fs-extra';\nimport { lookup as lookupMimeType } from 'mime-types';\nimport * as webStream from 'stream/web';\nimport type { Core } from '@strapi/types';\n\nexport const PROJECT_SETTINGS_CORE_STORE_KEY = 'core_admin_project-settings';\n\nexport const PROJECT_SETTINGS_LOGO_FIELDS = ['menuLogo', 'authLogo'] as const;\n\nexport type ProjectSettingsLogoField = (typeof PROJECT_SETTINGS_LOGO_FIELDS)[number];\n\nexport type ProjectSettingsLogo = {\n  name?: string;\n  hash?: string;\n  url?: string;\n  width?: number;\n  height?: number;\n  ext?: string;\n  size?: number;\n  mime?: string;\n  provider?: string;\n  __transferBuffer?: string;\n};\n\nexport type ProjectSettingsStoreValue = {\n  menuLogo?: ProjectSettingsLogo | null;\n  authLogo?: ProjectSettingsLogo | null;\n};\n\nexport type CoreStoreRow = {\n  key: string;\n  value: unknown;\n  [key: string]: unknown;\n};\n\n// The shape persisted back to core-store, matching what the admin project-settings\n// service stores (so the admin UI keeps behaving identically after a transfer).\nconst LOGO_PERSISTED_FIELDS = [\n  'name',\n  'hash',\n  'url',\n  'width',\n  'height',\n  'ext',\n  'size',\n  'provider',\n] as const;\n\nconst isProjectSettingsRow = (row: CoreStoreRow) => row.key === PROJECT_SETTINGS_CORE_STORE_KEY;\n\nconst getConfiguredUploadProvider = (strapi: Core.Strapi) =>\n  (strapi.config.get('plugin::upload') as { provider?: string } | undefined)?.provider;\n\n// Admin logos with no provider were uploaded with the local provider (the default).\nconst isLocalProviderLogo = (logo: ProjectSettingsLogo) =>\n  !logo.provider || logo.provider === 'local';\n\n// Best-effort mime type for a logo so that remote providers (S3, Cloudinary, …)\n// store the correct Content-Type and the image renders instead of downloading.\n// The admin does not persist the mime type, so it is reconstructed from the\n// file extension (falling back to the file name).\nconst getLogoMimeType = (logo: ProjectSettingsLogo): string | undefined => {\n  const fromExt = logo.ext ? lookupMimeType(logo.ext) : false;\n  if (fromExt) {\n    return fromExt;\n  }\n\n  const fromName = logo.name ? lookupMimeType(logo.name) : false;\n  if (fromName) {\n    return fromName;\n  }\n\n  return undefined;\n};\n\n/**\n * Resolve the URL to read a non-local logo from during export.\n *\n * Mirrors the media-library asset export: when the file lives on the\n * currently-configured provider and that provider serves private files,\n * a signed URL is generated so the bytes can be fetched.\n */\nconst getRemoteLogoUrl = async (strapi: Core.Strapi, logo: ProjectSettingsLogo) => {\n  const { provider } = strapi.plugins.upload;\n  const providerName = getConfiguredUploadProvider(strapi);\n\n  if (\n    logo.provider === providerName &&\n    typeof provider?.isPrivate === 'function' &&\n    typeof provider?.getSignedUrl === 'function' &&\n    (await provider.isPrivate())\n  ) {\n    const { url } = await provider.getSignedUrl(logo);\n    return url;\n  }\n\n  return logo.url;\n};\n\nconst logoLabel = (logo: ProjectSettingsLogo) => logo.name ?? logo.hash ?? 'unknown';\n\nconst readLocalLogoBuffer = async (strapi: Core.Strapi, logo: ProjectSettingsLogo) => {\n  const filepath = join(strapi.dirs.static.public, logo.url as string);\n\n  try {\n    const buffer = await readFile(filepath);\n    return buffer.toString('base64');\n  } catch (error) {\n    const code =\n      error && typeof error === 'object' && 'code' in error\n        ? (error as NodeJS.ErrnoException).code\n        : undefined;\n\n    if (code === 'ENOENT') {\n      strapi.log.warn(\n        `[Data transfer] Admin logo \"${logoLabel(logo)}\" exists in project settings but no corresponding file was found to transfer. Path: ${filepath}`\n      );\n      return undefined;\n    }\n\n    throw error;\n  }\n};\n\nconst readRemoteLogoBuffer = async (strapi: Core.Strapi, logo: ProjectSettingsLogo) => {\n  const url = await getRemoteLogoUrl(strapi, logo);\n  const response = await strapi.fetch(url);\n\n  if (response.status !== 200 || !response.body) {\n    strapi.log.warn(\n      `[Data transfer] Admin logo \"${logoLabel(logo)}\" exists in project settings but could not be fetched for transfer. URL: ${url} (status: ${response.status})`\n    );\n    return undefined;\n  }\n\n  const chunks: Uint8Array[] = [];\n\n  for await (const chunk of Readable.fromWeb(\n    response.body as webStream.ReadableStream<Uint8Array>\n  )) {\n    chunks.push(chunk);\n  }\n\n  return Buffer.concat(chunks).toString('base64');\n};\n\nconst readLogoTransferBuffer = async (strapi: Core.Strapi, logo: ProjectSettingsLogo) => {\n  if (!logo.url) {\n    return undefined;\n  }\n\n  if (isLocalProviderLogo(logo)) {\n    return readLocalLogoBuffer(strapi, logo);\n  }\n\n  return readRemoteLogoBuffer(strapi, logo);\n};\n\nconst enrichLogoForExport = async (\n  strapi: Core.Strapi,\n  logo: ProjectSettingsLogo | null | undefined\n) => {\n  if (!logo?.url) {\n    return logo;\n  }\n\n  const transferBuffer = await readLogoTransferBuffer(strapi, logo);\n\n  if (!transferBuffer) {\n    return logo;\n  }\n\n  return {\n    ...logo,\n    __transferBuffer: transferBuffer,\n  };\n};\n\nexport const enrichProjectSettingsForExport = async (\n  strapi: Core.Strapi,\n  row: CoreStoreRow\n): Promise<CoreStoreRow> => {\n  if (!isProjectSettingsRow(row)) {\n    return row;\n  }\n\n  const settings = row.value as ProjectSettingsStoreValue;\n\n  const [menuLogo, authLogo] = await Promise.all([\n    enrichLogoForExport(strapi, settings.menuLogo),\n    enrichLogoForExport(strapi, settings.authLogo),\n  ]);\n\n  return {\n    ...row,\n    value: {\n      ...settings,\n      menuLogo,\n      authLogo,\n    },\n  };\n};\n\n/**\n * Re-upload a transferred logo to the destination's configured upload provider.\n *\n * The file is always re-uploaded through the destination provider, so the\n * persisted `url` and `provider` reflect the destination (matching how the\n * media-library asset restore behaves). A best-effort mime type is supplied so\n * remote providers serve the logo with the correct Content-Type.\n */\nconst uploadLogoFromTransferBuffer = async (strapi: Core.Strapi, logo: ProjectSettingsLogo) => {\n  if (!logo.__transferBuffer) {\n    return logo;\n  }\n\n  const { __transferBuffer, ...logoWithoutBuffer } = logo;\n  const provider = getConfiguredUploadProvider(strapi);\n  const mime = getLogoMimeType(logoWithoutBuffer);\n\n  const file = {\n    ...logoWithoutBuffer,\n    ...(mime ? { mime } : {}),\n    stream: Readable.from(Buffer.from(__transferBuffer, 'base64')),\n    provider,\n  };\n\n  await strapi.plugin('upload').provider.uploadStream(file);\n\n  return pick(LOGO_PERSISTED_FIELDS, file);\n};\n\nexport const restoreProjectSettingsLogos = async (\n  strapi: Core.Strapi,\n  settings: ProjectSettingsStoreValue\n): Promise<ProjectSettingsStoreValue> => {\n  const [menuLogo, authLogo] = await Promise.all([\n    settings.menuLogo ? uploadLogoFromTransferBuffer(strapi, settings.menuLogo) : settings.menuLogo,\n    settings.authLogo ? uploadLogoFromTransferBuffer(strapi, settings.authLogo) : settings.authLogo,\n  ]);\n\n  return {\n    ...settings,\n    menuLogo,\n    authLogo,\n  };\n};\n\nexport const restoreProjectSettingsRow = async (strapi: Core.Strapi, row: CoreStoreRow) => {\n  if (!isProjectSettingsRow(row)) {\n    return row;\n  }\n\n  return {\n    ...row,\n    value: await restoreProjectSettingsLogos(strapi, row.value as ProjectSettingsStoreValue),\n  };\n};\n"],"names":["PROJECT_SETTINGS_CORE_STORE_KEY","LOGO_PERSISTED_FIELDS","isProjectSettingsRow","row","key","getConfiguredUploadProvider","strapi","config","get","provider","isLocalProviderLogo","logo","getLogoMimeType","fromExt","ext","lookupMimeType","fromName","name","undefined","getRemoteLogoUrl","plugins","upload","providerName","isPrivate","getSignedUrl","url","logoLabel","hash","readLocalLogoBuffer","filepath","join","dirs","static","public","buffer","readFile","toString","error","code","log","warn","readRemoteLogoBuffer","response","fetch","status","body","chunks","chunk","Readable","fromWeb","push","Buffer","concat","readLogoTransferBuffer","enrichLogoForExport","transferBuffer","__transferBuffer","enrichProjectSettingsForExport","settings","value","menuLogo","authLogo","Promise","all","uploadLogoFromTransferBuffer","logoWithoutBuffer","mime","file","stream","from","plugin","uploadStream","pick","restoreProjectSettingsLogos","restoreProjectSettingsRow"],"mappings":"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"}

package/dist/types/common-entities.d.ts

@@ -0,0 +1,152 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+import type { Readable } from 'stream';
+import type { Schema, Data, UID } from '@strapi/types';
+export interface IMetadata {
+    strapi?: {
+        version?: string;
+    };
+    createdAt?: string;
+}
+/**
+ * Common TransferEngine format to represent a Strapi entity
+ * @template T The schema UID this entity represents
+ */
+export interface IEntity<T extends UID.ContentType = UID.ContentType> {
+    /**
+     * UID of the parent type (content-type, component, etc...)
+     */
+    type: T;
+    /**
+     * Reference of the entity.
+     * Might be deprecated and replaced by a "ref" or "reference" property in the future
+     */
+    id: number;
+    /**
+     * The entity data (attributes value)
+     */
+    data: Data.Entity<T>;
+}
+/**
+ * Union type that regroups all the different kinds of link
+ */
+export type ILink = IBasicLink | IMorphLink | ICircularLink;
+/**
+ * Default generic link structure
+ */
+interface IDefaultLink {
+    /**
+     * The link type
+     * (useful for providers (destination) to adapt the logic following what kind of link is processed)
+     */
+    kind: string;
+    /**
+     * The relation type
+     */
+    relation: Schema.Attribute.RelationKind.Any;
+    /**
+     * Left side of the link
+     * It should hold information about the entity that owns the dominant side of the link
+     */
+    left: {
+        /**
+         * Entity UID
+         * (restricted to content type)
+         */
+        type: string;
+        /**
+         * Reference ID of the entity
+         */
+        ref: number;
+        /**
+         * Field used to hold the link in the entity
+         */
+        field: string;
+        /**
+         * If the link is part of a collection, keep its position here
+         */
+        pos?: number;
+    };
+    /**
+     * Right side of the link
+     * It should hold information about the entity attached to the left side of the link
+     */
+    right: {
+        /**
+         * Entity UID
+         * (can be a content type or a component)
+         */
+        type: string;
+        /**
+         * Reference ID of the entity
+         */
+        ref: number;
+        /**
+         * Field used to hold the link in the entity
+         */
+        field?: string;
+        /**
+         * If the link is part of a collection, keep its position here
+         */
+        pos?: number;
+    };
+}
+/**
+ * Basic link between two content type entities
+ */
+interface IBasicLink extends IDefaultLink {
+    kind: 'relation.basic';
+}
+/**
+ * Polymorphic link (one source content type to multiple different content types)
+ */
+interface IMorphLink extends IDefaultLink {
+    kind: 'relation.morph';
+}
+/**
+ * Regular link with the left and right sides having the save content-type
+ */
+interface ICircularLink extends IDefaultLink {
+    kind: 'relation.circular';
+}
+/**
+ * Strapi configurations
+ */
+export interface IConfiguration<T = unknown> {
+    type: 'core-store' | 'webhook';
+    value: T;
+}
+export interface IFile {
+    id: number;
+    name: string;
+    alternativeText?: string;
+    caption?: string;
+    width?: number;
+    height?: number;
+    formats?: Record<string, IFile>;
+    hash: string;
+    ext?: string;
+    mime: string;
+    size: number;
+    url: string;
+    previewUrl?: string;
+    path?: string;
+    provider?: string;
+    provider_metadata?: Record<string, unknown>;
+    type?: string;
+    mainHash?: string;
+}
+export interface IAsset {
+    filename: string;
+    filepath: string;
+    stream: Readable;
+    stats: IAssetStats;
+    metadata: IFile;
+    buffer?: Buffer;
+}
+export interface IAssetStats {
+    size: number;
+}
+export {};
+//# sourceMappingURL=common-entities.d.ts.map

package/dist/types/common-entities.d.ts.map

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

package/dist/types/encryption.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="node" />
+import type { Cipheriv, Decipheriv } from 'crypto';
+export type EncryptionStrategy = (key: string) => Cipheriv | Decipheriv;
+export type Strategies = {
+    'aes-128-ecb': (key: string) => Cipheriv | Decipheriv;
+    aes128: (key: string) => Cipheriv | Decipheriv;
+    aes192: (key: string) => Cipheriv | Decipheriv;
+    aes256: (key: string) => Cipheriv | Decipheriv;
+};
+export type Algorithm = 'aes-128-ecb' | 'aes128' | 'aes192' | 'aes256';
+//# sourceMappingURL=encryption.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/types/encryption.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEnD,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ,GAAG,UAAU,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG;IACvB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ,GAAG,UAAU,CAAC;IACtD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ,GAAG,UAAU,CAAC;IAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ,GAAG,UAAU,CAAC;IAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,QAAQ,GAAG,UAAU,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export * from './common-entities';
+export * from './providers';
+export * from './transfer-engine';
+export * from './utils';
+export * from './encryption';
+export * from './remote';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/dist/types/providers.d.ts

@@ -0,0 +1,50 @@
+/// <reference types="node" />
+import type { Readable, Writable } from 'stream';
+import type { Struct } from '@strapi/types';
+import type { IDestinationProviderTransferResults, IProviderTransferResults, ISourceProviderTransferResults, MaybePromise, StageTotalsEstimate, TransferStage } from './utils';
+import type { IMetadata } from './common-entities';
+import type { IDiagnosticReporter } from '../utils/diagnostic';
+export type ProviderType = 'source' | 'destination';
+export interface IProvider {
+    type: ProviderType;
+    name: string;
+    results?: IProviderTransferResults;
+    /**
+     * bootstrap() is called during transfer engine bootstrap
+     * It is used for initialization operations such as making a database connection, opening a file, checking authorization, etc
+     */
+    bootstrap?(diagnostics?: IDiagnosticReporter): MaybePromise<void>;
+    close?(): MaybePromise<void>;
+    getMetadata(): MaybePromise<IMetadata | null>;
+    getSchemas?(): MaybePromise<Record<string, Struct.Schema> | null>;
+    beforeTransfer?(): MaybePromise<void>;
+}
+export interface ISourceProvider extends IProvider {
+    results?: ISourceProviderTransferResults;
+    /**
+     * Optional totals for a stage. Called by the engine after the stage read stream is created and before `stage::start`.
+     * Used for CLI progress (e.g. bytes/count remaining, ETA). Omit or return null when unknown (older remotes, file providers).
+     */
+    getStageTotals?(stage: TransferStage): MaybePromise<StageTotalsEstimate | null | undefined>;
+    createEntitiesReadStream?(): MaybePromise<Readable>;
+    createLinksReadStream?(): MaybePromise<Readable>;
+    createAssetsReadStream?(): MaybePromise<Readable>;
+    createConfigurationReadStream?(): MaybePromise<Readable>;
+    createSchemasReadStream?(): MaybePromise<Readable>;
+}
+export interface IDestinationProvider extends IProvider {
+    results?: IDestinationProviderTransferResults;
+    /**
+     * Optional rollback implementation
+     * Called when an error is thrown during a transfer to allow rollback operations to be performed
+     */
+    rollback?<T extends Error = Error>(e: T): MaybePromise<void>;
+    setMetadata?(target: ProviderType, metadata: IMetadata): IDestinationProvider;
+    onWarning?: (message: string) => void;
+    createEntitiesWriteStream?(): MaybePromise<Writable>;
+    createLinksWriteStream?(): MaybePromise<Writable>;
+    createAssetsWriteStream?(): MaybePromise<Writable>;
+    createConfigurationWriteStream?(): MaybePromise<Writable>;
+    createSchemasWriteStream?(): MaybePromise<Writable>;
+}
+//# sourceMappingURL=providers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/types/providers.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EACV,mCAAmC,EACnC,wBAAwB,EACxB,8BAA8B,EAC9B,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACd,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,wBAAwB,CAAC;IAEnC;;;OAGG;IACH,SAAS,CAAC,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE7B,WAAW,IAAI,YAAY,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC9C,UAAU,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAElE,cAAc,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,OAAO,CAAC,EAAE,8BAA8B,CAAC;IAEzC;;;OAGG;IACH,cAAc,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAAC,mBAAmB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAE5F,wBAAwB,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpD,qBAAqB,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACjD,sBAAsB,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IAClD,6BAA6B,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzD,uBAAuB,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD,OAAO,CAAC,EAAE,mCAAmC,CAAC;IAE9C;;;OAGG;IACH,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAE7D,WAAW,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,GAAG,oBAAoB,CAAC;IAC9E,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEtC,yBAAyB,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrD,sBAAsB,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IAClD,uBAAuB,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACnD,8BAA8B,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1D,wBAAwB,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;CACrD"}

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

@@ -0,0 +1,2 @@
+export * as Protocol from './protocol';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,5 @@
+export interface ITransferTokenAuth {
+    type: 'token';
+    token: string;
+}
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/types/remote/protocol/auth.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/remote/protocol/client/commands.d.ts

@@ -0,0 +1,37 @@
+import type { ILocalStrapiDestinationProviderOptions } from '../../../../strapi/providers';
+import type { TransferMethod } from '../../../../strapi/remote/constants';
+export type CommandMessage = {
+    type: 'command';
+} & (InitCommand | EndCommand | StatusCommand);
+export type Command = CommandMessage['command'];
+export type GetCommandParams<T extends Command> = {
+    [key in Command]: {
+        command: key;
+    } & CommandMessage;
+}[T] extends {
+    params: infer U;
+} ? U : never;
+export type InitCommand = CreateCommand<'init', {
+    options?: Pick<ILocalStrapiDestinationProviderOptions, 'strategy' | 'restore'>;
+    transfer: TransferMethod;
+    checksums?: boolean;
+    /**
+     * Opt-in request for the compact base64 asset-chunk wire format. Remotes that understand it
+     * echo it back in {@link InitMessage}; older remotes ignore it and the client falls back to
+     * the legacy `{ type: 'Buffer', data: number[] }` shape they can still decode.
+     */
+    assetEncoding?: 'base64';
+}>;
+export type TransferKind = InitCommand['params']['transfer'];
+export type EndCommand = CreateCommand<'end', {
+    transferID: string;
+}>;
+export type StatusCommand = CreateCommand<'status'>;
+type CreateCommand<T extends string, U extends Record<string, unknown> = never> = {
+    type: 'command';
+    command: T;
+} & ([U] extends [never] ? unknown : {
+    params: U;
+});
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/types/remote/protocol/client/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../../../src/types/remote/protocol/client/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sCAAsC,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,CAAC,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC,CAAC;AAE9F,MAAM,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;AAEhD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,OAAO,IAAI;KAC/C,GAAG,IAAI,OAAO,GAAG;QAAE,OAAO,EAAE,GAAG,CAAA;KAAE,GAAG,cAAc;CACpD,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC5B,CAAC,GACD,KAAK,CAAC;AAEV,MAAM,MAAM,WAAW,GAAG,aAAa,CACrC,MAAM,EACN;IACE,OAAO,CAAC,EAAE,IAAI,CAAC,sCAAsC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;IAC/E,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,aAAa,CAAC,EAAE,QAAQ,CAAC;CAC1B,CACF,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC;AAE7D,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtE,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAEpD,KAAK,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,IAAI;IAChF,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,CAAC,CAAC;CACZ,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,GAAG;IAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { CommandMessage } from './commands';
+import type { TransferMessage } from './transfer';
+export * from './commands';
+export * from './transfer';
+export type Message = {
+    uuid: string;
+} & (CommandMessage | TransferMessage);
+export type MessageType = Message['type'];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/types/remote/protocol/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,CAAC,cAAc,GAAG,eAAe,CAAC,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { CreateTransferMessage } from './utils';
+export type Action = CreateTransferMessage<'action', {
+    action: string;
+}>;
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../../../../src/types/remote/protocol/client/transfer/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { Action } from './action';
+import type { TransferPullMessage } from './pull';
+import type { TransferPushMessage } from './push';
+export * from './action';
+export * from './pull';
+export * from './push';
+export * from './utils';
+export type TransferMessage = {
+    type: 'transfer';
+    transferID: string;
+} & (Action | TransferPushMessage | TransferPullMessage);
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/types/remote/protocol/client/transfer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAElD,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AAExB,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,CACrE,MAAM,GACN,mBAAmB,GACnB,mBAAmB,CACtB,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { IEntity, ILink, IConfiguration } from '../../../../common-entities';
+import { CreateTransferMessage, TransferAssetFlow } from './utils';
+export type TransferPullMessage = CreateTransferMessage<'step', TransferStepCommands<'entities', IEntity[]> | TransferStepCommands<'links', ILink[]> | TransferStepCommands<'configuration', IConfiguration[]> | TransferStepCommands<'assets', TransferAssetFlow[]>>;
+export type TransferPullStep = TransferPullMessage['step'];
+export type GetTransferPullStreamData<T extends TransferPullStep> = {
+    [key in TransferPullStep]: {
+        action: 'stream';
+        step: key;
+    } & TransferPullMessage;
+}[T] extends {
+    data: infer U;
+} ? U : never;
+type TransferStepCommands<T extends string, U> = {
+    step: T;
+} & TransferStepFlow<U>;
+type TransferStepFlow<U> = {
+    action: 'start';
+} | {
+    action: 'stream';
+    data: U;
+} | {
+    action: 'end';
+};
+export {};
+//# sourceMappingURL=pull.d.ts.map

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"}