@gaganref/confect-core 10.3.1-fork.5 → 10.3.1-fork.50

package/src/FunctionSpec.ts

@@ -1,3 +1,4 @@
+import type * as ManifestSection from "./ManifestSection.js";
 import type * as MiddlewareAttachment from "./MiddlewareAttachment.js";
 import type {
   DefaultFunctionArgs,
@@ -7,11 +8,12 @@ import type {
   RegisteredMutation,
   RegisteredQuery,
 } from "convex/server";
-import type * as Schema from "effect/Schema";
+import * as Schema from "effect/Schema";
 import * as Predicate from "effect/Predicate";
 import * as FunctionProvenance from "./FunctionProvenance.js";
 import { validateConfectFunctionIdentifier } from "./Identifier.js";
-import type * as MiddlewareSpec from "./MiddlewareSpec.js";
+import * as MiddlewareSpec from "./MiddlewareSpec.js";
+import type * as Profile from "./Profile.js";
 import * as RuntimeAndFunctionType from "./RuntimeAndFunctionType.js";
 
 export const TypeId = "~@confect/core/FunctionSpec";
@@ -31,6 +33,8 @@ export interface FunctionSpec<
   readonly runtimeAndFunctionType: RuntimeAndFunctionType_;
   readonly functionVisibility: FunctionVisibility_;
   readonly name: Name_;
+  readonly reservedArgument?: string;
+  readonly manifestSections?: ReadonlyArray<ManifestSection.Entry>;
   readonly functionProvenance: FunctionProvenance_;
   readonly middlewareSpecs: ReadonlyArray<MiddlewareSpecs_>;
   readonly middlewareAttachments: ReadonlyArray<
@@ -69,6 +73,78 @@ export interface Builder<
   >;
 }
 
+export interface DescribedBuilder<
+  RuntimeAndFunctionType_ extends RuntimeAndFunctionType.RuntimeAndFunctionType,
+  FunctionVisibility_ extends FunctionVisibility,
+  Name_ extends string,
+  FunctionProvenance_ extends FunctionProvenance.FunctionProvenance,
+  MiddlewareSpecs_ extends MiddlewareSpec.AnyMiddlewareSpec = never,
+> extends Builder<
+  RuntimeAndFunctionType_,
+  FunctionVisibility_,
+  Name_,
+  FunctionProvenance_,
+  MiddlewareSpecs_
+> {
+  readonly description?: string;
+
+  middleware<MiddlewareSpec_ extends MiddlewareSpec.AnyMiddlewareSpec>(
+    middlewareSpec: MiddlewareSpec_ &
+      MiddlewareSpec.ValidateFunctionAttach<
+        MiddlewareSpec_,
+        RuntimeAndFunctionType_,
+        FunctionProvenance_,
+        MiddlewareSpecs_
+      >,
+    ...options: MiddlewareAttachment.Args<NoInfer<MiddlewareSpec_>>
+  ): DescribedBuilder<
+    RuntimeAndFunctionType_,
+    FunctionVisibility_,
+    Name_,
+    FunctionProvenance_,
+    MiddlewareSpecs_ | MiddlewareSpec_
+  >;
+}
+
+/**
+ * A spec built through {@link extend}, keeping its fields through middleware.
+ */
+export interface ExtendedBuilder<
+  RuntimeAndFunctionType_ extends RuntimeAndFunctionType.RuntimeAndFunctionType,
+  FunctionVisibility_ extends FunctionVisibility,
+  Name_ extends string,
+  FunctionProvenance_ extends FunctionProvenance.FunctionProvenance,
+  MiddlewareSpecs_ extends MiddlewareSpec.AnyMiddlewareSpec,
+  Fields_,
+> extends Builder<
+  RuntimeAndFunctionType_,
+  FunctionVisibility_,
+  Name_,
+  FunctionProvenance_,
+  MiddlewareSpecs_
+> {
+  readonly description?: string;
+  readonly fields: Profile.Info<Fields_>["fields"];
+
+  middleware<MiddlewareSpec_ extends MiddlewareSpec.AnyMiddlewareSpec>(
+    middlewareSpec: MiddlewareSpec_ &
+      MiddlewareSpec.ValidateFunctionAttach<
+        MiddlewareSpec_,
+        RuntimeAndFunctionType_,
+        FunctionProvenance_,
+        MiddlewareSpecs_
+      >,
+    ...options: MiddlewareAttachment.Args<NoInfer<MiddlewareSpec_>>
+  ): ExtendedBuilder<
+    RuntimeAndFunctionType_,
+    FunctionVisibility_,
+    Name_,
+    FunctionProvenance_,
+    MiddlewareSpecs_ | MiddlewareSpec_,
+    Fields_
+  >;
+}
+
 export interface Any {
   readonly [TypeId]: TypeId;
 }
