mongo.do 0.1.0

package/dist/translator/update-translator.d.ts

@@ -0,0 +1,148 @@
+/**
+ * UpdateTranslator - Translates MongoDB-style update operations to SQLite SQL
+ * using json_set, json_remove, and related functions for JSON document updates.
+ *
+ * REFACTORED: Optimized with combined json_set calls, validation, and CTE-based array operations.
+ */
+export interface TranslatedUpdate {
+    sql: string;
+    params: unknown[];
+}
+/**
+ * Context for positional array updates.
+ * Contains information needed to resolve positional operators.
+ */
+export interface PositionalContext {
+    /** The matched array index for $ operator (from query phase) */
+    matchedIndex?: number;
+    /** The matched indices map: array path -> index for nested positional operators */
+    matchedIndices?: Map<string, number>;
+    /** Array filters for $[identifier] operators */
+    arrayFilters?: ArrayFilter[];
+}
+/**
+ * An array filter specification for $[identifier] operators.
+ * Used to identify and update specific array elements matching conditions.
+ */
+export interface ArrayFilter {
+    /** The identifier used in the path (e.g., "elem" for $[elem]) */
+    identifier: string;
+    /** The filter conditions to match against array elements */
+    conditions: Record<string, unknown>;
+}
+/**
+ * Parses arrayFilters option into ArrayFilter objects.
+ *
+ * @param arrayFilters - Array of filter objects from MongoDB update options
+ * @returns Parsed ArrayFilter array
+ *
+ * @example
+ * parseArrayFilters([{ "elem.status": "pending" }])
+ * // Returns: [{ identifier: "elem", conditions: { status: "pending" } }]
+ */
+export declare function parseArrayFilters(arrayFilters: Record<string, unknown>[]): ArrayFilter[];
+/**
+ * Converts a field path with a resolved positional index to JSONPath.
+ * Used when we know the specific array index to update.
+ *
+ * @param fieldPath - The original path with positional operator
+ * @param _arrayPath - The path to the array (e.g., "items") - unused but part of API
+ * @param index - The resolved array index
+ * @returns JSONPath with the index substituted
+ */
+declare function toJsonPathWithIndex(fieldPath: string, _arrayPath: string, index: number): string;
+export { toJsonPathWithIndex };
+export declare class UpdateTranslator {
+    private static readonly SUPPORTED_OPERATORS;
+    private static readonly OPERATOR_ORDER;
+    /**
+     * Translates a MongoDB-style update object to SQLite SQL.
+     * Returns the SQL expression and parameters for updating the data column.
+     *
+     * @param update - MongoDB update document with operators like $set, $inc, etc.
+     * @returns Translated SQL expression and parameters
+     * @throws Error if operators are invalid or conflicting
+     */
+    translate(update: Record<string, unknown>): TranslatedUpdate;
+    private translateOperator;
+    /**
+     * Translates $set operator using optimized multi-path json_set.
+     *
+     * OPTIMIZATION: SQLite's json_set supports multiple path-value pairs in a single call:
+     * json_set(data, '$.a', 1, '$.b', 2) instead of json_set(json_set(data, '$.a', 1), '$.b', 2)
+     */
+    private translateSet;
+    /**
+     * Translates $unset operator using optimized multi-path json_remove.
+     *
+     * OPTIMIZATION: SQLite's json_remove supports multiple paths in a single call.
+     */
+    private translateUnset;
+    /**
+     * Translates $inc operator to json_set with addition.
+     * Uses COALESCE to handle missing fields (defaulting to 0).
+     */
+    private translateInc;
+    /**
+     * Translates $mul operator to json_set with multiplication.
+     * Uses COALESCE to handle missing fields (defaulting to 0, which means result is 0).
+     */
+    private translateMul;
+    /**
+     * Translates $min operator to conditional update.
+     * Sets the field to the smaller of current value or specified value.
+     * If field doesn't exist, sets it to the specified value.
+     */
+    private translateMin;
+    /**
+     * Translates $max operator to conditional update.
+     * Sets the field to the larger of current value or specified value.
+     * If field doesn't exist, sets it to the specified value.
+     */
+    private translateMax;
+    /**
+     * Translates $rename operator to json_set + json_remove combination.
+     * Moves a field from one location to another.
+     */
+    private translateRename;
+    /**
+     * Translates $push operator to append values to an array.
+     * Supports $each and $slice modifiers.
+     */
+    private translatePush;
+    /**
+     * Handles $push with $each modifier for batch appending.
+     * Uses CTE for efficient array building when $slice is present.
+     */
+    private translatePushEach;
+    /**
+     * Applies $slice modifier using CTE for efficient array slicing.
+     * CTE provides better performance for large arrays.
+     */
+    private applySliceWithCTE;
+    /**
+     * Translates $pull operator to remove matching elements.
+     * Uses CTE for efficient filtering.
+     */
+    private translatePull;
+    /**
+     * Handles $pull with query conditions using CTE.
+     */
+    private translatePullWithQueryCTE;
+    private mongoOpToSql;
+    /**
+     * Translates $addToSet operator to push if value doesn't exist.
+     * Uses CTE for efficient uniqueness check.
+     */
+    private translateAddToSet;
+    /**
+     * Single value $addToSet using CTE for uniqueness check.
+     */
+    private translateAddToSetSingleWithCTE;
+    /**
+     * Translates $pop operator to remove first or last element.
+     * Uses CTE for efficient element removal.
+     */
+    private translatePop;
+}
+//# sourceMappingURL=update-translator.d.ts.map

package/dist/translator/update-translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-translator.d.ts","sourceRoot":"","sources":["../../src/translator/update-translator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,gDAAgD;IAChD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,WAAW,EAAE,CAwCxF;AA6ID;;;;;;;;GAQG;AACH,iBAAS,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAyBzF;AAGD,OAAO,EAAE,mBAAmB,EAAE,CAAC;AA0H/B,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAGxC;IAIH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAGpC;IAEF;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IA0C5D,OAAO,CAAC,iBAAiB;IA+CzB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAmBtB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IA+BrB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAyCzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAuDzB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA8CjC,OAAO,CAAC,YAAY;IAYpB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,OAAO,CAAC,8BAA8B;IA6BtC;;;OAGG;IACH,OAAO,CAAC,YAAY;CA8CrB"}