@africanies/angular-web-sdk 0.1.12 → 0.1.13

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 (181) hide show
  1. package/.nx/cache/13293303228070520113/dist/libs/africanies-core/README.md +85 -0
  2. package/.nx/cache/13293303228070520113/dist/libs/africanies-core/fesm2022/africanies-africanies-core.mjs +4699 -0
  3. package/.nx/cache/13293303228070520113/dist/libs/africanies-core/fesm2022/africanies-africanies-core.mjs.map +1 -0
  4. package/.nx/cache/13293303228070520113/dist/libs/africanies-core/package.json +31 -0
  5. package/.nx/cache/13293303228070520113/dist/libs/africanies-core/types/africanies-africanies-core.d.ts +2748 -0
  6. package/.nx/cache/13387631073062967069/dist/libs/africanies-theme/README.md +46 -0
  7. package/.nx/cache/13387631073062967069/dist/libs/africanies-theme/fesm2022/africanies-africanies-theme.mjs +249 -0
  8. package/.nx/cache/13387631073062967069/dist/libs/africanies-theme/fesm2022/africanies-africanies-theme.mjs.map +1 -0
  9. package/.nx/cache/13387631073062967069/dist/libs/africanies-theme/package.json +35 -0
  10. package/.nx/cache/13387631073062967069/dist/libs/africanies-theme/tailwind-preset.cjs +330 -0
  11. package/.nx/cache/13387631073062967069/dist/libs/africanies-theme/types/africanies-africanies-theme.d.ts +178 -0
  12. package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/README.md +31 -0
  13. package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/fesm2022/africanies-africanies-storage.mjs +249 -0
  14. package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/fesm2022/africanies-africanies-storage.mjs.map +1 -0
  15. package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/package.json +26 -0
  16. package/.nx/cache/16704640000606796352/dist/libs/africanies-storage/types/africanies-africanies-storage.d.ts +210 -0
  17. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/README.md +68 -0
  18. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/assets/brand/africanies-logo-mini.png +0 -0
  19. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/assets/brand/africanies-logo.png +0 -0
  20. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/assets/brand/africanies-logo.svg +5 -0
  21. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/assets/carriers/dhl.svg +7 -0
  22. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/fesm2022/africanies-africanies-ui.mjs +21251 -0
  23. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/fesm2022/africanies-africanies-ui.mjs.map +1 -0
  24. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/package.json +35 -0
  25. package/.nx/cache/2427575433215940812/dist/libs/africanies-ui/types/africanies-africanies-ui.d.ts +5803 -0
  26. package/.nx/cache/7730350229628359718/dist/libs/africanies-icons/README.md +69 -0
  27. package/.nx/cache/7730350229628359718/dist/libs/africanies-icons/assets/icons.sprite.svg +1851 -0
  28. package/.nx/cache/7730350229628359718/dist/libs/africanies-icons/fesm2022/africanies-africanies-icons.mjs +839 -0
  29. package/.nx/cache/7730350229628359718/dist/libs/africanies-icons/fesm2022/africanies-africanies-icons.mjs.map +1 -0
  30. package/.nx/cache/7730350229628359718/dist/libs/africanies-icons/package.json +30 -0
  31. package/.nx/cache/7730350229628359718/dist/libs/africanies-icons/types/africanies-africanies-icons.d.ts +108 -0
  32. package/.nx/cache/run.json +35 -35
  33. package/.nx/cache/terminalOutputs/10603154579345867998 +397 -0
  34. package/.nx/cache/terminalOutputs/12354163057083828162 +80 -0
  35. package/.nx/cache/terminalOutputs/13293303228070520113 +21 -0
  36. package/.nx/cache/terminalOutputs/13387631073062967069 +21 -0
  37. package/.nx/cache/terminalOutputs/14876351543379349919 +176 -0
  38. package/.nx/cache/terminalOutputs/15336883221450327589 +21 -0
  39. package/.nx/cache/terminalOutputs/16208231681037145050 +86 -84
  40. package/.nx/cache/terminalOutputs/16704640000606796352 +21 -0
  41. package/.nx/cache/terminalOutputs/1811006905937373707 +74 -0
  42. package/.nx/cache/terminalOutputs/2005781115771702035 +8 -0
  43. package/.nx/cache/terminalOutputs/2360743690449633551 +21 -0
  44. package/.nx/cache/terminalOutputs/2427575433215940812 +21 -0
  45. package/.nx/cache/terminalOutputs/2981230413857865352 +8 -0
  46. package/.nx/cache/terminalOutputs/3243550283886864639 +8 -0
  47. package/.nx/cache/terminalOutputs/3380188914363501109 +231 -0
  48. package/.nx/cache/terminalOutputs/3699068646900552690 +8 -0
  49. package/.nx/cache/terminalOutputs/5175669339257931410 +8 -0
  50. package/.nx/cache/terminalOutputs/6040230831125637867 +8 -0
  51. package/.nx/cache/terminalOutputs/7730350229628359718 +21 -0
  52. package/.nx/cache/terminalOutputs/8098730470212963224 +87 -0
  53. package/.nx/cache/terminalOutputs/8928690901537686687 +21 -0
  54. package/.nx/workspace-data/0091ABA9-5C90-580D-953C-8C94E763ADB5-v3.db +0 -0
  55. package/.nx/workspace-data/0091ABA9-5C90-580D-953C-8C94E763ADB5-v3.db-shm +0 -0
  56. package/.nx/workspace-data/0091ABA9-5C90-580D-953C-8C94E763ADB5-v3.db-wal +0 -0
  57. package/.nx/workspace-data/d/daemon.log +2859 -0
  58. package/.nx/workspace-data/d/server-process.json +2 -2
  59. package/.nx/workspace-data/file-map.json +2155 -2183
  60. package/.nx/workspace-data/nx_files.nxt +0 -0
  61. package/.nx/workspace-data/project-graph.json +2 -2
  62. package/dist/libs/africanies-core/fesm2022/africanies-africanies-core.mjs +60 -0
  63. package/dist/libs/africanies-core/fesm2022/africanies-africanies-core.mjs.map +1 -1
  64. package/dist/libs/africanies-icons/fesm2022/africanies-africanies-icons.mjs +6 -0
  65. package/dist/libs/africanies-icons/fesm2022/africanies-africanies-icons.mjs.map +1 -1
  66. package/dist/libs/africanies-storage/fesm2022/africanies-africanies-storage.mjs +6 -0
  67. package/dist/libs/africanies-storage/fesm2022/africanies-africanies-storage.mjs.map +1 -1
  68. package/dist/libs/africanies-theme/fesm2022/africanies-africanies-theme.mjs +6 -0
  69. package/dist/libs/africanies-theme/fesm2022/africanies-africanies-theme.mjs.map +1 -1
  70. package/dist/libs/africanies-ui/fesm2022/africanies-africanies-ui.mjs +297 -51
  71. package/dist/libs/africanies-ui/fesm2022/africanies-africanies-ui.mjs.map +1 -1
  72. package/dist/libs/africanies-ui/types/africanies-africanies-ui.d.ts +12 -12
  73. package/libs/africanies-core/src/lib/auth/auth-token.service.ts +3 -0
  74. package/libs/africanies-core/src/lib/auth/auth.service.ts +3 -0
  75. package/libs/africanies-core/src/lib/country/country.service.ts +3 -0
  76. package/libs/africanies-core/src/lib/currency/currency.service.ts +3 -0
  77. package/libs/africanies-core/src/lib/document/document.service.ts +3 -0
  78. package/libs/africanies-core/src/lib/file/file.service.ts +3 -0
  79. package/libs/africanies-core/src/lib/filters/filter-options.resolver.ts +3 -0
  80. package/libs/africanies-core/src/lib/http/api-client.ts +3 -0
  81. package/libs/africanies-core/src/lib/mode/mode-config.service.ts +3 -0
  82. package/libs/africanies-core/src/lib/notification/notification.service.ts +3 -0
  83. package/libs/africanies-core/src/lib/overlay/route-overlay.service.ts +3 -0
  84. package/libs/africanies-core/src/lib/payment-method/payment-method.service.ts +3 -0
  85. package/libs/africanies-core/src/lib/plan/plan.service.ts +3 -0
  86. package/libs/africanies-core/src/lib/product/product.service.ts +3 -0
  87. package/libs/africanies-core/src/lib/service/service.service.ts +3 -0
  88. package/libs/africanies-core/src/lib/shipment-method/shipment-method.service.ts +3 -0
  89. package/libs/africanies-core/src/lib/shipping/shipping-mode.service.ts +3 -0
  90. package/libs/africanies-core/src/lib/user/user.service.ts +3 -0
  91. package/libs/africanies-core/src/lib/warehouse/warehouse.service.ts +3 -0
  92. package/libs/africanies-core/src/lib/zone/zone.service.ts +3 -0
  93. package/libs/africanies-icons/src/lib/africanies-icon.component.ts +3 -0
  94. package/libs/africanies-icons/src/lib/icon-registry.service.ts +3 -0
  95. package/libs/africanies-storage/src/lib/local-storage.service.ts +3 -0
  96. package/libs/africanies-storage/src/lib/session-storage.service.ts +3 -0
  97. package/libs/africanies-theme/src/lib/mode-color.service.ts +3 -0
  98. package/libs/africanies-theme/src/lib/theme.service.ts +3 -0
  99. package/libs/africanies-ui/src/index.ts +11 -11
  100. package/libs/africanies-ui/src/lib/accordion/accordion.component.ts +3 -0
  101. package/libs/africanies-ui/src/lib/action-menu/action-menu-trigger.directive.ts +3 -0
  102. package/libs/africanies-ui/src/lib/action-menu/action-menu.component.ts +3 -0
  103. package/libs/africanies-ui/src/lib/alert/alert.component.ts +3 -0
  104. package/libs/africanies-ui/src/lib/avatar/avatar-menu.component.ts +3 -0
  105. package/libs/africanies-ui/src/lib/avatar/avatar.component.ts +3 -0
  106. package/libs/africanies-ui/src/lib/brand/brand-logo.component.ts +3 -0
  107. package/libs/africanies-ui/src/lib/button/button.component.ts +3 -0
  108. package/libs/africanies-ui/src/lib/carrier/carrier-logo.component.ts +3 -0
  109. package/libs/africanies-ui/src/lib/chip/chip.component.ts +3 -0
  110. package/libs/africanies-ui/src/lib/content-stack/content-stack.component.ts +3 -0
  111. package/libs/africanies-ui/src/lib/copy-button/copy-button.component.ts +3 -0
  112. package/libs/africanies-ui/src/lib/feedback/async-state.component.ts +3 -0
  113. package/libs/africanies-ui/src/lib/feedback/empty-state.component.ts +3 -0
  114. package/libs/africanies-ui/src/lib/feedback/error-indicator.component.ts +3 -0
  115. package/libs/africanies-ui/src/lib/feedback/error-state.component.ts +3 -0
  116. package/libs/africanies-ui/src/lib/feedback/loading-state.component.ts +3 -0
  117. package/libs/africanies-ui/src/lib/filters/filter-drawer.panel.ts +3 -0
  118. package/libs/africanies-ui/src/lib/filters/filter-drawer.service.ts +3 -0
  119. package/libs/africanies-ui/src/lib/filters/filter-query.service.ts +3 -0
  120. package/libs/africanies-ui/src/lib/forms/address-input/address-input.component.ts +3 -0
  121. package/libs/africanies-ui/src/lib/forms/address-input/google-places.service.ts +3 -0
  122. package/libs/africanies-ui/src/lib/forms/checkbox/checkbox.component.ts +3 -0
  123. package/libs/africanies-ui/src/lib/forms/date-picker/date-picker.component.ts +3 -0
  124. package/libs/africanies-ui/src/lib/forms/file-upload/camera-capture.dialog.ts +3 -0
  125. package/libs/africanies-ui/src/lib/forms/file-upload/file-preview.dialog.ts +3 -0
  126. package/libs/africanies-ui/src/lib/forms/file-upload/file-upload.component.ts +3 -0
  127. package/libs/africanies-ui/src/lib/forms/index.ts +3 -3
  128. package/libs/africanies-ui/src/lib/forms/number-input/number-input.component.ts +3 -0
  129. package/libs/africanies-ui/src/lib/forms/otp-input/otp-input.component.ts +3 -0
  130. package/libs/africanies-ui/src/lib/forms/phone-input/phone-input.component.ts +9 -6
  131. package/libs/africanies-ui/src/lib/forms/radio/radio.component.ts +3 -0
  132. package/libs/africanies-ui/src/lib/forms/search-combobox/search-combobox.component.ts +3 -0
  133. package/libs/africanies-ui/src/lib/forms/select/select.component.ts +3 -0
  134. package/libs/africanies-ui/src/lib/forms/text-input/text-input.component.ts +3 -0
  135. package/libs/africanies-ui/src/lib/forms/textarea/textarea.component.ts +3 -0
  136. package/libs/africanies-ui/src/lib/forms/toggle/toggle.component.ts +3 -0
  137. package/libs/africanies-ui/src/lib/image/image.component.ts +3 -0
  138. package/libs/africanies-ui/src/lib/info-popover/info-popover-content.directive.ts +3 -0
  139. package/libs/africanies-ui/src/lib/info-popover/info-popover-trigger.directive.ts +3 -0
  140. package/libs/africanies-ui/src/lib/info-popover/info-popover.component.ts +3 -0
  141. package/libs/africanies-ui/src/lib/layout/app-shell-content-header.component.ts +3 -0
  142. package/libs/africanies-ui/src/lib/layout/app-shell-header-slot.directive.ts +3 -0
  143. package/libs/africanies-ui/src/lib/layout/app-shell-header.component.ts +9 -0
  144. package/libs/africanies-ui/src/lib/layout/app-shell.component.ts +3 -0
  145. package/libs/africanies-ui/src/lib/layout/header-weather.spec.ts +62 -94
  146. package/libs/africanies-ui/src/lib/layout/header-weather.ts +54 -61
  147. package/libs/africanies-ui/src/lib/layout/page-header.component.ts +3 -0
  148. package/libs/africanies-ui/src/lib/modules/africanies-actions.module.ts +3 -0
  149. package/libs/africanies-ui/src/lib/modules/africanies-feedback.module.ts +3 -0
  150. package/libs/africanies-ui/src/lib/modules/africanies-forms.module.ts +3 -0
  151. package/libs/africanies-ui/src/lib/modules/africanies-info-popover.module.ts +3 -0
  152. package/libs/africanies-ui/src/lib/modules/africanies-navigation.module.ts +3 -0
  153. package/libs/africanies-ui/src/lib/modules/africanies-stepper.module.ts +3 -0
  154. package/libs/africanies-ui/src/lib/modules/africanies-table.module.ts +3 -0
  155. package/libs/africanies-ui/src/lib/modules/africanies-tooltip.module.ts +3 -0
  156. package/libs/africanies-ui/src/lib/navigation/breadcrumb/breadcrumb.component.ts +3 -0
  157. package/libs/africanies-ui/src/lib/navigation/segment/segment.component.ts +3 -0
  158. package/libs/africanies-ui/src/lib/navigation/shipping-mode-switch/shipping-mode-switch.component.ts +3 -0
  159. package/libs/africanies-ui/src/lib/navigation/side-nav/africanies-side-nav.component.ts +3 -0
  160. package/libs/africanies-ui/src/lib/navigation/tabs/tab-def.directive.ts +3 -0
  161. package/libs/africanies-ui/src/lib/navigation/tabs/tabs.component.ts +3 -0
  162. package/libs/africanies-ui/src/lib/notifications/notification-drawer.panel.ts +3 -0
  163. package/libs/africanies-ui/src/lib/notifications/notification-drawer.service.ts +3 -0
  164. package/libs/africanies-ui/src/lib/overlay/confirm-dialog.component.ts +3 -0
  165. package/libs/africanies-ui/src/lib/overlay/confirm.service.ts +3 -0
  166. package/libs/africanies-ui/src/lib/overlay/drawer.service.ts +3 -0
  167. package/libs/africanies-ui/src/lib/overlay/modal.service.ts +3 -0
  168. package/libs/africanies-ui/src/lib/overlay/overlay-frame.component.ts +9 -0
  169. package/libs/africanies-ui/src/lib/pagination/pagination.component.ts +3 -0
  170. package/libs/africanies-ui/src/lib/stepper/step-def.directive.ts +3 -0
  171. package/libs/africanies-ui/src/lib/stepper/stepper.component.ts +3 -0
  172. package/libs/africanies-ui/src/lib/table/cell-def.directive.ts +3 -0
  173. package/libs/africanies-ui/src/lib/table/header-cell-def.directive.ts +3 -0
  174. package/libs/africanies-ui/src/lib/table/row-detail-def.directive.ts +3 -0
  175. package/libs/africanies-ui/src/lib/table/table.component.ts +3 -0
  176. package/libs/africanies-ui/src/lib/toast/toast-host.component.ts +4 -1
  177. package/libs/africanies-ui/src/lib/toast/toast-item.component.ts +3 -0
  178. package/libs/africanies-ui/src/lib/toast/toast.service.ts +3 -0
  179. package/libs/africanies-ui/src/lib/tooltip/tooltip-trigger.directive.ts +3 -0
  180. package/libs/africanies-ui/src/lib/tooltip/tooltip.component.ts +3 -0
  181. package/package.json +1 -1
