@quatrain/auth-github 1.2.10

package/README.md

@@ -0,0 +1,18 @@
+# @quatrain/auth-github
+
+Authentication adapter and pluggable endpoints for GitHub OAuth 2.0 Web Application Flow.
+
+## Installation
+
+This package is a workspace package within the Quatrain Core monorepo. It depends on `@quatrain/auth` and `@quatrain/api`.
+
+```bash
+yarn add @quatrain/auth-github
+```
+
+## Features
+
+- **OAuth 2.0 Flow**: Handles authorization URL generation and exchanging code for token.
+- **Pluggable API Router**: Framework-agnostic `GithubAuthApi` endpoint handler matching `ServerAdapter` specification.
+- **Deep Linking**: Supports generic redirect schemes for mobile contexts.
+- **GitHub API Utilities**: Methods to check repository existence and create new repositories.

package/dist/GithubAuthAdapter.d.ts

@@ -0,0 +1,34 @@
+import { AbstractOAuthAdapter } from '@quatrain/auth';
+/**
+ * Authentication adapter for GitHub OAuth 2.0 Web Application Flow.
+ * Handles profiles, repository existence checks, and repository creation.
+ */
+export declare class GithubAuthAdapter extends AbstractOAuthAdapter {
+    protected _authorizationEndpoint: string;
+    protected _tokenEndpoint: string;
+    protected _userProfileEndpoint: string;
+    /**
+     * Factory method to create a new instance from config credentials.
+     */
+    static factory(config: any): GithubAuthAdapter | null;
+    /**
+     * Returns the pluggable API routes builder.
+     */
+    getEndpointHandler(): any;
+    /**
+     * Returns user details from GitHub by validating the access token.
+     */
+    getAuthToken(accessToken: string): Promise<any>;
+    /**
+     * Custom GitHub API call to check repository existence.
+     */
+    checkRepositoryExists(accessToken: string, owner: string, name: string): Promise<boolean>;
+    /**
+     * Custom GitHub API call to create a repository.
+     */
+    createRepository(accessToken: string, name: string, options?: {
+        private?: boolean;
+        description?: string;
+        autoInit?: boolean;
+    }): Promise<any>;
+}

package/dist/GithubAuthAdapter.js

