@streamoid/settings 0.13.0 → 0.14.0

package/dist/index.d.mts

@@ -705,8 +705,28 @@ interface BillingSubscription {
     /** Stripe product id; used to look up the matching product in fetched plans. */
     stripeProductId?: string;
 }
+/**
+ * Whether the workspace gets paid features, and why: `plan` (its own paid
+ * plan) or `pool` (it spends a sponsor's shared credits, on its free plan).
+ * The plan and billing actions are unchanged by it; see `./entitlement`.
+ */
+interface BillingEntitlement {
+    paid: boolean;
+    source: "plan" | "pool" | null;
+    /** The sponsor's workspace id, for `pool`. */
+    sponsorWorkspaceId?: string;
+    sponsorName?: string;
+    /** When the sharing ends (ISO); null or absent when it runs until removed. */
+    endsAt?: string | null;
+}
 interface SubscriptionResponse {
     data: BillingSubscription | null;
+    /**
+     * Billing's top-level `entitlement` (beside `data`), passed through.
+     * Absent on servers from before it, and from hosts that drop it: then the
+     * plan alone decides, as before.
+     */
+    entitlement?: BillingEntitlement | null;
 }
 interface PriceMetadata {
     name: string;
@@ -965,7 +985,10 @@ interface SettingsApiAdapter {
     fetchPlans: () => Promise<ProductsResponse>;
     /**
      * Current active subscription. Returns `{ data: null }` when the workspace
-     * has no plan yet (free tier).
+     * has no plan yet (free tier). Pass billing's top-level `entitlement`
+     * through as `entitlement`. For billing's 404 (no subscription) that carries
+     * one, resolve `{ data: null, entitlement }`, or throw an error that keeps
+     * the response body (`body`, `data` or `response.data`).
      */
     fetchCurrentPlan: () => Promise<SubscriptionResponse>;
     /** Available credit balance for the active workspace. */
@@ -1424,7 +1447,7 @@ type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width'
 };
 declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react.JSX.Element;
 
-declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, showPerUserLimits: showPerUserLimitsProp, onShowPerUserLimitsChange, showSharedCredits: showSharedCreditsProp, onShowSharedCreditsChange, }?: {
+declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, showPerUserLimits: showPerUserLimitsProp, onShowPerUserLimitsChange, showSharedCredits: showSharedCreditsProp, onShowSharedCreditsChange, onEntitlementChange, }?: {
     embedded?: boolean;
     /** Controlled "plans" sub-view flag. When provided, the host (settings
      *  wrapper) owns it so it can hide the sub-nav + show the Plans breadcrumb. */
@@ -1439,6 +1462,14 @@ declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlan
      *  workspace is in an organization. */
     showSharedCredits?: boolean;
     onShowSharedCreditsChange?: (open: boolean) => void;
+    /** Called once the current plan has loaded, and again when it changes:
+     *  billing's `entitlement` (null from servers without it) and whether the
+     *  workspace gets paid features. A workspace spending a sponsor's shared
+     *  credits is `paid` on its free plan; gate features on this, not the plan. */
+    onEntitlementChange?: (state: {
+        entitlement: BillingEntitlement | null;
+        paid: boolean;
+    }) => void;
 }): react__default.JSX.Element;
 
 /**
@@ -2204,6 +2235,78 @@ declare function poolErrorMessage(failure: unknown): string | null;
  */
 declare function SharedCreditsView(): react.JSX.Element;
 
