bunderstack 0.25.2 → 1.0.0-beta.2

package/dist/dev/index.js

@@ -0,0 +1,290 @@
+// `bunderstack dev` and `bunderstack build`. dev starts sqld, celld, and Vite
+// with one command; build writes the SPA to dist/client and checks
+// wrangler.json and bunderstack.blueprint.yaml.
+import { watch } from 'node:fs';
+import { mkdir, readdir, writeFile } from 'node:fs/promises';
+import { createServer } from 'node:net';
+import { dirname, join, resolve } 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';
+const LOG_LINE = /^\S+Z\s+(TRACE|DEBUG|INFO|WARN|ERROR)\s+([\w:]+): (.*)$/;
+/**
+ * celld --logs mixes the Worker's console output with its own INFO lines.
+ * Keep the Worker output (without the timestamp), warnings, errors, and the
+ * start summary.
+ */
+export function celldLine(line) {
+    if (line.startsWith('<jemalloc>'))
+        return undefined;
+    const match = LOG_LINE.exec(line);
+    if (!match)
+        return line;
+    const [, level, target, message] = match;
+    if (target === 'cell_console')
+        return message;
+    if (target === 'celld::memory')
+        return undefined; // allocator notice on macOS
+    if (level === 'WARN' || level === 'ERROR')
+        return `${level} ${message}`;
+    return undefined;
+}
+export function planDev(input) {
+    const { directory, ports, binaries } = input;
+    const apiUrl = `http://127.0.0.1:${ports.api}`;
+    const appUrl = input.hasVite ? `http://localhost:${ports.app}` : apiUrl;
+    const external = input.userEnv.BUNDERSTACK_DATABASE_URL;
+    const databaseUrl = external || `http://127.0.0.1:${ports.db}`;
+    return {
+        appUrl,
+        apiUrl,
+        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,
+            },
+        worker: {
+            name: 'celld',
+            cmd: [
+                binaries.celld,
+                'dev',
+                directory,
+                '--port',
+                String(ports.api),
+                // Shows the Worker's console output.
+                '--logs',
+                // sqld writes here; a rebuild per write would restart the Worker.
+                '--watch-ignore',
+                '.bunderstack/**',
+                '--watch-ignore',
+                'dist/**',
+            ],
+            cwd: directory,
+            env: { CELLD_ESBUILD: binaries.esbuild },
+            filter: celldLine,
+        },
+        vite: input.hasVite
+            ? {
+                name: 'vite',
+                cmd: [
+                    process.execPath,
+                    'x',
+                    '--bun',
+                    'vite',
+                    '--port',
+                    String(ports.app),
+                    '--strictPort',
+                ],
+                cwd: directory,
+                env: { BUNDERSTACK_DEV_API_URL: apiUrl },
+            }
+            : undefined,
+    };
+}
+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(`[bunderstack] 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);
+    }
+}
+function esbuildBinary() {
+    const pkg = Bun.resolveSync('esbuild/package.json', import.meta.dir);
+    return join(dirname(pkg), 'bin', 'esbuild');
+}
+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, '.bunderstack', 'dev');
+    const group = new ProcessGroup();
+    const say = (line) => group.log('dev', line);
+    const userEnv = await readUserEnv(directory);
+    const external = Boolean(userEnv.BUNDERSTACK_DATABASE_URL);
+    const [celld, sqld] = await Promise.all([
+        resolveBinary('celld', { log: say }),
+        external ? '' : resolveBinary('sqld', { log: say }),
+    ]);
+    const plan = planDev({
+        directory,
+        stateDir,
+        userEnv,
+        hasVite: await hasViteConfig(directory),
+        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)),
+            api: await freePort(),
+            db: await freePort(),
+        },
+        binaries: { celld, sqld, esbuild: esbuildBinary() },
+    });
+    // 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,
+            BUNDERSTACK_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 also writes wrangler.json, which celld 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);
+        });
+        group.start(plan.worker);
+        await waitForHealth(`${plan.apiUrl}/api/health`, 60_000, cancelled).catch(() => say('the Worker did not answer /api/health yet; see the celld log'));
+        if (plan.vite && !interrupted)
+            group.start(plan.vite);
+        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);
+    if (await hasViteConfig(directory)) {
+        const vite = Bun.spawn([process.execPath, 'x', '--bun', 'vite', 'build'], {
+            cwd: directory,
+            stdout: 'inherit',
+            stderr: 'inherit',
+        });
+        if ((await vite.exited) !== 0)
+            return 1;
+    }
+    try {
+        await runWranglerCommand({ directory, check: true });
+        console.log('wrangler.json is current');
+        await generateBlueprint({ directory, check: true });
+        console.log('bunderstack.blueprint.yaml is current');
+        return 0;
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+}
+//# 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":["// `bunderstack dev` and `bunderstack build`. dev starts sqld, celld, and Vite\n// with one command; build writes the SPA to dist/client and checks\n// wrangler.json and bunderstack.blueprint.yaml.\nimport { watch } from 'node:fs'\nimport { mkdir, readdir, writeFile } from 'node:fs/promises'\nimport { createServer } from 'node:net'\nimport { dirname, join, resolve } 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  apiUrl: string\n  databaseUrl: string\n  sqld?: ProcessSpec\n  worker: ProcessSpec\n  vite?: ProcessSpec\n}\n\nconst LOG_LINE = /^\\S+Z\\s+(TRACE|DEBUG|INFO|WARN|ERROR)\\s+([\\w:]+): (.*)$/\n\n/**\n * celld --logs mixes the Worker's console output with its own INFO lines.\n * Keep the Worker output (without the timestamp), warnings, errors, and the\n * start summary.\n */\nexport function celldLine(line: string): string | undefined {\n  if (line.startsWith('<jemalloc>')) return undefined\n  const match = LOG_LINE.exec(line)\n  if (!match) return line\n  const [, level, target, message] = match as unknown as [\n    string,\n    string,\n    string,\n    string,\n  ]\n  if (target === 'cell_console') return message\n  if (target === 'celld::memory') return undefined // allocator notice on macOS\n  if (level === 'WARN' || level === 'ERROR') return `${level} ${message}`\n  return undefined\n}\n\nexport function planDev(input: {\n  directory: string\n  stateDir: string\n  userEnv: Record<string, string>\n  hasVite: boolean\n  ports: { app: number; api: number; db: number }\n  binaries: { celld: string; sqld: string; esbuild: string }\n}): DevPlan {\n  const { directory, ports, binaries } = input\n  const apiUrl = `http://127.0.0.1:${ports.api}`\n  const appUrl = input.hasVite ? `http://localhost:${ports.app}` : apiUrl\n  const external = input.userEnv.BUNDERSTACK_DATABASE_URL\n  const databaseUrl = external || `http://127.0.0.1:${ports.db}`\n  return {\n    appUrl,\n    apiUrl,\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    worker: {\n      name: 'celld',\n      cmd: [\n        binaries.celld,\n        'dev',\n        directory,\n        '--port',\n        String(ports.api),\n        // Shows the Worker's console output.\n        '--logs',\n        // sqld writes here; a rebuild per write would restart the Worker.\n        '--watch-ignore',\n        '.bunderstack/**',\n        '--watch-ignore',\n        'dist/**',\n      ],\n      cwd: directory,\n      env: { CELLD_ESBUILD: binaries.esbuild },\n      filter: celldLine,\n    },\n    vite: input.hasVite\n      ? {\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          env: { BUNDERSTACK_DEV_API_URL: apiUrl },\n        }\n      : undefined,\n  }\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(`[bunderstack] 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\nfunction esbuildBinary() {\n  const pkg = Bun.resolveSync('esbuild/package.json', import.meta.dir)\n  return join(dirname(pkg), 'bin', 'esbuild')\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, '.bunderstack', '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.BUNDERSTACK_DATABASE_URL)\n  const [celld, sqld] = await Promise.all([\n    resolveBinary('celld', { log: say }),\n    external ? '' : resolveBinary('sqld', { log: say }),\n  ])\n  const plan = planDev({\n    directory,\n    stateDir,\n    userEnv,\n    hasVite: await hasViteConfig(directory),\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      api: await freePort(),\n      db: await freePort(),\n    },\n    binaries: { celld, sqld, esbuild: esbuildBinary() },\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      BUNDERSTACK_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 also writes wrangler.json, which celld 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    group.start(plan.worker)\n    await waitForHealth(`${plan.apiUrl}/api/health`, 60_000, cancelled).catch(\n      () => say('the Worker did not answer /api/health yet; see the celld log'),\n    )\n    if (plan.vite && !interrupted) group.start(plan.vite)\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  if (await hasViteConfig(directory)) {\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  }\n  try {\n    await runWranglerCommand({ directory, check: true })\n    console.log('wrangler.json is current')\n    await generateBlueprint({ directory, check: true })\n    console.log('bunderstack.blueprint.yaml is current')\n    return 0\n  } catch (error) {\n    console.error(error instanceof Error ? error.message : String(error))\n    return 1\n  }\n}\n"]}

package/dist/dev/processes.d.ts

@@ -0,0 +1,37 @@
+export type ProcessSpec = {
+    name: string;
+    cmd: string[];
+    cwd: string;
+    env?: Record<string, string>;
+    /** Rewrites an output line; `undefined` drops it. */
+    filter?: (line: string) => string | undefined;
+};
+export declare function prefixLines(chunk: string, pending: string): {
+    lines: string[];
+    pending: string;
+};
+export declare class ProcessGroup {
+    private write;
+    readonly exited: Promise<{
+        name: string;
+        code: number | null;
+    }>;
+    private children;
+    private resolveExit;
+    private stopping;
+    private width;
+    constructor(write?: (line: string) => void);
+    private label;
+    private names;
+    private labelIndex;
+    /** Writes one line with the name's prefix; the dev command logs here too. */
+    log(name: string, line: string): void;
+    start(spec: ProcessSpec): void;
+    /**
+     * SIGINT to each child's process group, as Ctrl+C in a terminal does, then
+     * SIGKILL to the groups after 3 s. `celld dev` runs a node process that
+     * ignores SIGTERM, so a signal to the leader alone leaves it running.
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=processes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processes.d.ts","sourceRoot":"","sources":["../../src/dev/processes.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,qDAAqD;IACrD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CAC9C,CAAA;AAID,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAItC;AAED,qBAAa,YAAY;IAQrB,OAAO,CAAC,KAAK;IAPf,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IAC/D,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,WAAW,CAAyD;IAC5E,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAAI;gBAGP,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkC;IAKrE,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,UAAU;IAKlB,6EAA6E;IAC7E,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAM9B,KAAK,CAAC,IAAI,EAAE,WAAW;IAqCvB;;;;OAIG;IACG,IAAI;CAmBX"}

package/dist/dev/processes.js

@@ -0,0 +1,104 @@
+const COLORS = [36, 35, 33, 32, 34];
+export function prefixLines(chunk, pending) {
+    const parts = (pending + chunk).split(/\r?\n/);
+    const rest = parts.pop() ?? '';
+    return { lines: parts, pending: rest };
+}
+export class ProcessGroup {
+    write;
+    exited;
+    children = [];
+    resolveExit;
+    stopping = false;
+    width = 0;
+    constructor(write = (line) => console.log(line)) {
+        this.write = write;
+        this.exited = new Promise((resolve) => (this.resolveExit = resolve));
+    }
+    label(name) {
+        const text = `[${name}]`.padEnd(this.width + 2);
+        if (!process.stdout.isTTY)
+            return text;
+        const color = COLORS[this.labelIndex(name) % COLORS.length];
+        return `\x1b[${color}m${text}\x1b[0m`;
+    }
+    names = [];
+    labelIndex(name) {
+        if (!this.names.includes(name))
+            this.names.push(name);
+        return this.names.indexOf(name);
+    }
+    /** Writes one line with the name's prefix; the dev command logs here too. */
+    log(name, line) {
+        this.labelIndex(name);
+        this.width = Math.max(this.width, name.length);
+        this.write(`${this.label(name)} ${line}`);
+    }
+    start(spec) {
+        this.width = Math.max(this.width, spec.name.length);
+        const child = Bun.spawn(spec.cmd, {
+            cwd: spec.cwd,
+            env: { ...process.env, ...spec.env },
+            stdin: 'ignore',
+            // Own process group, so stop() reaches the child's children too.
+            detached: true,
+            stdout: 'pipe',
+            stderr: 'pipe',
+        });
+        this.children.push(child);
+        const emit = (line) => {
+            const shown = spec.filter ? spec.filter(line) : line;
+            if (shown !== undefined)
+                this.log(spec.name, shown);
+        };
+        const pump = async (stream) => {
+            let pending = '';
+            const decoder = new TextDecoder();
+            const reader = stream.getReader();
+            for (;;) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const chunk = decoder.decode(value, { stream: true });
+                const result = prefixLines(chunk, pending);
+                pending = result.pending;
+                for (const line of result.lines)
+                    emit(line);
+            }
+            if (pending)
+                emit(pending);
+        };
+        const output = Promise.all([pump(child.stdout), pump(child.stderr)]);
+        void child.exited.then(async (code) => {
+            await output.catch(() => { });
+            if (!this.stopping)
+                this.resolveExit({ name: spec.name, code });
+        });
+    }
+    /**
+     * SIGINT to each child's process group, as Ctrl+C in a terminal does, then
+     * SIGKILL to the groups after 3 s. `celld dev` runs a node process that
+     * ignores SIGTERM, so a signal to the leader alone leaves it running.
+     */
+    async stop() {
+        this.stopping = true;
+        const signal = (sig) => {
+            for (const child of this.children) {
+                try {
+                    process.kill(-child.pid, sig);
+                }
+                catch {
+                    // The group is gone already.
+                }
+            }
+        };
+        signal('SIGINT');
+        await Promise.race([
+            Promise.allSettled(this.children.map((child) => child.exited)),
+            Bun.sleep(3_000),
+        ]);
+        signal('SIGKILL');
+        await Promise.allSettled(this.children.map((child) => child.exited));
+    }
+}
+//# sourceMappingURL=processes.js.map

