@ydtb/tk-scope-app 0.14.7

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-api.d.ts","sourceRoot":"","sources":["../../../src/lib/platform-api.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuBk8J,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAgrF,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyrD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA8uD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAvBxha,CAAA;AAC9D,eAAO,MAAM,UAAU;;;;;;;;;;;;kBAJL,CAAC;;;;;;;;;;;;;;mBAWZ,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAegxE,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA4oG,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAqrD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAyrD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAw7D,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA0yD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA2yD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA4uD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAgoE,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAmxD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAtB77xB,CAAA;AACpE,eAAO,MAAM,QAAQ;;;;;;;;;;;;kBALmB,CAAC;;;;;;;;;;;;;;mBAWb,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAegxE,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA85G,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA8pH,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAoxH,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAurD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAm8F,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA6yD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EArB5iuB,CAAA;AAC9D,eAAO,MAAM,cAAc;;;;;;;;;;;;kBAKF,CAAC;;;;;;;;;;;;;;mBAUA,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK4zG,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAAyiH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;aAAkqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAmwD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA8rD,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EApBn7Y,CAAA;AAChF,eAAO,MAAM,YAAY;;;;;;;;;;;;kBAFiB,CAAC;;;;;;;;;;;;;;mBAUtB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWy6D,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA8gI,CAAC;;;;;;;;;;;;;;mBAAwgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAnBt5N,CAAA;AAG3E,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAuC,CAAA;AAC3D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA+C,CAAA;AACvE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAcsM,CAAC;;;;;;;;;;;;;;mBAAghB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAo5D,CAAC;;;;;;;;;;;;;;mBAAghB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAkxD,CAAC;;;;;;;;;;;;;;mBAAghB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAd72K,CAAA;AAChF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;kBAdxB,CAAC;;;;;;;;;;;;;;mBAWiB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgB+7C,CAAC;;;;;;;;;;;;;;mBAAghB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA0yE,CAAC;;;;;;;;;;;;;;mBAAghB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAb9sJ,CAAA;AAGtF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAmD,CAAA;AAC7E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqD,CAAA;AAIhF,eAAO,MAAM,SAAS;;;;;;;;;;;;kBAxBL,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6BuQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAA+lD,CAAC;;;;;;;;;;;;;;;;;;;;;;EALzzD,CAAA;AAIjE,eAAO,MAAM,SAAS;;EAAwC,CAAA"}

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

@@ -0,0 +1,26 @@
+/**
+ * Typed oRPC clients for platform infrastructure routers.
+ *
+ * Uses @ydtb/api-client for the client factory and imports router types
+ * from client-safe /types paths.
+ */
+import { createToolClient } from "@ydtb/tk-scope-api-client";
+// Scope extension routers
+export const scopeApi = createToolClient("scope");
+export const membersApi = createToolClient("members");
+export const rolesApi = createToolClient("roles");
+export const invitationsApi = createToolClient("invitations");
+export const joinCodesApi = createToolClient("join-codes");
+// Platform routers
+export const userApi = createToolClient("user");
+export const platformApi = createToolClient("platform");
+export const permissionsApi = createToolClient("permissions");
+export const scopeChildrenApi = createToolClient("scopeChildren");
+// Onboarding extension
+export const onboardingApi = createToolClient("onboarding");
+export const preferencesApi = createToolClient("preferences");
+export const searchApi = createToolClient("search");
+// Tokens extension — no concrete oRPC router yet, so expose the widest router
+// surface the client factory accepts until the tokens router exists.
+export const tokensApi = createToolClient("tokens");
+//# sourceMappingURL=platform-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform-api.js","sourceRoot":"","sources":["../../../src/lib/platform-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAkB5D,0BAA0B;AAC1B,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAc,OAAO,CAAC,CAAA;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAgB,SAAS,CAAC,CAAA;AACpE,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAc,OAAO,CAAC,CAAA;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAoB,aAAa,CAAC,CAAA;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAkB,YAAY,CAAC,CAAA;AAE3E,mBAAmB;AACnB,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAa,MAAM,CAAC,CAAA;AAC3D,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAiB,UAAU,CAAC,CAAA;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAoB,aAAa,CAAC,CAAA;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAsB,eAAe,CAAC,CAAA;AAEtF,uBAAuB;AACvB,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAmB,YAAY,CAAC,CAAA;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAoB,aAAa,CAAC,CAAA;AAIhF,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAe,QAAQ,CAAC,CAAA;AAEjE,8EAA8E;AAC9E,qEAAqE;AACrE,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAY,QAAQ,CAAC,CAAA"}

package/dist/src/lib/resolve-redirect.d.ts

