Make component types resistant to multiple convex packages (#29972)

Modify component types to allow multiple copies of the convex library to typecheck against each other.

GitOrigin-RevId: 0577742902edefeebd634aa03a5355e4a90b5dc1

Author: thomasballinger

npm-packages/convex/.npmignore

@@ -28,4 +28,4 @@ build.cjs
 tmpPackage*
 tmpDist*
 api-extractor-configs/temp/
-*.log
+*.log

npm-packages/convex/src/server/components/index.ts

@@ -12,7 +12,7 @@ import {
   ComponentDefinitionAnalysis,
   ComponentDefinitionType,
 } from "./definition.js";
-import { toReferencePath } from "./paths.js";
+import { setReferencePath, toReferencePath } from "./paths.js";
 
 /**
  * A serializable reference to a Convex function.
@@ -158,15 +158,10 @@ class InstalledComponent<Definition extends ComponentDefinition<any>> {
    */
   _name: string;
 
-  /**
-   * @internal
-   */
-  [toReferencePath]: string;
-
   constructor(definition: Definition, name: string) {
     this._definition = definition;
     this._name = name;
-    this[toReferencePath] = `_reference/childComponent/${name}`;
+    setReferencePath(this, `_reference/childComponent/${name}`);
   }
 
   get exports(): ComponentDefinitionExports<Definition> {

npm-packages/convex/src/server/components/paths.ts

@@ -1,5 +1,12 @@
 export const toReferencePath = Symbol.for("toReferencePath");
 
+// Multiple instances of the same Symbol.for() are equal at runtime but not
+// at type-time, so `[toReferencePath]` properties aren't used in types.
+// Use this function to set the property invisibly.
+export function setReferencePath<T>(obj: T, value: string) {
+  (obj as any)[toReferencePath] = value;
+}
+
 export function extractReferencePath(reference: any): string | null {
   return reference[toReferencePath] ?? null;
 }

npm-packages/convex/src/server/router.ts

@@ -142,7 +142,7 @@ export type RouteSpec = RouteSpecWithPath | RouteSpecWithPathPrefix;
 export class HttpRouter {
   exactRoutes: Map<string, Map<RoutableMethod, PublicHttpAction>> = new Map();
   prefixRoutes: Map<RoutableMethod, Map<string, PublicHttpAction>> = new Map();
-  isRouter = true;
+  isRouter: true = true;
 
   /**
    * Specify an HttpAction to be used to respond to requests