@proseql/core 0.1.0

package/dist/types/database-config-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-config-types.js","sourceRoot":"","sources":["../../src/types/database-config-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkLH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACrC,MAAwB;IAExB,OAAO,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AAClE,CAAC"}

package/dist/types/hook-types.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Lifecycle hook types for CRUD operations.
+ * Hooks intercept operations before/after mutation for transformation, validation, or side effects.
+ */
+import type { Effect } from "effect";
+import type { HookError } from "../errors/crud-errors.js";
+import type { UpdateWithOperators } from "./crud-types.js";
+/**
+ * Context provided to beforeCreate hooks.
+ * The hook receives the validated entity about to be inserted and can transform it.
+ */
+export interface BeforeCreateContext<T> {
+    readonly operation: "create";
+    readonly collection: string;
+    readonly data: T;
+}
+/**
+ * Context provided to beforeUpdate hooks.
+ * The hook receives the current entity state and the update payload, and can transform the update.
+ */
+export interface BeforeUpdateContext<T> {
+    readonly operation: "update";
+    readonly collection: string;
+    readonly id: string;
+    readonly existing: T;
+    readonly update: UpdateWithOperators<T>;
+}
+/**
+ * Context provided to beforeDelete hooks.
+ * The hook can inspect the entity about to be deleted and reject if needed.
+ */
+export interface BeforeDeleteContext<T> {
+    readonly operation: "delete";
+    readonly collection: string;
+    readonly id: string;
+    readonly entity: T;
+}
+/**
+ * Context provided to afterCreate hooks.
+ * Contains the entity as it was stored after the create operation.
+ */
+export interface AfterCreateContext<T> {
+    readonly operation: "create";
+    readonly collection: string;
+    readonly entity: T;
+}
+/**
+ * Context provided to afterUpdate hooks.
+ * Contains both previous and current state to enable diffing.
+ */
+export interface AfterUpdateContext<T> {
+    readonly operation: "update";
+    readonly collection: string;
+    readonly id: string;
+    readonly previous: T;
+    readonly current: T;
+    readonly update: UpdateWithOperators<T>;
+}
+/**
+ * Context provided to afterDelete hooks.
+ * Contains the entity that was deleted.
+ */
+export interface AfterDeleteContext<T> {
+    readonly operation: "delete";
+    readonly collection: string;
+    readonly id: string;
+    readonly entity: T;
+}
+/**
+ * Context for onCreate change event.
+ */
+export interface OnChangeCreateContext<T> {
+    readonly type: "create";
+    readonly collection: string;
+    readonly entity: T;
+}
+/**
+ * Context for onUpdate change event.
+ */
+export interface OnChangeUpdateContext<T> {
+    readonly type: "update";
+    readonly collection: string;
+    readonly id: string;
+    readonly previous: T;
+    readonly current: T;
+}
+/**
+ * Context for onDelete change event.
+ */
+export interface OnChangeDeleteContext<T> {
+    readonly type: "delete";
+    readonly collection: string;
+    readonly id: string;
+    readonly entity: T;
+}
+/**
+ * Discriminated union of all change contexts.
+ * The `type` field discriminates between create, update, and delete events.
+ */
+export type OnChangeContext<T> = OnChangeCreateContext<T> | OnChangeUpdateContext<T> | OnChangeDeleteContext<T>;
+/**
+ * Before-hook for create operations.
+ * Receives the validated entity about to be inserted and can transform it.
+ * Return the (possibly transformed) entity, or fail with HookError to abort.
+ */
+export type BeforeCreateHook<T> = (ctx: BeforeCreateContext<T>) => Effect.Effect<T, HookError>;
+/**
+ * Before-hook for update operations.
+ * Receives the current entity state and the update payload.
+ * Return the (possibly transformed) update payload, or fail with HookError to abort.
+ */
+export type BeforeUpdateHook<T> = (ctx: BeforeUpdateContext<T>) => Effect.Effect<UpdateWithOperators<T>, HookError>;
+/**
+ * Before-hook for delete operations.
+ * Can inspect the entity about to be deleted and reject if needed.
+ * Return void to proceed, or fail with HookError to abort.
+ */
+export type BeforeDeleteHook<T> = (ctx: BeforeDeleteContext<T>) => Effect.Effect<void, HookError>;
+/**
+ * After-hook for create operations.
+ * Receives the entity as it was stored. Used for side effects.
+ * Errors are swallowed (fire-and-forget) - hooks may fail but failures are ignored.
+ */
+export type AfterCreateHook<T> = (ctx: AfterCreateContext<T>) => Effect.Effect<void, unknown>;
+/**
+ * After-hook for update operations.
+ * Receives both previous and current state to enable diffing.
+ * Errors are swallowed (fire-and-forget) - hooks may fail but failures are ignored.
+ */
+export type AfterUpdateHook<T> = (ctx: AfterUpdateContext<T>) => Effect.Effect<void, unknown>;
+/**
+ * After-hook for delete operations.
+ * Receives the entity that was deleted.
+ * Errors are swallowed (fire-and-forget) - hooks may fail but failures are ignored.
+ */
+export type AfterDeleteHook<T> = (ctx: AfterDeleteContext<T>) => Effect.Effect<void, unknown>;
+/**
+ * Generic change hook that fires after any mutation.
+ * Receives a discriminated union context with type "create", "update", or "delete".
+ * Errors are swallowed (fire-and-forget) - hooks may fail but failures are ignored.
+ */
+export type OnChangeHook<T> = (ctx: OnChangeContext<T>) => Effect.Effect<void, unknown>;
+/**
+ * Configuration object for lifecycle hooks on a collection.
+ * All fields are optional. Missing fields mean no hooks for that lifecycle point.
+ * Hooks run in array order: before-hooks chain (each receives previous output),
+ * after-hooks and onChange run independently (fire-and-forget).
+ */
+export interface HooksConfig<T> {
+    readonly beforeCreate?: ReadonlyArray<BeforeCreateHook<T>>;
+    readonly afterCreate?: ReadonlyArray<AfterCreateHook<T>>;
+    readonly beforeUpdate?: ReadonlyArray<BeforeUpdateHook<T>>;
+    readonly afterUpdate?: ReadonlyArray<AfterUpdateHook<T>>;
+    readonly beforeDelete?: ReadonlyArray<BeforeDeleteHook<T>>;
+    readonly afterDelete?: ReadonlyArray<AfterDeleteHook<T>>;
+    readonly onChange?: ReadonlyArray<OnChangeHook<T>>;
+}
+//# sourceMappingURL=hook-types.d.ts.map