@@ -0,0 +1,36 @@
+import { type ScopeTypeInfo } from "@ydtb/tk-scope/client";
+export interface LastVisitedScope {
+    scopeId: string;
+    scopeType: string;
+}
+export declare function getLastVisitedScope(): LastVisitedScope | null;
+export declare function saveLastVisitedScope(scopeId: string, scopeType: string): void;
+export interface Membership {
+    type: string;
+    id: string;
+    name: string;
+}
+export interface ResolveRedirectOptions {
+    /** Deep link URL from ?redirect= query param */
+    deepLink?: string;
+    /** Last visited scope from localStorage or server-side lastActiveContext */
+    lastVisited?: {
+        scopeId: string;
+        scopeType: string;
+    };
+    /** Current path (unused for now, reserved for future logic) */
+    currentPath?: string;
+}
+/**
+ * Pure redirect resolver that replaces PostLoginRedirect, ScopedRedirect,
+ * and /select-context decision logic.
+ *
+ * Decision tree:
+ * 1. Deep link (?redirect=) → validate access → go there or fall through
+ * 2. No memberships → /get-started
+ * 3. Single membership → scope dashboard via scopeLink()
+ * 4. Multiple same-type memberships → scope picker for that type
+ * 5. Multiple different types → lastVisited (if valid) → /select-context
+ */
+export declare function resolveRedirect(memberships: Membership[], scopeConfigs: readonly ScopeTypeInfo[], options?: ResolveRedirectOptions): string;
+//# sourceMappingURL=resolve-redirect.d.ts.map

package/dist/src/lib/resolve-redirect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-redirect.d.ts","sourceRoot":"","sources":["../../../src/lib/resolve-redirect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAkC,MAAM,uBAAuB,CAAA;AAQ1F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAU7D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAM7E;AAMD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACpD,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,UAAU,EAAE,EACzB,YAAY,EAAE,SAAS,aAAa,EAAE,EACtC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CA2DR"}

package/dist/src/lib/resolve-redirect.js

