@supatype/cli 0.1.0-alpha.6

package/dist/commands/keys.js

@@ -0,0 +1,57 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { signJwt } from "../jwt.js";
+export function registerKeys(program) {
+    program
+        .command("keys")
+        .description("Generate ANON_KEY and SERVICE_ROLE_KEY JWTs from your JWT_SECRET")
+        .option("--secret <secret>", "JWT secret (defaults to JWT_SECRET env var or value in .env)")
+        .option("--exp-years <years>", "Token expiry in years (default: 10)", "10")
+        .action((opts) => {
+        const secret = opts.secret ?? resolveSecret();
+        if (!secret) {
+            console.error("Error: JWT_SECRET not found. Set it in .env or pass --secret <value>");
+            process.exit(1);
+        }
+        const expYears = parseInt(opts.expYears, 10);
+        if (isNaN(expYears) || expYears < 1) {
+            console.error("Error: --exp-years must be a positive integer");
+            process.exit(1);
+        }
+        const now = Math.floor(Date.now() / 1000);
+        const exp = now + expYears * 365 * 24 * 60 * 60;
+        const anonKey = signJwt({ iss: "supatype", role: "anon", iat: now, exp }, secret);
+        const serviceKey = signJwt({ iss: "supatype", role: "service_role", iat: now, exp }, secret);
+        console.log("\nGenerated keys (valid for", expYears, "years):\n");
+        console.log("ANON_KEY=" + anonKey);
+        console.log("SERVICE_ROLE_KEY=" + serviceKey);
+        console.log("\nAdd these to your .env file. Do not commit .env to source control.");
+    });
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+export function resolveSecret() {
+    // 1. Check environment variable
+    const fromEnv = process.env["JWT_SECRET"];
+    if (fromEnv)
+        return fromEnv;
+    // 2. Parse .env file in cwd
+    const envPath = resolve(process.cwd(), ".env");
+    if (!existsSync(envPath))
+        return undefined;
+    try {
+        const contents = readFileSync(envPath, "utf8");
+        for (const line of contents.split("\n")) {
+            const trimmed = line.trim();
+            if (trimmed.startsWith("JWT_SECRET=")) {
+                const value = trimmed.slice("JWT_SECRET=".length).trim();
+                if (value && !value.startsWith("#"))
+                    return value;
+            }
+        }
+    }
+    catch {
+        // ignore read errors
+    }
+    return undefined;
+}
+//# sourceMappingURL=keys.js.map

package/dist/commands/keys.js.map

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

package/dist/commands/logs.d.ts

@@ -0,0 +1,6 @@
+/**
+ * supatype logs — tail aggregated logs from local Docker containers.
+ */
+import type { Command } from "commander";
+export declare function registerLogs(program: Command): void;
+//# sourceMappingURL=logs.d.ts.map

package/dist/commands/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKxC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiDnD"}

package/dist/commands/logs.js

@@ -0,0 +1,52 @@
+import { spawn } from "node:child_process";
+const SERVICES = ["postgres", "postgrest", "gotrue", "kong", "minio", "realtime", "studio"];
+export function registerLogs(program) {
+    program
+        .command("logs")
+        .description("Tail aggregated logs from local dev services")
+        .option("--service <name>", "Filter to a specific service")
+        .option("--since <duration>", "Show logs since duration (e.g., 5m, 1h)", "5m")
+        .option("-f, --follow", "Follow log output", true)
+        .action((opts) => {
+        const services = opts.service
+            ? [`supatype-${opts.service}`]
+            : SERVICES.map((s) => `supatype-${s}`);
+        if (opts.service && !SERVICES.includes(opts.service)) {
+            console.error(`Unknown service: ${opts.service}`);
+            console.error(`Available: ${SERVICES.join(", ")}`);
+            process.exit(1);
+        }
+        const args = ["compose", "logs"];
+        if (opts.follow)
+            args.push("-f");
+        if (opts.since)
+            args.push("--since", opts.since);
+        args.push("--tail", "100");
+        // If filtering by service, use docker logs for that container
+        if (opts.service) {
+            const containerArgs = ["logs"];
+            if (opts.follow)
+                containerArgs.push("-f");
+            if (opts.since)
+                containerArgs.push("--since", opts.since);
+            containerArgs.push("--tail", "100");
+            containerArgs.push(`supatype-${opts.service}`);
+            const child = spawn("docker", containerArgs, { stdio: "inherit" });
+            child.on("error", () => {
+                console.error("Docker not found. Ensure Docker is installed and running.");
+                process.exit(1);
+            });
+            return;
+        }
+        // Aggregated logs via docker compose
+        const child = spawn("docker", args, {
+            stdio: "inherit",
+            cwd: process.cwd(),
+        });
+        child.on("error", () => {
+            console.error("Docker not found. Ensure Docker is installed and running.");
+            process.exit(1);
+        });
+    });
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/logs.js.map

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

package/dist/commands/migrate.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerMigrate(program: Command): void;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/commands/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKxC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmEtD"}

package/dist/commands/migrate.js

@@ -0,0 +1,71 @@
+import { createInterface } from "node:readline";
+import { loadConfig } from "../config.js";
+import { ensureEngine, invokeEngine } from "../engine.js";
+export function registerMigrate(program) {
+    // migrate — apply all pending migrations
+    program
+        .command("migrate")
+        .description("Apply pending migrations from the migration history")
+        .option("--connection <url>", "Database connection URL (overrides config)")
+        .action(async (opts) => {
+        const config = loadConfig();
+        const connection = opts.connection ?? config.connection;
+        await ensureEngine();
+        const result = invokeEngine(["migrate", "--pending", "--connection", connection]);
+        if (result.exitCode !== 0) {
+            console.error(result.stderr || result.stdout);
+            process.exit(1);
+        }
+        console.log(result.stdout || "Migrations applied.");
+    });
+    // rollback — undo the last applied migration
+    program
+        .command("rollback")
+        .description("Roll back the last applied migration")
+        .option("--connection <url>", "Database connection URL (overrides config)")
+        .action(async (opts) => {
+        const config = loadConfig();
+        const connection = opts.connection ?? config.connection;
+        await ensureEngine();
+        const result = invokeEngine(["rollback", "--connection", connection]);
+        if (result.exitCode !== 0) {
+            console.error(result.stderr || result.stdout);
+            process.exit(1);
+        }
+        console.log(result.stdout || "Rolled back.");
+    });
+    // reset — drop all tables and re-apply from scratch
+    program
+        .command("reset")
+        .description("Drop all managed tables and re-apply the schema from scratch (destructive)")
+        .option("--yes", "Skip confirmation prompt")
+        .option("--connection <url>", "Database connection URL (overrides config)")
+        .action(async (opts) => {
+        if (!opts.yes) {
+            const confirmed = await confirm("This will DROP all managed tables and re-apply the schema. Proceed? [y/N] ");
+            if (!confirmed) {
+                console.log("Aborted.");
+                return;
+            }
+        }
+        const config = loadConfig();
+        const connection = opts.connection ?? config.connection;
+        await ensureEngine();
+        const result = invokeEngine(["reset", "--connection", connection]);
+        if (result.exitCode !== 0) {
+            console.error(result.stderr || result.stdout);
+            process.exit(1);
+        }
+        console.log(result.stdout || "Reset complete.");
+    });
+}
+async function confirm(prompt) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === "y");
+        });
+    });
+}
+//# sourceMappingURL=migrate.js.map

