@superblocksteam/sdk 2.0.93 → 2.0.94-next.0

package/dist/vite-plugin-generate-api-build-manifest.mjs

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { isSdkApiTemplate } from "@superblocksteam/shared";
 import { resolveLanguageSpecificStepContentFromBlocks } from "@superblocksteam/util";
 import { getPageName, getScopeIdFromName, } from "@superblocksteam/vite-plugin-file-sync";
 import { yellow, red } from "colorette";
@@ -6,6 +7,7 @@ import fg from "fast-glob";
 import fs from "fs-extra";
 import { createLogger } from "vite";
 import yaml from "yaml";
+import { collectSdkApisFromRegistry } from "./collect-sdk-apis.mjs";
 import { getLogger } from "./telemetry/logging.js";
 /**
  * Vite plugin that generates a build manifest for the application.
@@ -37,13 +39,16 @@ export function generateApiBuildManifestPlugin(root) {
         logger.error(red(msg));
     };
     viteLogger.clearScreen = () => { };
+    const sdkApiEnabled = isSdkApiTemplate(process.env.SUPERBLOCKS_APP_TEMPLATE_NAME);
     const apiFiles = {};
-    let buildManifest = { apis: {}, apiDependencies: [] };
+    let buildManifest = { apis: {}, apiDependencies: [], sdkApis: {} };
     return {
         name: "sb-generate-build-manifest",
         apply: "build",
         enforce: "pre",
         async buildStart() {
+            if (sdkApiEnabled)
+                return;
             const apiDocuments = await fg(["**/api.yaml", "**/api.yml"], {
                 cwd: root,
             });
@@ -65,9 +70,16 @@ export function generateApiBuildManifestPlugin(root) {
                 };
                 return acc;
             }, {});
