feat: [EXT-2242] Add typings and expose metadata methods

lib/entry.ts

@@ -1,6 +1,6 @@
 import { Channel } from './channel'
 import { MemoizedSignal } from './signal'
-import { EntryAPI, EntryFieldInfo, TaskAPI } from './types'
+import { EntryAPI, EntryFieldInfo, Metadata, TaskAPI } from './types'
 
 const taskMethods: Array<keyof TaskAPI> = [
   'getTask',
@@ -18,13 +18,19 @@ export default function createEntry(
 ): EntryAPI {
   let sys = entryData.sys
   const sysChanged = new MemoizedSignal(sys)
-  const entryMetadata = entryData.metadata
+  let metadata = entryData.metadata
+  const metadataChanged = new MemoizedSignal(metadata)
 
   channel.addHandler('sysChanged', (_sys: any) => {
     sys = _sys
     sysChanged.dispatch(sys)
   })
 
+  channel.addHandler('metadataChanged', (_metadata: Metadata) => {
+    metadata = _metadata
+    metadataChanged.dispatch(metadata)
+  })
+
   const taskApi = {} as TaskAPI
 
   taskMethods.forEach((methodName) => {
@@ -44,7 +50,13 @@ export default function createEntry(
       acc[info.id] = createEntryField(info)
       return acc
     }, {}),
-    ...(entryMetadata ? { metadata: entryMetadata } : {}),
+    ...(metadata ? { metadata } : {}),
+    getMetadata() {
+      return metadata
+    },
+    onMetadataChanged(handler: VoidFunction) {
+      return metadataChanged.attach(handler)
+    },
     ...taskApi,
   }
 }

lib/types.ts

@@ -98,6 +98,10 @@ export interface EntrySys {
   contentType: Link
 }
 
+export interface Metadata {
+  tags?: Link[]
+}
+
 /* Field API */
 export interface FieldAPI {
   /** The ID of a field is defined in an entry's content type. */
@@ -227,9 +231,9 @@ export interface EntryAPI extends TaskAPI {
    * Optional metadata on an entry
    * @deprecated
    */
-  metadata?: {
-    tags?: Link[]
-  }
+  metadata?: Metadata
+  getMetadata: () => Metadata | undefined
+  onMetadataChanged: (callback: (metadata?: Metadata) => void) => VoidFunction
 }
 
 /* Scheduled Actions */