@nonoun/native-chat 0.2.1 → 0.4.0

package/dist/stream/index.d.ts

@@ -0,0 +1,9 @@
+export type { ChatStreamChunk, StreamFormat, ChatTransportOptions, ChatStreamEvent, TransportState, TransportStatus, TransportStateCallback, RetryOptions, } from './types.ts';
+export { parseSSE } from './parse-sse.ts';
+export { parseNDJSON } from './parse-ndjson.ts';
+export { parseJSON } from './parse-json.ts';
+export type { ChatTransport } from './create-transport.ts';
+export { detectFormat, createChatStream, createChatTransport, } from './create-transport.ts';
+export type { StreamEndReason } from './classify.ts';
+export { classifyStreamEnd, classifyHttpError, backoffDelay } from './classify.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/stream/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stream/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/stream/parse-json.d.ts

@@ -0,0 +1,9 @@
+import type { ChatStreamChunk } from './types.ts';
+/**
+ * Parse a standard JSON response as a single ChatStreamChunk.
+ *
+ * Reads the entire response body, parses as JSON, and yields one chunk
+ * with `done: true`.
+ */
+export declare function parseJSON(response: Response): AsyncGenerator<ChatStreamChunk>;
+//# sourceMappingURL=parse-json.d.ts.map

package/dist/stream/parse-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-json.d.ts","sourceRoot":"","sources":["../../src/stream/parse-json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,wBAAuB,SAAS,CAC9B,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,eAAe,CAAC,CA2BjC"}

package/dist/stream/parse-ndjson.d.ts

@@ -0,0 +1,9 @@
+import type { ChatStreamChunk } from './types.ts';
+/**
+ * Parse a newline-delimited JSON (NDJSON) response stream into ChatStreamChunk values.
+ *
+ * Each non-empty line is parsed as a standalone JSON object.
+ * Accumulates the full message across chunks.
+ */
+export declare function parseNDJSON(response: Response): AsyncGenerator<ChatStreamChunk>;
+//# sourceMappingURL=parse-ndjson.d.ts.map

package/dist/stream/parse-ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-ndjson.d.ts","sourceRoot":"","sources":["../../src/stream/parse-ndjson.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,wBAAuB,WAAW,CAChC,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,eAAe,CAAC,CA2FjC"}

package/dist/stream/parse-sse.d.ts

@@ -0,0 +1,9 @@
+import type { ChatStreamChunk } from './types.ts';
+/**
+ * Parse a Server-Sent Events (SSE) response stream into ChatStreamChunk values.
+ *
+ * Reads `data:` lines from the response body, skips empty lines and comments,
+ * handles the `[DONE]` sentinel, and accumulates the full message across chunks.
+ */
+export declare function parseSSE(response: Response): AsyncGenerator<ChatStreamChunk>;
+//# sourceMappingURL=parse-sse.d.ts.map

package/dist/stream/parse-sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-sse.d.ts","sourceRoot":"","sources":["../../src/stream/parse-sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,wBAAuB,QAAQ,CAC7B,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,eAAe,CAAC,CAmIjC"}

package/dist/stream/types.d.ts