Binary file
@@ -826,7 +826,7 @@
826
826
  "targetGroups": {},
827
827
  "js": {
828
828
  "packageName": "@africanies/angular-web-sdk",
829
- "packageVersion": "0.1.12",
829
+ "packageVersion": "0.1.13",
830
830
  "isInPackageManagerWorkspaces": true
831
831
  }
832
832
  },
@@ -42095,5 +42095,5 @@
42095
42095
  },
42096
42096
  "version": "6.0",
42097
42097
  "errors": [],
42098
- "computedAt": 1789121395872
42098
+ "computedAt": 1789139553650
42099
42099
  }
@@ -48,6 +48,9 @@ const DEFAULT_MODE = 'sfn';
48
48
  * console.log(shipping.mode()); // 'stn'
49
49
  * ```
50
50
  */
51
+ /**
52
+ * Signal-based holder for the active {@link ShippingMode}.
53
+ */
51
54
  class ShippingModeService {
52
55
  storage = inject(SessionStorageService);
53
56
  injector = inject(Injector);
@@ -970,6 +973,9 @@ function mapResourcePayload(id, raw, mapOne, mapMany) {
970
973
  * });
971
974
  * ```
972
975
  */
976
+ /**
977
+ * Endpoint-agnostic HTTP façade over Angular {@link HttpClient}.
978
+ */
973
979
  class ApiClient {
974
980
  http = inject(HttpClient);
975
981
  config = inject(AFRICANIES_SDK_CONFIG);
@@ -1295,6 +1301,9 @@ function resolveModeRegionConfig(config, mode, countryCode) {
1295
1301
  * }
1296
1302
  * ```
1297
1303
  */
1304
+ /**
1305
+ * Source of truth for region currency and measurement units (STN / SFN).
1306
+ */
1298
1307
  class ModeConfigService {
1299
1308
  api = inject(ApiClient);
1300
1309
  storage = inject(STORAGE_TOKEN);
@@ -1456,6 +1465,9 @@ const AUTH_FORGOT_PASSWORD_PATH = '/auth/forgot/password';
1456
1465
  * });
1457
1466
  * ```
1458
1467
  */
1468
+ /**
1469
+ * Unauthenticated auth endpoints (`POST /auth/…`).
1470
+ */
1459
1471
  class AuthService {
1460
1472
  api = inject(ApiClient);
1461
1473
  /**
@@ -1502,6 +1514,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImpor
1502
1514
  * });
1503
1515
  * ```
1504
1516
  */
1517
+ /**
1518
+ * Holds the bearer access token used by {@link authInterceptor}.
1519
+ */
1505
1520
  class AuthTokenService {
1506
1521
  storage = inject(STORAGE_TOKEN);
1507
1522
  api = inject(ApiClient);
@@ -1914,6 +1929,9 @@ const COUNTRY_CACHE_TTL_MS = 5 * 60_000;
1914
1929
  * countries.readById(1).subscribe((res) => console.log(res.data?.name));
1915
1930
  * ```
1916
1931
  */
1932
+ /**
1933
+ * Public country utility reads (`GET /public/country/read/{id?}`).
1934
+ */
1917
1935
  class CountryService {
1918
1936
  api = inject(ApiClient);
1919
1937
  read(id = null, params) {
@@ -2117,6 +2135,9 @@ const DOCUMENT_CACHE_TTL_MS = 5 * 60_000;
2117
2135
  * });
2118
2136
  * ```
2119
2137
  */
2138
+ /**
2139
+ * Public document catalog reads (`GET /public/document/read/{id?}`).
2140
+ */
2120
2141
  class DocumentService {
2121
2142
  api = inject(ApiClient);
2122
2143
  read(id = null, params) {
@@ -2240,6 +2261,9 @@ const PLAN_CACHE_TTL_MS = 5 * 60_000;
2240
2261
  * });
2241
2262
  * ```
2242
2263
  */
2264
+ /**
2265
+ * Public subscription-plan reads (`GET /public/plan/read/{id?}`).
2266
+ */
2243
2267
  class PlanService {
2244
2268
  api = inject(ApiClient);
2245
2269
  read(id = null, params) {
@@ -2337,6 +2361,9 @@ const SERVICE_CACHE_TTL_MS = 5 * 60_000;
2337
2361
  * services.readById(3).subscribe((res) => console.log(res.data?.name));
2338
2362
  * ```
2339
2363
  */
2364
+ /**
2365
+ * Public subscription-service reads (`GET /public/service/read/{id?}`).
2366
+ */
2340
2367
  class ServiceService {
2341
2368
  api = inject(ApiClient);
2342
2369
  read(id = null, params) {
@@ -2539,6 +2566,9 @@ const CURRENCY_CACHE_TTL_MS = 5 * 60_000;
2539
2566
  * currencies.readById(5).subscribe((res) => console.log(res.data?.name));
2540
2567
  * ```
2541
2568
  */
2569
+ /**
2570
+ * Currency App Settings API (`GET /currency/read/{id?}` plus create / update / delete).
2571
+ */
2542
2572
  class CurrencyService {
2543
2573
  api = inject(ApiClient);
2544
2574
  read(id = null, params) {
@@ -2741,6 +2771,9 @@ const PAYMENT_METHOD_CACHE_TTL_MS = 5 * 60_000;
2741
2771
  * });
2742
2772
  * ```
2743
2773
  */
2774
+ /**
2775
+ * Payment-method App Settings API (`GET /payment_method/read/{id?}` plus update).
2776
+ */
2744
2777
  class PaymentMethodService {
2745
2778
  api = inject(ApiClient);
2746
2779
  read(id = null, params) {
@@ -2944,6 +2977,9 @@ const SHIPMENT_METHOD_CACHE_TTL_MS = 5 * 60_000;
2944
2977
  * methods.readById(12).subscribe((res) => console.log(res.data?.name));
2945
2978
  * ```
2946
2979
  */
2980
+ /**
2981
+ * Shipment method / carrier utility reads (`GET /shipment_method/read/{id?}`).
2982
+ */
2947
2983
  class ShipmentMethodService {
2948
2984
  api = inject(ApiClient);
2949
2985
  read(id = null, params) {
@@ -3085,6 +3121,9 @@ const WAREHOUSE_CACHE_TTL_MS = 5 * 60_000;
3085
3121
  * warehouses.readById(37).subscribe((res) => console.log(res.data?.name));
3086
3122
  * ```
3087
3123
  */
3124
+ /**
3125
+ * Warehouse utility reads (`GET /warehouse/read/{id?}`).
3126
+ */
3088
3127
  class WarehouseService {
3089
3128
  api = inject(ApiClient);
3090
3129
  read(id = null, params) {
@@ -3180,6 +3219,9 @@ const ZONE_CACHE_TTL_MS = 5 * 60_000;
3180
3219
  * zones.readById(1).subscribe((res) => console.log(res.data?.name));
3181
3220
  * ```
3182
3221
  */
3222
+ /**
3223
+ * Zone utility reads (`GET /zone/read/records/{id?}`).
3224
+ */
3183
3225
  class ZoneService {
3184
3226
  api = inject(ApiClient);
3185
3227
  read(id = null, params) {
@@ -3552,6 +3594,9 @@ function mapUser(raw) {
3552
3594
  * });
3553
3595
  * ```
3554
3596
  */
3597
+ /**
3598
+ * Current authenticated user (`GET /user`).
3599
+ */
3555
3600
  class UserService {
3556
3601
  api = inject(ApiClient);
3557
3602
  /**
@@ -3692,6 +3737,9 @@ function mapNotificationInboxItem(notification) {
3692
3737
  * });
3693
3738
  * ```
3694
3739
  */
3740
+ /**
3741
+ * Authenticated user notifications (`GET /user/notifications/read/{id?}`).
3742
+ */
3695
3743
  class NotificationService {
3696
3744
  api = inject(ApiClient);
3697
3745
  read(id = null, params) {
@@ -3957,6 +4005,9 @@ function isLegacyPortalHost(hostname) {
3957
4005
  * });
3958
4006
  * ```
3959
4007
  */
4008
+ /**
4009
+ * File utility reads (`POST /file/read`).
4010
+ */
3960
4011
  class FileService {
3961
4012
  api = inject(ApiClient);
3962
4013
  /**
@@ -4090,6 +4141,9 @@ const PRODUCT_CACHE_TTL_MS = 5 * 60_000;
4090
4141
  * products.readById(6280).subscribe((res) => console.log(res.data?.name));
4091
4142
  * ```
4092
4143
  */
4144
+ /**
4145
+ * Product utility reads (`GET /product/read/{id?}`).
4146
+ */
4093
4147
  class ProductService {
4094
4148
  api = inject(ApiClient);
4095
4149
  read(id = null, params) {
@@ -4228,6 +4282,9 @@ const SDK_FILTER_OPTIONS_SOURCES = new Set([
4228
4282
  * });
4229
4283
  * ```
4230
4284
  */
4285
+ /**
4286
+ * Resolves filter drawer select options from built-in SDK catalog services.
4287
+ */
4231
4288
  class FilterOptionsResolver {
4232
4289
  warehouses = inject(WarehouseService);
4233
4290
  shipmentMethods = inject(ShipmentMethodService);
@@ -4347,6 +4404,9 @@ const OVERLAY_ROUTE_CONFIGS = new InjectionToken('AFRICANIES_OVERLAY_ROUTE_CONFI
4347
4404
  * Modal/drawer implementations live in `@africanies/africanies-ui` and are injected through
4348
4405
  * {@link MODAL_SERVICE} / {@link DRAWER_SERVICE} to avoid a circular dependency.
4349
4406
  */
4407
+ /**
4408
+ * Keeps query-param state in sync with modal/drawer overlays.
4409
+ */
4350
4410
  class RouteOverlayService {
4351
4411
  route = inject(ActivatedRoute);
4352
4412
  router = inject(Router);