Add new Quickstart samples

Author: brionmario

.github/actions/pack-sample/action.yml

@@ -0,0 +1,51 @@
+name: Pack Sample App
+description: >
+  Packages a sample app into a standalone zip using pnpm pack, which
+  rewrites workspace:* and catalog: references to real npm versions.
+  Requires the pnpm workspace to be installed before this action runs.
+
+inputs:
+  sdk:
+    description: SDK slug matching the samples/ subdirectory (e.g. react, browser, node)
+    required: true
+  version:
+    description: Version being released (e.g. 1.2.3), used to name the zip file
+    required: true
+
+outputs:
+  archive:
+    description: Filename of the produced zip (relative to the workspace root)
+    value: ${{ steps.pack.outputs.archive }}
+
+runs:
+  using: composite
+  steps:
+    - name: Pack
+      id: pack
+      shell: bash
+      run: |
+        SDK="${{ inputs.sdk }}"
+        VERSION="${{ inputs.version }}"
+        DEST_DIR="$(pwd)"
+        FOLDER="thunderid-${SDK}-sdk-sample-v${VERSION}"
+        ARCHIVE="${FOLDER}.zip"
+
+        PACK_DIR="$(mktemp -d)"
+        trap 'rm -rf "$PACK_DIR"' EXIT
+
+        cd "samples/${SDK}/quickstart"
+        pnpm pack --pack-destination "${PACK_DIR}"
+        cd "${DEST_DIR}"
+
+        tgz=$(ls "${PACK_DIR}"/*.tgz | head -1)
+        if [ -z "$tgz" ]; then
+          echo "Error: pnpm pack did not produce a .tgz for ${SDK}"
+          exit 1
+        fi
+
+        tar xzf "$tgz"
+        mv package "${FOLDER}"
+        (find "${FOLDER}" | sort | zip "${ARCHIVE}" -@)
+        rm -rf "${FOLDER}"
+
+        echo "archive=${ARCHIVE}" >> "$GITHUB_OUTPUT"

.github/workflows/release.yml

@@ -163,6 +163,14 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/javascript/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID JavaScript SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes
+
   # ── Level 1: depends on javascript ─────────────────────────────────────────
   release-browser:
     name: 🌐 Release @thunderid/browser
@@ -221,6 +229,22 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 📦 Pack Sample
+        id: pack
+        uses: ./.github/actions/pack-sample
+        with:
+          sdk: browser
+          version: ${{ steps.bump.outputs.version }}
+
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/browser/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID Browser SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes \
+            "${{ steps.pack.outputs.archive }}"
+
   release-node:
     name: 🟢 Release @thunderid/node
     needs: [validate, release-javascript]
@@ -278,6 +302,22 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 📦 Pack Sample
+        id: pack
+        uses: ./.github/actions/pack-sample
+        with:
+          sdk: node
+          version: ${{ steps.bump.outputs.version }}
+
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/node/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID Node SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes \
+            "${{ steps.pack.outputs.archive }}"
+
   # ── Level 2: depends on browser / node ─────────────────────────────────────
   release-express:
     name: 🚂 Release @thunderid/express
@@ -336,6 +376,22 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 📦 Pack Sample
+        id: pack
+        uses: ./.github/actions/pack-sample
+        with:
+          sdk: express
+          version: ${{ steps.bump.outputs.version }}
+
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/express/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID Express SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes \
+            "${{ steps.pack.outputs.archive }}"
+
   release-react:
     name: ⚛️ Release @thunderid/react
     needs: [validate, release-browser]
@@ -393,6 +449,22 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 📦 Pack Sample
+        id: pack
+        uses: ./.github/actions/pack-sample
+        with:
+          sdk: react
+          version: ${{ steps.bump.outputs.version }}
+
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/react/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID React SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes \
+            "${{ steps.pack.outputs.archive }}"
+
   release-vue:
     name: 🟩 Release @thunderid/vue
     needs: [validate, release-browser]
@@ -450,6 +522,22 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 📦 Pack Sample
+        id: pack
+        uses: ./.github/actions/pack-sample
+        with:
+          sdk: vue
+          version: ${{ steps.bump.outputs.version }}
+
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/vue/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID Vue SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes \
+            "${{ steps.pack.outputs.archive }}"
+
   # ── Level 3: depends on react / node+react / browser+node+vue ──────────────
   release-react-router:
     name: 🔀 Release @thunderid/react-router
@@ -508,6 +596,14 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/react-router/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID React Router SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes
+
   release-tanstack-router:
     name: 🔱 Release @thunderid/tanstack-router
     needs: [validate, release-react]
@@ -565,6 +661,14 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/tanstack-router/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID TanStack Router SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes
+
   release-nextjs:
     name: ▲ Release @thunderid/nextjs
     needs: [validate, release-node, release-react]
@@ -622,6 +726,22 @@ jobs:
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
+      - name: 📦 Pack Sample
+        id: pack
+        uses: ./.github/actions/pack-sample
+        with:
+          sdk: nextjs
+          version: ${{ steps.bump.outputs.version }}
+
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/nextjs/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID Next.js SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes \
+            "${{ steps.pack.outputs.archive }}"
+
   release-nuxt:
     name: 💚 Release @thunderid/nuxt
     needs: [validate, release-browser, release-node, release-vue]
@@ -678,3 +798,19 @@ jobs:
         working-directory: packages/nuxt
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: 📦 Pack Sample
+        id: pack
+        uses: ./.github/actions/pack-sample
+        with:
+          sdk: nuxt
+          version: ${{ steps.bump.outputs.version }}
+
+      - name: 🚀 Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.THUNDERID_AUTOMATION_BOT }}
+        run: |
+          gh release create "sdk/nuxt/v${{ steps.bump.outputs.version }}" \
+            --title "ThunderID Nuxt SDK v${{ steps.bump.outputs.version }}" \
+            --generate-notes \
+            "${{ steps.pack.outputs.archive }}"

eslint.config.js

@@ -23,4 +23,10 @@ export default [
     ignores: ['dist/**', 'build/**', 'node_modules/**', 'coverage/**'],
   },
   ...thunderIdPlugin.configs.typescript,
+  {
+    files: ['samples/**'],
+    rules: {
+      '@thunderid/copyright-header': 'off',
+    },
+  },
 ];

package.json

@@ -33,6 +33,7 @@
   },
   "devDependencies": {
     "nx": "22.7.5",
+    "@thunderid/eslint-plugin": "catalog:",
     "eslint": "catalog:",
     "prettier": "catalog:",
     "rimraf": "catalog:",

packages/javascript/src/api/getOrganizationUnitChildren.ts

@@ -116,8 +116,7 @@ const getOrganizationUnitChildren = async ({
   if (offset !== undefined) queryParams.set('offset', String(offset));
   const query = queryParams.toString();
 
-  const resolvedBase =
-    url ?? `${baseUrl}/api/server/v1/organization-units/${organizationUnitId}/children`;
+  const resolvedBase = url ?? `${baseUrl}/api/server/v1/organization-units/${organizationUnitId}/children`;
   const resolvedUrl = query ? `${resolvedBase}?${query}` : resolvedBase;
 
   const requestInit: RequestInit = {

packages/nextjs/rolldown.config.js

@@ -23,7 +23,7 @@ import {defineConfig} from 'rolldown';
 const pkg = JSON.parse(readFileSync('./package.json', 'utf8'));
 
 const externalPackages = [...Object.keys(pkg.dependencies || {}), ...Object.keys(pkg.peerDependencies || {})];
-const external = id => externalPackages.some(name => id === name || id.startsWith(`${name}/`));
+const external = (id) => externalPackages.some((name) => id === name || id.startsWith(`${name}/`));
 
 const commonOptions = {
   input: [join('src', 'index.ts'), join('src', 'server', 'index.ts')],

packages/nextjs/src/client/components/actions/SignInButton/SignInButton.tsx

@@ -22,7 +22,7 @@ import {ThunderIDRuntimeError} from '@thunderid/node';
 import {BaseSignInButton, BaseSignInButtonProps, useTranslation} from '@thunderid/react';
 import {AppRouterInstance} from 'next/dist/shared/lib/app-router-context.shared-runtime';
 import {useRouter} from 'next/navigation';
-import {forwardRef, ForwardRefExoticComponent, ReactElement, Ref, RefAttributes, MouseEvent} from 'react';
+import {forwardRef, ForwardRefExoticComponent, ReactElement, Ref, RefAttributes, MouseEvent, useState} from 'react';
 import useThunderID from '../../../contexts/ThunderID/useThunderID';
 
 /**
@@ -71,25 +71,34 @@ const SignInButton: ForwardRefExoticComponent<SignInButtonProps & RefAttributes<
     const router: AppRouterInstance = useRouter();
     const {t} = useTranslation(preferences?.i18n);
 
-    const handleOnClick = async (e: MouseEvent<HTMLButtonElement>): Promise<void> => {
+    const [isLoading, setIsLoading] = useState(false);
+
+    const handleSignIn = async (): Promise<void> => {
       try {
+        setIsLoading(true);
+
         // If a custom `signInUrl` is provided, use it for navigation.
         if (signInUrl) {
           router.push(signInUrl);
         } else if (signIn) {
           await signIn(signInOptions);
         }
-
-        if (onClick) {
-          onClick(e);
-        }
       } catch (error) {
         throw new ThunderIDRuntimeError(
           `Sign in failed: ${error instanceof Error ? error.message : String(error)}`,
           'SignInButton-handleSignIn-RuntimeError-001',
           'nextjs',
           'Something went wrong while trying to sign in. Please try again later.',
         );
+      } finally {
+        setIsLoading(false);
+      }
+    };
+
+    const handleOnClick = async (e: MouseEvent<HTMLButtonElement>): Promise<void> => {
+      await handleSignIn();
+      if (onClick) {
+        onClick(e);
       }
     };
 
@@ -99,6 +108,8 @@ const SignInButton: ForwardRefExoticComponent<SignInButtonProps & RefAttributes<
         style={style}
         ref={ref}
         preferences={preferences}
+        isLoading={isLoading}
+        signIn={handleSignIn}
         onClick={handleOnClick}
         {...rest}
       >

packages/nextjs/src/client/contexts/ThunderID/ThunderIDProvider.tsx

@@ -302,10 +302,7 @@ const ThunderIDClientProvider: FC<PropsWithChildren<ThunderIDClientProviderProps
     <ThunderIDContext.Provider value={contextValue}>
       <I18nProvider preferences={preferences?.i18n}>
         <FlowMetaProvider enabled={preferences?.resolveFromMeta !== false}>
-          <ThemeProvider
-            theme={preferences?.theme?.overrides}
-            mode={getActiveTheme(preferences?.theme?.mode as any)}
-          >
+          <ThemeProvider theme={preferences?.theme?.overrides} mode={getActiveTheme(preferences?.theme?.mode as any)}>
             <FlowProvider>
               <UserProvider profile={userProfile} onUpdateProfile={handleProfileUpdate} updateProfile={updateProfile}>
                 {children}

packages/nextjs/src/server/index.ts

@@ -27,4 +27,3 @@ export {default as thunderIDProxy} from './proxy/thunderIDProxy';
 export * from './proxy/thunderIDProxy';
 
 export {default as createRouteMatcher} from './proxy/createRouteMatcher';
-

packages/nextjs/src/server/proxy/thunderIDProxy.ts

@@ -146,8 +146,7 @@ const thunderIDProxy =
     options?: ThunderIDProxyOptions | ((req: NextRequest) => ThunderIDProxyOptions),
   ): ((request: NextRequest) => Promise<NextResponse>) =>
   async (request: NextRequest): Promise<NextResponse> => {
-    const resolvedOptions: ThunderIDProxyOptions =
-      typeof options === 'function' ? options(request) : options || {};
+    const resolvedOptions: ThunderIDProxyOptions = typeof options === 'function' ? options(request) : options || {};
 
     // Resolve full config from passed options + environment variable fallbacks.
     const resolvedConfig: ThunderIDNextConfig = decorateConfigWithNextEnv(resolvedOptions as ThunderIDNextConfig);