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

package/dist/internal/MountedHttp.js.map

@@ -1 +1 @@
-{"version":3,"file":"MountedHttp.js","names":[],"sources":["../../src/internal/MountedHttp.ts"],"sourcesContent":["/* oxlint-disable effecttsgo/async-function -- This convex-test adapter uses Promise callbacks and temporarily overrides the real process environment consumed by HTTP module construction. */\nimport type { TestConvexForDataModel } from \"convex-test\";\nimport type {\n  GenericDataModel,\n  HttpRouter,\n  FunctionReference,\n  RoutableMethod,\n  PublicHttpAction,\n} from \"convex/server\";\nimport { actionGeneric } from \"convex/server\";\nimport * as Result from \"effect/Result\";\nimport * as Schema from \"effect/Schema\";\nimport type { HttpMount, RegisterComponent } from \"../TestConfect.js\";\n\ndeclare const process: { env: Record<string, string | undefined> };\n\nclass InvalidHttpMount extends Schema.TaggedError<InvalidHttpMount>()(\n  \"InvalidHttpMount\",\n  {\n    componentPath: Schema.String,\n    httpPrefix: Schema.String,\n    message: Schema.String,\n  },\n) {}\n\nclass ComponentHttpError extends Schema.TaggedError<ComponentHttpError>()(\n  \"ComponentHttpError\",\n  { componentPath: Schema.String, message: Schema.String },\n) {}\n\nclass InvalidFetchPath extends Schema.TaggedError<InvalidFetchPath>()(\n  \"InvalidFetchPath\",\n  { path: Schema.String, message: Schema.String },\n) {}\n\ntype NormalizedMount = {\n  readonly componentPath: string;\n  readonly prefix: string;\n};\n\nconst normalizeMounts = (mounts: ReadonlyArray<HttpMount>) => {\n  const normalized: Array<NormalizedMount> = [];\n  for (const mount of mounts) {\n    if (!mount.httpPrefix.startsWith(\"/\") || /[?#]/.test(mount.httpPrefix)) {\n      return Result.fail(\n        new InvalidHttpMount({\n          ...mount,\n          message:\n            \"httpPrefix must be an absolute path without a query or fragment.\",\n        }),\n      );\n    }\n    const prefix = mount.httpPrefix.replace(/\\/+$/, \"\");\n    if (normalized.some((previous) => previous.prefix === prefix)) {\n      return Result.fail(\n        new InvalidHttpMount({\n          ...mount,\n          message: \"Each httpPrefix must select one component installation.\",\n        }),\n      );\n    }\n    normalized.push({ componentPath: mount.componentPath, prefix });\n  }\n  return Result.succeed(\n    normalized.sort((a, b) => b.prefix.length - a.prefix.length),\n  );\n};\n\ntype HttpRequest = {\n  siteUrl: string;\n  url: string;\n  pathname: string;\n  method: string;\n  headers: Array<[string, string]>;\n  body: ArrayBuffer | null;\n};\n\ntype HttpResponse = {\n  status: number;\n  statusText: string;\n  headers: Array<[string, string]>;\n  body: ArrayBuffer;\n};\n\n// Convex omits this runtime entry point from its published declarations.\nconst isInvokable = (\n  action: PublicHttpAction,\n): action is PublicHttpAction & {\n  invokeHttpAction(request: Request): Promise<Response>;\n} =>\n  \"invokeHttpAction\" in action && typeof action.invokeHttpAction === \"function\";\n\nconst bridgeModule = \"__confect_test_http\";\nconst defaultSiteUrl = \"https://some.convex.site\";\n\nexport const make = (\n  mounts: ReadonlyArray<HttpMount>,\n  registerComponent: RegisterComponent,\n) => {\n  const normalized = normalizeMounts(mounts);\n  if (Result.isFailure(normalized)) throw normalized.failure;\n  const registered = new Set<string>();\n  let tail = Promise.resolve();\n\n  const register: RegisterComponent = (componentPath, schema, modules) => {\n    if (\n      !normalized.success.some((mount) => mount.componentPath === componentPath)\n    ) {\n      registerComponent(componentPath, schema, modules);\n      return;\n    }\n    const generated = Object.keys(modules).find((key) =>\n      key.includes(\"_generated\"),\n    );\n    const root = generated?.split(\"_generated\", 2)[0];\n    const moduleLoaders = Object.fromEntries(\n      Object.entries(modules).map(([path, load]) => [\n        path.replace(/\\.[^.]+$/, \"\"),\n        load,\n      ]),\n    );\n    const loadHttp =\n      root === undefined ? undefined : moduleLoaders[`${root}http`];\n    if (root === undefined || loadHttp === undefined) {\n      throw new ComponentHttpError({\n        componentPath,\n        message:\n          \"Mounted components need an HTTP module and Convex _generated modules.\",\n      });\n    }\n    const bridgePath = `${root}${bridgeModule}.ts`;\n    if (`${root}${bridgeModule}` in moduleLoaders) {\n      throw new ComponentHttpError({\n        componentPath,\n        message: `${bridgeModule} is reserved for mounted HTTP tests.`,\n      });\n    }\n    const routers = new Map<string, Promise<HttpRouter>>();\n    const invoke = actionGeneric({\n      handler: async (_ctx, args: HttpRequest): Promise<HttpResponse> => {\n        const previousSiteUrl = process.env.CONVEX_SITE_URL;\n        try {\n          process.env.CONVEX_SITE_URL = args.siteUrl;\n          let router = routers.get(args.siteUrl);\n          if (router === undefined) {\n            router = loadHttp().then(\n              (module: { default: HttpRouter }) => module.default,\n            );\n            routers.set(args.siteUrl, router);\n          }\n          const route = (await router).lookup(\n            args.pathname,\n            args.method as RoutableMethod,\n          );\n          let response: Response;\n          if (route === null) {\n            response = new Response(\n              `No HttpAction routed for ${args.pathname}`,\n              { status: 404 },\n            );\n          } else {\n            const action = route[0];\n            if (!isInvokable(action)) {\n              throw new ComponentHttpError({\n                componentPath,\n                message:\n                  \"This Convex version does not expose invokeHttpAction for HTTP tests.\",\n              });\n            }\n            // Convex selects on the relative path and passes the full URL to the handler.\n            response = await action.invokeHttpAction(\n              new Request(args.url, {\n                method: args.method,\n                headers: args.headers,\n                ...(args.body === null ? {} : { body: args.body }),\n              }),\n            );\n          }\n          return {\n            status: response.status,\n            statusText: response.statusText,\n            headers: [...response.headers],\n            body: await response.arrayBuffer(),\n          };\n        } finally {\n          if (previousSiteUrl === undefined) delete process.env.CONVEX_SITE_URL;\n          else process.env.CONVEX_SITE_URL = previousSiteUrl;\n        }\n      },\n    });\n    registerComponent(componentPath, schema, {\n      ...modules,\n      [bridgePath]: () => Promise.resolve({ invoke }),\n    });\n    registered.add(componentPath);\n  };\n\n  const fetch = <DataModel extends GenericDataModel>(\n    accessor: TestConvexForDataModel<DataModel>,\n    path: string,\n    init?: RequestInit,\n  ): Promise<Response> => {\n    if (normalized.success.length === 0) return accessor.fetch(path, init);\n    const run = async () => {\n      if (!path.startsWith(\"/\")) {\n        throw new InvalidFetchPath({\n          path,\n          message: 'Path given to fetch must start with a \"/\".',\n        });\n      }\n      const pathname = new URL(`${defaultSiteUrl}${path}`).pathname;\n      const mount = normalized.success.find(\n        ({ prefix }) =>\n          pathname === prefix || pathname.startsWith(`${prefix}/`),\n      );\n      if (mount === undefined) return accessor.fetch(path, init);\n      if (!registered.has(mount.componentPath)) {\n        throw new ComponentHttpError({\n          componentPath: mount.componentPath,\n          message: \"Register the mounted component before calling fetch.\",\n        });\n      }\n      const appSiteUrl = (\n        process.env.CONVEX_SITE_URL || defaultSiteUrl\n      ).replace(/\\/$/, \"\");\n      const request = new Request(new URL(`${appSiteUrl}${path}`), init);\n      // convex-test encodes exact component paths in test-only function handles.\n      const reference =\n        `function://${mount.componentPath};${bridgeModule}:invoke` as unknown as FunctionReference<\n          \"action\",\n          \"public\",\n          HttpRequest,\n          HttpResponse\n        >;\n      const response = await accessor.action(reference, {\n        siteUrl: `${appSiteUrl}${mount.prefix}`,\n        url: request.url,\n        pathname: pathname.slice(mount.prefix.length) || \"/\",\n        method: request.method,\n        headers: [...request.headers],\n        body:\n          request.method === \"GET\" || request.method === \"HEAD\"\n            ? null\n            : await request.arrayBuffer(),\n      });\n      return new Response(\n        request.method === \"HEAD\" || [204, 205, 304].includes(response.status)\n          ? null\n          : response.body,\n        {\n          status: response.status,\n          statusText: response.statusText,\n          headers: response.headers,\n        },\n      );\n    };\n    const result = tail.then(run);\n    tail = result.then(\n      () => undefined,\n      () => undefined,\n    );\n    return result;\n  };\n\n  return { register, fetch };\n};\n"],"mappings":"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"}
+{"version":3,"file":"MountedHttp.js","names":[],"sources":["../../src/internal/MountedHttp.ts"],"sourcesContent":["/* oxlint-disable effecttsgo/async-function -- This convex-test adapter uses Promise callbacks and temporarily overrides the real process environment consumed by HTTP module construction. */\nimport type { TestConvexForDataModel } from \"convex-test\";\nimport type {\n  GenericDataModel,\n  HttpRouter,\n  FunctionReference,\n  RoutableMethod,\n  PublicHttpAction,\n} from \"convex/server\";\nimport { actionGeneric } from \"convex/server\";\nimport * as Result from \"effect/Result\";\nimport * as Schema from \"effect/Schema\";\nimport type { HttpMount, RegisterComponent } from \"../TestConfect.js\";\n\ndeclare const process: { env: Record<string, string | undefined> };\n\nclass InvalidHttpMount extends Schema.TaggedError<InvalidHttpMount>()(\n  \"InvalidHttpMount\",\n  {\n    componentPath: Schema.String,\n    httpPrefix: Schema.String,\n    message: Schema.String,\n  },\n) {}\n\nclass ComponentHttpError extends Schema.TaggedError<ComponentHttpError>()(\n  \"ComponentHttpError\",\n  { componentPath: Schema.String, message: Schema.String },\n) {}\n\nclass InvalidFetchPath extends Schema.TaggedError<InvalidFetchPath>()(\n  \"InvalidFetchPath\",\n  { path: Schema.String, message: Schema.String },\n) {}\n\ntype NormalizedMount = {\n  readonly componentPath: string;\n  readonly prefix: string;\n};\n\nconst normalizeMounts = (mounts: ReadonlyArray<HttpMount>) => {\n  const normalized: Array<NormalizedMount> = [];\n  for (const mount of mounts) {\n    if (!mount.httpPrefix.startsWith(\"/\") || /[?#]/.test(mount.httpPrefix)) {\n      return Result.fail(\n        new InvalidHttpMount({\n          ...mount,\n          message:\n            \"httpPrefix must be an absolute path without a query or fragment.\",\n        }),\n      );\n    }\n    const prefix = mount.httpPrefix.replace(/\\/+$/, \"\");\n    if (normalized.some((previous) => previous.prefix === prefix)) {\n      return Result.fail(\n        new InvalidHttpMount({\n          ...mount,\n          message: \"Each httpPrefix must select one component installation.\",\n        }),\n      );\n    }\n    normalized.push({ componentPath: mount.componentPath, prefix });\n  }\n  return Result.succeed(\n    normalized.sort((a, b) => b.prefix.length - a.prefix.length),\n  );\n};\n\ntype HttpRequest = {\n  siteUrl: string;\n  url: string;\n  pathname: string;\n  method: string;\n  headers: Array<[string, string]>;\n  body: ArrayBuffer | null;\n};\n\ntype HttpResponse = {\n  status: number;\n  statusText: string;\n  headers: Array<[string, string]>;\n  body: ArrayBuffer;\n};\n\n// Convex omits this runtime entry point from its published declarations.\nconst isInvokable = (\n  action: PublicHttpAction,\n): action is PublicHttpAction & {\n  invokeHttpAction(request: Request): Promise<Response>;\n} =>\n  \"invokeHttpAction\" in action && typeof action.invokeHttpAction === \"function\";\n\nconst bridgeModule = \"__confect_test_http\";\nconst defaultSiteUrl = \"https://some.convex.site\";\n\nexport const make = (\n  mounts: ReadonlyArray<HttpMount>,\n  registerComponent: RegisterComponent,\n) => {\n  const normalized = normalizeMounts(mounts);\n  if (Result.isFailure(normalized)) throw normalized.failure;\n  const registered = new Set<string>();\n  let tail = Promise.resolve();\n\n  const register: RegisterComponent = (\n    componentPath,\n    schema,\n    modules,\n    options,\n  ) => {\n    if (\n      !normalized.success.some((mount) => mount.componentPath === componentPath)\n    ) {\n      registerComponent(componentPath, schema, modules, options);\n      return;\n    }\n    const generated = Object.keys(modules).find((key) =>\n      key.includes(\"_generated\"),\n    );\n    const root = generated?.split(\"_generated\", 2)[0];\n    const moduleLoaders = Object.fromEntries(\n      Object.entries(modules).map(([path, load]) => [\n        path.replace(/\\.[^.]+$/, \"\"),\n        load,\n      ]),\n    );\n    const loadHttp =\n      root === undefined ? undefined : moduleLoaders[`${root}http`];\n    if (root === undefined || loadHttp === undefined) {\n      throw new ComponentHttpError({\n        componentPath,\n        message:\n          \"Mounted components need an HTTP module and Convex _generated modules.\",\n      });\n    }\n    const bridgePath = `${root}${bridgeModule}.ts`;\n    if (`${root}${bridgeModule}` in moduleLoaders) {\n      throw new ComponentHttpError({\n        componentPath,\n        message: `${bridgeModule} is reserved for mounted HTTP tests.`,\n      });\n    }\n    const routers = new Map<string, Promise<HttpRouter>>();\n    const invoke = actionGeneric({\n      handler: async (_ctx, args: HttpRequest): Promise<HttpResponse> => {\n        const previousSiteUrl = process.env.CONVEX_SITE_URL;\n        try {\n          process.env.CONVEX_SITE_URL = args.siteUrl;\n          let router = routers.get(args.siteUrl);\n          if (router === undefined) {\n            router = loadHttp().then(\n              (module: { default: HttpRouter }) => module.default,\n            );\n            routers.set(args.siteUrl, router);\n          }\n          const route = (await router).lookup(\n            args.pathname,\n            args.method as RoutableMethod,\n          );\n          let response: Response;\n          if (route === null) {\n            response = new Response(\n              `No HttpAction routed for ${args.pathname}`,\n              { status: 404 },\n            );\n          } else {\n            const action = route[0];\n            if (!isInvokable(action)) {\n              throw new ComponentHttpError({\n                componentPath,\n                message:\n                  \"This Convex version does not expose invokeHttpAction for HTTP tests.\",\n              });\n            }\n            // Convex selects on the relative path and passes the full URL to the handler.\n            response = await action.invokeHttpAction(\n              new Request(args.url, {\n                method: args.method,\n                headers: args.headers,\n                ...(args.body === null ? {} : { body: args.body }),\n              }),\n            );\n          }\n          return {\n            status: response.status,\n            statusText: response.statusText,\n            headers: [...response.headers],\n            body: await response.arrayBuffer(),\n          };\n        } finally {\n          if (previousSiteUrl === undefined) delete process.env.CONVEX_SITE_URL;\n          else process.env.CONVEX_SITE_URL = previousSiteUrl;\n        }\n      },\n    });\n    registerComponent(\n      componentPath,\n      schema,\n      { ...modules, [bridgePath]: () => Promise.resolve({ invoke }) },\n      options,\n    );\n    registered.add(componentPath);\n  };\n\n  const fetch = <DataModel extends GenericDataModel>(\n    accessor: TestConvexForDataModel<DataModel>,\n    path: string,\n    init?: RequestInit,\n  ): Promise<Response> => {\n    if (normalized.success.length === 0) return accessor.fetch(path, init);\n    const run = async () => {\n      if (!path.startsWith(\"/\")) {\n        throw new InvalidFetchPath({\n          path,\n          message: 'Path given to fetch must start with a \"/\".',\n        });\n      }\n      const pathname = new URL(`${defaultSiteUrl}${path}`).pathname;\n      const mount = normalized.success.find(\n        ({ prefix }) =>\n          pathname === prefix || pathname.startsWith(`${prefix}/`),\n      );\n      if (mount === undefined) return accessor.fetch(path, init);\n      if (!registered.has(mount.componentPath)) {\n        throw new ComponentHttpError({\n          componentPath: mount.componentPath,\n          message: \"Register the mounted component before calling fetch.\",\n        });\n      }\n      const appSiteUrl = (\n        process.env.CONVEX_SITE_URL || defaultSiteUrl\n      ).replace(/\\/$/, \"\");\n      const request = new Request(new URL(`${appSiteUrl}${path}`), init);\n      // convex-test encodes exact component paths in test-only function handles.\n      const reference =\n        `function://${mount.componentPath};${bridgeModule}:invoke` as unknown as FunctionReference<\n          \"action\",\n          \"public\",\n          HttpRequest,\n          HttpResponse\n        >;\n      const response = await accessor.action(reference, {\n        siteUrl: `${appSiteUrl}${mount.prefix}`,\n        url: request.url,\n        pathname: pathname.slice(mount.prefix.length) || \"/\",\n        method: request.method,\n        headers: [...request.headers],\n        body:\n          request.method === \"GET\" || request.method === \"HEAD\"\n            ? null\n            : await request.arrayBuffer(),\n      });\n      return new Response(\n        request.method === \"HEAD\" || [204, 205, 304].includes(response.status)\n          ? null\n          : response.body,\n        {\n          status: response.status,\n          statusText: response.statusText,\n          headers: response.headers,\n        },\n      );\n    };\n    const result = tail.then(run);\n    tail = result.then(\n      () => undefined,\n      () => undefined,\n    );\n    return result;\n  };\n\n  return { register, fetch };\n};\n"],"mappings":"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"}

