@unchainedshop/plugins 5.0.0-alpha.2 → 5.0.0-alpha.3

package/lib/pricing/tax/eu.d.ts

@@ -0,0 +1,12 @@
+import type { DeliveryProvider } from '@unchainedshop/core-delivery';
+import type { Product } from '@unchainedshop/core-products';
+export declare const EU_TAX_CATEGORY_TAG_PREFIX = "eu-tax-category:";
+export declare const EU_MEMBER_COUNTRY_CODES: string[];
+export declare const isEuMemberCountry: (countryCode?: string | null) => boolean;
+export declare const resolveEuTaxRate: ({ countryCode, category, referenceDate, }: {
+    countryCode?: string | null;
+    category?: string | null;
+    referenceDate?: Date;
+}) => number | null;
+export declare const resolveEuTaxCategoryFromProduct: (product: Product) => string | null;
+export declare const resolveEuTaxCategoryFromDeliveryProvider: (provider: DeliveryProvider) => string | null;

package/lib/pricing/tax/eu.js

@@ -0,0 +1,38 @@
+import euTaxRates from './eu-tax-rates.json' with { type: 'json' };
+import { compileEraRates, rateForDate } from "./eraRates.js";
+export const EU_TAX_CATEGORY_TAG_PREFIX = 'eu-tax-category:';
+const PROVIDER_CONFIGURATION_KEY = 'eu-tax-category';
+const countryRates = Object.fromEntries(Object.entries(euTaxRates.countries).map(([countryCode, categories]) => [
+    countryCode,
+    Object.fromEntries(Object.entries(categories).map(([category, eras]) => [
+        category,
+        rateForDate(compileEraRates(eras, euTaxRates.timezone)),
+    ])),
+]));
+const normalizeCountryCode = (countryCode) => {
+    const normalized = countryCode?.toUpperCase().trim() || null;
+    return normalized === 'EL' ? 'GR' : normalized;
+};
+export const EU_MEMBER_COUNTRY_CODES = Object.keys(countryRates);
+export const isEuMemberCountry = (countryCode) => {
+    const normalized = normalizeCountryCode(countryCode);
+    return Boolean(normalized && countryRates[normalized]);
+};
+export const resolveEuTaxRate = ({ countryCode, category, referenceDate, }) => {
+    const normalized = normalizeCountryCode(countryCode);
+    const categories = normalized ? countryRates[normalized] : null;
+    if (!categories)
+        return null;
+    const resolveRate = (category && categories[category]) || categories.standard;
+    return resolveRate(referenceDate);
+};
+export const resolveEuTaxCategoryFromProduct = (product) => {
+    const categoryTag = product?.tags?.find((tag) => tag?.trim().toLowerCase().startsWith(EU_TAX_CATEGORY_TAG_PREFIX));
+    if (!categoryTag)
+        return null;
+    return categoryTag.trim().toLowerCase().slice(EU_TAX_CATEGORY_TAG_PREFIX.length) || null;
+};
+export const resolveEuTaxCategoryFromDeliveryProvider = (provider) => {
+    const value = provider?.configuration?.find(({ key }) => key === PROVIDER_CONFIGURATION_KEY)?.value;
+    return value?.trim().toLowerCase() || null;
+};

package/lib/pricing/tax/uk-tax-rates.json

@@ -0,0 +1,18 @@
+{
+    "source": "https://www.gov.uk/vat-rates",
+    "verifiedAt": "2026-08-20",
+    "timezone": "+00:00",
+    "categories": {
+        "standard": [
+            { "validFrom": "1991-04-01", "rate": 0.175 },
+            { "validFrom": "2008-12-01", "rate": 0.15 },
+            { "validFrom": "2010-01-01", "rate": 0.175 },
+            { "validFrom": "2011-01-04", "rate": 0.2 }
+        ],
+        "reduced": [
+            { "validFrom": "1994-04-01", "rate": 0.08 },
+            { "validFrom": "1997-09-01", "rate": 0.05 }
+        ],
+        "zero": [{ "validFrom": "1973-04-01", "rate": 0 }]
+    }
+}

