@vybit/oauth2-sdk 1.0.0

package/README.md

@@ -0,0 +1,137 @@
+# @vybit/oauth2-sdk
+
+OAuth 2.0 authentication SDK for Vybit.
+
+## Overview
+
+Complete OAuth2 implementation for Vybit authentication, including authorization URL generation, token exchange, and authenticated API calls.
+
+## Installation
+
+```bash
+npm install @vybit/oauth2-sdk
+```
+
+## Quick Start
+
+```typescript
+import { VybitOAuth2Client } from '@vybit/oauth2-sdk';
+
+// Create client with your OAuth2 credentials
+const client = new VybitOAuth2Client({
+  clientId: 'your-client-id',
+  clientSecret: 'your-client-secret',
+  redirectUri: 'https://yourapp.com/oauth/callback'
+});
+
+// Step 1: Generate authorization URL
+const authUrl = client.getAuthorizationUrl({
+  state: 'unique-state-value',
+  scope: 'read write'
+});
+
+// Redirect user to authUrl...
+
+// Step 2: Exchange authorization code for token
+const token = await client.exchangeCodeForToken('auth-code-from-callback');
+
+// Step 3: Make authenticated API calls
+const vybits = await client.getVybitList();
+await client.sendVybitNotification('trigger-key', {
+  message: 'Hello from your app!'
+});
+```
+
+## Environment Management
+
+The SDK always uses production Vybit endpoints:
+- **Authentication**: `https://app.vybit.net`
+- **API**: `https://vybit.net`
+
+For different environments (dev/staging/prod), create separate Vybit accounts with their own OAuth credentials rather than using different endpoints.
+
+## API Reference
+
+### VybitOAuth2Client
+
+#### Constructor
+```typescript
+new VybitOAuth2Client(config: OAuth2Config)
+```
+
+#### Methods
+
+**`getAuthorizationUrl(options?: AuthorizationUrlOptions): string`**
+- Generates OAuth2 authorization URL for user redirection
+- Returns complete URL including all required parameters
+
+**`exchangeCodeForToken(code: string): Promise<TokenResponse>`**
+- Exchanges authorization code for access token
+- Automatically stores token for subsequent API calls
+
+**`verifyToken(accessToken?: string): Promise<boolean>`**
+- Verifies if an access token is valid
+- Uses stored token if none provided
+
+**`getVybitList(accessToken?: string): Promise<Vybit[]>`**
+- Fetches user's vybit notifications
+- Requires valid access token
+
+**`sendVybitNotification(triggerKey: string, options?: TriggerOptions, accessToken?: string): Promise<TriggerResponse>`**
+- Triggers a vybit notification
+- Supports custom message, images, and links
+
+**`setAccessToken(token: string): void`**
+- Manually set access token
+
+**`getAccessToken(): string | undefined`**
+- Get currently stored access token
+
+## Error Handling
+
+```typescript
+import { VybitAuthError, VybitAPIError, VybitValidationError } from '@vybit/oauth2-sdk';
+
+try {
+  const token = await client.exchangeCodeForToken(code);
+} catch (error) {
+  if (error instanceof VybitAuthError) {
+    // Handle authentication errors
+  } else if (error instanceof VybitAPIError) {
+    // Handle API errors
+  } else if (error instanceof VybitValidationError) {
+    // Handle validation errors
+  }
+}
+```
+
+## TypeScript Support
+
+Full TypeScript support with comprehensive type definitions:
+
+```typescript
+interface OAuth2Config {
+  clientId: string;
+  clientSecret: string;
+  redirectUri: string;
+}
+
+interface TokenResponse {
+  access_token: string;
+  token_type: string;
+  expires_in?: number;
+  refresh_token?: string;
+  scope?: string;
+}
+
+interface TriggerOptions {
+  message?: string;
+  imageUrl?: string;
+  linkUrl?: string;
+  log?: string;
+}
+```
+
+## License
+
+MIT

package/dist/__tests__/oauth2-client.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * OAuth2 Client Tests
+ *
+ * These tests mirror the exact functionality tested in the developer portal,
+ * covering all 6 steps of the OAuth flow.
+ */
+export {};
+//# sourceMappingURL=oauth2-client.test.d.ts.map

