quidproquo-actionprocessor-node 0.0.256 → 0.0.258

package/lib/commonjs/dynamicActionProcessor/file/getFileWriteBinaryContentsActionProcessor.js

@@ -0,0 +1,70 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFileWriteBinaryContentsActionProcessor = void 0;
+const quidproquo_core_1 = require("quidproquo-core");
+const fs = __importStar(require("fs/promises"));
+const utils_1 = require("./utils");
+const getProcessFileWriteBinaryContents = (config) => (qpqConfig) => {
+    const serviceName = quidproquo_core_1.qpqCoreUtils.getApplicationModuleName(qpqConfig);
+    return (_a) => __awaiter(void 0, [_a], void 0, function* ({ drive, filepath, data }) {
+        try {
+            const fullPath = (0, utils_1.resolveFilePath)(config, serviceName, drive, filepath);
+            yield (0, utils_1.ensureParentDirectoryExists)(fullPath);
+            // Convert QPQBinaryData to Buffer
+            const buffer = Buffer.from(data.base64Data, 'base64');
+            yield fs.writeFile(fullPath, buffer);
+            return (0, quidproquo_core_1.actionResult)(void 0);
+        }
+        catch (error) {
+            return (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.ErrorTypeEnum.GenericError, `Error writing binary file: ${error.message}`);
+        }
+    });
+};
+const getFileWriteBinaryContentsActionProcessor = (config) => (qpqConfig) => __awaiter(void 0, void 0, void 0, function* () {
+    return ({
+        [quidproquo_core_1.FileActionType.WriteBinaryContents]: getProcessFileWriteBinaryContents(config)(qpqConfig),
+    });
+});
+exports.getFileWriteBinaryContentsActionProcessor = getFileWriteBinaryContentsActionProcessor;

package/lib/commonjs/dynamicActionProcessor/file/getFileWriteObjectJsonActionProcessor.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+import { FileStorageConfig } from './types';
+export declare const getFileWriteObjectJsonActionProcessor: (config: FileStorageConfig) => ActionProcessorListResolver;

package/lib/commonjs/dynamicActionProcessor/file/getFileWriteObjectJsonActionProcessor.js

@@ -0,0 +1,69 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFileWriteObjectJsonActionProcessor = void 0;
+const quidproquo_core_1 = require("quidproquo-core");
+const fs = __importStar(require("fs/promises"));
+const utils_1 = require("./utils");
+const getProcessFileWriteObjectJson = (config) => (qpqConfig) => {
+    const serviceName = quidproquo_core_1.qpqCoreUtils.getApplicationModuleName(qpqConfig);
+    return (_a) => __awaiter(void 0, [_a], void 0, function* ({ drive, filepath, data }) {
+        try {
+            const fullPath = (0, utils_1.resolveFilePath)(config, serviceName, drive, filepath);
+            yield (0, utils_1.ensureParentDirectoryExists)(fullPath);
+            const jsonString = JSON.stringify(data, null, 2);
+            yield fs.writeFile(fullPath, jsonString, 'utf8');
+            return (0, quidproquo_core_1.actionResult)(void 0);
+        }
+        catch (error) {
+            return (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.ErrorTypeEnum.GenericError, `Error writing JSON file: ${error.message}`);
+        }
+    });
+};
+const getFileWriteObjectJsonActionProcessor = (config) => (qpqConfig) => __awaiter(void 0, void 0, void 0, function* () {
+    return ({
+        [quidproquo_core_1.FileActionType.WriteObjectJson]: getProcessFileWriteObjectJson(config)(qpqConfig),
+    });
+});
+exports.getFileWriteObjectJsonActionProcessor = getFileWriteObjectJsonActionProcessor;

package/lib/commonjs/dynamicActionProcessor/file/getFileWriteTextContentsActionProcessor.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+import { FileStorageConfig } from './types';
+export declare const getFileWriteTextContentsActionProcessor: (config: FileStorageConfig) => ActionProcessorListResolver;

package/lib/commonjs/dynamicActionProcessor/file/getFileWriteTextContentsActionProcessor.js

