@zudojs/storage 0.0.1

package/README.md

@@ -0,0 +1,38 @@
+# @zudojs/storage
+
+Storage abstractions including database, object storage, repository, serialization, locking, and lifecycle.
+
+## Installation
+
+```bash
+npm install @zudojs/storage
+```
+
+## Quick Start
+
+```typescript
+import { createStorage } from "@zudojs/storage";
+
+const storage = createStorage({
+  database: { url: process.env.DATABASE_URL },
+  cache: { driver: "memory" },
+});
+
+const user = await storage.db.user.findUnique({ where: { id } });
+```
+
+## Features
+
+- Unified storage abstraction
+- Database client management
+- Object storage (S3, local filesystem)
+- Repository pattern
+- Serialization support
+- Distributed locking
+
+## Use Cases
+
+- Unified data access layer
+- File and object storage
+- Cache integration
+- Locking for distributed systems

package/dist/database/connectionPool.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionPool.core.d.ts","sourceRoot":"","sources":["../../src/database/connectionPool.core.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,SAAS,EACV,MAAM,0BAA0B,CAAC;AAYlC,qBAAa,cAAc;IAavB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAZ1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAIlB;IACR,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,MAAM,CAAS;IAEvB,YACmB,OAAO,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,EACnD,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,EAGzC;IAED,oDAAoD;IAC9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAMhC;IAED,0CAA0C;IACpC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAwBnC;IAED,6CAA6C;IACvC,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBnD;IAED,qDAAqD;IAC/C,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO7D;IAED,2BAA2B;IAC3B,QAAQ,IAAI,SAAS,CAOpB;IAED,wCAAwC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAwB3B;IAED,oCAAoC;IAC9B,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAkBnE;YAEa,gBAAgB;YAMhB,iBAAiB;YAQjB,SAAS;IAQvB,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/database/connectionPool.core.js

