@fayz-ai/admin 0.10.0 → 0.12.0

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

@@ -0,0 +1,32 @@
+import type { ConnectorDefinition } from '@fayz-ai/core';
+import type { ShelfIntegration, UnifiedConnector } from './model';
+/**
+ * The connectors list, resolved outside React.
+ *
+ * `useConnectors` is the hook the screens render from; this is the same three
+ * sources through the same two builders, for a caller with no component to
+ * mount — the assistant's `findConnectors` executor. Sharing the builders is
+ * what keeps the tool and the screen from ever disagreeing: if this returned a
+ * list of its own the whole feature would be the bug it was written to fix.
+ *
+ * Both underlying loads are already shared — the catalogue is one flight per
+ * session, the statuses one batched read per tenant — so a tool call made while
+ * the screen is open costs nothing extra.
+ *
+ * Inbound grants are left out, deliberately. A granted external assistant is
+ * something the org approved, not an integration someone is shopping for, and
+ * fetching them needs an authenticated round trip this path has no reason to
+ * make.
+ */
+export interface ConnectorIndex {
+    connectors: UnifiedConnector[];
+    shelf: ShelfIntegration[];
+}
+export declare function loadConnectorIndex(input: {
+    definitions: ConnectorDefinition[];
+    /** Plugin ids mounted in this build — what tells "em breve" from "outro módulo". */
+    installedModules: string[];
+    /** Defaults to the active tenant — the same id the screen's statuses key on. */
+    tenantId?: string;
+}): Promise<ConnectorIndex>;
+//# sourceMappingURL=connector-sources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connector-sources.d.ts","sourceRoot":"","sources":["../../../src/components/connect/connector-sources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAIxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEjE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,gBAAgB,EAAE,CAAA;IAC9B,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAC1B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,WAAW,EAAE,mBAAmB,EAAE,CAAA;IAClC,oFAAoF;IACpF,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,OAAO,CAAC,cAAc,CAAC,CAY1B"}

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

@@ -0,0 +1,15 @@
+import type { ConnectorDefinition } from '@fayz-ai/core';
+import type { InstalledConnector } from './model';
+/** Test seam — drops in-flight bookkeeping. */
+export declare function resetConnectorStatusFlights(): void;
+/**
+ * Every installed connector's status. One read for all those that share
+ * `plg_connections`, plus one each for those that do not.
+ *
+ * `tenantId` is required for batching — without an active tenant there is no
+ * row to scope, and each connector falls back to reporting for itself.
+ */
+export declare function loadConnectorStatuses(definitions: ConnectorDefinition[], tenantId: string | undefined, options?: {
+    client?: unknown;
+}): Promise<InstalledConnector[]>;
+//# sourceMappingURL=connector-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connector-status.d.ts","sourceRoot":"","sources":["../../../src/components/connect/connector-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,mBAAmB,EAAmB,MAAM,eAAe,CAAA;AAC3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAqDjD,+CAA+C;AAC/C,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD;AAkCD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,mBAAmB,EAAE,EAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqB/B"}

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

