@automattic/vip 4.1.6 → 4.1.8

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

@@ -1,19 +1,4 @@
 "use strict";
-
-exports.__esModule = true;
-exports.WORKER_MANIFEST_FILE = exports.WORKERS_DIR = exports.PROJECT_DESCRIPTOR_FILE = exports.CONVENTIONAL_PROJECT_DIR = exports.BUILD_DIR = void 0;
-exports.discoverWorkers = discoverWorkers;
-exports.findWorker = findWorker;
-exports.readProjectDescriptor = readProjectDescriptor;
-exports.readWorkerManifest = readWorkerManifest;
-exports.resolveProjectDir = resolveProjectDir;
-exports.writeProjectDescriptor = writeProjectDescriptor;
-exports.writeWorkerManifest = writeWorkerManifest;
-var _nodeFs = _interopRequireDefault(require("node:fs"));
-var _nodePath = _interopRequireDefault(require("node:path"));
-var _userError = _interopRequireDefault(require("../user-error"));
-var _validation = require("./validation");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * Edge-workers project resolution and on-disk layout helpers.
  *
@@ -28,39 +13,54 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  *         worker.json          <- per-worker manifest
  *         assembly/index.ts    <- entry (toolchain-specific)
  */
-
-const PROJECT_DESCRIPTOR_FILE = exports.PROJECT_DESCRIPTOR_FILE = 'edge-workers.json';
-const WORKER_MANIFEST_FILE = exports.WORKER_MANIFEST_FILE = 'worker.json';
-const WORKERS_DIR = exports.WORKERS_DIR = 'workers';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONVENTIONAL_PROJECT_DIR = exports.BUILD_DIR = exports.WORKERS_DIR = exports.WORKER_MANIFEST_FILE = exports.PROJECT_DESCRIPTOR_FILE = void 0;
+exports.resolveProjectDir = resolveProjectDir;
+exports.readProjectDescriptor = readProjectDescriptor;
+exports.writeProjectDescriptor = writeProjectDescriptor;
+exports.readWorkerManifest = readWorkerManifest;
+exports.writeWorkerManifest = writeWorkerManifest;
+exports.discoverWorkers = discoverWorkers;
+exports.findWorker = findWorker;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const user_error_1 = __importDefault(require("../user-error"));
+const validation_1 = require("./validation");
+exports.PROJECT_DESCRIPTOR_FILE = 'edge-workers.json';
+exports.WORKER_MANIFEST_FILE = 'worker.json';
+exports.WORKERS_DIR = 'workers';
 /** Conventional output directory for compiled artifacts, relative to the project root. */
-const BUILD_DIR = exports.BUILD_DIR = 'build';
+exports.BUILD_DIR = 'build';
 /** Conventional subfolder checked when resolving from a site-repo root. */
-const CONVENTIONAL_PROJECT_DIR = exports.CONVENTIONAL_PROJECT_DIR = 'edge-workers';
+exports.CONVENTIONAL_PROJECT_DIR = 'edge-workers';
 function isProjectRoot(dir) {
-  return _nodeFs.default.existsSync(_nodePath.default.join(dir, PROJECT_DESCRIPTOR_FILE));
+    return node_fs_1.default.existsSync(node_path_1.default.join(dir, exports.PROJECT_DESCRIPTOR_FILE));
 }
-
 /**
  * Read a project file as UTF-8, rejecting symlinks before opening so a symlinked
  * descriptor/manifest can't redirect the read outside the project tree.
  */
 function readProjectFile(file, label) {
-  let stat;
-  try {
-    stat = _nodeFs.default.lstatSync(file);
-  } catch {
-    throw new _userError.default(`Could not read ${label} at "${file}".`);
-  }
-  if (stat.isSymbolicLink()) {
-    throw new _userError.default(`${label} at "${file}" must not be a symbolic link.`);
-  }
-  try {
-    return _nodeFs.default.readFileSync(file, 'utf8');
-  } catch {
-    throw new _userError.default(`Could not read ${label} at "${file}".`);
-  }
+    let stat;
+    try {
+        stat = node_fs_1.default.lstatSync(file);
+    }
+    catch {
+        throw new user_error_1.default(`Could not read ${label} at "${file}".`);
+    }
+    if (stat.isSymbolicLink()) {
+        throw new user_error_1.default(`${label} at "${file}" must not be a symbolic link.`);
+    }
+    try {
+        return node_fs_1.default.readFileSync(file, 'utf8');
+    }
+    catch {
+        throw new user_error_1.default(`Could not read ${label} at "${file}".`);
+    }
 }
