@streamoid/settings 0.6.4 → 0.6.5

package/README.md

@@ -175,3 +175,43 @@ owns routing; apps without organization settings omit the callback.
 The adapter prefers `organizationName` from the authorized workspace response.
 This lets invited workspace members see its owner without organization membership;
 the separately checked organization role still controls settings navigation.
+
+API Keys navigation and controls are visible only to the selected workspace's
+Admins. When the host supplies only a workspace id, its role is resolved from
+the authorized workspace list. Other roles opening the route see an Admin-only
+message. The page links to https://docs.streamoid.com.
+
+Billing and API Keys are grouped under Workspace and restricted to workspace
+Admins in the menu and direct settings routes. Other members see a contact-admin
+explanation and a link to workspace members; billing content is not mounted.
+API documentation lives in an integration help card above the keys list.
+
+Hosts should provide `workspace.organizationRequest` using the same authenticated
+transport as their workspace popup. Workspace General and Members then display
+the selected workspace owner independently of account organization membership.
+Unknown or failed lookups are never labeled as an unowned workspace.
+
+Hosts that delegate organization management to CXO can set
+`organization.managementUrl` together with `workspace.organizationRequest`.
+Settings then shows the selected workspace's owning organization and the
+independently resolved organization role, rather than treating a null local
+organization adapter as proof that the user has no membership. Management opens
+in the central dashboard; an unavailable role never implies membership.
+The settings navigation separates the Account heading from its Profile action.
+Workspace identity remains in the main sidebar and the page breadcrumb.
+
+My workspaces belongs to Account: it lists the signed-in user’s workspace memberships. Organization → Workspaces remains scoped to the organization. The existing `workspace/all` route is retained for bookmark compatibility.
+
+Member lists use compact rows with a shared column grid, a short count summary,
+and embedded app favicon artwork in Access. App badges describe tool access;
+invite and credit permissions have separate Yes/No columns. Billing uses compact
+summary cards and usage-log rows while preserving all amounts and actions.
+
+### Shared settings appearance
+
+`SettingsContent` mounts a route-scoped appearance layer. While settings is
+visible, it normalizes the root rem scale to 16px, uses a 14px system-font body,
+and shares light/dark canvas, card, text, divider and selection colors with the
+host sidebar. Removing settings restores the host theme. Host wrappers must
+remain transparent and use `--alias-surface-canvas` for the app floor; do not
+paint `--alias-surface-base` behind the whole settings page.

package/dist/index.d.mts

@@ -1,6 +1,22 @@
 import * as react from 'react';
 import react__default, { SVGProps, ReactNode } from 'react';
-import { WorkspaceUsage, ScWorkspaceAccountMenuProps } from '@streamoid/ui';
+import { ScWorkspaceAccountMenuProps, WorkspaceUsage } from '@streamoid/ui';
+
+/** Host transport: authenticated GET returning the unified API envelope. */
+type WorkspaceOrganizationRequest = (path: string, signal: AbortSignal) => Promise<unknown>;
+interface WorkspaceOrganization {
+    _id: string;
+    name: string;
+    role?: string;
+}
+/** Resolve only the selected workspace's owner, never a user's first org. */
+declare function loadWorkspaceOrganization(workspaceId: string, request: WorkspaceOrganizationRequest, signal: AbortSignal): Promise<WorkspaceOrganization | null>;
+declare function useWorkspaceOrganization({ workspaceId, request, enabled, onOpenOrganization, }: {
+    workspaceId?: string | null;
+    request: WorkspaceOrganizationRequest;
+    enabled?: boolean;
+    onOpenOrganization?: (organizationId: string) => void;
+}): Pick<ScWorkspaceAccountMenuProps, "organizationName" | "organizationRole" | "organizationStatus" | "onOrganizationClick">;
 
 /**
  * Settings tab identifiers and URL mapping helpers.
@@ -26,7 +42,7 @@ type SettingsTab = "profile"
  | "workspace"
 /** Workspace › Members — was the top-level "Team" tab. */
  | "workspaceMembers"