@@ -0,0 +1,136 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubAuthAdapter = void 0;
+const auth_1 = require("@quatrain/auth");
+const GithubAuthApi_1 = require("./GithubAuthApi");
+const nativeFetch = __importStar(require("node-fetch-native"));
+/**
+ * Authentication adapter for GitHub OAuth 2.0 Web Application Flow.
+ * Handles profiles, repository existence checks, and repository creation.
+ */
+class GithubAuthAdapter extends auth_1.AbstractOAuthAdapter {
+    constructor() {
+        super(...arguments);
+        this._authorizationEndpoint = 'https://github.com/login/oauth/authorize';
+        this._tokenEndpoint = 'https://github.com/login/oauth/access_token';
+        this._userProfileEndpoint = 'https://api.github.com/user';
+    }
+    /**
+     * Factory method to create a new instance from config credentials.
+     */
+    static factory(config) {
+        if (!config.clientId || !config.clientSecret)
+            return null;
+        return new GithubAuthAdapter({ config });
+    }
+    /**
+     * Returns the pluggable API routes builder.
+     */
+    getEndpointHandler() {
+        return GithubAuthApi_1.GithubAuthApi;
+    }
+    /**
+     * Returns user details from GitHub by validating the access token.
+     */
+    getAuthToken(accessToken) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield nativeFetch.fetch(this._userProfileEndpoint, {
+                headers: {
+                    'Authorization': `Bearer ${accessToken}`,
+                    'Accept': 'application/json',
+                    'User-Agent': 'Quatrain-Auth-Github'
+                }
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to fetch Github user profile: ${response.statusText}`);
+            }
+            return yield response.json();
+        });
+    }
+    /**
+     * Custom GitHub API call to check repository existence.
+     */
+    checkRepositoryExists(accessToken, owner, name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield nativeFetch.fetch(`https://api.github.com/repos/${owner}/${name}`, {
+                headers: {
+                    'Authorization': `Bearer ${accessToken}`,
+                    'Accept': 'application/json',
+                    'User-Agent': 'Quatrain-Auth-Github'
+                }
+            });
+            return response.status === 200;
+        });
+    }
+    /**
+     * Custom GitHub API call to create a repository.
+     */
+    createRepository(accessToken_1, name_1) {
+        return __awaiter(this, arguments, void 0, function* (accessToken, name, options = {}) {
+            const response = yield nativeFetch.fetch('https://api.github.com/user/repos', {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${accessToken}`,
+                    'Content-Type': 'application/json',
+                    'Accept': 'application/json',
+                    'User-Agent': 'Quatrain-Auth-Github'
+                },
+                body: JSON.stringify({
+                    name,
+                    private: options.private !== false,
+                    description: options.description || 'Dépôt créé automatiquement par Modaka',
+                    auto_init: options.autoInit !== false
+                })
+            });
+            if (!response.ok) {
+                const errData = yield response.json().catch(() => ({}));
+                throw new Error(`Failed to create repository: ${errData.message || response.statusText}`);
+            }
+            return yield response.json();
+        });
+    }
+}
+exports.GithubAuthAdapter = GithubAuthAdapter;
+//# sourceMappingURL=GithubAuthAdapter.js.map

package/dist/GithubAuthAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GithubAuthAdapter.js","sourceRoot":"","sources":["../src/GithubAuthAdapter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAAqD;AACrD,mDAA+C;AAC/C,+DAAgD;AAEhD;;;GAGG;AACH,MAAa,iBAAkB,SAAQ,2BAAoB;IAA3D;;QACa,2BAAsB,GAAG,0CAA0C,CAAA;QACnE,mBAAc,GAAG,6CAA6C,CAAA;QAC9D,yBAAoB,GAAG,6BAA6B,CAAA;IA6EjE,CAAC;IA3EE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAW;QACvB,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,YAAY;YAAE,OAAO,IAAI,CAAA;QACzD,OAAO,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACa,kBAAkB;QAC/B,OAAO,6BAAa,CAAA;IACvB,CAAC;IAED;;OAEG;IACG,YAAY,CAAC,WAAmB;;YACnC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE;gBACjE,OAAO,EAAE;oBACN,eAAe,EAAE,UAAU,WAAW,EAAE;oBACxC,QAAQ,EAAE,kBAAkB;oBAC5B,YAAY,EAAE,sBAAsB;iBACtC;aACH,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;YACjF,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC/B,CAAC;KAAA;IAED;;OAEG;IACG,qBAAqB,CAAC,WAAmB,EAAE,KAAa,EAAE,IAAY;;YACzE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,gCAAgC,KAAK,IAAI,IAAI,EAAE,EAAE;gBACvF,OAAO,EAAE;oBACN,eAAe,EAAE,UAAU,WAAW,EAAE;oBACxC,QAAQ,EAAE,kBAAkB;oBAC5B,YAAY,EAAE,sBAAsB;iBACtC;aACH,CAAC,CAAA;YACF,OAAO,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAA;QACjC,CAAC;KAAA;IAED;;OAEG;IACG,gBAAgB;6DAAC,WAAmB,EAAE,IAAY,EAAE,UAA2E,EAAE;YACpI,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,mCAAmC,EAAE;gBAC3E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACN,eAAe,EAAE,UAAU,WAAW,EAAE;oBACxC,cAAc,EAAE,kBAAkB;oBAClC,QAAQ,EAAE,kBAAkB;oBAC5B,YAAY,EAAE,sBAAsB;iBACtC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBAClB,IAAI;oBACJ,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,KAAK;oBAClC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,uCAAuC;oBAC3E,SAAS,EAAE,OAAO,CAAC,QAAQ,KAAK,KAAK;iBACvC,CAAC;aACJ,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBACvD,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;YAC5F,CAAC;YAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC/B,CAAC;KAAA;CACH;AAhFD,8CAgFC"}

package/dist/GithubAuthAdapter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/GithubAuthAdapter.test.js

@@ -0,0 +1,177 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const GithubAuthAdapter_1 = require("./GithubAuthAdapter");
+const nativeFetch = __importStar(require("node-fetch-native"));
+jest.mock('node-fetch-native');
+describe('GithubAuthAdapter', () => {
+    let adapter;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        adapter = new GithubAuthAdapter_1.GithubAuthAdapter({
+            config: {
+                clientId: 'test-client-id',
+                clientSecret: 'test-client-secret',
+            },
+        });
+    });
+    describe('factory()', () => {
+        it('should return null if clientId or clientSecret is missing', () => {
+            expect(GithubAuthAdapter_1.GithubAuthAdapter.factory({})).toBeNull();
+            expect(GithubAuthAdapter_1.GithubAuthAdapter.factory({ clientId: 'id' })).toBeNull();
+            expect(GithubAuthAdapter_1.GithubAuthAdapter.factory({ clientSecret: 'secret' })).toBeNull();
+        });
+        it('should return an instance if config is valid', () => {
+            const instance = GithubAuthAdapter_1.GithubAuthAdapter.factory({
+                clientId: 'id',
+                clientSecret: 'secret',
+            });
+            expect(instance).toBeInstanceOf(GithubAuthAdapter_1.GithubAuthAdapter);
+        });
+    });
+    describe('getAuthorizationUrl()', () => {
+        it('should return correct authorization URL', () => {
+            const url = adapter.getAuthorizationUrl('http://callback', ['repo', 'user'], 'state-123');
+            expect(url).toBe('https://github.com/login/oauth/authorize?client_id=test-client-id&scope=repo%20user&redirect_uri=http%3A%2F%2Fcallback&state=state-123');
+        });
+    });
+    describe('exchangeCodeForToken()', () => {
+        it('should exchange code for token successfully', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = {
+                ok: true,
+                json: jest.fn().mockResolvedValue({
+                    access_token: 'github-access-token-123',
+                    token_type: 'bearer',
+                    scope: 'repo',
+                }),
+            };
+            nativeFetch.fetch.mockResolvedValue(mockResponse);
+            const result = yield adapter.exchangeCodeForToken('code-123', 'http://callback');
+            expect(result.access_token).toBe('github-access-token-123');
+            expect(nativeFetch.fetch).toHaveBeenCalledWith('https://github.com/login/oauth/access_token', expect.objectContaining({
+                method: 'POST',
+                body: JSON.stringify({
+                    client_id: 'test-client-id',
+                    client_secret: 'test-client-secret',
+                    code: 'code-123',
+                    grant_type: 'authorization_code',
+                    redirect_uri: 'http://callback',
+                }),
+            }));
+        }));
+        it('should throw error on failed exchange request', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = {
+                ok: false,
+                statusText: 'Bad Request',
+            };
+            nativeFetch.fetch.mockResolvedValue(mockResponse);
+            yield expect(adapter.exchangeCodeForToken('code-123')).rejects.toThrow('OAuth token exchange failed: Bad Request');
+        }));
+    });
+    describe('getAuthToken()', () => {
+        it('should fetch and return user profile information', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = {
+                ok: true,
+                json: jest.fn().mockResolvedValue({
+                    id: 9999,
+                    login: 'octocat',
+                    name: 'The Octocat',
+                }),
+            };
+            nativeFetch.fetch.mockResolvedValue(mockResponse);
+            const result = yield adapter.getAuthToken('token-123');
+            expect(result.login).toBe('octocat');
+            expect(nativeFetch.fetch).toHaveBeenCalledWith('https://api.github.com/user', expect.objectContaining({
+                headers: {
+                    'Authorization': 'Bearer token-123',
+                    'Accept': 'application/json',
+                    'User-Agent': 'Quatrain-Auth-Github',
+                },
+            }));
+        }));
+    });
+    describe('checkRepositoryExists()', () => {
+        it('should return true if repo exists', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = { status: 200 };
+            nativeFetch.fetch.mockResolvedValue(mockResponse);
+            const exists = yield adapter.checkRepositoryExists('token-123', 'owner', 'repo');
+            expect(exists).toBe(true);
+            expect(nativeFetch.fetch).toHaveBeenCalledWith('https://api.github.com/repos/owner/repo', expect.any(Object));
+        }));
+        it('should return false if repo does not exist', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = { status: 404 };
+            nativeFetch.fetch.mockResolvedValue(mockResponse);
+            const exists = yield adapter.checkRepositoryExists('token-123', 'owner', 'repo');
+            expect(exists).toBe(false);
+        }));
+    });
+    describe('createRepository()', () => {
+        it('should call GitHub user repos endpoint to create a repo', () => __awaiter(void 0, void 0, void 0, function* () {
+            const mockResponse = {
+                ok: true,
+                json: jest.fn().mockResolvedValue({
+                    id: 123456,
+                    name: 'new-repo',
+                    full_name: 'octocat/new-repo',
+                }),
+            };
+            nativeFetch.fetch.mockResolvedValue(mockResponse);
+            const result = yield adapter.createRepository('token-123', 'new-repo', {
+                private: true,
+                description: 'My new repo',
+            });
+            expect(result.name).toBe('new-repo');
+            expect(nativeFetch.fetch).toHaveBeenCalledWith('https://api.github.com/user/repos', expect.objectContaining({
+                method: 'POST',
+                body: JSON.stringify({
+                    name: 'new-repo',
+                    private: true,
+                    description: 'My new repo',
+                    auto_init: true,
+                }),
+            }));
+        }));
+    });
+});
+//# sourceMappingURL=GithubAuthAdapter.test.js.map

package/dist/GithubAuthAdapter.test.js.map

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

package/dist/GithubAuthApi.d.ts

@@ -0,0 +1,6 @@
+import { ServerAdapter } from '@quatrain/api';
+/**
+ * Pluggable router endpoints for Github OAuth authentication.
+ * Compatible with any Quatrain ServerAdapter (Astro, Express, etc.).
+ */
+export declare function GithubAuthApi(router: ServerAdapter, path: string, options?: any): void;

package/dist/GithubAuthApi.js

@@ -0,0 +1,73 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubAuthApi = GithubAuthApi;
+const GithubAuthAdapter_1 = require("./GithubAuthAdapter");
+/**
+ * Pluggable router endpoints for Github OAuth authentication.
+ * Compatible with any Quatrain ServerAdapter (Astro, Express, etc.).
+ */
+function GithubAuthApi(router, path, options = {}) {
+    const adapter = options.adapter || GithubAuthAdapter_1.GithubAuthAdapter.factory(options.config || {});
+    if (!adapter) {
+        throw new Error('GithubAuthApi requires a valid GithubAuthAdapter or configuration.');
+    }
+    // Route: GET [root]/login
+    router.get('/login', (req, res) => __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const redirectUri = req.query.redirect_uri;
+        const scopes = (req.query.scopes || 'repo').split(',');
+        const state = req.query.state;
+        const authUrl = adapter.getAuthorizationUrl(redirectUri, scopes, state);
+        const wantsJson = req.query.json === 'true' || ((_b = (_a = req.headers) === null || _a === void 0 ? void 0 : _a.accept) === null || _b === void 0 ? void 0 : _b.includes('application/json'));
+        if (wantsJson) {
+            res.status(200).json({ url: authUrl });
+            return;
+        }
+        res.status(302).setHeader('Location', authUrl);
+        res.send(`Redirecting to GitHub...`);
+    }));
+    // Route: GET [root]/callback
+    router.get('/callback', (req, res) => __awaiter(this, void 0, void 0, function* () {
+        const code = req.query.code;
+        const redirectUri = req.query.redirect_uri;
+        const platform = req.query.platform;
+        if (!code) {
+            res.status(400).send('Missing authorization code.');
+            return;
+        }
+        try {
+            const tokenData = yield adapter.exchangeCodeForToken(code, redirectUri);
+            // Support standard deep link redirect for mobile context if an app scheme is configured
+            const appScheme = req.query.app_scheme || options.appScheme;
+            if (appScheme) {
+                const redirectUrl = `${appScheme}://auth/github/callback?token=${tokenData.access_token}`;
+                res.status(302).setHeader('Location', redirectUrl);
+                res.send(`Redirecting back to app...`);
+                return;
+            }
+            // Support standard redirect for web context if a target URI is configured
+            const webRedirectUri = req.query.web_redirect_uri || options.webRedirectUri;
+            if (webRedirectUri) {
+                const separator = webRedirectUri.includes('?') ? '&' : '?';
+                const redirectUrl = `${webRedirectUri}${separator}token=${tokenData.access_token}`;
+                res.status(302).setHeader('Location', redirectUrl);
+                res.send(`Redirecting...`);
+                return;
+            }
+            res.status(200).json(tokenData);
+        }
+        catch (err) {
+            res.status(500).send(`OAuth error: ${err.message}`);
+        }
+    }));
+}
+//# sourceMappingURL=GithubAuthApi.js.map