package/dist/commands/migrate.js.map

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

package/dist/commands/plugins.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerPlugins(program: Command): void;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/commands/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../src/commands/plugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOxC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgDtD"}

package/dist/commands/plugins.js

@@ -0,0 +1,431 @@
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from "node:fs";
+import { resolve, join } from "node:path";
+import { spawnSync } from "node:child_process";
+// ─── Registration ────────────────────────────────────────────────────────────
+export function registerPlugins(program) {
+    const cmd = program
+        .command("plugins")
+        .description("Manage Supatype plugins (field types, composites, providers, widgets)");
+    cmd
+        .command("list")
+        .description("Show all installed and active plugins")
+        .action(() => {
+        listPlugins(process.cwd());
+    });
+    cmd
+        .command("search <query>")
+        .description("Search npm registry for Supatype plugins")
+        .action(async (query) => {
+        await searchPlugins(query);
+    });
+    cmd
+        .command("add <package>")
+        .description("Install a plugin package and register it")
+        .action((pkg) => {
+        addPlugin(process.cwd(), pkg);
+    });
+    cmd
+        .command("remove <package>")
+        .description("Uninstall and deregister a plugin")
+        .action((pkg) => {
+        removePlugin(process.cwd(), pkg);
+    });
+    cmd
+        .command("create")
+        .description("Scaffold a new plugin project")
+        .option("--type <type>", "Plugin type: field, composite, provider, or widget", "field")
+        .option("--name <name>", "Plugin name")
+        .action((opts) => {
+        createPlugin(process.cwd(), opts);
+    });
+    cmd
+        .command("validate")
+        .description("Validate installed plugins for compatibility and correctness")
+        .action(() => {
+        validatePlugins(process.cwd());
+    });
+}
+// ─── List ────────────────────────────────────────────────────────────────────
+function listPlugins(cwd) {
+    const plugins = discoverInstalledPlugins(cwd);
+    if (plugins.length === 0) {
+        console.log("No Supatype plugins installed.");
+        console.log("\nSearch for plugins:  npx supatype plugins search <query>");
+        console.log("Create a plugin:    npx supatype plugins create");
+        return;
+    }
+    console.log("Installed plugins:\n");
+    console.log(`  ${"Name".padEnd(35)} ${"Type".padEnd(14)} ${"Version".padEnd(12)} Status`);
+    console.log(`  ${"─".repeat(35)} ${"─".repeat(14)} ${"─".repeat(12)} ${"─".repeat(15)}`);
+    for (const p of plugins) {
+        const types = p.supatype?.types?.join(", ") ?? "unknown";
+        const status = p.compatible ? "active" : "incompatible";
+        console.log(`  ${p.name.padEnd(35)} ${types.padEnd(14)} ${p.version.padEnd(12)} ${status}`);
+    }
+}
+// ─── Search ──────────────────────────────────────────────────────────────────
+async function searchPlugins(query) {
+    console.log(`Searching npm for "${query}" supatype plugins...\n`);
+    try {
+        const searchUrl = `https://registry.npmjs.org/-/v1/search?text=supatype-plugin+${encodeURIComponent(query)}&size=20`;
+        const res = await fetch(searchUrl, {
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok) {
+            console.error(`Search failed: ${res.statusText}`);
+            return;
+        }
+        const data = await res.json();
+        if (data.objects.length === 0) {
+            console.log("No plugins found.");
+            console.log("\nTry a different search term, or create your own plugin:");
+            console.log("  npx supatype plugins create");
+            return;
+        }
+        console.log(`  ${"Package".padEnd(40)} ${"Version".padEnd(12)} Description`);
+        console.log(`  ${"─".repeat(40)} ${"─".repeat(12)} ${"─".repeat(40)}`);
+        for (const obj of data.objects) {
+            const pkg = obj.package;
+            const desc = (pkg.description ?? "").slice(0, 50);
+            console.log(`  ${pkg.name.padEnd(40)} ${pkg.version.padEnd(12)} ${desc}`);
+        }
+        console.log(`\nInstall: npx supatype plugins add <package-name>`);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : "unknown"}`);
+    }
+}
+// ─── Add ─────────────────────────────────────────────────────────────────────
+function addPlugin(cwd, pkg) {
+    console.log(`Installing ${pkg}...`);
+    // Detect package manager
+    const pm = detectPackageManager(cwd);
+    const installCmd = pm === "pnpm" ? ["pnpm", "add", pkg]
+        : pm === "yarn" ? ["yarn", "add", pkg]
+            : ["npm", "install", pkg];
+    const result = spawnSync(installCmd[0], installCmd.slice(1), {
+        stdio: "inherit",
+        cwd,
+    });
+    if (result.status !== 0) {
+        console.error(`Failed to install ${pkg}`);
+        process.exit(1);
+    }
+    // Check compatibility
+    const pluginPkgPath = resolvePackageJson(cwd, pkg);
+    if (pluginPkgPath) {
+        const pkgJson = JSON.parse(readFileSync(pluginPkgPath, "utf8"));
+        const supatype = pkgJson["supatype"];
+        if (supatype?.["pluginApi"] !== undefined) {
+            const pluginApi = supatype["pluginApi"];
+            if (pluginApi !== 1) {
+                console.warn(`\nWarning: ${pkg} targets plugin API v${pluginApi}, current is v1.`);
+                console.warn("The plugin may not work correctly.");
+            }
+        }
+    }
+    console.log(`\n${pkg} installed and registered.`);
+    console.log("Run 'npx supatype plugins list' to see active plugins.");
+}
+// ─── Remove ──────────────────────────────────────────────────────────────────
+function removePlugin(cwd, pkg) {
+    // Check if the plugin is referenced in the schema
+    // This is a best-effort check
+    const schemaFiles = findSchemaFiles(cwd);
+    for (const file of schemaFiles) {
+        const content = readFileSync(file, "utf8");
+        if (content.includes(pkg)) {
+            console.warn(`Warning: ${pkg} appears to be referenced in ${file}`);
+            console.warn("Removing it may break your schema. Proceed with caution.\n");
+        }
+    }
+    console.log(`Removing ${pkg}...`);
+    const pm = detectPackageManager(cwd);
+    const removeCmd = pm === "pnpm" ? ["pnpm", "remove", pkg]
+        : pm === "yarn" ? ["yarn", "remove", pkg]
+            : ["npm", "uninstall", pkg];
+    const result = spawnSync(removeCmd[0], removeCmd.slice(1), {
+        stdio: "inherit",
+        cwd,
+    });
+    if (result.status !== 0) {
+        console.error(`Failed to remove ${pkg}`);
+        process.exit(1);
+    }
+    console.log(`${pkg} removed.`);
+}
+// ─── Create ──────────────────────────────────────────────────────────────────
+function createPlugin(cwd, opts) {
+    const validTypes = ["field", "composite", "provider", "widget"];
+    if (!validTypes.includes(opts.type)) {
+        console.error(`Invalid plugin type "${opts.type}". Must be one of: ${validTypes.join(", ")}`);
+        process.exit(1);
+    }
+    const name = opts.name ?? `supatype-plugin-my-${opts.type}`;
+    const pluginDir = resolve(cwd, name);
+    if (existsSync(pluginDir)) {
+        console.error(`Directory "${name}" already exists.`);
+        process.exit(1);
+    }
+    mkdirSync(pluginDir, { recursive: true });
+    mkdirSync(join(pluginDir, "src"), { recursive: true });
+    // package.json
+    writeFileSync(join(pluginDir, "package.json"), JSON.stringify({
+        name,
+        version: "0.1.0",
+        description: `Supatype ${opts.type} plugin`,
+        type: "module",
+        main: "./dist/index.js",
+        types: "./dist/index.d.ts",
+        exports: {
+            ".": {
+                import: "./dist/index.js",
+                types: "./dist/index.d.ts",
+            },
+        },
+        keywords: ["supatype", "supatype-plugin"],
+        supatype: {
+            pluginApi: 1,
+            types: [opts.type],
+        },
+        scripts: {
+            build: "tsc",
+            typecheck: "tsc --noEmit",
+        },
+        dependencies: {
+            "@supatype/plugin-sdk": "^0.1.0",
+        },
+        devDependencies: {
+            typescript: "^5",
+        },
+    }, null, 2) + "\n", "utf8");
+    // tsconfig.json
+    writeFileSync(join(pluginDir, "tsconfig.json"), JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            module: "Node16",
+            moduleResolution: "Node16",
+            outDir: "dist",
+            rootDir: "src",
+            declaration: true,
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+        },
+        include: ["src"],
+    }, null, 2) + "\n", "utf8");
+    // Source file based on type
+    const sourceContent = generatePluginTemplate(opts.type, name);
+    writeFileSync(join(pluginDir, "src/index.ts"), sourceContent, "utf8");
+    console.log(`\nCreated plugin project: ${name}/\n`);
+    console.log("  Files:");
+    console.log(`    ${name}/package.json`);
+    console.log(`    ${name}/tsconfig.json`);
+    console.log(`    ${name}/src/index.ts`);
+    console.log(`\n  Next steps:`);
+    console.log(`    cd ${name}`);
+    console.log(`    npm install`);
+    console.log(`    npm run build`);
+    console.log(`    npx supatype plugins validate`);
+}
+function generatePluginTemplate(type, name) {
+    switch (type) {
+        case "field":
+            return `import { defineFieldType } from "@supatype/plugin-sdk"
+
+export default defineFieldType({
+  name: "${name.replace(/.*plugin-/, "")}",
+  pgType: "TEXT",
+  tsType: "string",
+
+  validate(value) {
+    if (typeof value !== "string") return "Must be a string"
+    return null
+  },
+
+  serialise(value: string) {
+    return value
+  },
+
+  deserialise(raw) {
+    return String(raw)
+  },
+
+  filterOperators: ["eq", "neq", "in", "like"],
+  // widgetPath: "./src/Widget.tsx",
+})
+`;
+        case "composite":
+            return `import { defineComposite } from "@supatype/plugin-sdk"
+
+export default defineComposite({
+  name: "${name.replace(/.*plugin-/, "")}",
+  label: "${name.replace(/.*plugin-/, "").replace(/-/g, " ").replace(/\b\w/g, l => l.toUpperCase())}",
+  fields: [
+    { name: "example_field", type: "text", required: false },
+  ],
+  adminGroup: {
+    collapsible: true,
+    defaultCollapsed: false,
+  },
+})
+`;
+        case "provider":
+            return `import { defineProvider, type EmailProvider } from "@supatype/plugin-sdk"
+
+interface MyProviderConfig {
+  apiKey: string
+  region?: string
+}
+
+export default defineProvider<MyProviderConfig>({
+  name: "${name.replace(/.*plugin-/, "")}",
+  category: "email",
+  label: "${name.replace(/.*plugin-/, "").replace(/-/g, " ").replace(/\b\w/g, l => l.toUpperCase())}",
+  configSchema: {
+    apiKey: { type: "string", label: "API Key", required: true, secret: true },
+    region: { type: "select", label: "Region", options: ["us-east-1", "eu-west-1"] },
+  },
+  create(config): EmailProvider {
+    return {
+      async send(params) {
+        // Implement email sending using config.apiKey
+        console.log("Sending email to", params.to)
+        return { messageId: "msg_" + Date.now() }
+      },
+    }
+  },
+})
+`;
+        case "widget":
+            return `import { defineWidget } from "@supatype/plugin-sdk"
+
+export default defineWidget({
+  name: "${name.replace(/.*plugin-/, "")}",
+  label: "${name.replace(/.*plugin-/, "").replace(/-/g, " ").replace(/\b\w/g, l => l.toUpperCase())}",
+  compatibleTypes: ["text", "varchar"],
+  componentPath: "./src/Widget.tsx",
+})
+`;
+        default:
+            return `// Unknown plugin type: ${type}\n`;
+    }
+}
+// ─── Validate ────────────────────────────────────────────────────────────────
+function validatePlugins(cwd) {
+    const plugins = discoverInstalledPlugins(cwd);
+    if (plugins.length === 0) {
+        console.log("No plugins to validate.");
+        return;
+    }
+    let hasErrors = false;
+    for (const p of plugins) {
+        const issues = [];
+        if (!p.supatype) {
+            issues.push("Missing 'supatype' field in package.json");
+        }
+        else {
+            if (!p.supatype.pluginApi) {
+                issues.push("Missing supatype.pluginApi version");
+            }
+            else if (p.supatype.pluginApi !== 1) {
+                issues.push(`Targets plugin API v${p.supatype.pluginApi}, current is v1`);
+            }
+            if (!p.supatype.types || p.supatype.types.length === 0) {
+                issues.push("Missing supatype.types array");
+            }
+        }
+        if (issues.length === 0) {
+            console.log(`  ✓ ${p.name} — valid`);
+        }
+        else {
+            hasErrors = true;
+            console.log(`  ✗ ${p.name}`);
+            for (const issue of issues) {
+                console.log(`    - ${issue}`);
+            }
+        }
+    }
+    if (hasErrors) {
+        console.log("\nSome plugins have issues. Fix them before deploying.");
+        process.exit(1);
+    }
+    else {
+        console.log("\nAll plugins are valid.");
+    }
+}
+function discoverInstalledPlugins(cwd) {
+    const nodeModulesDir = resolve(cwd, "node_modules");
+    if (!existsSync(nodeModulesDir))
+        return [];
+    const plugins = [];
+    // Read package.json to find dependencies
+    const pkgJsonPath = resolve(cwd, "package.json");
+    if (!existsSync(pkgJsonPath))
+        return [];
+    const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+    const deps = {
+        ...pkgJson["dependencies"],
+        ...pkgJson["devDependencies"],
+    };
+    for (const depName of Object.keys(deps)) {
+        const depPkgPath = resolvePackageJson(cwd, depName);
+        if (!depPkgPath)
+            continue;
+        try {
+            const depPkg = JSON.parse(readFileSync(depPkgPath, "utf8"));
+            // Check if it's a Supatype plugin
+            const keywords = depPkg["keywords"] ?? [];
+            const supatype = depPkg["supatype"];
+            if (keywords.includes("supatype-plugin") || supatype) {
+                plugins.push({
+                    name: depName,
+                    version: depPkg["version"] ?? "unknown",
+                    supatype: supatype ? {
+                        pluginApi: supatype["pluginApi"],
+                        types: supatype["types"],
+                    } : undefined,
+                    compatible: !supatype?.["pluginApi"] || supatype["pluginApi"] === 1,
+                });
+            }
+        }
+        catch {
+            // Skip packages we can't read
+        }
+    }
+    return plugins;
+}
+function resolvePackageJson(cwd, packageName) {
+    // Handle scoped packages
+    const parts = packageName.startsWith("@") ? packageName.split("/") : [packageName];
+    const pkgPath = resolve(cwd, "node_modules", ...parts, "package.json");
+    return existsSync(pkgPath) ? pkgPath : null;
+}
+function detectPackageManager(cwd) {
+    if (existsSync(resolve(cwd, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(resolve(cwd, "yarn.lock")))
+        return "yarn";
+    return "npm";
+}
+function findSchemaFiles(cwd) {
+    const schemaDir = resolve(cwd, "supatype/schema");
+    if (!existsSync(schemaDir))
+        return [];
+    const files = [];
+    try {
+        const { readdirSync, statSync } = require("node:fs");
+        const entries = readdirSync(schemaDir);
+        for (const entry of entries) {
+            const fullPath = join(schemaDir, entry);
+            if (statSync(fullPath).isFile() && entry.endsWith(".ts")) {
+                files.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return files;
+}
+//# sourceMappingURL=plugins.js.map