@isoftdata/svelte-ecommerce 1.0.0-beta.0

package/dist/helpers/validation.js

@@ -0,0 +1,91 @@
+// Pretty basic method to verify all required fields, the ebay-utility is more thorough on certain types
+// We could've just done required fields (and we may still), but this is a way to get a full list and to know when to set the active flag 
+export function validateInventoryListingDetails(listingDetails) {
+    const validationErrors = [];
+    // Helper function for required integer fields
+    const validateRequiredIntegers = (fields) => {
+        fields.forEach(({ key, name }) => {
+            const value = listingDetails[key];
+            if (value == null || value === undefined) {
+                validationErrors.push(`${name} is required`);
+            }
+            else if (!Number.isInteger(value)) {
+                validationErrors.push(`${name} must be a positive integer`);
+            }
+        });
+    };
+    // Helper function for required string fields
+    const validateRequiredStrings = (fields) => {
+        fields.forEach(({ key, name }) => {
+            const value = listingDetails[key];
+            if (value == null || value === undefined || value === '') {
+                validationErrors.push(`${name} is required`);
+            }
+            else if (typeof value !== 'string') {
+                validationErrors.push(`${name} must be a string`);
+            }
+        });
+    };
+    // Helper function for required number fields (decimals/floats)
+    const validateRequiredNumbers = (fields) => {
+        fields.forEach(({ key, name, allowZero = false }) => {
+            const value = listingDetails[key];
+            if (value == null || value === undefined) {
+                validationErrors.push(`${name} is required`);
+            }
+            else if (typeof value !== 'number' || isNaN(value)) {
+                validationErrors.push(`${name} must be a valid number`);
+            }
+            else if (!allowZero && value <= 0) {
+                validationErrors.push(`${name} must be greater than zero`);
+            }
+            else if (allowZero && value < 0) {
+                validationErrors.push(`${name} must be zero or greater`);
+            }
+        });
+    };
+    // Required integer fields
+    validateRequiredIntegers([
+        { key: 'inventoryId', name: 'Tag #' },
+        { key: 'ecommercePartnerId', name: 'Ecommerce Partner' },
+        { key: 'storeId', name: 'Store' },
+        { key: 'ecommerceCategoryId', name: 'Ebay Category Id' },
+        { key: 'ecommerceConditionId', name: 'Ebay Condition Id' },
+        { key: 'fulfillmentTime', name: 'Fulfillment Time' },
+        { key: 'shippingLength', name: 'Shipping Length' },
+        { key: 'shippingWidth', name: 'Shipping Width' },
+        { key: 'shippingHeight', name: 'Shipping Height' },
+    ]);
+    validateRequiredStrings([
+        { key: 'duration', name: 'Listing Duration' },
+        { key: 'ecommerceConditionDescription', name: 'Condition Description' },
+        { key: 'fulfillmentTimeUnit', name: 'Fulfillment Time Unit' },
+        { key: 'listingDescription', name: 'Listing Description' },
+        { key: 'listingTitle', name: 'Listing Title' },
+        { key: 'inventoryDescription', name: 'Inventory Description' },
+        { key: 'weightUnit', name: 'Weight Unit' },
+        { key: 'shippingLengthUnit', name: 'Length Unit' },
+        { key: 'shippingPackage', name: 'Shipping Package' },
+    ]);
+    validateRequiredNumbers([
+        { key: 'price', name: 'Price' },
+        { key: 'weight', name: 'Weight', allowZero: true }
+    ]);
+    // TODO: add public check and quantity check to ebay listing helper 
+    // price
+    // quantity
+    // weight
+    if (!listingDetails.imageUrls?.length) {
+        validationErrors.push('Image Required');
+    }
+    if (!listingDetails.partnerSpecificDetails?.fulfillmentPolicy?.length) {
+        validationErrors.push('Fulfillment Policy Required');
+    }
+    if (!listingDetails.partnerSpecificDetails?.paymentPolicy?.length) {
+        validationErrors.push('Payment Policy Required');
+    }
+    if (!listingDetails.partnerSpecificDetails?.returnPolicy?.length) {
+        validationErrors.push('Return Policy Required');
+    }
+    return validationErrors;
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { default as EcommerceDefaults } from './EcommerceDefaults.svelte';
+export { default as EcommerceConfiguration } from './EcommerceConfiguration.svelte';
+export { default as EcommerceConditionMapConfiguration } from './EcommerceConditionMapConfiguration.svelte';
+export { default as EcommerceCategorymapConfiguration } from './EcommerceCategoryMapConfiguration.svelte';
+export { default as EcommerceListingDetails } from './EcommerceListingDetails.svelte';
+export { default as EcommerceStoreConfiguration } from './EcommerceStoreConfiguration.svelte';
+export { default as EcommercePartTypeConfiguration } from './EcommercePartTypeConfig.svelte';
+export { buildEbayListing } from './helpers/index.js';
+export { ecommercePartnerStaticData } from './data/index.js';
+export type { PackageType } from './data/types.js';
+export type { BuildEbayListingInput, EbayCategory, EbayCategoryMap, EbayLocation, EbayPolicy, EcommerceCondition, EcommerceConditionMap, EcommercePartnerConfiguration, EcommercePartnerDefaults, EcommerceStoreConfig, EcommerceSharedDefaults, ExtendedEbayCategoryMap, ExtendedEcommerceConditionMap, ExtendedInventoryTypeListingDefaults, FileItem, ImageUrl, InventoryDetailsForTemplate, InventoryListingDetail, InventoryType, InventoryTypeCategory, InventoryTypeListingDefaults, InventoryRow, NewInventoryListingDetail, NewInventoryTypeListingDefaults, Store } from './utils.js';

package/dist/index.js

@@ -0,0 +1,11 @@
+// Export Svelte components
+export { default as EcommerceDefaults } from './EcommerceDefaults.svelte';
+export { default as EcommerceConfiguration } from './EcommerceConfiguration.svelte';
+export { default as EcommerceConditionMapConfiguration } from './EcommerceConditionMapConfiguration.svelte';
+export { default as EcommerceCategorymapConfiguration } from './EcommerceCategoryMapConfiguration.svelte';
+export { default as EcommerceListingDetails } from './EcommerceListingDetails.svelte';
+export { default as EcommerceStoreConfiguration } from './EcommerceStoreConfiguration.svelte';
+export { default as EcommercePartTypeConfiguration } from './EcommercePartTypeConfig.svelte';
+export { buildEbayListing } from './helpers/index.js';
+// Export ecommerce data
+export { ecommercePartnerStaticData } from './data/index.js';

package/dist/utils.d.ts

@@ -0,0 +1,321 @@
+export interface BuildEbayListingInput {
+    categoryMapping?: EbayCategoryMap;
+    conditionMapping?: EcommerceConditionMap;
+    ecommercePartnerConfiguration: EcommercePartnerConfiguration;
+    existingListing?: InventoryListingDetail | NewInventoryListingDetail;
+    inventoryRow: InventoryRow;
+    inventoryTypeListingDefaults?: ExtendedInventoryTypeListingDefaults[];
+    inventoryType?: InventoryType;
+    partFileList?: FileItem[];
+}
+export interface ConvertedEbayListingDetails {
+    imageUrls: ImageUrlsWithName[];
+    sku: string;
+    ebayInventoryItem: string;
+    listingDetails: string;
+    listingId: number;
+}
+export type EbayCategory = {
+    ebayCategoryId: number;
+    name: string;
+};
+export interface EbaySpecificListingDetails {
+    brand: string | null;
+    oemNumber: string | null;
+    listingFormat: string | null;
+    fulfillmentPolicy: string[] | null;
+    marketplaceId: string | null;
+    merchantLocationKey: string | null;
+    paymentPolicy: string[] | null;
+    returnPolicy: string[] | null;
+}
+export type EbayLocation = {
+    storeId: number;
+    details: string;
+    ebayName: string;
+    production: boolean;
+};
+export type EbayPolicy = {
+    details: string;
+    name: string;
+    policyId: string;
+    production: boolean;
+    policyType: string;
+};
+export interface PolicyRowWithChecked extends EbayPolicy {
+    checked: boolean;
+}
+export type EbayCategoryMap = {
+    ebayCategoryId: number;
+    typeNum: number;
+    vehicleType: string;
+};
+export type EcommerceCondition = {
+    ecommerceConditionId: number;
+    ecommercePartnerId: number;
+    conditionId: number;
+    name: string;
+    description: string;
+};
+export type EcommerceConditionMap = {
+    ecommerceConditionMapId: number;
+    ecommercePartnerId: number;
+    itrackCondition: string;
+    ecommerceConditionId: number;
+    description: string;
+};
+export type EcommercePartnerConfiguration = {
+    ecommercePartnerId: number;
+    name: string;
+    externalId: number | null;
+    active: boolean;
+    defaults?: EcommercePartnerDefaults;
+};
+export type EcommercePartnerDefaults = {
+    global: EcommerceSharedDefaults;
+    store: EcommerceStoreConfig[];
+};
+export type EcommerceSharedDefaults = {
+    brandMapping?: string;
+    conditionDescription?: string;
+    conditionId?: number;
+    fulfillmentPolicies?: string[];
+    fulfillmentTimeUnit?: string;
+    fulfillmentTimeValue?: number;
+    listingDescriptionTemplate?: string;
+    listingDuration?: string;
+    listingFormat?: string;
+    listingTitleTemplate?: string;
+    manufacturerPartNumberMapping?: string;
+    oemNumberMapping?: string;
+    packageType?: string;
+    paymentPolicies?: string[];
+    pricingModifier?: number;
+    returnPolicies?: string[];
+    shippingLengthUnit?: string;
+    shippingWeightUnit?: string;
+    storePickupAllowed?: boolean;
+};
+export type EcommerceStoreConfig = {
+    active: boolean;
+    defaults: EcommerceSharedDefaults;
+    merchantLocationKey?: string;
+    name: string;
+    storeId: number;
+};
+export interface ExtendedEbayCategoryMap extends EbayCategoryMap {
+    ebayCategoryName: string;
+    inventoryTypeName: string;
+}
+export interface ExtendedEcommerceConditionMap extends EcommerceConditionMap {
+    conditionId: number;
+    name: string;
+}
+export interface ExtendedInventoryTypeListingDefaults extends InventoryTypeListingDefaults {
+    categoryName: string;
+    inventoryType: number;
+    inventoryTypeName: string;
+}
+export type FileItem = {
+    createdDate: string;
+    fileId: number;
+    md5sum: string;
+    mimeType: string;
+    path: string;
+    public: boolean;
+    name: string;
+    rank: number;
+    size: number;
+    type: string;
+    updatedDate: string;
+};
+export type ImageUrl = {
+    fileId: number;
+    fileName: string;
+    rank: number;
+    mimeType: string;
+};
+export interface ImageUrlsWithName {
+    fileId: number;
+    name: string;
+    url: string;
+}
+export type InventoryDetailsForTemplate = {
+    inventoryId?: number;
+    vehicleMake?: string;
+    vehicleModel?: string;
+    year?: number;
+    description?: string;
+    price?: number;
+    manufacturer?: string;
+    model?: string;
+    partType?: string;
+    category?: string;
+    store?: string;
+    productCode?: number;
+    tagNumber?: string;
+    condition?: string;
+    flexLabel1?: string;
+    flexLabel2?: string;
+    flexLabel3?: string;
+    flexLabel4?: string;
+    flexValue1?: string;
+    flexValue2?: string;
+    flexValue3?: string;
+    flexValue4?: string;
+    oemNumber?: string;
+    side?: string;
+    make?: string;
+    serialNumber?: string;
+    weight?: number;
+    upc?: string;
+    notes?: string;
+    quantity?: number;
+    partManufacturer?: string;
+    partModel?: string;
+};
+export interface InventoryListingDetail {
+    inventoryListingDetailId: number;
+    active: boolean;
+    convertedListingDetails: ConvertedEbayListingDetails | null;
+    duration: string | null;
+    ecommercePartnerId: number;
+    ecommerceCategoryId: number | null;
+    ecommerceConditionId: number | null;
+    ecommerceConditionDescription: string | null;
+    fulfillmentTime: number | null;
+    fulfillmentTimeUnit: string | null;
+    imageUrls: ImageUrl[];
+    inventoryId: number;
+    inventoryDescription: string | null;
+    lastUpdate: string;
+    listingDescription: string | null;
+    listingStatus: 'error' | 'listed' | 'pending' | 'cancelled';
+    listingTitle: string | null;
+    manufacturerPartNumber: string | null;
+    message: MessageObj[];
+    price: number | null;
+    quantity: number | null;
+    sku: string | null;
+    storeId: number;
+    upc: string;
+    partnerSpecificDetails: EbaySpecificListingDetails;
+    shippingLength: number | null;
+    shippingWidth: number | null;
+    shippingHeight: number | null;
+    shippingLengthUnit: string | null;
+    shippingPackage: string | null;
+    weight: number | null;
+    weightUnit: string | null;
+}
+export type InventoryType = {
+    inventoryTypeId: number;
+    name: string;
+    partListAuthorityId: number | null;
+    vehicleUnit: boolean;
+    willShowOnline: boolean;
+};
+export type InventoryTypeCategory = {
+    categoryId: number;
+    description: string | null;
+    isoftCategoryId: number | null;
+    name: string;
+    partListAuthorityId: number | null;
+    typeSetId: number;
+    userEditable: boolean;
+};
+export type InventoryTypeListingDefaults = {
+    active: boolean;
+    categoryId?: number;
+    defaults: EcommerceSharedDefaults;
+    ecommercePartnerId: number;
+    inventoryTypeId: number;
+    inventoryTypeListingConfigurationId: number;
+};
+export interface InventoryRow {
+    inventoryId: number;
+    storeId: number;
+    tagNumber: string | null;
+    inventoryTypeId: number | null;
+    partManufacturer: string | null;
+    partModel: string | null;
+    category: string | null;
+    parentInventoryId: number;
+    vehicleId: number | null;
+    vin: string;
+    make: string;
+    model: string;
+    year: number | null;
+    bodyStyle: string | null;
+    core: number | null;
+    cost: number | null;
+    retailPrice: number | null;
+    wholesalePrice: number | null;
+    listPrice: number | null;
+    status: string;
+    side: 'Left' | 'Right' | '';
+    location: string | null;
+    condition: string | null;
+    serialNumber: string | null;
+    oemNumber: string | null;
+    upc: string;
+    replenish: boolean;
+    deplete: boolean;
+    isTaxable: boolean;
+    isWorldViewable: boolean;
+    tag: string;
+    isTagPerQuantity: string;
+    quantity: number | null;
+    minimumQuantity: number | null;
+    maximumQuantity: number | null;
+    description: string | null;
+    notes: string | null;
+    weight: number;
+    shippingLength: number | null;
+    shippingWidth: number | null;
+    shippingHeight: number | null;
+    label1: string;
+    data1: string;
+    label2: string;
+    data2: string;
+    label3: string;
+    data3: string;
+    label4: string;
+    data4: string;
+    interchangeNumber: string;
+    interchangeOptionNotes: string | null;
+    enteredDate: Date | string;
+    lastModifiedDate: Date | string;
+    lastModifiedByUser: string | null;
+    enteredByUser: string;
+    partFirstYear: string | null;
+    partLastYear: string | null;
+    destination: string;
+    buildId: number | null;
+    vendorId: number | null;
+    saleClassCode: string | null;
+    searchKeywords: string | null;
+}
+export interface MessageObj {
+    type: string;
+    messages: unknown[];
+}
+export type NewEcommerceConditionMap = Omit<EcommerceConditionMap, 'ecommerceConditionMapId'>;
+export type NewInventoryTypeListingDefaults = Omit<InventoryTypeListingDefaults, 'inventoryTypeListingConfigurationId'>;
+export type NewInventoryListingDetail = Omit<InventoryListingDetail, 'inventoryListingDetailId'>;
+export type NewConditionMappingState = {
+    ecommerceConditionMapId?: number;
+    ecommercePartnerId?: number;
+    itrackCondition: string | null;
+    ecommerceConditionId: number | null;
+    description: string | null;
+};
+export interface SelectedEbayCategoryMapRow extends ExtendedEbayCategoryMap {
+    originalIndex: number;
+    uuid: string;
+}
+export type Store = {
+    companyCode?: number;
+    storeId: number;
+    name: string;
+};

package/dist/utils.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@isoftdata/svelte-ecommerce",
+  "version": "1.0.0-beta.0",
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/*.spec.*"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "svelte": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js"
+    }
+  },
+  "peerDependencies": {
+    "svelte": "^5.23.2"
+  },
+  "devDependencies": {
+    "@isoftdata/prettier-config": "^2.0.4",
+    "@sveltejs/adapter-auto": "^4.0.0",
+    "@sveltejs/kit": "^2.16.0",
+    "@sveltejs/package": "^2.0.0",
+    "@sveltejs/vite-plugin-svelte": "^5.0.0",
+    "prettier": "^3.6.2",
+    "prettier-plugin-svelte": "^3.4.0",
+    "publint": "^0.3.2",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vite": "^6.0.0"
+  },
+  "keywords": [
+    "svelte"
+  ],
+  "prettier": "@isoftdata/prettier-config",
+  "dependencies": {
+    "@isoftdata/svelte-attachments": "2.2.1",
+    "@isoftdata/svelte-button": "^2.1.1",
+    "@isoftdata/svelte-checkbox": "^2.5.0",
+    "@isoftdata/svelte-currency-input": "^2.0.1",
+    "@isoftdata/svelte-input": "^2.1.1",
+    "@isoftdata/svelte-modal": "^2.0.11",
+    "@isoftdata/svelte-select": "^2.0.4",
+    "@isoftdata/svelte-table": "^2.6.6",
+    "@isoftdata/svelte-textarea": "^2.1.0",
+    "@isoftdata/svelte-user-prompt": "^1.1.0",
+    "@isoftdata/utility-string": "^2.1.1",
+    "@lukeed/uuid": "2.0.1",
+    "i18next": "^25.5.3",
+    "klona": "^1.1.2",
+    "svelte": "^5.23.2"
+  },
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build && npm run prepack",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch"
+  }
+}