@strapi/data-transfer 4.13.0 → 4.13.2

package/dist/strapi/remote/handlers/push.js

@@ -0,0 +1,311 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPushController = void 0;
+const crypto_1 = require("crypto");
+const stream_1 = require("stream");
+const providers_1 = require("../../../errors/providers");
+const providers_2 = require("../../providers");
+const flows_1 = require("../flows");
+const utils_1 = require("./utils");
+const VALID_TRANSFER_ACTIONS = [
+    'bootstrap',
+    'close',
+    'rollback',
+    'beforeTransfer',
+    'getMetadata',
+    'getSchemas',
+];
+const TRANSFER_KIND = 'push';
+const writeAsync = (stream, data) => {
+    return new Promise((resolve, reject) => {
+        stream.write(data, (error) => {
+            if (error) {
+                reject(error);
+            }
+            resolve();
+        });
+    });
+};
+exports.createPushController = (0, utils_1.handlerControllerFactory)((proto) => ({
+    isTransferStarted() {
+        return proto.isTransferStarted.call(this) && this.provider !== undefined;
+    },
+    verifyAuth() {
+        return proto.verifyAuth.call(this, TRANSFER_KIND);
+    },
+    cleanup() {
+        proto.cleanup.call(this);
+        this.streams = {};
+        this.assets = {};
+        delete this.flow;
+        delete this.provider;
+    },
+    teardown() {
+        if (this.provider) {
+            this.provider.rollback();
+        }
+        proto.teardown.call(this);
+    },
+    assertValidTransfer() {
+        proto.assertValidTransfer.call(this);
+        if (this.provider === undefined) {
+            throw new Error('Invalid Transfer Process');
+        }
+    },
+    assertValidTransferAction(action) {
+        if (VALID_TRANSFER_ACTIONS.includes(action)) {
+            return;
+        }
+        throw new providers_1.ProviderTransferError(`Invalid action provided: "${action}"`, {
+            action,
+            validActions: Object.keys(VALID_TRANSFER_ACTIONS),
+        });
+    },
+    assertValidStreamTransferStep(stage) {
+        const currentStep = this.flow?.get();
+        const nextStep = { kind: 'transfer', stage };
+        if (currentStep?.kind === 'transfer' && !currentStep.locked) {
+            throw new providers_1.ProviderTransferError(`You need to initialize the transfer stage (${nextStep}) before starting to stream data`);
+        }
+        if (this.flow?.cannot(nextStep)) {
+            throw new providers_1.ProviderTransferError(`Invalid stage (${nextStep}) provided for the current flow`, {
+                step: nextStep,
+            });
+        }
+    },
+    async createWritableStreamForStep(step) {
+        const mapper = {
+            entities: () => this.provider?.createEntitiesWriteStream(),
+            links: () => this.provider?.createLinksWriteStream(),
+            configuration: () => this.provider?.createConfigurationWriteStream(),
+            assets: () => this.provider?.createAssetsWriteStream(),
+        };
+        if (!(step in mapper)) {
+            throw new Error('Invalid transfer step, impossible to create a stream');
+        }
+        if (!this.streams) {
+            throw new Error('Invalid transfer state');
+        }
+        this.streams[step] = await mapper[step]();
+    },
+    async onMessage(raw) {
+        const msg = JSON.parse(raw.toString());
+        if (!(0, utils_1.isDataTransferMessage)(msg)) {
+            return;
+        }
+        if (!msg.uuid) {
+            await this.respond(undefined, new Error('Missing uuid in message'));
+        }
+        if (proto.hasUUID(msg.uuid)) {
+            const previousResponse = proto.response;
+            if (previousResponse?.uuid === msg.uuid) {
+                await this.respond(previousResponse?.uuid, previousResponse.e, previousResponse.data);
+            }
+            return;
+        }
+        const { uuid, type } = msg;
+        proto.addUUID(uuid);
+        // Regular command message (init, end, status)
+        if (type === 'command') {
+            const { command } = msg;
+            await this.executeAndRespond(uuid, () => {
+                this.assertValidTransferCommand(command);
+                // The status command don't have params
+                if (command === 'status') {
+                    return this.status();
+                }
+                return this[command](msg.params);
+            });
+        }
+        // Transfer message (the transfer must be init first)
+        else if (type === 'transfer') {
+            await this.executeAndRespond(uuid, async () => {
+                await this.verifyAuth();
+                this.assertValidTransfer();
+                return this.onTransferMessage(msg);
+            });
+        }
+        // Invalid messages
+        else {
+            await this.respond(uuid, new Error('Bad Request'));
+        }
+    },
+    async onTransferMessage(msg) {
+        const { kind } = msg;
+        if (kind === 'action') {
+            return this.onTransferAction(msg);
+        }
+        if (kind === 'step') {
+            return this.onTransferStep(msg);
+        }
+    },
+    lockTransferStep(stage) {
+        const currentStep = this.flow?.get();
+        const nextStep = { kind: 'transfer', stage };
+        if (currentStep?.kind === 'transfer' && currentStep.locked) {
+            throw new providers_1.ProviderTransferError(`It's not possible to start a new transfer stage (${stage}) while another one is in progress (${currentStep.stage})`);
+        }
+        if (this.flow?.cannot(nextStep)) {
+            throw new providers_1.ProviderTransferError(`Invalid stage (${stage}) provided for the current flow`, {
+                step: nextStep,
+            });
+        }
+        this.flow?.set({ ...nextStep, locked: true });
+    },
+    unlockTransferStep(stage) {
+        const currentStep = this.flow?.get();
+        const nextStep = { kind: 'transfer', stage };
+        // Cannot unlock if not locked (aka: started)
+        if (currentStep?.kind === 'transfer' && !currentStep.locked) {
+            throw new providers_1.ProviderTransferError(`You need to initialize the transfer stage (${stage}) before ending it`);
+        }
+        // Cannot unlock if invalid step provided
+        if (this.flow?.cannot(nextStep)) {
+            throw new providers_1.ProviderTransferError(`Invalid stage (${stage}) provided for the current flow`, {
+                step: nextStep,
+            });
+        }
+        this.flow?.set({ ...nextStep, locked: false });
+    },
+    async onTransferStep(msg) {
+        const { step: stage } = msg;
+        if (msg.action === 'start') {
+            this.lockTransferStep(stage);
+            if (this.streams?.[stage] instanceof stream_1.Writable) {
+                throw new Error('Stream already created, something went wrong');
+            }
+            await this.createWritableStreamForStep(stage);
+            return { ok: true };
+        }
+        if (msg.action === 'stream') {
+            this.assertValidStreamTransferStep(stage);
+            // Stream operation on the current transfer stage
+            const stream = this.streams?.[stage];
+            if (!stream) {
+                throw new Error('You need to init first');
+            }
+            // Assets are nested streams
+            if (stage === 'assets') {
+                return this.streamAsset(msg.data);
+            }
+            // For all other steps
+            await Promise.all(msg.data.map((item) => writeAsync(stream, item)));
+        }
+        if (msg.action === 'end') {
+            this.unlockTransferStep(stage);
+            const stream = this.streams?.[stage];
+            if (stream && !stream.closed) {
+                await new Promise((resolve, reject) => {
+                    stream.on('close', resolve).on('error', reject).end();
+                });
+            }
+            delete this.streams?.[stage];
+            return { ok: true };
+        }
+    },
+    async onTransferAction(msg) {
+        const { action } = msg;
+        this.assertValidTransferAction(action);
+        const step = { kind: 'action', action };
+        const isStepRegistered = this.flow?.has(step);
+        if (isStepRegistered) {
+            if (this.flow?.cannot(step)) {
+                throw new providers_1.ProviderTransferError(`Invalid action "${action}" found for the current flow `, {
+                    action,
+                });
+            }
+            this.flow?.set(step);
+        }
+        return this.provider?.[action]();
+    },
+    async streamAsset(payload) {
+        const assetsStream = this.streams?.assets;
+        // TODO: close the stream upong receiving an 'end' event instead
+        if (payload === null) {
+            this.streams?.assets?.end();
+            return;
+        }
+        for (const item of payload) {
+            /**
+             * This queues the given callback function to be executed in the next iteration
+             * of the event loop, immediately after the current operation completes.
+             */
+            process.nextTick(async () => {
+                const { action, assetID } = item;
+                if (!assetsStream) {
+                    throw new Error('Stream not defined');
+                }
+                if (action === 'start') {
+                    this.assets[assetID] = { ...item.data, stream: new stream_1.PassThrough() };
+                    writeAsync(assetsStream, this.assets[assetID]);
+                }
+                if (action === 'stream') {
+                    // The buffer has gone through JSON operations and is now of shape { type: "Buffer"; data: UInt8Array }
+                    // We need to transform it back into a Buffer instance
+                    const rawBuffer = item.data;
+                    const chunk = Buffer.from(rawBuffer.data);
+                    await writeAsync(this.assets[assetID].stream, chunk);
+                }
+                if (action === 'end') {
+                    await new Promise((resolve, reject) => {
+                        const { stream: assetStream } = this.assets[assetID];
+                        assetStream
+                            .on('close', () => {
+                            delete this.assets[assetID];
+                            resolve();
+                        })
+                            .on('error', reject)
+                            .end();
+                    });
+                }
+            });
+        }
+    },
+    onClose() {
+        this.teardown();
+    },
+    onError(err) {
+        this.teardown();
+        strapi.log.error(err);
+    },
+    // Commands
+    async init(params) {
+        if (this.transferID || this.provider) {
+            throw new Error('Transfer already in progress');
+        }
+        await this.verifyAuth();
+        this.transferID = (0, crypto_1.randomUUID)();
+        this.startedAt = Date.now();
+        this.assets = {};
+        this.streams = {};
+        this.flow = (0, flows_1.createFlow)(flows_1.DEFAULT_TRANSFER_FLOW);
+        this.provider = (0, providers_2.createLocalStrapiDestinationProvider)({
+            ...params.options,
+            autoDestroy: false,
+            getStrapi: () => strapi,
+        });
+        return { transferID: this.transferID };
+    },
+    async status() {
+        const isStarted = this.isTransferStarted();
+        if (isStarted) {
+            const startedAt = this.startedAt;
+            return {
+                active: true,
+                kind: TRANSFER_KIND,
+                startedAt,
+                elapsed: Date.now() - startedAt,
+            };
+        }
+        return { active: false, kind: null, elapsed: null, startedAt: null };
+    },
+    async end(params) {
+        await this.verifyAuth();
+        if (this.transferID !== params.transferID) {
+            throw new providers_1.ProviderTransferError('Bad transfer ID provided');
+        }
+        this.cleanup();
+        return { ok: true };
+    },
+}));
+//# sourceMappingURL=push.js.map

