@fluentcommerce/fc-connect-sdk 0.1.53 → 0.1.55

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 (495) hide show
  1. package/CHANGELOG.md +30 -2
  2. package/README.md +39 -0
  3. package/dist/cjs/auth/index.d.ts +3 -0
  4. package/dist/cjs/auth/index.js +13 -0
  5. package/dist/cjs/auth/profile-loader.d.ts +18 -0
  6. package/dist/cjs/auth/profile-loader.js +208 -0
  7. package/dist/cjs/client-factory.d.ts +4 -0
  8. package/dist/cjs/client-factory.js +10 -0
  9. package/dist/cjs/clients/fluent-client.js +13 -6
  10. package/dist/cjs/index.d.ts +3 -1
  11. package/dist/cjs/index.js +8 -2
  12. package/dist/cjs/utils/pagination-helpers.js +38 -2
  13. package/dist/cjs/versori/fluent-versori-client.js +11 -5
  14. package/dist/esm/auth/index.d.ts +3 -0
  15. package/dist/esm/auth/index.js +2 -0
  16. package/dist/esm/auth/profile-loader.d.ts +18 -0
  17. package/dist/esm/auth/profile-loader.js +169 -0
  18. package/dist/esm/client-factory.d.ts +4 -0
  19. package/dist/esm/client-factory.js +9 -0
  20. package/dist/esm/clients/fluent-client.js +13 -6
  21. package/dist/esm/index.d.ts +3 -1
  22. package/dist/esm/index.js +2 -1
  23. package/dist/esm/utils/pagination-helpers.js +38 -2
  24. package/dist/esm/versori/fluent-versori-client.js +11 -5
  25. package/dist/tsconfig.esm.tsbuildinfo +1 -1
  26. package/dist/tsconfig.tsbuildinfo +1 -1
  27. package/dist/tsconfig.types.tsbuildinfo +1 -1
  28. package/dist/types/auth/index.d.ts +3 -0
  29. package/dist/types/auth/profile-loader.d.ts +18 -0
  30. package/dist/types/client-factory.d.ts +4 -0
  31. package/dist/types/index.d.ts +3 -1
  32. package/docs/00-START-HERE/EXPORT-VALIDATION.md +158 -158
  33. package/docs/00-START-HERE/cli-analyze-source-structure-guide.md +655 -655
  34. package/docs/00-START-HERE/cli-documentation-index.md +202 -202
  35. package/docs/00-START-HERE/cli-quick-reference.md +252 -252
  36. package/docs/00-START-HERE/decision-tree.md +552 -552
  37. package/docs/00-START-HERE/getting-started.md +1070 -1070
  38. package/docs/00-START-HERE/mapper-quick-decision-guide.md +235 -235
  39. package/docs/00-START-HERE/readme.md +237 -237
  40. package/docs/00-START-HERE/retailerid-configuration.md +404 -404
  41. package/docs/00-START-HERE/sdk-philosophy.md +794 -794
  42. package/docs/00-START-HERE/troubleshooting-quick-reference.md +1086 -1086
  43. package/docs/01-TEMPLATES/faq.md +686 -686
  44. package/docs/01-TEMPLATES/patterns/pattern-templates-guide.md +68 -68
  45. package/docs/01-TEMPLATES/patterns/patterns-csv-schema-validation-and-rejection-report.md +233 -233
  46. package/docs/01-TEMPLATES/patterns/patterns-custom-resolvers.md +407 -407
  47. package/docs/01-TEMPLATES/patterns/patterns-error-handling-retry.md +511 -511
  48. package/docs/01-TEMPLATES/patterns/patterns-field-mapping-universal.md +701 -701
  49. package/docs/01-TEMPLATES/patterns/patterns-large-file-splitting.md +1430 -1430
  50. package/docs/01-TEMPLATES/patterns/patterns-master-data-etl.md +2399 -2399
  51. package/docs/01-TEMPLATES/patterns/patterns-pagination-streaming.md +447 -447
  52. package/docs/01-TEMPLATES/patterns/patterns-state-duplicate-prevention.md +385 -385
  53. package/docs/01-TEMPLATES/readme.md +957 -957
  54. package/docs/01-TEMPLATES/standalone/standalone-asn-inbound-processing.md +1209 -1209
  55. package/docs/01-TEMPLATES/standalone/standalone-graphql-query-export.md +1140 -1140
  56. package/docs/01-TEMPLATES/standalone/standalone-graphql-to-parquet-partitioned-s3.md +432 -432
  57. package/docs/01-TEMPLATES/standalone/standalone-multi-channel-inventory-sync.md +1185 -1185
  58. package/docs/01-TEMPLATES/standalone/standalone-multi-source-aggregation.md +1462 -1462
  59. package/docs/01-TEMPLATES/standalone/standalone-s3-csv-batch-api.md +1390 -1390
  60. package/docs/01-TEMPLATES/standalone/standalone-s3-csv-inventory-to-batch.md +330 -330
  61. package/docs/01-TEMPLATES/standalone/standalone-scripts-guide.md +87 -87
  62. package/docs/01-TEMPLATES/standalone/standalone-sftp-xml-graphql.md +1444 -1444
  63. package/docs/01-TEMPLATES/standalone/standalone-webhook-payload-processing.md +688 -688
  64. package/docs/01-TEMPLATES/versori/business-examples/business-examples-dropship-order-routing.md +193 -193
  65. package/docs/01-TEMPLATES/versori/business-examples/business-examples-graphql-parquet-extraction.md +518 -518
  66. package/docs/01-TEMPLATES/versori/business-examples/business-examples-inter-location-transfers.md +2162 -2162
  67. package/docs/01-TEMPLATES/versori/business-examples/business-examples-pre-order-allocation.md +2226 -2226
  68. package/docs/01-TEMPLATES/versori/business-examples/business-scenarios-guide.md +87 -87
  69. package/docs/01-TEMPLATES/versori/patterns/versori-patterns-connection-validation-pattern.md +656 -656
  70. package/docs/01-TEMPLATES/versori/patterns/versori-patterns-dual-workflow-connector.md +835 -835
  71. package/docs/01-TEMPLATES/versori/patterns/versori-patterns-guide.md +108 -108
  72. package/docs/01-TEMPLATES/versori/patterns/versori-patterns-kv-state-management.md +1533 -1533
  73. package/docs/01-TEMPLATES/versori/patterns/versori-patterns-xml-response-patterns.md +1160 -1160
  74. package/docs/01-TEMPLATES/versori/versori-platform-guide.md +201 -201
  75. package/docs/01-TEMPLATES/versori/webhooks/template-webhook-asn-purchase-order.md +1906 -1906
  76. package/docs/01-TEMPLATES/versori/webhooks/template-webhook-dropship-routing.md +1074 -1074
  77. package/docs/01-TEMPLATES/versori/webhooks/template-webhook-flash-sale-reserve.md +1395 -1395
  78. package/docs/01-TEMPLATES/versori/webhooks/template-webhook-generic-xml-order.md +888 -888
  79. package/docs/01-TEMPLATES/versori/webhooks/template-webhook-payment-gateway-integration.md +2478 -2478
  80. package/docs/01-TEMPLATES/versori/webhooks/template-webhook-rma-returns-comprehensive.md +2240 -2240
  81. package/docs/01-TEMPLATES/versori/webhooks/template-webhook-xml-order-ingestion.md +2029 -2029
  82. package/docs/01-TEMPLATES/versori/webhooks/webhook-templates-guide.md +140 -140
  83. package/docs/01-TEMPLATES/versori/workflows/_examples/sample-data/inventory-mapping.json +20 -20
  84. package/docs/01-TEMPLATES/versori/workflows/_examples/sample-data/products_2025-01-22.csv +11 -11
  85. package/docs/01-TEMPLATES/versori/workflows/_examples/sample-data/sample-data-guide.md +34 -34
  86. package/docs/01-TEMPLATES/versori/workflows/_examples/workflow-examples-guide.md +36 -36
  87. package/docs/01-TEMPLATES/versori/workflows/extraction/extraction-modes-guide.md +1038 -1038
  88. package/docs/01-TEMPLATES/versori/workflows/extraction/extraction-workflows-guide.md +138 -138
  89. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/graphql-extraction-guide.md +63 -63
  90. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-fulfillments-to-sftp-csv.md +2062 -2062
  91. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-fulfillments-to-sftp-xml.md +2294 -2294
  92. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-inventory-positions-to-s3-csv.md +2461 -2461
  93. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-inventory-positions-to-sftp-xml.md +2529 -2529
  94. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-inventory-quantities-to-s3-csv.md +2464 -2464
  95. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-inventory-quantities-to-s3-json.md +1959 -1959
  96. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-orders-to-s3-csv.md +1953 -1953
  97. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-orders-to-sftp-xml.md +2541 -2541
  98. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-products-to-s3-json.md +2384 -2384
  99. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-products-to-sftp-xml.md +2445 -2445
  100. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-virtual-positions-to-s3-csv.md +2355 -2355
  101. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-virtual-positions-to-s3-json.md +2042 -2042
  102. package/docs/01-TEMPLATES/versori/workflows/extraction/graphql-queries/template-extraction-virtual-positions-to-sftp-xml.md +2726 -2726
  103. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/batch-api-guide.md +206 -206
  104. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-cycle-count-reconciliation.md +2030 -2030
  105. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-multi-channel-inventory-sync.md +1882 -1882
  106. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-s3-csv-inventory-batch.md +2827 -2827
  107. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-s3-json-inventory-batch.md +1952 -1952
  108. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-s3-xml-inventory-batch.md +3289 -3289
  109. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-sftp-csv-inventory-batch.md +3064 -3064
  110. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-sftp-json-inventory-batch.md +3238 -3238
  111. package/docs/01-TEMPLATES/versori/workflows/ingestion/batch-api/template-ingestion-sftp-xml-inventory-batch.md +2977 -2977
  112. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/event-api-guide.md +321 -321
  113. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-payload-json-order-cancel-event.md +959 -959
  114. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-payload-xml-order-cancel-event.md +1170 -1170
  115. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-s3-csv-product-event.md +2312 -2312
  116. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-s3-json-product-event.md +2999 -2999
  117. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-s3-parquet-product-event.md +2836 -2836
  118. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-s3-xml-product-event.md +2395 -2395
  119. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-sftp-csv-product-event.md +2295 -2295
  120. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-sftp-json-product-event.md +2602 -2602
  121. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-sftp-parquet-product-event.md +2589 -2589
  122. package/docs/01-TEMPLATES/versori/workflows/ingestion/event-api/template-ingestion-sftp-xml-product-event.md +3578 -3578
  123. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/graphql-mutations-guide.md +93 -93
  124. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-payload-json-order-update-graphql.md +1260 -1260
  125. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-payload-xml-order-update-graphql.md +1472 -1472
  126. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-s3-csv-control-graphql.md +2417 -2417
  127. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-s3-csv-location-graphql.md +2811 -2811
  128. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-s3-csv-price-graphql.md +2619 -2619
  129. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-s3-json-location-graphql.md +2807 -2807
  130. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-s3-xml-location-graphql.md +2373 -2373
  131. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-sftp-csv-control-graphql.md +2740 -2740
  132. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-sftp-csv-location-graphql.md +2760 -2760
  133. package/docs/01-TEMPLATES/versori/workflows/ingestion/graphql-mutations/template-ingestion-sftp-json-location-graphql.md +1710 -1710
  134. package/docs/01-TEMPLATES/versori/workflows/ingestion/ingestion-workflows-guide.md +136 -136
  135. package/docs/01-TEMPLATES/versori/workflows/rubix-webhooks/rubix-webhooks-guide.md +520 -520
  136. package/docs/01-TEMPLATES/versori/workflows/rubix-webhooks/template-webhook-rubix-fulfilment-to-sftp-xml-inline.md +1418 -1418
  137. package/docs/01-TEMPLATES/versori/workflows/rubix-webhooks/template-webhook-rubix-fulfilment-to-sftp-xml-universal-mapper.md +1785 -1785
  138. package/docs/01-TEMPLATES/versori/workflows/rubix-webhooks/template-webhook-rubix-order-attribute-update.md +824 -824
  139. package/docs/01-TEMPLATES/versori/workflows/workflows-overview-guide.md +646 -646
  140. package/docs/02-CORE-GUIDES/advanced-services/advanced-services-batch-archival.md +724 -724
  141. package/docs/02-CORE-GUIDES/advanced-services/advanced-services-job-tracker.md +627 -627
  142. package/docs/02-CORE-GUIDES/advanced-services/advanced-services-partial-batch-recovery.md +561 -561
  143. package/docs/02-CORE-GUIDES/advanced-services/advanced-services-quick-reference.md +367 -367
  144. package/docs/02-CORE-GUIDES/advanced-services/advanced-services-readme.md +407 -407
  145. package/docs/02-CORE-GUIDES/advanced-services/readme.md +49 -49
  146. package/docs/02-CORE-GUIDES/api-reference/api-reference-quick-reference.md +548 -548
  147. package/docs/02-CORE-GUIDES/api-reference/event-api-input-output-reference.md +702 -1171
  148. package/docs/02-CORE-GUIDES/api-reference/examples/client-initialization.ts +286 -286
  149. package/docs/02-CORE-GUIDES/api-reference/graphql-error-classification.md +337 -337
  150. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-01-client-api.md +399 -482
  151. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-03-authentication.md +199 -199
  152. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-04-graphql-mapping.md +925 -925
  153. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-05-services.md +1198 -1198
  154. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-06-data-sources.md +1083 -1083
  155. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-07-parsers.md +1097 -1097
  156. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-08-pagination.md +513 -513
  157. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-08-types.md +545 -597
  158. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-09-error-handling.md +527 -527
  159. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-09-webhook-validation.md +514 -514
  160. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-10-extraction.md +557 -557
  161. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-10-utilities.md +412 -412
  162. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-11-cli-tools.md +423 -423
  163. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-11-error-handling.md +716 -716
  164. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-12-analyze-source-structure.md +518 -518
  165. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-12-partial-responses.md +212 -212
  166. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-12-testing.md +300 -300
  167. package/docs/02-CORE-GUIDES/api-reference/modules/api-reference-13-resolver-builder.md +322 -322
  168. package/docs/02-CORE-GUIDES/api-reference/readme.md +279 -279
  169. package/docs/02-CORE-GUIDES/auto-pagination/auto-pagination-quick-reference.md +351 -351
  170. package/docs/02-CORE-GUIDES/auto-pagination/auto-pagination-readme.md +277 -277
  171. package/docs/02-CORE-GUIDES/auto-pagination/examples/auto-pagination-readme.md +178 -178
  172. package/docs/02-CORE-GUIDES/auto-pagination/examples/common-patterns.ts +351 -351
  173. package/docs/02-CORE-GUIDES/auto-pagination/examples/paginate-products.ts +384 -384
  174. package/docs/02-CORE-GUIDES/auto-pagination/examples/paginate-virtual-positions.ts +308 -308
  175. package/docs/02-CORE-GUIDES/auto-pagination/modules/auto-pagination-01-foundations.md +470 -470
  176. package/docs/02-CORE-GUIDES/auto-pagination/modules/auto-pagination-02-quick-start.md +713 -713
  177. package/docs/02-CORE-GUIDES/auto-pagination/modules/auto-pagination-03-configuration.md +754 -754
  178. package/docs/02-CORE-GUIDES/auto-pagination/modules/auto-pagination-04-advanced-patterns.md +732 -732
  179. package/docs/02-CORE-GUIDES/auto-pagination/modules/auto-pagination-05-sdk-integration.md +847 -847
  180. package/docs/02-CORE-GUIDES/auto-pagination/modules/auto-pagination-06-troubleshooting.md +359 -359
  181. package/docs/02-CORE-GUIDES/auto-pagination/modules/auto-pagination-07-api-reference.md +462 -462
  182. package/docs/02-CORE-GUIDES/auto-pagination/readme.md +54 -54
  183. package/docs/02-CORE-GUIDES/data-sources/data-sources-file-operations-error-handling.md +1487 -1487
  184. package/docs/02-CORE-GUIDES/data-sources/data-sources-quick-reference.md +836 -836
  185. package/docs/02-CORE-GUIDES/data-sources/data-sources-readme.md +276 -276
  186. package/docs/02-CORE-GUIDES/data-sources/data-sources-sftp-credential-access-security.md +553 -553
  187. package/docs/02-CORE-GUIDES/data-sources/examples/common-patterns.ts +409 -409
  188. package/docs/02-CORE-GUIDES/data-sources/examples/data-sources-readme.md +178 -178
  189. package/docs/02-CORE-GUIDES/data-sources/examples/s3-operations.ts +308 -308
  190. package/docs/02-CORE-GUIDES/data-sources/examples/sftp-operations.ts +371 -371
  191. package/docs/02-CORE-GUIDES/data-sources/modules/data-sources-01-foundations.md +735 -735
  192. package/docs/02-CORE-GUIDES/data-sources/modules/data-sources-02-s3-operations.md +1302 -1302
  193. package/docs/02-CORE-GUIDES/data-sources/modules/data-sources-03-sftp-operations.md +1379 -1379
  194. package/docs/02-CORE-GUIDES/data-sources/modules/data-sources-04-file-patterns.md +941 -941
  195. package/docs/02-CORE-GUIDES/data-sources/modules/data-sources-05-advanced-topics.md +813 -813
  196. package/docs/02-CORE-GUIDES/data-sources/modules/data-sources-06-integration-patterns.md +486 -486
  197. package/docs/02-CORE-GUIDES/data-sources/modules/data-sources-07-troubleshooting.md +387 -387
  198. package/docs/02-CORE-GUIDES/data-sources/modules/data-sources-08-api-reference.md +417 -417
  199. package/docs/02-CORE-GUIDES/data-sources/readme.md +77 -77
  200. package/docs/02-CORE-GUIDES/error-handling-guide.md +936 -936
  201. package/docs/02-CORE-GUIDES/extraction/examples/02-core-guides-extraction-readme.md +116 -116
  202. package/docs/02-CORE-GUIDES/extraction/examples/common-patterns.ts +428 -428
  203. package/docs/02-CORE-GUIDES/extraction/examples/extract-inventory-basic.ts +187 -187
  204. package/docs/02-CORE-GUIDES/extraction/extraction-quick-reference.md +596 -596
  205. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-01-foundations.md +514 -514
  206. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-02-basic-extraction.md +823 -823
  207. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-03-parquet-processing.md +507 -507
  208. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-04-data-enrichment.md +546 -546
  209. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-05-transformation.md +494 -494
  210. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-06-export-formats.md +458 -458
  211. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-06-performance.md +138 -138
  212. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-07-api-reference.md +148 -148
  213. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-07-optimization.md +692 -692
  214. package/docs/02-CORE-GUIDES/extraction/modules/02-core-guides-extraction-08-extraction-orchestrator.md +1008 -1008
  215. package/docs/02-CORE-GUIDES/extraction/readme.md +151 -151
  216. package/docs/02-CORE-GUIDES/ingestion/examples/_simple-kv-store.ts +40 -40
  217. package/docs/02-CORE-GUIDES/ingestion/examples/error-recovery.ts +728 -728
  218. package/docs/02-CORE-GUIDES/ingestion/examples/event-driven.ts +501 -501
  219. package/docs/02-CORE-GUIDES/ingestion/examples/local-file-ingestion.ts +88 -88
  220. package/docs/02-CORE-GUIDES/ingestion/examples/parquet-ingestion.ts +117 -117
  221. package/docs/02-CORE-GUIDES/ingestion/examples/performance-optimized.ts +647 -647
  222. package/docs/02-CORE-GUIDES/ingestion/examples/s3-csv-ingestion.ts +169 -169
  223. package/docs/02-CORE-GUIDES/ingestion/examples/sftp-csv-ingestion.ts +134 -134
  224. package/docs/02-CORE-GUIDES/ingestion/ingestion-quick-reference.md +546 -546
  225. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-01-introduction.md +626 -626
  226. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-02-quick-start.md +658 -658
  227. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-03-data-sources.md +1052 -1052
  228. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-04-field-mapping.md +763 -763
  229. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-05-advanced-parsers.md +676 -676
  230. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-06-batch-api.md +1295 -1295
  231. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-07-api-reference.md +138 -138
  232. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-07-state-management.md +1037 -1037
  233. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-08-performance-optimization.md +1349 -1349
  234. package/docs/02-CORE-GUIDES/ingestion/modules/02-core-guides-ingestion-09-best-practices.md +1893 -1893
  235. package/docs/02-CORE-GUIDES/ingestion/readme.md +160 -160
  236. package/docs/02-CORE-GUIDES/logging-guide.md +585 -585
  237. package/docs/02-CORE-GUIDES/mapping/error-handling-patterns.md +401 -401
  238. package/docs/02-CORE-GUIDES/mapping/examples/02-core-guides-mapping-readme.md +128 -128
  239. package/docs/02-CORE-GUIDES/mapping/examples/common-patterns.ts +273 -273
  240. package/docs/02-CORE-GUIDES/mapping/examples/csv-location-ingestion.json +36 -36
  241. package/docs/02-CORE-GUIDES/mapping/examples/csv-mapping.ts +242 -242
  242. package/docs/02-CORE-GUIDES/mapping/examples/graphql-to-parquet-extraction.json +36 -36
  243. package/docs/02-CORE-GUIDES/mapping/examples/json-mapping.ts +213 -213
  244. package/docs/02-CORE-GUIDES/mapping/examples/json-product-to-mutation.json +48 -48
  245. package/docs/02-CORE-GUIDES/mapping/examples/xml-mapping.ts +291 -291
  246. package/docs/02-CORE-GUIDES/mapping/examples/xml-order-to-mutation.json +45 -45
  247. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/graphql-mutation-mapping-quick-reference.md +463 -463
  248. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/graphql-mutation-mapping-readme.md +227 -227
  249. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-01-introduction.md +222 -222
  250. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-02-quick-start.md +351 -351
  251. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-03-schema-validation.md +569 -569
  252. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-04-mapping-patterns.md +471 -471
  253. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-05-configuration-reference.md +611 -611
  254. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-06-advanced-xpath.md +148 -148
  255. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-06-path-syntax.md +464 -464
  256. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-07-api-reference.md +94 -94
  257. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-07-array-handling.md +307 -307
  258. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-08-custom-resolvers.md +544 -544
  259. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-09-advanced-patterns.md +427 -427
  260. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-10-hooks-and-variables.md +336 -336
  261. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-11-error-handling.md +488 -488
  262. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-12-arguments-vs-nodes.md +383 -383
  263. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/modules/graphql-mutation-mapping-13-best-practices.md +477 -477
  264. package/docs/02-CORE-GUIDES/mapping/graphql-mutation-mapping/readme.md +62 -62
  265. package/docs/02-CORE-GUIDES/mapping/mapping-format-decision-tree.md +480 -480
  266. package/docs/02-CORE-GUIDES/mapping/mapping-graphql-alias-batching-guide.md +820 -820
  267. package/docs/02-CORE-GUIDES/mapping/mapping-javascript-objects.md +2369 -2369
  268. package/docs/02-CORE-GUIDES/mapping/mapping-mapper-comparison-guide.md +682 -682
  269. package/docs/02-CORE-GUIDES/mapping/modules/02-core-guides-mapping-07-api-reference.md +1327 -1327
  270. package/docs/02-CORE-GUIDES/mapping/modules/02-core-guides-mapping-08-error-handling.md +1142 -1142
  271. package/docs/02-CORE-GUIDES/mapping/modules/mapping-04-use-cases.md +891 -891
  272. package/docs/02-CORE-GUIDES/mapping/modules/mapping-06-helpers-resolvers.md +1126 -1126
  273. package/docs/02-CORE-GUIDES/mapping/modules/mapping-06-sdk-resolvers.md +199 -199
  274. package/docs/02-CORE-GUIDES/mapping/modules/mapping-07-api-reference.md +1319 -1319
  275. package/docs/02-CORE-GUIDES/mapping/readme.md +178 -178
  276. package/docs/02-CORE-GUIDES/mapping/resolver-registration.md +410 -410
  277. package/docs/02-CORE-GUIDES/mapping/resolvers/examples/common-patterns.ts +226 -226
  278. package/docs/02-CORE-GUIDES/mapping/resolvers/examples/custom-resolvers.ts +227 -227
  279. package/docs/02-CORE-GUIDES/mapping/resolvers/examples/sdk-resolvers-usage.ts +203 -203
  280. package/docs/02-CORE-GUIDES/mapping/resolvers/mapping-resolvers-readme.md +274 -274
  281. package/docs/02-CORE-GUIDES/mapping/resolvers/mapping-resolvers-resolver-api-reference.md +679 -679
  282. package/docs/02-CORE-GUIDES/mapping/resolvers/mapping-resolvers-resolver-cookbook.md +826 -826
  283. package/docs/02-CORE-GUIDES/mapping/resolvers/mapping-resolvers-resolver-guide.md +1330 -1330
  284. package/docs/02-CORE-GUIDES/mapping/resolvers/mapping-resolvers-resolver-helpers-reference.md +1437 -1437
  285. package/docs/02-CORE-GUIDES/mapping/resolvers/mapping-resolvers-resolver-parameters-reference.md +553 -553
  286. package/docs/02-CORE-GUIDES/mapping/resolvers/mapping-resolvers-resolver-troubleshooting.md +854 -854
  287. package/docs/02-CORE-GUIDES/mapping/resolvers/readme.md +75 -75
  288. package/docs/02-CORE-GUIDES/parsers/examples/02-core-guides-parsers-readme.md +161 -161
  289. package/docs/02-CORE-GUIDES/parsers/examples/csv-parser-examples.ts +110 -110
  290. package/docs/02-CORE-GUIDES/parsers/examples/json-parser-examples.ts +33 -33
  291. package/docs/02-CORE-GUIDES/parsers/examples/parquet-parser-examples.ts +47 -47
  292. package/docs/02-CORE-GUIDES/parsers/examples/xml-parser-examples.ts +38 -38
  293. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-01-foundations.md +355 -355
  294. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-02-csv-parser.md +772 -772
  295. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-03-json-parser.md +789 -789
  296. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-04-xml-parser.md +857 -857
  297. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-05-parquet-parser.md +603 -603
  298. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-06-integration-patterns.md +702 -702
  299. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-06-streaming.md +121 -121
  300. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-07-api-reference.md +89 -89
  301. package/docs/02-CORE-GUIDES/parsers/modules/02-core-guides-parsers-07-troubleshooting.md +727 -727
  302. package/docs/02-CORE-GUIDES/parsers/parsers-quick-reference.md +482 -482
  303. package/docs/02-CORE-GUIDES/parsers/parsers-readme.md +258 -258
  304. package/docs/02-CORE-GUIDES/parsers/readme.md +65 -65
  305. package/docs/02-CORE-GUIDES/readme.md +194 -194
  306. package/docs/02-CORE-GUIDES/webhook-validation/examples/basic-validation.ts +108 -108
  307. package/docs/02-CORE-GUIDES/webhook-validation/examples/common-patterns.ts +316 -316
  308. package/docs/02-CORE-GUIDES/webhook-validation/examples/webhook-validation-readme.md +61 -61
  309. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-01-foundations.md +440 -440
  310. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-02-quick-start.md +525 -525
  311. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-03-versori-integration.md +741 -741
  312. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-04-platform-integration.md +629 -629
  313. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-05-configuration.md +535 -535
  314. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-06-error-handling.md +611 -611
  315. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-06-troubleshooting.md +124 -124
  316. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-07-api-reference.md +511 -511
  317. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-08-rubix-webhooks.md +590 -590
  318. package/docs/02-CORE-GUIDES/webhook-validation/modules/webhook-validation-09-rubix-event-vs-http-call.md +432 -432
  319. package/docs/02-CORE-GUIDES/webhook-validation/readme.md +239 -239
  320. package/docs/02-CORE-GUIDES/webhook-validation/webhook-validation-quick-reference.md +392 -392
  321. package/docs/03-PATTERN-GUIDES/connector-scenarios/connector-scenarios-quick-reference.md +498 -498
  322. package/docs/03-PATTERN-GUIDES/connector-scenarios/connector-scenarios-readme.md +313 -313
  323. package/docs/03-PATTERN-GUIDES/connector-scenarios/examples/common-patterns.ts +612 -612
  324. package/docs/03-PATTERN-GUIDES/connector-scenarios/examples/connector-scenarios-readme.md +253 -253
  325. package/docs/03-PATTERN-GUIDES/connector-scenarios/modules/connector-scenarios-01-foundations.md +452 -452
  326. package/docs/03-PATTERN-GUIDES/connector-scenarios/modules/connector-scenarios-02-simple-scenarios.md +681 -681
  327. package/docs/03-PATTERN-GUIDES/connector-scenarios/modules/connector-scenarios-03-intermediate-scenarios.md +637 -637
  328. package/docs/03-PATTERN-GUIDES/connector-scenarios/modules/connector-scenarios-04-advanced-scenarios.md +650 -650
  329. package/docs/03-PATTERN-GUIDES/connector-scenarios/modules/connector-scenarios-05-bidirectional-sync.md +233 -233
  330. package/docs/03-PATTERN-GUIDES/connector-scenarios/modules/connector-scenarios-06-production-patterns.md +442 -442
  331. package/docs/03-PATTERN-GUIDES/connector-scenarios/modules/connector-scenarios-07-reference.md +445 -445
  332. package/docs/03-PATTERN-GUIDES/connector-scenarios/readme.md +31 -31
  333. package/docs/03-PATTERN-GUIDES/enterprise-integration-patterns.md +1528 -1528
  334. package/docs/03-PATTERN-GUIDES/error-handling/comprehensive-error-handling-guide.md +1437 -1437
  335. package/docs/03-PATTERN-GUIDES/error-handling/error-handling-quick-reference.md +390 -390
  336. package/docs/03-PATTERN-GUIDES/error-handling/examples/common-patterns.ts +438 -438
  337. package/docs/03-PATTERN-GUIDES/error-handling/modules/error-handling-01-foundations.md +362 -362
  338. package/docs/03-PATTERN-GUIDES/error-handling/modules/error-handling-02-error-types.md +850 -850
  339. package/docs/03-PATTERN-GUIDES/error-handling/modules/error-handling-03-utf8-handling.md +456 -456
  340. package/docs/03-PATTERN-GUIDES/error-handling/modules/error-handling-04-error-scenarios.md +658 -658
  341. package/docs/03-PATTERN-GUIDES/error-handling/modules/error-handling-05-calling-patterns.md +671 -671
  342. package/docs/03-PATTERN-GUIDES/error-handling/modules/error-handling-06-retry-strategies.md +1034 -1034
  343. package/docs/03-PATTERN-GUIDES/error-handling/modules/error-handling-07-monitoring.md +653 -653
  344. package/docs/03-PATTERN-GUIDES/error-handling/modules/error-handling-08-api-reference.md +847 -847
  345. package/docs/03-PATTERN-GUIDES/error-handling/readme.md +36 -36
  346. package/docs/03-PATTERN-GUIDES/examples/__tests__/readme.md +40 -40
  347. package/docs/03-PATTERN-GUIDES/examples/__tests__/resolver-examples.test.js +282 -282
  348. package/docs/03-PATTERN-GUIDES/examples/test-data/03-pattern-guides-readme.md +110 -110
  349. package/docs/03-PATTERN-GUIDES/examples/test-data/canonical-inventory.json +123 -123
  350. package/docs/03-PATTERN-GUIDES/examples/test-data/canonical-order.json +171 -171
  351. package/docs/03-PATTERN-GUIDES/examples/test-data/readme.md +28 -28
  352. package/docs/03-PATTERN-GUIDES/extraction/extraction-readme.md +15 -15
  353. package/docs/03-PATTERN-GUIDES/extraction/readme.md +25 -25
  354. package/docs/03-PATTERN-GUIDES/file-operations/examples/common-patterns.ts +407 -407
  355. package/docs/03-PATTERN-GUIDES/file-operations/examples/file-operations-readme.md +142 -142
  356. package/docs/03-PATTERN-GUIDES/file-operations/file-operations-quick-reference.md +462 -462
  357. package/docs/03-PATTERN-GUIDES/file-operations/file-operations-readme.md +379 -379
  358. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-01-foundations.md +430 -430
  359. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-02-quick-start.md +484 -484
  360. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-03-s3-operations.md +507 -507
  361. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-04-sftp-operations.md +963 -963
  362. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-05-streaming-performance.md +503 -503
  363. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-06-archive-patterns.md +386 -386
  364. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-06-error-handling.md +117 -117
  365. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-07-api-reference.md +78 -78
  366. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-07-testing-troubleshooting.md +567 -567
  367. package/docs/03-PATTERN-GUIDES/file-operations/modules/file-operations-08-api-reference.md +1055 -1055
  368. package/docs/03-PATTERN-GUIDES/file-operations/readme.md +32 -32
  369. package/docs/03-PATTERN-GUIDES/ingestion/ingestion-readme.md +15 -15
  370. package/docs/03-PATTERN-GUIDES/ingestion/readme.md +25 -25
  371. package/docs/03-PATTERN-GUIDES/integration-patterns/examples/batch-processing.ts +130 -130
  372. package/docs/03-PATTERN-GUIDES/integration-patterns/examples/common-patterns.ts +360 -360
  373. package/docs/03-PATTERN-GUIDES/integration-patterns/examples/delta-sync.ts +130 -130
  374. package/docs/03-PATTERN-GUIDES/integration-patterns/examples/integration-patterns-readme.md +100 -100
  375. package/docs/03-PATTERN-GUIDES/integration-patterns/examples/real-time-webhook.ts +398 -398
  376. package/docs/03-PATTERN-GUIDES/integration-patterns/integration-patterns-quick-reference.md +962 -962
  377. package/docs/03-PATTERN-GUIDES/integration-patterns/integration-patterns-readme.md +134 -134
  378. package/docs/03-PATTERN-GUIDES/integration-patterns/modules/integration-patterns-01-real-time-processing.md +991 -991
  379. package/docs/03-PATTERN-GUIDES/integration-patterns/modules/integration-patterns-02-batch-processing.md +1547 -1547
  380. package/docs/03-PATTERN-GUIDES/integration-patterns/modules/integration-patterns-03-delta-sync.md +1108 -1108
  381. package/docs/03-PATTERN-GUIDES/integration-patterns/modules/integration-patterns-04-webhook-patterns.md +1181 -1181
  382. package/docs/03-PATTERN-GUIDES/integration-patterns/modules/integration-patterns-05-error-handling.md +1061 -1061
  383. package/docs/03-PATTERN-GUIDES/integration-patterns/modules/integration-patterns-06-advanced-integration-services.md +1547 -1547
  384. package/docs/03-PATTERN-GUIDES/integration-patterns/modules/integration-patterns-06-performance.md +109 -109
  385. package/docs/03-PATTERN-GUIDES/integration-patterns/modules/integration-patterns-07-api-reference.md +34 -34
  386. package/docs/03-PATTERN-GUIDES/integration-patterns/readme.md +30 -30
  387. package/docs/03-PATTERN-GUIDES/logging-minimal-mode.md +128 -128
  388. package/docs/03-PATTERN-GUIDES/multiple-connections/examples/common-patterns.ts +380 -380
  389. package/docs/03-PATTERN-GUIDES/multiple-connections/examples/multiple-connections-readme.md +139 -139
  390. package/docs/03-PATTERN-GUIDES/multiple-connections/examples/parallel-root-connections.ts +149 -149
  391. package/docs/03-PATTERN-GUIDES/multiple-connections/examples/real-world-scenarios.ts +405 -405
  392. package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-01-foundations.md +378 -378
  393. package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-02-quick-start.md +566 -566
  394. package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-03-targeting-connections.md +659 -659
  395. package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-04-parallel-queries.md +656 -656
  396. package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-05-best-practices.md +624 -624
  397. package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-06-api-reference.md +824 -824
  398. package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-06-versori.md +119 -119
  399. package/docs/03-PATTERN-GUIDES/multiple-connections/modules/multiple-connections-07-api-reference.md +87 -87
  400. package/docs/03-PATTERN-GUIDES/multiple-connections/multiple-connections-quick-reference.md +353 -353
  401. package/docs/03-PATTERN-GUIDES/multiple-connections/multiple-connections-readme.md +270 -270
  402. package/docs/03-PATTERN-GUIDES/multiple-connections/readme.md +30 -30
  403. package/docs/03-PATTERN-GUIDES/pagination/pagination-readme.md +14 -14
  404. package/docs/03-PATTERN-GUIDES/pagination/readme.md +24 -24
  405. package/docs/03-PATTERN-GUIDES/parquet/examples/common-patterns.ts +180 -180
  406. package/docs/03-PATTERN-GUIDES/parquet/examples/read-parquet.ts +48 -48
  407. package/docs/03-PATTERN-GUIDES/parquet/examples/write-parquet.ts +65 -65
  408. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-01-introduction.md +393 -393
  409. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-02-quick-start.md +572 -572
  410. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-03-reading-parquet.md +525 -525
  411. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-04-writing-parquet.md +554 -554
  412. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-05-graphql-extraction.md +405 -405
  413. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-06-performance.md +104 -104
  414. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-06-s3-integration.md +511 -511
  415. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-07-api-reference.md +90 -90
  416. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-07-performance-optimization.md +525 -525
  417. package/docs/03-PATTERN-GUIDES/parquet/modules/03-pattern-guides-parquet-08-best-practices.md +712 -712
  418. package/docs/03-PATTERN-GUIDES/parquet/parquet-quick-reference.md +683 -683
  419. package/docs/03-PATTERN-GUIDES/parquet/parquet-readme.md +248 -248
  420. package/docs/03-PATTERN-GUIDES/parquet/readme.md +32 -32
  421. package/docs/03-PATTERN-GUIDES/parsers/parsers-readme.md +12 -12
  422. package/docs/03-PATTERN-GUIDES/parsers/readme.md +24 -24
  423. package/docs/03-PATTERN-GUIDES/readme.md +159 -159
  424. package/docs/03-PATTERN-GUIDES/webhooks/readme.md +24 -24
  425. package/docs/03-PATTERN-GUIDES/webhooks/webhooks-readme.md +8 -8
  426. package/docs/04-REFERENCE/architecture/architecture-01-overview.md +427 -427
  427. package/docs/04-REFERENCE/architecture/architecture-02-client-architecture.md +424 -424
  428. package/docs/04-REFERENCE/architecture/architecture-03-data-flow.md +690 -690
  429. package/docs/04-REFERENCE/architecture/architecture-04-service-layer.md +834 -834
  430. package/docs/04-REFERENCE/architecture/architecture-05-integration-architecture.md +655 -655
  431. package/docs/04-REFERENCE/architecture/architecture-06-state-management.md +653 -653
  432. package/docs/04-REFERENCE/architecture/architecture-adding-new-data-sources.md +686 -686
  433. package/docs/04-REFERENCE/architecture/readme.md +279 -279
  434. package/docs/04-REFERENCE/platforms/deno/readme.md +117 -117
  435. package/docs/04-REFERENCE/platforms/nodejs/readme.md +146 -146
  436. package/docs/04-REFERENCE/platforms/readme.md +135 -135
  437. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-01-introduction.md +398 -398
  438. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-02-quick-start.md +560 -560
  439. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-03-authentication.md +757 -757
  440. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-04-workflows.md +2476 -2476
  441. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-05-connections.md +1167 -1167
  442. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-06-kv-storage.md +990 -990
  443. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-06-state-management.md +121 -121
  444. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-07-api-reference.md +68 -68
  445. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-07-deployment.md +731 -731
  446. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-08-best-practices.md +1111 -1111
  447. package/docs/04-REFERENCE/platforms/versori/modules/platforms-versori-09-signature-reference.md +766 -766
  448. package/docs/04-REFERENCE/platforms/versori/platforms-versori-readme.md +299 -299
  449. package/docs/04-REFERENCE/platforms/versori/platforms-versori-s3-sftp-configuration-guide.md +1425 -1425
  450. package/docs/04-REFERENCE/platforms/versori/platforms-versori-webhook-api-key-security.md +816 -816
  451. package/docs/04-REFERENCE/platforms/versori/platforms-versori-webhook-connection-security.md +681 -681
  452. package/docs/04-REFERENCE/platforms/versori/platforms-versori-workflow-task-types.md +708 -708
  453. package/docs/04-REFERENCE/platforms/versori/readme.md +108 -108
  454. package/docs/04-REFERENCE/readme.md +148 -148
  455. package/docs/04-REFERENCE/resolver-signature/examples/advanced-resolvers.ts +482 -482
  456. package/docs/04-REFERENCE/resolver-signature/examples/async-resolvers.ts +496 -496
  457. package/docs/04-REFERENCE/resolver-signature/examples/basic-resolvers.ts +343 -343
  458. package/docs/04-REFERENCE/resolver-signature/examples/resolver-signature-readme.md +188 -188
  459. package/docs/04-REFERENCE/resolver-signature/examples/testing-resolvers.ts +463 -463
  460. package/docs/04-REFERENCE/resolver-signature/modules/resolver-signature-01-foundations.md +286 -286
  461. package/docs/04-REFERENCE/resolver-signature/modules/resolver-signature-02-parameter-reference.md +643 -643
  462. package/docs/04-REFERENCE/resolver-signature/modules/resolver-signature-03-basic-examples.md +521 -521
  463. package/docs/04-REFERENCE/resolver-signature/modules/resolver-signature-04-advanced-patterns.md +739 -739
  464. package/docs/04-REFERENCE/resolver-signature/modules/resolver-signature-05-sdk-resolvers.md +531 -531
  465. package/docs/04-REFERENCE/resolver-signature/modules/resolver-signature-06-migration-guide.md +650 -650
  466. package/docs/04-REFERENCE/resolver-signature/modules/resolver-signature-06-testing.md +125 -125
  467. package/docs/04-REFERENCE/resolver-signature/modules/resolver-signature-07-api-reference.md +794 -794
  468. package/docs/04-REFERENCE/resolver-signature/readme.md +64 -64
  469. package/docs/04-REFERENCE/resolver-signature/resolver-signature-quick-reference.md +270 -270
  470. package/docs/04-REFERENCE/resolver-signature/resolver-signature-readme.md +351 -351
  471. package/docs/04-REFERENCE/schema/fluent-commerce-schema.json +764 -764
  472. package/docs/04-REFERENCE/schema/readme.md +141 -141
  473. package/docs/04-REFERENCE/testing/examples/04-reference-testing-readme.md +158 -158
  474. package/docs/04-REFERENCE/testing/examples/fluent-testing.ts +62 -62
  475. package/docs/04-REFERENCE/testing/examples/health-check.ts +155 -155
  476. package/docs/04-REFERENCE/testing/examples/integration-test.ts +119 -119
  477. package/docs/04-REFERENCE/testing/examples/performance-test.ts +183 -183
  478. package/docs/04-REFERENCE/testing/examples/s3-testing.ts +127 -127
  479. package/docs/04-REFERENCE/testing/modules/04-reference-testing-01-foundations.md +267 -267
  480. package/docs/04-REFERENCE/testing/modules/04-reference-testing-02-s3-testing.md +599 -599
  481. package/docs/04-REFERENCE/testing/modules/04-reference-testing-03-fluent-testing.md +589 -589
  482. package/docs/04-REFERENCE/testing/modules/04-reference-testing-04-integration-testing.md +699 -699
  483. package/docs/04-REFERENCE/testing/modules/04-reference-testing-05-debugging.md +478 -478
  484. package/docs/04-REFERENCE/testing/modules/04-reference-testing-06-cicd-integration.md +463 -463
  485. package/docs/04-REFERENCE/testing/modules/04-reference-testing-06-preflight-validation.md +131 -131
  486. package/docs/04-REFERENCE/testing/modules/04-reference-testing-07-best-practices.md +499 -499
  487. package/docs/04-REFERENCE/testing/modules/04-reference-testing-07-coverage-ci.md +165 -165
  488. package/docs/04-REFERENCE/testing/modules/04-reference-testing-08-api-reference.md +634 -634
  489. package/docs/04-REFERENCE/testing/readme.md +86 -86
  490. package/docs/04-REFERENCE/testing/testing-quick-reference.md +667 -667
  491. package/docs/04-REFERENCE/testing/testing-readme.md +286 -286
  492. package/docs/04-REFERENCE/troubleshooting/readme.md +144 -144
  493. package/docs/04-REFERENCE/troubleshooting/troubleshooting-deno-sftp-compatibility.md +392 -392
  494. package/docs/template-loading-matrix.md +242 -242
  495. package/package.json +5 -3
