@iflow-mcp/kdcokenny-lsbible 0.3.0

package/dist/noop-B62cxzKZ.d.ts

@@ -0,0 +1,1157 @@
+import { z } from 'zod';
+
+/**
+ * Cache provider interface for LSBible SDK.
+ *
+ * Allows users to implement custom caching strategies for different
+ * deployment environments (Cloudflare Workers, Redis, in-memory, etc.)
+ */
+/**
+ * Cache provider interface.
+ *
+ * Implement this interface to provide custom caching for the LSBible client.
+ *
+ * @example
+ * ```ts
+ * class RedisCacheProvider implements CacheProvider {
+ *   async get<T>(key: string): Promise<T | undefined> {
+ *     const value = await redis.get(key);
+ *     return value ? JSON.parse(value) : undefined;
+ *   }
+ *
+ *   async set<T>(key: string, value: T, ttl: number): Promise<void> {
+ *     await redis.set(key, JSON.stringify(value), 'EX', ttl);
+ *   }
+ * }
+ * ```
+ */
+interface CacheProvider {
+    /**
+     * Get a value from the cache.
+     *
+     * @param key - Cache key
+     * @returns Cached value or undefined if not found/expired
+     */
+    get<T>(key: string): Promise<T | undefined>;
+    /**
+     * Set a value in the cache.
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param ttl - Time to live in seconds
+     */
+    set<T>(key: string, value: T, ttl: number): Promise<void>;
+}
+/**
+ * Cache configuration options.
+ */
+interface CacheOptions {
+    /**
+     * Cache provider implementation.
+     *
+     * If not provided, caching is disabled.
+     */
+    provider?: CacheProvider;
+    /**
+     * Default TTL for cache entries (in seconds).
+     *
+     * Can be overridden per-operation.
+     * @default 2592000 (30 days)
+     */
+    defaultTtl?: number;
+    /**
+     * Per-operation TTL overrides.
+     */
+    ttl?: {
+        /** TTL for verse lookups */
+        verse?: number;
+        /** TTL for passage lookups */
+        passage?: number;
+        /** TTL for chapter lookups */
+        chapter?: number;
+        /** TTL for search queries */
+        search?: number;
+    };
+}
+/**
+ * Recommended cache TTL values (in seconds).
+ */
+declare const CacheTTL: {
+    /** 1 month - for immutable Bible content (verses, passages, chapters) */
+    readonly BIBLE_CONTENT: 2592000;
+    /** 1 week - for search results that may change with API updates */
+    readonly SEARCH_RESULTS: 604800;
+    /** 1 year - for static resources that never change */
+    readonly STATIC: 31536000;
+};
+
+/**
+ * Zod schemas and TypeScript types for LSBible API data structures.
+ *
+ * Provides runtime validation and type inference for all API responses.
+ */
+
+/**
+ * Enumeration of all 66 Bible books for type-safe API calls.
+ */
+declare enum BookName {
+    GENESIS = "Genesis",
+    EXODUS = "Exodus",
+    LEVITICUS = "Leviticus",
+    NUMBERS = "Numbers",
+    DEUTERONOMY = "Deuteronomy",
+    JOSHUA = "Joshua",
+    JUDGES = "Judges",
+    RUTH = "Ruth",
+    SAMUEL_1 = "1 Samuel",
+    SAMUEL_2 = "2 Samuel",
+    KINGS_1 = "1 Kings",
+    KINGS_2 = "2 Kings",
+    CHRONICLES_1 = "1 Chronicles",
+    CHRONICLES_2 = "2 Chronicles",
+    EZRA = "Ezra",
+    NEHEMIAH = "Nehemiah",
+    ESTHER = "Esther",
+    JOB = "Job",
+    PSALMS = "Psalms",
+    PROVERBS = "Proverbs",
+    ECCLESIASTES = "Ecclesiastes",
+    SONG_OF_SONGS = "Song of Songs",
+    ISAIAH = "Isaiah",
+    JEREMIAH = "Jeremiah",
+    LAMENTATIONS = "Lamentations",
+    EZEKIEL = "Ezekiel",
+    DANIEL = "Daniel",
+    HOSEA = "Hosea",
+    JOEL = "Joel",
+    AMOS = "Amos",
+    OBADIAH = "Obadiah",
+    JONAH = "Jonah",
+    MICAH = "Micah",
+    NAHUM = "Nahum",
+    HABAKKUK = "Habakkuk",
+    ZEPHANIAH = "Zephaniah",
+    HAGGAI = "Haggai",
+    ZECHARIAH = "Zechariah",
+    MALACHI = "Malachi",
+    MATTHEW = "Matthew",
+    MARK = "Mark",
+    LUKE = "Luke",
+    JOHN = "John",
+    ACTS = "Acts",
+    ROMANS = "Romans",
+    CORINTHIANS_1 = "1 Corinthians",
+    CORINTHIANS_2 = "2 Corinthians",
+    GALATIANS = "Galatians",
+    EPHESIANS = "Ephesians",
+    PHILIPPIANS = "Philippians",
+    COLOSSIANS = "Colossians",
+    THESSALONIANS_1 = "1 Thessalonians",
+    THESSALONIANS_2 = "2 Thessalonians",
+    TIMOTHY_1 = "1 Timothy",
+    TIMOTHY_2 = "2 Timothy",
+    TITUS = "Titus",
+    PHILEMON = "Philemon",
+    HEBREWS = "Hebrews",
+    JAMES = "James",
+    PETER_1 = "1 Peter",
+    PETER_2 = "2 Peter",
+    JOHN_1 = "1 John",
+    JOHN_2 = "2 John",
+    JOHN_3 = "3 John",
+    JUDE = "Jude",
+    REVELATION = "Revelation"
+}
+/**
+ * Zod schema for VerseReference with validation.
+ *
+ * Validates that:
+ * - Book number is 1-66
+ * - Chapter exists in the book
+ * - Verse exists in the chapter
+ */
+declare const VerseReferenceSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    bookNumber: z.ZodNumber;
+    chapter: z.ZodNumber;
+    verse: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    bookNumber: number;
+    chapter: number;
+    verse: number;
+}, {
+    bookNumber: number;
+    chapter: number;
+    verse: number;
+}>, {
+    bookNumber: number;
+    chapter: number;
+    verse: number;
+}, {
+    bookNumber: number;
+    chapter: number;
+    verse: number;
+}>, {
+    bookNumber: number;
+    chapter: number;
+    verse: number;
+}, {
+    bookNumber: number;
+    chapter: number;
+    verse: number;
+}>;
+/** Type for VerseReference inferred from Zod schema */
+type VerseReference = z.infer<typeof VerseReferenceSchema> & {
+    /** Get the book name from the book number */
+    readonly bookName: BookName;
+    /** String representation (e.g., "John 3:16") */
+    toString(): string;
+};
+/**
+ * Zod schema for TextSegment.
+ */
+declare const TextSegmentSchema: z.ZodObject<{
+    text: z.ZodString;
+    isRedLetter: z.ZodDefault<z.ZodBoolean>;
+    isItalic: z.ZodDefault<z.ZodBoolean>;
+    isBold: z.ZodDefault<z.ZodBoolean>;
+    isSmallCaps: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    isRedLetter: boolean;
+    isItalic: boolean;
+    isBold: boolean;
+    isSmallCaps: boolean;
+}, {
+    text: string;
+    isRedLetter?: boolean | undefined;
+    isItalic?: boolean | undefined;
+    isBold?: boolean | undefined;
+    isSmallCaps?: boolean | undefined;
+}>;
+/** Type for TextSegment */
+type TextSegment = z.infer<typeof TextSegmentSchema>;
+/**
+ * Zod schema for VerseContent.
+ */
+declare const VerseContentSchema: z.ZodObject<{
+    reference: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        bookNumber: z.ZodNumber;
+        chapter: z.ZodNumber;
+        verse: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>;
+    verseNumber: z.ZodNumber;
+    segments: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        isRedLetter: z.ZodDefault<z.ZodBoolean>;
+        isItalic: z.ZodDefault<z.ZodBoolean>;
+        isBold: z.ZodDefault<z.ZodBoolean>;
+        isSmallCaps: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        isRedLetter: boolean;
+        isItalic: boolean;
+        isBold: boolean;
+        isSmallCaps: boolean;
+    }, {
+        text: string;
+        isRedLetter?: boolean | undefined;
+        isItalic?: boolean | undefined;
+        isBold?: boolean | undefined;
+        isSmallCaps?: boolean | undefined;
+    }>, "many">;
+    hasSubheading: z.ZodDefault<z.ZodBoolean>;
+    subheadingText: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    isPoetry: z.ZodDefault<z.ZodBoolean>;
+    isProse: z.ZodDefault<z.ZodBoolean>;
+    chapterStart: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    reference: {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    };
+    verseNumber: number;
+    segments: {
+        text: string;
+        isRedLetter: boolean;
+        isItalic: boolean;
+        isBold: boolean;
+        isSmallCaps: boolean;
+    }[];
+    hasSubheading: boolean;
+    subheadingText: string | null;
+    isPoetry: boolean;
+    isProse: boolean;
+    chapterStart: boolean;
+}, {
+    reference: {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    };
+    verseNumber: number;
+    segments: {
+        text: string;
+        isRedLetter?: boolean | undefined;
+        isItalic?: boolean | undefined;
+        isBold?: boolean | undefined;
+        isSmallCaps?: boolean | undefined;
+    }[];
+    hasSubheading?: boolean | undefined;
+    subheadingText?: string | null | undefined;
+    isPoetry?: boolean | undefined;
+    isProse?: boolean | undefined;
+    chapterStart?: boolean | undefined;
+}>;
+/** Type for VerseContent with computed properties */
+type VerseContent = Omit<z.infer<typeof VerseContentSchema>, "reference"> & {
+    reference: VerseReference;
+    /** Get plain text without formatting */
+    readonly plainText: string;
+    /** Get text with simple formatting markers */
+    readonly formattedText: string;
+};
+/**
+ * Zod schema for Passage.
+ */
+declare const PassageSchema: z.ZodObject<{
+    fromRef: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        bookNumber: z.ZodNumber;
+        chapter: z.ZodNumber;
+        verse: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>;
+    toRef: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        bookNumber: z.ZodNumber;
+        chapter: z.ZodNumber;
+        verse: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }, {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    }>;
+    title: z.ZodString;
+    verses: z.ZodArray<z.ZodObject<{
+        reference: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+            bookNumber: z.ZodNumber;
+            chapter: z.ZodNumber;
+            verse: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>;
+        verseNumber: z.ZodNumber;
+        segments: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            isRedLetter: z.ZodDefault<z.ZodBoolean>;
+            isItalic: z.ZodDefault<z.ZodBoolean>;
+            isBold: z.ZodDefault<z.ZodBoolean>;
+            isSmallCaps: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            isRedLetter: boolean;
+            isItalic: boolean;
+            isBold: boolean;
+            isSmallCaps: boolean;
+        }, {
+            text: string;
+            isRedLetter?: boolean | undefined;
+            isItalic?: boolean | undefined;
+            isBold?: boolean | undefined;
+            isSmallCaps?: boolean | undefined;
+        }>, "many">;
+        hasSubheading: z.ZodDefault<z.ZodBoolean>;
+        subheadingText: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        isPoetry: z.ZodDefault<z.ZodBoolean>;
+        isProse: z.ZodDefault<z.ZodBoolean>;
+        chapterStart: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        reference: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        verseNumber: number;
+        segments: {
+            text: string;
+            isRedLetter: boolean;
+            isItalic: boolean;
+            isBold: boolean;
+            isSmallCaps: boolean;
+        }[];
+        hasSubheading: boolean;
+        subheadingText: string | null;
+        isPoetry: boolean;
+        isProse: boolean;
+        chapterStart: boolean;
+    }, {
+        reference: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        verseNumber: number;
+        segments: {
+            text: string;
+            isRedLetter?: boolean | undefined;
+            isItalic?: boolean | undefined;
+            isBold?: boolean | undefined;
+            isSmallCaps?: boolean | undefined;
+        }[];
+        hasSubheading?: boolean | undefined;
+        subheadingText?: string | null | undefined;
+        isPoetry?: boolean | undefined;
+        isProse?: boolean | undefined;
+        chapterStart?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    fromRef: {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    };
+    toRef: {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    };
+    title: string;
+    verses: {
+        reference: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        verseNumber: number;
+        segments: {
+            text: string;
+            isRedLetter: boolean;
+            isItalic: boolean;
+            isBold: boolean;
+            isSmallCaps: boolean;
+        }[];
+        hasSubheading: boolean;
+        subheadingText: string | null;
+        isPoetry: boolean;
+        isProse: boolean;
+        chapterStart: boolean;
+    }[];
+}, {
+    fromRef: {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    };
+    toRef: {
+        bookNumber: number;
+        chapter: number;
+        verse: number;
+    };
+    title: string;
+    verses: {
+        reference: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        verseNumber: number;
+        segments: {
+            text: string;
+            isRedLetter?: boolean | undefined;
+            isItalic?: boolean | undefined;
+            isBold?: boolean | undefined;
+            isSmallCaps?: boolean | undefined;
+        }[];
+        hasSubheading?: boolean | undefined;
+        subheadingText?: string | null | undefined;
+        isPoetry?: boolean | undefined;
+        isProse?: boolean | undefined;
+        chapterStart?: boolean | undefined;
+    }[];
+}>;
+/** Type for Passage with computed properties */
+type Passage = Omit<z.infer<typeof PassageSchema>, "fromRef" | "toRef" | "verses"> & {
+    fromRef: VerseReference;
+    toRef: VerseReference;
+    verses: VerseContent[];
+    /** Check if this passage is a single verse */
+    readonly isSingleVerse: boolean;
+    /** Get the number of verses in this passage */
+    readonly verseCount: number;
+};
+/**
+ * Zod schema for SearchResponse.
+ *
+ * For text searches, includes rich metadata about result distribution across
+ * Bible sections and books. For Bible reference lookups, these fields are undefined.
+ */
+declare const SearchResponseSchema: z.ZodObject<{
+    query: z.ZodString;
+    matchCount: z.ZodNumber;
+    passages: z.ZodArray<z.ZodObject<{
+        fromRef: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+            bookNumber: z.ZodNumber;
+            chapter: z.ZodNumber;
+            verse: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>;
+        toRef: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+            bookNumber: z.ZodNumber;
+            chapter: z.ZodNumber;
+            verse: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }, {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        }>;
+        title: z.ZodString;
+        verses: z.ZodArray<z.ZodObject<{
+            reference: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+                bookNumber: z.ZodNumber;
+                chapter: z.ZodNumber;
+                verse: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            }, {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            }>, {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            }, {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            }>, {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            }, {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            }>;
+            verseNumber: z.ZodNumber;
+            segments: z.ZodArray<z.ZodObject<{
+                text: z.ZodString;
+                isRedLetter: z.ZodDefault<z.ZodBoolean>;
+                isItalic: z.ZodDefault<z.ZodBoolean>;
+                isBold: z.ZodDefault<z.ZodBoolean>;
+                isSmallCaps: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                text: string;
+                isRedLetter: boolean;
+                isItalic: boolean;
+                isBold: boolean;
+                isSmallCaps: boolean;
+            }, {
+                text: string;
+                isRedLetter?: boolean | undefined;
+                isItalic?: boolean | undefined;
+                isBold?: boolean | undefined;
+                isSmallCaps?: boolean | undefined;
+            }>, "many">;
+            hasSubheading: z.ZodDefault<z.ZodBoolean>;
+            subheadingText: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            isPoetry: z.ZodDefault<z.ZodBoolean>;
+            isProse: z.ZodDefault<z.ZodBoolean>;
+            chapterStart: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            reference: {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            };
+            verseNumber: number;
+            segments: {
+                text: string;
+                isRedLetter: boolean;
+                isItalic: boolean;
+                isBold: boolean;
+                isSmallCaps: boolean;
+            }[];
+            hasSubheading: boolean;
+            subheadingText: string | null;
+            isPoetry: boolean;
+            isProse: boolean;
+            chapterStart: boolean;
+        }, {
+            reference: {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            };
+            verseNumber: number;
+            segments: {
+                text: string;
+                isRedLetter?: boolean | undefined;
+                isItalic?: boolean | undefined;
+                isBold?: boolean | undefined;
+                isSmallCaps?: boolean | undefined;
+            }[];
+            hasSubheading?: boolean | undefined;
+            subheadingText?: string | null | undefined;
+            isPoetry?: boolean | undefined;
+            isProse?: boolean | undefined;
+            chapterStart?: boolean | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fromRef: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        toRef: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        title: string;
+        verses: {
+            reference: {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            };
+            verseNumber: number;
+            segments: {
+                text: string;
+                isRedLetter: boolean;
+                isItalic: boolean;
+                isBold: boolean;
+                isSmallCaps: boolean;
+            }[];
+            hasSubheading: boolean;
+            subheadingText: string | null;
+            isPoetry: boolean;
+            isProse: boolean;
+            chapterStart: boolean;
+        }[];
+    }, {
+        fromRef: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        toRef: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        title: string;
+        verses: {
+            reference: {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            };
+            verseNumber: number;
+            segments: {
+                text: string;
+                isRedLetter?: boolean | undefined;
+                isItalic?: boolean | undefined;
+                isBold?: boolean | undefined;
+                isSmallCaps?: boolean | undefined;
+            }[];
+            hasSubheading?: boolean | undefined;
+            subheadingText?: string | null | undefined;
+            isPoetry?: boolean | undefined;
+            isProse?: boolean | undefined;
+            chapterStart?: boolean | undefined;
+        }[];
+    }>, "many">;
+    durationMs: z.ZodNumber;
+    timestamp: z.ZodNumber;
+    totalCount: z.ZodOptional<z.ZodNumber>;
+    filteredCount: z.ZodOptional<z.ZodNumber>;
+    countsByBook: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    countsBySection: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    matchCount: number;
+    passages: {
+        fromRef: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        toRef: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        title: string;
+        verses: {
+            reference: {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            };
+            verseNumber: number;
+            segments: {
+                text: string;
+                isRedLetter: boolean;
+                isItalic: boolean;
+                isBold: boolean;
+                isSmallCaps: boolean;
+            }[];
+            hasSubheading: boolean;
+            subheadingText: string | null;
+            isPoetry: boolean;
+            isProse: boolean;
+            chapterStart: boolean;
+        }[];
+    }[];
+    durationMs: number;
+    timestamp: number;
+    totalCount?: number | undefined;
+    filteredCount?: number | undefined;
+    countsByBook?: Record<string, number> | undefined;
+    countsBySection?: Record<string, number> | undefined;
+}, {
+    query: string;
+    matchCount: number;
+    passages: {
+        fromRef: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        toRef: {
+            bookNumber: number;
+            chapter: number;
+            verse: number;
+        };
+        title: string;
+        verses: {
+            reference: {
+                bookNumber: number;
+                chapter: number;
+                verse: number;
+            };
+            verseNumber: number;
+            segments: {
+                text: string;
+                isRedLetter?: boolean | undefined;
+                isItalic?: boolean | undefined;
+                isBold?: boolean | undefined;
+                isSmallCaps?: boolean | undefined;
+            }[];
+            hasSubheading?: boolean | undefined;
+            subheadingText?: string | null | undefined;
+            isPoetry?: boolean | undefined;
+            isProse?: boolean | undefined;
+            chapterStart?: boolean | undefined;
+        }[];
+    }[];
+    durationMs: number;
+    timestamp: number;
+    totalCount?: number | undefined;
+    filteredCount?: number | undefined;
+    countsByBook?: Record<string, number> | undefined;
+    countsBySection?: Record<string, number> | undefined;
+}>;
+/** Type for SearchResponse with computed properties */
+type SearchResponse = Omit<z.infer<typeof SearchResponseSchema>, "passages"> & {
+    passages: Passage[];
+    /** Get the number of passages returned */
+    readonly passageCount: number;
+    /** Get total number of verses across all passages */
+    readonly totalVerses: number;
+    /** Check if this response includes search distribution metadata */
+    readonly hasSearchMetadata: boolean;
+};
+
+/**
+ * LSBible API client.
+ */
+
+/** Client configuration options */
+interface LSBibleClientOptions {
+    /** Request timeout in seconds (default: 30) */
+    timeout?: number;
+    /** Optional build ID (auto-detected if not provided) */
+    buildId?: string;
+    /** Optional custom headers */
+    headers?: Record<string, string>;
+    /** Optional cache configuration */
+    cache?: CacheOptions;
+}
+/**
+ * Client for interacting with the LSBible API.
+ *
+ * @example
+ * ```ts
+ * const client = new LSBibleClient();
+ *
+ * // Get a single verse
+ * const verse = await client.getVerse(BookName.JOHN, 3, 16);
+ *
+ * // Search for text
+ * const results = await client.search("love");
+ * ```
+ */
+declare class LSBibleClient {
+    private static readonly BASE_URL;
+    private cacheProvider;
+    private cacheTtls;
+    private timeout;
+    private buildId;
+    private buildIdFetched;
+    private headers;
+    /**
+     * Create a new LSBible client.
+     *
+     * @param options - Client configuration options
+     */
+    constructor(options?: LSBibleClientOptions);
+    /**
+     * Get the Next.js build ID.
+     *
+     * Strategies:
+     * 1. Use cached/provided build ID
+     * 2. Extract from homepage HTML (__NEXT_DATA__ script)
+     * 3. Try to find it in script tags
+     *
+     * @throws BuildIDError if build ID cannot be determined
+     */
+    private getBuildId;
+    /**
+     * Cache wrapper for async operations.
+     *
+     * @param key - Cache key
+     * @param ttl - Time to live in seconds
+     * @param fetcher - Function to fetch fresh data
+     * @returns Cached or fresh data
+     */
+    private withCache;
+    /**
+     * Make a request to the LSBible API.
+     *
+     * @param query - Search query or verse reference
+     * @returns API response JSON
+     * @throws APIError if request fails
+     */
+    private makeRequest;
+    /**
+     * Detect if response is from text search or Bible reference lookup.
+     *
+     * Text searches have initialItems array with metadata.
+     * Bible reference lookups have passages array with full HTML.
+     */
+    private isTextSearch;
+    /**
+     * Parse text search results from initialItems format.
+     */
+    private parseSearchResults;
+    /**
+     * Parse Bible reference lookup results from passages format.
+     */
+    private parseReferenceResults;
+    /**
+     * Parse API response into SearchResponse.
+     */
+    private parseResponse;
+    /**
+     * Search for passages containing text.
+     *
+     * @param query - Search text (e.g., "love", "faith")
+     * @returns SearchResponse with structured passage data
+     * @throws APIError if API request fails
+     */
+    search(query: string): Promise<SearchResponse>;
+    /**
+     * Get a specific verse with validated parameters.
+     *
+     * @param book - Book name as enum or string
+     * @param chapter - Chapter number (validated against book)
+     * @param verse - Verse number (validated against chapter)
+     * @returns Single Passage containing the verse
+     * @throws InvalidReferenceError if book/chapter/verse combination is invalid
+     * @throws APIError if API request fails
+     *
+     * @example
+     * ```ts
+     * // Using enum (recommended - type-safe with autocomplete)
+     * const passage = await client.getVerse(BookName.JOHN, 3, 16);
+     *
+     * // Using string (validated at runtime)
+     * const passage2 = await client.getVerse("John", 3, 16);
+     * ```
+     */
+    getVerse(book: BookName | string, chapter: number, verse: number): Promise<Passage>;
+    /**
+     * Get a passage spanning multiple verses.
+     *
+     * @param fromBook - Starting book
+     * @param fromChapter - Starting chapter
+     * @param fromVerse - Starting verse
+     * @param toBook - Ending book
+     * @param toChapter - Ending chapter
+     * @param toVerse - Ending verse
+     * @returns Passage containing all verses in range
+     * @throws InvalidReferenceError if any reference is invalid
+     * @throws APIError if API request fails
+     *
+     * @example
+     * ```ts
+     * // Get John 3:16-18
+     * const passage = await client.getPassage(
+     *   BookName.JOHN, 3, 16,
+     *   BookName.JOHN, 3, 18
+     * );
+     * ```
+     */
+    getPassage(fromBook: BookName | string, fromChapter: number, fromVerse: number, toBook: BookName | string, toChapter: number, toVerse: number): Promise<Passage>;
+    /**
+     * Get an entire chapter.
+     *
+     * @param book - Book name
+     * @param chapter - Chapter number
+     * @returns Passage containing all verses in the chapter
+     * @throws InvalidReferenceError if book/chapter is invalid
+     * @throws APIError if API request fails
+     *
+     * @example
+     * ```ts
+     * // Get all of John chapter 3
+     * const passage = await client.getChapter(BookName.JOHN, 3);
+     * ```
+     */
+    getChapter(book: BookName | string, chapter: number): Promise<Passage>;
+    /**
+     * Clear all cached data.
+     *
+     * This method calls the cache provider's clear method if one is configured.
+     * If the cache provider doesn't implement a clear method, this is a no-op.
+     *
+     * @example
+     * ```ts
+     * const client = new LSBibleClient({
+     *   cache: { provider: new MemoryCacheProvider() }
+     * });
+     *
+     * // Clear all cached data
+     * client.clearCache();
+     * ```
+     */
+    clearCache(): void;
+}
+
+/**
+ * In-memory cache provider for local development and testing.
+ *
+ * Stores cache entries in a Map with TTL support. Cache is not
+ * shared across processes or requests.
+ */
+
+/**
+ * In-memory cache provider using Map.
+ *
+ * Suitable for:
+ * - Local development
+ * - Testing
+ * - Single-process applications
+ * - MCP stdio servers
+ *
+ * Not suitable for:
+ * - Multi-process applications
+ * - Cloudflare Workers (use CloudflareCacheProvider)
+ * - Production high-traffic servers (use Redis/Memcached)
+ *
+ * @example
+ * ```ts
+ * import { LSBibleClient, MemoryCacheProvider } from 'lsbible';
+ *
+ * const client = new LSBibleClient({
+ *   cache: {
+ *     provider: new MemoryCacheProvider()
+ *   }
+ * });
+ * ```
+ */
+declare class MemoryCacheProvider implements CacheProvider {
+    private cache;
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T, ttl: number): Promise<void>;
+    /**
+     * Clear all cache entries.
+     *
+     * Useful for testing or manual cache invalidation.
+     */
+    clear(): void;
+    /**
+     * Get the number of entries in the cache.
+     *
+     * Includes expired entries that haven't been accessed yet.
+     */
+    size(): number;
+}
+
+/**
+ * No-op cache provider that disables caching.
+ *
+ * Use this when you want to disable caching entirely.
+ */
+
+/**
+ * No-op cache provider.
+ *
+ * All get() calls return undefined (cache miss).
+ * All set() calls do nothing.
+ *
+ * Use when you want to disable caching for testing,
+ * debugging, or when caching isn't beneficial for your use case.
+ *
+ * @example
+ * ```ts
+ * import { LSBibleClient, NoopCacheProvider } from 'lsbible';
+ *
+ * const client = new LSBibleClient({
+ *   cache: {
+ *     provider: new NoopCacheProvider()
+ *   }
+ * });
+ * ```
+ */
+declare class NoopCacheProvider implements CacheProvider {
+    get<T>(_key: string): Promise<T | undefined>;
+    set<T>(_key: string, _value: T, _ttl: number): Promise<void>;
+}
+
+export { BookName as B, type CacheOptions as C, LSBibleClient as L, MemoryCacheProvider as M, NoopCacheProvider as N, type Passage as P, type SearchResponse as S, type TextSegment as T, type VerseContent as V, type CacheProvider as a, CacheTTL as b, type LSBibleClientOptions as c, type VerseReference as d };