package/lib/pricing/tax/uk.d.ts

@@ -0,0 +1,10 @@
+import type { DeliveryProvider } from '@unchainedshop/core-delivery';
+import type { Product } from '@unchainedshop/core-products';
+export declare const UK_VAT_COUNTRY_CODES: string[];
+export interface UkTaxCategoryResolver {
+    value: string;
+    rate: (referenceDate?: Date) => number;
+}
+export declare const UkTaxCategories: Record<string, UkTaxCategoryResolver>;
+export declare const resolveUkTaxCategoryFromDeliveryProvider: (provider: DeliveryProvider) => UkTaxCategoryResolver | null;
+export declare const resolveUkTaxCategoryFromProduct: (product: Product) => UkTaxCategoryResolver | null;

package/lib/pricing/tax/uk.js

@@ -0,0 +1,23 @@
+import ukTaxRates from './uk-tax-rates.json' with { type: 'json' };
+import { compileEraRates, rateForDate } from "./eraRates.js";
+export const UK_VAT_COUNTRY_CODES = ['GB', 'IM'];
+export const UkTaxCategories = Object.fromEntries(Object.entries(ukTaxRates.categories).map(([value, eras]) => [
+    value.toUpperCase(),
+    { value, rate: rateForDate(compileEraRates(eras, ukTaxRates.timezone)) },
+]));
+export const resolveUkTaxCategoryFromDeliveryProvider = (provider) => {
+    const taxCategoryFromProvider = provider?.configuration
+        ?.find(({ key }) => {
+        if (key === 'uk-tax-category')
+            return true;
+        return null;
+    })
+        ?.value?.toUpperCase();
+    const taxCategory = taxCategoryFromProvider ? UkTaxCategories[taxCategoryFromProvider] : null;
+    return taxCategory;
+};
+export const resolveUkTaxCategoryFromProduct = (product) => {
+    const productSpecialTaxTag = product?.tags?.find((tag) => tag?.trim().toLowerCase().startsWith('uk-tax-category:'));
+    const taxCategory = Object.values(UkTaxCategories).find((t) => `uk-tax-category:${t.value}` === productSpecialTaxTag?.trim().toLowerCase());
+    return taxCategory || null;
+};

package/lib/pricing/tax/us-tax-rates.json

