@nightshift-sdk/fiber-vite 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nightshift
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { Plugin } from 'vite';
+export interface FiberOptions {
+    /** Source root to scan (default "src"). */
+    root?: string;
+    /** Output file (default "src/fiber.generated.ts"). */
+    out?: string;
+    /** Override config; otherwise read from VITE_NIGHTSHIFT_* / NIGHTSHIFT_* env. */
+    baseUrl?: string;
+    org?: string;
+    token?: string;
+    /** Dev token-injecting proxy. `true` (default) mounts it at /api/nightshift;
+     *  pass `{ path }` to change the mount, or `false` to disable. */
+    proxy?: boolean | {
+        path?: string;
+    };
+    /** Publish the query manifest on `vite build`. Pass `{ appId }` or set
+     *  NIGHTSHIFT_APP_ID; uses NIGHTSHIFT_PUBLISH_TOKEN (falls back to the token). */
+    publish?: boolean | {
+        appId?: string;
+    };
+}
+export declare function fiber(options?: FiberOptions): Plugin;

package/dist/index.js

@@ -0,0 +1,135 @@
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { generate, publish } from "@nightshift-sdk/fiber-cli";
+import { createFiberProxy } from "@nightshift-sdk/fiber-proxy";
+import { loadEnv } from "vite";
+function fiber(options = {}) {
+  let cfg;
+  let rootDir;
+  let outDir;
+  let outFile;
+  let appId = "";
+  let publishToken = "";
+  let running = false;
+  let queued = false;
+  let timer;
+  return {
+    name: "fiber",
+    // Hosted apps serve under apps.nightshift.sh/<id>/, so emit relative asset
+    // URLs (./assets/…) — these work under a sub-path AND at root. Without this,
+    // Vite's default base "/" produces /assets/… which 404s when hosted. An
+    // explicit base in the user's config is respected.
+    config(userConfig) {
+      if (!userConfig.base || userConfig.base === "/") return { base: "./" };
+    },
+    configResolved(config) {
+      const env = loadEnv(config.mode, config.root, "");
+      cfg = {
+        baseUrl: options.baseUrl || env.VITE_NIGHTSHIFT_BASE_URL || env.NIGHTSHIFT_BASE_URL || "https://api.nightshift.sh",
+        org: options.org || env.VITE_NIGHTSHIFT_ORG || env.NIGHTSHIFT_ORG || "",
+        token: options.token || env.VITE_NIGHTSHIFT_TOKEN || env.NIGHTSHIFT_TOKEN || ""
+      };
+      rootDir = resolve(config.root, options.root ?? "src");
+      outDir = resolve(config.root, config.build.outDir);
+      outFile = resolve(config.root, options.out ?? "src/fiber.generated.ts");
+      appId = typeof options.publish === "object" && options.publish.appId || env.NIGHTSHIFT_APP_ID || "";
+      publishToken = env.NIGHTSHIFT_PUBLISH_TOKEN || cfg.token;
+    },
+    // Build: publish the manifest (opt-in). Only runs in `vite build`.
+    async closeBundle() {
+      if (!options.publish) return;
+      if (!appId) {
+        console.warn("[fiber] publish: set publish.appId or NIGHTSHIFT_APP_ID");
+        return;
+      }
+      if (!cfg.org || !publishToken) {
+        console.warn("[fiber] publish: set NIGHTSHIFT_ORG and a publish token");
+        return;
+      }
+      try {
+        const { version, count, url } = await publish({ ...cfg, token: publishToken }, rootDir, appId, { dist: outDir });
+        console.info(`[fiber] publish: ${count} quer${count === 1 ? "y" : "ies"} → ${appId} version ${version}${url ? ` (${url})` : ""}`);
+      } catch (e) {
+        console.error(`[fiber] publish failed: ${e.message}`);
+      }
+    },
+    configureServer(server) {
+      const log = (msg, warn = false) => server.config.logger[warn ? "warn" : "info"](`[fiber] ${msg}`);
+      if (options.proxy !== false) {
+        const mount = typeof options.proxy === "object" && options.proxy.path || "/api/nightshift";
+        const handle = createFiberProxy({
+          token: cfg.token,
+          org: cfg.org,
+          baseUrl: cfg.baseUrl,
+          mountPath: mount
+        });
+        server.middlewares.use((req, res, next) => {
+          if (!req.url || !req.url.startsWith(mount)) return next();
+          forward(handle, req, res).catch(next);
+        });
+        log(`proxy on ${mount} -> ${cfg.baseUrl}${cfg.org ? "" : " (set NIGHTSHIFT_ORG/TOKEN)"}`);
+      }
+      const run = async () => {
+        if (running) {
+          queued = true;
+          return;
+        }
+        running = true;
+        try {
+          const { content, count } = await generate(cfg, rootDir);
+          await writeFile(outFile, content);
+          log(`typegen: ${count} quer${count === 1 ? "y" : "ies"}`);
+        } catch (e) {
+          log(`typegen failed: ${e.message}`, true);
+        } finally {
+          running = false;
+          if (queued) {
+            queued = false;
+            void run();
+          }
+        }
+      };
+      const schedule = () => {
+        clearTimeout(timer);
+        timer = setTimeout(() => void run(), 300);
+      };
+      if (!cfg.org || !cfg.token) {
+        log("set NIGHTSHIFT_ORG and NIGHTSHIFT_TOKEN (server-side) to enable typegen + proxy", true);
+        return;
+      }
+      void run();
+      const onChange = (file) => {
+        if (resolve(file) === outFile) return;
+        if (/\.tsx?$/.test(file) && !file.endsWith(".generated.ts")) schedule();
+      };
+      server.watcher.on("change", onChange);
+      server.watcher.on("add", onChange);
+      server.watcher.on("unlink", onChange);
+    }
+  };
+}
+async function forward(handle, req, res) {
+  const host = req.headers.host ?? "localhost";
+  const method = req.method ?? "GET";
+  const headers = new Headers();
+  for (const [k, v] of Object.entries(req.headers)) {
+    if (typeof v === "string") headers.set(k, v);
+    else if (Array.isArray(v)) headers.set(k, v.join(", "));
+  }
+  const body = method === "GET" || method === "HEAD" ? void 0 : await readBody(req);
+  const response = await handle(new Request(`http://${host}${req.url}`, { method, headers, body }));
+  res.statusCode = response.status;
+  response.headers.forEach((value, key) => res.setHeader(key, value));
+  res.end(Buffer.from(await response.arrayBuffer()));
+}
+function readBody(req) {
+  return new Promise((resolve2, reject) => {
+    const chunks = [];
+    req.on("data", (c) => chunks.push(c));
+    req.on("end", () => resolve2(Buffer.concat(chunks).toString("utf8")));
+    req.on("error", reject);
+  });
+}
+export {
+  fiber
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@nightshift-sdk/fiber-vite",
+  "version": "0.1.0",
+  "description": "Vite plugin — regenerate Nightshift query types on dev start and on save",
+  "license": "MIT",
+  "author": "Nightshift",
+  "homepage": "https://github.com/nightshiftco/platform/tree/main/sdk/packages/fiber-vite#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nightshiftco/platform.git",
+    "directory": "sdk/packages/fiber-vite"
+  },
+  "bugs": "https://github.com/nightshiftco/platform/issues",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "vite": "^5"
+  },
+  "dependencies": {
+    "@nightshift-sdk/fiber-cli": "^0.1.0",
+    "@nightshift-sdk/fiber-proxy": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0",
+    "vite": "^5.4.0",
+    "vite-plugin-dts": "^4.2.0"
+  }
+}