sandstream-kit 1.0.0

package/dist/adapters/inngest-background.js

@@ -0,0 +1,19 @@
+import { apiKeyAdapter } from "./api-key-adapter.js";
+/**
+ * Inngest — event-driven background jobs and scheduled functions.
+ * API-based; requires both the event key and signing key.
+ */
+export const inngestBackgroundAdapter = apiKeyAdapter({
+    name: "inngest/background",
+    description: "Inngest event-driven background jobs and scheduled functions",
+    required: ["INNGEST_EVENT_KEY", "INNGEST_SIGNING_KEY"],
+    steps: [
+        "Set the following before running kit add inngest/background:",
+        "  1. Go to https://app.inngest.com and create an app",
+        "  2. Navigate to Settings → API keys",
+        "  3. Copy the Event Key → INNGEST_EVENT_KEY",
+        "  4. Copy the Signing Key → INNGEST_SIGNING_KEY",
+        "  5. Re-run: kit add inngest/background",
+    ],
+});
+//# sourceMappingURL=inngest-background.js.map

package/dist/adapters/inngest-background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inngest-background.js","sourceRoot":"","sources":["../../src/adapters/inngest-background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC;IACpD,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,8DAA8D;IAC3E,QAAQ,EAAE,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;IACtD,KAAK,EAAE;QACL,8DAA8D;QAC9D,sDAAsD;QACtD,sCAAsC;QACtC,6CAA6C;QAC7C,iDAAiD;QACjD,yCAAyC;KAC1C;CACF,CAAC,CAAC"}

package/dist/adapters/liveblocks-realtime.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceAdapter } from "./types.js";
+/**
+ * Liveblocks Realtime Adapter
+ *
+ * Liveblocks provides presence, collaborative cursors, and realtime data for web apps.
+ * Keys come from the Liveblocks dashboard — no programmatic key creation.
+ *
+ * Dashboard: https://liveblocks.io/dashboard
+ * API reference: https://liveblocks.io/docs/api-reference/rest-api-endpoints
+ */
+export declare const liveblocksRealtimeAdapter: ServiceAdapter;

package/dist/adapters/liveblocks-realtime.js

@@ -0,0 +1,62 @@
+/**
+ * Liveblocks Realtime Adapter
+ *
+ * Liveblocks provides presence, collaborative cursors, and realtime data for web apps.
+ * Keys come from the Liveblocks dashboard — no programmatic key creation.
+ *
+ * Dashboard: https://liveblocks.io/dashboard
+ * API reference: https://liveblocks.io/docs/api-reference/rest-api-endpoints
+ */
+export const liveblocksRealtimeAdapter = {
+    name: "liveblocks/realtime",
+    description: "Liveblocks collaborative realtime (presence, cursors, multiplayer)",
+    getRequiredTools() {
+        return []; // API-based, no CLI needed
+    },
+    async check(context) {
+        const secret = context.existingEnv.LIVEBLOCKS_SECRET_KEY;
+        return !!(secret && secret.startsWith("sk_"));
+    },
+    async provision(context) {
+        const secretKey = context.existingEnv.LIVEBLOCKS_SECRET_KEY;
+        const publicKey = context.existingEnv.NEXT_PUBLIC_LIVEBLOCKS_PUBLIC_KEY;
+        // Already configured with both keys
+        if (secretKey?.startsWith("sk_") && publicKey?.startsWith("pk_")) {
+            return {
+                success: true,
+                message: "Liveblocks already configured — keys present in environment",
+                secrets: {
+                    LIVEBLOCKS_SECRET_KEY: secretKey,
+                    NEXT_PUBLIC_LIVEBLOCKS_PUBLIC_KEY: publicKey,
+                },
+                config: { service: "liveblocks/realtime", existing: true },
+            };
+        }
+        // Secret key present, public key absent — derive from secret key prefix convention
+        if (secretKey?.startsWith("sk_")) {
+            const derivedPublicKey = secretKey.replace(/^sk_/, "pk_");
+            return {
+                success: true,
+                message: "Liveblocks secret key found — set NEXT_PUBLIC_LIVEBLOCKS_PUBLIC_KEY manually if needed",
+                secrets: {
+                    LIVEBLOCKS_SECRET_KEY: secretKey,
+                    NEXT_PUBLIC_LIVEBLOCKS_PUBLIC_KEY: publicKey ?? derivedPublicKey,
+                },
+                config: { service: "liveblocks/realtime", existing: true },
+            };
+        }
+        // No keys — return manual setup instructions
+        return {
+            success: false,
+            error: "Missing LIVEBLOCKS_SECRET_KEY",
+            message: [
+                "Set the following before running kit add liveblocks/realtime:",
+                "  1. Go to https://liveblocks.io/dashboard and create a project",
+                "  2. Copy the secret key → LIVEBLOCKS_SECRET_KEY",
+                "  3. Copy the public key → NEXT_PUBLIC_LIVEBLOCKS_PUBLIC_KEY",
+                "  4. Export and re-run: kit add liveblocks/realtime",
+            ].join("\n"),
+        };
+    },
+};
+//# sourceMappingURL=liveblocks-realtime.js.map

