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

package/build/src/core/entities/city.d.ts

@@ -0,0 +1,17 @@
+/**
+ * City Entity
+ *
+ * Represents a city with composite key (countryCode + stateCode + name).
+ */
+export interface CityEntity {
+    /** Country code (part of composite primary key) */
+    countryCode: string;
+    /** State code (part of composite primary key) */
+    stateCode: string;
+    /** City name (part of composite primary key) */
+    name: string;
+    /** Additional metadata as key-value pairs */
+    metadata: Record<string, any>;
+    /** Creation timestamp */
+    createdAt: any;
+}

package/build/src/core/entities/country.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Country Entity
+ *
+ * Represents a country with ISO 3166-1 alpha-2 country code.
+ */
+export interface CountryEntity {
+    /** ISO 3166-1 alpha-2 country code (e.g., US, DZ, SA) */
+    code: string;
+    /** Country name (e.g., United States, Algeria, Saudi Arabia) */
+    name: string;
+    /** Phone country code without + (e.g., 1, 213, 966) */
+    phone: string;
+    /** Additional metadata as key-value pairs */
+    metadata: Record<string, any>;
+    /** Creation timestamp */
+    createdAt: any;
+}

package/build/src/core/entities/currency.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Currency Entity
+ *
+ * Represents a currency with ISO 4217 code.
+ */
+export interface CurrencyEntity {
+    /** ISO 4217 currency code (e.g., USD, EUR, SAR) */
+    code: string;
+    /** Currency name (e.g., US Dollar, Euro, Saudi Riyal) */
+    name: string;
+    /** Currency symbol (e.g., $, €, ﷼) */
+    symbol?: string;
+    /** Number of decimal places */
+    decimals: number;
+    /** Exchange rate relative to base currency */
+    rate: number;
+    /** Additional metadata as key-value pairs */
+    metadata?: Record<string, any>;
+    /** Creation timestamp */
+    createdAt: any;
+}

package/build/src/core/entities/order.d.ts

