workerstack 0.1.0-beta.0

package/dist/dev/binaries.d.ts

@@ -0,0 +1,22 @@
+export type BinaryName = 'celld' | 'sqld';
+export type Pin = {
+    version: string;
+    format: 'gz' | 'tar.xz';
+    url: (target: string) => string;
+    /** sha256 of the downloaded asset, per release target. */
+    sha256: Partial<Record<string, string>>;
+};
+export type Pins = Partial<Record<BinaryName, Pin>>;
+export type ResolveOptions = {
+    env?: Record<string, string | undefined>;
+    cacheDir?: string;
+    platform?: string;
+    arch?: string;
+    fetch?: (url: string) => Promise<Response>;
+    log?: (message: string) => void;
+    /** Replaces the pinned table; for tests. */
+    pins?: Pins;
+};
+export declare function binaryTarget(platform: string, arch: string): string | undefined;
+export declare function resolveBinary(name: BinaryName, options?: ResolveOptions): Promise<string>;
+//# sourceMappingURL=binaries.d.ts.map

package/dist/dev/binaries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaries.d.ts","sourceRoot":"","sources":["../../src/dev/binaries.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAA;AAEzC,MAAM,MAAM,GAAG,GAAG;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAA;IACvB,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;IAC/B,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAA;AAmCnD,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1C,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ,CAAA;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,sBAM1D;AAyBD,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAmEjB"}

package/dist/dev/binaries.js

