18 — @talost/app-sdk ve Starter Şablonları

npm install @talost/app-sdk
# veya
pnpm add @talost/app-sdk

import { createTalostClient } from "@talost/app-sdk";

const talost = createTalostClient({
  issuer: process.env.TALOST_ISSUER || "https://id.talost.com",
  clientId: process.env.TALOST_CLIENT_ID!,
  clientSecret: process.env.TALOST_CLIENT_SECRET, // Confidential ise
  apiKey: process.env.TALOST_APP_API_KEY,         // M2M API'ler için
  environment: "PRODUCTION",                     // veya DEVELOPMENT
});

// 1. Authorize URL ve PKCE Üretimi
const { url, codeVerifier, state } = await talost.auth.buildAuthorizeUrl({
  redirectUri: "https://app.com/api/auth/callback",
  scope: ["openid", "profile", "email", "subscription"],
});

// 2. Token Takası
const tokens = await talost.auth.exchangeCode({
  code: "xyz...",
  codeVerifier: codeVerifier,
  redirectUri: "https://app.com/api/auth/callback",
});

// 3. Yerel Access Token Doğrulama (JWKS Cache)
const session = await talost.auth.verifyAccessToken(tokens.access_token);
console.log("Kullanıcı ID (sub):", session.sub);

const entitlement = await talost.entitlements.forUser(session.sub);

if (!entitlement.hasAccess) {
  throw new Error("Aktif lisansınız bulunmuyor.");
}

if (!entitlement.features.includes("export_pdf")) {
  throw new Error("Bu özellik mevcut planınızda bulunmuyor.");
}

// İmza geçersizse veya zaman aşımı varsa otomatik hata fırlatır
const event = talost.webhooks.verify({
  rawBody: requestBodyString,
  signatureHeader: request.headers["x-talost-signature"],
  secret: process.env.TALOST_WEBHOOK_SECRET!,
});

console.log("Doğrulanmış Olay:", event.type, event.data);

// Sunucu başlarken arka planda periyodik (60sn) heartbeat başlatır
const heartbeat = talost.health.startHeartbeat({
  platform: "WEB",
  version: "1.2.0",
  instanceId: "prod-web-01",
});

// Kapatırken:
// heartbeat.stop();

// Konfigürasyonu ETag önbelleği ile çeker
const config = await talost.config.get();

// Kullanıcı için bayrak aktif mi kontrol eder (Deterministik SHA-256 bucket)
const isBetaEnabled = await talost.flags.isEnabled("new_editor", session.sub);