@ydtb/tk-scope-app 0.14.7

package/dist/src/hooks/useJoinCode.js

@@ -0,0 +1,37 @@
+/**
+ * Join code hooks — validate + redeem.
+ *
+ * Adapts the scope extension's joinCodes.use endpoint to match the
+ * old authClient.scope.joinCode.validate/redeem API shape.
+ *
+ * Used by JoinScopeDialog.
+ */
+import { joinCodesApi } from "../lib/platform-api.js";
+/**
+ * Validate a join code. Returns the old-style { valid, scope, error } shape.
+ *
+ * The scope extension's `use` endpoint throws on invalid codes rather than
+ * returning `{ valid: false }`. This function adapts that to the shape
+ * JoinScopeDialog expects.
+ */
+export async function validateJoinCode(code) {
+    try {
+        const result = await joinCodesApi.$client.use({ code });
+        const scope = result;
+        if (scope?.scope) {
+            return { valid: true, scope: scope.scope };
+        }
+        return { valid: false, error: "Invalid or expired code" };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Invalid or expired code";
+        return { valid: false, error: message };
+    }
+}
+/**
+ * Redeem a join code (join the scope).
+ */
+export async function redeemJoinCode(code) {
+    return joinCodesApi.$client.use({ code });
+}
+//# sourceMappingURL=useJoinCode.js.map

package/dist/src/hooks/useJoinCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useJoinCode.js","sourceRoot":"","sources":["../../../src/hooks/useJoinCode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAQrD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;QACvD,MAAM,KAAK,GAAG,MAAuE,CAAA;QACrF,IAAI,KAAK,EAAE,KAAK,EAAE,CAAC;YACjB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAA;QAC5C,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAA;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAA;QAC9E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;IACzC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;AAC3C,CAAC"}

package/dist/src/hooks/usePreference.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generic React hook for reading and writing user preferences with
+ * localStorage fallback and server sync via TanStack Query + oRPC.
+ *
+ * 1. On mount: initialData from localStorage (instant, avoids flash).
+ * 2. useQuery fetches server value via oRPC in the background.
+ * 3. If the API returns a value, updates localStorage cache.
+ * 4. If the API fails (offline), continues using localStorage value.
+ * 5. `setValue`: writes to localStorage immediately (optimistic), updates
+ *    query cache, then fires `preferences.set` to persist server-side.
+ */
+export declare function usePreference<T>(key: string, defaultValue: T, options?: {
+    scope?: string;
+    scopeId?: string;
+}): {
+    value: T;
+    setValue: (newValue: T) => void;
+    isLoading: boolean;
+};
+//# sourceMappingURL=usePreference.d.ts.map

package/dist/src/hooks/usePreference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreference.d.ts","sourceRoot":"","sources":["../../../src/hooks/usePreference.ts"],"names":[],"mappings":"AAmCA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,CAAC,EACf,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C;IACD,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAA;IAC/B,SAAS,EAAE,OAAO,CAAA;CACnB,CAgGA"}

package/dist/src/hooks/usePreference.js