@@ -0,0 +1,166 @@
+/**
+ * Connection pool that manages database connections with backpressure.
+ */
+import { StorageError } from "@zudojs/errors";
+/** Default pool options. */
+const DEFAULT_POOL_OPTIONS = {
+    min: 2,
+    max: 10,
+    acquireTimeout: 30_000,
+    idleTimeout: 30_000,
+    connectionTimeout: 10_000,
+    maxLifetime: 0,
+};
+export class ConnectionPool {
+    factory;
+    options;
+    available = [];
+    inUse = new Set();
+    waitQueue = [];
+    connectionIdCounter = 0;
+    closed = false;
+    constructor(factory, options) {
+        this.factory = factory;
+        this.options = { ...DEFAULT_POOL_OPTIONS, ...options };
+    }
+    /** Initialize the pool with minimum connections. */
+    async initialize() {
+        const initial = Math.min(this.options.min, this.options.max);
+        for (let i = 0; i < initial; i++) {
+            const conn = await this.createConnection();
+            this.available.push(conn);
+        }
+    }
+    /** Acquire a connection from the pool. */
+    async acquire() {
+        if (this.closed) {
+            throw new StorageError("Pool is closed", {
+                code: "STORAGE_CONNECTION_POOL_CLOSED",
+                statusCode: 503,
+            });
+        }
+        while (this.available.length > 0) {
+            const conn = this.available.pop();
+            if (await this.isConnectionAlive(conn)) {
+                this.inUse.add(conn);
+                return conn;
+            }
+            await this.safeClose(conn);
+        }
+        if (this.inUse.size < this.options.max) {
+            const conn = await this.createConnection();
+            this.inUse.add(conn);
+            return conn;
+        }
+        return this.waitForConnection();
+    }
+    /** Release a connection back to the pool. */
+    async release(connection) {
+        this.inUse.delete(connection);
+        if (this.closed) {
+            await this.safeClose(connection);
+            return;
+        }
+        if (this.waitQueue.length > 0) {
+            const waiter = this.waitQueue.shift();
+            clearTimeout(waiter.timer);
+            this.inUse.add(connection);
+            waiter.resolve(connection);
+            return;
+        }
+        this.available.push(connection);
+    }
+    /** Use a connection and automatically release it. */
+    async use(fn) {
+        const conn = await this.acquire();
+        try {
+            return await fn(conn);
+        }
+        finally {
+            await this.release(conn);
+        }
+    }
+    /** Get pool statistics. */
+    getStats() {
+        return {
+            total: this.available.length + this.inUse.size,
+            idle: this.available.length,
+            active: this.inUse.size,
+            waiting: this.waitQueue.length,
+        };
+    }
+    /** Drain all connections gracefully. */
+    async drain() {
+        this.closed = true;
+        for (const waiter of this.waitQueue) {
+            clearTimeout(waiter.timer);
+            waiter.reject(new Error("Pool is draining"));
+        }
+        this.waitQueue.length = 0;
+        while (this.available.length > 0) {
+            const conn = this.available.pop();
+            await this.safeClose(conn);
+        }
+        const drainTimeout = 30_000;
+        const start = Date.now();
+        while (this.inUse.size > 0 && Date.now() - start < drainTimeout) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        for (const conn of this.inUse) {
+            await this.safeClose(conn);
+        }
+        this.inUse.clear();
+    }
+    /** Check if the pool is healthy. */
+    async healthCheck() {
+        const stats = this.getStats();
+        if (this.available.length === 0 && this.inUse.size === 0) {
+            try {
+                const conn = await this.createConnection();
+                this.available.push(conn);
+                return { healthy: true, stats: this.getStats() };
+            }
+            catch {
+                return { healthy: false, stats };
+            }
+        }
+        for (const conn of this.available) {
+            if (await this.isConnectionAlive(conn))
+                return { healthy: true, stats };
+        }
+        return { healthy: this.inUse.size > 0, stats };
+    }
+    async createConnection() {
+        const conn = await this.factory();
+        this.connectionIdCounter++;
+        return conn;
+    }
+    async isConnectionAlive(conn) {
+        try {
+            return await conn.ping();
+        }
+        catch {
+            return false;
+        }
+    }
+    async safeClose(conn) {
+        try {
+            await conn.close();
+        }
+        catch {
+            /* Ignore close errors */
+        }
+    }
+    waitForConnection() {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                const idx = this.waitQueue.findIndex((w) => w.resolve === resolve);
+                if (idx !== -1)
+                    this.waitQueue.splice(idx, 1);
+                reject(new Error("Acquire timeout: no connection available"));
+            }, this.options.acquireTimeout);
+            this.waitQueue.push({ resolve, reject, timer });
+        });
+    }
+}
+//# sourceMappingURL=connectionPool.core.js.map

package/dist/database/connectionPool.core.js.map

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

package/dist/database/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @zudojs/storage — Database Barrel
+ */
+export { ConnectionPool } from "./connectionPool.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/database/index.js

@@ -0,0 +1,5 @@
+/**
+ * @zudojs/storage — Database Barrel
+ */
+export { ConnectionPool } from "./connectionPool.core.js";
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/health/healthChecker.core.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @zudojs/storage — Health Checker
+ *
+ * Aggregates health checks from multiple storage components.
+ */
+import type { StorageHealth, StorageLifecycle } from "../types/storage.type.js";
+/**
+ * Result of checking multiple storage components.
+ */
+export interface StorageHealthReport {
+    /** Overall health status. */
+    readonly healthy: boolean;
+    /** Individual component health results. */
+    readonly components: readonly ComponentHealth[];
+    /** Total check duration in milliseconds. */
+    readonly durationMs: number;
+}
+/**
+ * Health result for a single component.
+ */
+export interface ComponentHealth {
+    /** Component name. */
+    readonly name: string;
+    /** Health status. */
+    readonly health: StorageHealth;
+}
+/**
+ * Aggregates health checks from multiple storage components.
+ */
+export declare class HealthChecker {
+    private readonly components;
+    /**
+     * Register a component for health checking.
+     */
+    register(name: string, component: StorageLifecycle): void;
+    /**
+     * Remove a component from health checking.
+     */
+    unregister(name: string): void;
+    /**
+     * Check health of all registered components.
+     */
+    checkAll(): Promise<StorageHealthReport>;
+    /**
+     * Check health of a single component.
+     */
+    checkOne(name: string): Promise<StorageHealth | null>;
+    /**
+     * Get names of all registered components.
+     */
+    getRegisteredComponents(): readonly string[];
+}
+//# sourceMappingURL=healthChecker.core.d.ts.map

