@pamenv/vite 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @pamenv/vite
+
+## 0.1.0
+
+### Minor Changes
+
+- First release: Vite plugin injects PAM env in an early `config` hook (`debug`, `envPriority`).

package/README.md

@@ -1,3 +1,42 @@
-# Temporary Holding Version
+# @pamenv/vite
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在 Vite 解析配置之前，把 PAM 环境写进当前进程的 `process.env`。`dev` 脚本可以继续是 `vite`，不必再包 `pamenv run`。
+
+```bash
+pnpm add @pamenv/vite pamenv-cli
+# 或 npm i @pamenv/vite pamenv-cli
+```
+
+依赖 `pamenv-cli`（注入与登录逻辑）。项目目录需有可用的 `.pam`（与 CLI 相同）。
+
+```ts
+import { defineConfig } from 'vite';
+import pamenv from '@pamenv/vite';
+
+export default defineConfig({
+  plugins: [
+    pamenv({
+      slug: 'my-app',
+      env: 'local',
+      keepEnv: ['APP_ENV'],
+      // 默认 PAM 优先；本地临时改 .env / process 测值时用 'local'
+      // envPriority: 'local',
+      debug: process.env.PAMENV_DEBUG === '1'
+    })
+  ]
+});
+```
+
+也可用命名导出：`import { createPamenvPlugin } from '@pamenv/vite'`（与 `@pamenv/next` 同名）。
+
+Token 来自**当前项目**的 `.pam`（默认 `preferLocal: true`，不会用 `~/.pam`），不要写进配置对象。未登录时请在项目目录执行：
+
+```bash
+pamenv login --local
+```
+
+`enabled: false` 时不请求 PAM。未传 `enabled` 时只在 **`vite` / `vite dev`（serve）** 注入；`vite build` 默认跳过。需要构建期注入时设 `enabled: true`，或 `enabled: (command) => command === 'serve' || command === 'build'`。
+
+`debug` 默认 `false`；`envPriority` 默认 `remote`（与 CLI / `@pamenv/next` 相同）。
+
+`clientPublicPrefixes` 可覆盖「敏感 + 公开前缀」告警用的前缀（如 `['VITE_']`）；传 `[]` 关闭该告警。

package/dist/index.cjs

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createPamenvPlugin: () => createPamenvPlugin,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_pamenv_cli = require("pamenv-cli");
+function createPamenvPlugin(options) {
+  return {
+    name: "pamenv",
+    enforce: "pre",
+    async config(_userConfig, env) {
+      await (0, import_pamenv_cli.injectPamenvProcessEnv)({
+        ...options,
+        enabled: isEnabled(options, env)
+      });
+      return;
+    }
+  };
+}
+var index_default = createPamenvPlugin;
+function isEnabled(options, env) {
+  if (typeof options.enabled === "function") {
+    return options.enabled(env.command);
+  }
+  if (options.enabled === false) {
+    return false;
+  }
+  if (options.enabled === true) {
+    return true;
+  }
+  return env.command === "serve";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createPamenvPlugin
+});

package/dist/index.d.cts

@@ -0,0 +1,32 @@
+import { PamenvInjectOptions } from 'pamenv-cli';
+export { PamenvInjectOptions } from 'pamenv-cli';
+import { Plugin } from 'vite';
+
+/**
+ * Vite plugin that writes PAM variables onto `process.env` in an early
+ * `config` hook (before most other plugins and `loadEnv` consumers see env).
+ *
+ * Default: only runs for `vite` / `vite dev` (`command === 'serve'`).
+ * Pass `enabled: true` to also inject during `vite build`, or a function
+ * receiving Vite's command (`serve` | `build`).
+ *
+ * @example
+ * import { defineConfig } from 'vite';
+ * import pamenv from '@pamenv/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     pamenv({
+ *       slug: 'my-app',
+ *       env: 'local',
+ *       debug: process.env.PAMENV_DEBUG === '1'
+ *     })
+ *   ]
+ * });
+ *
+ * @param options - Same fields as `pamenv run <slug> -e <env>`;
+ *   `debug` / `envPriority` default false / `remote`
+ */
+declare function createPamenvPlugin(options: PamenvInjectOptions): Plugin;
+
+export { createPamenvPlugin, createPamenvPlugin as default };

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { PamenvInjectOptions } from 'pamenv-cli';
+export { PamenvInjectOptions } from 'pamenv-cli';
+import { Plugin } from 'vite';
+
+/**
+ * Vite plugin that writes PAM variables onto `process.env` in an early
+ * `config` hook (before most other plugins and `loadEnv` consumers see env).
+ *
+ * Default: only runs for `vite` / `vite dev` (`command === 'serve'`).
+ * Pass `enabled: true` to also inject during `vite build`, or a function
+ * receiving Vite's command (`serve` | `build`).
+ *
+ * @example
+ * import { defineConfig } from 'vite';
+ * import pamenv from '@pamenv/vite';
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     pamenv({
+ *       slug: 'my-app',
+ *       env: 'local',
+ *       debug: process.env.PAMENV_DEBUG === '1'
+ *     })
+ *   ]
+ * });
+ *
+ * @param options - Same fields as `pamenv run <slug> -e <env>`;
+ *   `debug` / `envPriority` default false / `remote`
+ */
+declare function createPamenvPlugin(options: PamenvInjectOptions): Plugin;
+
+export { createPamenvPlugin, createPamenvPlugin as default };

package/dist/index.js

@@ -0,0 +1,34 @@
+// src/index.ts
+import {
+  injectPamenvProcessEnv
+} from "pamenv-cli";
+function createPamenvPlugin(options) {
+  return {
+    name: "pamenv",
+    enforce: "pre",
+    async config(_userConfig, env) {
+      await injectPamenvProcessEnv({
+        ...options,
+        enabled: isEnabled(options, env)
+      });
+      return;
+    }
+  };
+}
+var index_default = createPamenvPlugin;
+function isEnabled(options, env) {
+  if (typeof options.enabled === "function") {
+    return options.enabled(env.command);
+  }
+  if (options.enabled === false) {
+    return false;
+  }
+  if (options.enabled === true) {
+    return true;
+  }
+  return env.command === "serve";
+}
+export {
+  createPamenvPlugin,
+  index_default as default
+};

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@pamenv/vite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "private": false,
+  "description": "Vite plugin: load PAM env into process.env before Vite resolves config",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "type-check": "tsc --build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qlover/brain-toolkit.git",
+    "directory": "packages/pamenv-vite"
+  },
+  "homepage": "https://pam.qlover.top/docs/cli",
+  "keywords": [
+    "brain toolkit",
+    "pam",
+    "pamenv",
+    "vite",
+    "vite-plugin",
+    "dotenv"
+  ],
+  "author": "qlover",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "pamenv-cli": "workspace:^"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "vite": "^6.1.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}