@_linked/core 2.12.0 → 2.13.0

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

@@ -1,39 +0,0 @@
-import type { DesugaredSelectionPath, DesugaredWhere } from './IRDesugar.js';
-import { IRAliasScope } from './IRAliasScope.js';
-import type { IRExpression, IRProjectionItem, IRResultMapEntry } from './IntermediateRepresentation.js';
-import type { PathExpr } from '../paths/PropertyPathExpr.js';
-/**
- * Callback invoked when a property step with an inline `.where()` is encountered
- * during path lowering. The callback receives the traversal alias (target entity)
- * and the desugared where predicate so the caller can canonicalize and lower it.
- */
-export type InlineFilterCallback = (traverseAlias: string, where: DesugaredWhere) => void;
-export type ProjectionPathLoweringOptions = {
-    rootAlias: string;
-    resolveTraversal: (fromAlias: string, propertyShapeId: string, pathExpr?: PathExpr, maxCount?: number) => string;
-};
-export type CanonicalProjectionResult = {
-    projection: IRProjectionItem[];
-    resultMap?: IRResultMapEntry[];
-};
-export type ProjectionPathInput = DesugaredSelectionPath | {
-    path: DesugaredSelectionPath;
-    key?: string;
-};
-/** Derives a result key name from the last step of a selection path. */
-export declare const projectionKeyFromPath: (path: DesugaredSelectionPath) => string;
-/**
- * Lowers a single desugared selection path into an IR expression,
- * creating traversal aliases for intermediate property steps.
- *
- * When `onInlineFilter` is provided, property steps with `.where()` will
- * force a traversal creation and invoke the callback with the traversal
- * alias and the where predicate. For last steps with `.where()`, an
- * `alias_expr` is returned instead of a `property_expr`.
- */
-export declare const lowerSelectionPathExpression: (path: DesugaredSelectionPath, options: ProjectionPathLoweringOptions, onInlineFilter?: InlineFilterCallback) => IRExpression;
-/**
- * Builds projection items and a result map from an array of selection paths.
- * Each path gets a unique alias and is lowered into an IR expression.
- */
-export declare const buildCanonicalProjection: (selections: ProjectionPathInput[], options: ProjectionPathLoweringOptions, scope?: IRAliasScope) => CanonicalProjectionResult;

package/lib/cjs/queries/IRProjection.js