package/dist/__tests__/oauth2-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth2-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/oauth2-client.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/oauth2-client.test.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * OAuth2 Client Tests
+ *
+ * These tests mirror the exact functionality tested in the developer portal,
+ * covering all 6 steps of the OAuth flow.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const oauth2_client_1 = require("../oauth2-client");
+const core_1 = require("@vybit/core");
+// Mock fetch globally
+const mockFetch = jest.fn();
+global.fetch = mockFetch;
+describe('VybitOAuth2Client', () => {
+    let client;
+    const validConfig = {
+        clientId: 'test-client-id',
+        clientSecret: 'test-client-secret',
+        redirectUri: 'https://example.com/callback'
+    };
+    beforeEach(() => {
+        client = new oauth2_client_1.VybitOAuth2Client(validConfig);
+        mockFetch.mockClear();
+    });
+    describe('Configuration Validation', () => {
+        it('should validate required configuration', () => {
+            expect(() => new oauth2_client_1.VybitOAuth2Client({
+                ...validConfig,
+                clientId: ''
+            })).toThrow(core_1.VybitValidationError);
+            expect(() => new oauth2_client_1.VybitOAuth2Client({
+                ...validConfig,
+                clientSecret: ''
+            })).toThrow(core_1.VybitValidationError);
+            expect(() => new oauth2_client_1.VybitOAuth2Client({
+                ...validConfig,
+                redirectUri: ''
+            })).toThrow(core_1.VybitValidationError);
+        });
+        it('should validate redirect URI format', () => {
+            expect(() => new oauth2_client_1.VybitOAuth2Client({
+                ...validConfig,
+                redirectUri: 'invalid-url'
+            })).toThrow(core_1.VybitValidationError);
+        });
+        it('should accept valid configuration', () => {
+            expect(() => new oauth2_client_1.VybitOAuth2Client(validConfig)).not.toThrow();
+        });
+    });
+    describe('Step 1: Authorization URL Generation', () => {
+        it('should generate correct authorization URL', () => {
+            const authUrl = client.getAuthorizationUrl();
+            expect(authUrl).toContain('https://app.vybit.net');
+            expect(authUrl).toContain('client_id=test-client-id');
+            expect(authUrl).toContain('redirect_uri=https%3A%2F%2Fexample.com%2Fcallback');
+            expect(authUrl).toContain('response_type=code');
+            expect(authUrl).toContain('state=');
+        });
+        it('should use custom state when provided', () => {
+            const customState = 'custom-state-123';
+            const authUrl = client.getAuthorizationUrl({ state: customState });
+            expect(authUrl).toContain(`state=${customState}`);
+        });
+        it('should include scope when provided', () => {
+            const authUrl = client.getAuthorizationUrl({ scope: 'read' });
+            expect(authUrl).toContain('scope=read');
+        });
+        it('should always use production domain', () => {
+            const authUrl = client.getAuthorizationUrl();
+            expect(authUrl).toContain('https://app.vybit.net');
+        });
+    });
+    describe('Step 3: Token Exchange', () => {
+        it('should successfully exchange code for token', async () => {
+            const mockTokenResponse = {
+                access_token: 'test-access-token',
+                token_type: 'Bearer'
+            };
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(mockTokenResponse)
+            });
+            const result = await client.exchangeCodeForToken('test-auth-code');
+            expect(result).toEqual(mockTokenResponse);
+            expect(client.getAccessToken()).toBe('test-access-token');
+            // Verify correct API call
+            expect(mockFetch).toHaveBeenCalledWith('https://app.vybit.net/service/token', expect.objectContaining({
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded'
+                },
+                body: expect.any(URLSearchParams)
+            }));
+        });
+        it('should handle token exchange errors', async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 400,
+                statusText: 'Bad Request'
+            });
+            await expect(client.exchangeCodeForToken('invalid-code')).rejects.toThrow(core_1.VybitAPIError);
+        });
+        it('should handle auth errors in response', async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ error: 'invalid_client' })
+            });
+            await expect(client.exchangeCodeForToken('test-code')).rejects.toThrow(core_1.VybitAuthError);
+        });
+    });
+    describe('Step 4: Token Verification', () => {
+        beforeEach(() => {
+            client.setAccessToken('test-token');
+        });
+        it('should verify valid token', async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ status: 'ok' })
+            });
+            const isValid = await client.verifyToken();
+            expect(isValid).toBe(true);
+            expect(mockFetch).toHaveBeenCalledWith('https://vybit.net/service/test', {
+                headers: {
+                    Authorization: 'Bearer test-token'
+                }
+            });
+        });
+        it('should handle invalid token', async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 401
+            });
+            const isValid = await client.verifyToken();
+            expect(isValid).toBe(false);
+        });
+        it('should handle network errors gracefully', async () => {
+            mockFetch.mockRejectedValueOnce(new Error('Network error'));
+            const isValid = await client.verifyToken();
+            expect(isValid).toBe(false);
+        });
+        it('should require access token', async () => {
+            const clientWithoutToken = new oauth2_client_1.VybitOAuth2Client(validConfig);
+            await expect(clientWithoutToken.verifyToken()).rejects.toThrow(core_1.VybitAuthError);
+        });
+    });
+    describe('Step 5: Get Vybit List', () => {
+        beforeEach(() => {
+            client.setAccessToken('test-token');
+        });
+        it('should fetch vybit list successfully', async () => {
+            const mockVybitResponse = {
+                '0': { name: 'My Alert', triggerKey: 'abc123def456' },
+                '1': { name: 'Notification Sound', triggerKey: 'def456ghi789' },
+                '2': { name: 'Status Update', triggerKey: 'ghi789jkl012' }
+            };
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(mockVybitResponse)
+            });
+            const vybits = await client.getVybitList();
+            expect(vybits).toHaveLength(3);
+            expect(vybits[0]).toEqual({ name: 'My Alert', triggerKey: 'abc123def456' });
+            expect(vybits[1]).toEqual({ name: 'Notification Sound', triggerKey: 'def456ghi789' });
+            expect(vybits[2]).toEqual({ name: 'Status Update', triggerKey: 'ghi789jkl012' });
+            expect(mockFetch).toHaveBeenCalledWith('https://vybit.net/rest/vybit_list', {
+                headers: {
+                    Authorization: 'Bearer test-token'
+                }
+            });
+        });
+        it('should handle API errors', async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 403,
+                statusText: 'Forbidden'
+            });
+            await expect(client.getVybitList()).rejects.toThrow(core_1.VybitAPIError);
+        });
+        it('should require access token', async () => {
+            const clientWithoutToken = new oauth2_client_1.VybitOAuth2Client(validConfig);
+            await expect(clientWithoutToken.getVybitList()).rejects.toThrow(core_1.VybitAuthError);
+        });
+    });
+    describe('Step 6: Send Vybit Notification', () => {
+        beforeEach(() => {
+            client.setAccessToken('test-token');
+        });
+        it('should send notification with all optional parameters', async () => {
+            const mockResponse = {
+                result: 1,
+                plk: 'bbxope6xhryminef'
+            };
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(mockResponse)
+            });
+            const triggerOptions = {
+                message: 'Test notification',
+                imageUrl: 'https://example.com/image.jpg',
+                linkUrl: 'https://example.com/redirect',
+                log: 'Test log entry <a href="https://example.com">link</a>'
+            };
+            const result = await client.sendVybitNotification('test-trigger-key', triggerOptions);
+            expect(result).toEqual(mockResponse);
+            // Verify the API call
+            const [url, options] = mockFetch.mock.calls[0];
+            expect(url).toBe('https://vybit.net/fire/test-trigger-key');
+            expect(options.method).toBe('POST');
+            expect(options.headers['Authorization']).toBe('Bearer test-token');
+            expect(options.headers['Content-Type']).toBe('application/json');
+            const body = JSON.parse(options.body);
+            expect(body).toEqual(triggerOptions);
+        });
+        it('should send notification with minimal parameters', async () => {
+            const mockResponse = { result: 1, plk: 'test-plk' };
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve(mockResponse)
+            });
+            const result = await client.sendVybitNotification('test-trigger-key');
+            expect(result).toEqual(mockResponse);
+            const body = JSON.parse(mockFetch.mock.calls[0][1].body);
+            expect(body).toEqual({});
+        });
+        it('should validate URL parameters', async () => {
+            await expect(client.sendVybitNotification('test-key', {
+                imageUrl: 'invalid-url'
+            })).rejects.toThrow(core_1.VybitValidationError);
+            await expect(client.sendVybitNotification('test-key', {
+                linkUrl: 'also-invalid'
+            })).rejects.toThrow(core_1.VybitValidationError);
+        });
+        it('should handle API errors', async () => {
+            mockFetch.mockResolvedValueOnce({
+                ok: false,
+                status: 404,
+                statusText: 'Not Found'
+            });
+            await expect(client.sendVybitNotification('invalid-key')).rejects.toThrow(core_1.VybitAPIError);
+        });
+        it('should require access token', async () => {
+            const clientWithoutToken = new oauth2_client_1.VybitOAuth2Client(validConfig);
+            await expect(clientWithoutToken.sendVybitNotification('test-key')).rejects.toThrow(core_1.VybitAuthError);
+        });
+    });
+    describe('Token Management', () => {
+        it('should set and get access token', () => {
+            expect(client.getAccessToken()).toBeUndefined();
+            client.setAccessToken('new-token');
+            expect(client.getAccessToken()).toBe('new-token');
+        });
+        it('should allow overriding token in API calls', async () => {
+            client.setAccessToken('default-token');
+            mockFetch.mockResolvedValueOnce({
+                ok: true,
+                json: () => Promise.resolve({ status: 'ok' })
+            });
+            await client.verifyToken('override-token');
+            expect(mockFetch).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({
+                headers: expect.objectContaining({
+                    Authorization: 'Bearer override-token'
+                })
+            }));
+        });
+    });
+});
+//# sourceMappingURL=oauth2-client.test.js.map

