@automattic/vip 4.1.6 → 4.1.8

package/dist/lib/edge-workers/deployment.js

@@ -1,190 +1,181 @@
 "use strict";
-
-exports.__esModule = true;
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeploymentApplyError = void 0;
-exports.applyEdgeWorkerDeploymentPlan = applyEdgeWorkerDeploymentPlan;
-exports.deploymentPlanRows = deploymentPlanRows;
 exports.prepareEdgeWorkerDeploymentPlan = prepareEdgeWorkerDeploymentPlan;
-var _edgeWorkers = require("../api/edge-workers");
-var _userError = _interopRequireDefault(require("../user-error"));
-var _index = require("./index");
-var _output = require("./output");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+exports.deploymentPlanRows = deploymentPlanRows;
+exports.applyEdgeWorkerDeploymentPlan = applyEdgeWorkerDeploymentPlan;
+const edge_workers_1 = require("../api/edge-workers");
+const user_error_1 = __importDefault(require("../user-error"));
+const index_1 = require("./index");
+const output_1 = require("./output");
 class DeploymentApplyError extends Error {
-  appliedNames;
-  failedName;
-  unappliedNames;
-  stage;
-  uploadCompleted;
-  activeAfterUpload;
-  constructor(appliedNames, failedName, unappliedNames, cause, state) {
-    super(`Failed to apply edge worker "${failedName}".`, {
-      cause
-    });
-    this.name = 'DeploymentApplyError';
-    this.appliedNames = appliedNames;
-    this.failedName = failedName;
-    this.unappliedNames = unappliedNames;
-    this.stage = state.stage;
-    this.uploadCompleted = state.uploadCompleted;
-    this.activeAfterUpload = state.activeAfterUpload;
-  }
+    appliedNames;
+    failedName;
+    unappliedNames;
+    stage;
+    uploadCompleted;
+    activeAfterUpload;
+    constructor(appliedNames, failedName, unappliedNames, cause, state) {
+        super(`Failed to apply edge worker "${failedName}".`, { cause });
+        this.name = 'DeploymentApplyError';
+        this.appliedNames = appliedNames;
+        this.failedName = failedName;
+        this.unappliedNames = unappliedNames;
+        this.stage = state.stage;
+        this.uploadCompleted = state.uploadCompleted;
+        this.activeAfterUpload = state.activeAfterUpload;
+    }
 }
 exports.DeploymentApplyError = DeploymentApplyError;
 function prepareArtifact(options, worker) {
-  if (options.skipBuild) {
-    return (0, _index.readPrebuiltWorker)(options.projectDir, worker);
-  }
-  return (0, _index.buildWorker)(options.projectDir, worker);
+    if (options.skipBuild) {
+        return (0, index_1.readPrebuiltWorker)(options.projectDir, worker);
+    }
+    return (0, index_1.buildWorker)(options.projectDir, worker);
 }
 async function prepareValidation(options, worker, artifact) {
-  if (options.skipValidate) {
-    return {
-      validation: 'skipped',
-      phases: []
-    };
-  }
-  const result = await (0, _edgeWorkers.validateEdgeWorker)(options.envId, artifact.base64);
-  if (result.valid !== true) {
-    const errors = result.errors.join('; ') || 'unknown error';
-    throw new _userError.default(`worker "${worker.manifest.name}" failed validation: ${errors}`);
-  }
-  return {
-    validation: 'passed',
-    phases: result.phases
-  };
+    if (options.skipValidate) {
+        return { validation: 'skipped', phases: [] };
+    }
+    const result = await (0, edge_workers_1.validateEdgeWorker)(options.envId, artifact.base64);
+    if (result.valid !== true) {
+        const errors = result.errors.join('; ') || 'unknown error';
+        throw new user_error_1.default(`worker "${worker.manifest.name}" failed validation: ${errors}`);
+    }
+    return { validation: 'passed', phases: result.phases };
 }
 function proposedLocationFor(worker, existing, hasLocation, currentLocation) {
-  if (!existing) {
+    if (!existing) {
+        return worker.manifest.location ?? null;
+    }
+    if (!hasLocation) {
+        return currentLocation;
+    }
     return worker.manifest.location ?? null;
-  }
-  if (!hasLocation) {
-    return currentLocation;
-  }
-  return worker.manifest.location ?? null;
 }
 function prepareInput(worker, existing, artifact, source, hasLocation) {
-  const input = {
-    name: worker.manifest.name,
-    wasmBinary: artifact.base64
-  };
-  if (worker.manifest.on_failure) {
-    input.onFailure = worker.manifest.on_failure;
-  }
-  if (source !== undefined) {
-    input.source = source;
-  }
-  if (existing && hasLocation) {
-    input.location = worker.manifest.location ?? null;
-  } else if (!existing && worker.manifest.location) {
-    input.location = worker.manifest.location;
-  }
-  return input;
+    const input = {
+        name: worker.manifest.name,
+        wasmBinary: artifact.base64,
+    };
+    if (worker.manifest.on_failure) {
+        input.onFailure = worker.manifest.on_failure;
+    }
+    if (source !== undefined) {
+        input.source = source;
+    }
+    if (existing && hasLocation) {
+        input.location = worker.manifest.location ?? null;
+    }
+    else if (!existing && worker.manifest.location) {
+        input.location = worker.manifest.location;
+    }
+    return input;
 }
 function sourceModeFor(skipSource, existing) {
-  if (!skipSource) {
-    return 'store';
-  }
-  return existing ? 'preserve' : 'omit';
+    if (!skipSource) {
+        return 'store';
+    }
+    return existing ? 'preserve' : 'omit';
 }
 async function preparePlanItem(options, worker, existing) {
-  const artifact = prepareArtifact(options, worker);
-  const {
-    validation,
-    phases
-  } = await prepareValidation(options, worker, artifact);
-  const source = options.skipSource ? undefined : (0, _index.readWorkerSource)(worker);
-  const hasLocation = Object.hasOwn(worker.manifest, 'location');
-  const currentLocation = existing?.location ?? null;
-  const intendedActive = options.enableAfterDeploy || Boolean(existing?.active);
-  return {
-    action: existing ? 'update' : 'create',
-    worker,
-    existing,
-    artifact,
-    validation,
-    phases,
-    input: prepareInput(worker, existing, artifact, source, hasLocation),
-    currentLocation,
-    proposedLocation: proposedLocationFor(worker, existing, hasLocation, currentLocation),
-    sourceMode: sourceModeFor(options.skipSource, existing),
-    enableAfterDeploy: options.enableAfterDeploy,
-    intendedActive
-  };
+    const artifact = prepareArtifact(options, worker);
+    const { validation, phases } = await prepareValidation(options, worker, artifact);
+    const source = options.skipSource ? undefined : (0, index_1.readWorkerSource)(worker);
+    const hasLocation = Object.hasOwn(worker.manifest, 'location');
+    const currentLocation = existing?.location ?? null;
+    const intendedActive = options.enableAfterDeploy || Boolean(existing?.active);
+    return {
+        action: existing ? 'update' : 'create',
+        worker,
+        existing,
+        artifact,
+        validation,
+        phases,
+        input: prepareInput(worker, existing, artifact, source, hasLocation),
+        currentLocation,
+        proposedLocation: proposedLocationFor(worker, existing, hasLocation, currentLocation),
+        sourceMode: sourceModeFor(options.skipSource, existing),
+        enableAfterDeploy: options.enableAfterDeploy,
+        intendedActive,
+    };
 }
 async function prepareEdgeWorkerDeploymentPlan(options) {
-  const remoteWorkers = await (0, _edgeWorkers.listEdgeWorkers)(options.appId, options.envId);
-  const remoteWorkersByName = new Map(remoteWorkers.map(worker => [worker.name, worker]));
-  const items = [];
-  for (const worker of options.workers) {
-    const existing = remoteWorkersByName.get(worker.manifest.name) ?? null;
-    // eslint-disable-next-line no-await-in-loop
-    items.push(await preparePlanItem(options, worker, existing));
-  }
-  return items;
+    const remoteWorkers = await (0, edge_workers_1.listEdgeWorkers)(options.appId, options.envId);
+    const remoteWorkersByName = new Map(remoteWorkers.map(worker => [worker.name, worker]));
+    const items = [];
+    for (const worker of options.workers) {
+        const existing = remoteWorkersByName.get(worker.manifest.name) ?? null;
+        // eslint-disable-next-line no-await-in-loop
+        items.push(await preparePlanItem(options, worker, existing));
+    }
+    return items;
 }
 function formatLocation(location) {
-  return location ? `${(0, _output.escapeTerminalText)(location.operator)} "${(0, _output.escapeTerminalText)(location.value)}"` : 'all requests';
+    return location
+        ? `${(0, output_1.escapeTerminalText)(location.operator)} "${(0, output_1.escapeTerminalText)(location.value)}"`
+        : 'all requests';
 }
 function currentActiveLabel(item) {
-  if (!item.existing) {
-    return 'new';
-  }
-  return item.existing.active ? 'active' : 'inactive';
+    if (!item.existing) {
+        return 'new';
+    }
+    return item.existing.active ? 'active' : 'inactive';
 }
 function deploymentPlanRows(items) {
-  return items.map(item => ({
-    worker: (0, _output.escapeTerminalText)(item.worker.manifest.name),
-    action: item.action,
-    current_active: currentActiveLabel(item),
-    final_active: item.intendedActive ? 'active' : 'inactive',
-    current_scope: formatLocation(item.currentLocation),
-    proposed_scope: formatLocation(item.proposedLocation),
-    validation: item.validation,
-    phases: item.phases.map(_output.escapeTerminalText).join(', ') || 'none',
-    bytes: String(item.artifact.sizeBytes),
-    source: item.sourceMode
-  }));
+    return items.map(item => ({
+        worker: (0, output_1.escapeTerminalText)(item.worker.manifest.name),
+        action: item.action,
+        current_active: currentActiveLabel(item),
+        final_active: item.intendedActive ? 'active' : 'inactive',
+        current_scope: formatLocation(item.currentLocation),
+        proposed_scope: formatLocation(item.proposedLocation),
+        validation: item.validation,
+        phases: item.phases.map(output_1.escapeTerminalText).join(', ') || 'none',
+        bytes: String(item.artifact.sizeBytes),
+        source: item.sourceMode,
+    }));
 }
 async function applyPlanItem(envId, item) {
-  if (item.action === 'create') {
-    return (0, _edgeWorkers.createEdgeWorker)(envId, item.input);
-  }
-  if (!item.existing) {
-    throw new Error(`Update plan for "${item.worker.manifest.name}" has no existing worker.`);
-  }
-  return (0, _edgeWorkers.updateEdgeWorker)(envId, item.existing.id, item.input);
+    if (item.action === 'create') {
+        return (0, edge_workers_1.createEdgeWorker)(envId, item.input);
+    }
+    if (!item.existing) {
+        throw new Error(`Update plan for "${item.worker.manifest.name}" has no existing worker.`);
+    }
+    return (0, edge_workers_1.updateEdgeWorker)(envId, item.existing.id, item.input);
 }
 async function applyEdgeWorkerDeploymentPlan(envId, items, onApplied) {
-  const appliedNames = [];
-  for (const [index, item] of items.entries()) {
-    const name = item.worker.manifest.name;
-    let result;
-    try {
-      // eslint-disable-next-line no-await-in-loop
-      result = await applyPlanItem(envId, item);
-    } catch (cause) {
-      throw new DeploymentApplyError([...appliedNames], name, items.slice(index + 1).map(remaining => remaining.worker.manifest.name), cause, {
-        stage: 'upload',
-        uploadCompleted: false,
-        activeAfterUpload: null
-      });
-    }
-    let finalResult = result;
-    if (item.enableAfterDeploy && !result.active) {
-      try {
+    const appliedNames = [];
+    for (const [index, item] of items.entries()) {
+        const name = item.worker.manifest.name;
+        let result;
+        try {
+            // eslint-disable-next-line no-await-in-loop
+            result = await applyPlanItem(envId, item);
+        }
+        catch (cause) {
+            throw new DeploymentApplyError([...appliedNames], name, items.slice(index + 1).map(remaining => remaining.worker.manifest.name), cause, { stage: 'upload', uploadCompleted: false, activeAfterUpload: null });
+        }
+        let finalResult = result;
+        if (item.enableAfterDeploy && !result.active) {
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                finalResult = await (0, edge_workers_1.setEdgeWorkerActive)(envId, result.id, true);
+            }
+            catch (cause) {
+                throw new DeploymentApplyError([...appliedNames], name, items.slice(index + 1).map(remaining => remaining.worker.manifest.name), cause, {
+                    stage: 'enable',
+                    uploadCompleted: true,
+                    activeAfterUpload: result.active,
+                });
+            }
+        }
+        appliedNames.push(name);
         // eslint-disable-next-line no-await-in-loop
-        finalResult = await (0, _edgeWorkers.setEdgeWorkerActive)(envId, result.id, true);
-      } catch (cause) {
-        throw new DeploymentApplyError([...appliedNames], name, items.slice(index + 1).map(remaining => remaining.worker.manifest.name), cause, {
-          stage: 'enable',
-          uploadCompleted: true,
-          activeAfterUpload: result.active
-        });
-      }
-    }
-    appliedNames.push(name);
-    // eslint-disable-next-line no-await-in-loop
-    await onApplied(item, finalResult);
-  }
-}
+        await onApplied(item, finalResult);
+    }
+}

