@jytextiles/medusa-plugin-faire-store-sync 0.1.0

package/scripts/postbuild.js

@@ -0,0 +1,36 @@
+const fs = require("fs")
+const path = require("path")
+
+const serverDir = path.join(__dirname, "..", ".medusa", "server")
+const srcDir = path.join(serverDir, "src")
+
+if (!fs.existsSync(serverDir)) {
+  process.exit(0)
+}
+
+if (!fs.existsSync(srcDir)) {
+  fs.mkdirSync(srcDir, { recursive: true })
+}
+
+const dirsToMove = [
+  "api",
+  "jobs",
+  "lib",
+  "links",
+  "modules",
+  "workflows",
+  "__tests__",
+]
+
+for (const dir of dirsToMove) {
+  const from = path.join(serverDir, dir)
+  const to = path.join(srcDir, dir)
+  if (fs.existsSync(from)) {
+    if (fs.existsSync(to)) {
+      fs.rmSync(to, { recursive: true, force: true })
+    }
+    fs.renameSync(from, to)
+  }
+}
+
+console.log("postbuild: restructured server output into src/")

package/src/__tests__/ingest-faire-order-support.spec.ts

@@ -0,0 +1,77 @@
+import { mapFaireOrderToOrder, faireMoney } from "../workflows/ingest-faire-order-support"
+
+describe("faireMoney", () => {
+  it("converts integer cents to decimal major units", () => {
+    expect(faireMoney(2500)).toBe(25)
+    expect(faireMoney(4999)).toBe(49.99)
+  })
+  it("coerces undefined/NaN to 0", () => {
+    expect(faireMoney(undefined)).toBe(0)
+    expect(faireMoney(NaN)).toBe(0)
+  })
+})
+
+describe("mapFaireOrderToOrder", () => {
+  it("maps items, address and idempotency token", () => {
+    const order = {
+      order_token: "o_123",
+      currency: "USD",
+      total_cents: 4999,
+      buyer_name: "Ada Lovelace",
+      address: {
+        first_name: "Ada",
+        last_name: "Lovelace",
+        street1: "1 Main St",
+        city: "London",
+        state: "ENG",
+        zip: "EC1",
+        country: "GB",
+      },
+      items: [
+        {
+          id: "i_1",
+          product_token: "p_1",
+          sku: "SKU-1",
+          quantity: 2,
+          wholesale_price_cents: 1250,
+          name: "Cushion",
+        },
+      ],
+    }
+
+    const mapped = mapFaireOrderToOrder(order)
+
+    expect(mapped.order_token).toBe("o_123")
+    expect(mapped.currency_code).toBe("usd")
+    expect(mapped.total).toBe(49.99)
+    expect(mapped.buyer_name).toBe("Ada Lovelace")
+    expect(mapped.email).toBe("faire+o_123@marketplace.invalid")
+    expect(mapped.shipping_address.country_code).toBe("gb")
+    expect(mapped.items).toHaveLength(1)
+    expect(mapped.items[0]).toMatchObject({
+      title: "Cushion",
+      quantity: 2,
+      unit_price: 12.5,
+    })
+    expect(mapped.items[0].metadata).toMatchObject({
+      faire_order_token: "o_123",
+      faire_product_token: "p_1",
+      faire_sku: "SKU-1",
+    })
+  })
+
+  it("falls back when address fields are missing", () => {
+    const mapped = mapFaireOrderToOrder({ order_token: "o_1", items: [] })
+    expect(mapped.shipping_address.first_name).toBe("Faire")
+    expect(mapped.items).toEqual([])
+  })
+
+  it("uses buyer email when provided", () => {
+    const mapped = mapFaireOrderToOrder({
+      order_token: "o_2",
+      buyer_email: "retailer@example.com",
+      items: [{ quantity: 1, name: "x" }],
+    })
+    expect(mapped.email).toBe("retailer@example.com")
+  })
+})

package/src/__tests__/webhook.spec.ts

