@sixb/core 0.0.1

package/dist/objects/materializer-adapter.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Runtime translation onto the ontology Materializer.
+ *
+ * Every typed and dynamic object/link mutation lowers to canonical Materializer operations here and
+ * every Materializer result is mapped back to the public runtime shapes. The adapter owns no
+ * ontology semantics: authority classification, effective resolution, validation, and event
+ * construction all happen inside the Materializer's single commit.
+ */
+import type { JsonValue } from "../json";
+import type { EditCommitResult, EffectiveObjectSnapshot, MaterializationItemError, OntologyEditOperation, OntologyLinkRef, OntologyObjectRef, OntologyOperationOutcome } from "../materialization/model";
+import type { ObjectLink, ValueType } from "../ontology";
+import type { ObjectTypeWithPropertyTokens } from "../ontology/tokens";
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { ObjectRow } from "../storage";
+/** The runtime pieces one commit needs. */
+export type RuntimeMaterializerContext = Pick<SixbRuntimeContext, "projectId" | "storage" | "authorization">;
+/** One caller-supplied batch item, lowered to the operations it contributes. */
+export interface RuntimeBatchGroup {
+    /** Position in the caller's input array; item errors are reported against it. */
+    readonly index: number;
+    readonly operations: readonly OntologyEditOperation[];
+}
+export interface RuntimeBatchCommit {
+    readonly commit: EditCommitResult | null;
+    /** Outcomes per input position, in the order the item's operations were submitted. */
+    readonly outcomes: ReadonlyMap<number, readonly OntologyOperationOutcome[]>;
+}
+/**
+ * Commits ordered operations as one atomic runtime commit.
+ *
+ * A fresh request id per call keeps each runtime mutation its own commit; the Materializer's
+ * idempotency replay then only collapses a retry of the very same request.
+ */
+export declare function commitRuntimeOperations(ctx: RuntimeMaterializerContext, operations: readonly OntologyEditOperation[]): Promise<EditCommitResult>;
+/**
+ * Commits grouped batch operations as one ordered continue-mode transaction.
+ *
+ * Successful items apply against one evolving authority state while semantic failures are recorded
+ * per item. Provider, serialization, and CAS failures still roll the whole transaction back.
+ *
+ * An item that lowers to several operations is declared as one operation group so the Materializer
+ * rolls the whole item back rather than committing the operations that ran before the failure.
+ */
+export declare function commitRuntimeBatch(ctx: RuntimeMaterializerContext, groups: readonly RuntimeBatchGroup[]): Promise<RuntimeBatchCommit>;
+/**
+ * Assigns the canonical operation id for one batch item.
+ *
+ * Ids derive from the caller's original ordinal so outcomes map back to input positions even when
+ * earlier items failed local validation and never reached the Materializer.
+ */
+export declare function runtimeOperationId(index: number, subOrdinal?: number): string;
+export interface NormalizedRuntimeObject {
+    readonly primaryId: string;
+    /** Managed authority values; identity lives in the object ref, never in the properties. */
+    readonly properties: Readonly<Record<string, JsonValue>>;
+}
+/**
+ * Validates and normalizes one runtime object input at the SDK/service boundary.
+ *
+ * Shape and value-type errors surface here so a batch can report them against the caller's original
+ * position. Authority classification, required-property enforcement, and cardinality stay in the
+ * Materializer, which validates the resolved effective object instead of the request.
+ */
+export declare function normalizeRuntimeObject(input: {
+    readonly objectType: ObjectTypeWithPropertyTokens;
+    readonly primaryPropertyId: string;
+    readonly properties: Record<string, unknown>;
+    readonly valueTypesById: ReadonlyMap<string, ValueType>;
+}): NormalizedRuntimeObject;
+/**
+ * Validates and normalizes one runtime link input.
+ *
+ * Managed link authority carries the complete property set, so required link properties must be
+ * present in the request rather than inherited from the stored edge.
+ */
+export declare function normalizeRuntimeLink(input: {
+    readonly objectType: ObjectTypeWithPropertyTokens;
+    readonly linkDefinition: ObjectLink;
+    readonly linkId: string;
+    readonly targetTypeId: string;
+    readonly properties?: Record<string, unknown>;
+    readonly valueTypesById: ReadonlyMap<string, ValueType>;
+    readonly isValidLinkTarget: (expected: string | string[], actual: string) => boolean;
+}): Readonly<Record<string, JsonValue>> | undefined;
+export declare function objectUpsertOperation(input: {
+    readonly id: string;
+    readonly ref: OntologyObjectRef;
+    readonly properties: Readonly<Record<string, JsonValue>>;
+}): OntologyEditOperation;
+export declare function objectDeleteOperation(input: {
+    readonly id: string;
+    readonly ref: OntologyObjectRef;
+}): OntologyEditOperation;
+export declare function objectRestoreOperation(input: {
+    readonly id: string;
+    readonly ref: OntologyObjectRef;
+}): OntologyEditOperation;
+export declare function linkUpsertOperation(input: {
+    readonly id: string;
+    readonly ref: OntologyLinkRef;
+    readonly properties?: Readonly<Record<string, JsonValue>>;
+}): OntologyEditOperation;
+export declare function linkDeleteOperation(input: {
+    readonly id: string;
+    readonly ref: OntologyLinkRef;
+}): OntologyEditOperation;
+/** Reads the outcomes one batch item produced; the commit returns one per submitted operation. */
+export declare function requireItemOutcomes(commit: RuntimeBatchCommit, index: number): readonly OntologyOperationOutcome[];
+/** Reads the effective object an ok outcome produced; runtime object writes always resolve one. */
+export declare function requireEffectiveObject(outcome: OntologyOperationOutcome): EffectiveObjectSnapshot;
+export declare function toObjectRow(projectId: string, snapshot: EffectiveObjectSnapshot): ObjectRow;
+/** Rehydrates a persisted item error into the public runtime error type. */
+export declare function toItemError(error: MaterializationItemError): Error;
+//# sourceMappingURL=materializer-adapter.d.ts.map