@@ -0,0 +1,42 @@
+export interface ChatStreamChunk {
+    delta: string;
+    fullMessage: string;
+    role: 'assistant' | 'user';
+    datetime: number;
+    done: boolean;
+    /** True when stream ended without an explicit completion signal (e.g., no `[DONE]` sentinel). */
+    partial?: boolean;
+}
+export type StreamFormat = 'sse' | 'ndjson' | 'json';
+export type TransportState = 'idle' | 'sending' | 'streaming' | 'retrying' | 'rate-limited' | 'auth-required' | 'server-error' | 'offline' | 'ready';
+export interface TransportStatus {
+    state: TransportState;
+    statusCode?: number;
+    retryInMs?: number;
+    attempt?: number;
+    maxAttempts?: number;
+    error?: Error;
+}
+export type TransportStateCallback = (status: TransportStatus) => void;
+export interface RetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+}
+export interface ChatTransportOptions {
+    baseUrl: string;
+    clientId?: string;
+    format?: StreamFormat;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+    onStateChange?: TransportStateCallback;
+    retry?: RetryOptions;
+}
+export interface ChatStreamEvent {
+    type: 'start' | 'chunk' | 'complete' | 'partial' | 'error' | 'stop';
+    chunk?: ChatStreamChunk;
+    error?: Error;
+    durationMs?: number;
+    requestId: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/stream/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/stream/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,iGAAiG;IACjG,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAIrD,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,cAAc,GACd,eAAe,GACf,cAAc,GACd,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,aAAa,CAAC,EAAE,sBAAsB,CAAC;IACvC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACpE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/telemetry/emitter.d.ts

@@ -0,0 +1,20 @@
+import type { TelemetryCorrelation, TelemetryEvent, TelemetryLevel, TelemetryRedactor } from './types.ts';
+/**
+ * Dispatches telemetry events as `CustomEvent` instances on a given
+ * `EventTarget`, applying a configurable redactor before emission.
+ */
+export declare class TelemetryEmitter {
+    #private;
+    constructor(target: EventTarget, level?: TelemetryLevel);
+    /** Change the telemetry level, replacing the redactor. */
+    setLevel(level: TelemetryLevel): void;
+    /** Replace the redactor with a custom implementation. */
+    setRedactor(fn: TelemetryRedactor): void;
+    /** Apply the redactor and dispatch the event on the target. */
+    emit(event: TelemetryEvent): void;
+    emitTransport(correlation: TelemetryCorrelation, mode: string, contentType: string): void;
+    emitGenerationStart(correlation: TelemetryCorrelation): void;
+    emitGenerationComplete(correlation: TelemetryCorrelation, durationMs: number): void;
+    emitWarning(correlation: TelemetryCorrelation, message: string, detail?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/telemetry/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/telemetry/emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,qBAAa,gBAAgB;;gBAIf,MAAM,EAAE,WAAW,EAAE,KAAK,GAAE,cAA0B;IAKlE,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAIrC,yDAAyD;IACzD,WAAW,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAIxC,+DAA+D;IAC/D,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IASjC,aAAa,CACX,WAAW,EAAE,oBAAoB,EACjC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,IAAI;IAQP,mBAAmB,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI;IAQ5D,sBAAsB,CACpB,WAAW,EAAE,oBAAoB,EACjC,UAAU,EAAE,MAAM,GACjB,IAAI;IAQP,WAAW,CACT,WAAW,EAAE,oBAAoB,EACjC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI;CAOR"}

package/dist/telemetry/events.d.ts

@@ -0,0 +1,11 @@
+export declare const CHAT_EVENTS: {
+    readonly TRANSPORT: "native:chat-transport";
+    readonly GENERATION_START: "native:generation-start";
+    readonly GENERATION_COMPLETE: "native:generation-complete";
+    readonly GENERATION_STOP: "native:generation-stop";
+    readonly GENERATION_ERROR: "native:generation-error";
+    readonly WARNING: "native:chat-warning";
+};
+export declare const SAFE_FIELDS: readonly ["requestId", "sessionId", "conversationId", "messageId", "mode", "contentType", "durationMs", "startedAt", "completedAt", "attempt", "maxAttempts", "chunkIndex"];
+export declare const SENSITIVE_FIELDS: readonly ["query", "message", "delta", "fullMessage", "body", "content", "prompt", "response"];
+//# sourceMappingURL=events.d.ts.map

package/dist/telemetry/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/telemetry/events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAEX,eAAO,MAAM,WAAW,6KAad,CAAC;AAEX,eAAO,MAAM,gBAAgB,gGASnB,CAAC"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,5 @@
+export type { TelemetryCorrelation, TelemetryTiming, TelemetryRetry, TelemetryLevel, TelemetryEvent, TelemetryRedactor, } from './types.ts';
+export { CHAT_EVENTS, SAFE_FIELDS, SENSITIVE_FIELDS } from './events.ts';
+export { scrubPII, createDefaultRedactor } from './redactor.ts';
+export { TelemetryEmitter } from './emitter.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/telemetry/redactor.d.ts

@@ -0,0 +1,17 @@
+import type { TelemetryLevel, TelemetryRedactor } from './types.ts';
+/**
+ * Scrub common PII patterns from a string.
+ *
+ * Replaces email addresses, phone-like numbers, and credit-card-like
+ * number sequences with `[redacted]` placeholders.
+ */
+export declare function scrubPII(text: string): string;
+/**
+ * Create a default redactor for the given telemetry level.
+ *
+ * - **minimal**: Sensitive fields in `detail` are replaced with
+ *   `[redacted:Nchars]` indicating the original length.
+ * - **debug**: All fields pass through unmodified.
+ */
+export declare function createDefaultRedactor(level: TelemetryLevel): TelemetryRedactor;
+//# sourceMappingURL=redactor.d.ts.map

package/dist/telemetry/redactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redactor.d.ts","sourceRoot":"","sources":["../../src/telemetry/redactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AASpF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK7C;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAmB9E"}

package/dist/telemetry/types.d.ts

@@ -0,0 +1,27 @@
+export interface TelemetryCorrelation {
+    requestId: string;
+    sessionId?: string;
+    conversationId?: string;
+    messageId?: string;
+    parentMessageId?: string;
+}
+export interface TelemetryTiming {
+    startedAt?: number;
+    completedAt?: number;
+    durationMs?: number;
+}
+export interface TelemetryRetry {
+    attempt?: number;
+    maxAttempts?: number;
+    retryReason?: string;
+}
+export type TelemetryLevel = 'minimal' | 'debug';
+export interface TelemetryEvent {
+    type: string;
+    correlation: TelemetryCorrelation;
+    timing?: TelemetryTiming;
+    retry?: TelemetryRetry;
+    detail?: Record<string, unknown>;
+}
+export type TelemetryRedactor = (event: TelemetryEvent) => TelemetryEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/telemetry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,oBAAoB,CAAC;IAClC,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nonoun/native-chat",
-  "version": "0.2.1",
+  "version": "0.4.0",
   "description": "Chat input and message layout components for @nonoun/native-ui",
   "license": "MIT",
   "type": "module",