vyft 0.3.0-alpha → 0.4.1-alpha

package/dist/exec.d.ts

@@ -1,2 +0,0 @@
-import type { Logger } from "pino";
-export declare function exec(command: string, cwd: string, env?: Record<string, string>, log?: Logger): Promise<void>;

package/dist/exec.js

@@ -1,28 +0,0 @@
-import { spawn } from "node:child_process";
-export async function exec(command, cwd, env, log) {
-    const start = performance.now();
-    log?.debug({ command, cwd }, "process spawning");
-    return new Promise((resolve, reject) => {
-        const proc = spawn(command, {
-            cwd,
-            stdio: "inherit",
-            shell: true,
-            env: env ? { ...process.env, ...env } : undefined,
-        });
-        proc.on("close", (code) => {
-            const durationMs = Math.round(performance.now() - start);
-            if (code !== 0) {
-                log?.debug({ command, cwd, exitCode: code, durationMs }, "process exited with error");
-                reject(new Error(`Command failed with exit code ${code}`));
-            }
-            else {
-                log?.debug({ command, cwd, exitCode: 0, durationMs }, "process exited");
-                resolve();
-            }
-        });
-        proc.on("error", (err) => {
-            log?.debug({ err, command, cwd }, "process spawn failed");
-            reject(err);
-        });
-    });
-}

package/dist/init.d.ts

@@ -1 +0,0 @@
-export declare function init(directory?: string): Promise<void>;

package/dist/init.js