@@ -0,0 +1,91 @@
+import { scopeLink, detectScopeFromPath } from "@ydtb/tk-scope/client";
+// ---------------------------------------------------------------------------
+// localStorage helpers (internalized from lastVisitedScope.ts)
+// ---------------------------------------------------------------------------
+const STORAGE_KEY = "ydtb:lastVisitedScope";
+export function getLastVisitedScope() {
+    try {
+        const raw = localStorage.getItem(STORAGE_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        if (parsed?.scopeId && parsed?.scopeType)
+            return parsed;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveLastVisitedScope(scopeId, scopeType) {
+    try {
+        localStorage.setItem(STORAGE_KEY, JSON.stringify({ scopeId, scopeType }));
+    }
+    catch {
+        // localStorage unavailable — silently ignore
+    }
+}
+// ---------------------------------------------------------------------------
+// resolveRedirect()
+// ---------------------------------------------------------------------------
+/**
+ * Pure redirect resolver that replaces PostLoginRedirect, ScopedRedirect,
+ * and /select-context decision logic.
+ *
+ * Decision tree:
+ * 1. Deep link (?redirect=) → validate access → go there or fall through
+ * 2. No memberships → /get-started
+ * 3. Single membership → scope dashboard via scopeLink()
+ * 4. Multiple same-type memberships → scope picker for that type
+ * 5. Multiple different types → lastVisited (if valid) → /select-context
+ */
+export function resolveRedirect(memberships, scopeConfigs, options) {
+    const { deepLink, lastVisited } = options ?? {};
+    // Build a map of known scope type IDs → config for validation and defaultRoute lookup
+    const knownScopes = new Set(scopeConfigs.map((c) => c.type));
+    const configByType = new Map(scopeConfigs.map((c) => [c.type, c]));
+    // 1. Deep link → validate the user has access to that scope
+    if (deepLink) {
+        const detected = detectScopeFromPath(deepLink);
+        if (detected && knownScopes.has(detected.scope)) {
+            const hasAccess = memberships.some((m) => m.type === detected.scope && (!detected.scopeId || m.id === detected.scopeId));
+            if (hasAccess)
+                return deepLink;
+        }
+        // Deep link invalid or no access — fall through
+    }
+    // 2. No memberships → get-started page
+    if (memberships.length === 0) {
+        return "/get-started";
+    }
+    // 3. Single membership → go to the scope's configured default route
+    if (memberships.length === 1) {
+        const m = memberships[0];
+        if (m) {
+            const defaultRoute = configByType.get(m.type)?.defaultRoute ?? "/";
+            return scopeLink(defaultRoute, { scope: m.type, scopeId: m.id });
+        }
+    }
+    // 4+5. Multiple memberships
+    const types = new Set(memberships.map((m) => m.type));
+    if (types.size === 1) {
+        // 4. All same type → scope picker filtered to that type
+        const first = memberships[0];
+        if (first) {
+            return `/select-context?type=${first.type}`;
+        }
+    }
+    // 5. Multiple different types → try lastVisited, then fall back
+    if (lastVisited) {
+        const exists = memberships.some((m) => m.id === lastVisited.scopeId && m.type === lastVisited.scopeType);
+        if (exists) {
+            const defaultRoute = configByType.get(lastVisited.scopeType)?.defaultRoute ?? "/";
+            return scopeLink(defaultRoute, {
+                scope: lastVisited.scopeType,
+                scopeId: lastVisited.scopeId,
+            });
+        }
+    }
+    return "/select-context";
+}
+//# sourceMappingURL=resolve-redirect.js.map

package/dist/src/lib/resolve-redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-redirect.js","sourceRoot":"","sources":["../../../src/lib/resolve-redirect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,SAAS,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE1F,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E,MAAM,WAAW,GAAG,uBAAuB,CAAA;AAO3C,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAC7C,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAA;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC9B,IAAI,MAAM,EAAE,OAAO,IAAI,MAAM,EAAE,SAAS;YAAE,OAAO,MAA0B,CAAA;QAC3E,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,SAAiB;IACrE,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;AACH,CAAC;AAqBD,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAyB,EACzB,YAAsC,EACtC,OAAgC;IAEhC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,IAAI,EAAE,CAAA;IAE/C,sFAAsF;IACtF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAC5D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAElE,4DAA4D;IAC5D,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAA;QAC9C,IAAI,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,OAAO,CAAC,CACrF,CAAA;YACD,IAAI,SAAS;gBAAE,OAAO,QAAQ,CAAA;QAChC,CAAC;QACD,gDAAgD;IAClD,CAAC;IAED,uCAAuC;IACvC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,oEAAoE;IACpE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;QACxB,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,YAAY,IAAI,GAAG,CAAA;YAClE,OAAO,SAAS,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAErD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrB,wDAAwD;QACxD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;QAC5B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,wBAAwB,KAAK,CAAC,IAAI,EAAE,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,SAAS,CACxE,CAAA;QACD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,YAAY,IAAI,GAAG,CAAA;YACjF,OAAO,SAAS,CAAC,YAAY,EAAE;gBAC7B,KAAK,EAAE,WAAW,CAAC,SAAS;gBAC5B,OAAO,EAAE,WAAW,CAAC,OAAO;aAC7B,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,iBAAiB,CAAA;AAC1B,CAAC"}

package/dist/src/lib/scope-menu-policy.d.ts

@@ -0,0 +1,13 @@
+import type { ScopeMenuMode } from "@ydtb/tk-scope/client";
+export interface ScopeMenuVisibilityInput {
+    mode: ScopeMenuMode;
+    canSwitchScopes: boolean;
+    hasSwitchTarget: boolean;
+    canViewChildScopes: boolean;
+    hasChildScopes: boolean;
+    canCreateChildScopes: boolean;
+    hasCreateChildAction: boolean;
+}
+export declare function getScopeMenuVisibility({ mode, canSwitchScopes, hasSwitchTarget, canViewChildScopes, hasChildScopes, canCreateChildScopes, hasCreateChildAction, }: ScopeMenuVisibilityInput): boolean;
+export declare function canCreateChildScopeAction(selfCreate: string | boolean | undefined, hasChildScopeType: boolean): boolean;
+//# sourceMappingURL=scope-menu-policy.d.ts.map

package/dist/src/lib/scope-menu-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-menu-policy.d.ts","sourceRoot":"","sources":["../../../src/lib/scope-menu-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAA;IACnB,eAAe,EAAE,OAAO,CAAA;IACxB,eAAe,EAAE,OAAO,CAAA;IACxB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,cAAc,EAAE,OAAO,CAAA;IACvB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,oBAAoB,EAAE,OAAO,CAAA;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,EACrC,IAAI,EACJ,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACrB,EAAE,wBAAwB,GAAG,OAAO,CASpC;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACxC,iBAAiB,EAAE,OAAO,GACzB,OAAO,CAGT"}

package/dist/src/lib/scope-menu-policy.js

@@ -0,0 +1,15 @@
+export function getScopeMenuVisibility({ mode, canSwitchScopes, hasSwitchTarget, canViewChildScopes, hasChildScopes, canCreateChildScopes, hasCreateChildAction, }) {
+    if (mode === "hidden")
+        return false;
+    if (mode === "always")
+        return true;
+    return ((canSwitchScopes && hasSwitchTarget) ||
+        (canViewChildScopes && hasChildScopes) ||
+        (canCreateChildScopes && hasCreateChildAction));
+}
+export function canCreateChildScopeAction(selfCreate, hasChildScopeType) {
+    if (!hasChildScopeType)
+        return false;
+    return selfCreate !== false && selfCreate !== "initial";
+}
+//# sourceMappingURL=scope-menu-policy.js.map

package/dist/src/lib/scope-menu-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-menu-policy.js","sourceRoot":"","sources":["../../../src/lib/scope-menu-policy.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,sBAAsB,CAAC,EACrC,IAAI,EACJ,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,GACK;IACzB,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IACnC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAElC,OAAO,CACL,CAAC,eAAe,IAAI,eAAe,CAAC;QACpC,CAAC,kBAAkB,IAAI,cAAc,CAAC;QACtC,CAAC,oBAAoB,IAAI,oBAAoB,CAAC,CAC/C,CAAA;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,UAAwC,EACxC,iBAA0B;IAE1B,IAAI,CAAC,iBAAiB;QAAE,OAAO,KAAK,CAAA;IACpC,OAAO,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,SAAS,CAAA;AACzD,CAAC"}

package/dist/src/lib/scope-query-keys.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Centralized query key factory for auth/scope operations.
+ *
+ * These queries use the better-auth SDK client (not oRPC), so there are
+ * no auto-generated query keys. This factory prevents key duplication
+ * and makes cache invalidation reliable.
+ *
+ * Usage:
+ *   import { scopeQueryKeys } from '@ydtb/app'
+ *   queryKey: scopeQueryKeys.entity(scopeId)
+ *   queryClient.invalidateQueries({ queryKey: scopeQueryKeys.list(scopeType) })
+ */
+export declare const scopeQueryKeys: {
+    /** Fetch a single scope entity by ID */
+    readonly entity: (scopeId: string | null) => readonly ["scope-entity", string | null];
+    /** Check access (membership) for a scope */
+    readonly checkAccess: (scopeId: string) => readonly ["scope", "checkAccess", string];
+    /** List all scopes the user belongs to (no type filter) */
+    readonly all: () => readonly ["scopes"];
+    /** List scopes by type */
+    readonly list: (scopeType: string) => readonly ["scope-list", string];
+    /** Scope switcher list (by type) */
+    readonly switcher: (scopeType: string) => readonly ["scope-switcher", string];
+    /** Invitations base key — use for broad invalidation */
+    readonly invitationsBase: () => readonly ["scope", "invitations"];
+    /** Invitations for a specific scope */
+    readonly invitations: (scopeId: string, status?: string) => readonly ["scope", "invitations", string, string];
+    /** Invitations by scope type (profile section) */
+    readonly invitationsByType: (scopeType: string) => readonly ["scope-invitations", string];
+    /** Portal scopes list */
+    readonly portalScopes: () => readonly ["portal-scopes"];
+    /** API keys list for a scope */
+    readonly apiKeys: (scope: string, scopeId: string) => readonly ["apiKeys", "list", {
+        readonly scope: string;
+        readonly scopeId: string;
+    }];
+};
+//# sourceMappingURL=scope-query-keys.d.ts.map

package/dist/src/lib/scope-query-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-query-keys.d.ts","sourceRoot":"","sources":["../../../src/lib/scope-query-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,cAAc;IACzB,wCAAwC;+BACtB,MAAM,GAAG,IAAI;IAE/B,4CAA4C;oCACrB,MAAM;IAE7B,2DAA2D;;IAG3D,0BAA0B;+BACR,MAAM;IAExB,oCAAoC;mCACd,MAAM;IAE5B,wDAAwD;;IAGxD,uCAAuC;oCAChB,MAAM,WAAW,MAAM;IAG9C,kDAAkD;4CACnB,MAAM;IAErC,yBAAyB;;IAGzB,gCAAgC;8BACf,MAAM,WAAW,MAAM;;;;CAChC,CAAA"}

package/dist/src/lib/scope-query-keys.js

@@ -0,0 +1,35 @@
+/**
+ * Centralized query key factory for auth/scope operations.
+ *
+ * These queries use the better-auth SDK client (not oRPC), so there are
+ * no auto-generated query keys. This factory prevents key duplication
+ * and makes cache invalidation reliable.
+ *
+ * Usage:
+ *   import { scopeQueryKeys } from '@ydtb/app'
+ *   queryKey: scopeQueryKeys.entity(scopeId)
+ *   queryClient.invalidateQueries({ queryKey: scopeQueryKeys.list(scopeType) })
+ */
+export const scopeQueryKeys = {
+    /** Fetch a single scope entity by ID */
+    entity: (scopeId) => ["scope-entity", scopeId],
+    /** Check access (membership) for a scope */
+    checkAccess: (scopeId) => ["scope", "checkAccess", scopeId],
+    /** List all scopes the user belongs to (no type filter) */
+    all: () => ["scopes"],
+    /** List scopes by type */
+    list: (scopeType) => ["scope-list", scopeType],
+    /** Scope switcher list (by type) */
+    switcher: (scopeType) => ["scope-switcher", scopeType],
+    /** Invitations base key — use for broad invalidation */
+    invitationsBase: () => ["scope", "invitations"],
+    /** Invitations for a specific scope */
+    invitations: (scopeId, status) => ["scope", "invitations", scopeId, status ?? "all"],
+    /** Invitations by scope type (profile section) */
+    invitationsByType: (scopeType) => ["scope-invitations", scopeType],
+    /** Portal scopes list */
+    portalScopes: () => ["portal-scopes"],
+    /** API keys list for a scope */
+    apiKeys: (scope, scopeId) => ["apiKeys", "list", { scope, scopeId }],
+};
+//# sourceMappingURL=scope-query-keys.js.map

package/dist/src/lib/scope-query-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-query-keys.js","sourceRoot":"","sources":["../../../src/lib/scope-query-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,wCAAwC;IACxC,MAAM,EAAE,CAAC,OAAsB,EAAE,EAAE,CAAC,CAAC,cAAc,EAAE,OAAO,CAAU;IAEtE,4CAA4C;IAC5C,WAAW,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAU;IAE5E,2DAA2D;IAC3D,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAU;IAE9B,0BAA0B;IAC1B,IAAI,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,YAAY,EAAE,SAAS,CAAU;IAE/D,oCAAoC;IACpC,QAAQ,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,gBAAgB,EAAE,SAAS,CAAU;IAEvE,wDAAwD;IACxD,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,CAAU;IAExD,uCAAuC;IACvC,WAAW,EAAE,CAAC,OAAe,EAAE,MAAe,EAAE,EAAE,CAChD,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,IAAI,KAAK,CAAU;IAE7D,kDAAkD;IAClD,iBAAiB,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,mBAAmB,EAAE,SAAS,CAAU;IAEnF,yBAAyB;IACzB,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,eAAe,CAAU;IAE9C,gCAAgC;IAChC,OAAO,EAAE,CAAC,KAAa,EAAE,OAAe,EAAE,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAU;CACrF,CAAA"}

package/dist/src/lib/scopeLink.d.ts

@@ -0,0 +1,24 @@
+import { scopeLink, detectScopeFromPath, getUrlPrefixes } from "@ydtb/tk-scope/client";
+export { scopeLink, detectScopeFromPath, getUrlPrefixes };
+export interface ScopeLinkOptions {
+    /** Which scope to target. Defaults to auto-detection. */
+    scope?: string;
+    /** Explicit scope ID to use. Defaults to current context. */
+    scopeId?: string;
+}
+/**
+ * React hook that returns a scoped link builder bound to the current scope context.
+ *
+ * Usage:
+ *   const sl = useScopeLink()
+ *   <Link to={sl('/offers')}>Offers</Link>
+ *   navigate({ to: sl('/team/members') })
+ *
+ * The returned function automatically detects the current scope from the URL
+ * ($scopeId param) and ScopeContext.
+ *
+ * You can override the scope/scopeId for cross-scope navigation:
+ *   sl('/dashboard', { scope: 'parent', scopeId: parentScopeId })
+ */
+export declare function useScopeLink(): (path: string, opts?: ScopeLinkOptions) => string;
+//# sourceMappingURL=scopeLink.d.ts.map

package/dist/src/lib/scopeLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeLink.d.ts","sourceRoot":"","sources":["../../../src/lib/scopeLink.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAItF,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,cAAc,EAAE,CAAA;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,KAAK,MAAM,CA2ChF"}

package/dist/src/lib/scopeLink.js

@@ -0,0 +1,57 @@
+import { useParams } from "@tanstack/react-router";
+import { scopeLink, detectScopeFromPath, getUrlPrefixes } from "@ydtb/tk-scope/client";
+import { useScopeId } from "../contexts/scope/ScopeContext.js";
+// Re-export pure functions from tk-scope canonical source
+export { scopeLink, detectScopeFromPath, getUrlPrefixes };
+/**
+ * React hook that returns a scoped link builder bound to the current scope context.
+ *
+ * Usage:
+ *   const sl = useScopeLink()
+ *   <Link to={sl('/offers')}>Offers</Link>
+ *   navigate({ to: sl('/team/members') })
+ *
+ * The returned function automatically detects the current scope from the URL
+ * ($scopeId param) and ScopeContext.
+ *
+ * You can override the scope/scopeId for cross-scope navigation:
+ *   sl('/dashboard', { scope: 'parent', scopeId: parentScopeId })
+ */
+export function useScopeLink() {
+    // Get scopeId from URL params for scopes whose URL prefix includes $scopeId.
+    const params = useParams({ strict: false });
+    // Context fallbacks: if not in a scoped route, use context-based IDs
+    const contextScopeId = useScopeId();
+    // Detect current scope from URL pathname
+    const urlScopeId = params.scopeId;
+    return (path, opts) => {
+        // If explicit scope is provided, use it directly
+        if (opts?.scope) {
+            return scopeLink(path, {
+                scope: opts.scope,
+                scopeId: opts.scopeId,
+            });
+        }
+        // Auto-detect current scope from URL
+        const currentPath = typeof window !== "undefined" ? window.location.pathname : "/";
+        const detected = detectScopeFromPath(currentPath);
+        if (detected) {
+            return scopeLink(path, {
+                scope: detected.scope,
+                scopeId: opts?.scopeId ?? urlScopeId ?? contextScopeId ?? undefined,
+            });
+        }
+        // Fallback: try to build a scoped link with first available scope
+        // that has a scopeId pattern
+        const prefixes = getUrlPrefixes();
+        const scopedEntry = Object.entries(prefixes).find(([, p]) => p.includes("$scopeId"));
+        if (scopedEntry) {
+            return scopeLink(path, {
+                scope: scopedEntry[0],
+                scopeId: opts?.scopeId ?? urlScopeId ?? contextScopeId ?? undefined,
+            });
+        }
+        return path;
+    };
+}
+//# sourceMappingURL=scopeLink.js.map

package/dist/src/lib/scopeLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeLink.js","sourceRoot":"","sources":["../../../src/lib/scopeLink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAoC,CAAA;AAE/D,0DAA0D;AAC1D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,cAAc,EAAE,CAAA;AASzD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY;IAC1B,6EAA6E;IAC7E,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAyB,CAAA;IAEnE,qEAAqE;IACrE,MAAM,cAAc,GAAG,UAAU,EAAE,CAAA;IAEnC,yCAAyC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAA;IAEjC,OAAO,CAAC,IAAY,EAAE,IAAuB,EAAE,EAAE;QAC/C,iDAAiD;QACjD,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC,IAAI,EAAE;gBACrB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAA;QACJ,CAAC;QAED,qCAAqC;QACrC,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAA;QAClF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAA;QAEjD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,IAAI,EAAE;gBACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,UAAU,IAAI,cAAc,IAAI,SAAS;aACpE,CAAC,CAAA;QACJ,CAAC;QAED,kEAAkE;QAClE,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAA;QACjC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;QACpF,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC,IAAI,EAAE;gBACrB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;gBACrB,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,UAAU,IAAI,cAAc,IAAI,SAAS;aACpE,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;AACH,CAAC"}

package/dist/src/lib/tool-api-types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Lightweight API interfaces for tool APIs consumed by the platform shell.
+ *
+ * The platform shell doesn't import typed routers from specific tools
+ * to avoid coupling. These interfaces define the minimum query/mutation
+ * shapes needed for type-safe usage without `as any` casts.
+ *
+ * We define the *client-side* shape (what createToolClient returns after
+ * oRPC's TanStack Query integration wraps the router) rather than the
+ * router type itself, because our lightweight interfaces can't satisfy
+ * oRPC's AnyRouter constraint.
+ */
+import { type ToolClient } from "@ydtb/tk-scope-api-client";
+import type { DashboardRouter } from "@ydtb/tk-scope-dashboard/api/router";
+import type { NotificationsRouter } from "@ydtb/tk-scope-notifications/api/router";
+type DashboardApiClient = ToolClient<DashboardRouter>;
+type NotificationsApiClient = ToolClient<NotificationsRouter>;
+/** Rail item returned by dashboard.listRail */
+export type DashboardRailItem = Awaited<ReturnType<DashboardApiClient["$client"]["listRail"]>>[number];
+/** Client-side shape for the dashboard tool API. */
+export type DashboardToolClient = Pick<ToolClient<DashboardRouter>, "listRail">;
+export declare function createDashboardClient(): DashboardToolClient;
+/** A single notification item. */
+export type NotificationItem = Awaited<ReturnType<NotificationsApiClient["$client"]["list"]>>["data"][number];
+/** Client-side shape for the notifications tool API (panel usage). */
+export type NotificationsToolClient = Pick<ToolClient<NotificationsRouter>, "list" | "unreadCount" | "markRead" | "markAllRead" | "key">;
+export declare function createNotificationsClient(): NotificationsToolClient;
+/** Notification provider group returned by notifications.getProviders. */
+export type NotificationProviderGroup = Awaited<ReturnType<NotificationsApiClient["$client"]["getProviders"]>>[number];
+/** Flattened event provider descriptor used by the profile page UI. */
+export type NotificationProvider = NotificationProviderGroup["events"][number];
+/** Per-event/channel preference. */
+export type NotificationPreference = Awaited<ReturnType<NotificationsApiClient["$client"]["getPreferences"]>>[number];
+/** Entity subscription. */
+export type NotificationSubscription = Awaited<ReturnType<NotificationsApiClient["$client"]["listSubscriptions"]>>[number];
+/** Client-side shape for notification preferences (profile page). */
+export type NotificationPreferencesClient = Pick<ToolClient<NotificationsRouter>, "getProviders" | "getPreferences" | "setPreference" | "listSubscriptions" | "unsubscribe">;
+export declare function createNotificationPreferencesClient(): NotificationPreferencesClient;
+export {};
+//# sourceMappingURL=tool-api-types.d.ts.map

package/dist/src/lib/tool-api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-api-types.d.ts","sourceRoot":"","sources":["../../../src/lib/tool-api-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAElF,KAAK,kBAAkB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAA;AACrD,KAAK,sBAAsB,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAI7D,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtG,oDAAoD;AACpD,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC,CAAA;AAE/E,wBAAgB,qBAAqB,IAAI,mBAAmB,CAE3D;AAID,kCAAkC;AAClC,MAAM,MAAM,gBAAgB,GAAG,OAAO,CACpC,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CACtD,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAEjB,sEAAsE;AACtE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,UAAU,CAAC,mBAAmB,CAAC,EAC/B,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,aAAa,GAAG,KAAK,CAC5D,CAAA;AAED,wBAAgB,yBAAyB,IAAI,uBAAuB,CAEnE;AAID,0EAA0E;AAC1E,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAC7C,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC,CAC9D,CAAC,MAAM,CAAC,CAAA;AAET,uEAAuE;AACvE,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9E,oCAAoC;AACpC,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAChE,CAAC,MAAM,CAAC,CAAA;AAET,2BAA2B;AAC3B,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,UAAU,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC,CACnE,CAAC,MAAM,CAAC,CAAA;AAET,qEAAqE;AACrE,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,UAAU,CAAC,mBAAmB,CAAC,EAC/B,cAAc,GAAG,gBAAgB,GAAG,eAAe,GAAG,mBAAmB,GAAG,aAAa,CAC1F,CAAA;AAED,wBAAgB,mCAAmC,IAAI,6BAA6B,CAEnF"}

package/dist/src/lib/tool-api-types.js

@@ -0,0 +1,23 @@
+/**
+ * Lightweight API interfaces for tool APIs consumed by the platform shell.
+ *
+ * The platform shell doesn't import typed routers from specific tools
+ * to avoid coupling. These interfaces define the minimum query/mutation
+ * shapes needed for type-safe usage without `as any` casts.
+ *
+ * We define the *client-side* shape (what createToolClient returns after
+ * oRPC's TanStack Query integration wraps the router) rather than the
+ * router type itself, because our lightweight interfaces can't satisfy
+ * oRPC's AnyRouter constraint.
+ */
+import { createToolClient } from "@ydtb/tk-scope-api-client";
+export function createDashboardClient() {
+    return createToolClient("dashboard");
+}
+export function createNotificationsClient() {
+    return createToolClient("notifications");
+}
+export function createNotificationPreferencesClient() {
+    return createToolClient("notifications");
+}
+//# sourceMappingURL=tool-api-types.js.map

package/dist/src/lib/tool-api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-api-types.js","sourceRoot":"","sources":["../../../src/lib/tool-api-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAmB,MAAM,2BAA2B,CAAA;AAe7E,MAAM,UAAU,qBAAqB;IACnC,OAAO,gBAAgB,CAAkB,WAAW,CAAC,CAAA;AACvD,CAAC;AAeD,MAAM,UAAU,yBAAyB;IACvC,OAAO,gBAAgB,CAAsB,eAAe,CAAC,CAAA;AAC/D,CAAC;AA4BD,MAAM,UAAU,mCAAmC;IACjD,OAAO,gBAAgB,CAAsB,eAAe,CAAC,CAAA;AAC/D,CAAC"}

package/dist/src/lib/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * App-owned type definitions — replaces type-only imports from @ydtb/plugin-sdk.
+ *
+ * These are simple interfaces that the YDTB app owns. They were previously
+ * imported from plugin-sdk but are now inlined here to remove the dependency.
+ *
+ * @see migration/audit/AUDIT_003_post-m7-pre-m8-gate.md — Category B remediation
+ */
+import type { ComponentType } from "react";
+export interface StepProps {
+    onNext: () => void;
+    onBack?: () => void;
+    stepIndex?: number;
+    totalSteps?: number;
+}
+export type StepPriority = "required" | "suggested";
+export type StepGate = "scope" | "tool";
+export interface OnboardingStepDefinition {
+    /** Unique step identifier */
+    id: string;
+    /** React component to render for this step */
+    component: ComponentType<StepProps>;
+    /** Sort order — lower numbers render first */
+    order: number;
+    /** Step IDs that must display/resolve before this one */
+    dependsOn?: string[];
+    /** Optional context key to scope when this step appears */
+    context?: string;
+    /** Whether this step tracks completion per-user or per-scope */
+    level?: "scope" | "user";
+    /** Optional predicate — return false to skip this step */
+    condition?: (ctx: {
+        previouslyCompletedSteps: string[];
+        wizardMetadata: Record<string, unknown>;
+        scope: string;
+        scopeId: string;
+        userId: string;
+    }) => boolean;
+    /** Runs during the resolve step to perform side-effects */
+    resolve?: (metadata: Record<string, unknown>) => Promise<Record<string, unknown> | void>;
+    /** Step priority — required steps block progress, suggested steps can be skipped */
+    priority?: StepPriority;
+    /** Gate type — scope gates block shell access, tool gates block tool access */
+    gate?: StepGate;
+    /** Tool that owns this step (for tool-gated steps) */
+    toolId?: string;
+    /** Human-readable label */
+    label?: string;
+    /** Human-readable description */
+    description?: string;
+    /** Icon identifier */
+    icon?: string;
+    /** URL to navigate to for this step */
+    href?: string;
+    /** URL to navigate to after step is completed */
+    completedHref?: string;
+    /** Label to show after step is completed */
+    completedLabel?: string;
+}
+export type OnboardingStepsByScope = Partial<Record<string, OnboardingStepDefinition[]>>;
+declare module "@ydtb/tk-scope/core" {
+    interface ClientContributions {
+        onboarding?: {
+            stepsByScope?: OnboardingStepsByScope;
+        };
+    }
+}
+export interface AuthResult {
+    success: boolean;
+    error?: string;
+    /** Optional user/session data returned on successful auth */
+    data?: Record<string, unknown>;
+}
+export interface BrandingConfig {
+    /** Business or scope name */
+    name?: string;
+    /** URL to logo image */
+    logoUrl?: string | null;
+    /** Primary brand color (CSS value) */
+    primaryColor?: string;
+    /** Powered-by footer text */
+    poweredByText?: string | null;
+}
+export interface AuthComponentProps {
+    /** Callback to submit credentials for validation */
+    onAuthenticate: (credentials: unknown) => Promise<AuthResult>;
+    /** Branding configuration for visual customization */
+    branding: BrandingConfig;
+    /** Error message to display */
+    error: string | null;
+    /** Whether authentication is in progress */
+    loading: boolean;
+}
+export interface GuardConfig {
+    auth: "session" | "pin" | "device" | "none" | string;
+    scope: string | null;
+    permissions: "auto" | "none";
+    onboarding: boolean;
+}
+/** Public routes — no auth, no scope, no permissions, no onboarding. */
+declare function publicGuard(): GuardConfig;
+/** Auth shell routes (login/signup) — no gates applied. */
+declare function authOnly(): GuardConfig;
+/** Authenticated routes — session required, but no scope or permissions. */
+declare function authenticated(): GuardConfig;
+/** Scoped routes — session + scope resolution, but no permission checks or onboarding. */
+declare function scoped(type: string): GuardConfig;
+/** Fully guarded routes — session + scope + auto permissions + onboarding. */
+declare function guarded(type: string): GuardConfig;
+/** Custom auth strategy with optional scope. */
+declare function custom(strategy: string, type?: string): GuardConfig;
+/** Guard preset functions for declarative route shell configuration. */
+export declare const guardPresets: {
+    readonly public: typeof publicGuard;
+    readonly authOnly: typeof authOnly;
+    readonly authenticated: typeof authenticated;
+    readonly scoped: typeof scoped;
+    readonly guarded: typeof guarded;
+    readonly custom: typeof custom;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/lib/types.d.ts.map

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