package/dist/lib/edge-workers/index.js

@@ -1,100 +1,83 @@
 "use strict";
-
-exports.__esModule = true;
-var _exportNames = {
-  readPrebuiltWorker: true,
-  buildWorker: true,
-  readWorkerSource: true,
-  getToolchain: true
-};
-exports.buildWorker = buildWorker;
-exports.readPrebuiltWorker = readPrebuiltWorker;
-exports.readWorkerSource = readWorkerSource;
-var _nodeFs = _interopRequireDefault(require("node:fs"));
-var _userError = _interopRequireDefault(require("../user-error"));
-var _project = require("./project");
-Object.keys(_project).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _project[key]) return;
-  exports[key] = _project[key];
-});
-var _toolchains = require("./toolchains");
-exports.getToolchain = _toolchains.getToolchain;
-var _validation = require("./validation");
-Object.keys(_validation).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _validation[key]) return;
-  exports[key] = _validation[key];
-});
-var _types = require("./types");
-Object.keys(_types).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _types[key]) return;
-  exports[key] = _types[key];
-});
-var _location = require("./location");
-Object.keys(_location).forEach(function (key) {
-  if (key === "default" || key === "__esModule") return;
-  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _location[key]) return;
-  exports[key] = _location[key];
-});
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * Convenience entry point for the edge-workers lib: ties project resolution and
  * the toolchain together to produce a deployable artifact.
  */