package/dist/health/healthChecker.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthChecker.core.d.ts","sourceRoot":"","sources":["../../src/health/healthChecker.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAElE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAExD;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7B;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAkC7C;IAED;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgB1D;IAED;;OAEG;IACH,uBAAuB,IAAI,SAAS,MAAM,EAAE,CAE3C;CACF"}

package/dist/health/healthChecker.core.js

@@ -0,0 +1,84 @@
+/**
+ * @zudojs/storage — Health Checker
+ *
+ * Aggregates health checks from multiple storage components.
+ */
+/**
+ * Aggregates health checks from multiple storage components.
+ */
+export class HealthChecker {
+    components = new Map();
+    /**
+     * Register a component for health checking.
+     */
+    register(name, component) {
+        this.components.set(name, component);
+    }
+    /**
+     * Remove a component from health checking.
+     */
+    unregister(name) {
+        this.components.delete(name);
+    }
+    /**
+     * Check health of all registered components.
+     */
+    async checkAll() {
+        const start = Date.now();
+        const results = [];
+        const checks = Array.from(this.components.entries()).map(async ([name, component]) => {
+            try {
+                const health = await component.healthCheck();
+                results.push({ name, health });
+            }
+            catch (error) {
+                results.push({
+                    name,
+                    health: {
+                        healthy: false,
+                        latencyMs: 0,
+                        status: "error",
+                        details: {
+                            error: error instanceof Error ? error.message : "Unknown error",
+                        },
+                    },
+                });
+            }
+        });
+        await Promise.allSettled(checks);
+        const healthy = results.every((r) => r.health.healthy);
+        return {
+            healthy,
+            components: results,
+            durationMs: Date.now() - start,
+        };
+    }
+    /**
+     * Check health of a single component.
+     */
+    async checkOne(name) {
+        const component = this.components.get(name);
+        if (!component)
+            return null;
+        try {
+            return await component.healthCheck();
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                latencyMs: 0,
+                status: "error",
+                details: {
+                    error: error instanceof Error ? error.message : "Unknown error",
+                },
+            };
+        }
+    }
+    /**
+     * Get names of all registered components.
+     */
+    getRegisteredComponents() {
+        return Array.from(this.components.keys());
+    }
+}
+//# sourceMappingURL=healthChecker.core.js.map

package/dist/health/healthChecker.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthChecker.core.js","sourceRoot":"","sources":["../../src/health/healthChecker.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH;;GAEG;AACH,MAAM,OAAO,aAAa;IACP,UAAU,GAAG,IAAI,GAAG,EAA4B,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,IAAY,EAAE,SAA2B;QAChD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,OAAO,GAAsB,EAAE,CAAC;QAEtC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CACtD,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE;YAC1B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC;gBAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,MAAM,EAAE;wBACN,OAAO,EAAE,KAAK;wBACd,SAAS,EAAE,CAAC;wBACZ,MAAM,EAAE,OAAO;wBACf,OAAO,EAAE;4BACP,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;yBAChE;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CACF,CAAC;QAEF,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAEjC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO;YACP,UAAU,EAAE,OAAO;YACnB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAE5B,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,CAAC;gBACZ,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE;oBACP,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;iBAChE;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/health/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @zudojs/storage — Health Barrel
+ */
+export { HealthChecker } from "./healthChecker.core.js";
+export type { StorageHealthReport, ComponentHealth, } from "./healthChecker.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EACV,mBAAmB,EACnB,eAAe,GAChB,MAAM,yBAAyB,CAAC"}

package/dist/health/index.js

@@ -0,0 +1,5 @@
+/**
+ * @zudojs/storage — Health Barrel
+ */
+export { HealthChecker } from "./healthChecker.core.js";
+//# sourceMappingURL=index.js.map