package/dist/adapters/liveblocks-realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveblocks-realtime.js","sourceRoot":"","sources":["../../src/adapters/liveblocks-realtime.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAmB;IACvD,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,oEAAoE;IAEjF,gBAAgB;QACd,OAAO,EAAE,CAAC,CAAC,2BAA2B;IACxC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAuB;QACjC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC;QACzD,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAuB;QACrC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC;QAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,iCAAiC,CAAC;QAExE,oCAAoC;QACpC,IAAI,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,6DAA6D;gBACtE,OAAO,EAAE;oBACP,qBAAqB,EAAE,SAAS;oBAChC,iCAAiC,EAAE,SAAS;iBAC7C;gBACD,MAAM,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC3D,CAAC;QACJ,CAAC;QAED,mFAAmF;QACnF,IAAI,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,gBAAgB,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1D,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,wFAAwF;gBACjG,OAAO,EAAE;oBACP,qBAAqB,EAAE,SAAS;oBAChC,iCAAiC,EAAE,SAAS,IAAI,gBAAgB;iBACjE;gBACD,MAAM,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC3D,CAAC;QACJ,CAAC;QAED,6CAA6C;QAC7C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,+BAA+B;YACtC,OAAO,EAAE;gBACP,+DAA+D;gBAC/D,iEAAiE;gBACjE,kDAAkD;gBAClD,8DAA8D;gBAC9D,qDAAqD;aACtD,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/adapters/loops-email.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Loops — modern email marketing for SaaS (onboarding, newsletters, transactional).
+ * No programmatic account creation; provisioning reuses an existing LOOPS_API_KEY.
+ * API reference: https://loops.so/docs/api-reference
+ */
+export declare const loopsEmailAdapter: import("sandstream-kit-adapter-sdk").ServiceAdapter;

package/dist/adapters/loops-email.js

@@ -0,0 +1,18 @@
+import { apiKeyAdapter } from "./api-key-adapter.js";
+/**
+ * Loops — modern email marketing for SaaS (onboarding, newsletters, transactional).
+ * No programmatic account creation; provisioning reuses an existing LOOPS_API_KEY.
+ * API reference: https://loops.so/docs/api-reference
+ */
+export const loopsEmailAdapter = apiKeyAdapter({
+    name: "loops/email",
+    description: "Loops marketing and transactional email for SaaS",
+    required: ["LOOPS_API_KEY"],
+    steps: [
+        "Set LOOPS_API_KEY before running kit add loops/email:",
+        "  1. Go to https://app.loops.so/settings?page=api and create an API key",
+        "  2. Export it: export LOOPS_API_KEY=<your-key>",
+        "  3. Re-run: kit add loops/email",
+    ],
+});
+//# sourceMappingURL=loops-email.js.map

package/dist/adapters/loops-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loops-email.js","sourceRoot":"","sources":["../../src/adapters/loops-email.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,kDAAkD;IAC/D,QAAQ,EAAE,CAAC,eAAe,CAAC;IAC3B,KAAK,EAAE;QACL,uDAAuD;QACvD,yEAAyE;QACzE,iDAAiD;QACjD,kCAAkC;KACnC;CACF,CAAC,CAAC"}

package/dist/adapters/neon-db.d.ts

@@ -0,0 +1,10 @@
+import type { ServiceAdapter } from "./types.js";
+/**
+ * Neon Serverless Postgres Adapter
+ *
+ * Provisions a Neon serverless Postgres project via the Neon REST API.
+ * Requires NEON_API_KEY in the environment.
+ *
+ * API reference: https://api.neon.tech/v2
+ */
+export declare const neonDbAdapter: ServiceAdapter;

package/dist/adapters/neon-db.js

