@pipedream/grain 0.1.0 → 1.0.0

package/actions/get-recording/get-recording.mjs

@@ -1,57 +1,92 @@
-import {
-  INTELLIGENCE_NOTES_FORMAT_OPTIONS,
-  TRANSCRIPT_FORMAT_OPTIONS,
-} from "../../common/constants.mjs";
-import { parseObject } from "../../common/utils.mjs";
 import grain from "../../grain.app.mjs";
 
 export default {
   key: "grain-get-recording",
   name: "Get Recording",
-  description: "Fetches a specific recording by its ID from Grain, optionally including the transcript and intelligence notes. [See the documentation](https://grainhq.notion.site/grain-public-api-877184aa82b54c77a875083c1b560de9)",
-  version: "0.0.1",
+  description: "Fetches a specific recording by its ID from Grain, returning its metadata (title, times, URL, tags, teams, meeting type)."
+    + " Enable the optional include props to add highlights, participants, AI action items, AI summary, calendar event, HubSpot data, or screenshares to the response."
+    + " Use **List Recordings** to find recording IDs, and **Get Transcript** to fetch the full transcript."
+    + " [See the documentation](https://developers.grain.com/#get-recording)",
+  version: "1.0.0",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
   type: "action",
   props: {
     grain,
-    recordId: {
+    recordingId: {
       propDefinition: [
         grain,
-        "recordId",
+        "recordingId",
       ],
     },
-    transcriptFormat: {
-      type: "string",
-      label: "Transcript Format",
-      description: "Format for the transcript",
-      options: TRANSCRIPT_FORMAT_OPTIONS,
-      optional: true,
+    highlights: {
+      propDefinition: [
+        grain,
+        "highlights",
+      ],
     },
-    intelligenceNotesFormat: {
-      type: "string",
-      label: "Intelligence Notes Format",
-      description: "Format for the intelligence notes",
-      options: INTELLIGENCE_NOTES_FORMAT_OPTIONS,
-      optional: true,
+    participants: {
+      propDefinition: [
+        grain,
+        "participants",
+      ],
+    },
+    aiActionItems: {
+      propDefinition: [
+        grain,
+        "aiActionItems",
+      ],
     },
-    allowedIntelligenceNotes: {
-      type: "string[]",
-      label: "Allowed Intelligence Notes",
-      description: "Whitelist of intelligence notes section titles",
+    aiSummary: {
+      propDefinition: [
+        grain,
+        "aiSummary",
+      ],
+    },
+    calendarEvent: {
+      propDefinition: [
+        grain,
+        "calendarEvent",
+      ],
+    },
+    hubspot: {
+      propDefinition: [
+        grain,
+        "hubspot",
+      ],
+    },
+    screenshares: {
+      type: "boolean",
+      label: "Include Screenshares",
+      description: "Include the recording's screenshare ranges in the response",
       optional: true,
     },
   },
   async run({ $ }) {
+    const include = {
+      highlights: this.highlights,
+      participants: this.participants,
+      ai_action_items: this.aiActionItems,
+      ai_summary: this.aiSummary,
+      calendar_event: this.calendarEvent,
+      hubspot: this.hubspot,
+      screenshares: this.screenshares,
+    };
+
     const response = await this.grain.fetchRecording({
       $,
-      recordId: this.recordId,
-      params: {
-        transcript_format: this.transcriptFormat,
-        intelligence_notes_format: this.intelligenceNotesFormat,
-        allowed_intelligence_notes: parseObject(this.allowedIntelligenceNotes),
+      recordingId: this.recordingId,
+      data: {
+        include: Object.fromEntries(Object.entries(include).filter(([
+          , value,
+        ]) => value)),
       },
     });
 
-    $.export("$summary", `Successfully fetched recording with ID ${this.recordId}`);
+    $.export("$summary", `Successfully fetched recording with ID ${this.recordingId}`);
     return response;
   },
 };

package/actions/get-transcript/get-transcript.mjs

@@ -0,0 +1,45 @@
+import { TRANSCRIPT_FORMAT_OPTIONS } from "../../common/constants.mjs";
+import grain from "../../grain.app.mjs";
+
+export default {
+  key: "grain-get-transcript",
+  name: "Get Transcript",
+  description: "Fetches the full transcript of a Grain recording."
+    + " The `json` format returns structured segments with speaker, participant ID, start/end times in milliseconds, and text;"
+    + " `txt`, `vtt`, and `srt` return plain text or subtitle formats."
+    + " Use **List Recordings** to find recording IDs; use **Get Recording** for the recording's metadata instead of its transcript."
+    + " [See the documentation](https://developers.grain.com/#get-recording-transcript-json)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    grain,
+    recordingId: {
+      propDefinition: [
+        grain,
+        "recordingId",
+      ],
+    },
+    format: {
+      type: "string",
+      label: "Format",
+      description: "Format for the transcript",
+      options: TRANSCRIPT_FORMAT_OPTIONS,
+      default: "json",
+    },
+  },
+  async run({ $ }) {
+    const response = await this.grain.fetchTranscript({
+      $,
+      recordingId: this.recordingId,
+      format: this.format,
+    });
+
+    $.export("$summary", `Successfully fetched transcript for recording ${this.recordingId}`);
+    return response;
+  },
+};

package/actions/list-recordings/list-recordings.mjs

@@ -0,0 +1,89 @@
+import grain from "../../grain.app.mjs";
+
+export default {
+  key: "grain-list-recordings",
+  name: "List Recordings",
+  description: "Lists Grain recordings, optionally filtered by start datetime range (ISO8601), title search, or participant scope."
+    + " Automatically paginates and returns up to Max Results recordings."
+    + " Use this to find recording IDs for **Get Recording** and **Get Transcript**."
+    + " [See the documentation](https://developers.grain.com/#list-recordings)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    grain,
+    beforeDatetime: {
+      type: "string",
+      label: "Before Datetime",
+      description: "Only return recordings that started before this ISO8601 datetime. E.g. `2025-01-01T00:00:00Z`",
+      optional: true,
+    },
+    afterDatetime: {
+      type: "string",
+      label: "After Datetime",
+      description: "Only return recordings that started after this ISO8601 datetime. E.g. `2025-01-01T00:00:00Z`",
+      optional: true,
+    },
+    titleSearch: {
+      type: "string",
+      label: "Title Search",
+      description: "Only return recordings whose title matches this search string",
+      optional: true,
+    },
+    participantScope: {
+      type: "string",
+      label: "Participant Scope",
+      description: "Only return recordings whose participants are all internal, or that include external participants",
+      options: [
+        "internal",
+        "external",
+      ],
+      optional: true,
+    },
+    maxResults: {
+      type: "integer",
+      label: "Max Results",
+      description: "Maximum number of recordings to return. Must be a positive integer.",
+      optional: true,
+      default: 100,
+      min: 1,
+    },
+  },
+  async run({ $ }) {
+    const filter = {
+      before_datetime: this.beforeDatetime,
+      after_datetime: this.afterDatetime,
+      title_search: this.titleSearch,
+      participant_scope: this.participantScope,
+    };
+
+    const recordings = [];
+    let cursor;
+    do {
+      const {
+        recordings: page, cursor: nextCursor,
+      } = await this.grain.listRecordings({
+        $,
+        data: {
+          cursor,
+          filter,
+        },
+      });
+      recordings.push(...page);
+      cursor = nextCursor;
+    } while (cursor && recordings.length < this.maxResults);
+
+    if (recordings.length > this.maxResults) {
+      recordings.length = this.maxResults;
+    }
+
+    $.export("$summary", `Successfully fetched ${recordings.length} recording${recordings.length === 1
+      ? ""
+      : "s"}`);
+    return recordings;
+  },
+};

package/common/constants.mjs

@@ -4,22 +4,15 @@ export const TRANSCRIPT_FORMAT_OPTIONS = [
     value: "json",
   },
   {
-    label: "VTT",
-    value: "vtt",
-  },
-];
-
-export const INTELLIGENCE_NOTES_FORMAT_OPTIONS = [
-  {
-    label: "JSON",
-    value: "json",
+    label: "Text",
+    value: "txt",
   },
   {
-    label: "Markdown",
-    value: "md",
+    label: "VTT",
+    value: "vtt",
   },
   {
-    label: "Text",
-    value: "text",
+    label: "SRT",
+    value: "srt",
   },
 ];

package/grain.app.mjs

@@ -4,16 +4,16 @@ export default {
   type: "app",
   app: "grain",
   propDefinitions: {
-    recordId: {
+    recordingId: {
       type: "string",
-      label: "Record ID",
-      description: "The ID of the recording to fetch",
-      async options({ prevContext: { nextPage } }) {
+      label: "Recording ID",
+      description: "The ID of the recording to fetch. Use **List Recordings** to find recording IDs.",
+      async options({ prevContext }) {
         const {
           recordings, cursor,
         } = await this.listRecordings({
-          params: {
-            cursor: nextPage,
+          data: {
+            cursor: prevContext?.nextPage,
           },
         });
         return {
@@ -29,42 +29,63 @@ export default {
         };
       },
     },
-    viewId: {
-      type: "string",
-      label: "View ID",
-      description: "The ID of the view to fetch",
-      async options({
-        type, prevContext: { nextPage },
-      }) {
-        const {
-          views, cursor,
-        } = await this.listViews({
-          params: {
-            type_filter: type,
-            cursor: nextPage,
-          },
-        });
-        return {
-          options: views.map(({
-            id: value, name: label,
-          }) => ({
-            value,
-            label,
-          })),
-          context: {
-            nextPage: cursor,
-          },
-        };
-      },
+    highlights: {
+      type: "boolean",
+      label: "Include Highlights",
+      description: "Whether to include the recording's highlights",
+      optional: true,
+    },
+    participants: {
+      type: "boolean",
+      label: "Include Participants",
+      description: "Whether to include the recording's participants",
+      optional: true,
+    },
+    calendarEvent: {
+      type: "boolean",
+      label: "Include Calendar Event",
+      description: "Whether to include the recording's calendar event data",
+      optional: true,
+    },
+    hubspot: {
+      type: "boolean",
+      label: "Include HubSpot Data",
+      description: "Whether to include associated HubSpot data",
+      optional: true,
+    },
+    aiActionItems: {
+      type: "boolean",
+      label: "Include AI Action Items",
+      description: "Whether to include the recording's AI action items",
+      optional: true,
+    },
+    aiSummary: {
+      type: "boolean",
+      label: "Include AI Summary",
+      description: "Whether to include the recording's AI summary",
+      optional: true,
+    },
+    transcript: {
+      type: "boolean",
+      label: "Include Transcript",
+      description: "Whether to include the highlight's transcript",
+      optional: true,
+    },
+    speakers: {
+      type: "boolean",
+      label: "Include Speakers",
+      description: "Whether to include the highlight's speakers",
+      optional: true,
     },
   },
   methods: {
     _baseUrl() {
-      return "https://grain.com/_/public-api";
+      return "https://api.grain.com/_/public-api/v2";
     },
     _headers() {
       return {
-        Authorization: `Bearer ${this.$auth.oauth_access_token}`,
+        "Authorization": `Bearer ${this.$auth.oauth_access_token}`,
+        "Public-Api-Version": "2025-10-31",
       };
     },
     _makeRequest({
@@ -76,33 +97,64 @@ export default {
         ...opts,
       });
     },
+    /**
+     * Fetch a page of recordings matching the supplied filters.
+     * @param {object} [opts={}] Request context and data containing filter, include, and cursor.
+     * @returns {Promise<object>} Recordings and the cursor for the next page.
+     */
     listRecordings(opts = {}) {
       return this._makeRequest({
+        method: "POST",
         path: "/recordings",
         ...opts,
       });
     },
-    listViews(opts = {}) {
+    /**
+     * Fetch recording metadata and optional related data.
+     * @param {object} opts Request context, recordingId, and data containing include options.
+     * @returns {Promise<object>} The recording.
+     */
+    fetchRecording({
+      recordingId, ...opts
+    }) {
       return this._makeRequest({
-        path: "/views",
+        method: "POST",
+        path: `/recordings/${recordingId}`,
         ...opts,
       });
     },
-    fetchRecording({
-      recordId, ...opts
+    /**
+     * Fetch a recording's transcript in the requested format.
+     * @param {object} opts Request context, recordingId, and format (json, txt, vtt, or srt).
+     * @returns {Promise<object[]|string>} Transcript segments for JSON, or transcript text.
+     */
+    fetchTranscript({
+      recordingId, format, ...opts
     }) {
       return this._makeRequest({
-        path: `/recordings/${recordId}`,
+        path: `/recordings/${recordingId}/transcript${format === "json"
+          ? ""
+          : `.${format}`}`,
         ...opts,
       });
     },
+    /**
+     * Register a webhook for a Grain event type.
+     * @param {object} [opts={}] Request options with hook_url, hook_type, and include in data.
+     * @returns {Promise<object>} The registered hook, including its ID.
+     */
     createWebhook(opts = {}) {
       return this._makeRequest({
         method: "POST",
-        path: "/hooks",
+        path: "/hooks/create",
         ...opts,
       });
     },
+    /**
+     * Remove a webhook registration.
+     * @param {string} hookId The ID returned when the hook was created.
+     * @returns {Promise<object>} The API's success response.
+     */
     deleteWebhook(hookId) {
       return this._makeRequest({
         method: "DELETE",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/grain",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Pipedream Grain Components",
   "main": "grain.app.mjs",
   "keywords": [
@@ -13,6 +13,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@pipedream/platform": "^3.0.3"
+    "@pipedream/platform": "^3.1.1"
   }
 }

package/sources/common/base.mjs

@@ -3,7 +3,10 @@ import grain from "../../grain.app.mjs";
 export default {
   props: {
     grain,
-    http: "$.interface.http",
+    http: {
+      type: "$.interface.http",
+      customResponse: true,
+    },
     db: "$.service.db",
   },
   methods: {
@@ -13,30 +16,49 @@ export default {
     _setHookId(hookId) {
       this.db.set("hookId", hookId);
     },
+    getInclude() {
+      return undefined;
+    },
+    getTimestamp() {
+      return Date.now();
+    },
   },
   hooks: {
     async activate() {
       const response = await this.grain.createWebhook({
         data: {
-          version: 2,
           hook_url: this.http.endpoint,
-          view_id: this.viewId,
-          actions: this.getAction(),
+          hook_type: this.getHookType(),
+          include: this.getInclude(),
         },
       });
       this._setHookId(response.id);
     },
     async deactivate() {
       const webhookId = this._getHookId();
-      await this.grain.deleteWebhook(webhookId);
+      if (webhookId) {
+        await this.grain.deleteWebhook(webhookId);
+      }
     },
   },
   async run({ body }) {
-    if (!body.data) return;
+    this.http.respond({
+      status: 200,
+    });
+
+    if (!body?.data?.id || body.type !== this.getHookType()) return;
+
+    const ts = this.getTimestamp(body);
+    // Grain doesn't document a delivery ID. Added/deleted events dedupe on the
+    // resource ID alone (there's only ever one). Updated events concatenate the
+    // resource ID with the payload-derived timestamp so retries of the same
+    // update share an ID while a later, distinct update gets a new one.
+    const id = body.type.endsWith("_updated")
+      ? `${body.data.id}:${ts}`
+      : body.data.id;
 
-    const ts = Date.parse(new Date());
     this.$emit(body, {
-      id: `${body.data.id}-${ts}`,
+      id,
       summary: this.getSummary(body),
       ts,
     });

package/sources/common/highlight.mjs

@@ -0,0 +1,38 @@
+import common from "./base.mjs";
+
+export default {
+  ...common,
+  props: {
+    ...common.props,
+    transcript: {
+      propDefinition: [
+        common.props.grain,
+        "transcript",
+      ],
+    },
+    speakers: {
+      propDefinition: [
+        common.props.grain,
+        "speakers",
+      ],
+    },
+  },
+  methods: {
+    ...common.methods,
+    getInclude() {
+      const include = {
+        transcript: this.transcript,
+        speakers: this.speakers,
+      };
+      return Object.fromEntries(Object.entries(include).filter(([
+        , value,
+      ]) => value));
+    },
+    getTimestamp({ data }) {
+      const ts = Date.parse(data.created_datetime);
+      return Number.isNaN(ts)
+        ? Date.now()
+        : ts;
+    },
+  },
+};

package/sources/common/recording.mjs

@@ -0,0 +1,66 @@
+import common from "./base.mjs";
+
+export default {
+  ...common,
+  props: {
+    ...common.props,
+    highlights: {
+      propDefinition: [
+        common.props.grain,
+        "highlights",
+      ],
+    },
+    participants: {
+      propDefinition: [
+        common.props.grain,
+        "participants",
+      ],
+    },
+    calendarEvent: {
+      propDefinition: [
+        common.props.grain,
+        "calendarEvent",
+      ],
+    },
+    hubspot: {
+      propDefinition: [
+        common.props.grain,
+        "hubspot",
+      ],
+    },
+    aiActionItems: {
+      propDefinition: [
+        common.props.grain,
+        "aiActionItems",
+      ],
+    },
+    aiSummary: {
+      propDefinition: [
+        common.props.grain,
+        "aiSummary",
+      ],
+    },
+  },
+  methods: {
+    ...common.methods,
+    getInclude() {
+      const include = {
+        highlights: this.highlights,
+        participants: this.participants,
+        calendar_event: this.calendarEvent,
+        hubspot: this.hubspot,
+        ai_action_items: this.aiActionItems,
+        ai_summary: this.aiSummary,
+      };
+      return Object.fromEntries(Object.entries(include).filter(([
+        , value,
+      ]) => value));
+    },
+    getTimestamp({ data }) {
+      const ts = Date.parse(data.end_datetime);
+      return Number.isNaN(ts)
+        ? Date.now()
+        : ts;
+    },
+  },
+};

package/sources/new-highlight-instant/new-highlight-instant.mjs

@@ -1,32 +1,18 @@
-import common from "../common/base.mjs";
+import common from "../common/highlight.mjs";
 import sampleEmit from "./test-event.mjs";
 
 export default {
   ...common,
   key: "grain-new-highlight-instant",
   name: "New Highlight (Instant)",
-  description: "Emit new event when a highlight that matches the filter is added.",
-  version: "0.0.1",
+  description: "Emit new event when a highlight is added. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
   dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "highlights",
-        }),
-      ],
-    },
-  },
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "added",
-      ];
+    getHookType() {
+      return "highlight_added";
     },
     getSummary({ data }) {
       return `New highlight added: ${data.id}`;

package/sources/new-highlight-instant/test-event.mjs

@@ -2,16 +2,20 @@ export default {
   "type": "highlight_added",
   "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
   "data": {
-    "id": "vjQRUKsWw0aFpCT3531eGbr8V0HJrMjKMEIcAUmP",
-	  "recording_id": "b5185ccb-9a08-458c-9be1-db17a03fb14c",
-	  "text": "testing 123 #test",
+    "id": "a14e5af9-d28e-43e9-902b-bc07419082eb",
+    "recording_id": "b5185ccb-9a08-458c-9be1-db17a03fb14c",
+    "text": "testing 123 #test",
     "transcript": "expected, that there was a mews in a lane which runs down by one wall of the garden. I lent the ostlers a hand in rubbing down their horses, and received in exchange twopence, a glass of half-and-half, two fills of shag tobacco, and as much information as I could desire about Miss Adler, to say nothing of half a dozen other people in",
-    "speakers": ["Andy Arbol"],
+    "speakers": [
+      "Andy Arbol"
+    ],
     "timestamp": 3080,
     "duration": 15000,
-	  "created_datetime": "2021-07-29T23:16:34Z",
-    "url": "https://grain.com/highlight/vjQRUKsWw0aFpCT3531eGbr8V0HJrMjKMEIcAUmP",
+    "created_datetime": "2021-07-29T23:16:34Z",
+    "url": "https://grain.com/highlight/a14e5af9-d28e-43e9-902b-bc07419082eb",
     "thumbnail_url": "https://media.grain.com/clips/v1/a14e5af9-d28e-43e9-902b-bc07419082eb/57zB8z52l7BKPoOvkS9KNyUi7LDSsNEh.jpeg",
-    "tags": ["test"]
+    "tags": [
+      "test"
+    ]
   }
-}
+};

package/sources/new-recording-instant/new-recording-instant.mjs

@@ -1,32 +1,18 @@
-import common from "../common/base.mjs";
+import common from "../common/recording.mjs";
 import sampleEmit from "./test-event.mjs";
 
 export default {
   ...common,
   key: "grain-new-recording-instant",
   name: "New Recording (Instant)",
-  description: "Emit new event when a recording that matches the filter is added.",
-  version: "0.0.1",
+  description: "Emit new event when a recording is added. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
   dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "recordings",
-        }),
-      ],
-    },
-  },
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "added",
-      ];
+    getHookType() {
+      return "recording_added";
     },
     getSummary({ data }) {
       return `New recording added: ${data.id}`;

package/sources/new-recording-instant/test-event.mjs

@@ -2,11 +2,26 @@ export default {
   "type": "recording_added",
   "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
   "data": {
-    "id": "b5185ccb-9a08-458c-9be1-db17a03fb14c",
-    "title": "Sample Recording",
-    "url": "https://grain.com/recordings/b5185ccb-9a08-458c-9be1-db17a03fb14c/Kz5t1kAyPtt78hcxbSOJHJzFiPpZmUIeDVFXWzP0",
-    "start_datetime": "2021-07-29T23:13:17Z",
-	  "end_datetime": "2021-07-29T23:16:18Z",
-    "public_thumbnail_url": null // Only non-null if recording share state is public
-  }
-}
+    "id": "pppp6666-qq77-rr88-ss99-tttt00000000",
+    "title": "All Hands",
+    "start_datetime": "2025-01-01T09:30:00Z",
+    "end_datetime": "2025-01-01T10:00:00Z",
+    "duration_ms": 1800000,
+    "media_type": "video",
+    "source": "zoom",
+    "url": "https://grain.com/share/recording/pppp6666-qq77-rr88-ss99-tttt00000000",
+    "thumbnail_url": "https://media.grain.com/public_thumbnails/recordings/pppp6666",
+    "tags": [],
+    "teams": [
+      {
+        "id": "aaaa1111-bb22-cc33-dd44-eeee55555555",
+        "name": "My Team",
+      },
+    ],
+    "meeting_type": {
+      "id": "ffff6666-gg77-hh88-ii99-jjjj00000000",
+      "name": "Project & Team Coordination",
+      "scope": "internal",
+    },
+  },
+};

package/sources/new-story-instant/new-story-instant.mjs

@@ -5,28 +5,20 @@ export default {
   ...common,
   key: "grain-new-story-instant",
   name: "New Story (Instant)",
-  description: "Emit new event when a story that matches the filter is added.",
-  version: "0.0.1",
+  description: "Emit new event when a story is added. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
   dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "stories",
-        }),
-      ],
-    },
-  },
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "added",
-      ];
+    getHookType() {
+      return "story_added";
+    },
+    getTimestamp({ data }) {
+      const ts = Date.parse(data.created_datetime);
+      return Number.isNaN(ts)
+        ? Date.now()
+        : ts;
     },
     getSummary({ data }) {
       return `New story added: ${data.id}`;

package/sources/new-story-instant/test-event.mjs

@@ -8,8 +8,10 @@ export default {
     "url": "https://grain.com/app/stories/89bd4a02-25f5-42c0-bd40-aa4c94be13ce",
     "public_url": "https://grain.com/share/story/89bd4a02-25f5-42c0-bd40-aa4c94be13ce/2hAEpxLsIN8hDQ48aQ1Yi1MIirv1qCPSJNhxXEoj",
     "banner_image_url": "https://media.grain.com/public/story_thumbnails/07.png",
-	  "created_datetime": "2021-07-29T23:16:34Z",
-	  "last_edited_datetime": "2021-08-29T23:16:34Z",
-    "tags": ["customer"]
+    "created_datetime": "2021-07-29T23:16:34Z",
+    "last_edited_datetime": "2021-08-29T23:16:34Z",
+    "tags": [
+      "customer"
+    ]
   }
-}
+};

