@tangle-network/sandbox-ui 0.113.6 → 0.114.0

package/dist/integrations.d.ts

@@ -1,5 +1,5 @@
-import * as React from 'react';
-
+import * as React$1 from "react";
+//#region src/integrations/types.d.ts
 /**
  * Shapes for the integrations primitives. Mirrors the platform's
  * `/v1/integrations/*` response shape so consumers can pipe payloads
@@ -8,101 +8,105 @@ import * as React from 'react';
  * leaf-level — no dependency on the server-side client.
  */
 interface IntegrationConnection {
-    id: string;
-    providerId: string;
-    connectorId?: string;
-    status: "connected" | "pending" | "revoked" | "expired" | (string & {});
-    grantedScopes?: string[];
-    accountDisplay?: string | null;
-    expiresAt?: string | null;
-    createdAt?: string;
-    updatedAt?: string;
+  id: string;
+  providerId: string;
+  connectorId?: string;
+  status: "connected" | "pending" | "revoked" | "expired" | (string & {});
+  grantedScopes?: string[];
+  accountDisplay?: string | null;
+  expiresAt?: string | null;
+  createdAt?: string;
+  updatedAt?: string;
 }
 interface IntegrationConnector {
-    connectorId: string;
-    displayName?: string;
-    description?: string;
-    scopes?: string[];
+  connectorId: string;
+  displayName?: string;
+  description?: string;
+  scopes?: string[];
 }
 interface IntegrationProvider {
-    providerId: string;
-    displayName?: string;
-    description?: string;
-    iconUrl?: string;
-    connectors?: IntegrationConnector[];
-    /**
-     * True when the platform can currently receive this provider's events.
-     * Absent means the platform predates inbound-readiness discovery.
-     */
-    eventIngressConfigured?: boolean;
+  providerId: string;
+  displayName?: string;
+  /** The hub catalog's name for the provider ("GitHub", "Google Sheets"). */
+  title?: string;
+  description?: string;
+  iconUrl?: string;
+  connectors?: IntegrationConnector[];
+  /**
+   * True when the platform can currently receive this provider's events.
+   * Absent means the platform predates inbound-readiness discovery.
+   */
+  eventIngressConfigured?: boolean;
 }
 interface IntegrationHealth {
-    connectionId: string;
-    status: "ok" | "degraded" | "failing" | "unknown" | (string & {});
-    checkedAt?: string;
-    message?: string;
+  connectionId: string;
+  status: "ok" | "degraded" | "failing" | "unknown" | (string & {});
+  checkedAt?: string;
+  message?: string;
 }
