@everfur/sdk 0.1.0

package/dist/core/index.d.cts

@@ -0,0 +1,70 @@
+export { K as KvPort } from '../cacheEpoch-DknKn3S0.cjs';
+export { C as CapabilityKind, a as CapabilityRegistry, b as CapabilityServices, c as ChatControllerRegistry, d as ChatScope, e as CreateEverfurRuntimeInput, f as CreateRuntimeOptions, E as EntitlementPoller, g as EntitlementPollerDeps, h as EntitlementSnapshot, i as EntitlementStore, j as EverfurRuntime, k as EverfurRuntimeConfig, L as LogLevel, l as LogRecord, m as LogSink, M as MIN_POLL_INTERVAL_SECONDS, N as NULL_SECURE_STORE, P as PollScheduler, R as RuntimeTheme, n as RuntimeUser, S as SecureStorePort, T as TimerHandle, o as createEntitlementPoller, p as createEverfurRuntime } from '../runtime-BgQnA594.cjs';
+export { T as TelemetryPort, n as noopTelemetry } from '../TelemetryPort-BDNr00hu.cjs';
+import { S as SuggestedPromptCategory, C as ChatController } from '../ChatController-CpUMvvZf.cjs';
+export { a as ChatControllerDeps, b as ChatHandlers, c as ChatMessage, d as ChatSnapshot, e as ChatStatus, f as Citation, E as ErrorPolicyPort, M as MESSAGE_MAX_CHARS, g as SendOptions, T as Timers, h as createChatController, i as defaultErrorPolicy } from '../ChatController-CpUMvvZf.cjs';
+export { C as CameraPort, a as CaptureOptions, M as MediaSource, u as unavailableCamera } from '../CameraPort-Cv31Pz7g.cjs';
+export { F as FileHandle, a as FilePort } from '../FilePort-BabWrv7I.cjs';
+import { P as PetRef, a as ConversationId } from '../ids-CJ1S6adf.cjs';
+import '../resolve-Dq_4_agU.cjs';
+import '../petsRepository-BEGb97M9.cjs';
+import '../EverfurResult-D92-uL82.cjs';
+import '../requestFunnel-DuUH-kAe.cjs';
+import '../config-BSjBdxrZ.cjs';
+import '../identity-Brl-lDd6.cjs';
+
+/** The settled outcome of a guarded optional-module load. Never a throw. */
+type OptionalModule<T> = {
+    readonly available: true;
+    readonly module: T;
+} | {
+    readonly available: false;
+    readonly module: null;
+    readonly reason: string;
+};
+/**
+ * Load an optional native peer behind a guard. `load` is the host-provided thunk (typically a `require`).
+ * An optional `validate` type-guard rejects a present-but-wrong-shape module (a version whose surface drifted)
+ * without throwing. Returns a settled result; NEVER throws.
+ *
+ * @param name  human-readable peer name, only used to build the `reason` string.
+ * @param load  the thunk that resolves the module (e.g. `() => require('expo-secure-store')`).
+ * @param validate  optional shape guard; when it returns false the module is treated as unavailable.
+ */
+declare function optionalModule<T>(name: string, load: () => unknown, validate?: (candidate: unknown) => candidate is T): OptionalModule<T>;
+
+interface ChatBootstrapInput {
+    /** omit => general conversation */
+    readonly petRef?: PetRef;
+    /** from KvPort auto-resume, if any */
+    readonly resumeConversationId?: ConversationId;
+}
+interface ChatBootstrapDiagnostics {
+    readonly candidateConversationIds: readonly string[];
+    /** a 403 was seen (observed, not an auth block) */
+    readonly sawForbidden: boolean;
+    /** a 401 was seen (auth block) */
+    readonly sawUnauthorized: boolean;
+    readonly sawConversationInitFailure: boolean;
+}
+interface ChatBootstrapResult {
+    /** null => first send() will create + retry (warning set) */
+    readonly conversationId: ConversationId | null;
+    readonly petRef: PetRef | null;
+    readonly suggestedPrompts: readonly SuggestedPromptCategory[];
+    /** SAFE display copy: an auth failure blocks (code-derived, never raw wire text) */
+    readonly error: string | null;
+    /** SAFE display copy: conversation not pre-initialized; the first send retries */
+    readonly warning: string | null;
+    readonly diagnostics: ChatBootstrapDiagnostics;
+}
+/**
+ * Prime chat. Settles to a result; never throws. Parallel prompts + conversation prime, resumed id tried
+ * first. A 401 anywhere sets `error` (auth block). A 403 sets `sawForbidden` only. A conversation-init
+ * failure sets `warning` and leaves `conversationId` null so the first send recreates.
+ */
+declare function bootstrapChat(input: ChatBootstrapInput, deps: {
+    readonly controller: ChatController;
+}): Promise<ChatBootstrapResult>;
+
+export { type ChatBootstrapDiagnostics, type ChatBootstrapInput, type ChatBootstrapResult, ChatController, type OptionalModule, SuggestedPromptCategory, bootstrapChat, optionalModule };

