@umituz/react-native-firebase 2.6.1 → 2.6.2

package/src/domains/firestore/domain/services/QueryService_part_aa

@@ -0,0 +1,150 @@
+/**
+ * Query Service (Main Builder)
+ * Single Responsibility: Build and validate Firestore queries
+ *
+ * Domain service that encapsulates query building logic.
+ * Moves business logic from infrastructure to domain layer.
+ *
+ * Max lines: 150 (enforced for maintainability)
+ */
+
+import type { Query, Firestore, WhereFilterOp } from 'firebase/firestore';
+import { collection, query, where, orderBy, limit, startAfter, startAt } from 'firebase/firestore';
+import { QueryOptions, createQueryOptions } from '../value-objects/QueryOptions';
+import { WhereClause } from '../value-objects/WhereClause';
+
+/**
+ * Query builder result
+ */
+export interface QueryBuilderResult {
+  readonly query: Query;
+  readonly options: QueryOptions;
+}
+
+/**
+ * Query service
+ * Provides query building and validation functionality
+ */
+export class QueryService {
+  private readonly db: Firestore;
+
+  constructor(db: Firestore) {
+    this.db = db;
+  }
+
+  /**
+   * Build a query from options
+   * Main method for query construction
+   */
+  buildQuery(collectionPath: string, options: QueryOptions): QueryBuilderResult {
+    const validation = options.validate();
+    if (!validation.valid) {
+      throw new Error(`Invalid query options: ${validation.errors.join(', ')}`);
+    }
+
+    const collectionRef = collection(this.db, collectionPath);
+    let q: Query = collectionRef;
+
+    // Apply where clauses
+    for (const clause of options.whereClauses) {
+      q = query(q, where(clause.field, clause.operator, clause.value));
+    }
+
+    // Apply sort options
+    for (const sort of options.sortOptions) {
+      q = query(q, orderBy(sort.field, sort.direction));
+    }
+
+    // Apply date range
+    if (options.dateRange) {
+      const { field, startDate, endDate } = options.dateRange;
+      if (startDate) {
+        q = query(q, where(field, '>=', startDate));
+      }
+      if (endDate) {
+        q = query(q, where(field, '<=', endDate));
+      }
+    }
+
+    // Apply pagination
+    if (options.pagination) {
+      const { cursor, limit: limitValue, startAfter: startAfterValue, startAt: startAtValue } = options.pagination;
+
+      if (startAfterValue !== undefined) {
+        q = query(q, startAfter(startAfterValue));
+      }
+
+      if (startAtValue !== undefined) {
+        q = query(q, startAt(startAtValue));
+      }
+
+      if (limitValue !== undefined) {
+        q = query(q, limit(limitValue));
+      }
+    }
+
+    return { query: q, options };
+  }
+
+  /**
+   * Build simple query with single where clause
+   */
+  buildSimpleQuery(
+    collectionPath: string,
+    field: string,
+    operator: WhereFilterOp,
+    value: unknown
+  ): Query {
+    const options = createQueryOptions({
+      where: [WhereClause.create(field, operator, value)],
+    });
+
+    return this.buildQuery(collectionPath, options).query;
+  }
+
+  /**
+   * Build query with equality filter
+   */
+  buildEqualsQuery(collectionPath: string, field: string, value: unknown): Query {
+    return this.buildSimpleQuery(collectionPath, field, '==', value);
+  }
+
+  /**
+   * Build query with multiple equality filters
+   */
+  buildMultiEqualsQuery(
+    collectionPath: string,
+    filters: Record<string, unknown>
+  ): Query {
+    const whereClauses = Object.entries(filters).map(([field, value]) =>
+      WhereClause.equals(field, value)
+    );
+
+    const options = createQueryOptions({ where: whereClauses });
+    return this.buildQuery(collectionPath, options).query;
+  }
+
+  /**
+   * Build query with sorting
+   */
+  buildSortedQuery(
+    collectionPath: string,
+    sortField: string,
+    direction: 'asc' | 'desc' = 'asc'
+  ): Query {
+    const options = createQueryOptions({
+      sort: [{ field: sortField, direction }],
+    });
+
+    return this.buildQuery(collectionPath, options).query;
+  }
+
+  /**
+   * Build query with limit
+   */
+  buildLimitedQuery(collectionPath: string, limitValue: number): Query {
+    const options = createQueryOptions({
+      pagination: { limit: limitValue },
+    });
+
+    return this.buildQuery(collectionPath, options).query;

package/src/domains/firestore/domain/services/QueryService_part_ab

@@ -0,0 +1,32 @@
+  }
+
+  /**
+   * Build query with date range
+   */
+  buildDateRangeQuery(
+    collectionPath: string,
+    field: string,
+    startDate?: Date,
+    endDate?: Date
+  ): Query {
+    const options = createQueryOptions({
+      dateRange: { field, startDate, endDate },
+    });
+
+    return this.buildQuery(collectionPath, options).query;
+  }
+
+  /**
+   * Validate query options
+   */
+  validateOptions(options: QueryOptions): { valid: boolean; errors: string[] } {
+    return options.validate();
+  }
+
+  /**
+   * Check if query is empty (no filters)
+   */
+  isEmptyQuery(options: QueryOptions): boolean {
+    return options.isEmpty();
+  }
+}

