@zudojs/storage 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryLock.core.d.ts","sourceRoot":"","sources":["../../src/locking/inMemoryLock.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAgB/E;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAMvB;IAEE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBpE;IAEK,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAEtE;IAEK,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUjD;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAQd;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAQZ;IAED,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAC,aAAa;CAQtB"}

package/dist/locking/inMemoryLock.core.js

@@ -0,0 +1,120 @@
+/**
+ * @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 { randomBytes } from "node:crypto";
+import { StorageError } from "@zudojs/errors";
+/** Default lock options. */
+const DEFAULT_LOCK_OPTIONS = {
+    timeout: 10_000,
+    ttl: 30_000,
+    retryInterval: 100,
+};
+/**
+ * In-memory lock manager implementation.
+ */
+export class InMemoryLockManager {
+    locks = new Map();
+    waitQueues = new Map();
+    async acquire(resource, options) {
+        const opts = { ...DEFAULT_LOCK_OPTIONS, ...options };
+        const deadline = Date.now() + opts.timeout;
+        while (Date.now() < deadline) {
+            const lock = this.tryAcquireLock(resource, opts.ttl);
+            if (lock)
+                return lock;
+            // Wait before retrying
+            await new Promise((resolve) => setTimeout(resolve, opts.retryInterval));
+        }
+        throw new StorageError(`Failed to acquire lock on "${resource}" within ${opts.timeout}ms`, {
+            code: "STORAGE_LOCK_ACQUIRE_TIMEOUT",
+            statusCode: 504,
+        });
+    }
+    async tryAcquire(resource, ttlMs) {
+        return this.tryAcquireLock(resource, ttlMs);
+    }
+    async isLocked(resource) {
+        const entry = this.locks.get(resource);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expiresAt.getTime()) {
+            this.locks.delete(resource);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Clean up expired locks.
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [resource, entry] of this.locks) {
+            if (now > entry.expiresAt.getTime()) {
+                this.locks.delete(resource);
+                this.notifyWaiters(resource);
+            }
+        }
+    }
+    /**
+     * Release all locks and clean up.
+     */
+    clear() {
+        this.locks.clear();
+        for (const queue of this.waitQueues.values()) {
+            for (const waiter of queue) {
+                clearTimeout(waiter.timer);
+            }
+        }
+        this.waitQueues.clear();
+    }
+    tryAcquireLock(resource, ttlMs) {
+        this.cleanup();
+        const existing = this.locks.get(resource);
+        if (existing) {
+            if (Date.now() > existing.expiresAt.getTime()) {
+                this.locks.delete(resource);
+            }
+            else {
+                return null;
+            }
+        }
+        const lockId = randomBytes(16).toString("hex");
+        const acquiredAt = new Date();
+        const expiresAt = new Date(Date.now() + ttlMs);
+        const entry = { lockId, resource, acquiredAt, expiresAt };
+        this.locks.set(resource, entry);
+        return {
+            lockId,
+            resource,
+            acquiredAt,
+            get expiresAt() {
+                return entry.expiresAt;
+            },
+            release: async () => {
+                const current = this.locks.get(resource);
+                if (current?.lockId === lockId) {
+                    this.locks.delete(resource);
+                    this.notifyWaiters(resource);
+                }
+            },
+            extend: async (durationMs) => {
+                const current = this.locks.get(resource);
+                if (current?.lockId === lockId) {
+                    current.expiresAt = new Date(Date.now() + durationMs);
+                }
+            },
+        };
+    }
+    notifyWaiters(resource) {
+        const queue = this.waitQueues.get(resource);
+        if (queue && queue.length > 0) {
+            const waiter = queue.shift();
+            clearTimeout(waiter.timer);
+            waiter.resolve();
+        }
+    }
+}
+//# sourceMappingURL=inMemoryLock.core.js.map

package/dist/locking/inMemoryLock.core.js.map

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

package/dist/locking/index.d.ts

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

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

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

package/dist/locking/index.js

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

package/dist/locking/index.js.map

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

package/dist/objectStorage/index.d.ts

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

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

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

package/dist/objectStorage/index.js

@@ -0,0 +1,5 @@
+/**
+ * @zudojs/storage — Object Storage Barrel
+ */
+export { LocalObjectStorage } from "./localObjectStorage.core.js";
+//# sourceMappingURL=index.js.map

package/dist/objectStorage/index.js.map

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