-
 /**
  * Resolve the edge-workers project directory for a command.
  *
@@ -71,119 +71,110 @@ function readProjectFile(file, label) {
  *   4. Otherwise throw a UserError with guidance.
  */
 function resolveProjectDir(opts = {}, cwd = process.cwd()) {
-  if (opts.path !== undefined) {
-    // `--path` passed without a value arrives as a boolean, not a string;
-    // guard so we surface a clear error instead of a throw from path.resolve().
-    if (typeof opts.path !== 'string' || opts.path === '') {
-      throw new _userError.default('The --path flag requires a path to the edge-workers project.');
-    }
-    const explicit = _nodePath.default.resolve(cwd, opts.path);
-    if (!isProjectRoot(explicit)) {
-      throw new _userError.default(`No edge-workers project found at "${explicit}" (missing ${PROJECT_DESCRIPTOR_FILE}).`);
+    if (opts.path !== undefined) {
+        // `--path` passed without a value arrives as a boolean, not a string;
+        // guard so we surface a clear error instead of a throw from path.resolve().
+        if (typeof opts.path !== 'string' || opts.path === '') {
+            throw new user_error_1.default('The --path flag requires a path to the edge-workers project.');
+        }
+        const explicit = node_path_1.default.resolve(cwd, opts.path);
+        if (!isProjectRoot(explicit)) {
+            throw new user_error_1.default(`No edge-workers project found at "${explicit}" (missing ${exports.PROJECT_DESCRIPTOR_FILE}).`);
+        }
+        return explicit;
     }
-    return explicit;
-  }
-
-  // Walk up from cwd.
-  let current = _nodePath.default.resolve(cwd);
-  while (true) {
-    if (isProjectRoot(current)) {
-      return current;
+    // Walk up from cwd.
+    let current = node_path_1.default.resolve(cwd);
+    while (true) {
+        if (isProjectRoot(current)) {
+            return current;
+        }
+        const parent = node_path_1.default.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
     }
-    const parent = _nodePath.default.dirname(current);
-    if (parent === current) {
-      break;
+    // Conventional subfolder fallback.
+    const conventional = node_path_1.default.resolve(cwd, exports.CONVENTIONAL_PROJECT_DIR);
+    if (isProjectRoot(conventional)) {
+        return conventional;
     }
-    current = parent;
-  }
-
-  // Conventional subfolder fallback.
-  const conventional = _nodePath.default.resolve(cwd, CONVENTIONAL_PROJECT_DIR);
-  if (isProjectRoot(conventional)) {
-    return conventional;
-  }
-  throw new _userError.default('No edge-workers project found here. Run `vip edge-workers init` to create one, ' + 'run the command from inside a project, or pass `--path` to point at one.');
+    throw new user_error_1.default('No edge-workers project found here. Run `vip edge-workers init` to create one, ' +
+        'run the command from inside a project, or pass `--path` to point at one.');
 }
 function readProjectDescriptor(projectDir) {
-  const file = _nodePath.default.join(projectDir, PROJECT_DESCRIPTOR_FILE);
-  const raw = readProjectFile(file, 'project descriptor');
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    throw new _userError.default(`Project descriptor at "${file}" is not valid JSON.`);
-  }
-  return (0, _validation.parseProjectDescriptor)(parsed, file);
+    const file = node_path_1.default.join(projectDir, exports.PROJECT_DESCRIPTOR_FILE);
+    const raw = readProjectFile(file, 'project descriptor');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new user_error_1.default(`Project descriptor at "${file}" is not valid JSON.`);
+    }
+    return (0, validation_1.parseProjectDescriptor)(parsed, file);
 }
 function writeProjectDescriptor(projectDir, descriptor) {
-  const file = _nodePath.default.join(projectDir, PROJECT_DESCRIPTOR_FILE);
-  _nodeFs.default.mkdirSync(projectDir, {
-    recursive: true
-  });
-  _nodeFs.default.writeFileSync(file, JSON.stringify(descriptor, null, '\t') + '\n');
+    const file = node_path_1.default.join(projectDir, exports.PROJECT_DESCRIPTOR_FILE);
+    node_fs_1.default.mkdirSync(projectDir, { recursive: true });
+    node_fs_1.default.writeFileSync(file, JSON.stringify(descriptor, null, '\t') + '\n');
 }
 function readWorkerManifest(workerDir) {
-  const file = _nodePath.default.join(workerDir, WORKER_MANIFEST_FILE);
-  const raw = readProjectFile(file, 'worker manifest');
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    throw new _userError.default(`Worker manifest at "${file}" is not valid JSON.`);
-  }
-  return (0, _validation.parseWorkerManifest)(parsed, file);
+    const file = node_path_1.default.join(workerDir, exports.WORKER_MANIFEST_FILE);
+    const raw = readProjectFile(file, 'worker manifest');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new user_error_1.default(`Worker manifest at "${file}" is not valid JSON.`);
+    }
+    return (0, validation_1.parseWorkerManifest)(parsed, file);
 }
 function writeWorkerManifest(workerDir, manifest) {
-  const file = _nodePath.default.join(workerDir, WORKER_MANIFEST_FILE);
-  _nodeFs.default.mkdirSync(workerDir, {
-    recursive: true
-  });
-  _nodeFs.default.writeFileSync(file, JSON.stringify(manifest, null, '\t') + '\n');
+    const file = node_path_1.default.join(workerDir, exports.WORKER_MANIFEST_FILE);
+    node_fs_1.default.mkdirSync(workerDir, { recursive: true });
+    node_fs_1.default.writeFileSync(file, JSON.stringify(manifest, null, '\t') + '\n');
 }
