@gaganref/confect-test 10.3.1-fork.9 → 10.3.1-fork.90

package/dist/TestConfect.d.ts

@@ -1,17 +1,28 @@
-import { App, Ref } from "@confect/core";
+import { App, type Mount, Ref } from "@confect/core";
 import type { DatabaseSchema } from "@confect/server";
 import { RegisteredConvexFunction } from "@confect/server";
-import type { TestConvexForDataModelAndIdentity } from "convex-test";
-import type { GenericDataModel, GenericSchema, SchemaDefinition, UserIdentity } from "convex/server";
+import type { GenericSchema, SchemaDefinition, UserIdentity } from "convex/server";
 import type { Value } from "convex/values";
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Schema from "effect/Schema";
+/**
+ * How a kit registers a component beyond its schema and modules.
+ */
+export type RegisterOptions = {
+    /**
+     * The component's functions, as `module:export`, that schedule their own next
+     * run, such as the crons component's `public:rescheduler`. The test kernel
+     * never treats a job that runs one, or that one schedules, as work
+     * `finishAllScheduledFunctions` must finish. convex-test ignores it.
+     */
+    readonly standing?: ReadonlyArray<string>;
+};
 /**
  * Register a component's Convex schema and modules at its installation path.
  */
-export type RegisterComponent = TestConvexForDataModelAndIdentity<GenericDataModel>["registerComponent"];
+export type RegisterComponent = (componentPath: string, schema: SchemaDefinition<GenericSchema, boolean>, modules: Record<string, () => Promise<any>>, options?: RegisterOptions) => void;
 /**
  * An installed component path and the HTTP prefix exposed by its host.
  */
@@ -19,7 +30,20 @@ export type HttpMount = {
     readonly componentPath: string;
     readonly httpPrefix: string;
 };
-export type LayerOptions = {
+/**
+ * The in-process backend a test layer runs on.
+ */
+export type Target = "convex-test" | "kernel";
+export type TargetOptions = {
+    /**
+     * `"kernel"` runs every function and component the layer registers on
+     * Confect's test kernel, which runs scheduled functions on its own clock and
+     * reads `registerComponent`'s `standing`. Defaults to `"convex-test"`. The
+     * option goes once the kernel replaces convex-test.
+     */
+    readonly target?: Target;
+};
+export type LayerOptions = TargetOptions & {
     /**
      * Register component kits synchronously before the test service is available.
      */
@@ -42,14 +66,14 @@ export type TestConfectWithoutIdentity<ConfectSchema extends DatabaseSchema.AnyW
     finishAllScheduledFunctions: (advanceTimers: () => void) => Effect.Effect<void>;
 };
 export type TestConfect<ConfectSchema extends DatabaseSchema.AnyWithProps> = {
-    registerComponent: (componentPath: string, schema: SchemaDefinition<GenericSchema, boolean>, modules: Record<string, () => Promise<any>>) => Effect.Effect<void>;
+    registerComponent: (componentPath: string, schema: SchemaDefinition<GenericSchema, boolean>, modules: Record<string, () => Promise<any>>, options?: RegisterOptions) => Effect.Effect<void>;
     withIdentity: (userIdentity: Partial<UserIdentity>) => TestConfectWithoutIdentity<ConfectSchema>;
 } & TestConfectWithoutIdentity<ConfectSchema>;
 export declare const TestConfect: <ConfectSchema extends DatabaseSchema.AnyWithProps>() => Context.Service<TestConfect<ConfectSchema>, TestConfect<ConfectSchema>>;
 /**
  * How a test registers one installed component: its own schema and modules, or
- * the `register(t, name)` a component package exports from `<package>/test`,
- * which also registers the package's own children.
+ * the `register(t, name)` a component package exports from `<package>/testing`
+ * or `<package>/test`, which also registers the package's own children.
  */
 export type ComponentKit = {
     readonly schema: SchemaDefinition<GenericSchema, boolean>;
@@ -77,10 +101,12 @@ export type DeclaredApp<DatabaseSchema_ extends DatabaseSchema.AnyWithProps> = R
 /**
  * Build a fresh test backend from a declaration and its generated
  * `confect/_generated/testing` registry, without restating component mounts.
+ * Pass `{ target: "kernel" }` to run it on Confect's test kernel instead of
+ * convex-test.
  */
-export declare function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(app: DeclaredApp<DatabaseSchema_>): Layer.Layer<TestConfect<DatabaseSchema_>>;
+export declare function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(app: DeclaredApp<DatabaseSchema_>, options?: TargetOptions): Layer.Layer<TestConfect<DatabaseSchema_>>;
 export declare function layer<A extends App.Any, DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(app: A, registry: Registry<DatabaseSchema_> & {
-    readonly components: Readonly<Record<keyof NoInfer<A>["mounts"], Registry<DatabaseSchema_>["components"][string]>>;
-}): Layer.Layer<TestConfect<DatabaseSchema_>>;
+    readonly components: Readonly<Record<Mount.NameOf<NoInfer<A>["mounts"][number]>, Registry<DatabaseSchema_>["components"][string]>>;
+}, options?: TargetOptions): Layer.Layer<TestConfect<DatabaseSchema_>>;
 export declare function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(databaseSchema: DatabaseSchema_, convexSchemaDefinition: SchemaDefinition<GenericSchema, true>, modules: Record<string, () => Promise<any>>, options?: LayerOptions): Layer.Layer<TestConfect<DatabaseSchema_>>;
 //# sourceMappingURL=TestConfect.d.ts.map

package/dist/TestConfect.d.ts.map

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

package/dist/TestConfect.js

@@ -1,4 +1,5 @@
 import { __exportAll } from "./_virtual/_rolldown/runtime.js";
+import { convexTest as convexTest$1 } from "./internal/ConvexTest.js";
 import { make } from "./internal/MountedHttp.js";
 import { App, Ref } from "@confect/core";
 import { RegisteredConvexFunction } from "@confect/server";
@@ -45,7 +46,7 @@ var TestConfectImpl = class {
 		this.testConfectImplWithoutIdentity = new TestConfectImplWithoutIdentity(confectSchema, testConvex, mountedHttp);
 	}
 	withIdentity = (userIdentity) => new TestConfectImplWithoutIdentity(this.confectSchema, this.testConvex.withIdentity(userIdentity), this.mountedHttp);
-	registerComponent = Effect.fn("TestConfect.registerComponent")((componentPath, schema, modules) => Effect.sync(() => this.mountedHttp.register(componentPath, schema, modules)));
+	registerComponent = Effect.fn("TestConfect.registerComponent")((componentPath, schema, modules, options) => Effect.sync(() => this.mountedHttp.register(componentPath, schema, modules, options)));
 	query = (queryRef, ...args) => this.testConfectImplWithoutIdentity.query(queryRef, ...args);
 	mutation = (mutationRef, ...args) => this.testConfectImplWithoutIdentity.mutation(mutationRef, ...args);
 	action = (actionRef, ...args) => this.testConfectImplWithoutIdentity.action(actionRef, ...args);
@@ -54,15 +55,24 @@ var TestConfectImpl = class {
 	finishInProgressScheduledFunctions = () => this.testConfectImplWithoutIdentity.finishInProgressScheduledFunctions();
 	finishAllScheduledFunctions = (advanceTimers) => this.testConfectImplWithoutIdentity.finishAllScheduledFunctions(advanceTimers);
 };
+var InvalidComponentKit = class extends Schema.TaggedError()("InvalidComponentKit", {
+	componentPath: Schema.String,
+	message: Schema.String
+}) {};
 const registerKit = (registerComponent, name, kit) => {
 	if ("register" in kit) kit.register({ registerComponent }, name);
-	else registerComponent(name, kit.schema, kit.modules);
+	else if ("schema" in kit && "modules" in kit) registerComponent(name, kit.schema, kit.modules);
+	else throw new InvalidComponentKit({
+		componentPath: name,
+		message: `The test kit for ${JSON.stringify(name)} must export register(t, name), or schema and modules.`
+	});
 };
