@_linked/core 1.2.0-next.20260304061428 → 1.2.0-next.20260312041833

package/CHANGELOG.md

@@ -4,73 +4,52 @@
 
 ### Minor Changes
 
-- [#20](https://github.com/Semantu/linked/pull/20) [`33e9fb0`](https://github.com/Semantu/linked/commit/33e9fb0205343eca8c84723cbabc3f3342e40be5) Thanks [@flyon](https://github.com/flyon)! - **Breaking:** `QueryParser` has been removed. If you imported `QueryParser` directly, replace with `getQueryDispatch()` from `@_linked/core/queries/queryDispatch`. The Shape DSL (`Shape.select()`, `.create()`, `.update()`, `.delete()`) and `SelectQuery.exec()` are unchanged.
+- [#31](https://github.com/Semantu/linked/pull/31) [`eb88865`](https://github.com/Semantu/linked/commit/eb8886564f2c9663805c4308a834ca615f9a1dab) Thanks [@flyon](https://github.com/flyon)! - Properties in `select()` and `update()` now support expressions — you can compute values dynamically instead of just reading or writing raw fields.
 
-  **New:** `getQueryDispatch()` and `setQueryDispatch()` are now exported, allowing custom query dispatch implementations (e.g. for testing or alternative storage backends) without subclassing `LinkedStorage`.
+  ### What's new
 
-- [#9](https://github.com/Semantu/linked/pull/9) [`381067b`](https://github.com/Semantu/linked/commit/381067b0fbc25f4a0446c5f8cc0eec57ddded466) Thanks [@flyon](https://github.com/flyon)! - Replaced internal query representation with a canonical backend-agnostic IR AST. `SelectQuery`, `CreateQuery`, `UpdateQuery`, and `DeleteQuery` are now typed IR objects with `kind` discriminators, compact shape/property ID references, and expression trees — replacing the previous ad-hoc nested arrays. The public Shape DSL is unchanged; what changed is what `IQuadStore` implementations receive. Store result types (`ResultRow`, `SelectResult`, `CreateResult`, `UpdateResult`) are now exported. All factories expose `build()` as the primary method. See `documentation/intermediate-representation.md` for the full IR reference and migration guidance.
+  - **Computed fields in queries** — chain expression methods on properties to derive new values: string manipulation (`.strlen()`, `.ucase()`, `.concat()`), arithmetic (`.plus()`, `.times()`, `.abs()`), date extraction (`.year()`, `.month()`, `.hours()`), and comparisons (`.gt()`, `.eq()`, `.contains()`).
 
-- [#14](https://github.com/Semantu/linked/pull/14) [`b65e156`](https://github.com/Semantu/linked/commit/b65e15688ac173478e58e1dbb9f26dbaf5fc5a37) Thanks [@flyon](https://github.com/flyon)! - Add SPARQL conversion layer — compiles Linked IR queries into executable SPARQL and maps results back to typed DSL objects.
-
-  **New exports from `@_linked/core/sparql`:**
-
-  - **`SparqlStore`** — abstract base class for SPARQL-backed stores. Extend it and implement two methods to connect any SPARQL 1.1 endpoint:
-
-    ```ts
-    import { SparqlStore } from "@_linked/core/sparql";
-
-    class MyStore extends SparqlStore {
-      protected async executeSparqlSelect(
-        sparql: string
-      ): Promise<SparqlJsonResults> {
-        /* ... */
-      }
-      protected async executeSparqlUpdate(sparql: string): Promise<void> {
-        /* ... */
-      }
-    }
+    ```typescript
+    await Person.select((p) => ({
+      name: p.name,
+      nameLen: p.name.strlen(),
+      ageInMonths: p.age.times(12),
+    }));
     ```
 
-  - **IR → SPARQL string** convenience functions (full pipeline in one call):
-
-    - `selectToSparql(query, options?)` — SelectQuery → SPARQL string
-    - `createToSparql(query, options?)` — CreateQuery → SPARQL string
-    - `updateToSparql(query, options?)` — UpdateQuery → SPARQL string
-    - `deleteToSparql(query, options?)` — DeleteQuery → SPARQL string
-
-  - **IR → SPARQL algebra** (for stores that want to inspect/optimize the algebra before serialization):
-
-    - `selectToAlgebra(query, options?)` — returns `SparqlSelectPlan`
-    - `createToAlgebra(query, options?)` — returns `SparqlInsertDataPlan`
-    - `updateToAlgebra(query, options?)` — returns `SparqlDeleteInsertPlan`
-    - `deleteToAlgebra(query, options?)` — returns `SparqlDeleteInsertPlan`
-
-  - **Algebra → SPARQL string** serialization:
+  - **Expression-based WHERE filters** — filter using computed conditions, not just equality checks. Works on queries, updates, and deletes.
 
-    - `selectPlanToSparql(plan, options?)`, `insertDataPlanToSparql(plan, options?)`, `deleteInsertPlanToSparql(plan, options?)`, `deleteWherePlanToSparql(plan, options?)`
-    - `serializeAlgebraNode(node)`, `serializeExpression(expr)`, `serializeTerm(term)`
-
-  - **Result mapping** (SPARQL JSON results → typed DSL objects):
-
-    - `mapSparqlSelectResult(json, query)` — handles flat/nested/aggregated results with XSD type coercion
-    - `mapSparqlCreateResult(uri, query)` — echoes created fields with generated URI
-    - `mapSparqlUpdateResult(query)` — echoes updated fields
+    ```typescript
+    await Person.select((p) => p.name).where((p) => p.name.strlen().gt(5));
+    await Person.update({ verified: true }).where((p) => p.age.gte(18));
+    ```
 
-  - **All algebra types** re-exported: `SparqlTerm`, `SparqlTriple`, `SparqlAlgebraNode`, `SparqlExpression`, `SparqlSelectPlan`, `SparqlInsertDataPlan`, `SparqlDeleteInsertPlan`, `SparqlDeleteWherePlan`, `SparqlPlan`, `SparqlOptions`, etc.
+  - **Computed updates** — when updating data, calculate new values based on existing ones instead of providing static values. Pass a callback to `update()` to reference current field values.
 
-  **Bug fixes included:**
+    ```typescript
+    await Person.update((p) => ({ age: p.age.plus(1) })).for(entity);
+    await Person.update((p) => ({
+      label: p.firstName.concat(" ").concat(p.lastName),
+    })).for(entity);
+    ```
 
-  - Fixed `isNodeReference()` in MutationQuery.ts — nested creates with predefined IDs (e.g., `{id: '...', name: 'Bestie'}`) now correctly insert entity data instead of only creating the link.
+  - **`Expr` module** — for expressions that don't start from a property, like the current timestamp, conditional logic, or coalescing nulls.
 
-  See [SPARQL Algebra Layer docs](./documentation/sparql-algebra.md) for the full type reference, conversion rules, and store implementation guide.
+    ```typescript
+    await Person.update({ lastSeen: Expr.now() }).for(entity);
+    await Person.select((p) => ({
+      displayName: Expr.firstDefined(p.nickname, p.name),
+    }));
+    ```
 
-### Patch Changes
+  Update expression callbacks are fully typed — `.plus()` only appears on number properties, `.strlen()` only on strings, etc.
 
-- [#17](https://github.com/Semantu/linked/pull/17) [`0654780`](https://github.com/Semantu/linked/commit/06547807a7bae56e992eba73263f83e092b7788b) Thanks [@flyon](https://github.com/flyon)! - Preserve nested array sub-select branches in canonical IR so `build()` emits complete traversals, projection fields, and `resultMap` entries for nested selections.
+  ### New exports
 
-  This fixes cases where nested branches present in `toRawInput().select` were dropped during desugar/lowering (for example nested `friends.select([name, hobby])` branches under another sub-select).
+  `ExpressionNode`, `Expr`, `ExpressionInput`, `PropertyRefMap`, `ExpressionUpdateProxy<S>`, `ExpressionUpdateResult<S>`, and per-type method interfaces (`NumericExpressionMethods`, `StringExpressionMethods`, `DateExpressionMethods`, `BooleanExpressionMethods`, `BaseExpressionMethods`).
 
-  Also adds regression coverage for desugar preservation, IR lowering completeness, and updated SPARQL golden output for nested query fixtures.
+  See the [README](./README.md#computed-expressions) for the full method reference and more examples.
 
 ## 1.1.0