@gaganref/confect-server 10.3.1-fork.42 → 10.3.1-fork.44

package/dist/RegisteredFunction.js

@@ -1,4 +1,5 @@
 import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { Forward } from "./internal/reservedArgument.js";
 import { ActionCtx, layer } from "./ActionCtx.js";
 import { layer as layer$1 } from "./ActionRunner.js";
 import { layer as layer$2 } from "./MutationRunner.js";
@@ -6,42 +7,63 @@ 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 "./ConvexLogger.js";
-import { layer as layer$7 } from "./ExecutionMetadata.js";
-import { layer as layer$8 } from "./RequestMetadata.js";
+import { layer as layer$6 } from "./ConvexConfigProvider.js";
+import { layer as layer$7 } from "./ConvexLogger.js";
+import { layer as layer$8 } from "./ExecutionMetadata.js";
+import { layer as layer$9 } from "./RequestMetadata.js";
 import { StorageActionWriter } from "./StorageActionWriter.js";
 import { StorageWriter } from "./StorageWriter.js";
-import { layer as layer$9 } from "./Storage.js";
+import { layer as layer$10 } 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 { layer as layer$11 } from "./VectorSearch.js";
+import { ConvexError } from "convex/values";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
+import * as Tracer from "effect/Tracer";
+import * as ActionCallSpec from "@confect/core/ActionCall";
 import * as Layer from "effect/Layer";
 import * as MiddlewareSpec from "@confect/core/MiddlewareSpec";
 import * as Schema from "effect/Schema";
 import { pipe } from "effect/Function";
+import * as Option from "effect/Option";
 import { compileArgsSchema, compileReturnsSchema } from "@confect/core/SchemaToValidator";
-import { ConvexError } from "convex/values";
 import * as Result from "effect/Result";
 import * as IdScope from "@confect/core/IdScope";
+import * as Config from "effect/Config";
 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({
+	Forward: () => Forward,
 	Observability: () => Observability,
+	Received: () => Received,
 	actionFunctionBase: () => actionFunctionBase,
 	actionLayer: () => actionLayer,
 	applyMiddleware: () => applyMiddleware,
 	baseActionLayer: () => baseActionLayer,
 	combineErrorSchemas: () => combineErrorSchemas,
 	domainArgs: () => domainArgs,
+	invocationMetadata: () => invocationMetadata,
 	runHandlerPromise: () => runHandlerPromise,
 	storageLayer: () => storageLayer
 });
+const Received = Context.Reference("@confect/server/RegisteredFunction/Received", { defaultValue: () => void 0 });
+const invocationMetadata = (meta, args, reservedArgument) => Effect.gen(function* () {
+	const metadata = yield* Effect.promise(() => meta.getFunctionMetadata());
+	if (reservedArgument === void 0) return metadata;
+	const { requestId } = yield* Effect.promise(() => meta.getRequestMetadata());
+	const deployment = yield* Config.String("CONVEX_CLOUD_URL").pipe(Config.option, Effect.map(Option.getOrUndefined), Effect.provide(layer$6), Effect.orDie);
+	return {
+		...metadata,
+		received: {
+			value: args[reservedArgument],
+			requestId,
+			deployment
+		}
+	};
+});
 const Observability = Context.Reference("@confect/server/Observability", { defaultValue: () => void 0 });
 /**
 * Wrap a function's handler effect in its resolved middleware chain, per
@@ -114,13 +136,13 @@ const runHandlerPromise = (errorSchema, runOptions) => (effect) => {
 		}
 	}));
 	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, {
+		const exit = yield* Effect.exit(observability === void 0 || invocation === void 0 ? effect : Effect.flatMap(invocation, ({ name, type, componentPath, received }) => Effect.useSpan(name, {
 			root: true,
 			attributes: {
 				kind: type,
 				componentPath
 			}
-		}, (span) => Effect.provideService(observed, Tracer.ParentSpan, span))));
+		}, (span) => Effect.provideService(observed, Tracer.ParentSpan, span)).pipe(Effect.provideService(Received, received))));
 		if (Exit.isSuccess(exit)) return Result.succeed(exit.value);
 		if (undeclared !== void 0) return yield* Effect.die(undeclared.error);
 		const cause = encodedError !== void 0 && Exit.isFailure(encodedError) ? encodedError.cause : exit.cause;
@@ -137,7 +159,7 @@ const runHandlerPromise = (errorSchema, runOptions) => (effect) => {
 		}
 		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({
+	return Effect.runPromise(withConvexError.pipe(Effect.provide(observability === void 0 ? layer$7 : 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;
 		},
@@ -160,7 +182,7 @@ const actionFunctionBase = ({ name, functionVisibility, args, returns, error, ha
 		if (restricted !== void 0) yield* restricted.check;
 		return yield* pipe(decodedReturns, Schema.encodeEffect(returns), Effect.catchTag("SchemaError", Effect.die));
 	}).pipe(runHandlerPromise(combineErrorSchemas(error, resolvedMiddlewares), {
-		invocation: Effect.promise(() => ctx.meta.getFunctionMetadata()),
+		invocation: invocationMetadata(ctx.meta, actualArgs, reservedArgument),
 		observability
 	}))
 });
@@ -169,9 +191,9 @@ const actionFunctionBase = ({ name, functionVisibility, args, returns, error, ha
 * 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$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);
+const baseActionLayer = (ctx) => Layer.mergeAll(layer$4(ctx.scheduler), layer$5(ctx.auth), layer$8(ctx.meta), layer$9(ctx.meta), layer$10(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$8(ctx.meta), layer$9(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$11(ctx.vectorSearch.bind(ctx)));
+const storageLayer = (reader) => layer$10(reader);
 /**
 * Shares one dispatch budget across the entire middleware chain.
 */
