@_linked/core 2.12.0 → 2.13.0-next.20260706164859

package/lib/cjs/paths/pathExprToSparql.js

@@ -1,136 +0,0 @@
-"use strict";
-/*
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.collectPathUris = collectPathUris;
-exports.pathExprToSparql = pathExprToSparql;
-const PropertyPathExpr_js_1 = require("./PropertyPathExpr.js");
-const sparqlUtils_js_1 = require("../sparql/sparqlUtils.js");
-// ---------------------------------------------------------------------------
-// Precedence levels (higher = tighter binding)
-// ---------------------------------------------------------------------------
-const PREC_ALT = 1;
-const PREC_SEQ = 2;
-const PREC_UNARY = 3;
-const PREC_PRIMARY = 4;
-function refToSparql(ref) {
-    if (typeof ref === 'string') {
-        // If it looks like a full IRI (contains ://), use formatUri for prefix shortening
-        if (ref.includes('://'))
-            return (0, sparqlUtils_js_1.formatUri)(ref);
-        // Otherwise treat as prefixed name (already in prefix:local form)
-        return ref;
-    }
-    // {id} refs always contain full IRIs — use formatUri for prefix shortening
-    return (0, sparqlUtils_js_1.formatUri)(ref.id);
-}
-/**
- * Collect all full IRIs from a PathExpr AST.
- * Returns IRIs that need PREFIX declarations (full URIs from string refs
- * containing `://` and from `{id}` refs). Does not collect prefixed-name
- * string refs since those are already in prefix:local form.
- */
-function collectPathUris(expr) {
-    const uris = [];
-    walkPathExpr(expr, uris);
-    return uris;
-}
-function collectRef(ref, uris) {
-    if (typeof ref === 'string') {
-        if (ref.includes('://'))
-            uris.push(ref);
-    }
-    else {
-        uris.push(ref.id);
-    }
-}
-function walkPathExpr(expr, uris) {
-    if ((0, PropertyPathExpr_js_1.isPathRef)(expr)) {
-        collectRef(expr, uris);
-        return;
-    }
-    if ('seq' in expr) {
-        for (const e of expr.seq)
-            walkPathExpr(e, uris);
-        return;
-    }
-    if ('alt' in expr) {
-        for (const e of expr.alt)
-            walkPathExpr(e, uris);
-        return;
-    }
-    if ('inv' in expr) {
-        walkPathExpr(expr.inv, uris);
-        return;
-    }
-    if ('zeroOrMore' in expr) {
-        walkPathExpr(expr.zeroOrMore, uris);
-        return;
-    }
-    if ('oneOrMore' in expr) {
-        walkPathExpr(expr.oneOrMore, uris);
-        return;
-    }
-    if ('zeroOrOne' in expr) {
-        walkPathExpr(expr.zeroOrOne, uris);
-        return;
-    }
-    if ('negatedPropertySet' in expr) {
-        for (const item of expr.negatedPropertySet) {
-            if (typeof item === 'string' || (typeof item === 'object' && 'id' in item && !('inv' in item))) {
-                collectRef(item, uris);
-            }
-            else {
-                collectRef(item.inv, uris);
-            }
-        }
-    }
-}
-/**
- * Render a PathExpr to SPARQL property path syntax.
- * Handles all forms including negatedPropertySet.
- * Adds parentheses only when needed for correct precedence.
- */
-function pathExprToSparql(expr) {
-    return renderExpr(expr, 0);
-}
-function renderExpr(expr, parentPrec) {
-    if ((0, PropertyPathExpr_js_1.isPathRef)(expr)) {
-        return refToSparql(expr);
-    }
-    if ('seq' in expr) {
-        const inner = expr.seq.map((e) => renderExpr(e, PREC_SEQ)).join('/');
-        return parentPrec > PREC_SEQ ? `(${inner})` : inner;
-    }
-    if ('alt' in expr) {
-        const inner = expr.alt.map((e) => renderExpr(e, PREC_ALT)).join('|');
-        return parentPrec > PREC_ALT ? `(${inner})` : inner;
-    }
-    if ('inv' in expr) {
-        return `^${renderExpr(expr.inv, PREC_UNARY)}`;
-    }
-    if ('zeroOrMore' in expr) {
-        return `${renderExpr(expr.zeroOrMore, PREC_PRIMARY)}*`;
-    }
-    if ('oneOrMore' in expr) {
-        return `${renderExpr(expr.oneOrMore, PREC_PRIMARY)}+`;
-    }
-    if ('zeroOrOne' in expr) {
-        return `${renderExpr(expr.zeroOrOne, PREC_PRIMARY)}?`;
-    }
-    if ('negatedPropertySet' in expr) {
-        const items = expr.negatedPropertySet.map((item) => {
-            if (typeof item === 'string' || (typeof item === 'object' && 'id' in item && !('inv' in item))) {
-                return refToSparql(item);
-            }
-            const invItem = item;
-            return `^${refToSparql(invItem.inv)}`;
-        });
-        return items.length === 1 ? `!${items[0]}` : `!(${items.join('|')})`;
-    }
-    throw new Error(`Unknown PathExpr shape: ${JSON.stringify(expr)}`);
-}
-//# sourceMappingURL=pathExprToSparql.js.map

