@endora-commerce/contracts 0.110.0 → 0.111.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (347) hide show
  1. package/dist/accept-language.d.ts +31 -0
  2. package/dist/accept-language.js +64 -0
  3. package/dist/admin-actions.d.ts +2 -0
  4. package/dist/admin-actions.js +18 -0
  5. package/dist/admin-contributions.d.ts +37 -5
  6. package/dist/admin-contributions.js +9 -2
  7. package/dist/admin-roles.d.ts +9 -0
  8. package/dist/admin.d.ts +37 -0
  9. package/dist/admin.js +19 -0
  10. package/dist/api-keys.d.ts +22 -0
  11. package/dist/api-keys.js +4 -0
  12. package/dist/assets-library.d.ts +19 -0
  13. package/dist/assets-library.js +14 -0
  14. package/dist/auth.d.ts +9 -0
  15. package/dist/auth.js +9 -0
  16. package/dist/carts.d.ts +30 -1
  17. package/dist/carts.js +20 -5
  18. package/dist/catalog.d.ts +61 -22
  19. package/dist/catalog.js +32 -6
  20. package/dist/cms.d.ts +33 -3
  21. package/dist/cms.js +15 -0
  22. package/dist/command-hooks.d.ts +301 -0
  23. package/dist/command-hooks.js +248 -0
  24. package/dist/comparisons.d.ts +14 -14
  25. package/dist/credit-limits.d.ts +21 -0
  26. package/dist/credit-limits.js +21 -0
  27. package/dist/crm.d.ts +81 -55
  28. package/dist/crm.js +15 -5
  29. package/dist/custom-fields.d.ts +403 -49
  30. package/dist/custom-fields.js +127 -0
  31. package/dist/customer-accounts.d.ts +138 -0
  32. package/dist/customer-accounts.js +4 -0
  33. package/dist/customer-notifications.d.ts +143 -0
  34. package/dist/customer-notifications.js +41 -0
  35. package/dist/customers.d.ts +52 -0
  36. package/dist/customers.js +53 -0
  37. package/dist/dictionary.d.ts +53 -0
  38. package/dist/dictionary.js +25 -0
  39. package/dist/document-templates.d.ts +4 -4
  40. package/dist/email.d.ts +34 -0
  41. package/dist/email.js +6 -0
  42. package/dist/errors.d.ts +312 -2
  43. package/dist/errors.js +377 -2
  44. package/dist/forms.d.ts +88 -88
  45. package/dist/i18n.d.ts +34 -0
  46. package/dist/i18n.js +15 -0
  47. package/dist/index.d.ts +7 -1
  48. package/dist/index.js +12 -1
  49. package/dist/invoice-ledger.d.ts +6 -6
  50. package/dist/invoices.d.ts +126 -0
  51. package/dist/invoices.js +49 -0
  52. package/dist/line-bounds.d.ts +53 -0
  53. package/dist/line-bounds.js +65 -0
  54. package/dist/megamenu.d.ts +27 -27
  55. package/dist/mfa.d.ts +86 -0
  56. package/dist/mfa.js +90 -0
  57. package/dist/modules.d.ts +21 -5
  58. package/dist/modules.js +60 -3
  59. package/dist/orders.d.ts +141 -0
  60. package/dist/orders.js +80 -3
  61. package/dist/organization-hooks.d.ts +99 -0
  62. package/dist/organization-hooks.js +22 -0
  63. package/dist/organization-registry-lookup.d.ts +5 -5
  64. package/dist/organization-roles.d.ts +1 -0
  65. package/dist/organization-roles.js +7 -0
  66. package/dist/organizations.d.ts +954 -17
  67. package/dist/organizations.js +229 -8
  68. package/dist/price-books.d.ts +173 -25
  69. package/dist/price-books.js +41 -0
  70. package/dist/price-lists.d.ts +5 -2
  71. package/dist/product-feeds.d.ts +157 -8
  72. package/dist/product-feeds.js +41 -2
  73. package/dist/product-scopes.d.ts +17 -0
  74. package/dist/product-scopes.js +31 -5
  75. package/dist/projects.d.ts +61 -28
  76. package/dist/projects.js +47 -9
  77. package/dist/promotions.d.ts +157 -5
  78. package/dist/promotions.js +23 -1
  79. package/dist/pwa.d.ts +39 -0
  80. package/dist/quick-order.d.ts +9 -3
  81. package/dist/quick-order.js +4 -3
  82. package/dist/quote-requests.d.ts +168 -5
  83. package/dist/quote-requests.js +69 -8
  84. package/dist/record-references.d.ts +15 -15
  85. package/dist/returns.d.ts +6 -0
  86. package/dist/returns.js +4 -2
  87. package/dist/sales-channels.d.ts +34 -3
  88. package/dist/sales-channels.js +16 -1
  89. package/dist/schema-extensions.d.ts +36 -0
  90. package/dist/schema-extensions.js +29 -0
  91. package/dist/seo.d.ts +2 -2
  92. package/dist/settings.d.ts +44 -2
  93. package/dist/settings.js +17 -2
  94. package/dist/shopping-lists.d.ts +39 -1
  95. package/dist/shopping-lists.js +37 -3
  96. package/dist/storefront-cache-tags.d.ts +10 -0
  97. package/dist/tasks.d.ts +21 -21
  98. package/dist/taxes.d.ts +27 -0
  99. package/dist/taxes.js +4 -0
  100. package/dist/transactional-emails.d.ts +39 -13
  101. package/dist/webhooks.d.ts +75 -0
  102. package/dist/webhooks.js +24 -0
  103. package/package.json +4 -2
  104. package/dist/actor.d.ts.map +0 -1
  105. package/dist/actor.js.map +0 -1
  106. package/dist/addresses.d.ts.map +0 -1
  107. package/dist/addresses.js.map +0 -1
  108. package/dist/admin-actions.d.ts.map +0 -1
  109. package/dist/admin-actions.js.map +0 -1
  110. package/dist/admin-contributions.d.ts.map +0 -1
  111. package/dist/admin-contributions.js.map +0 -1
  112. package/dist/admin-feedback.d.ts.map +0 -1
  113. package/dist/admin-feedback.js.map +0 -1
  114. package/dist/admin-i18n.d.ts.map +0 -1
  115. package/dist/admin-i18n.js.map +0 -1
  116. package/dist/admin-name.d.ts.map +0 -1
  117. package/dist/admin-name.js.map +0 -1
  118. package/dist/admin-notifications.d.ts.map +0 -1
  119. package/dist/admin-notifications.js.map +0 -1
  120. package/dist/admin-preferences.d.ts.map +0 -1
  121. package/dist/admin-preferences.js.map +0 -1
  122. package/dist/admin-roles.d.ts.map +0 -1
  123. package/dist/admin-roles.js.map +0 -1
  124. package/dist/admin-search.d.ts.map +0 -1
  125. package/dist/admin-search.js.map +0 -1
  126. package/dist/admin-users.d.ts.map +0 -1
  127. package/dist/admin-users.js.map +0 -1
  128. package/dist/admin.d.ts.map +0 -1
  129. package/dist/admin.js.map +0 -1
  130. package/dist/analytics.d.ts.map +0 -1
  131. package/dist/analytics.js.map +0 -1
  132. package/dist/api-keys.d.ts.map +0 -1
  133. package/dist/api-keys.js.map +0 -1
  134. package/dist/assets-library.d.ts.map +0 -1
  135. package/dist/assets-library.js.map +0 -1
  136. package/dist/audit-logs.d.ts.map +0 -1
  137. package/dist/audit-logs.js.map +0 -1
  138. package/dist/auth.d.ts.map +0 -1
  139. package/dist/auth.js.map +0 -1
  140. package/dist/blog.d.ts.map +0 -1
  141. package/dist/blog.js.map +0 -1
  142. package/dist/capabilities.d.ts.map +0 -1
  143. package/dist/capabilities.js.map +0 -1
  144. package/dist/carts.d.ts.map +0 -1
  145. package/dist/carts.js.map +0 -1
  146. package/dist/catalog.d.ts.map +0 -1
  147. package/dist/catalog.js.map +0 -1
  148. package/dist/cms-brand.d.ts.map +0 -1
  149. package/dist/cms-brand.js.map +0 -1
  150. package/dist/cms-contact-form.d.ts.map +0 -1
  151. package/dist/cms-contact-form.js.map +0 -1
  152. package/dist/cms.d.ts.map +0 -1
  153. package/dist/cms.js.map +0 -1
  154. package/dist/common.d.ts.map +0 -1
  155. package/dist/common.js.map +0 -1
  156. package/dist/comparisons.d.ts.map +0 -1
  157. package/dist/comparisons.js.map +0 -1
  158. package/dist/credentials.d.ts.map +0 -1
  159. package/dist/credentials.js.map +0 -1
  160. package/dist/credit-limits.d.ts.map +0 -1
  161. package/dist/credit-limits.js.map +0 -1
  162. package/dist/crm-rich-text.d.ts.map +0 -1
  163. package/dist/crm-rich-text.js.map +0 -1
  164. package/dist/crm.d.ts.map +0 -1
  165. package/dist/crm.js.map +0 -1
  166. package/dist/currencies.d.ts.map +0 -1
  167. package/dist/currencies.js.map +0 -1
  168. package/dist/custom-fields.d.ts.map +0 -1
  169. package/dist/custom-fields.js.map +0 -1
  170. package/dist/customer-accounts.d.ts.map +0 -1
  171. package/dist/customer-accounts.js.map +0 -1
  172. package/dist/customers.d.ts.map +0 -1
  173. package/dist/customers.js.map +0 -1
  174. package/dist/dictionary.d.ts.map +0 -1
  175. package/dist/dictionary.js.map +0 -1
  176. package/dist/document-templates.d.ts.map +0 -1
  177. package/dist/document-templates.js.map +0 -1
  178. package/dist/document-values.d.ts.map +0 -1
  179. package/dist/document-values.js.map +0 -1
  180. package/dist/email-address.d.ts.map +0 -1
  181. package/dist/email-address.js.map +0 -1
  182. package/dist/email.d.ts.map +0 -1
  183. package/dist/email.js.map +0 -1
  184. package/dist/envelopes.d.ts.map +0 -1
  185. package/dist/envelopes.js.map +0 -1
  186. package/dist/environment-inputs.d.ts.map +0 -1
  187. package/dist/environment-inputs.js.map +0 -1
  188. package/dist/erp-connector.d.ts.map +0 -1
  189. package/dist/erp-connector.js.map +0 -1
  190. package/dist/errors.d.ts.map +0 -1
  191. package/dist/errors.js.map +0 -1
  192. package/dist/forms-logic.d.ts.map +0 -1
  193. package/dist/forms-logic.fixtures.d.ts.map +0 -1
  194. package/dist/forms-logic.fixtures.js.map +0 -1
  195. package/dist/forms-logic.js.map +0 -1
  196. package/dist/forms.d.ts.map +0 -1
  197. package/dist/forms.js.map +0 -1
  198. package/dist/google-analytics.d.ts.map +0 -1
  199. package/dist/google-analytics.js.map +0 -1
  200. package/dist/google-tag-manager.d.ts.map +0 -1
  201. package/dist/google-tag-manager.js.map +0 -1
  202. package/dist/i18n.d.ts.map +0 -1
  203. package/dist/i18n.js.map +0 -1
  204. package/dist/import-export.d.ts.map +0 -1
  205. package/dist/import-export.js.map +0 -1
  206. package/dist/index.d.ts.map +0 -1
  207. package/dist/index.js.map +0 -1
  208. package/dist/inventory.d.ts.map +0 -1
  209. package/dist/inventory.js.map +0 -1
  210. package/dist/invoice-ledger.d.ts.map +0 -1
  211. package/dist/invoice-ledger.js.map +0 -1
  212. package/dist/invoices.d.ts.map +0 -1
  213. package/dist/invoices.js.map +0 -1
  214. package/dist/kernel.d.ts.map +0 -1
  215. package/dist/kernel.js.map +0 -1
  216. package/dist/languages.d.ts.map +0 -1
  217. package/dist/languages.js.map +0 -1
  218. package/dist/line-groups.d.ts.map +0 -1
  219. package/dist/line-groups.js.map +0 -1
  220. package/dist/linkedin-ads.d.ts.map +0 -1
  221. package/dist/linkedin-ads.js.map +0 -1
  222. package/dist/localized-name.d.ts.map +0 -1
  223. package/dist/localized-name.js.map +0 -1
  224. package/dist/megamenu.d.ts.map +0 -1
  225. package/dist/megamenu.js.map +0 -1
  226. package/dist/meta-ads.d.ts.map +0 -1
  227. package/dist/meta-ads.js.map +0 -1
  228. package/dist/mfa.d.ts.map +0 -1
  229. package/dist/mfa.js.map +0 -1
  230. package/dist/modules.d.ts.map +0 -1
  231. package/dist/modules.js.map +0 -1
  232. package/dist/money-decimal.d.ts.map +0 -1
  233. package/dist/money-decimal.js.map +0 -1
  234. package/dist/money-input.d.ts.map +0 -1
  235. package/dist/money-input.js.map +0 -1
  236. package/dist/newsletter.d.ts.map +0 -1
  237. package/dist/newsletter.js.map +0 -1
  238. package/dist/order-minimums.d.ts.map +0 -1
  239. package/dist/order-minimums.js.map +0 -1
  240. package/dist/orders.d.ts.map +0 -1
  241. package/dist/orders.js.map +0 -1
  242. package/dist/organization-registry-lookup.d.ts.map +0 -1
  243. package/dist/organization-registry-lookup.js.map +0 -1
  244. package/dist/organization-roles.d.ts.map +0 -1
  245. package/dist/organization-roles.js.map +0 -1
  246. package/dist/organizations.d.ts.map +0 -1
  247. package/dist/organizations.js.map +0 -1
  248. package/dist/page-builder-props.d.ts.map +0 -1
  249. package/dist/page-builder-props.js.map +0 -1
  250. package/dist/page-builder-values.d.ts.map +0 -1
  251. package/dist/page-builder-values.js.map +0 -1
  252. package/dist/pagination.d.ts.map +0 -1
  253. package/dist/pagination.js.map +0 -1
  254. package/dist/payment-methods.d.ts.map +0 -1
  255. package/dist/payment-methods.js.map +0 -1
  256. package/dist/payment-return-url.d.ts.map +0 -1
  257. package/dist/payment-return-url.js.map +0 -1
  258. package/dist/payments.d.ts.map +0 -1
  259. package/dist/payments.js.map +0 -1
  260. package/dist/pim-connector.d.ts.map +0 -1
  261. package/dist/pim-connector.js.map +0 -1
  262. package/dist/pim-field-path.d.ts.map +0 -1
  263. package/dist/pim-field-path.js.map +0 -1
  264. package/dist/pim-locale-mapping.d.ts.map +0 -1
  265. package/dist/pim-locale-mapping.js.map +0 -1
  266. package/dist/platform-info.d.ts.map +0 -1
  267. package/dist/platform-info.js.map +0 -1
  268. package/dist/platform-language.d.ts.map +0 -1
  269. package/dist/platform-language.js.map +0 -1
  270. package/dist/price-book-decimal.d.ts.map +0 -1
  271. package/dist/price-book-decimal.js.map +0 -1
  272. package/dist/price-books.d.ts.map +0 -1
  273. package/dist/price-books.js.map +0 -1
  274. package/dist/price-lists.d.ts.map +0 -1
  275. package/dist/price-lists.js.map +0 -1
  276. package/dist/product-feeds.d.ts.map +0 -1
  277. package/dist/product-feeds.js.map +0 -1
  278. package/dist/product-scope-model.d.ts.map +0 -1
  279. package/dist/product-scope-model.js.map +0 -1
  280. package/dist/product-scope-overrides.d.ts.map +0 -1
  281. package/dist/product-scope-overrides.js.map +0 -1
  282. package/dist/product-scoped-values.d.ts.map +0 -1
  283. package/dist/product-scoped-values.js.map +0 -1
  284. package/dist/product-scopes.d.ts.map +0 -1
  285. package/dist/product-scopes.js.map +0 -1
  286. package/dist/product-summary-text.d.ts.map +0 -1
  287. package/dist/product-summary-text.js.map +0 -1
  288. package/dist/product-tax-rates.d.ts.map +0 -1
  289. package/dist/product-tax-rates.js.map +0 -1
  290. package/dist/product-url-keys.d.ts.map +0 -1
  291. package/dist/product-url-keys.js.map +0 -1
  292. package/dist/product-value-resolver.d.ts.map +0 -1
  293. package/dist/product-value-resolver.js.map +0 -1
  294. package/dist/projects.d.ts.map +0 -1
  295. package/dist/projects.js.map +0 -1
  296. package/dist/promotions.d.ts.map +0 -1
  297. package/dist/promotions.js.map +0 -1
  298. package/dist/prompt-actions.d.ts.map +0 -1
  299. package/dist/prompt-actions.js.map +0 -1
  300. package/dist/pwa.d.ts.map +0 -1
  301. package/dist/pwa.js.map +0 -1
  302. package/dist/quick-order.d.ts.map +0 -1
  303. package/dist/quick-order.js.map +0 -1
  304. package/dist/quote-requests.d.ts.map +0 -1
  305. package/dist/quote-requests.js.map +0 -1
  306. package/dist/record-references.d.ts.map +0 -1
  307. package/dist/record-references.js.map +0 -1
  308. package/dist/record-rich-text.d.ts.map +0 -1
  309. package/dist/record-rich-text.js.map +0 -1
  310. package/dist/returns.d.ts.map +0 -1
  311. package/dist/returns.js.map +0 -1
  312. package/dist/sales-channels.d.ts.map +0 -1
  313. package/dist/sales-channels.js.map +0 -1
  314. package/dist/saved-list-views.d.ts.map +0 -1
  315. package/dist/saved-list-views.js.map +0 -1
  316. package/dist/scope-notice.d.ts.map +0 -1
  317. package/dist/scope-notice.js.map +0 -1
  318. package/dist/scoped-write-encoding.d.ts.map +0 -1
  319. package/dist/scoped-write-encoding.js.map +0 -1
  320. package/dist/search.d.ts.map +0 -1
  321. package/dist/search.js.map +0 -1
  322. package/dist/seo.d.ts.map +0 -1
  323. package/dist/seo.js.map +0 -1
  324. package/dist/settings.d.ts.map +0 -1
  325. package/dist/settings.js.map +0 -1
  326. package/dist/shipments.d.ts.map +0 -1
  327. package/dist/shipments.js.map +0 -1
  328. package/dist/shipping-methods.d.ts.map +0 -1
  329. package/dist/shipping-methods.js.map +0 -1
  330. package/dist/shopping-lists.d.ts.map +0 -1
  331. package/dist/shopping-lists.js.map +0 -1
  332. package/dist/storefront-cache-tags.d.ts.map +0 -1
  333. package/dist/storefront-cache-tags.js.map +0 -1
  334. package/dist/storefront-language-path.d.ts.map +0 -1
  335. package/dist/storefront-language-path.js.map +0 -1
  336. package/dist/storefront-value-overrides.d.ts.map +0 -1
  337. package/dist/storefront-value-overrides.js.map +0 -1
  338. package/dist/tasks.d.ts.map +0 -1
  339. package/dist/tasks.js.map +0 -1
  340. package/dist/taxes.d.ts.map +0 -1
  341. package/dist/taxes.js.map +0 -1
  342. package/dist/text-normalization.d.ts.map +0 -1
  343. package/dist/text-normalization.js.map +0 -1
  344. package/dist/transactional-emails.d.ts.map +0 -1
  345. package/dist/transactional-emails.js.map +0 -1
  346. package/dist/webhooks.d.ts.map +0 -1
  347. package/dist/webhooks.js.map +0 -1
