@contractspec/lib.contracts-integrations 2.0.0

package/dist/node/integrations/providers/fireflies.js

@@ -0,0 +1,105 @@
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/fireflies.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var firefliesIntegrationSpec = defineIntegration({
+  meta: {
+    key: "meeting-recorder.fireflies",
+    version: "1.0.0",
+    category: "meeting-recorder",
+    title: "Fireflies.ai Meeting Recorder",
+    description: "Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.",
+    domain: "productivity",
+    owners: ["platform.integrations"],
+    tags: ["meeting-recorder", "fireflies", "transcripts"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["byok"],
+  capabilities: {
+    provides: [
+      { key: "meeting-recorder.meetings.read", version: "1.0.0" },
+      { key: "meeting-recorder.transcripts.read", version: "1.0.0" },
+      { key: "meeting-recorder.webhooks", version: "1.0.0" }
+    ]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        baseUrl: {
+          type: "string",
+          description: "Optional override for the Fireflies GraphQL endpoint. Defaults to https://api.fireflies.ai/graphql."
+        },
+        webhookUrl: {
+          type: "string",
+          description: "Webhook destination URL configured in Fireflies developer settings."
+        },
+        webhookEvents: {
+          type: "array",
+          items: { type: "string" },
+          description: "Webhook events to subscribe to (e.g., Transcription completed)."
+        },
+        transcriptsPageSize: {
+          type: "number",
+          description: "Number of transcripts to request per GraphQL query."
+        }
+      }
+    },
+    example: {
+      baseUrl: "https://api.fireflies.ai/graphql",
+      webhookUrl: "https://example.com/webhooks/fireflies",
+      webhookEvents: ["Transcription completed"],
+      transcriptsPageSize: 25
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["apiKey"],
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "Fireflies API key for GraphQL requests."
+        },
+        webhookSecret: {
+          type: "string",
+          description: "Optional webhook secret used to verify x-hub-signature HMAC payloads."
+        }
+      }
+    },
+    example: {
+      apiKey: "fireflies-***",
+      webhookSecret: "fireflies-webhook-secret"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 6000
+  },
+  docsUrl: "https://docs.fireflies.ai/getting-started/introduction",
+  byokSetup: {
+    setupInstructions: "Create a Fireflies API key and optionally configure webhook settings in Developer Settings."
+  }
+});
+function registerFirefliesIntegration(registry) {
+  return registry.register(firefliesIntegrationSpec);
+}
+export {
+  registerFirefliesIntegration,
+  firefliesIntegrationSpec
+};

package/dist/node/integrations/providers/gcs-storage.js

@@ -0,0 +1,96 @@
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/gcs-storage.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var gcsStorageIntegrationSpec = defineIntegration({
+  meta: {
+    key: "storage.gcs",
+    version: "1.0.0",
+    category: "storage",
+    title: "Google Cloud Storage Buckets",
+    description: "Google Cloud Storage integration for object storage and retrieval.",
+    domain: "infrastructure",
+    owners: ["platform.infrastructure"],
+    tags: ["storage", "gcs", "google-cloud"],
+    stability: StabilityEnum.Beta
+  },
+  supportedModes: ["managed", "byok"],
+  capabilities: {
+    provides: [{ key: "storage.objects", version: "1.0.0" }]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      required: ["bucket"],
+      properties: {
+        bucket: {
+          type: "string",
+          description: "Primary bucket name used for storing objects."
+        },
+        prefix: {
+          type: "string",
+          description: "Optional prefix applied to object keys."
+        }
+      }
+    },
+    example: {
+      bucket: "pfo-tenant-assets",
+      prefix: "documents/"
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        type: {
+          type: "string",
+          description: "Service account type field from Google credentials JSON (if provided)."
+        },
+        client_email: { type: "string" },
+        private_key: { type: "string" },
+        project_id: { type: "string" }
+      }
+    },
+    example: {
+      type: "service_account",
+      client_email: "svc-account@example.iam.gserviceaccount.com",
+      private_key: "-----BEGIN PRIVATE KEY-----...",
+      project_id: "example-project"
+    }
+  },
+  healthCheck: {
+    method: "ping",
+    timeoutMs: 4000
+  },
+  docsUrl: "https://cloud.google.com/storage/docs/apis",
+  constraints: {
+    quotas: {
+      storageGb: 5120
+    }
+  },
+  byokSetup: {
+    setupInstructions: "Create a Google Cloud service account with Storage Object Admin role and upload the JSON credentials to the secret store."
+  }
+});
+function registerGcsStorageIntegration(registry) {
+  return registry.register(gcsStorageIntegrationSpec);
+}
+export {
+  registerGcsStorageIntegration,
+  gcsStorageIntegrationSpec
+};

