@longvansoftware/service-js-client 1.16.2 → 1.16.4

package/dist/src/types/common.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Common types used across the SDK
+ */
+/**
+ * Environment configuration
+ */
+export type Environment = 'dev' | 'live';
+/**
+ * HTTP methods supported by REST API calls
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+/**
+ * Pagination parameters
+ */
+export interface PaginationParams {
+    currentPage?: number;
+    maxResult?: number;
+    pageSize?: number;
+}
+/**
+ * Pagination response
+ */
+export interface PaginationResponse<T> {
+    total: number;
+    currentPage: number;
+    maxResult: number;
+    totalPage: number;
+    data: T[];
+}
+/**
+ * Search parameters
+ */
+export interface SearchParams extends PaginationParams {
+    keyword?: string;
+    sortBy?: string;
+    sortOrder?: 'ASC' | 'DESC';
+}
+/**
+ * API Response wrapper
+ */
+export interface ApiResponse<T = any> {
+    success: boolean;
+    data?: T;
+    message?: string;
+    errors?: string[];
+}
+/**
+ * Service configuration
+ */
+export interface ServiceConfig {
+    endpoint: string;
+    orgId: string;
+    storeId: string;
+    token?: string;
+}
+/**
+ * GraphQL variables base interface
+ */
+export interface GraphQLVariables {
+    partnerId?: string;
+    storeChannel?: string;
+    [key: string]: any;
+}
+/**
+ * REST API headers
+ */
+export interface RestApiHeaders {
+    'Content-Type'?: string;
+    'Authorization'?: string;
+    'PartnerId'?: string;
+    'Partner-Id'?: string;
+    'X-Ecomos-Access-Token'?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * File upload configuration
+ */
+export interface FileUploadConfig {
+    maxSize?: number;
+    allowedTypes?: string[];
+    multiple?: boolean;
+}
+/**
+ * Cache configuration
+ */
+export interface CacheConfig {
+    ttl?: number;
+    maxSize?: number;
+    enabled?: boolean;
+}
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    maxRetries?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+    exponentialBackoff?: boolean;
+}
+/**
+ * SDK Configuration
+ */
+export interface SDKConfig {
+    orgId: string;
+    storeId: string;
+    environment: Environment;
+    cache?: CacheConfig;
+    retry?: RetryConfig;
+    timeout?: number;
+}
+/**
+ * Service method options
+ */
+export interface ServiceMethodOptions {
+    timeout?: number;
+    retry?: RetryConfig;
+    cache?: boolean;
+    headers?: RestApiHeaders;
+}
+/**
+ * Base entity interface
+ */
+export interface BaseEntity {
+    id: string;
+    createdAt?: string;
+    updatedAt?: string;
+    createdBy?: string;
+    updatedBy?: string;
+}
+/**
+ * Address interface
+ */
+export interface Address {
+    street?: string;
+    city?: string;
+    state?: string;
+    country?: string;
+    postalCode?: string;
+    fullAddress?: string;
+}
+/**
+ * Contact information
+ */
+export interface ContactInfo {
+    email?: string;
+    phone?: string;
+    website?: string;
+}
+/**
+ * Money/Price interface
+ */
+export interface Money {
+    amount: number;
+    currency?: string;
+    formatted?: string;
+}
+/**
+ * Image interface
+ */
+export interface Image {
+    id?: string;
+    url: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+    size?: number;
+}
+/**
+ * Category interface
+ */
+export interface Category extends BaseEntity {
+    title: string;
+    handle?: string;
+    description?: string;
+    image?: string;
+    icon?: string;
+    parentId?: string;
+    level?: number;
+    children?: Category[];
+}
+/**
+ * Tag interface
+ */
+export interface Tag {
+    id: string;
+    name: string;
+    color?: string;
+}
+/**
+ * Attribute interface
+ */
+export interface Attribute {
+    name: string;
+    value: string;
+    type?: string;
+}
+/**
+ * Unit interface
+ */
+export interface Unit {
+    id: string;
+    name: string;
+    symbol?: string;
+}
+/**
+ * Status enum
+ */
+export declare enum Status {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE",
+    PENDING = "PENDING",
+    DRAFT = "DRAFT",
+    PUBLISHED = "PUBLISHED",
+    ARCHIVED = "ARCHIVED"
+}
+/**
+ * Gender enum
+ */
+export declare enum Gender {
+    MALE = "MALE",
+    FEMALE = "FEMALE",
+    OTHER = "OTHER"
+}
+/**
+ * Sort order enum
+ */
+export declare enum SortOrder {
+    ASC = "ASC",
+    DESC = "DESC"
+}
+/**
+ * Utility type for making all properties optional
+ */
+export type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Utility type for making all properties required
+ */
+export type RequiredBy<T, K extends keyof T> = T & Required<Pick<T, K>>;
+/**
+ * Utility type for nullable properties
+ */
+export type Nullable<T> = T | null;
+/**
+ * Utility type for optional properties
+ */
+export type Optional<T> = T | undefined;
+/**
+ * Deep partial type
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Promise result type
+ */
+export type PromiseResult<T> = Promise<T>;
+/**
+ * Callback function type
+ */
+export type Callback<T = void> = (error?: Error, result?: T) => void;
+/**
+ * Event handler type
+ */
+export type EventHandler<T = any> = (event: T) => void;

