@buoy-gg/env 3.0.1 → 3.0.2

package/lib/commonjs/env/hooks/useDynamicEnv.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useDynamicEnv = useDynamicEnv;
 var _react = require("react");
+var _remoteEnv = require("../utils/remoteEnv");
 /**
  * Hook that returns all available environment variables with parsed values
  * Includes all available environment variables by default (only EXPO_PUBLIC_ prefixed vars are loaded by Expo)
@@ -33,11 +34,16 @@ var _react = require("react");
 function useDynamicEnv({
   envFilter = () => true // Default: include all available environment variables (EXPO_PUBLIC_ only)
 } = {}) {
+  // In remote mirror mode (desktop dashboard) env values come from the
+  // synced device instead of the local process.env
+  const envSource =
+  // @ts-ignore process.env does exist
+  (0, _remoteEnv.getRemoteEnv)() ?? process.env;
+
   // Helper function to get a single environment variable value
   const getEnvValue = (0, _react.useMemo)(() => {
     return key => {
-      // @ts-ignore thhis does exist
-      const value = process.env[key];
+      const value = envSource[key];
       if (value === undefined) {
         return null;
       }
@@ -67,21 +73,20 @@ function useDynamicEnv({
         return value;
       }
     };
-  }, []);
+  }, [envSource]);
 
   // Get all environment variables and process them
   const envResults = (0, _react.useMemo)(() => {
-    // @ts-ignore thhis does exist
-    const allEnvKeys = Object.keys(process.env);
+    const allEnvKeys = Object.keys(envSource);
     const filteredKeys = allEnvKeys.filter(key => {
-      // @ts-ignore thhis does exist
-      const value = process.env[key];
+      const value = envSource[key];
       return envFilter(key, value);
     });
     return filteredKeys.map(key => ({
       key,
       data: getEnvValue(key)
     }));
-  }, [envFilter, getEnvValue]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [envFilter, getEnvValue, envSource]);
   return envResults;
 }

package/lib/commonjs/env/utils/remoteEnv.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getRemoteEnv = getRemoteEnv;
+exports.setRemoteEnv = setRemoteEnv;
+/**
+ * Remote env override for remote mirror mode (desktop dashboard).
+ *
+ * The dashboard has no meaningful process.env of its own — the env values it
+ * shows come from the synced device. When set, useDynamicEnv reads from this
+ * map instead of process.env.
+ */
+
+let remoteEnv = null;
+
+/** Override the env source. Pass null to restore process.env. */
+function setRemoteEnv(env) {
+  remoteEnv = env;
+}
+function getRemoteEnv() {
+  return remoteEnv;
+}

package/lib/commonjs/index.js

