@amboras-dev/aliexpress-dropshipping 1.1.0 → 1.2.0

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.0",
+  "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",