@ms-cloudpack/api-server 0.2.0

package/README.md

@@ -0,0 +1,5 @@
+# @ms-cloudpack/api-server
+
+Provides an API server that exposes a pub/sub endpoint for trigger long running tasks.
+
+## Usage

package/lib/TaskRunner.d.ts

@@ -0,0 +1,40 @@
+import type { Task, TaskOptions } from './types.js';
+/**
+ * TaskRunner class manages the state of Tasks.
+ * This class is to be called by the api server.
+ */
+export declare class TaskRunner {
+    private _queue;
+    private _pendingTasks;
+    private _completedTasks;
+    private _requiresRerun;
+    private _prevTasks;
+    constructor();
+    /**
+     * The add method enqueues a Task and returns its Promise.
+     * If a Task with the same id has already been processed,
+     * it returns either the result or the promise.
+     * Rerun flag forces the Task to be run again.
+     */
+    add<TReturn>(task: Task<TReturn>, options?: TaskOptions): Promise<TReturn>;
+    /**
+     * The reset method removes a task from the TaskRunner
+     * and then adds it again through a previous execute function.
+     *
+     * This is useful for when a task needs to be forcibly rerun.
+     *
+     * It is intented to be used by the api server
+     * to rerun a task when it is stuck or it failed.
+     */
+    reset<TReturn>(id: string): Promise<TReturn>;
+    /**
+     * The remove method disposes a task if available
+     * and then removes it from the TaskRunner.
+     *
+     * This is useful when the state of a task needs to be cleared.
+     *
+     * It is intented to be used by the api server
+     * to clear the TaskRunner's state before reloading the page.
+     */
+    remove(id: string): void;
+}

package/lib/TaskRunner.js

@@ -0,0 +1,119 @@
+import PQueue from 'p-queue';
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const log = (...messages) => {
+    // console.log(`TaskRunner:`, ...messages);
+};
+/**
+ * TaskRunner class manages the state of Tasks.
+ * This class is to be called by the api server.
+ */
+export class TaskRunner {
+    constructor() {
+        this._queue = new PQueue({ concurrency: 10 });
+        this._pendingTasks = new Map();
+        this._completedTasks = new Map();
+        this._requiresRerun = new Set();
+        this._prevTasks = new Map();
+    }
+    /**
+     * The add method enqueues a Task and returns its Promise.
+     * If a Task with the same id has already been processed,
+     * it returns either the result or the promise.
+     * Rerun flag forces the Task to be run again.
+     */
+    add(task, options) {
+        const { name, id, execute } = task;
+        const { rerun, watch } = options || {};
+        watch?.();
+        if (!this._prevTasks.get(id)) {
+            this._prevTasks.set(id, task);
+        }
+        // Check if we are already completed the task with that id.
+        const action = this._completedTasks.get(id);
+        if (action !== undefined && !rerun) {
+            log(`Previous action found, returning: "${name}:${id}"`);
+            return Promise.resolve(action);
+        }
+        // Check if we are already running the task with that id.
+        const pending = this._pendingTasks.get(id);
+        if (pending !== undefined) {
+            if (rerun) {
+                this._requiresRerun.add(id);
+            }
+            log(`Previous action found, waiting: "${name}:${id}"`);
+            return pending;
+        }
+        const resultPromise = (async () => {
+            let taskResult;
+            let taskError;
+            let completed = false;
+            do {
+                // Delete from rerun list (if present).
+                this._requiresRerun.delete(id);
+                try {
+                    // TODO: possibly remove cast once this issue is resolved
+                    // https://github.com/sindresorhus/p-queue/issues/175
+                    taskResult = (await this._queue.add(execute));
+                    completed = true;
+                }
+                catch (err) {
+                    // Save the error--it will be thrown later if a rerun was not requested.
+                    taskError = err;
+                }
+            } while (this._requiresRerun.has(id));
+            log(`Task finished: "${name}:${id}"`);
+            // Delete from pending list.
+            this._pendingTasks.delete(id);
+            if (completed) {
+                // Update finished Tasks.
+                this._completedTasks.set(id, taskResult);
+                // Resolve the promise.
+                return taskResult;
+            }
+            // If the task never completed successfully, throw the error from earlier.
+            throw taskError;
+        })();
+        this._pendingTasks.set(id, resultPromise);
+        this._completedTasks.delete(id);
+        return resultPromise;
+    }
+    /**
+     * The reset method removes a task from the TaskRunner
+     * and then adds it again through a previous execute function.
+     *
+     * This is useful for when a task needs to be forcibly rerun.
+     *
+     * It is intented to be used by the api server
+     * to rerun a task when it is stuck or it failed.
+     */
+    reset(id) {
+        this.remove(id);
+        const prevTask = this._prevTasks.get(id);
+        if (prevTask === undefined) {
+            throw new Error(`Task not found: ${id}`);
+        }
+        return this.add(prevTask, { rerun: true });
+    }
+    /**
+     * The remove method disposes a task if available
+     * and then removes it from the TaskRunner.
+     *
+     * This is useful when the state of a task needs to be cleared.
+     *
+     * It is intented to be used by the api server
+     * to clear the TaskRunner's state before reloading the page.
+     */
+    remove(id) {
+        this._prevTasks
+            .get(id)
+            ?.dispose?.()
+            .catch(() => {
+            log(`Error disposing task: ${id}`);
+        });
+        this._prevTasks.get(id)?.clear?.();
+        this._requiresRerun.delete(id);
+        this._pendingTasks.delete(id);
+        this._completedTasks.delete(id);
+    }
+}
+//# sourceMappingURL=TaskRunner.js.map

