@burdenoff/fe-libs 2026.1030.1 → 2026.1030.3

package/dist/connections/ShareConnectionDialog.js

@@ -0,0 +1,146 @@
+import { cn as e } from "../lib/utils.js";
+import { englishTranslator as t } from "../credentials/translate.js";
+import { VisibilityChoice as n } from "./VisibilityChoice.js";
+import { DIALOG_Z as r, OVERLAY_Z as i, SURFACE_CLASS as a } from "./frame.js";
+import { createConnectionSharingApi as o } from "./sharingApi.js";
+import { principalKey as s, useConnectionSharingDraft as c } from "./useConnectionSharingDraft.js";
+import { GrantList as l, OwnerField as u, PrincipalSearch as d } from "./SharePanels.js";
+import { useId as f, useMemo as p, useRef as m } from "react";
+import { Loader2 as h, X as g } from "lucide-react";
+import { Fragment as _, jsx as v, jsxs as y } from "react/jsx-runtime";
+import * as b from "@radix-ui/react-dialog";
+//#region src/connections/ShareConnectionDialog.tsx
+var x = "share-connection-dialog-title", S = ({ draft: e, idPrefix: t, translate: r }) => {
+	let i = new Set([...e.grants.map((e) => s(e.principalType, e.principalId)), s("USER", e.ownerId)]);
+	return /* @__PURE__ */ y(_, { children: [
+		!e.editable && /* @__PURE__ */ v("p", {
+			className: "rounded-md border border-border-subtle bg-accent/30 p-3 text-xs text-text-secondary",
+			children: r("integrations.sharing.readOnly", "Only the owner, editors and workspace admins can change who can use this connection.")
+		}),
+		/* @__PURE__ */ v(u, {
+			id: `${t}-owner`,
+			ownerId: e.ownerId,
+			onChange: e.setOwnerId,
+			changeable: e.administrator,
+			members: e.principals.filter((e) => e.principalType === "USER"),
+			ownerLabel: e.labelOf("USER", e.ownerId),
+			translate: r
+		}),
+		/* @__PURE__ */ v(n, {
+			value: e.visibility,
+			onChange: e.setVisibility,
+			translate: r,
+			idPrefix: t,
+			disabled: !e.editable
+		}),
+		/* @__PURE__ */ v(d, {
+			id: `${t}-add`,
+			principals: e.principals,
+			excluded: i,
+			onAdd: e.addGrant,
+			disabled: !e.editable,
+			translate: r
+		}),
+		/* @__PURE__ */ v(l, {
+			idPrefix: t,
+			grants: e.grants,
+			visibility: e.visibility,
+			labelOf: e.labelOf,
+			onRole: e.setRole,
+			onRemove: e.removeGrant,
+			disabled: !e.editable,
+			translate: r
+		})
+	] });
+};
+function C(e, t, n) {
+	return e.loadError ? /* @__PURE__ */ v("p", {
+		role: "alert",
+		className: "text-sm text-status-error-text",
+		children: e.loadError
+	}) : e.sharing ? /* @__PURE__ */ v(S, {
+		draft: e,
+		idPrefix: t,
+		translate: n
+	}) : /* @__PURE__ */ y("div", {
+		className: "flex items-center gap-2 text-sm text-text-secondary",
+		children: [/* @__PURE__ */ v(h, {
+			size: 16,
+			className: "animate-spin",
+			"aria-hidden": !0
+		}), n("integrations.sharing.loading", "Loading sharing…")]
+	});
+}
+var w = ({ open: n, onClose: s, client: l, connectionId: u, workspaceId: d, translate: _ = t, onShared: S, api: w }) => {
+	let T = p(() => w ?? o(l), [w, l]), E = f(), D = c(T, n, u, d), O = m(null), k = m(null), A = async () => {
+		let e = await D.save();
+		e && (S?.(e), s());
+	};
+	return /* @__PURE__ */ v(b.Root, {
+		open: n,
+		onOpenChange: (e) => !e && s(),
+		children: /* @__PURE__ */ y(b.Portal, { children: [/* @__PURE__ */ v(b.Overlay, {
+			className: "fixed inset-0 bg-bg-overlay animate-in fade-in-0 duration-200",
+			style: { zIndex: i }
+		}), /* @__PURE__ */ y(b.Content, {
+			ref: O,
+			onOpenAutoFocus: (e) => {
+				k.current = document.activeElement instanceof HTMLElement ? document.activeElement : null, e.preventDefault(), O.current?.focus({ preventScroll: !0 });
+			},
+			onCloseAutoFocus: (e) => {
+				e.preventDefault();
+				let t = k.current;
+				t && t.isConnected && t !== document.body && t.focus({ preventScroll: !0 });
+			},
+			"aria-labelledby": x,
+			"aria-describedby": void 0,
+			style: { zIndex: r },
+			className: e(a, "fixed inset-x-4 top-4 bottom-4 mx-auto flex max-w-lg flex-col overflow-hidden rounded-xl sm:top-1/2 sm:bottom-auto sm:max-h-[min(90vh,48rem)] sm:-translate-y-1/2"),
+			"data-testid": "share-connection-dialog",
+			children: [
+				/* @__PURE__ */ y("div", {
+					className: "flex items-start justify-between gap-4 border-b border-border-subtle px-5 py-4",
+					children: [/* @__PURE__ */ v(b.Title, {
+						id: x,
+						className: "text-base font-semibold text-text-primary",
+						children: D.sharing ? _("integrations.sharing.title", "Share {{name}}", { name: D.sharing.name }) : _("integrations.sharing.titleLoading", "Share connection")
+					}), /* @__PURE__ */ v(b.Close, {
+						className: "rounded-md p-1 text-text-secondary hover:bg-accent",
+						"aria-label": _("integrations.common.close", "Close"),
+						children: /* @__PURE__ */ v(g, { size: 16 })
+					})]
+				}),
+				/* @__PURE__ */ y("div", {
+					className: "flex-1 space-y-5 overflow-y-auto px-5 py-4",
+					children: [C(D, E, _), D.saveError && /* @__PURE__ */ v("p", {
+						role: "alert",
+						className: "text-sm text-status-error-text",
+						children: D.saveError
+					})]
+				}),
+				/* @__PURE__ */ y("div", {
+					className: "flex justify-end gap-2 border-t border-border-subtle px-5 py-3",
+					children: [/* @__PURE__ */ v("button", {
+						type: "button",
+						onClick: s,
+						className: "rounded-md border border-border-subtle px-4 py-2 text-sm font-medium text-text-primary transition-colors hover:bg-accent",
+						children: _("integrations.common.cancel", "Cancel")
+					}), /* @__PURE__ */ y("button", {
+						type: "button",
+						onClick: () => void A(),
+						disabled: !D.editable || D.saving,
+						className: "inline-flex items-center gap-2 rounded-md bg-action-primary-bg px-4 py-2 text-sm font-medium text-action-primary-text transition-colors hover:bg-action-primary-bg/90 disabled:opacity-50",
+						"data-testid": "share-connection-save",
+						children: [D.saving && /* @__PURE__ */ v(h, {
+							size: 14,
+							className: "animate-spin",
+							"aria-hidden": !0
+						}), _("integrations.sharing.save", "Save")]
+					})]
+				})
+			]
+		})] })
+	});
+};
+//#endregion
+export { x as SHARE_TITLE_ID, w as ShareConnectionDialog };

