falconhub-apilibrary 1.5.1 → 1.5.2-dev.132

package/dist/index.d.mts

@@ -73,10 +73,19 @@ interface BulkRowError {
 }
 interface BulkResult {
     created: number;
+    updated: number;
     failed: number;
     rowErrors: BulkRowError[];
 }
 
+/**
+ * Request genérico para la carga masiva de archivos.
+ * Contiene el archivo en formato base64.
+ */
+interface BulkUploadRequest {
+    base64: string;
+}
+
 /**
  * Interfaz que representa un género del catálogo.
  */
@@ -211,48 +220,6 @@ interface InventoryStatusesFilter {
     Description?: string;
 }
 
-/**
- * Interfaz que representa un empaque del inventario.
- */
-interface Packing {
-    packingId: number;
-    packing: string;
-    key: string;
-    materialId: number;
-    length: number;
-    width: number;
-    height: number;
-    weightLimit: number | null;
-    cost: number;
-    providerId: number;
-    isActive: boolean;
-}
-/**
- * Request para crear o actualizar un empaque.
- */
-interface PackingRequest {
-    packing: string;
-    key?: string;
-    materialId: number;
-    length: number;
-    width: number;
-    height: number;
-    weightLimit?: number;
-    cost: number;
-    providerId: number;
-    isActive: boolean;
-}
-/**
- * Filtros disponibles para buscar empaques.
- */
-interface PackingsFilter {
-    Search?: string;
-    Packing?: string;
-    MaterialId?: number;
-    ProviderId?: number;
-    IsActive?: boolean;
-}
-
 /**
  * Interfaz que representa un material del inventario.
  */
@@ -263,6 +230,9 @@ interface Material {
     description: string;
     isRecyclable: boolean;
     isFragile: boolean;
+    createdAt: string;
+    updatedAt: string | null;
+    deleted: boolean;
 }
 /**
  * Request para crear o actualizar un material.
@@ -284,6 +254,37 @@ interface MaterialsFilter {
     IsRecyclable?: boolean;
     IsFragile?: boolean;
 }
+/**
+ * Fila del Excel de carga masiva / layout editable de Materiales.
+ * Todos los campos son string porque provienen de celdas Excel.
+ * Campos booleanos representados como "true" | "false".
+ */
+interface MaterialsBulkItem {
+    materialId: string;
+    material: string;
+    description: string;
+    key: string;
+    isRecyclable: string;
+    isFragile: string;
+}
+/**
+ * Mapeo de encabezados Excel (plantilla vacía) a propiedades de MaterialsBulkItem.
+ * Usar al leer archivos descargados desde GET bulk/template.
+ */
+declare const MATERIALS_BULK_COLUMN_MAP: Record<string, keyof MaterialsBulkItem>;
+/**
+ * Encabezados en español de la plantilla vacía, en el orden exacto de las columnas.
+ */
+declare const MATERIALS_BULK_HEADERS: string[];
+/**
+ * Mapeo de encabezados Excel (layout editable) a propiedades de MaterialsBulkItem.
+ * Usar al leer archivos descargados desde GET bulk/layout.
+ */
+declare const MATERIALS_LAYOUT_COLUMN_MAP: Record<string, keyof MaterialsBulkItem>;
+/**
+ * Encabezados en español del layout editable, en el orden exacto de las columnas.
+ */
+declare const MATERIALS_LAYOUT_HEADERS: string[];
 
 /**
  * Interfaz que representa un proveedor del inventario.
@@ -317,6 +318,53 @@ interface ProvidersFilter {
     IsActive?: boolean;
 }
 
+/**
+ * Interfaz que representa un empaque del inventario.
+ */
+interface Packing {
+    packingId: number;
+    packing: string;
+    key: string;
+    materialId: number;
+    length: number;
+    width: number;
+    height: number;
+    weightLimit: number | null;
+    cost: number;
+    providerId: number;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string | null;
+    deleted: boolean;
+    material?: Material | null;
+    provider?: Provider | null;
+}
+/**
+ * Request para crear o actualizar un empaque.
+ */
+interface PackingRequest {
+    packing: string;
+    key?: string;
+    materialId: number;
+    length: number;
+    width: number;
+    height: number;
+    weightLimit?: number;
+    cost: number;
+    providerId: number;
+    isActive: boolean;
+}
+/**
+ * Filtros disponibles para buscar empaques.
+ */
+interface PackingsFilter {
+    Search?: string;
+    Packing?: string;
+    MaterialId?: number;
+    ProviderId?: number;
+    IsActive?: boolean;
+}
+
 /**
  * Interfaz que representa un color.
  */