package/dist/dev/processes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes.js","sourceRoot":"","sources":["../../src/dev/processes.ts"],"names":[],"mappings":"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","sourcesContent":["// The child processes of `bunderstack dev`: one log with a prefix per process,\n// and one stop for all of them.\nimport type { Subprocess } from 'bun'\n\nexport type ProcessSpec = {\n  name: string\n  cmd: string[]\n  cwd: string\n  env?: Record<string, string>\n  /** Rewrites an output line; `undefined` drops it. */\n  filter?: (line: string) => string | undefined\n}\n\nconst COLORS = [36, 35, 33, 32, 34]\n\nexport function prefixLines(\n  chunk: string,\n  pending: string,\n): { lines: string[]; pending: string } {\n  const parts = (pending + chunk).split(/\\r?\\n/)\n  const rest = parts.pop() ?? ''\n  return { lines: parts, pending: rest }\n}\n\nexport class ProcessGroup {\n  readonly exited: Promise<{ name: string; code: number | null }>\n  private children: Subprocess[] = []\n  private resolveExit!: (value: { name: string; code: number | null }) => void\n  private stopping = false\n  private width = 0\n\n  constructor(\n    private write: (line: string) => void = (line) => console.log(line),\n  ) {\n    this.exited = new Promise((resolve) => (this.resolveExit = resolve))\n  }\n\n  private label(name: string) {\n    const text = `[${name}]`.padEnd(this.width + 2)\n    if (!process.stdout.isTTY) return text\n    const color = COLORS[this.labelIndex(name) % COLORS.length]\n    return `\\x1b[${color}m${text}\\x1b[0m`\n  }\n\n  private names: string[] = []\n  private labelIndex(name: string) {\n    if (!this.names.includes(name)) this.names.push(name)\n    return this.names.indexOf(name)\n  }\n\n  /** Writes one line with the name's prefix; the dev command logs here too. */\n  log(name: string, line: string) {\n    this.labelIndex(name)\n    this.width = Math.max(this.width, name.length)\n    this.write(`${this.label(name)} ${line}`)\n  }\n\n  start(spec: ProcessSpec) {\n    this.width = Math.max(this.width, spec.name.length)\n    const child = Bun.spawn(spec.cmd, {\n      cwd: spec.cwd,\n      env: { ...process.env, ...spec.env },\n      stdin: 'ignore',\n      // Own process group, so stop() reaches the child's children too.\n      detached: true,\n      stdout: 'pipe',\n      stderr: 'pipe',\n    })\n    this.children.push(child)\n    const emit = (line: string) => {\n      const shown = spec.filter ? spec.filter(line) : line\n      if (shown !== undefined) this.log(spec.name, shown)\n    }\n    const pump = async (stream: ReadableStream<Uint8Array>) => {\n      let pending = ''\n      const decoder = new TextDecoder()\n      const reader = stream.getReader()\n      for (;;) {\n        const { done, value } = await reader.read()\n        if (done) break\n        const chunk = decoder.decode(value, { stream: true })\n        const result = prefixLines(chunk, pending)\n        pending = result.pending\n        for (const line of result.lines) emit(line)\n      }\n      if (pending) emit(pending)\n    }\n    const output = Promise.all([pump(child.stdout), pump(child.stderr)])\n    void child.exited.then(async (code) => {\n      await output.catch(() => {})\n      if (!this.stopping) this.resolveExit({ name: spec.name, code })\n    })\n  }\n\n  /**\n   * SIGINT to each child's process group, as Ctrl+C in a terminal does, then\n   * SIGKILL to the groups after 3 s. `celld dev` runs a node process that\n   * ignores SIGTERM, so a signal to the leader alone leaves it running.\n   */\n  async stop() {\n    this.stopping = true\n    const signal = (sig: NodeJS.Signals) => {\n      for (const child of this.children) {\n        try {\n          process.kill(-child.pid, sig)\n        } catch {\n          // The group is gone already.\n        }\n      }\n    }\n    signal('SIGINT')\n    await Promise.race([\n      Promise.allSettled(this.children.map((child) => child.exited)),\n      Bun.sleep(3_000),\n    ])\n    signal('SIGKILL')\n    await Promise.allSettled(this.children.map((child) => child.exited))\n  }\n}\n"]}