@@ -0,0 +1,334 @@
+{
+    "source": "https://taxfoundation.org/data/all/state/2026-sales-tax-rates-midyear/",
+    "verifiedAt": "2026-08-20",
+    "timezone": "-06:00",
+    "states": {
+        "AK": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0
+            }
+        ],
+        "AL": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.04
+            }
+        ],
+        "AR": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.065
+            }
+        ],
+        "AZ": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.056
+            }
+        ],
+        "CA": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0725,
+                "note": "6.0% state + 1.25% mandatory statewide local"
+            }
+        ],
+        "CO": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.029
+            }
+        ],
+        "CT": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0635
+            }
+        ],
+        "DC": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            },
+            {
+                "validFrom": "2026-10-01",
+                "rate": 0.07,
+                "note": "enacted increase per DC OTR notice"
+            }
+        ],
+        "DE": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0
+            }
+        ],
+        "FL": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "GA": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.04
+            }
+        ],
+        "HI": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.04,
+                "note": "general excise tax (GET)"
+            }
+        ],
+        "IA": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "ID": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "IL": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0625
+            }
+        ],
+        "IN": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.07
+            }
+        ],
+        "KS": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.065
+            }
+        ],
+        "KY": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "LA": [
+            {
+                "validFrom": "2018-07-01",
+                "rate": 0.0445
+            },
+            {
+                "validFrom": "2025-01-01",
+                "rate": 0.05,
+                "note": "Act 11 (2024); scheduled to drop to 4.75% from 2030"
+            }
+        ],
+        "MA": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0625
+            }
+        ],
+        "MD": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "ME": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.055
+            }
+        ],
+        "MI": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "MN": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06875
+            }
+        ],
+        "MO": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.04225
+            }
+        ],
+        "MS": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.07
+            }
+        ],
+        "MT": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0
+            }
+        ],
+        "NC": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0475
+            }
+        ],
+        "ND": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.05
+            }
+        ],
+        "NE": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.055
+            }
+        ],
+        "NH": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0
+            }
+        ],
+        "NJ": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06625
+            }
+        ],
+        "NM": [
+            {
+                "validFrom": "2022-07-01",
+                "rate": 0.05
+            },
+            {
+                "validFrom": "2023-07-01",
+                "rate": 0.04875,
+                "note": "gross receipts tax (HB 163, 2022)"
+            }
+        ],
+        "NV": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0685,
+                "note": "includes mandatory statewide-levied components"
+            }
+        ],
+        "NY": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.04
+            }
+        ],
+        "OH": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0575
+            }
+        ],
+        "OK": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.045
+            }
+        ],
+        "OR": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0
+            }
+        ],
+        "PA": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "RI": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.07
+            }
+        ],
+        "SC": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "SD": [
+            {
+                "validFrom": "2023-07-01",
+                "rate": 0.042,
+                "note": "HB 1137 temporary cut; reverts to 4.5% on 2027-07-01 unless extended"
+            }
+        ],
+        "TN": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.07
+            }
+        ],
+        "TX": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.0625
+            }
+        ],
+        "UT": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.061,
+                "note": "includes 1.25% mandatory statewide local add-on"
+            }
+        ],
+        "VA": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.053,
+                "note": "4.3% state + 1% mandatory statewide local"
+            }
+        ],
+        "VT": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "WA": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.065
+            }
+        ],
+        "WI": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.05
+            }
+        ],
+        "WV": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.06
+            }
+        ],
+        "WY": [
+            {
+                "validFrom": "2026-07-01",
+                "rate": 0.04
+            }
+        ]
+    }
+}

package/lib/pricing/tax/us.d.ts

@@ -0,0 +1,11 @@
+import type { DeliveryProvider } from '@unchainedshop/core-delivery';
+import type { Product } from '@unchainedshop/core-products';
+export declare const US_COUNTRY_CODE = "US";
+export declare const US_SALES_TAX_EXEMPT_VALUE = "exempt";
+export declare const US_STATE_CODES: string[];
+export declare const resolveUsSalesTaxRate: ({ regionCode, referenceDate, }: {
+    regionCode?: string | null;
+    referenceDate?: Date;
+}) => number | null;
+export declare const isProductExemptFromUsSalesTax: (product: Product) => boolean;
+export declare const isDeliveryExemptFromUsSalesTax: (provider: DeliveryProvider) => boolean;

package/lib/pricing/tax/us.js

@@ -0,0 +1,20 @@
+import usTaxRates from './us-tax-rates.json' with { type: 'json' };
+import { compileEraRates, rateForDate } from "./eraRates.js";
+export const US_COUNTRY_CODE = 'US';
+export const US_SALES_TAX_EXEMPT_VALUE = 'exempt';
+const stateRates = Object.fromEntries(Object.entries(usTaxRates.states).map(([stateCode, eras]) => [
+    stateCode,
+    rateForDate(compileEraRates(eras, usTaxRates.timezone)),
+]));
+export const US_STATE_CODES = Object.keys(stateRates);
+export const resolveUsSalesTaxRate = ({ regionCode, referenceDate, }) => {
+    const resolveRate = regionCode ? stateRates[regionCode.toUpperCase().trim()] : null;
+    if (!resolveRate)
+        return null;
+    return resolveRate(referenceDate);
+};
+export const isProductExemptFromUsSalesTax = (product) => Boolean(product?.tags?.some((tag) => tag?.trim().toLowerCase() === `us-tax-category:${US_SALES_TAX_EXEMPT_VALUE}`));
+export const isDeliveryExemptFromUsSalesTax = (provider) => provider?.configuration
+    ?.find(({ key }) => key === 'us-tax-category')
+    ?.value?.trim()
+    .toLowerCase() === US_SALES_TAX_EXEMPT_VALUE;