package/dist/internal/ReadSet.d.ts

@@ -0,0 +1,55 @@
+import { type Value } from "convex/values";
+import type { DocumentId, SerializedRangeExpression, StoredDocument } from "./KernelValues.js";
+/**
+ * A row's position in an interval's order: its value at each of the interval's
+ * fields.
+ */
+export type Key = ReadonlyArray<Value | undefined>;
+/**
+ * A read of one document by ID. It records the document's absence as well as
+ * its presence, so a commit that creates the document invalidates it.
+ */
+export interface DocumentRead {
+    readonly kind: "document";
+    readonly componentPath: string;
+    readonly id: DocumentId;
+}
+/**
+ * A read of an ordered interval of one table.
+ *
+ * `fields` is the sort key: an index's fields, then the tie-breakers
+ * `_creationTime` and `_id`. `range` is the index range expression, whose `Gt`
+ * and `Lt` bounds are exclusive and `Gte` and `Lte` inclusive. `after` is an
+ * exclusive start in `order`, a page's cursor. `through` is how far the query
+ * examined, inclusive: nothing yet, up to a key, or to the end of the range. An
+ * empty result reads to the end, so it still covers an insert into the range.
+ *
+ * Only the attempt that owns the read advances `through`.
+ */
+export interface IntervalRead {
+    readonly kind: "interval";
+    readonly componentPath: string;
+    readonly table: string;
+    readonly fields: ReadonlyArray<string>;
+    readonly order: "asc" | "desc";
+    readonly range: ReadonlyArray<SerializedRangeExpression>;
+    readonly after: Key | null;
+    through: Key | "end" | null;
+}
+export type Read = DocumentRead | IntervalRead;
+/**
+ * Where `doc` sorts against `key` in the interval's order.
+ */
+export declare const compareToKey: (fields: ReadonlyArray<string>, order: "asc" | "desc", doc: StoredDocument, key: Key) => number;
+export declare const keyOf: (fields: ReadonlyArray<string>, doc: StoredDocument) => Key;
+/**
+ * Whether a commit's change to one document invalidates `read`: it wrote the
+ * document read by ID, or the document entered or left the interval.
+ */
+export declare const covers: (read: Read, change: {
+    readonly componentPath: string;
+    readonly id: DocumentId;
+    readonly before: StoredDocument | null;
+    readonly after: StoredDocument | null;
+}) => boolean;
+//# sourceMappingURL=ReadSet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReadSet.d.ts","sourceRoot":"","sources":["../../src/internal/ReadSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EACV,UAAU,EACV,yBAAyB,EACzB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAO3B;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,YAAY,WACf,aAAa,CAAC,MAAM,CAAC,SACtB,KAAK,GAAG,MAAM,OAChB,cAAc,OACd,GAAG,KACP,MAUF,CAAC;AAEF,eAAO,MAAM,KAAK,WACR,aAAa,CAAC,MAAM,CAAC,OACxB,cAAc,KAClB,GAA2D,CAAC;AAU/D;;;GAGG;AACH,eAAO,MAAM,MAAM,SACX,IAAI,UACF;IACN,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;CACvC,KACA,OASF,CAAC"}

