@proseql/core 0.1.0

package/dist/operations/crud/update.js

@@ -0,0 +1,505 @@
+/**
+ * Effect-based update operations for entities.
+ *
+ * Uses Ref<ReadonlyMap> for atomic state mutation, Effect Schema for validation,
+ * and typed errors (ValidationError, NotFoundError, ForeignKeyError).
+ *
+ * Preserves all update operators: $increment, $decrement, $multiply,
+ * $append, $prepend, $remove, $toggle, $set.
+ */
+import { Effect, PubSub, Ref } from "effect";
+import { NotFoundError, ValidationError, } from "../../errors/crud-errors.js";
+import { runAfterUpdateHooks, runBeforeUpdateHooks, runOnChangeHooks, } from "../../hooks/hook-runner.js";
+import { updateInIndex } from "../../indexes/index-manager.js";
+import { updateInSearchIndex } from "../../indexes/search-index.js";
+import { validateForeignKeysEffect } from "../../validators/foreign-key.js";
+import { validateEntity } from "../../validators/schema-validator.js";
+import { checkUniqueConstraints, } from "./unique-check.js";
+// ============================================================================
+// Update Operators Implementation
+// ============================================================================
+/**
+ * Check if an object is a plain object (not null, not an array).
+ */
+function isPlainObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/**
+ * Check if an object contains any $-prefixed keys (operator object).
+ */
+function hasOperatorKeys(obj) {
+    return Object.keys(obj).some((k) => k.startsWith("$"));
+}
+/**
+ * Apply update operators to a value.
+ * Supports: $increment, $decrement, $multiply (number),
+ *           $append, $prepend (string/array), $remove (array),
+ *           $toggle (boolean), $set (all types).
+ */
+function applyOperator(currentValue, operator) {
+    // Number operators
+    if (typeof currentValue === "number") {
+        if ("$increment" in operator && typeof operator.$increment === "number") {
+            return (currentValue + operator.$increment);
+        }
+        if ("$decrement" in operator && typeof operator.$decrement === "number") {
+            return (currentValue - operator.$decrement);
+        }
+        if ("$multiply" in operator && typeof operator.$multiply === "number") {
+            return (currentValue * operator.$multiply);
+        }
+        if ("$set" in operator) {
+            return operator.$set;
+        }
+    }
+    // String operators
+    if (typeof currentValue === "string") {
+        if ("$append" in operator && typeof operator.$append === "string") {
+            return (currentValue + operator.$append);
+        }
+        if ("$prepend" in operator && typeof operator.$prepend === "string") {
+            return (operator.$prepend + currentValue);
+        }
+        if ("$set" in operator) {
+            return operator.$set;
+        }
+    }
+    // Array operators
+    if (Array.isArray(currentValue)) {
+        if ("$append" in operator) {
+            const toAppend = Array.isArray(operator.$append)
+                ? operator.$append
+                : [operator.$append];
+            return [...currentValue, ...toAppend];
+        }
+        if ("$prepend" in operator) {
+            const toPrepend = Array.isArray(operator.$prepend)
+                ? operator.$prepend
+                : [operator.$prepend];
+            return [...toPrepend, ...currentValue];
+        }
+        if ("$remove" in operator) {
+            if (typeof operator.$remove === "function") {
+                return currentValue.filter((item) => !operator.$remove(item));
+            }
+            return currentValue.filter((item) => item !== operator.$remove);
+        }
+        if ("$set" in operator) {
+            return operator.$set;
+        }
+    }
+    // Boolean operators
+    if (typeof currentValue === "boolean") {
+        if ("$toggle" in operator && operator.$toggle === true) {
+            return !currentValue;
+        }
+        if ("$set" in operator) {
+            return operator.$set;
+        }
+    }
+    // Default: just set the value
+    if ("$set" in operator) {
+        return operator.$set;
+    }
+    // If no operator matched, return current value
+    return currentValue;
+}
+/**
+ * Deep merge an update object into a current object, handling operators at any level.
+ *
+ * Rules:
+ * 1. If update value has $-prefixed keys → it's an operator, apply to current value
+ * 2. If update value is a plain object with no $-keys AND current value is also a plain object → recurse
+ * 3. Otherwise → direct assignment (replace current value with update value)
+ *
+ * This allows nested updates like:
+ * - `{ metadata: { views: 500 } }` → merges into metadata, preserving other fields
+ * - `{ metadata: { views: { $increment: 1 } } }` → applies operator to metadata.views
+ * - `{ metadata: { $set: { views: 0 } } }` → replaces entire metadata
+ *
+ * @param current - The current object to merge into
+ * @param updates - The update object containing values and/or operators
+ * @returns A new object with updates applied
+ */
+export function deepMergeUpdates(current, updates) {
+    const result = { ...current };
+    for (const [key, updateValue] of Object.entries(updates)) {
+        if (updateValue === undefined) {
+            // Skip undefined values
+            continue;
+        }
+        const currentValue = current[key];
+        if (isPlainObject(updateValue)) {
+            if (hasOperatorKeys(updateValue)) {
+                // Update value is an operator object → apply operator to current value
+                result[key] = applyOperator(currentValue, updateValue);
+            }
+            else if (isPlainObject(currentValue)) {
+                // Both update and current are plain objects with no $ keys → recurse
+                result[key] = deepMergeUpdates(currentValue, updateValue);
+            }
+            else {
+                // Current value is not a plain object → direct assignment
+                result[key] = updateValue;
+            }
+        }
+        else {
+            // Update value is a primitive or array → direct assignment
+            result[key] = updateValue;
+        }
+    }
+    return result;
+}
+/**
+ * Apply update operations to an entity.
+ * Handles both direct value assignments and operator objects at any nesting level.
+ * Uses deepMergeUpdates for nested object merging with operator support.
+ * Automatically sets updatedAt timestamp.
+ */
+export function applyUpdates(entity, updates) {
+    const now = new Date().toISOString();
+    // Use deepMergeUpdates to handle nested objects and operators at any level
+    const merged = deepMergeUpdates(entity, updates);
+    // Ensure updatedAt is set
+    if (!("updatedAt" in updates)) {
+        merged.updatedAt = now;
+    }
+    return merged;
+}
+/**
+ * Validate that an update doesn't violate immutable fields (id, createdAt).
+ */
+export function validateImmutableFields(updates) {
+    const immutableFields = ["id", "createdAt"];
+    for (const field of immutableFields) {
+        if (field in updates) {
+            return { valid: false, field };
+        }
+    }
+    return { valid: true };
+}
+// ============================================================================
+// Computed Field Stripping
+// ============================================================================
+/**
+ * Strip computed field keys from an update input object.
+ * Used to remove computed field names from update input before schema validation.
+ *
+ * @param updates - The update payload (possibly with computed field keys)
+ * @param computed - The computed fields configuration that defines which keys to strip
+ * @returns A new object with computed field keys removed
+ */
+const stripComputedFromUpdates = (updates, computed) => {
+    if (computed === undefined || Object.keys(computed).length === 0) {
+        return updates;
+    }
+    const computedKeys = new Set(Object.keys(computed));
+    const result = {};
+    for (const key of Object.keys(updates)) {
+        if (!computedKeys.has(key)) {
+            result[key] = updates[key];
+        }
+    }
+    return result;
+};
+// ============================================================================
+// Unique Constraint Helpers
+// ============================================================================
+/**
+ * Check if an update operation touches any unique fields.
+ *
+ * Extracts the update keys (handling $set operators) and checks if any
+ * intersect with the fields in the unique constraints.
+ *
+ * @param updates - The update payload (may contain direct values or operators)
+ * @param constraints - Normalized unique constraints
+ * @returns True if the update modifies any field that's part of a unique constraint
+ */
+function updateTouchesUniqueFields(updates, constraints) {
+    if (constraints.length === 0) {
+        return false;
+    }
+    // Extract the fields being updated
+    const updateKeys = new Set();
+    for (const [key, value] of Object.entries(updates)) {
+        // Check if it's a $set operator
+        if (typeof value === "object" &&
+            value !== null &&
+            !Array.isArray(value) &&
+            "$set" in value) {
+            updateKeys.add(key);
+        }
+        else if (value !== undefined) {
+            // Direct value assignment or other operators
+            updateKeys.add(key);
+        }
+    }
+    // Check if any update key is in any constraint
+    for (const constraintFields of constraints) {
+        for (const field of constraintFields) {
+            if (updateKeys.has(field)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+// ============================================================================
+// Update Single Entity
+// ============================================================================
+/**
+ * Update a single entity by ID with validation, hooks, and foreign key checks.
+ *
+ * Steps:
+ * 1. Validate immutable fields are not being modified
+ * 2. Look up entity by ID in Ref state (O(1)) - capture as previous
+ * 3. Run beforeUpdate hooks (can transform update payload)
+ * 4. Apply update operators to produce new entity
+ * 5. Validate through Effect Schema
+ * 6. Validate foreign key constraints if relationship fields changed
+ * 7. Atomically update in Ref state
+ * 8. Update indexes if provided
+ */
+export const update = (collectionName, schema, relationships, ref, stateRefs, indexes, hooks, uniqueFields = [], computed, searchIndexRef, searchIndexFields, changePubSub) => (id, updates) => Effect.gen(function* () {
+    // Strip computed field keys from updates (they are derived, not stored)
+    const sanitizedUpdates = stripComputedFromUpdates(updates, computed);
+    // Validate immutable fields
+    const immutableCheck = validateImmutableFields(sanitizedUpdates);
+    if (!immutableCheck.valid) {
+        const fieldName = immutableCheck.field ?? "unknown";
+        return yield* Effect.fail(new ValidationError({
+            message: `Cannot update immutable field: ${fieldName}`,
+            issues: [
+                {
+                    field: fieldName,
+                    message: `Cannot update immutable field: ${fieldName}`,
+                },
+            ],
+        }));
+    }
+    // Look up entity by ID (O(1)) - capture as previous for hooks
+    const currentMap = yield* Ref.get(ref);
+    const previous = currentMap.get(id);
+    if (previous === undefined) {
+        return yield* Effect.fail(new NotFoundError({
+            collection: collectionName,
+            id,
+            message: `Entity '${id}' not found in collection '${collectionName}'`,
+        }));
+    }
+    // Run beforeUpdate hooks (can transform the update payload)
+    const transformedUpdates = yield* runBeforeUpdateHooks(hooks?.beforeUpdate, {
+        operation: "update",
+        collection: collectionName,
+        id,
+        existing: previous,
+        update: sanitizedUpdates,
+    });
+    // Apply update operators with (possibly transformed) updates
+    const updated = applyUpdates(previous, transformedUpdates);
+    // Validate through Effect Schema
+    const validated = yield* validateEntity(schema, updated);
+    // Validate foreign keys if any relationship fields were updated
+    const relationshipFields = Object.keys(relationships).map((field) => relationships[field].foreignKey || `${field}Id`);
+    const hasRelationshipUpdate = Object.keys(transformedUpdates).some((key) => relationshipFields.includes(key));
+    if (hasRelationshipUpdate) {
+        yield* validateForeignKeysEffect(validated, collectionName, relationships, stateRefs);
+    }
+    // Check unique constraints if the update touches any unique fields
+    if (updateTouchesUniqueFields(transformedUpdates, uniqueFields)) {
+        yield* checkUniqueConstraints(validated, currentMap, uniqueFields, collectionName);
+    }
+    // Atomically update in state
+    yield* Ref.update(ref, (map) => {
+        const next = new Map(map);
+        next.set(id, validated);
+        return next;
+    });
+    // Update indexes if provided
+    if (indexes && indexes.size > 0) {
+        yield* updateInIndex(indexes, previous, validated);
+    }
+    // Update search index if configured
+    if (searchIndexRef && searchIndexFields && searchIndexFields.length > 0) {
+        yield* updateInSearchIndex(searchIndexRef, previous, validated, searchIndexFields);
+    }
+    // Run afterUpdate hooks (fire-and-forget, errors swallowed)
+    yield* runAfterUpdateHooks(hooks?.afterUpdate, {
+        operation: "update",
+        collection: collectionName,
+        id,
+        previous,
+        current: validated,
+        update: transformedUpdates,
+    });
+    // Run onChange hooks with type: "update" (fire-and-forget, errors swallowed)
+    yield* runOnChangeHooks(hooks?.onChange, {
+        type: "update",
+        collection: collectionName,
+        id,
+        previous,
+        current: validated,
+    });
+    // Publish change event to reactive subscribers
+    if (changePubSub) {
+        yield* PubSub.publish(changePubSub, {
+            collection: collectionName,
+            operation: "update",
+        });
+    }
+    return validated;
+});
+// ============================================================================
+// Update Multiple Entities
+// ============================================================================
+/**
+ * Update multiple entities matching a filter predicate.
+ *
+ * Uses a predicate function to select which entities to update.
+ * The caller (database factory) can use the Stream-based filter pipeline
+ * to build the predicate from a WhereClause.
+ *
+ * Runs hooks per entity: beforeUpdate can transform the update payload,
+ * afterUpdate and onChange run after state mutation.
+ *
+ * All matching entities are updated atomically in a single Ref.update call.
+ */
+export const updateMany = (collectionName, schema, relationships, ref, stateRefs, indexes, hooks, uniqueFields = [], computed, searchIndexRef, searchIndexFields, changePubSub) => (predicate, updates) => Effect.gen(function* () {
+    // Strip computed field keys from updates (they are derived, not stored)
+    const sanitizedUpdates = stripComputedFromUpdates(updates, computed);
+    // Validate immutable fields
+    const immutableCheck = validateImmutableFields(sanitizedUpdates);
+    if (!immutableCheck.valid) {
+        const fieldName = immutableCheck.field ?? "unknown";
+        return yield* Effect.fail(new ValidationError({
+            message: `Cannot update immutable field: ${fieldName}`,
+            issues: [
+                {
+                    field: fieldName,
+                    message: `Cannot update immutable field: ${fieldName}`,
+                },
+            ],
+        }));
+    }
+    // Get current state and find matching entities
+    const currentMap = yield* Ref.get(ref);
+    const matchingEntities = [];
+    for (const entity of currentMap.values()) {
+        if (predicate(entity)) {
+            matchingEntities.push(entity);
+        }
+    }
+    if (matchingEntities.length === 0) {
+        return { count: 0, updated: [] };
+    }
+    // Apply updates, run beforeUpdate hooks, and validate each entity
+    // We need to track both previous and validated for hooks later
+    const entityPairs = [];
+    for (const entity of matchingEntities) {
+        // Run beforeUpdate hooks (can transform the update payload)
+        const transformedUpdates = yield* runBeforeUpdateHooks(hooks?.beforeUpdate, {
+            operation: "update",
+            collection: collectionName,
+            id: entity.id,
+            existing: entity,
+            update: sanitizedUpdates,
+        });
+        const updated = applyUpdates(entity, transformedUpdates);
+        const validated = yield* validateEntity(schema, updated);
+        entityPairs.push({
+            previous: entity,
+            validated,
+            transformedUpdates: transformedUpdates,
+        });
+    }
+    // Validate foreign keys if relationship fields were updated
+    const relationshipFields = Object.keys(relationships).map((field) => relationships[field].foreignKey || `${field}Id`);
+    const hasRelationshipUpdate = Object.keys(sanitizedUpdates).some((key) => relationshipFields.includes(key));
+    if (hasRelationshipUpdate) {
+        for (const { validated } of entityPairs) {
+            yield* validateForeignKeysEffect(validated, collectionName, relationships, stateRefs);
+        }
+    }
+    // Check unique constraints if the update touches any unique fields
+    if (updateTouchesUniqueFields(sanitizedUpdates, uniqueFields)) {
+        // For updateMany, we need to check each entity against:
+        // 1. Existing entities (excluding entities being updated)
+        // 2. Other entities in the batch (they might conflict with each other)
+        // Create a temporary map that includes our updates for checking
+        const checkMap = new Map(currentMap);
+        for (const { validated } of entityPairs) {
+            checkMap.set(validated.id, validated);
+        }
+        for (const { validated } of entityPairs) {
+            // Check against all other entities (excluding self)
+            yield* checkUniqueConstraints(validated, checkMap, uniqueFields, collectionName);
+        }
+    }
+    // Atomically update all matching entities in state
+    yield* Ref.update(ref, (map) => {
+        const next = new Map(map);
+        for (const { validated } of entityPairs) {
+            next.set(validated.id, validated);
+        }
+        return next;
+    });
+    // Update indexes if provided
+    if (indexes && indexes.size > 0) {
+        for (const { previous, validated } of entityPairs) {
+            yield* updateInIndex(indexes, previous, validated);
+        }
+    }
+    // Update search index if configured
+    if (searchIndexRef && searchIndexFields && searchIndexFields.length > 0) {
+        for (const { previous, validated } of entityPairs) {
+            yield* updateInSearchIndex(searchIndexRef, previous, validated, searchIndexFields);
+        }
+    }
+    // Run afterUpdate and onChange hooks for each updated entity
+    for (const { previous, validated, transformedUpdates } of entityPairs) {
+        // Run afterUpdate hooks (fire-and-forget, errors swallowed)
+        yield* runAfterUpdateHooks(hooks?.afterUpdate, {
+            operation: "update",
+            collection: collectionName,
+            id: validated.id,
+            previous,
+            current: validated,
+            update: transformedUpdates,
+        });
+        // Run onChange hooks with type: "update" (fire-and-forget, errors swallowed)
+        yield* runOnChangeHooks(hooks?.onChange, {
+            type: "update",
+            collection: collectionName,
+            id: validated.id,
+            previous,
+            current: validated,
+        });
+    }
+    // Publish a single change event after all updates are complete
+    if (changePubSub && entityPairs.length > 0) {
+        yield* PubSub.publish(changePubSub, {
+            collection: collectionName,
+            operation: "update",
+        });
+    }
+    return {
+        count: entityPairs.length,
+        updated: entityPairs.map((p) => p.validated),
+    };
+});
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Extract fields that were actually changed between two entity versions.
+ */
+export function getChangedFields(original, updated) {
+    const changed = [];
+    for (const key of Object.keys(updated)) {
+        if (original[key] !== updated[key]) {
+            changed.push(String(key));
+        }
+    }
+    return changed;
+}
+//# sourceMappingURL=update.js.map

package/dist/operations/crud/update.js.map

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

package/dist/operations/crud/upsert.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Effect-based upsert operations for entities.
+ *
+ * Uses Ref<ReadonlyMap> for atomic state mutation, Effect Schema for validation,
+ * and typed errors (ValidationError, ForeignKeyError).
+ *
+ * Upsert = find by `where` clause → update if exists, create if not.
+ */
+import { Effect, PubSub, Ref, type Schema } from "effect";
+import type { ForeignKeyError, HookError, UniqueConstraintError, ValidationError } from "../../errors/crud-errors.js";
+import type { UpsertInternalInput, UpsertManyResult, UpsertResult } from "../../types/crud-types.js";
+import type { HooksConfig } from "../../types/hook-types.js";
+import type { CollectionIndexes } from "../../types/index-types.js";
+import type { ChangeEvent } from "../../types/reactive-types.js";
+import type { SearchIndexMap } from "../../types/search-types.js";
+import { type NormalizedConstraints } from "./unique-check.js";
+type HasId = {
+    readonly id: string;
+};
+type RelationshipConfig = {
+    readonly type: "ref" | "inverse";
+    readonly target: string;
+    readonly foreignKey?: string;
+};
+/**
+ * Upsert a single entity: find by `where`, update if exists, create if not.
+ *
+ * Steps:
+ * 1. Look up entity by where clause in Ref state
+ * 2a. If found: run beforeUpdate hooks, apply update operators, validate, update in state, run afterUpdate/onChange
+ * 2b. If not found: merge where + create data, generate ID/timestamps, validate, run beforeCreate hooks, add to state, run afterCreate/onChange
+ * 3. Validate foreign key constraints
+ * 4. Return entity with __action metadata
+ */
+export declare const upsert: <T extends HasId, I = T>(collectionName: string, schema: Schema.Schema<T, I>, relationships: Record<string, RelationshipConfig>, ref: Ref.Ref<ReadonlyMap<string, T>>, stateRefs: Record<string, Ref.Ref<ReadonlyMap<string, HasId>>>, indexes?: CollectionIndexes, hooks?: HooksConfig<T>, uniqueFields?: NormalizedConstraints, searchIndexRef?: Ref.Ref<SearchIndexMap>, searchIndexFields?: ReadonlyArray<string>, changePubSub?: PubSub.PubSub<ChangeEvent>) => (input: UpsertInternalInput<T>) => Effect.Effect<UpsertResult<T>, ValidationError | ForeignKeyError | HookError | UniqueConstraintError>;
+/**
+ * Upsert multiple entities efficiently.
+ *
+ * For each input:
+ * - If entity matches where clause: apply updates (or skip if unchanged)
+ * - If no match: create new entity
+ *
+ * All changes validated and applied atomically.
+ * Returns categorized results: created, updated, unchanged.
+ *
+ * Runs hooks per entity:
+ * - Create path: beforeCreate → mutation → afterCreate → onChange("create")
+ * - Update path: beforeUpdate → mutation → afterUpdate → onChange("update")
+ */
+export declare const upsertMany: <T extends HasId, I = T>(collectionName: string, schema: Schema.Schema<T, I>, relationships: Record<string, RelationshipConfig>, ref: Ref.Ref<ReadonlyMap<string, T>>, stateRefs: Record<string, Ref.Ref<ReadonlyMap<string, HasId>>>, indexes?: CollectionIndexes, hooks?: HooksConfig<T>, uniqueFields?: NormalizedConstraints, searchIndexRef?: Ref.Ref<SearchIndexMap>, searchIndexFields?: ReadonlyArray<string>, changePubSub?: PubSub.PubSub<ChangeEvent>) => (inputs: ReadonlyArray<UpsertInternalInput<T>>) => Effect.Effect<UpsertManyResult<T>, ValidationError | ForeignKeyError | HookError | UniqueConstraintError>;
+export {};
+//# sourceMappingURL=upsert.d.ts.map

package/dist/operations/crud/upsert.d.ts.map

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