bypilot-business-signup-sdk 0.1.0-beta.1

package/dist/index-DzVvaEqu.d.ts

@@ -0,0 +1,493 @@
+/**
+ * OAuth token yapısı
+ */
+interface OAuthToken {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt?: number;
+    tokenType: string;
+    scope?: string;
+}
+/**
+ * Token storage stratejisi
+ */
+type StorageStrategy = 'localStorage' | 'sessionStorage' | 'memory';
+/**
+ * OAuth client konfigürasyonu
+ */
+interface OAuthConfig {
+    clientId: string;
+    redirectUri: string;
+    scope?: string;
+    state?: string;
+    storage?: StorageStrategy;
+}
+/**
+ * Popup konfigürasyonu
+ */
+interface PopupConfig {
+    width?: number;
+    height?: number;
+    left?: number;
+    top?: number;
+}
+/**
+ * OAuth callback response
+ */
+interface OAuthCallbackResponse {
+    code?: string;
+    state?: string;
+    error?: string;
+    errorDescription?: string;
+}
+/**
+ * Provider base konfigürasyonu
+ */
+interface ProviderConfig extends OAuthConfig {
+    [key: string]: unknown;
+}
+/**
+ * SDK event tipleri
+ */
+type SDKEventType = 'auth:start' | 'auth:success' | 'auth:error' | 'auth:cancel' | 'token:refresh' | 'token:expire';
+/**
+ * SDK event listener
+ */
+type SDKEventListener<T = unknown> = (data: T) => void;
+/**
+ * Auth result
+ */
+interface AuthResult {
+    success: boolean;
+    token?: OAuthToken;
+    error?: string;
+    errorDescription?: string;
+    raw?: Record<string, unknown>;
+}
+
+/**
+ * Token yönetimi için storage wrapper
+ */
+declare class TokenManager {
+    private strategy;
+    private memoryStorage;
+    private storageKey;
+    constructor(providerName: string, strategy?: StorageStrategy);
+    /**
+     * Token'ı storage'a kaydet
+     */
+    save(token: OAuthToken): void;
+    /**
+     * Token'ı storage'dan getir
+     */
+    get(): OAuthToken | null;
+    /**
+     * Token'ı sil
+     */
+    clear(): void;
+    /**
+     * Token'ın geçerli olup olmadığını kontrol et
+     */
+    isValid(): boolean;
+    /**
+     * Token'ın süresinin dolmasına kalan süre (ms)
+     */
+    getTimeUntilExpiry(): number | null;
+}
+
+/**
+ * SDK için basit event emitter
+ */
+declare class EventEmitter {
+    private listeners;
+    /**
+     * Event listener ekle
+     */
+    on<T = unknown>(event: SDKEventType, listener: SDKEventListener<T>): () => void;
+    /**
+     * Event listener kaldır
+     */
+    off<T = unknown>(event: SDKEventType, listener: SDKEventListener<T>): void;
+    /**
+     * Event tetikle
+     */
+    emit<T = unknown>(event: SDKEventType, data?: T): void;
+    /**
+     * Tek seferlik event listener
+     */
+    once<T = unknown>(event: SDKEventType, listener: SDKEventListener<T>): () => void;
+    /**
+     * Tüm listener'ları temizle
+     */
+    removeAllListeners(event?: SDKEventType): void;
+}
+
+/**
+ * OAuth popup yönetimi
+ */
+declare class PopupManager {
+    private popup;
+    private checkInterval;
+    /**
+     * Popup aç ve URL'e yönlendir
+     */
+    open(url: string, config?: PopupConfig): Window | null;
+    /**
+     * Popup'ın kapanmasını bekle
+     */
+    waitForClose(): Promise<void>;
+    /**
+     * Popup'tan callback al (postMessage ile)
+     */
+    waitForCallback<T>(origin: string, timeout?: number): Promise<T>;
+    /**
+     * Popup'ı kapat ve temizle
+     */
+    close(): void;
+    private cleanup;
+    /**
+     * Popup aktif mi?
+     */
+    isOpen(): boolean;
+}
+
+/**
+ * Tüm OAuth provider'ları için base class
+ */
+declare abstract class BaseProvider extends EventEmitter {
+    protected config: ProviderConfig;
+    protected tokenManager: TokenManager;
+    protected popupManager: PopupManager;
+    /**
+     * Provider adı (alt sınıflar override etmeli)
+     */
+    abstract readonly name: string;
+    /**
+     * OAuth authorization URL'i
+     */
+    protected abstract readonly authorizationEndpoint: string;
+    constructor(config: ProviderConfig);
+    /**
+     * Authorization URL'i oluştur
+     */
+    protected abstract buildAuthorizationUrl(state: string): string;
+    /**
+     * Callback'i işle ve token al
+     */
+    protected abstract handleCallback(callbackData: Record<string, unknown>): Promise<AuthResult>;
+    /**
+     * Random state oluştur
+     */
+    protected generateState(): string;
+    /**
+     * Popup ile login başlat
+     */
+    loginWithPopup(popupConfig?: PopupConfig): Promise<AuthResult>;
+    /**
+     * Redirect ile login başlat
+     */
+    loginWithRedirect(): void;
+    /**
+     * Redirect callback'ini işle (sayfa yüklendiğinde çağrılmalı)
+     */
+    handleRedirectCallback(): Promise<AuthResult | null>;
+    /**
+     * Mevcut token'ı getir
+     */
+    getToken(): OAuthToken | null;
+    /**
+     * Access token'ı getir
+     */
+    getAccessToken(): string | null;
+    /**
+     * Token geçerli mi?
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Logout - token'ı temizle
+     */
+    logout(): void;
+    /**
+     * Storage stratejisini değiştir
+     */
+    setStorageStrategy(strategy: StorageStrategy): void;
+}
+
+/**
+ * WhatsApp Embedded Signup konfigürasyonu
+ */
+interface WhatsAppConfig extends ProviderConfig {
+    /**
+     * Facebook App ID
+     */
+    clientId: string;
+    /**
+     * Facebook App Secret (opsiyonel - backend token exchange için)
+     * DİKKAT: Frontend'de kullanılmamalı!
+     */
+    clientSecret?: string;
+    /**
+     * Config ID - Meta Business Suite'den alınan Embedded Signup config
+     */
+    configId: string;
+    /**
+     * Solution ID (opsiyonel)
+     */
+    solutionId?: string;
+    /**
+     * Facebook SDK version
+     * @default 'v24.0'
+     */
+    sdkVersion?: string;
+    /**
+     * Graph API version
+     * @default 'v24.0'
+     */
+    graphApiVersion?: string;
+    /**
+     * Redirect URI (callback URL)
+     */
+    redirectUri: string;
+    /**
+     * İstenen izinler
+     */
+    scope?: string;
+    /**
+     * Ek özellikler
+     */
+    extras?: WhatsAppExtras;
+}
+/**
+ * WhatsApp Embedded Signup ek özellikleri
+ */
+interface WhatsAppExtras {
+    /**
+     * Önceden doldurulmuş telefon numarası
+     */
+    preverifiedPhone?: string;
+    /**
+     * Önceden seçilmiş WABA ID
+     */
+    wabaId?: string;
+    /**
+     * Önceden seçilmiş Business ID
+     */
+    businessId?: string;
+    /**
+     * Feature tipi
+     */
+    featureType?: 'whatsapp_embedded_signup' | 'whatsapp_coexistence_signup';
+    /**
+     * Session info version
+     */
+    sessionInfoVersion?: number;
+}
+/**
+ * WhatsApp auth response
+ */
+interface WhatsAppAuthResponse {
+    /**
+     * Access token (token-based flow)
+     */
+    accessToken?: string;
+    /**
+     * Authorization code (code-based flow)
+     */
+    code?: string;
+    /**
+     * User ID
+     */
+    userID?: string;
+    /**
+     * Token tipi
+     */
+    signedRequest?: string;
+    /**
+     * Graphdomain
+     */
+    graphDomain?: string;
+    /**
+     * Data access expiration time
+     */
+    data_access_expiration_time?: number;
+    /**
+     * Expiration time (seconds)
+     */
+    expiresIn?: number;
+}
+/**
+ * Embedded Signup session info
+ */
+interface WhatsAppSessionInfo {
+    /**
+     * Access token
+     */
+    accessToken: string;
+    /**
+     * Phone number ID
+     */
+    phoneNumberId?: string;
+    /**
+     * WABA ID (WhatsApp Business Account ID)
+     */
+    wabaId?: string;
+    /**
+     * Business ID
+     */
+    businessId?: string;
+    /**
+     * Phone number
+     */
+    phoneNumber?: string;
+    /**
+     * Phone number verified
+     */
+    phoneNumberVerified?: boolean;
+}
+/**
+ * Facebook SDK login options
+ */
+interface FBLoginOptions {
+    config_id: string;
+    response_type: string;
+    override_default_response_type: boolean;
+    extras: Record<string, unknown>;
+}
+/**
+ * Facebook SDK global type declaration
+ */
+declare global {
+    interface Window {
+        FB?: {
+            init: (params: {
+                appId: string;
+                cookie?: boolean;
+                xfbml?: boolean;
+                version: string;
+            }) => void;
+            login: (callback: (response: FBLoginResponse) => void, options: FBLoginOptions) => void;
+            logout: (callback?: () => void) => void;
+            getLoginStatus: (callback: (response: FBLoginResponse) => void) => void;
+            api: (path: string, method: string | ((response: unknown) => void), params?: Record<string, unknown> | ((response: unknown) => void), callback?: (response: unknown) => void) => void;
+        };
+        fbAsyncInit?: () => void;
+    }
+}
+/**
+ * Facebook login response
+ */
+interface FBLoginResponse {
+    status: 'connected' | 'not_authorized' | 'unknown';
+    authResponse?: WhatsAppAuthResponse;
+}
+
+/**
+ * WhatsApp Embedded Signup Provider
+ *
+ * Meta'nın WhatsApp Business Platform için Embedded Signup akışını yönetir.
+ * Facebook SDK kullanarak OAuth 2.0 akışı gerçekleştirir.
+ *
+ * @example
+ * ```typescript
+ * const whatsapp = new WhatsAppProvider({
+ *   clientId: 'YOUR_FB_APP_ID',
+ *   configId: 'YOUR_CONFIG_ID',
+ *   redirectUri: 'https://yoursite.com/callback'
+ * });
+ *
+ * // Event listener
+ * whatsapp.on('auth:success', (result) => {
+ *   console.log('Authenticated!', result);
+ * });
+ *
+ * // Login başlat
+ * await whatsapp.loginWithPopup();
+ * ```
+ */
+declare class WhatsAppProvider extends BaseProvider {
+    readonly name = "whatsapp";
+    protected readonly authorizationEndpoint = "https://www.facebook.com/v24.0/dialog/oauth";
+    private fbSDKLoaded;
+    private fbSDKLoadPromise;
+    private whatsappConfig;
+    constructor(config: WhatsAppConfig);
+    /**
+     * Facebook SDK'yı yükle
+     */
+    private loadFacebookSDK;
+    /**
+     * Facebook SDK'yı başlat
+     */
+    private initFacebookSDK;
+    /**
+     * Authorization URL oluştur (redirect flow için)
+     */
+    protected buildAuthorizationUrl(state: string): string;
+    /**
+     * Callback'i işle
+     */
+    protected handleCallback(callbackData: Record<string, unknown>): Promise<AuthResult>;
+    /**
+     * WhatsApp Embedded Signup popup ile başlat
+     *
+     * Facebook SDK kullanarak native popup deneyimi sağlar.
+     * Session info message event'i ile WABA ID, Phone Number ID ve access token alır.
+     */
+    loginWithPopup(_popupConfig?: PopupConfig): Promise<AuthResult>;
+    /**
+     * Session info için message event bekle
+     */
+    private waitForSessionInfo;
+    /**
+     * Son alınan session info
+     */
+    private lastSessionInfo;
+    /**
+     * Son session info'yu al
+     */
+    getLastSessionInfo(): WhatsAppSessionInfo | null;
+    /**
+     * Embedded Signup akışını başlat
+     */
+    private launchEmbeddedSignup;
+    /**
+     * Auth response'dan token oluştur
+     */
+    private buildToken;
+    /**
+     * Session info al (Embedded Signup sonrası)
+     *
+     * Facebook SDK message event'i ile session bilgilerini alır
+     */
+    getSessionInfoListener(callback: (info: WhatsAppSessionInfo) => void): () => void;
+    /**
+     * Login durumunu kontrol et
+     */
+    checkLoginStatus(): Promise<FBLoginResponse | null>;
+    /**
+     * Facebook'tan logout
+     */
+    logout(): void;
+    /**
+     * Graph API çağrısı yap (Facebook SDK kullanarak)
+     *
+     * @param path - API endpoint (örn: 'me' veya 'v24.0/me')
+     * @param method - HTTP method
+     * @param params - Query/body parametreleri
+     */
+    graphAPI<T = unknown>(path: string, method?: 'GET' | 'POST' | 'DELETE', params?: Record<string, unknown>): Promise<T>;
+    /**
+     * WhatsApp Cloud API'ye doğrudan HTTP çağrısı yap
+     *
+     * @param endpoint - API endpoint (örn: '123456/messages')
+     * @param method - HTTP method
+     * @param body - Request body
+     */
+    whatsappAPI<T = unknown>(endpoint: string, method?: 'GET' | 'POST' | 'DELETE', body?: Record<string, unknown>): Promise<T>;
+    /**
+     * Graph API version'unu al
+     */
+    getGraphApiVersion(): string;
+}
+
+export { type AuthResult as A, BaseProvider as B, EventEmitter as E, type FBLoginOptions as F, type OAuthCallbackResponse as O, type PopupConfig as P, type SDKEventListener as S, TokenManager as T, type WhatsAppAuthResponse as W, type FBLoginResponse as a, type OAuthConfig as b, type OAuthToken as c, PopupManager as d, type ProviderConfig as e, type SDKEventType as f, type StorageStrategy as g, type WhatsAppConfig as h, type WhatsAppExtras as i, WhatsAppProvider as j, type WhatsAppSessionInfo as k };

