@bactv/socialite 1.0.0

package/dist/infrastructure/providers/MicrosoftProvider.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicrosoftProvider = void 0;
+const AbstractProvider_1 = require("./AbstractProvider");
+const SocialUser_1 = require("../../domain/entities/SocialUser");
+class MicrosoftProvider extends AbstractProvider_1.AbstractProvider {
+    constructor() {
+        super(...arguments);
+        this.name = "microsoft";
+        // "common" allows both personal Microsoft accounts and work/school (Azure AD) accounts.
+        this.authorizeUrl = "https://login.microsoftonline.com/common/oauth2/v2.0/authorize";
+        this.tokenUrl = "https://login.microsoftonline.com/common/oauth2/v2.0/token";
+        this.userUrl = "https://graph.microsoft.com/v1.0/me";
+        this.defaultScopes = ["openid", "profile", "email", "User.Read"];
+    }
+    mapToSocialUser(raw, token) {
+        return new SocialUser_1.SocialUser({
+            id: String(raw.id),
+            nickname: raw.userPrincipalName ?? null,
+            name: raw.displayName ?? null,
+            email: raw.mail ?? raw.userPrincipalName ?? null,
+            avatar: null, // Requires a separate call to /me/photo/$value; omitted to keep this call cheap.
+            provider: this.name,
+            accessToken: token.accessToken,
+            refreshToken: token.refreshToken,
+            expiresIn: token.expiresIn,
+            raw,
+        });
+    }
+}
+exports.MicrosoftProvider = MicrosoftProvider;
+//# sourceMappingURL=MicrosoftProvider.js.map

package/dist/infrastructure/providers/MicrosoftProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MicrosoftProvider.js","sourceRoot":"","sources":["../../../src/infrastructure/providers/MicrosoftProvider.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AACtD,iEAA8D;AAG9D,MAAa,iBAAkB,SAAQ,mCAAgB;IAAvD;;QACW,SAAI,GAAG,WAAW,CAAC;QAC5B,wFAAwF;QACrE,iBAAY,GAAG,gEAAgE,CAAC;QAChF,aAAQ,GAAG,4DAA4D,CAAC;QACxE,YAAO,GAAG,qCAAqC,CAAC;QAChD,kBAAa,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAgBjF,CAAC;IAdC,eAAe,CAAC,GAA4B,EAAE,KAAwB;QACpE,OAAO,IAAI,uBAAU,CAAC;YACpB,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,QAAQ,EAAG,GAAG,CAAC,iBAA4B,IAAI,IAAI;YACnD,IAAI,EAAG,GAAG,CAAC,WAAsB,IAAI,IAAI;YACzC,KAAK,EAAG,GAAG,CAAC,IAAe,IAAK,GAAG,CAAC,iBAA4B,IAAI,IAAI;YACxE,MAAM,EAAE,IAAI,EAAE,iFAAiF;YAC/F,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;CACF;AAtBD,8CAsBC"}

package/dist/infrastructure/providers/ProviderFactory.d.ts

@@ -0,0 +1,15 @@
+import { OAuthProviderContract } from "../../domain/contracts/OAuthProviderContract";
+import { HttpClientContract } from "../../domain/contracts/HttpClientContract";
+import { StateStoreContract } from "../../domain/contracts/StateStoreContract";
+import { ProviderConfig } from "../../application/dto/ProviderConfig";
+import { ProviderName } from "../../domain/value-objects/ProviderName";
+/**
+ * Infrastructure Factory: ProviderFactory
+ *
+ * Encapsulates the mapping from a driver name string to the concrete
+ * class that implements it. This is the only place in the codebase
+ * that needs to change to register a brand-new provider.
+ */
+export declare class ProviderFactory {
+    static make(name: ProviderName, config: ProviderConfig, http: HttpClientContract, stateStore: StateStoreContract): OAuthProviderContract;
+}

