@junobuild/core-peer 3.0.1 → 3.1.0

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

@@ -1,7 +1,6 @@
 import { type AuthClient } from '@icp-sdk/auth/client';
 import { type AuthClientSignInOptions } from '../types/auth-client';
-import type { Provider } from '../types/provider';
-import type { AuthProvider } from './_auth.providers';
+import type { ProviderWithoutData } from '../types/provider';
 /**
  * Options for signing in with an authentication provider.
  * @interface AuthProviderSignInOptions
@@ -21,9 +20,8 @@ export interface AuthProviderSignInOptions {
  *
  * @abstract
  * @class AuthClientProvider
- * @implements {AuthProvider}
  */
-export declare abstract class AuthClientProvider implements AuthProvider {
+export declare abstract class AuthClientProvider {
     #private;
     /**
      * The unique identifier of the provider.
@@ -31,7 +29,7 @@ export declare abstract class AuthClientProvider implements AuthProvider {
      * @abstract
      * @type {Provider}
      */
-    abstract get id(): Provider;
+    abstract get id(): ProviderWithoutData;
     /**
      * Returns the sign-in options for the provider.
      *
@@ -59,7 +57,7 @@ export declare abstract class AuthClientProvider implements AuthProvider {
         options?: AuthClientSignInOptions;
         authClient: AuthClient | undefined | null;
         initAuth: (params: {
-            provider: Provider;
+            provider: ProviderWithoutData;
         }) => Promise<void>;
     }): Promise<void>;
 }

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

@@ -1,12 +1,5 @@
 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;
+export declare class GoogleProvider {
     /**
      * Initiates a Google sign-in flow.
      *

package/dist/types/auth/providers/internet-identity.providers.d.ts

@@ -1,11 +1,10 @@
 import type { AuthClientSignInOptions } from '../types/auth-client';
 import type { InternetIdentityConfig } from '../types/internet-identity';
-import type { Provider } from '../types/provider';
+import type { ProviderWithoutData } from '../types/provider';
 import { AuthClientProvider, type AuthProviderSignInOptions } from './_auth-client.providers';
 /**
  * Internet Identity authentication provider.
  * @class InternetIdentityProvider
- * @implements {AuthProvider}
  */
 export declare class InternetIdentityProvider extends AuthClientProvider {
     #private;
@@ -18,7 +17,7 @@ export declare class InternetIdentityProvider extends AuthClientProvider {
      * Gets the identifier of the provider.
      * @returns {Provider} The identifier of the provider - `internet_identity`.
      */
-    get id(): Provider;
+    get id(): ProviderWithoutData;
     /**
      * Gets the sign-in options for Internet Identity.
      * @param {Pick<SignInOptions, 'windowed'>} options - The sign-in options.

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

@@ -1,14 +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.providers';
-export declare class WebAuthnProvider implements AuthProvider {
+export declare class WebAuthnProvider {
     #private;
-    /**
-     * Gets the identifier of the provider.
-     * @returns {Provider} The identifier of the provider is webauthn.
-     */
-    get id(): Provider;
     /**
      * Signs up a user by creating a new passkey.
      *

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

@@ -1,8 +1,8 @@
-import type { Provider } from '../types/provider';
+import type { ProviderWithoutData } from '../types/provider';
 import type { User } from '../types/user';
 type UserId = string;
 export declare const initUser: ({ provider }: {
-    provider: Provider;
+    provider: ProviderWithoutData;
 }) => Promise<User>;
 export declare const loadUser: () => Promise<{
     userId: UserId;

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

@@ -1,5 +1,5 @@
 import type { SignInOptions } from '../types/auth';
-import type { Provider } from '../types/provider';
+import type { ProviderWithoutData } from '../types/provider';
 /**
  * Initialize the authClient, load or create a new user.
  * Executed on sign-in.
@@ -7,7 +7,7 @@ import type { Provider } from '../types/provider';
  * ℹ️ Exposed for testing purpose only.
  */
 export declare const createAuth: ({ provider }: {
-    provider: Provider;
+    provider: ProviderWithoutData;
 }) => Promise<void>;
 /**
  * Signs in a user with the specified options.

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

@@ -7,6 +7,10 @@ export type DeprecatedNfid = 'nfid';
  * @typedef {('internet_identity' | 'nfid' | 'webauthn' | 'google')} Provider
  */
 export type Provider = 'internet_identity' | DeprecatedNfid | 'webauthn' | 'google';
+/**
+ * Subset of authentication providers that do not include any provider-specific metadata.
+ */
+export type ProviderWithoutData = Extract<Provider, 'internet_identity' | DeprecatedNfid> | undefined;
 /**
  * Metadata for WebAuthn authentication.
  * @interface ProviderDataWebAuthn
@@ -51,12 +55,16 @@ export interface ProviderDataOpenId {
     locale?: string;
 }
 /**
- * Container for provider-specific metadata.
+ * Metadata associated with a given authentication provider.
+ *
+ * For example:
+ * - `'webauthn'` → WebAuthn attestation details
+ * - `'openid'` → OpenID profile information (e.g. Google)
  *
- * @typedef {({ webauthn: ProviderDataWebAuthn } | { openid: ProviderDataOpenId })} ProviderData
+ * Other providers have no associated metadata.
  */
-export type ProviderData = {
+export type ProviderData<P extends 'webauthn' | 'openid'> = P extends 'webauthn' ? {
     webauthn: ProviderDataWebAuthn;
-} | {
+} : P extends 'openid' ? {
     openid: ProviderDataOpenId;
-};
+} : never;

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

@@ -1,23 +1,51 @@
 import type { Doc } from '../../datastore/types/doc';
-import type { Provider, ProviderData } from './provider';
+import type { DeprecatedNfid, Provider, ProviderData, ProviderWithoutData } from './provider';
 /**
- * Interface representing user data.
- * @interface UserData
+ * All supported authentication providers, plus `undefined` for providers
+ * that do not include any associated metadata (see {@link ProviderWithoutData}).
  */
-export interface UserData {
+export type UserProvider = Provider | undefined;
+/**
+ * Data about the signed-in user.
+ *
+ * Resolves to the appropriate structure based on the provider:
+ * - `webauthn` → includes WebAuthn metadata.
+ * - `google` → includes OpenID profile metadata.
+ * - `internet_identity` / `nfid` / `undefined` → no provider-specific metadata.
+ *
+ * @template P Authentication provider (defaults to all).
+ */
+export type UserData<P extends UserProvider = UserProvider> = P extends 'webauthn' ? {
+    /**
+     * Sign-in via WebAuthn.
+     */
+    provider: 'webauthn';
+    providerData: ProviderData<'webauthn'>;
+} : P extends 'google' ? {
     /**
-     * The potential provider used to sign-in. There is no absolute guarantee that the information can be set by the browser during the sign-in flow, therefore it is optional.
-     * @type {Provider}
+     * Sign-in via Google.
      */
-    provider?: Provider;
+    provider: 'google';
+    providerData: ProviderData<'openid'>;
+} : {
     /**
-     * The optional provider-specific metadata. This is only set if the frontend was able to supply it during the sign-in flow.
-     * @type {ProviderData}
+     * Sign-in via another provider. There is no absolute guarantee that the information can be set by the browser
+     * during the sign-in flow, therefore it is optional.
      */
-    providerData?: ProviderData;
-}
+    provider?: 'internet_identity' | DeprecatedNfid | undefined;
+    providerData?: never;
+};
+/**
+ *  A simplified version of {@link UserData} for users signed in with providers
+ *  that don't include any extra metadata.
+ */
+export type UserDataWithoutProviderData<P extends UserProvider = UserProvider> = Extract<UserData<P>, {
+    provider?: ProviderWithoutData;
+}>;
 /**
- * Type representing a user document.
- * @typedef {Doc<UserData>} User
+ * Represents a user's profile, including authentication provider
+ * and any associated metadata.
+ *
+ * @template P Authentication provider (defaults to all).
  */
-export type User = Doc<UserData>;
+export type User<P extends UserProvider = UserProvider> = Doc<UserData<P>>;

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

@@ -0,0 +1,19 @@
+import type { User } from '../types/user';
+/**
+ * Checks whether a user signed in using WebAuthn.
+ *
+ * Acts as a type guard that narrows {@link User} to {@link User<'webauthn'>}.
+ *
+ * @param user - The user object to check.
+ * @returns True if the user signed in via WebAuthn.
+ */
+export declare const isWebAuthnUser: (user: User) => user is User<"webauthn">;
+/**
+ * Checks whether a user signed in using Google (OpenID).
+ *
+ * Acts as a type guard that narrows {@link User} to {@link User<'google'>}.
+ *
+ * @param user - The user object to check.
+ * @returns True if the user signed in via Google.
+ */
+export declare const isGoogleUser: (user: User) => user is User<"google">;

package/dist/types/index.d.ts

@@ -16,6 +16,7 @@ export type * from './auth/types/progress';
 export type * from './auth/types/provider';
 export type * from './auth/types/user';
 export * from './auth/types/webauthn';
+export * from './auth/utils/user.utils';
 export type * from './core/types/env';
 export { ListOrder, ListPaginate, ListParams, ListResults } from './core/types/list';
 export type * from './core/types/satellite';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@junobuild/core-peer",
-  "version": "3.0.1",
-  "description": "JavaScript core client for Juno minus DFINITY agent-js dependencies",
+  "version": "3.1.0",
+  "description": "JavaScript core client for Juno (deprecated, use @junobuild/core)",
   "author": "David Dal Busco (https://daviddalbusco.com)",
   "license": "MIT",
   "type": "module",

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

@@ -1,11 +0,0 @@
-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;
-}