feeef 0.5.38-dev.2 → 0.5.38-dev.4

package/build/src/feeef/repositories/transfers.d.ts

@@ -0,0 +1,38 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository } from './repository.js';
+/**
+ * Represents a transfer entity for double-entry accounting transactions
+ */
+export interface TransferEntity {
+    id: string;
+    debitAccountId: string;
+    creditAccountId: string;
+    amount: number;
+    type: 'deposit' | 'subscription' | 'points' | 'store_due' | 'user_transfer' | 'ai_generation' | 'refund' | 'adjustment';
+    referenceId?: string | null;
+    description?: string | null;
+    metadata: Record<string, any>;
+    createdAt: any;
+}
+/**
+ * Input data for creating a new transfer
+ */
+export interface TransferCreateInput {
+    debitAccountId: string;
+    creditAccountId: string;
+    amount: number;
+    type: TransferEntity['type'];
+    referenceId?: string | null;
+    description?: string | null;
+    metadata?: Record<string, any>;
+}
+/**
+ * Repository for managing transfer data
+ */
+export declare class TransferRepository extends ModelRepository<TransferEntity, TransferCreateInput, any> {
+    /**
+     * Constructs a new TransferRepository instance
+     * @param client - The AxiosInstance used for making HTTP requests
+     */
+    constructor(client: AxiosInstance);
+}

package/build/src/feeef/repositories/users.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from 'axios';
 import { ModelRepository } from './repository.js';
-import { AuthToken, UserEntity } from '../../core/entities/user.js';
+import { AccessToken, AuthToken, CreateUserOptions, FinishPasskeyAuthenticationOptions, FinishPasskeyRegistrationOptions, LinkSocialAccountOptions, Passkey, SigninCredentials, SigninWithSocialOptions, SignupCredentials, TransferMoneyOptions, TransferMoneyResponse, UpdateUserOptions, UserEntity, UserUpdate, StartPasskeyAuthenticationOptions, StartPasskeyRegistrationOptions } from '../../core/entities/user.js';
 /**
  * Represents the response returned by the authentication process.
  */
@@ -9,14 +9,23 @@ export interface AuthResponse {
     user: UserEntity;
 }
 /**
- * Represents a repository for managing user data.
- * Extends the ModelRepository class.
+ * Represents a repository for managing user data and authentication.
+ * Extends the ModelRepository class with authentication capabilities.
  */