-
 /** Discover all workers in a project by scanning each `workers/<name>/worker.json`. */
 function discoverWorkers(projectDir) {
-  const workersRoot = _nodePath.default.join(projectDir, WORKERS_DIR);
-  if (!_nodeFs.default.existsSync(workersRoot)) {
-    return [];
-  }
-  const entries = _nodeFs.default.readdirSync(workersRoot, {
-    withFileTypes: true
-  });
-  const workers = [];
-  const workersByName = new Map();
-  for (const entry of entries) {
-    if (!entry.isDirectory()) {
-      continue;
+    const workersRoot = node_path_1.default.join(projectDir, exports.WORKERS_DIR);
+    if (!node_fs_1.default.existsSync(workersRoot)) {
+        return [];
     }
-    const dir = _nodePath.default.join(workersRoot, entry.name);
-    if (!_nodeFs.default.existsSync(_nodePath.default.join(dir, WORKER_MANIFEST_FILE))) {
-      continue;
+    const entries = node_fs_1.default.readdirSync(workersRoot, { withFileTypes: true });
+    const workers = [];
+    const workersByName = new Map();
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const dir = node_path_1.default.join(workersRoot, entry.name);
+        if (!node_fs_1.default.existsSync(node_path_1.default.join(dir, exports.WORKER_MANIFEST_FILE))) {
+            continue;
+        }
+        const worker = { dir, manifest: readWorkerManifest(dir) };
+        const normalizedName = worker.manifest.name.toLocaleLowerCase('en-US');
+        if (workersByName.has(normalizedName)) {
+            throw new user_error_1.default(`Duplicate worker name "${worker.manifest.name}" found in this project.`);
+        }
+        workersByName.set(normalizedName, worker);
+        workers.push(worker);
     }
-    const worker = {
-      dir,
-      manifest: readWorkerManifest(dir)
-    };
-    const normalizedName = worker.manifest.name.toLocaleLowerCase('en-US');
-    if (workersByName.has(normalizedName)) {
-      throw new _userError.default(`Duplicate worker name "${worker.manifest.name}" found in this project.`);
-    }
-    workersByName.set(normalizedName, worker);
-    workers.push(worker);
-  }
-  return workers.sort((left, right) => left.manifest.name.localeCompare(right.manifest.name));
+    return workers.sort((left, right) => left.manifest.name.localeCompare(right.manifest.name));
 }
-
 /**
  * Find a single worker by name (the manifest `name`, falling back to the
  * directory name for convenience).
  */
 function findWorker(projectDir, name) {
-  const workers = discoverWorkers(projectDir);
-  const match = workers.find(worker => worker.manifest.name === name) ?? workers.find(worker => _nodePath.default.basename(worker.dir) === name);
-  if (!match) {
-    const available = workers.map(worker => worker.manifest.name).join(', ') || '(none)';
-    throw new _userError.default(`No worker named "${name}" found in this project. Available workers: ${available}.`);
-  }
-  return match;
-}
+    const workers = discoverWorkers(projectDir);
+    const match = workers.find(worker => worker.manifest.name === name) ??
+        workers.find(worker => node_path_1.default.basename(worker.dir) === name);
+    if (!match) {
+        const available = workers.map(worker => worker.manifest.name).join(', ') || '(none)';
+        throw new user_error_1.default(`No worker named "${name}" found in this project. Available workers: ${available}.`);
+    }
+    return match;
+}

