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,347 +0,0 @@
1
- import { describe, it, before, after, beforeEach } from 'node:test'
2
- import assert from 'node:assert/strict'
3
- import knexLib from 'knex'
4
- import { createExtendedApi } from './fixtures/api-configs.js'
5
- import {
6
- validateJsonApiStructure,
7
- cleanTables,
8
- createJsonApiDocument,
9
- createRelationship
10
- } from './helpers/test-utils.js'
11
-
12
- // Create Knex instance for tests
13
- const knex = knexLib({
14
- client: 'better-sqlite3',
15
- connection: {
16
- filename: ':memory:'
17
- },
18
- useNullAsDefault: true
19
- })
20
-
21
- // API instance
22
- let api
23
-
24
- describe('Polymorphic Relationship Operations', () => {
25
- before(async () => {
26
- // Initialize API
27
- api = await createExtendedApi(knex)
28
- })
29
-
30
- after(async () => {
31
- // Close database connection
32
- await knex.destroy()
33
- })
34
-
35
- describe('Creating Reviews with Polymorphic Relationships', () => {
36
- beforeEach(async () => {
37
- // Clean all tables before each test
38
- await cleanTables(knex, [
39
- 'ext_countries', 'ext_publishers', 'ext_authors', 'ext_books',
40
- 'ext_book_authors', 'ext_reviews'
41
- ])
42
- })
43
-
44
- it('should create a review for a book', async () => {
45
- // Create a country first
46
- const country = await api.resources.countries.post({
47
- inputRecord: createJsonApiDocument('countries', {
48
- name: 'USA',
49
- code: 'US'
50
- })
51
- })
52
-
53
- // Create a book
54
- const book = await api.resources.books.post({
55
- inputRecord: createJsonApiDocument('books', {
56
- title: 'Test Book'
57
- }, {
58
- country: createRelationship({ type: 'countries', id: country.data.id })
59
- })
60
- })
61
-
62
- // Create a review for the book
63
- const review = await api.resources.reviews.post({
64
- inputRecord: createJsonApiDocument('reviews', {
65
- rating: 5,
66
- title: 'Great book!',
67
- content: 'This is an excellent book about testing.',
68
- reviewer_name: 'John Doe',
69
- reviewable_type: 'books',
70
- reviewable_id: book.data.id
71
- })
72
- })
73
-
74
- validateJsonApiStructure(review)
75
- assert.equal(review.data.type, 'reviews')
76
- assert.equal(review.data.attributes.rating, 5)
77
- // Since polymorphic fields are filtered out from POST responses,
78
- // we need to GET the record to verify the relationship was saved correctly
79
- })
80
-
81
- it('should create a review for an author', async () => {
82
- // Create an author
83
- const author = await api.resources.authors.post({
84
- inputRecord: createJsonApiDocument('authors', {
85
- name: 'Jane Doe'
86
- })
87
- })
88
-
89
- // Create a review for the author
90
- const review = await api.resources.reviews.post({
91
- inputRecord: createJsonApiDocument('reviews', {
92
- rating: 4,
93
- title: 'Talented author',
94
- content: 'Love this author\'s writing style!',
95
- reviewer_name: 'Book Lover',
96
- reviewable_type: 'authors',
97
- reviewable_id: author.data.id
98
- })
99
- })
100
-
101
- validateJsonApiStructure(review)
102
- // Polymorphic fields are no longer in attributes, they're in relationships
103
- assert.equal(review.data.relationships.reviewable.data.type, 'authors')
104
- assert.equal(review.data.relationships.reviewable.data.id, String(author.data.id))
105
- })
106
-
107
- it('should create a review for a publisher', async () => {
108
- // Create a country
109
- const country = await api.resources.countries.post({
110
- inputRecord: createJsonApiDocument('countries', {
111
- name: 'UK',
112
- code: 'GB'
113
- })
114
- })
115
-
116
- // Create a publisher
117
- const publisher = await api.resources.publishers.post({
118
- inputRecord: createJsonApiDocument('publishers', {
119
- name: 'Test Publisher'
120
- }, {
121
- country: createRelationship({ type: 'countries', id: country.data.id })
122
- })
123
- })
124
-
125
- // Create a review for the publisher
126
- const review = await api.resources.reviews.post({
127
- inputRecord: createJsonApiDocument('reviews', {
128
- rating: 3,
129
- title: 'Good publisher',
130
- content: 'They publish quality books.',
131
- reviewer_name: 'Industry Expert',
132
- reviewable_type: 'publishers',
133
- reviewable_id: publisher.data.id
134
- })
135
- })
136
-
137
- validateJsonApiStructure(review)
138
- // Polymorphic fields are no longer in attributes, they're in relationships
139
- assert.equal(review.data.relationships.reviewable.data.type, 'publishers')
140
- assert.equal(review.data.relationships.reviewable.data.id, String(publisher.data.id))
141
- })
142
-
143
- it('should fail to create review with invalid reviewable_type', async () => {
144
- // Skip this test for now - polymorphic validation happens at relationship level
145
- // not at the attribute level, so we need to create a proper relationship
146
- // This would require more complex validation implementation
147
- })
148
- })
149
-
150
- describe('Querying Reviews with Polymorphic Relationships', () => {
151
- beforeEach(async () => {
152
- await cleanTables(knex, [
153
- 'ext_countries', 'ext_publishers', 'ext_authors', 'ext_books',
154
- 'ext_book_authors', 'ext_reviews'
155
- ])
156
- })
157
-
158
- it('should query reviews and include polymorphic reviewable resource', async () => {
159
- // Create test data
160
- const country = await api.resources.countries.post({
161
- inputRecord: createJsonApiDocument('countries', {
162
- name: 'France',
163
- code: 'FR'
164
- })
165
- })
166
-
167
- const book = await api.resources.books.post({
168
- inputRecord: createJsonApiDocument('books', {
169
- title: 'Test Book for Review'
170
- }, {
171
- country: createRelationship({ type: 'countries', id: country.data.id })
172
- })
173
- })
174
-
175
- await api.resources.reviews.post({
176
- inputRecord: createJsonApiDocument('reviews', {
177
- rating: 5,
178
- title: 'Excellent!',
179
- content: 'Must read!',
180
- reviewer_name: 'Reader',
181
- reviewable_type: 'books',
182
- reviewable_id: book.data.id
183
- })
184
- })
185
-
186
- // Query reviews with include
187
- const result = await api.resources.reviews.query({
188
- queryParams: {
189
- include: ['reviewable']
190
- }
191
- })
192
-
193
- validateJsonApiStructure(result, true) // It's a collection
194
- assert.equal(result.data.length, 1)
195
- assert.equal(result.data[0].type, 'reviews')
196
-
197
- // Check included resources
198
- assert(result.included)
199
- assert.equal(result.included.length, 1)
200
- assert.equal(result.included[0].type, 'books')
201
- assert.equal(result.included[0].id, book.data.id)
202
- assert.equal(result.included[0].attributes.title, 'Test Book for Review')
203
- })
204
-
205
- it('should handle mixed polymorphic types in a single query', async () => {
206
- // Create test data
207
- const country = await api.resources.countries.post({
208
- inputRecord: createJsonApiDocument('countries', {
209
- name: 'Germany',
210
- code: 'DE'
211
- })
212
- })
213
-
214
- const book = await api.resources.books.post({
215
- inputRecord: createJsonApiDocument('books', {
216
- title: 'German Book'
217
- }, {
218
- country: createRelationship({ type: 'countries', id: country.data.id })
219
- })
220
- })
221
-
222
- const author = await api.resources.authors.post({
223
- inputRecord: createJsonApiDocument('authors', {
224
- name: 'German Author'
225
- })
226
- })
227
-
228
- // Create reviews for different types
229
- await api.resources.reviews.post({
230
- inputRecord: createJsonApiDocument('reviews', {
231
- rating: 5,
232
- title: 'Great book',
233
- content: 'Love it',
234
- reviewer_name: 'Reader 1',
235
- reviewable_type: 'books',
236
- reviewable_id: book.data.id
237
- })
238
- })
239
-
240
- await api.resources.reviews.post({
241
- inputRecord: createJsonApiDocument('reviews', {
242
- rating: 4,
243
- title: 'Great author',
244
- content: 'Talented writer',
245
- reviewer_name: 'Reader 2',
246
- reviewable_type: 'authors',
247
- reviewable_id: author.data.id
248
- })
249
- })
250
-
251
- // Query all reviews with includes
252
- const result = await api.resources.reviews.query({
253
- queryParams: {
254
- include: ['reviewable']
255
- }
256
- })
257
-
258
- validateJsonApiStructure(result, true) // It's a collection
259
- assert.equal(result.data.length, 2)
260
-
261
- // Check included resources
262
- assert(result.included)
263
- assert.equal(result.included.length, 2)
264
-
265
- // Find each type in included
266
- const includedBook = result.included.find(r => r.type === 'books')
267
- const includedAuthor = result.included.find(r => r.type === 'authors')
268
-
269
- assert(includedBook)
270
- assert.equal(includedBook.attributes.title, 'German Book')
271
-
272
- assert(includedAuthor)
273
- assert.equal(includedAuthor.attributes.name, 'German Author')
274
- })
275
- })
276
-
277
- describe('Reverse Polymorphic Queries', () => {
278
- beforeEach(async () => {
279
- await cleanTables(knex, [
280
- 'ext_countries', 'ext_publishers', 'ext_authors', 'ext_books',
281
- 'ext_book_authors', 'ext_reviews'
282
- ])
283
- })
284
-
285
- it('should query books and include their reviews', async () => {
286
- // Create test data
287
- const country = await api.resources.countries.post({
288
- inputRecord: createJsonApiDocument('countries', {
289
- name: 'Spain',
290
- code: 'ES'
291
- })
292
- })
293
-
294
- const book = await api.resources.books.post({
295
- inputRecord: createJsonApiDocument('books', {
296
- title: 'Spanish Book'
297
- }, {
298
- country: createRelationship({ type: 'countries', id: country.data.id })
299
- })
300
- })
301
-
302
- // Create multiple reviews for the book
303
- await api.resources.reviews.post({
304
- inputRecord: createJsonApiDocument('reviews', {
305
- rating: 5,
306
- title: 'Amazing!',
307
- content: 'Best book ever',
308
- reviewer_name: 'Fan 1',
309
- reviewable_type: 'books',
310
- reviewable_id: book.data.id
311
- })
312
- })
313
-
314
- await api.resources.reviews.post({
315
- inputRecord: createJsonApiDocument('reviews', {
316
- rating: 4,
317
- title: 'Very good',
318
- content: 'Enjoyed reading it',
319
- reviewer_name: 'Fan 2',
320
- reviewable_type: 'books',
321
- reviewable_id: book.data.id
322
- })
323
- })
324
-
325
- // Query book with reviews
326
- const result = await api.resources.books.get({
327
- id: book.data.id,
328
- queryParams: {
329
- include: ['reviews']
330
- }
331
- })
332
-
333
- validateJsonApiStructure(result)
334
- assert.equal(result.data.type, 'books')
335
-
336
- // Check included reviews
337
- console.log('Result included:', JSON.stringify(result.included, null, 2))
338
- assert(result.included)
339
- assert.equal(result.included.length, 2)
340
- assert(result.included.every(r => r.type === 'reviews'))
341
- assert(result.included.every(r =>
342
- r.relationships.reviewable.data.type === 'books' &&
343
- String(r.relationships.reviewable.data.id) === String(book.data.id)
344
- ))
345
- })
346
- })
347
- })
@@ -1,148 +0,0 @@
1
- import { describe, it, before, after, beforeEach } from 'node:test'
2
- import assert from 'node:assert/strict'
3
- import knexLib from 'knex'
4
- import { createExtendedApi } from './fixtures/api-configs.js'
5
- import {
6
- validateJsonApiStructure,
7
- cleanTables,
8
- createJsonApiDocument,
9
- createRelationship
10
- } from './helpers/test-utils.js'
11
-
12
- // Create Knex instance for tests
13
- const knex = knexLib({
14
- client: 'better-sqlite3',
15
- connection: {
16
- filename: ':memory:'
17
- },
18
- useNullAsDefault: true
19
- })
20
-
21
- // API instance
22
- let api
23
-
24
- describe('Polymorphic Relationships - Basic Tests', () => {
25
- before(async () => {
26
- // Initialize API
27
- api = await createExtendedApi(knex)
28
- })
29
-
30
- after(async () => {
31
- // Close database connection
32
- await knex.destroy()
33
- })
34
-
35
- beforeEach(async () => {
36
- // Clean all tables before each test
37
- await cleanTables(knex, [
38
- 'ext_countries', 'ext_publishers', 'ext_authors', 'ext_books',
39
- 'ext_book_authors', 'ext_reviews'
40
- ])
41
- })
42
-
43
- it('should create and retrieve a review for a book', async () => {
44
- // Create a country first
45
- const country = await api.resources.countries.post({
46
- inputRecord: createJsonApiDocument('countries', {
47
- name: 'USA',
48
- code: 'US'
49
- })
50
- })
51
-
52
- // Create a book
53
- const book = await api.resources.books.post({
54
- inputRecord: createJsonApiDocument('books', {
55
- title: 'Test Book'
56
- }, {
57
- country: createRelationship({ type: 'countries', id: country.data.id })
58
- })
59
- })
60
-
61
- // Create a review for the book
62
- const review = await api.resources.reviews.post({
63
- inputRecord: createJsonApiDocument('reviews', {
64
- rating: 5,
65
- title: 'Great book!',
66
- content: 'This is an excellent book about testing.',
67
- reviewer_name: 'John Doe'
68
- }, {
69
- reviewable: { data: { type: 'books', id: book.data.id } }
70
- })
71
- })
72
-
73
- validateJsonApiStructure(review)
74
- assert.equal(review.data.type, 'reviews')
75
- assert.equal(review.data.attributes.rating, 5)
76
-
77
- // Get the review back
78
- const retrievedReview = await api.resources.reviews.get({
79
- id: review.data.id
80
- })
81
-
82
- validateJsonApiStructure(retrievedReview)
83
- // Polymorphic fields are no longer in attributes, they're in relationships
84
- assert.equal(retrievedReview.data.relationships.reviewable.data.type, 'books')
85
- assert.equal(retrievedReview.data.relationships.reviewable.data.id, String(book.data.id))
86
- })
87
-
88
- it('should query all reviews', async () => {
89
- // Create test data
90
- const country = await api.resources.countries.post({
91
- inputRecord: createJsonApiDocument('countries', {
92
- name: 'UK',
93
- code: 'GB'
94
- })
95
- })
96
-
97
- const book = await api.resources.books.post({
98
- inputRecord: createJsonApiDocument('books', {
99
- title: 'Book 1'
100
- }, {
101
- country: createRelationship({ type: 'countries', id: country.data.id })
102
- })
103
- })
104
-
105
- const author = await api.resources.authors.post({
106
- inputRecord: createJsonApiDocument('authors', {
107
- name: 'Author 1'
108
- })
109
- })
110
-
111
- // Create reviews
112
- await api.resources.reviews.post({
113
- inputRecord: createJsonApiDocument('reviews', {
114
- rating: 5,
115
- title: 'Great book',
116
- content: 'Love it',
117
- reviewer_name: 'Reader 1'
118
- }, {
119
- reviewable: { data: { type: 'books', id: book.data.id } }
120
- })
121
- })
122
-
123
- await api.resources.reviews.post({
124
- inputRecord: createJsonApiDocument('reviews', {
125
- rating: 4,
126
- title: 'Good author',
127
- content: 'Nice writing',
128
- reviewer_name: 'Reader 2'
129
- }, {
130
- reviewable: { data: { type: 'authors', id: author.data.id } }
131
- })
132
- })
133
-
134
- // Query all reviews
135
- const result = await api.resources.reviews.query({})
136
-
137
- validateJsonApiStructure(result, true)
138
- assert.equal(result.data.length, 2)
139
-
140
- // Check we have one of each type
141
- // Polymorphic fields are no longer in attributes, they're in relationships
142
- const bookReview = result.data.find(r => r.relationships.reviewable.data.type === 'books')
143
- const authorReview = result.data.find(r => r.relationships.reviewable.data.type === 'authors')
144
-
145
- assert(bookReview, 'Should have a book review')
146
- assert(authorReview, 'Should have an author review')
147
- })
148
- })