@askdb/studio 0.2.0-beta.28 → 0.2.0-beta.29

package/dist/setup.js

@@ -0,0 +1,373 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { basename, dirname, join, resolve, isAbsolute, relative } from "node:path";
+import { bootstrapAskDbEnv, discoverAskDbConfigPath, getAskDbRuntimeConfig } from "@askdb/config";
+/** Mirrors `AI_DEFAULTS` in `apps/cli/src/init.ts` — keep the two in sync. */
+const AI_DEFAULTS = {
+    openai: { keyEnv: "OPENAI_API_KEY", modelEnv: "OPENAI_MODEL" },
+    anthropic: { keyEnv: "ANTHROPIC_API_KEY", modelEnv: "ANTHROPIC_MODEL" },
+    google: { keyEnv: "GOOGLE_GENERATIVE_AI_API_KEY", modelEnv: "GOOGLE_GENERATIVE_AI_MODEL" },
+    azure: { keyEnv: "AZURE_OPENAI_API_KEY", modelEnv: "AZURE_OPENAI_DEPLOYMENT" },
+};
+const CONNECTION_ENV_DEFAULTS = {
+    postgres: "DATABASE_URL",
+    mysql: "MYSQL_URL",
+    sqlserver: "SQLSERVER_URL",
+};
+const ENV_NAME_PATTERN = /^[A-Z][A-Z0-9_]*$/;
+/** Live-introspection driver per engine — mirrors `DB_DRIVER_PACKAGES` in `apps/cli/src/init.ts`. */
+const DB_DRIVER_PACKAGES = {
+    postgres: "pg",
+    mysql: "mysql2",
+    sqlite: "better-sqlite3",
+    sqlserver: "mssql",
+};
+/**
+ * Write `askdb.config.ts` (and `.env.example`) into `cwd`. Accepts env var
+ * NAMES only — secret values never travel through this endpoint. Refuses to
+ * overwrite an existing config. Templates mirror `askdb init`'s output.
+ */
+export function writeSetupConfig(cwd, input) {
+    const existing = discoverAskDbConfigPath(cwd);
+    if (existing) {
+        throw new SetupError(409, `A config already exists at ${existing}. Edit it directly instead.`);
+    }
+    const schemaOut = validateRelativePath(input.schemaOut ?? "./askdb", "schemaOut");
+    const aiDefaults = AI_DEFAULTS[input.aiProvider];
+    if (!aiDefaults)
+        throw new SetupError(400, `Unknown AI provider: ${input.aiProvider}`);
+    const aiKeyEnv = validateEnvName(input.aiKeyEnv ?? aiDefaults.keyEnv, "aiKeyEnv");
+    const envVars = [
+        { name: aiKeyEnv, purpose: `${input.aiProvider} API key`, requiredForIntrospection: false },
+    ];
+    let introspectionSection;
+    switch (input.database) {
+        case "postgres":
+        case "mysql":
+        case "sqlserver": {
+            const connectionEnv = validateEnvName(input.connectionEnv ?? CONNECTION_ENV_DEFAULTS[input.database], "connectionEnv");
+            envVars.push({
+                name: connectionEnv,
+                purpose: `${input.database} connection URL (introspection only)`,
+                requiredForIntrospection: true,
+            });
+            introspectionSection = `  introspection: {
+    provider: "${input.database}",
+    providerConfig: {
+      ${input.database}: {
+        databaseUrl: env("${connectionEnv}"),
+      },
+    },
+    outputDir: "${schemaOut}",
+  },`;
+            break;
+        }
+        case "sqlite": {
+            const file = validateRelativePath(input.sqliteFile ?? "./data.db", "sqliteFile");
+            introspectionSection = `  introspection: {
+    provider: "sqlite",
+    providerConfig: {
+      sqlite: {
+        file: "${file}",
+      },
+    },
+    outputDir: "${schemaOut}",
+  },`;
+            break;
+        }
+        case "prisma": {
+            const schemaLine = input.prismaSchema
+                ? `\n        schemaPath: "${validateRelativePath(input.prismaSchema, "prismaSchema")}",`
+                : "";
+            introspectionSection = `  introspection: {
+    provider: "prisma",
+    providerConfig: {
+      prisma: {${schemaLine}
+      },
+    },
+    outputDir: "${schemaOut}",
+  },`;
+            break;
+        }
+        default:
+            throw new SetupError(400, `Unknown database: ${String(input.database)}`);
+    }
+    const config = `import { defineConfig, env, type AskDbConfig } from "@askdb/config";
+
+export default defineConfig({
+  ai: {
+    provider: "${input.aiProvider}",
+    providerConfig: {
+      ${input.aiProvider}: {
+        apiKey: env("${aiKeyEnv}"),
+      },
+    },
+  },
+${introspectionSection}
+  rag: {
+    embedder: "mock",
+    embedderConfig: {},
+    store: "file",
+    storeConfig: { file: {} },
+  },
+} satisfies AskDbConfig);
+`;
+    const configPath = join(cwd, "askdb.config.ts");
+    writeFileSync(configPath, config, "utf8");
+    let envExamplePath = join(cwd, ".env.example");
+    if (existsSync(envExamplePath)) {
+        envExamplePath = null; // don't clobber an existing example file
+    }
+    else {
+        const example = [
+            "# AskDB environment — copy to .env and fill in real values.",
+            "# .env is read by Studio, the CLI, and the HTTP API; never commit it.",
+            ...envVars.map((v) => `${v.name}= # ${v.purpose}`),
+            "",
+        ].join("\n");
+        writeFileSync(envExamplePath, example, "utf8");
+    }
+    // The config imports `@askdb/config`, so the project needs it (plus the
+    // live-introspection driver) installed — same as `askdb init` does.
+    const deps = ensureProjectDependencies(cwd, input.database);
+    // Install the runtime snapshot from the file we just wrote so the rest of
+    // the server (and the introspection step) sees the new config immediately.
+    // Skipped when dependencies are still missing — probeSetupState retries later.
+    if (!deps.manualInstallCommand) {
+        bootstrapAskDbEnv({ cwd });
+    }
+    return {
+        configPath,
+        envExamplePath,
+        envVars,
+        installed: deps.installed,
+        manualInstallCommand: deps.manualInstallCommand,
+        packageJsonCreated: deps.packageJsonCreated,
+    };
+}
+/**
+ * Make sure the project can load the config we just wrote: `@askdb/config` +
+ * `dotenv` must be resolvable from the project, and live engines need their
+ * introspection driver. Mirrors `askdb init`'s install plan. Falls back to a
+ * manual command when the project looks like a workspace root or the install
+ * fails — never mutates a monorepo root implicitly.
+ */
+function ensureProjectDependencies(cwd, database) {
+    const missing = [];
+    if (!canResolveFrom(cwd, "@askdb/config")) {
+        missing.push(`@askdb/config@${resolveConfigSpec()}`, `dotenv@${resolveDotenvSpec()}`);
+    }
+    const driver = DB_DRIVER_PACKAGES[database];
+    if (driver && !canResolveFrom(cwd, driver)) {
+        missing.push(driver);
+    }
+    if (missing.length === 0) {
+        return { installed: null, manualInstallCommand: null, packageJsonCreated: false };
+    }
+    let packageJsonCreated = false;
+    const nearestPkgDir = findNearestPackageJsonDir(cwd);
+    if (!nearestPkgDir) {
+        writeFileSync(join(cwd, "package.json"), `${JSON.stringify({ name: basename(cwd) || "askdb-project", private: true }, null, 2)}\n`, "utf8");
+        packageJsonCreated = true;
+    }
+    const pkgDir = nearestPkgDir ?? cwd;
+    const pm = detectPackageManager(pkgDir);
+    // Only auto-install when the project manifest sits exactly at the wizard's
+    // directory. A package.json found further up might be a monorepo root or an
+    // unrelated project — never mutate those implicitly.
+    if (pkgDir !== resolve(cwd) || (isLikelyWorkspaceRoot(pkgDir) && !packageJsonCreated)) {
+        return {
+            installed: null,
+            manualInstallCommand: formatInstallCommand(pm, missing),
+            packageJsonCreated,
+        };
+    }
+    const installer = setupInstallerForTests ?? runInstall;
+    const ok = installer(pm, pkgDir, missing);
+    if (!ok) {
+        return {
+            installed: null,
+            manualInstallCommand: formatInstallCommand(pm, missing),
+            packageJsonCreated,
+        };
+    }
+    return { installed: missing, manualInstallCommand: null, packageJsonCreated };
+}
+function canResolveFrom(dir, packageName) {
+    try {
+        // Resolve the package entry point, not `<pkg>/package.json` — the latter
+        // fails for packages whose `exports` map doesn't expose "./package.json".
+        createRequire(join(dir, "package.json")).resolve(packageName);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Locate the `package.json` of the `@askdb/config` copy Studio itself runs
+ * with. `require.resolve("@askdb/config/package.json")` fails because the
+ * package's `exports` map doesn't expose it — resolve the entry point and
+ * walk up instead.
+ */
+function readStudioConfigPackageJson() {
+    try {
+        const require = createRequire(import.meta.url);
+        const entry = require.resolve("@askdb/config");
+        const pkgDir = findNearestPackageJsonDir(dirname(entry));
+        if (!pkgDir)
+            return undefined;
+        return JSON.parse(readFileSync(join(pkgDir, "package.json"), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Pin `@askdb/config` to the version Studio itself was built against. */
+function resolveConfigSpec() {
+    return readStudioConfigPackageJson()?.version ?? "latest";
+}
+function resolveDotenvSpec() {
+    return readStudioConfigPackageJson()?.dependencies?.dotenv ?? "latest";
+}
+function findNearestPackageJsonDir(startDir) {
+    let dir = resolve(startDir);
+    for (let i = 0; i < 40; i += 1) {
+        if (existsSync(join(dir, "package.json")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+    return undefined;
+}
+function isLikelyWorkspaceRoot(packageDir) {
+    if (existsSync(join(packageDir, "pnpm-workspace.yaml")) ||
+        existsSync(join(packageDir, "pnpm-workspace.yml"))) {
+        return true;
+    }
+    try {
+        const pkg = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf8"));
+        return pkg.workspaces !== undefined && pkg.workspaces !== null;
+    }
+    catch {
+        return false;
+    }
+}
+let setupInstallerForTests;
+/** @internal Tests only — replaces the real package-manager install. */
+export function setSetupInstallerForTests(installer) {
+    setupInstallerForTests = installer;
+}
+function detectPackageManager(packageDir) {
+    let dir = packageDir;
+    for (let i = 0; i < 40; i += 1) {
+        if (existsSync(join(dir, "pnpm-lock.yaml")))
+            return "pnpm";
+        if (existsSync(join(dir, "bun.lockb")) || existsSync(join(dir, "bun.lock")))
+            return "bun";
+        if (existsSync(join(dir, "yarn.lock")))
+            return "yarn";
+        if (existsSync(join(dir, "package-lock.json")))
+            return "npm";
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return "npm";
+}
+function runInstall(pm, packageDir, packages) {
+    const env = { ...process.env, CI: process.env.CI ?? "true" };
+    const win = process.platform === "win32";
+    let cmd;
+    let args;
+    switch (pm) {
+        case "pnpm":
+            cmd = win ? "pnpm.CMD" : "pnpm";
+            args = ["add", ...packages];
+            break;
+        case "yarn":
+            cmd = win ? "yarn.cmd" : "yarn";
+            args = ["add", ...packages];
+            break;
+        case "bun":
+            cmd = win ? "bun.exe" : "bun";
+            args = ["add", ...packages];
+            break;
+        default:
+            cmd = win ? "npm.cmd" : "npm";
+            args = ["install", "--save", ...packages];
+    }
+    const result = spawnSync(cmd, args, { cwd: packageDir, stdio: "ignore", env, shell: false });
+    return result.status === 0;
+}
+function formatInstallCommand(pm, packages) {
+    const pkgList = packages.join(" ");
+    switch (pm) {
+        case "pnpm":
+            return `pnpm add ${pkgList}`;
+        case "yarn":
+            return `yarn add ${pkgList}`;
+        case "bun":
+            return `bun add ${pkgList}`;
+        default:
+            return `npm install --save ${pkgList}`;
+    }
+}
+/** Re-check the on-disk state (config file, schema artifact) for setup routing. */
+export function probeSetupState(cwd) {
+    const configPath = discoverAskDbConfigPath(cwd) ?? null;
+    if (!configPath) {
+        return { hasConfig: false, configPath: null, hasArtifact: false, outputDir: null, loadError: null };
+    }
+    try {
+        // Re-bootstrap so config/.env edits made since server start are honored.
+        bootstrapAskDbEnv({ cwd });
+        const outputDir = resolve(cwd, getAskDbRuntimeConfig().introspection.outputDir);
+        return {
+            hasConfig: true,
+            configPath,
+            hasArtifact: existsSync(join(outputDir, "schema.json")),
+            outputDir,
+            loadError: null,
+        };
+    }
+    catch (error) {
+        return {
+            hasConfig: true,
+            configPath,
+            hasArtifact: false,
+            outputDir: null,
+            loadError: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function validateEnvName(name, field) {
+    const trimmed = name.trim();
+    if (!ENV_NAME_PATTERN.test(trimmed)) {
+        throw new SetupError(400, `\`${field}\` must be an environment variable NAME like DATABASE_URL (got: ${JSON.stringify(name)}). Values belong in .env, not here.`);
+    }
+    return trimmed;
+}
+function validateRelativePath(path, field) {
+    const trimmed = path.trim();
+    if (trimmed === "" ||
+        isAbsolute(trimmed) ||
+        relative(".", trimmed).startsWith("..") ||
+        trimmed.includes("\0")) {
+        throw new SetupError(400, `\`${field}\` must be a relative path inside the project (got: ${JSON.stringify(path)}).`);
+    }
+    return trimmed;
+}
+export class SetupError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = "SetupError";
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/shared/api.d.ts

@@ -10,7 +10,11 @@ export type StudioTableDto = {
 };
 export type StudioWorkspaceDto = {
     schemaDir: string;
+    /** Schema artifact path relative to the project root — usable in integration snippets. */
+    schemaPathRelative: string;
     schemaId: string;
+    /** Resolved NL-to-SQL dialect: config `dialect` → artifact provider → `postgres`. */
+    dialect: string;
     warnings: SchemaV2Warning[];
     aiConfigured: boolean;
     model: string;
@@ -194,6 +198,59 @@ export type ExecuteRequest = {
     sql: string;
     params?: unknown[];
 };
+export type SetupReason = "no-config" | "no-artifact";
+export type SetupStatusDto = {
+    needed: boolean;
+    reason: SetupReason | null;
+    projectDir: string;
+    configPath: string | null;
+    outputDir: string | null;
+    /** Config exists but couldn't be loaded (e.g. project dependencies missing). */
+    configLoadError: string | null;
+};
+export type SetupConfigRequest = {
+    database: "postgres" | "mysql" | "sqlite" | "sqlserver" | "prisma";
+    /** Env var NAME for the connection URL — values never travel through this API. */
+    connectionEnv?: string;
+    sqliteFile?: string;
+    prismaSchema?: string;
+    aiProvider: "openai" | "anthropic" | "google" | "azure";
+    /** Env var NAME for the model API key — values never travel through this API. */
+    aiKeyEnv?: string;
+    schemaOut?: string;
+};
+export type SetupConfigResponse = {
+    configPath: string;
+    envExamplePath: string | null;
+    envVars: Array<{
+        name: string;
+        purpose: string;
+        requiredForIntrospection: boolean;
+    }>;
+    /** Packages the wizard installed into the project (null when nothing was needed). */
+    installed: string[] | null;
+    /** Set when automatic install wasn't possible — run this, then introspect. */
+    manualInstallCommand: string | null;
+    packageJsonCreated: boolean;
+    status: SetupStatusDto;
+};
+export type IntrospectionPlanDto = {
+    ok: true;
+    engine: string;
+    sourceLabel: string;
+} | {
+    ok: false;
+    engine: string | null;
+    error: string;
+};
+export type IntrospectRunResponse = {
+    ok: true;
+    engine: string;
+    schemaId: string;
+    tables: number;
+    warnings: string[];
+    workspace: StudioWorkspaceDto;
+};
 export type ExecuteResponse = {
     ok: true;
     columns: string[];

package/dist/shared/api.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askdb/studio",
-  "version": "0.2.0-beta.28",
+  "version": "0.2.0-beta.29",
   "description": "AskDB Studio: local browser UI for Schema v2 enrichment and sample NL-to-SQL checks.",
   "keywords": [
     "askdb",
@@ -47,19 +47,22 @@
     "react-dom": "^19.2.7",
     "react-router": "^7.17.0",
     "tailwind-merge": "^3.6.0",
+    "@askdb/ai-azure": "1.0.0-beta.3",
     "@askdb/ai": "0.1.0-beta.3",
     "@askdb/ai-anthropic": "1.0.0-beta.1",
-    "@askdb/ai-azure": "1.0.0-beta.3",
     "@askdb/ai-openai": "1.0.0-beta.3",
     "@askdb/ai-google": "1.0.0-beta.3",
-    "@askdb/config": "1.0.0-beta.9",
     "@askdb/core": "1.0.0-beta.26",
-    "@askdb/postgres": "0.2.0-beta.14",
+    "@askdb/config": "1.0.0-beta.9",
+    "@askdb/connectors": "0.1.0-beta.3",
     "@askdb/enrich": "0.2.0-beta.9",
+    "@askdb/introspect": "0.3.0-beta.12",
+    "@askdb/prisma": "0.2.0-beta.12",
+    "@askdb/mysql": "0.1.0-beta.13",
+    "@askdb/postgres": "0.2.0-beta.14",
     "@askdb/rag": "0.2.0-beta.18",
-    "@askdb/sqlite": "0.1.0-beta.13",
     "@askdb/sqlserver": "0.1.0-beta.14",
-    "@askdb/mysql": "0.1.0-beta.13"
+    "@askdb/sqlite": "0.1.0-beta.13"
   },
   "peerDependencies": {
     "better-sqlite3": ">=9",