@atscript/db 0.1.39 → 0.1.41

package/dist/ops.cjs

@@ -0,0 +1,123 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/ops.ts
+/** Increment a numeric field by `value` (default 1). */
+function $inc(value = 1) {
+	return { $inc: value };
+}
+/** Decrement a numeric field by `value` (default 1). */
+function $dec(value = 1) {
+	return { $dec: value };
+}
+/** Multiply a numeric field by `value`. */
+function $mul(value) {
+	return { $mul: value };
+}
+/** Replace the entire array. */
+function $replace(items) {
+	return { $replace: items };
+}
+/** Append items to an array. */
+function $insert(items) {
+	return { $insert: items };
+}
+/** Insert-or-update items by key. */
+function $upsert(items) {
+	return { $upsert: items };
+}
+/** Update existing items matched by key. */
+function $update(items) {
+	return { $update: items };
+}
+/** Remove items matched by key or value. */
+function $remove(items) {
+	return { $remove: items };
+}
+/** Returns true if obj has any own key other than `skip`. Zero-allocation. */
+function _hasExtraKey(obj, skip) {
+	for (const k in obj) if (k !== skip) return true;
+	return false;
+}
+/**
+* Returns `true` when `value` is a field operation object
+* (`{ $inc: N }`, `{ $dec: N }`, or `{ $mul: N }`).
+*/
+function isDbFieldOp(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const v = value;
+	if ("$inc" in v) return typeof v.$inc === "number" && !_hasExtraKey(v, "$inc");
+	if ("$dec" in v) return typeof v.$dec === "number" && !_hasExtraKey(v, "$dec");
+	if ("$mul" in v) return typeof v.$mul === "number" && !_hasExtraKey(v, "$mul");
+	return false;
+}
+/**
+* Extracts the normalized operation from a field op value.
+* Returns `undefined` when `value` is not a field op.
+*
+* `$dec` is normalized to `{ op: 'inc', value: -N }` so consumers
+* only need to handle `inc` and `mul`.
+*/
+function getDbFieldOp(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return;
+	const v = value;
+	if (typeof v.$inc === "number" && !_hasExtraKey(v, "$inc")) return {
+		op: "inc",
+		value: v.$inc
+	};
+	if (typeof v.$dec === "number" && !_hasExtraKey(v, "$dec")) return {
+		op: "inc",
+		value: -v.$dec
+	};
+	if (typeof v.$mul === "number" && !_hasExtraKey(v, "$mul")) return {
+		op: "mul",
+		value: v.$mul
+	};
+}
+/**
+* Separates field operations from a data payload.
+*
+* Mutates `data` in-place (removes op entries) and returns the separated ops.
+* When no ops are found, returns `undefined` — zero allocation for the
+* common non-op case.
+*
+* Hot path: uses `for...in` (no array allocation), inlines detection to
+* avoid intermediate `{ op, value }` objects, and short-circuits on typeof.
+*/
+function separateFieldOps(data) {
+	let ops;
+	for (const key in data) {
+		const value = data[key];
+		if (typeof value !== "object" || value === null || Array.isArray(value)) continue;
+		const v = value;
+		let opValue;
+		let opType;
+		if (typeof v.$inc === "number" && !_hasExtraKey(v, "$inc")) {
+			opValue = v.$inc;
+			opType = 0;
+		} else if (typeof v.$dec === "number" && !_hasExtraKey(v, "$dec")) {
+			opValue = -v.$dec;
+			opType = 0;
+		} else if (typeof v.$mul === "number" && !_hasExtraKey(v, "$mul")) {
+			opValue = v.$mul;
+			opType = 1;
+		}
+		if (opType !== void 0) {
+			if (!ops) ops = {};
+			if (opType === 0) (ops.inc ??= {})[key] = opValue;
+			else (ops.mul ??= {})[key] = opValue;
+			delete data[key];
+		}
+	}
+	return ops;
+}
+//#endregion
+exports.$dec = $dec;
+exports.$inc = $inc;
+exports.$insert = $insert;
+exports.$mul = $mul;
+exports.$remove = $remove;
+exports.$replace = $replace;
+exports.$update = $update;
+exports.$upsert = $upsert;
+exports.getDbFieldOp = getDbFieldOp;
+exports.isDbFieldOp = isDbFieldOp;
+exports.separateFieldOps = separateFieldOps;

package/dist/ops.d.cts