@@ -0,0 +1,68 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFileWriteTextContentsActionProcessor = void 0;
+const quidproquo_core_1 = require("quidproquo-core");
+const fs = __importStar(require("fs/promises"));
+const utils_1 = require("./utils");
+const getProcessFileWriteTextContents = (qpqConfig, config) => {
+    const serviceName = quidproquo_core_1.qpqCoreUtils.getApplicationModuleName(qpqConfig);
+    return (_a) => __awaiter(void 0, [_a], void 0, function* ({ drive, filepath, data }) {
+        try {
+            const fullPath = (0, utils_1.resolveFilePath)(config, serviceName, drive, filepath);
+            yield (0, utils_1.ensureParentDirectoryExists)(fullPath);
+            yield fs.writeFile(fullPath, data, 'utf8');
+            return (0, quidproquo_core_1.actionResult)(void 0);
+        }
+        catch (error) {
+            return (0, quidproquo_core_1.actionResultError)(quidproquo_core_1.ErrorTypeEnum.GenericError, `Error writing file: ${error.message}`);
+        }
+    });
+};
+const getFileWriteTextContentsActionProcessor = (config) => (qpqConfig) => __awaiter(void 0, void 0, void 0, function* () {
+    return ({
+        [quidproquo_core_1.FileActionType.WriteTextContents]: getProcessFileWriteTextContents(qpqConfig, config),
+    });
+});
+exports.getFileWriteTextContentsActionProcessor = getFileWriteTextContentsActionProcessor;

package/lib/commonjs/dynamicActionProcessor/file/index.d.ts

@@ -0,0 +1,6 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+import { FileStorageConfig } from './types';
+export * from './types';
+export declare const getFileActionProcessor: (fileStorageConfig: FileStorageConfig) => ActionProcessorListResolver;
+export * from "./secureUrlUtils";
+export * from "./utils";

package/lib/commonjs/dynamicActionProcessor/file/index.js

@@ -0,0 +1,48 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFileActionProcessor = void 0;
+const getFileDeleteActionProcessor_1 = require("./getFileDeleteActionProcessor");
+const getFileExistsActionProcessor_1 = require("./getFileExistsActionProcessor");
+const getFileGenerateTemporarySecureUrlActionProcessor_1 = require("./getFileGenerateTemporarySecureUrlActionProcessor");
+const getFileGenerateTemporaryUploadSecureUrlActionProcessor_1 = require("./getFileGenerateTemporaryUploadSecureUrlActionProcessor");
+const getFileIsColdStorageActionProcessor_1 = require("./getFileIsColdStorageActionProcessor");
+const getFileListDirectoryActionProcessor_1 = require("./getFileListDirectoryActionProcessor");
+const getFileReadBinaryContentsActionProcessor_1 = require("./getFileReadBinaryContentsActionProcessor");
+const getFileReadObjectJsonActionProcessor_1 = require("./getFileReadObjectJsonActionProcessor");
+const getFileReadTextContentsActionProcessor_1 = require("./getFileReadTextContentsActionProcessor");
+const getFileWriteBinaryContentsActionProcessor_1 = require("./getFileWriteBinaryContentsActionProcessor");
+const getFileWriteObjectJsonActionProcessor_1 = require("./getFileWriteObjectJsonActionProcessor");
+const getFileWriteTextContentsActionProcessor_1 = require("./getFileWriteTextContentsActionProcessor");
+__exportStar(require("./types"), exports);
+// Main export that accepts configuration
+const getFileActionProcessor = (fileStorageConfig) => {
+    return (qpqConfig, dynamicModuleLoader) => __awaiter(void 0, void 0, void 0, function* () {
+        return (Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, (yield (0, getFileReadTextContentsActionProcessor_1.getFileReadTextContentsActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileWriteTextContentsActionProcessor_1.getFileWriteTextContentsActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileReadObjectJsonActionProcessor_1.getFileReadObjectJsonActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileWriteObjectJsonActionProcessor_1.getFileWriteObjectJsonActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileReadBinaryContentsActionProcessor_1.getFileReadBinaryContentsActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileWriteBinaryContentsActionProcessor_1.getFileWriteBinaryContentsActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileListDirectoryActionProcessor_1.getFileListDirectoryActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileExistsActionProcessor_1.getFileExistsActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileDeleteActionProcessor_1.getFileDeleteActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileGenerateTemporarySecureUrlActionProcessor_1.getFileGenerateTemporarySecureUrlActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileGenerateTemporaryUploadSecureUrlActionProcessor_1.getFileGenerateTemporaryUploadSecureUrlActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))), (yield (0, getFileIsColdStorageActionProcessor_1.getFileIsColdStorageActionProcessor)(fileStorageConfig)(qpqConfig, dynamicModuleLoader))));
+    });
+};
+exports.getFileActionProcessor = getFileActionProcessor;
+__exportStar(require("./secureUrlUtils"), exports);
+__exportStar(require("./utils"), exports);

