@salefony/api-sdk 1.0.7 → 1.0.8

package/README.md

@@ -506,12 +506,8 @@ const { total, page, limit, totalPages, hasNextPage } = meta ?? {};
 Connect Google Analytics, Facebook Business, TikTok Pixel, etc. OAuth flow runs on the backend.
 
 ```typescript
-// Start OAuth – redirect user
-const url = sdk.admin.integrations.getAuthorizeUrl(
-  'google-analytics',
-  'https://app.example.com/admin/analytics'
-);
-window.location.href = url;  // React/Next.js
+// Start OAuth – URL oluşturur ve otomatik yönlendirir
+sdk.admin.integrations.authorize('google-analytics', '/admin/analytics');
 
 // Check connection status
 const { data } = await sdk.admin.integrations.getStatus('google-analytics');
@@ -524,9 +520,9 @@ await sdk.admin.integrations.disconnect('google-analytics');
 
 | Platform           | Flow                                                         |
 |--------------------|--------------------------------------------------------------|
-| React / Next.js    | `window.location.href = getAuthorizeUrl(...)`                |
-| Expo / React Native| `Linking.openURL(url)` or WebView with `redirect_uri`: `myapp://` |
-| Node.js            | Return URL or `res.redirect(url)`                            |
+| React / Next.js    | `authorize('google-analytics', '/admin/analytics')` – otomatik redirect |
+| Expo / React Native| `url = authorize(...)` + `Linking.openURL(url)` – sadece URL döner |
+| Node.js            | `url = authorize(...)` – sadece URL döner, `res.redirect(url)` |
 
 Full guide: [Integrations Documentation](./docs/INTEGRATIONS.md)
 

package/dist/index.d.mts