@@ -0,0 +1,94 @@
+/**
+ * Neon Serverless Postgres Adapter
+ *
+ * Provisions a Neon serverless Postgres project via the Neon REST API.
+ * Requires NEON_API_KEY in the environment.
+ *
+ * API reference: https://api.neon.tech/v2
+ */
+export const neonDbAdapter = {
+    name: "neon/db",
+    description: "Neon serverless Postgres database",
+    getRequiredTools() {
+        return []; // API-based, no CLI needed
+    },
+    async check(context) {
+        const url = context.existingEnv.DATABASE_URL;
+        return !!(url && (url.startsWith("postgres://") || url.startsWith("postgresql://")));
+    },
+    async provision(context) {
+        const databaseUrl = context.existingEnv.DATABASE_URL;
+        // Already configured — re-use
+        if (databaseUrl && (databaseUrl.startsWith("postgres://") || databaseUrl.startsWith("postgresql://"))) {
+            return {
+                success: true,
+                message: "Neon (or Postgres) already configured — DATABASE_URL present in environment",
+                secrets: {
+                    DATABASE_URL: databaseUrl,
+                    NEON_DATABASE_URL: databaseUrl,
+                },
+                config: { service: "neon/db", existing: true },
+            };
+        }
+        const apiKey = context.existingEnv.NEON_API_KEY;
+        if (!apiKey) {
+            return {
+                success: false,
+                error: "Missing NEON_API_KEY",
+                message: [
+                    "Set NEON_API_KEY before running kit add neon/db:",
+                    "  1. Go to https://console.neon.tech/app/settings/api-keys and create an API key",
+                    "  2. Export it: export NEON_API_KEY=<your-key>",
+                    "  3. Re-run: kit add neon/db",
+                ].join("\n"),
+            };
+        }
+        const projectName = context.projectName ?? context.projectPath.split("/").pop() ?? "kit-db";
+        let project;
+        try {
+            const resp = await fetch("https://api.neon.tech/v2/projects", {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify({ project: { name: projectName } }),
+            });
+            if (!resp.ok) {
+                const body = await resp.text();
+                return {
+                    success: false,
+                    error: `Neon API error ${resp.status}: ${body}`,
+                    message: "Failed to create Neon project",
+                };
+            }
+            project = (await resp.json());
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Network error",
+                message: "Failed to reach Neon API",
+            };
+        }
+        const connectionUri = project.connection_uris?.[0]?.connection_uri;
+        if (!connectionUri) {
+            return {
+                success: false,
+                error: "Neon project created but no connection URI returned",
+                message: `Project '${projectName}' created (id: ${project.project.id}) but connection URI was empty`,
+            };
+        }
+        return {
+            success: true,
+            message: `Neon project '${projectName}' created`,
+            secrets: {
+                DATABASE_URL: connectionUri,
+                NEON_DATABASE_URL: connectionUri,
+            },
+            config: { service: "neon/db", projectId: project.project.id, name: projectName },
+        };
+    },
+};
+//# sourceMappingURL=neon-db.js.map

package/dist/adapters/neon-db.js.map

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

package/dist/adapters/planetscale-db.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceAdapter } from "./types.js";
+/**
+ * PlanetScale MySQL Adapter
+ *
+ * Provisions a PlanetScale serverless MySQL database via the PlanetScale API.
+ * Requires PLANETSCALE_SERVICE_TOKEN_ID + PLANETSCALE_SERVICE_TOKEN +
+ * PLANETSCALE_ORG in the environment.
+ *
+ * API reference: https://api.planetscale.com/v1
+ */
+export declare const planetscaleDbAdapter: ServiceAdapter;

package/dist/adapters/planetscale-db.js

