Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Allow making context specific requests using the data module #32961

Merged
merged 5 commits into from
Jun 25, 2021

Conversation

youknowriad
Copy link
Contributor

@youknowriad youknowriad commented Jun 24, 2021

closes #11643

We've been struggling with context specific data request for a long time in Gutenberg. This is due to the fact that the data module had always had a single representation of what an entity record could look like.

In this PR, I'm exploring allowing context specific requests. I'm doing so by separating the results from requests of different context, it's like considering these as different entities entirely.

Hopefully, this will allow us to get rid of all the adhoc apiFetch usage across the code base.

@youknowriad youknowriad added Framework Issues related to broader framework topics, especially as it relates to javascript [Package] Core data /packages/core-data [Type] New API New API to be used by plugin developers or package users. labels Jun 24, 2021
@youknowriad youknowriad self-assigned this Jun 24, 2021
@youknowriad youknowriad requested a review from nerrad as a code owner June 24, 2021 14:36
@youknowriad
Copy link
Contributor Author

(Don't review this just yet, I have some local changes changing the approach entirely but I'm having trouble pushing them due to internet issues, I'll update here once I'm done)

@github-actions
Copy link

github-actions bot commented Jun 24, 2021

Size Change: +1.76 kB (0%)

Total Size: 1.04 MB