package/dist/connections/SharePanels.d.ts

@@ -0,0 +1,32 @@
+import { FC } from 'react';
+import { Translator } from '../credentials/translate';
+import { ConnectionShareGrant, ConnectionShareRole, ConnectionSharePrincipalType, ConnectionVisibility, SharePrincipal } from './types';
+export declare const OwnerField: FC<{
+    id: string;
+    ownerId: string;
+    onChange: (ownerId: string) => void;
+    /** Only a workspace admin can hand the connection to someone else. */
+    changeable: boolean;
+    members: SharePrincipal[];
+    ownerLabel: string;
+    translate: Translator;
+}>;
+export declare const PrincipalSearch: FC<{
+    id: string;
+    principals: SharePrincipal[];
+    /** Keys (`TYPE:id`) already granted, or the owner: never offered again. */
+    excluded: ReadonlySet<string>;
+    onAdd: (principal: SharePrincipal) => void;
+    disabled: boolean;
+    translate: Translator;
+}>;
+export declare const GrantList: FC<{
+    idPrefix: string;
+    grants: ConnectionShareGrant[];
+    visibility: ConnectionVisibility;
+    labelOf: (principalType: ConnectionSharePrincipalType, principalId: string) => string;
+    onRole: (index: number, role: ConnectionShareRole) => void;
+    onRemove: (index: number) => void;
+    disabled: boolean;
+    translate: Translator;
+}>;