@@ -211,6 +233,6 @@ const restrict = (ctx) => {
 	};
 };
 //#endregion
-export { Observability, RegisteredFunction_exports, actionFunctionBase, actionLayer, applyMiddleware, baseActionLayer, combineErrorSchemas, domainArgs, runHandlerPromise, storageLayer };
+export { Forward, Observability, Received, RegisteredFunction_exports, actionFunctionBase, actionLayer, applyMiddleware, baseActionLayer, combineErrorSchemas, domainArgs, invocationMetadata, runHandlerPromise, storageLayer };
 
 //# sourceMappingURL=RegisteredFunction.js.map

package/dist/RegisteredFunction.js.map

@@ -1 +1 @@
-{"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    let undeclared: { readonly error: unknown } | 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          // An encoding failure is a defect, even when it dies with a ConvexError.\n          if (Exit.isFailure(encodedError)) {\n            const encoding = encodedError.cause;\n            return yield* Cause.squash(encoding) instanceof ConvexError\n              ? Effect.die(\n                  new Error(Cause.pretty(encoding), { cause: encoding }),\n                )\n              : Effect.orDie(encodedError);\n          }\n        }\n        // With no error schema a failure is a defect, so the root span ends as one.\n        if (\n          reason?._tag === \"Fail\" &&\n          errorSchema === undefined &&\n          !(reason.error instanceof ConvexError)\n        ) {\n          undeclared = { error: reason.error };\n          return yield* Effect.die(reason.error);\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        if (undeclared !== undefined)\n          return yield* Effect.die(undeclared.error);\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 domainArgs = (\n  args: DefaultFunctionArgs,\n  reservedArgument?: string,\n): DefaultFunctionArgs =>\n  reservedArgument === undefined\n    ? args\n    : Object.fromEntries(\n        Object.entries(args).filter(([key]) => key !== reservedArgument),\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  reservedArgument,\n}: {\n  name: string;\n  reservedArgument?: string | undefined;\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, reservedArgument, name),\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        domainArgs(actualArgs, reservedArgument),\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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"}
+{"version":3,"file":"RegisteredFunction.js","names":["ConvexConfigProvider.layer","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":["export { Forward } from \"./internal/reservedArgument.js\";\nimport * 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 MutationMeta,\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 Config from \"effect/Config\";\nimport * as Option from \"effect/Option\";\nimport * as ConvexConfigProvider from \"./ConvexConfigProvider.js\";\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 interface ReceivedValue {\n  readonly value: unknown;\n  readonly requestId: string;\n  readonly deployment: string | undefined;\n}\n\nexport const Received = Context.Reference<ReceivedValue | undefined>(\n  \"@confect/server/RegisteredFunction/Received\",\n  { defaultValue: () => undefined },\n);\n\nexport const invocationMetadata = (\n  meta: Pick<MutationMeta, \"getFunctionMetadata\" | \"getRequestMetadata\">,\n  args: DefaultFunctionArgs,\n  reservedArgument?: string,\n): Effect.Effect<FunctionMetadata & { readonly received?: ReceivedValue }> =>\n  Effect.gen(function* () {\n    const metadata = yield* Effect.promise(() => meta.getFunctionMetadata());\n    if (reservedArgument === undefined) return metadata;\n    const { requestId } = yield* Effect.promise(() =>\n      meta.getRequestMetadata(),\n    );\n    const deployment = yield* Config.String(\"CONVEX_CLOUD_URL\").pipe(\n      Config.option,\n      Effect.map(Option.getOrUndefined),\n      Effect.provide(ConvexConfigProvider.layer),\n      Effect.orDie,\n    );\n    return {\n      ...metadata,\n      received: { value: args[reservedArgument], requestId, deployment },\n    };\n  });\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?:\n        | Effect.Effect<\n            FunctionMetadata & { readonly received?: ReceivedValue }\n          >\n        | 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    let undeclared: { readonly error: unknown } | 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          // An encoding failure is a defect, even when it dies with a ConvexError.\n          if (Exit.isFailure(encodedError)) {\n            const encoding = encodedError.cause;\n            return yield* Cause.squash(encoding) instanceof ConvexError\n              ? Effect.die(\n                  new Error(Cause.pretty(encoding), { cause: encoding }),\n                )\n              : Effect.orDie(encodedError);\n          }\n        }\n        // With no error schema a failure is a defect, so the root span ends as one.\n        if (\n          reason?._tag === \"Fail\" &&\n          errorSchema === undefined &&\n          !(reason.error instanceof ConvexError)\n        ) {\n          undeclared = { error: reason.error };\n          return yield* Effect.die(reason.error);\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(\n                invocation,\n                ({ name, type, componentPath, received }) =>\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                  ).pipe(Effect.provideService(Received, received)),\n              ),\n        );\n        if (Exit.isSuccess(exit)) {\n          return Result.succeed(exit.value);\n        }\n        if (undeclared !== undefined)\n          return yield* Effect.die(undeclared.error);\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 domainArgs = (\n  args: DefaultFunctionArgs,\n  reservedArgument?: string,\n): DefaultFunctionArgs =>\n  reservedArgument === undefined\n    ? args\n    : Object.fromEntries(\n        Object.entries(args).filter(([key]) => key !== reservedArgument),\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  reservedArgument,\n}: {\n  name: string;\n  reservedArgument?: string | undefined;\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, reservedArgument, name),\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        domainArgs(actualArgs, reservedArgument),\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: invocationMetadata(ctx.meta, actualArgs, reservedArgument),\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/Scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../src/Scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAuCtC,eAAO,MAAM,SAAS;iBApCP,eAAe,CAAC,sBAAsB,CAAC;eAEzC,IAAI,SAAS,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS,SAC9C,QAAQ,CAAC,QAAQ,OACnB,IAAI,WACA,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC;YAazB,IAAI,SAAS,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS,YACxC,QAAQ,CAAC,QAAQ,OACtB,IAAI,WACA,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC;;;;;EAiBlC,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,UAAU,CAAC;AAEpD,MAAM,WAAW,OAAO,CAAC,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG;IAClE,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,sBAAsB,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1E,QAAQ,CAAC,IAAI,SAAS,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS,EACnD,KAAK,EAAE,QAAQ,CAAC,QAAQ,EACxB,GAAG,EAAE,IAAI,EACT,GAAG,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,GAC9B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,SAAS,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS,EAChD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,GAAG,EAAE,IAAI,EACT,GAAG,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,GAC9B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,MAAM,QAAQ,CAAC,KAAK,SAAS,OAAO,CAAC,OAAO,IAAI,KAAK,SAAS,OAAO,CAAC,GAAG,GAC3E,SAAS,GACT;IAAE,QAAQ,CAAC,kBAAkB,EAAE,KAAK,CAAA;CAAE,CAAC;AAE3C,eAAO,MAAM,QAAQ,GACnB,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,OACxC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CACN,CAAC;AAE/C,eAAO,MAAM,KAAK,GAAI,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,aACpD,eAAe,WACjB,KAAK,+CAMb,CAAC"}
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../src/Scheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,OAAO,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAmCtC,eAAO,MAAM,SAAS;iBAhCP,eAAe,CAAC,sBAAsB,CAAC;eAGlD,IAAI,SAAS,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS;YAc5C,IAAI,SAAS,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS;;;;;EAiB/C,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,UAAU,CAAC;AAEpD,MAAM,WAAW,OAAO,CAAC,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG;IAClE,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,sBAAsB,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1E,QAAQ,CAAC,IAAI,SAAS,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS,EACnD,KAAK,EAAE,QAAQ,CAAC,QAAQ,EACxB,GAAG,EAAE,IAAI,EACT,GAAG,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,GAC9B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,IAAI,SAAS,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,SAAS,EAChD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAC3B,GAAG,EAAE,IAAI,EACT,GAAG,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,GAC9B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC,CAAC;CAC5D;AAED,MAAM,MAAM,QAAQ,CAAC,KAAK,SAAS,OAAO,CAAC,OAAO,IAAI,KAAK,SAAS,OAAO,CAAC,GAAG,GAC3E,SAAS,GACT;IAAE,QAAQ,CAAC,kBAAkB,EAAE,KAAK,CAAA;CAAE,CAAC;AAE3C,eAAO,MAAM,QAAQ,GACnB,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,OACxC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CACN,CAAC;AAE/C,eAAO,MAAM,KAAK,GAAI,KAAK,SAAS,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,aACpD,eAAe,WACjB,KAAK,+CAMb,CAAC"}

package/dist/Scheduler.js

@@ -1,4 +1,5 @@
 import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { encodeArgs } from "./internal/reservedArgument.js";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
@@ -13,18 +14,18 @@ var Scheduler_exports = /* @__PURE__ */ __exportAll({
 });
 const make = (scheduler) => ({
 	cancel: (id) => Effect.promise(() => scheduler.cancel(id)),
-	runAfter: (delay, ref, ...args) => {
+	runAfter: Effect.fn("Scheduler.runAfter")(function* (delay, ref, ...args) {
 		const delayMs = Duration.toMillis(delay);
 		const functionReference = Ref.getFunctionReference(ref);
-		const encodedArgs = Ref.encodeArgsSync(ref, args[0] ?? {});
-		return Effect.promise(() => scheduler.runAfter(delayMs, functionReference, encodedArgs));
-	},
-	runAt: (dateTime, ref, ...args) => {
+		const encodedArgs = yield* encodeArgs(ref, args[0] ?? {});
+		return yield* Effect.promise(() => scheduler.runAfter(delayMs, functionReference, encodedArgs));
+	}),
+	runAt: Effect.fn("Scheduler.runAt")(function* (dateTime, ref, ...args) {
 		const timestamp = DateTime.toEpochMillis(dateTime);
 		const functionReference = Ref.getFunctionReference(ref);
-		const encodedArgs = Ref.encodeArgsSync(ref, args[0] ?? {});
-		return Effect.promise(() => scheduler.runAt(timestamp, functionReference, encodedArgs));
-	}
+		const encodedArgs = yield* encodeArgs(ref, args[0] ?? {});
+		return yield* Effect.promise(() => scheduler.runAt(timestamp, functionReference, encodedArgs));
+	})
 });
 const Scheduler = Context.Service("@confect/server/Scheduler");
 const forScope = () => Context.Service("@confect/server/Scheduler");

package/dist/Scheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"Scheduler.js","names":[],"sources":["../src/Scheduler.ts"],"sourcesContent":["import type * as IdScope from \"@confect/core/IdScope\";\nimport { Ref } from \"@confect/core\";\nimport type { GenericId } from \"@confect/core/GenericId\";\nimport type { Scheduler as ConvexScheduler } from \"convex/server\";\nimport type { GenericId as ConvexGenericId } from \"convex/values\";\nimport * as Context from \"effect/Context\";\nimport * as DateTime from \"effect/DateTime\";\nimport * as Duration from \"effect/Duration\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\n\nconst make = (scheduler: ConvexScheduler) => ({\n  cancel: (id: ConvexGenericId<\"_scheduled_functions\">) =>\n    Effect.promise(() => scheduler.cancel(id)),\n  runAfter: <Ref_ extends Ref.AnyMutation | Ref.AnyAction>(\n    delay: Duration.Duration,\n    ref: Ref_,\n    ...args: Ref.OptionalArgs<Ref_>\n  ) => {\n    const delayMs = Duration.toMillis(delay);\n    const functionReference = Ref.getFunctionReference(ref);\n    const encodedArgs = Ref.encodeArgsSync(\n      ref,\n      (args[0] ?? {}) as Ref.Args<Ref_>,\n    );\n\n    return Effect.promise(() =>\n      scheduler.runAfter(delayMs, functionReference, encodedArgs),\n    );\n  },\n  runAt: <Ref_ extends Ref.AnyMutation | Ref.AnyAction>(\n    dateTime: DateTime.DateTime,\n    ref: Ref_,\n    ...args: Ref.OptionalArgs<Ref_>\n  ) => {\n    const timestamp = DateTime.toEpochMillis(dateTime);\n    const functionReference = Ref.getFunctionReference(ref);\n    const encodedArgs = Ref.encodeArgsSync(\n      ref,\n      (args[0] ?? {}) as Ref.Args<Ref_>,\n    );\n\n    return Effect.promise(() =>\n      scheduler.runAt(timestamp, functionReference, encodedArgs),\n    );\n  },\n});\n\nexport const Scheduler = Context.Service<ReturnType<typeof make>>(\n  \"@confect/server/Scheduler\",\n);\nexport type Scheduler = typeof Scheduler.Identifier;\n\nexport interface Service<Scope extends IdScope.IdScope = IdScope.App> {\n  cancel(id: GenericId<\"_scheduled_functions\", Scope>): Effect.Effect<void>;\n  runAfter<Ref_ extends Ref.AnyMutation | Ref.AnyAction>(\n    delay: Duration.Duration,\n    ref: Ref_,\n    ...args: Ref.OptionalArgs<Ref_>\n  ): Effect.Effect<GenericId<\"_scheduled_functions\", Scope>>;\n  runAt<Ref_ extends Ref.AnyMutation | Ref.AnyAction>(\n    dateTime: DateTime.DateTime,\n    ref: Ref_,\n    ...args: Ref.OptionalArgs<Ref_>\n  ): Effect.Effect<GenericId<\"_scheduled_functions\", Scope>>;\n}\n\nexport type ForScope<Scope extends IdScope.IdScope> = Scope extends IdScope.App\n  ? Scheduler\n  : { readonly \"~ScopedScheduler\": Scope };\n\nexport const forScope = <\n  Scope extends IdScope.IdScope = IdScope.App,\n>(): Context.Service<ForScope<Scope>, Service<Scope>> =>\n  Context.Service(\"@confect/server/Scheduler\");\n\nexport const layer = <Scope extends IdScope.IdScope = IdScope.App>(\n  scheduler: ConvexScheduler,\n  _scope?: Scope,\n) =>\n  // Scopes are phantom: Convex still receives and returns the same ID strings.\n  Layer.succeed(\n    forScope<Scope>(),\n    make(scheduler) as unknown as Service<Scope>,\n  );\n"],"mappings":";;;;;;;;;;;;;AAWA,MAAM,QAAQ,eAAgC;CAC5C,SAAS,OACP,OAAO,cAAc,UAAU,OAAO,EAAE,CAAC;CAC3C,WACE,OACA,KACA,GAAG,SACA;EACH,MAAM,UAAU,SAAS,SAAS,KAAK;EACvC,MAAM,oBAAoB,IAAI,qBAAqB,GAAG;EACtD,MAAM,cAAc,IAAI,eACtB,KACC,KAAK,MAAM,CAAC,CACf;EAEA,OAAO,OAAO,cACZ,UAAU,SAAS,SAAS,mBAAmB,WAAW,CAC5D;CACF;CACA,QACE,UACA,KACA,GAAG,SACA;EACH,MAAM,YAAY,SAAS,cAAc,QAAQ;EACjD,MAAM,oBAAoB,IAAI,qBAAqB,GAAG;EACtD,MAAM,cAAc,IAAI,eACtB,KACC,KAAK,MAAM,CAAC,CACf;EAEA,OAAO,OAAO,cACZ,UAAU,MAAM,WAAW,mBAAmB,WAAW,CAC3D;CACF;AACF;AAEA,MAAa,YAAY,QAAQ,QAC/B,2BACF;AAqBA,MAAa,iBAGX,QAAQ,QAAQ,2BAA2B;AAE7C,MAAa,SACX,WACA,WAGA,MAAM,QACJ,SAAgB,GAChB,KAAK,SAAS,CAChB"}
+{"version":3,"file":"Scheduler.js","names":["ReservedArgument.encodeArgs"],"sources":["../src/Scheduler.ts"],"sourcesContent":["import * as ReservedArgument from \"./internal/reservedArgument.js\";\nimport type * as IdScope from \"@confect/core/IdScope\";\nimport { Ref } from \"@confect/core\";\nimport type { GenericId } from \"@confect/core/GenericId\";\nimport type { Scheduler as ConvexScheduler } from \"convex/server\";\nimport type { GenericId as ConvexGenericId } from \"convex/values\";\nimport * as Context from \"effect/Context\";\nimport * as DateTime from \"effect/DateTime\";\nimport * as Duration from \"effect/Duration\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\n\nconst make = (scheduler: ConvexScheduler) => ({\n  cancel: (id: ConvexGenericId<\"_scheduled_functions\">) =>\n    Effect.promise(() => scheduler.cancel(id)),\n  runAfter: Effect.fn(\"Scheduler.runAfter\")(function* <\n    Ref_ extends Ref.AnyMutation | Ref.AnyAction,\n  >(delay: Duration.Duration, ref: Ref_, ...args: Ref.OptionalArgs<Ref_>) {\n    const delayMs = Duration.toMillis(delay);\n    const functionReference = Ref.getFunctionReference(ref);\n    const encodedArgs = yield* ReservedArgument.encodeArgs(\n      ref,\n      (args[0] ?? {}) as Ref.Args<Ref_>,\n    );\n\n    return yield* Effect.promise(() =>\n      scheduler.runAfter(delayMs, functionReference, encodedArgs),\n    );\n  }),\n  runAt: Effect.fn(\"Scheduler.runAt\")(function* <\n    Ref_ extends Ref.AnyMutation | Ref.AnyAction,\n  >(dateTime: DateTime.DateTime, ref: Ref_, ...args: Ref.OptionalArgs<Ref_>) {\n    const timestamp = DateTime.toEpochMillis(dateTime);\n    const functionReference = Ref.getFunctionReference(ref);\n    const encodedArgs = yield* ReservedArgument.encodeArgs(\n      ref,\n      (args[0] ?? {}) as Ref.Args<Ref_>,\n    );\n\n    return yield* Effect.promise(() =>\n      scheduler.runAt(timestamp, functionReference, encodedArgs),\n    );\n  }),\n});\n\nexport const Scheduler = Context.Service<ReturnType<typeof make>>(\n  \"@confect/server/Scheduler\",\n);\nexport type Scheduler = typeof Scheduler.Identifier;\n\nexport interface Service<Scope extends IdScope.IdScope = IdScope.App> {\n  cancel(id: GenericId<\"_scheduled_functions\", Scope>): Effect.Effect<void>;\n  runAfter<Ref_ extends Ref.AnyMutation | Ref.AnyAction>(\n    delay: Duration.Duration,\n    ref: Ref_,\n    ...args: Ref.OptionalArgs<Ref_>\n  ): Effect.Effect<GenericId<\"_scheduled_functions\", Scope>>;\n  runAt<Ref_ extends Ref.AnyMutation | Ref.AnyAction>(\n    dateTime: DateTime.DateTime,\n    ref: Ref_,\n    ...args: Ref.OptionalArgs<Ref_>\n  ): Effect.Effect<GenericId<\"_scheduled_functions\", Scope>>;\n}\n\nexport type ForScope<Scope extends IdScope.IdScope> = Scope extends IdScope.App\n  ? Scheduler\n  : { readonly \"~ScopedScheduler\": Scope };\n\nexport const forScope = <\n  Scope extends IdScope.IdScope = IdScope.App,\n>(): Context.Service<ForScope<Scope>, Service<Scope>> =>\n  Context.Service(\"@confect/server/Scheduler\");\n\nexport const layer = <Scope extends IdScope.IdScope = IdScope.App>(\n  scheduler: ConvexScheduler,\n  _scope?: Scope,\n) =>\n  // Scopes are phantom: Convex still receives and returns the same ID strings.\n  Layer.succeed(\n    forScope<Scope>(),\n    make(scheduler) as unknown as Service<Scope>,\n  );\n"],"mappings":";;;;;;;;;;;;;;AAYA,MAAM,QAAQ,eAAgC;CAC5C,SAAS,OACP,OAAO,cAAc,UAAU,OAAO,EAAE,CAAC;CAC3C,UAAU,OAAO,GAAG,oBAAoB,CAAC,CAAC,WAExC,OAA0B,KAAW,GAAG,MAA8B;EACtE,MAAM,UAAU,SAAS,SAAS,KAAK;EACvC,MAAM,oBAAoB,IAAI,qBAAqB,GAAG;EACtD,MAAM,cAAc,OAAOA,WACzB,KACC,KAAK,MAAM,CAAC,CACf;EAEA,OAAO,OAAO,OAAO,cACnB,UAAU,SAAS,SAAS,mBAAmB,WAAW,CAC5D;CACF,CAAC;CACD,OAAO,OAAO,GAAG,iBAAiB,CAAC,CAAC,WAElC,UAA6B,KAAW,GAAG,MAA8B;EACzE,MAAM,YAAY,SAAS,cAAc,QAAQ;EACjD,MAAM,oBAAoB,IAAI,qBAAqB,GAAG;EACtD,MAAM,cAAc,OAAOA,WACzB,KACC,KAAK,MAAM,CAAC,CACf;EAEA,OAAO,OAAO,OAAO,cACnB,UAAU,MAAM,WAAW,mBAAmB,WAAW,CAC3D;CACF,CAAC;AACH;AAEA,MAAa,YAAY,QAAQ,QAC/B,2BACF;AAqBA,MAAa,iBAGX,QAAQ,QAAQ,2BAA2B;AAE7C,MAAa,SACX,WACA,WAGA,MAAM,QACJ,SAAgB,GAChB,KAAK,SAAS,CAChB"}

package/dist/internal/reservedArgument.d.ts

@@ -0,0 +1,8 @@
+import * as Ref from "@confect/core/Ref";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Tracer from "effect/Tracer";
+export declare const Forward: Context.Reference<((span: Tracer.Span) => unknown) | undefined>;
+export declare const runWithCodec: <Ref_ extends Ref.Any>(ref: Ref_, args: Ref.Args<Ref_>, call: (native: Ref.FunctionReference<Ref_>, encoded: unknown) => PromiseLike<unknown>) => Effect.Effect<Ref.Returns<Ref_>, import("effect/Schema").SchemaError | Ref.Error<Ref_>, never>;
+export declare const encodeArgs: <Ref_ extends Ref.Any>(ref: Ref_, args: Ref.Args<Ref_>) => Effect.Effect<unknown, never, never>;
+//# sourceMappingURL=reservedArgument.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reservedArgument.d.ts","sourceRoot":"","sources":["../../src/internal/reservedArgument.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,mBAAmB,CAAC;AACzC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,OAAO,4BACV,MAAM,CAAC,IAAI,KAAK,OAAO,cAG/B,CAAC;AAyBH,eAAO,MAAM,YAAY,GAAI,IAAI,SAAS,GAAG,CAAC,GAAG,OAC1C,IAAI,QACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QACd,CACJ,MAAM,EAAE,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,EACnC,OAAO,EAAE,OAAO,KACb,WAAW,CAAC,OAAO,CAAC,mGAMxB,CAAC;AAEJ,eAAO,MAAM,UAAU,GAAI,IAAI,SAAS,GAAG,CAAC,GAAG,OACxC,IAAI,QACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,yCAInB,CAAC"}

package/dist/internal/reservedArgument.js

@@ -0,0 +1,30 @@
+import { convexToJson } from "convex/values";
+import * as Ref from "@confect/core/Ref";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Tracer from "effect/Tracer";
+//#region src/internal/reservedArgument.ts
+const Forward = Context.Reference("@confect/server/RegisteredFunction/Forward", { defaultValue: () => void 0 });
+const inject = (ref, encoded, context) => {
+	if (ref.reservedArgument === void 0 || ref.functionType === "query") return encoded;
+	const forward = Context.get(context, Forward);
+	const span = Context.getOrUndefined(context, Tracer.ParentSpan);
+	if (forward === void 0 || span?._tag !== "Span") return encoded;
+	try {
+		const value = forward(span);
+		if (value === void 0) return encoded;
+		convexToJson(value);
+		return {
+			...encoded,
+			[ref.reservedArgument]: value
+		};
+	} catch {
+		return encoded;
+	}
+};
+const runWithCodec = (ref, args, call) => Effect.withFiber((fiber) => Ref.runWithCodec(ref, args, (native, encoded) => call(native, inject(ref, encoded, fiber.context))));
+const encodeArgs = (ref, args) => Effect.withFiberSucceed((fiber) => inject(ref, Ref.encodeArgsSync(ref, args), fiber.context));
+//#endregion
+export { Forward, encodeArgs, runWithCodec };
+
+//# sourceMappingURL=reservedArgument.js.map

package/dist/internal/reservedArgument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reservedArgument.js","names":[],"sources":["../../src/internal/reservedArgument.ts"],"sourcesContent":["import { convexToJson, type Value } from \"convex/values\";\nimport * as Ref from \"@confect/core/Ref\";\nimport * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Tracer from \"effect/Tracer\";\n\nexport const Forward = Context.Reference<\n  ((span: Tracer.Span) => unknown) | undefined\n>(\"@confect/server/RegisteredFunction/Forward\", {\n  defaultValue: () => undefined,\n});\n\nconst inject = (\n  ref: Ref.Any,\n  encoded: unknown,\n  context: Context.Context<never>,\n): unknown => {\n  if (ref.reservedArgument === undefined || ref.functionType === \"query\")\n    return encoded;\n  const forward = Context.get(context, Forward);\n  const span = Context.getOrUndefined(context, Tracer.ParentSpan);\n  if (forward === undefined || span?._tag !== \"Span\") return encoded;\n  try {\n    const value = forward(span);\n    if (value === undefined) return encoded;\n    convexToJson(value as Value);\n    return {\n      ...(encoded as Record<string, unknown>),\n      [ref.reservedArgument]: value,\n    };\n  } catch {\n    return encoded;\n  }\n};\n\nexport const runWithCodec = <Ref_ extends Ref.Any>(\n  ref: Ref_,\n  args: Ref.Args<Ref_>,\n  call: (\n    native: Ref.FunctionReference<Ref_>,\n    encoded: unknown,\n  ) => PromiseLike<unknown>,\n) =>\n  Effect.withFiber((fiber) =>\n    Ref.runWithCodec(ref, args, (native, encoded) =>\n      call(native, inject(ref, encoded, fiber.context)),\n    ),\n  );\n\nexport const encodeArgs = <Ref_ extends Ref.Any>(\n  ref: Ref_,\n  args: Ref.Args<Ref_>,\n) =>\n  Effect.withFiberSucceed((fiber) =>\n    inject(ref, Ref.encodeArgsSync(ref, args), fiber.context),\n  );\n"],"mappings":";;;;;;AAMA,MAAa,UAAU,QAAQ,UAE7B,8CAA8C,EAC9C,oBAAoB,KAAA,EACtB,CAAC;AAED,MAAM,UACJ,KACA,SACA,YACY;CACZ,IAAI,IAAI,qBAAqB,KAAA,KAAa,IAAI,iBAAiB,SAC7D,OAAO;CACT,MAAM,UAAU,QAAQ,IAAI,SAAS,OAAO;CAC5C,MAAM,OAAO,QAAQ,eAAe,SAAS,OAAO,UAAU;CAC9D,IAAI,YAAY,KAAA,KAAa,MAAM,SAAS,QAAQ,OAAO;CAC3D,IAAI;EACF,MAAM,QAAQ,QAAQ,IAAI;EAC1B,IAAI,UAAU,KAAA,GAAW,OAAO;EAChC,aAAa,KAAc;EAC3B,OAAO;GACL,GAAI;IACH,IAAI,mBAAmB;EAC1B;CACF,QAAQ;EACN,OAAO;CACT;AACF;AAEA,MAAa,gBACX,KACA,MACA,SAKA,OAAO,WAAW,UAChB,IAAI,aAAa,KAAK,OAAO,QAAQ,YACnC,KAAK,QAAQ,OAAO,KAAK,SAAS,MAAM,OAAO,CAAC,CAClD,CACF;AAEF,MAAa,cACX,KACA,SAEA,OAAO,kBAAkB,UACvB,OAAO,KAAK,IAAI,eAAe,KAAK,IAAI,GAAG,MAAM,OAAO,CAC1D"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@gaganref/confect-server",
-  "version": "10.3.1-fork.42",
+  "version": "10.3.1-fork.44",
   "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.42",