package/lib/commonjs/dynamicActionProcessor/file/secureUrlUtils.d.ts

@@ -0,0 +1,10 @@
+import { FileStorageConfig } from './types';
+export interface SecureUrlToken {
+    fullFilepath: string;
+    operation: 'download' | 'upload';
+    expiresAt: number;
+    contentType?: string;
+}
+export declare const createSecureUrlToken: (token: SecureUrlToken, secret: string) => string;
+export declare const verifySecureUrlToken: (tokenString: string, secret: string) => SecureUrlToken | null;
+export declare const getSecureUrlBaseUrl: (config: FileStorageConfig) => string;

package/lib/commonjs/dynamicActionProcessor/file/secureUrlUtils.js

@@ -0,0 +1,84 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSecureUrlBaseUrl = exports.verifySecureUrlToken = exports.createSecureUrlToken = void 0;
+const crypto = __importStar(require("crypto"));
+// Create a signed token for secure URLs
+const createSecureUrlToken = (token, secret) => {
+    const payload = JSON.stringify(token);
+    const payloadBase64 = Buffer.from(payload).toString('base64url');
+    // Create HMAC signature
+    const signature = crypto
+        .createHmac('sha256', secret)
+        .update(payloadBase64)
+        .digest('base64url');
+    // Return token as payload.signature
+    return `${payloadBase64}.${signature}`;
+};
+exports.createSecureUrlToken = createSecureUrlToken;
+// Verify and decode a signed token
+const verifySecureUrlToken = (tokenString, secret) => {
+    try {
+        const [payloadBase64, signature] = tokenString.split('.');
+        if (!payloadBase64 || !signature) {
+            return null;
+        }
+        // Verify signature
+        const expectedSignature = crypto
+            .createHmac('sha256', secret)
+            .update(payloadBase64)
+            .digest('base64url');
+        if (signature !== expectedSignature) {
+            return null;
+        }
+        // Decode payload
+        const payload = Buffer.from(payloadBase64, 'base64url').toString();
+        const token = JSON.parse(payload);
+        // Check expiration
+        if (token.expiresAt < Date.now()) {
+            return null;
+        }
+        return token;
+    }
+    catch (error) {
+        return null;
+    }
+};
+exports.verifySecureUrlToken = verifySecureUrlToken;
+// Get the secure URL base URL
+const getSecureUrlBaseUrl = (config) => {
+    return `http://${config.secureUrlHost}:${config.secureUrlPort}`;
+};
+exports.getSecureUrlBaseUrl = getSecureUrlBaseUrl;

package/lib/commonjs/dynamicActionProcessor/file/types.d.ts

@@ -0,0 +1,6 @@
+export interface FileStorageConfig {
+    storagePath: string;
+    secureUrlPort: number;
+    secureUrlHost: string;
+    secureUrlSecret: string;
+}

package/lib/commonjs/dynamicActionProcessor/file/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/commonjs/dynamicActionProcessor/file/utils.d.ts

@@ -0,0 +1,6 @@
+import { QPQConfig } from 'quidproquo-core';
+import { FileStorageConfig } from './types';
+export declare const isStorageDriveNameValid: (drive: string, qpqConfig: QPQConfig) => boolean;
+export declare function resolveFilePath(fileStorageConfig: FileStorageConfig, service: string, drive: string, filepath: string): string;
+export declare const ensureDirectoryExists: (dirPath: string) => Promise<void>;
+export declare const ensureParentDirectoryExists: (filePath: string) => Promise<void>;

