@dotdo/postgres 0.1.0

package/dist/iceberg/writer.js

@@ -0,0 +1,452 @@
+/**
+ * Iceberg Table Writer for WAL Storage
+ * Task: postgres-6qa - Apache Iceberg table format support
+ *
+ * Main writer class that coordinates WAL entry storage in Iceberg format
+ * on Cloudflare R2. Handles data files, manifests, and metadata updates.
+ */
+import { createLogger, LogLevel } from '@dotdo/postgres-shared';
+// Module-level logger for Iceberg writer errors
+const writerLogger = createLogger({
+    level: LogLevel.ERROR,
+    prefix: '[IcebergWriter]',
+});
+import { IcebergMetadataBuilder, ManifestBuilder, ManifestListBuilder, generateMetadataFileName, generateManifestFileName, generateManifestListFileName, generateDataFileName, } from './metadata';
+import { createWALSchema, createWALPartitionSpec, createWALSortOrder, getPartitionValue, generatePartitionPath, } from './schema';
+import { createWALParquetWriter, walEntryToParquetRecord, generateDataFileMetadata, } from './parquet';
+/**
+ * Default target file size (128 MB)
+ */
+const DEFAULT_TARGET_FILE_SIZE = 128 * 1024 * 1024;
+/**
+ * Iceberg WAL Writer
+ *
+ * Writes WAL entries to Iceberg tables on R2 storage.
+ * Manages partitioning, file creation, and metadata updates.
+ */
+export class IcebergWALWriter {
+    bucket;
+    tablePath;
+    targetFileSizeBytes;
+    properties;
+    metadataBuilder = null;
+    pendingFiles = new Map();
+    stats = {
+        snapshotsCreated: 0,
+        dataFilesWritten: 0,
+        recordsWritten: 0n,
+        bytesWritten: 0n,
+        lastSnapshotTimestamp: null,
+        lastCommitDurationMs: 0,
+    };
+    initialized = false;
+    metadataVersion = 0;
+    constructor(config) {
+        this.bucket = config.bucket;
+        this.tablePath = config.tablePath.replace(/\/$/, ''); // Remove trailing slash
+        this.targetFileSizeBytes = config.targetFileSizeBytes ?? DEFAULT_TARGET_FILE_SIZE;
+        this.properties = config.properties ?? {};
+    }
+    /**
+     * Initialize the writer, creating table metadata if needed
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        // Try to load existing metadata
+        const existingMetadata = await this.loadLatestMetadata();
+        if (existingMetadata) {
+            this.metadataBuilder = IcebergMetadataBuilder.fromMetadata(existingMetadata);
+            // Find the latest version number from metadata files
+            const metadataFiles = await this.listMetadataFiles();
+            this.metadataVersion = metadataFiles.length;
+        }
+        else {
+            // Create new table
+            this.metadataBuilder = new IcebergMetadataBuilder({
+                location: `${this.tablePath}`,
+                schema: createWALSchema(),
+                partitionSpec: createWALPartitionSpec(),
+                sortOrder: createWALSortOrder(),
+                properties: {
+                    'write.format.default': 'parquet',
+                    'write.parquet.compression-codec': 'snappy',
+                    ...this.properties,
+                },
+            });
+            // Write initial metadata
+            await this.writeMetadata();
+        }
+        this.initialized = true;
+    }
+    /**
+     * Ensure the writer is initialized
+     */
+    ensureInitialized() {
+        if (!this.initialized || !this.metadataBuilder) {
+            throw new Error('Writer not initialized. Call initialize() first.');
+        }
+    }
+    /**
+     * Load the latest table metadata from R2
+     */
+    async loadLatestMetadata() {
+        // First try version hint file
+        const versionHint = await this.bucket.get(`${this.tablePath}/metadata/version-hint.text`);
+        if (versionHint) {
+            const version = parseInt(await versionHint.text(), 10);
+            const metadataPath = `${this.tablePath}/metadata/v${version}.metadata.json`;
+            const metadata = await this.bucket.get(metadataPath);
+            if (metadata) {
+                return JSON.parse(await metadata.text());
+            }
+        }
+        // Fall back to listing metadata files
+        const metadataFiles = await this.listMetadataFiles();
+        if (metadataFiles.length === 0) {
+            return null;
+        }
+        // Get the latest version
+        const latestFile = metadataFiles[metadataFiles.length - 1];
+        if (!latestFile) {
+            return null;
+        }
+        const metadata = await this.bucket.get(latestFile);
+        if (metadata) {
+            return JSON.parse(await metadata.text());
+        }
+        return null;
+    }
+    /**
+     * List metadata files in version order
+     */
+    async listMetadataFiles() {
+        const list = await this.bucket.list({
+            prefix: `${this.tablePath}/metadata/`,
+        });
+        return list.objects
+            .filter((obj) => obj.key.endsWith('.metadata.json'))
+            .map((obj) => obj.key)
+            .sort((a, b) => {
+            const versionA = parseInt(a.match(/v(\d+)\.metadata\.json/)?.[1] ?? '0', 10);
+            const versionB = parseInt(b.match(/v(\d+)\.metadata\.json/)?.[1] ?? '0', 10);
+            return versionA - versionB;
+        });
+    }
+    /**
+     * Add WAL entries to be written
+     */
+    addEntries(entries, doId) {
+        this.ensureInitialized();
+        const partitionSpec = this.metadataBuilder.getCurrentPartitionSpec();
+        for (const entry of entries) {
+            const record = walEntryToParquetRecord(entry, doId);
+            const partition = getPartitionValue(record, partitionSpec);
+            const partitionPath = generatePartitionPath(partition);
+            // Get or create pending file for this partition
+            let pendingFile = this.pendingFiles.get(partitionPath);
+            if (!pendingFile) {
+                pendingFile = {
+                    partition,
+                    partitionPath,
+                    writer: createWALParquetWriter({
+                        'iceberg.schema': JSON.stringify(this.metadataBuilder.getCurrentSchema()),
+                        'iceberg.partition-spec': JSON.stringify(partitionSpec),
+                    }),
+                    records: [],
+                    estimatedSize: 0,
+                };
+                this.pendingFiles.set(partitionPath, pendingFile);
+            }
+            pendingFile.writer.addRecord(record);
+            pendingFile.records.push(record);
+            // Estimate size (rough JSON size approximation)
+            pendingFile.estimatedSize += JSON.stringify(record).length;
+        }
+    }
+    /**
+     * Check if any pending files should be flushed
+     */
+    shouldFlush() {
+        for (const pendingFile of this.pendingFiles.values()) {
+            if (pendingFile.estimatedSize >= this.targetFileSizeBytes) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return { ...this.stats };
+    }
+    /**
+     * Get the number of pending records
+     */
+    getPendingRecordCount() {
+        let count = 0;
+        for (const pendingFile of this.pendingFiles.values()) {
+            count += pendingFile.records.length;
+        }
+        return count;
+    }
+    /**
+     * Flush all pending data files and create a new snapshot
+     */
+    async flush() {
+        this.ensureInitialized();
+        if (this.pendingFiles.size === 0) {
+            return null;
+        }
+        const startTime = performance.now();
+        try {
+            // Write all pending data files
+            const dataFiles = [];
+            for (const [, pendingFile] of this.pendingFiles) {
+                const dataFile = await this.writeDataFile(pendingFile);
+                dataFiles.push(dataFile);
+            }
+            // Create manifest for the new data files
+            const sequenceNumber = this.metadataBuilder.nextSequenceNumber();
+            const snapshotId = Date.now() * 1000 + Math.floor(Math.random() * 1000);
+            const manifestBuilder = new ManifestBuilder({
+                partitionSpecId: this.metadataBuilder.getCurrentPartitionSpec()['spec-id'],
+                sequenceNumber,
+                snapshotId,
+            });
+            for (const dataFile of dataFiles) {
+                manifestBuilder.addDataFile(dataFile);
+            }
+            // Write manifest file
+            const manifestFileName = generateManifestFileName(snapshotId);
+            const manifestPath = `${this.tablePath}/metadata/${manifestFileName}`;
+            const manifestContent = manifestBuilder.toJSON();
+            const manifestBytes = new TextEncoder().encode(manifestContent);
+            await this.bucket.put(manifestPath, manifestBytes, {
+                httpMetadata: { contentType: 'application/json' },
+            });
+            const manifestFileMetadata = manifestBuilder.createManifestFileMetadata(manifestPath, manifestBytes.length);
+            // Create manifest list
+            const manifestListBuilder = new ManifestListBuilder(snapshotId, sequenceNumber);
+            manifestListBuilder.addManifest(manifestFileMetadata);
+            // Include existing manifests from previous snapshot
+            await this.includeExistingManifests(manifestListBuilder);
+            // Write manifest list
+            const manifestListFileName = generateManifestListFileName(snapshotId);
+            const manifestListPath = `${this.tablePath}/metadata/${manifestListFileName}`;
+            const manifestListContent = manifestListBuilder.toJSON();
+            const manifestListBytes = new TextEncoder().encode(manifestListContent);
+            await this.bucket.put(manifestListPath, manifestListBytes, {
+                httpMetadata: { contentType: 'application/json' },
+            });
+            // Calculate summary
+            const summary = manifestListBuilder.calculateSummary('append');
+            // Create snapshot
+            const snapshot = this.metadataBuilder.createSnapshot({
+                manifestListPath,
+                summary,
+            });
+            // Write updated metadata
+            await this.writeMetadata();
+            // Update stats
+            const recordsWritten = dataFiles.reduce((sum, f) => sum + f['record-count'], 0);
+            const bytesWritten = dataFiles.reduce((sum, f) => sum + f['file-size-in-bytes'], 0);
+            this.stats.snapshotsCreated++;
+            this.stats.dataFilesWritten += dataFiles.length;
+            this.stats.recordsWritten += BigInt(recordsWritten);
+            this.stats.bytesWritten += BigInt(bytesWritten);
+            this.stats.lastSnapshotTimestamp = snapshot['timestamp-ms'];
+            this.stats.lastCommitDurationMs = performance.now() - startTime;
+            // Clear pending files
+            this.pendingFiles.clear();
+            return snapshot;
+        }
+        catch (error) {
+            writerLogger.error('Failed to flush Iceberg data', { error: error instanceof Error ? error.message : String(error) });
+            throw error;
+        }
+    }
+    /**
+     * Write a single data file to R2
+     */
+    async writeDataFile(pendingFile) {
+        const filePath = generateDataFileName(pendingFile.partitionPath);
+        const fullPath = `${this.tablePath}/data/${filePath}`;
+        // Build Parquet data
+        const parquetData = pendingFile.writer.build();
+        // Write to R2
+        await this.bucket.put(fullPath, parquetData, {
+            httpMetadata: { contentType: 'application/octet-stream' },
+            customMetadata: {
+                'iceberg-partition': JSON.stringify(pendingFile.partition),
+                'record-count': String(pendingFile.records.length),
+            },
+        });
+        // Generate data file metadata
+        return generateDataFileMetadata(pendingFile.writer, fullPath, parquetData.length, pendingFile.partition, this.metadataBuilder.getCurrentSchema());
+    }
+    /**
+     * Include manifests from the previous snapshot
+     */
+    async includeExistingManifests(manifestListBuilder) {
+        const currentSnapshotId = this.metadataBuilder.getCurrentSnapshotId();
+        if (!currentSnapshotId) {
+            return;
+        }
+        const metadata = this.metadataBuilder.build();
+        const currentSnapshot = metadata.snapshots?.find((s) => s['snapshot-id'] === currentSnapshotId);
+        if (!currentSnapshot) {
+            return;
+        }
+        // Load previous manifest list
+        const manifestListData = await this.bucket.get(currentSnapshot['manifest-list']);
+        if (!manifestListData) {
+            return;
+        }
+        const manifestList = JSON.parse(await manifestListData.text());
+        if (manifestList.manifests) {
+            for (const manifest of manifestList.manifests) {
+                manifestListBuilder.addManifest(manifest);
+            }
+        }
+    }
+    /**
+     * Write table metadata to R2
+     */
+    async writeMetadata() {
+        if (!this.metadataBuilder) {
+            throw new Error('Metadata builder not initialized');
+        }
+        this.metadataVersion++;
+        const metadataFileName = generateMetadataFileName(this.metadataVersion);
+        const metadataPath = `${this.tablePath}/metadata/${metadataFileName}`;
+        // Add to metadata log
+        this.metadataBuilder.addMetadataLogEntry(metadataPath);
+        // Write metadata
+        const metadataContent = this.metadataBuilder.toJSON();
+        await this.bucket.put(metadataPath, metadataContent, {
+            httpMetadata: { contentType: 'application/json' },
+        });
+        // Update version hint
+        await this.bucket.put(`${this.tablePath}/metadata/version-hint.text`, String(this.metadataVersion), { httpMetadata: { contentType: 'text/plain' } });
+    }
+    /**
+     * Get the current table metadata
+     */
+    getMetadata() {
+        if (!this.metadataBuilder) {
+            return null;
+        }
+        return this.metadataBuilder.build();
+    }
+    /**
+     * Get table UUID
+     */
+    getTableUuid() {
+        return this.metadataBuilder?.getTableUuid() ?? null;
+    }
+    /**
+     * Get table location
+     */
+    getTableLocation() {
+        return this.tablePath;
+    }
+}
+/**
+ * Create an Iceberg WAL writer
+ */
+export function createIcebergWALWriter(config) {
+    return new IcebergWALWriter(config);
+}
+/**
+ * WAL to Iceberg streaming bridge
+ *
+ * Connects WAL manager to Iceberg writer for automatic streaming.
+ */
+export class WALIcebergBridge {
+    writer;
+    doId;
+    autoFlushThreshold;
+    flushIntervalMs;
+    flushTimer = null;
+    unsubscribe = null;
+    constructor(options) {
+        this.writer = options.writer;
+        this.doId = options.doId;
+        this.autoFlushThreshold = options.autoFlushThreshold ?? 1000;
+        this.flushIntervalMs = options.flushIntervalMs ?? 60000; // 1 minute default
+    }
+    /**
+     * Start the bridge (attach to WAL manager)
+     */
+    start(onEntry) {
+        this.unsubscribe = onEntry((entry) => {
+            this.handleEntry(entry);
+        });
+        // Start periodic flush timer
+        this.startFlushTimer();
+    }
+    /**
+     * Stop the bridge
+     */
+    async stop() {
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        // Final flush
+        await this.writer.flush();
+    }
+    /**
+     * Handle a WAL entry
+     */
+    handleEntry(entry) {
+        this.writer.addEntries([entry], this.doId);
+        // Check if we should auto-flush
+        if (this.writer.getPendingRecordCount() >= this.autoFlushThreshold) {
+            void this.writer.flush().catch((error) => {
+                writerLogger.error('Auto-flush failed', { error: error instanceof Error ? error.message : String(error) });
+            });
+        }
+    }
+    /**
+     * Start the periodic flush timer
+     */
+    startFlushTimer() {
+        this.flushTimer = setTimeout(() => {
+            this.periodicFlush();
+        }, this.flushIntervalMs);
+    }
+    /**
+     * Perform periodic flush
+     */
+    async periodicFlush() {
+        try {
+            await this.writer.flush();
+        }
+        catch (error) {
+            writerLogger.error('Periodic flush failed', { error: error instanceof Error ? error.message : String(error) });
+        }
+        // Restart timer
+        this.startFlushTimer();
+    }
+    /**
+     * Force a flush
+     */
+    async flush() {
+        return this.writer.flush();
+    }
+}
+/**
+ * Create a WAL to Iceberg bridge
+ */
+export function createWALIcebergBridge(options) {
+    return new WALIcebergBridge(options);
+}
+//# sourceMappingURL=writer.js.map

package/dist/iceberg/writer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @module @dotdo/postgres
+ *
+ * PostgreSQL server for Cloudflare Workers/DOs with PGLite WASM and tiered storage.
+ *
+ * This package provides a complete PostgreSQL-compatible database solution
+ * optimized for Cloudflare's edge infrastructure:
+ *
+ * - **Worker Module**: PostgresDO Durable Object with HTTP/WebSocket APIs
+ * - **PGLite Module**: Tiered storage system (Cache/DO/R2) for PGLite
+ * - **Extensions Module**: PGLite extension management and pgvector support
+ * - **Routing Module**: Intelligent query routing based on CPU cost estimation
+ * - **Read-Only Module**: Security-focused read-only deployment mode
+ * - **Middleware Module**: Rate limiting with sliding window and token bucket algorithms
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   PostgresDO,
+ *   createRoutes,
+ *   WebSocketHandler,
+ * } from '@dotdo/postgres'
+ *
+ * // Export the Durable Object
+ * export { PostgresDO }
+ *
+ * // Create Hono routes
+ * const app = new Hono()
+ * app.route('/api/sql', createRoutes(env))
+ *
+ * export default {
+ *   fetch: app.fetch,
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use tiered storage for PGLite
+ * import { createDOVFS, TieredVFS, CacheLayer } from '@dotdo/postgres/pglite'
+ *
+ * const vfs = createDOVFS(ctx.storage)
+ * const pglite = await PGlite.create({ vfs })
+ * ```
+ */
+export * from './config';
+export { createTenantId, createPageNumber, createMigrationVersion, createQueryId, createSnapshotId, createBlockId, createShardId, createIngestId, createReplicaId, createBatchId, isTenantId, isPageNumber, isMigrationVersion, isQueryId, isSnapshotId, isBlockId, isShardId, isIngestId, isReplicaId, isBatchId, unwrap, unsafeTenantId, unsafePageNumber, unsafeMigrationVersion, unsafeQueryId, unsafeSnapshotId, unsafeBlockId, unsafeShardId, unsafeIngestId, unsafeReplicaId, unsafeBatchId, TENANT_ID_MAX_LENGTH, TENANT_ID_PATTERN, MAX_PAGE_NUMBER, QUERY_ID_PATTERN, SNAPSHOT_ID_PATTERN, MAX_SNAPSHOT_ID, BLOCK_ID_PATTERN, SHARD_ID_PATTERN, SHARD_ID_MAX_LENGTH, INGEST_ID_PATTERN, INGEST_ID_MAX_LENGTH, REPLICA_ID_PATTERN, REPLICA_ID_MAX_LENGTH, BATCH_ID_PATTERN, BATCH_ID_MAX_LENGTH, } from './types/branded';
+export type { TenantId, PageNumber, MigrationVersion, QueryId, SnapshotId, BlockId, ShardId, IngestId, ReplicaId, BatchId, Branded, } from './types/branded';
+export { isDefined, isString, isNumber, isBoolean, isPlainObject, isArray, isFunction, isPromise, isError, assertDefined, assert, assertNever, success, failure, isSuccess, isFailure, toBodyInit, toArrayBuffer, isArrayBufferView, isUint8Array, narrowStorageValue, assertStorageValue, createDiscriminatorGuard, unsafeCast, safeCast, getProperty, hasProperty, hasProperties, } from './types/utilities';
+export type { Nullable, Optional, Maybe, NonNullish, Constructor, ConstructorWithArgs, AbstractConstructor, Success, Failure, Result, AsyncResult, DeepPartial, DeepRequired, DeepReadonly, DeepMutable, Awaited, MaybePromise, Awaitable, AsyncFunction, StringRecord, KeysOfType, PickByType, OmitByType, RequireKeys, OptionalKeys, ValueOf, AnyFunction, VoidFunction, Thunk, Predicate, TypeGuard, FirstParameter, LastParameter, Capitalize, Uncapitalize, Join, Head, Tail, Last, Length, DiscriminatedMessage, } from './types/utilities';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAMH,cAAc,UAAU,CAAA;AAMxB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,SAAS,EACT,OAAO,EACP,OAAO,GACR,MAAM,iBAAiB,CAAA;AAMxB,OAAO,EAEL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EAET,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EAEZ,kBAAkB,EAClB,kBAAkB,EAElB,wBAAwB,EAExB,UAAU,EACV,QAAQ,EAER,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAA;AAE1B,YAAY,EAEV,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,UAAU,EAEV,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EAEnB,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EAEX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,aAAa,EAEb,YAAY,EACZ,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,OAAO,EAEP,WAAW,EACX,YAAY,EACZ,KAAK,EACL,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EAEb,UAAU,EACV,YAAY,EACZ,IAAI,EAEJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,EAEN,oBAAoB,GACrB,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,69 @@
+/**
+ * @module @dotdo/postgres
+ *
+ * PostgreSQL server for Cloudflare Workers/DOs with PGLite WASM and tiered storage.
+ *
+ * This package provides a complete PostgreSQL-compatible database solution
+ * optimized for Cloudflare's edge infrastructure:
+ *
+ * - **Worker Module**: PostgresDO Durable Object with HTTP/WebSocket APIs
+ * - **PGLite Module**: Tiered storage system (Cache/DO/R2) for PGLite
+ * - **Extensions Module**: PGLite extension management and pgvector support
+ * - **Routing Module**: Intelligent query routing based on CPU cost estimation
+ * - **Read-Only Module**: Security-focused read-only deployment mode
+ * - **Middleware Module**: Rate limiting with sliding window and token bucket algorithms
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   PostgresDO,
+ *   createRoutes,
+ *   WebSocketHandler,
+ * } from '@dotdo/postgres'
+ *
+ * // Export the Durable Object
+ * export { PostgresDO }
+ *
+ * // Create Hono routes
+ * const app = new Hono()
+ * app.route('/api/sql', createRoutes(env))
+ *
+ * export default {
+ *   fetch: app.fetch,
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use tiered storage for PGLite
+ * import { createDOVFS, TieredVFS, CacheLayer } from '@dotdo/postgres/pglite'
+ *
+ * const vfs = createDOVFS(ctx.storage)
+ * const pglite = await PGlite.create({ vfs })
+ * ```
+ */
+// ============================================================================
+// Configuration Module - Centralized Constants
+// ============================================================================
+export * from './config';
+// ============================================================================
+// Worker Module - PostgresDO Durable Object
+// ============================================================================
+export { createTenantId, createPageNumber, createMigrationVersion, createQueryId, createSnapshotId, createBlockId, createShardId, createIngestId, createReplicaId, createBatchId, isTenantId, isPageNumber, isMigrationVersion, isQueryId, isSnapshotId, isBlockId, isShardId, isIngestId, isReplicaId, isBatchId, unwrap, unsafeTenantId, unsafePageNumber, unsafeMigrationVersion, unsafeQueryId, unsafeSnapshotId, unsafeBlockId, unsafeShardId, unsafeIngestId, unsafeReplicaId, unsafeBatchId, TENANT_ID_MAX_LENGTH, TENANT_ID_PATTERN, MAX_PAGE_NUMBER, QUERY_ID_PATTERN, SNAPSHOT_ID_PATTERN, MAX_SNAPSHOT_ID, BLOCK_ID_PATTERN, SHARD_ID_PATTERN, SHARD_ID_MAX_LENGTH, INGEST_ID_PATTERN, INGEST_ID_MAX_LENGTH, REPLICA_ID_PATTERN, REPLICA_ID_MAX_LENGTH, BATCH_ID_PATTERN, BATCH_ID_MAX_LENGTH, } from './types/branded';
+// ============================================================================
+// Type Utilities - Reusable type patterns
+// ============================================================================
+export { 
+// Utility functions
+isDefined, isString, isNumber, isBoolean, isPlainObject, isArray, isFunction, isPromise, isError, assertDefined, assert, assertNever, success, failure, isSuccess, isFailure, 
+// Web API helpers
+toBodyInit, toArrayBuffer, isArrayBufferView, isUint8Array, 
+// Storage helpers
+narrowStorageValue, assertStorageValue, 
+// Discriminated union helpers
+createDiscriminatorGuard, 
+// Safe casting utilities
+unsafeCast, safeCast, 
+// Object property helpers
+getProperty, hasProperty, hasProperties, } from './types/utilities';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E,cAAc,UAAU,CAAA;AAExB,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACT,MAAM,EACN,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAgBxB,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E,OAAO;AACL,oBAAoB;AACpB,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,aAAa,EACb,OAAO,EACP,UAAU,EACV,SAAS,EACT,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAW,EACX,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS;AACT,kBAAkB;AAClB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY;AACZ,kBAAkB;AAClB,kBAAkB,EAClB,kBAAkB;AAClB,8BAA8B;AAC9B,wBAAwB;AACxB,yBAAyB;AACzB,UAAU,EACV,QAAQ;AACR,0BAA0B;AAC1B,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,mBAAmB,CAAA"}

package/dist/lineage/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Data Lineage Tracking Module
+ * Task: postgres-zce - Data lineage tracking
+ *
+ * Comprehensive data lineage tracking for PostgresDO with WAL and Iceberg integration.
+ */
+export type { LineageNodeType, LineageOperationType, LineageJoinType, LineageAggregateFunction, ColumnLineage, JoinDependency, AggregateDependency, LineageNode, LineageEdge, LineageGraph, RowLineage, LineageQueryResult, LineageTrackerConfig, LineageStats, LineageVisualizationGraph, LineageVisualizationNode, LineageVisualizationEdge, IcebergLineageMetadata, LineageParseResult, } from './types';
+export { LineageTracker, createLineageTracker, parseLineage } from './tracker';
+export { LineageIntegration, createLineageIntegration, DOLineageCatalog, createDOLineageCatalog, } from './integration';
+export type { LineageIntegrationConfig, LineageCatalogStorage } from './integration';
+//# sourceMappingURL=index.d.ts.map

package/dist/lineage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lineage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAG9E,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,eAAe,CAAA;AAEtB,YAAY,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA"}

package/dist/lineage/index.js

@@ -0,0 +1,11 @@
+/**
+ * Data Lineage Tracking Module
+ * Task: postgres-zce - Data lineage tracking
+ *
+ * Comprehensive data lineage tracking for PostgresDO with WAL and Iceberg integration.
+ */
+// Export tracker
+export { LineageTracker, createLineageTracker, parseLineage } from './tracker';
+// Export integration
+export { LineageIntegration, createLineageIntegration, DOLineageCatalog, createDOLineageCatalog, } from './integration';
+//# sourceMappingURL=index.js.map

package/dist/lineage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lineage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE9E,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,eAAe,CAAA"}