-export declare class UserRepository extends ModelRepository<UserEntity, any, any> {
+export declare class UserRepository extends ModelRepository<UserEntity, CreateUserOptions, UpdateUserOptions> {
     /**
-     * Represents the authentication response.
+     * Represents the current authentication response.
+     * Set automatically after signin, signup, or signinWithToken.
      */
-    auth: AuthResponse | null;
+    private _auth;
+    /**
+     * Gets the current authentication response.
+     */
+    get auth(): AuthResponse | null;
+    /**
+     * Sets the authentication response and updates the Authorization header.
+     */
+    private set auth(value);
     /**
      * Constructs a new UserRepository instance.
      * @param client - The AxiosInstance used for making HTTP requests.
@@ -24,25 +33,128 @@ export declare class UserRepository extends ModelRepository<UserEntity, any, any
     constructor(client: AxiosInstance);
     /**
      * Signs in a user with the provided credentials.
-     * @param credentials - The user credentials.
+     * @param credentials - The user credentials (email, password, optional fcmToken).
      * @returns A promise that resolves to the authentication response.
      */
-    signin(credentials: any): Promise<AuthResponse>;
+    signin(credentials: SigninCredentials): Promise<AuthResponse>;
     /**
      * Signs up a new user with the provided credentials.
-     * @param credentials - The user credentials.
+     * @param credentials - The user signup credentials.
+     * @returns A promise that resolves to the authentication response.
+     */
+    signup(credentials: SignupCredentials): Promise<AuthResponse>;
+    /**
+     * Signs in a user with an existing token.
+     * Useful for restoring authentication state from localStorage.
+     * @param token - The authentication token.
+     * @param fcmToken - Optional FCM token for push notifications.
      * @returns A promise that resolves to the authentication response.
      */
-    signup(credentials: any): Promise<AuthResponse>;
+    signinWithToken(token: string, fcmToken?: string | null): Promise<AuthResponse>;
     /**
      * Signs out the currently authenticated user.
+     * Deletes the token on the server and clears local auth state.
      * @returns A promise that resolves when the user is signed out.
      */
     signout(): Promise<void>;
     /**
-     * Updates the authenticated user's data.
+     * Gets the currently authenticated user.
+     * @returns A promise that resolves to the authentication response with current user.
+     */
+    me(): Promise<AuthResponse>;
+    /**
+     * Updates the authenticated user's profile.
      * @param data - The updated user data.
      * @returns A promise that resolves to the updated user entity.
      */
-    updateMe(data: any): Promise<UserEntity>;
+    updateMe(data: UserUpdate): Promise<UserEntity>;
+    /**
+     * Sends a password reset email to the user.
+     * @param email - The user's email address.
+     * @returns A promise that resolves when the email is sent.
+     */
+    sendResetPasswordEmail(email: string): Promise<void>;
+    /**
+     * Resets the password using a token from the reset email.
+     * @param uid - The user ID.
+     * @param token - The reset token from the email.
+     * @returns A promise that resolves when the password is reset.
+     */
+    resetPasswordWithToken(uid: string, token: string): Promise<void>;
+    /**
+     * Gets all access tokens for the authenticated user.
+     * @returns A promise that resolves to an array of access tokens.
+     */
+    tokens(): Promise<AccessToken[]>;
+    /**
+     * Signs in with Google OAuth.
+     * @param options - The OAuth code and optional FCM token.
+     * @returns A promise that resolves to the authentication response.
+     */
+    signinWithGoogle(options: SigninWithSocialOptions): Promise<AuthResponse>;
+    /**
+     * Signs in with GitHub OAuth.
+     * @param options - The OAuth code and optional FCM token.
+     * @returns A promise that resolves to the authentication response.
+     */
+    signinWithGitHub(options: SigninWithSocialOptions): Promise<AuthResponse>;
+    /**
+     * Signs in with Apple OAuth.
+     * @param options - The OAuth code and optional FCM token.
+     * @returns A promise that resolves to the authentication response.
+     */
+    signinWithApple(options: SigninWithSocialOptions): Promise<AuthResponse>;
+    /**
+     * Links a social account to the current user.
+     * @param options - The provider and OAuth code.
+     * @returns A promise that resolves to the updated user entity.
+     */
+    linkSocialAccount(options: LinkSocialAccountOptions): Promise<UserEntity>;
+    /**
+     * Unlinks a social account from the current user.
+     * @param provider - The social provider to unlink.
+     * @returns A promise that resolves to the updated user entity.
+     */
+    unlinkSocialAccount(provider: 'google' | 'github' | 'apple'): Promise<UserEntity>;
+    /**
+     * Transfers money from the authenticated user to another user.
+     * @param options - Transfer options including recipient and amount.
+     * @returns A promise that resolves to the transfer response with updated users.
+     */
+    transferMoney(options: TransferMoneyOptions): Promise<TransferMoneyResponse>;
+    /**
+     * Starts passkey registration.
+     * @param options - Optional device name for the passkey.
+     * @returns A promise that resolves to the registration challenge data.
+     */
+    startPasskeyRegistration(options?: StartPasskeyRegistrationOptions): Promise<Record<string, any>>;
+    /**
+     * Finishes passkey registration.
+     * @param options - The registration response from the authenticator.
+     * @returns A promise that resolves to the authentication response.
+     */
+    finishPasskeyRegistration(options: FinishPasskeyRegistrationOptions): Promise<AuthResponse>;
+    /**
+     * Starts passkey authentication.
+     * @param options - Optional email to identify the user.
+     * @returns A promise that resolves to the authentication challenge data.
+     */
+    startPasskeyAuthentication(options?: StartPasskeyAuthenticationOptions): Promise<Record<string, any>>;
+    /**
+     * Finishes passkey authentication.
+     * @param options - The authentication response from the authenticator.
+     * @returns A promise that resolves to the authentication response.
+     */
+    finishPasskeyAuthentication(options: FinishPasskeyAuthenticationOptions): Promise<AuthResponse>;
+    /**
+     * Lists all passkeys for the authenticated user.
+     * @returns A promise that resolves to an array of passkeys.
+     */
+    listPasskeys(): Promise<Passkey[]>;
+    /**
+     * Deletes a passkey.
+     * @param passkeyId - The ID of the passkey to delete.
+     * @returns A promise that resolves when the passkey is deleted.
+     */
+    deletePasskey(passkeyId: string): Promise<void>;
 }

package/build/src/feeef/services/cart.d.ts

@@ -1,6 +1,7 @@
 import { ShippingType } from '../../core/entities/order.js';
 import { ProductEntity, ProductOffer } from '../../core/entities/product.js';
 import { ShippingMethodEntity } from '../../core/entities/shipping_method.js';
+import { ShippingPriceEntity } from '../../core/entities/shipping_price.js';
 import { StoreEntity } from '../../core/entities/store.js';
 import { NotifiableService } from './service.js';
 /**
@@ -37,6 +38,8 @@ export interface CartShippingAddress {
 export declare class CartService extends NotifiableService {
     private items;
     private shippingMethod;
+    private shippingPrice;
+    private store;
     private shippingAddress;
     private cachedSubtotal;
     private currentItem;
@@ -187,11 +190,48 @@ export declare class CartService extends NotifiableService {
      */
     setShippingMethod(method: ShippingMethodEntity | StoreEntity, notify?: boolean): void;
     /**
-     * Retrieves the available shipping types for the current shipping method.
+     * Sets the shipping price (new system).
+     * @param shippingPrice - The shipping price entity.
+     * @param notify - Whether to notify listeners.
+     */
+    setShippingPrice(shippingPrice: ShippingPriceEntity | null, notify?: boolean): void;
+    /**
+     * Sets the store entity.
+     * @param store - The store entity.
+     * @param notify - Whether to notify listeners.
+     */
+    setStore(store: StoreEntity | null, notify?: boolean): void;
+    /**
+     * Maps ShippingType enum to ShippingPriceType string.
+     * @param shippingType - The shipping type enum.
+     * @returns The corresponding shipping price type.
+     */
+    private mapShippingTypeToPriceType;
+    /**
+     * Resolves shipping price using the priority chain.
+     * Priority: 1. Product shippingPriceId, 2. Store shippingPriceId, 3. Product shippingMethodId, 4. Store defaultShippingRates
+     *
+     * Note: Shipping prices must be loaded and set via setShippingPrice() for the new system to work.
+     * If shipping prices are not loaded, the method falls back to the legacy system.
+     *
+     * @param countryCode - ISO 3166-1 alpha-2 country code (optional, required for new system)
+     * @param stateCode - State/province code
+     * @param shippingType - The shipping type
+     * @returns The shipping price or null if not available
+     */
+    private resolveShippingPrice;
+    /**
+     * Gets shipping price using legacy system (array-based rates).
+     * @param type - The shipping type
+     * @returns The shipping price or null if not available
+     */
+    private getShippingPriceForTypeLegacy;
+    /**
+     * Retrieves the available shipping types using the priority chain.
+     * Priority: 1. Product shippingPriceId, 2. Store shippingPriceId, 3. Product shippingMethodId, 4. Store defaultShippingRates
      *
-     *   rates is a 2D array for example `[[10, 20, 30], [5, 10, 15]]`
-     *   where the first array is for `home` fees and the second is for `pickup` fees, and the third is for `store` fees
-     *   if the fee value is 0, then it's free shipping, and if it's null, then it's not available
+     * Note: Shipping prices must be loaded and set via setShippingPrice() for the new system to work.
+     * If shipping prices are not loaded, the method falls back to the legacy system.
      *
      * @returns An array of available shipping types.
      */
@@ -217,7 +257,8 @@ export declare class CartService extends NotifiableService {
      */
     getShippingPrice(): number;
     /**
-     * Gets the shipping price for a specific shipping type using the current shipping address state.
+     * Gets the shipping price for a specific shipping type using the priority chain.
+     * Priority: 1. Product shippingPriceId, 2. Store shippingPriceId, 3. Product shippingMethodId, 4. Store defaultShippingRates
      * @param type - The shipping type to check (pickup, home, store)
      * @returns The shipping price for the specified type, or null if not available
      */

package/build/src/index.d.ts

@@ -4,8 +4,18 @@ export * from './core/entities/store.js';
 export * from './core/entities/product.js';
 export * from './core/entities/user.js';
 export * from './core/entities/shipping_method.js';
+export * from './core/entities/shipping_price.js';
 export * from './core/entities/category.js';
+export * from './core/entities/country.js';
+export * from './core/entities/state.js';
+export * from './core/entities/city.js';
+export * from './core/entities/currency.js';
 export * from './feeef/repositories/deposits.js';
+export * from './feeef/repositories/transfers.js';
+export * from './feeef/repositories/shipping_prices.js';
+export * from './feeef/repositories/users.js';
+export type { TransferEntity, TransferCreateInput } from './feeef/repositories/transfers.js';
+export type { DepositEntity, DepositCreateInput } from './feeef/repositories/deposits.js';
 export * from './core/embadded/address.js';
 export * from './core/embadded/category.js';
 export * from './core/embadded/contact.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "feeef",
   "description": "feeef sdk for javascript",
-  "version": "0.5.38-dev.2",
+  "version": "0.5.38-dev.4",
   "main": "build/index.js",
   "type": "module",
   "files": [