@gaganref/confect-server 0.0.0-stage → 10.3.1-fork.2

package/dist/MutationRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationRunner.d.ts","sourceRoot":"","sources":["../src/MutationRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,mBAAmB,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,0BAA0B,MAAM,8BAA8B,CAAC;AAE3E,MAAM,MAAM,OAAO,GAAG,0BAA0B,CAAC,eAAe,CAAC;AAmDjE,eAAO,MAAM,cAAc;;SA5CJ,QAAQ,SAAS,GAAG,CAAC,WAAW,YACzC,QAAQ,WACT,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,GAC5D,MAAM,CAAC,MAAM,CACd,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EACrB,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,CACzC;SACoB,QAAQ,SAAS,GAAG,CAAC,WAAW,YACzC,QAAQ,QACZ,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,WACf,OAAO,GAAG,SAAS,GAC3B,MAAM,CAAC,MAAM,CACd,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EACrB,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,EACxC,0BAA0B,CAAC,0BAA0B,CACtD;;;;;;;EA+BF,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,UAAU,CAAC;AAE9D,eAAO,MAAM,KAAK,gBAAiB,gBAAgB,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;;SAjDhD,QAAQ,SAAS,GAAG,CAAC,WAAW,YACzC,QAAQ,WACT,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,GAC5D,MAAM,CAAC,MAAM,CACd,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EACrB,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,CACzC;SACoB,QAAQ,SAAS,GAAG,CAAC,WAAW,YACzC,QAAQ,QACZ,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,WACf,OAAO,GAAG,SAAS,GAC3B,MAAM,CAAC,MAAM,CACd,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EACrB,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,WAAW,EACxC,0BAA0B,CAAC,0BAA0B,CACtD;;gBAmC+C,CAAC"}

package/dist/MutationRunner.js

@@ -0,0 +1,28 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { MutationTransactionContext } from "./MutationTransactionContext.js";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as Ref from "@confect/core/Ref";
+import * as Effect from "effect/Effect";
+//#region src/MutationRunner.ts
+var MutationRunner_exports = /* @__PURE__ */ __exportAll({
+	MutationRunner: () => MutationRunner,
+	layer: () => layer
+});
+const run = Effect.fn("MutationRunner.runMutation")((effect) => effect);
+const make = (nativeRunMutation) => {
+	function runMutation(mutation, args, options) {
+		return run(Effect.gen(function* () {
+			const actualArgs = args ?? {};
+			if (options !== void 0) return yield* (yield* MutationTransactionContext).runMutation(mutation, actualArgs, options);
+			return yield* Ref.runWithCodec(mutation, actualArgs, (ref, encodedArgs) => nativeRunMutation(ref, encodedArgs));
+		}));
+	}
+	return { runMutation };
+};
+const MutationRunner = Context.Service("@confect/server/MutationRunner");
+const layer = (runMutation) => Layer.succeed(MutationRunner, make(runMutation));
+//#endregion
+export { MutationRunner, MutationRunner_exports, layer };
+
+//# sourceMappingURL=MutationRunner.js.map

package/dist/MutationRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationRunner.js","names":["MutationTransactionContext.MutationTransactionContext"],"sources":["../src/MutationRunner.ts"],"sourcesContent":["import * as Ref from \"@confect/core/Ref\";\nimport type { GenericActionCtx } from \"convex/server\";\nimport * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport type * as Schema from \"effect/Schema\";\nimport * as MutationTransactionContext from \"./MutationTransactionContext\";\n\nexport type Options = MutationTransactionContext.MutationOptions;\n\nconst run = Effect.fn(\"MutationRunner.runMutation\")(\n  <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> => effect,\n);\n\nconst make = (nativeRunMutation: GenericActionCtx<any>[\"runMutation\"]) => {\n  function runMutation<Mutation extends Ref.AnyMutation>(\n    mutation: Mutation,\n    ...args: [...Ref.OptionalArgs<Mutation>, options?: undefined]\n  ): Effect.Effect<\n    Ref.Returns<Mutation>,\n    Ref.Error<Mutation> | Schema.SchemaError\n  >;\n  function runMutation<Mutation extends Ref.AnyMutation>(\n    mutation: Mutation,\n    args: Ref.Args<Mutation>,\n    options: Options | undefined,\n  ): Effect.Effect<\n    Ref.Returns<Mutation>,\n    Ref.Error<Mutation> | Schema.SchemaError,\n    MutationTransactionContext.MutationTransactionContext\n  >;\n  function runMutation<Mutation extends Ref.AnyMutation>(\n    mutation: Mutation,\n    args?: Ref.Args<Mutation>,\n    options?: Options,\n  ): Effect.Effect<\n    Ref.Returns<Mutation>,\n    Ref.Error<Mutation> | Schema.SchemaError,\n    MutationTransactionContext.MutationTransactionContext\n  > {\n    return run(\n      Effect.gen(function* () {\n        const actualArgs = (args ?? {}) as Ref.Args<Mutation>;\n        if (options !== undefined) {\n          const controls =\n            yield* MutationTransactionContext.MutationTransactionContext;\n          return yield* controls.runMutation(mutation, actualArgs, options);\n        }\n        return yield* Ref.runWithCodec(\n          mutation,\n          actualArgs,\n          (ref, encodedArgs) => nativeRunMutation(ref, encodedArgs),\n        );\n      }),\n    );\n  }\n  return { runMutation };\n};\n\nexport const MutationRunner = Context.Service<ReturnType<typeof make>>(\n  \"@confect/server/MutationRunner\",\n);\nexport type MutationRunner = typeof MutationRunner.Identifier;\n\nexport const layer = (runMutation: GenericActionCtx<any>[\"runMutation\"]) =>\n  Layer.succeed(MutationRunner, make(runMutation));\n"],"mappings":";;;;;;;;;;;AAUA,MAAM,MAAM,OAAO,GAAG,4BAA4B,CAAC,EACvC,WAA2D,MACvE;AAEA,MAAM,QAAQ,sBAA4D;CAiBxE,SAAS,YACP,UACA,MACA,SAKA;EACA,OAAO,IACL,OAAO,IAAI,aAAa;GACtB,MAAM,aAAc,QAAQ,CAAC;GAC7B,IAAI,YAAY,KAAA,GAGd,OAAO,QAAO,OADLA,2BAAAA,CACc,YAAY,UAAU,YAAY,OAAO;GAElE,OAAO,OAAO,IAAI,aAChB,UACA,aACC,KAAK,gBAAgB,kBAAkB,KAAK,WAAW,CAC1D;EACF,CAAC,CACH;CACF;CACA,OAAO,EAAE,YAAY;AACvB;AAEA,MAAa,iBAAiB,QAAQ,QACpC,gCACF;AAGA,MAAa,SAAS,gBACpB,MAAM,QAAQ,gBAAgB,KAAK,WAAW,CAAC"}

package/dist/MutationTransactionContext.d.ts

@@ -0,0 +1,17 @@
+import * as Ref from "@confect/core/Ref";
+import type { AdvancedRunQueryOptions, GenericDataModel, GenericMutationCtx } from "convex/server";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type { Options as MutationOptions } from "./QueryTransactionContext";
+export type { TransactionLimits } from "convex/server";
+export type { Options as MutationOptions } from "./QueryTransactionContext";
+export type QueryOptions = AdvancedRunQueryOptions;
+declare const MutationTransactionContext_base: Context.ServiceClass<MutationTransactionContext, "@confect/server/MutationTransactionContext", {
+    runQuery: <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: AdvancedRunQueryOptions) => Effect.Effect<Ref.Returns<Query>, import("effect/Schema").SchemaError | Ref.Error<Query>, never>;
+    runMutation: <Mutation extends Ref.AnyMutation>(mutation: Mutation, args: Ref.Args<Mutation>, options: MutationOptions) => Effect.Effect<Ref.Returns<Mutation>, import("effect/Schema").SchemaError | Ref.Error<Mutation>, never>;
+}>;
+export declare class MutationTransactionContext extends MutationTransactionContext_base {
+}
+export declare const layer: (ctx: Pick<GenericMutationCtx<GenericDataModel>, "runQuery" | "runMutation">) => Layer.Layer<MutationTransactionContext, never, never>;
+//# sourceMappingURL=MutationTransactionContext.d.ts.map

package/dist/MutationTransactionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationTransactionContext.d.ts","sourceRoot":"","sources":["../src/MutationTransactionContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,mBAAmB,CAAC;AACzC,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAC;;eAM9C,KAAK,SAAS,GAAG,CAAC,QAAQ;kBAU1B,QAAQ,SAAS,GAAG,CAAC,WAAW;;AAWrC,qBAAa,0BAA2B,SAAQ,+BAGC;CAAG;AAEpD,eAAO,MAAM,KAAK,QACX,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,0DACpB,CAAC"}

package/dist/MutationTransactionContext.js