package/dist/infrastructure/providers/ProviderFactory.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderFactory = void 0;
+const SocialiteError_1 = require("../../domain/errors/SocialiteError");
+const GoogleProvider_1 = require("./GoogleProvider");
+const MicrosoftProvider_1 = require("./MicrosoftProvider");
+const FacebookProvider_1 = require("./FacebookProvider");
+const GithubProvider_1 = require("./GithubProvider");
+const TwitterProvider_1 = require("./TwitterProvider");
+const LinkedinProvider_1 = require("./LinkedinProvider");
+const PROVIDER_REGISTRY = {
+    google: GoogleProvider_1.GoogleProvider,
+    microsoft: MicrosoftProvider_1.MicrosoftProvider,
+    facebook: FacebookProvider_1.FacebookProvider,
+    github: GithubProvider_1.GithubProvider,
+    twitter: TwitterProvider_1.TwitterProvider,
+    linkedin: LinkedinProvider_1.LinkedinProvider,
+};
+/**
+ * Infrastructure Factory: ProviderFactory
+ *
+ * Encapsulates the mapping from a driver name string to the concrete
+ * class that implements it. This is the only place in the codebase
+ * that needs to change to register a brand-new provider.
+ */
+class ProviderFactory {
+    static make(name, config, http, stateStore) {
+        const Ctor = PROVIDER_REGISTRY[name];
+        if (!Ctor) {
+            throw new SocialiteError_1.UnsupportedProviderError(name);
+        }
+        return new Ctor(config, http, stateStore);
+    }
+}
+exports.ProviderFactory = ProviderFactory;
+//# sourceMappingURL=ProviderFactory.js.map

package/dist/infrastructure/providers/ProviderFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderFactory.js","sourceRoot":"","sources":["../../../src/infrastructure/providers/ProviderFactory.ts"],"names":[],"mappings":";;;AAKA,uEAA8E;AAE9E,qDAAkD;AAClD,2DAAwD;AACxD,yDAAsD;AACtD,qDAAkD;AAClD,uDAAoD;AACpD,yDAAsD;AAQtD,MAAM,iBAAiB,GAAuC;IAC5D,MAAM,EAAE,+BAAc;IACtB,SAAS,EAAE,qCAAiB;IAC5B,QAAQ,EAAE,mCAAgB;IAC1B,MAAM,EAAE,+BAAc;IACtB,OAAO,EAAE,iCAAe;IACxB,QAAQ,EAAE,mCAAgB;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,MAAa,eAAe;IAC1B,MAAM,CAAC,IAAI,CACT,IAAkB,EAClB,MAAsB,EACtB,IAAwB,EACxB,UAA8B;QAE9B,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,yCAAwB,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;CACF;AAbD,0CAaC"}

package/dist/infrastructure/providers/TwitterProvider.d.ts

@@ -0,0 +1,13 @@
+import { AbstractProvider } from "./AbstractProvider";
+import { SocialUser } from "../../domain/entities/SocialUser";
+import { AccessTokenResult } from "../../domain/value-objects/AccessTokenResult";
+export declare class TwitterProvider extends AbstractProvider {
+    readonly name = "twitter";
+    protected readonly authorizeUrl = "https://twitter.com/i/oauth2/authorize";
+    protected readonly tokenUrl = "https://api.twitter.com/2/oauth2/token";
+    protected readonly userUrl = "https://api.twitter.com/2/users/me?user.fields=profile_image_url,username,name";
+    protected readonly defaultScopes: string[];
+    protected readonly usesPKCE = true;
+    protected tokenRequestHeaders(): Record<string, string>;
+    mapToSocialUser(raw: Record<string, unknown>, token: AccessTokenResult): SocialUser;
+}

