@porulle/import-flat 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @porulle/import-flat
+
+Import catalog entities from a flat JSON file. The lowest-friction format — define an array of products, run `porulle import`, done.
+
+## Usage
+
+```bash
+porulle import ./catalog.json
+```
+
+Format:
+
+```json
+[
+  {
+    "type": "product",
+    "slug": "ceylon-black-tea-50g",
+    "attributes": {
+      "locale": "en",
+      "title": "Ceylon Black Tea (50g)",
+      "description": "Single-estate, hand-picked.",
+      "subtitle": "Uva region"
+    },
+    "metadata": { "weight": 50, "material": "tea leaves" },
+    "variants": [
+      { "sku": "CBT-50G", "options": { "size": "50g" }, "price": 1200 }
+    ]
+  }
+]
+```
+
+## When to use
+
+- Seeding a new store with a small fixed catalog
+- Internal inventory dumps converted from a spreadsheet (export CSV → flatten to JSON)
+- Test fixtures
+- Anything that doesn't have a Shopify or WooCommerce origin
+
+For Shopify migrations: `@porulle/import-shopify`. For WooCommerce: `@porulle/import-woocommerce`.
+
+## See also
+
+- `@porulle/cli` — `porulle import` command
+- `apps/store-example/src/scripts/seed.ts` — programmatic seeding example

package/dist/src/index.d.ts

@@ -0,0 +1,49 @@
+import { type Result } from "@porulle/core";
+export interface FlatImportEntityInput {
+    type: string;
+    slug: string;
+    attributes: {
+        locale?: string;
+        title: string;
+        description?: string;
+        subtitle?: string;
+    };
+    metadata?: Record<string, unknown>;
+    customFields?: Record<string, unknown>;
+}
+export interface FlatImportTarget {
+    createEntity(input: FlatImportEntityInput): Promise<{
+        id: string;
+    }>;
+}
+export type FlatValueResolver = string | ((row: Record<string, string>) => unknown);
+export interface FlatImportMapping {
+    entityType: string;
+    slug: FlatValueResolver;
+    title: FlatValueResolver;
+    description?: FlatValueResolver;
+    subtitle?: FlatValueResolver;
+    locale?: string;
+    metadata?: Record<string, FlatValueResolver>;
+    customFields?: Record<string, FlatValueResolver>;
+}
+export interface ImportFlatOptions {
+    mapping: FlatImportMapping;
+    target: FlatImportTarget;
+    rows?: Array<Record<string, string>>;
+    csv?: string;
+    json?: string;
+    delimiter?: string;
+}
+export interface ImportFlatSummary {
+    imported: number;
+    failed: number;
+    errors: Array<{
+        row: number;
+        message: string;
+    }>;
+    entityIds: string[];
+}
+export declare function parseCsv(input: string, delimiter?: string): Array<Record<string, string>>;
+export declare function importFlat(options: ImportFlatOptions): Promise<Result<ImportFlatSummary>>;
+//# 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":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC;AAEpF,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,iBAAiB,CAAC;IACzB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAiCD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyBtF;AAqFD,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAoC/F"}

package/dist/src/index.js

