@payez/next-mvp 4.0.41 → 4.0.43

package/dist/auth/better-auth.d.ts

@@ -22,13 +22,29 @@ export interface BetterAuthSocialProvider {
  * Build Better Auth social providers from IDP config.
  */
 export declare function buildBetterAuthProviders(config: IDPClientConfig): Record<string, BetterAuthSocialProvider>;
+/**
+ * Optional extra plugins for createBetterAuthInstance.
+ * Use to add credentials/custom signin endpoints from the host app.
+ */
+export type BetterAuthExtraPlugins = any[];
+/**
+ * Optional overrides for createBetterAuthInstance.
+ */
+export interface BetterAuthInstanceOptions {
+    /** Path suffix for the BA mount (default: '/api/auth'). Use '/api/ba-auth' for migration scenarios. */
+    basePath?: string;
+}
 /**
  * Create Better Auth instance from IDP config.
  *
  * No database — runs in stateless mode with JWE cookie cache.
  * Call after getIDPClientConfig() resolves.
+ *
+ * @param idpConfig IDP client config (from getIDPClientConfig)
+ * @param extraPlugins Optional plugins to add (e.g., credentials plugin from host app)
+ * @param options Optional overrides (e.g., basePath for migration scenarios)
  */
-export declare function createBetterAuthInstance(idpConfig: IDPClientConfig): import("better-auth").Auth<{
+export declare function createBetterAuthInstance(idpConfig: IDPClientConfig, extraPlugins?: BetterAuthExtraPlugins, options?: BetterAuthInstanceOptions): import("better-auth").Auth<{
     baseURL: string;
     secret: string;
     socialProviders: Record<string, BetterAuthSocialProvider>;
@@ -53,7 +69,7 @@ export declare function createBetterAuthInstance(idpConfig: IDPClientConfig): im
             };
         };
     };
