@gaganref/confect-core 10.3.1-fork.7 → 10.3.1-fork.71

package/dist/Component.js.map

@@ -1 +1 @@
-{"version":3,"file":"Component.js","names":["Spec.groups","Ref.make","IdScope.instance","IdScope.app","rebase","GenericId.rebase","Ref.isRef","Ref.fromProvenance","GenericId.GenericId"],"sources":["../src/Component.ts"],"sourcesContent":["import type { DefaultFunctionArgs, FunctionReference } from \"convex/server\";\nimport { getFunctionAddress } from \"convex/server\";\nimport * as Array from \"effect/Array\";\nimport * as Data from \"effect/Data\";\nimport * as Result from \"effect/Result\";\nimport { memoize, pipe } from \"effect/Function\";\nimport * as Match from \"effect/Match\";\nimport * as Record from \"effect/Record\";\nimport * as Schema from \"effect/Schema\";\nimport type * as FunctionProvenance from \"./FunctionProvenance.js\";\nimport type * as FunctionSpec from \"./FunctionSpec.js\";\nimport * as GenericId from \"./GenericId.js\";\nimport type * as GroupSpec from \"./GroupSpec.js\";\nimport * as IdScope from \"./IdScope.js\";\nimport * as Lazy from \"./Lazy.js\";\nimport type * as MiddlewareSpec from \"./MiddlewareSpec.js\";\nimport * as Ref from \"./Ref.js\";\nimport type * as Refs from \"./Refs.js\";\nimport type * as RuntimeAndFunctionType from \"./RuntimeAndFunctionType.js\";\nimport * as Spec from \"./Spec.js\";\n\nexport class EmptyComponentScopeError extends Data.TaggedError(\n  \"EmptyComponentScopeError\",\n)<{\n  readonly definitionScope: IdScope.IdScope;\n}> {\n  override get message(): string {\n    return \"A component contract requires a nonempty definition scope.\";\n  }\n}\n\nexport class ComponentNameCollisionError extends Data.TaggedError(\n  \"ComponentNameCollisionError\",\n)<{\n  readonly groupPath: string;\n  readonly functionName: string;\n}> {\n  override get message(): string {\n    return `Group and function at same level have same name ('${this.groupPath}:${this.functionName}')`;\n  }\n}\n\nexport class UninstalledComponentReferenceError extends Data.TaggedError(\n  \"UninstalledComponentReferenceError\",\n)<{\n  readonly definitionScope: IdScope.IdScope;\n}> {\n  override get message(): string {\n    return \"Component.bind expects an installed component from the generated components registry.\";\n  }\n}\n\nconst validateNames = (\n  groups: Readonly<Record<string, GroupSpec.AnyWithProps>>,\n  prefix = \"\",\n): Result.Result<void, ComponentNameCollisionError> => {\n  for (const [name, group] of Record.toEntries(groups)) {\n    const path = prefix === \"\" ? name : `${prefix}/${name}`;\n    for (const functionSpec of Record.values(group.functions)) {\n      if (Record.has(group.groups, functionSpec.name)) {\n        return Result.fail(\n          new ComponentNameCollisionError({\n            groupPath: path,\n            functionName: functionSpec.name,\n          }),\n        );\n      }\n    }\n    const nested = validateNames(group.groups, path);\n    if (Result.isFailure(nested)) return nested;\n  }\n  return Result.succeed(undefined);\n};\n\nconst validateContract = (\n  scope: IdScope.IdScope,\n  groups: Readonly<Record<string, GroupSpec.AnyWithProps>>,\n): Result.Result<\n  void,\n  EmptyComponentScopeError | ComponentNameCollisionError\n> =>\n  scope === \"\"\n    ? Result.fail(new EmptyComponentScopeError({ definitionScope: scope }))\n    : validateNames(groups);\n\nconst TypeId = \"~@confect/core/Component\";\nconst BoundTypeId = \"~@confect/core/BoundComponent\";\n\n/**\n * Convex's generated ComponentApi erases database ID brands at the boundary.\n */\ntype Wire<A> = A extends { readonly __tableName: string }\n  ? string\n  : A extends\n        | string\n        | number\n        | bigint\n        | boolean\n        | null\n        | undefined\n        | ArrayBuffer\n    ? A\n    : { [K in keyof A]: Wire<A[K]> };\n\ntype OmitEmpty<A> = {\n  [K in keyof A as keyof A[K] extends never ? never : K]: A[K];\n};\ntype ApiGroups<\n  GroupSpec_ extends GroupSpec.AnyWithProps,\n  Name extends string | undefined,\n> = OmitEmpty<{\n  [GroupName in GroupSpec.Name<GroupSpec_>]: ApiGroup<\n    GroupSpec.WithName<GroupSpec_, GroupName>,\n    Name\n  >;\n}>;\ntype ApiGroup<\n  GroupSpec_ extends GroupSpec.AnyWithProps,\n  Name extends string | undefined,\n> = ApiGroups<GroupSpec.Groups<GroupSpec_>, Name> & {\n  [\n    FunctionSpec_ in GroupSpec.Functions<GroupSpec_> as FunctionSpec.GetFunctionVisibility<FunctionSpec_> extends \"public\"\n      ? FunctionSpec.Name<FunctionSpec_>\n      : never\n  ]: FunctionReference<\n    RuntimeAndFunctionType.GetFunctionType<\n      FunctionSpec_[\"runtimeAndFunctionType\"]\n    >,\n    \"internal\",\n    Extract<Wire<FunctionSpec.EncodedArgs<FunctionSpec_>>, DefaultFunctionArgs>,\n    Wire<FunctionSpec.EncodedReturns<FunctionSpec_>>,\n    Name\n  >;\n};\n\nexport type Api<\n  Spec_ extends Spec.AnyWithProps,\n  Name extends string | undefined = string | undefined,\n> = ApiGroups<Spec.Groups<Spec_>, Name>;\n\ninterface Tree {\n  readonly [key: string]: Tree | Ref.Any;\n}\n\nexport interface Component<\n  Spec_ extends Spec.AnyWithProps,\n  Scope extends IdScope.IdScope,\n  Tables extends string = string,\n> {\n  readonly [TypeId]: {\n    readonly refs: Tree;\n    readonly scope: Scope;\n    readonly tables: ReadonlyArray<Tables>;\n  };\n  readonly \"~Spec\": Spec_;\n}\n\n/**\n * An opaque identity: its string representation is not part of the API.\n */\nexport type MountScope<\n  Parent extends IdScope.IdScope,\n  Name extends string | undefined,\n> = IdScope.Mount<Parent, Name>;\n\ntype MountName<ComponentApi> =\n  ComponentApi extends FunctionReference<any, any, any, any, infer Name>\n    ? Name\n    : ComponentApi extends object\n      ? {\n          [Key in keyof ComponentApi]: MountName<ComponentApi[Key]>;\n        }[keyof ComponentApi]\n      : never;\n\ntype BindRefs<\n  RefTree,\n  From extends IdScope.IdScope,\n  To extends IdScope.IdScope,\n> = RefTree extends Ref.Any\n  ? RefTree extends { readonly _tag: \"Convex\" }\n    ? Ref.ConvexRef<\n        Ref.GetRuntimeAndFunctionType<RefTree>,\n        \"internal\",\n        Extract<Wire<Ref.Args<RefTree>>, DefaultFunctionArgs>,\n        Wire<Ref.Returns<RefTree>>\n      >\n    : Extract<\n        Ref.Ref<\n          Ref.GetRuntimeAndFunctionType<RefTree>,\n          \"internal\",\n          Extract<\n            GenericId.Rebase<Ref.Args<RefTree>, From, To>,\n            DefaultFunctionArgs\n          >,\n          GenericId.Rebase<Ref.Returns<RefTree>, From, To>,\n          GenericId.Rebase<Ref.Error<RefTree>, From, To>\n        >,\n        { readonly _tag: RefTree[\"_tag\"] }\n      >\n  : { [Key in keyof RefTree]: BindRefs<RefTree[Key], From, To> };\n\nexport type Bound<\n  Spec_ extends Spec.AnyWithProps,\n  From extends IdScope.IdScope,\n  To extends IdScope.IdScope,\n  Tables extends string,\n> = BindRefs<Refs.Refs<Spec_, Ref.AnyPublic>, From, To> & {\n  readonly [BoundTypeId]: {\n    readonly from: From;\n    readonly scope: To;\n    readonly tables: ReadonlyArray<Tables>;\n  };\n};\n\n/**\n * Build a publishable contract containing only exported functions and codecs.\n */\nexport const make = <\n  Spec_ extends Spec.AnyWithProps,\n  const Scope extends IdScope.IdScope,\n  const Tables extends string,\n>(\n  spec: Spec_,\n  scope: Scope,\n  tables: ReadonlyArray<Tables>,\n): Component<Spec_, Scope, Tables> => {\n  const specGroups = Spec.groups(spec);\n  Result.getOrThrow(validateContract(scope, specGroups));\n  const collect = (\n    groups: Readonly<Record<string, GroupSpec.AnyWithProps>>,\n    prefix = \"\",\n  ): Tree =>\n    pipe(\n      groups,\n      Record.map((group, name) => {\n        const path = prefix === \"\" ? name : `${prefix}/${name}`;\n        const functions = pipe(\n          group.functions,\n          Record.filter((functionSpec) => {\n            return Match.value(functionSpec.functionVisibility).pipe(\n              Match.when(\"public\", () => true),\n              Match.when(\"internal\", () => false),\n              Match.exhaustive,\n            );\n          }),\n          Record.map((functionSpec) =>\n            Ref.make(path, functionSpec, group.middlewareAttachments),\n          ),\n        );\n        return { ...collect(group.groups, path), ...functions };\n      }),\n      Record.filter((children) => !Record.isEmptyRecord(children)),\n    );\n  return {\n    [TypeId]: { refs: collect(specGroups), scope, tables },\n  } as Component<Spec_, Scope, Tables>;\n};\n\n/**\n * Bind the published contract to an actual installed component reference.\n */\nexport const bind = <\n  Spec_ extends Spec.AnyWithProps,\n  From extends IdScope.IdScope,\n  Tables extends string,\n  Native extends Api<NoInfer<Spec_>>,\n  const Parent extends IdScope.IdScope = IdScope.App,\n>(\n  component: Component<Spec_, From, Tables>,\n  native: Native,\n  options?: { readonly parentScope: Parent },\n): Bound<\n  Spec_,\n  From,\n  MountScope<Parent, Extract<MountName<Native>, string | undefined>>,\n  Tables\n> => {\n  const contract = component[TypeId];\n  const address = getFunctionAddress(native);\n  const installedReference = Result.getOrThrow(\n    Result.fromNullishOr(\n      address.reference,\n      () =>\n        new UninstalledComponentReferenceError({\n          definitionScope: contract.scope,\n        }),\n    ),\n  );\n  // Preserve the opaque address as an identity only. Calls retain the native\n  // references; no component address is constructed or parsed for routing.\n  const scope = IdScope.instance(\n    options?.parentScope ?? IdScope.app,\n    installedReference,\n  );\n  const rebase = (schema: Schema.ConstraintCodec<any, any, never, never>) =>\n    GenericId.rebase(schema, contract.scope, scope);\n  const rebaseMiddleware = memoize(\n    (middleware: MiddlewareSpec.AnyMiddlewareSpec) => {\n      if (!(\"error\" in middleware)) return middleware;\n      const boundMiddleware = Object.create(\n        middleware,\n      ) as MiddlewareSpec.AnyMiddlewareSpec;\n      Lazy.defineProperty(boundMiddleware, \"error\", () => {\n        const error = middleware.error;\n        return error === undefined ? undefined : rebase(error);\n      });\n      return boundMiddleware;\n    },\n  );\n  const visit = (tree: Tree, references: unknown): Tree =>\n    Record.map(tree, (child, key) => {\n      const reference = (references as Record<string, unknown>)[key];\n      if (Ref.isRef(child)) {\n        const nativeRef = reference as FunctionReference<any, any>;\n        return Match.value(child).pipe(\n          Match.tag(\"Convex\", (ref) => ({\n            ...ref,\n            functionReference: nativeRef,\n          })),\n          Match.tag(\"Confect\", (ref) => {\n            const provenance = {\n              _tag: \"Confect\" as const,\n              kind: Match.value(ref.kind).pipe(\n                Match.tag(\"Standard\", (kind) => kind),\n                Match.tag(\"Paginated\", (kind) => {\n                  const boundKind = { _tag: \"Paginated\" as const };\n                  Lazy.defineProperty(boundKind, \"userArgs\", () =>\n                    Schema.Struct(Record.map(kind.userArgs.fields, rebase)),\n                  );\n                  Lazy.defineProperty(boundKind, \"item\", () =>\n                    rebase(kind.item),\n                  );\n                  Lazy.defineProperty(boundKind, \"page\", () =>\n                    rebase(kind.page),\n                  );\n                  return boundKind as FunctionProvenance.Paginated;\n                }),\n                Match.exhaustive,\n              ),\n            };\n            Lazy.defineProperty(provenance, \"args\", () =>\n              Schema.Struct(Record.map(ref.args.fields, rebase)),\n            );\n            Lazy.defineProperty(provenance, \"returns\", () =>\n              rebase(ref.returns),\n            );\n            if (\"error\" in ref) {\n              Lazy.defineProperty(provenance, \"error\", () => {\n                const error = ref.error;\n                return error === undefined ? undefined : rebase(error);\n              });\n            }\n            return Ref.fromProvenance(\n              ref.convexFunctionName,\n              provenance as FunctionProvenance.AnyConfect,\n              Array.map(ref.middlewareAttachments, (attachment) => ({\n                ...attachment,\n                spec: rebaseMiddleware(attachment.spec),\n              })),\n              nativeRef,\n            );\n          }),\n          Match.exhaustive,\n        );\n      } else {\n        return visit(child, reference);\n      }\n    });\n  const refs = visit(contract.refs, native);\n  Object.defineProperty(refs, BoundTypeId, {\n    value: { from: contract.scope, scope, tables: contract.tables },\n  });\n  return refs as Bound<\n    Spec_,\n    From,\n    MountScope<Parent, Extract<MountName<Native>, string | undefined>>,\n    Tables\n  >;\n};\n\n/**\n * Reference an installed component's table ID in host schemas.\n */\nexport const id = <\n  From extends IdScope.IdScope,\n  To extends IdScope.IdScope,\n  Tables extends string,\n  const Table extends Tables,\n>(\n  component: {\n    readonly [BoundTypeId]: {\n      readonly from: From;\n      readonly scope: To;\n      readonly tables: ReadonlyArray<Tables>;\n    };\n  },\n  table: Table,\n) => GenericId.GenericId(table, component[BoundTypeId].scope);\n\n/**\n * Reuse a component's codec in a host function or table without losing its\n * scope.\n */\nexport const schema = <\n  From extends IdScope.IdScope,\n  To extends IdScope.IdScope,\n  Schema_ extends Schema.Codec<any, any>,\n>(\n  component: {\n    readonly [BoundTypeId]: { readonly from: From; readonly scope: To };\n  },\n  codec: Schema_,\n) =>\n  GenericId.rebase(\n    codec,\n    component[BoundTypeId].from,\n    component[BoundTypeId].scope,\n  );\n"],"mappings":"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"}
+{"version":3,"file":"Component.js","names":["Spec.groups","Ref.make","IdScope.instance","IdScope.app","rebase","GenericId.rebase","Ref.isRef","Ref.fromProvenance","GenericId.GenericId"],"sources":["../src/Component.ts"],"sourcesContent":["import type { DefaultFunctionArgs, FunctionReference } from \"convex/server\";\nimport { getFunctionAddress } from \"convex/server\";\nimport * as Array from \"effect/Array\";\nimport * as Data from \"effect/Data\";\nimport * as Result from \"effect/Result\";\nimport { memoize, pipe } from \"effect/Function\";\nimport * as Match from \"effect/Match\";\nimport * as Record from \"effect/Record\";\nimport * as Schema from \"effect/Schema\";\nimport type * as FunctionProvenance from \"./FunctionProvenance.js\";\nimport type * as FunctionSpec from \"./FunctionSpec.js\";\nimport * as GenericId from \"./GenericId.js\";\nimport type * as GroupSpec from \"./GroupSpec.js\";\nimport * as IdScope from \"./IdScope.js\";\nimport * as Lazy from \"./Lazy.js\";\nimport type * as MiddlewareSpec from \"./MiddlewareSpec.js\";\nimport * as Ref from \"./Ref.js\";\nimport type * as Refs from \"./Refs.js\";\nimport type * as RuntimeAndFunctionType from \"./RuntimeAndFunctionType.js\";\nimport * as Spec from \"./Spec.js\";\n\nexport class EmptyComponentScopeError extends Data.TaggedError(\n  \"EmptyComponentScopeError\",\n)<{\n  readonly definitionScope: IdScope.IdScope;\n}> {\n  override get message(): string {\n    return \"A component contract requires a nonempty definition scope.\";\n  }\n}\n\nexport class ComponentNameCollisionError extends Data.TaggedError(\n  \"ComponentNameCollisionError\",\n)<{\n  readonly groupPath: string;\n  readonly functionName: string;\n}> {\n  override get message(): string {\n    return `Group and function at same level have same name ('${this.groupPath}:${this.functionName}')`;\n  }\n}\n\nexport class UninstalledComponentReferenceError extends Data.TaggedError(\n  \"UninstalledComponentReferenceError\",\n)<{\n  readonly definitionScope: IdScope.IdScope;\n}> {\n  override get message(): string {\n    return \"Component.bind expects an installed component from the generated components registry.\";\n  }\n}\n\nconst validateNames = (\n  groups: Readonly<Record<string, GroupSpec.AnyWithProps>>,\n  prefix = \"\",\n): Result.Result<void, ComponentNameCollisionError> => {\n  for (const [name, group] of Record.toEntries(groups)) {\n    const path = prefix === \"\" ? name : `${prefix}/${name}`;\n    for (const functionSpec of Record.values(group.functions)) {\n      if (Record.has(group.groups, functionSpec.name)) {\n        return Result.fail(\n          new ComponentNameCollisionError({\n            groupPath: path,\n            functionName: functionSpec.name,\n          }),\n        );\n      }\n    }\n    const nested = validateNames(group.groups, path);\n    if (Result.isFailure(nested)) return nested;\n  }\n  return Result.succeed(undefined);\n};\n\nconst validateContract = (\n  scope: IdScope.IdScope,\n  groups: Readonly<Record<string, GroupSpec.AnyWithProps>>,\n): Result.Result<\n  void,\n  EmptyComponentScopeError | ComponentNameCollisionError\n> =>\n  scope === \"\"\n    ? Result.fail(new EmptyComponentScopeError({ definitionScope: scope }))\n    : validateNames(groups);\n\nconst TypeId = \"~@confect/core/Component\";\nconst BoundTypeId = \"~@confect/core/BoundComponent\";\n\n/**\n * Convex's generated ComponentApi erases database ID brands at the boundary.\n */\ntype Wire<A> = A extends { readonly __tableName: string }\n  ? string\n  : A extends\n        | string\n        | number\n        | bigint\n        | boolean\n        | null\n        | undefined\n        | ArrayBuffer\n    ? A\n    : { [K in keyof A]: Wire<A[K]> };\n\ntype OmitEmpty<A> = {\n  [K in keyof A as keyof A[K] extends never ? never : K]: A[K];\n};\ntype ApiGroups<\n  GroupSpec_ extends GroupSpec.AnyWithProps,\n  Name extends string | undefined,\n> = OmitEmpty<{\n  [GroupName in GroupSpec.Name<GroupSpec_>]: ApiGroup<\n    GroupSpec.WithName<GroupSpec_, GroupName>,\n    Name\n  >;\n}>;\ntype ApiGroup<\n  GroupSpec_ extends GroupSpec.AnyWithProps,\n  Name extends string | undefined,\n> = ApiGroups<GroupSpec.Groups<GroupSpec_>, Name> & {\n  [\n    FunctionSpec_ in GroupSpec.Functions<GroupSpec_> as FunctionSpec.GetFunctionVisibility<FunctionSpec_> extends \"public\"\n      ? FunctionSpec.Name<FunctionSpec_>\n      : never\n  ]: FunctionReference<\n    RuntimeAndFunctionType.GetFunctionType<\n      FunctionSpec_[\"runtimeAndFunctionType\"]\n    >,\n    \"internal\",\n    Extract<Wire<FunctionSpec.EncodedArgs<FunctionSpec_>>, DefaultFunctionArgs>,\n    Wire<FunctionSpec.EncodedReturns<FunctionSpec_>>,\n    Name\n  >;\n};\n\nexport type Api<\n  Spec_ extends Spec.AnyWithProps,\n  Name extends string | undefined = string | undefined,\n> = ApiGroups<Spec.Groups<Spec_>, Name>;\n\ninterface Tree {\n  readonly [key: string]: Tree | Ref.Any;\n}\n\nexport interface Component<\n  Spec_ extends Spec.AnyWithProps,\n  Scope extends IdScope.IdScope,\n  Tables extends string = string,\n> {\n  readonly [TypeId]: {\n    readonly refs: Tree;\n    readonly scope: Scope;\n    readonly tables: ReadonlyArray<Tables>;\n  };\n  readonly \"~Spec\": Spec_;\n}\n\n/**\n * An opaque identity: its string representation is not part of the API.\n */\nexport type MountScope<\n  Parent extends IdScope.IdScope,\n  Name extends string | undefined,\n> = IdScope.Mount<Parent, Name>;\n\ntype MountName<ComponentApi> =\n  ComponentApi extends FunctionReference<any, any, any, any, infer Name>\n    ? Name\n    : ComponentApi extends object\n      ? {\n          [Key in keyof ComponentApi]: MountName<ComponentApi[Key]>;\n        }[keyof ComponentApi]\n      : never;\n\ntype BindRefs<\n  RefTree,\n  From extends IdScope.IdScope,\n  To extends IdScope.IdScope,\n> = RefTree extends Ref.Any\n  ? RefTree extends { readonly _tag: \"Convex\" }\n    ? Ref.ConvexRef<\n        Ref.GetRuntimeAndFunctionType<RefTree>,\n        \"internal\",\n        Extract<Wire<Ref.Args<RefTree>>, DefaultFunctionArgs>,\n        Wire<Ref.Returns<RefTree>>\n      >\n    : Extract<\n        Ref.Ref<\n          Ref.GetRuntimeAndFunctionType<RefTree>,\n          \"internal\",\n          Extract<\n            GenericId.Rebase<Ref.Args<RefTree>, From, To>,\n            DefaultFunctionArgs\n          >,\n          GenericId.Rebase<Ref.Returns<RefTree>, From, To>,\n          GenericId.Rebase<Ref.Error<RefTree>, From, To>\n        >,\n        { readonly _tag: RefTree[\"_tag\"] }\n      >\n  : { [Key in keyof RefTree]: BindRefs<RefTree[Key], From, To> };\n\nexport type Bound<\n  Spec_ extends Spec.AnyWithProps,\n  From extends IdScope.IdScope,\n  To extends IdScope.IdScope,\n  Tables extends string,\n> = BindRefs<Refs.Refs<Spec_, Ref.AnyPublic>, From, To> & {\n  readonly [BoundTypeId]: {\n    readonly from: From;\n    readonly scope: To;\n    readonly tables: ReadonlyArray<Tables>;\n  };\n};\n\n/**\n * Build a publishable contract containing only exported functions and codecs.\n */\nexport const contract = <\n  Spec_ extends Spec.AnyWithProps,\n  const Scope extends IdScope.IdScope,\n  const Tables extends string,\n>(\n  spec: Spec_,\n  scope: Scope,\n  tables: ReadonlyArray<Tables>,\n): Component<Spec_, Scope, Tables> => {\n  const specGroups = Spec.groups(spec);\n  Result.getOrThrow(validateContract(scope, specGroups));\n  const collect = (\n    groups: Readonly<Record<string, GroupSpec.AnyWithProps>>,\n    prefix = \"\",\n  ): Tree =>\n    pipe(\n      groups,\n      Record.map((group, name) => {\n        const path = prefix === \"\" ? name : `${prefix}/${name}`;\n        const functions = pipe(\n          group.functions,\n          Record.filter((functionSpec) => {\n            return Match.value(functionSpec.functionVisibility).pipe(\n              Match.when(\"public\", () => true),\n              Match.when(\"internal\", () => false),\n              Match.exhaustive,\n            );\n          }),\n          Record.map((functionSpec) =>\n            Ref.make(path, functionSpec, group.middlewareAttachments),\n          ),\n        );\n        return { ...collect(group.groups, path), ...functions };\n      }),\n      Record.filter((children) => !Record.isEmptyRecord(children)),\n    );\n  return {\n    [TypeId]: { refs: collect(specGroups), scope, tables },\n  } as Component<Spec_, Scope, Tables>;\n};\n\n/**\n * Bind the published contract to an actual installed component reference.\n */\nexport const bind = <\n  Spec_ extends Spec.AnyWithProps,\n  From extends IdScope.IdScope,\n  Tables extends string,\n  Native extends Api<NoInfer<Spec_>>,\n  const Parent extends IdScope.IdScope = IdScope.App,\n>(\n  component: Component<Spec_, From, Tables>,\n  native: Native,\n  options?: { readonly parentScope: Parent },\n): Bound<\n  Spec_,\n  From,\n  MountScope<Parent, Extract<MountName<Native>, string | undefined>>,\n  Tables\n> => {\n  const published = component[TypeId];\n  const address = getFunctionAddress(native);\n  const installedReference = Result.getOrThrow(\n    Result.fromNullishOr(\n      address.reference,\n      () =>\n        new UninstalledComponentReferenceError({\n          definitionScope: published.scope,\n        }),\n    ),\n  );\n  // Preserve the opaque address as an identity only. Calls retain the native\n  // references; no component address is constructed or parsed for routing.\n  const scope = IdScope.instance(\n    options?.parentScope ?? IdScope.app,\n    installedReference,\n  );\n  const rebase = (schema: Schema.ConstraintCodec<any, any, never, never>) =>\n    GenericId.rebase(schema, published.scope, scope);\n  const rebaseMiddleware = memoize(\n    (middleware: MiddlewareSpec.AnyMiddlewareSpec) => {\n      if (!(\"error\" in middleware)) return middleware;\n      const boundMiddleware = Object.create(\n        middleware,\n      ) as MiddlewareSpec.AnyMiddlewareSpec;\n      Lazy.defineProperty(boundMiddleware, \"error\", () => {\n        const error = middleware.error;\n        return error === undefined ? undefined : rebase(error);\n      });\n      return boundMiddleware;\n    },\n  );\n  const visit = (tree: Tree, references: unknown): Tree =>\n    Record.map(tree, (child, key) => {\n      const reference = (references as Record<string, unknown>)[key];\n      if (Ref.isRef(child)) {\n        const nativeRef = reference as FunctionReference<any, any>;\n        return Match.value(child).pipe(\n          Match.tag(\"Convex\", (ref) => ({\n            ...ref,\n            functionReference: nativeRef,\n          })),\n          Match.tag(\"Confect\", (ref) => {\n            const provenance = {\n              _tag: \"Confect\" as const,\n              kind: Match.value(ref.kind).pipe(\n                Match.tag(\"Standard\", (kind) => kind),\n                Match.tag(\"Paginated\", (kind) => {\n                  const boundKind = { _tag: \"Paginated\" as const };\n                  Lazy.defineProperty(boundKind, \"userArgs\", () =>\n                    Schema.Struct(Record.map(kind.userArgs.fields, rebase)),\n                  );\n                  Lazy.defineProperty(boundKind, \"item\", () =>\n                    rebase(kind.item),\n                  );\n                  Lazy.defineProperty(boundKind, \"page\", () =>\n                    rebase(kind.page),\n                  );\n                  return boundKind as FunctionProvenance.Paginated;\n                }),\n                Match.exhaustive,\n              ),\n            };\n            Lazy.defineProperty(provenance, \"args\", () =>\n              Schema.Struct(Record.map(ref.args.fields, rebase)),\n            );\n            Lazy.defineProperty(provenance, \"returns\", () =>\n              rebase(ref.returns),\n            );\n            if (\"error\" in ref) {\n              Lazy.defineProperty(provenance, \"error\", () => {\n                const error = ref.error;\n                return error === undefined ? undefined : rebase(error);\n              });\n            }\n            return Ref.fromProvenance(\n              ref.convexFunctionName,\n              provenance as FunctionProvenance.AnyConfect,\n              Array.map(ref.middlewareAttachments, (attachment) => ({\n                ...attachment,\n                spec: rebaseMiddleware(attachment.spec),\n              })),\n              nativeRef,\n              ref.functionType,\n              ref.reservedArgument,\n            );\n          }),\n          Match.exhaustive,\n        );\n      } else {\n        return visit(child, reference);\n      }\n    });\n  const refs = visit(published.refs, native);\n  Object.defineProperty(refs, BoundTypeId, {\n    value: { from: published.scope, scope, tables: published.tables },\n  });\n  return refs as Bound<\n    Spec_,\n    From,\n    MountScope<Parent, Extract<MountName<Native>, string | undefined>>,\n    Tables\n  >;\n};\n\n/**\n * Reference an installed component's table ID in host schemas.\n */\nexport const id = <\n  From extends IdScope.IdScope,\n  To extends IdScope.IdScope,\n  Tables extends string,\n  const Table extends Tables,\n>(\n  component: {\n    readonly [BoundTypeId]: {\n      readonly from: From;\n      readonly scope: To;\n      readonly tables: ReadonlyArray<Tables>;\n    };\n  },\n  table: Table,\n) => GenericId.GenericId(table, component[BoundTypeId].scope);\n\n/**\n * Reuse a component's codec in a host function or table without losing its\n * scope.\n */\nexport const schema = <\n  From extends IdScope.IdScope,\n  To extends IdScope.IdScope,\n  Schema_ extends Schema.Codec<any, any>,\n>(\n  component: {\n    readonly [BoundTypeId]: { readonly from: From; readonly scope: To };\n  },\n  codec: Schema_,\n) =>\n  GenericId.rebase(\n    codec,\n    component[BoundTypeId].from,\n    component[BoundTypeId].scope,\n  );\n"],"mappings":"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"}