@seifer-webapp-factory/authentication 0.1.0

package/frontend/templates/runtime.ts

@@ -0,0 +1,60 @@
+/**
+ * Kleine, test-veilige runtime-helpers voor de auth-surface-pagina's. Géén mechanisme — puur
+ * glue die de pagina's los-koppelt van het host-framework (Nuxt) zodat ze óók bloot in vitest
+ * renderen. Alle helpers zijn per-instance / injectie-gebaseerd: geen module-globale mutable state.
+ *
+ * - `useTranslate()` — leest de i18n-kit-instance als die geprovide is, valt anders veilig terug op
+ *   de sleutel zelf (zodat een pagina zonder i18n-provider tóch rendert; tests zien de sleutel).
+ * - `useNavigate()` / `provideNavigate()` — injecteerbare navigatie; de Nuxt-plugin wired hier
+ *   `navigateTo`; zonder provider is het een no-op (tests hoeven geen router).
+ * - `readQueryParam()` — leest een query-parameter (bv. `token`, `redirect`) uit `window.location`,
+ *   test-veilig (happy-dom) en client-safe.
+ * - `useOptionalToasts()` — leest de notifications-toast-store als die geprovide is, anders `undefined`.
+ */
+import { inject, type App, type InjectionKey } from 'vue';
+import { I18N_KEY } from '@seifer-webapp-factory/kits/frontend/i18n/vue';
+import { TOAST_STORE_KEY } from '@seifer-webapp-factory/kits/frontend/notifications/vue';
+import type { UseToasts } from '@seifer-webapp-factory/kits/frontend/notifications/vue';
+
+/** Vertaal-functie: sleutel (+ optionele interpolatie-params) → gelokaliseerde tekst. */
+export type TranslateFn = (key: string, params?: Readonly<Record<string, unknown>>) => string;
+
+/**
+ * Levert een vertaal-functie. Met geprovide i18n-kit: echte vertaling. Zonder: identiteit (de
+ * sleutel zelf), zodat een surface-pagina ook zonder i18n-provider rendert.
+ */
+export function useTranslate(): TranslateFn {
+  const i18n = inject(I18N_KEY, undefined);
+  return (key, params) => (i18n !== undefined ? i18n.t(key, params) : key);
+}
+
+/** Navigatie-functie: stuurt de gebruiker naar een pad (bv. na een geslaagde login). */
+export type NavigateFn = (to: string) => void;
+
+/** Injectie-sleutel voor de navigator. Module-constante (geen mutable state). */
+export const AUTH_NAVIGATE_KEY: InjectionKey<NavigateFn> = Symbol('auth.navigate');
+
+/** Registreer de navigator op een app-instance (de Nuxt-plugin wired hier `navigateTo`). */
+export function provideNavigate(app: App, navigate: NavigateFn): void {
+  app.provide(AUTH_NAVIGATE_KEY, navigate);
+}
+
+/** Haal de navigator op binnen setup(). Zonder provider: een veilige no-op. */
+export function useNavigate(): NavigateFn {
+  return inject(AUTH_NAVIGATE_KEY, () => {});
+}
+
+/**
+ * Lees een query-parameter uit de huidige URL. Test-veilig (happy-dom levert `window.location`) en
+ * client-safe. Zonder `window` (SSR): lege string.
+ */
+export function readQueryParam(name: string): string {
+  if (typeof window === 'undefined' || window.location == null) return '';
+  return new URLSearchParams(window.location.search).get(name) ?? '';
+}
+
+/** Haal de (optionele) toast-store op; `undefined` als notifications niet geprovide is. */
+export function useOptionalToasts(): UseToasts['success'] | undefined {
+  const store = inject(TOAST_STORE_KEY, undefined);
+  return store?.success;
+}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@seifer-webapp-factory/authentication",
+  "version": "0.1.0",
+  "description": "authentication — eerste capability-module: verticale, pluggable full-stack auth-feature (register/login/logout/verify/refresh/reset) die de backend- en frontend-kits samenbindt via één contract.",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    "./contract": {
+      "types": "./dist/contract/index.d.ts",
+      "import": "./dist/contract/index.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/src/index.d.ts",
+      "import": "./dist/backend/src/index.js"
+    },
+    "./frontend": {
+      "types": "./dist/frontend/src/index.d.ts",
+      "import": "./dist/frontend/src/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "import": "./dist/manifest.js"
+    },
+    "./scaffolder": {
+      "types": "./dist/scaffolder/index.d.ts",
+      "import": "./dist/scaffolder/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0",
+    "zod": "^3.23.0",
+    "@seifer-webapp-factory/kits": "^0.1.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.4.22",
+    "@nestjs/core": "^10.4.22",
+    "@nestjs/platform-express": "^10.4.22",
+    "@nestjs/testing": "^10.4.22",
+    "@playwright/test": "^1.50.0",
+    "@types/pg": "^8.20.0",
+    "@types/supertest": "^6.0.0",
+    "@vitejs/plugin-vue": "^5.2.0",
+    "@vue/test-utils": "^2.4.0",
+    "happy-dom": "^15.0.0",
+    "pg": "^8.22.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "supertest": "^7.0.0",
+    "testcontainers": "^10.28.0",
+    "tsx": "^4.23.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0",
+    "vue": "^3.4.0",
+    "zod": "^3.24.0",
+    "@seifer-webapp-factory/kits": "^0.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "backend/templates",
+    "frontend/templates",
+    "README.md"
+  ]
+}