package/dist/GithubAuthApi.js.map

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

package/dist/GithubAuthApi.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/GithubAuthApi.test.js

@@ -0,0 +1,117 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const GithubAuthApi_1 = require("./GithubAuthApi");
+describe('GithubAuthApi', () => {
+    let mockRouter;
+    let mockAdapter;
+    let routes = {};
+    beforeEach(() => {
+        routes = {};
+        mockRouter = {
+            get: jest.fn().mockImplementation((path, handler) => {
+                routes[path] = handler;
+            }),
+        };
+        mockAdapter = {
+            getAuthorizationUrl: jest.fn().mockReturnValue('https://github.com/login/authorize'),
+            exchangeCodeForToken: jest.fn().mockResolvedValue({
+                access_token: 'token-abc',
+            }),
+        };
+    });
+    it('should register /login and /callback routes', () => {
+        (0, GithubAuthApi_1.GithubAuthApi)(mockRouter, '/api/auth/github', {
+            adapter: mockAdapter,
+        });
+        expect(mockRouter.get).toHaveBeenCalledWith('/login', expect.any(Function));
+        expect(mockRouter.get).toHaveBeenCalledWith('/callback', expect.any(Function));
+    });
+    it('should handle /login route redirect', () => __awaiter(void 0, void 0, void 0, function* () {
+        (0, GithubAuthApi_1.GithubAuthApi)(mockRouter, '/api/auth/github', {
+            adapter: mockAdapter,
+        });
+        const req = {
+            query: {
+                redirect_uri: 'http://my-callback',
+                scopes: 'repo,user',
+                state: 'mystate',
+            },
+        };
+        const res = {
+            status: jest.fn().mockReturnThis(),
+            setHeader: jest.fn().mockReturnThis(),
+            send: jest.fn(),
+        };
+        yield routes['/login'](req, res);
+        expect(mockAdapter.getAuthorizationUrl).toHaveBeenCalledWith('http://my-callback', ['repo', 'user'], 'mystate');
+        expect(res.status).toHaveBeenCalledWith(302);
+        expect(res.setHeader).toHaveBeenCalledWith('Location', 'https://github.com/login/authorize');
+    }));
+    it('should handle /callback route token exchange', () => __awaiter(void 0, void 0, void 0, function* () {
+        (0, GithubAuthApi_1.GithubAuthApi)(mockRouter, '/api/auth/github', {
+            adapter: mockAdapter,
+        });
+        const req = {
+            query: {
+                code: 'code-123',
+                redirect_uri: 'http://my-callback',
+            },
+        };
+        const res = {
+            status: jest.fn().mockReturnThis(),
+            json: jest.fn(),
+        };
+        yield routes['/callback'](req, res);
+        expect(mockAdapter.exchangeCodeForToken).toHaveBeenCalledWith('code-123', 'http://my-callback');
+        expect(res.status).toHaveBeenCalledWith(200);
+        expect(res.json).toHaveBeenCalledWith({ access_token: 'token-abc' });
+    }));
+    it('should redirect to deep link for mobile platform', () => __awaiter(void 0, void 0, void 0, function* () {
+        (0, GithubAuthApi_1.GithubAuthApi)(mockRouter, '/api/auth/github', {
+            adapter: mockAdapter,
+            appScheme: 'myapp',
+        });
+        const req = {
+            query: {
+                code: 'code-123',
+            },
+        };
+        const res = {
+            status: jest.fn().mockReturnThis(),
+            setHeader: jest.fn().mockReturnThis(),
+            send: jest.fn(),
+        };
+        yield routes['/callback'](req, res);
+        expect(res.status).toHaveBeenCalledWith(302);
+        expect(res.setHeader).toHaveBeenCalledWith('Location', 'myapp://auth/github/callback?token=token-abc');
+    }));
+    it('should redirect to web URL if webRedirectUri is configured', () => __awaiter(void 0, void 0, void 0, function* () {
+        (0, GithubAuthApi_1.GithubAuthApi)(mockRouter, '/api/auth/github', {
+            adapter: mockAdapter,
+            webRedirectUri: 'http://localhost:3000/settings?tab=sync',
+        });
+        const req = {
+            query: {
+                code: 'code-123',
+            },
+        };
+        const res = {
+            status: jest.fn().mockReturnThis(),
+            setHeader: jest.fn().mockReturnThis(),
+            send: jest.fn(),
+        };
+        yield routes['/callback'](req, res);
+        expect(res.status).toHaveBeenCalledWith(302);
+        expect(res.setHeader).toHaveBeenCalledWith('Location', 'http://localhost:3000/settings?tab=sync&token=token-abc');
+    }));
+});
+//# sourceMappingURL=GithubAuthApi.test.js.map

