@unifiedcommerce/core 0.0.1

package/dist/modules/search/service.d.ts

@@ -0,0 +1,24 @@
+import { type Result } from "../../kernel/result";
+import type { TxContext } from "../../kernel/database/tx-context";
+import type { CatalogRepository } from "../catalog/repository";
+import type { SearchAdapter, SearchQueryParams, SearchQueryResult, SearchSuggestParams } from "./adapter";
+interface SearchServiceDeps {
+    catalogRepository: CatalogRepository;
+    adapter?: SearchAdapter;
+    defaultFacets?: string[];
+}
+export declare class SearchService {
+    private deps;
+    constructor(deps: SearchServiceDeps);
+    private entityCategories;
+    private entityBrands;
+    private buildDocument;
+    private allDocuments;
+    private matchesFilters;
+    private computeFacets;
+    syncEntity(entityId: string, ctx?: TxContext): Promise<Result<void>>;
+    query(params: SearchQueryParams, ctx?: TxContext): Promise<Result<SearchQueryResult>>;
+    suggest(params: SearchSuggestParams, ctx?: TxContext): Promise<Result<string[]>>;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/search/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/search/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EACV,aAAa,EAGb,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,WAAW,CAAC;AAEnB,UAAU,iBAAiB;IACzB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAuCD,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,iBAAiB;YAE7B,gBAAgB;YAwBhB,YAAY;YAwBZ,aAAa;YAyCb,YAAY;IAY1B,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,aAAa;IAgDf,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAcpE,KAAK,CACT,MAAM,EAAE,iBAAiB,EACzB,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IA8C/B,OAAO,CACX,MAAM,EAAE,mBAAmB,EAC3B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;CA2B7B"}

package/dist/modules/search/service.js

@@ -0,0 +1,217 @@
+import { Ok } from "../../kernel/result";
+import { resolveOrgId } from "../../auth/org";
+function unique(values) {
+    return [...new Set(values)];
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+function tokenize(query) {
+    return query
+        .toLowerCase()
+        .split(/\s+/)
+        .map((part) => part.trim())
+        .filter(Boolean);
+}
+function includesAllTokens(haystack, tokens) {
+    if (tokens.length === 0)
+        return true;
+    const lower = haystack.toLowerCase();
+    return tokens.every((token) => lower.includes(token));
+}
+function scoreText(document, tokens) {
+    if (tokens.length === 0)
+        return 1;
+    const title = document.title.toLowerCase();
+    const text = document.text.toLowerCase();
+    let score = 0;
+    for (const token of tokens) {
+        if (title.includes(token))
+            score += 2;
+        if (text.includes(token))
+            score += 1;
+    }
+    return score;
+}
+export class SearchService {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async entityCategories(entityId, ctx) {
+        const entries = await this.deps.catalogRepository.findEntityCategories(entityId, ctx);
+        const slugs = (await Promise.all(entries.map(async (entry) => {
+            const category = await this.deps.catalogRepository.findCategoryById(entry.categoryId, ctx);
+            return category?.slug;
+        }))).filter((slug) => typeof slug === "string");
+        return unique(slugs);
+    }
+    async entityBrands(entityId, ctx) {
+        const entries = await this.deps.catalogRepository.findEntityBrands(entityId, ctx);
+        const slugs = (await Promise.all(entries.map(async (entry) => {
+            const brand = await this.deps.catalogRepository.findBrandById(entry.brandId, ctx);
+            return brand?.slug;
+        }))).filter((slug) => typeof slug === "string");
+        return unique(slugs);
+    }
+    async buildDocument(entity, ctx) {
+        const attributes = await this.deps.catalogRepository.findAttributesByEntityId(entity.id, ctx);
+        const primary = attributes[0];
+        const title = primary?.title ?? entity.slug;
+        const description = primary?.description;
+        const categories = await this.entityCategories(entity.id, ctx);
+        const brands = await this.entityBrands(entity.id, ctx);
+        const textParts = [
+            entity.slug,
+            title,
+            description ?? "",
+            ...categories,
+            ...brands,
+            ...attributes.map((attr) => attr.title),
+            ...attributes.map((attr) => attr.description ?? ""),
+        ];
+        return {
+            id: entity.id,
+            type: entity.type,
+            slug: entity.slug,
+            title,
+            ...(description ? { description } : {}),
+            status: entity.status,
+            categories,
+            brands,
+            text: textParts.join(" ").trim(),
+            payload: {
+                metadata: entity.metadata ?? undefined,
+            },
+        };
+    }
+    async allDocuments(ctx) {
+        const orgId = resolveOrgId(ctx?.actor ?? null);
+        const entities = await this.deps.catalogRepository.findEntities(orgId, undefined, ctx);
+        return Promise.all(entities.map((entity) => this.buildDocument(entity, ctx)));
+    }
+    matchesFilters(document, filters) {
+        if (!filters)
+            return true;
+        if (filters.type && document.type !== filters.type)
+            return false;
+        if (filters.status && document.status !== filters.status)
+            return false;
+        if (filters.category && !document.categories.includes(filters.category))
+            return false;
+        if (filters.brand && !document.brands.includes(filters.brand))
+            return false;
+        return true;
+    }
+    computeFacets(documents, requested) {
+        const facets = requested && requested.length > 0
+            ? requested
+            : (this.deps.defaultFacets ?? ["type", "category", "brand", "status"]);
+        const output = {};
+        for (const facet of facets) {
+            if (facet === "type") {
+                output.type = {};
+                for (const document of documents) {
+                    output.type[document.type] = (output.type[document.type] ?? 0) + 1;
+                }
+            }
+            if (facet === "status") {
+                output.status = {};
+                for (const document of documents) {
+                    const status = document.status ?? "unknown";
+                    output.status[status] = (output.status[status] ?? 0) + 1;
+                }
+            }
+            if (facet === "category" || facet === "categories") {
+                output.category = {};
+                for (const document of documents) {
+                    for (const category of document.categories) {
+                        output.category[category] = (output.category[category] ?? 0) + 1;
+                    }
+                }
+            }
+            if (facet === "brand" || facet === "brands") {
+                output.brand = {};
+                for (const document of documents) {
+                    for (const brand of document.brands) {
+                        output.brand[brand] = (output.brand[brand] ?? 0) + 1;
+                    }
+                }
+            }
+        }
+        return output;
+    }
+    async syncEntity(entityId, ctx) {
+        if (!this.deps.adapter)
+            return Ok(undefined);
+        const entity = await this.deps.catalogRepository.findEntityById(entityId, ctx);
+        if (!entity) {
+            return this.deps.adapter.remove([entityId]);
+        }
+        return this.deps.adapter.index([await this.buildDocument(entity, ctx)]);
+    }
+    async query(params, ctx) {
+        const page = clamp(params.page ?? 1, 1, 100000);
+        const limit = clamp(params.limit ?? 20, 1, 100);
+        if (this.deps.adapter) {
+            return this.deps.adapter.search({
+                ...params,
+                page,
+                limit,
+            });
+        }
+        const tokens = tokenize(params.query);
+        const allDocs = await this.allDocuments(ctx);
+        const filtered = allDocs.filter((document) => {
+            if (!this.matchesFilters(document, params.filters))
+                return false;
+            if (tokens.length === 0)
+                return true;
+            return includesAllTokens(document.text, tokens);
+        });
+        const scored = filtered
+            .map((document) => ({
+            document,
+            score: scoreText(document, tokens),
+        }))
+            .sort((first, second) => {
+            if (second.score !== first.score)
+                return second.score - first.score;
+            return first.document.title.localeCompare(second.document.title);
+        });
+        const offset = (page - 1) * limit;
+        const hits = scored.slice(offset, offset + limit).map((row) => ({
+            id: row.document.id,
+            score: row.score,
+            document: row.document,
+        }));
+        return Ok({
+            hits,
+            total: scored.length,
+            page,
+            limit,
+            facets: this.computeFacets(filtered, params.facets),
+        });
+    }
+    async suggest(params, ctx) {
+        const limit = clamp(params.limit ?? 10, 1, 25);
+        const prefix = params.prefix.trim().toLowerCase();
+        if (prefix.length === 0)
+            return Ok([]);
+        if (this.deps.adapter) {
+            return this.deps.adapter.suggest({
+                ...params,
+                prefix,
+                limit,
+            });
+        }
+        const allDocs = await this.allDocuments(ctx);
+        const titles = allDocs
+            .filter((document) => (!params.type || document.type === params.type) &&
+            document.title.toLowerCase().startsWith(prefix))
+            .map((document) => document.title)
+            .filter((title, index, list) => list.indexOf(title) === index)
+            .slice(0, limit);
+        return Ok(titles);
+    }
+}

package/dist/modules/shipping/calculator.d.ts

@@ -0,0 +1,42 @@
+import type { CommerceConfig } from "../../config/types";
+import type { TxContext } from "../../kernel/database/tx-context";
+import type { CatalogRepository } from "../catalog/repository";
+export interface ShippingAddress {
+    country: string;
+    postalCode: string;
+    state?: string;
+    city?: string;
+    line1?: string;
+}
+export interface ShippingLineItem {
+    entityId: string;
+    variantId?: string;
+    quantity: number;
+    resolvedTotal: number;
+}
+export type ShippingStrategy = {
+    type: "flat";
+    flatRate: number;
+    freeShippingThreshold?: number;
+} | {
+    type: "weight_based";
+    brackets: Array<{
+        upToGrams: number;
+        cost: number;
+    }>;
+    fallbackCost: number;
+    freeShippingThreshold?: number;
+};
+export interface ShippingCalculationInput {
+    lineItems: ShippingLineItem[];
+    subtotalAfterDiscount: number;
+    currency: string;
+    address?: ShippingAddress;
+    isFreeShipping: boolean;
+}
+export declare function calculateShippingCost(config: CommerceConfig, catalogRepo: CatalogRepository, input: ShippingCalculationInput, ctx?: TxContext): Promise<{
+    amount: number;
+    strategy: string;
+    weightGrams: number;
+}>;
+//# sourceMappingURL=calculator.d.ts.map

package/dist/modules/shipping/calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../../src/modules/shipping/calculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEN,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;CACzB;AAiFD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,iBAAiB,EAC9B,KAAK,EAAE,wBAAwB,EAC/B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA+DpE"}

package/dist/modules/shipping/calculator.js

@@ -0,0 +1,91 @@
+async function resolveWeightGrams(catalogRepo, entityId, variantId, ctx) {
+    if (variantId !== undefined) {
+        const variant = await catalogRepo.findVariantById(variantId, ctx);
+        const weightFromVariant = variant?.metadata?.weightGrams;
+        if (typeof weightFromVariant === "number" &&
+            Number.isFinite(weightFromVariant)) {
+            return Math.max(0, Math.round(weightFromVariant));
+        }
+    }
+    const entity = await catalogRepo.findEntityById(entityId, ctx);
+    const weightFromEntity = entity?.metadata
+        ?.weightGrams;
+    if (typeof weightFromEntity === "number" &&
+        Number.isFinite(weightFromEntity)) {
+        return Math.max(0, Math.round(weightFromEntity));
+    }
+    return 0;
+}
+async function isShippableEntity(config, catalogRepo, entityId, ctx) {
+    const entity = await catalogRepo.findEntityById(entityId, ctx);
+    if (!entity)
+        return false;
+    const fulfillment = config.entities?.[entity.type]?.fulfillment;
+    return (fulfillment === "physical" ||
+        fulfillment === "internal-transfer" ||
+        fulfillment === undefined);
+}
+function resolveStrategy(config) {
+    const shipping = config.shipping;
+    if (!shipping) {
+        return {
+            type: "flat",
+            flatRate: 0,
+        };
+    }
+    if (shipping.type === "weight_based") {
+        return {
+            type: "weight_based",
+            brackets: [...shipping.brackets].sort((a, b) => a.upToGrams - b.upToGrams),
+            fallbackCost: shipping.fallbackCost,
+            ...(shipping.freeShippingThreshold !== undefined
+                ? { freeShippingThreshold: shipping.freeShippingThreshold }
+                : {}),
+        };
+    }
+    return {
+        type: "flat",
+        flatRate: shipping.flatRate,
+        ...(shipping.freeShippingThreshold !== undefined
+            ? { freeShippingThreshold: shipping.freeShippingThreshold }
+            : {}),
+    };
+}
+export async function calculateShippingCost(config, catalogRepo, input, ctx) {
+    if (input.isFreeShipping) {
+        return { amount: 0, strategy: "promotion:free_shipping", weightGrams: 0 };
+    }
+    const strategy = resolveStrategy(config);
+    if (strategy.freeShippingThreshold !== undefined &&
+        input.subtotalAfterDiscount >= strategy.freeShippingThreshold) {
+        return { amount: 0, strategy: "threshold:free_shipping", weightGrams: 0 };
+    }
+    // Filter to shippable items
+    const shippableFlags = await Promise.all(input.lineItems.map((lineItem) => isShippableEntity(config, catalogRepo, lineItem.entityId, ctx)));
+    const shippableItems = input.lineItems.filter((_, i) => shippableFlags[i]);
+    if (shippableItems.length === 0) {
+        return {
+            amount: 0,
+            strategy: `${strategy.type}:digital_only`,
+            weightGrams: 0,
+        };
+    }
+    // Calculate total weight
+    const weights = await Promise.all(shippableItems.map((lineItem) => resolveWeightGrams(catalogRepo, lineItem.entityId, lineItem.variantId, ctx)));
+    const weightGrams = shippableItems.reduce((sum, lineItem, i) => sum + (weights[i] ?? 0) * lineItem.quantity, 0);
+    if (strategy.type === "flat") {
+        return {
+            amount: Math.max(0, Math.round(strategy.flatRate)),
+            strategy: "flat",
+            weightGrams,
+        };
+    }
+    const matchedBracket = strategy.brackets.find((bracket) => weightGrams <= bracket.upToGrams);
+    return {
+        amount: matchedBracket
+            ? Math.max(0, Math.round(matchedBracket.cost))
+            : Math.max(0, Math.round(strategy.fallbackCost)),
+        strategy: "weight_based",
+        weightGrams,
+    };
+}

package/dist/modules/shipping/repository/index.d.ts

@@ -0,0 +1,5 @@
+import type { TxContext } from "../../../kernel/database/tx-context";
+export interface ShippingRepository {
+    ping(ctx: TxContext): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/shipping/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/shipping/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,MAAM,WAAW,kBAAkB;IAEjC,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}

package/dist/modules/shipping/repository/index.js

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

package/dist/modules/shipping/service.d.ts

@@ -0,0 +1,28 @@
+import type { CommerceConfig } from "../../config/types";
+import { type Result } from "../../kernel/result";
+import type { TxContext } from "../../kernel/database/tx-context";
+import type { CatalogRepository } from "../catalog/repository";
+import { type ShippingAddress, type ShippingLineItem } from "./calculator";
+interface ShippingServiceDeps {
+    config: CommerceConfig;
+    catalogRepository: CatalogRepository;
+}
+export interface CalculateShippingInput {
+    lineItems: ShippingLineItem[];
+    subtotalAfterDiscount: number;
+    currency: string;
+    address?: ShippingAddress;
+    isFreeShipping?: boolean;
+}
+export declare class ShippingService {
+    private deps;
+    private readonly catalogRepo;
+    constructor(deps: ShippingServiceDeps);
+    calculate(input: CalculateShippingInput, ctx?: TxContext): Promise<Result<{
+        amount: number;
+        strategy: string;
+        weightGrams: number;
+    }>>;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/shipping/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/shipping/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AAEtB,UAAU,mBAAmB;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,iBAAiB,EAAE,iBAAiB,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;gBAE5B,IAAI,EAAE,mBAAmB;IAIvC,SAAS,CACb,KAAK,EAAE,sBAAsB,EAC7B,GAAG,CAAC,EAAE,SAAS,GACd,OAAO,CACR,MAAM,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAClE;CAeF"}

package/dist/modules/shipping/service.js

@@ -0,0 +1,20 @@
+import { Ok } from "../../kernel/result";
+import { calculateShippingCost, } from "./calculator";
+export class ShippingService {
+    deps;
+    catalogRepo;
+    constructor(deps) {
+        this.deps = deps;
+        this.catalogRepo = deps.catalogRepository;
+    }
+    async calculate(input, ctx) {
+        const result = await calculateShippingCost(this.deps.config, this.catalogRepo, {
+            lineItems: input.lineItems,
+            subtotalAfterDiscount: input.subtotalAfterDiscount,
+            currency: input.currency,
+            isFreeShipping: input.isFreeShipping ?? false,
+            ...(input.address !== undefined ? { address: input.address } : {}),
+        }, ctx);
+        return Ok(result);
+    }
+}

package/dist/modules/tax/adapter.d.ts

@@ -0,0 +1,58 @@
+import type { Result } from "../../kernel/result";
+export interface TaxAddress {
+    country: string;
+    postalCode: string;
+    state?: string;
+    city?: string;
+    line1?: string;
+}
+export interface TaxLineItem {
+    id: string;
+    entityId: string;
+    description: string;
+    quantity: number;
+    unitPrice: number;
+    discount?: number;
+    productTaxCode?: string;
+}
+export interface TaxCalculationParams {
+    currency: string;
+    customerId?: string;
+    orderId?: string;
+    fromAddress?: TaxAddress;
+    toAddress?: TaxAddress;
+    shippingAmount: number;
+    lineItems: TaxLineItem[];
+}
+export interface TaxCalculationResult {
+    amountToCollect: number;
+    taxableAmount: number;
+    rate: number;
+    breakdown?: Record<string, unknown>;
+}
+export interface TaxReportParams {
+    transactionId: string;
+    transactionDate: Date;
+    currency: string;
+    customerId?: string;
+    fromAddress?: TaxAddress;
+    toAddress?: TaxAddress;
+    amount: number;
+    shipping: number;
+    salesTax: number;
+    lineItems: TaxLineItem[];
+}
+export interface TaxVoidParams {
+    transactionId: string;
+}
+export interface TaxAdapter {
+    readonly providerId: string;
+    calculateTax(params: TaxCalculationParams): Promise<Result<TaxCalculationResult>>;
+    reportTransaction(params: TaxReportParams): Promise<Result<{
+        transactionId: string;
+    }>>;
+    voidTransaction(params: TaxVoidParams): Promise<Result<{
+        transactionId: string;
+    }>>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/modules/tax/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/modules/tax/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAClF,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACvF,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACpF"}

package/dist/modules/tax/adapter.js

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

package/dist/modules/tax/repository/index.d.ts

@@ -0,0 +1,5 @@
+import type { TxContext } from "../../../kernel/database/tx-context";
+export interface TaxRepository {
+    ping(ctx: TxContext): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/tax/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/tax/repository/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAErE,MAAM,WAAW,aAAa;IAE5B,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}

package/dist/modules/tax/repository/index.js

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

package/dist/modules/tax/service.d.ts

@@ -0,0 +1,19 @@
+import { type Result } from "../../kernel/result";
+import type { TaxAdapter, TaxCalculationParams, TaxCalculationResult, TaxReportParams, TaxVoidParams } from "./adapter";
+interface TaxServiceDeps {
+    adapter: TaxAdapter | undefined;
+}
+export declare class TaxService {
+    private adapter;
+    constructor(deps: TaxServiceDeps);
+    calculate(params: TaxCalculationParams): Promise<Result<TaxCalculationResult>>;
+    reportTransaction(params: TaxReportParams): Promise<Result<{
+        transactionId: string;
+    }>>;
+    voidTransaction(params: TaxVoidParams): Promise<Result<{
+        transactionId: string;
+    }>>;
+    requireConfigured(): Result<TaxAdapter>;
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/dist/modules/tax/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/modules/tax/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACd,MAAM,WAAW,CAAC;AAEnB,UAAU,cAAc;IACtB,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;CACjC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAyB;gBAE5B,IAAI,EAAE,cAAc;IAI1B,SAAS,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAe9E,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAKtF,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAKxF,iBAAiB,IAAI,MAAM,CAAC,UAAU,CAAC;CAMxC"}

package/dist/modules/tax/service.js

@@ -0,0 +1,34 @@
+import { CommerceValidationError } from "../../kernel/errors";
+import { Err, Ok } from "../../kernel/result";
+export class TaxService {
+    adapter;
+    constructor(deps) {
+        this.adapter = deps.adapter;
+    }
+    async calculate(params) {
+        if (!this.adapter) {
+            return Ok({
+                amountToCollect: 0,
+                taxableAmount: params.lineItems.reduce((sum, lineItem) => sum + lineItem.unitPrice * lineItem.quantity - (lineItem.discount ?? 0), 0) + params.shippingAmount,
+                rate: 0,
+            });
+        }
+        return this.adapter.calculateTax(params);
+    }
+    async reportTransaction(params) {
+        if (!this.adapter)
+            return Ok({ transactionId: params.transactionId });
+        return this.adapter.reportTransaction(params);
+    }
+    async voidTransaction(params) {
+        if (!this.adapter)
+            return Ok({ transactionId: params.transactionId });
+        return this.adapter.voidTransaction(params);
+    }
+    requireConfigured() {
+        if (!this.adapter) {
+            return Err(new CommerceValidationError("Tax adapter is not configured."));
+        }
+        return Ok(this.adapter);
+    }
+}

package/dist/modules/webhooks/hook.d.ts

@@ -0,0 +1,13 @@
+import type { AfterHook } from "../../kernel/hooks/types";
+/**
+ * Webhook delivery hook — enqueues delivery jobs instead of blocking.
+ *
+ * Previously, this hook made synchronous HTTP calls to each webhook endpoint
+ * inside the request handler, blocking the response for seconds if endpoints
+ * were slow or down.
+ *
+ * Now it enqueues a background job per endpoint. The job runner delivers
+ * asynchronously with retries. The HTTP response returns immediately.
+ */
+export declare const deliverWebhooks: AfterHook<unknown>;
+//# sourceMappingURL=hook.d.ts.map

package/dist/modules/webhooks/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../src/modules/webhooks/hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,CAAC,OAAO,CAqB9C,CAAC"}

package/dist/modules/webhooks/hook.js

@@ -0,0 +1,29 @@
+/**
+ * Webhook delivery hook — enqueues delivery jobs instead of blocking.
+ *
+ * Previously, this hook made synchronous HTTP calls to each webhook endpoint
+ * inside the request handler, blocking the response for seconds if endpoints
+ * were slow or down.
+ *
+ * Now it enqueues a background job per endpoint. The job runner delivers
+ * asynchronously with retries. The HTTP response returns immediately.
+ */
+export const deliverWebhooks = async ({ result, operation, context }) => {
+    const eventName = `${String(context.context.moduleName ?? "unknown")}.${operation}`;
+    const webhooksService = context.services.webhooks;
+    const endpoints = await webhooksService.getEndpointsForEvent(eventName);
+    if (!endpoints.ok)
+        return;
+    for (const endpoint of endpoints.value) {
+        await context.jobs.enqueue("webhooks/deliver", {
+            endpointId: endpoint.id,
+            endpointUrl: endpoint.url,
+            endpointSecret: endpoint.secret,
+            eventName,
+            payload: result,
+        }, {
+            maxAttempts: 5,
+            queue: "webhooks",
+        });
+    }
+};