@with-logic/intent 0.1.0

package/dist/intent.js

@@ -0,0 +1,540 @@
+import { batchProcess } from "./batches";
+import { CONFIG } from "./config";
+import { DEFAULT_KEY_EXTRACTOR, DEFAULT_SUMMARY_EXTRACTOR } from "./extractors";
+import { clamp } from "./lib/number";
+import { selectLlmClient } from "./llm_client";
+import { buildChoiceMessages, buildFilterMessages, buildMessages } from "./messages";
+import { buildChoiceSchema, buildFilterSchema, buildRelevancySchema } from "./schema";
+/**
+ * LLM-based reranker for arbitrary items.
+ *
+ * Uses a listwise LLM approach to score candidates within a configurable range based on relevance to a query,
+ * then filters by threshold and returns results sorted by score with stable ordering.
+ *
+ * @template T - The type of items to rerank (defaults to any)
+ *
+ * @example
+ * ```typescript
+ * // Simplest: uses defaults and GROQ_API_KEY from environment
+ * const intent = new Intent();
+ * const ranked = await intent.rank("find expense reports", items);
+ *
+ * // With custom extractors
+ * type Document = { id: string; title: string; content: string };
+ * const intent = new Intent<Document>({
+ *   key: doc => doc.title,
+ *   summary: doc => doc.content.slice(0, 200),
+ *   relevancyThreshold: 5,
+ *   batchSize: 20
+ * });
+ *
+ * // With custom LLM client
+ * const intent = new Intent<Document>({
+ *   llm: myClient,
+ *   userId: "user-123",
+ *   key: doc => doc.title,
+ *   summary: doc => doc.content.slice(0, 200)
+ * });
+ * ```
+ */
+export class Intent {
+    /**
+     * Resolve the model name to use for this Intent instance.
+     *
+     * Intent is provider-driven. Today only GROQ is supported; when using GROQ
+     * we always take the model from GROQ's config defaults.
+     *
+     * @returns Provider-specific model name
+     * @private
+     */
+    resolveModel() {
+        return this.env.GROQ.DEFAULT_MODEL;
+    }
+    /**
+     * Builds the context object from options.
+     *
+     * Constructs an IntentContext with only defined properties to satisfy
+     * TypeScript's exactOptionalPropertyTypes requirement.
+     *
+     * @param options - The options object containing llm, logger, and userId
+     * @returns IntentContext with only defined properties
+     * @private
+     */
+    buildContext(options) {
+        return {
+            ...(options.llm !== undefined && { llm: options.llm }),
+            ...(options.logger !== undefined && { logger: options.logger }),
+            ...(options.userId !== undefined && { userId: options.userId }),
+        };
+    }
+    /**
+     * Builds the extractors object from options.
+     *
+     * Uses provided extractors or falls back to generic defaults that work
+     * for any type T via JSON stringification and hashing.
+     *
+     * @param options - The options object containing key and summary extractors
+     * @returns Required extractors with defaults applied
+     * @private
+     */
+    buildExtractors(options) {
+        return {
+            key: options.key ?? (DEFAULT_KEY_EXTRACTOR),
+            summary: options.summary ?? (DEFAULT_SUMMARY_EXTRACTOR),
+        };
+    }
+    /**
+     * Builds the configuration object from options.
+     *
+     * Merges user-provided options with environment-based CONFIG defaults.
+     *
+     * @param options - The options object containing config overrides
+     * @returns Required config with all values populated
+     * @private
+     */
+    buildConfig(options) {
+        return {
+            provider: options.provider ?? this.env.INTENT.PROVIDER,
+            timeoutMs: options.timeoutMs ?? this.env.INTENT.TIMEOUT_MS,
+            relevancyThreshold: options.relevancyThreshold ?? this.env.INTENT.RELEVANCY_THRESHOLD,
+            batchSize: options.batchSize ?? this.env.INTENT.BATCH_SIZE,
+            tinyBatchFraction: options.tinyBatchFraction ?? this.env.INTENT.TINY_BATCH_FRACTION,
+            minScore: options.minScore ?? this.env.INTENT.MIN_SCORE,
+            maxScore: options.maxScore ?? this.env.INTENT.MAX_SCORE,
+        };
+    }
+    /**
+     * Validates the configuration values.
+     *
+     * Ensures the configured score range is valid and the relevancyThreshold is in range.
+     *
+     * @throws {Error} If maxScore is below minScore
+     * @throws {Error} If relevancyThreshold is not within [minScore, maxScore]
+     * @private
+     */
+    validateConfig() {
+        if (this.cfg.maxScore < this.cfg.minScore) {
+            throw new Error(`intent: maxScore must be >= minScore, got minScore=${this.cfg.minScore} maxScore=${this.cfg.maxScore}`);
+        }
+        if (this.cfg.relevancyThreshold < this.cfg.minScore ||
+            this.cfg.relevancyThreshold > this.cfg.maxScore) {
+            throw new Error(`intent: relevancyThreshold must be between ${this.cfg.minScore} and ${this.cfg.maxScore}, got ${this.cfg.relevancyThreshold}`);
+        }
+    }
+    /**
+     * Selects and validates the LLM client.
+     *
+     * Uses the provided client from context or attempts to create a default
+     * Groq client if GROQ_API_KEY is available.
+     *
+     * @returns The selected LLM client
+     * @throws {Error} If no LLM client is provided and GROQ_API_KEY is not set
+     * @private
+     */
+    selectAndValidateLlmClient() {
+        const selectedClient = selectLlmClient(this.ctx, this.env);
+        if (!selectedClient) {
+            throw new Error("intent: No LLM client provided and GROQ_API_KEY not set. Provide options.llm or set GROQ_API_KEY.");
+        }
+        return selectedClient;
+    }
+    /**
+     * Creates a new Intent instance.
+     *
+     * All options are optional with sensible defaults:
+     * - llm: Auto-detected from GROQ_API_KEY environment variable if available
+     * - key: Hash-based string from JSON representation of items
+     * - summary: Pretty-printed JSON of items (2-space indentation for LLM readability)
+     * - Config values: From INTENT_* environment variables or built-in defaults
+     *
+     * @param options - Optional configuration object
+     * @param options.llm - Optional LLM client. If omitted, uses Groq client when GROQ_API_KEY is set
+     * @param options.logger - Optional logger for warnings and errors
+     * @param options.userId - Optional user identifier for LLM provider abuse monitoring
+     * @param options.key - Optional function extracting a short human-readable key from items
+     * @param options.summary - Optional function extracting a short description for LLM reasoning
+     * @param options.provider - Optional provider override (default: INTENT_PROVIDER or "GROQ")
+     * @param options.timeoutMs - Optional timeout in milliseconds (default: INTENT_TIMEOUT_MS or 3000)
+     * @param options.relevancyThreshold - Optional minimum score to include results (default: INTENT_RELEVANCY_THRESHOLD)
+     * @param options.minScore - Optional minimum score value (default: INTENT_MIN_SCORE or 0)
+     * @param options.maxScore - Optional maximum score value (default: INTENT_MAX_SCORE or 10)
+     * @param options.batchSize - Optional number of candidates per LLM call (default: INTENT_BATCH_SIZE or 20)
+     * @param options.tinyBatchFraction - Optional threshold for merging small batches (default: INTENT_TINY_BATCH_FRACTION or 0.2)
+     * @throws {Error} If no LLM client is provided and GROQ_API_KEY is not set
+     * @throws {Error} If maxScore is below minScore
+     * @throws {Error} If relevancyThreshold is not within [minScore, maxScore]
+     *
+     * @example
+     * ```typescript
+     * // Minimal - uses all defaults
+     * const intent = new Intent();
+     *
+     * // With extractors
+     * const intent = new Intent<Doc>({
+     *   key: doc => doc.title,
+     *   summary: doc => doc.content
+     * });
+     *
+     * // Full configuration
+     * const intent = new Intent<Doc>({
+     *   llm: myClient,
+     *   userId: "org-123",
+     *   key: doc => doc.title,
+     *   summary: doc => doc.content,
+     *   relevancyThreshold: 5,
+     *   batchSize: 20
+     * });
+     * ```
+     */
+    constructor(options = {}) {
+        this.env = options.config ?? CONFIG;
+        this.ctx = this.buildContext(options);
+        this.extractors = this.buildExtractors(options);
+        this.cfg = this.buildConfig(options);
+        this.validateConfig();
+        this.llm = this.selectAndValidateLlmClient();
+    }
+    async rank(query, candidates, options) {
+        try {
+            if (candidates.length === 0) {
+                return [];
+            }
+            if (candidates.length === 1) {
+                if (options?.explain) {
+                    const [firstCandidate] = candidates;
+                    return [{ item: firstCandidate, explanation: "" }];
+                }
+                return candidates;
+            }
+            const prepared = this.prepareCandidates(candidates);
+            const rankedWithExplanations = await batchProcess(prepared, this.cfg.batchSize, this.cfg.tinyBatchFraction, async (batch) => (await this.processBatch(query, batch, options?.userId !== undefined ? { userId: options.userId } : undefined)), this.ctx.logger, (batch) => batch.map(({ item }) => ({ item, explanation: "" })));
+            if (options?.explain) {
+                return rankedWithExplanations;
+            }
+            return rankedWithExplanations.map(({ item }) => item);
+        }
+        catch (error) {
+            this.ctx.logger?.warn?.("intent reranker failed, using fallback", {
+                error: error?.message,
+            });
+            if (options?.explain) {
+                return candidates.map((item) => ({ item, explanation: "" }));
+            }
+            return candidates;
+        }
+    }
+    async filter(query, candidates, options) {
+        if (candidates.length === 0) {
+            return [];
+        }
+        if (candidates.length === 1) {
+            if (options?.explain) {
+                const [firstCandidate] = candidates;
+                return [{ item: firstCandidate, explanation: "" }];
+            }
+            return candidates;
+        }
+        const prepared = this.prepareCandidates(candidates);
+        const filteredWithExplanations = await batchProcess(prepared, this.cfg.batchSize, this.cfg.tinyBatchFraction, async (batch) => (await this.processFilterBatch(query, batch, options?.userId !== undefined ? { userId: options.userId } : undefined)), this.ctx.logger, (batch) => batch.map(({ item }) => ({ item, explanation: "" })));
+        if (options?.explain) {
+            return filteredWithExplanations;
+        }
+        return filteredWithExplanations.map(({ item }) => item);
+    }
+    async choice(query, candidates, options) {
+        if (candidates.length === 0) {
+            throw new Error("intent: choice requires at least one candidate");
+        }
+        if (candidates.length === 1) {
+            const [firstCandidate] = candidates;
+            if (options?.explain) {
+                return { item: firstCandidate, explanation: "" };
+            }
+            return firstCandidate;
+        }
+        const prepared = this.prepareCandidates(candidates);
+        const keyed = this.ensureUniqueKeys(prepared);
+        const winners = await batchProcess(keyed, this.cfg.batchSize, this.cfg.tinyBatchFraction, async (batch) => [await this.processChoiceBatch(query, batch, options?.userId)], this.ctx.logger, (batch) => [{ item: batch[0].item, explanation: "" }]);
+        // batchProcess guarantees at least one winner via its per-batch fallback.
+        if (winners.length === 1) {
+            const [onlyWinner] = winners;
+            if (options?.explain) {
+                return onlyWinner;
+            }
+            return onlyWinner.item;
+        }
+        const preparedFinalists = this.prepareCandidates(winners.map((w) => w.item));
+        const keyedFinalists = this.ensureUniqueKeys(preparedFinalists);
+        const final = await this.processChoiceBatch(query, keyedFinalists, options?.userId);
+        if (options?.explain) {
+            return final;
+        }
+        return final.item;
+    }
+    /**
+     * Normalize incoming items into a consistent shape for downstream processing.
+     *
+     * Extracts the key and summary from each item using the configured extractors,
+     * and attaches the original input index for stable sorting later.
+     *
+     * @param candidates - Raw items to prepare
+     * @returns Array of prepared candidates with extracted metadata and original index
+     * @private
+     */
+    prepareCandidates(candidates) {
+        return candidates.map((item, idx) => ({
+            item,
+            idx,
+            baseKey: this.extractors.key(item),
+            summary: this.extractors.summary(item),
+        }));
+    }
+    /**
+     * Ensure keys are unique by suffixing duplicates with their input index.
+     *
+     * When multiple items share the same key, subsequent occurrences are renamed
+     * to "Key (idx)" where idx is the original input index. This prevents JSON
+     * schema validation errors and ensures the LLM can score each item independently.
+     *
+     * @param itemsBase - Prepared candidates with potentially duplicate keys
+     * @returns Candidates with guaranteed unique keys
+     * @private
+     */
+    ensureUniqueKeys(itemsBase) {
+        const counts = new Map();
+        return itemsBase.map(({ item, baseKey, summary, idx }) => {
+            const n = (counts.get(baseKey) ?? 0) + 1;
+            counts.set(baseKey, n);
+            const key = n === 1 ? baseKey : `${baseKey} (${idx})`;
+            return { item, idx, key, summary };
+        });
+    }
+    /**
+     * Build the JSON schema and chat messages payload for the LLM.
+     *
+     * Creates a strict JSON schema requiring one integer property (minScore-maxScore) per candidate key,
+     * and constructs system + user messages instructing the LLM to score relevance.
+     *
+     * @param query - The search query to evaluate candidates against
+     * @param items - Candidates with unique keys and summaries
+     * @returns Object containing JSON schema and chat messages array
+     * @private
+     */
+    buildRequest(query, items) {
+        const keys = items.map((x) => x.key);
+        const schema = buildRelevancySchema(keys, this.cfg.minScore, this.cfg.maxScore);
+        const messages = buildMessages(query, items, {
+            minScore: this.cfg.minScore,
+            maxScore: this.cfg.maxScore,
+        });
+        return { schema, messages };
+    }
+    /**
+     * Build the JSON schema and chat messages payload for the LLM filter call.
+     *
+     * @param query - The search query to evaluate candidates against
+     * @param items - Candidates with unique keys and summaries
+     * @returns Object containing JSON schema and chat messages array
+     * @private
+     */
+    buildFilterRequest(query, items) {
+        const keys = items.map((x) => x.key);
+        const schema = buildFilterSchema(keys);
+        const messages = buildFilterMessages(query, items);
+        return { schema, messages };
+    }
+    /**
+     * Build the JSON schema and chat messages payload for the LLM choice call.
+     *
+     * @param query - The search query to choose against
+     * @param items - Candidates with unique keys and summaries
+     * @returns Object containing JSON schema and chat messages array
+     * @private
+     */
+    buildChoiceRequest(query, items) {
+        const keys = items.map((x) => x.key);
+        const schema = buildChoiceSchema(keys);
+        const messages = buildChoiceMessages(query, items);
+        return { schema, messages };
+    }
+    /**
+     * Invoke the LLM and return the parsed map of candidate scores.
+     *
+     * Calls the configured LLM client with the messages, JSON schema, model config,
+     * and user ID. Returns null if the response is invalid or missing.
+     *
+     * @param messages - Chat messages (system + user) to send to LLM
+     * @param schema - Strict JSON schema defining expected response structure
+     * @param userId - Optional user identifier for provider abuse monitoring
+     * @returns Map of candidate keys to numeric scores, or null if response invalid
+     * @private
+     */
+    async fetchEvaluations(messages, schema, userId) {
+        const config = {
+            model: this.resolveModel(),
+            reasoningEffort: "medium",
+            timeoutMs: this.cfg.timeoutMs,
+        };
+        const { data } = await this.llm.call(messages, schema, config, userId ?? this.ctx.userId);
+        if (data == null || typeof data !== "object")
+            return null;
+        return data;
+    }
+    /**
+     * Invoke the LLM and return boolean relevancy decisions.
+     *
+     * @param messages - Chat messages to send
+     * @param schema - Strict JSON schema defining expected response structure
+     * @param userId - Optional user id
+     * @returns Map of candidate keys to filter decisions, or null if invalid
+     * @private
+     */
+    async fetchFilterDecisions(messages, schema, userId) {
+        const config = {
+            model: this.resolveModel(),
+            reasoningEffort: "medium",
+            timeoutMs: this.cfg.timeoutMs,
+        };
+        const { data } = await this.llm.call(messages, schema, config, userId ?? this.ctx.userId);
+        if (data == null || typeof data !== "object")
+            return null;
+        return data;
+    }
+    /**
+     * Invoke the LLM and return a single selected key.
+     *
+     * @param messages - Chat messages to send
+     * @param schema - Strict JSON schema defining expected response structure
+     * @param userId - Optional user id
+     * @returns Choice result, or null if invalid
+     * @private
+     */
+    async fetchChoice(messages, schema, userId) {
+        const config = {
+            model: this.resolveModel(),
+            reasoningEffort: "medium",
+            timeoutMs: this.cfg.timeoutMs,
+        };
+        const { data } = await this.llm.call(messages, schema, config, userId ?? this.ctx.userId);
+        if (data == null || typeof data !== "object")
+            return null;
+        const record = data;
+        const explanation = typeof record.explanation === "string" ? record.explanation : "";
+        const selectedKey = typeof record.selectedKey === "string" ? record.selectedKey : "";
+        if (selectedKey === "")
+            return null;
+        return { explanation, selectedKey };
+    }
+    /**
+     * Apply boolean filter decisions while preserving input order.
+     *
+     * @param items - Candidates with unique keys
+     * @param decisions - Map of candidate keys to decisions
+     * @returns Filtered items with explanations
+     * @private
+     */
+    applyFilter(items, decisions) {
+        const kept = [];
+        for (const it of items) {
+            const decision = decisions[it.key];
+            if (decision?.isRelevant === true) {
+                kept.push({
+                    item: it.item,
+                    explanation: typeof decision.explanation === "string" ? decision.explanation : "",
+                });
+            }
+        }
+        return kept;
+    }
+    /**
+     * Process a single batch of candidates through the LLM filter.
+     *
+     * @param query - Query to filter against
+     * @param batch - Prepared candidates
+     * @param options - Optional userId override
+     * @returns Filtered items (stable order), with explanations
+     * @private
+     */
+    async processFilterBatch(query, batch, options) {
+        const keyed = this.ensureUniqueKeys(batch);
+        const { schema, messages } = this.buildFilterRequest(query, keyed);
+        const decisions = await this.fetchFilterDecisions(messages, schema, options?.userId);
+        if (decisions == null) {
+            return keyed.map(({ item }) => ({ item, explanation: "" }));
+        }
+        return this.applyFilter(keyed, decisions);
+    }
+    /**
+     * Process a batch of candidates and choose a single winner.
+     *
+     * @param query - Query to choose against
+     * @param batch - Candidates with unique keys
+     * @param userId - Optional userId override
+     * @returns Winner item with explanation
+     * @private
+     */
+    async processChoiceBatch(query, batch, userId) {
+        const { schema, messages } = this.buildChoiceRequest(query, batch);
+        const choice = await this.fetchChoice(messages, schema, userId);
+        if (choice == null) {
+            return { item: batch[0].item, explanation: "" };
+        }
+        const winner = batch.find((x) => x.key === choice.selectedKey);
+        if (!winner) {
+            return { item: batch[0].item, explanation: choice.explanation };
+        }
+        return { item: winner.item, explanation: choice.explanation };
+    }
+    /**
+     * Apply relevancy threshold filtering and stable sorting.
+     *
+     * Scores are clamped to the configured score range, then filtered to keep only items with
+     * score > threshold. Results are sorted by score descending, with ties
+     * preserving original input order for deterministic results.
+     *
+     * @param items - Candidates with unique keys
+     * @param scores - Map of candidate keys to LLM-assigned scores
+     * @returns Filtered and sorted array of original items
+     * @private
+     */
+    rankAndFilter(items, evaluations) {
+        const threshold = this.cfg.relevancyThreshold;
+        const scored = items.map(({ item, idx, key }) => ({
+            item,
+            idx,
+            explanation: typeof evaluations[key]?.explanation === "string" ? evaluations[key].explanation : "",
+            score: clamp(evaluations[key]?.score ?? this.cfg.minScore, this.cfg.minScore, this.cfg.maxScore),
+        }));
+        const filtered = scored.filter(({ score }) => score > threshold);
+        const sorted = filtered.sort((a, b) => {
+            if (b.score !== a.score)
+                return b.score - a.score;
+            return a.idx - b.idx;
+        });
+        return sorted;
+    }
+    /**
+     * Process a single batch of candidates through the LLM.
+     *
+     * Ensures unique keys, builds the request payload, fetches scores from the LLM,
+     * and returns filtered and sorted results. On any error or null response from
+     * the LLM, returns items in their original order as a fallback.
+     *
+     * @param query - The search query to evaluate candidates against
+     * @param batch - Batch of prepared candidates to process
+     * @param userId - Optional user identifier for provider abuse monitoring
+     * @returns Ranked and filtered items, or original order on error
+     * @private
+     */
+    async processBatch(query, batch, options) {
+        const keyed = this.ensureUniqueKeys(batch);
+        const { schema, messages } = this.buildRequest(query, keyed);
+        const evaluations = await this.fetchEvaluations(messages, schema, options?.userId);
+        if (evaluations == null) {
+            return keyed.map(({ item }) => ({ item, explanation: "" }));
+        }
+        const ranked = this.rankAndFilter(keyed, evaluations);
+        return ranked.map(({ item, explanation }) => ({ item, explanation }));
+    }
+}
+//# sourceMappingURL=intent.js.map