@@ -342,6 +390,33 @@ interface ColorsFilter {
     Search?: string;
     Color?: string;
 }
+/**
+ * Fila del Excel de carga masiva / layout editable de Colores.
+ * Todos los campos son string porque provienen de celdas Excel.
+ */
+interface ColorsBulkItem {
+    colorId: string;
+    color: string;
+    key: string;
+}
+/**
+ * Mapeo de encabezados Excel (plantilla vacía) a propiedades de ColorsBulkItem.
+ * Usar al leer archivos descargados desde GET bulk/template.
+ */
+declare const COLORS_BULK_COLUMN_MAP: Record<string, keyof ColorsBulkItem>;
+/**
+ * Encabezados en español de la plantilla vacía, en el orden exacto de las columnas.
+ */
+declare const COLORS_BULK_HEADERS: string[];
+/**
+ * Mapeo de encabezados Excel (layout editable) a propiedades de ColorsBulkItem.
+ * Usar al leer archivos descargados desde GET bulk/layout.
+ */
+declare const COLORS_LAYOUT_COLUMN_MAP: Record<string, keyof ColorsBulkItem>;
+/**
+ * Encabezados en español del layout editable, en el orden exacto de las columnas.
+ */
+declare const COLORS_LAYOUT_HEADERS: string[];
 
 /**
  * Interfaz que representa un grupo de tallas.
@@ -451,12 +526,6 @@ interface BlanksFilter {
     Size: string;
     IsActive?: boolean;
 }
-/**
- * Request para carga masiva de archivos.
- */
-interface BulkUploadRequest {
-    base64: string;
-}
 /**
  * Representa una fila del Excel de carga masiva de Blanks.
  */
@@ -551,6 +620,34 @@ interface ProductTypesFilter {
     productType?: string;
     description?: string;
 }
