@contractspec/example.meeting-recorder-providers 3.7.17 → 3.7.18

package/dist/browser/handlers/webhook-handler.js

@@ -1,114 +1 @@
-// src/handlers/create-provider.ts
-import { FathomMeetingRecorderProvider } from "@contractspec/integration.providers-impls/impls/fathom-meeting-recorder";
-import { FirefliesMeetingRecorderProvider } from "@contractspec/integration.providers-impls/impls/fireflies-meeting-recorder";
-import { GranolaMeetingRecorderProvider } from "@contractspec/integration.providers-impls/impls/granola-meeting-recorder";
-import { TldvMeetingRecorderProvider } from "@contractspec/integration.providers-impls/impls/tldv-meeting-recorder";
-function createMeetingRecorderProvider(input) {
-  const { integrationKey, secrets, config } = input;
-  switch (integrationKey) {
-    case "meeting-recorder.granola":
-      if (config?.transport === "mcp") {
-        return new GranolaMeetingRecorderProvider({
-          transport: "mcp",
-          mcpUrl: config?.mcpUrl,
-          mcpHeaders: config?.mcpHeaders,
-          mcpAccessToken: secrets.mcpAccessToken ?? secrets.apiKey,
-          pageSize: config?.pageSize
-        });
-      }
-      if (!secrets.apiKey) {
-        throw new Error("Granola apiKey is required for API transport.");
-      }
-      return new GranolaMeetingRecorderProvider({
-        apiKey: secrets.apiKey,
-        baseUrl: config?.baseUrl,
-        pageSize: config?.pageSize
-      });
-    case "meeting-recorder.tldv":
-      if (!secrets.apiKey) {
-        throw new Error("tl;dv apiKey is required.");
-      }
-      return new TldvMeetingRecorderProvider({
-        apiKey: secrets.apiKey,
-        baseUrl: config?.baseUrl,
-        pageSize: config?.pageSize
-      });
-    case "meeting-recorder.fireflies":
-      if (!secrets.apiKey) {
-        throw new Error("Fireflies apiKey is required.");
-      }
-      return new FirefliesMeetingRecorderProvider({
-        apiKey: secrets.apiKey,
-        baseUrl: config?.baseUrl,
-        pageSize: config?.transcriptsPageSize ?? config?.pageSize,
-        webhookSecret: secrets.webhookSecret
-      });
-    case "meeting-recorder.fathom":
-      if (!secrets.apiKey) {
-        throw new Error("Fathom apiKey is required.");
-      }
-      return new FathomMeetingRecorderProvider({
-        apiKey: secrets.apiKey,
-        baseUrl: config?.baseUrl,
-        includeTranscript: config?.includeTranscript,
-        includeSummary: config?.includeSummary,
-        includeActionItems: config?.includeActionItems,
-        includeCrmMatches: config?.includeCrmMatches,
-        triggeredFor: config?.triggeredFor,
-        maxPages: config?.maxPages,
-        webhookSecret: secrets.webhookSecret
-      });
-    default:
-      throw new Error(`Unsupported meeting recorder provider: ${integrationKey}`);
-  }
-}
-
-// src/handlers/webhook-handler.ts
-async function handleMeetingRecorderWebhook(input) {
-  const { integrationKey, request } = input;
-  const provider = createMeetingRecorderProvider(input);
-  const rawBody = await request.text();
-  const parsedBody = safeJsonParse(rawBody);
-  const webhookRequest = {
-    headers: toHeaderRecord(request.headers),
-    rawBody,
-    parsedBody
-  };
-  if (provider.verifyWebhook) {
-    const verified = await provider.verifyWebhook(webhookRequest);
-    if (!verified) {
-      return new Response("Invalid webhook signature", { status: 401 });
-    }
-  }
-  const event = provider.parseWebhook ? await provider.parseWebhook(webhookRequest) : fallbackWebhookEvent(integrationKey, parsedBody ?? rawBody);
-  return new Response(JSON.stringify({ status: "ok", event }), {
-    status: 200,
-    headers: { "Content-Type": "application/json" }
-  });
-}
-function toHeaderRecord(headers) {
-  const record = {};
-  headers.forEach((value, key) => {
-    record[key] = value;
-  });
-  return record;
-}
-function safeJsonParse(payload) {
-  if (!payload)
-    return;
-  try {
-    return JSON.parse(payload);
-  } catch {
-    return;
-  }
-}
-function fallbackWebhookEvent(providerKey, payload) {
-  return {
-    providerKey,
-    payload,
-    receivedAt: new Date().toISOString()
-  };
-}
-export {
-  handleMeetingRecorderWebhook
-};
+import{FathomMeetingRecorderProvider as h}from"@contractspec/integration.providers-impls/impls/fathom-meeting-recorder";import{FirefliesMeetingRecorderProvider as k}from"@contractspec/integration.providers-impls/impls/fireflies-meeting-recorder";import{GranolaMeetingRecorderProvider as i}from"@contractspec/integration.providers-impls/impls/granola-meeting-recorder";import{TldvMeetingRecorderProvider as R}from"@contractspec/integration.providers-impls/impls/tldv-meeting-recorder";function s(t){let{integrationKey:n,secrets:r,config:e}=t;switch(n){case"meeting-recorder.granola":if(e?.transport==="mcp")return new i({transport:"mcp",mcpUrl:e?.mcpUrl,mcpHeaders:e?.mcpHeaders,mcpAccessToken:r.mcpAccessToken??r.apiKey,pageSize:e?.pageSize});if(!r.apiKey)throw Error("Granola apiKey is required for API transport.");return new i({apiKey:r.apiKey,baseUrl:e?.baseUrl,pageSize:e?.pageSize});case"meeting-recorder.tldv":if(!r.apiKey)throw Error("tl;dv apiKey is required.");return new R({apiKey:r.apiKey,baseUrl:e?.baseUrl,pageSize:e?.pageSize});case"meeting-recorder.fireflies":if(!r.apiKey)throw Error("Fireflies apiKey is required.");return new k({apiKey:r.apiKey,baseUrl:e?.baseUrl,pageSize:e?.transcriptsPageSize??e?.pageSize,webhookSecret:r.webhookSecret});case"meeting-recorder.fathom":if(!r.apiKey)throw Error("Fathom apiKey is required.");return new h({apiKey:r.apiKey,baseUrl:e?.baseUrl,includeTranscript:e?.includeTranscript,includeSummary:e?.includeSummary,includeActionItems:e?.includeActionItems,includeCrmMatches:e?.includeCrmMatches,triggeredFor:e?.triggeredFor,maxPages:e?.maxPages,webhookSecret:r.webhookSecret});default:throw Error(`Unsupported meeting recorder provider: ${n}`)}}async function I(t){let{integrationKey:n,request:r}=t,e=s(t),o=await r.text(),d=b(o),a={headers:p(r.headers),rawBody:o,parsedBody:d};if(e.verifyWebhook){if(!await e.verifyWebhook(a))return new Response("Invalid webhook signature",{status:401})}let u=e.parseWebhook?await e.parseWebhook(a):v(n,d??o);return new Response(JSON.stringify({status:"ok",event:u}),{status:200,headers:{"Content-Type":"application/json"}})}function p(t){let n={};return t.forEach((r,e)=>{n[e]=r}),n}function b(t){if(!t)return;try{return JSON.parse(t)}catch{return}}function v(t,n){return{providerKey:t,payload:n,receivedAt:new Date().toISOString()}}export{I as handleMeetingRecorderWebhook};