@@ -0,0 +1,134 @@
+/**
+ * PlanetScale MySQL Adapter
+ *
+ * Provisions a PlanetScale serverless MySQL database via the PlanetScale API.
+ * Requires PLANETSCALE_SERVICE_TOKEN_ID + PLANETSCALE_SERVICE_TOKEN +
+ * PLANETSCALE_ORG in the environment.
+ *
+ * API reference: https://api.planetscale.com/v1
+ */
+export const planetscaleDbAdapter = {
+    name: "planetscale/db",
+    description: "PlanetScale serverless MySQL database",
+    getRequiredTools() {
+        return []; // API-based, no CLI needed
+    },
+    async check(context) {
+        const url = context.existingEnv.DATABASE_URL;
+        return !!(url && url.startsWith("mysql://"));
+    },
+    async provision(context) {
+        const tokenId = context.existingEnv.PLANETSCALE_SERVICE_TOKEN_ID;
+        const token = context.existingEnv.PLANETSCALE_SERVICE_TOKEN;
+        const org = context.existingEnv.PLANETSCALE_ORG;
+        // Already configured — re-use
+        if (context.existingEnv.DATABASE_URL?.startsWith("mysql://")) {
+            return {
+                success: true,
+                message: "PlanetScale already configured — DATABASE_URL present in environment",
+                secrets: buildSecrets(context.existingEnv),
+                config: { service: "planetscale/db", existing: true },
+            };
+        }
+        // Missing credentials
+        if (!tokenId || !token || !org) {
+            const missing = [
+                !tokenId && "PLANETSCALE_SERVICE_TOKEN_ID",
+                !token && "PLANETSCALE_SERVICE_TOKEN",
+                !org && "PLANETSCALE_ORG",
+            ].filter(Boolean);
+            return {
+                success: false,
+                error: `Missing PlanetScale credentials: ${missing.join(", ")}`,
+                message: [
+                    "Set the following before running kit add planetscale/db:",
+                    "  PLANETSCALE_ORG — your PlanetScale organization name",
+                    "  PLANETSCALE_SERVICE_TOKEN_ID — service token ID",
+                    "  PLANETSCALE_SERVICE_TOKEN — service token secret",
+                    "  Create a service token at: https://app.planetscale.com/<org>/settings/service-tokens",
+                ].join("\n"),
+            };
+        }
+        const dbName = context.projectName ?? context.projectPath.split("/").pop() ?? "kit-db";
+        const headers = {
+            Authorization: `${tokenId}:${token}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        // Create database
+        let db;
+        try {
+            const resp = await fetch(`https://api.planetscale.com/v1/organizations/${org}/databases`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ name: dbName }),
+            });
+            if (!resp.ok) {
+                const body = await resp.text();
+                return {
+                    success: false,
+                    error: `PlanetScale API error ${resp.status}: ${body}`,
+                    message: "Failed to create PlanetScale database",
+                };
+            }
+            db = (await resp.json());
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Network error",
+                message: "Failed to reach PlanetScale API",
+            };
+        }
+        // Create a connection password for the main branch
+        let password;
+        try {
+            const resp = await fetch(`https://api.planetscale.com/v1/organizations/${org}/databases/${db.name}/branches/main/passwords`, {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ name: `${dbName}-kit`, role: "readwriter" }),
+            });
+            if (!resp.ok) {
+                const body = await resp.text();
+                return {
+                    success: false,
+                    error: `PlanetScale password API error ${resp.status}: ${body}`,
+                    message: "Database created but failed to generate connection password",
+                };
+            }
+            password = (await resp.json());
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : "Network error",
+                message: "Failed to create database connection password",
+            };
+        }
+        const databaseUrl = `mysql://${password.username}:${password.plain_text}@${password.access_host_url}/${db.name}?ssl={"rejectUnauthorized":true}`;
+        return {
+            success: true,
+            message: `PlanetScale database '${db.name}' created`,
+            secrets: {
+                DATABASE_URL: databaseUrl,
+                PLANETSCALE_HOST: password.access_host_url,
+                PLANETSCALE_USERNAME: password.username,
+                PLANETSCALE_PASSWORD: password.plain_text,
+            },
+            config: { service: "planetscale/db", database: db.name, org },
+        };
+    },
+};
+function buildSecrets(env) {
+    const secrets = {};
+    if (env.DATABASE_URL)
+        secrets.DATABASE_URL = env.DATABASE_URL;
+    if (env.PLANETSCALE_HOST)
+        secrets.PLANETSCALE_HOST = env.PLANETSCALE_HOST;
+    if (env.PLANETSCALE_USERNAME)
+        secrets.PLANETSCALE_USERNAME = env.PLANETSCALE_USERNAME;
+    if (env.PLANETSCALE_PASSWORD)
+        secrets.PLANETSCALE_PASSWORD = env.PLANETSCALE_PASSWORD;
+    return secrets;
+}
+//# sourceMappingURL=planetscale-db.js.map

package/dist/adapters/planetscale-db.js.map

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

