@superblocksteam/sdk 2.0.110-next.8 → 2.0.110

package/dist/cli-replacement/automatic-upgrades.test.d.ts

@@ -1,11 +0,0 @@
-/**
- * Tests for checkVersionsAndWritePackageJson, specifically around the
- * skipCliUpgrade parameter introduced for warm pool activation.
- *
- * Warm pods ship with the latest CLI, so an auto-upgrade would pointlessly
- * restart the process and defeat the warm pool. But we still need the
- * package.json version sync when resuming an existing app so the user's
- * @superblocksteam/library pin matches the target version.
- */
-export {};
-//# sourceMappingURL=automatic-upgrades.test.d.ts.map

package/dist/cli-replacement/automatic-upgrades.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"automatic-upgrades.test.d.ts","sourceRoot":"","sources":["../../src/cli-replacement/automatic-upgrades.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/cli-replacement/automatic-upgrades.test.js

@@ -1,175 +0,0 @@
-/**
- * Tests for checkVersionsAndWritePackageJson, specifically around the
- * skipCliUpgrade parameter introduced for warm pool activation.
- *
- * Warm pods ship with the latest CLI, so an auto-upgrade would pointlessly
- * restart the process and defeat the warm pool. But we still need the
- * package.json version sync when resuming an existing app so the user's
- * @superblocksteam/library pin matches the target version.
- */
-import fs from "node:fs/promises";
-import { describe, it, expect, beforeEach, vi } from "vitest";
-import { checkVersionsAndWritePackageJson } from "./automatic-upgrades.js";
-// ---------------------------------------------------------------------------
-// Mocks
-// ---------------------------------------------------------------------------
-vi.mock("node:fs/promises", () => ({
-    default: {
-        readFile: vi.fn(),
-        writeFile: vi.fn(),
-    },
-}));
-vi.mock("node:child_process", () => ({
-    exec: vi.fn(),
-}));
-const upgradeWithPackageManagerCalls = [];
-vi.mock("package-manager-detector/detect", () => ({
-    detect: vi.fn(async () => ({
-        name: "pnpm",
-        agent: "pnpm",
-        version: "10.0.0",
-    })),
-}));
-vi.mock("package-manager-detector", () => ({
-    resolveCommand: vi.fn(() => ({ command: "pnpm", args: ["install"] })),
-}));
-vi.mock("./version-detection.js", () => ({
-    getCurrentCliVersion: vi.fn(async () => ({
-        version: "2.0.0",
-        alias: undefined,
-    })),
-    clearCliVersionCache: vi.fn(),
-}));
-vi.mock("../telemetry/logging.js", () => ({
-    getLogger: () => ({
-        info: vi.fn(),
-        warn: vi.fn(),
-        error: vi.fn(),
-        debug: vi.fn(),
-    }),
-    getErrorMeta: vi.fn(() => ({})),
-}));
-vi.mock("../telemetry/index.js", () => ({
-    getTracer: () => ({
-        startActiveSpan: vi.fn((_name, fn) => fn({ end: vi.fn() })),
-    }),
-}));
-vi.mock("@superblocksteam/shared", async () => {
-    return {
-        NON_SB_ORG_UPDATE_ERROR: "non_sb_org_update_error",
-        // traceFunction in tests is a passthrough — we just want the fn to run.
-        traceFunction: async ({ fn }) => {
-            return await fn();
-        },
-    };
-});
-// ---------------------------------------------------------------------------
-// Test fixtures
-// ---------------------------------------------------------------------------
-const TARGET_CLI_VERSION = "2.1.0"; // newer than the mocked current 2.0.0
-const TARGET_LIBRARY_VERSION = "1.9.0";
-const mockLockService = {
-    shutdown: vi.fn(async () => undefined),
-};
-const mockConfig = {
-    id: "app-123",
-    branchName: "main",
-    superblocksBaseUrl: "https://example.test",
-    token: "test-token",
-    userId: "user-1",
-    userEmail: "test@example.com",
-    organizationId: "org-1",
-    featureFlags: {},
-};
-beforeEach(() => {
-    vi.clearAllMocks();
-    upgradeWithPackageManagerCalls.length = 0;
-    // Mock global fetch used by getRemoteVersions
-    global.fetch = vi.fn(async () => ({
-        ok: true,
-        json: async () => ({
-            data: {
-                cli: TARGET_CLI_VERSION,
-                library: TARGET_LIBRARY_VERSION,
-            },
-        }),
-    }));
-    // Default package.json content
-    vi.mocked(fs.readFile).mockResolvedValue(JSON.stringify({
-        name: "test-app",
-        dependencies: {
-            "@superblocksteam/library": "1.0.0",
-        },
-    }));
-    vi.mocked(fs.writeFile).mockResolvedValue(undefined);
-});
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-describe("checkVersionsAndWritePackageJson", () => {
-    describe("skipCliUpgrade=true (warm pool activation)", () => {
-        it("still writes package.json with the target library version", async () => {
-            await checkVersionsAndWritePackageJson(mockLockService, mockConfig, false, // forceUpgrade
-            true);
-            expect(fs.writeFile).toHaveBeenCalledTimes(1);
-            const [, writtenContent] = vi.mocked(fs.writeFile).mock.calls[0];
-            const parsed = JSON.parse(writtenContent);
-            expect(parsed.dependencies["@superblocksteam/library"]).toBe(TARGET_LIBRARY_VERSION);
-        });
-        it("does NOT call the oclif CLI upgrader even when CLI is stale", async () => {
-            const { exec } = await import("node:child_process");
-            // If an upgrade were attempted, upgradeCliWithOclif would exec
-            // `which superblocks`. We assert that does not happen.
-            await checkVersionsAndWritePackageJson(mockLockService, mockConfig, false, true);
-            expect(exec).not.toHaveBeenCalled();
-        });
-        it("returns cliUpdated=false regardless of CLI version gap", async () => {
-            const result = await checkVersionsAndWritePackageJson(mockLockService, mockConfig, false, true);
-            expect(result.cliUpdated).toBe(false);
-        });
-        it("skipCliUpgrade overrides forceUpgrade", async () => {
-            const { exec } = await import("node:child_process");
-            await checkVersionsAndWritePackageJson(mockLockService, mockConfig, true, // forceUpgrade — should be overridden by skipCliUpgrade
-            true);
-            expect(exec).not.toHaveBeenCalled();
-            // But package.json still gets written
-            expect(fs.writeFile).toHaveBeenCalledTimes(1);
-        });
-    });
-    describe("skipCliUpgrade=false (default)", () => {
-        it("writes package.json with the target library version", async () => {
-            await checkVersionsAndWritePackageJson(mockLockService, mockConfig, false, false);
-            expect(fs.writeFile).toHaveBeenCalledTimes(1);
-            const [, writtenContent] = vi.mocked(fs.writeFile).mock.calls[0];
-            const parsed = JSON.parse(writtenContent);
-            expect(parsed.dependencies["@superblocksteam/library"]).toBe(TARGET_LIBRARY_VERSION);
-        });
-        it("defaults to false when omitted (backward compat)", async () => {
-            // 3-arg call (pre-warm-pool signature) should behave as skipCliUpgrade=false
-            const result = await checkVersionsAndWritePackageJson(mockLockService, mockConfig, false);
-            // Still writes package.json
-            expect(fs.writeFile).toHaveBeenCalledTimes(1);
-            expect(result).toBeDefined();
-        });
-    });
-    describe("SNAPSHOT library versions", () => {
-        it("pins to ephemeral alias when library target is a SNAPSHOT", async () => {
-            const snapshotVersion = "1.9.0-SNAPSHOT.abc123";
-            global.fetch = vi.fn(async () => ({
-                ok: true,
-                json: async () => ({
-                    data: {
-                        cli: TARGET_CLI_VERSION,
-                        library: snapshotVersion,
-                    },
-                }),
-            }));
-            await checkVersionsAndWritePackageJson(mockLockService, mockConfig, false, true);
-            expect(fs.writeFile).toHaveBeenCalledTimes(1);
-            const [, writtenContent] = vi.mocked(fs.writeFile).mock.calls[0];
-            const parsed = JSON.parse(writtenContent);
-            expect(parsed.dependencies["@superblocksteam/library"]).toBe(`npm:@superblocksteam/library-ephemeral@${snapshotVersion}`);
-        });
-    });
-});
-//# sourceMappingURL=automatic-upgrades.test.js.map

package/dist/cli-replacement/automatic-upgrades.test.js.map

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

package/src/cli-replacement/automatic-upgrades.test.ts

@@ -1,251 +0,0 @@
-/**
- * Tests for checkVersionsAndWritePackageJson, specifically around the
- * skipCliUpgrade parameter introduced for warm pool activation.
- *
- * Warm pods ship with the latest CLI, so an auto-upgrade would pointlessly
- * restart the process and defeat the warm pool. But we still need the
- * package.json version sync when resuming an existing app so the user's
- * @superblocksteam/library pin matches the target version.
- */
-
-import fs from "node:fs/promises";
-
-import { describe, it, expect, beforeEach, vi } from "vitest";
-
-import { checkVersionsAndWritePackageJson } from "./automatic-upgrades.js";
-
-// ---------------------------------------------------------------------------
-// Mocks
-// ---------------------------------------------------------------------------
-
-vi.mock("node:fs/promises", () => ({
-  default: {
-    readFile: vi.fn(),
-    writeFile: vi.fn(),
-  },
-}));
-
-vi.mock("node:child_process", () => ({
-  exec: vi.fn(),
-}));
-
-const upgradeWithPackageManagerCalls: unknown[] = [];
-vi.mock("package-manager-detector/detect", () => ({
-  detect: vi.fn(async () => ({
-    name: "pnpm",
-    agent: "pnpm",
-    version: "10.0.0",
-  })),
-}));
-
-vi.mock("package-manager-detector", () => ({
-  resolveCommand: vi.fn(() => ({ command: "pnpm", args: ["install"] })),
-}));
-
-vi.mock("./version-detection.js", () => ({
-  getCurrentCliVersion: vi.fn(async () => ({
-    version: "2.0.0",
-    alias: undefined,
-  })),
-  clearCliVersionCache: vi.fn(),
-}));
-
-vi.mock("../telemetry/logging.js", () => ({
-  getLogger: () => ({
-    info: vi.fn(),
-    warn: vi.fn(),
-    error: vi.fn(),
-    debug: vi.fn(),
-  }),
-  getErrorMeta: vi.fn(() => ({})),
-}));
-
-vi.mock("../telemetry/index.js", () => ({
-  getTracer: () => ({
-    startActiveSpan: vi.fn((_name, fn) => fn({ end: vi.fn() })),
-  }),
-}));
-
-vi.mock("@superblocksteam/shared", async () => {
-  return {
-    NON_SB_ORG_UPDATE_ERROR: "non_sb_org_update_error",
-    // traceFunction in tests is a passthrough — we just want the fn to run.
-    traceFunction: async ({ fn }: { fn: () => Promise<unknown> }) => {
-      return await fn();
-    },
-  };
-});
-
-// ---------------------------------------------------------------------------
-// Test fixtures
-// ---------------------------------------------------------------------------
-
-const TARGET_CLI_VERSION = "2.1.0"; // newer than the mocked current 2.0.0
-const TARGET_LIBRARY_VERSION = "1.9.0";
-
-const mockLockService = {
-  shutdown: vi.fn(async () => undefined),
-} as unknown as Parameters<typeof checkVersionsAndWritePackageJson>[0];
-
-const mockConfig: Parameters<typeof checkVersionsAndWritePackageJson>[1] = {
-  id: "app-123",
-  branchName: "main",
-  superblocksBaseUrl: "https://example.test",
-  token: "test-token",
-  userId: "user-1",
-  userEmail: "test@example.com",
-  organizationId: "org-1",
-  featureFlags: {},
-} as unknown as Parameters<typeof checkVersionsAndWritePackageJson>[1];
-
-beforeEach(() => {
-  vi.clearAllMocks();
-  upgradeWithPackageManagerCalls.length = 0;
-
-  // Mock global fetch used by getRemoteVersions
-  global.fetch = vi.fn(async () => ({
-    ok: true,
-    json: async () => ({
-      data: {
-        cli: TARGET_CLI_VERSION,
-        library: TARGET_LIBRARY_VERSION,
-      },
-    }),
-  })) as unknown as typeof fetch;
-
-  // Default package.json content
-  vi.mocked(fs.readFile).mockResolvedValue(
-    JSON.stringify({
-      name: "test-app",
-      dependencies: {
-        "@superblocksteam/library": "1.0.0",
-      },
-    }),
-  );
-  vi.mocked(fs.writeFile).mockResolvedValue(undefined);
-});
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe("checkVersionsAndWritePackageJson", () => {
-  describe("skipCliUpgrade=true (warm pool activation)", () => {
-    it("still writes package.json with the target library version", async () => {
-      await checkVersionsAndWritePackageJson(
-        mockLockService,
-        mockConfig,
-        false, // forceUpgrade
-        true, // skipCliUpgrade — the warm pool case
-      );
-
-      expect(fs.writeFile).toHaveBeenCalledTimes(1);
-      const [, writtenContent] = vi.mocked(fs.writeFile).mock.calls[0];
-      const parsed = JSON.parse(writtenContent as string);
-      expect(parsed.dependencies["@superblocksteam/library"]).toBe(
-        TARGET_LIBRARY_VERSION,
-      );
-    });
-
-    it("does NOT call the oclif CLI upgrader even when CLI is stale", async () => {
-      const { exec } = await import("node:child_process");
-      // If an upgrade were attempted, upgradeCliWithOclif would exec
-      // `which superblocks`. We assert that does not happen.
-
-      await checkVersionsAndWritePackageJson(
-        mockLockService,
-        mockConfig,
-        false,
-        true,
-      );
-
-      expect(exec).not.toHaveBeenCalled();
-    });
-
-    it("returns cliUpdated=false regardless of CLI version gap", async () => {
-      const result = await checkVersionsAndWritePackageJson(
-        mockLockService,
-        mockConfig,
-        false,
-        true,
-      );
-
-      expect(result.cliUpdated).toBe(false);
-    });
-
-    it("skipCliUpgrade overrides forceUpgrade", async () => {
-      const { exec } = await import("node:child_process");
-
-      await checkVersionsAndWritePackageJson(
-        mockLockService,
-        mockConfig,
-        true, // forceUpgrade — should be overridden by skipCliUpgrade
-        true, // skipCliUpgrade wins
-      );
-
-      expect(exec).not.toHaveBeenCalled();
-      // But package.json still gets written
-      expect(fs.writeFile).toHaveBeenCalledTimes(1);
-    });
-  });
-
-  describe("skipCliUpgrade=false (default)", () => {
-    it("writes package.json with the target library version", async () => {
-      await checkVersionsAndWritePackageJson(
-        mockLockService,
-        mockConfig,
-        false,
-        false,
-      );
-
-      expect(fs.writeFile).toHaveBeenCalledTimes(1);
-      const [, writtenContent] = vi.mocked(fs.writeFile).mock.calls[0];
-      const parsed = JSON.parse(writtenContent as string);
-      expect(parsed.dependencies["@superblocksteam/library"]).toBe(
-        TARGET_LIBRARY_VERSION,
-      );
-    });
-
-    it("defaults to false when omitted (backward compat)", async () => {
-      // 3-arg call (pre-warm-pool signature) should behave as skipCliUpgrade=false
-      const result = await checkVersionsAndWritePackageJson(
-        mockLockService,
-        mockConfig,
-        false,
-      );
-
-      // Still writes package.json
-      expect(fs.writeFile).toHaveBeenCalledTimes(1);
-      expect(result).toBeDefined();
-    });
-  });
-
-  describe("SNAPSHOT library versions", () => {
-    it("pins to ephemeral alias when library target is a SNAPSHOT", async () => {
-      const snapshotVersion = "1.9.0-SNAPSHOT.abc123";
-      global.fetch = vi.fn(async () => ({
-        ok: true,
-        json: async () => ({
-          data: {
-            cli: TARGET_CLI_VERSION,
-            library: snapshotVersion,
-          },
-        }),
-      })) as unknown as typeof fetch;
-
-      await checkVersionsAndWritePackageJson(
-        mockLockService,
-        mockConfig,
-        false,
-        true, // warm pool
-      );
-
-      expect(fs.writeFile).toHaveBeenCalledTimes(1);
-      const [, writtenContent] = vi.mocked(fs.writeFile).mock.calls[0];
-      const parsed = JSON.parse(writtenContent as string);
-      expect(parsed.dependencies["@superblocksteam/library"]).toBe(
-        `npm:@superblocksteam/library-ephemeral@${snapshotVersion}`,
-      );
-    });
-  });
-});