json-rest-api 1.0.29 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (292) hide show
  1. package/LICENSE +10 -670
  2. package/LICENSE-GPL-3.0 +674 -0
  3. package/LICENSE-MIT +21 -0
  4. package/README.md +39 -30
  5. package/docs/API.md +744 -1273
  6. package/docs/GUIDE/01-getting-started.md +338 -0
  7. package/docs/GUIDE/02-resources-and-relationships.md +33 -0
  8. package/docs/GUIDE/03-running-example.md +87 -0
  9. package/docs/GUIDE/04-creating-and-querying.md +181 -0
  10. package/docs/GUIDE/05-belongs-to.md +177 -0
  11. package/docs/GUIDE/06-has-many.md +184 -0
  12. package/docs/GUIDE/07-polymorphic-relationships.md +191 -0
  13. package/docs/GUIDE/08-many-to-many.md +184 -0
  14. package/docs/GUIDE/09-pagination-and-sorting.md +149 -0
  15. package/docs/GUIDE/10-put-and-patch.md +174 -0
  16. package/docs/GUIDE/11-relationship-endpoints.md +174 -0
  17. package/docs/GUIDE/12-field-transformations.md +287 -0
  18. package/docs/GUIDE/13-hooks-and-lifecycle.md +479 -0
  19. package/docs/GUIDE/14-custom-resource-methods.md +125 -0
  20. package/docs/GUIDE/15-query-projections.md +266 -0
  21. package/docs/GUIDE/{GUIDE_X_Autofiltering.md → 16-autofiltering.md} +77 -15
  22. package/docs/GUIDE/{GUIDE_X_Row_Policies.md → 17-row-policies.md} +137 -44
  23. package/docs/GUIDE/18-labels.md +86 -0
  24. package/docs/GUIDE/19-managed-transactions.md +179 -0
  25. package/docs/GUIDE/20-transaction-outcomes.md +207 -0
  26. package/docs/GUIDE/21-schema-and-migrations.md +634 -0
  27. package/docs/GUIDE/22-version-field-migrations.md +208 -0
  28. package/docs/GUIDE/23-fastify.md +179 -0
  29. package/docs/GUIDE/24-cors.md +172 -0
  30. package/docs/GUIDE/{GUIDE_X_URL_Management.md → 25-url-management.md} +7 -1
  31. package/docs/GUIDE/26-file-uploads.md +278 -0
  32. package/docs/GUIDE/27-bulk-operations.md +277 -0
  33. package/docs/GUIDE/28-socketio.md +325 -0
  34. package/docs/GUIDE/29-writing-plugins.md +278 -0
  35. package/docs/GUIDE/30-backend-capabilities.md +100 -0
  36. package/docs/GUIDE/31-positioning.md +181 -0
  37. package/docs/GUIDE/{GUIDE_Y_Appendices.md → 32-date-and-time.md} +74 -30
  38. package/docs/GUIDE/33-migrating-to-v2.md +3827 -0
  39. package/docs/GUIDE/index.md +51 -59
  40. package/docs/QUICKSTART.md +120 -287
  41. package/docs/architecture.md +75 -0
  42. package/docs/contributing.md +178 -0
  43. package/index.d.ts +36 -0
  44. package/index.js +1 -22
  45. package/lib/enhanced-logger.js +91 -85
  46. package/lib/error-context.js +445 -5
  47. package/lib/error-formatter.js +219 -59
  48. package/lib/knex-transaction.js +64 -0
  49. package/lib/logger-types.d.ts +22 -0
  50. package/lib/missing-package.js +4 -0
  51. package/lib/rest-api-errors.js +103 -8
  52. package/lib/runtime/json-rest-api.js +172 -0
  53. package/lib/transaction-types.d.ts +59 -0
  54. package/package.json +97 -27
  55. package/plugins/core/bulk-operations-plugin.js +191 -184
  56. package/plugins/core/connectors/express-plugin.js +148 -219
  57. package/plugins/core/connectors/fastify-plugin.js +125 -82
  58. package/plugins/core/connectors/lib/busboy-detector.js +74 -156
  59. package/plugins/core/connectors/lib/connector-core.js +144 -20
  60. package/plugins/core/connectors/lib/formidable-detector.js +63 -120
  61. package/plugins/core/connectors/lib/http-validators.js +77 -0
  62. package/plugins/core/connectors/lib/multipart-helpers.js +18 -0
  63. package/plugins/core/connectors/lib/request-helpers.js +10 -1
  64. package/plugins/core/connectors/lib/transport-http-helpers.js +89 -8
  65. package/plugins/core/connectors/lib/transport-route-schemas.js +7 -4
  66. package/plugins/core/file-handling-plugin.js +87 -177
  67. package/plugins/core/lib/anyapi/anyapi-registry.js +213 -164
  68. package/plugins/core/lib/anyapi/canonical-link-store.js +507 -0
  69. package/plugins/core/lib/anyapi/canonical-relationship-reader.js +598 -0
  70. package/plugins/core/lib/anyapi/schema-utils.js +25 -16
  71. package/plugins/core/lib/anyapi/utils/descriptor-helpers.js +0 -64
  72. package/plugins/core/lib/dbIntrospection.js +228 -21
  73. package/plugins/core/lib/dbTablesOperations.js +409 -92
  74. package/plugins/core/lib/fractional-positioning.js +12 -48
  75. package/plugins/core/lib/querying/identifier-query.js +19 -0
  76. package/plugins/core/lib/querying/include-query-helpers.js +364 -0
  77. package/plugins/core/lib/querying/include-to-many.js +428 -0
  78. package/plugins/core/lib/querying/include-to-one.js +579 -0
  79. package/plugins/core/lib/querying/knex-cross-table-search.js +31 -307
  80. package/plugins/core/lib/querying/knex-json-api-transformers-querying.js +99 -401
  81. package/plugins/core/lib/querying/knex-pagination-helpers.js +48 -317
  82. package/plugins/core/lib/querying/knex-process-includes.js +5 -110
  83. package/plugins/core/lib/querying/knex-query-helpers-base.js +21 -56
  84. package/plugins/core/lib/querying/knex-query-helpers.js +298 -448
  85. package/plugins/core/lib/querying/knex-relationship-includes.js +120 -2138
  86. package/plugins/core/lib/querying/knex-window-queries.js +62 -253
  87. package/plugins/core/lib/querying/query-builder-utils.js +44 -4
  88. package/plugins/core/lib/querying/query-constraint.d.ts +12 -0
  89. package/plugins/core/lib/querying/query-constraint.js +27 -0
  90. package/plugins/core/lib/querying/query-field-sort-helpers.js +134 -37
  91. package/plugins/core/lib/querying/relationship-identifiers.js +208 -0
  92. package/plugins/core/lib/querying/sort-helpers.js +13 -1
  93. package/plugins/core/lib/querying/storage-adapter-utils.js +13 -5
  94. package/plugins/core/lib/querying/url-helpers.js +11 -4
  95. package/plugins/core/lib/querying-writing/compile-schemas.js +148 -249
  96. package/plugins/core/lib/querying-writing/connectors-query-parser.js +33 -118
  97. package/plugins/core/lib/querying-writing/database-capabilities.js +149 -223
  98. package/plugins/core/lib/querying-writing/database-value-normalizers.js +179 -194
  99. package/plugins/core/lib/querying-writing/default-data-helpers.js +15 -45
  100. package/plugins/core/lib/querying-writing/field-selection-types.d.ts +43 -0
  101. package/plugins/core/lib/querying-writing/field-utils.js +113 -92
  102. package/plugins/core/lib/querying-writing/knex-constants.d.ts +18 -0
  103. package/plugins/core/lib/querying-writing/knex-constants.js +2 -26
  104. package/plugins/core/lib/querying-writing/knex-field-helpers.js +100 -290
  105. package/plugins/core/lib/querying-writing/knex-json-api-transformers.js +31 -120
  106. package/plugins/core/lib/querying-writing/query-field-helpers.js +108 -32
  107. package/plugins/core/lib/querying-writing/query-field-types.d.ts +60 -0
  108. package/plugins/core/lib/querying-writing/relationship-contracts.js +33 -13
  109. package/plugins/core/lib/querying-writing/request-contracts.js +93 -38
  110. package/plugins/core/lib/querying-writing/resource-id-normalization.js +23 -5
  111. package/plugins/core/lib/querying-writing/response-options.js +35 -0
  112. package/plugins/core/lib/querying-writing/schema-helpers.js +203 -324
  113. package/plugins/core/lib/querying-writing/scope-validations.js +92 -290
  114. package/plugins/core/lib/querying-writing/simplified-helpers.js +113 -712
  115. package/plugins/core/lib/storage/canonical-data-helpers.js +683 -0
  116. package/plugins/core/lib/storage/canonical-storage-mapping.js +51 -20
  117. package/plugins/core/lib/storage/ordinary-data-helpers.js +710 -0
  118. package/plugins/core/lib/storage/storage-adapter.js +128 -62
  119. package/plugins/core/lib/storage/storage-mapping.js +78 -28
  120. package/plugins/core/lib/storage/storage-types.d.ts +502 -0
  121. package/plugins/core/lib/writing/many-to-many-manipulations.js +114 -284
  122. package/plugins/core/lib/writing/relationship-processor.js +94 -158
  123. package/plugins/core/lib/writing/resource-version.js +172 -0
  124. package/plugins/core/lib/writing/reverse-relationship-manipulations.js +110 -0
  125. package/plugins/core/rest-api-anyapi-knex-plugin.js +116 -2485
  126. package/plugins/core/rest-api-autofilter-plugin.js +17 -19
  127. package/plugins/core/rest-api-cors-plugin.js +52 -205
  128. package/plugins/core/rest-api-knex-plugin.js +45 -1077
  129. package/plugins/core/rest-api-label-plugin.js +25 -38
  130. package/plugins/core/rest-api-plugin-hooks/register-relationship-routes.js +5 -5
  131. package/plugins/core/rest-api-plugin-hooks/register-scope-routes.js +9 -6
  132. package/plugins/core/rest-api-plugin-hooks/turn-scope-init-into-vars.js +7 -26
  133. package/plugins/core/rest-api-plugin-hooks/validate-include-configurations.js +20 -26
  134. package/plugins/core/rest-api-plugin-methods/add-route.js +4 -6
  135. package/plugins/core/rest-api-plugin-methods/apply-query-filters.js +42 -13
  136. package/plugins/core/rest-api-plugin-methods/check-permissions.js +11 -5
  137. package/plugins/core/rest-api-plugin-methods/common.js +291 -395
  138. package/plugins/core/rest-api-plugin-methods/delete-relationship.js +49 -47
  139. package/plugins/core/rest-api-plugin-methods/delete.js +31 -25
  140. package/plugins/core/rest-api-plugin-methods/enrich-attributes.js +108 -148
  141. package/plugins/core/rest-api-plugin-methods/get-related.js +113 -305
  142. package/plugins/core/rest-api-plugin-methods/get-relationship.js +25 -18
  143. package/plugins/core/rest-api-plugin-methods/get.js +36 -68
  144. package/plugins/core/rest-api-plugin-methods/lifecycle-types.d.ts +225 -0
  145. package/plugins/core/rest-api-plugin-methods/patch-relationship.js +28 -25
  146. package/plugins/core/rest-api-plugin-methods/patch.js +46 -99
  147. package/plugins/core/rest-api-plugin-methods/post-relationship.js +49 -53
  148. package/plugins/core/rest-api-plugin-methods/post.js +51 -51
  149. package/plugins/core/rest-api-plugin-methods/put.js +69 -148
  150. package/plugins/core/rest-api-plugin-methods/query.js +37 -81
  151. package/plugins/core/rest-api-plugin-methods/release.js +2 -1
  152. package/plugins/core/rest-api-plugin.js +32 -46
  153. package/plugins/core/rest-api-positioning-plugin.js +183 -628
  154. package/plugins/core/rest-api-query-projections-plugin.js +19 -102
  155. package/plugins/core/rest-api-row-policy-plugin.js +3 -3
  156. package/plugins/core/socketio-plugin.js +364 -344
  157. package/plugins/storage/local-storage.js +40 -36
  158. package/types/autofilter.d.ts +57 -0
  159. package/types/bulk-methods.d.ts +63 -0
  160. package/types/errors.d.ts +118 -0
  161. package/types/fastify-options.d.ts +19 -0
  162. package/types/file-detectors.d.ts +33 -0
  163. package/types/file-storage.d.ts +48 -0
  164. package/types/hook-context.d.ts +180 -0
  165. package/types/plugin-options.d.ts +53 -0
  166. package/types/relationship-methods.d.ts +74 -0
  167. package/types/representations.d.ts +50 -0
  168. package/types/resource-methods.d.ts +95 -0
  169. package/types/resource-schema.d.ts +157 -0
  170. package/types/row-policy.d.ts +31 -0
  171. package/types/runtime.d.ts +132 -0
  172. package/types/transactions.d.ts +21 -0
  173. package/.claude/agents/library-guide-expert.md +0 -30
  174. package/.claude/agents/rest-api-internals-expert.md +0 -54
  175. package/.claude/settings.local.json +0 -70
  176. package/AGENTS.md +0 -34
  177. package/CLAUDE.md +0 -160
  178. package/CRUSH.md +0 -55
  179. package/JSKIT_BACKEND_MIGRATION_TRACKER.txt +0 -180
  180. package/SINGLE_VALIDATION_CONTRACT_TODO.txt +0 -172
  181. package/TODO.todo +0 -13
  182. package/connectors_ideas/fastify.js +0 -217
  183. package/connectors_ideas/koa-plugin.js +0 -112
  184. package/docs/.bundle/config +0 -2
  185. package/docs/COMPARISON.md +0 -433
  186. package/docs/GUIDE/GUIDE_1_Initial_Setup.md +0 -1057
  187. package/docs/GUIDE/GUIDE_2_1_The_Starting_Point.md +0 -88
  188. package/docs/GUIDE/GUIDE_2_2_Manipulating_And_Searching_Tables.md +0 -808
  189. package/docs/GUIDE/GUIDE_2_3_BelongsTo_Relationships.md +0 -491
  190. package/docs/GUIDE/GUIDE_2_4_HasMany_Records.md +0 -398
  191. package/docs/GUIDE/GUIDE_2_5_HasMany_Polymorphic.md +0 -898
  192. package/docs/GUIDE/GUIDE_2_6_Many_To_Many.md +0 -712
  193. package/docs/GUIDE/GUIDE_2_7_Pagination_And_Ordering.md +0 -1247
  194. package/docs/GUIDE/GUIDE_2_8_Effects_of_PUT_and_PATCH.md +0 -748
  195. package/docs/GUIDE/GUIDE_2_9_Relationships_Urls.md +0 -517
  196. package/docs/GUIDE/GUIDE_2_Data_And_Relations.md +0 -66
  197. package/docs/GUIDE/GUIDE_3_Field_Transformations.md +0 -1252
  198. package/docs/GUIDE/GUIDE_5_Non-Db_Resources.md +0 -1107
  199. package/docs/GUIDE/GUIDE_6_Positioning.md +0 -692
  200. package/docs/GUIDE/GUIDE_7_Hooks_Data_Management_And_Plugins.md +0 -1491
  201. package/docs/GUIDE/GUIDE_X_Bulk_Operations.md +0 -732
  202. package/docs/GUIDE/GUIDE_X_Cors.md +0 -1957
  203. package/docs/GUIDE/GUIDE_X_Fastify.md +0 -78
  204. package/docs/GUIDE/GUIDE_X_File_Uploads.md +0 -729
  205. package/docs/GUIDE/GUIDE_X_Knex_Schema_And_Migrations.md +0 -370
  206. package/docs/GUIDE/GUIDE_X_Query_Projections.md +0 -159
  207. package/docs/GUIDE/GUIDE_X_SocketIO.md +0 -1040
  208. package/docs/GUIDE/GUIDE_X_Writing_Plugins.md +0 -201
  209. package/docs/Gemfile +0 -6
  210. package/docs/Gemfile.lock +0 -308
  211. package/docs/ONBOARDING.md +0 -315
  212. package/docs/_config.yml +0 -36
  213. package/docs/_layouts/default.html +0 -123
  214. package/docs/apple-touch-icon.svg +0 -4
  215. package/docs/assets/css/style.scss +0 -392
  216. package/docs/favicon.svg +0 -4
  217. package/docs/index.md +0 -164
  218. package/docs/mini-guides/file-uploads-complete.md +0 -161
  219. package/eslint.config.js +0 -13
  220. package/examples/url-override-example.js +0 -137
  221. package/fixing_plan.md +0 -112
  222. package/plugins/core/lib/anyapi/query/anyapi-query-adapter.js +0 -657
  223. package/plugins/core/lib/querying-writing/return-record-settings.js +0 -47
  224. package/plugins/core/lib/writing/knex-json-api-transformers-writing.js +0 -110
  225. package/plugins/storage/s3-storage.js +0 -93
  226. package/quickTest.js +0 -136
  227. package/scripts/debug-anyapi-review-filter.mjs +0 -63
  228. package/scripts/inspect-anyapi-descriptor-country.mjs +0 -19
  229. package/scripts/inspect-anyapi-descriptor.mjs +0 -19
  230. package/scripts/run-docs.js +0 -133
  231. package/test-debug.js +0 -59
  232. package/tests/README.md +0 -202
  233. package/tests/TEST_TEMPLATE.test.js +0 -178
  234. package/tests/anyapi-basic.test.js +0 -105
  235. package/tests/anyapi-cursor-pagination.test.js +0 -148
  236. package/tests/anyapi-custom-idproperty.test.js +0 -163
  237. package/tests/autofilter.test.js +0 -463
  238. package/tests/bulk-operations.test.js +0 -657
  239. package/tests/computed-fields.test.js +0 -586
  240. package/tests/cors.test.js +0 -834
  241. package/tests/curl.test.js +0 -467
  242. package/tests/custom-id-mysql-returning-fallback.test.js +0 -128
  243. package/tests/custom-id-simplified-post.test.js +0 -75
  244. package/tests/custom-idproperty-relationships.test.js +0 -932
  245. package/tests/db-introspection.test.js +0 -521
  246. package/tests/db-table-operations.test.js +0 -798
  247. package/tests/fastify-plugin.test.js +0 -184
  248. package/tests/field-getters.test.js +0 -370
  249. package/tests/field-setters.test.js +0 -306
  250. package/tests/file-handling.test.js +0 -155
  251. package/tests/fixtures/api-configs.js +0 -2566
  252. package/tests/full-jsonapi-belongsto-linkage.test.js +0 -150
  253. package/tests/helpers/fake-fastify.js +0 -99
  254. package/tests/helpers/storage-mode.js +0 -65
  255. package/tests/helpers/test-utils.js +0 -203
  256. package/tests/http-connectors-parity.test.js +0 -395
  257. package/tests/id-normalization.test.js +0 -444
  258. package/tests/include-depth-validation.test.js +0 -331
  259. package/tests/includes.test.js +0 -427
  260. package/tests/local-storage.test.js +0 -96
  261. package/tests/logical-id-write-validation.test.js +0 -151
  262. package/tests/nested-includes.test.js +0 -617
  263. package/tests/pagination-boundaries.test.js +0 -154
  264. package/tests/pagination-contract.test.js +0 -122
  265. package/tests/pagination-cursor-multifield.test.js +0 -641
  266. package/tests/pagination-enhanced.test.js +0 -563
  267. package/tests/polymorphic-relationships.test.js +0 -347
  268. package/tests/polymorphic-simple.test.js +0 -148
  269. package/tests/positioning-advanced.test.js +0 -692
  270. package/tests/positioning-extended.test.js +0 -915
  271. package/tests/positioning-multifilter.test.js +0 -699
  272. package/tests/positioning.test.js +0 -560
  273. package/tests/post-commit-hooks.test.js +0 -120
  274. package/tests/projected-fields.test.js +0 -319
  275. package/tests/public-exports.test.js +0 -15
  276. package/tests/put-create-parity.test.js +0 -216
  277. package/tests/queries.test.js +0 -521
  278. package/tests/query-limits.test.js +0 -584
  279. package/tests/relationship-endpoints.test.js +0 -620
  280. package/tests/relationship-include-storage-adapter.test.js +0 -56
  281. package/tests/relationships.test.js +0 -681
  282. package/tests/rest-api.test.js +0 -337
  283. package/tests/return-record-settings.test.js +0 -184
  284. package/tests/row-policy.test.js +0 -489
  285. package/tests/s3-storage.test.js +0 -38
  286. package/tests/searchschema-knex-behavior.test.js +0 -187
  287. package/tests/searchschema-merge.test.js +0 -151
  288. package/tests/socketio.test.js +0 -860
  289. package/tests/storage-mapping.test.js +0 -362
  290. package/tests/temporal-boundaries.test.js +0 -208
  291. package/tests/test-development-guide.md +0 -370
  292. package/tests/virtual-fields.test.js +0 -404
