@renseiai/agentfactory-server 0.8.0

package/dist/src/a2a-types.js

@@ -0,0 +1,8 @@
+/**
+ * A2A Protocol Types
+ *
+ * TypeScript type definitions for the Agent-to-Agent (A2A) protocol.
+ * Covers AgentCard discovery, JSON-RPC messaging, task lifecycle,
+ * and Server-Sent Events (SSE) streaming.
+ */
+export {};

package/dist/src/agent-tracking.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Agent Tracking Module
+ *
+ * Tracks which issues the agent has worked on to enable automated QA pickup.
+ * Also tracks QA attempts to prevent infinite loops.
+ */
+/**
+ * Record of an issue that was worked on by an agent
+ */
+export interface AgentWorkRecord {
+    issueId: string;
+    issueIdentifier: string;
+    completedAt: number;
+    sessionId: string;
+    prUrl?: string;
+}
+/**
+ * Record of QA attempts for an issue
+ */
+export interface QAAttemptRecord {
+    issueId: string;
+    attemptNumber: number;
+    startedAt: number;
+    sessionId: string;
+    previousAttempts: Array<{
+        sessionId: string;
+        failedAt: number;
+        reason?: string;
+    }>;
+}
+/**
+ * Escalation strategy computed deterministically from cycleCount.
+ * No LLM in the decision loop — pure function.
+ */
+export type EscalationStrategy = 'normal' | 'context-enriched' | 'decompose' | 'escalate-human';
+/**
+ * Workflow phase types
+ */
+export type WorkflowPhase = 'development' | 'qa' | 'refinement' | 'acceptance';
+/**
+ * Record of a single phase attempt within a workflow cycle
+ */
+export interface PhaseRecord {
+    attempt: number;
+    sessionId?: string;
+    startedAt: number;
+    completedAt?: number;
+    result?: 'passed' | 'failed' | 'unknown';
+    failureReason?: string;
+    costUsd?: number;
+}
+/**
+ * Cross-phase workflow state for an issue.
+ * Tracks the full dev-QA-rejected cycle count and accumulated failure context.
+ * Higher-level overlay on top of the existing QAAttemptRecord.
+ */
+export interface WorkflowState {
+    issueId: string;
+    issueIdentifier: string;
+    cycleCount: number;
+    phases: {
+        development: PhaseRecord[];
+        qa: PhaseRecord[];
+        refinement: PhaseRecord[];
+        acceptance: PhaseRecord[];
+    };
+    strategy: EscalationStrategy;
+    failureSummary: string | null;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Compute escalation strategy deterministically from cycle count.
+ * Pure function — no side effects, no LLM.
+ */
+export declare function computeStrategy(cycleCount: number): EscalationStrategy;
+/**
+ * Get the workflow state for an issue
+ */
+export declare function getWorkflowState(issueId: string): Promise<WorkflowState | null>;
+/**
+ * Update (partial merge) the workflow state for an issue.
+ * Creates the state if it doesn't exist.
+ */
+export declare function updateWorkflowState(issueId: string, partial: Partial<Omit<WorkflowState, 'issueId'>> & {
+    issueIdentifier?: string;
+}): Promise<WorkflowState>;
+/**
+ * Record a phase attempt in the workflow state
+ */
+export declare function recordPhaseAttempt(issueId: string, phase: WorkflowPhase, record: PhaseRecord): Promise<WorkflowState>;
+/**
+ * Increment the dev-QA-rejected cycle count and recompute strategy.
+ * Called when QA or acceptance fails and triggers a Rejected transition.
+ */
+export declare function incrementCycleCount(issueId: string): Promise<WorkflowState>;
+/**
+ * Append a failure reason to the accumulated failure summary.
+ * Format: --- Cycle {N}, {phase} Attempt {M} ({timestamp}) ---\n{reason}
+ */
+export declare function appendFailureSummary(issueId: string, newFailure: string): Promise<WorkflowState>;
+/**
+ * Clear workflow state for an issue (called on acceptance pass)
+ */
+export declare function clearWorkflowState(issueId: string): Promise<void>;
+/**
+ * Extract a structured failure reason from an agent's result message.
+ * Strips boilerplate and keeps the substantive failure description.
+ */
+export declare function extractFailureReason(resultMessage: string | undefined): string;
+/**
+ * Mark an issue as having been worked on by the agent
+ */
+export declare function markAgentWorked(issueId: string, data: Omit<AgentWorkRecord, 'issueId' | 'completedAt'>): Promise<void>;
+/**
+ * Check if an issue was worked on by the agent
+ */
+export declare function wasAgentWorked(issueId: string): Promise<AgentWorkRecord | null>;
+/**
+ * Record a QA attempt for an issue
+ */
+export declare function recordQAAttempt(issueId: string, sessionId: string): Promise<QAAttemptRecord>;
+/**
+ * Get QA attempt count for an issue
+ */
+export declare function getQAAttemptCount(issueId: string): Promise<number>;
+/**
+ * Mark an issue as having just failed QA (prevents immediate re-trigger)
+ */
+export declare function markQAFailed(issueId: string, reason?: string): Promise<void>;
+/**
+ * Check if an issue just failed QA (within cooldown period)
+ */
+export declare function didJustFailQA(issueId: string): Promise<boolean>;
+/**
+ * Clear QA failed marker (when issue is fixed and moves to Finished again)
+ */
+export declare function clearQAFailed(issueId: string): Promise<void>;
+/**
+ * Clear agent worked record (e.g., when issue is moved back to Backlog)
+ */
+export declare function clearAgentWorked(issueId: string): Promise<void>;
+/**
+ * Clear QA attempt record (e.g., after successful QA)
+ */
+export declare function clearQAAttempts(issueId: string): Promise<void>;
+/**
+ * Mark an issue as having development work just queued
+ * Prevents rapid re-queuing if status is toggled back and forth
+ */
+export declare function markDevelopmentQueued(issueId: string): Promise<void>;
+/**
+ * Check if development work was just queued for an issue (within cooldown period)
+ */
+export declare function didJustQueueDevelopment(issueId: string): Promise<boolean>;
+/**
+ * Clear development queued marker
+ */
+export declare function clearDevelopmentQueued(issueId: string): Promise<void>;
+/**
+ * Mark an issue as having acceptance work just queued
+ * Prevents rapid re-queuing if status is toggled back and forth
+ */
+export declare function markAcceptanceQueued(issueId: string): Promise<void>;
+/**
+ * Check if acceptance work was just queued for an issue (within cooldown period)
+ */
+export declare function didJustQueueAcceptance(issueId: string): Promise<boolean>;
+/**
+ * Clear acceptance queued marker
+ */
+export declare function clearAcceptanceQueued(issueId: string): Promise<void>;
+/**
+ * Clean up all tracking data for an accepted issue
+ * Called after successful acceptance processing to remove all Redis state
+ */
+export declare function cleanupAcceptedIssue(issueId: string): Promise<void>;
+/**
+ * Maximum total sessions (across all phases) allowed per issue.
+ * Once reached, no more automated sessions will be created.
+ */
+export declare const MAX_TOTAL_SESSIONS = 8;
+/**
+ * Get the total number of sessions across all workflow phases for an issue.
+ * Returns 0 if no workflow state exists.
+ */
+export declare function getTotalSessionCount(issueId: string): Promise<number>;
+/**
+ * Mark an issue as having just completed acceptance.
+ * Prevents re-triggering acceptance within the cooldown window.
+ */
+export declare function markAcceptanceCompleted(issueId: string): Promise<void>;
+/**
+ * Check if acceptance was recently completed for an issue (within cooldown period)
+ */
+export declare function didAcceptanceJustComplete(issueId: string): Promise<boolean>;
+/**
+ * Clear acceptance completed marker
+ */
+export declare function clearAcceptanceCompleted(issueId: string): Promise<void>;
+//# sourceMappingURL=agent-tracking.d.ts.map

package/dist/src/agent-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tracking.d.ts","sourceRoot":"","sources":["../../src/agent-tracking.ts"],"names":[],"mappings":"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"}

package/dist/src/agent-tracking.js

@@ -0,0 +1,349 @@
+/**
+ * Agent Tracking Module
+ *
+ * Tracks which issues the agent has worked on to enable automated QA pickup.
+ * Also tracks QA attempts to prevent infinite loops.
+ */
+import { redisSet, redisGet, redisExists, redisDel } from './redis.js';
+const log = {
+    info: (msg, data) => console.log(`[tracking] ${msg}`, data ? JSON.stringify(data) : ''),
+    warn: (msg, data) => console.warn(`[tracking] ${msg}`, data ? JSON.stringify(data) : ''),
+    error: (msg, data) => console.error(`[tracking] ${msg}`, data ? JSON.stringify(data) : ''),
+    debug: (_msg, _data) => { },
+};
+// Redis key prefixes
+const AGENT_WORKED_PREFIX = 'agent:worked:';
+const QA_ATTEMPT_PREFIX = 'qa:attempt:';
+const QA_FAILED_PREFIX = 'qa:failed:';
+const DEV_QUEUED_PREFIX = 'agent:dev-queued:';
+const ACCEPTANCE_QUEUED_PREFIX = 'agent:acceptance-queued:';
+const ACCEPTANCE_COMPLETED_PREFIX = 'agent:acceptance-completed:';
+const WORKFLOW_STATE_PREFIX = 'workflow:state:';
+// TTLs in seconds
+const AGENT_WORKED_TTL = 7 * 24 * 60 * 60; // 7 days
+const QA_ATTEMPT_TTL = 24 * 60 * 60; // 24 hours
+const QA_FAILED_TTL = 60 * 60; // 1 hour
+const DEV_QUEUED_TTL = 300; // 5 minutes
+const ACCEPTANCE_QUEUED_TTL = 300; // 5 minutes
+const ACCEPTANCE_COMPLETED_TTL = 30 * 60; // 30 minutes
+const WORKFLOW_STATE_TTL = 30 * 24 * 60 * 60; // 30 days
+/**
+ * Compute escalation strategy deterministically from cycle count.
+ * Pure function — no side effects, no LLM.
+ */
+export function computeStrategy(cycleCount) {
+    if (cycleCount <= 1)
+        return 'normal';
+    if (cycleCount === 2)
+        return 'context-enriched';
+    if (cycleCount === 3)
+        return 'decompose';
+    return 'escalate-human';
+}
+/**
+ * Get the workflow state for an issue
+ */
+export async function getWorkflowState(issueId) {
+    const key = `${WORKFLOW_STATE_PREFIX}${issueId}`;
+    return redisGet(key);
+}
+/**
+ * Update (partial merge) the workflow state for an issue.
+ * Creates the state if it doesn't exist.
+ */
+export async function updateWorkflowState(issueId, partial) {
+    const key = `${WORKFLOW_STATE_PREFIX}${issueId}`;
+    const existing = await redisGet(key);
+    const state = {
+        issueId,
+        issueIdentifier: partial.issueIdentifier ?? existing?.issueIdentifier ?? '',
+        cycleCount: partial.cycleCount ?? existing?.cycleCount ?? 0,
+        phases: {
+            development: partial.phases?.development ?? existing?.phases?.development ?? [],
+            qa: partial.phases?.qa ?? existing?.phases?.qa ?? [],
+            refinement: partial.phases?.refinement ?? existing?.phases?.refinement ?? [],
+            acceptance: partial.phases?.acceptance ?? existing?.phases?.acceptance ?? [],
+        },
+        strategy: partial.strategy ?? existing?.strategy ?? 'normal',
+        failureSummary: partial.failureSummary !== undefined ? partial.failureSummary : (existing?.failureSummary ?? null),
+        createdAt: existing?.createdAt ?? Date.now(),
+        updatedAt: Date.now(),
+    };
+    await redisSet(key, state, WORKFLOW_STATE_TTL);
+    return state;
+}
+/**
+ * Record a phase attempt in the workflow state
+ */
+export async function recordPhaseAttempt(issueId, phase, record) {
+    const existing = await getWorkflowState(issueId);
+    const phases = existing?.phases ?? { development: [], qa: [], refinement: [], acceptance: [] };
+    phases[phase] = [...phases[phase], record];
+    return updateWorkflowState(issueId, { phases });
+}
+/**
+ * Increment the dev-QA-rejected cycle count and recompute strategy.
+ * Called when QA or acceptance fails and triggers a Rejected transition.
+ */
+export async function incrementCycleCount(issueId) {
+    const existing = await getWorkflowState(issueId);
+    const newCount = (existing?.cycleCount ?? 0) + 1;
+    const strategy = computeStrategy(newCount);
+    log.info('Workflow cycle incremented', { issueId, cycleCount: newCount, strategy });
+    return updateWorkflowState(issueId, { cycleCount: newCount, strategy });
+}
+/**
+ * Append a failure reason to the accumulated failure summary.
+ * Format: --- Cycle {N}, {phase} Attempt {M} ({timestamp}) ---\n{reason}
+ */
+export async function appendFailureSummary(issueId, newFailure) {
+    const existing = await getWorkflowState(issueId);
+    const currentSummary = existing?.failureSummary ?? '';
+    const updatedSummary = currentSummary
+        ? `${currentSummary}\n\n${newFailure}`
+        : newFailure;
+    return updateWorkflowState(issueId, { failureSummary: updatedSummary });
+}
+/**
+ * Clear workflow state for an issue (called on acceptance pass)
+ */
+export async function clearWorkflowState(issueId) {
+    const key = `${WORKFLOW_STATE_PREFIX}${issueId}`;
+    await redisDel(key);
+    log.info('Cleared workflow state', { issueId });
+}
+/**
+ * Extract a structured failure reason from an agent's result message.
+ * Strips boilerplate and keeps the substantive failure description.
+ */
+export function extractFailureReason(resultMessage) {
+    if (!resultMessage)
+        return 'No result message provided';
+    // Try to extract from structured sections
+    const failurePatterns = [
+        /##\s*(?:QA\s+)?(?:Failed|Failure|Issues?\s+Found)[^\n]*\n([\s\S]*?)(?=\n##|\n<!--|\Z)/i,
+        /(?:Fail(?:ure|ed)\s+(?:Reason|Details?|Summary)):?\s*([\s\S]*?)(?=\n##|\n<!--|\Z)/i,
+        /(?:Issues?\s+Found|Problems?\s+Found):?\s*([\s\S]*?)(?=\n##|\n<!--|\Z)/i,
+    ];
+    for (const pattern of failurePatterns) {
+        const match = resultMessage.match(pattern);
+        if (match?.[1]) {
+            const extracted = match[1].trim();
+            if (extracted.length > 20) {
+                // Truncate if excessively long
+                return extracted.length > 2000 ? extracted.slice(0, 2000) + '...' : extracted;
+            }
+        }
+    }
+    // Fallback: take the last meaningful paragraph (often the conclusion)
+    const paragraphs = resultMessage.split(/\n\n+/).filter(p => p.trim().length > 20);
+    if (paragraphs.length > 0) {
+        const last = paragraphs[paragraphs.length - 1].trim();
+        return last.length > 2000 ? last.slice(0, 2000) + '...' : last;
+    }
+    return resultMessage.slice(0, 500);
+}
+/**
+ * Mark an issue as having been worked on by the agent
+ */
+export async function markAgentWorked(issueId, data) {
+    const key = `${AGENT_WORKED_PREFIX}${issueId}`;
+    const record = {
+        ...data,
+        issueId,
+        completedAt: Date.now(),
+    };
+    await redisSet(key, record, AGENT_WORKED_TTL);
+    log.info('Marked agent worked', {
+        issueId,
+        issueIdentifier: data.issueIdentifier,
+    });
+}
+/**
+ * Check if an issue was worked on by the agent
+ */
+export async function wasAgentWorked(issueId) {
+    const key = `${AGENT_WORKED_PREFIX}${issueId}`;
+    return redisGet(key);
+}
+/**
+ * Record a QA attempt for an issue
+ */
+export async function recordQAAttempt(issueId, sessionId) {
+    const key = `${QA_ATTEMPT_PREFIX}${issueId}`;
+    const existing = await redisGet(key);
+    const record = {
+        issueId,
+        attemptNumber: (existing?.attemptNumber ?? 0) + 1,
+        startedAt: Date.now(),
+        sessionId,
+        previousAttempts: existing?.previousAttempts ?? [],
+    };
+    // Add current attempt to history if this is a retry
+    if (existing) {
+        record.previousAttempts.push({
+            sessionId: existing.sessionId,
+            failedAt: Date.now(),
+        });
+    }
+    await redisSet(key, record, QA_ATTEMPT_TTL);
+    log.info('Recorded QA attempt', {
+        issueId,
+        attemptNumber: record.attemptNumber,
+    });
+    return record;
+}
+/**
+ * Get QA attempt count for an issue
+ */
+export async function getQAAttemptCount(issueId) {
+    const key = `${QA_ATTEMPT_PREFIX}${issueId}`;
+    const record = await redisGet(key);
+    return record?.attemptNumber ?? 0;
+}
+/**
+ * Mark an issue as having just failed QA (prevents immediate re-trigger)
+ */
+export async function markQAFailed(issueId, reason) {
+    const key = `${QA_FAILED_PREFIX}${issueId}`;
+    await redisSet(key, { failedAt: Date.now(), reason }, QA_FAILED_TTL);
+    log.info('Marked QA failed', { issueId, reason });
+}
+/**
+ * Check if an issue just failed QA (within cooldown period)
+ */
+export async function didJustFailQA(issueId) {
+    const key = `${QA_FAILED_PREFIX}${issueId}`;
+    return redisExists(key);
+}
+/**
+ * Clear QA failed marker (when issue is fixed and moves to Finished again)
+ */
+export async function clearQAFailed(issueId) {
+    const key = `${QA_FAILED_PREFIX}${issueId}`;
+    await redisDel(key);
+    log.debug('Cleared QA failed marker', { issueId });
+}
+/**
+ * Clear agent worked record (e.g., when issue is moved back to Backlog)
+ */
+export async function clearAgentWorked(issueId) {
+    const key = `${AGENT_WORKED_PREFIX}${issueId}`;
+    await redisDel(key);
+    log.debug('Cleared agent worked marker', { issueId });
+}
+/**
+ * Clear QA attempt record (e.g., after successful QA)
+ */
+export async function clearQAAttempts(issueId) {
+    const key = `${QA_ATTEMPT_PREFIX}${issueId}`;
+    await redisDel(key);
+    log.debug('Cleared QA attempts', { issueId });
+}
+/**
+ * Mark an issue as having development work just queued
+ * Prevents rapid re-queuing if status is toggled back and forth
+ */
+export async function markDevelopmentQueued(issueId) {
+    const key = `${DEV_QUEUED_PREFIX}${issueId}`;
+    await redisSet(key, { queuedAt: Date.now() }, DEV_QUEUED_TTL);
+    log.info('Marked development queued', { issueId });
+}
+/**
+ * Check if development work was just queued for an issue (within cooldown period)
+ */
+export async function didJustQueueDevelopment(issueId) {
+    const key = `${DEV_QUEUED_PREFIX}${issueId}`;
+    return redisExists(key);
+}
+/**
+ * Clear development queued marker
+ */
+export async function clearDevelopmentQueued(issueId) {
+    const key = `${DEV_QUEUED_PREFIX}${issueId}`;
+    await redisDel(key);
+    log.debug('Cleared development queued marker', { issueId });
+}
+/**
+ * Mark an issue as having acceptance work just queued
+ * Prevents rapid re-queuing if status is toggled back and forth
+ */
+export async function markAcceptanceQueued(issueId) {
+    const key = `${ACCEPTANCE_QUEUED_PREFIX}${issueId}`;
+    await redisSet(key, { queuedAt: Date.now() }, ACCEPTANCE_QUEUED_TTL);
+    log.info('Marked acceptance queued', { issueId });
+}
+/**
+ * Check if acceptance work was just queued for an issue (within cooldown period)
+ */
+export async function didJustQueueAcceptance(issueId) {
+    const key = `${ACCEPTANCE_QUEUED_PREFIX}${issueId}`;
+    return redisExists(key);
+}
+/**
+ * Clear acceptance queued marker
+ */
+export async function clearAcceptanceQueued(issueId) {
+    const key = `${ACCEPTANCE_QUEUED_PREFIX}${issueId}`;
+    await redisDel(key);
+    log.debug('Cleared acceptance queued marker', { issueId });
+}
+/**
+ * Clean up all tracking data for an accepted issue
+ * Called after successful acceptance processing to remove all Redis state
+ */
+export async function cleanupAcceptedIssue(issueId) {
+    const keysToDelete = [
+        `${AGENT_WORKED_PREFIX}${issueId}`,
+        `${QA_ATTEMPT_PREFIX}${issueId}`,
+        `${QA_FAILED_PREFIX}${issueId}`,
+        `${DEV_QUEUED_PREFIX}${issueId}`,
+        `${ACCEPTANCE_QUEUED_PREFIX}${issueId}`,
+        `${ACCEPTANCE_COMPLETED_PREFIX}${issueId}`,
+        `${WORKFLOW_STATE_PREFIX}${issueId}`,
+    ];
+    await Promise.all(keysToDelete.map((key) => redisDel(key)));
+    log.info('Cleaned up all tracking data for accepted issue', { issueId });
+}
+/**
+ * Maximum total sessions (across all phases) allowed per issue.
+ * Once reached, no more automated sessions will be created.
+ */
+export const MAX_TOTAL_SESSIONS = 8;
+/**
+ * Get the total number of sessions across all workflow phases for an issue.
+ * Returns 0 if no workflow state exists.
+ */
+export async function getTotalSessionCount(issueId) {
+    const state = await getWorkflowState(issueId);
+    if (!state)
+        return 0;
+    return (state.phases.development.length +
+        state.phases.qa.length +
+        state.phases.refinement.length +
+        state.phases.acceptance.length);
+}
+/**
+ * Mark an issue as having just completed acceptance.
+ * Prevents re-triggering acceptance within the cooldown window.
+ */
+export async function markAcceptanceCompleted(issueId) {
+    const key = `${ACCEPTANCE_COMPLETED_PREFIX}${issueId}`;
+    await redisSet(key, { completedAt: Date.now() }, ACCEPTANCE_COMPLETED_TTL);
+    log.info('Marked acceptance completed', { issueId });
+}
+/**
+ * Check if acceptance was recently completed for an issue (within cooldown period)
+ */
+export async function didAcceptanceJustComplete(issueId) {
+    const key = `${ACCEPTANCE_COMPLETED_PREFIX}${issueId}`;
+    return redisExists(key);
+}
+/**
+ * Clear acceptance completed marker
+ */
+export async function clearAcceptanceCompleted(issueId) {
+    const key = `${ACCEPTANCE_COMPLETED_PREFIX}${issueId}`;
+    await redisDel(key);
+    log.debug('Cleared acceptance completed marker', { issueId });
+}

package/dist/src/env-validation.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Environment Variable Validation
+ *
+ * Validates required environment variables on startup.
+ * Fails fast if critical security variables are missing in production.
+ */
+/**
+ * Configuration for environment validation
+ */
+export interface EnvValidationConfig {
+    /** Variable names required in production */
+    requiredVars?: string[];
+    /** Variables that need minimum length validation */
+    minLengthVars?: Array<{
+        name: string;
+        minLength: number;
+    }>;
+}
+/**
+ * Validation result
+ */
+export interface EnvValidationResult {
+    valid: boolean;
+    missing: string[];
+    warnings: string[];
+}
+/**
+ * Validate environment variables
+ *
+ * In production: All required vars must be present
+ * In development: Log warnings for missing vars but don't fail
+ *
+ * @param config - Optional configuration to override defaults
+ * @returns Validation result with missing vars
+ */
+export declare function validateEnv(config?: EnvValidationConfig): EnvValidationResult;
+/**
+ * Validate and fail fast if critical vars are missing
+ *
+ * Call this at application startup to ensure required
+ * environment variables are configured.
+ *
+ * @param config - Optional configuration to override defaults
+ * @throws Error if required vars are missing in production
+ */
+export declare function validateEnvOrThrow(config?: EnvValidationConfig): void;
+/**
+ * Check if webhook signature verification is configured
+ */
+export declare function isWebhookSecretConfigured(): boolean;
+/**
+ * Check if cron authentication is configured
+ */
+export declare function isCronSecretConfigured(): boolean;
+/**
+ * Check if session hashing is configured
+ */
+export declare function isSessionHashConfigured(): boolean;
+/**
+ * Get session hash salt
+ * @param saltEnvVar - Environment variable name for the salt (default: SESSION_HASH_SALT)
+ * @throws Error if not configured
+ */
+export declare function getSessionHashSalt(saltEnvVar?: string): string;
+//# sourceMappingURL=env-validation.d.ts.map

package/dist/src/env-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validation.d.ts","sourceRoot":"","sources":["../../src/env-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,oDAAoD;IACpD,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC3D;AA8BD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,CAkC7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAsBrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,SAAsB,GAAG,MAAM,CAM3E"}