@superdangerous/app-framework 4.9.0

package/dist/core/storageService.js

@@ -0,0 +1,405 @@
+/**
+ * Storage Service
+ * Unified service for secure file operations, user uploads, and internal data storage
+ * Provides path sanitization, validation, and consistent file handling
+ */
+import path from "path";
+import * as fsUtils from "../utils/fs-utils.js";
+import { createWriteStream } from "fs";
+import { createLogger } from "./index.js";
+import crypto from "crypto";
+let logger; // Will be initialized when needed
+function ensureLogger() {
+    if (!logger) {
+        logger = createLogger("StorageService");
+    }
+    return logger;
+}
+// Define safe base directories
+const DATA_DIR = path.join(process.cwd(), "data");
+const BASE_DIRS = {
+    attachments: path.join(DATA_DIR, "uploads", "attachments"),
+    data: DATA_DIR,
+    templates: path.join(DATA_DIR, "templates"),
+    uploads: path.join(DATA_DIR, "uploads"),
+    logs: path.join(DATA_DIR, "logs"),
+    config: path.join(DATA_DIR, "config"),
+};
+export class StorageService {
+    initialized = false;
+    maxFileSize = 100 * 1024 * 1024; // 100MB
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            // Ensure all base directories exist
+            for (const dir of Object.values(BASE_DIRS)) {
+                await fsUtils.ensureDir(dir);
+            }
+            // Ensure .gitignore exists in attachments and data directories
+            const gitignoreContent = "*\n!.gitignore\n";
+            await fsUtils.writeFile(path.join(BASE_DIRS.attachments, ".gitignore"), gitignoreContent);
+            await fsUtils.writeFile(path.join(BASE_DIRS.data, ".gitignore"), gitignoreContent);
+            this.initialized = true;
+            // Storage service initialized
+        }
+        catch (_error) {
+            ensureLogger().error("Failed to initialize storage service:", _error);
+            throw _error;
+        }
+    }
+    /**
+     * Sanitize a filename to prevent path traversal attacks
+     */
+    sanitizeFilename(filename) {
+        if (!filename || typeof filename !== "string") {
+            throw new Error("Invalid filename provided");
+        }
+        // Remove any path components and keep only the basename
+        let sanitized = path.basename(filename);
+        // Remove any remaining special characters that could cause issues
+        sanitized = sanitized.replace(/[^a-zA-Z0-9._-]/g, "_");
+        // Ensure the filename is not empty after sanitization
+        if (!sanitized || sanitized === "." || sanitized === "..") {
+            sanitized = `file_${Date.now()}`;
+        }
+        // Limit filename length
+        if (sanitized.length > 255) {
+            const ext = path.extname(sanitized);
+            const name = path.basename(sanitized, ext);
+            sanitized = name.substring(0, 255 - ext.length) + ext;
+        }
+        return sanitized;
+    }
+    /**
+     * Validate that a path is within the allowed base directory
+     */
+    isPathSafe(filePath, baseDir) {
+        try {
+            const resolvedPath = path.resolve(filePath);
+            const resolvedBase = path.resolve(baseDir);
+            return resolvedPath.startsWith(resolvedBase);
+        }
+        catch (_error) {
+            ensureLogger().error("Error validating path safety:", _error);
+            return false;
+        }
+    }
+    /**
+     * Get the full safe path for a file
+     */
+    getSafePath(filename, category = "data") {
+        const sanitizedName = this.sanitizeFilename(filename);
+        const baseDir = BASE_DIRS[category];
+        const fullPath = path.join(baseDir, sanitizedName);
+        if (!this.isPathSafe(fullPath, baseDir)) {
+            throw new Error("Invalid file path detected");
+        }
+        return fullPath;
+    }
+    /**
+     * Save a file securely
+     */
+    async saveFile(content, filename, category = "data", options = {}) {
+        await this.initialize();
+        const safePath = this.getSafePath(filename, category);
+        // Check if file exists and handle accordingly
+        if (await fsUtils.pathExists(safePath)) {
+            if (!options.overwrite) {
+                throw new Error(`File already exists: ${filename}`);
+            }
+            if (options.createBackup) {
+                const backupPath = `${safePath}.backup.${Date.now()}`;
+                await fsUtils.copy(safePath, backupPath);
+                ensureLogger().info(`Created backup: ${backupPath}`);
+            }
+        }
+        // Validate content size
+        const size = Buffer.isBuffer(content)
+            ? content.length
+            : Buffer.byteLength(content);
+        if (size > this.maxFileSize) {
+            throw new Error(`File size exceeds maximum allowed size of ${this.maxFileSize} bytes`);
+        }
+        // Save the file
+        await fsUtils.writeFile(safePath, content);
+        // Calculate hash
+        const hash = crypto
+            .createHash("sha256")
+            .update(Buffer.isBuffer(content) ? content : Buffer.from(content))
+            .digest("hex");
+        const stats = await fsUtils.stat(safePath);
+        ensureLogger().debug(`File saved: ${safePath} (${size} bytes)`);
+        return {
+            name: filename,
+            size,
+            path: safePath,
+            hash,
+            created: stats.birthtime,
+            modified: stats.mtime,
+        };
+    }
+    /**
+     * Read a file securely
+     */
+    async readFile(filename, category = "data", options = {}) {
+        await this.initialize();
+        const safePath = this.getSafePath(filename, category);
+        // Check if file exists
+        if (!(await fsUtils.pathExists(safePath))) {
+            throw new Error(`File not found: ${filename}`);
+        }
+        // Check file size
+        const stats = await fsUtils.stat(safePath);
+        const maxSize = options.maxSize || this.maxFileSize;
+        if (stats.size > maxSize) {
+            throw new Error(`File size (${stats.size}) exceeds maximum allowed size (${maxSize})`);
+        }
+        // Read the file
+        const content = options.encoding
+            ? await fsUtils.readFile(safePath, options.encoding)
+            : await fsUtils.readFile(safePath);
+        ensureLogger().debug(`File read: ${safePath} (${stats.size} bytes)`);
+        return content;
+    }
+    /**
+     * Delete a file securely
+     */
+    async deleteFile(filename, category = "data") {
+        await this.initialize();
+        const safePath = this.getSafePath(filename, category);
+        if (!(await fsUtils.pathExists(safePath))) {
+            ensureLogger().warn(`File not found for deletion: ${filename}`);
+            return false;
+        }
+        await fsUtils.unlink(safePath);
+        ensureLogger().debug(`File deleted: ${safePath}`);
+        return true;
+    }
+    /**
+     * List files in a category
+     */
+    async listFiles(category = "data", pattern) {
+        await this.initialize();
+        const baseDir = BASE_DIRS[category];
+        const files = [];
+        try {
+            const entries = await fsUtils.readdir(baseDir);
+            for (const entry of entries) {
+                if (pattern && !pattern.test(entry))
+                    continue;
+                const fullPath = path.join(baseDir, entry);
+                const stats = await fsUtils.stat(fullPath);
+                if (stats.isFile()) {
+                    files.push({
+                        name: entry,
+                        size: stats.size,
+                        path: fullPath,
+                        created: stats.birthtime,
+                        modified: stats.mtime,
+                    });
+                }
+            }
+        }
+        catch (_error) {
+            ensureLogger().error(`Error listing files in ${category}:`, _error);
+        }
+        return files;
+    }
+    /**
+     * Get file info
+     */
+    async getFileInfo(filename, category = "data") {
+        await this.initialize();
+        const safePath = this.getSafePath(filename, category);
+        if (!(await fsUtils.pathExists(safePath))) {
+            return null;
+        }
+        const stats = await fsUtils.stat(safePath);
+        return {
+            name: filename,
+            size: stats.size,
+            path: safePath,
+            created: stats.birthtime,
+            modified: stats.mtime,
+        };
+    }
+    /**
+     * Move file between categories
+     */
+    async moveFile(filename, fromCategory, toCategory) {
+        await this.initialize();
+        const sourcePath = this.getSafePath(filename, fromCategory);
+        const destPath = this.getSafePath(filename, toCategory);
+        if (!(await fsUtils.pathExists(sourcePath))) {
+            throw new Error(`Source file not found: ${filename}`);
+        }
+        await fsUtils.move(sourcePath, destPath, { overwrite: false });
+        const stats = await fsUtils.stat(destPath);
+        ensureLogger().debug(`File moved from ${fromCategory} to ${toCategory}: ${filename}`);
+        return {
+            name: filename,
+            size: stats.size,
+            path: destPath,
+            created: stats.birthtime,
+            modified: stats.mtime,
+        };
+    }
+    /**
+     * Get available base directories
+     */
+    getBaseDirectories() {
+        return { ...BASE_DIRS };
+    }
+    /**
+     * Save a user upload with security checks
+     * @param file - File buffer or stream
+     * @param originalName - Original filename from user
+     * @param options - Upload options
+     * @returns Information about the uploaded file
+     */
+    async saveUserUpload(file, originalName, options = {}) {
+        await this.initialize();
+        const { maxSize = this.maxFileSize, allowedTypes = [], destination = "uploads", generateUniqueName = true, preserveExtension = true, } = options;
+        // Sanitize the original filename
+        const sanitizedName = this.sanitizeFilename(originalName);
+        const ext = path.extname(sanitizedName).toLowerCase();
+        const nameWithoutExt = path.basename(sanitizedName, ext);
+        // Check file extension if restrictions are specified
+        if (allowedTypes.length > 0 && !allowedTypes.includes(ext)) {
+            throw new Error(`File type ${ext} is not allowed. Allowed types: ${allowedTypes.join(", ")}`);
+        }
+        // Generate filename
+        let filename;
+        if (generateUniqueName) {
+            const uniqueId = crypto.randomBytes(8).toString("hex");
+            filename = preserveExtension
+                ? `${nameWithoutExt}_${uniqueId}${ext}`
+                : `${uniqueId}`;
+        }
+        else {
+            filename = sanitizedName;
+        }
+        // Determine the upload path. Prefer known base directories, but allow custom
+        // destinations for backward compatibility with the old FileHandler API.
+        let uploadPath;
+        if (BASE_DIRS[destination]) {
+            uploadPath = this.getSafePath(filename, destination);
+        }
+        else {
+            const resolvedDest = path.isAbsolute(destination)
+                ? destination
+                : path.join(process.cwd(), destination);
+            await fsUtils.ensureDir(resolvedDest);
+            uploadPath = path.join(resolvedDest, this.sanitizeFilename(filename));
+        }
+        // Save the file
+        if (Buffer.isBuffer(file)) {
+            // Check size for buffer
+            if (file.length > maxSize) {
+                throw new Error(`File size exceeds maximum allowed size of ${maxSize} bytes`);
+            }
+            await fsUtils.writeFile(uploadPath, file);
+        }
+        else {
+            // For streams, we need to check size while writing
+            const writeStream = createWriteStream(uploadPath);
+            let size = 0;
+            await new Promise((resolve, reject) => {
+                file.on("data", (chunk) => {
+                    size += chunk.length;
+                    if (size > maxSize) {
+                        writeStream.destroy();
+                        fsUtils.unlink(uploadPath).catch(() => { }); // Clean up partial file
+                        reject(new Error(`File size exceeds maximum allowed size of ${maxSize} bytes`));
+                    }
+                });
+                file.on("error", reject);
+                writeStream.on("error", reject);
+                writeStream.on("finish", () => resolve(undefined));
+                file.pipe(writeStream);
+            });
+        }
+        // Generate file hash
+        const fileBuffer = await fsUtils.readFile(uploadPath);
+        const hash = crypto.createHash("sha256").update(fileBuffer).digest("hex");
+        // Get file stats
+        const stats = await fsUtils.stat(uploadPath);
+        const uploadedFile = {
+            originalName,
+            filename,
+            path: uploadPath,
+            size: stats.size,
+            extension: ext,
+            hash,
+        };
+        ensureLogger().info("User file uploaded successfully", {
+            originalName,
+            filename,
+            size: stats.size,
+            hash,
+        });
+        return uploadedFile;
+    }
+    /**
+     * Clean temporary files older than a given age. Falls back to ./temp to
+     * preserve the previous middleware behaviour.
+     */
+    async cleanTempFiles(maxAgeMs = 24 * 60 * 60 * 1000, tempDir = path.join(process.cwd(), "temp")) {
+        await fsUtils.ensureDir(tempDir);
+        const now = Date.now();
+        let deletedCount = 0;
+        try {
+            const files = await fsUtils.readdir(tempDir);
+            for (const file of files) {
+                const filePath = path.join(tempDir, file);
+                const stats = await fsUtils.stat(filePath);
+                if (!stats.isFile())
+                    continue;
+                if (now - stats.mtimeMs > maxAgeMs) {
+                    await fsUtils.unlink(filePath);
+                    deletedCount++;
+                }
+            }
+            if (deletedCount > 0) {
+                ensureLogger().info(`Cleaned ${deletedCount} temporary file(s) older than ${Math.round(maxAgeMs / (1000 * 60 * 60))}h`);
+            }
+        }
+        catch (_error) {
+            ensureLogger().error("Error cleaning temp files:", _error);
+        }
+        return deletedCount;
+    }
+    /**
+     * Save internal application data
+     * @param data - Data to save
+     * @param filename - Filename for the data
+     * @param category - Category/directory for the data
+     * @param options - Save options
+     */
+    async saveInternalData(data, filename, category = "data", options = {}) {
+        // If data is an object, stringify it
+        const finalData = typeof data === "object" && !Buffer.isBuffer(data)
+            ? JSON.stringify(data, null, 2)
+            : data;
+        // Use the existing save method
+        return this.saveFile(finalData, filename, category, options);
+    }
+}
+// Singleton instance
+let storageService = null;
+export function getStorageService() {
+    if (!storageService) {
+        storageService = new StorageService();
+    }
+    return storageService;
+}
+// Backward compatibility export (deprecated)
+export function getSecureFileHandler() {
+    console.warn("getSecureFileHandler is deprecated. Use getStorageService instead.");
+    return getStorageService();
+}
+// Export for backward compatibility (deprecated)
+export { StorageService as SecureFileHandler };
+export default StorageService;
+//# sourceMappingURL=storageService.js.map

