@barekey/cli 0.3.2 → 0.4.0

package/bun.lock

@@ -5,7 +5,7 @@
     "": {
       "name": "@barekey/cli",
       "dependencies": {
-        "@barekey/sdk": "^0.3.1",
+        "@barekey/sdk": "^0.5.0",
         "@clack/prompts": "^0.11.0",
         "commander": "^14.0.1",
         "open": "^10.2.0",
@@ -18,7 +18,7 @@
     },
   },
   "packages": {
-    "@barekey/sdk": ["@barekey/sdk@0.3.1", "", {}, "sha512-IrVFvOzHYr/PVcW4VTJtbB05X9alQadrYNntQx3Uy3KUNs6IEI6CndV/roeT2A9nS7FxaHjfpOEBkEULpALPiA=="],
+    "@barekey/sdk": ["@barekey/sdk@0.5.0", "", {}, "sha512-+8RoKix9DZee3ZheGP5wJLnet6XaEGHTfcJOuvtJLmfQKRBllUy+wevsvELi1wOjw42pWaG3DYyb68XHznZRQw=="],
 
     "@clack/core": ["@clack/core@0.5.0", "", { "dependencies": { "picocolors": "^1.0.0", "sisteransi": "^1.0.5" } }, "sha512-p3y0FIOwaYRUPRcMO7+dlmLh8PSRcrjuTndsiA0WAFbWES0mLZlrjVoBRZ9DzkPFJZG6KGkJmoEAY0ZcVWTkow=="],
 

package/dist/command-utils.d.ts

@@ -13,7 +13,7 @@ export type EnvTargetOptions = {
 export declare function toJsonOutput(enabled: boolean, value: unknown): void;
 export declare function resolveBaseUrl(explicit: string | undefined): Promise<string>;
 export declare function requireLocalSession(): Promise<LocalSession>;
-export declare function resolveTarget(options: EnvTargetOptions, local: LocalSession): Promise<{
+export declare function resolveTarget(options: EnvTargetOptions, local?: LocalSession | null): Promise<{
     projectSlug: string;
     stageSlug: string;
     orgSlug?: string;

package/dist/command-utils.js

@@ -39,10 +39,11 @@ export async function requireLocalSession() {
 }
 export async function resolveTarget(options, local) {
     const runtime = await loadRuntimeConfig();
+    const isStandalone = runtime?.config.config?.mode === "standalone";
     const projectSlug = options.project?.trim() || runtime?.config.project || "";
     const stageSlug = options.stage?.trim() || runtime?.config.environment || "";
-    const orgSlug = options.org?.trim() || runtime?.config.org || local.credentials.orgSlug;
-    if (projectSlug.length === 0 || stageSlug.length === 0) {
+    const orgSlug = options.org?.trim() || runtime?.config.org || local?.credentials.orgSlug || "";
+    if (!isStandalone && (projectSlug.length === 0 || stageSlug.length === 0)) {
         const hint = runtime
             ? `Found ${runtime.path} but project/environment is incomplete.`
             : "No barekey.json found in current directory tree.";

package/dist/commands/env.js

@@ -5,8 +5,32 @@ import pc from "picocolors";
 import { createCliAuthProvider } from "../auth-provider.js";
 import { addTargetOptions, dotenvEscape, parseChance, requireLocalSession, resolveTarget, toJsonOutput, } from "../command-utils.js";
 import { postJson } from "../http.js";
+import { loadRuntimeConfig } from "../runtime-config.js";
 import { collectOptionValues, parseRolloutFunction, parseRolloutMilestones, parseVisibility, } from "./env-helpers.js";
 function createEnvClient(input) {
+    if (input.runtimeConfig !== null) {
+        const organization = input.organization?.trim();
+        const isStandalone = input.runtimeConfig.config.config?.mode === "standalone";
+        if (!organization && !isStandalone) {
+            throw new Error("Organization slug is required.");
+        }
+        const jsonConfig = {
+            ...(organization ? { organization } : {}),
+            ...(input.project.trim().length > 0 ? { project: input.project } : {}),
+            ...(input.environment.trim().length > 0 ? { environment: input.environment } : {}),
+            ...(input.runtimeConfig.config.config === undefined
+                ? {}
+                : {
+                    config: {
+                        typegen: input.runtimeConfig.config.config.typegen,
+                        mode: input.runtimeConfig.config.config.mode,
+                    },
+                }),
+        };
+        return new BarekeyClient({
+            json: jsonConfig,
+        });
+    }
     const organization = input.organization?.trim();
     if (!organization) {
         throw new Error("Organization slug is required.");
@@ -18,12 +42,14 @@ function createEnvClient(input) {
     });
 }
 async function runEnvGet(name, options) {
-    const local = await requireLocalSession();
+    const runtime = await loadRuntimeConfig();
+    const local = runtime?.config.config?.mode === "standalone" ? null : await requireLocalSession();
     const target = await resolveTarget(options, local);
     const client = createEnvClient({
-        organization: target.orgSlug ?? local.credentials.orgSlug,
+        organization: target.orgSlug ?? local?.credentials.orgSlug,
         project: target.projectSlug,
         environment: target.stageSlug,
+        runtimeConfig: runtime,
     });
     const value = await client.get(name, {
         seed: options.seed,
@@ -39,12 +65,14 @@ async function runEnvGet(name, options) {
     console.log(String(value));
 }
 async function runEnvGetMany(options) {
-    const local = await requireLocalSession();
+    const runtime = await loadRuntimeConfig();
+    const local = runtime?.config.config?.mode === "standalone" ? null : await requireLocalSession();
     const target = await resolveTarget(options, local);
     const client = createEnvClient({
-        organization: target.orgSlug ?? local.credentials.orgSlug,
+        organization: target.orgSlug ?? local?.credentials.orgSlug,
         project: target.projectSlug,
         environment: target.stageSlug,
+        runtimeConfig: runtime,
     });
     const names = options.names
         .split(",")

package/dist/commands/typegen.js

@@ -1,6 +1,7 @@
 import { BarekeyClient } from "@barekey/sdk/server";
 import pc from "picocolors";
 import { addTargetOptions, requireLocalSession, resolveTarget, } from "../command-utils.js";
+import { loadRuntimeConfig } from "../runtime-config.js";
 const DEFAULT_TYPEGEN_WATCH_INTERVAL_MS = 5_000;
 export function formatTypegenResultMessage(result) {
     const title = result.written
@@ -39,22 +40,35 @@ function sleep(milliseconds) {
     });
 }
 async function resolveTypegenClient(options) {
-    const local = await requireLocalSession();
+    const runtime = await loadRuntimeConfig();
+    const local = runtime?.config.config?.mode === "standalone" ? null : await requireLocalSession();
     const target = await resolveTarget(options, local);
-    const organization = target.orgSlug ?? local.credentials.orgSlug;
-    if (!organization || organization.trim().length === 0) {
+    const isStandalone = runtime?.config.config?.mode === "standalone";
+    const organization = target.orgSlug ?? local?.credentials.orgSlug;
+    if ((!organization || organization.trim().length === 0) && !isStandalone) {
         throw new Error("Organization slug is required.");
     }
+    const jsonConfig = {
+        ...(organization && organization.trim().length > 0 ? { organization } : {}),
+        ...(target.projectSlug.trim().length > 0 ? { project: target.projectSlug } : {}),
+        ...(target.stageSlug.trim().length > 0 ? { environment: target.stageSlug } : {}),
+        ...(runtime?.config.config?.typegen === undefined
+            ? {}
+            : {
+                config: {
+                    typegen: runtime.config.config.typegen,
+                    mode: runtime.config.config.mode,
+                },
+            }),
+    };
     return {
         client: new BarekeyClient({
-            organization,
-            project: target.projectSlug,
-            environment: target.stageSlug,
+            json: jsonConfig,
             typegen: false,
         }),
-        organization,
-        project: target.projectSlug,
-        environment: target.stageSlug,
+        organization: organization && organization.trim().length > 0 ? organization : "local",
+        project: target.projectSlug.trim().length > 0 ? target.projectSlug : "standalone",
+        environment: target.stageSlug.trim().length > 0 ? target.stageSlug : "local",
     };
 }
 async function runTypegen(options) {

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
 export declare const CLI_NAME = "barekey";
 export declare const CLI_DESCRIPTION = "Barekey CLI";
-export declare const CLI_VERSION = "0.3.2";
+export declare const CLI_VERSION = "0.4.0";
 export declare const DEFAULT_BAREKEY_API_URL = "https://api.barekey.dev";

package/dist/constants.js

@@ -1,4 +1,4 @@
 export const CLI_NAME = "barekey";
 export const CLI_DESCRIPTION = "Barekey CLI";
-export const CLI_VERSION = "0.3.2";
+export const CLI_VERSION = "0.4.0";
 export const DEFAULT_BAREKEY_API_URL = "https://api.barekey.dev";

package/dist/runtime-config.d.ts

@@ -2,6 +2,10 @@ export type BarekeyRuntimeConfig = {
     org?: string;
     project?: string;
     environment?: string;
+    config?: {
+        typegen?: "semantic" | "minimal";
+        mode?: "centralized" | "standalone";
+    };
 };
 export type BarekeyRuntimeConfigResult = {
     config: BarekeyRuntimeConfig;

package/dist/runtime-config.js

@@ -30,6 +30,9 @@ export async function loadRuntimeConfig() {
     }
     const raw = await readFile(configPath, "utf8");
     const parsed = JSON.parse(raw);
+    const config = typeof parsed.config === "object" && parsed.config !== null
+        ? parsed.config
+        : undefined;
     return {
         path: configPath,
         config: {
@@ -44,6 +47,20 @@ export async function loadRuntimeConfig() {
                 : typeof parsed.stage === "string"
                     ? parsed.stage.trim()
                     : undefined,
+            config: {
+                mode: config?.mode === "centralized" || config?.mode === "standalone"
+                    ? config.mode
+                    : "centralized",
+                typegen: (config?.mode === "centralized" || config?.mode === "standalone"
+                    ? config.mode
+                    : "centralized") === "standalone"
+                    ? "minimal"
+                    : config?.typegen === "semantic" || config?.typegen === "minimal"
+                        ? config.typegen
+                        : parsed.typegen === "semantic" || parsed.typegen === "minimal"
+                            ? parsed.typegen
+                            : "semantic",
+            },
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barekey/cli",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Barekey command line interface",
   "type": "module",
   "bin": {
@@ -15,7 +15,7 @@
   "packageManager": "bun@1.2.22",
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@barekey/sdk": "^0.3.1",
+    "@barekey/sdk": "^0.5.0",
     "commander": "^14.0.1",
     "open": "^10.2.0",
     "picocolors": "^1.1.1"

package/src/command-utils.ts

@@ -63,19 +63,20 @@ export async function requireLocalSession(): Promise<LocalSession> {
 
 export async function resolveTarget(
   options: EnvTargetOptions,
-  local: LocalSession,
+  local?: LocalSession | null,
 ): Promise<{
   projectSlug: string;
   stageSlug: string;
   orgSlug?: string;
 }> {
   const runtime = await loadRuntimeConfig();
+  const isStandalone = runtime?.config.config?.mode === "standalone";
 
   const projectSlug = options.project?.trim() || runtime?.config.project || "";
   const stageSlug = options.stage?.trim() || runtime?.config.environment || "";
-  const orgSlug = options.org?.trim() || runtime?.config.org || local.credentials.orgSlug;
+  const orgSlug = options.org?.trim() || runtime?.config.org || local?.credentials.orgSlug || "";
 
-  if (projectSlug.length === 0 || stageSlug.length === 0) {
+  if (!isStandalone && (projectSlug.length === 0 || stageSlug.length === 0)) {
     const hint = runtime
       ? `Found ${runtime.path} but project/environment is incomplete.`
       : "No barekey.json found in current directory tree.";

package/src/commands/env.ts

@@ -2,6 +2,7 @@ import { writeFile } from "node:fs/promises";
 
 import { cancel, confirm, isCancel } from "@clack/prompts";
 import { BarekeyClient } from "@barekey/sdk/server";
+import type { BarekeyJsonConfig } from "@barekey/sdk/server";
 import { Command } from "commander";
 import pc from "picocolors";
 
@@ -16,6 +17,7 @@ import {
   type EnvTargetOptions,
 } from "../command-utils.js";
 import { postJson } from "../http.js";
+import { loadRuntimeConfig } from "../runtime-config.js";
 import {
   collectOptionValues,
   parseRolloutFunction,
@@ -29,7 +31,34 @@ function createEnvClient(input: {
   organization: string | undefined;
   project: string;
   environment: string;
+  runtimeConfig: Awaited<ReturnType<typeof loadRuntimeConfig>> | null;
 }): BarekeyClient {
+  if (input.runtimeConfig !== null) {
+    const organization = input.organization?.trim();
+    const isStandalone = input.runtimeConfig.config.config?.mode === "standalone";
+    if (!organization && !isStandalone) {
+      throw new Error("Organization slug is required.");
+    }
+
+    const jsonConfig: BarekeyJsonConfig = {
+      ...(organization ? { organization } : {}),
+      ...(input.project.trim().length > 0 ? { project: input.project } : {}),
+      ...(input.environment.trim().length > 0 ? { environment: input.environment } : {}),
+      ...(input.runtimeConfig.config.config === undefined
+        ? {}
+        : {
+            config: {
+              typegen: input.runtimeConfig.config.config.typegen,
+              mode: input.runtimeConfig.config.config.mode,
+            },
+          }),
+    };
+
+    return new BarekeyClient({
+      json: jsonConfig,
+    });
+  }
+
   const organization = input.organization?.trim();
   if (!organization) {
     throw new Error("Organization slug is required.");
@@ -50,12 +79,14 @@ async function runEnvGet(
     json?: boolean;
   },
 ): Promise<void> {
-  const local = await requireLocalSession();
+  const runtime = await loadRuntimeConfig();
+  const local = runtime?.config.config?.mode === "standalone" ? null : await requireLocalSession();
   const target = await resolveTarget(options, local);
   const client = createEnvClient({
-    organization: target.orgSlug ?? local.credentials.orgSlug,
+    organization: target.orgSlug ?? local?.credentials.orgSlug,
     project: target.projectSlug,
     environment: target.stageSlug,
+    runtimeConfig: runtime,
   });
   const value = await client.get(name, {
     seed: options.seed,
@@ -81,12 +112,14 @@ async function runEnvGetMany(
     json?: boolean;
   },
 ): Promise<void> {
-  const local = await requireLocalSession();
+  const runtime = await loadRuntimeConfig();
+  const local = runtime?.config.config?.mode === "standalone" ? null : await requireLocalSession();
   const target = await resolveTarget(options, local);
   const client = createEnvClient({
-    organization: target.orgSlug ?? local.credentials.orgSlug,
+    organization: target.orgSlug ?? local?.credentials.orgSlug,
     project: target.projectSlug,
     environment: target.stageSlug,
+    runtimeConfig: runtime,
   });
 
   const names = options.names

package/src/commands/typegen.ts

@@ -1,5 +1,5 @@
 import { BarekeyClient } from "@barekey/sdk/server";
-import type { BarekeyTypegenResult } from "@barekey/sdk/server";
+import type { BarekeyJsonConfig, BarekeyTypegenResult } from "@barekey/sdk/server";
 import { Command } from "commander";
 import pc from "picocolors";
 
@@ -9,6 +9,7 @@ import {
   resolveTarget,
   type EnvTargetOptions,
 } from "../command-utils.js";
+import { loadRuntimeConfig } from "../runtime-config.js";
 
 const DEFAULT_TYPEGEN_WATCH_INTERVAL_MS = 5_000;
 
@@ -66,23 +67,42 @@ async function resolveTypegenClient(options: EnvTargetOptions): Promise<{
   project: string;
   environment: string;
 }> {
-  const local = await requireLocalSession();
+  const runtime = await loadRuntimeConfig();
+  const local = runtime?.config.config?.mode === "standalone" ? null : await requireLocalSession();
   const target = await resolveTarget(options, local);
-  const organization = target.orgSlug ?? local.credentials.orgSlug;
-  if (!organization || organization.trim().length === 0) {
+  const isStandalone = runtime?.config.config?.mode === "standalone";
+  const organization = target.orgSlug ?? local?.credentials.orgSlug;
+  if ((!organization || organization.trim().length === 0) && !isStandalone) {
     throw new Error("Organization slug is required.");
   }
 
+  const jsonConfig = {
+    ...(organization && organization.trim().length > 0 ? { organization } : {}),
+    ...(target.projectSlug.trim().length > 0 ? { project: target.projectSlug } : {}),
+    ...(target.stageSlug.trim().length > 0 ? { environment: target.stageSlug } : {}),
+    ...(runtime?.config.config?.typegen === undefined
+      ? {}
+      : {
+            config: {
+              typegen: runtime.config.config.typegen,
+              mode: runtime.config.config.mode,
+            },
+          }),
+  } as BarekeyJsonConfig & {
+    config?: {
+      typegen?: "semantic" | "minimal";
+      mode?: "centralized" | "standalone";
+    };
+  };
+
   return {
     client: new BarekeyClient({
-      organization,
-      project: target.projectSlug,
-      environment: target.stageSlug,
+      json: jsonConfig as BarekeyJsonConfig,
       typegen: false,
     }),
-    organization,
-    project: target.projectSlug,
-    environment: target.stageSlug,
+    organization: organization && organization.trim().length > 0 ? organization : "local",
+    project: target.projectSlug.trim().length > 0 ? target.projectSlug : "standalone",
+    environment: target.stageSlug.trim().length > 0 ? target.stageSlug : "local",
   };
 }
 

package/src/constants.ts

@@ -1,4 +1,4 @@
 export const CLI_NAME = "barekey";
 export const CLI_DESCRIPTION = "Barekey CLI";
-export const CLI_VERSION = "0.3.2";
+export const CLI_VERSION = "0.4.0";
 export const DEFAULT_BAREKEY_API_URL = "https://api.barekey.dev";

package/src/runtime-config.ts

@@ -5,6 +5,10 @@ export type BarekeyRuntimeConfig = {
   org?: string;
   project?: string;
   environment?: string;
+  config?: {
+    typegen?: "semantic" | "minimal";
+    mode?: "centralized" | "standalone";
+  };
 };
 
 export type BarekeyRuntimeConfigResult = {
@@ -45,6 +49,10 @@ export async function loadRuntimeConfig(): Promise<BarekeyRuntimeConfigResult |
 
   const raw = await readFile(configPath, "utf8");
   const parsed = JSON.parse(raw) as Record<string, unknown>;
+  const config =
+    typeof parsed.config === "object" && parsed.config !== null
+      ? (parsed.config as Record<string, unknown>)
+      : undefined;
   return {
     path: configPath,
     config: {
@@ -61,6 +69,22 @@ export async function loadRuntimeConfig(): Promise<BarekeyRuntimeConfigResult |
           : typeof parsed.stage === "string"
             ? parsed.stage.trim()
             : undefined,
+      config: {
+        mode:
+          config?.mode === "centralized" || config?.mode === "standalone"
+            ? config.mode
+            : "centralized",
+        typegen:
+          (config?.mode === "centralized" || config?.mode === "standalone"
+            ? config.mode
+            : "centralized") === "standalone"
+            ? "minimal"
+            : config?.typegen === "semantic" || config?.typegen === "minimal"
+              ? config.typegen
+              : parsed.typegen === "semantic" || parsed.typegen === "minimal"
+                ? parsed.typegen
+                : "semantic",
+      },
     },
   };
 }

package/test/runtime-config.test.ts

@@ -0,0 +1,125 @@
+import { mkdtemp, mkdir, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+
+import { describe, expect, test } from "bun:test";
+
+import { loadRuntimeConfig } from "../src/runtime-config";
+
+async function createTempDir(prefix = "barekey-cli-test-"): Promise<string> {
+  return await mkdtemp(path.join(tmpdir(), prefix));
+}
+
+async function withWorkingDirectory<TValue>(
+  nextCwd: string,
+  fn: () => Promise<TValue>,
+): Promise<TValue> {
+  const previousCwd = process.cwd();
+  process.chdir(nextCwd);
+  try {
+    return await fn();
+  } finally {
+    process.chdir(previousCwd);
+  }
+}
+
+describe("loadRuntimeConfig", () => {
+  test("clamps standalone config.typegen to minimal", async () => {
+    const tempDir = await createTempDir();
+    const appDir = path.join(tempDir, "apps", "web");
+    await mkdir(appDir, {
+      recursive: true,
+    });
+    await writeFile(
+      path.join(tempDir, "barekey.json"),
+      JSON.stringify(
+        {
+          organization: "acme",
+          project: "api",
+          environment: "development",
+          config: {
+            mode: "standalone",
+            typegen: "semantic",
+          },
+        },
+        null,
+        2,
+      ),
+      "utf8",
+    );
+
+    await withWorkingDirectory(appDir, async () => {
+      await expect(loadRuntimeConfig()).resolves.toMatchObject({
+        path: path.join(tempDir, "barekey.json"),
+        config: {
+          org: "acme",
+          project: "api",
+          environment: "development",
+          config: {
+            mode: "standalone",
+            typegen: "minimal",
+          },
+        },
+      });
+    });
+  });
+
+  test("defaults config flags when barekey.json omits them", async () => {
+    const tempDir = await createTempDir();
+    await writeFile(
+      path.join(tempDir, "barekey.json"),
+      JSON.stringify(
+        {
+          organization: "acme",
+          project: "api",
+          environment: "development",
+        },
+        null,
+        2,
+      ),
+      "utf8",
+    );
+
+    await withWorkingDirectory(tempDir, async () => {
+      await expect(loadRuntimeConfig()).resolves.toMatchObject({
+        config: {
+          config: {
+            mode: "centralized",
+            typegen: "semantic",
+          },
+        },
+      });
+    });
+  });
+
+  test("keeps standalone config valid without platform scope fields", async () => {
+    const tempDir = await createTempDir();
+    await writeFile(
+      path.join(tempDir, "barekey.json"),
+      JSON.stringify(
+        {
+          config: {
+            mode: "standalone",
+          },
+        },
+        null,
+        2,
+      ),
+      "utf8",
+    );
+
+    await withWorkingDirectory(tempDir, async () => {
+      await expect(loadRuntimeConfig()).resolves.toMatchObject({
+        config: {
+          org: undefined,
+          project: undefined,
+          environment: undefined,
+          config: {
+            mode: "standalone",
+            typegen: "minimal",
+          },
+        },
+      });
+    });
+  });
+});