package/sources/removed-highlight-instant/removed-highlight-instant.mjs

@@ -5,31 +5,17 @@ export default {
   ...common,
   key: "grain-removed-highlight-instant",
   name: "New Highlight Removed (Instant)",
-  description: "Emit new event when a highlight is removed.",
-  version: "0.0.1",
+  description: "Emit new event when a highlight is removed. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
   dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "highlights",
-        }),
-      ],
-    },
-  },
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "removed",
-      ];
+    getHookType() {
+      return "highlight_deleted";
     },
     getSummary({ data }) {
-      return `Highlight removed from recording ${data.recording_id}`;
+      return `Highlight removed: ${data.id}`;
     },
   },
   sampleEmit,

package/sources/removed-highlight-instant/test-event.mjs

@@ -1,8 +1,8 @@
 export default {
-  "type": "highlight_removed",
+  "type": "highlight_deleted",
   "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
   "data": {
-    "id": "vjQRUKsWw0aFpCT3531eGbr8V0HJrMjKMEIcAUmP",
+    "id": "a14e5af9-d28e-43e9-902b-bc07419082eb",
     "recording_id": "b5185ccb-9a08-458c-9be1-db17a03fb14c"
   }
-}
+};

package/sources/removed-recording-instant/removed-recording-instant.mjs

