@plyaz/db 0.0.0

package/dist/advanced/sharding/ShardKey.d.ts

@@ -0,0 +1,80 @@
+import type { ShardKey } from "@plyaz/types";
+/**
+ * Manages shard key definitions and calculations.
+ * Provides utilities for determining which shard a record belongs to.
+ *
+ * @example
+ * ```typescript
+ * const shardKeyManager = new ShardKeyManager();
+ *
+ * // Register a shard key for users table
+ * shardKeyManager.registerShardKey('users', {
+ *   name: 'user_shard',
+ *   type: 'hash',
+ *   columns: ['id'],
+ *   strategy: 'hash',
+ *   shardCount: 4
+ * });
+ *
+ * // Calculate which shard a user belongs to
+ * const shardId = shardKeyManager.calculateShard('users', { id: 'user-123' });
+ * console.log(`User belongs to shard ${shardId}`);
+ * ```
+ */
+export declare class ShardKeyManager {
+    private shardKeys;
+    /**
+     * Registers a shard key for a table.
+     * @param table Table name
+     * @param shardKey Shard key configuration
+     */
+    registerShardKey(table: string, shardKey: ShardKey): void;
+    /**
+     * Gets the shard key configuration for a table.
+     * @param table Table name
+     * @returns Shard key configuration or undefined
+     */
+    getShardKey(table: string): ShardKey | undefined;
+    /**
+     * Calculates which shard a record belongs to.
+     * @param table Table name
+     * @param data Record data
+     * @returns Shard ID (0-based)
+     */
+    calculateShard<T extends Record<string, string | number>>(table: string, data: T): number;
+    /**
+     * Extracts the shard key value from record data.
+     * @param data Record data
+     * @param shardKey Shard key configuration
+     * @returns Extracted key value
+     */
+    private extractKeyValue;
+    /**
+     * Calculates shard ID using modulus strategy.
+     * @param keyValue Key value
+     * @param shardCount Number of shards
+     * @returns Shard ID
+     */
+    private modulusShard;
+    /**
+     * Calculates shard ID using hash strategy.
+     * @param keyValue Key value
+     * @param shardCount Number of shards
+     * @returns Shard ID
+     */
+    private hashShard;
+    /**
+     * Calculates shard ID using range strategy.
+     * @param keyValue Key value
+     * @param shardKey Shard key configuration
+     * @returns Shard ID
+     */
+    private rangeShard;
+    /**
+     * Hashes a string to a numeric value.
+     * @param str String to hash
+     * @returns Hash value
+     */
+    private hashString;
+}
+//# sourceMappingURL=ShardKey.d.ts.map

package/dist/advanced/sharding/ShardKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShardKey.d.ts","sourceRoot":"","sources":["../../../src/advanced/sharding/ShardKey.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAoC;IAErD;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIzD;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIhD;;;;;OAKG;IACH,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EACtD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,CAAC,GACN,MAAM;IAkCT;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAWvB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IASjB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAalB;;;;OAIG;IACH,OAAO,CAAC,UAAU;CASnB"}

package/dist/advanced/sharding/ShardRouter.d.ts

@@ -0,0 +1,66 @@
+import type { ShardConfig, ShardKey } from "@plyaz/types";
+/**
+ * Routes database operations to the appropriate shard based on shard keys.
+ * Provides shard-aware routing and management capabilities.
+ *
+ * @example
+ * ```typescript
+ * const shardConfigs: ShardConfig[] = [
+ *   { id: 0, connectionString: 'postgres://shard0:5432/db', isPrimary: false },
+ *   { id: 1, connectionString: 'postgres://shard1:5432/db', isPrimary: false },
+ *   { id: 2, connectionString: 'postgres://shard2:5432/db', isPrimary: true }
+ * ];
+ *
+ * const router = new ShardRouter(shardConfigs);
+ *
+ * // Route a record to the appropriate shard
+ * const userData = { id: 'user-456', name: 'Jane' };
+ * const shard = router.routeToShard('users', userData);
+ * console.log(`User should be stored on shard ${shard.id}`);
+ *
+ * // Get a specific shard
+ * const shard2 = router.getShardById(2);
+ *
+ * // Get all shards
+ * const allShards = router.getAllShards();
+ * ```
+ */
+export declare class ShardRouter {
+    private shards;
+    private shardKeyManager;
+    /**
+     * Creates a new ShardRouter instance.
+     * @param shardConfigs Array of shard configurations
+     */
+    constructor(shardConfigs: ShardConfig[]);
+    /**
+     * Determines which shard a record should be routed to.
+     * @param table Table name
+     * @param data Record data
+     * @returns Shard configuration
+     */
+    routeToShard(table: string, data: Record<string, string | number | boolean | Date>): ShardConfig;
+    /**
+     * Gets a shard configuration by ID.
+     * @param shardId Shard ID
+     * @returns Shard configuration or undefined
+     */
+    getShardById(shardId: number): ShardConfig | undefined;
+    /**
+     * Gets all shard configurations.
+     * @returns Array of all shard configurations
+     */
+    getAllShards(): ShardConfig[];
+    /**
+     * Gets the primary shard configuration.
+     * @returns Primary shard configuration or undefined
+     */
+    getPrimaryShard(): ShardConfig | undefined;
+    /**
+     * Registers a shard key for a table.
+     * @param table Table name
+     * @param shardKey Shard key configuration
+     */
+    registerShardKey(table: string, shardKey: ShardKey): void;
+}
+//# sourceMappingURL=ShardRouter.d.ts.map