+/**
+ * Representa una fila del Excel de carga masiva / layout editable de tipos de producto.
+ * Todos los campos son string porque provienen de celdas Excel.
+ */
+interface ProductTypesBulkItem {
+    productTypeId: string;
+    productType: string;
+    key: string;
+    description: string;
+}
+/**
+ * Mapeo de encabezados Excel (plantilla vacía) a propiedades de ProductTypesBulkItem.
+ * Usar al leer archivos descargados desde GET bulk/template.
+ */
+declare const PRODUCT_TYPES_BULK_COLUMN_MAP: Record<string, keyof ProductTypesBulkItem>;
+/**
+ * Encabezados en español de la plantilla vacía, en el orden exacto de las columnas.
+ */
+declare const PRODUCT_TYPES_BULK_HEADERS: string[];
+/**
+ * Mapeo de encabezados Excel (layout editable) a propiedades de ProductTypesBulkItem.
+ * Usar al leer archivos descargados desde GET bulk/layout.
+ */
+declare const PRODUCT_TYPES_LAYOUT_COLUMN_MAP: Record<string, keyof ProductTypesBulkItem>;
+/**
+ * Encabezados en español del layout editable, en el orden exacto de las columnas.
+ */
+declare const PRODUCT_TYPES_LAYOUT_HEADERS: string[];
 
 interface ProductCategory {
     productCategoryId: number;
@@ -574,6 +671,16 @@ interface ProductCategoriesFilter {
     description?: string;
     isActive?: boolean;
 }
+/**
+ * Representa una fila del Excel de carga masiva de categorías de producto.
+ */
+interface ProductCategoriesBulkItem {
+    productCategoryId: string;
+    productCategory: string;
+    key: string;
+    description: string;
+    isActive: string;
+}
 
 interface ProductStatus {
     productStatusId: number;
@@ -984,6 +1091,12 @@ interface SiteConfigResponse {
     catalogs: SiteConfigCatalogsResponse;
 }
 
+/**
+ * Valor del marcador oculto embebido en la hoja "Catalogos" columna 1000 fila 1.
+ * Si el archivo contiene este valor → modo layout (UPSERT); si está vacío → modo creación.
+ */
+declare const LAYOUT_MARKER = "FH_LAYOUT";
+
 type MethodTypes = "GET" | "POST" | "PATCH" | "DELETE" | "PUT";
 interface RequestOptions {
     endpoint: string;
@@ -1595,6 +1708,20 @@ declare class InventoryService {
      * @param id - ID del material a eliminar
      */
     deleteMaterial(id: number): Promise<ResponseModel<void>>;
+    /**
+     * Descarga la plantilla Excel vacía para carga masiva de materiales.
+     */
+    getMaterialsBulkTemplate(): Promise<ResponseModel<Blob>>;
+    /**
+     * Descarga el layout Excel pre-poblado para edición masiva de materiales.
+     * @param ids - Lista de IDs de materiales a incluir en el layout
+     */
+    getMaterialsBulkLayout(ids: number[]): Promise<ResponseModel<Blob>>;
+    /**
+     * Realiza una carga masiva de creación de materiales desde un archivo Excel.
+     * @param request - Objeto con el archivo en base64
+     */
+    bulkCreateMaterials(request: BulkUploadRequest): Promise<ResponseModel<BulkResult>>;
     /**
      * Obtiene todos los proveedores con filtros opcionales.
      * @param filter - Filtros opcionales para la búsqueda
@@ -1663,6 +1790,19 @@ declare class ProductService {
      * Elimina un color.
      */
     deleteColor(id: number): Promise<ResponseModel<void>>;
+    /**
+     * Obtiene la plantilla para la carga masiva de colores.
+     */
+    getColorsBulkTemplate(): Promise<ResponseModel<Blob>>;
+    /**
+     * Obtiene el layout Excel pre-poblado para edición masiva de colores.
+     * @param ids - Lista de IDs de colores a incluir en el layout
+     */
+    getColorsBulkLayout(ids: number[]): Promise<ResponseModel<Blob>>;
+    /**
+     * Realiza una carga masiva de colores.
+     */
+    bulkCreateColors(request: BulkUploadRequest): Promise<ResponseModel<BulkResult>>;
     /**
      * Obtiene todos los grupos de tallas con filtros opcionales.
      */
@@ -1827,6 +1967,18 @@ declare class ProductService {
      * Elimina un tipo de producto.
      */
     deleteProductType(id: number): Promise<ResponseModel<void>>;
+    /**
+     * Obtiene la plantilla para la carga masiva de tipos de producto.
+     */
+    getProductTypesBulkTemplate(): Promise<ResponseModel<Blob>>;
+    /**
+     * Obtiene el layout para la actualización masiva de tipos de producto.
+     */
+    getProductTypesBulkLayout(ids: number[]): Promise<ResponseModel<Blob>>;
+    /**
+     * Realiza una carga masiva (upsert) de tipos de producto.
+     */
+    bulkUpsertProductTypes(request: BulkUploadRequest): Promise<ResponseModel<BulkResult>>;
     /**
      * Obtiene todas las categorías de producto con filtros opcionales.
      */
@@ -1855,6 +2007,18 @@ declare class ProductService {
      * Elimina una categoría de producto.
      */
     deleteProductCategory(id: number): Promise<ResponseModel<void>>;
+    /**
+     * Obtiene la plantilla para la carga masiva de categorías de producto.
+     */
+    getProductCategoriesBulkTemplate(): Promise<ResponseModel<Blob>>;
+    /**
+     * Obtiene el layout para la actualización masiva de categorías de producto.
+     */
+    getProductCategoriesBulkLayout(ids: number[]): Promise<ResponseModel<Blob>>;
+    /**
+     * Realiza una carga masiva (upsert) de categorías de producto.
+     */
+    bulkUpsertProductCategories(request: BulkUploadRequest): Promise<ResponseModel<BulkResult>>;
     /**
      * Obtiene todos los estatus de producto con filtros opcionales.
      */
@@ -2199,4 +2363,4 @@ declare class FalconHUBSDK {
 
 declare function decrypt(encryptedBase64: string, secret: string, timestamp: string): string;
 
-export { API, type AdminAuthentication, type AdminUser, type AreaCode, type AreaCodeRequest, type AreaCodeUserProfile, type AreaCodesFilter, AuthInterceptor, type AuthInterceptorConfig, AuthService, BLANKS_BULK_COLUMN_MAP, BLANKS_BULK_SPANISH_HEADERS, type Blank, type BlankRequest, type BlanksBulkItem, type BlanksFilter, type BulkResult, type BulkRowError, type BulkUploadRequest, CatalogService, type ChangePasswordAdminRequest, type ChangePasswordRequest, type ChangePasswordUserRequest, type Color, type ColorRequest, type ColorsFilter, type ConfirmEmailRequest, CryptoService, type Endpoint, type EndpointRequest, type EndpointsFilter, ErrorResponse, FalconHUBSDK, FilterBuilder, type FilterFieldMetadata, type FilterGroup, type FilterGroupOption, type FilterGroupsModel, type FilterMetadataModel, type FilterModel, type Gender, type GenderRequest, type GenderUserProfile, type GendersFilter, type GetSecretKeyRequest, type GetSecretKeyResponse, type HttpMethodType, type InterceptorContext, InventoryService, type InventoryStatus, type InventoryStatusRequest, type InventoryStatusesFilter, type License, type LicenseRequest, type LicensesFilter, type Location, type LocationsFilter, type LocationsRequest, type LoginRequest, type LoginResponse, type Material, type MaterialRequest, type MaterialsFilter, type MethodTypes, type Module, type ModuleRequest, type ModulesFilter, type Packing, type PackingRequest, type PackingsFilter, type ProductCategoriesFilter, type ProductCategory, type ProductCategoryRequest, ProductService, type ProductStatus, type ProductStatusRequest, type ProductStatusesFilter, type ProductType, type ProductTypeRequest, type ProductTypesFilter, type Provider, type ProviderRequest, type ProvidersFilter, type RefreshTokenRequest, type RefreshTokenResponse, type RequestConfig, type RequestInterceptor, type RequestOptions, type ResponseModel, type Role, type RoleRequest, type RoleUserProfile, type RolesFilter, type SendOtpRequest, type ServiceProperties, type SiteConfigCatalogsResponse, type SiteConfigResponse, type Size, type SizeGroup, type SizeGroupRequest, type SizeGroupsFilter, type SizeRequest, type SizesFilter, type Studio, type StudioRequest, type StudiosFilter, SystemService, type TokenData, TokenManager, type UIRoute, type UIRouteRequest, type UIRoutesFilter, type UserAdminFilter, type UserAdminRequest, type UserAdminUpdateRequest, type UserAuthAdminRequest, type UserAuthUpdateRequest, type UserBasicResponse, type UserDataUpdateRequest, type UserProfileResponse, type Role as UserRole, UserService, type UserType, type UserTypeRequest, type UserTypeUserProfile, type UserTypesFilter, type ValidateOtpRequest, type ValidateSessionRenewedResponse, type ValidateSessionResponse, decrypt };
+export { API, type AdminAuthentication, type AdminUser, type AreaCode, type AreaCodeRequest, type AreaCodeUserProfile, type AreaCodesFilter, AuthInterceptor, type AuthInterceptorConfig, AuthService, BLANKS_BULK_COLUMN_MAP, BLANKS_BULK_SPANISH_HEADERS, type Blank, type BlankRequest, type BlanksBulkItem, type BlanksFilter, type BulkResult, type BulkRowError, type BulkUploadRequest, COLORS_BULK_COLUMN_MAP, COLORS_BULK_HEADERS, COLORS_LAYOUT_COLUMN_MAP, COLORS_LAYOUT_HEADERS, CatalogService, type ChangePasswordAdminRequest, type ChangePasswordRequest, type ChangePasswordUserRequest, type Color, type ColorRequest, type ColorsBulkItem, type ColorsFilter, type ConfirmEmailRequest, CryptoService, type Endpoint, type EndpointRequest, type EndpointsFilter, ErrorResponse, FalconHUBSDK, FilterBuilder, type FilterFieldMetadata, type FilterGroup, type FilterGroupOption, type FilterGroupsModel, type FilterMetadataModel, type FilterModel, type Gender, type GenderRequest, type GenderUserProfile, type GendersFilter, type GetSecretKeyRequest, type GetSecretKeyResponse, type HttpMethodType, type InterceptorContext, InventoryService, type InventoryStatus, type InventoryStatusRequest, type InventoryStatusesFilter, LAYOUT_MARKER, type License, type LicenseRequest, type LicensesFilter, type Location, type LocationsFilter, type LocationsRequest, type LoginRequest, type LoginResponse, MATERIALS_BULK_COLUMN_MAP, MATERIALS_BULK_HEADERS, MATERIALS_LAYOUT_COLUMN_MAP, MATERIALS_LAYOUT_HEADERS, type Material, type MaterialRequest, type MaterialsBulkItem, type MaterialsFilter, type MethodTypes, type Module, type ModuleRequest, type ModulesFilter, PRODUCT_TYPES_BULK_COLUMN_MAP, PRODUCT_TYPES_BULK_HEADERS, PRODUCT_TYPES_LAYOUT_COLUMN_MAP, PRODUCT_TYPES_LAYOUT_HEADERS, type Packing, type PackingRequest, type PackingsFilter, type ProductCategoriesBulkItem, type ProductCategoriesFilter, type ProductCategory, type ProductCategoryRequest, ProductService, type ProductStatus, type ProductStatusRequest, type ProductStatusesFilter, type ProductType, type ProductTypeRequest, type ProductTypesBulkItem, type ProductTypesFilter, type Provider, type ProviderRequest, type ProvidersFilter, type RefreshTokenRequest, type RefreshTokenResponse, type RequestConfig, type RequestInterceptor, type RequestOptions, type ResponseModel, type Role, type RoleRequest, type RoleUserProfile, type RolesFilter, type SendOtpRequest, type ServiceProperties, type SiteConfigCatalogsResponse, type SiteConfigResponse, type Size, type SizeGroup, type SizeGroupRequest, type SizeGroupsFilter, type SizeRequest, type SizesFilter, type Studio, type StudioRequest, type StudiosFilter, SystemService, type TokenData, TokenManager, type UIRoute, type UIRouteRequest, type UIRoutesFilter, type UserAdminFilter, type UserAdminRequest, type UserAdminUpdateRequest, type UserAuthAdminRequest, type UserAuthUpdateRequest, type UserBasicResponse, type UserDataUpdateRequest, type UserProfileResponse, type Role as UserRole, UserService, type UserType, type UserTypeRequest, type UserTypeUserProfile, type UserTypesFilter, type ValidateOtpRequest, type ValidateSessionRenewedResponse, type ValidateSessionResponse, decrypt };