package/dist/__tests__/oauth2-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth2-client.test.js","sourceRoot":"","sources":["../../src/__tests__/oauth2-client.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './oauth2-client';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./oauth2-client"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,0CAAwB"}

package/dist/oauth2-client.d.ts

@@ -0,0 +1,88 @@
+import { Vybit } from '@vybit/core';
+import { OAuth2Config, TokenResponse, AuthorizationUrlOptions, TriggerOptions, TriggerResponse } from './types';
+/**
+ * OAuth2 client for Vybit authentication and API access
+ *
+ * This client handles the complete OAuth2 flow for Vybit authentication,
+ * including authorization URL generation, token exchange, and authenticated API calls.
+ *
+ * @example
+ * ```typescript
+ * const client = new VybitOAuth2Client({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ *   redirectUri: 'https://yourapp.com/oauth/callback'
+ * });
+ *
+ * // Generate authorization URL
+ * const authUrl = client.getAuthorizationUrl();
+ *
+ * // Exchange authorization code for token
+ * const token = await client.exchangeCodeForToken(authCode);
+ *
+ * // Make authenticated API calls
+ * const vybits = await client.getVybitList();
+ * ```
+ */
+export declare class VybitOAuth2Client {
+    private config;
+    private accessToken?;
+    /**
+     * Creates a new Vybit OAuth2 client
+     * @param config - OAuth2 configuration including client credentials and redirect URI
+     * @throws {VybitValidationError} When configuration is invalid
+     */
+    constructor(config: OAuth2Config);
+    private validateConfig;
+    /**
+     * Generates an OAuth2 authorization URL for user authentication
+     *
+     * Direct users to this URL to begin the OAuth2 authorization flow.
+     * After authorization, users will be redirected to your configured redirect URI
+     * with an authorization code.
+     *
+     * @param options - Optional parameters for the authorization URL
+     * @returns Complete authorization URL for user redirection
+     *
+     * @example
+     * ```typescript
+     * const authUrl = client.getAuthorizationUrl({
+     *   state: 'unique-state-value',
+     *   scope: 'read write'
+     * });
+     * // Redirect user to authUrl
+     * ```
+     */
+    getAuthorizationUrl(options?: AuthorizationUrlOptions): string;
+    /**
+     * Exchanges an authorization code for an access token
+     *
+     * Call this method with the authorization code received from the redirect URI
+     * after successful user authorization. The returned access token can be used
+     * for authenticated API calls.
+     *
+     * @param code - Authorization code from the OAuth2 callback
+     * @returns Promise resolving to token response with access token
+     * @throws {VybitAPIError} When token exchange fails
+     * @throws {VybitAuthError} When authorization is denied
+     *
+     * @example
+     * ```typescript
+     * // Handle OAuth2 callback
+     * const urlParams = new URLSearchParams(window.location.search);
+     * const code = urlParams.get('code');
+     *
+     * if (code) {
+     *   const token = await client.exchangeCodeForToken(code);
+     *   console.log('Access token:', token.access_token);
+     * }
+     * ```
+     */
+    exchangeCodeForToken(code: string): Promise<TokenResponse>;
+    verifyToken(accessToken?: string): Promise<boolean>;
+    getVybitList(accessToken?: string): Promise<Vybit[]>;
+    sendVybitNotification(triggerKey: string, options?: TriggerOptions, accessToken?: string): Promise<TriggerResponse>;
+    setAccessToken(token: string): void;
+    getAccessToken(): string | undefined;
+}
+//# sourceMappingURL=oauth2-client.d.ts.map