@@ -5,28 +5,14 @@ export default {
   ...common,
   key: "grain-removed-recording-instant",
   name: "New Recording Removed (Instant)",
-  description: "Emit new event when a recording is removed.",
-  version: "0.0.1",
+  description: "Emit new event when a recording is removed. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
   dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "recordings",
-        }),
-      ],
-    },
-  },
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "removed",
-      ];
+    getHookType() {
+      return "recording_deleted";
     },
     getSummary({ data }) {
       return `Recording removed: ${data.id}`;

package/sources/removed-recording-instant/test-event.mjs

@@ -1,7 +1,7 @@
 export default {
-  "type": "recording_removed",
+  "type": "recording_deleted",
   "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
   "data": {
     "id": "b5185ccb-9a08-458c-9be1-db17a03fb14c"
   }
-}
+};

package/sources/removed-story-instant/removed-story-instant.mjs

@@ -5,28 +5,14 @@ export default {
   ...common,
   key: "grain-removed-story-instant",
   name: "New Story Removed (Instant)",
-  description: "Emit new event when a story is removed.",
-  version: "0.0.1",
+  description: "Emit new event when a story is removed. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
   dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "stories",
-        }),
-      ],
-    },
-  },
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "removed",
-      ];
+    getHookType() {
+      return "story_deleted";
     },
     getSummary({ data }) {
       return `New story removed: ${data.id}`;

package/sources/removed-story-instant/test-event.mjs

@@ -1,7 +1,7 @@
 export default {
-  "type": "story_removed",
+  "type": "story_deleted",
   "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
   "data": {
     "id": "1aff0fe4-6575-4d5f-a462-aaf09f5f17a6"
   }
-}
+};