package/dist/dev/push.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=push.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/dev/push.ts"],"names":[],"mappings":""}

package/dist/dev/push.js

@@ -0,0 +1,30 @@
+// Subprocess of `bunderstack dev`: `bun push.ts <app directory>`. A fresh
+// process sees the current app code on each run. It regenerates wrangler.json
+// and bunderstack.blueprint.yaml, and pushes the schema (or applies committed
+// migrations) to the dev database.
+import { generateBlueprint } from '../blueprint-generator.js';
+import { loadBackend, runWranglerCommand } from '../workers/wrangler.js';
+const directory = process.argv[2];
+if (!directory)
+    throw new Error('usage: push.ts <app directory>');
+const wrangler = await runWranglerCommand({ directory });
+if (wrangler.changed)
+    console.log('wrangler.json updated');
+const blueprint = await generateBlueprint({ directory });
+if (blueprint.changed)
+    console.log('bunderstack.blueprint.yaml updated');
+const { backend } = await loadBackend(directory);
+// Resolve from the app, so provision sees the same bunderstack instance as
+// the backend it provisions.
+const { provision } = (await import(Bun.resolveSync('bunderstack/provision-schema', directory)));
+const app = (await backend.start({
+    env: process.env,
+}));
+try {
+    await provision(app);
+    console.log('schema is current');
+}
+finally {
+    await app.close();
+}
+//# sourceMappingURL=push.js.map