@@ -227,13 +227,13 @@ export declare function isValidCronExpression(expression: string): boolean;
227
227
  export declare function describeCronExpression(expression: string): string | null;
228
228
  export declare const productSelectionOpSchema: z.ZodEnum<{
229
229
  in: "in";
230
+ contains: "contains";
230
231
  startsWith: "startsWith";
231
232
  eq: "eq";
232
233
  gt: "gt";
233
234
  gte: "gte";
234
235
  lt: "lt";
235
236
  lte: "lte";
236
- contains: "contains";
237
237
  isSet: "isSet";
238
238
  neq: "neq";
239
239
  between: "between";
@@ -246,8 +246,8 @@ export declare const productSelectionBuiltinFieldSchema: z.ZodEnum<{
246
246
  status: "status";
247
247
  createdAt: "createdAt";
248
248
  updatedAt: "updatedAt";
249
- price: "price";
250
249
  category: "category";
250
+ price: "price";
251
251
  productType: "productType";
252
252
  brand: "brand";
253
253
  stockState: "stockState";
@@ -259,8 +259,8 @@ export declare const productSelectionFieldSchema: z.ZodDiscriminatedUnion<[z.Zod
259
259
  status: "status";
260
260
  createdAt: "createdAt";
261
261
  updatedAt: "updatedAt";
262
- price: "price";
263
262
  category: "category";
263
+ price: "price";
264
264
  productType: "productType";
265
265
  brand: "brand";
266
266
  stockState: "stockState";
@@ -462,6 +462,7 @@ export declare const feedTemplateSchema: z.ZodObject<{
462
462
  unbound: z.ZodBoolean;
463
463
  }, z.core.$strip>>;
464
464
  usedByFeedCount: z.ZodNumber;
465
+ fieldCount: z.ZodOptional<z.ZodNumber>;
465
466
  version: z.ZodNumber;
466
467
  createdAt: z.ZodString;
467
468
  updatedAt: z.ZodString;
@@ -705,11 +706,19 @@ export declare const feedTemplateResponseSchema: z.ZodObject<{
705
706
  unbound: z.ZodBoolean;
706
707
  }, z.core.$strip>>;
707
708
  usedByFeedCount: z.ZodNumber;
709
+ fieldCount: z.ZodOptional<z.ZodNumber>;
708
710
  version: z.ZodNumber;
709
711
  createdAt: z.ZodString;
710
712
  updatedAt: z.ZodString;
711
713
  }, z.core.$strip>;
712
714
  }, z.core.$strip>;
715
+ export type FeedTemplateResponse = z.infer<typeof feedTemplateResponseSchema>;
716
+ /**
717
+ * `GET /api/v1/admin/feed-templates` — every template, without its field list.
718
+ *
719
+ * `pagination` is optional: the route answers the whole list in one page and has
720
+ * never sent it (issue #599). The rows are `feedTemplateSchema` minus `fields`.
721
+ */
713
722
  export declare const feedTemplateListResponseSchema: z.ZodObject<{
714
723
  data: z.ZodArray<z.ZodObject<{
715
724
  version: z.ZodNumber;
@@ -744,13 +753,114 @@ export declare const feedTemplateListResponseSchema: z.ZodObject<{
744
753
  }>>;
745
754
  systemCode: z.ZodNullable<z.ZodString>;
746
755
  usedByFeedCount: z.ZodNumber;
756
+ fieldCount: z.ZodOptional<z.ZodNumber>;
747
757
  }, z.core.$strip>>;
748
- pagination: z.ZodObject<{
758
+ pagination: z.ZodOptional<z.ZodObject<{
749
759
  cursor: z.ZodNullable<z.ZodString>;
750
760
  hasMore: z.ZodBoolean;
751
761
  limit: z.ZodNumber;
762
+ }, z.core.$strip>>;
763
+ }, z.core.$strip>;
764
+ export type FeedTemplateListResponse = z.infer<typeof feedTemplateListResponseSchema>;
765
+ /**
766
+ * FR-074 — a save that removes a provider-required field. Refused with a `409`
767
+ * carrying these until the operator acknowledges them, then answered beside the
768
+ * saved template.
769
+ */
770
+ export declare const feedTemplateSaveWarningSchema: z.ZodObject<{
771
+ code: z.ZodLiteral<"provider_required_field_removed">;
772
+ outputName: z.ZodString;
773
+ }, z.core.$strip>;
774
+ export type FeedTemplateSaveWarning = z.infer<typeof feedTemplateSaveWarningSchema>;
775
+ /** `PUT /api/v1/admin/feed-templates/:id` — the saved template and the warnings the save acknowledged (issue #599). */
776
+ export declare const feedTemplateUpdateResponseSchema: z.ZodObject<{
777
+ data: z.ZodObject<{
778
+ id: z.ZodString;
779
+ name: z.ZodString;
780
+ description: z.ZodNullable<z.ZodString>;
781
+ providerCode: z.ZodEnum<{
782
+ custom: "custom";
783
+ meta: "meta";
784
+ google_merchant: "google_merchant";
785
+ amazon: "amazon";
786
+ ebay: "ebay";
787
+ allegro: "allegro";
788
+ }>;
789
+ outputFormat: z.ZodEnum<{
790
+ csv: "csv";
791
+ xml: "xml";
792
+ tsv: "tsv";
793
+ txt: "txt";
794
+ xlsx: "xlsx";
795
+ }>;
796
+ itemGranularity: z.ZodEnum<{
797
+ product: "product";
798
+ variant: "variant";
799
+ }>;
800
+ taxonomyProviderCode: z.ZodNullable<z.ZodEnum<{
801
+ meta: "meta";
802
+ google_merchant: "google_merchant";
803
+ }>>;
804
+ isSystem: z.ZodBoolean;
805
+ systemCode: z.ZodNullable<z.ZodString>;
806
+ fields: z.ZodArray<z.ZodObject<{
807
+ id: z.ZodString;
808
+ outputName: z.ZodString;
809
+ sourceKind: z.ZodEnum<{
810
+ description: "description";
811
+ name: "name";
812
+ sku: "sku";
813
+ link: "link";
814
+ price: "price";
815
+ slug: "slug";
816
+ availability: "availability";
817
+ attribute: "attribute";
818
+ product_id: "product_id";
819
+ product_type: "product_type";
820
+ brand: "brand";
821
+ custom_field: "custom_field";
822
+ sale_price: "sale_price";
823
+ stock_quantity: "stock_quantity";
824
+ image_link: "image_link";
825
+ additional_image_link: "additional_image_link";
826
+ category_path: "category_path";
827
+ provider_category: "provider_category";
828
+ grouping_id: "grouping_id";
829
+ pack_quantity: "pack_quantity";
830
+ pack_unit_pricing_measure: "pack_unit_pricing_measure";
831
+ pack_unit_pricing_base_measure: "pack_unit_pricing_base_measure";
832
+ constant: "constant";
833
+ }>;
834
+ sourceKey: z.ZodNullable<z.ZodString>;
835
+ constantValue: z.ZodNullable<z.ZodString>;
836
+ fallbackValue: z.ZodNullable<z.ZodString>;
837
+ providerRequired: z.ZodBoolean;
838
+ transform: z.ZodNullable<z.ZodEnum<{
839
+ trim: "trim";
840
+ none: "none";
841
+ upper: "upper";
842
+ lower: "lower";
843
+ truncate: "truncate";
844
+ strip_html: "strip_html";
845
+ absolute_url: "absolute_url";
846
+ }>>;
847
+ transformArg: z.ZodNullable<z.ZodString>;
848
+ sortOrder: z.ZodNumber;
849
+ helpKey: z.ZodNullable<z.ZodString>;
850
+ unbound: z.ZodBoolean;
851
+ }, z.core.$strip>>;
852
+ usedByFeedCount: z.ZodNumber;
853
+ fieldCount: z.ZodOptional<z.ZodNumber>;
854
+ version: z.ZodNumber;
855
+ createdAt: z.ZodString;
856
+ updatedAt: z.ZodString;
752
857
  }, z.core.$strip>;
858
+ warnings: z.ZodArray<z.ZodObject<{
859
+ code: z.ZodLiteral<"provider_required_field_removed">;
860
+ outputName: z.ZodString;
861
+ }, z.core.$strip>>;
753
862
  }, z.core.$strip>;
863
+ export type FeedTemplateUpdateResponse = z.infer<typeof feedTemplateUpdateResponseSchema>;
754
864
  /** Why a group exists, so the editor can order and head the picker's sections. */
755
865
  export declare const feedFieldSourceGroupKindSchema: z.ZodEnum<{
756
866
  attribute: "attribute";
@@ -1547,6 +1657,42 @@ export declare const productFeedListResponseSchema: z.ZodObject<{
1547
1657
  limit: z.ZodNumber;
1548
1658
  }, z.core.$strip>;
1549
1659
  }, z.core.$strip>;
1660
+ /**
1661
+ * Issue #414 — one price book a feed's settings offer to pin the feed to
1662
+ * (`GET /api/v1/admin/product-feeds/:id/price-book-options`): every book in the
1663
+ * feed's currency, plus the book the feed is pinned to whatever its currency.
1664
+ * `unpublishableReason` is why the book would publish no prices for this feed
1665
+ * now (feature 160 FR-029, owner ruling 2026-10-23), `null` when it would.
1666
+ */
1667
+ export declare const productFeedPriceBookOptionSchema: z.ZodObject<{
1668
+ id: z.ZodString;
1669
+ name: z.ZodString;
1670
+ isBase: z.ZodBoolean;
1671
+ unpublishableReason: z.ZodNullable<z.ZodEnum<{
1672
+ not_found: "not_found";
1673
+ currency_mismatch: "currency_mismatch";
1674
+ not_active: "not_active";
1675
+ outside_schedule: "outside_schedule";
1676
+ not_on_channel: "not_on_channel";
1677
+ audience_restricted: "audience_restricted";
1678
+ }>>;
1679
+ }, z.core.$strip>;
1680
+ export type ProductFeedPriceBookOption = z.infer<typeof productFeedPriceBookOptionSchema>;
1681
+ export declare const productFeedPriceBookOptionsResponseSchema: z.ZodObject<{
1682
+ data: z.ZodArray<z.ZodObject<{
1683
+ id: z.ZodString;
1684
+ name: z.ZodString;
1685
+ isBase: z.ZodBoolean;
1686
+ unpublishableReason: z.ZodNullable<z.ZodEnum<{
1687
+ not_found: "not_found";
1688
+ currency_mismatch: "currency_mismatch";
1689
+ not_active: "not_active";
1690
+ outside_schedule: "outside_schedule";
1691
+ not_on_channel: "not_on_channel";
1692
+ audience_restricted: "audience_restricted";
1693
+ }>>;
1694
+ }, z.core.$strip>>;
1695
+ }, z.core.$strip>;
1550
1696
  /** Returned exactly once, on create and on rotate. Never re-readable (FR-047). */
1551
1697
  export declare const productFeedTokenIssuedResponseSchema: z.ZodObject<{
1552
1698
  data: z.ZodObject<{
@@ -1827,6 +1973,7 @@ export declare const feedRunIssueListResponseSchema: z.ZodObject<{
1827
1973
  limit: z.ZodNumber;
1828
1974
  }, z.core.$strip>;
1829
1975
  }, z.core.$strip>;
1976
+ export type FeedRunIssueListResponse = z.infer<typeof feedRunIssueListResponseSchema>;
1830
1977
  export declare const feedRunListQuerySchema: z.ZodObject<{
1831
1978
  limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1832
1979
  cursor: z.ZodOptional<z.ZodString>;
@@ -2104,8 +2251,8 @@ export type FeedTaxonomyCheckOutcome = z.infer<typeof feedTaxonomyCheckOutcomeSc
2104
2251
  /** Why a check did not install anything. Closed set — the admin renders a translated line per value. */
2105
2252
  export declare const feedTaxonomyCheckReasonSchema: z.ZodEnum<{
2106
2253
  empty: "empty";
2107
- truncated: "truncated";
2108
2254
  not_found: "not_found";
2255
+ truncated: "truncated";
2109
2256
  transport: "transport";
2110
2257
  http_status: "http_status";
2111
2258
  not_taxonomy: "not_taxonomy";
@@ -2135,8 +2282,8 @@ export declare const feedTaxonomyCheckSchema: z.ZodObject<{
2135
2282
  }>>;
2136
2283
  reason: z.ZodNullable<z.ZodEnum<{
2137
2284
  empty: "empty";
2138
- truncated: "truncated";
2139
2285
  not_found: "not_found";
2286
+ truncated: "truncated";
2140
2287
  transport: "transport";
2141
2288
  http_status: "http_status";
2142
2289
  not_taxonomy: "not_taxonomy";
@@ -2173,8 +2320,8 @@ export declare const feedTaxonomyCheckListResponseSchema: z.ZodObject<{
2173
2320
  }>>;
2174
2321
  reason: z.ZodNullable<z.ZodEnum<{
2175
2322
  empty: "empty";
2176
- truncated: "truncated";
2177
2323
  not_found: "not_found";
2324
+ truncated: "truncated";
2178
2325
  transport: "transport";
2179
2326
  http_status: "http_status";
2180
2327
  not_taxonomy: "not_taxonomy";
@@ -2216,8 +2363,8 @@ export declare const feedTaxonomyCheckResponseSchema: z.ZodObject<{
2216
2363
  }>>;
2217
2364
  reason: z.ZodNullable<z.ZodEnum<{
2218
2365
  empty: "empty";
2219
- truncated: "truncated";
2220
2366
  not_found: "not_found";
2367
+ truncated: "truncated";
2221
2368
  transport: "transport";
2222
2369
  http_status: "http_status";
2223
2370
  not_taxonomy: "not_taxonomy";
@@ -2489,6 +2636,7 @@ export declare const importFeedTemplateResponseSchema: z.ZodObject<{
2489
2636
  unbound: z.ZodBoolean;
2490
2637
  }, z.core.$strip>>;
2491
2638
  usedByFeedCount: z.ZodNumber;
2639
+ fieldCount: z.ZodOptional<z.ZodNumber>;
2492
2640
  version: z.ZodNumber;
2493
2641
  createdAt: z.ZodString;
2494
2642
  updatedAt: z.ZodString;
@@ -2524,6 +2672,7 @@ export declare const importFeedTemplateResponseSchema: z.ZodObject<{
2524
2672
  }, z.core.$strip>>;
2525
2673
  }, z.core.$strip>;
2526
2674
  }, z.core.$strip>;
2675
+ export type ImportFeedTemplateResponse = z.infer<typeof importFeedTemplateResponseSchema>;
2527
2676
  export declare const PRODUCT_FEED_ERROR_CODES: {
2528
2677
  readonly TEMPLATE_IS_SYSTEM: "template_is_system";
2529
2678
  readonly TEMPLATE_IN_USE: "template_in_use";
@@ -15,7 +15,7 @@
15
15
  import { z } from 'zod';
16
16
  import { isoDateTimeSchema, uuidSchema } from './common.js';
17
17
  import { collectionEnvelope, dataEnvelope } from './envelopes.js';
18
- import { listQuerySchema } from './pagination.js';
18
+ import { listQuerySchema, paginationSchema } from './pagination.js';
19
19
  import { pinnedPriceBookUnpublishableReasonSchema } from './price-lists.js';
20
20
  // ---------------------------------------------------------------------------
21
21
  // (1) Enumerations
@@ -545,6 +545,11 @@ export const feedTemplateSchema = z.object({
545
545
  fields: z.array(feedTemplateFieldSchema),
546
546
  /** Number of feeds referencing this template — drives the delete refusal message (FR-010). */
547
547
  usedByFeedCount: z.number().int().nonnegative(),
548
+ /**
549
+ * The length of `fields`. Every template reply answers it; the list, which
550
+ * carries no `fields`, shows it as the field count (issue #599).
551
+ */
552
+ fieldCount: z.number().int().nonnegative().optional(),
548
553
  version: z.number().int().positive(),
549
554
  createdAt: isoDateTimeSchema,
550
555
  updatedAt: isoDateTimeSchema,
@@ -589,7 +594,26 @@ export const duplicateFeedTemplateRequestSchema = z.object({
589
594
  name: z.string().trim().min(1).max(200),
590
595
  });
591
596
  export const feedTemplateResponseSchema = dataEnvelope(feedTemplateSchema);
592
- export const feedTemplateListResponseSchema = collectionEnvelope(feedTemplateSchema.omit({ fields: true }));
597
+ /**
598
+ * `GET /api/v1/admin/feed-templates` — every template, without its field list.
599
+ *
600
+ * `pagination` is optional: the route answers the whole list in one page and has
601
+ * never sent it (issue #599). The rows are `feedTemplateSchema` minus `fields`.
602
+ */
603
+ export const feedTemplateListResponseSchema = collectionEnvelope(feedTemplateSchema.omit({ fields: true })).extend({ pagination: paginationSchema.optional() });
604
+ /**
605
+ * FR-074 — a save that removes a provider-required field. Refused with a `409`
606
+ * carrying these until the operator acknowledges them, then answered beside the
607
+ * saved template.
608
+ */
609
+ export const feedTemplateSaveWarningSchema = z.object({
610
+ code: z.literal('provider_required_field_removed'),
611
+ outputName: z.string(),
612
+ });
613
+ /** `PUT /api/v1/admin/feed-templates/:id` — the saved template and the warnings the save acknowledged (issue #599). */
614
+ export const feedTemplateUpdateResponseSchema = feedTemplateResponseSchema.extend({
615
+ warnings: z.array(feedTemplateSaveWarningSchema),
616
+ });
593
617
  // ---------------------------------------------------------------------------
594
618
  // (4b) Guided binding catalogue (FR-070)
595
619
  //
@@ -834,6 +858,21 @@ export const duplicateProductFeedRequestSchema = z.object({
834
858
  });
835
859
  export const productFeedResponseSchema = dataEnvelope(productFeedSchema);
836
860
  export const productFeedListResponseSchema = collectionEnvelope(productFeedSchema);
861
+ /**
862
+ * Issue #414 — one price book a feed's settings offer to pin the feed to
863
+ * (`GET /api/v1/admin/product-feeds/:id/price-book-options`): every book in the
864
+ * feed's currency, plus the book the feed is pinned to whatever its currency.
865
+ * `unpublishableReason` is why the book would publish no prices for this feed
866
+ * now (feature 160 FR-029, owner ruling 2026-10-23), `null` when it would.
867
+ */
868
+ export const productFeedPriceBookOptionSchema = z.object({
869
+ id: z.string().min(1),
870
+ name: z.string(),
871
+ /** The currency's base book. */
872
+ isBase: z.boolean(),
873
+ unpublishableReason: pinnedPriceBookUnpublishableReasonSchema.nullable(),
874
+ });
875
+ export const productFeedPriceBookOptionsResponseSchema = dataEnvelope(z.array(productFeedPriceBookOptionSchema));
837
876
  /** Returned exactly once, on create and on rotate. Never re-readable (FR-047). */
838
877
  export const productFeedTokenIssuedResponseSchema = dataEnvelope(z.object({
839
878
  token: z.string(),
@@ -200,6 +200,23 @@ export declare function scopeLanguageOf(channel: {
200
200
  languages?: readonly string[] | undefined;
201
201
  defaultLanguage: string;
202
202
  }, requestedTag: string | null | undefined): string;
203
+ /**
204
+ * The scope language L of a buyer request on `channel` from its whole
205
+ * `Accept-Language` header (issue #397): the tags in descending `q`
206
+ * ({@link parseAcceptLanguage}), each matched against the channel's languages as
207
+ * {@link resolveScopeLanguage} matches one — exactly, then by base language
208
+ * (`pl` → `pl-PL`) — and the first tag the channel serves wins; with none served,
209
+ * the channel's default. Always spelled as the channel spells it.
210
+ *
211
+ * The header form of {@link scopeLanguageOf}; prefer it to
212
+ * `scopeLanguageOf(channel, firstLanguageTag(header))`, which ignores the weights
213
+ * and stops at the first tag whether or not the channel serves it.
214
+ */
215
+ export declare function requestScopeLanguage(channel: {
216
+ id: string;
217
+ languages?: readonly string[] | undefined;
218
+ defaultLanguage: string;
219
+ }, header: string | readonly string[] | undefined): string;
203
220
  /**
204
221
  * The first tag of an `Accept-Language` header, without its quality parameter,
205
222
  * or `undefined` when the header is absent or empty.
@@ -1,5 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { isoDateTimeSchema, multilingualStringSchema, productVisibilitySchema, UUID_SHAPE_PATTERN, uuidSchema, } from './common.js';
3
+ import { parseAcceptLanguage } from './accept-language.js';
3
4
  import { isProductVisibleTo, productStatusSchema } from './catalog.js';
4
5
  import { ORDER_MINIMUM_MAX } from './order-minimums.js';
5
6
  import { scopeFromRequest } from './product-scope-model.js';
@@ -149,15 +150,19 @@ function statusOnAt(snapshot, channelId, languageCode) {
149
150
  */
150
151
  export function resolveScopeLanguage(channel, requestedTag) {
151
152
  // An `Accept-Language` pick may carry its quality parameter (`de;q=0.9`).
152
- const tag = requestedTag?.split(';')[0]?.trim().toLowerCase() ?? '';
153
+ const tag = requestedTag?.split(';')[0]?.trim() ?? '';
154
+ return matchChannelLanguage(channel.languages, tag) ?? channel.defaultLanguage;
155
+ }
156
+ /** The channel language `tag` names — exactly, else by base language — or `undefined`. */
157
+ function matchChannelLanguage(languages, requestedTag) {
158
+ const tag = requestedTag.toLowerCase();
153
159
  if (tag === '')
154
- return channel.defaultLanguage;
155
- const exact = channel.languages.find((language) => language.toLowerCase() === tag);
160
+ return undefined;
161
+ const exact = languages.find((language) => language.toLowerCase() === tag);
156
162
  if (exact !== undefined)
157
163
  return exact;
158
164
  const base = baseLanguage(tag);
159
- const sameBase = channel.languages.find((language) => baseLanguage(language.toLowerCase()) === base);
160
- return sameBase ?? channel.defaultLanguage;
165
+ return languages.find((language) => baseLanguage(language.toLowerCase()) === base);
161
166
  }
162
167
  export { sameLanguage } from './product-scope-model.js';
163
168
  /**
@@ -181,6 +186,27 @@ export function toScopeChannel(channel) {
181
186
  export function scopeLanguageOf(channel, requestedTag) {
182
187
  return resolveScopeLanguage(toScopeChannel(channel), requestedTag);
183
188
  }
189
+ /**
190
+ * The scope language L of a buyer request on `channel` from its whole
191
+ * `Accept-Language` header (issue #397): the tags in descending `q`
192
+ * ({@link parseAcceptLanguage}), each matched against the channel's languages as
193
+ * {@link resolveScopeLanguage} matches one — exactly, then by base language
194
+ * (`pl` → `pl-PL`) — and the first tag the channel serves wins; with none served,
195
+ * the channel's default. Always spelled as the channel spells it.
196
+ *
197
+ * The header form of {@link scopeLanguageOf}; prefer it to
198
+ * `scopeLanguageOf(channel, firstLanguageTag(header))`, which ignores the weights
199
+ * and stops at the first tag whether or not the channel serves it.
200
+ */
201
+ export function requestScopeLanguage(channel, header) {
202
+ const { languages, defaultLanguage } = toScopeChannel(channel);
203
+ for (const tag of parseAcceptLanguage(header)) {
204
+ const match = matchChannelLanguage(languages, tag);
205
+ if (match !== undefined)
206
+ return match;
207
+ }
208
+ return defaultLanguage;
209
+ }
184
210
  /**
185
211
  * The first tag of an `Accept-Language` header, without its quality parameter,
186
212
  * or `undefined` when the header is absent or empty.