package/src/domains/firestore/domain/value-objects/QueryOptions.ts.bak

@@ -1,5 +1,5 @@
 /**
- * Query Options Value Object
+ * Query Options Value Object (Main)
  * Single Responsibility: Encapsulate query configuration options
  *
  * Value object that represents query options in a type-safe way.
@@ -89,7 +89,7 @@ export class QueryOptions {
    */
   withWhere(clause: WhereClause): QueryOptions {
     return new QueryOptions(
-      [...this.whereClauses, clause] as WhereClause[] as WhereClause[],
+      [...this.whereClauses, clause] as WhereClause[],
       this.sortOptions,
       this.dateRange,
       this.pagination
@@ -160,135 +160,6 @@ export class QueryOptions {
     return new QueryOptions(this.whereClauses, this.sortOptions, this.dateRange, null);
   }
 
-  /**
-   * Check if has any where clauses
-   */
-  hasWhereClauses(): boolean {
-    return this.whereClauses.length > 0;
-  }
-
-  /**
-   * Check if has any sort options
-   */
-  hasSort(): boolean {
-    return this.sortOptions.length > 0;
-  }
-
-  /**
-   * Check if has date range
-   */
-  hasDateRange(): boolean {
-    return this.dateRange !== null;
-  }
-
-  /**
-   * Check if has pagination
-   */
-  hasPagination(): boolean {
-    return this.pagination !== null;
-  }
-
-  /**
-   * Check if is empty (no options set)
-   */
-  isEmpty(): boolean {
-    return !this.hasWhereClauses() &&
-           !this.hasSort() &&
-           !this.hasDateRange() &&
-           !this.hasPagination();
-  }
-
-  /**
-   * Validate query options
-   */
-  validate(): { valid: boolean; errors: string[] } {
-    const errors: string[] = [];
-
-    // Validate where clauses
-    for (const clause of this.whereClauses) {
-      const clauseValidation = clause.validate();
-      if (!clauseValidation.valid) {
-        errors.push(...clauseValidation.errors);
-      }
-    }
-
-    // Validate sort options
-    for (const sort of this.sortOptions) {
-      if (!sort.field || typeof sort.field !== 'string') {
-        errors.push('Sort field must be a non-empty string');
-      }
-      if (sort.direction !== 'asc' && sort.direction !== 'desc') {
-        errors.push('Sort direction must be "asc" or "desc"');
-      }
-    }
-
-    // Validate date range
-    if (this.dateRange) {
-      if (!this.dateRange.field || typeof this.dateRange.field !== 'string') {
-        errors.push('Date range field must be a non-empty string');
-      }
-      if (this.dateRange.startDate && !(this.dateRange.startDate instanceof Date)) {
-        errors.push('Start date must be a Date instance');
-      }
-      if (this.dateRange.endDate && !(this.dateRange.endDate instanceof Date)) {
-        errors.push('End date must be a Date instance');
-      }
-      if (
-        this.dateRange.startDate &&
-        this.dateRange.endDate &&
-        this.dateRange.startDate > this.dateRange.endDate
-      ) {
-        errors.push('Start date must be before end date');
-      }
-    }
-
-    // Validate pagination
-    if (this.pagination) {
-      if (this.pagination.limit !== undefined && (typeof this.pagination.limit !== 'number' || this.pagination.limit <= 0)) {
-        errors.push('Pagination limit must be a positive number');
-      }
-    }
-
-    return {
-      valid: errors.length === 0,
-      errors,
-    };
-  }
-
-  /**
-   * Convert to plain object (for serialization)
-   */
-  toObject(): {
-    where: WhereClause[];
-    sort: SortOptions[];
-    dateRange: DateRangeOptions | null;
-    pagination: PaginationOptions | null;
-  } {
-    return {
-      where: [...this.whereClauses] as WhereClause[],
-      sort: [...this.sortOptions] as SortOptions[],
-      dateRange: this.dateRange,
-      pagination: this.pagination,
-    };
-  }
-
-  /**
-   * Create from plain object
-   */
-  static fromObject(obj: {
-    where?: Array<{ field: string; operator: WhereFilterOp; value: unknown }>;
-    sort?: SortOptions[];
-    dateRange?: DateRangeOptions;
-    pagination?: PaginationOptions;
-  }): QueryOptions {
-    return QueryOptions.create({
-      where: obj.where?.map(w => WhereClause.create(w.field, w.operator, w.value)) || [],
-      sort: obj.sort || [],
-      dateRange: obj.dateRange || null,
-      pagination: obj.pagination || null,
-    });
-  }
-
   /**
    * Clone with modifications
    */
@@ -299,10 +170,10 @@ export class QueryOptions {
     pagination?: PaginationOptions | null;
   }): QueryOptions {
     return QueryOptions.create({
-      where: modifications.where ?? this.whereClauses,
-      sort: modifications.sort ?? this.sortOptions,
-      dateRange: modifications.dateRange ?? this.dateRange,
-      pagination: modifications.pagination ?? this.pagination,
+      where: modifications.where ?? [...this.whereClauses] as WhereClause[],
+      sort: modifications.sort ?? [...this.sortOptions] as SortOptions[],
+      dateRange: modifications.dateRange ?? this.dateRange ?? null,
+      pagination: modifications.pagination ?? this.pagination ?? null,
     });
   }
 }

