@enformik/auth 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Enformik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -42,17 +42,19 @@ if (!auth.isAuthenticated()) {
 | `config` | Okunan site yapılandırması (`appUrl`, `apiUrl`, `workspaceId`, `auth`…). |
 | `isAuthenticated()` | Geçerli ya da yenilenebilir oturum var mı. |
 | `login(returnTo?)` | Giriş sayfasına yönlendirir; `returnTo` giriş sonrası dönülecek yoldur. |
+| `register(returnTo?)` | Hesap oluşturma sayfasına yönlendirir (sitede "kendi kendine kayıt" açıksa). Kişi parolasını e-postasına gelen bağlantıyla belirler, sonra `login()` ile girer. |
 | `handleRedirect()` | Girişten dönüşü tamamlar; `{ returnTo }` ya da `null` döner. |
 | `getAccessToken()` | Geçerli access token'ı döner, gerekirse yeniler (eşzamanlı çağrılar tek yenilemede birleşir). |
 | `fetch(path, init?)` | Uygulamanın API'sini oturumla çağırır; 401'de bir kez yenileyip tekrarlar. |
 | `getUser()` | ID token'dan `{ sub, email?, name? }` — yalnızca arayüzde göstermek içindir. |
+| `deleteAccount()` | Kullanıcının kendi hesabını kalıcı siler (KVKK silme hakkı) ve yerel oturumu temizler; kullanıcının oluşturduğu kayıtlar silinmez. Başarısızsa `account_delete_failed` hatası atar. |
 | `logout()` | Oturumu siler ve giriş sayfasından çıkış yaptırır. |
 
 Seçenekler (`AuthOptions`): `config` (nesne ya da adres; varsayılan `/_enformik/config.json`), `redirectPath` (varsayılan `/callback`), `postLogoutPath` (varsayılan `/`), `storage` (`'session'` varsayılan, `'local'` ya da kendi `getItem/setItem/removeItem` nesneniz).
 
 `redirectPath` sitenizin kayıtlı dönüş adreslerinden biri olmalıdır: `/`, `/callback`, `/auth/callback`, `/login/callback`.
 
-Hatalar `EnformikAuthError` olarak atılır; `code` alanı: `not_configured`, `state_mismatch`, `no_pending_login`, `login_rejected`, `token_exchange_failed`, `not_authenticated`.
+Hatalar `EnformikAuthError` olarak atılır; `code` alanı: `not_configured`, `state_mismatch`, `no_pending_login`, `login_rejected`, `token_exchange_failed`, `not_authenticated`, `account_delete_failed`.
 
 ## Güvenlik notları
 

package/dist/auth.d.ts

@@ -1,4 +1,4 @@
-import { type AuthConfig, type AuthOptions, type AuthUser, type SiteConfig } from './types';
+import { type AuthConfig, type AuthOptions, type AuthUser, type SiteConfig } from './types.js';
 export interface Auth {
     /** Okunan site yapılandırması (`auth` bloğu doludur; yoksa `createAuth` zaten `not_configured` verir). */
     readonly config: SiteConfig & {
@@ -8,6 +8,11 @@ export interface Auth {
     isAuthenticated(): boolean;
     /** Giriş sayfasına yönlendirir. `returnTo`: giriş sonrası dönülecek yol (varsayılan: şu anki yol). */
     login(returnTo?: string): Promise<void>;
+    /**
+     * Hesap oluşturma sayfasına yönlendirir (sitede "kendi kendine kayıt" açıksa; kapalıysa sayfa bunu bildirir). Kişi parolasını e-postasına
+     * gelen bağlantıyla belirler, sonra `login()` ile girer; sayfadaki "Giriş yapın" bağlantısı da aynı `returnTo` ile girişe döner.
+     */
+    register(returnTo?: string): Promise<void>;
     /**
      * Dönüş adresinde (`?code=&state=`) girişi tamamlar. Her sayfa yüklemesinde çağırmak güvenlidir: dönüş yoksa `null` döner.
      * Başarıda `{ returnTo }` döner (sayfayı oraya yönlendirmek istemci koduna bırakılır).
@@ -21,6 +26,12 @@ export interface Auth {
     fetch(path: string, init?: RequestInit): Promise<Response>;
     /** ID token'dan kullanıcı bilgisi (yalnızca arayüz için). */
     getUser(): AuthUser | null;
+    /**
+     * Kullanıcının kendi hesabını kalıcı siler (KVKK silme hakkı) ve yerel oturumu temizler; çağıran sonrasında kullanıcıyı bilgilendirip
+     * yönlendirmelidir. Hesap yalnızca web kullanıcısı rolündeyse silinir; başarısızsa `account_delete_failed` hatası atar. Kullanıcının
+     * oluşturduğu kayıtlar silinmez (hiçbir hesaba bağlı olmayan bir kimlikle kalır) — saklama politikası site sahibine aittir.
+     */
+    deleteAccount(): Promise<void>;
     /** Oturumu siler ve sağlayıcıdan çıkış yaptırır. */
     logout(): Promise<void>;
 }

package/dist/auth.js

@@ -1,5 +1,5 @@
-import { challengeFor, randomString } from './pkce';
-import { EnformikAuthError } from './types';
+import { challengeFor, randomString } from './pkce.js';
+import { EnformikAuthError } from './types.js';
 const PENDING_KEY = 'enformik.auth.pending';
 const TOKENS_KEY = 'enformik.auth.tokens';
 const LEEWAY_MS = 30_000; // süresi dolmadan 30 sn önce yenile
@@ -105,25 +105,52 @@ export async function createAuth(opts = {}) {
             return t.accessToken;
         return (await refresh())?.accessToken ?? null;
     };
+    const apiFetch = async (path, init = {}) => {
+        const base = cfg.apiUrl.replace(/\/$/, '');
+        const url = /^https?:\/\//i.test(path) ? path : base + (path.startsWith('/') ? path : '/' + path);
+        const call = async (token) => {
+            const h = new Headers(init.headers);
+            h.set('Authorization', 'Bearer ' + token);
+            if (cfg.workspaceId && !h.has('X-Tenant-ID'))
+                h.set('X-Tenant-ID', cfg.workspaceId);
+            return f(url, { ...init, headers: h });
+        };
+        let token = await getAccessToken();
+        if (!token)
+            throw new EnformikAuthError('not_authenticated', 'Oturum yok; önce giriş yapın.');
+        let res = await call(token);
+        if (res.status === 401) {
+            // Token sunucuda reddedildi (iptal/erken bitiş): bir kez yenile ve tekrar dene.
+            const t = await refresh();
+            if (!t)
+                throw new EnformikAuthError('not_authenticated', 'Oturum sona erdi; yeniden giriş yapın.');
+            token = t.accessToken;
+            res = await call(token);
+        }
+        return res;
+    };
+    // Giriş / kayıt sayfasına PKCE ile yönlendirir; ikisi de aynı bekleyen girişi (state + verifier) kullanır.
+    const startFlow = async (path, returnTo) => {
+        const verifier = randomString(32, cry);
+        const state = randomString(16, cry);
+        write(PENDING_KEY, { state, verifier, returnTo: returnTo ?? loc.href.slice(loc.origin.length) });
+        const q = new URLSearchParams({
+            client_id: a.clientId,
+            redirect_uri: redirectUri(),
+            code_challenge: await challengeFor(verifier, cry),
+            code_challenge_method: 'S256',
+            state,
+        });
+        loc.assign(a.gatewayUrl.replace(/\/$/, '') + path + '?' + q.toString());
+    };
     return {
         config: { ...cfg, auth: a },
         isAuthenticated() {
             const t = read(TOKENS_KEY);
             return !!t && (t.expiresAt > now() || !!t.refreshToken);
         },
-        async login(returnTo) {
-            const verifier = randomString(32, cry);
-            const state = randomString(16, cry);
-            write(PENDING_KEY, { state, verifier, returnTo: returnTo ?? loc.href.slice(loc.origin.length) });
-            const q = new URLSearchParams({
-                client_id: a.clientId,
-                redirect_uri: redirectUri(),
-                code_challenge: await challengeFor(verifier, cry),
-                code_challenge_method: 'S256',
-                state,
-            });
-            loc.assign(a.gatewayUrl.replace(/\/$/, '') + '/login?' + q.toString());
-        },
+        login: (returnTo) => startFlow('/login', returnTo),
+        register: (returnTo) => startFlow('/register', returnTo),
         async handleRedirect() {
             const q = new URLSearchParams(loc.search);
             const err = q.get('error');
@@ -155,30 +182,7 @@ export async function createAuth(opts = {}) {
             return { returnTo: pending.returnTo };
         },
         getAccessToken,
-        async fetch(path, init = {}) {
-            const base = cfg.apiUrl.replace(/\/$/, '');
-            const url = /^https?:\/\//i.test(path) ? path : base + (path.startsWith('/') ? path : '/' + path);
-            const call = async (token) => {
-                const h = new Headers(init.headers);
-                h.set('Authorization', 'Bearer ' + token);
-                if (cfg.workspaceId && !h.has('X-Tenant-ID'))
-                    h.set('X-Tenant-ID', cfg.workspaceId);
-                return f(url, { ...init, headers: h });
-            };
-            let token = await getAccessToken();
-            if (!token)
-                throw new EnformikAuthError('not_authenticated', 'Oturum yok; önce giriş yapın.');
-            let res = await call(token);
-            if (res.status === 401) {
-                // Token sunucuda reddedildi (iptal/erken bitiş): bir kez yenile ve tekrar dene.
-                const t = await refresh();
-                if (!t)
-                    throw new EnformikAuthError('not_authenticated', 'Oturum sona erdi; yeniden giriş yapın.');
-                token = t.accessToken;
-                res = await call(token);
-            }
-            return res;
-        },
+        fetch: apiFetch,
         getUser() {
             const id = read(TOKENS_KEY)?.idToken;
             const c = id ? decodeJwtPayload(id) : null;
@@ -186,6 +190,16 @@ export async function createAuth(opts = {}) {
                 return null;
             return { sub: c.sub, email: typeof c.email === 'string' ? c.email : undefined, name: typeof c.name === 'string' ? c.name : undefined };
         },
+        async deleteAccount() {
+            const res = await apiFetch('/me/account', { method: 'DELETE' });
+            if (!res.ok) {
+                const body = (await res.json().catch(() => ({})));
+                throw new EnformikAuthError('account_delete_failed', body.message ?? `Hesap silinemedi (HTTP ${res.status}).`);
+            }
+            // Hesap artık yok: yerel oturumu sil (sağlayıcıda çıkış yaptırmaya gerek yok).
+            store.removeItem(TOKENS_KEY);
+            store.removeItem(PENDING_KEY);
+        },
         async logout() {
             const idToken = read(TOKENS_KEY)?.idToken;
             store.removeItem(TOKENS_KEY);

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { createAuth } from './auth';
-export type { Auth } from './auth';
-export { EnformikAuthError } from './types';
-export type { AuthConfig, AuthErrorCode, AuthOptions, AuthUser, KeyValueStorage, SiteConfig } from './types';
+export { createAuth } from './auth.js';
+export type { Auth } from './auth.js';
+export { EnformikAuthError } from './types.js';
+export type { AuthConfig, AuthErrorCode, AuthOptions, AuthUser, KeyValueStorage, SiteConfig } from './types.js';

package/dist/index.js

@@ -1,2 +1,2 @@
-export { createAuth } from './auth';
-export { EnformikAuthError } from './types';
+export { createAuth } from './auth.js';
+export { EnformikAuthError } from './types.js';

package/dist/types.d.ts

@@ -24,7 +24,7 @@ export interface AuthUser {
     email?: string;
     name?: string;
 }
-export type AuthErrorCode = 'not_configured' | 'state_mismatch' | 'no_pending_login' | 'login_rejected' | 'token_exchange_failed' | 'not_authenticated';
+export type AuthErrorCode = 'not_configured' | 'state_mismatch' | 'no_pending_login' | 'login_rejected' | 'token_exchange_failed' | 'not_authenticated' | 'account_delete_failed';
 export declare class EnformikAuthError extends Error {
     readonly code: AuthErrorCode;
     constructor(code: AuthErrorCode, message: string);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@enformik/auth",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Enformik web sitesi girişi: tarayıcı için OIDC yetkilendirme kodu + PKCE istemcisi (sıfır bağımlılık).",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,7 +24,8 @@
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
-    "prepublishOnly": "npm run build && npm test"
+    "prepublishOnly": "npm run build && npm test && npm run smoke",
+    "smoke": "node --input-type=module -e \"const m = await import('./dist/index.js'); if (typeof m.createAuth !== 'function') throw new Error('createAuth yok')\""
   },
   "devDependencies": {
     "@types/node": "^22.10.0",