package/dist/objectStorage/localObjectStorage.core.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @zudojs/storage — Local Object Storage
+ *
+ * Filesystem-based object storage for development and testing.
+ */
+import type { ObjectStorage, ObjectPutOptions, ObjectMetadata, ObjectData, ListObjectsResult } from "../types/storage.type.js";
+/**
+ * Local filesystem object storage implementation.
+ */
+export declare class LocalObjectStorage implements ObjectStorage {
+    private readonly basePath;
+    constructor(basePath: string);
+    put(key: string, data: Uint8Array | ReadableStream<Uint8Array>, options?: ObjectPutOptions): Promise<ObjectMetadata>;
+    get(key: string): Promise<ObjectData | null>;
+    delete(key: string): Promise<void>;
+    exists(key: string): Promise<boolean>;
+    metadata(key: string): Promise<ObjectMetadata | null>;
+    list(prefix?: string, options?: {
+        readonly maxKeys?: number;
+        readonly continuationToken?: string;
+    }): Promise<ListObjectsResult>;
+    private resolvePath;
+}
+//# sourceMappingURL=localObjectStorage.core.d.ts.map

package/dist/objectStorage/localObjectStorage.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localObjectStorage.core.d.ts","sourceRoot":"","sources":["../../src/objectStorage/localObjectStorage.core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,EAAE,MAAM,EAAI;IAE3C,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,EAC7C,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,cAAc,CAAC,CAmCzB;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA4BjD;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvC;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1C;IAEK,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAY1D;IAEK,IAAI,CACR,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KACrC,GACA,OAAO,CAAC,iBAAiB,CAAC,CAgC5B;IAED,OAAO,CAAC,WAAW;CAWpB"}

package/dist/objectStorage/localObjectStorage.core.js

