feat(shopify): integrate shopify passport authentication

Integrate shopify passport authentication

README.md

@@ -130,6 +130,7 @@ class AuthController {
 - [GitHub](https://nestjs-hybrid-auth.manishjangir.com/docs/providers/github)
 - [Instagram](https://nestjs-hybrid-auth.manishjangir.com/docs/providers/instagram)
 - [Twitch](https://nestjs-hybrid-auth.manishjangir.com/docs/providers/twitch)
+- [Shopify](https://nestjs-hybrid-auth.manishjangir.com/docs/providers/shopify)
 - [Okta](https://nestjs-hybrid-auth.manishjangir.com/docs/providers/okta)
 
 ## Related

packages/nestjs-hybrid-auth-all/package.json

@@ -52,6 +52,7 @@
     "@nestjs-hybrid-auth/github": "^1.0.0",
     "@nestjs-hybrid-auth/twitter": "^1.0.0",
     "@nestjs-hybrid-auth/twitch": "^1.0.0",
+    "@nestjs-hybrid-auth/shopify": "^0.0.0",
     "@nestjs-hybrid-auth/okta": "^1.0.0"
   }
 }

packages/nestjs-hybrid-auth-all/src/hybrid-auth.module.ts

@@ -6,6 +6,7 @@ import { FacebookAuthModule } from '@nestjs-hybrid-auth/facebook';
 import { InstagramAuthModule } from '@nestjs-hybrid-auth/instagram';
 import { GithubAuthModule } from '@nestjs-hybrid-auth/github';
 import { TwitchAuthModule } from '@nestjs-hybrid-auth/twitch';
+import { ShopifyAuthModule } from '@nestjs-hybrid-auth/shopify';
 import { OktaAuthModule } from '@nestjs-hybrid-auth/okta';
 import {
   HybridAuthModuleOptions,
@@ -21,6 +22,7 @@ function createHybridAuthImports(options: HybridAuthModuleOptions): any {
     options.instagram && InstagramAuthModule.forRoot(options.instagram),
     options.github && GithubAuthModule.forRoot(options.github),
     options.twitch && TwitchAuthModule.forRoot(options.twitch),
+    options.shopify && ShopifyAuthModule.forRoot(options.shopify),
     options.okta && OktaAuthModule.forRoot(options.okta),
   ].filter(Boolean);
 }
@@ -66,6 +68,10 @@ export class HybridAuthModule {
       imports.push(TwitchAuthModule.forRootAsync(options.twitch));
     }
 
+    if (options.shopify) {
+      imports.push(ShopifyAuthModule.forRootAsync(options.shopify));
+    }
+
     if (options.okta) {
       imports.push(OktaAuthModule.forRootAsync(options.okta));
     }

packages/nestjs-hybrid-auth-all/src/hybrid-auth.options.ts

@@ -9,6 +9,7 @@ import { FacebookAuthModuleOptions } from '@nestjs-hybrid-auth/facebook';
 import { InstagramAuthModuleOptions } from '@nestjs-hybrid-auth/instagram';
 import { GithubAuthModuleOptions } from '@nestjs-hybrid-auth/github';
 import { TwitchAuthModuleOptions } from '@nestjs-hybrid-auth/twitch';
+import { ShopifyAuthModuleOptions } from '@nestjs-hybrid-auth/shopify';
 import { OktaAuthModuleOptions } from '@nestjs-hybrid-auth/okta';
 
 export interface HybridAuthModuleOptions {
@@ -19,6 +20,7 @@ export interface HybridAuthModuleOptions {
   instagram?: InstagramAuthModuleOptions;
   github?: GithubAuthModuleOptions;
   twitch?: TwitchAuthModuleOptions;
+  shopify?: ShopifyAuthModuleOptions;
   okta?: OktaAuthModuleOptions;
 }
 
@@ -51,6 +53,10 @@ export interface HybridAuthModuleAsyncOptions {
     IdentityModuleOptionsFactory<TwitchAuthModuleOptions>,
     TwitchAuthModuleOptions
   >;
+  shopify?: IdentityModuleAsyncOptions<
+    IdentityModuleOptionsFactory<ShopifyAuthModuleOptions>,
+    ShopifyAuthModuleOptions
+  >;
   okta?: IdentityModuleAsyncOptions<
     IdentityModuleOptionsFactory<OktaAuthModuleOptions>,
     OktaAuthModuleOptions

packages/nestjs-hybrid-auth-all/src/index.ts

@@ -5,6 +5,7 @@ export * from '@nestjs-hybrid-auth/github';
 export * from '@nestjs-hybrid-auth/twitter';
 export * from '@nestjs-hybrid-auth/linkedin';
 export * from '@nestjs-hybrid-auth/twitch';
+export * from '@nestjs-hybrid-auth/shopify';
 export * from '@nestjs-hybrid-auth/okta';
 export * from './hybrid-auth.module';
 export * from './hybrid-auth.options';

packages/nestjs-hybrid-auth-shopify/README.md

@@ -0,0 +1,241 @@
+# NestJS Shopify Authentication
+
+Implement shopify authentication in your NestJS application.
+
+## Install
+
+```bash
+npm install @nestjs-hybrid-auth/shopify --save
+```
+
+OR
+
+```bash
+yarn add @nestjs-hybrid-auth/shopify
+```
+
+### Note: **Shopify oauth applications require secure redirect urls. Please make sure to have https in your dev env also.**
+
+## How To Use?
+
+The package exports mainly a [dynamic module](https://docs.nestjs.com/fundamentals/dynamic-modules) and [guard](https://docs.nestjs.com/guards). The module should be imported in your app.module.ts and guards should be used on the route handlers of any controller.
+
+## Example Code For app.module.ts
+
+### Simple static configuration
+
+Want to jump directly to the [available options](#shopifyauthmoduleoptions)?
+
+If you just want to provide the static values or have them handy, pass them as options to the `forRoot` static method like below. The options object is type of `ShopifyAuthModuleOptions`.
+
+```typescript
+import { ShopifyAuthModule } from '@nestjs-hybrid-auth/shopify';
+
+@Module({
+  imports: [
+    ShopifyAuthModule.forRoot({
+      clientID: process.env.CLIENT_ID,
+      clientSecret: process.env.CLIENT_SECRET,
+      callbackURL: process.env.CALLBACK_URL,
+      shop: process.env.SHOPIFY_STORE_SLUG,
+    }),
+  ],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}
+```
+
+### `useFactory` to get the ConfigService injected.
+
+If you want to make use of nest's [ConfigModule](https://docs.nestjs.com/techniques/configuration#installation) to get the auth configuration for a provider from `.env` config files, use `forRootAsync` static method. The options to this method are typeof `ShopifyAuthModuleAsyncOptions` which accepts a `useFactory` property. `useFactory` is a function which gets the instances injected whatever has been provided in `inject` array. You can use those instances to prepare and return the actual `ShopifyAuthModuleOptions` object. ConfigService can be one of them as per your choice.
+
+```typescript
+import { ShopifyAuthModule } from '@nestjs-hybrid-auth/shopify';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+      cache: true,
+      expandVariables: true,
+    }),
+    ShopifyAuthModule.forRootAsync({
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useFactory: (configService: ConfigService) => ({
+        clientID: configService.get('SHOPIFY_CLIENT_ID'),
+        clientSecret: configService.get('SHOPIFY_CLIENT_SECRET'),
+        callbackURL: configService.get('SHOPIFY_CALLBACK_URL'),
+        shop: configService.get('SHOPIFY_STORE_SLUG'),
+      }),
+    }),
+  ],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}
+```
+
+### Use `useClass` to get your auth config from a class
+
+If the `useFactory` makes your app module bloated with a lot of boilerplate code, you can `useClass` to provide an existing config provider class. The class must implement `ShopifyAuthModuleOptionsFactory` interface and `createModuleOptions` method. This method should return `ShopifyAuthModuleOptions` object. Similar to `useFactory`, whatever you provide in `inject` array, it will get injected in the constructor of your class. Follow the example:
+
+**hybrid-auth.config.ts**
+
+```typescript
+import { ConfigService } from '@nestjs/config';
+import {
+  ShopifyAuthModuleOptions,
+  ShopifyAuthModuleOptionsFactory,
+} from '@nestjs-hybrid-auth/shopify';
+
+@Injectable()
+class HybridAuthConfig implements ShopifyAuthModuleOptionsFactory {
+  constructor(private configService: ConfigService) {}
+
+  createModuleOptions(): ShopifyAuthModuleOptions {
+    return {
+      clientKey: this.configService.get('SHOPIFY_CLIENT_ID'),
+      clientSecret: this.configService.get('SHOPIFY_CLIENT_SECRET'),
+      callbackURL: this.configService.get('SHOPIFY_CALLBACK_URL'),
+      shop: this.configService.get('SHOPIFY_STORE_SLUG'),
+    };
+  }
+}
+```
+
+**app.module.ts**
+
+```typescript
+import { ShopifyAuthModule } from '@nestjs-hybrid-auth/shopify';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+      cache: true,
+      expandVariables: true,
+    }),
+    ShopifyAuthModule.forRootAsync({
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useClass: HybridAuthConfig,
+    }),
+  ],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}
+```
+
+## Example Code For Controller
+
+Once you have setup the module properly in module file, its time to configure your route handlers to make the user properly redirected to appropriate identity provider's login page. `@nestjs-hybrid-auth/shopify` provides a guard and result interface to make it enabled.
+
+Each route will have two variants. One is to redirect to social login page and the other is to collect the response such as access/refresh tokens and user profile etc. The result will be attached to `Request` object's `hybridAuthResult` property as shown in the example below.
+
+### app.controller.ts
+
+```typescript
+import { UseShopifyAuth, ShopifyAuthResult } from '@nestjs-hybrid-auth/shopify';
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @UseShopifyAuth()
+  @Get('auth/shopify')
+  loginWithShopify() {
+    return 'Login with Shopify';
+  }
+
+  @UseShopifyAuth()
+  @Get('auth/shopify-login/callback')
+  shopifyCallback(@Request() req): Partial<ShopifyAuthResult> {
+    const result: ShopifyAuthResult = req.hybridAuthResult;
+    return {
+      accessToken: result.accessToken,
+      refreshToken: result.refreshToken,
+      profile: result.profile,
+    };
+  }
+}
+```
+
+## Exports
+
+`@nestjs-hybrid-auth/shopify` exports various decorators, interfaces and methods.
+
+### UseShopifyAuth
+
+`UseShopifyAuth` is NestJS `Guard` which hijacks your nest request and redirects users to the appropriate login page of your configured identity provider (shopify in this case). The same guard can be used on `callback` route also as shown in the example above. In the callback route handler, the `req: Request` object will have a property `hybridAuthResult` which is an object of type `ShopifyAuthResult`.
+
+```typescript
+@UseShopifyAuth(options: ShopifyAuthGuardOptions)
+@Get('auth/shopify')
+loginWithShopify() {
+  return 'Login with Shopify';
+}
+```
+
+### ShopifyAuthGuardOptions
+
+This is a simple object to be passed into `UseShopifyAuth` guard as shown in example above if you want to pass some extra parameters to query the shopify result. It can be left empty for default result.
+
+### ShopifyAuthModule
+
+This is the dynamic module which must be imported in your app's main module with `forRoot` or `forRootAsync` static methods whichever suits your need. Both will return a [NestJS dynamic module](https://docs.nestjs.com/fundamentals/dynamic-modules).
+
+```typescript
+interface ShopifyAuthModule {
+  forRoot(options: ShopifyAuthModuleOptions): DynamicModule;
+  forRootAsync(options: ShopifyAuthModuleAsyncOptions): DynamicModule;
+}
+```
+
+### ShopifyAuthModuleOptions
+
+If you are configuring your module with `forRoot` static method, pass in the module options given below. They can be called the shopify passport strategy options also.
+
+```typescript
+interface ShopifyAuthModuleOptions {
+  clientID: string;
+  clientSecret: string;
+  callbackURL: string;
+  shop: string;
+}
+```
+
+### ShopifyAuthModuleAsyncOptions
+
+If you want to configure the `ShopifyAuthModule` dynamically having the config or other services injected, pass in async options in the `forRootAsync` static method. Please refer to the example above for `useFactory` and `useClass` properties.
+
+```typescript
+interface ShopifyAuthModuleAsyncOptions {
+  useExisting?: Type<ShopifyAuthModuleOptionsFactory>;
+  useClass?: Type<ShopifyAuthModuleOptionsFactory>;
+  useFactory?: (
+    ...args: any[]
+  ) => Promise<ShopifyAuthModuleOptions> | ShopifyAuthModuleOptions;
+  inject?: any[];
+}
+```
+
+### ShopifyAuthModuleOptionsFactory
+
+```typescript
+interface ShopifyAuthModuleOptionsFactory {
+  createModuleOptions():
+    | Promise<ShopifyAuthModuleOptions>
+    | ShopifyAuthModuleOptions;
+}
+```
+
+## Have Issues?
+
+If you still have trouble setting up the workflow properly, please file an issue at [Issues](https://github.com/mjangir/nestjs-hybrid-auth/issues) page.
+
+## Maintainers
+
+[Manish Jangir](https://github.com/mjangir)

packages/nestjs-hybrid-auth-shopify/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@nestjs-hybrid-auth/shopify",
+  "description": "NestJS shopify authentication using passport",
+  "version": "0.0.0",
+  "license": "MIT",
+  "author": "Manish Jangir <mjangir70@gmail.com> (https://manishjangir.com)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mjangir/nestjs-hybrid-auth.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mjangir/nestjs-hybrid-auth/issues"
+  },
+  "homepage": "https://nestjs-hybrid-auth.manishjangir.com",
+  "keywords": [
+    "nestjs shopify",
+    "nestjs passport",
+    "nestjs shopify login",
+    "shopify auth",
+    "nestjs shopify auth",
+    "nestjs login",
+    "nestjs social login"
+  ],
+  "main": "dist/index.js",
+  "typings": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@nestjs/common": "^8.0.0",
+    "@nestjs/core": "^8.0.0",
+    "@nestjs/passport": "^8.0.0",
+    "passport": "^0.5.0",
+    "reflect-metadata": "^0.1.13"
+  },
+  "scripts": {
+    "test": "tsdx test --env=jsdom",
+    "test:watch": "npm run test -- --watchAll",
+    "start": "tsdx watch --target node --tsconfig tsconfig.build.json --verbose --noClean",
+    "build": "tsdx build --target node --tsconfig tsconfig.build.json",
+    "lint": "tsdx lint src",
+    "prepublish": "npm run build"
+  },
+  "dependencies": {
+    "@nestjs-hybrid-auth/core": "^1.0.0",
+    "@types/lodash": "^4.14.174",
+    "lodash": "^4.17.21",
+    "passport-shopify": "^0.1.2"
+  },
+  "devDependencies": {
+    "express": "^4.17.1",
+    "passport": "^0.5.0",
+    "passport-oauth2": "^1.6.1"
+  }
+}

packages/nestjs-hybrid-auth-shopify/src/index.ts

@@ -0,0 +1,8 @@
+export { UseShopifyAuth } from './shopify.guard';
+export { ShopifyAuthModule } from './shopify.module';
+export {
+  ShopifyAuthModuleOptions,
+  ShopifyAuthModuleOptionsFactory,
+  ShopifyAuthGuardOptions,
+  ShopifyAuthResult,
+} from './shopify.types';

packages/nestjs-hybrid-auth-shopify/src/shopify.constants.ts

@@ -0,0 +1 @@
+export const SHOPIFY_HYBRID_AUTH_OPTIONS = 'SHOPIFY_HYBRID_AUTH_OPTIONS';