Filename Size Change
build/a11y/index.min.js 1.12 kB +1 B (0%)
build/block-directory/index.min.js 6.62 kB +5 B (0%)
build/block-editor/index.min.js 119 kB -20 B (0%)
build/block-library/blocks/media-text/editor-rtl.css 263 B +87 B (+49%) 🚨
build/block-library/blocks/media-text/editor.css 264 B +88 B (+50%) 🆘
build/block-library/editor-rtl.css 9.72 kB +16 B (0%)
build/block-library/editor.css 9.72 kB +17 B (0%)
build/block-library/index.min.js 145 kB +141 B (0%)
build/block-serialization-default-parser/index.min.js 1.29 kB -1 B (0%)
build/blocks/index.min.js 47.3 kB -6 B (0%)
build/components/index.min.js 182 kB +1.31 kB (+1%)
build/core-data/index.min.js 12.4 kB +195 B (+2%)
build/customize-widgets/index.min.js 10 kB -2 B (0%)
build/data-controls/index.min.js 828 B +1 B (0%)
build/data/index.min.js 7.23 kB +2 B (0%)
build/date/index.min.js 31.8 kB +1 B (0%)
build/edit-navigation/index.min.js 13.9 kB -69 B (0%)
build/edit-post/index.min.js 58.6 kB -111 B (0%)
build/edit-site/index.min.js 25.9 kB -107 B (0%)
build/edit-widgets/index.min.js 16.1 kB +11 B (0%)
build/edit-widgets/style-rtl.css 3.66 kB +90 B (+3%)
build/edit-widgets/style.css 3.66 kB +91 B (+3%)
build/editor/index.min.js 38.6 kB +9 B (0%)
build/element/index.min.js 3.44 kB +2 B (0%)
build/format-library/index.min.js 5.68 kB -2 B (0%)
build/hooks/index.min.js 1.76 kB -1 B (0%)
build/html-entities/index.min.js 628 B -1 B (0%)
build/is-shallow-equal/index.min.js 710 B +1 B (0%)
build/keycodes/index.min.js 1.43 kB -1 B (0%)
build/list-reusable-blocks/index.min.js 2.07 kB -1 B (0%)
build/notices/index.min.js 1.07 kB -1 B (0%)
build/nux/index.min.js 2.31 kB -1 B (0%)
build/plugins/index.min.js 1.99 kB +1 B (0%)
build/react-i18n/index.min.js 924 B -1 B (0%)
build/rich-text/index.min.js 10.6 kB +1 B (0%)
build/server-side-render/index.min.js 1.63 kB -1 B (0%)
build/viewport/index.min.js 1.28 kB +1 B (0%)
build/widgets/index.min.js 6.21 kB +1 B (0%)
build/widgets/style-rtl.css 866 B +6 B (+1%)
build/widgets/style.css 867 B +6 B (+1%)
ℹ️ View Unchanged
Filename Size
build/annotations/index.min.js 2.93 kB
build/api-fetch/index.min.js 2.44 kB
build/autop/index.min.js 2.28 kB
build/blob/index.min.js 672 B
build/block-directory/style-rtl.css 989 B
build/block-directory/style.css 990 B
build/block-editor/style-rtl.css 13.5 kB
build/block-editor/style.css 13.5 kB
build/block-library/blocks/archives/editor-rtl.css 61 B
build/block-library/blocks/archives/editor.css 60 B
build/block-library/blocks/archives/style-rtl.css 65 B
build/block-library/blocks/archives/style.css 65 B
build/block-library/blocks/audio/editor-rtl.css 58 B
build/block-library/blocks/audio/editor.css 58 B
build/block-library/blocks/audio/style-rtl.css 112 B
build/block-library/blocks/audio/style.css 112 B
build/block-library/blocks/audio/theme-rtl.css 125 B
build/block-library/blocks/audio/theme.css 125 B
build/block-library/blocks/block/editor-rtl.css 161 B
build/block-library/blocks/block/editor.css 161 B
build/block-library/blocks/button/editor-rtl.css 475 B
build/block-library/blocks/button/editor.css 474 B
build/block-library/blocks/button/style-rtl.css 603 B
build/block-library/blocks/button/style.css 602 B
build/block-library/blocks/buttons/editor-rtl.css 315 B
build/block-library/blocks/buttons/editor.css 315 B
build/block-library/blocks/buttons/style-rtl.css 375 B
build/block-library/blocks/buttons/style.css 375 B
build/block-library/blocks/calendar/style-rtl.css 208 B
build/block-library/blocks/calendar/style.css 208 B
build/block-library/blocks/categories/editor-rtl.css 84 B
build/block-library/blocks/categories/editor.css 83 B
build/block-library/blocks/categories/style-rtl.css 79 B
build/block-library/blocks/categories/style.css 79 B
build/block-library/blocks/code/style-rtl.css 90 B
build/block-library/blocks/code/style.css 90 B
build/block-library/blocks/code/theme-rtl.css 131 B
build/block-library/blocks/code/theme.css 131 B
build/block-library/blocks/columns/editor-rtl.css 190 B
build/block-library/blocks/columns/editor.css 190 B
build/block-library/blocks/columns/style-rtl.css 422 B
build/block-library/blocks/columns/style.css 422 B
build/block-library/blocks/cover/editor-rtl.css 670 B
build/block-library/blocks/cover/editor.css 670 B
build/block-library/blocks/cover/style-rtl.css 1.22 kB
build/block-library/blocks/cover/style.css 1.23 kB
build/block-library/blocks/embed/editor-rtl.css 486 B
build/block-library/blocks/embed/editor.css 486 B
build/block-library/blocks/embed/style-rtl.css 401 B
build/block-library/blocks/embed/style.css 400 B
build/block-library/blocks/embed/theme-rtl.css 124 B
build/block-library/blocks/embed/theme.css 124 B
build/block-library/blocks/file/editor-rtl.css 301 B
build/block-library/blocks/file/editor.css 300 B
build/block-library/blocks/file/style-rtl.css 255 B
build/block-library/blocks/file/style.css 255 B
build/block-library/blocks/file/view.min.js 780 B
build/block-library/blocks/freeform/editor-rtl.css 2.44 kB
build/block-library/blocks/freeform/editor.css 2.44 kB
build/block-library/blocks/gallery/editor-rtl.css 704 B
build/block-library/blocks/gallery/editor.css 705 B
build/block-library/blocks/gallery/style-rtl.css 1.06 kB
build/block-library/blocks/gallery/style.css 1.06 kB
build/block-library/blocks/gallery/theme-rtl.css 122 B
build/block-library/blocks/gallery/theme.css 122 B
build/block-library/blocks/group/editor-rtl.css 160 B
build/block-library/blocks/group/editor.css 160 B
build/block-library/blocks/group/style-rtl.css 57 B
build/block-library/blocks/group/style.css 57 B
build/block-library/blocks/group/theme-rtl.css 93 B
build/block-library/blocks/group/theme.css 93 B
build/block-library/blocks/heading/editor-rtl.css 152 B
build/block-library/blocks/heading/editor.css 152 B
build/block-library/blocks/heading/style-rtl.css 76 B
build/block-library/blocks/heading/style.css 76 B
build/block-library/blocks/home-link/style-rtl.css 259 B
build/block-library/blocks/home-link/style.css 259 B
build/block-library/blocks/html/editor-rtl.css 281 B
build/block-library/blocks/html/editor.css 281 B
build/block-library/blocks/image/editor-rtl.css 729 B
build/block-library/blocks/image/editor.css 727 B
build/block-library/blocks/image/style-rtl.css 481 B
build/block-library/blocks/image/style.css 485 B
build/block-library/blocks/image/theme-rtl.css 124 B
build/block-library/blocks/image/theme.css 124 B
build/block-library/blocks/latest-comments/style-rtl.css 281 B
build/block-library/blocks/latest-comments/style.css 282 B
build/block-library/blocks/latest-posts/editor-rtl.css 137 B
build/block-library/blocks/latest-posts/editor.css 137 B
build/block-library/blocks/latest-posts/style-rtl.css 529 B
build/block-library/blocks/latest-posts/style.css 529 B
build/block-library/blocks/list/style-rtl.css 63 B
build/block-library/blocks/list/style.css 63 B
build/block-library/blocks/media-text/style-rtl.css 492 B
build/block-library/blocks/media-text/style.css 489 B
build/block-library/blocks/more/editor-rtl.css 434 B
build/block-library/blocks/more/editor.css 434 B
build/block-library/blocks/navigation-link/editor-rtl.css 633 B
build/block-library/blocks/navigation-link/editor.css 634 B
build/block-library/blocks/navigation-link/style-rtl.css 94 B
build/block-library/blocks/navigation-link/style.css 94 B
build/block-library/blocks/navigation/editor-rtl.css 1.55 kB
build/block-library/blocks/navigation/editor.css 1.55 kB
build/block-library/blocks/navigation/style-rtl.css 1.63 kB
build/block-library/blocks/navigation/style.css 1.63 kB
build/block-library/blocks/navigation/view.min.js 2.87 kB
build/block-library/blocks/nextpage/editor-rtl.css 395 B
build/block-library/blocks/nextpage/editor.css 395 B
build/block-library/blocks/page-list/editor-rtl.css 310 B
build/block-library/blocks/page-list/editor.css 311 B
build/block-library/blocks/page-list/style-rtl.css 240 B
build/block-library/blocks/page-list/style.css 240 B
build/block-library/blocks/paragraph/editor-rtl.css 157 B
build/block-library/blocks/paragraph/editor.css 157 B
build/block-library/blocks/paragraph/style-rtl.css 247 B
build/block-library/blocks/paragraph/style.css 248 B
build/block-library/blocks/post-author/editor-rtl.css 209 B
build/block-library/blocks/post-author/editor.css 209 B
build/block-library/blocks/post-author/style-rtl.css 183 B
build/block-library/blocks/post-author/style.css 184 B
build/block-library/blocks/post-comments-form/style-rtl.css 140 B
build/block-library/blocks/post-comments-form/style.css 140 B
build/block-library/blocks/post-comments/style-rtl.css 360 B
build/block-library/blocks/post-comments/style.css 359 B
build/block-library/blocks/post-content/editor-rtl.css 139 B
build/block-library/blocks/post-content/editor.css 139 B
build/block-library/blocks/post-excerpt/editor-rtl.css 73 B
build/block-library/blocks/post-excerpt/editor.css 73 B
build/block-library/blocks/post-excerpt/style-rtl.css 69 B
build/block-library/blocks/post-excerpt/style.css 69 B
build/block-library/blocks/post-featured-image/editor-rtl.css 338 B
build/block-library/blocks/post-featured-image/editor.css 338 B
build/block-library/blocks/post-featured-image/style-rtl.css 141 B
build/block-library/blocks/post-featured-image/style.css 141 B
build/block-library/blocks/post-template/editor-rtl.css 100 B
build/block-library/blocks/post-template/editor.css 99 B
build/block-library/blocks/post-template/style-rtl.css 379 B
build/block-library/blocks/post-template/style.css 380 B
build/block-library/blocks/post-title/style-rtl.css 60 B
build/block-library/blocks/post-title/style.css 60 B
build/block-library/blocks/preformatted/style-rtl.css 103 B
build/block-library/blocks/preformatted/style.css 103 B
build/block-library/blocks/pullquote/editor-rtl.css 183 B
build/block-library/blocks/pullquote/editor.css 183 B
build/block-library/blocks/pullquote/style-rtl.css 318 B
build/block-library/blocks/pullquote/style.css 318 B
build/block-library/blocks/pullquote/theme-rtl.css 169 B
build/block-library/blocks/pullquote/theme.css 169 B
build/block-library/blocks/query-pagination-numbers/editor-rtl.css 122 B
build/block-library/blocks/query-pagination-numbers/editor.css 121 B
build/block-library/blocks/query-pagination/editor-rtl.css 270 B
build/block-library/blocks/query-pagination/editor.css 262 B
build/block-library/blocks/query-pagination/style-rtl.css 168 B
build/block-library/blocks/query-pagination/style.css 168 B
build/block-library/blocks/query-title/editor-rtl.css 86 B
build/block-library/blocks/query-title/editor.css 86 B
build/block-library/blocks/query/editor-rtl.css 131 B
build/block-library/blocks/query/editor.css 132 B
build/block-library/blocks/quote/style-rtl.css 169 B
build/block-library/blocks/quote/style.css 169 B
build/block-library/blocks/quote/theme-rtl.css 221 B
build/block-library/blocks/quote/theme.css 221 B
build/block-library/blocks/rss/editor-rtl.css 201 B
build/block-library/blocks/rss/editor.css 202 B
build/block-library/blocks/rss/style-rtl.css 290 B
build/block-library/blocks/rss/style.css 290 B
build/block-library/blocks/search/editor-rtl.css 211 B
build/block-library/blocks/search/editor.css 211 B
build/block-library/blocks/search/style-rtl.css 359 B
build/block-library/blocks/search/style.css 362 B
build/block-library/blocks/search/theme-rtl.css 64 B
build/block-library/blocks/search/theme.css 64 B
build/block-library/blocks/separator/editor-rtl.css 99 B
build/block-library/blocks/separator/editor.css 99 B
build/block-library/blocks/separator/style-rtl.css 251 B
build/block-library/blocks/separator/style.css 251 B
build/block-library/blocks/separator/theme-rtl.css 172 B
build/block-library/blocks/separator/theme.css 172 B
build/block-library/blocks/shortcode/editor-rtl.css 512 B
build/block-library/blocks/shortcode/editor.css 512 B
build/block-library/blocks/site-logo/editor-rtl.css 440 B
build/block-library/blocks/site-logo/editor.css 441 B
build/block-library/blocks/site-logo/style-rtl.css 154 B
build/block-library/blocks/site-logo/style.css 154 B
build/block-library/blocks/site-tagline/editor-rtl.css 87 B
build/block-library/blocks/site-tagline/editor.css 87 B
build/block-library/blocks/site-title/editor-rtl.css 85 B
build/block-library/blocks/site-title/editor.css 85 B
build/block-library/blocks/social-link/editor-rtl.css 164 B
build/block-library/blocks/social-link/editor.css 165 B
build/block-library/blocks/social-links/editor-rtl.css 800 B
build/block-library/blocks/social-links/editor.css 799 B
build/block-library/blocks/social-links/style-rtl.css 1.34 kB
build/block-library/blocks/social-links/style.css 1.34 kB
build/block-library/blocks/spacer/editor-rtl.css 308 B
build/block-library/blocks/spacer/editor.css 308 B
build/block-library/blocks/spacer/style-rtl.css 48 B
build/block-library/blocks/spacer/style.css 48 B
build/block-library/blocks/table/editor-rtl.css 478 B
build/block-library/blocks/table/editor.css 478 B
build/block-library/blocks/table/style-rtl.css 480 B
build/block-library/blocks/table/style.css 480 B
build/block-library/blocks/table/theme-rtl.css 188 B
build/block-library/blocks/table/theme.css 188 B
build/block-library/blocks/tag-cloud/editor-rtl.css 118 B
build/block-library/blocks/tag-cloud/editor.css 118 B
build/block-library/blocks/tag-cloud/style-rtl.css 94 B
build/block-library/blocks/tag-cloud/style.css 94 B
build/block-library/blocks/template-part/editor-rtl.css 551 B
build/block-library/blocks/template-part/editor.css 550 B
build/block-library/blocks/template-part/theme-rtl.css 101 B
build/block-library/blocks/template-part/theme.css 101 B
build/block-library/blocks/term-description/editor-rtl.css 90 B
build/block-library/blocks/term-description/editor.css 90 B
build/block-library/blocks/text-columns/editor-rtl.css 95 B
build/block-library/blocks/text-columns/editor.css 95 B
build/block-library/blocks/text-columns/style-rtl.css 166 B
build/block-library/blocks/text-columns/style.css 166 B
build/block-library/blocks/verse/style-rtl.css 87 B
build/block-library/blocks/verse/style.css 87 B
build/block-library/blocks/video/editor-rtl.css 569 B
build/block-library/blocks/video/editor.css 570 B
build/block-library/blocks/video/style-rtl.css 173 B
build/block-library/blocks/video/style.css 173 B
build/block-library/blocks/video/theme-rtl.css 124 B
build/block-library/blocks/video/theme.css 124 B
build/block-library/common-rtl.css 1.26 kB
build/block-library/common.css 1.26 kB
build/block-library/reset-rtl.css 514 B
build/block-library/reset.css 515 B
build/block-library/style-rtl.css 10.2 kB
build/block-library/style.css 10.2 kB
build/block-library/theme-rtl.css 692 B
build/block-library/theme.css 693 B
build/block-serialization-spec-parser/index.min.js 3.06 kB
build/components/style-rtl.css 16.2 kB
build/components/style.css 16.2 kB
build/compose/index.min.js 10.2 kB
build/customize-widgets/style-rtl.css 1.46 kB
build/customize-widgets/style.css 1.45 kB
build/deprecated/index.min.js 738 B
build/dom-ready/index.min.js 577 B
build/dom/index.min.js 4.62 kB
build/edit-navigation/style-rtl.css 3.09 kB
build/edit-navigation/style.css 3.09 kB
build/edit-post/classic-rtl.css 454 B
build/edit-post/classic.css 454 B
build/edit-post/style-rtl.css 7.04 kB
build/edit-post/style.css 7.03 kB
build/edit-site/style-rtl.css 4.76 kB
build/edit-site/style.css 4.75 kB
build/editor/style-rtl.css 3.91 kB
build/editor/style.css 3.9 kB
build/escape-html/index.min.js 739 B
build/format-library/style-rtl.css 637 B
build/format-library/style.css 639 B
build/i18n/index.min.js 3.73 kB
build/keyboard-shortcuts/index.min.js 1.74 kB
build/list-reusable-blocks/style-rtl.css 629 B
build/list-reusable-blocks/style.css 628 B
build/media-utils/index.min.js 3.08 kB
build/nux/style-rtl.css 718 B
build/nux/style.css 716 B
build/primitives/index.min.js 1.03 kB
build/priority-queue/index.min.js 791 B
build/redux-routine/index.min.js 2.82 kB
build/reusable-blocks/index.min.js 2.56 kB
build/reusable-blocks/style-rtl.css 225 B
build/reusable-blocks/style.css 225 B
build/shortcode/index.min.js 1.68 kB
build/token-list/index.min.js 848 B
build/url/index.min.js 1.95 kB
build/warning/index.min.js 1.13 kB
build/wordcount/index.min.js 1.24 kB