package/dist/objects/materializer-adapter.d.ts.map

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

package/dist/objects/object/delete.d.ts

@@ -0,0 +1,17 @@
+import type { ResolvedObjectContext } from "../context";
+/**
+ * Delete the object with this primary id.
+ *
+ * A missing object is a no-op: the delete records managed authority only where effective state
+ * exists, so the commit reports `unchanged` rather than failing. An object a projection also writes
+ * stays hidden even while the projection keeps asserting it — `restore()` is what reveals it again.
+ */
+export declare function deleteObject(ctx: ResolvedObjectContext, primaryId: string): Promise<void>;
+/**
+ * Withdraw a previous delete.
+ *
+ * For an object written only from code this is a no-op — there is nothing left to reveal, so write it
+ * again instead. For an object a projection also writes, it makes the projected state visible again.
+ */
+export declare function restoreObject(ctx: ResolvedObjectContext, primaryId: string): Promise<void>;
+//# sourceMappingURL=delete.d.ts.map

package/dist/objects/object/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/objects/object/delete.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAQvD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/F;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhG"}

package/dist/objects/object/index.d.ts

@@ -0,0 +1,4 @@
+export { deleteObject, restoreObject } from "./delete";
+export { upsertObject } from "./upsert";
+export { upsertObjectBatch } from "./upsert-batch";
+//# sourceMappingURL=index.d.ts.map

package/dist/objects/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/objects/object/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/objects/object/upsert-batch.d.ts

@@ -0,0 +1,7 @@
+import type { BatchItemResult } from "../../runtime/types";
+import type { ObjectRow } from "../../storage";
+import type { ResolvedObjectContext } from "../context";
+export declare function upsertObjectBatch(ctx: ResolvedObjectContext, items: readonly {
+    properties: Record<string, unknown>;
+}[]): Promise<readonly BatchItemResult<ObjectRow>[]>;
+//# sourceMappingURL=upsert-batch.d.ts.map

package/dist/objects/object/upsert-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-batch.d.ts","sourceRoot":"","sources":["../../../src/objects/object/upsert-batch.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAUvD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,qBAAqB,EAC1B,KAAK,EAAE,SAAS;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAAE,GACxD,OAAO,CAAC,SAAS,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC,CAiChD"}

package/dist/objects/object/upsert.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Leaf operation: upsert a single object through the ontology Materializer.
+ */
+import type { ObjectRow } from "../../storage";
+import type { ResolvedObjectContext } from "../context";
+export declare function upsertObject(ctx: ResolvedObjectContext, properties: Record<string, unknown>): Promise<ObjectRow>;
+//# sourceMappingURL=upsert.d.ts.map