-/** Workspace › All workspaces — the switch/create list. */
+/** Account › My workspaces — the memberships and switch/create list. */
  | "workspaceList"
 /** Organization › People. */
  | "organization"
@@ -73,26 +89,6 @@ declare const TAB_DESCRIPTIONS: Record<SettingsTab, string>;
  */
 declare function resolveSettingsTabFromPath(path: string): SettingsTab;
 
-/**
- * Adapter contracts for @streamoid/settings.
- *
- * The host application (cxo-dashboard, photogenix, etc.) implements one
- * `SettingsAdapters` object and passes it into <SettingsContent>. Every
- * sub-component in this package reads from `useSettingsAdapters()` instead of
- * importing the host's auth/workspace/services/router/toast directly.
- *
- * Design notes:
- * - State that the host already owns reactively (current user, current
- *   workspace) is *embedded* in the adapter object. The host re-creates the
- *   adapter object (or its inner objects) when its state changes; React's
- *   normal render-on-prop-change semantics flow that change into the package.
- * - Lists that the package fetches on demand (workspace list, members,
- *   invoices, tokens) are exposed as async functions. The package owns the
- *   `loading`/`data` state internally and re-fetches after mutations.
- * - Mutations don't return anything the package depends on; the convention is
- *   "fire the mutation, then refetch". Errors throw.
- */
-
 interface SettingsAuthUser {
     id: string;
     email: string;
@@ -180,6 +176,8 @@ interface SettingsWorkspaceListItem {
     ownerEmail?: string;
 }
 interface SettingsWorkspaceAdapter {
+    /** Same authenticated transport used by the sidebar owner lookup. */
+    organizationRequest?: WorkspaceOrganizationRequest;
     current: SettingsWorkspaceCurrent | null;
     list: () => Promise<SettingsWorkspaceListItem[]>;
     /**
@@ -348,6 +346,8 @@ interface OrganizationDomainMatch {
  * mutations are fire-then-refetch and throw on failure.
  */
 interface SettingsOrganizationAdapter {
+    /** Host delegates organization management to the central dashboard. */
+    managementUrl?: string;
     current: SettingsOrganizationCurrent | null;
     list: () => Promise<SettingsOrganizationListItem[]>;
     create: (input: {
@@ -995,12 +995,13 @@ interface WorkspaceGeneralTabProps {
     memberCount?: number | null;
     /** Name of the parent organization, when the workspace has joined one. */
     organizationName?: string | null;
+    organizationStatus?: "loading" | "error";
     saving: boolean;
     onSave: (name: string, imageFile: File | null, imageRemoved: boolean) => Promise<boolean>;
     onLeave: () => void;
     onDelete: () => void;
 }
-declare function WorkspaceGeneralTab({ workspace, loading, memberCount, organizationName, saving, onSave, onLeave, onDelete, }: WorkspaceGeneralTabProps): react.JSX.Element;
+declare function WorkspaceGeneralTab({ workspace, loading, memberCount, organizationName, organizationStatus, saving, onSave, onLeave, onDelete, }: WorkspaceGeneralTabProps): react.JSX.Element;
 
 type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width' | 'height'> & {
     color?: string;
@@ -1394,20 +1395,4 @@ declare function SettingsAdaptersProvider({ adapters, children, }: {
  */
 declare function useSettingsAdapters(): SettingsAdapters;
 
-/** Host transport: authenticated GET returning the unified API envelope. */
-type WorkspaceOrganizationRequest = (path: string, signal: AbortSignal) => Promise<unknown>;
-interface WorkspaceOrganization {
-    _id: string;
-    name: string;
-    role?: string;
-}
-/** Resolve only the selected workspace's owner, never a user's first org. */
-declare function loadWorkspaceOrganization(workspaceId: string, request: WorkspaceOrganizationRequest, signal: AbortSignal): Promise<WorkspaceOrganization | null>;
-declare function useWorkspaceOrganization({ workspaceId, request, enabled, onOpenOrganization, }: {
-    workspaceId?: string | null;
-    request: WorkspaceOrganizationRequest;
-    enabled?: boolean;
-    onOpenOrganization?: (organizationId: string) => void;
-}): Pick<ScWorkspaceAccountMenuProps, "organizationName" | "organizationRole" | "organizationStatus" | "onOrganizationClick">;
-
 export { APP_KEYS, type ApiToken, type AppKey, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, OrganizationInviteModal, type OrganizationInviteModalProps, type OrganizationJoinRequest, type OrganizationMember, OrganizationModal, type OrganizationView, type OrganizationWorkspaceItem, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCurrent, type SettingsOrganizationListItem, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_DESCRIPTIONS, TAB_LABELS, TAB_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USER_LANGUAGES, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspaceTab, type WorkspaceUsageResponse, countLabel, loadWorkspaceOrganization, resolveSettingsTabFromPath, useSettingsAdapters, useWorkspaceOrganization, userLanguageLabel };

package/dist/index.d.ts

@@ -1,6 +1,22 @@
 import * as react from 'react';
 import react__default, { SVGProps, ReactNode } from 'react';
-import { WorkspaceUsage, ScWorkspaceAccountMenuProps } from '@streamoid/ui';
+import { ScWorkspaceAccountMenuProps, WorkspaceUsage } from '@streamoid/ui';
+
+/** Host transport: authenticated GET returning the unified API envelope. */
+type WorkspaceOrganizationRequest = (path: string, signal: AbortSignal) => Promise<unknown>;
+interface WorkspaceOrganization {
+    _id: string;
+    name: string;
+    role?: string;
+}
+/** Resolve only the selected workspace's owner, never a user's first org. */
+declare function loadWorkspaceOrganization(workspaceId: string, request: WorkspaceOrganizationRequest, signal: AbortSignal): Promise<WorkspaceOrganization | null>;
+declare function useWorkspaceOrganization({ workspaceId, request, enabled, onOpenOrganization, }: {
+    workspaceId?: string | null;
+    request: WorkspaceOrganizationRequest;
+    enabled?: boolean;
+    onOpenOrganization?: (organizationId: string) => void;
+}): Pick<ScWorkspaceAccountMenuProps, "organizationName" | "organizationRole" | "organizationStatus" | "onOrganizationClick">;
 
 /**
  * Settings tab identifiers and URL mapping helpers.
@@ -26,7 +42,7 @@ type SettingsTab = "profile"
  | "workspace"
 /** Workspace › Members — was the top-level "Team" tab. */
  | "workspaceMembers"
-/** Workspace › All workspaces — the switch/create list. */
+/** Account › My workspaces — the memberships and switch/create list. */
  | "workspaceList"
 /** Organization › People. */
  | "organization"
@@ -73,26 +89,6 @@ declare const TAB_DESCRIPTIONS: Record<SettingsTab, string>;
  */
 declare function resolveSettingsTabFromPath(path: string): SettingsTab;
 
-/**
- * Adapter contracts for @streamoid/settings.
- *
- * The host application (cxo-dashboard, photogenix, etc.) implements one
- * `SettingsAdapters` object and passes it into <SettingsContent>. Every
- * sub-component in this package reads from `useSettingsAdapters()` instead of
- * importing the host's auth/workspace/services/router/toast directly.
- *
- * Design notes:
- * - State that the host already owns reactively (current user, current
- *   workspace) is *embedded* in the adapter object. The host re-creates the
- *   adapter object (or its inner objects) when its state changes; React's
- *   normal render-on-prop-change semantics flow that change into the package.
- * - Lists that the package fetches on demand (workspace list, members,
- *   invoices, tokens) are exposed as async functions. The package owns the
- *   `loading`/`data` state internally and re-fetches after mutations.
- * - Mutations don't return anything the package depends on; the convention is
- *   "fire the mutation, then refetch". Errors throw.
- */
-
 interface SettingsAuthUser {
     id: string;
     email: string;
@@ -180,6 +176,8 @@ interface SettingsWorkspaceListItem {
     ownerEmail?: string;
 }
 interface SettingsWorkspaceAdapter {
+    /** Same authenticated transport used by the sidebar owner lookup. */
+    organizationRequest?: WorkspaceOrganizationRequest;
     current: SettingsWorkspaceCurrent | null;
     list: () => Promise<SettingsWorkspaceListItem[]>;
     /**
@@ -348,6 +346,8 @@ interface OrganizationDomainMatch {
  * mutations are fire-then-refetch and throw on failure.
  */
 interface SettingsOrganizationAdapter {
+    /** Host delegates organization management to the central dashboard. */
+    managementUrl?: string;
     current: SettingsOrganizationCurrent | null;
     list: () => Promise<SettingsOrganizationListItem[]>;
     create: (input: {
@@ -995,12 +995,13 @@ interface WorkspaceGeneralTabProps {
     memberCount?: number | null;
     /** Name of the parent organization, when the workspace has joined one. */
     organizationName?: string | null;
+    organizationStatus?: "loading" | "error";
     saving: boolean;
     onSave: (name: string, imageFile: File | null, imageRemoved: boolean) => Promise<boolean>;
     onLeave: () => void;
     onDelete: () => void;
 }
-declare function WorkspaceGeneralTab({ workspace, loading, memberCount, organizationName, saving, onSave, onLeave, onDelete, }: WorkspaceGeneralTabProps): react.JSX.Element;
+declare function WorkspaceGeneralTab({ workspace, loading, memberCount, organizationName, organizationStatus, saving, onSave, onLeave, onDelete, }: WorkspaceGeneralTabProps): react.JSX.Element;
 
 type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width' | 'height'> & {
     color?: string;
@@ -1394,20 +1395,4 @@ declare function SettingsAdaptersProvider({ adapters, children, }: {
  */
 declare function useSettingsAdapters(): SettingsAdapters;
 
-/** Host transport: authenticated GET returning the unified API envelope. */
-type WorkspaceOrganizationRequest = (path: string, signal: AbortSignal) => Promise<unknown>;
-interface WorkspaceOrganization {
-    _id: string;
-    name: string;
-    role?: string;
-}
-/** Resolve only the selected workspace's owner, never a user's first org. */
-declare function loadWorkspaceOrganization(workspaceId: string, request: WorkspaceOrganizationRequest, signal: AbortSignal): Promise<WorkspaceOrganization | null>;
-declare function useWorkspaceOrganization({ workspaceId, request, enabled, onOpenOrganization, }: {
-    workspaceId?: string | null;
-    request: WorkspaceOrganizationRequest;
-    enabled?: boolean;
-    onOpenOrganization?: (organizationId: string) => void;
-}): Pick<ScWorkspaceAccountMenuProps, "organizationName" | "organizationRole" | "organizationStatus" | "onOrganizationClick">;
-
 export { APP_KEYS, type ApiToken, type AppKey, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type CreatedToken, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationInvite, OrganizationInviteModal, type OrganizationInviteModalProps, type OrganizationJoinRequest, type OrganizationMember, OrganizationModal, type OrganizationView, type OrganizationWorkspaceItem, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, ReferralTab, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCurrent, type SettingsOrganizationListItem, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_DESCRIPTIONS, TAB_LABELS, TAB_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USER_LANGUAGES, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspaceTab, type WorkspaceUsageResponse, countLabel, loadWorkspaceOrganization, resolveSettingsTabFromPath, useSettingsAdapters, useWorkspaceOrganization, userLanguageLabel };