Rename the manifest's extendServerConfig to setupFn, following the prismaSetupFn convention

Author: FranjoMindek

waspc/data/packages/spec/__tests__/spec/mapApp.unit.test.ts

@@ -500,7 +500,7 @@ describe("mapAuth", () => {
         userSignupFields: mapRefObjectForMockProjectDir(
           provider.userSignupFields,
         ),
-        extendServerConfig: undefined,
+        setupFn: undefined,
         optionsJson: JSON.stringify(provider.options),
       },
     } satisfies AppSpec.Auth);

waspc/data/packages/spec/src/appSpec.ts

@@ -184,7 +184,7 @@ export type ExternalAuthProviderSpec = {
   capabilities: string[];
   envVars: ExternalProviderEnvVars;
   userSignupFields: Optional<ExtImport>;
-  extendServerConfig: Optional<ExtImport>;
+  setupFn: Optional<ExtImport>;
   optionsJson: Optional<string>;
 };
 

waspc/data/packages/spec/src/spec/mapper/app.ts

@@ -155,9 +155,7 @@ function mapExternalAuthProvider(
     userSignupFields:
       manifest.userSignupFields &&
       ctx.parseRefObject(manifest.userSignupFields),
-    extendServerConfig:
-      manifest.extendServerConfig &&
-      ctx.parseRefObject(manifest.extendServerConfig),
+    setupFn: manifest.setupFn && ctx.parseRefObject(manifest.setupFn),
     optionsJson: mapProviderOptions(manifest),
   };
 }
@@ -178,15 +176,15 @@ function mapProviderOptions(
   // Options travel to the generated code as JSON, so anything that doesn't
   // survive the round-trip (functions, class instances, undefined-holed
   // arrays) would arrive silently mangled. Rejecting here turns that into an
-  // error at compile time, with `extendServerConfig` as the documented escape
+  // error at compile time, with `setupFn` as the documented escape
   // hatch for non-serializable configuration.
   const optionsJson = JSON.stringify(manifest.options);
   if (
     optionsJson === undefined ||
     !isEqual(JSON.parse(optionsJson), manifest.options)
   ) {
     throw new WaspSpecUserError(
-      `Auth provider '${manifest.id}' has options that do not survive JSON serialization. Provider options must be plain serializable data; use extendServerConfig for functions and other live values.`,
+      `Auth provider '${manifest.id}' has options that do not survive JSON serialization. Provider options must be plain serializable data; use setupFn for functions and other live values.`,
     );
   }
 

waspc/data/packages/spec/src/spec/publicApi/waspSpec.ts

@@ -330,12 +330,13 @@ export interface ExternalAuthProviderManifest {
    */
   userSignupFields?: Reference<AnyObject>;
   /**
-   * Escape hatch for non-serializable adapter configuration (functions, class
-   * instances -- e.g. Better Auth's email-sending callbacks). References a
-   * user-code module; the adapter's server factory applies it after its own
-   * defaults.
+   * Setup function for the provider's underlying library, following the same
+   * convention as `db.prismaSetupFn`: a reference to a user-code function the
+   * adapter calls with its integration config, whose return value becomes the
+   * configuration to use. This is how an app reaches everything serializable
+   * options cannot carry -- hooks, plugins, email-sending callbacks.
    */
-  extendServerConfig?: Reference<AnyFunction>;
+  setupFn?: Reference<AnyFunction>;
   /**
    * Serializable adapter options, passed verbatim to the adapter's server and
    * client factories. Must survive a JSON round-trip; the compiler checks.

waspc/src/Wasp/AppSpec/App/Auth.hs

@@ -149,10 +149,11 @@ data ExternalAuthProviderSpec = ExternalAuthProviderSpec
     -- | Populates the user entity when Wasp provisions a local user for a
     -- subject it has not seen before.
     userSignupFields :: Maybe ExtImport,
-    -- | Escape hatch for non-serializable adapter configuration (functions,
-    -- class instances). Applied by the adapter's server factory after its own
-    -- defaults.
-    extendServerConfig :: Maybe ExtImport,
+    -- | Setup function for the provider's underlying library (the
+    -- @prismaSetupFn@ convention): the adapter calls it with its integration
+    -- config and uses the returned configuration. The escape hatch for
+    -- everything serializable options cannot carry.
+    setupFn :: Maybe ExtImport,
     -- | The adapter's serializable options, JSON-encoded. Kept as a string so
     -- the generator can splice it into generated code verbatim.
     optionsJson :: Maybe String