package/dist/connections/SharePanels.js

@@ -0,0 +1,158 @@
+import { INPUT_CLASS as e } from "./frame.js";
+import { principalKey as t } from "./useConnectionSharingDraft.js";
+import { useState as n } from "react";
+import { Folder as r, Trash2 as i, User as a, Users as o } from "lucide-react";
+import { jsx as s, jsxs as c } from "react/jsx-runtime";
+//#region src/connections/SharePanels.tsx
+var l = 8, u = {
+	USER: a,
+	GROUP: o,
+	PROJECT: r
+};
+function d(e, t) {
+	switch (e) {
+		case "USER": return t("integrations.sharing.type.user", "Person");
+		case "GROUP": return t("integrations.sharing.type.group", "Group");
+		case "PROJECT": return t("integrations.sharing.type.project", "Project");
+	}
+}
+var f = ({ id: t, ownerId: n, onChange: r, changeable: i, members: a, ownerLabel: o, translate: l }) => /* @__PURE__ */ c("div", {
+	className: "space-y-1",
+	children: [/* @__PURE__ */ s("label", {
+		htmlFor: t,
+		className: "block text-sm font-medium text-text-primary",
+		children: l("integrations.sharing.owner", "Owner")
+	}), i ? /* @__PURE__ */ c("select", {
+		id: t,
+		value: n,
+		onChange: (e) => r(e.target.value),
+		className: e,
+		"data-testid": "share-connection-owner",
+		children: [!a.some((e) => e.principalId === n) && /* @__PURE__ */ s("option", {
+			value: n,
+			children: o
+		}), a.map((e) => /* @__PURE__ */ s("option", {
+			value: e.principalId,
+			children: e.label
+		}, e.principalId))]
+	}) : /* @__PURE__ */ s("p", {
+		id: t,
+		className: "text-sm text-text-secondary",
+		children: o
+	})]
+}), p = ({ id: r, principals: i, excluded: a, onAdd: o, disabled: f, translate: p }) => {
+	let [m, h] = n(""), g = m.trim().toLowerCase(), _ = g ? i.filter((e) => !a.has(t(e.principalType, e.principalId)) && `${e.label} ${e.detail ?? ""}`.toLowerCase().includes(g)).slice(0, l) : [];
+	return /* @__PURE__ */ c("div", {
+		className: "space-y-2",
+		children: [
+			/* @__PURE__ */ s("label", {
+				htmlFor: r,
+				className: "block text-sm font-medium text-text-primary",
+				children: p("integrations.sharing.add", "Share with people, groups or projects")
+			}),
+			/* @__PURE__ */ s("input", {
+				id: r,
+				type: "search",
+				value: m,
+				onChange: (e) => h(e.target.value),
+				placeholder: p("integrations.sharing.addPlaceholder", "Search by name or email"),
+				className: e,
+				disabled: f,
+				"data-testid": "share-connection-search"
+			}),
+			_.length > 0 && /* @__PURE__ */ s("ul", {
+				className: "divide-y divide-border-subtle rounded-md border border-border-subtle",
+				children: _.map((e) => {
+					let n = u[e.principalType];
+					return /* @__PURE__ */ s("li", { children: /* @__PURE__ */ c("button", {
+						type: "button",
+						onClick: () => {
+							o(e), h("");
+						},
+						className: "flex w-full items-center gap-2 px-3 py-2 text-left text-sm hover:bg-accent",
+						"data-testid": "share-connection-match",
+						children: [
+							/* @__PURE__ */ s(n, {
+								size: 14,
+								className: "shrink-0 text-text-secondary",
+								"aria-hidden": !0
+							}),
+							/* @__PURE__ */ s("span", {
+								className: "flex-1 truncate text-text-primary",
+								children: e.label
+							}),
+							/* @__PURE__ */ s("span", {
+								className: "text-xs text-text-secondary",
+								children: e.detail ?? d(e.principalType, p)
+							})
+						]
+					}) }, t(e.principalType, e.principalId));
+				})
+			})
+		]
+	});
+}, m = ({ idPrefix: e, grants: n, visibility: r, labelOf: a, onRole: o, onRemove: l, disabled: f, translate: p }) => /* @__PURE__ */ c("div", {
+	className: "space-y-2",
+	children: [/* @__PURE__ */ s("h3", {
+		className: "text-sm font-medium text-text-primary",
+		children: p("integrations.sharing.sharedWith", "Shared with")
+	}), n.length === 0 ? /* @__PURE__ */ s("p", {
+		className: "text-xs text-text-secondary",
+		children: r === "RESTRICTED" ? p("integrations.sharing.onlyOwner", "No one else yet. Only the owner can use it.") : p("integrations.sharing.none", "No one in particular.")
+	}) : /* @__PURE__ */ s("ul", {
+		className: "divide-y divide-border-subtle rounded-md border border-border-subtle",
+		children: n.map((n, r) => {
+			let m = u[n.principalType], h = `${e}-role-${r}`, g = a(n.principalType, n.principalId);
+			return /* @__PURE__ */ c("li", {
+				className: "flex items-center gap-2 px-3 py-2",
+				"data-testid": "share-connection-grant",
+				children: [
+					/* @__PURE__ */ s(m, {
+						size: 14,
+						className: "shrink-0 text-text-secondary",
+						"aria-hidden": !0
+					}),
+					/* @__PURE__ */ c("span", {
+						className: "min-w-0 flex-1",
+						children: [/* @__PURE__ */ s("span", {
+							className: "block truncate text-sm text-text-primary",
+							children: g
+						}), /* @__PURE__ */ s("span", {
+							className: "block text-xs text-text-secondary",
+							children: d(n.principalType, p)
+						})]
+					}),
+					/* @__PURE__ */ s("label", {
+						htmlFor: h,
+						className: "sr-only",
+						children: p("integrations.sharing.roleFor", "Access for {{name}}", { name: g })
+					}),
+					/* @__PURE__ */ c("select", {
+						id: h,
+						value: n.role,
+						onChange: (e) => o(r, e.target.value),
+						disabled: f,
+						className: "rounded-md border border-border-subtle bg-bg-surface px-2 py-1 text-xs",
+						children: [/* @__PURE__ */ s("option", {
+							value: "USE",
+							children: p("integrations.sharing.role.use", "Can use")
+						}), /* @__PURE__ */ s("option", {
+							value: "EDITOR",
+							children: p("integrations.sharing.role.editor", "Can edit")
+						})]
+					}),
+					/* @__PURE__ */ s("button", {
+						type: "button",
+						onClick: () => l(r),
+						disabled: f,
+						className: "rounded-md p-1 text-text-secondary hover:bg-accent disabled:opacity-50",
+						"aria-label": p("integrations.sharing.remove", "Stop sharing with {{name}}", { name: g }),
+						children: /* @__PURE__ */ s(i, { size: 14 })
+					})
+				]
+			}, t(n.principalType, n.principalId));
+		})
+	})]
+});
+//#endregion
+export { m as GrantList, f as OwnerField, p as PrincipalSearch };

