@everfur/sdk 0.1.0

package/dist/chat/index.d.cts

@@ -0,0 +1,59 @@
+import { f as EverfurError, E as EverfurResult } from '../EverfurResult-D92-uL82.cjs';
+import { a as ConversationId, b as ResponseId, P as PetRef } from '../ids-CJ1S6adf.cjs';
+import { e as ChatStatus, c as ChatMessage } from '../ChatController-CpUMvvZf.cjs';
+import { ReactNode } from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+import '../requestFunnel-DuUH-kAe.cjs';
+import '../config-BSjBdxrZ.cjs';
+import '../identity-Brl-lDd6.cjs';
+import '../TelemetryPort-BDNr00hu.cjs';
+
+/**
+ * Headless chat state. `isBootstrapping` is a deliberate superset of the SPEC-10 §7.4 minimum: the
+ * controller snapshot carries it (§7.1) and the prebuilt component maps it to the Loading state.
+ */
+interface UseEverfurChatState {
+    readonly status: ChatStatus;
+    readonly messages: ReadonlyArray<ChatMessage>;
+    readonly conversationId: ConversationId | null;
+    readonly error: EverfurError | null;
+    readonly isStreaming: boolean;
+    readonly isBootstrapping: boolean;
+    /**
+     * Backend-owned suggested-prompt strings (flattened + de-duplicated) from the chat bootstrap. Empty until the
+     * bootstrap resolves and empty when the backend returns none; the prebuilt component renders them as the
+     * tappable "Follow up questions" list, each string a ready-to-send message.
+     */
+    readonly suggestedPrompts: ReadonlyArray<string>;
+    /**
+     * Optimistic; the blank user bubble is removed on a pre-first-delta failure (controller-owned). Drives the
+     * controller stream to completion and settles: `ok(responseId)` on a completed turn (the id is null when
+     * the terminal `done` frame carried no message id), or `err` with the terminal EverfurError.
+     */
+    send(text: string): Promise<EverfurResult<ResponseId | null>>;
+    /** Re-sends the last turn with the SAME idempotency key; no duplicate user bubble (§7.4). */
+    retryLast(): Promise<EverfurResult<ResponseId | null>>;
+    /** Aborts the in-flight stream; not an error. */
+    stop(): void;
+}
+/**
+ * @throws {EverfurConfigError} kind 'not-initialized' if called outside an EverfurProvider.
+ * Auto-disposes its controller reference on unmount.
+ */
+declare function useEverfurChat(opts?: {
+    readonly petRef?: PetRef;
+    readonly conversationId?: ConversationId;
+}): UseEverfurChatState;
+
+interface EverfurChatProps {
+    readonly petRef?: PetRef;
+    readonly conversationId?: ConversationId;
+    readonly style?: StyleProp<ViewStyle>;
+}
+/**
+ * Entitlement-gated, four-state chat surface. Entitlement-OFF renders the CapabilityGate OffState;
+ * otherwise the body maps the controller snapshot to exactly one deliberate state.
+ */
+declare function EverfurChat(props: EverfurChatProps): ReactNode;
+
+export { EverfurChat, type EverfurChatProps, type UseEverfurChatState, useEverfurChat };

package/dist/chat/index.d.ts

@@ -0,0 +1,59 @@
+import { f as EverfurError, E as EverfurResult } from '../EverfurResult-D92-uL82.js';
+import { a as ConversationId, b as ResponseId, P as PetRef } from '../ids-CJ1S6adf.js';
+import { e as ChatStatus, c as ChatMessage } from '../ChatController-CKdBvPj2.js';
+import { ReactNode } from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+import '../requestFunnel-dio5OmR9.js';
+import '../config-CiJ0PVBB.js';
+import '../identity-DK9zORrG.js';
+import '../TelemetryPort-BDNr00hu.js';
+
+/**
+ * Headless chat state. `isBootstrapping` is a deliberate superset of the SPEC-10 §7.4 minimum: the
+ * controller snapshot carries it (§7.1) and the prebuilt component maps it to the Loading state.
+ */
+interface UseEverfurChatState {
+    readonly status: ChatStatus;
+    readonly messages: ReadonlyArray<ChatMessage>;
+    readonly conversationId: ConversationId | null;
+    readonly error: EverfurError | null;
+    readonly isStreaming: boolean;
+    readonly isBootstrapping: boolean;
+    /**
+     * Backend-owned suggested-prompt strings (flattened + de-duplicated) from the chat bootstrap. Empty until the
+     * bootstrap resolves and empty when the backend returns none; the prebuilt component renders them as the
+     * tappable "Follow up questions" list, each string a ready-to-send message.
+     */
+    readonly suggestedPrompts: ReadonlyArray<string>;
+    /**
+     * Optimistic; the blank user bubble is removed on a pre-first-delta failure (controller-owned). Drives the
+     * controller stream to completion and settles: `ok(responseId)` on a completed turn (the id is null when
+     * the terminal `done` frame carried no message id), or `err` with the terminal EverfurError.
+     */
+    send(text: string): Promise<EverfurResult<ResponseId | null>>;
+    /** Re-sends the last turn with the SAME idempotency key; no duplicate user bubble (§7.4). */
+    retryLast(): Promise<EverfurResult<ResponseId | null>>;
+    /** Aborts the in-flight stream; not an error. */
+    stop(): void;
+}
+/**
+ * @throws {EverfurConfigError} kind 'not-initialized' if called outside an EverfurProvider.
+ * Auto-disposes its controller reference on unmount.
+ */
+declare function useEverfurChat(opts?: {
+    readonly petRef?: PetRef;
+    readonly conversationId?: ConversationId;
+}): UseEverfurChatState;
+
+interface EverfurChatProps {
+    readonly petRef?: PetRef;
+    readonly conversationId?: ConversationId;
+    readonly style?: StyleProp<ViewStyle>;
+}
+/**
+ * Entitlement-gated, four-state chat surface. Entitlement-OFF renders the CapabilityGate OffState;
+ * otherwise the body maps the controller snapshot to exactly one deliberate state.
+ */
+declare function EverfurChat(props: EverfurChatProps): ReactNode;
+
+export { EverfurChat, type EverfurChatProps, type UseEverfurChatState, useEverfurChat };