package/lib/TaskRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskRunner.js","sourceRoot":"","sources":["../src/TaskRunner.ts"],"names":[],"mappings":"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","sourcesContent":["import PQueue from 'p-queue';\nimport type { Task, TaskOptions } from './types.js';\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst log = (...messages: unknown[]) => {\n  // console.log(`TaskRunner:`, ...messages);\n};\n\n/**\n * TaskRunner class manages the state of Tasks.\n * This class is to be called by the api server.\n */\nexport class TaskRunner {\n  private _queue: PQueue;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private _pendingTasks: Map<string, Promise<any>>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private _completedTasks: Map<string, any>;\n  private _requiresRerun: Set<string>;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private _prevTasks: Map<string, Task<any>>;\n\n  constructor() {\n    this._queue = new PQueue({ concurrency: 10 });\n    this._pendingTasks = new Map();\n    this._completedTasks = new Map();\n    this._requiresRerun = new Set();\n    this._prevTasks = new Map();\n  }\n\n  /**\n   * The add method enqueues a Task and returns its Promise.\n   * If a Task with the same id has already been processed,\n   * it returns either the result or the promise.\n   * Rerun flag forces the Task to be run again.\n   */\n  add<TReturn>(task: Task<TReturn>, options?: TaskOptions): Promise<TReturn> {\n    const { name, id, execute } = task;\n    const { rerun, watch } = options || {};\n\n    watch?.();\n\n    if (!this._prevTasks.get(id)) {\n      this._prevTasks.set(id, task);\n    }\n\n    // Check if we are already completed the task with that id.\n    const action = this._completedTasks.get(id) as TReturn | undefined;\n    if (action !== undefined && !rerun) {\n      log(`Previous action found, returning: \"${name}:${id}\"`);\n      return Promise.resolve(action);\n    }\n\n    // Check if we are already running the task with that id.\n    const pending = this._pendingTasks.get(id) as Promise<TReturn> | undefined;\n    if (pending !== undefined) {\n      if (rerun) {\n        this._requiresRerun.add(id);\n      }\n      log(`Previous action found, waiting: \"${name}:${id}\"`);\n      return pending;\n    }\n\n    const resultPromise = (async () => {\n      let taskResult: TReturn | undefined;\n      let taskError: unknown;\n      let completed = false;\n\n      do {\n        // Delete from rerun list (if present).\n        this._requiresRerun.delete(id);\n        try {\n          // TODO: possibly remove cast once this issue is resolved\n          // https://github.com/sindresorhus/p-queue/issues/175\n          taskResult = (await this._queue.add(execute)) as TReturn | undefined;\n          completed = true;\n        } catch (err) {\n          // Save the error--it will be thrown later if a rerun was not requested.\n          taskError = err;\n        }\n      } while (this._requiresRerun.has(id));\n\n      log(`Task finished: \"${name}:${id}\"`);\n\n      // Delete from pending list.\n      this._pendingTasks.delete(id);\n\n      if (completed) {\n        // Update finished Tasks.\n        this._completedTasks.set(id, taskResult);\n        // Resolve the promise.\n        return taskResult as TReturn;\n      }\n\n      // If the task never completed successfully, throw the error from earlier.\n      throw taskError;\n    })();\n\n    this._pendingTasks.set(id, resultPromise);\n    this._completedTasks.delete(id);\n\n    return resultPromise;\n  }\n\n  /**\n   * The reset method removes a task from the TaskRunner\n   * and then adds it again through a previous execute function.\n   *\n   * This is useful for when a task needs to be forcibly rerun.\n   *\n   * It is intented to be used by the api server\n   * to rerun a task when it is stuck or it failed.\n   */\n  reset<TReturn>(id: string): Promise<TReturn> {\n    this.remove(id);\n    const prevTask = this._prevTasks.get(id);\n    if (prevTask === undefined) {\n      throw new Error(`Task not found: ${id}`);\n    }\n    return <Promise<TReturn>>this.add(prevTask, { rerun: true });\n  }\n\n  /**\n   * The remove method disposes a task if available\n   * and then removes it from the TaskRunner.\n   *\n   * This is useful when the state of a task needs to be cleared.\n   *\n   * It is intented to be used by the api server\n   * to clear the TaskRunner's state before reloading the page.\n   */\n  remove(id: string): void {\n    this._prevTasks\n      .get(id)\n      ?.dispose?.()\n      .catch(() => {\n        log(`Error disposing task: ${id}`);\n      });\n    this._prevTasks.get(id)?.clear?.();\n    this._requiresRerun.delete(id);\n    this._pendingTasks.delete(id);\n    this._completedTasks.delete(id);\n  }\n}\n"]}

package/lib/addOverride.d.ts

@@ -0,0 +1,7 @@
+import type { Session } from './types.js';
+export declare function addOverride({ session, packageName, importPath, filename, }: {
+    session: Session;
+    packageName: string;
+    importPath: string;
+    filename?: string;
+}): Promise<void>;

package/lib/addOverride.js

@@ -0,0 +1,63 @@
+import semver from 'semver';
+import { createPackageOverrideTransform } from './common/createPackageOverrideTransform.js';
+import { addExportsMapEntry, findResolveMapEntry, getExportsMap, PackageDefinitions, } from '@ms-cloudpack/package-utilities';
+import { slash } from '@ms-cloudpack/path-string-parsing';
+import { parseRequestInfo } from './parseRequestInfo.js';
+import { readConfig, writeConfig } from '@ms-cloudpack/config';
+export async function addOverride({ session, packageName, importPath, filename, }) {
+    let definition = undefined;
+    if (filename) {
+        const requestPath = slash(new URL(filename).pathname);
+        const { packageName: name, version } = parseRequestInfo(requestPath);
+        definition = { name, version };
+    }
+    const entry = findResolveMapEntry({
+        packageName,
+        resolveMap: session.resolveMap,
+        definition,
+    });
+    if (entry === undefined) {
+        console.error(`Could not find entry of package ${packageName} in resolve map`);
+        return;
+    }
+    const exports = (await getExportsMap(entry.path));
+    await addExportsMapEntry({
+        exports,
+        packagePath: entry.path,
+        importPath,
+    });
+    const packageOverride = {
+        name: packageName,
+        versionRequirement: entry.version,
+        overrides: {
+            exports,
+        },
+    };
+    // Parse config if it exists.
+    const cloudpackConfig = await readConfig(session.appPath);
+    // Add package override to config.
+    if (!cloudpackConfig.packageOverrides) {
+        cloudpackConfig.packageOverrides = [packageOverride];
+    }
+    else {
+        // Check if override already exists.
+        const existingOverride = cloudpackConfig.packageOverrides.find((o) => o.name === packageOverride.name && semver.satisfies(packageOverride.versionRequirement, o.versionRequirement));
+        if (existingOverride) {
+            // Update existing override.
+            existingOverride.overrides = packageOverride.overrides;
+        }
+        else {
+            // Add new override.
+            cloudpackConfig.packageOverrides.push(packageOverride);
+        }
+    }
+    // Write config.
+    await writeConfig(cloudpackConfig, session.appPath);
+    console.debug(`Added override for ${packageName} to cloudpack config`);
+    const override = {
+        packageOverrides: [packageOverride],
+    };
+    // Initialize package overrides.
+    PackageDefinitions.getInstance().registerTransform(createPackageOverrideTransform(override));
+}
+//# sourceMappingURL=addOverride.js.map

package/lib/addOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addOverride.js","sourceRoot":"","sources":["../src/addOverride.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,GACnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAChC,OAAO,EACP,WAAW,EACX,UAAU,EACV,QAAQ,GAMT;IACC,IAAI,UAAU,GAAG,SAAS,CAAC;IAE3B,IAAI,QAAQ,EAAE;QACZ,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACrE,UAAU,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAChC;IAED,MAAM,KAAK,GAAG,mBAAmB,CAAC;QAChC,WAAW;QACX,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU;KACX,CAAC,CAAC;IAEH,IAAI,KAAK,KAAK,SAAS,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,mCAAmC,WAAW,iBAAiB,CAAC,CAAC;QAC/E,OAAO;KACR;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAA2C,CAAC;IAE5F,MAAM,kBAAkB,CAAC;QACvB,OAAO;QACP,WAAW,EAAE,KAAK,CAAC,IAAI;QACvB,UAAU;KACX,CAAC,CAAC;IAEH,MAAM,eAAe,GAAoB;QACvC,IAAI,EAAE,WAAW;QACjB,kBAAkB,EAAE,KAAK,CAAC,OAAO;QACjC,SAAS,EAAE;YACT,OAAO;SACR;KACF,CAAC;IAEF,6BAA6B;IAC7B,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1D,kCAAkC;IAClC,IAAI,CAAC,eAAe,CAAC,gBAAgB,EAAE;QACrC,eAAe,CAAC,gBAAgB,GAAG,CAAC,eAAe,CAAC,CAAC;KACtD;SAAM;QACL,oCAAoC;QACpC,MAAM,gBAAgB,GAAG,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAC5D,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,IAAI,IAAI,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,kBAAkB,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAChH,CAAC;QAEF,IAAI,gBAAgB,EAAE;YACpB,4BAA4B;YAC5B,gBAAgB,CAAC,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC;SACxD;aAAM;YACL,oBAAoB;YACpB,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;SACxD;KACF;IAED,gBAAgB;IAChB,MAAM,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,CAAC,KAAK,CAAC,sBAAsB,WAAW,sBAAsB,CAAC,CAAC;IAEvE,MAAM,QAAQ,GAAoB;QAChC,gBAAgB,EAAE,CAAC,eAAe,CAAC;KACpC,CAAC;IAEF,gCAAgC;IAChC,kBAAkB,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC,8BAA8B,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/F,CAAC","sourcesContent":["import semver from 'semver';\nimport { createPackageOverrideTransform } from './common/createPackageOverrideTransform.js';\nimport {\n  addExportsMapEntry,\n  findResolveMapEntry,\n  getExportsMap,\n  PackageDefinitions,\n} from '@ms-cloudpack/package-utilities';\nimport type { CloudpackConfig, Session, PackageOverride } from './types.js';\nimport { slash } from '@ms-cloudpack/path-string-parsing';\nimport { parseRequestInfo } from './parseRequestInfo.js';\nimport { readConfig, writeConfig } from '@ms-cloudpack/config';\n\nexport async function addOverride({\n  session,\n  packageName,\n  importPath,\n  filename,\n}: {\n  session: Session;\n  packageName: string;\n  importPath: string;\n  filename?: string;\n}) {\n  let definition = undefined;\n\n  if (filename) {\n    const requestPath = slash(new URL(filename).pathname);\n    const { packageName: name, version } = parseRequestInfo(requestPath);\n    definition = { name, version };\n  }\n\n  const entry = findResolveMapEntry({\n    packageName,\n    resolveMap: session.resolveMap,\n    definition,\n  });\n\n  if (entry === undefined) {\n    console.error(`Could not find entry of package ${packageName} in resolve map`);\n    return;\n  }\n\n  const exports = (await getExportsMap(entry.path)) as Record<string, Record<string, string>>;\n\n  await addExportsMapEntry({\n    exports,\n    packagePath: entry.path,\n    importPath,\n  });\n\n  const packageOverride: PackageOverride = {\n    name: packageName,\n    versionRequirement: entry.version,\n    overrides: {\n      exports,\n    },\n  };\n\n  // Parse config if it exists.\n  const cloudpackConfig = await readConfig(session.appPath);\n\n  // Add package override to config.\n  if (!cloudpackConfig.packageOverrides) {\n    cloudpackConfig.packageOverrides = [packageOverride];\n  } else {\n    // Check if override already exists.\n    const existingOverride = cloudpackConfig.packageOverrides.find(\n      (o) =>\n        o.name === packageOverride.name && semver.satisfies(packageOverride.versionRequirement, o.versionRequirement),\n    );\n\n    if (existingOverride) {\n      // Update existing override.\n      existingOverride.overrides = packageOverride.overrides;\n    } else {\n      // Add new override.\n      cloudpackConfig.packageOverrides.push(packageOverride);\n    }\n  }\n\n  // Write config.\n  await writeConfig(cloudpackConfig, session.appPath);\n  console.debug(`Added override for ${packageName} to cloudpack config`);\n\n  const override: CloudpackConfig = {\n    packageOverrides: [packageOverride],\n  };\n\n  // Initialize package overrides.\n  PackageDefinitions.getInstance().registerTransform(createPackageOverrideTransform(override));\n}\n"]}

package/lib/common/createPackageOverrideTransform.d.ts

@@ -0,0 +1,6 @@
+import type { CloudpackConfig } from '../types.js';
+import type { PackageDefinitionTransform } from '@ms-cloudpack/bundler-types';
+/**
+ * Creates a transform to be registered with a PackageDefinitions registry for overriding package.json definitions.
+ */
+export declare function createPackageOverrideTransform(config: CloudpackConfig): PackageDefinitionTransform;

package/lib/common/createPackageOverrideTransform.js

@@ -0,0 +1,19 @@
+import { findPackageOverride } from './findPackageOverride.js';
+/**
+ * Creates a transform to be registered with a PackageDefinitions registry for overriding package.json definitions.
+ */
+export function createPackageOverrideTransform(config) {
+    const { packageOverrides = [] } = config;
+    return (packageDefinition) => {
+        const { name = '', version = '' } = packageDefinition;
+        const packageOverride = findPackageOverride(packageOverrides, name, version);
+        if (packageOverride) {
+            return {
+                ...packageDefinition,
+                ...packageOverride.overrides,
+            };
+        }
+        return undefined;
+    };
+}
+//# sourceMappingURL=createPackageOverrideTransform.js.map

package/lib/common/createPackageOverrideTransform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPackageOverrideTransform.js","sourceRoot":"","sources":["../../src/common/createPackageOverrideTransform.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAuB;IACpE,MAAM,EAAE,gBAAgB,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAEzC,OAAO,CAAC,iBAA8B,EAAE,EAAE;QACxC,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,iBAAiB,CAAC;QACtD,MAAM,eAAe,GAAG,mBAAmB,CAAC,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAE7E,IAAI,eAAe,EAAE;YACnB,OAAO;gBACL,GAAG,iBAAiB;gBACpB,GAAG,eAAe,CAAC,SAAS;aAC7B,CAAC;SACH;QAED,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { CloudpackConfig } from '../types.js';\nimport type { PackageJson, PackageDefinitionTransform } from '@ms-cloudpack/bundler-types';\nimport { findPackageOverride } from './findPackageOverride.js';\n\n/**\n * Creates a transform to be registered with a PackageDefinitions registry for overriding package.json definitions.\n */\nexport function createPackageOverrideTransform(config: CloudpackConfig): PackageDefinitionTransform {\n  const { packageOverrides = [] } = config;\n\n  return (packageDefinition: PackageJson) => {\n    const { name = '', version = '' } = packageDefinition;\n    const packageOverride = findPackageOverride(packageOverrides, name, version);\n\n    if (packageOverride) {\n      return {\n        ...packageDefinition,\n        ...packageOverride.overrides,\n      };\n    }\n\n    return undefined;\n  };\n}\n"]}

package/lib/common/findPackageOverride.d.ts

@@ -0,0 +1,5 @@
+import type { PackageOverride } from '../types.js';
+/**
+ * Given a set of package overrides, finds the overrides for the given package name and version.
+ */
+export declare function findPackageOverride(packageOverrides: PackageOverride[], packageName: string, packageVersion: string): PackageOverride | undefined;

package/lib/common/findPackageOverride.js

@@ -0,0 +1,8 @@
+import semver from 'semver';
+/**
+ * Given a set of package overrides, finds the overrides for the given package name and version.
+ */
+export function findPackageOverride(packageOverrides, packageName, packageVersion) {
+    return packageOverrides.find((override) => override.name === packageName && semver.satisfies(packageVersion, override.versionRequirement));
+}
+//# sourceMappingURL=findPackageOverride.js.map

package/lib/common/findPackageOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPackageOverride.js","sourceRoot":"","sources":["../../src/common/findPackageOverride.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,gBAAmC,EACnC,WAAmB,EACnB,cAAsB;IAEtB,OAAO,gBAAgB,CAAC,IAAI,CAC1B,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAC7G,CAAC;AACJ,CAAC","sourcesContent":["import semver from 'semver';\nimport type { PackageOverride } from '../types.js';\n\n/**\n * Given a set of package overrides, finds the overrides for the given package name and version.\n */\nexport function findPackageOverride(\n  packageOverrides: PackageOverride[],\n  packageName: string,\n  packageVersion: string,\n): PackageOverride | undefined {\n  return packageOverrides.find(\n    (override) => override.name === packageName && semver.satisfies(packageVersion, override.versionRequirement),\n  );\n}\n"]}

package/lib/common/getCachePath.d.ts

@@ -0,0 +1,2 @@
+export declare function getCachePath(): string;
+export declare function getLocalCachePath(appPath?: string): string;

package/lib/common/getCachePath.js

@@ -0,0 +1,9 @@
+import os from 'os';
+import path from 'path';
+export function getCachePath() {
+    return path.join(os.homedir(), '.cloudpack');
+}
+export function getLocalCachePath(appPath) {
+    return path.join(appPath ?? process.cwd(), 'node_modules', '.cache', 'cloudpack');
+}
+//# sourceMappingURL=getCachePath.js.map

package/lib/common/getCachePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCachePath.js","sourceRoot":"","sources":["../../src/common/getCachePath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AACpF,CAAC","sourcesContent":["import os from 'os';\nimport path from 'path';\n\nexport function getCachePath() {\n  return path.join(os.homedir(), '.cloudpack');\n}\n\nexport function getLocalCachePath(appPath?: string) {\n  return path.join(appPath ?? process.cwd(), 'node_modules', '.cache', 'cloudpack');\n}\n"]}

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { startApiServer } from './startApiServer.js';
+export type { ApiServer, CloudpackConfig, DevServer, PackageOverride, Route, Session, SessionStats, Task, TaskDescription, TaskEndDescription, TaskError, TaskOptions, TaskStartDescription, } from './types.js';

package/lib/index.js

@@ -0,0 +1,2 @@
+export { startApiServer } from './startApiServer.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export { startApiServer } from './startApiServer.js';\n\nexport type {\n  ApiServer,\n  CloudpackConfig,\n  DevServer,\n  PackageOverride,\n  Route,\n  Session,\n  SessionStats,\n  Task,\n  TaskDescription,\n  TaskEndDescription,\n  TaskError,\n  TaskOptions,\n  TaskStartDescription,\n} from './types.js';\n"]}

package/lib/parseRequestInfo.d.ts

@@ -0,0 +1,6 @@
+export declare function parseRequestInfo(requestPath: string): {
+    packageName: string;
+    version: string;
+    bundled: boolean;
+    filePath: string;
+};

package/lib/parseRequestInfo.js

@@ -0,0 +1,14 @@
+export function parseRequestInfo(requestPath) {
+    const matches = requestPath.match(/[/]?(@[-_a-z-A-Z0-9.]+\/[-_a-z-A-Z0-9.]+|[a-zA-Z-0-9.]+)(@([-_a-zA-Z-0-9.]+))?(\/v([0-9.]+))?(\/(bundled|unbundled))?(\/[-_/a-zA-Z0-9.+]+)?/) || [];
+    const packageName = matches[1] || '';
+    const version = matches[3] || '';
+    const bundled = (matches.length > 8 && matches[7]) === 'bundled';
+    const filePath = (matches.length > 8 && matches[8]) || '';
+    return {
+        packageName,
+        version,
+        bundled,
+        filePath,
+    };
+}
+//# sourceMappingURL=parseRequestInfo.js.map

package/lib/parseRequestInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseRequestInfo.js","sourceRoot":"","sources":["../src/parseRequestInfo.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,MAAM,OAAO,GACX,WAAW,CAAC,KAAK,CACf,6IAA6I,CAC9I,IAAI,EAAE,CAAC;IAEV,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IACjE,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAE1D,OAAO;QACL,WAAW;QACX,OAAO;QACP,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC","sourcesContent":["export function parseRequestInfo(requestPath: string) {\n  const matches =\n    requestPath.match(\n      /[/]?(@[-_a-z-A-Z0-9.]+\\/[-_a-z-A-Z0-9.]+|[a-zA-Z-0-9.]+)(@([-_a-zA-Z-0-9.]+))?(\\/v([0-9.]+))?(\\/(bundled|unbundled))?(\\/[-_/a-zA-Z0-9.+]+)?/,\n    ) || [];\n\n  const packageName = matches[1] || '';\n  const version = matches[3] || '';\n  const bundled = (matches.length > 8 && matches[7]) === 'bundled';\n  const filePath = (matches.length > 8 && matches[8]) || '';\n\n  return {\n    packageName,\n    version,\n    bundled,\n    filePath,\n  };\n}\n"]}

package/lib/startApiServer.d.ts

@@ -0,0 +1,21 @@
+import type { ApiServer, CloudpackConfig, Session } from './types.js';
+import type { Span } from '@ms-cloudpack/telemetry';
+/**
+ * The api server handles the data pub/sub (for things like reporting build status)
+ * and hosting the dashboard verb backend (for executing actions like loading vscode,
+ * changing dependencies, connecting new projects to the running session, etc.)
+ *
+ * Each time `cloudpack start` is run, an api server will start up for that session. The
+ * hosted web page will have a "cloudpack-api-server" header which points
+ * to the websocket server.
+ *
+ * The bundle server will call the api server to publish build status updates.
+ *
+ * The app server will burn the api server url on the host html, so that client-side
+ * javascript can connect and subscribe to page changes.
+ */
+export declare function startApiServer({ session, config, rootSpan, }: {
+    session: Session;
+    config: CloudpackConfig;
+    rootSpan: Span | undefined;
+}): Promise<ApiServer>;

package/lib/startApiServer.js

@@ -0,0 +1,301 @@
+import os from 'os';
+import getPort from 'get-port';
+import path from 'path';
+import http from 'http';
+import https from 'https';
+import WebSocket, { WebSocketServer } from 'ws';
+import { createDataBus } from '@ms-cloudpack/data-bus';
+import { execSync } from 'child_process';
+import { TaskRunner } from './TaskRunner.js';
+import { getCachePath } from './common/getCachePath.js';
+import fsExtra from 'fs-extra';
+import fs from 'fs';
+import { startWatcher } from './startWatcher.js';
+import { PackageDefinitions } from '@ms-cloudpack/package-utilities';
+import { createPackageOverrideTransform } from './common/createPackageOverrideTransform.js';
+import { configTemplate, getConfigPath, readConfigSync, writeConfigSync } from '@ms-cloudpack/config';
+import { addOverride } from './addOverride.js';
+import { validateOverride } from './validateOverride.js';
+import { parseHttpsConfig } from '@ms-cloudpack/create-express-app';
+/**
+ * The api server handles the data pub/sub (for things like reporting build status)
+ * and hosting the dashboard verb backend (for executing actions like loading vscode,
+ * changing dependencies, connecting new projects to the running session, etc.)
+ *
+ * Each time `cloudpack start` is run, an api server will start up for that session. The
+ * hosted web page will have a "cloudpack-api-server" header which points
+ * to the websocket server.
+ *
+ * The bundle server will call the api server to publish build status updates.
+ *
+ * The app server will burn the api server url on the host html, so that client-side
+ * javascript can connect and subscribe to page changes.
+ */
+export async function startApiServer({ session, config, rootSpan, }) {
+    const host = config?.devServer?.domain || 'localhost';
+    const port = await getPort({ port: [9890, 9891, 9892, 9893] });
+    const bus = createDataBus();
+    const sessionStats = {
+        status: 'idle',
+        remainingTasks: 0,
+        totalTasks: 0,
+        totalErrors: 0,
+        totalWarnings: 0,
+    };
+    const allTasks = new Map();
+    const taskRunner = new TaskRunner();
+    function reportStart(taskStart) {
+        const previousResult = allTasks.get(taskStart.id);
+        const now = new Date().getTime();
+        if (!previousResult) {
+            sessionStats.totalTasks++;
+        }
+        if (previousResult?.status === 'complete') {
+            sessionStats.totalErrors -= previousResult.errors?.length || 0;
+            sessionStats.totalWarnings -= previousResult.warnings?.length || 0;
+        }
+        sessionStats.remainingTasks++;
+        sessionStats.status = 'pending';
+        allTasks.set(taskStart.id, {
+            ...taskStart,
+            status: 'pending',
+            startTime: now,
+        });
+        bus.publish([session.id, 'status'], sessionStats);
+        bus.publish([session.id, 'status-details'], { tasks: Array.from(allTasks.values()) });
+    }
+    function reportEnd(taskEnd) {
+        const previousResult = allTasks.get(taskEnd.id);
+        const now = new Date().getTime();
+        if (previousResult) {
+            sessionStats.remainingTasks--;
+            sessionStats.totalErrors += taskEnd.errors?.length || 0;
+            sessionStats.totalWarnings += taskEnd.warnings?.length || 0;
+            allTasks.set(taskEnd.id, {
+                ...previousResult,
+                ...taskEnd,
+                status: 'complete',
+                durationMilliseconds: now - previousResult.startTime,
+                lastUpdated: now,
+            });
+            if (sessionStats.remainingTasks === 0) {
+                sessionStats.status = 'idle';
+            }
+            bus.publish([session.id, 'status'], sessionStats);
+            bus.publish([session.id, 'status-details'], { tasks: Array.from(allTasks.values()) });
+        }
+    }
+    bus.publish([session.id, 'status'], sessionStats);
+    const addTask = (task, options) => {
+        if (task.watch) {
+            options = options || {};
+            options.watch = () => {
+                watcher.watch(task, { onSuccess: notifyReload });
+            };
+        }
+        return taskRunner.add({
+            ...task,
+            execute: async () => {
+                reportStart({
+                    ...task.getStartDescription?.(),
+                    id: task.id,
+                });
+                let taskResult;
+                try {
+                    taskResult = await task.execute();
+                }
+                catch (err) {
+                    // no-op
+                }
+                reportEnd({
+                    ...task.getEndDescription?.(taskResult),
+                    id: task.id,
+                });
+                return taskResult;
+            },
+        }, options);
+    };
+    const watcher = startWatcher(addTask);
+    // Create a node http(s) server.
+    let server;
+    const httpsConfig = config?.devServer?.https;
+    const protocol = httpsConfig ? 'wss' : 'ws';
+    if (httpsConfig) {
+        const { key, cert, passphrase } = parseHttpsConfig(httpsConfig);
+        if (!key || !cert) {
+            console.error('Invalid https config in cloudpack.config.js. Make sure key and cert are valid.');
+            throw new Error('Invalid https config.');
+        }
+        server = https
+            .createServer({
+            key,
+            cert,
+            passphrase,
+        }, () => {
+            /* no-op */
+        })
+            .listen(port, host);
+    }
+    else {
+        server = http.createServer().listen(port, host);
+    }
+    // Create a websocket server which listens for subscriptions and verb requests,
+    // and broadcasts the data to all connected clients.
+    const socketServer = new WebSocketServer({ server }, () => {
+        // console.log(`ApiServer: Started on port ${port}`);
+    }).on('connection', (socket) => {
+        const disposables = new Map();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        function sendMessage(message) {
+            socket.send(JSON.stringify(message, null, 2));
+        }
+        socket.send(JSON.stringify({
+            type: 'sequence',
+            sequence: session.sequence,
+        }));
+        socket
+            .on('message', (rawData) => {
+            try {
+                const request = JSON.parse(rawData.toString());
+                switch (request.type) {
+                    case 'subscribe': {
+                        const { path: subscriptionPath, id } = request.data;
+                        disposables.set(id, bus.subscribe(subscriptionPath, 
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment
+                        (data) => sendMessage({ type: 'notify', id, path: subscriptionPath, data })));
+                        break;
+                    }
+                    case 'unsubscribe': {
+                        const id = request.data.id;
+                        if (id) {
+                            const dispose = disposables.get(id);
+                            if (dispose) {
+                                dispose();
+                                disposables.delete(id);
+                            }
+                        }
+                        break;
+                    }
+                    case 'openSource': {
+                        const { rootPath, relativePath = '', line, column } = request.data;
+                        const fullPath = path.join(rootPath, relativePath);
+                        console.log(`Opening VSCode with path: ${fullPath}`);
+                        execSync(`code --goto ${fullPath}:${line}:${column}`, { cwd: process.cwd() });
+                        break;
+                    }
+                    case 'open': {
+                        const { rootPath, relativePath = '' } = request.data;
+                        const fullPath = path.join(rootPath, relativePath);
+                        console.log(`Opening path: ${fullPath}`);
+                        const openCommand = os.platform() == 'win32' ? 'start' : 'open';
+                        execSync(`${openCommand} ${fullPath}`, { cwd: process.cwd() });
+                        break;
+                    }
+                    case 'editConfig': {
+                        const fullPath = path.resolve(getConfigPath());
+                        // Check if file exists
+                        if (!fs.existsSync(fullPath)) {
+                            // Create file with default config
+                            writeConfigSync(configTemplate);
+                        }
+                        console.log('Opening config file');
+                        console.log(`Opening VSCode with path: ${fullPath}`);
+                        execSync(`code --goto ${fullPath}:${1}`, { cwd: process.cwd() });
+                        break;
+                    }
+                    case 'addOverride': {
+                        // TODO: Send filename from request data to findResolveMapEntry when chromium Issue 1371551 is fixed.
+                        const { packageName, importPath } = request.data;
+                        (async () => {
+                            await addOverride({ session, packageName, importPath });
+                            session.incrementSessionVersion();
+                            notifyReload();
+                        })().catch(() => {
+                            // no-op
+                        });
+                        break;
+                    }
+                    case 'validateOverride': {
+                        // TODO: Get filename from request data when chromium Issue 1371551 is fixed.
+                        const { requestId, data } = request;
+                        const { packageName, importPath } = data;
+                        (async () => {
+                            const fixable = await validateOverride({ session, packageName, importPath });
+                            sendMessage({ type: 'validateOverride', requestId, data: { fixable } });
+                        })().catch(() => {
+                            // no-op
+                        });
+                        break;
+                    }
+                    case 'restartAllTasks': {
+                        console.log('ApiServer: Restarting all tasks');
+                        // Clear entire local cache.
+                        fsExtra.emptyDirSync(getCachePath());
+                        // All tasks can be removed as notifyReload()
+                        // will cause the client to add the tasks again.
+                        allTasks.forEach((_, id) => {
+                            taskRunner.remove(id);
+                        });
+                        // Parse config if it exists.
+                        const cloudpackConfig = readConfigSync();
+                        // Initialize package overrides.
+                        PackageDefinitions.getInstance().registerTransform(createPackageOverrideTransform(cloudpackConfig));
+                        // Update session version.
+                        session.incrementSessionVersion();
+                        notifyReload();
+                        break;
+                    }
+                    case 'restartTask': {
+                        const { id, inputPath } = request.data;
+                        console.log(`ApiServer: Restarting task ${id}`);
+                        taskRunner.remove(id);
+                        session.incrementTargetVersion(inputPath);
+                        notifyReload();
+                        break;
+                    }
+                    case 'reportMetric': {
+                        const { metric, value } = request.data;
+                        console.debug(`ApiServer: Received metric: ${metric}, value: ${value}`);
+                        rootSpan?.addEvent(metric, value);
+                        break;
+                    }
+                }
+            }
+            catch (err) {
+                console.error('ApiServer: error handling message');
+                console.error('Error:', err);
+                console.error('Message:', rawData.toString());
+            }
+        })
+            .on('close', () => {
+            for (const d of disposables.values()) {
+                d();
+            }
+        });
+    });
+    const notifyReload = () => {
+        session.sequence++;
+        socketServer.clients.forEach((socket) => {
+            if (socket.readyState === WebSocket.OPEN) {
+                socket.send(JSON.stringify({
+                    type: 'reload',
+                    data: { sessionId: session.id },
+                }));
+            }
+        });
+    };
+    return {
+        url: `${protocol}://${host}:${port}`,
+        port,
+        notifyReload,
+        addTask: (task, options) => {
+            return addTask(task, options);
+        },
+        close: () => new Promise((resolve, reject) => {
+            socketServer.clients.forEach((socket) => socket.terminate());
+            socketServer.close((err) => (err ? reject(err) : resolve()));
+            server.close();
+        }),
+    };
+}
+//# sourceMappingURL=startApiServer.js.map

package/lib/startApiServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startApiServer.js","sourceRoot":"","sources":["../src/startApiServer.ts"],"names":[],"mappings":"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","sourcesContent":["import os from 'os';\nimport getPort from 'get-port';\nimport path from 'path';\nimport http from 'http';\nimport https from 'https';\nimport WebSocket, { WebSocketServer } from 'ws';\nimport { createDataBus } from '@ms-cloudpack/data-bus';\nimport { execSync } from 'child_process';\nimport { TaskRunner } from './TaskRunner.js';\nimport { getCachePath } from './common/getCachePath.js';\nimport fsExtra from 'fs-extra';\nimport fs from 'fs';\nimport { startWatcher } from './startWatcher.js';\nimport type {\n  ApiServer,\n  CloudpackConfig,\n  Session,\n  SessionStats,\n  TaskDescription,\n  TaskEndDescription,\n  TaskStartDescription,\n} from './types.js';\nimport { PackageDefinitions } from '@ms-cloudpack/package-utilities';\nimport { createPackageOverrideTransform } from './common/createPackageOverrideTransform.js';\nimport { configTemplate, getConfigPath, readConfigSync, writeConfigSync } from '@ms-cloudpack/config';\nimport { addOverride } from './addOverride.js';\nimport { validateOverride } from './validateOverride.js';\nimport { parseHttpsConfig } from '@ms-cloudpack/create-express-app';\nimport type { Span } from '@ms-cloudpack/telemetry';\n\n/**\n * The api server handles the data pub/sub (for things like reporting build status)\n * and hosting the dashboard verb backend (for executing actions like loading vscode,\n * changing dependencies, connecting new projects to the running session, etc.)\n *\n * Each time `cloudpack start` is run, an api server will start up for that session. The\n * hosted web page will have a \"cloudpack-api-server\" header which points\n * to the websocket server.\n *\n * The bundle server will call the api server to publish build status updates.\n *\n * The app server will burn the api server url on the host html, so that client-side\n * javascript can connect and subscribe to page changes.\n */\nexport async function startApiServer({\n  session,\n  config,\n  rootSpan,\n}: {\n  session: Session;\n  config: CloudpackConfig;\n  rootSpan: Span | undefined;\n}): Promise<ApiServer> {\n  const host = config?.devServer?.domain || 'localhost';\n  const port = await getPort({ port: [9890, 9891, 9892, 9893] });\n  const bus = createDataBus();\n  const sessionStats: SessionStats = {\n    status: 'idle',\n\n    remainingTasks: 0,\n    totalTasks: 0,\n\n    totalErrors: 0,\n    totalWarnings: 0,\n  };\n\n  const allTasks: Map<string, TaskDescription> = new Map();\n  const taskRunner = new TaskRunner();\n\n  function reportStart(taskStart: TaskStartDescription): void {\n    const previousResult = allTasks.get(taskStart.id);\n    const now = new Date().getTime();\n\n    if (!previousResult) {\n      sessionStats.totalTasks++;\n    }\n\n    if (previousResult?.status === 'complete') {\n      sessionStats.totalErrors -= previousResult.errors?.length || 0;\n      sessionStats.totalWarnings -= previousResult.warnings?.length || 0;\n    }\n\n    sessionStats.remainingTasks++;\n    sessionStats.status = 'pending';\n\n    allTasks.set(taskStart.id, {\n      ...taskStart,\n      status: 'pending',\n      startTime: now,\n    });\n\n    bus.publish([session.id, 'status'], sessionStats);\n    bus.publish([session.id, 'status-details'], { tasks: Array.from(allTasks.values()) });\n  }\n\n  function reportEnd(taskEnd: TaskEndDescription): void {\n    const previousResult = allTasks.get(taskEnd.id);\n    const now = new Date().getTime();\n\n    if (previousResult) {\n      sessionStats.remainingTasks--;\n      sessionStats.totalErrors += taskEnd.errors?.length || 0;\n      sessionStats.totalWarnings += taskEnd.warnings?.length || 0;\n\n      allTasks.set(taskEnd.id, {\n        ...previousResult,\n        ...taskEnd,\n        status: 'complete',\n        durationMilliseconds: now - previousResult.startTime,\n        lastUpdated: now,\n      });\n\n      if (sessionStats.remainingTasks === 0) {\n        sessionStats.status = 'idle';\n      }\n\n      bus.publish([session.id, 'status'], sessionStats);\n      bus.publish([session.id, 'status-details'], { tasks: Array.from(allTasks.values()) });\n    }\n  }\n\n  bus.publish([session.id, 'status'], sessionStats);\n\n  const addTask: ApiServer['addTask'] = (task, options) => {\n    if (task.watch) {\n      options = options || {};\n      options.watch = () => {\n        watcher.watch(task, { onSuccess: notifyReload });\n      };\n    }\n\n    return taskRunner.add(\n      {\n        ...task,\n        execute: async () => {\n          reportStart({\n            ...task.getStartDescription?.(),\n            id: task.id,\n          });\n\n          let taskResult;\n\n          try {\n            taskResult = await task.execute();\n          } catch (err) {\n            // no-op\n          }\n\n          reportEnd({\n            ...task.getEndDescription?.(taskResult),\n            id: task.id,\n          } as TaskEndDescription);\n\n          return taskResult;\n        },\n      },\n      options,\n    );\n  };\n\n  const watcher = startWatcher(addTask);\n\n  // Create a node http(s) server.\n  let server: http.Server | https.Server;\n  const httpsConfig = config?.devServer?.https;\n  const protocol = httpsConfig ? 'wss' : 'ws';\n\n  if (httpsConfig) {\n    const { key, cert, passphrase } = parseHttpsConfig(httpsConfig);\n\n    if (!key || !cert) {\n      console.error('Invalid https config in cloudpack.config.js. Make sure key and cert are valid.');\n\n      throw new Error('Invalid https config.');\n    }\n\n    server = https\n      .createServer(\n        {\n          key,\n          cert,\n          passphrase,\n        },\n        () => {\n          /* no-op */\n        },\n      )\n      .listen(port, host);\n  } else {\n    server = http.createServer().listen(port, host);\n  }\n\n  // Create a websocket server which listens for subscriptions and verb requests,\n  // and broadcasts the data to all connected clients.\n  const socketServer = new WebSocketServer({ server }, () => {\n    // console.log(`ApiServer: Started on port ${port}`);\n  }).on('connection', (socket: WebSocket) => {\n    const disposables = new Map<number, () => void>();\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    function sendMessage(message: any) {\n      socket.send(JSON.stringify(message, null, 2));\n    }\n\n    socket.send(\n      JSON.stringify({\n        type: 'sequence',\n        sequence: session.sequence,\n      }),\n    );\n\n    socket\n      .on('message', (rawData) => {\n        try {\n          const request = JSON.parse(rawData.toString()) as {\n            type: string;\n            requestId?: string;\n            data: Record<string, unknown>;\n          };\n\n          switch (request.type) {\n            case 'subscribe': {\n              const { path: subscriptionPath, id } = request.data;\n\n              disposables.set(\n                id as number,\n                bus.subscribe(\n                  subscriptionPath as string[],\n                  // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment\n                  (data: any) => sendMessage({ type: 'notify', id, path: subscriptionPath, data }),\n                ),\n              );\n\n              break;\n            }\n\n            case 'unsubscribe': {\n              const id = request.data.id as number | undefined;\n              if (id) {\n                const dispose = disposables.get(id);\n\n                if (dispose) {\n                  dispose();\n                  disposables.delete(id);\n                }\n              }\n\n              break;\n            }\n\n            case 'openSource': {\n              const { rootPath, relativePath = '', line, column } = request.data;\n              const fullPath = path.join(rootPath as string, relativePath as string);\n\n              console.log(`Opening VSCode with path: ${fullPath}`);\n              execSync(`code --goto ${fullPath}:${line}:${column}`, { cwd: process.cwd() });\n              break;\n            }\n\n            case 'open': {\n              const { rootPath, relativePath = '' } = request.data;\n              const fullPath = path.join(rootPath as string, relativePath as string);\n\n              console.log(`Opening path: ${fullPath}`);\n              const openCommand = os.platform() == 'win32' ? 'start' : 'open';\n\n              execSync(`${openCommand} ${fullPath}`, { cwd: process.cwd() });\n              break;\n            }\n\n            case 'editConfig': {\n              const fullPath = path.resolve(getConfigPath());\n              // Check if file exists\n              if (!fs.existsSync(fullPath)) {\n                // Create file with default config\n                writeConfigSync(configTemplate);\n              }\n              console.log('Opening config file');\n              console.log(`Opening VSCode with path: ${fullPath}`);\n              execSync(`code --goto ${fullPath}:${1}`, { cwd: process.cwd() });\n              break;\n            }\n\n            case 'addOverride': {\n              // TODO: Send filename from request data to findResolveMapEntry when chromium Issue 1371551 is fixed.\n              const { packageName, importPath } = request.data as Record<string, string>;\n              (async () => {\n                await addOverride({ session, packageName, importPath });\n                session.incrementSessionVersion();\n                notifyReload();\n              })().catch(() => {\n                // no-op\n              });\n              break;\n            }\n\n            case 'validateOverride': {\n              // TODO: Get filename from request data when chromium Issue 1371551 is fixed.\n              const { requestId, data } = request as { requestId: string; data: Record<string, string> };\n              const { packageName, importPath } = data;\n              (async () => {\n                const fixable = await validateOverride({ session, packageName, importPath });\n                sendMessage({ type: 'validateOverride', requestId, data: { fixable } });\n              })().catch(() => {\n                // no-op\n              });\n              break;\n            }\n\n            case 'restartAllTasks': {\n              console.log('ApiServer: Restarting all tasks');\n\n              // Clear entire local cache.\n              fsExtra.emptyDirSync(getCachePath());\n\n              // All tasks can be removed as notifyReload()\n              // will cause the client to add the tasks again.\n              allTasks.forEach((_, id) => {\n                taskRunner.remove(id);\n              });\n\n              // Parse config if it exists.\n              const cloudpackConfig = readConfigSync();\n\n              // Initialize package overrides.\n              PackageDefinitions.getInstance().registerTransform(createPackageOverrideTransform(cloudpackConfig));\n\n              // Update session version.\n              session.incrementSessionVersion();\n\n              notifyReload();\n              break;\n            }\n\n            case 'restartTask': {\n              const { id, inputPath } = request.data as Record<string, string>;\n              console.log(`ApiServer: Restarting task ${id}`);\n              taskRunner.remove(id);\n              session.incrementTargetVersion(inputPath);\n              notifyReload();\n              break;\n            }\n\n            case 'reportMetric': {\n              const { metric, value } = request.data as { metric: string; value: number };\n              console.debug(`ApiServer: Received metric: ${metric}, value: ${value}`);\n              rootSpan?.addEvent(metric, value);\n              break;\n            }\n          }\n        } catch (err) {\n          console.error('ApiServer: error handling message');\n          console.error('Error:', err);\n          console.error('Message:', rawData.toString());\n        }\n      })\n      .on('close', () => {\n        for (const d of disposables.values()) {\n          d();\n        }\n      });\n  });\n\n  const notifyReload = () => {\n    session.sequence++;\n    socketServer.clients.forEach((socket: WebSocket) => {\n      if (socket.readyState === WebSocket.OPEN) {\n        socket.send(\n          JSON.stringify({\n            type: 'reload',\n            data: { sessionId: session.id },\n          }),\n        );\n      }\n    });\n  };\n\n  return {\n    url: `${protocol}://${host}:${port}`,\n    port,\n\n    notifyReload,\n\n    addTask: (task, options) => {\n      return addTask(task, options);\n    },\n\n    close: () =>\n      new Promise<void>((resolve, reject) => {\n        socketServer.clients.forEach((socket: WebSocket) => socket.terminate());\n        socketServer.close((err) => (err ? reject(err) : resolve()));\n        server.close();\n      }),\n  };\n}\n"]}

package/lib/startWatcher.d.ts

@@ -0,0 +1,7 @@
+import type { ApiServer, Task } from './types.js';
+export declare function startWatcher(addTask: ApiServer['addTask']): {
+    watch: <TReturn>(task: Task<TReturn>, options?: {
+        onSuccess?: () => void;
+        onDispose?: () => void;
+    }) => void;
+};

package/lib/startWatcher.js

@@ -0,0 +1,51 @@
+import chokidar from 'chokidar';
+export function startWatcher(addTask) {
+    const watched = new Set();
+    return {
+        watch: (task, options) => {
+            const { id, name, dir } = task;
+            // Have a single watcher per bundle request.
+            if (watched.has(id) || !dir) {
+                return;
+            }
+            watched.add(id);
+            console.debug(`Initializing file watcher for ${name}`);
+            // TODO: This is a bit of a hack. We should be able to use the watch API, but it doesn't seem to work.
+            const watcher = chokidar.watch(dir).on('change', (event) => {
+                console.debug(`Detected change "${event}", rebuilding "${name}"`);
+                (async () => {
+                    // Start tracking work.
+                    let rebuilt = false;
+                    try {
+                        await addTask(task, { rerun: true });
+                        rebuilt = true;
+                    }
+                    catch (err) {
+                        console.error(`Error rebuilding "${name}":`, err?.stack || err);
+                    }
+                    const errors = task.getErrors?.();
+                    if (rebuilt && !errors?.length) {
+                        console.debug(`Notifying rebuild: ${name}`);
+                        options?.onSuccess?.();
+                    }
+                    else if (errors) {
+                        console.debug(`${name} ${errors.length} errors`);
+                    }
+                })().catch(() => {
+                    // no-op
+                });
+            });
+            task.dispose = async () => {
+                try {
+                    await watcher.close();
+                }
+                catch {
+                    // ignore
+                }
+                task.onDispose?.();
+                watched.delete(id);
+            };
+        },
+    };
+}
+//# sourceMappingURL=startWatcher.js.map

package/lib/startWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startWatcher.js","sourceRoot":"","sources":["../src/startWatcher.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAGhC,MAAM,UAAU,YAAY,CAAC,OAA6B;IACxD,MAAM,OAAO,GAAgB,IAAI,GAAG,EAAE,CAAC;IAEvC,OAAO;QACL,KAAK,EAAE,CAAU,IAAmB,EAAE,OAA4D,EAAE,EAAE;YACpG,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAC/B,4CAA4C;YAC5C,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC3B,OAAO;aACR;YAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEhB,OAAO,CAAC,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;YAEvD,sGAAsG;YACtG,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBACjE,OAAO,CAAC,KAAK,CAAC,oBAAoB,KAAK,kBAAkB,IAAI,GAAG,CAAC,CAAC;gBAElE,CAAC,KAAK,IAAI,EAAE;oBACV,uBAAuB;oBACvB,IAAI,OAAO,GAAG,KAAK,CAAC;oBACpB,IAAI;wBACF,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;wBACrC,OAAO,GAAG,IAAI,CAAC;qBAChB;oBAAC,OAAO,GAAG,EAAE;wBACZ,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,IAAI,EAAG,GAAa,EAAE,KAAK,IAAI,GAAG,CAAC,CAAC;qBAC5E;oBACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;oBAClC,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE;wBAC9B,OAAO,CAAC,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;wBAC5C,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC;qBACxB;yBAAM,IAAI,MAAM,EAAE;wBACjB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;qBAClD;gBACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;oBACd,QAAQ;gBACV,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,GAAG,KAAK,IAAI,EAAE;gBACxB,IAAI;oBACF,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;iBACvB;gBAAC,MAAM;oBACN,SAAS;iBACV;gBAED,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;gBAEnB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACrB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import chokidar from 'chokidar';\nimport type { ApiServer, Task } from './types.js';\n\nexport function startWatcher(addTask: ApiServer['addTask']) {\n  const watched: Set<string> = new Set();\n\n  return {\n    watch: <TReturn>(task: Task<TReturn>, options?: { onSuccess?: () => void; onDispose?: () => void }) => {\n      const { id, name, dir } = task;\n      // Have a single watcher per bundle request.\n      if (watched.has(id) || !dir) {\n        return;\n      }\n\n      watched.add(id);\n\n      console.debug(`Initializing file watcher for ${name}`);\n\n      // TODO: This is a bit of a hack. We should be able to use the watch API, but it doesn't seem to work.\n      const watcher = chokidar.watch(dir).on('change', (event: string) => {\n        console.debug(`Detected change \"${event}\", rebuilding \"${name}\"`);\n\n        (async () => {\n          // Start tracking work.\n          let rebuilt = false;\n          try {\n            await addTask(task, { rerun: true });\n            rebuilt = true;\n          } catch (err) {\n            console.error(`Error rebuilding \"${name}\":`, (err as Error)?.stack || err);\n          }\n          const errors = task.getErrors?.();\n          if (rebuilt && !errors?.length) {\n            console.debug(`Notifying rebuild: ${name}`);\n            options?.onSuccess?.();\n          } else if (errors) {\n            console.debug(`${name} ${errors.length} errors`);\n          }\n        })().catch(() => {\n          // no-op\n        });\n      });\n\n      task.dispose = async () => {\n        try {\n          await watcher.close();\n        } catch {\n          // ignore\n        }\n\n        task.onDispose?.();\n\n        watched.delete(id);\n      };\n    },\n  };\n}\n"]}

package/lib/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.34.4"
+    }
+  ]
+}

package/lib/types.d.ts

@@ -0,0 +1,234 @@
+import type { ImportMap, ResolveMap } from '@ms-cloudpack/package-utilities';
+import type { PackageJson } from '@ms-cloudpack/bundler-types';
+import type { HttpsConfig } from '@ms-cloudpack/create-express-app';
+export interface Session {
+    /**
+     * The session id, used for identifying
+     */
+    id: string;
+    /**
+     * The primary application path to monitor.
+     */
+    appPath: string;
+    /**
+     * The type of session controls how the code is served via start.
+     * Web apps require app server and asset hosting, while libraries
+     * only need a bundle service.
+     */
+    type: 'web-app' | 'library';
+    /**
+     * The mode of the session controls how the code is bundled. Library
+     * mode bundles each package in isolation, while development and
+     * production modes bundle the full app graph together. Library
+     * mode is fastest but packages must be complaint for loading in
+     * the browser.
+     */
+    mode: 'library' | 'development' | 'production';
+    /**
+     * Used to resolve packages in the dependency graph.
+     */
+    resolveMap: ResolveMap;
+    /**
+     * Reload sequence to ensure that the client is always
+     * up to date with the latest changes.
+     */
+    sequence: number;
+    /**
+     * Get session version.
+     * Used to force a hard refresh on the client.
+     */
+    getSessionVersion: () => number;
+    /**
+     * Used to increment the session version.
+     * If version is undefined, the version will be incremented by 1.
+     * If version is greater than the current version, the version will be set to the new value.
+     */
+    incrementSessionVersion: (version?: number) => void;
+    /**
+     * The name of the project folder.
+     * Used to differentiate between multiple projects.
+     */
+    projectName: string;
+    /**
+     * The version of each target.
+     * Used to force a client cache refresh on a single target.
+     */
+    targetVersions: Record<string, number>;
+    /**
+     * Increments the version for the given target.
+     */
+    incrementTargetVersion: (inputPath: string) => void;
+    /**
+     * The import map for the session.
+     */
+    getImportMap: () => ImportMap | undefined;
+    setImportMap: (newImportMap: ImportMap) => ImportMap;
+}
+export interface SessionStats {
+    status: 'idle' | 'pending';
+    remainingTasks: number;
+    totalTasks: number;
+    totalErrors: number;
+    totalWarnings: number;
+}
+export interface ApiServer {
+    url: string;
+    port: number;
+    notifyReload: () => void;
+    addTask: <TReturn>(task: Task<TReturn>, options?: TaskOptions) => Promise<TReturn>;
+    close: () => Promise<void>;
+}
+export interface TaskError {
+    message: string;
+    pluginName: string;
+    stack: string;
+    fileLocation: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+export interface TaskStartDescription {
+    id: string;
+    name?: string;
+    inputPath?: string;
+    outputPath?: string;
+}
+export interface TaskEndDescription {
+    id: string;
+    errors?: TaskError[];
+    warnings?: TaskError[];
+}
+export interface TaskDescription extends TaskStartDescription, TaskEndDescription {
+    status: 'pending' | 'complete';
+    startTime: number;
+    durationMilliseconds?: number;
+    lastUpdated?: number;
+}
+export interface Task<TReturn> {
+    name: string;
+    id: string;
+    dir?: string;
+    execute: () => Promise<TReturn | undefined>;
+    clear?: () => void;
+    watch?: boolean;
+    dispose?: () => Promise<void>;
+    onDispose?: () => void;
+    getErrors?: () => TaskError[] | undefined;
+    getStartDescription?: () => TaskStartDescription;
+    getEndDescription?: (result: TReturn | undefined) => TaskEndDescription;
+}
+export interface TaskOptions {
+    rerun?: boolean;
+    watch?: () => void;
+}
+export interface PackageOverride {
+    name: string;
+    versionRequirement: string;
+    isInternal?: boolean;
+    overrides: PackageJson;
+}
+export interface Route {
+    /**
+     * The url path part to match. Start paths with a leading slash, e.g. `'/my-route'`. You can also
+     * use wildcards (`*`), e.g. `'/my-route/*'` to match all paths starting with `'/my-route'`.
+     */
+    match: string;
+    /**
+     * The path relative to the app root to static assets. If this is provided, renderScript/exportEntry
+     * will be ignored.
+     */
+    staticPath?: string;
+    /**
+     * Path to a .js or .html file used for rendering the route. If a script is provided, it must
+     * export a default function implementing `CreateHtmlFunction` defined in `@ms-cloudpack/cli`.
+     */
+    renderScript?: string;
+    /**
+     * The key in the exports map which represents the entry point app script for this route.
+     * Default is '.', meaning the main package export key.
+     */
+    exportEntry?: string;
+}
+export interface DevServer {
+    /**
+     * The domain name of the server.
+     */
+    domain?: string;
+    /**
+     * The ports to be used by the server.
+     * It can be a number or an array of numbers.
+     * If ports are provided, an error will be thrown if none are available.
+     * If no ports are provided, the server will attempt to find an available port.
+     */
+    port?: number | number[];
+    /**
+     * The config settings for the https server.
+     * Paths to files are accepted for 'ca', 'cert', 'key', and 'pfx' settings.
+     * Everything else is passed directly to the https.createServer() method.
+     * If not provided, the server will use http.
+     */
+    https?: HttpsConfig;
+    /**
+     * If provided, will override where the publicDir is located, relative to the app package folder.
+     * Defaults to `./public`. The same thing can be achieved with `routes`, using route: '*' and
+     * staticPath: './public', so the `publicPath` setting may be removed in the future.
+     */
+    publicPath?: string;
+    /**
+     * If provided, will register routes with the dev server to host various pages.
+     */
+    routes?: Route[];
+}
+export interface TelemetryConfig {
+    /**
+     * Application Insights instrumentation key.
+     */
+    instrumentationKey: string;
+}
+/**
+ * Per-application configuration for Cloudpack.
+ */
+export interface CloudpackConfig {
+    /**
+     * An array of PackageOverride objects, used to provide overrides for packages without modifying their
+     * definitions directly. This is primarily used for providing exports maps for packages that don't have them.
+     */
+    packageOverrides?: PackageOverride[];
+    /**
+     * A set of options for configuring how the dev server works.
+     */
+    devServer?: DevServer;
+    /**
+     * A set of options for configuring telemetry
+     */
+    telemetry?: TelemetryConfig;
+}
+/**
+ * The input options for a createHtml custom server render function.
+ */
+export type CreateHtmlOptions = {
+    session: Session;
+    route: Route;
+    baseUrl: string;
+    definition: PackageJson;
+    importMap: ImportMap;
+    overlayScript: string | undefined;
+    entryScript: string | undefined;
+    inlineScripts: string[];
+};
+/**
+ * The expected result of the createHtml custom server render function.
+ */
+export type CreateHtmlResult = string | {
+    html: string;
+    statusCode: number;
+};
+/**
+ * A custom server render function that can be used to override the default HTML response.
+ */
+export type CreateHtmlFunction = (options: CreateHtmlOptions) => Promise<CreateHtmlResult> | CreateHtmlResult;
+/**
+ * The expected shape of the createHtml custom server render function script.
+ */
+export type CreateHtmlScript = {
+    default: CreateHtmlFunction;
+};

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ImportMap, ResolveMap } from '@ms-cloudpack/package-utilities';\nimport type { PackageJson } from '@ms-cloudpack/bundler-types';\nimport type { HttpsConfig } from '@ms-cloudpack/create-express-app';\n\nexport interface Session {\n  /**\n   * The session id, used for identifying\n   */\n  id: string;\n\n  /**\n   * The primary application path to monitor.\n   */\n  appPath: string;\n\n  /**\n   * The type of session controls how the code is served via start.\n   * Web apps require app server and asset hosting, while libraries\n   * only need a bundle service.\n   */\n  type: 'web-app' | 'library';\n\n  /**\n   * The mode of the session controls how the code is bundled. Library\n   * mode bundles each package in isolation, while development and\n   * production modes bundle the full app graph together. Library\n   * mode is fastest but packages must be complaint for loading in\n   * the browser.\n   */\n  mode: 'library' | 'development' | 'production';\n\n  /**\n   * Used to resolve packages in the dependency graph.\n   */\n  resolveMap: ResolveMap;\n\n  /**\n   * Reload sequence to ensure that the client is always\n   * up to date with the latest changes.\n   */\n  sequence: number;\n\n  /**\n   * Get session version.\n   * Used to force a hard refresh on the client.\n   */\n  getSessionVersion: () => number;\n\n  /**\n   * Used to increment the session version.\n   * If version is undefined, the version will be incremented by 1.\n   * If version is greater than the current version, the version will be set to the new value.\n   */\n  incrementSessionVersion: (version?: number) => void;\n\n  /**\n   * The name of the project folder.\n   * Used to differentiate between multiple projects.\n   */\n  projectName: string;\n\n  /**\n   * The version of each target.\n   * Used to force a client cache refresh on a single target.\n   */\n  targetVersions: Record<string, number>;\n\n  /**\n   * Increments the version for the given target.\n   */\n  incrementTargetVersion: (inputPath: string) => void;\n\n  /**\n   * The import map for the session.\n   */\n  getImportMap: () => ImportMap | undefined;\n\n  setImportMap: (newImportMap: ImportMap) => ImportMap;\n}\n\nexport interface SessionStats {\n  status: 'idle' | 'pending';\n\n  remainingTasks: number;\n  totalTasks: number;\n\n  totalErrors: number;\n  totalWarnings: number;\n}\n\nexport interface ApiServer {\n  url: string;\n  port: number;\n\n  notifyReload: () => void;\n\n  addTask: <TReturn>(task: Task<TReturn>, options?: TaskOptions) => Promise<TReturn>;\n\n  close: () => Promise<void>;\n}\n\nexport interface TaskError {\n  message: string;\n  pluginName: string;\n  stack: string;\n  fileLocation: string;\n  lineNumber: number;\n  columnNumber: number;\n}\n\nexport interface TaskStartDescription {\n  id: string;\n  name?: string;\n  inputPath?: string;\n  outputPath?: string;\n}\n\nexport interface TaskEndDescription {\n  id: string;\n  errors?: TaskError[];\n  warnings?: TaskError[];\n}\n\nexport interface TaskDescription extends TaskStartDescription, TaskEndDescription {\n  status: 'pending' | 'complete';\n  startTime: number;\n  durationMilliseconds?: number;\n  lastUpdated?: number;\n}\n\nexport interface Task<TReturn> {\n  name: string;\n  id: string;\n  dir?: string;\n  execute: () => Promise<TReturn | undefined>;\n  clear?: () => void;\n  watch?: boolean;\n  dispose?: () => Promise<void>;\n  onDispose?: () => void;\n  getErrors?: () => TaskError[] | undefined;\n  getStartDescription?: () => TaskStartDescription;\n  getEndDescription?: (result: TReturn | undefined) => TaskEndDescription;\n}\n\nexport interface TaskOptions {\n  rerun?: boolean;\n  watch?: () => void;\n}\n\nexport interface PackageOverride {\n  name: string;\n  versionRequirement: string;\n  isInternal?: boolean;\n  overrides: PackageJson;\n}\n\nexport interface Route {\n  /**\n   * The url path part to match. Start paths with a leading slash, e.g. `'/my-route'`. You can also\n   * use wildcards (`*`), e.g. `'/my-route/*'` to match all paths starting with `'/my-route'`.\n   */\n  match: string;\n\n  /**\n   * The path relative to the app root to static assets. If this is provided, renderScript/exportEntry\n   * will be ignored.\n   */\n  staticPath?: string;\n\n  /**\n   * Path to a .js or .html file used for rendering the route. If a script is provided, it must\n   * export a default function implementing `CreateHtmlFunction` defined in `@ms-cloudpack/cli`.\n   */\n  renderScript?: string;\n\n  /**\n   * The key in the exports map which represents the entry point app script for this route.\n   * Default is '.', meaning the main package export key.\n   */\n  exportEntry?: string;\n}\n\nexport interface DevServer {\n  /**\n   * The domain name of the server.\n   */\n  domain?: string;\n\n  /**\n   * The ports to be used by the server.\n   * It can be a number or an array of numbers.\n   * If ports are provided, an error will be thrown if none are available.\n   * If no ports are provided, the server will attempt to find an available port.\n   */\n  port?: number | number[];\n\n  /**\n   * The config settings for the https server.\n   * Paths to files are accepted for 'ca', 'cert', 'key', and 'pfx' settings.\n   * Everything else is passed directly to the https.createServer() method.\n   * If not provided, the server will use http.\n   */\n  https?: HttpsConfig;\n\n  /**\n   * If provided, will override where the publicDir is located, relative to the app package folder.\n   * Defaults to `./public`. The same thing can be achieved with `routes`, using route: '*' and\n   * staticPath: './public', so the `publicPath` setting may be removed in the future.\n   */\n  publicPath?: string;\n\n  /**\n   * If provided, will register routes with the dev server to host various pages.\n   */\n  routes?: Route[];\n}\n\nexport interface TelemetryConfig {\n  /**\n   * Application Insights instrumentation key.\n   */\n  instrumentationKey: string;\n}\n\n/**\n * Per-application configuration for Cloudpack.\n */\nexport interface CloudpackConfig {\n  /**\n   * An array of PackageOverride objects, used to provide overrides for packages without modifying their\n   * definitions directly. This is primarily used for providing exports maps for packages that don't have them.\n   */\n  packageOverrides?: PackageOverride[];\n\n  /**\n   * A set of options for configuring how the dev server works.\n   */\n  devServer?: DevServer;\n\n  /**\n   * A set of options for configuring telemetry\n   */\n  telemetry?: TelemetryConfig;\n}\n\n/**\n * The input options for a createHtml custom server render function.\n */\nexport type CreateHtmlOptions = {\n  session: Session;\n  route: Route;\n  baseUrl: string;\n  definition: PackageJson;\n  importMap: ImportMap;\n  overlayScript: string | undefined;\n  entryScript: string | undefined;\n  inlineScripts: string[];\n};\n\n/**\n * The expected result of the createHtml custom server render function.\n */\nexport type CreateHtmlResult =\n  | string\n  | {\n      html: string;\n      statusCode: number;\n    };\n\n/**\n * A custom server render function that can be used to override the default HTML response.\n */\nexport type CreateHtmlFunction = (options: CreateHtmlOptions) => Promise<CreateHtmlResult> | CreateHtmlResult;\n\n/**\n * The expected shape of the createHtml custom server render function script.\n */\nexport type CreateHtmlScript = { default: CreateHtmlFunction };\n"]}

package/lib/validateOverride.d.ts

@@ -0,0 +1,7 @@
+import type { Session } from './types.js';
+export declare function validateOverride({ session, packageName, importPath, filename, }: {
+    session: Session;
+    packageName: string;
+    importPath: string;
+    filename?: string;
+}): Promise<boolean>;

package/lib/validateOverride.js

@@ -0,0 +1,28 @@
+import { findResolveMapEntry, findFileInPackage } from '@ms-cloudpack/package-utilities';
+import { slash } from '@ms-cloudpack/path-string-parsing';
+import { parseRequestInfo } from './parseRequestInfo.js';
+export async function validateOverride({ session, packageName, importPath, filename, }) {
+    let definition = undefined;
+    if (filename) {
+        const requestPath = slash(new URL(filename).pathname);
+        const { packageName: name, version } = parseRequestInfo(requestPath);
+        definition = { name, version };
+    }
+    const entry = findResolveMapEntry({
+        packageName,
+        resolveMap: session.resolveMap,
+        definition,
+    });
+    if (entry === undefined) {
+        return false;
+    }
+    const { filePath } = await findFileInPackage({
+        packagePath: entry.path,
+        filePath: importPath,
+    });
+    if (filePath) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=validateOverride.js.map

package/lib/validateOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateOverride.js","sourceRoot":"","sources":["../src/validateOverride.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,OAAO,EACP,WAAW,EACX,UAAU,EACV,QAAQ,GAMT;IACC,IAAI,UAAU,GAAG,SAAS,CAAC;IAE3B,IAAI,QAAQ,EAAE;QACZ,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;QACtD,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACrE,UAAU,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;KAChC;IAED,MAAM,KAAK,GAAG,mBAAmB,CAAC;QAChC,WAAW;QACX,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU;KACX,CAAC,CAAC;IAEH,IAAI,KAAK,KAAK,SAAS,EAAE;QACvB,OAAO,KAAK,CAAC;KACd;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,CAAC;QAC3C,WAAW,EAAE,KAAK,CAAC,IAAI;QACvB,QAAQ,EAAE,UAAU;KACrB,CAAC,CAAC;IAEH,IAAI,QAAQ,EAAE;QACZ,OAAO,IAAI,CAAC;KACb;IACD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import { findResolveMapEntry, findFileInPackage } from '@ms-cloudpack/package-utilities';\nimport { slash } from '@ms-cloudpack/path-string-parsing';\nimport type { Session } from './types.js';\nimport { parseRequestInfo } from './parseRequestInfo.js';\n\nexport async function validateOverride({\n  session,\n  packageName,\n  importPath,\n  filename,\n}: {\n  session: Session;\n  packageName: string;\n  importPath: string;\n  filename?: string;\n}) {\n  let definition = undefined;\n\n  if (filename) {\n    const requestPath = slash(new URL(filename).pathname);\n    const { packageName: name, version } = parseRequestInfo(requestPath);\n    definition = { name, version };\n  }\n\n  const entry = findResolveMapEntry({\n    packageName,\n    resolveMap: session.resolveMap,\n    definition,\n  });\n\n  if (entry === undefined) {\n    return false;\n  }\n\n  const { filePath } = await findFileInPackage({\n    packagePath: entry.path,\n    filePath: importPath,\n  });\n\n  if (filePath) {\n    return true;\n  }\n  return false;\n}\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ms-cloudpack/api-server",
+  "version": "0.2.0",
+  "description": "An implementation of the API server that does interacts with a task scheduler.",
+  "license": "MIT",
+  "type": "module",
+  "types": "./lib/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "dependencies": {
+    "@ms-cloudpack/bundler-types": "^0.11.0",
+    "@ms-cloudpack/config": "^0.2.0",
+    "@ms-cloudpack/create-express-app": "^1.3.0",
+    "@ms-cloudpack/data-bus": "^0.1.1",
+    "@ms-cloudpack/package-utilities": "^2.3.10",
+    "@ms-cloudpack/path-string-parsing": "^1.0.1",
+    "@ms-cloudpack/telemetry": "^0.2.2",
+    "chokidar": "^3.5.3",
+    "fs-extra": "^11.0.0",
+    "get-port": "^6.1.2",
+    "p-queue": "^7.3.0",
+    "semver": "^7.3.7",
+    "ws": "^8.9.0"
+  },
+  "devDependencies": {
+    "@ms-cloudpack/eslint-config-base": "*",
+    "@ms-cloudpack/scripts": "*",
+    "@ms-cloudpack/test-utilities": "*",
+    "@types/ws": "8.5.4"
+  },
+  "scripts": {
+    "api:update": "cloudpack-scripts api-update",
+    "api": "cloudpack-scripts api",
+    "build:watch": "cloudpack-scripts build-watch",
+    "build": "cloudpack-scripts build",
+    "lint:update": "cloudpack-scripts lint-update",
+    "lint": "cloudpack-scripts lint",
+    "test:update": "cloudpack-scripts test-update",
+    "test:watch": "cloudpack-scripts test-watch",
+    "test": "cloudpack-scripts test"
+  },
+  "files": [
+    "lib/**/!(*.test.*)"
+  ]
+}