@fluidframework/fluid-runner 2.0.0-internal.1.1.1 → 2.0.0-internal.1.1.2

package/README.md

@@ -6,15 +6,38 @@ Allows some execution to be made on a container given a provided ODSP snapshot.
 
 ### Sample command
 If package is installed globally:
-`node fluid-runner exportFile --codeLoader=compiledBundle.js --inputFile=inputFileName.fluid --outputFolder=outputFolderName --scenario=test --telemetryFile=telemetryFile.txt`
+`node fluid-runner exportFile --codeLoader=compiledBundle.js --inputFile=inputFileName.fluid --outputFile=result.txt --telemetryFile=telemetryFile.txt`
 
 If working directly on this package:
-`node bin/fluidRunner exportFile --codeLoader=compiledBundle.js --inputFile=inputFileName.fluid --outputFolder=outputFolderName --scenario=test --telemetryFile=telemetryFile.txt`
+```node bin/fluid-runner exportFile --codeLoader=compiledBundle.js --inputFile=inputFileName.fluid --outputFile=result.txt --telemetryFile=telemetryFile.txt```
 
 ### Code Loader bundle format
 The Code Loader bundle should provide defined exports required for this functionality.
 For more details on what exports are needed, see [codeLoaderBundle.ts](./src/codeLoaderBundle.ts).
 
+#### "codeLoader" vs "IFluidFileConverter" argument
+You may notice the command line argument `codeLoader` is optional. If you choose not to provide a value for `codeLoader`, you must extend this library
+and provide a [`IFluidFileConverter`](./src/codeLoaderBundle.ts) implementation to the [`fluidRunner(...)`](./src/fluidRunner.ts) method.
+
+```
+import { fluidRunner } from "@fluidframework/fluid-runner";
+
+fluidRunner({ /* IFluidFileConverter implementation here */ });
+```
+
+> **Note**: Only one of `codeLoader` or `fluidRunner(...)` argument is allowed. If both or none are provided, an error will be thrown at the start of execution.
+
 ### Input file format
 The input file is expected to be an ODSP snapshot.
 For some examples, see the files in the [localOdspSnapshots folder](./src/test/localOdspSnapshots).
+
+### Consumption
+The code around `exportFile` can be consumed in multiple different layers. It is not necessary to run all this code fully as is, and the following are some interesting code bits involved in this workflow:
+- [`createLogger(...)`](./src/logger/FileLogger.ts)
+    - Wraps a provided `FileLogger` and adds some useful telemetry data to every entry
+- [`createContainerAndExecute(...)`](./src/exportFile.ts)
+    - This is the core logic for running some action based on a local ODSP snapshot
+- [`getSnapshotFileContent(...)`](./src/utils.ts)
+    - Reads a local ODSP snapshot from both JSON and binary formats for usage in `createContainerAndExecute(...)`
+
+For an example of a consumption path that differs slightly to [`exportFile(...)`](./src/exportFile.ts), see [`parseBundleAndExportFile(...)`](./src/parseBundleAndExportFile.ts). In addition to running the same logic as [`exportFile`](./src/exportFile.ts) method, it implements the logic around parsing a dynamically provided bundle path into an `IFluidFileConverter` object.

package/dist/codeLoaderBundle.d.ts