package/lib/cjs/paths/pathExprToSparql.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pathExprToSparql.js","sourceRoot":"","sources":["../../../src/paths/pathExprToSparql.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA+BH,0CAIC;AAqCD,4CAEC;AAvED,+DAAgD;AAChD,6DAAmD;AAEnD,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAC9E,MAAM,QAAQ,GAAG,CAAC,CAAC;AACnB,MAAM,QAAQ,GAAG,CAAC,CAAC;AACnB,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,kFAAkF;QAClF,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAA,0BAAS,EAAC,GAAG,CAAC,CAAC;QAC/C,kEAAkE;QAClE,OAAO,GAAG,CAAC;IACb,CAAC;IACD,2EAA2E;IAC3E,OAAO,IAAA,0BAAS,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,IAAc;IAC5C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,GAAY,EAAE,IAAc;IAC9C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,IAAc,EAAE,IAAc;IAClD,IAAI,IAAA,+BAAS,EAAC,IAAI,CAAC,EAAE,CAAC;QACpB,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IACD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAAC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG;YAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC/E,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAAC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG;YAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC/E,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC5D,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC1E,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACxE,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACxE,IAAI,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC3C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC/F,UAAU,CAAC,IAAe,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAE,IAAuB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,IAAc;IAC7C,OAAO,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,UAAU,CAAC,IAAc,EAAE,UAAkB;IACpD,IAAI,IAAA,+BAAS,EAAC,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,OAAO,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,OAAO,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QACzB,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC;IACzD,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC;IACxD,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC;IACxD,CAAC;IAED,IAAI,oBAAoB,IAAI,IAAI,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC/F,OAAO,WAAW,CAAC,IAAe,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,OAAO,GAAG,IAAsB,CAAC;YACvC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvE,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrE,CAAC"}

package/lib/cjs/queries/ContextRef.d.ts

@@ -1,32 +0,0 @@
-/**
- * The reserved key that tags a **context reference** in DSL-JSON (`{@ctx: name}`).
- *
- * It is one of the DSL-JSON system value-tags — the `@`-sigiled vocabulary for
- * tagged *values* (`@id`, `@date`, `@list`, `@add`/`@remove`, `@unset`, `@path`,
- * `@ctx`). The `@` sigil frees every user property name: a property literally
- * named `date`/`id`/`path`/… no longer collides with a tag. (Structural
- * node-data keys stay `__id`/`__shape`.) The full tag set is defined by the
- * `MutationValueJSON` union (MutationSerialization.ts) + the DSL-JSON codecs and
- * documented in `documentation/dsl-json.md`; only `@ctx` needs a named constant
- * because it is shared across the select/mutation builders and the IR resolver.
- */
-export declare const CONTEXT_REF_KEY = "@ctx";
-/** The wire shape of a context reference: `{@ctx: "<contextName>"}`. */
-export interface ContextRefJSON {
-    [CONTEXT_REF_KEY]: string;
-}
-/** Build a context-reference marker for the given context name. */
-export declare function encodeContextRef(name: string): ContextRefJSON;
-/** Type guard: is this value a `{@ctx: "..."}` context-reference marker? */
-export declare function isContextRefJSON(value: unknown): value is ContextRefJSON;
-/**
- * Resolve a context name to its node id against the current context map.
- *
- * @param name     the context name (e.g. `'user'`)
- * @param required when true, throw {@link UnresolvedContextError} if the context
- *   isn't set (the mutation contract — a mutation must not silently target
- *   nothing). When false, return `undefined` (the select contract — an
- *   unresolved subject simply yields no results, and a reactive layer re-runs
- *   the query once the context lands).
- */
-export declare function resolveContextId(name: string, required: boolean): string | undefined;

