@amboras-dev/aliexpress-dropshipping 1.1.0 → 1.2.2

package/dist/chunk-65TJ4JF6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/settings-form.tsx"],"sourcesContent":["/**\n * Public types for @amboras-dev/aliexpress-dropshipping.\n *\n * These are the single source of truth for the wire shape between the\n * Amboras admin settings form and the medusa-backend-orchestrator\n * Store API routes under `/store/aliexpress-dropshipping/*`. The DTO\n * files on the medusa side must stay byte-compatible with these.\n */\n\n/**\n * Sentinel returned in place of a stored secret when the settings form\n * reads back current config. Matches the pattern used by meta-ads and\n * pinterest so the admin never sees the plaintext secret after write.\n */\nexport const SECRET_SET_SENTINEL = '__SECRET_SET__' as const\nexport type SecretSetSentinel = typeof SECRET_SET_SENTINEL\n\n/**\n * Per-store AliExpress plugin configuration.\n *\n * - `appKey` / `appSecret` are per-store developer app credentials\n *   supplied by the merchant. The admin form receives\n *   `SECRET_SET_SENTINEL` for `appSecret` on read, and only sends a\n *   real value on user edit.\n * - `connectedSellerId` is populated after the merchant completes the\n *   OAuth flow to `/rest/auth/token/create`.\n * - `needsReauth` is flipped by the backend runtime detector when it\n *   sees `MissingParameter access_token` or `IllegalAccessToken`\n *   sub-codes on any envelope.\n * - `lastSuccessfulCallAt` is an ISO-8601 timestamp for the status card.\n */\nexport interface AliExpressPluginConfig {\n  enabled: boolean\n  appKey: string | null\n  appSecret: string | SecretSetSentinel | null\n  connectedSellerId: string | null\n  needsReauth: boolean\n  lastSuccessfulCallAt: string | null\n}\n\n/**\n * Reasons the backend surfaces when a merchant token becomes invalid.\n * Kept narrow so the admin banner can render a specific message.\n */\nexport enum AliExpressReauthReason {\n  MissingAccessToken = 'missing_access_token',\n  IllegalAccessToken = 'illegal_access_token',\n  RefreshFailed = 'refresh_failed',\n  Disconnected = 'disconnected',\n}\n\n/**\n * Category node returned by `aliexpress.ds.category.get`. The API\n * returns a flat list; the admin renders it as a tree by walking\n * `parentCategoryId`.\n */\nexport interface AliExpressCategoryDto {\n  categoryId: string\n  categoryName: string\n  parentCategoryId: string | null\n}\n\n/**\n * Product summary shape returned by `aliexpress.ds.recommend.feed.get`.\n * Used by the \"browse products\" admin surface.\n */\nexport interface AliExpressProductSummaryDto {\n  productId: string\n  title: string\n  imageUrl: string | null\n  minPrice: number | null\n  maxPrice: number | null\n  currency: string | null\n  productDetailUrl: string | null\n}\n\n/**\n * Full product shape returned by `aliexpress.ds.product.get`. Consumed\n * by the medusa-side mapper `aliexpressProductToMedusaDraft`.\n */\nexport interface AliExpressProductDto {\n  productId: string\n  title: string\n  description: string | null\n  images: string[]\n  variants: AliExpressProductVariantDto[]\n  weightGrams: number | null\n  sourceUrl: string | null\n}\n\nexport interface AliExpressProductVariantDto {\n  skuId: string\n  title: string | null\n  price: number\n  currency: string\n  stock: number | null\n  attributes: Record<string, string>\n}\n\n/**\n * Return shape from `POST /store/aliexpress-dropshipping/products/:id/import`.\n */\nexport interface AliExpressImportResultDto {\n  medusaProductId: string\n  sourceProductId: string\n  importedVariants: number\n}\n\n/**\n * Return shape from `GET /store/aliexpress-dropshipping/status` - drives\n * the admin status card.\n */\nexport interface AliExpressConnectionStatusDto {\n  connected: boolean\n  sellerId: string | null\n  needsReauth: boolean\n  reauthReason: AliExpressReauthReason | null\n  lastSuccessfulCallAt: string | null\n}\n\n/**\n * Return shape from `POST /store/aliexpress-dropshipping/test-connection`.\n */\nexport type AliExpressTestConnectionResult =\n  | { ok: true; categoryCount: number }\n  | { ok: false; code: string; msg: string }\n\nexport interface PreflightMerchantError {\n  code: string\n  message: string\n}\n\nexport interface PreflightAddressError {\n  code: string\n  message: string\n  field: string\n}\n\nexport interface PreflightItemError {\n  variantId: string\n  productTitle: string\n  code: 'CORRUPT_METADATA' | 'PRODUCT_OFFLINE' | 'OUT_OF_STOCK' | 'CANNOT_SHIP' | 'PRICE_DRIFT'\n  message: string\n  removable: boolean\n}\n\nexport interface PreflightResult {\n  ok: boolean\n  merchantErrors: PreflightMerchantError[]\n  addressErrors: PreflightAddressError[]\n  itemErrors: PreflightItemError[]\n  warnings: Array<{ code: string; message: string }>\n  degraded?: boolean\n  warning?: string\n}\n","'use client'\n\n/**\n * Admin settings form for the AliExpress Dropshipping integration.\n *\n * Class B: this component owns the UI and talks to the Medusa Store API\n * under `/store/aliexpress-dropshipping/*`. It does NOT embed any\n * AliExpress SDK, does not sign requests, and does not touch OAuth\n * tokens directly - the backend does all of that.\n *\n * The component is intentionally dependency-light (no external UI kit,\n * no @tanstack/react-query peer) so the admin bundle can drop it in\n * without extra peer dep resolution.\n */\n\nimport * as React from 'react'\nimport type {\n  AliExpressPluginConfig,\n  AliExpressConnectionStatusDto,\n  AliExpressTestConnectionResult,\n} from './types'\nimport { SECRET_SET_SENTINEL } from './types'\n\nexport interface AliExpressDropshippingSettingsFormProps {\n  /** Current config for this store (fetched by the parent server component). */\n  initialConfig: AliExpressPluginConfig\n  /** Current connection status (from `GET /status`). */\n  initialStatus: AliExpressConnectionStatusDto\n  /**\n   * Persist non-secret + optionally new secret values. The parent maps\n   * this onto `PATCH /store/aliexpress-dropshipping/config` (or\n   * equivalent) and then re-fetches config on success.\n   *\n   * `appSecret` is only sent when the merchant actually typed a new\n   * value; if they leave the field untouched, this method receives\n   * `undefined` for that key so the backend keeps the existing secret.\n   */\n  onSaveConfig: (patch: {\n    appKey?: string\n    appSecret?: string\n    enabled?: boolean\n  }) => Promise<void>\n  /** Kick off `POST /oauth/start` and redirect to the returned URL. */\n  onConnect: () => Promise<void>\n  /** Kick off `POST /oauth/disconnect` and clear merchant credentials. */\n  onDisconnect: () => Promise<void>\n  /** Call `POST /test-connection` and return the result. */\n  onTestConnection: () => Promise<AliExpressTestConnectionResult>\n}\n\ntype SaveState = 'idle' | 'saving' | 'saved' | 'error'\ntype TestState =\n  | { kind: 'idle' }\n  | { kind: 'running' }\n  | { kind: 'ok'; categoryCount: number }\n  | { kind: 'err'; code: string; msg: string }\n\n/**\n * Amboras admin settings surface for AliExpress Dropshipping.\n * Renders AppKey + AppSecret inputs, Test / Connect / Disconnect\n * buttons, status card, and a \"Coming soon\" order-forwarding block.\n */\nexport function AliExpressDropshippingSettingsForm(\n  props: AliExpressDropshippingSettingsFormProps,\n): React.ReactElement {\n  const {\n    initialConfig,\n    initialStatus,\n    onSaveConfig,\n    onConnect,\n    onDisconnect,\n    onTestConnection,\n  } = props\n\n  const [appKey, setAppKey] = React.useState<string>(\n    initialConfig.appKey ?? '',\n  )\n  const secretPreset =\n    initialConfig.appSecret === SECRET_SET_SENTINEL ||\n    (typeof initialConfig.appSecret === 'string' &&\n      initialConfig.appSecret.length > 0)\n  const [appSecret, setAppSecret] = React.useState<string>('')\n  const [secretDirty, setSecretDirty] = React.useState<boolean>(false)\n\n  const [saveState, setSaveState] = React.useState<SaveState>('idle')\n  const [saveError, setSaveError] = React.useState<string | null>(null)\n\n  const [testState, setTestState] = React.useState<TestState>({ kind: 'idle' })\n  const [testEverSucceeded, setTestEverSucceeded] = React.useState<boolean>(\n    initialStatus.connected,\n  )\n\n  const [busyOAuth, setBusyOAuth] = React.useState<boolean>(false)\n\n  const hasStoredSecret = secretPreset || secretDirty\n  const canTest = appKey.trim().length > 0 && hasStoredSecret\n  const canConnect = testEverSucceeded && !initialStatus.connected\n  const canDisconnect = initialStatus.connected\n\n  const handleSave = React.useCallback(async () => {\n    setSaveState('saving')\n    setSaveError(null)\n    try {\n      const patch: {\n        appKey?: string\n        appSecret?: string\n        enabled?: boolean\n      } = {}\n      if (appKey.trim() !== (initialConfig.appKey ?? '')) {\n        patch.appKey = appKey.trim()\n      }\n      if (secretDirty && appSecret.length > 0) {\n        patch.appSecret = appSecret\n      }\n      await onSaveConfig(patch)\n      setSaveState('saved')\n      setSecretDirty(false)\n      setAppSecret('')\n    } catch (err) {\n      setSaveState('error')\n      setSaveError(err instanceof Error ? err.message : 'Save failed')\n    }\n  }, [appKey, appSecret, secretDirty, initialConfig.appKey, onSaveConfig])\n\n  const handleTest = React.useCallback(async () => {\n    setTestState({ kind: 'running' })\n    try {\n      const result = await onTestConnection()\n      if (result.ok) {\n        setTestState({ kind: 'ok', categoryCount: result.categoryCount })\n        setTestEverSucceeded(true)\n      } else {\n        setTestState({ kind: 'err', code: result.code, msg: result.msg })\n      }\n    } catch (err) {\n      setTestState({\n        kind: 'err',\n        code: 'UNKNOWN',\n        msg: err instanceof Error ? err.message : 'Test failed',\n      })\n    }\n  }, [onTestConnection])\n\n  const handleConnect = React.useCallback(async () => {\n    setBusyOAuth(true)\n    try {\n      await onConnect()\n    } finally {\n      setBusyOAuth(false)\n    }\n  }, [onConnect])\n\n  const handleDisconnect = React.useCallback(async () => {\n    setBusyOAuth(true)\n    try {\n      await onDisconnect()\n    } finally {\n      setBusyOAuth(false)\n    }\n  }, [onDisconnect])\n\n  return (\n    <div className=\"aliexpress-dropshipping-settings\">\n      <section aria-labelledby=\"ae-credentials-heading\">\n        <h2 id=\"ae-credentials-heading\">Developer app credentials</h2>\n        <p>\n          Enter your AliExpress Open Platform app credentials. These are\n          stored encrypted at rest and used to sign every AliExpress API\n          call for this store.\n        </p>\n\n        <label>\n          <span>App Key</span>\n          <input\n            type=\"text\"\n            value={appKey}\n            onChange={(e) => setAppKey(e.target.value)}\n            autoComplete=\"off\"\n            spellCheck={false}\n          />\n        </label>\n\n        <label>\n          <span>App Secret</span>\n          <input\n            type=\"password\"\n            value={appSecret}\n            placeholder={secretPreset ? '(secret set - leave blank to keep)' : ''}\n            onChange={(e) => {\n              setAppSecret(e.target.value)\n              setSecretDirty(true)\n            }}\n            autoComplete=\"off\"\n            spellCheck={false}\n          />\n        </label>\n\n        <div className=\"actions\">\n          <button\n            type=\"button\"\n            onClick={handleSave}\n            disabled={saveState === 'saving' || appKey.trim().length === 0}\n          >\n            {saveState === 'saving' ? 'Saving...' : 'Save credentials'}\n          </button>\n          <button\n            type=\"button\"\n            onClick={handleTest}\n            disabled={!canTest || testState.kind === 'running'}\n          >\n            {testState.kind === 'running' ? 'Testing...' : 'Test connection'}\n          </button>\n        </div>\n\n        {saveState === 'saved' ? <p role=\"status\">Saved.</p> : null}\n        {saveState === 'error' && saveError ? (\n          <p role=\"alert\">Save failed: {saveError}</p>\n        ) : null}\n\n        {testState.kind === 'ok' ? (\n          <p role=\"status\">\n            Connected to AliExpress. Found {testState.categoryCount} categories.\n          </p>\n        ) : null}\n        {testState.kind === 'err' ? (\n          <p role=\"alert\">\n            Test failed ({testState.code}): {testState.msg}\n          </p>\n        ) : null}\n      </section>\n\n      <section aria-labelledby=\"ae-oauth-heading\">\n        <h2 id=\"ae-oauth-heading\">Merchant account connection</h2>\n        <p>\n          Connect a specific AliExpress seller account to enable product\n          import into this store. This is separate from the developer app\n          credentials above.\n        </p>\n\n        {initialStatus.needsReauth ? (\n          <p role=\"alert\" className=\"reauth-banner\">\n            Re-authentication required. Please reconnect your AliExpress account.\n          </p>\n        ) : null}\n\n        <div className=\"status-card\">\n          <div>\n            <strong>Status:</strong>{' '}\n            {initialStatus.connected ? 'Connected' : 'Not connected'}\n          </div>\n          {initialStatus.sellerId ? (\n            <div>\n              <strong>Seller ID:</strong> {initialStatus.sellerId}\n            </div>\n          ) : null}\n          {initialStatus.lastSuccessfulCallAt ? (\n            <div>\n              <strong>Last successful call:</strong>{' '}\n              {initialStatus.lastSuccessfulCallAt}\n            </div>\n          ) : null}\n        </div>\n\n        <div className=\"actions\">\n          <button\n            type=\"button\"\n            onClick={handleConnect}\n            disabled={!canConnect || busyOAuth}\n          >\n            {busyOAuth ? 'Working...' : 'Connect merchant AliExpress account'}\n          </button>\n          <button\n            type=\"button\"\n            onClick={handleDisconnect}\n            disabled={!canDisconnect || busyOAuth}\n          >\n            Disconnect\n          </button>\n        </div>\n\n        {!testEverSucceeded ? (\n          <p>\n            Run <em>Test connection</em> once with your AppKey/AppSecret before\n            connecting a merchant account.\n          </p>\n        ) : null}\n      </section>\n\n      <section aria-labelledby=\"ae-coming-soon-heading\">\n        <h2 id=\"ae-coming-soon-heading\">Order forwarding</h2>\n        <p>\n          Coming soon. Automatic order forwarding to AliExpress requires\n          our app to be approved out of Test status by AliExpress. Product\n          import and browsing work today.\n        </p>\n      </section>\n    </div>\n  )\n}\n\nexport default AliExpressDropshippingSettingsForm\n"],"mappings":"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","names":["AliExpressReauthReason"]}

