@porulle/import-woocommerce 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# @porulle/import-woocommerce
+
+Import a WooCommerce store's catalog into Porulle. Maps WooCommerce's product / variation / attribute / image model onto Porulle's catalog.
+
+## Usage
+
+Export your WooCommerce catalog as JSON (via the WooCommerce REST API or the WP-CLI):
+
+```bash
+wp wc product list --user=admin --format=json > woo-catalog.json
+porulle import ./woo-catalog.json --format woocommerce
+```
+
+Or programmatically:
+
+```ts
+import { importWooProducts } from "@porulle/import-woocommerce";
+import { commerce } from "./server";
+
+const products = JSON.parse(await fs.readFile("./woo-catalog.json", "utf-8"));
+const result = await importWooProducts(commerce.api, products);
+if (!result.ok) {
+  console.error("import failed:", result.error);
+  process.exit(1);
+}
+```
+
+## What it maps
+
+| WooCommerce | Porulle |
+|---|---|
+| `product` (simple, variable) | `sellable_entities` (type: `product`) |
+| `variation` | `variants` |
+| `attribute` (pa_size, pa_color, …) | `option_types` + `option_values` |
+| `images[]` | `media_assets` + `entity_media` |
+| `categories[]` | `entity_categories` (creates `categories` rows on first sight) |
+| `tags[]` | `metadata.tags` |
+| `meta_data[]` | `metadata.<key>` |
+
+## What it doesn't map
+
+- Customers, orders, coupons — same reasoning as the Shopify importer
+- Tax rates — Porulle's tax adapter handles this; configure separately
+- Shipping zones — set up via `config.shipping`
+- WP users / themes / plugins — out of scope
+
+## See also
+
+- `@porulle/import-flat` — neutral JSON format
+- `@porulle/import-shopify` — for Shopify origins
+- [WooCommerce REST API — Products](https://woocommerce.github.io/woocommerce-rest-api-docs/#products)

package/dist/src/index.d.ts

@@ -0,0 +1,160 @@
+import { type Result } from "@porulle/core";
+export interface WooImage {
+    id: number;
+    src: string;
+    alt?: string;
+}
+export interface WooAttribute {
+    id?: number;
+    name: string;
+    variation?: boolean;
+    options?: string[];
+    option?: string;
+}
+export interface WooProductVariation {
+    id: number;
+    sku?: string;
+    price?: string;
+    attributes?: WooAttribute[];
+}
+export interface WooProduct {
+    id: number;
+    name: string;
+    slug?: string;
+    description?: string;
+    short_description?: string;
+    type?: string;
+    sku?: string;
+    categories?: Array<{
+        id: number;
+        name: string;
+        slug?: string;
+    }>;
+    attributes?: WooAttribute[];
+    images?: WooImage[];
+    variationsData?: WooProductVariation[];
+}
+export interface WooCustomer {
+    id: number;
+    email?: string;
+    first_name?: string;
+    last_name?: string;
+    billing?: {
+        phone?: string;
+        address_1?: string;
+        address_2?: string;
+        city?: string;
+        state?: string;
+        postcode?: string;
+        country?: string;
+    };
+    shipping?: {
+        address_1?: string;
+        address_2?: string;
+        city?: string;
+        state?: string;
+        postcode?: string;
+        country?: string;
+    };
+}
+export interface WooImportTarget {
+    createEntity(input: {
+        type: string;
+        slug: string;
+        attributes: {
+            title: string;
+            description?: string;
+            subtitle?: string;
+        };
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+    }>;
+    createOptionType?(input: {
+        entityId: string;
+        name: string;
+        displayName: string;
+        sortOrder?: number;
+    }): Promise<{
+        id: string;
+    }>;
+    createOptionValue?(input: {
+        optionTypeId: string;
+        value: string;
+        displayValue: string;
+        sortOrder?: number;
+    }): Promise<{
+        id: string;
+    }>;
+    createVariant?(input: {
+        entityId: string;
+        optionValueIds: string[];
+        sku?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+    }>;
+    uploadMedia?(input: {
+        filename: string;
+        contentType: string;
+        data: ArrayBuffer;
+        alt?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+        url: string;
+    }>;
+    attachMedia?(input: {
+        entityId: string;
+        mediaAssetId: string;
+        role: "primary" | "gallery";
+    }): Promise<void>;
+    upsertCustomer?(input: {
+        userId: string;
+        email?: string;
+        phone?: string;
+        firstName?: string;
+        lastName?: string;
+        addresses?: Array<{
+            type: "shipping" | "billing";
+            isDefault: boolean;
+            firstName: string;
+            lastName: string;
+            line1: string;
+            line2?: string;
+            city: string;
+            state?: string;
+            postalCode?: string;
+            country: string;
+            phone?: string;
+        }>;
+        metadata?: Record<string, unknown>;
+    }): Promise<void>;
+}
+export interface WooImportOptions {
+    target: WooImportTarget;
+    storeUrl?: string;
+    consumerKey?: string;
+    consumerSecret?: string;
+    products?: WooProduct[];
+    customers?: WooCustomer[];
+    fetchImpl?: typeof fetch;
+    mediaFetcher?: (url: string) => Promise<{
+        data: ArrayBuffer;
+        contentType: string;
+        filename?: string;
+    }>;
+    entityType?: string;
+}
+export interface WooImportSummary {
+    entitiesImported: number;
+    variantsImported: number;
+    mediaImported: number;
+    customersImported: number;
+    errors: Array<{
+        scope: "entity" | "variant" | "media" | "customer";
+        message: string;
+    }>;
+}
+export declare function importWooCommerceCatalog(options: WooImportOptions): Promise<Result<WooImportSummary>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -0,0 +1,258 @@
+import { Err, Ok } from "@porulle/core";
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .trim()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "") || `product-${crypto.randomUUID().slice(0, 8)}`;
+}
+function buildWooUrl(base, path, key, secret) {
+    const url = new URL(path, base.replace(/\/$/, "/"));
+    url.searchParams.set("consumer_key", key);
+    url.searchParams.set("consumer_secret", secret);
+    url.searchParams.set("per_page", "100");
+    return url.toString();
+}
+async function fetchJson(fetchImpl, url) {
+    try {
+        const response = await fetchImpl(url, { headers: { accept: "application/json" } });
+        if (!response.ok) {
+            return Err({
+                code: "WOO_API_FAILED",
+                message: `WooCommerce request failed (${response.status}) for ${url}.`,
+            });
+        }
+        return Ok((await response.json()));
+    }
+    catch (error) {
+        return Err({
+            code: "WOO_API_FAILED",
+            message: error instanceof Error ? error.message : "WooCommerce request failed.",
+        });
+    }
+}
+async function loadProducts(options) {
+    if (options.products)
+        return Ok(options.products);
+    if (!options.storeUrl || !options.consumerKey || !options.consumerSecret) {
+        return Err({
+            code: "WOO_INPUT_REQUIRED",
+            message: "Provide products or storeUrl + consumerKey + consumerSecret.",
+        });
+    }
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return fetchJson(fetchImpl, buildWooUrl(options.storeUrl, "/wp-json/wc/v3/products", options.consumerKey, options.consumerSecret));
+}
+async function loadCustomers(options) {
+    if (options.customers)
+        return Ok(options.customers);
+    if (!options.storeUrl || !options.consumerKey || !options.consumerSecret) {
+        return Ok([]);
+    }
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return fetchJson(fetchImpl, buildWooUrl(options.storeUrl, "/wp-json/wc/v3/customers", options.consumerKey, options.consumerSecret));
+}
+function filenameFromUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.pathname.split("/").filter(Boolean).pop() ?? `media-${crypto.randomUUID().slice(0, 8)}.bin`;
+    }
+    catch {
+        return `media-${crypto.randomUUID().slice(0, 8)}.bin`;
+    }
+}
+async function defaultMediaFetcher(fetchImpl, url) {
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch media (${response.status}) from ${url}`);
+    }
+    return {
+        data: await response.arrayBuffer(),
+        contentType: response.headers.get("content-type") ?? "application/octet-stream",
+        filename: filenameFromUrl(url),
+    };
+}
+export async function importWooCommerceCatalog(options) {
+    const products = await loadProducts(options);
+    if (!products.ok)
+        return products;
+    const customers = await loadCustomers(options);
+    if (!customers.ok)
+        return customers;
+    const summary = {
+        entitiesImported: 0,
+        variantsImported: 0,
+        mediaImported: 0,
+        customersImported: 0,
+        errors: [],
+    };
+    const mediaFetcher = options.mediaFetcher
+        ? options.mediaFetcher
+        : async (url) => defaultMediaFetcher(options.fetchImpl ?? fetch, url);
+    for (const product of products.value) {
+        try {
+            const createdEntity = await options.target.createEntity({
+                type: options.entityType ?? "product",
+                slug: product.slug ? slugify(product.slug) : slugify(product.name),
+                attributes: {
+                    title: product.name,
+                    ...(product.description ? { description: product.description } : {}),
+                    ...(product.short_description ? { subtitle: product.short_description } : {}),
+                },
+                metadata: {
+                    source: "woocommerce",
+                    wooProductId: product.id,
+                    productType: product.type,
+                    categories: (product.categories ?? []).map((category) => category.slug ?? category.name),
+                },
+            });
+            summary.entitiesImported += 1;
+            const optionTypeIdByName = new Map();
+            const optionValueIdByKey = new Map();
+            if (options.target.createOptionType && options.target.createOptionValue) {
+                const attributes = (product.attributes ?? []).filter((attribute) => attribute.variation);
+                for (let attrIndex = 0; attrIndex < attributes.length; attrIndex += 1) {
+                    const attribute = attributes[attrIndex];
+                    const createdType = await options.target.createOptionType({
+                        entityId: createdEntity.id,
+                        name: attribute.name,
+                        displayName: attribute.name,
+                        sortOrder: attrIndex,
+                    });
+                    optionTypeIdByName.set(attribute.name, createdType.id);
+                    for (let valueIndex = 0; valueIndex < (attribute.options ?? []).length; valueIndex += 1) {
+                        const value = attribute.options[valueIndex];
+                        const createdValue = await options.target.createOptionValue({
+                            optionTypeId: createdType.id,
+                            value,
+                            displayValue: value,
+                            sortOrder: valueIndex,
+                        });
+                        optionValueIdByKey.set(`${attribute.name}::${value}`, createdValue.id);
+                    }
+                }
+            }
+            if (options.target.createVariant) {
+                const variationData = product.variationsData ?? [];
+                for (const variant of variationData) {
+                    try {
+                        const optionValueIds = (variant.attributes ?? [])
+                            .map((attribute) => optionValueIdByKey.get(`${attribute.name}::${attribute.option ?? ""}`))
+                            .filter((value) => typeof value === "string");
+                        await options.target.createVariant({
+                            entityId: createdEntity.id,
+                            optionValueIds,
+                            ...(variant.sku ? { sku: variant.sku } : {}),
+                            metadata: {
+                                source: "woocommerce",
+                                wooVariationId: variant.id,
+                                price: variant.price,
+                            },
+                        });
+                        summary.variantsImported += 1;
+                    }
+                    catch (error) {
+                        summary.errors.push({
+                            scope: "variant",
+                            message: error instanceof Error ? error.message : "Variation import failed.",
+                        });
+                    }
+                }
+            }
+            if (options.target.uploadMedia && options.target.attachMedia) {
+                for (let imageIndex = 0; imageIndex < (product.images ?? []).length; imageIndex += 1) {
+                    const image = product.images[imageIndex];
+                    try {
+                        const downloaded = await mediaFetcher(image.src);
+                        const uploaded = await options.target.uploadMedia({
+                            filename: downloaded.filename ?? filenameFromUrl(image.src),
+                            contentType: downloaded.contentType,
+                            data: downloaded.data,
+                            ...(image.alt ? { alt: image.alt } : {}),
+                            metadata: {
+                                source: "woocommerce",
+                                wooImageId: image.id,
+                            },
+                        });
+                        await options.target.attachMedia({
+                            entityId: createdEntity.id,
+                            mediaAssetId: uploaded.id,
+                            role: imageIndex === 0 ? "primary" : "gallery",
+                        });
+                        summary.mediaImported += 1;
+                    }
+                    catch (error) {
+                        summary.errors.push({
+                            scope: "media",
+                            message: error instanceof Error ? error.message : "Media import failed.",
+                        });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            summary.errors.push({
+                scope: "entity",
+                message: error instanceof Error ? error.message : "Entity import failed.",
+            });
+        }
+    }
+    if (options.target.upsertCustomer) {
+        for (const customer of customers.value) {
+            try {
+                const billing = customer.billing;
+                const shipping = customer.shipping;
+                const addresses = [];
+                if (billing?.address_1) {
+                    addresses.push({
+                        type: "billing",
+                        isDefault: true,
+                        firstName: customer.first_name ?? "",
+                        lastName: customer.last_name ?? "",
+                        line1: billing.address_1,
+                        ...(billing.address_2 ? { line2: billing.address_2 } : {}),
+                        city: billing.city ?? "",
+                        ...(billing.state ? { state: billing.state } : {}),
+                        ...(billing.postcode ? { postalCode: billing.postcode } : {}),
+                        country: billing.country ?? "US",
+                        ...(billing.phone ? { phone: billing.phone } : {}),
+                    });
+                }
+                if (shipping?.address_1) {
+                    addresses.push({
+                        type: "shipping",
+                        isDefault: addresses.length === 0,
+                        firstName: customer.first_name ?? "",
+                        lastName: customer.last_name ?? "",
+                        line1: shipping.address_1,
+                        ...(shipping.address_2 ? { line2: shipping.address_2 } : {}),
+                        city: shipping.city ?? "",
+                        ...(shipping.state ? { state: shipping.state } : {}),
+                        ...(shipping.postcode ? { postalCode: shipping.postcode } : {}),
+                        country: shipping.country ?? "US",
+                    });
+                }
+                await options.target.upsertCustomer({
+                    userId: `woocommerce:${customer.id}`,
+                    ...(customer.email ? { email: customer.email } : {}),
+                    ...(billing?.phone ? { phone: billing.phone } : {}),
+                    ...(customer.first_name ? { firstName: customer.first_name } : {}),
+                    ...(customer.last_name ? { lastName: customer.last_name } : {}),
+                    addresses,
+                    metadata: {
+                        source: "woocommerce",
+                        wooCustomerId: customer.id,
+                    },
+                });
+                summary.customersImported += 1;
+            }
+            catch (error) {
+                summary.errors.push({
+                    scope: "customer",
+                    message: error instanceof Error ? error.message : "Customer import failed.",
+                });
+            }
+        }
+    }
+    return Ok(summary);
+}