package/dist/adapters/posthog-analytics.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PostHog — product analytics, session recording, feature flags.
+ * API-based; reuses NEXT_PUBLIC_POSTHOG_KEY and carries an optional host
+ * (defaults to US cloud; override for EU cloud / self-hosted).
+ */
+export declare const posthogAnalyticsAdapter: import("sandstream-kit-adapter-sdk").ServiceAdapter;

package/dist/adapters/posthog-analytics.js

@@ -0,0 +1,22 @@
+import { apiKeyAdapter } from "./api-key-adapter.js";
+/**
+ * PostHog — product analytics, session recording, feature flags.
+ * API-based; reuses NEXT_PUBLIC_POSTHOG_KEY and carries an optional host
+ * (defaults to US cloud; override for EU cloud / self-hosted).
+ */
+export const posthogAnalyticsAdapter = apiKeyAdapter({
+    name: "posthog/analytics",
+    description: "PostHog product analytics, session recording, and feature flags",
+    required: ["NEXT_PUBLIC_POSTHOG_KEY"],
+    optional: [{ env: "NEXT_PUBLIC_POSTHOG_HOST", default: "https://us.i.posthog.com" }],
+    steps: [
+        "Set NEXT_PUBLIC_POSTHOG_KEY before running kit add posthog/analytics:",
+        "  1. Go to https://app.posthog.com and create a project",
+        "  2. Navigate to Settings → Project API key",
+        "  3. Export: export NEXT_PUBLIC_POSTHOG_KEY=phc_...",
+        "  4. Re-run: kit add posthog/analytics",
+        "  (Self-hosted: also set NEXT_PUBLIC_POSTHOG_HOST=https://your-posthog-host.com)",
+        "  (EU cloud: set NEXT_PUBLIC_POSTHOG_HOST=https://eu.i.posthog.com)",
+    ],
+});
+//# sourceMappingURL=posthog-analytics.js.map

package/dist/adapters/posthog-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-analytics.js","sourceRoot":"","sources":["../../src/adapters/posthog-analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;IACnD,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,iEAAiE;IAC9E,QAAQ,EAAE,CAAC,yBAAyB,CAAC;IACrC,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,0BAA0B,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACpF,KAAK,EAAE;QACL,uEAAuE;QACvE,yDAAyD;QACzD,6CAA6C;QAC7C,qDAAqD;QACrD,wCAAwC;QACxC,kFAAkF;QAClF,qEAAqE;KACtE;CACF,CAAC,CAAC"}

package/dist/adapters/railway-hosting.d.ts

@@ -0,0 +1,2 @@
+import type { ServiceAdapter } from "sandstream-kit-adapter-sdk";
+export declare const railwayHostingAdapter: ServiceAdapter;

package/dist/adapters/railway-hosting.js

