@vezham/env 26.0.0-alpha.5 → 26.0.0-alpha.7

package/README.md

@@ -1 +1,20 @@
 # @vezham/env
+
+Validated app environment settings with Vite and Next.js adapters.
+
+## Vite environment handling
+
+The Vite adapter must use the consuming app's environment. Resolving
+`import.meta.env` during the package build would bake the package's build
+environment into the published JavaScript.
+
+The `vezham:consumer-env` plugin in `vite.config.ts` preserves that expression:
+
+1. Its early `transform` hook replaces `import.meta.env` with the temporary
+   `__VEZHAM_CONSUMER_ENV__` identifier, only in `src/lib/vite/env.ts`.
+2. Its `renderChunk` hook restores `import.meta.env` in the emitted JavaScript.
+3. The consuming app's Vite dev server or build supplies its own environment
+   values, including `MODE` and `V_APP_ID`.
+
+The placeholder is internal to the package build; consumers do not configure it.
+The plugin adds no browser runtime overhead.

package/dist/lib/base.d.ts

@@ -0,0 +1,26 @@
+export type BaseApiMode = 'api' | 'mock' | 'local';
+type Props = {
+    MODE?: string;
+    V_APP_ENV?: string;
+    V_RELEASE_CHANNEL?: string;
+    V_APP_ID?: string;
+    V_APP_NAME?: string;
+    V_APP_VER?: string;
+    V_IS_DEBUG?: string;
+    V_BASE_API_MODE?: BaseApiMode;
+    V_MOCK_LOCAL_API_URL?: string;
+    V_MOCK_API_URL?: string;
+    V_APP_API_URL?: string;
+};
+export declare const createEnv: (__ENV__: Props) => {
+    __DEV__: boolean;
+    __PRODUCTION__: boolean;
+    APP_ENV: "local" | "dev" | "qa" | "preview" | "production";
+    RELEASE_CHANNEL: "canary" | "beta" | "stable";
+    APP_ID: string;
+    APP_NAME: string;
+    APP_VER: string;
+    __DEBUG__: boolean;
+};
+export {};
+//# sourceMappingURL=base.d.ts.map

package/dist/lib/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/lib/base.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;AAOlD,KAAK,KAAK,GAAG;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,eAAe,CAAC,EAAE,WAAW,CAAA;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAuBD,eAAO,MAAM,SAAS,GAAI,SAAS,KAAK;;;;;;;;;CA8CvC,CAAA"}

package/dist/lib/base.js

@@ -0,0 +1,45 @@
+//#region src/lib/base.ts
+var environments = [
+	"local",
+	"dev",
+	"qa",
+	"preview",
+	"production"
+];
+var releaseChannels = [
+	"canary",
+	"beta",
+	"stable"
+];
+var parseSetting = (name, value, allowed) => {
+	const setting = allowed.find((option) => option === value);
+	if (setting === void 0) throw new Error(`${name} must be one of: ${allowed.join(", ")}`);
+	return setting;
+};
+var requireSetting = (name, value) => {
+	if (value === void 0 || value.trim() === "") throw new Error(`${name} is required`);
+	return value;
+};
+var createEnv = (__ENV__) => {
+	const __DEV__ = __ENV__.MODE === "development";
+	const __PRODUCTION__ = __ENV__.MODE === "production";
+	const APP_ENV = parseSetting("V_APP_ENV", __ENV__.V_APP_ENV || "local", environments);
+	const RELEASE_CHANNEL = parseSetting("V_RELEASE_CHANNEL", __ENV__.V_RELEASE_CHANNEL || "stable", releaseChannels);
+	const APP_ID = requireSetting("V_APP_ID", __ENV__.V_APP_ID);
+	const APP_NAME = requireSetting("V_APP_NAME", __ENV__.V_APP_NAME);
+	const APP_VER = requireSetting("V_APP_VER", __ENV__.V_APP_VER);
+	const __DEBUG__ = __ENV__.V_IS_DEBUG === "true";
+	if (__DEV__ && __DEBUG__) console.table(__ENV__);
+	return {
+		__DEV__,
+		__PRODUCTION__,
+		APP_ENV,
+		RELEASE_CHANNEL,
+		APP_ID,
+		APP_NAME,
+		APP_VER,
+		__DEBUG__
+	};
+};
+//#endregion
+export { createEnv };

package/dist/lib/next/env.d.ts

