@ably/ai-transport 0.0.1 → 0.1.0

package/src/react/use-history.ts

@@ -1,111 +0,0 @@
-/**
- * useHistory — history pagination handle for a ClientTransport.
- *
- * Returns a `HistoryHandle` with `load()`, `next()`, `hasNext`, and
- * `loading` — mirroring the transport's `history()` and
- * `PaginatedMessages` API.
- *
- * The transport's `history()` is branch-aware: `limit` means "keep loading
- * until N new messages appear on the selected branch." Messages on
- * unselected branches are loaded into the tree but not counted toward the
- * limit. The returned `items` contain only the newly visible messages.
- *
- * When `options` are provided, auto-loads the first page on mount
- * (SWR-style: options present = enabled). When omitted or null,
- * no auto-load — call `load()` manually.
- *
- * Usage:
- * ```tsx
- * // Auto-load on mount
- * const history = useHistory(transport, { limit: 30 });
- *
- * // Manual load (e.g. on button press)
- * const history = useHistory(transport);
- * // ...later: await history.load({ limit: 30 });
- *
- * // Scroll-back
- * if (history.hasNext) await history.next();
- * ```
- */
-
-import { useCallback, useEffect, useRef, useState } from 'react';
-
-import type { ClientTransport, LoadHistoryOptions, PaginatedMessages } from '../core/transport/types.js';
-
-/** Handle for paginated history loading. */
-export interface HistoryHandle {
-  /** Are there older pages available? False until `load()` has been called. */
-  hasNext: boolean;
-  /** Is a page being fetched? */
-  loading: boolean;
-  /** Load the first page (or re-load with different options). Inserts into the conversation tree. */
-  load: (options?: LoadHistoryOptions) => Promise<void>;
-  /** Fetch the next (older) page. No-op if loading or no more pages. Inserts into the conversation tree. */
-  next: () => Promise<void>;
-}
-
-/**
- * Paginated history handle for a client transport.
- * @param transport - The client transport to load history from, or null/undefined if not yet available.
- * @param options - When provided, auto-loads the first page on mount. Omit or pass null for manual loading.
- * @returns A {@link HistoryHandle} for loading and paginating through history.
- */
-export const useHistory = <TEvent, TMessage>(
-  transport: ClientTransport<TEvent, TMessage> | null | undefined,
-  options?: LoadHistoryOptions | null,
-): HistoryHandle => {
-  const [hasNext, setHasNext] = useState(false);
-  const [loading, setLoading] = useState(false);
-  const loadingRef = useRef(false);
-  const pageRef = useRef<PaginatedMessages<TMessage> | null>(null);
-  const transportRef = useRef(transport);
-  transportRef.current = transport;
-
-  const load = useCallback(async (loadOptions?: LoadHistoryOptions) => {
-    if (!transportRef.current || loadingRef.current) return;
-    loadingRef.current = true;
-    setLoading(true);
-    try {
-      const page = await transportRef.current.history(loadOptions);
-      pageRef.current = page;
-      setHasNext(page.hasNext());
-    } finally {
-      loadingRef.current = false;
-      setLoading(false);
-    }
-  }, []);
-
-  const next = useCallback(async () => {
-    const page = pageRef.current;
-    if (!page || !page.hasNext() || loadingRef.current || !transportRef.current) return;
-
-    loadingRef.current = true;
-    setLoading(true);
-    try {
-      const older = await page.next();
-      if (older) {
-        pageRef.current = older;
-        setHasNext(older.hasNext());
-      } else {
-        setHasNext(false);
-      }
-    } finally {
-      loadingRef.current = false;
-      setLoading(false);
-    }
-  }, []);
-
-  // Auto-load first page on mount when options are provided (SWR-style).
-  const autoLoad = options !== undefined && options !== null;
-  const autoLoadedRef = useRef(false);
-  const optionsRef = useRef(options);
-  optionsRef.current = options;
-
-  useEffect(() => {
-    if (!autoLoad || autoLoadedRef.current || !transportRef.current) return;
-    autoLoadedRef.current = true;
-    void load(optionsRef.current ?? undefined);
-  }, [autoLoad, load]);
-
-  return { hasNext, loading, load, next };
-};

package/src/react/use-messages.ts

@@ -1,32 +0,0 @@
-/**
- * useMessages — reactive message list from a ClientTransport.
- *
- * Subscribes to the transport's "message" notification and returns
- * the current message list as React state. Replaces the manual
- * useState + useEffect + on("message") + getMessages() pattern.
- */
-
-import { useEffect, useState } from 'react';
-
-import type { ClientTransport } from '../core/transport/types.js';
-
-/**
- * Subscribe to transport message updates and return the current message list.
- * @param transport - The client transport to observe.
- * @returns The current list of decoded messages.
- */
-export const useMessages = <TEvent, TMessage>(transport: ClientTransport<TEvent, TMessage>): TMessage[] => {
-  const [messages, setMessages] = useState<TMessage[]>(() => transport.getMessages());
-
-  useEffect(() => {
-    // Sync initial state in case the transport already has messages
-    setMessages(transport.getMessages());
-
-    const unsub = transport.on('message', () => {
-      setMessages(transport.getMessages());
-    });
-    return unsub;
-  }, [transport]);
-
-  return messages;
-};

package/src/react/use-regenerate.ts

@@ -1,24 +0,0 @@
-/**
- * useRegenerate — stable callback for regenerating an assistant message.
- *
- * Delegates to `transport.regenerate()`, which automatically computes
- * `forkOf`, `parent`, and truncated history from the conversation tree.
- */
-
-import { useCallback } from 'react';
-
-import type { ActiveTurn, ClientTransport, SendOptions } from '../core/transport/types.js';
-
-/**
- * Return a stable `regenerate` callback bound to the given transport.
- * @param transport - The client transport to regenerate through.
- * @returns A function that regenerates an assistant message and returns an {@link ActiveTurn} handle.
- */
-export const useRegenerate = <TEvent, TMessage>(
-  transport: ClientTransport<TEvent, TMessage>,
-): ((messageId: string, options?: SendOptions) => Promise<ActiveTurn<TEvent>>) =>
-  useCallback(
-    async (messageId: string, options?: SendOptions): Promise<ActiveTurn<TEvent>> =>
-      transport.regenerate(messageId, options),
-    [transport],
-  );

package/src/react/use-send.ts

@@ -1,25 +0,0 @@
-/**
- * useSend — stable callback for sending messages through a ClientTransport.
- *
- * Returns a `send` function that sends one or more messages in a single
- * turn via `transport.send()`. Callers construct the domain messages
- * themselves; the hook provides a stable reference suitable for React deps.
- */
-
-import { useCallback } from 'react';
-
-import type { ActiveTurn, ClientTransport, SendOptions } from '../core/transport/types.js';
-
-/**
- * Return a stable `send` callback bound to the given transport.
- * @param transport - The client transport to send through.
- * @returns A function that sends messages and returns an {@link ActiveTurn} handle.
- */
-export const useSend = <TEvent, TMessage>(
-  transport: ClientTransport<TEvent, TMessage>,
-): ((messages: TMessage[], options?: SendOptions) => Promise<ActiveTurn<TEvent>>) =>
-  useCallback(
-    async (messages: TMessage[], options?: SendOptions): Promise<ActiveTurn<TEvent>> =>
-      transport.send(messages, options),
-    [transport],
-  );