@@ -1,105 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildCanonicalProjection = exports.lowerSelectionPathExpression = exports.projectionKeyFromPath = void 0;
-const IRAliasScope_js_1 = require("./IRAliasScope.js");
-/** Derives a result key name from the last step of a selection path. */
-const projectionKeyFromPath = (path) => {
-    if (!path.steps.length)
-        return 'value';
-    const lastStep = path.steps[path.steps.length - 1];
-    if (lastStep.kind === 'property_step')
-        return lastStep.propertyShapeId;
-    if (lastStep.kind === 'count_step')
-        return lastStep.label || 'count';
-    if (lastStep.kind === 'type_cast_step')
-        return lastStep.shapeId;
-    return 'value';
-};
-exports.projectionKeyFromPath = projectionKeyFromPath;
-/**
- * Lowers a single desugared selection path into an IR expression,
- * creating traversal aliases for intermediate property steps.
- *
- * When `onInlineFilter` is provided, property steps with `.where()` will
- * force a traversal creation and invoke the callback with the traversal
- * alias and the where predicate. For last steps with `.where()`, an
- * `alias_expr` is returned instead of a `property_expr`.
- */
-const lowerSelectionPathExpression = (path, options, onInlineFilter) => {
-    if (path.steps.length === 0) {
-        return { kind: 'alias_expr', alias: options.rootAlias };
-    }
-    let currentAlias = options.rootAlias;
-    for (let i = 0; i < path.steps.length; i++) {
-        const step = path.steps[i];
-        const isLast = i === path.steps.length - 1;
-        if (step.kind === 'property_step') {
-            if (step.where && onInlineFilter) {
-                // Force traversal creation for step with inline where
-                currentAlias = options.resolveTraversal(currentAlias, step.propertyShapeId, step.pathExpr, step.maxCount);
-                onInlineFilter(currentAlias, step.where);
-                if (isLast) {
-                    return { kind: 'alias_expr', alias: currentAlias };
-                }
-                continue;
-            }
-            if (isLast) {
-                const expr = {
-                    kind: 'property_expr',
-                    sourceAlias: currentAlias,
-                    property: step.propertyShapeId,
-                };
-                if (step.pathExpr) {
-                    expr.pathExpr = step.pathExpr;
-                }
-                if (typeof step.maxCount === 'number') {
-                    expr.maxCount = step.maxCount;
-                }
-                return expr;
-            }
-            currentAlias = options.resolveTraversal(currentAlias, step.propertyShapeId, step.pathExpr, step.maxCount);
-            continue;
-        }
-        if (step.kind === 'count_step') {
-            return {
-                kind: 'aggregate_expr',
-                name: 'count',
-                args: step.path.map((propertyStep) => ({
-                    kind: 'property_expr',
-                    sourceAlias: currentAlias,
-                    property: propertyStep.propertyShapeId,
-                })),
-            };
-        }
-    }
-    return { kind: 'alias_expr', alias: currentAlias };
-};
-exports.lowerSelectionPathExpression = lowerSelectionPathExpression;
-/**
- * Builds projection items and a result map from an array of selection paths.
- * Each path gets a unique alias and is lowered into an IR expression.
- */
-const buildCanonicalProjection = (selections, options, scope = new IRAliasScope_js_1.IRAliasScope('projection')) => {
-    const projection = [];
-    const entries = [];
-    selections.forEach((selection) => {
-        const path = 'path' in selection ? selection.path : selection;
-        const key = 'path' in selection ? selection.key : undefined;
-        const resultKey = key || (0, exports.projectionKeyFromPath)(path);
-        const binding = scope.generateAlias(resultKey);
-        projection.push({
-            alias: binding.alias,
-            expression: (0, exports.lowerSelectionPathExpression)(path, options),
-        });
-        entries.push({
-            key: resultKey,
-            alias: binding.alias,
-        });
-    });
-    return {
-        projection,
-        resultMap: entries,
-    };
-};
-exports.buildCanonicalProjection = buildCanonicalProjection;
-//# sourceMappingURL=IRProjection.js.map

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

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

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