package/dist/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/health/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @zudojs/storage
+ *
+ * Storage infrastructure for the Zudojs framework.
+ *
+ * Provides database, object storage, repository, serialization, locking,
+ * and lifecycle abstractions with driver-independent interfaces.
+ *
+ * @example
+ * ```ts
+ * import { Database, ConnectionPool, BaseRepository } from '@zudojs/storage';
+ *
+ * // Use database abstraction
+ * const result = await database.query({ text: 'SELECT * FROM users' });
+ *
+ * // Use repository pattern
+ * class UserRepository extends BaseRepository<User, string> {
+ *   async findByEmail(email: string) {
+ *     return this.database.query({
+ *       text: 'SELECT * FROM users WHERE email = $1',
+ *       parameters: [email],
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { ConnectionState, TransactionState, IsolationLevel, QueryParameter, Query, QueryResult, ExecuteResult, FieldInfo, Connection, ConnectionPoolOptions, PoolStats, TransactionOptions, Transaction, StorageHealth, Database, ObjectPutOptions, ObjectMetadata, ObjectData, ObjectStorage, ListObjectsResult, Repository, SerializationFormat, Serializer, Lock, LockOptions, LockManager, StorageLifecyclePhase, StorageLifecycle, StorageContext, } from "./types/index.js";
+export { ConnectionPool } from "./database/index.js";
+export { BaseRepository } from "./repository/index.js";
+export type { BaseRepositoryOptions } from "./repository/index.js";
+export { LocalObjectStorage } from "./objectStorage/index.js";
+export { JsonSerializer } from "./serialization/index.js";
+export { InMemoryLockManager } from "./locking/index.js";
+export { StorageLifecycleManager } from "./lifecycle/index.js";
+export { HealthChecker } from "./health/index.js";
+export type { StorageHealthReport, ComponentHealth } from "./health/index.js";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,KAAK,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,IAAI,EACJ,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * @zudojs/storage
+ *
+ * Storage infrastructure for the Zudojs framework.
+ *
+ * Provides database, object storage, repository, serialization, locking,
+ * and lifecycle abstractions with driver-independent interfaces.
+ *
+ * @example
+ * ```ts
+ * import { Database, ConnectionPool, BaseRepository } from '@zudojs/storage';
+ *
+ * // Use database abstraction
+ * const result = await database.query({ text: 'SELECT * FROM users' });
+ *
+ * // Use repository pattern
+ * class UserRepository extends BaseRepository<User, string> {
+ *   async findByEmail(email: string) {
+ *     return this.database.query({
+ *       text: 'SELECT * FROM users WHERE email = $1',
+ *       parameters: [email],
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ConnectionPool } from "./database/index.js";
+export { BaseRepository } from "./repository/index.js";
+export { LocalObjectStorage } from "./objectStorage/index.js";
+export { JsonSerializer } from "./serialization/index.js";
+export { InMemoryLockManager } from "./locking/index.js";
+export { StorageLifecycleManager } from "./lifecycle/index.js";
+export { HealthChecker } from "./health/index.js";
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAmCH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @zudojs/storage — Lifecycle Barrel
+ */
+export { StorageLifecycleManager } from "./storageLifecycle.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/lifecycle/index.js

@@ -0,0 +1,5 @@
+/**
+ * @zudojs/storage — Lifecycle Barrel
+ */
+export { StorageLifecycleManager } from "./storageLifecycle.core.js";
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/lifecycle/storageLifecycle.core.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @zudojs/storage — Storage Lifecycle Manager
+ *
+ * Manages the lifecycle phases of storage components:
+ * uninitialized → initializing → ready → draining → drained → shutdown
+ */
+import type { StorageLifecycle, StorageLifecyclePhase, StorageHealth } from "../types/storage.type.js";
+/**
+ * Lifecycle manager that coordinates storage component initialization,
+ * draining, and shutdown.
+ */
+export declare class StorageLifecycleManager implements StorageLifecycle {
+    private phase;
+    private readonly components;
+    /**
+     * Register a storage component for lifecycle management.
+     */
+    register(component: StorageLifecycle): void;
+    initialize(): Promise<void>;
+    start(): Promise<void>;
+    healthCheck(): Promise<StorageHealth>;
+    drain(): Promise<void>;
+    shutdown(): Promise<void>;
+    getPhase(): StorageLifecyclePhase;
+}
+//# sourceMappingURL=storageLifecycle.core.d.ts.map

package/dist/lifecycle/storageLifecycle.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageLifecycle.core.d.ts","sourceRoot":"","sources":["../../src/lifecycle/storageLifecycle.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IAErD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAE1C;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAMhC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;IAEK,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAyB1C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3B;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAG9B;IAED,QAAQ,IAAI,qBAAqB,CAEhC;CACF"}

package/dist/lifecycle/storageLifecycle.core.js

@@ -0,0 +1,71 @@
+/**
+ * @zudojs/storage — Storage Lifecycle Manager
+ *
+ * Manages the lifecycle phases of storage components:
+ * uninitialized → initializing → ready → draining → drained → shutdown
+ */
+import { StorageError } from "@zudojs/errors";
+/**
+ * Lifecycle manager that coordinates storage component initialization,
+ * draining, and shutdown.
+ */
+export class StorageLifecycleManager {
+    phase = "uninitialized";
+    components = [];
+    /**
+     * Register a storage component for lifecycle management.
+     */
+    register(component) {
+        this.components.push(component);
+    }
+    async initialize() {
+        this.phase = "initializing";
+        for (const component of this.components) {
+            await component.initialize();
+        }
+        this.phase = "ready";
+    }
+    async start() {
+        if (this.phase !== "ready") {
+            throw new StorageError(`Cannot start from phase: ${this.phase}`, {
+                code: "STORAGE_LIFECYCLE_INVALID_PHASE",
+                statusCode: 500,
+            });
+        }
+        for (const component of this.components) {
+            await component.start();
+        }
+    }
+    async healthCheck() {
+        const results = await Promise.allSettled(this.components.map((c) => c.healthCheck()));
+        const healthy = results.every((r) => r.status === "fulfilled" && r.value.healthy);
+        const latencyMs = results.reduce((max, r) => {
+            if (r.status === "fulfilled") {
+                return Math.max(max, r.value.latencyMs);
+            }
+            return max;
+        }, 0);
+        return {
+            healthy,
+            latencyMs,
+            status: this.phase,
+            details: {
+                componentCount: this.components.length,
+                phases: this.components.map((c) => c.getPhase()),
+            },
+        };
+    }
+    async drain() {
+        this.phase = "draining";
+        await Promise.all(this.components.map((c) => c.drain()));
+        this.phase = "drained";
+    }
+    async shutdown() {
+        this.phase = "shutdown";
+        await Promise.all(this.components.map((c) => c.shutdown()));
+    }
+    getPhase() {
+        return this.phase;
+    }
+}
+//# sourceMappingURL=storageLifecycle.core.js.map

package/dist/lifecycle/storageLifecycle.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageLifecycle.core.js","sourceRoot":"","sources":["../../src/lifecycle/storageLifecycle.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAO9C;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAC1B,KAAK,GAA0B,eAAe,CAAC;IACtC,UAAU,GAAuB,EAAE,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,SAA2B;QAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC;QAC5B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,SAAS,CAAC,UAAU,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,YAAY,CAAC,4BAA4B,IAAI,CAAC,KAAK,EAAE,EAAE;gBAC/D,IAAI,EAAE,iCAAiC;gBACvC,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAC5C,CAAC;QAEF,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CACnD,CAAC;QAEF,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC1C,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,CAAC,CAAC,CAAC;QAEN,OAAO;YACL,OAAO;YACP,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,KAAK;YAClB,OAAO,EAAE;gBACP,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;gBACtC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;aACjD;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;QACxB,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;QACxB,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/locking/inMemoryLock.core.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @zudojs/storage — In-Memory Lock Manager
+ *
+ * Provides distributed-style locking for single-process scenarios.
+ * For multi-process/multi-node, replace with Redis/Database-backed lock.
+ */
+import type { Lock, LockManager, LockOptions } from "../types/storage.type.js";
+/**
+ * In-memory lock manager implementation.
+ */
+export declare class InMemoryLockManager implements LockManager {
+    private readonly locks;
+    private readonly waitQueues;
+    acquire(resource: string, options?: LockOptions): Promise<Lock>;
+    tryAcquire(resource: string, ttlMs: number): Promise<Lock | null>;
+    isLocked(resource: string): Promise<boolean>;
+    /**
+     * Clean up expired locks.
+     */
+    cleanup(): void;
+    /**
+     * Release all locks and clean up.
+     */
+    clear(): void;
+    private tryAcquireLock;
+    private notifyWaiters;
+}
+//# sourceMappingURL=inMemoryLock.core.d.ts.map