+    "@confect/core": "npm:@gaganref/confect-core@10.3.1-fork.44",
     "@effect/platform-node": ">=4.0.0 <4.1.0",
     "convex": "^1.48.0",
     "effect": ">=4.0.4 <4.1.0"

package/src/ActionCall.ts

@@ -1,5 +1,6 @@
+import * as ReservedArgument from "./internal/reservedArgument.js";
 import * as ActionCall from "@confect/core/ActionCall";
-import * as Ref from "@confect/core/Ref";
+import type * as Ref from "@confect/core/Ref";
 import type { FunctionReference } from "convex/server";
 import * as Context from "effect/Context";
 import * as Data from "effect/Data";
@@ -50,7 +51,7 @@ export const layer = <S extends DatabaseSchema.AnyWithProps>(schema: S) =>
           claimed = true;
           if (ref.functionType !== "query" && ref.functionType !== "mutation")
             return Effect.die(new MissingFunctionType());
-          return Ref.runWithCodec(
+          return ReservedArgument.runWithCodec(
             ref,
             (args[0] ?? {}) as Ref.Args<Target>,
             (native, encoded) =>
@@ -64,7 +65,7 @@ export const layer = <S extends DatabaseSchema.AnyWithProps>(schema: S) =>
                     encoded as never,
                   ),
           );