+/**
+ * Whether a workspace gets paid features, and why. Billing reports it at the
+ * top level of the current-subscription answer, beside `data` (200:
+ * `{ success, data, entitlement }`; 404: `{ error, entitlement }`), and
+ * leaves the plan as it is: a workspace spending another's shared credits (a
+ * "sponsored" workspace) still shows the free plan, with
+ * `entitlement.source: 'pool'`.
+ *
+ * So the plan — and every billing action: Upgrade, Cancel downgrade, Buy
+ * credits — stays decided by the plan's amount, and only features are gated
+ * on `entitlement.paid`. Billing servers from before entitlement send none;
+ * then a workspace is paid exactly when its plan is, as before.
+ */
+/** `entitlement` as billing sends it, or null when it is absent or malformed. */
+declare function parseBillingEntitlement(value: unknown): BillingEntitlement | null;
+/**
+ * The `entitlement` of a current-subscription answer: `body.entitlement`,
+ * never `body.data.entitlement` (`data` is the subscription).
+ */
+declare function entitlementFromBody(body: unknown): BillingEntitlement | null;
+/**
+ * The entitlement a failed read carries: billing's 404 for a workspace with
+ * no subscription of its own still says whether a pool entitles it. The body
+ * is looked for where hosts keep it — the failure itself, `body`, `data`
+ * (`UserFacingError`), `response.data` (axios) and `cause` — to a shallow
+ * depth. Null when there is none.
+ */
+declare function entitlementFromFailure(failure: unknown): BillingEntitlement | null;
+/** Paid by the workspace's own plan: what Buy credits and the plan actions go by. */
+declare function isPaidPlan(subscription: Pick<BillingSubscription, "plan"> | null | undefined): boolean;
+/**
+ * Whether the workspace gets paid features: `entitlement.paid` when billing
+ * sent one, else its own plan being paid (servers from before entitlement).
+ */
+declare function hasPaidFeatures({ entitlement, subscription, }: {
+    entitlement: BillingEntitlement | null | undefined;
+    subscription: Pick<BillingSubscription, "plan"> | null | undefined;
+}): boolean;
+/** A workspace spending another's shared credits, by its entitlement. */
+declare function isSponsoredEntitlement(entitlement: BillingEntitlement | null | undefined): entitlement is BillingEntitlement & {
+    source: "pool";
+};
+/** "Credits shared by Agency." plus " Sharing ends on Mar 1, 2027." when it ends on its own. */
+declare function sponsoredCreditsText(entitlement: Pick<BillingEntitlement, "sponsorName" | "endsAt">): string;
+interface CurrentPlanState {
+    /** The workspace's own subscription; null without one. */
+    subscription: BillingSubscription | null;
+    /** Null when billing sent none (servers from before entitlement). */
+    entitlement: BillingEntitlement | null;
+    /** Gate features on this; see `hasPaidFeatures`. */
+    paid: boolean;
+}
+/**
+ * Read the current plan and its entitlement through the host's
+ * `fetchCurrentPlan`. A failure that carries an entitlement — billing's 404
+ * for a sponsored workspace with no subscription of its own — is not an
+ * error: it answers no subscription with that entitlement. Any other failure
+ * is thrown, as before.
+ */
+declare function loadCurrentPlan(fetchCurrentPlan: () => Promise<SubscriptionResponse>): Promise<CurrentPlanState>;
+
+/**
+ * `loadCurrentPlan` as a hook, for a host gating features on `paid`. Reloads
+ * when `key` (e.g. the workspace id) changes; `fetchCurrentPlan` may be a new
+ * function every render. `state` is null while loading, after a failure, and
+ * while `key` is null.
+ */
+declare function useBillingEntitlement(fetchCurrentPlan: (() => Promise<SubscriptionResponse>) | null | undefined, key: string | null | undefined): {
+    state: CurrentPlanState | null;
+    loading: boolean;
+};
+
 type CreditPoolMemberModalProps = {
     kind: "add";
     /** Workspaces credits can be shared with. */
@@ -2331,4 +2434,4 @@ interface AppSettingsRowProps {
 }
 declare function AppSettingsRow({ title, description, summary, href, onClick, disabled, disabledReason, ariaLabel, trailing }: AppSettingsRowProps): react.JSX.Element;
 
-export { APP_KEYS, type AddCreditPoolMemberInput, AdministrationOverview, type AdministrationOverviewProps, type AdministrativeNavigationOptions, type ApiToken, type AppKey, AppSettingsHeader, type AppSettingsHeaderProps, AppSettingsPage, type AppSettingsPageProps, AppSettingsRow, type AppSettingsRowProps, AppSettingsSection, type AppSettingsSectionProps, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type ConnectedApp, ConnectedAppsContent, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CreditPoolCandidate, type CreditPoolFormerMember, type CreditPoolMember, CreditPoolMemberModal, type CreditPoolMemberModalProps, type CreditPoolMemberStatus, type CreditPoolMode, type CreditPoolResponse, type CreditsMeter, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationDetails, OrganizationIntegrationsContent, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, type OrganizationMemberRole, OrganizationModal, OrganizationPicker, type OrganizationPickerItem, type OrganizationPickerProps, type OrganizationPickerType, type OrganizationView, type OrganizationWorkspaceItem, POOL_ERROR_CODES, POOL_EXPIRY_MAX_MONTHS, POOL_NOTE_MAX_LENGTH, PerUserLimitsView, type PoolEndsAtResult, type PoolErrorCode, type PoolExpiryChoice, type PoolValueValidation, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, REMOVE_REASON_MAX_LENGTH, ReferralTab, RemovePoolMemberModal, type RemovePoolMemberModalProps, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsIntegrationsAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCreateOptions, type SettingsOrganizationCurrent, type SettingsOrganizationJoinableItem, type SettingsOrganizationListItem, type SettingsOrganizationType, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SharedCreditsView, type SharedPoolBalance, 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 UpdateCreditPoolMemberInput, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerGroup, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, canShowSharedCredits, cleanCreditLimitInput, cleanPoolValueInput, countLabel, creditCycleUnit, creditsMeter, deriveWorkspaceInvitePermission, describeAllowance, describeDefaultLimit, describeMemberLimit, expiryChoiceFor, findBillingError, findPoolError, formatCreditLimit, formatCredits, formatPoolEndsAt, formatPoolSplit, groupWorkspaceList, isLimitBelowUsage, joinMembersWithLimits, lastUsedLabel, limitBelowUsageUsed, limitSourceLabel, loadWorkspaceOrganization, memberRoleUpdate, minPoolEndDate, minimumCreditLimit, ownCreditsFirstText, pausedOwnCreditsText, poolEndsAtFrom, poolErrorMessage, poolRenewsAtCycleEnd, poolWorkspaceName, readSettingsCaller, rememberSettingsCaller, resolveSettingsTabFromPath, roundCredits, settingsReturnTarget, sharedPoolBannerText, sharedPoolEndsText, toLocalDateInput, useSettingsAdapters, useWorkspaceInvitePermission, useWorkspaceOrganization, usedByNamesFrom, usedByWorkspaceKey, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput, validatePoolText, validatePoolValue };
+export { APP_KEYS, type AddCreditPoolMemberInput, AdministrationOverview, type AdministrationOverviewProps, type AdministrativeNavigationOptions, type ApiToken, type AppKey, AppSettingsHeader, type AppSettingsHeaderProps, AppSettingsPage, type AppSettingsPageProps, AppSettingsRow, type AppSettingsRowProps, AppSettingsSection, type AppSettingsSectionProps, type AvailableCreditsResponse, BillingContent, type BillingEntitlement, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type ConnectedApp, ConnectedAppsContent, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CreditPoolCandidate, type CreditPoolFormerMember, type CreditPoolMember, CreditPoolMemberModal, type CreditPoolMemberModalProps, type CreditPoolMemberStatus, type CreditPoolMode, type CreditPoolResponse, type CreditsMeter, type CurrentPlanState, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationDetails, OrganizationIntegrationsContent, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, type OrganizationMemberRole, OrganizationModal, OrganizationPicker, type OrganizationPickerItem, type OrganizationPickerProps, type OrganizationPickerType, type OrganizationView, type OrganizationWorkspaceItem, POOL_ERROR_CODES, POOL_EXPIRY_MAX_MONTHS, POOL_NOTE_MAX_LENGTH, PerUserLimitsView, type PoolEndsAtResult, type PoolErrorCode, type PoolExpiryChoice, type PoolValueValidation, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, REMOVE_REASON_MAX_LENGTH, ReferralTab, RemovePoolMemberModal, type RemovePoolMemberModalProps, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsIntegrationsAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCreateOptions, type SettingsOrganizationCurrent, type SettingsOrganizationJoinableItem, type SettingsOrganizationListItem, type SettingsOrganizationType, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SharedCreditsView, type SharedPoolBalance, 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 UpdateCreditPoolMemberInput, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerGroup, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, canShowSharedCredits, cleanCreditLimitInput, cleanPoolValueInput, countLabel, creditCycleUnit, creditsMeter, deriveWorkspaceInvitePermission, describeAllowance, describeDefaultLimit, describeMemberLimit, entitlementFromBody, entitlementFromFailure, expiryChoiceFor, findBillingError, findPoolError, formatCreditLimit, formatCredits, formatPoolEndsAt, formatPoolSplit, groupWorkspaceList, hasPaidFeatures, isLimitBelowUsage, isPaidPlan, isSponsoredEntitlement, joinMembersWithLimits, lastUsedLabel, limitBelowUsageUsed, limitSourceLabel, loadCurrentPlan, loadWorkspaceOrganization, memberRoleUpdate, minPoolEndDate, minimumCreditLimit, ownCreditsFirstText, parseBillingEntitlement, pausedOwnCreditsText, poolEndsAtFrom, poolErrorMessage, poolRenewsAtCycleEnd, poolWorkspaceName, readSettingsCaller, rememberSettingsCaller, resolveSettingsTabFromPath, roundCredits, settingsReturnTarget, sharedPoolBannerText, sharedPoolEndsText, sponsoredCreditsText, toLocalDateInput, useBillingEntitlement, useSettingsAdapters, useWorkspaceInvitePermission, useWorkspaceOrganization, usedByNamesFrom, usedByWorkspaceKey, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput, validatePoolText, validatePoolValue };

package/dist/index.d.ts

@@ -705,8 +705,28 @@ interface BillingSubscription {
     /** Stripe product id; used to look up the matching product in fetched plans. */
     stripeProductId?: string;
 }
+/**
+ * Whether the workspace gets paid features, and why: `plan` (its own paid
+ * plan) or `pool` (it spends a sponsor's shared credits, on its free plan).
+ * The plan and billing actions are unchanged by it; see `./entitlement`.
+ */
+interface BillingEntitlement {
+    paid: boolean;
+    source: "plan" | "pool" | null;
+    /** The sponsor's workspace id, for `pool`. */
+    sponsorWorkspaceId?: string;
+    sponsorName?: string;
+    /** When the sharing ends (ISO); null or absent when it runs until removed. */
+    endsAt?: string | null;
+}
 interface SubscriptionResponse {
     data: BillingSubscription | null;
+    /**
+     * Billing's top-level `entitlement` (beside `data`), passed through.
+     * Absent on servers from before it, and from hosts that drop it: then the
+     * plan alone decides, as before.
+     */
+    entitlement?: BillingEntitlement | null;
 }
 interface PriceMetadata {
     name: string;
@@ -965,7 +985,10 @@ interface SettingsApiAdapter {
     fetchPlans: () => Promise<ProductsResponse>;
     /**
      * Current active subscription. Returns `{ data: null }` when the workspace
-     * has no plan yet (free tier).
+     * has no plan yet (free tier). Pass billing's top-level `entitlement`
+     * through as `entitlement`. For billing's 404 (no subscription) that carries
+     * one, resolve `{ data: null, entitlement }`, or throw an error that keeps
+     * the response body (`body`, `data` or `response.data`).
      */
     fetchCurrentPlan: () => Promise<SubscriptionResponse>;
     /** Available credit balance for the active workspace. */
@@ -1424,7 +1447,7 @@ type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width'
 };
 declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react.JSX.Element;
 
-declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, showPerUserLimits: showPerUserLimitsProp, onShowPerUserLimitsChange, showSharedCredits: showSharedCreditsProp, onShowSharedCreditsChange, }?: {
+declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, showPerUserLimits: showPerUserLimitsProp, onShowPerUserLimitsChange, showSharedCredits: showSharedCreditsProp, onShowSharedCreditsChange, onEntitlementChange, }?: {
     embedded?: boolean;
     /** Controlled "plans" sub-view flag. When provided, the host (settings
      *  wrapper) owns it so it can hide the sub-nav + show the Plans breadcrumb. */
@@ -1439,6 +1462,14 @@ declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlan
      *  workspace is in an organization. */
     showSharedCredits?: boolean;
     onShowSharedCreditsChange?: (open: boolean) => void;
+    /** Called once the current plan has loaded, and again when it changes:
+     *  billing's `entitlement` (null from servers without it) and whether the
+     *  workspace gets paid features. A workspace spending a sponsor's shared
+     *  credits is `paid` on its free plan; gate features on this, not the plan. */
+    onEntitlementChange?: (state: {
+        entitlement: BillingEntitlement | null;
+        paid: boolean;
+    }) => void;
 }): react__default.JSX.Element;
 
 /**
@@ -2204,6 +2235,78 @@ declare function poolErrorMessage(failure: unknown): string | null;
  */
 declare function SharedCreditsView(): react.JSX.Element;
 
