Fix SSR compatibility and module bundling issues of Nuxt

.changeset/lemon-trams-mix.md

@@ -0,0 +1,9 @@
+---
+'@asgardeo/browser': patch
+'@asgardeo/nuxt': patch
+---
+
+Fix SSR compatibility and module bundling issues
+
+- **Browser:** Fixed Node.js ESM import resolution by changing directory imports (`'buffer/'`) to explicit file paths (`'buffer/index.js'`)
+- **Nuxt:** Fixed Rollup bundling by centralizing module augmentations in `module.ts` and removing `.d.ts` file from dist

packages/browser/esbuild.config.mjs

@@ -40,15 +40,15 @@ const polyfillPlugin = {
 
     // Buffer polyfill
     build.onResolve({filter: /^buffer$/}, () => ({
-      path: require.resolve('buffer/'),
+      path: require.resolve('buffer/index.js'),
     }));
   },
 };
 
 const commonOptions = {
   banner: {
     js: `
-      import { Buffer } from 'buffer/';
+      import { Buffer } from 'buffer/index.js';
       if (typeof window !== 'undefined' && !window.Buffer) {
         window.Buffer = Buffer;
       }
@@ -66,7 +66,7 @@ const commonOptions = {
   footer: {
     js: `
       if (typeof window !== 'undefined' && !window.Buffer) {
-        window.Buffer = require('buffer/').Buffer;
+        window.Buffer = require('buffer/index.js').Buffer;
       }
     `,
   },

packages/nuxt/src/module.ts

@@ -28,7 +28,7 @@ import {
 } from '@nuxt/kit';
 import type {Nuxt} from '@nuxt/schema';
 import {defu} from 'defu';
-import type {AsgardeoNuxtConfig} from './runtime/types';
+import type {AsgardeoNuxtConfig, AsgardeoSessionPayload, AsgardeoSSRData} from './runtime/types';
 
 const PACKAGE_NAME: string = '@asgardeo/nuxt';
 
@@ -298,14 +298,20 @@ export default defineNuxtModule<AsgardeoNuxtConfig>({
 });
 
 declare module '@nuxt/schema' {
+  interface NuxtConfig {
+    asgardeo?: AsgardeoNuxtConfig;
+  }
+  interface NuxtOptions {
+    asgardeo?: AsgardeoNuxtConfig;
+  }
   interface PublicRuntimeConfig {
     asgardeo: {
       afterSignInUrl: string;
       afterSignOutUrl: string;
       applicationId?: string;
       baseUrl: string;
       clientId: string;
-      preferences?: import('./runtime/types').AsgardeoNuxtConfig['preferences'];
+      preferences?: AsgardeoNuxtConfig['preferences'];
       scopes: string[];
       signInUrl?: string;
       signUpUrl?: string;
@@ -319,3 +325,13 @@ declare module '@nuxt/schema' {
     };
   }
 }
+
+declare module 'h3' {
+  interface H3EventContext {
+    asgardeo?: {
+      isSignedIn?: boolean;
+      session?: AsgardeoSessionPayload | {sub?: string} | null;
+      ssr?: AsgardeoSSRData;
+    };
+  }
+}

packages/nuxt/src/runtime/plugins/asgardeo.ts

@@ -27,9 +27,6 @@ import type {AsgardeoAuthState, AsgardeoSSRData} from '../types';
 import {defineNuxtPlugin, useState, useRequestEvent, useRuntimeConfig, navigateTo} from '#app';
 import type {NuxtApp} from '#app';
 
-// Import H3 augmentation so event.context.asgardeo is typed
-import '../types/augments.d';
-
 /**
  * Universal Nuxt plugin (runs on both server and client) that wires up the
  * Asgardeo Vue SDK.
@@ -122,7 +119,9 @@ export default defineNuxtPlugin((nuxtApp: NuxtApp) => {
       brandingState.value = ssr.brandingPreference;
     } else {
       // Backwards-compat: fall back to the legacy context shape (pre-Step-2 plugin).
-      const ssrContext: {isSignedIn?: boolean; session?: {sub?: string}} | undefined = event?.context?.asgardeo;
+      const ssrContext: {isSignedIn?: boolean; session?: {sub?: string}} | undefined = event?.context?.asgardeo as
+        | {isSignedIn?: boolean; session?: {sub?: string}}
+        | undefined;
       if (ssrContext) {
         authState.value = {
           isLoading: false,

packages/nuxt/src/runtime/server/plugins/asgardeo-ssr.ts

@@ -24,9 +24,6 @@ import AsgardeoNuxtClient from '../AsgardeoNuxtClient';
 import {verifyAndRehydrateSession} from '../utils/serverSession';
 import {useRuntimeConfig} from '#imports';
 
-// Import augmentation so event.context.asgardeo is typed
-import '../../types/augments.d';
-
 const log: ReturnType<typeof createLogger> = createLogger('asgardeo-ssr');
 
 const CALLBACK_PATH: string = '/api/auth/callback';