@@ -1,331 +0,0 @@
1
- import { describe, it, before, after } from 'node:test'
2
- import assert from 'node:assert/strict'
3
- import knexLib from 'knex'
4
- import { createBasicApi, createLimitedDepthApi } from './fixtures/api-configs.js'
5
- import { cleanTables } from './helpers/test-utils.js'
6
-
7
- // Create Knex instance for tests
8
- const knex = knexLib({
9
- client: 'better-sqlite3',
10
- connection: {
11
- filename: ':memory:'
12
- },
13
- useNullAsDefault: true
14
- })
15
-
16
- describe('Include Depth Validation', () => {
17
- let api
18
-
19
- before(async () => {
20
- // Initialize API with custom includeDepthLimit
21
- api = await createBasicApi(knex, {
22
- 'rest-api': {
23
- includeDepthLimit: 3 // Default is 3, but being explicit
24
- }
25
- })
26
-
27
- // Set up test data with nested relationships
28
- // Country -> Publisher -> Author -> Book
29
- await cleanTables(knex, [
30
- 'basic_countries', 'basic_publishers', 'basic_authors', 'basic_books'
31
- ])
32
-
33
- const country = await api.resources.countries.post({
34
- inputRecord: {
35
- data: {
36
- type: 'countries',
37
- attributes: { name: 'USA', code: 'US' }
38
- }
39
- }
40
- })
41
-
42
- const publisher = await api.resources.publishers.post({
43
- inputRecord: {
44
- data: {
45
- type: 'publishers',
46
- attributes: { name: 'Test Publisher' },
47
- relationships: {
48
- country: { data: { type: 'countries', id: country.data.id } }
49
- }
50
- }
51
- }
52
- })
53
-
54
- const author = await api.resources.authors.post({
55
- inputRecord: {
56
- data: {
57
- type: 'authors',
58
- attributes: { name: 'Test Author' },
59
- relationships: {
60
- publisher: { data: { type: 'publishers', id: publisher.data.id } }
61
- }
62
- }
63
- }
64
- })
65
-
66
- await api.resources.books.post({
67
- inputRecord: {
68
- data: {
69
- type: 'books',
70
- attributes: { title: 'Test Book' },
71
- relationships: {
72
- country: { data: { type: 'countries', id: country.data.id } },
73
- publisher: { data: { type: 'publishers', id: publisher.data.id } }
74
- }
75
- }
76
- }
77
- })
78
- })
79
-
80
- after(async () => {
81
- await knex.destroy()
82
- })
83
-
84
- describe('Query endpoint validation', () => {
85
- it('should allow includes within depth limit', async () => {
86
- // Depth 1
87
- const depth1 = await api.resources.publishers.query({
88
- queryParams: { include: ['country'] }
89
- })
90
- assert(depth1.data.length > 0, 'Should return publishers')
91
- assert(depth1.included, 'Should have included resources')
92
-
93
- // Depth 2
94
- const depth2 = await api.resources.authors.query({
95
- queryParams: { include: ['publisher.country'] }
96
- })
97
- assert(depth2.data.length > 0, 'Should return authors')
98
- // The included array may or may not be present depending on whether relationships exist
99
-
100
- // Depth 3 (at limit)
101
- const depth3 = await api.resources.books.query({
102
- queryParams: { include: ['publisher.country.publishers'] }
103
- })
104
- assert(depth3.data.length > 0, 'Should return books')
105
- // Note: The included array might be present even if some relationships don't have data
106
- })
107
-
108
- it('should reject includes exceeding depth limit', async () => {
109
- await assert.rejects(
110
- async () => {
111
- await api.resources.books.query({
112
- queryParams: { include: ['publisher.country.publishers.books'] }
113
- })
114
- },
115
- {
116
- name: 'RestApiValidationError',
117
- message: /Include path.*exceeds maximum depth of 3/
118
- },
119
- 'Should reject depth 4'
120
- )
121
-
122
- await assert.rejects(
123
- async () => {
124
- await api.resources.books.query({
125
- queryParams: { include: ['publisher.country.publishers.books.authors'] }
126
- })
127
- },
128
- {
129
- name: 'RestApiValidationError',
130
- message: /Include path.*exceeds maximum depth of 3/
131
- },
132
- 'Should reject depth 5'
133
- )
134
- })
135
-
136
- it('should validate each include path independently', async () => {
137
- await assert.rejects(
138
- async () => {
139
- await api.resources.books.query({
140
- queryParams: {
141
- include: [
142
- 'publisher', // Valid (depth 1)
143
- 'publisher.country', // Valid (depth 2)
144
- 'publisher.country.publishers.books' // Invalid (depth 4)
145
- ]
146
- }
147
- })
148
- },
149
- {
150
- name: 'RestApiValidationError',
151
- message: /publisher\.country\.publishers\.books.*exceeds maximum depth of 3/
152
- },
153
- 'Should reject when any path exceeds limit'
154
- )
155
- })
156
- })
157
-
158
- describe('Get endpoint validation', () => {
159
- it('should allow includes within depth limit', async () => {
160
- const books = await api.resources.books.query()
161
- const bookId = books.data[0].id
162
-
163
- // Depth 1
164
- const depth1 = await api.resources.books.get({
165
- id: bookId,
166
- queryParams: { include: ['publisher'] }
167
- })
168
- assert(depth1.data.id === bookId, 'Should return correct book')
169
- assert(depth1.included, 'Should have included resources')
170
-
171
- // Depth 3 (at limit)
172
- const depth3 = await api.resources.books.get({
173
- id: bookId,
174
- queryParams: { include: ['publisher.country.publishers'] }
175
- })
176
- assert(depth3.data.id === bookId, 'Should return correct book')
177
- })
178
-
179
- it('should reject includes exceeding depth limit', async () => {
180
- const books = await api.resources.books.query()
181
- const bookId = books.data[0].id
182
-
183
- await assert.rejects(
184
- async () => {
185
- await api.resources.books.get({
186
- id: bookId,
187
- queryParams: { include: ['publisher.country.publishers.books'] }
188
- })
189
- },
190
- {
191
- name: 'RestApiValidationError',
192
- message: /Include path.*exceeds maximum depth of 3/
193
- },
194
- 'Should reject depth 4 on GET'
195
- )
196
- })
197
- })
198
-
199
- describe('Custom depth limits', () => {
200
- it('should respect custom includeDepthLimit configuration', async () => {
201
- // Create API with depth limit of 2 and different table names
202
- const limitedApi = await createLimitedDepthApi(knex)
203
-
204
- // Set up test data for limited API
205
- await cleanTables(knex, [
206
- 'limited_countries', 'limited_publishers', 'limited_authors', 'limited_books', 'limited_book_authors'
207
- ])
208
-
209
- const country = await limitedApi.resources.countries.post({
210
- inputRecord: {
211
- data: {
212
- type: 'countries',
213
- attributes: { name: 'Limited Country', code: 'LC' }
214
- }
215
- }
216
- })
217
-
218
- const publisher = await limitedApi.resources.publishers.post({
219
- inputRecord: {
220
- data: {
221
- type: 'publishers',
222
- attributes: { name: 'Limited Publisher' },
223
- relationships: {
224
- country: { data: { type: 'countries', id: country.data.id } }
225
- }
226
- }
227
- }
228
- })
229
-
230
- const author = await limitedApi.resources.authors.post({
231
- inputRecord: {
232
- data: {
233
- type: 'authors',
234
- attributes: { name: 'Limited Author' },
235
- relationships: {
236
- publisher: { data: { type: 'publishers', id: publisher.data.id } }
237
- }
238
- }
239
- }
240
- })
241
-
242
- // Depth 2 should work
243
- const depth2 = await limitedApi.resources.authors.query({
244
- queryParams: { include: ['publisher.country'] }
245
- })
246
- assert(depth2.data.length > 0, 'Should return authors')
247
-
248
- // Depth 3 should fail
249
- await assert.rejects(
250
- async () => {
251
- await limitedApi.resources.books.query({
252
- queryParams: { include: ['publisher.country.publishers'] }
253
- })
254
- },
255
- {
256
- name: 'RestApiValidationError',
257
- message: /Include path.*exceeds maximum depth of 2/
258
- },
259
- 'Should reject depth 3 with custom limit of 2'
260
- )
261
- })
262
- })
263
-
264
- describe('Edge cases', () => {
265
- it('should handle empty include arrays', async () => {
266
- const result = await api.resources.books.query({
267
- queryParams: { include: [] }
268
- })
269
- assert(result.data.length > 0, 'Should return books')
270
- assert(!result.included, 'Should not have included resources')
271
- })
272
-
273
- it('should handle single-level paths correctly', async () => {
274
- const country = await api.resources.countries.post({
275
- inputRecord: {
276
- data: {
277
- type: 'countries',
278
- attributes: { name: 'Single Level Country', code: `S${Date.now().toString().slice(-2)}` }
279
- }
280
- }
281
- })
282
-
283
- const publisher = await api.resources.publishers.post({
284
- inputRecord: {
285
- data: {
286
- type: 'publishers',
287
- attributes: { name: 'Single Level Publisher' },
288
- relationships: {
289
- country: { data: { type: 'countries', id: country.data.id } }
290
- }
291
- }
292
- }
293
- })
294
-
295
- await api.resources.books.post({
296
- inputRecord: {
297
- data: {
298
- type: 'books',
299
- attributes: { title: 'Single Level Book' },
300
- relationships: {
301
- country: { data: { type: 'countries', id: country.data.id } },
302
- publisher: { data: { type: 'publishers', id: publisher.data.id } }
303
- }
304
- }
305
- }
306
- })
307
-
308
- const result = await api.resources.books.query({
309
- queryParams: { include: ['publisher'] }
310
- })
311
- assert(result.data.length > 0, 'Should return books')
312
- assert(result.included, 'Should have included resources')
313
- })
314
-
315
- it('should count depth correctly with dots in path', async () => {
316
- // "a.b.c" = depth 3
317
- await assert.rejects(
318
- async () => {
319
- await api.resources.books.query({
320
- queryParams: { include: ['a.b.c.d'] }
321
- })
322
- },
323
- {
324
- name: 'RestApiValidationError',
325
- message: /Include path 'a\.b\.c\.d' exceeds maximum depth of 3/
326
- },
327
- 'Should count dots correctly'
328
- )
329
- })
330
- })
331
- })