@@ -0,0 +1,20 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as Ref from "@confect/core/Ref";
+import * as Effect from "effect/Effect";
+//#region src/MutationTransactionContext.ts
+var MutationTransactionContext_exports = /* @__PURE__ */ __exportAll({
+	MutationTransactionContext: () => MutationTransactionContext,
+	layer: () => layer
+});
+const make = (ctx) => ({
+	runQuery: Effect.fn("MutationTransactionContext.runQuery")((query, args, options) => Ref.runWithCodec(query, args, (ref, encodedArgs) => ctx.runQuery(ref, encodedArgs, options))),
+	runMutation: Effect.fn("MutationTransactionContext.runMutation")((mutation, args, options) => Ref.runWithCodec(mutation, args, (ref, encodedArgs) => ctx.runMutation(ref, encodedArgs, options)))
+});
+var MutationTransactionContext = class extends Context.Service()("@confect/server/MutationTransactionContext") {};
+const layer = (ctx) => Layer.succeed(MutationTransactionContext, make(ctx));
+//#endregion
+export { MutationTransactionContext, MutationTransactionContext_exports, layer };
+
+//# sourceMappingURL=MutationTransactionContext.js.map

package/dist/MutationTransactionContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutationTransactionContext.js","names":[],"sources":["../src/MutationTransactionContext.ts"],"sourcesContent":["import * as Ref from \"@confect/core/Ref\";\nimport type {\n  AdvancedRunQueryOptions,\n  GenericDataModel,\n  GenericMutationCtx,\n} from \"convex/server\";\nimport * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport type { Options as MutationOptions } from \"./QueryTransactionContext\";\n\nexport type { TransactionLimits } from \"convex/server\";\nexport type { Options as MutationOptions } from \"./QueryTransactionContext\";\nexport type QueryOptions = AdvancedRunQueryOptions;\n\nconst make = (\n  ctx: Pick<GenericMutationCtx<GenericDataModel>, \"runQuery\" | \"runMutation\">,\n) => ({\n  runQuery: Effect.fn(\"MutationTransactionContext.runQuery\")(\n    <Query extends Ref.AnyQuery>(\n      query: Query,\n      args: Ref.Args<Query>,\n      options: QueryOptions,\n    ) =>\n      Ref.runWithCodec(query, args, (ref, encodedArgs) =>\n        ctx.runQuery(ref, encodedArgs, options),\n      ),\n  ),\n  runMutation: Effect.fn(\"MutationTransactionContext.runMutation\")(\n    <Mutation extends Ref.AnyMutation>(\n      mutation: Mutation,\n      args: Ref.Args<Mutation>,\n      options: MutationOptions,\n    ) =>\n      Ref.runWithCodec(mutation, args, (ref, encodedArgs) =>\n        ctx.runMutation(ref, encodedArgs, options),\n      ),\n  ),\n});\n\nexport class MutationTransactionContext extends Context.Service<\n  MutationTransactionContext,\n  ReturnType<typeof make>\n>()(\"@confect/server/MutationTransactionContext\") {}\n\nexport const layer = (\n  ctx: Pick<GenericMutationCtx<GenericDataModel>, \"runQuery\" | \"runMutation\">,\n) => Layer.succeed(MutationTransactionContext, make(ctx));\n"],"mappings":";;;;;;;;;;AAeA,MAAM,QACJ,SACI;CACJ,UAAU,OAAO,GAAG,qCAAqC,CAAC,EAEtD,OACA,MACA,YAEA,IAAI,aAAa,OAAO,OAAO,KAAK,gBAClC,IAAI,SAAS,KAAK,aAAa,OAAO,CACxC,CACJ;CACA,aAAa,OAAO,GAAG,wCAAwC,CAAC,EAE5D,UACA,MACA,YAEA,IAAI,aAAa,UAAU,OAAO,KAAK,gBACrC,IAAI,YAAY,KAAK,aAAa,OAAO,CAC3C,CACJ;AACF;AAEA,IAAa,6BAAb,cAAgD,QAAQ,QAGtD,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC;AAEnD,MAAa,SACX,QACG,MAAM,QAAQ,4BAA4B,KAAK,GAAG,CAAC"}

package/dist/OrderedQuery.d.ts

@@ -0,0 +1,32 @@
+import type * as IdScope from "@confect/core/IdScope";
+import type { ExpressionOrValue, FilterBuilder, OrderedQuery as ConvexOrderedQuery, PaginationOptions, PaginationResult } from "convex/server";
+import type { Option } from "effect";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import type * as DatabaseSchema from "./DatabaseSchema";
+import * as Document from "./Document";
+import type * as TableInfo from "./TableInfo";
+import type * as Table from "./Table";
+type NativePaginate<TableInfo_ extends TableInfo.AnyWithProps, Doc> = (options: PaginationOptions, filter?: (q: FilterBuilder<TableInfo.ConvexTableInfo<TableInfo_>>) => ExpressionOrValue<boolean>) => Effect.Effect<PaginationResult<Doc>, Document.DocumentDecodeError>;
+export type OrderedQuery<TableInfo_ extends TableInfo.AnyWithProps, Doc = TableInfo_["document"], TargetKind extends DatabaseSchema.Target["kind"] = "app"> = {
+    readonly first: () => Effect.Effect<Option.Option<Doc>, Document.DocumentDecodeError>;
+    readonly take: (n: number) => Effect.Effect<ReadonlyArray<Doc>, Document.DocumentDecodeError>;
+    readonly collect: () => Effect.Effect<ReadonlyArray<Doc>, Document.DocumentDecodeError>;
+    readonly stream: () => Stream.Stream<Doc, Document.DocumentDecodeError>;
+    /**
+     * Native pagination is application-only. Use `QueryStream.paginate` for
+     * component index queries.
+     */
+    readonly paginate: {
+        readonly app: NativePaginate<TableInfo_, Doc>;
+        readonly component: {
+            readonly "Native pagination is unavailable in components. Use QueryStream.paginate for index queries.": never;
+        };
+    }[TargetKind];
+};
+export declare function make<Table_ extends Table.AnyWithProps>(query: ConvexOrderedQuery<TableInfo.ConvexTableInfo<TableInfo.TableInfo<Table_>>>, table: Table_ & {
+    readonly scope: IdScope.App;
+}): OrderedQuery<TableInfo.TableInfo<Table_>>;
+export declare function make<Table_ extends Table.AnyWithProps>(query: ConvexOrderedQuery<TableInfo.ConvexTableInfo<TableInfo.TableInfo<Table_>>>, table: Table_): OrderedQuery<TableInfo.TableInfo<Table_>, TableInfo.TableInfo<Table_>["document"], Table.Scope<Table_> extends IdScope.App ? "app" : "component">;
+export {};
+//# sourceMappingURL=OrderedQuery.d.ts.map

package/dist/OrderedQuery.d.ts.map

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

package/dist/OrderedQuery.js

@@ -0,0 +1,36 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { decode } from "./Document.js";
+import * as Effect from "effect/Effect";
+import { identity, pipe } from "effect/Function";
+import * as Stream from "effect/Stream";
+//#region src/OrderedQuery.ts
+var OrderedQuery_exports = /* @__PURE__ */ __exportAll({ make: () => make });
+function make(query, table) {
+	const streamEncoded = Stream.fromAsyncIterable(query, identity).pipe(Stream.orDie);
+	const stream = () => pipe(streamEncoded, Stream.mapEffect(decode(table)));
+	const first = () => pipe(stream(), Stream.take(1), Stream.runHead);
+	const take = (n) => pipe(stream(), Stream.take(n), Stream.runCollect);
+	const collect = () => pipe(stream(), Stream.runCollect);
+	return {
+		first,
+		take,
+		collect,
+		paginate: Effect.fn("OrderedQuery.paginate")(function* (options, filter) {
+			const filteredQuery = filter !== void 0 ? query.filter(filter) : query;
+			const paginationResult = yield* Effect.promise(() => filteredQuery.paginate(options));
+			return {
+				page: yield* Effect.forEach(paginationResult.page, decode(table)),
+				isDone: paginationResult.isDone,
+				continueCursor: paginationResult.continueCursor,
+				/* v8 ignore start */
+				...paginationResult.splitCursor ? { splitCursor: paginationResult.splitCursor } : {},
+				...paginationResult.pageStatus ? { pageStatus: paginationResult.pageStatus } : {}
+			};
+		}),
+		stream
+	};
+}
+//#endregion
+export { OrderedQuery_exports, make };
+
+//# sourceMappingURL=OrderedQuery.js.map

