@vibesdotdev/infra-core 0.0.1

package/dist/schemas.d.ts

@@ -0,0 +1,125 @@
+import * as z from 'zod/v4';
+/**
+ * Deployment providers with active adapter implementations.
+ * Only providers backed by adapter packages are enumerated.
+ * - cloudflare-workers: via infra-cloudflare
+ * - digitalocean-app: via infra-doks
+ */
+export declare const deploymentProviderSchema: z.ZodEnum<{
+    "cloudflare-workers": "cloudflare-workers";
+    "digitalocean-app": "digitalocean-app";
+}>;
+export type DeploymentProvider = z.infer<typeof deploymentProviderSchema>;
+export declare const appRuntimeSchema: z.ZodEnum<{
+    edge: "edge";
+    worker: "worker";
+    node: "node";
+    browser: "browser";
+}>;
+export type AppRuntime = z.infer<typeof appRuntimeSchema>;
+export declare const deploymentOriginSchema: z.ZodObject<{
+    hostname: z.ZodString;
+    origin: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<{
+        primary: "primary";
+        redirect: "redirect";
+        preview: "preview";
+        internal: "internal";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeploymentOrigin = z.infer<typeof deploymentOriginSchema>;
+export declare const deploymentBuildSchema: z.ZodObject<{
+    workspaceRootDir: z.ZodDefault<z.ZodString>;
+    appDir: z.ZodString;
+    installCommand: z.ZodOptional<z.ZodString>;
+    buildCommand: z.ZodString;
+    outputDir: z.ZodString;
+}, z.core.$strip>;
+export type DeploymentBuild = z.infer<typeof deploymentBuildSchema>;
+export declare const deploymentEnvRequirementSchema: z.ZodObject<{
+    name: z.ZodString;
+    public: z.ZodOptional<z.ZodBoolean>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    value: z.ZodOptional<z.ZodString>;
+    secret: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    storeKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeploymentEnvRequirement = z.infer<typeof deploymentEnvRequirementSchema>;
+export declare const deploymentDependencySchema: z.ZodObject<{
+    appId: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type DeploymentDependency = z.infer<typeof deploymentDependencySchema>;
+export declare const deploymentUpstreamSchema: z.ZodObject<{
+    name: z.ZodString;
+    origin: z.ZodString;
+    purpose: z.ZodString;
+    originEnvVar: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeploymentUpstream = z.infer<typeof deploymentUpstreamSchema>;
+export declare const appDeploymentSchema: z.ZodObject<{
+    appId: z.ZodString;
+    appName: z.ZodString;
+    provider: z.ZodEnum<{
+        "cloudflare-workers": "cloudflare-workers";
+        "digitalocean-app": "digitalocean-app";
+    }>;
+    runtime: z.ZodEnum<{
+        edge: "edge";
+        worker: "worker";
+        node: "node";
+        browser: "browser";
+    }>;
+    build: z.ZodObject<{
+        workspaceRootDir: z.ZodDefault<z.ZodString>;
+        appDir: z.ZodString;
+        installCommand: z.ZodOptional<z.ZodString>;
+        buildCommand: z.ZodString;
+        outputDir: z.ZodString;
+    }, z.core.$strip>;
+    origins: z.ZodArray<z.ZodObject<{
+        hostname: z.ZodString;
+        origin: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            primary: "primary";
+            redirect: "redirect";
+            preview: "preview";
+            internal: "internal";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    env: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        public: z.ZodOptional<z.ZodBoolean>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        value: z.ZodOptional<z.ZodString>;
+        secret: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        storeKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        appId: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+    upstreams: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        origin: z.ZodString;
+        purpose: z.ZodString;
+        originEnvVar: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    kvNamespaces: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        binding: z.ZodString;
+        id: z.ZodString;
+        preview_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    preDeployCommands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type AppDeploymentInput = z.input<typeof appDeploymentSchema>;
+export type AppDeployment = z.infer<typeof appDeploymentSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;;;EAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAW1E,eAAO,MAAM,gBAAgB;;;;;EAAgD,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;;;;;;iBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,qBAAqB;;;;;;iBAMhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,8BAA8B;;;;;;;;iBAazC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,wBAAwB;;;;;iBAQnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+C9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,102 @@
+import * as z from 'zod/v4';
+/**
+ * Deployment providers with active adapter implementations.
+ * Only providers backed by adapter packages are enumerated.
+ * - cloudflare-workers: via infra-cloudflare
+ * - digitalocean-app: via infra-doks
+ */
+export const deploymentProviderSchema = z.enum([
+    'cloudflare-workers',
+    'digitalocean-app'
+]);
+/**
+ * Map of valid provider × runtime combinations.
+ * Used for cross-validation in appDeploymentSchema refinement.
+ */
+const VALID_PROVIDER_RUNTIME_MATRIX = {
+    'cloudflare-workers': ['edge', 'worker'],
+    'digitalocean-app': ['node', 'worker']
+};
+export const appRuntimeSchema = z.enum(['edge', 'node', 'worker', 'browser']);
+export const deploymentOriginSchema = z.object({
+    hostname: z.string().min(1),
+    origin: z.string().url(),
+    kind: z.enum(['primary', 'redirect', 'preview', 'internal']).default('primary'),
+    description: z.string().optional()
+});
+export const deploymentBuildSchema = z.object({
+    workspaceRootDir: z.string().min(1).default('.'),
+    appDir: z.string().min(1),
+    installCommand: z.string().min(1).optional(),
+    buildCommand: z.string().min(1),
+    outputDir: z.string().min(1)
+});
+export const deploymentEnvRequirementSchema = z.object({
+    name: z.string().regex(/^[_A-Z0-9]+$/),
+    public: z.boolean().optional(),
+    required: z.boolean().optional(),
+    value: z.string().optional(),
+    secret: z.boolean().optional(),
+    description: z.string().optional(),
+    /**
+     * Override the secret name in the remote store. Defaults to `name` when omitted.
+     * Only meaningful when `secret: true` and the deployment targets a shared
+     * Secrets Store binding (e.g. `secrets_store_secrets[].secret_name`).
+     */
+    storeKey: z.string().min(1).optional()
+});
+export const deploymentDependencySchema = z.object({
+    appId: z.string().min(1),
+    reason: z.string().min(1)
+});
+export const deploymentUpstreamSchema = z.object({
+    name: z.string().min(1),
+    origin: z.string().url(),
+    purpose: z.string().min(1),
+    originEnvVar: z
+        .string()
+        .regex(/^[_A-Z0-9]+$/)
+        .optional()
+});
+export const appDeploymentSchema = z
+    .object({
+    appId: z.string().min(1),
+    appName: z.string().min(1),
+    provider: deploymentProviderSchema,
+    runtime: appRuntimeSchema,
+    build: deploymentBuildSchema,
+    origins: z.array(deploymentOriginSchema).min(1),
+    env: z.array(deploymentEnvRequirementSchema).default([]),
+    dependsOn: z.array(deploymentDependencySchema).default([]),
+    upstreams: z.array(deploymentUpstreamSchema).default([]),
+    tags: z.array(z.string()).default([]),
+    /** Cloudflare KV namespace bindings (provider-specific extension). */
+    kvNamespaces: z
+        .array(z.object({
+        binding: z.string().min(1),
+        id: z.string().min(1),
+        preview_id: z.string().optional()
+    }))
+        .default([]),
+    /**
+     * One-off commands to run before the Worker deploy (e.g. DB migrations,
+     * seed scripts, cache warmers). Executed sequentially in the appDir.
+     */
+    preDeployCommands: z
+        .array(z.object({
+        command: z.string().min(1),
+        description: z.string().optional()
+    }))
+        .default([])
+})
+    .refine((data) => {
+    const validRuntimes = VALID_PROVIDER_RUNTIME_MATRIX[data.provider];
+    return validRuntimes.includes(data.runtime);
+}, {
+    error: (issue) => {
+        const data = issue.input;
+        return `Invalid runtime "${data.runtime}" for provider "${data.provider}". Valid runtimes: ${VALID_PROVIDER_RUNTIME_MATRIX[data.provider].join(', ')}`;
+    },
+    path: ['runtime']
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/package.json

@@ -0,0 +1,92 @@
+{
+  "name": "@vibesdotdev/infra-core",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./deployment": {
+      "types": "./dist/deployment.d.ts",
+      "bun": "./src/deployment.ts",
+      "import": "./dist/deployment.js",
+      "default": "./dist/deployment.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas.d.ts",
+      "bun": "./src/schemas.ts",
+      "import": "./dist/schemas.js",
+      "default": "./dist/schemas.js"
+    },
+    "./kinds": {
+      "types": "./dist/kinds/index.d.ts",
+      "bun": "./src/kinds/index.ts",
+      "import": "./dist/kinds/index.js",
+      "default": "./dist/kinds/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/infra.plugin.d.ts",
+      "bun": "./src/infra.plugin.ts",
+      "import": "./dist/infra.plugin.js",
+      "default": "./dist/infra.plugin.js"
+    },
+    "./bootstrap": {
+      "types": "./dist/bootstrap/index.d.ts",
+      "bun": "./src/bootstrap/index.ts",
+      "import": "./dist/bootstrap/index.js",
+      "default": "./dist/bootstrap/index.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vibesdotdev/monorepo.git",
+    "directory": "packages/infra-core"
+  },
+  "dependencies": {
+    "@vibesdotdev/logging": "0.0.1",
+    "@vibesdotdev/runtime": "0.0.1",
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "test": "bun test",
+    "check": "bun --bun tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "src",
+    "bin",
+    "README.md",
+    "SPEC.md",
+    "LICENSE",
+    "!src/**/__tests__/**",
+    "!src/**/__stubs__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
+    "!dist/**/__tests__/**",
+    "!dist/**/__stubs__/**",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/*.spec.js",
+    "!dist/**/*.spec.js.map",
+    "!dist/**/*.spec.d.ts",
+    "!dist/**/*.spec.d.ts.map"
+  ],
+  "vibes": {
+    "visibility": "public-framework"
+  }
+}

package/src/bootstrap/index.ts

@@ -0,0 +1,15 @@
+export { bootstrapSeedKind } from './seed.kind.ts';
+export {
+	bootstrapSeedConditionSchema,
+	bootstrapSeedDescriptorSchema,
+	bootstrapSeedModeSchema,
+	type BootstrapSeedCondition,
+	type BootstrapSeedDescriptor,
+	type BootstrapSeedMode
+} from './seed.descriptor.ts';
+export type { BootstrapSeedImpl } from './seed.impl-shape.ts';
+export {
+	runBootstrapSeeds,
+	type BootstrapSeedRunOptions,
+	type BootstrapSeedRunResult
+} from './seed.runner.ts';

package/src/bootstrap/seed.descriptor.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+
+export const bootstrapSeedModeSchema = z.enum(['cold-start', 'deploy']);
+export type BootstrapSeedMode = z.infer<typeof bootstrapSeedModeSchema>;
+
+export const bootstrapSeedConditionSchema = z.discriminatedUnion('kind', [
+	z.object({ kind: z.literal('always') }),
+	z.object({
+		kind: z.literal('env-keys-present'),
+		keys: z.array(z.string().min(1)).min(1)
+	})
+]);
+export type BootstrapSeedCondition = z.infer<typeof bootstrapSeedConditionSchema>;
+
+export const bootstrapSeedDescriptorSchema = z.object({
+	kind: z.literal('bootstrap/seed'),
+	id: z.string().min(1),
+	description: z.string().optional(),
+	executeOn: z.array(bootstrapSeedModeSchema).min(1),
+	condition: bootstrapSeedConditionSchema.optional(),
+	priority: z.number().int().optional()
+});
+
+export type BootstrapSeedDescriptor = z.infer<typeof bootstrapSeedDescriptorSchema>;

package/src/bootstrap/seed.impl-shape.ts

@@ -0,0 +1,5 @@
+import type { VibesRuntime } from '@vibesdotdev/runtime';
+
+export interface BootstrapSeedImpl {
+	run(runtime: VibesRuntime, env: Record<string, string | undefined>): Promise<void>;
+}

package/src/bootstrap/seed.kind.ts

@@ -0,0 +1,26 @@
+import type { RuntimeDescriptor, RuntimeKindDescriptor } from '@vibesdotdev/runtime/schemas/kind';
+import {
+	bootstrapSeedDescriptorSchema,
+	type BootstrapSeedDescriptor
+} from './seed.descriptor.ts';
+import type { BootstrapSeedImpl } from './seed.impl-shape.ts';
+
+class UnregisteredBootstrapSeed implements BootstrapSeedImpl {
+	constructor(_descriptor: RuntimeDescriptor) {}
+	async run(): Promise<void> {
+		// No-op when no impl loader is registered for this descriptor id.
+	}
+}
+
+export const bootstrapSeedKind: RuntimeKindDescriptor<
+	BootstrapSeedDescriptor,
+	BootstrapSeedImpl,
+	never
+> = {
+	id: 'bootstrap/seed',
+	descriptorSchema: bootstrapSeedDescriptorSchema,
+	defaultImplementation: UnregisteredBootstrapSeed as unknown as new (
+		descriptor: RuntimeDescriptor
+	) => BootstrapSeedImpl,
+	contexts: []
+};

package/src/bootstrap/seed.runner.ts

@@ -0,0 +1,87 @@
+import type { VibesRuntime } from '@vibesdotdev/runtime';
+import { getLogger } from '@vibesdotdev/logging';
+import type {
+	BootstrapSeedCondition,
+	BootstrapSeedDescriptor,
+	BootstrapSeedMode
+} from './seed.descriptor.ts';
+import type { BootstrapSeedImpl } from './seed.impl-shape.ts';
+
+const log = getLogger('infra.bootstrap.seed');
+
+export interface BootstrapSeedRunResult {
+	ran: string[];
+	skipped: Array<{ id: string; reason: string }>;
+	failed: Array<{ id: string; error: string }>;
+}
+
+export interface BootstrapSeedRunOptions {
+	env: Record<string, string | undefined>;
+}
+
+export async function runBootstrapSeeds(
+	runtime: VibesRuntime,
+	mode: BootstrapSeedMode,
+	options: BootstrapSeedRunOptions
+): Promise<BootstrapSeedRunResult> {
+	const allDescriptors = runtime
+		.assets('bootstrap/seed')
+		.descriptors() as unknown as readonly BootstrapSeedDescriptor[];
+
+	const result: BootstrapSeedRunResult = { ran: [], skipped: [], failed: [] };
+	const runnable: BootstrapSeedDescriptor[] = [];
+
+	for (const descriptor of allDescriptors) {
+		if (!descriptor.executeOn.includes(mode)) {
+			result.skipped.push({
+				id: descriptor.id,
+				reason: `mode ${mode} not in executeOn`
+			});
+			continue;
+		}
+		if (!evaluateCondition(descriptor.condition, options.env)) {
+			result.skipped.push({
+				id: descriptor.id,
+				reason: 'condition not met'
+			});
+			continue;
+		}
+		runnable.push(descriptor);
+	}
+
+	runnable.sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+
+	for (const descriptor of runnable) {
+		try {
+			const impl = (await runtime
+				.query('bootstrap/seed')
+				.withId(descriptor.id)
+				.resolve()) as BootstrapSeedImpl;
+			await impl.run(runtime, options.env);
+			result.ran.push(descriptor.id);
+			log.info('bootstrap seed completed', {
+				id: descriptor.id,
+				mode,
+				priority: descriptor.priority ?? 100
+			});
+		} catch (err) {
+			const error = err instanceof Error ? err.message : String(err);
+			result.failed.push({ id: descriptor.id, error });
+			log.error('bootstrap seed failed', { id: descriptor.id, mode, error });
+		}
+	}
+
+	return result;
+}
+
+function evaluateCondition(
+	condition: BootstrapSeedCondition | undefined,
+	env: Record<string, string | undefined>
+): boolean {
+	if (!condition) return true;
+	if (condition.kind === 'always') return true;
+	if (condition.kind === 'env-keys-present') {
+		return condition.keys.every((key) => Boolean(env[key]));
+	}
+	return true;
+}