@doubledigit/cli 0.1.0

package/dist/lib/marketplace-schema.js

@@ -0,0 +1,111 @@
+/**
+ * Zod schemas for marketplace manifests and known-marketplaces config.
+ *
+ * Two files:
+ *   1. marketplace.json — lives inside a marketplace repo at .doubledigit/marketplace.json
+ *   2. marketplaces.json — lives in the consuming project at .doubledigit/marketplaces.json
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Safe marketplace name (used as filesystem path segment + JSON key)
+// ---------------------------------------------------------------------------
+const MARKETPLACE_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+export const MarketplaceNameSchema = z
+    .string()
+    .min(1)
+    .regex(MARKETPLACE_NAME_RE, 'Marketplace name must start with an alphanumeric character and contain only [a-zA-Z0-9_-]');
+// ---------------------------------------------------------------------------
+// Extension source (where the code lives)
+// ---------------------------------------------------------------------------
+export const ExtensionSourceSchema = z.object({
+    /** Source type — currently only git-subdir is supported */
+    type: z.enum(['git-subdir', 'git-repo']).default('git-subdir'),
+    /** GitHub owner/repo (e.g. "digitaldouble/micro-apps") */
+    url: z.string().min(1),
+    /** Path within the repo (e.g. "packages/habit-tracker") */
+    path: z.string().optional(),
+    /** Git ref (branch, tag, SHA) */
+    ref: z.string().optional(),
+    /** Pinned commit SHA for reproducibility */
+    sha: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Single extension entry in a marketplace manifest
+// ---------------------------------------------------------------------------
+export const ExtensionKindSchema = z.enum(['micro-app', 'payload-plugin']);
+export const MarketplaceExtensionSchema = z.object({
+    /** Unique name within the marketplace */
+    name: z.string().min(1),
+    /** Extension kind */
+    kind: ExtensionKindSchema,
+    /** Human-readable description */
+    description: z.string().optional(),
+    /** Semver version string */
+    version: z.string().optional(),
+    /** Where the code lives */
+    source: ExtensionSourceSchema,
+    /** Whether marketplace or source is authoritative */
+    sourceAuthority: z.enum(['source', 'marketplace']).default('source'),
+    /** Verified by the marketplace maintainer */
+    verified: z.boolean().default(false),
+    /** Discovery tags */
+    tags: z.array(z.string()).default([]),
+    /** Author name or GitHub handle */
+    author: z.string().optional(),
+    /** Minimum platform version required */
+    minPlatformVersion: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// Marketplace manifest (.doubledigit/marketplace.json in a marketplace repo)
+// ---------------------------------------------------------------------------
+export const MarketplaceManifestSchema = z.object({
+    /** Marketplace display name (safe slug for filesystem use) */
+    name: MarketplaceNameSchema,
+    /** Marketplace owner info */
+    owner: z
+        .object({
+        name: z.string().min(1),
+        email: z.string().optional(),
+        url: z.string().optional(),
+    })
+        .optional(),
+    /** Marketplace metadata */
+    metadata: z
+        .object({
+        description: z.string().optional(),
+        version: z.string().optional(),
+        /** Root directory within the marketplace repo for extension dirs */
+        extensionRoot: z.string().optional(),
+    })
+        .optional(),
+    /** List of extensions in this marketplace */
+    extensions: z.array(MarketplaceExtensionSchema),
+});
+// ---------------------------------------------------------------------------
+// Known marketplaces file (.doubledigit/marketplaces.json in the project)
+// ---------------------------------------------------------------------------
+export const KnownMarketplaceEntrySchema = z.object({
+    /** GitHub source (owner/repo or full URL) */
+    source: z.string().min(1),
+    /** Path within the repo to .doubledigit/marketplace.json (defaults to root) */
+    manifestPath: z.string().default('.doubledigit/marketplace.json'),
+    /** Git ref to fetch from */
+    ref: z.string().optional(),
+    /** Last-fetched manifest cache */
+    cachedAt: z.string().optional(),
+    /** Number of extensions in the last fetch */
+    extensionCount: z.number().optional(),
+});
+export const KnownMarketplacesFileSchema = z.object({
+    version: z.literal(1).default(1),
+    marketplaces: z.record(MarketplaceNameSchema, KnownMarketplaceEntrySchema),
+});
+// ---------------------------------------------------------------------------
+// Marketplace catalog cache (.doubledigit/cache/<name>.json in the project)
+// ---------------------------------------------------------------------------
+export const CachedMarketplaceSchema = z.object({
+    /** When this cache was last updated */
+    fetchedAt: z.string(),
+    /** The marketplace manifest */
+    manifest: MarketplaceManifestSchema,
+});

package/dist/lib/marketplace.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Marketplace manager — fetch, cache, and query marketplace catalogs.
+ *
+ * Marketplaces are GitHub repos containing .doubledigit/marketplace.json.
+ * The consuming project tracks known marketplaces in .doubledigit/marketplaces.json
+ * and caches fetched catalogs in .doubledigit/cache/<name>.json.
+ */
+import { type KnownMarketplacesFile, type KnownMarketplaceEntry, type MarketplaceManifest, type CachedMarketplace, type MarketplaceExtension } from './marketplace-schema.js';
+/**
+ * Validate a marketplace name is a safe slug for filesystem and JSON key use.
+ * Throws a descriptive error if the name is invalid. Returns the name for chaining.
+ */
+export declare function assertValidMarketplaceName(name: string): string;
+export declare function getMarketplacesDir(root: string): string;
+export declare function getMarketplacesFilePath(root: string): string;
+export declare function getCacheDir(root: string): string;
+export declare function getCachePath(root: string, name: string): string;
+export declare function readKnownMarketplaces(root: string): KnownMarketplacesFile;
+export declare function writeKnownMarketplaces(root: string, data: KnownMarketplacesFile): void;
+export declare function addKnownMarketplace(root: string, name: string, entry: KnownMarketplaceEntry): void;
+export declare function removeKnownMarketplace(root: string, name: string): boolean;
+/**
+ * Fetch a marketplace manifest from a GitHub repo.
+ * Tries the GitHub raw content URL first.
+ */
+export declare function fetchMarketplaceManifest(source: string, manifestPath?: string, ref?: string): Promise<MarketplaceManifest>;
+export declare function readCachedMarketplace(root: string, name: string): CachedMarketplace | null;
+export declare function writeCachedMarketplace(root: string, name: string, manifest: MarketplaceManifest): void;
+export declare function updateMarketplace(root: string, name: string): Promise<MarketplaceManifest>;
+/**
+ * Get all extensions across all cached marketplaces.
+ */
+export declare function getAllCachedExtensions(root: string): Array<MarketplaceExtension & {
+    marketplace: string;
+}>;
+/**
+ * Resolve an extension name from a specific marketplace.
+ * Returns null if not found.
+ */
+export declare function resolveExtensionFromMarketplace(root: string, extensionName: string, marketplaceName: string): (MarketplaceExtension & {
+    marketplace: string;
+}) | null;
+/**
+ * Resolve an extension name across all known marketplaces.
+ * Returns first match (priority: verified first, then alphabetical marketplace order).
+ */
+export declare function resolveExtension(root: string, extensionName: string): (MarketplaceExtension & {
+    marketplace: string;
+}) | null;
+/**
+ * Convert a marketplace extension source to a `gh:owner/repo/path#ref` string
+ * compatible with the existing `dd add` pipeline.
+ *
+ * Prefers the pinned SHA over ref for reproducibility.
+ */
+export declare function extensionSourceToGhString(ext: MarketplaceExtension): string;
+//# sourceMappingURL=marketplace.d.ts.map

package/dist/lib/marketplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../src/lib/marketplace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAOjC;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS/D;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/D;AAMD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CA8BzE;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,GAC1B,IAAI,CAkBN;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,qBAAqB,GAC3B,IAAI,CAKN;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAe1E;AAMD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,YAAY,SAAkC,EAC9C,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAqE9B;AAMD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,IAAI,CAW1B;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mBAAmB,GAC5B,IAAI,CAeN;AAMD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAsB9B;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GACX,KAAK,CAAC,oBAAoB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAcvD;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,GACtB,CAAC,oBAAoB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAUzD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GACpB,CAAC,oBAAoB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAYzD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,oBAAoB,GACxB,MAAM,CAOR"}

package/dist/lib/marketplace.js

@@ -0,0 +1,270 @@
+/**
+ * Marketplace manager — fetch, cache, and query marketplace catalogs.
+ *
+ * Marketplaces are GitHub repos containing .doubledigit/marketplace.json.
+ * The consuming project tracks known marketplaces in .doubledigit/marketplaces.json
+ * and caches fetched catalogs in .doubledigit/cache/<name>.json.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { KnownMarketplacesFileSchema, MarketplaceManifestSchema, CachedMarketplaceSchema, MarketplaceNameSchema, } from './marketplace-schema.js';
+import { resolveGitHubToken } from './github-auth.js';
+// ---------------------------------------------------------------------------
+// Name validation helper
+// ---------------------------------------------------------------------------
+/**
+ * Validate a marketplace name is a safe slug for filesystem and JSON key use.
+ * Throws a descriptive error if the name is invalid. Returns the name for chaining.
+ */
+export function assertValidMarketplaceName(name) {
+    const result = MarketplaceNameSchema.safeParse(name);
+    if (!result.success) {
+        throw new Error(`Invalid marketplace name: "${name}"\n` +
+            'Marketplace names must start with an alphanumeric character and contain only letters, digits, hyphens, and underscores.');
+    }
+    return name;
+}
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+export function getMarketplacesDir(root) {
+    return path.join(root, '.doubledigit');
+}
+export function getMarketplacesFilePath(root) {
+    return path.join(getMarketplacesDir(root), 'marketplaces.json');
+}
+export function getCacheDir(root) {
+    return path.join(getMarketplacesDir(root), 'cache');
+}
+export function getCachePath(root, name) {
+    assertValidMarketplaceName(name);
+    return path.join(getCacheDir(root), `${name}.json`);
+}
+// ---------------------------------------------------------------------------
+// Known marketplaces CRUD
+// ---------------------------------------------------------------------------
+export function readKnownMarketplaces(root) {
+    const filePath = getMarketplacesFilePath(root);
+    if (!fs.existsSync(filePath)) {
+        return { version: 1, marketplaces: {} };
+    }
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch (err) {
+        const backupPath = filePath + '.bak';
+        fs.copyFileSync(filePath, backupPath);
+        throw new Error(`Marketplaces file is corrupted (backed up to ${backupPath}).\n` +
+            `Fix or delete ${filePath} and retry.\n` +
+            `Parse error: ${err instanceof Error ? err.message : err}`);
+    }
+    try {
+        return KnownMarketplacesFileSchema.parse(raw);
+    }
+    catch (err) {
+        const backupPath = filePath + '.bak';
+        fs.copyFileSync(filePath, backupPath);
+        throw new Error(`Marketplaces file has invalid schema (backed up to ${backupPath}).\n` +
+            `Fix or delete ${filePath} and retry.\n` +
+            `Validation error: ${err instanceof Error ? err.message : err}`);
+    }
+}
+export function writeKnownMarketplaces(root, data) {
+    const dir = getMarketplacesDir(root);
+    fs.mkdirSync(dir, { recursive: true });
+    const sorted = {
+        version: data.version,
+        marketplaces: Object.fromEntries(Object.entries(data.marketplaces).sort(([a], [b]) => a.localeCompare(b))),
+    };
+    fs.writeFileSync(getMarketplacesFilePath(root), JSON.stringify(sorted, null, 2) + '\n', 'utf-8');
+}
+export function addKnownMarketplace(root, name, entry) {
+    assertValidMarketplaceName(name);
+    const data = readKnownMarketplaces(root);
+    data.marketplaces[name] = entry;
+    writeKnownMarketplaces(root, data);
+}
+export function removeKnownMarketplace(root, name) {
+    assertValidMarketplaceName(name);
+    const data = readKnownMarketplaces(root);
+    if (!(name in data.marketplaces))
+        return false;
+    delete data.marketplaces[name];
+    writeKnownMarketplaces(root, data);
+    // Also remove cached catalog
+    const cachePath = getCachePath(root, name);
+    if (fs.existsSync(cachePath)) {
+        fs.rmSync(cachePath, { force: true });
+    }
+    return true;
+}
+// ---------------------------------------------------------------------------
+// Fetch marketplace manifest from GitHub
+// ---------------------------------------------------------------------------
+/**
+ * Fetch a marketplace manifest from a GitHub repo.
+ * Tries the GitHub raw content URL first.
+ */
+export async function fetchMarketplaceManifest(source, manifestPath = '.doubledigit/marketplace.json', ref) {
+    const token = resolveGitHubToken();
+    const headers = {
+        Accept: 'application/vnd.github.v3.raw',
+        'User-Agent': 'dd-cli',
+    };
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
+    // Parse source: "owner/repo" or full GitHub URL
+    let owner;
+    let repo;
+    let sourceRef;
+    if (source.includes('github.com')) {
+        const match = source.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\/tree\/(.+?))?\/?$/);
+        if (!match) {
+            throw new Error(`Invalid GitHub URL: ${source}\n` +
+                'Expected format: https://github.com/owner/repo or https://github.com/owner/repo/tree/ref');
+        }
+        owner = match[1];
+        repo = match[2].replace(/\.git$/, '');
+        sourceRef = match[3];
+    }
+    else {
+        const parts = source.split('/');
+        if (parts.length < 2) {
+            throw new Error(`Invalid marketplace source: "${source}"\n` +
+                'Expected format: owner/repo, https://github.com/owner/repo, or https://github.com/owner/repo/tree/ref');
+        }
+        owner = parts[0];
+        repo = parts[1];
+    }
+    const gitRef = ref || sourceRef || 'main';
+    const url = `https://raw.githubusercontent.com/${owner}/${repo}/${gitRef}/${manifestPath}`;
+    const res = await fetch(url, { headers });
+    if (res.status === 404) {
+        // Try 'master' branch as fallback
+        if (!ref && !sourceRef) {
+            const fallbackUrl = `https://raw.githubusercontent.com/${owner}/${repo}/master/${manifestPath}`;
+            const fallbackRes = await fetch(fallbackUrl, { headers });
+            if (fallbackRes.ok) {
+                const data = await fallbackRes.json();
+                return MarketplaceManifestSchema.parse(data);
+            }
+        }
+        throw new Error(`Marketplace manifest not found at ${owner}/${repo}/${manifestPath}\n` +
+            'Ensure the repo has a .doubledigit/marketplace.json file.');
+    }
+    if (!res.ok) {
+        throw new Error(`Failed to fetch marketplace manifest (${res.status}): ${url}`);
+    }
+    const data = await res.json();
+    return MarketplaceManifestSchema.parse(data);
+}
+// ---------------------------------------------------------------------------
+// Cache management
+// ---------------------------------------------------------------------------
+export function readCachedMarketplace(root, name) {
+    assertValidMarketplaceName(name);
+    const cachePath = getCachePath(root, name);
+    if (!fs.existsSync(cachePath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(cachePath, 'utf-8'));
+        return CachedMarketplaceSchema.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function writeCachedMarketplace(root, name, manifest) {
+    assertValidMarketplaceName(name);
+    const cacheDir = getCacheDir(root);
+    fs.mkdirSync(cacheDir, { recursive: true });
+    const cached = {
+        fetchedAt: new Date().toISOString(),
+        manifest,
+    };
+    fs.writeFileSync(getCachePath(root, name), JSON.stringify(cached, null, 2) + '\n', 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Update a single marketplace (fetch + cache + update known file)
+// ---------------------------------------------------------------------------
+export async function updateMarketplace(root, name) {
+    assertValidMarketplaceName(name);
+    const known = readKnownMarketplaces(root);
+    const entry = known.marketplaces[name];
+    if (!entry) {
+        throw new Error(`Marketplace "${name}" is not registered. Run: dd marketplace add`);
+    }
+    const manifest = await fetchMarketplaceManifest(entry.source, entry.manifestPath, entry.ref);
+    writeCachedMarketplace(root, name, manifest);
+    // Update metadata in known file
+    entry.cachedAt = new Date().toISOString();
+    entry.extensionCount = manifest.extensions.length;
+    writeKnownMarketplaces(root, known);
+    return manifest;
+}
+// ---------------------------------------------------------------------------
+// Query helpers
+// ---------------------------------------------------------------------------
+/**
+ * Get all extensions across all cached marketplaces.
+ */
+export function getAllCachedExtensions(root) {
+    const known = readKnownMarketplaces(root);
+    const results = [];
+    for (const [name] of Object.entries(known.marketplaces)) {
+        const cached = readCachedMarketplace(root, name);
+        if (!cached)
+            continue;
+        for (const ext of cached.manifest.extensions) {
+            results.push({ ...ext, marketplace: name });
+        }
+    }
+    return results;
+}
+/**
+ * Resolve an extension name from a specific marketplace.
+ * Returns null if not found.
+ */
+export function resolveExtensionFromMarketplace(root, extensionName, marketplaceName) {
+    const cached = readCachedMarketplace(root, marketplaceName);
+    if (!cached)
+        return null;
+    const ext = cached.manifest.extensions.find((e) => e.name === extensionName);
+    if (!ext)
+        return null;
+    return { ...ext, marketplace: marketplaceName };
+}
+/**
+ * Resolve an extension name across all known marketplaces.
+ * Returns first match (priority: verified first, then alphabetical marketplace order).
+ */
+export function resolveExtension(root, extensionName) {
+    const all = getAllCachedExtensions(root);
+    // Filter by name
+    const matches = all.filter((e) => e.name === extensionName);
+    if (matches.length === 0)
+        return null;
+    // Prefer verified
+    const verified = matches.find((e) => e.verified);
+    if (verified)
+        return verified;
+    return matches[0];
+}
+/**
+ * Convert a marketplace extension source to a `gh:owner/repo/path#ref` string
+ * compatible with the existing `dd add` pipeline.
+ *
+ * Prefers the pinned SHA over ref for reproducibility.
+ */
+export function extensionSourceToGhString(ext) {
+    const { source } = ext;
+    let ghString = `gh:${source.url}`;
+    if (source.path)
+        ghString += `/${source.path}`;
+    const refPart = source.sha ?? source.ref;
+    if (refPart)
+        ghString += `#${refPart}`;
+    return ghString;
+}

package/dist/lib/onboarding.d.ts

@@ -0,0 +1,84 @@
+import type { WorkspacePaths } from '../paths.js';
+export declare const DEFAULT_DATABASE_URL = "postgresql://doubledigit:doubledigit@localhost:5432/doubledigit";
+export declare const DEFAULT_APP_URL = "http://localhost:3000";
+export declare const DEFAULT_EMBEDDED_POSTGRES_PORT = 54329;
+export declare const DEFAULT_EMBEDDED_POSTGRES_INSTANCE_ID = "default";
+export declare const DEFAULT_EMBEDDED_POSTGRES_HOME: string;
+export declare const DEFAULT_EMBEDDED_POSTGRES_DATA_DIR: string;
+export interface CommandCaptureResult {
+    ok: boolean;
+    output: string;
+}
+export interface DatabaseInfo {
+    host: string;
+    port: number;
+    database: string;
+    username?: string;
+}
+export interface EnvSetupResult {
+    envPath: string;
+    created: boolean;
+    updatedKeys: string[];
+    env: Record<string, string>;
+}
+export interface EnvInspectionResult {
+    envPath: string;
+    exists: boolean;
+    env: Record<string, string>;
+}
+export type DatabaseMode = 'external' | 'embedded' | 'docker';
+export interface DatabaseRuntime {
+    mode: DatabaseMode;
+    databaseUrl: string;
+    source: string;
+    reachable: boolean;
+    embeddedDataDir?: string;
+    embeddedPort?: number;
+    dockerPort?: number;
+}
+export interface EnsureLocalEnvOptions {
+    databaseMode?: DatabaseMode;
+    databaseUrl?: string;
+    embeddedDataDir?: string;
+    embeddedPort?: number;
+    dockerPort?: number;
+}
+interface EnsureDatabaseOptions {
+    yes?: boolean;
+    allowDockerFallback?: boolean;
+}
+export interface DatabasePreference {
+    mode: DatabaseMode;
+    reason: string;
+    databaseUrl?: string;
+}
+export declare function getEnvPath(paths: WorkspacePaths): string;
+export declare function getEnvExamplePath(paths: WorkspacePaths): string;
+export declare function getGeneratedTypesPath(paths: WorkspacePaths): string;
+export declare function commandExists(command: string): boolean;
+export declare function dockerAvailable(): boolean;
+export declare function runChecked(command: string, args: string[], cwd: string, label: string, envOverrides?: Record<string, string>): void;
+export declare function captureCommand(command: string, args: string[], cwd: string, envOverrides?: Record<string, string>): CommandCaptureResult;
+export declare function readEnvFile(filePath: string): Record<string, string>;
+export declare function isPlaceholderValue(key: string, value: string | undefined): boolean;
+export declare function ensureLocalEnv(paths: WorkspacePaths, options?: EnsureLocalEnvOptions): EnvSetupResult;
+export declare function inspectLocalEnv(paths: WorkspacePaths): EnvInspectionResult;
+export declare function parseDatabaseUrl(databaseUrl: string): DatabaseInfo;
+export declare function checkDatabaseReachability(databaseUrl: string): Promise<boolean>;
+export declare function confirmYesNo(message: string): Promise<boolean>;
+export declare function waitForDockerDatabase(paths: WorkspacePaths, envOverrides?: Record<string, string>): Promise<boolean>;
+export declare function startDevServer(paths: WorkspacePaths, envOverrides?: Record<string, string>): Promise<void>;
+export declare function printNextSteps(): void;
+export declare function resolveDatabasePreference(env: Record<string, string>): DatabasePreference;
+export declare function probeEmbeddedPostgresSupport(): Promise<{
+    supported: boolean;
+    reason?: string;
+}>;
+export declare function ensureDatabaseReady(paths: WorkspacePaths, options?: EnsureDatabaseOptions): Promise<DatabaseRuntime>;
+export declare function localDependenciesInstalled(paths: WorkspacePaths): boolean;
+export declare function databaseRuntimeToEnvOptions(runtime: DatabaseRuntime): EnsureLocalEnvOptions;
+export declare function applyRuntimeDatabaseUrl(env: Record<string, string>, runtime: DatabaseRuntime): Record<string, string>;
+export declare function trimOutput(output: string, maxLines?: number): string;
+export declare function requiredEnvKeysMissing(env: Record<string, string>): string[];
+export {};
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/lib/onboarding.d.ts.map

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