@junobuild/core-standalone 2.2.1 → 3.0.1

package/dist/types/auth/providers/_auth-client.providers.d.ts

@@ -1,16 +1,7 @@
-import { type AuthClient } from '@dfinity/auth-client';
+import { type AuthClient } from '@icp-sdk/auth/client';
 import { type AuthClientSignInOptions } from '../types/auth-client';
 import type { Provider } from '../types/provider';
-/**
- * Common traits for all authentication providers
- * @interface AuthProvider
- */
-export interface AuthProvider {
-    /**
-     * The unique identifier of the provider.
-     */
-    readonly id: Provider;
-}
+import type { AuthProvider } from './_auth.providers';
 /**
  * Options for signing in with an authentication provider.
  * @interface AuthProviderSignInOptions
@@ -26,7 +17,7 @@ export interface AuthProviderSignInOptions {
     windowOpenerFeatures?: string;
 }
 /**
- * Abstract base class for all authentication providers that integrate with the `@dfinity/auth-client`.
+ * Abstract base class for all authentication providers that integrate with the `@icp-sdk/auth/client`.
  *
  * @abstract
  * @class AuthClientProvider

package/dist/types/auth/providers/_auth.providers.d.ts

@@ -0,0 +1,11 @@
+import type { Provider } from '../types/provider';
+/**
+ * Common traits for all authentication providers
+ * @interface AuthProvider
+ */
+export interface AuthProvider {
+    /**
+     * The unique identifier of the provider.
+     */
+    readonly id: Provider;
+}

package/dist/types/auth/providers/google.providers.d.ts

@@ -0,0 +1,25 @@
+import type { GoogleSignInRedirectOptions } from '../types/google';
+import type { Provider } from '../types/provider';
+import type { AuthProvider } from './_auth.providers';
+export declare class GoogleProvider implements AuthProvider {
+    /**
+     * Gets the identifier of the provider.
+     * @returns {Provider} The identifier of the provider is google.
+     */
+    get id(): Provider;
+    /**
+     * Initiates a Google sign-in flow.
+     *
+     * Depending on the environment or configuration, this may redirect the user
+     * to Google's authentication screen or trigger a browser-native sign-in flow
+     * (such as FedCM in the future).
+     *
+     * @param {Object} params - Parameters for the sign-in request.
+     * @param {GoogleSignInRedirectOptions} [params.options] - Optional configuration for the sign-in request.
+     *
+     * @returns {Promise<void>} Resolves once the sign-in flow has been initiated.
+     */
+    signIn({ options }: {
+        options?: GoogleSignInRedirectOptions;
+    }): Promise<void>;
+}

package/dist/types/auth/providers/webauthn.providers.d.ts

@@ -1,7 +1,7 @@
 import type { Provider } from '../types/provider';
 import type { User } from '../types/user';
 import { type WebAuthnSignInOptions, type WebAuthnSignUpOptions } from '../types/webauthn';