-
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getToolchain = void 0;
+exports.readPrebuiltWorker = readPrebuiltWorker;
+exports.buildWorker = buildWorker;
+exports.readWorkerSource = readWorkerSource;
+const node_fs_1 = __importDefault(require("node:fs"));
+const user_error_1 = __importDefault(require("../user-error"));
+const project_1 = require("./project");
+const toolchains_1 = require("./toolchains");
+const validation_1 = require("./validation");
+__exportStar(require("./types"), exports);
+__exportStar(require("./project"), exports);
+__exportStar(require("./location"), exports);
+var toolchains_2 = require("./toolchains");
+Object.defineProperty(exports, "getToolchain", { enumerable: true, get: function () { return toolchains_2.getToolchain; } });
+__exportStar(require("./validation"), exports);
 function encodeArtifact(wasmPath) {
-  const buffer = _nodeFs.default.readFileSync(wasmPath);
-  return {
-    wasmPath,
-    base64: buffer.toString('base64'),
-    sizeBytes: buffer.length
-  };
+    const buffer = node_fs_1.default.readFileSync(wasmPath);
+    return { wasmPath, base64: buffer.toString('base64'), sizeBytes: buffer.length };
 }
-
 /** Read a previously compiled artifact without recompiling (used by `deploy --skip-build`). */
 function readPrebuiltWorker(projectDir, worker) {
-  const name = (0, _validation.validateWorkerName)(worker.manifest.name);
-  const buildRoot = (0, _validation.resolvePathWithin)(projectDir, _project.BUILD_DIR, 'Worker build directory');
-  const candidate = (0, _validation.resolvePathWithin)(buildRoot, `${name}.wasm`, 'Worker build artifact');
-  if (!_nodeFs.default.existsSync(candidate)) {
-    throw new _userError.default(`No compiled artifact found for "${worker.manifest.name}" at "${candidate}". ` + 'Run `vip edge-workers build` first, or deploy without `--skip-build`.');
-  }
-  if (_nodeFs.default.lstatSync(buildRoot).isSymbolicLink()) {
-    throw new _userError.default('Worker build directory must not be a symbolic link.');
-  }
-  if (_nodeFs.default.lstatSync(candidate).isSymbolicLink()) {
-    throw new _userError.default('Worker build artifact must not be a symbolic link.');
-  }
-  const canonicalBuildRoot = (0, _validation.resolveExistingPathWithin)(projectDir, _project.BUILD_DIR, 'Worker build directory');
-  const wasmPath = (0, _validation.resolveExistingPathWithin)(canonicalBuildRoot, `${name}.wasm`, 'Worker build artifact');
-  return encodeArtifact(wasmPath);
+    const name = (0, validation_1.validateWorkerName)(worker.manifest.name);
+    const buildRoot = (0, validation_1.resolvePathWithin)(projectDir, project_1.BUILD_DIR, 'Worker build directory');
+    const candidate = (0, validation_1.resolvePathWithin)(buildRoot, `${name}.wasm`, 'Worker build artifact');
+    if (!node_fs_1.default.existsSync(candidate)) {
+        throw new user_error_1.default(`No compiled artifact found for "${worker.manifest.name}" at "${candidate}". ` +
+            'Run `vip edge-workers build` first, or deploy without `--skip-build`.');
+    }
+    if (node_fs_1.default.lstatSync(buildRoot).isSymbolicLink()) {
+        throw new user_error_1.default('Worker build directory must not be a symbolic link.');
+    }
+    if (node_fs_1.default.lstatSync(candidate).isSymbolicLink()) {
+        throw new user_error_1.default('Worker build artifact must not be a symbolic link.');
+    }
+    const canonicalBuildRoot = (0, validation_1.resolveExistingPathWithin)(projectDir, project_1.BUILD_DIR, 'Worker build directory');
+    const wasmPath = (0, validation_1.resolveExistingPathWithin)(canonicalBuildRoot, `${name}.wasm`, 'Worker build artifact');
+    return encodeArtifact(wasmPath);
 }
