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

package/dist/TestConfect.d.ts

@@ -1,17 +1,28 @@
 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 = (...args: Parameters<TestConvexForDataModelAndIdentity<GenericDataModel>["registerComponent"]>) => void;
+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,7 +66,7 @@ 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>>;
@@ -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<Mount.NameOf<NoInfer<A>["mounts"][number]>, Registry<DatabaseSchema_>["components"][string]>>;
-}): Layer.Layer<TestConfect<DatabaseSchema_>>;
+}, 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);
@@ -66,11 +67,12 @@ const registerKit = (registerComponent, name, kit) => {
 		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
@@ -83,19 +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(), () => {
 	process.env.CONVEX_CLOUD_URL ??= "https://some-deployment.convex.cloud";
 	process.env.CONVEX_SITE_URL ??= "https://some.convex.site";
-	const testConvex = convexTest(convexSchemaDefinition, modules);
-	const mountedHttp = make(options.httpMounts ?? [], (...args) => testConvex.registerComponent(...args));
+	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, 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  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\ndeclare const process: { env: Record<string, string | undefined> };\n\n/**\n * Register a component's Convex schema and modules at its installation path.\n */\nexport type RegisterComponent = (\n  ...args: Parameters<\n    TestConvexForDataModelAndIdentity<GenericDataModel>[\"registerComponent\"]\n  >\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\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>/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 */\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        Mount.NameOf<NoInfer<A>[\"mounts\"][number]>,\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    process.env.CONVEX_CLOUD_URL ??= \"https://some-deployment.convex.cloud\";\n    process.env.CONVEX_SITE_URL ??= \"https://some.convex.site\";\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":";;;;;;;;;;;;;;;AAgJA,MAAa,oBAEN,QAAQ,QAAoC,2BAA2B;AAE9E,IAAM,iCAAN,MAEuD;CAE3C;CACA;CAGA;CALV,YACE,eACA,YAGA,aACA;EALQ,KAAA,gBAAA;EACA,KAAA,aAAA;EAGA,KAAA,cAAA;CACP;CAEH,SACE,UACA,GAAG,SAKH,IAAI,aACF,UACC,KAAK,MAAM,CAAC,IACZ,mBAAmB,gBAClB,KAAK,WAAW,MAAM,mBAA0B,WAAW,CAC/D;CAEF,YACE,aACA,GAAG,SAKH,IAAI,aACF,aACC,KAAK,MAAM,CAAC,IACZ,mBAAmB,gBAClB,KAAK,WAAW,SAAS,mBAA0B,WAAW,CAClE;CAEF,UACE,WACA,GAAG,SAKH,IAAI,aACF,WACC,KAAK,MAAM,CAAC,IACZ,mBAAmB,gBAClB,KAAK,WAAW,OAAO,mBAA0B,WAAW,CAChE;CAEF,QAKE,SAKA,YAC+D;EAC/D,MAAM,qBACJ,gBAIA,yBAAyB,cACvB,KAAK,eACL,WACF;EAIF,OAAO,YAAY,KAAA,IACf,OAAO,cACL,KAAK,WAAW,KAAK,gBACnB,OAAO,WACL,QAAQ,KACN,OAAO,QACP,OAAO,QAAQ,kBAAkB,WAAW,CAAC,CAC/C,CACF,CACF,CACF,IACA,OAAO,cACL,KAAK,WAAW,KAAK,gBACnB,OAAO,WACL,QAAQ,KACN,OAAO,QAAQ,OAAO,aAAa,OAAO,CAAC,GAC3C,OAAO,QAAQ,kBAAkB,WAAW,CAAC,CAC/C,CACF,CACF,CACF,CAAC,CAAC,KAAK,OAAO,QAAQ,OAAO,aAAa,OAAO,CAAC,CAAC;CACzD;CAEA,SACE,mBACA,SAEA,OAAO,cACL,KAAK,YAAY,MAAM,KAAK,YAAY,mBAAmB,IAAI,CACjE;CAEF,2CACE,OAAO,cAAc,KAAK,WAAW,mCAAmC,CAAC;CAE3E,+BAAwC,kBACtC,OAAO,cACL,KAAK,WAAW,4BAA4B,aAAa,CAC3D;AACJ;AAEA,IAAM,kBAAN,MAEwC;CAI5B;CACA;CAGA;CAPV;CAEA,YACE,eACA,YAGA,aACA;EALQ,KAAA,gBAAA;EACA,KAAA,aAAA;EAGA,KAAA,cAAA;EAER,KAAK,iCAAiC,IAAI,+BACxC,eACA,YACA,WACF;CACF;CAEA,gBAAyB,iBACvB,IAAI,+BACF,KAAK,eACL,KAAK,WAAW,aAAa,YAAY,GACzC,KAAK,WACP;CAEF,oBACE,OAAO,GAAG,+BAA+B,CAAC,EACvC,eAAe,QAAQ,SAAS,YAC/B,OAAO,WACL,KAAK,YAAY,SAAS,eAAe,QAAQ,SAAS,OAAO,CACnE,CACJ;CAEF,SACE,UACA,GAAG,SACA,KAAK,+BAA+B,MAAM,UAAU,GAAG,IAAI;CAEhE,YACE,aACA,GAAG,SACA,KAAK,+BAA+B,SAAS,aAAa,GAAG,IAAI;CAEtE,UACE,WACA,GAAG,SACA,KAAK,+BAA+B,OAAO,WAAW,GAAG,IAAI;CAElE,QACE,SACA,YAEA,KAAK,+BAA+B,IAClC,SACA,OACF;CAEF,SACE,mBACA,SACG,KAAK,+BAA+B,MAAM,mBAAmB,IAAI;CAEtE,2CACE,KAAK,+BAA+B,mCAAmC;CAEzE,+BAAwC,kBACtC,KAAK,+BAA+B,4BAClC,aACF;AACJ;AAmBA,IAAM,sBAAN,cAAkC,OAAO,YAAiC,CAAC,CACzE,uBACA;CAAE,eAAe,OAAO;CAAQ,SAAS,OAAO;AAAO,CACzD,CAAC,CAAC,CAAC;AAEH,MAAM,eACJ,mBACA,MACA,QACG;CACH,IAAI,cAAc,KAChB,IAAI,SAAS,EAAE,kBAAkB,GAAG,IAAI;MACnC,IAAI,YAAY,OAAO,aAAa,KACzC,kBAAkB,MAAM,IAAI,QAAQ,IAAI,OAAO;MAG/C,MAAM,IAAI,oBAAoB;EAC5B,eAAe;EACf,SAAS,oBAAoB,KAAK,UAAU,IAAI,EAAE;CACpD,CAAC;AAEL;AAmDA,SAAgB,MACd,aACA,QAIA,OACA,UAAwB,CAAC,GACkB;CAC3C,IAAI,IAAI,MAAM,WAAW,GAAG;EAC1B,MAAM,WAAW;EACjB,MAAM,SAAS,IAAI,OAAO,WAAW;EACrC,OAAO,YACL,SAAS,QACT,SAAS,cACT,SAAS,SACT;GACE,GAAG,SAAS,KAAkC;GAC9C,YAAY,OAAO,SAAS,EAAE,MAAM,iBAClC,eAAe,KAAA,IAAY,CAAC,IAAI,CAAC;IAAE,eAAe;IAAM;GAAW,CAAC,CACtE;GACA,WAAW,sBAAsB;IAC/B,KAAK,MAAM,CAAC,MAAM,cAAc,OAAO,QAAQ,SAAS,UAAU,GAChE,IACE,OAAO,MACJ,UACC,SAAS,MAAM,QAAQ,KAAK,WAAW,GAAG,MAAM,KAAK,EAAE,CAC3D,GAEA,YAAY,mBAAmB,MAAM,SAAS;GAGpD;EACF,CACF;CACF;CACA,IAAI,gBAAgB,aAAa;EAC/B,MAAM,MAAM;EACZ,OAAO,YAAY,IAAI,QAAQ,IAAI,cAAc,IAAI,SAAS;GAC5D,GAAG,SAAS,MAAmC;GAC/C,YAAY,IAAI;GAChB,WAAW,sBAAsB;IAC/B,KAAK,MAAM,CAAC,MAAM,cAAc,OAAO,QAAQ,IAAI,UAAU,GAC3D,YAAY,mBAAmB,MAAM,SAAS;GAElD;EACF,CAAC;CACH;CACA,OAAO,YACL,aACA,QACA,OACA,OACF;AACF;AAEA,MAAM,YAAY,YAChB,SAAS,WAAW,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ,QAAQ,OAAO;AAEhE,MAAM,eACJ,gBACA,wBACA,SACA,UAAwB,CAAC,MAEzB,MAAM,KAAK,YAA6B,SAAS;CAC/C,QAAQ,IAAI,qBAAqB;CACjC,QAAQ,IAAI,oBAAoB;CAChC,MAAM,cAAc,QAAQ,WAAW,WAAWA,eAAa,WAAA,CAC7D,wBACA,OACF;CAGA,MAAM,oBACJ,WAAW;CACb,MAAM,cAAcC,KAAiB,QAAQ,cAAc,CAAC,IAAI,GAAG,SACjE,kBAAkB,GAAG,IAAI,CAC3B;CACA,QAAQ,WAAW,YAAY,QAAQ;CACvC,OAAO,IAAI,gBAAgB,gBAAgB,YAAmB,WAAW;AAC3E,CAAC"}

package/dist/internal/Attempt.js.map

@@ -1 +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 -- The drain waits a real turn of the event loop. 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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"}
+{"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

package/dist/internal/Clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Clock.js","names":["Globals.host"],"sources":["../../src/internal/Clock.ts"],"sourcesContent":["/**\n * Convex pins `Date` inside a query or mutation to the time it started, and its\n * scheduler reads `Date.now()` for `runAfter`. The kernel wraps the realm's\n * `Date` so it answers a kernel invocation's time inside one and the host's\n * everywhere else. It sets no host timer.\n */\n\nimport * as Globals from \"./Globals.js\";\n\ntype DateConstructor = typeof globalThis.Date;\n\ninterface State {\n  /**\n   * Each wrapper the kernel installed, and the `Date` it wraps.\n   */\n  readonly bases: WeakMap<DateConstructor, DateConstructor>;\n  readonly pinned: () => number | undefined;\n  /**\n   * Whether a kernel invocation is running, without reading its time.\n   */\n  readonly inside: () => boolean;\n}\n\nconst key = Symbol.for(\"@confect/test/Clock\");\n\ntype Global = { [key]?: State; Date: DateConstructor };\n\nconst wrap = (\n  base: DateConstructor,\n  pinned: () => number | undefined,\n): DateConstructor => {\n  const proxy: DateConstructor = new Proxy(base, {\n    get: (target, property) =>\n      property === \"now\"\n        ? () => pinned() ?? target.now()\n        : Reflect.get(target, property, target),\n    construct: (target, args, newTarget) => {\n      const at = args.length === 0 ? pinned() : undefined;\n      return Reflect.construct(\n        target,\n        at === undefined ? args : [at],\n        newTarget === proxy ? target : newTarget,\n      );\n    },\n    apply: (target, self, args) => {\n      const at = pinned();\n      return at === undefined\n        ? Reflect.apply(target, self, args)\n        : new target(at).toString();\n    },\n  });\n  return proxy;\n};\n\n/**\n * Wrap the realm's current `Date`, unless the kernel already did. `pinned`\n * answers the running invocation's time, or `undefined` outside one, and\n * `inside` says whether one is running. The first install's callbacks answer\n * for every later one, as with `globalThis.Convex`. A test that fakes `Date`\n * replaces the wrapper while the fake is installed, and the next install wraps\n * the `Date` the test restores.\n */\nexport const install = (\n  pinned: () => number | undefined,\n  inside: () => boolean,\n) => {\n  const global = globalThis as Global;\n  const state = (global[key] ??= { bases: new WeakMap(), pinned, inside });\n  const current = global.Date;\n  if (state.bases.has(current)) return;\n  const wrapper = wrap(current, () => state.pinned());\n  state.bases.set(wrapper, current);\n  global.Date = wrapper;\n};\n\n/**\n * Whether `date` is the kernel's wrapper inside a running kernel invocation, so\n * it already answers that invocation's time on the kernel's clock.\n */\nexport const answersInvocation = (date: DateConstructor): boolean => {\n  const state = (globalThis as Global)[key];\n  return state !== undefined && state.bases.has(date) && state.inside();\n};\n\n/**\n * The host's time in milliseconds, never a kernel invocation's: the real clock,\n * or a test's fake one while it is installed. It reads the test environment's\n * `Date`, never the copy a bound handler pinned.\n */\nexport const hostNow = (): number =>\n  Globals.host(() => {\n    const global = globalThis as Global;\n    const current = global.Date;\n    return (global[key]?.bases.get(current) ?? current).now();\n  });\n"],"mappings":";;;;;;;;AAuBA,MAAM,MAAM,OAAO,IAAI,qBAAqB;AAI5C,MAAM,QACJ,MACA,WACoB;CACpB,MAAM,QAAyB,IAAI,MAAM,MAAM;EAC7C,MAAM,QAAQ,aACZ,aAAa,cACH,OAAO,KAAK,OAAO,IAAI,IAC7B,QAAQ,IAAI,QAAQ,UAAU,MAAM;EAC1C,YAAY,QAAQ,MAAM,cAAc;GACtC,MAAM,KAAK,KAAK,WAAW,IAAI,OAAO,IAAI,KAAA;GAC1C,OAAO,QAAQ,UACb,QACA,OAAO,KAAA,IAAY,OAAO,CAAC,EAAE,GAC7B,cAAc,QAAQ,SAAS,SACjC;EACF;EACA,QAAQ,QAAQ,MAAM,SAAS;GAC7B,MAAM,KAAK,OAAO;GAClB,OAAO,OAAO,KAAA,IACV,QAAQ,MAAM,QAAQ,MAAM,IAAI,IAChC,IAAI,OAAO,EAAE,CAAC,CAAC,SAAS;EAC9B;CACF,CAAC;CACD,OAAO;AACT;;;;;;;;;AAUA,MAAa,WACX,QACA,WACG;CACH,MAAM,SAAS;CACf,MAAM,QAAS,OAAO,SAAS;EAAE,uBAAO,IAAI,QAAQ;EAAG;EAAQ;CAAO;CACtE,MAAM,UAAU,OAAO;CACvB,IAAI,MAAM,MAAM,IAAI,OAAO,GAAG;CAC9B,MAAM,UAAU,KAAK,eAAe,MAAM,OAAO,CAAC;CAClD,MAAM,MAAM,IAAI,SAAS,OAAO;CAChC,OAAO,OAAO;AAChB;;;;;AAMA,MAAa,qBAAqB,SAAmC;CACnE,MAAM,QAAS,WAAsB;CACrC,OAAO,UAAU,KAAA,KAAa,MAAM,MAAM,IAAI,IAAI,KAAK,MAAM,OAAO;AACtE;;;;;;AAOA,MAAa,gBACXA,WAAmB;CACjB,MAAM,SAAS;CACf,MAAM,UAAU,OAAO;CACvB,QAAQ,OAAO,IAAI,EAAE,MAAM,IAAI,OAAO,KAAK,QAAA,CAAS,IAAI;AAC1D,CAAC"}

package/dist/internal/ConvexTest.d.ts

@@ -1,6 +1,7 @@
 import type { GenericSchema, SchemaDefinition } from "convex/server";
 import * as Execution from "./Execution.js";
 import type * as Kernel from "./Kernel.js";
+import type * as Scheduling from "./Scheduling.js";
 type Modules = Record<string, () => Promise<any>>;
 /**
  * What the kernel adds to convex-test's surface, typed. The shim itself returns
@@ -13,6 +14,36 @@ export interface KernelControls {
     readonly prepare: (reference: any, args?: any) => Promise<Execution.HeldAttempt>;
     readonly apply: (id: string) => Promise<Execution.KernelApply>;
     readonly held: () => ReadonlyArray<Execution.HeldAttempt>;
+    /**
+     * Move the kernel's clock forward, running each job due on the way at its
+     * deadline.
+     */
+    readonly advance: (ms: number) => Promise<void>;
+    /**
+     * The pending jobs, earliest deadline first.
+     */
+    readonly jobs: () => ReadonlyArray<Scheduling.Job>;
+    /**
+     * Run the jobs due now. No future deadline is crossed.
+     */
+    readonly finishInProgressScheduledFunctions: () => Promise<void>;
+    /**
+     * Run jobs at their deadlines until only standing jobs remain, or fail with
+     * `DrainBudgetExceeded` after `maxIterations` jobs. The kernel keeps its own
+     * clock, so it never calls `advanceTimers`.
+     */
+    readonly finishAllScheduledFunctions: (advanceTimers?: () => void, maxIterations?: number) => Promise<void>;
+}
+/**
+ * How a kit registers a component beyond its schema and modules.
+ */
+export interface RegisterOptions {
+    /**
+     * The component's functions, as `module:export`, that schedule their own next
+     * run, such as the crons component's `public:rescheduler`. A job that runs
+     * one, or that one schedules, is never drain work.
+     */
+    readonly standing?: ReadonlyArray<string>;
 }
 /**
  * The test kernel under convex-test's `convexTest` signature. The fork's kernel
@@ -22,7 +53,8 @@ export interface KernelControls {
  * Beyond convex-test, `prepare` runs a mutation to its commit point and holds
  * it, and `apply` validates and publishes a held attempt. `mutation` applies
  * each attempt it prepares at once and prepares the next on a conflict, up to
- * attempt 5. `runtime` supplies the clock and commit timestamps.
+ * attempt 5. `runtime` supplies the clock and commit timestamps. Scheduled
+ * functions run on the kernel's clock, never on a host timer.
  */
 export declare function convexTest(schemaOrOptions?: SchemaDefinition<GenericSchema, boolean> | {
     readonly schema?: SchemaDefinition<GenericSchema, boolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"ConvexTest.d.ts","sourceRoot":"","sources":["../../src/internal/ConvexTest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEjB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAC;AAG3C,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAChB,SAAS,EAAE,GAAG,EACd,IAAI,CAAC,EAAE,GAAG,KACP,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;CAC3D;AAyCD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,eAAe,CAAC,EACZ,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GACxC;IACE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC;CACzC,EACL,OAAO,CAAC,EAAE,OAAO,GAChB,GAAG,CA8BL"}
+{"version":3,"file":"ConvexTest.d.ts","sourceRoot":"","sources":["../../src/internal/ConvexTest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAEjB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAEnD,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9D,QAAQ,CAAC,OAAO,EAAE,CAChB,SAAS,EAAE,GAAG,EACd,IAAI,CAAC,EAAE,GAAG,KACP,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC1D;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnD;;OAEG;IACH,QAAQ,CAAC,kCAAkC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,2BAA2B,EAAE,CACpC,aAAa,CAAC,EAAE,MAAM,IAAI,EAC1B,aAAa,CAAC,EAAE,MAAM,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC3C;AA4CD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,eAAe,CAAC,EACZ,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,GACxC;IACE,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC;CACzC,EACL,OAAO,CAAC,EAAE,OAAO,GAChB,GAAG,CAoCL"}

package/dist/internal/ConvexTest.js

@@ -20,8 +20,10 @@ const accessor = (world, caller) => ({
 	}),
 	fetch: () => Promise.reject(rowPending("HTTP routes", 6)),
 	jwks: () => Promise.reject(rowPending("JWT verification", 6)),
-	finishInProgressScheduledFunctions: () => Promise.reject(rowPending("the scheduler", 5)),
-	finishAllScheduledFunctions: () => Promise.reject(rowPending("the scheduler", 5))
+	advance: (ms) => world.advance(ms),
+	jobs: () => world.jobs(),
+	finishInProgressScheduledFunctions: () => world.advance(0),
+	finishAllScheduledFunctions: (_advanceTimers, maxIterations) => world.drain(maxIterations)
 });
 /**
 * The test kernel under convex-test's `convexTest` signature. The fork's kernel
@@ -31,7 +33,8 @@ const accessor = (world, caller) => ({
 * Beyond convex-test, `prepare` runs a mutation to its commit point and holds
 * it, and `apply` validates and publishes a held attempt. `mutation` applies
 * each attempt it prepares at once and prepares the next on a conflict, up to
-* attempt 5. `runtime` supplies the clock and commit timestamps.
+* attempt 5. `runtime` supplies the clock and commit timestamps. Scheduled
+* functions run on the kernel's clock, never on a host timer.
 */
 function convexTest(schemaOrOptions, modules) {
 	let schema;
@@ -47,8 +50,8 @@ function convexTest(schemaOrOptions, modules) {
 	const world = new World(schema, modules, runtime);
 	return {
 		...accessor(world, anonymous),
-		registerComponent: (componentPath, componentSchema, componentModules) => {
-			world.register(componentPath, componentSchema, componentModules);
+		registerComponent: (componentPath, componentSchema, componentModules, options) => {
+			world.register(componentPath, componentSchema, componentModules, options?.standing);
 			return componentsGeneric()[componentPath];
 		}
 	};

package/dist/internal/ConvexTest.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConvexTest.js","names":["Execution.withIdentity","KernelRefusal.rowPending","Execution.World","Execution.anonymous"],"sources":["../../src/internal/ConvexTest.ts"],"sourcesContent":["import type {\n  GenericSchema,\n  SchemaDefinition,\n  UserIdentity,\n} from \"convex/server\";\nimport { componentsGeneric } from \"convex/server\";\nimport * as Execution from \"./Execution.js\";\nimport type * as Kernel from \"./Kernel.js\";\nimport * as KernelRefusal from \"./KernelRefusal.js\";\n\ntype Modules = Record<string, () => Promise<any>>;\n\n/**\n * What the kernel adds to convex-test's surface, typed. The shim itself returns\n * `any`, as convex-test's callers expect.\n */\nexport interface KernelControls {\n  readonly query: (reference: any, args?: any) => Promise<any>;\n  readonly mutation: (reference: any, args?: any) => Promise<any>;\n  readonly action: (reference: any, args?: any) => Promise<any>;\n  readonly prepare: (\n    reference: any,\n    args?: any,\n  ) => Promise<Execution.HeldAttempt>;\n  readonly apply: (id: string) => Promise<Execution.KernelApply>;\n  readonly held: () => ReadonlyArray<Execution.HeldAttempt>;\n}\n\nconst isSchemaDefinition = (\n  value: unknown,\n): value is SchemaDefinition<GenericSchema, boolean> =>\n  value !== null &&\n  typeof value === \"object\" &&\n  \"tables\" in value &&\n  typeof (value as { tables: unknown }).tables === \"object\";\n\nconst accessor = (world: Execution.World, caller: Execution.Caller): any => ({\n  query: (reference: any, args?: any) => world.query(caller, reference, args),\n  mutation: (reference: any, args?: any) =>\n    world.mutation(caller, reference, args),\n  action: (reference: any, args?: any) => world.action(caller, reference, args),\n  prepare: (reference: any, args?: any) =>\n    world.prepare(caller, reference, args),\n  apply: (id: string) => world.apply(id),\n  held: () => world.held(),\n  run: (handler: (ctx: any) => any) => world.run(caller, \"\", handler),\n  runInComponent: (componentPath: string, handler: (ctx: any) => any) =>\n    world.run(caller, componentPath, handler),\n  withIdentity: (identity: Partial<UserIdentity>) =>\n    accessor(world, Execution.withIdentity(caller, identity)),\n  withRequestMetadata: (metadata: {\n    readonly ip?: string | null;\n    readonly userAgent?: string | null;\n  }) =>\n    accessor(world, {\n      ...caller,\n      ip: metadata.ip ?? null,\n      userAgent: metadata.userAgent ?? null,\n    }),\n  fetch: () => Promise.reject(KernelRefusal.rowPending(\"HTTP routes\", 6)),\n  jwks: () => Promise.reject(KernelRefusal.rowPending(\"JWT verification\", 6)),\n  finishInProgressScheduledFunctions: () =>\n    Promise.reject(KernelRefusal.rowPending(\"the scheduler\", 5)),\n  finishAllScheduledFunctions: () =>\n    Promise.reject(KernelRefusal.rowPending(\"the scheduler\", 5)),\n});\n\n/**\n * The test kernel under convex-test's `convexTest` signature. The fork's kernel\n * lane aliases `convex-test` to this module, so every suite that calls\n * `convexTest` directly, and `TestConfect` itself, runs on the kernel.\n *\n * Beyond convex-test, `prepare` runs a mutation to its commit point and holds\n * it, and `apply` validates and publishes a held attempt. `mutation` applies\n * each attempt it prepares at once and prepares the next on a conflict, up to\n * attempt 5. `runtime` supplies the clock and commit timestamps.\n */\nexport function convexTest(\n  schemaOrOptions?:\n    | SchemaDefinition<GenericSchema, boolean>\n    | {\n        readonly schema?: SchemaDefinition<GenericSchema, boolean>;\n        readonly modules?: Modules;\n        readonly transactionLimits?: unknown;\n        readonly runtime?: Kernel.KernelRuntime;\n      },\n  modules?: Modules,\n): any {\n  let schema: SchemaDefinition<GenericSchema, boolean> | undefined;\n  let runtime: Kernel.KernelRuntime | undefined;\n  if (isSchemaDefinition(schemaOrOptions)) {\n    schema = schemaOrOptions;\n  } else if (schemaOrOptions !== undefined) {\n    if (schemaOrOptions.transactionLimits !== undefined) {\n      throw KernelRefusal.rowPending(\"transaction limits\", 6);\n    }\n    schema = schemaOrOptions.schema;\n    modules = schemaOrOptions.modules;\n    runtime = schemaOrOptions.runtime;\n  }\n  if (modules === undefined) {\n    throw new Error(\n      \"The test kernel needs the modules map: pass `import.meta.glob(...)` as the second argument.\",\n    );\n  }\n  const world = new Execution.World(schema, modules, runtime);\n  return {\n    ...accessor(world, Execution.anonymous),\n    registerComponent: (\n      componentPath: string,\n      componentSchema: SchemaDefinition<GenericSchema, boolean>,\n      componentModules: Modules,\n    ) => {\n      world.register(componentPath, componentSchema, componentModules);\n      return (componentsGeneric() as any)[componentPath];\n    },\n  };\n}\n"],"mappings":";;;;AA4BA,MAAM,sBACJ,UAEA,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAQ,MAA8B,WAAW;AAEnD,MAAM,YAAY,OAAwB,YAAmC;CAC3E,QAAQ,WAAgB,SAAe,MAAM,MAAM,QAAQ,WAAW,IAAI;CAC1E,WAAW,WAAgB,SACzB,MAAM,SAAS,QAAQ,WAAW,IAAI;CACxC,SAAS,WAAgB,SAAe,MAAM,OAAO,QAAQ,WAAW,IAAI;CAC5E,UAAU,WAAgB,SACxB,MAAM,QAAQ,QAAQ,WAAW,IAAI;CACvC,QAAQ,OAAe,MAAM,MAAM,EAAE;CACrC,YAAY,MAAM,KAAK;CACvB,MAAM,YAA+B,MAAM,IAAI,QAAQ,IAAI,OAAO;CAClE,iBAAiB,eAAuB,YACtC,MAAM,IAAI,QAAQ,eAAe,OAAO;CAC1C,eAAe,aACb,SAAS,OAAOA,aAAuB,QAAQ,QAAQ,CAAC;CAC1D,sBAAsB,aAIpB,SAAS,OAAO;EACd,GAAG;EACH,IAAI,SAAS,MAAM;EACnB,WAAW,SAAS,aAAa;CACnC,CAAC;CACH,aAAa,QAAQ,OAAOC,WAAyB,eAAe,CAAC,CAAC;CACtE,YAAY,QAAQ,OAAOA,WAAyB,oBAAoB,CAAC,CAAC;CAC1E,0CACE,QAAQ,OAAOA,WAAyB,iBAAiB,CAAC,CAAC;CAC7D,mCACE,QAAQ,OAAOA,WAAyB,iBAAiB,CAAC,CAAC;AAC/D;;;;;;;;;;;AAYA,SAAgB,WACd,iBAQA,SACK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI,mBAAmB,eAAe,GACpC,SAAS;MACJ,IAAI,oBAAoB,KAAA,GAAW;EACxC,IAAI,gBAAgB,sBAAsB,KAAA,GACxC,MAAMA,WAAyB,sBAAsB,CAAC;EAExD,SAAS,gBAAgB;EACzB,UAAU,gBAAgB;EAC1B,UAAU,gBAAgB;CAC5B;CACA,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MACR,6FACF;CAEF,MAAM,QAAQ,IAAIC,MAAgB,QAAQ,SAAS,OAAO;CAC1D,OAAO;EACL,GAAG,SAAS,OAAOC,SAAmB;EACtC,oBACE,eACA,iBACA,qBACG;GACH,MAAM,SAAS,eAAe,iBAAiB,gBAAgB;GAC/D,OAAQ,kBAAkB,CAAC,CAAS;EACtC;CACF;AACF"}
+{"version":3,"file":"ConvexTest.js","names":["Execution.withIdentity","KernelRefusal.rowPending","Execution.World","Execution.anonymous"],"sources":["../../src/internal/ConvexTest.ts"],"sourcesContent":["import type {\n  GenericSchema,\n  SchemaDefinition,\n  UserIdentity,\n} from \"convex/server\";\nimport { componentsGeneric } from \"convex/server\";\nimport * as Execution from \"./Execution.js\";\nimport type * as Kernel from \"./Kernel.js\";\nimport * as KernelRefusal from \"./KernelRefusal.js\";\nimport type * as Scheduling from \"./Scheduling.js\";\n\ntype Modules = Record<string, () => Promise<any>>;\n\n/**\n * What the kernel adds to convex-test's surface, typed. The shim itself returns\n * `any`, as convex-test's callers expect.\n */\nexport interface KernelControls {\n  readonly query: (reference: any, args?: any) => Promise<any>;\n  readonly mutation: (reference: any, args?: any) => Promise<any>;\n  readonly action: (reference: any, args?: any) => Promise<any>;\n  readonly prepare: (\n    reference: any,\n    args?: any,\n  ) => Promise<Execution.HeldAttempt>;\n  readonly apply: (id: string) => Promise<Execution.KernelApply>;\n  readonly held: () => ReadonlyArray<Execution.HeldAttempt>;\n  /**\n   * Move the kernel's clock forward, running each job due on the way at its\n   * deadline.\n   */\n  readonly advance: (ms: number) => Promise<void>;\n  /**\n   * The pending jobs, earliest deadline first.\n   */\n  readonly jobs: () => ReadonlyArray<Scheduling.Job>;\n  /**\n   * Run the jobs due now. No future deadline is crossed.\n   */\n  readonly finishInProgressScheduledFunctions: () => Promise<void>;\n  /**\n   * Run jobs at their deadlines until only standing jobs remain, or fail with\n   * `DrainBudgetExceeded` after `maxIterations` jobs. The kernel keeps its own\n   * clock, so it never calls `advanceTimers`.\n   */\n  readonly finishAllScheduledFunctions: (\n    advanceTimers?: () => void,\n    maxIterations?: number,\n  ) => Promise<void>;\n}\n\n/**\n * How a kit registers a component beyond its schema and modules.\n */\nexport interface 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`. A job that runs\n   * one, or that one schedules, is never drain work.\n   */\n  readonly standing?: ReadonlyArray<string>;\n}\n\nconst isSchemaDefinition = (\n  value: unknown,\n): value is SchemaDefinition<GenericSchema, boolean> =>\n  value !== null &&\n  typeof value === \"object\" &&\n  \"tables\" in value &&\n  typeof (value as { tables: unknown }).tables === \"object\";\n\nconst accessor = (world: Execution.World, caller: Execution.Caller): any => ({\n  query: (reference: any, args?: any) => world.query(caller, reference, args),\n  mutation: (reference: any, args?: any) =>\n    world.mutation(caller, reference, args),\n  action: (reference: any, args?: any) => world.action(caller, reference, args),\n  prepare: (reference: any, args?: any) =>\n    world.prepare(caller, reference, args),\n  apply: (id: string) => world.apply(id),\n  held: () => world.held(),\n  run: (handler: (ctx: any) => any) => world.run(caller, \"\", handler),\n  runInComponent: (componentPath: string, handler: (ctx: any) => any) =>\n    world.run(caller, componentPath, handler),\n  withIdentity: (identity: Partial<UserIdentity>) =>\n    accessor(world, Execution.withIdentity(caller, identity)),\n  withRequestMetadata: (metadata: {\n    readonly ip?: string | null;\n    readonly userAgent?: string | null;\n  }) =>\n    accessor(world, {\n      ...caller,\n      ip: metadata.ip ?? null,\n      userAgent: metadata.userAgent ?? null,\n    }),\n  fetch: () => Promise.reject(KernelRefusal.rowPending(\"HTTP routes\", 6)),\n  jwks: () => Promise.reject(KernelRefusal.rowPending(\"JWT verification\", 6)),\n  advance: (ms: number) => world.advance(ms),\n  jobs: () => world.jobs(),\n  finishInProgressScheduledFunctions: () => world.advance(0),\n  finishAllScheduledFunctions: (\n    _advanceTimers?: () => void,\n    maxIterations?: number,\n  ) => world.drain(maxIterations),\n});\n\n/**\n * The test kernel under convex-test's `convexTest` signature. The fork's kernel\n * lane aliases `convex-test` to this module, so every suite that calls\n * `convexTest` directly, and `TestConfect` itself, runs on the kernel.\n *\n * Beyond convex-test, `prepare` runs a mutation to its commit point and holds\n * it, and `apply` validates and publishes a held attempt. `mutation` applies\n * each attempt it prepares at once and prepares the next on a conflict, up to\n * attempt 5. `runtime` supplies the clock and commit timestamps. Scheduled\n * functions run on the kernel's clock, never on a host timer.\n */\nexport function convexTest(\n  schemaOrOptions?:\n    | SchemaDefinition<GenericSchema, boolean>\n    | {\n        readonly schema?: SchemaDefinition<GenericSchema, boolean>;\n        readonly modules?: Modules;\n        readonly transactionLimits?: unknown;\n        readonly runtime?: Kernel.KernelRuntime;\n      },\n  modules?: Modules,\n): any {\n  let schema: SchemaDefinition<GenericSchema, boolean> | undefined;\n  let runtime: Kernel.KernelRuntime | undefined;\n  if (isSchemaDefinition(schemaOrOptions)) {\n    schema = schemaOrOptions;\n  } else if (schemaOrOptions !== undefined) {\n    if (schemaOrOptions.transactionLimits !== undefined) {\n      throw KernelRefusal.rowPending(\"transaction limits\", 6);\n    }\n    schema = schemaOrOptions.schema;\n    modules = schemaOrOptions.modules;\n    runtime = schemaOrOptions.runtime;\n  }\n  if (modules === undefined) {\n    throw new Error(\n      \"The test kernel needs the modules map: pass `import.meta.glob(...)` as the second argument.\",\n    );\n  }\n  const world = new Execution.World(schema, modules, runtime);\n  return {\n    ...accessor(world, Execution.anonymous),\n    registerComponent: (\n      componentPath: string,\n      componentSchema: SchemaDefinition<GenericSchema, boolean>,\n      componentModules: Modules,\n      options?: RegisterOptions,\n    ) => {\n      world.register(\n        componentPath,\n        componentSchema,\n        componentModules,\n        options?.standing,\n      );\n      return (componentsGeneric() as any)[componentPath];\n    },\n  };\n}\n"],"mappings":";;;;AA+DA,MAAM,sBACJ,UAEA,UAAU,QACV,OAAO,UAAU,YACjB,YAAY,SACZ,OAAQ,MAA8B,WAAW;AAEnD,MAAM,YAAY,OAAwB,YAAmC;CAC3E,QAAQ,WAAgB,SAAe,MAAM,MAAM,QAAQ,WAAW,IAAI;CAC1E,WAAW,WAAgB,SACzB,MAAM,SAAS,QAAQ,WAAW,IAAI;CACxC,SAAS,WAAgB,SAAe,MAAM,OAAO,QAAQ,WAAW,IAAI;CAC5E,UAAU,WAAgB,SACxB,MAAM,QAAQ,QAAQ,WAAW,IAAI;CACvC,QAAQ,OAAe,MAAM,MAAM,EAAE;CACrC,YAAY,MAAM,KAAK;CACvB,MAAM,YAA+B,MAAM,IAAI,QAAQ,IAAI,OAAO;CAClE,iBAAiB,eAAuB,YACtC,MAAM,IAAI,QAAQ,eAAe,OAAO;CAC1C,eAAe,aACb,SAAS,OAAOA,aAAuB,QAAQ,QAAQ,CAAC;CAC1D,sBAAsB,aAIpB,SAAS,OAAO;EACd,GAAG;EACH,IAAI,SAAS,MAAM;EACnB,WAAW,SAAS,aAAa;CACnC,CAAC;CACH,aAAa,QAAQ,OAAOC,WAAyB,eAAe,CAAC,CAAC;CACtE,YAAY,QAAQ,OAAOA,WAAyB,oBAAoB,CAAC,CAAC;CAC1E,UAAU,OAAe,MAAM,QAAQ,EAAE;CACzC,YAAY,MAAM,KAAK;CACvB,0CAA0C,MAAM,QAAQ,CAAC;CACzD,8BACE,gBACA,kBACG,MAAM,MAAM,aAAa;AAChC;;;;;;;;;;;;AAaA,SAAgB,WACd,iBAQA,SACK;CACL,IAAI;CACJ,IAAI;CACJ,IAAI,mBAAmB,eAAe,GACpC,SAAS;MACJ,IAAI,oBAAoB,KAAA,GAAW;EACxC,IAAI,gBAAgB,sBAAsB,KAAA,GACxC,MAAMA,WAAyB,sBAAsB,CAAC;EAExD,SAAS,gBAAgB;EACzB,UAAU,gBAAgB;EAC1B,UAAU,gBAAgB;CAC5B;CACA,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MACR,6FACF;CAEF,MAAM,QAAQ,IAAIC,MAAgB,QAAQ,SAAS,OAAO;CAC1D,OAAO;EACL,GAAG,SAAS,OAAOC,SAAmB;EACtC,oBACE,eACA,iBACA,kBACA,YACG;GACH,MAAM,SACJ,eACA,iBACA,kBACA,SAAS,QACX;GACA,OAAQ,kBAAkB,CAAC,CAAS;EACtC;CACF;AACF"}