@perkos/util-config 1.0.0

package/README.md

@@ -0,0 +1,192 @@
+# @perkos/util-config
+
+Configuration management utilities for PerkOS services.
+
+## Installation
+
+```bash
+npm install @perkos/util-config
+```
+
+## Usage
+
+### Basic Environment Variables
+
+```typescript
+import {
+  getEnv,
+  getRequiredEnv,
+  getEnvNumber,
+  getEnvBoolean,
+  getEnvJson,
+} from "@perkos/util-config";
+
+// Get optional env var with default
+const apiUrl = getEnv("API_URL", "http://localhost:3000");
+
+// Get required env var (throws if missing)
+const apiKey = getRequiredEnv("API_KEY");
+
+// Get as number
+const port = getEnvNumber("PORT", 3000);
+
+// Get as boolean
+const debug = getEnvBoolean("DEBUG", false);
+
+// Get as parsed JSON
+const config = getEnvJson<{ key: string }>("CONFIG_JSON");
+```
+
+### Typed Configuration Builder
+
+```typescript
+import { createConfig, validateConfig } from "@perkos/util-config";
+
+// Define configuration schema
+const config = createConfig({
+  prefix: "APP",
+  strict: true,
+  vars: {
+    API_KEY: { required: true, type: "string" },
+    PORT: { type: "number", default: 3000 },
+    DEBUG: { type: "boolean", default: false },
+    SETTINGS: { type: "json", default: {} },
+    NETWORK: {
+      required: true,
+      validator: (v) => ["mainnet", "testnet"].includes(v),
+    },
+  },
+});
+
+// config is typed: { API_KEY: string, PORT: number, DEBUG: boolean, ... }
+
+// Validate without creating
+const result = validateConfig({
+  prefix: "APP",
+  vars: {
+    API_KEY: { required: true },
+    PORT: { type: "number" },
+  },
+});
+
+if (!result.valid) {
+  console.error("Config errors:", result.errors);
+  console.warn("Warnings:", result.warnings);
+}
+```
+
+### Price Configuration
+
+```typescript
+import { parsePrice, createPriceConfig, createRouteMapping } from "@perkos/util-config";
+
+// Parse single price
+const price = parsePrice(process.env.PRICE_USD, 0.01);
+
+// Create price config from env
+const prices = createPriceConfig({
+  analyze: { envKey: "AI_ANALYZE_PRICE_USD", default: 0.05 },
+  generate: { envKey: "AI_GENERATE_PRICE_USD", default: 0.15 },
+  transcribe: { envKey: "AI_TRANSCRIBE_PRICE_USD", default: 0.04 },
+});
+
+// Create route mappings
+const routes = createRouteMapping(
+  [
+    { path: "/api/ai/analyze", priceKey: "analyze" },
+    { path: "/api/ai/generate", priceKey: "generate" },
+    { path: "/api/ai/transcribe", priceKey: "transcribe" },
+  ],
+  prices
+);
+
+// Get price for route
+import { getRoutePrice } from "@perkos/util-config";
+const price = getRoutePrice(routes, "/api/ai/analyze"); // 0.05
+```
+
+### Service Discovery
+
+```typescript
+import { createServiceInfo } from "@perkos/util-config";
+
+const serviceInfo = createServiceInfo({
+  name: "My AI Service",
+  version: "1.0.0",
+  description: "AI-powered services with micropayments",
+  capabilities: [
+    "image-analysis",
+    "image-generation",
+    "text-summarization",
+  ],
+  endpoints: {
+    analyze: {
+      path: "/api/ai/analyze",
+      method: "POST",
+      description: "Analyze images",
+      price: 0.05,
+    },
+  },
+});
+```
+
+### Feature Flags
+
+```typescript
+import { createFeatureFlags, isFeatureEnabled } from "@perkos/util-config";
+
+const flags = createFeatureFlags({
+  newUI: { envKey: "FEATURE_NEW_UI", default: false },
+  betaAPI: { envKey: "FEATURE_BETA_API", default: false },
+  analytics: { envKey: "FEATURE_ANALYTICS", default: true },
+});
+
+if (isFeatureEnabled(flags, "newUI")) {
+  // Show new UI
+}
+```
+
+## API Reference
+
+### Environment Utilities
+
+| Function | Description |
+|----------|-------------|
+| `getEnv(key, default?)` | Get env var with optional default |
+| `getRequiredEnv(key)` | Get required env var (throws if missing) |
+| `getEnvNumber(key, default?)` | Get env var as number |
+| `getEnvBoolean(key, default?)` | Get env var as boolean |
+| `getEnvJson(key, default?)` | Get env var as parsed JSON |
+
+### Configuration Builder
+
+| Function | Description |
+|----------|-------------|
+| `createConfig(config)` | Create typed config from env vars |
+| `validateConfig(config)` | Validate config without creating |
+
+### Price Configuration
+
+| Function | Description |
+|----------|-------------|
+| `parsePrice(envVar, fallback)` | Parse price with fallback |
+| `createPriceConfig(priceMap)` | Create price config from env |
+| `createRouteMapping(routes, prices)` | Map routes to prices |
+| `getRoutePrice(routes, path)` | Get price for route |
+
+### Service Discovery
+
+| Function | Description |
+|----------|-------------|
+| `createServiceInfo(info)` | Create service discovery info |
+
+### Feature Flags
+
+| Function | Description |
+|----------|-------------|
+| `createFeatureFlags(flags)` | Create feature flags from env |
+| `isFeatureEnabled(flags, feature)` | Check if feature is enabled |
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,118 @@
+/**
+ * @perkos/config
+ * Configuration management utilities for PerkOS services
+ */
+interface EnvConfig<T extends Record<string, EnvVarConfig>> {
+    vars: T;
+    prefix?: string;
+    strict?: boolean;
+}
+interface EnvVarConfig {
+    required?: boolean;
+    default?: string | number | boolean;
+    type?: "string" | "number" | "boolean" | "json";
+    validator?: (value: string) => boolean;
+    transform?: (value: string) => unknown;
+}
+type ParsedConfig<T extends Record<string, EnvVarConfig>> = {
+    [K in keyof T]: T[K]["type"] extends "number" ? number : T[K]["type"] extends "boolean" ? boolean : T[K]["type"] extends "json" ? unknown : string;
+};
+interface ConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Get environment variable with optional default
+ */
+declare function getEnv(key: string, defaultValue?: string): string | undefined;
+/**
+ * Get required environment variable (throws if missing)
+ */
+declare function getRequiredEnv(key: string): string;
+/**
+ * Get environment variable as number
+ */
+declare function getEnvNumber(key: string, defaultValue?: number): number | undefined;
+/**
+ * Get environment variable as boolean
+ */
+declare function getEnvBoolean(key: string, defaultValue?: boolean): boolean | undefined;
+/**
+ * Get environment variable as JSON
+ */
+declare function getEnvJson<T>(key: string, defaultValue?: T): T | undefined;
+/**
+ * Create a typed configuration from environment variables
+ */
+declare function createConfig<T extends Record<string, EnvVarConfig>>(config: EnvConfig<T>): ParsedConfig<T>;
+/**
+ * Validate configuration without creating it
+ */
+declare function validateConfig<T extends Record<string, EnvVarConfig>>(config: EnvConfig<T>): ConfigValidationResult;
+interface ServiceInfo {
+    name: string;
+    version: string;
+    description?: string;
+    capabilities?: string[];
+    endpoints?: Record<string, EndpointInfo>;
+}
+interface EndpointInfo {
+    path: string;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    description?: string;
+    price?: number;
+    rateLimit?: number;
+}
+/**
+ * Create service discovery info
+ */
+declare function createServiceInfo(info: ServiceInfo): ServiceInfo;
+interface PriceConfig {
+    [key: string]: number;
+}
+/**
+ * Parse price from environment variable with fallback
+ */
+declare function parsePrice(envVar: string | undefined, fallback: number): number;
+/**
+ * Create price configuration from environment
+ */
+declare function createPriceConfig(priceMap: Record<string, {
+    envKey: string;
+    default: number;
+}>): PriceConfig;
+interface RouteConfig {
+    path: string;
+    price: number;
+    description?: string;
+    rateLimit?: number;
+}
+/**
+ * Create route price mapping from price config
+ */
+declare function createRouteMapping(routes: Array<{
+    path: string;
+    priceKey: string;
+    description?: string;
+}>, prices: PriceConfig): Record<string, RouteConfig>;
+/**
+ * Get price for a route path
+ */
+declare function getRoutePrice(routes: Record<string, RouteConfig>, path: string): number | undefined;
+interface FeatureFlags {
+    [key: string]: boolean;
+}
+/**
+ * Create feature flags from environment
+ */
+declare function createFeatureFlags(flags: Record<string, {
+    envKey: string;
+    default: boolean;
+}>): FeatureFlags;
+/**
+ * Check if a feature is enabled
+ */
+declare function isFeatureEnabled(flags: FeatureFlags, feature: string): boolean;
+
+export { type ConfigValidationResult, type EndpointInfo, type EnvConfig, type EnvVarConfig, type FeatureFlags, type ParsedConfig, type PriceConfig, type RouteConfig, type ServiceInfo, createConfig, createFeatureFlags, createPriceConfig, createRouteMapping, createServiceInfo, getEnv, getEnvBoolean, getEnvJson, getEnvNumber, getRequiredEnv, getRoutePrice, isFeatureEnabled, parsePrice, validateConfig };

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * @perkos/config
+ * Configuration management utilities for PerkOS services
+ */
+interface EnvConfig<T extends Record<string, EnvVarConfig>> {
+    vars: T;
+    prefix?: string;
+    strict?: boolean;
+}
+interface EnvVarConfig {
+    required?: boolean;
+    default?: string | number | boolean;
+    type?: "string" | "number" | "boolean" | "json";
+    validator?: (value: string) => boolean;
+    transform?: (value: string) => unknown;
+}
+type ParsedConfig<T extends Record<string, EnvVarConfig>> = {
+    [K in keyof T]: T[K]["type"] extends "number" ? number : T[K]["type"] extends "boolean" ? boolean : T[K]["type"] extends "json" ? unknown : string;
+};
+interface ConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Get environment variable with optional default
+ */
+declare function getEnv(key: string, defaultValue?: string): string | undefined;
+/**
+ * Get required environment variable (throws if missing)
+ */
+declare function getRequiredEnv(key: string): string;
+/**
+ * Get environment variable as number
+ */
+declare function getEnvNumber(key: string, defaultValue?: number): number | undefined;
+/**
+ * Get environment variable as boolean
+ */
+declare function getEnvBoolean(key: string, defaultValue?: boolean): boolean | undefined;
+/**
+ * Get environment variable as JSON
+ */
+declare function getEnvJson<T>(key: string, defaultValue?: T): T | undefined;
+/**
+ * Create a typed configuration from environment variables
+ */
+declare function createConfig<T extends Record<string, EnvVarConfig>>(config: EnvConfig<T>): ParsedConfig<T>;
+/**
+ * Validate configuration without creating it
+ */
+declare function validateConfig<T extends Record<string, EnvVarConfig>>(config: EnvConfig<T>): ConfigValidationResult;
+interface ServiceInfo {
+    name: string;
+    version: string;
+    description?: string;
+    capabilities?: string[];
+    endpoints?: Record<string, EndpointInfo>;
+}
+interface EndpointInfo {
+    path: string;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    description?: string;
+    price?: number;
+    rateLimit?: number;
+}
+/**
+ * Create service discovery info
+ */
+declare function createServiceInfo(info: ServiceInfo): ServiceInfo;
+interface PriceConfig {
+    [key: string]: number;
+}
+/**
+ * Parse price from environment variable with fallback
+ */
+declare function parsePrice(envVar: string | undefined, fallback: number): number;
+/**
+ * Create price configuration from environment
+ */
+declare function createPriceConfig(priceMap: Record<string, {
+    envKey: string;
+    default: number;
+}>): PriceConfig;
+interface RouteConfig {
+    path: string;
+    price: number;
+    description?: string;
+    rateLimit?: number;
+}
+/**
+ * Create route price mapping from price config
+ */
+declare function createRouteMapping(routes: Array<{
+    path: string;
+    priceKey: string;
+    description?: string;
+}>, prices: PriceConfig): Record<string, RouteConfig>;
+/**
+ * Get price for a route path
+ */
+declare function getRoutePrice(routes: Record<string, RouteConfig>, path: string): number | undefined;
+interface FeatureFlags {
+    [key: string]: boolean;
+}
+/**
+ * Create feature flags from environment
+ */
+declare function createFeatureFlags(flags: Record<string, {
+    envKey: string;
+    default: boolean;
+}>): FeatureFlags;
+/**
+ * Check if a feature is enabled
+ */
+declare function isFeatureEnabled(flags: FeatureFlags, feature: string): boolean;
+
+export { type ConfigValidationResult, type EndpointInfo, type EnvConfig, type EnvVarConfig, type FeatureFlags, type ParsedConfig, type PriceConfig, type RouteConfig, type ServiceInfo, createConfig, createFeatureFlags, createPriceConfig, createRouteMapping, createServiceInfo, getEnv, getEnvBoolean, getEnvJson, getEnvNumber, getRequiredEnv, getRoutePrice, isFeatureEnabled, parsePrice, validateConfig };

