revine 1.0.5 → 1.1.0

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/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/dist/runtime/routing.d.ts

@@ -1,2 +1,6 @@
+import { createBrowserRouter } from "react-router-dom";
+declare module "revine/routing" {
+    const router: ReturnType<typeof createBrowserRouter>;
+}
 export {};
 //# sourceMappingURL=routing.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/runtime/routing.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/runtime/routing.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,QAAQ,gBAAgB,CAAC;IACvB,MAAM,MAAM,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;CAC7D;AAED,OAAO,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "revine",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "A react framework, but better.",
   "license": "MIT",
   "author": "Rachit Bharadwaj",

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/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/src/runtime/routing.ts

@@ -1,4 +1,13 @@
-// This module is intentionally empty.
-// `revine/routing` is a virtual module resolved by the Revine Vite plugin at build time.
+// This module is intentionally empty at the source level.
+// `revine/routing` is a virtual module resolved by the Revine Vite plugin at build/dev time.
 // The actual router is injected via the plugin's resolveId/load hooks.
-export {};
+//
+// The type declaration below tells TypeScript that `router` exists on this module
+// so consumers don't get ts(2305) errors.
+import { createBrowserRouter } from "react-router-dom";
+
+declare module "revine/routing" {
+  export const router: ReturnType<typeof createBrowserRouter>;
+}
+
+export {};

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

@@ -0,0 +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;
+}