package/dist/GithubAuthApi.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './GithubAuthAdapter';
+export * from './GithubAuthApi';

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("./GithubAuthAdapter"), exports);
+__exportStar(require("./GithubAuthApi"), 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,sDAAmC;AACnC,kDAA+B"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@quatrain/auth-github",
+  "version": "1.2.10",
+  "license": "AGPL-3.0-only",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bun": "src/index.ts",
+  "files": [
+    "LICENSE.md",
+    "src/",
+    "dist/",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Quatrain/Core.git",
+    "directory": "packages/auth-github"
+  },
+  "author": "Quatrain Développement SAS <developers@quatrain.com>",
+  "dependencies": {
+    "@quatrain/api": "^1.1.7",
+    "@quatrain/auth": "^1.2.10",
+    "@quatrain/backend": "^1.2.17",
+    "node-fetch-native": "^1.6.4"
+  },
+  "devDependencies": {
+    "@tsconfig/recommended": "^1.0.1",
+    "@types/node": "^22.10.1",
+    "typescript": "^5.2.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "wbuild": "tsc --watch",
+    "bump-to": "yarn version"
+  }
+}

package/src/GithubAuthAdapter.test.ts

@@ -0,0 +1,172 @@
+import { GithubAuthAdapter } from './GithubAuthAdapter'
+import * as nativeFetch from 'node-fetch-native'
+
+jest.mock('node-fetch-native')
+
+describe('GithubAuthAdapter', () => {
+   let adapter: GithubAuthAdapter
+
+   beforeEach(() => {
+      jest.clearAllMocks()
+
+      adapter = new GithubAuthAdapter({
+         config: {
+            clientId: 'test-client-id',
+            clientSecret: 'test-client-secret',
+         },
+      })
+   })
+
+   describe('factory()', () => {
+      it('should return null if clientId or clientSecret is missing', () => {
+         expect(GithubAuthAdapter.factory({})).toBeNull()
+         expect(GithubAuthAdapter.factory({ clientId: 'id' })).toBeNull()
+         expect(GithubAuthAdapter.factory({ clientSecret: 'secret' })).toBeNull()
+      })
+
+      it('should return an instance if config is valid', () => {
+         const instance = GithubAuthAdapter.factory({
+            clientId: 'id',
+            clientSecret: 'secret',
+         })
+         expect(instance).toBeInstanceOf(GithubAuthAdapter)
+      })
+   })
+
+   describe('getAuthorizationUrl()', () => {
+      it('should return correct authorization URL', () => {
+         const url = adapter.getAuthorizationUrl(
+            'http://callback',
+            ['repo', 'user'],
+            'state-123'
+         )
+         expect(url).toBe(
+            'https://github.com/login/oauth/authorize?client_id=test-client-id&scope=repo%20user&redirect_uri=http%3A%2F%2Fcallback&state=state-123'
+         )
+      })
+   })
+
+   describe('exchangeCodeForToken()', () => {
+      it('should exchange code for token successfully', async () => {
+         const mockResponse = {
+            ok: true,
+            json: jest.fn().mockResolvedValue({
+               access_token: 'github-access-token-123',
+               token_type: 'bearer',
+               scope: 'repo',
+            }),
+         }
+         ;(nativeFetch.fetch as jest.Mock).mockResolvedValue(mockResponse)
+
+         const result = await adapter.exchangeCodeForToken('code-123', 'http://callback')
+         expect(result.access_token).toBe('github-access-token-123')
+         expect(nativeFetch.fetch).toHaveBeenCalledWith(
+            'https://github.com/login/oauth/access_token',
+            expect.objectContaining({
+               method: 'POST',
+               body: JSON.stringify({
+                  client_id: 'test-client-id',
+                  client_secret: 'test-client-secret',
+                  code: 'code-123',
+                  grant_type: 'authorization_code',
+                  redirect_uri: 'http://callback',
+               }),
+            })
+         )
+      })
+
+      it('should throw error on failed exchange request', async () => {
+         const mockResponse = {
+            ok: false,
+            statusText: 'Bad Request',
+         }
+         ;(nativeFetch.fetch as jest.Mock).mockResolvedValue(mockResponse)
+
+         await expect(
+            adapter.exchangeCodeForToken('code-123')
+         ).rejects.toThrow('OAuth token exchange failed: Bad Request')
+      })
+   })
+
+   describe('getAuthToken()', () => {
+      it('should fetch and return user profile information', async () => {
+         const mockResponse = {
+            ok: true,
+            json: jest.fn().mockResolvedValue({
+               id: 9999,
+               login: 'octocat',
+               name: 'The Octocat',
+            }),
+         }
+         ;(nativeFetch.fetch as jest.Mock).mockResolvedValue(mockResponse)
+
+         const result = await adapter.getAuthToken('token-123')
+         expect(result.login).toBe('octocat')
+         expect(nativeFetch.fetch).toHaveBeenCalledWith(
+            'https://api.github.com/user',
+            expect.objectContaining({
+               headers: {
+                  'Authorization': 'Bearer token-123',
+                  'Accept': 'application/json',
+                  'User-Agent': 'Quatrain-Auth-Github',
+               },
+            })
+         )
+      })
+   })
+
+   describe('checkRepositoryExists()', () => {
+      it('should return true if repo exists', async () => {
+         const mockResponse = { status: 200 }
+         ;(nativeFetch.fetch as jest.Mock).mockResolvedValue(mockResponse)
+
+         const exists = await adapter.checkRepositoryExists('token-123', 'owner', 'repo')
+         expect(exists).toBe(true)
+         expect(nativeFetch.fetch).toHaveBeenCalledWith(
+            'https://api.github.com/repos/owner/repo',
+            expect.any(Object)
+         )
+      })
+
+      it('should return false if repo does not exist', async () => {
+         const mockResponse = { status: 404 }
+         ;(nativeFetch.fetch as jest.Mock).mockResolvedValue(mockResponse)
+
+         const exists = await adapter.checkRepositoryExists('token-123', 'owner', 'repo')
+         expect(exists).toBe(false)
+      })
+   })
+
+   describe('createRepository()', () => {
+      it('should call GitHub user repos endpoint to create a repo', async () => {
+         const mockResponse = {
+            ok: true,
+            json: jest.fn().mockResolvedValue({
+               id: 123456,
+               name: 'new-repo',
+               full_name: 'octocat/new-repo',
+            }),
+         }
+         ;(nativeFetch.fetch as jest.Mock).mockResolvedValue(mockResponse)
+
+         const result = await adapter.createRepository('token-123', 'new-repo', {
+            private: true,
+            description: 'My new repo',
+         })
+
+         expect(result.name).toBe('new-repo')
+         expect(nativeFetch.fetch).toHaveBeenCalledWith(
+            'https://api.github.com/user/repos',
+            expect.objectContaining({
+               method: 'POST',
+               body: JSON.stringify({
+                  name: 'new-repo',
+                  private: true,
+                  description: 'My new repo',
+                  auto_init: true,
+               }),
+            })
+         )
+      })
+   })
+})

