@opengeni/react 2.5.0-canary.1 → 3.0.0-canary.0

package/README.md

@@ -135,6 +135,21 @@ can therefore implement only the methods used by each hook. A shared event feed
 also avoids requiring a client-owned event stream at runtime. Workspace-level
 Resume is an optional authority.
 
+Use `createEmbeddedSessionClient(base, options)` to bind that narrow surface
+from a full SDK client or host proxy. Delegated methods preserve their SDK
+receiver, `options.overrides.submitComposerDraft` can route atomic submission
+through a host-authenticated endpoint, and `mapComposerDraft` can project every
+read/save/submit draft before React adopts it. Construction fails immediately
+when a required method is missing, and submit returns the host/native
+`SubmitComposerDraftResponse` unchanged apart from an explicitly configured
+draft projection.
+
+The styled file surfaces accept a presentation-only node predicate:
+`FileBrowser.isNodeVisible`, `SandboxFiles.isNodeVisible`, and
+`SandboxWorkspace.isFileNodeVisible`. Hidden parents never expose orphaned
+children, hidden selections/reveal requests are ignored, and omitting the prop
+preserves the complete authoritative tree. This is not an authorization seam.
+
 The styled root surface ships with ready-to-use CSS. Import it once; the host
 does not need Tailwind:
 

package/dist/accounts.d.ts

@@ -0,0 +1,64 @@
+import type { BrowserAccountsClientLike, ManagedAuthDeepLinkResolution, ManagedAuthLoginTransaction, ManagedAuthSessionSetProjection } from "@opengeni/sdk/accounts";
+import { type ReactNode } from "react";
+export type BrowserAccountTransitionPhase = "preflight" | "blocked" | "committing" | "loading" | "ready" | "recoverable_error";
+export type BrowserAccountTransitionKind = "add" | "select" | "logout_one" | "logout_all" | "reauth" | "cross_tab";
+export type BrowserAccountTransitionBlocker = {
+    id: string;
+    label: string;
+    detail?: string | undefined;
+};
+export type BrowserAccountTransition = {
+    kind: BrowserAccountTransitionKind;
+    from: ManagedAuthSessionSetProjection | null;
+    to: ManagedAuthSessionSetProjection | null;
+    signal: AbortSignal;
+};
+export type BrowserAccountsProviderProps = {
+    client: BrowserAccountsClientLike;
+    /**
+     * Hide the authenticated tree, abort old actor work, clear tenant-bound
+     * state, recreate credentials/clients, and refetch principal access here.
+     * Cross-tab/server invalidation first calls this with `to: null` as a
+     * neutral fence before authority is reread, then calls it with the accepted
+     * projection after the new actor is known.
+     */
+    onActorTransition: (transition: BrowserAccountTransition) => Promise<void>;
+    children?: ReactNode;
+    broadcastChannelName?: string | null | undefined;
+    /** Adopt the already-authenticated legacy provider session during dual-mode rollout. */
+    bootstrapLegacySession?: boolean | undefined;
+};
+type BlockerInspector = () => BrowserAccountTransitionBlocker | null;
+export type BrowserAccountsContextValue = {
+    projection: ManagedAuthSessionSetProjection | null;
+    phase: BrowserAccountTransitionPhase;
+    blockers: BrowserAccountTransitionBlocker[];
+    error: Error | null;
+    transaction: ManagedAuthLoginTransaction | null;
+    hasPendingTransition: boolean;
+    refresh: () => Promise<ManagedAuthSessionSetProjection | null>;
+    invalidateActor: () => Promise<ManagedAuthSessionSetProjection | null>;
+    registerTransitionBlocker: (id: string, inspect: BlockerInspector) => () => void;
+    continueTransition: () => Promise<boolean>;
+    cancelPendingTransition: () => void;
+    beginAdd: (returnIntent?: string | undefined) => Promise<ManagedAuthLoginTransaction>;
+    beginReauth: (slotId: string, returnIntent?: string | undefined) => Promise<ManagedAuthLoginTransaction>;
+    completeEmailPassword: (input: {
+        email: string;
+        password: string;
+    }) => Promise<boolean>;
+    settleExternalLoginTransaction: (transactionId: string) => Promise<boolean>;
+    cancelLoginTransaction: () => Promise<void>;
+    selectSlot: (slotId: string) => Promise<boolean>;
+    logoutSlot: (slotId: string, replacementSlotId: string | null) => Promise<boolean>;
+    logoutAll: () => Promise<boolean>;
+    resolveDeepLink: (path: string) => Promise<ManagedAuthDeepLinkResolution>;
+};
+export declare function BrowserAccountsProvider({ client, onActorTransition, children, broadcastChannelName, bootstrapLegacySession, }: BrowserAccountsProviderProps): import("react").JSX.Element;
+export declare function useBrowserAccounts(): BrowserAccountsContextValue;
+/** Read the optional controller without requiring non-legacy hosts to mount it. */
+export declare function useOptionalBrowserAccounts(): BrowserAccountsContextValue | null;
+export declare function useBrowserAccountTransitionBlocker(id: string, inspect: BlockerInspector): void;
+/** No-op on legacy hosts that do not mount the optional accounts provider. */
+export declare function useOptionalBrowserAccountTransitionBlocker(id: string, inspect: BlockerInspector): void;
+export {};