package/lib/cjs/queries/ContextRef.js

@@ -1,69 +0,0 @@
-"use strict";
-/*
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTEXT_REF_KEY = void 0;
-exports.encodeContextRef = encodeContextRef;
-exports.isContextRefJSON = isContextRefJSON;
-exports.resolveContextId = resolveContextId;
-/**
- * The unified wire encoding for a *query-context reference*.
- *
- * A context reference is a placeholder for a node id that is not known when the
- * query is authored — e.g. "the currently authenticated user". Instead of
- * resolving it eagerly (which loses the reference and breaks queries built
- * before auth completes), the reference is carried on the wire as a tagged
- * marker and resolved at lowering time against whatever context map is
- * available (client-side React context, server-side auth, …).
- *
- * The same `{@ctx: "<name>"}` marker is used in *every* position a node id can
- * appear: the select subject, the update target, where-clause arguments, and
- * mutation field values. One marker, one resolver, everywhere.
- */
-const QueryContext_js_1 = require("./QueryContext.js");
-/**
- * The reserved key that tags a **context reference** in DSL-JSON (`{@ctx: name}`).
- *
- * It is one of the DSL-JSON system value-tags — the `@`-sigiled vocabulary for
- * tagged *values* (`@id`, `@date`, `@list`, `@add`/`@remove`, `@unset`, `@path`,
- * `@ctx`). The `@` sigil frees every user property name: a property literally
- * named `date`/`id`/`path`/… no longer collides with a tag. (Structural
- * node-data keys stay `__id`/`__shape`.) The full tag set is defined by the
- * `MutationValueJSON` union (MutationSerialization.ts) + the DSL-JSON codecs and
- * documented in `documentation/dsl-json.md`; only `@ctx` needs a named constant
- * because it is shared across the select/mutation builders and the IR resolver.
- */
-exports.CONTEXT_REF_KEY = '@ctx';
-/** Build a context-reference marker for the given context name. */
-function encodeContextRef(name) {
-    return { [exports.CONTEXT_REF_KEY]: name };
-}
-/** Type guard: is this value a `{@ctx: "..."}` context-reference marker? */
-function isContextRefJSON(value) {
-    return (!!value &&
-        typeof value === 'object' &&
-        typeof value[exports.CONTEXT_REF_KEY] === 'string' &&
-        Object.keys(value).length === 1);
-}
-/**
- * Resolve a context name to its node id against the current context map.
- *
- * @param name     the context name (e.g. `'user'`)
- * @param required when true, throw {@link UnresolvedContextError} if the context
- *   isn't set (the mutation contract — a mutation must not silently target
- *   nothing). When false, return `undefined` (the select contract — an
- *   unresolved subject simply yields no results, and a reactive layer re-runs
- *   the query once the context lands).
- */
-function resolveContextId(name, required) {
-    var _a;
-    const id = (_a = (0, QueryContext_js_1.getQueryContext)(name)) === null || _a === void 0 ? void 0 : _a.id;
-    if (!id && required) {
-        throw new QueryContext_js_1.UnresolvedContextError(name);
-    }
-    return id;
-}
-//# sourceMappingURL=ContextRef.js.map

package/lib/cjs/queries/ContextRef.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContextRef.js","sourceRoot":"","sources":["../../../src/queries/ContextRef.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAsCH,4CAEC;AAGD,4CAOC;AAYD,4CASC;AArED;;;;;;;;;;;;;GAaG;AACH,uDAA0E;AAE1E;;;;;;;;;;;GAWG;AACU,QAAA,eAAe,GAAG,MAAM,CAAC;AAOtC,mEAAmE;AACnE,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,OAAO,EAAC,CAAC,uBAAe,CAAC,EAAE,IAAI,EAAC,CAAC;AACnC,CAAC;AAED,4EAA4E;AAC5E,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,CAAC,CAAC,KAAK;QACP,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAAiC,CAAC,uBAAe,CAAC,KAAK,QAAQ;QACvE,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,MAAM,KAAK,CAAC,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAC9B,IAAY,EACZ,QAAiB;;IAEjB,MAAM,EAAE,GAAG,MAAA,IAAA,iCAAe,EAAC,IAAI,CAAC,0CAAE,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,IAAI,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,wCAAsB,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/lib/cjs/queries/CreateBuilder.d.ts