+/**
+ * Whether a workspace gets paid features, and why. Billing reports it at the
+ * top level of the current-subscription answer, beside `data` (200:
+ * `{ success, data, entitlement }`; 404: `{ error, entitlement }`), and
+ * leaves the plan as it is: a workspace spending another's shared credits (a
+ * "sponsored" workspace) still shows the free plan, with
+ * `entitlement.source: 'pool'`.
+ *
+ * So the plan — and every billing action: Upgrade, Cancel downgrade, Buy
+ * credits — stays decided by the plan's amount, and only features are gated
+ * on `entitlement.paid`. Billing servers from before entitlement send none;
+ * then a workspace is paid exactly when its plan is, as before.
+ */
+/** `entitlement` as billing sends it, or null when it is absent or malformed. */
+declare function parseBillingEntitlement(value: unknown): BillingEntitlement | null;
+/**
+ * The `entitlement` of a current-subscription answer: `body.entitlement`,
+ * never `body.data.entitlement` (`data` is the subscription).
+ */
+declare function entitlementFromBody(body: unknown): BillingEntitlement | null;
+/**
+ * The entitlement a failed read carries: billing's 404 for a workspace with
+ * no subscription of its own still says whether a pool entitles it. The body
+ * is looked for where hosts keep it — the failure itself, `body`, `data`
+ * (`UserFacingError`), `response.data` (axios) and `cause` — to a shallow
+ * depth. Null when there is none.
+ */
+declare function entitlementFromFailure(failure: unknown): BillingEntitlement | null;
+/** Paid by the workspace's own plan: what Buy credits and the plan actions go by. */
+declare function isPaidPlan(subscription: Pick<BillingSubscription, "plan"> | null | undefined): boolean;
+/**
+ * Whether the workspace gets paid features: `entitlement.paid` when billing
+ * sent one, else its own plan being paid (servers from before entitlement).
+ */
+declare function hasPaidFeatures({ entitlement, subscription, }: {
+    entitlement: BillingEntitlement | null | undefined;
+    subscription: Pick<BillingSubscription, "plan"> | null | undefined;
+}): boolean;
+/** A workspace spending another's shared credits, by its entitlement. */
+declare function isSponsoredEntitlement(entitlement: BillingEntitlement | null | undefined): entitlement is BillingEntitlement & {
+    source: "pool";
+};
+/** "Credits shared by Agency." plus " Sharing ends on Mar 1, 2027." when it ends on its own. */
+declare function sponsoredCreditsText(entitlement: Pick<BillingEntitlement, "sponsorName" | "endsAt">): string;
+interface CurrentPlanState {
+    /** The workspace's own subscription; null without one. */
+    subscription: BillingSubscription | null;
+    /** Null when billing sent none (servers from before entitlement). */
+    entitlement: BillingEntitlement | null;
+    /** Gate features on this; see `hasPaidFeatures`. */
+    paid: boolean;
+}
+/**
+ * Read the current plan and its entitlement through the host's
+ * `fetchCurrentPlan`. A failure that carries an entitlement — billing's 404
+ * for a sponsored workspace with no subscription of its own — is not an
+ * error: it answers no subscription with that entitlement. Any other failure
+ * is thrown, as before.
+ */
+declare function loadCurrentPlan(fetchCurrentPlan: () => Promise<SubscriptionResponse>): Promise<CurrentPlanState>;
+
+/**
+ * `loadCurrentPlan` as a hook, for a host gating features on `paid`. Reloads
+ * when `key` (e.g. the workspace id) changes; `fetchCurrentPlan` may be a new
+ * function every render. `state` is null while loading, after a failure, and
+ * while `key` is null.
+ */
+declare function useBillingEntitlement(fetchCurrentPlan: (() => Promise<SubscriptionResponse>) | null | undefined, key: string | null | undefined): {
+    state: CurrentPlanState | null;
+    loading: boolean;
+};
+
 type CreditPoolMemberModalProps = {
     kind: "add";
     /** Workspaces credits can be shared with. */
@@ -2331,4 +2434,4 @@ interface AppSettingsRowProps {
 }
 declare function AppSettingsRow({ title, description, summary, href, onClick, disabled, disabledReason, ariaLabel, trailing }: AppSettingsRowProps): react.JSX.Element;
 
-export { APP_KEYS, type AddCreditPoolMemberInput, AdministrationOverview, type AdministrationOverviewProps, type AdministrativeNavigationOptions, type ApiToken, type AppKey, AppSettingsHeader, type AppSettingsHeaderProps, AppSettingsPage, type AppSettingsPageProps, AppSettingsRow, type AppSettingsRowProps, AppSettingsSection, type AppSettingsSectionProps, type AvailableCreditsResponse, BillingContent, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type ConnectedApp, ConnectedAppsContent, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CreditPoolCandidate, type CreditPoolFormerMember, type CreditPoolMember, CreditPoolMemberModal, type CreditPoolMemberModalProps, type CreditPoolMemberStatus, type CreditPoolMode, type CreditPoolResponse, type CreditsMeter, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationDetails, OrganizationIntegrationsContent, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, type OrganizationMemberRole, OrganizationModal, OrganizationPicker, type OrganizationPickerItem, type OrganizationPickerProps, type OrganizationPickerType, type OrganizationView, type OrganizationWorkspaceItem, POOL_ERROR_CODES, POOL_EXPIRY_MAX_MONTHS, POOL_NOTE_MAX_LENGTH, PerUserLimitsView, type PoolEndsAtResult, type PoolErrorCode, type PoolExpiryChoice, type PoolValueValidation, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, REMOVE_REASON_MAX_LENGTH, ReferralTab, RemovePoolMemberModal, type RemovePoolMemberModalProps, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsIntegrationsAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCreateOptions, type SettingsOrganizationCurrent, type SettingsOrganizationJoinableItem, type SettingsOrganizationListItem, type SettingsOrganizationType, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SharedCreditsView, type SharedPoolBalance, 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 UpdateCreditPoolMemberInput, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerGroup, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, canShowSharedCredits, cleanCreditLimitInput, cleanPoolValueInput, countLabel, creditCycleUnit, creditsMeter, deriveWorkspaceInvitePermission, describeAllowance, describeDefaultLimit, describeMemberLimit, expiryChoiceFor, findBillingError, findPoolError, formatCreditLimit, formatCredits, formatPoolEndsAt, formatPoolSplit, groupWorkspaceList, isLimitBelowUsage, joinMembersWithLimits, lastUsedLabel, limitBelowUsageUsed, limitSourceLabel, loadWorkspaceOrganization, memberRoleUpdate, minPoolEndDate, minimumCreditLimit, ownCreditsFirstText, pausedOwnCreditsText, poolEndsAtFrom, poolErrorMessage, poolRenewsAtCycleEnd, poolWorkspaceName, readSettingsCaller, rememberSettingsCaller, resolveSettingsTabFromPath, roundCredits, settingsReturnTarget, sharedPoolBannerText, sharedPoolEndsText, toLocalDateInput, useSettingsAdapters, useWorkspaceInvitePermission, useWorkspaceOrganization, usedByNamesFrom, usedByWorkspaceKey, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput, validatePoolText, validatePoolValue };
+export { APP_KEYS, type AddCreditPoolMemberInput, AdministrationOverview, type AdministrationOverviewProps, type AdministrativeNavigationOptions, type ApiToken, type AppKey, AppSettingsHeader, type AppSettingsHeaderProps, AppSettingsPage, type AppSettingsPageProps, AppSettingsRow, type AppSettingsRowProps, AppSettingsSection, type AppSettingsSectionProps, type AvailableCreditsResponse, BillingContent, type BillingEntitlement, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type ConnectedApp, ConnectedAppsContent, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CreditPoolCandidate, type CreditPoolFormerMember, type CreditPoolMember, CreditPoolMemberModal, type CreditPoolMemberModalProps, type CreditPoolMemberStatus, type CreditPoolMode, type CreditPoolResponse, type CreditsMeter, type CurrentPlanState, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationDetails, OrganizationIntegrationsContent, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, type OrganizationMemberRole, OrganizationModal, OrganizationPicker, type OrganizationPickerItem, type OrganizationPickerProps, type OrganizationPickerType, type OrganizationView, type OrganizationWorkspaceItem, POOL_ERROR_CODES, POOL_EXPIRY_MAX_MONTHS, POOL_NOTE_MAX_LENGTH, PerUserLimitsView, type PoolEndsAtResult, type PoolErrorCode, type PoolExpiryChoice, type PoolValueValidation, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, REMOVE_REASON_MAX_LENGTH, ReferralTab, RemovePoolMemberModal, type RemovePoolMemberModalProps, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsIntegrationsAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCreateOptions, type SettingsOrganizationCurrent, type SettingsOrganizationJoinableItem, type SettingsOrganizationListItem, type SettingsOrganizationType, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SharedCreditsView, type SharedPoolBalance, 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 UpdateCreditPoolMemberInput, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerGroup, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, canShowSharedCredits, cleanCreditLimitInput, cleanPoolValueInput, countLabel, creditCycleUnit, creditsMeter, deriveWorkspaceInvitePermission, describeAllowance, describeDefaultLimit, describeMemberLimit, entitlementFromBody, entitlementFromFailure, expiryChoiceFor, findBillingError, findPoolError, formatCreditLimit, formatCredits, formatPoolEndsAt, formatPoolSplit, groupWorkspaceList, hasPaidFeatures, isLimitBelowUsage, isPaidPlan, isSponsoredEntitlement, joinMembersWithLimits, lastUsedLabel, limitBelowUsageUsed, limitSourceLabel, loadCurrentPlan, loadWorkspaceOrganization, memberRoleUpdate, minPoolEndDate, minimumCreditLimit, ownCreditsFirstText, parseBillingEntitlement, pausedOwnCreditsText, poolEndsAtFrom, poolErrorMessage, poolRenewsAtCycleEnd, poolWorkspaceName, readSettingsCaller, rememberSettingsCaller, resolveSettingsTabFromPath, roundCredits, settingsReturnTarget, sharedPoolBannerText, sharedPoolEndsText, sponsoredCreditsText, toLocalDateInput, useBillingEntitlement, useSettingsAdapters, useWorkspaceInvitePermission, useWorkspaceOrganization, usedByNamesFrom, usedByWorkspaceKey, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput, validatePoolText, validatePoolValue };

package/dist/index.js

@@ -85,6 +85,8 @@ __export(index_exports, {
   describeAllowance: () => describeAllowance,
   describeDefaultLimit: () => describeDefaultLimit,
   describeMemberLimit: () => describeMemberLimit,
+  entitlementFromBody: () => entitlementFromBody,
+  entitlementFromFailure: () => entitlementFromFailure,
   expiryChoiceFor: () => expiryChoiceFor,
   findBillingError: () => findBillingError,
   findPoolError: () => findPoolError,
@@ -93,16 +95,21 @@ __export(index_exports, {
   formatPoolEndsAt: () => formatPoolEndsAt,
   formatPoolSplit: () => formatPoolSplit,
   groupWorkspaceList: () => groupWorkspaceList,
+  hasPaidFeatures: () => hasPaidFeatures,
   isLimitBelowUsage: () => isLimitBelowUsage,
+  isPaidPlan: () => isPaidPlan,
+  isSponsoredEntitlement: () => isSponsoredEntitlement,
   joinMembersWithLimits: () => joinMembersWithLimits,
   lastUsedLabel: () => lastUsedLabel,
   limitBelowUsageUsed: () => limitBelowUsageUsed,
   limitSourceLabel: () => limitSourceLabel,
+  loadCurrentPlan: () => loadCurrentPlan,
   loadWorkspaceOrganization: () => loadWorkspaceOrganization,
   memberRoleUpdate: () => memberRoleUpdate,
   minPoolEndDate: () => minPoolEndDate,
   minimumCreditLimit: () => minimumCreditLimit,
   ownCreditsFirstText: () => ownCreditsFirstText,
+  parseBillingEntitlement: () => parseBillingEntitlement,
   pausedOwnCreditsText: () => pausedOwnCreditsText,
   poolEndsAtFrom: () => poolEndsAtFrom,
   poolErrorMessage: () => poolErrorMessage,
@@ -115,7 +122,9 @@ __export(index_exports, {
   settingsReturnTarget: () => settingsReturnTarget,
   sharedPoolBannerText: () => sharedPoolBannerText,
   sharedPoolEndsText: () => sharedPoolEndsText,
+  sponsoredCreditsText: () => sponsoredCreditsText,
   toLocalDateInput: () => toLocalDateInput,
+  useBillingEntitlement: () => useBillingEntitlement,
   useSettingsAdapters: () => useSettingsAdapters,
   useWorkspaceInvitePermission: () => useWorkspaceInvitePermission,
   useWorkspaceOrganization: () => useWorkspaceOrganization,
@@ -10585,6 +10594,71 @@ function SharedCreditsView() {
   ] });
 }
 
+// src/entitlement.ts
+function parseBillingEntitlement(value) {
+  if (!value || typeof value !== "object") return null;
+  const raw = value;
+  if (typeof raw.paid !== "boolean") return null;
+  const source = raw.source === "plan" || raw.source === "pool" ? raw.source : null;
+  const entitlement = { paid: raw.paid, source };
+  if (typeof raw.sponsorWorkspaceId === "string") entitlement.sponsorWorkspaceId = raw.sponsorWorkspaceId;
+  if (typeof raw.sponsorName === "string") entitlement.sponsorName = raw.sponsorName;
+  if (typeof raw.endsAt === "string" || raw.endsAt === null) entitlement.endsAt = raw.endsAt;
+  return entitlement;
+}
+function entitlementFromBody(body) {
+  if (!body || typeof body !== "object") return null;
+  return parseBillingEntitlement(body.entitlement);
+}
+function entitlementFromFailure(failure) {
+  const seen = /* @__PURE__ */ new Set();
+  const visit = (value, depth) => {
+    if (depth > 4 || value == null || typeof value !== "object" || seen.has(value)) return null;
+    seen.add(value);
+    const found = entitlementFromBody(value);
+    if (found) return found;
+    const error = value;
+    const response = error.response;
+    for (const child of [error.body, error.data, response?.data, error.cause]) {
+      const nested = visit(child, depth + 1);
+      if (nested) return nested;
+    }
+    return null;
+  };
+  return visit(failure, 0);
+}
+function isPaidPlan(subscription) {
+  const amount = subscription?.plan?.amount;
+  return amount != null && amount > 0;
+}
+function hasPaidFeatures({
+  entitlement,
+  subscription
+}) {
+  return entitlement ? entitlement.paid : isPaidPlan(subscription);
+}
+function isSponsoredEntitlement(entitlement) {
+  return entitlement?.source === "pool" && entitlement.paid;
+}
+function sponsoredCreditsText(entitlement) {
+  const sponsor = entitlement.sponsorName?.trim() || "another workspace";
+  const ends = entitlement.endsAt ? ` Sharing ends on ${formatPoolEndsAt(entitlement.endsAt)}.` : "";
+  return `Credits shared by ${sponsor}.${ends}`;
+}
+async function loadCurrentPlan(fetchCurrentPlan) {
+  let response;
+  try {
+    response = await fetchCurrentPlan();
+  } catch (failure) {
+    const entitlement2 = entitlementFromFailure(failure);
+    if (!entitlement2) throw failure;
+    return { subscription: null, entitlement: entitlement2, paid: entitlement2.paid };
+  }
+  const subscription = response?.data ?? null;
+  const entitlement = entitlementFromBody(response);
+  return { subscription, entitlement, paid: hasPaidFeatures({ entitlement, subscription }) };
+}
+
 // src/billing-content.tsx
 var import_jsx_runtime29 = require("react/jsx-runtime");
 var DEFAULT_TOPUP_SERVICE = "catalogix";
@@ -11716,7 +11790,8 @@ function BillingContent({
   showPerUserLimits: showPerUserLimitsProp,
   onShowPerUserLimitsChange,
   showSharedCredits: showSharedCreditsProp,
-  onShowSharedCreditsChange
+  onShowSharedCreditsChange,
+  onEntitlementChange
 } = {}) {
   const { auth, workspace, organization, api, toast, navigation } = useSettingsAdapters();
   const user = auth.user;
@@ -11755,6 +11830,9 @@ function BillingContent({
   const [showExportModal, setShowExportModal] = (0, import_react23.useState)(false);
   const [showBuyCreditsModal, setShowBuyCreditsModal] = (0, import_react23.useState)(false);
   const [subscription, setSubscription] = (0, import_react23.useState)(null);
+  const [entitlement, setEntitlement] = (0, import_react23.useState)(
+    null
+  );
   const [availableCredits, setAvailableCredits] = (0, import_react23.useState)(null);
   const [sharedPool, setSharedPool] = (0, import_react23.useState)(null);
   const [usedByNames, setUsedByNames] = (0, import_react23.useState)({});
@@ -11800,12 +11878,15 @@ function BillingContent({
     try {
       console.log("calling Billing apis");
       const [subRes, creditsRes, productsRes, customRes] = await Promise.all([
-        api.fetchCurrentPlan().catch(() => null),
+        // A sponsored workspace with no subscription of its own gets a 404
+        // that carries its entitlement: loadCurrentPlan answers it, not throws.
+        loadCurrentPlan(api.fetchCurrentPlan).catch(() => null),
         api.fetchAvailableCredits().catch(() => null),
         api.fetchPlans().catch(() => null),
         api.getCustomCreditInfo?.().catch(() => null) ?? Promise.resolve(null)
       ]);
-      if (subRes?.data) setSubscription(subRes.data);
+      if (subRes?.subscription) setSubscription(subRes.subscription);
+      if (subRes) setEntitlement(subRes.entitlement);
       if (creditsRes?.availableCredits != null)
         setAvailableCredits(creditsRes.availableCredits);
       setSharedPool(creditsRes?.sharedPool ?? null);
@@ -11975,6 +12056,7 @@ function BillingContent({
     setInitialFetchTriggered(false);
     setBillingOverviewLoaded(false);
     setSubscription(null);
+    setEntitlement(null);
     setAvailableCredits(null);
     setProducts([]);
     setTotalCredits(null);
@@ -12030,7 +12112,16 @@ function BillingContent({
     subscription?.scheduledDowngradeEffectiveDate
   );
   const scheduledDowngradeText = subscription?.downgradeScheduled && subscription.plan?.name ? `Downgrades to ${subscription.plan.name}${scheduledDowngradeDateLabel ? ` ${scheduledDowngradeDateLabel}` : ""}` : void 0;
-  const isPlanDetailsLoading = !billingOverviewLoaded || loadingBilling || subscription?.plan == null || !planName || planName === "-" || !planAmount || currentPlanCredits == null;
+  const sponsored = isSponsoredEntitlement(entitlement);
+  const sponsoredWithoutPlan = sponsored && billingOverviewLoaded && !loadingBilling && subscription == null;
+  const isPlanDetailsLoading = sponsoredWithoutPlan ? false : !billingOverviewLoaded || loadingBilling || subscription?.plan == null || !planName || planName === "-" || !planAmount || currentPlanCredits == null;
+  const paidFeatures = hasPaidFeatures({ entitlement, subscription });
+  const onEntitlementChangeRef = (0, import_react23.useRef)(onEntitlementChange);
+  onEntitlementChangeRef.current = onEntitlementChange;
+  (0, import_react23.useEffect)(() => {
+    if (!billingOverviewLoaded) return;
+    onEntitlementChangeRef.current?.({ entitlement, paid: paidFeatures });
+  }, [billingOverviewLoaded, entitlement, paidFeatures]);
   const {
     used: usedCredits,
     remaining: remainingCredits,
@@ -12267,9 +12358,9 @@ function BillingContent({
           /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
             import_ui17.ScPlanDetailsCard,
             {
-              planName,
-              planCredits: planCreditsText,
-              planPrice: planAmount,
+              planName: sponsoredWithoutPlan ? "Free" : planName,
+              planCredits: sponsoredWithoutPlan ? "Shared credits" : planCreditsText,
+              planPrice: sponsoredWithoutPlan ? `${workspace.current?.country?.trim().toUpperCase() === "IN" ? "\u20B9" : "$"}0.00 / month` : planAmount,
               badgeText: "Active",
               badgeSubText: scheduledDowngradeText,
               currentPlanLabel: "Current plan",
@@ -12358,6 +12449,50 @@ function BillingContent({
           )
         ]
       }
+    ) : sponsored && entitlement ? (
+      // Billing says a pool entitles it, but the balance carried no
+      // allowance (an older credits answer, or it failed): say whose.
+      /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(
+        "div",
+        {
+          role: "status",
+          className: "flex flex-col shrink-0 w-full",
+          style: {
+            gap: 4,
+            padding: 16,
+            backgroundColor: "var(--alias-surface-base)",
+            border: "1px solid var(--alias-border-subtle)",
+            borderRadius: "var(--radius-3xl)"
+          },
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+              "span",
+              {
+                style: {
+                  fontFamily: "var(--font-family-font-family-body)",
+                  fontSize: "var(--font-size-font-size-sm)",
+                  fontWeight: 500,
+                  lineHeight: "var(--line-height-line-height-sm)",
+                  color: "var(--alias-text---icons-primary)"
+                },
+                children: sponsoredCreditsText(entitlement)
+              }
+            ),
+            /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(
+              "span",
+              {
+                style: {
+                  fontFamily: "var(--font-family-font-family-body)",
+                  fontSize: "var(--font-size-font-size-sm)",
+                  lineHeight: "var(--line-height-line-height-sm)",
+                  color: "var(--alias-text---icons-muted)"
+                },
+                children: ownCreditsFirstText()
+              }
+            )
+          ]
+        }
+      )
     ) : null,
     usage ? /* @__PURE__ */ (0, import_jsx_runtime29.jsxs)(
       "div",
@@ -16732,6 +16867,30 @@ function OrganizationPicker({
   );
 }
 
+// src/use-billing-entitlement.ts
+var import_react30 = require("react");
+function useBillingEntitlement(fetchCurrentPlan, key) {
+  const fetchRef = (0, import_react30.useRef)(fetchCurrentPlan);
+  fetchRef.current = fetchCurrentPlan;
+  const [state, setState] = (0, import_react30.useState)(null);
+  const [loading, setLoading] = (0, import_react30.useState)(false);
+  (0, import_react30.useEffect)(() => {
+    const fetch2 = fetchRef.current;
+    setState(null);
+    if (!key || !fetch2) {
+      setLoading(false);
+      return;
+    }
+    let live = true;
+    setLoading(true);
+    loadCurrentPlan(fetch2).then((next) => live && setState(next)).catch(() => live && setState(null)).finally(() => live && setLoading(false));
+    return () => {
+      live = false;
+    };
+  }, [key]);
+  return { state, loading };
+}
+
 // src/administration-navigation.ts
 var normalizedBase = (base) => base.replace(/\/$/, "");
 var returnKey = (base, entryKey) => `streamoid:settings:return:${base}:${entryKey}`;
@@ -16778,7 +16937,7 @@ function readSettingsCaller(base, state, entryKey, fallback = `${normalizedBase(
 }
 
 // src/app-settings-page.tsx
-var import_react30 = require("react");
+var import_react31 = require("react");
 var import_icons20 = require("@streamoid/icons");
 
 // src/app-settings-page.module.css
@@ -16841,7 +17000,7 @@ function AppSettingsSection({ title, action, children }) {
   ] });
 }
 function AppSettingsRow({ title, description, summary, href, onClick, disabled, disabledReason, ariaLabel, trailing }) {
-  const reasonId = (0, import_react30.useId)();
+  const reasonId = (0, import_react31.useId)();
   const content = /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(import_jsx_runtime36.Fragment, { children: [
     /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)("span", { className: app_settings_page_default.rowCopy, children: [
       /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("span", { className: app_settings_page_default.rowTitle, children: title }),

package/dist/index.mjs

@@ -10523,6 +10523,71 @@ function SharedCreditsView() {
   ] });
 }
 
+// src/entitlement.ts
+function parseBillingEntitlement(value) {
+  if (!value || typeof value !== "object") return null;
+  const raw = value;
+  if (typeof raw.paid !== "boolean") return null;
+  const source = raw.source === "plan" || raw.source === "pool" ? raw.source : null;
+  const entitlement = { paid: raw.paid, source };
+  if (typeof raw.sponsorWorkspaceId === "string") entitlement.sponsorWorkspaceId = raw.sponsorWorkspaceId;
+  if (typeof raw.sponsorName === "string") entitlement.sponsorName = raw.sponsorName;
+  if (typeof raw.endsAt === "string" || raw.endsAt === null) entitlement.endsAt = raw.endsAt;
+  return entitlement;
+}
+function entitlementFromBody(body) {
+  if (!body || typeof body !== "object") return null;
+  return parseBillingEntitlement(body.entitlement);
+}
+function entitlementFromFailure(failure) {
+  const seen = /* @__PURE__ */ new Set();
+  const visit = (value, depth) => {
+    if (depth > 4 || value == null || typeof value !== "object" || seen.has(value)) return null;
+    seen.add(value);
+    const found = entitlementFromBody(value);
+    if (found) return found;
+    const error = value;
+    const response = error.response;
+    for (const child of [error.body, error.data, response?.data, error.cause]) {
+      const nested = visit(child, depth + 1);
+      if (nested) return nested;
+    }
+    return null;
+  };
+  return visit(failure, 0);
+}
+function isPaidPlan(subscription) {
+  const amount = subscription?.plan?.amount;
+  return amount != null && amount > 0;
+}
+function hasPaidFeatures({
+  entitlement,
+  subscription
+}) {
+  return entitlement ? entitlement.paid : isPaidPlan(subscription);
+}
+function isSponsoredEntitlement(entitlement) {
+  return entitlement?.source === "pool" && entitlement.paid;
+}
+function sponsoredCreditsText(entitlement) {
+  const sponsor = entitlement.sponsorName?.trim() || "another workspace";
+  const ends = entitlement.endsAt ? ` Sharing ends on ${formatPoolEndsAt(entitlement.endsAt)}.` : "";
+  return `Credits shared by ${sponsor}.${ends}`;
+}
+async function loadCurrentPlan(fetchCurrentPlan) {
+  let response;
+  try {
+    response = await fetchCurrentPlan();
+  } catch (failure) {
+    const entitlement2 = entitlementFromFailure(failure);
+    if (!entitlement2) throw failure;
+    return { subscription: null, entitlement: entitlement2, paid: entitlement2.paid };
+  }
+  const subscription = response?.data ?? null;
+  const entitlement = entitlementFromBody(response);
+  return { subscription, entitlement, paid: hasPaidFeatures({ entitlement, subscription }) };
+}
+
 // src/billing-content.tsx
 import { Fragment as Fragment11, jsx as jsx29, jsxs as jsxs26 } from "react/jsx-runtime";
 var DEFAULT_TOPUP_SERVICE = "catalogix";
@@ -11654,7 +11719,8 @@ function BillingContent({
   showPerUserLimits: showPerUserLimitsProp,
   onShowPerUserLimitsChange,
   showSharedCredits: showSharedCreditsProp,
-  onShowSharedCreditsChange
+  onShowSharedCreditsChange,
+  onEntitlementChange
 } = {}) {
   const { auth, workspace, organization, api, toast, navigation } = useSettingsAdapters();
   const user = auth.user;
@@ -11693,6 +11759,9 @@ function BillingContent({
   const [showExportModal, setShowExportModal] = useState21(false);
   const [showBuyCreditsModal, setShowBuyCreditsModal] = useState21(false);
   const [subscription, setSubscription] = useState21(null);
+  const [entitlement, setEntitlement] = useState21(
+    null
+  );
   const [availableCredits, setAvailableCredits] = useState21(null);
   const [sharedPool, setSharedPool] = useState21(null);
   const [usedByNames, setUsedByNames] = useState21({});
@@ -11738,12 +11807,15 @@ function BillingContent({
     try {
       console.log("calling Billing apis");
       const [subRes, creditsRes, productsRes, customRes] = await Promise.all([
-        api.fetchCurrentPlan().catch(() => null),
+        // A sponsored workspace with no subscription of its own gets a 404
+        // that carries its entitlement: loadCurrentPlan answers it, not throws.
+        loadCurrentPlan(api.fetchCurrentPlan).catch(() => null),
         api.fetchAvailableCredits().catch(() => null),
         api.fetchPlans().catch(() => null),
         api.getCustomCreditInfo?.().catch(() => null) ?? Promise.resolve(null)
       ]);
-      if (subRes?.data) setSubscription(subRes.data);
+      if (subRes?.subscription) setSubscription(subRes.subscription);
+      if (subRes) setEntitlement(subRes.entitlement);
       if (creditsRes?.availableCredits != null)
         setAvailableCredits(creditsRes.availableCredits);
       setSharedPool(creditsRes?.sharedPool ?? null);
@@ -11913,6 +11985,7 @@ function BillingContent({
     setInitialFetchTriggered(false);
     setBillingOverviewLoaded(false);
     setSubscription(null);
+    setEntitlement(null);
     setAvailableCredits(null);
     setProducts([]);
     setTotalCredits(null);
@@ -11968,7 +12041,16 @@ function BillingContent({
     subscription?.scheduledDowngradeEffectiveDate
   );
   const scheduledDowngradeText = subscription?.downgradeScheduled && subscription.plan?.name ? `Downgrades to ${subscription.plan.name}${scheduledDowngradeDateLabel ? ` ${scheduledDowngradeDateLabel}` : ""}` : void 0;
-  const isPlanDetailsLoading = !billingOverviewLoaded || loadingBilling || subscription?.plan == null || !planName || planName === "-" || !planAmount || currentPlanCredits == null;
+  const sponsored = isSponsoredEntitlement(entitlement);
+  const sponsoredWithoutPlan = sponsored && billingOverviewLoaded && !loadingBilling && subscription == null;
+  const isPlanDetailsLoading = sponsoredWithoutPlan ? false : !billingOverviewLoaded || loadingBilling || subscription?.plan == null || !planName || planName === "-" || !planAmount || currentPlanCredits == null;
+  const paidFeatures = hasPaidFeatures({ entitlement, subscription });
+  const onEntitlementChangeRef = useRef10(onEntitlementChange);
+  onEntitlementChangeRef.current = onEntitlementChange;
+  useEffect18(() => {
+    if (!billingOverviewLoaded) return;
+    onEntitlementChangeRef.current?.({ entitlement, paid: paidFeatures });
+  }, [billingOverviewLoaded, entitlement, paidFeatures]);
   const {
     used: usedCredits,
     remaining: remainingCredits,
@@ -12205,9 +12287,9 @@ function BillingContent({
           /* @__PURE__ */ jsx29(
             ScPlanDetailsCard,
             {
-              planName,
-              planCredits: planCreditsText,
-              planPrice: planAmount,
+              planName: sponsoredWithoutPlan ? "Free" : planName,
+              planCredits: sponsoredWithoutPlan ? "Shared credits" : planCreditsText,
+              planPrice: sponsoredWithoutPlan ? `${workspace.current?.country?.trim().toUpperCase() === "IN" ? "\u20B9" : "$"}0.00 / month` : planAmount,
               badgeText: "Active",
               badgeSubText: scheduledDowngradeText,
               currentPlanLabel: "Current plan",
@@ -12296,6 +12378,50 @@ function BillingContent({
           )
         ]
       }
+    ) : sponsored && entitlement ? (
+      // Billing says a pool entitles it, but the balance carried no
+      // allowance (an older credits answer, or it failed): say whose.
+      /* @__PURE__ */ jsxs26(
+        "div",
+        {
+          role: "status",
+          className: "flex flex-col shrink-0 w-full",
+          style: {
+            gap: 4,
+            padding: 16,
+            backgroundColor: "var(--alias-surface-base)",
+            border: "1px solid var(--alias-border-subtle)",
+            borderRadius: "var(--radius-3xl)"
+          },
+          children: [
+            /* @__PURE__ */ jsx29(
+              "span",
+              {
+                style: {
+                  fontFamily: "var(--font-family-font-family-body)",
+                  fontSize: "var(--font-size-font-size-sm)",
+                  fontWeight: 500,
+                  lineHeight: "var(--line-height-line-height-sm)",
+                  color: "var(--alias-text---icons-primary)"
+                },
+                children: sponsoredCreditsText(entitlement)
+              }
+            ),
+            /* @__PURE__ */ jsx29(
+              "span",
+              {
+                style: {
+                  fontFamily: "var(--font-family-font-family-body)",
+                  fontSize: "var(--font-size-font-size-sm)",
+                  lineHeight: "var(--line-height-line-height-sm)",
+                  color: "var(--alias-text---icons-muted)"
+                },
+                children: ownCreditsFirstText()
+              }
+            )
+          ]
+        }
+      )
     ) : null,
     usage ? /* @__PURE__ */ jsxs26(
       "div",
@@ -16676,6 +16802,30 @@ function OrganizationPicker({
   );
 }
 
+// src/use-billing-entitlement.ts
+import { useEffect as useEffect22, useRef as useRef12, useState as useState28 } from "react";
+function useBillingEntitlement(fetchCurrentPlan, key) {
+  const fetchRef = useRef12(fetchCurrentPlan);
+  fetchRef.current = fetchCurrentPlan;
+  const [state, setState] = useState28(null);
+  const [loading, setLoading] = useState28(false);
+  useEffect22(() => {
+    const fetch2 = fetchRef.current;
+    setState(null);
+    if (!key || !fetch2) {
+      setLoading(false);
+      return;
+    }
+    let live = true;
+    setLoading(true);
+    loadCurrentPlan(fetch2).then((next) => live && setState(next)).catch(() => live && setState(null)).finally(() => live && setLoading(false));
+    return () => {
+      live = false;
+    };
+  }, [key]);
+  return { state, loading };
+}
+
 // src/administration-navigation.ts
 var normalizedBase = (base) => base.replace(/\/$/, "");
 var returnKey = (base, entryKey) => `streamoid:settings:return:${base}:${entryKey}`;
@@ -16873,6 +17023,8 @@ export {
   describeAllowance,
   describeDefaultLimit,
   describeMemberLimit,
+  entitlementFromBody,
+  entitlementFromFailure,
   expiryChoiceFor,
   findBillingError,
   findPoolError,
@@ -16881,16 +17033,21 @@ export {
   formatPoolEndsAt,
   formatPoolSplit,
   groupWorkspaceList,
+  hasPaidFeatures,
   isLimitBelowUsage,
+  isPaidPlan,
+  isSponsoredEntitlement,
   joinMembersWithLimits,
   lastUsedLabel,
   limitBelowUsageUsed,
   limitSourceLabel,
+  loadCurrentPlan,
   loadWorkspaceOrganization,
   memberRoleUpdate,
   minPoolEndDate,
   minimumCreditLimit,
   ownCreditsFirstText,
+  parseBillingEntitlement,
   pausedOwnCreditsText,
   poolEndsAtFrom,
   poolErrorMessage,
@@ -16903,7 +17060,9 @@ export {
   settingsReturnTarget,
   sharedPoolBannerText,
   sharedPoolEndsText,
+  sponsoredCreditsText,
   toLocalDateInput,
+  useBillingEntitlement,
   useSettingsAdapters,
   useWorkspaceInvitePermission,
   useWorkspaceOrganization,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@streamoid/settings",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",