revine 1.0.6 → 1.1.1

package/dist/client.d.ts

@@ -5,4 +5,5 @@ export { NavLink } from "./components/NavLink.js";
 export { defineConfig } from "./runtime/defineConfig.js";
 export type { LayoutProps } from "./runtime/types.js";
 export type { LinkProps } from "./components/Link.js";
+export { env, envAll } from "./runtime/env.js";
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,cAAc,EACd,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,cAAc,EACd,WAAW,EACX,WAAW,EACX,SAAS,EACT,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/client.js

@@ -2,3 +2,4 @@ export { Outlet, RouterProvider, useLocation, useNavigate, useParams, useSearchP
 export { Link } from "./components/Link.js";
 export { NavLink } from "./components/NavLink.js";
 export { defineConfig } from "./runtime/defineConfig.js";
+export { env, envAll } from "./runtime/env.js";

package/dist/runtime/bundler/defaults/vite.d.ts

@@ -1,6 +1,7 @@
 export declare const defaultViteConfig: {
     plugins: any[];
     logLevel: string;
+    envPrefix: string;
     server: {
         clearScreen: boolean;
         open: boolean;

package/dist/runtime/bundler/defaults/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bundler/defaults/vite.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAa7B,CAAC"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../../../../src/runtime/bundler/defaults/vite.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;CAgB7B,CAAC"}

package/dist/runtime/bundler/defaults/vite.js

@@ -4,6 +4,9 @@ import { revineLoggerPlugin } from "../viteLoggerPlugin.js";
 export const defaultViteConfig = {
     plugins: [react(), revinePlugin(), revineLoggerPlugin()],
     logLevel: "silent",
+    // Only expose env variables prefixed with REVINE_PUBLIC_ to the browser bundle.
+    // Variables without this prefix are never included in client-side code.
+    envPrefix: "REVINE_PUBLIC_",
     server: {
         clearScreen: false,
         open: false,

package/dist/runtime/bundler/generateConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateConfig.d.ts","sourceRoot":"","sources":["../../../src/runtime/bundler/generateConfig.ts"],"names":[],"mappings":"AAUA,wBAAsB,wBAAwB,iBAyB7C"}
+{"version":3,"file":"generateConfig.d.ts","sourceRoot":"","sources":["../../../src/runtime/bundler/generateConfig.ts"],"names":[],"mappings":"AA8CA,wBAAsB,wBAAwB,iBAiC7C"}

package/dist/runtime/bundler/generateConfig.js

@@ -1,16 +1,54 @@
+import dotenv from "dotenv";
+import fs from "fs-extra";
 import { merge } from "lodash-es";
 import path from "path";
-import fs from "fs-extra";
 import { defaultViteConfig } from "./defaults/vite.js";
 import { loadUserConfig } from "./utils/loadUserConfig.js";
+/**
+ * Reads all .env files in the project root and returns a Vite `define` map
+ * that replaces `process.env.REVINE_PUBLIC_*` with the actual string values
+ * at build/dev time — exactly like Next.js does with process.env.
+ *
+ * Only REVINE_PUBLIC_ prefixed variables are exposed to the browser bundle.
+ * All other variables are ignored for safety.
+ */
+function buildProcessEnvDefines(cwd) {
+    const defines = {};
+    // Load .env, .env.local, .env.development / .env.production in priority order
+    const envFiles = [
+        ".env",
+        ".env.local",
+        `.env.${process.env.NODE_ENV || "development"}`,
+        `.env.${process.env.NODE_ENV || "development"}.local`,
+    ];
+    for (const file of envFiles) {
+        const filePath = path.resolve(cwd, file);
+        if (fs.existsSync(filePath)) {
+            const parsed = dotenv.parse(fs.readFileSync(filePath));
+            for (const [key, value] of Object.entries(parsed)) {
+                if (key.startsWith("REVINE_PUBLIC_")) {
+                    // Replace process.env.REVINE_PUBLIC_FOO with the literal string value
+                    defines[`process.env.${key}`] = JSON.stringify(value);
+                }
+            }
+        }
+    }
+    return defines;
+}
 export async function generateRevineViteConfig() {
+    const cwd = process.cwd();
     // Load the user's revine.config.ts
     const userConfig = (await loadUserConfig());
     // Merge user "vite" overrides with your default config
     const finalConfig = merge({}, defaultViteConfig, userConfig.vite || {});
+    // Inject process.env.REVINE_PUBLIC_* defines so users can write:
+    //   const token = process.env.REVINE_PUBLIC_GITHUB_TOKEN;
+    // These are statically replaced at build time — nothing leaks to the bundle.
+    const processEnvDefines = buildProcessEnvDefines(cwd);
+    finalConfig.define = merge({}, processEnvDefines, finalConfig.define || {});
     // Dynamically add Tailwind if present in the project
     try {
-        const projectPkgPath = path.resolve(process.cwd(), "package.json");
+        const projectPkgPath = path.resolve(cwd, "package.json");
         const pkg = await fs.readJson(projectPkgPath);
         const hasTailwind = pkg.devDependencies?.["@tailwindcss/vite"] ||
             pkg.dependencies?.["@tailwindcss/vite"];

package/dist/runtime/env.d.ts

@@ -0,0 +1,20 @@
+/**
+ * env() — Revine's typed helper for accessing public environment variables.
+ *
+ * Usage:
+ *   import { env } from "revine";
+ *   const token = env("REVINE_PUBLIC_GITHUB_TOKEN");
+ *
+ * Rules:
+ *   - Variables MUST be prefixed with REVINE_PUBLIC_ to be exposed to the browser.
+ *   - Variables without this prefix are never included in the client bundle.
+ *   - Values are replaced at build time by Vite (static string replacement).
+ *   - Never use import.meta.env directly — always use this helper.
+ */
+export declare function env(key: string): string | undefined;
+/**
+ * All public env variables as a typed object.
+ * Keys are the full variable names including the REVINE_PUBLIC_ prefix.
+ */
+export declare function envAll(): Record<string, string | undefined>;
+//# sourceMappingURL=env.d.ts.map

package/dist/runtime/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/runtime/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnD;AAED;;;GAGG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAQ3D"}

package/dist/runtime/env.js

@@ -0,0 +1,29 @@
+/**
+ * env() — Revine's typed helper for accessing public environment variables.
+ *
+ * Usage:
+ *   import { env } from "revine";
+ *   const token = env("REVINE_PUBLIC_GITHUB_TOKEN");
+ *
+ * Rules:
+ *   - Variables MUST be prefixed with REVINE_PUBLIC_ to be exposed to the browser.
+ *   - Variables without this prefix are never included in the client bundle.
+ *   - Values are replaced at build time by Vite (static string replacement).
+ *   - Never use import.meta.env directly — always use this helper.
+ */
+export function env(key) {
+    return import.meta.env[key];
+}
+/**
+ * All public env variables as a typed object.
+ * Keys are the full variable names including the REVINE_PUBLIC_ prefix.
+ */
+export function envAll() {
+    const all = {};
+    for (const [key, value] of Object.entries(import.meta.env)) {
+        if (key.startsWith("REVINE_PUBLIC_")) {
+            all[key] = value;
+        }
+    }
+    return all;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "revine",
-  "version": "1.0.6",
+  "version": "1.1.1",
   "description": "A react framework, but better.",
   "license": "MIT",
   "author": "Rachit Bharadwaj",
@@ -29,6 +29,7 @@
     "@vitejs/plugin-react": "^4.2.1",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
+    "dotenv": "^16.4.5",
     "fs-extra": "^11.3.0",
     "inquirer": "^12.4.1",
     "lodash-es": "^4.17.21",
@@ -39,6 +40,7 @@
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.2.0",
+    "@types/dotenv": "^8.2.3",
     "@types/fs-extra": "^11.0.4",
     "@types/lodash-es": "^4.17.9",
     "@types/node": "^22.13.0",

package/src/client.ts

@@ -11,4 +11,5 @@ export { Link } from "./components/Link.js";
 export { NavLink } from "./components/NavLink.js";
 export { defineConfig } from "./runtime/defineConfig.js";
 export type { LayoutProps } from "./runtime/types.js";
-export type { LinkProps } from "./components/Link.js";
+export type { LinkProps } from "./components/Link.js";
+export { env, envAll } from "./runtime/env.js";

package/src/runtime/bundler/defaults/vite.ts

@@ -5,6 +5,9 @@ import { revineLoggerPlugin } from "../viteLoggerPlugin.js";
 export const defaultViteConfig = {
   plugins: [react(), revinePlugin(), revineLoggerPlugin()],
   logLevel: "silent",
+  // Only expose env variables prefixed with REVINE_PUBLIC_ to the browser bundle.
+  // Variables without this prefix are never included in client-side code.
+  envPrefix: "REVINE_PUBLIC_",
   server: {
     clearScreen: false,
     open: false,

package/src/runtime/bundler/generateConfig.ts

@@ -1,6 +1,7 @@
+import dotenv from "dotenv";
+import fs from "fs-extra";
 import { merge } from "lodash-es";
 import path from "path";
-import fs from "fs-extra";
 import { defaultViteConfig } from "./defaults/vite.js";
 import { loadUserConfig } from "./utils/loadUserConfig.js";
 
@@ -8,16 +9,59 @@ interface UserConfig {
   vite?: Record<string, unknown>;
 }
 
+/**
+ * Reads all .env files in the project root and returns a Vite `define` map
+ * that replaces `process.env.REVINE_PUBLIC_*` with the actual string values
+ * at build/dev time — exactly like Next.js does with process.env.
+ *
+ * Only REVINE_PUBLIC_ prefixed variables are exposed to the browser bundle.
+ * All other variables are ignored for safety.
+ */
+function buildProcessEnvDefines(cwd: string): Record<string, string> {
+  const defines: Record<string, string> = {};
+
+  // Load .env, .env.local, .env.development / .env.production in priority order
+  const envFiles = [
+    ".env",
+    ".env.local",
+    `.env.${process.env.NODE_ENV || "development"}`,
+    `.env.${process.env.NODE_ENV || "development"}.local`,
+  ];
+
+  for (const file of envFiles) {
+    const filePath = path.resolve(cwd, file);
+    if (fs.existsSync(filePath)) {
+      const parsed = dotenv.parse(fs.readFileSync(filePath));
+      for (const [key, value] of Object.entries(parsed)) {
+        if (key.startsWith("REVINE_PUBLIC_")) {
+          // Replace process.env.REVINE_PUBLIC_FOO with the literal string value
+          defines[`process.env.${key}`] = JSON.stringify(value);
+        }
+      }
+    }
+  }
+
+  return defines;
+}
+
 export async function generateRevineViteConfig() {
+  const cwd = process.cwd();
+
   // Load the user's revine.config.ts
   const userConfig = (await loadUserConfig()) as UserConfig;
 
   // Merge user "vite" overrides with your default config
   const finalConfig = merge({}, defaultViteConfig, userConfig.vite || {});
 
+  // Inject process.env.REVINE_PUBLIC_* defines so users can write:
+  //   const token = process.env.REVINE_PUBLIC_GITHUB_TOKEN;
+  // These are statically replaced at build time — nothing leaks to the bundle.
+  const processEnvDefines = buildProcessEnvDefines(cwd);
+  finalConfig.define = merge({}, processEnvDefines, finalConfig.define || {});
+
   // Dynamically add Tailwind if present in the project
   try {
-    const projectPkgPath = path.resolve(process.cwd(), "package.json");
+    const projectPkgPath = path.resolve(cwd, "package.json");
     const pkg = await fs.readJson(projectPkgPath);
     const hasTailwind =
       pkg.devDependencies?.["@tailwindcss/vite"] ||

package/src/runtime/env.ts

@@ -0,0 +1,30 @@
+/**
+ * env() — Revine's typed helper for accessing public environment variables.
+ *
+ * Usage:
+ *   import { env } from "revine";
+ *   const token = env("REVINE_PUBLIC_GITHUB_TOKEN");
+ *
+ * Rules:
+ *   - Variables MUST be prefixed with REVINE_PUBLIC_ to be exposed to the browser.
+ *   - Variables without this prefix are never included in the client bundle.
+ *   - Values are replaced at build time by Vite (static string replacement).
+ *   - Never use import.meta.env directly — always use this helper.
+ */
+export function env(key: string): string | undefined {
+  return (import.meta.env as Record<string, string | undefined>)[key];
+}
+
+/**
+ * All public env variables as a typed object.
+ * Keys are the full variable names including the REVINE_PUBLIC_ prefix.
+ */
+export function envAll(): Record<string, string | undefined> {
+  const all: Record<string, string | undefined> = {};
+  for (const [key, value] of Object.entries(import.meta.env)) {
+    if (key.startsWith("REVINE_PUBLIC_")) {
+      all[key] = value as string | undefined;
+    }
+  }
+  return all;
+}

package/template/.env.example

@@ -0,0 +1,10 @@
+# Public environment variables — exposed to the browser bundle.
+# Variables MUST be prefixed with REVINE_PUBLIC_ to be accessible in your app.
+# Copy this file to .env and fill in your values.
+
+# Example:
+# REVINE_PUBLIC_API_URL=https://api.example.com
+# REVINE_PUBLIC_APP_NAME=My Revine App
+
+# ⚠️  Variables WITHOUT the REVINE_PUBLIC_ prefix are NEVER sent to the browser.
+# Use those for server-side secrets only (they stay in Node processes).

package/template/src/vite-env.d.ts

@@ -1,2 +1,21 @@
 /// <reference types="vite/client" />
 /// <reference types="revine/routing" />
+
+/**
+ * Augment ImportMetaEnv so TypeScript knows about your REVINE_PUBLIC_ variables.
+ *
+ * Add your own variables here:
+ *
+ * interface ImportMetaEnv {
+ *   readonly REVINE_PUBLIC_API_URL: string;
+ *   readonly REVINE_PUBLIC_GITHUB_TOKEN: string;
+ * }
+ */
+interface ImportMetaEnv {
+  // Add your REVINE_PUBLIC_ variables here
+  [key: `REVINE_PUBLIC_${string}`]: string | undefined;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}