package/dist/types/hook-types.d.ts.map

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

package/dist/types/hook-types.js

@@ -0,0 +1,6 @@
+/**
+ * Lifecycle hook types for CRUD operations.
+ * Hooks intercept operations before/after mutation for transformation, validation, or side effects.
+ */
+export {};
+//# sourceMappingURL=hook-types.js.map

package/dist/types/hook-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-types.js","sourceRoot":"","sources":["../../src/types/hook-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/index-types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Types for indexing functionality.
+ *
+ * Indexes accelerate equality queries by maintaining a reverse mapping
+ * from field values to entity IDs.
+ */
+import type { Ref } from "effect";
+/**
+ * An index mapping field values to sets of entity IDs.
+ *
+ * For single-field indexes, the key is the field value directly.
+ * For compound indexes, the key is a JSON.stringify'd array of field values.
+ *
+ * The Set<string> contains entity IDs that have that particular value combination.
+ */
+export type IndexMap = Map<unknown, Set<string>>;
+/**
+ * A reference to an index that can be updated atomically.
+ * Used to maintain consistency between data mutations and index updates.
+ */
+export type IndexRef = Ref.Ref<IndexMap>;
+/**
+ * All indexes for a collection, keyed by the normalized index name.
+ *
+ * The key is a JSON.stringify'd array of field names for consistency:
+ * - Single field "email" -> key is '["email"]'
+ * - Compound ["userId", "category"] -> key is '["userId","category"]'
+ */
+export type CollectionIndexes = Map<string, IndexRef>;
+/**
+ * An index definition normalized to array form.
+ *
+ * User input can be:
+ * - "email" (single field)
+ * - ["userId", "category"] (compound)
+ *
+ * Both normalize to ReadonlyArray<string>:
+ * - "email" -> ["email"]
+ * - ["userId", "category"] -> ["userId", "category"]
+ */
+export type NormalizedIndex = ReadonlyArray<string>;
+//# sourceMappingURL=index-types.d.ts.map

package/dist/types/index-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-types.d.ts","sourceRoot":"","sources":["../../src/types/index-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC"}

package/dist/types/index-types.js

