@gaganref/confect-server 10.3.1-fork.36 → 10.3.1-fork.39

package/dist/RegisteredFunction.js

@@ -6,14 +6,16 @@ import { layer as layer$3 } from "./QueryRunner.js";
 import { layer as layer$4 } from "./Scheduler.js";
 import { ActionCallAlreadyUsed, ActionCallNotUsed, NestedActionNotAllowed, SchedulingNotAllowed } from "./ActionCall.js";
 import { layer as layer$5, layerForTarget } from "./Auth.js";
-import { layer as layer$6 } from "./ExecutionMetadata.js";
-import { layer as layer$7 } from "./RequestMetadata.js";
-import { layer as layer$8 } from "./ConvexLogger.js";
+import { layer as layer$6 } from "./ConvexLogger.js";
+import { layer as layer$7 } from "./ExecutionMetadata.js";
+import { layer as layer$8 } from "./RequestMetadata.js";
 import { StorageActionWriter } from "./StorageActionWriter.js";
 import { StorageWriter } from "./StorageWriter.js";
 import { layer as layer$9 } from "./Storage.js";
+import { memoized } from "./internal/observability.js";
 import { layer as layer$10 } from "./VectorSearch.js";
 import * as ActionCallSpec from "@confect/core/ActionCall";
+import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as MiddlewareSpec from "@confect/core/MiddlewareSpec";
@@ -23,9 +25,14 @@ import { compileArgsSchema, compileReturnsSchema } from "@confect/core/SchemaToV
 import { ConvexError } from "convex/values";
 import * as Result from "effect/Result";
 import * as IdScope from "@confect/core/IdScope";
+import * as Clock from "effect/Clock";
+import * as Cause from "effect/Cause";
 import * as Console from "effect/Console";