package/dist/oauth2-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth2-client.d.ts","sourceRoot":"","sources":["../src/oauth2-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,EACN,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAS;IAE7B;;;;OAIG;gBACS,MAAM,EAAE,YAAY;IAKhC,OAAO,CAAC,cAAc;IAetB;;;;;;;;;;;;;;;;;;OAkBG;IACH,mBAAmB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM;IAkBlE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2C1D,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BnD,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAmCpD,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAmB,EAC5B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC;IAkD3B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAInC,cAAc,IAAI,MAAM,GAAG,SAAS;CAGrC"}

package/dist/oauth2-client.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VybitOAuth2Client = void 0;
+const core_1 = require("@vybit/core");
+/**
+ * OAuth2 client for Vybit authentication and API access
+ *
+ * This client handles the complete OAuth2 flow for Vybit authentication,
+ * including authorization URL generation, token exchange, and authenticated API calls.
+ *
+ * @example
+ * ```typescript
+ * const client = new VybitOAuth2Client({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ *   redirectUri: 'https://yourapp.com/oauth/callback'
+ * });
+ *
+ * // Generate authorization URL
+ * const authUrl = client.getAuthorizationUrl();
+ *
+ * // Exchange authorization code for token
+ * const token = await client.exchangeCodeForToken(authCode);
+ *
+ * // Make authenticated API calls
+ * const vybits = await client.getVybitList();
+ * ```
+ */
+class VybitOAuth2Client {
+    /**
+     * Creates a new Vybit OAuth2 client
+     * @param config - OAuth2 configuration including client credentials and redirect URI
+     * @throws {VybitValidationError} When configuration is invalid
+     */
+    constructor(config) {
+        this.validateConfig(config);
+        this.config = config;
+    }
+    validateConfig(config) {
+        if (!config.clientId) {
+            throw new core_1.VybitValidationError('Client ID is required');
+        }
+        if (!config.clientSecret) {
+            throw new core_1.VybitValidationError('Client Secret is required');
+        }
+        if (!config.redirectUri) {
+            throw new core_1.VybitValidationError('Redirect URI is required');
+        }
+        if (!(0, core_1.isValidUrl)(config.redirectUri)) {
+            throw new core_1.VybitValidationError('Redirect URI must be a valid URL');
+        }
+    }
+    /**
+     * Generates an OAuth2 authorization URL for user authentication
+     *
+     * Direct users to this URL to begin the OAuth2 authorization flow.
+     * After authorization, users will be redirected to your configured redirect URI
+     * with an authorization code.
+     *
+     * @param options - Optional parameters for the authorization URL
+     * @returns Complete authorization URL for user redirection
+     *
+     * @example
+     * ```typescript
+     * const authUrl = client.getAuthorizationUrl({
+     *   state: 'unique-state-value',
+     *   scope: 'read write'
+     * });
+     * // Redirect user to authUrl
+     * ```
+     */
+    getAuthorizationUrl(options = {}) {
+        const state = options.state || (0, core_1.generateRandomState)();
+        const authDomain = (0, core_1.getAuthDomain)();
+        const params = new URLSearchParams({
+            client_id: this.config.clientId,
+            redirect_uri: this.config.redirectUri,
+            response_type: 'code',
+            state,
+        });
+        if (options.scope) {
+            params.append('scope', options.scope);
+        }
+        return `${authDomain}?${params.toString()}`;
+    }
+    /**
+     * Exchanges an authorization code for an access token
+     *
+     * Call this method with the authorization code received from the redirect URI
+     * after successful user authorization. The returned access token can be used
+     * for authenticated API calls.
+     *
+     * @param code - Authorization code from the OAuth2 callback
+     * @returns Promise resolving to token response with access token
+     * @throws {VybitAPIError} When token exchange fails
+     * @throws {VybitAuthError} When authorization is denied
+     *
+     * @example
+     * ```typescript
+     * // Handle OAuth2 callback
+     * const urlParams = new URLSearchParams(window.location.search);
+     * const code = urlParams.get('code');
+     *
+     * if (code) {
+     *   const token = await client.exchangeCodeForToken(code);
+     *   console.log('Access token:', token.access_token);
+     * }
+     * ```
+     */
+    async exchangeCodeForToken(code) {
+        const authDomain = (0, core_1.getAuthDomain)();
+        const tokenUrl = `${authDomain}/service/token`;
+        const formData = new URLSearchParams({
+            grant_type: 'authorization_code',
+            code,
+            client_id: this.config.clientId,
+            client_secret: this.config.clientSecret,
+        });
+        try {
+            const response = await fetch(tokenUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body: formData,
+            });
+            if (!response.ok) {
+                throw new core_1.VybitAPIError(`Token exchange failed: ${response.statusText}`, response.status);
+            }
+            const data = await response.json();
+            if (data.error) {
+                throw new core_1.VybitAuthError(`Token exchange error: ${data.error}`);
+            }
+            this.accessToken = data.access_token;
+            return data;
+        }
+        catch (error) {
+            if (error instanceof core_1.VybitAPIError || error instanceof core_1.VybitAuthError) {
+                throw error;
+            }
+            throw new core_1.VybitAPIError(`Network error during token exchange: ${error}`);
+        }
+    }
+    async verifyToken(accessToken) {
+        const token = accessToken || this.accessToken;
+        if (!token) {
+            throw new core_1.VybitAuthError('No access token available');
+        }
+        const baseUrl = (0, core_1.getDefaultBaseUrl)();
+        const verifyUrl = `${baseUrl}/service/test`;
+        try {
+            const response = await fetch(verifyUrl, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                },
+            });
+            if (!response.ok) {
+                return false;
+            }
+            const data = await response.json();
+            return data.status === 'ok';
+        }
+        catch {
+            return false;
+        }
+    }
+    async getVybitList(accessToken) {
+        const token = accessToken || this.accessToken;
+        if (!token) {
+            throw new core_1.VybitAuthError('No access token available');
+        }
+        const baseUrl = (0, core_1.getDefaultBaseUrl)();
+        const listUrl = `${baseUrl}/rest/vybit_list`;
+        try {
+            const response = await fetch(listUrl, {
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                },
+            });
+            if (!response.ok) {
+                throw new core_1.VybitAPIError(`Failed to fetch vybit list: ${response.statusText}`, response.status);
+            }
+            const data = await response.json();
+            // Convert object with numeric keys to array
+            return Object.values(data);
+        }
+        catch (error) {
+            if (error instanceof core_1.VybitAPIError) {
+                throw error;
+            }
+            throw new core_1.VybitAPIError(`Network error fetching vybit list: ${error}`);
+        }
+    }
+    async sendVybitNotification(triggerKey, options = {}, accessToken) {
+        const token = accessToken || this.accessToken;
+        if (!token) {
+            throw new core_1.VybitAuthError('No access token available');
+        }
+        // Validate URL parameters
+        if (options.imageUrl && !(0, core_1.isValidUrl)(options.imageUrl)) {
+            throw new core_1.VybitValidationError('Image URL must be a valid URL');
+        }
+        if (options.linkUrl && !(0, core_1.isValidUrl)(options.linkUrl)) {
+            throw new core_1.VybitValidationError('Link URL must be a valid URL');
+        }
+        const baseUrl = (0, core_1.getDefaultBaseUrl)();
+        const triggerUrl = `${baseUrl}/fire/${triggerKey}`;
+        // Build payload
+        const payload = {};
+        if (options.message)
+            payload.message = options.message;
+        if (options.imageUrl)
+            payload.imageUrl = options.imageUrl;
+        if (options.linkUrl)
+            payload.linkUrl = options.linkUrl;
+        if (options.log)
+            payload.log = options.log;
+        try {
+            const response = await fetch(triggerUrl, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                throw new core_1.VybitAPIError(`Failed to send vybit notification: ${response.statusText}`, response.status);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error instanceof core_1.VybitAPIError) {
+                throw error;
+            }
+            throw new core_1.VybitAPIError(`Network error sending notification: ${error}`);
+        }
+    }
+    setAccessToken(token) {
+        this.accessToken = token;
+    }
+    getAccessToken() {
+        return this.accessToken;
+    }
+}
+exports.VybitOAuth2Client = VybitOAuth2Client;
+//# sourceMappingURL=oauth2-client.js.map

