signwell_sdk 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.3

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 (449) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +0 -38
  3. data/Gemfile +9 -0
  4. data/README.md +159 -366
  5. data/Rakefile +10 -0
  6. data/docs/APIApplicationApi.md +149 -0
  7. data/docs/AdditionalFieldsInnerInner.md +56 -0
  8. data/docs/AdditionalFieldsInnerInnerValue.md +51 -0
  9. data/docs/AdditionalFilesInner.md +22 -0
  10. data/docs/AttachmentRequestInfo.md +22 -0
  11. data/docs/AttachmentRequestsInner.md +22 -0
  12. data/docs/BulkSendApi.md +452 -0
  13. data/docs/BulkSendCsvRequest.md +20 -0
  14. data/docs/CheckboxGroupInfo.md +30 -0
  15. data/docs/CheckboxGroupsInner.md +32 -0
  16. data/docs/CheckboxValidation.md +15 -0
  17. data/docs/CompletedPdfUrlResponse.md +18 -0
  18. data/docs/CopiedContactInfo.md +22 -0
  19. data/docs/CopiedContactsInner.md +20 -0
  20. data/docs/CopiedPlaceholdersInner.md +22 -0
  21. data/docs/CreateBulkSendRequest.md +36 -0
  22. data/docs/CreateWebhookRequest.md +20 -0
  23. data/docs/DateFormat.md +15 -0
  24. data/docs/DetailedOption.md +22 -0
  25. data/docs/DocumentApi.md +521 -0
  26. data/docs/DocumentFromTemplateRequest.md +78 -0
  27. data/docs/DocumentFromTemplateResponse.md +80 -0
  28. data/docs/DocumentFromTemplateResponseFieldsInnerInner.md +60 -0
  29. data/docs/DocumentFromTemplateResponseFieldsInnerInnerRecipient.md +22 -0
  30. data/docs/DocumentFromTemplateResponseRecipientsInner.md +28 -0
  31. data/docs/DocumentListResponse.md +28 -0
  32. data/docs/DocumentRequest.md +74 -0
  33. data/docs/DocumentResponse.md +80 -0
  34. data/docs/DocumentResponseAttachmentRequestsInner.md +22 -0
  35. data/docs/DocumentResponseFieldsInnerInner.md +60 -0
  36. data/docs/DocumentResponseFieldsInnerInnerOptionsInner.md +22 -0
  37. data/docs/DocumentResponseFieldsInnerInnerRecipient.md +20 -0
  38. data/docs/DocumentResponseFieldsInnerInnerValue.md +51 -0
  39. data/docs/DocumentResponseRecipientsInner.md +46 -0
  40. data/docs/DocumentTemplateListResponse.md +28 -0
  41. data/docs/DocumentTemplateRequest.md +60 -0
  42. data/docs/DocumentTemplateResponse.md +72 -0
  43. data/docs/DocumentTemplateResponseCopiedPlaceholdersInner.md +30 -0
  44. data/docs/DocumentTemplateResponsePlaceholdersInner.md +32 -0
  45. data/docs/DocumentTemplateUpdateRequest.md +46 -0
  46. data/docs/DropdownOption.md +49 -0
  47. data/docs/ErrorResponse.md +20 -0
  48. data/docs/ErrorResponseMeta.md +22 -0
  49. data/docs/FieldType.md +15 -0
  50. data/docs/FieldsInnerInner.md +54 -0
  51. data/docs/FileFormat.md +15 -0
  52. data/docs/FileInfo.md +20 -0
  53. data/docs/FilesInner.md +22 -0
  54. data/docs/LabelInfo.md +20 -0
  55. data/docs/LabelRequest.md +18 -0
  56. data/docs/LabelResponse.md +20 -0
  57. data/docs/MeApi.md +75 -0
  58. data/docs/Nom151CertificateResponse.md +18 -0
  59. data/docs/Nom151CertificateResponseNom151.md +32 -0
  60. data/docs/Nom151UrlResponse.md +18 -0
  61. data/docs/PaginationMeta.md +26 -0
  62. data/docs/PlaceholdersInner.md +24 -0
  63. data/docs/RateLimitErrorResponse.md +18 -0
  64. data/docs/RecipientsInner.md +32 -0
  65. data/docs/ReminderRecipientsInner.md +20 -0
  66. data/docs/SendReminderRequest.md +18 -0
  67. data/docs/TemplateApi.md +296 -0
  68. data/docs/TemplateAttachmentRequestsInner.md +22 -0
  69. data/docs/TemplateCheckboxGroupsInner.md +32 -0
  70. data/docs/TemplateFieldValuesInner.md +20 -0
  71. data/docs/TemplateFieldValuesInnerValue.md +51 -0
  72. data/docs/TemplateFieldsInnerInner.md +54 -0
  73. data/docs/TemplateRecipientsInner.md +34 -0
  74. data/docs/TextValidation.md +15 -0
  75. data/docs/UpdateDocumentAndSendRequest.md +54 -0
  76. data/docs/ValidationErrorResponse.md +18 -0
  77. data/docs/WebhooksApi.md +217 -0
  78. data/lib/signwell_sdk/api/api_application_api.rb +148 -0
  79. data/lib/signwell_sdk/api/bulk_send_api.rb +450 -0
  80. data/lib/signwell_sdk/api/document_api.rb +504 -0
  81. data/lib/signwell_sdk/api/me_api.rb +79 -0
  82. data/lib/signwell_sdk/api/template_api.rb +290 -0
  83. data/lib/signwell_sdk/api/webhooks_api.rb +210 -0
  84. data/lib/signwell_sdk/api_client.rb +439 -0
  85. data/lib/signwell_sdk/api_error.rb +131 -0
  86. data/lib/signwell_sdk/configuration.rb +392 -0
  87. data/lib/signwell_sdk/models/additional_fields_inner_inner.rb +524 -0
  88. data/lib/signwell_sdk/models/additional_fields_inner_inner_value.rb +107 -0
  89. data/lib/signwell_sdk/models/additional_files_inner.rb +259 -0
  90. data/lib/signwell_sdk/models/attachment_request_info.rb +273 -31
  91. data/lib/signwell_sdk/models/attachment_requests_inner.rb +277 -0
  92. data/lib/signwell_sdk/models/bulk_send_csv_request.rb +267 -0
  93. data/lib/signwell_sdk/models/checkbox_group_info.rb +355 -63
  94. data/lib/signwell_sdk/models/checkbox_groups_inner.rb +366 -0
  95. data/lib/signwell_sdk/models/checkbox_validation.rb +36 -12
  96. data/lib/signwell_sdk/models/completed_pdf_url_response.rb +239 -0
  97. data/lib/signwell_sdk/models/copied_contact_info.rb +256 -31
  98. data/lib/signwell_sdk/models/copied_contacts_inner.rb +248 -0
  99. data/lib/signwell_sdk/models/copied_placeholders_inner.rb +258 -0
  100. data/lib/signwell_sdk/models/create_bulk_send_request.rb +351 -0
  101. data/lib/signwell_sdk/models/create_webhook_request.rb +248 -0
  102. data/lib/signwell_sdk/models/date_format.rb +40 -17
  103. data/lib/signwell_sdk/models/detailed_option.rb +261 -0
  104. data/lib/signwell_sdk/models/document_from_template_request.rb +596 -0
  105. data/lib/signwell_sdk/models/document_from_template_response.rb +557 -0
  106. data/lib/signwell_sdk/models/document_from_template_response_fields_inner_inner.rb +490 -0
  107. data/lib/signwell_sdk/models/document_from_template_response_fields_inner_inner_recipient.rb +272 -0
  108. data/lib/signwell_sdk/models/document_from_template_response_recipients_inner.rb +285 -0
  109. data/lib/signwell_sdk/models/document_list_response.rb +338 -0
  110. data/lib/signwell_sdk/models/document_request.rb +592 -0
  111. data/lib/signwell_sdk/models/document_response.rb +558 -0
  112. data/lib/signwell_sdk/models/document_response_attachment_requests_inner.rb +272 -0
  113. data/lib/signwell_sdk/models/document_response_fields_inner_inner.rb +490 -0
  114. data/lib/signwell_sdk/models/document_response_fields_inner_inner_options_inner.rb +238 -0
  115. data/lib/signwell_sdk/models/document_response_fields_inner_inner_recipient.rb +263 -0
  116. data/lib/signwell_sdk/models/document_response_fields_inner_inner_value.rb +106 -0
  117. data/lib/signwell_sdk/models/document_response_recipients_inner.rb +389 -0
  118. data/lib/signwell_sdk/models/document_template_list_response.rb +338 -0
  119. data/lib/signwell_sdk/models/document_template_request.rb +512 -0
  120. data/lib/signwell_sdk/models/document_template_response.rb +504 -0
  121. data/lib/signwell_sdk/models/document_template_response_copied_placeholders_inner.rb +293 -0
  122. data/lib/signwell_sdk/models/document_template_response_placeholders_inner.rb +304 -0
  123. data/lib/signwell_sdk/models/document_template_update_request.rb +396 -0
  124. data/lib/signwell_sdk/models/dropdown_option.rb +106 -0
  125. data/lib/signwell_sdk/models/error_response.rb +227 -49
  126. data/lib/signwell_sdk/models/error_response_meta.rb +277 -0
  127. data/lib/signwell_sdk/models/field_type.rb +50 -26
  128. data/lib/signwell_sdk/models/fields_inner_inner.rb +514 -0
  129. data/lib/signwell_sdk/models/file_format.rb +40 -0
  130. data/lib/signwell_sdk/models/file_info.rb +263 -23
  131. data/lib/signwell_sdk/models/files_inner.rb +258 -0
  132. data/lib/signwell_sdk/models/label_info.rb +229 -23
  133. data/lib/signwell_sdk/models/label_request.rb +238 -0
  134. data/lib/signwell_sdk/models/label_response.rb +247 -0
  135. data/lib/signwell_sdk/models/nom151_certificate_response.rb +238 -0
  136. data/lib/signwell_sdk/models/nom151_certificate_response_nom151.rb +427 -0
  137. data/lib/signwell_sdk/models/nom151_url_response.rb +239 -0
  138. data/lib/signwell_sdk/models/pagination_meta.rb +315 -0
  139. data/lib/signwell_sdk/models/placeholders_inner.rb +285 -0
  140. data/lib/signwell_sdk/models/rate_limit_error_response.rb +236 -15
  141. data/lib/signwell_sdk/models/recipients_inner.rb +329 -0
  142. data/lib/signwell_sdk/models/reminder_recipients_inner.rb +231 -0
  143. data/lib/signwell_sdk/models/send_reminder_request.rb +223 -0
  144. data/lib/signwell_sdk/models/template_attachment_requests_inner.rb +277 -0
  145. data/lib/signwell_sdk/models/template_checkbox_groups_inner.rb +366 -0
  146. data/lib/signwell_sdk/models/template_field_values_inner.rb +264 -0
  147. data/lib/signwell_sdk/models/template_field_values_inner_value.rb +107 -0
  148. data/lib/signwell_sdk/models/template_fields_inner_inner.rb +514 -0
  149. data/lib/signwell_sdk/models/template_recipients_inner.rb +339 -0
  150. data/lib/signwell_sdk/models/text_validation.rb +46 -22
  151. data/lib/signwell_sdk/models/update_document_and_send_request.rb +440 -0
  152. data/lib/signwell_sdk/models/validation_error_response.rb +238 -21
  153. data/lib/signwell_sdk/version.rb +13 -3
  154. data/lib/signwell_sdk/webhook.rb +26 -0
  155. data/lib/signwell_sdk.rb +108 -106
  156. data/release-please-config.json +12 -0
  157. data/signwell_sdk.gemspec +41 -0
  158. data/spec/api/api_application_api_spec.rb +59 -0
  159. data/spec/api/bulk_send_api_spec.rb +113 -0
  160. data/spec/api/document_api_spec.rb +124 -0
  161. data/spec/api/me_api_spec.rb +46 -0
  162. data/spec/api/template_api_spec.rb +84 -0
  163. data/spec/api/webhooks_api_spec.rb +70 -0
  164. data/spec/models/additional_fields_inner_inner_spec.rb +150 -0
  165. data/spec/models/additional_fields_inner_inner_value_spec.rb +32 -0
  166. data/spec/models/additional_files_inner_spec.rb +48 -0
  167. data/spec/models/attachment_request_info_spec.rb +48 -0
  168. data/spec/models/attachment_requests_inner_spec.rb +48 -0
  169. data/spec/models/bulk_send_csv_request_spec.rb +42 -0
  170. data/spec/models/checkbox_group_info_spec.rb +72 -0
  171. data/spec/models/checkbox_groups_inner_spec.rb +78 -0
  172. data/spec/models/checkbox_validation_spec.rb +30 -0
  173. data/spec/models/completed_pdf_url_response_spec.rb +36 -0
  174. data/spec/models/copied_contact_info_spec.rb +48 -0
  175. data/spec/models/copied_contacts_inner_spec.rb +42 -0
  176. data/spec/models/copied_placeholders_inner_spec.rb +48 -0
  177. data/spec/models/create_bulk_send_request_spec.rb +90 -0
  178. data/spec/models/create_webhook_request_spec.rb +42 -0
  179. data/spec/models/date_format_spec.rb +30 -0
  180. data/spec/models/detailed_option_spec.rb +48 -0
  181. data/spec/models/document_from_template_request_spec.rb +216 -0
  182. data/spec/models/document_from_template_response_fields_inner_inner_recipient_spec.rb +48 -0
  183. data/spec/models/document_from_template_response_fields_inner_inner_spec.rb +162 -0
  184. data/spec/models/document_from_template_response_recipients_inner_spec.rb +66 -0
  185. data/spec/models/document_from_template_response_spec.rb +222 -0
  186. data/spec/models/document_list_response_spec.rb +66 -0
  187. data/spec/models/document_request_spec.rb +204 -0
  188. data/spec/models/document_response_attachment_requests_inner_spec.rb +48 -0
  189. data/spec/models/document_response_fields_inner_inner_options_inner_spec.rb +48 -0
  190. data/spec/models/document_response_fields_inner_inner_recipient_spec.rb +42 -0
  191. data/spec/models/document_response_fields_inner_inner_spec.rb +162 -0
  192. data/spec/models/document_response_fields_inner_inner_value_spec.rb +32 -0
  193. data/spec/models/document_response_recipients_inner_spec.rb +120 -0
  194. data/spec/models/document_response_spec.rb +222 -0
  195. data/spec/models/document_template_list_response_spec.rb +66 -0
  196. data/spec/models/document_template_request_spec.rb +162 -0
  197. data/spec/models/document_template_response_copied_placeholders_inner_spec.rb +72 -0
  198. data/spec/models/document_template_response_placeholders_inner_spec.rb +78 -0
  199. data/spec/models/document_template_response_spec.rb +198 -0
  200. data/spec/models/document_template_update_request_spec.rb +120 -0
  201. data/spec/models/dropdown_option_spec.rb +32 -0
  202. data/spec/models/error_response_meta_spec.rb +48 -0
  203. data/spec/models/error_response_spec.rb +42 -0
  204. data/spec/models/field_type_spec.rb +30 -0
  205. data/spec/models/fields_inner_inner_spec.rb +144 -0
  206. data/spec/models/file_format_spec.rb +30 -0
  207. data/spec/models/file_info_spec.rb +42 -0
  208. data/spec/models/files_inner_spec.rb +48 -0
  209. data/spec/models/label_info_spec.rb +42 -0
  210. data/spec/models/label_request_spec.rb +36 -0
  211. data/spec/models/label_response_spec.rb +42 -0
  212. data/spec/models/nom151_certificate_response_nom151_spec.rb +78 -0
  213. data/spec/models/nom151_certificate_response_spec.rb +36 -0
  214. data/spec/models/nom151_url_response_spec.rb +36 -0
  215. data/spec/models/pagination_meta_spec.rb +60 -0
  216. data/spec/models/placeholders_inner_spec.rb +54 -0
  217. data/spec/models/rate_limit_error_response_spec.rb +36 -0
  218. data/spec/models/recipients_inner_spec.rb +78 -0
  219. data/spec/models/reminder_recipients_inner_spec.rb +42 -0
  220. data/spec/models/send_reminder_request_spec.rb +36 -0
  221. data/spec/models/template_attachment_requests_inner_spec.rb +48 -0
  222. data/spec/models/template_checkbox_groups_inner_spec.rb +78 -0
  223. data/spec/models/template_field_values_inner_spec.rb +42 -0
  224. data/spec/models/template_field_values_inner_value_spec.rb +32 -0
  225. data/spec/models/template_fields_inner_inner_spec.rb +144 -0
  226. data/spec/models/template_recipients_inner_spec.rb +84 -0
  227. data/spec/models/text_validation_spec.rb +30 -0
  228. data/spec/models/update_document_and_send_request_spec.rb +144 -0
  229. data/spec/models/validation_error_response_spec.rb +36 -0
  230. data/spec/spec_helper.rb +111 -0
  231. metadata +345 -239
  232. data/.ignore +0 -2
  233. data/SECURITY.md +0 -27
  234. data/lib/signwell_sdk/client.rb +0 -72
  235. data/lib/signwell_sdk/errors.rb +0 -228
  236. data/lib/signwell_sdk/file_part.rb +0 -58
  237. data/lib/signwell_sdk/internal/transport/base_client.rb +0 -573
  238. data/lib/signwell_sdk/internal/transport/pooled_net_requester.rb +0 -210
  239. data/lib/signwell_sdk/internal/type/array_of.rb +0 -168
  240. data/lib/signwell_sdk/internal/type/base_model.rb +0 -531
  241. data/lib/signwell_sdk/internal/type/base_page.rb +0 -55
  242. data/lib/signwell_sdk/internal/type/boolean.rb +0 -77
  243. data/lib/signwell_sdk/internal/type/converter.rb +0 -327
  244. data/lib/signwell_sdk/internal/type/enum.rb +0 -156
  245. data/lib/signwell_sdk/internal/type/file_input.rb +0 -111
  246. data/lib/signwell_sdk/internal/type/hash_of.rb +0 -188
  247. data/lib/signwell_sdk/internal/type/request_parameters.rb +0 -42
  248. data/lib/signwell_sdk/internal/type/union.rb +0 -243
  249. data/lib/signwell_sdk/internal/type/unknown.rb +0 -81
  250. data/lib/signwell_sdk/internal/util.rb +0 -920
  251. data/lib/signwell_sdk/internal.rb +0 -20
  252. data/lib/signwell_sdk/models/v1/api_application_delete_params.rb +0 -16
  253. data/lib/signwell_sdk/models/v1/api_application_retrieve_params.rb +0 -16
  254. data/lib/signwell_sdk/models/v1/attachment_request.rb +0 -38
  255. data/lib/signwell_sdk/models/v1/bulk_send_create_params.rb +0 -107
  256. data/lib/signwell_sdk/models/v1/bulk_send_list_params.rb +0 -55
  257. data/lib/signwell_sdk/models/v1/bulk_send_retrieve_csv_template_params.rb +0 -39
  258. data/lib/signwell_sdk/models/v1/bulk_send_retrieve_documents_params.rb +0 -32
  259. data/lib/signwell_sdk/models/v1/bulk_send_retrieve_params.rb +0 -16
  260. data/lib/signwell_sdk/models/v1/bulk_send_validate_csv_params.rb +0 -39
  261. data/lib/signwell_sdk/models/v1/checkbox_group.rb +0 -80
  262. data/lib/signwell_sdk/models/v1/copied_contact.rb +0 -26
  263. data/lib/signwell_sdk/models/v1/document.rb +0 -543
  264. data/lib/signwell_sdk/models/v1/document_create_from_template_params.rb +0 -740
  265. data/lib/signwell_sdk/models/v1/document_create_from_template_response.rb +0 -500
  266. data/lib/signwell_sdk/models/v1/document_create_params.rb +0 -620
  267. data/lib/signwell_sdk/models/v1/document_delete_params.rb +0 -16
  268. data/lib/signwell_sdk/models/v1/document_file.rb +0 -34
  269. data/lib/signwell_sdk/models/v1/document_list_params.rb +0 -32
  270. data/lib/signwell_sdk/models/v1/document_list_response.rb +0 -50
  271. data/lib/signwell_sdk/models/v1/document_remind_params.rb +0 -49
  272. data/lib/signwell_sdk/models/v1/document_retrieve_completed_pdf_params.rb +0 -55
  273. data/lib/signwell_sdk/models/v1/document_retrieve_completed_pdf_response.rb +0 -22
  274. data/lib/signwell_sdk/models/v1/document_retrieve_params.rb +0 -16
  275. data/lib/signwell_sdk/models/v1/document_send_params.rb +0 -198
  276. data/lib/signwell_sdk/models/v1/document_template.rb +0 -503
  277. data/lib/signwell_sdk/models/v1/document_template_create_params.rb +0 -599
  278. data/lib/signwell_sdk/models/v1/document_template_delete_params.rb +0 -16
  279. data/lib/signwell_sdk/models/v1/document_template_list_params.rb +0 -32
  280. data/lib/signwell_sdk/models/v1/document_template_list_response.rb +0 -50
  281. data/lib/signwell_sdk/models/v1/document_template_retrieve_params.rb +0 -16
  282. data/lib/signwell_sdk/models/v1/document_template_update_params.rb +0 -162
  283. data/lib/signwell_sdk/models/v1/hook_create_params.rb +0 -32
  284. data/lib/signwell_sdk/models/v1/hook_delete_params.rb +0 -16
  285. data/lib/signwell_sdk/models/v1/hook_list_params.rb +0 -16
  286. data/lib/signwell_sdk/models/v1/label.rb +0 -22
  287. data/lib/signwell_sdk/models/v1/template_checkbox_group.rb +0 -80
  288. data/lib/signwell_sdk/models/v1_me_params.rb +0 -14
  289. data/lib/signwell_sdk/models.rb +0 -69
  290. data/lib/signwell_sdk/request_options.rb +0 -77
  291. data/lib/signwell_sdk/resources/v1/api_applications.rb +0 -59
  292. data/lib/signwell_sdk/resources/v1/bulk_sends.rb +0 -198
  293. data/lib/signwell_sdk/resources/v1/document_templates.rb +0 -204
  294. data/lib/signwell_sdk/resources/v1/documents.rb +0 -372
  295. data/lib/signwell_sdk/resources/v1/hooks.rb +0 -78
  296. data/lib/signwell_sdk/resources/v1.rb +0 -47
  297. data/manifest.yaml +0 -17
  298. data/rbi/signwell_sdk/client.rbi +0 -49
  299. data/rbi/signwell_sdk/errors.rbi +0 -205
  300. data/rbi/signwell_sdk/file_part.rbi +0 -37
  301. data/rbi/signwell_sdk/internal/transport/base_client.rbi +0 -302
  302. data/rbi/signwell_sdk/internal/transport/pooled_net_requester.rbi +0 -84
  303. data/rbi/signwell_sdk/internal/type/array_of.rbi +0 -104
  304. data/rbi/signwell_sdk/internal/type/base_model.rbi +0 -308
  305. data/rbi/signwell_sdk/internal/type/base_page.rbi +0 -43
  306. data/rbi/signwell_sdk/internal/type/boolean.rbi +0 -58
  307. data/rbi/signwell_sdk/internal/type/converter.rbi +0 -216
  308. data/rbi/signwell_sdk/internal/type/enum.rbi +0 -82
  309. data/rbi/signwell_sdk/internal/type/file_input.rbi +0 -59
  310. data/rbi/signwell_sdk/internal/type/hash_of.rbi +0 -104
  311. data/rbi/signwell_sdk/internal/type/request_parameters.rbi +0 -31
  312. data/rbi/signwell_sdk/internal/type/union.rbi +0 -128
  313. data/rbi/signwell_sdk/internal/type/unknown.rbi +0 -58
  314. data/rbi/signwell_sdk/internal/util.rbi +0 -487
  315. data/rbi/signwell_sdk/internal.rbi +0 -18
  316. data/rbi/signwell_sdk/models/attachment_request_info.rbi +0 -52
  317. data/rbi/signwell_sdk/models/checkbox_group_info.rbi +0 -89
  318. data/rbi/signwell_sdk/models/checkbox_validation.rbi +0 -27
  319. data/rbi/signwell_sdk/models/copied_contact_info.rbi +0 -50
  320. data/rbi/signwell_sdk/models/date_format.rbi +0 -26
  321. data/rbi/signwell_sdk/models/error_response.rbi +0 -97
  322. data/rbi/signwell_sdk/models/field_type.rbi +0 -41
  323. data/rbi/signwell_sdk/models/file_info.rbi +0 -36
  324. data/rbi/signwell_sdk/models/label_info.rbi +0 -40
  325. data/rbi/signwell_sdk/models/rate_limit_error_response.rbi +0 -31
  326. data/rbi/signwell_sdk/models/text_validation.rbi +0 -44
  327. data/rbi/signwell_sdk/models/v1/api_application_delete_params.rbi +0 -34
  328. data/rbi/signwell_sdk/models/v1/api_application_retrieve_params.rbi +0 -34
  329. data/rbi/signwell_sdk/models/v1/attachment_request.rbi +0 -59
  330. data/rbi/signwell_sdk/models/v1/bulk_send_create_params.rbi +0 -160
  331. data/rbi/signwell_sdk/models/v1/bulk_send_list_params.rbi +0 -92
  332. data/rbi/signwell_sdk/models/v1/bulk_send_retrieve_csv_template_params.rbi +0 -67
  333. data/rbi/signwell_sdk/models/v1/bulk_send_retrieve_documents_params.rbi +0 -62
  334. data/rbi/signwell_sdk/models/v1/bulk_send_retrieve_params.rbi +0 -34
  335. data/rbi/signwell_sdk/models/v1/bulk_send_validate_csv_params.rbi +0 -64
  336. data/rbi/signwell_sdk/models/v1/checkbox_group.rbi +0 -121
  337. data/rbi/signwell_sdk/models/v1/copied_contact.rbi +0 -41
  338. data/rbi/signwell_sdk/models/v1/document.rbi +0 -833
  339. data/rbi/signwell_sdk/models/v1/document_create_from_template_params.rbi +0 -1270
  340. data/rbi/signwell_sdk/models/v1/document_create_from_template_response.rbi +0 -856
  341. data/rbi/signwell_sdk/models/v1/document_create_params.rbi +0 -1019
  342. data/rbi/signwell_sdk/models/v1/document_delete_params.rbi +0 -34
  343. data/rbi/signwell_sdk/models/v1/document_file.rbi +0 -55
  344. data/rbi/signwell_sdk/models/v1/document_list_params.rbi +0 -62
  345. data/rbi/signwell_sdk/models/v1/document_list_response.rbi +0 -71
  346. data/rbi/signwell_sdk/models/v1/document_remind_params.rbi +0 -107
  347. data/rbi/signwell_sdk/models/v1/document_retrieve_completed_pdf_params.rbi +0 -123
  348. data/rbi/signwell_sdk/models/v1/document_retrieve_completed_pdf_response.rbi +0 -34
  349. data/rbi/signwell_sdk/models/v1/document_retrieve_params.rbi +0 -34
  350. data/rbi/signwell_sdk/models/v1/document_send_params.rbi +0 -307
  351. data/rbi/signwell_sdk/models/v1/document_template.rbi +0 -830
  352. data/rbi/signwell_sdk/models/v1/document_template_create_params.rbi +0 -1050
  353. data/rbi/signwell_sdk/models/v1/document_template_delete_params.rbi +0 -34
  354. data/rbi/signwell_sdk/models/v1/document_template_list_params.rbi +0 -62
  355. data/rbi/signwell_sdk/models/v1/document_template_list_response.rbi +0 -71
  356. data/rbi/signwell_sdk/models/v1/document_template_retrieve_params.rbi +0 -34
  357. data/rbi/signwell_sdk/models/v1/document_template_update_params.rbi +0 -257
  358. data/rbi/signwell_sdk/models/v1/hook_create_params.rbi +0 -59
  359. data/rbi/signwell_sdk/models/v1/hook_delete_params.rbi +0 -34
  360. data/rbi/signwell_sdk/models/v1/hook_list_params.rbi +0 -34
  361. data/rbi/signwell_sdk/models/v1/label.rbi +0 -29
  362. data/rbi/signwell_sdk/models/v1/template_checkbox_group.rbi +0 -121
  363. data/rbi/signwell_sdk/models/v1_me_params.rbi +0 -27
  364. data/rbi/signwell_sdk/models/validation_error_response.rbi +0 -38
  365. data/rbi/signwell_sdk/models.rbi +0 -31
  366. data/rbi/signwell_sdk/request_options.rbi +0 -59
  367. data/rbi/signwell_sdk/resources/v1/api_applications.rbi +0 -45
  368. data/rbi/signwell_sdk/resources/v1/bulk_sends.rbi +0 -173
  369. data/rbi/signwell_sdk/resources/v1/document_templates.rbi +0 -276
  370. data/rbi/signwell_sdk/resources/v1/documents.rbi +0 -527
  371. data/rbi/signwell_sdk/resources/v1/hooks.rbi +0 -52
  372. data/rbi/signwell_sdk/resources/v1.rbi +0 -32
  373. data/rbi/signwell_sdk/version.rbi +0 -5
  374. data/sig/signwell_sdk/client.rbs +0 -26
  375. data/sig/signwell_sdk/errors.rbs +0 -117
  376. data/sig/signwell_sdk/file_part.rbs +0 -21
  377. data/sig/signwell_sdk/internal/transport/base_client.rbs +0 -133
  378. data/sig/signwell_sdk/internal/transport/pooled_net_requester.rbs +0 -48
  379. data/sig/signwell_sdk/internal/type/array_of.rbs +0 -48
  380. data/sig/signwell_sdk/internal/type/base_model.rbs +0 -102
  381. data/sig/signwell_sdk/internal/type/base_page.rbs +0 -24
  382. data/sig/signwell_sdk/internal/type/boolean.rbs +0 -26
  383. data/sig/signwell_sdk/internal/type/converter.rbs +0 -79
  384. data/sig/signwell_sdk/internal/type/enum.rbs +0 -32
  385. data/sig/signwell_sdk/internal/type/file_input.rbs +0 -25
  386. data/sig/signwell_sdk/internal/type/hash_of.rbs +0 -48
  387. data/sig/signwell_sdk/internal/type/request_parameters.rbs +0 -19
  388. data/sig/signwell_sdk/internal/type/union.rbs +0 -52
  389. data/sig/signwell_sdk/internal/type/unknown.rbs +0 -26
  390. data/sig/signwell_sdk/internal/util.rbs +0 -185
  391. data/sig/signwell_sdk/internal.rbs +0 -9
  392. data/sig/signwell_sdk/models/attachment_request_info.rbs +0 -19
  393. data/sig/signwell_sdk/models/checkbox_group_info.rbs +0 -52
  394. data/sig/signwell_sdk/models/checkbox_validation.rbs +0 -16
  395. data/sig/signwell_sdk/models/copied_contact_info.rbs +0 -21
  396. data/sig/signwell_sdk/models/date_format.rbs +0 -22
  397. data/sig/signwell_sdk/models/error_response.rbs +0 -52
  398. data/sig/signwell_sdk/models/field_type.rbs +0 -42
  399. data/sig/signwell_sdk/models/file_info.rbs +0 -15
  400. data/sig/signwell_sdk/models/label_info.rbs +0 -19
  401. data/sig/signwell_sdk/models/rate_limit_error_response.rbs +0 -13
  402. data/sig/signwell_sdk/models/text_validation.rbs +0 -34
  403. data/sig/signwell_sdk/models/v1/api_application_delete_params.rbs +0 -17
  404. data/sig/signwell_sdk/models/v1/api_application_retrieve_params.rbs +0 -17
  405. data/sig/signwell_sdk/models/v1/attachment_request.rbs +0 -26
  406. data/sig/signwell_sdk/models/v1/bulk_send_create_params.rbs +0 -89
  407. data/sig/signwell_sdk/models/v1/bulk_send_list_params.rbs +0 -51
  408. data/sig/signwell_sdk/models/v1/bulk_send_retrieve_csv_template_params.rbs +0 -32
  409. data/sig/signwell_sdk/models/v1/bulk_send_retrieve_documents_params.rbs +0 -34
  410. data/sig/signwell_sdk/models/v1/bulk_send_retrieve_params.rbs +0 -17
  411. data/sig/signwell_sdk/models/v1/bulk_send_validate_csv_params.rbs +0 -30
  412. data/sig/signwell_sdk/models/v1/checkbox_group.rbs +0 -69
  413. data/sig/signwell_sdk/models/v1/copied_contact.rbs +0 -19
  414. data/sig/signwell_sdk/models/v1/document.rbs +0 -563
  415. data/sig/signwell_sdk/models/v1/document_create_from_template_params.rbs +0 -570
  416. data/sig/signwell_sdk/models/v1/document_create_from_template_response.rbs +0 -518
  417. data/sig/signwell_sdk/models/v1/document_create_params.rbs +0 -473
  418. data/sig/signwell_sdk/models/v1/document_delete_params.rbs +0 -17
  419. data/sig/signwell_sdk/models/v1/document_file.rbs +0 -32
  420. data/sig/signwell_sdk/models/v1/document_list_params.rbs +0 -34
  421. data/sig/signwell_sdk/models/v1/document_list_response.rbs +0 -47
  422. data/sig/signwell_sdk/models/v1/document_remind_params.rbs +0 -48
  423. data/sig/signwell_sdk/models/v1/document_retrieve_completed_pdf_params.rbs +0 -57
  424. data/sig/signwell_sdk/models/v1/document_retrieve_completed_pdf_response.rbs +0 -15
  425. data/sig/signwell_sdk/models/v1/document_retrieve_params.rbs +0 -17
  426. data/sig/signwell_sdk/models/v1/document_send_params.rbs +0 -160
  427. data/sig/signwell_sdk/models/v1/document_template.rbs +0 -530
  428. data/sig/signwell_sdk/models/v1/document_template_create_params.rbs +0 -459
  429. data/sig/signwell_sdk/models/v1/document_template_delete_params.rbs +0 -17
  430. data/sig/signwell_sdk/models/v1/document_template_list_params.rbs +0 -34
  431. data/sig/signwell_sdk/models/v1/document_template_list_response.rbs +0 -47
  432. data/sig/signwell_sdk/models/v1/document_template_retrieve_params.rbs +0 -17
  433. data/sig/signwell_sdk/models/v1/document_template_update_params.rbs +0 -132
  434. data/sig/signwell_sdk/models/v1/hook_create_params.rbs +0 -32
  435. data/sig/signwell_sdk/models/v1/hook_delete_params.rbs +0 -17
  436. data/sig/signwell_sdk/models/v1/hook_list_params.rbs +0 -17
  437. data/sig/signwell_sdk/models/v1/label.rbs +0 -15
  438. data/sig/signwell_sdk/models/v1/template_checkbox_group.rbs +0 -69
  439. data/sig/signwell_sdk/models/v1_me_params.rbs +0 -14
  440. data/sig/signwell_sdk/models/validation_error_response.rbs +0 -13
  441. data/sig/signwell_sdk/models.rbs +0 -29
  442. data/sig/signwell_sdk/request_options.rbs +0 -36
  443. data/sig/signwell_sdk/resources/v1/api_applications.rbs +0 -19
  444. data/sig/signwell_sdk/resources/v1/bulk_sends.rbs +0 -55
  445. data/sig/signwell_sdk/resources/v1/document_templates.rbs +0 -71
  446. data/sig/signwell_sdk/resources/v1/documents.rbs +0 -130
  447. data/sig/signwell_sdk/resources/v1/hooks.rbs +0 -22
  448. data/sig/signwell_sdk/resources/v1.rbs +0 -19
  449. data/sig/signwell_sdk/version.rbs +0 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '02022668207e2410908c334ca7275b7be0dfd46d5f7ce91cc55e50750d54cc21'