package/dist/internal/ReadSet.js

@@ -0,0 +1,29 @@
+import { evaluateFieldPath, evaluateRangeFilter, tableNameFromId } from "./KernelValues.js";
+import { compareValues } from "convex/values";
+//#region src/internal/ReadSet.ts
+/**
+* Where `doc` sorts against `key` in the interval's order.
+*/
+const compareToKey = (fields, order, doc, key) => {
+	const direction = order === "asc" ? 1 : -1;
+	for (let i = 0; i < fields.length; i++) {
+		const cmp = compareValues(evaluateFieldPath(fields[i], doc), key[i]);
+		if (cmp !== 0) return cmp * direction;
+	}
+	return 0;
+};
+const keyOf = (fields, doc) => fields.map((field) => evaluateFieldPath(field, doc));
+const inInterval = (read, doc) => read.through !== null && read.range.every((filter) => evaluateRangeFilter(doc, filter)) && (read.after === null || compareToKey(read.fields, read.order, doc, read.after) > 0) && (read.through === "end" || compareToKey(read.fields, read.order, doc, read.through) <= 0);
+/**
+* Whether a commit's change to one document invalidates `read`: it wrote the
+* document read by ID, or the document entered or left the interval.
+*/
+const covers = (read, change) => {
+	if (read.componentPath !== change.componentPath) return false;
+	if (read.kind === "document") return read.id === change.id;
+	return tableNameFromId(change.id) === read.table && [change.before, change.after].some((doc) => doc !== null && inInterval(read, doc));
+};
+//#endregion
+export { compareToKey, covers, keyOf };
+
+//# sourceMappingURL=ReadSet.js.map