@@ -0,0 +1,65 @@
+import type { ConnectorDefinition, ConnectorField, TestConnectionResult } from '@fayz-ai/core';
+import { type ConnectorCredentialSink } from '@fayz-ai/sdk';
+/**
+ * The split that keeps a tenant's secret out of connector-author code.
+ *
+ * The setup form collects one object; two very different things are in it. The
+ * domain the RankLayer account publishes to is configuration — the connector
+ * needs it, and it belongs in the app's own row. The API key next to it is a
+ * credential, and the moment `saveConnection(values)` is called with it, where
+ * it ends up is decided by code the platform does not own.
+ *
+ * Everything a connector is called through goes past here, so the split is not
+ * something each call site has to remember: `submitConnection` and
+ * `probeConnection` are the only two doors, and `NonSecretValues` is what comes
+ * out of both. The contract in `@fayz-ai/core` still types the callbacks as
+ * `Record<string, string>`, so the narrowing is expressed here — a plain
+ * `values` object is not a `NonSecretValues` and cannot be passed as one.
+ */
+declare const nonSecret: unique symbol;
+/** Form values that have been through the split — the only shape author code is handed. */
+export type NonSecretValues = Record<string, string> & {
+    readonly [nonSecret]: true;
+};
+/** The connection could not be saved because this app has nowhere safe to put the secret. */
+export declare class CredentialSinkMissingError extends Error {
+    constructor();
+}
+/** Masked, or explicitly marked — the unmasked half of a credential pair is still a credential. */
+export declare function isSecretField(field: ConnectorField): boolean;
+/** Whether saving this connector needs a sink at all — a connector with no secret asks nothing of the app. */
+export declare function needsCredentialSink(definition: Pick<ConnectorDefinition, 'fields'>): boolean;
+export declare function splitConnectorValues(fields: ConnectorField[] | undefined, values: Record<string, string>): {
+    safe: NonSecretValues;
+    secrets: Record<string, string>;
+};
+/**
+ * Test the connection with the non-secret half.
+ *
+ * The secret is discarded rather than forwarded: a pre-save test that worked
+ * would have to hand the credential to author code, which is the one thing this
+ * module exists to prevent. What a connector can still test this way is the
+ * connection it already has — so the hub only offers the button when there is
+ * no secret in the form.
+ */
+export declare function probeConnection(input: {
+    definition: ConnectorDefinition;
+    values: Record<string, string>;
+}): Promise<TestConnectionResult>;
+/**
+ * Place the credential, then save the rest.
+ *
+ * Sink first: a connection saved against a credential that never landed reads
+ * as "connected" and fails at the first sync, which is the harder failure to
+ * diagnose of the two.
+ */
+export declare function submitConnection(input: {
+    definition: ConnectorDefinition;
+    /** Raw form values, secrets included — this is where they part ways. */
+    values: Record<string, string>;
+    tenantId?: string;
+    /** Defaults to the app's configured sink; pass `null` to assert there is none. */
+    sink?: ConnectorCredentialSink | null;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=credentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/components/connect/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAC9F,OAAO,EAA8B,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAEvF;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,CAAC,MAAM,SAAS,EAAE,OAAO,MAAM,CAAA;AAEtC,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AAErF,6FAA6F;AAC7F,qBAAa,0BAA2B,SAAQ,KAAK;;CAKpD;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAE5D;AAED,8GAA8G;AAC9G,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,GAAG,OAAO,CAE5F;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EAAE,GAAG,SAAS,EACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAW5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,UAAU,EAAE,mBAAmB,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAGhC;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,UAAU,EAAE,mBAAmB,CAAA;IAC/B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,IAAI,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAA;CACtC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhB"}

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

@@ -3,10 +3,22 @@ export type { ConnectConsentPageProps } from './ConnectConsentPage';
 export { ConnectorsTab } from './ConnectorsTab';
 export { AddConnectorPanel, AddConnectorButton } from './AddConnectorPanel';
 export { ConnectorRow, PlaneBadge, DirectionBadge, StateChip } from './ConnectorRow';
-export { ConnectorDetail, ConnectorJourney, ConnectorHeading } from './ConnectorDetail';
+export { ConnectorDetail, ConnectorJourney, ConnectorHeading, hasOperatingSettings } from './ConnectorDetail';
+export { useConnectorOAuthReturn, readConnectorOAuthReturn, urlWithoutOAuthReturn, oauthFailureMessage, OAUTH_FAILURE_REASONS, } from './oauth-return';
+export type { ConnectorOAuthReturn, ConnectorOAuthFailureReason } from './oauth-return';
+export { ConnectorRuns, useConnectorRuns, hasRunHistory } from './ConnectorRuns';
+export { ConnectorSyncActions } from './ConnectorSyncActions';
+export { ConnectorDeliveries } from './ConnectorDeliveries';
+export type { ConnectorRunsState } from './ConnectorRuns';
 export { ConnectorMark } from './ConnectorMark';
 export { useConnectors, useConnectorCatalog } from './useConnectors';
+export { loadConnectorIndex } from './connector-sources';
+export type { ConnectorIndex } from './connector-sources';
+export { searchConnectors, hasDestination, isConnectorState } from './connector-search';
+export type { ConnectorSuggestion, ConnectorSuggestionState } from './connector-search';
 export { ConnectorsPanel, openConnectorsPanel, useConnectorsPanelAvailable } from './ConnectorsPanel';
-export { buildConnectorList, filterConnectors, sortConnectors, connectorRoute, CATEGORY_LABELS, } from './model';
-export type { UnifiedConnector, ConnectorState, ConnectorFilter, AgentGrant, CatalogConnector, InstalledConnector, } from './model';
+export { CredentialSinkMissingError, isSecretField, needsCredentialSink, probeConnection, splitConnectorValues, submitConnection, } from './credentials';
+export type { NonSecretValues } from './credentials';
+export { buildConnectorList, filterConnectors, sortConnectors, connectorRoute, connectorSubscriptions, categoryLabel, inCategories, CATEGORY_LABELS, } from './model';
+export type { UnifiedConnector, ConnectorState, ConnectorFilter, ConnectorSubscription, AgentGrant, CatalogConnector, InstalledConnector, } from './model';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACpF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAA;AACrG,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/connect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACpF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7G,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AACvF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACvF,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AACvF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAA;AACrG,OAAO,EACL,0BAA0B,EAC1B,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,SAAS,CAAA;AAChB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAA"}

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

@@ -1,4 +1,5 @@
-import type { ConnectorDefinition, ConnectorPlane, ConnectorDirection, ConnectorAgentTool } from '@fayz-ai/core';
+import type { ConnectorCategory, ConnectorDefinition, ConnectorPermission, ConnectorPlane, ConnectorDirection, ConnectorAgentTool, ConnectorInvocation } from '@fayz-ai/core';
+import { type SdkIntegration } from './connector-map.generated';
 /**
  * One list, one noun.
  *
@@ -21,20 +22,33 @@ import type { ConnectorDefinition, ConnectorPlane, ConnectorDirection, Connector
  */
 export type { ConnectorPlane, ConnectorDirection, ConnectorAgentTool };
 /**
- * How far along the journey a connector is. The distinction between `ready`,
- * `catalog` and `soon` is the one worth being strict about: collapsing them is
- * how a catalogue turns into a promise, because only `ready` has somewhere real
- * to send the user.
+ * How far along the journey a connector is.
+ *
+ * Every state is about a connector THIS app backs. Rows for what the platform
+ * *could* build were the defect — see {@link buildConnectorList} — and no state
+ * here may bring them back.
+ *
+ * `needs_setup` is not a fourth kind of "maybe connected": the authorization
+ * happened and nothing about it needs redoing. It exists because the connect
+ * step stopped asking for operational configuration, so there is now a real gap
+ * between "authorized" and "able to work" — and a carrier that cannot quote
+ * because nobody chose an origin postcode must not read as ready. The truth
+ * lives in `plg_connections.status = 'pending'`; this is its name in the UI.
+ *
+ * These tokens are not only rendered — they are the assistant's vocabulary too.
+ * {@link ConnectorSuggestionState} is this union plus the two shelf answers, and
+ * `findConnectors` puts the same word on the wire for a model to read, which is
+ * what makes "the tool and the screen never disagree" a fact about the types
+ * rather than something to keep in sync. Hence `needs_setup` and not
+ * `needs-setup`: its siblings over there are `soon` and `needs_module`.
  */
 export type ConnectorState = 
 /** Live — granted (inbound) or authorized (outbound). */
 'connected'
+/** Authorized, and unable to work until a required-to-operate setting is chosen. */
+ | 'needs_setup'
 /** Installed in this app: a plugin here contributes it, so it can be connected now. */
- | 'ready'
-/** The platform has it built, but this app lacks the plugin that hosts it. */
- | 'catalog'
-/** A catalogue entry with nothing behind it yet. */
- | 'soon';
+ | 'ready';
 export interface UnifiedConnector {
     /** Stable row key — connector id, catalog slug, or grant id. */
     id: string;
@@ -48,19 +62,25 @@ export interface UnifiedConnector {
     /** The plane it is running on right now (only meaningful when connected). */
     activePlane?: ConnectorPlane;
     state: ConnectorState;
+    /** Setting keys still to be chosen, when `state` is 'needs_setup'. Keys only. */
+    missingSettings?: string[];
     hostPluginId?: string;
     category?: string;
     /** Lucide icon name (installed connectors). */
     icon?: string;
     /** Brand mark from the catalogue or the granting client. */
     logoUrl?: string;
-    /** Canonical entities the connector touches. */
+    /** Canonical entities the connector touches — derived from `permissions`. */
     entities?: string[];
+    /** What the connector declared it needs access to, and why. Consent view's source. */
+    permissions?: ConnectorPermission[];
     /** How many record types it reaches, when the source only counts them. */
     entityCount?: number;
     /** Tools the assistant gains — declared (outbound) or granted (inbound). */
     agentTools?: ConnectorAgentTool[];
     detail?: string;
+    /** What is wrong with a live connection, when the connector enumerates it. */
+    issues?: string[];
     docsUrl?: string;
     builtIn?: boolean;
     revocable?: boolean;
@@ -107,45 +127,199 @@ export interface AgentGrant {
         tools: string[];
     };
 }
-/** A row of the Fayz connector directory. */
+/** A row of the Fayz connector directory — read here for copy and brand mark only. */
 export interface CatalogConnector {
     slug: string;
     name: string;
     description?: string;
     category?: string;
+    /** Builder-audience flag ("the Fayz panel has this wired"). Never a tenant signal. */
     enabled?: boolean;
     logoUrl?: string;
     iconUrl?: string;
-    /** Planes the platform declares for this provider, when it knows. */
-    planes?: ConnectorPlane[];
 }
-export declare const CATEGORY_LABELS: Record<string, string>;
-/** The four the product leads with; the rest follow, in catalogue order. */
-export declare const FEATURED: string[];
+/**
+ * Every category, in the tenant's language.
+ *
+ * Keyed by `ConnectorCategory` and not `string`, so the compiler is what catches
+ * the next shelf the catalogue adds. This map trailed the catalogue by five
+ * entries when M6 opened — `marketplace`, `crm`, `banking`, `local` and
+ * `courses` all rendered no badge — and nothing failed, which is exactly the
+ * failure mode a `Record<string, string>` guarantees.
+ */
+export declare const CATEGORY_LABELS: Record<ConnectorCategory, string>;
+/**
+ * The badge text for a category, or nothing.
+ *
+ * Still tolerant of an unknown string at runtime: a connector definition may
+ * arrive from a published third-party package built against an older core, and
+ * a raw `logistics` in front of a salon owner reads as a bug while a missing
+ * badge costs nothing.
+ */
+export declare function categoryLabel(category?: string): string | undefined;
 /** An installed connector plus the status the hub already resolved for it. */
 export interface InstalledConnector {
     definition: ConnectorDefinition;
     connected?: boolean;
     detail?: string;
+    /** Everything wrong with the live connection, when there is more than one thing. */
+    issues?: string[];
     /** Plane reported by `getStatus()`; falls back to the preferred one. */
     plane?: ConnectorPlane;
+    /** Connected, waiting on a required-to-operate setting. */
+    needsSetup?: boolean;
+    /** Which setting keys are missing. Keys only. */
+    missingSettings?: string[];
 }
 /**
- * Merge the three sources into the single list both surfaces render.
+ * The catalogue slug a connector joins on.
+ *
+ * The id names the implementation and the slug names the provider; they are
+ * only usually the same word. `plugbank` IS the directory's `tecnospeed` — and
+ * until the definition said so, that row looked up a slug that is not there and
+ * rendered a grey plug next to a household brand.
+ */
+export declare function connectorSlug(def: Pick<ConnectorDefinition, 'id' | 'catalogSlug'>): string;
+/**
+ * Merge the sources into the single list both surfaces render.
+ *
+ * A row exists if and only if something in THIS app backs it: an installed
+ * `ConnectorDefinition`, or a grant somebody approved. The Fayz catalogue is
+ * enrichment and nothing else — it lends an installed connector its localized
+ * copy and its brand mark, and contributes no row of its own.
  *
- * Installed connectors win over their catalogue twin — the catalogue only
- * lends them a brand mark — because the installed one is the copy with real
- * verbs behind it.
+ * It used to. The catalogue is the *builder* directory: `enabled` there means
+ * "the Fayz panel has this wired for a builder org" (its Supabase row is about
+ * provisioning an app's database), and reading that flag from a tenant screen
+ * offered Supabase, Anthropic and Google Analytics to the owner of a salon.
+ * An audience flag consumed audience-blind is not a filter problem — the rows
+ * were never addressed to this reader.
  */
 export declare function buildConnectorList(input: {
     installed?: InstalledConnector[];
     grants?: AgentGrant[];
     catalog?: CatalogConnector[];
 }): UnifiedConnector[];
-/** Connected first, then what can be connected here, then the catalogue. */
+/** Connected first, then what can be connected here; alphabetical within each. */
 export declare function sortConnectors(list: UnifiedConnector[]): UnifiedConnector[];
+/** One event a live connector says it listens to, with the reaction it owns. */
+export interface ConnectorSubscription {
+    /** Exact key of a managed automation, or the raw pattern when none covers it. */
+    key: string;
+    /** What the tenant is told happens — only for an automation the connector owns. */
+    label?: string;
+}
+/**
+ * What a connector listens to, once it is live.
+ *
+ * Empty until connected on purpose: a subscription is a fact about a running
+ * connection, and listing it next to a connect button would read as a promise
+ * the app has not made yet.
+ */
+export declare function connectorSubscriptions(connector: UnifiedConnector): ConnectorSubscription[];
+/** Live — authorized, whether or not it is fully configured. */
+export declare function isLive(state: ConnectorState): boolean;
+/**
+ * "Acionado em quais momentos" — the two answers, kept apart.
+ *
+ * `calls` are invocations that exist in code and may be described plainly.
+ * `events` are subscriptions, which the platform does not dispatch yet, so the
+ * copy next to them says "ouve" and never "reage". Splitting them here rather
+ * than in the component is what keeps that distinction assertable.
+ *
+ * Unlike {@link connectorSubscriptions}, this answers before the connection
+ * exists: it describes what the connector IS, which is what step 1 is for.
+ */
+export declare function connectorMoments(connector: UnifiedConnector): {
+    calls: ConnectorInvocation[];
+    events: ConnectorSubscription[];
+};
+/**
+ * A slug a module put on the shelf, and cannot be connected right now.
+ *
+ * Deliberately NOT a {@link UnifiedConnector}: there is no connection, no
+ * status to probe and nothing to click, and giving it a `state` would be the
+ * third state #89 deleted — the one that turned "the platform could build this"
+ * into a row a salon owner was invited to press. What it carries instead is
+ * why: a module that is not here, or an integration that is not built yet.
+ */
+export interface ShelfIntegration {
+    id: string;
+    slug: string;
+    name: string;
+    description?: string;
+    category?: string;
+    icon?: string;
+    logoUrl?: string;
+    planes?: ConnectorPlane[];
+    direction?: ConnectorDirection;
+    /** Plugin id of the module that brings it — labelled through i18n. */
+    moduleId: string;
+    /** Whether that module is mounted in this build. */
+    moduleInstalled: boolean;
+    /** `available` — implemented, waiting on the module. `soon` — declared, not built. */
+    status: 'available' | 'soon';
+}
+/**
+ * The rows "Adicionar conector" can offer: everything an installed plugin backs.
+ *
+ * What it drops is a granted assistant — that arrives by approving a consent
+ * screen, not by being added, and it is already in the list behind the panel.
+ * The tell is having no `definition`, NOT `direction`: direction is which side
+ * reaches for the other, and filtering on it silently hid Bling, PlugBank and
+ * RankLayer — three connectors an installed plugin ships and a shopkeeper came
+ * here to add.
+ */
+export declare function addableConnectors(list: UnifiedConnector[]): UnifiedConnector[];
+/**
+ * Narrow any connector-ish list to the categories a section is about.
+ *
+ * One function for both the installed rows and the shelf, because the bug it
+ * fixes was the two disagreeing: "Provedores de pagamento" filtered its own
+ * list by `payments` and then opened an add panel that offered the ERP and the
+ * carrier. No categories means no narrowing — the hub is the whole app.
+ *
+ * A row with no category is dropped when a scope is given: it cannot be shown
+ * to belong, and guessing is how a gateway list grows a CRM.
+ */
+export declare function inCategories<T extends {
+    category?: string;
+}>(list: T[], categories?: string[]): T[];
+/**
+ * Everything the modules put within reach that is not already a row above.
+ *
+ * The source is {@link SDK_INTEGRATIONS}, generated from the plugin manifests
+ * in this repo — never the platform catalogue. The catalogue is a builder
+ * directory with no notion of a host plugin, and reading it here is how the
+ * owner of a salon was once offered Supabase and Anthropic. What decides is the
+ * module: having CRM is what makes Kommo relevant, having Financeiro is what
+ * makes AbacatePay relevant. A slug reaches this list because a manifest asked
+ * for it, and for no other reason — asserted, not assumed.
+ *
+ * The catalogue is still read, for exactly two things: the localized name and
+ * the brand mark, joined by slug. It contributes no row.
+ *
+ * One row per slug, even though a slug can be on two modules' shelves (Stripe
+ * is money-in for Loja, Financeiro and Cursos). The winner is the module this
+ * app actually has, then the one that already implements it — a shopkeeper does
+ * not care which module technically hosts it, only whether it is within reach.
+ */
+export declare function shelfIntegrations(input: {
+    present: UnifiedConnector[];
+    /** Plugin ids mounted in this build — what tells "em breve" from "outro módulo". */
+    installedModules?: Iterable<string>;
+    /** The Fayz directory, for the localized name and the brand mark. */
+    catalog?: CatalogConnector[];
+    map?: readonly SdkIntegration[];
+}): ShelfIntegration[];
+/** Declared by a module this app HAS, and not built yet — informational. */
+export declare function comingSoonHere(list: ShelfIntegration[]): ShelfIntegration[];
+/** Implemented or promised by a module this app was not built with. */
+export declare function withAnotherModule(list: ShelfIntegration[]): ShelfIntegration[];
+/** Same free-text match the installed list uses, so one query filters both. */
+export declare function filterAvailable(list: ShelfIntegration[], query?: string): ShelfIntegration[];
 export type ConnectorFilter = 'all' | 'connected' | 'agentic' | 'sync' | 'inbound' | 'outbound';
 export declare function filterConnectors(list: UnifiedConnector[], filter: ConnectorFilter, query?: string): UnifiedConnector[];
 /** Deep link to where a connector is actually configured. */
-export declare function connectorRoute(connector: UnifiedConnector): string;
+export declare function connectorRoute(connector: Pick<UnifiedConnector, 'hostPluginId'>): string;
 //# sourceMappingURL=model.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/connect/model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/components/connect/model.ts"],"names":[],"mappings":"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"}

package/dist/components/connect/oauth-return.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Every reason the platform's redirect route can give for a failure.
+ *
+ * A closed set, and an allow-list rather than a formatting rule: the value
+ * arrives in a query string anyone can type, and it is about to select a
+ * sentence shown to a shop owner. A slug that is not on this list is not
+ * rendered at all — `token_exchange_failed` on a merchant's screen is noise
+ * either way, and an arbitrary string from the URL bar would be worse.
+ */
+export declare const OAUTH_FAILURE_REASONS: readonly ["config_missing", "invalid_state", "expired_state", "not_a_member", "provider_denied", "missing_code", "token_exchange_failed", "token_incomplete", "store_failed", "unexpected"];
+export type ConnectorOAuthFailureReason = (typeof OAUTH_FAILURE_REASONS)[number];
+export interface ConnectorOAuthReturn {
+    connectorId: string;
+    status: 'connected' | 'error';
+    /**
+     * The platform's own verdict, from {@link OAUTH_FAILURE_REASONS}. Generic
+     * callbacks only, and never rendered as-is — see {@link oauthFailureMessage}.
+     */
+    reason?: ConnectorOAuthFailureReason;
+    /**
+     * The provider's own words, when a legacy per-connector callback passed any.
+     *
+     * Kept apart from `reason` because they are different kinds of thing: the
+     * calendar function has always written prose a person can read ("acesso
+     * negado"), and collapsing the two would either print a slug or throw away a
+     * sentence that was already in the reader's language.
+     */
+    message?: string;
+}
+/** What the callback said, or null when this is an ordinary page load. */
+export declare function readConnectorOAuthReturn(search: string): ConnectorOAuthReturn | null;
+/** Every query key this module owns — what has to leave the URL once it is read. */
+export declare function oauthReturnParams(): string[];
+/**
+ * The same URL with the markers gone.
+ *
+ * The hash is preserved untouched — it is the route the person was on before
+ * they left for Google, and losing it would land them somewhere else after a
+ * successful grant.
+ */
+export declare function urlWithoutOAuthReturn(href: string): string;
+/**
+ * What to tell the person, in their language.
+ *
+ * Three sources, in order of how much they know: the platform's slug becomes a
+ * translated sentence; a legacy callback's prose is already a sentence and is
+ * passed through; anything else is the honest generic failure. The second
+ * `t(key) !== key` guard is belt and braces — a slug that reached the closed set
+ * before someone wrote its copy must still not print as `store_failed`.
+ */
+export declare function oauthFailureMessage(t: (key: string) => string, result: Pick<ConnectorOAuthReturn, 'reason' | 'message'>): string;
+/**
+ * Mounted once, in the shell: a consent screen can return to any route.
+ *
+ * The marker is consumed exactly once — `replaceState` strips it before the
+ * panel opens, so a refresh is a refresh and not a second "conectado".
+ */
+export declare function useConnectorOAuthReturn(): void;
+//# sourceMappingURL=oauth-return.d.ts.map

package/dist/components/connect/oauth-return.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-return.d.ts","sourceRoot":"","sources":["../../../src/components/connect/oauth-return.ts"],"names":[],"mappings":"AA2CA;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,6LAWxB,CAAA;AAEV,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAIhF,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,WAAW,GAAG,OAAO,CAAA;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,2BAA2B,CAAA;IACpC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CA2BpF;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAI5C;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAC1B,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,CAAC,GACvD,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAyB9C"}

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

@@ -1,5 +1,18 @@
 import { type CatalogConnector, type UnifiedConnector } from './model';
+export declare function loadCatalog(): Promise<CatalogConnector[]>;
 export declare function useConnectorCatalog(): CatalogConnector[] | null;
+/** Every connector list on screen re-reads. Safe to call from anywhere. */
+export declare function refreshConnectors(): void;
+/**
+ * Plugin ids mounted in this build.
+ *
+ * What tells "não dá pra ligar ainda" from "não tem esse módulo": both are inert
+ * rows on the same shelf, and only the module the app actually has decides which
+ * sentence is true. Inactive plugins count — a module switched off for a tenant
+ * is still in the app, and offering it as something a new build would bring is a
+ * lie the tenant can disprove from the settings screen.
+ */
+export declare function useInstalledModuleIds(): string[];
 export interface ConnectorsView {
     connectors: UnifiedConnector[] | null;
     error: string | null;
@@ -12,13 +25,14 @@ export interface ConnectorsView {
 }
 /**
  * Builds the unified list: inbound grants (what reaches this org) + installed
- * connectors (what this app reaches) + the Fayz catalogue (what it could).
+ * connectors (what this app reaches). The catalogue contributes no row — it only
+ * lends the connectors that ARE installed their localized copy and brand mark.
  */
 export declare function useConnectors(options?: {
     hostPluginId?: string;
     /** Include the inbound grants — the plugin-scoped view leaves them out. */
     includeGrants?: boolean;
-    /** Include catalogue rows this app can't connect yet. */
+    /** Enrich installed connectors with the catalogue's localized copy and mark. */
     includeCatalog?: boolean;
 }): ConnectorsView;
 //# sourceMappingURL=useConnectors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useConnectors.d.ts","sourceRoot":"","sources":["../../../src/components/connect/useConnectors.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,gBAAgB,EAErB,KAAK,gBAAgB,EACtB,MAAM,SAAS,CAAA;AAgChB,wBAAgB,mBAAmB,IAAI,gBAAgB,EAAE,GAAG,IAAI,CAY/D;AAaD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAA;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,gEAAgE;IAChE,WAAW,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IACrC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,cAAc,CAmHtB"}
+{"version":3,"file":"useConnectors.d.ts","sourceRoot":"","sources":["../../../src/components/connect/useConnectors.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,gBAAgB,EAErB,KAAK,gBAAgB,EACtB,MAAM,SAAS,CAAA;AAgBhB,wBAAgB,WAAW,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAczD;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,EAAE,GAAG,IAAI,CAY/D;AA0BD,2EAA2E;AAC3E,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAGhD;AAaD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAA;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,gEAAgE;IAChE,WAAW,EAAE,CAAC,SAAS,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE;IACrC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,cAAc,CAyGtB"}

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

@@ -0,0 +1,22 @@
+/**
+ * When something happened, in the reader's language.
+ *
+ * Both formatters used to be private to ConnectorDetail, and the relative one
+ * had "agora" and "há 2 h" written into it — correct for the only locale that
+ * had a reader, and a lie in the en bundle next to it. The translator is passed
+ * in rather than hooked so the same functions work inside a `.map` and inside a
+ * test with no provider mounted.
+ */
+/** Same shape core's `useTranslation` hands back. */
+export type Translate = (key: string, params?: Record<string, string | number>) => string;
+export declare function formatDate(iso: string): string;
+/** Full stamp, for the title of something showing a relative time. */
+export declare function formatDateTime(iso: string): string;
+/**
+ * "há 2 h" up to a month, and a date after that.
+ *
+ * A month-old run is answered with the day it happened: nobody counts back 47
+ * days, and "is it working?" stopped being the question long before then.
+ */
+export declare function formatRelative(iso: string, t: Translate): string;
+//# sourceMappingURL=when.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"when.d.ts","sourceRoot":"","sources":["../../../src/components/connect/when.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qDAAqD;AACrD,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAA;AAEzF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAUhE"}

package/dist/components/layout/CommandPalette.d.ts

@@ -9,8 +9,11 @@ export interface CommandItem {
     keywords?: string;
     subtitle?: string;
 }
-/** Runs one global search. `onPartial` paints a cheap early answer, if there is one. */
-export type EntitySearchFn = (query: string, onPartial?: (result: GlobalSearchResult) => void) => Promise<GlobalSearchResult>;
+/** Runs one global search. `onPartial` paints a cheap early answer, if there is one.
+ *  `opts.fresh` bypasses every cache — the footer's refresh button uses it. */
+export type EntitySearchFn = (query: string, onPartial?: (result: GlobalSearchResult) => void, opts?: {
+    fresh?: boolean;
+}) => Promise<GlobalSearchResult>;
 interface CommandPaletteProps {
     commands?: CommandItem[];
     open: boolean;