package/sources/updated-highlight-instant/test-event.mjs

@@ -2,16 +2,20 @@ export default {
   "type": "highlight_updated",
   "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
   "data": {
-    "id": "vjQRUKsWw0aFpCT3531eGbr8V0HJrMjKMEIcAUmP",
-	  "recording_id": "b5185ccb-9a08-458c-9be1-db17a03fb14c",
-	  "text": "testing 123 #test",
+    "id": "a14e5af9-d28e-43e9-902b-bc07419082eb",
+    "recording_id": "b5185ccb-9a08-458c-9be1-db17a03fb14c",
+    "text": "testing 123 #test",
     "transcript": "expected, that there was a mews in a lane which runs down by one wall of the garden. I lent the ostlers a hand in rubbing down their horses, and received in exchange twopence, a glass of half-and-half, two fills of shag tobacco, and as much information as I could desire about Miss Adler, to say nothing of half a dozen other people in",
-    "speakers": ["Andy Arbol"],
+    "speakers": [
+      "Andy Arbol"
+    ],
     "timestamp": 3080,
     "duration": 15000,
-	  "created_datetime": "2021-07-29T23:16:34Z",
-    "url": "https://grain.com/highlight/vjQRUKsWw0aFpCT3531eGbr8V0HJrMjKMEIcAUmP",
+    "created_datetime": "2021-07-29T23:16:34Z",
+    "url": "https://grain.com/highlight/a14e5af9-d28e-43e9-902b-bc07419082eb",
     "thumbnail_url": "https://media.grain.com/clips/v1/a14e5af9-d28e-43e9-902b-bc07419082eb/57zB8z52l7BKPoOvkS9KNyUi7LDSsNEh.jpeg",
-    "tags": ["test"]
+    "tags": [
+      "test"
+    ]
   }
-}
+};