package/dist/oauth2-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth2-client.js","sourceRoot":"","sources":["../src/oauth2-client.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * OAuth2 configuration for Vybit authentication
+ */
+export interface OAuth2Config {
+    /** OAuth2 client ID from your Vybit developer account */
+    clientId: string;
+    /** OAuth2 client secret from your Vybit developer account */
+    clientSecret: string;
+    /** Redirect URI that matches your Vybit app configuration */
+    redirectUri: string;
+}
+/**
+ * OAuth2 token response from successful authentication
+ */
+export interface TokenResponse {
+    /** Access token for authenticated API calls */
+    access_token: string;
+    /** Token type (typically "Bearer") */
+    token_type: string;
+    /** Token expiration time in seconds (optional) */
+    expires_in?: number;
+    /** Refresh token for token renewal (optional) */
+    refresh_token?: string;
+    /** Granted scopes for this token (optional) */
+    scope?: string;
+}
+/**
+ * Options for generating OAuth2 authorization URLs
+ */
+export interface AuthorizationUrlOptions {
+    /** Custom state parameter for security (auto-generated if not provided) */
+    state?: string;
+    /** Requested OAuth2 scopes (space-separated) */
+    scope?: string;
+}
+/**
+ * Options for triggering vybit notifications
+ */
+export interface TriggerOptions {
+    /** Custom message text for the notification */
+    message?: string;
+    /** URL to an image to display with the notification */
+    imageUrl?: string;
+    /** URL to open when the notification is clicked */
+    linkUrl?: string;
+    /** Custom log message for debugging */
+    log?: string;
+}
+/**
+ * Response from triggering a vybit notification
+ */
+export interface TriggerResponse {
+    /** Result code (0 = success) */
+    result: number;
+    /** Processing key for tracking the notification */
+    plk: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@vybit/oauth2-sdk",
+  "version": "1.0.0",
+  "description": "OAuth 2.0 SDK for Vybit authentication and authorization",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "test": "jest --config ../../jest.config.js --rootDir ../.."
+  },
+  "keywords": [
+    "vybit",
+    "oauth2",
+    "authentication",
+    "sdk"
+  ],
+  "author": "Vybit Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vybit/vybit-sdk.git",
+    "directory": "packages/oauth2"
+  },
+  "homepage": "https://github.com/vybit/vybit-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/vybit/vybit-sdk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@vybit/core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "node-fetch": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "node-fetch": {
+      "optional": true
+    }
+  }
+}