@@ -0,0 +1,119 @@
+// Pinned celld and sqld binaries for `workerstack dev`. The first run
+// downloads them to ~/.cache/workerstack and checks their sha256; an env var
+// selects a system binary instead.
+import { access, chmod, constants, mkdir, mkdtemp, readdir, rename, rm, stat, } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const PINS = {
+    celld: {
+        version: 'v0.6.0',
+        format: 'gz',
+        url: (target) => `https://github.com/denoland/celld/releases/download/v0.6.0/celld-${target}.gz`,
+        sha256: {
+            'aarch64-apple-darwin': 'bf6f0c06c4f815eecddf61ae40340935a0dbf76be3d643bf75fdd92bfac425cd',
+            'aarch64-unknown-linux-gnu': '3d4945df3abcc6832b6e7fa978b9ee3c26e46a0b7791924843d42c0ed14eff96',
+            'x86_64-unknown-linux-gnu': '8f1e18072c234ab75459d4da104c13cebc9b29a3e4a4772086bf985829bea8aa',
+        },
+    },
+    sqld: {
+        version: 'v0.24.32',
+        format: 'tar.xz',
+        url: (target) => `https://github.com/tursodatabase/libsql/releases/download/libsql-server-v0.24.32/libsql-server-${target}.tar.xz`,
+        sha256: {
+            'aarch64-apple-darwin': 'ced2a9d65a5d4b6bd72c67e98ad6c63139e2a139d91769f07fdd15be935381dd',
+            'x86_64-apple-darwin': '461480ea5a17781bab7dd5974aa804007434611baced37b6349c8060d0648e34',
+            'aarch64-unknown-linux-gnu': '37f9eee45b388a30192907ecf4565b93df945c079331657073b5b3caf8bb1cd0',
+            'x86_64-unknown-linux-gnu': '71720fc8648c19efef416efebd47145ef59b62e198770533530a858e1336879f',
+        },
+    },
+};
+export function binaryTarget(platform, arch) {
+    const cpu = arch === 'arm64' ? 'aarch64' : arch === 'x64' ? 'x86_64' : '';
+    if (!cpu)
+        return undefined;
+    if (platform === 'darwin')
+        return `${cpu}-apple-darwin`;
+    if (platform === 'linux')
+        return `${cpu}-unknown-linux-gnu`;
+    return undefined;
+}
+async function isExecutable(path) {
+    return access(path, constants.X_OK).then(() => true, () => false);
+}
+async function findFile(dir, name) {
+    for (const entry of await readdir(dir, { withFileTypes: true })) {
+        const path = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            const found = await findFile(path, name);
+            if (found)
+                return found;
+        }
+        else if (entry.name === name) {
+            return path;
+        }
+    }
+    return undefined;
+}
+export async function resolveBinary(name, options = {}) {
+    const env = options.env ?? process.env;
+    const envName = `WORKERSTACK_${name.toUpperCase()}_BIN`;
+    const override = env[envName];
+    if (override)
+        return override;
+    const pin = (options.pins ?? PINS)[name];
+    const target = binaryTarget(options.platform ?? process.platform, options.arch ?? process.arch);
+    const checksum = target ? pin?.sha256[target] : undefined;
+    if (!pin || !target || !checksum) {
+        throw new Error(`[workerstack] no ${name} build for ${options.platform ?? process.platform} ${options.arch ?? process.arch}; install ${name} and set ${envName} to its path`);
+    }
+    const cacheDir = options.cacheDir ??
+        env.WORKERSTACK_CACHE_DIR ??
+        join(homedir(), '.cache', 'workerstack');
+    const home = join(cacheDir, `${name}-${pin.version}-${target}`);
+    const cached = await findFile(home, name).catch(() => undefined);
+    if (cached && (await isExecutable(cached)))
+        return cached;
+    const url = pin.url(target);
+    options.log?.(`downloading ${name} ${pin.version} from ${url}`);
+    const response = await (options.fetch ?? fetch)(url);
+    if (!response.ok) {
+        throw new Error(`[workerstack] ${url} returned ${response.status}`);
+    }
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    const actual = new Bun.CryptoHasher('sha256').update(bytes).digest('hex');
+    if (actual !== checksum) {
+        throw new Error(`[workerstack] ${name} checksum mismatch: expected ${checksum}, got ${actual}`);
+    }
+    await mkdir(cacheDir, { recursive: true });
+    const staging = await mkdtemp(join(cacheDir, `.${name}-`));
+    try {
+        if (pin.format === 'gz') {
+            await Bun.write(join(staging, name), Bun.gunzipSync(bytes));
+        }
+        else {
+            const archive = join(staging, 'asset.tar.xz');
+            await Bun.write(archive, bytes);
+            const tar = Bun.spawnSync(['tar', '-xJf', archive], { cwd: staging });
+            if (tar.exitCode !== 0) {
+                throw new Error(`[workerstack] tar failed: ${tar.stderr.toString()}`);
+            }
+            await rm(archive);
+        }
+        const binary = await findFile(staging, name);
+        if (!binary)
+            throw new Error(`[workerstack] ${url} has no ${name} file`);
+        await chmod(binary, 0o755);
+        // Another run may have finished first; keep its copy.
+        if (!(await stat(home).catch(() => undefined))) {
+            await rename(staging, home);
+        }
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+    const path = await findFile(home, name);
+    if (!path)
+        throw new Error(`[workerstack] ${name} is missing from ${home}`);
+    return path;
+}
+//# sourceMappingURL=binaries.js.map

package/dist/dev/binaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaries.js","sourceRoot":"","sources":["../../src/dev/binaries.ts"],"names":[],"mappings":"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","sourcesContent":["// Pinned celld and sqld binaries for `workerstack dev`. The first run\n// downloads them to ~/.cache/workerstack and checks their sha256; an env var\n// selects a system binary instead.\nimport {\n  access,\n  chmod,\n  constants,\n  mkdir,\n  mkdtemp,\n  readdir,\n  rename,\n  rm,\n  stat,\n} from 'node:fs/promises'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\n\nexport type BinaryName = 'celld' | 'sqld'\n\nexport type Pin = {\n  version: string\n  format: 'gz' | 'tar.xz'\n  url: (target: string) => string\n  /** sha256 of the downloaded asset, per release target. */\n  sha256: Partial<Record<string, string>>\n}\n\nexport type Pins = Partial<Record<BinaryName, Pin>>\n\nconst PINS: Record<BinaryName, Pin> = {\n  celld: {\n    version: 'v0.6.0',\n    format: 'gz',\n    url: (target) =>\n      `https://github.com/denoland/celld/releases/download/v0.6.0/celld-${target}.gz`,\n    sha256: {\n      'aarch64-apple-darwin':\n        'bf6f0c06c4f815eecddf61ae40340935a0dbf76be3d643bf75fdd92bfac425cd',\n      'aarch64-unknown-linux-gnu':\n        '3d4945df3abcc6832b6e7fa978b9ee3c26e46a0b7791924843d42c0ed14eff96',\n      'x86_64-unknown-linux-gnu':\n        '8f1e18072c234ab75459d4da104c13cebc9b29a3e4a4772086bf985829bea8aa',\n    },\n  },\n  sqld: {\n    version: 'v0.24.32',\n    format: 'tar.xz',\n    url: (target) =>\n      `https://github.com/tursodatabase/libsql/releases/download/libsql-server-v0.24.32/libsql-server-${target}.tar.xz`,\n    sha256: {\n      'aarch64-apple-darwin':\n        'ced2a9d65a5d4b6bd72c67e98ad6c63139e2a139d91769f07fdd15be935381dd',\n      'x86_64-apple-darwin':\n        '461480ea5a17781bab7dd5974aa804007434611baced37b6349c8060d0648e34',\n      'aarch64-unknown-linux-gnu':\n        '37f9eee45b388a30192907ecf4565b93df945c079331657073b5b3caf8bb1cd0',\n      'x86_64-unknown-linux-gnu':\n        '71720fc8648c19efef416efebd47145ef59b62e198770533530a858e1336879f',\n    },\n  },\n}\n\nexport type ResolveOptions = {\n  env?: Record<string, string | undefined>\n  cacheDir?: string\n  platform?: string\n  arch?: string\n  fetch?: (url: string) => Promise<Response>\n  log?: (message: string) => void\n  /** Replaces the pinned table; for tests. */\n  pins?: Pins\n}\n\nexport function binaryTarget(platform: string, arch: string) {\n  const cpu = arch === 'arm64' ? 'aarch64' : arch === 'x64' ? 'x86_64' : ''\n  if (!cpu) return undefined\n  if (platform === 'darwin') return `${cpu}-apple-darwin`\n  if (platform === 'linux') return `${cpu}-unknown-linux-gnu`\n  return undefined\n}\n\nasync function isExecutable(path: string) {\n  return access(path, constants.X_OK).then(\n    () => true,\n    () => false,\n  )\n}\n\nasync function findFile(\n  dir: string,\n  name: string,\n): Promise<string | undefined> {\n  for (const entry of await readdir(dir, { withFileTypes: true })) {\n    const path = join(dir, entry.name)\n    if (entry.isDirectory()) {\n      const found = await findFile(path, name)\n      if (found) return found\n    } else if (entry.name === name) {\n      return path\n    }\n  }\n  return undefined\n}\n\nexport async function resolveBinary(\n  name: BinaryName,\n  options: ResolveOptions = {},\n): Promise<string> {\n  const env = options.env ?? process.env\n  const envName = `WORKERSTACK_${name.toUpperCase()}_BIN`\n  const override = env[envName]\n  if (override) return override\n\n  const pin = (options.pins ?? PINS)[name]\n  const target = binaryTarget(\n    options.platform ?? process.platform,\n    options.arch ?? process.arch,\n  )\n  const checksum = target ? pin?.sha256[target] : undefined\n  if (!pin || !target || !checksum) {\n    throw new Error(\n      `[workerstack] no ${name} build for ${options.platform ?? process.platform} ${options.arch ?? process.arch}; install ${name} and set ${envName} to its path`,\n    )\n  }\n\n  const cacheDir =\n    options.cacheDir ??\n    env.WORKERSTACK_CACHE_DIR ??\n    join(homedir(), '.cache', 'workerstack')\n  const home = join(cacheDir, `${name}-${pin.version}-${target}`)\n  const cached = await findFile(home, name).catch(() => undefined)\n  if (cached && (await isExecutable(cached))) return cached\n\n  const url = pin.url(target)\n  options.log?.(`downloading ${name} ${pin.version} from ${url}`)\n  const response = await (options.fetch ?? fetch)(url)\n  if (!response.ok) {\n    throw new Error(`[workerstack] ${url} returned ${response.status}`)\n  }\n  const bytes = new Uint8Array(await response.arrayBuffer())\n  const actual = new Bun.CryptoHasher('sha256').update(bytes).digest('hex')\n  if (actual !== checksum) {\n    throw new Error(\n      `[workerstack] ${name} checksum mismatch: expected ${checksum}, got ${actual}`,\n    )\n  }\n\n  await mkdir(cacheDir, { recursive: true })\n  const staging = await mkdtemp(join(cacheDir, `.${name}-`))\n  try {\n    if (pin.format === 'gz') {\n      await Bun.write(join(staging, name), Bun.gunzipSync(bytes))\n    } else {\n      const archive = join(staging, 'asset.tar.xz')\n      await Bun.write(archive, bytes)\n      const tar = Bun.spawnSync(['tar', '-xJf', archive], { cwd: staging })\n      if (tar.exitCode !== 0) {\n        throw new Error(`[workerstack] tar failed: ${tar.stderr.toString()}`)\n      }\n      await rm(archive)\n    }\n    const binary = await findFile(staging, name)\n    if (!binary) throw new Error(`[workerstack] ${url} has no ${name} file`)\n    await chmod(binary, 0o755)\n    // Another run may have finished first; keep its copy.\n    if (!(await stat(home).catch(() => undefined))) {\n      await rename(staging, home)\n    }\n  } finally {\n    await rm(staging, { recursive: true, force: true })\n  }\n  const path = await findFile(home, name)\n  if (!path) throw new Error(`[workerstack] ${name} is missing from ${home}`)\n  return path\n}\n"]}

package/dist/dev/env.d.ts

@@ -0,0 +1,11 @@
+export declare function parseDotenv(text: string): Record<string, string>;
+export declare function readUserEnv(directory: string): Promise<Record<string, string>>;
+/** A random AUTH_SECRET kept in the dev state dir, so sessions survive restarts. */
+export declare function devSecret(stateDir: string): Promise<string>;
+export declare function devVars(input: {
+    userEnv: Record<string, string>;
+    databaseUrl: string;
+    appUrl: string;
+    authSecret: string;
+}): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/dev/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/dev/env.ts"],"names":[],"mappings":"AAKA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBhE;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CASjC;AAED,oFAAoF;AACpF,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWjE;AAOD,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,MAAM,CAaT"}

package/dist/dev/env.js

@@ -0,0 +1,71 @@
+// The Worker env for `workerstack dev`: the app's .env files plus the values
+// the dev command owns, written as .dev.vars for celld.
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export function parseDotenv(text) {
+    const vars = {};
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const match = /^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(line);
+        if (!match)
+            continue;
+        const [, key, rest] = match;
+        let value;
+        if (rest.startsWith('"')) {
+            const end = rest.lastIndexOf('"');
+            value = rest
+                .slice(1, end > 0 ? end : undefined)
+                .replace(/\\(["\\n])/g, (_, c) => (c === 'n' ? '\n' : c));
+        }
+        else if (rest.startsWith("'")) {
+            const end = rest.lastIndexOf("'");
+            value = rest.slice(1, end > 0 ? end : undefined);
+        }
+        else {
+            value = rest.replace(/\s+#.*$/, '').trim();
+        }
+        vars[key] = value;
+    }
+    return vars;
+}
+export async function readUserEnv(directory) {
+    const vars = {};
+    for (const name of ['.env', '.env.local']) {
+        const text = await readFile(join(directory, name), 'utf8').catch(() => undefined);
+        if (text !== undefined)
+            Object.assign(vars, parseDotenv(text));
+    }
+    return vars;
+}
+/** A random AUTH_SECRET kept in the dev state dir, so sessions survive restarts. */
+export async function devSecret(stateDir) {
+    const path = join(stateDir, 'auth-secret');
+    const existing = (await readFile(path, 'utf8').catch(() => '')).trim();
+    if (existing)
+        return existing;
+    await mkdir(stateDir, { recursive: true });
+    const bytes = crypto.getRandomValues(new Uint8Array(32));
+    const secret = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+    await writeFile(path, `${secret}\n`, { mode: 0o600 });
+    return secret;
+}
+function quote(value) {
+    if (/^[A-Za-z0-9_./:@+-]*$/.test(value))
+        return value;
+    return `"${value.replace(/["\\]/g, '\\$&').replace(/\n/g, '\\n')}"`;
+}
+export function devVars(input) {
+    const vars = {
+        ...input.userEnv,
+        AUTH_SECRET: input.userEnv.AUTH_SECRET || input.authSecret,
+        // The dev command picks these; a value from .env would point elsewhere.
+        APP_URL: input.appUrl,
+        WORKERSTACK_DATABASE_URL: input.databaseUrl,
+    };
+    return (Object.entries(vars)
+        .map(([key, value]) => `${key}=${quote(value)}`)
+        .join('\n') + '\n');
+}
+//# sourceMappingURL=env.js.map

package/dist/dev/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/dev/env.ts"],"names":[],"mappings":"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","sourcesContent":["// The Worker env for `workerstack dev`: the app's .env files plus the values\n// the dev command owns, written as .dev.vars for celld.\nimport { mkdir, readFile, writeFile } from 'node:fs/promises'\nimport { join } from 'node:path'\n\nexport function parseDotenv(text: string): Record<string, string> {\n  const vars: Record<string, string> = {}\n  for (const raw of text.split(/\\r?\\n/)) {\n    const line = raw.trim()\n    if (!line || line.startsWith('#')) continue\n    const match = /^(?:export\\s+)?([A-Za-z_][A-Za-z0-9_]*)\\s*=\\s*(.*)$/.exec(\n      line,\n    )\n    if (!match) continue\n    const [, key, rest] = match as unknown as [string, string, string]\n    let value: string\n    if (rest.startsWith('\"')) {\n      const end = rest.lastIndexOf('\"')\n      value = rest\n        .slice(1, end > 0 ? end : undefined)\n        .replace(/\\\\([\"\\\\n])/g, (_, c: string) => (c === 'n' ? '\\n' : c))\n    } else if (rest.startsWith(\"'\")) {\n      const end = rest.lastIndexOf(\"'\")\n      value = rest.slice(1, end > 0 ? end : undefined)\n    } else {\n      value = rest.replace(/\\s+#.*$/, '').trim()\n    }\n    vars[key] = value\n  }\n  return vars\n}\n\nexport async function readUserEnv(\n  directory: string,\n): Promise<Record<string, string>> {\n  const vars: Record<string, string> = {}\n  for (const name of ['.env', '.env.local']) {\n    const text = await readFile(join(directory, name), 'utf8').catch(\n      () => undefined,\n    )\n    if (text !== undefined) Object.assign(vars, parseDotenv(text))\n  }\n  return vars\n}\n\n/** A random AUTH_SECRET kept in the dev state dir, so sessions survive restarts. */\nexport async function devSecret(stateDir: string): Promise<string> {\n  const path = join(stateDir, 'auth-secret')\n  const existing = (await readFile(path, 'utf8').catch(() => '')).trim()\n  if (existing) return existing\n  await mkdir(stateDir, { recursive: true })\n  const bytes = crypto.getRandomValues(new Uint8Array(32))\n  const secret = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join(\n    '',\n  )\n  await writeFile(path, `${secret}\\n`, { mode: 0o600 })\n  return secret\n}\n\nfunction quote(value: string) {\n  if (/^[A-Za-z0-9_./:@+-]*$/.test(value)) return value\n  return `\"${value.replace(/[\"\\\\]/g, '\\\\$&').replace(/\\n/g, '\\\\n')}\"`\n}\n\nexport function devVars(input: {\n  userEnv: Record<string, string>\n  databaseUrl: string\n  appUrl: string\n  authSecret: string\n}): string {\n  const vars: Record<string, string> = {\n    ...input.userEnv,\n    AUTH_SECRET: input.userEnv.AUTH_SECRET || input.authSecret,\n    // The dev command picks these; a value from .env would point elsewhere.\n    APP_URL: input.appUrl,\n    WORKERSTACK_DATABASE_URL: input.databaseUrl,\n  }\n  return (\n    Object.entries(vars)\n      .map(([key, value]) => `${key}=${quote(value)}`)\n      .join('\\n') + '\\n'\n  )\n}\n"]}

package/dist/dev/index.d.ts

@@ -0,0 +1,39 @@
+import { type ProcessSpec } from './processes.js';
+export type DevPlan = {
+    appUrl: string;
+    databaseUrl: string;
+    sqld?: ProcessSpec;
+    vite: ProcessSpec;
+};
+export declare function planDev(input: {
+    directory: string;
+    stateDir: string;
+    userEnv: Record<string, string>;
+    ports: {
+        app: number;
+        db: number;
+    };
+    binaries: {
+        sqld: string;
+    };
+}): DevPlan;
+/**
+ * Removes what a host must not deploy: the Cloudflare plugin's
+ * `.assetsignore` (celld rejects it) and every `.dev.vars` (the plugin copies
+ * the local one into dist/server). Returns the removed paths.
+ */
+export declare function cleanArtifact(directory: string): Promise<string[]>;
+/**
+ * The first port from `start` that is free on 127.0.0.1 and on ::1. The
+ * browser opens `localhost`, which can resolve to either; Vite on ::1 next to
+ * another server on 127.0.0.1 would answer only some requests.
+ */
+export declare function firstFreePort(start: number): Promise<number>;
+export declare function runDev(options: {
+    directory: string;
+    port?: number;
+}): Promise<number>;
+export declare function runBuild(options: {
+    directory: string;
+}): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/dev/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAE5D,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;CAClB,CAAA;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAClC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3B,GAAG,OAAO,CAmCV;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBxE;AA+BD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlE;AA2BD,wBAAsB,MAAM,CAAC,OAAO,EAAE;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAuHlB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACtC,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClB"}

package/dist/dev/index.js

@@ -0,0 +1,273 @@
+// `workerstack dev` and `workerstack build`. dev starts sqld and Vite, which
+// runs the Worker (SSR, /api, Durable Objects) in workerd through the
+// Cloudflare plugin; build checks workerstack.blueprint.yaml, writes
+// wrangler.json from it, and builds dist/server and dist/client with Vite.
+import { watch } from 'node:fs';
+import { mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import { createServer } from 'node:net';
+import { join, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { generateBlueprint } from '../blueprint-generator.js';
+import { runWranglerCommand } from '../workers/wrangler.js';
+import { resolveBinary } from './binaries.js';
+import { devSecret, devVars, readUserEnv } from './env.js';
+import { ProcessGroup } from './processes.js';
+export function planDev(input) {
+    const { directory, ports, binaries } = input;
+    const external = input.userEnv.WORKERSTACK_DATABASE_URL;
+    const databaseUrl = external || `http://127.0.0.1:${ports.db}`;
+    return {
+        // localhost, not 127.0.0.1: auth checks the Origin against APP_URL.
+        appUrl: `http://localhost:${ports.app}`,
+        databaseUrl,
+        sqld: external
+            ? undefined
+            : {
+                name: 'sqld',
+                cmd: [
+                    binaries.sqld,
+                    '--http-listen-addr',
+                    `127.0.0.1:${ports.db}`,
+                    '-d',
+                    join(input.stateDir, 'db'),
+                ],
+                cwd: directory,
+            },
+        vite: {
+            name: 'vite',
+            cmd: [
+                process.execPath,
+                'x',
+                '--bun',
+                'vite',
+                '--port',
+                String(ports.app),
+                '--strictPort',
+            ],
+            cwd: directory,
+        },
+    };
+}
+/**
+ * Removes what a host must not deploy: the Cloudflare plugin's
+ * `.assetsignore` (celld rejects it) and every `.dev.vars` (the plugin copies
+ * the local one into dist/server). Returns the removed paths.
+ */
+export async function cleanArtifact(directory) {
+    const dist = join(directory, 'dist');
+    const entries = await readdir(dist, {
+        recursive: true,
+        withFileTypes: true,
+    }).catch(() => []);
+    const removed = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const path = join(entry.parentPath, entry.name);
+        const rel = relative(directory, path).split(sep).join('/');
+        if (entry.name === '.dev.vars' || rel === 'dist/client/.assetsignore') {
+            await rm(path, { force: true });
+            removed.push(rel);
+        }
+    }
+    return removed;
+}
+async function hasViteConfig(directory) {
+    const files = await readdir(directory);
+    return files.some((file) => /^vite\.config\.[cm]?[jt]s$/.test(file));
+}
+async function freePort() {
+    return new Promise((resolvePort, reject) => {
+        const server = createServer();
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            server.close(() => typeof address === 'object' && address
+                ? resolvePort(address.port)
+                : reject(new Error('no free port')));
+        });
+    });
+}
+function canListen(port, hostname) {
+    try {
+        Bun.listen({ hostname, port, socket: { data() { } } }).stop(true);
+        return true;
+    }
+    catch (error) {
+        // No IPv6 on this machine: nothing can take the port there either.
+        return error.code === 'EADDRNOTAVAIL';
+    }
+}
+/**
+ * The first port from `start` that is free on 127.0.0.1 and on ::1. The
+ * browser opens `localhost`, which can resolve to either; Vite on ::1 next to
+ * another server on 127.0.0.1 would answer only some requests.
+ */
+export async function firstFreePort(start) {
+    for (let port = start; port < start + 100; port++) {
+        if (canListen(port, '127.0.0.1') && canListen(port, '::1'))
+            return port;
+    }
+    throw new Error(`[workerstack] no free port from ${start}`);
+}
+async function waitForHealth(url, timeoutMs, cancelled) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        if (cancelled())
+            return;
+        const ok = await fetch(url).then((res) => res.ok, () => false);
+        if (ok)
+            return;
+        if (Date.now() > deadline)
+            throw new Error(`timed out waiting for ${url}`);
+        await Bun.sleep(200);
+    }
+}
+const pushScript = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './push.ts' : './push.js', import.meta.url));
+export async function runDev(options) {
+    const directory = resolve(options.directory);
+    const stateDir = join(directory, '.workerstack', 'dev');
+    const group = new ProcessGroup();
+    const say = (line) => group.log('dev', line);
+    const userEnv = await readUserEnv(directory);
+    const external = Boolean(userEnv.WORKERSTACK_DATABASE_URL);
+    if (!(await hasViteConfig(directory))) {
+        say('vite.config.ts is missing; add workerstack() to it');
+        return 1;
+    }
+    const sqld = external ? '' : await resolveBinary('sqld', { log: say });
+    const plan = planDev({
+        directory,
+        stateDir,
+        userEnv,
+        ports: {
+            // An explicit port is kept, and Vite fails when it is taken.
+            app: options.port ??
+                (process.env.PORT
+                    ? Number(process.env.PORT)
+                    : await firstFreePort(5173)),
+            db: await freePort(),
+        },
+        binaries: { sqld },
+    });
+    // Children run in their own process groups, so the terminal's Ctrl+C does
+    // not reach them; group.stop() passes it on.
+    let interrupted = false;
+    const interrupt = new Promise((resolveInterrupt) => {
+        for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+            process.once(signal, () => {
+                interrupted = true;
+                resolveInterrupt();
+            });
+        }
+    });
+    const cancelled = () => interrupted;
+    let watcher;
+    try {
+        await mkdir(stateDir, { recursive: true });
+        if (plan.sqld) {
+            group.start(plan.sqld);
+            await waitForHealth(`${plan.databaseUrl}/health`, 20_000, cancelled);
+        }
+        const authSecret = await devSecret(stateDir);
+        await writeFile(join(directory, '.dev.vars'), devVars({
+            userEnv,
+            databaseUrl: plan.databaseUrl,
+            appUrl: plan.appUrl,
+            authSecret,
+        }));
+        const pushEnv = {
+            ...userEnv,
+            WORKERSTACK_DATABASE_URL: plan.databaseUrl,
+            AUTH_SECRET: userEnv.AUTH_SECRET || authSecret,
+            APP_URL: plan.appUrl,
+        };
+        const push = async () => {
+            const child = Bun.spawn([process.execPath, pushScript, directory], {
+                cwd: directory,
+                env: { ...process.env, ...pushEnv },
+                stdout: 'pipe',
+                stderr: 'pipe',
+            });
+            const [out, err, code] = await Promise.all([
+                new Response(child.stdout).text(),
+                new Response(child.stderr).text(),
+                child.exited,
+            ]);
+            // drizzle-kit draws a spinner with escape codes; keep the text only.
+            // oxlint-disable-next-line no-control-regex
+            const text = `${out}${err}`.replace(/\x1b\[[0-9;]*[A-Za-z]/g, '');
+            for (const line of text.trim().split('\n')) {
+                if (line.trim())
+                    group.log('push', line.trim());
+            }
+            if (code !== 0)
+                group.log('push', 'failed; fix the code and save again');
+            return code === 0;
+        };
+        // The first push writes the blueprint and wrangler.json, which the
+        // Cloudflare plugin in Vite reads at start.
+        await push();
+        let timer;
+        let running = Promise.resolve(true);
+        watcher = watch(join(directory, 'src'), { recursive: true }, (_, file) => {
+            if (file && String(file).endsWith('routeTree.gen.ts'))
+                return;
+            clearTimeout(timer);
+            timer = setTimeout(() => {
+                running = running.then(push);
+            }, 300);
+        });
+        if (!interrupted)
+            group.start(plan.vite);
+        await waitForHealth(`${plan.appUrl}/api/health`, 60_000, cancelled).catch(() => say('the Worker did not answer /api/health yet; see the vite log'));
+        if (!interrupted)
+            say(`App: ${plan.appUrl}`);
+        const outcome = await Promise.race([group.exited, interrupt]);
+        if (outcome && !interrupted) {
+            say(`${outcome.name} exited with code ${outcome.code}; stopping`);
+            return 1;
+        }
+        return 0;
+    }
+    catch (error) {
+        say(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+    finally {
+        watcher?.close();
+        await group.stop();
+    }
+}
+export async function runBuild(options) {
+    const directory = resolve(options.directory);
+    try {
+        await generateBlueprint({ directory, check: true });
+        console.log('workerstack.blueprint.yaml is current');
+        await runWranglerCommand({ directory });
+        console.log('wrote wrangler.json');
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+    if (!(await hasViteConfig(directory))) {
+        console.error('[workerstack] vite.config.ts is missing; add workerstack() to it');
+        return 1;
+    }
+    const vite = Bun.spawn([process.execPath, 'x', '--bun', 'vite', 'build'], {
+        cwd: directory,
+        stdout: 'inherit',
+        stderr: 'inherit',
+    });
+    if ((await vite.exited) !== 0)
+        return 1;
+    for (const path of await cleanArtifact(directory)) {
+        console.log(`removed ${path}`);
+    }
+    if (!(await Bun.file(join(directory, 'dist/server/index.js')).exists())) {
+        console.error('[workerstack] the build did not produce dist/server/index.js');
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/dev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"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","sourcesContent":["// `workerstack dev` and `workerstack build`. dev starts sqld and Vite, which\n// runs the Worker (SSR, /api, Durable Objects) in workerd through the\n// Cloudflare plugin; build checks workerstack.blueprint.yaml, writes\n// wrangler.json from it, and builds dist/server and dist/client with Vite.\nimport { watch } from 'node:fs'\nimport { mkdir, readdir, rm, writeFile } from 'node:fs/promises'\nimport { createServer } from 'node:net'\nimport { join, relative, resolve, sep } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { generateBlueprint } from '../blueprint-generator'\nimport { runWranglerCommand } from '../workers/wrangler'\nimport { resolveBinary } from './binaries'\nimport { devSecret, devVars, readUserEnv } from './env'\nimport { ProcessGroup, type ProcessSpec } from './processes'\n\nexport type DevPlan = {\n  appUrl: string\n  databaseUrl: string\n  sqld?: ProcessSpec\n  vite: ProcessSpec\n}\n\nexport function planDev(input: {\n  directory: string\n  stateDir: string\n  userEnv: Record<string, string>\n  ports: { app: number; db: number }\n  binaries: { sqld: string }\n}): DevPlan {\n  const { directory, ports, binaries } = input\n  const external = input.userEnv.WORKERSTACK_DATABASE_URL\n  const databaseUrl = external || `http://127.0.0.1:${ports.db}`\n  return {\n    // localhost, not 127.0.0.1: auth checks the Origin against APP_URL.\n    appUrl: `http://localhost:${ports.app}`,\n    databaseUrl,\n    sqld: external\n      ? undefined\n      : {\n          name: 'sqld',\n          cmd: [\n            binaries.sqld,\n            '--http-listen-addr',\n            `127.0.0.1:${ports.db}`,\n            '-d',\n            join(input.stateDir, 'db'),\n          ],\n          cwd: directory,\n        },\n    vite: {\n      name: 'vite',\n      cmd: [\n        process.execPath,\n        'x',\n        '--bun',\n        'vite',\n        '--port',\n        String(ports.app),\n        '--strictPort',\n      ],\n      cwd: directory,\n    },\n  }\n}\n\n/**\n * Removes what a host must not deploy: the Cloudflare plugin's\n * `.assetsignore` (celld rejects it) and every `.dev.vars` (the plugin copies\n * the local one into dist/server). Returns the removed paths.\n */\nexport async function cleanArtifact(directory: string): Promise<string[]> {\n  const dist = join(directory, 'dist')\n  const entries = await readdir(dist, {\n    recursive: true,\n    withFileTypes: true,\n  }).catch(() => [])\n  const removed: string[] = []\n  for (const entry of entries) {\n    if (!entry.isFile()) continue\n    const path = join(entry.parentPath, entry.name)\n    const rel = relative(directory, path).split(sep).join('/')\n    if (entry.name === '.dev.vars' || rel === 'dist/client/.assetsignore') {\n      await rm(path, { force: true })\n      removed.push(rel)\n    }\n  }\n  return removed\n}\n\nasync function hasViteConfig(directory: string) {\n  const files = await readdir(directory)\n  return files.some((file) => /^vite\\.config\\.[cm]?[jt]s$/.test(file))\n}\n\nasync function freePort(): Promise<number> {\n  return new Promise((resolvePort, reject) => {\n    const server = createServer()\n    server.listen(0, '127.0.0.1', () => {\n      const address = server.address()\n      server.close(() =>\n        typeof address === 'object' && address\n          ? resolvePort(address.port)\n          : reject(new Error('no free port')),\n      )\n    })\n  })\n}\n\nfunction canListen(port: number, hostname: string): boolean {\n  try {\n    Bun.listen({ hostname, port, socket: { data() {} } }).stop(true)\n    return true\n  } catch (error) {\n    // No IPv6 on this machine: nothing can take the port there either.\n    return (error as { code?: string }).code === 'EADDRNOTAVAIL'\n  }\n}\n\n/**\n * The first port from `start` that is free on 127.0.0.1 and on ::1. The\n * browser opens `localhost`, which can resolve to either; Vite on ::1 next to\n * another server on 127.0.0.1 would answer only some requests.\n */\nexport async function firstFreePort(start: number): Promise<number> {\n  for (let port = start; port < start + 100; port++) {\n    if (canListen(port, '127.0.0.1') && canListen(port, '::1')) return port\n  }\n  throw new Error(`[workerstack] no free port from ${start}`)\n}\n\nasync function waitForHealth(\n  url: string,\n  timeoutMs: number,\n  cancelled: () => boolean,\n) {\n  const deadline = Date.now() + timeoutMs\n  for (;;) {\n    if (cancelled()) return\n    const ok = await fetch(url).then(\n      (res) => res.ok,\n      () => false,\n    )\n    if (ok) return\n    if (Date.now() > deadline) throw new Error(`timed out waiting for ${url}`)\n    await Bun.sleep(200)\n  }\n}\n\nconst pushScript = fileURLToPath(\n  new URL(\n    import.meta.url.endsWith('.ts') ? './push.ts' : './push.js',\n    import.meta.url,\n  ),\n)\n\nexport async function runDev(options: {\n  directory: string\n  port?: number\n}): Promise<number> {\n  const directory = resolve(options.directory)\n  const stateDir = join(directory, '.workerstack', 'dev')\n  const group = new ProcessGroup()\n  const say = (line: string) => group.log('dev', line)\n\n  const userEnv = await readUserEnv(directory)\n  const external = Boolean(userEnv.WORKERSTACK_DATABASE_URL)\n  if (!(await hasViteConfig(directory))) {\n    say('vite.config.ts is missing; add workerstack() to it')\n    return 1\n  }\n  const sqld = external ? '' : await resolveBinary('sqld', { log: say })\n  const plan = planDev({\n    directory,\n    stateDir,\n    userEnv,\n    ports: {\n      // An explicit port is kept, and Vite fails when it is taken.\n      app:\n        options.port ??\n        (process.env.PORT\n          ? Number(process.env.PORT)\n          : await firstFreePort(5173)),\n      db: await freePort(),\n    },\n    binaries: { sqld },\n  })\n\n  // Children run in their own process groups, so the terminal's Ctrl+C does\n  // not reach them; group.stop() passes it on.\n  let interrupted = false\n  const interrupt = new Promise<void>((resolveInterrupt) => {\n    for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP'] as const) {\n      process.once(signal, () => {\n        interrupted = true\n        resolveInterrupt()\n      })\n    }\n  })\n  const cancelled = () => interrupted\n  let watcher: ReturnType<typeof watch> | undefined\n\n  try {\n    await mkdir(stateDir, { recursive: true })\n    if (plan.sqld) {\n      group.start(plan.sqld)\n      await waitForHealth(`${plan.databaseUrl}/health`, 20_000, cancelled)\n    }\n    const authSecret = await devSecret(stateDir)\n    await writeFile(\n      join(directory, '.dev.vars'),\n      devVars({\n        userEnv,\n        databaseUrl: plan.databaseUrl,\n        appUrl: plan.appUrl,\n        authSecret,\n      }),\n    )\n    const pushEnv = {\n      ...userEnv,\n      WORKERSTACK_DATABASE_URL: plan.databaseUrl,\n      AUTH_SECRET: userEnv.AUTH_SECRET || authSecret,\n      APP_URL: plan.appUrl,\n    }\n    const push = async () => {\n      const child = Bun.spawn([process.execPath, pushScript, directory], {\n        cwd: directory,\n        env: { ...process.env, ...pushEnv },\n        stdout: 'pipe',\n        stderr: 'pipe',\n      })\n      const [out, err, code] = await Promise.all([\n        new Response(child.stdout).text(),\n        new Response(child.stderr).text(),\n        child.exited,\n      ])\n      // drizzle-kit draws a spinner with escape codes; keep the text only.\n      // oxlint-disable-next-line no-control-regex\n      const text = `${out}${err}`.replace(/\\x1b\\[[0-9;]*[A-Za-z]/g, '')\n      for (const line of text.trim().split('\\n')) {\n        if (line.trim()) group.log('push', line.trim())\n      }\n      if (code !== 0) group.log('push', 'failed; fix the code and save again')\n      return code === 0\n    }\n    // The first push writes the blueprint and wrangler.json, which the\n    // Cloudflare plugin in Vite reads at start.\n    await push()\n\n    let timer: ReturnType<typeof setTimeout> | undefined\n    let running = Promise.resolve(true)\n    watcher = watch(join(directory, 'src'), { recursive: true }, (_, file) => {\n      if (file && String(file).endsWith('routeTree.gen.ts')) return\n      clearTimeout(timer)\n      timer = setTimeout(() => {\n        running = running.then(push)\n      }, 300)\n    })\n\n    if (!interrupted) group.start(plan.vite)\n    await waitForHealth(`${plan.appUrl}/api/health`, 60_000, cancelled).catch(\n      () => say('the Worker did not answer /api/health yet; see the vite log'),\n    )\n    if (!interrupted) say(`App: ${plan.appUrl}`)\n\n    const outcome = await Promise.race([group.exited, interrupt])\n    if (outcome && !interrupted) {\n      say(`${outcome.name} exited with code ${outcome.code}; stopping`)\n      return 1\n    }\n    return 0\n  } catch (error) {\n    say(error instanceof Error ? error.message : String(error))\n    return 1\n  } finally {\n    watcher?.close()\n    await group.stop()\n  }\n}\n\nexport async function runBuild(options: {\n  directory: string\n}): Promise<number> {\n  const directory = resolve(options.directory)\n  try {\n    await generateBlueprint({ directory, check: true })\n    console.log('workerstack.blueprint.yaml is current')\n    await runWranglerCommand({ directory })\n    console.log('wrote wrangler.json')\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error))\n    return 1\n  }\n  if (!(await hasViteConfig(directory))) {\n    console.error(\n      '[workerstack] vite.config.ts is missing; add workerstack() to it',\n    )\n    return 1\n  }\n  const vite = Bun.spawn([process.execPath, 'x', '--bun', 'vite', 'build'], {\n    cwd: directory,\n    stdout: 'inherit',\n    stderr: 'inherit',\n  })\n  if ((await vite.exited) !== 0) return 1\n  for (const path of await cleanArtifact(directory)) {\n    console.log(`removed ${path}`)\n  }\n  if (!(await Bun.file(join(directory, 'dist/server/index.js')).exists())) {\n    console.error(\n      '[workerstack] the build did not produce dist/server/index.js',\n    )\n    return 1\n  }\n  return 0\n}\n"]}