feat(workos-node): Add connection to CommonAuthorizationURLOptions (#347)

Author: rohanjadvani

src/sso/__snapshots__/sso.spec.ts.snap

@@ -1,5 +1,7 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`SSO SSO getAuthorizationURL with a connection generates an authorize url with the connection 1`] = `"https://api.workos.dev/sso/authorize?client_id=proj_123&connection=connection_123&redirect_uri=example.com%2Fsso%2Fworkos%2Fcallback&response_type=code"`;
+
 exports[`SSO SSO getAuthorizationURL with a custom api hostname generates an authorize url with the custom api hostname 1`] = `"https://api.workos.dev/sso/authorize?client_id=proj_123&domain=lyft.com&redirect_uri=example.com%2Fsso%2Fworkos%2Fcallback&response_type=code"`;
 
 exports[`SSO SSO getAuthorizationURL with a provider generates an authorize url with the provider 1`] = `"https://api.workos.dev/sso/authorize?client_id=proj_123&provider=Google&redirect_uri=example.com%2Fsso%2Fworkos%2Fcallback&response_type=code"`;
@@ -8,7 +10,7 @@ exports[`SSO SSO getAuthorizationURL with no custom api hostname generates an au
 
 exports[`SSO SSO getAuthorizationURL with no custom api hostname with projectID instead of clientID generates an authorize url with the default api hostname 1`] = `"https://api.workos.com/sso/authorize?client_id=proj_123&domain=lyft.com&redirect_uri=example.com%2Fsso%2Fworkos%2Fcallback&response_type=code"`;
 
-exports[`SSO SSO getAuthorizationURL with no domain or provider throws an error for incomplete arguments 1`] = `"Incomplete arguments. Need to specify either a 'domain' or 'provider'."`;
+exports[`SSO SSO getAuthorizationURL with no domain or provider throws an error for incomplete arguments 1`] = `"Incomplete arguments. Need to specify either a 'connection', 'domain', or 'provider'."`;
 
 exports[`SSO SSO getAuthorizationURL with state generates an authorize url with the provided state 1`] = `"https://api.workos.com/sso/authorize?client_id=proj_123&domain=lyft.com&redirect_uri=example.com%2Fsso%2Fworkos%2Fcallback&response_type=code&state=custom%20state"`;
 

src/sso/interfaces/authorization-url-options.interface.ts

@@ -1,9 +1,11 @@
 export interface CommonAuthorizationURLOptions {
+  connection?: string;
   domain?: string;
   provider?: string;
   redirectURI: string;
   state?: string;
 }
+
 export type AuthorizationURLOptions =
   | ({
       clientID: string;

src/sso/sso.spec.ts

@@ -63,6 +63,22 @@ describe('SSO', () => {
         });
       });
 
+      describe('with a connection', () => {
+        it('generates an authorize url with the connection', () => {
+          const workos = new WorkOS('sk_test_Sz3IQjepeSWaI4cMS4ms4sMuU', {
+            apiHostname: 'api.workos.dev',
+          });
+
+          const url = workos.sso.getAuthorizationURL({
+            connection: 'connection_123',
+            clientID: 'proj_123',
+            redirectURI: 'example.com/sso/workos/callback',
+          });
+
+          expect(url).toMatchSnapshot();
+        });
+      });
+
       describe('with a custom api hostname', () => {
         it('generates an authorize url with the custom api hostname', () => {
           const workos = new WorkOS('sk_test_Sz3IQjepeSWaI4cMS4ms4sMuU', {

src/sso/sso.ts

@@ -25,20 +25,22 @@ export class SSO {
   }
 
   getAuthorizationURL({
+    connection,
     clientID,
     domain,
     provider,
     projectID,
     redirectURI,
     state,
   }: AuthorizationURLOptions): string {
-    if (!domain && !provider) {
+    if (!domain && !provider && !connection) {
       throw new Error(
-        `Incomplete arguments. Need to specify either a 'domain' or 'provider'.`,
+        `Incomplete arguments. Need to specify either a 'connection', 'domain', or 'provider'.`,
       );
     }
 
     const query = queryString.stringify({
+      connection,
       domain,
       provider,
       client_id: clientID ?? projectID,