package/dist/connections/VisibilityChoice.d.ts

@@ -0,0 +1,12 @@
+import { FC } from 'react';
+import { Translator } from '../credentials/translate';
+import { ConnectionVisibility } from './types';
+export interface VisibilityChoiceProps {
+    value: ConnectionVisibility;
+    onChange: (value: ConnectionVisibility) => void;
+    translate: Translator;
+    /** Prefix for the inputs' ids, unique on the page. */
+    idPrefix: string;
+    disabled?: boolean;
+}
+export declare const VisibilityChoice: FC<VisibilityChoiceProps>;

package/dist/connections/VisibilityChoice.js

@@ -0,0 +1,60 @@
+import { cn as e } from "../lib/utils.js";
+import { Lock as t, Users as n } from "lucide-react";
+import { jsx as r, jsxs as i } from "react/jsx-runtime";
+//#region src/connections/VisibilityChoice.tsx
+var a = ({ value: a, onChange: o, translate: s, idPrefix: c, disabled: l = !1 }) => {
+	let u = [{
+		value: "RESTRICTED",
+		icon: t,
+		title: s("integrations.sharing.visibility.restricted", "Only people I choose"),
+		description: s("integrations.sharing.visibility.restrictedHint", "You, and the people, groups or projects you share it with. Workspace admins can manage it but not use it.")
+	}, {
+		value: "WORKSPACE",
+		icon: n,
+		title: s("integrations.sharing.visibility.workspace", "Everyone in this workspace"),
+		description: s("integrations.sharing.visibility.workspaceHint", "Anyone in the workspace whose role allows it can see it and use it in workflows.")
+	}];
+	return /* @__PURE__ */ i("fieldset", {
+		className: "space-y-2",
+		disabled: l,
+		children: [/* @__PURE__ */ r("legend", {
+			className: "mb-2 text-sm font-medium text-text-primary",
+			children: s("integrations.sharing.visibility.label", "Who can use this connection")
+		}), u.map((t) => {
+			let n = `${c}-visibility-${t.value.toLowerCase()}`, s = t.icon, u = a === t.value;
+			return /* @__PURE__ */ i("label", {
+				htmlFor: n,
+				className: e("flex cursor-pointer items-start gap-3 rounded-md border p-3 transition-colors", u ? "border-primary bg-primary/5" : "border-border-subtle hover:bg-accent/40", l && "cursor-not-allowed opacity-60"),
+				children: [
+					/* @__PURE__ */ r("input", {
+						id: n,
+						type: "radio",
+						name: `${c}-visibility`,
+						value: t.value,
+						checked: u,
+						onChange: () => o(t.value),
+						className: "mt-1",
+						"data-testid": `connection-visibility-${t.value.toLowerCase()}`
+					}),
+					/* @__PURE__ */ r(s, {
+						size: 16,
+						className: "mt-0.5 shrink-0 text-text-secondary",
+						"aria-hidden": !0
+					}),
+					/* @__PURE__ */ i("span", {
+						className: "space-y-0.5",
+						children: [/* @__PURE__ */ r("span", {
+							className: "block text-sm font-medium text-text-primary",
+							children: t.title
+						}), /* @__PURE__ */ r("span", {
+							className: "block text-xs text-text-secondary",
+							children: t.description
+						})]
+					})
+				]
+			}, t.value);
+		})]
+	});
+};
+//#endregion
+export { a as VisibilityChoice };