package/dist/core/index.d.ts

@@ -0,0 +1,70 @@
+export { K as KvPort } from '../cacheEpoch-DknKn3S0.js';
+export { C as CapabilityKind, a as CapabilityRegistry, b as CapabilityServices, c as ChatControllerRegistry, d as ChatScope, e as CreateEverfurRuntimeInput, f as CreateRuntimeOptions, E as EntitlementPoller, g as EntitlementPollerDeps, h as EntitlementSnapshot, i as EntitlementStore, j as EverfurRuntime, k as EverfurRuntimeConfig, L as LogLevel, l as LogRecord, m as LogSink, M as MIN_POLL_INTERVAL_SECONDS, N as NULL_SECURE_STORE, P as PollScheduler, R as RuntimeTheme, n as RuntimeUser, S as SecureStorePort, T as TimerHandle, o as createEntitlementPoller, p as createEverfurRuntime } from '../runtime-CBA-LvdM.js';
+export { T as TelemetryPort, n as noopTelemetry } from '../TelemetryPort-BDNr00hu.js';
+import { S as SuggestedPromptCategory, C as ChatController } from '../ChatController-CKdBvPj2.js';
+export { a as ChatControllerDeps, b as ChatHandlers, c as ChatMessage, d as ChatSnapshot, e as ChatStatus, f as Citation, E as ErrorPolicyPort, M as MESSAGE_MAX_CHARS, g as SendOptions, T as Timers, h as createChatController, i as defaultErrorPolicy } from '../ChatController-CKdBvPj2.js';
+export { C as CameraPort, a as CaptureOptions, M as MediaSource, u as unavailableCamera } from '../CameraPort-Cv31Pz7g.js';
+export { F as FileHandle, a as FilePort } from '../FilePort-BabWrv7I.js';
+import { P as PetRef, a as ConversationId } from '../ids-CJ1S6adf.js';
+import '../resolve-Dq_4_agU.js';
+import '../petsRepository-Bu18r2kK.js';
+import '../EverfurResult-D92-uL82.js';
+import '../requestFunnel-dio5OmR9.js';
+import '../config-CiJ0PVBB.js';
+import '../identity-DK9zORrG.js';
+
+/** The settled outcome of a guarded optional-module load. Never a throw. */
+type OptionalModule<T> = {
+    readonly available: true;
+    readonly module: T;
+} | {
+    readonly available: false;
+    readonly module: null;
+    readonly reason: string;
+};
+/**
+ * Load an optional native peer behind a guard. `load` is the host-provided thunk (typically a `require`).
+ * An optional `validate` type-guard rejects a present-but-wrong-shape module (a version whose surface drifted)
+ * without throwing. Returns a settled result; NEVER throws.
+ *
+ * @param name  human-readable peer name, only used to build the `reason` string.
+ * @param load  the thunk that resolves the module (e.g. `() => require('expo-secure-store')`).
+ * @param validate  optional shape guard; when it returns false the module is treated as unavailable.
+ */
+declare function optionalModule<T>(name: string, load: () => unknown, validate?: (candidate: unknown) => candidate is T): OptionalModule<T>;
+
+interface ChatBootstrapInput {
+    /** omit => general conversation */
+    readonly petRef?: PetRef;
+    /** from KvPort auto-resume, if any */
+    readonly resumeConversationId?: ConversationId;
+}
+interface ChatBootstrapDiagnostics {
+    readonly candidateConversationIds: readonly string[];
+    /** a 403 was seen (observed, not an auth block) */
+    readonly sawForbidden: boolean;
+    /** a 401 was seen (auth block) */
+    readonly sawUnauthorized: boolean;
+    readonly sawConversationInitFailure: boolean;
+}
+interface ChatBootstrapResult {
+    /** null => first send() will create + retry (warning set) */
+    readonly conversationId: ConversationId | null;
+    readonly petRef: PetRef | null;
+    readonly suggestedPrompts: readonly SuggestedPromptCategory[];
+    /** SAFE display copy: an auth failure blocks (code-derived, never raw wire text) */
+    readonly error: string | null;
+    /** SAFE display copy: conversation not pre-initialized; the first send retries */
+    readonly warning: string | null;
+    readonly diagnostics: ChatBootstrapDiagnostics;
+}
+/**
+ * Prime chat. Settles to a result; never throws. Parallel prompts + conversation prime, resumed id tried
+ * first. A 401 anywhere sets `error` (auth block). A 403 sets `sawForbidden` only. A conversation-init
+ * failure sets `warning` and leaves `conversationId` null so the first send recreates.
+ */
+declare function bootstrapChat(input: ChatBootstrapInput, deps: {
+    readonly controller: ChatController;
+}): Promise<ChatBootstrapResult>;
+
+export { type ChatBootstrapDiagnostics, type ChatBootstrapInput, type ChatBootstrapResult, ChatController, type OptionalModule, SuggestedPromptCategory, bootstrapChat, optionalModule };