4
- data.tar.gz: dd43d14eed3f775b98f32fb366fa065d72b6a00df29269c3d3170bd3dffcafe5
3
+ metadata.gz: 8da5e4f39a9d87d108d2a660d893f44770095c2ffd56d52f76e646f210126f35
4
+ data.tar.gz: 2433b13f13609027349df9576808961cfd4b11930e8059296f1edb43488a24bf
5
5
  SHA512:
6
- metadata.gz: b539dbd329d0b71b137d48f0e0341da02085f8a7633421e91cff26180bd194a30bc2626e83ba1819c9e82fdd66abdc078f4f20ef9cc8108ba47fa548c5720dcd
7
- data.tar.gz: c1ac5ffc4fc77bcc7d338225e54a7ce42e3446c513dd0d5a304c9a86f6f879d634999a398c25db2c973e197a012a196fba6dc9e6cc609702b57d09ccbd52bc7f
6
+ metadata.gz: acfaf3173484ff848427a9d527b0db6217050d8c26f59d2ef31d200fb62dfba1dcb759e916dba5a4a900782d87bc207759114e2a384a6353c378387496393128
7
+ data.tar.gz: '0130486e3b7e1fb47c64bbc1d5f32fad9593e430e3f04c19d0c9d2019728d983069286057e908adf99476c1a8a808d854455cb0261023c05860dc39d4329db4c'
data/CHANGELOG.md CHANGED
@@ -1,39 +1 @@
1
1
  # Changelog