package/dist/OrderedQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrderedQuery.js","names":["Document.decode"],"sources":["../src/OrderedQuery.ts"],"sourcesContent":["import type * as IdScope from \"@confect/core/IdScope\";\nimport type {\n  ExpressionOrValue,\n  FilterBuilder,\n  OrderedQuery as ConvexOrderedQuery,\n  PaginationOptions,\n  PaginationResult,\n} from \"convex/server\";\nimport { identity, pipe } from \"effect/Function\";\nimport type { Option } from \"effect\";\nimport * as Effect from \"effect/Effect\";\nimport * as Stream from \"effect/Stream\";\nimport type * as DatabaseSchema from \"./DatabaseSchema\";\nimport * as Document from \"./Document\";\nimport type * as TableInfo from \"./TableInfo\";\nimport type * as Table from \"./Table\";\n\ntype NativePaginate<TableInfo_ extends TableInfo.AnyWithProps, Doc> = (\n  options: PaginationOptions,\n  filter?: (\n    q: FilterBuilder<TableInfo.ConvexTableInfo<TableInfo_>>,\n  ) => ExpressionOrValue<boolean>,\n) => Effect.Effect<PaginationResult<Doc>, Document.DocumentDecodeError>;\n\nexport type OrderedQuery<\n  TableInfo_ extends TableInfo.AnyWithProps,\n  Doc = TableInfo_[\"document\"],\n  TargetKind extends DatabaseSchema.Target[\"kind\"] = \"app\",\n> = {\n  readonly first: () => Effect.Effect<\n    Option.Option<Doc>,\n    Document.DocumentDecodeError\n  >;\n  readonly take: (\n    n: number,\n  ) => Effect.Effect<ReadonlyArray<Doc>, Document.DocumentDecodeError>;\n  readonly collect: () => Effect.Effect<\n    ReadonlyArray<Doc>,\n    Document.DocumentDecodeError\n  >;\n  readonly stream: () => Stream.Stream<Doc, Document.DocumentDecodeError>;\n  /**\n   * Native pagination is application-only. Use `QueryStream.paginate` for\n   * component index queries.\n   */\n  readonly paginate: {\n    readonly app: NativePaginate<TableInfo_, Doc>;\n    readonly component: {\n      readonly \"Native pagination is unavailable in components. Use QueryStream.paginate for index queries.\": never;\n    };\n  }[TargetKind];\n};\n\nexport function make<Table_ extends Table.AnyWithProps>(\n  query: ConvexOrderedQuery<\n    TableInfo.ConvexTableInfo<TableInfo.TableInfo<Table_>>\n  >,\n  table: Table_ & { readonly scope: IdScope.App },\n): OrderedQuery<TableInfo.TableInfo<Table_>>;\nexport function make<Table_ extends Table.AnyWithProps>(\n  query: ConvexOrderedQuery<\n    TableInfo.ConvexTableInfo<TableInfo.TableInfo<Table_>>\n  >,\n  table: Table_,\n): OrderedQuery<\n  TableInfo.TableInfo<Table_>,\n  TableInfo.TableInfo<Table_>[\"document\"],\n  Table.Scope<Table_> extends IdScope.App ? \"app\" : \"component\"\n>;\nexport function make<Table_ extends Table.AnyWithProps>(\n  query: ConvexOrderedQuery<\n    TableInfo.ConvexTableInfo<TableInfo.TableInfo<Table_>>\n  >,\n  table: Table_,\n): OrderedQuery<\n  TableInfo.TableInfo<Table_>,\n  TableInfo.TableInfo<Table_>[\"document\"],\n  DatabaseSchema.Target[\"kind\"]\n> {\n  type TableInfo_ = TableInfo.TableInfo<Table_>;\n  type OrderedQueryFunction<\n    FunctionName extends keyof OrderedQuery<TableInfo_>,\n  > = OrderedQuery<TableInfo_>[FunctionName];\n\n  const streamEncoded = Stream.fromAsyncIterable(query, identity).pipe(\n    Stream.orDie,\n  );\n\n  const stream: OrderedQueryFunction<\"stream\"> = () =>\n    pipe(streamEncoded, Stream.mapEffect(Document.decode(table)));\n\n  const first: OrderedQueryFunction<\"first\"> = () =>\n    pipe(stream(), Stream.take(1), Stream.runHead);\n\n  const take: OrderedQueryFunction<\"take\"> = (n: number) =>\n    pipe(stream(), Stream.take(n), Stream.runCollect);\n\n  const collect: OrderedQueryFunction<\"collect\"> = () =>\n    pipe(stream(), Stream.runCollect);\n\n  const paginate: NativePaginate<TableInfo_, TableInfo_[\"document\"]> =\n    Effect.fn(\"OrderedQuery.paginate\")(function* (options, filter) {\n      const filteredQuery = filter !== undefined ? query.filter(filter) : query;\n\n      const paginationResult = yield* Effect.promise(() =>\n        filteredQuery.paginate(options),\n      );\n\n      const parsedPage = yield* Effect.forEach(\n        paginationResult.page,\n        Document.decode(table),\n      );\n\n      return {\n        page: parsedPage,\n        isDone: paginationResult.isDone,\n        continueCursor: paginationResult.continueCursor,\n        /* v8 ignore start */\n        ...(paginationResult.splitCursor\n          ? { splitCursor: paginationResult.splitCursor }\n          : {}),\n        ...(paginationResult.pageStatus\n          ? { pageStatus: paginationResult.pageStatus }\n          : {}),\n        /* v8 ignore stop */\n      };\n    });\n\n  return {\n    first,\n    take,\n    collect,\n    paginate,\n    stream,\n  };\n}\n"],"mappings":";;;;;;;AAqEA,SAAgB,KACd,OAGA,OAKA;CAMA,MAAM,gBAAgB,OAAO,kBAAkB,OAAO,QAAQ,CAAC,CAAC,KAC9D,OAAO,KACT;CAEA,MAAM,eACJ,KAAK,eAAe,OAAO,UAAUA,OAAgB,KAAK,CAAC,CAAC;CAE9D,MAAM,cACJ,KAAK,OAAO,GAAG,OAAO,KAAK,CAAC,GAAG,OAAO,OAAO;CAE/C,MAAM,QAAsC,MAC1C,KAAK,OAAO,GAAG,OAAO,KAAK,CAAC,GAAG,OAAO,UAAU;CAElD,MAAM,gBACJ,KAAK,OAAO,GAAG,OAAO,UAAU;CA8BlC,OAAO;EACL;EACA;EACA;EACA,UA/BA,OAAO,GAAG,uBAAuB,CAAC,CAAC,WAAW,SAAS,QAAQ;GAC7D,MAAM,gBAAgB,WAAW,KAAA,IAAY,MAAM,OAAO,MAAM,IAAI;GAEpE,MAAM,mBAAmB,OAAO,OAAO,cACrC,cAAc,SAAS,OAAO,CAChC;GAOA,OAAO;IACL,MAAM,OANkB,OAAO,QAC/B,iBAAiB,MACjBA,OAAgB,KAAK,CACvB;IAIE,QAAQ,iBAAiB;IACzB,gBAAgB,iBAAiB;;IAEjC,GAAI,iBAAiB,cACjB,EAAE,aAAa,iBAAiB,YAAY,IAC5C,CAAC;IACL,GAAI,iBAAiB,aACjB,EAAE,YAAY,iBAAiB,WAAW,IAC1C,CAAC;GAEP;EACF,CAMO;EACP;CACF;AACF"}

package/dist/QueryCtx.d.ts

@@ -0,0 +1,10 @@
+import type * as IdScope from "@confect/core/IdScope";
+import type { GenericDataModel, GenericQueryCtx } from "convex/server";
+import * as Context from "effect/Context";
+import type * as ComponentCtx from "./ComponentCtx";
+import * as Layer from "effect/Layer";
+export type QueryCtxTag<DataModel extends GenericDataModel, Scope extends IdScope.IdScope = IdScope.App> = Context.Service<QueryCtx<DataModel, Scope>, Scope extends IdScope.App ? GenericQueryCtx<DataModel> : ComponentCtx.Query<DataModel, Scope>>;
+export declare const QueryCtx: <DataModel extends GenericDataModel, Scope extends IdScope.IdScope = IdScope.App>() => QueryCtxTag<DataModel, Scope>;
+export type QueryCtx<DataModel extends GenericDataModel, Scope extends IdScope.IdScope = IdScope.App> = Scope extends IdScope.App ? GenericQueryCtx<DataModel> : ComponentCtx.Identifier<"query", DataModel, Scope>;
+export declare const layer: <DataModel extends GenericDataModel, Scope extends IdScope.IdScope>(ctx: GenericQueryCtx<DataModel>, scope: Scope) => Layer.Layer<QueryCtx<DataModel, Scope>, never, never>;
+//# sourceMappingURL=QueryCtx.d.ts.map

package/dist/QueryCtx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryCtx.d.ts","sourceRoot":"","sources":["../src/QueryCtx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,KAAK,YAAY,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,MAAM,MAAM,WAAW,CACrB,SAAS,SAAS,gBAAgB,EAClC,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,IACzC,OAAO,CAAC,OAAO,CACjB,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,EAC1B,KAAK,SAAS,OAAO,CAAC,GAAG,GACrB,eAAe,CAAC,SAAS,CAAC,GAC1B,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CACzC,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,SAAS,SAAS,gBAAgB,EAClC,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,OACxC,WAAW,CAAC,SAAS,EAAE,KAAK,CACY,CAAC;AAE9C,MAAM,MAAM,QAAQ,CAClB,SAAS,SAAS,gBAAgB,EAClC,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,IACzC,KAAK,SAAS,OAAO,CAAC,GAAG,GACzB,eAAe,CAAC,SAAS,CAAC,GAC1B,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAEvD,eAAO,MAAM,KAAK,GAChB,SAAS,SAAS,gBAAgB,EAClC,KAAK,SAAS,OAAO,CAAC,OAAO,OAExB,eAAe,CAAC,SAAS,CAAC,SACxB,KAAK,0DAUb,CAAC"}