@@ -0,0 +1,81 @@
+import { verifyFaireWebhook } from "../lib/webhook"
+import crypto from "crypto"
+
+const secret = "faire-webhook-secret"
+
+const sign = (body: string, enc: "hex" | "base64" = "hex") =>
+  crypto.createHmac("sha256", Buffer.from(secret, "utf8")).update(body, "utf8").digest(enc)
+
+describe("verifyFaireWebhook", () => {
+  it("accepts a valid hex signature", () => {
+    const body = '{"event_type":"ORDER_PLACED"}'
+    const res = verifyFaireWebhook({
+      secret,
+      headers: { signature: sign(body, "hex") },
+      rawBody: body,
+    })
+    expect(res.valid).toBe(true)
+  })
+
+  it("accepts a valid base64 signature", () => {
+    const body = '{"event_type":"ORDER_PLACED"}'
+    const res = verifyFaireWebhook({
+      secret,
+      headers: { signature: sign(body, "base64") },
+      rawBody: body,
+    })
+    expect(res.valid).toBe(true)
+  })
+
+  it("accepts svix-style v1,<sig> entries", () => {
+    const body = '{"event_type":"ORDER_PLACED"}'
+    const res = verifyFaireWebhook({
+      secret,
+      headers: { signature: `v1,${sign(body, "hex")}` },
+      rawBody: body,
+    })
+    expect(res.valid).toBe(true)
+  })
+
+  it("rejects a tampered body", () => {
+    const body = '{"event_type":"ORDER_PLACED"}'
+    const res = verifyFaireWebhook({
+      secret,
+      headers: { signature: sign(body, "hex") },
+      rawBody: body + "tampered",
+    })
+    expect(res.valid).toBe(false)
+    expect(res.reason).toBe("signature mismatch")
+  })
+
+  it("rejects when signature header is missing", () => {
+    const res = verifyFaireWebhook({
+      secret,
+      headers: {},
+      rawBody: "{}",
+    })
+    expect(res.valid).toBe(false)
+    expect(res.reason).toMatch(/missing/)
+  })
+
+  it("rejects when secret is empty", () => {
+    const res = verifyFaireWebhook({
+      secret: "",
+      headers: { signature: "abc" },
+      rawBody: "{}",
+    })
+    expect(res.valid).toBe(false)
+    expect(res.reason).toMatch(/secret/)
+  })
+
+  it("enforces timestamp tolerance when a timestamp is present", () => {
+    const body = "{}"
+    const res = verifyFaireWebhook({
+      secret,
+      headers: { signature: sign(body, "hex"), timestamp: String(Math.floor(Date.now() / 1000) - 600) },
+      rawBody: body,
+    })
+    expect(res.valid).toBe(false)
+    expect(res.reason).toMatch(/timestamp/)
+  })
+})

package/src/admin/lib/api.ts

@@ -0,0 +1,88 @@
+import Medusa from "@medusajs/js-sdk"
+
+export const sdk = new Medusa({
+  baseUrl: "/",
+  auth: {
+    type: "session",
+  },
+})
+
+export const faireApi = {
+  status: () =>
+    sdk.client.fetch<{
+      connected: boolean
+      account: any | null
+      settings: any
+      readiness: {
+        connected: boolean
+        brand: boolean
+        wholesale_pricing: boolean
+        shipping_policy: boolean
+        ready_to_publish: boolean
+      }
+    }>("/admin/faire/status"),
+  getSettings: () =>
+    sdk.client.fetch<Record<string, any>>("/admin/faire/settings"),
+  saveSettings: (settings: Record<string, any>) =>
+    sdk.client.fetch("/admin/faire/settings", {
+      method: "POST",
+      body: settings,
+    }),
+  authorize: () =>
+    sdk.client.fetch<{ authorization_url: string; state: string }>(
+      "/admin/faire/auth/authorize"
+    ),
+  callback: (code: string, state: string) =>
+    sdk.client.fetch("/admin/faire/auth/callback", {
+      method: "POST",
+      body: { code, state },
+    }),
+  disconnect: () =>
+    sdk.client.fetch("/admin/faire/auth/disconnect", { method: "POST" }),
+  syncProduct: (id: string) =>
+    sdk.client.fetch(`/admin/faire/sync/product/${id}`, { method: "POST" }),
+  productStatus: (id: string) =>
+    sdk.client.fetch<{
+      connected: boolean
+      synced: boolean
+      latest: any | null
+    }>(`/admin/faire/status/product/${id}`),
+  syncBulk: (product_ids: string[]) =>
+    sdk.client.fetch<{ batch_id: string; status: string }>(
+      "/admin/faire/sync/bulk",
+      {
+        method: "POST",
+        body: { product_ids },
+      }
+    ),
+  bulkStatus: (batchId: string) =>
+    sdk.client.fetch<{ batch: any; progress: any }>(
+      `/admin/faire/sync/bulk/${batchId}`
+    ),
+  ingestOrders: (limit?: number) =>
+    sdk.client.fetch<{ batch_id: string; status: string }>(
+      "/admin/faire/ingest/orders",
+      { method: "POST", body: limit != null ? { limit } : {} }
+    ),
+  ingestStatus: (batchId: string) =>
+    sdk.client.fetch<{ batch: any; progress: any }>(
+      `/admin/faire/ingest/orders/${batchId}`
+    ),
+  listSyncs: (opts: { take?: number; skip?: number; status?: string } = {}) => {
+    const query: Record<string, string> = {}
+    if (opts.take !== undefined) query.take = String(opts.take)
+    if (opts.skip !== undefined) query.skip = String(opts.skip)
+    if (opts.status) query.status = opts.status
+    return sdk.client.fetch("/admin/faire/syncs", { query })
+  },
+  getSync: (id: string) => sdk.client.fetch(`/admin/faire/syncs/${id}`),
+  retrySync: (id: string) =>
+    sdk.client.fetch(`/admin/faire/syncs/${id}`, { method: "POST" }),
+  brand: () => sdk.client.fetch("/admin/faire/brand"),
+  products: (opts: { limit?: number; page?: number } = {}) => {
+    const query: Record<string, string> = {}
+    if (opts.limit !== undefined) query.limit = String(opts.limit)
+    if (opts.page !== undefined) query.page = String(opts.page)
+    return sdk.client.fetch("/admin/faire/products", { query })
+  },
+}