@@ -0,0 +1,154 @@
+import { Err, Ok } from "@porulle/core";
+function parseCsvLine(line, delimiter) {
+    const output = [];
+    let current = "";
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i += 1) {
+        const char = line[i];
+        if (char === '"') {
+            const next = line[i + 1];
+            if (inQuotes && next === '"') {
+                current += '"';
+                i += 1;
+                continue;
+            }
+            inQuotes = !inQuotes;
+            continue;
+        }
+        if (char === delimiter && !inQuotes) {
+            output.push(current.trim());
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    output.push(current.trim());
+    return output;
+}
+export function parseCsv(input, delimiter = ",") {
+    const lines = input
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (lines.length === 0)
+        return [];
+    const headers = parseCsvLine(lines[0], delimiter);
+    const rows = [];
+    for (const line of lines.slice(1)) {
+        const values = parseCsvLine(line, delimiter);
+        const row = {};
+        for (let i = 0; i < headers.length; i += 1) {
+            const key = headers[i];
+            if (!key)
+                continue;
+            row[key] = values[i] ?? "";
+        }
+        rows.push(row);
+    }
+    return rows;
+}
+function resolveValue(row, resolver) {
+    if (!resolver)
+        return undefined;
+    if (typeof resolver === "function")
+        return resolver(row);
+    return row[resolver];
+}
+function mapRow(row, mapping) {
+    const slug = String(resolveValue(row, mapping.slug) ?? "").trim();
+    const title = String(resolveValue(row, mapping.title) ?? "").trim();
+    const metadata = mapping.metadata
+        ? Object.fromEntries(Object.entries(mapping.metadata)
+            .map(([key, resolver]) => [key, resolveValue(row, resolver)])
+            .filter(([, value]) => value !== undefined && value !== ""))
+        : undefined;
+    const customFields = mapping.customFields
+        ? Object.fromEntries(Object.entries(mapping.customFields)
+            .map(([key, resolver]) => [key, resolveValue(row, resolver)])
+            .filter(([, value]) => value !== undefined && value !== ""))
+        : undefined;
+    return {
+        type: mapping.entityType,
+        slug,
+        attributes: {
+            title,
+            ...(mapping.locale ? { locale: mapping.locale } : {}),
+            ...(resolveValue(row, mapping.description)
+                ? { description: String(resolveValue(row, mapping.description)) }
+                : {}),
+            ...(resolveValue(row, mapping.subtitle)
+                ? { subtitle: String(resolveValue(row, mapping.subtitle)) }
+                : {}),
+        },
+        ...(metadata && Object.keys(metadata).length > 0 ? { metadata } : {}),
+        ...(customFields && Object.keys(customFields).length > 0 ? { customFields } : {}),
+    };
+}
+function normalizeRows(options) {
+    if (options.rows && options.rows.length > 0)
+        return Ok(options.rows);
+    if (options.csv) {
+        return Ok(parseCsv(options.csv, options.delimiter ?? ","));
+    }
+    if (options.json) {
+        try {
+            const parsed = JSON.parse(options.json);
+            if (!Array.isArray(parsed)) {
+                return Err({
+                    code: "IMPORT_FLAT_INVALID_JSON",
+                    message: "JSON payload must be an array of records.",
+                });
+            }
+            const rows = parsed.map((value) => {
+                if (!value || typeof value !== "object")
+                    return {};
+                return Object.fromEntries(Object.entries(value).map(([key, current]) => [key, String(current ?? "")]));
+            });
+            return Ok(rows);
+        }
+        catch (error) {
+            return Err({
+                code: "IMPORT_FLAT_INVALID_JSON",
+                message: error instanceof Error ? error.message : "Invalid JSON payload.",
+            });
+        }
+    }
+    return Err({
+        code: "IMPORT_FLAT_NO_INPUT",
+        message: "Provide rows, csv, or json input for flat import.",
+    });
+}
+export async function importFlat(options) {
+    const normalized = normalizeRows(options);
+    if (!normalized.ok)
+        return normalized;
+    const summary = {
+        imported: 0,
+        failed: 0,
+        errors: [],
+        entityIds: [],
+    };
+    for (let index = 0; index < normalized.value.length; index += 1) {
+        try {
+            const row = normalized.value[index];
+            const mapped = mapRow(row, options.mapping);
+            if (!mapped.slug) {
+                throw new Error("Missing slug after mapping.");
+            }
+            if (!mapped.attributes.title) {
+                throw new Error("Missing title after mapping.");
+            }
+            const created = await options.target.createEntity(mapped);
+            summary.imported += 1;
+            summary.entityIds.push(created.id);
+        }
+        catch (error) {
+            summary.failed += 1;
+            summary.errors.push({
+                row: index + 1,
+                message: error instanceof Error ? error.message : "Unknown import error.",
+            });
+        }
+    }
+    return Ok(summary);
+}