package/dist/internal/ReadSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadSet.js","names":[],"sources":["../../src/internal/ReadSet.ts"],"sourcesContent":["import { compareValues, type Value } from \"convex/values\";\nimport type {\n  DocumentId,\n  SerializedRangeExpression,\n  StoredDocument,\n} from \"./KernelValues.js\";\nimport {\n  evaluateFieldPath,\n  evaluateRangeFilter,\n  tableNameFromId,\n} from \"./KernelValues.js\";\n\n/**\n * A row's position in an interval's order: its value at each of the interval's\n * fields.\n */\nexport type Key = ReadonlyArray<Value | undefined>;\n\n/**\n * A read of one document by ID. It records the document's absence as well as\n * its presence, so a commit that creates the document invalidates it.\n */\nexport interface DocumentRead {\n  readonly kind: \"document\";\n  readonly componentPath: string;\n  readonly id: DocumentId;\n}\n\n/**\n * A read of an ordered interval of one table.\n *\n * `fields` is the sort key: an index's fields, then the tie-breakers\n * `_creationTime` and `_id`. `range` is the index range expression, whose `Gt`\n * and `Lt` bounds are exclusive and `Gte` and `Lte` inclusive. `after` is an\n * exclusive start in `order`, a page's cursor. `through` is how far the query\n * examined, inclusive: nothing yet, up to a key, or to the end of the range. An\n * empty result reads to the end, so it still covers an insert into the range.\n *\n * Only the attempt that owns the read advances `through`.\n */\nexport interface IntervalRead {\n  readonly kind: \"interval\";\n  readonly componentPath: string;\n  readonly table: string;\n  readonly fields: ReadonlyArray<string>;\n  readonly order: \"asc\" | \"desc\";\n  readonly range: ReadonlyArray<SerializedRangeExpression>;\n  readonly after: Key | null;\n  through: Key | \"end\" | null;\n}\n\nexport type Read = DocumentRead | IntervalRead;\n\n/**\n * Where `doc` sorts against `key` in the interval's order.\n */\nexport const compareToKey = (\n  fields: ReadonlyArray<string>,\n  order: \"asc\" | \"desc\",\n  doc: StoredDocument,\n  key: Key,\n): number => {\n  const direction = order === \"asc\" ? 1 : -1;\n  for (let i = 0; i < fields.length; i++) {\n    const cmp = compareValues(\n      evaluateFieldPath(fields[i]!, doc),\n      key[i] as Value,\n    );\n    if (cmp !== 0) return cmp * direction;\n  }\n  return 0;\n};\n\nexport const keyOf = (\n  fields: ReadonlyArray<string>,\n  doc: StoredDocument,\n): Key => fields.map((field) => evaluateFieldPath(field, doc));\n\nconst inInterval = (read: IntervalRead, doc: StoredDocument): boolean =>\n  read.through !== null &&\n  read.range.every((filter) => evaluateRangeFilter(doc, filter)) &&\n  (read.after === null ||\n    compareToKey(read.fields, read.order, doc, read.after) > 0) &&\n  (read.through === \"end\" ||\n    compareToKey(read.fields, read.order, doc, read.through) <= 0);\n\n/**\n * Whether a commit's change to one document invalidates `read`: it wrote the\n * document read by ID, or the document entered or left the interval.\n */\nexport const covers = (\n  read: Read,\n  change: {\n    readonly componentPath: string;\n    readonly id: DocumentId;\n    readonly before: StoredDocument | null;\n    readonly after: StoredDocument | null;\n  },\n): boolean => {\n  if (read.componentPath !== change.componentPath) return false;\n  if (read.kind === \"document\") return read.id === change.id;\n  return (\n    tableNameFromId(change.id) === read.table &&\n    [change.before, change.after].some(\n      (doc) => doc !== null && inInterval(read, doc),\n    )\n  );\n};\n"],"mappings":";;;;;;AAwDA,MAAa,gBACX,QACA,OACA,KACA,QACW;CACX,MAAM,YAAY,UAAU,QAAQ,IAAI;CACxC,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;EACtC,MAAM,MAAM,cACV,kBAAkB,OAAO,IAAK,GAAG,GACjC,IAAI,EACN;EACA,IAAI,QAAQ,GAAG,OAAO,MAAM;CAC9B;CACA,OAAO;AACT;AAEA,MAAa,SACX,QACA,QACQ,OAAO,KAAK,UAAU,kBAAkB,OAAO,GAAG,CAAC;AAE7D,MAAM,cAAc,MAAoB,QACtC,KAAK,YAAY,QACjB,KAAK,MAAM,OAAO,WAAW,oBAAoB,KAAK,MAAM,CAAC,MAC5D,KAAK,UAAU,QACd,aAAa,KAAK,QAAQ,KAAK,OAAO,KAAK,KAAK,KAAK,IAAI,OAC1D,KAAK,YAAY,SAChB,aAAa,KAAK,QAAQ,KAAK,OAAO,KAAK,KAAK,OAAO,KAAK;;;;;AAMhE,MAAa,UACX,MACA,WAMY;CACZ,IAAI,KAAK,kBAAkB,OAAO,eAAe,OAAO;CACxD,IAAI,KAAK,SAAS,YAAY,OAAO,KAAK,OAAO,OAAO;CACxD,OACE,gBAAgB,OAAO,EAAE,MAAM,KAAK,SACpC,CAAC,OAAO,QAAQ,OAAO,KAAK,CAAC,CAAC,MAC3B,QAAQ,QAAQ,QAAQ,WAAW,MAAM,GAAG,CAC/C;AAEJ"}