package/dist/advanced/sharding/ShardRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShardRouter.d.ts","sourceRoot":"","sources":["../../../src/advanced/sharding/ShardRouter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;OAGG;gBACS,YAAY,EAAE,WAAW,EAAE;IAQvC;;;;;OAKG;IACH,YAAY,CACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,GACrD,WAAW;IAwBd;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAItD;;;OAGG;IACH,YAAY,IAAI,WAAW,EAAE;IAI7B;;;OAGG;IACH,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C;;;;OAIG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAG1D"}

package/dist/advanced/sharding/index.d.ts

@@ -0,0 +1,3 @@
+export { ShardKeyManager } from "./ShardKey";
+export { ShardRouter } from "./ShardRouter";
+//# sourceMappingURL=index.d.ts.map

package/dist/advanced/sharding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/advanced/sharding/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/builder/query/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Query builder index
+ * Exports all query builder utilities (SQL and ORM)
+ */
+export * from "./sql";
+export * from "./orm";
+//# sourceMappingURL=index.d.ts.map

package/dist/builder/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builder/query/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC"}

package/dist/builder/query/orm.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ORM Query builder utilities
+ *
+ * This module provides utilities for building ORM-specific queries.
+ * Currently a placeholder for future ORM implementations.
+ */
+/**
+ * Builds a WHERE clause for ORM queries
+ * @throws Error - Not implemented yet
+ */
+export declare function buildWhereClauseORM(): Error;
+/**
+ * Builds an ORDER BY clause for ORM queries
+ * @throws Error - Not implemented yet
+ */
+export declare function buildOrderClauseORM(): Error;
+/**
+ * Builds pagination clauses for ORM queries
+ * @throws Error - Not implemented yet
+ */
+export declare function buildPaginationClauseORM(): Error;
+//# sourceMappingURL=orm.d.ts.map

package/dist/builder/query/orm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orm.d.ts","sourceRoot":"","sources":["../../../src/builder/query/orm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,CAS3C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,KAAK,CAS3C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,KAAK,CAShD"}

package/dist/builder/query/sql.d.ts

@@ -0,0 +1,29 @@
+import type { PaginationOptions, SortOptions, Filter } from "@plyaz/types/db";
+/**
+ * SQL query builder utilities
+ *
+ * Provides safe, parameterized SQL query generation.
+ * Works independently of any specific ORM or query engine.
+ */
+/**
+ * Builds a WHERE clause from filters
+ * @param filters - Array of filter conditions
+ * @returns WHERE clause string
+ */
+export declare function buildWhereClause<T extends object = object>(filters?: Filter[]): string;
+/**
+ * Builds an ORDER BY clause from sort options
+ * @param sortOptions - Array of sort options
+ * @returns ORDER BY clause string
+ */
+export declare function buildOrderClause(sortOptions?: SortOptions[]): string;
+/**
+ * Builds LIMIT and OFFSET clauses from pagination options
+ * @param pagination - Pagination options
+ * @returns Object containing the clause string and parameters
+ */
+export declare function buildPaginationClause<T>(pagination?: PaginationOptions): {
+    clause: string;
+    params: T[];
+};
+//# sourceMappingURL=sql.d.ts.map

package/dist/builder/query/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../../src/builder/query/sql.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG9E;;;;;GAKG;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACxD,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,MAAM,CAuDR;AAsGD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CAuCpE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,EAAE,CAAC;CACb,CAmBA"}