package/dist/dev/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/dev/push.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAC9E,mCAAmC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAErE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjC,IAAI,CAAC,SAAS;IAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;AAEjE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;AACxD,IAAI,QAAQ,CAAC,OAAO;IAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;AAE1D,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;AACxD,IAAI,SAAS,CAAC,OAAO;IAAE,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;AAExE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,CAAA;AAChD,2EAA2E;AAC3E,6BAA6B;AAC7B,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,MAAM,CACjC,GAAG,CAAC,WAAW,CAAC,8BAA8B,EAAE,SAAS,CAAC,CAC3D,CAAyC,CAAA;AAC1C,MAAM,GAAG,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC;IAC/B,GAAG,EAAE,OAAO,CAAC,GAAyC;CACvD,CAAC,CAA+B,CAAA;AACjC,IAAI,CAAC;IACH,MAAM,SAAS,CAAC,GAAG,CAAC,CAAA;IACpB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA;AAClC,CAAC;QAAS,CAAC;IACT,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;AACnB,CAAC","sourcesContent":["// Subprocess of `bunderstack dev`: `bun push.ts <app directory>`. A fresh\n// process sees the current app code on each run. It regenerates wrangler.json\n// and bunderstack.blueprint.yaml, and pushes the schema (or applies committed\n// migrations) to the dev database.\nimport { generateBlueprint } from '../blueprint-generator'\nimport { loadBackend, runWranglerCommand } from '../workers/wrangler'\n\nconst directory = process.argv[2]\nif (!directory) throw new Error('usage: push.ts <app directory>')\n\nconst wrangler = await runWranglerCommand({ directory })\nif (wrangler.changed) console.log('wrangler.json updated')\n\nconst blueprint = await generateBlueprint({ directory })\nif (blueprint.changed) console.log('bunderstack.blueprint.yaml updated')\n\nconst { backend } = await loadBackend(directory)\n// Resolve from the app, so provision sees the same bunderstack instance as\n// the backend it provisions.\nconst { provision } = (await import(\n  Bun.resolveSync('bunderstack/provision-schema', directory)\n)) as typeof import('../provision-schema')\nconst app = (await backend.start({\n  env: process.env as Record<string, string | undefined>,\n})) as { close(): Promise<void> }\ntry {\n  await provision(app)\n  console.log('schema is current')\n} finally {\n  await app.close()\n}\n"]}