@@ -20,21 +20,20 @@ export interface ICodeLoaderBundle {
  */
 export interface IFluidFileConverter {
     /**
-     * Code loader details to provide at Loader creation
+     * Get code loader details to provide at Loader creation
+     * @param logger - created logger object to pass to code loader
      */
-    codeLoader: ICodeDetailsLoader;
+    getCodeLoader(logger: ITelemetryBaseLogger): Promise<ICodeDetailsLoader>;
     /**
      * Scope object to provide at Loader creation
      */
     scope?: FluidObject;
     /**
-     * Execute code and return the results
+     * Executes code on container and returns the result
      * @param container - container created by this application
-     * @param scenario - scenario this execution is related to
-     * @param logger - passed through logger object
-     * @returns - object containing file names as property keys and file content as values
+     * @param options - additional options
      */
-    execute(container: IContainer, scenario: string, logger: ITelemetryBaseLogger): Promise<Record<string, string>>;
+    execute(container: IContainer, options?: string): Promise<string>;
 }
 /**
  * Type cast to ensure necessary methods are present in the provided bundle

package/dist/codeLoaderBundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codeLoaderBundle.d.ts","sourceRoot":"","sources":["../src/codeLoaderBundle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D;;;GAGG;AACF,MAAM,WAAW,iBAAiB;IAC/B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,UAAU,EAAE,kBAAkB,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnH;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,iBAAiB,CAG3E;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,mBAAmB,CAIzE"}
+{"version":3,"file":"codeLoaderBundle.d.ts","sourceRoot":"","sources":["../src/codeLoaderBundle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEzE;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,iBAAiB,CAG3E;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,mBAAmB,CAIzE"}

package/dist/codeLoaderBundle.js

@@ -16,7 +16,7 @@ function isCodeLoaderBundle(bundle) {
 exports.isCodeLoaderBundle = isCodeLoaderBundle;
 function isFluidFileConverter(obj) {
     // eslint-disable-next-line @typescript-eslint/no-unsafe-return
-    return (obj === null || obj === void 0 ? void 0 : obj.codeLoader) && typeof obj.codeLoader === "object"
+    return (obj === null || obj === void 0 ? void 0 : obj.getCodeLoader) && typeof obj.getCodeLoader === "function"
         && obj.execute && typeof obj.execute === "function";
 }
 exports.isFluidFileConverter = isFluidFileConverter;

package/dist/codeLoaderBundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"codeLoaderBundle.js","sourceRoot":"","sources":["../src/codeLoaderBundle.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAyCH;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,MAAW;IAC1C,+DAA+D;IAC/D,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,WAAW,KAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC;AACzE,CAAC;AAHD,gDAGC;AAED,SAAgB,oBAAoB,CAAC,GAAQ;IACzC,+DAA+D;IAC/D,OAAO,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,UAAU,KAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;WACrD,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC;AAC5D,CAAC;AAJD,oDAIC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { ITelemetryBaseLogger } from \"@fluidframework/common-definitions\";\nimport { ICodeDetailsLoader, IContainer } from \"@fluidframework/container-definitions\";\nimport { FluidObject } from \"@fluidframework/core-interfaces\";\n\n/**\n * Contract that defines the necessary exports for the bundle provided at runtime\n * For an example, see \"src/test/sampleCodeLoaders/sampleCodeLoader.ts\"\n */\n export interface ICodeLoaderBundle {\n    /**\n     * Fluid export of all the required objects and functions\n     */\n    fluidExport: Promise<IFluidFileConverter>;\n}\n\n/**\n * Instance that holds all the details for Fluid file conversion\n */\nexport interface IFluidFileConverter {\n    /**\n     * Code loader details to provide at Loader creation\n     */\n    codeLoader: ICodeDetailsLoader;\n\n    /**\n     * Scope object to provide at Loader creation\n     */\n    scope?: FluidObject;\n\n    /**\n     * Execute code and return the results\n     * @param container - container created by this application\n     * @param scenario - scenario this execution is related to\n     * @param logger - passed through logger object\n     * @returns - object containing file names as property keys and file content as values\n     */\n    execute(container: IContainer, scenario: string, logger: ITelemetryBaseLogger): Promise<Record<string, string>>;\n}\n\n/**\n * Type cast to ensure necessary methods are present in the provided bundle\n * @param bundle - bundle provided to this application\n */\nexport function isCodeLoaderBundle(bundle: any): bundle is ICodeLoaderBundle {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return bundle?.fluidExport && typeof bundle.fluidExport === \"object\";\n}\n\nexport function isFluidFileConverter(obj: any): obj is IFluidFileConverter {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return obj?.codeLoader && typeof obj.codeLoader === \"object\"\n        && obj.execute && typeof obj.execute === \"function\";\n}\n"]}
+{"version":3,"file":"codeLoaderBundle.js","sourceRoot":"","sources":["../src/codeLoaderBundle.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAwCH;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,MAAW;IAC1C,+DAA+D;IAC/D,OAAO,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,WAAW,KAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC;AACzE,CAAC;AAHD,gDAGC;AAED,SAAgB,oBAAoB,CAAC,GAAQ;IACzC,+DAA+D;IAC/D,OAAO,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,aAAa,KAAI,OAAO,GAAG,CAAC,aAAa,KAAK,UAAU;WAC7D,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC;AAC5D,CAAC;AAJD,oDAIC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport { ITelemetryBaseLogger } from \"@fluidframework/common-definitions\";\nimport { ICodeDetailsLoader, IContainer } from \"@fluidframework/container-definitions\";\nimport { FluidObject } from \"@fluidframework/core-interfaces\";\n\n/**\n * Contract that defines the necessary exports for the bundle provided at runtime\n * For an example, see \"src/test/sampleCodeLoaders/sampleCodeLoader.ts\"\n */\nexport interface ICodeLoaderBundle {\n    /**\n     * Fluid export of all the required objects and functions\n     */\n    fluidExport: Promise<IFluidFileConverter>;\n}\n\n/**\n * Instance that holds all the details for Fluid file conversion\n */\nexport interface IFluidFileConverter {\n    /**\n     * Get code loader details to provide at Loader creation\n     * @param logger - created logger object to pass to code loader\n     */\n    getCodeLoader(logger: ITelemetryBaseLogger): Promise<ICodeDetailsLoader>;\n\n    /**\n     * Scope object to provide at Loader creation\n     */\n    scope?: FluidObject;\n\n    /**\n     * Executes code on container and returns the result\n     * @param container - container created by this application\n     * @param options - additional options\n     */\n    execute(container: IContainer, options?: string): Promise<string>;\n}\n\n/**\n * Type cast to ensure necessary methods are present in the provided bundle\n * @param bundle - bundle provided to this application\n */\nexport function isCodeLoaderBundle(bundle: any): bundle is ICodeLoaderBundle {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return bundle?.fluidExport && typeof bundle.fluidExport === \"object\";\n}\n\nexport function isFluidFileConverter(obj: any): obj is IFluidFileConverter {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return obj?.getCodeLoader && typeof obj.getCodeLoader === \"function\"\n        && obj.execute && typeof obj.execute === \"function\";\n}\n"]}

package/dist/exportFile.d.ts

@@ -14,7 +14,14 @@ interface IExportFileResponseFailure {
     errorMessage: string;
     error?: any;
 }
-export declare function exportFile(codeLoader: string, inputFile: string, outputFolder: string, scenario: string, logger: ITelemetryLogger): Promise<IExportFileResponse>;
-export declare function createContainerAndExecute(localOdspSnapshot: string, fluidFileConverter: IFluidFileConverter, scenario: string, logger: ITelemetryLogger): Promise<Record<string, string>>;
+/**
+ * Execute code on Container based on ODSP snapshot and write result to file
+ */
+export declare function exportFile(fluidFileConverter: IFluidFileConverter, inputFile: string, outputFile: string, telemetryFile: string, options?: string): Promise<IExportFileResponse>;
+/**
+ * Create the container based on an ODSP snapshot and execute code on it
+ * @returns result of execution
+ */
+export declare function createContainerAndExecute(localOdspSnapshot: string | Uint8Array, fluidFileConverter: IFluidFileConverter, logger: ITelemetryLogger, options?: string): Promise<string>;
 export {};
 //# sourceMappingURL=exportFile.d.ts.map

