@dotdo/do 0.1.0

package/dist/db/storage/cold.d.ts

@@ -0,0 +1,313 @@
+/**
+ * Cold Storage - R2 + Iceberg
+ *
+ * Long-term archival storage using R2 with Apache Iceberg table format.
+ * Provides ~69ms latency at $0.015/GB/month for historical data and analytics.
+ *
+ * Features:
+ * - Iceberg table format for ACID transactions
+ * - Parquet columnar storage
+ * - Time-travel queries
+ * - Partition pruning
+ *
+ * @module @do/core/storage/cold
+ */
+import type { R2ObjectRef, IcebergTable, IcebergSchema, IcebergSnapshot, IcebergPartitionSpec, Snapshot } from '../../types/storage';
+/**
+ * Cold storage configuration
+ */
+export interface ColdStorageConfig {
+    /** R2 key prefix for all objects */
+    prefix?: string;
+    /** Default partition fields */
+    partitionBy?: string[];
+    /** Compression codec for Parquet files */
+    compressionCodec?: 'none' | 'zstd' | 'snappy' | 'gzip';
+    /** Target file size in bytes */
+    targetFileSize?: number;
+    /** Enable automatic compaction */
+    autoCompact?: boolean;
+}
+/**
+ * Query options for cold storage
+ */
+export interface ColdQueryOptions {
+    /** Filter conditions */
+    where?: Record<string, unknown>;
+    /** Time range for time-travel */
+    timeRange?: {
+        start: number;
+        end: number;
+    };
+    /** Snapshot ID for time-travel */
+    snapshotId?: string;
+    /** Partition filters for pruning */
+    partitions?: Record<string, string | number>;
+    /** Columns to select (projection pushdown) */
+    columns?: string[];
+    /** Maximum rows to return */
+    limit?: number;
+}
+/**
+ * Archive options
+ */
+export interface ArchiveOptions {
+    /** Custom partition values */
+    partition?: Record<string, string | number>;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+    /** Compression override */
+    compression?: 'none' | 'zstd' | 'snappy' | 'gzip';
+}
+/**
+ * Compaction options
+ */
+export interface CompactOptions {
+    /** Minimum files to trigger compaction */
+    minFiles?: number;
+    /** Target file size after compaction */
+    targetSize?: number;
+    /** Only compact files smaller than this */
+    maxFileSize?: number;
+}
+/**
+ * Cold storage statistics
+ */
+export interface ColdStorageStats {
+    /** Total tables */
+    tableCount: number;
+    /** Total snapshots */
+    snapshotCount: number;
+    /** Total data files */
+    fileCount: number;
+    /** Total size in bytes */
+    totalSizeBytes: number;
+    /** Oldest data timestamp */
+    oldestTimestamp: number;
+    /** Newest data timestamp */
+    newestTimestamp: number;
+}
+/**
+ * Cold storage implementation using R2 + Iceberg
+ *
+ * @example
+ * ```typescript
+ * const cold = new ColdStorage(r2Bucket)
+ *
+ * // Archive a snapshot
+ * await cold.archive(snapshot, {
+ *   partition: { year: 2024, month: 1 },
+ * })
+ *
+ * // Query historical data
+ * const orders = await cold.query('orders', {
+ *   where: { status: 'completed' },
+ *   timeRange: { start: lastMonth, end: today },
+ *   partitions: { year: 2024 },
+ * })
+ *
+ * // Time-travel query
+ * const asOf = await cold.queryAsOf('orders', snapshotId)
+ *
+ * // List table snapshots
+ * const snapshots = await cold.listSnapshots('orders')
+ * ```
+ */
+export declare class ColdStorage {
+    private readonly r2;
+    private config;
+    /**
+     * Create a new cold storage instance
+     *
+     * @param r2 - R2 bucket binding
+     * @param config - Storage configuration
+     */
+    constructor(r2: R2Bucket, config?: ColdStorageConfig);
+    /**
+     * Archive a DO snapshot to cold storage
+     *
+     * Converts snapshot data to Parquet format and stores in R2
+     * following Iceberg table structure.
+     *
+     * @param snapshot - Snapshot to archive
+     * @param options - Archive options
+     * @returns R2 object reference
+     *
+     * @example
+     * ```typescript
+     * const ref = await cold.archive(snapshot, {
+     *   partition: { year: 2024, month: 1, day: 15 },
+     * })
+     * console.log(`Archived to: ${ref.key}`)
+     * ```
+     */
+    archive(snapshot: Snapshot, options?: ArchiveOptions): Promise<R2ObjectRef>;
+    /**
+     * Query data from cold storage
+     *
+     * Uses Iceberg metadata for partition pruning and
+     * Parquet predicate pushdown for efficient queries.
+     *
+     * @param table - Table name
+     * @param options - Query options
+     * @returns Query results
+     *
+     * @example
+     * ```typescript
+     * const results = await cold.query('orders', {
+     *   where: { customerId: 'cust_123' },
+     *   timeRange: { start: startOfYear, end: endOfYear },
+     *   columns: ['id', 'amount', 'status'],
+     *   limit: 1000,
+     * })
+     * ```
+     */
+    query<T>(table: string, options?: ColdQueryOptions): Promise<T[]>;
+    /**
+     * Query data as of a specific snapshot (time-travel)
+     *
+     * @param table - Table name
+     * @param snapshotId - Snapshot ID to query
+     * @param options - Additional query options
+     * @returns Query results as of that snapshot
+     *
+     * @example
+     * ```typescript
+     * // Query orders as they were 30 days ago
+     * const snapshot = await cold.getSnapshotAt('orders', thirtyDaysAgo)
+     * const orders = await cold.queryAsOf('orders', snapshot.snapshotId)
+     * ```
+     */
+    queryAsOf<T>(table: string, snapshotId: string, options?: Omit<ColdQueryOptions, 'snapshotId'>): Promise<T[]>;
+    /**
+     * Get table metadata
+     *
+     * @param table - Table name
+     * @returns Iceberg table metadata
+     */
+    getTable(table: string): Promise<IcebergTable | null>;
+    /**
+     * Create a new Iceberg table
+     *
+     * @param table - Table name
+     * @param schema - Table schema
+     * @param options - Table options
+     * @returns Created table metadata
+     */
+    createTable(table: string, schema: IcebergSchema, options?: {
+        partitionSpec?: IcebergPartitionSpec;
+        properties?: Record<string, string>;
+    }): Promise<IcebergTable>;
+    /**
+     * List snapshots for a table
+     *
+     * @param table - Table name
+     * @param options - List options
+     * @returns Array of snapshots
+     */
+    listSnapshots(table: string, options?: {
+        limit?: number;
+        after?: string;
+    }): Promise<IcebergSnapshot[]>;
+    /**
+     * Get snapshot at a specific timestamp
+     *
+     * @param table - Table name
+     * @param timestamp - Target timestamp
+     * @returns Snapshot valid at that time or null
+     */
+    getSnapshotAt(table: string, timestamp: number): Promise<IcebergSnapshot | null>;
+    /**
+     * Restore data from a snapshot
+     *
+     * @param snapshot - DO snapshot to restore
+     * @returns Restored snapshot data
+     */
+    restore(snapshotId: string): Promise<Snapshot>;
+    /**
+     * Delete old snapshots (expire)
+     *
+     * @param table - Table name
+     * @param options - Expiration options
+     * @returns Number of snapshots deleted
+     */
+    expireSnapshots(table: string, options: {
+        olderThan?: number;
+        retainLast?: number;
+    }): Promise<number>;
+    /**
+     * Compact small files into larger ones
+     *
+     * @param table - Table name
+     * @param options - Compaction options
+     * @returns Compaction result
+     */
+    compact(table: string, options?: CompactOptions): Promise<{
+        filesCompacted: number;
+        filesCreated: number;
+        bytesRemoved: number;
+        bytesAdded: number;
+    }>;
+    /**
+     * List all tables
+     *
+     * @returns Array of table names
+     */
+    listTables(): Promise<string[]>;
+    /**
+     * Delete a table and all its data
+     *
+     * @param table - Table name
+     */
+    dropTable(table: string): Promise<void>;
+    /**
+     * Get storage statistics
+     *
+     * @returns Cold storage statistics
+     */
+    getStats(): Promise<ColdStorageStats>;
+    /**
+     * Build R2 key for an object
+     *
+     * @param components - Key components
+     * @returns Full R2 key
+     */
+    private buildKey;
+    /**
+     * Build partition path from values
+     *
+     * @param partitions - Partition values
+     * @returns Partition path component
+     */
+    private buildPartitionPath;
+}
+/**
+ * Convert data to Parquet format
+ *
+ * @param data - Data to convert
+ * @param schema - Schema definition
+ * @param options - Conversion options
+ * @returns Parquet file as ArrayBuffer
+ */
+export declare function toParquet(data: unknown[], schema: IcebergSchema, options?: {
+    compression?: 'none' | 'zstd' | 'snappy' | 'gzip';
+}): Promise<ArrayBuffer>;
+/**
+ * Read data from Parquet format
+ *
+ * @param buffer - Parquet file buffer
+ * @param options - Read options
+ * @returns Parsed data
+ */
+export declare function fromParquet<T>(buffer: ArrayBuffer, options?: {
+    columns?: string[];
+    rowFilter?: (row: unknown) => boolean;
+}): Promise<T[]>;
+/**
+ * Create Iceberg schema from TypeScript type
+ *
+ * @param sample - Sample object
+ * @returns Iceberg schema
+ */
+export declare function inferSchema(sample: Record<string, unknown>): IcebergSchema;
+//# sourceMappingURL=cold.d.ts.map

