@shushed/helpers 0.0.247-cat-tree-schema-20260130105151 → 0.0.247-fh-20260130141017

package/dist/types/dist-types/product.d.ts

@@ -3,38 +3,23 @@ export type Country = ("AF" | "AX" | "AL" | "DZ" | "AS" | "AD" | "AO" | "AI" | "
 export interface __MainSchema {
     product_id: string;
     slug?: string;
-    style_slug?: string;
     style_id: string;
     colour_id?: string;
     style_name?: string;
-    product_name: string;
-    display_name?: (string | null);
+    display_name: string;
     buffer_quantity?: number;
     display_type?: ("Out-of-stock" | "Permanently-unavailable");
     available_to_sell_from?: (string | null);
-    online_from: (string | null);
-    online_to?: (string | null);
-    first_online_at?: (string | null);
-    last_online_at?: (string | null);
-    first_purchased_at?: string;
-    first_markdown_at?: (string | null);
     created_at?: string;
     last_modified_at?: string;
     colour_family_name?: string;
-    colour_code?: string;
     colour_name?: string;
     display_tags?: DisplayTags;
     sizerange_code?: string;
-    sizerange_name?: string;
     variants?: {
         code: string;
         name: string;
-        [k: string]: unknown;
-    }[];
-    images?: {
-        type: ("Campaign" | "Ecom" | "Flatlay" | "UGC" | "AI");
-        url: string;
-        description?: string;
+        ean?: (string | null);
         [k: string]: unknown;
     }[];
     vat_rate_uk?: (number | null);
@@ -43,47 +28,40 @@ export interface __MainSchema {
         commodity_code_ref?: string;
         country_of_origin?: Country;
         port_of_origin?: string;
-        supplier_id?: string;
-        supplier_name?: string;
-        factory_id?: string;
         packing_method?: (("Standard" | "Hanging") | null);
         is_bought_in_product?: boolean;
         [k: string]: unknown;
     };
     merch?: {
         strategy_type?: string;
-        product_type?: string;
-        stock_type?: string;
         category?: string;
         subcategory?: string;
-        range?: (("Main Collection" | "Seasonal") | null);
-        channels_availability?: ("DIRECT-UK" | "DIRECT-INT" | "DIRECT-US" | "JL-STORES" | "JL-WEB" | "NEXT" | "MS" | "FENWICK" | "MORLEYS")[];
-        collections?: string;
         seasons?: string[];
         drops?: string[];
-        fashionability?: (string | null);
         [k: string]: unknown;
     };
+    category_assignments?: {
+        display_path?: string[];
+        path?: string[];
+        name?: string;
+        id?: string;
+        [k: string]: unknown;
+    }[];
     attributes?: Attributes;
-    presentations?: {
+    markets?: string[];
+    markets_overrides?: {
         [k: string]: {
             locale: string;
-            presentation_type: string;
+            market: string;
             slug?: string;
-            style_slug?: string;
             style_name?: string;
-            display_name?: (string | null);
+            display_name?: string;
             display_type?: ("Out-of-stock" | "Permanently-unavailable");
             available_to_sell_from?: (string | null);
-            online_from?: (string | null);
-            online_to?: (string | null);
-            last_online_at?: (string | null);
-            first_purchased_at?: string;
-            first_markdown_at?: (string | null);
             colour_family_name?: string;
             colour_name?: string;
             display_tags?: DisplayTags;
-            sizerange_name?: string;
+            last_online_at?: (string | null);
             variants?: {
                 code: string;
                 name: string;
@@ -94,49 +72,34 @@ export interface __MainSchema {
     };
 }
 export interface Attributes {
+    stock_quantity_score?: number;
+    stock_availability?: number;
+    measurement_chart?: (string | null);
+    sizeguide_type?: (string | null);
+    brand?: (string | null);
+    shoes_type?: (string | null);
     seo_url_name?: string;
-    embellishment?: (string | null);
     seo_title?: (string | null);
     seo_description?: (string | null);
     fit_description?: (string | null);
     description?: (string | null);
     fabric_care?: (string | null);
-    delivery_returns?: (string | null);
     weight?: (number | null);
-    weight_statement?: (string | null);
     main_fibre?: (string | null);
     main_metal?: (string | null);
-    extra_selling_points?: string[];
-    length_measurement?: (string | null);
-    measurement_table_code?: string;
-    fit?: (string | null);
-    pockets?: (string | null);
-    pleats_gathers?: (string | null);
-    lining?: (string | null);
-    bias_cut?: (string | null);
     designer?: (string | null);
-    fabric?: (string | null);
-    fabric_composition?: (string | null);
     certificate_code?: (string | null);
-    shape?: (string | null);
-    development_type?: string;
-    occasion?: (string | null);
-    design?: (string | null);
-    block?: (string | null);
     pattern_name?: (string | null);
     fit_type?: (string | null);
-    neckline?: (string | null);
-    sleeve_length?: (string | null);
-    sleeve_type?: (string | null);
-    heel_height?: (string | null);
-    heel_shape?: (string | null);
-    toe_shape?: (string | null);
-    trouser_fit?: (string | null);
-    leg_length?: (string | null);
-    handle_straps?: (string | null);
-    straps_features?: (string | null);
-    fastening?: ((string[] | null) | null);
-    sole_material?: (string | null);
+    trousers_fit?: (string | null);
+    trousers_length?: (string | null);
+    dresses_skirts_length?: (string | null);
+    coats_jackets_type?: (string | null);
+    dresses_skirts_type?: (string | null);
+    bag_type?: (string | null);
+    product_category?: (string | null);
+    product_type?: (string | null);
+    metal?: (string | null);
     care_instructions?: string[];
     [k: string]: unknown;
 }

package/dist/types/src-public/fredhopper/fredhopper.base.d.ts

@@ -0,0 +1,59 @@
+import { ILogging } from '../runtime';
+import { FredhopperAttribute, FredhopperCategory, FredhopperConfig, FredhopperProduct, UpdateResult, UpdateStatus } from './fredhopper.types';
+export default abstract class FredHelperBase {
+    protected logging: ILogging;
+    protected readonly config: FredhopperConfig;
+    protected attributes: FredhopperAttribute[];
+    protected categories: FredhopperCategory[];
+    constructor(logging: ILogging, config: FredhopperConfig, attributes: FredhopperAttribute[], categories: FredhopperCategory[]);
+    updateType: 'full' | 'incremental';
+    protected get timestamp(): string;
+    protected get authHeader(): string;
+    protected get baseFilesUrl(): string;
+    protected get baseUrl(): string;
+    static validateCategoryId(categoryId: string): boolean;
+    static validateAttributeId(attributeId: string): boolean;
+    static validateProductId(productId: string): boolean;
+    static authHeader(config: FredhopperConfig): string;
+    getCategories(): Promise<FredhopperCategory[]>;
+    getAttributesMeta(): Promise<FredhopperAttribute[]>;
+    validateProducts(products: FredhopperProduct[]): Promise<void>;
+    uploadProductUpdate(products: FredhopperProduct[]): Promise<string>;
+    uploadToFredhopper(zipData: Blob, checksum: string): Promise<string>;
+    uploadChecksumFile(checksum: string, timestamp: string): Promise<void>;
+    triggerIncrementalUpdate(dataId: string): Promise<string>;
+    checkUpdateStatus(triggerId: string): Promise<UpdateStatus>;
+    getUpdateLogs(triggerId: string): Promise<string>;
+    waitForUpdateCompletion(triggerId: string, pollInterval?: number, timeout?: number): Promise<string>;
+    protected triggerUpdate(dataId: string): Promise<UpdateResult>;
+    protected generateCategoriesCSV(categories: FredhopperCategory[]): string;
+    protected generateAttributesMetaCSV(attributes: FredhopperAttribute[]): string;
+    protected generateProductsCSV(products: FredhopperProduct[]): string;
+    protected generateVariantsCSV(inputs: {
+        variants: any[];
+        productId: string;
+    }[]): string;
+    protected generateCustomVariantAttributesCSV(input: {
+        [key: string]: string | number;
+    }[][]): string;
+    protected generateProductAttributesCSV(products: FredhopperProduct[]): string;
+    protected createProductUpdateZip(products: FredhopperProduct[]): Promise<{
+        blob: Blob;
+        checksum: string;
+    }>;
+    getProductCategories(productId: string): Promise<any>;
+    protected createZip(files: Record<string, string>): Promise<{
+        blob: Blob;
+        checksum: string;
+    }>;
+    protected calculateChecksum(filename: string): Promise<string>;
+    protected createCSVLine(...parts: (string | number)[]): string;
+    protected getProduct(id: string): Promise<any>;
+    protected queryProduct(query: {
+        [key: string]: string;
+    }): Promise<any>;
+    protected mapAttributesFromExistingProduct(product: any): any;
+    protected updateProducts(products: FredhopperProduct[]): Promise<UpdateResult>;
+    protected createProductZipContent(products: FredhopperProduct[]): Promise<Record<string, string>>;
+    protected get uploadFileName(): "data.zip" | "data-incremental.zip";
+}

package/dist/types/src-public/fredhopper/fredhopper.d.ts

@@ -0,0 +1,21 @@
+import FredHelperBase from './fredhopper.base';
+import { CentraCategory, FredhopperProduct, UpdateResult } from './fredhopper.types';
+export default class FredHelper extends FredHelperBase {
+    patchAttributes(updates: Array<{
+        productId: string;
+        attributes: {
+            [attributeId: string]: any;
+        };
+    }>): Promise<UpdateResult>;
+    updateProductCategories(updates: Array<{
+        productId: string;
+        categories: string[];
+    }>): Promise<UpdateResult>;
+    updateProductAndVariants(items: Array<{
+        product: FredhopperProduct;
+        variants: {
+            [key: string]: string | number;
+        }[];
+    }>): Promise<UpdateResult>;
+    updateCategory(updatedCentraCategory: CentraCategory): Promise<any>;
+}

package/dist/types/src-public/fredhopper/fredhopper.types.d.ts

@@ -0,0 +1,70 @@
+export interface FredhopperCategory {
+    category_id: string;
+    parent_id: string;
+    locales: {
+        locale: string;
+        name: string;
+    }[];
+}
+export type UpdateStatus = 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'UNKNOWN';
+export type UpdateResult = {
+    dataId: string;
+    triggerId: string;
+    status: string;
+};
+export interface FredhopperAttribute {
+    attribute_id: string;
+    type: 'float' | 'set' | 'list' | 'int' | 'datetime' | 'asset' | 'text' | 'hierarchical';
+    locales?: {
+        locale: string;
+        name: string;
+    }[];
+}
+export interface FredhopperProduct {
+    product_id: string;
+    attributes: {
+        [attributeId: string]: any;
+    };
+    categories?: string[];
+    operation_type?: 'add' | 'update' | 'replace' | 'delete';
+    variants?: {
+        [key: string]: string | number;
+    }[];
+}
+export interface FredhopperConfig {
+    username: string;
+    password: string;
+    baseUrl: string;
+    environment: string;
+    region?: string;
+    base64Credentials?: string;
+}
+export declare class FredhopperValidationError extends Error {
+    constructor(message: string);
+}
+export type LocalizedName = {
+    name: string;
+    locale: string;
+};
+export type CategoryNode = {
+    name: string;
+    localizedNames: LocalizedName[];
+    children: CategoryNode[];
+};
+export type Catalog = {
+    tenant: string;
+    environment: string;
+    version: number;
+    name: string;
+    children: CategoryNode[];
+    localizedNames: LocalizedName[];
+};
+export type CentraCategory = {
+    category_code: string;
+    parent_category_code?: string;
+    status: string;
+    translations?: {
+        language_code: string;
+        name: string;
+    }[];
+};

package/dist/types/src-public/fredhopper/index.d.ts

@@ -0,0 +1,2 @@
+export { default as FredHelper } from './fredhopper';
+export { FredhopperValidationError, type FredhopperCategory, type FredhopperAttribute, type FredhopperProduct, type FredhopperConfig, } from './fredhopper.types';

package/dist/types/src-public/index.d.ts

@@ -17,4 +17,4 @@ export { default as setHeaders } from './setHeaders';
 export { type CentraError, type CentraErrors, type BasicCentraCountry, type BasicCentraMarket, type BasicCentraSizeChart, type BasicPricelist, type BasicCentraWarehouse, type BasicCentraCampaign, type BasicCentraProduct, type BasicCentraVariant, type BasicCentraDisplay } from './centra';
 export { default as RateLimit, RedisConnectionError } from './rateLimit';
 export { type TriggerOnCreateOptions, type TriggerOnExecuteOptions, type NodeOptions, type RNConfiguration, type TriggerExtraOptions } from './types';
-export { default as SitooHelper, type UnitCost, type StockMovementInput, type BasicSitooWarehouse, type BasicSitooStore, type BasicWarehouseTransaction, type WarehouseTransactionEnvelope, type WarehouseTransactionSyncOptions } from './sitoo';
+export * from './fredhopper';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shushed/helpers",
-  "version": "0.0.247-cat-tree-schema-20260130105151",
+  "version": "0.0.247-fh-20260130141017",
   "author": "",
   "license": "UNLICENSED",
   "description": "",
@@ -9,6 +9,7 @@
     "@hackylabs/deep-redact": "^2.2.1",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
+    "archiver": "^7.0.1",
     "co-body": "^6.2.0",
     "jose": "^6.0.11",
     "lodash.chunk": "^4.2.0",