package/dist/QueryCtx.js

@@ -0,0 +1,18 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+//#region src/QueryCtx.ts
+var QueryCtx_exports = /* @__PURE__ */ __exportAll({
+	QueryCtx: () => QueryCtx,
+	layer: () => layer
+});
+const QueryCtx = () => Context.Service("@confect/server/QueryCtx");
+const layer = (ctx, scope) => {
+	const tag = QueryCtx();
+	const { auth: _auth, ...componentCtx } = ctx;
+	return Layer.succeed(tag, scope === "" ? ctx : componentCtx);
+};
+//#endregion
+export { QueryCtx, QueryCtx_exports, layer };
+
+//# sourceMappingURL=QueryCtx.js.map

package/dist/QueryCtx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryCtx.js","names":[],"sources":["../src/QueryCtx.ts"],"sourcesContent":["import type * as IdScope from \"@confect/core/IdScope\";\nimport type { GenericDataModel, GenericQueryCtx } from \"convex/server\";\nimport * as Context from \"effect/Context\";\nimport type * as ComponentCtx from \"./ComponentCtx\";\nimport * as Layer from \"effect/Layer\";\n\nexport type QueryCtxTag<\n  DataModel extends GenericDataModel,\n  Scope extends IdScope.IdScope = IdScope.App,\n> = Context.Service<\n  QueryCtx<DataModel, Scope>,\n  Scope extends IdScope.App\n    ? GenericQueryCtx<DataModel>\n    : ComponentCtx.Query<DataModel, Scope>\n>;\n\nexport const QueryCtx = <\n  DataModel extends GenericDataModel,\n  Scope extends IdScope.IdScope = IdScope.App,\n>(): QueryCtxTag<DataModel, Scope> =>\n  Context.Service(\"@confect/server/QueryCtx\");\n\nexport type QueryCtx<\n  DataModel extends GenericDataModel,\n  Scope extends IdScope.IdScope = IdScope.App,\n> = Scope extends IdScope.App\n  ? GenericQueryCtx<DataModel>\n  : ComponentCtx.Identifier<\"query\", DataModel, Scope>;\n\nexport const layer = <\n  DataModel extends GenericDataModel,\n  Scope extends IdScope.IdScope,\n>(\n  ctx: GenericQueryCtx<DataModel>,\n  scope: Scope,\n) => {\n  const tag = QueryCtx<DataModel, Scope>();\n  const { auth: _auth, ...componentCtx } = ctx;\n  return Layer.succeed(\n    tag,\n    (scope === \"\" ? ctx : componentCtx) as unknown as Context.Service.Shape<\n      typeof tag\n    >,\n  );\n};\n"],"mappings":";;;;;;;;AAgBA,MAAa,iBAIX,QAAQ,QAAQ,0BAA0B;AAS5C,MAAa,SAIX,KACA,UACG;CACH,MAAM,MAAM,SAA2B;CACvC,MAAM,EAAE,MAAM,OAAO,GAAG,iBAAiB;CACzC,OAAO,MAAM,QACX,KACC,UAAU,KAAK,MAAM,YAGxB;AACF"}

package/dist/QueryInitializer.d.ts