package/dist/strapi/remote/handlers/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../../src/strapi/remote/handlers/push.ts"],"names":[],"mappings":"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"}

package/dist/strapi/remote/handlers/utils.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="node" />
+import type { IncomingMessage } from 'http';
+import type { Context } from 'koa';
+import type { ServerOptions } from 'ws';
+import { WebSocket, WebSocketServer } from 'ws';
+import type { Handler } from './abstract';
+import type { Protocol } from '../../../../types';
+import { TransferMethod } from '../constants';
+type WSCallback = (client: WebSocket, request: IncomingMessage) => void;
+export interface HandlerOptions {
+    verify: (ctx: Context, scope?: TransferMethod) => Promise<void>;
+    server?: ServerOptions;
+}
+export declare const transformUpgradeHeader: (header?: string) => string[];
+/**
+ * Make sure that the upgrade header is a valid websocket one
+ */
+export declare const assertValidHeader: (ctx: Context) => void;
+export declare const isDataTransferMessage: (message: unknown) => message is Protocol.Client.Message;
+/**
+ * Handle the upgrade to ws connection
+ */
+export declare const handleWSUpgrade: (wss: WebSocketServer, ctx: Context, callback: WSCallback) => void;
+export declare const handlerControllerFactory: <T extends Partial<Handler>>(implementation: (proto: Handler) => T) => (options: HandlerOptions) => (ctx: Context) => Promise<void>;
+export {};

