@meshwhisper/sdk 0.1.0

package/dist/transport/websocket/serialize.js

@@ -0,0 +1,55 @@
+// ============================================================
+// MeshWhisper SDK — Packet Wire Serialization
+// Pure functions with no platform-specific dependencies.
+// Shared by WebSocketTransport (Node.js) and BrowserTransport.
+//
+// Binary layout (all big-endian):
+//   [0]       version       u8
+//   [1]       flags         u8
+//   [2..9]    destHash      8 bytes
+//   [10..25]  senderEphId   16 bytes
+//   [26]      ttl           u8
+//   [27..30]  payloadLen    u32
+//   [31..]    encrypted payload
+//
+// Total header = 31 bytes.
+// ============================================================
+export const HEADER_SIZE = 31;
+export function serializePacket(packet) {
+    const buf = new Uint8Array(HEADER_SIZE + packet.encryptedPayload.length);
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    buf[0] = packet.version;
+    buf[1] = packet.flags;
+    buf.set(packet.destHash.subarray(0, 8), 2);
+    buf.set(packet.senderEphemeralId.subarray(0, 16), 10);
+    buf[26] = packet.ttl;
+    view.setUint32(27, packet.payloadLength, false);
+    buf.set(packet.encryptedPayload, HEADER_SIZE);
+    return buf;
+}
+export function deserializePacket(data) {
+    if (data.length < HEADER_SIZE) {
+        throw new Error(`Packet too small: ${data.length} bytes (min ${HEADER_SIZE})`);
+    }
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const version = data[0];
+    const flags = data[1];
+    const destHash = data.slice(2, 10);
+    const senderEphemeralId = data.slice(10, 26);
+    const ttl = data[26];
+    const payloadLength = view.getUint32(27, false);
+    const encryptedPayload = data.slice(HEADER_SIZE, HEADER_SIZE + payloadLength);
+    if (encryptedPayload.length !== payloadLength) {
+        throw new Error(`Payload length mismatch: header says ${payloadLength}, got ${encryptedPayload.length}`);
+    }
+    return {
+        version,
+        flags,
+        destHash,
+        senderEphemeralId,
+        ttl,
+        payloadLength,
+        encryptedPayload,
+    };
+}
+//# sourceMappingURL=serialize.js.map