@@ -33,6 +33,7 @@ export interface OrderEntity {
     shippingAddress?: string | null;
     shippingCity?: string | null;
     shippingState?: string | null;
+    shippingCountry?: string | null;
     shippingMethodId?: string | null;
     shippingType: ShippingType;
     trackingCode: string | null;

package/build/src/core/entities/product.d.ts

@@ -11,6 +11,7 @@ export interface ProductEntity {
     media: string[];
     storeId: string;
     shippingMethodId?: string | null;
+    shippingPriceId?: string | null;
     categoryId?: string | null;
     category?: EmbaddedCategory | null;
     categoryRelation?: CategoryEntity | null;

package/build/src/core/entities/shipping_price.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Shipping Price Entity
+ *
+ * A simplified, country-aware shipping pricing system that replaces
+ * the legacy array-based shipping rates with a structured approach.
+ *
+ * Key features:
+ * - Country codes as keys (ISO 3166-1 alpha-2)
+ * - State codes as keys (no fragile array indexes)
+ * - Named price types for extensibility
+ * - Gradual migration path from legacy system
+ *
+ * @example
+ * ```typescript
+ * const prices: ShippingPriceRates = {
+ *   "DZ": {
+ *     "01": { home: 800, desk: 400, pickup: 0 },
+ *     "16": { home: 600, desk: 300, pickup: 0 }
+ *   },
+ *   "IQ": {
+ *     "01": { home: 15000, desk: 10000, pickup: 5000 }
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Individual state shipping rates with named price types.
+ * Using named properties instead of array indexes for clarity and extensibility.
+ */
+export interface ShippingStateRates {
+    /** Price for home delivery (nullable if unavailable) */
+    home: number | null;
+    /** Price for desk/office pickup (nullable if unavailable) */
+    desk: number | null;
+    /** Price for store pickup (nullable if unavailable) */
+    pickup: number | null;
+}
+/**
+ * Shipping rates organized by country code and state code.
+ * Structure: { [countryCode]: { [stateCode]: ShippingStateRates } }
+ */
+export type ShippingPriceRates = Record<string, Record<string, ShippingStateRates>>;
+/**
+ * Status of the shipping price configuration.
+ */
+export declare enum ShippingPriceStatus {
+    /** Not yet published, only visible to store owner */
+    draft = "draft",
+    /** Active and used for shipping calculations */
+    published = "published"
+}
+/**
+ * Shipping Price Entity
+ *
+ * Represents a shipping pricing configuration for a store.
+ * Supports multi-country operations with state-level pricing.
+ */
+export interface ShippingPriceEntity {
+    /** Unique identifier (24-char string) */
+    id: string;
+    /** Display name for this pricing configuration */
+    name: string;
+    /** Optional logo URL for branding */
+    logoUrl: string | null;
+    /** Store this pricing belongs to */
+    storeId: string;
+    /**
+     * Pricing data structured by country and state codes.
+     * @see ShippingPriceRates
+     */
+    prices: ShippingPriceRates;
+    /** Publication status */
+    status: ShippingPriceStatus;
+    /** Creation timestamp */
+    createdAt: any;
+    /** Last update timestamp */
+    updatedAt: any;
+}
+/**
+ * Shipping type enumeration for order shipping type.
+ * Maps to the pricing structure keys.
+ */
+export type ShippingPriceType = keyof ShippingStateRates;
+/**
+ * Helper function to get shipping price from rates.
+ *
+ * @param prices - The shipping price rates object
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @param stateCode - State/province code
+ * @param type - Shipping type (home, desk, pickup)
+ * @returns The price or null if not available
+ *
+ * @example
+ * ```typescript
+ * const price = getShippingPrice(shippingPrice.prices, 'DZ', '16', 'home')
+ * // Returns 600 or null
+ * ```
+ */
+export declare function getShippingPrice(prices: ShippingPriceRates, countryCode: string, stateCode: string, type: ShippingPriceType): number | null;
+/**
+ * Helper function to check if shipping is available for a location.
+ *
+ * @param prices - The shipping price rates object
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @param stateCode - State/province code
+ * @returns True if any shipping type is available for this location
+ */
+export declare function isShippingAvailable(prices: ShippingPriceRates, countryCode: string, stateCode: string): boolean;
+/**
+ * Helper function to get all available shipping types for a location.
+ *
+ * @param prices - The shipping price rates object
+ * @param countryCode - ISO 3166-1 alpha-2 country code
+ * @param stateCode - State/province code
+ * @returns Array of available shipping types with their prices
+ */
+export declare function getAvailableShippingTypes(prices: ShippingPriceRates, countryCode: string, stateCode: string): Array<{
+    type: ShippingPriceType;
+    price: number;
+}>;

package/build/src/core/entities/state.d.ts

@@ -0,0 +1,17 @@
+/**
+ * State/Province Entity
+ *
+ * Represents a state or province with composite key (countryCode + code).
+ */
+export interface StateEntity {
+    /** Country code (part of composite primary key) */
+    countryCode: string;
+    /** State/province code (part of composite primary key) */
+    code: string;
+    /** State/province name */
+    name: string;
+    /** Additional metadata as key-value pairs */
+    metadata: Record<string, any>;
+    /** Creation timestamp */
+    createdAt: any;
+}

package/build/src/core/entities/store.d.ts

@@ -34,6 +34,7 @@ export interface StoreEntity {
     updatedAt: any;
     user?: UserEntity;
     defaultShippingRates: (number | null)[][] | null;
+    shippingPriceId?: string | null;
     subscription?: any;
     due?: number;
     configs?: StoreConfigs;

package/build/src/core/entities/user.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Represents a user entity in the system.
+ */
 export interface UserEntity {
     id: string;
     name: string | null;
@@ -14,10 +17,16 @@ export interface UserEntity {
     metadata: Record<string, any>;
     wallet: EmbaddedWallet;
 }
+/**
+ * Represents an embedded wallet in a user entity.
+ */
 export interface EmbaddedWallet {
     currency: 'DZD' | 'USD' | 'EUR';
     balance: number;
 }
+/**
+ * Represents an authentication token.
+ */
 export interface AuthToken {
     type: string;
     name: string | null;
@@ -26,3 +35,149 @@ export interface AuthToken {
     lastUsedAt: any;
     expiresAt: any;
 }
+/**
+ * Options for creating a user (admin panel)
+ */
+export interface CreateUserOptions {
+    name: string;
+    email: string;
+    phone?: string;
+    password: string;
+    photoUrl?: string;
+    metadata?: Record<string, any>;
+    emailVerifiedAt?: string | Date;
+    phoneVerifiedAt?: string | Date;
+    verifiedAt?: string | Date;
+    blockedAt?: string | Date;
+    createdByAdmin?: boolean;
+    initialBalance?: number;
+}
+/**
+ * Options for updating a user
+ */
+export interface UpdateUserOptions {
+    name?: string;
+    email?: string;
+    phone?: string;
+    password?: string;
+    password_confirmation?: string;
+    photoUrl?: string;
+    metadata?: Record<string, any>;
+    emailVerifiedAt?: string | Date;
+    phoneVerifiedAt?: string | Date;
+    verifiedAt?: string | Date;
+    blockedAt?: string | Date;
+}
+/**
+ * Represents an access token (returned from tokens endpoint).
+ */
+export interface AccessToken {
+    id: string;
+    type: string;
+    name: string | null;
+    token: string;
+    abilities: string[];
+    lastUsedAt: any | null;
+    expiresAt: any | null;
+    createdAt: any;
+}
+/**
+ * Credentials for signing in.
+ */
+export interface SigninCredentials {
+    email: string;
+    password: string;
+    fcmToken?: string | null;
+}
+/**
+ * Credentials for signing up.
+ */
+export interface SignupCredentials {
+    referral?: string | null;
+    name: string;
+    email: string;
+    phone?: string;
+    password: string;
+    photoUrl?: string;
+    fcmToken?: string | null;
+}
+/**
+ * Options for updating user profile.
+ */
+export interface UserUpdate {
+    name?: string;
+    email?: string;
+    phone?: string;
+    photoUrl?: string;
+    oldPassword?: string;
+    newPassword?: string;
+}
+/**
+ * Options for transferring money between users.
+ */
+export interface TransferMoneyOptions {
+    recipientId?: string;
+    recipientEmail?: string;
+    recipientPhone?: string;
+    amount: number;
+    note?: string;
+}
+/**
+ * Response from a money transfer operation.
+ */
+export interface TransferMoneyResponse {
+    success: boolean;
+    sender: UserEntity;
+    recipient: UserEntity;
+    amount: number;
+    currency: string;
+}
+/**
+ * Options for linking a social account.
+ */
+export interface LinkSocialAccountOptions {
+    provider: 'google' | 'github' | 'apple';
+    code: string;
+}
+/**
+ * Options for signing in with a social provider.
+ */
+export interface SigninWithSocialOptions {
+    code: string;
+    fcmToken?: string | null;
+}
+/**
+ * Options for passkey registration start.
+ */
+export interface StartPasskeyRegistrationOptions {
+    deviceName?: string;
+}
+/**
+ * Options for finishing passkey registration.
+ */
+export interface FinishPasskeyRegistrationOptions {
+    registrationResponse: Record<string, any>;
+    deviceName?: string;
+}
+/**
+ * Options for starting passkey authentication.
+ */
+export interface StartPasskeyAuthenticationOptions {
+    email?: string;
+}
+/**
+ * Options for finishing passkey authentication.
+ */
+export interface FinishPasskeyAuthenticationOptions {
+    authenticationResponse: Record<string, any>;
+}
+/**
+ * Represents a passkey entry.
+ */
+export interface Passkey {
+    id: string;
+    name: string;
+    deviceName?: string;
+    createdAt: any;
+    lastUsedAt: any | null;
+}

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

@@ -4,7 +4,13 @@ import { ProductRepository } from './repositories/products.js';
 import { StoreRepository } from './repositories/stores.js';
 import { UserRepository } from './repositories/users.js';
 import { DepositRepository } from './repositories/deposits.js';
+import { TransferRepository } from './repositories/transfers.js';
 import { CategoryRepository } from './repositories/categories.js';
+import { CountryRepository } from './repositories/countries.js';
+import { StateRepository } from './repositories/states.js';
+import { CityRepository } from './repositories/cities.js';
+import { CurrencyRepository } from './repositories/currencies.js';
+import { ShippingPriceRepository } from './repositories/shipping_prices.js';
 import { CartService } from './services/cart.js';
 import { ActionsService } from './services/actions.js';
 /**
@@ -63,10 +69,34 @@ export declare class FeeeF {
      * The repository for managing deposits.
      */
     deposits: DepositRepository;
+    /**
+     * The repository for managing transfers.
+     */
+    transfers: TransferRepository;
     /**
      * The repository for managing categories.
      */
     categories: CategoryRepository;
+    /**
+     * The repository for managing countries.
+     */
+    countries: CountryRepository;
+    /**
+     * The repository for managing states.
+     */
+    states: StateRepository;
+    /**
+     * The repository for managing cities.
+     */
+    cities: CityRepository;
+    /**
+     * The repository for managing currencies.
+     */
+    currencies: CurrencyRepository;
+    /**
+     * The repository for managing shipping prices.
+     */
+    shippingPrices: ShippingPriceRepository;
     /**
      * The cart service for managing the cart.
      */

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

@@ -0,0 +1,78 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository, ModelListOptions } from './repository.js';
+import { CityEntity } from '../../core/entities/city.js';
+/**
+ * Repository for managing City entities.
+ * Cities have composite keys (countryCode + stateCode + name) and are nested under states.
+ */
+export declare class CityRepository extends ModelRepository<CityEntity, any, any> {
+    /**
+     * Constructs a new CityRepository instance.
+     * @param client The AxiosInstance used for making HTTP requests.
+     */
+    constructor(client: AxiosInstance);
+    /**
+     * Lists cities, optionally filtered by country code and/or state code.
+     * @param options - The options for listing cities, including filters.
+     * @returns A Promise that resolves to a list of City entities.
+     */
+    list(options?: ModelListOptions & {
+        countryCode?: string;
+        stateCode?: string;
+    }): Promise<any>;
+    /**
+     * Lists cities for a specific country and state (nested route).
+     * @param countryCode - The country code.
+     * @param stateCode - The state code.
+     * @param options - Optional list options.
+     * @returns A Promise that resolves to a list of City entities.
+     */
+    listByState(countryCode: string, stateCode: string, options?: ModelListOptions): Promise<any>;
+    /**
+     * Finds a city by country code, state code, and city name.
+     * @param countryCode - The country code.
+     * @param stateCode - The state code.
+     * @param cityName - The city name.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the found City entity.
+     */
+    findByName(countryCode: string, stateCode: string, cityName: string, params?: Record<string, any>): Promise<CityEntity>;
+    /**
+     * Creates a new city (nested under country/state).
+     * @param countryCode - The country code.
+     * @param stateCode - The state code.
+     * @param data - The city data.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the created City entity.
+     */
+    createByState(countryCode: string, stateCode: string, data: any, params?: Record<string, any>): Promise<CityEntity>;
+    /**
+     * Updates a city (nested under country/state).
+     * @param countryCode - The country code.
+     * @param stateCode - The state code.
+     * @param cityName - The city name.
+     * @param data - The update data.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the updated City entity.
+     */
+    updateByState(countryCode: string, stateCode: string, cityName: string, data: any, params?: Record<string, any>): Promise<CityEntity>;
+    /**
+     * Deletes a city (nested under country/state).
+     * @param countryCode - The country code.
+     * @param stateCode - The state code.
+     * @param cityName - The city name.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves when the city is deleted.
+     */
+    deleteByState(countryCode: string, stateCode: string, cityName: string, params?: Record<string, any>): Promise<void>;
+    /**
+     * Searches cities by name (autocomplete).
+     * @param query - The search query.
+     * @param options - Optional filters (countryCode, stateCode).
+     * @returns A Promise that resolves to a list of matching City entities.
+     */
+    search(query: string, options?: {
+        countryCode?: string;
+        stateCode?: string;
+    }): Promise<CityEntity[]>;
+}

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

@@ -0,0 +1,20 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository } from './repository.js';
+import { CountryEntity } from '../../core/entities/country.js';
+/**
+ * Repository for managing Country entities.
+ */
+export declare class CountryRepository extends ModelRepository<CountryEntity, any, any> {
+    /**
+     * Constructs a new CountryRepository instance.
+     * @param client The AxiosInstance used for making HTTP requests.
+     */
+    constructor(client: AxiosInstance);
+    /**
+     * Finds a country by its code (ID is the country code).
+     * @param code - The country code (ISO 3166-1 alpha-2).
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the found Country entity.
+     */
+    findByCode(code: string, params?: Record<string, any>): Promise<CountryEntity>;
+}

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

@@ -0,0 +1,20 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository } from './repository.js';
+import { CurrencyEntity } from '../../core/entities/currency.js';
+/**
+ * Repository for managing Currency entities.
+ */
+export declare class CurrencyRepository extends ModelRepository<CurrencyEntity, any, any> {
+    /**
+     * Constructs a new CurrencyRepository instance.
+     * @param client The AxiosInstance used for making HTTP requests.
+     */
+    constructor(client: AxiosInstance);
+    /**
+     * Finds a currency by its code (ID is the currency code).
+     * @param code - The currency code (ISO 4217, e.g., USD, EUR).
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the found Currency entity.
+     */
+    findByCode(code: string, params?: Record<string, any>): Promise<CurrencyEntity>;
+}

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

@@ -0,0 +1,28 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository, ModelCreateOptions } from './repository.js';
+import { ShippingPriceEntity } from '../../core/entities/shipping_price.js';
+/**
+ * Repository for managing ShippingPrice entities.
+ *
+ * ShippingPrice is the new geo-based shipping system that replaces
+ * the legacy array-based ShippingMethod rates.
+ */
+export declare class ShippingPriceRepository extends ModelRepository<ShippingPriceEntity, any, any> {
+    /**
+     * Constructs a new ShippingPriceRepository instance.
+     * @param client The AxiosInstance used for making HTTP requests.
+     */
+    constructor(client: AxiosInstance);
+    /**
+     * Creates a new ShippingPrice entity.
+     * @param options The options for creating the ShippingPrice entity.
+     * @returns A Promise that resolves to the created ShippingPrice entity.
+     */
+    create(options: ModelCreateOptions<any>): Promise<ShippingPriceEntity>;
+    /**
+     * Finds a ShippingPrice by store ID.
+     * @param storeId The store ID to search for.
+     * @returns A Promise that resolves to the ShippingPrice entities for the store.
+     */
+    listByStore(storeId: string): Promise<ShippingPriceEntity[]>;
+}

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

@@ -0,0 +1,62 @@
+import { AxiosInstance } from 'axios';
+import { ModelRepository, ModelListOptions } from './repository.js';
+import { StateEntity } from '../../core/entities/state.js';
+/**
+ * Repository for managing State entities.
+ * States have composite keys (countryCode + code) and can be nested under countries.
+ */
+export declare class StateRepository extends ModelRepository<StateEntity, any, any> {
+    /**
+     * Constructs a new StateRepository instance.
+     * @param client The AxiosInstance used for making HTTP requests.
+     */
+    constructor(client: AxiosInstance);
+    /**
+     * Lists states, optionally filtered by country code.
+     * @param options - The options for listing states, including countryCode filter.
+     * @returns A Promise that resolves to a list of State entities.
+     */
+    list(options?: ModelListOptions & {
+        countryCode?: string;
+    }): Promise<any>;
+    /**
+     * Lists states for a specific country (nested route).
+     * @param countryCode - The country code.
+     * @param options - Optional list options.
+     * @returns A Promise that resolves to a list of State entities.
+     */
+    listByCountry(countryCode: string, options?: ModelListOptions): Promise<any>;
+    /**
+     * Finds a state by country code and state code.
+     * @param countryCode - The country code.
+     * @param stateCode - The state code.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the found State entity.
+     */
+    findByCode(countryCode: string, stateCode: string, params?: Record<string, any>): Promise<StateEntity>;
+    /**
+     * Creates a new state (nested under country).
+     * @param countryCode - The country code.
+     * @param data - The state data.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the created State entity.
+     */
+    createByCountry(countryCode: string, data: any, params?: Record<string, any>): Promise<StateEntity>;
+    /**
+     * Updates a state (nested under country).
+     * @param countryCode - The country code.
+     * @param stateCode - The state code.
+     * @param data - The update data.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves to the updated State entity.
+     */
+    updateByCountry(countryCode: string, stateCode: string, data: any, params?: Record<string, any>): Promise<StateEntity>;
+    /**
+     * Deletes a state (nested under country).
+     * @param countryCode - The country code.
+     * @param stateCode - The state code.
+     * @param params - Optional query parameters.
+     * @returns A Promise that resolves when the state is deleted.
+     */
+    deleteByCountry(countryCode: string, stateCode: string, params?: Record<string, any>): Promise<void>;
+}