duckpond 0.3.0 → 0.4.1

package/dist/types.d.mts

@@ -1,194 +0,0 @@
-import { DuckDBConnection } from '@duckdb/node-api';
-import { Either } from 'functype/either';
-import { List } from 'functype/list';
-
-/**
- * Configuration for DuckPond manager
- */
-interface DuckPondConfig {
-    r2?: {
-        accountId: string;
-        accessKeyId: string;
-        secretAccessKey: string;
-        bucket: string;
-    };
-    s3?: {
-        region: string;
-        accessKeyId: string;
-        secretAccessKey: string;
-        bucket: string;
-        endpoint?: string;
-    };
-    memoryLimit?: string;
-    threads?: number;
-    tempDir?: string;
-    dataDir?: string;
-    maxActiveUsers?: number;
-    evictionTimeout?: number;
-    cacheType?: "disk" | "memory" | "noop";
-    cacheDir?: string;
-    strategy?: "parquet" | "duckdb" | "hybrid";
-}
-/**
- * Represents an active user database connection
- */
-interface UserDatabase {
-    userId: string;
-    connection: DuckDBConnection;
-    lastAccess: Date;
-    attached: boolean;
-    memoryUsage?: number;
-}
-/**
- * Statistics about a user's database
- */
-interface UserStats {
-    userId: string;
-    attached: boolean;
-    lastAccess: Date;
-    memoryUsage: number;
-    storageUsage: number;
-    queryCount: number;
-}
-/**
- * Database schema information
- */
-interface Schema {
-    tables: TableSchema[];
-}
-interface TableSchema {
-    name: string;
-    columns: ColumnSchema[];
-    rowCount?: number;
-}
-interface ColumnSchema {
-    name: string;
-    type: string;
-    nullable: boolean;
-}
-/**
- * Options for creating a new user
- */
-interface CreateUserOptions {
-    template?: string;
-    initialData?: Record<string, unknown[]>;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Storage usage statistics
- */
-interface StorageStats {
-    totalSize: number;
-    fileCount: number;
-    lastModified: Date;
-    files?: FileInfo[];
-}
-interface FileInfo {
-    path: string;
-    size: number;
-    modified: Date;
-}
-/**
- * Query result with metadata
- */
-interface QueryResult<T = unknown> {
-    rows: T[];
-    rowCount: number;
-    executionTime: number;
-    columns: string[];
-}
-/**
- * Metrics for monitoring
- */
-interface DuckPondMetrics {
-    activeUsers: number;
-    totalQueries: number;
-    avgQueryTime: number;
-    cacheHitRate: number;
-    memoryUsage: number;
-    storageUsage: number;
-}
-/**
- * Events emitted by DuckPond
- */
-type DuckPondEvent = {
-    type: "user:attached";
-    userId: string;
-    timestamp: Date;
-} | {
-    type: "user:detached";
-    userId: string;
-    reason: "eviction" | "manual";
-    timestamp: Date;
-} | {
-    type: "query:executed";
-    userId: string;
-    duration: number;
-    timestamp: Date;
-} | {
-    type: "query:failed";
-    userId: string;
-    error: string;
-    timestamp: Date;
-} | {
-    type: "cache:hit";
-    userId: string;
-} | {
-    type: "cache:miss";
-    userId: string;
-} | {
-    type: "error";
-    error: Error;
-    timestamp: Date;
-};
-/**
- * Type-safe result types using functype Either
- */
-type DuckPondResult<T> = Either<DuckPondError, T>;
-type AsyncDuckPondResult<T> = Promise<Either<DuckPondError, T>>;
-/**
- * Error types
- */
-interface DuckPondError {
-    code: ErrorCode;
-    message: string;
-    cause?: Error;
-    context?: Record<string, unknown>;
-}
-declare enum ErrorCode {
-    CONNECTION_FAILED = "CONNECTION_FAILED",
-    CONNECTION_TIMEOUT = "CONNECTION_TIMEOUT",
-    R2_CONNECTION_ERROR = "R2_CONNECTION_ERROR",
-    S3_CONNECTION_ERROR = "S3_CONNECTION_ERROR",
-    USER_NOT_FOUND = "USER_NOT_FOUND",
-    USER_ALREADY_EXISTS = "USER_ALREADY_EXISTS",
-    USER_NOT_ATTACHED = "USER_NOT_ATTACHED",
-    QUERY_EXECUTION_ERROR = "QUERY_EXECUTION_ERROR",
-    QUERY_TIMEOUT = "QUERY_TIMEOUT",
-    INVALID_SQL = "INVALID_SQL",
-    MEMORY_LIMIT_EXCEEDED = "MEMORY_LIMIT_EXCEEDED",
-    STORAGE_ERROR = "STORAGE_ERROR",
-    STORAGE_QUOTA_EXCEEDED = "STORAGE_QUOTA_EXCEEDED",
-    INVALID_CONFIG = "INVALID_CONFIG",
-    NOT_INITIALIZED = "NOT_INITIALIZED",
-    UNKNOWN_ERROR = "UNKNOWN_ERROR"
-}
-/**
- * Configuration with defaults applied
- */
-type ResolvedConfig = Required<Omit<DuckPondConfig, "r2" | "s3" | "dataDir"> & {
-    r2: DuckPondConfig["r2"];
-    s3: DuckPondConfig["s3"];
-    dataDir: DuckPondConfig["dataDir"];
-}>;
-/**
- * Result of listUsers operation
- */
-interface ListUsersResult {
-    users: List<string>;
-    count: number;
-    maxActiveUsers: number;
-    utilizationPercent: number;
-}
-
-export { type AsyncDuckPondResult, type ColumnSchema, type CreateUserOptions, type DuckPondConfig, type DuckPondError, type DuckPondEvent, type DuckPondMetrics, type DuckPondResult, ErrorCode, type FileInfo, type ListUsersResult, type QueryResult, type ResolvedConfig, type Schema, type StorageStats, type TableSchema, type UserDatabase, type UserStats };

package/dist/types.mjs

@@ -1,2 +0,0 @@
-import{a}from"./chunk-GXQJHTJW.mjs";import"./chunk-V57JCP3U.mjs";export{a as ErrorCode};
-//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/errors.d.mts

@@ -1,41 +0,0 @@
-import { Either } from 'functype';
-import { ErrorCode, DuckPondError } from '../types.mjs';
-import '@duckdb/node-api';
-import 'functype/either';
-import 'functype/list';
-
-/**
- * Create a DuckPondError as a Left Either
- */
-declare function createError(code: ErrorCode, message: string, cause?: Error, context?: Record<string, unknown>): Either<DuckPondError, never>;
-/**
- * Wrap a value in a Right Either
- */
-declare function success<T = void>(value?: T): Either<DuckPondError, T extends void ? void : T>;
-/**
- * Convert an unknown error to a DuckPondError
- */
-declare function toDuckPondError(error: unknown, defaultCode?: ErrorCode): DuckPondError;
-/**
- * Error factory functions for common errors
- */
-declare const Errors: {
-    connectionFailed: (message: string, cause?: Error) => Either<DuckPondError, never>;
-    r2ConnectionError: (message: string, cause?: Error) => Either<DuckPondError, never>;
-    s3ConnectionError: (message: string, cause?: Error) => Either<DuckPondError, never>;
-    userNotFound: (userId: string) => Either<DuckPondError, never>;
-    userAlreadyExists: (userId: string) => Either<DuckPondError, never>;
-    userNotAttached: (userId: string) => Either<DuckPondError, never>;
-    queryExecutionError: (message: string, sql?: string, cause?: Error) => Either<DuckPondError, never>;
-    queryTimeout: (timeoutMs: number) => Either<DuckPondError, never>;
-    memoryLimitExceeded: (limit: string) => Either<DuckPondError, never>;
-    storageError: (message: string, cause?: Error) => Either<DuckPondError, never>;
-    invalidConfig: (message: string) => Either<DuckPondError, never>;
-    notInitialized: () => Either<DuckPondError, never>;
-};
-/**
- * Format an error for logging
- */
-declare function formatError(error: DuckPondError): string;
-
-export { Errors, createError, formatError, success, toDuckPondError };

package/dist/utils/errors.mjs

@@ -1,2 +0,0 @@
-import{a,b,c,d,e}from"../chunk-PCQEPXO3.mjs";import"../chunk-GXQJHTJW.mjs";import"../chunk-V57JCP3U.mjs";export{d as Errors,a as createError,e as formatError,b as success,c as toDuckPondError};
-//# sourceMappingURL=errors.mjs.map

package/dist/utils/errors.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/utils/logger.d.mts

@@ -1,25 +0,0 @@
-import debug from 'debug';
-
-/**
- * Create a namespaced logger for DuckPond
- *
- * Usage:
- *   const log = createLogger('DuckPond')
- *   log('Initializing...')
- *
- * Enable with: DEBUG=duckpond:* node app.js
- */
-declare function createLogger(namespace: string): debug.Debugger;
-/**
- * Pre-configured loggers for different modules
- */
-declare const loggers: {
-    main: debug.Debugger;
-    cache: debug.Debugger;
-    connection: debug.Debugger;
-    query: debug.Debugger;
-    storage: debug.Debugger;
-    metrics: debug.Debugger;
-};
-
-export { createLogger, loggers };

package/dist/utils/logger.mjs

@@ -1,2 +0,0 @@
-import{a,b}from"../chunk-SZJXSB7U.mjs";import"../chunk-V57JCP3U.mjs";export{a as createLogger,b as loggers};
-//# sourceMappingURL=logger.mjs.map

package/dist/utils/logger.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}