@pipedream/grain 0.0.1 → 1.0.0

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

@@ -0,0 +1,92 @@
+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, 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,
+    recordingId: {
+      propDefinition: [
+        grain,
+        "recordingId",
+      ],
+    },
+    highlights: {
+      propDefinition: [
+        grain,
+        "highlights",
+      ],
+    },
+    participants: {
+      propDefinition: [
+        grain,
+        "participants",
+      ],
+    },
+    aiActionItems: {
+      propDefinition: [
+        grain,
+        "aiActionItems",
+      ],
+    },
+    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({
+      $,
+      recordingId: this.recordingId,
+      data: {
+        include: Object.fromEntries(Object.entries(include).filter(([
+          , value,
+        ]) => value)),
+      },
+    });
+
+    $.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

@@ -0,0 +1,18 @@
+export const TRANSCRIPT_FORMAT_OPTIONS = [
+  {
+    label: "JSON",
+    value: "json",
+  },
+  {
+    label: "Text",
+    value: "txt",
+  },
+  {
+    label: "VTT",
+    value: "vtt",
+  },
+  {
+    label: "SRT",
+    value: "srt",
+  },
+];

package/grain.app.mjs

@@ -1,11 +1,165 @@
+import { axios } from "@pipedream/platform";
+
 export default {
   type: "app",
   app: "grain",
-  propDefinitions: {},
+  propDefinitions: {
+    recordingId: {
+      type: "string",
+      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({
+          data: {
+            cursor: prevContext?.nextPage,
+          },
+        });
+        return {
+          options: recordings.map(({
+            id: value, title: 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: {
-    // this.$auth contains connected account data
-    authKeys() {
-      console.log(Object.keys(this.$auth));
+    _baseUrl() {
+      return "https://api.grain.com/_/public-api/v2";
+    },
+    _headers() {
+      return {
+        "Authorization": `Bearer ${this.$auth.oauth_access_token}`,
+        "Public-Api-Version": "2025-10-31",
+      };
+    },
+    _makeRequest({
+      $ = this, path, ...opts
+    }) {
+      return axios($, {
+        url: this._baseUrl() + path,
+        headers: this._headers(),
+        ...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,
+      });
+    },
+    /**
+     * 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({
+        method: "POST",
+        path: `/recordings/${recordingId}`,
+        ...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/${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/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",
+        path: `/hooks/${hookId}`,
+      });
     },
   },
-};
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/grain",
-  "version": "0.0.1",
+  "version": "1.0.0",
   "description": "Pipedream Grain Components",
   "main": "grain.app.mjs",
   "keywords": [
@@ -11,5 +11,8 @@
   "author": "Pipedream <support@pipedream.com> (https://pipedream.com/)",
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@pipedream/platform": "^3.1.1"
   }
 }

package/sources/common/base.mjs

@@ -0,0 +1,66 @@
+import grain from "../../grain.app.mjs";
+
+export default {
+  props: {
+    grain,
+    http: {
+      type: "$.interface.http",
+      customResponse: true,
+    },
+    db: "$.service.db",
+  },
+  methods: {
+    _getHookId() {
+      return this.db.get("hookId");
+    },
+    _setHookId(hookId) {
+      this.db.set("hookId", hookId);
+    },
+    getInclude() {
+      return undefined;
+    },
+    getTimestamp() {
+      return Date.now();
+    },
+  },
+  hooks: {
+    async activate() {
+      const response = await this.grain.createWebhook({
+        data: {
+          hook_url: this.http.endpoint,
+          hook_type: this.getHookType(),
+          include: this.getInclude(),
+        },
+      });
+      this._setHookId(response.id);
+    },
+    async deactivate() {
+      const webhookId = this._getHookId();
+      if (webhookId) {
+        await this.grain.deleteWebhook(webhookId);
+      }
+    },
+  },
+  async run({ body }) {
+    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;
+
+    this.$emit(body, {
+      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

@@ -0,0 +1,22 @@
+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 is added. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    getHookType() {
+      return "highlight_added";
+    },
+    getSummary({ data }) {
+      return `New highlight added: ${data.id}`;
+    },
+  },
+  sampleEmit,
+};

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

@@ -0,0 +1,21 @@
+export default {
+  "type": "highlight_added",
+  "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
+  "data": {
+    "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"
+    ],
+    "timestamp": 3080,
+    "duration": 15000,
+    "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"
+    ]
+  }
+};

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

@@ -0,0 +1,22 @@
+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 is added. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    getHookType() {
+      return "recording_added";
+    },
+    getSummary({ data }) {
+      return `New recording added: ${data.id}`;
+    },
+  },
+  sampleEmit,
+};

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

@@ -0,0 +1,27 @@
+export default {
+  "type": "recording_added",
+  "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
+  "data": {
+    "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

@@ -0,0 +1,28 @@
+import common from "../common/base.mjs";
+import sampleEmit from "./test-event.mjs";
+
+export default {
+  ...common,
+  key: "grain-new-story-instant",
+  name: "New Story (Instant)",
+  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",
+  methods: {
+    ...common.methods,
+    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}`;
+    },
+  },
+  sampleEmit,
+};

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

@@ -0,0 +1,17 @@
+export default {
+  "type": "story_added",
+  "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
+  "data": {
+    "id": "1aff0fe4-6575-4d5f-a462-aaf09f5f17a6",
+    "title": "My customer story",
+    "description": "A customer journey with ACME Corp",
+    "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"
+    ]
+  }
+};

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

@@ -0,0 +1,22 @@
+import common from "../common/base.mjs";
+import sampleEmit from "./test-event.mjs";
+
+export default {
+  ...common,
+  key: "grain-removed-highlight-instant",
+  name: "New Highlight Removed (Instant)",
+  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",
+  methods: {
+    ...common.methods,
+    getHookType() {
+      return "highlight_deleted";
+    },
+    getSummary({ data }) {
+      return `Highlight removed: ${data.id}`;
+    },
+  },
+  sampleEmit,
+};

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

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

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

@@ -0,0 +1,22 @@
+import common from "../common/base.mjs";
+import sampleEmit from "./test-event.mjs";
+
+export default {
+  ...common,
+  key: "grain-removed-recording-instant",
+  name: "New Recording Removed (Instant)",
+  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",
+  methods: {
+    ...common.methods,
+    getHookType() {
+      return "recording_deleted";
+    },
+    getSummary({ data }) {
+      return `Recording removed: ${data.id}`;
+    },
+  },
+  sampleEmit,
+};

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

@@ -0,0 +1,7 @@
+export default {
+  "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

@@ -0,0 +1,22 @@
+import common from "../common/base.mjs";
+import sampleEmit from "./test-event.mjs";
+
+export default {
+  ...common,
+  key: "grain-removed-story-instant",
+  name: "New Story Removed (Instant)",
+  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",
+  methods: {
+    ...common.methods,
+    getHookType() {
+      return "story_deleted";
+    },
+    getSummary({ data }) {
+      return `New story removed: ${data.id}`;
+    },
+  },
+  sampleEmit,
+};

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

@@ -0,0 +1,7 @@
+export default {
+  "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

@@ -0,0 +1,21 @@
+export default {
+  "type": "highlight_updated",
+  "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
+  "data": {
+    "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"
+    ],
+    "timestamp": 3080,
+    "duration": 15000,
+    "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"
+    ]
+  }
+};

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

@@ -0,0 +1,22 @@
+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. Each webhook delivery emits an event, including retries. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
+  type: "source",
+  // Grain does not document a delivery ID; deduping by resource ID would discard later updates.
+  methods: {
+    ...common.methods,
+    getHookType() {
+      return "highlight_updated";
+    },
+    getSummary({ data }) {
+      return `New highlight updated: ${data.id}`;
+    },
+  },
+  sampleEmit,
+};

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

@@ -0,0 +1,27 @@
+export default {
+  "type": "recording_updated",
+  "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
+  "data": {
+    "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

@@ -0,0 +1,22 @@
+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. Each webhook delivery emits an event, including retries. [See the documentation](https://developers.grain.com/#create-hook)",
+  version: "1.0.0",
+  type: "source",
+  // Grain does not document a delivery ID; deduping by resource ID would discard later updates.
+  methods: {
+    ...common.methods,
+    getHookType() {
+      return "recording_updated";
+    },
+    getSummary({ data }) {
+      return `New recording updated: ${data.id}`;
+    },
+  },
+  sampleEmit,
+};

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

@@ -0,0 +1,17 @@
+export default {
+  "type": "story_updated",
+  "user_id": "aea95745-99e9-4609-8623-c9efa2926b82",
+  "data": {
+    "id": "1aff0fe4-6575-4d5f-a462-aaf09f5f17a6",
+    "title": "My customer story",
+    "description": "A customer journey with ACME Corp",
+    "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"
+    ]
+  }
+};

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

@@ -0,0 +1,28 @@
+import common from "../common/base.mjs";
+import sampleEmit from "./test-event.mjs";
+
+export default {
+  ...common,
+  key: "grain-updated-story-instant",
+  name: "New Story Updated (Instant)",
+  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",
+  // Grain does not document a delivery ID; deduping by resource ID would discard later updates.
+  methods: {
+    ...common.methods,
+    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}`;
+    },
+  },
+  sampleEmit,
+};