package/dist/env-probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env-probe.d.ts","sourceRoot":"","sources":["../src/env-probe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAyB3C,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,GAAG,EAAE,MAAM;CAOxB;AAmCD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,GAAG,SAAS,EACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC7C,SAAS;IACV,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAUA"}
+{"version":3,"file":"env-probe.d.ts","sourceRoot":"","sources":["../src/env-probe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAwB3C,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,GAAG,EAAE,MAAM;CAOxB;AAmCD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,GAAG,SAAS,EACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAC7C,SAAS;IACV,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAUA"}

package/dist/env-probe.js

@@ -16,7 +16,6 @@ const BASE_SOURCE = {
     NODE_ENV: 'production',
     AUTH_SECRET: 'bunderstack-blueprint-probe-secret',
     DATABASE_URL: 'file:./bunderstack-blueprint-probe.db',
-    BUNDERSTACK_ROLE: 'all',
 };
 export class BlueprintProbeError extends Error {
     constructor(key) {

package/dist/env-probe.js.map

@@ -1 +1 @@
-{"version":3,"file":"env-probe.js","sourceRoot":"","sources":["../src/env-probe.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec'\n\nimport type { EnvConfigInput } from './env'\n\nimport { validateStandardSchema } from './standard-schema'\n\nconst CANDIDATES: readonly (string | undefined)[] = [\n  undefined,\n  '',\n  'probe',\n  'true',\n  'false',\n  '0',\n  '1',\n  'https://example.invalid',\n  'file:./bunderstack-probe.db',\n  'probe@example.invalid',\n  '00000000-0000-4000-8000-000000000000',\n]\n\nconst BASE_SOURCE = {\n  NODE_ENV: 'production',\n  AUTH_SECRET: 'bunderstack-blueprint-probe-secret',\n  DATABASE_URL: 'file:./bunderstack-blueprint-probe.db',\n  BUNDERSTACK_ROLE: 'all',\n} satisfies Record<string, string | undefined>\n\nexport class BlueprintProbeError extends Error {\n  constructor(key: string) {\n    super(\n      `[bunderstack] cannot synthesize a valid blueprint probe for env key ${key}; ` +\n        'provide a valid value while generating the blueprint',\n    )\n    this.name = 'BlueprintProbeError'\n  }\n}\n\nfunction identity(value: unknown): string {\n  if (value === undefined) return 'undefined'\n  if (typeof value === 'number' && Number.isNaN(value)) return 'number:NaN'\n  try {\n    return `${typeof value}:${JSON.stringify(value)}`\n  } catch {\n    return `${typeof value}:${String(value)}`\n  }\n}\n\nfunction acceptedValues(\n  key: string,\n  schema: StandardSchemaV1,\n  configured: string | undefined,\n): (string | undefined)[] {\n  const accepted: (string | undefined)[] = []\n  const outputs = new Set<string>()\n  for (const candidate of [configured, ...CANDIDATES]) {\n    try {\n      const output = validateStandardSchema(schema, candidate, 'env')\n      const id = identity(output)\n      if (outputs.has(id)) continue\n      outputs.add(id)\n      accepted.push(candidate)\n      if (accepted.length === 2) return accepted\n    } catch {\n      // Candidate failures are expected. The eventual error names only the key.\n    }\n  }\n  if (accepted.length === 0) throw new BlueprintProbeError(key)\n  return accepted\n}\n\nexport function createEnvProbeSources(\n  envSchema: EnvConfigInput | undefined,\n  configured: Record<string, string | undefined>,\n): readonly [\n  Record<string, string | undefined>,\n  Record<string, string | undefined>,\n] {\n  const first: Record<string, string | undefined> = { ...BASE_SOURCE }\n  const second: Record<string, string | undefined> = { ...BASE_SOURCE }\n  const variables = { ...envSchema?.server, ...envSchema?.client }\n  for (const [key, schema] of Object.entries(variables)) {\n    const values = acceptedValues(key, schema, configured[key])\n    first[key] = values[0]\n    second[key] = values[1] ?? values[0]\n  }\n  return [first, second]\n}\n"]}
+{"version":3,"file":"env-probe.js","sourceRoot":"","sources":["../src/env-probe.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec'\n\nimport type { EnvConfigInput } from './env'\n\nimport { validateStandardSchema } from './standard-schema'\n\nconst CANDIDATES: readonly (string | undefined)[] = [\n  undefined,\n  '',\n  'probe',\n  'true',\n  'false',\n  '0',\n  '1',\n  'https://example.invalid',\n  'file:./bunderstack-probe.db',\n  'probe@example.invalid',\n  '00000000-0000-4000-8000-000000000000',\n]\n\nconst BASE_SOURCE = {\n  NODE_ENV: 'production',\n  AUTH_SECRET: 'bunderstack-blueprint-probe-secret',\n  DATABASE_URL: 'file:./bunderstack-blueprint-probe.db',\n} satisfies Record<string, string | undefined>\n\nexport class BlueprintProbeError extends Error {\n  constructor(key: string) {\n    super(\n      `[bunderstack] cannot synthesize a valid blueprint probe for env key ${key}; ` +\n        'provide a valid value while generating the blueprint',\n    )\n    this.name = 'BlueprintProbeError'\n  }\n}\n\nfunction identity(value: unknown): string {\n  if (value === undefined) return 'undefined'\n  if (typeof value === 'number' && Number.isNaN(value)) return 'number:NaN'\n  try {\n    return `${typeof value}:${JSON.stringify(value)}`\n  } catch {\n    return `${typeof value}:${String(value)}`\n  }\n}\n\nfunction acceptedValues(\n  key: string,\n  schema: StandardSchemaV1,\n  configured: string | undefined,\n): (string | undefined)[] {\n  const accepted: (string | undefined)[] = []\n  const outputs = new Set<string>()\n  for (const candidate of [configured, ...CANDIDATES]) {\n    try {\n      const output = validateStandardSchema(schema, candidate, 'env')\n      const id = identity(output)\n      if (outputs.has(id)) continue\n      outputs.add(id)\n      accepted.push(candidate)\n      if (accepted.length === 2) return accepted\n    } catch {\n      // Candidate failures are expected. The eventual error names only the key.\n    }\n  }\n  if (accepted.length === 0) throw new BlueprintProbeError(key)\n  return accepted\n}\n\nexport function createEnvProbeSources(\n  envSchema: EnvConfigInput | undefined,\n  configured: Record<string, string | undefined>,\n): readonly [\n  Record<string, string | undefined>,\n  Record<string, string | undefined>,\n] {\n  const first: Record<string, string | undefined> = { ...BASE_SOURCE }\n  const second: Record<string, string | undefined> = { ...BASE_SOURCE }\n  const variables = { ...envSchema?.server, ...envSchema?.client }\n  for (const [key, schema] of Object.entries(variables)) {\n    const values = acceptedValues(key, schema, configured[key])\n    first[key] = values[0]\n    second[key] = values[1] ?? values[0]\n  }\n  return [first, second]\n}\n"]}

package/dist/env.d.ts

@@ -22,21 +22,18 @@ export type EnvConfigInput = {
     /** Value-free metadata per key, keyed by the key's own name. */
     meta?: Record<string, EnvVarMeta>;
 };
-export type BunderstackRole = 'all' | 'web' | 'worker';
 /** Vars bunderstack itself consumes, always validated. */
 export type BaseEnv = {
     NODE_ENV?: string;
     DATABASE_URL: string;
     DATABASE_AUTH_TOKEN?: string;
     AUTH_SECRET: string;
-    REDIS_URL?: string;
     RESEND_API_KEY?: string;
     BUNDERSTACK_MESSAGING_CONFIG?: string;
     BUNDERSTACK_BLUEPRINT_PATH?: string;
     BUNDERHOST_ENVIRONMENT_ID?: string;
     /** Deployed commit SHA, injected by the platform. Reported by readiness. */
     BUNDERSTACK_REVISION?: string;
-    BUNDERSTACK_ROLE: BunderstackRole;
 };
 type InferVars<T> = T extends Record<string, StandardSchemaV1> ? {
     [K in keyof T]: StandardSchemaV1.InferOutput<T[K]>;

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAO7D,eAAO,MAAM,aAAa,EAAG,SAAkB,CAAA;AAE/C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAA;AAItD,0DAA0D;AAC1D,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B,CAAC,EAAE,MAAM,CAAA;IACrC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,gBAAgB,EAAE,eAAe,CAAA;CAClC,CAAA;AAED,KAAK,SAAS,CAAC,CAAC,IACd,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACtC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtD,OAAO,CAAA;AAGb,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,cAAc,GAAG,SAAS,IAAI;IAClE,IAAI;CACL,SAAS,CAAC,cAAc,CAAC,GACtB,OAAO,GACL,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,GACtC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,GACxC,OAAO,CAAA;AAEX,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;gBAEb,MAAM,EAAE,MAAM,EAAE;CAK7B;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAC3C,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAqCD,wBAAgB,WAAW,CAAC,IAAI,SAAS,cAAc,GAAG,SAAS,EACjE,SAAS,EAAE,IAAI,EACf,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAAC,IAAI,CAAC,CAqCpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,cAAc,EACzD,SAAS,EAAE,IAAI,GACd,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAsB3B"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAO7D,eAAO,MAAM,aAAa,EAAG,SAAkB,CAAA;AAE/C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACzC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAClC,CAAA;AAED,0DAA0D;AAC1D,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B,CAAC,EAAE,MAAM,CAAA;IACrC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAClC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B,CAAA;AAED,KAAK,SAAS,CAAC,CAAC,IACd,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACtC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtD,OAAO,CAAA;AAGb,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,cAAc,GAAG,SAAS,IAAI;IAClE,IAAI;CACL,SAAS,CAAC,cAAc,CAAC,GACtB,OAAO,GACL,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,GACtC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,GACxC,OAAO,CAAA;AAEX,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;gBAEb,MAAM,EAAE,MAAM,EAAE;CAK7B;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAC3C,kEAAkE;IAClE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAqCD,wBAAgB,WAAW,CAAC,IAAI,SAAS,cAAc,GAAG,SAAS,EACjE,SAAS,EAAE,IAAI,EACf,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAAC,IAAI,CAAC,CA2BpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,cAAc,EACzD,SAAS,EAAE,IAAI,GACd,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAsB3B"}