-        });
+        }).pipe(Effect.withSpan("ActionCall.call"));
       return yield* effect.pipe(
         Effect.provideService(ActionCall.ActionCall, call),
         Effect.updateContext(

package/src/ActionRunner.ts

@@ -1,4 +1,5 @@
-import * as Ref from "@confect/core/Ref";
+import * as ReservedArgument from "./internal/reservedArgument.js";
+import type * as Ref from "@confect/core/Ref";
 import { type GenericActionCtx } from "convex/server";
 import * as Effect from "effect/Effect";
 import * as Context from "effect/Context";
@@ -18,7 +19,7 @@ const make = (runAction: GenericActionCtx<any>["runAction"]) => ({
     Ref.Error<Action> | Schema.SchemaError
   > =>
     run(
-      Ref.runWithCodec(
+      ReservedArgument.runWithCodec(
         action,
         (args[0] ?? {}) as Ref.Args<Action>,
         (functionReference, encodedArgs) =>

package/src/MutationRunner.ts

@@ -1,4 +1,5 @@
-import * as Ref from "@confect/core/Ref";
+import * as ReservedArgument from "./internal/reservedArgument.js";
+import type * as Ref from "@confect/core/Ref";
 import type { GenericActionCtx } from "convex/server";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
@@ -46,7 +47,7 @@ const make = (nativeRunMutation: GenericActionCtx<any>["runMutation"]) => {
             yield* MutationTransactionContext.MutationTransactionContext;
           return yield* controls.runMutation(mutation, actualArgs, options);
         }
-        return yield* Ref.runWithCodec(
+        return yield* ReservedArgument.runWithCodec(
           mutation,
           actualArgs,
           (ref, encodedArgs) => nativeRunMutation(ref, encodedArgs),

package/src/MutationTransactionContext.ts

@@ -1,3 +1,4 @@
+import * as ReservedArgument from "./internal/reservedArgument.js";
 import * as Ref from "@confect/core/Ref";
 import type {
   AdvancedRunQueryOptions,
@@ -32,7 +33,7 @@ const make = (
       args: Ref.Args<Mutation>,
       options: MutationOptions,
     ) =>
-      Ref.runWithCodec(mutation, args, (ref, encodedArgs) =>
+      ReservedArgument.runWithCodec(mutation, args, (ref, encodedArgs) =>
         ctx.runMutation(ref, encodedArgs, options),
       ),
   ),

package/src/RegisteredConvexFunction.ts

@@ -381,7 +381,11 @@ const mutationFunction = <
         RegisteredFunction.combineErrorSchemas(error, resolvedMiddlewares),
         {
           scheduler: new EffectScheduler.MixedScheduler("sync"),
-          invocation: Effect.promise(() => ctx.meta.getFunctionMetadata()),
+          invocation: RegisteredFunction.invocationMetadata(
+            ctx.meta,
+            actualArgs,
+            reservedArgument,
+          ),
           observability,
         },
       ),

package/src/RegisteredFunction.ts

@@ -1,3 +1,4 @@
+export { Forward } from "./internal/reservedArgument.js";
 import * as ActionCallSpec from "@confect/core/ActionCall";
 import * as ActionCall from "./ActionCall.js";
 import type { FunctionSpec, RuntimeAndFunctionType } from "@confect/core";
@@ -12,6 +13,7 @@ import {
   type DefaultFunctionArgs,
   type FunctionVisibility,
   type FunctionMetadata,
+  type MutationMeta,
   type GenericActionCtx,
   type GenericDataModel,
   type StorageReader as ConvexStorageReader,
@@ -22,6 +24,9 @@ import {
 import type { Value } from "convex/values";
 import { ConvexError } from "convex/values";
 import { pipe } from "effect/Function";
+import * as Config from "effect/Config";
+import * as Option from "effect/Option";
+import * as ConvexConfigProvider from "./ConvexConfigProvider.js";
 import * as Clock from "effect/Clock";
 import * as Cause from "effect/Cause";
 import * as Console from "effect/Console";
@@ -53,6 +58,40 @@ import * as ObservabilityRuntime from "./internal/observability.js";
 import * as VectorSearch from "./VectorSearch.js";
 import type * as Handler from "./Handler.js";
 
+export interface ReceivedValue {
+  readonly value: unknown;
+  readonly requestId: string;
+  readonly deployment: string | undefined;
+}
+
+export const Received = Context.Reference<ReceivedValue | undefined>(
+  "@confect/server/RegisteredFunction/Received",
+  { defaultValue: () => undefined },
+);
+
+export const invocationMetadata = (
+  meta: Pick<MutationMeta, "getFunctionMetadata" | "getRequestMetadata">,
+  args: DefaultFunctionArgs,
+  reservedArgument?: string,
+): Effect.Effect<FunctionMetadata & { readonly received?: ReceivedValue }> =>
+  Effect.gen(function* () {
+    const metadata = yield* Effect.promise(() => meta.getFunctionMetadata());
+    if (reservedArgument === undefined) return metadata;
+    const { requestId } = yield* Effect.promise(() =>
+      meta.getRequestMetadata(),
+    );
+    const deployment = yield* Config.String("CONVEX_CLOUD_URL").pipe(
+      Config.option,
+      Effect.map(Option.getOrUndefined),
+      Effect.provide(ConvexConfigProvider.layer),
+      Effect.orDie,
+    );
+    return {
+      ...metadata,
+      received: { value: args[reservedArgument], requestId, deployment },
+    };
+  });
+
 export const Observability = Context.Reference<Layer.Layer<never> | undefined>(
   "@confect/server/Observability",
   { defaultValue: () => undefined },
@@ -226,7 +265,11 @@ export const runHandlerPromise =
     runOptions?: {
       readonly scheduler?: EffectScheduler.Scheduler | undefined;
       readonly clock?: Clock.Clock | undefined;
-      readonly invocation?: Effect.Effect<FunctionMetadata> | undefined;
+      readonly invocation?:
+        | Effect.Effect<
+            FunctionMetadata & { readonly received?: ReceivedValue }
+          >
+        | undefined;
       readonly observability?: Layer.Layer<never> | undefined;
     },
   ) =>
@@ -269,16 +312,18 @@ export const runHandlerPromise =
         const exit = yield* Effect.exit(
           observability === undefined || invocation === undefined
             ? effect
-            : Effect.flatMap(invocation, ({ name, type, componentPath }) =>
-                Effect.useSpan(
-                  name,
-                  {
-                    root: true,
-                    attributes: { kind: type, componentPath },
-                  },
-                  (span) =>
-                    Effect.provideService(observed, Tracer.ParentSpan, span),
-                ),
+            : Effect.flatMap(
+                invocation,
+                ({ name, type, componentPath, received }) =>
+                  Effect.useSpan(
+                    name,
+                    {
+                      root: true,
+                      attributes: { kind: type, componentPath },
+                    },
+                    (span) =>
+                      Effect.provideService(observed, Tracer.ParentSpan, span),
+                  ).pipe(Effect.provideService(Received, received)),
               ),
         );
         if (Exit.isSuccess(exit)) {
@@ -429,7 +474,7 @@ export const actionFunctionBase = <
       );
     }).pipe(
       runHandlerPromise(combineErrorSchemas(error, resolvedMiddlewares), {
-        invocation: Effect.promise(() => ctx.meta.getFunctionMetadata()),
+        invocation: invocationMetadata(ctx.meta, actualArgs, reservedArgument),
         observability,
       }),
     ),