@@ -1,59 +0,0 @@
-import { Shape, type ShapeConstructor } from '../shapes/Shape.js';
-import type { UpdatePartial } from './QueryFactory.js';
-import type { CreateResponse } from './CreateQuery.js';
-import { MutationThenable } from './MutationThenable.js';
-import type { IDataset } from '../interfaces/IDataset.js';
-import type { NodeShape } from '../shapes/SHACL.js';
-import { type CreateMutationJSON } from './MutationSerialization.js';
-import type { CreateLowerSpec } from './mutationLowerSpec.js';
-/**
- * An immutable, fluent builder for create mutations.
- *
- * Every mutation method returns a new CreateBuilder — the original is never modified.
- *
- * Implements PromiseLike so mutations execute on `await`:
- * ```ts
- * const result = await CreateBuilder.from(Person).set({name: 'Alice'});
- * ```
- *
- * Serialization normalizes through the IR-free factory base; IR is produced by
- * the free `lower()` function (the builder itself imports no IR).
- */
-export declare class CreateBuilder<S extends Shape = Shape, U extends UpdatePartial<S> = UpdatePartial<S>> extends MutationThenable<CreateResponse<U>> {
-    protected readonly _tag = "CreateBuilder";
-    private readonly _shape;
-    private readonly _data?;
-    private readonly _fixedId?;
-    private constructor();
-    private clone;
-    /**
-     * Create a CreateBuilder for the given shape.
-     */
-    static from<S extends Shape>(shape: ShapeConstructor<S> | string): CreateBuilder<S>;
-    /** Reconstruct a CreateBuilder from its DSL-JSON (inverse of `toJSON`). */
-    static fromJSON(json: CreateMutationJSON): CreateBuilder;
-    /** Set the data for the entity to create. */
-    set<NewU extends UpdatePartial<S>>(data: NewU): CreateBuilder<S, NewU>;
-    /** Pre-assign a node ID for the created entity. */
-    withId(id: string): CreateBuilder<S, U>;
-    /** Discriminator for the free `lower()` function and dataset routing. */
-    readonly __queryKind: "create";
-    /** The shape this query targets — the routing key datasets/`LinkedStorage` use. */
-    get shape(): NodeShape;
-    /** @internal The IR-free lowering spec consumed by `lower()`. Validates inputs. */
-    _lowerSpec(): CreateLowerSpec<S>;
-    /**
-     * Serialize this create mutation to lightweight DSL-JSON. Normalizes the create
-     * data through the IR-free factory base (the same normalization `lower()` runs)
-     * so the result is concrete and JSON-safe, then encodes the node description.
-     */
-    toJSON(): CreateMutationJSON;
-    /**
-     * Execute the mutation.
-     *
-     * @param target Optional explicit dataset (a store or a router) to run against. Omitted →
-     *   the global query dispatch. A `target` runs on that dataset only; the global router is
-     *   untouched. Rejects if the target dataset doesn't implement create.
-     */
-    exec(target?: IDataset): Promise<CreateResponse<U>>;
-}

package/lib/cjs/queries/CreateBuilder.js