@@ -6,7 +6,9 @@ Object.defineProperty(exports, "__esModule", {
 var _exportNames = {
   envToolPreset: true,
   createEnvTool: true,
-  EnvVarsModal: true
+  EnvVarsModal: true,
+  createEnvSyncAdapter: true,
+  setRemoteEnv: true
 };
 Object.defineProperty(exports, "EnvVarsModal", {
   enumerable: true,
@@ -14,6 +16,12 @@ Object.defineProperty(exports, "EnvVarsModal", {
     return _EnvVarsModal.EnvVarsModal;
   }
 });
+Object.defineProperty(exports, "createEnvSyncAdapter", {
+  enumerable: true,
+  get: function () {
+    return _envSyncAdapter.createEnvSyncAdapter;
+  }
+});
 Object.defineProperty(exports, "createEnvTool", {
   enumerable: true,
   get: function () {
@@ -26,8 +34,16 @@ Object.defineProperty(exports, "envToolPreset", {
     return _preset.envToolPreset;
   }
 });
+Object.defineProperty(exports, "setRemoteEnv", {
+  enumerable: true,
+  get: function () {
+    return _remoteEnv.setRemoteEnv;
+  }
+});
 var _preset = require("./preset");
 var _EnvVarsModal = require("./env/components/EnvVarsModal");
+var _envSyncAdapter = require("./sync/envSyncAdapter");
+var _remoteEnv = require("./env/utils/remoteEnv");
 var _types = require("./env/types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/lib/commonjs/sync/envSyncAdapter.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createEnvSyncAdapter = createEnvSyncAdapter;
+/** Collect the device's env vars (only EXPO_PUBLIC_-style vars exist in RN). */
+function collectEnv() {
+  const env = {};
+  // @ts-ignore process.env does exist
+  for (const [key, value] of Object.entries(process.env)) {
+    if (typeof value === "string") {
+      env[key] = value;
+    }
+  }
+  return env;
+}
+
+/**
+ * Create a sync adapter for the env tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it).
+ *
+ * Env vars are baked into the bundle, so the snapshot is static — it's sent
+ * once when a dashboard starts watching. Pass the same `requiredEnvVars`
+ * config you give FloatingDevTools so the dashboard validates against it.
+ */
+function createEnvSyncAdapter(requiredEnvVars = []) {
+  return {
+    version: 1,
+    getSnapshot: () => ({
+      env: collectEnv(),
+      requiredEnvVars
+    }),
+    // Env never changes at runtime — nothing to subscribe to
+    subscribe: () => () => {}
+  };
+}

package/lib/module/env/hooks/useDynamicEnv.js

@@ -1,6 +1,7 @@
 "use strict";
 
 import { useMemo } from "react";
+import { getRemoteEnv } from "../utils/remoteEnv";
 /**
  * Hook that returns all available environment variables with parsed values
  * Includes all available environment variables by default (only EXPO_PUBLIC_ prefixed vars are loaded by Expo)
@@ -29,11 +30,16 @@ import { useMemo } from "react";
 export function useDynamicEnv({
   envFilter = () => true // Default: include all available environment variables (EXPO_PUBLIC_ only)
 } = {}) {
+  // In remote mirror mode (desktop dashboard) env values come from the
+  // synced device instead of the local process.env
+  const envSource =
+  // @ts-ignore process.env does exist
+  getRemoteEnv() ?? process.env;
+
   // Helper function to get a single environment variable value
   const getEnvValue = useMemo(() => {
     return key => {
-      // @ts-ignore thhis does exist
-      const value = process.env[key];
+      const value = envSource[key];
       if (value === undefined) {
         return null;
       }
@@ -63,21 +69,20 @@ export function useDynamicEnv({
         return value;
       }
     };
-  }, []);
+  }, [envSource]);
 
   // Get all environment variables and process them
   const envResults = useMemo(() => {
-    // @ts-ignore thhis does exist
-    const allEnvKeys = Object.keys(process.env);
+    const allEnvKeys = Object.keys(envSource);
     const filteredKeys = allEnvKeys.filter(key => {
-      // @ts-ignore thhis does exist
-      const value = process.env[key];
+      const value = envSource[key];
       return envFilter(key, value);
     });
     return filteredKeys.map(key => ({
       key,
       data: getEnvValue(key)
     }));
-  }, [envFilter, getEnvValue]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [envFilter, getEnvValue, envSource]);
   return envResults;
 }

package/lib/module/env/utils/remoteEnv.js

@@ -0,0 +1,19 @@
+"use strict";
+
+/**
+ * Remote env override for remote mirror mode (desktop dashboard).
+ *
+ * The dashboard has no meaningful process.env of its own — the env values it
+ * shows come from the synced device. When set, useDynamicEnv reads from this
+ * map instead of process.env.
+ */
+
+let remoteEnv = null;
+
+/** Override the env source. Pass null to restore process.env. */
+export function setRemoteEnv(env) {
+  remoteEnv = env;
+}
+export function getRemoteEnv() {
+  return remoteEnv;
+}

package/lib/module/index.js

@@ -6,6 +6,12 @@ export { envToolPreset, createEnvTool } from "./preset";
 // Export main modal component
 export { EnvVarsModal } from "./env/components/EnvVarsModal";
 
+// External sync (adapter for @buoy-gg/external-sync's useExternalSync)
+export { createEnvSyncAdapter } from "./sync/envSyncAdapter";
+
+/** @internal - Remote mirror mode only (desktop dashboard). */
+export { setRemoteEnv } from "./env/utils/remoteEnv";
+
 // Export types (Environment, UserRole, RequiredEnvVar, etc.)
 export * from "./env/types";
 

package/lib/module/sync/envSyncAdapter.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/** Collect the device's env vars (only EXPO_PUBLIC_-style vars exist in RN). */
+function collectEnv() {
+  const env = {};
+  // @ts-ignore process.env does exist
+  for (const [key, value] of Object.entries(process.env)) {
+    if (typeof value === "string") {
+      env[key] = value;
+    }
+  }
+  return env;
+}
+
+/**
+ * Create a sync adapter for the env tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it).
+ *
+ * Env vars are baked into the bundle, so the snapshot is static — it's sent
+ * once when a dashboard starts watching. Pass the same `requiredEnvVars`
+ * config you give FloatingDevTools so the dashboard validates against it.
+ */
+export function createEnvSyncAdapter(requiredEnvVars = []) {
+  return {
+    version: 1,
+    getSnapshot: () => ({
+      env: collectEnv(),
+      requiredEnvVars
+    }),
+    // Env never changes at runtime — nothing to subscribe to
+    subscribe: () => () => {}
+  };
+}

package/lib/typescript/env/hooks/useDynamicEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDynamicEnv.d.ts","sourceRoot":"","sources":["../../../../src/env/hooks/useDynamicEnv.ts"],"names":[],"mappings":"AAEA,UAAU,oBAAoB;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;CACjE;AAED,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAsB,GACvB,GAAE,oBAAyB,GAAG,SAAS,EAAE,CAyDzC"}
+{"version":3,"file":"useDynamicEnv.d.ts","sourceRoot":"","sources":["../../../../src/env/hooks/useDynamicEnv.ts"],"names":[],"mappings":"AAGA,UAAU,oBAAoB;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;CACjE;AAED,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAsB,GACvB,GAAE,oBAAyB,GAAG,SAAS,EAAE,CA6DzC"}

package/lib/typescript/env/utils/remoteEnv.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Remote env override for remote mirror mode (desktop dashboard).
+ *
+ * The dashboard has no meaningful process.env of its own — the env values it
+ * shows come from the synced device. When set, useDynamicEnv reads from this
+ * map instead of process.env.
+ */
+/** Override the env source. Pass null to restore process.env. */
+export declare function setRemoteEnv(env: Record<string, string> | null): void;
+export declare function getRemoteEnv(): Record<string, string> | null;
+//# sourceMappingURL=remoteEnv.d.ts.map

package/lib/typescript/env/utils/remoteEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteEnv.d.ts","sourceRoot":"","sources":["../../../../src/env/utils/remoteEnv.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAE5D"}

package/lib/typescript/index.d.ts

@@ -1,5 +1,8 @@
 export { envToolPreset, createEnvTool } from "./preset";
 export { EnvVarsModal } from "./env/components/EnvVarsModal";
+export { createEnvSyncAdapter } from "./sync/envSyncAdapter";
+/** @internal - Remote mirror mode only (desktop dashboard). */
+export { setRemoteEnv } from "./env/utils/remoteEnv";
 export * from "./env/types";
 export * from "./env/utils";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,+DAA+D;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC"}

package/lib/typescript/sync/envSyncAdapter.d.ts

@@ -0,0 +1,19 @@
+import type { RequiredEnvVar } from "../env/types/types";
+/**
+ * Create a sync adapter for the env tool, consumed by @buoy-gg/external-sync's
+ * `useExternalSync` (structurally matches its ToolSyncAdapter interface so
+ * this package doesn't need a dependency on it).
+ *
+ * Env vars are baked into the bundle, so the snapshot is static — it's sent
+ * once when a dashboard starts watching. Pass the same `requiredEnvVars`
+ * config you give FloatingDevTools so the dashboard validates against it.
+ */
+export declare function createEnvSyncAdapter(requiredEnvVars?: RequiredEnvVar[]): {
+    version: number;
+    getSnapshot: () => {
+        env: Record<string, string>;
+        requiredEnvVars: RequiredEnvVar[];
+    };
+    subscribe: () => () => void;
+};
+//# sourceMappingURL=envSyncAdapter.d.ts.map

package/lib/typescript/sync/envSyncAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envSyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/envSyncAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAczD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,GAAE,cAAc,EAAO;;;;;;;EAU1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/env",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Environment variables dev tooling",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -26,8 +26,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/floating-tools-core": "3.0.1",
-    "@buoy-gg/shared-ui": "3.0.1"
+    "@buoy-gg/floating-tools-core": "3.0.2",
+    "@buoy-gg/shared-ui": "3.0.2"
   },
   "peerDependencies": {
     "react": "*",