@dotdo/postgres 0.1.0

package/dist/iceberg/analytics.js

@@ -0,0 +1,448 @@
+/**
+ * Iceberg Historical Data Analytics
+ * Task: postgres-no1 - Historical data analytics feature
+ *
+ * Provides historical analytics capabilities for Iceberg tables:
+ * - Change rate analysis (inserts, updates, deletes over time)
+ * - Row count trends across snapshots
+ * - Data growth metrics and projections
+ * - Snapshot comparison and diff analysis
+ *
+ * @example
+ * ```typescript
+ * const analytics = createHistoricalAnalytics({
+ *   bucket: env.ICEBERG_BUCKET,
+ *   catalog,
+ * })
+ *
+ * // Get change rates over a time period
+ * const changeRate = await analytics.getChangeRate(
+ *   tableId,
+ *   new Date('2024-01-01'),
+ *   new Date('2024-01-31')
+ * )
+ *
+ * // Get data growth metrics
+ * const growth = await analytics.getGrowthMetrics(tableId)
+ *
+ * // Compare two snapshots
+ * const comparison = await analytics.getSnapshotComparison(
+ *   tableId,
+ *   snapshotId1,
+ *   snapshotId2
+ * )
+ * ```
+ */
+import { IcebergTimeTravelReader, parseTimestamp, formatTimestamp, } from './time-travel';
+// ============================================================================
+// Historical Analytics Class
+// ============================================================================
+/**
+ * Historical Analytics for Iceberg Tables
+ *
+ * Provides advanced analytics capabilities for Iceberg time-travel data:
+ * - Change rate analysis
+ * - Growth trend analysis
+ * - Snapshot comparison
+ */
+export class HistoricalAnalytics {
+    bucket;
+    catalog;
+    reader;
+    retentionWindowMs;
+    enableCache;
+    cacheTtlMs;
+    cache = new Map();
+    constructor(config) {
+        this.bucket = config.bucket;
+        this.catalog = config.catalog;
+        this.retentionWindowMs = config.retentionWindowMs ?? 90 * 24 * 60 * 60 * 1000; // 90 days
+        this.enableCache = config.enableCache ?? true;
+        this.cacheTtlMs = config.cacheTtlMs ?? 5 * 60 * 1000; // 5 minutes
+        this.reader = new IcebergTimeTravelReader({
+            bucket: this.bucket,
+            retentionWindowMs: this.retentionWindowMs,
+        });
+    }
+    // ========== Change Rate Analysis ==========
+    /**
+     * Get change rate analysis for a table over a time period
+     *
+     * Analyzes insert, update, and delete rates between two timestamps.
+     *
+     * @param table - Table identifier
+     * @param startTime - Start timestamp
+     * @param endTime - End timestamp
+     * @returns Change rate analysis
+     */
+    async getChangeRate(table, startTime, endTime) {
+        const cacheKey = this.getCacheKey('changeRate', table, { startTime, endTime });
+        const cached = this.getFromCache(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const metadata = await this.catalog.loadTable(table);
+        const start = parseTimestamp(startTime);
+        const end = parseTimestamp(endTime);
+        // Get all snapshots in the time range
+        const snapshotsInRange = await this.reader.findSnapshotsInRange(metadata, start.timestampMs, end.timestampMs);
+        if (snapshotsInRange.length === 0) {
+            const result = {
+                startTimestampMs: start.timestampMs,
+                endTimestampMs: end.timestampMs,
+                durationMs: end.timestampMs - start.timestampMs,
+                totalAdded: 0,
+                totalDeleted: 0,
+                netChange: 0,
+                addedPerDay: 0,
+                deletedPerDay: 0,
+                netChangePerDay: 0,
+                snapshotCount: 0,
+                snapshots: [],
+            };
+            this.setInCache(cacheKey, result);
+            return result;
+        }
+        // Sort snapshots chronologically
+        snapshotsInRange.sort((a, b) => a['timestamp-ms'] - b['timestamp-ms']);
+        // Analyze each snapshot
+        const snapshotChanges = [];
+        let totalAdded = 0;
+        let totalDeleted = 0;
+        for (const snapshot of snapshotsInRange) {
+            const summary = snapshot.summary;
+            const recordsAdded = parseInt(summary['added-records'] ?? '0', 10);
+            const recordsDeleted = parseInt(summary['deleted-records'] ?? '0', 10);
+            const totalRecords = parseInt(summary['total-records'] ?? '0', 10);
+            totalAdded += recordsAdded;
+            totalDeleted += recordsDeleted;
+            snapshotChanges.push({
+                snapshotId: snapshot['snapshot-id'],
+                timestampMs: snapshot['timestamp-ms'],
+                timestamp: formatTimestamp(snapshot['timestamp-ms']),
+                recordsAdded,
+                recordsDeleted,
+                netChange: recordsAdded - recordsDeleted,
+                totalRecords,
+                operation: summary.operation,
+            });
+        }
+        // Calculate rates
+        const durationMs = end.timestampMs - start.timestampMs;
+        const durationDays = durationMs / (24 * 60 * 60 * 1000);
+        const result = {
+            startTimestampMs: start.timestampMs,
+            endTimestampMs: end.timestampMs,
+            durationMs,
+            totalAdded,
+            totalDeleted,
+            netChange: totalAdded - totalDeleted,
+            addedPerDay: durationDays > 0 ? totalAdded / durationDays : 0,
+            deletedPerDay: durationDays > 0 ? totalDeleted / durationDays : 0,
+            netChangePerDay: durationDays > 0 ? (totalAdded - totalDeleted) / durationDays : 0,
+            snapshotCount: snapshotsInRange.length,
+            snapshots: snapshotChanges,
+        };
+        this.setInCache(cacheKey, result);
+        return result;
+    }
+    // ========== Growth Metrics ==========
+    /**
+     * Get data growth metrics for a table
+     *
+     * Analyzes historical growth patterns and projects future growth.
+     *
+     * @param table - Table identifier
+     * @param samplingInterval - Optional sampling interval in ms (default: 1 day)
+     * @returns Growth metrics
+     */
+    async getGrowthMetrics(table, samplingInterval = 24 * 60 * 60 * 1000 // 1 day
+    ) {
+        const cacheKey = this.getCacheKey('growthMetrics', table, { samplingInterval });
+        const cached = this.getFromCache(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const metadata = await this.catalog.loadTable(table);
+        const snapshots = metadata.snapshots ?? [];
+        if (snapshots.length === 0) {
+            const result = {
+                currentRecordCount: 0,
+                currentDataSizeBytes: 0,
+                currentFileCount: 0,
+                oldestSnapshotMs: null,
+                newestSnapshotMs: null,
+                timeSpanMs: 0,
+                avgRecordsPerDay: 0,
+                avgBytesPerDay: 0,
+                projectedRecordsIn30Days: 0,
+                projectedBytesIn30Days: 0,
+                trend: 'stable',
+                history: [],
+            };
+            this.setInCache(cacheKey, result);
+            return result;
+        }
+        // Sort snapshots chronologically
+        const sortedSnapshots = [...snapshots].sort((a, b) => a['timestamp-ms'] - b['timestamp-ms']);
+        const oldestSnapshot = sortedSnapshots[0];
+        const newestSnapshot = sortedSnapshots[sortedSnapshots.length - 1];
+        // Sample snapshots at the given interval
+        const history = [];
+        let lastSampledTime = 0;
+        for (const snapshot of sortedSnapshots) {
+            const snapshotTime = snapshot['timestamp-ms'];
+            if (snapshotTime - lastSampledTime >= samplingInterval || history.length === 0) {
+                const summary = snapshot.summary;
+                const recordCount = parseInt(summary['total-records'] ?? '0', 10);
+                const dataSizeBytes = parseInt(summary['total-files-size'] ?? '0', 10);
+                const fileCount = parseInt(summary['added-data-files'] ?? '0', 10);
+                history.push({
+                    snapshotId: snapshot['snapshot-id'],
+                    timestampMs: snapshotTime,
+                    timestamp: formatTimestamp(snapshotTime),
+                    recordCount,
+                    dataSizeBytes,
+                    fileCount,
+                });
+                lastSampledTime = snapshotTime;
+            }
+        }
+        // Ensure we have the latest snapshot in history
+        const latestInHistory = history[history.length - 1];
+        if (latestInHistory && latestInHistory.snapshotId !== newestSnapshot['snapshot-id']) {
+            const summary = newestSnapshot.summary;
+            history.push({
+                snapshotId: newestSnapshot['snapshot-id'],
+                timestampMs: newestSnapshot['timestamp-ms'],
+                timestamp: formatTimestamp(newestSnapshot['timestamp-ms']),
+                recordCount: parseInt(summary['total-records'] ?? '0', 10),
+                dataSizeBytes: parseInt(summary['total-files-size'] ?? '0', 10),
+                fileCount: parseInt(summary['added-data-files'] ?? '0', 10),
+            });
+        }
+        // Calculate current metrics
+        const currentSummary = newestSnapshot.summary;
+        const currentRecordCount = parseInt(currentSummary['total-records'] ?? '0', 10);
+        const currentDataSizeBytes = parseInt(currentSummary['total-files-size'] ?? '0', 10);
+        const currentFileCount = parseInt(currentSummary['added-data-files'] ?? '0', 10);
+        // Calculate growth rates
+        const timeSpanMs = newestSnapshot['timestamp-ms'] - oldestSnapshot['timestamp-ms'];
+        const timeSpanDays = timeSpanMs / (24 * 60 * 60 * 1000);
+        const oldestSummary = oldestSnapshot.summary;
+        const oldestRecordCount = parseInt(oldestSummary['total-records'] ?? '0', 10);
+        const oldestDataSizeBytes = parseInt(oldestSummary['total-files-size'] ?? '0', 10);
+        const recordGrowth = currentRecordCount - oldestRecordCount;
+        const bytesGrowth = currentDataSizeBytes - oldestDataSizeBytes;
+        const avgRecordsPerDay = timeSpanDays > 0 ? recordGrowth / timeSpanDays : 0;
+        const avgBytesPerDay = timeSpanDays > 0 ? bytesGrowth / timeSpanDays : 0;
+        // Project 30 days into the future
+        const projectedRecordsIn30Days = Math.max(0, currentRecordCount + avgRecordsPerDay * 30);
+        const projectedBytesIn30Days = Math.max(0, currentDataSizeBytes + avgBytesPerDay * 30);
+        // Determine trend
+        let trend = 'stable';
+        if (avgRecordsPerDay >= 10) {
+            // Growing if adding >= 10 records/day on average
+            trend = 'growing';
+        }
+        else if (avgRecordsPerDay <= -10) {
+            // Shrinking if losing >= 10 records/day on average
+            trend = 'shrinking';
+        }
+        const result = {
+            currentRecordCount,
+            currentDataSizeBytes,
+            currentFileCount,
+            oldestSnapshotMs: oldestSnapshot['timestamp-ms'],
+            newestSnapshotMs: newestSnapshot['timestamp-ms'],
+            timeSpanMs,
+            avgRecordsPerDay,
+            avgBytesPerDay,
+            projectedRecordsIn30Days,
+            projectedBytesIn30Days,
+            trend,
+            history,
+        };
+        this.setInCache(cacheKey, result);
+        return result;
+    }
+    // ========== Snapshot Comparison ==========
+    /**
+     * Compare two snapshots and return the differences
+     *
+     * Analyzes the changes between two snapshots, including file additions,
+     * deletions, and statistical changes.
+     *
+     * @param table - Table identifier
+     * @param snapshot1Id - First snapshot ID (earlier)
+     * @param snapshot2Id - Second snapshot ID (later)
+     * @returns Snapshot comparison result
+     */
+    async getSnapshotComparison(table, snapshot1Id, snapshot2Id) {
+        const cacheKey = this.getCacheKey('snapshotComparison', table, {
+            snapshot1Id,
+            snapshot2Id,
+        });
+        const cached = this.getFromCache(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        const metadata = await this.catalog.loadTable(table);
+        // Find the snapshots
+        const snapshot1 = metadata.snapshots?.find((s) => s['snapshot-id'] === snapshot1Id);
+        const snapshot2 = metadata.snapshots?.find((s) => s['snapshot-id'] === snapshot2Id);
+        if (!snapshot1) {
+            throw new Error(`Snapshot ${snapshot1Id} not found`);
+        }
+        if (!snapshot2) {
+            throw new Error(`Snapshot ${snapshot2Id} not found`);
+        }
+        // Get data files for both snapshots
+        const files1 = await this.reader.getDataFilesForSnapshot(metadata, snapshot1);
+        const files2 = await this.reader.getDataFilesForSnapshot(metadata, snapshot2);
+        // Create maps for efficient lookup
+        const files1Map = new Map(files1.dataFiles.map((f) => [f['file-path'], f]));
+        const files2Map = new Map(files2.dataFiles.map((f) => [f['file-path'], f]));
+        // Find added, deleted, and unchanged files
+        const filesAdded = [];
+        const filesDeleted = [];
+        const filesUnchanged = [];
+        // Files in snapshot2 but not in snapshot1 = added
+        for (const [path, file] of files2Map) {
+            if (!files1Map.has(path)) {
+                filesAdded.push(file);
+            }
+            else {
+                filesUnchanged.push(file);
+            }
+        }
+        // Files in snapshot1 but not in snapshot2 = deleted
+        for (const [path, file] of files1Map) {
+            if (!files2Map.has(path)) {
+                filesDeleted.push(file);
+            }
+        }
+        // Extract summary info
+        const summary1 = snapshot1.summary;
+        const summary2 = snapshot2.summary;
+        const recordCount1 = parseInt(summary1['total-records'] ?? '0', 10);
+        const recordCount2 = parseInt(summary2['total-records'] ?? '0', 10);
+        const dataSize1 = parseInt(summary1['total-files-size'] ?? '0', 10);
+        const dataSize2 = parseInt(summary2['total-files-size'] ?? '0', 10);
+        // Calculate deltas
+        const recordCountDelta = recordCount2 - recordCount1;
+        const dataSizeDelta = dataSize2 - dataSize1;
+        const fileCountDelta = files2.dataFiles.length - files1.dataFiles.length;
+        const timeDifferenceMs = snapshot2['timestamp-ms'] - snapshot1['timestamp-ms'];
+        // Calculate percentage changes
+        const recordCountChangePercent = recordCount1 > 0 ? ((recordCountDelta / recordCount1) * 100) : 0;
+        const dataSizeChangePercent = dataSize1 > 0 ? ((dataSizeDelta / dataSize1) * 100) : 0;
+        // Calculate average file sizes
+        const avgFileSizeSnapshot1 = files1.dataFiles.length > 0
+            ? files1.dataFiles.reduce((sum, f) => sum + f['file-size-in-bytes'], 0) /
+                files1.dataFiles.length
+            : 0;
+        const avgFileSizeSnapshot2 = files2.dataFiles.length > 0
+            ? files2.dataFiles.reduce((sum, f) => sum + f['file-size-in-bytes'], 0) /
+                files2.dataFiles.length
+            : 0;
+        const result = {
+            snapshot1: {
+                snapshotId: snapshot1['snapshot-id'],
+                timestampMs: snapshot1['timestamp-ms'],
+                timestamp: formatTimestamp(snapshot1['timestamp-ms']),
+                recordCount: recordCount1,
+                dataSizeBytes: dataSize1,
+                fileCount: files1.dataFiles.length,
+                operation: summary1.operation,
+            },
+            snapshot2: {
+                snapshotId: snapshot2['snapshot-id'],
+                timestampMs: snapshot2['timestamp-ms'],
+                timestamp: formatTimestamp(snapshot2['timestamp-ms']),
+                recordCount: recordCount2,
+                dataSizeBytes: dataSize2,
+                fileCount: files2.dataFiles.length,
+                operation: summary2.operation,
+            },
+            timeDifferenceMs,
+            recordCountDelta,
+            dataSizeDelta,
+            fileCountDelta,
+            filesAdded,
+            filesDeleted,
+            filesUnchanged,
+            summary: {
+                recordCountChangePercent,
+                dataSizeChangePercent,
+                avgFileSizeSnapshot1,
+                avgFileSizeSnapshot2,
+            },
+        };
+        this.setInCache(cacheKey, result);
+        return result;
+    }
+    // ========== Cache Management ==========
+    /**
+     * Generate cache key
+     */
+    getCacheKey(operation, table, params) {
+        const namespace = table.namespace.levels.join('.');
+        const paramsStr = JSON.stringify(params);
+        return `${operation}:${namespace}.${table.name}:${paramsStr}`;
+    }
+    /**
+     * Get value from cache
+     */
+    getFromCache(key) {
+        if (!this.enableCache) {
+            return null;
+        }
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        if (entry.expiresAt < Date.now()) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.data;
+    }
+    /**
+     * Set value in cache
+     */
+    setInCache(key, data) {
+        if (!this.enableCache) {
+            return;
+        }
+        this.cache.set(key, {
+            data,
+            expiresAt: Date.now() + this.cacheTtlMs,
+        });
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            ttlMs: this.cacheTtlMs,
+        };
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a historical analytics instance
+ */
+export function createHistoricalAnalytics(config) {
+    return new HistoricalAnalytics(config);
+}
+//# sourceMappingURL=analytics.js.map

package/dist/iceberg/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/iceberg/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,GAEhB,MAAM,eAAe,CAAA;AAuLtB,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAU;IAChB,OAAO,CAAgB;IACvB,MAAM,CAAyB;IAC/B,iBAAiB,CAAQ;IACzB,WAAW,CAAS;IACpB,UAAU,CAAQ;IAClB,KAAK,GAAqC,IAAI,GAAG,EAAE,CAAA;IAE3D,YAAY,MAAiC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QAC3B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;QAC7B,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,UAAU;QACxF,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAA;QAC7C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,YAAY;QAEjE,IAAI,CAAC,MAAM,GAAG,IAAI,uBAAuB,CAAC;YACxC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;SAC1C,CAAC,CAAA;IACJ,CAAC;IAED,6CAA6C;IAE7C;;;;;;;;;OASG;IACH,KAAK,CAAC,aAAa,CACjB,KAAsB,EACtB,SAAwB,EACxB,OAAsB;QAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAqB,QAAQ,CAAC,CAAA;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;QACvC,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QAEnC,sCAAsC;QACtC,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAC7D,QAAQ,EACR,KAAK,CAAC,WAAW,EACjB,GAAG,CAAC,WAAW,CAChB,CAAA;QAED,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,GAAuB;gBACjC,gBAAgB,EAAE,KAAK,CAAC,WAAW;gBACnC,cAAc,EAAE,GAAG,CAAC,WAAW;gBAC/B,UAAU,EAAE,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW;gBAC/C,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,CAAC;gBACf,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,CAAC;gBAChB,eAAe,EAAE,CAAC;gBAClB,aAAa,EAAE,CAAC;gBAChB,SAAS,EAAE,EAAE;aACd,CAAA;YACD,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YACjC,OAAO,MAAM,CAAA;QACf,CAAC;QAED,iCAAiC;QACjC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAA;QAEtE,wBAAwB;QACxB,MAAM,eAAe,GAAyB,EAAE,CAAA;QAChD,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,IAAI,YAAY,GAAG,CAAC,CAAA;QAEpB,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAA;YAChC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;YAClE,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;YACtE,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;YAElE,UAAU,IAAI,YAAY,CAAA;YAC1B,YAAY,IAAI,cAAc,CAAA;YAE9B,eAAe,CAAC,IAAI,CAAC;gBACnB,UAAU,EAAE,QAAQ,CAAC,aAAa,CAAC;gBACnC,WAAW,EAAE,QAAQ,CAAC,cAAc,CAAC;gBACrC,SAAS,EAAE,eAAe,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;gBACpD,YAAY;gBACZ,cAAc;gBACd,SAAS,EAAE,YAAY,GAAG,cAAc;gBACxC,YAAY;gBACZ,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAA;QACJ,CAAC;QAED,kBAAkB;QAClB,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;QACtD,MAAM,YAAY,GAAG,UAAU,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;QAEvD,MAAM,MAAM,GAAuB;YACjC,gBAAgB,EAAE,KAAK,CAAC,WAAW;YACnC,cAAc,EAAE,GAAG,CAAC,WAAW;YAC/B,UAAU;YACV,UAAU;YACV,YAAY;YACZ,SAAS,EAAE,UAAU,GAAG,YAAY;YACpC,WAAW,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7D,aAAa,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YACjE,eAAe,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAClF,aAAa,EAAE,gBAAgB,CAAC,MAAM;YACtC,SAAS,EAAE,eAAe;SAC3B,CAAA;QAED,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACjC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,uCAAuC;IAEvC;;;;;;;;OAQG;IACH,KAAK,CAAC,gBAAgB,CACpB,KAAsB,EACtB,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ;;QAE/C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAA;QAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAgB,QAAQ,CAAC,CAAA;QACzD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QACpD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAA;QAE1C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAkB;gBAC5B,kBAAkB,EAAE,CAAC;gBACrB,oBAAoB,EAAE,CAAC;gBACvB,gBAAgB,EAAE,CAAC;gBACnB,gBAAgB,EAAE,IAAI;gBACtB,gBAAgB,EAAE,IAAI;gBACtB,UAAU,EAAE,CAAC;gBACb,gBAAgB,EAAE,CAAC;gBACnB,cAAc,EAAE,CAAC;gBACjB,wBAAwB,EAAE,CAAC;gBAC3B,sBAAsB,EAAE,CAAC;gBACzB,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,EAAE;aACZ,CAAA;YACD,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YACjC,OAAO,MAAM,CAAA;QACf,CAAC;QAED,iCAAiC;QACjC,MAAM,eAAe,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CACzC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAChD,CAAA;QAED,MAAM,cAAc,GAAG,eAAe,CAAC,CAAC,CAAE,CAAA;QAC1C,MAAM,cAAc,GAAG,eAAe,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAE,CAAA;QAEnE,yCAAyC;QACzC,MAAM,OAAO,GAAsB,EAAE,CAAA;QACrC,IAAI,eAAe,GAAG,CAAC,CAAA;QAEvB,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;YACvC,MAAM,YAAY,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAA;YAE7C,IAAI,YAAY,GAAG,eAAe,IAAI,gBAAgB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/E,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAA;gBAChC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;gBACjE,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;gBACtE,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;gBAElE,OAAO,CAAC,IAAI,CAAC;oBACX,UAAU,EAAE,QAAQ,CAAC,aAAa,CAAC;oBACnC,WAAW,EAAE,YAAY;oBACzB,SAAS,EAAE,eAAe,CAAC,YAAY,CAAC;oBACxC,WAAW;oBACX,aAAa;oBACb,SAAS;iBACV,CAAC,CAAA;gBAEF,eAAe,GAAG,YAAY,CAAA;YAChC,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACnD,IAAI,eAAe,IAAI,eAAe,CAAC,UAAU,KAAK,cAAc,CAAC,aAAa,CAAC,EAAE,CAAC;YACpF,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAA;YACtC,OAAO,CAAC,IAAI,CAAC;gBACX,UAAU,EAAE,cAAc,CAAC,aAAa,CAAC;gBACzC,WAAW,EAAE,cAAc,CAAC,cAAc,CAAC;gBAC3C,SAAS,EAAE,eAAe,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;gBAC1D,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;gBAC1D,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;gBAC/D,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;aAC5D,CAAC,CAAA;QACJ,CAAC;QAED,4BAA4B;QAC5B,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAA;QAC7C,MAAM,kBAAkB,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QAC/E,MAAM,oBAAoB,GAAG,QAAQ,CAAC,cAAc,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QACpF,MAAM,gBAAgB,GAAG,QAAQ,CAAC,cAAc,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QAEhF,yBAAyB;QACzB,MAAM,UAAU,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC,cAAc,CAAC,CAAA;QAClF,MAAM,YAAY,GAAG,UAAU,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;QAEvD,MAAM,aAAa,GAAG,cAAc,CAAC,OAAO,CAAA;QAC5C,MAAM,iBAAiB,GAAG,QAAQ,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QAC7E,MAAM,mBAAmB,GAAG,QAAQ,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QAElF,MAAM,YAAY,GAAG,kBAAkB,GAAG,iBAAiB,CAAA;QAC3D,MAAM,WAAW,GAAG,oBAAoB,GAAG,mBAAmB,CAAA;QAE9D,MAAM,gBAAgB,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3E,MAAM,cAAc,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;QAExE,kCAAkC;QAClC,MAAM,wBAAwB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,EAAE,CAAC,CAAA;QACxF,MAAM,sBAAsB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,GAAG,cAAc,GAAG,EAAE,CAAC,CAAA;QAEtF,kBAAkB;QAClB,IAAI,KAAK,GAAuC,QAAQ,CAAA;QACxD,IAAI,gBAAgB,IAAI,EAAE,EAAE,CAAC;YAC3B,iDAAiD;YACjD,KAAK,GAAG,SAAS,CAAA;QACnB,CAAC;aAAM,IAAI,gBAAgB,IAAI,CAAC,EAAE,EAAE,CAAC;YACnC,mDAAmD;YACnD,KAAK,GAAG,WAAW,CAAA;QACrB,CAAC;QAED,MAAM,MAAM,GAAkB;YAC5B,kBAAkB;YAClB,oBAAoB;YACpB,gBAAgB;YAChB,gBAAgB,EAAE,cAAc,CAAC,cAAc,CAAC;YAChD,gBAAgB,EAAE,cAAc,CAAC,cAAc,CAAC;YAChD,UAAU;YACV,gBAAgB;YAChB,cAAc;YACd,wBAAwB;YACxB,sBAAsB;YACtB,KAAK;YACL,OAAO;SACR,CAAA;QAED,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACjC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,4CAA4C;IAE5C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,qBAAqB,CACzB,KAAsB,EACtB,WAAmB,EACnB,WAAmB;QAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,oBAAoB,EAAE,KAAK,EAAE;YAC7D,WAAW;YACX,WAAW;SACZ,CAAC,CAAA;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAqB,QAAQ,CAAC,CAAA;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;QAEpD,qBAAqB;QACrB,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,WAAW,CAAC,CAAA;QACnF,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,WAAW,CAAC,CAAA;QAEnF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,YAAY,WAAW,YAAY,CAAC,CAAA;QACtD,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,YAAY,WAAW,YAAY,CAAC,CAAA;QACtD,CAAC;QAED,oCAAoC;QACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAE7E,mCAAmC;QACnC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QAE3E,2CAA2C;QAC3C,MAAM,UAAU,GAAsB,EAAE,CAAA;QACxC,MAAM,YAAY,GAAsB,EAAE,CAAA;QAC1C,MAAM,cAAc,GAAsB,EAAE,CAAA;QAE5C,kDAAkD;QAClD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACvB,CAAC;iBAAM,CAAC;gBACN,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACzB,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAA;QAClC,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAA;QAElC,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QACnE,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QACnE,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QACnE,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAA;QAEnE,mBAAmB;QACnB,MAAM,gBAAgB,GAAG,YAAY,GAAG,YAAY,CAAA;QACpD,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,CAAA;QAC3C,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAA;QACxE,MAAM,gBAAgB,GAAG,SAAS,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC,cAAc,CAAC,CAAA;QAE9E,+BAA+B;QAC/B,MAAM,wBAAwB,GAC5B,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAClE,MAAM,qBAAqB,GACzB,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAEzD,+BAA+B;QAC/B,MAAM,oBAAoB,GACxB,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;gBACrE,MAAM,CAAC,SAAS,CAAC,MAAM;YACzB,CAAC,CAAC,CAAC,CAAA;QACP,MAAM,oBAAoB,GACxB,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YACzB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;gBACrE,MAAM,CAAC,SAAS,CAAC,MAAM;YACzB,CAAC,CAAC,CAAC,CAAA;QAEP,MAAM,MAAM,GAAuB;YACjC,SAAS,EAAE;gBACT,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC;gBACpC,WAAW,EAAE,SAAS,CAAC,cAAc,CAAC;gBACtC,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;gBACrD,WAAW,EAAE,YAAY;gBACzB,aAAa,EAAE,SAAS;gBACxB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;gBAClC,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC9B;YACD,SAAS,EAAE;gBACT,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC;gBACpC,WAAW,EAAE,SAAS,CAAC,cAAc,CAAC;gBACtC,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;gBACrD,WAAW,EAAE,YAAY;gBACzB,aAAa,EAAE,SAAS;gBACxB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;gBAClC,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC9B;YACD,gBAAgB;YAChB,gBAAgB;YAChB,aAAa;YACb,cAAc;YACd,UAAU;YACV,YAAY;YACZ,cAAc;YACd,OAAO,EAAE;gBACP,wBAAwB;gBACxB,qBAAqB;gBACrB,oBAAoB;gBACpB,oBAAoB;aACrB;SACF,CAAA;QAED,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACjC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,yCAAyC;IAEzC;;OAEG;IACK,WAAW,CACjB,SAAiB,EACjB,KAAsB,EACtB,MAA+B;QAE/B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACxC,OAAO,GAAG,SAAS,IAAI,SAAS,IAAI,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,CAAA;IAC/D,CAAC;IAED;;OAEG;IACK,YAAY,CAAI,GAAW;QACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACtB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,KAAK,CAAC,IAAS,CAAA;IACxB,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,GAAW,EAAE,IAAa;QAC3C,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAM;QACR,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU;SACxC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,KAAK,EAAE,IAAI,CAAC,UAAU;SACvB,CAAA;IACH,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAiC;IAEjC,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC"}

package/dist/iceberg/catalog-api.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Iceberg Catalog REST API
+ * Task: postgres-b44 - Iceberg metadata storage strategy
+ *
+ * Implements the Iceberg REST Catalog API specification for external tool compatibility.
+ * Compatible with:
+ * - Apache Spark
+ * - Trino/Presto
+ * - DuckDB
+ * - PyIceberg
+ * - Any Iceberg REST catalog client
+ *
+ * @see https://github.com/apache/iceberg/blob/main/open-api/rest-catalog-open-api.yaml
+ */
+import { Hono } from 'hono';
+import type { Context } from 'hono';
+import { IcebergCatalog } from './catalog';
+/**
+ * API configuration
+ */
+export interface CatalogApiConfig {
+    /** The Iceberg catalog instance */
+    catalog: IcebergCatalog;
+    /** API prefix (default: '/api/catalog/v1') */
+    prefix?: string;
+    /** Enable CORS (default: true) */
+    cors?: boolean;
+    /** Authentication handler (optional) */
+    authenticate?: (c: Context) => Promise<boolean>;
+}
+/**
+ * Create the Iceberg Catalog REST API router
+ */
+export declare function createCatalogApi(config: CatalogApiConfig): Hono;
+/**
+ * Create a Hono middleware that adds catalog API routes
+ */
+export declare function catalogApiMiddleware(config: CatalogApiConfig): Hono;
+//# sourceMappingURL=catalog-api.d.ts.map

package/dist/iceberg/catalog-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-api.d.ts","sourceRoot":"","sources":["../../src/iceberg/catalog-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,EACL,cAAc,EASf,MAAM,WAAW,CAAA;AAWlB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,OAAO,EAAE,cAAc,CAAA;IACvB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,wCAAwC;IACxC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAChD;AAqCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAsa/D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAEnE"}