package/dist/node/integrations/providers/gmail.js

@@ -0,0 +1,108 @@
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/gmail.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var gmailIntegrationSpec = defineIntegration({
+  meta: {
+    key: "email.gmail",
+    version: "1.0.0",
+    category: "email",
+    title: "Google Gmail API",
+    description: "Gmail integration supporting inbound thread ingestion and outbound transactional email.",
+    domain: "communications",
+    owners: ["platform.messaging"],
+    tags: ["email", "gmail"],
+    stability: StabilityEnum.Beta
+  },
+  supportedModes: ["managed", "byok"],
+  capabilities: {
+    provides: [
+      { key: "email.inbound", version: "1.0.0" },
+      { key: "email.outbound", version: "1.0.0" }
+    ]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        labelIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional list of label IDs to scope inbound sync."
+        },
+        includeSpamTrash: {
+          type: "boolean",
+          description: "Whether to include spam or trash messages during sync."
+        }
+      }
+    },
+    example: {
+      labelIds: ["INBOX"],
+      includeSpamTrash: false
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["clientId", "clientSecret", "refreshToken"],
+      properties: {
+        clientId: {
+          type: "string",
+          description: "OAuth client ID for the Google Cloud project."
+        },
+        clientSecret: {
+          type: "string",
+          description: "OAuth client secret for the Google Cloud project."
+        },
+        refreshToken: {
+          type: "string",
+          description: "OAuth refresh token for delegated Gmail access."
+        },
+        redirectUri: {
+          type: "string",
+          description: "Optional redirect URI used when issuing the refresh token."
+        }
+      }
+    },
+    example: {
+      clientId: "xxx.apps.googleusercontent.com",
+      clientSecret: "secret",
+      refreshToken: "refresh-token"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 4000
+  },
+  docsUrl: "https://developers.google.com/gmail/api",
+  constraints: {
+    rateLimit: {
+      rpm: 600
+    }
+  },
+  byokSetup: {
+    setupInstructions: "Create an OAuth consent screen and credentials within Google Cloud Console, then authorize the Gmail scopes and store the resulting refresh token."
+  }
+});
+function registerGmailIntegration(registry) {
+  return registry.register(gmailIntegrationSpec);
+}
+export {
+  registerGmailIntegration,
+  gmailIntegrationSpec
+};

package/dist/node/integrations/providers/google-calendar.js

@@ -0,0 +1,91 @@
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/google-calendar.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var googleCalendarIntegrationSpec = defineIntegration({
+  meta: {
+    key: "calendar.google",
+    version: "1.0.0",
+    category: "calendar",
+    title: "Google Calendar API",
+    description: "Google Calendar integration for event creation, updates, and scheduling automations.",
+    domain: "productivity",
+    owners: ["platform.messaging"],
+    tags: ["calendar", "google"],
+    stability: StabilityEnum.Beta
+  },
+  supportedModes: ["managed", "byok"],
+  capabilities: {
+    provides: [{ key: "calendar.events", version: "1.0.0" }]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        calendarId: {
+          type: "string",
+          description: "Default calendar identifier (defaults to primary)."
+        }
+      }
+    },
+    example: {
+      calendarId: "primary"
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["clientEmail", "privateKey"],
+      properties: {
+        clientEmail: {
+          type: "string",
+          description: "Service account client email."
+        },
+        privateKey: {
+          type: "string",
+          description: "Service account private key."
+        },
+        projectId: {
+          type: "string",
+          description: "Google Cloud project ID."
+        }
+      }
+    },
+    example: {
+      clientEmail: "svc-calendar@example.iam.gserviceaccount.com",
+      privateKey: "-----BEGIN PRIVATE KEY-----...",
+      projectId: "calendar-project"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 4000
+  },
+  docsUrl: "https://developers.google.com/calendar/api",
+  constraints: {},
+  byokSetup: {
+    setupInstructions: "Create a Google service account with Calendar access and share the target calendars with the service account email."
+  }
+});
+function registerGoogleCalendarIntegration(registry) {
+  return registry.register(googleCalendarIntegrationSpec);
+}
+export {
+  registerGoogleCalendarIntegration,
+  googleCalendarIntegrationSpec
+};

package/dist/node/integrations/providers/gradium.js

