@logto/js 4.0.1 → 4.1.1

package/lib/consts/index.cjs

@@ -36,6 +36,8 @@ exports.QueryKey = void 0;
     QueryKey["InteractionMode"] = "interaction_mode";
     /** The query key for specifying the organization ID. */
     QueryKey["OrganizationId"] = "organization_id";
+    QueryKey["FirstScreen"] = "first_screen";
+    QueryKey["DirectSignIn"] = "direct_sign_in";
 })(exports.QueryKey || (exports.QueryKey = {}));
 /** The prompt parameter to be used for the authorization request. */
 exports.Prompt = void 0;

package/lib/consts/index.d.ts

@@ -31,7 +31,9 @@ export declare enum QueryKey {
     Token = "token",
     InteractionMode = "interaction_mode",
     /** The query key for specifying the organization ID. */
-    OrganizationId = "organization_id"
+    OrganizationId = "organization_id",
+    FirstScreen = "first_screen",
+    DirectSignIn = "direct_sign_in"
 }
 /** The prompt parameter to be used for the authorization request. */
 export declare enum Prompt {

package/lib/consts/index.js

@@ -34,6 +34,8 @@ var QueryKey;
     QueryKey["InteractionMode"] = "interaction_mode";
     /** The query key for specifying the organization ID. */
     QueryKey["OrganizationId"] = "organization_id";
+    QueryKey["FirstScreen"] = "first_screen";
+    QueryKey["DirectSignIn"] = "direct_sign_in";
 })(QueryKey || (QueryKey = {}));
 /** The prompt parameter to be used for the authorization request. */
 var Prompt;

package/lib/core/sign-in.cjs

@@ -11,7 +11,7 @@ const buildPrompt = (prompt) => {
     }
     return prompt ?? index.Prompt.Consent;
 };
-const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes: scopes$1, resources, prompt, interactionMode, loginHint, }) => {
+const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes: scopes$1, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, }) => {
     const urlSearchParameters = new URLSearchParams({
         [index.QueryKey.ClientId]: clientId,
         [index.QueryKey.RedirectUri]: redirectUri,
@@ -21,15 +21,22 @@ const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeC
         [index.QueryKey.ResponseType]: responseType,
         [index.QueryKey.Prompt]: buildPrompt(prompt),
         [index.QueryKey.Scope]: scopes.withDefaultScopes(scopes$1),
+        ...extraParams,
     });
     if (loginHint) {
         urlSearchParameters.append(index.QueryKey.LoginHint, loginHint);
     }
+    if (directSignIn) {
+        urlSearchParameters.append(index.QueryKey.DirectSignIn, `${directSignIn.method}:${directSignIn.target}`);
+    }
     for (const resource of resources ?? []) {
         urlSearchParameters.append(index.QueryKey.Resource, resource);
     }
-    // Set interactionMode to signUp for a create account user experience
-    if (interactionMode) {
+    if (firstScreen) {
+        urlSearchParameters.append(index.QueryKey.FirstScreen, firstScreen);
+    }
+    // @deprecated Remove later
+    else if (interactionMode) {
         urlSearchParameters.append(index.QueryKey.InteractionMode, interactionMode);
     }
     return `${authorizationEndpoint}?${urlSearchParameters.toString()}`;

package/lib/core/sign-in.d.ts

@@ -1,5 +1,18 @@
 import { Prompt } from '../consts/index.js';
-import type { InteractionMode } from '../types/index.js';
+import type { FirstScreen, InteractionMode } from '../types/index.js';
+/** @experimental Don't use this type as it's under development. */
+export type DirectSignInOptions = {
+    /**
+     * The method to be used for the direct sign-in.
+     */
+    method: 'social';
+    /**
+     * The target to be used for the direct sign-in.
+     *
+     * - For `method: 'social'`, it should be the social connector target.
+     */
+    target: string;
+};
 export type SignInUriParameters = {
     authorizationEndpoint: string;
     clientId: string;
@@ -9,7 +22,30 @@ export type SignInUriParameters = {
     scopes?: string[];
     resources?: string[];
     prompt?: Prompt | Prompt[];
+    /**
+     * The first screen to be shown in the sign-in experience.
+     *
+     * @experimental Don't use this field as it's under development.
+     */
+    firstScreen?: FirstScreen;
+    /** The first screen to be shown in the sign-in experience. */
     interactionMode?: InteractionMode;
+    /**
+     * Login hint indicates the current user (usually an email address or a phone number).
+     *
+     * @experimental Don't use this field as it's under development.
+     */
     loginHint?: string;
+    /**
+     * Parameters for direct sign-in.
+     *
+     * @experimental Don't use this field as it's under development.
+     */
+    directSignIn?: DirectSignInOptions;
+    /**
+     * Extra parameters for the authentication request. Note that the parameters should be supported
+     * by the authorization server.
+     */
+    extraParams?: Record<string, string>;
 };
-export declare const generateSignInUri: ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes, resources, prompt, interactionMode, loginHint, }: SignInUriParameters) => string;
+export declare const generateSignInUri: ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, }: SignInUriParameters) => string;

package/lib/core/sign-in.js

@@ -9,7 +9,7 @@ const buildPrompt = (prompt) => {
     }
     return prompt ?? Prompt.Consent;
 };
-const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes, resources, prompt, interactionMode, loginHint, }) => {
+const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeChallenge, state, scopes, resources, prompt, firstScreen, interactionMode, loginHint, directSignIn, extraParams, }) => {
     const urlSearchParameters = new URLSearchParams({
         [QueryKey.ClientId]: clientId,
         [QueryKey.RedirectUri]: redirectUri,
@@ -19,15 +19,22 @@ const generateSignInUri = ({ authorizationEndpoint, clientId, redirectUri, codeC
         [QueryKey.ResponseType]: responseType,
         [QueryKey.Prompt]: buildPrompt(prompt),
         [QueryKey.Scope]: withDefaultScopes(scopes),
+        ...extraParams,
     });
     if (loginHint) {
         urlSearchParameters.append(QueryKey.LoginHint, loginHint);
     }
+    if (directSignIn) {
+        urlSearchParameters.append(QueryKey.DirectSignIn, `${directSignIn.method}:${directSignIn.target}`);
+    }
     for (const resource of resources ?? []) {
         urlSearchParameters.append(QueryKey.Resource, resource);
     }
-    // Set interactionMode to signUp for a create account user experience
-    if (interactionMode) {
+    if (firstScreen) {
+        urlSearchParameters.append(QueryKey.FirstScreen, firstScreen);
+    }
+    // @deprecated Remove later
+    else if (interactionMode) {
         urlSearchParameters.append(QueryKey.InteractionMode, interactionMode);
     }
     return `${authorizationEndpoint}?${urlSearchParameters.toString()}`;

package/lib/types/index.d.ts

@@ -15,3 +15,10 @@ export type Requester = <T>(...args: Parameters<typeof fetch>) => Promise<T>;
  * - `signUp`: The authorization request will be initiated with a sign-up page.
  */
 export type InteractionMode = 'signIn' | 'signUp';
+/**
+ * The first screen to be shown in the sign-in experience. Note it's not a part of the OIDC
+ * standard, but a Logto-specific extension.
+ *
+ * @experimental Don't use this type as it's under development.
+ */
+export type FirstScreen = 'signIn' | 'register';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logto/js",
-  "version": "4.0.1",
+  "version": "4.1.1",
   "type": "module",
   "main": "./lib/index.cjs",
   "module": "./lib/index.js",