@idealyst/oauth-client 1.2.9 → 1.2.12

package/dist/index.d.mts

@@ -1,25 +1,45 @@
-interface OAuthConfig {
-    oauthUrl: string;
-    redirectUrl: string;
-    additionalParameters?: Record<string, string>;
-}
+/**
+ * Raw callback parameters from OAuth redirect
+ * Contains all query parameters returned by the OAuth provider
+ */
+type OAuthCallbackParams = Record<string, string | undefined>;
+/**
+ * Default OAuth result with standard code and state
+ */
 interface OAuthResult {
     code: string;
     state?: string;
 }
-interface OAuthClient {
-    authorize(): Promise<OAuthResult>;
+/**
+ * OAuth configuration options
+ */
+interface OAuthConfig<T = OAuthResult> {
+    oauthUrl: string;
+    redirectUrl: string;
+    additionalParameters?: Record<string, string>;
+    /**
+     * Optional transformer to convert raw callback params to desired type
+     * If not provided, returns all callback params as-is (typed as T)
+     */
+    transformCallback?: (params: OAuthCallbackParams) => T;
+}
+/**
+ * OAuth client interface with generic result type
+ * @template T - The type returned from authorize(), defaults to OAuthResult
+ */
+interface OAuthClient<T = OAuthResult> {
+    authorize(): Promise<T>;
 }
 
-declare class WebOAuthClient implements OAuthClient {
+declare class WebOAuthClient<T = OAuthResult> implements OAuthClient<T> {
     private config;
-    constructor(config: OAuthConfig);
-    authorize(): Promise<OAuthResult>;
+    constructor(config: OAuthConfig<T>);
+    authorize(): Promise<T>;
     private checkForCallback;
     private buildOAuthUrl;
     private generateState;
 }
 
-declare function createOAuthClient(config: OAuthConfig): OAuthClient;
+declare function createOAuthClient<T = OAuthResult>(config: OAuthConfig<T>): OAuthClient<T>;
 
-export { type OAuthClient, type OAuthConfig, type OAuthResult, WebOAuthClient, createOAuthClient };
+export { type OAuthCallbackParams, type OAuthClient, type OAuthConfig, type OAuthResult, WebOAuthClient, createOAuthClient };

package/dist/index.d.ts

@@ -1,25 +1,45 @@
-interface OAuthConfig {
-    oauthUrl: string;
-    redirectUrl: string;
-    additionalParameters?: Record<string, string>;
-}
+/**
+ * Raw callback parameters from OAuth redirect
+ * Contains all query parameters returned by the OAuth provider
+ */
+type OAuthCallbackParams = Record<string, string | undefined>;
+/**
+ * Default OAuth result with standard code and state
+ */
 interface OAuthResult {
     code: string;
     state?: string;
 }
-interface OAuthClient {
-    authorize(): Promise<OAuthResult>;
+/**
+ * OAuth configuration options
+ */
+interface OAuthConfig<T = OAuthResult> {
+    oauthUrl: string;
+    redirectUrl: string;
+    additionalParameters?: Record<string, string>;
+    /**
+     * Optional transformer to convert raw callback params to desired type
+     * If not provided, returns all callback params as-is (typed as T)
+     */
+    transformCallback?: (params: OAuthCallbackParams) => T;
+}
+/**
+ * OAuth client interface with generic result type
+ * @template T - The type returned from authorize(), defaults to OAuthResult
+ */
+interface OAuthClient<T = OAuthResult> {
+    authorize(): Promise<T>;
 }
 
-declare class WebOAuthClient implements OAuthClient {
+declare class WebOAuthClient<T = OAuthResult> implements OAuthClient<T> {
     private config;
-    constructor(config: OAuthConfig);
-    authorize(): Promise<OAuthResult>;
+    constructor(config: OAuthConfig<T>);
+    authorize(): Promise<T>;
     private checkForCallback;
     private buildOAuthUrl;
     private generateState;
 }
 
-declare function createOAuthClient(config: OAuthConfig): OAuthClient;
+declare function createOAuthClient<T = OAuthResult>(config: OAuthConfig<T>): OAuthClient<T>;
 
-export { type OAuthClient, type OAuthConfig, type OAuthResult, WebOAuthClient, createOAuthClient };
+export { type OAuthCallbackParams, type OAuthClient, type OAuthConfig, type OAuthResult, WebOAuthClient, createOAuthClient };

package/dist/index.js

@@ -32,19 +32,16 @@ var WebOAuthClient = class {
   }
   async authorize() {
     const state = this.generateState();
-    const callbackData = this.checkForCallback();
-    if (callbackData) {
-      const { code, error, returnedState } = callbackData;
-      if (error) {
-        throw new Error(`OAuth error: ${error}`);
+    const callbackParams = this.checkForCallback();
+    if (callbackParams) {
+      if (callbackParams.error) {
+        throw new Error(`OAuth error: ${callbackParams.error}`);
       }
-      if (code) {
-        window.history.replaceState({}, document.title, window.location.pathname);
-        return {
-          code,
-          state: returnedState || void 0
-        };
+      window.history.replaceState({}, document.title, window.location.pathname);
+      if (this.config.transformCallback) {
+        return this.config.transformCallback(callbackParams);
       }
+      return callbackParams;
     }
     const oauthUrl = this.buildOAuthUrl(state);
     window.location.href = oauthUrl;
@@ -52,17 +49,14 @@ var WebOAuthClient = class {
   }
   checkForCallback() {
     const urlParams = new URLSearchParams(window.location.search);
-    const code = urlParams.get("code");
-    const error = urlParams.get("error");
-    const state = urlParams.get("state");
-    if (code || error) {
-      return {
-        code: code || void 0,
-        error: error || void 0,
-        returnedState: state || void 0
-      };
+    const params = {};
+    urlParams.forEach((value, key) => {
+      params[key] = value;
+    });
+    if (Object.keys(params).length === 0) {
+      return null;
     }
-    return null;
+    return params;
   }
   buildOAuthUrl(state) {
     const url = new URL(this.config.oauthUrl);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/oauth-client.web.ts","../src/index.web.ts"],"sourcesContent":["export * from './index.web'","import type { OAuthClient, OAuthConfig, OAuthResult } from './types'\n\nexport class WebOAuthClient implements OAuthClient {\n  private config: OAuthConfig\n\n  constructor(config: OAuthConfig) {\n    this.config = config\n  }\n\n  async authorize(): Promise<OAuthResult> {\n    const state = this.generateState()\n\n    // Check if we're already in a callback\n    const callbackData = this.checkForCallback()\n    \n    if (callbackData) {\n      const { code, error, returnedState } = callbackData\n      \n      if (error) {\n        throw new Error(`OAuth error: ${error}`)\n      }\n\n      if (code) {\n        // Clean up URL\n        window.history.replaceState({}, document.title, window.location.pathname)\n        \n        return { \n          code,\n          state: returnedState || undefined\n        }\n      }\n    }\n\n    // Build OAuth URL and redirect\n    const oauthUrl = this.buildOAuthUrl(state)\n    window.location.href = oauthUrl\n    \n    // This won't be reached due to redirect\n    throw new Error('Authorization flow initiated')\n  }\n\n  private checkForCallback(): { code?: string; error?: string; returnedState?: string } | null {\n    const urlParams = new URLSearchParams(window.location.search)\n    const code = urlParams.get('code')\n    const error = urlParams.get('error')\n    const state = urlParams.get('state')\n    \n    if (code || error) {\n      return {\n        code: code || undefined,\n        error: error || undefined,\n        returnedState: state || undefined,\n      }\n    }\n    \n    return null\n  }\n\n  private buildOAuthUrl(state: string): string {\n    const url = new URL(this.config.oauthUrl)\n    \n    url.searchParams.set('redirect_uri', this.config.redirectUrl)\n    url.searchParams.set('state', state)\n\n    // Add additional parameters\n    if (this.config.additionalParameters) {\n      Object.entries(this.config.additionalParameters).forEach(([key, value]) => {\n        url.searchParams.set(key, value)\n      })\n    }\n\n    return url.toString()\n  }\n\n  private generateState(): string {\n    // Generate random state for CSRF protection\n    let result = ''\n    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~'\n    for (let i = 0; i < 32; i++) {\n      result += chars.charAt(Math.floor(Math.random() * chars.length))\n    }\n    return result\n  }\n}","export * from './types'\n\nimport type { OAuthConfig, OAuthClient } from './types'\nimport { WebOAuthClient } from './oauth-client.web'\n\nexport function createOAuthClient(config: OAuthConfig): OAuthClient {\n  return new WebOAuthClient(config)\n}\n\nexport { WebOAuthClient }"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,iBAAN,MAA4C;AAAA,EAGjD,YAAY,QAAqB;AAC/B,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAM,YAAkC;AACtC,UAAM,QAAQ,KAAK,cAAc;AAGjC,UAAM,eAAe,KAAK,iBAAiB;AAE3C,QAAI,cAAc;AAChB,YAAM,EAAE,MAAM,OAAO,cAAc,IAAI;AAEvC,UAAI,OAAO;AACT,cAAM,IAAI,MAAM,gBAAgB,KAAK,EAAE;AAAA,MACzC;AAEA,UAAI,MAAM;AAER,eAAO,QAAQ,aAAa,CAAC,GAAG,SAAS,OAAO,OAAO,SAAS,QAAQ;AAExE,eAAO;AAAA,UACL;AAAA,UACA,OAAO,iBAAiB;AAAA,QAC1B;AAAA,MACF;AAAA,IACF;AAGA,UAAM,WAAW,KAAK,cAAc,KAAK;AACzC,WAAO,SAAS,OAAO;AAGvB,UAAM,IAAI,MAAM,8BAA8B;AAAA,EAChD;AAAA,EAEQ,mBAAqF;AAC3F,UAAM,YAAY,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAC5D,UAAM,OAAO,UAAU,IAAI,MAAM;AACjC,UAAM,QAAQ,UAAU,IAAI,OAAO;AACnC,UAAM,QAAQ,UAAU,IAAI,OAAO;AAEnC,QAAI,QAAQ,OAAO;AACjB,aAAO;AAAA,QACL,MAAM,QAAQ;AAAA,QACd,OAAO,SAAS;AAAA,QAChB,eAAe,SAAS;AAAA,MAC1B;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,cAAc,OAAuB;AAC3C,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,QAAQ;AAExC,QAAI,aAAa,IAAI,gBAAgB,KAAK,OAAO,WAAW;AAC5D,QAAI,aAAa,IAAI,SAAS,KAAK;AAGnC,QAAI,KAAK,OAAO,sBAAsB;AACpC,aAAO,QAAQ,KAAK,OAAO,oBAAoB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACzE,YAAI,aAAa,IAAI,KAAK,KAAK;AAAA,MACjC,CAAC;AAAA,IACH;AAEA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEQ,gBAAwB;AAE9B,QAAI,SAAS;AACb,UAAM,QAAQ;AACd,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,gBAAU,MAAM,OAAO,KAAK,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,CAAC;AAAA,IACjE;AACA,WAAO;AAAA,EACT;AACF;;;AC9EO,SAAS,kBAAkB,QAAkC;AAClE,SAAO,IAAI,eAAe,MAAM;AAClC;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/oauth-client.web.ts","../src/index.web.ts"],"sourcesContent":["export * from './index.web'","import type { OAuthClient, OAuthConfig, OAuthResult, OAuthCallbackParams } from './types'\n\nexport class WebOAuthClient<T = OAuthResult> implements OAuthClient<T> {\n  private config: OAuthConfig<T>\n\n  constructor(config: OAuthConfig<T>) {\n    this.config = config\n  }\n\n  async authorize(): Promise<T> {\n    const state = this.generateState()\n\n    // Check if we're already in a callback\n    const callbackParams = this.checkForCallback()\n\n    if (callbackParams) {\n      if (callbackParams.error) {\n        throw new Error(`OAuth error: ${callbackParams.error}`)\n      }\n\n      // Clean up URL\n      window.history.replaceState({}, document.title, window.location.pathname)\n\n      // Transform callback params if transformer provided, otherwise return as-is\n      if (this.config.transformCallback) {\n        return this.config.transformCallback(callbackParams)\n      }\n\n      // Default behavior: return all callback params as T\n      return callbackParams as T\n    }\n\n    // Build OAuth URL and redirect\n    const oauthUrl = this.buildOAuthUrl(state)\n    window.location.href = oauthUrl\n\n    // This won't be reached due to redirect\n    throw new Error('Authorization flow initiated')\n  }\n\n  private checkForCallback(): OAuthCallbackParams | null {\n    const urlParams = new URLSearchParams(window.location.search)\n    const params: OAuthCallbackParams = {}\n\n    // Collect all query parameters\n    urlParams.forEach((value, key) => {\n      params[key] = value\n    })\n\n    // Return null if no parameters found\n    if (Object.keys(params).length === 0) {\n      return null\n    }\n\n    return params\n  }\n\n  private buildOAuthUrl(state: string): string {\n    const url = new URL(this.config.oauthUrl)\n    \n    url.searchParams.set('redirect_uri', this.config.redirectUrl)\n    url.searchParams.set('state', state)\n\n    // Add additional parameters\n    if (this.config.additionalParameters) {\n      Object.entries(this.config.additionalParameters).forEach(([key, value]) => {\n        url.searchParams.set(key, value)\n      })\n    }\n\n    return url.toString()\n  }\n\n  private generateState(): string {\n    // Generate random state for CSRF protection\n    let result = ''\n    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~'\n    for (let i = 0; i < 32; i++) {\n      result += chars.charAt(Math.floor(Math.random() * chars.length))\n    }\n    return result\n  }\n}","export * from './types'\n\nimport type { OAuthConfig, OAuthClient, OAuthResult } from './types'\nimport { WebOAuthClient } from './oauth-client.web'\n\nexport function createOAuthClient<T = OAuthResult>(config: OAuthConfig<T>): OAuthClient<T> {\n  return new WebOAuthClient<T>(config)\n}\n\nexport { WebOAuthClient }"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,iBAAN,MAAgE;AAAA,EAGrE,YAAY,QAAwB;AAClC,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAM,YAAwB;AAC5B,UAAM,QAAQ,KAAK,cAAc;AAGjC,UAAM,iBAAiB,KAAK,iBAAiB;AAE7C,QAAI,gBAAgB;AAClB,UAAI,eAAe,OAAO;AACxB,cAAM,IAAI,MAAM,gBAAgB,eAAe,KAAK,EAAE;AAAA,MACxD;AAGA,aAAO,QAAQ,aAAa,CAAC,GAAG,SAAS,OAAO,OAAO,SAAS,QAAQ;AAGxE,UAAI,KAAK,OAAO,mBAAmB;AACjC,eAAO,KAAK,OAAO,kBAAkB,cAAc;AAAA,MACrD;AAGA,aAAO;AAAA,IACT;AAGA,UAAM,WAAW,KAAK,cAAc,KAAK;AACzC,WAAO,SAAS,OAAO;AAGvB,UAAM,IAAI,MAAM,8BAA8B;AAAA,EAChD;AAAA,EAEQ,mBAA+C;AACrD,UAAM,YAAY,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAC5D,UAAM,SAA8B,CAAC;AAGrC,cAAU,QAAQ,CAAC,OAAO,QAAQ;AAChC,aAAO,GAAG,IAAI;AAAA,IAChB,CAAC;AAGD,QAAI,OAAO,KAAK,MAAM,EAAE,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,cAAc,OAAuB;AAC3C,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,QAAQ;AAExC,QAAI,aAAa,IAAI,gBAAgB,KAAK,OAAO,WAAW;AAC5D,QAAI,aAAa,IAAI,SAAS,KAAK;AAGnC,QAAI,KAAK,OAAO,sBAAsB;AACpC,aAAO,QAAQ,KAAK,OAAO,oBAAoB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACzE,YAAI,aAAa,IAAI,KAAK,KAAK;AAAA,MACjC,CAAC;AAAA,IACH;AAEA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEQ,gBAAwB;AAE9B,QAAI,SAAS;AACb,UAAM,QAAQ;AACd,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,gBAAU,MAAM,OAAO,KAAK,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,CAAC;AAAA,IACjE;AACA,WAAO;AAAA,EACT;AACF;;;AC7EO,SAAS,kBAAmC,QAAwC;AACzF,SAAO,IAAI,eAAkB,MAAM;AACrC;","names":[]}

package/dist/index.mjs

@@ -5,19 +5,16 @@ var WebOAuthClient = class {
   }
   async authorize() {
     const state = this.generateState();
-    const callbackData = this.checkForCallback();
-    if (callbackData) {
-      const { code, error, returnedState } = callbackData;
-      if (error) {
-        throw new Error(`OAuth error: ${error}`);
+    const callbackParams = this.checkForCallback();
+    if (callbackParams) {
+      if (callbackParams.error) {
+        throw new Error(`OAuth error: ${callbackParams.error}`);
       }
-      if (code) {
-        window.history.replaceState({}, document.title, window.location.pathname);
-        return {
-          code,
-          state: returnedState || void 0
-        };
+      window.history.replaceState({}, document.title, window.location.pathname);
+      if (this.config.transformCallback) {
+        return this.config.transformCallback(callbackParams);
       }
+      return callbackParams;
     }
     const oauthUrl = this.buildOAuthUrl(state);
     window.location.href = oauthUrl;
@@ -25,17 +22,14 @@ var WebOAuthClient = class {
   }
   checkForCallback() {
     const urlParams = new URLSearchParams(window.location.search);
-    const code = urlParams.get("code");
-    const error = urlParams.get("error");
-    const state = urlParams.get("state");
-    if (code || error) {
-      return {
-        code: code || void 0,
-        error: error || void 0,
-        returnedState: state || void 0
-      };
+    const params = {};
+    urlParams.forEach((value, key) => {
+      params[key] = value;
+    });
+    if (Object.keys(params).length === 0) {
+      return null;
     }
-    return null;
+    return params;
   }
   buildOAuthUrl(state) {
     const url = new URL(this.config.oauthUrl);

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/oauth-client.web.ts","../src/index.web.ts"],"sourcesContent":["import type { OAuthClient, OAuthConfig, OAuthResult } from './types'\n\nexport class WebOAuthClient implements OAuthClient {\n  private config: OAuthConfig\n\n  constructor(config: OAuthConfig) {\n    this.config = config\n  }\n\n  async authorize(): Promise<OAuthResult> {\n    const state = this.generateState()\n\n    // Check if we're already in a callback\n    const callbackData = this.checkForCallback()\n    \n    if (callbackData) {\n      const { code, error, returnedState } = callbackData\n      \n      if (error) {\n        throw new Error(`OAuth error: ${error}`)\n      }\n\n      if (code) {\n        // Clean up URL\n        window.history.replaceState({}, document.title, window.location.pathname)\n        \n        return { \n          code,\n          state: returnedState || undefined\n        }\n      }\n    }\n\n    // Build OAuth URL and redirect\n    const oauthUrl = this.buildOAuthUrl(state)\n    window.location.href = oauthUrl\n    \n    // This won't be reached due to redirect\n    throw new Error('Authorization flow initiated')\n  }\n\n  private checkForCallback(): { code?: string; error?: string; returnedState?: string } | null {\n    const urlParams = new URLSearchParams(window.location.search)\n    const code = urlParams.get('code')\n    const error = urlParams.get('error')\n    const state = urlParams.get('state')\n    \n    if (code || error) {\n      return {\n        code: code || undefined,\n        error: error || undefined,\n        returnedState: state || undefined,\n      }\n    }\n    \n    return null\n  }\n\n  private buildOAuthUrl(state: string): string {\n    const url = new URL(this.config.oauthUrl)\n    \n    url.searchParams.set('redirect_uri', this.config.redirectUrl)\n    url.searchParams.set('state', state)\n\n    // Add additional parameters\n    if (this.config.additionalParameters) {\n      Object.entries(this.config.additionalParameters).forEach(([key, value]) => {\n        url.searchParams.set(key, value)\n      })\n    }\n\n    return url.toString()\n  }\n\n  private generateState(): string {\n    // Generate random state for CSRF protection\n    let result = ''\n    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~'\n    for (let i = 0; i < 32; i++) {\n      result += chars.charAt(Math.floor(Math.random() * chars.length))\n    }\n    return result\n  }\n}","export * from './types'\n\nimport type { OAuthConfig, OAuthClient } from './types'\nimport { WebOAuthClient } from './oauth-client.web'\n\nexport function createOAuthClient(config: OAuthConfig): OAuthClient {\n  return new WebOAuthClient(config)\n}\n\nexport { WebOAuthClient }"],"mappings":";AAEO,IAAM,iBAAN,MAA4C;AAAA,EAGjD,YAAY,QAAqB;AAC/B,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAM,YAAkC;AACtC,UAAM,QAAQ,KAAK,cAAc;AAGjC,UAAM,eAAe,KAAK,iBAAiB;AAE3C,QAAI,cAAc;AAChB,YAAM,EAAE,MAAM,OAAO,cAAc,IAAI;AAEvC,UAAI,OAAO;AACT,cAAM,IAAI,MAAM,gBAAgB,KAAK,EAAE;AAAA,MACzC;AAEA,UAAI,MAAM;AAER,eAAO,QAAQ,aAAa,CAAC,GAAG,SAAS,OAAO,OAAO,SAAS,QAAQ;AAExE,eAAO;AAAA,UACL;AAAA,UACA,OAAO,iBAAiB;AAAA,QAC1B;AAAA,MACF;AAAA,IACF;AAGA,UAAM,WAAW,KAAK,cAAc,KAAK;AACzC,WAAO,SAAS,OAAO;AAGvB,UAAM,IAAI,MAAM,8BAA8B;AAAA,EAChD;AAAA,EAEQ,mBAAqF;AAC3F,UAAM,YAAY,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAC5D,UAAM,OAAO,UAAU,IAAI,MAAM;AACjC,UAAM,QAAQ,UAAU,IAAI,OAAO;AACnC,UAAM,QAAQ,UAAU,IAAI,OAAO;AAEnC,QAAI,QAAQ,OAAO;AACjB,aAAO;AAAA,QACL,MAAM,QAAQ;AAAA,QACd,OAAO,SAAS;AAAA,QAChB,eAAe,SAAS;AAAA,MAC1B;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,cAAc,OAAuB;AAC3C,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,QAAQ;AAExC,QAAI,aAAa,IAAI,gBAAgB,KAAK,OAAO,WAAW;AAC5D,QAAI,aAAa,IAAI,SAAS,KAAK;AAGnC,QAAI,KAAK,OAAO,sBAAsB;AACpC,aAAO,QAAQ,KAAK,OAAO,oBAAoB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACzE,YAAI,aAAa,IAAI,KAAK,KAAK;AAAA,MACjC,CAAC;AAAA,IACH;AAEA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEQ,gBAAwB;AAE9B,QAAI,SAAS;AACb,UAAM,QAAQ;AACd,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,gBAAU,MAAM,OAAO,KAAK,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,CAAC;AAAA,IACjE;AACA,WAAO;AAAA,EACT;AACF;;;AC9EO,SAAS,kBAAkB,QAAkC;AAClE,SAAO,IAAI,eAAe,MAAM;AAClC;","names":[]}
+{"version":3,"sources":["../src/oauth-client.web.ts","../src/index.web.ts"],"sourcesContent":["import type { OAuthClient, OAuthConfig, OAuthResult, OAuthCallbackParams } from './types'\n\nexport class WebOAuthClient<T = OAuthResult> implements OAuthClient<T> {\n  private config: OAuthConfig<T>\n\n  constructor(config: OAuthConfig<T>) {\n    this.config = config\n  }\n\n  async authorize(): Promise<T> {\n    const state = this.generateState()\n\n    // Check if we're already in a callback\n    const callbackParams = this.checkForCallback()\n\n    if (callbackParams) {\n      if (callbackParams.error) {\n        throw new Error(`OAuth error: ${callbackParams.error}`)\n      }\n\n      // Clean up URL\n      window.history.replaceState({}, document.title, window.location.pathname)\n\n      // Transform callback params if transformer provided, otherwise return as-is\n      if (this.config.transformCallback) {\n        return this.config.transformCallback(callbackParams)\n      }\n\n      // Default behavior: return all callback params as T\n      return callbackParams as T\n    }\n\n    // Build OAuth URL and redirect\n    const oauthUrl = this.buildOAuthUrl(state)\n    window.location.href = oauthUrl\n\n    // This won't be reached due to redirect\n    throw new Error('Authorization flow initiated')\n  }\n\n  private checkForCallback(): OAuthCallbackParams | null {\n    const urlParams = new URLSearchParams(window.location.search)\n    const params: OAuthCallbackParams = {}\n\n    // Collect all query parameters\n    urlParams.forEach((value, key) => {\n      params[key] = value\n    })\n\n    // Return null if no parameters found\n    if (Object.keys(params).length === 0) {\n      return null\n    }\n\n    return params\n  }\n\n  private buildOAuthUrl(state: string): string {\n    const url = new URL(this.config.oauthUrl)\n    \n    url.searchParams.set('redirect_uri', this.config.redirectUrl)\n    url.searchParams.set('state', state)\n\n    // Add additional parameters\n    if (this.config.additionalParameters) {\n      Object.entries(this.config.additionalParameters).forEach(([key, value]) => {\n        url.searchParams.set(key, value)\n      })\n    }\n\n    return url.toString()\n  }\n\n  private generateState(): string {\n    // Generate random state for CSRF protection\n    let result = ''\n    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~'\n    for (let i = 0; i < 32; i++) {\n      result += chars.charAt(Math.floor(Math.random() * chars.length))\n    }\n    return result\n  }\n}","export * from './types'\n\nimport type { OAuthConfig, OAuthClient, OAuthResult } from './types'\nimport { WebOAuthClient } from './oauth-client.web'\n\nexport function createOAuthClient<T = OAuthResult>(config: OAuthConfig<T>): OAuthClient<T> {\n  return new WebOAuthClient<T>(config)\n}\n\nexport { WebOAuthClient }"],"mappings":";AAEO,IAAM,iBAAN,MAAgE;AAAA,EAGrE,YAAY,QAAwB;AAClC,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAM,YAAwB;AAC5B,UAAM,QAAQ,KAAK,cAAc;AAGjC,UAAM,iBAAiB,KAAK,iBAAiB;AAE7C,QAAI,gBAAgB;AAClB,UAAI,eAAe,OAAO;AACxB,cAAM,IAAI,MAAM,gBAAgB,eAAe,KAAK,EAAE;AAAA,MACxD;AAGA,aAAO,QAAQ,aAAa,CAAC,GAAG,SAAS,OAAO,OAAO,SAAS,QAAQ;AAGxE,UAAI,KAAK,OAAO,mBAAmB;AACjC,eAAO,KAAK,OAAO,kBAAkB,cAAc;AAAA,MACrD;AAGA,aAAO;AAAA,IACT;AAGA,UAAM,WAAW,KAAK,cAAc,KAAK;AACzC,WAAO,SAAS,OAAO;AAGvB,UAAM,IAAI,MAAM,8BAA8B;AAAA,EAChD;AAAA,EAEQ,mBAA+C;AACrD,UAAM,YAAY,IAAI,gBAAgB,OAAO,SAAS,MAAM;AAC5D,UAAM,SAA8B,CAAC;AAGrC,cAAU,QAAQ,CAAC,OAAO,QAAQ;AAChC,aAAO,GAAG,IAAI;AAAA,IAChB,CAAC;AAGD,QAAI,OAAO,KAAK,MAAM,EAAE,WAAW,GAAG;AACpC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA,EAEQ,cAAc,OAAuB;AAC3C,UAAM,MAAM,IAAI,IAAI,KAAK,OAAO,QAAQ;AAExC,QAAI,aAAa,IAAI,gBAAgB,KAAK,OAAO,WAAW;AAC5D,QAAI,aAAa,IAAI,SAAS,KAAK;AAGnC,QAAI,KAAK,OAAO,sBAAsB;AACpC,aAAO,QAAQ,KAAK,OAAO,oBAAoB,EAAE,QAAQ,CAAC,CAAC,KAAK,KAAK,MAAM;AACzE,YAAI,aAAa,IAAI,KAAK,KAAK;AAAA,MACjC,CAAC;AAAA,IACH;AAEA,WAAO,IAAI,SAAS;AAAA,EACtB;AAAA,EAEQ,gBAAwB;AAE9B,QAAI,SAAS;AACb,UAAM,QAAQ;AACd,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,gBAAU,MAAM,OAAO,KAAK,MAAM,KAAK,OAAO,IAAI,MAAM,MAAM,CAAC;AAAA,IACjE;AACA,WAAO;AAAA,EACT;AACF;;;AC7EO,SAAS,kBAAmC,QAAwC;AACzF,SAAO,IAAI,eAAkB,MAAM;AACrC;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/oauth-client",
-  "version": "1.2.9",
+  "version": "1.2.12",
   "description": "Universal OAuth2 client for web and React Native",
   "main": "src/index.ts",
   "module": "src/index.ts",

package/src/index.native.ts

@@ -1,10 +1,10 @@
 export * from './types'
 
-import type { OAuthConfig, OAuthClient } from './types'
+import type { OAuthConfig, OAuthClient, OAuthResult } from './types'
 import { NativeOAuthClient } from './oauth-client.native'
 
-export function createOAuthClient(config: OAuthConfig): OAuthClient {
-  return new NativeOAuthClient(config)
+export function createOAuthClient<T = OAuthResult>(config: OAuthConfig<T>): OAuthClient<T> {
+  return new NativeOAuthClient<T>(config)
 }
 
 export { NativeOAuthClient }

package/src/index.web.ts

@@ -1,10 +1,10 @@
 export * from './types'
 
-import type { OAuthConfig, OAuthClient } from './types'
+import type { OAuthConfig, OAuthClient, OAuthResult } from './types'
 import { WebOAuthClient } from './oauth-client.web'
 
-export function createOAuthClient(config: OAuthConfig): OAuthClient {
-  return new WebOAuthClient(config)
+export function createOAuthClient<T = OAuthResult>(config: OAuthConfig<T>): OAuthClient<T> {
+  return new WebOAuthClient<T>(config)
 }
 
 export { WebOAuthClient }

package/src/oauth-client.native.ts

@@ -1,38 +1,37 @@
-import type { OAuthClient, OAuthConfig, OAuthResult } from './types'
+import type { OAuthClient, OAuthConfig, OAuthResult, OAuthCallbackParams } from './types'
 import { Linking } from 'react-native'
 
-export class NativeOAuthClient implements OAuthClient {
-  private config: OAuthConfig
+export class NativeOAuthClient<T = OAuthResult> implements OAuthClient<T> {
+  private config: OAuthConfig<T>
 
-  constructor(config: OAuthConfig) {
+  constructor(config: OAuthConfig<T>) {
     this.config = config
   }
 
-  async authorize(): Promise<OAuthResult> {
+  async authorize(): Promise<T> {
     const state = this.generateState()
     const oauthUrl = this.buildOAuthUrl(state)
-    
+
     // Open OAuth URL in system browser
     await Linking.openURL(oauthUrl)
-    
+
     // Wait for deep link callback
-    const callbackData = await this.waitForDeepLinkCallback()
-    
-    if (callbackData.error) {
-      throw new Error(`OAuth error: ${callbackData.error}`)
+    const callbackParams = await this.waitForDeepLinkCallback()
+
+    if (callbackParams.error) {
+      throw new Error(`OAuth error: ${callbackParams.error}`)
     }
-    
-    if (callbackData.code) {
-      return {
-        code: callbackData.code,
-        state: callbackData.state
-      }
+
+    // Transform callback params if transformer provided, otherwise return as-is
+    if (this.config.transformCallback) {
+      return this.config.transformCallback(callbackParams)
     }
-    
-    throw new Error('No authorization code received')
+
+    // Default behavior: return all callback params as T
+    return callbackParams as T
   }
 
-  private async waitForDeepLinkCallback(): Promise<{ code?: string; error?: string; state?: string }> {
+  private async waitForDeepLinkCallback(): Promise<OAuthCallbackParams> {
     return new Promise((resolve, reject) => {
       let subscription: any
       let timeoutId: NodeJS.Timeout | null = null
@@ -82,47 +81,39 @@ export class NativeOAuthClient implements OAuthClient {
     })
   }
 
-  private parseDeepLink(url: string): { code?: string; error?: string; state?: string } | null {
+  private parseDeepLink(url: string): OAuthCallbackParams | null {
     try {
       // Handle custom scheme URLs (e.g., com.myapp://oauth/callback?code=123)
       const parsedUrl = new URL(url)
-      
+
       // Check if this is our OAuth callback
       const expectedScheme = new URL(this.config.redirectUrl).protocol.slice(0, -1)
       if (parsedUrl.protocol.slice(0, -1) !== expectedScheme) {
         return null
       }
 
-      // For custom schemes, parameters are in the query string
-      const code = parsedUrl.searchParams.get('code')
-      const error = parsedUrl.searchParams.get('error')
-      const state = parsedUrl.searchParams.get('state')
+      // Collect all query parameters
+      const params: OAuthCallbackParams = {}
+
+      // Get all parameters from query string
+      parsedUrl.searchParams.forEach((value, key) => {
+        params[key] = value
+      })
 
       // Also check the hash fragment for parameters (some OAuth providers use this)
-      if (!code && !error && parsedUrl.hash) {
+      if (Object.keys(params).length === 0 && parsedUrl.hash) {
         const hashParams = new URLSearchParams(parsedUrl.hash.substring(1))
-        const hashCode = hashParams.get('code')
-        const hashError = hashParams.get('error')
-        const hashState = hashParams.get('state')
-        
-        if (hashCode || hashError) {
-          return {
-            code: hashCode || undefined,
-            error: hashError || undefined,
-            state: hashState || undefined
-          }
-        }
+        hashParams.forEach((value, key) => {
+          params[key] = value
+        })
       }
 
-      if (!code && !error) {
+      // Return null if no parameters found
+      if (Object.keys(params).length === 0) {
         return null
       }
 
-      return { 
-        code: code || undefined, 
-        error: error || undefined, 
-        state: state || undefined 
-      }
+      return params
     } catch (error) {
       console.warn('Failed to parse deep link URL:', url, error)
       return null

package/src/oauth-client.web.ts

@@ -1,59 +1,58 @@
-import type { OAuthClient, OAuthConfig, OAuthResult } from './types'
+import type { OAuthClient, OAuthConfig, OAuthResult, OAuthCallbackParams } from './types'
 
-export class WebOAuthClient implements OAuthClient {
-  private config: OAuthConfig
+export class WebOAuthClient<T = OAuthResult> implements OAuthClient<T> {
+  private config: OAuthConfig<T>
 
-  constructor(config: OAuthConfig) {
+  constructor(config: OAuthConfig<T>) {
     this.config = config
   }
 
-  async authorize(): Promise<OAuthResult> {
+  async authorize(): Promise<T> {
     const state = this.generateState()
 
     // Check if we're already in a callback
-    const callbackData = this.checkForCallback()
-    
-    if (callbackData) {
-      const { code, error, returnedState } = callbackData
-      
-      if (error) {
-        throw new Error(`OAuth error: ${error}`)
+    const callbackParams = this.checkForCallback()
+
+    if (callbackParams) {
+      if (callbackParams.error) {
+        throw new Error(`OAuth error: ${callbackParams.error}`)
       }
 
-      if (code) {
-        // Clean up URL
-        window.history.replaceState({}, document.title, window.location.pathname)
-        
-        return { 
-          code,
-          state: returnedState || undefined
-        }
+      // Clean up URL
+      window.history.replaceState({}, document.title, window.location.pathname)
+
+      // Transform callback params if transformer provided, otherwise return as-is
+      if (this.config.transformCallback) {
+        return this.config.transformCallback(callbackParams)
       }
+
+      // Default behavior: return all callback params as T
+      return callbackParams as T
     }
 
     // Build OAuth URL and redirect
     const oauthUrl = this.buildOAuthUrl(state)
     window.location.href = oauthUrl
-    
+
     // This won't be reached due to redirect
     throw new Error('Authorization flow initiated')
   }
 
-  private checkForCallback(): { code?: string; error?: string; returnedState?: string } | null {
+  private checkForCallback(): OAuthCallbackParams | null {
     const urlParams = new URLSearchParams(window.location.search)
-    const code = urlParams.get('code')
-    const error = urlParams.get('error')
-    const state = urlParams.get('state')
-    
-    if (code || error) {
-      return {
-        code: code || undefined,
-        error: error || undefined,
-        returnedState: state || undefined,
-      }
+    const params: OAuthCallbackParams = {}
+
+    // Collect all query parameters
+    urlParams.forEach((value, key) => {
+      params[key] = value
+    })
+
+    // Return null if no parameters found
+    if (Object.keys(params).length === 0) {
+      return null
     }
-    
-    return null
+
+    return params
   }
 
   private buildOAuthUrl(state: string): string {

package/src/types.ts

@@ -1,19 +1,41 @@
-export interface OAuthConfig {
+/**
+ * Raw callback parameters from OAuth redirect
+ * Contains all query parameters returned by the OAuth provider
+ */
+export type OAuthCallbackParams = Record<string, string | undefined>
+
+/**
+ * Default OAuth result with standard code and state
+ */
+export interface OAuthResult {
+  code: string
+  state?: string
+}
+
+/**
+ * OAuth configuration options
+ */
+export interface OAuthConfig<T = OAuthResult> {
   // OAuth endpoint URL (e.g., "https://api.yourapp.com/auth/google")
   oauthUrl: string
-  
+
   // Redirect URL for the client app (e.g., "com.yourapp://oauth/callback")
   redirectUrl: string
-  
+
   // Optional additional parameters to send to OAuth endpoint
   additionalParameters?: Record<string, string>
-}
 
-export interface OAuthResult {
-  code: string
-  state?: string
+  /**
+   * Optional transformer to convert raw callback params to desired type
+   * If not provided, returns all callback params as-is (typed as T)
+   */
+  transformCallback?: (params: OAuthCallbackParams) => T
 }
 
-export interface OAuthClient {
-  authorize(): Promise<OAuthResult>
+/**
+ * OAuth client interface with generic result type
+ * @template T - The type returned from authorize(), defaults to OAuthResult
+ */
+export interface OAuthClient<T = OAuthResult> {
+  authorize(): Promise<T>
 }