package/dist/internal/Scheduling.d.ts

@@ -0,0 +1,71 @@
+import type { Value } from "convex/values";
+import type * as Invocation from "./Invocation.js";
+import type * as Kernel from "./Kernel.js";
+import type { DocumentId, FunctionPath, StoredDocument } from "./KernelValues.js";
+/**
+ * Convex's system table of scheduled functions. Each component has its own.
+ */
+export declare const table = "_scheduled_functions";
+export type JobState = {
+    readonly kind: "pending";
+} | {
+    readonly kind: "inProgress";
+} | {
+    readonly kind: "success";
+} | {
+    readonly kind: "failed";
+    readonly error: string;
+} | {
+    readonly kind: "canceled";
+};
+/**
+ * What the kernel keeps beside a job's row: the function it calls, which a
+ * handle may place in another component, whether a standing source owns the
+ * job, and the test world whose invocation scheduled it. The row holds only
+ * what Convex's system table holds.
+ */
+export interface Target {
+    readonly functionPath: FunctionPath;
+    readonly standing: boolean;
+    /**
+     * The job runs as a fresh invocation of this world, with its services, or
+     * unbound when no invocation was bound as it was scheduled.
+     */
+    readonly world: Invocation.World | undefined;
+}
+/**
+ * A pending job as a driver sees it.
+ */
+export interface Job {
+    readonly id: DocumentId;
+    readonly componentPath: string;
+    readonly name: string;
+    readonly scheduledTime: number;
+    /**
+     * A standing job is never drain work. Time reaches it through `advance`.
+     */
+    readonly standing: boolean;
+}
+/**
+ * A pending job with what running it needs.
+ */
+export interface Due extends Job {
+    readonly target: FunctionPath;
+    readonly args: Value;
+    readonly world: Invocation.World | undefined;
+}
+export declare const row: (id: DocumentId, creationTime: number, name: string, args: Value, scheduledTime: number) => StoredDocument;
+export declare const stateOf: (doc: StoredDocument) => JobState;
+/**
+ * Every committed pending job of every component, earliest deadline first. Jobs
+ * that share a deadline run in the order they were scheduled.
+ */
+export declare const pending: (state: Kernel.State, targets: ReadonlyMap<DocumentId, Target>) => Array<Due>;
+/**
+ * The distinct functions of `jobs`, for a refusal that names what is left.
+ */
+export declare const functions: (jobs: ReadonlyArray<Job>) => Array<{
+    readonly componentPath: string;
+    readonly name: string;
+}>;
+//# sourceMappingURL=Scheduling.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduling.d.ts","sourceRoot":"","sources":["../../src/internal/Scheduling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,KAAK,UAAU,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,eAAO,MAAM,KAAK,yBAAyB,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAElC;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,GAAI,SAAQ,GAAG;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;CAC9C;AAED,eAAO,MAAM,GAAG,OACV,UAAU,gBACA,MAAM,QACd,MAAM,QACN,KAAK,iBACI,MAAM,KACpB,cAOD,CAAC;AAEH,eAAO,MAAM,OAAO,QAAS,cAAc,KAAG,QACpB,CAAC;AAK3B;;;GAGG;AACH,eAAO,MAAM,OAAO,UACX,MAAM,CAAC,KAAK,WACV,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,KACvC,KAAK,CAAC,GAAG,CAwBX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,SACd,aAAa,CAAC,GAAG,CAAC,KACvB,KAAK,CAAC;IAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMjE,CAAC"}