@@ -0,0 +1,136 @@
+import { exec } from "../utils/exec.js";
+async function runRailway(args, cwd, env) {
+    try {
+        const { stdout, stderr } = await exec("railway", args, {
+            cwd,
+            timeout: 120_000,
+            env: { ...process.env, ...env },
+        });
+        return { ok: true, stdout: stdout.trim(), stderr: stderr.trim() };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            ok: false,
+            stdout: e.stdout?.trim() ?? "",
+            stderr: (e.stderr ?? e.message ?? String(err)).trim(),
+        };
+    }
+}
+export const railwayHostingAdapter = {
+    name: "railway/hosting",
+    description: "Railway — Heroku-style deployment platform (hosting provisioning)",
+    getRequiredTools() {
+        return ["railway"];
+    },
+    async check(context) {
+        const token = context.existingEnv["RAILWAY_TOKEN"];
+        const projectId = context.existingEnv["RAILWAY_PROJECT_ID"];
+        // If token exists, consider it configured
+        if (token)
+            return true;
+        // Otherwise check if railway CLI is authenticated
+        if (!projectId)
+            return false;
+        const { ok } = await runRailway(["status"], context.projectPath);
+        return ok;
+    },
+    async provision(context) {
+        // Key-reuse: if we already have a project ID, return it
+        const existingToken = context.existingEnv["RAILWAY_TOKEN"];
+        const existingProjectId = context.existingEnv["RAILWAY_PROJECT_ID"];
+        const existingEnvId = context.existingEnv["RAILWAY_ENVIRONMENT_ID"];
+        if (existingToken && existingProjectId && existingEnvId) {
+            return {
+                success: true,
+                message: "Railway project already configured",
+                secrets: {
+                    RAILWAY_TOKEN: existingToken,
+                    RAILWAY_PROJECT_ID: existingProjectId,
+                    RAILWAY_ENVIRONMENT_ID: existingEnvId,
+                },
+            };
+        }
+        // Step 1: Check if railway CLI is installed and available
+        const installCheckResult = await runRailway(["--version"], context.projectPath);
+        if (!installCheckResult.ok) {
+            return {
+                success: false,
+                message: "Railway CLI not found. Install with: npm install -g @railway/cli",
+                error: "railway CLI not installed",
+            };
+        }
+        // Step 2: Ensure user is logged in (browserless is not interactive)
+        // In non-interactive mode, token should be set via RAILWAY_TOKEN env var
+        const loginCheckResult = await runRailway(["whoami"], context.projectPath);
+        if (!loginCheckResult.ok && !existingToken) {
+            return {
+                success: false,
+                message: "Not authenticated with Railway. Login with: railway login",
+                error: "not authenticated",
+            };
+        }
+        // Step 3: Initialize Railway project if needed
+        let initResult = await runRailway(["link"], context.projectPath);
+        if (!initResult.ok) {
+            // If link fails, try init
+            initResult = await runRailway(["init", "--empty"], context.projectPath);
+            if (!initResult.ok) {
+                return {
+                    success: false,
+                    message: `Failed to initialize Railway project: ${initResult.stderr}`,
+                    error: "failed to init",
+                };
+            }
+        }
+        // Step 4: Extract project information
+        const statusResult = await runRailway(["status"], context.projectPath);
+        if (!statusResult.ok) {
+            return {
+                success: false,
+                message: `Failed to get Railway project status: ${statusResult.stderr}`,
+                error: "status failed",
+            };
+        }
+        // Parse project ID from status output
+        // Expected format includes: Project: <project-id>
+        const projectMatch = statusResult.stdout.match(/Project:\s+(\w+)/);
+        const projectId = projectMatch?.[1];
+        if (!projectId) {
+            return {
+                success: false,
+                message: "Could not extract Railway project ID from status",
+                error: "project id not found",
+            };
+        }
+        // Step 5: Get environment ID (default to 'production')
+        const envMatch = statusResult.stdout.match(/Environment:\s+(\w+)/);
+        const environmentId = envMatch?.[1] || "production";
+        // Step 6: Ensure we have a token
+        let token = existingToken;
+        if (!token) {
+            // Try to get token from railway
+            const tokenResult = await runRailway(["token"], context.projectPath);
+            if (tokenResult.ok) {
+                token = tokenResult.stdout;
+            }
+            else {
+                return {
+                    success: false,
+                    message: "Could not obtain Railway API token",
+                    error: "token not found",
+                };
+            }
+        }
+        return {
+            success: true,
+            message: `Railway project configured: ${projectId}`,
+            secrets: {
+                RAILWAY_TOKEN: token,
+                RAILWAY_PROJECT_ID: projectId,
+                RAILWAY_ENVIRONMENT_ID: environmentId,
+            },
+        };
+    },
+};
+//# sourceMappingURL=railway-hosting.js.map

package/dist/adapters/railway-hosting.js.map

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

package/dist/adapters/resend-email.d.ts

@@ -0,0 +1,35 @@
+import type { ServiceAdapter } from "./types.js";
+interface ResendApiKey {
+    id: string;
+    token: string;
+}
+/**
+ * Resend Email Adapter
+ *
+ * Provisions a project-scoped Resend API key for transactional email.
+ * Requires a master RESEND_API_KEY in the environment (from the Resend dashboard).
+ *
+ * API reference: https://resend.com/docs/api-reference/api-keys/create-api-key
+ */
+export declare const resendEmailAdapter: ServiceAdapter;
+/**
+ * Resend Email Provisioner — creates a scoped API key via the Resend API.
+ *
+ * Called by resendEmailAdapter.provision() when a master key is available
+ * and we want to create a project-scoped key instead of reusing the master.
+ *
+ * Exported separately so it can be tested without stubbing the adapter.
+ */
+export declare function provisionResendApiKey(masterKey: string, keyName: string): Promise<{
+    success: true;
+    key: ResendApiKey;
+} | {
+    success: false;
+    error: string;
+}>;
+/**
+ * Fetch the first verified sending domain for the account.
+ * Returns null if none exist (use onboarding@resend.dev as fallback).
+ */
+export declare function fetchFirstVerifiedDomain(apiKey: string): Promise<string | null>;
+export {};