@@ -1,282 +0,0 @@
-import { NodeReferenceValue } from './QueryFactory.js';
-import type { PathExpr } from '../paths/PropertyPathExpr.js';
-export type IRDirection = 'ASC' | 'DESC';
-export type IRAlias = string;
-export type IRValue = string | number | boolean | null;
-export type IRQuery = IRSelectQuery | IRCreateMutation | IRUpdateMutation | IRDeleteMutation | IRDeleteAllMutation | IRDeleteWhereMutation | IRUpdateWhereMutation;
-export type IRSelectQuery = {
-    kind: 'select';
-    root: IRShapeScanPattern;
-    patterns: IRGraphPattern[];
-    projection: IRProjectionItem[];
-    where?: IRExpression;
-    orderBy?: IROrderByItem[];
-    limit?: number;
-    offset?: number;
-    subjectId?: string;
-    subjectIds?: string[];
-    singleResult?: boolean;
-    resultMap?: IRResultMapEntry[];
-};
-export type IRProjectionItem = {
-    alias: IRAlias;
-    expression: IRExpression;
-};
-export type IROrderByItem = {
-    expression: IRExpression;
-    direction: IRDirection;
-};
-export type IRResultMapEntry = {
-    key: string;
-    alias: IRAlias;
-};
-export type IRGraphPattern = IRShapeScanPattern | IRTraversePattern | IRJoinPattern | IROptionalPattern | IRUnionPattern | IRExistsPattern | IRMinusPattern;
-export type IRShapeScanPattern = {
-    kind: 'shape_scan';
-    shape: string;
-    alias: IRAlias;
-};
-export type IRTraversePattern = {
-    kind: 'traverse';
-    from: IRAlias;
-    to: IRAlias;
-    property: string;
-    pathExpr?: PathExpr;
-    filter?: IRExpression;
-    maxCount?: number;
-    /**
-     * Inner LIMIT/OFFSET/ORDER BY for a nested select on this traversal's
-     * related collection. When set, the root→child traverse is wrapped in a
-     * SPARQL sub-SELECT to bound the collection per parent. Only valid when the
-     * outer query targets a single root subject (enforced in irToAlgebra).
-     */
-    innerLimit?: number;
-    innerOffset?: number;
-    innerOrderBy?: IRInnerOrderBy[];
-};
-export type IRInnerOrderBy = {
-    property: string;
-    direction: IRDirection;
-};
-export type IRJoinPattern = {
-    kind: 'join';
-    patterns: IRGraphPattern[];
-};
-export type IROptionalPattern = {
-    kind: 'optional';
-    pattern: IRGraphPattern;
-};
-export type IRUnionPattern = {
-    kind: 'union';
-    branches: IRGraphPattern[];
-};
-export type IRExistsPattern = {
-    kind: 'exists';
-    pattern: IRGraphPattern;
-};
-export type IRMinusPattern = {
-    kind: 'minus';
-    pattern: IRGraphPattern;
-    filter?: IRExpression;
-};
-export type IRExpression = IRLiteralExpression | IRReferenceExpression | IRAliasExpression | IRPropertyExpression | IRContextPropertyExpression | IRBinaryExpression | IRLogicalExpression | IRNotExpression | IRFunctionExpression | IRAggregateExpression | IRExistsExpression | IRInExpression;
-/**
- * Membership test — `value IN (…)` / `NOT IN (…)`.
- * `source` is forward-shaped: today only the explicit-`list` arm exists (Rung 1);
- * a `{query}` arm (Rung 2 — membership against a subquery, lowering to EXISTS)
- * can be added without changing the node's identity or the `oneOf`/`notOneOf` DSL.
- */
-export type IRInExpression = {
-    kind: 'in_expr';
-    negated: boolean;
-    value: IRExpression;
-    source: {
-        list: IRExpression[];
-    };
-};
-export type IRLiteralExpression = {
-    kind: 'literal_expr';
-    value: IRValue;
-};
-export type IRReferenceExpression = {
-    kind: 'reference_expr';
-    /** The referenced node IRI. Optional only while a `contextName` is unresolved. */
-    value?: string;
-    /**
-     * A query-context reference (`{@ctx}` on the wire). When set, `value` is filled
-     * by `lower()` from the live context map — resolved or thrown there, never baked
-     * at build time. Absent for a plain node reference.
-     */
-    contextName?: string;
-};
-export type IRAliasExpression = {
-    kind: 'alias_expr';
-    alias: IRAlias;
-};
-export type IRPropertyExpression = {
-    kind: 'property_expr';
-    sourceAlias: IRAlias;
-    property: string;
-    pathExpr?: import('../paths/PropertyPathExpr.js').PathExpr;
-    maxCount?: number;
-};
-export type IRContextPropertyExpression = {
-    kind: 'context_property_expr';
-    /** The context entity IRI. Optional only while a `contextName` is unresolved. */
-    contextIri?: string;
-    /** A query-context reference resolved into `contextIri` by `lower()`. */
-    contextName?: string;
-    property: string;
-};
-export type IRBinaryOperator = '=' | '!=' | '>' | '>=' | '<' | '<=' | '+' | '-' | '*' | '/';
-export type IRBinaryExpression = {
-    kind: 'binary_expr';
-    operator: IRBinaryOperator;
-    left: IRExpression;
-    right: IRExpression;
-};
-export type IRLogicalOperator = 'and' | 'or';
-export type IRLogicalExpression = {
-    kind: 'logical_expr';
-    operator: IRLogicalOperator;
-    expressions: IRExpression[];
-};
-export type IRNotExpression = {
-    kind: 'not_expr';
-    expression: IRExpression;
-};
-export type IRFunctionExpression = {
-    kind: 'function_expr';
-    name: string;
-    args: IRExpression[];
-};
-export type IRAggregateExpression = {
-    kind: 'aggregate_expr';
-    name: 'count' | 'sum' | 'avg' | 'min' | 'max';
-    args: IRExpression[];
-};
-export type IRExistsExpression = {
-    kind: 'exists_expr';
-    pattern: IRGraphPattern;
-    filter?: IRExpression;
-};
-export type IRCreateMutation = {
-    kind: 'create';
-    shape: string;
-    data: IRNodeData;
-};
-export type IRTraversalPattern = {
-    from: string;
-    property: string;
-    to: string;
-};
-export type IRUpdateMutation = {
-    kind: 'update';
-    shape: string;
-    id: string;
-    data: IRNodeData;
-    traversalPatterns?: IRTraversalPattern[];
-};
-export type IRDeleteMutation = {
-    kind: 'delete';
-    shape: string;
-    ids: NodeReferenceValue[];
-};
-export type IRDeleteAllMutation = {
-    kind: 'delete_all';
-    shape: string;
-};
-export type IRDeleteWhereMutation = {
-    kind: 'delete_where';
-    shape: string;
-    where: IRExpression;
-    wherePatterns: IRGraphPattern[];
-};
-export type IRUpdateWhereMutation = {
-    kind: 'update_where';
-    shape: string;
-    data: IRNodeData;
-    where?: IRExpression;
-    wherePatterns?: IRGraphPattern[];
-    traversalPatterns?: IRTraversalPattern[];
-};
-export type IRNodeData = {
-    shape: string;
-    fields: IRFieldUpdate[];
-    id?: string;
-};
-export type IRFieldUpdate = {
-    property: string;
-    value: IRFieldValue;
-};
-export type IRSetModificationValue = {
-    add?: IRFieldValue[];
-    remove?: NodeReferenceValue[];
-};
-export type IRFieldValue = IRValue | Date | NodeReferenceValue | IRNodeData | IRSetModificationValue | IRFieldValue[] | IRExpression | undefined;
-/**
- * A single result row — an object with a node id and dynamic fields.
- * Used in select and create results.
- */
-export type ResultRow = {
-    id: string;
-    [key: string]: ResultFieldValue;
-};
-/**
- * Possible field values in a select or create result row.
- */
-export type ResultFieldValue = string | number | boolean | Date | null | undefined | ResultRow | ResultRow[] | string[] | number[] | boolean[] | Date[];
-/**
- * What `selectQuery` should return.
- *
- * - Array of rows for multi-result queries (the default).
- * - A single row when `query.singleResult` is true (`.one()` or subject-targeted query).
- * - `null` when `singleResult` is true and the target node doesn't exist.
- */
-export type SelectResult = ResultRow[] | ResultRow | null;
-/**
- * What `createQuery` should return.
- *
- * A single row with the generated `id` and the created field values.
- * Nested creates appear as nested `ResultRow` objects (with their own ids).
- * Array fields (e.g. friends) appear as `ResultRow[]`.
- */
-export type CreateResult = ResultRow;
-/**
- * When a set property is fully overwritten, the result contains `updatedTo`
- * with the new complete set of values.
- */
-export type SetOverwriteResult = {
-    updatedTo: ResultRow[];
-};
-/**
- * When a set property is incrementally modified with `{add, remove}`,
- * the result contains the added and removed entries.
- */
-export type SetModificationResult = {
-    added: ResultRow[];
-    removed: ResultRow[];
-};
-/**
- * Possible field values in an update result row.
- * Extends `ResultFieldValue` with set modification shapes.
- */
-export type UpdateFieldValue = ResultFieldValue | SetOverwriteResult | SetModificationResult;
-/**
- * What `updateQuery` should return.
- *
- * A single row with the target node's `id` and only the changed fields.
- * Fields not included in the update are omitted (not returned).
- *
- * Field value shapes depend on the type of update:
- * - Literal fields: the new value (string, number, boolean, Date).
- * - Single object fields: a `ResultRow` with the referenced/created node.
- * - Set overwrite (passing an array): `{updatedTo: ResultRow[]}`.
- * - Set add/remove (passing `{add, remove}`): `{added: ResultRow[], removed: ResultRow[]}`.
- * - Unset single field (passing `undefined` or `null`): field is `undefined`.
- * - Unset multi-value field (passing `undefined`): empty array `[]`.
- */
-export type UpdateResult = {
-    id: string;
-    [key: string]: UpdateFieldValue;
-};