package/dist/core/storageService.js.map

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

package/dist/desktop/bundler.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Desktop Bundler Module
+ * Handles bundling Node.js backends for Electron desktop applications
+ */
+export interface BundleOptions {
+    entryPoint: string;
+    outDir: string;
+    appName: string;
+    version: string;
+    platform?: "node" | "neutral";
+    target?: string;
+    format?: "cjs" | "esm";
+    minify?: boolean;
+    sourcemap?: boolean;
+    external?: string[];
+    env?: Record<string, string>;
+    resources?: {
+        config?: string;
+        data?: string[];
+    };
+    nativeModules?: {
+        autoDetect?: boolean;
+        modules?: string[];
+        rebuild?: boolean;
+    };
+}
+/**
+ * Bundle a Node.js backend for desktop deployment
+ */
+export declare function bundleBackend(options: BundleOptions): Promise<void>;
+/**
+ * Bundle dependencies separately for better caching
+ */
+export declare function bundleDependencies(packageJsonPath: string, outDir: string): Promise<void>;
+declare const _default: {
+    bundleBackend: typeof bundleBackend;
+    bundleDependencies: typeof bundleDependencies;
+};
+export default _default;
+//# sourceMappingURL=bundler.d.ts.map

package/dist/desktop/bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../src/desktop/bundler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,aAAa,CAAC,EAAE;QACd,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6HzE;AA6CD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAqCf;;;;;AAED,wBAGE"}