package/dist/browser/index.js

@@ -1,351 +1,18 @@
-// src/connection.sample.ts
-var granolaMeetingRecorderConnection = {
-  meta: {
-    id: "conn-granola-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.granola",
-    integrationVersion: "1",
-    label: "Granola Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    transport: "api",
-    baseUrl: "https://public-api.granola.ai",
-    pageSize: 10
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-granola-demo",
-  status: "connected"
-};
-var granolaMcpMeetingRecorderConnection = {
-  meta: {
-    id: "conn-granola-mcp-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.granola",
-    integrationVersion: "1",
-    label: "Granola MCP Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    transport: "mcp",
-    mcpUrl: "https://mcp.granola.ai/mcp",
-    pageSize: 10
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-granola-mcp-demo",
-  status: "connected"
-};
-var tldvMeetingRecorderConnection = {
-  meta: {
-    id: "conn-tldv-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.tldv",
-    integrationVersion: "1",
-    label: "tl;dv Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    baseUrl: "https://pasta.tldv.io/v1alpha1",
-    pageSize: 25
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-tldv-demo",
-  status: "connected"
-};
-var firefliesMeetingRecorderConnection = {
-  meta: {
-    id: "conn-fireflies-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.fireflies",
-    integrationVersion: "1",
-    label: "Fireflies Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    baseUrl: "https://api.fireflies.ai/graphql",
-    transcriptsPageSize: 25
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-fireflies-demo",
-  status: "connected"
-};
-var fathomMeetingRecorderConnection = {
-  meta: {
-    id: "conn-fathom-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.fathom",
-    integrationVersion: "1",
-    label: "Fathom Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    baseUrl: "https://api.fathom.ai/external/v1",
-    includeTranscript: true,
-    includeSummary: true,
-    includeActionItems: false,
-    includeCrmMatches: false,
-    triggeredFor: ["my_recordings"],
-    maxPages: 5
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-fathom-demo",
-  status: "connected"
-};
-var meetingRecorderSampleConnections = [
-  granolaMeetingRecorderConnection,
-  granolaMcpMeetingRecorderConnection,
-  tldvMeetingRecorderConnection,
-  firefliesMeetingRecorderConnection,
-  fathomMeetingRecorderConnection
-];
-
-// src/docs/meeting-recorder-providers.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var blocks = [
-  {
-    id: "docs.examples.meeting-recorder-providers",
-    title: "Meeting Recorder Providers (example)",
-    summary: "Multi-provider meeting recorder example covering list, transcript fetch, and webhook ingestion.",
-    kind: "reference",
-    visibility: "public",
-    route: "/docs/examples/meeting-recorder-providers",
-    tags: ["meeting-recorder", "integration", "example", "transcripts"],
-    body: `## What this example shows
-` + `- Provider selection for Granola (API and MCP), tl;dv, Fireflies, and Fathom.
-` + `- List meetings + fetch transcripts using the MeetingRecorderProvider interface.
-` + `- Webhook verification and normalization into a single event shape.
-
-` + `## Secrets and config
-` + `- apiKey (all providers)
-` + `- Granola MCP: set transport=mcp and provide mcpAccessToken (or apiKey fallback for MCP proxy).
-` + `- webhookSecret (Fireflies and Fathom)
-` + `- baseUrl overrides for sandbox or proxy setups
-` + `- mcpUrl and mcpHeaders for custom MCP routing
-` + `- pageSize / transcriptsPageSize for pagination
-` + `- Fathom options: includeTranscript, includeSummary, includeActionItems, includeCrmMatches, triggeredFor
-
-` + `## Guardrails
-` + `- Keep secrets in a dedicated secret provider.
-` + `- Verify webhook signatures before triggering workflows.
-` + "- Treat transcript ingestion as async workflows, not inline writes."
-  },
-  {
-    id: "docs.examples.meeting-recorder-providers.usage",
-    title: "Meeting Recorder Providers - Usage",
-    summary: "How to wire the provider factory and handlers in a runtime.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/examples/meeting-recorder-providers/usage",
-    tags: ["meeting-recorder", "usage"],
-    body: `## Usage
-` + "- Call `createMeetingRecorderProvider` with an integration key, secrets, and config.\n" + "- Use `listMeetingRecorderMeetings` to fetch metadata pages.\n" + "- Use `getMeetingRecorderTranscript` to fetch transcript content.\n" + "- Wire `handleMeetingRecorderWebhook` to your webhook endpoint.\n\n" + `## Notes
-` + `- Replace the placeholder stores with your app persistence.
-` + "- Record the raw webhook payload for replay or debugging."
-  }
-];
-registerDocBlocks(blocks);
-// src/example.ts
-import { defineExample } from "@contractspec/lib.contracts-spec";
-var example = defineExample({
-  meta: {
-    key: "meeting-recorder-providers",
-    version: "1.0.0",
-    title: "Meeting Recorder Providers",
-    description: "Multi-provider meeting recorder integration example with list, transcript, and webhook handling.",
-    kind: "integration",
-    visibility: "public",
-    stability: "experimental",
-    owners: ["@platform.integrations"],
-    tags: ["meeting-recorder", "transcripts", "webhooks", "integrations"]
-  },
-  docs: {
-    rootDocId: "docs.examples.meeting-recorder-providers",
-    usageDocId: "docs.examples.meeting-recorder-providers.usage"
-  },
-  entrypoints: {
-    packageName: "@contractspec/example.meeting-recorder-providers",
-    docs: "./docs"
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ["markdown", "specs"] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true }
-  }
-});
-var example_default = example;
-
-// src/handlers/create-provider.ts
-import { FathomMeetingRecorderProvider } from "@contractspec/integration.providers-impls/impls/fathom-meeting-recorder";
-import { FirefliesMeetingRecorderProvider } from "@contractspec/integration.providers-impls/impls/fireflies-meeting-recorder";
-import { GranolaMeetingRecorderProvider } from "@contractspec/integration.providers-impls/impls/granola-meeting-recorder";
-import { TldvMeetingRecorderProvider } from "@contractspec/integration.providers-impls/impls/tldv-meeting-recorder";
-function createMeetingRecorderProvider(input) {
-  const { integrationKey, secrets, config } = input;
-  switch (integrationKey) {
-    case "meeting-recorder.granola":
-      if (config?.transport === "mcp") {
-        return new GranolaMeetingRecorderProvider({
-          transport: "mcp",
-          mcpUrl: config?.mcpUrl,
-          mcpHeaders: config?.mcpHeaders,
-          mcpAccessToken: secrets.mcpAccessToken ?? secrets.apiKey,
-          pageSize: config?.pageSize
-        });
-      }
-      if (!secrets.apiKey) {
-        throw new Error("Granola apiKey is required for API transport.");
-      }
-      return new GranolaMeetingRecorderProvider({
-        apiKey: secrets.apiKey,
-        baseUrl: config?.baseUrl,
-        pageSize: config?.pageSize
-      });
-    case "meeting-recorder.tldv":
-      if (!secrets.apiKey) {
-        throw new Error("tl;dv apiKey is required.");
-      }
-      return new TldvMeetingRecorderProvider({
-        apiKey: secrets.apiKey,
-        baseUrl: config?.baseUrl,
-        pageSize: config?.pageSize
-      });
-    case "meeting-recorder.fireflies":
-      if (!secrets.apiKey) {
-        throw new Error("Fireflies apiKey is required.");
-      }
-      return new FirefliesMeetingRecorderProvider({
-        apiKey: secrets.apiKey,
-        baseUrl: config?.baseUrl,
-        pageSize: config?.transcriptsPageSize ?? config?.pageSize,
-        webhookSecret: secrets.webhookSecret
-      });
-    case "meeting-recorder.fathom":
-      if (!secrets.apiKey) {
-        throw new Error("Fathom apiKey is required.");
-      }
-      return new FathomMeetingRecorderProvider({
-        apiKey: secrets.apiKey,
-        baseUrl: config?.baseUrl,
-        includeTranscript: config?.includeTranscript,
-        includeSummary: config?.includeSummary,
-        includeActionItems: config?.includeActionItems,
-        includeCrmMatches: config?.includeCrmMatches,
-        triggeredFor: config?.triggeredFor,
-        maxPages: config?.maxPages,
-        webhookSecret: secrets.webhookSecret
-      });
-    default:
-      throw new Error(`Unsupported meeting recorder provider: ${integrationKey}`);
-  }
-}
-
-// src/handlers/get-transcript.ts
-async function getMeetingRecorderTranscript(input) {
-  const provider = createMeetingRecorderProvider(input);
-  return provider.getTranscript(input.params);
-}
-
-// src/handlers/list-meetings.ts
-async function listMeetingRecorderMeetings(input) {
-  const provider = createMeetingRecorderProvider(input);
-  return provider.listMeetings(input.params);
-}
-
-// src/handlers/webhook-handler.ts
-async function handleMeetingRecorderWebhook(input) {
-  const { integrationKey, request } = input;
-  const provider = createMeetingRecorderProvider(input);
-  const rawBody = await request.text();
-  const parsedBody = safeJsonParse(rawBody);
-  const webhookRequest = {
-    headers: toHeaderRecord(request.headers),
-    rawBody,
-    parsedBody
-  };
-  if (provider.verifyWebhook) {
-    const verified = await provider.verifyWebhook(webhookRequest);
-    if (!verified) {
-      return new Response("Invalid webhook signature", { status: 401 });
-    }
-  }
-  const event = provider.parseWebhook ? await provider.parseWebhook(webhookRequest) : fallbackWebhookEvent(integrationKey, parsedBody ?? rawBody);
-  return new Response(JSON.stringify({ status: "ok", event }), {
-    status: 200,
-    headers: { "Content-Type": "application/json" }
-  });
-}
-function toHeaderRecord(headers) {
-  const record = {};
-  headers.forEach((value, key) => {
-    record[key] = value;
-  });
-  return record;
-}
-function safeJsonParse(payload) {
-  if (!payload)
-    return;
-  try {
-    return JSON.parse(payload);
-  } catch {
-    return;
-  }
-}
-function fallbackWebhookEvent(providerKey, payload) {
-  return {
-    providerKey,
-    payload,
-    receivedAt: new Date().toISOString()
-  };
-}
-
-// src/meeting-recorder-providers.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var MeetingRecorderProvidersFeature = defineFeature({
-  meta: {
-    key: "meeting-recorder-providers",
-    version: "1.0.0",
-    title: "Meeting Recorder Providers",
-    description: "Meeting recorder provider integration with transcripts and webhook handling",
-    domain: "integration",
-    owners: ["@examples"],
-    tags: ["meeting", "recorder", "transcripts", "webhooks"],
-    stability: "experimental"
-  },
-  integrations: [
-    { key: "meeting-recorder.integration.provider", version: "1.0.0" }
-  ],
-  docs: [
-    "docs.examples.meeting-recorder-providers",
-    "docs.examples.meeting-recorder-providers.usage"
-  ]
-});
-export {
-  tldvMeetingRecorderConnection,
-  meetingRecorderSampleConnections,
-  listMeetingRecorderMeetings,
-  handleMeetingRecorderWebhook,
-  granolaMeetingRecorderConnection,
-  granolaMcpMeetingRecorderConnection,
-  getMeetingRecorderTranscript,
-  firefliesMeetingRecorderConnection,
-  fathomMeetingRecorderConnection,
-  example_default as example,
-  createMeetingRecorderProvider,
-  MeetingRecorderProvidersFeature
-};
+var u={meta:{id:"conn-granola-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.granola",integrationVersion:"1",label:"Granola Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{transport:"api",baseUrl:"https://public-api.granola.ai",pageSize:10},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-granola-demo",status:"connected"},R={meta:{id:"conn-granola-mcp-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.granola",integrationVersion:"1",label:"Granola MCP Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{transport:"mcp",mcpUrl:"https://mcp.granola.ai/mcp",pageSize:10},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-granola-mcp-demo",status:"connected"},M={meta:{id:"conn-tldv-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.tldv",integrationVersion:"1",label:"tl;dv Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{baseUrl:"https://pasta.tldv.io/v1alpha1",pageSize:25},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-tldv-demo",status:"connected"},c={meta:{id:"conn-fireflies-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.fireflies",integrationVersion:"1",label:"Fireflies Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{baseUrl:"https://api.fireflies.ai/graphql",transcriptsPageSize:25},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-fireflies-demo",status:"connected"},g={meta:{id:"conn-fathom-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.fathom",integrationVersion:"1",label:"Fathom Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{baseUrl:"https://api.fathom.ai/external/v1",includeTranscript:!0,includeSummary:!0,includeActionItems:!1,includeCrmMatches:!1,triggeredFor:["my_recordings"],maxPages:5},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-fathom-demo",status:"connected"},q=[u,R,M,c,g];import{registerDocBlocks as v}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.examples.meeting-recorder-providers",title:"Meeting Recorder Providers (example)",summary:"Multi-provider meeting recorder example covering list, transcript fetch, and webhook ingestion.",kind:"reference",visibility:"public",route:"/docs/examples/meeting-recorder-providers",tags:["meeting-recorder","integration","example","transcripts"],body:`## What this example shows
+- Provider selection for Granola (API and MCP), tl;dv, Fireflies, and Fathom.
+- List meetings + fetch transcripts using the MeetingRecorderProvider interface.
+- Webhook verification and normalization into a single event shape.
+
+## Secrets and config
+- apiKey (all providers)
+- Granola MCP: set transport=mcp and provide mcpAccessToken (or apiKey fallback for MCP proxy).
+- webhookSecret (Fireflies and Fathom)
+- baseUrl overrides for sandbox or proxy setups
+- mcpUrl and mcpHeaders for custom MCP routing
+- pageSize / transcriptsPageSize for pagination
+- Fathom options: includeTranscript, includeSummary, includeActionItems, includeCrmMatches, triggeredFor
+
+## Guardrails
+- Keep secrets in a dedicated secret provider.
+- Verify webhook signatures before triggering workflows.
+- Treat transcript ingestion as async workflows, not inline writes.`},{id:"docs.examples.meeting-recorder-providers.usage",title:"Meeting Recorder Providers - Usage",summary:"How to wire the provider factory and handlers in a runtime.",kind:"usage",visibility:"public",route:"/docs/examples/meeting-recorder-providers/usage",tags:["meeting-recorder","usage"],body:"## Usage\n- Call `createMeetingRecorderProvider` with an integration key, secrets, and config.\n- Use `listMeetingRecorderMeetings` to fetch metadata pages.\n- Use `getMeetingRecorderTranscript` to fetch transcript content.\n- Wire `handleMeetingRecorderWebhook` to your webhook endpoint.\n\n## Notes\n- Replace the placeholder stores with your app persistence.\n- Record the raw webhook payload for replay or debugging."}];v(h);import{defineExample as y}from"@contractspec/lib.contracts-spec";var m=y({meta:{key:"meeting-recorder-providers",version:"1.0.0",title:"Meeting Recorder Providers",description:"Multi-provider meeting recorder integration example with list, transcript, and webhook handling.",kind:"integration",visibility:"public",stability:"experimental",owners:["@platform.integrations"],tags:["meeting-recorder","transcripts","webhooks","integrations"]},docs:{rootDocId:"docs.examples.meeting-recorder-providers",usageDocId:"docs.examples.meeting-recorder-providers.usage"},entrypoints:{packageName:"@contractspec/example.meeting-recorder-providers",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["markdown","specs"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),k=m;import{FathomMeetingRecorderProvider as P}from"@contractspec/integration.providers-impls/impls/fathom-meeting-recorder";import{FirefliesMeetingRecorderProvider as I}from"@contractspec/integration.providers-impls/impls/fireflies-meeting-recorder";import{GranolaMeetingRecorderProvider as s}from"@contractspec/integration.providers-impls/impls/granola-meeting-recorder";import{TldvMeetingRecorderProvider as b}from"@contractspec/integration.providers-impls/impls/tldv-meeting-recorder";function o(r){let{integrationKey:n,secrets:t,config:e}=r;switch(n){case"meeting-recorder.granola":if(e?.transport==="mcp")return new s({transport:"mcp",mcpUrl:e?.mcpUrl,mcpHeaders:e?.mcpHeaders,mcpAccessToken:t.mcpAccessToken??t.apiKey,pageSize:e?.pageSize});if(!t.apiKey)throw Error("Granola apiKey is required for API transport.");return new s({apiKey:t.apiKey,baseUrl:e?.baseUrl,pageSize:e?.pageSize});case"meeting-recorder.tldv":if(!t.apiKey)throw Error("tl;dv apiKey is required.");return new b({apiKey:t.apiKey,baseUrl:e?.baseUrl,pageSize:e?.pageSize});case"meeting-recorder.fireflies":if(!t.apiKey)throw Error("Fireflies apiKey is required.");return new I({apiKey:t.apiKey,baseUrl:e?.baseUrl,pageSize:e?.transcriptsPageSize??e?.pageSize,webhookSecret:t.webhookSecret});case"meeting-recorder.fathom":if(!t.apiKey)throw Error("Fathom apiKey is required.");return new P({apiKey:t.apiKey,baseUrl:e?.baseUrl,includeTranscript:e?.includeTranscript,includeSummary:e?.includeSummary,includeActionItems:e?.includeActionItems,includeCrmMatches:e?.includeCrmMatches,triggeredFor:e?.triggeredFor,maxPages:e?.maxPages,webhookSecret:t.webhookSecret});default:throw Error(`Unsupported meeting recorder provider: ${n}`)}}async function A(r){return o(r).getTranscript(r.params)}async function C(r){return o(r).listMeetings(r.params)}async function U(r){let{integrationKey:n,request:t}=r,e=o(r),i=await t.text(),a=W(i),d={headers:w(t.headers),rawBody:i,parsedBody:a};if(e.verifyWebhook){if(!await e.verifyWebhook(d))return new Response("Invalid webhook signature",{status:401})}let p=e.parseWebhook?await e.parseWebhook(d):f(n,a??i);return new Response(JSON.stringify({status:"ok",event:p}),{status:200,headers:{"Content-Type":"application/json"}})}function w(r){let n={};return r.forEach((t,e)=>{n[e]=t}),n}function W(r){if(!r)return;try{return JSON.parse(r)}catch{return}}function f(r,n){return{providerKey:r,payload:n,receivedAt:new Date().toISOString()}}import{defineFeature as T}from"@contractspec/lib.contracts-spec";var Y=T({meta:{key:"meeting-recorder-providers",version:"1.0.0",title:"Meeting Recorder Providers",description:"Meeting recorder provider integration with transcripts and webhook handling",domain:"integration",owners:["@examples"],tags:["meeting","recorder","transcripts","webhooks"],stability:"experimental"},integrations:[{key:"meeting-recorder.integration.provider",version:"1.0.0"}],docs:["docs.examples.meeting-recorder-providers","docs.examples.meeting-recorder-providers.usage"]});export{M as tldvMeetingRecorderConnection,q as meetingRecorderSampleConnections,C as listMeetingRecorderMeetings,U as handleMeetingRecorderWebhook,u as granolaMeetingRecorderConnection,R as granolaMcpMeetingRecorderConnection,A as getMeetingRecorderTranscript,c as firefliesMeetingRecorderConnection,g as fathomMeetingRecorderConnection,k as example,o as createMeetingRecorderProvider,Y as MeetingRecorderProvidersFeature};

package/dist/browser/meeting-recorder-providers.feature.js

@@ -1,24 +1 @@
-// src/meeting-recorder-providers.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var MeetingRecorderProvidersFeature = defineFeature({
-  meta: {
-    key: "meeting-recorder-providers",
-    version: "1.0.0",
-    title: "Meeting Recorder Providers",
-    description: "Meeting recorder provider integration with transcripts and webhook handling",
-    domain: "integration",
-    owners: ["@examples"],
-    tags: ["meeting", "recorder", "transcripts", "webhooks"],
-    stability: "experimental"
-  },
-  integrations: [
-    { key: "meeting-recorder.integration.provider", version: "1.0.0" }
-  ],
-  docs: [
-    "docs.examples.meeting-recorder-providers",
-    "docs.examples.meeting-recorder-providers.usage"
-  ]
-});
-export {
-  MeetingRecorderProvidersFeature
-};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({meta:{key:"meeting-recorder-providers",version:"1.0.0",title:"Meeting Recorder Providers",description:"Meeting recorder provider integration with transcripts and webhook handling",domain:"integration",owners:["@examples"],tags:["meeting","recorder","transcripts","webhooks"],stability:"experimental"},integrations:[{key:"meeting-recorder.integration.provider",version:"1.0.0"}],docs:["docs.examples.meeting-recorder-providers","docs.examples.meeting-recorder-providers.usage"]});export{j as MeetingRecorderProvidersFeature};

package/dist/connection.sample.js

@@ -1,124 +1,2 @@
 // @bun
-// src/connection.sample.ts
-var granolaMeetingRecorderConnection = {
-  meta: {
-    id: "conn-granola-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.granola",
-    integrationVersion: "1",
-    label: "Granola Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    transport: "api",
-    baseUrl: "https://public-api.granola.ai",
-    pageSize: 10
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-granola-demo",
-  status: "connected"
-};
-var granolaMcpMeetingRecorderConnection = {
-  meta: {
-    id: "conn-granola-mcp-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.granola",
-    integrationVersion: "1",
-    label: "Granola MCP Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    transport: "mcp",
-    mcpUrl: "https://mcp.granola.ai/mcp",
-    pageSize: 10
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-granola-mcp-demo",
-  status: "connected"
-};
-var tldvMeetingRecorderConnection = {
-  meta: {
-    id: "conn-tldv-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.tldv",
-    integrationVersion: "1",
-    label: "tl;dv Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    baseUrl: "https://pasta.tldv.io/v1alpha1",
-    pageSize: 25
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-tldv-demo",
-  status: "connected"
-};
-var firefliesMeetingRecorderConnection = {
-  meta: {
-    id: "conn-fireflies-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.fireflies",
-    integrationVersion: "1",
-    label: "Fireflies Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    baseUrl: "https://api.fireflies.ai/graphql",
-    transcriptsPageSize: 25
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-fireflies-demo",
-  status: "connected"
-};
-var fathomMeetingRecorderConnection = {
-  meta: {
-    id: "conn-fathom-demo",
-    tenantId: "acme-inc",
-    integrationKey: "meeting-recorder.fathom",
-    integrationVersion: "1",
-    label: "Fathom Meeting Recorder",
-    environment: "production",
-    createdAt: "2026-01-01T00:00:00.000Z",
-    updatedAt: "2026-01-01T00:00:00.000Z"
-  },
-  ownershipMode: "byok",
-  config: {
-    baseUrl: "https://api.fathom.ai/external/v1",
-    includeTranscript: true,
-    includeSummary: true,
-    includeActionItems: false,
-    includeCrmMatches: false,
-    triggeredFor: ["my_recordings"],
-    maxPages: 5
-  },
-  secretProvider: "vault",
-  secretRef: "vault://integrations/acme-inc/conn-fathom-demo",
-  status: "connected"
-};
-var meetingRecorderSampleConnections = [
-  granolaMeetingRecorderConnection,
-  granolaMcpMeetingRecorderConnection,
-  tldvMeetingRecorderConnection,
-  firefliesMeetingRecorderConnection,
-  fathomMeetingRecorderConnection
-];
-export {
-  tldvMeetingRecorderConnection,
-  meetingRecorderSampleConnections,
-  granolaMeetingRecorderConnection,
-  granolaMcpMeetingRecorderConnection,
-  firefliesMeetingRecorderConnection,
-  fathomMeetingRecorderConnection
-};
+var b={meta:{id:"conn-granola-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.granola",integrationVersion:"1",label:"Granola Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{transport:"api",baseUrl:"https://public-api.granola.ai",pageSize:10},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-granola-demo",status:"connected"},f={meta:{id:"conn-granola-mcp-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.granola",integrationVersion:"1",label:"Granola MCP Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{transport:"mcp",mcpUrl:"https://mcp.granola.ai/mcp",pageSize:10},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-granola-mcp-demo",status:"connected"},h={meta:{id:"conn-tldv-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.tldv",integrationVersion:"1",label:"tl;dv Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{baseUrl:"https://pasta.tldv.io/v1alpha1",pageSize:25},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-tldv-demo",status:"connected"},j={meta:{id:"conn-fireflies-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.fireflies",integrationVersion:"1",label:"Fireflies Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{baseUrl:"https://api.fireflies.ai/graphql",transcriptsPageSize:25},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-fireflies-demo",status:"connected"},k={meta:{id:"conn-fathom-demo",tenantId:"acme-inc",integrationKey:"meeting-recorder.fathom",integrationVersion:"1",label:"Fathom Meeting Recorder",environment:"production",createdAt:"2026-01-01T00:00:00.000Z",updatedAt:"2026-01-01T00:00:00.000Z"},ownershipMode:"byok",config:{baseUrl:"https://api.fathom.ai/external/v1",includeTranscript:!0,includeSummary:!0,includeActionItems:!1,includeCrmMatches:!1,triggeredFor:["my_recordings"],maxPages:5},secretProvider:"vault",secretRef:"vault://integrations/acme-inc/conn-fathom-demo",status:"connected"},m=[b,f,h,j,k];export{h as tldvMeetingRecorderConnection,m as meetingRecorderSampleConnections,b as granolaMeetingRecorderConnection,f as granolaMcpMeetingRecorderConnection,j as firefliesMeetingRecorderConnection,k as fathomMeetingRecorderConnection};