package/dist/index.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+var chunkARDHIAFU_cjs = require('./chunk-ARDHIAFU.cjs');
+
+// src/index.ts
+var VERSION = "1.0.0";
+
+Object.defineProperty(exports, "BaseProvider", {
+  enumerable: true,
+  get: function () { return chunkARDHIAFU_cjs.BaseProvider; }
+});
+Object.defineProperty(exports, "EventEmitter", {
+  enumerable: true,
+  get: function () { return chunkARDHIAFU_cjs.EventEmitter; }
+});
+Object.defineProperty(exports, "PopupManager", {
+  enumerable: true,
+  get: function () { return chunkARDHIAFU_cjs.PopupManager; }
+});
+Object.defineProperty(exports, "TokenManager", {
+  enumerable: true,
+  get: function () { return chunkARDHIAFU_cjs.TokenManager; }
+});
+Object.defineProperty(exports, "WhatsAppProvider", {
+  enumerable: true,
+  get: function () { return chunkARDHIAFU_cjs.WhatsAppProvider; }
+});
+exports.VERSION = VERSION;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAeO,IAAM,OAAA,GAAU","file":"index.cjs","sourcesContent":["/**\n * ByPilot SDK\n *\n * Business hesaplar için OAuth ve Embedded Signup yönetimi\n *\n * @packageDocumentation\n */\n\n// Core exports\nexport * from './core';\n\n// Provider exports\nexport * from './providers';\n\n// Version\nexport const VERSION = '1.0.0';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,13 @@
+export { A as AuthResult, B as BaseProvider, E as EventEmitter, F as FBLoginOptions, a as FBLoginResponse, O as OAuthCallbackResponse, b as OAuthConfig, c as OAuthToken, P as PopupConfig, d as PopupManager, e as ProviderConfig, S as SDKEventListener, f as SDKEventType, g as StorageStrategy, T as TokenManager, W as WhatsAppAuthResponse, h as WhatsAppConfig, i as WhatsAppExtras, j as WhatsAppProvider, k as WhatsAppSessionInfo } from './index-DzVvaEqu.cjs';
+
+/**
+ * ByPilot SDK
+ *
+ * Business hesaplar için OAuth ve Embedded Signup yönetimi
+ *
+ * @packageDocumentation
+ */
+
+declare const VERSION = "1.0.0";
+
+export { VERSION };

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { A as AuthResult, B as BaseProvider, E as EventEmitter, F as FBLoginOptions, a as FBLoginResponse, O as OAuthCallbackResponse, b as OAuthConfig, c as OAuthToken, P as PopupConfig, d as PopupManager, e as ProviderConfig, S as SDKEventListener, f as SDKEventType, g as StorageStrategy, T as TokenManager, W as WhatsAppAuthResponse, h as WhatsAppConfig, i as WhatsAppExtras, j as WhatsAppProvider, k as WhatsAppSessionInfo } from './index-DzVvaEqu.js';
+
+/**
+ * ByPilot SDK
+ *
+ * Business hesaplar için OAuth ve Embedded Signup yönetimi
+ *
+ * @packageDocumentation
+ */
+
+declare const VERSION = "1.0.0";
+
+export { VERSION };