@@ -1,138 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateBuilder = void 0;
-const resolveShape_js_1 = require("./resolveShape.js");
-const MutationQuery_js_1 = require("./MutationQuery.js");
-const MutationThenable_js_1 = require("./MutationThenable.js");
-const queryDispatch_js_1 = require("./queryDispatch.js");
-const wireVersion_js_1 = require("./wireVersion.js");
-const MutationSerialization_js_1 = require("./MutationSerialization.js");
-/**
- * An immutable, fluent builder for create mutations.
- *
- * Every mutation method returns a new CreateBuilder — the original is never modified.
- *
- * Implements PromiseLike so mutations execute on `await`:
- * ```ts
- * const result = await CreateBuilder.from(Person).set({name: 'Alice'});
- * ```
- *
- * Serialization normalizes through the IR-free factory base; IR is produced by
- * the free `lower()` function (the builder itself imports no IR).
- */
-class CreateBuilder extends MutationThenable_js_1.MutationThenable {
-    constructor(init) {
-        super();
-        this._tag = 'CreateBuilder';
-        // ---------------------------------------------------------------------------
-        // Build & execute
-        // ---------------------------------------------------------------------------
-        /** Discriminator for the free `lower()` function and dataset routing. */
-        this.__queryKind = 'create';
-        this._shape = init.shape;
-        this._data = init.data;
-        this._fixedId = init.fixedId;
-    }
-    clone(overrides = {}) {
-        return new CreateBuilder(Object.assign({ shape: this._shape, data: this._data, fixedId: this._fixedId }, overrides));
-    }
-    // ---------------------------------------------------------------------------
-    // Static constructors
-    // ---------------------------------------------------------------------------
-    /**
-     * Create a CreateBuilder for the given shape.
-     */
-    static from(shape) {
-        const resolved = (0, resolveShape_js_1.resolveShape)(shape);
-        return new CreateBuilder({ shape: resolved });
-    }
-    /** Reconstruct a CreateBuilder from its DSL-JSON (inverse of `toJSON`). */
-    static fromJSON(json) {
-        (0, wireVersion_js_1.assertWireVersion)(json.v);
-        const builder = CreateBuilder.from(json.shape);
-        return builder.set((0, MutationSerialization_js_1.decodeNodeDataToRaw)(json.data, builder._shape.shape));
-    }
-    // ---------------------------------------------------------------------------
-    // Fluent API
-    // ---------------------------------------------------------------------------
-    /** Set the data for the entity to create. */
-    set(data) {
-        return this.clone({ data });
-    }
-    /** Pre-assign a node ID for the created entity. */
-    withId(id) {
-        return this.clone({ fixedId: id });
-    }
-    /** The shape this query targets — the routing key datasets/`LinkedStorage` use. */
-    get shape() {
-        return this._shape.shape;
-    }
-    /** @internal The IR-free lowering spec consumed by `lower()`. Validates inputs. */
-    _lowerSpec() {
-        if (!this._data) {
-            throw new Error('CreateBuilder requires .set(data) before it can be lowered. Specify what to create.');
-        }
-        const data = this._data;
-        // Validate that required properties (minCount >= 1) are present in data
-        const shapeObj = this._shape.shape;
-        if (shapeObj) {
-            const requiredProps = shapeObj
-                .getUniquePropertyShapes()
-                .filter((ps) => ps.minCount && ps.minCount >= 1);
-            const dataKeys = new Set(Object.keys(data));
-            const missing = requiredProps
-                .filter((ps) => !dataKeys.has(ps.label))
-                .map((ps) => ps.label);
-            if (missing.length > 0) {
-                throw new Error(`Missing required fields for '${shapeObj.label || shapeObj.id}': ${missing.join(', ')}`);
-            }
-        }
-        // TODO: Full data validation against the shape (type checking, maxCount, nested shapes, etc.)
-        // Inject __id if fixedId is set
-        const dataWithId = this._fixedId
-            ? Object.assign(Object.assign({}, data), { __id: this._fixedId }) : data;
-        return { shapeClass: this._shape, data: dataWithId };
-    }
-    /**
-     * Serialize this create mutation to lightweight DSL-JSON. Normalizes the create
-     * data through the IR-free factory base (the same normalization `lower()` runs)
-     * so the result is concrete and JSON-safe, then encodes the node description.
-     */
-    toJSON() {
-        if (!this._data) {
-            throw new Error('CreateBuilder requires .set(data) before .toJSON().');
-        }
-        const dataWithId = this._fixedId
-            ? Object.assign(Object.assign({}, this._data), { __id: this._fixedId }) : this._data;
-        const description = new MutationQuery_js_1.MutationQueryFactory().describe(this._shape.shape, dataWithId, true);
-        return {
-            v: wireVersion_js_1.WIRE_VERSION,
-            op: 'create',
-            shape: this._shape.shape.id,
-            data: (0, MutationSerialization_js_1.encodeNodeData)(description, this._shape.shape),
-        };
-    }
-    /**
-     * Execute the mutation.
-     *
-     * @param target Optional explicit dataset (a store or a router) to run against. Omitted →
-     *   the global query dispatch. A `target` runs on that dataset only; the global router is
-     *   untouched. Rejects if the target dataset doesn't implement create.
-     */
-    exec(target) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return (0, queryDispatch_js_1.resolveMutationDispatch)('create', target).createQuery(this);
-        });
-    }
-}
-exports.CreateBuilder = CreateBuilder;
-//# sourceMappingURL=CreateBuilder.js.map

package/lib/cjs/queries/CreateBuilder.js.map

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

package/lib/cjs/queries/CreateQuery.d.ts