package/lib/commonjs/dynamicActionProcessor/file/utils.js

@@ -0,0 +1,90 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureParentDirectoryExists = exports.ensureDirectoryExists = exports.isStorageDriveNameValid = void 0;
+exports.resolveFilePath = resolveFilePath;
+const quidproquo_core_1 = require("quidproquo-core");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+// Resolve a drive name to a filesystem path
+const isStorageDriveNameValid = (drive, qpqConfig) => {
+    const storageDrive = quidproquo_core_1.qpqCoreUtils.getStorageDrives(qpqConfig).find((d) => d.storageDrive === drive);
+    if (!storageDrive) {
+        return false;
+    }
+    return true;
+};
+exports.isStorageDriveNameValid = isStorageDriveNameValid;
+function resolveFilePath(fileStorageConfig, service, drive, filepath) {
+    const root = path.resolve(fileStorageConfig.storagePath, service, drive);
+    // Block absolute paths and null bytes outright
+    if (path.isAbsolute(filepath)) {
+        throw new Error('Absolute paths are not allowed.');
+    }
+    // Check for null to prevent directory traversal attacks in native libs
+    if (filepath.includes('\0')) {
+        throw new Error('Invalid path.');
+    }
+    // Normalize user input (collapses ., .., slashes)
+    const cleaned = path.normalize(filepath);
+    // Resolve against the root
+    const target = path.resolve(root, cleaned);
+    // Ensure target stays within root
+    const rel = path.relative(root, target);
+    if (rel === '' || (!rel.startsWith('..') && !path.isAbsolute(rel))) {
+        return target;
+    }
+    throw new Error('Invalid file path: escapes drive root.');
+}
+// Ensure a directory exists
+const ensureDirectoryExists = (dirPath) => __awaiter(void 0, void 0, void 0, function* () {
+    yield fs.mkdir(dirPath, { recursive: true });
+});
+exports.ensureDirectoryExists = ensureDirectoryExists;
+// Ensure the parent directory of a file exists
+const ensureParentDirectoryExists = (filePath) => __awaiter(void 0, void 0, void 0, function* () {
+    const parentDir = path.dirname(filePath);
+    yield (0, exports.ensureDirectoryExists)(parentDir);
+});
+exports.ensureParentDirectoryExists = ensureParentDirectoryExists;

package/lib/commonjs/dynamicActionProcessor/index.d.ts

@@ -0,0 +1 @@
+export * from './file';

package/lib/commonjs/dynamicActionProcessor/index.js

@@ -0,0 +1,17 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./file"), exports);

package/lib/commonjs/index.d.ts

@@ -1 +1,2 @@
 export * from './actionProcessor';
+export * from './dynamicActionProcessor';

package/lib/commonjs/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./actionProcessor"), exports);
+__exportStar(require("./dynamicActionProcessor"), exports);

package/lib/esm/dynamicActionProcessor/file/getFileDeleteActionProcessor.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+import { FileStorageConfig } from './types';
+export declare const getFileDeleteActionProcessor: (config: FileStorageConfig) => ActionProcessorListResolver;

package/lib/esm/dynamicActionProcessor/file/getFileDeleteActionProcessor.js

@@ -0,0 +1,33 @@
+import { actionResult, actionResultError, ErrorTypeEnum, FileActionType, qpqCoreUtils, } from 'quidproquo-core';
+import * as fs from 'fs/promises';
+import { resolveFilePath } from './utils';
+const getProcessFileDelete = (qpqConfig, config) => {
+    const serviceName = qpqCoreUtils.getApplicationModuleName(qpqConfig);
+    return async ({ drive, filepaths }) => {
+        const deletedFiles = [];
+        const errors = [];
+        for (const filepath of filepaths) {
+            try {
+                const fullPath = resolveFilePath(config, serviceName, drive, filepath);
+                await fs.unlink(fullPath);
+                deletedFiles.push(filepath);
+            }
+            catch (error) {
+                // If file doesn't exist, consider it successfully deleted
+                if (error.code === 'ENOENT') {
+                    deletedFiles.push(filepath);
+                }
+                else {
+                    errors.push(`Failed to delete ${filepath}: ${error.message}`);
+                }
+            }
+        }
+        if (errors.length > 0 && deletedFiles.length === 0) {
+            return actionResultError(ErrorTypeEnum.GenericError, `Failed to delete files: ${errors.join(', ')}`);
+        }
+        return actionResult(deletedFiles);
+    };
+};
+export const getFileDeleteActionProcessor = (config) => async (qpqConfig) => ({
+    [FileActionType.Delete]: getProcessFileDelete(qpqConfig, config),
+});