package/dist/chunk-FPBGH4MH.mjs

@@ -0,0 +1,89 @@
+// src/client/use-preflight.ts
+import { useCallback, useState } from "react";
+function useAliexpressPreflight(options = {}) {
+  const [isPending, setIsPending] = useState(false);
+  const mutateAsync = useCallback(async ({ cartId }) => {
+    setIsPending(true);
+    try {
+      const baseUrl = options.baseUrl ?? process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL ?? "";
+      const publishableKey = options.publishableKey ?? process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY ?? "";
+      const response = await fetch(`${baseUrl.replace(/\/$/, "")}/store/aliexpress-dropshipping/preflight-cart`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...publishableKey ? { "x-publishable-api-key": publishableKey } : {}
+        },
+        body: JSON.stringify({ cart_id: cartId })
+      });
+      if (!response.ok) throw new Error(`Preflight check failed: ${response.status}`);
+      return await response.json();
+    } finally {
+      setIsPending(false);
+    }
+  }, [options.baseUrl, options.publishableKey]);
+  return { mutateAsync, isPending };
+}
+
+// src/client/preflight-guard.tsx
+import { useEffect, useState as useState2 } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+function AliexpressCheckoutGuard({ cartId, options, onBlock }) {
+  const preflight = useAliexpressPreflight(options);
+  const [blockedResult, setBlockedResult] = useState2(null);
+  useEffect(() => {
+    if (!cartId) return;
+    let cancelled = false;
+    void preflight.mutateAsync({ cartId }).then((result) => {
+      if (cancelled) return;
+      if (!result.ok) {
+        setBlockedResult(result);
+        onBlock?.(result);
+      } else {
+        setBlockedResult(null);
+      }
+    }).catch(() => {
+      if (!cancelled) setBlockedResult(null);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [cartId]);
+  if (!blockedResult) return null;
+  const itemErrors = blockedResult.itemErrors ?? [];
+  const addressErrors = blockedResult.addressErrors ?? [];
+  const merchantErrors = blockedResult.merchantErrors ?? [];
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      role: "alert",
+      style: {
+        border: "1px solid #f5c2c7",
+        background: "#f8d7da",
+        color: "#842029",
+        padding: "12px 16px",
+        borderRadius: 8,
+        marginBottom: 16,
+        fontSize: 14,
+        lineHeight: 1.4
+      },
+      children: [
+        /* @__PURE__ */ jsx("strong", { style: { display: "block", marginBottom: 6 }, children: "Some items in your cart can't be shipped" }),
+        /* @__PURE__ */ jsxs("ul", { style: { margin: 0, paddingLeft: 20 }, children: [
+          itemErrors.map((err) => /* @__PURE__ */ jsxs("li", { children: [
+            /* @__PURE__ */ jsx("strong", { children: err.productTitle }),
+            ": ",
+            err.message
+          ] }, err.variantId)),
+          addressErrors.map((err, idx) => /* @__PURE__ */ jsx("li", { children: err.message }, `addr-${idx}`)),
+          merchantErrors.map((err, idx) => /* @__PURE__ */ jsx("li", { children: err.message }, `merchant-${idx}`))
+        ] })
+      ]
+    }
+  );
+}
+
+export {
+  useAliexpressPreflight,
+  AliexpressCheckoutGuard
+};
+//# sourceMappingURL=chunk-FPBGH4MH.mjs.map

package/dist/chunk-FPBGH4MH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/use-preflight.ts","../src/client/preflight-guard.tsx"],"sourcesContent":["'use client'\n\nimport { useCallback, useState } from 'react'\nimport type { PreflightResult } from '../types'\n\nexport interface UseAliexpressPreflightOptions {\n  baseUrl?: string\n  publishableKey?: string\n}\n\nexport function useAliexpressPreflight(options: UseAliexpressPreflightOptions = {}) {\n  const [isPending, setIsPending] = useState(false)\n  const mutateAsync = useCallback(async ({ cartId }: { cartId: string }): Promise<PreflightResult> => {\n    setIsPending(true)\n    try {\n      const baseUrl = options.baseUrl ?? process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL ?? ''\n      const publishableKey = options.publishableKey ?? process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY ?? ''\n      const response = await fetch(`${baseUrl.replace(/\\/$/, '')}/store/aliexpress-dropshipping/preflight-cart`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          ...(publishableKey ? { 'x-publishable-api-key': publishableKey } : {}),\n        },\n        body: JSON.stringify({ cart_id: cartId }),\n      })\n      if (!response.ok) throw new Error(`Preflight check failed: ${response.status}`)\n      return await response.json() as PreflightResult\n    } finally {\n      setIsPending(false)\n    }\n  }, [options.baseUrl, options.publishableKey])\n\n  return { mutateAsync, isPending }\n}\n","'use client'\n\nimport { useEffect, useState } from 'react'\nimport { useAliexpressPreflight, type UseAliexpressPreflightOptions } from './use-preflight'\nimport type { PreflightResult } from '../types'\n\nexport interface AliexpressCheckoutGuardProps {\n  /**\n   * Cart id to preflight. Passed by the storefront checkout page or the plugin slot's\n   * `context.cartId`. If undefined (cart not yet loaded), the guard renders nothing.\n   */\n  cartId?: string\n  /** Optional TanStack Query hook options (e.g. custom baseUrl for tests). */\n  options?: UseAliexpressPreflightOptions\n  /** Optional callback merchant storefronts can wire to react to the block state. */\n  onBlock?: (result: PreflightResult) => void\n}\n\n/**\n * Standalone slot-compatible AliExpress preflight component.\n *\n * Rendered by the plugin registry at the `checkoutStart` slot. On mount + whenever\n * `cartId` changes, runs the pre-payment shipping/address/OAuth check. If any AE line\n * item is unfulfillable, renders an inline warning block above the checkout form.\n *\n * NOTE: this is a SOFT warning (not a hard block on the pay button). For hard blocking,\n * the merchant's checkout page should call `useAliexpressPreflight` directly and gate\n * its own `cart.complete()` on the result. See package README for both integration\n * patterns.\n *\n * Fail-open: if the preflight endpoint is unreachable, the guard renders nothing rather\n * than block checkout. Better to occasionally let through an unfulfillable order (which\n * downstream retry + refund handles) than to lock the merchant out of checkouts on a\n * transient outage.\n */\nexport function AliexpressCheckoutGuard({ cartId, options, onBlock }: AliexpressCheckoutGuardProps) {\n  const preflight = useAliexpressPreflight(options)\n  const [blockedResult, setBlockedResult] = useState<PreflightResult | null>(null)\n\n  useEffect(() => {\n    if (!cartId) return\n    let cancelled = false\n    void preflight\n      .mutateAsync({ cartId })\n      .then((result) => {\n        if (cancelled) return\n        if (!result.ok) {\n          setBlockedResult(result)\n          onBlock?.(result)\n        } else {\n          setBlockedResult(null)\n        }\n      })\n      .catch(() => {\n        // Fail-open: don't block checkout if the preflight endpoint itself is unreachable.\n        if (!cancelled) setBlockedResult(null)\n      })\n    return () => {\n      cancelled = true\n    }\n    // Intentionally re-runs only on cartId change, not on mutation reference change.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [cartId])\n\n  if (!blockedResult) return null\n\n  const itemErrors = blockedResult.itemErrors ?? []\n  const addressErrors = blockedResult.addressErrors ?? []\n  const merchantErrors = blockedResult.merchantErrors ?? []\n\n  return (\n    <div\n      role=\"alert\"\n      style={{\n        border: '1px solid #f5c2c7',\n        background: '#f8d7da',\n        color: '#842029',\n        padding: '12px 16px',\n        borderRadius: 8,\n        marginBottom: 16,\n        fontSize: 14,\n        lineHeight: 1.4,\n      }}\n    >\n      <strong style={{ display: 'block', marginBottom: 6 }}>\n        Some items in your cart can&apos;t be shipped\n      </strong>\n      <ul style={{ margin: 0, paddingLeft: 20 }}>\n        {itemErrors.map((err) => (\n          <li key={err.variantId}>\n            <strong>{err.productTitle}</strong>: {err.message}\n          </li>\n        ))}\n        {addressErrors.map((err, idx) => (\n          <li key={`addr-${idx}`}>{err.message}</li>\n        ))}\n        {merchantErrors.map((err, idx) => (\n          <li key={`merchant-${idx}`}>{err.message}</li>\n        ))}\n      </ul>\n    </div>\n  )\n}\n"],"mappings":";AAEA,SAAS,aAAa,gBAAgB;AAQ/B,SAAS,uBAAuB,UAAyC,CAAC,GAAG;AAClF,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,KAAK;AAChD,QAAM,cAAc,YAAY,OAAO,EAAE,OAAO,MAAoD;AAClG,iBAAa,IAAI;AACjB,QAAI;AACF,YAAM,UAAU,QAAQ,WAAW,QAAQ,IAAI,kCAAkC;AACjF,YAAM,iBAAiB,QAAQ,kBAAkB,QAAQ,IAAI,sCAAsC;AACnG,YAAM,WAAW,MAAM,MAAM,GAAG,QAAQ,QAAQ,OAAO,EAAE,CAAC,iDAAiD;AAAA,QACzG,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,GAAI,iBAAiB,EAAE,yBAAyB,eAAe,IAAI,CAAC;AAAA,QACtE;AAAA,QACA,MAAM,KAAK,UAAU,EAAE,SAAS,OAAO,CAAC;AAAA,MAC1C,CAAC;AACD,UAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,2BAA2B,SAAS,MAAM,EAAE;AAC9E,aAAO,MAAM,SAAS,KAAK;AAAA,IAC7B,UAAE;AACA,mBAAa,KAAK;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,QAAQ,SAAS,QAAQ,cAAc,CAAC;AAE5C,SAAO,EAAE,aAAa,UAAU;AAClC;;;AC/BA,SAAS,WAAW,YAAAA,iBAAgB;AAkF9B,cAKI,YALJ;AAjDC,SAAS,wBAAwB,EAAE,QAAQ,SAAS,QAAQ,GAAiC;AAClG,QAAM,YAAY,uBAAuB,OAAO;AAChD,QAAM,CAAC,eAAe,gBAAgB,IAAIC,UAAiC,IAAI;AAE/E,YAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,QAAI,YAAY;AAChB,SAAK,UACF,YAAY,EAAE,OAAO,CAAC,EACtB,KAAK,CAAC,WAAW;AAChB,UAAI,UAAW;AACf,UAAI,CAAC,OAAO,IAAI;AACd,yBAAiB,MAAM;AACvB,kBAAU,MAAM;AAAA,MAClB,OAAO;AACL,yBAAiB,IAAI;AAAA,MACvB;AAAA,IACF,CAAC,EACA,MAAM,MAAM;AAEX,UAAI,CAAC,UAAW,kBAAiB,IAAI;AAAA,IACvC,CAAC;AACH,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EAGF,GAAG,CAAC,MAAM,CAAC;AAEX,MAAI,CAAC,cAAe,QAAO;AAE3B,QAAM,aAAa,cAAc,cAAc,CAAC;AAChD,QAAM,gBAAgB,cAAc,iBAAiB,CAAC;AACtD,QAAM,iBAAiB,cAAc,kBAAkB,CAAC;AAExD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,MAAK;AAAA,MACL,OAAO;AAAA,QACL,QAAQ;AAAA,QACR,YAAY;AAAA,QACZ,OAAO;AAAA,QACP,SAAS;AAAA,QACT,cAAc;AAAA,QACd,cAAc;AAAA,QACd,UAAU;AAAA,QACV,YAAY;AAAA,MACd;AAAA,MAEA;AAAA,4BAAC,YAAO,OAAO,EAAE,SAAS,SAAS,cAAc,EAAE,GAAG,sDAEtD;AAAA,QACA,qBAAC,QAAG,OAAO,EAAE,QAAQ,GAAG,aAAa,GAAG,GACrC;AAAA,qBAAW,IAAI,CAAC,QACf,qBAAC,QACC;AAAA,gCAAC,YAAQ,cAAI,cAAa;AAAA,YAAS;AAAA,YAAG,IAAI;AAAA,eADnC,IAAI,SAEb,CACD;AAAA,UACA,cAAc,IAAI,CAAC,KAAK,QACvB,oBAAC,QAAwB,cAAI,WAApB,QAAQ,GAAG,EAAiB,CACtC;AAAA,UACA,eAAe,IAAI,CAAC,KAAK,QACxB,oBAAC,QAA4B,cAAI,WAAxB,YAAY,GAAG,EAAiB,CAC1C;AAAA,WACH;AAAA;AAAA;AAAA,EACF;AAEJ;","names":["useState","useState"]}

package/dist/client/index.d.mts

@@ -0,0 +1,46 @@
+import { P as PreflightResult } from '../types-CLTkhq_u.mjs';
+export { j as PreflightAddressError, k as PreflightItemError, l as PreflightMerchantError } from '../types-CLTkhq_u.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface UseAliexpressPreflightOptions {
+    baseUrl?: string;
+    publishableKey?: string;
+}
+declare function useAliexpressPreflight(options?: UseAliexpressPreflightOptions): {
+    mutateAsync: ({ cartId }: {
+        cartId: string;
+    }) => Promise<PreflightResult>;
+    isPending: boolean;
+};
+
+interface AliexpressCheckoutGuardProps {
+    /**
+     * Cart id to preflight. Passed by the storefront checkout page or the plugin slot's
+     * `context.cartId`. If undefined (cart not yet loaded), the guard renders nothing.
+     */
+    cartId?: string;
+    /** Optional TanStack Query hook options (e.g. custom baseUrl for tests). */
+    options?: UseAliexpressPreflightOptions;
+    /** Optional callback merchant storefronts can wire to react to the block state. */
+    onBlock?: (result: PreflightResult) => void;
+}
+/**
+ * Standalone slot-compatible AliExpress preflight component.
+ *
+ * Rendered by the plugin registry at the `checkoutStart` slot. On mount + whenever
+ * `cartId` changes, runs the pre-payment shipping/address/OAuth check. If any AE line
+ * item is unfulfillable, renders an inline warning block above the checkout form.
+ *
+ * NOTE: this is a SOFT warning (not a hard block on the pay button). For hard blocking,
+ * the merchant's checkout page should call `useAliexpressPreflight` directly and gate
+ * its own `cart.complete()` on the result. See package README for both integration
+ * patterns.
+ *
+ * Fail-open: if the preflight endpoint is unreachable, the guard renders nothing rather
+ * than block checkout. Better to occasionally let through an unfulfillable order (which
+ * downstream retry + refund handles) than to lock the merchant out of checkouts on a
+ * transient outage.
+ */
+declare function AliexpressCheckoutGuard({ cartId, options, onBlock }: AliexpressCheckoutGuardProps): react_jsx_runtime.JSX.Element | null;
+
+export { AliexpressCheckoutGuard, type AliexpressCheckoutGuardProps, PreflightResult, type UseAliexpressPreflightOptions, useAliexpressPreflight };

package/dist/client/index.d.ts

@@ -0,0 +1,46 @@
+import { P as PreflightResult } from '../types-CLTkhq_u.js';
+export { j as PreflightAddressError, k as PreflightItemError, l as PreflightMerchantError } from '../types-CLTkhq_u.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface UseAliexpressPreflightOptions {
+    baseUrl?: string;
+    publishableKey?: string;
+}
+declare function useAliexpressPreflight(options?: UseAliexpressPreflightOptions): {
+    mutateAsync: ({ cartId }: {
+        cartId: string;
+    }) => Promise<PreflightResult>;
+    isPending: boolean;
+};
+
+interface AliexpressCheckoutGuardProps {
+    /**
+     * Cart id to preflight. Passed by the storefront checkout page or the plugin slot's
+     * `context.cartId`. If undefined (cart not yet loaded), the guard renders nothing.
+     */
+    cartId?: string;
+    /** Optional TanStack Query hook options (e.g. custom baseUrl for tests). */
+    options?: UseAliexpressPreflightOptions;
+    /** Optional callback merchant storefronts can wire to react to the block state. */
+    onBlock?: (result: PreflightResult) => void;
+}
+/**
+ * Standalone slot-compatible AliExpress preflight component.
+ *
+ * Rendered by the plugin registry at the `checkoutStart` slot. On mount + whenever
+ * `cartId` changes, runs the pre-payment shipping/address/OAuth check. If any AE line
+ * item is unfulfillable, renders an inline warning block above the checkout form.
+ *
+ * NOTE: this is a SOFT warning (not a hard block on the pay button). For hard blocking,
+ * the merchant's checkout page should call `useAliexpressPreflight` directly and gate
+ * its own `cart.complete()` on the result. See package README for both integration
+ * patterns.
+ *
+ * Fail-open: if the preflight endpoint is unreachable, the guard renders nothing rather
+ * than block checkout. Better to occasionally let through an unfulfillable order (which
+ * downstream retry + refund handles) than to lock the merchant out of checkouts on a
+ * transient outage.
+ */
+declare function AliexpressCheckoutGuard({ cartId, options, onBlock }: AliexpressCheckoutGuardProps): react_jsx_runtime.JSX.Element | null;
+
+export { AliexpressCheckoutGuard, type AliexpressCheckoutGuardProps, PreflightResult, type UseAliexpressPreflightOptions, useAliexpressPreflight };

package/dist/client/index.js

@@ -0,0 +1,116 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  AliexpressCheckoutGuard: () => AliexpressCheckoutGuard,
+  useAliexpressPreflight: () => useAliexpressPreflight
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/client/use-preflight.ts
+var import_react = require("react");
+function useAliexpressPreflight(options = {}) {
+  const [isPending, setIsPending] = (0, import_react.useState)(false);
+  const mutateAsync = (0, import_react.useCallback)(async ({ cartId }) => {
+    setIsPending(true);
+    try {
+      const baseUrl = options.baseUrl ?? process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL ?? "";
+      const publishableKey = options.publishableKey ?? process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY ?? "";
+      const response = await fetch(`${baseUrl.replace(/\/$/, "")}/store/aliexpress-dropshipping/preflight-cart`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...publishableKey ? { "x-publishable-api-key": publishableKey } : {}
+        },
+        body: JSON.stringify({ cart_id: cartId })
+      });
+      if (!response.ok) throw new Error(`Preflight check failed: ${response.status}`);
+      return await response.json();
+    } finally {
+      setIsPending(false);
+    }
+  }, [options.baseUrl, options.publishableKey]);
+  return { mutateAsync, isPending };
+}
+
+// src/client/preflight-guard.tsx
+var import_react2 = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+function AliexpressCheckoutGuard({ cartId, options, onBlock }) {
+  const preflight = useAliexpressPreflight(options);
+  const [blockedResult, setBlockedResult] = (0, import_react2.useState)(null);
+  (0, import_react2.useEffect)(() => {
+    if (!cartId) return;
+    let cancelled = false;
+    void preflight.mutateAsync({ cartId }).then((result) => {
+      if (cancelled) return;
+      if (!result.ok) {
+        setBlockedResult(result);
+        onBlock?.(result);
+      } else {
+        setBlockedResult(null);
+      }
+    }).catch(() => {
+      if (!cancelled) setBlockedResult(null);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [cartId]);
+  if (!blockedResult) return null;
+  const itemErrors = blockedResult.itemErrors ?? [];
+  const addressErrors = blockedResult.addressErrors ?? [];
+  const merchantErrors = blockedResult.merchantErrors ?? [];
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    "div",
+    {
+      role: "alert",
+      style: {
+        border: "1px solid #f5c2c7",
+        background: "#f8d7da",
+        color: "#842029",
+        padding: "12px 16px",
+        borderRadius: 8,
+        marginBottom: 16,
+        fontSize: 14,
+        lineHeight: 1.4
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { style: { display: "block", marginBottom: 6 }, children: "Some items in your cart can't be shipped" }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("ul", { style: { margin: 0, paddingLeft: 20 }, children: [
+          itemErrors.map((err) => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("li", { children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { children: err.productTitle }),
+            ": ",
+            err.message
+          ] }, err.variantId)),
+          addressErrors.map((err, idx) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { children: err.message }, `addr-${idx}`)),
+          merchantErrors.map((err, idx) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)("li", { children: err.message }, `merchant-${idx}`))
+        ] })
+      ]
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AliexpressCheckoutGuard,
+  useAliexpressPreflight
+});
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/index.ts","../../src/client/use-preflight.ts","../../src/client/preflight-guard.tsx"],"sourcesContent":["export { useAliexpressPreflight, type UseAliexpressPreflightOptions } from './use-preflight'\nexport { AliexpressCheckoutGuard, type AliexpressCheckoutGuardProps } from './preflight-guard'\nexport type {\n  PreflightResult,\n  PreflightMerchantError,\n  PreflightAddressError,\n  PreflightItemError,\n} from '../types'\n","'use client'\n\nimport { useCallback, useState } from 'react'\nimport type { PreflightResult } from '../types'\n\nexport interface UseAliexpressPreflightOptions {\n  baseUrl?: string\n  publishableKey?: string\n}\n\nexport function useAliexpressPreflight(options: UseAliexpressPreflightOptions = {}) {\n  const [isPending, setIsPending] = useState(false)\n  const mutateAsync = useCallback(async ({ cartId }: { cartId: string }): Promise<PreflightResult> => {\n    setIsPending(true)\n    try {\n      const baseUrl = options.baseUrl ?? process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL ?? ''\n      const publishableKey = options.publishableKey ?? process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY ?? ''\n      const response = await fetch(`${baseUrl.replace(/\\/$/, '')}/store/aliexpress-dropshipping/preflight-cart`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          ...(publishableKey ? { 'x-publishable-api-key': publishableKey } : {}),\n        },\n        body: JSON.stringify({ cart_id: cartId }),\n      })\n      if (!response.ok) throw new Error(`Preflight check failed: ${response.status}`)\n      return await response.json() as PreflightResult\n    } finally {\n      setIsPending(false)\n    }\n  }, [options.baseUrl, options.publishableKey])\n\n  return { mutateAsync, isPending }\n}\n","'use client'\n\nimport { useEffect, useState } from 'react'\nimport { useAliexpressPreflight, type UseAliexpressPreflightOptions } from './use-preflight'\nimport type { PreflightResult } from '../types'\n\nexport interface AliexpressCheckoutGuardProps {\n  /**\n   * Cart id to preflight. Passed by the storefront checkout page or the plugin slot's\n   * `context.cartId`. If undefined (cart not yet loaded), the guard renders nothing.\n   */\n  cartId?: string\n  /** Optional TanStack Query hook options (e.g. custom baseUrl for tests). */\n  options?: UseAliexpressPreflightOptions\n  /** Optional callback merchant storefronts can wire to react to the block state. */\n  onBlock?: (result: PreflightResult) => void\n}\n\n/**\n * Standalone slot-compatible AliExpress preflight component.\n *\n * Rendered by the plugin registry at the `checkoutStart` slot. On mount + whenever\n * `cartId` changes, runs the pre-payment shipping/address/OAuth check. If any AE line\n * item is unfulfillable, renders an inline warning block above the checkout form.\n *\n * NOTE: this is a SOFT warning (not a hard block on the pay button). For hard blocking,\n * the merchant's checkout page should call `useAliexpressPreflight` directly and gate\n * its own `cart.complete()` on the result. See package README for both integration\n * patterns.\n *\n * Fail-open: if the preflight endpoint is unreachable, the guard renders nothing rather\n * than block checkout. Better to occasionally let through an unfulfillable order (which\n * downstream retry + refund handles) than to lock the merchant out of checkouts on a\n * transient outage.\n */\nexport function AliexpressCheckoutGuard({ cartId, options, onBlock }: AliexpressCheckoutGuardProps) {\n  const preflight = useAliexpressPreflight(options)\n  const [blockedResult, setBlockedResult] = useState<PreflightResult | null>(null)\n\n  useEffect(() => {\n    if (!cartId) return\n    let cancelled = false\n    void preflight\n      .mutateAsync({ cartId })\n      .then((result) => {\n        if (cancelled) return\n        if (!result.ok) {\n          setBlockedResult(result)\n          onBlock?.(result)\n        } else {\n          setBlockedResult(null)\n        }\n      })\n      .catch(() => {\n        // Fail-open: don't block checkout if the preflight endpoint itself is unreachable.\n        if (!cancelled) setBlockedResult(null)\n      })\n    return () => {\n      cancelled = true\n    }\n    // Intentionally re-runs only on cartId change, not on mutation reference change.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [cartId])\n\n  if (!blockedResult) return null\n\n  const itemErrors = blockedResult.itemErrors ?? []\n  const addressErrors = blockedResult.addressErrors ?? []\n  const merchantErrors = blockedResult.merchantErrors ?? []\n\n  return (\n    <div\n      role=\"alert\"\n      style={{\n        border: '1px solid #f5c2c7',\n        background: '#f8d7da',\n        color: '#842029',\n        padding: '12px 16px',\n        borderRadius: 8,\n        marginBottom: 16,\n        fontSize: 14,\n        lineHeight: 1.4,\n      }}\n    >\n      <strong style={{ display: 'block', marginBottom: 6 }}>\n        Some items in your cart can&apos;t be shipped\n      </strong>\n      <ul style={{ margin: 0, paddingLeft: 20 }}>\n        {itemErrors.map((err) => (\n          <li key={err.variantId}>\n            <strong>{err.productTitle}</strong>: {err.message}\n          </li>\n        ))}\n        {addressErrors.map((err, idx) => (\n          <li key={`addr-${idx}`}>{err.message}</li>\n        ))}\n        {merchantErrors.map((err, idx) => (\n          <li key={`merchant-${idx}`}>{err.message}</li>\n        ))}\n      </ul>\n    </div>\n  )\n}\n"],"mappings":"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","names":["import_react"]}

package/dist/client/index.mjs

@@ -0,0 +1,9 @@
+import {
+  AliexpressCheckoutGuard,
+  useAliexpressPreflight
+} from "../chunk-FPBGH4MH.mjs";
+export {
+  AliexpressCheckoutGuard,
+  useAliexpressPreflight
+};
+//# sourceMappingURL=index.mjs.map

package/dist/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.mts

@@ -1,171 +1,5 @@
-import * as React from 'react';
-
-/**
- * Public types for @amboras-dev/aliexpress-dropshipping.
- *
- * These are the single source of truth for the wire shape between the
- * Amboras admin settings form and the medusa-backend-orchestrator
- * Store API routes under `/store/aliexpress-dropshipping/*`. The DTO
- * files on the medusa side must stay byte-compatible with these.
- */
-/**
- * Sentinel returned in place of a stored secret when the settings form
- * reads back current config. Matches the pattern used by meta-ads and
- * pinterest so the admin never sees the plaintext secret after write.
- */
-declare const SECRET_SET_SENTINEL: "__SECRET_SET__";
-type SecretSetSentinel = typeof SECRET_SET_SENTINEL;
-/**
- * Per-store AliExpress plugin configuration.
- *
- * - `appKey` / `appSecret` are per-store developer app credentials
- *   supplied by the merchant. The admin form receives
- *   `SECRET_SET_SENTINEL` for `appSecret` on read, and only sends a
- *   real value on user edit.
- * - `connectedSellerId` is populated after the merchant completes the
- *   OAuth flow to `/rest/auth/token/create`.
- * - `needsReauth` is flipped by the backend runtime detector when it
- *   sees `MissingParameter access_token` or `IllegalAccessToken`
- *   sub-codes on any envelope.
- * - `lastSuccessfulCallAt` is an ISO-8601 timestamp for the status card.
- */
-interface AliExpressPluginConfig {
-    enabled: boolean;
-    appKey: string | null;
-    appSecret: string | SecretSetSentinel | null;
-    connectedSellerId: string | null;
-    needsReauth: boolean;
-    lastSuccessfulCallAt: string | null;
-}
-/**
- * Reasons the backend surfaces when a merchant token becomes invalid.
- * Kept narrow so the admin banner can render a specific message.
- */
-declare enum AliExpressReauthReason {
-    MissingAccessToken = "missing_access_token",
-    IllegalAccessToken = "illegal_access_token",
-    RefreshFailed = "refresh_failed",
-    Disconnected = "disconnected"
-}
-/**
- * Category node returned by `aliexpress.ds.category.get`. The API
- * returns a flat list; the admin renders it as a tree by walking
- * `parentCategoryId`.
- */
-interface AliExpressCategoryDto {
-    categoryId: string;
-    categoryName: string;
-    parentCategoryId: string | null;
-}
-/**
- * Product summary shape returned by `aliexpress.ds.recommend.feed.get`.
- * Used by the "browse products" admin surface.
- */
-interface AliExpressProductSummaryDto {
-    productId: string;
-    title: string;
-    imageUrl: string | null;
-    minPrice: number | null;
-    maxPrice: number | null;
-    currency: string | null;
-    productDetailUrl: string | null;
-}
-/**
- * Full product shape returned by `aliexpress.ds.product.get`. Consumed
- * by the medusa-side mapper `aliexpressProductToMedusaDraft`.
- */
-interface AliExpressProductDto {
-    productId: string;
-    title: string;
-    description: string | null;
-    images: string[];
-    variants: AliExpressProductVariantDto[];
-    weightGrams: number | null;
-    sourceUrl: string | null;
-}
-interface AliExpressProductVariantDto {
-    skuId: string;
-    title: string | null;
-    price: number;
-    currency: string;
-    stock: number | null;
-    attributes: Record<string, string>;
-}
-/**
- * Return shape from `POST /store/aliexpress-dropshipping/products/:id/import`.
- */
-interface AliExpressImportResultDto {
-    medusaProductId: string;
-    sourceProductId: string;
-    importedVariants: number;
-}
-/**
- * Return shape from `GET /store/aliexpress-dropshipping/status` - drives
- * the admin status card.
- */
-interface AliExpressConnectionStatusDto {
-    connected: boolean;
-    sellerId: string | null;
-    needsReauth: boolean;
-    reauthReason: AliExpressReauthReason | null;
-    lastSuccessfulCallAt: string | null;
-}
-/**
- * Return shape from `POST /store/aliexpress-dropshipping/test-connection`.
- */
-type AliExpressTestConnectionResult = {
-    ok: true;
-    categoryCount: number;
-} | {
-    ok: false;
-    code: string;
-    msg: string;
-};
-
-/**
- * Admin settings form for the AliExpress Dropshipping integration.
- *
- * Class B: this component owns the UI and talks to the Medusa Store API
- * under `/store/aliexpress-dropshipping/*`. It does NOT embed any
- * AliExpress SDK, does not sign requests, and does not touch OAuth
- * tokens directly - the backend does all of that.
- *
- * The component is intentionally dependency-light (no external UI kit,
- * no @tanstack/react-query peer) so the admin bundle can drop it in
- * without extra peer dep resolution.
- */
-
-interface AliExpressDropshippingSettingsFormProps {
-    /** Current config for this store (fetched by the parent server component). */
-    initialConfig: AliExpressPluginConfig;
-    /** Current connection status (from `GET /status`). */
-    initialStatus: AliExpressConnectionStatusDto;
-    /**
-     * Persist non-secret + optionally new secret values. The parent maps
-     * this onto `PATCH /store/aliexpress-dropshipping/config` (or
-     * equivalent) and then re-fetches config on success.
-     *
-     * `appSecret` is only sent when the merchant actually typed a new
-     * value; if they leave the field untouched, this method receives
-     * `undefined` for that key so the backend keeps the existing secret.
-     */
-    onSaveConfig: (patch: {
-        appKey?: string;
-        appSecret?: string;
-        enabled?: boolean;
-    }) => Promise<void>;
-    /** Kick off `POST /oauth/start` and redirect to the returned URL. */
-    onConnect: () => Promise<void>;
-    /** Kick off `POST /oauth/disconnect` and clear merchant credentials. */
-    onDisconnect: () => Promise<void>;
-    /** Call `POST /test-connection` and return the result. */
-    onTestConnection: () => Promise<AliExpressTestConnectionResult>;
-}
-/**
- * Amboras admin settings surface for AliExpress Dropshipping.
- * Renders AppKey + AppSecret inputs, Test / Connect / Disconnect
- * buttons, status card, and a "Coming soon" order-forwarding block.
- */
-declare function AliExpressDropshippingSettingsForm(props: AliExpressDropshippingSettingsFormProps): React.ReactElement;
-
-export { type AliExpressCategoryDto, type AliExpressConnectionStatusDto, AliExpressDropshippingSettingsForm, type AliExpressDropshippingSettingsFormProps, type AliExpressImportResultDto, type AliExpressPluginConfig, type AliExpressProductDto, type AliExpressProductSummaryDto, type AliExpressProductVariantDto, AliExpressReauthReason, type AliExpressTestConnectionResult, SECRET_SET_SENTINEL, type SecretSetSentinel };
+export { AliExpressDropshippingSettingsForm, AliExpressDropshippingSettingsFormProps } from './admin/index.mjs';
+export { A as AliExpressCategoryDto, a as AliExpressConnectionStatusDto, b as AliExpressImportResultDto, c as AliExpressPluginConfig, d as AliExpressProductDto, e as AliExpressProductSummaryDto, f as AliExpressProductVariantDto, g as AliExpressReauthReason, h as AliExpressTestConnectionResult, S as SECRET_SET_SENTINEL, i as SecretSetSentinel } from './types-CLTkhq_u.mjs';
+export { AliexpressCheckoutGuard, AliexpressCheckoutGuardProps, UseAliexpressPreflightOptions, useAliexpressPreflight } from './client/index.mjs';
+import 'react';
+import 'react/jsx-runtime';