package/dist/index.js

@@ -0,0 +1,214 @@
+"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, {
+  createConfig: () => createConfig,
+  createFeatureFlags: () => createFeatureFlags,
+  createPriceConfig: () => createPriceConfig,
+  createRouteMapping: () => createRouteMapping,
+  createServiceInfo: () => createServiceInfo,
+  getEnv: () => getEnv,
+  getEnvBoolean: () => getEnvBoolean,
+  getEnvJson: () => getEnvJson,
+  getEnvNumber: () => getEnvNumber,
+  getRequiredEnv: () => getRequiredEnv,
+  getRoutePrice: () => getRoutePrice,
+  isFeatureEnabled: () => isFeatureEnabled,
+  parsePrice: () => parsePrice,
+  validateConfig: () => validateConfig
+});
+module.exports = __toCommonJS(index_exports);
+function getEnv(key, defaultValue) {
+  return process.env[key] ?? defaultValue;
+}
+function getRequiredEnv(key) {
+  const value = process.env[key];
+  if (value === void 0 || value === "") {
+    throw new Error(`Required environment variable ${key} is not set`);
+  }
+  return value;
+}
+function getEnvNumber(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) return defaultValue;
+  const parsed = parseFloat(value);
+  return isNaN(parsed) ? defaultValue : parsed;
+}
+function getEnvBoolean(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) return defaultValue;
+  return value.toLowerCase() === "true" || value === "1";
+}
+function getEnvJson(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) return defaultValue;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return defaultValue;
+  }
+}
+function createConfig(config) {
+  const result = {};
+  const prefix = config.prefix ? `${config.prefix}_` : "";
+  for (const [key, varConfig] of Object.entries(config.vars)) {
+    const envKey = `${prefix}${key}`;
+    const rawValue = process.env[envKey];
+    if (rawValue === void 0 || rawValue === "") {
+      if (varConfig.required && config.strict !== false) {
+        throw new Error(`Required environment variable ${envKey} is not set`);
+      }
+      if (varConfig.default !== void 0) {
+        result[key] = varConfig.default;
+        continue;
+      }
+      result[key] = void 0;
+      continue;
+    }
+    if (varConfig.validator && !varConfig.validator(rawValue)) {
+      throw new Error(`Invalid value for environment variable ${envKey}`);
+    }
+    if (varConfig.transform) {
+      result[key] = varConfig.transform(rawValue);
+      continue;
+    }
+    switch (varConfig.type) {
+      case "number":
+        const num = parseFloat(rawValue);
+        if (isNaN(num)) {
+          throw new Error(`Invalid number for environment variable ${envKey}`);
+        }
+        result[key] = num;
+        break;
+      case "boolean":
+        result[key] = rawValue.toLowerCase() === "true" || rawValue === "1";
+        break;
+      case "json":
+        try {
+          result[key] = JSON.parse(rawValue);
+        } catch {
+          throw new Error(`Invalid JSON for environment variable ${envKey}`);
+        }
+        break;
+      default:
+        result[key] = rawValue;
+    }
+  }
+  return result;
+}
+function validateConfig(config) {
+  const errors = [];
+  const warnings = [];
+  const prefix = config.prefix ? `${config.prefix}_` : "";
+  for (const [key, varConfig] of Object.entries(config.vars)) {
+    const envKey = `${prefix}${key}`;
+    const rawValue = process.env[envKey];
+    if (rawValue === void 0 || rawValue === "") {
+      if (varConfig.required) {
+        errors.push(`Missing required: ${envKey}`);
+      } else if (varConfig.default === void 0) {
+        warnings.push(`Optional not set: ${envKey}`);
+      }
+      continue;
+    }
+    if (varConfig.validator && !varConfig.validator(rawValue)) {
+      errors.push(`Invalid value: ${envKey}`);
+    }
+    if (varConfig.type === "number" && isNaN(parseFloat(rawValue))) {
+      errors.push(`Invalid number: ${envKey}`);
+    }
+    if (varConfig.type === "json") {
+      try {
+        JSON.parse(rawValue);
+      } catch {
+        errors.push(`Invalid JSON: ${envKey}`);
+      }
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function createServiceInfo(info) {
+  return {
+    ...info,
+    capabilities: info.capabilities || [],
+    endpoints: info.endpoints || {}
+  };
+}
+function parsePrice(envVar, fallback) {
+  if (!envVar) return fallback;
+  const parsed = parseFloat(envVar);
+  return isNaN(parsed) ? fallback : parsed;
+}
+function createPriceConfig(priceMap) {
+  const result = {};
+  for (const [key, config] of Object.entries(priceMap)) {
+    result[key] = parsePrice(process.env[config.envKey], config.default);
+  }
+  return result;
+}
+function createRouteMapping(routes, prices) {
+  const result = {};
+  for (const route of routes) {
+    result[route.path] = {
+      path: route.path,
+      price: prices[route.priceKey] || 0,
+      description: route.description
+    };
+  }
+  return result;
+}
+function getRoutePrice(routes, path) {
+  const route = routes[path];
+  return route?.price;
+}
+function createFeatureFlags(flags) {
+  const result = {};
+  for (const [key, config] of Object.entries(flags)) {
+    const value = process.env[config.envKey];
+    result[key] = value !== void 0 ? value.toLowerCase() === "true" || value === "1" : config.default;
+  }
+  return result;
+}
+function isFeatureEnabled(flags, feature) {
+  return flags[feature] ?? false;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createConfig,
+  createFeatureFlags,
+  createPriceConfig,
+  createRouteMapping,
+  createServiceInfo,
+  getEnv,
+  getEnvBoolean,
+  getEnvJson,
+  getEnvNumber,
+  getRequiredEnv,
+  getRoutePrice,
+  isFeatureEnabled,
+  parsePrice,
+  validateConfig
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @perkos/config\n * Configuration management utilities for PerkOS services\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface EnvConfig<T extends Record<string, EnvVarConfig>> {\n  vars: T;\n  prefix?: string;\n  strict?: boolean;\n}\n\nexport interface EnvVarConfig {\n  required?: boolean;\n  default?: string | number | boolean;\n  type?: \"string\" | \"number\" | \"boolean\" | \"json\";\n  validator?: (value: string) => boolean;\n  transform?: (value: string) => unknown;\n}\n\nexport type ParsedConfig<T extends Record<string, EnvVarConfig>> = {\n  [K in keyof T]: T[K][\"type\"] extends \"number\"\n    ? number\n    : T[K][\"type\"] extends \"boolean\"\n    ? boolean\n    : T[K][\"type\"] extends \"json\"\n    ? unknown\n    : string;\n};\n\nexport interface ConfigValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n\n// ============================================================================\n// Environment Variable Utilities\n// ============================================================================\n\n/**\n * Get environment variable with optional default\n */\nexport function getEnv(key: string, defaultValue?: string): string | undefined {\n  return process.env[key] ?? defaultValue;\n}\n\n/**\n * Get required environment variable (throws if missing)\n */\nexport function getRequiredEnv(key: string): string {\n  const value = process.env[key];\n  if (value === undefined || value === \"\") {\n    throw new Error(`Required environment variable ${key} is not set`);\n  }\n  return value;\n}\n\n/**\n * Get environment variable as number\n */\nexport function getEnvNumber(key: string, defaultValue?: number): number | undefined {\n  const value = process.env[key];\n  if (value === undefined) return defaultValue;\n  const parsed = parseFloat(value);\n  return isNaN(parsed) ? defaultValue : parsed;\n}\n\n/**\n * Get environment variable as boolean\n */\nexport function getEnvBoolean(key: string, defaultValue?: boolean): boolean | undefined {\n  const value = process.env[key];\n  if (value === undefined) return defaultValue;\n  return value.toLowerCase() === \"true\" || value === \"1\";\n}\n\n/**\n * Get environment variable as JSON\n */\nexport function getEnvJson<T>(key: string, defaultValue?: T): T | undefined {\n  const value = process.env[key];\n  if (value === undefined) return defaultValue;\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return defaultValue;\n  }\n}\n\n// ============================================================================\n// Configuration Builder\n// ============================================================================\n\n/**\n * Create a typed configuration from environment variables\n */\nexport function createConfig<T extends Record<string, EnvVarConfig>>(\n  config: EnvConfig<T>\n): ParsedConfig<T> {\n  const result: Record<string, unknown> = {};\n  const prefix = config.prefix ? `${config.prefix}_` : \"\";\n\n  for (const [key, varConfig] of Object.entries(config.vars)) {\n    const envKey = `${prefix}${key}`;\n    const rawValue = process.env[envKey];\n\n    // Handle missing values\n    if (rawValue === undefined || rawValue === \"\") {\n      if (varConfig.required && config.strict !== false) {\n        throw new Error(`Required environment variable ${envKey} is not set`);\n      }\n      if (varConfig.default !== undefined) {\n        result[key] = varConfig.default;\n        continue;\n      }\n      result[key] = undefined;\n      continue;\n    }\n\n    // Validate\n    if (varConfig.validator && !varConfig.validator(rawValue)) {\n      throw new Error(`Invalid value for environment variable ${envKey}`);\n    }\n\n    // Transform or parse by type\n    if (varConfig.transform) {\n      result[key] = varConfig.transform(rawValue);\n      continue;\n    }\n\n    switch (varConfig.type) {\n      case \"number\":\n        const num = parseFloat(rawValue);\n        if (isNaN(num)) {\n          throw new Error(`Invalid number for environment variable ${envKey}`);\n        }\n        result[key] = num;\n        break;\n      case \"boolean\":\n        result[key] = rawValue.toLowerCase() === \"true\" || rawValue === \"1\";\n        break;\n      case \"json\":\n        try {\n          result[key] = JSON.parse(rawValue);\n        } catch {\n          throw new Error(`Invalid JSON for environment variable ${envKey}`);\n        }\n        break;\n      default:\n        result[key] = rawValue;\n    }\n  }\n\n  return result as ParsedConfig<T>;\n}\n\n/**\n * Validate configuration without creating it\n */\nexport function validateConfig<T extends Record<string, EnvVarConfig>>(\n  config: EnvConfig<T>\n): ConfigValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const prefix = config.prefix ? `${config.prefix}_` : \"\";\n\n  for (const [key, varConfig] of Object.entries(config.vars)) {\n    const envKey = `${prefix}${key}`;\n    const rawValue = process.env[envKey];\n\n    if (rawValue === undefined || rawValue === \"\") {\n      if (varConfig.required) {\n        errors.push(`Missing required: ${envKey}`);\n      } else if (varConfig.default === undefined) {\n        warnings.push(`Optional not set: ${envKey}`);\n      }\n      continue;\n    }\n\n    if (varConfig.validator && !varConfig.validator(rawValue)) {\n      errors.push(`Invalid value: ${envKey}`);\n    }\n\n    if (varConfig.type === \"number\" && isNaN(parseFloat(rawValue))) {\n      errors.push(`Invalid number: ${envKey}`);\n    }\n\n    if (varConfig.type === \"json\") {\n      try {\n        JSON.parse(rawValue);\n      } catch {\n        errors.push(`Invalid JSON: ${envKey}`);\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n// ============================================================================\n// Service Discovery Configuration\n// ============================================================================\n\nexport interface ServiceInfo {\n  name: string;\n  version: string;\n  description?: string;\n  capabilities?: string[];\n  endpoints?: Record<string, EndpointInfo>;\n}\n\nexport interface EndpointInfo {\n  path: string;\n  method: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n  description?: string;\n  price?: number;\n  rateLimit?: number;\n}\n\n/**\n * Create service discovery info\n */\nexport function createServiceInfo(info: ServiceInfo): ServiceInfo {\n  return {\n    ...info,\n    capabilities: info.capabilities || [],\n    endpoints: info.endpoints || {},\n  };\n}\n\n// ============================================================================\n// Price Configuration\n// ============================================================================\n\nexport interface PriceConfig {\n  [key: string]: number;\n}\n\n/**\n * Parse price from environment variable with fallback\n */\nexport function parsePrice(envVar: string | undefined, fallback: number): number {\n  if (!envVar) return fallback;\n  const parsed = parseFloat(envVar);\n  return isNaN(parsed) ? fallback : parsed;\n}\n\n/**\n * Create price configuration from environment\n */\nexport function createPriceConfig(\n  priceMap: Record<string, { envKey: string; default: number }>\n): PriceConfig {\n  const result: PriceConfig = {};\n  for (const [key, config] of Object.entries(priceMap)) {\n    result[key] = parsePrice(process.env[config.envKey], config.default);\n  }\n  return result;\n}\n\n// ============================================================================\n// Route Configuration\n// ============================================================================\n\nexport interface RouteConfig {\n  path: string;\n  price: number;\n  description?: string;\n  rateLimit?: number;\n}\n\n/**\n * Create route price mapping from price config\n */\nexport function createRouteMapping(\n  routes: Array<{ path: string; priceKey: string; description?: string }>,\n  prices: PriceConfig\n): Record<string, RouteConfig> {\n  const result: Record<string, RouteConfig> = {};\n  for (const route of routes) {\n    result[route.path] = {\n      path: route.path,\n      price: prices[route.priceKey] || 0,\n      description: route.description,\n    };\n  }\n  return result;\n}\n\n/**\n * Get price for a route path\n */\nexport function getRoutePrice(\n  routes: Record<string, RouteConfig>,\n  path: string\n): number | undefined {\n  const route = routes[path];\n  return route?.price;\n}\n\n// ============================================================================\n// Feature Flags\n// ============================================================================\n\nexport interface FeatureFlags {\n  [key: string]: boolean;\n}\n\n/**\n * Create feature flags from environment\n */\nexport function createFeatureFlags(\n  flags: Record<string, { envKey: string; default: boolean }>\n): FeatureFlags {\n  const result: FeatureFlags = {};\n  for (const [key, config] of Object.entries(flags)) {\n    const value = process.env[config.envKey];\n    result[key] =\n      value !== undefined\n        ? value.toLowerCase() === \"true\" || value === \"1\"\n        : config.default;\n  }\n  return result;\n}\n\n/**\n * Check if a feature is enabled\n */\nexport function isFeatureEnabled(\n  flags: FeatureFlags,\n  feature: string\n): boolean {\n  return flags[feature] ?? false;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8CO,SAAS,OAAO,KAAa,cAA2C;AAC7E,SAAO,QAAQ,IAAI,GAAG,KAAK;AAC7B;AAKO,SAAS,eAAe,KAAqB;AAClD,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,UAAa,UAAU,IAAI;AACvC,UAAM,IAAI,MAAM,iCAAiC,GAAG,aAAa;AAAA,EACnE;AACA,SAAO;AACT;AAKO,SAAS,aAAa,KAAa,cAA2C;AACnF,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,SAAS,WAAW,KAAK;AAC/B,SAAO,MAAM,MAAM,IAAI,eAAe;AACxC;AAKO,SAAS,cAAc,KAAa,cAA6C;AACtF,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,MAAM,YAAY,MAAM,UAAU,UAAU;AACrD;AAKO,SAAS,WAAc,KAAa,cAAiC;AAC1E,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AASO,SAAS,aACd,QACiB;AACjB,QAAM,SAAkC,CAAC;AACzC,QAAM,SAAS,OAAO,SAAS,GAAG,OAAO,MAAM,MAAM;AAErD,aAAW,CAAC,KAAK,SAAS,KAAK,OAAO,QAAQ,OAAO,IAAI,GAAG;AAC1D,UAAM,SAAS,GAAG,MAAM,GAAG,GAAG;AAC9B,UAAM,WAAW,QAAQ,IAAI,MAAM;AAGnC,QAAI,aAAa,UAAa,aAAa,IAAI;AAC7C,UAAI,UAAU,YAAY,OAAO,WAAW,OAAO;AACjD,cAAM,IAAI,MAAM,iCAAiC,MAAM,aAAa;AAAA,MACtE;AACA,UAAI,UAAU,YAAY,QAAW;AACnC,eAAO,GAAG,IAAI,UAAU;AACxB;AAAA,MACF;AACA,aAAO,GAAG,IAAI;AACd;AAAA,IACF;AAGA,QAAI,UAAU,aAAa,CAAC,UAAU,UAAU,QAAQ,GAAG;AACzD,YAAM,IAAI,MAAM,0CAA0C,MAAM,EAAE;AAAA,IACpE;AAGA,QAAI,UAAU,WAAW;AACvB,aAAO,GAAG,IAAI,UAAU,UAAU,QAAQ;AAC1C;AAAA,IACF;AAEA,YAAQ,UAAU,MAAM;AAAA,MACtB,KAAK;AACH,cAAM,MAAM,WAAW,QAAQ;AAC/B,YAAI,MAAM,GAAG,GAAG;AACd,gBAAM,IAAI,MAAM,2CAA2C,MAAM,EAAE;AAAA,QACrE;AACA,eAAO,GAAG,IAAI;AACd;AAAA,MACF,KAAK;AACH,eAAO,GAAG,IAAI,SAAS,YAAY,MAAM,UAAU,aAAa;AAChE;AAAA,MACF,KAAK;AACH,YAAI;AACF,iBAAO,GAAG,IAAI,KAAK,MAAM,QAAQ;AAAA,QACnC,QAAQ;AACN,gBAAM,IAAI,MAAM,yCAAyC,MAAM,EAAE;AAAA,QACnE;AACA;AAAA,MACF;AACE,eAAO,GAAG,IAAI;AAAA,IAClB;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,eACd,QACwB;AACxB,QAAM,SAAmB,CAAC;AAC1B,QAAM,WAAqB,CAAC;AAC5B,QAAM,SAAS,OAAO,SAAS,GAAG,OAAO,MAAM,MAAM;AAErD,aAAW,CAAC,KAAK,SAAS,KAAK,OAAO,QAAQ,OAAO,IAAI,GAAG;AAC1D,UAAM,SAAS,GAAG,MAAM,GAAG,GAAG;AAC9B,UAAM,WAAW,QAAQ,IAAI,MAAM;AAEnC,QAAI,aAAa,UAAa,aAAa,IAAI;AAC7C,UAAI,UAAU,UAAU;AACtB,eAAO,KAAK,qBAAqB,MAAM,EAAE;AAAA,MAC3C,WAAW,UAAU,YAAY,QAAW;AAC1C,iBAAS,KAAK,qBAAqB,MAAM,EAAE;AAAA,MAC7C;AACA;AAAA,IACF;AAEA,QAAI,UAAU,aAAa,CAAC,UAAU,UAAU,QAAQ,GAAG;AACzD,aAAO,KAAK,kBAAkB,MAAM,EAAE;AAAA,IACxC;AAEA,QAAI,UAAU,SAAS,YAAY,MAAM,WAAW,QAAQ,CAAC,GAAG;AAC9D,aAAO,KAAK,mBAAmB,MAAM,EAAE;AAAA,IACzC;AAEA,QAAI,UAAU,SAAS,QAAQ;AAC7B,UAAI;AACF,aAAK,MAAM,QAAQ;AAAA,MACrB,QAAQ;AACN,eAAO,KAAK,iBAAiB,MAAM,EAAE;AAAA,MACvC;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,OAAO,WAAW;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AACF;AAyBO,SAAS,kBAAkB,MAAgC;AAChE,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,KAAK,gBAAgB,CAAC;AAAA,IACpC,WAAW,KAAK,aAAa,CAAC;AAAA,EAChC;AACF;AAaO,SAAS,WAAW,QAA4B,UAA0B;AAC/E,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,SAAS,WAAW,MAAM;AAChC,SAAO,MAAM,MAAM,IAAI,WAAW;AACpC;AAKO,SAAS,kBACd,UACa;AACb,QAAM,SAAsB,CAAC;AAC7B,aAAW,CAAC,KAAK,MAAM,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACpD,WAAO,GAAG,IAAI,WAAW,QAAQ,IAAI,OAAO,MAAM,GAAG,OAAO,OAAO;AAAA,EACrE;AACA,SAAO;AACT;AAgBO,SAAS,mBACd,QACA,QAC6B;AAC7B,QAAM,SAAsC,CAAC;AAC7C,aAAW,SAAS,QAAQ;AAC1B,WAAO,MAAM,IAAI,IAAI;AAAA,MACnB,MAAM,MAAM;AAAA,MACZ,OAAO,OAAO,MAAM,QAAQ,KAAK;AAAA,MACjC,aAAa,MAAM;AAAA,IACrB;AAAA,EACF;AACA,SAAO;AACT;AAKO,SAAS,cACd,QACA,MACoB;AACpB,QAAM,QAAQ,OAAO,IAAI;AACzB,SAAO,OAAO;AAChB;AAaO,SAAS,mBACd,OACc;AACd,QAAM,SAAuB,CAAC;AAC9B,aAAW,CAAC,KAAK,MAAM,KAAK,OAAO,QAAQ,KAAK,GAAG;AACjD,UAAM,QAAQ,QAAQ,IAAI,OAAO,MAAM;AACvC,WAAO,GAAG,IACR,UAAU,SACN,MAAM,YAAY,MAAM,UAAU,UAAU,MAC5C,OAAO;AAAA,EACf;AACA,SAAO;AACT;AAKO,SAAS,iBACd,OACA,SACS;AACT,SAAO,MAAM,OAAO,KAAK;AAC3B;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,176 @@
+// src/index.ts
+function getEnv(key, defaultValue) {
+  return process.env[key] ?? defaultValue;
+}
+function getRequiredEnv(key) {
+  const value = process.env[key];
+  if (value === void 0 || value === "") {
+    throw new Error(`Required environment variable ${key} is not set`);
+  }
+  return value;
+}
+function getEnvNumber(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) return defaultValue;
+  const parsed = parseFloat(value);
+  return isNaN(parsed) ? defaultValue : parsed;
+}
+function getEnvBoolean(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) return defaultValue;
+  return value.toLowerCase() === "true" || value === "1";
+}
+function getEnvJson(key, defaultValue) {
+  const value = process.env[key];
+  if (value === void 0) return defaultValue;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return defaultValue;
+  }
+}
+function createConfig(config) {
+  const result = {};
+  const prefix = config.prefix ? `${config.prefix}_` : "";
+  for (const [key, varConfig] of Object.entries(config.vars)) {
+    const envKey = `${prefix}${key}`;
+    const rawValue = process.env[envKey];
+    if (rawValue === void 0 || rawValue === "") {
+      if (varConfig.required && config.strict !== false) {
+        throw new Error(`Required environment variable ${envKey} is not set`);
+      }
+      if (varConfig.default !== void 0) {
+        result[key] = varConfig.default;
+        continue;
+      }
+      result[key] = void 0;
+      continue;
+    }
+    if (varConfig.validator && !varConfig.validator(rawValue)) {
+      throw new Error(`Invalid value for environment variable ${envKey}`);
+    }
+    if (varConfig.transform) {
+      result[key] = varConfig.transform(rawValue);
+      continue;
+    }
+    switch (varConfig.type) {
+      case "number":
+        const num = parseFloat(rawValue);
+        if (isNaN(num)) {
+          throw new Error(`Invalid number for environment variable ${envKey}`);
+        }
+        result[key] = num;
+        break;
+      case "boolean":
+        result[key] = rawValue.toLowerCase() === "true" || rawValue === "1";
+        break;
+      case "json":
+        try {
+          result[key] = JSON.parse(rawValue);
+        } catch {
+          throw new Error(`Invalid JSON for environment variable ${envKey}`);
+        }
+        break;
+      default:
+        result[key] = rawValue;
+    }
+  }
+  return result;
+}
+function validateConfig(config) {
+  const errors = [];
+  const warnings = [];
+  const prefix = config.prefix ? `${config.prefix}_` : "";
+  for (const [key, varConfig] of Object.entries(config.vars)) {
+    const envKey = `${prefix}${key}`;
+    const rawValue = process.env[envKey];
+    if (rawValue === void 0 || rawValue === "") {
+      if (varConfig.required) {
+        errors.push(`Missing required: ${envKey}`);
+      } else if (varConfig.default === void 0) {
+        warnings.push(`Optional not set: ${envKey}`);
+      }
+      continue;
+    }
+    if (varConfig.validator && !varConfig.validator(rawValue)) {
+      errors.push(`Invalid value: ${envKey}`);
+    }
+    if (varConfig.type === "number" && isNaN(parseFloat(rawValue))) {
+      errors.push(`Invalid number: ${envKey}`);
+    }
+    if (varConfig.type === "json") {
+      try {
+        JSON.parse(rawValue);
+      } catch {
+        errors.push(`Invalid JSON: ${envKey}`);
+      }
+    }
+  }
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings
+  };
+}
+function createServiceInfo(info) {
+  return {
+    ...info,
+    capabilities: info.capabilities || [],
+    endpoints: info.endpoints || {}
+  };
+}
+function parsePrice(envVar, fallback) {
+  if (!envVar) return fallback;
+  const parsed = parseFloat(envVar);
+  return isNaN(parsed) ? fallback : parsed;
+}
+function createPriceConfig(priceMap) {
+  const result = {};
+  for (const [key, config] of Object.entries(priceMap)) {
+    result[key] = parsePrice(process.env[config.envKey], config.default);
+  }
+  return result;
+}
+function createRouteMapping(routes, prices) {
+  const result = {};
+  for (const route of routes) {
+    result[route.path] = {
+      path: route.path,
+      price: prices[route.priceKey] || 0,
+      description: route.description
+    };
+  }
+  return result;
+}
+function getRoutePrice(routes, path) {
+  const route = routes[path];
+  return route?.price;
+}
+function createFeatureFlags(flags) {
+  const result = {};
+  for (const [key, config] of Object.entries(flags)) {
+    const value = process.env[config.envKey];
+    result[key] = value !== void 0 ? value.toLowerCase() === "true" || value === "1" : config.default;
+  }
+  return result;
+}
+function isFeatureEnabled(flags, feature) {
+  return flags[feature] ?? false;
+}
+export {
+  createConfig,
+  createFeatureFlags,
+  createPriceConfig,
+  createRouteMapping,
+  createServiceInfo,
+  getEnv,
+  getEnvBoolean,
+  getEnvJson,
+  getEnvNumber,
+  getRequiredEnv,
+  getRoutePrice,
+  isFeatureEnabled,
+  parsePrice,
+  validateConfig
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @perkos/config\n * Configuration management utilities for PerkOS services\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface EnvConfig<T extends Record<string, EnvVarConfig>> {\n  vars: T;\n  prefix?: string;\n  strict?: boolean;\n}\n\nexport interface EnvVarConfig {\n  required?: boolean;\n  default?: string | number | boolean;\n  type?: \"string\" | \"number\" | \"boolean\" | \"json\";\n  validator?: (value: string) => boolean;\n  transform?: (value: string) => unknown;\n}\n\nexport type ParsedConfig<T extends Record<string, EnvVarConfig>> = {\n  [K in keyof T]: T[K][\"type\"] extends \"number\"\n    ? number\n    : T[K][\"type\"] extends \"boolean\"\n    ? boolean\n    : T[K][\"type\"] extends \"json\"\n    ? unknown\n    : string;\n};\n\nexport interface ConfigValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n}\n\n// ============================================================================\n// Environment Variable Utilities\n// ============================================================================\n\n/**\n * Get environment variable with optional default\n */\nexport function getEnv(key: string, defaultValue?: string): string | undefined {\n  return process.env[key] ?? defaultValue;\n}\n\n/**\n * Get required environment variable (throws if missing)\n */\nexport function getRequiredEnv(key: string): string {\n  const value = process.env[key];\n  if (value === undefined || value === \"\") {\n    throw new Error(`Required environment variable ${key} is not set`);\n  }\n  return value;\n}\n\n/**\n * Get environment variable as number\n */\nexport function getEnvNumber(key: string, defaultValue?: number): number | undefined {\n  const value = process.env[key];\n  if (value === undefined) return defaultValue;\n  const parsed = parseFloat(value);\n  return isNaN(parsed) ? defaultValue : parsed;\n}\n\n/**\n * Get environment variable as boolean\n */\nexport function getEnvBoolean(key: string, defaultValue?: boolean): boolean | undefined {\n  const value = process.env[key];\n  if (value === undefined) return defaultValue;\n  return value.toLowerCase() === \"true\" || value === \"1\";\n}\n\n/**\n * Get environment variable as JSON\n */\nexport function getEnvJson<T>(key: string, defaultValue?: T): T | undefined {\n  const value = process.env[key];\n  if (value === undefined) return defaultValue;\n  try {\n    return JSON.parse(value) as T;\n  } catch {\n    return defaultValue;\n  }\n}\n\n// ============================================================================\n// Configuration Builder\n// ============================================================================\n\n/**\n * Create a typed configuration from environment variables\n */\nexport function createConfig<T extends Record<string, EnvVarConfig>>(\n  config: EnvConfig<T>\n): ParsedConfig<T> {\n  const result: Record<string, unknown> = {};\n  const prefix = config.prefix ? `${config.prefix}_` : \"\";\n\n  for (const [key, varConfig] of Object.entries(config.vars)) {\n    const envKey = `${prefix}${key}`;\n    const rawValue = process.env[envKey];\n\n    // Handle missing values\n    if (rawValue === undefined || rawValue === \"\") {\n      if (varConfig.required && config.strict !== false) {\n        throw new Error(`Required environment variable ${envKey} is not set`);\n      }\n      if (varConfig.default !== undefined) {\n        result[key] = varConfig.default;\n        continue;\n      }\n      result[key] = undefined;\n      continue;\n    }\n\n    // Validate\n    if (varConfig.validator && !varConfig.validator(rawValue)) {\n      throw new Error(`Invalid value for environment variable ${envKey}`);\n    }\n\n    // Transform or parse by type\n    if (varConfig.transform) {\n      result[key] = varConfig.transform(rawValue);\n      continue;\n    }\n\n    switch (varConfig.type) {\n      case \"number\":\n        const num = parseFloat(rawValue);\n        if (isNaN(num)) {\n          throw new Error(`Invalid number for environment variable ${envKey}`);\n        }\n        result[key] = num;\n        break;\n      case \"boolean\":\n        result[key] = rawValue.toLowerCase() === \"true\" || rawValue === \"1\";\n        break;\n      case \"json\":\n        try {\n          result[key] = JSON.parse(rawValue);\n        } catch {\n          throw new Error(`Invalid JSON for environment variable ${envKey}`);\n        }\n        break;\n      default:\n        result[key] = rawValue;\n    }\n  }\n\n  return result as ParsedConfig<T>;\n}\n\n/**\n * Validate configuration without creating it\n */\nexport function validateConfig<T extends Record<string, EnvVarConfig>>(\n  config: EnvConfig<T>\n): ConfigValidationResult {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const prefix = config.prefix ? `${config.prefix}_` : \"\";\n\n  for (const [key, varConfig] of Object.entries(config.vars)) {\n    const envKey = `${prefix}${key}`;\n    const rawValue = process.env[envKey];\n\n    if (rawValue === undefined || rawValue === \"\") {\n      if (varConfig.required) {\n        errors.push(`Missing required: ${envKey}`);\n      } else if (varConfig.default === undefined) {\n        warnings.push(`Optional not set: ${envKey}`);\n      }\n      continue;\n    }\n\n    if (varConfig.validator && !varConfig.validator(rawValue)) {\n      errors.push(`Invalid value: ${envKey}`);\n    }\n\n    if (varConfig.type === \"number\" && isNaN(parseFloat(rawValue))) {\n      errors.push(`Invalid number: ${envKey}`);\n    }\n\n    if (varConfig.type === \"json\") {\n      try {\n        JSON.parse(rawValue);\n      } catch {\n        errors.push(`Invalid JSON: ${envKey}`);\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n// ============================================================================\n// Service Discovery Configuration\n// ============================================================================\n\nexport interface ServiceInfo {\n  name: string;\n  version: string;\n  description?: string;\n  capabilities?: string[];\n  endpoints?: Record<string, EndpointInfo>;\n}\n\nexport interface EndpointInfo {\n  path: string;\n  method: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\" | \"PATCH\";\n  description?: string;\n  price?: number;\n  rateLimit?: number;\n}\n\n/**\n * Create service discovery info\n */\nexport function createServiceInfo(info: ServiceInfo): ServiceInfo {\n  return {\n    ...info,\n    capabilities: info.capabilities || [],\n    endpoints: info.endpoints || {},\n  };\n}\n\n// ============================================================================\n// Price Configuration\n// ============================================================================\n\nexport interface PriceConfig {\n  [key: string]: number;\n}\n\n/**\n * Parse price from environment variable with fallback\n */\nexport function parsePrice(envVar: string | undefined, fallback: number): number {\n  if (!envVar) return fallback;\n  const parsed = parseFloat(envVar);\n  return isNaN(parsed) ? fallback : parsed;\n}\n\n/**\n * Create price configuration from environment\n */\nexport function createPriceConfig(\n  priceMap: Record<string, { envKey: string; default: number }>\n): PriceConfig {\n  const result: PriceConfig = {};\n  for (const [key, config] of Object.entries(priceMap)) {\n    result[key] = parsePrice(process.env[config.envKey], config.default);\n  }\n  return result;\n}\n\n// ============================================================================\n// Route Configuration\n// ============================================================================\n\nexport interface RouteConfig {\n  path: string;\n  price: number;\n  description?: string;\n  rateLimit?: number;\n}\n\n/**\n * Create route price mapping from price config\n */\nexport function createRouteMapping(\n  routes: Array<{ path: string; priceKey: string; description?: string }>,\n  prices: PriceConfig\n): Record<string, RouteConfig> {\n  const result: Record<string, RouteConfig> = {};\n  for (const route of routes) {\n    result[route.path] = {\n      path: route.path,\n      price: prices[route.priceKey] || 0,\n      description: route.description,\n    };\n  }\n  return result;\n}\n\n/**\n * Get price for a route path\n */\nexport function getRoutePrice(\n  routes: Record<string, RouteConfig>,\n  path: string\n): number | undefined {\n  const route = routes[path];\n  return route?.price;\n}\n\n// ============================================================================\n// Feature Flags\n// ============================================================================\n\nexport interface FeatureFlags {\n  [key: string]: boolean;\n}\n\n/**\n * Create feature flags from environment\n */\nexport function createFeatureFlags(\n  flags: Record<string, { envKey: string; default: boolean }>\n): FeatureFlags {\n  const result: FeatureFlags = {};\n  for (const [key, config] of Object.entries(flags)) {\n    const value = process.env[config.envKey];\n    result[key] =\n      value !== undefined\n        ? value.toLowerCase() === \"true\" || value === \"1\"\n        : config.default;\n  }\n  return result;\n}\n\n/**\n * Check if a feature is enabled\n */\nexport function isFeatureEnabled(\n  flags: FeatureFlags,\n  feature: string\n): boolean {\n  return flags[feature] ?? false;\n}\n"],"mappings":";AA8CO,SAAS,OAAO,KAAa,cAA2C;AAC7E,SAAO,QAAQ,IAAI,GAAG,KAAK;AAC7B;AAKO,SAAS,eAAe,KAAqB;AAClD,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,UAAa,UAAU,IAAI;AACvC,UAAM,IAAI,MAAM,iCAAiC,GAAG,aAAa;AAAA,EACnE;AACA,SAAO;AACT;AAKO,SAAS,aAAa,KAAa,cAA2C;AACnF,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,SAAS,WAAW,KAAK;AAC/B,SAAO,MAAM,MAAM,IAAI,eAAe;AACxC;AAKO,SAAS,cAAc,KAAa,cAA6C;AACtF,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,MAAM,YAAY,MAAM,UAAU,UAAU;AACrD;AAKO,SAAS,WAAc,KAAa,cAAiC;AAC1E,QAAM,QAAQ,QAAQ,IAAI,GAAG;AAC7B,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AASO,SAAS,aACd,QACiB;AACjB,QAAM,SAAkC,CAAC;AACzC,QAAM,SAAS,OAAO,SAAS,GAAG,OAAO,MAAM,MAAM;AAErD,aAAW,CAAC,KAAK,SAAS,KAAK,OAAO,QAAQ,OAAO,IAAI,GAAG;AAC1D,UAAM,SAAS,GAAG,MAAM,GAAG,GAAG;AAC9B,UAAM,WAAW,QAAQ,IAAI,MAAM;AAGnC,QAAI,aAAa,UAAa,aAAa,IAAI;AAC7C,UAAI,UAAU,YAAY,OAAO,WAAW,OAAO;AACjD,cAAM,IAAI,MAAM,iCAAiC,MAAM,aAAa;AAAA,MACtE;AACA,UAAI,UAAU,YAAY,QAAW;AACnC,eAAO,GAAG,IAAI,UAAU;AACxB;AAAA,MACF;AACA,aAAO,GAAG,IAAI;AACd;AAAA,IACF;AAGA,QAAI,UAAU,aAAa,CAAC,UAAU,UAAU,QAAQ,GAAG;AACzD,YAAM,IAAI,MAAM,0CAA0C,MAAM,EAAE;AAAA,IACpE;AAGA,QAAI,UAAU,WAAW;AACvB,aAAO,GAAG,IAAI,UAAU,UAAU,QAAQ;AAC1C;AAAA,IACF;AAEA,YAAQ,UAAU,MAAM;AAAA,MACtB,KAAK;AACH,cAAM,MAAM,WAAW,QAAQ;AAC/B,YAAI,MAAM,GAAG,GAAG;AACd,gBAAM,IAAI,MAAM,2CAA2C,MAAM,EAAE;AAAA,QACrE;AACA,eAAO,GAAG,IAAI;AACd;AAAA,MACF,KAAK;AACH,eAAO,GAAG,IAAI,SAAS,YAAY,MAAM,UAAU,aAAa;AAChE;AAAA,MACF,KAAK;AACH,YAAI;AACF,iBAAO,GAAG,IAAI,KAAK,MAAM,QAAQ;AAAA,QACnC,QAAQ;AACN,gBAAM,IAAI,MAAM,yCAAyC,MAAM,EAAE;AAAA,QACnE;AACA;AAAA,MACF;AACE,eAAO,GAAG,IAAI;AAAA,IAClB;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,eACd,QACwB;AACxB,QAAM,SAAmB,CAAC;AAC1B,QAAM,WAAqB,CAAC;AAC5B,QAAM,SAAS,OAAO,SAAS,GAAG,OAAO,MAAM,MAAM;AAErD,aAAW,CAAC,KAAK,SAAS,KAAK,OAAO,QAAQ,OAAO,IAAI,GAAG;AAC1D,UAAM,SAAS,GAAG,MAAM,GAAG,GAAG;AAC9B,UAAM,WAAW,QAAQ,IAAI,MAAM;AAEnC,QAAI,aAAa,UAAa,aAAa,IAAI;AAC7C,UAAI,UAAU,UAAU;AACtB,eAAO,KAAK,qBAAqB,MAAM,EAAE;AAAA,MAC3C,WAAW,UAAU,YAAY,QAAW;AAC1C,iBAAS,KAAK,qBAAqB,MAAM,EAAE;AAAA,MAC7C;AACA;AAAA,IACF;AAEA,QAAI,UAAU,aAAa,CAAC,UAAU,UAAU,QAAQ,GAAG;AACzD,aAAO,KAAK,kBAAkB,MAAM,EAAE;AAAA,IACxC;AAEA,QAAI,UAAU,SAAS,YAAY,MAAM,WAAW,QAAQ,CAAC,GAAG;AAC9D,aAAO,KAAK,mBAAmB,MAAM,EAAE;AAAA,IACzC;AAEA,QAAI,UAAU,SAAS,QAAQ;AAC7B,UAAI;AACF,aAAK,MAAM,QAAQ;AAAA,MACrB,QAAQ;AACN,eAAO,KAAK,iBAAiB,MAAM,EAAE;AAAA,MACvC;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,OAAO,WAAW;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AACF;AAyBO,SAAS,kBAAkB,MAAgC;AAChE,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,KAAK,gBAAgB,CAAC;AAAA,IACpC,WAAW,KAAK,aAAa,CAAC;AAAA,EAChC;AACF;AAaO,SAAS,WAAW,QAA4B,UAA0B;AAC/E,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,SAAS,WAAW,MAAM;AAChC,SAAO,MAAM,MAAM,IAAI,WAAW;AACpC;AAKO,SAAS,kBACd,UACa;AACb,QAAM,SAAsB,CAAC;AAC7B,aAAW,CAAC,KAAK,MAAM,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACpD,WAAO,GAAG,IAAI,WAAW,QAAQ,IAAI,OAAO,MAAM,GAAG,OAAO,OAAO;AAAA,EACrE;AACA,SAAO;AACT;AAgBO,SAAS,mBACd,QACA,QAC6B;AAC7B,QAAM,SAAsC,CAAC;AAC7C,aAAW,SAAS,QAAQ;AAC1B,WAAO,MAAM,IAAI,IAAI;AAAA,MACnB,MAAM,MAAM;AAAA,MACZ,OAAO,OAAO,MAAM,QAAQ,KAAK;AAAA,MACjC,aAAa,MAAM;AAAA,IACrB;AAAA,EACF;AACA,SAAO;AACT;AAKO,SAAS,cACd,QACA,MACoB;AACpB,QAAM,QAAQ,OAAO,IAAI;AACzB,SAAO,OAAO;AAChB;AAaO,SAAS,mBACd,OACc;AACd,QAAM,SAAuB,CAAC;AAC9B,aAAW,CAAC,KAAK,MAAM,KAAK,OAAO,QAAQ,KAAK,GAAG;AACjD,UAAM,QAAQ,QAAQ,IAAI,OAAO,MAAM;AACvC,WAAO,GAAG,IACR,UAAU,SACN,MAAM,YAAY,MAAM,UAAU,UAAU,MAC5C,OAAO;AAAA,EACf;AACA,SAAO;AACT;AAKO,SAAS,iBACd,OACA,SACS;AACT,SAAO,MAAM,OAAO,KAAK;AAC3B;","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@perkos/util-config",
+  "version": "1.0.0",
+  "description": "Configuration management utilities for PerkOS services",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "config",
+    "configuration",
+    "environment",
+    "perkos",
+    "x402"
+  ],
+  "author": "PerkOS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PerkOS-xyz/pkg-util-config.git"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}