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

package/.medusa/server/src/workflows/sync-product-to-faire.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncProductToFaireWorkflow = exports.SYNC_PRODUCT_TO_FAIRE = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const utils_1 = require("@medusajs/framework/utils");
+const faire_sync_1 = require("../modules/faire-sync");
+exports.SYNC_PRODUCT_TO_FAIRE = "faire-sync-product";
+/**
+ * Faire doesn't expose a public storefront URL for every product the way Etsy
+ * does; fall back to the brand portal link if no url is present.
+ */
+const productDisplayUrl = (product) => {
+    if (product.url)
+        return product.url;
+    if (!product.product_token)
+        return null;
+    return `https://www.faire.com/brand/products/${product.product_token}`;
+};
+// ── Step 1: resolve account (fresh token) + settings ─────────────────────
+const resolveFaireConfigStep = (0, workflows_sdk_1.createStep)("faire-resolve-config-step", async (_, { container }) => {
+    const service = container.resolve(faire_sync_1.FAIRE_SYNC_MODULE);
+    const account = await service.ensureFreshToken();
+    const settings = await service.getSettings();
+    return new workflows_sdk_1.StepResponse({
+        account_id: account.id,
+        brand_id: account.brand_id,
+        access_token: account.access_token,
+        currency: account.currency ?? null,
+        settings,
+    });
+});
+// ── Step 2: fetch + map product ──────────────────────────────────────────
+const prepareProductStep = (0, workflows_sdk_1.createStep)("faire-prepare-product-step", async (input, { container }) => {
+    const query = container.resolve(utils_1.ContainerRegistrationKeys.QUERY);
+    const remoteLink = container.resolve(utils_1.ContainerRegistrationKeys.LINK);
+    const service = container.resolve(faire_sync_1.FAIRE_SYNC_MODULE);
+    const { data: products } = await query.graph({
+        entity: "product",
+        fields: [
+            "id",
+            "title",
+            "description",
+            "status",
+            "metadata",
+            "tags.*",
+            "variants.*",
+            "variants.prices.*",
+            "variants.inventory_items.*",
+            "images.*",
+            "variants.sku",
+        ],
+        filters: { id: input.product_id },
+    });
+    const product = products?.[0];
+    if (!product) {
+        throw new Error(`Product ${input.product_id} not found`);
+    }
+    // Resolve existing Faire product (from link)
+    let existing_product_token = null;
+    const account = await service.getActiveAccount();
+    if (account) {
+        try {
+            const linkRows = await remoteLink.list({
+                [utils_1.Modules.PRODUCT]: { product_id: input.product_id },
+                [faire_sync_1.FAIRE_SYNC_MODULE]: { faire_sync_account_id: account.id },
+            });
+            const row = linkRows?.[0];
+            existing_product_token = row?.faire_product_token ?? null;
+        }
+        catch {
+            // no link yet
+        }
+    }
+    const settings = input.settings;
+    const metadata = product.metadata || {};
+    const variants = product.variants || [];
+    // Medusa v2 stores money as a whole decimal in the price's currency (NOT
+    // minor units). Faire wants integer cents, so round to cents.
+    const toCents = (amount) => Math.round(Number(amount || 0) * 100);
+    const markupPercent = Number(metadata.faire_wholesale_markup_percent ?? settings.default_wholesale_markup_percent) ||
+        0;
+    const buildVariant = (v) => {
+        const prices = v.prices || [];
+        const retail = prices[0] ?? prices.find(Boolean);
+        const retailCents = retail ? toCents(retail.amount) : 0;
+        const wholesaleCents = markupPercent > 0
+            ? Math.round((retailCents * (100 - markupPercent)) / 100)
+            : retailCents;
+        return {
+            sku: v.sku || v.id,
+            name: v.title || undefined,
+            retail_price_cents: retailCents || undefined,
+            wholesale_price_cents: wholesaleCents || undefined,
+            inventory_count: Number(v.inventory_quantity) || 0,
+        };
+    };
+    // Aggregate retail/wholesale from min-variant for the product-level price.
+    const allPrices = variants.flatMap((v) => v.prices || []);
+    const minRetail = allPrices
+        .map((p) => toCents(p.amount))
+        .filter((a) => a > 0)
+        .sort((a, b) => a - b)[0] ?? 0;
+    const minWholesale = markupPercent > 0
+        ? Math.round((minRetail * (100 - markupPercent)) / 100)
+        : minRetail;
+    const tags = (product.tags || [])
+        .map((t) => t.value)
+        .filter(Boolean);
+    const images = (product.images || [])
+        .map((img) => ({ url: img.url }))
+        .filter((i) => i.url);
+    const product_input = {
+        brand_id: input.brand_id,
+        name: (product.title || "Untitled Product").slice(0, 140),
+        description: product.description || "",
+        wholesale_price_cents: minWholesale || undefined,
+        retail_price_cents: minRetail || undefined,
+        images,
+        variants: variants.length ? variants.map(buildVariant) : undefined,
+        tags,
+        short_description: typeof metadata.faire_short_description === "string"
+            ? metadata.faire_short_description
+            : undefined,
+    };
+    return new workflows_sdk_1.StepResponse({
+        product_id: input.product_id,
+        product_title: product.title,
+        product_status: product.status,
+        product_input,
+        existing_product_token,
+    });
+});
+// ── Step 3: create/update product + push inventory ───────────────────────
+const syncProductStep = (0, workflows_sdk_1.createStep)("faire-sync-product-step", async (input, { container }) => {
+    const service = container.resolve(faire_sync_1.FAIRE_SYNC_MODULE);
+    const client = service.getClient();
+    const { access_token, settings } = input.config;
+    const { product_input, existing_product_token, product_status } = input.prepared;
+    const warnings = [];
+    let product;
+    try {
+        if (existing_product_token) {
+            product = await client.updateProduct(access_token, existing_product_token, {
+                name: product_input.name,
+                description: product_input.description,
+                images: product_input.images,
+                variants: product_input.variants,
+                tags: product_input.tags,
+            });
+        }
+        else {
+            product = await client.createProduct(access_token, product_input);
+        }
+    }
+    catch (err) {
+        // Image fetch/upload failures shouldn't abort the whole sync.
+        warnings.push(`Product create/update failed: ${err?.message || err}`);
+        throw err;
+    }
+    // Push inventory levels for each variant.
+    if (product_input.variants?.length) {
+        try {
+            const levels = product_input.variants.map((v) => ({
+                sku: v.sku,
+                current_count: v.inventory_count ?? 0,
+            }));
+            await client.updateInventory(access_token, levels);
+        }
+        catch (err) {
+            warnings.push(`Inventory push failed: ${err?.message || err}`);
+        }
+    }
+    // Publish decision: follow product status.
+    const shouldPublish = settings.follow_product_status !== false && product_status === "published";
+    const published = shouldPublish && product.state === "active";
+    return new workflows_sdk_1.StepResponse({
+        product,
+        published,
+        warnings,
+    });
+}, async () => { });
+// ── Step 4: persist sync record + link ───────────────────────────────────
+const persistSyncResultStep = (0, workflows_sdk_1.createStep)("faire-persist-sync-result-step", async (input, { container }) => {
+    const service = container.resolve(faire_sync_1.FAIRE_SYNC_MODULE);
+    const remoteLink = container.resolve(utils_1.ContainerRegistrationKeys.LINK);
+    const { config, prepared, result } = input;
+    const status = result.published
+        ? "success"
+        : result.product.state === "draft"
+            ? "draft"
+            : "success";
+    await service.createSyncRecord({
+        product_id: prepared.product_id,
+        account_id: config.account_id,
+        product_token: result.product.product_token,
+        product_url: productDisplayUrl(result.product),
+        product_state: result.product.state,
+        action: prepared.existing_product_token ? "update" : "create",
+        status,
+        published: result.published,
+        error_message: result.warnings.length ? result.warnings.join(" | ") : null,
+        warnings: result.warnings,
+        metadata: { title: prepared.product_title },
+        synced_at: new Date(),
+    });
+    try {
+        await remoteLink.dismiss([
+            {
+                [utils_1.Modules.PRODUCT]: { product_id: prepared.product_id },
+                [faire_sync_1.FAIRE_SYNC_MODULE]: { faire_sync_account_id: config.account_id },
+            },
+        ]);
+    }
+    catch {
+        // ignore dismiss errors
+    }
+    await remoteLink.create([
+        {
+            [utils_1.Modules.PRODUCT]: { product_id: prepared.product_id },
+            [faire_sync_1.FAIRE_SYNC_MODULE]: { faire_sync_account_id: config.account_id },
+            data: {
+                faire_product_token: result.product.product_token,
+                faire_url: productDisplayUrl(result.product),
+                sync_status: "synced",
+                last_synced_at: new Date(),
+                sync_error: result.warnings.length ? result.warnings.join(" | ") : null,
+                metadata: {
+                    published: result.published,
+                    state: result.product.state,
+                    product_status: prepared.product_status,
+                },
+            },
+        },
+    ]);
+    return new workflows_sdk_1.StepResponse();
+});
+// ── Workflow ─────────────────────────────────────────────────────────────
+exports.syncProductToFaireWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.SYNC_PRODUCT_TO_FAIRE, (input) => {
+    const config = resolveFaireConfigStep();
+    const prepared = prepareProductStep((0, workflows_sdk_1.transform)({ input, config }, (data) => ({
+        product_id: data.input.product_id,
+        settings: data.config.settings,
+        brand_id: data.config.brand_id,
+    })));
+    const result = syncProductStep((0, workflows_sdk_1.transform)({ config, prepared }, (data) => ({
+        config: data.config,
+        prepared: data.prepared,
+    })));
+    persistSyncResultStep((0, workflows_sdk_1.transform)({ config, prepared, result }, (data) => ({
+        config: data.config,
+        prepared: data.prepared,
+        result: data.result,
+    })));
+    return new workflows_sdk_1.WorkflowResponse({
+        product_token: result.product.product_token,
+        product_url: productDisplayUrl(result.product),
+        published: result.published,
+        state: result.product.state,
+        warnings: result.warnings,
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3luYy1wcm9kdWN0LXRvLWZhaXJlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3dvcmtmbG93cy9zeW5jLXByb2R1Y3QtdG8tZmFpcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEscUVBTzBDO0FBQzFDLHFEQUE4RTtBQUc5RSxzREFBeUQ7QUFPNUMsUUFBQSxxQkFBcUIsR0FBRyxvQkFBb0IsQ0FBQTtBQTRCekQ7OztHQUdHO0FBQ0gsTUFBTSxpQkFBaUIsR0FBRyxDQUFDLE9BQXdCLEVBQWlCLEVBQUU7SUFDcEUsSUFBSSxPQUFPLENBQUMsR0FBRztRQUFFLE9BQU8sT0FBTyxDQUFDLEdBQUcsQ0FBQTtJQUNuQyxJQUFJLENBQUMsT0FBTyxDQUFDLGFBQWE7UUFBRSxPQUFPLElBQUksQ0FBQTtJQUN2QyxPQUFPLHdDQUF3QyxPQUFPLENBQUMsYUFBYSxFQUFFLENBQUE7QUFDeEUsQ0FBQyxDQUFBO0FBRUQsNEVBQTRFO0FBRTVFLE1BQU0sc0JBQXNCLEdBQUcsSUFBQSwwQkFBVSxFQUN2QywyQkFBMkIsRUFDM0IsS0FBSyxFQUFFLENBQUMsRUFBRSxFQUFFLFNBQVMsRUFBRSxFQUF5QyxFQUFFO0lBQ2hFLE1BQU0sT0FBTyxHQUFxQixTQUFTLENBQUMsT0FBTyxDQUFDLDhCQUFpQixDQUFDLENBQUE7SUFDdEUsTUFBTSxPQUFPLEdBQUcsTUFBTSxPQUFPLENBQUMsZ0JBQWdCLEVBQUUsQ0FBQTtJQUNoRCxNQUFNLFFBQVEsR0FBRyxNQUFNLE9BQU8sQ0FBQyxXQUFXLEVBQUUsQ0FBQTtJQUM1QyxPQUFPLElBQUksNEJBQVksQ0FBQztRQUN0QixVQUFVLEVBQUUsT0FBTyxDQUFDLEVBQUU7UUFDdEIsUUFBUSxFQUFFLE9BQU8sQ0FBQyxRQUFRO1FBQzFCLFlBQVksRUFBRSxPQUFPLENBQUMsWUFBWTtRQUNsQyxRQUFRLEVBQUUsT0FBTyxDQUFDLFFBQVEsSUFBSSxJQUFJO1FBQ2xDLFFBQVE7S0FD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

package/.medusa/server/src/workflows/sync-products-to-faire.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncProductsToFaireWorkflow = exports.SYNC_PRODUCTS_TO_FAIRE = void 0;
+const workflows_sdk_1 = require("@medusajs/framework/workflows-sdk");
+const faire_sync_1 = require("../modules/faire-sync");
+const sync_product_to_faire_1 = require("./sync-product-to-faire");
+exports.SYNC_PRODUCTS_TO_FAIRE = "faire-sync-products-bulk";
+// Faire enforces a modest per-second request budget and a daily call ceiling.
+// A single product sync fans out to several calls (create + inventory push),
+// so we pace *products* conservatively and let the client's 429 retry-after
+// backoff absorb bursts over the per-second limit.
+const BASE_DELAY_MS = 600;
+const MAX_DELAY_MS = 10_000;
+const PROGRESS_EVERY = 5;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+// ── Step 1 (inline): open the batch so the HTTP caller gets an id to poll ──
+const openBatchStep = (0, workflows_sdk_1.createStep)("faire-open-batch-step", async (input, { container, context }) => {
+    const service = container.resolve(faire_sync_1.FAIRE_SYNC_MODULE);
+    const account = await service.getActiveAccount();
+    if (!account) {
+        throw new Error("Faire account is not connected");
+    }
+    const batch = await service.createFaireSyncBatches({
+        transaction_id: context.transactionId,
+        status: "processing",
+        total_products: input.product_ids.length,
+        synced_count: 0,
+        failed_count: 0,
+        error_log: {},
+        started_at: new Date(),
+    });
+    return new workflows_sdk_1.StepResponse({ batch_id: batch.id });
+});
+// ── Step 2 (async, background): process every product with backoff ─────────
+const processBatchStep = (0, workflows_sdk_1.createStep)("faire-process-batch-step", async (input, { container }) => {
+    const service = container.resolve(faire_sync_1.FAIRE_SYNC_MODULE);
+    let synced = 0;
+    let failed = 0;
+    let delay = BASE_DELAY_MS;
+    const errors = {};
+    const persistProgress = async () => {
+        await service
+            .updateFaireSyncBatches({
+            id: input.batch_id,
+            synced_count: synced,
+            failed_count: failed,
+            error_log: errors,
+        })
+            .catch(() => { });
+    };
+    for (let i = 0; i < input.product_ids.length; i++) {
+        const product_id = input.product_ids[i];
+        try {
+            await (0, sync_product_to_faire_1.syncProductToFaireWorkflow)(container).run({ input: { product_id } });
+            synced++;
+            delay = Math.max(BASE_DELAY_MS, Math.floor(delay / 2));
+        }
+        catch (err) {
+            failed++;
+            errors[product_id] = err?.message || "Unknown error";
+            if (/429|rate limit/i.test(errors[product_id])) {
+                delay = Math.min(delay * 2, MAX_DELAY_MS);
+            }
+        }
+        if ((i + 1) % PROGRESS_EVERY === 0) {
+            await persistProgress();
+        }
+        if (i < input.product_ids.length - 1) {
+            await sleep(delay);
+        }
+    }
+    await service.updateFaireSyncBatches({
+        id: input.batch_id,
+        status: failed === input.product_ids.length ? "failed" : "completed",
+        synced_count: synced,
+        failed_count: failed,
+        error_log: errors,
+        completed_at: new Date(),
+    });
+    return new workflows_sdk_1.StepResponse({ synced, failed });
+});
+exports.syncProductsToFaireWorkflow = (0, workflows_sdk_1.createWorkflow)(exports.SYNC_PRODUCTS_TO_FAIRE, (input) => {
+    const opened = openBatchStep(input);
+    processBatchStep((0, workflows_sdk_1.transform)({ input, opened }, (data) => ({
+        batch_id: data.opened.batch_id,
+        product_ids: data.input.product_ids,
+    }))).config({ async: true, backgroundExecution: true });
+    return new workflows_sdk_1.WorkflowResponse({ batch_id: opened.batch_id });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3luYy1wcm9kdWN0cy10by1mYWlyZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy93b3JrZmxvd3Mvc3luYy1wcm9kdWN0cy10by1mYWlyZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSxxRUFPMEM7QUFDMUMsc0RBQXlEO0FBRXpELG1FQUFvRTtBQUV2RCxRQUFBLHNCQUFzQixHQUFHLDBCQUEwQixDQUFBO0FBTWhFLDhFQUE4RTtBQUM5RSw2RUFBNkU7QUFDN0UsNEVBQTRFO0FBQzVFLG1EQUFtRDtBQUNuRCxNQUFNLGFBQWEsR0FBRyxHQUFHLENBQUE7QUFDekIsTUFBTSxZQUFZLEdBQUcsTUFBTSxDQUFBO0FBQzNCLE1BQU0sY0FBYyxHQUFHLENBQUMsQ0FBQTtBQUV4QixNQUFNLEtBQUssR0FBRyxDQUFDLEVBQVUsRUFBRSxFQUFFLENBQUMsSUFBSSxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQTtBQUVuRSw4RUFBOEU7QUFFOUUsTUFBTSxhQUFhLEdBQUcsSUFBQSwwQkFBVSxFQUM5Qix1QkFBdUIsRUFDdkIsS0FBSyxFQUNILEtBQWdDLEVBQ2hDLEVBQUUsU0FBUyxFQUFFLE9BQU8sRUFBRSxFQUN1QixFQUFFO0lBQy9DLE1BQU0sT0FBTyxHQUFxQixTQUFTLENBQUMsT0FBTyxDQUFDLDhCQUFpQixDQUFDLENBQUE7SUFFdEUsTUFBTSxPQUFPLEdBQUcsTUFBTSxPQUFPLENBQUMsZ0JBQWdCLEVBQUUsQ0FBQTtJQUNoRCxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDYixNQUFNLElBQUksS0FBSyxDQUFDLGdDQUFnQyxDQUFDLENBQUE7SUFDbkQsQ0FBQztJQUVELE1BQU0sS0FBSyxHQUFHLE1BQU0sT0FBTyxDQUFDLHNCQUFzQixDQUFDO1FBQ2pELGNBQWMsRUFBRSxPQUFPLENBQUMsYUFBYTtRQUNy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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jaal Yantra Textiles
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,180 @@
+# @jytextiles/medusa-plugin-faire-store-sync
+
+A [Medusa v2](https://medusajs.com) plugin that **bidirectionally** syncs your
+Medusa products, inventory and orders with a [Faire](https://www.faire.com)
+brand account via the [Faire External Platform API](https://developer.faire.com)
+(OAuth 2.0). It handles the OAuth connect flow, product push (create/update +
+inventory), bulk product sync, bulk order ingestion, and inbound Faire webhooks
+for order/inventory/product events.
+
+> ⚠️ **Note on API specifics.** Faire's developer portal is access-gated, so
+> this plugin's endpoint paths, payload shapes and webhook signature scheme
+> reflect the publicly documented v2 surface and standard OAuth2 conventions.
+> If your Faire app uses a different base URL, token header, or signing scheme,
+> override via the options/env vars below — the client is intentionally
+> permissive. Verify against your Faire app's documentation before going live.
+
+## Features
+
+- **OAuth 2.0 redirect connect flow** — connect/disconnect a Faire brand from
+  **Settings → Faire** in the Admin; tokens are stored and auto-refreshed when
+  applicable.
+- **Product → Faire sync** — create/update Faire products, push variant
+  inventory, upload images via URL (single or bulk).
+- **Faire → Medusa order ingestion** — bulk-pull Faire orders and create
+  matching Medusa orders (idempotent, payment marked captured).
+- **Readiness checks** — surfaces what's missing (brand, wholesale-pricing
+  strategy, shipping policy) before publishing.
+- **Sync records** — every sync is tracked per product with status and the
+  remote Faire product token.
+- **Long-running bulk workflows** — both bulk product push and bulk order pull
+  run as background workflows (`backgroundExecution`) with a pollable batch id.
+- **Event-driven** — inbound Faire webhooks (order placed/canceled/shipped,
+  inventory updated, product updated) are verified, recorded idempotently and
+  re-emitted as Medusa events; `product.updated` re-syncs linked products when
+  their status actually changes.
+
+## Requirements
+
+- Medusa **2.17.x**
+- Node.js **>= 22**
+- A Faire app (client id + client secret) from the Faire developer portal, with
+  the OAuth redirect URL registered.
+
+## Install
+
+```bash
+npm install @jytextiles/medusa-plugin-faire-store-sync
+# or
+yarn add @jytextiles/medusa-plugin-faire-store-sync
+# or
+pnpm add @jytextiles/medusa-plugin-faire-store-sync
+```
+
+## Configure
+
+Register the plugin in `medusa-config.ts`:
+
+```ts
+module.exports = defineConfig({
+  // ...
+  plugins: [
+    {
+      resolve: "@jytextiles/medusa-plugin-faire-store-sync",
+      options: {
+        clientId: process.env.FAIRE_CLIENT_ID,
+        clientSecret: process.env.FAIRE_CLIENT_SECRET,
+        redirectUri:
+          process.env.FAIRE_REDIRECT_URI ??
+          "http://localhost:9000/app/settings/oauth/faire/callback",
+        webhookSecret: process.env.FAIRE_WEBHOOK_SECRET,
+        // Optional overrides (defaults shown):
+        // apiBase: "https://www.faire.com/api/v2",
+        // authUrl: "https://www.faire.com/oauth/authorize",
+        // tokenUrl: "https://www.faire.com/oauth/token",
+      },
+    },
+  ],
+})
+```
+
+Options can be supplied via the `options` object above **or** the matching
+environment variables (env takes precedence):
+
+| Option          | Env var               | Required | Description                                                        |
+| --------------- | --------------------- | -------- | ------------------------------------------------------------------ |
+| `clientId`      | `FAIRE_CLIENT_ID`     | yes      | Your Faire app's client id.                                        |
+| `clientSecret`  | `FAIRE_CLIENT_SECRET` | yes      | Your Faire app's client secret.                                    |
+| `redirectUri`   | `FAIRE_REDIRECT_URI`  | no       | OAuth callback URL. Must match your Faire app's registered redirect. |
+| `webhookSecret` | `FAIRE_WEBHOOK_SECRET`| no       | Signing secret for verifying inbound Faire webhooks.               |
+| `apiBase`       | `FAIRE_API_BASE`      | no       | Override the Faire API base URL (e.g. for sandbox).                |
+| `authUrl`       | `FAIRE_AUTH_URL`      | no       | Override the OAuth authorize URL.                                  |
+| `tokenUrl`      | `FAIRE_TOKEN_URL`     | no       | Override the OAuth token URL.                                      |
+
+After installing, run your project's migrations so the plugin's tables are
+created:
+
+```bash
+npx medusa db:migrate
+```
+
+### Webhook raw body
+
+The host app's `src/api/middlewares.ts` must preserve the raw request body for
+the Faire webhook path so the signature can be verified:
+
+```ts
+import { defineMiddlewares } from "@medusajs/framework/http"
+
+export default defineMiddlewares({
+  routes: [
+    {
+      matcher: "/webhooks/faire",
+      method: "POST",
+      middlewares: [/* preserveRawBody — see your Medusa version's helper */],
+    },
+  ],
+})
+```
+
+Register the webhook URL (`https://your-host/webhooks/faire`) and copy the
+signing secret into `FAIRE_WEBHOOK_SECRET` when you create the webhook via the
+Faire API.
+
+### Optional behavior flags
+
+| Env var                       | Default | Effect                                                      |
+| ----------------------------- | ------- | ----------------------------------------------------------- |
+| `FAIRE_INGEST_ORDERS`         | `true`  | Set `false` to disable creating Medusa orders from Faire.   |
+| `FAIRE_DECREMENT_INVENTORY`   | `false` | Set `true` to decrement Medusa stock on Faire order ingest. |
+| `FAIRE_AUTO_INGEST_ORDERS`    | `true`  | Set `false` to disable the scheduled order-pull job.        |
+
+## Usage
+
+1. In the Admin, go to **Settings → Faire** and click **Connect** to authorize
+   your Faire brand.
+2. Configure sync settings (brand, wholesale markup %, shipping policy).
+3. From a product page, use the **Faire Sync** widget to sync the product, or
+   sync in bulk from the Faire settings page (Bulk operations card).
+4. Pull Faire orders into Medusa with the **Start order pull** button (also runs
+   on a 30-minute schedule).
+
+### Admin API routes
+
+| Method | Route                              | Purpose                                            |
+| ------ | ---------------------------------- | -------------------------------------------------- |
+| GET    | `/admin/faire/status`              | Connection + readiness status                      |
+| GET/POST | `/admin/faire/settings`          | Read / save sync settings                          |
+| GET    | `/admin/faire/auth/authorize`      | Start the OAuth2 flow                              |
+| POST   | `/admin/faire/auth/callback`       | OAuth2 callback (called by the SPA)                |
+| POST   | `/admin/faire/auth/disconnect`     | Disconnect the brand                               |
+| POST   | `/admin/faire/sync/product/:id`    | Sync a single product                              |
+| POST   | `/admin/faire/sync/bulk`           | Sync multiple products (background workflow, 202)  |
+| GET    | `/admin/faire/sync/bulk/:batchId`  | Poll bulk product-sync progress                    |
+| POST   | `/admin/faire/ingest/orders`       | Pull Faire orders (background workflow, 202)       |
+| GET    | `/admin/faire/ingest/orders/:batchId` | Poll bulk order-ingest progress                 |
+| GET    | `/admin/faire/syncs`               | List sync records                                  |
+| GET/POST | `/admin/faire/syncs/:id`          | Fetch / retry a sync record                        |
+| GET    | `/admin/faire/brand`               | The connected Faire brand                          |
+| GET    | `/admin/faire/products`            | Products already on Faire                          |
+| POST   | `/webhooks/faire`                  | Inbound Faire webhook receiver                     |
+
+## Development
+
+```bash
+# Build the plugin (compiles to .medusa/server, then restructures via postbuild)
+npm run build
+
+# Watch mode while developing against a local Medusa app
+npm run dev
+
+# Generate a migration after changing a model
+npm run db:generate
+
+# Run tests
+npm run test
+```
+
+## License
+
+[MIT](./LICENSE)

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@jytextiles/medusa-plugin-faire-store-sync",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "description": "Medusa v2 plugin to bidirectionally sync Medusa products, inventory and orders with a Faire brand account via the Faire External Platform API (OAuth 2.0).",
+  "keywords": [
+    "medusa-v2",
+    "medusa-plugin-integration",
+    "medusa-plugin-other",
+    "faire",
+    "medusa",
+    "plugin"
+  ],
+  "license": "MIT",
+  "author": "Jaal Yantra Textiles",
+  "homepage": "https://github.com/Jaal-Yantra-Textiles/v2/tree/main/packages/medusa-plugin-faire-store-sync#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jaal-Yantra-Textiles/v2.git",
+    "directory": "packages/medusa-plugin-faire-store-sync"
+  },
+  "bugs": {
+    "url": "https://github.com/Jaal-Yantra-Textiles/v2/issues"
+  },
+  "scripts": {
+    "build": "medusa plugin:build",
+    "dev": "medusa plugin:develop",
+    "db:generate": "medusa plugin:db:generate",
+    "test": "jest"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./workflows": "./.medusa/server/src/workflows/index.js",
+    "./.medusa/server/src/modules/*": "./.medusa/server/src/modules/*/index.js",
+    "./providers/*": "./.medusa/server/src/providers/*/index.js",
+    "./admin": {
+      "import": "./.medusa/server/src/admin/index.mjs",
+      "require": "./.medusa/server/src/admin/index.js",
+      "default": "./.medusa/server/src/admin/index.js"
+    },
+    "./*": "./.medusa/server/src/*.js"
+  },
+  "files": [
+    "src",
+    ".medusa",
+    "scripts"
+  ],
+  "devDependencies": {
+    "@medusajs/admin-sdk": "2.17.2",
+    "@medusajs/cli": "2.17.2",
+    "@medusajs/dashboard": "2.17.2",
+    "@medusajs/framework": "2.17.2",
+    "@medusajs/medusa": "2.17.2",
+    "@medusajs/test-utils": "2.17.2",
+    "@medusajs/ui": "4.1.19",
+    "@medusajs/icons": "2.17.2",
+    "@medusajs/types": "2.17.2",
+    "@swc/core": "1.5.7",
+    "@swc/jest": "0.2.37",
+    "@types/jest": "29.5.14",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.3.2",
+    "@types/react-dom": "^18.2.25",
+    "jest": "29.7.0",
+    "typescript": "5.6.3"
+  },
+  "peerDependencies": {
+    "@medusajs/admin-sdk": "2.17.2",
+    "@medusajs/cli": "2.17.2",
+    "@medusajs/dashboard": "2.17.2",
+    "@medusajs/framework": "2.17.2",
+    "@medusajs/medusa": "2.17.2",
+    "@medusajs/test-utils": "2.17.2",
+    "@medusajs/ui": "4.1.19",
+    "@medusajs/icons": "2.17.2",
+    "@medusajs/types": "2.17.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "6.30.4"
+  }
+}