package/dist/index.js

@@ -0,0 +1,8 @@
+export { BaseProvider, EventEmitter, PopupManager, TokenManager, WhatsAppProvider } from './chunk-B3CUULGV.js';
+
+// src/index.ts
+var VERSION = "1.0.0";
+
+export { VERSION };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAeO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["/**\n * ByPilot SDK\n *\n * Business hesaplar için OAuth ve Embedded Signup yönetimi\n *\n * @packageDocumentation\n */\n\n// Core exports\nexport * from './core';\n\n// Provider exports\nexport * from './providers';\n\n// Version\nexport const VERSION = '1.0.0';\n"]}

package/dist/whatsapp.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkARDHIAFU_cjs = require('./chunk-ARDHIAFU.cjs');
+
+
+
+Object.defineProperty(exports, "WhatsAppProvider", {
+  enumerable: true,
+  get: function () { return chunkARDHIAFU_cjs.WhatsAppProvider; }
+});
+//# sourceMappingURL=whatsapp.cjs.map
+//# sourceMappingURL=whatsapp.cjs.map

package/dist/whatsapp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"whatsapp.cjs"}

package/dist/whatsapp.d.cts

@@ -0,0 +1 @@
+export { F as FBLoginOptions, a as FBLoginResponse, W as WhatsAppAuthResponse, h as WhatsAppConfig, i as WhatsAppExtras, j as WhatsAppProvider, k as WhatsAppSessionInfo } from './index-DzVvaEqu.cjs';

