workerstack 0.1.0-beta.0

package/dist/blueprint-generator.js

@@ -0,0 +1,199 @@
+import { mkdir, readFile, realpath, rename, rm, stat, writeFile, } from 'node:fs/promises';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { parse } from 'yaml';
+import { isWorkerstackBackend } from './backend.js';
+import { BACKEND_INTERNALS } from './backend-internals.js';
+import { blueprintFromManifest, parseWorkerBlueprintYaml, serializeBlueprint, WORKER_PACKAGE_ENTRIES, } from './blueprint.js';
+import { createEnvProbeSources } from './env-probe.js';
+import { assertManifestMatchesBlueprint } from './hosted-contract.js';
+import { parseManifest } from './manifest.js';
+import { diffManifests } from './manifest-diff.js';
+export class BlueprintCheckError extends Error {
+    constructor() {
+        super('workerstack.blueprint.yaml is missing or stale; run `workerstack blueprint`');
+        this.name = 'BlueprintCheckError';
+    }
+}
+function requireRelativePath(value, label) {
+    const normalized = value.replaceAll('\\', '/');
+    if (!normalized ||
+        isAbsolute(normalized) ||
+        normalized.split('/').some((part) => !part || part === '..')) {
+        throw new Error(`[workerstack] ${label} must be a relative path without traversal`);
+    }
+    return normalized;
+}
+function resolveWithin(root, value, label) {
+    const path = resolve(root, requireRelativePath(value, label));
+    const pathFromRoot = relative(root, path);
+    if (pathFromRoot === '..' ||
+        pathFromRoot.startsWith('../') ||
+        isAbsolute(pathFromRoot)) {
+        throw new Error(`[workerstack] ${label} must stay within the application directory`);
+    }
+    return path;
+}
+function normalizeProjectPath(root, value, label) {
+    if (!isAbsolute(value))
+        return requireRelativePath(value, label);
+    const pathFromRoot = relative(root, resolve(value)) || '.';
+    return requireRelativePath(pathFromRoot, label);
+}
+function requireScript(pkg, name, required) {
+    const value = pkg.scripts?.[name];
+    if (typeof value === 'string' && value.trim())
+        return true;
+    if (required)
+        throw new Error(`[workerstack] package.json requires a non-empty "${name}" script`);
+    return false;
+}
+async function readText(path) {
+    return readFile(path, 'utf8').catch(() => undefined);
+}
+/**
+ * Worker settings survive regeneration: the committed blueprint wins, then an
+ * old wrangler.json (apps from beta.1 and beta.2), then the defaults.
+ */
+async function exists(path) {
+    return stat(path).then(() => true, () => false);
+}
+async function workerSettings(directory, existing, today, hasStart) {
+    let fromBlueprint = {};
+    try {
+        const raw = parse(existing ?? '');
+        fromBlueprint = raw?.application?.worker ?? {};
+    }
+    catch { }
+    let fromWrangler = {};
+    try {
+        const raw = JSON.parse((await readText(join(directory, 'wrangler.json'))) ?? 'null');
+        fromWrangler = {
+            main: raw?.main,
+            compatibilityDate: raw?.compatibility_date,
+            assets: raw?.assets?.directory,
+        };
+    }
+    catch { }
+    const pick = (key, fallback) => {
+        const value = fromBlueprint[key] ?? fromWrangler[key];
+        return typeof value === 'string' && value ? value : fallback;
+    };
+    const render = fromBlueprint.render === 'ssr' || fromBlueprint.render === 'spa'
+        ? fromBlueprint.render
+        : hasStart
+            ? 'ssr'
+            : 'spa';
+    // An old wrangler.json names src/worker.ts; keep it only while it exists.
+    if (fromWrangler.main &&
+        !WORKER_PACKAGE_ENTRIES.includes(fromWrangler.main) &&
+        !(await exists(join(directory, fromWrangler.main)))) {
+        fromWrangler.main = undefined;
+    }
+    const defaultMain = (await exists(join(directory, 'src/server.ts')))
+        ? 'src/server.ts'
+        : render === 'ssr'
+            ? 'workerstack/start/server-entry'
+            : 'workerstack/workers/entry';
+    return {
+        render,
+        main: pick('main', defaultMain),
+        compatibilityDate: pick('compatibilityDate', today),
+        assets: pick('assets', 'dist/client'),
+    };
+}
+async function packageVersion() {
+    const pkg = (await Bun.file(new URL('../package.json', import.meta.url)).json());
+    return pkg.version;
+}
+export async function generateBlueprint(options) {
+    const directory = await realpath(resolve(options.directory));
+    const packagePath = join(directory, 'package.json');
+    const pkg = JSON.parse(await readFile(packagePath, 'utf8'));
+    const allDependencies = { ...pkg.dependencies, ...pkg.devDependencies };
+    let framework = 'bun-ssr';
+    if (typeof allDependencies['@tanstack/react-start'] === 'string') {
+        framework = 'tanstack-start';
+    }
+    else if (typeof allDependencies['solid-js'] === 'string' ||
+        typeof allDependencies['@solidjs/web'] === 'string') {
+        framework = 'solid';
+    }
+    requireScript(pkg, 'build', true);
+    const configuredEntry = pkg.workerstack?.entry;
+    const entry = requireRelativePath(options.entry ??
+        (typeof configuredEntry === 'string'
+            ? configuredEntry
+            : 'src/workerstack.ts'), 'entry');
+    const entryPath = resolveWithin(directory, entry, 'entry');
+    if (!(await Bun.file(entryPath).exists())) {
+        throw new Error(`[workerstack] entry does not exist: ${entry}`);
+    }
+    const output = requireRelativePath(options.output ?? 'workerstack.blueprint.yaml', 'output');
+    const outputPath = resolveWithin(directory, output, 'output');
+    const module = (await import(`${pathToFileURL(entryPath).href}?blueprint=${Date.now()}`));
+    const backend = module.backend;
+    if (!isWorkerstackBackend(backend)) {
+        throw new Error(`[workerstack] ${entry} must export backend`);
+    }
+    if (options.hostedCheck) {
+        const file = Bun.file(outputPath);
+        if (!(await file.exists())) {
+            throw new Error(`[workerstack] hosted blueprint does not exist: ${output}`);
+        }
+        const source = await file.text();
+        const manifest = parseManifest(backend.inspect({ env: process.env }));
+        assertManifestMatchesBlueprint(manifest, source);
+        return {
+            path: outputPath,
+            blueprint: parseWorkerBlueprintYaml(source),
+            source,
+            changed: false,
+        };
+    }
+    const probeSources = createEnvProbeSources(backend[BACKEND_INTERNALS].envSchema, process.env);
+    const firstManifest = parseManifest(backend.inspect({ env: probeSources[0] }));
+    const secondManifest = parseManifest(backend.inspect({ env: probeSources[1] }));
+    const differences = diffManifests(firstManifest, secondManifest);
+    if (differences.length > 0) {
+        throw new Error('[workerstack] environment-dependent blueprint shape:\n' +
+            differences.map(({ kind, path }) => `  - ${kind}: ${path}`).join('\n'));
+    }
+    const manifest = firstManifest;
+    const migrationsDirectory = normalizeProjectPath(directory, manifest.database.migrationsDirectory, 'migrationsDirectory');
+    const migrationJournal = join(resolveWithin(directory, migrationsDirectory, 'migrationsDirectory'), 'meta', '_journal.json');
+    const migrationMode = (await Bun.file(migrationJournal).exists())
+        ? 'migrations'
+        : 'push';
+    const existing = await readText(outputPath);
+    const blueprint = blueprintFromManifest({
+        manifest: {
+            ...manifest,
+            database: { ...manifest.database, migrationsDirectory },
+        },
+        generatorVersion: await packageVersion(),
+        entry,
+        migrationMode,
+        framework,
+        worker: await workerSettings(directory, existing, options.today ?? new Date().toISOString().slice(0, 10), typeof allDependencies['@tanstack/react-start'] === 'string'),
+    });
+    const source = serializeBlueprint(blueprint);
+    if (options.check) {
+        if (existing !== source)
+            throw new BlueprintCheckError();
+        return { path: outputPath, blueprint, source, changed: false };
+    }
+    if (existing === source)
+        return { path: outputPath, blueprint, source, changed: false };
+    await mkdir(dirname(outputPath), { recursive: true });
+    const temporary = `${outputPath}.${process.pid}.${Date.now()}.tmp`;
+    try {
+        await writeFile(temporary, source, { mode: 0o600 });
+        await rename(temporary, outputPath);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+    return { path: outputPath, blueprint, source, changed: true };
+}
+//# sourceMappingURL=blueprint-generator.js.map

package/dist/blueprint-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint-generator.js","sourceRoot":"","sources":["../src/blueprint-generator.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  mkdir,\n  readFile,\n  realpath,\n  rename,\n  rm,\n  stat,\n  writeFile,\n} from 'node:fs/promises'\nimport { dirname, isAbsolute, join, relative, resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport { parse } from 'yaml'\n\nimport { isWorkerstackBackend } from './backend'\nimport { BACKEND_INTERNALS } from './backend-internals'\nimport {\n  blueprintFromManifest,\n  parseWorkerBlueprintYaml,\n  serializeBlueprint,\n  WORKER_PACKAGE_ENTRIES,\n  type WorkerBlueprint,\n  type WorkerRender,\n  type WorkerSettings,\n} from './blueprint'\nimport { createEnvProbeSources } from './env-probe'\nimport { assertManifestMatchesBlueprint } from './hosted-contract'\nimport { parseManifest } from './manifest'\nimport { diffManifests } from './manifest-diff'\n\nexport type GenerateBlueprintOptions = {\n  directory: string\n  entry?: string\n  output?: string\n  check?: boolean\n  hostedCheck?: boolean\n  /** UTC date for a new compatibilityDate; tests pin it. */\n  today?: string\n}\n\nexport type GenerateBlueprintResult = {\n  path: string\n  blueprint: WorkerBlueprint\n  source: string\n  changed: boolean\n}\n\nexport class BlueprintCheckError extends Error {\n  constructor() {\n    super(\n      'workerstack.blueprint.yaml is missing or stale; run `workerstack blueprint`',\n    )\n    this.name = 'BlueprintCheckError'\n  }\n}\n\ntype AppPackage = {\n  scripts?: Record<string, unknown>\n  dependencies?: Record<string, unknown>\n  devDependencies?: Record<string, unknown>\n  workerstack?: { entry?: unknown }\n}\n\nfunction requireRelativePath(value: string, label: string): string {\n  const normalized = value.replaceAll('\\\\', '/')\n  if (\n    !normalized ||\n    isAbsolute(normalized) ||\n    normalized.split('/').some((part) => !part || part === '..')\n  ) {\n    throw new Error(\n      `[workerstack] ${label} must be a relative path without traversal`,\n    )\n  }\n  return normalized\n}\n\nfunction resolveWithin(root: string, value: string, label: string): string {\n  const path = resolve(root, requireRelativePath(value, label))\n  const pathFromRoot = relative(root, path)\n  if (\n    pathFromRoot === '..' ||\n    pathFromRoot.startsWith('../') ||\n    isAbsolute(pathFromRoot)\n  ) {\n    throw new Error(\n      `[workerstack] ${label} must stay within the application directory`,\n    )\n  }\n  return path\n}\n\nfunction normalizeProjectPath(\n  root: string,\n  value: string,\n  label: string,\n): string {\n  if (!isAbsolute(value)) return requireRelativePath(value, label)\n  const pathFromRoot = relative(root, resolve(value)) || '.'\n  return requireRelativePath(pathFromRoot, label)\n}\n\nfunction requireScript(\n  pkg: AppPackage,\n  name: 'build',\n  required: boolean,\n): boolean {\n  const value = pkg.scripts?.[name]\n  if (typeof value === 'string' && value.trim()) return true\n  if (required)\n    throw new Error(\n      `[workerstack] package.json requires a non-empty \"${name}\" script`,\n    )\n  return false\n}\n\nasync function readText(path: string): Promise<string | undefined> {\n  return readFile(path, 'utf8').catch(() => undefined)\n}\n\n/**\n * Worker settings survive regeneration: the committed blueprint wins, then an\n * old wrangler.json (apps from beta.1 and beta.2), then the defaults.\n */\nasync function exists(path: string): Promise<boolean> {\n  return stat(path).then(\n    () => true,\n    () => false,\n  )\n}\n\nasync function workerSettings(\n  directory: string,\n  existing: string | undefined,\n  today: string,\n  hasStart: boolean,\n): Promise<WorkerSettings> {\n  let fromBlueprint: Partial<WorkerSettings> = {}\n  try {\n    const raw = parse(existing ?? '') as {\n      application?: { worker?: Partial<WorkerSettings> }\n    } | null\n    fromBlueprint = raw?.application?.worker ?? {}\n  } catch {}\n  let fromWrangler: Partial<WorkerSettings> = {}\n  try {\n    const raw = JSON.parse(\n      (await readText(join(directory, 'wrangler.json'))) ?? 'null',\n    ) as {\n      main?: string\n      compatibility_date?: string\n      assets?: { directory?: string }\n    } | null\n    fromWrangler = {\n      main: raw?.main,\n      compatibilityDate: raw?.compatibility_date,\n      assets: raw?.assets?.directory,\n    }\n  } catch {}\n  const pick = (key: keyof WorkerSettings, fallback: string) => {\n    const value = fromBlueprint[key] ?? fromWrangler[key]\n    return typeof value === 'string' && value ? value : fallback\n  }\n  const render: WorkerRender =\n    fromBlueprint.render === 'ssr' || fromBlueprint.render === 'spa'\n      ? fromBlueprint.render\n      : hasStart\n        ? 'ssr'\n        : 'spa'\n  // An old wrangler.json names src/worker.ts; keep it only while it exists.\n  if (\n    fromWrangler.main &&\n    !(WORKER_PACKAGE_ENTRIES as readonly string[]).includes(\n      fromWrangler.main,\n    ) &&\n    !(await exists(join(directory, fromWrangler.main)))\n  ) {\n    fromWrangler.main = undefined\n  }\n  const defaultMain = (await exists(join(directory, 'src/server.ts')))\n    ? 'src/server.ts'\n    : render === 'ssr'\n      ? 'workerstack/start/server-entry'\n      : 'workerstack/workers/entry'\n  return {\n    render,\n    main: pick('main', defaultMain),\n    compatibilityDate: pick('compatibilityDate', today),\n    assets: pick('assets', 'dist/client'),\n  }\n}\n\nasync function packageVersion(): Promise<string> {\n  const pkg = (await Bun.file(\n    new URL('../package.json', import.meta.url),\n  ).json()) as { version: string }\n  return pkg.version\n}\n\nexport async function generateBlueprint(\n  options: GenerateBlueprintOptions,\n): Promise<GenerateBlueprintResult> {\n  const directory = await realpath(resolve(options.directory))\n  const packagePath = join(directory, 'package.json')\n  const pkg = JSON.parse(await readFile(packagePath, 'utf8')) as AppPackage\n  const allDependencies = { ...pkg.dependencies, ...pkg.devDependencies }\n  let framework: 'tanstack-start' | 'solid' | 'bun-ssr' = 'bun-ssr'\n  if (typeof allDependencies['@tanstack/react-start'] === 'string') {\n    framework = 'tanstack-start'\n  } else if (\n    typeof allDependencies['solid-js'] === 'string' ||\n    typeof allDependencies['@solidjs/web'] === 'string'\n  ) {\n    framework = 'solid'\n  }\n  requireScript(pkg, 'build', true)\n\n  const configuredEntry = pkg.workerstack?.entry\n  const entry = requireRelativePath(\n    options.entry ??\n      (typeof configuredEntry === 'string'\n        ? configuredEntry\n        : 'src/workerstack.ts'),\n    'entry',\n  )\n  const entryPath = resolveWithin(directory, entry, 'entry')\n  if (!(await Bun.file(entryPath).exists())) {\n    throw new Error(`[workerstack] entry does not exist: ${entry}`)\n  }\n  const output = requireRelativePath(\n    options.output ?? 'workerstack.blueprint.yaml',\n    'output',\n  )\n  const outputPath = resolveWithin(directory, output, 'output')\n\n  const module = (await import(\n    `${pathToFileURL(entryPath).href}?blueprint=${Date.now()}`\n  )) as { backend?: unknown }\n  const backend = module.backend\n  if (!isWorkerstackBackend(backend)) {\n    throw new Error(`[workerstack] ${entry} must export backend`)\n  }\n  if (options.hostedCheck) {\n    const file = Bun.file(outputPath)\n    if (!(await file.exists())) {\n      throw new Error(\n        `[workerstack] hosted blueprint does not exist: ${output}`,\n      )\n    }\n    const source = await file.text()\n    const manifest = parseManifest(backend.inspect({ env: process.env }))\n    assertManifestMatchesBlueprint(manifest, source)\n    return {\n      path: outputPath,\n      blueprint: parseWorkerBlueprintYaml(source),\n      source,\n      changed: false,\n    }\n  }\n  const probeSources = createEnvProbeSources(\n    backend[BACKEND_INTERNALS].envSchema,\n    process.env as Record<string, string | undefined>,\n  )\n  const firstManifest = parseManifest(backend.inspect({ env: probeSources[0] }))\n  const secondManifest = parseManifest(\n    backend.inspect({ env: probeSources[1] }),\n  )\n  const differences = diffManifests(firstManifest, secondManifest)\n  if (differences.length > 0) {\n    throw new Error(\n      '[workerstack] environment-dependent blueprint shape:\\n' +\n        differences.map(({ kind, path }) => `  - ${kind}: ${path}`).join('\\n'),\n    )\n  }\n  const manifest = firstManifest\n  const migrationsDirectory = normalizeProjectPath(\n    directory,\n    manifest.database.migrationsDirectory,\n    'migrationsDirectory',\n  )\n  const migrationJournal = join(\n    resolveWithin(directory, migrationsDirectory, 'migrationsDirectory'),\n    'meta',\n    '_journal.json',\n  )\n  const migrationMode = (await Bun.file(migrationJournal).exists())\n    ? 'migrations'\n    : 'push'\n  const existing = await readText(outputPath)\n  const blueprint = blueprintFromManifest({\n    manifest: {\n      ...manifest,\n      database: { ...manifest.database, migrationsDirectory },\n    },\n    generatorVersion: await packageVersion(),\n    entry,\n    migrationMode,\n    framework,\n    worker: await workerSettings(\n      directory,\n      existing,\n      options.today ?? new Date().toISOString().slice(0, 10),\n      typeof allDependencies['@tanstack/react-start'] === 'string',\n    ),\n  })\n  const source = serializeBlueprint(blueprint)\n  if (options.check) {\n    if (existing !== source) throw new BlueprintCheckError()\n    return { path: outputPath, blueprint, source, changed: false }\n  }\n  if (existing === source)\n    return { path: outputPath, blueprint, source, changed: false }\n  await mkdir(dirname(outputPath), { recursive: true })\n  const temporary = `${outputPath}.${process.pid}.${Date.now()}.tmp`\n  try {\n    await writeFile(temporary, source, { mode: 0o600 })\n    await rename(temporary, outputPath)\n  } finally {\n    await rm(temporary, { force: true })\n  }\n  return { path: outputPath, blueprint, source, changed: true }\n}\n"]}

package/dist/blueprint.d.ts

@@ -0,0 +1,99 @@
+import type { WorkerstackManifest } from './manifest.js';
+export type MigrationMode = 'migrations' | 'push';
+export type ApplicationFramework = 'tanstack-start' | 'solid' | 'bun-ssr' | 'custom';
+/**
+ * Blueprint form of an environment key. `sensitive` and `description` are
+ * optional because blueprints committed before 0.23.0 do not carry them.
+ */
+export type BlueprintEnvVar = {
+    key: string;
+    required: boolean;
+    scope: 'server' | 'client';
+    sensitive?: boolean;
+    description?: string;
+};
+export declare const WORKER_PACKAGE_ENTRIES: readonly ["workerstack/start/server-entry", "workerstack/workers/entry"];
+export type WorkerRender = 'ssr' | 'spa';
+export type WorkerSettings = {
+    render: WorkerRender;
+    /** A relative path inside the package, or one of WORKER_PACKAGE_ENTRIES. */
+    main: string;
+    compatibilityDate: string;
+    assets: string;
+};
+type BlueprintBackground = Pick<WorkerstackManifest['background'], 'jobs' | 'cron' | 'maintenance'>;
+type BlueprintBody = {
+    generator: {
+        name: 'workerstack';
+        version: string;
+    };
+    workerstack: {
+        entry: string;
+        manifestVersion: 4;
+    };
+    resources: {
+        database: WorkerstackManifest['database'] & {
+            migrationMode: MigrationMode;
+        };
+        storage: WorkerstackManifest['storage'];
+        realtime?: {
+            required: true;
+        };
+        messaging: WorkerstackManifest['messaging'];
+    };
+    environment: BlueprintEnvVar[];
+    /** Application-declared procedures. Absent in blueprints written before 0.23.0. */
+    api?: {
+        operations: WorkerstackManifest['api']['operations'];
+    };
+};
+/** The 0.x server contract. Parsed for hosts; never generated by 1.0. */
+export type LegacyBlueprint = BlueprintBody & {
+    version: 1;
+    application: {
+        framework: ApplicationFramework;
+        scripts: {
+            build: 'build';
+            start: 'start';
+            worker?: 'worker';
+        };
+    };
+    background: BlueprintBackground & {
+        worker: {
+            required: boolean;
+        };
+    };
+};
+/** The 1.0 Worker contract. */
+export type WorkerBlueprint = BlueprintBody & {
+    version: 2;
+    application: {
+        framework: ApplicationFramework;
+        scripts: {
+            build: 'build';
+        };
+        worker: WorkerSettings;
+    };
+    background: BlueprintBackground;
+};
+export type WorkerstackBlueprint = LegacyBlueprint | WorkerBlueprint;
+export declare function parseBlueprint(value: unknown): WorkerstackBlueprint;
+export declare function parseWorkerBlueprint(value: unknown): WorkerBlueprint;
+/**
+ * Whether a host must treat this key as a secret. A blueprint generated before
+ * 0.23.0 has no flag, and server keys are secret by default.
+ */
+export declare function isSensitiveEnvVar(entry: BlueprintEnvVar): boolean;
+export declare function blueprintFromManifest(args: {
+    manifest: WorkerstackManifest;
+    generatorVersion: string;
+    entry: string;
+    migrationMode: MigrationMode;
+    framework?: ApplicationFramework;
+    worker: WorkerSettings;
+}): WorkerBlueprint;
+export declare function parseBlueprintYaml(source: string): WorkerstackBlueprint;
+export declare function parseWorkerBlueprintYaml(source: string): WorkerBlueprint;
+export declare function serializeBlueprint(value: WorkerstackBlueprint): string;
+export { bucketBindingName, workerPlanFromBlueprint, type WorkerPlan, } from './worker-plan.js';
+//# sourceMappingURL=blueprint.d.ts.map

package/dist/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../src/blueprint.ts"],"names":[],"mappings":"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"}

package/dist/blueprint.js

@@ -0,0 +1,257 @@
+import * as v from 'valibot';
+import { parse, stringify } from 'yaml';
+import { parseCron } from './jobs/cron.js';
+import { validateStandardSchema } from './standard-schema.js';
+export const WORKER_PACKAGE_ENTRIES = [
+    'workerstack/start/server-entry',
+    'workerstack/workers/entry',
+];
+const nonEmpty = v.pipe(v.string(), v.minLength(1));
+const relativePath = v.pipe(nonEmpty, v.check((value) => !value.startsWith('/') &&
+    !value.includes('\\') &&
+    value.split('/').every((part) => part !== '' && part !== '..'), 'entry must be a relative path without traversal'));
+const cronSchedule = v.pipe(nonEmpty, v.check((value) => {
+    try {
+        parseCron(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}, 'invalid cron schedule'));
+// Hosts parse blueprints committed by applications that upgrade workerstack on
+// their own schedule, so a section written by a newer generator has to survive
+// an older parser instead of failing the whole file.
+function open(entries) {
+    return v.objectWithRest(entries, v.unknown());
+}
+const compatibilityDate = v.pipe(v.string(), v.regex(/^\d{4}-\d{2}-\d{2}$/, 'compatibilityDate must be YYYY-MM-DD'));
+const workerMain = v.pipe(nonEmpty, v.check((value) => WORKER_PACKAGE_ENTRIES.includes(value) ||
+    (!value.startsWith('workerstack/') &&
+        !value.startsWith('@') &&
+        !value.startsWith('/') &&
+        !value.includes('\\') &&
+        value.split('/').every((part) => part !== '' && part !== '..')), 'main must be a relative path inside the package or a workerstack entry'));
+const framework = v.picklist(['tanstack-start', 'solid', 'bun-ssr', 'custom']);
+const generatorEntry = open({
+    name: v.literal('workerstack'),
+    version: nonEmpty,
+});
+const sharedEntries = {
+    workerstack: open({
+        entry: relativePath,
+        manifestVersion: v.literal(4),
+    }),
+    resources: open({
+        database: open({
+            dialect: v.picklist(['sqlite']),
+            migrationsDirectory: relativePath,
+            migrationMode: v.picklist(['migrations', 'push']),
+            tables: v.array(open({
+                exportName: nonEmpty,
+                physicalName: nonEmpty,
+                system: v.boolean(),
+            })),
+        }),
+        storage: open({
+            defaultBucket: nonEmpty,
+            buckets: v.array(open({
+                name: nonEmpty,
+                visibility: v.picklist(['public', 'private']),
+            })),
+        }),
+        realtime: v.optional(open({ required: v.literal(true) })),
+        messaging: open({
+            channels: v.array(open({ name: nonEmpty, kind: nonEmpty, provider: nonEmpty })),
+        }),
+    }),
+    environment: v.array(open({
+        key: nonEmpty,
+        required: v.boolean(),
+        scope: v.picklist(['server', 'client']),
+        sensitive: v.optional(v.boolean()),
+        description: v.optional(v.pipe(nonEmpty, v.maxLength(200))),
+    })),
+    api: v.optional(open({
+        operations: v.array(open({
+            handle: nonEmpty,
+            operationId: nonEmpty,
+            effect: v.picklist(['read', 'mutation', 'unknown']),
+            method: v.optional(nonEmpty),
+            path: v.optional(nonEmpty),
+            summary: v.optional(v.pipe(nonEmpty, v.maxLength(200))),
+        })),
+    })),
+};
+const backgroundEntries = {
+    jobs: v.array(open({ name: nonEmpty })),
+    cron: v.array(open({
+        name: nonEmpty,
+        schedule: cronSchedule,
+        timezone: v.literal('UTC'),
+    })),
+    maintenance: v.array(open({
+        name: v.literal('storage-sweep'),
+        schedule: cronSchedule,
+        timezone: v.literal('UTC'),
+    })),
+};
+const legacySchema = open({
+    version: v.literal(1),
+    // Key order is the YAML order: identity and application first.
+    generator: generatorEntry,
+    application: open({
+        framework,
+        scripts: open({
+            build: v.literal('build'),
+            start: v.literal('start'),
+            worker: v.optional(v.literal('worker')),
+        }),
+    }),
+    ...sharedEntries,
+    background: open({
+        worker: open({ required: v.boolean() }),
+        ...backgroundEntries,
+    }),
+});
+const workerSchema = open({
+    version: v.literal(2),
+    // Key order is the YAML order: identity and application first.
+    generator: generatorEntry,
+    application: open({
+        framework,
+        scripts: open({ build: v.literal('build') }),
+        worker: open({
+            render: v.picklist(['ssr', 'spa']),
+            main: workerMain,
+            compatibilityDate,
+            assets: relativePath,
+        }),
+    }),
+    ...sharedEntries,
+    background: open(backgroundEntries),
+});
+const blueprintSchema = v.variant('version', [legacySchema, workerSchema]);
+function sortBy(entries, key) {
+    return [...entries].sort((left, right) => key(left).localeCompare(key(right)));
+}
+function rejectDuplicates(collection, values) {
+    const seen = new Set();
+    for (const value of values) {
+        if (seen.has(value))
+            throw new Error(`[workerstack] duplicate ${collection} "${value}"`);
+        seen.add(value);
+    }
+}
+export function parseBlueprint(value) {
+    const raw = value;
+    if (raw?.version === 1 && raw.application?.runtime === 'worker') {
+        throw new Error('[workerstack] this version 1 blueprint declares runtime: worker; regenerate the blueprint with workerstack 1.0.0-beta.3');
+    }
+    const worker = raw?.application?.worker;
+    if (raw?.version === 2 && worker && worker.render === undefined) {
+        throw new Error('[workerstack] application.worker.render is missing; regenerate the blueprint with workerstack 1.0.0-beta.4');
+    }
+    const blueprint = validateStandardSchema(blueprintSchema, value, 'blueprint');
+    rejectDuplicates('database physical table', blueprint.resources.database.tables.map((entry) => entry.physicalName));
+    rejectDuplicates('database export table', blueprint.resources.database.tables.map((entry) => entry.exportName));
+    rejectDuplicates('storage bucket', blueprint.resources.storage.buckets.map((entry) => entry.name));
+    rejectDuplicates('environment key', blueprint.environment.map((entry) => entry.key));
+    rejectDuplicates('messaging channel', blueprint.resources.messaging.channels.map((entry) => entry.name));
+    if (blueprint.api)
+        rejectDuplicates('api operation', blueprint.api.operations.map((entry) => entry.handle));
+    rejectDuplicates('background job', blueprint.background.jobs.map((entry) => entry.name));
+    rejectDuplicates('background cron', blueprint.background.cron.map((entry) => entry.name));
+    rejectDuplicates('background maintenance', blueprint.background.maintenance.map((entry) => entry.name));
+    if (!blueprint.resources.storage.buckets.some((bucket) => bucket.name === blueprint.resources.storage.defaultBucket)) {
+        throw new Error('[workerstack] storage defaultBucket must be declared in storage buckets');
+    }
+    if (blueprint.version === 1) {
+        const workerRequired = blueprint.background.jobs.length > 0;
+        if (blueprint.background.worker.required !== workerRequired) {
+            throw new Error('[workerstack] background worker.required must match declared queue jobs');
+        }
+        if (Boolean(blueprint.application.scripts.worker) !== workerRequired) {
+            throw new Error('[workerstack] application worker script must match declared queue jobs');
+        }
+    }
+    else {
+        const scripts = blueprint.application.scripts;
+        if (Object.keys(scripts).some((name) => name !== 'build')) {
+            throw new Error('[workerstack] a version 2 blueprint declares only the build script');
+        }
+    }
+    return blueprint;
+}
+export function parseWorkerBlueprint(value) {
+    const blueprint = parseBlueprint(value);
+    if (blueprint.version !== 2) {
+        throw new Error('[workerstack] workerstack.blueprint.yaml is a 0.x (version 1) blueprint; run `workerstack dev` or `workerstack blueprint` to regenerate it for 1.0');
+    }
+    return blueprint;
+}
+/**
+ * Whether a host must treat this key as a secret. A blueprint generated before
+ * 0.23.0 has no flag, and server keys are secret by default.
+ */
+export function isSensitiveEnvVar(entry) {
+    return entry.sensitive ?? entry.scope === 'server';
+}
+export function blueprintFromManifest(args) {
+    return parseWorkerBlueprint({
+        version: 2,
+        generator: { name: 'workerstack', version: args.generatorVersion },
+        application: {
+            framework: args.framework ?? 'tanstack-start',
+            scripts: { build: 'build' },
+            worker: args.worker,
+        },
+        workerstack: { entry: args.entry, manifestVersion: 4 },
+        resources: {
+            database: {
+                ...args.manifest.database,
+                migrationMode: args.migrationMode,
+                tables: sortBy(args.manifest.database.tables, (entry) => entry.physicalName),
+            },
+            storage: {
+                ...args.manifest.storage,
+                buckets: sortBy(args.manifest.storage.buckets, (entry) => entry.name),
+            },
+            ...(args.manifest.realtime.required
+                ? { realtime: { required: true } }
+                : {}),
+            messaging: {
+                channels: sortBy(args.manifest.messaging.channels, (entry) => entry.name),
+            },
+        },
+        environment: sortBy(args.manifest.environment, (entry) => entry.key),
+        api: { operations: args.manifest.api.operations },
+        background: {
+            jobs: sortBy(args.manifest.background.jobs, (entry) => entry.name),
+            cron: sortBy(args.manifest.background.cron, (entry) => entry.name),
+            maintenance: sortBy(args.manifest.background.maintenance, (entry) => entry.name),
+        },
+    });
+}
+export function parseBlueprintYaml(source) {
+    return parseBlueprint(parse(source));
+}
+export function parseWorkerBlueprintYaml(source) {
+    return parseWorkerBlueprint(parse(source));
+}
+export function serializeBlueprint(value) {
+    const blueprint = parseBlueprint(value);
+    const options = {
+        aliasDuplicateObjects: false,
+        defaultKeyType: 'PLAIN',
+        defaultStringType: 'PLAIN',
+        lineWidth: 0,
+    };
+    const source = stringify(parseBlueprintYaml(stringify(blueprint, options)), options);
+    return source.replace(/^(\s*schedule: )(.+)$/gm, (_match, prefix, value) => {
+        const schedule = value.startsWith('"') ? JSON.parse(value) : value;
+        return `${prefix}${JSON.stringify(schedule)}`;
+    });
+}
+export { bucketBindingName, workerPlanFromBlueprint, } from './worker-plan.js';
+//# sourceMappingURL=blueprint.js.map