@anhuijie/envguard 1.0.0 → 1.1.0

package/README.md

@@ -5,6 +5,7 @@
 **Environment Variable Validation, Security Scanning & Documentation Generator**
 
 [![CI](https://github.com/AnhuiJie/envguard/actions/workflows/ci.yml/badge.svg)](https://github.com/AnhuiJie/envguard/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@anhuijie/envguard.svg)](https://www.npmjs.com/package/@anhuijie/envguard)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js >=18](https://img.shields.io/badge/node-%3E%3D18-green.svg)](https://nodejs.org/)
 
@@ -36,7 +37,7 @@ Misconfigured environment variables are a leading cause of production incidents.
 
 ```bash
 # Install
-npm install -g envguard
+npm install -g @anhuijie/envguard
 
 # Create config
 envguard init
@@ -103,6 +104,9 @@ module.exports = {
 | `port` | Valid port number (0-65535) | `3000` |
 | `json` | Valid JSON string | `'{"key":"value"}'` |
 | `regex` | Valid regex pattern | `^\\d+$` |
+| `date` | ISO 8601 date string | `2024-01-15` |
+| `semver` | Semantic version | `1.2.3` |
+| `color` | CSS color (hex, rgb, named) | `#ff6600` |
 
 ### Rule Options
 
@@ -137,10 +141,10 @@ EnvGuard detects these secret types:
 
 ```yaml
 - name: Validate env config
-  run: npx envguard validate
+  run: npx @anhuijie/envguard validate
 
 - name: Security check
-  run: npx envguard check
+  run: npx @anhuijie/envguard check
 ```
 
 The command exits with code `1` on validation errors or critical security findings, failing the build.
@@ -148,7 +152,7 @@ The command exits with code `1` on validation errors or critical security findin
 ### Programmatic API
 
 ```js
-const { validateEnv, scanForSecrets, generateEnvExample } = require('envguard');
+const { validateEnv, scanForSecrets, generateEnvExample } = require('@anhuijie/envguard');
 
 const schema = { PORT: { required: true, type: 'port' } };
 const result = validateEnv(process.env, schema);
@@ -189,7 +193,7 @@ const example = generateEnvExample(schema);
 
 ```bash
 # 安装
-npm install -g envguard
+npm install -g @anhuijie/envguard
 
 # 创建配置
 envguard init
@@ -256,6 +260,9 @@ module.exports = {
 | `port` | 合法端口号 (0-65535) | `3000` |
 | `json` | 合法 JSON 字符串 | `'{"key":"value"}'` |
 | `regex` | 合法正则表达式 | `^\\d+$` |
+| `date` | ISO 8601 日期字符串 | `2024-01-15` |
+| `semver` | 语义化版本号 | `1.2.3` |
+| `color` | CSS 颜色（hex、rgb、命名色） | `#ff6600` |
 
 ### 安全扫描
 
@@ -276,10 +283,10 @@ EnvGuard 可检测以下密钥类型：
 
 ```yaml
 - name: 验证环境配置
-  run: npx envguard validate
+  run: npx @anhuijie/envguard validate
 
 - name: 安全检查
-  run: npx envguard check
+  run: npx @anhuijie/envguard check
 ```
 
 验证失败或发现严重安全问题时，命令以退出码 `1` 退出，使构建失败。
@@ -287,7 +294,7 @@ EnvGuard 可检测以下密钥类型：
 ### 编程式 API
 
 ```js
-const { validateEnv, scanForSecrets, generateEnvExample } = require('envguard');
+const { validateEnv, scanForSecrets, generateEnvExample } = require('@anhuijie/envguard');
 
 const schema = { PORT: { required: true, type: 'port' } };
 const result = validateEnv(process.env, schema);
@@ -328,7 +335,7 @@ const example = generateEnvExample(schema);
 
 ```bash
 # インストール
-npm install -g envguard
+npm install -g @anhuijie/envguard
 
 # 設定ファイルの作成
 envguard init
@@ -395,6 +402,9 @@ module.exports = {
 | `port` | 有効なポート番号 (0-65535) | `3000` |
 | `json` | 有効な JSON 文字列 | `'{"key":"value"}'` |
 | `regex` | 有効な正規表現パターン | `^\\d+$` |
+| `date` | ISO 8601 日付文字列 | `2024-01-15` |
+| `semver` | セマンティックバージョン | `1.2.3` |
+| `color` | CSS カラー（hex、rgb、名前付き） | `#ff6600` |
 
 ### セキュリティスキャン
 
@@ -415,10 +425,10 @@ EnvGuard は以下のシークレットタイプを検出します：
 
 ```yaml
 - name: 環境設定の検証
-  run: npx envguard validate
+  run: npx @anhuijie/envguard validate
 
 - name: セキュリティチェック
-  run: npx envguard check
+  run: npx @anhuijie/envguard check
 ```
 
 検証エラーや重大なセキュリティ問題が見つかった場合、コマンドは終了コード `1` で終了し、ビルドを失敗させます。
@@ -426,7 +436,7 @@ EnvGuard は以下のシークレットタイプを検出します：
 ### プログラマティック API
 
 ```js
-const { validateEnv, scanForSecrets, generateEnvExample } = require('envguard');
+const { validateEnv, scanForSecrets, generateEnvExample } = require('@anhuijie/envguard');
 
 const schema = { PORT: { required: true, type: 'port' } };
 const result = validateEnv(process.env, schema);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anhuijie/envguard",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Environment variable & config validation, security scanning, and documentation generator for modern projects",
   "main": "src/index.js",
   "bin": {

package/src/commands/init.js

@@ -48,6 +48,23 @@ module.exports = {
     //   type: 'string',
     //   description: 'External API key',
     // },
+
+    // ── Additional Types ─────────────────
+    // APP_VERSION: {
+    //   required: false,
+    //   type: 'semver',
+    //   description: 'Application version (e.g. 1.2.3)',
+    // },
+    // RELEASE_DATE: {
+    //   required: false,
+    //   type: 'date',
+    //   description: 'Release date (ISO 8601, e.g. 2024-01-15)',
+    // },
+    // BRAND_COLOR: {
+    //   required: false,
+    //   type: 'color',
+    //   description: 'Primary brand color (hex, rgb, or named CSS color)',
+    // },
   },
 
   // Security scanning options

package/src/core/schema.js

@@ -2,7 +2,7 @@
  * Schema definition and parsing for envguard.config.js
  */
 
-const SUPPORTED_TYPES = ['string', 'number', 'boolean', 'url', 'email', 'json', 'regex', 'port'];
+const SUPPORTED_TYPES = ['string', 'number', 'boolean', 'url', 'email', 'json', 'regex', 'port', 'date', 'semver', 'color'];
 
 function validateSchema(schema) {
   if (!schema || typeof schema !== 'object') {

package/src/core/validator.js

@@ -66,6 +66,74 @@ const validators = {
     }
     return { valid: true };
   },
+
+  // Date type: validates ISO 8601 date strings (YYYY-MM-DD or full ISO format)
+  date: (value) => {
+    const dateRegex = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:?\d{2})?)?$/;
+    if (!dateRegex.test(value)) {
+      return { valid: false, error: `"${value}" is not a valid date (expected ISO 8601 format, e.g. 2024-01-15)` };
+    }
+    const parsed = new Date(value);
+    if (isNaN(parsed.getTime())) {
+      return { valid: false, error: `"${value}" is not a valid date` };
+    }
+    return { valid: true };
+  },
+
+  // Semver type: validates semantic version strings (e.g. 1.2.3, 1.0.0-beta.1)
+  semver: (value) => {
+    const semverRegex = /^\d+\.\d+\.\d+(-[a-zA-Z0-9]+(\.[a-zA-Z0-9]+)*)?(\+[a-zA-Z0-9]+(\.[a-zA-Z0-9]+)*)?$/;
+    return semverRegex.test(value)
+      ? { valid: true }
+      : { valid: false, error: `"${value}" is not a valid semver (expected format: X.Y.Z, e.g. 1.2.3)` };
+  },
+
+  // Color type: validates CSS color values (hex, rgb, rgba, hsl, named colors)
+  color: (value) => {
+    const str = String(value).trim();
+    // Hex: #RGB, #RRGGBB, #RRGGBBAA
+    if (/^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$/.test(str)) {
+      return { valid: true };
+    }
+    // rgb/rgba
+    if (/^rgba?\(\s*\d+(\.\d+)?%?\s*(,\s*\d+(\.\d+)?%?\s*){2,3}\)$/.test(str)) {
+      return { valid: true };
+    }
+    // hsl/hsla
+    if (/^hsla?\(\s*\d+(\.\d+)?(deg)?\s*(,\s*\d+(\.\d+)?%?\s*){2,3}\)$/.test(str)) {
+      return { valid: true };
+    }
+    // Named CSS colors
+    const namedColors = [
+      'aliceblue', 'antiquewhite', 'aqua', 'aquamarine', 'azure', 'beige', 'bisque', 'black',
+      'blanchedalmond', 'blue', 'blueviolet', 'brown', 'burlywood', 'cadetblue', 'chartreuse',
+      'chocolate', 'coral', 'cornflowerblue', 'cornsilk', 'crimson', 'cyan', 'darkblue',
+      'darkcyan', 'darkgoldenrod', 'darkgray', 'darkgreen', 'darkgrey', 'darkkhaki',
+      'darkmagenta', 'darkolivegreen', 'darkorange', 'darkorchid', 'darkred', 'darksalmon',
+      'darkseagreen', 'darkslateblue', 'darkslategray', 'darkslategrey', 'darkturquoise',
+      'darkviolet', 'deeppink', 'deepskyblue', 'dimgray', 'dimgrey', 'dodgerblue', 'firebrick',
+      'floralwhite', 'forestgreen', 'fuchsia', 'gainsboro', 'ghostwhite', 'gold', 'goldenrod',
+      'gray', 'green', 'greenyellow', 'grey', 'honeydew', 'hotpink', 'indianred', 'indigo',
+      'ivory', 'khaki', 'lavender', 'lavenderblush', 'lawngreen', 'lemonchiffon', 'lightblue',
+      'lightcoral', 'lightcyan', 'lightgoldenrodyellow', 'lightgray', 'lightgreen', 'lightgrey',
+      'lightpink', 'lightsalmon', 'lightseagreen', 'lightskyblue', 'lightslategray',
+      'lightslategrey', 'lightsteelblue', 'lightyellow', 'lime', 'limegreen', 'linen', 'magenta',
+      'maroon', 'mediumaquamarine', 'mediumblue', 'mediumorchid', 'mediumpurple',
+      'mediumseagreen', 'mediumslateblue', 'mediumspringgreen', 'mediumturquoise',
+      'mediumvioletred', 'midnightblue', 'mintcream', 'mistyrose', 'moccasin', 'navajowhite',
+      'navy', 'oldlace', 'olive', 'olivedrab', 'orange', 'orangered', 'orchid', 'palegoldenrod',
+      'palegreen', 'paleturquoise', 'palevioletred', 'papayawhip', 'peachpuff', 'peru', 'pink',
+      'plum', 'powderblue', 'purple', 'rebeccapurple', 'red', 'rosybrown', 'royalblue',
+      'saddlebrown', 'salmon', 'sandybrown', 'seagreen', 'seashell', 'sienna', 'silver',
+      'skyblue', 'slateblue', 'slategray', 'slategrey', 'snow', 'springgreen', 'steelblue',
+      'tan', 'teal', 'thistle', 'tomato', 'turquoise', 'violet', 'wheat', 'white', 'whitesmoke',
+      'yellow', 'yellowgreen',
+    ];
+    if (namedColors.includes(str.toLowerCase())) {
+      return { valid: true };
+    }
+    return { valid: false, error: `"${value}" is not a valid color (expected hex, rgb, hsl, or named CSS color)` };
+  },
 };
 
 function validateValue(value, rule) {