zero-trust-application-channel 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,68 @@
-# Temporary Holding Version
+# zero-trust-application-channel
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Jenerik, çoklanmış WebSocket tüneli — tek outbound bağlantı üzerinden HTTP/WS
+reverse proxy + oturum yönetimi. GD-PMS monorepo'sundan **bağımsız bir
+kütüphanedir** (tamper-logger deseni; ayrıntı:
+`../docs/LIB-MIMARISI.md`). Domain adapter'leri
+(Fastify/PG/ContainerProxy) tüketici projede yaşar.
+
+**İki deployment, tek paket (v2):** aynı jenerik paket hem
+**field→container** hem **field→boss** topolojisinde çalışır — register şeması
+nötr `peerId`+`peerType`, oturum/cookie/allowlist config'le enjekte edilir
+(ayrıntı: `../docs/CONTRACTS.md`).
+
+## İçerik
+
+| Modül | Görev |
+|---|---|
+| `codec` | Binary frame codec — 9 bayt başlık (streamId u32 BE + seq u32 BE + flags FIN/RST/WS_OP); `decode` asla throw etmez (`Result`) |
+| `protocol` | Kontrol mesaj tipleri + zod şemaları (register/ack — v2 `peerId`+`peerType`, heartbeat, telemetry, stream-*, open-session/*); `TUNNEL_PROTOCOL_VERSION = 2` |
+| `connector` | `TunnelConnector` — outbound WS istemcisi + durum makinesi + üstel backoff (`ReconnectDelay`) |
+| `channel` | `ISocketClient`/`WsSocketClient` (ws adapter), `ITunnelChannel` (client ucu), `IHubChannel` (hub ucu — peerId'li) |
+| `client` | `TunnelClient` — stream multiplex, kredi bazlı backpressure, çift upstream yönlendirme, WS köprüsü |
+| `session` | `ClientSessionStore` + `ClientSessionServer` — geçici oturum JWT'si (`ITokenSigner` enjeksiyonu) |
+| `proxy` | `SessionGateway` + `HubSessionStore` + `TunnelProxy` — hub tarafı oturum + HTTP/WS proxy (`IHubChannel`/`IStreamSink`/`IAuditSink` enjeksiyonu; cookieName + PathAllowlist config'i) |
+| `logger` / `token` / `audit` / `snapshot` / `types` | Bağımsızlık sözleşmeleri — minimal `ILogger`, `ITokenSigner`, `IAuditSink`, `ISnapshotSource`, jenerik `TunnelRole`/`TunnelUser`/`TunnelTelemetryPoint` |
+
+## Bağımlılıklar
+
+`ws`, `zod`, `@gd-monorepo/result` — başka bir şey yok. (`jose` yalnızca
+devDependency — test yardımcısı; üretim kodu `ITokenSigner` enjeksiyonuyla
+çalışır.)
+
+## Örnek — loopback uçtan uca (monorepo'suz)
+
+```bash
+bun lib/examples/loopback-demo.mjs
+```
+
+Paket içi demo: `HubHarness` (hub ucu) ↔ `TunnelConnector` + `TunnelClient`
+(client ucu) ↔ `SessionGateway` + `TunnelProxy` — tek gerçek WS kanalında
+register → oturum → tünel HTTP → WS köprüsü. Aynı akış test olarak da çalışır:
+
+```bash
+bun nx run lib:test   # loopback.spec.ts dahil
+```
+
+## Test & kalite kapıları
+
+- `nx run lib:test` — unit + spec + loopback uçtan uca
+- `nx run lib:typecheck` — `tsc --noEmit` (test dosyaları hariç)
+- Güvenlik-kritik modüller (codec, connector, client, proxy) branch kapsamı ≥ %90 hedeflenir
+
+## Sözleşme özeti
+
+```ts
+// Client ucu: TunnelConnector zaten ITunnelChannel'dır
+const client = TunnelClient.create({ webServiceUrl, staticUrl });
+client.attach(connector);
+
+// Hub ucu: IHubChannel adapter'i (ör. paket içi HubHarness veya
+// tüketicinin ContainerProxy sarmalayıcısı) + IStreamSink (tüketicinin
+// HTTP framework adapter'i) + IAuditSink + ITokenSigner enjekte edilir
+const gateway = new SessionGateway(channel, store, audit, logger);
+const proxy = new TunnelProxy(channel, store, logger);
+```
+
+Tünel rolü YORUMLAMAZ: `TunnelRole` serbest string'dir — eşleme ve RBAC
+tüketiciye aittir. Detaylı protokol: `../docs/deprecated/KONTEYNER-UZAKTAN-ERISIM-MIMARISI.md`.

package/dist/audit/index.d.ts

@@ -0,0 +1,2 @@
+export type { IAuditSink, SessionAuditOpenRecord, SessionAuditCloseRecord, } from "./interface";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audit/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,aAAa,CAAC"}

package/dist/audit/interface.d.ts

@@ -0,0 +1,29 @@
+import type { TunnelRole } from "../types";
+/** Oturum açılış kaydı — audit sink'ine verilir. */
+export interface SessionAuditOpenRecord {
+    hubId: string;
+    peerId: string;
+    sessionId: string;
+    username: string;
+    callerRole: TunnelRole;
+    peerRole: TunnelRole;
+    remoteIp?: string;
+}
+/** Oturum kapanış kaydı. */
+export interface SessionAuditCloseRecord {
+    sessionId: string;
+    endReason: string;
+    bytesIn: number;
+    bytesOut: number;
+}
+/**
+ * IAuditSink — oturum denetim kaydı sözleşmesi (fail-closed):
+ * `open` hata fırlatırsa oturum AÇILMAZ; `close` kapanışta çağrılır
+ * (hata yutulur + logger'a bildirilir).
+ * Monorepo implementasyonu: `SessionAudit` (web-service, PG + TamperLogger).
+ */
+export interface IAuditSink {
+    open(record: SessionAuditOpenRecord): Promise<void>;
+    close(record: SessionAuditCloseRecord): Promise<void>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/audit/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/audit/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4BAA4B;AAC5B,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,KAAK,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD"}

package/dist/channel/index.d.ts

@@ -0,0 +1,3 @@
+export { WsSocketClient, WsSocketClientFactory } from "./ws-socket-client";
+export type { ISocketClient, ISocketClientFactory, ITunnelChannel, IHubChannel, } from "./interface";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channel/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/channel/interface.d.ts

@@ -0,0 +1,63 @@
+/**
+ * ISocketClient — tünelin kullandığı soket görünümü (jenerik).
+ * `ws` paketi `WsSocketClient` adapter'iyle gerçeklenir; testlerde fake soket
+ * enjekte edilir (Strategy).
+ */
+export interface ISocketClient {
+    /** Text frame gönderir (kontrol mesajı JSON). */
+    send(data: string): void;
+    /** Binary frame gönderir (tünel akış verisi — 9 bayt başlık + payload). */
+    sendBinary(data: Uint8Array): void;
+    /** WS protokol seviyesi ping — liveness tespiti için (pong beklenir). */
+    ping(): void;
+    /** Soketi kapatır. */
+    close(): void;
+    /** Bağlantı açıldı (upgrade tamam). */
+    onOpen(callback: () => void): void;
+    /** Text mesajı alındı. */
+    onMessage(callback: (raw: string) => void): void;
+    /** Binary mesajı alındı (tünel akış frame'leri). */
+    onBinaryMessage(callback: (data: Buffer) => void): void;
+    /** Bağlantı kapandı (her koşulda — hata sonrası dahil). */
+    onClose(callback: () => void): void;
+    /** Soket hatası — ardından onClose da tetiklenir. */
+    onError(callback: (error: Error) => void): void;
+    /** Pong alındı — liveness saati sıfırlanır. */
+    onPong(callback: () => void): void;
+    /**
+     * Pre-upgrade ret — sunucu upgrade'i reddetti (örn. 401 service token).
+     * `statusCode` HTTP yanıt kodudur.
+     */
+    onRejected(callback: (statusCode: number) => void): void;
+    /** Güncel hazırlık durumu. */
+    readyState(): "connecting" | "open" | "closing" | "closed";
+}
+/** Soket üretici sözleşmesi — URL + auth header'ları ile client oluşturur. */
+export interface ISocketClientFactory {
+    create(url: string, headers: Record<string, string>, protocols?: string[]): ISocketClient;
+}
+/**
+ * ITunnelChannel — client tarafı kanal (TEK outbound bağlantı).
+ * TunnelConnector bu sözleşmeyi uygular; TunnelClient `attach(channel)` ile
+ * tünel akışlarını aynı WS üzerinden çoklar.
+ */
+export interface ITunnelChannel {
+    onMessage(subscriber: (message: unknown) => void): () => void;
+    onBinaryFrame(subscriber: (data: Buffer) => void): () => void;
+    sendControl(message: unknown): void;
+    sendBinary(data: Buffer): void;
+}
+/**
+ * IHubChannel — hub tarafı kanal (peer başına peerId).
+ * Monorepo implementasyonu: `ContainerProxyFieldChannel` (ContainerProxy
+ * adapter'i — sendControl/sendBinary/observer + bağlantı durumu).
+ * İkinci deployment (boss uplink) aynı sözleşmeyi field kayıtları için uygular.
+ */
+export interface IHubChannel {
+    sendControl(peerId: string, message: unknown): void;
+    sendBinary(peerId: string, data: Buffer): void;
+    onControlMessage(subscriber: (peerId: string, message: unknown) => void): () => void;
+    onBinaryFrame(subscriber: (peerId: string, data: Buffer) => void): () => void;
+    isConnected(peerId: string): boolean;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/channel/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/channel/interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2EAA2E;IAC3E,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,yEAAyE;IACzE,IAAI,IAAI,IAAI,CAAC;IACb,sBAAsB;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,uCAAuC;IACvC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnC,0BAA0B;IAC1B,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACjD,oDAAoD;IACpD,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACxD,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACpC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IAChD,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACzD,8BAA8B;IAC9B,UAAU,IAAI,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC5D;AAED,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,aAAa,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9D,aAAa,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9D,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,gBAAgB,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrF,aAAa,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC9E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC"}

package/dist/channel/ws-socket-client.d.ts

@@ -0,0 +1,36 @@
+import { WebSocket } from "ws";
+import type { ISocketClient, ISocketClientFactory } from "./interface";
+/**
+ * WsSocketClient — `ws` paketi istemcisini `ISocketClient`'a uyarlar (Adapter).
+ * TunnelConnector bu sözleşme üzerinden çalışır; testlerde fake soket enjekte
+ * edilir. `unexpected-response` (pre-upgrade ret — 401/403) `onRejected`'a
+ * çevrilir; statusCode yoksa 0 iletilir.
+ */
+export declare class WsSocketClient implements ISocketClient {
+    private readonly raw;
+    constructor(raw: WebSocket);
+    send(data: string): void;
+    sendBinary(data: Uint8Array): void;
+    ping(): void;
+    close(): void;
+    onOpen(callback: () => void): void;
+    onMessage(callback: (raw: string) => void): void;
+    onBinaryMessage(callback: (data: Buffer) => void): void;
+    onClose(callback: () => void): void;
+    onError(callback: (error: Error) => void): void;
+    onPong(callback: () => void): void;
+    onRejected(callback: (statusCode: number) => void): void;
+    readyState(): "connecting" | "open" | "closing" | "closed";
+}
+/**
+ * WsSocketClientFactory — `ws` WebSocket üreticisi. Creator testlerde fake
+ * enjekte edilir; üretimde varsayılan creator gerçek `ws` istemcisini kurar.
+ */
+export declare class WsSocketClientFactory implements ISocketClientFactory {
+    private readonly creator;
+    constructor(creator?: (url: string, protocols: string[], options: {
+        headers: Record<string, string>;
+    }) => WebSocket);
+    create(url: string, headers: Record<string, string>, protocols?: string[]): ISocketClient;
+}
+//# sourceMappingURL=ws-socket-client.d.ts.map

package/dist/channel/ws-socket-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-socket-client.d.ts","sourceRoot":"","sources":["../../src/channel/ws-socket-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AASvE;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,aAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,SAAS;IAE3C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIlC,IAAI,IAAI,IAAI;IAIZ,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIlC,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAOhD,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAOvD,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAInC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAI/C,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIlC,UAAU,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAMxD,UAAU,IAAI,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ;CAM3D;AAED;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,oBAAoB;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAIT;gBAKb,OAAO,CAAC,EAAE,CACR,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KACzC,SAAS;IAOhB,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,GAAE,MAAM,EAAO,GACvB,aAAa;CAGjB"}

package/dist/client/index.d.ts

@@ -0,0 +1,3 @@
+export { TunnelClient } from "./tunnel-client";
+export type { TunnelClientConfig } from "./tunnel-client";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/client/tunnel-client.d.ts

@@ -0,0 +1,99 @@
+import type { ISocketClientFactory, ITunnelChannel } from "../channel";
+/** TunnelClient yapılandırması — opsiyonel alanlar testlerde enjekte edilir. */
+export interface TunnelClientConfig {
+    /** API upstream taban URL'i (varsayılan kural: `/api/*`, `/ws/*`). */
+    webServiceUrl: string;
+    /** Statik/SPA upstream taban URL'i (varsayılan kural: diğer yollar). */
+    staticUrl: string;
+    /**
+     * Upstream yönlendirici — opsiyonel. Verilmezse varsayılan kural uygulanır
+     * (`/api/*`,`/ws/*` → webServiceUrl, diğer → staticUrl). Tüketici kendi
+     * yönlendirme politikasını enjekte edebilir.
+     */
+    routeUpstream?: (path: string) => string;
+    /** Akış kredisi pencere boyutu (tasarım §5.2: 256 KiB). */
+    windowSize?: number;
+    /** Eşzamanlı akış tavanı (tasarım §5.6: 16). */
+    maxStreams?: number;
+    /** Frame parça boyutu (tasarım §5.2: ≤64 KiB). */
+    chunkSize?: number;
+    /** İstek gövdesi tavanı (POST/PUT) — aşımı RST + kapatma. */
+    maxRequestBody?: number;
+    /** Akış boşta kalma süresi (ms) — §12.4 her stream için idle timeout. */
+    idleTimeoutMs?: number;
+    /** Akış azami yaşı (ms) — §12.4 max yaş. */
+    maxAgeMs?: number;
+    /** Sweep aralığı (ms). */
+    sweepIntervalMs?: number;
+    /** Loopback WS üretici — testlerde fake; üretimde `ws`. */
+    socketFactory?: ISocketClientFactory;
+}
+/**
+ * TunnelClient — client/peer tarafı akış multiplexer'ı.
+ *
+ * - `stream-open` frame'lerini alır, stream'leri upstream'e dağıtır:
+ *   varsayılan kural `/api/*`, `/ws/*` → API upstream; diğer her şey → statik
+ *   upstream. `routeUpstream` ile değiştirilebilir.
+ * - Undici fetch stream'lerini ≤64 KiB binary frame'lere böler; `stream-window`
+ *   kredisiyle backpressure uygular (kredi yoksa gövde DURUR — §5.2).
+ * - `upgrade:"websocket"` → loopback WS köprüsü; mesaj sınırları ve opcode'lar
+ *   WS_OP bayrağıyla korunur (§5.3).
+ * - Limitler: eşzamanlı akış tavanı → 503; boşta kalma/max yaş sweep'i;
+ *   `stream-close` → iptal.
+ */
+export declare class TunnelClient {
+    private readonly config;
+    private readonly codec;
+    private readonly socketFactory;
+    private readonly routeUpstream;
+    private readonly streams;
+    private sweepTimer?;
+    private channel?;
+    private constructor();
+    static create(config: TunnelClientConfig): TunnelClient;
+    /** TunnelConnector kanalına abone olur (kontrol + binary). */
+    attach(channel: ITunnelChannel): void;
+    /** Tüm akışları kapatır ve sweep'i durdurur (komut). */
+    stop(): void;
+    private handleControl;
+    private onStreamOpen;
+    private handleBinaryFrame;
+    private onWsDataFrame;
+    private onBodyFrame;
+    /** HTTP akışı: loopback fetch → ack → kredi kontrollü gövde frame'leri. */
+    private fetchStream;
+    /** Gövde parçasını kredi kontrollü gönderir — kredi yoksa bekler. */
+    private sendPayload;
+    private sendFin;
+    private openWsBridge;
+    private awaitCredit;
+    private drainWaiting;
+    private sendRst;
+    private closeStream;
+    private sweep;
+    private now;
+}
+/** Varsayılan yönlendirme kuralı: `/api|/ws` → API upstream, diğer → statik. */
+export declare function upstreamUrl(path: string, webServiceUrl: string, staticUrl: string): string;
+/** Yanıt başlıklarını hop-by-hop başlıklardan arındırır. */
+export declare function filterHeaders(headers: Headers): Record<string, string>;
+/**
+ * Upstream WS URL'inden tarayıcı-origin'i üretir (sorgu — saf):
+ * `wss://` → `https://`, `ws://` → `http://` (WHATWG origin ws için
+ * http-eşdeğerini bekler; tarayıcı da wss bağlantısında `https://` yollar).
+ * Upstream handshake'inde `Origin` olarak kullanılır — Host ile eşleşir.
+ */
+export declare function wsOrigin(url: string): string;
+/**
+ * Tarayıcının önerdiği subprotocol listesini ayrıştırır (RFC 6455):
+ * `Sec-WebSocket-Protocol: a, b` → `["a","b"]`. Upstream handshake'ine
+ * `protocols` olarak verilir (app-bağımsız — cockpit1, graphql-ws, mqtt...).
+ */
+export declare function requestedSubprotocols(header: string | undefined): string[];
+/**
+ * Upstream WS handshake'ine taşınacak başlıkları süzer: hop-by-hop ve el
+ * sıkışmasına özgü başlıklar çıkarılır (yeni handshake kendi anahtarını
+ * üretir); `cookie`/`authorization` gibi uygulama başlıkları geçer.
+ */
+export declare function wsHandshakeHeaders(headers: Record<string, string> | undefined): Record<string, string>;
+//# sourceMappingURL=tunnel-client.d.ts.map

package/dist/client/tunnel-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-client.d.ts","sourceRoot":"","sources":["../../src/client/tunnel-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtF,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAuCD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAarB;IACF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,OAAO,CAAC,CAAiB;IAIjC,OAAO;IAkBP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY;IAIvD,8DAA8D;IAC9D,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAOrC,wDAAwD;IACxD,IAAI,IAAI,IAAI;IAQZ,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,YAAY;IA0CpB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,WAAW;IAenB,2EAA2E;YAC7D,WAAW;IA8DzB,qEAAqE;YACvD,WAAW;IAyBzB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,YAAY;YAmEN,WAAW;IASzB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,GAAG;CAGZ;AAMD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAI1F;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI5C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,EAAE,CAMV;AAaD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB"}

package/dist/codec/frame-codec.d.ts

@@ -0,0 +1,26 @@
+import { ValidationError, Result } from "../result";
+import type { TunnelFrame } from "./types";
+/** Frame çözümleme hatası — beklenen (güvenilmez WS girdisi), Result ile taşınır. */
+export declare class FrameDecodeError extends ValidationError {
+    constructor(reason: string);
+}
+/**
+ * FrameCodec — tünel binary frame codec'i (tasarım §4.2).
+ *
+ * - `encode(frame)`: programcı hatası (aralık dışı streamId/seq, hatalı
+ *   opcode-flag birleşimi) throw eder — bunlar protokol verisi değildir.
+ * - `decode(buffer, maxPayload?)`: girdi güvenilmezdir; HİÇBİR durumda throw
+ *   etmez — kısa/çok-büyük frame `Result.err(FrameDecodeError)` döner.
+ *   İkisi birden (throw ve Result) bilinçli hibrittir (bkz. Faz 0 ek 2).
+ */
+export declare class FrameCodec {
+    /** Frame'i 9 bayt başlık + payload olarak serileştirir. */
+    encode(frame: TunnelFrame): Buffer;
+    /**
+     * Ham baytları frame'e çözer. Kısa girdi veya `maxPayload` aşımı → Err;
+     * aksi halde Ok. WS_OP yokken `opcode` undefined döner; bilinmeyen opcode
+     * değerleri korunur (ileri uyumluluk).
+     */
+    decode(buffer: Uint8Array, maxPayload?: number): Result<TunnelFrame, FrameDecodeError>;
+}
+//# sourceMappingURL=frame-codec.d.ts.map

package/dist/codec/frame-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-codec.d.ts","sourceRoot":"","sources":["../../src/codec/frame-codec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAMpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,qFAAqF;AACrF,qBAAa,gBAAiB,SAAQ,eAAe;gBACvC,MAAM,EAAE,MAAM;CAG3B;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IA6BlC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,GAAE,MAA0B,GAAG,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC;CA+B1G"}

package/dist/codec/index.d.ts

@@ -0,0 +1,4 @@
+export { FrameCodec, FrameDecodeError } from "./frame-codec";
+export { FRAME_HEADER_SIZE, MAX_CHUNK_SIZE, MAX_FRAME_PAYLOAD, FLAG_FIN, FLAG_RST, FLAG_WS_OP, WS_OPCODE, } from "./types";
+export type { TunnelFrame } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codec/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/codec/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Tünel akış frame'i tipleri — tasarım §4.2.
+ *
+ * Binary frame düzeni (9 bayt başlık + payload):
+ * ```
+ *  0        4        8   9
+ * ┌────────┬────────┬───┬────────────────────────┐
+ * │ streamId (u32 BE) │ seq (u32 BE) │flags│ payload (ham bayt)
+ * └────────┴────────┴───┴────────────────────────┘
+ *   flags: 0x01 FIN · 0x02 RST · 0x04 WS_OP
+ *   WS_OP varken sonraki 4 bit opcode: 0x0 veri, 0x1 text, 0x2 binary,
+ *                                      0x8 close, 0x9 ping, 0xA pong
+ * ```
+ *
+ * - `streamId`: oturum açan taraf (field) atar, monoton artan.
+ * - `seq`: akış içi sıra (güvenilir WS üzerinde kayıp olmaz; teşhis amaçlı).
+ * - `WS_OP`: tünel WS akışlarında mesaj sınırları ve opcode'lar korunur.
+ */
+/** Başlık boyutu: streamId (4) + seq (4) + flags (1). */
+export declare const FRAME_HEADER_SIZE = 9;
+/** Frame başına azami payload — 64 KiB parçalar (tasarım §5.2). */
+export declare const MAX_CHUNK_SIZE: number;
+/** decode() güvenlik sınırı — 1 MiB üstü frame reddedilir. */
+export declare const MAX_FRAME_PAYLOAD: number;
+/** flags bitleri. */
+export declare const FLAG_FIN = 1;
+export declare const FLAG_RST = 2;
+export declare const FLAG_WS_OP = 4;
+/** WS_OP varken taşınan WS opcode değerleri (RFC 6455 alt kümesi). */
+export declare const WS_OPCODE: {
+    readonly Data: 0;
+    readonly Text: 1;
+    readonly Binary: 2;
+    readonly Close: 8;
+    readonly Ping: 9;
+    readonly Pong: 10;
+};
+/** Bir tünel akış frame'i. `opcode` yalnızca WS_OP flag'i set iken anlamlıdır. */
+export interface TunnelFrame {
+    /** Akış kimliği — 0..2^32-1. */
+    streamId: number;
+    /** Akış içi sıra numarası — 0..2^32-1. */
+    seq: number;
+    /** FIN|RST|WS_OP bitlerinin birleşimi (WS_OP varken yüksek 4 bit opcode taşır). */
+    flags: number;
+    /** WS_OP set iken WS opcode (0-15); diğer durumda undefined. */
+    opcode?: number;
+    /** Ham payload baytları. */
+    payload: Uint8Array;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/codec/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,mEAAmE;AACnE,eAAO,MAAM,cAAc,QAAY,CAAC;AAExC,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,QAAc,CAAC;AAE7C,qBAAqB;AACrB,eAAO,MAAM,QAAQ,IAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,IAAO,CAAC;AAC7B,eAAO,MAAM,UAAU,IAAO,CAAC;AAE/B,sEAAsE;AACtE,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,OAAO,EAAE,UAAU,CAAC;CACrB"}

package/dist/connector/index.d.ts

@@ -0,0 +1,5 @@
+export { TunnelConnector } from "./tunnel-connector";
+export type { TunnelConnectorConfig } from "./tunnel-connector";
+export { ReconnectDelay } from "./reconnect-delay";
+export type { ReconnectDelayConfig } from "./reconnect-delay";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/connector/reconnect-delay.d.ts

@@ -0,0 +1,32 @@
+/** ReconnectDelay yapılandırması — tüm alanlar zorunlu (birincil constructor). */
+export interface ReconnectDelayConfig {
+    /** Taban gecikme (ms) — attempt 1'deki değer. */
+    baseMs: number;
+    /** Maksimum gecikme (ms) — üstel büyüme bu değeri aşamaz. */
+    maxMs: number;
+    /** Jitter açıklığı (ms) — [0, jitterSpanMs) aralığında ekleme. */
+    jitterSpanMs: number;
+    /** [0, 1) aralığında rastgele değer üretici — testlerde deterministik enjekte edilir. */
+    jitter: () => number;
+}
+/**
+ * ReconnectDelay — üstel backoff hesaplayıcı (tasarım §6):
+ *
+ * `delayFor(attempt)` = `min(maxMs, baseMs · 2^(attempt-1) + jitter() · jitterSpanMs)`.
+ * `reset()` başarılı bağlantıda çağrılır — bir sonraki kopuş yeniden tabandan başlar
+ * (reconnect fırtınası önlenir, tasarım §12.4).
+ *
+ * Immutable — durum yalnızca `reset()` komutuyla değişir (Elegant Object kural 3).
+ */
+export declare class ReconnectDelay {
+    private readonly baseMs;
+    private readonly maxMs;
+    private readonly jitterSpanMs;
+    private readonly jitter;
+    constructor(config: ReconnectDelayConfig);
+    /** `attempt` (1 tabanlı) için beklenmesi gereken gecikmeyi döndürür (ms). */
+    delayFor(attempt: number): number;
+    /** Başarılı bağlantıda çağrılır — bir sonraki kopuş tabandan başlar. */
+    reset(): void;
+}
+//# sourceMappingURL=reconnect-delay.d.ts.map

package/dist/connector/reconnect-delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-delay.d.ts","sourceRoot":"","sources":["../../src/connector/reconnect-delay.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,oBAAoB;IA4BxC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAoBjC,wEAAwE;IACxE,KAAK,IAAI,IAAI;CAId"}

package/dist/connector/tunnel-connector.d.ts

@@ -0,0 +1,128 @@
+import type { TunnelConnectorState, ServiceAnnouncement, TunnelPeerType } from "../protocol";
+import type { ILogger } from "../logger";
+import type { ISocketClientFactory, ITunnelChannel } from "../channel";
+import type { ReconnectDelay } from "./reconnect-delay";
+/** TunnelConnector yapılandırması — bootstrap env'den türetilir (tasarım §6.1). */
+export interface TunnelConnectorConfig {
+    /** Hub WS URL listesi — sırayla denenir (ana + yedek). */
+    wsUrls: readonly string[];
+    /** Service token — upgrade'de `Authorization: Bearer` header'ı olarak taşınır. */
+    token: string;
+    /** Peer kimliği — register mesajının `peerId` alanı. */
+    peerId: string;
+    /** Peer türü — hub kayıt/doğrulama tarafını seçer. Varsayılan: "container". */
+    peerType?: TunnelPeerType;
+    /**
+     * Peer'ın sunduğu OPAK servisler (opsiyonel). Register mesajına yalnızca
+     * doluysa eklenir; hub hedef adresi bilmez (bkz. ServiceAnnouncement).
+     */
+    services?: readonly ServiceAnnouncement[];
+    /** Heartbeat gönderim aralığı (ms) — operational config ile değişebilir. */
+    heartbeatIntervalMs: number;
+    /**
+     * Log olay kodları — nötr varsayılanlar; tüketici kendi (domain) kodlarını
+     * enjekte eder. Paket domain sözlüğü bilmez.
+     */
+    eventCodes?: Partial<TunnelConnectorEventCodes>;
+    /** Register sonrası ack bekleme süresi (ms) — aşarsa backoff. */
+    registerTimeoutMs: number;
+    /** Pong alınmazsa bağlantı yarı-ölü sayılır (ms). */
+    livenessTimeoutMs: number;
+}
+/** Connector log olay kodları — nötr varsayılanlar. */
+export interface TunnelConnectorEventCodes {
+    connected: string;
+    connectionLost: string;
+    registerRejected: string;
+    configRejected: string;
+}
+/** Varsayılan olay kodları — transport-nötr. */
+export declare const DEFAULT_TUNNEL_EVENT_CODES: Readonly<TunnelConnectorEventCodes>;
+/**
+ * TunnelConnector — client→hub outbound WS istemcisi (tasarım §6).
+ *
+ * Sorumluluklar: register + heartbeat + PPC durumu (`state()`) + operational
+ * config alımı (register-ack.config / config-update — restart'sız). Tünel
+ * stream'leri aynı kanala eklenir.
+ *
+ * Domain mesajları (telemetri/operasyon/olay) TAŞIMAZ; bilinmeyen tipler
+ * `onMessage` abonelerine akar.
+ *
+ * Durum makinesi (tasarım §6 diyagramı):
+ * ```
+ * offline → connecting: start() veya backoff bitti
+ * connecting → registered: register-ack ok
+ * connecting → backoff: hata / 401 / register timeout
+ * registered → connected: ilk heartbeat gönderildi
+ * connected → backoff: WS kapandı / liveness timeout
+ * backoff → connecting: exp(2^n·1s)+jitter (ReconnectDelay)
+ * connected → offline: stop()
+ * ```
+ *
+ * Yan etkiler: `ws` soketi (enjekte fabrikadan), ILogger (geçiş-odaklı loglar —
+ * kodlar `eventCodes` ile enjekte edilir; varsayılanlar nötrdür).
+ */
+export declare class TunnelConnector implements ITunnelChannel {
+    private readonly config;
+    private readonly socketFactory;
+    private readonly reconnectDelay;
+    private readonly logger?;
+    private readonly now;
+    private stateValue;
+    private socket?;
+    private generation;
+    private attempt;
+    private urlIndex;
+    private stopped;
+    private heartbeatTimer?;
+    private registerTimer?;
+    private reconnectTimer?;
+    private lastHeartbeatSentAt?;
+    private lastPongAt;
+    private operational;
+    private readonly eventCodes;
+    private readonly messageSubscribers;
+    private readonly binarySubscribers;
+    constructor(config: TunnelConnectorConfig, socketFactory: ISocketClientFactory, reconnectDelay: ReconnectDelay, logger?: ILogger | undefined, now?: () => number);
+    /** Bağlantı döngüsünü başlatır (komut). Çalışıyorsa no-op. */
+    start(): Promise<void>;
+    /** Bağlantıyı kapatır, yeniden bağlanmaz (komut). */
+    stop(): Promise<void>;
+    /** Güncel durum makinesi durumu (sorgu). */
+    state(): TunnelConnectorState;
+    /** Hub'a bağlı mı — PPC kaynağı (sorgu). */
+    connected(): boolean;
+    /** Son heartbeat'in gönderildiği zaman (ms epoch) — hiç gönderilmediyse undefined. */
+    lastHeartbeatAt(): number | undefined;
+    /**
+     * Faz 3: tünel katmanının kullandığı kontrol mesajı gönderici (komut).
+     * stream-open-ack / stream-window / stream-close / open-session-ack.
+     * WS açık değilse no-op.
+     */
+    sendControl(message: unknown): void;
+    /** Faz 3: ham binary frame gönderici (9 bayt başlık + payload). WS açıksa. */
+    sendBinary(data: Buffer): void;
+    /**
+     * Faz 3: tünel kontrol mesajı aboneliği — TunnelConnector'ın bilmediği tipler
+     * (open-session, stream-*, session-end) abonelere iletilir. Unsubscribe
+     * fonksiyonu döner (sorgu + yan etki — abonelik kurulumu).
+     */
+    onMessage(subscriber: (message: unknown) => void): () => void;
+    /** Faz 3: binary frame aboneliği — tünel akış verisi abonelere iletilir. */
+    onBinaryFrame(subscriber: (data: Buffer) => void): () => void;
+    private connect;
+    private tryUrl;
+    private handleMessage;
+    private sendHeartbeat;
+    private applyOperationalConfig;
+    private scheduleHeartbeat;
+    private closeAndBackoff;
+    private enterBackoff;
+    private clearTimers;
+    private registerFrame;
+    /** Peer türü — varsayılan "container" (geriye uyumluluk). */
+    private peerType;
+    private send;
+    private log;
+}
+//# sourceMappingURL=tunnel-connector.d.ts.map

package/dist/connector/tunnel-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-connector.d.ts","sourceRoot":"","sources":["../../src/connector/tunnel-connector.ts"],"names":[],"mappings":"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"}