package/dist/objects/object/upsert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../../src/objects/object/upsert.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAUvD,wBAAsB,YAAY,CAChC,GAAG,EAAE,qBAAqB,EAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,SAAS,CAAC,CAkBpB"}

package/dist/objects/query/errors.d.ts

@@ -0,0 +1,23 @@
+import type { ObjectQueryValidationIssue } from "./validate";
+export interface ObjectQueryPlanningIssue {
+    path: string;
+    code: string;
+    message: string;
+}
+export declare class ObjectQueryValidationError extends Error {
+    readonly name = "ObjectQueryValidationError";
+    readonly issues: readonly ObjectQueryValidationIssue[];
+    constructor(issues: readonly ObjectQueryValidationIssue[]);
+}
+export declare class ObjectQueryPlanningError extends Error {
+    readonly name = "ObjectQueryPlanningError";
+    readonly issues: readonly ObjectQueryPlanningIssue[];
+    constructor(issues: readonly ObjectQueryPlanningIssue[]);
+}
+export declare class ObjectQueryExecutionError extends Error {
+    readonly name = "ObjectQueryExecutionError";
+    readonly code: string;
+    readonly path?: string;
+    constructor(code: string, message: string, path?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/objects/query/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/objects/query/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAA;AAE5D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,gCAA+B;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAA;gBAE1C,MAAM,EAAE,SAAS,0BAA0B,EAAE;CAI1D;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,8BAA6B;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAA;gBAExC,MAAM,EAAE,SAAS,wBAAwB,EAAE;CAIxD;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,+BAA8B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAKzD"}

package/dist/objects/query/executor.d.ts

@@ -0,0 +1,63 @@
+import { type AuthorizationContext } from "../../authorization";
+import type { OntologyRegistry } from "../../ontology";
+import type { CountObjectsResult, ExistsObjectsResult, FacetObjectsResult, ObjectFacetRequest, ObjectStorage, QueryObjectsResult } from "../../storage";
+import type { ObjectQuery } from "./ir";
+import { type ObjectQueryPlan, type ObjectQueryPlanningOptions } from "./planner";
+export interface QueryExecutorOptions extends Omit<ObjectQueryPlanningOptions, "capabilities" | "operation" | "hasQueryObjects" | "hasCountObjects" | "hasExistsObjects" | "hasFacetObjects"> {
+    ontology: OntologyRegistry;
+    storage: ObjectStorage;
+    maxLimit?: number;
+    maxPageSize?: number;
+    maxFacetLimit?: number;
+    /**
+     * Per-parent cap on how many links a single `expand` hydrates, applied as a
+     * top-N trim after `orderBy` (mirrors `maxLimit` for the result set). An
+     * expansion's own `limit` narrows this further; the cap is the backstop.
+     */
+    maxExpansionFanout?: number;
+    /** When present, every object type the query touches must be viewable. */
+    authorization?: AuthorizationContext;
+}
+export interface ExecuteObjectQueryInput {
+    projectId: string;
+    query: ObjectQuery;
+    includeTotal?: boolean;
+}
+export interface ExecuteObjectQueryResult extends QueryObjectsResult {
+    plan: ObjectQueryPlan;
+}
+export interface ExecuteObjectCountInput {
+    projectId: string;
+    query: ObjectQuery;
+}
+export interface ExecuteObjectCountResult extends CountObjectsResult {
+    plan: ObjectQueryPlan;
+}
+export interface ExecuteObjectExistsInput {
+    projectId: string;
+    query: ObjectQuery;
+}
+export interface ExecuteObjectExistsResult extends ExistsObjectsResult {
+    plan: ObjectQueryPlan;
+}
+export interface ExecuteObjectFacetsInput {
+    projectId: string;
+    query: ObjectQuery;
+    facets: readonly ObjectFacetRequest[];
+}
+export interface ExecuteObjectFacetsResult extends FacetObjectsResult {
+    plan: ObjectQueryPlan;
+}
+export declare class QueryExecutor {
+    private readonly options;
+    constructor(options: QueryExecutorOptions);
+    execute(input: ExecuteObjectQueryInput): Promise<ExecuteObjectQueryResult>;
+    count(input: ExecuteObjectCountInput): Promise<ExecuteObjectCountResult>;
+    exists(input: ExecuteObjectExistsInput): Promise<ExecuteObjectExistsResult>;
+    facets(input: ExecuteObjectFacetsInput): Promise<ExecuteObjectFacetsResult>;
+}
+export declare function executeObjectQuery(input: ExecuteObjectQueryInput, options: QueryExecutorOptions): Promise<ExecuteObjectQueryResult>;
+export declare function countObjects(input: ExecuteObjectCountInput, options: QueryExecutorOptions): Promise<ExecuteObjectCountResult>;
+export declare function existsObjects(input: ExecuteObjectExistsInput, options: QueryExecutorOptions): Promise<ExecuteObjectExistsResult>;
+export declare function facetObjects(input: ExecuteObjectFacetsInput, options: QueryExecutorOptions): Promise<ExecuteObjectFacetsResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/objects/query/executor.d.ts.map

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

package/dist/objects/query/explain-format.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Formatting for object query explanations.
+ *
+ * Lives apart from `explain.ts` so the fluent builder (and browser bundles
+ * built on it) can import the formatter without pulling in the explanation
+ * builder and its validation machinery.
+ */
+import type { ObjectQueryExplanation } from "./explain";
+export declare function formatObjectQueryExplanation(explanation: ObjectQueryExplanation): string;
+//# sourceMappingURL=explain-format.d.ts.map

package/dist/objects/query/explain-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-format.d.ts","sourceRoot":"","sources":["../../../src/objects/query/explain-format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAA0B,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAE/E,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,sBAAsB,GAAG,MAAM,CAiBxF"}

package/dist/objects/query/explain.d.ts

@@ -0,0 +1,26 @@
+import type { OntologyRegistry } from "../../ontology";
+import type { ObjectQuery, ObjectQueryResultShape } from "./ir";
+import { type ObjectQueryValidationIssue } from "./validate";
+export interface ObjectQueryExplainOptions {
+    ontology?: OntologyRegistry;
+    normalize?: boolean;
+    maxLimit?: number;
+    maxPageSize?: number;
+}
+export interface ObjectQueryExplanation {
+    query: ObjectQuery;
+    normalizedQuery: ObjectQuery;
+    valid?: boolean;
+    result?: ObjectQueryResultShape;
+    issues: readonly ObjectQueryValidationIssue[];
+    tree: ObjectQueryExplainNode;
+}
+export interface ObjectQueryExplainNode {
+    path: string;
+    kind: ObjectQuery["kind"];
+    summary: string;
+    details: Record<string, unknown>;
+    children: readonly ObjectQueryExplainNode[];
+}
+export declare function explainObjectQuery(query: ObjectQuery, options?: ObjectQueryExplainOptions): ObjectQueryExplanation;
+//# sourceMappingURL=explain.d.ts.map

package/dist/objects/query/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/objects/query/explain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAEV,WAAW,EAEX,sBAAsB,EAEvB,MAAM,MAAM,CAAA;AAEb,OAAO,EAEL,KAAK,0BAA0B,EAEhC,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,WAAW,CAAA;IAClB,eAAe,EAAE,WAAW,CAAA;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,sBAAsB,CAAA;IAC/B,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAA;IAC7C,IAAI,EAAE,sBAAsB,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAC5C;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,yBAA8B,GACtC,sBAAsB,CA6BxB"}

package/dist/objects/query/index.d.ts

@@ -0,0 +1,14 @@
+export type { ObjectQueryPlanningIssue } from "./errors";
+export { ObjectQueryExecutionError, ObjectQueryPlanningError, ObjectQueryValidationError, } from "./errors";
+export type { ExecuteObjectCountInput, ExecuteObjectCountResult, ExecuteObjectExistsInput, ExecuteObjectExistsResult, ExecuteObjectFacetsInput, ExecuteObjectFacetsResult, ExecuteObjectQueryInput, ExecuteObjectQueryResult, QueryExecutorOptions, } from "./executor";
+export { countObjects, executeObjectQuery, existsObjects, facetObjects, QueryExecutor, } from "./executor";
+export type { ObjectQueryExplainNode, ObjectQueryExplainOptions, ObjectQueryExplanation, } from "./explain";
+export { explainObjectQuery } from "./explain";
+export { formatObjectQueryExplanation } from "./explain-format";
+export type { ObjectExpansion, ObjectQuery, ObjectQueryDirection, ObjectQueryExpand, ObjectQueryFilter, ObjectQueryLimit, ObjectQueryPage, ObjectQueryPredicate, ObjectQueryPredicateComparison, ObjectQueryPredicateContains, ObjectQueryPredicateExists, ObjectQueryPredicateGroup, ObjectQueryPredicateIn, ObjectQueryPredicateNot, ObjectQueryProject, ObjectQueryResultShape, ObjectQuerySet, ObjectQuerySetOperation, ObjectQuerySort, ObjectQuerySortDirection, ObjectQuerySortField, ObjectQueryStart, ObjectQueryText, ObjectQueryTraverse, ObjectQueryVector, QueryScalarKind, } from "./ir";
+export { normalizeObjectQuery, normalizeObjectQueryPredicate } from "./normalize";
+export type { ObjectQueryPlan, ObjectQueryPlanMode, ObjectQueryPlanningOptions, ObjectQueryProviderOperation, } from "./planner";
+export { planObjectQuery, QueryPlanner } from "./planner";
+export type { ObjectQueryValidationIssue, ObjectQueryValidationOptions, ValidatedObjectQuery, } from "./validate";
+export { collectObjectQueryValidationIssues, resolveObjectQueryResultShape, validateObjectQuery, } from "./validate";
+//# sourceMappingURL=index.d.ts.map

package/dist/objects/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/objects/query/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA;AACxD,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,sBAAsB,EACtB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC/D,YAAY,EACV,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,MAAM,CAAA;AACb,OAAO,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAA;AACjF,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACzD,YAAY,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,kCAAkC,EAClC,6BAA6B,EAC7B,mBAAmB,GACpB,MAAM,YAAY,CAAA"}

package/dist/objects/query/index.js

@@ -0,0 +1,54 @@
+// @bun
+import {
+  QueryExecutor,
+  QueryPlanner,
+  collectObjectQueryValidationIssues,
+  countObjects,
+  executeObjectQuery,
+  existsObjects,
+  explainObjectQuery,
+  facetObjects,
+  planObjectQuery,
+  resolveObjectQueryResultShape,
+  validateObjectQuery
+} from "../../chunk-2gpr6jsz.js";
+import {
+  ObjectQueryExecutionError,
+  ObjectQueryPlanningError,
+  ObjectQueryValidationError,
+  formatObjectQueryExplanation,
+  normalizeObjectQuery,
+  normalizeObjectQueryPredicate
+} from "../../chunk-88ppkr54.js";
+import"../../chunk-6wetht33.js";
+import"../../chunk-mx84y05q.js";
+import"../../chunk-45tw90k7.js";
+import"../../chunk-tsk2bxs3.js";
+import"../../chunk-04b07a9q.js";
+import"../../chunk-dktq02ne.js";
+import"../../chunk-4pycxcj3.js";
+import"../../chunk-0fygrz37.js";
+import"../../chunk-btpe64e4.js";
+import"../../chunk-1vffvydj.js";
+import"../../chunk-y64skrwp.js";
+export {
+  validateObjectQuery,
+  resolveObjectQueryResultShape,
+  planObjectQuery,
+  normalizeObjectQueryPredicate,
+  normalizeObjectQuery,
+  formatObjectQueryExplanation,
+  facetObjects,
+  explainObjectQuery,
+  existsObjects,
+  executeObjectQuery,
+  countObjects,
+  collectObjectQueryValidationIssues,
+  QueryPlanner,
+  QueryExecutor,
+  ObjectQueryValidationError,
+  ObjectQueryPlanningError,
+  ObjectQueryExecutionError
+};
+
+//# debugId=AAB44FA6DBDAC12A64756E2164756E21

package/dist/objects/query/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "AAB44FA6DBDAC12A64756E2164756E21",
+  "names": []
+}

package/dist/objects/query/ir.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Provider-neutral object query IR.
+ *
+ * The IR describes the requested object-set operation without committing to a
+ * storage backend. Providers can push down the subset they support, while the
+ * core planner decides whether a bounded fallback is acceptable.
+ */
+export type ObjectQueryDirection = "outgoing" | "incoming";
+export type ObjectQuerySetOperation = "union" | "intersect" | "subtract";
+export type ObjectQuerySortDirection = "asc" | "desc";
+/** Scalar schema resolved by core validation for provider-neutral value semantics. */
+export type QueryScalarKind = "string" | "uuid" | "boolean" | "integer" | "double" | "decimal" | "date" | "timestamp";
+export type ObjectQuery = ObjectQueryStart | ObjectQueryFilter | ObjectQueryText | ObjectQueryVector | ObjectQueryTraverse | ObjectQuerySet | ObjectQuerySort | ObjectQueryLimit | ObjectQueryPage | ObjectQueryProject | ObjectQueryExpand;
+export interface ObjectQueryStart {
+    kind: "start";
+    objectTypeId: string;
+    includeSubtypes?: boolean;
+}
+export interface ObjectQueryFilter {
+    kind: "filter";
+    input: ObjectQuery;
+    predicate: ObjectQueryPredicate;
+}
+export interface ObjectQueryText {
+    kind: "text";
+    input: ObjectQuery;
+    query: string;
+    fields?: readonly string[];
+    /**
+     * Resolved search-profile defaults, keyed by object type id.
+     *
+     * Providers receive this from core validation when `fields` is omitted so
+     * multi-type text queries do not leak one type's defaults onto another.
+     */
+    fieldsByObjectType?: Readonly<Record<string, readonly string[]>>;
+}
+export interface ObjectQueryVector {
+    kind: "vector";
+    input: ObjectQuery;
+    vector: readonly number[];
+    propertyId: string;
+    k: number;
+}
+export interface ObjectQueryTraverse {
+    kind: "traverse";
+    input: ObjectQuery;
+    linkId: string;
+    direction: ObjectQueryDirection;
+    /**
+     * Constrains incoming traversal to one source object type. Without it,
+     * incoming traversal matches every object type that declares a link with
+     * this `linkId` targeting the input set. The fluent builder always sets it
+     * from the link token's owner type.
+     */
+    sourceObjectTypeId?: string;
+}
+export interface ObjectQuerySet {
+    kind: "set";
+    op: ObjectQuerySetOperation;
+    inputs: readonly ObjectQuery[];
+}
+export interface ObjectQuerySort {
+    kind: "sort";
+    input: ObjectQuery;
+    fields: readonly ObjectQuerySortField[];
+}
+export interface ObjectQueryLimit {
+    kind: "limit";
+    input: ObjectQuery;
+    limit: number;
+}
+export interface ObjectQueryPage {
+    kind: "page";
+    input: ObjectQuery;
+    pageSize: number;
+    pageToken?: string;
+}
+export interface ObjectQueryProject {
+    kind: "project";
+    input: ObjectQuery;
+    properties?: readonly string[];
+}
+/**
+ * Attaches linked objects to the result set without changing which objects
+ * match — the graph-read counterpart to `traverse` (which replaces the set).
+ *
+ * Like `project`, `expand` is output-shaping: it is normalized to the
+ * outermost layer, and `count`/`exists` ignore it. Each {@link ObjectExpansion}
+ * names a link to hydrate; nesting walks further hops.
+ */
+export interface ObjectQueryExpand {
+    kind: "expand";
+    input: ObjectQuery;
+    expansions: readonly ObjectExpansion[];
+}
+export interface ObjectExpansion {
+    linkId: string;
+    /** Defaults to "outgoing". Incoming reuses `sourceObjectTypeId` to disambiguate, like traverse. */
+    direction: ObjectQueryDirection;
+    /** Constrains an incoming expansion to one source object type (see traverse). */
+    sourceObjectTypeId?: string;
+    /** Bounds a "many" expansion to the top-N links per parent. */
+    limit?: number;
+    /** Deterministic ordering for a bounded "many" expansion, against the target type. */
+    orderBy?: readonly ObjectQuerySortField[];
+    /** Nested expansions, hydrated from the target objects of this expansion. */
+    expand?: readonly ObjectExpansion[];
+    /**
+     * Resolved link cardinality, driving the attached value shape: `"one"` yields a
+     * single object (or `null`), `"many"` yields an array.
+     *
+     * Core-resolved, never authored: the core executor fills this from the ontology
+     * before provider pushdown (like {@link ObjectQueryText.fieldsByObjectType}), so
+     * a storage provider can shape the result without an ontology. The bounded
+     * fallback re-derives cardinality per parent row and ignores this field. The
+     * planner only pushes an expansion down once it is set.
+     */
+    cardinality?: "one" | "many";
+}
+export type ObjectQueryPredicate = ObjectQueryPredicateGroup | ObjectQueryPredicateNot | ObjectQueryPredicateComparison | ObjectQueryPredicateIn | ObjectQueryPredicateExists | ObjectQueryPredicateContains;
+export interface ObjectQueryPredicateGroup {
+    op: "and" | "or";
+    items: readonly ObjectQueryPredicate[];
+}
+export interface ObjectQueryPredicateNot {
+    op: "not";
+    item: ObjectQueryPredicate;
+}
+export interface ObjectQueryPredicateComparison {
+    op: "eq" | "neq" | "lt" | "lte" | "gt" | "gte";
+    propertyId: string;
+    value: unknown;
+    /** Core-resolved scalar schema used by providers; never authored by callers. */
+    scalarKind?: QueryScalarKind;
+}
+export interface ObjectQueryPredicateIn {
+    op: "in";
+    propertyId: string;
+    values: readonly unknown[];
+    /** Core-resolved scalar schema used by providers; never authored by callers. */
+    scalarKind?: QueryScalarKind;
+}
+export interface ObjectQueryPredicateExists {
+    op: "exists";
+    propertyId: string;
+    value: boolean;
+}
+export interface ObjectQueryPredicateContains {
+    op: "contains";
+    propertyId: string;
+    value: unknown;
+}
+export type ObjectQuerySortField = {
+    kind: "property";
+    propertyId: string;
+    direction?: ObjectQuerySortDirection;
+    /** Core-resolved scalar schema used by providers; never authored by callers. */
+    scalarKind?: QueryScalarKind;
+} | {
+    kind: "relevance";
+    direction?: ObjectQuerySortDirection;
+};
+export interface ObjectQueryResultShape {
+    objectTypeIds: readonly string[];
+}
+//# sourceMappingURL=ir.d.ts.map

package/dist/objects/query/ir.d.ts.map

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

package/dist/objects/query/normalize.d.ts

@@ -0,0 +1,12 @@
+import type { ObjectQuery, ObjectQueryPredicate } from "./ir";
+/**
+ * Canonicalizes query trees before validation/planning so providers see a
+ * stable shape regardless of how the typed builder assembled the query.
+ *
+ * `expand` is output-shaping, so it is hoisted to the outermost layer here: two
+ * queries that differ only in where `.expand(...)` was chained normalize to the
+ * same tree (and therefore the same cache key).
+ */
+export declare function normalizeObjectQuery(query: ObjectQuery): ObjectQuery;
+export declare function normalizeObjectQueryPredicate(predicate: ObjectQueryPredicate): ObjectQueryPredicate;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/objects/query/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/objects/query/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EACX,oBAAoB,EAGrB,MAAM,MAAM,CAAA;AAEb;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEpE;AAyHD,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,oBAAoB,GAC9B,oBAAoB,CAkBtB"}

package/dist/objects/query/planner.d.ts

@@ -0,0 +1,32 @@
+import type { ObjectQueryCapabilities } from "../../storage";
+import type { ObjectQueryPlanningIssue } from "./errors";
+import type { ObjectQuery } from "./ir";
+export type ObjectQueryPlanMode = "pushdown" | "fallback" | "rejected";
+export type ObjectQueryProviderOperation = "queryObjects" | "countObjects" | "existsObjects" | "facetObjects";
+export interface ObjectQueryPlan {
+    mode: ObjectQueryPlanMode;
+    query: ObjectQuery;
+    providerIssues: readonly ObjectQueryPlanningIssue[];
+    fallbackIssues: readonly ObjectQueryPlanningIssue[];
+    issues: readonly ObjectQueryPlanningIssue[];
+    fallback?: {
+        maxRows: number;
+        requiresExplicitBound: boolean;
+    };
+}
+export interface ObjectQueryPlanningOptions {
+    capabilities: ObjectQueryCapabilities;
+    operation?: ObjectQueryProviderOperation;
+    hasQueryObjects?: boolean;
+    hasCountObjects?: boolean;
+    hasExistsObjects?: boolean;
+    hasFacetObjects?: boolean;
+    allowFallback?: boolean;
+    maxFallbackRows?: number;
+    requiresExplicitFallbackBound?: boolean;
+}
+export declare class QueryPlanner {
+    plan(query: ObjectQuery, options: ObjectQueryPlanningOptions): ObjectQueryPlan;
+}
+export declare function planObjectQuery(query: ObjectQuery, options: ObjectQueryPlanningOptions): ObjectQueryPlan;
+//# sourceMappingURL=planner.d.ts.map