package/dist/strapi/remote/handlers/utils.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlerControllerFactory = exports.handleWSUpgrade = exports.isDataTransferMessage = exports.assertValidHeader = exports.transformUpgradeHeader = void 0;
+const crypto_1 = require("crypto");
+const ws_1 = require("ws");
+const providers_1 = require("../../../errors/providers");
+const constants_1 = require("./constants");
+const transformUpgradeHeader = (header = '') => {
+    return header.split(',').map((s) => s.trim().toLowerCase());
+};
+exports.transformUpgradeHeader = transformUpgradeHeader;
+/**
+ * Make sure that the upgrade header is a valid websocket one
+ */
+const assertValidHeader = (ctx) => {
+    // if it's exactly what we expect, it's fine
+    if (ctx.headers.upgrade === 'websocket') {
+        return;
+    }
+    // check if it could be an array that still includes websocket
+    const upgradeHeader = (0, exports.transformUpgradeHeader)(ctx.headers.upgrade);
+    // Sanitize user input before writing it to our logs
+    const logSafeUpgradeHeader = JSON.stringify(ctx.headers.upgrade)
+        ?.replace(/[^a-z0-9\s.,|]/gi, '')
+        .substring(0, 50);
+    if (!upgradeHeader.includes('websocket')) {
+        throw new Error(`Transfer Upgrade header expected 'websocket', found '${logSafeUpgradeHeader}'. Please ensure that your server or proxy is not modifying the Upgrade header.`);
+    }
+    /**
+     * If there's more than expected but it still includes websocket, in theory it could still work
+     * and could be necessary for their certain configurations, so we'll allow it to proceed but
+     * log the unexpected behaviour in case it helps debug an issue
+     * */
+    strapi.log.info(`Transfer Upgrade header expected only 'websocket', found unexpected values: ${logSafeUpgradeHeader}`);
+};
+exports.assertValidHeader = assertValidHeader;
+const isDataTransferMessage = (message) => {
+    if (!message || typeof message !== 'object') {
+        return false;
+    }
+    const { uuid, type } = message;
+    if (typeof uuid !== 'string' || typeof type !== 'string') {
+        return false;
+    }
+    if (!['command', 'transfer'].includes(type)) {
+        return false;
+    }
+    return true;
+};
+exports.isDataTransferMessage = isDataTransferMessage;
+/**
+ * Handle the upgrade to ws connection
+ */
+const handleWSUpgrade = (wss, ctx, callback) => {
+    (0, exports.assertValidHeader)(ctx);
+    wss.handleUpgrade(ctx.req, ctx.request.socket, Buffer.alloc(0), (client, request) => {
+        // Create a connection between the client & the server
+        wss.emit('connection', client, ctx.req);
+        // Invoke the ws callback
+        callback(client, request);
+    });
+    ctx.respond = false;
+};
+exports.handleWSUpgrade = handleWSUpgrade;
+// Protocol related functions
+const handlerControllerFactory = (implementation) => (options) => {
+    const { verify, server: serverOptions } = options ?? {};
+    const wss = new ws_1.WebSocket.Server({ ...serverOptions, noServer: true });
+    return async (ctx) => {
+        (0, exports.handleWSUpgrade)(wss, ctx, (ws) => {
+            const state = { id: undefined };
+            const messageUUIDs = new Set();
+            const prototype = {
+                // Transfer ID
+                get transferID() {
+                    return state.id;
+                },
+                set transferID(id) {
+                    state.id = id;
+                },
+                // Started at
+                get startedAt() {
+                    return state.startedAt;
+                },
+                set startedAt(timestamp) {
+                    state.startedAt = timestamp;
+                },
+                get response() {
+                    return state.response;
+                },
+                set response(response) {
+                    state.response = response;
+                },
+                addUUID(uuid) {
+                    messageUUIDs.add(uuid);
+                },
+                hasUUID(uuid) {
+                    return messageUUIDs.has(uuid);
+                },
+                isTransferStarted() {
+                    return this.transferID !== undefined && this.startedAt !== undefined;
+                },
+                assertValidTransfer() {
+                    const isStarted = this.isTransferStarted();
+                    if (!isStarted) {
+                        throw new Error('Invalid Transfer Process');
+                    }
+                },
+                assertValidTransferCommand(command) {
+                    const isDefined = typeof this[command] === 'function';
+                    const isValidTransferCommand = constants_1.VALID_TRANSFER_COMMANDS.includes(command);
+                    if (!isDefined || !isValidTransferCommand) {
+                        throw new Error('Invalid transfer command');
+                    }
+                },
+                respond(uuid, e, data) {
+                    let details = {};
+                    return new Promise((resolve, reject) => {
+                        if (!uuid && !e) {
+                            reject(new Error('Missing uuid for this message'));
+                            return;
+                        }
+                        this.response = {
+                            uuid,
+                            data,
+                            e,
+                        };
+                        if (e instanceof providers_1.ProviderError) {
+                            details = e.details;
+                        }
+                        const payload = JSON.stringify({
+                            uuid,
+                            data: data ?? null,
+                            error: e
+                                ? {
+                                    code: e?.name ?? 'ERR',
+                                    message: e?.message,
+                                    details,
+                                }
+                                : null,
+                        });
+                        this.send(payload, (error) => (error ? reject(error) : resolve()));
+                    });
+                },
+                send(message, cb) {
+                    ws.send(message, cb);
+                },
+                confirm(message) {
+                    return new Promise((resolve, reject) => {
+                        const uuid = (0, crypto_1.randomUUID)();
+                        const payload = JSON.stringify({ uuid, data: message });
+                        this.send(payload, (error) => {
+                            if (error) {
+                                reject(error);
+                            }
+                        });
+                        const onResponse = (raw) => {
+                            const response = JSON.parse(raw.toString());
+                            if (response.uuid === uuid) {
+                                resolve(response.data ?? null);
+                            }
+                            else {
+                                ws.once('message', onResponse);
+                            }
+                        };
+                        ws.once('message', onResponse);
+                    });
+                },
+                async executeAndRespond(uuid, fn) {
+                    try {
+                        const response = await fn();
+                        this.respond(uuid, null, response);
+                    }
+                    catch (e) {
+                        if (e instanceof Error) {
+                            this.respond(uuid, e);
+                        }
+                        else if (typeof e === 'string') {
+                            this.respond(uuid, new providers_1.ProviderTransferError(e));
+                        }
+                        else {
+                            this.respond(uuid, new providers_1.ProviderTransferError('Unexpected error', {
+                                error: e,
+                            }));
+                        }
+                    }
+                },
+                cleanup() {
+                    this.transferID = undefined;
+                    this.startedAt = undefined;
+                    this.response = undefined;
+                },
+                teardown() {
+                    this.cleanup();
+                },
+                verifyAuth(scope) {
+                    return verify(ctx, scope);
+                },
+                // Transfer commands
+                init() { },
+                end() { },
+                status() { },
+                // Default prototype implementation for events
+                onMessage() { },
+                onError() { },
+                onClose() { },
+            };
+            const handler = Object.assign(Object.create(prototype), implementation(prototype));
+            // Bind ws events to handler methods
+            ws.on('close', (...args) => handler.onClose(...args));
+            ws.on('error', (...args) => handler.onError(...args));
+            ws.on('message', (...args) => handler.onMessage(...args));
+        });
+    };
+};
+exports.handlerControllerFactory = handlerControllerFactory;
+//# sourceMappingURL=utils.js.map

package/dist/strapi/remote/handlers/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/strapi/remote/handlers/utils.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+export * as constants from './constants';
+export * as handlers from './handlers';

package/dist/strapi/remote/index.js

@@ -0,0 +1,29 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlers = exports.constants = void 0;
+exports.constants = __importStar(require("./constants"));
+exports.handlers = __importStar(require("./handlers"));
+//# sourceMappingURL=index.js.map

package/dist/strapi/remote/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/strapi/remote/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yDAAyC;AACzC,uDAAuC"}

package/dist/utils/encryption/decrypt.d.ts

@@ -0,0 +1,11 @@
+import { Cipher } from 'crypto';
+import { Algorithm } from '../../../types';
+/**
+ * It creates a cipher instance used for decryption
+ *
+ * @param key - The decryption key
+ * @param algorithm - The algorithm to use to create the Cipher
+ *
+ * @returns A {@link Cipher} instance created with the given key & algorithm
+ */
+export declare const createDecryptionCipher: (key: string, algorithm?: Algorithm) => Cipher;