package/dist/internal/Scheduling.js

@@ -0,0 +1,60 @@
+//#region src/internal/Scheduling.ts
+/**
+* Convex's system table of scheduled functions. Each component has its own.
+*/
+const table = "_scheduled_functions";
+const row = (id, creationTime, name, args, scheduledTime) => ({
+	_id: id,
+	_creationTime: creationTime,
+	name,
+	args: [args],
+	scheduledTime,
+	state: { kind: "pending" }
+});
+const stateOf = (doc) => doc["state"];
+const byDeadline = (a, b) => a.scheduledTime - b.scheduledTime || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+/**
+* Every committed pending job of every component, earliest deadline first. Jobs
+* that share a deadline run in the order they were scheduled.
+*/
+const pending = (state, targets) => {
+	const due = [];
+	for (const [componentPath, tables] of state.tables) for (const { doc } of tables.get("_scheduled_functions")?.values() ?? []) {
+		if (stateOf(doc).kind !== "pending") continue;
+		const name = doc["name"];
+		const target = targets.get(doc._id) ?? {
+			functionPath: {
+				componentPath,
+				udfPath: name
+			},
+			standing: false,
+			world: void 0
+		};
+		due.push({
+			id: doc._id,
+			componentPath,
+			name,
+			scheduledTime: doc["scheduledTime"],
+			standing: target.standing,
+			target: target.functionPath,
+			args: doc["args"][0],
+			world: target.world
+		});
+	}
+	return due.sort(byDeadline);
+};
+/**
+* The distinct functions of `jobs`, for a refusal that names what is left.
+*/
+const functions = (jobs) => {
+	const seen = /* @__PURE__ */ new Map();
+	for (const { componentPath, name } of jobs) seen.set(`${componentPath}\u0000${name}`, {
+		componentPath,
+		name
+	});
+	return [...seen.values()];
+};
+//#endregion
+export { functions, pending, row, stateOf, table };
+
+//# sourceMappingURL=Scheduling.js.map