@@ -0,0 +1,75 @@
+import type * as IdScope from "@confect/core/IdScope";
+import type { DocumentByInfo, Indexes, IndexRange, IndexRangeBuilder, NamedIndex, NamedSearchIndex, SearchFilter, SearchFilterBuilder, SearchIndexes } from "convex/server";
+import type { GenericId } from "convex/values";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import type { BaseDatabaseReader, IndexFieldTypesForEq } from "@confect/core/Types";
+import type * as DataModel from "./DataModel";
+import type * as DatabaseSchema from "./DatabaseSchema";
+import * as Document from "./Document";
+import * as OrderedQuery from "./OrderedQuery";
+import * as QueryStream from "./QueryStream";
+import type * as QueryStreamKeyLabels from "./QueryStreamKeyLabels";
+import * as QueryStreamIndexRange from "./QueryStreamIndexRange";
+import type { QueryStreamOrderDirection as OrderDirection } from "./QueryStreamOrderDirection";
+import type * as Table from "./Table";
+type ConvexTableInfoFor<DataModel_ extends DataModel.AnyWithProps, TableName extends DataModel.TableNames<DataModel_>> = DataModel.TableInfoWithName<DataModel_, TableName>;
+type TableInfoFor<DataModel_ extends DataModel.AnyWithProps, TableName extends DataModel.TableNames<DataModel_>> = DataModel.TableInfoWithName_<DataModel_, TableName>;
+export interface QueryInitializer<DataModel_ extends DataModel.AnyWithProps, TableName extends DataModel.TableNames<DataModel_>, Doc = DataModel.DocumentWithName<DataModel_, TableName>, TargetKind extends DatabaseSchema.Target["kind"] = "app"> {
+    readonly get: {
+        (id: DataModel.Id<DataModel_, TableName>): Effect.Effect<Doc, Document.DocumentDecodeError | GetByIdFailure>;
+        <IndexName extends keyof Indexes<ConvexTableInfoFor<DataModel_, TableName>>>(indexName: IndexName, ...indexFieldValues: IndexFieldTypesForEq<DataModel.ToConvex<DataModel_>, TableName, Indexes<ConvexTableInfoFor<DataModel_, TableName>>[IndexName]>): Effect.Effect<Doc, Document.DocumentDecodeError | GetByIndexFailure>;
+    };
+    readonly index: {
+        <IndexName extends keyof Indexes<ConvexTableInfoFor<DataModel_, TableName>>>(indexName: IndexName, indexRange?: (q: IndexRangeBuilder<TableInfoFor<DataModel_, TableName>["convexDocument"], NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>>) => IndexRange, order?: OrderDirection): OrderedQuery.OrderedQuery<TableInfoFor<DataModel_, TableName>, Doc, TargetKind>;
+        <IndexName extends keyof Indexes<ConvexTableInfoFor<DataModel_, TableName>>>(indexName: IndexName, order?: OrderDirection): OrderedQuery.OrderedQuery<TableInfoFor<DataModel_, TableName>, Doc, TargetKind>;
+    };
+    readonly search: <IndexName extends keyof SearchIndexes<ConvexTableInfoFor<DataModel_, TableName>>>(indexName: IndexName, searchFilter: (q: SearchFilterBuilder<DocumentByInfo<ConvexTableInfoFor<DataModel_, TableName>>, NamedSearchIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>>) => SearchFilter) => OrderedQuery.OrderedQuery<TableInfoFor<DataModel_, TableName>, Doc, TargetKind>;
+    /**
+     * EXPERIMENTAL—stream-first querying (see `notes/stream-based-querying.md`).
+     *
+     * Like `index`, but returns a {@link QueryStream.QueryStream}: a genuine
+     * Effect `Stream` of documents in index order that stays mergeable and
+     * paginable.
+     *
+     * In SQL terms: an index range scan—`SELECT * FROM table WHERE <range> ORDER
+     * BY <index fields> [DESC]`; `eq` calls are the equality predicates, the
+     * bound calls are the range predicates. The value is a reusable description
+     * of a query: each run re-runs the index query. * The typed range builder
+     * consumes `eq`-pinned fields from the index's field tuple at the type level,
+     * so the stream's visible label type is exactly the fields that still vary
+     * (the `ORDER BY` columns left after the equality predicates). The order
+     * direction is part of the type too: omitted, it is `"asc"`; a literal is
+     * tracked as that literal, and a value known only at runtime as the union.
+     * The order parameter is either absent or a direction—never `undefined`—so
+     * the type can't claim a literal the runtime default would contradict.
+     */
+    readonly stream: {
+        <IndexName extends keyof Indexes<ConvexTableInfoFor<DataModel_, TableName>> & string, Range extends QueryStreamIndexRange.QueryStreamIndexRange>(indexName: IndexName, indexRange: (q: QueryStreamIndexRange.Builder<TableInfoFor<DataModel_, TableName>["convexDocument"], NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>>) => Range): QueryStream.QueryStream<Doc, QueryStreamKeyLabels.QueryStreamKeyLabels<QueryStreamIndexRange.Remaining<Range>>, "asc", Document.DocumentDecodeError, never>;
+        <IndexName extends keyof Indexes<ConvexTableInfoFor<DataModel_, TableName>> & string, Range extends QueryStreamIndexRange.QueryStreamIndexRange, Direction extends OrderDirection>(indexName: IndexName, indexRange: (q: QueryStreamIndexRange.Builder<TableInfoFor<DataModel_, TableName>["convexDocument"], NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>>) => Range, order: Direction): QueryStream.QueryStream<Doc, QueryStreamKeyLabels.QueryStreamKeyLabels<QueryStreamIndexRange.Remaining<Range>>, Direction, Document.DocumentDecodeError, never>;
+        <IndexName extends keyof Indexes<ConvexTableInfoFor<DataModel_, TableName>> & string>(indexName: IndexName): QueryStream.QueryStream<Doc, QueryStreamKeyLabels.QueryStreamKeyLabels<NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>>, "asc", Document.DocumentDecodeError, never>;
+        <IndexName extends keyof Indexes<ConvexTableInfoFor<DataModel_, TableName>> & string, Direction extends OrderDirection>(indexName: IndexName, order: Direction): QueryStream.QueryStream<Doc, QueryStreamKeyLabels.QueryStreamKeyLabels<NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>>, Direction, Document.DocumentDecodeError, never>;
+    };
+}
+export declare function make<Tables extends Table.AnyWithProps, TableName extends Table.Name<Tables>>(convexDatabaseReader: BaseDatabaseReader<DataModel.ToConvex<DataModel.FromTables<Tables>>>, table: Table.WithName<Tables, TableName> & {
+    readonly scope: IdScope.App;
+}): QueryInitializer<DataModel.FromTables<Tables>, TableName>;
+export declare function make<Tables extends Table.AnyWithProps, TableName extends Table.Name<Tables>>(convexDatabaseReader: BaseDatabaseReader<DataModel.ToConvex<DataModel.FromTables<Tables>>>, table: Table.WithName<Tables, TableName>): QueryInitializer<DataModel.FromTables<Tables>, TableName, DataModel.DocumentWithName<DataModel.FromTables<Tables>, TableName>, Table.Scope<Table.WithName<Tables, TableName>> extends IdScope.App ? "app" : "component">;
+export declare const getById: <Tables extends Table.AnyWithProps, TableName extends Table.Name<Tables>>(convexDatabaseReader: BaseDatabaseReader<DataModel.ToConvex<DataModel.FromTables<Tables>>>, table: Table.WithName<Tables, TableName>) => (id: GenericId<TableName>) => Effect.Effect<import("./TableInfo").TableInfo<Table.WithName<Tables, TableName>>["document"], Document.DocumentDecodeError | GetByIdFailure, never>;
+declare const GetByIdFailure_base: Schema.Class<GetByIdFailure, Schema.TaggedStruct<"GetByIdFailure", {
+    readonly id: Schema.String;
+    readonly tableName: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class GetByIdFailure extends GetByIdFailure_base {
+    get message(): string;
+}
+declare const GetByIndexFailure_base: Schema.Class<GetByIndexFailure, Schema.TaggedStruct<"GetByIndexFailure", {
+    readonly tableName: Schema.String;
+    readonly indexName: Schema.String;
+    readonly indexFieldValues: Schema.$Array<Schema.Unknown>;
+}>, import("effect/Cause").YieldableError>;
+export declare class GetByIndexFailure extends GetByIndexFailure_base {
+    get message(): string;
+}
+export {};
+//# sourceMappingURL=QueryInitializer.d.ts.map

package/dist/QueryInitializer.d.ts.map

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

package/dist/QueryInitializer.js

@@ -0,0 +1,105 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { decode, documentErrorMessage } from "./Document.js";
+import { make as make$1 } from "./OrderedQuery.js";
+import { builder } from "./QueryStreamIndexRange.js";
+import { fromReflection } from "./QueryStream.js";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { pipe } from "effect/Function";
+import * as Option from "effect/Option";
+import * as Array from "effect/Array";
+import * as Predicate from "effect/Predicate";
+import * as Result from "effect/Result";
+//#region src/QueryInitializer.ts
+var QueryInitializer_exports = /* @__PURE__ */ __exportAll({
+	GetByIdFailure: () => GetByIdFailure,
+	GetByIndexFailure: () => GetByIndexFailure,
+	getById: () => getById,
+	make: () => make
+});
+function make(convexDatabaseReader, table) {
+	const tableName = table.tableName;
+	const getByIndex = (indexName, indexFieldValues) => {
+		const indexFieldPaths = table.indexes[indexName];
+		return pipe(Effect.promise(() => convexDatabaseReader.query(tableName).withIndex(indexName, (q) => Array.reduce(indexFieldValues, q, (q_, v, i) => q_.eq(indexFieldPaths[i], v))).unique()), Effect.andThen((value) => Effect.fromResult(Result.fromNullishOr(value, () => new GetByIndexFailure({
+			tableName,
+			indexName,
+			indexFieldValues
+		})))), Effect.andThen(decode(table)));
+	};
+	const get = ((...args) => {
+		if (args.length === 1) {
+			const id = args[0];
+			return getById(convexDatabaseReader, table)(id);
+		} else {
+			const [indexName, ...indexFieldValues] = args;
+			return getByIndex(indexName, indexFieldValues);
+		}
+	});
+	const index = (indexName, indexRangeOrOrder, order) => {
+		const { applyWithIndex, applyOrder } = indexRangeOrOrder === void 0 ? {
+			applyWithIndex: (q) => q.withIndex(indexName),
+			applyOrder: (q) => q.order("asc")
+		} : typeof indexRangeOrOrder === "function" ? order === void 0 ? {
+			applyWithIndex: (q) => q.withIndex(indexName, indexRangeOrOrder),
+			applyOrder: (q) => q.order("asc")
+		} : {
+			applyWithIndex: (q) => q.withIndex(indexName, indexRangeOrOrder),
+			applyOrder: (q) => q.order(order)
+		} : {
+			applyWithIndex: (q) => q.withIndex(indexName),
+			applyOrder: (q) => q.order(indexRangeOrOrder)
+		};
+		const orderedQuery = pipe(convexDatabaseReader.query(tableName), applyWithIndex, applyOrder);
+		return make$1(orderedQuery, table);
+	};
+	const stream = ((indexName, indexRangeOrOrder, maybeOrder) => {
+		const orderDirection = Predicate.isString(indexRangeOrOrder) ? indexRangeOrOrder : maybeOrder ?? "asc";
+		const indexRange = Predicate.isFunction(indexRangeOrOrder) ? indexRangeOrOrder(builder()) : builder();
+		const indexFieldPaths = indexName === "by_id" ? ["_id"] : indexName === "by_creation_time" ? ["_creationTime"] : pipe(Option.fromUndefinedOr(table.indexes[indexName]), Option.getOrThrowWith(() => /* @__PURE__ */ new Error(`QueryInitializer.stream: table "${tableName}" has no index named "${indexName}"`)), Array.append("_creationTime"));
+		return fromReflection({
+			reader: convexDatabaseReader,
+			table,
+			indexName,
+			indexFieldPaths,
+			indexRange,
+			orderDirection
+		});
+	});
+	const search = (indexName, searchFilter) => make$1(convexDatabaseReader.query(tableName).withSearchIndex(indexName, searchFilter), table);
+	return {
+		get,
+		index,
+		search,
+		stream
+	};
+}
+const getById = (convexDatabaseReader, table) => (id) => pipe(Effect.promise(() => convexDatabaseReader.get(id)), Effect.andThen((value) => Effect.fromResult(Result.fromNullishOr(value, () => new GetByIdFailure({
+	tableName: table.tableName,
+	id
+})))), Effect.andThen(decode(table)));
+var GetByIdFailure = class extends Schema.TaggedError()("GetByIdFailure", {
+	id: Schema.String,
+	tableName: Schema.String
+}) {
+	get message() {
+		return documentErrorMessage({
+			id: this.id,
+			tableName: this.tableName,
+			message: "not found"
+		});
+	}
+};
+var GetByIndexFailure = class extends Schema.TaggedError()("GetByIndexFailure", {
+	tableName: Schema.String,
+	indexName: Schema.String,
+	indexFieldValues: Schema.Array(Schema.Unknown)
+}) {
+	get message() {
+		return `No documents found in table '${this.tableName}' with index '${this.indexName}' and field values '${JSON.stringify(this.indexFieldValues, (_key, value) => typeof value === "bigint" ? value.toString() : value)}'`;
+	}
+};
+//#endregion
+export { GetByIdFailure, GetByIndexFailure, QueryInitializer_exports, getById, make };
+
+//# sourceMappingURL=QueryInitializer.js.map

package/dist/QueryInitializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryInitializer.js","names":["Document.decode","OrderedQuery.make","QueryStreamIndexRange.builder","QueryStream.fromReflection","Document.documentErrorMessage"],"sources":["../src/QueryInitializer.ts"],"sourcesContent":["import type * as IdScope from \"@confect/core/IdScope\";\nimport type {\n  OrderedQuery as ConvexOrderedQuery,\n  QueryInitializer as ConvexQueryInitializer,\n  DocumentByInfo,\n  GenericTableIndexes,\n  Indexes,\n  IndexRange,\n  IndexRangeBuilder,\n  NamedIndex,\n  NamedSearchIndex,\n  NamedTableInfo,\n  Query,\n  SearchFilter,\n  SearchFilterBuilder,\n  SearchIndexes,\n} from \"convex/server\";\nimport type { GenericId } from \"convex/values\";\nimport { pipe } from \"effect/Function\";\nimport * as Array from \"effect/Array\";\nimport * as Effect from \"effect/Effect\";\nimport * as Option from \"effect/Option\";\nimport * as Predicate from \"effect/Predicate\";\nimport type { ReadonlyRecord } from \"effect/Record\";\nimport * as Result from \"effect/Result\";\nimport * as Schema from \"effect/Schema\";\nimport type {\n  BaseDatabaseReader,\n  IndexFieldTypesForEq,\n} from \"@confect/core/Types\";\nimport type * as DataModel from \"./DataModel\";\nimport type * as DatabaseSchema from \"./DatabaseSchema\";\nimport * as Document from \"./Document\";\nimport * as OrderedQuery from \"./OrderedQuery\";\nimport * as QueryStream from \"./QueryStream\";\nimport type * as QueryStreamKeyLabels from \"./QueryStreamKeyLabels\";\nimport * as QueryStreamIndexRange from \"./QueryStreamIndexRange\";\nimport type { QueryStreamOrderDirection as OrderDirection } from \"./QueryStreamOrderDirection\";\nimport type * as Table from \"./Table\";\n\ntype ConvexTableInfoFor<\n  DataModel_ extends DataModel.AnyWithProps,\n  TableName extends DataModel.TableNames<DataModel_>,\n> = DataModel.TableInfoWithName<DataModel_, TableName>;\n\ntype TableInfoFor<\n  DataModel_ extends DataModel.AnyWithProps,\n  TableName extends DataModel.TableNames<DataModel_>,\n> = DataModel.TableInfoWithName_<DataModel_, TableName>;\n\nexport interface QueryInitializer<\n  DataModel_ extends DataModel.AnyWithProps,\n  TableName extends DataModel.TableNames<DataModel_>,\n  Doc = DataModel.DocumentWithName<DataModel_, TableName>,\n  TargetKind extends DatabaseSchema.Target[\"kind\"] = \"app\",\n> {\n  readonly get: {\n    (\n      id: DataModel.Id<DataModel_, TableName>,\n    ): Effect.Effect<Doc, Document.DocumentDecodeError | GetByIdFailure>;\n    <\n      IndexName extends keyof Indexes<\n        ConvexTableInfoFor<DataModel_, TableName>\n      >,\n    >(\n      indexName: IndexName,\n      ...indexFieldValues: IndexFieldTypesForEq<\n        DataModel.ToConvex<DataModel_>,\n        TableName,\n        Indexes<ConvexTableInfoFor<DataModel_, TableName>>[IndexName]\n      >\n    ): Effect.Effect<Doc, Document.DocumentDecodeError | GetByIndexFailure>;\n  };\n  readonly index: {\n    <\n      IndexName extends keyof Indexes<\n        ConvexTableInfoFor<DataModel_, TableName>\n      >,\n    >(\n      indexName: IndexName,\n      indexRange?: (\n        q: IndexRangeBuilder<\n          TableInfoFor<DataModel_, TableName>[\"convexDocument\"],\n          NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>\n        >,\n      ) => IndexRange,\n      order?: OrderDirection,\n    ): OrderedQuery.OrderedQuery<\n      TableInfoFor<DataModel_, TableName>,\n      Doc,\n      TargetKind\n    >;\n    <\n      IndexName extends keyof Indexes<\n        ConvexTableInfoFor<DataModel_, TableName>\n      >,\n    >(\n      indexName: IndexName,\n      order?: OrderDirection,\n    ): OrderedQuery.OrderedQuery<\n      TableInfoFor<DataModel_, TableName>,\n      Doc,\n      TargetKind\n    >;\n  };\n  readonly search: <\n    IndexName extends keyof SearchIndexes<\n      ConvexTableInfoFor<DataModel_, TableName>\n    >,\n  >(\n    indexName: IndexName,\n    searchFilter: (\n      q: SearchFilterBuilder<\n        DocumentByInfo<ConvexTableInfoFor<DataModel_, TableName>>,\n        NamedSearchIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>\n      >,\n    ) => SearchFilter,\n  ) => OrderedQuery.OrderedQuery<\n    TableInfoFor<DataModel_, TableName>,\n    Doc,\n    TargetKind\n  >;\n  /**\n   * EXPERIMENTAL—stream-first querying (see `notes/stream-based-querying.md`).\n   *\n   * Like `index`, but returns a {@link QueryStream.QueryStream}: a genuine\n   * Effect `Stream` of documents in index order that stays mergeable and\n   * paginable.\n   *\n   * In SQL terms: an index range scan—`SELECT * FROM table WHERE <range> ORDER\n   * BY <index fields> [DESC]`; `eq` calls are the equality predicates, the\n   * bound calls are the range predicates. The value is a reusable description\n   * of a query: each run re-runs the index query. * The typed range builder\n   * consumes `eq`-pinned fields from the index's field tuple at the type level,\n   * so the stream's visible label type is exactly the fields that still vary\n   * (the `ORDER BY` columns left after the equality predicates). The order\n   * direction is part of the type too: omitted, it is `\"asc\"`; a literal is\n   * tracked as that literal, and a value known only at runtime as the union.\n   * The order parameter is either absent or a direction—never `undefined`—so\n   * the type can't claim a literal the runtime default would contradict.\n   */\n  readonly stream: {\n    <\n      IndexName extends keyof Indexes<\n        ConvexTableInfoFor<DataModel_, TableName>\n      > &\n        string,\n      Range extends QueryStreamIndexRange.QueryStreamIndexRange,\n    >(\n      indexName: IndexName,\n      indexRange: (\n        q: QueryStreamIndexRange.Builder<\n          TableInfoFor<DataModel_, TableName>[\"convexDocument\"],\n          NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>\n        >,\n      ) => Range,\n    ): QueryStream.QueryStream<\n      Doc,\n      QueryStreamKeyLabels.QueryStreamKeyLabels<\n        QueryStreamIndexRange.Remaining<Range>\n      >,\n      \"asc\",\n      Document.DocumentDecodeError,\n      never\n    >;\n    <\n      IndexName extends keyof Indexes<\n        ConvexTableInfoFor<DataModel_, TableName>\n      > &\n        string,\n      Range extends QueryStreamIndexRange.QueryStreamIndexRange,\n      Direction extends OrderDirection,\n    >(\n      indexName: IndexName,\n      indexRange: (\n        q: QueryStreamIndexRange.Builder<\n          TableInfoFor<DataModel_, TableName>[\"convexDocument\"],\n          NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>\n        >,\n      ) => Range,\n      order: Direction,\n    ): QueryStream.QueryStream<\n      Doc,\n      QueryStreamKeyLabels.QueryStreamKeyLabels<\n        QueryStreamIndexRange.Remaining<Range>\n      >,\n      Direction,\n      Document.DocumentDecodeError,\n      never\n    >;\n    <\n      IndexName extends keyof Indexes<\n        ConvexTableInfoFor<DataModel_, TableName>\n      > &\n        string,\n    >(\n      indexName: IndexName,\n    ): QueryStream.QueryStream<\n      Doc,\n      QueryStreamKeyLabels.QueryStreamKeyLabels<\n        NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>\n      >,\n      \"asc\",\n      Document.DocumentDecodeError,\n      never\n    >;\n    <\n      IndexName extends keyof Indexes<\n        ConvexTableInfoFor<DataModel_, TableName>\n      > &\n        string,\n      Direction extends OrderDirection,\n    >(\n      indexName: IndexName,\n      order: Direction,\n    ): QueryStream.QueryStream<\n      Doc,\n      QueryStreamKeyLabels.QueryStreamKeyLabels<\n        NamedIndex<ConvexTableInfoFor<DataModel_, TableName>, IndexName>\n      >,\n      Direction,\n      Document.DocumentDecodeError,\n      never\n    >;\n  };\n}\n\nexport function make<\n  Tables extends Table.AnyWithProps,\n  TableName extends Table.Name<Tables>,\n>(\n  convexDatabaseReader: BaseDatabaseReader<\n    DataModel.ToConvex<DataModel.FromTables<Tables>>\n  >,\n  table: Table.WithName<Tables, TableName> & { readonly scope: IdScope.App },\n): QueryInitializer<DataModel.FromTables<Tables>, TableName>;\nexport function make<\n  Tables extends Table.AnyWithProps,\n  TableName extends Table.Name<Tables>,\n>(\n  convexDatabaseReader: BaseDatabaseReader<\n    DataModel.ToConvex<DataModel.FromTables<Tables>>\n  >,\n  table: Table.WithName<Tables, TableName>,\n): QueryInitializer<\n  DataModel.FromTables<Tables>,\n  TableName,\n  DataModel.DocumentWithName<DataModel.FromTables<Tables>, TableName>,\n  Table.Scope<Table.WithName<Tables, TableName>> extends IdScope.App\n    ? \"app\"\n    : \"component\"\n>;\nexport function make<\n  Tables extends Table.AnyWithProps,\n  TableName extends Table.Name<Tables>,\n>(\n  convexDatabaseReader: BaseDatabaseReader<\n    DataModel.ToConvex<DataModel.FromTables<Tables>>\n  >,\n  table: Table.WithName<Tables, TableName>,\n): QueryInitializer<\n  DataModel.FromTables<Tables>,\n  TableName,\n  DataModel.DocumentWithName<DataModel.FromTables<Tables>, TableName>,\n  DatabaseSchema.Target[\"kind\"]\n> {\n  const tableName = table.tableName;\n  type DataModel_ = DataModel.FromTables<Tables>;\n  type ConvexDataModel_ = DataModel.ToConvex<DataModel_>;\n  type ThisQueryInitializer = QueryInitializer<\n    DataModel_,\n    TableName,\n    DataModel.DocumentWithName<DataModel_, TableName>,\n    DatabaseSchema.Target[\"kind\"]\n  >;\n  type QueryInitializerFunction<\n    FunctionName extends keyof ThisQueryInitializer,\n  > = ThisQueryInitializer[FunctionName];\n\n  const getByIndex = <\n    IndexName extends keyof Indexes<\n      DataModel.TableInfoWithName<DataModel_, TableName>\n    >,\n  >(\n    indexName: IndexName,\n    indexFieldValues: IndexFieldTypesForEq<\n      DataModel.ToConvex<DataModel_>,\n      TableName,\n      Indexes<DataModel.TableInfoWithName<DataModel_, TableName>>[IndexName]\n    >,\n  ): Effect.Effect<\n    DataModel.DocumentWithName<DataModel_, TableName>,\n    Document.DocumentDecodeError | GetByIndexFailure\n  > => {\n    const indexFieldPaths: GenericTableIndexes[keyof GenericTableIndexes] = (\n      table.indexes as GenericTableIndexes\n    )[indexName as keyof GenericTableIndexes]!;\n\n    return pipe(\n      Effect.promise(() =>\n        convexDatabaseReader\n          .query(tableName)\n          .withIndex(indexName, (q) =>\n            Array.reduce(\n              indexFieldValues,\n              q,\n              (q_, v, i) => q_.eq(indexFieldPaths[i] as any, v as any) as any,\n            ),\n          )\n          .unique(),\n      ),\n      Effect.andThen((value) =>\n        Effect.fromResult(\n          Result.fromNullishOr(\n            value,\n            () =>\n              new GetByIndexFailure({\n                tableName,\n                indexName: indexName as string,\n                indexFieldValues,\n              }),\n          ),\n        ),\n      ),\n      Effect.andThen(Document.decode(table)),\n    );\n  };\n\n  const get: QueryInitializerFunction<\"get\"> = ((\n    ...args: Parameters<QueryInitializerFunction<\"get\">>\n  ) => {\n    if (args.length === 1) {\n      const id = args[0] as GenericId<TableName>;\n\n      return getById<Tables, TableName>(convexDatabaseReader, table)(id);\n    } else {\n      const [indexName, ...indexFieldValues] = args;\n\n      return getByIndex(\n        indexName as keyof Indexes<\n          DataModel.TableInfoWithName<DataModel_, TableName>\n        >,\n        indexFieldValues,\n      );\n    }\n  }) as QueryInitializerFunction<\"get\">;\n\n  const index: QueryInitializerFunction<\"index\"> = <\n    IndexName extends keyof Indexes<\n      DataModel.TableInfoWithName<DataModel_, TableName>\n    >,\n  >(\n    indexName: IndexName,\n    indexRangeOrOrder?:\n      | ((\n          q: IndexRangeBuilder<\n            DataModel.TableInfoWithName_<\n              DataModel_,\n              TableName\n            >[\"convexDocument\"],\n            NamedIndex<\n              DataModel.TableInfoWithName<DataModel_, TableName>,\n              IndexName\n            >\n          >,\n        ) => IndexRange)\n      | OrderDirection,\n    order?: OrderDirection,\n  ) => {\n    const {\n      applyWithIndex,\n      applyOrder,\n    }: {\n      applyWithIndex: (\n        queryInitializer: ConvexQueryInitializer<\n          NamedTableInfo<ConvexDataModel_, TableName>\n        >,\n      ) => Query<NamedTableInfo<ConvexDataModel_, TableName>>;\n      applyOrder: (\n        query: Query<NamedTableInfo<ConvexDataModel_, TableName>>,\n      ) => ConvexOrderedQuery<NamedTableInfo<ConvexDataModel_, TableName>>;\n    } =\n      indexRangeOrOrder === undefined\n        ? {\n            applyWithIndex: (q) => q.withIndex(indexName),\n            applyOrder: (q) => q.order(\"asc\"),\n          }\n        : typeof indexRangeOrOrder === \"function\"\n          ? order === undefined\n            ? {\n                applyWithIndex: (q) =>\n                  q.withIndex(indexName, indexRangeOrOrder),\n                applyOrder: (q) => q.order(\"asc\"),\n              }\n            : {\n                applyWithIndex: (q) =>\n                  q.withIndex(indexName, indexRangeOrOrder),\n                applyOrder: (q) => q.order(order),\n              }\n          : {\n              applyWithIndex: (q) => q.withIndex(indexName),\n              applyOrder: (q) => q.order(indexRangeOrOrder),\n            };\n\n    const orderedQuery = pipe(\n      convexDatabaseReader.query(tableName),\n      applyWithIndex,\n      applyOrder,\n    );\n\n    return OrderedQuery.make(orderedQuery, table);\n  };\n\n  const stream: QueryInitializerFunction<\"stream\"> = ((\n    indexName: string,\n    indexRangeOrOrder?:\n      | ((\n          q: QueryStreamIndexRange.Builder<any, any>,\n        ) => QueryStreamIndexRange.QueryStreamIndexRange)\n      | OrderDirection,\n    maybeOrder?: OrderDirection,\n  ) => {\n    const orderDirection = Predicate.isString(indexRangeOrOrder)\n      ? indexRangeOrOrder\n      : (maybeOrder ?? \"asc\");\n\n    // Without a range callback, the leaf scans the entire index.\n    const indexRange = Predicate.isFunction(indexRangeOrOrder)\n      ? indexRangeOrOrder(QueryStreamIndexRange.builder())\n      : QueryStreamIndexRange.builder();\n\n    // The type-level field tuple appends the `_creationTime` tiebreaker, but\n    // the runtime `table.indexes` record stores only the declared fields—append it here.\n    const indexFieldPaths: ReadonlyArray<string> =\n      indexName === \"by_id\"\n        ? [\"_id\"]\n        : indexName === \"by_creation_time\"\n          ? [\"_creationTime\"]\n          : pipe(\n              Option.fromUndefinedOr(\n                (\n                  table.indexes as ReadonlyRecord<string, ReadonlyArray<string>>\n                )[indexName],\n              ),\n              // An unknown index name is a defect, not an empty field list:\n              // silently empty fields would make key extraction and range\n              // splitting target the wrong fields.\n              Option.getOrThrowWith(\n                () =>\n                  new Error(\n                    `QueryInitializer.stream: table \"${tableName}\" has no index named \"${indexName}\"`,\n                  ),\n              ),\n              Array.append(\"_creationTime\"),\n            );\n\n    return QueryStream.fromReflection({\n      reader: convexDatabaseReader as QueryStream.ReflectionReader,\n      table,\n      indexName,\n      indexFieldPaths,\n      indexRange,\n      orderDirection,\n    });\n  }) as QueryInitializerFunction<\"stream\">;\n\n  const search: QueryInitializerFunction<\"search\"> = (\n    indexName,\n    searchFilter,\n  ) =>\n    OrderedQuery.make(\n      convexDatabaseReader\n        .query(tableName)\n        .withSearchIndex(indexName, searchFilter),\n      table,\n    );\n\n  return {\n    get,\n    index,\n    search,\n    stream,\n  };\n}\n\nexport const getById =\n  <Tables extends Table.AnyWithProps, TableName extends Table.Name<Tables>>(\n    convexDatabaseReader: BaseDatabaseReader<\n      DataModel.ToConvex<DataModel.FromTables<Tables>>\n    >,\n    table: Table.WithName<Tables, TableName>,\n  ) =>\n  (id: GenericId<TableName>) =>\n    pipe(\n      Effect.promise(() => convexDatabaseReader.get(id)),\n      Effect.andThen((value) =>\n        Effect.fromResult(\n          Result.fromNullishOr(\n            value,\n            () => new GetByIdFailure({ tableName: table.tableName, id }),\n          ),\n        ),\n      ),\n      Effect.andThen(Document.decode(table)),\n    );\n\nexport class GetByIdFailure extends Schema.TaggedError<GetByIdFailure>()(\n  \"GetByIdFailure\",\n  {\n    id: Schema.String,\n    tableName: Schema.String,\n  },\n) {\n  override get message(): string {\n    return Document.documentErrorMessage({\n      id: this.id,\n      tableName: this.tableName,\n      message: \"not found\",\n    });\n  }\n}\n\nexport class GetByIndexFailure extends Schema.TaggedError<GetByIndexFailure>()(\n  \"GetByIndexFailure\",\n  {\n    tableName: Schema.String,\n    indexName: Schema.String,\n    indexFieldValues: Schema.Array(Schema.Unknown),\n  },\n) {\n  override get message(): string {\n    return `No documents found in table '${this.tableName}' with index '${this.indexName}' and field values '${JSON.stringify(\n      this.indexFieldValues,\n      (_key, value) => (typeof value === \"bigint\" ? value.toString() : value),\n    )}'`;\n  }\n}\n"],"mappings":"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"}

