@supacloud/cli 0.87.0 → 0.88.0

package/README.md

@@ -11,6 +11,22 @@ Registration accepts unknown boundary input, decodes it before invoking the
 typed callback, and validates the callback's result. Private `src/shared` imports
 are not supported.
 
+## Project Setup and Environment Profiles
+
+For an existing frontend, the shortest path is:
+
+```sh
+supacloud init
+cp .env.supacloud.test.example .env.supacloud.test
+supacloud env check
+supacloud --env test deploy
+```
+
+`init` creates `supacloud.json` and non-secret environment examples without
+overwriting an existing project configuration. `env list` and `env check` are
+local-only, redact credentials, and provide stable JSON with `--json` for CI or
+AI tooling. The real `.env.supacloud.*` files are added to `.gitignore`.
+
 ## Application Starter
 
 ```sh

package/dist/index.js

@@ -7797,7 +7797,7 @@ function FromObject10(context, type, value) {
     return value;
   const additionalProperties = GetAdditionalProperties(type);
   for (const key of Keys(value)) {
-    if (HasPropertyKey(type.properties, key)) {
+    if (HasPropertyKey(type.properties, key) && IsSchema(type.properties[key])) {
       value[key] = FromType19(context, type.properties[key], value[key]);
       continue;
     }
@@ -7882,6 +7882,9 @@ function FromProperties4(properties) {
     result[key] = FromType20(properties[key]);
   return result;
 }
+function FromRecordKey(type) {
+  return String2({ pattern: RecordPattern(type) });
+}
 function FromPriorityTypes(types) {
   return FromTypes6(Priority(types));
 }
@@ -7889,7 +7892,7 @@ function FromTypes6(types) {
   return types.map((type) => FromType20(type));
 }
 function FromType20(type) {
-  const next = IsArray2(type) ? _Array_(FromType20(type.items), ArrayOptions(type)) : IsIntersect(type) ? Intersect(FromTypes6(type.allOf)) : IsUnion(type) ? Union(FromPriorityTypes(type.anyOf)) : IsObject2(type) ? _Object_(FromProperties4(type.properties)) : IsRecord(type) ? Record(RecordKey(type), FromType20(RecordValue(type))) : IsTuple(type) ? Tuple(FromTypes6(type.items)) : type;
+  const next = IsArray2(type) ? _Array_(FromType20(type.items), ArrayOptions(type)) : IsIntersect(type) ? Intersect(FromTypes6(type.allOf)) : IsUnion(type) ? Union(FromPriorityTypes(type.anyOf)) : IsObject2(type) ? _Object_(FromProperties4(type.properties)) : IsRecord(type) ? Record(FromRecordKey(type), FromType20(RecordValue(type))) : IsTuple(type) ? Tuple(FromTypes6(type.items)) : type;
   return Modifiers(type, next);
 }
 function UnionPrioritySort(type) {
@@ -9257,6 +9260,8 @@ var ACTION_POLICY = {
     write: ["send", "receive", "ack", "release", "fail", "retry", "delete_message", "update_settings"]
   },
   ai: { local: ["show_skill", "install_skill"] },
+  init: { local: ["init"] },
+  env: { local: ["list", "check"] },
   app: {
     local: ["init", "generate", "dev", "watch", "verify-plan", "compile", "check", "graph", "explain", "export-tools", "context", "doctor", "fix", "plan", "build"],
     read: ["status", "logs", "transfer-plan", "promote-plan", "rollback-plan", "history", "deploy-plan", "diff", "promote-status", "preview-plan", "previews", "preview-list", "preview-status"],
@@ -21107,25 +21112,25 @@ var starter_metadata_default = {
   generatedBy: "supacloud/starter-metadata-v1",
   packages: {
     compiler: {
-      version: "0.44.0"
+      version: "0.44.1"
     },
     app: {
-      version: "0.26.0",
+      version: "0.26.1",
       dependencies: {
         rxjs: "7.8.2"
       }
     },
     elysia: {
-      version: "0.29.1"
+      version: "0.29.2"
     },
     commands: {
-      version: "0.9.1"
+      version: "0.9.2"
     },
     contracts: {
-      version: "0.8.0"
+      version: "0.8.1"
     },
     db: {
-      version: "0.16.0",
+      version: "0.16.1",
       peerDependencies: {
         "drizzle-orm": "1.0.0-rc.5-169397b"
       },
@@ -21134,7 +21139,7 @@ var starter_metadata_default = {
       }
     },
     sdk: {
-      version: "0.41.1",
+      version: "0.41.2",
       peerDependencies: {
         "@supabase/supabase-js": "^2.117.3"
       }
@@ -28887,10 +28892,320 @@ function registerRemoteDevTools(server, options = {}) {
     throw new Error("Unsupported remote dev action");
   });
 }
+
+// src/shared/tools/developer-experience-tools.ts
+import { existsSync as existsSync15 } from "node:fs";
+import { mkdir as mkdir7, readdir as readdir8, readFile as readFile7, writeFile as writeFile6 } from "node:fs/promises";
+import { dirname as dirname12, join as join19, resolve as resolve24 } from "node:path";
+var initToolSchema = {
+  root: optional(String2(), "Project directory to initialize (default: current directory)"),
+  json: optional(Boolean2(), "Emit one machine-readable JSON result")
+};
+var environmentToolSchema = {
+  action: withDescription(stringEnum(["list", "check"]), "Environment profile inspection action"),
+  root: optional(String2(), "Project directory containing .env.supacloud.* files"),
+  json: optional(Boolean2(), "Emit one machine-readable JSON result")
+};
+var TEST_PROFILE = [
+  "SUPACLOUD_ENV=test",
+  "SUPACLOUD_API_URL=https://management.test.example.com",
+  "SUPACLOUD_API_TOKEN=<test-management-api-token>",
+  "SUPACLOUD_PROJECT_REF=<test-project-ref>",
+  ""
+].join(`
+`);
+var PRODUCTION_PROFILE = [
+  "SUPACLOUD_ENV=production",
+  "SUPACLOUD_API_URL=https://management.example.com",
+  "SUPACLOUD_API_TOKEN=<production-management-api-token>",
+  "SUPACLOUD_PROJECT_REF=<production-project-ref>",
+  ""
+].join(`
+`);
+function textResult3(text, isError = false) {
+  return { isError, content: [{ type: "text", text }] };
+}
+function jsonResult(value, isError = false) {
+  return textResult3(JSON.stringify(value, null, 2), isError);
+}
+function record5(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function packageDependencies(manifest) {
+  return new Set([
+    ...Object.keys(manifest.dependencies ?? {}),
+    ...Object.keys(manifest.devDependencies ?? {})
+  ]);
+}
+function outputDirectoryFor(manifest) {
+  const dependencies = packageDependencies(manifest);
+  if (dependencies.has("next"))
+    return "out";
+  if (dependencies.has("@sveltejs/kit") || dependencies.has("svelte"))
+    return "build";
+  return "dist";
+}
+async function readPackageManifest(root) {
+  const path = join19(root, "package.json");
+  if (!existsSync15(path))
+    return {};
+  try {
+    const parsed = JSON.parse(await readFile7(path, "utf8"));
+    const value = record5(parsed);
+    if (!value)
+      throw new Error("package.json must contain an object");
+    const scripts = record5(value.scripts);
+    const dependencies = record5(value.dependencies);
+    const devDependencies = record5(value.devDependencies);
+    return {
+      scripts: scripts ?? undefined,
+      dependencies: dependencies ?? undefined,
+      devDependencies: devDependencies ?? undefined
+    };
+  } catch (error) {
+    throw new Error(`Invalid package.json: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+async function writeNewFile(path, content) {
+  try {
+    await writeFile6(path, content, { encoding: "utf8", flag: "wx", mode: 384 });
+    return true;
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "EEXIST")
+      return false;
+    throw error;
+  }
+}
+async function ensureGitignore(root) {
+  const path = join19(root, ".gitignore");
+  const existing = existsSync15(path) ? await readFile7(path, "utf8") : "";
+  const required = [".env.supacloud.*", "!.env.supacloud.*.example"];
+  const missing = required.filter((entry) => !existing.split(/\r?\n/).includes(entry));
+  if (missing.length === 0)
+    return false;
+  const prefix = existing.length > 0 && !existing.endsWith(`
+`) ? `${existing}
+` : existing;
+  await writeFile6(path, `${prefix}${missing.join(`
+`)}
+`, "utf8");
+  return true;
+}
+async function initializeProject(request, options) {
+  const root = resolve24(request.root || options.cwd || process.cwd());
+  await mkdir7(root, { recursive: true });
+  const configPath = join19(root, "supacloud.json");
+  if (existsSync15(configPath)) {
+    throw new Error(`supacloud.json already exists in ${root}; init never overwrites project configuration`);
+  }
+  const manifest = await readPackageManifest(root);
+  const hasBuildScript = typeof manifest.scripts?.build === "string" && Boolean(manifest.scripts.build.trim());
+  const outputDirectory = outputDirectoryFor(manifest);
+  const config = {
+    frontend: {
+      root: ".",
+      outputDirectory
+    }
+  };
+  const created = [];
+  try {
+    await writeFile6(configPath, `${JSON.stringify(config, null, 2)}
+`, {
+      encoding: "utf8",
+      flag: "wx",
+      mode: 420
+    });
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "EEXIST") {
+      throw new Error(`supacloud.json already exists in ${root}; init never overwrites project configuration`);
+    }
+    throw error;
+  }
+  created.push("supacloud.json");
+  if (await writeNewFile(join19(root, ".env.supacloud.test.example"), TEST_PROFILE)) {
+    created.push(".env.supacloud.test.example");
+  }
+  if (await writeNewFile(join19(root, ".env.supacloud.production.example"), PRODUCTION_PROFILE)) {
+    created.push(".env.supacloud.production.example");
+  }
+  if (await ensureGitignore(root))
+    created.push(".gitignore");
+  const result = {
+    schema: "supacloud.developer-experience.init.v1",
+    ok: true,
+    root,
+    created,
+    detected: {
+      package_json: existsSync15(join19(root, "package.json")),
+      build_script: hasBuildScript,
+      output_directory: outputDirectory
+    },
+    next: [
+      "cp .env.supacloud.test.example .env.supacloud.test",
+      "supacloud env check",
+      "supacloud --env test deploy"
+    ]
+  };
+  if (request.json === true)
+    return jsonResult(result);
+  return textResult3([
+    `Initialized SupaCloud deployment in ${root}.`,
+    `Created: ${created.join(", ")}.`,
+    hasBuildScript ? `Detected package.json build script; deploy output defaults to ${outputDirectory}.` : "No package.json build script detected; add one before deploying.",
+    "",
+    ...result.next
+  ].join(`
+`));
+}
+function profileNameFromFile(name) {
+  const match = name.match(/^\.env\.supacloud\.([A-Za-z0-9][A-Za-z0-9_-]{0,63})$/);
+  return match?.[1] ?? null;
+}
+async function environmentProfiles(root) {
+  const entries = await readdir8(root, { withFileTypes: true }).catch((error) => {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT")
+      return [];
+    throw error;
+  });
+  return entries.filter((entry) => entry.isFile()).map((entry) => {
+    const name = profileNameFromFile(entry.name);
+    return name ? { name, path: join19(root, entry.name), exists: true } : null;
+  }).filter((profile) => profile !== null).sort((left, right) => left.name.localeCompare(right.name));
+}
+function statusMissing(context) {
+  if (context.credentialScope === "management") {
+    return [
+      !context.apiUrl ? "SUPACLOUD_API_URL" : null,
+      !context.apiToken ? "SUPACLOUD_API_TOKEN" : null,
+      !context.projectRef ? "SUPACLOUD_PROJECT_REF" : null
+    ].filter((value) => value !== null);
+  }
+  if (context.credentialScope === "project_application") {
+    return [
+      !context.inferredSupabaseUrl ? "SUPABASE_URL" : null,
+      !context.inferredServiceRoleKey ? "SUPABASE_SERVICE_ROLE_KEY" : null,
+      !context.projectRef ? "SUPACLOUD_PROJECT_REF" : null
+    ].filter((value) => value !== null);
+  }
+  return ["SUPACLOUD_API_URL", "SUPACLOUD_API_TOKEN", "SUPACLOUD_PROJECT_REF"];
+}
+function deployMissing(context) {
+  const missing = statusMissing(context);
+  if (context.credentialScope !== "management") {
+    return [...missing, "Management API context"];
+  }
+  if (context.applicationId) {
+    if (!context.applicationEnvironmentId)
+      missing.push("SUPACLOUD_APPLICATION_ENVIRONMENT_ID");
+    if (!context.applicationConfigurationPath && !context.applicationConfigurationId) {
+      missing.push("SUPACLOUD_APPLICATION_CONFIGURATION_PATH or SUPACLOUD_APPLICATION_CONFIGURATION_ID");
+    }
+  }
+  return missing;
+}
+async function inspectProfile(profile) {
+  try {
+    const context = resolveSupaCloudContext({}, dirname12(profile.path), {
+      environmentName: profile.name
+    });
+    const status = statusMissing(context);
+    const deploy = deployMissing(context);
+    return {
+      name: profile.name,
+      path: profile.path,
+      environment: context.environment || null,
+      production: context.production,
+      source: "named_env_file",
+      credentialScope: context.credentialScope,
+      projectRef: context.projectRef || null,
+      statusReady: status.length === 0,
+      statusMissing: status,
+      deployReady: deploy.length === 0,
+      deployMissing: deploy,
+      hasApiToken: Boolean(context.apiToken),
+      hasServiceRoleKey: Boolean(context.inferredServiceRoleKey),
+      error: null
+    };
+  } catch (error) {
+    return {
+      name: profile.name,
+      path: profile.path,
+      environment: null,
+      production: false,
+      source: "invalid",
+      credentialScope: "incomplete",
+      projectRef: null,
+      statusReady: false,
+      statusMissing: [],
+      deployReady: false,
+      deployMissing: [],
+      hasApiToken: false,
+      hasServiceRoleKey: false,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function inspectEnvironment(request, options) {
+  const root = resolve24(request.root || options.cwd || process.cwd());
+  const profiles = await environmentProfiles(root);
+  if (request.action === "list") {
+    const active = options.activeContext?.environment || null;
+    const result = {
+      schema: "supacloud.developer-experience.environments.v1",
+      ok: true,
+      root,
+      active,
+      environments: profiles.map((profile) => ({
+        name: profile.name,
+        path: profile.path,
+        active: profile.name.toLowerCase() === active?.toLowerCase()
+      }))
+    };
+    if (request.json === true)
+      return jsonResult(result);
+    if (profiles.length === 0) {
+      return textResult3(`No .env.supacloud.<name> profiles found in ${root}.
+Run \`supacloud init\` to create safe examples.`);
+    }
+    return textResult3([
+      `Environment profiles in ${root}:`,
+      ...result.environments.map((profile) => `${profile.active ? "*" : " "} ${profile.name}  ${profile.path}`)
+    ].join(`
+`));
+  }
+  const reports = await Promise.all(profiles.map((profile) => inspectProfile(profile)));
+  const result = {
+    schema: "supacloud.developer-experience.environment-check.v1",
+    ok: reports.length > 0 && reports.every((report) => report.statusReady),
+    root,
+    active: options.activeContext?.environment || null,
+    environments: reports
+  };
+  if (request.json === true)
+    return jsonResult(result, !result.ok);
+  if (reports.length === 0) {
+    return textResult3(`No environment profiles found in ${root}.
+Run \`supacloud init\` and copy an example profile.`, true);
+  }
+  const lines = reports.map((report) => {
+    if (report.error)
+      return `FAIL ${report.name}: ${report.error}`;
+    const status = report.statusReady ? "OK" : `FAIL missing ${report.statusMissing.join(", ")}`;
+    const deploy = report.deployReady ? "deploy=ready" : `deploy=blocked(${report.deployMissing.join(", ")})`;
+    const ref = report.projectRef ? `project=${report.projectRef}` : "project=unknown";
+    return `${status}  ${report.name}  ${deploy}  ${ref}`;
+  });
+  return textResult3(lines.join(`
+`), !result.ok);
+}
+function registerDeveloperExperienceTools(server, options = {}) {
+  registerTool(server, "init", "Create SupaCloud deployment configuration and non-secret environment examples without overwriting project files.", initToolSchema, (request) => initializeProject(request, options));
+  registerTool(server, "env", "List or locally validate named SupaCloud environment profiles without contacting the platform or printing secrets.", environmentToolSchema, (request) => inspectEnvironment(request, options));
+}
 // package.json
 var package_default = {
   name: "@supacloud/cli",
-  version: "0.87.0",
+  version: "0.88.0",
   description: "Project-scoped CLI for SupaCloud users",
   type: "module",
   main: "./dist/index.js",
@@ -28942,14 +29257,14 @@ var package_default = {
     directory: "packages/cli"
   },
   dependencies: {
-    "@supacloud/compiler": "^0.44.0",
-    "@supacloud/delivery": "0.14.0",
-    "@supacloud/db": "0.16.0",
-    typebox: "1.3.34"
+    "@supacloud/compiler": "^0.44.1",
+    "@supacloud/delivery": "0.14.1",
+    "@supacloud/db": "0.16.1",
+    typebox: "1.3.36"
   },
   overrides: {
-    "@supacloud/contracts": "0.8.0",
-    "@supacloud/delivery": "0.14.0",
+    "@supacloud/contracts": "0.8.1",
+    "@supacloud/delivery": "0.14.1",
     "@graphql-tools/utils": "^12.0.3"
   },
   devDependencies: {
@@ -29125,6 +29440,8 @@ USAGE
 
   ${preferredCommand} [global flags] deploy [--flags]
   ${preferredCommand} [global flags] <module> <action> [--flags]
+  ${preferredCommand} init [--root <directory>]
+  ${preferredCommand} env <list|check> [--root <directory>]
   ${preferredCommand} [global flags] status
   ${preferredCommand} --help
   ${preferredCommand} --version
@@ -29157,6 +29474,9 @@ DEFAULT CONTEXT
 
 EXAMPLES
 
+  ${preferredCommand} init
+  ${preferredCommand} env check
+  ${preferredCommand} env check --json
   ${preferredCommand} status
   ${preferredCommand} deploy
   ${preferredCommand} --env test deploy
@@ -29316,6 +29636,10 @@ function createCliTools(context, confirmProduction) {
   })));
   Object.assign(tools, captureTools((server) => registerLiteCliTools(server)));
   Object.assign(tools, captureTools((server) => registerAiTools(server)));
+  Object.assign(tools, captureTools((server) => registerDeveloperExperienceTools(server, {
+    cwd: process.cwd(),
+    activeContext: context
+  })));
   Object.assign(tools, captureTools((server) => registerAppTools(server, { onDevProgress: writeDevProgress })));
   Object.assign(tools, captureTools((server) => registerAppAliases(server)));
   Object.assign(tools, captureTools((server) => registerDbGovernanceTools(server, {
@@ -29550,7 +29874,7 @@ async function main() {
     return;
   }
   const cliTools = createCliTools(context, globalOptions.confirmProduction);
-  if (args.length === 1 && !["ai", "supabase", "lite", "app", "db"].includes(args[0]) && cliTools[args[0]]) {
+  if (args.length === 1 && !["ai", "supabase", "lite", "app", "db", "env"].includes(args[0]) && cliTools[args[0]]) {
     if ("action" in cliTools[args[0]].schema) {
       if (context.credentialScope !== "management" || !context.apiUrl || !context.apiToken) {
         console.error(`This command requires Management API context. Run \`${preferredCommand} status\` to inspect current detection.`);

package/dist/shared/tools/developer-experience-tools.d.ts

@@ -0,0 +1,26 @@
+import { type ResolvedContext } from "../context";
+import type { ToolSchema } from "../schema";
+import { type ToolServer } from "../tool-server";
+export interface DeveloperExperienceOptions {
+    cwd?: string;
+    activeContext?: ResolvedContext;
+}
+interface PackageManifest {
+    scripts?: Record<string, unknown>;
+    dependencies?: Record<string, unknown>;
+    devDependencies?: Record<string, unknown>;
+}
+export declare const initToolSchema: ToolSchema;
+export declare const environmentToolSchema: ToolSchema;
+declare function outputDirectoryFor(manifest: PackageManifest): string;
+declare function profileNameFromFile(name: string): string | null;
+declare function statusMissing(context: ResolvedContext): string[];
+declare function deployMissing(context: ResolvedContext): string[];
+export declare function registerDeveloperExperienceTools(server: ToolServer, options?: DeveloperExperienceOptions): void;
+export declare const __internal: {
+    outputDirectoryFor: typeof outputDirectoryFor;
+    profileNameFromFile: typeof profileNameFromFile;
+    statusMissing: typeof statusMissing;
+    deployMissing: typeof deployMissing;
+};
+export {};

package/dist/shared/tools/developer-experience-tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/cli",
-  "version": "0.87.0",
+  "version": "0.88.0",
   "description": "Project-scoped CLI for SupaCloud users",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,14 +52,14 @@
     "directory": "packages/cli"
   },
   "dependencies": {
-    "@supacloud/compiler": "^0.44.0",
-    "@supacloud/delivery": "0.14.0",
-    "@supacloud/db": "0.16.0",
-    "typebox": "1.3.34"
+    "@supacloud/compiler": "^0.44.1",
+    "@supacloud/delivery": "0.14.1",
+    "@supacloud/db": "0.16.1",
+    "typebox": "1.3.36"
   },
   "overrides": {
-    "@supacloud/contracts": "0.8.0",
-    "@supacloud/delivery": "0.14.0",
+    "@supacloud/contracts": "0.8.1",
+    "@supacloud/delivery": "0.14.1",
     "@graphql-tools/utils": "^12.0.3"
   },
   "devDependencies": {