package/dist/internal/Scheduling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduling.js","names":[],"sources":["../../src/internal/Scheduling.ts"],"sourcesContent":["import type { Value } from \"convex/values\";\nimport type * as Invocation from \"./Invocation.js\";\nimport type * as Kernel from \"./Kernel.js\";\nimport type {\n  DocumentId,\n  FunctionPath,\n  StoredDocument,\n} from \"./KernelValues.js\";\n\n/**\n * Convex's system table of scheduled functions. Each component has its own.\n */\nexport const table = \"_scheduled_functions\";\n\nexport type JobState =\n  | { readonly kind: \"pending\" }\n  | { readonly kind: \"inProgress\" }\n  | { readonly kind: \"success\" }\n  | { readonly kind: \"failed\"; readonly error: string }\n  | { readonly kind: \"canceled\" };\n\n/**\n * What the kernel keeps beside a job's row: the function it calls, which a\n * handle may place in another component, whether a standing source owns the\n * job, and the test world whose invocation scheduled it. The row holds only\n * what Convex's system table holds.\n */\nexport interface Target {\n  readonly functionPath: FunctionPath;\n  readonly standing: boolean;\n  /**\n   * The job runs as a fresh invocation of this world, with its services, or\n   * unbound when no invocation was bound as it was scheduled.\n   */\n  readonly world: Invocation.World | undefined;\n}\n\n/**\n * A pending job as a driver sees it.\n */\nexport interface Job {\n  readonly id: DocumentId;\n  readonly componentPath: string;\n  readonly name: string;\n  readonly scheduledTime: number;\n  /**\n   * A standing job is never drain work. Time reaches it through `advance`.\n   */\n  readonly standing: boolean;\n}\n\n/**\n * A pending job with what running it needs.\n */\nexport interface Due extends Job {\n  readonly target: FunctionPath;\n  readonly args: Value;\n  readonly world: Invocation.World | undefined;\n}\n\nexport const row = (\n  id: DocumentId,\n  creationTime: number,\n  name: string,\n  args: Value,\n  scheduledTime: number,\n): StoredDocument => ({\n  _id: id,\n  _creationTime: creationTime,\n  name,\n  args: [args],\n  scheduledTime,\n  state: { kind: \"pending\" },\n});\n\nexport const stateOf = (doc: StoredDocument): JobState =>\n  doc[\"state\"] as JobState;\n\nconst byDeadline = (a: Due, b: Due) =>\n  a.scheduledTime - b.scheduledTime || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0);\n\n/**\n * Every committed pending job of every component, earliest deadline first. Jobs\n * that share a deadline run in the order they were scheduled.\n */\nexport const pending = (\n  state: Kernel.State,\n  targets: ReadonlyMap<DocumentId, Target>,\n): Array<Due> => {\n  const due: Array<Due> = [];\n  for (const [componentPath, tables] of state.tables) {\n    for (const { doc } of tables.get(table)?.values() ?? []) {\n      if (stateOf(doc).kind !== \"pending\") continue;\n      const name = doc[\"name\"] as string;\n      const target = targets.get(doc._id) ?? {\n        functionPath: { componentPath, udfPath: name },\n        standing: false,\n        world: undefined,\n      };\n      due.push({\n        id: doc._id,\n        componentPath,\n        name,\n        scheduledTime: doc[\"scheduledTime\"] as number,\n        standing: target.standing,\n        target: target.functionPath,\n        args: (doc[\"args\"] as ReadonlyArray<Value>)[0]!,\n        world: target.world,\n      });\n    }\n  }\n  return due.sort(byDeadline);\n};\n\n/**\n * The distinct functions of `jobs`, for a refusal that names what is left.\n */\nexport const functions = (\n  jobs: ReadonlyArray<Job>,\n): Array<{ readonly componentPath: string; readonly name: string }> => {\n  const seen = new Map<string, { componentPath: string; name: string }>();\n  for (const { componentPath, name } of jobs) {\n    seen.set(`${componentPath}\\u0000${name}`, { componentPath, name });\n  }\n  return [...seen.values()];\n};\n"],"mappings":";;;;AAYA,MAAa,QAAQ;AAgDrB,MAAa,OACX,IACA,cACA,MACA,MACA,mBACoB;CACpB,KAAK;CACL,eAAe;CACf;CACA,MAAM,CAAC,IAAI;CACX;CACA,OAAO,EAAE,MAAM,UAAU;AAC3B;AAEA,MAAa,WAAW,QACtB,IAAI;AAEN,MAAM,cAAc,GAAQ,MAC1B,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI;;;;;AAM7E,MAAa,WACX,OACA,YACe;CACf,MAAM,MAAkB,CAAC;CACzB,KAAK,MAAM,CAAC,eAAe,WAAW,MAAM,QAC1C,KAAK,MAAM,EAAE,SAAS,OAAO,IAAA,sBAAS,CAAC,EAAE,OAAO,KAAK,CAAC,GAAG;EACvD,IAAI,QAAQ,GAAG,CAAC,CAAC,SAAS,WAAW;EACrC,MAAM,OAAO,IAAI;EACjB,MAAM,SAAS,QAAQ,IAAI,IAAI,GAAG,KAAK;GACrC,cAAc;IAAE;IAAe,SAAS;GAAK;GAC7C,UAAU;GACV,OAAO,KAAA;EACT;EACA,IAAI,KAAK;GACP,IAAI,IAAI;GACR;GACA;GACA,eAAe,IAAI;GACnB,UAAU,OAAO;GACjB,QAAQ,OAAO;GACf,MAAO,IAAI,OAAO,CAA0B;GAC5C,OAAO,OAAO;EAChB,CAAC;CACH;CAEF,OAAO,IAAI,KAAK,UAAU;AAC5B;;;;AAKA,MAAa,aACX,SACqE;CACrE,MAAM,uBAAO,IAAI,IAAqD;CACtE,KAAK,MAAM,EAAE,eAAe,UAAU,MACpC,KAAK,IAAI,GAAG,cAAc,QAAQ,QAAQ;EAAE;EAAe;CAAK,CAAC;CAEnE,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC;AAC1B"}

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@gaganref/confect-test",
-  "version": "10.3.1-fork.9",
+  "version": "10.3.1-fork.90",
   "peerDependencies": {
-    "@confect/core": "npm:@gaganref/confect-core@10.3.1-fork.9",
-    "@confect/server": "npm:@gaganref/confect-server@10.3.1-fork.9",
+    "@confect/core": "npm:@gaganref/confect-core@10.3.1-fork.90",
+    "@confect/server": "npm:@gaganref/confect-server@10.3.1-fork.90",
     "convex": "^1.32.0",
-    "convex-test": ">=0.0.50 <0.1.0",
-    "effect": "^4.0.0"
+    "convex-test": ">=0.0.65 <0.1.0",
+    "effect": ">=4.0.0 <4.1.0"
   },
   "description": "Utilities for testing Confect apps without a live Convex backend",
   "author": "RJ Dellecese",

package/src/TestConfect.ts