-import type { AuthProvider } from './_auth-client.providers';
+import type { AuthProvider } from './_auth.providers';
 export declare class WebAuthnProvider implements AuthProvider {
     #private;
     /**

package/dist/types/auth/services/_auth-client.services.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Initializes a new `AuthClient`, checks authentication state,
+ * and executes the provided function if already authenticated.
+ *
+ * - Always creates a fresh `AuthClient` using {@link createAuthClient}.
+ * - If the client is **not authenticated**, it resets the client via {@link safeCreateAuthClient}
+ *   to ensure a clean session.
+ * - If authenticated, it runs the given async function `fn`.
+ *
+ * @param {Object} params
+ * @param {() => Promise<void>} params.fn - The asynchronous function to execute when authenticated.
+ *
+ * @returns {Promise<void>} Resolves when authentication is handled and the provided function is executed (if applicable).
+ */
+export declare const authenticateWithAuthClient: ({ fn }: {
+    fn: () => Promise<void>;
+}) => Promise<void>;

package/dist/types/auth/services/identity.services.d.ts

@@ -0,0 +1,22 @@
+import type { Identity } from '@icp-sdk/core/agent';
+export declare const getIdentity: () => Identity | undefined;
+/**
+ * Returns the identity of a signed-in user or an anonymous identity.
+ * This function is useful for loading an identity in web workers.
+ * Used to imperatively get the identity. Please be certain before using it.
+ * @returns {Promise<Identity>} A promise that resolves to the identity of the user or an anonymous identity.
+ */
+export declare const unsafeIdentity: () => Promise<Identity>;
+/**
+ * Returns the current identity if the user is authenticated.
+ *
+ * ⚠️ Use this function imperatively only. Do **not** persist the identity in global state.
+ * It is intended for short-lived or one-time operations.
+ *
+ * Typical use case is to enable developers to implement custom features for the Internet Computer:
+ * - Passing the identity to temporarily create an actor or agent to call a canister
+ * - Signing a message or making a one-time authenticated call
+ *
+ * @returns The authenticated identity, or null if unavailable.
+ */
+export declare const getIdentityOnce: () => Promise<Identity | null>;

package/dist/types/auth/services/load.services.d.ts

@@ -0,0 +1,13 @@
+import type { User } from '../types/user';
+/**
+ * Initialize the authClient and load the existing user.
+ * Executed when the library is initialized through initSatellite.
+ */
+export declare const loadAuth: () => Promise<void>;
+/**
+ * Initialize the authClient, load the user passed as parameter.
+ * Executed on sign-up.
+ */
+export declare const loadAuthWithUser: ({ user }: {
+    user: User;
+}) => Promise<void>;

package/dist/types/auth/services/redirect.services.d.ts

@@ -0,0 +1 @@
+export declare const handleRedirectCallback: () => Promise<void>;

package/dist/types/auth/services/sign-in.services.d.ts

@@ -0,0 +1,19 @@
+import type { SignInOptions } from '../types/auth';
+import type { Provider } from '../types/provider';
+/**
+ * Initialize the authClient, load or create a new user.
+ * Executed on sign-in.
+ *
+ * ℹ️ Exposed for testing purpose only.
+ */
+export declare const createAuth: ({ provider }: {
+    provider: Provider;
+}) => Promise<void>;
+/**
+ * Signs in a user with the specified options.
+ *
+ * @default Signs in by default with Internet Identity
+ * @param {SignInOptions} [options] - The options for signing in including the provider to use for the process.
+ * @returns {Promise<void>} A promise that resolves when the sign-in process is complete and the authenticated user is initialized.
+ */
+export declare const signIn: (options: SignInOptions) => Promise<void>;

package/dist/types/auth/services/sign-out.services.d.ts

@@ -0,0 +1,10 @@
+import type { SignOutOptions } from '../types/auth';
+/**
+ * Signs out the current user.
+ * @returns {Promise<void>} A promise that resolves when the sign-out process is complete.
+ */
+export declare const signOut: (options?: SignOutOptions) => Promise<void>;
+/**
+ * ℹ️ Exposed for testing purpose only. Should not be leaked to consumer or used by the library.
+ */
+export declare const resetAuth: () => Promise<void>;

package/dist/types/auth/services/sign-up.services.d.ts

@@ -0,0 +1,8 @@
+import type { SignUpOptions } from '../types/auth';
+/**
+ * Signs up to create a new user with the specified options.
+ *
+ * @param {SignUpOptions} [options] - The options for signing up including the provider to use for the process.
+ * @returns {Promise<void>} A promise that resolves when the sign-up process is complete and the user is authenticated.
+ */
+export declare const signUp: (options: SignUpOptions) => Promise<void>;

package/dist/types/auth/services/user-webauthn.services.d.ts

@@ -1,4 +1,4 @@
-import type { Identity } from '@dfinity/agent';
+import type { Identity } from '@icp-sdk/core/agent';
 import type { WebAuthnIdentity, WebAuthnNewCredential } from '@junobuild/ic-client/webauthn';
 import type { Environment } from '../../core/types/env';
 import type { User } from '../types/user';

package/dist/types/auth/stores/auth-client.store.d.ts

@@ -0,0 +1,15 @@
+import { AuthClient } from '@icp-sdk/auth/client';
+import type { DelegationChain, ECDSAKeyIdentity } from '@icp-sdk/core/identity';
+export declare class AuthClientStore {
+    #private;
+    private constructor();
+    static getInstance(): AuthClientStore;
+    createAuthClient: () => Promise<AuthClient>;
+    safeCreateAuthClient: () => Promise<AuthClient>;
+    getAuthClient: () => AuthClient | undefined | null;
+    logout: () => Promise<void>;
+    setAuthClientStorage: ({ delegationChain, sessionKey }: {
+        delegationChain: DelegationChain;
+        sessionKey: ECDSAKeyIdentity;
+    }) => Promise<void>;
+}

package/dist/types/auth/types/auth.d.ts

@@ -1,5 +1,5 @@
+import type { GoogleSignInRedirectOptions } from './google';
 import type { InternetIdentitySignInOptions } from './internet-identity';
-import type { NFIDSignInOptions } from './nfid';
 import type { WebAuthnSignInOptions, WebAuthnSignUpOptions } from './webauthn';
 /**
  * Options for the context of the sign-in flow.
@@ -16,20 +16,19 @@ export interface SignInContext {
     windowGuard?: boolean;
 }
 /**
- * The options for sign-in.
+ * Defines which provider to use for signing in and its associated options.
  *
- * - `internetIdentity`: Internet Identity options
- * - `nfid`: NFID options
- * - `webauthn`: WebAuthn/Passkey options
+ * - `google` — Google sign-in
+ * - `internet_identity` — Internet Identity
+ * - `webauthn` — WebAuthn/Passkeys
  */
 export type SignInOptions = {
-    internet_identity: {
-        options?: InternetIdentitySignInOptions;
-        context?: SignInContext;
+    google: {
+        options?: GoogleSignInRedirectOptions;
     };
 } | {
-    nfid: {
-        options: NFIDSignInOptions;
+    internet_identity: {
+        options?: InternetIdentitySignInOptions;
         context?: SignInContext;
     };
 } | {
@@ -39,9 +38,9 @@ export type SignInOptions = {
     };
 };
 /**
- * The options for sign-up.
+ * Defines which provider to use for signing up and its associated options.
  *
- * - `webauthn`: WebAuthn/Passkey options
+ * - `webauthn`: WebAuthn/Passkeys
  */
 export interface SignUpOptions {
     webauthn: {

package/dist/types/auth/types/errors.d.ts

@@ -6,6 +6,8 @@ export declare class SignInUserInterruptError extends Error {
 }
 export declare class SignInProviderNotSupportedError extends Error {
 }
+export declare class SignInMissingClientIdError extends Error {
+}
 export declare class WebAuthnSignInRetrievePublicKeyError extends Error {
 }
 export declare class SignUpProviderNotSupportedError extends Error {

package/dist/types/auth/types/google.d.ts

@@ -0,0 +1,50 @@
+export type AuthScope = 'openid' | 'profile' | 'email';
+/**
+ * Combination of OAuth scopes supported by Google.
+ *
+ * According to Google’s OpenID Connect documentation:
+ * The `scope` parameter must begin with `'openid'` and include `'profile'`, `'email'`, or both.
+ *
+ * - `'openid'` is always required.
+ * - `'profile'` and `'email'` are optional individually, but at least one must be included.
+ *
+ * @see https://developers.google.com/identity/openid-connect/openid-connect?utm_source=chatgpt.com#authenticationuriparameters
+ */
+export type GoogleAuthScopes = ['openid', 'profile'] | ['openid', 'email'] | ['openid', 'profile', 'email'];
+/**
+ * Sign-in options for the Google provider using a redirect flow.
+ * @interface GoogleSignInRedirectOptions
+ */
+export interface GoogleSignInRedirectOptions {
+    /**
+     * Redirect configuration.
+     */
+    redirect?: GoogleRedirectOptions;
+}
+/**
+ * Redirect options for Google sign-in.
+ */
+export interface GoogleRedirectOptions {
+    /**
+     * Google OAuth client ID.
+     * If omitted, the library attempts to read it from `juno.config`.
+     */
+    clientId?: string;
+    /**
+     * OAuth scopes to request.
+     * Must begin with `'openid'` and include `'profile'`, `'email'`, or both.
+     * @default ['openid', 'profile', 'email']
+     */
+    authScopes?: GoogleAuthScopes;
+    /**
+     * Redirect URL after authentication.
+     * @default window.location.origin
+     */
+    redirectUrl?: string;
+    /**
+     * Optional hint about which user is trying to sign in — usually an email address
+     * or a Google account ID. When provided, Google can potentially skip the account-picker
+     * screen or prefill the login form for a smoother sign-in experience.
+     */
+    loginHint?: string;
+}

package/dist/types/auth/types/provider.d.ts

@@ -1,8 +1,12 @@
 /**
- * Type representing the available authentication providers.
- * @typedef {('internet_identity' | 'nfid' | 'webauthn')} Provider
+ * @deprecated The support for `nfid` provider is deprecated.
  */
-export type Provider = 'internet_identity' | 'nfid' | 'webauthn';
+export type DeprecatedNfid = 'nfid';
+/**
+ * Type representing the authentication providers.
+ * @typedef {('internet_identity' | 'nfid' | 'webauthn' | 'google')} Provider
+ */
+export type Provider = 'internet_identity' | DeprecatedNfid | 'webauthn' | 'google';
 /**
  * Metadata for WebAuthn authentication.
  * @interface ProviderDataWebAuthn
@@ -17,16 +21,42 @@ export interface ProviderDataWebAuthn {
     aaguid: Uint8Array | number[];
 }
 /**
- * Container for provider-specific metadata.
- *
- * Currently only `webauthn` is supported, but this type
- * can be extended in the future.
- *
- * @interface ProviderData
+ * Metadata for OpenID (e.g. Google) authentication.
+ * @interface ProviderDataOpenId
  */
-export interface ProviderData {
+export interface ProviderDataOpenId {
     /**
-     * Metadata specific to WebAuthn (passkey) authentication.
+     * Email address of the authenticated user.
      */
-    webauthn: ProviderDataWebAuthn;
+    email?: string;
+    /**
+     * Full name of the authenticated user.
+     */
+    name?: string;
+    /**
+     * Given name of the authenticated user.
+     */
+    givenName?: string;
+    /**
+     * Family name of the authenticated user.
+     */
+    familyName?: string;
+    /**
+     * Profile picture URL of the authenticated user.
+     */
+    picture?: string;
+    /**
+     * Locale of the authenticated user.
+     */
+    locale?: string;
 }
+/**
+ * Container for provider-specific metadata.
+ *
+ * @typedef {({ webauthn: ProviderDataWebAuthn } | { openid: ProviderDataOpenId })} ProviderData
+ */
+export type ProviderData = {
+    webauthn: ProviderDataWebAuthn;
+} | {
+    openid: ProviderDataOpenId;
+};

package/dist/types/core/api/actor.api.d.ts

@@ -1,5 +1,5 @@
-import type { ActorMethod, ActorSubclass } from '@dfinity/agent';
-import type { IDL } from '@dfinity/candid';
+import type { ActorMethod, ActorSubclass } from '@icp-sdk/core/agent';
+import type { IDL } from '@icp-sdk/core/candid';
 import { type SatelliteActor } from '@junobuild/ic-client/actor';
 import type { CallOptions } from '../types/call-options';
 import type { SatelliteContext } from '../types/satellite';

package/dist/types/core/services/{identity.services.d.ts → any-identity.services.d.ts}

@@ -1,2 +1,2 @@
-import { type Identity } from '@dfinity/agent';
+import { type Identity } from '@icp-sdk/core/agent';
 export declare const getAnyIdentity: (identity?: Identity) => Identity;

package/dist/types/core/stores/_agent.factory.d.ts

@@ -1,4 +1,4 @@
-import { HttpAgent } from '@dfinity/agent';
+import { HttpAgent } from '@icp-sdk/core/agent';
 import type { SatelliteContext } from '../types/satellite';
 export type CreateAgentParams = Required<Pick<SatelliteContext, 'identity'>> & Pick<SatelliteContext, 'container'>;
 export declare const createAgent: ({ identity, container }: CreateAgentParams) => Promise<HttpAgent>;

package/dist/types/core/stores/actor.store.d.ts

@@ -1,5 +1,5 @@
-import { type ActorMethod, type ActorSubclass } from '@dfinity/agent';
-import type { IDL } from '@dfinity/candid';
+import { type ActorMethod, type ActorSubclass } from '@icp-sdk/core/agent';
+import type { IDL } from '@icp-sdk/core/candid';
 import type { ActorKey } from '../types/actor';
 import type { SatelliteContext } from '../types/satellite';
 type ActorParams = {

package/dist/types/core/stores/agent.store.d.ts

@@ -1,4 +1,4 @@
-import type { Agent } from '@dfinity/agent';
+import type { Agent } from '@icp-sdk/core/agent';
 import { type CreateAgentParams } from './_agent.factory';
 export declare class AgentStore {
     #private;

package/dist/types/core/types/list.d.ts

@@ -1,4 +1,4 @@
-import type { Principal } from '@dfinity/principal';
+import type { Principal } from '@icp-sdk/core/principal';
 /**
  * Represents the results of a list call.
  * @template T - The type of items in the list.

package/dist/types/core/types/satellite.d.ts

@@ -1,4 +1,4 @@
-import type { Identity } from '@dfinity/agent';
+import type { Identity } from '@icp-sdk/core/agent';
 /**
  * Configuration options for connecting to a satellite.
  * @interface

package/dist/types/core/types/utility.d.ts

@@ -1,3 +1,5 @@
-export type ExcludeDate<T> = {
-    [K in keyof T]: T[K] extends Date ? never : T[K] extends object ? ExcludeDate<T[K]> : T[K];
-};
+type Primitive = string | number | boolean | bigint | symbol | null | undefined;
+export type ExcludeDate<T> = T extends Date ? never : T extends (...args: any) => any ? T : T extends Primitive ? T : T extends Array<infer U> ? ExcludeDate<U>[] : T extends object ? {
+    [K in keyof T]: ExcludeDate<T[K]>;
+} : T;
+export {};

package/dist/types/core/utils/window.env.utils.d.ts

@@ -1,2 +1,3 @@
 export declare const envSatelliteId: () => string | undefined;
 export declare const envContainer: () => string | undefined;
+export declare const envGoogleClientId: () => string | undefined;

package/dist/types/functions/services/functions.services.d.ts

@@ -1,5 +1,5 @@
-import type { ActorMethod, ActorSubclass } from '@dfinity/agent';
-import type { IDL } from '@dfinity/candid';
+import type { ActorMethod, ActorSubclass } from '@icp-sdk/core/agent';
+import type { IDL } from '@icp-sdk/core/candid';
 import type { SatelliteOptions } from '../../core/types/satellite';
 /**
  * Returns an extended satellite actor instance using the provided IDL factory and satellite options.

package/dist/types/index.d.ts

@@ -4,8 +4,11 @@ import type { User } from './auth/types/user';
 import type { UserEnvironment } from './core/types/env';
 import type { Unsubscribe } from './core/types/subscription';
 export * from './auth/providers/internet-identity.providers';
-export * from './auth/providers/nfid.providers';
-export { getIdentityOnce, signIn, signOut, signUp, unsafeIdentity } from './auth/services/auth.services';
+export { getIdentityOnce, unsafeIdentity } from './auth/services/identity.services';
+export { handleRedirectCallback } from './auth/services/redirect.services';
+export { signIn } from './auth/services/sign-in.services';
+export { signOut } from './auth/services/sign-out.services';
+export { signUp } from './auth/services/sign-up.services';
 export type * from './auth/types/auth';
 export * from './auth/types/auth-client';
 export * from './auth/types/errors';
@@ -47,4 +50,3 @@ export declare const onAuthStateChange: (callback: (authUser: User | null) => vo
  */
 export declare const authSubscribe: (callback: (authUser: User | null) => void) => Unsubscribe;
 export { InternetIdentityConfig, InternetIdentityDomain } from './auth/types/internet-identity';
-export { NFIDConfig } from './auth/types/nfid';