package/dist/db/storage/cold.d.ts.map

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

package/dist/db/storage/cold.js

@@ -0,0 +1,319 @@
+/**
+ * Cold Storage - R2 + Iceberg
+ *
+ * Long-term archival storage using R2 with Apache Iceberg table format.
+ * Provides ~69ms latency at $0.015/GB/month for historical data and analytics.
+ *
+ * Features:
+ * - Iceberg table format for ACID transactions
+ * - Parquet columnar storage
+ * - Time-travel queries
+ * - Partition pruning
+ *
+ * @module @do/core/storage/cold
+ */
+/**
+ * Cold storage implementation using R2 + Iceberg
+ *
+ * @example
+ * ```typescript
+ * const cold = new ColdStorage(r2Bucket)
+ *
+ * // Archive a snapshot
+ * await cold.archive(snapshot, {
+ *   partition: { year: 2024, month: 1 },
+ * })
+ *
+ * // Query historical data
+ * const orders = await cold.query('orders', {
+ *   where: { status: 'completed' },
+ *   timeRange: { start: lastMonth, end: today },
+ *   partitions: { year: 2024 },
+ * })
+ *
+ * // Time-travel query
+ * const asOf = await cold.queryAsOf('orders', snapshotId)
+ *
+ * // List table snapshots
+ * const snapshots = await cold.listSnapshots('orders')
+ * ```
+ */
+export class ColdStorage {
+    r2;
+    config;
+    /**
+     * Create a new cold storage instance
+     *
+     * @param r2 - R2 bucket binding
+     * @param config - Storage configuration
+     */
+    constructor(r2, config) {
+        this.r2 = r2;
+        this.config = {
+            prefix: config?.prefix ?? 'iceberg/',
+            partitionBy: config?.partitionBy ?? ['year', 'month'],
+            compressionCodec: config?.compressionCodec ?? 'zstd',
+            targetFileSize: config?.targetFileSize ?? 128 * 1024 * 1024, // 128MB
+            autoCompact: config?.autoCompact ?? true,
+        };
+    }
+    /**
+     * Archive a DO snapshot to cold storage
+     *
+     * Converts snapshot data to Parquet format and stores in R2
+     * following Iceberg table structure.
+     *
+     * @param snapshot - Snapshot to archive
+     * @param options - Archive options
+     * @returns R2 object reference
+     *
+     * @example
+     * ```typescript
+     * const ref = await cold.archive(snapshot, {
+     *   partition: { year: 2024, month: 1, day: 15 },
+     * })
+     * console.log(`Archived to: ${ref.key}`)
+     * ```
+     */
+    async archive(snapshot, options) {
+        // TODO: Implement snapshot archival
+        // 1. Convert snapshot tables to Parquet
+        // 2. Build Iceberg metadata
+        // 3. Store in R2 with proper key structure
+        throw new Error('Not implemented');
+    }
+    /**
+     * Query data from cold storage
+     *
+     * Uses Iceberg metadata for partition pruning and
+     * Parquet predicate pushdown for efficient queries.
+     *
+     * @param table - Table name
+     * @param options - Query options
+     * @returns Query results
+     *
+     * @example
+     * ```typescript
+     * const results = await cold.query('orders', {
+     *   where: { customerId: 'cust_123' },
+     *   timeRange: { start: startOfYear, end: endOfYear },
+     *   columns: ['id', 'amount', 'status'],
+     *   limit: 1000,
+     * })
+     * ```
+     */
+    async query(table, options) {
+        // TODO: Implement Iceberg query
+        // 1. Read table metadata
+        // 2. Apply partition pruning
+        // 3. Read relevant Parquet files
+        // 4. Apply predicate pushdown
+        // 5. Return filtered results
+        throw new Error('Not implemented');
+    }
+    /**
+     * Query data as of a specific snapshot (time-travel)
+     *
+     * @param table - Table name
+     * @param snapshotId - Snapshot ID to query
+     * @param options - Additional query options
+     * @returns Query results as of that snapshot
+     *
+     * @example
+     * ```typescript
+     * // Query orders as they were 30 days ago
+     * const snapshot = await cold.getSnapshotAt('orders', thirtyDaysAgo)
+     * const orders = await cold.queryAsOf('orders', snapshot.snapshotId)
+     * ```
+     */
+    async queryAsOf(table, snapshotId, options) {
+        // TODO: Implement time-travel query
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get table metadata
+     *
+     * @param table - Table name
+     * @returns Iceberg table metadata
+     */
+    async getTable(table) {
+        // TODO: Implement table metadata retrieval
+        throw new Error('Not implemented');
+    }
+    /**
+     * Create a new Iceberg table
+     *
+     * @param table - Table name
+     * @param schema - Table schema
+     * @param options - Table options
+     * @returns Created table metadata
+     */
+    async createTable(table, schema, options) {
+        // TODO: Implement table creation
+        throw new Error('Not implemented');
+    }
+    /**
+     * List snapshots for a table
+     *
+     * @param table - Table name
+     * @param options - List options
+     * @returns Array of snapshots
+     */
+    async listSnapshots(table, options) {
+        // TODO: Implement snapshot listing
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get snapshot at a specific timestamp
+     *
+     * @param table - Table name
+     * @param timestamp - Target timestamp
+     * @returns Snapshot valid at that time or null
+     */
+    async getSnapshotAt(table, timestamp) {
+        // TODO: Implement snapshot lookup by timestamp
+        throw new Error('Not implemented');
+    }
+    /**
+     * Restore data from a snapshot
+     *
+     * @param snapshot - DO snapshot to restore
+     * @returns Restored snapshot data
+     */
+    async restore(snapshotId) {
+        // TODO: Implement snapshot restoration
+        throw new Error('Not implemented');
+    }
+    /**
+     * Delete old snapshots (expire)
+     *
+     * @param table - Table name
+     * @param options - Expiration options
+     * @returns Number of snapshots deleted
+     */
+    async expireSnapshots(table, options) {
+        // TODO: Implement snapshot expiration
+        throw new Error('Not implemented');
+    }
+    /**
+     * Compact small files into larger ones
+     *
+     * @param table - Table name
+     * @param options - Compaction options
+     * @returns Compaction result
+     */
+    async compact(table, options) {
+        // TODO: Implement file compaction
+        throw new Error('Not implemented');
+    }
+    /**
+     * List all tables
+     *
+     * @returns Array of table names
+     */
+    async listTables() {
+        // TODO: Implement table listing
+        throw new Error('Not implemented');
+    }
+    /**
+     * Delete a table and all its data
+     *
+     * @param table - Table name
+     */
+    async dropTable(table) {
+        // TODO: Implement table deletion
+        throw new Error('Not implemented');
+    }
+    /**
+     * Get storage statistics
+     *
+     * @returns Cold storage statistics
+     */
+    async getStats() {
+        // TODO: Implement statistics gathering
+        throw new Error('Not implemented');
+    }
+    /**
+     * Build R2 key for an object
+     *
+     * @param components - Key components
+     * @returns Full R2 key
+     */
+    buildKey(...components) {
+        return `${this.config.prefix}${components.join('/')}`;
+    }
+    /**
+     * Build partition path from values
+     *
+     * @param partitions - Partition values
+     * @returns Partition path component
+     */
+    buildPartitionPath(partitions) {
+        return Object.entries(partitions)
+            .map(([key, value]) => `${key}=${value}`)
+            .join('/');
+    }
+}
+/**
+ * Convert data to Parquet format
+ *
+ * @param data - Data to convert
+ * @param schema - Schema definition
+ * @param options - Conversion options
+ * @returns Parquet file as ArrayBuffer
+ */
+export async function toParquet(data, schema, options) {
+    // TODO: Implement Parquet encoding
+    throw new Error('Not implemented');
+}
+/**
+ * Read data from Parquet format
+ *
+ * @param buffer - Parquet file buffer
+ * @param options - Read options
+ * @returns Parsed data
+ */
+export async function fromParquet(buffer, options) {
+    // TODO: Implement Parquet decoding
+    throw new Error('Not implemented');
+}
+/**
+ * Create Iceberg schema from TypeScript type
+ *
+ * @param sample - Sample object
+ * @returns Iceberg schema
+ */
+export function inferSchema(sample) {
+    const fields = Object.entries(sample).map(([name, value], id) => ({
+        id,
+        name,
+        type: inferIcebergType(value),
+        required: value !== null && value !== undefined,
+    }));
+    return {
+        schemaId: 0,
+        fields,
+    };
+}
+/**
+ * Infer Iceberg type from JavaScript value
+ */
+function inferIcebergType(value) {
+    if (value === null || value === undefined)
+        return 'string';
+    if (typeof value === 'string')
+        return 'string';
+    if (typeof value === 'number') {
+        return Number.isInteger(value) ? 'long' : 'double';
+    }
+    if (typeof value === 'boolean')
+        return 'boolean';
+    if (value instanceof Date)
+        return 'timestamp';
+    if (Array.isArray(value))
+        return 'list';
+    if (typeof value === 'object')
+        return 'struct';
+    return 'binary';
+}
+//# sourceMappingURL=cold.js.map

package/dist/db/storage/cold.js.map

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