feat(sanity): content releases

.eslintrc.cjs

@@ -132,6 +132,8 @@ const config = {
             'sortOrder',
             'status',
             'group',
+            'textWeight',
+            'showChangesBy',
           ],
         },
       },

dev/test-studio/package.json

@@ -19,7 +19,7 @@
     "@portabletext/block-tools": "^1.0.2",
     "@portabletext/editor": "^1.21.5",
     "@portabletext/react": "^3.0.0",
-    "@sanity/assist": "^3.0.2",
+    "@sanity/assist": "^3.1.0",
     "@sanity/client": "^6.25.0",
     "@sanity/color": "^3.0.0",
     "@sanity/color-input": "^4.0.1",
@@ -34,7 +34,7 @@
     "@sanity/logos": "^2.1.2",
     "@sanity/migrate": "workspace:*",
     "@sanity/preview-url-secret": "^2.0.0",
-    "@sanity/react-loader": "^1.8.3",
+    "@sanity/react-loader": "^1.10.35",
     "@sanity/tsdoc": "1.0.169",
     "@sanity/types": "workspace:*",
     "@sanity/ui": "^2.11.2",

dev/test-studio/sanity.config.ts

@@ -225,6 +225,7 @@ export default defineConfig([
     dataset: 'playground',
     plugins: [sharedSettings()],
     basePath: '/playground',
+    beta: {eventsAPI: {enabled: true}},
   },
   {
     name: 'listener-events',
@@ -253,6 +254,7 @@ export default defineConfig([
     plugins: [sharedSettings()],
     basePath: '/staging',
     apiHost: 'https://api.sanity.work',
+    beta: {eventsAPI: {enabled: true}},
     auth: {
       loginMethod: 'token',
     },

packages/@sanity/types/src/schema/preview.ts

@@ -10,6 +10,9 @@ export interface PrepareViewOptions {
 
 /** @public */
 export interface PreviewValue {
+  _id?: string
+  _createdAt?: string
+  _updatedAt?: string
   title?: string
   subtitle?: string
   description?: string

packages/sanity/package.json

@@ -256,6 +256,7 @@
     "rimraf": "^5.0.10",
     "rxjs": "^7.8.0",
     "rxjs-exhaustmap-with-trailing": "^2.1.1",
+    "rxjs-mergemap-array": "^0.1.0",
     "sanity-diff-patch": "^4.0.0",
     "scroll-into-view-if-needed": "^3.0.3",
     "semver": "^7.3.5",

packages/sanity/src/_singletons/context/EventsContext.ts

@@ -0,0 +1,11 @@
+import {createContext} from 'sanity/_createContext'
+
+import type {EventsStore} from '../../core/store/events/types'
+
+/**
+ * @internal
+ */
+export const EventsContext = createContext<EventsStore | null>(
+  'sanity/_singletons/context/events',
+  null,
+)

packages/sanity/src/_singletons/context/ReleasesMetadataContext.ts

@@ -0,0 +1,12 @@
+import {createContext} from 'sanity/_createContext'
+
+import type {ReleasesMetadataContextValue} from '../../core/releases/contexts/ReleasesMetadataProvider'
+
+/**
+ * @internal
+ * @hidden
+ */
+export const ReleasesMetadataContext = createContext<ReleasesMetadataContextValue | null>(
+  'sanity/_singletons/context/releases-metadata',
+  null,
+)

packages/sanity/src/_singletons/context/ReleasesTableContext.ts

@@ -0,0 +1,11 @@
+import {createContext} from 'sanity/_createContext'
+
+import type {TableContextValue} from '../../core/releases/tool/components/Table/TableProvider'
+
+/**
+ * @internal
+ */
+export const TableContext = createContext<TableContextValue | null>(
+  'sanity/_singletons/context/releases-table',
+  null,
+)

packages/sanity/src/_singletons/index.ts

@@ -21,6 +21,7 @@ export * from './context/DocumentFieldActionsContext'
 export * from './context/DocumentIdContext'
 export * from './context/DocumentPaneContext'
 export * from './context/DocumentSheetListContext'
+export * from './context/EventsContext'
 export * from './context/FieldActionsContext'
 export * from './context/FormBuilderContext'
 export * from './context/FormCallbacksContext'
@@ -51,6 +52,8 @@ export * from './context/PresentationSharedStateContext'
 export * from './context/PreviewCardContext'
 export * from './context/ReferenceInputOptionsContext'
 export * from './context/ReferenceItemRefContext'
+export * from './context/ReleasesMetadataContext'
+export * from './context/ReleasesTableContext'
 export * from './context/ResourceCacheContext'
 export * from './context/ReviewChangesContext'
 export * from './context/RouterContext'

packages/sanity/src/core/comments/context/comments/CommentsProvider.tsx

@@ -1,3 +1,4 @@
+import {type ReleaseId} from '@sanity/client'
 import {type Path} from '@sanity/types'
 import {orderBy} from 'lodash'
 import {memo, type ReactNode, useCallback, useMemo, useState} from 'react'
@@ -6,7 +7,7 @@ import {CommentsContext} from 'sanity/_singletons'
 import {useEditState, useSchema, useUserListWithPermissions} from '../../../hooks'
 import {useCurrentUser} from '../../../store'
 import {useAddonDataset, useWorkspace} from '../../../studio'
-import {getPublishedId} from '../../../util'
+import {getPublishedId, getVersionId} from '../../../util'
 import {
   type CommentOperationsHookOptions,
   useCommentOperations,
@@ -43,6 +44,7 @@ export interface CommentsProviderProps {
   children: ReactNode
   documentId: string
   documentType: string
+  releaseId?: ReleaseId
   type: CommentsType
   sortOrder: 'asc' | 'desc'
 
@@ -78,20 +80,23 @@ export const CommentsProvider = memo(function CommentsProvider(props: CommentsPr
     selectedCommentId,
     isConnecting,
     onPathOpen,
+    releaseId,
   } = props
   const commentsEnabled = useCommentsEnabled()
   const [status, setStatus] = useState<CommentStatus>('open')
   const {client, createAddonDataset, isCreatingDataset} = useAddonDataset()
   const publishedId = getPublishedId(documentId)
-  const editState = useEditState(publishedId, documentType, 'low')
+  const versionOrPublishedId = releaseId ? getVersionId(documentId, releaseId) : publishedId
+  const editState = useEditState(publishedId, documentType, 'low', releaseId)
   const schemaType = useSchema().get(documentType)
   const currentUser = useCurrentUser()
 
   const {name: workspaceName, dataset, projectId} = useWorkspace()
 
   const documentValue = useMemo(() => {
+    if (releaseId) return editState.version
     return editState.draft || editState.published
-  }, [editState.draft, editState.published])
+  }, [editState.version, editState.draft, editState.published, releaseId])
 
   const documentRevisionId = useMemo(() => documentValue?._rev, [documentValue])
 
@@ -112,7 +117,8 @@ export const CommentsProvider = memo(function CommentsProvider(props: CommentsPr
     error,
     loading,
   } = useCommentsStore({
-    documentId: publishedId,
+    documentId,
+    releaseId,
     client,
     transactionsIdMap,
     onLatestTransactionIdReceived: handleOnLatestTransactionIdReceived,
@@ -229,7 +235,7 @@ export const CommentsProvider = memo(function CommentsProvider(props: CommentsPr
         client,
         currentUser,
         dataset,
-        documentId: publishedId,
+        documentId: versionOrPublishedId,
         documentRevisionId,
         documentType,
         getComment,
@@ -257,7 +263,7 @@ export const CommentsProvider = memo(function CommentsProvider(props: CommentsPr
         client,
         currentUser,
         dataset,
-        publishedId,
+        versionOrPublishedId,
         documentRevisionId,
         documentType,
         getComment,
@@ -277,7 +283,7 @@ export const CommentsProvider = memo(function CommentsProvider(props: CommentsPr
 
   const ctxValue = useMemo(
     (): CommentsContextValue => ({
-      documentId,
+      documentId: versionOrPublishedId,
       documentType,
 
       isCreatingDataset,
@@ -310,7 +316,7 @@ export const CommentsProvider = memo(function CommentsProvider(props: CommentsPr
       mentionOptions,
     }),
     [
-      documentId,
+      versionOrPublishedId,
       documentType,
       isCreatingDataset,
       status,

packages/sanity/src/core/comments/store/useCommentsStore.ts

@@ -1,8 +1,13 @@
-import {type ListenEvent, type ListenOptions, type SanityClient} from '@sanity/client'
+import {
+  type ListenEvent,
+  type ListenOptions,
+  type ReleaseId,
+  type SanityClient,
+} from '@sanity/client'
 import {useCallback, useEffect, useMemo, useReducer, useRef, useState} from 'react'
 import {catchError, of} from 'rxjs'
 
-import {getPublishedId} from '../../util'
+import {getPublishedId, getVersionId} from '../../util'
 import {type CommentDocument, type Loadable} from '../types'
 import {commentsReducer, type CommentsReducerAction, type CommentsReducerState} from './reducer'
 
@@ -14,6 +19,7 @@ export interface CommentsStoreOptions {
   documentId: string
   onLatestTransactionIdReceived: (documentId: DocumentId) => void
   transactionsIdMap: Map<DocumentId, TransactionId>
+  releaseId?: ReleaseId
 }
 
 interface CommentsStoreReturnType extends Loadable<CommentDocument[]> {
@@ -56,15 +62,20 @@ const QUERY_SORT_ORDER = `order(${SORT_FIELD} ${SORT_ORDER})`
 const QUERY = `*[${QUERY_FILTERS.join(' && ')}] ${QUERY_PROJECTION} | ${QUERY_SORT_ORDER}`
 
 export function useCommentsStore(opts: CommentsStoreOptions): CommentsStoreReturnType {
-  const {client, documentId, onLatestTransactionIdReceived, transactionsIdMap} = opts
+  const {client, documentId, onLatestTransactionIdReceived, transactionsIdMap, releaseId} = opts
 
   const [state, dispatch] = useReducer(commentsReducer, INITIAL_STATE)
   const [loading, setLoading] = useState<boolean>(client !== null)
   const [error, setError] = useState<Error | null>(null)
 
   const didInitialFetch = useRef<boolean>(false)
 
-  const params = useMemo(() => ({documentId: getPublishedId(documentId)}), [documentId])
+  const params = useMemo(
+    () => ({
+      documentId: releaseId ? getVersionId(documentId, releaseId) : getPublishedId(documentId),
+    }),
+    [documentId, releaseId],
+  )
 
   const initialFetch = useCallback(async () => {
     if (!client) {