package/src/GithubAuthAdapter.ts

@@ -0,0 +1,89 @@
+import { AbstractOAuthAdapter } from '@quatrain/auth'
+import { GithubAuthApi } from './GithubAuthApi'
+import * as nativeFetch from 'node-fetch-native'
+
+/**
+ * Authentication adapter for GitHub OAuth 2.0 Web Application Flow.
+ * Handles profiles, repository existence checks, and repository creation.
+ */
+export class GithubAuthAdapter extends AbstractOAuthAdapter {
+   protected _authorizationEndpoint = 'https://github.com/login/oauth/authorize'
+   protected _tokenEndpoint = 'https://github.com/login/oauth/access_token'
+   protected _userProfileEndpoint = 'https://api.github.com/user'
+
+   /**
+    * Factory method to create a new instance from config credentials.
+    */
+   static factory(config: any): GithubAuthAdapter | null {
+      if (!config.clientId || !config.clientSecret) return null
+      return new GithubAuthAdapter({ config })
+   }
+
+   /**
+    * Returns the pluggable API routes builder.
+    */
+   public override getEndpointHandler(): any {
+      return GithubAuthApi
+   }
+
+   /**
+    * Returns user details from GitHub by validating the access token.
+    */
+   async getAuthToken(accessToken: string): Promise<any> {
+      const response = await nativeFetch.fetch(this._userProfileEndpoint, {
+         headers: {
+            'Authorization': `Bearer ${accessToken}`,
+            'Accept': 'application/json',
+            'User-Agent': 'Quatrain-Auth-Github'
+         }
+      })
+
+      if (!response.ok) {
+         throw new Error(`Failed to fetch Github user profile: ${response.statusText}`)
+      }
+
+      return await response.json()
+   }
+
+   /**
+    * Custom GitHub API call to check repository existence.
+    */
+   async checkRepositoryExists(accessToken: string, owner: string, name: string): Promise<boolean> {
+      const response = await nativeFetch.fetch(`https://api.github.com/repos/${owner}/${name}`, {
+         headers: {
+            'Authorization': `Bearer ${accessToken}`,
+            'Accept': 'application/json',
+            'User-Agent': 'Quatrain-Auth-Github'
+         }
+      })
+      return response.status === 200
+   }
+
+   /**
+    * Custom GitHub API call to create a repository.
+    */
+   async createRepository(accessToken: string, name: string, options: { private?: boolean; description?: string; autoInit?: boolean } = {}): Promise<any> {
+      const response = await nativeFetch.fetch('https://api.github.com/user/repos', {
+         method: 'POST',
+         headers: {
+            'Authorization': `Bearer ${accessToken}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+            'User-Agent': 'Quatrain-Auth-Github'
+         },
+         body: JSON.stringify({
+            name,
+            private: options.private !== false,
+            description: options.description || 'Dépôt créé automatiquement par Modaka',
+            auto_init: options.autoInit !== false
+         })
+      })
+
+      if (!response.ok) {
+         const errData = await response.json().catch(() => ({}))
+         throw new Error(`Failed to create repository: ${errData.message || response.statusText}`)
+      }
+
+      return await response.json()
+   }
+}

package/src/GithubAuthApi.test.ts

@@ -0,0 +1,142 @@
+import { GithubAuthApi } from './GithubAuthApi'
+import { ServerAdapter, ApiRequest, ApiResponse } from '@quatrain/api'
+import { GithubAuthAdapter } from './GithubAuthAdapter'
+
+describe('GithubAuthApi', () => {
+   let mockRouter: any
+   let mockAdapter: any
+   let routes: Record<string, Function> = {}
+
+   beforeEach(() => {
+      routes = {}
+      mockRouter = {
+         get: jest.fn().mockImplementation((path: string, handler: Function) => {
+            routes[path] = handler
+         }),
+      }
+
+      mockAdapter = {
+         getAuthorizationUrl: jest.fn().mockReturnValue('https://github.com/login/authorize'),
+         exchangeCodeForToken: jest.fn().mockResolvedValue({
+            access_token: 'token-abc',
+         }),
+      }
+   })
+
+   it('should register /login and /callback routes', () => {
+      GithubAuthApi(mockRouter as unknown as ServerAdapter, '/api/auth/github', {
+         adapter: mockAdapter,
+      })
+
+      expect(mockRouter.get).toHaveBeenCalledWith('/login', expect.any(Function))
+      expect(mockRouter.get).toHaveBeenCalledWith('/callback', expect.any(Function))
+   })
+
+   it('should handle /login route redirect', async () => {
+      GithubAuthApi(mockRouter as unknown as ServerAdapter, '/api/auth/github', {
+         adapter: mockAdapter,
+      })
+
+      const req = {
+         query: {
+            redirect_uri: 'http://my-callback',
+            scopes: 'repo,user',
+            state: 'mystate',
+         },
+      } as unknown as ApiRequest
+
+      const res = {
+         status: jest.fn().mockReturnThis(),
+         setHeader: jest.fn().mockReturnThis(),
+         send: jest.fn(),
+      } as unknown as ApiResponse
+
+      await routes['/login'](req, res)
+
+      expect(mockAdapter.getAuthorizationUrl).toHaveBeenCalledWith(
+         'http://my-callback',
+         ['repo', 'user'],
+         'mystate'
+      )
+      expect(res.status).toHaveBeenCalledWith(302)
+      expect(res.setHeader).toHaveBeenCalledWith('Location', 'https://github.com/login/authorize')
+   })
+
+   it('should handle /callback route token exchange', async () => {
+      GithubAuthApi(mockRouter as unknown as ServerAdapter, '/api/auth/github', {
+         adapter: mockAdapter,
+      })
+
+      const req = {
+         query: {
+            code: 'code-123',
+            redirect_uri: 'http://my-callback',
+         },
+      } as unknown as ApiRequest
+
+      const res = {
+         status: jest.fn().mockReturnThis(),
+         json: jest.fn(),
+      } as unknown as ApiResponse
+
+      await routes['/callback'](req, res)
+
+      expect(mockAdapter.exchangeCodeForToken).toHaveBeenCalledWith('code-123', 'http://my-callback')
+      expect(res.status).toHaveBeenCalledWith(200)
+      expect(res.json).toHaveBeenCalledWith({ access_token: 'token-abc' })
+   })
+
+    it('should redirect to deep link for mobile platform', async () => {
+       GithubAuthApi(mockRouter as unknown as ServerAdapter, '/api/auth/github', {
+          adapter: mockAdapter,
+          appScheme: 'myapp',
+       })
+
+       const req = {
+          query: {
+             code: 'code-123',
+          },
+       } as unknown as ApiRequest
+
+       const res = {
+          status: jest.fn().mockReturnThis(),
+          setHeader: jest.fn().mockReturnThis(),
+          send: jest.fn(),
+       } as unknown as ApiResponse
+
+       await routes['/callback'](req, res)
+
+       expect(res.status).toHaveBeenCalledWith(302)
+       expect(res.setHeader).toHaveBeenCalledWith(
+          'Location',
+          'myapp://auth/github/callback?token=token-abc'
+       )
+    })
+
+    it('should redirect to web URL if webRedirectUri is configured', async () => {
+       GithubAuthApi(mockRouter as unknown as ServerAdapter, '/api/auth/github', {
+          adapter: mockAdapter,
+          webRedirectUri: 'http://localhost:3000/settings?tab=sync',
+       })
+
+       const req = {
+          query: {
+             code: 'code-123',
+          },
+       } as unknown as ApiRequest
+
+       const res = {
+          status: jest.fn().mockReturnThis(),
+          setHeader: jest.fn().mockReturnThis(),
+          send: jest.fn(),
+       } as unknown as ApiResponse
+
+       await routes['/callback'](req, res)
+
+       expect(res.status).toHaveBeenCalledWith(302)
+       expect(res.setHeader).toHaveBeenCalledWith(
+          'Location',
+          'http://localhost:3000/settings?tab=sync&token=token-abc'
+       )
+    })
+})

package/src/GithubAuthApi.ts

@@ -0,0 +1,70 @@
+import { ServerAdapter, ApiRequest, ApiResponse } from '@quatrain/api'
+import { GithubAuthAdapter } from './GithubAuthAdapter'
+
+/**
+ * Pluggable router endpoints for Github OAuth authentication.
+ * Compatible with any Quatrain ServerAdapter (Astro, Express, etc.).
+ */
+export function GithubAuthApi(router: ServerAdapter, path: string, options: any = {}) {
+   const adapter = options.adapter || GithubAuthAdapter.factory(options.config || {})
+   if (!adapter) {
+      throw new Error('GithubAuthApi requires a valid GithubAuthAdapter or configuration.')
+   }
+
+   // Route: GET [root]/login
+   router.get('/login', async (req: ApiRequest, res: ApiResponse) => {
+      const redirectUri = req.query.redirect_uri as string
+      const scopes = (req.query.scopes as string || 'repo').split(',')
+      const state = req.query.state as string
+      
+      const authUrl = adapter.getAuthorizationUrl(redirectUri, scopes, state)
+      
+      const wantsJson = req.query.json === 'true' || req.headers?.accept?.includes('application/json')
+      if (wantsJson) {
+         res.status(200).json({ url: authUrl })
+         return
+      }
+
+      res.status(302).setHeader('Location', authUrl)
+      res.send(`Redirecting to GitHub...`)
+   })
+
+   // Route: GET [root]/callback
+   router.get('/callback', async (req: ApiRequest, res: ApiResponse) => {
+      const code = req.query.code as string
+      const redirectUri = req.query.redirect_uri as string
+      const platform = req.query.platform as string
+      
+      if (!code) {
+         res.status(400).send('Missing authorization code.')
+         return
+      }
+
+      try {
+         const tokenData = await adapter.exchangeCodeForToken(code, redirectUri)
+         
+         // Support standard deep link redirect for mobile context if an app scheme is configured
+         const appScheme = req.query.app_scheme as string || options.appScheme
+         if (appScheme) {
+            const redirectUrl = `${appScheme}://auth/github/callback?token=${tokenData.access_token}`
+            res.status(302).setHeader('Location', redirectUrl)
+            res.send(`Redirecting back to app...`)
+            return
+         }
+
+         // Support standard redirect for web context if a target URI is configured
+         const webRedirectUri = req.query.web_redirect_uri as string || options.webRedirectUri
+         if (webRedirectUri) {
+            const separator = webRedirectUri.includes('?') ? '&' : '?'
+            const redirectUrl = `${webRedirectUri}${separator}token=${tokenData.access_token}`
+            res.status(302).setHeader('Location', redirectUrl)
+            res.send(`Redirecting...`)
+            return
+         }
+
+         res.status(200).json(tokenData)
+      } catch (err: any) {
+         res.status(500).send(`OAuth error: ${err.message}`)
+      }
+   })
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './GithubAuthAdapter'
+export * from './GithubAuthApi'