@primate/go 0.2.0 → 0.4.0

package/lib/private/Default.d.ts

@@ -2,6 +2,6 @@ import Runtime from "#Runtime";
 import type BuildApp from "@primate/core/BuildApp";
 import type NextBuild from "@primate/core/NextBuild";
 export default class Default extends Runtime {
-    build(app: BuildApp, next: NextBuild): import("@rcompat/type/MaybePromise").default<BuildApp>;
+    build(app: BuildApp, next: NextBuild): Promise<BuildApp>;
 }
 //# sourceMappingURL=Default.d.ts.map

package/lib/private/Default.js

@@ -1,113 +1,81 @@
 import Runtime from "#Runtime";
 import AppError from "@primate/core/AppError";
+import TAG from "@primate/core/backend/TAG";
+import fail from "@primate/core/fail";
 import log from "@primate/core/log";
-import wrap from "@primate/core/route/wrap";
 import assert from "@rcompat/assert";
 import user from "@rcompat/env/user";
-import runtime from "@rcompat/runtime";
 import execute from "@rcompat/stdio/execute";
 import which from "@rcompat/stdio/which";
-const command = await which("go");
-const env = {
+const COMMAND = await which("go");
+const ENV = {
     GOARCH: "wasm",
-    GOCACHE: (await execute(`${command} env GOCACHE`, {})).replaceAll("\n", ""),
+    GOCACHE: (await execute(`${COMMAND} env GOCACHE`, {})).replaceAll("\n", ""),
     GOOS: "js",
     HOME: user.HOME,
 };
-const run = (wasm, go) => `${command} build -o ${wasm.name} ${go.name}`;
-const js_wrapper = (path) => `
-import env from "@primate/go/env";
-import toRequest from "@primate/go/to-request";
-import to_response from "@primate/go/to-response";
-import session from "#session";
-import route from "primate/route";
-
-globalThis.PRMT_SESSION = {
-  get exists() {
-    return session.exists;
-  },
-  get id() {
-    return session.id;
-  },
-  get data() {
-    return JSON.stringify(session.try());
-  },
-  create(data) {
-    session.create(JSON.parse(data));
-  },
-  get() {
-    return JSON.stringify(session.get());
-  },
-  try() {
-    return JSON.stringify(session.try());
-  },
-  set(data) {
-    session.set(JSON.parse(data));
-  },
-  destroy() {
-    session.destroy();
-  },
-};
-
-${runtime === "bun"
-    ? `import route_path from "${path}" with { type: "file" };
-const go_route = await Bun.file(route_path).arrayBuffer();`
-    :
-        `import FileRef from "primate/runtime/FileRef";
-
-const buffer = await FileRef.arrayBuffer(import.meta.url+"/../${path}");
-const go_route = new Uint8Array(buffer);`}
-
-env();
-
-// Run Go once to register routes and get available verbs
-const go = new globalThis.Go();
-const result = await WebAssembly.instantiate(go_route, go.importObject);
-go.run(result.instance);
-
-const verbs = globalThis.__primate_verbs || [];
-
-for (const verb of verbs) {
-  route[verb.toLowerCase()](async request => {
-    const requested = await toRequest(request);
-    const freshGo = new globalThis.Go();
-    return WebAssembly.instantiate(go_route, {...freshGo.importObject}).then(freshResult => {
-      freshGo.run(freshResult.instance);
-      return to_response(globalThis.__primate_handle(verb, requested));
-    });
-  });
-}
-`;
-const go_wrapper = (code) => {
-    if (!code.includes("github.com/primate-run/go/route")) {
-        console.warn("Go file does not import \"github.com/primate-run/go/route\" - skipping route registration");
+const REPO = "github.com/primate-run/go";
+const [MAJOR, MINOR] = TAG.split(".").map(Number);
+const run = (wasm, go) => `${COMMAND} build -o ${wasm.name} ${go.name}`;
+function postlude(code, route_id) {
+    if (!code.includes(`${REPO}/route`)) {
+        log.warn("Go file does not import {0} - skipping route registration", REPO);
         return code;
     }
     return `${code}
-
-func main() {
-    route.Commit()
-    select{}
-}`;
-};
+    func main() {
+        route.Commit("${route_id}")
+        select{}
+    }`;
+}
+async function check_version() {
+    try {
+        const version = await execute(`go list -m -f '{{.Version}}' ${REPO}`);
+        const trimmed = version.trim();
+        const version_match = trimmed.match(/^v?(\d+)\.(\d+)\.(\d+)/);
+        if (!version_match)
+            throw fail("invalid version format: {0}", trimmed);
+        const [, major, minor] = version_match.map(Number);
+        if (major !== MAJOR || minor !== MINOR) {
+            throw fail("installed version {0} not in range {1}", trimmed, TAG);
+        }
+        log.info("using {0} package v{1}.{2}.x", REPO, major, minor);
+    }
+    catch (error) {
+        if (error instanceof AppError)
+            throw error;
+        throw fail("{0} dependency not found - run 'go get {0}@v{1}.0'", REPO, TAG);
+    }
+}
 export default class Default extends Runtime {
-    build(app, next) {
-        app.bind(this.fileExtension, async (route, { build, context }) => {
+    async build(app, next) {
+        await check_version();
+        app.bind(this.fileExtension, async (route, { context }) => {
             assert(context === "routes", "go: only route files are supported");
-            const code = await route.text();
-            // wrap user code with main function if they imported our route package
-            await route.write(go_wrapper(code));
-            const wasm = route.bare(".wasm");
-            const js_code = wrap(js_wrapper(wasm.name), route, build);
-            await route.append(".js").write(js_code);
+            const relative = route.debase(app.path.routes);
+            const route_id = relative.path.slice(1, -relative.extension.length);
+            // create a temporary .go file in the build directory for compilation
+            // this is necessary because `go build` requires an actual file on disk
+            const build_go_file = app.runpath("wasm", `${route_id}.go`);
+            await build_go_file.directory.create({ recursive: true });
+            await build_go_file.write(postlude(await route.text(), route_id));
+            const wasm = app.runpath("wasm", `${route_id}.wasm`);
             try {
                 log.info("compiling {0} to WebAssembly", route);
-                // compile .go to .wasm using user's go.mod from project root
-                await execute(run(wasm, route), { cwd: `${route.directory}`, env });
+                await execute(run(wasm, build_go_file), {
+                    cwd: build_go_file.directory.path,
+                    env: ENV,
+                });
             }
             catch (error) {
-                throw new AppError("Error in module {0}\n{1}", route, error);
+                throw fail("error in module {0}\n{1}", route, error);
             }
+            await build_go_file.remove();
+            return `
+        import wrapper from "@primate/go/wrapper";
+        import bytes from "app:wasm/${route_id}.wasm" with { type: "bytes" };
+        await wrapper(bytes, ${JSON.stringify(route_id)});
+      `;
         });
         return next(app);
     }

package/lib/private/to-request.d.ts

@@ -1,7 +1,7 @@
 import type RequestFacade from "@primate/core/request/RequestFacade";
 export default function toRequest(request: RequestFacade): Promise<{
     body: {
-        fieldsSync: () => string;
+        formSync: () => string;
         filesSync: () => {
             bytes: Uint8Array;
             field: string;
@@ -9,7 +9,7 @@ export default function toRequest(request: RequestFacade): Promise<{
             size: number;
             type: string;
         }[];
-        type: "fields";
+        type: "form";
     } | {
         textSync: () => string;
         type: "text";

package/lib/private/to-request.js

@@ -1,19 +1,16 @@
-async function bridgeFields(body) {
-    const fields = body.fields();
+async function bridge_form(body) {
     const meta = Object.create(null);
     const files = [];
     const pending = [];
-    for (const [k, v] of Object.entries(fields)) {
-        if (typeof v === "string") {
-            meta[k] = v;
-            continue;
-        }
-        // v is File
+    for (const [k, v] of Object.entries(body.form())) {
+        meta[k] = v;
+    }
+    for (const [k, v] of Object.entries(body.files())) {
         const name = v.name;
         const type = v.type;
         const size = v.size;
         meta[k] = { name, size, type };
-        // Precompute bytes so Go can call a SYNC getter
+        // precompute bytes so Go can call a SYNC getter
         pending.push(v.arrayBuffer().then(buffer => {
             files.push({
                 bytes: new Uint8Array(buffer),
@@ -27,9 +24,9 @@ async function bridgeFields(body) {
     await Promise.all(pending);
     const jsonStr = JSON.stringify(meta);
     return {
-        fieldsSync: () => jsonStr,
+        formSync: () => jsonStr,
         filesSync: () => files,
-        type: "fields",
+        type: "form",
     };
 }
 async function bridgeBody(body) {
@@ -44,8 +41,8 @@ async function bridgeBody(body) {
             const jsonStr = JSON.stringify(val);
             return { jsonSync: () => jsonStr, type };
         }
-        case "fields": {
-            return await bridgeFields(body);
+        case "form": {
+            return await bridge_form(body);
         }
         case "binary": {
             const blob = body.binary();

package/lib/private/to-response.d.ts

@@ -1,9 +1,4 @@
 import type ResponseLike from "@primate/core/response/ResponseLike";
-import type Dict from "@rcompat/type/Dict";
-type Handler = "error" | "redirect" | "view";
-type ResponseType = (() => {
-    handler: Handler;
-} & Dict) | string;
-declare const _default: (response: ResponseType) => ResponseLike;
+declare const _default: (response: any) => ResponseLike;
 export default _default;
 //# sourceMappingURL=to-response.d.ts.map

package/lib/private/to-response.js

@@ -1,24 +1,32 @@
 import error from "@primate/core/response/error";
 import redirect from "@primate/core/response/redirect";
 import view from "@primate/core/response/view";
-const parse = (input) => input === null ? undefined : JSON.parse(input);
-const handle_handler = (handler, response) => {
-    if (handler === "view") {
-        const { component, options, props } = response;
-        return view(component, parse(props), parse(options));
-    }
-    if (handler === "redirect") {
-        const { location, status } = response;
-        return redirect(location, status === null ? undefined : status);
-    }
-    const { options } = response;
-    return error(parse(options));
-};
+const handlers = { error, redirect, view };
+const is_handler = (handler) => typeof handler === "string" && Object.keys(handlers).includes(handler);
 export default (response) => {
-    if (typeof response === "function") {
-        const { handler, ...args } = response();
-        return handle_handler(handler, args);
+    if (typeof response === "string") {
+        try {
+            response = JSON.parse(response);
+        }
+        catch {
+            return response;
+        }
+    }
+    if (response && typeof response === "object") {
+        const handler = response.handler;
+        if (is_handler(handler)) {
+            if (handler === "view") {
+                const { component, props, options } = response;
+                return view(component, props ? JSON.parse(props) : {}, options ? JSON.parse(options) : {});
+            }
+            if (handler === "redirect") {
+                const { location, status } = response;
+                return redirect(location, status);
+            }
+            const { options } = response;
+            return error(options ? JSON.parse(options) : {});
+        }
     }
-    return JSON.parse(response);
+    return response;
 };
 //# sourceMappingURL=to-response.js.map

package/lib/private/wrapper.d.ts

@@ -0,0 +1,12 @@
+declare global {
+    var Go: {
+        new (): {
+            importObject: WebAssembly.Imports;
+            run(instance: WebAssembly.Instance): Promise<void>;
+        };
+    };
+    var PRMT_SESSION: any;
+    var __primate_go_initialized: Set<string> | undefined;
+}
+export default function wrapper(bytes: Uint8Array, routeId: string): Promise<void>;
+//# sourceMappingURL=wrapper.d.ts.map

package/lib/private/wrapper.js

@@ -0,0 +1,52 @@
+import env from "@primate/go/env";
+import toRequest from "@primate/go/to-request";
+import to_response from "@primate/go/to-response";
+import session from "primate/config/session";
+import route from "primate/route";
+export default async function wrapper(bytes, routeId) {
+    if (!globalThis.__primate_go_initialized) {
+        globalThis.__primate_go_initialized = new Set();
+    }
+    globalThis.PRMT_SESSION = {
+        get exists() { return session().exists; },
+        get id() { return session().id; },
+        get data() { return JSON.stringify(session().try()); },
+        create(data) { session().create(JSON.parse(data)); },
+        get() { return JSON.stringify(session().get()); },
+        try() { return JSON.stringify(session().try()); },
+        set(data) { session().set(JSON.parse(data)); },
+        destroy() { session().destroy(); },
+    };
+    env();
+    const safe_route_id = routeId.replace(/\//g, "_");
+    const registry_name = `__primate_go_registry_${safe_route_id}`;
+    const call_go = `__primate_call_go_${safe_route_id}`;
+    delete globalThis[registry_name];
+    delete globalThis[call_go];
+    await new Promise((resolve) => {
+        globalThis[`__primate_go_ready_${safe_route_id}`] = () => {
+            resolve();
+        };
+        const go = new globalThis.Go();
+        WebAssembly.instantiate(bytes, go.importObject).then(result => {
+            go.run(result.instance).catch(err => {
+                console.error("Go runtime error:", routeId, err);
+            });
+        });
+    });
+    const registry_fn = globalThis[registry_name];
+    const registry = registry_fn();
+    const verbs = registry?.length
+        ? Array.from({ length: registry.length }, (_, i) => registry[i])
+        : [];
+    for (const verb of verbs) {
+        route[verb.toLowerCase()](async (request) => {
+            const requested = await toRequest(request);
+            const callFn = globalThis[call_go];
+            const response = callFn(verb, requested);
+            return to_response(response);
+        });
+    }
+    globalThis.__primate_go_initialized.add(routeId);
+}
+//# sourceMappingURL=wrapper.js.map

package/lib/public/wrapper.d.ts

@@ -0,0 +1,2 @@
+export { default } from "#wrapper";
+//# sourceMappingURL=wrapper.d.ts.map

package/lib/public/wrapper.js

@@ -0,0 +1,2 @@
+export { default } from "#wrapper";
+//# sourceMappingURL=wrapper.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primate/go",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Primate Go backend",
   "homepage": "https://primate.run/docs/backend/go",
   "bugs": "https://github.com/primate-run/primate/issues",
@@ -18,15 +18,15 @@
   "dependencies": {
     "@rcompat/assert": "^0.3.1",
     "@rcompat/cli": "^0.11.3",
-    "@rcompat/env": "^0.9.0",
-    "@rcompat/fs": "^0.21.1",
+    "@rcompat/env": "^0.9.2",
+    "@rcompat/fs": "^0.22.3",
     "@rcompat/runtime": "^0.6.0",
     "@rcompat/stdio": "^0.12.2",
     "@rcompat/string": "^0.10.0",
-    "@primate/core": "^0.2.0"
+    "@primate/core": "^0.4.0"
   },
   "peerDependencies": {
-    "primate": "^0.33.0"
+    "primate": "^0.35.0"
   },
   "type": "module",
   "imports": {