@qpqjs/user-script 0.0.0-stage → 0.2.0

package/lib/commonjs/config/getUserScriptBuilderLayerDir.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserScriptBuilderLayerDir = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const USER_SCRIPT_BUILDER_LAYER_NAME_1 = require("./USER_SCRIPT_BUILDER_LAYER_NAME");
+const PACKAGE_NAME = '@qpqjs/user-script';
+// This package's root, from src under ts-node or from lib/commonjs, by walking up to its
+// own package.json.
+const getOwnPackageRoot = () => {
+    let dir = __dirname;
+    while (true) {
+        const candidate = path_1.default.join(dir, 'package.json');
+        if (fs_1.default.existsSync(candidate) && JSON.parse(fs_1.default.readFileSync(candidate, 'utf8')).name === PACKAGE_NAME) {
+            return dir;
+        }
+        const parent = path_1.default.dirname(dir);
+        if (parent === dir)
+            throw new Error(`Could not locate the ${PACKAGE_NAME} package root from [${__dirname}]`);
+        dir = parent;
+    }
+};
+/**
+ * The one directory the builder layer lives in: `<this package>/layer`. The api layer
+ * entry reads it and `qpq script:builder-layer` writes it, so neither side is told a
+ * path. Absolute, which is why the CDK resolves layer paths rather than joining them.
+ */
+const getUserScriptBuilderLayerDir = () => path_1.default.join(getOwnPackageRoot(), 'layer', USER_SCRIPT_BUILDER_LAYER_NAME_1.USER_SCRIPT_BUILDER_LAYER_NAME);
+exports.getUserScriptBuilderLayerDir = getUserScriptBuilderLayerDir;
+//# sourceMappingURL=getUserScriptBuilderLayerDir.js.map

package/lib/commonjs/config/getUserScriptBuilderLayerDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUserScriptBuilderLayerDir.js","sourceRoot":"","sources":["../../../src/config/getUserScriptBuilderLayerDir.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AACpB,gDAAwB;AAExB,qFAAkF;AAElF,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,yFAAyF;AACzF,oBAAoB;AACpB,MAAM,iBAAiB,GAAG,GAAW,EAAE;IACrC,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACjD,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACrG,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,YAAY,uBAAuB,SAAS,GAAG,CAAC,CAAC;QAC7G,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACI,MAAM,4BAA4B,GAAG,GAAW,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,+DAA8B,CAAC,CAAC;AAArH,QAAA,4BAA4B,gCAAyF","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nimport { USER_SCRIPT_BUILDER_LAYER_NAME } from './USER_SCRIPT_BUILDER_LAYER_NAME';\n\nconst PACKAGE_NAME = '@qpqjs/user-script';\n\n// This package's root, from src under ts-node or from lib/commonjs, by walking up to its\n// own package.json.\nconst getOwnPackageRoot = (): string => {\n  let dir = __dirname;\n  while (true) {\n    const candidate = path.join(dir, 'package.json');\n    if (fs.existsSync(candidate) && JSON.parse(fs.readFileSync(candidate, 'utf8')).name === PACKAGE_NAME) {\n      return dir;\n    }\n    const parent = path.dirname(dir);\n    if (parent === dir) throw new Error(`Could not locate the ${PACKAGE_NAME} package root from [${__dirname}]`);\n    dir = parent;\n  }\n};\n\n/**\n * The one directory the builder layer lives in: `<this package>/layer`. The api layer\n * entry reads it and `qpq script:builder-layer` writes it, so neither side is told a\n * path. Absolute, which is why the CDK resolves layer paths rather than joining them.\n */\nexport const getUserScriptBuilderLayerDir = (): string => path.join(getOwnPackageRoot(), 'layer', USER_SCRIPT_BUILDER_LAYER_NAME);\n"]}

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

@@ -0,0 +1,5 @@
+export * from './defineUserScriptBuilder';
+export * from './getUserScriptBuilderApiLayer';
+export * from './getUserScriptBuilderLayerDir';
+export * from './USER_SCRIPT_BUILDER_LAYER_MODULES';
+export * from './USER_SCRIPT_BUILDER_LAYER_NAME';