package/dist/src/types/common.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Common types used across the SDK
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SortOrder = exports.Gender = exports.Status = void 0;
+/**
+ * Status enum
+ */
+var Status;
+(function (Status) {
+    Status["ACTIVE"] = "ACTIVE";
+    Status["INACTIVE"] = "INACTIVE";
+    Status["PENDING"] = "PENDING";
+    Status["DRAFT"] = "DRAFT";
+    Status["PUBLISHED"] = "PUBLISHED";
+    Status["ARCHIVED"] = "ARCHIVED";
+})(Status || (exports.Status = Status = {}));
+/**
+ * Gender enum
+ */
+var Gender;
+(function (Gender) {
+    Gender["MALE"] = "MALE";
+    Gender["FEMALE"] = "FEMALE";
+    Gender["OTHER"] = "OTHER";
+})(Gender || (exports.Gender = Gender = {}));
+/**
+ * Sort order enum
+ */
+var SortOrder;
+(function (SortOrder) {
+    SortOrder["ASC"] = "ASC";
+    SortOrder["DESC"] = "DESC";
+})(SortOrder || (exports.SortOrder = SortOrder = {}));

package/dist/src/types/invoice.d.ts

@@ -0,0 +1,13 @@
+export interface VatInvoiceRequestDTO {
+    sourceId: String;
+    sourceType: String;
+    signType: String;
+    includeBuyerTaxCode: Boolean;
+    buyerName: String;
+    buyerTaxCode: String;
+    buyerCompany: String;
+    buyerAddress: String;
+    sendMail: Boolean;
+    receiverName: String;
+    receiverEmail: String;
+}

package/dist/src/types/invoice.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/types/portal.d.ts

@@ -0,0 +1,7 @@
+export interface SaveTextEditor {
+    type: string;
+    relativeId: string;
+    content: string;
+    version: string;
+    createdBy: string;
+}

package/dist/src/types/portal.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/types/store.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Store Data Transfer Object
+ * Represents a store/channel in the system
+ */
+export interface StoreDTO {
+    /** Unique identifier for the store */
+    id: string;
+    /** Timestamp when the store was created */
+    createdStamp: string | null;
+    /** Display name of the store */
+    name: string;
+    /** Type of store (pos, ecommerce, etc.) */
+    type: 'pos' | 'ecommerce' | 'marketplace' | 'wholesale' | string;
+    /** Whether the store is enabled/active */
+    enable: boolean;
+    /** Party/Organization ID that owns this store */
+    partyId: string;
+    /** Array of warehouse IDs associated with this store */
+    warehouses: string[];
+    /** Default warehouse ID for this store */
+    warehouseIdDefault: string;
+    /** Whether future orders are allowed */
+    enableOrderAbleFuture: boolean;
+    /** Whether negative quantity orders are allowed */
+    enableOrderNegativeQuantity: boolean;
+    /** E-commerce specific store name */
+    storeEcommerceName: string | null;
+    /** Array of shipping company IDs */
+    shippingCompanies: string[];
+    /** Primary shipping company ID */
+    shippingCompanyIdPrimary: string;
+    /** Primary customer ID */
+    customerIdPrimary: string;
+    /** Primary payment method ID */
+    paymentMethodIdPrimary: string;
+    /** Whether custom product pricing is enabled */
+    enableCustomProductPrice: boolean;
+    /** Whether partial payments are enabled */
+    enablePaymentPartial: boolean;
+    /** Array of allowed partial payment percentages */
+    paymentPartialPercent: number[];
+    /** Link to the product store (for e-commerce) */
+    productStoreLink: string | null;
+    /** GraphQL typename */
+    __typename?: string;
+}
+/**
+ * Request interface for creating a new store
+ */
+export interface CreateStoreRequest {
+    /** Partner/Organization ID */
+    partnerId: string;
+    /** Name for the new store */
+    storeName: string;
+    /** Optional store type */
+    type?: 'pos' | 'ecommerce' | 'marketplace' | 'wholesale';
+    /** Optional configuration */
+    config?: Partial<StoreConfiguration>;
+}
+/**
+ * Store configuration options
+ */
+export interface StoreConfiguration {
+    /** Whether the store should be enabled by default */
+    enable: boolean;
+    /** Warehouse IDs to associate with the store */
+    warehouses: string[];
+    /** Default warehouse ID */
+    warehouseIdDefault: string;
+    /** Whether to enable future orders */
+    enableOrderAbleFuture: boolean;
+    /** Whether to enable negative quantity orders */
+    enableOrderNegativeQuantity: boolean;
+    /** E-commerce store name */
+    storeEcommerceName: string;
+    /** Shipping company IDs */
+    shippingCompanies: string[];
+    /** Primary shipping company ID */
+    shippingCompanyIdPrimary: string;
+    /** Primary customer ID */
+    customerIdPrimary: string;
+    /** Primary payment method ID */
+    paymentMethodIdPrimary: string;
+    /** Enable custom product pricing */
+    enableCustomProductPrice: boolean;
+    /** Enable partial payments */
+    enablePaymentPartial: boolean;
+    /** Partial payment percentages */
+    paymentPartialPercent: number[];
+    /** Product store link */
+    productStoreLink: string;
+}
+/**
+ * Request interface for getting store channels by employee ID
+ */
+export interface GetStoreChannelRequest {
+    /** Employee/Sale ID */
+    saleId: string;
+    /** Optional filter by store type */
+    type?: 'pos' | 'ecommerce' | 'marketplace' | 'wholesale';
+    /** Optional filter by enabled status */
+    enabledOnly?: boolean;
+}
+/**
+ * Response interface for store channel queries
+ */
+export interface StoreChannelResponse {
+    /** Array of accessible stores */
+    stores: StoreDTO[];
+    /** Total count of stores */
+    totalCount: number;
+    /** Whether user has admin permissions (can see all stores) */
+    hasAdminAccess: boolean;
+}
+/**
+ * Store filter options for querying stores
+ */
+export interface StoreFilterOptions {
+    /** Filter by store type */
+    type?: 'pos' | 'ecommerce' | 'marketplace' | 'wholesale' | string;
+    /** Filter by enabled status */
+    enabled?: boolean;
+    /** Filter by party/organization ID */
+    partyId?: string;
+    /** Search by store name */
+    searchName?: string;
+    /** Pagination - current page */
+    currentPage?: number;
+    /** Pagination - max results per page */
+    maxResult?: number;
+}
+/**
+ * Store statistics interface
+ */
+export interface StoreStats {
+    /** Total number of stores */
+    totalStores: number;
+    /** Number of active stores */
+    activeStores: number;
+    /** Number of inactive stores */
+    inactiveStores: number;
+    /** Breakdown by store type */
+    byType: {
+        pos: number;
+        ecommerce: number;
+        marketplace: number;
+        wholesale: number;
+        other: number;
+    };
+}
+/**
+ * Store service method return types
+ */
+export interface StoreServiceMethods {
+    createStore: (partnerId: string, storeName: string) => Promise<StoreDTO>;
+    getStoreChannelByEmpId: (saleId: string) => Promise<StoreDTO[]>;
+}
+export type { StoreDTO as Store, };