package/sources/updated-highlight-instant/updated-highlight-instant.mjs

@@ -1,32 +1,18 @@
-import common from "../common/base.mjs";
+import common from "../common/highlight.mjs";
 import sampleEmit from "./test-event.mjs";
 
 export default {
   ...common,
   key: "grain-updated-highlight-instant",
   name: "New Highlight Updated (Instant)",
-  description: "Emit new event when a highlight is updated.",
-  version: "0.0.1",
+  description: "Emit new event when a highlight is updated. Each webhook delivery emits an event, including retries. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
-  dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "highlights",
-        }),
-      ],
-    },
-  },
+  // Grain does not document a delivery ID; deduping by resource ID would discard later updates.
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "updated",
-      ];
+    getHookType() {
+      return "highlight_updated";
     },
     getSummary({ data }) {
       return `New highlight updated: ${data.id}`;

package/sources/updated-recording-instant/test-event.mjs

@@ -2,11 +2,26 @@ export default {
   "type": "recording_updated",
   "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
   "data": {
-    "id": "b5185ccb-9a08-458c-9be1-db17a03fb14c",
-    "title": "Sample Recording",
-    "url": "https://grain.com/recordings/b5185ccb-9a08-458c-9be1-db17a03fb14c/Kz5t1kAyPtt78hcxbSOJHJzFiPpZmUIeDVFXWzP0",
-    "start_datetime": "2021-07-29T23:13:17Z",
-	  "end_datetime": "2021-07-29T23:16:18Z",
-    "public_thumbnail_url": null // Only non-null if recording share state is public
-  }
-}
+    "id": "pppp6666-qq77-rr88-ss99-tttt00000000",
+    "title": "All Hands — Updated",
+    "start_datetime": "2025-01-01T09:30:00Z",
+    "end_datetime": "2025-01-01T10:00:00Z",
+    "duration_ms": 1800000,
+    "media_type": "video",
+    "source": "zoom",
+    "url": "https://grain.com/share/recording/pppp6666-qq77-rr88-ss99-tttt00000000",
+    "thumbnail_url": "https://media.grain.com/public_thumbnails/recordings/pppp6666",
+    "tags": [],
+    "teams": [
+      {
+        "id": "aaaa1111-bb22-cc33-dd44-eeee55555555",
+        "name": "My Team",
+      },
+    ],
+    "meeting_type": {
+      "id": "ffff6666-gg77-hh88-ii99-jjjj00000000",
+      "name": "Project & Team Coordination",
+      "scope": "internal",
+    },
+  },
+};