@@ -79,7 +155,10 @@ export interface AnyWithProps extends FunctionSpec<
   string,
   FunctionProvenance.FunctionProvenance,
   MiddlewareSpec.AnyMiddlewareSpec
-> {}
+> {
+  readonly description?: string;
+  readonly fields?: object;
+}
 
 export interface AnyConfect extends FunctionSpec<
   RuntimeAndFunctionType.RuntimeAndFunctionType,
@@ -326,6 +405,14 @@ const Proto = {
       runtimeAndFunctionType: this.runtimeAndFunctionType,
       functionVisibility: this.functionVisibility,
       name: this.name,
+      ...(this.manifestSections === undefined
+        ? {}
+        : { manifestSections: this.manifestSections }),
+      ...(this.reservedArgument === undefined
+        ? {}
+        : { reservedArgument: this.reservedArgument }),
+      ...("description" in this ? { description: this.description } : {}),
+      ...("fields" in this ? { fields: this.fields } : {}),
       functionProvenance: this.functionProvenance,
       middlewareAttachments: [
         ...this.middlewareAttachments,
@@ -336,6 +423,8 @@ const Proto = {
 } satisfies ThisType<AnyWithProps>;
 
 interface Options {
+  readonly reservedArgument?: string;
+  readonly description?: string;
   readonly name: string;
   readonly args?: () => FunctionProvenance.ArgsFields;
   readonly returns: () => Schema.Codec<any, any>;
@@ -355,7 +444,11 @@ const make = <
     Returns_ extends Schema.Codec<any, any>,
     Error_ extends Schema.Codec<any, any> = never,
   >(options: {
+    reservedArgument?: RuntimeAndFunctionType_["functionType"] extends "query"
+      ? never
+      : string;
     name: Name_;
+    description?: never;
     args: () => ArgsFields_;
     returns: () => Returns_;
     error?: () => Error_;
@@ -370,7 +463,11 @@ const make = <
     Returns_ extends Schema.Codec<any, any>,
     Error_ extends Schema.Codec<any, any> = never,
   >(options: {
+    reservedArgument?: RuntimeAndFunctionType_["functionType"] extends "query"
+      ? never
+      : string;
     name: Name_;
+    description?: never;
     args?: never;
     returns: () => Returns_;
     error?: () => Error_;
@@ -380,13 +477,64 @@ const make = <
     Name_,
     FunctionProvenance.Confect<{}, Returns_, Error_>
   >;
-  function makeSpec({ name, args, returns, error }: Options) {
+  function makeSpec<
+    const Name_ extends string,
+    const ArgsFields_ extends FunctionProvenance.ArgsFields,
+    Returns_ extends Schema.Codec<any, any>,
+    Error_ extends Schema.Codec<any, any> = never,
+  >(options: {
+    reservedArgument?: RuntimeAndFunctionType_["functionType"] extends "query"
+      ? never
+      : string;
+    name: Name_;
+    description?: FunctionVisibility_ extends "public" ? string : never;
+    args: () => ArgsFields_;
+    returns: () => Returns_;
+    error?: () => Error_;
+  }): DescribedBuilder<
+    RuntimeAndFunctionType_,
+    FunctionVisibility_,
+    Name_,
+    FunctionProvenance.Confect<ArgsFields_, Returns_, Error_>
+  >;
+  function makeSpec<
+    const Name_ extends string,
+    Returns_ extends Schema.Codec<any, any>,
+    Error_ extends Schema.Codec<any, any> = never,
+  >(options: {
+    reservedArgument?: RuntimeAndFunctionType_["functionType"] extends "query"
+      ? never
+      : string;
+    name: Name_;
+    description?: FunctionVisibility_ extends "public" ? string : never;
+    args?: never;
+    returns: () => Returns_;
+    error?: () => Error_;
+  }): DescribedBuilder<
+    RuntimeAndFunctionType_,
+    FunctionVisibility_,
+    Name_,
+    FunctionProvenance.Confect<{}, Returns_, Error_>
+  >;
+  function makeSpec({
+    name,
+    description,
+    args,
+    returns,
+    error,
+    reservedArgument,
+  }: Options) {
     validateConfectFunctionIdentifier(name);
 
     return Object.assign(Object.create(Proto), {
       runtimeAndFunctionType,
       functionVisibility,
       name,
+      ...(runtimeAndFunctionType.functionType !== "query" &&
+      reservedArgument !== undefined
+        ? { reservedArgument }
+        : {}),
+      ...(description === undefined ? {} : { description }),
       functionProvenance:
         args === undefined
           ? FunctionProvenance.Confect(() => ({}), returns, error)
@@ -411,6 +559,7 @@ type ForbidPaginationOpts<
   : unknown;
 
 interface PaginatedOptions {
+  readonly description?: string;
   readonly name: string;
   readonly args?: () => FunctionProvenance.ArgsFields;
   readonly item: () => Schema.Codec<any, any>;
@@ -431,6 +580,7 @@ const makePaginated = <
     Error_ extends Schema.Codec<any, any> = never,
   >(options: {
     name: Name_;
+    description?: never;
     args: () => UserArgsFields_ & ForbidPaginationOpts<UserArgsFields_>;
     item: () => Item_;
     error?: () => Error_;
@@ -446,6 +596,7 @@ const makePaginated = <
     Error_ extends Schema.Codec<any, any> = never,
   >(options: {
     name: Name_;
+    description?: never;
     args?: never;
     item: () => Item_;
     error?: () => Error_;
@@ -455,13 +606,53 @@ const makePaginated = <
     Name_,
     FunctionProvenance.ConfectPaginated<{}, Item_, Error_>
   >;
-  function makeSpec({ name, args, item, error }: PaginatedOptions) {
+  function makeSpec<
+    const Name_ extends string,
+    const UserArgsFields_ extends FunctionProvenance.ArgsFields,
+    Item_ extends Schema.Codec<any, any>,
+    Error_ extends Schema.Codec<any, any> = never,
+  >(options: {
+    name: Name_;
+    description?: FunctionVisibility_ extends "public" ? string : never;
+    args: () => UserArgsFields_ & ForbidPaginationOpts<UserArgsFields_>;
+    item: () => Item_;
+    error?: () => Error_;
+  }): DescribedBuilder<
+    RuntimeAndFunctionType_,
+    FunctionVisibility_,
+    Name_,
+    FunctionProvenance.ConfectPaginated<UserArgsFields_, Item_, Error_>
+  >;
+  function makeSpec<
+    const Name_ extends string,
+    Item_ extends Schema.Codec<any, any>,
+    Error_ extends Schema.Codec<any, any> = never,
+  >(options: {
+    name: Name_;
+    description?: FunctionVisibility_ extends "public" ? string : never;
+    args?: never;
+    item: () => Item_;
+    error?: () => Error_;
+  }): DescribedBuilder<
+    RuntimeAndFunctionType_,
+    FunctionVisibility_,
+    Name_,
+    FunctionProvenance.ConfectPaginated<{}, Item_, Error_>
+  >;
+  function makeSpec({
+    name,
+    description,
+    args,
+    item,
+    error,
+  }: PaginatedOptions) {
     validateConfectFunctionIdentifier(name);
 
     return Object.assign(Object.create(Proto), {
       runtimeAndFunctionType,
       functionVisibility,
       name,
+      ...(description === undefined ? {} : { description }),
       functionProvenance:
         args === undefined
           ? FunctionProvenance.ConfectPaginated(() => ({}), item, error)
@@ -509,6 +700,380 @@ export const internalNodeAction = make(
   "internal",
 );
 
+type OptionlessMiddlewareSpec = MiddlewareSpec.AnyMiddlewareSpec & {
+  readonly "~Options": never;
+};
+
+type BuilderOption =
+  | "name"
+  | "description"
+  | "args"
+  | "returns"
+  | "item"
+  | "error";
+
+/**
+ * Only a required description string may name a builder option. The builder
+ * reads it as that option. The conditional keeps the mapped type out of a
+ * builder call's inference, which would otherwise widen the function's name to
+ * `string` when reporting the error.
+ */
+type OptionFree<Type> = [keyof Type & BuilderOption] extends [never]
+  ? unknown
+  : {
+      readonly [
+        Option in keyof Type & BuilderOption as Option extends "description"
+          ? Type[Option] extends string
+            ? string extends Type[Option]
+              ? never
+              : Option
+            : Option
+          : Option
+      ]: never;
+    };
+
+/**
+ * A function's fields, checked once applied, since a profile's field type can
+ * branch on the function's name.
+ */
+type CheckedFields<Type> = Type & OptionFree<Type>;
+
+type NotRepeated<
+  Middleware_,
+  Inherited extends MiddlewareSpec.AnyMiddlewareSpec,
+> = Middleware_ extends {
+  readonly key: infer Key extends MiddlewareSpec.Key<Inherited>;
+}
+  ? MiddlewareSpec.AttachmentError<`Middleware "${Key}" is already attached by this profile`>
+  : Middleware_;
+
+/**
+ * Refuses a middleware without options that an earlier layer attached, as it is
+ * attached at most once; one with options may repeat. Each member of an
+ * element's union is checked, so an array typed `(A | B)[]` is refused when
+ * either was attached.
+ */
+type NotInherited<
+  Middleware_ extends ReadonlyArray<unknown>,
+  Inherited extends MiddlewareSpec.AnyMiddlewareSpec,
+> = {
+  readonly [Index in keyof Middleware_]: NotRepeated<
+    Middleware_[Index],
+    Inherited
+  >;
+};
+
+/**
+ * A profile's middleware: a spec without options, or an attachment.
+ */
+type ProfileMiddleware<FieldsType> =
+  | OptionlessMiddlewareSpec
+  | Profile.Attachment<MiddlewareSpec.AnyMiddlewareSpec, FieldsType>;
+
+type SpecOf<Middleware_> =
+  Middleware_ extends Profile.Attachment<infer MiddlewareSpec_, any>
+    ? MiddlewareSpec_
+    : Extract<Middleware_, MiddlewareSpec.AnyMiddlewareSpec>;
+
+/**
+ * `never` when a profile middleware does not declare the function type.
+ */
+type Declared<
+  MiddlewareSpecs_ extends MiddlewareSpec.AnyMiddlewareSpec,
+  FunctionType_ extends FunctionType,
+  Make,
+> = [
+  MiddlewareSpecs_ extends unknown
+    ? FunctionType_ extends MiddlewareSpec.FunctionTypes<MiddlewareSpecs_>
+      ? never
+      : MiddlewareSpecs_
+    : never,
+] extends [never]
+  ? Make
+  : never;
+
+type Wrapped<
+  Layers extends ReadonlyArray<Profile.Transforms>,
+  Key extends keyof Profile.Transforms,
+  Input,
+> = Layers extends readonly [
+  infer First extends Profile.Transforms,
+  ...infer Rest extends ReadonlyArray<Profile.Transforms>,
+]
+  ? Wrapped<
+      Rest,
+      Key,
+      Key extends keyof First
+        ? [Input] extends [never]
+          ? Key extends "error"
+            ? Profile.Transform<First[Key], typeof Schema.Never>
+            : never
+          : Profile.Transform<First[Key], Input>
+        : Input
+    >
+  : Input;
+
+type UserArgs<A> = [A] extends [never] ? {} : A;
+
+type ExtendedMake<
+  RuntimeAndFunctionType_ extends RuntimeAndFunctionType.RuntimeAndFunctionType,
+  Fields_ extends Profile.Fields,
+  MiddlewareSpecs_ extends MiddlewareSpec.AnyMiddlewareSpec,
+  Layers extends ReadonlyArray<Profile.Transforms>,
+> = Declared<
+  MiddlewareSpecs_,
+  RuntimeAndFunctionType_["functionType"],
+  <
+    const Name_ extends string,
+    const ArgsFields_ extends FunctionProvenance.ArgsFields = never,
+    Returns_ extends Schema.Codec<any, any> = never,
+    Error_ extends Schema.Codec<any, any> = never,
+  >(
+    options: {
+      readonly name: Name_;
+      readonly description?: string;
+      readonly args?: () => ArgsFields_;
+      readonly returns: () => Returns_;
+      readonly error?: () => Error_;
+    } & NoInfer<
+      CheckedFields<Profile.Apply<Fields_, Name_, UserArgs<ArgsFields_>>>
+    >,
+  ) => ExtendedBuilder<
+    RuntimeAndFunctionType_,
+    "public",
+    Name_,
+    FunctionProvenance.Confect<
+      UserArgs<Wrapped<Layers, "args", ArgsFields_>>,
+      Wrapped<Layers, "returns", Returns_>,
+      Wrapped<Layers, "error", Error_>
+    >,
+    MiddlewareSpecs_,
+    Profile.Apply<Fields_, Name_, UserArgs<ArgsFields_>>
+  >
+>;
+
+type ExtendedMakePaginated<
+  Fields_ extends Profile.Fields,
+  MiddlewareSpecs_ extends MiddlewareSpec.AnyMiddlewareSpec,
+  Layers extends ReadonlyArray<Profile.Transforms>,
+> = Declared<
+  MiddlewareSpecs_,
+  "query",
+  <
+    const Name_ extends string,
+    const UserArgsFields_ extends FunctionProvenance.ArgsFields = never,
+    Item_ extends Schema.Codec<any, any> = never,
+    Error_ extends Schema.Codec<any, any> = never,
+  >(
+    options: {
+      readonly name: Name_;
+      readonly description?: string;
+      readonly args?: () => UserArgsFields_ &
+        ForbidPaginationOpts<UserArgsFields_>;
+      readonly item: () => Item_;
+      readonly error?: () => Error_;
+    } & NoInfer<
+      CheckedFields<Profile.Apply<Fields_, Name_, UserArgs<UserArgsFields_>>>
+    >,
+  ) => ExtendedBuilder<
+    RuntimeAndFunctionType.ConvexQuery,
+    "public",
+    Name_,
+    FunctionProvenance.ConfectPaginated<
+      UserArgs<Wrapped<Layers, "args", UserArgsFields_>>,
+      Wrapped<Layers, "item", Item_>,
+      Wrapped<Layers, "error", Error_>
+    >,
+    MiddlewareSpecs_,
+    Profile.Apply<Fields_, Name_, UserArgs<UserArgsFields_>>
+  >
+>;
+
+interface ExtendedRuntimes {
+  readonly publicQuery: RuntimeAndFunctionType.ConvexQuery;
+  readonly publicMutation: RuntimeAndFunctionType.ConvexMutation;
+  readonly publicAction: RuntimeAndFunctionType.ConvexAction;
+  readonly publicNodeAction: RuntimeAndFunctionType.NodeAction;
+}
+
+/**
+ * A profile's five public builders and its own `extend`.
+ */
+export type Extended<
+  Fields_ extends Profile.Fields,
+  MiddlewareSpecs_ extends MiddlewareSpec.AnyMiddlewareSpec,
+  Layers extends ReadonlyArray<Profile.Transforms> = [],
+> = {
+  readonly [Builder_ in keyof ExtendedRuntimes]: ExtendedMake<
+    ExtendedRuntimes[Builder_],
+    Fields_,
+    MiddlewareSpecs_,
+    Layers
+  >;
+} & {
+  readonly publicPaginatedQuery: ExtendedMakePaginated<
+    Fields_,
+    MiddlewareSpecs_,
+    Layers
+  >;
+  /**
+   * Require more fields and attach more middleware after this profile's.
+   */
+  extend<
+    Extension extends Profile.Fields = Profile.NoFields,
+    Transforms extends Profile.Transforms = {},
+  >(): <
+    const Middleware_ extends ReadonlyArray<
+      ProfileMiddleware<
+        Profile.Apply<Profile.Both<Fields_, Extension>, string, any>
+      >
+    >,
+  >(
+    config: {
+      readonly manifest?: Readonly<
+        Record<string, ManifestSection.ManifestSection>
+      >;
+      readonly reservedArgument?: string;
+      readonly middleware: Middleware_ &
+        NotInherited<Middleware_, MiddlewareSpecs_>;
+    } & OptionFree<Extension["Type"]> &
+      Profile.SchemaConfig<
+        Transforms,
+        Profile.Apply<Profile.Both<Fields_, Extension>, string, any>
+      >,
+  ) => Extended<
+    Profile.Both<Fields_, Extension>,
+    MiddlewareSpecs_ | SpecOf<Middleware_[number]>,
+    [...Layers, Transforms]
+  >;
+};
+
+type RuntimeWrappers = Partial<
+  Record<
+    keyof Profile.Transforms,
+    (thunk: () => any, info: Profile.Info<any>) => () => any
+  >
+>;
+
+const makeExtended = (
+  middleware: ReadonlyArray<ProfileMiddleware<any>>,
+  schemas: ReadonlyArray<RuntimeWrappers> = [],
+  reservedArgument?: string,
+  manifestSections: ReadonlyArray<ManifestSection.Entry> = [],
+): Extended<any, any> => {
+  const extended =
+    (
+      makeSpec: (options: never) => object,
+      paginated = false,
+      reserves = false,
+    ): any =>
+    ({
+      name,
+      description,
+      args,
+      returns,
+      item,
+      error,
+      ...fields
+    }: Record<string, unknown>) => {
+      const info = {
+        name,
+        ...(description === undefined ? {} : { description }),
+        args: args ?? (() => ({})),
+        fields,
+      } as Profile.Info<unknown>;
+      const thunks = {
+        args,
+        returns: paginated ? undefined : returns,
+        item: paginated ? item : undefined,
+        error,
+      } as Partial<Record<keyof Profile.Transforms, () => any>>;
+      for (const wrappers of schemas) {
+        for (const key of ["args", "returns", "item", "error"] as const) {
+          const wrap = wrappers[key];
+          const thunk =
+            thunks[key] ?? (key === "error" ? () => Schema.Never : undefined);
+          if (wrap !== undefined && thunk !== undefined) {
+            thunks[key] = () => wrap(thunk, info)();
+          }
+        }
+      }
+      return middleware.reduce(
+        (spec: any, entry) =>
+          MiddlewareSpec.isMiddlewareSpec(entry)
+            ? spec.middleware(entry)
+            : spec.middleware(entry.spec, entry.options(info)),
+        Object.assign(makeSpec({ name, description, ...thunks } as never), {
+          fields,
+          manifestSections,
+          ...(reserves && reservedArgument !== undefined
+            ? { reservedArgument }
+            : {}),
+        }),
+      );
+    };
+
+  return {
+    publicQuery: extended(publicQuery),
+    publicMutation: extended(publicMutation, false, true),
+    publicAction: extended(publicAction, false, true),
+    publicNodeAction: extended(publicNodeAction, false, true),
+    publicPaginatedQuery: extended(publicPaginatedQuery, true),
+    extend:
+      () =>
+      (config: {
+        middleware: ReadonlyArray<ProfileMiddleware<any>>;
+        schemas?: RuntimeWrappers;
+        reservedArgument?: string;
+        manifest?: Readonly<Record<string, ManifestSection.ManifestSection>>;
+      }) =>
+        makeExtended(
+          [...middleware, ...config.middleware],
+          [...schemas, config.schemas ?? {}],
+          config.reservedArgument ?? reservedArgument,
+          [
+            ...manifestSections,
+            ...Object.entries(config.manifest ?? {}).map(([key, section]) => ({
+              key,
+              section,
+            })),
+          ],
+        ),
+  };
+};
+
+/**
+ * Public builders whose specs require and keep `Fields_`, with `middleware`.
+ */
+export const extend =
+  <
+    Fields_ extends Profile.Fields = Profile.NoFields,
+    Transforms extends Profile.Transforms = {},
+  >() =>
+  <
+    const Middleware_ extends ReadonlyArray<
+      ProfileMiddleware<Profile.Apply<Fields_, string, any>>
+    >,
+  >(
+    config: {
+      readonly manifest?: Readonly<
+        Record<string, ManifestSection.ManifestSection>
+      >;
+      readonly reservedArgument?: string;
+      readonly middleware: Middleware_;
+    } & OptionFree<Fields_["Type"]> &
+      Profile.SchemaConfig<Transforms, Profile.Apply<Fields_, string, any>>,
+  ) =>
+    makeExtended(
+      config.middleware,
+      [config.schemas ?? {}],
+      config.reservedArgument,
+      Object.entries(config.manifest ?? {}).map(([key, section]) => ({
+        key,
+        section,
+      })),
+    ) as Extended<Fields_, SpecOf<Middleware_[number]>, [Transforms]>;
+
 type MatchingRegisteredFunction<
   RuntimeAndFunctionType_ extends RuntimeAndFunctionType.RuntimeAndFunctionType,
   FunctionVisibility_ extends FunctionVisibility,

package/src/Http.ts

@@ -7,7 +7,7 @@ import * as SchemaAST from "effect/SchemaAST";
 import type * as HttpApi from "effect/http-api/HttpApi";
 import * as HttpApiBuilder from "effect/http-api/HttpApiBuilder";
 import type * as HttpApiGroup from "effect/http-api/HttpApiGroup";
-import * as HttpApiScalar from "effect/http-api/HttpApiScalar";
+import { scalarDocs } from "./internal/scalarDocs.js";
 import * as App from "./App.js";
 
 const TypeId = "~@confect/core/Http";
@@ -57,10 +57,7 @@ export const make = <
   const routes =
     options.docs === undefined
       ? api
-      : Layer.merge(
-          api,
-          HttpApiScalar.layerCdn(options.api, { path: options.docs }),
-        );
+      : Layer.merge(api, scalarDocs(options.api, options.docs));
   const http: Http<HttpApi.HttpApi<Id, Groups>, typeof routes> = {
     [TypeId]: TypeId,
     api: options.api,