core-services-sdk 1.3.76 → 1.3.77

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-services-sdk",
-  "version": "1.3.76",
+  "version": "1.3.77",
   "main": "src/index.js",
   "type": "module",
   "types": "types/index.d.ts",

package/src/env/env-validation.js

@@ -361,3 +361,51 @@ export function validateAndReportEnv(definition, values, options = {}) {
     output,
   }
 }
+
+/**
+ * Validates environment variables and prepares
+ * a printable table output.
+ *
+ * No side effects. Does NOT print.
+ *
+ * @param {Record<string, Object>} definition
+ * @param {Record<string, any>} values
+ * @param {{
+ *   mask?: (value: any) => string
+ * }} [options]
+ *
+ * @returns {{
+ *   success: boolean,
+ *   table: string,
+ *   validation: {
+ *     success: boolean,
+ *     data?: Record<string, any>,
+ *     summary?: Record<string, string[]>
+ *   },
+ *   report: {
+ *     success: boolean,
+ *     params: Array<{
+ *       key: string,
+ *       value: any,
+ *       displayValue: string,
+ *       secret: boolean,
+ *       valid: boolean,
+ *       errors?: string[]
+ *     }>
+ *   }
+ * }}
+ */
+export function prepareEnvValidation(definition, values, options = {}) {
+  const { mask } = options
+
+  const validation = validateEnv(definition, values)
+  const report = buildEnvReport(definition, values, validation, mask)
+  const table = formatEnvReport(report)
+
+  return {
+    success: validation.success,
+    table,
+    validation,
+    report,
+  }
+}

package/tests/env/env-validation.demo.js

@@ -0,0 +1,86 @@
+// @ts-nocheck
+import { prepareEnvValidation } from '../../src/env/env-validation.js'
+
+const mask = (value) => {
+  if (value == null) {
+    return '******'
+  }
+
+  const str = String(value)
+  if (str.length <= 4) {
+    return '****'
+  }
+
+  return `${str.slice(0, 2)}****${str.slice(-2)}`
+}
+
+const definition = {
+  PORT: {
+    type: 'number',
+    required: true,
+    int: true,
+    min: 1,
+    max: 65535,
+  },
+  TIMEOUT: {
+    type: 'number',
+    min: 100,
+    max: 10000,
+  },
+  DEBUG: {
+    type: 'boolean',
+  },
+  MODE: {
+    type: 'string',
+    enum: ['development', 'production'],
+  },
+  API_KEY: {
+    type: 'string',
+    secret: true,
+  },
+}
+
+const scenarios = [
+  {
+    title: '✅ All valid values',
+    values: {
+      PORT: 3000,
+      TIMEOUT: 500,
+      DEBUG: false,
+      MODE: 'development',
+      API_KEY: 'secret123',
+    },
+  },
+  {
+    title: '❌ Invalid port',
+    values: {
+      PORT: 0,
+      TIMEOUT: 500,
+      MODE: 'production',
+    },
+  },
+  {
+    title: '❌ Invalid enum',
+    values: {
+      PORT: 3000,
+      TIMEOUT: 500,
+      MODE: 'prod',
+      API_KEY: 'secret123',
+    },
+  },
+]
+
+for (const scenario of scenarios) {
+  console.log('\n===================================================')
+  console.log(scenario.title)
+  console.log('===================================================\n')
+
+  const result = prepareEnvValidation(definition, scenario.values, { mask })
+
+  // פה הבחירה שלך מה לעשות עם זה
+  console.log(result.table)
+
+  if (!result.success) {
+    console.log('⚠️  Scenario failed validation')
+  }
+}

package/tests/env/prepare-env-validation.test.js

@@ -0,0 +1,84 @@
+import { describe, it, expect } from 'vitest'
+import { prepareEnvValidation } from '../../src/env/env-validation.js'
+
+describe('prepareEnvValidation', () => {
+  const definition = {
+    PORT: {
+      type: 'number',
+      required: true,
+      int: true,
+      min: 1,
+      max: 65535,
+    },
+    MODE: {
+      type: 'string',
+      enum: ['development', 'production'],
+      required: true,
+    },
+    API_KEY: {
+      type: 'string',
+      secret: true,
+    },
+  }
+
+  it('returns success and a printable table when values are valid', () => {
+    const values = {
+      PORT: '3000',
+      MODE: 'development',
+      API_KEY: 'secret',
+    }
+
+    const result = prepareEnvValidation(definition, values, { mask })
+
+    expect(result.success).toBe(true)
+    expect(result.validation.success).toBe(true)
+
+    expect(result.table).toContain('Environment variables')
+    expect(result.table).toContain('PORT')
+    expect(result.table).toContain('MODE')
+    expect(result.table).toContain('API_KEY')
+
+    expect(result.table).toContain('OK')
+    expect(result.table).toContain('****')
+    expect(result.table).not.toContain('secret')
+  })
+
+  it('returns failure and error table when required value is missing', () => {
+    const values = {
+      MODE: 'production',
+    }
+
+    const result = prepareEnvValidation(definition, values)
+
+    expect(result.success).toBe(false)
+    expect(result.validation.success).toBe(false)
+
+    expect(result.table).toContain('ERROR')
+    expect(result.table).toContain('PORT')
+  })
+
+  it('coerces number values correctly', () => {
+    const values = {
+      PORT: '8080',
+      MODE: 'production',
+      API_KEY: 'x',
+    }
+
+    const result = prepareEnvValidation(definition, values)
+
+    expect(result.success).toBe(true)
+    expect(result.validation.data.PORT).toBe(8080)
+  })
+
+  it('returns a table string even on failure', () => {
+    const values = {
+      PORT: 0,
+      MODE: 'development',
+    }
+
+    const result = prepareEnvValidation(definition, values)
+
+    expect(typeof result.table).toBe('string')
+    expect(result.table.length).toBeGreaterThan(0)
+  })
+})

package/types/env/env-validation.d.ts

@@ -220,3 +220,62 @@ export function validateAndReportEnv(
   }
   output: string
 }
+/**
+ * Validates environment variables and prepares
+ * a printable table output.
+ *
+ * No side effects. Does NOT print.
+ *
+ * @param {Record<string, Object>} definition
+ * @param {Record<string, any>} values
+ * @param {{
+ *   mask?: (value: any) => string
+ * }} [options]
+ *
+ * @returns {{
+ *   success: boolean,
+ *   table: string,
+ *   validation: {
+ *     success: boolean,
+ *     data?: Record<string, any>,
+ *     summary?: Record<string, string[]>
+ *   },
+ *   report: {
+ *     success: boolean,
+ *     params: Array<{
+ *       key: string,
+ *       value: any,
+ *       displayValue: string,
+ *       secret: boolean,
+ *       valid: boolean,
+ *       errors?: string[]
+ *     }>
+ *   }
+ * }}
+ */
+export function prepareEnvValidation(
+  definition: Record<string, any>,
+  values: Record<string, any>,
+  options?: {
+    mask?: (value: any) => string
+  },
+): {
+  success: boolean
+  table: string
+  validation: {
+    success: boolean
+    data?: Record<string, any>
+    summary?: Record<string, string[]>
+  }
+  report: {
+    success: boolean
+    params: Array<{
+      key: string
+      value: any
+      displayValue: string
+      secret: boolean
+      valid: boolean
+      errors?: string[]
+    }>
+  }
+}