package/dist/infrastructure/providers/TwitterProvider.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwitterProvider = void 0;
+const AbstractProvider_1 = require("./AbstractProvider");
+const SocialUser_1 = require("../../domain/entities/SocialUser");
+class TwitterProvider extends AbstractProvider_1.AbstractProvider {
+    constructor() {
+        super(...arguments);
+        this.name = "twitter";
+        this.authorizeUrl = "https://twitter.com/i/oauth2/authorize";
+        this.tokenUrl = "https://api.twitter.com/2/oauth2/token";
+        this.userUrl = "https://api.twitter.com/2/users/me?user.fields=profile_image_url,username,name";
+        this.defaultScopes = ["tweet.read", "users.read", "offline.access"];
+        // X (Twitter) OAuth 2.0 mandates PKCE for the authorization code grant.
+        this.usesPKCE = true;
+    }
+    // X's token endpoint authenticates confidential clients via HTTP Basic
+    // auth (base64 client_id:client_secret) rather than body parameters.
+    tokenRequestHeaders() {
+        const basic = Buffer.from(`${this.config.clientId}:${this.config.clientSecret}`).toString("base64");
+        return {
+            Accept: "application/json",
+            Authorization: `Basic ${basic}`,
+        };
+    }
+    mapToSocialUser(raw, token) {
+        const data = (raw.data ?? raw);
+        return new SocialUser_1.SocialUser({
+            id: String(data.id),
+            nickname: data.username ?? null,
+            name: data.name ?? null,
+            email: null, // X's API does not expose email through this endpoint.
+            avatar: data.profile_image_url ?? null,
+            provider: this.name,
+            accessToken: token.accessToken,
+            refreshToken: token.refreshToken,
+            expiresIn: token.expiresIn,
+            raw,
+        });
+    }
+}
+exports.TwitterProvider = TwitterProvider;
+//# sourceMappingURL=TwitterProvider.js.map

package/dist/infrastructure/providers/TwitterProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TwitterProvider.js","sourceRoot":"","sources":["../../../src/infrastructure/providers/TwitterProvider.ts"],"names":[],"mappings":";;;AAAA,yDAAsD;AACtD,iEAA8D;AAG9D,MAAa,eAAgB,SAAQ,mCAAgB;IAArD;;QACW,SAAI,GAAG,SAAS,CAAC;QACP,iBAAY,GAAG,wCAAwC,CAAC;QACxD,aAAQ,GAAG,wCAAwC,CAAC;QACpD,YAAO,GAAG,gFAAgF,CAAC;QAC3F,kBAAa,GAAG,CAAC,YAAY,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC;QAClF,wEAAwE;QACrD,aAAQ,GAAG,IAAI,CAAC;IA2BrC,CAAC;IAzBC,uEAAuE;IACvE,qEAAqE;IAC3D,mBAAmB;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpG,OAAO;YACL,MAAM,EAAE,kBAAkB;YAC1B,aAAa,EAAE,SAAS,KAAK,EAAE;SAChC,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,GAA4B,EAAE,KAAwB;QACpE,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAA4B,CAAC;QAC1D,OAAO,IAAI,uBAAU,CAAC;YACpB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,QAAQ,EAAG,IAAI,CAAC,QAAmB,IAAI,IAAI;YAC3C,IAAI,EAAG,IAAI,CAAC,IAAe,IAAI,IAAI;YACnC,KAAK,EAAE,IAAI,EAAE,uDAAuD;YACpE,MAAM,EAAG,IAAI,CAAC,iBAA4B,IAAI,IAAI;YAClD,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;CACF;AAlCD,0CAkCC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@bactv/socialite",
+  "version": "1.0.0",
+  "description": "A DDD-structured Node.js SDK for social login (OAuth2) across Google, Microsoft, Facebook, GitHub, Twitter/X and LinkedIn.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -w -p tsconfig.json",
+    "test": "tsc --module commonjs --target ES2021 --esModuleInterop --outDir dist-tests --rootDir . src/index.ts tests/*.test.ts && node --test dist-tests/tests/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "oauth",
+    "oauth2",
+    "social-login",
+    "google",
+    "microsoft",
+    "facebook",
+    "github",
+    "twitter",
+    "linkedin",
+    "ddd"
+  ],
+  "author": "Bac Truong Van<bactruongvan17@gmail.com>",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.5.4",
+    "@types/node": "^20.14.0",
+    "ts-node": "^10.9.2"
+  }
+}