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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/README.md +67 -2
  2. package/dist/audit/index.d.ts +2 -0
  3. package/dist/audit/index.d.ts.map +1 -0
  4. package/dist/audit/interface.d.ts +29 -0
  5. package/dist/audit/interface.d.ts.map +1 -0
  6. package/dist/channel/index.d.ts +3 -0
  7. package/dist/channel/index.d.ts.map +1 -0
  8. package/dist/channel/interface.d.ts +63 -0
  9. package/dist/channel/interface.d.ts.map +1 -0
  10. package/dist/channel/ws-socket-client.d.ts +36 -0
  11. package/dist/channel/ws-socket-client.d.ts.map +1 -0
  12. package/dist/client/index.d.ts +3 -0
  13. package/dist/client/index.d.ts.map +1 -0
  14. package/dist/client/tunnel-client.d.ts +99 -0
  15. package/dist/client/tunnel-client.d.ts.map +1 -0
  16. package/dist/codec/frame-codec.d.ts +26 -0
  17. package/dist/codec/frame-codec.d.ts.map +1 -0
  18. package/dist/codec/index.d.ts +4 -0
  19. package/dist/codec/index.d.ts.map +1 -0
  20. package/dist/codec/types.d.ts +51 -0
  21. package/dist/codec/types.d.ts.map +1 -0
  22. package/dist/connector/index.d.ts +5 -0
  23. package/dist/connector/index.d.ts.map +1 -0
  24. package/dist/connector/reconnect-delay.d.ts +32 -0
  25. package/dist/connector/reconnect-delay.d.ts.map +1 -0
  26. package/dist/connector/tunnel-connector.d.ts +128 -0
  27. package/dist/connector/tunnel-connector.d.ts.map +1 -0
  28. package/dist/demo/hub-harness.d.ts +31 -0
  29. package/dist/demo/hub-harness.d.ts.map +1 -0
  30. package/dist/hub/index.d.ts +3 -0
  31. package/dist/hub/index.d.ts.map +1 -0
  32. package/dist/hub/registry.d.ts +45 -0
  33. package/dist/hub/registry.d.ts.map +1 -0
  34. package/dist/index.d.ts +13 -0
  35. package/dist/index.d.ts.map +1 -0
  36. package/dist/index.js +1922 -0
  37. package/dist/logger/index.d.ts +2 -0
  38. package/dist/logger/index.d.ts.map +1 -0
  39. package/dist/logger/interface.d.ts +19 -0
  40. package/dist/logger/interface.d.ts.map +1 -0
  41. package/dist/protocol/index.d.ts +2 -0
  42. package/dist/protocol/index.d.ts.map +1 -0
  43. package/dist/protocol/messages.d.ts +226 -0
  44. package/dist/protocol/messages.d.ts.map +1 -0
  45. package/dist/proxy/hub-session-store.d.ts +55 -0
  46. package/dist/proxy/hub-session-store.d.ts.map +1 -0
  47. package/dist/proxy/index.d.ts +8 -0
  48. package/dist/proxy/index.d.ts.map +1 -0
  49. package/dist/proxy/session-gateway.d.ts +85 -0
  50. package/dist/proxy/session-gateway.d.ts.map +1 -0
  51. package/dist/proxy/stream-sink.d.ts +18 -0
  52. package/dist/proxy/stream-sink.d.ts.map +1 -0
  53. package/dist/proxy/tunnel-proxy.d.ts +126 -0
  54. package/dist/proxy/tunnel-proxy.d.ts.map +1 -0
  55. package/dist/result/domain-error.d.ts +50 -0
  56. package/dist/result/domain-error.d.ts.map +1 -0
  57. package/dist/result/index.d.ts +4 -0
  58. package/dist/result/index.d.ts.map +1 -0
  59. package/dist/result/result.d.ts +24 -0
  60. package/dist/result/result.d.ts.map +1 -0
  61. package/dist/session/__test-helpers__/jose-signer.d.ts +13 -0
  62. package/dist/session/__test-helpers__/jose-signer.d.ts.map +1 -0
  63. package/dist/session/__test-helpers__/jose-signer.js +30 -0
  64. package/dist/session/client-session-server.d.ts +23 -0
  65. package/dist/session/client-session-server.d.ts.map +1 -0
  66. package/dist/session/client-session-store.d.ts +59 -0
  67. package/dist/session/client-session-store.d.ts.map +1 -0
  68. package/dist/session/index.d.ts +4 -0
  69. package/dist/session/index.d.ts.map +1 -0
  70. package/dist/token/index.d.ts +2 -0
  71. package/dist/token/index.d.ts.map +1 -0
  72. package/dist/token/interface.d.ts +18 -0
  73. package/dist/token/interface.d.ts.map +1 -0
  74. package/dist/types.d.ts +16 -0
  75. package/dist/types.d.ts.map +1 -0
  76. package/package.json +61 -4