package/dist/exportFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exportFile.d.ts","sourceRoot":"","sources":["../src/exportFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAMtE,OAAO,EAAE,mBAAmB,EAA4C,MAAM,oBAAoB,CAAC;AAGnG,oBAAY,mBAAmB,GAAG,0BAA0B,GAAG,0BAA0B,CAAC;AAE1F,UAAU,0BAA0B;IAChC,OAAO,EAAE,IAAI,CAAC;CACjB;AAED,UAAU,0BAA0B;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,GAAG,CAAC;CACf;AAID,wBAAsB,UAAU,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CA6C9B;AAED,wBAAsB,yBAAyB,CAC3C,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,EAAE,mBAAmB,EACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAcjC"}
+{"version":3,"file":"exportFile.d.ts","sourceRoot":"","sources":["../src/exportFile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAMtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAMzD,oBAAY,mBAAmB,GAAG,0BAA0B,GAAG,0BAA0B,CAAC;AAE1F,UAAU,0BAA0B;IAChC,OAAO,EAAE,IAAI,CAAC;CACjB;AAED,UAAU,0BAA0B;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,GAAG,CAAC;CACf;AAID;;GAEG;AACH,wBAAsB,UAAU,CAC5B,kBAAkB,EAAE,mBAAmB,EACvC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CAkC9B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC3C,iBAAiB,EAAE,MAAM,GAAG,UAAU,EACtC,kBAAkB,EAAE,mBAAmB,EACvC,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/dist/exportFile.js

@@ -22,70 +22,68 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createContainerAndExecute = exports.exportFile = void 0;
 const fs = __importStar(require("fs"));
-const path_1 = __importDefault(require("path"));
 const container_definitions_1 = require("@fluidframework/container-definitions");
 const container_loader_1 = require("@fluidframework/container-loader");
 const odsp_driver_1 = require("@fluidframework/odsp-driver");
 const telemetry_utils_1 = require("@fluidframework/telemetry-utils");
 const getArgsValidationError_1 = require("./getArgsValidationError");
-const codeLoaderBundle_1 = require("./codeLoaderBundle");
 const fakeUrlResolver_1 = require("./fakeUrlResolver");
+const utils_1 = require("./utils");
+// eslint-disable-next-line import/no-internal-modules
+const FileLogger_1 = require("./logger/FileLogger");
 const clientArgsValidationError = "Client_ArgsValidationError";
-async function exportFile(codeLoader, inputFile, outputFolder, scenario, logger) {
+/**
+ * Execute code on Container based on ODSP snapshot and write result to file
+ */
+async function exportFile(fluidFileConverter, inputFile, outputFile, telemetryFile, options) {
+    const telemetryArgError = (0, FileLogger_1.getTelemetryFileValidationError)(telemetryFile);
+    if (telemetryArgError) {
+        const eventName = clientArgsValidationError;
+        return { success: false, eventName, errorMessage: telemetryArgError };
+    }
+    const fileLogger = new FileLogger_1.FileLogger(telemetryFile);
+    const logger = (0, FileLogger_1.createLogger)(fileLogger);
     try {
         return await telemetry_utils_1.PerformanceEvent.timedExecAsync(logger, { eventName: "ExportFile" }, async () => {
-            const argsValidationError = (0, getArgsValidationError_1.getArgsValidationError)(inputFile, outputFolder, scenario);
+            const argsValidationError = (0, getArgsValidationError_1.getArgsValidationError)(inputFile, outputFile);
             if (argsValidationError) {
                 const eventName = clientArgsValidationError;
+                logger.sendErrorEvent({ eventName, message: argsValidationError });
                 return { success: false, eventName, errorMessage: argsValidationError };
             }
-            // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires
-            const codeLoaderBundle = require(codeLoader);
-            if (!(0, codeLoaderBundle_1.isCodeLoaderBundle)(codeLoaderBundle)) {
-                const eventName = clientArgsValidationError;
-                const errorMessage = "Code loader bundle is not of type ICodeLoaderBundle";
-                return { success: false, eventName, errorMessage };
-            }
-            const fluidExport = await codeLoaderBundle.fluidExport;
-            if (!(0, codeLoaderBundle_1.isFluidFileConverter)(fluidExport)) {
-                const eventName = clientArgsValidationError;
-                const errorMessage = "Fluid export from CodeLoaderBundle is not of type IFluidFileConverter";
-                return { success: false, eventName, errorMessage };
-            }
-            // TODO: read file stream
-            const inputFileContent = fs.readFileSync(inputFile, { encoding: "utf-8" });
-            const results = await createContainerAndExecute(inputFileContent, fluidExport, scenario, logger);
-            // eslint-disable-next-line guard-for-in, no-restricted-syntax
-            for (const key in results) {
-                fs.appendFileSync(path_1.default.join(outputFolder, key), results[key]);
-            }
+            fs.writeFileSync(outputFile, await createContainerAndExecute((0, utils_1.getSnapshotFileContent)(inputFile), fluidFileConverter, logger, options));
             return { success: true };
         });
     }
     catch (error) {
         const eventName = "Client_UnexpectedError";
+        logger.sendErrorEvent({ eventName }, error);
         return { success: false, eventName, errorMessage: "Unexpected error", error };
     }
+    finally {
+        await fileLogger.flush();
+    }
 }
 exports.exportFile = exportFile;
-async function createContainerAndExecute(localOdspSnapshot, fluidFileConverter, scenario, logger) {
+/**
+ * Create the container based on an ODSP snapshot and execute code on it
+ * @returns result of execution
+ */
+async function createContainerAndExecute(localOdspSnapshot, fluidFileConverter, logger, options) {
     const loader = new container_loader_1.Loader({
         urlResolver: new fakeUrlResolver_1.FakeUrlResolver(),
         documentServiceFactory: (0, odsp_driver_1.createLocalOdspDocumentServiceFactory)(localOdspSnapshot),
-        codeLoader: fluidFileConverter.codeLoader,
+        codeLoader: await fluidFileConverter.getCodeLoader(logger),
         scope: fluidFileConverter.scope,
         logger,
     });
     const container = await loader.resolve({ url: "/fakeUrl/", headers: {
             [container_definitions_1.LoaderHeader.loadMode]: { opsBeforeReturn: "cached" }
         } });
-    return telemetry_utils_1.PerformanceEvent.timedExecAsync(logger, { eventName: "ExportFile" }, async () => fluidFileConverter.execute(container, scenario, logger));
+    return telemetry_utils_1.PerformanceEvent.timedExecAsync(logger, { eventName: "ExportFile" }, async () => fluidFileConverter.execute(container, options));
 }
 exports.createContainerAndExecute = createContainerAndExecute;
 //# sourceMappingURL=exportFile.js.map

package/dist/exportFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"exportFile.js","sourceRoot":"","sources":["../src/exportFile.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport * as fs from \"fs\";\nimport path from \"path\";\nimport { ITelemetryLogger } from \"@fluidframework/common-definitions\";\nimport { LoaderHeader } from \"@fluidframework/container-definitions\";\nimport { Loader } from \"@fluidframework/container-loader\";\nimport { createLocalOdspDocumentServiceFactory } from \"@fluidframework/odsp-driver\";\nimport { PerformanceEvent } from \"@fluidframework/telemetry-utils\";\nimport { getArgsValidationError } from \"./getArgsValidationError\";\nimport { IFluidFileConverter, isCodeLoaderBundle, isFluidFileConverter } from \"./codeLoaderBundle\";\nimport { FakeUrlResolver } from \"./fakeUrlResolver\";\n\nexport type IExportFileResponse = IExportFileResponseSuccess | IExportFileResponseFailure;\n\ninterface IExportFileResponseSuccess {\n    success: true;\n}\n\ninterface IExportFileResponseFailure {\n    success: false;\n    eventName: string;\n    errorMessage: string;\n    error?: any;\n}\n\nconst clientArgsValidationError = \"Client_ArgsValidationError\";\n\nexport async function exportFile(\n    codeLoader: string,\n    inputFile: string,\n    outputFolder: string,\n    scenario: string,\n    logger: ITelemetryLogger,\n): Promise<IExportFileResponse> {\n    try {\n        return await PerformanceEvent.timedExecAsync(logger, { eventName: \"ExportFile\" }, async () => {\n            const argsValidationError = getArgsValidationError(inputFile, outputFolder, scenario);\n            if (argsValidationError) {\n                const eventName = clientArgsValidationError;\n                return { success: false, eventName, errorMessage: argsValidationError };\n            }\n\n            // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n            const codeLoaderBundle = require(codeLoader);\n            if (!isCodeLoaderBundle(codeLoaderBundle)) {\n                const eventName = clientArgsValidationError;\n                const errorMessage = \"Code loader bundle is not of type ICodeLoaderBundle\";\n                return { success: false, eventName, errorMessage };\n            }\n\n            const fluidExport = await codeLoaderBundle.fluidExport;\n            if (!isFluidFileConverter(fluidExport)) {\n                const eventName = clientArgsValidationError;\n                const errorMessage = \"Fluid export from CodeLoaderBundle is not of type IFluidFileConverter\";\n                return { success: false, eventName, errorMessage };\n            }\n\n            // TODO: read file stream\n            const inputFileContent = fs.readFileSync(inputFile, { encoding: \"utf-8\" });\n\n            const results = await createContainerAndExecute(\n                inputFileContent,\n                fluidExport,\n                scenario,\n                logger,\n            );\n\n            // eslint-disable-next-line guard-for-in, no-restricted-syntax\n            for (const key in results) {\n                fs.appendFileSync(path.join(outputFolder, key), results[key]);\n            }\n\n            return { success: true };\n        });\n    } catch (error) {\n        const eventName = \"Client_UnexpectedError\";\n        return { success: false, eventName, errorMessage: \"Unexpected error\", error };\n    }\n}\n\nexport async function createContainerAndExecute(\n    localOdspSnapshot: string,\n    fluidFileConverter: IFluidFileConverter,\n    scenario: string,\n    logger: ITelemetryLogger,\n): Promise<Record<string, string>> {\n    const loader = new Loader({\n        urlResolver: new FakeUrlResolver(),\n        documentServiceFactory: createLocalOdspDocumentServiceFactory(localOdspSnapshot),\n        codeLoader: fluidFileConverter.codeLoader,\n        scope: fluidFileConverter.scope,\n        logger,\n    });\n\n    const container = await loader.resolve({ url: \"/fakeUrl/\", headers: {\n        [LoaderHeader.loadMode]: { opsBeforeReturn: \"cached\" } } });\n\n    return PerformanceEvent.timedExecAsync(logger, { eventName: \"ExportFile\" }, async () =>\n        fluidFileConverter.execute(container, scenario, logger));\n}\n"]}
+{"version":3,"file":"exportFile.js","sourceRoot":"","sources":["../src/exportFile.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport * as fs from \"fs\";\nimport { ITelemetryLogger } from \"@fluidframework/common-definitions\";\nimport { LoaderHeader } from \"@fluidframework/container-definitions\";\nimport { Loader } from \"@fluidframework/container-loader\";\nimport { createLocalOdspDocumentServiceFactory } from \"@fluidframework/odsp-driver\";\nimport { PerformanceEvent } from \"@fluidframework/telemetry-utils\";\nimport { getArgsValidationError } from \"./getArgsValidationError\";\nimport { IFluidFileConverter } from \"./codeLoaderBundle\";\nimport { FakeUrlResolver } from \"./fakeUrlResolver\";\nimport { getSnapshotFileContent } from \"./utils\";\n// eslint-disable-next-line import/no-internal-modules\nimport { createLogger, FileLogger, getTelemetryFileValidationError } from \"./logger/FileLogger\";\n\nexport type IExportFileResponse = IExportFileResponseSuccess | IExportFileResponseFailure;\n\ninterface IExportFileResponseSuccess {\n    success: true;\n}\n\ninterface IExportFileResponseFailure {\n    success: false;\n    eventName: string;\n    errorMessage: string;\n    error?: any;\n}\n\nconst clientArgsValidationError = \"Client_ArgsValidationError\";\n\n/**\n * Execute code on Container based on ODSP snapshot and write result to file\n */\nexport async function exportFile(\n    fluidFileConverter: IFluidFileConverter,\n    inputFile: string,\n    outputFile: string,\n    telemetryFile: string,\n    options?: string,\n): Promise<IExportFileResponse> {\n    const telemetryArgError = getTelemetryFileValidationError(telemetryFile);\n    if (telemetryArgError) {\n        const eventName = clientArgsValidationError;\n        return { success: false, eventName, errorMessage: telemetryArgError };\n    }\n    const fileLogger = new FileLogger(telemetryFile);\n    const logger = createLogger(fileLogger);\n\n    try {\n        return await PerformanceEvent.timedExecAsync(logger, { eventName: \"ExportFile\" }, async () => {\n            const argsValidationError = getArgsValidationError(inputFile, outputFile);\n            if (argsValidationError) {\n                const eventName = clientArgsValidationError;\n                logger.sendErrorEvent({ eventName, message: argsValidationError });\n                return { success: false, eventName, errorMessage: argsValidationError };\n            }\n\n            fs.writeFileSync(outputFile, await createContainerAndExecute(\n                getSnapshotFileContent(inputFile),\n                fluidFileConverter,\n                logger,\n                options,\n            ));\n\n            return { success: true };\n        });\n    } catch (error) {\n        const eventName = \"Client_UnexpectedError\";\n        logger.sendErrorEvent({ eventName }, error);\n        return { success: false, eventName, errorMessage: \"Unexpected error\", error };\n    } finally {\n        await fileLogger.flush();\n    }\n}\n\n/**\n * Create the container based on an ODSP snapshot and execute code on it\n * @returns result of execution\n */\nexport async function createContainerAndExecute(\n    localOdspSnapshot: string | Uint8Array,\n    fluidFileConverter: IFluidFileConverter,\n    logger: ITelemetryLogger,\n    options?: string,\n): Promise<string> {\n    const loader = new Loader({\n        urlResolver: new FakeUrlResolver(),\n        documentServiceFactory: createLocalOdspDocumentServiceFactory(localOdspSnapshot),\n        codeLoader: await fluidFileConverter.getCodeLoader(logger),\n        scope: fluidFileConverter.scope,\n        logger,\n    });\n\n    const container = await loader.resolve({ url: \"/fakeUrl/\", headers: {\n        [LoaderHeader.loadMode]: { opsBeforeReturn: \"cached\" } } });\n\n    return PerformanceEvent.timedExecAsync(logger, { eventName: \"ExportFile\" }, async () =>\n        fluidFileConverter.execute(container, options));\n}\n"]}

package/dist/fluidRunner.d.ts

@@ -2,5 +2,9 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export {};
+import { IFluidFileConverter } from "./codeLoaderBundle";
+/**
+ * @param fluidFileConverter - needs to be provided if "codeLoaderBundle" is not and vice versa
+ */
+export declare function fluidRunner(fluidFileConverter?: IFluidFileConverter): void;
 //# sourceMappingURL=fluidRunner.d.ts.map

package/dist/fluidRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fluidRunner.d.ts","sourceRoot":"","sources":["../src/fluidRunner.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
+{"version":3,"file":"fluidRunner.d.ts","sourceRoot":"","sources":["../src/fluidRunner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;GAEG;AACH,wBAAgB,WAAW,CAAC,kBAAkB,CAAC,EAAE,mBAAmB,QAwEnE"}

package/dist/fluidRunner.js

@@ -23,66 +23,79 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const fs = __importStar(require("fs"));
+exports.fluidRunner = void 0;
 const yargs = __importStar(require("yargs"));
-const telemetry_utils_1 = require("@fluidframework/telemetry-utils");
 const exportFile_1 = require("./exportFile");
-// eslint-disable-next-line import/no-internal-modules
-const FileLogger_1 = require("./logger/FileLogger");
-function fluidRunner() {
+const parseBundleAndExportFile_1 = require("./parseBundleAndExportFile");
+/**
+ * @param fluidFileConverter - needs to be provided if "codeLoaderBundle" is not and vice versa
+ */
+function fluidRunner(fluidFileConverter) {
     // eslint-disable-next-line @typescript-eslint/no-unused-expressions
     yargs
         .strict()
         .version(false)
-        .command("exportFile", "Generate an output for a local snapshot", 
+        .command("exportFile", "Generate an output for a local ODSP snapshot", 
     // eslint-disable-next-line @typescript-eslint/no-shadow
     (yargs) => yargs
         .option("codeLoader", {
-        describe: "Name of the code loader bundle",
+        // eslint-disable-next-line max-len
+        describe: "Path to code loader bundle. Required if this application is being called without modification.\nSee \"README.md\" for more details.",
         type: "string",
-        demandOption: true,
+        demandOption: false,
     })
         .option("inputFile", {
-        describe: "Name of the file containing local ODSP snapshot",
+        describe: "Path to local ODSP snapshot",
         type: "string",
         demandOption: true,
     })
-        .option("outputFolder", {
-        describe: "Name of the output file",
+        .option("outputFile", {
+        describe: "Path of output file (cannot already exist).\nExecution result will be written here",
         type: "string",
         demandOption: true,
     })
-        .option("scenario", {
-        describe: "Name of scenario to invoke",
+        .option("telemetryFile", {
+        describe: "Path of telemetry file for config and session data (cannot already exist)",
         type: "string",
         demandOption: true,
     })
-        .option("telemetryFile", {
-        describe: "Config and session data for telemetry",
+        .option("options", {
+        describe: "Additional options passed to container on execution",
         type: "string",
-        demandOption: true,
+        demandOption: false,
     }), 
     // eslint-disable-next-line @typescript-eslint/no-misused-promises
     async (argv) => {
-        if (fs.existsSync(argv.telemetryFile)) {
-            console.error(`Telemetry file already exists [${argv.telemetryFile}]`);
+        const argsError = validateProvidedArgs(argv.codeLoader, fluidFileConverter);
+        if (argsError) {
+            console.error(argsError);
             process.exit(1);
         }
-        const fileLogger = new FileLogger_1.FileLogger(argv.telemetryFile);
-        const logger = telemetry_utils_1.ChildLogger.create(fileLogger, "LocalSnapshotRunnerApp", { all: { Event_Time: () => Date.now() } });
-        const result = await (0, exportFile_1.exportFile)(argv.codeLoader, argv.inputFile, argv.outputFolder, argv.scenario, logger);
+        let result;
+        if (argv.codeLoader) {
+            result = await (0, parseBundleAndExportFile_1.parseBundleAndExportFile)(argv.codeLoader, argv.inputFile, argv.outputFile, argv.telemetryFile, argv.options);
+        }
+        else {
+            result = await (0, exportFile_1.exportFile)(fluidFileConverter, argv.inputFile, argv.outputFile, argv.telemetryFile, argv.options);
+        }
         if (!result.success) {
             console.error(`${result.eventName}: ${result.errorMessage}`);
-            logger.sendErrorEvent({ eventName: result.eventName, message: result.errorMessage }, result.error);
-            await fileLogger.flush();
             process.exit(1);
         }
-        else {
-            await fileLogger.flush();
-        }
     })
         .help()
         .demandCommand().argv;
 }
+exports.fluidRunner = fluidRunner;
+function validateProvidedArgs(codeLoader, fluidFileConverter) {
+    if (codeLoader !== undefined && fluidFileConverter !== undefined) {
+        return "\"codeLoader\" and \"fluidFileConverter\" cannot both be provided. See \"fluidRunner.ts\" for details.";
+    }
+    if (codeLoader === undefined && fluidFileConverter === undefined) {
+        // eslint-disable-next-line max-len
+        return "\"codeLoader\" must be provided if there is no explicit \"fluidFileConverter\". See \"fluidRunner.ts\" for details.";
+    }
+    return undefined;
+}
 fluidRunner();
 //# sourceMappingURL=fluidRunner.js.map

package/dist/fluidRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"fluidRunner.js","sourceRoot":"","sources":["../src/fluidRunner.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,6CAA+B;AAC/B,qEAA8D;AAC9D,6CAA0C;AAC1C,sDAAsD;AACtD,oDAAiD;AAEjD,SAAS,WAAW;IAChB,oEAAoE;IACpE,KAAK;SACA,MAAM,EAAE;SACR,OAAO,CAAC,KAAK,CAAC;SACd,OAAO,CACJ,YAAY,EACZ,yCAAyC;IACzC,wDAAwD;IACxD,CAAC,KAAK,EAAE,EAAE,CACN,KAAK;SACA,MAAM,CAAC,YAAY,EAAE;QAClB,QAAQ,EAAE,gCAAgC;QAC1C,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACrB,CAAC;SACD,MAAM,CAAC,WAAW,EAAE;QACjB,QAAQ,EAAE,iDAAiD;QAC3D,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACrB,CAAC;SACD,MAAM,CAAC,cAAc,EAAE;QACpB,QAAQ,EAAE,yBAAyB;QACnC,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACrB,CAAC;SACD,MAAM,CAAC,UAAU,EAAE;QAChB,QAAQ,EAAE,4BAA4B;QACtC,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACrB,CAAC;SACD,MAAM,CAAC,eAAe,EAAE;QACrB,QAAQ,EAAE,uCAAuC;QACjD,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACrB,CAAC;IACV,kEAAkE;IAClE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE;YACnC,OAAO,CAAC,KAAK,CAAC,kCAAkC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACnB;QAED,MAAM,UAAU,GAAG,IAAI,uBAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,6BAAW,CAAC,MAAM,CAAC,UAAU,EAAE,wBAAwB,EAClE,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,MAAM,IAAA,uBAAU,EAC3B,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,QAAQ,EACb,MAAM,CACT,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YACjB,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC7D,MAAM,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACnG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACnB;aAAM;YACH,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;SAC5B;IACL,CAAC,CACJ;SACA,IAAI,EAAE;SACN,aAAa,EAAE,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED,WAAW,EAAE,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport * as fs from \"fs\";\nimport * as yargs from \"yargs\";\nimport { ChildLogger } from \"@fluidframework/telemetry-utils\";\nimport { exportFile } from \"./exportFile\";\n// eslint-disable-next-line import/no-internal-modules\nimport { FileLogger } from \"./logger/FileLogger\";\n\nfunction fluidRunner() {\n    // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n    yargs\n        .strict()\n        .version(false)\n        .command(\n            \"exportFile\",\n            \"Generate an output for a local snapshot\",\n            // eslint-disable-next-line @typescript-eslint/no-shadow\n            (yargs) =>\n                yargs\n                    .option(\"codeLoader\", {\n                        describe: \"Name of the code loader bundle\",\n                        type: \"string\",\n                        demandOption: true,\n                    })\n                    .option(\"inputFile\", {\n                        describe: \"Name of the file containing local ODSP snapshot\",\n                        type: \"string\",\n                        demandOption: true,\n                    })\n                    .option(\"outputFolder\", {\n                        describe: \"Name of the output file\",\n                        type: \"string\",\n                        demandOption: true,\n                    })\n                    .option(\"scenario\", {\n                        describe: \"Name of scenario to invoke\",\n                        type: \"string\",\n                        demandOption: true,\n                    })\n                    .option(\"telemetryFile\", {\n                        describe: \"Config and session data for telemetry\",\n                        type: \"string\",\n                        demandOption: true,\n                    }),\n            // eslint-disable-next-line @typescript-eslint/no-misused-promises\n            async (argv) => {\n                if (fs.existsSync(argv.telemetryFile)) {\n                    console.error(`Telemetry file already exists [${argv.telemetryFile}]`);\n                    process.exit(1);\n                }\n\n                const fileLogger = new FileLogger(argv.telemetryFile);\n\n                const logger = ChildLogger.create(fileLogger, \"LocalSnapshotRunnerApp\",\n                    { all: { Event_Time: () => Date.now() } });\n\n                const result = await exportFile(\n                    argv.codeLoader,\n                    argv.inputFile,\n                    argv.outputFolder,\n                    argv.scenario,\n                    logger,\n                );\n\n                if (!result.success) {\n                    console.error(`${result.eventName}: ${result.errorMessage}`);\n                    logger.sendErrorEvent({ eventName: result.eventName, message: result.errorMessage }, result.error);\n                    await fileLogger.flush();\n                    process.exit(1);\n                } else {\n                    await fileLogger.flush();\n                }\n            },\n        )\n        .help()\n        .demandCommand().argv;\n}\n\nfluidRunner();\n"]}
+{"version":3,"file":"fluidRunner.js","sourceRoot":"","sources":["../src/fluidRunner.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;AAEH,6CAA+B;AAC/B,6CAA+D;AAE/D,yEAAsE;AAEtE;;GAEG;AACH,SAAgB,WAAW,CAAC,kBAAwC;IAChE,oEAAoE;IACpE,KAAK;SACA,MAAM,EAAE;SACR,OAAO,CAAC,KAAK,CAAC;SACd,OAAO,CACJ,YAAY,EACZ,8CAA8C;IAC9C,wDAAwD;IACxD,CAAC,KAAK,EAAE,EAAE,CACN,KAAK;SACA,MAAM,CAAC,YAAY,EAAE;QAClB,mCAAmC;QACnC,QAAQ,EAAE,qIAAqI;QAC/I,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,KAAK;KACtB,CAAC;SACD,MAAM,CAAC,WAAW,EAAE;QACjB,QAAQ,EAAE,6BAA6B;QACvC,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACrB,CAAC;SACD,MAAM,CAAC,YAAY,EAAE;QAClB,QAAQ,EAAE,oFAAoF;QAC9F,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACrB,CAAC;SACD,MAAM,CAAC,eAAe,EAAE;QACrB,QAAQ,EAAE,2EAA2E;QACrF,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACrB,CAAC;SACD,MAAM,CAAC,SAAS,EAAE;QACf,QAAQ,EAAE,qDAAqD;QAC/D,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,KAAK;KACtB,CAAC;IACV,kEAAkE;IAClE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;QAC5E,IAAI,SAAS,EAAE;YACX,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACnB;QAED,IAAI,MAA2B,CAAC;QAChC,IAAI,IAAI,CAAC,UAAU,EAAE;YACjB,MAAM,GAAG,MAAM,IAAA,mDAAwB,EACnC,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,OAAO,CACf,CAAC;SACL;aAAM;YACH,MAAM,GAAG,MAAM,IAAA,uBAAU,EACrB,kBAAmB,EACnB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,OAAO,CACf,CAAC;SACL;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;YACjB,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACnB;IACL,CAAC,CACJ;SACA,IAAI,EAAE;SACN,aAAa,EAAE,CAAC,IAAI,CAAC;AAC9B,CAAC;AAxED,kCAwEC;AAED,SAAS,oBAAoB,CACzB,UAAmB,EACnB,kBAAwC;IAExC,IAAI,UAAU,KAAK,SAAS,IAAI,kBAAkB,KAAK,SAAS,EAAE;QAC9D,OAAO,wGAAwG,CAAC;KACnH;IACD,IAAI,UAAU,KAAK,SAAS,IAAI,kBAAkB,KAAK,SAAS,EAAE;QAC9D,mCAAmC;QACnC,OAAO,qHAAqH,CAAC;KAChI;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,WAAW,EAAE,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport * as yargs from \"yargs\";\nimport { exportFile, IExportFileResponse } from \"./exportFile\";\nimport { IFluidFileConverter } from \"./codeLoaderBundle\";\nimport { parseBundleAndExportFile } from \"./parseBundleAndExportFile\";\n\n/**\n * @param fluidFileConverter - needs to be provided if \"codeLoaderBundle\" is not and vice versa\n */\nexport function fluidRunner(fluidFileConverter?: IFluidFileConverter) {\n    // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n    yargs\n        .strict()\n        .version(false)\n        .command(\n            \"exportFile\",\n            \"Generate an output for a local ODSP snapshot\",\n            // eslint-disable-next-line @typescript-eslint/no-shadow\n            (yargs) =>\n                yargs\n                    .option(\"codeLoader\", {\n                        // eslint-disable-next-line max-len\n                        describe: \"Path to code loader bundle. Required if this application is being called without modification.\\nSee \\\"README.md\\\" for more details.\",\n                        type: \"string\",\n                        demandOption: false,\n                    })\n                    .option(\"inputFile\", {\n                        describe: \"Path to local ODSP snapshot\",\n                        type: \"string\",\n                        demandOption: true,\n                    })\n                    .option(\"outputFile\", {\n                        describe: \"Path of output file (cannot already exist).\\nExecution result will be written here\",\n                        type: \"string\",\n                        demandOption: true,\n                    })\n                    .option(\"telemetryFile\", {\n                        describe: \"Path of telemetry file for config and session data (cannot already exist)\",\n                        type: \"string\",\n                        demandOption: true,\n                    })\n                    .option(\"options\", {\n                        describe: \"Additional options passed to container on execution\",\n                        type: \"string\",\n                        demandOption: false,\n                    }),\n            // eslint-disable-next-line @typescript-eslint/no-misused-promises\n            async (argv) => {\n                const argsError = validateProvidedArgs(argv.codeLoader, fluidFileConverter);\n                if (argsError) {\n                    console.error(argsError);\n                    process.exit(1);\n                }\n\n                let result: IExportFileResponse;\n                if (argv.codeLoader) {\n                    result = await parseBundleAndExportFile(\n                        argv.codeLoader,\n                        argv.inputFile,\n                        argv.outputFile,\n                        argv.telemetryFile,\n                        argv.options,\n                    );\n                } else {\n                    result = await exportFile(\n                        fluidFileConverter!,\n                        argv.inputFile,\n                        argv.outputFile,\n                        argv.telemetryFile,\n                        argv.options,\n                    );\n                }\n\n                if (!result.success) {\n                    console.error(`${result.eventName}: ${result.errorMessage}`);\n                    process.exit(1);\n                }\n            },\n        )\n        .help()\n        .demandCommand().argv;\n}\n\nfunction validateProvidedArgs(\n    codeLoader?: string,\n    fluidFileConverter?: IFluidFileConverter,\n): string | undefined {\n    if (codeLoader !== undefined && fluidFileConverter !== undefined) {\n        return \"\\\"codeLoader\\\" and \\\"fluidFileConverter\\\" cannot both be provided. See \\\"fluidRunner.ts\\\" for details.\";\n    }\n    if (codeLoader === undefined && fluidFileConverter === undefined) {\n        // eslint-disable-next-line max-len\n        return \"\\\"codeLoader\\\" must be provided if there is no explicit \\\"fluidFileConverter\\\". See \\\"fluidRunner.ts\\\" for details.\";\n    }\n    return undefined;\n}\n\nfluidRunner();\n"]}

package/dist/getArgsValidationError.d.ts

@@ -2,5 +2,5 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export declare function getArgsValidationError(inputFile: string, outputFolder: string, scenario: string): string | undefined;
+export declare function getArgsValidationError(inputFile: string, outputFile: string): string | undefined;
 //# sourceMappingURL=getArgsValidationError.d.ts.map

package/dist/getArgsValidationError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getArgsValidationError.d.ts","sourceRoot":"","sources":["../src/getArgsValidationError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,sBAAsB,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAsBpB"}
+{"version":3,"file":"getArgsValidationError.d.ts","sourceRoot":"","sources":["../src/getArgsValidationError.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,sBAAsB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAiBpB"}

package/dist/getArgsValidationError.js

@@ -25,25 +25,21 @@ var __importStar = (this && this.__importStar) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getArgsValidationError = void 0;
 const fs = __importStar(require("fs"));
-function getArgsValidationError(inputFile, outputFolder, scenario) {
+function getArgsValidationError(inputFile, outputFile) {
     // Validate input file
     if (!inputFile) {
         // TODO: Do not log file name. It can be customer content
-        return "Input file name is missing.";
+        return "Input file name argument is missing.";
     }
     else if (!fs.existsSync(inputFile)) {
         return "Input file does not exist.";
     }
     // Validate output file
-    if (!outputFolder) {
-        return "Output folder name is missing.";
+    if (!outputFile) {
+        return "Output file argument is missing.";
     }
-    else if (!fs.existsSync(outputFolder)) {
-        return "Output folder does not exist.";
-    }
-    // Validate scenario name
-    if (!scenario) {
-        return "Scenario name is missing.";
+    else if (fs.existsSync(outputFile)) {
+        return `Output file already exists [${outputFile}].`;
     }
     return undefined;
 }

package/dist/getArgsValidationError.js.map

@@ -1 +1 @@
-{"version":3,"file":"getArgsValidationError.js","sourceRoot":"","sources":["../src/getArgsValidationError.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AAEzB,SAAgB,sBAAsB,CAClC,SAAiB,EACjB,YAAoB,EACpB,QAAgB;IAEhB,sBAAsB;IACtB,IAAI,CAAC,SAAS,EAAE;QACZ,yDAAyD;QACzD,OAAO,6BAA6B,CAAC;KACxC;SAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QAClC,OAAO,4BAA4B,CAAC;KACvC;IAED,uBAAuB;IACvB,IAAI,CAAC,YAAY,EAAE;QACf,OAAO,gCAAgC,CAAC;KAC3C;SAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE;QACrC,OAAO,+BAA+B,CAAC;KAC1C;IAED,yBAAyB;IACzB,IAAI,CAAC,QAAQ,EAAE;QACX,OAAO,2BAA2B,CAAC;KACtC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AA1BD,wDA0BC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport * as fs from \"fs\";\n\nexport function getArgsValidationError(\n    inputFile: string,\n    outputFolder: string,\n    scenario: string,\n): string | undefined {\n    // Validate input file\n    if (!inputFile) {\n        // TODO: Do not log file name. It can be customer content\n        return \"Input file name is missing.\";\n    } else if (!fs.existsSync(inputFile)) {\n        return \"Input file does not exist.\";\n    }\n\n    // Validate output file\n    if (!outputFolder) {\n        return \"Output folder name is missing.\";\n    } else if (!fs.existsSync(outputFolder)) {\n        return \"Output folder does not exist.\";\n    }\n\n    // Validate scenario name\n    if (!scenario) {\n        return \"Scenario name is missing.\";\n    }\n\n    return undefined;\n}\n"]}
+{"version":3,"file":"getArgsValidationError.js","sourceRoot":"","sources":["../src/getArgsValidationError.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AAEzB,SAAgB,sBAAsB,CAClC,SAAiB,EACjB,UAAkB;IAElB,sBAAsB;IACtB,IAAI,CAAC,SAAS,EAAE;QACZ,yDAAyD;QACzD,OAAO,sCAAsC,CAAC;KACjD;SAAM,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;QAClC,OAAO,4BAA4B,CAAC;KACvC;IAED,uBAAuB;IACvB,IAAI,CAAC,UAAU,EAAE;QACb,OAAO,kCAAkC,CAAC;KAC7C;SAAM,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;QAClC,OAAO,+BAA+B,UAAU,IAAI,CAAC;KACxD;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AApBD,wDAoBC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport * as fs from \"fs\";\n\nexport function getArgsValidationError(\n    inputFile: string,\n    outputFile: string,\n): string | undefined {\n    // Validate input file\n    if (!inputFile) {\n        // TODO: Do not log file name. It can be customer content\n        return \"Input file name argument is missing.\";\n    } else if (!fs.existsSync(inputFile)) {\n        return \"Input file does not exist.\";\n    }\n\n    // Validate output file\n    if (!outputFile) {\n        return \"Output file argument is missing.\";\n    } else if (fs.existsSync(outputFile)) {\n        return `Output file already exists [${outputFile}].`;\n    }\n\n    return undefined;\n}\n"]}

package/dist/index.d.ts

@@ -2,6 +2,9 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-export * from "./codeLoaderBundle";
+export { ICodeLoaderBundle, IFluidFileConverter } from "./codeLoaderBundle";
 export * from "./exportFile";
+export { fluidRunner } from "./fluidRunner";
+export * from "./logger/FileLogger";
+export * from "./parseBundleAndExportFile";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC"}

package/dist/index.js

@@ -14,6 +14,11 @@ 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("./codeLoaderBundle"), exports);
+exports.fluidRunner = void 0;
 __exportStar(require("./exportFile"), exports);
+var fluidRunner_1 = require("./fluidRunner");
+Object.defineProperty(exports, "fluidRunner", { enumerable: true, get: function () { return fluidRunner_1.fluidRunner; } });
+// eslint-disable-next-line import/no-internal-modules
+__exportStar(require("./logger/FileLogger"), exports);
+__exportStar(require("./parseBundleAndExportFile"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;AAEH,qDAAmC;AACnC,+CAA6B","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport * from \"./codeLoaderBundle\";\nexport * from \"./exportFile\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;AAGH,+CAA6B;AAC7B,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,sDAAsD;AACtD,sDAAoC;AACpC,6DAA2C","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { ICodeLoaderBundle, IFluidFileConverter } from \"./codeLoaderBundle\";\nexport * from \"./exportFile\";\nexport { fluidRunner } from \"./fluidRunner\";\n// eslint-disable-next-line import/no-internal-modules\nexport * from \"./logger/FileLogger\";\nexport * from \"./parseBundleAndExportFile\";\n"]}

package/dist/logger/FileLogger.d.ts

@@ -2,7 +2,7 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
-import { ITelemetryBaseEvent, ITelemetryBaseLogger } from "@fluidframework/common-definitions";
+import { ITelemetryBaseEvent, ITelemetryBaseLogger, ITelemetryLogger } from "@fluidframework/common-definitions";
 /**
  * Logger that writes events into a defined file
  */
@@ -20,4 +20,14 @@ export declare class FileLogger implements ITelemetryBaseLogger {
     flush(): Promise<void>;
     send(event: ITelemetryBaseEvent): void;
 }
+/**
+ * Create a ITelemetryLogger wrapped around provided FileLogger
+ */
+export declare function createLogger(fileLogger: FileLogger): ITelemetryLogger;
+/**
+ * Validate the telemetryFile command line argument
+ * @param telemetryFile - path where telemetry will be written
+ * @returns
+ */
+export declare function getTelemetryFileValidationError(telemetryFile: string): string | undefined;
 //# sourceMappingURL=FileLogger.d.ts.map

package/dist/logger/FileLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileLogger.d.ts","sourceRoot":"","sources":["../../src/logger/FileLogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/F;;GAEG;AACH,qBAAa,UAAW,YAAW,oBAAoB;IAW/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAX5B,YAAY,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAEvC,0CAA0C;IAC1C,OAAO,CAAC,MAAM,CAAgB;IAE9B;;;OAGG;gBAEkB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,MAAW;IAGnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;CAUhD"}
+{"version":3,"file":"FileLogger.d.ts","sourceRoot":"","sources":["../../src/logger/FileLogger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGjH;;GAEG;AACH,qBAAa,UAAW,YAAW,oBAAoB;IAW/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAX5B,YAAY,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAEvC,0CAA0C;IAC1C,OAAO,CAAC,MAAM,CAAgB;IAE9B;;;OAGG;gBAEkB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,MAAW;IAGnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;CAUhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,gBAAgB,CAGrE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQzF"}

package/dist/logger/FileLogger.js

@@ -23,8 +23,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileLogger = void 0;
+exports.getTelemetryFileValidationError = exports.createLogger = exports.FileLogger = void 0;
 const fs = __importStar(require("fs"));
+const telemetry_utils_1 = require("@fluidframework/telemetry-utils");
 /**
  * Logger that writes events into a defined file
  */
@@ -55,4 +56,26 @@ class FileLogger {
     }
 }
 exports.FileLogger = FileLogger;
+/**
+ * Create a ITelemetryLogger wrapped around provided FileLogger
+ */
+function createLogger(fileLogger) {
+    return telemetry_utils_1.ChildLogger.create(fileLogger, "LocalSnapshotRunnerApp", { all: { Event_Time: () => Date.now() } });
+}
+exports.createLogger = createLogger;
+/**
+ * Validate the telemetryFile command line argument
+ * @param telemetryFile - path where telemetry will be written
+ * @returns
+ */
+function getTelemetryFileValidationError(telemetryFile) {
+    if (!telemetryFile) {
+        return "Telemetry file argument is missing.";
+    }
+    else if (fs.existsSync(telemetryFile)) {
+        return `Telemetry file already exists [${telemetryFile}].`;
+    }
+    return undefined;
+}
+exports.getTelemetryFileValidationError = getTelemetryFileValidationError;
 //# sourceMappingURL=FileLogger.js.map