@gl-life/gl-life-database 1.0.0

package/dist/migration/index.d.ts

@@ -0,0 +1,4 @@
+export * from './loader.js';
+export * from './runner.js';
+export * from './seeder.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migration/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/migration/loader.d.ts

@@ -0,0 +1,88 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { Migration, MigrationConfig, MigrationError } from '../types/migration.js';
+/**
+ * Migration file loader
+ *
+ * Discovers and loads migration files from a directory,
+ * validates migration structure, and orders by version.
+ *
+ * Migration file format:
+ * ```typescript
+ * export const version = 1;
+ * export const name = 'create_users_table';
+ *
+ * export async function up(context) {
+ *   return context.execute('CREATE TABLE users (id INTEGER PRIMARY KEY)');
+ * }
+ *
+ * export async function down(context) {
+ *   return context.execute('DROP TABLE users');
+ * }
+ * ```
+ *
+ * Usage:
+ * ```typescript
+ * const loader = new MigrationLoader(config, logger);
+ * const result = await loader.loadMigrations();
+ * if (result.isOk()) {
+ *   const migrations = result.unwrap();
+ *   // migrations are ordered by version
+ * }
+ * ```
+ */
+export declare class MigrationLoader {
+    private readonly config;
+    private readonly logger;
+    private readonly filePattern;
+    constructor(config: MigrationConfig, logger: Logger);
+    /**
+     * Load all migrations from the configured directory
+     *
+     * @returns Result with array of migrations ordered by version
+     */
+    loadMigrations(): Promise<Result<Migration[], MigrationError>>;
+    /**
+     * Load a single migration file
+     *
+     * @param filePath - Path to migration file
+     * @returns Result with Migration or MigrationError
+     */
+    private loadMigrationFile;
+    /**
+     * Validate migration module structure
+     *
+     * @param module - Migration module
+     * @param filePath - File path for error messages
+     * @returns Result with void on success or MigrationError
+     */
+    private validateMigration;
+    /**
+     * Find duplicate version numbers in migrations
+     *
+     * @param migrations - Array of migrations
+     * @returns Array of duplicate version numbers
+     */
+    private findDuplicateVersions;
+    /**
+     * Generate unique migration ID from version and name
+     *
+     * @param version - Migration version
+     * @param name - Migration name
+     * @returns Migration ID
+     */
+    private generateMigrationId;
+    /**
+     * Compute SHA-256 checksum of migration content
+     *
+     * @param content - Migration file content
+     * @returns Checksum string
+     */
+    private computeChecksum;
+    /**
+     * Get SQL schema for migration tracking table
+     *
+     * @returns SQL CREATE TABLE statement
+     */
+    getMigrationTableSchema(): string;
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/migration/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/migration/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIvD,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACf,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;IAQnD;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;IA4DpE;;;;;OAKG;YACW,iBAAiB;IA8C/B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;IACH,uBAAuB,IAAI,MAAM;CAmBlC"}

package/dist/migration/runner.d.ts

@@ -0,0 +1,91 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { MigrationLoader } from './loader.js';
+import type { Migration, MigrationConfig, MigrationMetadata, MigrationError, MigrationRunner as IMigrationRunner } from '../types/migration.js';
+/**
+ * Migration runner implementation
+ *
+ * Manages database migrations with version control, transaction support,
+ * and rollback capabilities. Tracks migration state in the database.
+ *
+ * Usage:
+ * ```typescript
+ * const runner = new MigrationRunner(connection, loader, config, logger);
+ *
+ * // Run all pending migrations
+ * const result = await runner.migrate();
+ *
+ * // Rollback last migration
+ * const rollbackResult = await runner.rollback();
+ * ```
+ */
+export declare class MigrationRunner implements IMigrationRunner {
+    private readonly connection;
+    private readonly loader;
+    readonly config: MigrationConfig;
+    private readonly logger;
+    constructor(connection: any, loader: MigrationLoader, config: MigrationConfig, logger: Logger);
+    /**
+     * Create migration table if it doesn't exist
+     */
+    createMigrationTable(): Promise<Result<void, MigrationError>>;
+    /**
+     * Get all available migrations
+     */
+    getMigrations(): Promise<Result<Migration[], MigrationError>>;
+    /**
+     * Get migration history from database
+     */
+    getHistory(): Promise<Result<MigrationMetadata[], MigrationError>>;
+    /**
+     * Get pending migrations
+     */
+    getPending(): Promise<Result<Migration[], MigrationError>>;
+    /**
+     * Run all pending migrations
+     */
+    migrate(): Promise<Result<MigrationMetadata[], MigrationError>>;
+    /**
+     * Run migrations up to a specific version
+     */
+    migrateTo(targetVersion: number): Promise<Result<MigrationMetadata[], MigrationError>>;
+    /**
+     * Rollback the last migration
+     */
+    rollback(): Promise<Result<MigrationMetadata, MigrationError>>;
+    /**
+     * Rollback to a specific version
+     */
+    rollbackTo(targetVersion: number): Promise<Result<MigrationMetadata[], MigrationError>>;
+    /**
+     * Reset database by rolling back all migrations
+     */
+    reset(): Promise<Result<MigrationMetadata[], MigrationError>>;
+    /**
+     * Refresh database by resetting and re-running all migrations
+     */
+    refresh(): Promise<Result<{
+        rolledBack: MigrationMetadata[];
+        applied: MigrationMetadata[];
+    }, MigrationError>>;
+    /**
+     * Get current migration version
+     */
+    getCurrentVersion(): Promise<Result<number, MigrationError>>;
+    /**
+     * Validate migration checksums
+     */
+    validateChecksums(): Promise<Result<boolean, MigrationError>>;
+    /**
+     * Load migration from file
+     */
+    loadMigration(filePath: string): Promise<Result<Migration, MigrationError>>;
+    /**
+     * Run a single migration in a transaction
+     */
+    private runMigration;
+    /**
+     * Update migration status in database
+     */
+    private updateMigrationStatus;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/migration/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/migration/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EAEf,iBAAiB,EACjB,cAAc,EACd,eAAe,IAAI,gBAAgB,EACpC,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAG9B,UAAU,EAAE,GAAG,EACf,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM;IAQhB;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAyBnE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;IAInE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,cAAc,CAAC,CAAC;IAoCxE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,cAAc,CAAC,CAAC;IAqChE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,cAAc,CAAC,CAAC;IAwCrE;;OAEG;IACG,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,cAAc,CAAC,CAAC;IAoD5F;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;IAyDpE;;OAEG;IACG,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,cAAc,CAAC,CAAC;IAoD7F;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,cAAc,CAAC,CAAC;IAInE;;OAEG;IACG,OAAO,IAAI,OAAO,CACtB,MAAM,CAAC;QAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;QAAC,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE,EAAE,cAAc,CAAC,CAC1F;IAkCD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IA2BlE;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAkDnE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAWjF;;OAEG;YACW,YAAY;IA8G1B;;OAEG;YACW,qBAAqB;CAqDpC"}

package/dist/migration/seeder.d.ts

@@ -0,0 +1,95 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { Seed, SeedConfig, SeedMetadata, SeedError, Seeder } from '../types/seed.js';
+/**
+ * Data seeder implementation
+ *
+ * Manages database seeding with environment-specific support and idempotent execution.
+ * Seeds are executed only once per environment unless explicitly re-run.
+ *
+ * Usage:
+ * ```typescript
+ * const seeder = new DataSeeder(connection, config, logger);
+ *
+ * // Run all pending seeds
+ * const result = await seeder.seed();
+ *
+ * // Reset all seeds
+ * const resetResult = await seeder.reset();
+ * ```
+ */
+export declare class DataSeeder implements Seeder {
+    private readonly connection;
+    readonly config: SeedConfig;
+    private readonly logger;
+    private seedsCache;
+    constructor(connection: any, config: SeedConfig, logger: Logger);
+    /**
+     * Create seed table if it doesn't exist
+     */
+    createSeedTable(): Promise<Result<void, SeedError>>;
+    /**
+     * Get all available seeds
+     */
+    getSeeds(): Promise<Result<Seed[], SeedError>>;
+    /**
+     * Get seed history from database
+     */
+    getHistory(): Promise<Result<SeedMetadata[], SeedError>>;
+    /**
+     * Get pending seeds for current environment
+     */
+    getPending(): Promise<Result<Seed[], SeedError>>;
+    /**
+     * Run all pending seeds for current environment
+     */
+    seed(): Promise<Result<SeedMetadata[], SeedError>>;
+    /**
+     * Run a specific seed by ID
+     */
+    runSeed(seedId: string): Promise<Result<SeedMetadata, SeedError>>;
+    /**
+     * Reset all seeds (clear history)
+     */
+    reset(): Promise<Result<void, SeedError>>;
+    /**
+     * Validate seed checksums
+     */
+    validateChecksums(): Promise<Result<boolean, SeedError>>;
+    /**
+     * Load seed from file
+     */
+    loadSeed(filePath: string): Promise<Result<Seed, SeedError>>;
+    /**
+     * Load seeds from directory
+     */
+    private loadSeedsFromDirectory;
+    /**
+     * Load a single seed file
+     */
+    private loadSeedFile;
+    /**
+     * Validate seed module structure
+     */
+    private validateSeed;
+    /**
+     * Check if seed matches current environment
+     */
+    private matchesEnvironment;
+    /**
+     * Execute a single seed
+     */
+    private executeSeed;
+    /**
+     * Update seed status in database
+     */
+    private updateSeedStatus;
+    /**
+     * Compute SHA-256 checksum of seed content
+     */
+    private computeChecksum;
+    /**
+     * Get SQL schema for seed tracking table
+     */
+    private getSeedTableSchema;
+}
+//# sourceMappingURL=seeder.d.ts.map

package/dist/migration/seeder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeder.d.ts","sourceRoot":"","sources":["../../src/migration/seeder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAIvD,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EAEV,YAAY,EACZ,SAAS,EACT,MAAM,EAEP,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,UAAU,CAAuB;gBAE7B,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM;IAM/D;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAyBzD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IAIpD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,CAAC;IAoC9D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IAwCtD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,CAAC;IAwCxD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IA+BvE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAyB/C;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAkD9D;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAIlE;;OAEG;YACW,sBAAsB;IA8DpC;;OAEG;YACW,YAAY;IA0C1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAoCpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,WAAW;IAyFzB;;OAEG;YACW,gBAAgB;IAkD9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAmB3B"}

package/dist/query/builder.d.ts

@@ -0,0 +1,47 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { QueryBuilder as IQueryBuilder, QueryBuilderError, WhereOperator, JoinType, OrderDirection } from '../types/query-builder.js';
+/**
+ * Type-safe query builder wrapper for gl-life-data
+ *
+ * Wraps gl-life-data QueryBuilder with:
+ * - Type safety using TypeScript generics
+ * - Result<T, E> pattern for error handling
+ * - Fluent chainable API
+ * - Complex joins, aggregations, subqueries support
+ */
+export declare class TypeSafeQueryBuilder<T = unknown> implements IQueryBuilder<T> {
+    private tableName;
+    private metaDataService;
+    private logger;
+    private selectedColumns;
+    private whereConditions;
+    private joinClauses;
+    private orderByClauses;
+    private groupByFields;
+    private havingCondition;
+    private limitValue;
+    private offsetValue;
+    constructor(tableName: string, metaDataService: any, logger: Logger);
+    table(table: string): IQueryBuilder<T>;
+    select(...columns: string[]): IQueryBuilder<T>;
+    where(field: string, operator: WhereOperator, value?: unknown): IQueryBuilder<T>;
+    orWhere(field: string, operator: WhereOperator, value?: unknown): IQueryBuilder<T>;
+    whereIn(field: string, values: unknown[]): IQueryBuilder<T>;
+    join(table: string, leftField: string, rightField: string, type?: JoinType): IQueryBuilder<T>;
+    orderBy(field: string, direction?: OrderDirection): IQueryBuilder<T>;
+    groupBy(...fields: string[]): IQueryBuilder<T>;
+    having(condition: string): IQueryBuilder<T>;
+    limit(limit: number): IQueryBuilder<T>;
+    offset(offset: number): IQueryBuilder<T>;
+    insert(data: Partial<T>): Promise<Result<T, QueryBuilderError>>;
+    insertMany(data: Partial<T>[]): Promise<Result<T[], QueryBuilderError>>;
+    update(data: Partial<T>): Promise<Result<number, QueryBuilderError>>;
+    delete(): Promise<Result<number, QueryBuilderError>>;
+    first(): Promise<Result<T | null, QueryBuilderError>>;
+    get(): Promise<Result<T[], QueryBuilderError>>;
+    count(field?: string): Promise<Result<number, QueryBuilderError>>;
+    toSQL(): string;
+    getBindings(): unknown[];
+    clone(): IQueryBuilder<T>;
+}
+//# sourceMappingURL=builder.d.ts.map

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

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

package/dist/query/index.d.ts

@@ -0,0 +1,3 @@
+export * from './builder.js';
+export * from './raw.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/query/raw.d.ts

@@ -0,0 +1,92 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { DatabaseConnection, DatabaseConnectionError } from '../types/connection.js';
+/**
+ * Raw SQL execution error types
+ */
+export type RawSQLError = {
+    type: 'INVALID_SQL';
+    message: string;
+} | {
+    type: 'PARAMETER_MISMATCH';
+    message: string;
+} | {
+    type: 'EXECUTION_FAILED';
+    message: string;
+    cause?: unknown;
+} | {
+    type: 'VALIDATION_FAILED';
+    message: string;
+} | DatabaseConnectionError;
+/**
+ * Query with parameters for batch execution
+ */
+export interface SQLQuery {
+    sql: string;
+    params?: unknown[];
+}
+/**
+ * Execution options
+ */
+export interface ExecutionOptions {
+    transaction?: boolean;
+    timeout?: number;
+}
+/**
+ * Raw SQL Executor
+ *
+ * Provides safe raw SQL execution with:
+ * - Parameterized queries to prevent SQL injection
+ * - Result type mapping
+ * - Query validation
+ * - Batch execution support
+ * - Error handling with Result pattern
+ */
+export declare class RawSQLExecutor {
+    private readonly connection;
+    private readonly logger;
+    constructor(connection: DatabaseConnection, logger: Logger);
+    /**
+     * Execute a raw SQL query with parameters
+     *
+     * Uses parameterized queries to prevent SQL injection.
+     * All parameter values are properly escaped by the database driver.
+     *
+     * @param sql - SQL query string with ? placeholders
+     * @param params - Parameter values to bind to placeholders
+     * @param options - Execution options
+     * @returns Result containing array of rows or error
+     */
+    execute<T = unknown>(sql: string, params?: unknown[], options?: ExecutionOptions): Promise<Result<T[], RawSQLError>>;
+    /**
+     * Execute a query and return the first row or null
+     *
+     * @param sql - SQL query string
+     * @param params - Parameter values
+     * @param options - Execution options
+     * @returns Result containing single row or null
+     */
+    executeOne<T = unknown>(sql: string, params?: unknown[], options?: ExecutionOptions): Promise<Result<T | null, RawSQLError>>;
+    /**
+     * Execute multiple queries in batch
+     *
+     * All queries execute sequentially. If any query fails, execution stops
+     * and an error is returned.
+     *
+     * @param queries - Array of SQL queries with parameters
+     * @returns Result containing array of results or error
+     */
+    executeBatch<T = unknown>(queries: SQLQuery[]): Promise<Result<T[][], RawSQLError>>;
+    /**
+     * Validate SQL query and parameters
+     *
+     * Checks for:
+     * - Empty/whitespace-only queries
+     * - Parameter count matching placeholder count
+     *
+     * @param sql - SQL query string
+     * @param params - Parameter values
+     * @returns Result indicating validation success or error
+     */
+    private validateSQL;
+}
+//# sourceMappingURL=raw.d.ts.map

package/dist/query/raw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/query/raw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAE1F;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9C,uBAAuB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,UAAU,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM;IAK1D;;;;;;;;;;OAUG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAyDpC;;;;;;;OAOG;IACG,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1B,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC;IAWzC;;;;;;;;OAQG;IACG,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5B,OAAO,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;IAsCtC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;CAsBpB"}

package/dist/tenant/context.d.ts

@@ -0,0 +1,52 @@
+import { Option, Logger } from '@gl-life/gl-life-core';
+import type { TenantContext, TenantMetadata, TenantContextConfig } from '../types/tenant.js';
+/**
+ * Tenant Context Manager
+ *
+ * Manages multi-tenancy context using AsyncLocalStorage for request isolation.
+ * Supports multiple isolation strategies: DATABASE, SCHEMA, ROW, and HYBRID.
+ *
+ * Features:
+ * - AsyncLocalStorage for context isolation (Cloudflare Workers compatible)
+ * - Multiple isolation strategies
+ * - Automatic SQL query modification for tenant isolation
+ * - Tenant validation
+ * - Scoped execution with withTenant()
+ */
+export declare class TenantContextManager implements TenantContext {
+    private readonly storage;
+    private readonly _config;
+    private readonly logger;
+    private currentTenant;
+    constructor(config: TenantContextConfig, logger: Logger);
+    get tenant(): Option<TenantMetadata>;
+    get config(): TenantContextConfig;
+    get hasTenant(): boolean;
+    setTenant(tenantId: string): Promise<void>;
+    setTenantWithMetadata(metadata: TenantMetadata): Promise<void>;
+    clearTenant(): Promise<void>;
+    getTenantId(): Option<string>;
+    getTenant(): Option<TenantMetadata>;
+    shouldIsolateTable(table: string): boolean;
+    applyTenantIsolation(sql: string, params?: unknown[]): {
+        sql: string;
+        params: unknown[];
+    };
+    getTenantDatabase(): Option<string>;
+    getTenantSchema(): Option<string>;
+    withTenant<T>(tenantId: string, callback: () => Promise<T>): Promise<T>;
+    clone(): TenantContext;
+    /**
+     * Validate tenant ID format
+     */
+    private validateTenantId;
+    /**
+     * Apply ROW-level tenant isolation to SQL query
+     */
+    private applyRowLevelIsolation;
+    /**
+     * Apply SCHEMA-level tenant isolation to SQL query
+     */
+    private applySchemaIsolation;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/tenant/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tenant/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAS5B;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,aAAa,CAA+B;gBAExC,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM;IAMvD,IAAI,MAAM,IAAI,MAAM,CAAC,cAAc,CAAC,CAEnC;IAED,IAAI,MAAM,IAAI,mBAAmB,CAEhC;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1C,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAW9D,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC;IAO7B,SAAS,IAAI,MAAM,CAAC,cAAc,CAAC;IAOnC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAc1C,oBAAoB,CAClB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE;IA0CrC,iBAAiB,IAAI,MAAM,CAAC,MAAM,CAAC;IAiBnC,eAAe,IAAI,MAAM,CAAC,MAAM,CAAC;IAiB3B,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAsB7E,KAAK,IAAI,aAAa;IAItB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiE9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CA2B7B"}

package/dist/tenant/index.d.ts

@@ -0,0 +1,4 @@
+export * from './context.js';
+export * from './query-wrapper.js';
+export * from './schema-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tenant/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/tenant/query-wrapper.d.ts

@@ -0,0 +1,96 @@
+import { Result, Logger } from '@gl-life/gl-life-core';
+import type { QueryBuilder, QueryBuilderError, WhereOperator, JoinType, OrderDirection } from '../types/query-builder.js';
+import type { TenantContext } from '../types/tenant.js';
+/**
+ * Tenant-Aware Query Builder
+ *
+ * Wraps a QueryBuilder to automatically inject tenant filters and prevent
+ * cross-tenant data access. Provides:
+ * - Automatic tenant_id filter injection for all queries
+ * - Cross-tenant access prevention
+ * - Admin override mechanism via asAdmin()
+ * - Tenant filter enforcement (cannot be accidentally removed)
+ * - Support for excluded tables (migrations, system tables)
+ *
+ * Security:
+ * - All queries automatically scoped to current tenant
+ * - Tenant context validated before query execution
+ * - Manual tenant_id in WHERE clauses are overridden
+ * - INSERT operations always use current tenant_id
+ *
+ * Usage:
+ * ```typescript
+ * const builder = new TenantAwareQueryBuilder(baseBuilder, tenantContext, logger);
+ *
+ * // Normal tenant-scoped query
+ * const users = await builder.select('id', 'name').get();
+ *
+ * // Admin query (bypasses tenant filter)
+ * const allUsers = await builder.asAdmin().select('id', 'name').get();
+ * ```
+ */
+export declare class TenantAwareQueryBuilder<T = unknown> implements QueryBuilder<T> {
+    private readonly baseBuilder;
+    private readonly tenantContext;
+    private readonly logger;
+    private isAdminMode;
+    constructor(baseBuilder: QueryBuilder<T>, tenantContext: TenantContext, logger: Logger);
+    /**
+     * Switch to admin mode - bypasses tenant filtering
+     *
+     * Use with caution! Only for administrative queries that need
+     * to access data across all tenants.
+     *
+     * @returns QueryBuilder in admin mode
+     */
+    asAdmin(): TenantAwareQueryBuilder<T>;
+    /**
+     * Switch back to tenant mode from admin mode
+     *
+     * Re-enables automatic tenant filtering
+     *
+     * @returns QueryBuilder in tenant mode
+     */
+    asTenant(): TenantAwareQueryBuilder<T>;
+    /**
+     * Validate that tenant context is set (unless admin mode or excluded table)
+     */
+    private validateTenantContext;
+    /**
+     * Get table name from base builder
+     */
+    private getTableName;
+    /**
+     * Inject tenant filter into query builder
+     *
+     * This method ensures the correct tenant filter is present.
+     * If a manual tenant_id filter exists, it will be overridden.
+     */
+    private injectTenantFilter;
+    /**
+     * Override tenant_id in data object for INSERT operations
+     */
+    private enforceTenantInData;
+    table(table: string): QueryBuilder<T>;
+    select(...columns: string[]): QueryBuilder<T>;
+    where(field: string, operator: WhereOperator, value?: unknown): QueryBuilder<T>;
+    orWhere(field: string, operator: WhereOperator, value?: unknown): QueryBuilder<T>;
+    whereIn(field: string, values: unknown[]): QueryBuilder<T>;
+    join(table: string, leftField: string, rightField: string, type?: JoinType): QueryBuilder<T>;
+    orderBy(field: string, direction?: OrderDirection): QueryBuilder<T>;
+    groupBy(...fields: string[]): QueryBuilder<T>;
+    having(condition: string): QueryBuilder<T>;
+    limit(limit: number): QueryBuilder<T>;
+    offset(offset: number): QueryBuilder<T>;
+    insert(data: Partial<T>): Promise<Result<T, QueryBuilderError>>;
+    insertMany(data: Partial<T>[]): Promise<Result<T[], QueryBuilderError>>;
+    update(data: Partial<T>): Promise<Result<number, QueryBuilderError>>;
+    delete(): Promise<Result<number, QueryBuilderError>>;
+    first(): Promise<Result<T | null, QueryBuilderError>>;
+    get(): Promise<Result<T[], QueryBuilderError>>;
+    count(field?: string): Promise<Result<number, QueryBuilderError>>;
+    toSQL(): string;
+    getBindings(): unknown[];
+    clone(): QueryBuilder<T>;
+}
+//# sourceMappingURL=query-wrapper.d.ts.map

package/dist/tenant/query-wrapper.d.ts.map

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