@@ -0,0 +1,2 @@
1
+ export type { ILogger, TunnelLogInput } from "./interface";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logger/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * lib logger sözleşmesi — JENERİK, minimal.
3
+ *
4
+ * Tünel modülleri yalnızca bu arayüzü bilir; monorepo'da `TamperLogger`
5
+ * yapısal olarak uygular (eventCode serbest string — sözlük doğrulaması
6
+ * tüketicinin eventCodeValidator'ına aittir). Logger verilmezse log çağrıları
7
+ * atlanır (kademeli bozulma).
8
+ */
9
+ export interface TunnelLogInput {
10
+ level: "debug" | "info" | "warn" | "error" | "fatal";
11
+ category: "app" | "audit" | "security";
12
+ eventCode: string;
13
+ message: string;
14
+ context?: Record<string, unknown>;
15
+ }
16
+ export interface ILogger {
17
+ log(input: TunnelLogInput): Promise<void>;
18
+ }
19
+ //# sourceMappingURL=interface.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/logger/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACrD,QAAQ,EAAE,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}
@@ -0,0 +1,2 @@
1
+ export * from "./messages";
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}
@@ -0,0 +1,226 @@
1
+ import { z } from "zod";
2
+ import type { TunnelRole } from "../types";
3
+ /**
4
+ * WS tüneli kontrol kanalı sözleşmesi — JENERİK transport.
5
+ *
6
+ * İki frame sınıfı vardır: text frame'leri = kontrol mesajları (bu dosya),
7
+ * binary frame'leri = tünel akış verisi (`../codec`).
8
+ *
9
+ * Paket YALNIZ transport + oturum + akış taşır. Telemetri, operasyon ve olay
10
+ * mesajları pakette DEĞİLDİR; tüketici kendi modülünde (jenerik kontrol kanalı
11
+ * üzerinden) tanımlar — wire şekilleri değişmez.
12
+ */
13
+ /**
14
+ * WS kontrol kanalı protokol sürümü — `register.protocolVersion` alanında taşınır.
15
+ * v2: register şeması nötr `peerId` + `peerType` taşır (v1: `containerId`).
16
+ */
17
+ export declare const TUNNEL_PROTOCOL_VERSION = 2;
18
+ /**
19
+ * Tünel uç noktası türü — WIRE değerleri (v2 sözleşmesi).
20
+ * `container`/`field` mevcut deployment rollerinin wire adlarıdır; `device`
21
+ * jenerik peer'dır. Anlam `services[]` ve tüketici config'iyle gelir.
22
+ */
23
+ export type TunnelPeerType = "container" | "field" | "device";
24
+ /** Bilinen peer türleri — `register.peerType` doğrulaması için. */
25
+ export declare const TUNNEL_PEER_TYPES: readonly TunnelPeerType[];
26
+ /**
27
+ * Peer bağlantı durumu — HUB tarafı görünümü.
28
+ *
29
+ * - `idle`: kayıtlı ama WS kapalı
30
+ * - `connected`: register tamam + heartbeat akıyor
31
+ * - `stale`: heartbeat 45 sn sessiz (WS hâlâ açık olabilir — yarı ölü)
32
+ * - `error`: WS hata bildirdi
33
+ */
34
+ export type PeerConnectionState = "idle" | "connected" | "stale" | "error";
35
+ /** Verilen değer geçerli bir PeerConnectionState mi? */
36
+ export declare function isPeerConnectionState(value: unknown): value is PeerConnectionState;
37
+ /**
38
+ * TunnelConnector durum makinesi (client tarafı):
39
+ *
40
+ * ```
41
+ * [*] --> offline
42
+ * offline --> connecting: start() veya backoff bitti
43
+ * connecting --> registered: register-ack ok
44
+ * connecting --> backoff: hata/401/timeout
45
+ * registered --> connected: ilk heartbeat gönderildi
46
+ * connected --> backoff: WS kapandı / heartbeat timeout
47
+ * backoff --> connecting: exp(2^n·1s)+jitter, max 60s
48
+ * connected --> [*]: stop()
49
+ * ```
50
+ */
51
+ export type TunnelConnectorState = "offline" | "connecting" | "registered" | "connected" | "backoff";
52
+ /**
53
+ * Operational config — hub'dan `register-ack.config` veya `config-update`
54
+ * frame'iyle canlı push edilir; client restart'sız uygular.
55
+ *
56
+ * ZORUNLU alan YOKTUR — gelen obje `DEFAULT_TUNNEL_OPERATIONAL_CONFIG` üzerine
57
+ * merge edilir. Bilinmeyen anahtarlar strip edilir (ileri uyumluluk).
58
+ */
59
+ export interface TunnelOperationalConfig {
60
+ /** Heartbeat gönderim aralığı (ms). Bant: 1000-300000. Varsayılan: 15000. */
61
+ heartbeatIntervalMs?: number;
62
+ }
63
+ /** Operational config zod şeması — bilinmeyen anahtarlar strip edilir. */
64
+ export declare const tunnelOperationalConfigSchema: z.ZodObject<{
65
+ heartbeatIntervalMs: z.ZodOptional<z.ZodNumber>;
66
+ }, "strip", z.ZodTypeAny, {
67
+ heartbeatIntervalMs?: number | undefined;
68
+ }, {
69
+ heartbeatIntervalMs?: number | undefined;
70
+ }>;
71
+ /** Varsayılan operational config — heartbeat 15 sn. */
72
+ export declare const DEFAULT_TUNNEL_OPERATIONAL_CONFIG: Readonly<Required<TunnelOperationalConfig>>;
73
+ /** Bilinen kontrol mesajı tipleri — paket yalnız transport/oturum/akış taşır. */
74
+ export declare const TUNNEL_MESSAGE_TYPES: readonly ["register", "register-ack", "config-update", "heartbeat", "open-session", "open-session-ack", "session-end", "stream-open", "stream-open-ack", "stream-window", "stream-close", "error"];
75
+ /** Client→Hub: İlk mesaj — service token'lı upgrade sonrası gönderilir. */
76
+ export interface RegisterMessage {
77
+ type: "register";
78
+ /** Peer kimliği — v2 nötr ad. */
79
+ peerId: string;
80
+ /** Peer türü — hub kayıt/doğrulama tarafını seçer. */
81
+ peerType: TunnelPeerType;
82
+ /** Bilgi amaçlıdır — hub yalnızca registry'deki URL'i trust eder (SSRF). */
83
+ peerUrl?: string;
84
+ /**
85
+ * Peer'ın sunduğu OPAK servisler (opsiyonel). Hub yalnızca `id`+`meta`
86
+ * bilir; hedef adres/protokol/endpoint BİLMEZ (opaklık ilkesi).
87
+ */
88
+ services?: ServiceAnnouncement[];
89
+ protocolVersion: number;
90
+ }
91
+ /**
92
+ * Peer servis duyurusu — OPAK.
93
+ *
94
+ * Yalnızca isim + kozmetik meta taşır. Hedef adres / protokol / health /
95
+ * endpoint alanı **YOKTUR ve eklenemez**: hub servisin içini bilmez; hedef
96
+ * peer'ın lokal config'inde kalır (SSRF ilkesi).
97
+ */
98
+ export interface ServiceAnnouncement {
99
+ /** Servis kimliği — peer içinde benzersiz, boş olamaz. */
100
+ id: string;
101
+ /** Kozmetik meta (dashboard) — davranışsal anlam taşımaz. */
102
+ meta?: {
103
+ title?: string;
104
+ icon?: string;
105
+ };
106
+ }
107
+ /**
108
+ * Servis duyurusu zod şeması — STRICT: bilinmeyen alan RED (opaklık sınırı).
109
+ */
110
+ export declare const serviceAnnouncementSchema: z.ZodObject<{
111
+ id: z.ZodString;
112
+ meta: z.ZodOptional<z.ZodObject<{
113
+ title: z.ZodOptional<z.ZodString>;
114
+ icon: z.ZodOptional<z.ZodString>;
115
+ }, "strict", z.ZodTypeAny, {
116
+ title?: string | undefined;
117
+ icon?: string | undefined;
118
+ }, {
119
+ title?: string | undefined;
120
+ icon?: string | undefined;
121
+ }>>;
122
+ }, "strict", z.ZodTypeAny, {
123
+ id: string;
124
+ meta?: {
125
+ title?: string | undefined;
126
+ icon?: string | undefined;
127
+ } | undefined;
128
+ }, {
129
+ id: string;
130
+ meta?: {
131
+ title?: string | undefined;
132
+ icon?: string | undefined;
133
+ } | undefined;
134
+ }>;
135
+ /** Hub→Client: Doğrulama sonucu + opsiyonel operational config. */
136
+ export interface RegisterAckMessage {
137
+ type: "register-ack";
138
+ status: "ok" | "rejected";
139
+ serverTime: string;
140
+ config?: TunnelOperationalConfig;
141
+ }
142
+ /** Hub→Client: Canlı operational config push — yeniden başlatma gerektirmez. */
143
+ export interface ConfigUpdateMessage {
144
+ type: "config-update";
145
+ config: TunnelOperationalConfig;
146
+ }
147
+ /** Client→Hub: 15 sn'de bir; `ts` = gönderen saati (ms epoch). */
148
+ export interface HeartbeatMessage {
149
+ type: "heartbeat";
150
+ ts: number;
151
+ }
152
+ /** Her iki yön: protokol hatası (kod + insan-okunur mesaj). */
153
+ export interface ErrorMessage {
154
+ type: "error";
155
+ code: string;
156
+ message: string;
157
+ }
158
+ /** Hub→Client: oturum isteği — `user.role` hub tarafında EŞLENMİŞ client rolüdür. */
159
+ export interface OpenSessionMessage {
160
+ type: "open-session";
161
+ sessionId: string;
162
+ user: {
163
+ id: string;
164
+ username: string;
165
+ role: TunnelRole;
166
+ };
167
+ }
168
+ /** Client→Hub: kısa ömürlü client JWT'si (kendi secret'i). */
169
+ export interface OpenSessionAckMessage {
170
+ type: "open-session-ack";
171
+ sessionId: string;
172
+ token: string;
173
+ expiresInSec: number;
174
+ }
175
+ /** Hub→Client: oturumu kapat (iptal / TTL / hub restart). */
176
+ export interface SessionEndMessage {
177
+ type: "session-end";
178
+ sessionId: string;
179
+ reason: string;
180
+ }
181
+ /** Hub→Client: yeni HTTP/WS akışı — `upgrade:"websocket"` ise WS köprüsü. */
182
+ export interface StreamOpenMessage {
183
+ type: "stream-open";
184
+ streamId: number;
185
+ sessionId: string;
186
+ method: string;
187
+ path: string;
188
+ headers?: Record<string, string>;
189
+ upgrade?: "websocket";
190
+ }
191
+ /** Client→Hub: yanıt başladı (HTTP durum kodu + başlıklar; WS için 101). */
192
+ export interface StreamOpenAckMessage {
193
+ type: "stream-open-ack";
194
+ streamId: number;
195
+ statusCode: number;
196
+ headers?: Record<string, string>;
197
+ }
198
+ /** Her iki yön: akış kredisi (backpressure — pencere 256 KiB). */
199
+ export interface StreamWindowMessage {
200
+ type: "stream-window";
201
+ streamId: number;
202
+ credit: number;
203
+ }
204
+ /** Her iki yön: akış sonu. */
205
+ export interface StreamCloseMessage {
206
+ type: "stream-close";
207
+ streamId: number;
208
+ reason: string;
209
+ }
210
+ /** Oturum + akış mesajları (tünel alt kümesi). */
211
+ export type SessionStreamMessage = OpenSessionMessage | OpenSessionAckMessage | SessionEndMessage | StreamOpenMessage | StreamOpenAckMessage | StreamWindowMessage | StreamCloseMessage;
212
+ /**
213
+ * Kanal üzerindeki paket kontrol mesajları. Tüketici domain mesajları
214
+ * (telemetri/operasyon/olay) burada DEĞİLDİR; bilinmeyen tipler abonelere akar.
215
+ */
216
+ export type TunnelControlMessage = RegisterMessage | RegisterAckMessage | ConfigUpdateMessage | HeartbeatMessage | ErrorMessage | SessionStreamMessage;
217
+ /**
218
+ * Hub bağlantı durumu — client UI göstergesini besler.
219
+ * `lastHeartbeatAt` hiç gönderilmemişse undefined.
220
+ */
221
+ export interface TunnelConnectionStatus {
222
+ connected: boolean;
223
+ state: TunnelConnectorState;
224
+ lastHeartbeatAt?: string;
225
+ }
226
+ //# sourceMappingURL=messages.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/protocol/messages.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ import type { TunnelRole, TunnelUser } from "../types";
2
+ /** Hub tarafı oturum kaydı — cookie (client JWT) ile eşlenir. */
3
+ export interface HubSession {
4
+ sessionId: string;
5
+ peerId: string;
6
+ /** Client JWT'si — cookie değeri (hub içeriğini görmez — §5.4). */
7
+ token: string;
8
+ /** Hub kullanıcısı (site erişimleriyle). */
9
+ user: TunnelUser;
10
+ /** Eşlenmiş client rolü (§5.5). */
11
+ peerRole: TunnelRole;
12
+ createdAt: number;
13
+ lastActivityAt: number;
14
+ bytesIn: number;
15
+ bytesOut: number;
16
+ }
17
+ /** HubSessionStore yapılandırması — opsiyonel alanlar testlerde enjekte edilir. */
18
+ export interface HubSessionStoreConfig {
19
+ /** Oturum ömrü (ms) — varsayılan 4 saat (§5.6). */
20
+ ttlMs?: number;
21
+ /** Boşta kalma süresi (ms) — varsayılan 15 dk (§5.6). */
22
+ idleTimeoutMs?: number;
23
+ /** Zaman kaynağı — testlerde deterministik. */
24
+ now?: () => number;
25
+ }
26
+ /**
27
+ * HubSessionStore — hub tarafı oturum kayıtları (tasarım §5.7).
28
+ * Cookie → oturum eşlemesi burada tutulur; `sweep()` TTL/idle süresi dolan
29
+ * oturumları kapatır. Client tarafı periyodik TTL sweep'iyle birlikte
30
+ * orphan session temizliği sağlanır (kırılganlık #3).
31
+ */
32
+ export declare class HubSessionStore {
33
+ private sessions;
34
+ private readonly ttlMs;
35
+ private readonly idleTimeoutMs;
36
+ private readonly now;
37
+ constructor(config?: HubSessionStoreConfig);
38
+ /** Oturumu kaydeder (komut) — token → oturum eşlemesi. */
39
+ register(session: HubSession): void;
40
+ /** Cookie değeriyle oturumu bulur (sorgu — liveness saatini tazeler). */
41
+ byToken(token: string): HubSession | undefined;
42
+ /** sessionId ile oturumu bulur (sorgu). */
43
+ byId(sessionId: string): HubSession | undefined;
44
+ /** Tüm açık oturumlar üzerinde gezinme (sorgu). */
45
+ byIdIterable(): IterableIterator<HubSession>;
46
+ /** Oturumu kapatır (komut). */
47
+ end(sessionId: string): void;
48
+ /** Peer başına açık oturum sayısı (sorgu) — limit kontrolü (§5.6). */
49
+ countFor(peerId: string): number;
50
+ /** TTL/idle süresi dolan oturumları düşürür (komut) — sona erenleri döner. */
51
+ sweep(): HubSession[];
52
+ /** Açık oturum sayısı (sorgu). */
53
+ activeCount(): number;
54
+ }
55
+ //# sourceMappingURL=hub-session-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hub-session-store.d.ts","sourceRoot":"","sources":["../../src/proxy/hub-session-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,EAAE,UAAU,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAKD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAIvB,MAAM,GAAE,qBAA0B;IAM9C,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAInC,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAU9C,2CAA2C;IAC3C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C,mDAAmD;IACnD,YAAY,IAAI,gBAAgB,CAAC,UAAU,CAAC;IAI5C,+BAA+B;IAC/B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI5B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAQhC,8EAA8E;IAC9E,KAAK,IAAI,UAAU,EAAE;IAerB,kCAAkC;IAClC,WAAW,IAAI,MAAM;CAGtB"}
@@ -0,0 +1,8 @@
1
+ export { HubSessionStore } from "./hub-session-store";
2
+ export type { HubSession, HubSessionStoreConfig } from "./hub-session-store";
3
+ export { SessionGateway, mapSessionRole } from "./session-gateway";
4
+ export type { SessionGatewayConfig, OpenSessionInput, OpenSessionOutcome, } from "./session-gateway";
5
+ export { TunnelProxy, sessionCookieValue, isPathAllowed, DEFAULT_PATH_ALLOWLIST } from "./tunnel-proxy";
6
+ export type { TunnelProxyConfig, PathAllowlist } from "./tunnel-proxy";
7
+ export type { IStreamSink } from "./stream-sink";
8
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxG,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,85 @@
1
+ import { Result } from "../result";
2
+ import type { DomainError } from "../result";
3
+ import type { ILogger } from "../logger";
4
+ import type { IHubChannel } from "../channel";
5
+ import type { IAuditSink } from "../audit";
6
+ import type { TunnelRole, TunnelUser } from "../types";
7
+ import { HubSessionStore } from "./hub-session-store";
8
+ import type { HubSession } from "./hub-session-store";
9
+ /** Gateway yapılandırması — opsiyonel alanlar testlerde enjekte edilir. */
10
+ export interface SessionGatewayConfig {
11
+ /** open-session ack bekleme süresi (ms). */
12
+ ackTimeoutMs?: number;
13
+ /** Peer başına azami eşzamanlı oturum (tasarım §5.6: 1). */
14
+ maxSessionsPerPeer?: number;
15
+ /** Sweep aralığı (ms) — TTL/idle sonlandırma. */
16
+ sweepIntervalMs?: number;
17
+ /** Zaman kaynağı — testlerde deterministik. */
18
+ now?: () => number;
19
+ }
20
+ /** Oturum açma girdisi — route katmanından gelir. */
21
+ export interface OpenSessionInput {
22
+ /** Hub site kimliği — audit korelasyonu (tüketici anlamı). */
23
+ hubId: string;
24
+ peerId: string;
25
+ user: TunnelUser;
26
+ remoteIp?: string;
27
+ }
28
+ /** Başarılı oturum açılışı — cookie değeri + geçerlilik süresi. */
29
+ export interface OpenSessionOutcome {
30
+ sessionId: string;
31
+ token: string;
32
+ expiresInSec: number;
33
+ peerRole: TunnelRole;
34
+ }
35
+ /**
36
+ * Hub rolü → client rolü eşlemesi (tasarım §5.5, 2026-08-30 BİREBİR):
37
+ * roller iki uygulamada da aynıdır ve aynen taşınır. Patron'un client'te
38
+ * manevra/kullanıcı yasağı client tarafının rbac matrisiyle sağlanır
39
+ * (commands/users yalnız admin+teknik) — eşleme katmanında gizleme YOKTUR.
40
+ */
41
+ export declare function mapSessionRole(role: TunnelRole): TunnelRole;
42
+ /**
43
+ * SessionGateway — hub tarafı oturum yöneticisi (tasarım §5, T3.3).
44
+ *
45
+ * Akış: POST session → RBAC+site yetkisi (route'ta) → limit kontrolü → `open-session`
46
+ * frame'i → client kendi secret'iyle JWT üretir → `open-session-ack` →
47
+ * session_audit (fail-closed — K0.5) → cookie (Path-scoped, HttpOnly).
48
+ *
49
+ * Yaşam döngüsü (§5.7): TTL 4 sa / idle 15 dk sweep → `session-end` yayını +
50
+ * audit kapanışı; hub restart sonrası bilinen oturumlar açılışta kapatılır.
51
+ */
52
+ export declare class SessionGateway {
53
+ private readonly channel;
54
+ private readonly sessions;
55
+ private readonly audit;
56
+ private readonly logger;
57
+ private readonly ackTimeoutMs;
58
+ private readonly maxSessionsPerPeer;
59
+ private readonly sweepIntervalMs;
60
+ private readonly now;
61
+ private pendingAcks;
62
+ private sweepTimer?;
63
+ private unsubscribe?;
64
+ constructor(channel: IHubChannel, sessions: HubSessionStore, audit: IAuditSink, logger: ILogger | undefined, config?: SessionGatewayConfig);
65
+ /** Observer + sweep kurulumu (komut). */
66
+ initialize(): void;
67
+ /** Observer + sweep kapatma (komut). */
68
+ stop(): void;
69
+ /** Cookie değeriyle oturumu bulur (sorgu). */
70
+ sessionByToken(token: string): HubSession | undefined;
71
+ /** Peer başına açık oturumu bulur (sorgu — Faz 5 kapatma akışı). */
72
+ sessionForPeer(peerId: string): HubSession | undefined;
73
+ /**
74
+ * Oturum açar (komut — başarısızlık Result ile, beklenen alan hatası):
75
+ * limit aşımı → ConflictError; client bağlı değil → TransientError;
76
+ * guest → ForbiddenError; ack zaman aşımı → TransientError; audit hatası →
77
+ * FatalError (fail-closed — oturum AÇILMAZ).
78
+ */
79
+ openSession(input: OpenSessionInput): Promise<Result<OpenSessionOutcome, DomainError>>;
80
+ /** Oturumu kapatır (komut) — `session-end` yayını + audit kapanışı. */
81
+ closeSession(sessionId: string, reason: string): void;
82
+ /** TTL/idle süresi dolan oturumları kapatır (komut — sweep). */
83
+ private sweep;
84
+ }
85
+ //# sourceMappingURL=session-gateway.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-gateway.d.ts","sourceRoot":"","sources":["../../src/proxy/session-gateway.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAA6D,MAAM,WAAW,CAAC;AAC9F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAE3D;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IAYvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAdzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,WAAW,CAAgE;IACnF,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,WAAW,CAAC,CAAa;gBAKd,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,OAAO,GAAG,SAAS,EAC5C,MAAM,GAAE,oBAAyB;IASnC,yCAAyC;IACzC,UAAU,IAAI,IAAI;IAelB,wCAAwC;IACxC,IAAI,IAAI,IAAI;IAOZ,8CAA8C;IAC9C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIrD,oEAAoE;IACpE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAOtD;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAC;IAiG5F,uEAAuE;IACvE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA2BrD,gEAAgE;IAChE,OAAO,CAAC,KAAK;CAkBd"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * IStreamSink — tünel proxy'sinin yazdığı HTTP yanıt görünümü (jenerik).
3
+ * Monorepo implementasyonu: `FastifyStreamSink` (web-service — `reply.raw`
4
+ * ServerResponse'unu sarar). RST/destroy akış iptalidir.
5
+ */
6
+ export interface IStreamSink {
7
+ /** HTTP durum kodu + başlıklar (writeHead karşılığı). */
8
+ status(code: number, headers?: Record<string, string>): void;
9
+ /** Gövde parçası yazar. */
10
+ write(chunk: Buffer): void;
11
+ /** Yanıtı normal sonlandırır. */
12
+ end(): void;
13
+ /** Yanıtı iptal eder (RST / istemci kopması). */
14
+ destroy(): void;
15
+ /** İstemci bağlantısı kapandığında bildirir. */
16
+ onClose(callback: () => void): void;
17
+ }
18
+ //# sourceMappingURL=stream-sink.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stream-sink.d.ts","sourceRoot":"","sources":["../../src/proxy/stream-sink.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7D,2BAA2B;IAC3B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iCAAiC;IACjC,GAAG,IAAI,IAAI,CAAC;IACZ,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAAC;IAChB,gDAAgD;IAChD,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACrC"}
@@ -0,0 +1,126 @@
1
+ import type { ILogger } from "../logger";
2
+ import type { IHubChannel } from "../channel";
3
+ import { HubSessionStore } from "./hub-session-store";
4
+ import type { HubSession } from "./hub-session-store";
5
+ import type { IStreamSink } from "./stream-sink";
6
+ /**
7
+ * Path allowlist/blocklist — deployment-bazlı yasaklı listesi config'le
8
+ * enjekte edilir (varsayılanlar tasarım §5.6'dan gelir). İlk eşleşen blok
9
+ * kaybeder: blocklist allowlist'ten önce değerlendirilir.
10
+ */
11
+ export interface PathAllowlist {
12
+ allowedPrefixes?: string[];
13
+ blockedPrefixes?: string[];
14
+ }
15
+ /**
16
+ * Varsayılan path allowlist (jenerik web yolları).
17
+ * Deployment katmanları kendi allowlist/blocklist'lerini bu sabitin üzerine
18
+ * kurar (domain yasaklıları tüketicide tanımlanır).
19
+ */
20
+ export declare const DEFAULT_PATH_ALLOWLIST: PathAllowlist;
21
+ /** TunnelProxy yapılandırması — opsiyonel alanlar testlerde enjekte edilir. */
22
+ export interface TunnelProxyConfig {
23
+ /** Akış kredisi pencere boyutu (tasarım §5.2: 256 KiB). */
24
+ windowSize?: number;
25
+ /** Eşzamanlı akış tavanı (tasarım §5.6: 16). */
26
+ maxStreams?: number;
27
+ /** stream-open-ack bekleme süresi (ms). */
28
+ streamTimeoutMs?: number;
29
+ /** Akış boşta kalma süresi (ms). */
30
+ idleTimeoutMs?: number;
31
+ /** Akış azami yaşı (ms). */
32
+ maxAgeMs?: number;
33
+ /** Sweep aralığı (ms). */
34
+ sweepIntervalMs?: number;
35
+ /** Oturum cookie adı — tüketici enjekte eder (varsayılan nötr: `tunnel_session`). */
36
+ cookieName?: string;
37
+ /** Path allowlist/blocklist — varsayılanlar §5.6'dan. */
38
+ pathAllowlist?: PathAllowlist;
39
+ /** Zaman kaynağı — testlerde deterministik. */
40
+ now?: () => number;
41
+ }
42
+ interface WsStreamState {
43
+ streamId: number;
44
+ session: HubSession;
45
+ browserSocket: {
46
+ send(data: Buffer | string, options?: {
47
+ binary?: boolean;
48
+ }): void;
49
+ close(code?: number): void;
50
+ };
51
+ seq: number;
52
+ createdAt: number;
53
+ lastActivityAt: number;
54
+ }
55
+ /** Cookie başlığından verilen isimli cookie değerini çözer (sorgu — saf). */
56
+ export declare function sessionCookieValue(cookieHeader: string | undefined, cookieName?: string): string | undefined;
57
+ /** Path allowlist — tasarım §5.6; blocklist önce değerlendirilir. */
58
+ export declare function isPathAllowed(path: string, allowlist?: PathAllowlist): boolean;
59
+ /**
60
+ * TunnelProxy — hub tarafı `/peers/:peerId/ui/*` HTTP/WS proxy'si
61
+ * (tasarım §5.2/§5.3, T3.3). Tarayıcı isteğini stream-open frame'lerine
62
+ * çevirir; binary frame'leri yanıt akışına borular; `stream-window` kredisiyle
63
+ * client'a akış izni verir; WS upgrade → çift yönlü WS_OP köprüsü.
64
+ */
65
+ export declare class TunnelProxy {
66
+ private readonly channel;
67
+ private readonly sessions;
68
+ private readonly logger;
69
+ private readonly config;
70
+ private readonly pathAllowlist;
71
+ private readonly codec;
72
+ private readonly now;
73
+ private nextStreamId;
74
+ private pendingAcks;
75
+ private httpStreams;
76
+ private wsStreams;
77
+ private sweepTimer?;
78
+ private unsubscribeControl?;
79
+ private unsubscribeBinary?;
80
+ constructor(channel: IHubChannel, sessions: HubSessionStore, logger: ILogger | undefined, config?: TunnelProxyConfig);
81
+ /** Observer + sweep kurulumu (komut). */
82
+ initialize(): void;
83
+ /** Observer + sweep kapatma (komut). */
84
+ stop(): void;
85
+ /** Cookie → oturum doğrulama (sorgu) — peerId eşleşmesi dahil. */
86
+ authenticate(cookieHeader: string | undefined, peerId: string): HubSession | undefined;
87
+ /** HTTP akışını başlatır (komut) — Fastify handler'ından çağrılır. */
88
+ startHttpStream(input: {
89
+ session: HubSession;
90
+ method: string;
91
+ path: string;
92
+ headers: Record<string, string>;
93
+ raw: IStreamSink;
94
+ requestBody?: Buffer;
95
+ }): Promise<void>;
96
+ /** WS köprüsünü başlatır (komut) — açılırsa streamId döner. */
97
+ startWsBridge(input: {
98
+ session: HubSession;
99
+ path: string;
100
+ browserSocket: WsStreamState["browserSocket"];
101
+ /** Upstream WS handshake'ine taşınacak başlıklar (cookie/auth vb.). */
102
+ headers?: Record<string, string>;
103
+ }): Promise<number | undefined>;
104
+ /** Tarayıcı WS'ini kapatır (komut) — `stream-close` + temizlik. */
105
+ closeWs(streamId: number, reason: string): void;
106
+ /** Tarayıcı WS mesajını client'a iletir (komut). */
107
+ sendWsToPeer(streamId: number, data: Buffer, isBinary: boolean): void;
108
+ /** stream-open gönderir ve ack vaadini döner — gövde ack'ten önce akabilir. */
109
+ private sendStreamOpen;
110
+ /** Ack'i zaman aşımıyla bekler — yoksa kaydı temizler, undefined döner. */
111
+ private raceAck;
112
+ private onControlMessage;
113
+ private onBinaryFrame;
114
+ private onHttpFrame;
115
+ private onWsFrame;
116
+ private sendBodyFrames;
117
+ private grantCredit;
118
+ private closeStream;
119
+ private cleanupHttp;
120
+ private cleanupWs;
121
+ private logStreamClose;
122
+ private assignStreamId;
123
+ private sweep;
124
+ }
125
+ export {};
126
+ //# sourceMappingURL=tunnel-proxy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tunnel-proxy.d.ts","sourceRoot":"","sources":["../../src/proxy/tunnel-proxy.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /** Hata kategorisi — sınır katmanının 4xx/5xx eşlemesi ve retry kararı için. */
2
+ export type ErrorKind = "validation" | "not_found" | "unauthorized" | "forbidden" | "conflict" | "transient" | "fatal";
3
+ /** DomainError yapılandırması — constructor'a tek obje olarak verilir. */
4
+ export interface DomainErrorOptions {
5
+ kind: ErrorKind;
6
+ retryable: boolean;
7
+ context?: Record<string, unknown>;
8
+ cause?: unknown;
9
+ }
10
+ /**
11
+ * DomainError — beklenmeyen hataların tabanı. Fırlatılır (throw); beklenen alan
12
+ * hataları Result<T,E> ile taşınır. Immutable.
13
+ */
14
+ export declare class DomainError extends Error {
15
+ readonly code: string;
16
+ readonly kind: ErrorKind;
17
+ readonly retryable: boolean;
18
+ readonly context: Record<string, unknown>;
19
+ readonly cause: unknown;
20
+ constructor(code: string, message: string, options: DomainErrorOptions);
21
+ }
22
+ /** Alan doğrulama hatası — beklenen; 400'e eşlenir. */
23
+ export declare class ValidationError extends DomainError {
24
+ constructor(code: string, message: string, options?: Pick<DomainErrorOptions, "context" | "cause">);
25
+ }
26
+ /** Kaynak bulunamadı — beklenen; 404'e eşlenir. */
27
+ export declare class NotFoundError extends DomainError {
28
+ constructor(code: string, message: string, options?: Pick<DomainErrorOptions, "context" | "cause">);
29
+ }
30
+ /** Kimlik doğrulama hatası — beklenen; 401'e eşlenir. */
31
+ export declare class UnauthorizedError extends DomainError {
32
+ constructor(code: string, message: string, options?: Pick<DomainErrorOptions, "context" | "cause">);
33
+ }
34
+ /** Yetki hatası — beklenen; 403'e eşlenir. */
35
+ export declare class ForbiddenError extends DomainError {
36
+ constructor(code: string, message: string, options?: Pick<DomainErrorOptions, "context" | "cause">);
37
+ }
38
+ /** Çakışma hatası — beklenen; 409'a eşlenir. */
39
+ export declare class ConflictError extends DomainError {
40
+ constructor(code: string, message: string, options?: Pick<DomainErrorOptions, "context" | "cause">);
41
+ }
42
+ /** Geçici altyapı hatası — sahibi (adapter) retry eder; tükenince fırlatılır. */
43
+ export declare class TransientError extends DomainError {
44
+ constructor(code: string, message: string, options?: Pick<DomainErrorOptions, "context" | "cause">);
45
+ }
46
+ /** Kalıcı altyapı hatası / fault — health düşürülür, alert kuralı tetiklenir. */
47
+ export declare class FatalError extends DomainError {
48
+ constructor(code: string, message: string, options?: Pick<DomainErrorOptions, "context" | "cause">);
49
+ }
50
+ //# sourceMappingURL=domain-error.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"domain-error.d.ts","sourceRoot":"","sources":["../../src/result/domain-error.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,WAAW,GACX,cAAc,GACd,WAAW,GACX,UAAU,GACV,WAAW,GACX,OAAO,CAAC;AAEZ,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB;CAevE;AAED,uDAAuD;AACvD,qBAAa,eAAgB,SAAQ,WAAW;gBAE5C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,CAAC;CAS1D;AAED,mDAAmD;AACnD,qBAAa,aAAc,SAAQ,WAAW;gBAE1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,CAAC;CAS1D;AAED,yDAAyD;AACzD,qBAAa,iBAAkB,SAAQ,WAAW;gBAE9C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,CAAC;CAS1D;AAED,8CAA8C;AAC9C,qBAAa,cAAe,SAAQ,WAAW;gBAE3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,CAAC;CAS1D;AAED,gDAAgD;AAChD,qBAAa,aAAc,SAAQ,WAAW;gBAE1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,CAAC;CAS1D;AAED,iFAAiF;AACjF,qBAAa,cAAe,SAAQ,WAAW;gBAE3C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,CAAC;CAS1D;AAED,iFAAiF;AACjF,qBAAa,UAAW,SAAQ,WAAW;gBAEvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,CAAC;CAS1D"}