package/lib/esm/dynamicActionProcessor/file/getFileExistsActionProcessor.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+import { FileStorageConfig } from './types';
+export declare const getFileExistsActionProcessor: (config: FileStorageConfig) => ActionProcessorListResolver;

package/lib/esm/dynamicActionProcessor/file/getFileExistsActionProcessor.js

@@ -0,0 +1,24 @@
+import { actionResult, actionResultError, ErrorTypeEnum, FileActionType, qpqCoreUtils, } from 'quidproquo-core';
+import * as fs from 'fs/promises';
+import { resolveFilePath } from './utils';
+const getProcessFileExists = (qpqConfig, config) => {
+    const serviceName = qpqCoreUtils.getApplicationModuleName(qpqConfig);
+    return async ({ drive, filepath }) => {
+        try {
+            const fullPath = resolveFilePath(config, serviceName, drive, filepath);
+            try {
+                await fs.access(fullPath);
+                return actionResult(true);
+            }
+            catch {
+                return actionResult(false);
+            }
+        }
+        catch (error) {
+            return actionResultError(ErrorTypeEnum.GenericError, `Error checking file existence: ${error.message}`);
+        }
+    };
+};
+export const getFileExistsActionProcessor = (config) => async (qpqConfig) => ({
+    [FileActionType.Exists]: getProcessFileExists(qpqConfig, config),
+});

package/lib/esm/dynamicActionProcessor/file/getFileGenerateTemporarySecureUrlActionProcessor.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+import { FileStorageConfig } from './types';
+export declare const getFileGenerateTemporarySecureUrlActionProcessor: (config: FileStorageConfig) => ActionProcessorListResolver;

package/lib/esm/dynamicActionProcessor/file/getFileGenerateTemporarySecureUrlActionProcessor.js

@@ -0,0 +1,26 @@
+import { actionResult, actionResultError, ErrorTypeEnum, FileActionType, qpqCoreUtils, } from 'quidproquo-core';
+import { createSecureUrlToken, getSecureUrlBaseUrl } from './secureUrlUtils';
+import { resolveFilePath } from './utils';
+const getProcessFileGenerateTemporarySecureUrl = (qpqConfig, config) => {
+    const serviceName = qpqCoreUtils.getApplicationModuleName(qpqConfig);
+    return async ({ drive, filepath, expirationMs }) => {
+        try {
+            // Create a token for download
+            const token = createSecureUrlToken({
+                fullFilepath: resolveFilePath(config, serviceName, drive, filepath),
+                operation: 'download',
+                expiresAt: Date.now() + expirationMs,
+            }, config.secureUrlSecret);
+            // Build the secure URL
+            const baseUrl = getSecureUrlBaseUrl(config);
+            const url = `${baseUrl}/secure-download?token=${token}`;
+            return actionResult(url);
+        }
+        catch (error) {
+            return actionResultError(ErrorTypeEnum.GenericError, `Unable to generate temporary secure URL: ${error.message}`);
+        }
+    };
+};
+export const getFileGenerateTemporarySecureUrlActionProcessor = (config) => async (qpqConfig) => ({
+    [FileActionType.GenerateTemporarySecureUrl]: getProcessFileGenerateTemporarySecureUrl(qpqConfig, config),
+});

package/lib/esm/dynamicActionProcessor/file/getFileGenerateTemporaryUploadSecureUrlActionProcessor.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorListResolver } from 'quidproquo-core';
+import { FileStorageConfig } from './types';
+export declare const getFileGenerateTemporaryUploadSecureUrlActionProcessor: (config: FileStorageConfig) => ActionProcessorListResolver;