compressed-size-action

@youknowriad youknowriad changed the title All making context specific requests using the data module Allow making context specific requests using the data module Jun 24, 2021
@youknowriad youknowriad force-pushed the add/allow-alternative-context-data-package branch from 8b29ace to b284577 Compare June 24, 2021 16:22
@youknowriad
Copy link
Contributor Author

Ok I managed to push the changes, this is ready to review.

@youknowriad youknowriad requested a review from ockham June 24, 2021 19:45
Co-authored-by: Nik Tsekouras <[email protected]>
@youknowriad youknowriad added the Backport to WP 6.7 Beta/RC Pull request that needs to be backported to the WordPress major release that's currently in beta label Jun 25, 2021
@youknowriad
Copy link
Contributor Author

I'm adding this to the backport list to be able to use it to fix the permissions checks for the site blocks.

Copy link
Contributor

@ntsekouras ntsekouras left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a great addition and you did it amazingly fast after discussing it yesterday 🚀 !

Great work Riad!!

@youknowriad youknowriad merged commit 5e8e8b4 into trunk Jun 25, 2021
@youknowriad youknowriad deleted the add/allow-alternative-context-data-package branch June 25, 2021 10:42
@github-actions github-actions bot added this to the Gutenberg 11.0 milestone Jun 25, 2021
Copy link
Member