+import * as Exit from "effect/Exit";
+import * as Tracer from "effect/Tracer";
 //#region src/RegisteredFunction.ts
 var RegisteredFunction_exports = /* @__PURE__ */ __exportAll({
+	Observability: () => Observability,
 	actionFunctionBase: () => actionFunctionBase,
 	actionLayer: () => actionLayer,
 	applyMiddleware: () => applyMiddleware,
@@ -34,6 +41,7 @@ var RegisteredFunction_exports = /* @__PURE__ */ __exportAll({
 	runHandlerPromise: () => runHandlerPromise,
 	storageLayer: () => storageLayer
 });
+const Observability = Context.Reference("@confect/server/Observability", { defaultValue: () => void 0 });
 /**
 * Wrap a function's handler effect in its resolved middleware chain, per
 * invocation, after args decode. Iterated innermost-first so that the
@@ -63,43 +71,70 @@ const combineErrorSchemas = (error, resolvedMiddlewares) => {
 	return schemas.length === 0 ? void 0 : schemas.length === 1 ? schemas[0] : Schema.Union(schemas);
 };
 /**
-* Run the `Effect` as a `Promise`. The error schema acts as an allowlist of
-* failures that may be surfaced to the client as a `ConvexError`:
+* Run the `Effect` as a `Promise`. Inspect the complete `Exit` before encoding
+* a declared error so a typed failure cannot hide a defect.
 *
-* - With a schema: typed errors are schema-encoded and wrapped in a
-*   `ConvexError`, then thrown so Convex surfaces the data to the client.
-*   `Effect.either` escapes the failure channel before `runPromise` so the
-*   thrown `ConvexError` retains its `Symbol.for("ConvexError")` identity
-*   instead of being wrapped in Effect's `FiberFailure`.
-* - Without a schema: every failure is converted to a defect via `Effect.orDie`,
-*   so nothing—not even a `ConvexError` the handler placed in its error
-*   channel—reaches the client as a `ConvexError`. The fiber dies and
-*   `runPromise` rejects with a generic failure.
+* Any `Die` reason takes the defect path. Without a `Die`, the first `Fail` in
+* cause order is schema-encoded and thrown as a `ConvexError` outside the
+* Effect runtime so Convex surfaces its data to the client. Other failures and
+* interruptions alongside that `Fail` are ignored. Without an error schema, the
+* selected failure is treated as a defect.
 *
-* Either way, a `ConvexError` _defect_—thrown imperatively rather than placed
-* in the error channel, e.g. the pagination protocol's `InvalidCursor` signal
-* from `QueryStream.paginate`—is rethrown bare so it retains its identity and
-* Convex serializes its `data` to the client, matching how a thrown
-* `ConvexError` behaves in a plain Convex handler.
+* A lone `ConvexError` defect or a selected undeclared `ConvexError` failure is
+* rethrown bare so it keeps Convex's meaning. Pagination and Workpool rely on
+* its data for their control signals. Other causes with a `Die`, interrupt-only
+* or empty causes, and error-encoding failures reject with a plain `Error`
+* whose message renders the complete cause and whose `cause` holds it for
+* server diagnostics.
 *
 * A `scheduler` in `runOptions` must be passed here as a run option rather than
 * provided via `Effect.provideService` inside `effect`: the run option lands in
 * the fiber's root context, while a service provided within `effect` pops
-* before the `orDie`/`catch`/`result` wrappers this function adds. The fiber's
-* op counter survives context pops, so a cooperative yield can fire inside
-* those wrappers—only a root-context scheduler covers them.
+* before the exit/encoding wrappers this function adds. The fiber's op counter
+* survives context pops, so a cooperative yield can fire inside those wrappers.
+* Only a root-context scheduler covers them.
 */
 const runHandlerPromise = (errorSchema, runOptions) => (effect) => {
-	const rethrowConvexErrorDefects = Effect.catchDefect((defect) => defect instanceof ConvexError ? Effect.fail(defect) : Effect.die(defect));
-	const withConvexError = errorSchema === void 0 ? Effect.orDie(effect) : effect.pipe(Effect.catch((typedError) => pipe(Schema.encodeEffect(errorSchema)(typedError), Effect.catchTag("SchemaError", Effect.die), Effect.andThen((encodedError) => Effect.fail(new ConvexError(encodedError))))));
-	return Effect.runPromise(Effect.result(rethrowConvexErrorDefects(withConvexError)).pipe(Effect.provide(layer$8), Effect.provideService(Console.Console, globalThis.console)), runOptions).then(Result.match({
+	const { observability, invocation, clock } = runOptions ?? {};
+	let encodedError;
+	const observed = Effect.tapCause(effect, (cause) => Effect.gen(function* () {
+		const reason = cause.reasons.find(Cause.isDieReason) ?? cause.reasons.find(Cause.isFailReason);
+		if (reason?._tag === "Fail" && errorSchema !== void 0) {
+			encodedError = yield* Effect.exit(Schema.encodeEffect(errorSchema)(reason.error));
+			if (Exit.isFailure(encodedError)) return yield* Effect.orDie(encodedError);
+		}
+	}));
+	const withConvexError = Effect.gen(function* () {
+		const exit = yield* Effect.exit(observability === void 0 || invocation === void 0 ? effect : Effect.flatMap(invocation, ({ name, type, componentPath }) => Effect.useSpan(name, {
+			root: true,
+			attributes: {
+				kind: type,
+				componentPath
+			}
+		}, (span) => Effect.provideService(observed, Tracer.ParentSpan, span))));
+		if (Exit.isSuccess(exit)) return Result.succeed(exit.value);
+		const cause = encodedError !== void 0 && Exit.isFailure(encodedError) ? encodedError.cause : exit.cause;
+		const reason = cause.reasons.find(Cause.isDieReason) ?? cause.reasons.find(Cause.isFailReason);
+		if (encodedError === void 0 && reason?._tag === "Die" && cause.reasons.length === 1 && reason.defect instanceof ConvexError) return Result.fail(reason.defect);
+		if (reason?._tag === "Fail") {
+			if (errorSchema === void 0) {
+				if (reason.error instanceof ConvexError) return Result.fail(reason.error);
+				return yield* Effect.die(reason.error);
+			}
+			const encoded = encodedError ?? (yield* Effect.exit(Schema.encodeEffect(errorSchema)(reason.error)));
+			if (Exit.isSuccess(encoded)) return Result.fail(new ConvexError(encoded.value));
+			return yield* Effect.die(new Error(Cause.pretty(encoded.cause), { cause: encoded.cause }));
+		}
+		return yield* Effect.die(new Error(Cause.pretty(cause), { cause }));
+	});
+	return Effect.runPromise(withConvexError.pipe(Effect.provide(observability === void 0 ? layer$6 : memoized(observability)), Effect.provideService(Console.Console, globalThis.console), clock === void 0 ? (self) => self : Effect.provideService(Clock.Clock, clock)), runOptions).then(Result.match({
 		onFailure: (error) => {
 			throw error;
 		},
 		onSuccess: (value) => value
 	}));
 };
-const actionFunctionBase = ({ name, functionVisibility, args, returns, error, handler, resolvedMiddlewares = [], createLayer, scope = IdScope.app }) => ({
+const actionFunctionBase = ({ name, functionVisibility, args, returns, error, handler, resolvedMiddlewares = [], createLayer, scope = IdScope.app, observability }) => ({
 	args: compileArgsSchema(args, scope),
 	returns: compileReturnsSchema(returns, scope),
 	handler: (ctx, actualArgs) => Effect.gen(function* () {
@@ -113,15 +148,18 @@ const actionFunctionBase = ({ name, functionVisibility, args, returns, error, ha
 		}).pipe(Effect.provide(createLayer(restricted?.ctx ?? ctx)));
 		if (restricted !== void 0) yield* restricted.check;
 		return yield* pipe(decodedReturns, Schema.encodeEffect(returns), Effect.catchTag("SchemaError", Effect.die));
-	}).pipe(runHandlerPromise(combineErrorSchemas(error, resolvedMiddlewares)))
+	}).pipe(runHandlerPromise(combineErrorSchemas(error, resolvedMiddlewares), {
+		invocation: Effect.promise(() => ctx.meta.getFunctionMetadata()),
+		observability
+	}))
 });
 /**
 * The ctx-backed action services that don't depend on a Confect database
 * schema. {@link actionLayer} adds the schema-typed `VectorSearch` on top; the
 * HTTP API handler uses this base directly.
 */
-const baseActionLayer = (ctx) => Layer.mergeAll(layer$4(ctx.scheduler), layer$5(ctx.auth), layer$6(ctx.meta), layer$7(ctx.meta), layer$9(ctx.storage), StorageWriter.layer(ctx.storage), StorageActionWriter.layer(ctx.storage), layer$3(ctx.runQuery.bind(ctx)), layer$2(ctx.runMutation.bind(ctx)), layer$1(ctx.runAction.bind(ctx)), Layer.succeed(ActionCtx(), ctx));
-const actionLayer = (databaseSchema, ctx) => Layer.mergeAll(layer$4(ctx.scheduler, databaseSchema.target.scope), layerForTarget(databaseSchema.target, ctx.auth), layer$6(ctx.meta), layer$7(ctx.meta), storageLayer(ctx.storage), StorageWriter.layer(ctx.storage, databaseSchema.target.scope), StorageActionWriter.layer(ctx.storage, databaseSchema.target.scope), layer$3(ctx.runQuery.bind(ctx)), layer$2(ctx.runMutation.bind(ctx)), layer$1(ctx.runAction.bind(ctx)), layer(ctx, databaseSchema.target.scope), layer$10(ctx.vectorSearch.bind(ctx)));
+const baseActionLayer = (ctx) => Layer.mergeAll(layer$4(ctx.scheduler), layer$5(ctx.auth), layer$7(ctx.meta), layer$8(ctx.meta), layer$9(ctx.storage), StorageWriter.layer(ctx.storage), StorageActionWriter.layer(ctx.storage), layer$3(ctx.runQuery.bind(ctx)), layer$2(ctx.runMutation.bind(ctx)), layer$1(ctx.runAction.bind(ctx)), Layer.succeed(ActionCtx(), ctx));
+const actionLayer = (databaseSchema, ctx) => Layer.mergeAll(layer$4(ctx.scheduler, databaseSchema.target.scope), layerForTarget(databaseSchema.target, ctx.auth), layer$7(ctx.meta), layer$8(ctx.meta), storageLayer(ctx.storage), StorageWriter.layer(ctx.storage, databaseSchema.target.scope), StorageActionWriter.layer(ctx.storage, databaseSchema.target.scope), layer$3(ctx.runQuery.bind(ctx)), layer$2(ctx.runMutation.bind(ctx)), layer$1(ctx.runAction.bind(ctx)), layer(ctx, databaseSchema.target.scope), layer$10(ctx.vectorSearch.bind(ctx)));
 const storageLayer = (reader) => layer$9(reader);
 /**
 * Shares one dispatch budget across the entire middleware chain.
@@ -162,6 +200,6 @@ const restrict = (ctx) => {
 	};
 };
 //#endregion
-export { RegisteredFunction_exports, actionFunctionBase, actionLayer, applyMiddleware, baseActionLayer, combineErrorSchemas, runHandlerPromise, storageLayer };
+export { Observability, RegisteredFunction_exports, actionFunctionBase, actionLayer, applyMiddleware, baseActionLayer, combineErrorSchemas, runHandlerPromise, storageLayer };
 
 //# sourceMappingURL=RegisteredFunction.js.map

package/dist/RegisteredFunction.js.map

@@ -1 +1 @@
-{"version":3,"file":"RegisteredFunction.js","names":["ConvexLogger.layer","Scheduler.layer","Auth.layer","ExecutionMetadata.layer","RequestMetadata.layer","Storage.layer","QueryRunner.layer","MutationRunner.layer","ActionRunner.layer","ActionCtx.ActionCtx","Auth.layerForTarget","ActionCtx.layer","VectorSearch.layer","ActionCall.ActionCallAlreadyUsed","ActionCall.SchedulingNotAllowed","ActionCall.NestedActionNotAllowed","ActionCall.ActionCallNotUsed"],"sources":["../src/RegisteredFunction.ts"],"sourcesContent":["import * as ActionCallSpec from \"@confect/core/ActionCall\";\nimport * as ActionCall from \"./ActionCall.js\";\nimport type { FunctionSpec, RuntimeAndFunctionType } from \"@confect/core\";\nimport * as IdScope from \"@confect/core/IdScope\";\nimport type * as FunctionProvenance from \"@confect/core/FunctionProvenance\";\nimport * as MiddlewareSpec from \"@confect/core/MiddlewareSpec\";\nimport {\n  compileArgsSchema,\n  compileReturnsSchema,\n} from \"@confect/core/SchemaToValidator\";\nimport {\n  type DefaultFunctionArgs,\n  type FunctionVisibility,\n  type GenericActionCtx,\n  type GenericDataModel,\n  type StorageReader as ConvexStorageReader,\n  type RegisteredAction,\n  type RegisteredMutation,\n  type RegisteredQuery,\n} from \"convex/server\";\nimport type { Value } from \"convex/values\";\nimport { ConvexError } from \"convex/values\";\nimport { pipe } from \"effect/Function\";\nimport * as Console from \"effect/Console\";\nimport * as Effect from \"effect/Effect\";\nimport * as Result from \"effect/Result\";\nimport * as Layer from \"effect/Layer\";\nimport * as Schema from \"effect/Schema\";\nimport type * as EffectScheduler from \"effect/Scheduler\";\nimport * as ActionCtx from \"./ActionCtx.js\";\nimport * as ActionRunner from \"./ActionRunner.js\";\nimport * as Auth from \"./Auth.js\";\nimport * as ConvexLogger from \"./ConvexLogger.js\";\nimport type * as DatabaseSchema from \"./DatabaseSchema.js\";\nimport type * as DataModel from \"./DataModel.js\";\nimport * as ExecutionMetadata from \"./ExecutionMetadata.js\";\nimport * as RequestMetadata from \"./RequestMetadata.js\";\nimport * as MutationRunner from \"./MutationRunner.js\";\nimport * as QueryRunner from \"./QueryRunner.js\";\nimport type * as ResolvedMiddleware from \"./ResolvedMiddleware.js\";\nimport * as Scheduler from \"./Scheduler.js\";\nimport * as Storage from \"./Storage.js\";\nimport * as StorageActionWriter from \"./StorageActionWriter.js\";\nimport type * as StorageReader from \"./StorageReader.js\";\nimport * as StorageWriter from \"./StorageWriter.js\";\nimport * as VectorSearch from \"./VectorSearch.js\";\nimport type * as Handler from \"./Handler.js\";\n\nexport type Any =\n  | RegisteredQuery<FunctionVisibility, DefaultFunctionArgs, any>\n  | RegisteredMutation<FunctionVisibility, DefaultFunctionArgs, any>\n  | RegisteredAction<FunctionVisibility, DefaultFunctionArgs, any>;\n\ntype ConfectRegisteredFunction<\n  FunctionSpec_ extends FunctionSpec.AnyWithProps,\n> =\n  FunctionSpec.EncodedArgs<FunctionSpec_> extends infer Args_ extends\n    DefaultFunctionArgs\n    ? RuntimeAndFunctionType.GetFunctionType<\n        FunctionSpec_[\"runtimeAndFunctionType\"]\n      > extends \"query\"\n      ? RegisteredQuery<\n          FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n          Args_,\n          Promise<FunctionSpec.EncodedReturns<FunctionSpec_>>\n        >\n      : RuntimeAndFunctionType.GetFunctionType<\n            FunctionSpec_[\"runtimeAndFunctionType\"]\n          > extends \"mutation\"\n        ? RegisteredMutation<\n            FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n            Args_,\n            Promise<FunctionSpec.EncodedReturns<FunctionSpec_>>\n          >\n        : RuntimeAndFunctionType.GetFunctionType<\n              FunctionSpec_[\"runtimeAndFunctionType\"]\n            > extends \"action\"\n          ? RegisteredAction<\n              FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n              Args_,\n              Promise<FunctionSpec.EncodedReturns<FunctionSpec_>>\n            >\n          : never\n    : never;\n\nexport type ConvexRegisteredFunction<\n  FunctionSpec_ extends FunctionSpec.AnyWithProps,\n> = FunctionSpec_ extends FunctionSpec.AnyWithProps\n  ? FunctionSpec.GetFunctionProvenance<FunctionSpec_> extends FunctionProvenance.Convex<\n      infer Args_ extends DefaultFunctionArgs,\n      infer Returns_\n    >\n    ? RuntimeAndFunctionType.GetFunctionType<\n        FunctionSpec_[\"runtimeAndFunctionType\"]\n      > extends \"query\"\n      ? RegisteredQuery<\n          FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n          Args_,\n          Returns_\n        >\n      : RuntimeAndFunctionType.GetFunctionType<\n            FunctionSpec_[\"runtimeAndFunctionType\"]\n          > extends \"mutation\"\n        ? RegisteredMutation<\n            FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n            Args_,\n            Returns_\n          >\n        : RuntimeAndFunctionType.GetFunctionType<\n              FunctionSpec_[\"runtimeAndFunctionType\"]\n            > extends \"action\"\n          ? RegisteredAction<\n              FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n              Args_,\n              Returns_\n            >\n          : never\n    : never\n  : never;\n\nexport type RegisteredFunction<\n  FunctionSpec_ extends FunctionSpec.AnyWithProps,\n> =\n  FunctionSpec_ extends FunctionSpec.WithFunctionProvenance<\n    FunctionSpec_,\n    FunctionProvenance.AnyConvex\n  >\n    ? ConvexRegisteredFunction<FunctionSpec_>\n    : FunctionSpec_ extends FunctionSpec.WithFunctionProvenance<\n          FunctionSpec_,\n          FunctionProvenance.AnyConfect\n        >\n      ? ConfectRegisteredFunction<FunctionSpec_>\n      : never;\n\n/**\n * Wrap a function's handler effect in its resolved middleware chain, per\n * invocation, after args decode. Iterated innermost-first so that the\n * first-attached (group-level, in attachment order) middleware ends up\n * outermost and runs first. Erased types: the public safety story lives at the\n * `MiddlewareSpec.MiddlewareImpl`/`MiddlewareImpl.make` signatures, and the\n * composed effect's error channel is re-accounted by\n * {@link combineErrorSchemas}.\n */\nexport const applyMiddleware = <A, E, R>(\n  effect: Effect.Effect<A, E, R>,\n  resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>,\n  invocation: MiddlewareSpec.MiddlewareOptions[\"invocation\"],\n): Effect.Effect<A, any, R> => {\n  return resolvedMiddlewares.reduceRight<Effect.Effect<any, any, any>>(\n    // oxlint-disable-next-line effecttsgo/any-unknown-in-error-context -- The erased middleware error remains intact so runHandlerPromise can validate it against the combined error schema.\n    (wrapped, middleware) => {\n      const context =\n        \"options\" in middleware.middlewareSpec\n          ? { options: middleware.options, invocation }\n          : { invocation };\n      // oxlint-disable-next-line effecttsgo/any-unknown-in-error-context -- Resolved middleware is type-erased after its public implementation boundary; its error and service channels are restored by the surrounding function contract.\n      return middleware.middlewareImpl(wrapped, context);\n    },\n    effect,\n  );\n};\n\n/**\n * The error-schema allowlist for a function with middleware: the function's own\n * declared `error` schema unioned with every covering middleware's error\n * schema. `undefined` (⇒ every failure dies) only when neither declares\n * one—mirroring the ref-side union clients decode against.\n */\nexport const combineErrorSchemas = (\n  error: Schema.Codec<any, any> | undefined,\n  resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>,\n): Schema.Codec<any, any> | undefined => {\n  const schemas = [\n    ...(error !== undefined ? [error] : []),\n    ...MiddlewareSpec.errorSchemas(\n      resolvedMiddlewares.map(({ middlewareSpec }) => middlewareSpec),\n    ),\n  ];\n  return schemas.length === 0\n    ? undefined\n    : schemas.length === 1\n      ? schemas[0]\n      : Schema.Union(schemas);\n};\n\n/**\n * Run the `Effect` as a `Promise`. The error schema acts as an allowlist of\n * failures that may be surfaced to the client as a `ConvexError`:\n *\n * - With a schema: typed errors are schema-encoded and wrapped in a\n *   `ConvexError`, then thrown so Convex surfaces the data to the client.\n *   `Effect.either` escapes the failure channel before `runPromise` so the\n *   thrown `ConvexError` retains its `Symbol.for(\"ConvexError\")` identity\n *   instead of being wrapped in Effect's `FiberFailure`.\n * - Without a schema: every failure is converted to a defect via `Effect.orDie`,\n *   so nothing—not even a `ConvexError` the handler placed in its error\n *   channel—reaches the client as a `ConvexError`. The fiber dies and\n *   `runPromise` rejects with a generic failure.\n *\n * Either way, a `ConvexError` _defect_—thrown imperatively rather than placed\n * in the error channel, e.g. the pagination protocol's `InvalidCursor` signal\n * from `QueryStream.paginate`—is rethrown bare so it retains its identity and\n * Convex serializes its `data` to the client, matching how a thrown\n * `ConvexError` behaves in a plain Convex handler.\n *\n * A `scheduler` in `runOptions` must be passed here as a run option rather than\n * provided via `Effect.provideService` inside `effect`: the run option lands in\n * the fiber's root context, while a service provided within `effect` pops\n * before the `orDie`/`catch`/`result` wrappers this function adds. The fiber's\n * op counter survives context pops, so a cooperative yield can fire inside\n * those wrappers—only a root-context scheduler covers them.\n */\nexport const runHandlerPromise =\n  (\n    errorSchema: Schema.Codec<any, any> | undefined,\n    runOptions?: {\n      readonly scheduler?: EffectScheduler.Scheduler | undefined;\n    },\n  ) =>\n  <A, E>(effect: Effect.Effect<A, E>): Promise<A> => {\n    // A `ConvexError` defect escapes into the (escaped) failure channel so\n    // the `throw` below rethrows it with its identity intact.\n    const rethrowConvexErrorDefects = Effect.catchDefect(\n      (defect: unknown): Effect.Effect<never, ConvexError<any>> =>\n        defect instanceof ConvexError\n          ? Effect.fail(defect)\n          : Effect.die(defect),\n    );\n\n    const withConvexError =\n      errorSchema === undefined\n        ? Effect.orDie(effect)\n        : effect.pipe(\n            Effect.catch((typedError) =>\n              pipe(\n                Schema.encodeEffect(errorSchema)(typedError),\n                Effect.catchTag(\"SchemaError\", Effect.die),\n                Effect.andThen((encodedError) =>\n                  Effect.fail(new ConvexError(encodedError)),\n                ),\n              ),\n            ),\n          );\n    return Effect.runPromise(\n      Effect.result(rethrowConvexErrorDefects(withConvexError)).pipe(\n        Effect.provide(ConvexLogger.layer),\n        Effect.provideService(Console.Console, globalThis.console),\n      ),\n      runOptions,\n    ).then(\n      Result.match({\n        onFailure: (error) => {\n          throw error;\n        },\n        onSuccess: (value) => value,\n      }),\n    );\n  };\n\nexport const actionFunctionBase = <\n  Schema extends DatabaseSchema.AnyWithProps,\n  Args,\n  ConvexArgs extends DefaultFunctionArgs,\n  Returns,\n  ConvexReturns,\n  E,\n  R,\n>({\n  name,\n  functionVisibility,\n  args,\n  returns,\n  error,\n  handler,\n  resolvedMiddlewares = [],\n  createLayer,\n  scope = IdScope.app,\n}: {\n  name: string;\n  functionVisibility: FunctionVisibility;\n  args: Schema.Codec<Args, ConvexArgs>;\n  returns: Schema.Codec<Returns, ConvexReturns>;\n  error: Schema.Codec<Error, Value> | undefined;\n  handler: (a: Args) => Effect.Effect<Returns, E, R>;\n  resolvedMiddlewares?: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>;\n  createLayer: (\n    ctx: GenericActionCtx<DataModel.ToConvex<DataModel.FromSchema<Schema>>>,\n  ) => Layer.Layer<R>;\n  scope?: IdScope.IdScope;\n}) => ({\n  args: compileArgsSchema(args, scope),\n  returns: compileReturnsSchema(returns, scope),\n  handler: (\n    ctx: GenericActionCtx<DataModel.ToConvex<DataModel.FromSchema<Schema>>>,\n    actualArgs: ConvexArgs,\n  ): Promise<ConvexReturns> =>\n    Effect.gen(function* () {\n      const decodedArgs = yield* pipe(\n        actualArgs,\n        Schema.decodeUnknownEffect(args),\n        Effect.catchTag(\"SchemaError\", Effect.die),\n      );\n      const restricted = resolvedMiddlewares.some(\n        ({ middlewareSpec }) =>\n          middlewareSpec.key === ActionCallSpec.Middleware.key,\n      )\n        ? restrict(ctx)\n        : undefined;\n      // oxlint-disable-next-line effecttsgo/any-unknown-in-error-context -- Middleware errors are intentionally erased here and validated by runHandlerPromise against the combined error schema below.\n      const decodedReturns = yield* applyMiddleware(\n        handler(decodedArgs),\n        resolvedMiddlewares,\n        {\n          name,\n          functionType: \"action\",\n          functionVisibility,\n          args: decodedArgs,\n        },\n      ).pipe(Effect.provide(createLayer(restricted?.ctx ?? ctx)));\n      if (restricted !== undefined) yield* restricted.check;\n      return yield* pipe(\n        decodedReturns,\n        Schema.encodeEffect(returns),\n        Effect.catchTag(\"SchemaError\", Effect.die),\n      );\n    }).pipe(runHandlerPromise(combineErrorSchemas(error, resolvedMiddlewares))),\n});\n\nexport type ActionServices<\n  DatabaseSchema_ extends DatabaseSchema.AnyWithProps,\n> = Handler.ActionServices<DatabaseSchema_>;\n\n/**\n * The ctx-backed action services that don't depend on a Confect database\n * schema. {@link actionLayer} adds the schema-typed `VectorSearch` on top; the\n * HTTP API handler uses this base directly.\n */\nexport const baseActionLayer = <ConvexDataModel extends GenericDataModel>(\n  ctx: GenericActionCtx<ConvexDataModel>,\n) =>\n  Layer.mergeAll(\n    Scheduler.layer(ctx.scheduler),\n    Auth.layer(ctx.auth),\n    ExecutionMetadata.layer(ctx.meta),\n    RequestMetadata.layer(ctx.meta),\n    Storage.layer(ctx.storage),\n    StorageWriter.StorageWriter.layer(ctx.storage),\n    StorageActionWriter.StorageActionWriter.layer(ctx.storage),\n    QueryRunner.layer(ctx.runQuery.bind(ctx)),\n    MutationRunner.layer(ctx.runMutation.bind(ctx)),\n    ActionRunner.layer(ctx.runAction.bind(ctx)),\n    Layer.succeed(ActionCtx.ActionCtx<ConvexDataModel>(), ctx),\n  );\n\nexport const actionLayer = <\n  DatabaseSchema_ extends DatabaseSchema.AnyWithProps,\n>(\n  databaseSchema: DatabaseSchema_,\n  ctx: GenericActionCtx<\n    DataModel.ToConvex<DataModel.FromSchema<DatabaseSchema_>>\n  >,\n) =>\n  Layer.mergeAll(\n    Scheduler.layer<DatabaseSchema.Scope<DatabaseSchema_>>(\n      ctx.scheduler,\n      databaseSchema.target.scope,\n    ),\n    Auth.layerForTarget<DatabaseSchema_[\"target\"]>(\n      databaseSchema.target,\n      ctx.auth,\n    ),\n    ExecutionMetadata.layer(ctx.meta),\n    RequestMetadata.layer(ctx.meta),\n    storageLayer<DatabaseSchema.Scope<DatabaseSchema_>>(ctx.storage),\n    StorageWriter.StorageWriter.layer<DatabaseSchema.Scope<DatabaseSchema_>>(\n      ctx.storage,\n      databaseSchema.target.scope,\n    ),\n    StorageActionWriter.StorageActionWriter.layer<\n      DatabaseSchema.Scope<DatabaseSchema_>\n    >(ctx.storage, databaseSchema.target.scope),\n    QueryRunner.layer(ctx.runQuery.bind(ctx)),\n    MutationRunner.layer(ctx.runMutation.bind(ctx)),\n    ActionRunner.layer(ctx.runAction.bind(ctx)),\n    ActionCtx.layer<\n      DataModel.ToConvex<DataModel.FromSchema<DatabaseSchema_>>,\n      DatabaseSchema.Scope<DatabaseSchema_>\n    >(ctx, databaseSchema.target.scope),\n    VectorSearch.layer(ctx.vectorSearch.bind(ctx)),\n  );\n\n// Scoped readers share the same runtime service and ID strings. Reuse the\n// reader supplied by Storage so both APIs keep the same reader instance.\nexport const storageLayer = <Scope extends IdScope.IdScope>(\n  reader: ConvexStorageReader,\n): Layer.Layer<Storage.Storage | StorageReader.ForScope<Scope>> =>\n  Storage.layer(reader) as Layer.Layer<\n    Storage.Storage | StorageReader.ForScope<Scope>\n  >;\n\n/**\n * Shares one dispatch budget across the entire middleware chain.\n */\nconst restrict = <Model extends GenericDataModel>(\n  ctx: GenericActionCtx<Model>,\n) => {\n  let dispatched = false;\n  const claim = () => {\n    if (dispatched) throw new ActionCall.ActionCallAlreadyUsed();\n    dispatched = true;\n  };\n  const restricted: GenericActionCtx<Model> = {\n    ...ctx,\n    scheduler: {\n      runAfter: () => {\n        throw new ActionCall.SchedulingNotAllowed();\n      },\n      runAt: () => {\n        throw new ActionCall.SchedulingNotAllowed();\n      },\n      cancel: () => {\n        throw new ActionCall.SchedulingNotAllowed();\n      },\n    },\n    runQuery: (...args) => {\n      claim();\n      return ctx.runQuery(...args);\n    },\n    runMutation: (...args) => {\n      claim();\n      return ctx.runMutation(...args);\n    },\n    runAction: () => {\n      throw new ActionCall.NestedActionNotAllowed();\n    },\n  };\n  return {\n    ctx: restricted,\n    check: Effect.suspend(() =>\n      dispatched ? Effect.void : Effect.die(new ActionCall.ActionCallNotUsed()),\n    ),\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgJA,MAAa,mBACX,QACA,qBACA,eAC6B;CAC7B,OAAO,oBAAoB,aAExB,SAAS,eAAe;EACvB,MAAM,UACJ,aAAa,WAAW,iBACpB;GAAE,SAAS,WAAW;GAAS;EAAW,IAC1C,EAAE,WAAW;EAEnB,OAAO,WAAW,eAAe,SAAS,OAAO;CACnD,GACA,MACF;AACF;;;;;;;AAQA,MAAa,uBACX,OACA,wBACuC;CACvC,MAAM,UAAU,CACd,GAAI,UAAU,KAAA,IAAY,CAAC,KAAK,IAAI,CAAC,GACrC,GAAG,eAAe,aAChB,oBAAoB,KAAK,EAAE,qBAAqB,cAAc,CAChE,CACF;CACA,OAAO,QAAQ,WAAW,IACtB,KAAA,IACA,QAAQ,WAAW,IACjB,QAAQ,KACR,OAAO,MAAM,OAAO;AAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,qBAET,aACA,gBAIK,WAA4C;CAGjD,MAAM,4BAA4B,OAAO,aACtC,WACC,kBAAkB,cACd,OAAO,KAAK,MAAM,IAClB,OAAO,IAAI,MAAM,CACzB;CAEA,MAAM,kBACJ,gBAAgB,KAAA,IACZ,OAAO,MAAM,MAAM,IACnB,OAAO,KACL,OAAO,OAAO,eACZ,KACE,OAAO,aAAa,WAAW,CAAC,CAAC,UAAU,GAC3C,OAAO,SAAS,eAAe,OAAO,GAAG,GACzC,OAAO,SAAS,iBACd,OAAO,KAAK,IAAI,YAAY,YAAY,CAAC,CAC3C,CACF,CACF,CACF;CACN,OAAO,OAAO,WACZ,OAAO,OAAO,0BAA0B,eAAe,CAAC,CAAC,CAAC,KACxD,OAAO,QAAQA,OAAkB,GACjC,OAAO,eAAe,QAAQ,SAAS,WAAW,OAAO,CAC3D,GACA,UACF,CAAC,CAAC,KACA,OAAO,MAAM;EACX,YAAY,UAAU;GACpB,MAAM;EACR;EACA,YAAY,UAAU;CACxB,CAAC,CACH;AACF;AAEF,MAAa,sBAQX,EACA,MACA,oBACA,MACA,SACA,OACA,SACA,sBAAsB,CAAC,GACvB,aACA,QAAQ,QAAQ,WAaX;CACL,MAAM,kBAAkB,MAAM,KAAK;CACnC,SAAS,qBAAqB,SAAS,KAAK;CAC5C,UACE,KACA,eAEA,OAAO,IAAI,aAAa;EACtB,MAAM,cAAc,OAAO,KACzB,YACA,OAAO,oBAAoB,IAAI,GAC/B,OAAO,SAAS,eAAe,OAAO,GAAG,CAC3C;EACA,MAAM,aAAa,oBAAoB,MACpC,EAAE,qBACD,eAAe,QAAQ,eAAe,WAAW,GACrD,IACI,SAAS,GAAG,IACZ,KAAA;EAEJ,MAAM,iBAAiB,OAAO,gBAC5B,QAAQ,WAAW,GACnB,qBACA;GACE;GACA,cAAc;GACd;GACA,MAAM;EACR,CACF,CAAC,CAAC,KAAK,OAAO,QAAQ,YAAY,YAAY,OAAO,GAAG,CAAC,CAAC;EAC1D,IAAI,eAAe,KAAA,GAAW,OAAO,WAAW;EAChD,OAAO,OAAO,KACZ,gBACA,OAAO,aAAa,OAAO,GAC3B,OAAO,SAAS,eAAe,OAAO,GAAG,CAC3C;CACF,CAAC,CAAC,CAAC,KAAK,kBAAkB,oBAAoB,OAAO,mBAAmB,CAAC,CAAC;AAC9E;;;;;;AAWA,MAAa,mBACX,QAEA,MAAM,SACJC,QAAgB,IAAI,SAAS,GAC7BC,QAAW,IAAI,IAAI,GACnBC,QAAwB,IAAI,IAAI,GAChCC,QAAsB,IAAI,IAAI,GAC9BC,QAAc,IAAI,OAAO,GAAA,cACG,MAAM,IAAI,OAAO,GAAA,oBACL,MAAM,IAAI,OAAO,GACzDC,QAAkB,IAAI,SAAS,KAAK,GAAG,CAAC,GACxCC,QAAqB,IAAI,YAAY,KAAK,GAAG,CAAC,GAC9CC,QAAmB,IAAI,UAAU,KAAK,GAAG,CAAC,GAC1C,MAAM,QAAQC,UAAqC,GAAG,GAAG,CAC3D;AAEF,MAAa,eAGX,gBACA,QAIA,MAAM,SACJR,QACE,IAAI,WACJ,eAAe,OAAO,KACxB,GACAS,eACE,eAAe,QACf,IAAI,IACN,GACAP,QAAwB,IAAI,IAAI,GAChCC,QAAsB,IAAI,IAAI,GAC9B,aAAoD,IAAI,OAAO,GAAA,cACnC,MAC1B,IAAI,SACJ,eAAe,OAAO,KACxB,GAAA,oBACwC,MAEtC,IAAI,SAAS,eAAe,OAAO,KAAK,GAC1CE,QAAkB,IAAI,SAAS,KAAK,GAAG,CAAC,GACxCC,QAAqB,IAAI,YAAY,KAAK,GAAG,CAAC,GAC9CC,QAAmB,IAAI,UAAU,KAAK,GAAG,CAAC,GAC1CG,MAGE,KAAK,eAAe,OAAO,KAAK,GAClCC,SAAmB,IAAI,aAAa,KAAK,GAAG,CAAC,CAC/C;AAIF,MAAa,gBACX,WAEAP,QAAc,MAAM;;;;AAOtB,MAAM,YACJ,QACG;CACH,IAAI,aAAa;CACjB,MAAM,cAAc;EAClB,IAAI,YAAY,MAAM,IAAIQ,sBAAiC;EAC3D,aAAa;CACf;CA0BA,OAAO;EACL,KAAK;GAzBL,GAAG;GACH,WAAW;IACT,gBAAgB;KACd,MAAM,IAAIC,qBAAgC;IAC5C;IACA,aAAa;KACX,MAAM,IAAIA,qBAAgC;IAC5C;IACA,cAAc;KACZ,MAAM,IAAIA,qBAAgC;IAC5C;GACF;GACA,WAAW,GAAG,SAAS;IACrB,MAAM;IACN,OAAO,IAAI,SAAS,GAAG,IAAI;GAC7B;GACA,cAAc,GAAG,SAAS;IACxB,MAAM;IACN,OAAO,IAAI,YAAY,GAAG,IAAI;GAChC;GACA,iBAAiB;IACf,MAAM,IAAIC,uBAAkC;GAC9C;EAGc;EACd,OAAO,OAAO,cACZ,aAAa,OAAO,OAAO,OAAO,IAAI,IAAIC,kBAA6B,CAAC,CAC1E;CACF;AACF"}
+{"version":3,"file":"RegisteredFunction.js","names":["ConvexLogger.layer","ObservabilityRuntime.memoized","Scheduler.layer","Auth.layer","ExecutionMetadata.layer","RequestMetadata.layer","Storage.layer","QueryRunner.layer","MutationRunner.layer","ActionRunner.layer","ActionCtx.ActionCtx","Auth.layerForTarget","ActionCtx.layer","VectorSearch.layer","ActionCall.ActionCallAlreadyUsed","ActionCall.SchedulingNotAllowed","ActionCall.NestedActionNotAllowed","ActionCall.ActionCallNotUsed"],"sources":["../src/RegisteredFunction.ts"],"sourcesContent":["import * as ActionCallSpec from \"@confect/core/ActionCall\";\nimport * as ActionCall from \"./ActionCall.js\";\nimport type { FunctionSpec, RuntimeAndFunctionType } from \"@confect/core\";\nimport * as IdScope from \"@confect/core/IdScope\";\nimport type * as FunctionProvenance from \"@confect/core/FunctionProvenance\";\nimport * as MiddlewareSpec from \"@confect/core/MiddlewareSpec\";\nimport {\n  compileArgsSchema,\n  compileReturnsSchema,\n} from \"@confect/core/SchemaToValidator\";\nimport {\n  type DefaultFunctionArgs,\n  type FunctionVisibility,\n  type FunctionMetadata,\n  type GenericActionCtx,\n  type GenericDataModel,\n  type StorageReader as ConvexStorageReader,\n  type RegisteredAction,\n  type RegisteredMutation,\n  type RegisteredQuery,\n} from \"convex/server\";\nimport type { Value } from \"convex/values\";\nimport { ConvexError } from \"convex/values\";\nimport { pipe } from \"effect/Function\";\nimport * as Clock from \"effect/Clock\";\nimport * as Cause from \"effect/Cause\";\nimport * as Console from \"effect/Console\";\nimport * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Exit from \"effect/Exit\";\nimport * as Result from \"effect/Result\";\nimport * as Layer from \"effect/Layer\";\nimport * as Schema from \"effect/Schema\";\nimport type * as EffectScheduler from \"effect/Scheduler\";\nimport * as ActionCtx from \"./ActionCtx.js\";\nimport * as ActionRunner from \"./ActionRunner.js\";\nimport * as Auth from \"./Auth.js\";\nimport * as ConvexLogger from \"./ConvexLogger.js\";\nimport type * as DatabaseSchema from \"./DatabaseSchema.js\";\nimport type * as DataModel from \"./DataModel.js\";\nimport * as ExecutionMetadata from \"./ExecutionMetadata.js\";\nimport * as RequestMetadata from \"./RequestMetadata.js\";\nimport * as MutationRunner from \"./MutationRunner.js\";\nimport * as QueryRunner from \"./QueryRunner.js\";\nimport type * as ResolvedMiddleware from \"./ResolvedMiddleware.js\";\nimport * as Scheduler from \"./Scheduler.js\";\nimport * as Storage from \"./Storage.js\";\nimport * as StorageActionWriter from \"./StorageActionWriter.js\";\nimport type * as StorageReader from \"./StorageReader.js\";\nimport * as StorageWriter from \"./StorageWriter.js\";\nimport * as Tracer from \"effect/Tracer\";\nimport * as ObservabilityRuntime from \"./internal/observability.js\";\nimport * as VectorSearch from \"./VectorSearch.js\";\nimport type * as Handler from \"./Handler.js\";\n\nexport const Observability = Context.Reference<Layer.Layer<never> | undefined>(\n  \"@confect/server/Observability\",\n  { defaultValue: () => undefined },\n);\n\nexport type Any =\n  | RegisteredQuery<FunctionVisibility, DefaultFunctionArgs, any>\n  | RegisteredMutation<FunctionVisibility, DefaultFunctionArgs, any>\n  | RegisteredAction<FunctionVisibility, DefaultFunctionArgs, any>;\n\ntype ConfectRegisteredFunction<\n  FunctionSpec_ extends FunctionSpec.AnyWithProps,\n> =\n  FunctionSpec.EncodedArgs<FunctionSpec_> extends infer Args_ extends\n    DefaultFunctionArgs\n    ? RuntimeAndFunctionType.GetFunctionType<\n        FunctionSpec_[\"runtimeAndFunctionType\"]\n      > extends \"query\"\n      ? RegisteredQuery<\n          FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n          Args_,\n          Promise<FunctionSpec.EncodedReturns<FunctionSpec_>>\n        >\n      : RuntimeAndFunctionType.GetFunctionType<\n            FunctionSpec_[\"runtimeAndFunctionType\"]\n          > extends \"mutation\"\n        ? RegisteredMutation<\n            FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n            Args_,\n            Promise<FunctionSpec.EncodedReturns<FunctionSpec_>>\n          >\n        : RuntimeAndFunctionType.GetFunctionType<\n              FunctionSpec_[\"runtimeAndFunctionType\"]\n            > extends \"action\"\n          ? RegisteredAction<\n              FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n              Args_,\n              Promise<FunctionSpec.EncodedReturns<FunctionSpec_>>\n            >\n          : never\n    : never;\n\nexport type ConvexRegisteredFunction<\n  FunctionSpec_ extends FunctionSpec.AnyWithProps,\n> = FunctionSpec_ extends FunctionSpec.AnyWithProps\n  ? FunctionSpec.GetFunctionProvenance<FunctionSpec_> extends FunctionProvenance.Convex<\n      infer Args_ extends DefaultFunctionArgs,\n      infer Returns_\n    >\n    ? RuntimeAndFunctionType.GetFunctionType<\n        FunctionSpec_[\"runtimeAndFunctionType\"]\n      > extends \"query\"\n      ? RegisteredQuery<\n          FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n          Args_,\n          Returns_\n        >\n      : RuntimeAndFunctionType.GetFunctionType<\n            FunctionSpec_[\"runtimeAndFunctionType\"]\n          > extends \"mutation\"\n        ? RegisteredMutation<\n            FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n            Args_,\n            Returns_\n          >\n        : RuntimeAndFunctionType.GetFunctionType<\n              FunctionSpec_[\"runtimeAndFunctionType\"]\n            > extends \"action\"\n          ? RegisteredAction<\n              FunctionSpec.GetFunctionVisibility<FunctionSpec_>,\n              Args_,\n              Returns_\n            >\n          : never\n    : never\n  : never;\n\nexport type RegisteredFunction<\n  FunctionSpec_ extends FunctionSpec.AnyWithProps,\n> =\n  FunctionSpec_ extends FunctionSpec.WithFunctionProvenance<\n    FunctionSpec_,\n    FunctionProvenance.AnyConvex\n  >\n    ? ConvexRegisteredFunction<FunctionSpec_>\n    : FunctionSpec_ extends FunctionSpec.WithFunctionProvenance<\n          FunctionSpec_,\n          FunctionProvenance.AnyConfect\n        >\n      ? ConfectRegisteredFunction<FunctionSpec_>\n      : never;\n\n/**\n * Wrap a function's handler effect in its resolved middleware chain, per\n * invocation, after args decode. Iterated innermost-first so that the\n * first-attached (group-level, in attachment order) middleware ends up\n * outermost and runs first. Erased types: the public safety story lives at the\n * `MiddlewareSpec.MiddlewareImpl`/`MiddlewareImpl.make` signatures, and the\n * composed effect's error channel is re-accounted by\n * {@link combineErrorSchemas}.\n */\nexport const applyMiddleware = <A, E, R>(\n  effect: Effect.Effect<A, E, R>,\n  resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>,\n  invocation: MiddlewareSpec.MiddlewareOptions[\"invocation\"],\n): Effect.Effect<A, any, R> => {\n  return resolvedMiddlewares.reduceRight<Effect.Effect<any, any, any>>(\n    // oxlint-disable-next-line effecttsgo/any-unknown-in-error-context -- The erased middleware error remains intact so runHandlerPromise can validate it against the combined error schema.\n    (wrapped, middleware) => {\n      const context =\n        \"options\" in middleware.middlewareSpec\n          ? { options: middleware.options, invocation }\n          : { invocation };\n      // oxlint-disable-next-line effecttsgo/any-unknown-in-error-context -- Resolved middleware is type-erased after its public implementation boundary; its error and service channels are restored by the surrounding function contract.\n      return middleware.middlewareImpl(wrapped, context);\n    },\n    effect,\n  );\n};\n\n/**\n * The error-schema allowlist for a function with middleware: the function's own\n * declared `error` schema unioned with every covering middleware's error\n * schema. `undefined` (⇒ every failure dies) only when neither declares\n * one—mirroring the ref-side union clients decode against.\n */\nexport const combineErrorSchemas = (\n  error: Schema.Codec<any, any> | undefined,\n  resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>,\n): Schema.Codec<any, any> | undefined => {\n  const schemas = [\n    ...(error !== undefined ? [error] : []),\n    ...MiddlewareSpec.errorSchemas(\n      resolvedMiddlewares.map(({ middlewareSpec }) => middlewareSpec),\n    ),\n  ];\n  return schemas.length === 0\n    ? undefined\n    : schemas.length === 1\n      ? schemas[0]\n      : Schema.Union(schemas);\n};\n\n/**\n * Run the `Effect` as a `Promise`. Inspect the complete `Exit` before encoding\n * a declared error so a typed failure cannot hide a defect.\n *\n * Any `Die` reason takes the defect path. Without a `Die`, the first `Fail` in\n * cause order is schema-encoded and thrown as a `ConvexError` outside the\n * Effect runtime so Convex surfaces its data to the client. Other failures and\n * interruptions alongside that `Fail` are ignored. Without an error schema, the\n * selected failure is treated as a defect.\n *\n * A lone `ConvexError` defect or a selected undeclared `ConvexError` failure is\n * rethrown bare so it keeps Convex's meaning. Pagination and Workpool rely on\n * its data for their control signals. Other causes with a `Die`, interrupt-only\n * or empty causes, and error-encoding failures reject with a plain `Error`\n * whose message renders the complete cause and whose `cause` holds it for\n * server diagnostics.\n *\n * A `scheduler` in `runOptions` must be passed here as a run option rather than\n * provided via `Effect.provideService` inside `effect`: the run option lands in\n * the fiber's root context, while a service provided within `effect` pops\n * before the exit/encoding wrappers this function adds. The fiber's op counter\n * survives context pops, so a cooperative yield can fire inside those wrappers.\n * Only a root-context scheduler covers them.\n */\nexport const runHandlerPromise =\n  (\n    errorSchema: Schema.Codec<any, any> | undefined,\n    runOptions?: {\n      readonly scheduler?: EffectScheduler.Scheduler | undefined;\n      readonly clock?: Clock.Clock | undefined;\n      readonly invocation?: Effect.Effect<FunctionMetadata> | undefined;\n      readonly observability?: Layer.Layer<never> | undefined;\n    },\n  ) =>\n  <A, E>(effect: Effect.Effect<A, E>): Promise<A> => {\n    const { observability, invocation, clock } = runOptions ?? {};\n    let encodedError: Exit.Exit<any, any> | undefined;\n    const observed = Effect.tapCause(effect, (cause) =>\n      Effect.gen(function* () {\n        const reason =\n          cause.reasons.find(Cause.isDieReason) ??\n          cause.reasons.find(Cause.isFailReason);\n        if (reason?._tag === \"Fail\" && errorSchema !== undefined) {\n          encodedError = yield* Effect.exit(\n            Schema.encodeEffect(errorSchema)(reason.error),\n          );\n          if (Exit.isFailure(encodedError))\n            return yield* Effect.orDie(encodedError);\n        }\n      }),\n    );\n    const withConvexError: Effect.Effect<Result.Result<A, ConvexError<any>>> =\n      Effect.gen(function* () {\n        const exit = yield* Effect.exit(\n          observability === undefined || invocation === undefined\n            ? effect\n            : Effect.flatMap(invocation, ({ name, type, componentPath }) =>\n                Effect.useSpan(\n                  name,\n                  {\n                    root: true,\n                    attributes: { kind: type, componentPath },\n                  },\n                  (span) =>\n                    Effect.provideService(observed, Tracer.ParentSpan, span),\n                ),\n              ),\n        );\n        if (Exit.isSuccess(exit)) {\n          return Result.succeed(exit.value);\n        }\n\n        const cause =\n          encodedError !== undefined && Exit.isFailure(encodedError)\n            ? encodedError.cause\n            : exit.cause;\n        const reason =\n          cause.reasons.find(Cause.isDieReason) ??\n          cause.reasons.find(Cause.isFailReason);\n        if (\n          encodedError === undefined &&\n          reason?._tag === \"Die\" &&\n          cause.reasons.length === 1 &&\n          reason.defect instanceof ConvexError\n        ) {\n          return Result.fail(reason.defect);\n        }\n\n        if (reason?._tag === \"Fail\") {\n          if (errorSchema === undefined) {\n            if (reason.error instanceof ConvexError) {\n              return Result.fail(reason.error);\n            }\n            return yield* Effect.die(reason.error);\n          }\n          const encoded =\n            encodedError ??\n            (yield* Effect.exit(\n              Schema.encodeEffect(errorSchema)(reason.error),\n            ));\n          if (Exit.isSuccess(encoded)) {\n            return Result.fail(new ConvexError(encoded.value));\n          }\n          return yield* Effect.die(\n            new Error(Cause.pretty(encoded.cause), { cause: encoded.cause }),\n          );\n        }\n        return yield* Effect.die(new Error(Cause.pretty(cause), { cause }));\n      });\n    return Effect.runPromise(\n      withConvexError.pipe(\n        Effect.provide(\n          observability === undefined\n            ? ConvexLogger.layer\n            : ObservabilityRuntime.memoized(observability),\n        ),\n        Effect.provideService(Console.Console, globalThis.console),\n        clock === undefined\n          ? (self) => self\n          : Effect.provideService(Clock.Clock, clock),\n      ),\n      runOptions,\n    ).then(\n      Result.match({\n        onFailure: (error) => {\n          throw error;\n        },\n        onSuccess: (value) => value,\n      }),\n    );\n  };\n\nexport const actionFunctionBase = <\n  Schema extends DatabaseSchema.AnyWithProps,\n  Args,\n  ConvexArgs extends DefaultFunctionArgs,\n  Returns,\n  ConvexReturns,\n  E,\n  R,\n>({\n  name,\n  functionVisibility,\n  args,\n  returns,\n  error,\n  handler,\n  resolvedMiddlewares = [],\n  createLayer,\n  scope = IdScope.app,\n  observability,\n}: {\n  name: string;\n  functionVisibility: FunctionVisibility;\n  args: Schema.Codec<Args, ConvexArgs>;\n  returns: Schema.Codec<Returns, ConvexReturns>;\n  error: Schema.Codec<Error, Value> | undefined;\n  handler: (a: Args) => Effect.Effect<Returns, E, R>;\n  resolvedMiddlewares?: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>;\n  createLayer: (\n    ctx: GenericActionCtx<DataModel.ToConvex<DataModel.FromSchema<Schema>>>,\n  ) => Layer.Layer<R>;\n  scope?: IdScope.IdScope;\n  observability?: Layer.Layer<never> | undefined;\n}) => ({\n  args: compileArgsSchema(args, scope),\n  returns: compileReturnsSchema(returns, scope),\n  handler: (\n    ctx: GenericActionCtx<DataModel.ToConvex<DataModel.FromSchema<Schema>>>,\n    actualArgs: ConvexArgs,\n  ): Promise<ConvexReturns> =>\n    Effect.gen(function* () {\n      const decodedArgs = yield* pipe(\n        actualArgs,\n        Schema.decodeUnknownEffect(args),\n        Effect.catchTag(\"SchemaError\", Effect.die),\n      );\n      const restricted = resolvedMiddlewares.some(\n        ({ middlewareSpec }) =>\n          middlewareSpec.key === ActionCallSpec.Middleware.key,\n      )\n        ? restrict(ctx)\n        : undefined;\n      // oxlint-disable-next-line effecttsgo/any-unknown-in-error-context -- Middleware errors are intentionally erased here and validated by runHandlerPromise against the combined error schema below.\n      const decodedReturns = yield* applyMiddleware(\n        handler(decodedArgs),\n        resolvedMiddlewares,\n        {\n          name,\n          functionType: \"action\",\n          functionVisibility,\n          args: decodedArgs,\n        },\n      ).pipe(Effect.provide(createLayer(restricted?.ctx ?? ctx)));\n      if (restricted !== undefined) yield* restricted.check;\n      return yield* pipe(\n        decodedReturns,\n        Schema.encodeEffect(returns),\n        Effect.catchTag(\"SchemaError\", Effect.die),\n      );\n    }).pipe(\n      runHandlerPromise(combineErrorSchemas(error, resolvedMiddlewares), {\n        invocation: Effect.promise(() => ctx.meta.getFunctionMetadata()),\n        observability,\n      }),\n    ),\n});\n\nexport type ActionServices<\n  DatabaseSchema_ extends DatabaseSchema.AnyWithProps,\n> = Handler.ActionServices<DatabaseSchema_>;\n\n/**\n * The ctx-backed action services that don't depend on a Confect database\n * schema. {@link actionLayer} adds the schema-typed `VectorSearch` on top; the\n * HTTP API handler uses this base directly.\n */\nexport const baseActionLayer = <ConvexDataModel extends GenericDataModel>(\n  ctx: GenericActionCtx<ConvexDataModel>,\n) =>\n  Layer.mergeAll(\n    Scheduler.layer(ctx.scheduler),\n    Auth.layer(ctx.auth),\n    ExecutionMetadata.layer(ctx.meta),\n    RequestMetadata.layer(ctx.meta),\n    Storage.layer(ctx.storage),\n    StorageWriter.StorageWriter.layer(ctx.storage),\n    StorageActionWriter.StorageActionWriter.layer(ctx.storage),\n    QueryRunner.layer(ctx.runQuery.bind(ctx)),\n    MutationRunner.layer(ctx.runMutation.bind(ctx)),\n    ActionRunner.layer(ctx.runAction.bind(ctx)),\n    Layer.succeed(ActionCtx.ActionCtx<ConvexDataModel>(), ctx),\n  );\n\nexport const actionLayer = <\n  DatabaseSchema_ extends DatabaseSchema.AnyWithProps,\n>(\n  databaseSchema: DatabaseSchema_,\n  ctx: GenericActionCtx<\n    DataModel.ToConvex<DataModel.FromSchema<DatabaseSchema_>>\n  >,\n) =>\n  Layer.mergeAll(\n    Scheduler.layer<DatabaseSchema.Scope<DatabaseSchema_>>(\n      ctx.scheduler,\n      databaseSchema.target.scope,\n    ),\n    Auth.layerForTarget<DatabaseSchema_[\"target\"]>(\n      databaseSchema.target,\n      ctx.auth,\n    ),\n    ExecutionMetadata.layer(ctx.meta),\n    RequestMetadata.layer(ctx.meta),\n    storageLayer<DatabaseSchema.Scope<DatabaseSchema_>>(ctx.storage),\n    StorageWriter.StorageWriter.layer<DatabaseSchema.Scope<DatabaseSchema_>>(\n      ctx.storage,\n      databaseSchema.target.scope,\n    ),\n    StorageActionWriter.StorageActionWriter.layer<\n      DatabaseSchema.Scope<DatabaseSchema_>\n    >(ctx.storage, databaseSchema.target.scope),\n    QueryRunner.layer(ctx.runQuery.bind(ctx)),\n    MutationRunner.layer(ctx.runMutation.bind(ctx)),\n    ActionRunner.layer(ctx.runAction.bind(ctx)),\n    ActionCtx.layer<\n      DataModel.ToConvex<DataModel.FromSchema<DatabaseSchema_>>,\n      DatabaseSchema.Scope<DatabaseSchema_>\n    >(ctx, databaseSchema.target.scope),\n    VectorSearch.layer(ctx.vectorSearch.bind(ctx)),\n  );\n\n// Scoped readers share the same runtime service and ID strings. Reuse the\n// reader supplied by Storage so both APIs keep the same reader instance.\nexport const storageLayer = <Scope extends IdScope.IdScope>(\n  reader: ConvexStorageReader,\n): Layer.Layer<Storage.Storage | StorageReader.ForScope<Scope>> =>\n  Storage.layer(reader) as Layer.Layer<\n    Storage.Storage | StorageReader.ForScope<Scope>\n  >;\n\n/**\n * Shares one dispatch budget across the entire middleware chain.\n */\nconst restrict = <Model extends GenericDataModel>(\n  ctx: GenericActionCtx<Model>,\n) => {\n  let dispatched = false;\n  const claim = () => {\n    if (dispatched) throw new ActionCall.ActionCallAlreadyUsed();\n    dispatched = true;\n  };\n  const restricted: GenericActionCtx<Model> = {\n    ...ctx,\n    scheduler: {\n      runAfter: () => {\n        throw new ActionCall.SchedulingNotAllowed();\n      },\n      runAt: () => {\n        throw new ActionCall.SchedulingNotAllowed();\n      },\n      cancel: () => {\n        throw new ActionCall.SchedulingNotAllowed();\n      },\n    },\n    runQuery: (...args) => {\n      claim();\n      return ctx.runQuery(...args);\n    },\n    runMutation: (...args) => {\n      claim();\n      return ctx.runMutation(...args);\n    },\n    runAction: () => {\n      throw new ActionCall.NestedActionNotAllowed();\n    },\n  };\n  return {\n    ctx: restricted,\n    check: Effect.suspend(() =>\n      dispatched ? Effect.void : Effect.die(new ActionCall.ActionCallNotUsed()),\n    ),\n  };\n};\n"],"mappings":"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"}

package/dist/RegisteredNodeFunction.d.ts

@@ -7,5 +7,5 @@ import type * as GroupSpec from "@confect/core/GroupSpec";
 import type * as GroupImpl from "./GroupImpl.js";
 import type * as RegisteredFunctions from "./RegisteredFunctions.js";
 export declare const buildForGroup: <Group extends GroupSpec.AnyWithProps>(databaseSchema: DatabaseSchema.AnyWithProps, groupLayer: Layer.Layer<GroupImpl.GroupImpl<"Finalized">>) => RegisteredFunctions.RegisteredFunctionsForGroupSpec<Group>;
-export declare const make: (databaseSchema: DatabaseSchema.AnyWithProps, item: FunctionRegistryItem.ConfectFunctionRegistryItem, resolvedMiddlewares?: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>) => RegisteredFunction.Any;
+export declare const make: (databaseSchema: DatabaseSchema.AnyWithProps, item: FunctionRegistryItem.ConfectFunctionRegistryItem, resolvedMiddlewares?: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>, observability?: Layer.Layer<never>) => RegisteredFunction.Any;
 //# sourceMappingURL=RegisteredNodeFunction.d.ts.map

package/dist/RegisteredNodeFunction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RegisteredNodeFunction.d.ts","sourceRoot":"","sources":["../src/RegisteredNodeFunction.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,KAAK,cAAc,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,KAAK,SAAS,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,KAAK,mBAAmB,MAAM,0BAA0B,CAAC;AAGrE,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,SAAS,CAAC,YAAY,kBAChD,cAAc,CAAC,YAAY,cAC/B,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,KACxD,mBAAmB,CAAC,+BAA+B,CAAC,KAAK,CAqB3D,CAAC;AAEF,eAAO,MAAM,IAAI,mBACC,cAAc,CAAC,YAAY,QACrC,oBAAoB,CAAC,2BAA2B,wBACjC,aAAa,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,KACxE,kBAAkB,CAAC,GAkBrB,CAAC"}
+{"version":3,"file":"RegisteredNodeFunction.d.ts","sourceRoot":"","sources":["../src/RegisteredNodeFunction.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,KAAK,cAAc,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,KAAK,SAAS,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,KAAK,mBAAmB,MAAM,0BAA0B,CAAC;AAGrE,eAAO,MAAM,aAAa,GAAI,KAAK,SAAS,SAAS,CAAC,YAAY,kBAChD,cAAc,CAAC,YAAY,cAC/B,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,KACxD,mBAAmB,CAAC,+BAA+B,CAAC,KAAK,CAsB3D,CAAC;AAEF,eAAO,MAAM,IAAI,mBACC,cAAc,CAAC,YAAY,QACrC,oBAAoB,CAAC,2BAA2B,wBACjC,aAAa,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,kBACzD,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KACjC,kBAAkB,CAAC,GAmBrB,CAAC"}

package/dist/RegisteredNodeFunction.js

@@ -1,8 +1,8 @@
 import { __exportAll } from "./_virtual/_rolldown/runtime.js";
 import { mapLeaves } from "./internal/utils.js";
+import { actionFunctionBase, actionLayer } from "./RegisteredFunction.js";
 import { make as make$1 } from "./GroupRegistry.js";
 import { isFunctionRegistryItem } from "./FunctionRegistryItem.js";
-import { actionFunctionBase, actionLayer } from "./RegisteredFunction.js";
 import { resolve } from "./ResolvedMiddleware.js";
 import * as Layer from "effect/Layer";
 import { actionGeneric, internalActionGeneric } from "convex/server";
@@ -14,12 +14,13 @@ var RegisteredNodeFunction_exports = /* @__PURE__ */ __exportAll({
 	make: () => make
 });
 const buildForGroup = (databaseSchema, groupLayer) => {
-	const { functionRegistryItems, middlewareRegistryItems } = make$1(groupLayer);
-	return mapLeaves(functionRegistryItems, isFunctionRegistryItem, (item) => Match.value(item).pipe(Match.tag("Convex", ({ handler }) => handler), Match.tag("Confect", (confect) => make(databaseSchema, confect, resolve(confect, middlewareRegistryItems))), Match.exhaustive));
+	const { functionRegistryItems, middlewareRegistryItems, observability } = make$1(groupLayer);
+	return mapLeaves(functionRegistryItems, isFunctionRegistryItem, (item) => Match.value(item).pipe(Match.tag("Convex", ({ handler }) => handler), Match.tag("Confect", (confect) => make(databaseSchema, confect, resolve(confect, middlewareRegistryItems), observability)), Match.exhaustive));
 };
-const make = (databaseSchema, item, resolvedMiddlewares = []) => {
+const make = (databaseSchema, item, resolvedMiddlewares = [], observability) => {
 	return Match.value(item.functionVisibility).pipe(Match.when("public", () => actionGeneric), Match.when("internal", () => internalActionGeneric), Match.exhaustive)(nodeActionFunction(databaseSchema, {
 		name: item.name,
+		observability,
 		functionVisibility: item.functionVisibility,
 		args: item.args,
 		returns: item.returns,
@@ -28,7 +29,7 @@ const make = (databaseSchema, item, resolvedMiddlewares = []) => {
 		resolvedMiddlewares
 	}));
 };
-const nodeActionFunction = (databaseSchema, { name, functionVisibility, args, returns, error, handler, resolvedMiddlewares }) => actionFunctionBase({
+const nodeActionFunction = (databaseSchema, { name, functionVisibility, args, returns, error, handler, resolvedMiddlewares, observability }) => actionFunctionBase({
 	scope: databaseSchema.target.scope,
 	name,
 	functionVisibility,
@@ -37,6 +38,7 @@ const nodeActionFunction = (databaseSchema, { name, functionVisibility, args, re
 	error,
 	handler,
 	resolvedMiddlewares,
+	observability,
 	createLayer: (ctx) => Layer.mergeAll(actionLayer(databaseSchema, ctx), NodeServices.layer)
 });
 //#endregion

package/dist/RegisteredNodeFunction.js.map

@@ -1 +1 @@
-{"version":3,"file":"RegisteredNodeFunction.js","names":["GroupRegistry.make","FunctionRegistryItem.isFunctionRegistryItem","ResolvedMiddleware.resolve","RegisteredFunction.actionFunctionBase","RegisteredFunction.actionLayer"],"sources":["../src/RegisteredNodeFunction.ts"],"sourcesContent":["import * as NodeServices from \"@effect/platform-node/NodeServices\";\nimport {\n  actionGeneric,\n  type DefaultFunctionArgs,\n  type FunctionVisibility,\n  internalActionGeneric,\n} from \"convex/server\";\nimport type { Effect } from \"effect\";\nimport type { Schema } from \"effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Match from \"effect/Match\";\nimport type * as DatabaseSchema from \"./DatabaseSchema.js\";\nimport * as RegisteredFunction from \"./RegisteredFunction.js\";\nimport * as FunctionRegistryItem from \"./FunctionRegistryItem.js\";\nimport * as ResolvedMiddleware from \"./ResolvedMiddleware.js\";\nimport * as GroupRegistry from \"./GroupRegistry.js\";\nimport type * as GroupSpec from \"@confect/core/GroupSpec\";\nimport type * as GroupImpl from \"./GroupImpl.js\";\nimport type * as RegisteredFunctions from \"./RegisteredFunctions.js\";\nimport { mapLeaves } from \"./internal/utils.js\";\n\nexport const buildForGroup = <Group extends GroupSpec.AnyWithProps>(\n  databaseSchema: DatabaseSchema.AnyWithProps,\n  groupLayer: Layer.Layer<GroupImpl.GroupImpl<\"Finalized\">>,\n): RegisteredFunctions.RegisteredFunctionsForGroupSpec<Group> => {\n  const { functionRegistryItems, middlewareRegistryItems } =\n    GroupRegistry.make(groupLayer);\n  return mapLeaves<FunctionRegistryItem.AnyWithProps, RegisteredFunction.Any>(\n    functionRegistryItems as {\n      [key: string]: FunctionRegistryItem.AnyWithProps;\n    },\n    FunctionRegistryItem.isFunctionRegistryItem,\n    (item) =>\n      Match.value(item).pipe(\n        Match.tag(\"Convex\", ({ handler }) => handler),\n        Match.tag(\"Confect\", (confect) =>\n          make(\n            databaseSchema,\n            confect,\n            ResolvedMiddleware.resolve(confect, middlewareRegistryItems),\n          ),\n        ),\n        Match.exhaustive,\n      ),\n  ) as RegisteredFunctions.RegisteredFunctionsForGroupSpec<Group>;\n};\n\nexport const make = (\n  databaseSchema: DatabaseSchema.AnyWithProps,\n  item: FunctionRegistryItem.ConfectFunctionRegistryItem,\n  resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware> = [],\n): RegisteredFunction.Any => {\n  const genericFunction = Match.value(item.functionVisibility).pipe(\n    Match.when(\"public\", () => actionGeneric),\n    Match.when(\"internal\", () => internalActionGeneric),\n    Match.exhaustive,\n  );\n\n  return genericFunction(\n    nodeActionFunction(databaseSchema, {\n      name: item.name,\n      functionVisibility: item.functionVisibility,\n      args: item.args,\n      returns: item.returns,\n      error: item.error,\n      handler: item.handler,\n      resolvedMiddlewares,\n    }),\n  );\n};\n\nconst nodeActionFunction = <\n  DatabaseSchema_ extends DatabaseSchema.AnyWithProps,\n  Args,\n  ConvexArgs extends DefaultFunctionArgs,\n  Returns,\n  ConvexReturns,\n  E,\n>(\n  databaseSchema: DatabaseSchema_,\n  {\n    name,\n    functionVisibility,\n    args,\n    returns,\n    error,\n    handler,\n    resolvedMiddlewares,\n  }: {\n    name: string;\n    functionVisibility: FunctionVisibility;\n    args: Schema.Codec<Args, ConvexArgs>;\n    returns: Schema.Codec<Returns, ConvexReturns>;\n    error: Schema.Codec<any, any> | undefined;\n    handler: (\n      a: Args,\n    ) => Effect.Effect<\n      Returns,\n      E,\n      | RegisteredFunction.ActionServices<DatabaseSchema_>\n      | NodeServices.NodeServices\n    >;\n    resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>;\n  },\n) =>\n  RegisteredFunction.actionFunctionBase({\n    scope: databaseSchema.target.scope,\n    name,\n    functionVisibility,\n    args,\n    returns,\n    error,\n    handler,\n    resolvedMiddlewares,\n    createLayer: (ctx) =>\n      Layer.mergeAll(\n        RegisteredFunction.actionLayer(databaseSchema, ctx),\n        NodeServices.layer,\n      ),\n  });\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAa,iBACX,gBACA,eAC+D;CAC/D,MAAM,EAAE,uBAAuB,4BAC7BA,OAAmB,UAAU;CAC/B,OAAO,UACL,uBAGAC,yBACC,SACC,MAAM,MAAM,IAAI,CAAC,CAAC,KAChB,MAAM,IAAI,WAAW,EAAE,cAAc,OAAO,GAC5C,MAAM,IAAI,YAAY,YACpB,KACE,gBACA,SACAC,QAA2B,SAAS,uBAAuB,CAC7D,CACF,GACA,MAAM,UACR,CACJ;AACF;AAEA,MAAa,QACX,gBACA,MACA,sBAA4E,CAAC,MAClD;CAO3B,OANwB,MAAM,MAAM,KAAK,kBAAkB,CAAC,CAAC,KAC3D,MAAM,KAAK,gBAAgB,aAAa,GACxC,MAAM,KAAK,kBAAkB,qBAAqB,GAClD,MAAM,UAGa,CAAC,CACpB,mBAAmB,gBAAgB;EACjC,MAAM,KAAK;EACX,oBAAoB,KAAK;EACzB,MAAM,KAAK;EACX,SAAS,KAAK;EACd,OAAO,KAAK;EACZ,SAAS,KAAK;EACd;CACF,CAAC,CACH;AACF;AAEA,MAAM,sBAQJ,gBACA,EACE,MACA,oBACA,MACA,SACA,OACA,SACA,0BAkBFC,mBAAsC;CACpC,OAAO,eAAe,OAAO;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA,cAAc,QACZ,MAAM,SACJC,YAA+B,gBAAgB,GAAG,GAClD,aAAa,KACf;AACJ,CAAC"}
+{"version":3,"file":"RegisteredNodeFunction.js","names":["GroupRegistry.make","FunctionRegistryItem.isFunctionRegistryItem","ResolvedMiddleware.resolve","RegisteredFunction.actionFunctionBase","RegisteredFunction.actionLayer"],"sources":["../src/RegisteredNodeFunction.ts"],"sourcesContent":["import * as NodeServices from \"@effect/platform-node/NodeServices\";\nimport {\n  actionGeneric,\n  type DefaultFunctionArgs,\n  type FunctionVisibility,\n  internalActionGeneric,\n} from \"convex/server\";\nimport type { Effect } from \"effect\";\nimport type { Schema } from \"effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Match from \"effect/Match\";\nimport type * as DatabaseSchema from \"./DatabaseSchema.js\";\nimport * as RegisteredFunction from \"./RegisteredFunction.js\";\nimport * as FunctionRegistryItem from \"./FunctionRegistryItem.js\";\nimport * as ResolvedMiddleware from \"./ResolvedMiddleware.js\";\nimport * as GroupRegistry from \"./GroupRegistry.js\";\nimport type * as GroupSpec from \"@confect/core/GroupSpec\";\nimport type * as GroupImpl from \"./GroupImpl.js\";\nimport type * as RegisteredFunctions from \"./RegisteredFunctions.js\";\nimport { mapLeaves } from \"./internal/utils.js\";\n\nexport const buildForGroup = <Group extends GroupSpec.AnyWithProps>(\n  databaseSchema: DatabaseSchema.AnyWithProps,\n  groupLayer: Layer.Layer<GroupImpl.GroupImpl<\"Finalized\">>,\n): RegisteredFunctions.RegisteredFunctionsForGroupSpec<Group> => {\n  const { functionRegistryItems, middlewareRegistryItems, observability } =\n    GroupRegistry.make(groupLayer);\n  return mapLeaves<FunctionRegistryItem.AnyWithProps, RegisteredFunction.Any>(\n    functionRegistryItems as {\n      [key: string]: FunctionRegistryItem.AnyWithProps;\n    },\n    FunctionRegistryItem.isFunctionRegistryItem,\n    (item) =>\n      Match.value(item).pipe(\n        Match.tag(\"Convex\", ({ handler }) => handler),\n        Match.tag(\"Confect\", (confect) =>\n          make(\n            databaseSchema,\n            confect,\n            ResolvedMiddleware.resolve(confect, middlewareRegistryItems),\n            observability,\n          ),\n        ),\n        Match.exhaustive,\n      ),\n  ) as RegisteredFunctions.RegisteredFunctionsForGroupSpec<Group>;\n};\n\nexport const make = (\n  databaseSchema: DatabaseSchema.AnyWithProps,\n  item: FunctionRegistryItem.ConfectFunctionRegistryItem,\n  resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware> = [],\n  observability?: Layer.Layer<never>,\n): RegisteredFunction.Any => {\n  const genericFunction = Match.value(item.functionVisibility).pipe(\n    Match.when(\"public\", () => actionGeneric),\n    Match.when(\"internal\", () => internalActionGeneric),\n    Match.exhaustive,\n  );\n\n  return genericFunction(\n    nodeActionFunction(databaseSchema, {\n      name: item.name,\n      observability,\n      functionVisibility: item.functionVisibility,\n      args: item.args,\n      returns: item.returns,\n      error: item.error,\n      handler: item.handler,\n      resolvedMiddlewares,\n    }),\n  );\n};\n\nconst nodeActionFunction = <\n  DatabaseSchema_ extends DatabaseSchema.AnyWithProps,\n  Args,\n  ConvexArgs extends DefaultFunctionArgs,\n  Returns,\n  ConvexReturns,\n  E,\n>(\n  databaseSchema: DatabaseSchema_,\n  {\n    name,\n    functionVisibility,\n    args,\n    returns,\n    error,\n    handler,\n    resolvedMiddlewares,\n    observability,\n  }: {\n    name: string;\n    functionVisibility: FunctionVisibility;\n    args: Schema.Codec<Args, ConvexArgs>;\n    returns: Schema.Codec<Returns, ConvexReturns>;\n    error: Schema.Codec<any, any> | undefined;\n    handler: (\n      a: Args,\n    ) => Effect.Effect<\n      Returns,\n      E,\n      | RegisteredFunction.ActionServices<DatabaseSchema_>\n      | NodeServices.NodeServices\n    >;\n    resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>;\n    observability?: Layer.Layer<never> | undefined;\n  },\n) =>\n  RegisteredFunction.actionFunctionBase({\n    scope: databaseSchema.target.scope,\n    name,\n    functionVisibility,\n    args,\n    returns,\n    error,\n    handler,\n    resolvedMiddlewares,\n    observability,\n    createLayer: (ctx) =>\n      Layer.mergeAll(\n        RegisteredFunction.actionLayer(databaseSchema, ctx),\n        NodeServices.layer,\n      ),\n  });\n"],"mappings":";;;;;;;;;;;;;;;AAqBA,MAAa,iBACX,gBACA,eAC+D;CAC/D,MAAM,EAAE,uBAAuB,yBAAyB,kBACtDA,OAAmB,UAAU;CAC/B,OAAO,UACL,uBAGAC,yBACC,SACC,MAAM,MAAM,IAAI,CAAC,CAAC,KAChB,MAAM,IAAI,WAAW,EAAE,cAAc,OAAO,GAC5C,MAAM,IAAI,YAAY,YACpB,KACE,gBACA,SACAC,QAA2B,SAAS,uBAAuB,GAC3D,aACF,CACF,GACA,MAAM,UACR,CACJ;AACF;AAEA,MAAa,QACX,gBACA,MACA,sBAA4E,CAAC,GAC7E,kBAC2B;CAO3B,OANwB,MAAM,MAAM,KAAK,kBAAkB,CAAC,CAAC,KAC3D,MAAM,KAAK,gBAAgB,aAAa,GACxC,MAAM,KAAK,kBAAkB,qBAAqB,GAClD,MAAM,UAGa,CAAC,CACpB,mBAAmB,gBAAgB;EACjC,MAAM,KAAK;EACX;EACA,oBAAoB,KAAK;EACzB,MAAM,KAAK;EACX,SAAS,KAAK;EACd,OAAO,KAAK;EACZ,SAAS,KAAK;EACd;CACF,CAAC,CACH;AACF;AAEA,MAAM,sBAQJ,gBACA,EACE,MACA,oBACA,MACA,SACA,OACA,SACA,qBACA,oBAmBFC,mBAAsC;CACpC,OAAO,eAAe,OAAO;CAC7B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,cAAc,QACZ,MAAM,SACJC,YAA+B,gBAAgB,GAAG,GAClD,aAAa,KACf;AACJ,CAAC"}

package/dist/index.js

@@ -17,6 +17,15 @@ import { Auth_exports } from "./Auth.js";
 import { BlobNotFoundError_exports } from "./BlobNotFoundError.js";
 import { Callback_exports } from "./Callback.js";
 import { ConvexConfigProvider_exports } from "./ConvexConfigProvider.js";
+import { ConvexLogger_exports } from "./ConvexLogger.js";
+import { ExecutionMetadata_exports } from "./ExecutionMetadata.js";
+import { RequestMetadata_exports } from "./RequestMetadata.js";
+import { StorageActionWriter_exports } from "./StorageActionWriter.js";
+import { StorageReader_exports } from "./StorageReader.js";
+import { StorageWriter_exports } from "./StorageWriter.js";
+import { Storage_exports } from "./Storage.js";
+import { VectorSearch_exports } from "./VectorSearch.js";
+import { RegisteredFunction_exports } from "./RegisteredFunction.js";
 import { FunctionRegistryItem_exports } from "./FunctionRegistryItem.js";
 import { DatabaseSchema_exports } from "./DatabaseSchema.js";
 import { Document_exports } from "./Document.js";
@@ -34,18 +43,9 @@ import { QueryInitializer_exports } from "./QueryInitializer.js";
 import { Table_exports } from "./Table.js";
 import { DatabaseReader_exports } from "./DatabaseReader.js";
 import { DatabaseWriter_exports } from "./DatabaseWriter.js";
-import { ExecutionMetadata_exports } from "./ExecutionMetadata.js";
-import { RequestMetadata_exports } from "./RequestMetadata.js";
 import { TransactionMetadata_exports } from "./TransactionMetadata.js";
 import { MutationCtx_exports } from "./MutationCtx.js";
 import { QueryCtx_exports } from "./QueryCtx.js";
-import { ConvexLogger_exports } from "./ConvexLogger.js";
-import { StorageActionWriter_exports } from "./StorageActionWriter.js";
-import { StorageReader_exports } from "./StorageReader.js";
-import { StorageWriter_exports } from "./StorageWriter.js";
-import { Storage_exports } from "./Storage.js";
-import { VectorSearch_exports } from "./VectorSearch.js";
-import { RegisteredFunction_exports } from "./RegisteredFunction.js";
 import { RegisteredConvexFunction_exports } from "./RegisteredConvexFunction.js";
 import { ResolvedMiddleware_exports } from "./ResolvedMiddleware.js";
 import { ConvexFunctionDefinitions_exports } from "./ConvexFunctionDefinitions.js";

package/dist/internal/observability.d.ts

@@ -0,0 +1,5 @@
+import * as Layer from "effect/Layer";
+import * as Scope from "effect/Scope";
+export declare const scope: Scope.Closeable;
+export declare const memoized: (layer: Layer.Layer<never>) => Layer.Layer<never>;
+//# sourceMappingURL=observability.d.ts.map

package/dist/internal/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/internal/observability.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,eAAO,MAAM,KAAK,iBAAqB,CAAC;AAGxC,eAAO,MAAM,QAAQ,UAAW,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAerE,CAAC"}

package/dist/internal/observability.js

@@ -0,0 +1,21 @@
+import { layer } from "../ConvexConfigProvider.js";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Duration from "effect/Duration";
+import * as Exit from "effect/Exit";
+import * as Scope from "effect/Scope";
+//#region src/internal/observability.ts
+const memoMap = Layer.makeMemoMapUnsafe();
+const scope = Scope.makeUnsafe();
+const layers = /* @__PURE__ */ new WeakMap();
+const memoized = (layer$1) => {
+	const cached = layers.get(layer$1);
+	if (cached !== void 0) return cached;
+	const built = Layer.buildWithMemoMap(layer$1, memoMap, scope).pipe(Effect.provide(layer), Effect.cachedWithTTL((exit) => Exit.isSuccess(exit) ? Duration.infinity : Duration.zero), Effect.runSync, Effect.uninterruptible, Layer.effectContext);
+	layers.set(layer$1, built);
+	return built;
+};
+//#endregion
+export { memoized, scope };
+
+//# sourceMappingURL=observability.js.map

package/dist/internal/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","names":["layer","ConvexConfigProvider.layer"],"sources":["../../src/internal/observability.ts"],"sourcesContent":["import * as Duration from \"effect/Duration\";\nimport * as Effect from \"effect/Effect\";\nimport * as Exit from \"effect/Exit\";\nimport * as Layer from \"effect/Layer\";\nimport * as Scope from \"effect/Scope\";\nimport * as ConvexConfigProvider from \"../ConvexConfigProvider.js\";\n\nconst memoMap = Layer.makeMemoMapUnsafe();\nexport const scope = Scope.makeUnsafe();\nconst layers = new WeakMap<Layer.Layer<never>, Layer.Layer<never>>();\n\nexport const memoized = (layer: Layer.Layer<never>): Layer.Layer<never> => {\n  const cached = layers.get(layer);\n  if (cached !== undefined) return cached;\n  const built = Layer.buildWithMemoMap(layer, memoMap, scope).pipe(\n    Effect.provide(ConvexConfigProvider.layer),\n    // A failed first build is retried on the next invocation instead of failing every later one.\n    Effect.cachedWithTTL((exit) =>\n      Exit.isSuccess(exit) ? Duration.infinity : Duration.zero,\n    ),\n    Effect.runSync,\n    Effect.uninterruptible,\n    Layer.effectContext,\n  );\n  layers.set(layer, built);\n  return built;\n};\n"],"mappings":";;;;;;;AAOA,MAAM,UAAU,MAAM,kBAAkB;AACxC,MAAa,QAAQ,MAAM,WAAW;AACtC,MAAM,yBAAS,IAAI,QAAgD;AAEnE,MAAa,YAAY,YAAkD;CACzE,MAAM,SAAS,OAAO,IAAIA,OAAK;CAC/B,IAAI,WAAW,KAAA,GAAW,OAAO;CACjC,MAAM,QAAQ,MAAM,iBAAiBA,SAAO,SAAS,KAAK,CAAC,CAAC,KAC1D,OAAO,QAAQC,KAA0B,GAEzC,OAAO,eAAe,SACpB,KAAK,UAAU,IAAI,IAAI,SAAS,WAAW,SAAS,IACtD,GACA,OAAO,SACP,OAAO,iBACP,MAAM,aACR;CACA,OAAO,IAAID,SAAO,KAAK;CACvB,OAAO;AACT"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@gaganref/confect-server",
-  "version": "10.3.1-fork.36",
+  "version": "10.3.1-fork.39",
   "dependencies": {
     "@effect/ai-openai-compat": "4.0.4",
     "@effect/ai-openrouter": "4.0.4"
   },
   "peerDependencies": {
-    "@confect/core": "npm:@gaganref/confect-core@10.3.1-fork.36",
+    "@confect/core": "npm:@gaganref/confect-core@10.3.1-fork.39",
     "@effect/platform-node": ">=4.0.0 <4.1.0",
     "convex": "^1.48.0",
     "effect": ">=4.0.4 <4.1.0"

package/src/ConvexFunctionDefinitions.ts

@@ -63,7 +63,7 @@ export const buildForGroup = <Group extends GroupSpec.AnyWithProps>(
   databaseSchema: DatabaseSchema.AnyWithProps,
   groupLayer: Layer.Layer<GroupImpl.GroupImpl<"Finalized">>,
 ): ForGroup<Group> => {
-  const { functionRegistryItems, middlewareRegistryItems } =
+  const { functionRegistryItems, middlewareRegistryItems, observability } =
     GroupRegistry.make(groupLayer);
   return mapLeaves<
     FunctionRegistryItem.AnyWithProps,
@@ -83,6 +83,7 @@ export const buildForGroup = <Group extends GroupSpec.AnyWithProps>(
             databaseSchema,
             confect,
             ResolvedMiddleware.resolve(confect, middlewareRegistryItems),
+            observability,
           ),
         ),
         Match.exhaustive,

package/src/GroupRegistry.ts

@@ -1,3 +1,4 @@
+import * as RegisteredFunction from "./RegisteredFunction.js";
 import * as Effect from "effect/Effect";
 import type * as Layer from "effect/Layer";
 import * as Ref from "effect/Ref";
@@ -9,9 +10,12 @@ import * as MiddlewareRegistryItem from "./MiddlewareRegistryItem.js";
 export const make = (
   groupLayer: Layer.Layer<GroupImpl.GroupImpl<"Finalized">>,
 ) => {
-  const registryItems = Effect.gen(function* () {
+  const { registryItems, observability } = Effect.gen(function* () {
     const registry = yield* Registry.Registry;
-    return yield* Ref.get(registry);
+    return {
+      registryItems: yield* Ref.get(registry),
+      observability: yield* RegisteredFunction.Observability,
+    };
   }).pipe(
     Effect.provide(groupLayer),
     Effect.provideService(
@@ -21,7 +25,7 @@ export const make = (
     Effect.runSync,
   );
 
-  return partitionRegistryItems(registryItems);
+  return { ...partitionRegistryItems(registryItems), observability };
 };
 
 const partitionRegistryItems = (registryItems: RegistryItems.RegistryItems) => {

package/src/RegisteredConvexFunction.ts

@@ -61,12 +61,14 @@ export const prepare = (
   databaseSchema: DatabaseSchema.AnyWithProps,
   item: FunctionRegistryItem.ConfectFunctionRegistryItem,
   resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware> = [],
+  observability?: Layer.Layer<never>,
 ) =>
   Match.value(item.functionType).pipe(
     Match.when("query", () => {
       const definition = queryFunction({
         databaseSchema,
         name: item.name,
+        observability,
         functionVisibility: item.functionVisibility,
         args: item.args,
         returns: item.returns,
@@ -84,6 +86,7 @@ export const prepare = (
       const definition = mutationFunction({
         databaseSchema,
         name: item.name,
+        observability,
         functionVisibility: item.functionVisibility,
         args: item.args,
         returns: item.returns,
@@ -100,6 +103,7 @@ export const prepare = (
     Match.when("action", () => {
       const definition = convexActionFunction(databaseSchema, {
         name: item.name,
+        observability,
         functionVisibility: item.functionVisibility,
         args: item.args,
         returns: item.returns,
@@ -188,6 +192,7 @@ const queryFunction = <
   error,
   handler,
   resolvedMiddlewares,
+  observability,
 }: {
   databaseSchema: DatabaseSchema_;
   name: string;
@@ -199,6 +204,7 @@ const queryFunction = <
     a: Args,
   ) => Effect.Effect<Returns, E, Handler.QueryServices<DatabaseSchema_>>;
   resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>;
+  observability?: Layer.Layer<never> | undefined;
 }) => ({
   args: compileArgsSchema(args, databaseSchema.target.scope),
   returns: compileReturnsSchema(returns, databaseSchema.target.scope),
@@ -258,6 +264,9 @@ const queryFunction = <
         RegisteredFunction.combineErrorSchemas(error, resolvedMiddlewares),
         {
           scheduler: new EffectScheduler.MixedScheduler("sync"),
+          invocation: Effect.promise(() => ctx.meta.getFunctionMetadata()),
+          clock: observability === undefined ? undefined : queryClock,
+          observability,
         },
       ),
     ),
@@ -314,6 +323,7 @@ const mutationFunction = <
   error,
   handler,
   resolvedMiddlewares,
+  observability,
 }: {
   databaseSchema: DatabaseSchema_;
   name: string;
@@ -325,6 +335,7 @@ const mutationFunction = <
     a: Args,
   ) => Effect.Effect<Returns, E, MutationServices<DatabaseSchema_>>;
   resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>;
+  observability?: Layer.Layer<never> | undefined;
 }) => ({
   args: compileArgsSchema(args, databaseSchema.target.scope),
   returns: compileReturnsSchema(returns, databaseSchema.target.scope),
@@ -361,6 +372,8 @@ const mutationFunction = <
         RegisteredFunction.combineErrorSchemas(error, resolvedMiddlewares),
         {
           scheduler: new EffectScheduler.MixedScheduler("sync"),
+          invocation: Effect.promise(() => ctx.meta.getFunctionMetadata()),
+          observability,
         },
       ),
     ),
@@ -383,6 +396,7 @@ const convexActionFunction = <
     error,
     handler,
     resolvedMiddlewares,
+    observability,
   }: {
     name: string;
     functionVisibility: FunctionVisibility;
@@ -397,6 +411,7 @@ const convexActionFunction = <
       RegisteredFunction.ActionServices<DatabaseSchema_>
     >;
     resolvedMiddlewares: ReadonlyArray<ResolvedMiddleware.ResolvedMiddleware>;
+    observability?: Layer.Layer<never> | undefined;
   },
 ) =>
   RegisteredFunction.actionFunctionBase({
@@ -408,6 +423,7 @@ const convexActionFunction = <
     error,
     handler,
     resolvedMiddlewares,
+    observability,
     createLayer: (ctx) =>
       Layer.mergeAll(
         RegisteredFunction.actionLayer(schema, ctx),