@celsoft/platform 0.0.0-stage → 0.2.0

package/dist/fakes.d.ts

@@ -0,0 +1,53 @@
+import type { Branch, Cloudflare, Hyperdrive, Migrator, Neon, Wrangler, Zone } from "./ports.js";
+export declare class FakeNeon implements Neon {
+    branches: Branch[];
+    private next;
+    defaultBranch(): Promise<Branch>;
+    findBranch(_project: string, name: string): Promise<Branch | undefined>;
+    listBranches(_project: string, namePrefix: string): Promise<Branch[]>;
+    createBranch(_project: string, name: string): Promise<{
+        id: string;
+        name: string;
+    }>;
+    deleteBranch(_project: string, branchId: string): Promise<void>;
+    connectionUri(_project: string, branchId: string): Promise<string>;
+}
+export declare class FakeCloudflare implements Cloudflare {
+    zones: Zone[];
+    hyperdrives: Hyperdrive[];
+    workers: Set<string>;
+    private next;
+    accountId(): Promise<string>;
+    findZone(hostname: string): Promise<Zone | undefined>;
+    findHyperdrive(name: string): Promise<Hyperdrive | undefined>;
+    createHyperdrive(name: string, uri: string): Promise<{
+        id: string;
+        name: string;
+        origin: string;
+        cached: boolean;
+    }>;
+    updateHyperdrive(id: string, uri: string): Promise<Hyperdrive>;
+    deleteHyperdrive(id: string): Promise<void>;
+    findWorker(name: string): Promise<boolean>;
+    deleteWorker(name: string): Promise<void>;
+}
+export declare class FakeWrangler implements Wrangler {
+    private readonly cloudflare;
+    deploys: {
+        config: Record<string, unknown>;
+        secrets: Record<string, string>;
+    }[];
+    constructor(cloudflare: FakeCloudflare);
+    deploy(config: object, secrets: Record<string, string>): Promise<void>;
+}
+export declare class FakeMigrator implements Migrator {
+    runs: string[];
+    failWith: Error | undefined;
+    migrate(_command: string, databaseUrl: string): Promise<void>;
+}
+export declare function fakePorts(): {
+    neon: FakeNeon;
+    cloudflare: FakeCloudflare;
+    wrangler: FakeWrangler;
+    migrator: FakeMigrator;
+};

package/dist/fakes.js

@@ -0,0 +1,89 @@
+import { originOf } from "./target.js";
+export class FakeNeon {
+    branches = [{ id: "br-prod", name: "production" }];
+    next = 1;
+    async defaultBranch() {
+        return this.branches[0];
+    }
+    async findBranch(_project, name) {
+        return this.branches.find((b) => b.name === name);
+    }
+    async listBranches(_project, namePrefix) {
+        return this.branches.filter((b) => b.name.startsWith(namePrefix));
+    }
+    async createBranch(_project, name) {
+        const branch = { id: `br-${this.next++}`, name };
+        this.branches.push(branch);
+        return branch;
+    }
+    async deleteBranch(_project, branchId) {
+        this.branches = this.branches.filter((b) => b.id !== branchId);
+    }
+    async connectionUri(_project, branchId) {
+        return `postgresql://owner:secret@${branchId}.neon.test/app`;
+    }
+}
+export class FakeCloudflare {
+    zones = [{ id: "zone-1", name: "example.com" }];
+    hyperdrives = [];
+    workers = new Set();
+    next = 1;
+    async accountId() {
+        return "acct-1";
+    }
+    async findZone(hostname) {
+        return this.zones.find((z) => hostname === z.name || hostname.endsWith(`.${z.name}`));
+    }
+    async findHyperdrive(name) {
+        return this.hyperdrives.find((h) => h.name === name);
+    }
+    async createHyperdrive(name, uri) {
+        const hyperdrive = { id: `hd-${this.next++}`, name, origin: originOf(uri), cached: false };
+        this.hyperdrives.push(hyperdrive);
+        return hyperdrive;
+    }
+    async updateHyperdrive(id, uri) {
+        const hyperdrive = this.hyperdrives.find((h) => h.id === id);
+        hyperdrive.origin = originOf(uri);
+        hyperdrive.cached = false;
+        return hyperdrive;
+    }
+    async deleteHyperdrive(id) {
+        this.hyperdrives = this.hyperdrives.filter((h) => h.id !== id);
+    }
+    async findWorker(name) {
+        return this.workers.has(name);
+    }
+    async deleteWorker(name) {
+        this.workers.delete(name);
+    }
+}
+export class FakeWrangler {
+    cloudflare;
+    deploys = [];
+    constructor(cloudflare) {
+        this.cloudflare = cloudflare;
+    }
+    async deploy(config, secrets) {
+        const c = config;
+        this.deploys.push({ config: c, secrets });
+        this.cloudflare.workers.add(c.name);
+    }
+}
+export class FakeMigrator {
+    runs = [];
+    failWith;
+    async migrate(_command, databaseUrl) {
+        if (this.failWith)
+            throw this.failWith;
+        this.runs.push(databaseUrl);
+    }
+}
+export function fakePorts() {
+    const neon = new FakeNeon();
+    const cloudflare = new FakeCloudflare();
+    const wrangler = new FakeWrangler(cloudflare);
+    const migrator = new FakeMigrator();
+    return { neon, cloudflare, wrangler, migrator };
+}
+//# sourceMappingURL=fakes.js.map