package/src/domains/firestore/domain/value-objects/QueryOptionsSerialization_part_aa

@@ -0,0 +1,150 @@
+/**
+ * Query Options Serialization
+ * Single Responsibility: Handle serialization and conversion
+ *
+ * Serialization and conversion utilities for QueryOptions.
+ * Separated for better maintainability.
+ *
+ * Max lines: 150 (enforced for maintainability)
+ */
+
+import { QueryOptions, createQueryOptions } from './QueryOptions';
+import { WhereClause } from './WhereClause';
+import type { SortOptions, DateRangeOptions, PaginationOptions } from './QueryOptions';
+
+/**
+ * Convert to plain object (for serialization)
+ */
+export function toObject(options: QueryOptions): {
+  where: WhereClause[];
+  sort: SortOptions[];
+  dateRange: DateRangeOptions | null;
+  pagination: PaginationOptions | null;
+} {
+  return {
+    where: [...options.whereClauses],
+    sort: [...options.sortOptions],
+    dateRange: options.dateRange,
+    pagination: options.pagination,
+  };
+}
+
+/**
+ * Create from plain object
+ */
+export function fromObject(obj: {
+  where?: Array<{ field: string; operator: string; value: unknown }>;
+  sort?: SortOptions[];
+  dateRange?: DateRangeOptions;
+  pagination?: PaginationOptions;
+}): QueryOptions {
+  return QueryOptions.create({
+    where: obj.where?.map(w => WhereClause.create(w.field, w.operator as any, w.value)) || [],
+    sort: obj.sort || [],
+    dateRange: obj.dateRange || null,
+    pagination: obj.pagination || null,
+  });
+}
+
+/**
+ * Create from filters object (simplified)
+ */
+export function fromFilters(filters: Record<string, unknown>): QueryOptions {
+  const whereClauses = Object.entries(filters).map(([field, value]) =>
+    WhereClause.equals(field, value)
+  );
+
+  return QueryOptions.create({ where: whereClauses });
+}
+
+/**
+ * Merge multiple query options
+ */
+export function mergeOptions(...options: QueryOptions[]): QueryOptions {
+  if (options.length === 0) {
+    return createQueryOptions();
+  }
+
+  if (options.length === 1) {
+    return options[0];
+  }
+
+  const merged = options.reduce((acc, opt) => {
+    return QueryOptions.create({
+      where: [...acc.whereClauses, ...opt.whereClauses] as WhereClause[],
+      sort: opt.sortOptions.length > 0 ? [...opt.sortOptions] as any[] : [...acc.sortOptions] as any[],
+      dateRange: opt.dateRange ?? acc.dateRange,
+      pagination: opt.pagination ?? acc.pagination,
+    });
+  });
+
+  return merged ?? createQueryOptions();
+}
+
+/**
+ * Create paginated query options
+ */
+export function createPaginatedOptions(limit: number, cursor?: number): QueryOptions {
+  return createQueryOptions({
+    pagination: { limit, cursor },
+  });
+}
+
+/**
+ * Create sorted query options
+ */
+export function createSortedOptions(
+  field: string,
+  direction: 'asc' | 'desc' = 'asc'
+): QueryOptions {
+  return createQueryOptions({
+    sort: [{ field, direction }],
+  });
+}
+
+/**
+ * Create date range query options
+ */
+export function createDateRangeOptions(
+  field: string,
+  startDate?: Date,
+  endDate?: Date
+): QueryOptions {
+  return createQueryOptions({
+    dateRange: { field, startDate, endDate },
+  });
+}
+
+/**
+ * Clone query options with safety checks
+ */
+export function cloneSafe(options: QueryOptions, defaults?: Partial<{
+  where: WhereClause[];
+  sort: SortOptions[];
+  dateRange: DateRangeOptions;
+  pagination: PaginationOptions;
+}>): QueryOptions {
+  return QueryOptions.create({
+    where: options.whereClauses.length > 0 ? [...options.whereClauses] as WhereClause[] : defaults?.where || [],
+    sort: options.sortOptions.length > 0 ? [...options.sortOptions] as SortOptions[] : defaults?.sort || [],
+    dateRange: options.dateRange ?? defaults?.dateRange ?? null,
+    pagination: options.pagination ?? defaults?.pagination ?? null,
+  });
+}
+
+/**
+ * Strip pagination from options
+ */
+export function withoutPagination(options: QueryOptions): QueryOptions {
+  return QueryOptions.create({
+    where: [...options.whereClauses] as WhereClause[],
+    sort: [...options.sortOptions] as SortOptions[],
+    dateRange: options.dateRange,
+    pagination: null,
+  });
+}
+
+/**
+ * Strip sort from options
+ */
+export function withoutSort(options: QueryOptions): QueryOptions {

package/src/domains/firestore/domain/value-objects/QueryOptionsSerialization_part_ab

@@ -0,0 +1,57 @@
+  return QueryOptions.create({
+    where: [...options.whereClauses] as WhereClause[],
+    sort: [],
+    dateRange: options.dateRange,
+    pagination: options.pagination,
+  });
+}
+
+/**
+ * Strip date range from options
+ */
+export function withoutDateRange(options: QueryOptions): QueryOptions {
+  return QueryOptions.create({
+    where: [...options.whereClauses] as WhereClause[],
+    sort: [...options.sortOptions] as SortOptions[],
+    dateRange: null,
+    pagination: options.pagination,
+  });
+}
+
+/**
+ * Strip where clauses from options
+ */
+export function withoutWhere(options: QueryOptions): QueryOptions {
+  return QueryOptions.create({
+    where: [],
+    sort: [...options.sortOptions] as SortOptions[],
+    dateRange: options.dateRange,
+    pagination: options.pagination,
+  });
+}
+
+/**
+ * Add limit to existing options
+ */
+export function withLimit(options: QueryOptions, limit: number): QueryOptions {
+  const currentPagination = options.pagination || {};
+  return QueryOptions.create({
+    where: [...options.whereClauses] as WhereClause[],
+    sort: [...options.sortOptions] as SortOptions[],
+    dateRange: options.dateRange,
+    pagination: { ...currentPagination, limit },
+  });
+}
+
+/**
+ * Add cursor to existing options
+ */
+export function withCursor(options: QueryOptions, cursor: number): QueryOptions {
+  const currentPagination = options.pagination || {};
+  return QueryOptions.create({
+    where: [...options.whereClauses] as WhereClause[],
+    sort: [...options.sortOptions] as SortOptions[],
+    dateRange: options.dateRange,
+    pagination: { ...currentPagination, cursor },
+  });
+}