@@ -0,0 +1,151 @@
+/**
+ * @zudojs/storage — Local Object Storage
+ *
+ * Filesystem-based object storage for development and testing.
+ */
+import { readFile, writeFile, unlink, stat, mkdir, readdir, } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { StorageError } from "@zudojs/errors";
+/**
+ * Local filesystem object storage implementation.
+ */
+export class LocalObjectStorage {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    async put(key, data, options) {
+        const filePath = this.resolvePath(key);
+        await mkdir(dirname(filePath), { recursive: true });
+        let buffer;
+        if (data instanceof Uint8Array) {
+            buffer = Buffer.from(data);
+        }
+        else {
+            // Read stream to buffer
+            const chunks = [];
+            const reader = data.getReader();
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(value);
+            }
+            const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
+            buffer = Buffer.alloc(totalLength);
+            let offset = 0;
+            for (const chunk of chunks) {
+                buffer.set(chunk, offset);
+                offset += chunk.length;
+            }
+        }
+        await writeFile(filePath, buffer);
+        const stats = await stat(filePath);
+        return {
+            key,
+            contentType: options?.contentType,
+            size: stats.size,
+            lastModified: stats.mtime,
+            metadata: options?.metadata,
+        };
+    }
+    async get(key) {
+        const filePath = this.resolvePath(key);
+        try {
+            const stats = await stat(filePath);
+            const buffer = await readFile(filePath);
+            const metadata = {
+                key,
+                size: stats.size,
+                lastModified: stats.mtime,
+            };
+            return {
+                metadata,
+                body: new ReadableStream({
+                    start(controller) {
+                        controller.enqueue(new Uint8Array(buffer));
+                        controller.close();
+                    },
+                }),
+                async arrayBuffer() {
+                    return buffer.buffer;
+                },
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async delete(key) {
+        const filePath = this.resolvePath(key);
+        await unlink(filePath);
+    }
+    async exists(key) {
+        const filePath = this.resolvePath(key);
+        try {
+            await stat(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async metadata(key) {
+        const filePath = this.resolvePath(key);
+        try {
+            const stats = await stat(filePath);
+            return {
+                key,
+                size: stats.size,
+                lastModified: stats.mtime,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async list(prefix, options) {
+        const dirPath = prefix ? this.resolvePath(prefix) : this.basePath;
+        const maxKeys = options?.maxKeys ?? 1000;
+        try {
+            const entries = await readdir(dirPath, { recursive: true });
+            const objects = [];
+            for (const entry of entries.slice(0, maxKeys)) {
+                const fullPath = join(dirPath, entry);
+                try {
+                    const stats = await stat(fullPath);
+                    if (stats.isFile()) {
+                        const key = fullPath.slice(this.basePath.length + 1);
+                        objects.push({
+                            key,
+                            size: stats.size,
+                            lastModified: stats.mtime,
+                        });
+                    }
+                }
+                catch {
+                    // Skip inaccessible entries
+                }
+            }
+            return {
+                objects,
+                isTruncated: entries.length > maxKeys,
+            };
+        }
+        catch {
+            return { objects: [], isTruncated: false };
+        }
+    }
+    resolvePath(key) {
+        // Prevent path traversal
+        const resolved = join(this.basePath, key);
+        if (!resolved.startsWith(this.basePath)) {
+            throw new StorageError(`Path traversal detected: ${key}`, {
+                code: "STORAGE_PATH_TRAVERSAL",
+                statusCode: 400,
+            });
+        }
+        return resolved;
+    }
+}
+//# sourceMappingURL=localObjectStorage.core.js.map

package/dist/objectStorage/localObjectStorage.core.js.map

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

package/dist/repository/baseRepository.core.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @zudojs/storage — Base Repository
+ *
+ * Provides a base implementation for repository CRUD operations.
+ * Concrete repositories can extend this for domain-specific queries.
+ */
+import type { Database, QueryParameter } from "../types/storage.type.js";
+/**
+ * Options for the base repository.
+ */
+export interface BaseRepositoryOptions {
+    /** The database table name. */
+    readonly tableName: string;
+    /** The primary key column name (default: "id"). */
+    readonly primaryKey?: string;
+}
+/**
+ * Base repository providing common CRUD operations.
+ * Override methods for domain-specific behavior.
+ */
+export declare class BaseRepository<Entity extends Record<string, unknown>, ID = string> {
+    protected readonly database: Database;
+    protected readonly tableName: string;
+    protected readonly primaryKey: string;
+    constructor(database: Database, options: BaseRepositoryOptions);
+    /**
+     * Find an entity by its primary key.
+     */
+    findById(id: ID): Promise<Entity | null>;
+    /**
+     * Find multiple entities by their IDs.
+     */
+    findByIds(ids: readonly ID[]): Promise<readonly Entity[]>;
+    /**
+     * Create a new entity.
+     */
+    create(entity: Entity): Promise<Entity>;
+    /**
+     * Update an entity by primary key.
+     */
+    update(id: ID, changes: Partial<Entity>): Promise<Entity>;
+    /**
+     * Delete an entity by primary key.
+     */
+    delete(id: ID): Promise<void>;
+    /**
+     * Check if an entity exists by primary key.
+     */
+    exists(id: ID): Promise<boolean>;
+    /**
+     * Find all entities with optional limit and offset.
+     */
+    findAll(options?: {
+        readonly limit?: number;
+        readonly offset?: number;
+        readonly orderBy?: string;
+        readonly order?: "ASC" | "DESC";
+    }): Promise<readonly Entity[]>;
+    /**
+     * Count entities matching optional where conditions.
+     */
+    count(where?: Record<string, QueryParameter>): Promise<number>;
+}
+//# sourceMappingURL=baseRepository.core.d.ts.map

package/dist/repository/baseRepository.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseRepository.core.d.ts","sourceRoot":"","sources":["../../src/repository/baseRepository.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,QAAQ,EAER,cAAc,EAEf,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,qBAAa,cAAc,CACzB,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,EAAE,GAAG,MAAM;IAMT,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAJvC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAEtC,YACqB,QAAQ,EAAE,QAAQ,EACrC,OAAO,EAAE,qBAAqB,EAI/B;IAED;;OAEG;IACG,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO7C;IAED;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAU9D;IAED;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY5C;IAED;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB9D;IAED;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlC;IAED;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAOrC;IAED;;OAEG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KACjC,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAiB7B;IAED;;OAEG;IACG,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBnE;CACF"}

package/dist/repository/baseRepository.core.js

@@ -0,0 +1,145 @@
+/**
+ * @zudojs/storage — Base Repository
+ *
+ * Provides a base implementation for repository CRUD operations.
+ * Concrete repositories can extend this for domain-specific queries.
+ */
+import { NotFoundError } from "@zudojs/errors";
+/**
+ * Base repository providing common CRUD operations.
+ * Override methods for domain-specific behavior.
+ */
+export class BaseRepository {
+    database;
+    tableName;
+    primaryKey;
+    constructor(database, options) {
+        this.database = database;
+        this.tableName = options.tableName;
+        this.primaryKey = options.primaryKey ?? "id";
+    }
+    /**
+     * Find an entity by its primary key.
+     */
+    async findById(id) {
+        const query = {
+            text: `SELECT * FROM ${this.tableName} WHERE ${this.primaryKey} = $1`,
+            parameters: [id],
+        };
+        const result = await this.database.query(query);
+        return result.rows[0] ?? null;
+    }
+    /**
+     * Find multiple entities by their IDs.
+     */
+    async findByIds(ids) {
+        if (ids.length === 0)
+            return [];
+        const placeholders = ids.map((_, i) => `$${i + 1}`).join(", ");
+        const query = {
+            text: `SELECT * FROM ${this.tableName} WHERE ${this.primaryKey} IN (${placeholders})`,
+            parameters: [...ids],
+        };
+        const result = await this.database.query(query);
+        return result.rows;
+    }
+    /**
+     * Create a new entity.
+     */
+    async create(entity) {
+        const keys = Object.keys(entity);
+        const values = Object.values(entity);
+        const placeholders = keys.map((_, i) => `$${i + 1}`).join(", ");
+        const columns = keys.join(", ");
+        const query = {
+            text: `INSERT INTO ${this.tableName} (${columns}) VALUES (${placeholders}) RETURNING *`,
+            parameters: values,
+        };
+        const result = await this.database.query(query);
+        return result.rows[0];
+    }
+    /**
+     * Update an entity by primary key.
+     */
+    async update(id, changes) {
+        const keys = Object.keys(changes);
+        const values = Object.values(changes);
+        if (keys.length === 0) {
+            const existing = await this.findById(id);
+            if (!existing) {
+                throw new NotFoundError(`Entity not found: ${id}`, {
+                    code: "STORAGE_ENTITY_NOT_FOUND",
+                    statusCode: 404,
+                });
+            }
+            return existing;
+        }
+        const setClauses = keys.map((key, i) => `${key} = $${i + 1}`).join(", ");
+        const parameters = [...values, id];
+        const query = {
+            text: `UPDATE ${this.tableName} SET ${setClauses} WHERE ${this.primaryKey} = $${keys.length + 1} RETURNING *`,
+            parameters,
+        };
+        const result = await this.database.query(query);
+        return result.rows[0];
+    }
+    /**
+     * Delete an entity by primary key.
+     */
+    async delete(id) {
+        const query = {
+            text: `DELETE FROM ${this.tableName} WHERE ${this.primaryKey} = $1`,
+            parameters: [id],
+        };
+        await this.database.execute(query);
+    }
+    /**
+     * Check if an entity exists by primary key.
+     */
+    async exists(id) {
+        const query = {
+            text: `SELECT 1 FROM ${this.tableName} WHERE ${this.primaryKey} = $1 LIMIT 1`,
+            parameters: [id],
+        };
+        const result = await this.database.query(query);
+        return result.rowCount > 0;
+    }
+    /**
+     * Find all entities with optional limit and offset.
+     */
+    async findAll(options) {
+        let text = `SELECT * FROM ${this.tableName}`;
+        if (options?.orderBy) {
+            text += ` ORDER BY ${options.orderBy} ${options.order ?? "ASC"}`;
+        }
+        if (options?.limit !== undefined) {
+            text += ` LIMIT ${options.limit}`;
+        }
+        if (options?.offset !== undefined) {
+            text += ` OFFSET ${options.offset}`;
+        }
+        const result = await this.database.query({ text });
+        return result.rows;
+    }
+    /**
+     * Count entities matching optional where conditions.
+     */
+    async count(where) {
+        let text = `SELECT COUNT(*) as count FROM ${this.tableName}`;
+        const parameters = [];
+        if (where) {
+            const keys = Object.keys(where);
+            if (keys.length > 0) {
+                const conditions = keys.map((key, i) => `${key} = $${i + 1}`);
+                text += ` WHERE ${conditions.join(" AND ")}`;
+                parameters.push(...Object.values(where));
+            }
+        }
+        const result = await this.database.query({
+            text,
+            parameters,
+        });
+        return parseInt(result.rows[0]?.count ?? "0", 10);
+    }
+}
+//# sourceMappingURL=baseRepository.core.js.map

package/dist/repository/baseRepository.core.js.map

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

package/dist/repository/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @zudojs/storage — Repository Barrel
+ */
+export { BaseRepository } from "./baseRepository.core.js";
+export type { BaseRepositoryOptions } from "./baseRepository.core.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/repository/index.js

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

package/dist/repository/index.js.map

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

package/dist/serialization/index.d.ts

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

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

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

package/dist/serialization/index.js

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

package/dist/serialization/index.js.map

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

package/dist/serialization/jsonSerializer.core.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @zudojs/storage — JSON Serializer
+ *
+ * Serializes/deserializes data for storage with support for BigInt, Date,
+ * Map, Set, and Uint8Array via @zudojs/serialization's type preservation.
+ */
+import type { Serializer, SerializationFormat } from "../types/storage.type.js";
+/**
+ * JSON serializer with extended type support for storage operations.
+ *
+ * Delegates to @zudojs/serialization's JSONSerializer for type preservation
+ * (BigInt, Date, Map, Set, Uint8Array) and wraps the output as Uint8Array
+ * to satisfy the storage Serializer contract.
+ */
+export declare class JsonSerializer implements Serializer {
+    private readonly inner;
+    constructor();
+    serialize<T>(value: T, _format?: SerializationFormat): Uint8Array;
+    deserialize<T>(data: Uint8Array, _format?: SerializationFormat): T;
+}
+//# sourceMappingURL=jsonSerializer.core.d.ts.map