-
+//#endregion
+//#region src/integrations/integrations-panel.d.ts
 type IntegrationSort = "featured" | "alpha";
 interface IntegrationsPanelProps {
-    catalog: IntegrationProvider[];
-    connections: IntegrationConnection[];
-    healthByConnectionId?: Record<string, IntegrationHealth>;
-    isLoading?: boolean;
-    error?: Error | null;
-    /**
-     * Invoked when the user clicks an unconnected provider tile. The consumer
-     * should call its data hook's `connect(...)` action.
-     */
-    onConnect: (input: {
-        providerId: string;
-        connectorId: string;
-    }) => void | Promise<void>;
-    /**
-     * Invoked when the user confirms disconnecting a live connection from the
-     * disconnect control on a connected tile. May return a promise; the
-     * confirmation dialog shows a loading state until it settles and surfaces a
-     * thrown error inline.
-     */
-    onDisconnect: (connectionId: string) => void | Promise<void>;
-    /**
-     * Resolver for a connected app's management page URL. When it returns a URL,
-     * the connected tile's body and the overflow menu's "Manage" item become a
-     * real link opened in a new tab (so cmd/middle-click and "open in new tab"
-     * work). Return undefined to omit Manage for a given connection. Preferred
-     * over `onManage` — only fall back to the callback when the URL must be minted
-     * imperatively on click (e.g. a one-time token).
-     */
-    getManageHref?: (connection: IntegrationConnection) => string | undefined;
-    /**
-     * Imperative fallback for opening a connected app's management page, used only
-     * when `getManageHref` is not supplied (or returns undefined). The consumer is
-     * responsible for opening the page (e.g. `window.open(...)`).
-     */
-    onManage?: (input: {
-        connectionId: string;
-        providerId: string;
-    }) => void | Promise<void>;
-    /** Empty-state message when the catalog hasn't loaded any providers. */
-    emptyCatalogLabel?: string;
-    /**
-     * Provider ids surfaced first (in this order) before the rest are sorted
-     * alphabetically. Matching is normalized (case / separators ignored).
-     * Defaults to a curated list of common GTM/work providers.
-     */
-    featuredIds?: string[];
-    /** Initial sort mode. Defaults to "featured". */
-    defaultSort?: IntegrationSort;
-    /**
-     * Tiles the loading skeleton draws. A skeleton exists to reserve the space
-     * the real content will take, so pass the catalog size you expect when the
-     * consumer knows it; the default fills two rows at the widest breakpoint.
-     */
-    skeletonCount?: number;
-    className?: string;
+  catalog: IntegrationProvider[];
+  connections: IntegrationConnection[];
+  healthByConnectionId?: Record<string, IntegrationHealth>;
+  isLoading?: boolean;
+  error?: Error | null;
+  /**
+   * Invoked when the user clicks an unconnected provider tile. The consumer
+   * should call its data hook's `connect(...)` action.
+   */
+  onConnect: (input: {
+    providerId: string;
+    connectorId: string;
+  }) => void | Promise<void>;
+  /**
+   * Invoked when the user confirms disconnecting a live connection from the
+   * disconnect control on a connected tile. May return a promise; the
+   * confirmation dialog shows a loading state until it settles and surfaces a
+   * thrown error inline.
+   */
+  onDisconnect: (connectionId: string) => void | Promise<void>;
+  /**
+   * Resolver for a connected app's management page URL. When it returns a URL,
+   * the connected tile's body and the overflow menu's "Manage" item become a
+   * real link opened in a new tab (so cmd/middle-click and "open in new tab"
+   * work). Return undefined to omit Manage for a given connection. Preferred
+   * over `onManage` — only fall back to the callback when the URL must be minted
+   * imperatively on click (e.g. a one-time token).
+   */
+  getManageHref?: (connection: IntegrationConnection) => string | undefined;
+  /**
+   * Imperative fallback for opening a connected app's management page, used only
+   * when `getManageHref` is not supplied (or returns undefined). The consumer is
+   * responsible for opening the page (e.g. `window.open(...)`).
+   */
+  onManage?: (input: {
+    connectionId: string;
+    providerId: string;
+  }) => void | Promise<void>;
+  /** Empty-state message when the catalog hasn't loaded any providers. */
+  emptyCatalogLabel?: string;
+  /**
+   * Provider ids surfaced first (in this order) before the rest are sorted
+   * alphabetically. Matching is normalized (case / separators ignored).
+   * Defaults to a curated list of common GTM/work providers.
+   */
+  featuredIds?: string[];
+  /** Initial sort mode. Defaults to "featured". */
+  defaultSort?: IntegrationSort;
+  /**
+   * Tiles the loading skeleton draws. A skeleton exists to reserve the space
+   * the real content will take, so pass the catalog size you expect when the
+   * consumer knows it; the default fills two rows at the widest breakpoint.
+   */
+  skeletonCount?: number;
+  className?: string;
 }
-declare function IntegrationsPanel({ catalog, connections, healthByConnectionId, isLoading, error, onConnect, onDisconnect, getManageHref, onManage, emptyCatalogLabel, featuredIds, defaultSort, skeletonCount, className, }: IntegrationsPanelProps): React.JSX.Element;
-
+export declare function IntegrationsPanel({ catalog, connections, healthByConnectionId, isLoading, error, onConnect, onDisconnect, getManageHref, onManage, emptyCatalogLabel, featuredIds, defaultSort, skeletonCount, className }: IntegrationsPanelProps): React$1.JSX.Element;
+//#endregion
+//#region src/integrations/use-integrations.d.ts
 /**
  * Endpoint contract expected on the consumer app's server (which
  * wraps `PlatformHubClient` from `@tangle-network/agent-runtime/platform`):
@@ -120,48 +124,38 @@ declare function IntegrationsPanel({ catalog, connections, healthByConnectionId,
  *     → { connection: IntegrationConnection }
  */
 interface UseIntegrationsOptions {
-    /** Base URL where the consumer mounted the integrations endpoints. */
-    apiBaseUrl: string;
-    /** Custom fetch (tests / non-browser runtimes). */
-    fetchImpl?: typeof fetch;
-    /** Whether the initial load happens automatically on mount. */
-    autoLoad?: boolean;
+  /** Base URL where the consumer mounted the integrations endpoints. */
+  apiBaseUrl: string;
+  /** Custom fetch (tests / non-browser runtimes). */
+  fetchImpl?: typeof fetch;
+  /** Whether the initial load happens automatically on mount. */
+  autoLoad?: boolean;
 }
 interface UseIntegrationsResult {
-    catalog: IntegrationProvider[];
-    connections: IntegrationConnection[];
-    healthByConnectionId: Record<string, IntegrationHealth>;
-    isLoading: boolean;
-    error: Error | null;
-    refresh: () => Promise<void>;
-    /** Kick off OAuth — navigates the window on success. */
-    connect: (input: ConnectInput) => Promise<void>;
-    /** Revoke a connection by id; refreshes the connections list. */
-    disconnect: (connectionId: string) => Promise<void>;
+  catalog: IntegrationProvider[];
+  connections: IntegrationConnection[];
+  healthByConnectionId: Record<string, IntegrationHealth>;
+  isLoading: boolean;
+  error: Error | null;
+  refresh: () => Promise<void>;
+  /** Kick off OAuth — navigates the window on success. */
+  connect: (input: ConnectInput) => Promise<void>;
+  /** Revoke a connection by id; refreshes the connections list. */
+  disconnect: (connectionId: string) => Promise<void>;
 }
 interface ConnectInput {
-    providerId: string;
-    connectorId: string;
-    /**
-     * URL the platform redirects the user back to after OAuth. Must be
-     * allow-listed on the platform.
-     */
-    returnUrl: string;
-    requestedScopes?: string[];
+  providerId: string;
+  connectorId: string;
+  /**
+   * URL the platform redirects the user back to after OAuth. Must be
+   * allow-listed on the platform.
+   */
+  returnUrl: string;
+  requestedScopes?: string[];
 }