package/sources/updated-recording-instant/updated-recording-instant.mjs

@@ -1,32 +1,18 @@
-import common from "../common/base.mjs";
+import common from "../common/recording.mjs";
 import sampleEmit from "./test-event.mjs";
 
 export default {
   ...common,
   key: "grain-updated-recording-instant",
   name: "New Recording Updated (Instant)",
-  description: "Emit new event when a recording is updated.",
-  version: "0.0.1",
+  description: "Emit new event when a recording is updated. Each webhook delivery emits an event, including retries. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
-  dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "recordings",
-        }),
-      ],
-    },
-  },
+  // Grain does not document a delivery ID; deduping by resource ID would discard later updates.
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "updated",
-      ];
+    getHookType() {
+      return "recording_updated";
     },
     getSummary({ data }) {
       return `New recording updated: ${data.id}`;

package/sources/updated-story-instant/test-event.mjs

@@ -8,8 +8,10 @@ export default {
     "url": "https://grain.com/app/stories/89bd4a02-25f5-42c0-bd40-aa4c94be13ce",
     "public_url": "https://grain.com/share/story/89bd4a02-25f5-42c0-bd40-aa4c94be13ce/2hAEpxLsIN8hDQ48aQ1Yi1MIirv1qCPSJNhxXEoj",
     "banner_image_url": "https://media.grain.com/public/story_thumbnails/07.png",
-	  "created_datetime": "2021-07-29T23:16:34Z",
-	  "last_edited_datetime": "2021-08-29T23:16:34Z",
-    "tags": ["customer"]
+    "created_datetime": "2021-07-29T23:16:34Z",
+    "last_edited_datetime": "2021-08-29T23:16:34Z",
+    "tags": [
+      "customer"
+    ]
   }
-}
+};