package/dist/QueryRunner.d.ts

@@ -0,0 +1,46 @@
+import * as Ref from "@confect/core/Ref";
+import type { GenericActionCtx } from "convex/server";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type * as Schema from "effect/Schema";
+import * as MutationTransactionContext from "./MutationTransactionContext";
+import * as QueryTransactionContext from "./QueryTransactionContext";
+export type Options = MutationTransactionContext.QueryOptions;
+export declare const QueryRunner: Context.Service<{
+    runQuery: {
+        <Query extends Ref.AnyQuery>(query: Query, ...args: [...Ref.OptionalArgs<Query>, options?: undefined]): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: (QueryTransactionContext.Options & {
+            readonly useStaleSnapshot?: never;
+        }) | undefined): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, QueryTransactionContext.QueryTransactionContext>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: Options & {
+            readonly useStaleSnapshot: boolean;
+        }): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, MutationTransactionContext.MutationTransactionContext>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: Options | undefined): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, QueryTransactionContext.QueryTransactionContext | MutationTransactionContext.MutationTransactionContext>;
+    };
+}, {
+    runQuery: {
+        <Query extends Ref.AnyQuery>(query: Query, ...args: [...Ref.OptionalArgs<Query>, options?: undefined]): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: (QueryTransactionContext.Options & {
+            readonly useStaleSnapshot?: never;
+        }) | undefined): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, QueryTransactionContext.QueryTransactionContext>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: Options & {
+            readonly useStaleSnapshot: boolean;
+        }): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, MutationTransactionContext.MutationTransactionContext>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: Options | undefined): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, QueryTransactionContext.QueryTransactionContext | MutationTransactionContext.MutationTransactionContext>;
+    };
+}>;
+export type QueryRunner = typeof QueryRunner.Identifier;
+export declare const layer: (runQuery: GenericActionCtx<any>["runQuery"]) => Layer.Layer<{
+    runQuery: {
+        <Query extends Ref.AnyQuery>(query: Query, ...args: [...Ref.OptionalArgs<Query>, options?: undefined]): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: (QueryTransactionContext.Options & {
+            readonly useStaleSnapshot?: never;
+        }) | undefined): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, QueryTransactionContext.QueryTransactionContext>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: Options & {
+            readonly useStaleSnapshot: boolean;
+        }): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, MutationTransactionContext.MutationTransactionContext>;
+        <Query extends Ref.AnyQuery>(query: Query, args: Ref.Args<Query>, options: Options | undefined): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError, QueryTransactionContext.QueryTransactionContext | MutationTransactionContext.MutationTransactionContext>;
+    };
+}, never, never>;
+//# sourceMappingURL=QueryRunner.d.ts.map