-declare function useIntegrations({ apiBaseUrl, fetchImpl, autoLoad, }: UseIntegrationsOptions): UseIntegrationsResult;
-
-/**
- * Provider branding: resolve a connector/provider slug to a logo and render it
- * with graceful fallbacks. Shared by the integrations catalog tiles and the
- * assistant's proposal card (its integration-requirement rows), so both surfaces
- * show the same brand mark for a given provider from one source of truth.
- *
- * Dependency-light on purpose — only React — so it can be pulled into the
- * always-loaded assistant entry without dragging the integrations panel's tree
- * along with it.
- */
-
+export declare function useIntegrations({ apiBaseUrl, fetchImpl, autoLoad }: UseIntegrationsOptions): UseIntegrationsResult;
+//#endregion
+//#region src/integrations/provider-logo.d.ts
 /**
  * Ordered candidate logo URLs for a provider slug, most specific first. The
  * renderer walks the chain on each `onError` until one loads, then falls back to
@@ -171,20 +165,20 @@ declare function useIntegrations({ apiBaseUrl, fetchImpl, autoLoad, }: UseIntegr
  * delisted (svgl.app) → a pinned override → the ActivePieces CDN by id (covers
  * most of the hub catalog) → derived simpleicons slugs → monogram.
  */
-declare function providerLogoCandidates(opts: {
-    id: string;
-    iconUrl?: string | null;
+export declare function providerLogoCandidates(opts: {
+  id: string;
+  iconUrl?: string | null;
 }): string[];
 interface ProviderIconProps {
-    /** Provider/connector slug, e.g. "github". */
-    id: string;
-    /** Explicit icon URL, tried before the derived simpleicons slugs. */
-    iconUrl?: string | null;
-    /** Name for the monogram fallback initial; defaults to the id. */
-    displayName?: string;
-    /** Square edge length in px. Default 24. */
-    size?: number;
-    className?: string;
+  /** Provider/connector slug, e.g. "github". */
+  id: string;
+  /** Explicit icon URL, tried before the derived simpleicons slugs. */
+  iconUrl?: string | null;
+  /** Name for the monogram fallback initial; defaults to the id. */
+  displayName?: string;
+  /** Square edge length in px. Default 24. */
+  size?: number;
+  className?: string;
 }
 /**
  * A provider's brand mark: the resolved logo, walking a candidate chain on load
@@ -192,6 +186,6 @@ interface ProviderIconProps {
  * left to the caller's `className` so the same component fits a large catalog
  * tile and a small inline requirement row.
  */
-declare function ProviderIcon({ id, iconUrl, displayName, size, className, }: ProviderIconProps): React.JSX.Element;
-
-export { type ConnectInput, type IntegrationConnection, type IntegrationConnector, type IntegrationHealth, type IntegrationProvider, type IntegrationSort, IntegrationsPanel, type IntegrationsPanelProps, ProviderIcon, type ProviderIconProps, type UseIntegrationsOptions, type UseIntegrationsResult, providerLogoCandidates, useIntegrations };
+export declare function ProviderIcon({ id, iconUrl, displayName, size, className }: ProviderIconProps): React$1.JSX.Element;
+//#endregion
+export type { ConnectInput, IntegrationConnection, IntegrationConnector, IntegrationHealth, IntegrationProvider, IntegrationSort, IntegrationsPanelProps, ProviderIconProps, UseIntegrationsOptions, UseIntegrationsResult };