package/sources/updated-story-instant/updated-story-instant.mjs

@@ -5,28 +5,20 @@ export default {
   ...common,
   key: "grain-updated-story-instant",
   name: "New Story Updated (Instant)",
-  description: "Emit new event when a story is updated.",
-  version: "0.0.1",
+  description: "Emit new event when a story is updated. Each webhook delivery emits an event, including retries. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
   type: "source",
-  dedupe: "unique",
-  props: {
-    ...common.props,
-    viewId: {
-      propDefinition: [
-        common.props.grain,
-        "viewId",
-        () => ({
-          type: "stories",
-        }),
-      ],
-    },
-  },
+  // Grain does not document a delivery ID; deduping by resource ID would discard later updates.
   methods: {
     ...common.methods,
-    getAction() {
-      return [
-        "updated",
-      ];
+    getHookType() {
+      return "story_updated";
+    },
+    getTimestamp({ data }) {
+      const ts = Date.parse(data.last_edited_datetime);
+      return Number.isNaN(ts)
+        ? Date.now()
+        : ts;
     },
     getSummary({ data }) {
       return `New story updated: ${data.id}`;

package/common/utils.mjs

@@ -1,24 +0,0 @@
-export const parseObject = (obj) => {
-  if (!obj) return undefined;
-
-  if (Array.isArray(obj)) {
-    return obj.map((item) => {
-      if (typeof item === "string") {
-        try {
-          return JSON.parse(item);
-        } catch (e) {
-          return item;
-        }
-      }
-      return item;
-    });
-  }
-  if (typeof obj === "string") {
-    try {
-      return JSON.parse(obj);
-    } catch (e) {
-      return obj;
-    }
-  }
-  return obj;
-};