@@ -1,20 +0,0 @@
-import type { AddId } from './QueryFactory.js';
-import type { IRCreateMutation } from './IntermediateRepresentation.js';
-import type { NodeShape } from '../shapes/SHACL.js';
-import type { CreateMutationJSON } from './MutationSerialization.js';
-import type { CreateLowerSpec } from './mutationLowerSpec.js';
-/**
- * The closed, read-only create query a dataset receives (implemented by
- * `CreateBuilder`). The IR is `IRCreateQuery`, produced by `lower(query)` — the
- * IR construction lives in the IR tier, not here, so this module stays IR-free.
- */
-export interface CreateQuery {
-    readonly __queryKind: 'create';
-    readonly shape: NodeShape;
-    toJSON(): CreateMutationJSON;
-    /** @internal IR-free lowering spec consumed by `lower()`. */
-    _lowerSpec(): CreateLowerSpec;
-}
-/** The lowered IR for a create mutation (what `lower()` produces). */
-export type IRCreateQuery = IRCreateMutation;
-export type CreateResponse<U> = AddId<U, true>;

package/lib/cjs/queries/CreateQuery.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=CreateQuery.js.map

package/lib/cjs/queries/CreateQuery.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CreateQuery.js","sourceRoot":"","sources":["../../../src/queries/CreateQuery.ts"],"names":[],"mappings":""}

package/lib/cjs/queries/DeleteBuilder.d.ts

@@ -1,56 +0,0 @@
-import { Shape, type ShapeConstructor } from '../shapes/Shape.js';
-import type { DeleteResponse } from './DeleteQuery.js';
-import type { NodeId } from './MutationQuery.js';
-import { MutationThenable } from './MutationThenable.js';
-import type { IDataset } from '../interfaces/IDataset.js';
-import type { NodeShape } from '../shapes/SHACL.js';
-import { type WhereClause } from './SelectQuery.js';
-import { type DeleteMutationJSON } from './MutationSerialization.js';
-import type { DeleteLowerSpec } from './mutationLowerSpec.js';
-import { PendingQueryContext } from './QueryContext.js';
-/** A node to delete: a concrete id, a `{id}` ref, or a live query-context reference. */
-export type DeleteId = NodeId | PendingQueryContext;
-/**
- * An immutable, fluent builder for delete mutations.
- *
- * Implements PromiseLike so mutations execute on `await`:
- * ```ts
- * const result = await DeleteBuilder.from(Person, {id: '...'});
- * await DeleteBuilder.from(Person).all();  // returns void
- * ```
- *
- * R is the resolved type: DeleteResponse for ID-based, void for bulk operations.
- */
-export declare class DeleteBuilder<S extends Shape = Shape, R = DeleteResponse> extends MutationThenable<R> {
-    protected readonly _tag = "DeleteBuilder";
-    private readonly _shape;
-    private readonly _ids?;
-    private readonly _mode?;
-    private readonly _whereFn?;
-    private readonly _where?;
-    private constructor();
-    private clone;
-    static from<S extends Shape>(shape: ShapeConstructor<S> | string, ids?: DeleteId | DeleteId[]): DeleteBuilder<S, DeleteResponse>;
-    /** Reconstruct a DeleteBuilder from its DSL-JSON (inverse of `toJSON`). */
-    static fromJSON(json: DeleteMutationJSON): DeleteBuilder;
-    /** Delete all instances of this shape type. Returns void. */
-    all(): DeleteBuilder<S, void>;
-    /** Delete instances matching a condition. Returns void. */
-    where(fn: WhereClause<S>): DeleteBuilder<S, void>;
-    /** Discriminator for the free `lower()` function and dataset routing. */
-    readonly __queryKind: "delete";
-    /** The shape this query targets — the routing key datasets/`LinkedStorage` use. */
-    get shape(): NodeShape;
-    /** @internal The IR-free lowering spec consumed by `lower()`. Validates inputs. */
-    _lowerSpec(): DeleteLowerSpec<S>;
-    /** Serialize this delete mutation to lightweight DSL-JSON. */
-    toJSON(): DeleteMutationJSON;
-    /**
-     * Execute the mutation.
-     *
-     * @param target Optional explicit dataset (a store or a router) to run against. Omitted →
-     *   the global query dispatch. A `target` runs on that dataset only; the global router is
-     *   untouched. Rejects if the target dataset doesn't implement delete.
-     */
-    exec(target?: IDataset): Promise<R>;
-}