@makinbakin/sdk 0.0.1-rc.20 → 0.0.1-rc.21

package/hooks/index.d.ts

@@ -5,6 +5,17 @@
  *   1. Bakin-wide hooks from `src/hooks/*` (SSE, search, query-state, debug, etc.)
  *   2. Cross-plugin hooks from `plugins/team/hooks/*` (agent data)
  *   3. Cross-plugin hooks from `plugins/workflows/hooks/*` (notification channels)
+ *
+ * DELIBERATE ARRANGEMENT (audit P2 #5, decided 2026-07 in FW3): groups 2-3
+ * reach into plugin source on purpose. Each hook's wire contract (the
+ * `/api/plugins/<id>/...` routes it fetches) is owned by its plugin, so the
+ * implementation lives WITH that contract; the SDK re-export exists so
+ * external authors get one import surface. The npm publish build BUNDLES
+ * these sources into the package and `assertNoForbiddenImports`
+ * (scripts/build-sdk-package.ts) fails the release if any `@bakin/*`
+ * specifier survives — the published SDK is self-contained. Moving the
+ * implementations into the SDK would decouple them from the routes they
+ * call, which is the worse drift.
  */
 /** Access the global Zustand store for SSE-driven content state. */
 export { useContentStore } from '../_internal/app/hooks/use-content-store';
@@ -15,7 +26,7 @@ export { useDebug } from '../_internal/app/hooks/use-debug';
 /** Guard a form against unmounting while submission is in flight. */
 export { useFormGuard } from '../_internal/app/hooks/use-form-guard';
 /** Cancellable JSON GET with a `{ data, loading, error, refresh }` lifecycle. */
-export { useJsonFetch } from '../_internal/app/hooks/use-json-fetch';
+export { useJsonFetch, usePluginJsonFetch } from '../_internal/app/hooks/use-json-fetch';
 export type { UseJsonFetchResult } from '../_internal/app/hooks/use-json-fetch';
 /** Subscribe to runtime connection status (online/offline, last heartbeat). */
 export { useRuntimeStatus } from '../_internal/app/hooks/use-runtime-status';
@@ -27,12 +38,14 @@ export { useQueryArrayState } from '../_internal/app/hooks/use-query-state';
 export { useScheduleJobs } from '../_internal/app/hooks/use-schedule';
 /** Fetch run history for a scheduled job. */
 export { useRunHistory } from '../_internal/app/hooks/use-schedule';
-export type { ScheduleJob, RunEntry } from '../_internal/app/hooks/use-schedule';
+export { useOccurrences } from '../_internal/app/hooks/use-schedule';
+export type { ScheduleJob, RunEntry, ScheduleOccurrence, ScheduledDomainEvent } from '../_internal/app/hooks/use-schedule';
 /** Fetch dispatch run history for a task. */
 export { useTaskRunHistory } from '../_internal/app/hooks/use-task-run-history';
 export type { TaskOutcome, TaskRunEntry } from '../_internal/app/hooks/use-task-run-history';
 /** Hybrid full-text + semantic search across plugins with facet filtering. */
 export { useSearch } from '../_internal/app/hooks/use-search';
+/** Query-path warm signal ('cold' | 'warming' | 'warm') for search-bar UI. */
 /** Re-rank a local list to match the order returned by a search query. */
 export { reorderBySearchResults } from '../_internal/app/hooks/use-search';
 export type { SearchResult, SearchResponse, UseSearchOptions, UseSearchReturn } from '../_internal/app/hooks/use-search';
@@ -41,7 +54,12 @@ export { useSidebar } from '../_internal/app/hooks/use-sidebar';
 /** Subscribe to a Server-Sent Events endpoint with auto-reconnect. */
 export { useSSE } from '../_internal/app/hooks/use-sse';
 /** Subscribe to a server-pushed plugin event over the shell's single connection. */
-export { usePluginEvent, type PluginEventPayload } from '../_internal/app/hooks/use-plugin-event';
+export { usePluginEvent, emitPluginEvent, type PluginEventPayload } from '../_internal/app/hooks/use-plugin-event';
+/** Headless drag-drop file intake (drag-over state + handlers + accept filter) — style your own zone. */
+export { useFileDrop } from '../_internal/app/hooks/use-file-drop';
+export type { UseFileDropOptions, UseFileDropResult } from '../_internal/app/hooks/use-file-drop';
+/** History-aware back for detail surfaces reachable from many places — real back() with a fallback route for cold deep-links. */
+export { useHistoryBack } from '../_internal/app/hooks/use-history-back';
 /** Fire a toast notification (success/error/info). */
 export { toast } from '../_internal/app/hooks/use-toast';
 /** Subscribe to the toast store for custom toast UIs. */
@@ -75,7 +93,7 @@ export { getChannelLabel } from '../_internal/plugins/workflows/hooks/use-notifi
 /** Get initials for a channel (e.g. "Discord" → "D"). */
 export { getChannelInitials } from '../_internal/plugins/workflows/hooks/use-notification-channels';
 /** The available-models catalog (cached, read-only); empty until loaded. */
-export { useAvailableModels } from '../_internal/plugins/models/hooks/use-available-models';
+export { useAvailableModels } from '../_internal/app/hooks/use-available-models';
 /** Access the TanStack Router instance for imperative navigation. */
 export { useRouter } from './router';
 /** Current URL pathname (Next.js-shape compatible). */
@@ -84,3 +102,5 @@ export { usePathname } from './router';
 export { useSearchParams } from './router';
 /** Current route's typed path parameters. */
 export { useParams } from './router';
+/** Split a browser-style URL string into TanStack navigate options (non-hook). */
+export { toNavigationOptions } from './router';