package/dist/whatsapp.d.ts

@@ -0,0 +1 @@
+export { F as FBLoginOptions, a as FBLoginResponse, W as WhatsAppAuthResponse, h as WhatsAppConfig, i as WhatsAppExtras, j as WhatsAppProvider, k as WhatsAppSessionInfo } from './index-DzVvaEqu.js';

package/dist/whatsapp.js

@@ -0,0 +1,3 @@
+export { WhatsAppProvider } from './chunk-B3CUULGV.js';
+//# sourceMappingURL=whatsapp.js.map
+//# sourceMappingURL=whatsapp.js.map

package/dist/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"whatsapp.js"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "bypilot-business-signup-sdk",
+  "version": "0.1.0-beta.1",
+  "description": "Business hesaplar için OAuth ve Embedded Signup SDK'sı (WhatsApp, Instagram, Facebook vb.)",
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./whatsapp": {
+      "import": {
+        "types": "./dist/providers/whatsapp/index.d.ts",
+        "default": "./dist/whatsapp.js"
+      },
+      "require": {
+        "types": "./dist/providers/whatsapp/index.d.cts",
+        "default": "./dist/whatsapp.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "rimraf": "^5.0.0"
+  },
+  "keywords": [
+    "whatsapp",
+    "oauth",
+    "embedded-signup",
+    "facebook",
+    "meta",
+    "business-api",
+    "sdk"
+  ],
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}