package/lib/pricing/utils/isDeliveryAddressInCountry.d.ts

@@ -1,5 +1,5 @@
 import type { Order, OrderDelivery } from '@unchainedshop/core-orders';
-export default function isDeliveryAddressInCountry({ orderDelivery, order, countryCode: forceCountryCode, }: {
+export default function isDeliveryAddressInCountry(params: {
     orderDelivery?: OrderDelivery | null;
     order?: Order | null;
     countryCode?: string | null;

package/lib/pricing/utils/isDeliveryAddressInCountry.js

@@ -1,11 +1,6 @@
-export default function isDeliveryAddressInCountry({ orderDelivery, order, countryCode: forceCountryCode = null, }, allowedCountryCodes) {
-    let countryCode = forceCountryCode?.toUpperCase().trim() || order?.countryCode;
-    if (orderDelivery || order) {
-        const address = orderDelivery?.context?.address || order?.billingAddress;
-        if (address?.countryCode > '') {
-            countryCode = address.countryCode?.toUpperCase().trim();
-        }
-    }
+import resolveDeliveryLocation from "./resolveDeliveryLocation.js";
+export default function isDeliveryAddressInCountry(params, allowedCountryCodes) {
+    const { countryCode } = resolveDeliveryLocation(params);
     if (!countryCode)
         return false;
     return allowedCountryCodes.includes(countryCode);

package/lib/pricing/utils/resolveDeliveryLocation.d.ts

@@ -0,0 +1,10 @@
+import type { Order, OrderDelivery } from '@unchainedshop/core-orders';
+export interface DeliveryLocation {
+    countryCode: string | null;
+    regionCode: string | null;
+}
+export default function resolveDeliveryLocation({ orderDelivery, order, countryCode: forceCountryCode, }: {
+    orderDelivery?: OrderDelivery | null;
+    order?: Order | null;
+    countryCode?: string | null;
+}): DeliveryLocation;

package/lib/pricing/utils/resolveDeliveryLocation.js

@@ -0,0 +1,9 @@
+export default function resolveDeliveryLocation({ orderDelivery, order, countryCode: forceCountryCode = null, }) {
+    const address = orderDelivery?.context?.address || order?.billingAddress;
+    let countryCode = forceCountryCode?.toUpperCase().trim() || order?.countryCode || null;
+    if (address?.countryCode && address.countryCode > '') {
+        countryCode = address.countryCode.toUpperCase().trim();
+    }
+    const regionCode = address?.regionCode?.toUpperCase().trim() || null;
+    return { countryCode, regionCode };
+}

package/lib/quotations/manual/adapter.js

@@ -10,8 +10,13 @@ export const ManualOffering = {
         return {
             ...QuotationAdapter.actions(params),
             quote: async () => {
+                const { quotation } = params;
+                const price = Number(quotation?.context?.price);
                 return {
-                    expires: new Date(new Date().getTime() + 3600 * 1000),
+                    expires: quotation?.context?.expires
+                        ? new Date(quotation.context.expires)
+                        : new Date(new Date().getTime() + 3600 * 1000),
+                    price: Number.isFinite(price) && price > 0 ? Math.round(price) : undefined,
                 };
             },
         };

package/lib/quotations/manual.js

@@ -10,8 +10,13 @@ const ManualOffering = {
         return {
             ...QuotationAdapter.actions(params),
             quote: async () => {
+                const { quotation } = params;
+                const price = Number(quotation?.context?.price);
                 return {
-                    expires: new Date(new Date().getTime() + 3600 * 1000),
+                    expires: quotation?.context?.expires
+                        ? new Date(quotation.context.expires)
+                        : new Date(new Date().getTime() + 3600 * 1000),
+                    price: Number.isFinite(price) && price > 0 ? Math.round(price) : undefined,
                 };
             },
         };

package/lib/worker/gc-guests/adapter.d.ts

@@ -0,0 +1,9 @@
+import { type IWorkerAdapter } from '@unchainedshop/core';
+export declare const GCGuestsWorker: IWorkerAdapter<{
+    guestUserMaxAgeInDays?: number;
+}, {
+    scannedGuestCount: number;
+    deletedGuestCount: number;
+}>;
+export default GCGuestsWorker;
+export declare const configureGCGuestsAutoscheduling: () => void;

package/lib/worker/gc-guests/adapter.js

@@ -0,0 +1,56 @@
+import { WorkerAdapter, WorkerDirector, schedule } from '@unchainedshop/core';
+import { userSettings } from '@unchainedshop/core-users';
+import { createLogger } from '@unchainedshop/logger';
+const logger = createLogger('unchained:worker:gc-guests');
+const ONE_DAY_IN_MILLISECONDS = 86400000;
+const everyDayAtHalfPastTwo = schedule.parse.cron('30 2 * * *');
+export const GCGuestsWorker = {
+    ...WorkerAdapter,
+    key: 'shop.unchained.worker-plugin.gc-guests',
+    label: 'Garbage Collect Guests',
+    version: '1.0.0',
+    type: 'GC_GUESTS',
+    doWork: async ({ guestUserMaxAgeInDays } = {}, unchainedAPI) => {
+        const { modules, services } = unchainedAPI;
+        try {
+            const maxAgeInDays = guestUserMaxAgeInDays ?? userSettings.guestUserMaxAgeInDays;
+            const before = new Date(Date.now() - maxAgeInDays * ONE_DAY_IN_MILLISECONDS);
+            const userIdsToDelete = await modules.users.findGuestUserIds({ before });
+            let deletedGuestCount = 0;
+            await Array.fromAsync(userIdsToDelete, async (userId) => {
+                try {
+                    await services.users.deleteUser({ userId });
+                    deletedGuestCount += 1;
+                }
+                catch (err) {
+                    logger.warn(`Failed to garbage-collect guest ${userId}: ${err.message}`);
+                }
+            });
+            return {
+                success: true,
+                result: {
+                    scannedGuestCount: userIdsToDelete.length,
+                    deletedGuestCount,
+                },
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: {
+                    name: err.name,
+                    message: err.message,
+                    stack: err.stack,
+                },
+            };
+        }
+    },
+};
+export default GCGuestsWorker;
+export const configureGCGuestsAutoscheduling = () => {
+    WorkerDirector.configureAutoscheduling({
+        type: GCGuestsWorker.type,
+        schedule: everyDayAtHalfPastTwo,
+        retries: 0,
+    });
+};

package/lib/worker/gc-guests/index.d.ts

@@ -0,0 +1,4 @@
+import { type IPlugin } from '@unchainedshop/core';
+export declare const GCGuestsPlugin: IPlugin;
+export default GCGuestsPlugin;
+export * from './adapter.ts';

package/lib/worker/gc-guests/index.js

@@ -0,0 +1,13 @@
+import {} from '@unchainedshop/core';
+import { GCGuestsWorker, configureGCGuestsAutoscheduling } from "./adapter.js";
+export const GCGuestsPlugin = {
+    key: 'shop.unchained.worker-plugin.gc-guests',
+    label: 'Garbage Collect Guests Worker Plugin',
+    version: '1.0.0',
+    adapters: [GCGuestsWorker],
+    onRegister: () => {
+        configureGCGuestsAutoscheduling();
+    },
+};
+export default GCGuestsPlugin;
+export * from "./adapter.js";

package/lib/worker/gc-guests.d.ts

@@ -0,0 +1,8 @@
+import { type IWorkerAdapter } from '@unchainedshop/core';
+export declare const GCGuestsWorker: IWorkerAdapter<{
+    guestUserMaxAgeInDays?: number;
+}, {
+    scannedGuestCount: number;
+    deletedGuestCount: number;
+}>;
+export default GCGuestsWorker;