@@ -0,0 +1,109 @@
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/gradium.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var gradiumIntegrationSpec = defineIntegration({
+  meta: {
+    key: "ai-voice.gradium",
+    version: "1.0.0",
+    category: "ai-voice",
+    title: "Gradium Text-to-Speech",
+    description: "Gradium integration for low-latency voice synthesis and voice catalog access.",
+    domain: "ai",
+    owners: ["platform.ai"],
+    tags: ["voice", "tts", "realtime"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["byok"],
+  capabilities: {
+    provides: [{ key: "ai.voice.synthesis", version: "1.0.0" }]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        defaultVoiceId: {
+          type: "string",
+          description: "Optional default voice identifier used for synthesis."
+        },
+        region: {
+          type: "string",
+          enum: ["eu", "us"],
+          description: "Gradium region used by the SDK (eu or us)."
+        },
+        baseUrl: {
+          type: "string",
+          description: "Optional API base URL override for private routing or proxies."
+        },
+        timeoutMs: {
+          type: "number",
+          description: "Optional request timeout in milliseconds."
+        },
+        outputFormat: {
+          type: "string",
+          enum: [
+            "wav",
+            "pcm",
+            "opus",
+            "ulaw_8000",
+            "alaw_8000",
+            "pcm_16000",
+            "pcm_24000"
+          ],
+          description: "Optional default output format used when no format is specified."
+        }
+      }
+    },
+    example: {
+      defaultVoiceId: "YTpq7expH9539ERJ",
+      region: "eu",
+      timeoutMs: 15000,
+      outputFormat: "wav"
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["apiKey"],
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "Gradium API key with TTS access."
+        }
+      }
+    },
+    example: {
+      apiKey: "gd_***"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 5000
+  },
+  docsUrl: "https://gradium.ai/api_docs.html",
+  byokSetup: {
+    setupInstructions: "Create a Gradium API key, select the target region, and store credentials in your tenant secret provider."
+  }
+});
+function registerGradiumIntegration(registry) {
+  return registry.register(gradiumIntegrationSpec);
+}
+export {
+  registerGradiumIntegration,
+  gradiumIntegrationSpec
+};

package/dist/node/integrations/providers/granola.js

@@ -0,0 +1,106 @@
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/granola.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var granolaIntegrationSpec = defineIntegration({
+  meta: {
+    key: "meeting-recorder.granola",
+    version: "1.0.0",
+    category: "meeting-recorder",
+    title: "Granola Meeting Notes",
+    description: "Granola meeting notes and transcripts via Enterprise API or MCP transport.",
+    domain: "productivity",
+    owners: ["platform.integrations"],
+    tags: ["meeting-recorder", "granola", "transcripts"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["byok"],
+  capabilities: {
+    provides: [
+      { key: "meeting-recorder.meetings.read", version: "1.0.0" },
+      { key: "meeting-recorder.transcripts.read", version: "1.0.0" }
+    ]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        baseUrl: {
+          type: "string",
+          description: "Optional override for the Granola API base URL. Defaults to https://public-api.granola.ai for API transport."
+        },
+        transport: {
+          type: "string",
+          enum: ["api", "mcp"],
+          description: "Transport mode for Granola integration. Use api for Enterprise API or mcp for broader MCP access."
+        },
+        mcpUrl: {
+          type: "string",
+          description: "Optional override for Granola MCP URL. Defaults to https://mcp.granola.ai/mcp."
+        },
+        mcpHeaders: {
+          type: "object",
+          additionalProperties: { type: "string" },
+          description: "Optional static headers for MCP gateway/proxy setups."
+        },
+        pageSize: {
+          type: "number",
+          description: "Page size for listing notes (maximum 30 per Granola API)."
+        }
+      }
+    },
+    example: {
+      transport: "mcp",
+      mcpUrl: "https://mcp.granola.ai/mcp",
+      pageSize: 10
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "Granola API key used as a Bearer token for Enterprise API requests (transport=api)."
+        },
+        mcpAccessToken: {
+          type: "string",
+          description: "Optional bearer token for MCP proxy/gateway auth (transport=mcp)."
+        }
+      }
+    },
+    example: {
+      mcpAccessToken: "granola-mcp-***"
+    }
+  },
+  healthCheck: {
+    method: "list",
+    timeoutMs: 8000
+  },
+  docsUrl: "https://docs.granola.ai/help-center/sharing/integrations/mcp",
+  byokSetup: {
+    setupInstructions: "Use Granola MCP for browser OAuth access, or configure an Enterprise API key for REST transport."
+  }
+});
+function registerGranolaIntegration(registry) {
+  return registry.register(granolaIntegrationSpec);
+}
+export {
+  registerGranolaIntegration,
+  granolaIntegrationSpec
+};