package/dist/QueryRunner.d.ts.map

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

package/dist/QueryRunner.js

@@ -0,0 +1,30 @@
+import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { MutationTransactionContext } from "./MutationTransactionContext.js";
+import { QueryTransactionContext } from "./QueryTransactionContext.js";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as Ref from "@confect/core/Ref";
+import * as Effect from "effect/Effect";
+//#region src/QueryRunner.ts
+var QueryRunner_exports = /* @__PURE__ */ __exportAll({
+	QueryRunner: () => QueryRunner,
+	layer: () => layer
+});
+const run = Effect.fn("QueryRunner.runQuery")((effect) => effect);
+const make = (nativeRunQuery) => {
+	function runQuery(query, args, options) {
+		return run(Effect.gen(function* () {
+			const actualArgs = args ?? {};
+			if (options?.useStaleSnapshot !== void 0) return yield* (yield* MutationTransactionContext).runQuery(query, actualArgs, options);
+			if (options !== void 0) return yield* (yield* QueryTransactionContext).runQuery(query, actualArgs, options);
+			return yield* Ref.runWithCodec(query, actualArgs, (ref, encodedArgs) => nativeRunQuery(ref, encodedArgs));
+		}));
+	}
+	return { runQuery };
+};
+const QueryRunner = Context.Service("@confect/server/QueryRunner");
+const layer = (runQuery) => Layer.succeed(QueryRunner, make(runQuery));
+//#endregion
+export { QueryRunner, QueryRunner_exports, layer };
+
+//# sourceMappingURL=QueryRunner.js.map