@@ -0,0 +1,132 @@
+import { useCallback, useEffect, useMemo, useRef } from "react";
+import { useQuery, useQueryClient } from "@ydtb/tk-scope-query-client";
+import { useAuth } from "../contexts/auth/AuthContext.js";
+import { preferencesApi } from "../lib/platform-api.js";
+/**
+ * Build the localStorage key for a preference.
+ * Format: `ydtb-pref:{key}` or `ydtb-pref:{scopeId}:{key}` if scope-scoped.
+ */
+function storageKey(key, scope, scopeId) {
+    return scope && scopeId ? `ydtb-pref:${scope}:${scopeId}:${key}` : `ydtb-pref:${key}`;
+}
+function readFromStorage(lsKey, defaultValue) {
+    if (typeof window === "undefined")
+        return defaultValue;
+    try {
+        const raw = localStorage.getItem(lsKey);
+        if (raw !== null) {
+            return JSON.parse(raw);
+        }
+    }
+    catch {
+        // ignore parse / access errors
+    }
+    return defaultValue;
+}
+function writeToStorage(lsKey, value) {
+    if (typeof window === "undefined")
+        return;
+    try {
+        localStorage.setItem(lsKey, JSON.stringify(value));
+    }
+    catch {
+        // ignore quota / access errors
+    }
+}
+/**
+ * Generic React hook for reading and writing user preferences with
+ * localStorage fallback and server sync via TanStack Query + oRPC.
+ *
+ * 1. On mount: initialData from localStorage (instant, avoids flash).
+ * 2. useQuery fetches server value via oRPC in the background.
+ * 3. If the API returns a value, updates localStorage cache.
+ * 4. If the API fails (offline), continues using localStorage value.
+ * 5. `setValue`: writes to localStorage immediately (optimistic), updates
+ *    query cache, then fires `preferences.set` to persist server-side.
+ */
+export function usePreference(key, defaultValue, options) {
+    const { session } = useAuth();
+    const scope = options?.scope;
+    const scopeId = options?.scopeId;
+    const lsKey = storageKey(key, scope, scopeId);
+    const queryClient = useQueryClient();
+    // Read localStorage value once for initialData
+    const initialDataRef = useRef(readFromStorage(lsKey, defaultValue));
+    const queryOptions = preferencesApi.get.queryOptions({
+        input: scope && scopeId ? { key, scope, scopeId } : { key },
+    });
+    const { data: serverResult, isLoading } = useQuery({
+        ...queryOptions,
+        // Skip when not authenticated — localStorage value is sufficient
+        enabled: !!session,
+        // Use placeholderData instead of initialData to avoid type mismatch
+        // while still preventing flash (shows localStorage value until server responds)
+        placeholderData: {
+            key,
+            value: JSON.stringify(initialDataRef.current),
+            scope: scope ?? "global",
+            scopeId: scopeId ?? null,
+        },
+    });
+    // Parse the server value, falling back to default.
+    // Memoize on the serialized string so consumers get a stable reference
+    // (JSON.parse creates a new object every call, which would break
+    // reference-equality checks in useEffect deps downstream).
+    const serializedValue = serverResult?.value ?? null;
+    const defaultValueRef = useRef(defaultValue);
+    defaultValueRef.current = defaultValue;
+    const value = useMemo(() => {
+        try {
+            if (serializedValue !== null && serializedValue !== undefined) {
+                return JSON.parse(serializedValue);
+            }
+        }
+        catch {
+            // ignore parse errors
+        }
+        return defaultValueRef.current;
+    }, [serializedValue]);
+    // Sync server value to localStorage when query data updates
+    const prevValueRef = useRef(null);
+    useEffect(() => {
+        const serialized = serverResult?.value ?? null;
+        if (serialized !== null && serialized !== prevValueRef.current) {
+            prevValueRef.current = serialized;
+            try {
+                const parsed = JSON.parse(serialized);
+                writeToStorage(lsKey, parsed);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }, [serverResult, lsKey]);
+    const queryKeyRef = useRef(queryOptions.queryKey);
+    queryKeyRef.current = queryOptions.queryKey;
+    const setValue = useCallback((newValue) => {
+        const serialized = JSON.stringify(newValue);
+        // Optimistic local update
+        writeToStorage(lsKey, newValue);
+        // Update the query cache immediately
+        queryClient.setQueryData(queryKeyRef.current, {
+            key,
+            value: serialized,
+            scope: scope ?? "global",
+            scopeId: scopeId ?? null,
+        });
+        // Fire-and-forget server persist (skip when not authenticated)
+        if (session) {
+            preferencesApi.$client
+                .set({
+                key,
+                value: serialized,
+                ...(scope && scopeId ? { scope, scopeId } : {}),
+            })
+                .catch(() => {
+                // Silently ignore — localStorage already has the value
+            });
+        }
+    }, [key, scope, scopeId, lsKey, queryClient, session]);
+    return { value, setValue, isLoading };
+}
+//# sourceMappingURL=usePreference.js.map

package/dist/src/hooks/usePreference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreference.js","sourceRoot":"","sources":["../../../src/hooks/usePreference.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks/useScopeList.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Scope listing hook.
+ *
+ * Single source of truth for fetching user's scope memberships.
+ * Used by ScopeSwitcher, SwitchScopeDialog, ProfileScopeSection,
+ * and MainHeaderDesktop.
+ */
+export interface ScopeListItem {
+    id: string;
+    type: string;
+    name: string;
+    slug: string | null;
+    logo: string | null;
+    parentScope: string | null;
+    parentScopeId: string | null;
+    role: string;
+    metadata?: unknown;
+    childScopeCount?: number;
+}
+/**
+ * Fetch all scopes the current user is a member of.
+ * Optionally filter by scope type.
+ */
+export declare function useScopeList(options?: {
+    type?: string;
+    enabled?: boolean;
+    staleTime?: number;
+}): {
+    scopes: ScopeListItem[];
+    isPending: boolean;
+};
+//# sourceMappingURL=useScopeList.d.ts.map

package/dist/src/hooks/useScopeList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScopeList.d.ts","sourceRoot":"","sources":["../../../src/hooks/useScopeList.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;;;EAY9F"}

package/dist/src/hooks/useScopeList.js

@@ -0,0 +1,24 @@
+/**
+ * Scope listing hook.
+ *
+ * Single source of truth for fetching user's scope memberships.
+ * Used by ScopeSwitcher, SwitchScopeDialog, ProfileScopeSection,
+ * and MainHeaderDesktop.
+ */
+import { useQuery } from "@ydtb/tk-scope-query-client";
+import { scopeApi } from "../lib/platform-api.js";
+/**
+ * Fetch all scopes the current user is a member of.
+ * Optionally filter by scope type.
+ */
+export function useScopeList(options) {
+    const { type, enabled = true, staleTime } = options ?? {};
+    const { data, isPending } = useQuery({
+        ...scopeApi.list.queryOptions({ input: { type } }),
+        enabled,
+        ...(staleTime !== undefined ? { staleTime } : {}),
+    });
+    const scopes = (data?.scopes ?? []);
+    return { scopes, isPending };
+}
+//# sourceMappingURL=useScopeList.js.map

package/dist/src/hooks/useScopeList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScopeList.js","sourceRoot":"","sources":["../../../src/hooks/useScopeList.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAejD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAkE;IAC7F,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;IAEzD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC;QACnC,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QAClD,OAAO;QACP,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAoB,CAAA;IAEtD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA;AAC9B,CAAC"}

package/dist/src/hooks/useScopeMenuPolicy.d.ts

@@ -0,0 +1,23 @@
+import { type ScopeMenuMode, type ScopeTypeInfo } from "@ydtb/tk-scope/client";
+import { type ScopeListItem } from "./useScopeList.ts";
+export interface ScopeMenuPolicy {
+    mode: ScopeMenuMode;
+    scopeConfig?: ScopeTypeInfo;
+    childScopeType: string | null;
+    childScopeConfig?: ScopeTypeInfo;
+    currentScope: ScopeListItem | null;
+    parentScope: ScopeListItem | null;
+    siblingScopes: ScopeListItem[];
+    childScopes: ScopeListItem[];
+    allScopes: ScopeListItem[];
+    canSwitchScopes: boolean;
+    canViewChildScopes: boolean;
+    canCreateChildScopes: boolean;
+    hasSwitchTarget: boolean;
+    hasChildScopes: boolean;
+    hasCreateChildAction: boolean;
+    showScopeMenu: boolean;
+    isLoadingScopes: boolean;
+}
+export declare function useScopeMenuPolicy(): ScopeMenuPolicy;
+//# sourceMappingURL=useScopeMenuPolicy.d.ts.map

package/dist/src/hooks/useScopeMenuPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScopeMenuPolicy.d.ts","sourceRoot":"","sources":["../../../src/hooks/useScopeMenuPolicy.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAA;AAO9B,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEpE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAA;IACnB,WAAW,CAAC,EAAE,aAAa,CAAA;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,gBAAgB,CAAC,EAAE,aAAa,CAAA;IAChC,YAAY,EAAE,aAAa,GAAG,IAAI,CAAA;IAClC,WAAW,EAAE,aAAa,GAAG,IAAI,CAAA;IACjC,aAAa,EAAE,aAAa,EAAE,CAAA;IAC9B,WAAW,EAAE,aAAa,EAAE,CAAA;IAC5B,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,eAAe,EAAE,OAAO,CAAA;IACxB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,oBAAoB,EAAE,OAAO,CAAA;IAC7B,eAAe,EAAE,OAAO,CAAA;IACxB,cAAc,EAAE,OAAO,CAAA;IACvB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,aAAa,EAAE,OAAO,CAAA;IACtB,eAAe,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CA8DpD"}

package/dist/src/hooks/useScopeMenuPolicy.js

@@ -0,0 +1,59 @@
+import { useMemo } from "react";
+import { queryChildScopeTypes, queryScopeType, } from "@ydtb/tk-scope/client";
+import { useScopeContext } from "../contexts/scope/ScopeContext.js";
+import { useCurrentPermissions } from "../lib/permissions-store.js";
+import { canCreateChildScopeAction, getScopeMenuVisibility, } from "../lib/scope-menu-policy.js";
+import { useScopeList } from "./useScopeList.js";
+export function useScopeMenuPolicy() {
+    const { scopeId, scopeType, entity } = useScopeContext();
+    const permissions = useCurrentPermissions();
+    const { scopes: allScopes, isPending: isLoadingScopes } = useScopeList({ staleTime: 30_000 });
+    return useMemo(() => {
+        const scopeConfig = scopeType ? queryScopeType(scopeType) : undefined;
+        const mode = scopeConfig?.scopeMenu ?? "auto";
+        const childScopeType = scopeType ? (queryChildScopeTypes(scopeType)[0] ?? null) : null;
+        const childScopeConfig = childScopeType ? queryScopeType(childScopeType) : undefined;
+        const currentScope = allScopes.find((scope) => scope.id === scopeId) ?? null;
+        const parentScopeId = entity?.parentScopeId ?? currentScope?.parentScopeId ?? null;
+        const parentScope = parentScopeId
+            ? (allScopes.find((scope) => scope.id === parentScopeId) ?? null)
+            : null;
+        const siblingScopes = allScopes.filter((scope) => scope.parentScopeId === parentScopeId && scope.id !== scopeId);
+        const childScopes = allScopes.filter((scope) => scope.parentScopeId === scopeId);
+        const effectivePermissions = permissions.loaded ? permissions.effectivePermissions : [];
+        const canSwitchScopes = effectivePermissions.includes("scope.switch");
+        const canViewChildScopes = effectivePermissions.includes("scope.children.view");
+        const canCreateChildScopes = effectivePermissions.includes("scope.children.create");
+        const hasSwitchTarget = Boolean(parentScope) || siblingScopes.length > 0 || allScopes.length > 1;
+        const hasChildScopes = childScopes.length > 0;
+        const hasCreateChildAction = canCreateChildScopeAction(childScopeConfig?.selfCreate, Boolean(childScopeType));
+        return {
+            mode,
+            scopeConfig,
+            childScopeType,
+            childScopeConfig,
+            currentScope,
+            parentScope,
+            siblingScopes,
+            childScopes,
+            allScopes,
+            canSwitchScopes,
+            canViewChildScopes,
+            canCreateChildScopes,
+            hasSwitchTarget,
+            hasChildScopes,
+            hasCreateChildAction,
+            showScopeMenu: getScopeMenuVisibility({
+                mode,
+                canSwitchScopes,
+                hasSwitchTarget,
+                canViewChildScopes,
+                hasChildScopes,
+                canCreateChildScopes,
+                hasCreateChildAction,
+            }),
+            isLoadingScopes,
+        };
+    }, [allScopes, entity?.parentScopeId, isLoadingScopes, permissions, scopeId, scopeType]);
+}
+//# sourceMappingURL=useScopeMenuPolicy.js.map

package/dist/src/hooks/useScopeMenuPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScopeMenuPolicy.js","sourceRoot":"","sources":["../../../src/hooks/useScopeMenuPolicy.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks/useScopePermissions.d.ts

@@ -0,0 +1,9 @@
+interface ScopePermissionsOptions {
+    /** Set to false to skip permission resolution (e.g., null-scope guards). */
+    enabled?: boolean;
+    /** Current scope type so singleton scopes can resolve a stable scopeId. */
+    scope?: string | null;
+}
+export declare function useScopePermissions(options?: ScopePermissionsOptions): void;
+export {};
+//# sourceMappingURL=useScopePermissions.d.ts.map

package/dist/src/hooks/useScopePermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScopePermissions.d.ts","sourceRoot":"","sources":["../../../src/hooks/useScopePermissions.ts"],"names":[],"mappings":"AAuBA,UAAU,uBAAuB;IAC/B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAwE3E"}

package/dist/src/hooks/useScopePermissions.js

@@ -0,0 +1,84 @@
+/**
+ * Shared hook that resolves permissions for the current scope.
+ *
+ * Reads the active scope from `useScopeContext()`, gets the membership via
+ * `scopeApi.get`, resolves permissions via `permissionsApi.resolve`,
+ * and pushes the result into the
+ * shell-level permissions provider via `useSetCurrentPermissions()`.
+ *
+ * Called from UnifiedGuard's PostScopeSteps — runs immediately after
+ * scope validates so permissions are loaded before onboarding and
+ * permission gates check them downstream.
+ */
+import { useEffect } from "react";
+import { useQuery } from "@ydtb/tk-scope-query-client";
+import { scopeApi, permissionsApi } from "../lib/platform-api.js";
+import { useSetCurrentPermissions } from "../lib/permissions-store.js";
+import { useScopeContext } from "../contexts/scope/ScopeContext.js";
+import { useAppConfig } from "../contexts/config/AppConfigContext.js";
+import { useSetBackendUnreachable } from "../contexts/backend/BackendStatusContext.js";
+import { scopeHasUrlScopeId } from "@ydtb/tk-scope/client";
+import { isNetworkError } from "../lib/backend-status.js";
+export function useScopePermissions(options) {
+    const hookEnabled = options?.enabled ?? true;
+    const scope = options?.scope ?? null;
+    const { scopeId, entity } = useScopeContext();
+    const appConfig = useAppConfig();
+    const setCurrentPermissions = useSetCurrentPermissions();
+    const setBackendUnreachable = useSetBackendUnreachable();
+    const singletonScopeId = scope && !scopeHasUrlScopeId(scope) ? (appConfig.server?.rootSetup?.scopeId ?? scope) : null;
+    const effectiveScopeId = hookEnabled ? (scopeId ?? entity?.id ?? singletonScopeId) : null;
+    // Reset permissions immediately when scope changes
+    useEffect(() => {
+        if (!effectiveScopeId)
+            return;
+        setCurrentPermissions({
+            tier: "member",
+            effectivePermissions: [],
+            loaded: false,
+        });
+    }, [effectiveScopeId, setCurrentPermissions]);
+    // Step 1: Fetch scope + membership to get memberId
+    const { data: scopeData, isPending: accessPending } = useQuery({
+        ...scopeApi.get.queryOptions({ input: { scopeId: effectiveScopeId } }),
+        enabled: !!effectiveScopeId,
+    });
+    const memberId = scopeData?.membership?.id ?? "";
+    // Step 2: Resolve permissions for the member
+    const { data: resolved, isPending: permsPending, error, } = useQuery({
+        ...permissionsApi.resolve.queryOptions({
+            input: { memberId },
+        }),
+        enabled: !!memberId,
+    });
+    const isLoading = accessPending || (!!memberId && permsPending);
+    // Sync resolved permissions into the store
+    useEffect(() => {
+        if (!hookEnabled)
+            return;
+        if (isLoading)
+            return;
+        if (error) {
+            if (isNetworkError(error)) {
+                setBackendUnreachable(true);
+                return;
+            }
+            // Non-network error — set empty permissions
+            setCurrentPermissions({
+                tier: "member",
+                effectivePermissions: [],
+                loaded: true,
+            });
+            return;
+        }
+        if (!resolved)
+            return;
+        const data = resolved;
+        setCurrentPermissions({
+            tier: data.tier,
+            effectivePermissions: data.effectivePermissions,
+            loaded: true,
+        });
+    }, [hookEnabled, isLoading, resolved, error, setCurrentPermissions, setBackendUnreachable]);
+}
+//# sourceMappingURL=useScopePermissions.js.map

package/dist/src/hooks/useScopePermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScopePermissions.js","sourceRoot":"","sources":["../../../src/hooks/useScopePermissions.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/api-client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Anvil-compatible oRPC client factory.
+ *
+ * Replaces `createOrpcClient` from `@ydtb/compose/client` (old compose system).
+ * Uses `@ydtb/core-client` descriptors + `RPCLink` + `createORPCClient` to
+ * produce typed TanStack Query-integrated clients that match the Anvil server's
+ * `fromOrpc()` + `RPCHandler` wire format.
+ *
+ * Usage:
+ *   import { createToolClient } from '../lib/api-client.ts'
+ *   const contactsApi = createToolClient<ContactsRouter>('contacts')
+ *   // In components:
+ *   const { data } = useQuery(contactsApi.list.queryOptions({ input: { ... } }))
+ */
+import { configureApiClients } from "@ydtb/core-client";
+import type { AnyRouter, RouterClient } from "@orpc/server";
+export { configureApiClients };
+/**
+ * Create a typed oRPC client for a tool or platform router.
+ *
+ * The client is scope-aware (injects x-scope-id/x-scope-type headers)
+ * and produces TanStack Query integration (.queryOptions(), .mutationOptions()).
+ */
+export declare function createToolClient<TRouter extends AnyRouter>(toolId: string): import("@orpc/tanstack-query").RouterUtils<RouterClient<TRouter>> & {
+    $client: RouterClient<TRouter>;
+};
+//# sourceMappingURL=api-client.d.ts.map

package/dist/src/lib/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../src/lib/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAmB,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAIxE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3D,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAE9B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,SAAS,EAAE,MAAM,EAAE,MAAM,GAkBlE,oEAAoB;IAAE,OAAO,wBAAe;CAAE,CACrD"}

package/dist/src/lib/api-client.js

@@ -0,0 +1,45 @@
+/**
+ * Anvil-compatible oRPC client factory.
+ *
+ * Replaces `createOrpcClient` from `@ydtb/compose/client` (old compose system).
+ * Uses `@ydtb/core-client` descriptors + `RPCLink` + `createORPCClient` to
+ * produce typed TanStack Query-integrated clients that match the Anvil server's
+ * `fromOrpc()` + `RPCHandler` wire format.
+ *
+ * Usage:
+ *   import { createToolClient } from '../lib/api-client.ts'
+ *   const contactsApi = createToolClient<ContactsRouter>('contacts')
+ *   // In components:
+ *   const { data } = useQuery(contactsApi.list.queryOptions({ input: { ... } }))
+ */
+import { createApiClient, configureApiClients } from "@ydtb/core-client";
+import { RPCLink } from "@orpc/client/fetch";
+import { createORPCClient } from "@orpc/client";
+import { createTanstackQueryUtils } from "@orpc/tanstack-query";
+// Re-export configureApiClients so main.tsx only imports from this module
+export { configureApiClients };
+/**
+ * Create a typed oRPC client for a tool or platform router.
+ *
+ * The client is scope-aware (injects x-scope-id/x-scope-type headers)
+ * and produces TanStack Query integration (.queryOptions(), .mutationOptions()).
+ */
+export function createToolClient(toolId) {
+    const descriptor = createApiClient(toolId);
+    const link = new RPCLink({
+        url: descriptor.url,
+        headers: descriptor.headers,
+    });
+    const client = createORPCClient(link);
+    const queryUtils = createTanstackQueryUtils(client);
+    // Expose raw client as $client for imperative calls (fire-and-forget mutations etc.)
+    const $client = client;
+    return new Proxy(queryUtils, {
+        get(target, prop, receiver) {
+            if (prop === "$client")
+                return $client;
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+//# sourceMappingURL=api-client.js.map

package/dist/src/lib/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../src/lib/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAG/D,0EAA0E;AAC1E,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAE9B;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAA4B,MAAc;IACxE,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAE1C,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC;QACvB,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,gBAAgB,CAAwB,IAAI,CAAC,CAAA;IAC5D,MAAM,UAAU,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAEnD,qFAAqF;IACrF,MAAM,OAAO,GAAG,MAAM,CAAA;IACtB,OAAO,IAAI,KAAK,CAAC,UAAU,EAAE;QAC3B,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAA;YACtC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC5C,CAAC;KACF,CAAmD,CAAA;AACtD,CAAC"}

package/dist/src/lib/backend-status.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Backend-status helpers.
+ *
+ * Backend reachability state now lives in `BackendStatusProvider`, where
+ * permission resolution can update it through React context instead of a
+ * module-level pub-sub store. The only shared utility left here is the
+ * network-error detector used by that resolver.
+ */
+/**
+ * Checks if an error represents a network-level failure (backend unreachable).
+ * Does NOT match HTTP errors like 403, 404, 500 — only connection failures.
+ */
+export declare function isNetworkError(error: unknown): boolean;
+//# sourceMappingURL=backend-status.d.ts.map

package/dist/src/lib/backend-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-status.d.ts","sourceRoot":"","sources":["../../../src/lib/backend-status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgBtD"}

package/dist/src/lib/backend-status.js

@@ -0,0 +1,27 @@
+/**
+ * Backend-status helpers.
+ *
+ * Backend reachability state now lives in `BackendStatusProvider`, where
+ * permission resolution can update it through React context instead of a
+ * module-level pub-sub store. The only shared utility left here is the
+ * network-error detector used by that resolver.
+ */
+/**
+ * Checks if an error represents a network-level failure (backend unreachable).
+ * Does NOT match HTTP errors like 403, 404, 500 — only connection failures.
+ */
+export function isNetworkError(error) {
+    if (!error)
+        return false;
+    const message = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+    return (message.includes("fetch") ||
+        message.includes("network") ||
+        message.includes("aborted") ||
+        message.includes("connectionrefused") ||
+        message.includes("timedout") ||
+        message.includes("err_connection") ||
+        message.includes("failed to fetch") ||
+        message.includes("load failed") ||
+        message.includes("networkerror"));
+}
+//# sourceMappingURL=backend-status.js.map

package/dist/src/lib/backend-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-status.js","sourceRoot":"","sources":["../../../src/lib/backend-status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAExB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAElG,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CACjC,CAAA;AACH,CAAC"}