package/dist/intent.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Lightweight env var readers matching the API service pattern.
+ * - If the env var is set (non-empty), parse and return it.
+ * - Otherwise, if a default is provided, return the default.
+ * - Otherwise, throw a helpful error.
+ *
+ * This version exposes four self-contained readers with an options object
+ * supporting { default, min, max } where min/max apply to int/number only.
+ */
+export type BaseOptions<T> = {
+    default?: T;
+};
+export type RangeOptions = BaseOptions<number> & {
+    min?: number;
+    max?: number;
+};
+export type EnumOptions<T extends readonly string[]> = BaseOptions<T[number]> & {
+    values: T;
+};
+export declare function string(name: string, opts?: BaseOptions<string>): string;
+/**
+ * Read an env var as a constrained enum string.
+ *
+ * When set, validates the value is included in opts.values.
+ * When unset, returns opts.default if provided, otherwise throws.
+ */
+export declare function enumeration<const T extends readonly string[]>(name: string, opts: EnumOptions<T>): T[number];
+export declare function boolean(name: string, opts?: BaseOptions<boolean>): boolean;
+export declare function int(name: string, opts?: RangeOptions): number;
+export declare function number(name: string, opts?: RangeOptions): number;

package/dist/lib/config.js

@@ -0,0 +1,81 @@
+/**
+ * Lightweight env var readers matching the API service pattern.
+ * - If the env var is set (non-empty), parse and return it.
+ * - Otherwise, if a default is provided, return the default.
+ * - Otherwise, throw a helpful error.
+ *
+ * This version exposes four self-contained readers with an options object
+ * supporting { default, min, max } where min/max apply to int/number only.
+ */
+function throwRequiredEnvVar(name) {
+    throw new Error(`${name} is required.`);
+}
+import { clamp } from "./number";
+export function string(name, opts) {
+    const value = process.env[name];
+    const exists = value != null && value.length > 0;
+    if (exists) {
+        return value;
+    }
+    if (opts?.default !== undefined) {
+        return opts.default;
+    }
+    return throwRequiredEnvVar(name);
+}
+/**
+ * Read an env var as a constrained enum string.
+ *
+ * When set, validates the value is included in opts.values.
+ * When unset, returns opts.default if provided, otherwise throws.
+ */
+export function enumeration(name, opts) {
+    const value = opts.default !== undefined ? string(name, { default: opts.default }) : string(name);
+    if (opts.values.includes(value)) {
+        return value;
+    }
+    throw new Error(`${name} must be one of: ${opts.values.join(", ")}`);
+}
+export function boolean(name, opts) {
+    const value = process.env[name];
+    const exists = value != null && value.length > 0;
+    if (exists) {
+        const v = value;
+        return ["0", "false"].includes(v) === false;
+    }
+    if (opts?.default !== undefined) {
+        return opts.default;
+    }
+    return throwRequiredEnvVar(name);
+}
+export function int(name, opts) {
+    const value = process.env[name];
+    const exists = value != null && value.length > 0;
+    if (exists) {
+        const parsed = Number.parseInt(value, 10);
+        if (Number.isNaN(parsed)) {
+            throw new Error(`${name} must be a valid integer`);
+        }
+        return clamp(parsed, opts?.min, opts?.max);
+    }
+    if (opts?.default !== undefined) {
+        const def = Math.trunc(opts.default);
+        return clamp(def, opts?.min, opts?.max);
+    }
+    return throwRequiredEnvVar(name);
+}
+export function number(name, opts) {
+    const value = process.env[name];
+    const exists = value != null && value.length > 0;
+    if (exists) {
+        const parsed = Number.parseFloat(value);
+        if (Number.isNaN(parsed)) {
+            throw new Error(`${name} must be a valid number`);
+        }
+        return clamp(parsed, opts?.min, opts?.max);
+    }
+    if (opts?.default !== undefined) {
+        return clamp(opts.default, opts?.min, opts?.max);
+    }
+    return throwRequiredEnvVar(name);
+}
+//# sourceMappingURL=config.js.map