package/dist/desktop/bundler.js

@@ -0,0 +1,176 @@
+/**
+ * Desktop Bundler Module
+ * Handles bundling Node.js backends for Electron desktop applications
+ */
+import * as esbuild from "esbuild";
+import { ensureDir, writeFile, stat, copy, move, remove, writeJson, } from "../utils/fs-utils.js";
+import path from "path";
+import { execSync } from "child_process";
+import { createLogger } from "../core/index.js";
+import { detectNativeModules, copyNativeModules, createNativeModuleLoader, } from "./native-modules.js";
+const logger = createLogger("DesktopBundler");
+/**
+ * Bundle a Node.js backend for desktop deployment
+ */
+export async function bundleBackend(options) {
+    const { entryPoint, outDir, appName, version, platform = "node", target = "node18", format = "cjs", minify = false, sourcemap = false, external = [], env = {}, resources = {}, } = options;
+    logger.info(`Bundling backend for ${appName} v${version}`);
+    // Ensure output directory exists
+    await ensureDir(outDir);
+    // Default externals for Node.js
+    const defaultExternals = [
+        "fsevents", // Mac-specific, optional
+        "bufferutil", // Optional WebSocket performance
+        "utf-8-validate", // Optional WebSocket validation
+        "@superdangerous/app-framework/ui", // UI components not needed in backend
+        "serialport", // Optional serial port support
+        "@serialport/bindings-cpp", // Optional serial port bindings
+        "@aws-sdk/client-s3", // Optional AWS S3 support
+        "modbus-serial", // Optional Modbus communication
+    ];
+    // Build with esbuild
+    const result = await esbuild.build({
+        entryPoints: [entryPoint],
+        bundle: true,
+        platform,
+        target,
+        outfile: path.join(outDir, "backend.js"),
+        format,
+        minify,
+        sourcemap,
+        external: [...defaultExternals, ...external],
+        define: {
+            "process.env.NODE_ENV": '"production"',
+            "process.env.DESKTOP_MODE": '"true"',
+            ...Object.entries(env).reduce((acc, [key, value]) => {
+                acc[`process.env.${key}`] = JSON.stringify(value);
+                return acc;
+            }, {}),
+        },
+        loader: {
+            ".node": "file",
+            ".json": "json",
+        },
+        metafile: true,
+        logLevel: "info",
+    });
+    // Write metafile for analysis
+    await writeFile(path.join(outDir, "backend-meta.json"), JSON.stringify(result.metafile, null, 2));
+    // Create wrapper script
+    const wrapperScript = generateWrapperScript(appName, format);
+    await writeFile(path.join(outDir, "start-backend.js"), wrapperScript);
+    // Copy resources
+    if (resources.config) {
+        const configDest = path.join(outDir, "config");
+        await ensureDir(configDest);
+        await copy(resources.config, path.join(configDest, "app.json"));
+    }
+    if (resources.data) {
+        const dataDir = path.join(outDir, "data");
+        for (const dir of resources.data) {
+            await ensureDir(path.join(dataDir, dir));
+        }
+    }
+    // Handle native modules if configured
+    if (options.nativeModules) {
+        const projectDir = path.dirname(entryPoint);
+        // Detect native modules if requested
+        let nativeModulesList = options.nativeModules.modules || [];
+        if (options.nativeModules.autoDetect) {
+            const detected = await detectNativeModules(projectDir);
+            nativeModulesList = [...new Set([...nativeModulesList, ...detected])];
+            logger.info(`Detected native modules: ${nativeModulesList.join(", ")}`);
+        }
+        // Copy native modules to output directory
+        if (nativeModulesList.length > 0) {
+            await copyNativeModules({
+                modules: nativeModulesList,
+                sourceDir: projectDir,
+                targetDir: outDir,
+                rebuild: options.nativeModules.rebuild,
+            });
+            // Create native module loader
+            await createNativeModuleLoader(path.join(outDir, "native-loader.js"), nativeModulesList);
+            logger.info(`Copied ${nativeModulesList.length} native modules`);
+        }
+    }
+    // Get bundle size
+    const stats = await stat(path.join(outDir, "backend.js"));
+    const sizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+    logger.info(`✅ Backend bundled successfully!`);
+    logger.info(`   Bundle size: ${sizeMB} MB`);
+    logger.info(`   Location: ${outDir}/backend.js`);
+}
+/**
+ * Generate wrapper script for starting the bundled backend
+ */
+function generateWrapperScript(appName, format) {
+    return `#!/usr/bin/env node
+
+/**
+ * Desktop App Backend Wrapper for ${appName}
+ * Sets up environment and starts the bundled backend
+ */
+
+${format === "esm" ? "import { fileURLToPath } from 'url';" : ""}
+${format === "esm" ? "import { dirname, join } from 'path';" : "const path = require('path');"}
+
+${format === "esm"
+        ? `
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+`
+        : ""}
+
+// Set environment variables
+process.env.NODE_ENV = process.env.NODE_ENV || 'production';
+process.env.DESKTOP_MODE = 'true';
+
+// Set data directory to app data location
+if (!process.env.DATA_DIR) {
+  // In production, this will be set by Electron
+  // For testing, use a local data directory
+  process.env.DATA_DIR = ${format === "esm" ? "join" : "path.join"}(__dirname, 'data');
+}
+
+// Note: Using console.log in wrapper script as it runs in production without logger
+console.log('Starting ${appName} Backend...');
+console.log('Data directory:', process.env.DATA_DIR);
+
+// Start the bundled backend
+${format === "cjs" ? "require('./backend.js');" : "import('./backend.js');"}
+`;
+}
+/**
+ * Bundle dependencies separately for better caching
+ */
+export async function bundleDependencies(packageJsonPath, outDir) {
+    const fs = await import("fs");
+    const packageJson = JSON.parse(await fs.promises.readFile(packageJsonPath, "utf8"));
+    const dependencies = packageJson.dependencies || {};
+    logger.info("Installing production dependencies...");
+    // Create temporary directory for dependencies
+    const tempDir = path.join(outDir, "temp");
+    await ensureDir(tempDir);
+    // Create minimal package.json
+    const minimalPackage = {
+        name: packageJson.name,
+        version: packageJson.version,
+        dependencies,
+    };
+    await writeJson(path.join(tempDir, "package.json"), minimalPackage);
+    // Install production dependencies
+    execSync("npm install --production --no-audit --no-fund", {
+        cwd: tempDir,
+        stdio: "inherit",
+    });
+    // Move node_modules to output directory
+    await move(path.join(tempDir, "node_modules"), path.join(outDir, "node_modules"), { overwrite: true });
+    // Clean up temp directory
+    await remove(tempDir);
+}
+export default {
+    bundleBackend,
+    bundleDependencies,
+};
+//# sourceMappingURL=bundler.js.map

package/dist/desktop/bundler.js.map

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