@@ -1253,21 +1253,30 @@ interface IntegrationConnectionStatus {
  * Tüm OAuth akışları backend üzerinden yönetilir - proxy yok.
  *
  * Kullanım:
- * - Bağlantı başlat: window.location.href = sdk.admin.integrations.getAuthorizeUrl('google-analytics', redirectUri)
+ * - Bağlantı başlat: sdk.admin.integrations.authorize('google-analytics', '/admin/analytics')
  * - Durum: sdk.admin.integrations.getStatus('google-analytics')
  * - Bağlantı kes: sdk.admin.integrations.disconnect('google-analytics')
  */
 declare class IntegrationsResource extends BaseResource {
     constructor(httpClient: AxiosInstance);
     /**
-     * OAuth başlatma URL'ini döner.
-     * Frontend bu URL'e yönlendirir (window.location.href = url).
-     * Cookie/Authorization ile backend'e gidilir, backend Google'a redirect eder.
+     * OAuth başlatır: URL üretir ve tarayıcıda yönlendirir.
+     * Kullanıcının URL oluşturup window.location atamasına gerek kalmaz.
+     *
+     * @param provider - Provider ID (google-analytics, facebook-business, vb.)
+     * @param redirectUriOrPath - Tam URL veya path (örn: '/admin/analytics'). Verilmezse mevcut sayfa kullanılır.
+     * @returns Oluşturulan URL (Node.js / Expo gibi ortamlarda manuel kullanım için)
+     */
+    authorize(provider: IntegrationProviderId | string, redirectUriOrPath?: string): string;
+    /**
+     * OAuth başlatma URL'ini döner (redirect yapmaz).
+     * Tarayıcıda otomatik yönlendirme için `authorize()` kullanın.
      *
      * @param provider - Provider ID (google-analytics, facebook-business, vb.)
      * @param redirectUri - OAuth tamamlandıktan sonra dönülecek URL (opsiyonel)
      */
     getAuthorizeUrl(provider: IntegrationProviderId | string, redirectUri?: string): string;
+    private resolveRedirectUri;
     /**
      * Bağlantı durumunu sorgular
      */

package/dist/index.d.ts

@@ -1253,21 +1253,30 @@ interface IntegrationConnectionStatus {
  * Tüm OAuth akışları backend üzerinden yönetilir - proxy yok.
  *
  * Kullanım:
- * - Bağlantı başlat: window.location.href = sdk.admin.integrations.getAuthorizeUrl('google-analytics', redirectUri)
+ * - Bağlantı başlat: sdk.admin.integrations.authorize('google-analytics', '/admin/analytics')
  * - Durum: sdk.admin.integrations.getStatus('google-analytics')
  * - Bağlantı kes: sdk.admin.integrations.disconnect('google-analytics')
  */
 declare class IntegrationsResource extends BaseResource {
     constructor(httpClient: AxiosInstance);
     /**
-     * OAuth başlatma URL'ini döner.
-     * Frontend bu URL'e yönlendirir (window.location.href = url).
-     * Cookie/Authorization ile backend'e gidilir, backend Google'a redirect eder.
+     * OAuth başlatır: URL üretir ve tarayıcıda yönlendirir.
+     * Kullanıcının URL oluşturup window.location atamasına gerek kalmaz.
+     *
+     * @param provider - Provider ID (google-analytics, facebook-business, vb.)
+     * @param redirectUriOrPath - Tam URL veya path (örn: '/admin/analytics'). Verilmezse mevcut sayfa kullanılır.
+     * @returns Oluşturulan URL (Node.js / Expo gibi ortamlarda manuel kullanım için)
+     */
+    authorize(provider: IntegrationProviderId | string, redirectUriOrPath?: string): string;
+    /**
+     * OAuth başlatma URL'ini döner (redirect yapmaz).
+     * Tarayıcıda otomatik yönlendirme için `authorize()` kullanın.
      *
      * @param provider - Provider ID (google-analytics, facebook-business, vb.)
      * @param redirectUri - OAuth tamamlandıktan sonra dönülecek URL (opsiyonel)
      */
     getAuthorizeUrl(provider: IntegrationProviderId | string, redirectUri?: string): string;
+    private resolveRedirectUri;
     /**
      * Bağlantı durumunu sorgular
      */

package/dist/index.js

@@ -1340,9 +1340,24 @@ var IntegrationsResource = class extends BaseResource {
     super(httpClient);
   }
   /**
-   * OAuth başlatma URL'ini döner.
-   * Frontend bu URL'e yönlendirir (window.location.href = url).
-   * Cookie/Authorization ile backend'e gidilir, backend Google'a redirect eder.
+   * OAuth başlatır: URL üretir ve tarayıcıda yönlendirir.
+   * Kullanıcının URL oluşturup window.location atamasına gerek kalmaz.
+   *
+   * @param provider - Provider ID (google-analytics, facebook-business, vb.)
+   * @param redirectUriOrPath - Tam URL veya path (örn: '/admin/analytics'). Verilmezse mevcut sayfa kullanılır.
+   * @returns Oluşturulan URL (Node.js / Expo gibi ortamlarda manuel kullanım için)
+   */
+  authorize(provider, redirectUriOrPath) {
+    const redirectUri = this.resolveRedirectUri(redirectUriOrPath);
+    const url = this.getAuthorizeUrl(provider, redirectUri);
+    if (typeof window !== "undefined") {
+      window.location.href = url;
+    }
+    return url;
+  }
+  /**
+   * OAuth başlatma URL'ini döner (redirect yapmaz).
+   * Tarayıcıda otomatik yönlendirme için `authorize()` kullanın.
    *
    * @param provider - Provider ID (google-analytics, facebook-business, vb.)
    * @param redirectUri - OAuth tamamlandıktan sonra dönülecek URL (opsiyonel)
@@ -1353,6 +1368,21 @@ var IntegrationsResource = class extends BaseResource {
     const params = redirectUri ? `?redirect_uri=${encodeURIComponent(redirectUri)}` : "";
     return `${baseUrl}${path}${params}`;
   }
+  resolveRedirectUri(redirectUriOrPath) {
+    if (redirectUriOrPath) {
+      if (redirectUriOrPath.startsWith("http://") || redirectUriOrPath.startsWith("https://")) {
+        return redirectUriOrPath;
+      }
+      if (typeof window !== "undefined") {
+        const path = redirectUriOrPath.startsWith("/") ? redirectUriOrPath : `/${redirectUriOrPath}`;
+        return `${window.location.origin}${path}`;
+      }
+    }
+    if (typeof window !== "undefined") {
+      return window.location.href;
+    }
+    return void 0;
+  }
   /**
    * Bağlantı durumunu sorgular
    */

package/dist/index.mjs

@@ -1277,9 +1277,24 @@ var IntegrationsResource = class extends BaseResource {
     super(httpClient);
   }
   /**
-   * OAuth başlatma URL'ini döner.
-   * Frontend bu URL'e yönlendirir (window.location.href = url).
-   * Cookie/Authorization ile backend'e gidilir, backend Google'a redirect eder.
+   * OAuth başlatır: URL üretir ve tarayıcıda yönlendirir.
+   * Kullanıcının URL oluşturup window.location atamasına gerek kalmaz.
+   *
+   * @param provider - Provider ID (google-analytics, facebook-business, vb.)
+   * @param redirectUriOrPath - Tam URL veya path (örn: '/admin/analytics'). Verilmezse mevcut sayfa kullanılır.
+   * @returns Oluşturulan URL (Node.js / Expo gibi ortamlarda manuel kullanım için)
+   */
+  authorize(provider, redirectUriOrPath) {
+    const redirectUri = this.resolveRedirectUri(redirectUriOrPath);
+    const url = this.getAuthorizeUrl(provider, redirectUri);
+    if (typeof window !== "undefined") {
+      window.location.href = url;
+    }
+    return url;
+  }
+  /**
+   * OAuth başlatma URL'ini döner (redirect yapmaz).
+   * Tarayıcıda otomatik yönlendirme için `authorize()` kullanın.
    *
    * @param provider - Provider ID (google-analytics, facebook-business, vb.)
    * @param redirectUri - OAuth tamamlandıktan sonra dönülecek URL (opsiyonel)
@@ -1290,6 +1305,21 @@ var IntegrationsResource = class extends BaseResource {
     const params = redirectUri ? `?redirect_uri=${encodeURIComponent(redirectUri)}` : "";
     return `${baseUrl}${path}${params}`;
   }
+  resolveRedirectUri(redirectUriOrPath) {
+    if (redirectUriOrPath) {
+      if (redirectUriOrPath.startsWith("http://") || redirectUriOrPath.startsWith("https://")) {
+        return redirectUriOrPath;
+      }
+      if (typeof window !== "undefined") {
+        const path = redirectUriOrPath.startsWith("/") ? redirectUriOrPath : `/${redirectUriOrPath}`;
+        return `${window.location.origin}${path}`;
+      }
+    }
+    if (typeof window !== "undefined") {
+      return window.location.href;
+    }
+    return void 0;
+  }
   /**
    * Bağlantı durumunu sorgular
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salefony/api-sdk",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Salefony API SDK - Official SDK for Salefony Backend API. Full TypeScript support, SSR-ready, Admin & Frontstore resources.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",