@@ -0,0 +1,15 @@
+import { type BaseApiMode } from '../base';
+export declare const configEnv: {
+    MODE: string | undefined;
+    V_APP_ENV: string | undefined;
+    V_RELEASE_CHANNEL: string | undefined;
+    V_APP_ID: string | undefined;
+    V_APP_NAME: string | undefined;
+    V_APP_VER: string | undefined;
+    V_IS_DEBUG: string | undefined;
+    V_BASE_API_MODE: BaseApiMode;
+    V_MOCK_LOCAL_API_URL: string | undefined;
+    V_MOCK_API_URL: string | undefined;
+    V_APP_API_URL: string | undefined;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/lib/next/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/lib/next/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,eAAO,MAAM,SAAS;;;;;;;;qBAW4B,WAAW;;;;CAI5D,CAAA"}

package/dist/lib/next/env.js

@@ -0,0 +1,16 @@
+//#region src/lib/next/env.ts
+var configEnv = {
+	MODE: process.env.NODE_ENV,
+	V_APP_ENV: process.env.V_APP_ENV,
+	V_RELEASE_CHANNEL: process.env.V_RELEASE_CHANNEL,
+	V_APP_ID: process.env.V_APP_ID,
+	V_APP_NAME: process.env.V_APP_NAME,
+	V_APP_VER: process.env.V_APP_VER,
+	V_IS_DEBUG: process.env.V_IS_DEBUG,
+	V_BASE_API_MODE: process.env.V_BASE_API_MODE,
+	V_MOCK_LOCAL_API_URL: process.env.V_MOCK_LOCAL_API_URL,
+	V_MOCK_API_URL: process.env.V_MOCK_API_URL,
+	V_APP_API_URL: process.env.V_APP_API_URL
+};
+//#endregion
+export { configEnv };

package/dist/lib/next/index.d.ts

@@ -0,0 +1,4 @@
+import { configEnv } from './env';
+export { configEnv };
+export declare const __DEV__: boolean, __PRODUCTION__: boolean, APP_ENV: "local" | "dev" | "qa" | "preview" | "production", RELEASE_CHANNEL: "canary" | "beta" | "stable", APP_ID: string, APP_NAME: string, APP_VER: string, __DEBUG__: boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/next/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGjC,OAAO,EAAE,SAAS,EAAE,CAAA;AAIpB,eAAO,MACL,OAAO,WACP,cAAc,WACd,OAAO,qDACP,eAAe,gCAEf,MAAM,UACN,QAAQ,UACR,OAAO,UAEP,SAAS,SAGA,CAAA"}

package/dist/lib/next/index.js

@@ -0,0 +1,5 @@
+import { createEnv } from "../base.js";
+import { configEnv } from "./env.js";
+var { __DEV__, __PRODUCTION__, APP_ENV, RELEASE_CHANNEL, APP_ID, APP_NAME, APP_VER, __DEBUG__ } = createEnv(configEnv);
+//#endregion
+export { APP_ENV, APP_ID, APP_NAME, APP_VER, RELEASE_CHANNEL, __DEBUG__, __DEV__, __PRODUCTION__, configEnv };

package/dist/lib/vite/env.d.ts

@@ -0,0 +1,2 @@
+export declare const configEnv: ImportMetaEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/lib/vite/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/lib/vite/env.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,eAAkB,CAAA"}

package/dist/lib/vite/env.js

@@ -0,0 +1,4 @@
+//#region src/lib/vite/env.ts
+var configEnv = import.meta.env;
+//#endregion
+export { configEnv };

package/dist/lib/vite/index.d.ts

@@ -0,0 +1,2 @@
+export declare const __DEV__: boolean, __PRODUCTION__: boolean, APP_ENV: "local" | "dev" | "qa" | "preview" | "production", RELEASE_CHANNEL: "canary" | "beta" | "stable", APP_ID: string, APP_NAME: string, APP_VER: string, __DEBUG__: boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/vite/index.ts"],"names":[],"mappings":"AAKA,eAAO,MACL,OAAO,WACP,cAAc,WACd,OAAO,qDACP,eAAe,gCAEf,MAAM,UACN,QAAQ,UACR,OAAO,UAEP,SAAS,SAGA,CAAA"}

package/dist/lib/vite/index.js

@@ -0,0 +1,5 @@
+import { createEnv } from "../base.js";
+import { configEnv } from "./env.js";
+var { __DEV__, __PRODUCTION__, APP_ENV, RELEASE_CHANNEL, APP_ID, APP_NAME, APP_VER, __DEBUG__ } = createEnv(configEnv);
+//#endregion
+export { APP_ENV, APP_ID, APP_NAME, APP_VER, RELEASE_CHANNEL, __DEBUG__, __DEV__, __PRODUCTION__ };

package/package.json

@@ -1,13 +1,32 @@
 {
   "name": "@vezham/env",
-  "version": "26.0.0-alpha.5",
+  "version": "26.0.0-alpha.7",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vezham/vx-fe-pkgs.git",
     "directory": "packages/core/env"
   },
+  "sideEffects": true,
   "type": "module",
   "exports": {
+    "./vite": {
+      "@vx/fe-kit": "./src/lib/vite/index.ts",
+      "types": "./dist/lib/vite/index.d.ts",
+      "import": "./dist/lib/vite/index.js",
+      "default": "./dist/lib/vite/index.js"
+    },
+    "./next/config": {
+      "@vx/fe-kit": "./src/lib/next/env.ts",
+      "types": "./dist/lib/next/env.d.ts",
+      "import": "./dist/lib/next/env.js",
+      "default": "./dist/lib/next/env.js"
+    },
+    "./next": {
+      "@vx/fe-kit": "./src/lib/next/index.ts",
+      "types": "./dist/lib/next/index.d.ts",
+      "import": "./dist/lib/next/index.js",
+      "default": "./dist/lib/next/index.js"
+    },
     ".": {
       "@vx/fe-kit": "./src/index.ts",
       "types": "./dist/index.d.ts",