2
-
3
- ## 0.1.0-alpha.2 (2026-02-04)
4
-
5
- Full Changelog: [v0.0.1-alpha.1...v0.1.0-alpha.2](https://github.com/Bidsketch/signwell-sdk-ruby/compare/v0.0.1-alpha.1...v0.1.0-alpha.2)
6
-
7
- ### Features
8
-
9
- * **api:** adds contact information ([4d03e53](https://github.com/Bidsketch/signwell-sdk-ruby/commit/4d03e530a065aabce613ac34b5e7e760498fa822))
10
- * **api:** manual updates ([d1d35ee](https://github.com/Bidsketch/signwell-sdk-ruby/commit/d1d35ee21e78a13ed90f0bd9f340e9b4c3cf640e))
11
- * **api:** updates error responses ([aeff826](https://github.com/Bidsketch/signwell-sdk-ruby/commit/aeff82647d6d8340a758c2ff1ef1eac188ed944b))
12
-
13
-
14
- ### Chores
15
-
16
- * update SDK settings ([21722bb](https://github.com/Bidsketch/signwell-sdk-ruby/commit/21722bb094b2def47aae35fb448265141f22fcf7))
17
-
18
- ## 0.0.1-alpha.1 (2026-02-04)
19
-
20
- Full Changelog: [v0.0.1...v0.0.1-alpha.1](https://github.com/Bidsketch/signwell-sdk-ruby/compare/v0.0.1...v0.0.1-alpha.1)
21
-
22
- ### Features
23
-
24
- * **api:** manual updates ([3b4115e](https://github.com/Bidsketch/signwell-sdk-ruby/commit/3b4115e027c60f02c39bc5247be4be9add609ed8))
25
- * **api:** manual updates ([bf265ec](https://github.com/Bidsketch/signwell-sdk-ruby/commit/bf265ece7a5077b8b4fb2e36133eb40c36637934))
26
- * **api:** manual updates ([45e11aa](https://github.com/Bidsketch/signwell-sdk-ruby/commit/45e11aac78f4ea11fd5ed45ae2ce569118f86a64))
27
- * **api:** manual updates ([c4a0bce](https://github.com/Bidsketch/signwell-sdk-ruby/commit/c4a0bce2891157aca149cfa0007a88f23d3cb36d))
28
- * **api:** manual updates ([41d87af](https://github.com/Bidsketch/signwell-sdk-ruby/commit/41d87aff206a12bead4a691b42cdbdcce2fd5926))
29
- * **api:** manual updates ([666e33f](https://github.com/Bidsketch/signwell-sdk-ruby/commit/666e33f5394e8d005e3eba38407e460daa4670b5))
30
- * **api:** manual updates ([bb88e1e](https://github.com/Bidsketch/signwell-sdk-ruby/commit/bb88e1e78efab1e855310feb0a039f0596ec1193))
31
- * **api:** manual updates ([1fa00b1](https://github.com/Bidsketch/signwell-sdk-ruby/commit/1fa00b1c42c8f473f3e784f9376ed7dd27b8cf0c))
32
- * **api:** manual updates ([9b167be](https://github.com/Bidsketch/signwell-sdk-ruby/commit/9b167be00f2d0275550ca019ae897a77c0d24142))
33
-
34
-
35
- ### Chores
36
-
37
- * **docs:** remove www prefix ([2105144](https://github.com/Bidsketch/signwell-sdk-ruby/commit/2105144661cef53ed8045eaa9d07771f26c729ba))
38
- * **documents-api:** Removes nom151 from SDK Generation ([a608dda](https://github.com/Bidsketch/signwell-sdk-ruby/commit/a608dda6a026da7837a6ad087d94d627da7b31c4))
39
- * update SDK settings ([373d73c](https://github.com/Bidsketch/signwell-sdk-ruby/commit/373d73c6b7cfc95073dd7b3a3d41d0b80d3e790c))
data/Gemfile ADDED
@@ -0,0 +1,9 @@
1
+ source 'https://rubygems.org'
2
+
3
+ gemspec
4
+
5
+ group :development, :test do
6
+ gem 'rake', '~> 13.0.1'
7
+ gem 'pry-byebug'
8
+ gem 'rubocop', '~> 0.66.0'
9
+ end
data/README.md CHANGED
@@ -1,400 +1,193 @@
1
- # Signwell SDK Ruby API library
1
+ # signwell_sdk
2
2
 
3
- The Signwell SDK Ruby library provides convenient access to the Signwell SDK REST API from any Ruby 3.2.0+ application. It ships with comprehensive types & docstrings in Yard, RBS, and RBI – [see below](https://github.com/Bidsketch/signwell-sdk-ruby#Sorbet) for usage with Sorbet. The standard library's `net/http` is used as the HTTP transport, with connection pooling via the `connection_pool` gem.
3
+ SignWell - the Ruby gem for the SignWell Developer API
4
4
 
5
- It is generated with [Stainless](https://www.stainless.com/).
5
+ No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
6
6
 
7
- ## Documentation
7
+ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
8
8
 
9
- Documentation for releases of this gem can be found [on RubyDoc](https://gemdocs.org/gems/signwell_sdk).
10
-
11
- The REST API documentation can be found on [developers.signwell.com](https://developers.signwell.com/).
9
+ - API version: v1
10
+ - Package version: 0.1.0
11
+ - Generator version: 7.12.0
12
+ - Build package: org.openapitools.codegen.languages.RubyClientCodegen
12
13
 
13
14
  ## Installation
14
15
 
15
- To use this gem, install via Bundler by adding the following to your application's `Gemfile`:
16
-
17
- <!-- x-release-please-start-version -->
18
-
19
- ```ruby
20
- gem "signwell_sdk", "~> 0.1.0.pre.alpha.2"
21
- ```
22
-
23
- <!-- x-release-please-end -->
24
-
25
- ## Usage
26
-
27
- ```ruby
28
- require "bundler/setup"
29
- require "signwell_sdk"
30
-
31
- signwell_sdk = SignwellSDK::Client.new(
32
- api_key: ENV["SIGNWELL_SDK_API_KEY"] # This is the default and can be omitted
33
- )
34
-
35
- document = signwell_sdk.v1.documents.create(
36
- files: [{name: "employment_agreement.pdf", file_url: "https://example.com/documents/employment_agreement.pdf"}],
37
- recipients: [
38
- {id: "1", name: "John Doe", email: "john.doe@example.com"},
39
- {id: "2", name: "HR Manager", email: "hr@company.com"}
40
- ],
41
- allow_decline: true,
42
- apply_signing_order: true,
43
- copied_contacts: [{name: "Legal Department", email: "legal@company.com"}],
44
- decline_redirect_url: "https://example.com/signing-declined",
45
- expires_in: 14,
46
- fields: [
47
- [
48
- {x: 150, y: 600, page: 1, recipient_id: "1", type: "signature", required: true, api_id: "employee_signature"},
49
- {x: 150, y: 650, page: 1, recipient_id: "1", type: "date", required: true, label: "Date Signed"},
50
- {x: 400, y: 600, page: 1, recipient_id: "2", type: "signature", required: true, api_id: "hr_signature"}
51
- ]
52
- ],
53
- message: "Hi John,\n\nPlease review and sign the attached employment agreement at your earliest convenience.\n\nBest regards,\nHR Team",
54
- metadata: {employee_id: "EMP-2024-001", department: "Engineering", contract_type: "full_time"},
55
- name: "Employment Agreement - John Doe",
56
- redirect_url: "https://example.com/signing-complete",
57
- reminders: true,
58
- subject: "Action Required: Please sign your Employment Agreement",
59
- test_mode: true
60
- )
61
-
62
- puts(document.id)
63
- ```
64
-
65
- ### Handling errors
66
-
67
- When the library is unable to connect to the API, or if the API returns a non-success status code (i.e., 4xx or 5xx response), a subclass of `SignwellSDK::Errors::APIError` will be thrown:
68
-
69
- ```ruby
70
- begin
71
- document = signwell_sdk.v1.documents.list
72
- rescue SignwellSDK::Errors::APIConnectionError => e
73
- puts("The server could not be reached")
74
- puts(e.cause) # an underlying Exception, likely raised within `net/http`
75
- rescue SignwellSDK::Errors::RateLimitError => e
76
- puts("A 429 status code was received; we should back off a bit.")
77
- rescue SignwellSDK::Errors::APIStatusError => e
78
- puts("Another non-200-range status code was received")
79
- puts(e.status)
80
- end
81
- ```
82
-
83
- Error codes are as follows:
84
-
85
- | Cause | Error Type |
86
- | ---------------- | -------------------------- |
87
- | HTTP 400 | `BadRequestError` |
88
- | HTTP 401 | `AuthenticationError` |
89
- | HTTP 403 | `PermissionDeniedError` |
90
- | HTTP 404 | `NotFoundError` |
91
- | HTTP 409 | `ConflictError` |
92
- | HTTP 422 | `UnprocessableEntityError` |
93
- | HTTP 429 | `RateLimitError` |
94
- | HTTP >= 500 | `InternalServerError` |
95
- | Other HTTP error | `APIStatusError` |
96
- | Timeout | `APITimeoutError` |
97
- | Network error | `APIConnectionError` |
98
-
99
- ### Retries
100
-
101
- Certain errors will be automatically retried 2 times by default, with a short exponential backoff.
102
-
103
- Connection errors (for example, due to a network connectivity problem), 408 Request Timeout, 409 Conflict, 429 Rate Limit, >=500 Internal errors, and timeouts will all be retried by default.
104
-
105
- You can use the `max_retries` option to configure or disable this:
106
-
107
- ```ruby
108
- # Configure the default for all requests:
109
- signwell_sdk = SignwellSDK::Client.new(
110
- max_retries: 0 # default is 2
111
- )
112
-
113
- # Or, configure per-request:
114
- signwell_sdk.v1.documents.list(request_options: {max_retries: 5})
115
- ```
116
-
117
- ### Timeouts
118
-
119
- By default, requests will time out after 60 seconds. You can use the timeout option to configure or disable this:
120
-
121
- ```ruby
122
- # Configure the default for all requests:
123
- signwell_sdk = SignwellSDK::Client.new(
124
- timeout: nil # default is 60
125
- )
126
-
127
- # Or, configure per-request:
128
- signwell_sdk.v1.documents.list(request_options: {timeout: 5})
129
- ```
130
-
131
- On timeout, `SignwellSDK::Errors::APITimeoutError` is raised.
132
-
133
- Note that requests that time out are retried by default.
134
-
135
- ## Advanced concepts
136
-
137
- ### BaseModel
138
-
139
- All parameter and response objects inherit from `SignwellSDK::Internal::Type::BaseModel`, which provides several conveniences, including:
140
-
141
- 1. All fields, including unknown ones, are accessible with `obj[:prop]` syntax, and can be destructured with `obj => {prop: prop}` or pattern-matching syntax.
142
-
143
- 2. Structural equivalence for equality; if two API calls return the same values, comparing the responses with == will return true.
16
+ ### Build a gem
144
17
 
145
- 3. Both instances and the classes themselves can be pretty-printed.
18
+ To build the Ruby code into a gem:
146
19
 
147
- 4. Helpers such as `#to_h`, `#deep_to_h`, `#to_json`, and `#to_yaml`.
148
-
149
- ### Making custom or undocumented requests
150
-
151
- #### Undocumented properties
152
-
153
- You can send undocumented parameters to any endpoint, and read undocumented response properties, like so:
154
-
155
- Note: the `extra_` parameters of the same name overrides the documented parameters.
156
-
157
- ```ruby
158
- documents =
159
- signwell_sdk.v1.documents.list(
160
- request_options: {
161
- extra_query: {my_query_parameter: value},
162
- extra_body: {my_body_parameter: value},
163
- extra_headers: {"my-header": value}
164
- }
165
- )
166
-
167
- puts(documents[:my_undocumented_property])
20
+ ```shell
21
+ gem build signwell_sdk.gemspec
168
22
  ```
169
23
 
170
- #### Undocumented request params
171
-
172
- If you want to explicitly send an extra param, you can do so with the `extra_query`, `extra_body`, and `extra_headers` under the `request_options:` parameter when making a request, as seen in the examples above.
173
-
174
- #### Undocumented endpoints
24
+ Then either install the gem locally:
175
25
 
176
- To make requests to undocumented endpoints while retaining the benefit of auth, retries, and so on, you can make requests using `client.request`, like so:
177
-
178
- ```ruby
179
- response = client.request(
180
- method: :post,
181
- path: '/undocumented/endpoint',
182
- query: {"dog": "woof"},
183
- headers: {"useful-header": "interesting-value"},
184
- body: {"hello": "world"}
185
- )
26
+ ```shell
27
+ gem install ./signwell_sdk-0.1.0.gem
186
28
  ```
187
29
 
188
- ### Concurrency & connection pooling
30
+ (for development, run `gem install --dev ./signwell_sdk-0.1.0.gem` to install the development dependencies)
189
31
 
190
- The `SignwellSDK::Client` instances are threadsafe, but are only are fork-safe when there are no in-flight HTTP requests.
32
+ or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
191
33
 
192
- Each instance of `SignwellSDK::Client` has its own HTTP connection pool with a default size of 99. As such, we recommend instantiating the client once per application in most settings.
34
+ Finally add this to the Gemfile:
193
35
 
194
- When all available connections from the pool are checked out, requests wait for a new connection to become available, with queue time counting towards the request timeout.
36
+ gem 'signwell_sdk', '~> 0.1.0'
195
37
 
196
- Unless otherwise specified, other classes in the SDK do not have locks protecting their underlying data structure.
38
+ ### Install from Git
197
39
 
198
- ## Sorbet
40
+ If the Ruby gem is hosted at a git repository: https://github.com/GIT_USER_ID/GIT_REPO_ID, then add the following in the Gemfile:
199
41
 
200
- This library provides comprehensive [RBI](https://sorbet.org/docs/rbi) definitions, and has no dependency on sorbet-runtime.
42
+ gem 'signwell_sdk', :git => 'https://github.com/GIT_USER_ID/GIT_REPO_ID.git'
201
43
 
202
- You can provide typesafe request parameters like so:
203
-
204
- ```ruby
205
- signwell_sdk.v1.documents.create(
206
- files: [
207
- SignwellSDK::V1::DocumentFile.new(
208
- name: "employment_agreement.pdf",
209
- file_url: "https://example.com/documents/employment_agreement.pdf"
210
- )
211
- ],
212
- recipients: [
213
- SignwellSDK::V1::DocumentCreateParams::Recipient.new(
214
- id: "1",
215
- name: "John Doe",
216
- email: "john.doe@example.com"
217
- ),
218
- SignwellSDK::V1::DocumentCreateParams::Recipient.new(id: "2", name: "HR Manager", email: "hr@company.com")
219
- ],
220
- allow_decline: true,
221
- apply_signing_order: true,
222
- copied_contacts: [SignwellSDK::V1::CopiedContact.new(name: "Legal Department", email: "legal@company.com")],
223
- decline_redirect_url: "https://example.com/signing-declined",
224
- expires_in: 14,
225
- fields: [
226
- [
227
- SignwellSDK::V1::DocumentCreateParams::Field.new(
228
- x: 150,
229
- y_: 600,
230
- page: 1,
231
- recipient_id: "1",
232
- type: "signature",
233
- required: true,
234
- api_id: "employee_signature"
235
- ),
236
- SignwellSDK::V1::DocumentCreateParams::Field.new(
237
- x: 150,
238
- y_: 650,
239
- page: 1,
240
- recipient_id: "1",
241
- type: "date",
242
- required: true,
243
- label: "Date Signed"
244
- ),
245
- SignwellSDK::V1::DocumentCreateParams::Field.new(
246
- x: 400,
247
- y_: 600,
248
- page: 1,
249
- recipient_id: "2",
250
- type: "signature",
251
- required: true,
252
- api_id: "hr_signature"
253
- )
254
- ]
255
- ],
256
- message: "Hi John,\n\nPlease review and sign the attached employment agreement at your earliest convenience.\n\nBest regards,\nHR Team",
257
- metadata: {employee_id: "EMP-2024-001", department: "Engineering", contract_type: "full_time"},
258
- name: "Employment Agreement - John Doe",
259
- redirect_url: "https://example.com/signing-complete",
260
- reminders: true,
261
- subject: "Action Required: Please sign your Employment Agreement",
262
- test_mode: true
263
- )
264
- ```
44
+ ### Include the Ruby code directly
265
45
 
266
- Or, equivalently:
46
+ Include the Ruby code directly using `-I` as follows:
267
47
 
268
- ```ruby
269
- # Hashes work, but are not typesafe:
270
- signwell_sdk.v1.documents.create(
271
- files: [{name: "employment_agreement.pdf", file_url: "https://example.com/documents/employment_agreement.pdf"}],
272
- recipients: [
273
- {id: "1", name: "John Doe", email: "john.doe@example.com"},
274
- {id: "2", name: "HR Manager", email: "hr@company.com"}
275
- ],
276
- allow_decline: true,
277
- apply_signing_order: true,
278
- copied_contacts: [{name: "Legal Department", email: "legal@company.com"}],
279
- decline_redirect_url: "https://example.com/signing-declined",
280
- expires_in: 14,
281
- fields: [
282
- [
283
- {x: 150, y: 600, page: 1, recipient_id: "1", type: "signature", required: true, api_id: "employee_signature"},
284
- {x: 150, y: 650, page: 1, recipient_id: "1", type: "date", required: true, label: "Date Signed"},
285
- {x: 400, y: 600, page: 1, recipient_id: "2", type: "signature", required: true, api_id: "hr_signature"}
286
- ]
287
- ],
288
- message: "Hi John,\n\nPlease review and sign the attached employment agreement at your earliest convenience.\n\nBest regards,\nHR Team",
289
- metadata: {employee_id: "EMP-2024-001", department: "Engineering", contract_type: "full_time"},
290
- name: "Employment Agreement - John Doe",
291
- redirect_url: "https://example.com/signing-complete",
292
- reminders: true,
293
- subject: "Action Required: Please sign your Employment Agreement",
294
- test_mode: true
295
- )
296
-
297
- # You can also splat a full Params class:
298
- params = SignwellSDK::V1::DocumentCreateParams.new(
299
- files: [
300
- SignwellSDK::V1::DocumentFile.new(
301
- name: "employment_agreement.pdf",
302
- file_url: "https://example.com/documents/employment_agreement.pdf"
303
- )
304
- ],
305
- recipients: [
306
- SignwellSDK::V1::DocumentCreateParams::Recipient.new(
307
- id: "1",
308
- name: "John Doe",
309
- email: "john.doe@example.com"
310
- ),
311
- SignwellSDK::V1::DocumentCreateParams::Recipient.new(id: "2", name: "HR Manager", email: "hr@company.com")
312
- ],
313
- allow_decline: true,
314
- apply_signing_order: true,
315
- copied_contacts: [SignwellSDK::V1::CopiedContact.new(name: "Legal Department", email: "legal@company.com")],
316
- decline_redirect_url: "https://example.com/signing-declined",
317
- expires_in: 14,
318
- fields: [
319
- [
320
- SignwellSDK::V1::DocumentCreateParams::Field.new(
321
- x: 150,
322
- y_: 600,
323
- page: 1,
324
- recipient_id: "1",
325
- type: "signature",
326
- required: true,
327
- api_id: "employee_signature"
328
- ),
329
- SignwellSDK::V1::DocumentCreateParams::Field.new(
330
- x: 150,
331
- y_: 650,
332
- page: 1,
333
- recipient_id: "1",
334
- type: "date",
335
- required: true,
336
- label: "Date Signed"
337
- ),
338
- SignwellSDK::V1::DocumentCreateParams::Field.new(
339
- x: 400,
340
- y_: 600,
341
- page: 1,
342
- recipient_id: "2",
343
- type: "signature",
344
- required: true,
345
- api_id: "hr_signature"
346
- )
347
- ]
348
- ],
349
- message: "Hi John,\n\nPlease review and sign the attached employment agreement at your earliest convenience.\n\nBest regards,\nHR Team",
350
- metadata: {employee_id: "EMP-2024-001", department: "Engineering", contract_type: "full_time"},
351
- name: "Employment Agreement - John Doe",
352
- redirect_url: "https://example.com/signing-complete",
353
- reminders: true,
354
- subject: "Action Required: Please sign your Employment Agreement",
355
- test_mode: true
356
- )
357
- signwell_sdk.v1.documents.create(**params)
48
+ ```shell
49
+ ruby -Ilib script.rb
358
50
  ```
359
51
 
360
- ### Enums
52
+ ## Getting Started
361
53
 
362
- Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
54
+ Please follow the [installation](#installation) procedure and then run the following code:
363
55
 
364
56
  ```ruby
365
- # :pdf
366
- puts(SignwellSDK::V1::DocumentRetrieveCompletedPdfParams::FileFormat::PDF)
57
+ # Load the gem
58
+ require 'signwell_sdk'
59
+
60
+ # Setup authorization
61
+ SignWell.configure do |config|
62
+ # Configure API key authorization: api_key
63
+ config.api_key['X-Api-Key'] = 'YOUR API KEY'
64
+ # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
65
+ # config.api_key_prefix['X-Api-Key'] = 'Bearer'
66
+ # Configure faraday connection
67
+ config.configure_faraday_connection { |connection| 'YOUR CONNECTION CONFIG PROC' }
68
+ end
367
69
 
368
- # Revealed type: `T.all(SignwellSDK::V1::DocumentRetrieveCompletedPdfParams::FileFormat, Symbol)`
369
- T.reveal_type(SignwellSDK::V1::DocumentRetrieveCompletedPdfParams::FileFormat::PDF)
370
- ```
70
+ api_instance = SignWell::APIApplicationApi.new
71
+ id = '38400000-8cf0-11bd-b23e-10b96e4ef00d' # String |
371
72
 
372
- Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
73
+ begin
74
+ #Delete API Application
75
+ api_instance.delete_api_application(id)
76
+ rescue SignWell::ApiError => e
77
+ puts "Exception when calling APIApplicationApi->delete_api_application: #{e}"
78
+ end
373
79
 
374
- ```ruby
375
- # Using the enum constants preserves the tagged type information:
376
- signwell_sdk.v1.documents.retrieve_completed_pdf(
377
- file_format: SignwellSDK::V1::DocumentRetrieveCompletedPdfParams::FileFormat::PDF,
378
- # …
379
- )
380
-
381
- # Literal values are also permissible:
382
- signwell_sdk.v1.documents.retrieve_completed_pdf(
383
- file_format: :pdf,
384
- # …
385
- )
386
80
  ```
387
81
 
388
- ## Versioning
389
-
390
- This package follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions. As the library is in initial development and has a major version of `0`, APIs may change at any time.
391
-
392
- This package considers improvements to the (non-runtime) `*.rbi` and `*.rbs` type definitions to be non-breaking changes.
393
-
394
- ## Requirements
395
-
396
- Ruby 3.2.0 or higher.
397
-
398
- ## Contributing
82
+ ## Documentation for API Endpoints
83
+
84
+ All URIs are relative to *https://www.signwell.com*
85
+
86
+ Class | Method | HTTP request | Description
87
+ ------------ | ------------- | ------------- | -------------
88
+ *SignWell::APIApplicationApi* | [**delete_api_application**](docs/APIApplicationApi.md#delete_api_application) | **DELETE** /api/v1/api_applications/{id} | Delete API Application
89
+ *SignWell::APIApplicationApi* | [**get_api_application**](docs/APIApplicationApi.md#get_api_application) | **GET** /api/v1/api_applications/{id} | Get API Application
90
+ *SignWell::BulkSendApi* | [**create_bulk_send**](docs/BulkSendApi.md#create_bulk_send) | **POST** /api/v1/bulk_sends | Create Bulk Send
91
+ *SignWell::BulkSendApi* | [**get_bulk_send**](docs/BulkSendApi.md#get_bulk_send) | **GET** /api/v1/bulk_sends/{id} | Get Bulk Send
92
+ *SignWell::BulkSendApi* | [**get_bulk_send_csv_template**](docs/BulkSendApi.md#get_bulk_send_csv_template) | **GET** /api/v1/bulk_sends/csv_template | Get Bulk Send CSV Template
93
+ *SignWell::BulkSendApi* | [**get_bulk_send_documents**](docs/BulkSendApi.md#get_bulk_send_documents) | **GET** /api/v1/bulk_sends/{id}/documents | Get Bulk Send Documents
94
+ *SignWell::BulkSendApi* | [**list_bulk_sends**](docs/BulkSendApi.md#list_bulk_sends) | **GET** /api/v1/bulk_sends | List Bulk Sendings
95
+ *SignWell::BulkSendApi* | [**validate_bulk_send_csv**](docs/BulkSendApi.md#validate_bulk_send_csv) | **POST** /api/v1/bulk_sends/validate_csv | Validate Bulk Send CSV
96
+ *SignWell::DocumentApi* | [**create_document**](docs/DocumentApi.md#create_document) | **POST** /api/v1/documents | Create Document
97
+ *SignWell::DocumentApi* | [**create_document_from_template**](docs/DocumentApi.md#create_document_from_template) | **POST** /api/v1/document_templates/documents | Create Document from Template
98
+ *SignWell::DocumentApi* | [**delete_document**](docs/DocumentApi.md#delete_document) | **DELETE** /api/v1/documents/{id} | Delete Document
99
+ *SignWell::DocumentApi* | [**get_completed_pdf**](docs/DocumentApi.md#get_completed_pdf) | **GET** /api/v1/documents/{id}/completed_pdf | Completed PDF
100
+ *SignWell::DocumentApi* | [**get_document**](docs/DocumentApi.md#get_document) | **GET** /api/v1/documents/{id} | Get Document
101
+ *SignWell::DocumentApi* | [**send_document**](docs/DocumentApi.md#send_document) | **POST** /api/v1/documents/{id}/send | Update and Send Document
102
+ *SignWell::DocumentApi* | [**send_reminder**](docs/DocumentApi.md#send_reminder) | **POST** /api/v1/documents/{id}/remind | Send Reminder
103
+ *SignWell::MeApi* | [**get_me**](docs/MeApi.md#get_me) | **GET** /api/v1/me | Get credentials
104
+ *SignWell::TemplateApi* | [**create_template**](docs/TemplateApi.md#create_template) | **POST** /api/v1/document_templates | Create Template
105
+ *SignWell::TemplateApi* | [**delete_template**](docs/TemplateApi.md#delete_template) | **DELETE** /api/v1/document_templates/{id} | Delete Template
106
+ *SignWell::TemplateApi* | [**get_template**](docs/TemplateApi.md#get_template) | **GET** /api/v1/document_templates/{id} | Get Template
107
+ *SignWell::TemplateApi* | [**update_template**](docs/TemplateApi.md#update_template) | **PUT** /api/v1/document_templates/{id} | Update Template
108
+ *SignWell::WebhooksApi* | [**create_webhook**](docs/WebhooksApi.md#create_webhook) | **POST** /api/v1/hooks | Create Webhook
109
+ *SignWell::WebhooksApi* | [**delete_webhook**](docs/WebhooksApi.md#delete_webhook) | **DELETE** /api/v1/hooks/{id} | Delete Webhook
110
+ *SignWell::WebhooksApi* | [**list_webhooks**](docs/WebhooksApi.md#list_webhooks) | **GET** /api/v1/hooks | List Webhooks
111
+
112
+
113
+ ## Documentation for Models
114
+
115
+ - [SignWell::AdditionalFieldsInnerInner](docs/AdditionalFieldsInnerInner.md)
116
+ - [SignWell::AdditionalFieldsInnerInnerValue](docs/AdditionalFieldsInnerInnerValue.md)
117
+ - [SignWell::AdditionalFilesInner](docs/AdditionalFilesInner.md)
118
+ - [SignWell::AttachmentRequestInfo](docs/AttachmentRequestInfo.md)
119
+ - [SignWell::AttachmentRequestsInner](docs/AttachmentRequestsInner.md)
120
+ - [SignWell::BulkSendCsvRequest](docs/BulkSendCsvRequest.md)
121
+ - [SignWell::CheckboxGroupInfo](docs/CheckboxGroupInfo.md)
122
+ - [SignWell::CheckboxGroupsInner](docs/CheckboxGroupsInner.md)
123
+ - [SignWell::CheckboxValidation](docs/CheckboxValidation.md)
124
+ - [SignWell::CompletedPdfUrlResponse](docs/CompletedPdfUrlResponse.md)
125
+ - [SignWell::CopiedContactInfo](docs/CopiedContactInfo.md)
126
+ - [SignWell::CopiedContactsInner](docs/CopiedContactsInner.md)
127
+ - [SignWell::CopiedPlaceholdersInner](docs/CopiedPlaceholdersInner.md)
128
+ - [SignWell::CreateBulkSendRequest](docs/CreateBulkSendRequest.md)
129
+ - [SignWell::CreateWebhookRequest](docs/CreateWebhookRequest.md)
130
+ - [SignWell::DateFormat](docs/DateFormat.md)
131
+ - [SignWell::DetailedOption](docs/DetailedOption.md)
132
+ - [SignWell::DocumentFromTemplateRequest](docs/DocumentFromTemplateRequest.md)
133
+ - [SignWell::DocumentFromTemplateResponse](docs/DocumentFromTemplateResponse.md)
134
+ - [SignWell::DocumentFromTemplateResponseFieldsInnerInner](docs/DocumentFromTemplateResponseFieldsInnerInner.md)
135
+ - [SignWell::DocumentFromTemplateResponseFieldsInnerInnerRecipient](docs/DocumentFromTemplateResponseFieldsInnerInnerRecipient.md)
136
+ - [SignWell::DocumentFromTemplateResponseRecipientsInner](docs/DocumentFromTemplateResponseRecipientsInner.md)
137
+ - [SignWell::DocumentListResponse](docs/DocumentListResponse.md)
138
+ - [SignWell::DocumentRequest](docs/DocumentRequest.md)
139
+ - [SignWell::DocumentResponse](docs/DocumentResponse.md)
140
+ - [SignWell::DocumentResponseAttachmentRequestsInner](docs/DocumentResponseAttachmentRequestsInner.md)
141
+ - [SignWell::DocumentResponseFieldsInnerInner](docs/DocumentResponseFieldsInnerInner.md)
142
+ - [SignWell::DocumentResponseFieldsInnerInnerOptionsInner](docs/DocumentResponseFieldsInnerInnerOptionsInner.md)
143
+ - [SignWell::DocumentResponseFieldsInnerInnerRecipient](docs/DocumentResponseFieldsInnerInnerRecipient.md)
144
+ - [SignWell::DocumentResponseFieldsInnerInnerValue](docs/DocumentResponseFieldsInnerInnerValue.md)
145
+ - [SignWell::DocumentResponseRecipientsInner](docs/DocumentResponseRecipientsInner.md)
146
+ - [SignWell::DocumentTemplateListResponse](docs/DocumentTemplateListResponse.md)
147
+ - [SignWell::DocumentTemplateRequest](docs/DocumentTemplateRequest.md)
148
+ - [SignWell::DocumentTemplateResponse](docs/DocumentTemplateResponse.md)
149
+ - [SignWell::DocumentTemplateResponseCopiedPlaceholdersInner](docs/DocumentTemplateResponseCopiedPlaceholdersInner.md)
150
+ - [SignWell::DocumentTemplateResponsePlaceholdersInner](docs/DocumentTemplateResponsePlaceholdersInner.md)
151
+ - [SignWell::DocumentTemplateUpdateRequest](docs/DocumentTemplateUpdateRequest.md)
152
+ - [SignWell::DropdownOption](docs/DropdownOption.md)
153
+ - [SignWell::ErrorResponse](docs/ErrorResponse.md)
154
+ - [SignWell::ErrorResponseMeta](docs/ErrorResponseMeta.md)
155
+ - [SignWell::FieldType](docs/FieldType.md)
156
+ - [SignWell::FieldsInnerInner](docs/FieldsInnerInner.md)
157
+ - [SignWell::FileFormat](docs/FileFormat.md)
158
+ - [SignWell::FileInfo](docs/FileInfo.md)
159
+ - [SignWell::FilesInner](docs/FilesInner.md)
160
+ - [SignWell::LabelInfo](docs/LabelInfo.md)
161
+ - [SignWell::LabelRequest](docs/LabelRequest.md)
162
+ - [SignWell::LabelResponse](docs/LabelResponse.md)
163
+ - [SignWell::Nom151CertificateResponse](docs/Nom151CertificateResponse.md)
164
+ - [SignWell::Nom151CertificateResponseNom151](docs/Nom151CertificateResponseNom151.md)
165
+ - [SignWell::Nom151UrlResponse](docs/Nom151UrlResponse.md)
166
+ - [SignWell::PaginationMeta](docs/PaginationMeta.md)
167
+ - [SignWell::PlaceholdersInner](docs/PlaceholdersInner.md)
168
+ - [SignWell::RateLimitErrorResponse](docs/RateLimitErrorResponse.md)
169
+ - [SignWell::RecipientsInner](docs/RecipientsInner.md)
170
+ - [SignWell::ReminderRecipientsInner](docs/ReminderRecipientsInner.md)
171
+ - [SignWell::SendReminderRequest](docs/SendReminderRequest.md)
172
+ - [SignWell::TemplateAttachmentRequestsInner](docs/TemplateAttachmentRequestsInner.md)
173
+ - [SignWell::TemplateCheckboxGroupsInner](docs/TemplateCheckboxGroupsInner.md)
174
+ - [SignWell::TemplateFieldValuesInner](docs/TemplateFieldValuesInner.md)
175
+ - [SignWell::TemplateFieldValuesInnerValue](docs/TemplateFieldValuesInnerValue.md)
176
+ - [SignWell::TemplateFieldsInnerInner](docs/TemplateFieldsInnerInner.md)
177
+ - [SignWell::TemplateRecipientsInner](docs/TemplateRecipientsInner.md)
178
+ - [SignWell::TextValidation](docs/TextValidation.md)
179
+ - [SignWell::UpdateDocumentAndSendRequest](docs/UpdateDocumentAndSendRequest.md)
180
+ - [SignWell::ValidationErrorResponse](docs/ValidationErrorResponse.md)
181
+
182
+
183
+ ## Documentation for Authorization
184
+
185
+
186
+ Authentication schemes defined for the API:
187
+ ### api_key
188
+
189
+
190
+ - **Type**: API key
191
+ - **API key parameter name**: X-Api-Key
192
+ - **Location**: HTTP header
399
193
 
400
- See [the contributing documentation](https://github.com/Bidsketch/signwell-sdk-ruby/tree/main/CONTRIBUTING.md).
data/Rakefile ADDED
@@ -0,0 +1,10 @@
1
+ require "bundler/gem_tasks"
2
+
3
+ begin
4
+ require 'rspec/core/rake_task'
5
+
6
+ RSpec::Core::RakeTask.new(:spec)
7
+ task default: :spec
8
+ rescue LoadError
9
+ # no rspec available
10
+ end