@@ -0,0 +1,8 @@
+/**
+ * Types for indexing functionality.
+ *
+ * Indexes accelerate equality queries by maintaining a reverse mapping
+ * from field values to entity IDs.
+ */
+export {};
+//# sourceMappingURL=index-types.js.map

package/dist/types/index-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-types.js","sourceRoot":"","sources":["../../src/types/index-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/operators.d.ts

@@ -0,0 +1,5 @@
+import type { CustomOperator } from "../plugins/plugin-types.js";
+import type { FilterOperators } from "./types.js";
+export declare function isFilterOperatorObject<T>(filter: T | FilterOperators<T>, customOperators?: Map<string, CustomOperator>): filter is FilterOperators<T>;
+export declare function matchesFilter<T>(value: T, filter: T | FilterOperators<T>, customOperators?: Map<string, CustomOperator>): boolean;
+//# sourceMappingURL=operators.d.ts.map

package/dist/types/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../src/types/operators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkHlD,wBAAgB,sBAAsB,CAAC,CAAC,EACvC,MAAM,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAC9B,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAC3C,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAqB9B;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAC9B,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAC9B,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAC3C,OAAO,CAqQT"}

package/dist/types/operators.js

@@ -0,0 +1,297 @@
+import { tokenize } from "../operations/query/search.js";
+// ============================================================================
+// Modular Operator Checking Functions
+// ============================================================================
+// Universal operators that work with all types
+function checkUniversalOperator(value, operator, operand, hasOperator) {
+    // If operator is not present in the object, return null
+    if (!hasOperator)
+        return null;
+    switch (operator) {
+        case "$eq":
+            return value === operand;
+        case "$ne":
+            return value !== operand;
+        case "$in":
+            return Array.isArray(operand) && operand.includes(value);
+        case "$nin":
+            return Array.isArray(operand) && !operand.includes(value);
+    }
+}
+// String-specific operators
+function checkStringOperator(value, operator, operand, hasOperator) {
+    if (!hasOperator)
+        return null;
+    if (operand === undefined)
+        return false; // String operators require a value
+    if (value === undefined)
+        return false; // Can't perform string operations on undefined
+    switch (operator) {
+        case "$startsWith":
+            return value.startsWith(operand);
+        case "$endsWith":
+            return value.endsWith(operand);
+        case "$contains":
+            return value.includes(operand);
+    }
+}
+// Number-specific operators
+function checkNumberOperator(value, operator, operand, hasOperator) {
+    if (!hasOperator)
+        return null;
+    if (operand === undefined)
+        return false; // Number operators require a value
+    switch (operator) {
+        case "$gt":
+            return value > operand;
+        case "$gte":
+            return value >= operand;
+        case "$lt":
+            return value < operand;
+        case "$lte":
+            return value <= operand;
+    }
+}
+// Array-specific operators
+function checkArrayOperator(value, operator, operand, hasOperator) {
+    if (!hasOperator)
+        return null;
+    if (operand === undefined)
+        return false; // Array operators require a value
+    switch (operator) {
+        case "$contains":
+            // Check if array contains the single value
+            return value.includes(operand);
+        case "$all":
+            // Check if array contains all values
+            if (!Array.isArray(operand))
+                return false;
+            return operand.every((item) => value.includes(item));
+        case "$size":
+            // Check array length
+            return value.length === operand;
+    }
+}
+// Built-in operator keys (shared between isFilterOperatorObject and matchesFilter)
+const BUILT_IN_OPERATORS = new Set([
+    "$eq",
+    "$ne",
+    "$in",
+    "$nin",
+    "$gt",
+    "$gte",
+    "$lt",
+    "$lte",
+    "$startsWith",
+    "$endsWith",
+    "$contains",
+    "$all",
+    "$size",
+    "$search",
+]);
+// Type guard to check if a value is a filter operator object
+export function isFilterOperatorObject(filter, customOperators) {
+    if (typeof filter !== "object" || filter === null || Array.isArray(filter)) {
+        return false;
+    }
+    const filterKeys = Object.keys(filter);
+    if (filterKeys.length === 0) {
+        return false;
+    }
+    return filterKeys.some((key) => {
+        // Check built-in operators
+        if (BUILT_IN_OPERATORS.has(key)) {
+            return true;
+        }
+        // Check custom operators (any $-prefixed key present in the custom operators map)
+        if (customOperators && key.startsWith("$") && customOperators.has(key)) {
+            return true;
+        }
+        return false;
+    });
+}
+// Helper function to check if a value matches a filter operator
+export function matchesFilter(value, filter, customOperators) {
+    // Check if filter is an object with operators
+    if (isFilterOperatorObject(filter, customOperators)) {
+        // Type-safe operator access using type guards and explicit property checks
+        const ops = filter;
+        const results = [];
+        // Check universal operators that exist on all FilterOperators variants
+        if ("$eq" in ops) {
+            const result = checkUniversalOperator(value, "$eq", ops.$eq, true);
+            if (result !== null)
+                results.push(result);
+        }
+        if ("$ne" in ops) {
+            const result = checkUniversalOperator(value, "$ne", ops.$ne, true);
+            if (result !== null)
+                results.push(result);
+        }
+        if ("$in" in ops) {
+            const result = checkUniversalOperator(value, "$in", ops.$in, true);
+            if (result !== null)
+                results.push(result);
+        }
+        if ("$nin" in ops) {
+            const result = checkUniversalOperator(value, "$nin", ops.$nin, true);
+            if (result !== null)
+                results.push(result);
+        }
+        // Check string-specific operators only for string values
+        if (typeof value === "string") {
+            if ("$startsWith" in ops) {
+                const result = checkStringOperator(value, "$startsWith", ops.$startsWith, true);
+                if (result !== null)
+                    results.push(result);
+            }
+            if ("$endsWith" in ops) {
+                const result = checkStringOperator(value, "$endsWith", ops.$endsWith, true);
+                if (result !== null)
+                    results.push(result);
+            }
+            if ("$contains" in ops) {
+                const result = checkStringOperator(value, "$contains", ops.$contains, true);
+                if (result !== null)
+                    results.push(result);
+            }
+            if ("$search" in ops) {
+                const searchQuery = ops.$search;
+                if (searchQuery !== undefined) {
+                    // Empty search string matches everything
+                    if (searchQuery === "") {
+                        results.push(true);
+                    }
+                    else {
+                        const queryTokens = tokenize(searchQuery);
+                        const fieldTokens = tokenize(value);
+                        // All query tokens must match at least one field token (exact or prefix)
+                        const allTokensMatch = queryTokens.every((queryToken) => fieldTokens.some((fieldToken) => fieldToken === queryToken ||
+                            fieldToken.startsWith(queryToken)));
+                        results.push(allTokensMatch);
+                    }
+                }
+            }
+        }
+        else if (value === undefined || value === null || value === "") {
+            // For non-string values (undefined, null, empty), string operators should fail
+            if ("$startsWith" in ops || "$endsWith" in ops || "$contains" in ops) {
+                return false;
+            }
+        }
+        // Check number-specific operators only for number values
+        if (typeof value === "number") {
+            if ("$gt" in ops) {
+                const result = checkNumberOperator(value, "$gt", ops.$gt, true);
+                if (result !== null)
+                    results.push(result);
+            }
+            if ("$gte" in ops) {
+                const result = checkNumberOperator(value, "$gte", ops.$gte, true);
+                if (result !== null)
+                    results.push(result);
+            }
+            if ("$lt" in ops) {
+                const result = checkNumberOperator(value, "$lt", ops.$lt, true);
+                if (result !== null)
+                    results.push(result);
+            }
+            if ("$lte" in ops) {
+                const result = checkNumberOperator(value, "$lte", ops.$lte, true);
+                if (result !== null)
+                    results.push(result);
+            }
+        }
+        // Also allow comparison operators on strings (for ISO date strings, etc.)
+        if (typeof value === "string") {
+            if ("$gt" in ops) {
+                const operand = ops.$gt;
+                if (typeof operand === "string") {
+                    results.push(value > operand);
+                }
+            }
+            if ("$gte" in ops) {
+                const operand = ops.$gte;
+                if (typeof operand === "string") {
+                    results.push(value >= operand);
+                }
+            }
+            if ("$lt" in ops) {
+                const operand = ops.$lt;
+                if (typeof operand === "string") {
+                    results.push(value < operand);
+                }
+            }
+            if ("$lte" in ops) {
+                const operand = ops.$lte;
+                if (typeof operand === "string") {
+                    results.push(value <= operand);
+                }
+            }
+        }
+        // Check array-specific operators only for array values
+        if (Array.isArray(value)) {
+            // Note: For arrays, $contains checks if the array contains a value
+            if ("$contains" in ops) {
+                const result = checkArrayOperator(value, "$contains", ops.$contains, true);
+                if (result !== null)
+                    results.push(result);
+            }
+            if ("$all" in ops) {
+                const result = checkArrayOperator(value, "$all", ops.$all, true);
+                if (result !== null)
+                    results.push(result);
+            }
+            if ("$size" in ops) {
+                const result = checkArrayOperator(value, "$size", ops.$size, true);
+                if (result !== null)
+                    results.push(result);
+            }
+        }
+        else if (value === undefined || value === null) {
+            // For undefined/null values, array operators should fail
+            if ("$contains" in ops || "$all" in ops || "$size" in ops) {
+                return false;
+            }
+        }
+        // Check if comparison operators are being used on incompatible types
+        if (typeof value !== "number" && typeof value !== "string") {
+            if ("$gt" in ops || "$gte" in ops || "$lt" in ops || "$lte" in ops) {
+                return false;
+            }
+        }
+        // Check custom operators for any unrecognized $-prefixed keys
+        if (customOperators && customOperators.size > 0) {
+            for (const key of Object.keys(ops)) {
+                // Skip non-operator keys and built-in operators
+                if (!key.startsWith("$") || BUILT_IN_OPERATORS.has(key)) {
+                    continue;
+                }
+                // Look up custom operator
+                const customOp = customOperators.get(key);
+                if (customOp) {
+                    // Check if the value type is compatible with the operator
+                    const valueType = Array.isArray(value)
+                        ? "array"
+                        : typeof value;
+                    // Only evaluate if the operator supports this value type
+                    if (customOp.types.includes(valueType)) {
+                        const result = customOp.evaluate(value, ops[key]);
+                        results.push(result);
+                    }
+                    // If type is not supported, the operator is silently ignored
+                    // (consistent with how built-in type-specific operators work)
+                }
+                // Unknown operators are silently ignored (no error thrown)
+            }
+        }
+        // If no operators were specified, this shouldn't happen due to isFilterOperatorObject check
+        if (results.length === 0)
+            return true;
+        // All specified operators must match (AND logic)
+        return results.every((result) => result === true);
+    }
+    // Direct equality check
+    return value === filter;
+}
+//# sourceMappingURL=operators.js.map

