@dotdo/postgres 0.1.0

package/dist/playground/types.d.ts

@@ -0,0 +1,430 @@
+/**
+ * Playground Types
+ *
+ * Type definitions for the interactive SQL playground.
+ * These types define the expected interfaces for the GREEN phase implementation.
+ *
+ * @module playground/types
+ */
+/**
+ * Options for executing a SQL query in the playground
+ */
+export interface PlaygroundQueryOptions {
+    /** The SQL query to execute */
+    sql: string;
+    /** Optional query parameters */
+    params?: unknown[] | undefined;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number | undefined;
+    /** Whether to include execution plan (EXPLAIN) */
+    explain?: boolean | undefined;
+}
+/**
+ * Field metadata from query result
+ */
+export interface QueryResultField {
+    /** Column name */
+    name: string;
+    /** PostgreSQL data type OID */
+    dataTypeID: number;
+    /** Data type name (e.g., 'text', 'integer', 'timestamp') */
+    dataTypeName?: string | undefined;
+    /** Column modifier (e.g., precision for numeric) */
+    modifier?: number | undefined;
+    /** Table OID if the field belongs to a table */
+    tableID?: number | undefined;
+    /** Column position in the table */
+    columnID?: number | undefined;
+}
+/**
+ * Result of a single query execution
+ */
+export interface PlaygroundQueryResult<T = Record<string, unknown>> {
+    /** Array of result rows */
+    rows: T[];
+    /** Field metadata */
+    fields: QueryResultField[];
+    /** Number of rows affected (for INSERT/UPDATE/DELETE) */
+    rowCount: number | null;
+    /** Command type (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) */
+    command: string;
+    /** Query execution time in milliseconds */
+    durationMs: number;
+    /** Whether the query was successful */
+    success: true;
+    /** Optional execution plan if explain was requested */
+    plan?: QueryExecutionPlan | undefined;
+}
+/**
+ * Error result from a failed query execution
+ */
+export interface PlaygroundQueryError {
+    /** Error message */
+    message: string;
+    /** PostgreSQL error code (e.g., '42P01' for undefined table) */
+    code?: string | undefined;
+    /** Line number where error occurred (if applicable) */
+    line?: number | undefined;
+    /** Column position where error occurred (if applicable) */
+    position?: number | undefined;
+    /** Detailed error context */
+    detail?: string | undefined;
+    /** Hint for fixing the error */
+    hint?: string | undefined;
+    /** Query execution time until error */
+    durationMs: number;
+    /** Whether the query was successful */
+    success: false;
+}
+/**
+ * Union type for query execution result
+ */
+export type PlaygroundExecutionResult<T = Record<string, unknown>> = PlaygroundQueryResult<T> | PlaygroundQueryError;
+/**
+ * Execution plan node from EXPLAIN
+ */
+export interface QueryExecutionPlan {
+    /** Plan node type (e.g., 'Seq Scan', 'Index Scan') */
+    nodeType: string;
+    /** Estimated startup cost */
+    startupCost: number;
+    /** Estimated total cost */
+    totalCost: number;
+    /** Estimated number of rows */
+    planRows: number;
+    /** Estimated average row width */
+    planWidth: number;
+    /** Child plan nodes */
+    plans?: QueryExecutionPlan[] | undefined;
+    /** Additional plan properties */
+    [key: string]: unknown;
+}
+/**
+ * Display format for query results
+ */
+export type ResultDisplayFormat = 'table' | 'json' | 'csv' | 'raw';
+/**
+ * Column display configuration
+ */
+export interface ColumnDisplayConfig {
+    /** Column name */
+    name: string;
+    /** Display label (can differ from name) */
+    label?: string | undefined;
+    /** Column width in pixels or 'auto' */
+    width?: number | 'auto' | undefined;
+    /** Whether column is sortable */
+    sortable?: boolean | undefined;
+    /** Whether column is visible */
+    visible?: boolean | undefined;
+    /** Custom formatter function name */
+    formatter?: string | undefined;
+    /** Text alignment */
+    align?: 'left' | 'center' | 'right' | undefined;
+}
+/**
+ * Table display options
+ */
+export interface TableDisplayOptions {
+    /** Column configurations */
+    columns?: ColumnDisplayConfig[] | undefined;
+    /** Current sort column */
+    sortColumn?: string | undefined;
+    /** Sort direction */
+    sortDirection?: 'asc' | 'desc' | undefined;
+    /** Page size for pagination */
+    pageSize?: number | undefined;
+    /** Current page (0-indexed) */
+    currentPage?: number | undefined;
+    /** Whether to show row numbers */
+    showRowNumbers?: boolean | undefined;
+    /** Whether to enable column resizing */
+    resizable?: boolean | undefined;
+    /** Maximum cell content length before truncation */
+    maxCellLength?: number | undefined;
+}
+/**
+ * Formatted result ready for display
+ */
+export interface FormattedResult {
+    /** Display format */
+    format: ResultDisplayFormat;
+    /** Formatted data (depends on format) */
+    data: string | unknown[][];
+    /** Column headers */
+    headers: string[];
+    /** Total row count (may differ from displayed rows due to pagination) */
+    totalRows: number;
+    /** Execution duration display string */
+    durationDisplay: string;
+    /** Command summary (e.g., "SELECT 5 rows") */
+    commandSummary: string;
+}
+/**
+ * Database table information
+ */
+export interface TableInfo {
+    /** Table name */
+    name: string;
+    /** Schema name (e.g., 'public') */
+    schema: string;
+    /** Table type: 'table', 'view', 'materialized_view' */
+    type: 'table' | 'view' | 'materialized_view';
+    /** Estimated row count */
+    estimatedRowCount?: number | undefined;
+    /** Table size in bytes */
+    sizeBytes?: number | undefined;
+    /** Human-readable size (e.g., '1.2 MB') */
+    sizeDisplay?: string | undefined;
+    /** Table description/comment */
+    description?: string | undefined;
+}
+/**
+ * Column information for a table
+ */
+export interface ColumnInfo {
+    /** Column name */
+    name: string;
+    /** Data type (e.g., 'integer', 'text', 'timestamp with time zone') */
+    dataType: string;
+    /** Whether the column can be NULL */
+    nullable: boolean;
+    /** Default value expression */
+    defaultValue?: string | undefined;
+    /** Whether this column is part of the primary key */
+    isPrimaryKey: boolean;
+    /** Whether this column has a UNIQUE constraint */
+    isUnique: boolean;
+    /** Foreign key reference if applicable */
+    foreignKey?: {
+        table: string;
+        column: string;
+    } | undefined;
+    /** Column description/comment */
+    description?: string | undefined;
+    /** Column position (1-indexed) */
+    position: number;
+}
+/**
+ * Index information
+ */
+export interface IndexInfo {
+    /** Index name */
+    name: string;
+    /** Table name */
+    tableName: string;
+    /** Whether index is unique */
+    isUnique: boolean;
+    /** Whether index is primary key */
+    isPrimaryKey: boolean;
+    /** Index type (e.g., 'btree', 'gin', 'gist') */
+    indexType: string;
+    /** Columns included in the index */
+    columns: string[];
+    /** Index condition (for partial indexes) */
+    condition?: string | undefined;
+    /** Index size in bytes */
+    sizeBytes?: number | undefined;
+}
+/**
+ * Complete schema information for a table
+ */
+export interface TableSchema {
+    /** Table information */
+    table: TableInfo;
+    /** Column details */
+    columns: ColumnInfo[];
+    /** Index details */
+    indexes: IndexInfo[];
+    /** Foreign keys referencing this table */
+    referencedBy?: Array<{
+        table: string;
+        column: string;
+        constraintName: string;
+    }>;
+}
+/**
+ * Schema browser state
+ */
+export interface SchemaBrowserState {
+    /** List of all tables */
+    tables: TableInfo[];
+    /** Currently selected table (if any) */
+    selectedTable?: string;
+    /** Detailed schema for selected table */
+    tableSchema?: TableSchema;
+    /** Search/filter text */
+    searchFilter?: string;
+    /** Whether schema is loading */
+    loading: boolean;
+    /** Error if schema loading failed */
+    error?: string;
+}
+/**
+ * A single entry in query history
+ */
+export interface QueryHistoryEntry {
+    /** Unique identifier */
+    id: string;
+    /** The SQL query */
+    sql: string;
+    /** Timestamp when executed (ISO string) */
+    executedAt: string;
+    /** Execution duration in milliseconds */
+    durationMs: number;
+    /** Whether execution was successful */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Number of rows returned (for SELECT) */
+    rowCount?: number;
+    /** Command type */
+    command?: string;
+    /** Optional user-assigned label */
+    label?: string;
+    /** Whether entry is starred/favorited */
+    starred?: boolean;
+}
+/**
+ * Query history manager state
+ */
+export interface QueryHistoryState {
+    /** All history entries (most recent first) */
+    entries: QueryHistoryEntry[];
+    /** Maximum number of entries to keep */
+    maxEntries: number;
+    /** Search filter text */
+    searchFilter?: string;
+    /** Show only starred entries */
+    starredOnly?: boolean;
+    /** Show only successful queries */
+    successfulOnly?: boolean;
+}
+/**
+ * Options for adding a history entry
+ */
+export interface AddHistoryEntryOptions {
+    /** The SQL query */
+    sql: string;
+    /** Execution duration */
+    durationMs: number;
+    /** Whether successful */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Row count if applicable */
+    rowCount?: number;
+    /** Command type */
+    command?: string;
+}
+/**
+ * Complete playground state
+ */
+export interface PlaygroundState {
+    /** Current SQL in the editor */
+    editorContent: string;
+    /** Whether a query is currently executing */
+    isExecuting: boolean;
+    /** Most recent query result */
+    lastResult?: PlaygroundExecutionResult;
+    /** Result display settings */
+    displayOptions: TableDisplayOptions;
+    /** Current display format */
+    displayFormat: ResultDisplayFormat;
+    /** Schema browser state */
+    schemaBrowser: SchemaBrowserState;
+    /** Query history state */
+    queryHistory: QueryHistoryState;
+    /** Whether the playground is initialized */
+    initialized: boolean;
+    /** Initialization error if any */
+    initError?: string;
+}
+/**
+ * Query executor interface
+ */
+export interface IQueryExecutor {
+    /** Execute a SQL query */
+    execute<T = Record<string, unknown>>(options: PlaygroundQueryOptions): Promise<PlaygroundExecutionResult<T>>;
+    /** Execute multiple queries in sequence */
+    executeMultiple(queries: string[]): Promise<PlaygroundExecutionResult[]>;
+    /** Cancel the current query (if supported) */
+    cancel(): Promise<boolean>;
+    /** Check if executor is ready */
+    isReady(): boolean;
+}
+/**
+ * Result formatter interface
+ */
+export interface IResultFormatter {
+    /** Format result for display */
+    format(result: PlaygroundQueryResult, options: TableDisplayOptions): FormattedResult;
+    /** Export result to specified format */
+    export(result: PlaygroundQueryResult, format: 'csv' | 'json'): string;
+    /** Format a value for display */
+    formatValue(value: unknown, dataType?: string): string;
+}
+/**
+ * Schema explorer interface
+ */
+export interface ISchemaExplorer {
+    /** Get list of all tables */
+    getTables(): Promise<TableInfo[]>;
+    /** Get detailed schema for a table */
+    getTableSchema(tableName: string, schema?: string): Promise<TableSchema>;
+    /** Get column completions for editor */
+    getCompletions(tableName?: string): Promise<string[]>;
+    /** Refresh schema cache */
+    refresh(): Promise<void>;
+}
+/**
+ * Query history manager interface
+ */
+export interface IQueryHistoryManager {
+    /** Add a new entry to history */
+    add(options: AddHistoryEntryOptions): QueryHistoryEntry;
+    /** Get all history entries */
+    getAll(): QueryHistoryEntry[];
+    /** Search history by SQL content */
+    search(query: string): QueryHistoryEntry[];
+    /** Get a specific entry by ID */
+    get(id: string): QueryHistoryEntry | undefined;
+    /** Delete an entry */
+    delete(id: string): boolean;
+    /** Toggle starred status */
+    toggleStar(id: string): boolean;
+    /** Clear all history */
+    clear(): void;
+    /** Update entry label */
+    setLabel(id: string, label: string): boolean;
+    /** Export history to JSON */
+    export(): string;
+    /** Import history from JSON */
+    import(json: string): number;
+}
+/**
+ * Main playground service interface
+ */
+export interface IPlayground {
+    /** Initialize the playground */
+    initialize(): Promise<void>;
+    /** Execute a query */
+    executeQuery<T = Record<string, unknown>>(sql: string, options?: Partial<PlaygroundQueryOptions>): Promise<PlaygroundExecutionResult<T>>;
+    /** Get the query executor */
+    getExecutor(): IQueryExecutor;
+    /** Get the result formatter */
+    getFormatter(): IResultFormatter;
+    /** Get the schema explorer */
+    getSchemaExplorer(): ISchemaExplorer;
+    /** Get the query history manager */
+    getHistoryManager(): IQueryHistoryManager;
+    /** Get current state */
+    getState(): PlaygroundState;
+    /** Reset the playground (clear database) */
+    reset(): Promise<void>;
+    /** Load sample data */
+    loadSampleData(): Promise<void>;
+    /** Dispose of resources */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/playground/types.d.ts.map

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

package/dist/playground/types.js

@@ -0,0 +1,10 @@
+/**
+ * Playground Types
+ *
+ * Type definitions for the interactive SQL playground.
+ * These types define the expected interfaces for the GREEN phase implementation.
+ *
+ * @module playground/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/playground/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/playground/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/readonly/cache-reader.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Cache-First Read Path
+ *
+ * Reads from Cloudflare Cache first, falls back to R2.
+ * Cache is FREE on Cloudflare! This is a cost-saving feature.
+ */
+import type { CacheConfig, R2Config } from './config';
+/**
+ * Result of a cache read operation
+ */
+export interface CacheResult {
+    /** The file data */
+    data: ArrayBuffer;
+    /** Where the data came from */
+    source: 'cache' | 'r2';
+}
+/**
+ * Result with metadata
+ */
+export interface CacheResultWithMetadata extends CacheResult {
+    /** File size in bytes */
+    size: number;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+    /** ETag for cache validation */
+    etag?: string;
+}
+/**
+ * Cache statistics
+ */
+export interface CacheStats {
+    /** Number of cache hits */
+    cacheHits: number;
+    /** Number of cache misses */
+    cacheMisses: number;
+    /** Cache hit ratio (0-1) */
+    hitRatio: number;
+}
+/**
+ * Minimal R2 bucket interface
+ */
+export interface R2BucketInterface {
+    get(key: string): Promise<R2ObjectInterface | null>;
+    head(key: string): Promise<R2HeadObjectInterface | null>;
+}
+/**
+ * Minimal R2 object interface
+ */
+export interface R2ObjectInterface {
+    body: ReadableStream;
+    bodyUsed: boolean;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    text(): Promise<string>;
+    json<T = unknown>(): Promise<T>;
+    customMetadata?: Record<string, string>;
+    size: number;
+    etag: string;
+}
+/**
+ * Minimal R2 head object interface
+ */
+export interface R2HeadObjectInterface {
+    key: string;
+    size: number;
+    etag?: string;
+}
+/**
+ * Minimal Cache interface
+ */
+export interface CacheInterface {
+    match(request: string | Request): Promise<Response | undefined>;
+    put(request: string | Request, response: Response): Promise<void>;
+    delete?(request: string | Request): Promise<boolean>;
+}
+/**
+ * Cache-first reader for database files.
+ *
+ * Reads from Cloudflare Cache (FREE!) first, falls back to R2.
+ */
+export declare class CacheReader {
+    private readonly r2;
+    private readonly cache;
+    private readonly r2Config;
+    private readonly cacheConfig;
+    private stats;
+    constructor(r2: R2BucketInterface, cache: CacheInterface, r2Config: R2Config, cacheConfig?: Partial<CacheConfig>);
+    /**
+     * Build the R2 key from a file path
+     */
+    private buildR2Key;
+    /**
+     * Build the cache key from a file path
+     */
+    private buildCacheKey;
+    /**
+     * Build Cache-Control header based on config
+     */
+    private buildCacheControl;
+    /**
+     * Read a file, checking cache first then R2.
+     *
+     * @param path - The file path relative to R2 prefix
+     * @returns The cache result or null if not found
+     */
+    read(path: string): Promise<CacheResult | null>;
+    /**
+     * Read a file with metadata.
+     *
+     * @param path - The file path relative to R2 prefix
+     * @returns The cache result with metadata or null if not found
+     */
+    readWithMetadata(path: string): Promise<CacheResultWithMetadata | null>;
+    /**
+     * Check if a file exists.
+     *
+     * @param path - The file path relative to R2 prefix
+     * @returns true if the file exists
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Invalidate a cached file.
+     *
+     * @param path - The file path relative to R2 prefix
+     */
+    invalidate(path: string): Promise<void>;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): CacheStats;
+    /**
+     * Reset cache statistics.
+     */
+    resetStats(): void;
+}
+/**
+ * Create a cache reader.
+ *
+ * @param r2 - R2 bucket
+ * @param cache - Cloudflare Cache
+ * @param r2Config - R2 configuration
+ * @param cacheConfig - Cache configuration (optional)
+ * @returns A cache reader instance
+ */
+export declare function createCacheReader(r2: R2BucketInterface, cache: CacheInterface, r2Config: R2Config, cacheConfig?: Partial<CacheConfig>): CacheReader;
+//# sourceMappingURL=cache-reader.d.ts.map

package/dist/readonly/cache-reader.d.ts.map

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