package/dist/lib/edge-workers/toolchains/assemblyscript/constants.js

@@ -1,14 +1,12 @@
 "use strict";
-
-exports.__esModule = true;
-exports.SDK_VERSION = exports.SDK_PACKAGE = exports.DEFAULT_ENTRY = exports.ASSEMBLYSCRIPT_VERSION = void 0;
 /**
  * Shared constants for the AssemblyScript toolchain. Kept in one place so a
  * version bump or an SDK rename is a single-line change that flows into both the
  * scaffolded templates and the scaffold/compile logic.
  */
-
-const SDK_PACKAGE = exports.SDK_PACKAGE = '@automattic/vip-edge-workers-sdk';
-const SDK_VERSION = exports.SDK_VERSION = '0.5.0';
-const ASSEMBLYSCRIPT_VERSION = exports.ASSEMBLYSCRIPT_VERSION = '0.27.0';
-const DEFAULT_ENTRY = exports.DEFAULT_ENTRY = 'assembly/index.ts';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ENTRY = exports.ASSEMBLYSCRIPT_VERSION = exports.SDK_VERSION = exports.SDK_PACKAGE = void 0;
+exports.SDK_PACKAGE = '@automattic/vip-edge-workers-sdk';
+exports.SDK_VERSION = '0.5.0';
+exports.ASSEMBLYSCRIPT_VERSION = '0.27.0';
+exports.DEFAULT_ENTRY = 'assembly/index.ts';

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

@@ -1,16 +1,4 @@
 "use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _nodeChild_process = require("node:child_process");
-var _nodeFs = _interopRequireDefault(require("node:fs"));
-var _nodePath = _interopRequireDefault(require("node:path"));
-var _constants = require("./constants");
-var _templates = require("./templates");
-var _userError = _interopRequireDefault(require("../../../user-error"));
-var _project = require("../../project");
-var _validation = require("../../validation");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 /**
  * AssemblyScript toolchain: scaffolds an AssemblyScript edge-workers project,
  * adds workers, and compiles them to `.wasm` with the canonical `asc` flags.
@@ -22,101 +10,112 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  * The scaffolded file contents live in `./templates`; shared constants (versions,
  * SDK name, paths) live in `./constants`.
  */