+            const sdkApis = sdkApiEnabled
+                ? await collectSdkApisFromRegistry(root, {
+                    pathExists: (p) => fs.pathExists(p),
+                    readFile: (p, enc) => fs.readFile(p, enc),
+                })
+                : {};
             buildManifest = {
                 apis: allApis,
                 apiDependencies: [],
+                sdkApis,
             };
             // Find the existing hashed build-manifest file in the bundle and replace its content
             for (const [fileName, chunk] of Object.entries(bundle)) {

package/dist/vite-plugin-generate-api-build-manifest.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin-generate-api-build-manifest.mjs","sourceRoot":"","sources":["../src/vite-plugin-generate-api-build-manifest.mts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,4CAA4C,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EACL,WAAW,EACX,kBAAkB,GACnB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAWnD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,UAAU,CAAC,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,UAAU,CAAC,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,UAAU,CAAC,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE;QACpC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,UAAU,CAAC,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE;QACjC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,UAAU,CAAC,WAAW,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;IAElC,MAAM,QAAQ,GAAuC,EAAE,CAAC;IACxD,IAAI,aAAa,GAGb,EAAE,IAAI,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAEtC,OAAO;QACL,IAAI,EAAE,4BAA4B;QAClC,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,KAAK;QAEd,KAAK,CAAC,UAAU;YACd,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE;gBAC3D,GAAG,EAAE,IAAI;aACV,CAAC,CAAC;YAEH,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;gBACvC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAEzD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;gBACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAEnC,MAAM,4CAA4C,CAChD,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EACjC,KAAK,CAAC,MAAM,IAAI,EAAE,EAClB,EAAE,CACH,CAAC;gBAEF,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;gBAC1C,KAAK,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACxC,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,QAAa,EAAE,MAAW;YAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAC7C,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE;gBACjB,GAAG,CAAC,EAAE,CAAC,GAAG;oBACR,GAAG;oBACH,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC;iBACnC,CAAC;gBACF,OAAO,GAAG,CAAC;YACb,CAAC,EACD,EAAkE,CACnE,CAAC;YAEF,aAAa,GAAG;gBACd,IAAI,EAAE,OAAO;gBACb,eAAe,EAAE,EAAE;aACpB,CAAC;YAEF,qFAAqF;YACrF,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvD,kEAAkE;gBAClE,IACE,QAAQ,CAAC,UAAU,CAAC,uBAAuB,CAAC;oBAC5C,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EACxB,CAAC;oBACD,8DAA8D;oBAC9D,IAAK,KAAa,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;wBACnC,KAAa,CAAC,IAAI;4BACjB,kBAAkB,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC;oBACvD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;KACQ,CAAC;AACd,CAAC"}
+{"version":3,"file":"vite-plugin-generate-api-build-manifest.mjs","sourceRoot":"","sources":["../src/vite-plugin-generate-api-build-manifest.mts"],"names":[],"mappings":"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"}

package/dist/vite-plugin-sdk-api-entry-point.d.mts

@@ -0,0 +1,10 @@
+import type { Plugin } from "vite";
+/**
+ * Vite plugin that prepends `__setEntryPoint(relativePath)` to SDK API files
+ * so that `api()` / `streamingApi()` can stamp the authoritative source file
+ * path onto the compiled API object.
+ *
+ * Runs in both dev and build. The user's source code is never modified on disk.
+ */
+export declare function sdkApiEntryPointPlugin(root: string): Plugin;
+//# sourceMappingURL=vite-plugin-sdk-api-entry-point.d.mts.map

package/dist/vite-plugin-sdk-api-entry-point.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin-sdk-api-entry-point.d.mts","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.mts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAwBnC;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2C3D"}

package/dist/vite-plugin-sdk-api-entry-point.mjs

@@ -0,0 +1,63 @@
+import path from "node:path";
+/**
+ * Build a sourcemap `mappings` string for a simple prepend operation.
+ *
+ * The prepended lines get no source mapping (empty segments).
+ * Each original line maps 1:1 to its position in the source file.
+ *
+ * VLQ values used:
+ *   AAAA = (col 0, source 0, srcLine 0, srcCol 0)  — first original line
+ *   AACA = (col 0, source 0, srcLine +1, srcCol 0)  — each subsequent line
+ */
+function buildPrependMappings(prependLineCount, originalLineCount) {
+    const empty = ";".repeat(prependLineCount);
+    if (originalLineCount === 0)
+        return empty;
+    const original = ["AAAA"]
+        .concat(Array(Math.max(0, originalLineCount - 1)).fill("AACA"))
+        .join(";");
+    return empty + original;
+}
+/**
+ * Vite plugin that prepends `__setEntryPoint(relativePath)` to SDK API files
+ * so that `api()` / `streamingApi()` can stamp the authoritative source file
+ * path onto the compiled API object.
+ *
+ * Runs in both dev and build. The user's source code is never modified on disk.
+ */
+export function sdkApiEntryPointPlugin(root) {
+    return {
+        name: "sb-sdk-api-entry-point",
+        enforce: "pre",
+        transform(code, id) {
+            const relative = path.relative(root, id).replace(/\\/g, "/");
+            if (!relative.startsWith("server/apis/") ||
+                relative === "server/apis/index.ts") {
+                return null;
+            }
+            if (!relative.endsWith(".ts") && !relative.endsWith(".tsx")) {
+                return null;
+            }
+            const prependLines = [
+                `import { __setEntryPoint as __sb_set_ep } from "@superblocksteam/sdk-api";`,
+                `__sb_set_ep(${JSON.stringify(relative)});`,
+                "",
+            ];
+            const prepend = prependLines.join("\n");
+            const originalLineCount = code.split("\n").length;
+            const prependNewlineCount = prependLines.length - 1;
+            return {
+                code: prepend + code,
+                map: {
+                    version: 3,
+                    file: id,
+                    sources: [id],
+                    sourcesContent: [code],
+                    names: [],
+                    mappings: buildPrependMappings(prependNewlineCount, originalLineCount),
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=vite-plugin-sdk-api-entry-point.mjs.map

package/dist/vite-plugin-sdk-api-entry-point.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin-sdk-api-entry-point.mjs","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.mts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAC3B,gBAAwB,EACxB,iBAAyB;IAEzB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3C,IAAI,iBAAiB,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC;SACtB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC9D,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,KAAK,GAAG,QAAQ,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,KAAK;QAEd,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC7D,IACE,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC;gBACpC,QAAQ,KAAK,sBAAsB,EACnC,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5D,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,YAAY,GAAG;gBACnB,4EAA4E;gBAC5E,eAAe,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI;gBAC3C,EAAE;aACH,CAAC;YACF,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAElD,MAAM,mBAAmB,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YAEpD,OAAO;gBACL,IAAI,EAAE,OAAO,GAAG,IAAI;gBACpB,GAAG,EAAE;oBACH,OAAO,EAAE,CAAC;oBACV,IAAI,EAAE,EAAE;oBACR,OAAO,EAAE,CAAC,EAAE,CAAC;oBACb,cAAc,EAAE,CAAC,IAAI,CAAC;oBACtB,KAAK,EAAE,EAAE;oBACT,QAAQ,EAAE,oBAAoB,CAC5B,mBAAmB,EACnB,iBAAiB,CAClB;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/vite-plugin-sdk-api-entry-point.test.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vite-plugin-sdk-api-entry-point.test.d.mts.map

package/dist/vite-plugin-sdk-api-entry-point.test.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin-sdk-api-entry-point.test.d.mts","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.test.mts"],"names":[],"mappings":""}

package/dist/vite-plugin-sdk-api-entry-point.test.mjs

@@ -0,0 +1,166 @@
+import path from "node:path";
+import { describe, it, expect } from "vitest";
+import { sdkApiEntryPointPlugin } from "./vite-plugin-sdk-api-entry-point.mjs";
+function createPlugin(root) {
+    const plugin = sdkApiEntryPointPlugin(root);
+    const transform = plugin.transform;
+    return { plugin, transform };
+}
+const VLQ_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function decodeVlqSegment(encoded) {
+    const values = [];
+    let shift = 0;
+    let value = 0;
+    for (const char of encoded) {
+        const digit = VLQ_CHARS.indexOf(char);
+        value += (digit & 31) << shift;
+        if (digit & 32) {
+            shift += 5;
+        }
+        else {
+            values.push(value & 1 ? -(value >> 1) : value >> 1);
+            shift = 0;
+            value = 0;
+        }
+    }
+    return values;
+}
+/**
+ * Decode sourcemap mappings into per-output-line source line numbers.
+ * Returns null for unmapped lines.
+ */
+function decodeMappings(mappings) {
+    let currentSourceLine = 0;
+    return mappings.split(";").map((group) => {
+        if (group === "")
+            return null;
+        const fields = decodeVlqSegment(group.split(",")[0]);
+        if (fields.length >= 4) {
+            currentSourceLine += fields[2];
+            return currentSourceLine;
+        }
+        return null;
+    });
+}
+/**
+ * Validate the core sourcemap invariants for a prepend transform:
+ * 1. Mapping group count === output line count
+ * 2. Every original source line is mapped (none dropped)
+ * 3. Mapped source lines are sequential 0..N-1
+ */
+function expectValidSourcemap(result, originalCode) {
+    const outputLineCount = result.code.split("\n").length;
+    const groups = result.map.mappings.split(";");
+    expect(groups).toHaveLength(outputLineCount);
+    const decoded = decodeMappings(result.map.mappings);
+    const originalLineCount = originalCode.split("\n").length;
+    const mappedLines = decoded.filter((line) => line !== null);
+    expect(mappedLines).toHaveLength(originalLineCount);
+    mappedLines.forEach((sourceLine, i) => {
+        expect(sourceLine).toBe(i);
+    });
+}
+describe("sdkApiEntryPointPlugin", () => {
+    const root = "/app";
+    it("has the correct plugin name and enforce order", () => {
+        const { plugin } = createPlugin(root);
+        expect(plugin.name).toBe("sb-sdk-api-entry-point");
+        expect(plugin.enforce).toBe("pre");
+    });
+    describe("transform", () => {
+        it("prepends __setEntryPoint for a standard API file", () => {
+            const { transform } = createPlugin(root);
+            const result = transform('export default api({ name: "GetUsers" });', path.join(root, "server/apis/GetUsers/api.ts"));
+            expect(result).not.toBeNull();
+            expect(result.code).toContain('import { __setEntryPoint as __sb_set_ep } from "@superblocksteam/sdk-api";');
+            expect(result.code).toContain('__sb_set_ep("server/apis/GetUsers/api.ts");');
+            expect(result.code).toContain('export default api({ name: "GetUsers"');
+        });
+        it("prepends __setEntryPoint for a .tsx API file", () => {
+            const { transform } = createPlugin(root);
+            const result = transform("export default api({ name: 'Render' });", path.join(root, "server/apis/Render/api.tsx"));
+            expect(result).not.toBeNull();
+            expect(result.code).toContain('__sb_set_ep("server/apis/Render/api.tsx");');
+        });
+        it("skips server/apis/index.ts", () => {
+            const { transform } = createPlugin(root);
+            const result = transform("export default {};", path.join(root, "server/apis/index.ts"));
+            expect(result).toBeNull();
+        });
+        it("skips files outside server/apis/", () => {
+            const { transform } = createPlugin(root);
+            const result = transform("export default {};", path.join(root, "src/components/App.ts"));
+            expect(result).toBeNull();
+        });
+        it("skips non-.ts/.tsx files under server/apis/", () => {
+            const { transform } = createPlugin(root);
+            const result = transform("{}", path.join(root, "server/apis/GetUsers/config.json"));
+            expect(result).toBeNull();
+        });
+        it("handles nested API directories", () => {
+            const { transform } = createPlugin(root);
+            const result = transform("export default api({});", path.join(root, "server/apis/v2/GetUsers/api.ts"));
+            expect(result).not.toBeNull();
+            expect(result.code).toContain('__sb_set_ep("server/apis/v2/GetUsers/api.ts");');
+        });
+        it("preserves original code after the prepend", () => {
+            const { transform } = createPlugin(root);
+            const originalCode = [
+                'import { api, z } from "@superblocksteam/sdk-api";',
+                "export default api({",
+                '  name: "GetUsers",',
+                "  input: z.object({}),",
+                "  output: z.object({ users: z.array(z.string()) }),",
+                "  async run() { return { users: [] }; },",
+                "});",
+            ].join("\n");
+            const result = transform(originalCode, path.join(root, "server/apis/GetUsers/api.ts"));
+            expect(result).not.toBeNull();
+            expect(result.code.endsWith(originalCode)).toBe(true);
+        });
+    });
+    describe("sourcemap", () => {
+        it("returns a valid v3 sourcemap", () => {
+            const { transform } = createPlugin(root);
+            const id = path.join(root, "server/apis/GetUsers/api.ts");
+            const result = transform("export default api({});", id);
+            expect(result).not.toBeNull();
+            expect(result.map.version).toBe(3);
+            expect(result.map.file).toBe(id);
+            expect(result.map.sources).toEqual([id]);
+        });
+        it("includes the original source in sourcesContent", () => {
+            const { transform } = createPlugin(root);
+            const originalCode = 'export default api({ name: "Foo" });';
+            const result = transform(originalCode, path.join(root, "server/apis/Foo/api.ts"));
+            expect(result).not.toBeNull();
+            expect(result.map.sourcesContent).toEqual([originalCode]);
+        });
+        it("maps prepended lines to nothing and original lines 1:1", () => {
+            const { transform } = createPlugin(root);
+            const originalCode = ["line1", "line2", "line3"].join("\n");
+            const result = transform(originalCode, path.join(root, "server/apis/Test/api.ts"));
+            expect(result).not.toBeNull();
+            expectValidSourcemap(result, originalCode);
+            const decoded = decodeMappings(result.map.mappings);
+            expect(decoded).toEqual([null, null, 0, 1, 2]);
+        });
+        it("handles single-line source files", () => {
+            const { transform } = createPlugin(root);
+            const originalCode = "export default api({});";
+            const result = transform(originalCode, path.join(root, "server/apis/One/api.ts"));
+            expect(result).not.toBeNull();
+            expectValidSourcemap(result, originalCode);
+            const decoded = decodeMappings(result.map.mappings);
+            expect(decoded).toEqual([null, null, 0]);
+        });
+        it.each([1, 2, 3, 7, 20])("mapping group count equals output line count for %i-line source", (lineCount) => {
+            const { transform } = createPlugin(root);
+            const originalCode = Array.from({ length: lineCount }, (_, i) => `const x${i} = ${i};`).join("\n");
+            const result = transform(originalCode, path.join(root, "server/apis/Sized/api.ts"));
+            expect(result).not.toBeNull();
+            expectValidSourcemap(result, originalCode);
+        });
+    });
+});
+//# sourceMappingURL=vite-plugin-sdk-api-entry-point.test.mjs.map

package/dist/vite-plugin-sdk-api-entry-point.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin-sdk-api-entry-point.test.mjs","sourceRoot":"","sources":["../src/vite-plugin-sdk-api-entry-point.test.mts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAc/E,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,SAGL,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,SAAS,GACb,kEAAkE,CAAC;AAErE,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC;QAC/B,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;YACf,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACpD,KAAK,GAAG,CAAC,CAAC;YACV,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACvC,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACvB,iBAAiB,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/B,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAC3B,MAAoC,EACpC,YAAoB;IAEpB,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE9C,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,iBAAiB,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE5E,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACpD,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC;IAEpB,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,2CAA2C,EAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAC/C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,4EAA4E,CAC7E,CAAC;YACF,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,6CAA6C,CAC9C,CAAC;YACF,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,yCAAyC,EACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAC9C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,4CAA4C,CAC7C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,oBAAoB,EACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,sBAAsB,CAAC,CACxC,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,oBAAoB,EACpB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,CACzC,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,IAAI,EACJ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,kCAAkC,CAAC,CACpD,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,MAAM,GAAG,SAAS,CACtB,yBAAyB,EACzB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAClD,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,CAAC,SAAS,CAC5B,gDAAgD,CACjD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG;gBACnB,oDAAoD;gBACpD,sBAAsB;gBACtB,qBAAqB;gBACrB,wBAAwB;gBACxB,qDAAqD;gBACrD,0CAA0C;gBAC1C,KAAK;aACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAC/C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;YAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;YAExD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClC,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,sCAAsC,CAAC;YAC5D,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAC1C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,MAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;YAChE,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAC3C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,oBAAoB,CAAC,MAAO,EAAE,YAAY,CAAC,CAAC;YAE5C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,yBAAyB,CAAC;YAC/C,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAC1C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,oBAAoB,CAAC,MAAO,EAAE,YAAY,CAAC,CAAC;YAE5C,MAAM,OAAO,GAAG,cAAc,CAAC,MAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CACvB,iEAAiE,EACjE,CAAC,SAAS,EAAE,EAAE;YACZ,MAAM,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,EAAE,MAAM,EAAE,SAAS,EAAE,EACrB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,MAAM,MAAM,GAAG,SAAS,CACtB,YAAY,EACZ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAC5C,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC9B,oBAAoB,CAAC,MAAO,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/eslint.config.js

@@ -1,8 +1,8 @@
 import js from "@eslint/js";
 import { defineConfig } from "eslint/config";
+import prettier from "eslint-config-prettier";
 import turbo from "eslint-config-turbo/flat";
 import importPlugin from "eslint-plugin-import";
-import prettier from "eslint-plugin-prettier/recommended";
 import unicorn from "eslint-plugin-unicorn";
 import globals from "globals";
 import * as tseslint from "typescript-eslint";

package/lint-staged.config.mjs

@@ -1,5 +1,6 @@
 export default {
   "*.{js,jsx,ts,tsx,mjs,mts}":
-    "eslint --fix --max-warnings 0 --concurrency=auto",
+    "eslint --fix --max-warnings 0 --no-warn-ignored --concurrency=auto",
+  "*": "oxfmt --no-error-on-unmatched-pattern",
   "**/*.{ts,tsx,mts}": () => "pnpm typecheck",
 };

package/package.json

@@ -1,14 +1,10 @@
 {
   "name": "@superblocksteam/sdk",
-  "version": "2.0.93",
-  "type": "module",
+  "version": "2.0.94-next.0",
   "description": "Superblocks JS SDK",
   "homepage": "https://www.superblocks.com",
   "license": "Superblocks Community Software License",
-  "engines": {
-    "node": ">=24",
-    "npm": ">=10.x"
-  },
+  "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -44,7 +40,6 @@
     "jwt-decode": "^4.0.0",
     "lodash-es": "^4.17.21",
     "package-manager-detector": "^1.3.0",
-    "prettier": "^3.7.4",
     "read-pkg": "^9.0.1",
     "semver": "^7.5.4",
     "simple-git": "^3.20.0",
@@ -53,19 +48,11 @@
     "vite-tsconfig-paths": "^6.0.4",
     "winston": "^3.17.0",
     "yaml": "^2.7.1",
-    "@superblocksteam/library-shared": "2.0.93",
-    "@superblocksteam/shared": "0.9566.2",
-    "@superblocksteam/telemetry": "2.0.93",
-    "@superblocksteam/util": "2.0.93",
-    "@superblocksteam/vite-plugin-file-sync": "2.0.93"
-  },
-  "optionalDependencies": {
-    "@rollup/rollup-darwin-arm64": "^4.34.9",
-    "@rollup/rollup-darwin-x64": "^4.34.9",
-    "@rollup/rollup-linux-arm64-gnu": "^4.34.9",
-    "@rollup/rollup-linux-x64-gnu": "^4.34.9",
-    "@rollup/rollup-win32-arm64-msvc": "^4.34.9",
-    "@rollup/rollup-win32-x64-msvc": "^4.34.9"
+    "@superblocksteam/library-shared": "2.0.94-next.0",
+    "@superblocksteam/shared": "0.9567.0",
+    "@superblocksteam/telemetry": "2.0.94-next.0",
+    "@superblocksteam/util": "2.0.94-next.0",
+    "@superblocksteam/vite-plugin-file-sync": "2.0.94-next.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
@@ -80,7 +67,6 @@
     "eslint-config-prettier": "^10.1.8",
     "eslint-config-turbo": "^2.8.3",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-unicorn": "^62.0.0",
     "globals": "^17.3.0",
     "tsx": "^4.19.2",
@@ -88,6 +74,18 @@
     "typescript-eslint": "^8.54.0",
     "vitest": "^4.0.17"
   },
+  "optionalDependencies": {
+    "@rollup/rollup-darwin-arm64": "^4.34.9",
+    "@rollup/rollup-darwin-x64": "^4.34.9",
+    "@rollup/rollup-linux-arm64-gnu": "^4.34.9",
+    "@rollup/rollup-linux-x64-gnu": "^4.34.9",
+    "@rollup/rollup-win32-arm64-msvc": "^4.34.9",
+    "@rollup/rollup-win32-x64-msvc": "^4.34.9"
+  },
+  "engines": {
+    "node": ">=24",
+    "npm": ">=10.x"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },

package/src/application-build.mts

@@ -11,6 +11,7 @@ import { getLogger } from "./telemetry/logging.js";
 import { generateApiBuildManifestPlugin } from "./vite-plugin-generate-api-build-manifest.mjs";
 import { injectSuperblocksIdsPlugin } from "./vite-plugin-inject-sb-ids-transform.mjs";
 import createLucideReactImportOptimizer from "./vite-plugin-optimize-lucide-imports.js";
+import { sdkApiEntryPointPlugin } from "./vite-plugin-sdk-api-entry-point.mjs";
 
 export async function buildApplication({
   root,
@@ -114,6 +115,7 @@ async function buildWithVite({
     logLevel: "info",
     plugins: [
       tsconfigPaths(),
+      sdkApiEntryPointPlugin(root),
       injectIndexVitePlugin({ assetsCdnUrl }),
       customComponentsPlugin(),
       injectSuperblocksIdsPlugin(root),

package/src/cli-replacement/assets/git-workflows/github-superblocks-sync-workflow.test.ts

@@ -0,0 +1,60 @@
+import { describe, expect, it } from "vitest";
+import {
+  buildGithubSuperblocksSyncWorkflow,
+  buildGithubSuperblocksSyncWorkflowFromBaseUrl,
+  DEFAULT_SUPERBLOCKS_DOMAIN,
+  getSuperblocksDomainFromBaseUrl,
+} from "./github-superblocks-sync-workflow.js";
+
+describe("github-superblocks-sync-workflow asset", () => {
+  it("defaults to app.superblocks.com", () => {
+    expect(buildGithubSuperblocksSyncWorkflow()).toContain(
+      `domain: ${DEFAULT_SUPERBLOCKS_DOMAIN}`,
+    );
+  });
+
+  it("derives domain host from a valid base URL", () => {
+    expect(
+      getSuperblocksDomainFromBaseUrl("https://example.superblocks.com"),
+    ).toBe("example.superblocks.com");
+  });
+
+  it("preserves port in derived domain host", () => {
+    expect(
+      getSuperblocksDomainFromBaseUrl("https://example.superblocks.com:8443"),
+    ).toBe("example.superblocks.com:8443");
+  });
+
+  it("falls back to default domain for invalid base URL", () => {
+    expect(getSuperblocksDomainFromBaseUrl("not-a-url")).toBe(
+      DEFAULT_SUPERBLOCKS_DOMAIN,
+    );
+  });
+
+  it("builds workflow with domain derived from base URL", () => {
+    const workflow = buildGithubSuperblocksSyncWorkflowFromBaseUrl(
+      "https://app.superblocks.com",
+    );
+    expect(workflow).toContain("name: Sync changes to Superblocks");
+    expect(workflow).toContain("domain: app.superblocks.com");
+    expect(workflow).toContain("uses: superblocksteam/sync-action@v1");
+  });
+
+  it("derives production domain correctly", () => {
+    expect(getSuperblocksDomainFromBaseUrl("https://app.superblocks.com")).toBe(
+      "app.superblocks.com",
+    );
+  });
+
+  it("derives staging domain correctly", () => {
+    expect(
+      getSuperblocksDomainFromBaseUrl("https://staging.superblockshq.com"),
+    ).toBe("staging.superblockshq.com");
+  });
+
+  it("derives preview domain correctly", () => {
+    expect(
+      getSuperblocksDomainFromBaseUrl("https://pr-15000.superblocks.dev"),
+    ).toBe("pr-15000.superblocks.dev");
+  });
+});

package/src/cli-replacement/assets/git-workflows/github-superblocks-sync-workflow.ts

@@ -0,0 +1,70 @@
+export const DEFAULT_SUPERBLOCKS_DOMAIN = "app.superblocks.com";
+
+export function buildGithubSuperblocksSyncWorkflow(
+  domain: string = DEFAULT_SUPERBLOCKS_DOMAIN,
+): string {
+  return `name: Sync changes to Superblocks
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  superblocks-sync:
+    runs-on: ubuntu-latest
+    name: Sync to Superblocks
+    permissions:
+      contents: read
+      packages: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      # Optional: needed only if the CLI version is private in GitHub Packages.
+      - name: Setup npm credentials
+        env:
+          NPM_AUTH_TOKEN: \${{ secrets.NPM_AUTH_TOKEN }}
+        run: |
+          if [ -n "$NPM_AUTH_TOKEN" ]; then
+            echo "@superblocksteam:registry=https://npm.pkg.github.com" >> .npmrc
+            echo "always-auth=true" >> .npmrc
+            echo "//npm.pkg.github.com/:_authToken=$NPM_AUTH_TOKEN" >> .npmrc
+          fi
+
+      - name: Sync
+        uses: superblocksteam/sync-action@v1
+        env:
+          NPM_CONFIG_USERCONFIG: \${{ github.workspace }}/.npmrc
+        with:
+          token: \${{ secrets.SUPERBLOCKS_TOKEN }}
+          domain: ${domain}
+          path: .
+          sha: \${{ github.sha }}
+`;
+}
+
+export function getSuperblocksDomainFromBaseUrl(
+  superblocksBaseUrl: string,
+): string {
+  const trimmed = superblocksBaseUrl.trim();
+  if (!trimmed) {
+    return DEFAULT_SUPERBLOCKS_DOMAIN;
+  }
+  try {
+    return new URL(trimmed).host || DEFAULT_SUPERBLOCKS_DOMAIN;
+  } catch {
+    return DEFAULT_SUPERBLOCKS_DOMAIN;
+  }
+}
+
+export function buildGithubSuperblocksSyncWorkflowFromBaseUrl(
+  superblocksBaseUrl: string,
+): string {
+  return buildGithubSuperblocksSyncWorkflow(
+    getSuperblocksDomainFromBaseUrl(superblocksBaseUrl),
+  );
+}