package/src/admin/routes/settings/faire/[id]/page.tsx

@@ -0,0 +1,184 @@
+import {
+  Button,
+  Container,
+  DropdownMenu,
+  Heading,
+  IconButton,
+  Label,
+  Skeleton,
+  StatusBadge,
+  Text,
+  Toaster,
+} from "@medusajs/ui"
+import { EllipsisHorizontal, ArrowPath, ArrowUpRightOnBox } from "@medusajs/icons"
+import { useEffect, useState } from "react"
+import { useNavigate, useParams } from "react-router-dom"
+import { faireApi } from "../../../../lib/api"
+import type { FaireSyncRecord } from "../hooks/use-faire-sync-columns"
+
+const STATUS_COLORS: Record<string, "green" | "red" | "orange" | "grey"> = {
+  success: "green",
+  failed: "red",
+  draft: "orange",
+  pending: "grey",
+  syncing: "grey",
+}
+
+const FaireSyncDetailPage = () => {
+  const { id } = useParams<{ id: string }>()
+  const navigate = useNavigate()
+  const [record, setRecord] = useState<FaireSyncRecord | null>(null)
+  const [loading, setLoading] = useState(true)
+  const [retrying, setRetrying] = useState(false)
+  const [error, setError] = useState<string | null>(null)
+
+  useEffect(() => {
+    if (!id) return
+    setLoading(true)
+    faireApi
+      .getSync(id)
+      .then((res: any) => {
+        setRecord(res.sync || res)
+      })
+      .catch((err: any) => setError(err.message || "Failed to load sync record"))
+      .finally(() => setLoading(false))
+  }, [id])
+
+  const handleRetry = async () => {
+    if (!record) return
+    setRetrying(true)
+    setError(null)
+    try {
+      await faireApi.retrySync(record.id)
+      const updated = await faireApi.getSync(record.id).catch(() => null)
+      if (updated) setRecord((updated as any).sync || updated)
+    } catch (err: any) {
+      setError(err.message || "Retry failed")
+    } finally {
+      setRetrying(false)
+    }
+  }
+
+  if (loading) {
+    return (
+      <Container className="p-6">
+        <Skeleton className="h-7 w-12 rounded-md" />
+      </Container>
+    )
+  }
+
+  if (!record) {
+    return (
+      <Container className="p-6 flex flex-col gap-4">
+        <Heading level="h1">Sync record not found</Heading>
+        <Button size="small" variant="secondary" onClick={() => navigate("/settings/faire")}>
+          Back to Faire settings
+        </Button>
+      </Container>
+    )
+  }
+
+  const warnings: string[] = record.error_message
+    ? record.error_message.split(" | ")
+    : []
+
+  return (
+    <div className="flex flex-col gap-4">
+      {error && (
+        <Container className="p-4">
+          <Text className="text-ui-tag-red-text">{error}</Text>
+        </Container>
+      )}
+
+      <Container className="divide-y p-0">
+        <div className="flex items-center justify-between px-6 py-4">
+          <div className="flex flex-col gap-1">
+            <Heading level="h1">Sync record</Heading>
+            <Text className="text-ui-fg-subtle font-mono text-xs">{record.id}</Text>
+          </div>
+          <div className="flex items-center gap-3">
+            <StatusBadge color={STATUS_COLORS[record.status] || "grey"}>
+              {record.status}
+            </StatusBadge>
+            <DropdownMenu>
+              <DropdownMenu.Trigger asChild>
+                <IconButton size="small" variant="transparent" disabled={retrying}>
+                  <EllipsisHorizontal />
+                </IconButton>
+              </DropdownMenu.Trigger>
+              <DropdownMenu.Content align="end">
+                <DropdownMenu.Item
+                  className="gap-x-2"
+                  onClick={handleRetry}
+                  disabled={retrying}
+                >
+                  <ArrowPath className="text-ui-fg-subtle" />
+                  {retrying ? "Re-syncing…" : "Re-sync product"}
+                </DropdownMenu.Item>
+                {record.product_url && (
+                  <DropdownMenu.Item
+                    className="gap-x-2"
+                    onClick={() => window.open(record.product_url!, "_blank")}
+                  >
+                    <ArrowUpRightOnBox className="text-ui-fg-subtle" />
+                    Open on Faire
+                  </DropdownMenu.Item>
+                )}
+              </DropdownMenu.Content>
+            </DropdownMenu>
+          </div>
+        </div>
+
+        <div className="px-6 py-4 grid grid-cols-2 gap-4">
+          <Detail label="Product" value={record.product_id} mono />
+          <Detail label="Action" value={record.action} />
+          <Detail label="Faire product token" value={record.product_token || "—"} mono />
+          <Detail label="State" value={record.product_state || "—"} />
+          <Detail label="Published" value={record.published ? "Yes" : "No"} />
+          <Detail
+            label="Synced at"
+            value={record.synced_at ? new Date(record.synced_at).toLocaleString() : "—"}
+          />
+        </div>
+      </Container>
+
+      {warnings.length > 0 && (
+        <Container className="divide-y p-0">
+          <div className="px-6 py-4">
+            <Heading level="h2">Issues</Heading>
+          </div>
+          <div className="px-6 py-4 flex flex-col gap-2">
+            {warnings.map((w, i) => (
+              <Text key={i} className="text-ui-tag-red-text text-sm">
+                {w}
+              </Text>
+            ))}
+          </div>
+        </Container>
+      )}
+
+      <Toaster />
+    </div>
+  )
+}
+
+const Detail = ({
+  label,
+  value,
+  mono,
+}: {
+  label: string
+  value: string
+  mono?: boolean
+}) => (
+  <div className="flex flex-col gap-1">
+    <Label>{label}</Label>
+    <Text className={mono ? "font-mono text-xs" : ""}>{value}</Text>
+  </div>
+)
+
+export const handle = {
+  breadcrumb: () => "Sync record",
+}
+
+export default FaireSyncDetailPage

