@rigkit/provider-gcloud-cli 0.2.2 → 0.2.3

package/README.md

@@ -14,11 +14,13 @@ import {
 
 const app = workflow("example", {
   providers: {
-    gcloudConfig: copyGcloudConfig.provider(),
+    gcloudConfig: copyGcloudConfig.provider({
+      requireAuth: true,
+    }),
   },
 });
 
-// Inside workspace.onOpen:
+// Inside a workspace operation:
 const gcloudConfigFiles = await providers.gcloudConfig.configFiles();
 for (const step of gcloudConfigCopyInjectionSteps(gcloudConfigFiles)) {
   await vm.exec(step.command, { name: step.name, env: step.env });
@@ -28,4 +30,4 @@ const verified = await vm.probe(gcloudCopiedConfigReadyCommand());
 if (!verified.ok) throw new Error("gcloud did not accept the copied config files");
 ```
 
-If local `gcloud` is missing, provider startup fails with the Google Cloud SDK install URL. If it is not authenticated, startup asks the user to run `gcloud auth login`.
+By default, provider startup requires local `gcloud` to be installed and authenticated before Rigkit runs project commands. If local `gcloud` is missing, startup fails with the Google Cloud SDK install URL. If it is not authenticated, startup asks the user to run `gcloud auth login`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rigkit/provider-gcloud-cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "type": "module",
   "repository": {
     "type": "git",
@@ -17,8 +17,8 @@
   ],
   "dependencies": {
     "zod": "^4",
-    "@rigkit/engine": "0.2.2",
-    "@rigkit/sdk": "0.2.2"
+    "@rigkit/engine": "0.2.3",
+    "@rigkit/sdk": "0.2.3"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/index.ts

@@ -5,6 +5,7 @@ import {
   assertLocalGcloudReady,
   createGcloudConfigCopyController,
   GCLOUD_CONFIG_COPY_PROVIDER_ID,
+  requiresLocalGcloudAuth,
   type GcloudConfigCopyConfig,
   type GcloudConfigCopyRuntime,
 } from "./provider.ts";
@@ -12,6 +13,7 @@ import { createGcloudAuthStore } from "./store.ts";
 
 const gcloudConfigCopyProviderConfigSchema = z.object({
   command: z.optional(z.string()),
+  requireAuth: z.optional(z.boolean()),
   key: z.optional(z.string()),
   account: z.optional(z.string()),
   scopes: z.optional(z.array(z.string())),
@@ -42,7 +44,9 @@ export const gcloudConfigCopyProviderPlugin: BaseProviderPlugin = {
   providerId: GCLOUD_CONFIG_COPY_PROVIDER_ID,
   async createProvider({ provider, storage }) {
     const config = parseGcloudConfigCopyProviderConfig(provider.config);
-    await assertLocalGcloudReady(config);
+    if (requiresLocalGcloudAuth(config)) {
+      await assertLocalGcloudReady(config);
+    }
     return createGcloudConfigCopyController(config, createGcloudAuthStore(storage));
   },
 };
@@ -53,6 +57,7 @@ export {
   DEFAULT_GCLOUD_INSTALL_URL,
   GCLOUD_CONFIG_COPY_PROVIDER_ID,
   createGcloudConfigCopyController,
+  requiresLocalGcloudAuth,
 } from "./provider.ts";
 export {
   DEFAULT_GCLOUD_ACCESS_TOKEN_EXPIRES_AT_PATH,

package/src/provider.test.ts

@@ -3,10 +3,57 @@ import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { createStateStore } from "@rigkit/engine";
-import { createGcloudConfigCopyController, assertLocalGcloudReady, type GcloudCommandRunner } from "./provider.ts";
+import { gcloudConfigCopyProviderPlugin } from "./index.ts";
+import {
+  GCLOUD_CONFIG_COPY_PROVIDER_ID,
+  assertLocalGcloudReady,
+  createGcloudConfigCopyController,
+  requiresLocalGcloudAuth,
+  type GcloudCommandRunner,
+} from "./provider.ts";
 import { createGcloudAuthStore } from "./store.ts";
 
 describe("local gcloud config copy provider", () => {
+  test("requires startup auth by default", async () => {
+    expect(requiresLocalGcloudAuth({})).toBe(true);
+    expect(requiresLocalGcloudAuth({ requireAuth: true })).toBe(true);
+
+    const projectDir = mkdtempSync(join(tmpdir(), "rigkit-gcloud-"));
+    const state = createStateStore({ projectDir });
+    await state.syncSchema();
+
+    await expect(
+      gcloudConfigCopyProviderPlugin.createProvider({
+        provider: {
+          providerId: GCLOUD_CONFIG_COPY_PROVIDER_ID,
+          config: { command: join(projectDir, "missing-gcloud") },
+        },
+        storage: state.providerStorage("gcloud.config.copy"),
+      }),
+    ).rejects.toThrow("Local gcloud CLI is required");
+  });
+
+  test("can skip startup auth explicitly", async () => {
+    expect(requiresLocalGcloudAuth({ requireAuth: false })).toBe(false);
+
+    const projectDir = mkdtempSync(join(tmpdir(), "rigkit-gcloud-"));
+    const state = createStateStore({ projectDir });
+    await state.syncSchema();
+
+    const controller = await gcloudConfigCopyProviderPlugin.createProvider({
+      provider: {
+        providerId: GCLOUD_CONFIG_COPY_PROVIDER_ID,
+        config: {
+          command: join(projectDir, "missing-gcloud"),
+          requireAuth: false,
+        },
+      },
+      storage: state.providerStorage("gcloud.config.copy"),
+    });
+
+    expect(controller.providerId).toBe(GCLOUD_CONFIG_COPY_PROVIDER_ID);
+  });
+
   test("fails startup when local gcloud is missing", async () => {
     const runner: GcloudCommandRunner = async () => ({
       stdout: "",

package/src/provider.ts

@@ -24,6 +24,7 @@ const DEFAULT_ACCESS_TOKEN_LIFETIME_SECONDS = 55 * 60;
 
 export type GcloudConfigCopyConfig = {
   command?: string;
+  requireAuth?: boolean;
   key?: string;
   account?: string;
   scopes?: readonly string[];
@@ -113,6 +114,10 @@ export async function assertLocalGcloudReady(
   }
 }
 
+export function requiresLocalGcloudAuth(config: GcloudConfigCopyConfig): boolean {
+  return config.requireAuth ?? true;
+}
+
 async function freshAccessToken(input: {
   config: GcloudConfigCopyConfig;
   store: GcloudAuthStore;

package/src/version.ts

@@ -1 +1 @@
-export const RIGKIT_PROVIDER_GCLOUD_CLI_VERSION = "0.2.2";
+export const RIGKIT_PROVIDER_GCLOUD_CLI_VERSION = "0.2.3";