@fayz-ai/admin 0.10.0 → 0.11.0

package/dist/components/connect/AddConnectorPanel.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
-import { type UnifiedConnector } from './model';
+import { type ShelfIntegration, type UnifiedConnector } from './model';
 /**
- * The Fayz connector directory, as an "add" panel.
+ * What this app can be connected to, as an "add" panel.
  *
  * It lists the very same rows the hub does — same id, same mark, same badges —
  * because "Google Calendar" browsed here and "Google Calendar" configured in
@@ -9,22 +9,73 @@ import { type UnifiedConnector } from './model';
  * a name. Picking one opens the same journey panel; nothing is duplicated here,
  * so nothing can drift.
  *
- * Three states exist and the panel has to tell them apart, because collapsing
- * them is how a catalogue turns into a promise:
+ * Three sections, and the lines between them are what the app can actually do:
  *
- *   - **pronto para conectar** — a plugin in THIS app contributes it, so there
- *     is a real place to go and connect it.
- *   - **disponível no Fayz** — the platform has it built, but this app lacks the
- *     plugin that hosts it.
- *   - **em breve** — a catalogue entry with nothing behind it yet.
+ *   - **Instalados** — a plugin in this build contributes the connector, so it
+ *     can be connected now. One click, same journey as the hub.
+ *   - **Em breve** — a module this app HAS put the provider on its shelf, and
+ *     the integration is not built yet. Informational: it is the honest answer
+ *     to "o Kommo dá pra ligar?" from someone who has CRM.
+ *   - **Disponíveis com outro módulo** — the provider belongs to a module this
+ *     app was not built with.
+ *
+ * The last two are inert rows: they say why and stop. Not a disabled button,
+ * because a disabled control reads as something the user could fix, and a
+ * tenant admin cannot — modules are chosen when the app is built, there is no
+ * install path, no plan that unlocks one, and no route to link to (see
+ * ConnectorDetail's Note pattern, and #89's two-state ConnectorState).
+ *
+ * Both come from `SDK_INTEGRATIONS`, generated from the plugin manifests in
+ * this repo — never from the platform catalogue, whose `enabled` flag is
+ * addressed to a builder org and is how a salon owner was once offered Supabase
+ * and Anthropic. The catalogue is read only for a row's brand mark and its
+ * localized name; a provider no module declared appears in no list at all.
+ *
+ * The way to ask for more is the assistant — never a link into the builder
+ * directory, which is the same audience confusion wearing a politer hat.
+ *
+ * **`categories` scopes it to the section that opened it.** Opened from
+ * "Provedores de pagamento", the panel offered Bling and Melhor Envio — an ERP
+ * and a carrier, under a button whose only promise was a gateway. The section
+ * already knows which categories it is about (it filters its own list by them),
+ * so it says so here and the panel narrows: the same rows, the same journey,
+ * minus everything that could not have answered the question that was asked.
  */