@@ -0,0 +1,2 @@
+import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-DXJ4Zw0P.cjs";
+export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, TDbFieldOp, TFieldOps, getDbFieldOp, isDbFieldOp, separateFieldOps };

package/dist/ops.d.mts

@@ -0,0 +1,2 @@
+import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-BdRAFLKY.mjs";
+export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, TDbFieldOp, TFieldOps, getDbFieldOp, isDbFieldOp, separateFieldOps };

package/dist/ops.mjs

@@ -0,0 +1,112 @@
+//#region src/ops.ts
+/** Increment a numeric field by `value` (default 1). */
+function $inc(value = 1) {
+	return { $inc: value };
+}
+/** Decrement a numeric field by `value` (default 1). */
+function $dec(value = 1) {
+	return { $dec: value };
+}
+/** Multiply a numeric field by `value`. */
+function $mul(value) {
+	return { $mul: value };
+}
+/** Replace the entire array. */
+function $replace(items) {
+	return { $replace: items };
+}
+/** Append items to an array. */
+function $insert(items) {
+	return { $insert: items };
+}
+/** Insert-or-update items by key. */
+function $upsert(items) {
+	return { $upsert: items };
+}
+/** Update existing items matched by key. */
+function $update(items) {
+	return { $update: items };
+}
+/** Remove items matched by key or value. */
+function $remove(items) {
+	return { $remove: items };
+}
+/** Returns true if obj has any own key other than `skip`. Zero-allocation. */
+function _hasExtraKey(obj, skip) {
+	for (const k in obj) if (k !== skip) return true;
+	return false;
+}
+/**
+* Returns `true` when `value` is a field operation object
+* (`{ $inc: N }`, `{ $dec: N }`, or `{ $mul: N }`).
+*/
+function isDbFieldOp(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const v = value;
+	if ("$inc" in v) return typeof v.$inc === "number" && !_hasExtraKey(v, "$inc");
+	if ("$dec" in v) return typeof v.$dec === "number" && !_hasExtraKey(v, "$dec");
+	if ("$mul" in v) return typeof v.$mul === "number" && !_hasExtraKey(v, "$mul");
+	return false;
+}
+/**
+* Extracts the normalized operation from a field op value.
+* Returns `undefined` when `value` is not a field op.
+*
+* `$dec` is normalized to `{ op: 'inc', value: -N }` so consumers
+* only need to handle `inc` and `mul`.
+*/
+function getDbFieldOp(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return;
+	const v = value;
+	if (typeof v.$inc === "number" && !_hasExtraKey(v, "$inc")) return {
+		op: "inc",
+		value: v.$inc
+	};
+	if (typeof v.$dec === "number" && !_hasExtraKey(v, "$dec")) return {
+		op: "inc",
+		value: -v.$dec
+	};
+	if (typeof v.$mul === "number" && !_hasExtraKey(v, "$mul")) return {
+		op: "mul",
+		value: v.$mul
+	};
+}
+/**
+* Separates field operations from a data payload.
+*
+* Mutates `data` in-place (removes op entries) and returns the separated ops.
+* When no ops are found, returns `undefined` — zero allocation for the
+* common non-op case.
+*
+* Hot path: uses `for...in` (no array allocation), inlines detection to
+* avoid intermediate `{ op, value }` objects, and short-circuits on typeof.
+*/
+function separateFieldOps(data) {
+	let ops;
+	for (const key in data) {
+		const value = data[key];
+		if (typeof value !== "object" || value === null || Array.isArray(value)) continue;
+		const v = value;
+		let opValue;
+		let opType;
+		if (typeof v.$inc === "number" && !_hasExtraKey(v, "$inc")) {
+			opValue = v.$inc;
+			opType = 0;
+		} else if (typeof v.$dec === "number" && !_hasExtraKey(v, "$dec")) {
+			opValue = -v.$dec;
+			opType = 0;
+		} else if (typeof v.$mul === "number" && !_hasExtraKey(v, "$mul")) {
+			opValue = v.$mul;
+			opType = 1;
+		}
+		if (opType !== void 0) {
+			if (!ops) ops = {};
+			if (opType === 0) (ops.inc ??= {})[key] = opValue;
+			else (ops.mul ??= {})[key] = opValue;
+			delete data[key];
+		}
+	}
+	return ops;
+}
+//#endregion
+export { $dec, $inc, $insert, $mul, $remove, $replace, $update, $upsert, getDbFieldOp, isDbFieldOp, separateFieldOps };