@@ -1,4 +1,4 @@
-import { App, Ref } from "@confect/core";
+import { App, type Mount, Ref } from "@confect/core";
 import type { DatabaseSchema, DataModel } from "@confect/server";
 import { RegisteredConvexFunction } from "@confect/server";
 import type {
@@ -7,7 +7,6 @@ import type {
 } from "convex-test";
 import { convexTest } from "convex-test";
 import type {
-  GenericDataModel,
   GenericMutationCtx,
   GenericSchema,
   SchemaDefinition,
@@ -18,13 +17,33 @@ import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Schema from "effect/Schema";
+import { convexTest as kernelTest } from "./internal/ConvexTest.js";
 import * as MountedHttp from "./internal/MountedHttp.js";
 
+declare const process: { env: Record<string, string | undefined> };
+
+/**
+ * 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.
@@ -34,7 +53,22 @@ export type HttpMount = {
   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.
    */
@@ -101,6 +135,7 @@ export type TestConfect<ConfectSchema extends DatabaseSchema.AnyWithProps> = {
     componentPath: string,
     schema: SchemaDefinition<GenericSchema, boolean>,
     modules: Record<string, () => Promise<any>>,
+    options?: RegisterOptions,
   ) => Effect.Effect<void>;
   withIdentity: (
     userIdentity: Partial<UserIdentity>,
@@ -256,9 +291,9 @@ class TestConfectImpl<
 
   readonly registerComponent: TestConfect<ConfectSchema>["registerComponent"] =
     Effect.fn("TestConfect.registerComponent")(
-      (componentPath, schema, modules) =>
+      (componentPath, schema, modules, options) =>
         Effect.sync(() =>
-          this.mountedHttp.register(componentPath, schema, modules),
+          this.mountedHttp.register(componentPath, schema, modules, options),
         ),
     );
 
@@ -302,8 +337,8 @@ class TestConfectImpl<
 
 /**
  * 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 =
   | {
@@ -317,6 +352,11 @@ export type ComponentKit =
       ): unknown;
     };
 
+class InvalidComponentKit extends Schema.TaggedError<InvalidComponentKit>()(
+  "InvalidComponentKit",
+  { componentPath: Schema.String, message: Schema.String },
+) {}
+
 const registerKit = (
   registerComponent: RegisterComponent,
   name: string,
@@ -324,8 +364,14 @@ const registerKit = (
 ) => {
   if ("register" in kit) {
     kit.register({ registerComponent }, name);
-  } else {
+  } else if ("schema" in kit && "modules" in kit) {
     registerComponent(name, kit.schema, kit.modules);
+  } else {
+    // Codegen accepts a kit whose exports it cannot list, such as CommonJS.
+    throw new InvalidComponentKit({
+      componentPath: name,
+      message: `The test kit for ${JSON.stringify(name)} must export register(t, name), or schema and modules.`,
+    });
   }
 };
 
@@ -350,9 +396,12 @@ export type DeclaredApp<DatabaseSchema_ extends DatabaseSchema.AnyWithProps> =
 /**
  * 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 function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(
   app: DeclaredApp<DatabaseSchema_>,
+  options?: TargetOptions,
 ): Layer.Layer<TestConfect<DatabaseSchema_>>;
 export function layer<
   A extends App.Any,
@@ -362,11 +411,12 @@ export function layer<
   registry: Registry<DatabaseSchema_> & {
     readonly components: Readonly<
       Record<
-        keyof NoInfer<A>["mounts"],
+        Mount.NameOf<NoInfer<A>["mounts"][number]>,
         Registry<DatabaseSchema_>["components"][string]
       >
     >;
   },
+  options?: TargetOptions,
 ): Layer.Layer<TestConfect<DatabaseSchema_>>;
 export function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(
   databaseSchema: DatabaseSchema_,
@@ -376,20 +426,22 @@ export function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(
 ): Layer.Layer<TestConfect<DatabaseSchema_>>;
 export function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(
   appOrSchema: App.Any | DeclaredApp<DatabaseSchema_> | DatabaseSchema_,
-  registryOrSchema?:
+  second?:
     | Registry<DatabaseSchema_>
-    | SchemaDefinition<GenericSchema, true>,
-  modules?: Record<string, () => Promise<any>>,
+    | SchemaDefinition<GenericSchema, true>
+    | TargetOptions,
+  third?: Record<string, () => Promise<any>> | TargetOptions,
   options: LayerOptions = {},
 ): Layer.Layer<TestConfect<DatabaseSchema_>> {
   if (App.isApp(appOrSchema)) {
-    const registry = registryOrSchema as Registry<DatabaseSchema_>;
+    const registry = second as Registry<DatabaseSchema_>;
     const mounts = App.mounts(appOrSchema);
     return schemaLayer(
       registry.schema,
       registry.convexSchema,
       registry.modules,
       {
+        ...targetOf(third as TargetOptions | undefined),
         httpMounts: mounts.flatMap(({ name, httpPrefix }) =>
           httpPrefix === undefined ? [] : [{ componentPath: name, httpPrefix }],
         ),
@@ -411,6 +463,7 @@ export function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(
   if ("httpMounts" in appOrSchema) {
     const app = appOrSchema as DeclaredApp<DatabaseSchema_>;
     return schemaLayer(app.schema, app.convexSchema, app.modules, {
+      ...targetOf(second as TargetOptions | undefined),
       httpMounts: app.httpMounts,
       register: (registerComponent) => {
         for (const [name, component] of Object.entries(app.components)) {
@@ -421,12 +474,15 @@ export function layer<DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(
   }
   return schemaLayer(
     appOrSchema as DatabaseSchema_,
-    registryOrSchema as SchemaDefinition<GenericSchema, true>,
-    modules!,
+    second as SchemaDefinition<GenericSchema, true>,
+    third as Record<string, () => Promise<any>>,
     options,
   );
 }
 
+const targetOf = (options: TargetOptions | undefined): TargetOptions =>
+  options?.target === undefined ? {} : { target: options.target };
+
 const schemaLayer = <DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(
   databaseSchema: DatabaseSchema_,
   convexSchemaDefinition: SchemaDefinition<GenericSchema, true>,
@@ -434,9 +490,18 @@ const schemaLayer = <DatabaseSchema_ extends DatabaseSchema.AnyWithProps>(
   options: LayerOptions = {},
 ): Layer.Layer<TestConfect<DatabaseSchema_>> =>
   Layer.sync(TestConfect<DatabaseSchema_>(), () => {
-    const testConvex = convexTest(convexSchemaDefinition, modules);
+    process.env.CONVEX_CLOUD_URL ??= "https://some-deployment.convex.cloud";
+    process.env.CONVEX_SITE_URL ??= "https://some.convex.site";
+    const testConvex = (options.target === "kernel" ? kernelTest : convexTest)(
+      convexSchemaDefinition,
+      modules,
+    );
+    // convex-test takes three arguments and ignores the options. The kernel
+    // reads `standing`.
+    const registerComponent =
+      testConvex.registerComponent as unknown as RegisterComponent;
     const mountedHttp = MountedHttp.make(options.httpMounts ?? [], (...args) =>
-      testConvex.registerComponent(...args),
+      registerComponent(...args),
     );
     options.register?.(mountedHttp.register);
     return new TestConfectImpl(databaseSchema, testConvex as any, mountedHttp);