package/dist/src/types/store.js

@@ -0,0 +1,3 @@
+"use strict";
+// src/types/store.ts
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/src/utils/errorHandler.d.ts

@@ -0,0 +1,64 @@
+import { SDKError } from '../lib/serviceSDK';
+/**
+ * Error types for better categorization
+ */
+export declare enum ErrorType {
+    GRAPHQL_ERROR = "GRAPHQL_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    REST_API_ERROR = "REST_API_ERROR",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    AUTHENTICATION_ERROR = "AUTHENTICATION_ERROR",
+    AUTHORIZATION_ERROR = "AUTHORIZATION_ERROR",
+    NOT_FOUND_ERROR = "NOT_FOUND_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Error severity levels
+ */
+export declare enum ErrorSeverity {
+    LOW = "LOW",
+    MEDIUM = "MEDIUM",
+    HIGH = "HIGH",
+    CRITICAL = "CRITICAL"
+}
+/**
+ * Enhanced SDK Error with additional metadata
+ */
+export declare class EnhancedSDKError extends SDKError {
+    readonly severity: ErrorSeverity;
+    readonly timestamp: Date;
+    readonly context?: Record<string, any>;
+    readonly retryable: boolean;
+    constructor(message: string, type: ErrorType, originalError?: any, severity?: ErrorSeverity, context?: Record<string, any>, retryable?: boolean);
+}
+/**
+ * Error handler utility class
+ */
+export declare class ErrorHandler {
+    /**
+     * Create a standardized error from various error sources
+     */
+    static createError(error: any, context?: Record<string, any>): EnhancedSDKError;
+    /**
+     * Determine error severity based on error characteristics
+     */
+    private static determineSeverity;
+    /**
+     * Determine if an error is retryable
+     */
+    private static isRetryable;
+    /**
+     * Log error with appropriate level
+     */
+    static logError(error: EnhancedSDKError, operation?: string): void;
+    /**
+     * Check if error should trigger retry logic
+     */
+    static shouldRetry(error: EnhancedSDKError, attemptCount: number, maxRetries?: number): boolean;
+}
+/**
+ * Retry utility with exponential backoff
+ */
+export declare class RetryManager {
+    static withExponentialBackoff<T>(operation: () => Promise<T>, maxRetries?: number, baseDelay?: number): Promise<T>;
+}