package/dist/types/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.js","sourceRoot":"","sources":["../../src/types/operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAIzD,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E,+CAA+C;AAC/C,SAAS,sBAAsB,CAC9B,KAAQ,EACR,QAAwC,EACxC,OAA4B,EAC5B,WAAoB;IAEpB,wDAAwD;IACxD,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9B,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,KAAK;YACT,OAAO,KAAK,KAAK,OAAO,CAAC;QAC1B,KAAK,KAAK;YACT,OAAO,KAAK,KAAK,OAAO,CAAC;QAC1B,KAAK,KAAK;YACT,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1D,KAAK,MAAM;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;AACF,CAAC;AAED,4BAA4B;AAC5B,SAAS,mBAAmB,CAC3B,KAAyB,EACzB,QAAmD,EACnD,OAA2B,EAC3B,WAAoB;IAEpB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,mCAAmC;IAC5E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,+CAA+C;IAEtF,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,aAAa;YACjB,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,WAAW;YACf,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,KAAK,WAAW;YACf,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;AACF,CAAC;AAED,4BAA4B;AAC5B,SAAS,mBAAmB,CAC3B,KAAa,EACb,QAAyC,EACzC,OAA2B,EAC3B,WAAoB;IAEpB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,mCAAmC;IAE5E,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,KAAK;YACT,OAAO,KAAK,GAAG,OAAO,CAAC;QACxB,KAAK,MAAM;YACV,OAAO,KAAK,IAAI,OAAO,CAAC;QACzB,KAAK,KAAK;YACT,OAAO,KAAK,GAAG,OAAO,CAAC;QACxB,KAAK,MAAM;YACV,OAAO,KAAK,IAAI,OAAO,CAAC;IAC1B,CAAC;AACF,CAAC;AAED,2BAA2B;AAC3B,SAAS,kBAAkB,CAC1B,KAAU,EACV,QAAwC,EACxC,OAAqC,EACrC,WAAoB;IAEpB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,kCAAkC;IAE3E,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,WAAW;YACf,2CAA2C;YAC3C,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAY,CAAC,CAAC;QACrC,KAAK,MAAM;YACV,qCAAqC;YACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC1C,OAAQ,OAAe,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,KAAK,OAAO;YACX,qBAAqB;YACrB,OAAO,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC;IAClC,CAAC;AACF,CAAC;AAED,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IAClC,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,aAAa;IACb,WAAW;IACX,WAAW;IACX,MAAM;IACN,OAAO;IACP,SAAS;CACT,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB,CACrC,MAA8B,EAC9B,eAA6C;IAE7C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QAC9B,2BAA2B;QAC3B,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACb,CAAC;QACD,kFAAkF;QAClF,IAAI,eAAe,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxE,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,aAAa,CAC5B,KAAQ,EACR,MAA8B,EAC9B,eAA6C;IAE7C,8CAA8C;IAC9C,IAAI,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,CAAC;QACrD,2EAA2E;QAC3E,MAAM,GAAG,GAAG,MAAiC,CAAC;QAC9C,MAAM,OAAO,GAAc,EAAE,CAAC;QAE9B,uEAAuE;QACvE,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,sBAAsB,CACpC,KAAK,EACL,KAAK,EACL,GAAG,CAAC,GAAoB,EACxB,IAAI,CACJ,CAAC;YACF,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,sBAAsB,CACpC,KAAK,EACL,KAAK,EACL,GAAG,CAAC,GAAoB,EACxB,IAAI,CACJ,CAAC;YACF,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,sBAAsB,CACpC,KAAK,EACL,KAAK,EACL,GAAG,CAAC,GAAsB,EAC1B,IAAI,CACJ,CAAC;YACF,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,sBAAsB,CACpC,KAAK,EACL,MAAM,EACN,GAAG,CAAC,IAAuB,EAC3B,IAAI,CACJ,CAAC;YACF,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,yDAAyD;QACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,aAAa,IAAI,GAAG,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAG,mBAAmB,CACjC,KAAK,EACL,aAAa,EACb,GAAG,CAAC,WAAiC,EACrC,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,mBAAmB,CACjC,KAAK,EACL,WAAW,EACX,GAAG,CAAC,SAA+B,EACnC,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,mBAAmB,CACjC,KAAK,EACL,WAAW,EACX,GAAG,CAAC,SAA+B,EACnC,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;gBACtB,MAAM,WAAW,GAAG,GAAG,CAAC,OAA6B,CAAC;gBACtD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC/B,yCAAyC;oBACzC,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;wBACxB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,CAAC;yBAAM,CAAC;wBACP,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;wBAC1C,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;wBAEpC,yEAAyE;wBACzE,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CACvD,WAAW,CAAC,IAAI,CACf,CAAC,UAAU,EAAE,EAAE,CACd,UAAU,KAAK,UAAU;4BACzB,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,CAClC,CACD,CAAC;wBACF,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;oBAC9B,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;aAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAClE,+EAA+E;YAC/E,IAAI,aAAa,IAAI,GAAG,IAAI,WAAW,IAAI,GAAG,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;gBACtE,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QAED,yDAAyD;QACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,mBAAmB,CACjC,KAAK,EACL,KAAK,EACL,GAAG,CAAC,GAAyB,EAC7B,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,mBAAmB,CACjC,KAAK,EACL,MAAM,EACN,GAAG,CAAC,IAA0B,EAC9B,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,mBAAmB,CACjC,KAAK,EACL,KAAK,EACL,GAAG,CAAC,GAAyB,EAC7B,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,mBAAmB,CACjC,KAAK,EACL,MAAM,EACN,GAAG,CAAC,IAA0B,EAC9B,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;QACF,CAAC;QAED,0EAA0E;QAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;gBAClB,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;gBACxB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACjC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;gBAC/B,CAAC;YACF,CAAC;YAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;gBACzB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACjC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC;gBAChC,CAAC;YACF,CAAC;YAED,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;gBAClB,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC;gBACxB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACjC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;gBAC/B,CAAC;YACF,CAAC;YAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;gBACzB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACjC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC;gBAChC,CAAC;YACF,CAAC;QACF,CAAC;QAED,uDAAuD;QACvD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,mEAAmE;YACnE,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,kBAAkB,CAChC,KAAK,EACL,WAAW,EACX,GAAG,CAAC,SAAS,EACb,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACjE,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,kBAAkB,CAChC,KAAK,EACL,OAAO,EACP,GAAG,CAAC,KAA2B,EAC/B,IAAI,CACJ,CAAC;gBACF,IAAI,MAAM,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC;QACF,CAAC;aAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAClD,yDAAyD;YACzD,IAAI,WAAW,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;gBAC3D,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QAED,qEAAqE;QACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5D,IAAI,KAAK,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBACpE,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QAED,8DAA8D;QAC9D,IAAI,eAAe,IAAI,eAAe,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACjD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,gDAAgD;gBAChD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzD,SAAS;gBACV,CAAC;gBAED,0BAA0B;gBAC1B,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,QAAQ,EAAE,CAAC;oBACd,0DAA0D;oBAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;wBACrC,CAAC,CAAC,OAAO;wBACT,CAAC,CAAE,OAAO,KAAyC,CAAC;oBAErD,yDAAyD;oBACzD,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;wBACxC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;wBAClD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACtB,CAAC;oBACD,6DAA6D;oBAC7D,8DAA8D;gBAC/D,CAAC;gBACD,2DAA2D;YAC5D,CAAC;QACF,CAAC;QAED,4FAA4F;QAC5F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtC,iDAAiD;QACjD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,wBAAwB;IACxB,OAAO,KAAK,KAAK,MAAM,CAAC;AACzB,CAAC"}