package/dist/transport/websocket/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../../src/transport/websocket/serialize.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8CAA8C;AAC9C,yDAAyD;AACzD,+DAA+D;AAC/D,EAAE;AACF,kCAAkC;AAClC,+BAA+B;AAC/B,+BAA+B;AAC/B,oCAAoC;AACpC,qCAAqC;AACrC,+BAA+B;AAC/B,gCAAgC;AAChC,gCAAgC;AAChC,EAAE;AACF,2BAA2B;AAC3B,+DAA+D;AAI/D,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAE9B,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,WAAW,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAEtE,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IACxB,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;IACrB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAE9C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,MAAM,eAAe,WAAW,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAEzE,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAgB,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IACrB,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAEhD,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC;IAE9E,IAAI,gBAAgB,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,wCAAwC,aAAa,SAAS,gBAAgB,CAAC,MAAM,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO;QACP,KAAK;QACL,QAAQ;QACR,iBAAiB;QACjB,GAAG;QACH,aAAa;QACb,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,215 @@
+export interface KeyPair {
+    publicKey: Uint8Array;
+    privateKey: Uint8Array;
+}
+export interface PreKeyBundle {
+    identityKey: Uint8Array;
+    signedPreKey: Uint8Array;
+    signedPreKeySignature: Uint8Array;
+    oneTimePreKey?: Uint8Array;
+}
+export interface EncryptedPayload {
+    ciphertext: Uint8Array;
+    nonce: Uint8Array;
+    tag: Uint8Array;
+}
+export declare enum PacketFlags {
+    DATA = 1,
+    ACK = 2,
+    CHAFF = 3,
+    HANDSHAKE = 4,
+    ROUTE_REQUEST = 5,
+    ROUTE_OFFER = 6
+}
+export interface Packet {
+    version: number;
+    flags: PacketFlags;
+    destHash: Uint8Array;
+    senderEphemeralId: Uint8Array;
+    ttl: number;
+    payloadLength: number;
+    encryptedPayload: Uint8Array;
+}
+export type BearerType = 'platform_p2p' | 'local_net' | 'internet';
+export type BatteryState = 'charging' | 'high' | 'medium' | 'low' | 'critical';
+export type RelayWillingness = 'eager' | 'willing' | 'reluctant' | 'unavailable';
+export interface DeviceCapability {
+    bearerPlatformP2P: boolean;
+    bearerLocalNet: boolean;
+    bearerInternet: boolean;
+    inboundConnectable: boolean;
+    batteryState: BatteryState;
+    relayWillingness: RelayWillingness;
+}
+export interface Transport {
+    readonly type: BearerType;
+    send(packet: Packet, destination: string): Promise<void>;
+    onReceive(callback: (packet: Packet, source: string) => void): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isAvailable(): Promise<boolean>;
+}
+export interface PeerProximityEntry {
+    peerId: string;
+    destHash: Uint8Array;
+    lastSeen: number;
+    hopCount: number;
+    latency: number;
+    relayPath: string[];
+}
+export interface RouteRequest {
+    destHash: Uint8Array;
+    requestId: Uint8Array;
+    ttl: number;
+    timestamp: number;
+}
+export interface RouteOffer {
+    requestId: Uint8Array;
+    hopCount: number;
+    estimatedLatency: number;
+    offeredBy: string;
+}
+export type PermissionModel = 'open' | 'mutual' | 'introduction' | 'transactional' | 'custom';
+export interface Session {
+    peerId: string;
+    namespaceId: Uint8Array;
+    sharedSecret: Uint8Array;
+    established: number;
+    lastActivity: number;
+}
+export type MessageUrgency = 'background' | 'normal' | 'urgent' | 'critical';
+export type PresenceStatus = 'online' | 'recently_seen' | 'offline' | 'unknown';
+export interface Message {
+    id: string;
+    senderId: string;
+    recipientId: string;
+    payload: Uint8Array;
+    timestamp: number;
+    urgency: MessageUrgency;
+    expiry?: number;
+}
+export interface GroupMember {
+    id: string;
+    senderKey: Uint8Array;
+    role: 'admin' | 'member';
+    joinedAt: number;
+}
+export interface Group {
+    id: string;
+    name: string;
+    members: Map<string, GroupMember>;
+    treeRoot: string;
+    permissionModel: PermissionModel;
+    createdAt: number;
+}
+export interface RelayLedgerEntry {
+    peerId: string;
+    bytesRelayedForThem: number;
+    bytesTheyRelayedForUs: number;
+    lastUpdated: number;
+}
+export type ReciprocityTier = 'contributor' | 'balanced' | 'consumer' | 'freerider';
+export interface ClusterDevice {
+    deviceId: string;
+    clusterKey: Uint8Array;
+    capabilities: DeviceCapability;
+    isPrimary: boolean;
+    lastSync: number;
+}
+export interface StoredBlob {
+    id: string;
+    destHash: Uint8Array;
+    encryptedPayload: Uint8Array;
+    receivedAt: number;
+    ttlHours: number;
+    hopsRemaining: number;
+}
+export type EntropySensorType = 'accelerometer' | 'gyroscope' | 'magnetometer';
+export interface EntropyChallenge {
+    challengeId: Uint8Array;
+    sensorType: EntropySensorType;
+    durationMs: number;
+    timestamp: number;
+}
+export interface EntropyResponse {
+    challengeId: Uint8Array;
+    sensorData: Float64Array;
+    deviceSignature: Uint8Array;
+}
+export type ChaffRate = 'low' | 'normal' | 'high';
+export type AuditExportMode = 'plaintext' | 'encrypted';
+export interface ComplianceConfig {
+    logging?: boolean;
+    auditExport?: AuditExportMode;
+    retentionDays?: number;
+    contentScanning?: (msg: Message) => {
+        approved: boolean;
+        reason?: string;
+    };
+}
+export type MessageHook = (message: Message) => boolean | Promise<boolean>;
+export type { StorageBackend, StoredMessage } from './persistence/types.js';
+/** Web Push subscription object (serialisable form of PushSubscription). */
+export interface WebPushSubscription {
+    endpoint: string;
+    expirationTime?: number | null;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+}
+export type PushConfig = {
+    platform: 'apns';
+    token: string;
+    topic?: string;
+} | {
+    platform: 'fcm';
+    token: string;
+} | {
+    platform: 'webpush';
+    subscription: WebPushSubscription;
+};
+export interface MeshWhisperConfig {
+    namespace: string;
+    /** MeshWhisper Node endpoint(s). Use "mesh" for Foundation-hosted nodes,
+     *  a wss:// URL for self-hosted, or an array for hybrid mode. Defaults to "mesh". */
+    node?: string | string[];
+    /** Optional developer key (base64 public key). If omitted a random key is used,
+     *  which is fine for development and single-tenant deployments. */
+    developerKey?: string;
+    /** Default: "open". */
+    permissionModel?: PermissionModel;
+    /** Push notification token. When set the Node stores the token alongside
+     *  the device's destination hashes and sends a wake signal via the configured
+     *  push webhook when a message arrives while the device is offline. */
+    push?: PushConfig;
+    /**
+     * Persistent storage backend. Provide this to survive process restarts:
+     * sessions, message history, identity, and contacts are all persisted.
+     *
+     * For Node.js: `import { NodeStorage } from '@meshwhisper/sdk/persistence/node'`
+     * For React Native: wrap AsyncStorage or SQLCipher.
+     */
+    storage?: import('./persistence/types.js').StorageBackend;
+    onMessage?: (message: Message) => void;
+    onPresence?: (peerId: string, status: PresenceStatus) => void;
+    /** Called when the delivery status of an outbound message changes. */
+    onMessageStatus?: (messageId: string, status: import('./persistence/types.js').StoredMessage['status']) => void;
+    config?: {
+        relayWillingness?: 'auto' | RelayWillingness;
+        chaffRate?: ChaffRate;
+        storeTTL?: number;
+        clusterEnabled?: boolean;
+    };
+}
+export interface NamespaceConfig {
+    appBundleId: string;
+    developerPublicKey: Uint8Array;
+    salt: Uint8Array;
+}
+export interface EventEmitter<T extends Record<string, unknown>> {
+    on<K extends keyof T>(event: K, handler: (data: T[K]) => void): void;
+    off<K extends keyof T>(event: K, handler: (data: T[K]) => void): void;
+    emit<K extends keyof T>(event: K, data: T[K]): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,15 @@
+// ============================================================
+// MeshWhisper SDK — Shared Types & Interfaces
+// All modules code against these types.
+// ============================================================
+// --- Packet Types ---
+export var PacketFlags;
+(function (PacketFlags) {
+    PacketFlags[PacketFlags["DATA"] = 1] = "DATA";
+    PacketFlags[PacketFlags["ACK"] = 2] = "ACK";
+    PacketFlags[PacketFlags["CHAFF"] = 3] = "CHAFF";
+    PacketFlags[PacketFlags["HANDSHAKE"] = 4] = "HANDSHAKE";
+    PacketFlags[PacketFlags["ROUTE_REQUEST"] = 5] = "ROUTE_REQUEST";
+    PacketFlags[PacketFlags["ROUTE_OFFER"] = 6] = "ROUTE_OFFER";
+})(PacketFlags || (PacketFlags = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8CAA8C;AAC9C,wCAAwC;AACxC,+DAA+D;AAsB/D,uBAAuB;AAEvB,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,6CAAW,CAAA;IACX,2CAAU,CAAA;IACV,+CAAY,CAAA;IACZ,uDAAgB,CAAA;IAChB,+DAAoB,CAAA;IACpB,2DAAkB,CAAA;AACpB,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB"}

package/dist/x3dh/index.d.ts

@@ -0,0 +1,120 @@
+import type { KeyPair, PreKeyBundle } from '../types.js';
+/**
+ * The result of generating a pre-key bundle. The bundle is the public
+ * portion distributed to peers; the key pairs must be stored locally
+ * so that X3DH can be completed on the responder side.
+ */
+export interface GeneratedPreKeyBundle {
+    /** The public bundle to distribute (gossip or directory). */
+    bundle: PreKeyBundle;
+    /** The X25519 signed pre-key pair. Store the private key. */
+    signedPreKeyPair: KeyPair;
+    /** The X25519 one-time pre-key pair. Store the private key. */
+    oneTimePreKeyPair: KeyPair;
+}
+/**
+ * Generates a full PreKeyBundle for distribution to peers.
+ *
+ * The bundle contains:
+ * - Identity key (Ed25519 public key from the provided key pair)
+ * - Signed pre-key (X25519, signed by the identity key)
+ * - One-time pre-key (X25519, single-use)
+ *
+ * The returned `signedPreKeyPair` and `oneTimePreKeyPair` private keys
+ * must be stored by the caller — they are required to complete X3DH on
+ * the responder side when a handshake arrives.
+ *
+ * @param identityKeyPair - Ed25519 identity key pair
+ * @returns Bundle (public) plus the key pairs (private keys must be stored)
+ */
+export declare function generatePreKeyBundle(identityKeyPair: KeyPair): GeneratedPreKeyBundle;
+/**
+ * Generates a batch of one-time pre-keys for replenishment.
+ *
+ * Returns full KeyPairs — the caller must store the private keys.
+ * Only public keys are distributed in the prekey bundle; private keys
+ * are required locally to complete X3DH when a matching handshake arrives.
+ *
+ * @param _identityKeyPair - Unused; kept for API consistency
+ * @param count - Number of one-time pre-keys to generate
+ * @returns Array of X25519 key pairs
+ */
+export declare function generateOneTimePreKeys(_identityKeyPair: KeyPair, count: number): KeyPair[];
+export interface KeyExchangeResult {
+    /** Derived shared secret (BLAKE3 hash of concatenated DH outputs). */
+    sharedSecret: Uint8Array;
+    /** Ephemeral X25519 public key Alice used — must be sent to Bob. */
+    ephemeralPublicKey: Uint8Array;
+    /** Whether a one-time pre-key was consumed in the exchange. */
+    usedOneTimePreKey: boolean;
+}
+/**
+ * Performs the initiator side (Alice) of the X3DH key exchange.
+ *
+ * Executes 3 or 4 DH operations:
+ *   DH1 = DH(IK_A, SPK_B) — Alice's identity key with Bob's signed pre-key
+ *   DH2 = DH(EK_A, IK_B)  — Alice's ephemeral key with Bob's identity key
+ *   DH3 = DH(EK_A, SPK_B) — Alice's ephemeral key with Bob's signed pre-key
+ *   DH4 = DH(EK_A, OPK_B) — Alice's ephemeral key with Bob's one-time pre-key (optional)
+ *
+ * The shared secret is derived as BLAKE3(DH1 || DH2 || DH3 [|| DH4]).
+ *
+ * @param aliceIdentity - Alice's Ed25519 identity key pair
+ * @param bobPreKeyBundle - Bob's published PreKeyBundle
+ * @returns The derived shared secret, ephemeral public key, and OPK usage flag
+ * @throws If the pre-key bundle signature is invalid
+ */
+export declare function initiateKeyExchange(aliceIdentity: KeyPair, bobPreKeyBundle: PreKeyBundle): KeyExchangeResult;
+/**
+ * Performs the responder side (Bob) of the X3DH key exchange.
+ *
+ * Mirrors the initiator's DH operations to derive the same shared secret:
+ *   DH1 = DH(SPK_B, IK_A) — Bob's signed pre-key with Alice's identity key
+ *   DH2 = DH(IK_B, EK_A)  — Bob's identity key with Alice's ephemeral key
+ *   DH3 = DH(SPK_B, EK_A) — Bob's signed pre-key with Alice's ephemeral key
+ *   DH4 = DH(OPK_B, EK_A) — Bob's one-time pre-key with Alice's ephemeral key (optional)
+ *
+ * @param bobIdentity - Bob's Ed25519 identity key pair
+ * @param bobSignedPreKey - Bob's X25519 signed pre-key pair
+ * @param bobOneTimePreKey - Bob's X25519 one-time pre-key pair (null if not used)
+ * @param aliceIdentityKey - Alice's Ed25519 identity public key
+ * @param aliceEphemeralKey - Alice's X25519 ephemeral public key
+ * @returns The derived shared secret (same as Alice's if inputs are correct)
+ */
+export declare function completeKeyExchange(bobIdentity: KeyPair, bobSignedPreKey: KeyPair, bobOneTimePreKey: KeyPair | null, aliceIdentityKey: Uint8Array, aliceEphemeralKey: Uint8Array): Uint8Array;
+/**
+ * Verifies the signed pre-key signature in a PreKeyBundle.
+ *
+ * Checks that the signedPreKey was signed by the holder of the identityKey
+ * using Ed25519.
+ *
+ * @param bundle - The PreKeyBundle to verify
+ * @returns true if the signature is valid, false otherwise
+ */
+export declare function verifyPreKeyBundle(bundle: PreKeyBundle): boolean;
+/**
+ * Serializes a PreKeyBundle to a compact binary format for gossip distribution.
+ *
+ * Wire format:
+ *   [version: 1 byte]
+ *   [flags: 1 byte]       — bit 0: hasOneTimePreKey
+ *   [identityKey: 32 bytes]
+ *   [signedPreKey: 32 bytes]
+ *   [signedPreKeySignature: 64 bytes]
+ *   [oneTimePreKey: 32 bytes]  — optional, present if flags bit 0 is set
+ *
+ * Total: 130 bytes without OPK, 162 bytes with OPK.
+ *
+ * @param bundle - The PreKeyBundle to serialize
+ * @returns Serialized binary representation
+ */
+export declare function serializePreKeyBundle(bundle: PreKeyBundle): Uint8Array;
+/**
+ * Deserializes a PreKeyBundle from its binary representation.
+ *
+ * @param data - Serialized PreKeyBundle bytes
+ * @returns The deserialized PreKeyBundle
+ * @throws If the data is malformed or has an unsupported version
+ */
+export declare function deserializePreKeyBundle(data: Uint8Array): PreKeyBundle;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/x3dh/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAezD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAC;IACrB,6DAA6D;IAC7D,gBAAgB,EAAE,OAAO,CAAC;IAC1B,+DAA+D;IAC/D,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,OAAO,GAAG,qBAAqB,CA4BpF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,OAAO,EACzB,KAAK,EAAE,MAAM,GACZ,OAAO,EAAE,CAWX;AAID,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,YAAY,EAAE,UAAU,CAAC;IACzB,oEAAoE;IACpE,kBAAkB,EAAE,UAAU,CAAC;IAC/B,+DAA+D;IAC/D,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,OAAO,EACtB,eAAe,EAAE,YAAY,GAC5B,iBAAiB,CA4CnB;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,OAAO,EACpB,eAAe,EAAE,OAAO,EACxB,gBAAgB,EAAE,OAAO,GAAG,IAAI,EAChC,gBAAgB,EAAE,UAAU,EAC5B,iBAAiB,EAAE,UAAU,GAC5B,UAAU,CA4BZ;AAID;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAUhE;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAgCtE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CA+CtE"}