package/dist/QueryRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryRunner.js","names":["MutationTransactionContext.MutationTransactionContext","QueryTransactionContext.QueryTransactionContext"],"sources":["../src/QueryRunner.ts"],"sourcesContent":["import * as Ref from \"@confect/core/Ref\";\nimport type { GenericActionCtx } from \"convex/server\";\nimport * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport type * as Schema from \"effect/Schema\";\nimport * as MutationTransactionContext from \"./MutationTransactionContext\";\nimport * as QueryTransactionContext from \"./QueryTransactionContext\";\n\nexport type Options = MutationTransactionContext.QueryOptions;\n\nconst run = Effect.fn(\"QueryRunner.runQuery\")(\n  <A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> => effect,\n);\n\nconst make = (nativeRunQuery: GenericActionCtx<any>[\"runQuery\"]) => {\n  function runQuery<Query extends Ref.AnyQuery>(\n    query: Query,\n    ...args: [...Ref.OptionalArgs<Query>, options?: undefined]\n  ): Effect.Effect<Ref.Returns<Query>, Ref.Error<Query> | Schema.SchemaError>;\n  function runQuery<Query extends Ref.AnyQuery>(\n    query: Query,\n    args: Ref.Args<Query>,\n    options:\n      | (QueryTransactionContext.Options & {\n          readonly useStaleSnapshot?: never;\n        })\n      | undefined,\n  ): Effect.Effect<\n    Ref.Returns<Query>,\n    Ref.Error<Query> | Schema.SchemaError,\n    QueryTransactionContext.QueryTransactionContext\n  >;\n  function runQuery<Query extends Ref.AnyQuery>(\n    query: Query,\n    args: Ref.Args<Query>,\n    options: Options & { readonly useStaleSnapshot: boolean },\n  ): Effect.Effect<\n    Ref.Returns<Query>,\n    Ref.Error<Query> | Schema.SchemaError,\n    MutationTransactionContext.MutationTransactionContext\n  >;\n  function runQuery<Query extends Ref.AnyQuery>(\n    query: Query,\n    args: Ref.Args<Query>,\n    options: Options | undefined,\n  ): Effect.Effect<\n    Ref.Returns<Query>,\n    Ref.Error<Query> | Schema.SchemaError,\n    | QueryTransactionContext.QueryTransactionContext\n    | MutationTransactionContext.MutationTransactionContext\n  >;\n  function runQuery<Query extends Ref.AnyQuery>(\n    query: Query,\n    args?: Ref.Args<Query>,\n    options?: Options,\n  ): Effect.Effect<\n    Ref.Returns<Query>,\n    Ref.Error<Query> | Schema.SchemaError,\n    | QueryTransactionContext.QueryTransactionContext\n    | MutationTransactionContext.MutationTransactionContext\n  > {\n    return run(\n      Effect.gen(function* () {\n        const actualArgs = (args ?? {}) as Ref.Args<Query>;\n        if (options?.useStaleSnapshot !== undefined) {\n          const controls =\n            yield* MutationTransactionContext.MutationTransactionContext;\n          return yield* controls.runQuery(query, actualArgs, options);\n        }\n        if (options !== undefined) {\n          const controls =\n            yield* QueryTransactionContext.QueryTransactionContext;\n          return yield* controls.runQuery(query, actualArgs, options);\n        }\n        return yield* Ref.runWithCodec(query, actualArgs, (ref, encodedArgs) =>\n          nativeRunQuery(ref, encodedArgs),\n        );\n      }),\n    );\n  }\n  return { runQuery };\n};\n\nexport const QueryRunner = Context.Service<ReturnType<typeof make>>(\n  \"@confect/server/QueryRunner\",\n);\nexport type QueryRunner = typeof QueryRunner.Identifier;\n\nexport const layer = (runQuery: GenericActionCtx<any>[\"runQuery\"]) =>\n  Layer.succeed(QueryRunner, make(runQuery));\n"],"mappings":";;;;;;;;;;;;AAWA,MAAM,MAAM,OAAO,GAAG,sBAAsB,CAAC,EACjC,WAA2D,MACvE;AAEA,MAAM,QAAQ,mBAAsD;CAqClE,SAAS,SACP,OACA,MACA,SAMA;EACA,OAAO,IACL,OAAO,IAAI,aAAa;GACtB,MAAM,aAAc,QAAQ,CAAC;GAC7B,IAAI,SAAS,qBAAqB,KAAA,GAGhC,OAAO,QAAO,OADLA,2BAAAA,CACc,SAAS,OAAO,YAAY,OAAO;GAE5D,IAAI,YAAY,KAAA,GAGd,OAAO,QAAO,OADLC,wBAAAA,CACc,SAAS,OAAO,YAAY,OAAO;GAE5D,OAAO,OAAO,IAAI,aAAa,OAAO,aAAa,KAAK,gBACtD,eAAe,KAAK,WAAW,CACjC;EACF,CAAC,CACH;CACF;CACA,OAAO,EAAE,SAAS;AACpB;AAEA,MAAa,cAAc,QAAQ,QACjC,6BACF;AAGA,MAAa,SAAS,aACpB,MAAM,QAAQ,aAAa,KAAK,QAAQ,CAAC"}