package/dist/connections/api.d.ts

@@ -1,5 +1,5 @@
 import { ApolloClient } from '@apollo/client';
-import { ConnectionAuthMethod, ConnectionProvider, ProviderAuthType, VaultSecretSummary, VaultSummary } from './types';
+import { ConnectionAuthMethod, ConnectionProvider, ConnectionVisibility, ProviderAuthType, VaultSecretSummary, VaultSummary } from './types';
 /** A connection as the dialog tracks it. */
 export interface ConnectionRecord {
     id: string;
@@ -16,6 +16,8 @@ export interface CreateConnectionInput {
     vaultId?: string;
     credentialSecretId?: string;
     managedSecretName?: string;
+    /** Who can reach the connection; the service defaults to WORKSPACE. */
+    visibility?: ConnectionVisibility;
 }
 /** Everything the dialog asks of the service. Faked in tests. */
 export interface ConnectionsApi {
@@ -56,4 +58,13 @@ export interface ConnectionsApiOptions {
 export declare function normalizeAuthType(value: unknown): ProviderAuthType;
 export declare function mapAuthMethod(raw: unknown): ConnectionAuthMethod;
 export declare function mapProvider(raw: unknown): ConnectionProvider;
+/**
+ * Throw an operation's error. Host clients are configured with
+ * `errorPolicy: 'all'`, so a failed call RESOLVES with the failure in
+ * `result.error`; reading only `data` would swallow the server's message.
+ */
+export declare function unwrap<T>(result: {
+    data?: T | null;
+    error?: unknown;
+}): T | null;
 export declare function createConnectionsApi(client: ApolloClient, options?: ConnectionsApiOptions): ConnectionsApi;

package/dist/connections/api.js

@@ -257,4 +257,4 @@ function D(e, t = {}) {
 	};
 }
 //#endregion
-export { D as createConnectionsApi, w as mapProvider, x as normalizeAuthType };
+export { D as createConnectionsApi, w as mapProvider, x as normalizeAuthType, E as unwrap };

package/dist/connections/connectionFlow.d.ts

@@ -1,7 +1,7 @@
 import { Translator } from '../credentials/translate';
 import { AuthMethodFlow, FormSchema } from '../credentials/types';
 import { ConnectionRecord, ConnectionsApi, CreateConnectionInput } from './api';
-import { ConnectionAuthMethod, ConnectionProvider, CredentialStorageMode, CredentialStorageState, ProviderAuthType } from './types';
+import { ConnectionAuthMethod, ConnectionProvider, CredentialStorageMode, CredentialStorageState, ProviderAuthType, ConnectionVisibility } from './types';
 /** Providers whose methods were never backfilled fall back to their type. */
 export declare function flowForAuthType(authType: ProviderAuthType): AuthMethodFlow;
 /** The methods a user may pick: enabled ones, in display order. */
@@ -43,6 +43,11 @@ export interface ConnectionDraft {
     requireVault: boolean;
     /** Host settings stored on the connection, e.g. a Botlit return path. */
     extraConfig?: Record<string, unknown>;
+    /**
+     * Who can reach the new connection. Left out, the integrations service
+     * makes it visible to the whole workspace.
+     */
+    visibility?: ConnectionVisibility;
 }
 /** The first thing stopping the draft from being submitted, or null. */
 export declare function validateDraft(draft: ConnectionDraft, translate: Translator): string | null;

package/dist/connections/connectionFlow.js

@@ -75,7 +75,7 @@ function _(e) {
 		name: e.name.trim(),
 		providerId: e.provider.id
 	}, c = e.description.trim();
-	if (c && (a.description = c), e.method && (a.authMethodKey = e.method.key), Object.keys(i).length > 0 && (a.config = i), m(t, e.provider)) {
+	if (c && (a.description = c), e.method && (a.authMethodKey = e.method.key), Object.keys(i).length > 0 && (a.config = i), e.visibility && (a.visibility = e.visibility), m(t, e.provider)) {
 		let { storage: t } = e;
 		if (!d(e.provider, e.method).includes(t.mode)) throw Error("This authentication method does not support the selected credential storage mode.");
 		if (t.mode === "existing") {

package/dist/connections/index.d.ts

@@ -9,6 +9,9 @@
 export { ConnectionDialog, type ConnectionDialogProps } from './ConnectionDialog';
 export { CONNECTION_DIALOG_FRAME_CLASSES, type ConnectionDialogPresentation } from './frame';
 export { ProviderIcon, type ProviderIconProps } from './ProviderIcon';
+export { ShareConnectionDialog, SHARE_TITLE_ID, type ShareConnectionDialogProps, } from './ShareConnectionDialog';
+export { VisibilityChoice, type VisibilityChoiceProps } from './VisibilityChoice';
+export { canManageSharing, createConnectionSharingApi, mapConnectionSharing, SHARE_PICKER_LIMIT, type ConnectionSharingApi, type ShareConnectionInput, } from './sharingApi';
 export { CredentialStorageSelector } from './CredentialStorageSelector';
 export { compatibleSecrets, EMPTY_STORAGE } from './storage';
 export { groupByCategory, pickableProviders } from './picker';
@@ -19,5 +22,5 @@ export { waitForOAuthCompletion, isOAuthCallbackMessage } from './oauthPopup';
 export { getProviderAccent, getProviderIconName, getProviderImageSource, getProviderTextIcon, normalizeProviderCategory, type ProviderIdentity, } from './providerIdentity';
 export { isScopeChecked, parseScopeOptions, requestedScopes, toggleScope, type ScopeOption, type ScopeSelection, } from './scopes';
 export { authTypeLabel, categoryLabel } from './labels';
-export type { ConnectionAuthMethod, ConnectionDialogEvent, ConnectionProvider, CreatedConnection, CredentialStorageState, ProviderAuthType, ProviderCategory, VaultSecretSummary, VaultSummary, } from './types';
+export type { ConnectionAccess, ConnectionAuthMethod, ConnectionDialogEvent, ConnectionProvider, ConnectionShareGrant, ConnectionSharePrincipalType, ConnectionShareRole, ConnectionSharing, ConnectionVisibility, CreatedConnection, CredentialStorageState, ProviderAuthType, ProviderCategory, SharePrincipal, VaultSecretSummary, VaultSummary, } from './types';
 export type { Translator } from '../credentials/translate';

package/dist/connections/sharingApi.d.ts

@@ -0,0 +1,28 @@
+import { ApolloClient } from '@apollo/client';
+import { ConnectionAccess, ConnectionShareGrant, ConnectionSharing, ConnectionVisibility, SharePrincipal } from './types';
+/**
+ * Most members, groups and projects the share picker loads of each kind. A
+ * workspace past it can still share with anyone through a group or project.
+ */
+export declare const SHARE_PICKER_LIMIT = 1000;
+/** A connection's sharing from the service's answer; null when it is not one. */
+export declare function mapConnectionSharing(raw: unknown): ConnectionSharing | null;
+/** Whether someone reaching a connection this way may change its sharing. */
+export declare function canManageSharing(access: ConnectionAccess | null): boolean;
+export interface ShareConnectionInput {
+    connectionId: string;
+    visibility: ConnectionVisibility;
+    shares: ConnectionShareGrant[];
+    /**
+     * Hand the connection to this person in the same change, so the new owner
+     * and the new sharing apply together or not at all. Workspace admins only.
+     */
+    ownerId?: string;
+}
+export interface ConnectionSharingApi {
+    getSharing(connectionId: string): Promise<ConnectionSharing>;
+    /** Members, groups and projects of the workspace. A kind the person may not list is left empty. */
+    listPrincipals(workspaceId: string): Promise<SharePrincipal[]>;
+    share(input: ShareConnectionInput): Promise<ConnectionSharing>;
+}
+export declare function createConnectionSharingApi(client: ApolloClient): ConnectionSharingApi;