package/dist/fakes.js.map

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

package/dist/init.d.ts

@@ -0,0 +1,19 @@
+import type { Config } from "./config.js";
+import type { Cloudflare, GitHub, Neon } from "./ports.js";
+import type { Run } from "./run.js";
+export declare const TOKEN_HELP: Record<string, string>;
+export interface InitInput {
+    repoRoot: string;
+    appDir: string;
+    config: Config;
+    variables: Record<string, string>;
+    run: Run;
+    connect: (tokens: Record<string, string>) => {
+        cloudflare: Cloudflare;
+        neon: Neon;
+        github: GitHub;
+    };
+}
+export declare function tokenNames(config: Config): string[];
+export declare function init({ repoRoot, appDir, config, variables, run, connect }: InitInput): Promise<void>;
+export declare function checkWorkflow(repoRoot: string, appDir: string, config: Config, variables: string[]): Promise<void>;

package/dist/init.js

@@ -0,0 +1,96 @@
+import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
+import { PreflightError } from "./lifecycle.js";
+import { parseDotenv, SECRETS_FILE, VARS_FILE } from "./secrets.js";
+import { renderWorkflow, WORKFLOW_PATH } from "./workflow.js";
+export const TOKEN_HELP = {
+    CLOUDFLARE_API_TOKEN: "Cloudflare API token; see SETUP.md or the platform README for its permissions",
+    NEON_API_KEY: "Neon API key scoped to the app's Neon project",
+};
+export function tokenNames(config) {
+    return config.database ? ["CLOUDFLARE_API_TOKEN", "NEON_API_KEY"] : ["CLOUDFLARE_API_TOKEN"];
+}
+export async function init({ repoRoot, appDir, config, variables, run, connect }) {
+    const names = tokenNames(config);
+    const tokens = await prepareSecretsFile(repoRoot, names, run);
+    if (Object.keys(variables).length > 0)
+        await ensureIgnored(repoRoot, VARS_FILE, run);
+    const { cloudflare, neon, github } = connect(tokens);
+    await cloudflare.accountId();
+    const zone = await cloudflare.findZone(config.hostname);
+    if (!zone)
+        throw new PreflightError(`the Cloudflare token cannot see a zone for ${config.hostname}; check its Zone Resources`);
+    run.note(`✓ Cloudflare account and zone ${zone.name}`);
+    if (config.database) {
+        await neon.defaultBranch(config.database.neonProject);
+        run.note(`✓ Neon project ${config.database.neonProject}`);
+    }
+    for (const name of names) {
+        await run.mutate(`store ${name} as a GitHub secret`, () => github.setSecret(name, tokens[name]), undefined);
+    }
+    for (const [name, value] of Object.entries(variables)) {
+        await run.mutate(`store ${name} as a GitHub variable`, () => github.setVariable(name, value), undefined);
+    }
+    for (const environment of ["production", "preview"]) {
+        await run.mutate(`ensure GitHub Environment ${environment}`, () => github.ensureEnvironment(environment), undefined);
+    }
+    const workflow = await expectedWorkflow(repoRoot, appDir, config, Object.keys(variables));
+    const path = join(repoRoot, WORKFLOW_PATH);
+    if ((await readOptional(path)) !== workflow) {
+        await run.mutate(`write ${WORKFLOW_PATH}`, async () => {
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, workflow);
+        }, undefined);
+    }
+    else {
+        run.note(`✓ ${WORKFLOW_PATH}`);
+    }
+}
+export async function checkWorkflow(repoRoot, appDir, config, variables) {
+    const expected = await expectedWorkflow(repoRoot, appDir, config, variables);
+    if ((await readOptional(join(repoRoot, WORKFLOW_PATH))) !== expected) {
+        throw new PreflightError(`${WORKFLOW_PATH} differs from what this platform version writes; run \`platform init\` and commit the result`);
+    }
+}
+async function ensureIgnored(repoRoot, file, run) {
+    const gitignore = join(repoRoot, ".gitignore");
+    const ignored = (await readOptional(gitignore))?.split(/\r?\n/).some((line) => line.trim() === file || line.trim() === `/${file}`);
+    if (!ignored)
+        await run.mutate(`add ${file} to .gitignore`, () => appendFile(gitignore, `\n${file}\n`), undefined);
+}
+async function prepareSecretsFile(repoRoot, names, run) {
+    await ensureIgnored(repoRoot, SECRETS_FILE, run);
+    const path = join(repoRoot, SECRETS_FILE);
+    const text = (await readOptional(path)) ?? "";
+    const declared = new Set([...text.matchAll(/^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/gm)].map((m) => m[1]));
+    const additions = names.filter((name) => !declared.has(name)).map((name) => `\n# ${TOKEN_HELP[name]}\n${name}=\n`);
+    if (additions.length > 0) {
+        await run.mutate(`add blank entries to ${SECRETS_FILE}`, () => writeFile(path, text + additions.join(""), { mode: 0o600 }), undefined);
+    }
+    const values = parseDotenv(text);
+    const empty = names.filter((name) => !values[name]);
+    if (empty.length > 0) {
+        throw new PreflightError(`fill ${empty.join(" and ")} in ${path}, then rerun \`platform init\``);
+    }
+    return values;
+}
+async function expectedWorkflow(repoRoot, appDir, config, variables) {
+    return renderWorkflow({
+        appDir: relative(repoRoot, appDir) || ".",
+        packageManager: await packageManager(repoRoot),
+        secrets: [...tokenNames(config), ...config.secrets],
+        variables,
+    });
+}
+async function packageManager(repoRoot) {
+    return (await readOptional(join(repoRoot, "pnpm-lock.yaml"))) !== undefined ? "pnpm" : "npm";
+}
+async function readOptional(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/lifecycle.d.ts

@@ -0,0 +1,19 @@
+import type { Config } from "./config.js";
+import type { Ports } from "./ports.js";
+import type { Run } from "./run.js";
+import { type Target } from "./target.js";
+export interface Context {
+    config: Config;
+    ports: Ports;
+    run: Run;
+    secrets: Record<string, string>;
+    now?: () => Date;
+}
+export declare class PreflightError extends Error {
+}
+export declare function deploy(ctx: Context, target: Target): Promise<{
+    hostname: string;
+}>;
+export declare function cleanup(ctx: Context, pr: number): Promise<void>;
+export declare const BACKUP_PREFIX = "backup-";
+export declare const BACKUPS_KEPT = 3;

package/dist/lifecycle.js

@@ -0,0 +1,89 @@
+import { names, originOf, previewHostname } from "./target.js";
+import { wranglerConfig } from "./wrangler-config.js";
+export class PreflightError extends Error {
+}
+export async function deploy(ctx, target) {
+    const { config, ports, run } = ctx;
+    const secrets = requireSecrets(config, ctx.secrets);
+    const n = names(config, target);
+    const accountId = await ports.cloudflare.accountId();
+    const zone = await ports.cloudflare.findZone(config.hostname);
+    if (!zone)
+        throw new PreflightError(`no Cloudflare zone for ${config.hostname}; add the apex domain to this account, or check the token's zone access`);
+    const hostname = target.kind === "prod" ? config.hostname : previewHostname(n.worker, zone.name);
+    let hyperdriveId;
+    if (config.database) {
+        const project = config.database.neonProject;
+        const prod = await ports.neon.defaultBranch(project);
+        const branch = target.kind === "prod"
+            ? prod
+            : await run.ensure(`Neon branch ${n.neonBranch}`, () => ports.neon.findBranch(project, n.neonBranch), () => ports.neon.createBranch(project, n.neonBranch, prod.id, true), { id: "(new)", name: n.neonBranch });
+        if (target.kind === "prod")
+            await backup(ctx, project, prod);
+        const uri = run.dryRun && branch.id === "(new)" ? undefined : await ports.neon.connectionUri(project, branch.id);
+        if (uri) {
+            await run.mutate(`run migrations on ${branch.name}`, () => ports.migrator.migrate(config.database.migrate, uri), undefined);
+        }
+        else {
+            run.note(`would run migrations on ${branch.name}`);
+        }
+        hyperdriveId = await ensureHyperdrive(ctx, n.hyperdrive, uri);
+    }
+    const wrangler = wranglerConfig({ config, worker: n.worker, hostname, accountId, hyperdriveId });
+    await run.mutate(`deploy Worker ${n.worker} at https://${hostname}`, () => ports.wrangler.deploy(wrangler, secrets), undefined);
+    return { hostname };
+}
+export async function cleanup(ctx, pr) {
+    const { config, ports, run } = ctx;
+    const n = names(config, { kind: "preview", pr });
+    if (await ports.cloudflare.findWorker(n.worker)) {
+        await run.mutate(`delete Worker ${n.worker}`, () => ports.cloudflare.deleteWorker(n.worker), undefined);
+    }
+    const hyperdrive = await ports.cloudflare.findHyperdrive(n.hyperdrive);
+    if (hyperdrive) {
+        await run.mutate(`delete Hyperdrive config ${n.hyperdrive}`, () => ports.cloudflare.deleteHyperdrive(hyperdrive.id), undefined);
+    }
+    if (config.database) {
+        const project = config.database.neonProject;
+        const branch = await ports.neon.findBranch(project, n.neonBranch);
+        if (branch) {
+            await run.mutate(`delete Neon branch ${branch.name}`, () => ports.neon.deleteBranch(project, branch.id), undefined);
+        }
+    }
+}
+export const BACKUP_PREFIX = "backup-";
+export const BACKUPS_KEPT = 3;
+// Neon includes 10 branches per project, so only the newest few backups are kept.
+async function backup({ ports, run, now }, project, prod) {
+    const name = `${BACKUP_PREFIX}${(now?.() ?? new Date()).toISOString().replace(/[-:]/g, "").slice(0, 15)}`;
+    await run.mutate(`create Neon backup branch ${name}`, () => ports.neon.createBranch(project, name, prod.id, false), undefined);
+    const backups = (await ports.neon.listBranches(project, BACKUP_PREFIX)).sort((a, b) => b.name.localeCompare(a.name));
+    for (const old of backups.slice(BACKUPS_KEPT)) {
+        await run.mutate(`delete old Neon backup branch ${old.name}`, () => ports.neon.deleteBranch(project, old.id), undefined);
+    }
+}
+async function ensureHyperdrive({ ports, run }, name, uri) {
+    const existing = await ports.cloudflare.findHyperdrive(name);
+    if (!uri) {
+        run.note(existing ? `would check Hyperdrive config ${name}` : `would create Hyperdrive config ${name}`);
+        return existing?.id ?? "(new)";
+    }
+    if (!existing) {
+        return (await run.mutate(`create Hyperdrive config ${name}`, () => ports.cloudflare.createHyperdrive(name, uri), { id: "(new)", name, origin: "", cached: false })).id;
+    }
+    if (existing.origin !== originOf(uri) || existing.cached) {
+        await run.mutate(`update Hyperdrive config ${name} (new origin or caching on)`, () => ports.cloudflare.updateHyperdrive(existing.id, uri), existing);
+    }
+    else {
+        run.note(`✓ Hyperdrive config ${name}`);
+    }
+    return existing.id;
+}
+function requireSecrets(config, available) {
+    const missing = config.secrets.filter((name) => !available[name]);
+    if (missing.length > 0) {
+        throw new PreflightError(`missing secrets: ${missing.join(", ")}; add them to the GitHub Environment, or to .env.secrets for local runs`);
+    }
+    return Object.fromEntries(config.secrets.map((name) => [name, available[name]]));
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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

package/dist/ports.d.ts

@@ -0,0 +1,49 @@
+export interface Branch {
+    id: string;
+    name: string;
+}
+export interface Neon {
+    defaultBranch(project: string): Promise<Branch>;
+    findBranch(project: string, name: string): Promise<Branch | undefined>;
+    listBranches(project: string, namePrefix: string): Promise<Branch[]>;
+    createBranch(project: string, name: string, parentId: string, compute: boolean): Promise<Branch>;
+    deleteBranch(project: string, branchId: string): Promise<void>;
+    connectionUri(project: string, branchId: string): Promise<string>;
+}
+export interface Zone {
+    id: string;
+    name: string;
+}
+export interface Hyperdrive {
+    id: string;
+    name: string;
+    origin: string;
+    cached: boolean;
+}
+export interface Cloudflare {
+    accountId(): Promise<string>;
+    findZone(hostname: string): Promise<Zone | undefined>;
+    findHyperdrive(name: string): Promise<Hyperdrive | undefined>;
+    createHyperdrive(name: string, connectionUri: string): Promise<Hyperdrive>;
+    updateHyperdrive(id: string, connectionUri: string): Promise<Hyperdrive>;
+    deleteHyperdrive(id: string): Promise<void>;
+    findWorker(name: string): Promise<boolean>;
+    deleteWorker(name: string): Promise<void>;
+}
+export interface Wrangler {
+    deploy(wranglerConfig: object, secrets: Record<string, string>): Promise<void>;
+}
+export interface Migrator {
+    migrate(command: string, databaseUrl: string): Promise<void>;
+}
+export interface GitHub {
+    setSecret(name: string, value: string): Promise<void>;
+    setVariable(name: string, value: string): Promise<void>;
+    ensureEnvironment(name: string): Promise<void>;
+}
+export interface Ports {
+    neon: Neon;
+    cloudflare: Cloudflare;
+    wrangler: Wrangler;
+    migrator: Migrator;
+}

package/dist/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/ports.js.map

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

package/dist/run.d.ts

@@ -0,0 +1,9 @@
+export type Log = (line: string) => void;
+export declare class Run {
+    readonly dryRun: boolean;
+    private readonly log;
+    constructor(dryRun: boolean, log: Log);
+    ensure<T>(label: string, find: () => Promise<T | undefined>, create: () => Promise<T>, placeholder: T): Promise<T>;
+    mutate<T>(action: string, apply: () => Promise<T>, placeholder: T): Promise<T>;
+    note(line: string): void;
+}

package/dist/run.js

@@ -0,0 +1,29 @@
+export class Run {
+    dryRun;
+    log;
+    constructor(dryRun, log) {
+        this.dryRun = dryRun;
+        this.log = log;
+    }
+    async ensure(label, find, create, placeholder) {
+        const found = await find();
+        if (found !== undefined) {
+            this.log(`✓ ${label}`);
+            return found;
+        }
+        return this.mutate(`create ${label}`, create, placeholder);
+    }
+    async mutate(action, apply, placeholder) {
+        if (this.dryRun) {
+            this.log(`~ would ${action}`);
+            return placeholder;
+        }
+        const result = await apply();
+        this.log(`+ ${action}`);
+        return result;
+    }
+    note(line) {
+        this.log(`  ${line}`);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG;IAEH,MAAM;IACE,GAAG;IAFtB,YACW,MAAe,EACP,GAAQ;sBADhB,MAAM;mBACE,GAAG;IACnB,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAI,KAAa,EAAE,IAAkC,EAAE,MAAwB,EAAE,WAAc;QACzG,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,MAAc,EAAE,KAAuB,EAAE,WAAc;QACrE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;YAC9B,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,22 @@
+import postgres from "postgres";
+export type Sql = postgres.Sql;
+export interface PlatformBindings {
+    DB?: {
+        connectionString: string;
+    };
+}
+export interface ExecutionContext {
+    waitUntil(promise: Promise<unknown>): void;
+}
+export interface AppContext<Env> {
+    env: Env;
+    readonly sql: Sql;
+    waitUntil(promise: Promise<unknown>): void;
+}
+export type Handler<Env> = (request: Request, app: AppContext<Env>) => Response | Promise<Response>;
+export interface AppOptions {
+    connect?: (connectionString: string) => Sql;
+}
+export declare function defineApp<Secrets extends object = object>(handler: Handler<Secrets & PlatformBindings>, options?: AppOptions): {
+    fetch(request: Request, env: Secrets & PlatformBindings, ctx: ExecutionContext): Promise<Response>;
+};

package/dist/runtime/index.js

@@ -0,0 +1,29 @@
+import postgres from "postgres";
+const defaultConnect = (connectionString) => postgres(connectionString, { max: 5, fetch_types: false });
+// `Secrets` names the app's secrets, such as `defineApp<{ SESSION_SECRET: string }>`; the
+// platform's own bindings are added to it.
+export function defineApp(handler, options = {}) {
+    const connect = options.connect ?? defaultConnect;
+    return {
+        async fetch(request, env, ctx) {
+            let sql;
+            const app = {
+                env,
+                get sql() {
+                    if (!env.DB)
+                        throw new Error("this app has no database; add `database` to platform.jsonc");
+                    return (sql ??= connect(env.DB.connectionString));
+                },
+                waitUntil: (promise) => ctx.waitUntil(promise),
+            };
+            try {
+                return await handler(request, app);
+            }
+            finally {
+                if (sql)
+                    ctx.waitUntil(sql.end({ timeout: 5 }));
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAwBhC,MAAM,cAAc,GAAG,CAAC,gBAAwB,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;AAEhH,0FAA0F;AAC1F,2CAA2C;AAC3C,MAAM,UAAU,SAAS,CAAkC,OAA4C,EAAE,OAAO,GAAe,EAAE;IAC/H,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAElD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,OAAgB,EAAE,GAA+B,EAAE,GAAqB;YAClF,IAAI,GAAoB,CAAC;YACzB,MAAM,GAAG,GAA2C;gBAClD,GAAG;gBACH,IAAI,GAAG;oBACL,IAAI,CAAC,GAAG,CAAC,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;oBAC3F,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBACpD,CAAC;gBACD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC;aAC/C,CAAC;YAEF,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACrC,CAAC;oBAAS,CAAC;gBACT,IAAI,GAAG;oBAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/secrets.d.ts

@@ -0,0 +1,5 @@
+export declare const SECRETS_FILE = ".env.secrets";
+export declare const VARS_FILE = ".env";
+export declare function parseDotenv(text: string): Record<string, string>;
+export declare function loadSecrets(startDir: string, names: string[], env?: NodeJS.ProcessEnv): Promise<Record<string, string>>;
+export declare function loadVars(startDir: string, names: string[], env?: NodeJS.ProcessEnv): Promise<Record<string, string>>;

package/dist/secrets.js

@@ -0,0 +1,42 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export const SECRETS_FILE = ".env.secrets";
+export const VARS_FILE = ".env";
+export function parseDotenv(text) {
+    const values = {};
+    for (const line of text.split(/\r?\n/)) {
+        const match = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/.exec(line);
+        if (!match)
+            continue;
+        const [, name, raw] = match;
+        const value = /^(['"])(.*)\1$/.exec(raw)?.[2] ?? raw;
+        if (value)
+            values[name] = value;
+    }
+    return values;
+}
+// Locally secrets come from the nearest .env.secrets; in CI the workflow passes each named
+// secret as an environment variable. The environment wins.
+export async function loadSecrets(startDir, names, env = process.env) {
+    return { ...(await findEnvFile(startDir, SECRETS_FILE)), ...pick(env, names) };
+}
+// Non-secret values platform.jsonc references as ${NAME}: the nearest .env locally,
+// GitHub Actions variables passed by name in CI.
+export async function loadVars(startDir, names, env = process.env) {
+    return { ...(await findEnvFile(startDir, VARS_FILE)), ...pick(env, names) };
+}
+function pick(env, names) {
+    return Object.fromEntries(names.filter((name) => env[name]).map((name) => [name, env[name]]));
+}
+async function findEnvFile(dir, name) {
+    for (let current = dir;; current = dirname(current)) {
+        try {
+            return parseDotenv(await readFile(join(current, name), "utf8"));
+        }
+        catch {
+            if (dirname(current) === current)
+                return {};
+        }
+    }
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;AAEhC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,4DAA4D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtF,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAI,CAAC;QACvD,IAAI,KAAK;YAAE,MAAM,CAAC,IAAK,CAAC,GAAG,KAAK,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2FAA2F;AAC3F,2DAA2D;AAC3D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,KAAe,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IACvG,OAAO,EAAE,GAAG,CAAC,MAAM,WAAW,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;AACjF,CAAC;AAED,oFAAoF;AACpF,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAgB,EAAE,KAAe,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG;IACpG,OAAO,EAAE,GAAG,CAAC,MAAM,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,IAAI,CAAC,GAAsB,EAAE,KAAe;IACnD,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,IAAY;IAClD,KAAK,IAAI,OAAO,GAAG,GAAG,GAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,OAAO,WAAW,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO;gBAAE,OAAO,EAAE,CAAC;QAC9C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/target.d.ts

@@ -0,0 +1,15 @@
+import type { Config } from "./config.js";
+export type Target = {
+    kind: "prod";
+} | {
+    kind: "preview";
+    pr: number;
+};
+export interface Names {
+    worker: string;
+    hyperdrive: string;
+    neonBranch: string | undefined;
+}
+export declare function names(config: Config, target: Target): Names;
+export declare function previewHostname(worker: string, zoneName: string): string;
+export declare function originOf(connectionUri: string): string;