@spree/dashboard-core 6.0.3 → 6.0.4

package/src/lib/fulfillment-items.test.ts

@@ -4,6 +4,7 @@ import {
   fulfillmentItemRows,
   type GroupableFulfillment,
   type GroupableLineItem,
+  postSaleItemRow,
   unfulfilledItemRows,
 } from './fulfillment-items'
 
@@ -16,6 +17,7 @@ function lineItem(overrides: Partial<GroupableLineItem> = {}): GroupableLineItem
     thumbnail_url: 'https://example.test/shirt.jpg',
     price: '10.00',
     currency: 'USD',
+    product_id: 'prod_1',
     ...overrides,
   }
 }
@@ -45,6 +47,7 @@ describe('fulfillmentItemRows', () => {
         optionsText: 'Blue / M',
         thumbnailUrl: 'https://example.test/shirt.jpg',
         displayPrice: '$10.00',
+        productId: 'prod_1',
         quantity: 1,
       },
     ])
@@ -107,6 +110,7 @@ describe('fulfillmentItemRows', () => {
         optionsText: 'White',
         thumbnailUrl: null,
         displayPrice: null,
+        productId: null,
         quantity: 1,
       },
     ])
@@ -241,3 +245,50 @@ describe('fulfilledQuantities', () => {
     expect(quantities.size).toBe(0)
   })
 })
+
+describe('postSaleItemRow', () => {
+  it('takes the name, image, price and product from the order line it came from', () => {
+    const row = postSaleItemRow(
+      'rli_1',
+      { line_item_id: 'li_1', variant_id: 'variant_1', quantity: 1 },
+      [lineItem({ variant_id: 'variant_1' })],
+    )
+
+    expect(row).toMatchObject({
+      key: 'rli_1',
+      name: 'Shirt',
+      optionsText: 'Blue / M',
+      thumbnailUrl: 'https://example.test/shirt.jpg',
+      displayPrice: '$10.00',
+      productId: 'prod_1',
+      quantity: 1,
+    })
+  })
+
+  it('falls back to the variant it names when the order line is gone', () => {
+    const row = postSaleItemRow(
+      'rli_1',
+      {
+        line_item_id: 'li_gone',
+        variant_id: 'variant_1',
+        variant: {
+          product_name: 'Mug',
+          options_text: 'Red',
+          thumbnail_url: 'https://example.test/mug.jpg',
+          product_id: 'prod_2',
+        },
+        quantity: 2,
+      },
+      [lineItem()],
+    )
+
+    expect(row).toMatchObject({
+      name: 'Mug',
+      optionsText: 'Red',
+      thumbnailUrl: 'https://example.test/mug.jpg',
+      displayPrice: null,
+      productId: 'prod_2',
+      quantity: 2,
+    })
+  })
+})

package/src/lib/fulfillment-items.ts

@@ -20,6 +20,7 @@ export interface GroupableLineItem {
   thumbnail_url?: string | null
   price?: string | null
   currency?: string | null
+  product_id?: string | null
 }
 
 /** The fulfillment-item fields the grouping reads. */
@@ -53,6 +54,8 @@ export interface FulfillmentItemRow {
   optionsText: string | null
   thumbnailUrl: string | null
   displayPrice: string | null
+  /** The product to link the row to, when the line still names one. */
+  productId: string | null
   quantity: number
 }
 
