@qlover/oauth-wrapper 0.2.1 → 0.2.3

package/dist/client.cjs

@@ -300,6 +300,7 @@ var OAuthGateway = class {
   constructor(options) {
     this.options = options;
   }
+  options;
   callbackInflight = /* @__PURE__ */ new Map();
   get localeOptions() {
     return {
@@ -742,7 +743,8 @@ var OAuthClient = class {
       locale: this.config.locale,
       redirectUri,
       statePreview: `${state.slice(0, 8)}\u2026`,
-      pkceSaved: this.pkceStore.loadPkceSession() != null
+      pkceSaved: this.pkceStore.loadPkceSession() != null,
+      authorizeUrl: url
     });
     if (params?.target === "_blank") {
       window.open(url, "_blank", "noopener,noreferrer");

package/dist/client.d.ts

@@ -296,7 +296,7 @@ declare class OAuthClient<T extends OAuthUserInfo = OAuthUserInfo> implements OA
     /**
      * @override
      */
-    startOAuthLogin(params?: OAuthGatewayAuthorizeParams): Promise<void>;
+    startOAuthLogin(params?: Partial<OAuthGatewayAuthorizeParams>): Promise<void>;
     completeOAuthCallback(params?: Parameters<OAuthGateway<T>['oAuthWrapperCallback']>[0]): Promise<T>;
     parseOAuthCallbackSearchParams(searchParams: URLSearchParams): Parameters<OAuthGateway<T>['oAuthWrapperCallback']>[0];
     /**

package/dist/client.js

@@ -257,6 +257,7 @@ var OAuthGateway = class {
   constructor(options) {
     this.options = options;
   }
+  options;
   callbackInflight = /* @__PURE__ */ new Map();
   get localeOptions() {
     return {
@@ -699,7 +700,8 @@ var OAuthClient = class {
       locale: this.config.locale,
       redirectUri,
       statePreview: `${state.slice(0, 8)}\u2026`,
-      pkceSaved: this.pkceStore.loadPkceSession() != null
+      pkceSaved: this.pkceStore.loadPkceSession() != null,
+      authorizeUrl: url
     });
     if (params?.target === "_blank") {
       window.open(url, "_blank", "noopener,noreferrer");

package/dist/core.cjs

@@ -186,12 +186,12 @@ var OAuthTokenResponseSchema = import_zod2.z.object({
 var import_zod3 = require("zod");
 var OAuthUserInfoResponseSchema = import_zod3.z.object({
   sub: import_zod3.z.string(),
-  email: import_zod3.z.string().email(),
+  email: import_zod3.z.email(),
   name: import_zod3.z.string(),
   roles: import_zod3.z.array(import_zod3.z.string()).optional()
 });
 var OAuthUserInfoErrorResponseSchema = import_zod3.z.object({
-  error: import_zod3.z.literal("invalid_token"),
+  error: import_zod3.z.string(),
   error_id: import_zod3.z.string().optional()
 });
 

package/dist/core.d.ts

@@ -200,104 +200,6 @@ declare const OAuthTokenRevokeSchema: z.ZodObject<{
 }, z.core.$strip>;
 type OAuthTokenRevokeRequest = z.infer<typeof OAuthTokenRevokeSchema>;
 
-/**
- * OAuth user adapter profile shape.
- *
- * Significance: Keeps OAuth services independent from provider SDK user models.
- * Core idea: Represent only the profile fields required by OAuth login and userinfo.
- * Main function: Provide a canonical user profile contract for adapters.
- * Main purpose: Let the OAuth wrapper switch user providers without changing services.
- *
- * @example
- * const sub = String(profile.id);
- */
-type OAuthUserProfile = {
-    id: string | number;
-    email?: string | null;
-    name?: string | null;
-    first_name?: string | null;
-    last_name?: string | null;
-    roles?: string[];
-    [key: string]: unknown;
-};
-/**
- * OAuth provider login credentials result.
- *
- * Significance: Normalizes provider login responses for middleware sessions.
- * Core idea: Require a session token while allowing provider-specific metadata.
- * Main function: Carry the provider session token after credential verification.
- * Main purpose: Persist the token needed to mint OAuth access tokens later.
- *
- * @example
- * const sessionToken = credentials.token;
- */
-type OAuthUserCredentials = {
-    token: string;
-    [key: string]: unknown;
-};
-/**
- * OAuth provider access token result.
- *
- * Significance: Normalizes provider token exchange responses.
- * Core idea: OAuth token services only need access, expiry, and optional refresh token.
- * Main function: Return a provider access token for third-party OAuth clients.
- * Main purpose: Hide provider SDK response details behind the adapter contract.
- *
- * @example
- * return { access_token: token.access_token, expires_in: token.expires_in };
- */
-type OAuthUserAccessToken = {
-    access_token: string;
-    expires_in: number;
-    refresh_token?: string | null;
-    [key: string]: unknown;
-};
-/**
- * User adapter contract for the OAuth wrapper.
- *
- * Significance: Defines the boundary between OAuth core services and user providers.
- * Core idea: Keep provider-specific login, token exchange, and profile lookup behind one port.
- * Main function: Verify credentials, exchange provider tokens, and load user profiles.
- * Main purpose: Allow any upstream user API to be swapped without changing OAuth services.
- *
- * @example
- * const access = await adapter.exchangeAccessToken({ token: sessionToken });
- */
-interface OAuthUserAdapterInterface {
-    /**
-     * Verifies user credentials with the backing user provider.
-     *
-     * @param email - User email or username accepted by the provider.
-     * @param password - Plain credential submitted by the login form.
-     * @returns Provider credentials containing a session token.
-     */
-    login(params: LoginParams): Promise<OAuthUserCredentials>;
-    /**
-     * Exchanges a provider session token for a provider access token.
-     *
-     * @param params - Session token and optional language preference.
-     * @returns Provider access token payload used as the OAuth access token response.
-     */
-    exchangeAccessToken(params: {
-        token: string;
-        lang?: string;
-    }): Promise<OAuthUserAccessToken>;
-    /**
-     * Loads profile information using a provider session token.
-     *
-     * @param sessionToken - Provider session token from a successful login.
-     * @returns Canonical user profile for session creation.
-     */
-    getUserInfo(sessionToken: string): Promise<OAuthUserProfile>;
-    /**
-     * Loads profile information using a provider access token.
-     *
-     * @param accessToken - Bearer access token presented to the userinfo endpoint.
-     * @returns Canonical user profile for OIDC userinfo claims.
-     */
-    getUserInfoByAccessToken(accessToken: string): Promise<OAuthUserProfile>;
-}
-
 declare const OAuthUserCredentialsSchema: z.ZodObject<{
     user_id: z.ZodString;
     provider_refresh_token: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -365,13 +267,13 @@ interface OAuthWrapperRepositoryInterface extends OAuthClientsRepositoryInterfac
 
 declare const OAuthUserInfoResponseSchema: z.ZodObject<{
     sub: z.ZodString;
-    email: z.ZodString;
+    email: z.ZodEmail;
     name: z.ZodString;
     roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type OAuthUserInfoResponse = z.infer<typeof OAuthUserInfoResponseSchema>;
 declare const OAuthUserInfoErrorResponseSchema: z.ZodObject<{
-    error: z.ZodLiteral<"invalid_token">;
+    error: z.ZodString;
     error_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type OAuthUserInfoErrorResponse = z.infer<typeof OAuthUserInfoErrorResponseSchema>;
@@ -415,25 +317,40 @@ interface OAuthTokenServiceInterface {
      */
     revokeToken(rawFields: Record<string, string>): Promise<void>;
 }
-interface OAuthServiceInterface<SessionPayload extends OAuthSessionPayload> extends OAuthTokenServiceInterface {
-    resolveAuthorizePage(rawQuery: Record<string, string | string[] | undefined>): Promise<{
-        ok: true;
-        data: OAuthAuthorizePageData;
-    } | {
-        ok: false;
-        error: OAuthAuthorizeValidationError;
-    }>;
-    processConsent(requestBody: unknown): Promise<OAuthConsentResult>;
-    getUserInfo(accessToken: string): Promise<OAuthUserInfoResponse>;
-    getOAuthSession(): OAuthSessionInterface<SessionPayload>;
-    getOAuthAdapter(): OAuthUserAdapterInterface;
-    getOAuthTokenService(): OAuthTokenServiceInterface;
+type ResolveAuthorizePageResult = {
+    ok: true;
+    data: OAuthAuthorizePageData;
+} | {
+    ok: false;
+    error: OAuthAuthorizeValidationError;
+};
+interface OAuthProviderInterface<SessionPayload extends OAuthSessionPayload> extends OAuthTokenServiceInterface {
+    login(params: LoginParams): Promise<SessionPayload>;
+    /**
+     * Get the OAuth repository
+     */
     getOAuthRepo(): OAuthWrapperRepositoryInterface;
     /**
-     * Application logout: revoke issued refresh tokens, clear stored provider
-     * credentials, and clear the authorization-server session cookie.
+     * Clear the session
+     */
+    clearSession(): Promise<void>;
+    /**
+     * Get the session
+     */
+    getSession(): Promise<SessionPayload | null>;
+    /**
+     * Logout the user
+     */
+    logout(userId: string): Promise<void>;
+    /**
+     * Resolve the authorize page
      */
-    logoutUser(userId: string): Promise<void>;
+    resolveAuthorizePage(rawQuery: Record<string, string | string[] | undefined>): Promise<ResolveAuthorizePageResult>;
+    /**
+     * Process the consent
+     */
+    processConsent(requestBody: unknown): Promise<OAuthConsentResult>;
+    getUserInfoWithAccessToken(accessToken: string): Promise<OAuthUserInfoResponse>;
 }
 
 declare const OAuthRfcCodes: {
@@ -458,4 +375,4 @@ declare function generatePkceVerifier(length?: number): string;
 declare function computePkceS256Challenge(verifier: string): Promise<string>;
 declare function randomOAuthState(): string;
 
-export { type CreateAuthorizationCodeInput, type CreateOAuthRefreshTokenInput, type OAuthAuthorizationCodeRow, OAuthAuthorizationCodeRowSchema, type OAuthAuthorizePageData, type OAuthAuthorizeQuery, OAuthAuthorizeQuerySchema, type OAuthAuthorizeValidationError, type OAuthClientCreate, type OAuthClientCreateResponse, OAuthClientCreateResponseSchema, OAuthClientCreateSchema, type OAuthClientDetail, OAuthClientDetailSchema, type OAuthClientListItem, OAuthClientListItemSchema, type OAuthClientRow, OAuthClientRowSchema, type OAuthClientSecretRotateResponse, OAuthClientSecretRotateResponseSchema, type OAuthClientUpdate, OAuthClientUpdateSchema, type OAuthClientsInterface, type OAuthClientsRepositoryInterface, type OAuthConsentBody, OAuthConsentBodySchema, type OAuthConsentResult, type OAuthRefreshTokenRow, OAuthRefreshTokenSchema, type OAuthRfcCodeType, OAuthRfcCodes, type OAuthRfcErrorCodesType, type OAuthServiceInterface, type OAuthSessionInterface, type OAuthSessionPayload, type OAuthTokenAuthorizationCodeRequest, OAuthTokenAuthorizationCodeSchema, type OAuthTokenErrorResponse, OAuthTokenErrorResponseSchema, type OAuthTokenRefreshRequest, OAuthTokenRefreshSchema, type OAuthTokenRequest, OAuthTokenRequestSchema, type OAuthTokenResponse, OAuthTokenResponseSchema, type OAuthTokenRevokeRequest, OAuthTokenRevokeSchema, type OAuthTokenServiceInterface, type OAuthUserAccessToken, type OAuthUserAdapterInterface, type OAuthUserCredentials, type OAuthUserCredentialsRow, OAuthUserCredentialsSchema, type OAuthUserInfoErrorResponse, OAuthUserInfoErrorResponseSchema, type OAuthUserInfoResponse, OAuthUserInfoResponseSchema, type OAuthUserProfile, type OAuthWrapperRepositoryInterface, computePkceS256Challenge, generatePkceVerifier, isOAuthRedirectUri, randomOAuthState };
+export { type CreateAuthorizationCodeInput, type CreateOAuthRefreshTokenInput, type OAuthAuthorizationCodeRow, OAuthAuthorizationCodeRowSchema, type OAuthAuthorizePageData, type OAuthAuthorizeQuery, OAuthAuthorizeQuerySchema, type OAuthAuthorizeValidationError, type OAuthClientCreate, type OAuthClientCreateResponse, OAuthClientCreateResponseSchema, OAuthClientCreateSchema, type OAuthClientDetail, OAuthClientDetailSchema, type OAuthClientListItem, OAuthClientListItemSchema, type OAuthClientRow, OAuthClientRowSchema, type OAuthClientSecretRotateResponse, OAuthClientSecretRotateResponseSchema, type OAuthClientUpdate, OAuthClientUpdateSchema, type OAuthClientsInterface, type OAuthClientsRepositoryInterface, type OAuthConsentBody, OAuthConsentBodySchema, type OAuthConsentResult, type OAuthProviderInterface, type OAuthRefreshTokenRow, OAuthRefreshTokenSchema, type OAuthRfcCodeType, OAuthRfcCodes, type OAuthRfcErrorCodesType, type OAuthSessionInterface, type OAuthSessionPayload, type OAuthTokenAuthorizationCodeRequest, OAuthTokenAuthorizationCodeSchema, type OAuthTokenErrorResponse, OAuthTokenErrorResponseSchema, type OAuthTokenRefreshRequest, OAuthTokenRefreshSchema, type OAuthTokenRequest, OAuthTokenRequestSchema, type OAuthTokenResponse, OAuthTokenResponseSchema, type OAuthTokenRevokeRequest, OAuthTokenRevokeSchema, type OAuthTokenServiceInterface, type OAuthUserCredentialsRow, OAuthUserCredentialsSchema, type OAuthUserInfoErrorResponse, OAuthUserInfoErrorResponseSchema, type OAuthUserInfoResponse, OAuthUserInfoResponseSchema, type OAuthWrapperRepositoryInterface, type ResolveAuthorizePageResult, computePkceS256Challenge, generatePkceVerifier, isOAuthRedirectUri, randomOAuthState };

package/dist/core.js

@@ -136,12 +136,12 @@ var OAuthTokenResponseSchema = z2.object({
 import { z as z3 } from "zod";
 var OAuthUserInfoResponseSchema = z3.object({
   sub: z3.string(),
-  email: z3.string().email(),
+  email: z3.email(),
   name: z3.string(),
   roles: z3.array(z3.string()).optional()
 });
 var OAuthUserInfoErrorResponseSchema = z3.object({
-  error: z3.literal("invalid_token"),
+  error: z3.string(),
   error_id: z3.string().optional()
 });