@amboras-dev/aliexpress-dropshipping 1.1.0 → 1.2.2

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/settings-form.tsx","../src/types.ts"],"sourcesContent":["/**\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","/**\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"],"mappings":"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","names":["AliExpressReauthReason"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types-CLTkhq_u.d.mts

@@ -0,0 +1,151 @@
+/**
+ * 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;
+};
+interface PreflightMerchantError {
+    code: string;
+    message: string;
+}
+interface PreflightAddressError {
+    code: string;
+    message: string;
+    field: string;
+}
+interface PreflightItemError {
+    variantId: string;
+    productTitle: string;
+    code: 'CORRUPT_METADATA' | 'PRODUCT_OFFLINE' | 'OUT_OF_STOCK' | 'CANNOT_SHIP' | 'PRICE_DRIFT';
+    message: string;
+    removable: boolean;
+}
+interface PreflightResult {
+    ok: boolean;
+    merchantErrors: PreflightMerchantError[];
+    addressErrors: PreflightAddressError[];
+    itemErrors: PreflightItemError[];
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+    degraded?: boolean;
+    warning?: string;
+}
+
+export { type AliExpressCategoryDto as A, type PreflightResult as P, SECRET_SET_SENTINEL as S, type AliExpressConnectionStatusDto as a, type AliExpressImportResultDto as b, type AliExpressPluginConfig as c, type AliExpressProductDto as d, type AliExpressProductSummaryDto as e, type AliExpressProductVariantDto as f, AliExpressReauthReason as g, type AliExpressTestConnectionResult as h, type SecretSetSentinel as i, type PreflightAddressError as j, type PreflightItemError as k, type PreflightMerchantError as l };

package/dist/types-CLTkhq_u.d.ts

@@ -0,0 +1,151 @@
+/**
+ * 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;
+};
+interface PreflightMerchantError {
+    code: string;
+    message: string;
+}
+interface PreflightAddressError {
+    code: string;
+    message: string;
+    field: string;
+}
+interface PreflightItemError {
+    variantId: string;
+    productTitle: string;
+    code: 'CORRUPT_METADATA' | 'PRODUCT_OFFLINE' | 'OUT_OF_STOCK' | 'CANNOT_SHIP' | 'PRICE_DRIFT';
+    message: string;
+    removable: boolean;
+}
+interface PreflightResult {
+    ok: boolean;
+    merchantErrors: PreflightMerchantError[];
+    addressErrors: PreflightAddressError[];
+    itemErrors: PreflightItemError[];
+    warnings: Array<{
+        code: string;
+        message: string;
+    }>;
+    degraded?: boolean;
+    warning?: string;
+}
+
+export { type AliExpressCategoryDto as A, type PreflightResult as P, SECRET_SET_SENTINEL as S, type AliExpressConnectionStatusDto as a, type AliExpressImportResultDto as b, type AliExpressPluginConfig as c, type AliExpressProductDto as d, type AliExpressProductSummaryDto as e, type AliExpressProductVariantDto as f, AliExpressReauthReason as g, type AliExpressTestConnectionResult as h, type SecretSetSentinel as i, type PreflightAddressError as j, type PreflightItemError as k, type PreflightMerchantError as l };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@amboras-dev/aliexpress-dropshipping",
-  "version": "1.1.0",
-  "description": "AliExpress Dropshipping integration shell for Amboras - shared types + admin settings form",
+  "version": "1.2.2",
+  "description": "AliExpress Dropshipping integration for Amboras - storefront preflight and admin settings",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -11,6 +11,16 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
     },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.mjs",
+      "require": "./dist/client/index.js"
+    },
+    "./admin": {
+      "types": "./dist/admin/index.d.ts",
+      "import": "./dist/admin/index.mjs",
+      "require": "./dist/admin/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -20,7 +30,6 @@
     "react": ">=18",
     "next": ">=15"
   },
-  "dependencies": {},
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@types/react": "^19.0.0",