-
 /** Compile a worker and return both the artifact path and its base64 encoding. */
 function buildWorker(projectDir, worker) {
-  const descriptor = (0, _project.readProjectDescriptor)(projectDir);
-  const toolchain = (0, _toolchains.getToolchain)(descriptor.type);
-  toolchain.ensureAvailable(projectDir);
-  const wasmPath = toolchain.compile(projectDir, worker);
-  return encodeArtifact(wasmPath);
+    const descriptor = (0, project_1.readProjectDescriptor)(projectDir);
+    const toolchain = (0, toolchains_1.getToolchain)(descriptor.type);
+    toolchain.ensureAvailable(projectDir);
+    const wasmPath = toolchain.compile(projectDir, worker);
+    return encodeArtifact(wasmPath);
 }
-
 /** Read the entry source of a worker, for storing alongside the binary. */
 function readWorkerSource(worker) {
-  const candidate = (0, _validation.resolvePathWithin)(worker.dir, worker.manifest.entry, 'Worker entry');
-  if (!_nodeFs.default.existsSync(candidate)) {
-    throw new _userError.default(`Could not read worker source at "${candidate}".`);
-  }
-  const entry = (0, _validation.resolveExistingPathWithin)(worker.dir, worker.manifest.entry, 'Worker entry');
-  try {
-    return _nodeFs.default.readFileSync(entry, 'utf8');
-  } catch {
-    throw new _userError.default(`Could not read worker source at "${entry}".`);
-  }
-}
+    const candidate = (0, validation_1.resolvePathWithin)(worker.dir, worker.manifest.entry, 'Worker entry');
+    if (!node_fs_1.default.existsSync(candidate)) {
+        throw new user_error_1.default(`Could not read worker source at "${candidate}".`);
+    }
+    const entry = (0, validation_1.resolveExistingPathWithin)(worker.dir, worker.manifest.entry, 'Worker entry');
+    try {
+        return node_fs_1.default.readFileSync(entry, 'utf8');
+    }
+    catch {
+        throw new user_error_1.default(`Could not read worker source at "${entry}".`);
+    }
+}