package/lib/commonjs/config/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./defineUserScriptBuilder"), exports);
+__exportStar(require("./getUserScriptBuilderApiLayer"), exports);
+__exportStar(require("./getUserScriptBuilderLayerDir"), exports);
+__exportStar(require("./USER_SCRIPT_BUILDER_LAYER_MODULES"), exports);
+__exportStar(require("./USER_SCRIPT_BUILDER_LAYER_NAME"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,iEAA+C;AAC/C,iEAA+C;AAC/C,sEAAoD;AACpD,mEAAiD","sourcesContent":["export * from './defineUserScriptBuilder';\nexport * from './getUserScriptBuilderApiLayer';\nexport * from './getUserScriptBuilderLayerDir';\nexport * from './USER_SCRIPT_BUILDER_LAYER_MODULES';\nexport * from './USER_SCRIPT_BUILDER_LAYER_NAME';\n"]}

package/lib/commonjs/index.d.ts

@@ -0,0 +1,3 @@
+export * from './actionProcessor';
+export * from './build';
+export * from './config';

package/lib/commonjs/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./actionProcessor"), exports);
+__exportStar(require("./build"), exports);
+__exportStar(require("./config"), exports);
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,0CAAwB;AACxB,2CAAyB","sourcesContent":["export * from './actionProcessor';\nexport * from './build';\nexport * from './config';\n"]}

package/lib/esm/actionProcessor/getUserScriptBuildActionProcessor.d.ts

@@ -0,0 +1 @@
+export declare const getUserScriptBuildActionProcessor: import("@qpqjs/core").ActionProcessorListResolver;

package/lib/esm/actionProcessor/getUserScriptBuildActionProcessor.js

@@ -0,0 +1,56 @@
+import { loadUserScriptHostModules } from '@qpqjs/actionprocessor-node';
+import { actionResult, actionResultError, askFileListDirectory, askFileReadTextContents, askUserScriptBuild, createActionProcessor, createNestedRuntime, QpqRuntimeType, } from '@qpqjs/core';
+import { randomUUID } from 'crypto';
+import { UserScriptBuildError } from '../build/UserScriptBuildError';
+import { askUserScriptCheckPublishedOutput } from './logic/askUserScriptCheckPublishedOutput';
+import { askUserScriptCollectSource } from './logic/askUserScriptCollectSource';
+import { askUserScriptPublishOutput } from './logic/askUserScriptPublishOutput';
+import { buildUserScriptInTempDir } from './logic/buildUserScriptInTempDir';
+import { getUserScriptBuildErrorType } from './logic/getUserScriptBuildErrorType';
+import { materialiseUserScriptSource } from './logic/materialiseUserScriptSource';
+const { errorType } = askUserScriptBuild;
+const getDateNow = () => new Date().toISOString();
+// Drive failures while collecting the source, re-labelled into this action's catalog; any
+// other failure passes through with its own type.
+const COLLECT_ERROR_TYPES = {
+    [askFileListDirectory.errorType.DirectoryNotFound]: errorType.SourceNotFound,
+    [askFileListDirectory.errorType.DriveNotFound]: errorType.DriveNotFound,
+    [askFileListDirectory.errorType.InvalidScope]: errorType.InvalidScope,
+    [askFileReadTextContents.errorType.InvalidScope]: errorType.InvalidScope,
+};
+const getProcessBuild = (qpqConfig) => {
+    return async (payload, session, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry) => {
+        const resolveStory = createNestedRuntime(qpqConfig, session, actionProcessors, getDateNow, logger, randomUUID, QpqRuntimeType.EXECUTE_STORY, dynamicModuleLoader, undefined, [], streamRegistry);
+        // The source and the output both travel through the file actions, so each runtime's
+        // own drive implementation serves them; only the build itself touches local disk.
+        const collected = await resolveStory(() => askUserScriptCollectSource(payload.drive, payload.sourceDirectory, payload.scope), []);
+        if (collected.error) {
+            return actionResultError(COLLECT_ERROR_TYPES[collected.error.errorType] ?? collected.error.errorType, collected.error.errorText);
+        }
+        // The service's own script modules, which the bundler keeps external. One that does not
+        // load is the service's fault, so it throws rather than failing the build.
+        const hostModules = await loadUserScriptHostModules(qpqConfig, dynamicModuleLoader);
+        let built;
+        try {
+            built = await buildUserScriptInTempDir((projectDir) => materialiseUserScriptSource(projectDir, collected.result), payload.sourceMap, hostModules);
+        }
+        catch (error) {
+            if (error instanceof UserScriptBuildError) {
+                return actionResultError(getUserScriptBuildErrorType(error.code, errorType), error.message);
+            }
+            throw error;
+        }
+        const published = await resolveStory(() => askUserScriptPublishOutput(payload.drive, payload.outputFilepath, built.script, payload.scope), []);
+        if (published.error) {
+            return actionResultError(published.error.errorType, published.error.errorText);
+        }
+        // The output contract is judged where the script's top-level code cannot reach the host.
+        const checked = await resolveStory(() => askUserScriptCheckPublishedOutput(payload.drive, payload.outputFilepath, payload.scope, errorType), []);
+        if (checked.error) {
+            return actionResultError(checked.error.errorType, checked.error.errorText);
+        }
+        return actionResult({ exports: checked.result });
+    };
+};
+export const getUserScriptBuildActionProcessor = createActionProcessor(askUserScriptBuild, getProcessBuild);
+//# sourceMappingURL=getUserScriptBuildActionProcessor.js.map

package/lib/esm/actionProcessor/getUserScriptBuildActionProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUserScriptBuildActionProcessor.js","sourceRoot":"","sources":["../../../src/actionProcessor/getUserScriptBuildActionProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { loadUserScriptHostModules } from '@qpqjs/actionprocessor-node';\nimport {\n  ActionProcessorList,\n  actionResult,\n  actionResultError,\n  askFileListDirectory,\n  askFileReadTextContents,\n  askUserScriptBuild,\n  createActionProcessor,\n  createNestedRuntime,\n  DynamicModuleLoader,\n  ProcessorFor,\n  QPQConfig,\n  QpqLogger,\n  QpqRuntimeType,\n  StorySession,\n  StorySessionUpdater,\n  StreamRegistry,\n  UserScriptBuildActionPayload,\n} from '@qpqjs/core';\n\nimport { randomUUID } from 'crypto';\n\nimport { UserScriptBuildError } from '../build/UserScriptBuildError';\nimport { askUserScriptCheckPublishedOutput } from './logic/askUserScriptCheckPublishedOutput';\nimport { askUserScriptCollectSource } from './logic/askUserScriptCollectSource';\nimport { askUserScriptPublishOutput } from './logic/askUserScriptPublishOutput';\nimport { buildUserScriptInTempDir } from './logic/buildUserScriptInTempDir';\nimport { BuiltUserScript } from './logic/BuiltUserScript';\nimport { getUserScriptBuildErrorType } from './logic/getUserScriptBuildErrorType';\nimport { materialiseUserScriptSource } from './logic/materialiseUserScriptSource';\n\nconst { errorType } = askUserScriptBuild;\n\nconst getDateNow = () => new Date().toISOString();\n\n// Drive failures while collecting the source, re-labelled into this action's catalog; any\n// other failure passes through with its own type.\nconst COLLECT_ERROR_TYPES: Record<string, string> = {\n  [askFileListDirectory.errorType.DirectoryNotFound]: errorType.SourceNotFound,\n  [askFileListDirectory.errorType.DriveNotFound]: errorType.DriveNotFound,\n  [askFileListDirectory.errorType.InvalidScope]: errorType.InvalidScope,\n  [askFileReadTextContents.errorType.InvalidScope]: errorType.InvalidScope,\n};\n\nconst getProcessBuild = (qpqConfig: QPQConfig): ProcessorFor<typeof askUserScriptBuild> => {\n  return async (\n    payload: UserScriptBuildActionPayload,\n    session: StorySession,\n    actionProcessors: ActionProcessorList,\n    logger: QpqLogger,\n    updateSession: StorySessionUpdater,\n    dynamicModuleLoader: DynamicModuleLoader,\n    streamRegistry: StreamRegistry,\n  ) => {\n    const resolveStory = createNestedRuntime(\n      qpqConfig,\n      session,\n      actionProcessors,\n      getDateNow,\n      logger,\n      randomUUID,\n      QpqRuntimeType.EXECUTE_STORY,\n      dynamicModuleLoader,\n      undefined,\n      [],\n      streamRegistry,\n    );\n\n    // The source and the output both travel through the file actions, so each runtime's\n    // own drive implementation serves them; only the build itself touches local disk.\n    const collected = await resolveStory(() => askUserScriptCollectSource(payload.drive, payload.sourceDirectory, payload.scope), []);\n    if (collected.error) {\n      return actionResultError(COLLECT_ERROR_TYPES[collected.error.errorType] ?? collected.error.errorType, collected.error.errorText);\n    }\n\n    // The service's own script modules, which the bundler keeps external. One that does not\n    // load is the service's fault, so it throws rather than failing the build.\n    const hostModules = await loadUserScriptHostModules(qpqConfig, dynamicModuleLoader);\n\n    let built: BuiltUserScript;\n    try {\n      built = await buildUserScriptInTempDir(\n        (projectDir) => materialiseUserScriptSource(projectDir, collected.result),\n        payload.sourceMap,\n        hostModules,\n      );\n    } catch (error) {\n      if (error instanceof UserScriptBuildError) {\n        return actionResultError(getUserScriptBuildErrorType(error.code, errorType), error.message);\n      }\n      throw error;\n    }\n\n    const published = await resolveStory(() => askUserScriptPublishOutput(payload.drive, payload.outputFilepath, built.script, payload.scope), []);\n    if (published.error) {\n      return actionResultError(published.error.errorType, published.error.errorText);\n    }\n\n    // The output contract is judged where the script's top-level code cannot reach the host.\n    const checked = await resolveStory(() => askUserScriptCheckPublishedOutput(payload.drive, payload.outputFilepath, payload.scope, errorType), []);\n    if (checked.error) {\n      return actionResultError(checked.error.errorType, checked.error.errorText);\n    }\n\n    return actionResult({ exports: checked.result });\n  };\n};\n\nexport const getUserScriptBuildActionProcessor = createActionProcessor(askUserScriptBuild, getProcessBuild);\n"]}

package/lib/esm/actionProcessor/getUserScriptBuildActionProcessors.d.ts

@@ -0,0 +1,3 @@
+import { ActionProcessorListResolver } from '@qpqjs/core';
+/** The resolver defineUserScriptBuilder points a service at: both build actions, from a directory and from a zip. */
+export declare const getUserScriptBuildActionProcessors: ActionProcessorListResolver;

package/lib/esm/actionProcessor/getUserScriptBuildActionProcessors.js

@@ -0,0 +1,8 @@
+import { getUserScriptBuildActionProcessor } from './getUserScriptBuildActionProcessor';
+import { getUserScriptBuildFromZipActionProcessor } from './getUserScriptBuildFromZipActionProcessor';
+/** The resolver defineUserScriptBuilder points a service at: both build actions, from a directory and from a zip. */
+export const getUserScriptBuildActionProcessors = async (qpqConfig, dynamicModuleLoader) => ({
+    ...(await getUserScriptBuildActionProcessor(qpqConfig, dynamicModuleLoader)),
+    ...(await getUserScriptBuildFromZipActionProcessor(qpqConfig, dynamicModuleLoader)),
+});
+//# sourceMappingURL=getUserScriptBuildActionProcessors.js.map

package/lib/esm/actionProcessor/getUserScriptBuildActionProcessors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUserScriptBuildActionProcessors.js","sourceRoot":"","sources":["../../../src/actionProcessor/getUserScriptBuildActionProcessors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAAE,wCAAwC,EAAE,MAAM,4CAA4C,CAAC;AAEtG,qHAAqH;AACrH,MAAM,CAAC,MAAM,kCAAkC,GAAgC,KAAK,EAClF,SAAoB,EACpB,mBAAwC,EACV,EAAE,CAAC,CAAC;IAClC,GAAG,CAAC,MAAM,iCAAiC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC5E,GAAG,CAAC,MAAM,wCAAwC,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;CACpF,CAAC,CAAC","sourcesContent":["import { ActionProcessorList, ActionProcessorListResolver, DynamicModuleLoader, QPQConfig } from '@qpqjs/core';\n\nimport { getUserScriptBuildActionProcessor } from './getUserScriptBuildActionProcessor';\nimport { getUserScriptBuildFromZipActionProcessor } from './getUserScriptBuildFromZipActionProcessor';\n\n/** The resolver defineUserScriptBuilder points a service at: both build actions, from a directory and from a zip. */\nexport const getUserScriptBuildActionProcessors: ActionProcessorListResolver = async (\n  qpqConfig: QPQConfig,\n  dynamicModuleLoader: DynamicModuleLoader,\n): Promise<ActionProcessorList> => ({\n  ...(await getUserScriptBuildActionProcessor(qpqConfig, dynamicModuleLoader)),\n  ...(await getUserScriptBuildFromZipActionProcessor(qpqConfig, dynamicModuleLoader)),\n});\n"]}

package/lib/esm/actionProcessor/getUserScriptBuildFromZipActionProcessor.d.ts

@@ -0,0 +1 @@
+export declare const getUserScriptBuildFromZipActionProcessor: import("@qpqjs/core").ActionProcessorListResolver;

package/lib/esm/actionProcessor/getUserScriptBuildFromZipActionProcessor.js

@@ -0,0 +1,66 @@
+import { loadUserScriptHostModules } from '@qpqjs/actionprocessor-node';
+import { actionResult, actionResultError, askFileReadBinaryContents, askUserScriptBuildFromZip, createActionProcessor, createNestedRuntime, QpqRuntimeType, } from '@qpqjs/core';
+import { randomUUID } from 'crypto';
+import { UserScriptBuildError } from '../build/UserScriptBuildError';
+import { askUserScriptCheckPublishedOutput } from './logic/askUserScriptCheckPublishedOutput';
+import { askUserScriptPublishOutput } from './logic/askUserScriptPublishOutput';
+import { buildUserScriptInTempDir } from './logic/buildUserScriptInTempDir';
+import { extractUserScriptZip } from './logic/extractUserScriptZip';
+import { getUserScriptBuildErrorType } from './logic/getUserScriptBuildErrorType';
+import { USER_SCRIPT_SOURCE_LIMITS } from './logic/USER_SCRIPT_SOURCE_LIMITS';
+import { UserScriptArchiveError } from './logic/UserScriptArchiveError';
+const { errorType } = askUserScriptBuildFromZip;
+const getDateNow = () => new Date().toISOString();
+// Drive failures while reading the zip, re-labelled into this action's catalog; any other
+// failure passes through with its own type.
+const READ_ERROR_TYPES = {
+    [askFileReadBinaryContents.errorType.FileNotFound]: errorType.SourceNotFound,
+    [askFileReadBinaryContents.errorType.InvalidScope]: errorType.InvalidScope,
+};
+// The archive error codes are named after the action's own catalog.
+const getArchiveErrorType = (error) => errorType[error.code];
+const getProcessBuildFromZip = (qpqConfig) => {
+    return async (payload, session, actionProcessors, logger, updateSession, dynamicModuleLoader, streamRegistry) => {
+        const resolveStory = createNestedRuntime(qpqConfig, session, actionProcessors, getDateNow, logger, randomUUID, QpqRuntimeType.EXECUTE_STORY, dynamicModuleLoader, undefined, [], streamRegistry);
+        const read = await resolveStory(() => askFileReadBinaryContents(payload.drive, payload.zipFilepath, payload.scope), []);
+        if (read.error) {
+            return actionResultError(READ_ERROR_TYPES[read.error.errorType] ?? read.error.errorType, read.error.errorText);
+        }
+        // The file actions give no size without the bytes, so the zip's own cap applies to
+        // what came back before anything is unpacked.
+        const zip = Buffer.from(read.result.base64Data, 'base64');
+        if (zip.length > USER_SCRIPT_SOURCE_LIMITS.maxBytes) {
+            return actionResultError(errorType.SourceTooLarge, `[${payload.drive}:${payload.zipFilepath}] is larger than ${USER_SCRIPT_SOURCE_LIMITS.maxBytes} bytes`);
+        }
+        // The service's own script modules, which the bundler keeps external. One that does not
+        // load is the service's fault, so it throws rather than failing the build.
+        const hostModules = await loadUserScriptHostModules(qpqConfig, dynamicModuleLoader);
+        let built;
+        try {
+            built = await buildUserScriptInTempDir(async (projectDir) => {
+                await extractUserScriptZip(zip, projectDir);
+            }, payload.sourceMap, hostModules);
+        }
+        catch (error) {
+            if (error instanceof UserScriptArchiveError) {
+                return actionResultError(getArchiveErrorType(error), `[${payload.drive}:${payload.zipFilepath}] ${error.message}`);
+            }
+            if (error instanceof UserScriptBuildError) {
+                return actionResultError(getUserScriptBuildErrorType(error.code, errorType), error.message);
+            }
+            throw error;
+        }
+        const published = await resolveStory(() => askUserScriptPublishOutput(payload.drive, payload.outputFilepath, built.script, payload.scope), []);
+        if (published.error) {
+            return actionResultError(published.error.errorType, published.error.errorText);
+        }
+        // The output contract is judged where the script's top-level code cannot reach the host.
+        const checked = await resolveStory(() => askUserScriptCheckPublishedOutput(payload.drive, payload.outputFilepath, payload.scope, errorType), []);
+        if (checked.error) {
+            return actionResultError(checked.error.errorType, checked.error.errorText);
+        }
+        return actionResult({ exports: checked.result });
+    };
+};
+export const getUserScriptBuildFromZipActionProcessor = createActionProcessor(askUserScriptBuildFromZip, getProcessBuildFromZip);
+//# sourceMappingURL=getUserScriptBuildFromZipActionProcessor.js.map

package/lib/esm/actionProcessor/getUserScriptBuildFromZipActionProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getUserScriptBuildFromZipActionProcessor.js","sourceRoot":"","sources":["../../../src/actionProcessor/getUserScriptBuildFromZipActionProcessor.ts"],"names":[],"mappings":"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","sourcesContent":["import { loadUserScriptHostModules } from '@qpqjs/actionprocessor-node';\nimport {\n  ActionProcessorList,\n  actionResult,\n  actionResultError,\n  askFileReadBinaryContents,\n  askUserScriptBuildFromZip,\n  createActionProcessor,\n  createNestedRuntime,\n  DynamicModuleLoader,\n  ProcessorFor,\n  QPQConfig,\n  QpqLogger,\n  QpqRuntimeType,\n  StorySession,\n  StorySessionUpdater,\n  StreamRegistry,\n  UserScriptBuildFromZipActionPayload,\n} from '@qpqjs/core';\n\nimport { randomUUID } from 'crypto';\n\nimport { UserScriptBuildError } from '../build/UserScriptBuildError';\nimport { askUserScriptCheckPublishedOutput } from './logic/askUserScriptCheckPublishedOutput';\nimport { askUserScriptPublishOutput } from './logic/askUserScriptPublishOutput';\nimport { buildUserScriptInTempDir } from './logic/buildUserScriptInTempDir';\nimport { BuiltUserScript } from './logic/BuiltUserScript';\nimport { extractUserScriptZip } from './logic/extractUserScriptZip';\nimport { getUserScriptBuildErrorType } from './logic/getUserScriptBuildErrorType';\nimport { USER_SCRIPT_SOURCE_LIMITS } from './logic/USER_SCRIPT_SOURCE_LIMITS';\nimport { UserScriptArchiveError } from './logic/UserScriptArchiveError';\n\nconst { errorType } = askUserScriptBuildFromZip;\n\nconst getDateNow = () => new Date().toISOString();\n\n// Drive failures while reading the zip, re-labelled into this action's catalog; any other\n// failure passes through with its own type.\nconst READ_ERROR_TYPES: Record<string, string> = {\n  [askFileReadBinaryContents.errorType.FileNotFound]: errorType.SourceNotFound,\n  [askFileReadBinaryContents.errorType.InvalidScope]: errorType.InvalidScope,\n};\n\n// The archive error codes are named after the action's own catalog.\nconst getArchiveErrorType = (error: UserScriptArchiveError): string => errorType[error.code];\n\nconst getProcessBuildFromZip = (qpqConfig: QPQConfig): ProcessorFor<typeof askUserScriptBuildFromZip> => {\n  return async (\n    payload: UserScriptBuildFromZipActionPayload,\n    session: StorySession,\n    actionProcessors: ActionProcessorList,\n    logger: QpqLogger,\n    updateSession: StorySessionUpdater,\n    dynamicModuleLoader: DynamicModuleLoader,\n    streamRegistry: StreamRegistry,\n  ) => {\n    const resolveStory = createNestedRuntime(\n      qpqConfig,\n      session,\n      actionProcessors,\n      getDateNow,\n      logger,\n      randomUUID,\n      QpqRuntimeType.EXECUTE_STORY,\n      dynamicModuleLoader,\n      undefined,\n      [],\n      streamRegistry,\n    );\n\n    const read = await resolveStory(() => askFileReadBinaryContents(payload.drive, payload.zipFilepath, payload.scope), []);\n    if (read.error) {\n      return actionResultError(READ_ERROR_TYPES[read.error.errorType] ?? read.error.errorType, read.error.errorText);\n    }\n\n    // The file actions give no size without the bytes, so the zip's own cap applies to\n    // what came back before anything is unpacked.\n    const zip = Buffer.from(read.result.base64Data, 'base64');\n    if (zip.length > USER_SCRIPT_SOURCE_LIMITS.maxBytes) {\n      return actionResultError(\n        errorType.SourceTooLarge,\n        `[${payload.drive}:${payload.zipFilepath}] is larger than ${USER_SCRIPT_SOURCE_LIMITS.maxBytes} bytes`,\n      );\n    }\n\n    // The service's own script modules, which the bundler keeps external. One that does not\n    // load is the service's fault, so it throws rather than failing the build.\n    const hostModules = await loadUserScriptHostModules(qpqConfig, dynamicModuleLoader);\n\n    let built: BuiltUserScript;\n    try {\n      built = await buildUserScriptInTempDir(\n        async (projectDir) => {\n          await extractUserScriptZip(zip, projectDir);\n        },\n        payload.sourceMap,\n        hostModules,\n      );\n    } catch (error) {\n      if (error instanceof UserScriptArchiveError) {\n        return actionResultError(getArchiveErrorType(error), `[${payload.drive}:${payload.zipFilepath}] ${error.message}`);\n      }\n      if (error instanceof UserScriptBuildError) {\n        return actionResultError(getUserScriptBuildErrorType(error.code, errorType), error.message);\n      }\n      throw error;\n    }\n\n    const published = await resolveStory(() => askUserScriptPublishOutput(payload.drive, payload.outputFilepath, built.script, payload.scope), []);\n    if (published.error) {\n      return actionResultError(published.error.errorType, published.error.errorText);\n    }\n\n    // The output contract is judged where the script's top-level code cannot reach the host.\n    const checked = await resolveStory(() => askUserScriptCheckPublishedOutput(payload.drive, payload.outputFilepath, payload.scope, errorType), []);\n    if (checked.error) {\n      return actionResultError(checked.error.errorType, checked.error.errorText);\n    }\n\n    return actionResult({ exports: checked.result });\n  };\n};\n\nexport const getUserScriptBuildFromZipActionProcessor = createActionProcessor(askUserScriptBuildFromZip, getProcessBuildFromZip);\n"]}

package/lib/esm/actionProcessor/index.d.ts

@@ -0,0 +1,4 @@
+export * from './getUserScriptBuildActionProcessor';
+export * from './getUserScriptBuildActionProcessors';
+export * from './getUserScriptBuildFromZipActionProcessor';
+export * from './logic';

package/lib/esm/actionProcessor/index.js

@@ -0,0 +1,5 @@
+export * from './getUserScriptBuildActionProcessor';
+export * from './getUserScriptBuildActionProcessors';
+export * from './getUserScriptBuildFromZipActionProcessor';
+export * from './logic';
+//# sourceMappingURL=index.js.map

package/lib/esm/actionProcessor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actionProcessor/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,SAAS,CAAC","sourcesContent":["export * from './getUserScriptBuildActionProcessor';\nexport * from './getUserScriptBuildActionProcessors';\nexport * from './getUserScriptBuildFromZipActionProcessor';\nexport * from './logic';\n"]}

package/lib/esm/actionProcessor/logic/BuiltUserScript.d.ts

@@ -0,0 +1,4 @@
+/** A finished build, read back from disk, ready to publish to a drive. */
+export type BuiltUserScript = {
+    script: string;
+};

package/lib/esm/actionProcessor/logic/BuiltUserScript.js

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

package/lib/esm/actionProcessor/logic/BuiltUserScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuiltUserScript.js","sourceRoot":"","sources":["../../../../src/actionProcessor/logic/BuiltUserScript.ts"],"names":[],"mappings":"","sourcesContent":["/** A finished build, read back from disk, ready to publish to a drive. */\nexport type BuiltUserScript = {\n  // The built JavaScript, with its source map embedded when one was asked for.\n  script: string;\n};\n"]}

package/lib/esm/actionProcessor/logic/USER_SCRIPT_SOURCE_LIMITS.d.ts

@@ -0,0 +1,5 @@
+/** Caps on a script project pulled off a drive, so a build cannot exhaust the lambda it runs on. */
+export declare const USER_SCRIPT_SOURCE_LIMITS: {
+    readonly maxFiles: 200;
+    readonly maxBytes: number;
+};

package/lib/esm/actionProcessor/logic/USER_SCRIPT_SOURCE_LIMITS.js

@@ -0,0 +1,6 @@
+/** Caps on a script project pulled off a drive, so a build cannot exhaust the lambda it runs on. */
+export const USER_SCRIPT_SOURCE_LIMITS = {
+    maxFiles: 200,
+    maxBytes: 2 * 1024 * 1024,
+};
+//# sourceMappingURL=USER_SCRIPT_SOURCE_LIMITS.js.map

package/lib/esm/actionProcessor/logic/USER_SCRIPT_SOURCE_LIMITS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"USER_SCRIPT_SOURCE_LIMITS.js","sourceRoot":"","sources":["../../../../src/actionProcessor/logic/USER_SCRIPT_SOURCE_LIMITS.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;CACjB,CAAC","sourcesContent":["/** Caps on a script project pulled off a drive, so a build cannot exhaust the lambda it runs on. */\nexport const USER_SCRIPT_SOURCE_LIMITS = {\n  maxFiles: 200,\n  maxBytes: 2 * 1024 * 1024,\n} as const;\n"]}

package/lib/esm/actionProcessor/logic/UserScriptArchiveError.d.ts

@@ -0,0 +1,10 @@
+export declare enum UserScriptArchiveErrorCode {
+    InvalidArchive = "InvalidArchive",
+    UnsafeArchiveEntry = "UnsafeArchiveEntry",
+    SourceTooLarge = "SourceTooLarge"
+}
+/** Thrown by extractUserScriptZip; `code` names which rule the archive broke. */
+export declare class UserScriptArchiveError extends Error {
+    readonly code: UserScriptArchiveErrorCode;
+    constructor(code: UserScriptArchiveErrorCode, message: string);
+}

package/lib/esm/actionProcessor/logic/UserScriptArchiveError.js

@@ -0,0 +1,19 @@
+export var UserScriptArchiveErrorCode;
+(function (UserScriptArchiveErrorCode) {
+    // Not a zip this runtime can read, or an entry is encrypted or corrupt.
+    UserScriptArchiveErrorCode["InvalidArchive"] = "InvalidArchive";
+    // An entry path would escape the project, or an entry is a symlink.
+    UserScriptArchiveErrorCode["UnsafeArchiveEntry"] = "UnsafeArchiveEntry";
+    // Too many files, too many unpacked bytes, or a node_modules folder.
+    UserScriptArchiveErrorCode["SourceTooLarge"] = "SourceTooLarge";
+})(UserScriptArchiveErrorCode || (UserScriptArchiveErrorCode = {}));
+/** Thrown by extractUserScriptZip; `code` names which rule the archive broke. */
+export class UserScriptArchiveError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'UserScriptArchiveError';
+    }
+}
+//# sourceMappingURL=UserScriptArchiveError.js.map

package/lib/esm/actionProcessor/logic/UserScriptArchiveError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserScriptArchiveError.js","sourceRoot":"","sources":["../../../../src/actionProcessor/logic/UserScriptArchiveError.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,0BAOX;AAPD,WAAY,0BAA0B;IACpC,wEAAwE;IACxE,+DAAiC,CAAA;IACjC,oEAAoE;IACpE,uEAAyC,CAAA;IACzC,qEAAqE;IACrE,+DAAiC,CAAA;AACnC,CAAC,EAPW,0BAA0B,KAA1B,0BAA0B,QAOrC;AAED,iFAAiF;AACjF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAE7B;IADlB,YACkB,IAAgC,EAChD,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAA4B;QAIhD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF","sourcesContent":["export enum UserScriptArchiveErrorCode {\n  // Not a zip this runtime can read, or an entry is encrypted or corrupt.\n  InvalidArchive = 'InvalidArchive',\n  // An entry path would escape the project, or an entry is a symlink.\n  UnsafeArchiveEntry = 'UnsafeArchiveEntry',\n  // Too many files, too many unpacked bytes, or a node_modules folder.\n  SourceTooLarge = 'SourceTooLarge',\n}\n\n/** Thrown by extractUserScriptZip; `code` names which rule the archive broke. */\nexport class UserScriptArchiveError extends Error {\n  constructor(\n    public readonly code: UserScriptArchiveErrorCode,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'UserScriptArchiveError';\n  }\n}\n"]}

package/lib/esm/actionProcessor/logic/UserScriptSourceFile.d.ts

@@ -0,0 +1,5 @@
+/** One file of a script project pulled off a drive: its path relative to the project root, and its text. */
+export type UserScriptSourceFile = {
+    path: string;
+    text: string;
+};

package/lib/esm/actionProcessor/logic/UserScriptSourceFile.js

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

package/lib/esm/actionProcessor/logic/UserScriptSourceFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserScriptSourceFile.js","sourceRoot":"","sources":["../../../../src/actionProcessor/logic/UserScriptSourceFile.ts"],"names":[],"mappings":"","sourcesContent":["/** One file of a script project pulled off a drive: its path relative to the project root, and its text. */\nexport type UserScriptSourceFile = {\n  path: string;\n  text: string;\n};\n"]}

package/lib/esm/actionProcessor/logic/askUserScriptCheckPublishedOutput.d.ts

@@ -0,0 +1,8 @@
+import { AskResponse } from '@qpqjs/core';
+import { UserScriptBuildErrorCatalog } from './getUserScriptBuildErrorType';
+/**
+ * The output contract for a platform build, judged inside the sandbox: the runner loads the
+ * published file and reports its exports, and the rule is applied here. A load failure is the
+ * build's fault (BuildFailed); a runner failure keeps its own type.
+ */
+export declare function askUserScriptCheckPublishedOutput(drive: string, filepath: string, scope: string | undefined, errorType: UserScriptBuildErrorCatalog): AskResponse<string[]>;

package/lib/esm/actionProcessor/logic/askUserScriptCheckPublishedOutput.js

@@ -0,0 +1,27 @@
+import { askCatch, askThrowError, askUserScriptListExports } from '@qpqjs/core';
+import { assertUserScriptExports } from '../../build/assertUserScriptExports';
+import { UserScriptBuildError } from '../../build/UserScriptBuildError';
+/**
+ * The output contract for a platform build, judged inside the sandbox: the runner loads the
+ * published file and reports its exports, and the rule is applied here. A load failure is the
+ * build's fault (BuildFailed); a runner failure keeps its own type.
+ */
+export function* askUserScriptCheckPublishedOutput(drive, filepath, scope, errorType) {
+    const listed = yield* askCatch(askUserScriptListExports(drive, filepath, scope));
+    if (!listed.success) {
+        const loadFailed = listed.error.errorType === askUserScriptListExports.errorType.ModuleNotFound ||
+            listed.error.errorType === askUserScriptListExports.errorType.ScriptInvalid;
+        return yield* askThrowError(loadFailed ? errorType.BuildFailed : listed.error.errorType, listed.error.errorText);
+    }
+    try {
+        return assertUserScriptExports(filepath, listed.result);
+    }
+    catch (error) {
+        if (error instanceof UserScriptBuildError) {
+            const code = error.code;
+            return yield* askThrowError(errorType[code], error.message);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=askUserScriptCheckPublishedOutput.js.map

package/lib/esm/actionProcessor/logic/askUserScriptCheckPublishedOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUserScriptCheckPublishedOutput.js","sourceRoot":"","sources":["../../../../src/actionProcessor/logic/askUserScriptCheckPublishedOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,aAAa,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAA4B,MAAM,kCAAkC,CAAC;AAGlG;;;;GAIG;AACH,MAAM,SAAS,CAAC,CAAC,iCAAiC,CAChD,KAAa,EACb,QAAgB,EAChB,KAAyB,EACzB,SAAsC;IAEtC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACjF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,UAAU,GACd,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,wBAAwB,CAAC,SAAS,CAAC,cAAc;YAC5E,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,wBAAwB,CAAC,SAAS,CAAC,aAAa,CAAC;QAC9E,OAAO,KAAK,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnH,CAAC;IAED,IAAI,CAAC;QACH,OAAO,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAuF,CAAC;YAC3G,OAAO,KAAK,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import { askCatch, AskResponse, askThrowError, askUserScriptListExports } from '@qpqjs/core';\n\nimport { assertUserScriptExports } from '../../build/assertUserScriptExports';\nimport { UserScriptBuildError, UserScriptBuildErrorCode } from '../../build/UserScriptBuildError';\nimport { UserScriptBuildErrorCatalog } from './getUserScriptBuildErrorType';\n\n/**\n * The output contract for a platform build, judged inside the sandbox: the runner loads the\n * published file and reports its exports, and the rule is applied here. A load failure is the\n * build's fault (BuildFailed); a runner failure keeps its own type.\n */\nexport function* askUserScriptCheckPublishedOutput(\n  drive: string,\n  filepath: string,\n  scope: string | undefined,\n  errorType: UserScriptBuildErrorCatalog,\n): AskResponse<string[]> {\n  const listed = yield* askCatch(askUserScriptListExports(drive, filepath, scope));\n  if (!listed.success) {\n    const loadFailed =\n      listed.error.errorType === askUserScriptListExports.errorType.ModuleNotFound ||\n      listed.error.errorType === askUserScriptListExports.errorType.ScriptInvalid;\n    return yield* askThrowError(loadFailed ? errorType.BuildFailed : listed.error.errorType, listed.error.errorText);\n  }\n\n  try {\n    return assertUserScriptExports(filepath, listed.result);\n  } catch (error) {\n    if (error instanceof UserScriptBuildError) {\n      const code = error.code as UserScriptBuildErrorCode.NoExports | UserScriptBuildErrorCode.NonFunctionExport;\n      return yield* askThrowError(errorType[code], error.message);\n    }\n    throw error;\n  }\n}\n"]}

package/lib/esm/actionProcessor/logic/askUserScriptCollectSource.d.ts

@@ -0,0 +1,9 @@
+import { AskResponse } from '@qpqjs/core';
+import { UserScriptSourceFile } from './UserScriptSourceFile';
+/**
+ * Reads a script project off a drive: every file under `sourceDirectory`, recursively, as
+ * text with paths relative to the project root. Refuses a node_modules folder and enforces
+ * USER_SCRIPT_SOURCE_LIMITS, both as the build action's SourceTooLarge. Listing and read
+ * failures propagate with their own types for the processor to re-label.
+ */
+export declare function askUserScriptCollectSource(drive: string, sourceDirectory: string, scope?: string): AskResponse<UserScriptSourceFile[]>;

package/lib/esm/actionProcessor/logic/askUserScriptCollectSource.js

@@ -0,0 +1,50 @@
+import { askFileListAllDirectory, askFileReadTextContents, askThrowError, askUserScriptBuild } from '@qpqjs/core';
+import { USER_SCRIPT_SOURCE_LIMITS } from './USER_SCRIPT_SOURCE_LIMITS';
+const REFUSED_DIRECTORY = 'node_modules';
+const trimSlashes = (directory) => directory.replace(/^\/+|\/+$/g, '');
+const toProjectRelative = (sourceDirectory, filepath) => {
+    const prefix = `${sourceDirectory}/`;
+    return filepath.startsWith(prefix) ? filepath.slice(prefix.length) : filepath;
+};
+/**
+ * Reads a script project off a drive: every file under `sourceDirectory`, recursively, as
+ * text with paths relative to the project root. Refuses a node_modules folder and enforces
+ * USER_SCRIPT_SOURCE_LIMITS, both as the build action's SourceTooLarge. Listing and read
+ * failures propagate with their own types for the processor to re-label.
+ */
+export function* askUserScriptCollectSource(drive, sourceDirectory, scope) {
+    const root = trimSlashes(sourceDirectory);
+    const pending = [root];
+    const filePaths = [];
+    while (pending.length > 0) {
+        const directory = pending.shift();
+        const entries = yield* askFileListAllDirectory(drive, directory, scope);
+        for (const entry of entries) {
+            const relative = toProjectRelative(root, entry.filepath);
+            if (relative.split('/').includes(REFUSED_DIRECTORY)) {
+                return yield* askThrowError(askUserScriptBuild.errorType.SourceTooLarge, `[${drive}:${root}] contains a ${REFUSED_DIRECTORY} folder; dependencies are not supported in a user script yet`);
+            }
+            if (entry.isDir) {
+                pending.push(trimSlashes(entry.filepath));
+            }
+            else {
+                filePaths.push(entry.filepath);
+            }
+        }
+        if (filePaths.length > USER_SCRIPT_SOURCE_LIMITS.maxFiles) {
+            return yield* askThrowError(askUserScriptBuild.errorType.SourceTooLarge, `[${drive}:${root}] has more than ${USER_SCRIPT_SOURCE_LIMITS.maxFiles} files`);
+        }
+    }
+    const files = [];
+    let totalBytes = 0;
+    for (const filepath of filePaths) {
+        const text = yield* askFileReadTextContents(drive, filepath, scope);
+        totalBytes += Buffer.byteLength(text, 'utf8');
+        if (totalBytes > USER_SCRIPT_SOURCE_LIMITS.maxBytes) {
+            return yield* askThrowError(askUserScriptBuild.errorType.SourceTooLarge, `[${drive}:${root}] is larger than ${USER_SCRIPT_SOURCE_LIMITS.maxBytes} bytes`);
+        }
+        files.push({ path: toProjectRelative(root, filepath), text });
+    }
+    return files;
+}
+//# sourceMappingURL=askUserScriptCollectSource.js.map

package/lib/esm/actionProcessor/logic/askUserScriptCollectSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUserScriptCollectSource.js","sourceRoot":"","sources":["../../../../src/actionProcessor/logic/askUserScriptCollectSource.ts"],"names":[],"mappings":"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","sourcesContent":["import { askFileListAllDirectory, askFileReadTextContents, AskResponse, askThrowError, askUserScriptBuild } from '@qpqjs/core';\n\nimport { USER_SCRIPT_SOURCE_LIMITS } from './USER_SCRIPT_SOURCE_LIMITS';\nimport { UserScriptSourceFile } from './UserScriptSourceFile';\n\nconst REFUSED_DIRECTORY = 'node_modules';\n\nconst trimSlashes = (directory: string): string => directory.replace(/^\\/+|\\/+$/g, '');\n\nconst toProjectRelative = (sourceDirectory: string, filepath: string): string => {\n  const prefix = `${sourceDirectory}/`;\n  return filepath.startsWith(prefix) ? filepath.slice(prefix.length) : filepath;\n};\n\n/**\n * Reads a script project off a drive: every file under `sourceDirectory`, recursively, as\n * text with paths relative to the project root. Refuses a node_modules folder and enforces\n * USER_SCRIPT_SOURCE_LIMITS, both as the build action's SourceTooLarge. Listing and read\n * failures propagate with their own types for the processor to re-label.\n */\nexport function* askUserScriptCollectSource(drive: string, sourceDirectory: string, scope?: string): AskResponse<UserScriptSourceFile[]> {\n  const root = trimSlashes(sourceDirectory);\n  const pending: string[] = [root];\n  const filePaths: string[] = [];\n\n  while (pending.length > 0) {\n    const directory = pending.shift() as string;\n    const entries = yield* askFileListAllDirectory(drive, directory, scope);\n\n    for (const entry of entries) {\n      const relative = toProjectRelative(root, entry.filepath);\n      if (relative.split('/').includes(REFUSED_DIRECTORY)) {\n        return yield* askThrowError(\n          askUserScriptBuild.errorType.SourceTooLarge,\n          `[${drive}:${root}] contains a ${REFUSED_DIRECTORY} folder; dependencies are not supported in a user script yet`,\n        );\n      }\n\n      if (entry.isDir) {\n        pending.push(trimSlashes(entry.filepath));\n      } else {\n        filePaths.push(entry.filepath);\n      }\n    }\n\n    if (filePaths.length > USER_SCRIPT_SOURCE_LIMITS.maxFiles) {\n      return yield* askThrowError(\n        askUserScriptBuild.errorType.SourceTooLarge,\n        `[${drive}:${root}] has more than ${USER_SCRIPT_SOURCE_LIMITS.maxFiles} files`,\n      );\n    }\n  }\n\n  const files: UserScriptSourceFile[] = [];\n  let totalBytes = 0;\n  for (const filepath of filePaths) {\n    const text = yield* askFileReadTextContents(drive, filepath, scope);\n    totalBytes += Buffer.byteLength(text, 'utf8');\n    if (totalBytes > USER_SCRIPT_SOURCE_LIMITS.maxBytes) {\n      return yield* askThrowError(\n        askUserScriptBuild.errorType.SourceTooLarge,\n        `[${drive}:${root}] is larger than ${USER_SCRIPT_SOURCE_LIMITS.maxBytes} bytes`,\n      );\n    }\n    files.push({ path: toProjectRelative(root, filepath), text });\n  }\n\n  return files;\n}\n"]}

package/lib/esm/actionProcessor/logic/askUserScriptPublishOutput.d.ts

@@ -0,0 +1,3 @@
+import { AskResponse } from '@qpqjs/core';
+/** Writes a built script to exactly `outputFilepath` on a drive; a build publishes nothing else. */
+export declare function askUserScriptPublishOutput(drive: string, outputFilepath: string, script: string, scope?: string): AskResponse<void>;

package/lib/esm/actionProcessor/logic/askUserScriptPublishOutput.js

@@ -0,0 +1,6 @@
+import { askFileWriteTextContents } from '@qpqjs/core';
+/** Writes a built script to exactly `outputFilepath` on a drive; a build publishes nothing else. */
+export function* askUserScriptPublishOutput(drive, outputFilepath, script, scope) {
+    yield* askFileWriteTextContents(drive, outputFilepath, script, undefined, scope);
+}
+//# sourceMappingURL=askUserScriptPublishOutput.js.map

package/lib/esm/actionProcessor/logic/askUserScriptPublishOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUserScriptPublishOutput.js","sourceRoot":"","sources":["../../../../src/actionProcessor/logic/askUserScriptPublishOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAe,MAAM,aAAa,CAAC;AAEpE,oGAAoG;AACpG,MAAM,SAAS,CAAC,CAAC,0BAA0B,CAAC,KAAa,EAAE,cAAsB,EAAE,MAAc,EAAE,KAAc;IAC/G,KAAK,CAAC,CAAC,wBAAwB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AACnF,CAAC","sourcesContent":["import { askFileWriteTextContents, AskResponse } from '@qpqjs/core';\n\n/** Writes a built script to exactly `outputFilepath` on a drive; a build publishes nothing else. */\nexport function* askUserScriptPublishOutput(drive: string, outputFilepath: string, script: string, scope?: string): AskResponse<void> {\n  yield* askFileWriteTextContents(drive, outputFilepath, script, undefined, scope);\n}\n"]}

package/lib/esm/actionProcessor/logic/buildUserScriptInTempDir.d.ts

@@ -0,0 +1,9 @@
+import { UserScriptModuleMap } from '@qpqjs/actionprocessor-node';
+import { BuiltUserScript } from './BuiltUserScript';
+/**
+ * The part of a platform build that is the same whatever the source is: a temp project
+ * directory that `materialise` fills, the build, the output read back, and the temp
+ * directory removed whatever happened. Errors from `materialise` and from the build
+ * propagate for the caller to map.
+ */
+export declare const buildUserScriptInTempDir: (materialise: (projectDir: string) => Promise<void> | void, sourceMap: boolean, hostModules: UserScriptModuleMap) => Promise<BuiltUserScript>;

package/lib/esm/actionProcessor/logic/buildUserScriptInTempDir.js

@@ -0,0 +1,25 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { buildUserScript } from '../../build/buildUserScript';
+/**
+ * The part of a platform build that is the same whatever the source is: a temp project
+ * directory that `materialise` fills, the build, the output read back, and the temp
+ * directory removed whatever happened. Errors from `materialise` and from the build
+ * propagate for the caller to map.
+ */
+export const buildUserScriptInTempDir = async (materialise, sourceMap, hostModules) => {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'qpq-user-script-'));
+    const projectDir = path.join(tempDir, 'project');
+    const outDir = path.join(tempDir, 'out');
+    try {
+        fs.mkdirSync(projectDir, { recursive: true });
+        await materialise(projectDir);
+        const result = await buildUserScript({ projectDir, outDir, sourceMap, hostModules });
+        return { script: fs.readFileSync(result.entryPath, 'utf8') };
+    }
+    finally {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+};
+//# sourceMappingURL=buildUserScriptInTempDir.js.map

package/lib/esm/actionProcessor/logic/buildUserScriptInTempDir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildUserScriptInTempDir.js","sourceRoot":"","sources":["../../../../src/actionProcessor/logic/buildUserScriptInTempDir.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAC3C,WAAyD,EACzD,SAAkB,EAClB,WAAgC,EACN,EAAE;IAC5B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAEzC,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAErF,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;IAC/D,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC,CAAC","sourcesContent":["import { UserScriptModuleMap } from '@qpqjs/actionprocessor-node';\n\nimport fs from 'fs';\nimport os from 'os';\nimport path from 'path';\n\nimport { buildUserScript } from '../../build/buildUserScript';\nimport { BuiltUserScript } from './BuiltUserScript';\n\n/**\n * The part of a platform build that is the same whatever the source is: a temp project\n * directory that `materialise` fills, the build, the output read back, and the temp\n * directory removed whatever happened. Errors from `materialise` and from the build\n * propagate for the caller to map.\n */\nexport const buildUserScriptInTempDir = async (\n  materialise: (projectDir: string) => Promise<void> | void,\n  sourceMap: boolean,\n  hostModules: UserScriptModuleMap,\n): Promise<BuiltUserScript> => {\n  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'qpq-user-script-'));\n  const projectDir = path.join(tempDir, 'project');\n  const outDir = path.join(tempDir, 'out');\n\n  try {\n    fs.mkdirSync(projectDir, { recursive: true });\n    await materialise(projectDir);\n    const result = await buildUserScript({ projectDir, outDir, sourceMap, hostModules });\n\n    return { script: fs.readFileSync(result.entryPath, 'utf8') };\n  } finally {\n    fs.rmSync(tempDir, { recursive: true, force: true });\n  }\n};\n"]}

package/lib/esm/actionProcessor/logic/extractUserScriptZip.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unpacks a user-controlled zip into the project directory under the same rules as a
+ * directory build: plain relative paths only, no symlinks, no node_modules, at most
+ * USER_SCRIPT_SOURCE_LIMITS files and unpacked bytes counted as they are written (the
+ * sizes in the zip's headers are never trusted). Directory entries are ignored; folders
+ * come from file paths. Returns the project-relative paths written.
+ */
+export declare const extractUserScriptZip: (zip: Buffer, projectDir: string) => Promise<string[]>;