@gaganref/confect-server 10.3.1-fork.26 → 10.3.1-fork.28

package/dist/QueryStream.js

@@ -11,17 +11,17 @@ import { admittedByLower, admittedByUpper, forLayout, fromParsed, intersect, int
 import { apply, equalityPrefixLength, fromBounds, toBounds as toBounds$1 } from "./QueryStreamIndexRange.js";
 import { EmptyInitialPageError, InvalidPageSizeError, Range, Start, finish, initial, parseRequest, record } from "./QueryStreamPagination.js";
 import { InvalidReadLimitError, Limits, QueryStreamReadBudget, make as make$1 } from "./QueryStreamReadBudget.js";
+import * as Data from "effect/Data";
 import * as Effect from "effect/Effect";
+import * as Predicate from "effect/Predicate";
+import * as Array from "effect/Array";
 import * as Schema from "effect/Schema";
 import { dual, identity, pipe } from "effect/Function";
 import * as Match from "effect/Match";
 import * as Option from "effect/Option";
 import { ConvexError } from "convex/values";
-import * as Array from "effect/Array";
 import * as Order from "effect/Order";
-import * as Predicate from "effect/Predicate";
 import * as Result from "effect/Result";
-import * as Data from "effect/Data";
 import * as Stream from "effect/Stream";
 import { pipeArguments } from "effect/Pipeable";
 import * as Chunk from "effect/Chunk";
@@ -32,6 +32,7 @@ import * as String from "effect/String";
 import * as Tuple from "effect/Tuple";
 //#region src/QueryStream.ts
 var QueryStream_exports = /* @__PURE__ */ __exportAll({
+	DeferredStreamMismatchError: () => DeferredStreamMismatchError,
 	Element: () => Element,
 	EmptyInitialPageError: () => EmptyInitialPageError,
 	IncompatibleStreamsError: () => IncompatibleStreamsError,
@@ -44,6 +45,7 @@ var QueryStream_exports = /* @__PURE__ */ __exportAll({
 	QueryStream: () => QueryStream,
 	ReadBudgetExceededError: () => ReadBudgetExceededError,
 	TypeId: () => TypeId,
+	defer: () => defer,
 	distinct: () => distinct,
 	empty: () => empty,
 	filter: () => filter,
@@ -234,6 +236,40 @@ const empty = () => (keyLayout, orderDirection = "asc") => {
 	return make(orderDirection);
 };
 /**
+* A deferred stream's resolved direction or layout differs from its
+* declaration. The check runs on consumption, before the resolved source is
+* pulled.
+*
+* @experimental
+*/
+var DeferredStreamMismatchError = class extends Data.TaggedError("DeferredStreamMismatchError") {};
+/**
+* Defer an effect that checks access or constructs a query stream until it is
+* pulled. Supply its layout and direction without reading documents. This lets
+* `flatMap` build and narrow an inner stream before running its checks.
+*
+* The effect runs afresh on each consumption, seek, or reversal. Failures and
+* service requirements are preserved. Its stream must match the declared layout
+* and direction, or consumption dies with `DeferredStreamMismatchError`.
+*
+* @experimental
+*/
+const defer = (options, make) => {
+	const checked = Effect.map(make, (stream) => {
+		if (stream.orderDirection !== options.orderDirection || !Equivalence(stream.keyLayout, options.keyLayout)) throw new DeferredStreamMismatchError({
+			expectedOrderDirection: options.orderDirection,
+			actualOrderDirection: stream.orderDirection,
+			expectedKeyLayout: options.keyLayout,
+			actualKeyLayout: stream.keyLayout
+		});
+		return stream;
+	});
+	return new QueryStream(options.orderDirection, options.keyLayout, Stream.unwrap(Effect.map(checked, (stream) => stream.annotated)), void 0, (bounds) => defer(options, Effect.map(checked, (stream) => narrowByParsedBounds(stream, bounds))), () => defer({
+		...options,
+		orderDirection: flip(options.orderDirection)
+	}, Effect.map(checked, reverse)));
+};
+/**
 * Create a reusable query stream from an index-query description. Prefer
 * `reader.table(...).stream(...)` for inferred document and ordering types.
 *
@@ -938,6 +974,6 @@ const paginate = dual(2, Effect.fn("QueryStream.paginate")(function* (self, opti
 	}));
 }, (effect, _self, options) => Effect.provideServiceEffect(effect, QueryStreamReadBudget, Schema.decodeEffect(Limits)(options).pipe(Effect.catchTag("SchemaError", (cause) => Effect.die(new InvalidReadLimitError({ cause }))), Effect.flatMap(make$1)))));
 //#endregion
-export { Element, EmptyInitialPageError, IncompatibleStreamsError, InnerStreamLayoutMismatchError, InnerStreamOrderMismatchError, InvalidPageSizeError, InvalidReadLimitError, MissingReversalRecipeError, NotUniqueError, QueryStream, QueryStream_exports, ReadBudgetExceededError, TypeId, distinct, empty, filter, filterEffect, flatMap, fromReflection, isQueryStream, map, mapEffect, merge, narrow, paginate, renameKey, reverse, unique };
+export { DeferredStreamMismatchError, Element, EmptyInitialPageError, IncompatibleStreamsError, InnerStreamLayoutMismatchError, InnerStreamOrderMismatchError, InvalidPageSizeError, InvalidReadLimitError, MissingReversalRecipeError, NotUniqueError, QueryStream, QueryStream_exports, ReadBudgetExceededError, TypeId, defer, distinct, empty, filter, filterEffect, flatMap, fromReflection, isQueryStream, map, mapEffect, merge, narrow, paginate, renameKey, reverse, unique };
 
 //# sourceMappingURL=QueryStream.js.map