package/dist/lib/edge-workers/location.js

@@ -1,33 +1,33 @@
 "use strict";
-
-exports.__esModule = true;
-exports.parseLocationOption = parseLocationOption;
-var _userError = _interopRequireDefault(require("../user-error"));
-var _output = require("./output");
-var _types = require("./types");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * Parsing for location rules passed on the command line as
  * `<operator>:<value>` (e.g. `starts_with:/api/`). A location scopes which
  * request paths a worker runs on; workers without one run on all requests.
  */
-
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseLocationOption = parseLocationOption;
+const user_error_1 = __importDefault(require("../user-error"));
+const output_1 = require("./output");
+const types_1 = require("./types");
 function parseLocationOption(raw) {
-  // `--location` passed without a value arrives as a boolean, not a string;
-  // guard so we surface a clear error instead of a TypeError from `.indexOf()`.
-  if (typeof raw !== 'string') {
-    throw new _userError.default('The --location flag requires a value in the form "<operator>:<value>" ' + `(e.g. "starts_with:/api/"). Operators: ${_types.EDGE_WORKER_LOCATION_OPERATORS.join(', ')}.`);
-  }
-
-  // Split on the first colon only: the value may itself contain colons.
-  const separator = raw.indexOf(':');
-  const operator = separator > 0 ? raw.slice(0, separator) : '';
-  const value = separator > 0 ? raw.slice(separator + 1) : '';
-  if (!_types.EDGE_WORKER_LOCATION_OPERATORS.includes(operator) || !value || (0, _output.hasTerminalControlCharacters)(value)) {
-    throw new _userError.default(`Invalid location "${raw}". Use "<operator>:<value>", where <operator> is one of: ` + `${_types.EDGE_WORKER_LOCATION_OPERATORS.join(', ')} (e.g. "starts_with:/api/").`);
-  }
-  return {
-    operator: operator,
-    value
-  };
-}
+    // `--location` passed without a value arrives as a boolean, not a string;
+    // guard so we surface a clear error instead of a TypeError from `.indexOf()`.
+    if (typeof raw !== 'string') {
+        throw new user_error_1.default('The --location flag requires a value in the form "<operator>:<value>" ' +
+            `(e.g. "starts_with:/api/"). Operators: ${types_1.EDGE_WORKER_LOCATION_OPERATORS.join(', ')}.`);
+    }
+    // Split on the first colon only: the value may itself contain colons.
+    const separator = raw.indexOf(':');
+    const operator = separator > 0 ? raw.slice(0, separator) : '';
+    const value = separator > 0 ? raw.slice(separator + 1) : '';
+    if (!types_1.EDGE_WORKER_LOCATION_OPERATORS.includes(operator) ||
+        !value ||
+        (0, output_1.hasTerminalControlCharacters)(value)) {
+        throw new user_error_1.default(`Invalid location "${raw}". Use "<operator>:<value>", where <operator> is one of: ` +
+            `${types_1.EDGE_WORKER_LOCATION_OPERATORS.join(', ')} (e.g. "starts_with:/api/").`);
+    }
+    return { operator: operator, value };
+}