package/src/domains/firestore/domain/value-objects/QueryOptionsValidation_part_aa

@@ -0,0 +1,150 @@
+/**
+ * Query Options Validation
+ * Single Responsibility: Validate and check query options
+ *
+ * Validation and type checking functionality for QueryOptions.
+ * Separated for better maintainability.
+ *
+ * Max lines: 150 (enforced for maintainability)
+ */
+
+import { QueryOptions } from './QueryOptions';
+
+/**
+ * Validate query options
+ */
+export function validateOptions(options: QueryOptions): { valid: boolean; errors: string[] } {
+  const errors: string[] = [];
+
+  // Validate where clauses
+  for (const clause of options.whereClauses) {
+    const clauseValidation = clause.validate();
+    if (!clauseValidation.valid) {
+      errors.push(...clauseValidation.errors);
+    }
+  }
+
+  // Validate sort options
+  for (const sort of options.sortOptions) {
+    if (!sort.field || typeof sort.field !== 'string') {
+      errors.push('Sort field must be a non-empty string');
+    }
+    if (sort.direction !== 'asc' && sort.direction !== 'desc') {
+      errors.push('Sort direction must be "asc" or "desc"');
+    }
+  }
+
+  // Validate date range
+  if (options.dateRange) {
+    if (!options.dateRange.field || typeof options.dateRange.field !== 'string') {
+      errors.push('Date range field must be a non-empty string');
+    }
+    if (options.dateRange.startDate && !(options.dateRange.startDate instanceof Date)) {
+      errors.push('Start date must be a Date instance');
+    }
+    if (options.dateRange.endDate && !(options.dateRange.endDate instanceof Date)) {
+      errors.push('End date must be a Date instance');
+    }
+    if (
+      options.dateRange.startDate &&
+      options.dateRange.endDate &&
+      options.dateRange.startDate > options.dateRange.endDate
+    ) {
+      errors.push('Start date must be before end date');
+    }
+  }
+
+  // Validate pagination
+  if (options.pagination) {
+    if (options.pagination.limit !== undefined && (typeof options.pagination.limit !== 'number' || options.pagination.limit <= 0)) {
+      errors.push('Pagination limit must be a positive number');
+    }
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors,
+  };
+}
+
+/**
+ * Check if has any where clauses
+ */
+export function hasWhereClauses(options: QueryOptions): boolean {
+  return options.whereClauses.length > 0;
+}
+
+/**
+ * Check if has any sort options
+ */
+export function hasSort(options: QueryOptions): boolean {
+  return options.sortOptions.length > 0;
+}
+
+/**
+ * Check if has date range
+ */
+export function hasDateRange(options: QueryOptions): boolean {
+  return options.dateRange !== null;
+}
+
+/**
+ * Check if has pagination
+ */
+export function hasPagination(options: QueryOptions): boolean {
+  return options.pagination !== null;
+}
+
+/**
+ * Check if is empty (no options set)
+ */
+export function isEmpty(options: QueryOptions): boolean {
+  return !hasWhereClauses(options) &&
+         !hasSort(options) &&
+         !hasDateRange(options) &&
+         !hasPagination(options);
+}
+
+/**
+ * Check if options have date range filter
+ */
+export function hasDateFilter(options: QueryOptions): boolean {
+  return hasDateRange(options);
+}
+
+/**
+ * Check if options have limit set
+ */
+export function hasLimit(options: QueryOptions): boolean {
+  return options.pagination?.limit !== undefined;
+}
+
+/**
+ * Check if options have cursor set
+ */
+export function hasCursor(options: QueryOptions): boolean {
+  return options.pagination?.cursor !== undefined;
+}
+
+/**
+ * Check if options are valid for compound queries
+ */
+export function isValidForCompoundQuery(options: QueryOptions): boolean {
+  // Check for array/membership operator conflicts
+  const arrayCount = options.whereClauses.filter(c => c.isArrayOperator() || c.isMembership()).length;
+
+  if (arrayCount > 1) {
+    return false;
+  }
+
+  return validateOptions(options).valid;
+}
+
+/**
+ * Check if options are ready for execution
+ */
+export function isReadyToExecute(options: QueryOptions): boolean {
+  if (!validateOptions(options).valid) {
+    return false;
+  }
+