package/src/admin/routes/settings/faire/hooks/use-faire-sync-columns.tsx

@@ -0,0 +1,80 @@
+import { createDataTableColumnHelper, StatusBadge } from "@medusajs/ui"
+
+export type FaireSyncRecord = {
+  id: string
+  product_id: string
+  account_id: string
+  product_token: string | null
+  product_url: string | null
+  product_state: string | null
+  action: string
+  status: string
+  published: boolean
+  error_message: string | null
+  synced_at: string | null
+  created_at: string
+}
+
+const columnHelper = createDataTableColumnHelper<FaireSyncRecord>()
+
+export const useFaireSyncColumns = () => {
+  return [
+    columnHelper.accessor("product_id", {
+      header: "Product",
+      cell: (info) => (
+        <span className="font-mono text-ui-fg-subtle text-xs">
+          {info.getValue()}
+        </span>
+      ),
+    }),
+    columnHelper.accessor("status", {
+      header: "Status",
+      cell: (info) => {
+        const status = info.getValue()
+        const color =
+          status === "success"
+            ? "green"
+            : status === "failed"
+              ? "red"
+              : status === "draft"
+                ? "orange"
+                : "grey"
+        return <StatusBadge color={color as any}>{status}</StatusBadge>
+      },
+    }),
+    columnHelper.accessor("product_state", {
+      header: "State",
+      cell: (info) => info.getValue() || "—",
+    }),
+    columnHelper.display({
+      id: "product",
+      header: "Faire product",
+      cell: ({ row }: any) => {
+        const r = row.original as FaireSyncRecord
+        if (!r.product_url) return "—"
+        return (
+          <a
+            href={r.product_url}
+            target="_blank"
+            rel="noreferrer"
+            onClick={(e) => e.stopPropagation()}
+            className="text-ui-fg-interactive hover:text-ui-fg-interactive-hover"
+          >
+            {r.product_token}
+          </a>
+        )
+      },
+    }),
+    columnHelper.accessor("synced_at", {
+      header: "Synced",
+      cell: (info) => {
+        const v = info.getValue()
+        return v ? new Date(v).toLocaleString() : "—"
+      },
+      enableSorting: true,
+      sortLabel: "Synced",
+      sortAscLabel: "Oldest first",
+      sortDescLabel: "Newest first",
+    }),
+  ]
+}