@muxoai/sdk 1.3.0 → 1.4.3

package/dist/composio-catalog.d.ts

@@ -0,0 +1,234 @@
+/** SDK-free Composio enterprise toolkit and trigger catalogue shared by the Node server and the edge worker. */
+export interface ComposioToolkitMetadata {
+    slug: string;
+    name: string;
+    description: string;
+    categories: string[];
+    authSchemes: Array<"OAUTH2" | "API_KEY" | "BEARER_TOKEN" | "NO_AUTH">;
+    pinnedVersion: string;
+    readOnlyScopes: string[];
+    fullAccessScopes: string[];
+    lane?: "composio_sdk" | "stripe_projects" | "composio_instant" | "stripe_billing";
+    sampleActions: Array<{
+        upstreamSlug: string;
+        muxoSlug: string;
+        name: string;
+        riskLevel: "read" | "write" | "destructive" | "financial" | "provisioning" | "admin";
+    }>;
+}
+export type ComposioWebhookEventType = "composio.trigger.message" | "composio.trigger.disabled" | "composio.connected_account.expired" | "composio.connected_account.activated";
+export declare const COMPOSIO_V3_WEBHOOK_EVENTS: ComposioWebhookEventType[];
+export interface ComposioTriggerSubscription {
+    id: string;
+    upstreamTriggerId?: string;
+    workspaceId: string;
+    userId?: string;
+    triggerSlug: string;
+    providerSlug: string;
+    connectedAccountId: string;
+    webhookUrl: string;
+    config: Record<string, unknown>;
+    status: "active" | "paused" | "disabled";
+    source?: "composio_v3_sdk" | "muxo_managed";
+    createdAt: string;
+}
+export interface ComposioTriggerEventRecord {
+    id: string;
+    workspaceId: string;
+    eventType?: ComposioWebhookEventType | string;
+    webhookVersion?: "V3" | "V2" | "V1" | "direct";
+    signatureVerified?: boolean;
+    webhookId?: string;
+    triggerId?: string;
+    triggerSlug: string;
+    providerSlug: string;
+    connectedAccountId?: string;
+    userId?: string;
+    projectId?: string;
+    orgId?: string;
+    receivedAt: string;
+    promptInjectionScan: {
+        safe: boolean;
+        riskScore: number;
+        findings: string[];
+    };
+    disposition: "dispatched" | "quarantined";
+    payloadPreview: Record<string, unknown>;
+}
+export declare const ENTERPRISE_TOOLKITS_CATALOG: ComposioToolkitMetadata[];
+export declare function getSampleActionSchema(muxoSlug: string, upstreamSlug?: string): Record<string, unknown>;
+export interface ComposioTriggerType {
+    slug: string;
+    providerSlug: string;
+    name: string;
+    description: string;
+    config: Record<string, unknown>;
+}
+export declare const COMPOSIO_TRIGGER_CATALOGUE: ComposioTriggerType[];
+export declare function listComposioTriggerTypes(providerSlug?: string): ComposioTriggerType[];
+export declare function getComposioTriggerType(slug: string): ComposioTriggerType | null;
+/**
+ * Verifies a Composio V3 webhook HMAC-SHA256 signature (`v1,<base64>`) across Node and Cloudflare Workers.
+ * Signing input: `${webhookId}.${webhookTimestamp}.${rawPayload}`
+ */
+export declare function verifyComposioWebhookSignature(params: {
+    rawPayload: string;
+    signatureHeader?: string | null;
+    webhookIdHeader?: string | null;
+    webhookTimestampHeader?: string | null;
+    secret?: string | null;
+    toleranceSeconds?: number;
+}): Promise<{
+    verified: boolean;
+    reason?: string;
+}>;
+export interface ParsedComposioWebhookEnvelope {
+    eventType: ComposioWebhookEventType | string;
+    webhookVersion: "V3" | "V2" | "V1" | "direct";
+    webhookId?: string;
+    timestamp?: string;
+    triggerId?: string;
+    triggerSlug: string;
+    providerSlug: string;
+    connectedAccountId?: string;
+    connectionStatus?: "active" | "expired" | "disabled";
+    userId?: string;
+    projectId?: string;
+    orgId?: string;
+    payloadObj: Record<string, unknown>;
+}
+/**
+ * Normalizes Composio V3 webhook events (`composio.trigger.message`, `composio.trigger.disabled`,
+ * `composio.connected_account.expired`, `composio.connected_account.activated`) as well as direct
+ * trigger webhook payloads into a single canonical envelope.
+ */
+export declare function parseComposioWebhookEnvelope(body: Record<string, unknown>, headers?: {
+    webhookId?: string | null;
+    webhookTimestamp?: string | null;
+    webhookVersion?: string | null;
+}): ParsedComposioWebhookEnvelope;
+export declare function filterComposioToolkits(params?: {
+    category?: string;
+    search?: string;
+}): ComposioToolkitMetadata[];
+/** Least-privilege scopes for a custom auth config: explicit scopes win, then the toolkit's read-only or full set. */
+export declare function composioAuthConfigScopes(toolkitSlug: string, scopeMode: "read_only" | "full_access", customScopes?: string[]): string[];
+export interface MuxoConnectInputField {
+    name: string;
+    type?: string;
+    label?: string;
+    description?: string;
+    required?: boolean;
+    default?: string | null;
+}
+export interface MuxoConnectLinkMetadata {
+    token: string;
+    toolkitSlug: string;
+    toolkitName: string;
+    connectedAccountId: string | null;
+    authMode: string;
+    status: string;
+    callbackUrl: string | null;
+    expectedInputFields: MuxoConnectInputField[];
+}
+export declare function ensureOAuthCallbackParams(callbackUrl: string, workspaceId: string, providerSlug: string): string;
+/**
+ * Normalizes upstream Composio hosted link URLs (`connect.composio.dev/link/lk_...`,
+ * `dashboard.composio.dev/link/lk_...`, `backend.composio.dev/api/v3/s/...`, or
+ * legacy `/oauth/connect/lk_...`) directly to Composio's native hosted OAuth URL
+ * (`https://connect.composio.dev/link/<token>`), avoiding intermediate custom pages.
+ */
+export declare function wrapMuxoConnectUrl(rawUrl: string | null | undefined, _baseUrl?: string, _params?: {
+    workspaceId?: string;
+    providerSlug?: string;
+    callbackUrl?: string | null;
+    externalAccountId?: string | null;
+}): string | null;
+export declare function fetchMuxoConnectLinkMetadata(token: string, fallback?: {
+    workspaceId?: string;
+    providerSlug?: string;
+    callbackUrl?: string | null;
+    connectedAccountId?: string | null;
+}): Promise<MuxoConnectLinkMetadata>;
+export declare function submitMuxoConnectLink(token: string, input?: Record<string, unknown>, fallback?: {
+    workspaceId?: string;
+    providerSlug?: string;
+    callbackUrl?: string | null;
+    connectedAccountId?: string | null;
+}): Promise<{
+    ok: boolean;
+    status: string;
+    redirectUrl: string | null;
+    connectedAccountId: string | null;
+    error?: string;
+}>;
+/**
+ * Canonical Stripe Projects Cloud Infrastructure providers (`stripe_projects` lane).
+ * These providers are provisioned and deployed directly through Stripe Projects
+ * (and/or Muxo instant cloud provisioning) without Composio OAuth handoffs.
+ */
+export declare const STRIPE_PROJECTS_PROVIDER_SLUGS: Set<string>;
+export declare const STRIPE_PROJECTS_HOSTING_PROVIDERS: Set<string>;
+export declare const STRIPE_PROJECTS_DATABASE_PROVIDERS: ReadonlySet<string>;
+export declare const STRIPE_PROJECTS_MESSAGING_PROVIDERS: ReadonlySet<string>;
+export declare const STRIPE_PROJECTS_AI_SEARCH_PROVIDERS: ReadonlySet<string>;
+export declare const STRIPE_PROJECTS_SANDBOX_BROWSER_PROVIDERS: ReadonlySet<string>;
+export declare const STRIPE_PROJECTS_CANONICAL_RESOURCE_SLUG: Record<string, string>;
+/**
+ * Multi-service deployable slugs supported per Stripe Projects provider.
+ */
+export declare const STRIPE_PROJECTS_MULTI_SERVICE_MAP: Record<string, Record<string, string>>;
+export interface StripeProjectsDeployableCatalogEntry {
+    slug: string;
+    upstreamSlug: string;
+    providerSlug: string;
+    providerName: string;
+    serviceId: string;
+    name: string;
+    description: string;
+    categories: string[];
+    defaultPlan: string;
+    availablePlans: string[];
+    providerUrl: string;
+    llmContextUrl?: string;
+}
+export declare const STRIPE_PROJECTS_DEPLOYABLE_CATALOG: StripeProjectsDeployableCatalogEntry[];
+/**
+ * Stripe Projects Toolkits Catalog exposed alongside Enterprise Connected Apps in `/api/v1/toolkits`
+ * and `filterComposioToolkits` so every Stripe Projects provider and its services are discoverable as toolkits.
+ */
+export declare const STRIPE_PROJECTS_TOOLKITS_CATALOG: ComposioToolkitMetadata[];
+export declare function normalizeStripeProjectsProviderSlug(raw: string): string;
+export declare function isStripeProjectsExclusiveProvider(rawSlug: string): boolean;
+export declare function isStripeProjectsHostingProvider(rawSlug: string): boolean;
+export declare function isStripeProjectsDatabaseProvider(rawSlug: string): boolean;
+/**
+ * Resolves any tool or provider reference targeting a Stripe Projects provider
+ * (including `app.vercel.deploy`, `app.vercel.create_deployment`, `resource.vercel.deploy`,
+ * `vercel/deploy`, `app.netlify.deploy`, `app.turso.create_database`, `supabase_migration`,
+ * `resource.cloudflare.d1`, `resource.upstash.vector`, `resource.railway.postgres`, etc.)
+ * to its canonical `resource.<provider>.<service>` tool slug on the `stripe_projects` lane.
+ */
+export declare function resolveStripeProjectsCanonicalToolSlug(rawSlug: string): string | null;
+export declare function extractHostedHtmlFromInput(input: Record<string, unknown>): {
+    html: string | null;
+    files: Record<string, string>;
+    envVars: Record<string, string>;
+};
+export declare function extractDatabaseMigrationsFromInput(input: Record<string, unknown>): {
+    hasMigrations: boolean;
+    sqlStatements: string[];
+    tablesCreated: string[];
+};
+export declare function buildStandardStripeProjectsSecrets(params: {
+    providerSlug: string;
+    resourceName: string;
+    workspaceSlug?: string;
+    liveUrl?: string;
+}): Record<string, string>;
+export declare function renderDefaultHostedSiteHtml(params: {
+    resourceName: string;
+    providerName: string;
+    providerSlug: string;
+    liveUrl: string;
+}): string;