-    plugins: [{
+    plugins: [...any[], {
         id: "next-cookies";
         hooks: {
             before: {
@@ -77,7 +93,7 @@ export declare function isBetterAuthEnabled(): boolean;
  */
 declare let cachedInstance: any;
 export { cachedInstance as __betterAuthInstance };
-export declare function getBetterAuthInstance(): Promise<any>;
+export declare function getBetterAuthInstance(extraPlugins?: BetterAuthExtraPlugins): Promise<any>;
 /**
  * Get flag-gated auth handler for Next.js route.
  *

package/dist/auth/better-auth.js

@@ -80,15 +80,20 @@ function buildBetterAuthProviders(config) {
  *
  * No database — runs in stateless mode with JWE cookie cache.
  * Call after getIDPClientConfig() resolves.
+ *
+ * @param idpConfig IDP client config (from getIDPClientConfig)
+ * @param extraPlugins Optional plugins to add (e.g., credentials plugin from host app)
+ * @param options Optional overrides (e.g., basePath for migration scenarios)
  */
-function createBetterAuthInstance(idpConfig) {
+function createBetterAuthInstance(idpConfig, extraPlugins = [], options = {}) {
     const appSlug = idpConfig.clientSlug || (0, app_slug_1.getAppSlug)();
+    const basePath = options.basePath || '/api/auth';
     // Resolve base URL: BETTER_AUTH_URL env > IDP config > localhost fallback
-    // Must include /api/auth since that's where the catch-all route is mounted
+    // basePath defaults to /api/auth but can be overridden via options for migration scenarios
     const rawBaseURL = process.env.BETTER_AUTH_URL
         || idpConfig.baseClientUrl
         || `http://localhost:${process.env.PORT || '3000'}`;
-    const baseURL = rawBaseURL.replace(/\/+$/, '') + '/api/auth';
+    const baseURL = rawBaseURL.replace(/\/+$/, '') + basePath;
     return (0, better_auth_1.betterAuth)({
         baseURL,
         secret: idpConfig.nextAuthSecret,
@@ -148,6 +153,7 @@ function createBetterAuthInstance(idpConfig) {
             },
         },
         plugins: [
+            ...extraPlugins,
             (0, next_js_1.nextCookies)(),
         ],
     });
@@ -167,12 +173,12 @@ let cachedInstance = null;
 exports.__betterAuthInstance = cachedInstance;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 let initPromise = null;
-async function getBetterAuthInstance() {
+async function getBetterAuthInstance(extraPlugins = []) {
     if (cachedInstance)
         return cachedInstance;
     if (!initPromise) {
         initPromise = (0, idp_client_config_1.getIDPClientConfig)(true).then(config => {
-            const instance = createBetterAuthInstance(config);
+            const instance = createBetterAuthInstance(config, extraPlugins);
             exports.__betterAuthInstance = cachedInstance = instance;
             console.log('[BETTER_AUTH] Instance created for', config.clientSlug || config.clientId);
             return instance;

package/dist/server/auth.d.ts

@@ -36,7 +36,7 @@ export declare function getAuthInstance(): Promise<import("better-auth/types").A
             };
         };
     };
-    plugins: [{
+    plugins: [...any[], {
         id: "next-cookies";
         hooks: {
             before: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payez/next-mvp",
-  "version": "4.0.41",
+  "version": "4.0.43",
   "sideEffects": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/auth/better-auth.ts

@@ -48,21 +48,45 @@ export function buildBetterAuthProviders(
   return providers;
 }
 
+/**
+ * Optional extra plugins for createBetterAuthInstance.
+ * Use to add credentials/custom signin endpoints from the host app.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type BetterAuthExtraPlugins = any[];
+
+/**
+ * Optional overrides for createBetterAuthInstance.
+ */
+export interface BetterAuthInstanceOptions {
+  /** Path suffix for the BA mount (default: '/api/auth'). Use '/api/ba-auth' for migration scenarios. */
+  basePath?: string;
+}
+
 /**
  * Create Better Auth instance from IDP config.
  *
  * No database — runs in stateless mode with JWE cookie cache.
  * Call after getIDPClientConfig() resolves.
+ *
+ * @param idpConfig IDP client config (from getIDPClientConfig)
+ * @param extraPlugins Optional plugins to add (e.g., credentials plugin from host app)
+ * @param options Optional overrides (e.g., basePath for migration scenarios)
  */
-export function createBetterAuthInstance(idpConfig: IDPClientConfig) {
+export function createBetterAuthInstance(
+  idpConfig: IDPClientConfig,
+  extraPlugins: BetterAuthExtraPlugins = [],
+  options: BetterAuthInstanceOptions = {}
+) {
   const appSlug = idpConfig.clientSlug || getAppSlug();
+  const basePath = options.basePath || '/api/auth';
 
   // Resolve base URL: BETTER_AUTH_URL env > IDP config > localhost fallback
-  // Must include /api/auth since that's where the catch-all route is mounted
+  // basePath defaults to /api/auth but can be overridden via options for migration scenarios
   const rawBaseURL = process.env.BETTER_AUTH_URL
     || idpConfig.baseClientUrl
     || `http://localhost:${process.env.PORT || '3000'}`;
-  const baseURL = rawBaseURL.replace(/\/+$/, '') + '/api/auth';
+  const baseURL = rawBaseURL.replace(/\/+$/, '') + basePath;
 
   return betterAuth({
     baseURL,
@@ -123,6 +147,7 @@ export function createBetterAuthInstance(idpConfig: IDPClientConfig) {
     },
 
     plugins: [
+      ...extraPlugins,
       nextCookies(),
     ],
   });
@@ -148,12 +173,12 @@ let initPromise: Promise<any> | null = null;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export { cachedInstance as __betterAuthInstance };
 
-export async function getBetterAuthInstance() {
+export async function getBetterAuthInstance(extraPlugins: BetterAuthExtraPlugins = []) {
   if (cachedInstance) return cachedInstance;
 
   if (!initPromise) {
     initPromise = getIDPClientConfig(true).then(config => {
-      const instance = createBetterAuthInstance(config);
+      const instance = createBetterAuthInstance(config, extraPlugins);
       cachedInstance = instance;
       console.log('[BETTER_AUTH] Instance created for', config.clientSlug || config.clientId);
       return instance;