package/lib/cjs/queries/IntermediateRepresentation.js

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

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

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

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

@@ -1,50 +0,0 @@
-import { type NodeDescriptionValue, NodeReferenceValue, type PropUpdateValue, QueryFactory, type SetModification, type SetModificationValue, type UpdateNodePropertyValue, type UpdatePartial } from './QueryFactory.js';
-import type { NodeShape, PropertyShape } from '../shapes/SHACL.js';
-export type NodeId = {
-    id: string;
-} | string;
-export declare class MutationQueryFactory extends QueryFactory {
-    /**
-     * Normalize raw create/update data into a {@link NodeDescriptionValue} — the
-     * IR-free step shared by `toJSON()` and `lower()`. Kept on this base (which
-     * imports no IR) so the builders can normalize for serialization without
-     * pulling the canonical-IR pipeline.
-     */
-    describe(shape: NodeShape, data: unknown, allowTopLevelId?: boolean): NodeDescriptionValue;
-    /** Normalize delete ids (strings / `{id}`) to `NodeReferenceValue[]` (IR-free). */
-    normalizeNodeRefs(ids: NodeId[] | NodeId): NodeReferenceValue[];
-    protected convertUpdateObject(obj: any, shape: NodeShape, allowTopLevelId?: boolean): NodeDescriptionValue;
-    protected isSetModification(obj: any, shape: any): boolean;
-    protected convertSetModification(obj: SetModification<any>, shape: PropertyShape): SetModificationValue;
-    protected convertSetRemoveValue(obj: UpdatePartial | UpdatePartial[], shape: PropertyShape): NodeReferenceValue[];
-    protected convertSetAddValue(obj: UpdatePartial | UpdatePartial[], shape: PropertyShape): UpdatePartial[];
-    protected convertSingleRemoveValue(value: any, shape: PropertyShape): NodeReferenceValue;
-    protected convertNodeDescription(inputObj: Record<string, unknown>, shape: NodeShape): NodeDescriptionValue;
-    protected createNodePropertyValue(value: any, propShape: PropertyShape): UpdateNodePropertyValue;
-    /**
-     * Lightweight structural validation of a single property value against its
-     * PropertyShape — cardinality (`minCount`/`maxCount`) and node-kind (literal
-     * vs relation). This is *structural* only (from metadata already in hand); it
-     * does not duplicate datatype/deep validation, which the store performs. It
-     * fails fast at the call site with a clear message instead of surfacing a
-     * confusing store error later.
-     *
-     * Skips values whose final shape isn't known here: computed expressions,
-     * context refs, `unset` (null/undefined), and set-modifications (`{add,remove}`
-     * — the resulting count depends on the node's current state).
-     */
-    protected validateAgainstShape(value: any, propShape: PropertyShape): void;
-    /** True when the property clearly accepts only literal values. */
-    private expectsLiteral;
-    /** True when the property clearly accepts only nodes (IRIs/blank nodes). */
-    private expectsNode;
-    protected convertUpdateValue(value: any, propShape?: PropertyShape, allowArrays?: boolean): PropUpdateValue;
-    protected isNodeReference(obj: any): obj is NodeReferenceValue;
-    protected convertNodeReferences(input: NodeId[] | NodeId): NodeReferenceValue[];
-    protected convertNodeReferenceOrString(o: {
-        id: string;
-    } | string): NodeReferenceValue;
-    protected convertNodeReference(obj: {
-        id: string;
-    }): NodeReferenceValue;
-}