Skip to content

Function: createConnect() ​

Create a "Connect with Nosana" session, picking browser (no secret) or server (with secret) from your config. Pass it as the client's connect option: createNosanaClient(network, { connect }).

Call Signature ​

ts
function createConnect(config): ServerConnect;

Create a "Connect with Nosana" session, picking the flow from your config: a client secret means a confidential server app (redirect handled by your backend); no secret means a public browser app (PKCE, redirect in the browser). The returned type reflects that choice, so you get the right methods.

ts
// browser app (no secret) → BrowserConnect
const connect = createConnect({ clientId, redirectUri });
await connect.loginWithRedirect();

// server app (with secret) → ServerConnect
const connect = createConnect({ clientId, redirectUri, clientSecret });
res.redirect(await connect.getLoginUrl());

Prefer the explicit createBrowserConnect / createServerConnect when you already know which environment you're in.

Parameters ​

ParameterType
configConnectConfig & object & object

Returns ​

ServerConnect

Call Signature ​

ts
function createConnect(config): BrowserConnect;

Create a "Connect with Nosana" session, picking the flow from your config: a client secret means a confidential server app (redirect handled by your backend); no secret means a public browser app (PKCE, redirect in the browser). The returned type reflects that choice, so you get the right methods.

ts
// browser app (no secret) → BrowserConnect
const connect = createConnect({ clientId, redirectUri });
await connect.loginWithRedirect();

// server app (with secret) → ServerConnect
const connect = createConnect({ clientId, redirectUri, clientSecret });
res.redirect(await connect.getLoginUrl());

Prefer the explicit createBrowserConnect / createServerConnect when you already know which environment you're in.

Parameters ​

ParameterType
configConnectConfig & object & object

Returns ​

BrowserConnect

Call Signature ​

ts
function createConnect(config): ServerConnect | BrowserConnect;

Create a "Connect with Nosana" session, picking the flow from your config: a client secret means a confidential server app (redirect handled by your backend); no secret means a public browser app (PKCE, redirect in the browser). The returned type reflects that choice, so you get the right methods.

ts
// browser app (no secret) → BrowserConnect
const connect = createConnect({ clientId, redirectUri });
await connect.loginWithRedirect();

// server app (with secret) → ServerConnect
const connect = createConnect({ clientId, redirectUri, clientSecret });
res.redirect(await connect.getLoginUrl());

Prefer the explicit createBrowserConnect / createServerConnect when you already know which environment you're in.

Parameters ​

ParameterType
configConnectSessionConfig

Returns ​

| ServerConnect | BrowserConnect