package/dist/types/query-overloads.d.ts

@@ -0,0 +1,54 @@
+import type { ApplyPopulateObject, ApplySelectAndPopulate, ApplySelectConfig, PopulateConfig, RelationshipDef, SelectConfig, SortConfig, WhereClause } from "./types.js";
+export interface QueryWithoutPopulate<T, Relations, DB> {
+    where?: WhereClause<T, Relations, DB>;
+    sort?: SortConfig<T, Relations, Record<string, never>, DB>;
+    select?: SelectConfig<T, Relations, DB>;
+    limit?: number;
+    offset?: number;
+}
+export interface QueryWithPopulate<T, Relations, DB> {
+    populate: PopulateConfig<Relations, DB>;
+    where?: WhereClause<T, Relations, DB>;
+    sort?: SortConfig<T, Relations, {
+        populate: PopulateConfig<Relations, DB>;
+    }, DB>;
+    select?: SelectConfig<T, Relations, DB>;
+    limit?: number;
+    offset?: number;
+}
+export interface SmartCollectionWithOverloads<T, Relations extends Record<string, RelationshipDef<unknown, "ref" | "inverse", string>>, DB> {
+    query<P extends PopulateConfig<Relations, DB>, S extends SelectConfig<T, Relations, DB>>(config: {
+        populate: P;
+        select: S;
+        where?: WhereClause<T, Relations, DB>;
+        sort?: SortConfig<T, Relations, {
+            populate: P;
+        }, DB>;
+        limit?: number;
+        offset?: number;
+    }): AsyncIterable<ApplySelectAndPopulate<T, Relations, S, P, DB>>;
+    query<P extends PopulateConfig<Relations, DB>>(config: {
+        populate: P;
+        where?: WhereClause<T, Relations, DB>;
+        sort?: SortConfig<T, Relations, {
+            populate: P;
+        }, DB>;
+        limit?: number;
+        offset?: number;
+    }): AsyncIterable<ApplyPopulateObject<T, Relations, P, DB>>;
+    query<S extends SelectConfig<T, Relations, DB>>(config: {
+        select: S;
+        where?: WhereClause<T, Relations, DB>;
+        sort?: SortConfig<T, Relations, Record<string, never>, DB>;
+        limit?: number;
+        offset?: number;
+    }): AsyncIterable<ApplySelectConfig<T, S, Relations, DB>>;
+    query(config?: {
+        where?: WhereClause<T, Relations, DB>;
+        sort?: SortConfig<T, Relations, Record<string, never>, DB>;
+        limit?: number;
+        offset?: number;
+    }): AsyncIterable<T>;
+    query(config?: unknown): AsyncIterable<unknown>;
+}
+//# sourceMappingURL=query-overloads.d.ts.map

package/dist/types/query-overloads.d.ts.map

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

package/dist/types/query-overloads.js

@@ -0,0 +1,3 @@
+// Alternative approach using function overloads for better type inference
+export {};
+//# sourceMappingURL=query-overloads.js.map

package/dist/types/query-overloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-overloads.js","sourceRoot":"","sources":["../../src/types/query-overloads.ts"],"names":[],"mappings":"AAAA,0EAA0E"}