-export declare function AddConnectorPanel({ open, onOpenChange, connectors, onSelect, }: {
+export declare function AddConnectorPanel({ open, onOpenChange, connectors, categories, onSelect, }: {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     /** The unified list; `null` while it loads. */
     connectors: UnifiedConnector[] | null;
+    /**
+     * Limit the panel to these connector categories — pass what the surrounding
+     * section lists. Omitted, the panel is the whole app, which is what the
+     * Integrações hub wants.
+     */
+    categories?: string[];
     onSelect: (connector: UnifiedConnector) => void;
 }): React.JSX.Element;
+/**
+ * "Em breve" — put on the shelf by a module this app HAS, and not built yet.
+ *
+ * The distinction earns its own section rather than a chip in the one below:
+ * someone who has CRM and reads "Kommo · requer o módulo CRM" concludes the
+ * screen is broken. What is missing here is the integration, not the module,
+ * and only this list can say so.
+ */
+export declare function ComingSoonSection({ integrations }: {
+    integrations: ShelfIntegration[];
+}): React.JSX.Element | null;
+/**
+ * "Disponíveis com outro módulo" — what belongs to a module this build left out.
+ *
+ * Exported so it can be rendered on its own: the panel around it is a Radix
+ * dialog, which renders into a portal and therefore into nothing at all under
+ * `renderToStaticMarkup` — a test of the whole modal would pass by asserting
+ * against an empty string.
+ */
+export declare function AvailableSection({ connectors }: {
+    connectors: ShelfIntegration[];
+}): React.JSX.Element | null;
 /** Small trigger a screen can render next to its heading. */
 export declare function AddConnectorButton({ onClick }: {
     onClick: () => void;

package/dist/components/connect/AddConnectorPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AddConnectorPanel.d.ts","sourceRoot":"","sources":["../../../src/components/connect/AddConnectorPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB,OAAO,EAAqC,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAElF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,+CAA+C;IAC/C,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAA;IACrC,QAAQ,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAChD,qBAiEA;AA0CD,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,qBAWtE"}
+{"version":3,"file":"AddConnectorPanel.d.ts","sourceRoot":"","sources":["../../../src/components/connect/AddConnectorPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,OAAO,EASL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,SAAS,CAAA;AAGhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,+CAA+C;IAC/C,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAA;IACrC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,QAAQ,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAChD,qBAoGA;AAqFD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,YAAY,EAAE,EAAE;IAAE,YAAY,EAAE,gBAAgB,EAAE,CAAA;CAAE,4BAevF;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,UAAU,EAAE,EAAE;IAAE,UAAU,EAAE,gBAAgB,EAAE,CAAA;CAAE,4BAqBlF;AAuDD,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,qBAWtE"}

package/dist/components/connect/ConnectorDeliveries.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { ConnectorDelivery } from '@fayz-ai/core';
+export declare function ConnectorDeliveries({ load, providerName, limit, }: {
+    load(options?: {
+        limit?: number;
+    }): Promise<ConnectorDelivery[]>;
+    providerName: string;
+    limit?: number;
+}): React.JSX.Element;
+//# sourceMappingURL=ConnectorDeliveries.d.ts.map

package/dist/components/connect/ConnectorDeliveries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorDeliveries.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorDeliveries.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAiBtD,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,YAAY,EACZ,KAAU,GACX,EAAE;IACD,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAA;IAChE,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,qBAyDA"}

package/dist/components/connect/ConnectorDetail.d.ts

@@ -1,9 +1,28 @@
 import React from 'react';
-import type { UnifiedConnector } from './model';
-/** Mark, name and badges — the same identity in the rail and in the sheet. */
+import { type UnifiedConnector } from './model';
+/**
+ * Who this is, and how it stands — the same badge the list uses.
+ *
+ * The header used to carry a state chip AND a direction badge AND a plane
+ * badge, with the state repeated in a line under it and a third time as a dot
+ * on the Settings tab. One fact, four renderings, in a 380px column. Now the
+ * state sits once, right of the name, in the component the list rows use; how
+ * it resolves is said in words on the tab where someone is reading about it.
+ */
 export declare function ConnectorHeading({ connector }: {
     connector: UnifiedConnector;
 }): React.JSX.Element;
+/** Whether this connector has anything to operate — the Settings tab's reason to exist. */
+export declare function hasOperatingSettings(connector: UnifiedConnector): boolean;
+/**
+ * What is missing, in the words the settings screen uses.
+ *
+ * `missingSettings` carries keys, and a key is what the code calls the thing.
+ * Naming them turns "falta configurar" — a label the person already read on the
+ * tab next to it — into the one sentence that tells them what to go and do.
+ */
+export declare function missingSettingLabels(connector: UnifiedConnector): string[];
+/** Installing, or operating. Which one is not a mode anyone picks — it is whether the accounts are linked. */
 export declare function ConnectorJourney({ connector, onChanged, onRevoke, }: {
     connector: UnifiedConnector;
     /** Something was connected/disconnected — the list should reload. */

package/dist/components/connect/ConnectorDetail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectorDetail.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorDetail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAiH/C,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,gBAAgB,CAAA;CAAE,qBAmB9E;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,SAAS,EACT,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAA;IAC3B,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACjE,qBAwIA;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAClC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACjE,4BAgBA"}
+{"version":3,"file":"ConnectorDetail.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorDetail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAgCzB,OAAO,EAAU,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAA;AA4HvD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,gBAAgB,CAAA;CAAE,qBAe9E;AAYD,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAK1E;AAkBD,8GAA8G;AAC9G,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,SAAS,EACT,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAA;IAC3B,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACjE,qBAMA;AAsVD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAClC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACjE,4BAgBA"}

package/dist/components/connect/ConnectorDisclosure.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+/**
+ * The two disclosure shapes the connector detail screens share.
+ *
+ * Both were tooltips for one afternoon and that was the wrong instrument: a
+ * tooltip is invisible on touch, closes when you move to read it, and can hold
+ * a phrase but not a sentence — and what is behind these is a sentence. Both
+ * are `<details>` instead: it opens on click, it opens on Enter, its content is
+ * in the DOM whether open or shut (so find-in-page and screen readers reach it,
+ * and Chrome opens it to show a match), and it needs no state.
+ */
+/** One identifier, its chips, and the prose one click below it. */
+export declare function DisclosureRow({ name, chips, detail, }: {
+    name: string;
+    chips?: React.ReactNode;
+    /** Nothing to expand renders a plain row — an empty accordion is a lie. */
+    detail?: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * The caveats a panel owes, folded away until someone wants them — behind a
+ * LABEL and not a bare ⓘ. An icon alone in a column of lists reads as
+ * decoration, so nobody presses it and the sentence behind it is never read,
+ * which for these particular sentences is the whole failure.
+ */
+export declare function DisclosureNote({ label, children }: {
+    label: string;
+    children: React.ReactNode;
+}): React.JSX.Element;
+//# sourceMappingURL=ConnectorDisclosure.d.ts.map

package/dist/components/connect/ConnectorDisclosure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorDisclosure.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorDisclosure.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB;;;;;;;;;GASG;AAEH,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,MAAM,GACP,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CACzB,qBA4BA;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,qBAa/F"}

package/dist/components/connect/ConnectorMark.d.ts

@@ -1,5 +1,11 @@
 import React from 'react';
 import type { UnifiedConnector } from './model';
+/**
+ * What a mark actually needs. Narrower than `UnifiedConnector` so a row that is
+ * NOT a connection — a connector waiting on a module this app doesn't have —
+ * can still wear its own face without being given a fake `state`.
+ */
+export type ConnectorMarkSubject = Pick<UnifiedConnector, 'id' | 'name'> & Partial<Pick<UnifiedConnector, 'icon' | 'logoUrl' | 'builtIn' | 'clientWebsite' | 'identityVerified'>>;
 /**
  * The face of a connector, resolved the same way everywhere it appears.
  *
@@ -14,7 +20,7 @@ import type { UnifiedConnector } from './model';
  * rather than one asset being unreachable — never happens.
  */
 export declare function ConnectorMark({ connector, size, }: {
-    connector: UnifiedConnector;
+    connector: ConnectorMarkSubject;
     size?: 'sm' | 'md';
 }): React.JSX.Element;
 //# sourceMappingURL=ConnectorMark.d.ts.map

package/dist/components/connect/ConnectorMark.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectorMark.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorMark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,IAAW,GACZ,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAA;IAC3B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CACnB,qBA0CA"}
+{"version":3,"file":"ConnectorMark.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorMark.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,MAAM,CAAC,GACtE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,eAAe,GAAG,kBAAkB,CAAC,CAAC,CAAA;AAExG;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,IAAW,GACZ,EAAE;IACD,SAAS,EAAE,oBAAoB,CAAA;IAC/B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CACnB,qBA0CA"}

package/dist/components/connect/ConnectorPermissions.d.ts

@@ -0,0 +1,49 @@
+import React from 'react';
+import { type UnifiedConnector } from './model';
+/**
+ * What the connector declared: the records it reaches, the facts it hears, and
+ * the moments it is called. The consent view, before authorizing.
+ *
+ * It renders in step 1 of the journey, which is the step that exists precisely
+ * so nobody is asked for a credential before they know what it buys. The grammar
+ * is OAuth consent's, because that is the one a reader already has: grouped by
+ * resource, one reason per row, read told apart from write, sensitive marked.
+ *
+ * **One panel, because it was one subject.** "Quando ele age" used to be a
+ * second, collapsible box under this one — and it listed the same event keys
+ * from the same declaration, so the reader met `agenda.booking_created` twice
+ * and had to work out whether the two lists disagreed. They never could: the
+ * events here ARE the subscriptions. Merged, with calls as a third group.
+ *
+ * **The one sentence that decides whether this screen is worth having.** Nothing
+ * on this platform enforces a permission today: the token minting that would
+ * (FAY-1381) landed only its browser half, and FAY-1348 §D7 — *"a credencial
+ * autoriza só as RPCs declaradas do conector"* — is not built. A screen that says
+ * "this integration can only read your appointments" while nothing stops it
+ * writing them manufactures an assurance that does not exist, which is the exact
+ * failure this epic keeps fighting.
+ *
+ * So the copy states what the declaration IS — what the connector says it needs,
+ * shown before you authorize — and `connectors.permissions.notEnforced` says in
+ * as many words that Fayz does not yet use it to block anything. When D7 lands,
+ * that string is what tightens; nothing else here has to change, because the
+ * list is already the list the token will carry ({@link connectorGrantScopes}).
+ *
+ * The same honesty governs the difference between the two lower groups, which is
+ * why they are not merged in turn: a CALL happens — code in this app invokes the
+ * connector at that moment. A fact it OUVE does not, yet: the generic ingress
+ * that reads `subscribesTo` and dispatches does not exist (docs/integrations/
+ * EVENTS.md), each connector delivers its own reaction today, and the copy must
+ * survive that gap without promising it closed. "Ouve", never "reage".
+ *
+ * Prose sits one click below the name it belongs to. Read as paragraphs under
+ * every row, the reasons were longer than the list they qualified and the panel
+ * became a wall nobody finishes — and a list nobody finishes discloses nothing.
+ *
+ * Absence is rendered as absence: a connector that declared nothing says so,
+ * rather than showing an empty box that reads as "it touches nothing".
+ */
+export declare function ConnectorPermissions({ connector }: {
+    connector: UnifiedConnector;
+}): React.JSX.Element | null;
+//# sourceMappingURL=ConnectorPermissions.d.ts.map

package/dist/components/connect/ConnectorPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorPermissions.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorPermissions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,gBAAgB,CAAA;CAAE,4BA8GlF"}

package/dist/components/connect/ConnectorRow.d.ts

@@ -16,18 +16,25 @@ export declare function PlaneBadge({ plane, active }: {
 export declare function DirectionBadge({ direction }: {
     direction: 'inbound' | 'outbound';
 }): React.JSX.Element;
-export declare function StateChip({ state }: {
+/**
+ * A connection's state, in one badge, everywhere it is shown.
+ *
+ * One component and one vocabulary across the list, the assistant's drawer and
+ * the connection's own header — the founder's ask, and the reason the label is
+ * now short enough to sit beside a name: "conectado · falta configurar" was a
+ * sentence pretending to be a chip.
+ */
+export declare function StateChip({ state, className }: {
     state: ConnectorState;
+    className?: string;
 }): React.JSX.Element;
 /**
- * One row of the unified list — inbound grant, installed connector or catalogue
- * entry, all the same shape. The row is the entry point of the journey: it says
- * what the thing is and how far along it is, and opening it is what explains
- * the rest.
+ * One row of the unified list — an inbound grant or an installed connector, both
+ * the same shape. The row is the entry point of the journey: it says what the
+ * thing is and how far along it is, and opening it is what explains the rest.
  */
-export declare function ConnectorRow({ connector, onOpen, showHost, }: {
+export declare function ConnectorRow({ connector, onOpen, }: {
     connector: UnifiedConnector;
     onOpen: (connector: UnifiedConnector) => void;
-    showHost?: boolean;
 }): React.JSX.Element;
 //# sourceMappingURL=ConnectorRow.d.ts.map

package/dist/components/connect/ConnectorRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectorRow.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/E;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,qBAkBxF;AAED,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,SAAS,GAAG,UAAU,CAAA;CAAE,qBASlF;AASD,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,qBAG7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,MAAM,EACN,QAAe,GAChB,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAA;IAC3B,MAAM,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,qBAmDA"}
+{"version":3,"file":"ConnectorRow.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAG/E;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,qBAkBxF;AAED,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,SAAS,GAAG,UAAU,CAAA;CAAE,qBASlF;AAUD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,qBAO5F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,MAAM,GACP,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAA;IAC3B,MAAM,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAC9C,qBAkDA"}

package/dist/components/connect/ConnectorRuns.d.ts

@@ -0,0 +1,50 @@
+import React from 'react';
+import type { SyncRun } from '@fayz-ai/core';
+import type { UnifiedConnector } from './model';
+/**
+ * One history, for every connector that has one.
+ *
+ * Google Calendar hand-rolled a run list. Bling hand-rolled a second. RankLayer
+ * a third, open banking a fourth — four renderings of the same four columns of
+ * `plg_sync_runs`, each with its own empty state, its own idea of what a failure
+ * looks like, and none of them reachable by a connector written next week. What
+ * differs between them was never the view: it was where the rows come from, and
+ * that is one declaration (`ConnectorDefinition.listRuns`).
+ *
+ * The reader asks two things here and they want different shapes. *"Deu certo?"*
+ * is answered before this component renders — by the dot on the tab that brought
+ * them, so it is answerable from the screen they landed on without a second
+ * status line anywhere. *"O que aconteceu no dia 3?"* is the list below, newest
+ * first, one row per run, with the run's own sentence on it.
+ */
+export interface ConnectorRunsState {
+    runs: SyncRun[];
+    loading: boolean;
+    reload: () => void;
+    /** The newest run failed — what the tab's warning dot is for. */
+    failing: boolean;
+}
+/**
+ * Load a connector's history.
+ *
+ * Lifted out of the view because the tab STRIP needs the answer too: a warning
+ * dot that only appeared once you opened the tab would be a warning nobody sees.
+ * One load feeds both.
+ */
+export declare function useConnectorRuns(connector: UnifiedConnector): ConnectorRunsState;
+/**
+ * "Something is wrong right now" — the newest run, and only the newest.
+ *
+ * A connector that failed on Tuesday and has run cleanly since is not failing;
+ * a dot that counted any failure in the last twenty would be permanent for every
+ * connector that has ever had a bad night, which is a dot nobody reads.
+ */
+export declare function isFailing(runs: SyncRun[]): boolean;
+/** Whether this connector has a Sincronizações tab — history, actions, or both. */
+export declare function hasRunHistory(connector: UnifiedConnector): boolean;
+/** The whole Sincronizações tab: what you can make it do, then what it has done. */
+export declare function ConnectorRuns({ connector, state, }: {
+    connector: UnifiedConnector;
+    state: ConnectorRunsState;
+}): React.JSX.Element;
+//# sourceMappingURL=ConnectorRuns.d.ts.map

package/dist/components/connect/ConnectorRuns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorRuns.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorRuns.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AASzB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAI5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,gBAAgB,GAAG,kBAAkB,CA6BhF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAElD;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAGlE;AASD,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,KAAK,GACN,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAA;IAC3B,KAAK,EAAE,kBAAkB,CAAA;CAC1B,qBAwDA"}

package/dist/components/connect/ConnectorSettings.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { ConnectorSetting } from '@fayz-ai/core';
+import type { UnifiedConnector } from './model';
+/**
+ * How a live integration behaves — the second half of the split.
+ *
+ * It renders through the same rows a plugin's own Settings tab uses
+ * (`SettingsGroup` + `ToggleRow`/`SelectRow`, plus the two this case needed),
+ * because the founder's ask was literally that: *assim como nosso generic plugin
+ * > Settings carrega os settings no menu de forma dinâmica*. Those rows are
+ * presentational and hand-composed today; a connector cannot hand-write React
+ * from a published package that the host app renders, so what is declarative
+ * here is the SCHEMA — `ConnectorDefinition.settings` — and this is the one
+ * renderer for it. Not a third settings system: the same components, driven by a
+ * declaration instead of by JSX.
+ *
+ * It appears only once the connection exists. That is the whole defect being
+ * fixed — a merchant could not connect AppMax without first deciding which
+ * payment methods they accept.
+ */
+export declare function ConnectorSettingsPanel({ connector, onSaved, bare, }: {
+    connector: UnifiedConnector;
+    onSaved?: () => void;
+    /** Drop the group heading: the surface hosting it already says "Configurações". */
+    bare?: boolean;
+}): React.JSX.Element | null;
+/** Empty passes: "not filled in yet" is `requiredToOperate`'s business, not the pattern's. */
+export declare function matchesPattern(setting: ConnectorSetting, value: unknown): boolean;
+//# sourceMappingURL=ConnectorSettings.d.ts.map

package/dist/components/connect/ConnectorSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorSettings.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorSettings.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAIzB,OAAO,KAAK,EAAE,gBAAgB,EAAyB,MAAM,eAAe,CAAA;AAI5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,SAAS,EACT,OAAO,EACP,IAAI,GACL,EAAE;IACD,SAAS,EAAE,gBAAgB,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,4BAoFA;AAyED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAQjF"}

package/dist/components/connect/ConnectorSyncActions.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { ConnectorSyncAction } from '@fayz-ai/core';
+/**
+ * One button row, for every connector that can be asked to do something.
+ *
+ * Google Calendar drew its own; Bling was about to draw a second. Everything
+ * that would have been repeated lives here — running state, toast, reloading the
+ * history, hiding an action with nothing to act on, confirming a write at the
+ * provider. Every word on screen comes off the declaration.
+ */
+export declare function ConnectorSyncActions({ actions, onRan, }: {
+    actions: ConnectorSyncAction[];
+    onRan?: () => void;
+}): React.JSX.Element | null;
+//# sourceMappingURL=ConnectorSyncActions.d.ts.map

package/dist/components/connect/ConnectorSyncActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectorSyncActions.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorSyncActions.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAGxD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,KAAK,GACN,EAAE;IACD,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CACnB,4BAuIA"}

package/dist/components/connect/ConnectorsPanel.d.ts

@@ -11,7 +11,7 @@ import { type UnifiedConnector } from './model';
  * connector.
  *
  * Two views in the drawer:
- *   - the list: what this organization has, then what Fayz offers
+ *   - the list: what this organization has
  *   - the journey: what a connector does, how it resolves, and how to authorize
  */
 interface ConnectorsSurfaceState {
@@ -29,8 +29,10 @@ interface ConnectorsSurfaceState {
     consume: () => void;
 }
 export declare const useConnectorsSurface: import("zustand").UseBoundStore<import("zustand").StoreApi<ConnectorsSurfaceState>>;
-/** Raise the assistant with the connectors drawer open, on a connector or the list. */
-export declare function openConnectorsPanel(connector?: UnifiedConnector | null): void;
+/** Raise the assistant with the connectors drawer open, on a connector or the
+ *  list. The id is all it takes — the panel resolves the row from its own list,
+ *  so a caller holding only a reference (an assistant card) can open it too. */
+export declare function openConnectorsPanel(connector?: Pick<UnifiedConnector, 'id'> | null): void;
 /** Whether the assistant is mounted and can host the journey. */
 export declare function useConnectorsPanelAvailable(): boolean;
 export declare function ConnectorsPanel({ onClose }: {

package/dist/components/connect/ConnectorsPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectorsPanel.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorsPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAWzB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEjE;;;;;;;;;;;;;GAaG;AAEH,UAAU,sBAAsB;IAC9B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACnC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACjC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,eAAO,MAAM,oBAAoB,qFAM9B,CAAA;AAEH,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAM7E;AAED,iEAAiE;AACjE,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAED,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,qBA6GnE"}
+{"version":3,"file":"ConnectorsPanel.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorsPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAWzB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEjE;;;;;;;;;;;;;GAaG;AAEH,UAAU,sBAAsB;IAC9B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACnC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACjC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,eAAO,MAAM,oBAAoB,qFAM9B,CAAA;AAEH;;gFAEgF;AAChF,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAMzF;AAED,iEAAiE;AACjE,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAED,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,qBA0GnE"}

package/dist/components/connect/ConnectorsTab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectorsTab.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorsTab.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAWzB;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,sBAmH5B"}
+{"version":3,"file":"ConnectorsTab.d.ts","sourceRoot":"","sources":["../../../src/components/connect/ConnectorsTab.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAWzB;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,sBA4G5B"}

package/dist/components/connect/connector-map.generated.d.ts

@@ -0,0 +1,28 @@
+import type { ConnectorCategory, ConnectorDirection, ConnectorPlane } from '@fayz-ai/core';
+export interface SdkIntegration {
+    /** Platform catalogue slug — the key every source joins on. */
+    slug: string;
+    name: string;
+    /** The module that brings it, and where it is configured. */
+    moduleId: string;
+    /** `available` — a ConnectorDefinition backs it. `soon` — declared only. */
+    status: 'available' | 'soon';
+    description?: string;
+    /** Lucide icon name (implemented connectors). */
+    icon?: string;
+    /** Brand mark: the connector's own, else the platform catalogue's. */
+    logoUrl?: string;
+    category?: ConnectorCategory | string;
+    direction?: ConnectorDirection;
+    planes?: ConnectorPlane[];
+    /** `ConnectorDefinition.id`, when one exists. Differs from the slug for plugbank. */
+    connectorId?: string;
+    /** Which plugin ships or declares it. An addon also needs its host module. */
+    declaredBy: {
+        pluginId: string;
+        package: string;
+        addon?: boolean;
+    };
+}
+export declare const SDK_INTEGRATIONS: readonly SdkIntegration[];
+//# sourceMappingURL=connector-map.generated.d.ts.map

package/dist/components/connect/connector-map.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-map.generated.d.ts","sourceRoot":"","sources":["../../../src/components/connect/connector-map.generated.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE1F,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,MAAM,EAAE,WAAW,GAAG,MAAM,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAA;IACrC,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8EAA8E;IAC9E,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CACnE;AAED,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EA8WrD,CAAA"}

package/dist/components/connect/connector-search.d.ts

@@ -0,0 +1,104 @@
+import type { ConnectorPlane, ConnectorState, ShelfIntegration, UnifiedConnector } from './model';
+/**
+ * "Queria que tivesse pagamento com a appmax."
+ *
+ * The assistant answered that it could not help integrate specific payment
+ * providers — while AppMax sat on the other half of the screen marked *pronto
+ * para conectar*. It was not wrong about its own tools; it had no way to read
+ * the list. This module is that way, and it is the SAME list: the inputs are
+ * whatever `buildConnectorList` and `shelfIntegrations` already produced for the
+ * screen, so a second answer is impossible by construction. Nothing here fetches
+ * anything, and nothing here holds a provider name of its own.
+ *
+ * What it adds is the reading: a person asks for a *need* ("quero receber por
+ * Pix", "preciso emitir nota fiscal") far more often than for a slug, and the
+ * data already carries the category that answers it.
+ */
+/**
+ * The honest answers, and the difference between them is what the person can do
+ * next:
+ *
+ *  - `connected` / `needs_setup` / `ready` — every {@link ConnectorState}: there
+ *    is a screen to go to. Only these.
+ *  - `soon` — a module this app HAS declared it; no implementation exists.
+ *  - `needs_module` — it belongs to a module this app was not built with, and a
+ *    tenant admin cannot install one (`useTenantPlugins` reads, it never
+ *    activates). Offering a button here would be a promise nobody can keep.
+ *
+ * DERIVED from `ConnectorState`, not re-typed alongside it. The two vocabularies
+ * met when the assistant learned to read this list, and the meeting has to be a
+ * fact about the types: `fromConnector` assigns the screen's state straight
+ * across, and "the tool's answer and the connectors screen never disagree" stops
+ * being something a test hopes for. The `+ 2` is the whole difference — the
+ * shelf holds rows the screen expresses as absence, and those are the two the
+ * assistant must not offer a door to.
+ *
+ * The forcing function is {@link STATE_RANK}: the next member `ConnectorState`
+ * grows is a compile error here, where somebody has to decide whether the
+ * assistant may offer it. `needs_setup` arrived exactly that way.
+ */
+export type ConnectorSuggestionState = ConnectorState | 'soon' | 'needs_module';
+export interface ConnectorSuggestion {
+    slug: string;
+    /** Row key for the journey panel — the connector id, when one backs it. */
+    id?: string;
+    name: string;
+    description?: string;
+    /** Raw `ConnectorCategory`; the reader-facing label is resolved through i18n. */
+    category?: string;
+    icon?: string;
+    logoUrl?: string;
+    state: ConnectorSuggestionState;
+    /** Plugin that hosts (or would host) it — what "requer o módulo X" names. */
+    moduleId?: string;
+    planes?: ConnectorPlane[];
+    /** The screen a human finishes it on. Present exactly when {@link hasDestination}, and NOWHERE else. */
+    route?: string;
+    score: number;
+}
+interface ParsedQuery {
+    raw: string;
+    terms: string[];
+    categories: Set<string>;
+}
+export declare function parseConnectorQuery(query: string): ParsedQuery;
+/**
+ * What this app can be connected to, for a need stated in the user's words.
+ *
+ * `connectors` and `shelf` come straight from the screen's own builders. A row
+ * the screen would not show cannot appear here, and — the point of #89 — a
+ * provider that exists only as a platform catalogue entry appears in neither.
+ */
+export declare function searchConnectors(input: {
+    connectors: UnifiedConnector[];
+    shelf: ShelfIntegration[];
+    query: string;
+    limit?: number;
+}): ConnectorSuggestion[];
+/**
+ * Whether this answer is one the connectors screen itself holds — and therefore
+ * one with a screen to go to.
+ *
+ * A type guard and not a boolean, because the narrowing is the statement: the
+ * suggestion states that have a destination are **exactly** `ConnectorState`,
+ * and the two that do not are exactly the shelf's. Everything downstream that
+ * needs a real `ConnectorState` (the `StateChip` on the card) gets it from here
+ * instead of casting, so a state added to either side cannot slip through as a
+ * widened union that happens to compile.
+ *
+ * `switch` and not a list, so that addition is a compile error rather than a
+ * silent `false`.
+ */
+export declare function isConnectorState(state: ConnectorSuggestionState): state is ConnectorState;
+/**
+ * Only a real destination gets a button. Asserted, not assumed.
+ *
+ * Renamed from `canConnectNow` when `needs_setup` arrived: that row is one a
+ * person should absolutely be sent to, and "can connect now" is precisely what
+ * is NOT true of it — it is connected, and what is missing is the
+ * configuration. This boolean goes on the wire and is read by a model, so the
+ * name is not decoration.
+ */
+export declare function hasDestination(suggestion: Pick<ConnectorSuggestion, 'state'>): boolean;
+export {};
+//# sourceMappingURL=connector-search.d.ts.map

package/dist/components/connect/connector-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-search.d.ts","sourceRoot":"","sources":["../../../src/components/connect/connector-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEjG;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,wBAAwB,GAAG,cAAc,GAAG,MAAM,GAAG,cAAc,CAAA;AAE/E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,wBAAwB,CAAA;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,wGAAwG;IACxG,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAuED,UAAU,WAAW;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CACxB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAc9D;AAuED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,UAAU,EAAE,gBAAgB,EAAE,CAAA;IAC9B,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,mBAAmB,EAAE,CAmBxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,wBAAwB,GAAG,KAAK,IAAI,cAAc,CAUzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,GAAG,OAAO,CAEtF"}