@jsnajdr jsnajdr left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The packages/core-data/src/reducer reducer also handles the RECEIVE_ITEMS action in the edits part. Should it also check the action.context field and ignore responses that don't have the edit context?

The receiveEntityRecords and removeItems have an invalidateCache flag. The getEntityRecords.shouldInvalidate handler that looks at this flag should correctly and carefully choose the queries to invalidate: only the context-specific one for RECEIVE_ITEMS, and all contexts for REMOVE_ITEMS.

@@ -41,6 +41,7 @@ export function getQueryParts( query ) {
perPage: 10,
fields: null,
include: null,
context: 'default',
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If the context query param is omitted, the default value is view.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, we do enforce "edit" context in the API requests, even if the context is "view" by default for the server, that's why I opted on a new "default"/"empty" context in the frontend. Backward compatibility.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that mean that calling getQueriedItems without context will issue an API request with ?context=edit query param and will store the result under the state[ 'default' ] key?

And that getQueriedItems( state, { context: 'edit' } ) will issue a request with the same ?context=edit query param but this time will store the result as state[ 'edit' ]?

Copy link
Contributor Author

@youknowriad youknowriad Jun 28, 2021

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does that mean that calling getQueriedItems without context will issue an API request with ?context=edit query param and will store the result under the state[ 'default' ] key?

In most entities yes, but entities can define another set of default REST API parameters.

I agree it's not ideal that edit is different than default in this cases, but solving it properly would have required a small change in the entities API (explicitly define a default context instead of relying on a more global baseURLParams). I think it's something we can try but I thought it was not important for v1 of this.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree that it's not terribly important. I mostly wanted to confirm that this little flaw is really there, and that it's not just my misunderstanding.

@youknowriad
Copy link
Contributor Author

The receiveEntityRecords and removeItems have an invalidateCache flag. The getEntityRecords.shouldInvalidate handler that looks at this flag should correctly and carefully choose the queries to invalidate: only the context-specific one for RECEIVE_ITEMS, and all contexts for REMOVE_ITEMS.

I think creating a record in a one context, should invalidate queries in all contexts

@youknowriad youknowriad removed the Backport to WP 6.7 Beta/RC Pull request that needs to be backported to the WordPress major release that's currently in beta label Jun 25, 2021
youknowriad added a commit that referenced this pull request Jun 25, 2021
youknowriad added a commit that referenced this pull request Jun 25, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Framework Issues related to broader framework topics, especially as it relates to javascript [Package] Core data /packages/core-data [Type] New API New API to be used by plugin developers or package users.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Data storage layer should properly handle both context=view and context=edit
3 participants