@@ -1,117 +0,0 @@
-import { execSync } from "node:child_process";
-import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { confirm, intro, isCancel, log, outro, text } from "@clack/prompts";
-const TEMPLATES_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../templates/fullstack");
-async function walkDir(dir) {
-    const files = [];
-    const entries = await readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        const full = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            files.push(...(await walkDir(full)));
-        }
-        else {
-            files.push(full);
-        }
-    }
-    return files;
-}
-async function dirExists(dir) {
-    try {
-        const s = await stat(dir);
-        return s.isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-async function dirIsNonEmpty(dir) {
-    try {
-        const entries = await readdir(dir);
-        return entries.length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-export async function init(directory) {
-    intro("Create a new project");
-    const name = await text({
-        message: "Project name",
-        placeholder: "my-app",
-        defaultValue: directory || "my-app",
-        validate(value) {
-            if (!value)
-                return "Project name is required";
-            if (!/^[a-z0-9-]+$/.test(value))
-                return "Use lowercase letters, numbers, and hyphens only";
-        },
-    });
-    if (isCancel(name))
-        return;
-    const domain = await text({
-        message: "Domain",
-        placeholder: "example.com",
-        validate(value) {
-            if (!value)
-                return "Domain is required";
-            if (!/^[a-z0-9.-]+\.[a-z]{2,}$/.test(value))
-                return "Enter a valid domain (e.g. example.com)";
-        },
-    });
-    if (isCancel(domain))
-        return;
-    const targetDir = path.resolve(process.cwd(), directory || name);
-    if ((await dirExists(targetDir)) && (await dirIsNonEmpty(targetDir))) {
-        const ok = await confirm({
-            message: `Directory ${path.basename(targetDir)} is not empty. Continue?`,
-        });
-        if (isCancel(ok) || !ok)
-            return;
-    }
-    const templateFiles = await walkDir(TEMPLATES_DIR);
-    const replacements = {
-        "{{name}}": name,
-        "{{domain}}": domain,
-    };
-    for (const templateFile of templateFiles) {
-        let relativePath = path.relative(TEMPLATES_DIR, templateFile);
-        if (relativePath === "gitignore")
-            relativePath = ".gitignore";
-        if (relativePath === "dockerignore")
-            relativePath = ".dockerignore";
-        const destPath = path.join(targetDir, relativePath);
-        await mkdir(path.dirname(destPath), { recursive: true });
-        let content = await readFile(templateFile, "utf-8");
-        for (const [placeholder, value] of Object.entries(replacements)) {
-            content = content.replaceAll(placeholder, value);
-        }
-        await writeFile(destPath, content);
-        log.step(relativePath);
-    }
-    const ua = process.env.npm_config_user_agent ?? "";
-    const pm = ua.startsWith("pnpm")
-        ? "pnpm"
-        : ua.startsWith("bun")
-            ? "bun"
-            : "npm";
-    const install = await confirm({
-        message: `Install dependencies with ${pm}?`,
-    });
-    if (isCancel(install))
-        return;
-    if (install) {
-        log.step(`Running ${pm} install...`);
-        execSync(`${pm} install`, { cwd: targetDir, stdio: "inherit" });
-    }
-    outro("Project created");
-    console.log();
-    console.log("Next steps:");
-    console.log(`  cd ${path.relative(process.cwd(), targetDir)}`);
-    if (!install)
-        console.log(`  ${pm} install`);
-    console.log(`  ${pm} dev`);
-    console.log();
-}

package/dist/interpolate.d.ts

@@ -1,13 +0,0 @@
-import type { Interpolation, Reference } from "./resource.js";
-/**
- * Tagged template literal for building strings that contain {@link Reference} values
- * (e.g. secrets) which are resolved at deploy time.
- *
- * @example
- * ```ts
- * const connStr = interpolate`postgres://user:${dbPassword}@${db.host}:5432/app`;
- * ```
- *
- * @throws If none of the interpolated values are a {@link Reference}.
- */
-export declare function interpolate(strings: TemplateStringsArray, ...values: Array<Reference | string>): Interpolation;

package/dist/interpolate.js

@@ -1,19 +0,0 @@
-import { isReference } from "./resource.js";
-/**
- * Tagged template literal for building strings that contain {@link Reference} values
- * (e.g. secrets) which are resolved at deploy time.
- *
- * @example
- * ```ts
- * const connStr = interpolate`postgres://user:${dbPassword}@${db.host}:5432/app`;
- * ```
- *
- * @throws If none of the interpolated values are a {@link Reference}.
- */
-export function interpolate(strings, ...values) {
-    const hasRef = values.some(isReference);
-    if (!hasRef) {
-        throw new Error("interpolate() requires at least one Reference — use a plain string instead");
-    }
-    return { type: "interpolation", strings, values };
-}

package/dist/logger.d.ts

@@ -1,2 +0,0 @@
-import pino from "pino";
-export declare const logger: pino.Logger<never, boolean>;

package/dist/logger.js

@@ -1,10 +0,0 @@
-import pino from "pino";
-function resolveLevel() {
-    const val = process.env.LOG_LEVEL;
-    if (!val)
-        return "silent";
-    return val;
-}
-export const logger = pino({
-    level: resolveLevel(),
-});

package/dist/proxy.d.ts

@@ -1,16 +0,0 @@
-export interface ReverseProxy {
-    /** Ensure the proxy service is running and configured. */
-    ensure(): Promise<void>;
-    /** Register or update a route for a resource. */
-    addRoute(resourceId: string, route: string, target: {
-        host: string;
-        port: number;
-    }): Promise<void>;
-    /** Remove a route for a resource. No-op if it doesn't exist. */
-    removeRoute(resourceId: string): Promise<void>;
-    /** Stream proxy access logs. */
-    logs(options: {
-        follow?: boolean;
-        tail?: number;
-    }): Promise<void>;
-}

package/dist/resource.d.ts

@@ -1,174 +0,0 @@
-import type { RuntimeRef } from "./symbols.js";
-/** Discriminant for the four resource kinds. */
-export type ResourceType = "volume" | "secret" | "service" | "site";
-/** Configuration for a persistent volume. */
-export interface VolumeConfig {
-    /** Human-readable size hint (e.g. `"10GB"`). Informational only. */
-    size?: string;
-}
-/** Configuration for an auto-generated secret. */
-export interface SecretConfig {
-    /** Length of the generated random value in bytes. */
-    length?: number;
-}
-/** Container health-check configuration. */
-export interface HealthCheckConfig {
-    /** Command to run inside the container (e.g. `["pg_isready", "-U", "postgres"]`). */
-    command: string[];
-    /** Time between checks (e.g. `"5s"`, `"1m"`). */
-    interval?: string;
-    /** Maximum time a single check may take. */
-    timeout?: string;
-    /** Consecutive failures required to mark unhealthy. */
-    retries?: number;
-    /** Grace period before the first check runs. */
-    startPeriod?: string;
-}
-/** CPU and memory limits for a service. */
-export interface ResourceLimits {
-    /** Memory ceiling (e.g. `"512MB"`, `"2GB"`). */
-    memory?: string;
-    /** CPU core limit (e.g. `0.5`, `2`). */
-    cpus?: number;
-}
-/** A persistent storage volume. */
-export interface Volume extends RuntimeRef {
-    type: "volume";
-    id: string;
-    config: VolumeConfig;
-}
-/** An auto-generated secret value, injected at deploy time. */
-export interface Secret extends RuntimeRef {
-    type: "secret";
-    id: string;
-    config: SecretConfig;
-}
-/**
- * A long-running service (container).
- *
- * Use `host` and `port` to reference this service from other services
- * in the same project, or `url` for the full address.
- */
-export interface Service extends RuntimeRef {
-    type: "service";
-    id: string;
-    config: ServiceConfig;
-    /** Internal hostname reachable by other services. */
-    host: string;
-    /** Port the service listens on. */
-    port: number;
-    /** Full URL — `https://<route>` if routed, otherwise `http://<host>:<port>`. */
-    url: string;
-}
-/** A static site served via Caddy. */
-export interface Site extends RuntimeRef {
-    type: "site";
-    id: string;
-    config: SiteConfig;
-    /** Public URL derived from the route (e.g. `https://example.com`). */
-    url: string;
-}
-/** Union of all deployable resource types. */
-export type Resource = Volume | Secret | Service | Site;
-/**
- * A deferred reference to a value that isn't known until deploy time.
- *
- * Currently only {@link Secret} produces deferred values. Expand this
- * union as more resources gain deferred outputs.
- */
-export type Reference = Secret;
-/**
- * A tagged-template interpolation that mixes literal strings with
- * {@link Reference} values. Created via {@link interpolate}.
- *
- * @example
- * ```ts
- * const connStr = interpolate`postgres://user:${dbPassword}@${db.host}:5432/app`;
- * ```
- */
-export interface Interpolation {
-    type: "interpolation";
-    strings: TemplateStringsArray;
-    values: Array<Reference | string>;
-}
-/**
- * A value that can appear in a service's `env` map.
- *
- * - Plain `string` — set verbatim.
- * - {@link Reference} — resolved at deploy time (e.g. a secret).
- * - {@link Interpolation} — a template mixing strings and references.
- */
-export type EnvValue = string | Reference | Interpolation;
-/** Type-guard: returns `true` if `value` is a {@link Reference}. */
-export declare function isReference(value: unknown): value is Reference;
-/** Type-guard: returns `true` if `value` is a {@link Secret}. */
-export declare function isSecret(value: unknown): value is Secret;
-/** Type-guard: returns `true` if `value` is an {@link Interpolation}. */
-export declare function isInterpolation(value: unknown): value is Interpolation;
-/** Configuration for a long-running service. */
-export interface ServiceConfig {
-    /**
-     * Container image to run.
-     *
-     * - `string` — a registry image (e.g. `"node:22"`).
-     * - `{ context, dockerfile }` — build from a local Dockerfile.
-     */
-    image: string | {
-        context?: string;
-        dockerfile?: string;
-    };
-    /** Public route to expose (e.g. `"api.example.com"` or `"example.com/api"`). */
-    route?: string;
-    /** Port the container listens on. Defaults to `3000`. */
-    port?: number;
-    /** Environment variables injected into the container. */
-    env?: Record<string, EnvValue>;
-    /** Override the container's default command. */
-    command?: string[];
-    /** Volumes to mount into the container. */
-    volumes?: Array<{
-        volume: Volume;
-        mount: string;
-    }>;
-    /** Services that must be healthy before this one starts. */
-    dependsOn?: Service[];
-    /** Container health check. */
-    healthCheck?: HealthCheckConfig;
-    /**
-     * Restart behaviour on failure.
-     * @defaultValue `"any"`
-     */
-    restartPolicy?: "none" | "on-failure" | "any";
-}
-/** Configuration for a static site. */
-export interface SiteConfig {
-    /** Domain (and optional path) to serve the site on. */
-    route: string;
-    /**
-     * Enable single-page application mode. When `true`, all requests that
-     * don't match a static file are rewritten to `/index.html`.
-     * @defaultValue `true`
-     */
-    spa?: boolean;
-    /** Build settings for the static site. */
-    build: {
-        /** Working directory containing the source (relative to project root). */
-        cwd: string;
-        /** Directory containing the built output (relative to `cwd`). Defaults to `"dist"`. */
-        output?: string;
-        /** Build command to run (e.g. `"npm run build"`). */
-        command?: string;
-        /** Environment variables passed to the build command. */
-        env?: Record<string, string>;
-    };
-}
-/**
- * Validates a resource ID.
- * @throws If the ID is empty, too long, or contains invalid characters.
- */
-export declare function validateId(id: string): void;
-/**
- * Validates a route string.
- * @throws If the route is empty or not a valid domain with optional path.
- */
-export declare function validateRoute(route: string): void;

package/dist/resource.js

@@ -1,45 +0,0 @@
-/** Type-guard: returns `true` if `value` is a {@link Reference}. */
-export function isReference(value) {
-    return isSecret(value);
-}
-/** Type-guard: returns `true` if `value` is a {@link Secret}. */
-export function isSecret(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        value.type === "secret");
-}
-/** Type-guard: returns `true` if `value` is an {@link Interpolation}. */
-export function isInterpolation(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        value.type === "interpolation");
-}
-const ID_PATTERN = /^[a-z][a-z0-9-]*[a-z0-9]$|^[a-z]$/;
-const ROUTE_PATTERN = /^(\*\.)?[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*(\/.+)?$/;
-/**
- * Validates a resource ID.
- * @throws If the ID is empty, too long, or contains invalid characters.
- */
-export function validateId(id) {
-    if (!id || id.length < 1) {
-        throw new Error("Resource ID cannot be empty");
-    }
-    if (id.length > 63) {
-        throw new Error("Resource ID cannot exceed 63 characters");
-    }
-    if (!ID_PATTERN.test(id)) {
-        throw new Error(`Invalid resource ID "${id}": must start with a letter, contain only lowercase letters, numbers, and hyphens, and end with a letter or number`);
-    }
-}
-/**
- * Validates a route string.
- * @throws If the route is empty or not a valid domain with optional path.
- */
-export function validateRoute(route) {
-    if (!route) {
-        throw new Error("Route cannot be empty");
-    }
-    if (!ROUTE_PATTERN.test(route)) {
-        throw new Error(`Invalid route "${route}": must be a valid domain with optional path`);
-    }
-}

package/dist/services/index.d.ts

@@ -1,24 +0,0 @@
-import type { Secret, SecretConfig, Service, ServiceConfig, Volume, VolumeConfig } from "../resource.js";
-export interface Primitives {
-    volume(id: string, config?: VolumeConfig): Volume;
-    service(id: string, config: ServiceConfig): Service;
-    secret(id: string, config?: SecretConfig): Secret;
-}
-export declare function createServices(p: Primitives): {
-    postgres: (id: string, config?: import("./postgres.js").PostgresConfig) => import("./postgres.js").Postgres;
-    redis: (id: string, config?: import("./redis.js").RedisConfig) => import("./redis.js").Redis;
-    rabbitmq: (id: string, config?: import("./rabbitmq.js").RabbitmqConfig) => import("./rabbitmq.js").Rabbitmq;
-    nats: (id: string, config?: import("./nats.js").NatsConfig) => import("./nats.js").Nats;
-    mysql: (id: string, config?: import("./mysql.js").MysqlConfig) => import("./mysql.js").Mysql;
-    mongo: (id: string, config?: import("./mongo.js").MongoConfig) => import("./mongo.js").Mongo;
-    minio: (id: string, config?: import("./minio.js").MinioConfig) => import("./minio.js").Minio;
-    storage: (id: string, config?: import("./storage.js").StorageConfig) => import("./storage.js").Storage;
-};
-export type { Bucket, Minio, MinioConfig } from "./minio.js";
-export type { Mongo, MongoConfig } from "./mongo.js";
-export type { Mysql, MysqlConfig } from "./mysql.js";
-export type { Nats, NatsConfig } from "./nats.js";
-export type { Postgres, PostgresConfig } from "./postgres.js";
-export type { Rabbitmq, RabbitmqConfig } from "./rabbitmq.js";
-export type { Redis, RedisConfig } from "./redis.js";
-export type { BackupConfig, Storage, StorageConfig } from "./storage.js";

package/dist/services/index.js

@@ -1,20 +0,0 @@
-import { createMinio } from "./minio.js";
-import { createMongo } from "./mongo.js";
-import { createMysql } from "./mysql.js";
-import { createNats } from "./nats.js";
-import { createPostgres } from "./postgres.js";
-import { createRabbitmq } from "./rabbitmq.js";
-import { createRedis } from "./redis.js";
-import { createStorage } from "./storage.js";
-export function createServices(p) {
-    return {
-        postgres: createPostgres(p),
-        redis: createRedis(p),
-        rabbitmq: createRabbitmq(p),
-        nats: createNats(p),
-        mysql: createMysql(p),
-        mongo: createMongo(p),
-        minio: createMinio(p),
-        storage: createStorage(p),
-    };
-}

package/dist/services/minio.d.ts

@@ -1,36 +0,0 @@
-import type { Secret, Service, Volume } from "../resource.js";
-import type { Primitives } from "./index.js";
-/** Configuration for a managed MinIO instance. */
-export interface MinioConfig {
-    /** MinIO image tag. @defaultValue `"latest"` */
-    version?: string;
-    /** Volume size hint (e.g. `"50GB"`). */
-    size?: string;
-}
-/** A named S3-compatible bucket on this MinIO instance. */
-export interface Bucket {
-    /** Bucket name. */
-    name: string;
-    /** Init service that creates the bucket on first deploy. */
-    service: Service;
-}
-/** A managed MinIO (S3-compatible) instance with its associated resources. */
-export interface Minio {
-    /** The underlying service running MinIO. */
-    service: Service;
-    /** Persistent volume for object storage data. */
-    volume: Volume;
-    /** Auto-generated root access key. */
-    accessKey: Secret;
-    /** Auto-generated root secret key. */
-    secretKey: Secret;
-    /** Internal hostname reachable by other services. */
-    host: string;
-    /** Port the MinIO API listens on (`9000`). */
-    port: number;
-    /** Full internal endpoint URL (e.g. `http://<host>:9000`). */
-    endpoint: string;
-    /** Create a bucket that is provisioned automatically on deploy. */
-    bucket: (name: string) => Bucket;
-}
-export declare function createMinio(p: Primitives): (id: string, config?: MinioConfig) => Minio;

package/dist/services/minio.js

@@ -1,53 +0,0 @@
-import { validateId } from "../resource.js";
-export function createMinio(p) {
-    return function minio(id, config = {}) {
-        validateId(id);
-        const version = config.version ?? "latest";
-        const accessKey = p.secret(`${id}-access-key`, { length: 16 });
-        const secretKey = p.secret(`${id}-secret-key`, { length: 32 });
-        const vol = p.volume(`${id}-data`, { size: config.size });
-        const svc = p.service(id, {
-            image: `minio/minio:${version}`,
-            port: 9000,
-            command: ["server", "/data"],
-            volumes: [{ volume: vol, mount: "/data" }],
-            env: {
-                MINIO_ROOT_USER: accessKey,
-                MINIO_ROOT_PASSWORD: secretKey,
-            },
-            healthCheck: {
-                command: ["mc", "ready", "local"],
-                interval: "5s",
-                timeout: "5s",
-                retries: 5,
-                startPeriod: "5s",
-            },
-        });
-        return {
-            service: svc,
-            volume: vol,
-            accessKey,
-            secretKey,
-            host: svc.host,
-            port: 9000,
-            endpoint: `http://${svc.host}:9000`,
-            bucket(name) {
-                const initSvc = p.service(`${id}-bucket-${name}`, {
-                    image: "minio/mc:latest",
-                    command: [
-                        "sh",
-                        "-c",
-                        `mc alias set minio http://${svc.host}:9000 $(cat $ACCESS_KEY_FILE) $(cat $SECRET_KEY_FILE) && mc mb --ignore-existing minio/${name}`,
-                    ],
-                    env: {
-                        ACCESS_KEY: accessKey,
-                        SECRET_KEY: secretKey,
-                    },
-                    dependsOn: [svc],
-                    restartPolicy: "none",
-                });
-                return { name, service: initSvc };
-            },
-        };
-    };
-}

package/dist/services/mongo.d.ts

@@ -1,28 +0,0 @@
-import type { Interpolation, Secret, Service, Volume } from "../resource.js";
-import type { Primitives } from "./index.js";
-import { type BackupConfig } from "./storage.js";
-/** Configuration for a managed MongoDB instance. */
-export interface MongoConfig {
-    /** Major MongoDB version. @defaultValue `8` */
-    version?: number;
-    /** Volume size hint (e.g. `"10GB"`). */
-    size?: string;
-    /** Backup configuration. */
-    backup?: BackupConfig;
-}
-/** A managed MongoDB instance with its associated resources. */
-export interface Mongo {
-    /** The underlying service running MongoDB. */
-    service: Service;
-    /** Persistent volume for MongoDB data. */
-    volume: Volume;
-    /** Auto-generated root password secret. */
-    password: Secret;
-    /** Internal hostname reachable by other services. */
-    host: string;
-    /** Port MongoDB listens on (`27017`). */
-    port: number;
-    /** Connection string with credentials injected at deploy time. */
-    url: Interpolation;
-}
-export declare function createMongo(p: Primitives): (id: string, config?: MongoConfig) => Mongo;

package/dist/services/mongo.js

@@ -1,45 +0,0 @@
-import { interpolate } from "../interpolate.js";
-import { validateId } from "../resource.js";
-import { createBackupSidecar } from "./storage.js";
-export function createMongo(p) {
-    return function mongo(id, config = {}) {
-        validateId(id);
-        const version = config.version ?? 8;
-        const password = p.secret(`${id}-password`, { length: 32 });
-        const vol = p.volume(`${id}-data`, { size: config.size });
-        const svc = p.service(id, {
-            image: `mongo:${version}`,
-            port: 27017,
-            volumes: [{ volume: vol, mount: "/data/db" }],
-            env: {
-                MONGO_INITDB_ROOT_USERNAME: "mongo",
-                MONGO_INITDB_ROOT_PASSWORD: password,
-            },
-            healthCheck: {
-                command: ["mongosh", "--eval", "db.runCommand('ping').ok", "--quiet"],
-                interval: "5s",
-                timeout: "5s",
-                retries: 5,
-                startPeriod: "10s",
-            },
-        });
-        if (config.backup) {
-            createBackupSidecar(p, {
-                id,
-                image: `mongo:${version}`,
-                svc,
-                backup: config.backup,
-                dumpScript: `TIMESTAMP=$(date +%Y%m%d-%H%M%S) && mongodump --uri="mongodb://mongo:$(cat $DB_PASSWORD_FILE)@${svc.host}:27017" --archive --gzip | mc pipe backup/${config.backup.storage.bucket}/${id}-$TIMESTAMP.gz`,
-                env: { DB_PASSWORD: password },
-            });
-        }
-        return {
-            service: svc,
-            volume: vol,
-            password,
-            host: svc.host,
-            port: 27017,
-            url: interpolate `mongodb://mongo:${password}@${svc.host}:27017`,
-        };
-    };
-}