@@ -1,463 +1,463 @@
1
- # Module 6: CI/CD Integration
2
-
3
- **Level:** Intermediate
4
- **Estimated Time:** 20 minutes
5
-
6
- ## Overview
7
-
8
- This module covers integrating testing utilities into CI/CD pipelines for automated validation.
9
-
10
- ## Learning Objectives
11
-
12
- By the end of this module, you will:
13
- - ✅ Know how to integrate tests into GitHub Actions
14
- - ✅ Understand how to configure test scripts in package.json
15
- - ✅ Be able to set up automated testing workflows
16
- - ✅ Know how to handle secrets and credentials in CI/CD
17
-
18
- ## GitHub Actions Integration
19
-
20
- ### Basic Workflow
21
-
22
- ```yaml
23
- name: Integration Tests
24
-
25
- on:
26
- push:
27
- branches: [main]
28
- pull_request:
29
- branches: [main]
30
-
31
- jobs:
32
- test:
33
- runs-on: ubuntu-latest
34
-
35
- steps:
36
- - uses: actions/checkout@v2
37
-
38
- - name: Setup Node.js
39
- uses: actions/setup-node@v2
40
- with:
41
- node-version: '18'
42
-
43
- - name: Install dependencies
44
- run: npm ci
45
-
46
- - name: Run S3 Tests
47
- env:
48
- AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
49
- AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
50
- TEST_BUCKET: ${{ secrets.TEST_BUCKET }}
51
- run: |
52
- npm run test:s3
53
-
54
- - name: Run Fluent Tests
55
- env:
56
- FLUENT_CLIENT_ID: ${{ secrets.FLUENT_CLIENT_ID }}
57
- FLUENT_CLIENT_SECRET: ${{ secrets.FLUENT_CLIENT_SECRET }}
58
- FLUENT_USERNAME: ${{ secrets.FLUENT_USERNAME }}
59
- FLUENT_PASSWORD: ${{ secrets.FLUENT_PASSWORD }}
60
- run: |
61
- npm run test:fluent
62
-
63
- - name: Run Integration Tests
64
- run: |
65
- npm run test:integration
66
- ```
67
-
68
- ### Advanced Workflow with Matrix
69
-
70
- ```yaml
71
- name: Multi-Environment Tests
72
-
73
- on:
74
- push:
75
- branches: [main, develop]
76
- schedule:
77
- - cron: '0 0 * * *' # Daily at midnight
78
-
79
- jobs:
80
- test:
81
- runs-on: ${{ matrix.os }}
82
- strategy:
83
- matrix:
84
- os: [ubuntu-latest, windows-latest]
85
- node-version: [18, 20]
86
-
87
- steps:
88
- - uses: actions/checkout@v2
89
-
90
- - name: Setup Node.js ${{ matrix.node-version }}
91
- uses: actions/setup-node@v2
92
- with:
93
- node-version: ${{ matrix.node-version }}
94
-
95
- - name: Install dependencies
96
- run: npm ci
97
-
98
- - name: Run Tests
99
- env:
100
- AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
101
- AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
102
- FLUENT_CLIENT_ID: ${{ secrets.FLUENT_CLIENT_ID }}
103
- FLUENT_CLIENT_SECRET: ${{ secrets.FLUENT_CLIENT_SECRET }}
104
- FLUENT_USERNAME: ${{ secrets.FLUENT_USERNAME }}
105
- FLUENT_PASSWORD: ${{ secrets.FLUENT_PASSWORD }}
106
- run: npm run test:all
107
-
108
- - name: Upload Test Results
109
- if: always()
110
- uses: actions/upload-artifact@v2
111
- with:
112
- name: test-results-${{ matrix.os }}-node${{ matrix.node-version }}
113
- path: test-results/
114
- ```
115
-
116
- ## Package.json Test Scripts
117
-
118
- Configure test scripts for easy execution:
119
-
120
- ```json
121
- {
122
- "name": "my-fluent-integration",
123
- "version": "1.0.0",
124
- "scripts": {
125
- "test:s3": "node tests/s3-connectivity.js",
126
- "test:fluent": "node tests/fluent-connectivity.js",
127
- "test:integration": "node tests/integration.js",
128
- "test:all": "npm run test:s3 && npm run test:fluent && npm run test:integration",
129
- "test:watch": "nodemon tests/integration.js",
130
- "test:ci": "npm run test:all -- --ci",
131
- "health": "node tests/health-check.js"
132
- },
133
- "devDependencies": {
134
- "@fluentcommerce/fc-connect-sdk": "^1.0.0",
135
- "nodemon": "^2.0.0"
136
- }
137
- }
138
- ```
139
-
140
- ## Test Script Examples
141
-
142
- ### S3 Connectivity Test Script
143
-
144
- ```typescript
145
- // tests/s3-connectivity.js
146
- import { S3SDKTester } from '@fluentcommerce/fc-connect-sdk';
147
-
148
- async function main() {
149
- const tester = new S3SDKTester({
150
- region: process.env.AWS_REGION || 'us-east-1',
151
- accessKeyId: process.env.AWS_ACCESS_KEY_ID,
152
- secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
153
- });
154
-
155
- console.log('Testing S3 connectivity...');
156
- const testBucket = process.env.TEST_BUCKET;
157
-
158
- if (!testBucket) {
159
- console.error('❌ TEST_BUCKET environment variable not set');
160
- process.exit(1);
161
- }
162
-
163
- const result = await tester.testAll(testBucket);
164
-
165
- if (result.summary.success) {
166
- console.log(`✅ S3 tests passed`);
167
- console.log(` - List: ${result.tests.list.success ? '✅' : '}`);
168
- console.log(` - Write: ${result.tests.write.success ? '✅' : '}`);
169
- console.log(` - Read: ${result.tests.read.success ? '✅' : '}`);
170
- console.log(` - Delete: ${result.tests.delete.success ? '✅' : '}`);
171
- process.exit(0);
172
- } else {
173
- console.error('❌ S3 tests failed:');
174
- Object.entries(result.tests).forEach(([op, res]) => {
175
- if (!res.success) console.error(` - ${op}: ${res.message}`);
176
- });
177
- process.exit(1);
178
- }
179
- }
180
-
181
- main().catch(error => {
182
- console.error('Test error:', error);
183
- process.exit(1);
184
- });
185
- ```
186
-
187
- ### Fluent Connectivity Test Script
188
-
189
- ```typescript
190
- // tests/fluent-connectivity.js
191
- import { FluentConnectionTester, createClient } from '@fluentcommerce/fc-connect-sdk';
192
-
193
- async function main() {
194
- const client = await createClient({
195
- config: {
196
- baseUrl: process.env.FLUENT_BASE_URL,
197
- clientId: process.env.FLUENT_CLIENT_ID,
198
- clientSecret: process.env.FLUENT_CLIENT_SECRET,
199
- username: process.env.FLUENT_USERNAME,
200
- password: process.env.FLUENT_PASSWORD,
201
- retailerId: process.env.FLUENT_RETAILER_ID
202
- }
203
- });
204
-
205
- const tester = new FluentConnectionTester(client, {
206
- logger: console
207
- });
208
-
209
- console.log('Testing Fluent API connectivity...');
210
- const result = await tester.testConnection();
211
-
212
- if (result.success) {
213
- console.log(`✅ Fluent connection verified (${result.duration}ms)`);
214
- console.log(` User: ${result.details?.username || 'authenticated'}`);
215
- process.exit(0);
216
- } else {
217
- console.error('❌ Fluent connection failed:');
218
- console.error(` ${result.message}`);
219
- process.exit(1);
220
- }
221
- }
222
-
223
- main().catch(error => {
224
- console.error('Test error:', error);
225
- process.exit(1);
226
- });
227
- ```
228
-
229
- ### Integration Test Script
230
-
231
- ```typescript
232
- // tests/integration.js
233
- import {
234
- S3SDKTester,
235
- FluentConnectionTester,
236
- createClient
237
- } from '@fluentcommerce/fc-connect-sdk';
238
-
239
- async function main() {
240
- console.log('Running integration tests...\n');
241
-
242
- const testBucket = process.env.TEST_BUCKET;
243
- if (!testBucket) {
244
- console.error('❌ TEST_BUCKET environment variable not set');
245
- process.exit(1);
246
- }
247
-
248
- // Test S3
249
- console.log('1. Testing S3...');
250
- const s3Tester = new S3SDKTester({
251
- region: process.env.AWS_REGION || 'us-east-1',
252
- accessKeyId: process.env.AWS_ACCESS_KEY_ID,
253
- secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
254
- });
255
-
256
- const s3Result = await s3Tester.testAll(testBucket);
257
- console.log(` S3: ${s3Result.summary.success ? '✅' : '}`);
258
-
259
- if (!s3Result.summary.success) {
260
- console.error(' S3 tests failed - aborting');
261
- process.exit(1);
262
- }
263
-
264
- // Test Fluent
265
- console.log('2. Testing Fluent API...');
266
- const client = await createClient({
267
- config: {
268
- baseUrl: process.env.FLUENT_BASE_URL,
269
- clientId: process.env.FLUENT_CLIENT_ID,
270
- clientSecret: process.env.FLUENT_CLIENT_SECRET,
271
- username: process.env.FLUENT_USERNAME,
272
- password: process.env.FLUENT_PASSWORD,
273
- retailerId: process.env.FLUENT_RETAILER_ID
274
- }
275
- });
276
-
277
- const fluentTester = new FluentConnectionTester(client, {
278
- logger: console
279
- });
280
-
281
- const fluentResult = await fluentTester.testConnection();
282
- console.log(` Fluent: ${fluentResult.success ? '✅' : '}`);
283
-
284
- if (!fluentResult.success) {
285
- console.error(' Fluent connection test failed - aborting');
286
- process.exit(1);
287
- }
288
-
289
- console.log('\n✅ All integration tests passed!');
290
- process.exit(0);
291
- }
292
-
293
- main().catch(error => {
294
- console.error('Integration test error:', error);
295
- process.exit(1);
296
- });
297
- ```
298
-
299
- ## Environment Variables Management
300
-
301
- ### .env.example Template
302
-
303
- ```bash
304
- # AWS Credentials
305
- AWS_ACCESS_KEY_ID=your-access-key-id
306
- AWS_SECRET_ACCESS_KEY=your-secret-access-key
307
- AWS_REGION=us-east-1
308
- TEST_BUCKET=your-test-bucket
309
-
310
- # Fluent Commerce Credentials
311
- FLUENT_BASE_URL=https://api.fluentcommerce.com
312
- FLUENT_CLIENT_ID=your-client-id
313
- FLUENT_CLIENT_SECRET=your-client-secret
314
- FLUENT_USERNAME=your-username
315
- FLUENT_PASSWORD=your-password
316
- FLUENT_RETAILER_ID=1
317
- ```
318
-
319
- ### GitHub Secrets Configuration
320
-
321
- Add these secrets in GitHub repository settings:
322
-
323
- ```
324
- AWS_ACCESS_KEY_ID
325
- AWS_SECRET_ACCESS_KEY
326
- AWS_REGION
327
- TEST_BUCKET
328
- FLUENT_BASE_URL
329
- FLUENT_CLIENT_ID
330
- FLUENT_CLIENT_SECRET
331
- FLUENT_USERNAME
332
- FLUENT_PASSWORD
333
- FLUENT_RETAILER_ID
334
- ```
335
-
336
- ## Scheduled Testing
337
-
338
- Run tests on a schedule to catch issues early:
339
-
340
- ```yaml
341
- name: Scheduled Tests
342
-
343
- on:
344
- schedule:
345
- # Run every 6 hours
346
- - cron: '0 */6 * * *'
347
- workflow_dispatch: # Allow manual trigger
348
-
349
- jobs:
350
- scheduled-test:
351
- runs-on: ubuntu-latest
352
-
353
- steps:
354
- - uses: actions/checkout@v2
355
-
356
- - name: Setup Node.js
357
- uses: actions/setup-node@v2
358
- with:
359
- node-version: '18'
360
-
361
- - name: Install dependencies
362
- run: npm ci
363
-
364
- - name: Run Tests
365
- env:
366
- AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
367
- AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
368
- FLUENT_CLIENT_ID: ${{ secrets.FLUENT_CLIENT_ID }}
369
- FLUENT_CLIENT_SECRET: ${{ secrets.FLUENT_CLIENT_SECRET }}
370
- FLUENT_USERNAME: ${{ secrets.FLUENT_USERNAME }}
371
- FLUENT_PASSWORD: ${{ secrets.FLUENT_PASSWORD }}
372
- run: npm run test:all
373
-
374
- - name: Notify on Failure
375
- if: failure()
376
- uses: actions/github-script@v5
377
- with:
378
- script: |
379
- github.rest.issues.create({
380
- owner: context.repo.owner,
381
- repo: context.repo.repo,
382
- title: 'Scheduled Test Failure',
383
- body: 'Automated tests failed. Please investigate.',
384
- labels: ['bug', 'automated']
385
- })
386
- ```
387
-
388
- ## Docker Integration
389
-
390
- ### Dockerfile for Testing
391
-
392
- ```dockerfile
393
- FROM node:18-alpine
394
-
395
- WORKDIR /app
396
-
397
- COPY package*.json ./
398
- RUN npm ci
399
-
400
- COPY . .
401
-
402
- # Run tests
403
- CMD ["npm", "run", "test:all"]
404
- ```
405
-
406
- ### docker-compose.yml
407
-
408
- ```yaml
409
- version: '3.8'
410
-
411
- services:
412
- tests:
413
- build: .
414
- environment:
415
- - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
416
- - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
417
- - AWS_REGION=${AWS_REGION}
418
- - TEST_BUCKET=${TEST_BUCKET}
419
- - FLUENT_CLIENT_ID=${FLUENT_CLIENT_ID}
420
- - FLUENT_CLIENT_SECRET=${FLUENT_CLIENT_SECRET}
421
- - FLUENT_USERNAME=${FLUENT_USERNAME}
422
- - FLUENT_PASSWORD=${FLUENT_PASSWORD}
423
- - FLUENT_RETAILER_ID=${FLUENT_RETAILER_ID}
424
- ```
425
-
426
- Run tests with Docker:
427
-
428
- ```bash
429
- # Build and run tests
430
- docker-compose up --build
431
-
432
- # Run specific test
433
- docker-compose run tests npm run test:s3
434
- ```
435
-
436
- ## Key Takeaways
437
-
438
- - 🎯 Integrate tests into CI/CD pipelines for automated validation
439
- - 🎯 Use GitHub Actions for continuous testing
440
- - 🎯 Store credentials securely in GitHub Secrets
441
- - 🎯 Create npm scripts for easy test execution
442
- - 🎯 Use scheduled workflows to catch issues early
443
-
444
- ## Practice Exercise
445
-
446
- Set up GitHub Actions for your repository:
447
-
448
- ```yaml
449
- # .github/workflows/test.yml
450
- # TODO: Configure workflow for your project
451
- ```
452
-
453
- ## Next Steps
454
-
455
- Continue to [Module 7: Best Practices →](./04-reference-testing-07-best-practices.md) to learn testing best practices.
456
-
457
- ---
458
-
459
- **Module Navigation:**
460
- - **Previous:** [Module 5 - Debugging](./04-reference-testing-05-debugging.md)
461
- - **Current:** Module 6 - CI/CD Integration
462
- - **Next:** [Module 7 - Best Practices](./04-reference-testing-07-best-practices.md)
463
- - **Back to:** [Testing Guide Index](../testing-readme.md)
1
+ # Module 6: CI/CD Integration
2
+
3
+ **Level:** Intermediate
4
+ **Estimated Time:** 20 minutes
5
+
6
+ ## Overview
7
+
8
+ This module covers integrating testing utilities into CI/CD pipelines for automated validation.
9
+
10
+ ## Learning Objectives
11
+
12
+ By the end of this module, you will:
13
+ - ✅ Know how to integrate tests into GitHub Actions
14
+ - ✅ Understand how to configure test scripts in package.json
15
+ - ✅ Be able to set up automated testing workflows
16
+ - ✅ Know how to handle secrets and credentials in CI/CD
17
+
18
+ ## GitHub Actions Integration
19
+
20
+ ### Basic Workflow
21
+
22
+ ```yaml
23
+ name: Integration Tests
24
+
25
+ on:
26
+ push:
27
+ branches: [main]
28
+ pull_request:
29
+ branches: [main]
30
+
31
+ jobs:
32
+ test:
33
+ runs-on: ubuntu-latest
34
+
35
+ steps:
36
+ - uses: actions/checkout@v2
37
+
38
+ - name: Setup Node.js
39
+ uses: actions/setup-node@v2
40
+ with:
41
+ node-version: '18'
42
+
43
+ - name: Install dependencies
44
+ run: npm ci
45
+
46
+ - name: Run S3 Tests
47
+ env:
48
+ AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
49
+ AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
50
+ TEST_BUCKET: ${{ secrets.TEST_BUCKET }}
51
+ run: |
52
+ npm run test:s3
53
+
54
+ - name: Run Fluent Tests
55
+ env:
56
+ FLUENT_CLIENT_ID: ${{ secrets.FLUENT_CLIENT_ID }}
57
+ FLUENT_CLIENT_SECRET: ${{ secrets.FLUENT_CLIENT_SECRET }}
58
+ FLUENT_USERNAME: ${{ secrets.FLUENT_USERNAME }}
59
+ FLUENT_PASSWORD: ${{ secrets.FLUENT_PASSWORD }}
60
+ run: |
61
+ npm run test:fluent
62
+
63
+ - name: Run Integration Tests
64
+ run: |
65
+ npm run test:integration
66
+ ```
67
+
68
+ ### Advanced Workflow with Matrix
69
+
70
+ ```yaml
71
+ name: Multi-Environment Tests
72
+
73
+ on:
74
+ push:
75
+ branches: [main, develop]
76
+ schedule:
77
+ - cron: '0 0 * * *' # Daily at midnight
78
+
79
+ jobs:
80
+ test:
81
+ runs-on: ${{ matrix.os }}
82
+ strategy:
83
+ matrix:
84
+ os: [ubuntu-latest, windows-latest]
85
+ node-version: [18, 20]
86
+
87
+ steps:
88
+ - uses: actions/checkout@v2
89
+
90
+ - name: Setup Node.js ${{ matrix.node-version }}
91
+ uses: actions/setup-node@v2
92
+ with:
93
+ node-version: ${{ matrix.node-version }}
94
+
95
+ - name: Install dependencies
96
+ run: npm ci
97
+
98
+ - name: Run Tests
99
+ env:
100
+ AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
101
+ AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
102
+ FLUENT_CLIENT_ID: ${{ secrets.FLUENT_CLIENT_ID }}
103
+ FLUENT_CLIENT_SECRET: ${{ secrets.FLUENT_CLIENT_SECRET }}
104
+ FLUENT_USERNAME: ${{ secrets.FLUENT_USERNAME }}
105
+ FLUENT_PASSWORD: ${{ secrets.FLUENT_PASSWORD }}
106
+ run: npm run test:all
107
+
108
+ - name: Upload Test Results
109
+ if: always()
110
+ uses: actions/upload-artifact@v2
111
+ with:
112
+ name: test-results-${{ matrix.os }}-node${{ matrix.node-version }}
113
+ path: test-results/
114
+ ```
115
+
116
+ ## Package.json Test Scripts
117
+
118
+ Configure test scripts for easy execution:
119
+
120
+ ```json
121
+ {
122
+ "name": "my-fluent-integration",
123
+ "version": "1.0.0",
124
+ "scripts": {
125
+ "test:s3": "node tests/s3-connectivity.js",
126
+ "test:fluent": "node tests/fluent-connectivity.js",
127
+ "test:integration": "node tests/integration.js",
128
+ "test:all": "npm run test:s3 && npm run test:fluent && npm run test:integration",
129
+ "test:watch": "nodemon tests/integration.js",
130
+ "test:ci": "npm run test:all -- --ci",
131
+ "health": "node tests/health-check.js"
132
+ },
133
+ "devDependencies": {
134
+ "@fluentcommerce/fc-connect-sdk": "^1.0.0",
135
+ "nodemon": "^2.0.0"
136
+ }
137
+ }
138
+ ```
139
+
140
+ ## Test Script Examples
141
+
142
+ ### S3 Connectivity Test Script
143
+
144
+ ```typescript
145
+ // tests/s3-connectivity.js
146
+ import { S3SDKTester } from '@fluentcommerce/fc-connect-sdk';
147
+
148
+ async function main() {
149
+ const tester = new S3SDKTester({
150
+ region: process.env.AWS_REGION || 'us-east-1',
151
+ accessKeyId: process.env.AWS_ACCESS_KEY_ID,
152
+ secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
153
+ });
154
+
155
+ console.log('Testing S3 connectivity...');
156
+ const testBucket = process.env.TEST_BUCKET;
157
+
158
+ if (!testBucket) {
159
+ console.error('❌ TEST_BUCKET environment variable not set');
160
+ process.exit(1);
161
+ }
162
+
163
+ const result = await tester.testAll(testBucket);
164
+
165
+ if (result.summary.success) {
166
+ console.log(`✅ S3 tests passed`);
167
+ console.log(` - List: ${result.tests.list.success ? '✅' : '}`);
168
+ console.log(` - Write: ${result.tests.write.success ? '✅' : '}`);
169
+ console.log(` - Read: ${result.tests.read.success ? '✅' : '}`);
170
+ console.log(` - Delete: ${result.tests.delete.success ? '✅' : '}`);
171
+ process.exit(0);
172
+ } else {
173
+ console.error('❌ S3 tests failed:');
174
+ Object.entries(result.tests).forEach(([op, res]) => {
175
+ if (!res.success) console.error(` - ${op}: ${res.message}`);
176
+ });
177
+ process.exit(1);
178
+ }
179
+ }
180
+
181
+ main().catch(error => {
182
+ console.error('Test error:', error);
183
+ process.exit(1);
184
+ });
185
+ ```
186
+
187
+ ### Fluent Connectivity Test Script
188
+
189
+ ```typescript
190
+ // tests/fluent-connectivity.js
191
+ import { FluentConnectionTester, createClient } from '@fluentcommerce/fc-connect-sdk';
192
+
193
+ async function main() {
194
+ const client = await createClient({
195
+ config: {
196
+ baseUrl: process.env.FLUENT_BASE_URL,
197
+ clientId: process.env.FLUENT_CLIENT_ID,
198
+ clientSecret: process.env.FLUENT_CLIENT_SECRET,
199
+ username: process.env.FLUENT_USERNAME,
200
+ password: process.env.FLUENT_PASSWORD,
201
+ retailerId: process.env.FLUENT_RETAILER_ID
202
+ }
203
+ });
204
+
205
+ const tester = new FluentConnectionTester(client, {
206
+ logger: console
207
+ });
208
+
209
+ console.log('Testing Fluent API connectivity...');
210
+ const result = await tester.testConnection();
211
+
212
+ if (result.success) {
213
+ console.log(`✅ Fluent connection verified (${result.duration}ms)`);
214
+ console.log(` User: ${result.details?.username || 'authenticated'}`);
215
+ process.exit(0);
216
+ } else {
217
+ console.error('❌ Fluent connection failed:');
218
+ console.error(` ${result.message}`);
219
+ process.exit(1);
220
+ }
221
+ }
222
+
223
+ main().catch(error => {
224
+ console.error('Test error:', error);
225
+ process.exit(1);
226
+ });
227
+ ```
228
+
229
+ ### Integration Test Script
230
+
231
+ ```typescript
232
+ // tests/integration.js
233
+ import {
234
+ S3SDKTester,
235
+ FluentConnectionTester,
236
+ createClient
237
+ } from '@fluentcommerce/fc-connect-sdk';
238
+
239
+ async function main() {
240
+ console.log('Running integration tests...\n');
241
+
242
+ const testBucket = process.env.TEST_BUCKET;
243
+ if (!testBucket) {
244
+ console.error('❌ TEST_BUCKET environment variable not set');
245
+ process.exit(1);
246
+ }
247
+
248
+ // Test S3
249
+ console.log('1. Testing S3...');
250
+ const s3Tester = new S3SDKTester({
251
+ region: process.env.AWS_REGION || 'us-east-1',
252
+ accessKeyId: process.env.AWS_ACCESS_KEY_ID,
253
+ secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
254
+ });
255
+
256
+ const s3Result = await s3Tester.testAll(testBucket);
257
+ console.log(` S3: ${s3Result.summary.success ? '✅' : '}`);
258
+
259
+ if (!s3Result.summary.success) {
260
+ console.error(' S3 tests failed - aborting');
261
+ process.exit(1);
262
+ }
263
+
264
+ // Test Fluent
265
+ console.log('2. Testing Fluent API...');
266
+ const client = await createClient({
267
+ config: {
268
+ baseUrl: process.env.FLUENT_BASE_URL,
269
+ clientId: process.env.FLUENT_CLIENT_ID,
270
+ clientSecret: process.env.FLUENT_CLIENT_SECRET,
271
+ username: process.env.FLUENT_USERNAME,
272
+ password: process.env.FLUENT_PASSWORD,
273
+ retailerId: process.env.FLUENT_RETAILER_ID
274
+ }
275
+ });
276
+
277
+ const fluentTester = new FluentConnectionTester(client, {
278
+ logger: console
279
+ });
280
+
281
+ const fluentResult = await fluentTester.testConnection();
282
+ console.log(` Fluent: ${fluentResult.success ? '✅' : '}`);
283
+
284
+ if (!fluentResult.success) {
285
+ console.error(' Fluent connection test failed - aborting');
286
+ process.exit(1);
287
+ }
288
+
289
+ console.log('\n✅ All integration tests passed!');
290
+ process.exit(0);
291
+ }
292
+
293
+ main().catch(error => {
294
+ console.error('Integration test error:', error);
295
+ process.exit(1);
296
+ });
297
+ ```
298
+
299
+ ## Environment Variables Management
300
+
301
+ ### .env.example Template
302
+
303
+ ```bash
304
+ # AWS Credentials
305
+ AWS_ACCESS_KEY_ID=your-access-key-id
306
+ AWS_SECRET_ACCESS_KEY=your-secret-access-key
307
+ AWS_REGION=us-east-1
308
+ TEST_BUCKET=your-test-bucket
309
+
310
+ # Fluent Commerce Credentials
311
+ FLUENT_BASE_URL=https://api.fluentcommerce.com
312
+ FLUENT_CLIENT_ID=your-client-id
313
+ FLUENT_CLIENT_SECRET=your-client-secret
314
+ FLUENT_USERNAME=your-username
315
+ FLUENT_PASSWORD=your-password
316
+ FLUENT_RETAILER_ID=1
317
+ ```
318
+
319
+ ### GitHub Secrets Configuration
320
+
321
+ Add these secrets in GitHub repository settings:
322
+
323
+ ```
324
+ AWS_ACCESS_KEY_ID
325
+ AWS_SECRET_ACCESS_KEY
326
+ AWS_REGION
327
+ TEST_BUCKET
328
+ FLUENT_BASE_URL
329
+ FLUENT_CLIENT_ID
330
+ FLUENT_CLIENT_SECRET
331
+ FLUENT_USERNAME
332
+ FLUENT_PASSWORD
333
+ FLUENT_RETAILER_ID
334
+ ```
335
+
336
+ ## Scheduled Testing
337
+
338
+ Run tests on a schedule to catch issues early:
339
+
340
+ ```yaml
341
+ name: Scheduled Tests
342
+
343
+ on:
344
+ schedule:
345
+ # Run every 6 hours
346
+ - cron: '0 */6 * * *'
347
+ workflow_dispatch: # Allow manual trigger
348
+
349
+ jobs:
350
+ scheduled-test:
351
+ runs-on: ubuntu-latest
352
+
353
+ steps:
354
+ - uses: actions/checkout@v2
355
+
356
+ - name: Setup Node.js
357
+ uses: actions/setup-node@v2
358
+ with:
359
+ node-version: '18'
360
+
361
+ - name: Install dependencies
362
+ run: npm ci
363
+
364
+ - name: Run Tests
365
+ env:
366
+ AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
367
+ AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
368
+ FLUENT_CLIENT_ID: ${{ secrets.FLUENT_CLIENT_ID }}
369
+ FLUENT_CLIENT_SECRET: ${{ secrets.FLUENT_CLIENT_SECRET }}
370
+ FLUENT_USERNAME: ${{ secrets.FLUENT_USERNAME }}
371
+ FLUENT_PASSWORD: ${{ secrets.FLUENT_PASSWORD }}
372
+ run: npm run test:all
373
+
374
+ - name: Notify on Failure
375
+ if: failure()
376
+ uses: actions/github-script@v5
377
+ with:
378
+ script: |
379
+ github.rest.issues.create({
380
+ owner: context.repo.owner,
381
+ repo: context.repo.repo,
382
+ title: 'Scheduled Test Failure',
383
+ body: 'Automated tests failed. Please investigate.',
384
+ labels: ['bug', 'automated']
385
+ })
386
+ ```
387
+
388
+ ## Docker Integration
389
+
390
+ ### Dockerfile for Testing
391
+
392
+ ```dockerfile
393
+ FROM node:18-alpine
394
+
395
+ WORKDIR /app
396
+
397
+ COPY package*.json ./
398
+ RUN npm ci
399
+
400
+ COPY . .
401
+
402
+ # Run tests
403
+ CMD ["npm", "run", "test:all"]
404
+ ```
405
+
406
+ ### docker-compose.yml
407
+
408
+ ```yaml
409
+ version: '3.8'
410
+
411
+ services:
412
+ tests:
413
+ build: .
414
+ environment:
415
+ - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
416
+ - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
417
+ - AWS_REGION=${AWS_REGION}
418
+ - TEST_BUCKET=${TEST_BUCKET}
419
+ - FLUENT_CLIENT_ID=${FLUENT_CLIENT_ID}
420
+ - FLUENT_CLIENT_SECRET=${FLUENT_CLIENT_SECRET}
421
+ - FLUENT_USERNAME=${FLUENT_USERNAME}
422
+ - FLUENT_PASSWORD=${FLUENT_PASSWORD}
423
+ - FLUENT_RETAILER_ID=${FLUENT_RETAILER_ID}
424
+ ```
425
+
426
+ Run tests with Docker:
427
+
428
+ ```bash
429
+ # Build and run tests
430
+ docker-compose up --build
431
+
432
+ # Run specific test
433
+ docker-compose run tests npm run test:s3
434
+ ```
435
+
436
+ ## Key Takeaways
437
+
438
+ - 🎯 Integrate tests into CI/CD pipelines for automated validation
439
+ - 🎯 Use GitHub Actions for continuous testing
440
+ - 🎯 Store credentials securely in GitHub Secrets
441
+ - 🎯 Create npm scripts for easy test execution
442
+ - 🎯 Use scheduled workflows to catch issues early
443
+
444
+ ## Practice Exercise
445
+
446
+ Set up GitHub Actions for your repository:
447
+
448
+ ```yaml
449
+ # .github/workflows/test.yml
450
+ # TODO: Configure workflow for your project
451
+ ```
452
+
453
+ ## Next Steps
454
+
455
+ Continue to [Module 7: Best Practices →](./04-reference-testing-07-best-practices.md) to learn testing best practices.
456
+
457
+ ---
458
+
459
+ **Module Navigation:**
460
+ - **Previous:** [Module 5 - Debugging](./04-reference-testing-05-debugging.md)
461
+ - **Current:** Module 6 - CI/CD Integration
462
+ - **Next:** [Module 7 - Best Practices](./04-reference-testing-07-best-practices.md)
463
+ - **Back to:** [Testing Guide Index](../testing-readme.md)