-
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const constants_1 = require("./constants");
+const templates_1 = require("./templates");
+const user_error_1 = __importDefault(require("../../../user-error"));
+const project_1 = require("../../project");
+const validation_1 = require("../../validation");
 /** Write `contents` to `filePath`, creating any missing parent directories. */
 function writeFileEnsuringDir(filePath, contents) {
-  _nodeFs.default.mkdirSync(_nodePath.default.dirname(filePath), {
-    recursive: true
-  });
-  _nodeFs.default.writeFileSync(filePath, contents);
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(filePath), { recursive: true });
+    node_fs_1.default.writeFileSync(filePath, contents);
 }
 function assertScaffoldTargetAvailable(projectDir) {
-  if (!_nodeFs.default.existsSync(projectDir)) return;
-  // lstatSync (not statSync) so a symlink to a directory is rejected rather than followed.
-  if (!_nodeFs.default.lstatSync(projectDir).isDirectory()) {
-    throw new _userError.default(`Cannot create an edge-workers project at "${projectDir}": target is not a directory.`);
-  }
-  if (_nodeFs.default.readdirSync(projectDir).length > 0) {
-    throw new _userError.default(`Cannot create an edge-workers project at "${projectDir}": target is not empty.`);
-  }
+    if (!node_fs_1.default.existsSync(projectDir))
+        return;
+    // lstatSync (not statSync) so a symlink to a directory is rejected rather than followed.
+    if (!node_fs_1.default.lstatSync(projectDir).isDirectory()) {
+        throw new user_error_1.default(`Cannot create an edge-workers project at "${projectDir}": target is not a directory.`);
+    }
+    if (node_fs_1.default.readdirSync(projectDir).length > 0) {
+        throw new user_error_1.default(`Cannot create an edge-workers project at "${projectDir}": target is not empty.`);
+    }
 }
 function ascBinaryPath(projectDir) {
-  const binName = process.platform === 'win32' ? 'asc.cmd' : 'asc';
-  return _nodePath.default.join(projectDir, 'node_modules', '.bin', binName);
+    const binName = process.platform === 'win32' ? 'asc.cmd' : 'asc';
+    return node_path_1.default.join(projectDir, 'node_modules', '.bin', binName);
 }
 const toolchain = {
-  type: 'assemblyscript',
-  scaffoldProject(projectDir) {
-    assertScaffoldTargetAvailable(projectDir);
-
-    // Every write below ensures its own parent directory, so no standalone
-    // mkdir is needed up front.
-    (0, _project.writeProjectDescriptor)(projectDir, {
-      type: 'assemblyscript',
-      sdk: `${_constants.SDK_PACKAGE}@${_constants.SDK_VERSION}`
-    });
-    writeFileEnsuringDir(_nodePath.default.join(projectDir, 'package.json'), JSON.stringify(_templates.PACKAGE_JSON, null, '\t') + '\n');
-    writeFileEnsuringDir(_nodePath.default.join(projectDir, 'tsconfig.json'), JSON.stringify(_templates.TSCONFIG_JSON, null, '\t') + '\n');
-    writeFileEnsuringDir(_nodePath.default.join(projectDir, '.gitignore'), _templates.GITIGNORE);
-    writeFileEnsuringDir(_nodePath.default.join(projectDir, 'README.md'), _templates.README);
-    // Keep the workers directory present (and committed) even when empty.
-    writeFileEnsuringDir(_nodePath.default.join(projectDir, _project.WORKERS_DIR, '.gitkeep'), '');
-  },
-  scaffoldWorker(projectDir, name) {
-    (0, _validation.validateWorkerName)(name);
-    const workerDir = _nodePath.default.join(projectDir, _project.WORKERS_DIR, name);
-    if (_nodeFs.default.existsSync(workerDir)) {
-      throw new _userError.default(`A worker directory already exists at "${workerDir}".`);
-    }
-    (0, _project.writeWorkerManifest)(workerDir, {
-      name,
-      entry: _constants.DEFAULT_ENTRY
-    });
-    writeFileEnsuringDir(_nodePath.default.join(workerDir, _constants.DEFAULT_ENTRY), (0, _templates.starterWorker)());
-  },
-  ensureAvailable(projectDir) {
-    const asc = ascBinaryPath(projectDir);
-    if (!_nodeFs.default.existsSync(asc)) {
-      throw new _userError.default(`The AssemblyScript compiler was not found at "${asc}". ` + `Run \`npm install\` in "${projectDir}" first.`);
-    }
-  },
-  compile(projectDir, worker) {
-    const asc = ascBinaryPath(projectDir);
-    const entryCandidate = (0, _validation.resolvePathWithin)(worker.dir, worker.manifest.entry, 'Worker entry');
-    if (!_nodeFs.default.existsSync(entryCandidate)) {
-      throw new _userError.default(`Worker entry file not found: "${entryCandidate}".`);
-    }
-    const entry = (0, _validation.resolveExistingPathWithin)(worker.dir, worker.manifest.entry, 'Worker entry');
-    const nodeModules = _nodePath.default.join(projectDir, 'node_modules');
-    const workerName = (0, _validation.validateWorkerName)(worker.manifest.name);
-    const outFile = (0, _validation.resolveOutputPathWithin)(projectDir, _nodePath.default.join(_project.BUILD_DIR, `${workerName}.wasm`), 'Worker build artifact', 'Worker build directory');
-    const args = [entry, '--runtime', 'stub', '--path', nodeModules, '--outFile', outFile, '--optimizeLevel', '3', '--shrinkLevel', '2'];
-
-    // Enable the json-as transform when it's installed so workers can parse JSON.
-    // The transform lives at the `transform` subpath; the package root has no
-    // requirable entry, so `--transform json-as` fails to resolve.
-    if (_nodeFs.default.existsSync(_nodePath.default.join(nodeModules, 'json-as'))) {
-      args.push('--transform', 'json-as/transform');
-    }
-
-    // asc misbehaves if NODE_OPTIONS is inherited; drop it like the SDK build does.
-    const env = {
-      ...process.env
-    };
-    delete env.NODE_OPTIONS;
-    const result = (0, _nodeChild_process.spawnSync)(asc, args, {
-      cwd: projectDir,
-      env,
-      encoding: 'utf8'
-    });
-    if (result.error) {
-      throw new _userError.default(`Failed to run the AssemblyScript compiler: ${result.error.message}`);
-    }
-    if (result.status !== 0) {
-      const details = (result.stderr || result.stdout || '').trim();
-      throw new _userError.default(`Compilation failed for worker "${worker.manifest.name}"${details ? `:\n${details}` : '.'}`);
-    }
-    return (0, _validation.resolveOutputPathWithin)(projectDir, _nodePath.default.join(_project.BUILD_DIR, `${workerName}.wasm`), 'Worker build artifact', 'Worker build directory');
-  }
+    type: 'assemblyscript',
+    scaffoldProject(projectDir) {
+        assertScaffoldTargetAvailable(projectDir);
+        // Every write below ensures its own parent directory, so no standalone
+        // mkdir is needed up front.
+        (0, project_1.writeProjectDescriptor)(projectDir, {
+            type: 'assemblyscript',
+            sdk: `${constants_1.SDK_PACKAGE}@${constants_1.SDK_VERSION}`,
+        });
+        writeFileEnsuringDir(node_path_1.default.join(projectDir, 'package.json'), JSON.stringify(templates_1.PACKAGE_JSON, null, '\t') + '\n');
+        writeFileEnsuringDir(node_path_1.default.join(projectDir, 'tsconfig.json'), JSON.stringify(templates_1.TSCONFIG_JSON, null, '\t') + '\n');
+        writeFileEnsuringDir(node_path_1.default.join(projectDir, '.gitignore'), templates_1.GITIGNORE);
+        writeFileEnsuringDir(node_path_1.default.join(projectDir, 'README.md'), templates_1.README);
+        // Keep the workers directory present (and committed) even when empty.
+        writeFileEnsuringDir(node_path_1.default.join(projectDir, project_1.WORKERS_DIR, '.gitkeep'), '');
+    },
+    scaffoldWorker(projectDir, name) {
+        (0, validation_1.validateWorkerName)(name);
+        const workerDir = node_path_1.default.join(projectDir, project_1.WORKERS_DIR, name);
+        if (node_fs_1.default.existsSync(workerDir)) {
+            throw new user_error_1.default(`A worker directory already exists at "${workerDir}".`);
+        }
+        (0, project_1.writeWorkerManifest)(workerDir, { name, entry: constants_1.DEFAULT_ENTRY });
+        writeFileEnsuringDir(node_path_1.default.join(workerDir, constants_1.DEFAULT_ENTRY), (0, templates_1.starterWorker)());
+    },
+    ensureAvailable(projectDir) {
+        const asc = ascBinaryPath(projectDir);
+        if (!node_fs_1.default.existsSync(asc)) {
+            throw new user_error_1.default(`The AssemblyScript compiler was not found at "${asc}". ` +
+                `Run \`npm install\` in "${projectDir}" first.`);
+        }
+    },
+    compile(projectDir, worker) {
+        const asc = ascBinaryPath(projectDir);
+        const entryCandidate = (0, validation_1.resolvePathWithin)(worker.dir, worker.manifest.entry, 'Worker entry');
+        if (!node_fs_1.default.existsSync(entryCandidate)) {
+            throw new user_error_1.default(`Worker entry file not found: "${entryCandidate}".`);
+        }
+        const entry = (0, validation_1.resolveExistingPathWithin)(worker.dir, worker.manifest.entry, 'Worker entry');
+        const nodeModules = node_path_1.default.join(projectDir, 'node_modules');
+        const workerName = (0, validation_1.validateWorkerName)(worker.manifest.name);
+        const outFile = (0, validation_1.resolveOutputPathWithin)(projectDir, node_path_1.default.join(project_1.BUILD_DIR, `${workerName}.wasm`), 'Worker build artifact', 'Worker build directory');
+        const args = [
+            entry,
+            '--runtime',
+            'stub',
+            '--path',
+            nodeModules,
+            '--outFile',
+            outFile,
+            '--optimizeLevel',
+            '3',
+            '--shrinkLevel',
+            '2',
+        ];
+        // Enable the json-as transform when it's installed so workers can parse JSON.
+        // The transform lives at the `transform` subpath; the package root has no
+        // requirable entry, so `--transform json-as` fails to resolve.
+        if (node_fs_1.default.existsSync(node_path_1.default.join(nodeModules, 'json-as'))) {
+            args.push('--transform', 'json-as/transform');
+        }
+        // asc misbehaves if NODE_OPTIONS is inherited; drop it like the SDK build does.
+        const env = { ...process.env };
+        delete env.NODE_OPTIONS;
+        const result = (0, node_child_process_1.spawnSync)(asc, args, { cwd: projectDir, env, encoding: 'utf8' });
+        if (result.error) {
+            throw new user_error_1.default(`Failed to run the AssemblyScript compiler: ${result.error.message}`);
+        }
+        if (result.status !== 0) {
+            const details = (result.stderr || result.stdout || '').trim();
+            throw new user_error_1.default(`Compilation failed for worker "${worker.manifest.name}"${details ? `:\n${details}` : '.'}`);
+        }
+        return (0, validation_1.resolveOutputPathWithin)(projectDir, node_path_1.default.join(project_1.BUILD_DIR, `${workerName}.wasm`), 'Worker build artifact', 'Worker build directory');
+    },
 };
-var _default = exports.default = toolchain;
+exports.default = toolchain;