@everfur/sdk 0.1.0 → 0.3.0

package/dist/core/index.d.cts

@@ -1,17 +1,23 @@
 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 { B as BeforeLogoutContext, e as BeforeLogoutHook, C as CapabilityKind, f as CapabilityRegistry, g as CapabilityServices, h as ChatControllerRegistry, i as ChatScope, j as CreateEverfurRuntimeInput, k as CreateRuntimeOptions, l as EntitlementPoller, m as EntitlementPollerDeps, E as EntitlementSnapshot, n as EntitlementStore, o as EverfurRuntime, p as EverfurRuntimeConfig, L as LogLevel, a as LogRecord, b as LogSink, M as MIN_POLL_INTERVAL_SECONDS, N as NULL_SECURE_STORE, q as PollScheduler, P as PrepareOptions, c as PrepareResult, d as PrepareStatus, R as RuntimeTheme, r as RuntimeUser, S as SecureStorePort, T as TimerHandle, s as createEntitlementPoller, t as createEverfurRuntime } from '../runtime-B8s-_hv8.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 { E as ErrorPolicyPort, d as defaultErrorPolicy } from '../ErrorPolicyPort-CNf4uQZP.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';
+export { F as FileHandle, b as FilePort } from '../ports-BN6RHF9W.cjs';
+import { l as SuggestedPromptCategory, m as ChatController } from '../ports-DEBzEhbp.cjs';
+export { n as CHAT_FEEDBACK_TYPES, o as CHECKIN_ANSWERABLE_STATUS, C as ChatCheckin, a as ChatCheckinTarget, p as ChatControllerDeps, b as ChatConversation, c as ChatConversationListOptions, d as ChatConversationPage, e as ChatFeedbackReceipt, f as ChatFeedbackType, q as ChatHandlers, g as ChatHistoryOptions, i as ChatMessage, h as ChatMessagePage, r as ChatSnapshot, j as ChatStatus, k as Citation, F as FEEDBACK_NOTES_MAX_CHARS, M as MAX_IMAGE_KEYS_PER_MESSAGE, s as MESSAGE_MAX_CHARS, S as SendOptions, t as Timers, u as createChatController, v as isCheckinSettled } from '../ports-DEBzEhbp.cjs';
+import { E as EverfurError } from '../EverfurResult-DN9pL2Ab.cjs';
+import { P as PetRef, C as ConversationId } from '../ids-B2GAAifq.cjs';
+export { f as ATTACHMENT_ACCEPT, g as ATTACHMENT_BACKOFF_MS, h as ATTACHMENT_INITIATE_PATH, i as ATTACHMENT_MAX_ATTEMPTS, j as ATTACHMENT_MIME_TYPES, k as ATTACHMENT_QUEUE_CONCURRENCY, A as AttachmentError, a as AttachmentErrorCode, b as AttachmentOutcome, c as AttachmentQueue, l as AttachmentQueueDeps, m as AttachmentQueueSnapshot, d as AttachmentState, e as AttachmentStatus, n as AttachmentUploadPolicy, M as MAX_ATTACHMENTS_PER_MESSAGE, o as MAX_ATTACHMENT_BYTES, p as MAX_FILENAME_LENGTH, V as ValidatedAttachment, q as attachmentSize, r as createAttachmentQueue, s as formatBytes, t as initiateAttachmentUpload, u as isAttachmentMime, v as sanitizeFilename, w as uploadAttachmentBytes, x as validateAttachment } from '../attachments-CQgFrEQ7.cjs';
+export { G as SdkPlatform } from '../config-CzTZGlfF.cjs';
+export { c as EverfurThemeInput } from '../entitlementRepository-DKdXFgTo.cjs';
+export { C as CreateClinicRequestBatchInput, F as FACT_FIELD_BY_KIND, v as FACT_VALUE_FIELD, w as FactFieldValue, x as FactValueKind, H as HttpRecordsClinicRepositoryDeps, y as HttpRecordsRepositoryDeps, z as RECORDS_CLINIC_BATCH_MAX, R as RecordClinicianNote, a as RecordClinicianNoteSection, b as RecordCompleteness, c as RecordConflict, d as RecordConflictCandidate, e as RecordDepthView, f as RecordDocumentContributionsView, g as RecordEncounter, h as RecordExamSystem, A as RecordFactEditInput, B as RecordFactRemoveInput, i as RecordLabMarker, j as RecordLabPoint, D as RecordMarker, E as RecordMarkerLatest, G as RecordMarkerPoint, I as RecordMarkerSummary, J as RecordMarkersView, K as RecordPdfLink, k as RecordPhysicalExam, L as RecordShare, M as RecordShareLink, N as RecordsAuthorizationSignature, O as RecordsClinicBatch, P as RecordsClinicBatchClient, Q as RecordsClinicBatchItem, S as RecordsClinicBatchResult, T as RecordsClinicTarget, m as RecordsDepthClient, U as RecordsSignatureSuggestion, n as RecordsTimelineMedication, o as RecordsTimelineVaccine, p as RecordsTimelineView, q as RecordsTimelineVisit, r as RecordsTimelineWeight, V as createRecordsClinicBatchClient, W as createRecordsDepthClient, X as factCorrectionFor, Y as factValueCorrection, Z as inferFactValueKind, _ as isFactReviewerLocked, s as mapDocumentContributions, t as mapRecordDepth, $ as mapRecordMarkers, a0 as mapRecordPdfLink, a1 as mapRecordShareLink, a2 as mapRecordShareList, u as mapRecordsTimeline, a3 as mapSignatureSuggestions, a4 as resolveShareUrl } from '../depth-CErXCU8J.cjs';
+export { R as RecordDocumentMeta, a as RecordEntity, b as RecordOrigin, f as RecordsRequestGroupView, d as RecordsRequestView } from '../models-D2EUxPZY.cjs';
+export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-DHwtGRYY.cjs';
+import '../resolve-D4Ywz5OS.cjs';
+import '../identity-DI4eVx9S.cjs';
+import '../requestFunnel-L-BQfi0z.cjs';
+import '../profile-CSs1wlXT.cjs';
 
 /** The settled outcome of a guarded optional-module load. Never a throw. */
 type OptionalModule<T> = {
@@ -56,6 +62,11 @@ interface ChatBootstrapResult {
     readonly error: string | null;
     /** SAFE display copy: conversation not pre-initialized; the first send retries */
     readonly warning: string | null;
+    /**
+     * The typed error behind `error` or `warning` (the auth block, else the conversation-init failure), null
+     * when the conversation was primed. `runtime.prepare()` reports it as the chat step's outcome.
+     */
+    readonly cause: EverfurError | null;
     readonly diagnostics: ChatBootstrapDiagnostics;
 }
 /**
@@ -67,4 +78,39 @@ declare function bootstrapChat(input: ChatBootstrapInput, deps: {
     readonly controller: ChatController;
 }): Promise<ChatBootstrapResult>;
 
-export { type ChatBootstrapDiagnostics, type ChatBootstrapInput, type ChatBootstrapResult, ChatController, type OptionalModule, SuggestedPromptCategory, bootstrapChat, optionalModule };
+/**
+ * How long `logout()` waits for the before-logout hooks before it proceeds without them. The device unregistration
+ * the notifications hook issues is one request; a partner's sign-out screen must never hang on a slow network.
+ */
+declare const LOGOUT_HOOK_BUDGET_MS = 3000;
+
+/** The pad's fixed canvas, in bitmap pixels (a 3:1 signature strip). */
+declare const SIGNATURE_CANVAS: Readonly<{
+    width: 360;
+    height: 120;
+}>;
+/** A one-bit bitmap: `pixels[y * width + x]` is 1 for ink, 0 for paper. */
+interface SignatureBitmap {
+    readonly width: number;
+    readonly height: number;
+    readonly pixels: Uint8Array;
+}
+type SignaturePoint = readonly [number, number];
+/**
+ * The pen strokes of the pad (each a polyline in canvas pixels) as ink. A single point is a dot; a stroke that
+ * leaves the canvas is clipped, never wrapped. A non-finite point is skipped, every coordinate is clamped near
+ * the canvas, and one stroke plots at most `MAX_STEPS_PER_STROKE` steps, so no input can pin the JS thread.
+ */
+declare function rasterizeStrokes(strokes: readonly (readonly SignaturePoint[])[], penRadius?: number): SignatureBitmap;
+/**
+ * A typed name as ink, centred, shrunk to fit (the web pad's shrink-to-fit rule). The scale is the largest that
+ * fits the name on one line; a name too long even at scale 1 is clipped at the canvas edge rather than wrapped.
+ */
+declare function rasterizeTypedName(name: string): SignatureBitmap;
+/**
+ * Encode a bitmap as a 1-bit grayscale PNG (ink is black on white), base64 for `signaturePngBase64`. The rows
+ * use filter type 0; the image data is one zlib stream (header, fixed-Huffman DEFLATE, Adler-32).
+ */
+declare function encodeSignaturePng(bitmap: SignatureBitmap): string;
+
+export { type ChatBootstrapDiagnostics, type ChatBootstrapInput, type ChatBootstrapResult, ChatController, LOGOUT_HOOK_BUDGET_MS, type OptionalModule, SIGNATURE_CANVAS, type SignatureBitmap, type SignaturePoint, SuggestedPromptCategory, bootstrapChat, encodeSignaturePng, optionalModule, rasterizeStrokes, rasterizeTypedName };

package/dist/core/index.d.ts

@@ -1,17 +1,23 @@
 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 { B as BeforeLogoutContext, e as BeforeLogoutHook, C as CapabilityKind, f as CapabilityRegistry, g as CapabilityServices, h as ChatControllerRegistry, i as ChatScope, j as CreateEverfurRuntimeInput, k as CreateRuntimeOptions, l as EntitlementPoller, m as EntitlementPollerDeps, E as EntitlementSnapshot, n as EntitlementStore, o as EverfurRuntime, p as EverfurRuntimeConfig, L as LogLevel, a as LogRecord, b as LogSink, M as MIN_POLL_INTERVAL_SECONDS, N as NULL_SECURE_STORE, q as PollScheduler, P as PrepareOptions, c as PrepareResult, d as PrepareStatus, R as RuntimeTheme, r as RuntimeUser, S as SecureStorePort, T as TimerHandle, s as createEntitlementPoller, t as createEverfurRuntime } from '../runtime-BR9ysG0J.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 { E as ErrorPolicyPort, d as defaultErrorPolicy } from '../ErrorPolicyPort-CwbfmxzJ.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';
+export { F as FileHandle, b as FilePort } from '../ports-BN6RHF9W.js';
+import { l as SuggestedPromptCategory, m as ChatController } from '../ports-DMolTRzU.js';
+export { n as CHAT_FEEDBACK_TYPES, o as CHECKIN_ANSWERABLE_STATUS, C as ChatCheckin, a as ChatCheckinTarget, p as ChatControllerDeps, b as ChatConversation, c as ChatConversationListOptions, d as ChatConversationPage, e as ChatFeedbackReceipt, f as ChatFeedbackType, q as ChatHandlers, g as ChatHistoryOptions, i as ChatMessage, h as ChatMessagePage, r as ChatSnapshot, j as ChatStatus, k as Citation, F as FEEDBACK_NOTES_MAX_CHARS, M as MAX_IMAGE_KEYS_PER_MESSAGE, s as MESSAGE_MAX_CHARS, S as SendOptions, t as Timers, u as createChatController, v as isCheckinSettled } from '../ports-DMolTRzU.js';
+import { E as EverfurError } from '../EverfurResult-DN9pL2Ab.js';
+import { P as PetRef, C as ConversationId } from '../ids-B2GAAifq.js';
+export { f as ATTACHMENT_ACCEPT, g as ATTACHMENT_BACKOFF_MS, h as ATTACHMENT_INITIATE_PATH, i as ATTACHMENT_MAX_ATTEMPTS, j as ATTACHMENT_MIME_TYPES, k as ATTACHMENT_QUEUE_CONCURRENCY, A as AttachmentError, a as AttachmentErrorCode, b as AttachmentOutcome, c as AttachmentQueue, l as AttachmentQueueDeps, m as AttachmentQueueSnapshot, d as AttachmentState, e as AttachmentStatus, n as AttachmentUploadPolicy, M as MAX_ATTACHMENTS_PER_MESSAGE, o as MAX_ATTACHMENT_BYTES, p as MAX_FILENAME_LENGTH, V as ValidatedAttachment, q as attachmentSize, r as createAttachmentQueue, s as formatBytes, t as initiateAttachmentUpload, u as isAttachmentMime, v as sanitizeFilename, w as uploadAttachmentBytes, x as validateAttachment } from '../attachments-Bw3iMQgu.js';
+export { G as SdkPlatform } from '../config-DW60uRb9.js';
+export { c as EverfurThemeInput } from '../entitlementRepository-DSbzuyAW.js';
+export { C as CreateClinicRequestBatchInput, F as FACT_FIELD_BY_KIND, v as FACT_VALUE_FIELD, w as FactFieldValue, x as FactValueKind, H as HttpRecordsClinicRepositoryDeps, y as HttpRecordsRepositoryDeps, z as RECORDS_CLINIC_BATCH_MAX, R as RecordClinicianNote, a as RecordClinicianNoteSection, b as RecordCompleteness, c as RecordConflict, d as RecordConflictCandidate, e as RecordDepthView, f as RecordDocumentContributionsView, g as RecordEncounter, h as RecordExamSystem, A as RecordFactEditInput, B as RecordFactRemoveInput, i as RecordLabMarker, j as RecordLabPoint, D as RecordMarker, E as RecordMarkerLatest, G as RecordMarkerPoint, I as RecordMarkerSummary, J as RecordMarkersView, K as RecordPdfLink, k as RecordPhysicalExam, L as RecordShare, M as RecordShareLink, N as RecordsAuthorizationSignature, O as RecordsClinicBatch, P as RecordsClinicBatchClient, Q as RecordsClinicBatchItem, S as RecordsClinicBatchResult, T as RecordsClinicTarget, m as RecordsDepthClient, U as RecordsSignatureSuggestion, n as RecordsTimelineMedication, o as RecordsTimelineVaccine, p as RecordsTimelineView, q as RecordsTimelineVisit, r as RecordsTimelineWeight, V as createRecordsClinicBatchClient, W as createRecordsDepthClient, X as factCorrectionFor, Y as factValueCorrection, Z as inferFactValueKind, _ as isFactReviewerLocked, s as mapDocumentContributions, t as mapRecordDepth, $ as mapRecordMarkers, a0 as mapRecordPdfLink, a1 as mapRecordShareLink, a2 as mapRecordShareList, u as mapRecordsTimeline, a3 as mapSignatureSuggestions, a4 as resolveShareUrl } from '../depth-DjDcJ6kH.js';
+export { R as RecordDocumentMeta, a as RecordEntity, b as RecordOrigin, f as RecordsRequestGroupView, d as RecordsRequestView } from '../models-B-Uh2LTf.js';
+export { C as CheckinAnswer, a as CheckinOutcome, W as WatchCase } from '../casesRepository-ClLv6qMl.js';
+import '../resolve-D4Ywz5OS.js';
+import '../identity-BMx2SUOM.js';
+import '../requestFunnel-CjW7uDuA.js';
+import '../profile-CSs1wlXT.js';
 
 /** The settled outcome of a guarded optional-module load. Never a throw. */
 type OptionalModule<T> = {
@@ -56,6 +62,11 @@ interface ChatBootstrapResult {
     readonly error: string | null;
     /** SAFE display copy: conversation not pre-initialized; the first send retries */
     readonly warning: string | null;
+    /**
+     * The typed error behind `error` or `warning` (the auth block, else the conversation-init failure), null
+     * when the conversation was primed. `runtime.prepare()` reports it as the chat step's outcome.
+     */
+    readonly cause: EverfurError | null;
     readonly diagnostics: ChatBootstrapDiagnostics;
 }
 /**
@@ -67,4 +78,39 @@ declare function bootstrapChat(input: ChatBootstrapInput, deps: {
     readonly controller: ChatController;
 }): Promise<ChatBootstrapResult>;
 
-export { type ChatBootstrapDiagnostics, type ChatBootstrapInput, type ChatBootstrapResult, ChatController, type OptionalModule, SuggestedPromptCategory, bootstrapChat, optionalModule };
+/**
+ * How long `logout()` waits for the before-logout hooks before it proceeds without them. The device unregistration
+ * the notifications hook issues is one request; a partner's sign-out screen must never hang on a slow network.
+ */
+declare const LOGOUT_HOOK_BUDGET_MS = 3000;
+
+/** The pad's fixed canvas, in bitmap pixels (a 3:1 signature strip). */
+declare const SIGNATURE_CANVAS: Readonly<{
+    width: 360;
+    height: 120;
+}>;
+/** A one-bit bitmap: `pixels[y * width + x]` is 1 for ink, 0 for paper. */
+interface SignatureBitmap {
+    readonly width: number;
+    readonly height: number;
+    readonly pixels: Uint8Array;
+}
+type SignaturePoint = readonly [number, number];
+/**
+ * The pen strokes of the pad (each a polyline in canvas pixels) as ink. A single point is a dot; a stroke that
+ * leaves the canvas is clipped, never wrapped. A non-finite point is skipped, every coordinate is clamped near
+ * the canvas, and one stroke plots at most `MAX_STEPS_PER_STROKE` steps, so no input can pin the JS thread.
+ */
+declare function rasterizeStrokes(strokes: readonly (readonly SignaturePoint[])[], penRadius?: number): SignatureBitmap;
+/**
+ * A typed name as ink, centred, shrunk to fit (the web pad's shrink-to-fit rule). The scale is the largest that
+ * fits the name on one line; a name too long even at scale 1 is clipped at the canvas edge rather than wrapped.
+ */
+declare function rasterizeTypedName(name: string): SignatureBitmap;
+/**
+ * Encode a bitmap as a 1-bit grayscale PNG (ink is black on white), base64 for `signaturePngBase64`. The rows
+ * use filter type 0; the image data is one zlib stream (header, fixed-Huffman DEFLATE, Adler-32).
+ */
+declare function encodeSignaturePng(bitmap: SignatureBitmap): string;
+
+export { type ChatBootstrapDiagnostics, type ChatBootstrapInput, type ChatBootstrapResult, ChatController, LOGOUT_HOOK_BUDGET_MS, type OptionalModule, SIGNATURE_CANVAS, type SignatureBitmap, type SignaturePoint, SuggestedPromptCategory, bootstrapChat, encodeSignaturePng, optionalModule, rasterizeStrokes, rasterizeTypedName };