package/dist/lib/edge-workers/output.js

@@ -1,9 +1,8 @@
 "use strict";
-
-exports.__esModule = true;
-exports.escapeTerminalSource = escapeTerminalSource;
-exports.escapeTerminalText = escapeTerminalText;
+Object.defineProperty(exports, "__esModule", { value: true });
 exports.hasTerminalControlCharacters = hasTerminalControlCharacters;
+exports.escapeTerminalText = escapeTerminalText;
+exports.escapeTerminalSource = escapeTerminalSource;
 // C0, DEL, and C1 controls can alter terminal state or forge surrounding output.
 // eslint-disable-next-line no-control-regex
 const TERMINAL_CONTROL_CHARACTER = /[\u0000-\u001f\u007f-\u009f]/;
@@ -13,22 +12,22 @@ const TERMINAL_CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f]/g;
 // eslint-disable-next-line no-control-regex
 const SOURCE_CONTROL_CHARACTERS = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f]/g;
 function escapeControlCharacter(character) {
-  const codePoint = character.codePointAt(0);
-  if (codePoint === undefined) {
-    return '';
-  }
-  return String.raw`\u${codePoint.toString(16).padStart(4, '0')}`;
+    const codePoint = character.codePointAt(0);
+    if (codePoint === undefined) {
+        return '';
+    }
+    return String.raw `\u${codePoint.toString(16).padStart(4, '0')}`;
 }
 function hasTerminalControlCharacters(value) {
-  return TERMINAL_CONTROL_CHARACTER.test(value);
+    return TERMINAL_CONTROL_CHARACTER.test(value);
 }
-
 /** Render untrusted text without allowing it to emit terminal control characters. */
 function escapeTerminalText(value) {
-  return String(value).replace(TERMINAL_CONTROL_CHARACTERS, escapeControlCharacter);
+    return String(value).replace(TERMINAL_CONTROL_CHARACTERS, escapeControlCharacter);
 }
-
 /** Preserve source layout; normalize CRLF while escaping standalone carriage returns. */
 function escapeTerminalSource(value) {
-  return value.replace(/\r\n/g, '\n').replace(SOURCE_CONTROL_CHARACTERS, escapeControlCharacter);
-}
+    return value
+        .replace(/\r\n/g, '\n')
+        .replace(SOURCE_CONTROL_CHARACTERS, escapeControlCharacter);
+}