-function layer(appOrSchema, registryOrSchema, modules, options = {}) {
+function layer(appOrSchema, second, third, options = {}) {
 	if (App.isApp(appOrSchema)) {
-		const registry = registryOrSchema;
+		const registry = second;
 		const mounts = App.mounts(appOrSchema);
 		return schemaLayer(registry.schema, registry.convexSchema, registry.modules, {
+			...targetOf(third),
 			httpMounts: mounts.flatMap(({ name, httpPrefix }) => httpPrefix === void 0 ? [] : [{
 				componentPath: name,
 				httpPrefix
@@ -75,17 +85,22 @@ function layer(appOrSchema, registryOrSchema, modules, options = {}) {
 	if ("httpMounts" in appOrSchema) {
 		const app = appOrSchema;
 		return schemaLayer(app.schema, app.convexSchema, app.modules, {
+			...targetOf(second),
 			httpMounts: app.httpMounts,
 			register: (registerComponent) => {
 				for (const [name, component] of Object.entries(app.components)) registerKit(registerComponent, name, component);
 			}
 		});
 	}
-	return schemaLayer(appOrSchema, registryOrSchema, modules, options);
+	return schemaLayer(appOrSchema, second, third, options);
 }
+const targetOf = (options) => options?.target === void 0 ? {} : { target: options.target };
 const schemaLayer = (databaseSchema, convexSchemaDefinition, modules, options = {}) => Layer.sync(TestConfect(), () => {
-	const testConvex = convexTest(convexSchemaDefinition, modules);
-	const mountedHttp = make(options.httpMounts ?? [], (...args) => testConvex.registerComponent(...args));
+	process.env.CONVEX_CLOUD_URL ??= "https://some-deployment.convex.cloud";
+	process.env.CONVEX_SITE_URL ??= "https://some.convex.site";
+	const testConvex = (options.target === "kernel" ? convexTest$1 : convexTest)(convexSchemaDefinition, modules);
+	const registerComponent = testConvex.registerComponent;
+	const mountedHttp = make(options.httpMounts ?? [], (...args) => registerComponent(...args));
 	options.register?.(mountedHttp.register);
 	return new TestConfectImpl(databaseSchema, testConvex, mountedHttp);
 });

package/dist/TestConfect.js.map

@@ -1 +1 @@
-{"version":3,"file":"TestConfect.js","names":["MountedHttp.make"],"sources":["../src/TestConfect.ts"],"sourcesContent":["import { App, Ref } from \"@confect/core\";\nimport type { DatabaseSchema, DataModel } from \"@confect/server\";\nimport { RegisteredConvexFunction } from \"@confect/server\";\nimport type {\n  TestConvexForDataModel,\n  TestConvexForDataModelAndIdentity,\n} from \"convex-test\";\nimport { convexTest } from \"convex-test\";\nimport type {\n  GenericDataModel,\n  GenericMutationCtx,\n  GenericSchema,\n  SchemaDefinition,\n  UserIdentity,\n} from \"convex/server\";\nimport type { Value } from \"convex/values\";\nimport * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Schema from \"effect/Schema\";\nimport * as MountedHttp from \"./internal/MountedHttp.js\";\n\n/**\n * Register a component's Convex schema and modules at its installation path.\n */\nexport type RegisterComponent =\n  TestConvexForDataModelAndIdentity<GenericDataModel>[\"registerComponent\"];\n\n/**\n * An installed component path and the HTTP prefix exposed by its host.\n */\nexport type HttpMount = {\n  readonly componentPath: string;\n  readonly httpPrefix: string;\n};\n\nexport type LayerOptions = {\n  /**\n   * Register component kits synchronously before the test service is available.\n   */\n  readonly register?: (registerComponent: RegisterComponent) => void;\n  /**\n   * Explicit HTTP mounts. The test layer does not evaluate convex.config.ts.\n   */\n  readonly httpMounts?: ReadonlyArray<HttpMount>;\n};\n\nexport type TestConfectWithoutIdentity<\n  ConfectSchema extends DatabaseSchema.AnyWithProps,\n> = {\n  query: <QueryRef extends Ref.AnyQuery>(\n    queryRef: QueryRef,\n    ...args: Ref.OptionalArgs<QueryRef>\n  ) => Effect.Effect<\n    Ref.Returns<QueryRef>,\n    Ref.Error<QueryRef> | Schema.SchemaError\n  >;\n  mutation: <MutationRef extends Ref.AnyMutation>(\n    mutationRef: MutationRef,\n    ...args: Ref.OptionalArgs<MutationRef>\n  ) => Effect.Effect<\n    Ref.Returns<MutationRef>,\n    Ref.Error<MutationRef> | Schema.SchemaError\n  >;\n  action: <ActionRef extends Ref.AnyAction>(\n    actionRef: ActionRef,\n    ...args: Ref.OptionalArgs<ActionRef>\n  ) => Effect.Effect<\n    Ref.Returns<ActionRef>,\n    Ref.Error<ActionRef> | Schema.SchemaError\n  >;\n  run: {\n    <E>(\n      handler: Effect.Effect<\n        void,\n        E,\n        RegisteredConvexFunction.MutationServices<ConfectSchema>\n      >,\n    ): Effect.Effect<void>;\n    <A, B extends Value, E>(\n      handler: Effect.Effect<\n        A,\n        E,\n        RegisteredConvexFunction.MutationServices<ConfectSchema>\n      >,\n      returns: Schema.Codec<A, B>,\n    ): Effect.Effect<A, Schema.SchemaError>;\n  };\n  fetch: (\n    pathQueryFragment: string,\n    init?: RequestInit,\n  ) => Effect.Effect<Response>;\n  finishInProgressScheduledFunctions: () => Effect.Effect<void>;\n  finishAllScheduledFunctions: (\n    advanceTimers: () => void,\n  ) => Effect.Effect<void>;\n};\n\nexport type TestConfect<ConfectSchema extends DatabaseSchema.AnyWithProps> = {\n  registerComponent: (\n    componentPath: string,\n    schema: SchemaDefinition<GenericSchema, boolean>,\n    modules: Record<string, () => Promise<any>>,\n  ) => Effect.Effect<void>;\n  withIdentity: (\n    userIdentity: Partial<UserIdentity>,\n  ) => TestConfectWithoutIdentity<ConfectSchema>;\n} & TestConfectWithoutIdentity<ConfectSchema>;\n\nexport const TestConfect = <\n  ConfectSchema extends DatabaseSchema.AnyWithProps,\n>() => Context.Service<TestConfect<ConfectSchema>>(\"@confect/test/TestConfect\");\n\nclass TestConfectImplWithoutIdentity<\n  ConfectSchema extends DatabaseSchema.AnyWithProps,\n> implements TestConfectWithoutIdentity<ConfectSchema> {\n  constructor(\n    private confectSchema: ConfectSchema,\n    private testConvex: TestConvexForDataModel<\n      DataModel.ToConvex<DataModel.FromSchema<ConfectSchema>>\n    >,\n    private mountedHttp: ReturnType<typeof MountedHttp.make>,\n  ) {}\n\n  readonly query = <QueryRef extends Ref.AnyQuery>(\n    queryRef: QueryRef,\n    ...args: Ref.OptionalArgs<QueryRef>\n  ): Effect.Effect<\n    Ref.Returns<QueryRef>,\n    Ref.Error<QueryRef> | Schema.SchemaError\n  > =>\n    Ref.runWithCodec(\n      queryRef,\n      (args[0] ?? {}) as Ref.Args<QueryRef>,\n      (functionReference, encodedArgs) =>\n        this.testConvex.query(functionReference as any, encodedArgs),\n    );\n\n  readonly mutation = <MutationRef extends Ref.AnyMutation>(\n    mutationRef: MutationRef,\n    ...args: Ref.OptionalArgs<MutationRef>\n  ): Effect.Effect<\n    Ref.Returns<MutationRef>,\n    Ref.Error<MutationRef> | Schema.SchemaError\n  > =>\n    Ref.runWithCodec(\n      mutationRef,\n      (args[0] ?? {}) as Ref.Args<MutationRef>,\n      (functionReference, encodedArgs) =>\n        this.testConvex.mutation(functionReference as any, encodedArgs),\n    );\n\n  readonly action = <ActionRef extends Ref.AnyAction>(\n    actionRef: ActionRef,\n    ...args: Ref.OptionalArgs<ActionRef>\n  ): Effect.Effect<\n    Ref.Returns<ActionRef>,\n    Ref.Error<ActionRef> | Schema.SchemaError\n  > =>\n    Ref.runWithCodec(\n      actionRef,\n      (args[0] ?? {}) as Ref.Args<ActionRef>,\n      (functionReference, encodedArgs) =>\n        this.testConvex.action(functionReference as any, encodedArgs),\n    );\n\n  readonly run: TestConfectWithoutIdentity<ConfectSchema>[\"run\"] = (<\n    A,\n    B extends Value,\n    E,\n  >(\n    handler: Effect.Effect<\n      A,\n      E,\n      RegisteredConvexFunction.MutationServices<ConfectSchema>\n    >,\n    returns?: Schema.Codec<A, B>,\n  ): Effect.Effect<void> | Effect.Effect<A, Schema.SchemaError> => {\n    const makeMutationLayer = (\n      mutationCtx: GenericMutationCtx<\n        DataModel.ToConvex<DataModel.FromSchema<ConfectSchema>>\n      >,\n    ): Layer.Layer<RegisteredConvexFunction.MutationServices<ConfectSchema>> =>\n      RegisteredConvexFunction.mutationLayer(\n        this.confectSchema,\n        mutationCtx,\n      ) as Layer.Layer<\n        RegisteredConvexFunction.MutationServices<ConfectSchema>\n      >;\n\n    return returns === undefined\n      ? Effect.promise(() =>\n          this.testConvex.run((mutationCtx) =>\n            Effect.runPromise(\n              handler.pipe(\n                Effect.asVoid,\n                Effect.provide(makeMutationLayer(mutationCtx)),\n              ),\n            ),\n          ),\n        )\n      : Effect.promise(() =>\n          this.testConvex.run((mutationCtx) =>\n            Effect.runPromise(\n              handler.pipe(\n                Effect.andThen(Schema.encodeEffect(returns)),\n                Effect.provide(makeMutationLayer(mutationCtx)),\n              ),\n            ),\n          ),\n        ).pipe(Effect.andThen(Schema.decodeEffect(returns)));\n  }) as TestConfectWithoutIdentity<ConfectSchema>[\"run\"];\n\n  readonly fetch = <PathQueryFragment extends string>(\n    pathQueryFragment: PathQueryFragment,\n    init?: RequestInit,\n  ) =>\n    Effect.promise(() =>\n      this.mountedHttp.fetch(this.testConvex, pathQueryFragment, init),\n    );\n\n  readonly finishInProgressScheduledFunctions = () =>\n    Effect.promise(() => this.testConvex.finishInProgressScheduledFunctions());\n\n  readonly finishAllScheduledFunctions = (advanceTimers: () => void) =>\n    Effect.promise(() =>\n      this.testConvex.finishAllScheduledFunctions(advanceTimers),\n    );\n}\n\nclass TestConfectImpl<\n  ConfectSchema extends DatabaseSchema.AnyWithProps,\n> implements TestConfect<ConfectSchema> {\n  private readonly testConfectImplWithoutIdentity: TestConfectImplWithoutIdentity<ConfectSchema>;\n\n  constructor(\n    private confectSchema: ConfectSchema,\n    private testConvex: TestConvexForDataModelAndIdentity<\n      DataModel.ToConvex<DataModel.FromSchema<ConfectSchema>>\n    >,\n    private mountedHttp: ReturnType<typeof MountedHttp.make>,\n  ) {\n    this.testConfectImplWithoutIdentity = new TestConfectImplWithoutIdentity(\n      confectSchema,\n      testConvex,\n      mountedHttp,\n    );\n  }\n\n  readonly withIdentity = (userIdentity: Partial<UserIdentity>) =>\n    new TestConfectImplWithoutIdentity(\n      this.confectSchema,\n      this.testConvex.withIdentity(userIdentity),\n      this.mountedHttp,\n    );\n\n  readonly registerComponent: TestConfect<ConfectSchema>[\"registerComponent\"] =\n    Effect.fn(\"TestConfect.registerComponent\")(\n      (componentPath, schema, modules) =>\n        Effect.sync(() =>\n          this.mountedHttp.register(componentPath, schema, modules),\n        ),\n    );\n\n  readonly query = <QueryRef extends Ref.AnyQuery>(\n    queryRef: QueryRef,\n    ...args: Ref.OptionalArgs<QueryRef>\n  ) => this.testConfectImplWithoutIdentity.query(queryRef, ...args);\n\n  readonly mutation = <MutationRef extends Ref.AnyMutation>(\n    mutationRef: MutationRef,\n    ...args: Ref.OptionalArgs<MutationRef>\n  ) => this.testConfectImplWithoutIdentity.mutation(mutationRef, ...args);\n\n  readonly action = <ActionRef extends Ref.AnyAction>(\n    actionRef: ActionRef,\n    ...args: Ref.OptionalArgs<ActionRef>\n  ) => this.testConfectImplWithoutIdentity.action(actionRef, ...args);\n\n  readonly run: TestConfect<ConfectSchema>[\"run\"] = ((\n    handler: any,\n    returns?: any,\n  ) =>\n    this.testConfectImplWithoutIdentity.run(\n      handler,\n      returns,\n    )) as TestConfect<ConfectSchema>[\"run\"];\n\n  readonly fetch = <PathQueryFragment extends string>(\n    pathQueryFragment: PathQueryFragment,\n    init?: RequestInit,\n  ) => this.testConfectImplWithoutIdentity.fetch(pathQueryFragment, init);\n\n  readonly finishInProgressScheduledFunctions = () =>\n    this.testConfectImplWithoutIdentity.finishInProgressScheduledFunctions();\n\n  readonly finishAllScheduledFunctions = (advanceTimers: () => void) =>\n    this.testConfectImplWithoutIdentity.finishAllScheduledFunctions(\n      advanceTimers,\n    );\n}\n\n/**\n * How a test registers one installed component: its own schema and modules, or\n * the `register(t, name)` a component package exports from `<package>/test`,\n * which also registers the package's own children.\n */\nexport type ComponentKit =\n  | {\n      readonly schema: SchemaDefinition<GenericSchema, boolean>;\n      readonly modules: Record<string, () => Promise<any>>;\n    }\n  | {\n      register(\n        t: { readonly registerComponent: RegisterComponent },\n        name: string,\n      ): unknown;\n    };\n\nconst registerKit = (\n  registerComponent: RegisterComponent,\n  name: string,\n  kit: ComponentKit,\n) => {\n  if (\"register\" in kit) {\n    kit.register({ registerComponent }, name);\n  } else {\n    registerComponent(name, kit.schema, kit.modules);\n  }\n};\n\n/**\n * Codegen's test-only schema and module registry.\n */\nexport type Registry<DatabaseSchema_ extends DatabaseSchema.AnyWithProps> = {\n  readonly schema: DatabaseSchema_;\n  readonly convexSchema: SchemaDefinition<GenericSchema, true>;\n  readonly modules: Record<string, () => Promise<any>>;\n  readonly components: Readonly<Record<string, ComponentKit>>;\n};\n\n/**\n * The declared app's generated, test-only representation.\n */\nexport type DeclaredApp<DatabaseSchema_ extends DatabaseSchema.AnyWithProps> =\n  Registry<DatabaseSchema_> & {\n    readonly httpMounts: ReadonlyArray<HttpMount>;\n  };\n\n/**\n * Build a fresh test backend from a declaration and its generated\n * `confect/_generated/testing` registry, without restating component mounts.\n */\nexport function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(\n  app: DeclaredApp<DatabaseSchema_>,\n): Layer.Layer<TestConfect<DatabaseSchema_>>;\nexport function layer<\n  A extends App.Any,\n  DatabaseSchema_ extends DatabaseSchema.AnyWithProps,\n>(\n  app: A,\n  registry: Registry<DatabaseSchema_> & {\n    readonly components: Readonly<\n      Record<\n        keyof NoInfer<A>[\"mounts\"],\n        Registry<DatabaseSchema_>[\"components\"][string]\n      >\n    >;\n  },\n): Layer.Layer<TestConfect<DatabaseSchema_>>;\nexport function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(\n  databaseSchema: DatabaseSchema_,\n  convexSchemaDefinition: SchemaDefinition<GenericSchema, true>,\n  modules: Record<string, () => Promise<any>>,\n  options?: LayerOptions,\n): Layer.Layer<TestConfect<DatabaseSchema_>>;\nexport function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(\n  appOrSchema: App.Any | DeclaredApp<DatabaseSchema_> | DatabaseSchema_,\n  registryOrSchema?:\n    | Registry<DatabaseSchema_>\n    | SchemaDefinition<GenericSchema, true>,\n  modules?: Record<string, () => Promise<any>>,\n  options: LayerOptions = {},\n): Layer.Layer<TestConfect<DatabaseSchema_>> {\n  if (App.isApp(appOrSchema)) {\n    const registry = registryOrSchema as Registry<DatabaseSchema_>;\n    const mounts = App.mounts(appOrSchema);\n    return schemaLayer(\n      registry.schema,\n      registry.convexSchema,\n      registry.modules,\n      {\n        httpMounts: mounts.flatMap(({ name, httpPrefix }) =>\n          httpPrefix === undefined ? [] : [{ componentPath: name, httpPrefix }],\n        ),\n        register: (registerComponent) => {\n          for (const [name, component] of Object.entries(registry.components)) {\n            if (\n              mounts.some(\n                (mount) =>\n                  name === mount.name || name.startsWith(`${mount.name}/`),\n              )\n            ) {\n              registerKit(registerComponent, name, component);\n            }\n          }\n        },\n      },\n    );\n  }\n  if (\"httpMounts\" in appOrSchema) {\n    const app = appOrSchema as DeclaredApp<DatabaseSchema_>;\n    return schemaLayer(app.schema, app.convexSchema, app.modules, {\n      httpMounts: app.httpMounts,\n      register: (registerComponent) => {\n        for (const [name, component] of Object.entries(app.components)) {\n          registerKit(registerComponent, name, component);\n        }\n      },\n    });\n  }\n  return schemaLayer(\n    appOrSchema as DatabaseSchema_,\n    registryOrSchema as SchemaDefinition<GenericSchema, true>,\n    modules!,\n    options,\n  );\n}\n\nconst schemaLayer = <DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(\n  databaseSchema: DatabaseSchema_,\n  convexSchemaDefinition: SchemaDefinition<GenericSchema, true>,\n  modules: Record<string, () => Promise<any>>,\n  options: LayerOptions = {},\n): Layer.Layer<TestConfect<DatabaseSchema_>> =>\n  Layer.sync(TestConfect<DatabaseSchema_>(), () => {\n    const testConvex = convexTest(convexSchemaDefinition, modules);\n    const mountedHttp = MountedHttp.make(options.httpMounts ?? [], (...args) =>\n      testConvex.registerComponent(...args),\n    );\n    options.register?.(mountedHttp.register);\n    return new TestConfectImpl(databaseSchema, testConvex as any, mountedHttp);\n  });\n"],"mappings":"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"}
+{"version":3,"file":"TestConfect.js","names":["kernelTest","MountedHttp.make"],"sources":["../src/TestConfect.ts"],"sourcesContent":["import { App, type Mount, Ref } from \"@confect/core\";\nimport type { DatabaseSchema, DataModel } from \"@confect/server\";\nimport { RegisteredConvexFunction } from \"@confect/server\";\nimport type {\n  TestConvexForDataModel,\n  TestConvexForDataModelAndIdentity,\n} from \"convex-test\";\nimport { convexTest } from \"convex-test\";\nimport type {\n  GenericMutationCtx,\n  GenericSchema,\n  SchemaDefinition,\n  UserIdentity,\n} from \"convex/server\";\nimport type { Value } from \"convex/values\";\nimport * as Context from \"effect/Context\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Schema from \"effect/Schema\";\nimport { convexTest as kernelTest } from \"./internal/ConvexTest.js\";\nimport * as MountedHttp from \"./internal/MountedHttp.js\";\n\ndeclare const process: { env: Record<string, string | undefined> };\n\n/**\n * How a kit registers a component beyond its schema and modules.\n */\nexport type RegisterOptions = {\n  /**\n   * The component's functions, as `module:export`, that schedule their own next\n   * run, such as the crons component's `public:rescheduler`. The test kernel\n   * never treats a job that runs one, or that one schedules, as work\n   * `finishAllScheduledFunctions` must finish. convex-test ignores it.\n   */\n  readonly standing?: ReadonlyArray<string>;\n};\n\n/**\n * Register a component's Convex schema and modules at its installation path.\n */\nexport type RegisterComponent = (\n  componentPath: string,\n  schema: SchemaDefinition<GenericSchema, boolean>,\n  modules: Record<string, () => Promise<any>>,\n  options?: RegisterOptions,\n) => void;\n\n/**\n * An installed component path and the HTTP prefix exposed by its host.\n */\nexport type HttpMount = {\n  readonly componentPath: string;\n  readonly httpPrefix: string;\n};\n\n/**\n * The in-process backend a test layer runs on.\n */\nexport type Target = \"convex-test\" | \"kernel\";\n\nexport type TargetOptions = {\n  /**\n   * `\"kernel\"` runs every function and component the layer registers on\n   * Confect's test kernel, which runs scheduled functions on its own clock and\n   * reads `registerComponent`'s `standing`. Defaults to `\"convex-test\"`. The\n   * option goes once the kernel replaces convex-test.\n   */\n  readonly target?: Target;\n};\n\nexport type LayerOptions = TargetOptions & {\n  /**\n   * Register component kits synchronously before the test service is available.\n   */\n  readonly register?: (registerComponent: RegisterComponent) => void;\n  /**\n   * Explicit HTTP mounts. The test layer does not evaluate convex.config.ts.\n   */\n  readonly httpMounts?: ReadonlyArray<HttpMount>;\n};\n\nexport type TestConfectWithoutIdentity<\n  ConfectSchema extends DatabaseSchema.AnyWithProps,\n> = {\n  query: <QueryRef extends Ref.AnyQuery>(\n    queryRef: QueryRef,\n    ...args: Ref.OptionalArgs<QueryRef>\n  ) => Effect.Effect<\n    Ref.Returns<QueryRef>,\n    Ref.Error<QueryRef> | Schema.SchemaError\n  >;\n  mutation: <MutationRef extends Ref.AnyMutation>(\n    mutationRef: MutationRef,\n    ...args: Ref.OptionalArgs<MutationRef>\n  ) => Effect.Effect<\n    Ref.Returns<MutationRef>,\n    Ref.Error<MutationRef> | Schema.SchemaError\n  >;\n  action: <ActionRef extends Ref.AnyAction>(\n    actionRef: ActionRef,\n    ...args: Ref.OptionalArgs<ActionRef>\n  ) => Effect.Effect<\n    Ref.Returns<ActionRef>,\n    Ref.Error<ActionRef> | Schema.SchemaError\n  >;\n  run: {\n    <E>(\n      handler: Effect.Effect<\n        void,\n        E,\n        RegisteredConvexFunction.MutationServices<ConfectSchema>\n      >,\n    ): Effect.Effect<void>;\n    <A, B extends Value, E>(\n      handler: Effect.Effect<\n        A,\n        E,\n        RegisteredConvexFunction.MutationServices<ConfectSchema>\n      >,\n      returns: Schema.Codec<A, B>,\n    ): Effect.Effect<A, Schema.SchemaError>;\n  };\n  fetch: (\n    pathQueryFragment: string,\n    init?: RequestInit,\n  ) => Effect.Effect<Response>;\n  finishInProgressScheduledFunctions: () => Effect.Effect<void>;\n  finishAllScheduledFunctions: (\n    advanceTimers: () => void,\n  ) => Effect.Effect<void>;\n};\n\nexport type TestConfect<ConfectSchema extends DatabaseSchema.AnyWithProps> = {\n  registerComponent: (\n    componentPath: string,\n    schema: SchemaDefinition<GenericSchema, boolean>,\n    modules: Record<string, () => Promise<any>>,\n    options?: RegisterOptions,\n  ) => Effect.Effect<void>;\n  withIdentity: (\n    userIdentity: Partial<UserIdentity>,\n  ) => TestConfectWithoutIdentity<ConfectSchema>;\n} & TestConfectWithoutIdentity<ConfectSchema>;\n\nexport const TestConfect = <\n  ConfectSchema extends DatabaseSchema.AnyWithProps,\n>() => Context.Service<TestConfect<ConfectSchema>>(\"@confect/test/TestConfect\");\n\nclass TestConfectImplWithoutIdentity<\n  ConfectSchema extends DatabaseSchema.AnyWithProps,\n> implements TestConfectWithoutIdentity<ConfectSchema> {\n  constructor(\n    private confectSchema: ConfectSchema,\n    private testConvex: TestConvexForDataModel<\n      DataModel.ToConvex<DataModel.FromSchema<ConfectSchema>>\n    >,\n    private mountedHttp: ReturnType<typeof MountedHttp.make>,\n  ) {}\n\n  readonly query = <QueryRef extends Ref.AnyQuery>(\n    queryRef: QueryRef,\n    ...args: Ref.OptionalArgs<QueryRef>\n  ): Effect.Effect<\n    Ref.Returns<QueryRef>,\n    Ref.Error<QueryRef> | Schema.SchemaError\n  > =>\n    Ref.runWithCodec(\n      queryRef,\n      (args[0] ?? {}) as Ref.Args<QueryRef>,\n      (functionReference, encodedArgs) =>\n        this.testConvex.query(functionReference as any, encodedArgs),\n    );\n\n  readonly mutation = <MutationRef extends Ref.AnyMutation>(\n    mutationRef: MutationRef,\n    ...args: Ref.OptionalArgs<MutationRef>\n  ): Effect.Effect<\n    Ref.Returns<MutationRef>,\n    Ref.Error<MutationRef> | Schema.SchemaError\n  > =>\n    Ref.runWithCodec(\n      mutationRef,\n      (args[0] ?? {}) as Ref.Args<MutationRef>,\n      (functionReference, encodedArgs) =>\n        this.testConvex.mutation(functionReference as any, encodedArgs),\n    );\n\n  readonly action = <ActionRef extends Ref.AnyAction>(\n    actionRef: ActionRef,\n    ...args: Ref.OptionalArgs<ActionRef>\n  ): Effect.Effect<\n    Ref.Returns<ActionRef>,\n    Ref.Error<ActionRef> | Schema.SchemaError\n  > =>\n    Ref.runWithCodec(\n      actionRef,\n      (args[0] ?? {}) as Ref.Args<ActionRef>,\n      (functionReference, encodedArgs) =>\n        this.testConvex.action(functionReference as any, encodedArgs),\n    );\n\n  readonly run: TestConfectWithoutIdentity<ConfectSchema>[\"run\"] = (<\n    A,\n    B extends Value,\n    E,\n  >(\n    handler: Effect.Effect<\n      A,\n      E,\n      RegisteredConvexFunction.MutationServices<ConfectSchema>\n    >,\n    returns?: Schema.Codec<A, B>,\n  ): Effect.Effect<void> | Effect.Effect<A, Schema.SchemaError> => {\n    const makeMutationLayer = (\n      mutationCtx: GenericMutationCtx<\n        DataModel.ToConvex<DataModel.FromSchema<ConfectSchema>>\n      >,\n    ): Layer.Layer<RegisteredConvexFunction.MutationServices<ConfectSchema>> =>\n      RegisteredConvexFunction.mutationLayer(\n        this.confectSchema,\n        mutationCtx,\n      ) as Layer.Layer<\n        RegisteredConvexFunction.MutationServices<ConfectSchema>\n      >;\n\n    return returns === undefined\n      ? Effect.promise(() =>\n          this.testConvex.run((mutationCtx) =>\n            Effect.runPromise(\n              handler.pipe(\n                Effect.asVoid,\n                Effect.provide(makeMutationLayer(mutationCtx)),\n              ),\n            ),\n          ),\n        )\n      : Effect.promise(() =>\n          this.testConvex.run((mutationCtx) =>\n            Effect.runPromise(\n              handler.pipe(\n                Effect.andThen(Schema.encodeEffect(returns)),\n                Effect.provide(makeMutationLayer(mutationCtx)),\n              ),\n            ),\n          ),\n        ).pipe(Effect.andThen(Schema.decodeEffect(returns)));\n  }) as TestConfectWithoutIdentity<ConfectSchema>[\"run\"];\n\n  readonly fetch = <PathQueryFragment extends string>(\n    pathQueryFragment: PathQueryFragment,\n    init?: RequestInit,\n  ) =>\n    Effect.promise(() =>\n      this.mountedHttp.fetch(this.testConvex, pathQueryFragment, init),\n    );\n\n  readonly finishInProgressScheduledFunctions = () =>\n    Effect.promise(() => this.testConvex.finishInProgressScheduledFunctions());\n\n  readonly finishAllScheduledFunctions = (advanceTimers: () => void) =>\n    Effect.promise(() =>\n      this.testConvex.finishAllScheduledFunctions(advanceTimers),\n    );\n}\n\nclass TestConfectImpl<\n  ConfectSchema extends DatabaseSchema.AnyWithProps,\n> implements TestConfect<ConfectSchema> {\n  private readonly testConfectImplWithoutIdentity: TestConfectImplWithoutIdentity<ConfectSchema>;\n\n  constructor(\n    private confectSchema: ConfectSchema,\n    private testConvex: TestConvexForDataModelAndIdentity<\n      DataModel.ToConvex<DataModel.FromSchema<ConfectSchema>>\n    >,\n    private mountedHttp: ReturnType<typeof MountedHttp.make>,\n  ) {\n    this.testConfectImplWithoutIdentity = new TestConfectImplWithoutIdentity(\n      confectSchema,\n      testConvex,\n      mountedHttp,\n    );\n  }\n\n  readonly withIdentity = (userIdentity: Partial<UserIdentity>) =>\n    new TestConfectImplWithoutIdentity(\n      this.confectSchema,\n      this.testConvex.withIdentity(userIdentity),\n      this.mountedHttp,\n    );\n\n  readonly registerComponent: TestConfect<ConfectSchema>[\"registerComponent\"] =\n    Effect.fn(\"TestConfect.registerComponent\")(\n      (componentPath, schema, modules, options) =>\n        Effect.sync(() =>\n          this.mountedHttp.register(componentPath, schema, modules, options),\n        ),\n    );\n\n  readonly query = <QueryRef extends Ref.AnyQuery>(\n    queryRef: QueryRef,\n    ...args: Ref.OptionalArgs<QueryRef>\n  ) => this.testConfectImplWithoutIdentity.query(queryRef, ...args);\n\n  readonly mutation = <MutationRef extends Ref.AnyMutation>(\n    mutationRef: MutationRef,\n    ...args: Ref.OptionalArgs<MutationRef>\n  ) => this.testConfectImplWithoutIdentity.mutation(mutationRef, ...args);\n\n  readonly action = <ActionRef extends Ref.AnyAction>(\n    actionRef: ActionRef,\n    ...args: Ref.OptionalArgs<ActionRef>\n  ) => this.testConfectImplWithoutIdentity.action(actionRef, ...args);\n\n  readonly run: TestConfect<ConfectSchema>[\"run\"] = ((\n    handler: any,\n    returns?: any,\n  ) =>\n    this.testConfectImplWithoutIdentity.run(\n      handler,\n      returns,\n    )) as TestConfect<ConfectSchema>[\"run\"];\n\n  readonly fetch = <PathQueryFragment extends string>(\n    pathQueryFragment: PathQueryFragment,\n    init?: RequestInit,\n  ) => this.testConfectImplWithoutIdentity.fetch(pathQueryFragment, init);\n\n  readonly finishInProgressScheduledFunctions = () =>\n    this.testConfectImplWithoutIdentity.finishInProgressScheduledFunctions();\n\n  readonly finishAllScheduledFunctions = (advanceTimers: () => void) =>\n    this.testConfectImplWithoutIdentity.finishAllScheduledFunctions(\n      advanceTimers,\n    );\n}\n\n/**\n * How a test registers one installed component: its own schema and modules, or\n * the `register(t, name)` a component package exports from `<package>/testing`\n * or `<package>/test`, which also registers the package's own children.\n */\nexport type ComponentKit =\n  | {\n      readonly schema: SchemaDefinition<GenericSchema, boolean>;\n      readonly modules: Record<string, () => Promise<any>>;\n    }\n  | {\n      register(\n        t: { readonly registerComponent: RegisterComponent },\n        name: string,\n      ): unknown;\n    };\n\nclass InvalidComponentKit extends Schema.TaggedError<InvalidComponentKit>()(\n  \"InvalidComponentKit\",\n  { componentPath: Schema.String, message: Schema.String },\n) {}\n\nconst registerKit = (\n  registerComponent: RegisterComponent,\n  name: string,\n  kit: ComponentKit,\n) => {\n  if (\"register\" in kit) {\n    kit.register({ registerComponent }, name);\n  } else if (\"schema\" in kit && \"modules\" in kit) {\n    registerComponent(name, kit.schema, kit.modules);\n  } else {\n    // Codegen accepts a kit whose exports it cannot list, such as CommonJS.\n    throw new InvalidComponentKit({\n      componentPath: name,\n      message: `The test kit for ${JSON.stringify(name)} must export register(t, name), or schema and modules.`,\n    });\n  }\n};\n\n/**\n * Codegen's test-only schema and module registry.\n */\nexport type Registry<DatabaseSchema_ extends DatabaseSchema.AnyWithProps> = {\n  readonly schema: DatabaseSchema_;\n  readonly convexSchema: SchemaDefinition<GenericSchema, true>;\n  readonly modules: Record<string, () => Promise<any>>;\n  readonly components: Readonly<Record<string, ComponentKit>>;\n};\n\n/**\n * The declared app's generated, test-only representation.\n */\nexport type DeclaredApp<DatabaseSchema_ extends DatabaseSchema.AnyWithProps> =\n  Registry<DatabaseSchema_> & {\n    readonly httpMounts: ReadonlyArray<HttpMount>;\n  };\n\n/**\n * Build a fresh test backend from a declaration and its generated\n * `confect/_generated/testing` registry, without restating component mounts.\n * Pass `{ target: \"kernel\" }` to run it on Confect's test kernel instead of\n * convex-test.\n */\nexport function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(\n  app: DeclaredApp<DatabaseSchema_>,\n  options?: TargetOptions,\n): Layer.Layer<TestConfect<DatabaseSchema_>>;\nexport function layer<\n  A extends App.Any,\n  DatabaseSchema_ extends DatabaseSchema.AnyWithProps,\n>(\n  app: A,\n  registry: Registry<DatabaseSchema_> & {\n    readonly components: Readonly<\n      Record<\n        Mount.NameOf<NoInfer<A>[\"mounts\"][number]>,\n        Registry<DatabaseSchema_>[\"components\"][string]\n      >\n    >;\n  },\n  options?: TargetOptions,\n): Layer.Layer<TestConfect<DatabaseSchema_>>;\nexport function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(\n  databaseSchema: DatabaseSchema_,\n  convexSchemaDefinition: SchemaDefinition<GenericSchema, true>,\n  modules: Record<string, () => Promise<any>>,\n  options?: LayerOptions,\n): Layer.Layer<TestConfect<DatabaseSchema_>>;\nexport function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(\n  appOrSchema: App.Any | DeclaredApp<DatabaseSchema_> | DatabaseSchema_,\n  second?:\n    | Registry<DatabaseSchema_>\n    | SchemaDefinition<GenericSchema, true>\n    | TargetOptions,\n  third?: Record<string, () => Promise<any>> | TargetOptions,\n  options: LayerOptions = {},\n): Layer.Layer<TestConfect<DatabaseSchema_>> {\n  if (App.isApp(appOrSchema)) {\n    const registry = second as Registry<DatabaseSchema_>;\n    const mounts = App.mounts(appOrSchema);\n    return schemaLayer(\n      registry.schema,\n      registry.convexSchema,\n      registry.modules,\n      {\n        ...targetOf(third as TargetOptions | undefined),\n        httpMounts: mounts.flatMap(({ name, httpPrefix }) =>\n          httpPrefix === undefined ? [] : [{ componentPath: name, httpPrefix }],\n        ),\n        register: (registerComponent) => {\n          for (const [name, component] of Object.entries(registry.components)) {\n            if (\n              mounts.some(\n                (mount) =>\n                  name === mount.name || name.startsWith(`${mount.name}/`),\n              )\n            ) {\n              registerKit(registerComponent, name, component);\n            }\n          }\n        },\n      },\n    );\n  }\n  if (\"httpMounts\" in appOrSchema) {\n    const app = appOrSchema as DeclaredApp<DatabaseSchema_>;\n    return schemaLayer(app.schema, app.convexSchema, app.modules, {\n      ...targetOf(second as TargetOptions | undefined),\n      httpMounts: app.httpMounts,\n      register: (registerComponent) => {\n        for (const [name, component] of Object.entries(app.components)) {\n          registerKit(registerComponent, name, component);\n        }\n      },\n    });\n  }\n  return schemaLayer(\n    appOrSchema as DatabaseSchema_,\n    second as SchemaDefinition<GenericSchema, true>,\n    third as Record<string, () => Promise<any>>,\n    options,\n  );\n}\n\nconst targetOf = (options: TargetOptions | undefined): TargetOptions =>\n  options?.target === undefined ? {} : { target: options.target };\n\nconst schemaLayer = <DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(\n  databaseSchema: DatabaseSchema_,\n  convexSchemaDefinition: SchemaDefinition<GenericSchema, true>,\n  modules: Record<string, () => Promise<any>>,\n  options: LayerOptions = {},\n): Layer.Layer<TestConfect<DatabaseSchema_>> =>\n  Layer.sync(TestConfect<DatabaseSchema_>(), () => {\n    process.env.CONVEX_CLOUD_URL ??= \"https://some-deployment.convex.cloud\";\n    process.env.CONVEX_SITE_URL ??= \"https://some.convex.site\";\n    const testConvex = (options.target === \"kernel\" ? kernelTest : convexTest)(\n      convexSchemaDefinition,\n      modules,\n    );\n    // convex-test takes three arguments and ignores the options. The kernel\n    // reads `standing`.\n    const registerComponent =\n      testConvex.registerComponent as unknown as RegisterComponent;\n    const mountedHttp = MountedHttp.make(options.httpMounts ?? [], (...args) =>\n      registerComponent(...args),\n    );\n    options.register?.(mountedHttp.register);\n    return new TestConfectImpl(databaseSchema, testConvex as any, mountedHttp);\n  });\n"],"mappings":"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"}

package/dist/internal/Attempt.d.ts

@@ -0,0 +1,77 @@
+import type { Attempt as AttemptNumber } from "./Invocation.js";
+import * as Kernel from "./Kernel.js";
+import type { DocumentId, StoredDocument } from "./KernelValues.js";
+import type * as ReadSet from "./ReadSet.js";
+/**
+ * One frame of an attempt at a query or mutation: the committed state the
+ * attempt started from, its caller's frame and its own pending writes. The
+ * outermost frame belongs to the top-level function. Each nested mutation opens
+ * a child frame, which merges into its caller's frame when it returns and is
+ * dropped when it fails. Reads belong to the whole attempt and are never
+ * dropped: a failed nested mutation's reads stay in the attempt.
+ *
+ * Each frame has its own lifetime. A frame takes reads and writes until it is
+ * closed. A mutation's frame closes once its function has returned and no
+ * syscall it started is still running, so a write a detached fiber makes after
+ * the handler settled still lands in it, as on the binary. A nested mutation's
+ * frame closes before it merges into its caller's, so no write reaches it after
+ * its writes became its caller's.
+ *
+ * A frame belongs to one invocation, which alone writes to it, so a caller's
+ * write made while its nested mutation is in flight stays the caller's.
+ * `Kernel.apply` publishes the outermost frame's writes.
+ */
+export declare class KernelAttempt {
+    readonly snapshot: Kernel.State;
+    readonly number: AttemptNumber;
+    private readonly parent?;
+    private readonly overlay;
+    private readonly life;
+    private readonly allReads;
+    constructor(snapshot: Kernel.State, number?: AttemptNumber, parent?: KernelAttempt | undefined);
+    get reads(): ReadonlyArray<ReadSet.Read>;
+    get closed(): boolean;
+    readDocument(componentPath: string, id: DocumentId): void;
+    /**
+     * Record a read of an interval. The returned function advances how far the
+     * query examined it.
+     */
+    readInterval(read: Omit<ReadSet.IntervalRead, "through">): (through: ReadSet.Key | "end") => void;
+    /**
+     * A syscall began. `end` runs when it settles.
+     */
+    begin(): () => void;
+    /**
+     * Resolves once a whole turn of the event loop passes with no syscall of this
+     * frame running or started. A nested call is a syscall of its caller's frame
+     * until it has drained.
+     */
+    drained(): Promise<void>;
+    close(): void;
+    /**
+     * The pending writes this frame sees, from the outermost frame to this one.
+     */
+    private overlays;
+    get(componentPath: string, id: DocumentId): StoredDocument | null;
+    /**
+     * The table as this frame sees it, committed rows under every pending write
+     * from the outermost frame to this one.
+     */
+    scan(componentPath: string, tableName: string): Array<StoredDocument>;
+    write(componentPath: string, id: DocumentId, doc: StoredDocument | null): void;
+    /**
+     * A nested mutation begins, in a frame of its own. Dropping a failed one is
+     * forgetting it.
+     */
+    child(): KernelAttempt;
+    /**
+     * A nested mutation returned and its frame closed. Its writes become its
+     * caller's.
+     */
+    merge(): void;
+    /**
+     * The outermost frame's writes, for `Kernel.apply`.
+     */
+    writes(): Array<Kernel.Write>;
+}
+//# sourceMappingURL=Attempt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Attempt.d.ts","sourceRoot":"","sources":["../../src/internal/Attempt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAC;AAiB7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IAMtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAP1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgD;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAE/C,YACW,QAAQ,EAAE,MAAM,CAAC,KAAK,EACtB,MAAM,GAAE,aAAiB,EACjB,MAAM,CAAC,EAAE,aAAa,YAAA,EAGxC;IAED,IAAI,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAEvC;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,QAEjD;IAED;;;OAGG;IACH,YAAY,CACV,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,GAC1C,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,GAAG,KAAK,KAAK,IAAI,CAMxC;IAED;;OAEG;IACH,KAAK,IAAI,MAAM,IAAI,CAOlB;IAED;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvB;IAED,KAAK,SAEJ;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ;IAMhB,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAMhE;IAED;;;OAGG;IACH,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,CAAC,CAapE;IAED,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,QAItE;IAED;;;OAGG;IACH,KAAK,IAAI,aAAa,CAErB;IAED;;;OAGG;IACH,KAAK,SASJ;IAED;;OAEG;IACH,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAI5B;CACF"}

package/dist/internal/Attempt.js

@@ -0,0 +1,154 @@
+import { tableNameFromId } from "./KernelValues.js";
+import { get, rows } from "./Kernel.js";
+import { setImmediate } from "node:timers/promises";
+//#region src/internal/Attempt.ts
+/**
+* One frame of an attempt at a query or mutation: the committed state the
+* attempt started from, its caller's frame and its own pending writes. The
+* outermost frame belongs to the top-level function. Each nested mutation opens
+* a child frame, which merges into its caller's frame when it returns and is
+* dropped when it fails. Reads belong to the whole attempt and are never
+* dropped: a failed nested mutation's reads stay in the attempt.
+*
+* Each frame has its own lifetime. A frame takes reads and writes until it is
+* closed. A mutation's frame closes once its function has returned and no
+* syscall it started is still running, so a write a detached fiber makes after
+* the handler settled still lands in it, as on the binary. A nested mutation's
+* frame closes before it merges into its caller's, so no write reaches it after
+* its writes became its caller's.
+*
+* A frame belongs to one invocation, which alone writes to it, so a caller's
+* write made while its nested mutation is in flight stays the caller's.
+* `Kernel.apply` publishes the outermost frame's writes.
+*/
+var KernelAttempt = class KernelAttempt {
+	snapshot;
+	number;
+	parent;
+	overlay = /* @__PURE__ */ new Map();
+	life = {
+		running: 0,
+		started: 0,
+		open: true
+	};
+	allReads;
+	constructor(snapshot, number = 1, parent) {
+		this.snapshot = snapshot;
+		this.number = number;
+		this.parent = parent;
+		this.allReads = parent?.allReads ?? [];
+	}
+	get reads() {
+		return this.allReads;
+	}
+	get closed() {
+		return !this.life.open;
+	}
+	readDocument(componentPath, id) {
+		this.allReads.push({
+			kind: "document",
+			componentPath,
+			id
+		});
+	}
+	/**
+	* Record a read of an interval. The returned function advances how far the
+	* query examined it.
+	*/
+	readInterval(read) {
+		const interval = {
+			...read,
+			through: null
+		};
+		this.allReads.push(interval);
+		return (through) => {
+			interval.through = through;
+		};
+	}
+	/**
+	* A syscall began. `end` runs when it settles.
+	*/
+	begin() {
+		const life = this.life;
+		life.running++;
+		life.started++;
+		return () => {
+			life.running--;
+		};
+	}
+	/**
+	* Resolves once a whole turn of the event loop passes with no syscall of this
+	* frame running or started. A nested call is a syscall of its caller's frame
+	* until it has drained.
+	*/
+	drained() {
+		const before = this.life.started;
+		return setImmediate().then(() => this.life.running === 0 && this.life.started === before ? void 0 : this.drained());
+	}
+	close() {
+		this.life.open = false;
+	}
+	/**
+	* The pending writes this frame sees, from the outermost frame to this one.
+	*/
+	overlays() {
+		return this.parent === void 0 ? [this.overlay] : [...this.parent.overlays(), this.overlay];
+	}
+	get(componentPath, id) {
+		for (const overlay of this.overlays().toReversed()) {
+			const write = overlay.get(componentPath)?.get(id);
+			if (write !== void 0) return write;
+		}
+		return get(this.snapshot, componentPath, id)?.doc ?? null;
+	}
+	/**
+	* The table as this frame sees it, committed rows under every pending write
+	* from the outermost frame to this one.
+	*/
+	scan(componentPath, tableName) {
+		const ids = /* @__PURE__ */ new Set();
+		for (const row of rows(this.snapshot, componentPath, tableName)) ids.add(row.doc._id);
+		for (const overlay of this.overlays()) for (const id of overlay.get(componentPath)?.keys() ?? []) if (tableNameFromId(id) === tableName) ids.add(id);
+		const docs = [];
+		for (const id of ids) {
+			const doc = this.get(componentPath, id);
+			if (doc !== null) docs.push(doc);
+		}
+		return docs;
+	}
+	write(componentPath, id, doc) {
+		const writes = this.overlay.get(componentPath) ?? /* @__PURE__ */ new Map();
+		this.overlay.set(componentPath, writes);
+		writes.set(id, doc);
+	}
+	/**
+	* A nested mutation begins, in a frame of its own. Dropping a failed one is
+	* forgetting it.
+	*/
+	child() {
+		return new KernelAttempt(this.snapshot, this.number, this);
+	}
+	/**
+	* A nested mutation returned and its frame closed. Its writes become its
+	* caller's.
+	*/
+	merge() {
+		if (this.parent === void 0) throw new Error("The outermost frame of an attempt has no caller.");
+		if (this.life.open) throw new Error("A nested mutation's frame merges only once closed.");
+		for (const [componentPath, writes] of this.overlay) for (const [id, doc] of writes) this.parent.write(componentPath, id, doc);
+	}
+	/**
+	* The outermost frame's writes, for `Kernel.apply`.
+	*/
+	writes() {
+		return Array.from(this.overlay, ([componentPath, writes]) => Array.from(writes, ([id, doc]) => ({
+			componentPath,
+			id,
+			doc
+		}))).flat();
+	}
+};
+//#endregion
+export { KernelAttempt };
+
+//# sourceMappingURL=Attempt.js.map

package/dist/internal/Attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Attempt.js","names":["Kernel.get","Kernel.rows"],"sources":["../../src/internal/Attempt.ts"],"sourcesContent":["// oxlint-disable-next-line effecttsgo/node-builtin-import, no-restricted-imports -- An attempt's drain waits one real turn of the event loop, which is no deadline. Fake timers in a test replace the global `setImmediate`, not this one.\nimport { setImmediate } from \"node:timers/promises\";\nimport type { Attempt as AttemptNumber } from \"./Invocation.js\";\nimport * as Kernel from \"./Kernel.js\";\nimport type { DocumentId, StoredDocument } from \"./KernelValues.js\";\nimport { tableNameFromId } from \"./KernelValues.js\";\nimport type * as ReadSet from \"./ReadSet.js\";\n\n/**\n * Pending writes, keyed by component path, then document ID. `null` deletes.\n */\ntype Overlay = Map<string, Map<DocumentId, StoredDocument | null>>;\n\n/**\n * How long one frame takes syscalls: those it has running, those it has\n * started, and whether it still takes them.\n */\ninterface Life {\n  running: number;\n  started: number;\n  open: boolean;\n}\n\n/**\n * One frame of an attempt at a query or mutation: the committed state the\n * attempt started from, its caller's frame and its own pending writes. The\n * outermost frame belongs to the top-level function. Each nested mutation opens\n * a child frame, which merges into its caller's frame when it returns and is\n * dropped when it fails. Reads belong to the whole attempt and are never\n * dropped: a failed nested mutation's reads stay in the attempt.\n *\n * Each frame has its own lifetime. A frame takes reads and writes until it is\n * closed. A mutation's frame closes once its function has returned and no\n * syscall it started is still running, so a write a detached fiber makes after\n * the handler settled still lands in it, as on the binary. A nested mutation's\n * frame closes before it merges into its caller's, so no write reaches it after\n * its writes became its caller's.\n *\n * A frame belongs to one invocation, which alone writes to it, so a caller's\n * write made while its nested mutation is in flight stays the caller's.\n * `Kernel.apply` publishes the outermost frame's writes.\n */\nexport class KernelAttempt {\n  private readonly overlay: Overlay = new Map();\n  private readonly life: Life = { running: 0, started: 0, open: true };\n  private readonly allReads: Array<ReadSet.Read>;\n\n  constructor(\n    readonly snapshot: Kernel.State,\n    readonly number: AttemptNumber = 1,\n    private readonly parent?: KernelAttempt,\n  ) {\n    this.allReads = parent?.allReads ?? [];\n  }\n\n  get reads(): ReadonlyArray<ReadSet.Read> {\n    return this.allReads;\n  }\n\n  get closed(): boolean {\n    return !this.life.open;\n  }\n\n  readDocument(componentPath: string, id: DocumentId) {\n    this.allReads.push({ kind: \"document\", componentPath, id });\n  }\n\n  /**\n   * Record a read of an interval. The returned function advances how far the\n   * query examined it.\n   */\n  readInterval(\n    read: Omit<ReadSet.IntervalRead, \"through\">,\n  ): (through: ReadSet.Key | \"end\") => void {\n    const interval: ReadSet.IntervalRead = { ...read, through: null };\n    this.allReads.push(interval);\n    return (through) => {\n      interval.through = through;\n    };\n  }\n\n  /**\n   * A syscall began. `end` runs when it settles.\n   */\n  begin(): () => void {\n    const life = this.life;\n    life.running++;\n    life.started++;\n    return () => {\n      life.running--;\n    };\n  }\n\n  /**\n   * Resolves once a whole turn of the event loop passes with no syscall of this\n   * frame running or started. A nested call is a syscall of its caller's frame\n   * until it has drained.\n   */\n  drained(): Promise<void> {\n    const before = this.life.started;\n    return setImmediate().then(() =>\n      this.life.running === 0 && this.life.started === before\n        ? undefined\n        : this.drained(),\n    );\n  }\n\n  close() {\n    this.life.open = false;\n  }\n\n  /**\n   * The pending writes this frame sees, from the outermost frame to this one.\n   */\n  private overlays(): Array<Overlay> {\n    return this.parent === undefined\n      ? [this.overlay]\n      : [...this.parent.overlays(), this.overlay];\n  }\n\n  get(componentPath: string, id: DocumentId): StoredDocument | null {\n    for (const overlay of this.overlays().toReversed()) {\n      const write = overlay.get(componentPath)?.get(id);\n      if (write !== undefined) return write;\n    }\n    return Kernel.get(this.snapshot, componentPath, id)?.doc ?? null;\n  }\n\n  /**\n   * The table as this frame sees it, committed rows under every pending write\n   * from the outermost frame to this one.\n   */\n  scan(componentPath: string, tableName: string): Array<StoredDocument> {\n    const ids = new Set<DocumentId>();\n    for (const row of Kernel.rows(this.snapshot, componentPath, tableName))\n      ids.add(row.doc._id);\n    for (const overlay of this.overlays())\n      for (const id of overlay.get(componentPath)?.keys() ?? [])\n        if (tableNameFromId(id) === tableName) ids.add(id);\n    const docs: Array<StoredDocument> = [];\n    for (const id of ids) {\n      const doc = this.get(componentPath, id);\n      if (doc !== null) docs.push(doc);\n    }\n    return docs;\n  }\n\n  write(componentPath: string, id: DocumentId, doc: StoredDocument | null) {\n    const writes = this.overlay.get(componentPath) ?? new Map();\n    this.overlay.set(componentPath, writes);\n    writes.set(id, doc);\n  }\n\n  /**\n   * A nested mutation begins, in a frame of its own. Dropping a failed one is\n   * forgetting it.\n   */\n  child(): KernelAttempt {\n    return new KernelAttempt(this.snapshot, this.number, this);\n  }\n\n  /**\n   * A nested mutation returned and its frame closed. Its writes become its\n   * caller's.\n   */\n  merge() {\n    if (this.parent === undefined) {\n      throw new Error(\"The outermost frame of an attempt has no caller.\");\n    }\n    if (this.life.open) {\n      throw new Error(\"A nested mutation's frame merges only once closed.\");\n    }\n    for (const [componentPath, writes] of this.overlay)\n      for (const [id, doc] of writes) this.parent.write(componentPath, id, doc);\n  }\n\n  /**\n   * The outermost frame's writes, for `Kernel.apply`.\n   */\n  writes(): Array<Kernel.Write> {\n    return Array.from(this.overlay, ([componentPath, writes]) =>\n      Array.from(writes, ([id, doc]) => ({ componentPath, id, doc })),\n    ).flat();\n  }\n}\n"],"mappings":"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"}

package/dist/internal/Clock.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Convex pins `Date` inside a query or mutation to the time it started, and its
+ * scheduler reads `Date.now()` for `runAfter`. The kernel wraps the realm's
+ * `Date` so it answers a kernel invocation's time inside one and the host's
+ * everywhere else. It sets no host timer.
+ */
+type DateConstructor = typeof globalThis.Date;
+/**
+ * Wrap the realm's current `Date`, unless the kernel already did. `pinned`
+ * answers the running invocation's time, or `undefined` outside one, and
+ * `inside` says whether one is running. The first install's callbacks answer
+ * for every later one, as with `globalThis.Convex`. A test that fakes `Date`
+ * replaces the wrapper while the fake is installed, and the next install wraps
+ * the `Date` the test restores.
+ */
+export declare const install: (pinned: () => number | undefined, inside: () => boolean) => void;
+/**
+ * Whether `date` is the kernel's wrapper inside a running kernel invocation, so
+ * it already answers that invocation's time on the kernel's clock.
+ */
+export declare const answersInvocation: (date: DateConstructor) => boolean;
+/**
+ * The host's time in milliseconds, never a kernel invocation's: the real clock,
+ * or a test's fake one while it is installed. It reads the test environment's
+ * `Date`, never the copy a bound handler pinned.
+ */
+export declare const hostNow: () => number;
+export {};
+//# sourceMappingURL=Clock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.d.ts","sourceRoot":"","sources":["../../src/internal/Clock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,KAAK,eAAe,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AA6C9C;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,WACV,MAAM,MAAM,GAAG,SAAS,UACxB,MAAM,OAAO,SAStB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,SAAU,eAAe,KAAG,OAGzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,QAAO,MAKvB,CAAC"}

package/dist/internal/Clock.js

@@ -0,0 +1,66 @@
+import { host } from "./Globals.js";
+//#region src/internal/Clock.ts
+/**
+* Convex pins `Date` inside a query or mutation to the time it started, and its
+* scheduler reads `Date.now()` for `runAfter`. The kernel wraps the realm's
+* `Date` so it answers a kernel invocation's time inside one and the host's
+* everywhere else. It sets no host timer.
+*/
+const key = Symbol.for("@confect/test/Clock");
+const wrap = (base, pinned) => {
+	const proxy = new Proxy(base, {
+		get: (target, property) => property === "now" ? () => pinned() ?? target.now() : Reflect.get(target, property, target),
+		construct: (target, args, newTarget) => {
+			const at = args.length === 0 ? pinned() : void 0;
+			return Reflect.construct(target, at === void 0 ? args : [at], newTarget === proxy ? target : newTarget);
+		},
+		apply: (target, self, args) => {
+			const at = pinned();
+			return at === void 0 ? Reflect.apply(target, self, args) : new target(at).toString();
+		}
+	});
+	return proxy;
+};
+/**
+* Wrap the realm's current `Date`, unless the kernel already did. `pinned`
+* answers the running invocation's time, or `undefined` outside one, and
+* `inside` says whether one is running. The first install's callbacks answer
+* for every later one, as with `globalThis.Convex`. A test that fakes `Date`
+* replaces the wrapper while the fake is installed, and the next install wraps
+* the `Date` the test restores.
+*/
+const install = (pinned, inside) => {
+	const global = globalThis;
+	const state = global[key] ??= {
+		bases: /* @__PURE__ */ new WeakMap(),
+		pinned,
+		inside
+	};
+	const current = global.Date;
+	if (state.bases.has(current)) return;
+	const wrapper = wrap(current, () => state.pinned());
+	state.bases.set(wrapper, current);
+	global.Date = wrapper;
+};
+/**
+* Whether `date` is the kernel's wrapper inside a running kernel invocation, so
+* it already answers that invocation's time on the kernel's clock.
+*/
+const answersInvocation = (date) => {
+	const state = globalThis[key];
+	return state !== void 0 && state.bases.has(date) && state.inside();
+};
+/**
+* The host's time in milliseconds, never a kernel invocation's: the real clock,
+* or a test's fake one while it is installed. It reads the test environment's
+* `Date`, never the copy a bound handler pinned.
+*/
+const hostNow = () => host(() => {
+	const global = globalThis;
+	const current = global.Date;
+	return (global[key]?.bases.get(current) ?? current).now();
+});
+//#endregion
+export { answersInvocation, hostNow, install };
+
+//# sourceMappingURL=Clock.js.map