@@ -144,6 +147,7 @@ function buildRow(
     name: copy?.name ?? fallback?.name ?? '',
     optionsText: copy?.options_text ?? fallback?.options_text ?? null,
     thumbnailUrl: copy?.thumbnail_url ?? null,
+    productId: copy?.product_id ?? null,
     displayPrice:
       copy?.price && copy.currency
         ? formatMoney(copy.price, copy.currency, i18n.language || 'en', { unitPrice: true })
@@ -186,6 +190,55 @@ export function fulfillmentItemRows(
   return [...rows.values()]
 }
 
+/** A return, claim or exchange line, as the item row reads it. */
+export interface PostSaleLine {
+  line_item_id?: string | null
+  variant_id?: string | null
+  /** The line's own copy of the product name, where the panel's API sends one. */
+  name?: string | null
+  variant?: {
+    product_name?: string | null
+    options_text?: string | null
+    thumbnail_url?: string | null
+    sku?: string | null
+    product_id?: string | null
+  } | null
+  quantity: number
+}
+
+/**
+ * A return, claim or exchange line as the same row a fulfillment shows: the
+ * order line it came from gives the name, image and price; the variant it
+ * names fills in when the order line is gone.
+ */
+export function postSaleItemRow(
+  key: string,
+  line: PostSaleLine,
+  lineItems: GroupableLineItem[],
+): FulfillmentItemRow {
+  const lineItem = line.line_item_id
+    ? lineItems.find((item) => item.id === line.line_item_id)
+    : undefined
+  const variant = line.variant
+  const row = buildRow(
+    key,
+    lineItem,
+    {
+      variant_id: line.variant_id,
+      name: line.name ?? variant?.product_name ?? null,
+      options_text: variant?.options_text ?? null,
+    },
+    line.quantity,
+  )
+
+  return {
+    ...row,
+    name: row.name || variant?.sku || line.variant_id || '',
+    thumbnailUrl: row.thumbnailUrl ?? variant?.thumbnail_url ?? null,
+    productId: row.productId ?? variant?.product_id ?? null,
+  }
+}
+
 /**
  * Line-item units no fulfillment has claimed: the ordered quantity minus what
  * every fulfillment holds. Only positive remainders are returned, so an order

package/src/lib/request-snippets.ts

@@ -0,0 +1,41 @@
+import { buildCurlCommand } from './curl'
+import { type DeveloperInspectorEntry, SENSITIVE_HEADERS } from './developer-inspector'
+
+const ADMIN_API_PREFIX = '/api/v3/admin'
+// Credentials are replaced by the placeholder; a replayed idempotency key
+// would return the cached response instead of running the request again.
+const OMITTED_HEADERS = new Set([...SENSITIVE_HEADERS, 'idempotency-key'])
+
+function isSendableBody(body: unknown): boolean {
+  return body !== undefined && body !== null && typeof body !== 'string'
+}
+
+/** A curl command replaying the request, with a placeholder for the token. */
+export function entryToCurl(entry: DeveloperInspectorEntry): string {
+  const headers = Object.fromEntries(
+    Object.entries(entry.requestHeaders).filter(
+      ([name]) => !OMITTED_HEADERS.has(name.toLowerCase()),
+    ),
+  )
+  return buildCurlCommand(entry.url, headers, {
+    method: entry.method,
+    body: isSendableBody(entry.requestBody) ? entry.requestBody : undefined,
+  })
+}
+
+/**
+ * The same request through `@spree/admin-sdk`. Uses the low-level
+ * `adminClient.request`, which always matches the wire call; the resource
+ * method names would be a guess.
+ */
+export function entryToSdkCall(entry: DeveloperInspectorEntry): string {
+  const path = entry.path.startsWith(ADMIN_API_PREFIX)
+    ? entry.path.slice(ADMIN_API_PREFIX.length)
+    : entry.path
+  const options: Record<string, unknown> = {}
+  if (entry.query && Object.keys(entry.query).length > 0) options.params = entry.query
+  if (isSendableBody(entry.requestBody)) options.body = entry.requestBody
+  const args = [JSON.stringify(entry.method), JSON.stringify(path)]
+  if (Object.keys(options).length > 0) args.push(JSON.stringify(options, null, 2))
+  return `await adminClient.request(${args.join(', ')})`
+}

package/src/lib/table-registry.ts

@@ -178,6 +178,10 @@ export interface TableDef<T = any> {
   columns: ColumnDef<T>[]
   searchParam?: string
   searchPlaceholder?: string
+  /**
+   * Whether the toolbar offers a free-text search. On by default.
+   */
+  searchable?: boolean
   defaultSort?: SortOption
   emptyIcon?: ReactNode
   emptyMessage?: string
@@ -262,18 +266,21 @@ export const tables = new Proxy({} as Record<string, TableMutator>, {
 })
 
 interface TableMutator {
-  addColumn<T = any>(column: ColumnDef<T>): void
+  /** `after` places the column right after that one, instead of last. */
+  addColumn<T = any>(column: ColumnDef<T>, options?: { after?: string }): void
   removeColumn(key: string): void
   updateColumn<T = any>(key: string, updates: Partial<ColumnDef<T>>): void
 }
 
-function applyAddColumn(table: TableDef, column: ColumnDef) {
+function applyAddColumn(table: TableDef, column: ColumnDef, after?: string) {
   if (table.columns.some((c) => c.key === column.key)) {
     throw new Error(
       `Column "${column.key}" already exists in table "${table.key}". Use updateColumn() instead.`,
     )
   }
-  table.columns.push(column)
+  const index = after ? table.columns.findIndex((c) => c.key === after) : -1
+  if (index === -1) table.columns.push(column)
+  else table.columns.splice(index + 1, 0, column)
 }
 
 function applyRemoveColumn(table: TableDef, key: string) {
@@ -288,10 +295,10 @@ function applyUpdateColumn(table: TableDef, key: string, updates: Partial<Column
 
 function createMutator(tableKey: string): TableMutator {
   return {
-    addColumn(column) {
+    addColumn(column, options) {
       const table = registry.get(tableKey)
-      if (table) applyAddColumn(table, column as ColumnDef)
-      else enqueue(tableKey, (t) => applyAddColumn(t, column as ColumnDef))
+      if (table) applyAddColumn(table, column as ColumnDef, options?.after)
+      else enqueue(tableKey, (t) => applyAddColumn(t, column as ColumnDef, options?.after))
     },
     removeColumn(key) {
       const table = registry.get(tableKey)

package/src/lib/timestamp-columns.tsx

@@ -6,7 +6,7 @@ const TIMESTAMP_KEYS = ['created_at', 'updated_at'] as const
 
 type TimestampKey = (typeof TIMESTAMP_KEYS)[number]
 
-const TIMESTAMP_CLASS = 'text-sm text-muted-foreground whitespace-nowrap'
+const TIMESTAMP_CLASS = 'text-base text-muted-foreground whitespace-nowrap'
 
 function createTimestampColumn(key: TimestampKey, visibleByDefault = false): ColumnDef {
   return {

package/src/locales/ar.json

@@ -37,7 +37,6 @@
     },
     "account": {
       "community": "المجتمع",
-      "contact_support": "الاتصال بالدعم",
       "documentation": "التوثيق",
       "edit_profile": "تعديل الملف الشخصي",
       "language": {
@@ -45,8 +44,8 @@
         "update_failed": "تعذّر حفظ تفضيل اللغة. يرجى المحاولة مجددًا."
       },
       "log_out": "تسجيل الخروج",
-      "preferences": "التفضيلات",
-      "view_store": "عرض المتجر"
+      "report_issue": "الإبلاغ عن مشكلة",
+      "send_feedback": "إرسال ملاحظات"
     },
     "actions": {
       "actions_menu": "الإجراءات",
@@ -102,7 +101,11 @@
       "default_shipping": "الشحن الافتراضي",
       "inherited_from": "موروث من {{name}}",
       "set_default_billing": "تعيين كعنوان فوترة افتراضي",
-      "set_default_shipping": "تعيين كعنوان شحن افتراضي"
+      "set_default_shipping": "تعيين كعنوان شحن افتراضي",
+      "columns": {
+        "address": "العنوان",
+        "defaults": "افتراضي لـ"
+      }
     },
     "auth": {
       "back_to_login": "العودة إلى تسجيل الدخول",
@@ -190,7 +193,8 @@
       "unsaved_changes": "لديك تغييرات غير محفوظة.",
       "yes": "نعم",
       "done": "تم",
-      "error": "حدث خطأ ما."
+      "error": "حدث خطأ ما.",
+      "unsaved_label": "تغييرات غير محفوظة"
     },
     "components": {
       "address_block": {
@@ -321,7 +325,8 @@
         "drop_label": "أسقط ملفًا هنا، أو انقر للاستعراض",
         "invalid_type": "نوع الملف هذا غير مقبول (المتوقع: {{accept}})",
         "upload_failed": "فشل الرفع: {{message}}",
-        "uploading": "جارٍ الرفع…"
+        "uploading": "جارٍ الرفع…",
+        "replace": "استبدال الملف"
       },
       "import_button": {
         "delimiter_label": "فاصل الأعمدة",
@@ -342,7 +347,8 @@
       "json_preview_drawer": {
         "collapse_depth": "عمق الطي",
         "copied": "تم النسخ",
-        "copy_all": "نسخ الكل",
+        "copy_curl": "نسخ كـ curl",
+        "copy_json": "نسخ JSON",
         "depth": "العمق {{level}}",
         "failed_to_load": "فشل التحميل: {{message}}",
         "open_raw": "فتح الاستجابة الخام",
@@ -437,11 +443,8 @@
           "this_month": "هذا الشهر",
           "today": "اليوم"
         },
-        "date_range_end": "إلى",
-        "date_range_start": "من",
         "descending": "تنازلي",
         "filter_by": "تصفية حسب…",
-        "filter_date_placeholder": "اختر تاريخًا",
         "filter_select_placeholder": "اختر…",
         "filter_text_placeholder": "تصفية…",
         "filter_to_placeholder": "التصفية إلى…",
@@ -475,7 +478,10 @@
         "select_all": "تحديد الكل",
         "sort_by": "ترتيب حسب",
         "sort_tooltip": "ترتيب",
-        "visible_columns": "الأعمدة المرئية"
+        "visible_columns": "الأعمدة المرئية",
+        "row_density": "كثافة الصفوف",
+        "density_comfortable": "مريحة",
+        "density_compact": "مضغوطة"
       },
       "tag_combobox": {
         "create_option": "إنشاء «{{tag}}»",
@@ -488,6 +494,11 @@
         "light": "فاتح",
         "system": "النظام"
       },
+      "timezone_combobox": {
+        "empty": "لم يتم العثور على مناطق زمنية",
+        "placeholder": "اختر منطقة زمنية",
+        "search_placeholder": "ابحث عن المناطق الزمنية…"
+      },
       "wizard": {
         "discard_cancel": "متابعة التحرير",
         "discard_confirm": "تجاهل",
@@ -501,6 +512,40 @@
         "in_stock_short": "في المخزون",
         "variants_one": "{{count}} البديل",
         "variants_other": "{{count}} متغيرات"
+      },
+      "developer_inspector": {
+        "title": "أدوات المطوّر",
+        "description": "طلبات Admin API من علامة التبويب هذه، محفوظة في الذاكرة فقط. الرموز وكلمات المرور مخفية.",
+        "system_info": "معلومات النظام",
+        "clear": "مسح",
+        "tabs": {
+          "requests": "الطلبات",
+          "errors": "الأخطاء"
+        },
+        "empty_requests": "لا توجد طلبات بعد. استخدم لوحة التحكم وستظهر هنا.",
+        "empty_errors": "لا توجد طلبات فاشلة.",
+        "select_request": "اختر طلبًا لعرض تفاصيله.",
+        "network_error": "خطأ في الشبكة",
+        "status": "الحالة",
+        "duration": "المدة",
+        "duration_ms": "{{value}} مللي ثانية",
+        "request_id": "معرّف الطلب",
+        "error_code": "رمز الخطأ",
+        "query": "معلمات الاستعلام",
+        "request_body": "نص الطلب",
+        "response_body": "نص الاستجابة",
+        "no_body": "لا يوجد نص",
+        "copy_curl": "نسخ كأمر curl",
+        "copy_sdk": "نسخ كاستدعاء SDK",
+        "copy_response": "نسخ الاستجابة",
+        "copy_request_id": "نسخ معرّف الطلب",
+        "copied": "تم النسخ",
+        "menu_open": "أدوات المطوّر"
+      },
+      "server_error": {
+        "title": "حدث خطأ في الخادم",
+        "request_id": "الطلب {{id}}",
+        "report": "إبلاغ"
       }
     },
     "currency_amounts": {
@@ -971,6 +1016,24 @@
         "digital_asset_authorized_days": {
           "label": "الأيام المتاحة"
         }
+      },
+      "seller": {
+        "about": {
+          "label": "نبذة",
+          "help": "تظهر في ملف البائع بالمتجر."
+        },
+        "holiday_mode_until": {
+          "label": "غائب حتى",
+          "placeholder": "اختر تاريخاً",
+          "help": "يبقى الكتالوج ظاهراً لكن لا يمكن الشراء حتى ذلك الحين."
+        },
+        "contact_email": {
+          "help": "تصل إليه الدعوات وإشعارات السوق."
+        },
+        "billing_email": {
+          "label": "بريد الفوترة",
+          "help": "تصل إليه فواتير العمولة وإشعارات الدفع إن اختلف."
+        }
       }
     },
     "image_upload": {
@@ -1075,15 +1138,35 @@
       "signed_in_as_invitee": ". أنت مسجّل الدخول باسم {{email}}."
     },
     "media_picker": {
+      "any": "الكل",
       "confirm": "إضافة المحدد",
       "description": "اختر ملفات موجودة في مكتبتك، أو ارفع ملفات جديدة.",
+      "drop_hint_images": "أو اسحب الصور وأفلتها هنا",
+      "drop_hint_media": "أو اسحب الصور والفيديوهات وأفلتها هنا",
       "empty": "مكتبتك فارغة. ارفع ملفًا للبدء.",
+      "filter_type": "النوع",
+      "filter_usage": "الاستخدام",
       "no_results": "لا توجد ملفات تطابق بحثك.",
       "search_placeholder": "البحث بالاسم…",
       "selected_count_one": "تم تحديد {{count}}",
       "selected_count_other": "تم تحديد {{count}}",
+      "sort_date_added": "تاريخ الإضافة",
+      "sort_file_name": "اسم الملف",
+      "sort_file_size": "حجم الملف",
       "title": "مكتبة الوسائط",
-      "upload": "رفع"
+      "type_image": "الصور",
+      "type_video": "الفيديوهات",
+      "upload": "رفع",
+      "usage_unused": "غير مستخدم",
+      "usage_used": "مستخدم",
+      "view": "العرض",
+      "view_grid": "عرض شبكي",
+      "view_list": "عرض قائمة"
+    },
+    "media_editor": {
+      "information": "المعلومات",
+      "details": "التفاصيل",
+      "added": "أُضيف في {{date}}"
     },
     "messages": {
       "address_removed": "تمت إزالة العنوان",
@@ -1576,12 +1659,18 @@
         "add_video_title": "إضافة رابط فيديو",
         "assigned_variants_help": "اختر المتغيرات التي تمثلها هذه الصورة. اتركه فارغًا ليتم تطبيقه على كافة المتغيرات.",
         "assigned_variants_label": "المتغيرات المخصصة",
-        "delete_confirm": "هل تريد حذف هذه الوسائط؟ لا يمكن التراجع عن هذا.",
+        "delete_confirm": "إزالة هذه الوسائط؟ ستُحذف عند حفظ المنتج.",
+        "delete_selected_confirm_one": "إزالة الوسائط المحددة؟ ستُحذف عند حفظ المنتج.",
+        "delete_selected_confirm_other": "إزالة الوسائط المحددة ({{count}})؟ ستُحذف عند حفظ المنتج.",
         "drop_hint": "قم بسحب وإفلات الوسائط هنا، أو انقر للتصفح",
         "edit_title": "تحرير الوسائط",
         "file_types_hint": "صور (PNG، JPG، WebP) وفيديو (MP4، WebM، MOV)",
         "focal_point_help": "انقر على الصورة لتحديد الجزء الذي يبقى ظاهراً عند الاقتصاص.",
         "focal_point_reset": "إعادة تعيين",
+        "select_all": "تحديد كل الوسائط",
+        "select_item": "تحديد {{name}}",
+        "selected_count_one": "تم تحديد {{count}}",
+        "selected_count_other": "تم تحديد {{count}}",
         "unsupported_file": "لم تتم إضافة {{count}} ملف — الصور والفيديو فقط مدعومة.",
         "upload_failed": "فشل تحميل {{name}}: {{message}}",
         "upload_status_failed": "فشل",
@@ -1691,6 +1780,10 @@
           "failed_to_create_option_type": "فشل إنشاء نوع الخيار",
           "failed_to_create_value": "فشل إنشاء القيمة"
         },
+        "images_aria": "صور {{name}}",
+        "images_description": "حدد صور المنتج التي تعرض هذا المتغير. تظهر بترتيب بطاقة الوسائط، وتصبح أول صورة محددة صورته المصغرة — اسحب الصور في بطاقة الوسائط لتغييرها.",
+        "images_title": "صور {{name}}",
+        "images_unsaved": "احفظ المنتج لإضافة صور إلى هذا المتغير",
         "keep": "احتفظ بالكل",
         "option_type_label": "نوع الخيار",
         "option_type_placeholder": "اختر نوع الخيار",
@@ -1712,6 +1805,7 @@
           "carton_placeholder": "بدون كرتونة",
           "pending_save": "تُحفظ التغييرات هنا مع المنتج."
         },
+        "thumbnail_badge": "الصورة المصغرة",
         "title": "المتغيرات",
         "variant_label": "البديل"
       }
@@ -1800,7 +1894,8 @@
       "value_count_other": "{{count}} قيم"
     },
     "media_library": {
-      "download": "تنزيل"
+      "download": "تنزيل",
+      "choose_from_library": "اختر من المكتبة"
     },
     "catalogs": {
       "terms": {
@@ -2128,6 +2223,17 @@
       "replace": "استبدال الملف",
       "replace_description": "سيُحذف \"{{name}}\" وسيحمّل كل من اشتراه الملف الجديد من روابطه الحالية. يسري فورًا.",
       "replace_title": "استبدال هذا الملف؟"
+    },
+    "sellers": {
+      "images": {
+        "cover_photo_label": "صورة الغلاف",
+        "cover_photo_help": "لافتة عريضة أعلى ملف البائع.",
+        "logo_label": "الشعار",
+        "logo_help": "يُفضَّل الشكل المربّع. يظهر بجوار البائع في كل مكان يرد فيه.",
+        "square_logo_label": "شعار مربّع",
+        "square_logo_help": "للمواضع التي تتطلب مربّعاً دقيقاً، مثل الصورة الرمزية."
+      },
+      "not_provided": "غير محدد"
     }
   }
 }