raffel 0.1.2

package/dist/utils/content-codecs.js

@@ -0,0 +1,201 @@
+function normalizeMediaType(value) {
+    return value.split(';')[0].trim().toLowerCase();
+}
+function matchesPattern(pattern, value) {
+    if (pattern === '*/*')
+        return true;
+    if (!pattern.includes('*'))
+        return pattern === value;
+    const [start, end] = pattern.split('*');
+    return value.startsWith(start) && value.endsWith(end);
+}
+export function selectCodecForContentType(contentType, codecs) {
+    if (!contentType)
+        return null;
+    const mediaType = normalizeMediaType(contentType);
+    for (const codec of codecs) {
+        if (codec.contentTypes.some((type) => matchesPattern(type, mediaType))) {
+            return codec;
+        }
+    }
+    return null;
+}
+export function selectCodecForAccept(accept, codecs, fallback) {
+    if (!accept)
+        return fallback;
+    const ranges = accept.split(',').map((part) => normalizeMediaType(part));
+    for (const range of ranges) {
+        for (const codec of codecs) {
+            if (codec.contentTypes.some((type) => matchesPattern(range, type) || matchesPattern(type, range))) {
+                return codec;
+            }
+        }
+    }
+    return null;
+}
+function parseCsvRow(row) {
+    const values = [];
+    let current = '';
+    let inQuotes = false;
+    for (let i = 0; i < row.length; i += 1) {
+        const char = row[i];
+        if (char === '"') {
+            const next = row[i + 1];
+            if (inQuotes && next === '"') {
+                current += '"';
+                i += 1;
+            }
+            else {
+                inQuotes = !inQuotes;
+            }
+            continue;
+        }
+        if (char === ',' && !inQuotes) {
+            values.push(current);
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    values.push(current);
+    return values;
+}
+function parseCsv(body) {
+    const rows = body
+        .split(/\r?\n/)
+        .map((row) => row.trim())
+        .filter((row) => row.length > 0);
+    if (rows.length === 0)
+        return [];
+    const headers = parseCsvRow(rows[0]).map((header) => header.trim());
+    const hasHeader = headers.some((header) => header.length > 0);
+    if (!hasHeader) {
+        throw new Error('CSV header row is required');
+    }
+    const records = [];
+    for (const row of rows.slice(1)) {
+        const values = parseCsvRow(row);
+        const record = {};
+        for (let i = 0; i < headers.length; i += 1) {
+            const key = headers[i];
+            if (!key)
+                continue;
+            record[key] = values[i] ?? '';
+        }
+        records.push(record);
+    }
+    return records;
+}
+function escapeCsvValue(value) {
+    if (value.includes('"')) {
+        value = value.replace(/"/g, '""');
+    }
+    if (value.includes(',') || value.includes('\n') || value.includes('\r') || value.includes('"')) {
+        return `"${value}"`;
+    }
+    return value;
+}
+function stringifyCsv(value) {
+    if (value === null || value === undefined)
+        return '';
+    const rows = [];
+    const headers = [];
+    const addHeader = (key) => {
+        if (!headers.includes(key)) {
+            headers.push(key);
+        }
+    };
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '';
+        if (value.every((item) => item && typeof item === 'object' && !Array.isArray(item))) {
+            for (const item of value) {
+                for (const key of Object.keys(item)) {
+                    addHeader(key);
+                }
+                rows.push(item);
+            }
+        }
+        else {
+            addHeader('value');
+            for (const item of value) {
+                rows.push({ value: item });
+            }
+        }
+    }
+    else if (typeof value === 'object') {
+        for (const key of Object.keys(value)) {
+            addHeader(key);
+        }
+        rows.push(value);
+    }
+    else {
+        addHeader('value');
+        rows.push({ value });
+    }
+    if (headers.length === 0)
+        return '';
+    const lines = [];
+    lines.push(headers.map(escapeCsvValue).join(','));
+    for (const row of rows) {
+        const line = headers.map((header) => {
+            const cell = row[header];
+            if (cell === null || cell === undefined)
+                return '';
+            if (typeof cell === 'string')
+                return escapeCsvValue(cell);
+            if (typeof cell === 'number' || typeof cell === 'boolean' || typeof cell === 'bigint') {
+                return escapeCsvValue(String(cell));
+            }
+            return escapeCsvValue(JSON.stringify(cell));
+        });
+        lines.push(line.join(','));
+    }
+    return lines.join('\n');
+}
+export const jsonCodec = {
+    name: 'json',
+    contentTypes: ['application/json', 'application/*+json'],
+    encode: (value) => JSON.stringify(value),
+    decode: (body) => JSON.parse(body),
+};
+export const csvCodec = {
+    name: 'csv',
+    contentTypes: ['text/csv'],
+    encode: (value) => stringifyCsv(value),
+    decode: (body) => parseCsv(body),
+};
+export const textCodec = {
+    name: 'text',
+    contentTypes: ['text/plain', 'application/graphql'],
+    encode: (value) => {
+        if (value === null || value === undefined)
+            return '';
+        if (typeof value === 'string')
+            return value;
+        return JSON.stringify(value);
+    },
+    decode: (body) => body,
+};
+export const defaultCodecs = [jsonCodec, textCodec, csvCodec];
+export function resolveCodecs(codecs, fallback = defaultCodecs) {
+    if (!codecs || codecs.length === 0)
+        return fallback;
+    const resolved = [];
+    const seen = new Set();
+    const add = (codec) => {
+        const key = codec.name.toLowerCase();
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        resolved.push(codec);
+    };
+    for (const codec of codecs) {
+        add(codec);
+    }
+    for (const codec of fallback) {
+        add(codec);
+    }
+    return resolved;
+}
+//# sourceMappingURL=content-codecs.js.map

package/dist/utils/content-codecs.js.map

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

package/dist/utils/header-metadata.d.ts

@@ -0,0 +1,6 @@
+import type { IncomingHttpHeaders } from 'node:http';
+export declare function extractMetadataFromHeaders(headers: IncomingHttpHeaders): Record<string, string>;
+export declare function extractMetadataFromRecord(input: unknown): Record<string, string>;
+export declare function sanitizeMetadataRecord(input: unknown): Record<string, string>;
+export declare function mergeMetadata(...sources: Array<Record<string, string> | undefined>): Record<string, string>;
+//# sourceMappingURL=header-metadata.d.ts.map

package/dist/utils/header-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-metadata.d.ts","sourceRoot":"","sources":["../../src/utils/header-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AA8BpD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY/F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAahF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW7E;AAED,wBAAgB,aAAa,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS3G"}

package/dist/utils/header-metadata.js

@@ -0,0 +1,78 @@
+const STANDARD_METADATA_HEADERS = new Set([
+    'authorization',
+    'x-request-id',
+    'traceparent',
+    'tracestate',
+    'content-type',
+    'accept',
+    'cookie',
+]);
+function normalizeMetadataValue(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((item) => normalizeMetadataValue(item))
+            .filter((item) => item !== undefined);
+        return parts.length ? parts.join(',') : undefined;
+    }
+    return undefined;
+}
+function shouldIncludeHeader(key) {
+    return key.startsWith('x-') || STANDARD_METADATA_HEADERS.has(key);
+}
+export function extractMetadataFromHeaders(headers) {
+    const metadata = {};
+    for (const [key, value] of Object.entries(headers)) {
+        const normalizedKey = key.toLowerCase();
+        if (!shouldIncludeHeader(normalizedKey))
+            continue;
+        const normalizedValue = normalizeMetadataValue(value);
+        if (normalizedValue === undefined)
+            continue;
+        metadata[normalizedKey] = normalizedValue;
+    }
+    return metadata;
+}
+export function extractMetadataFromRecord(input) {
+    if (!input || typeof input !== 'object')
+        return {};
+    const metadata = {};
+    for (const [key, value] of Object.entries(input)) {
+        const normalizedKey = key.toLowerCase();
+        if (!shouldIncludeHeader(normalizedKey))
+            continue;
+        const normalizedValue = normalizeMetadataValue(value);
+        if (normalizedValue === undefined)
+            continue;
+        metadata[normalizedKey] = normalizedValue;
+    }
+    return metadata;
+}
+export function sanitizeMetadataRecord(input) {
+    if (!input || typeof input !== 'object')
+        return {};
+    const metadata = {};
+    for (const [key, value] of Object.entries(input)) {
+        const normalizedValue = normalizeMetadataValue(value);
+        if (normalizedValue === undefined)
+            continue;
+        metadata[key.toLowerCase()] = normalizedValue;
+    }
+    return metadata;
+}
+export function mergeMetadata(...sources) {
+    const merged = {};
+    for (const source of sources) {
+        if (!source)
+            continue;
+        for (const [key, value] of Object.entries(source)) {
+            merged[key.toLowerCase()] = value;
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=header-metadata.js.map

package/dist/utils/header-metadata.js.map

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

package/dist/utils/id/alphabets.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ID Alphabets
+ *
+ * Pre-defined character sets for ID generation.
+ * Each alphabet offers different trade-offs between
+ * density (characters per bit) and usability.
+ */
+/**
+ * URL-safe alphabet (64 chars).
+ * Entropy: 6 bits per character
+ * 21 chars = 126 bits of entropy
+ */
+export declare const URL_SAFE = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+/**
+ * URL-safe alphabet without special chars (62 chars).
+ * Alphanumeric only: a-z, A-Z, 0-9
+ * Entropy: ~5.95 bits per character
+ * 22 chars = ~131 bits of entropy
+ */
+export declare const ALPHANUMERIC = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+/**
+ * Lowercase alphanumeric (36 chars).
+ * Entropy: ~5.17 bits per character
+ * 25 chars = ~129 bits of entropy
+ */
+export declare const ALPHANUMERIC_LOWER = "0123456789abcdefghijklmnopqrstuvwxyz";
+/**
+ * Hexadecimal lowercase (16 chars).
+ * Entropy: 4 bits per character
+ * 32 chars = 128 bits of entropy
+ */
+export declare const HEX_LOWER = "0123456789abcdef";
+/**
+ * Hexadecimal uppercase (16 chars).
+ */
+export declare const HEX_UPPER = "0123456789ABCDEF";
+/**
+ * Base58 Bitcoin alphabet (58 chars).
+ * Excludes 0, O, I, l to avoid confusion.
+ * Entropy: ~5.86 bits per character
+ */
+export declare const BASE58 = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+/**
+ * Numeric only (10 chars).
+ * Entropy: ~3.32 bits per character
+ * 39 chars = ~129 bits of entropy
+ */
+export declare const NUMERIC = "0123456789";
+export declare const alphabets: {
+    readonly URL_SAFE: "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+    readonly ALPHANUMERIC: "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+    readonly ALPHANUMERIC_LOWER: "0123456789abcdefghijklmnopqrstuvwxyz";
+    readonly HEX_LOWER: "0123456789abcdef";
+    readonly HEX_UPPER: "0123456789ABCDEF";
+    readonly BASE58: "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+    readonly NUMERIC: "0123456789";
+};
+export type AlphabetName = keyof typeof alphabets;
+/**
+ * Get alphabet by name or return custom alphabet string.
+ */
+export declare function getAlphabet(nameOrCustom: AlphabetName | string): string;
+/**
+ * Validate an alphabet string.
+ * Returns null if valid, error message if invalid.
+ */
+export declare function validateAlphabet(alphabet: string): string | null;
+//# sourceMappingURL=alphabets.d.ts.map

package/dist/utils/id/alphabets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alphabets.d.ts","sourceRoot":"","sources":["../../../src/utils/id/alphabets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,eAAO,MAAM,QAAQ,qEAAqE,CAAA;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,YAAY,mEAAmE,CAAA;AAE5F;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,yCAAyC,CAAA;AAExE;;;;GAIG;AACH,eAAO,MAAM,SAAS,qBAAqB,CAAA;AAE3C;;GAEG;AACH,eAAO,MAAM,SAAS,qBAAqB,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,MAAM,+DAA+D,CAAA;AAElF;;;;GAIG;AACH,eAAO,MAAM,OAAO,eAAe,CAAA;AAEnC,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAA;AAEV,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,SAAS,CAAA;AAEjD;;GAEG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,CAKvE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAsBhE"}

package/dist/utils/id/alphabets.js

@@ -0,0 +1,90 @@
+/**
+ * ID Alphabets
+ *
+ * Pre-defined character sets for ID generation.
+ * Each alphabet offers different trade-offs between
+ * density (characters per bit) and usability.
+ */
+/**
+ * URL-safe alphabet (64 chars).
+ * Entropy: 6 bits per character
+ * 21 chars = 126 bits of entropy
+ */
+export const URL_SAFE = 'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict';
+/**
+ * URL-safe alphabet without special chars (62 chars).
+ * Alphanumeric only: a-z, A-Z, 0-9
+ * Entropy: ~5.95 bits per character
+ * 22 chars = ~131 bits of entropy
+ */
+export const ALPHANUMERIC = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
+/**
+ * Lowercase alphanumeric (36 chars).
+ * Entropy: ~5.17 bits per character
+ * 25 chars = ~129 bits of entropy
+ */
+export const ALPHANUMERIC_LOWER = '0123456789abcdefghijklmnopqrstuvwxyz';
+/**
+ * Hexadecimal lowercase (16 chars).
+ * Entropy: 4 bits per character
+ * 32 chars = 128 bits of entropy
+ */
+export const HEX_LOWER = '0123456789abcdef';
+/**
+ * Hexadecimal uppercase (16 chars).
+ */
+export const HEX_UPPER = '0123456789ABCDEF';
+/**
+ * Base58 Bitcoin alphabet (58 chars).
+ * Excludes 0, O, I, l to avoid confusion.
+ * Entropy: ~5.86 bits per character
+ */
+export const BASE58 = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+/**
+ * Numeric only (10 chars).
+ * Entropy: ~3.32 bits per character
+ * 39 chars = ~129 bits of entropy
+ */
+export const NUMERIC = '0123456789';
+export const alphabets = {
+    URL_SAFE,
+    ALPHANUMERIC,
+    ALPHANUMERIC_LOWER,
+    HEX_LOWER,
+    HEX_UPPER,
+    BASE58,
+    NUMERIC,
+};
+/**
+ * Get alphabet by name or return custom alphabet string.
+ */
+export function getAlphabet(nameOrCustom) {
+    if (nameOrCustom in alphabets) {
+        return alphabets[nameOrCustom];
+    }
+    return nameOrCustom;
+}
+/**
+ * Validate an alphabet string.
+ * Returns null if valid, error message if invalid.
+ */
+export function validateAlphabet(alphabet) {
+    if (!alphabet || alphabet.length === 0) {
+        return 'Alphabet cannot be empty';
+    }
+    if (alphabet.length === 1) {
+        return 'Alphabet must have at least 2 characters';
+    }
+    if (alphabet.length > 65536) {
+        return 'Alphabet cannot exceed 65536 characters';
+    }
+    const seen = new Set();
+    for (const char of alphabet) {
+        if (seen.has(char)) {
+            return `Duplicate character in alphabet: "${char}"`;
+        }
+        seen.add(char);
+    }
+    return null;
+}
+//# sourceMappingURL=alphabets.js.map

package/dist/utils/id/alphabets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alphabets.js","sourceRoot":"","sources":["../../../src/utils/id/alphabets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,kEAAkE,CAAA;AAE1F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,gEAAgE,CAAA;AAE5F;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,sCAAsC,CAAA;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,kBAAkB,CAAA;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,kBAAkB,CAAA;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,4DAA4D,CAAA;AAElF;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,YAAY,CAAA;AAEnC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ;IACR,YAAY;IACZ,kBAAkB;IAClB,SAAS;IACT,SAAS;IACT,MAAM;IACN,OAAO;CACC,CAAA;AAIV;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,YAAmC;IAC7D,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,YAA4B,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,0BAA0B,CAAA;IACnC,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,0CAA0C,CAAA;IACnD,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QAC5B,OAAO,yCAAyC,CAAA;IAClD,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,qCAAqC,IAAI,GAAG,CAAA;QACrD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/utils/id/entropy.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Entropy Pool and Random Generation
+ *
+ * Provides cryptographically secure random generation with:
+ * - Pre-allocated entropy pool for performance
+ * - Rejection sampling for zero modulo bias
+ * - Efficient batch generation
+ */
+/**
+ * Initialize or resize the entropy pool.
+ * Uses a pre-allocated buffer to reduce GC pressure and improve performance.
+ */
+export declare function initPool(size?: number): void;
+/**
+ * Get cryptographically secure random bytes from the pool.
+ * Automatically refills the pool when exhausted.
+ */
+export declare function getRandomBytes(count: number): Uint8Array;
+/**
+ * Fill a pre-allocated buffer with random bytes.
+ * More efficient than getRandomBytes when you already have a buffer.
+ */
+export declare function fillRandomBytes(buffer: Uint8Array): Uint8Array;
+/**
+ * Generate multiple unbiased random indices efficiently.
+ * Pre-calculates rejection threshold and batches random byte generation.
+ *
+ * Uses rejection sampling to eliminate modulo bias for non-power-of-2
+ * alphabet sizes.
+ */
+export declare function randomIndicesUnbiased(alphabetSize: number, count: number): Uint16Array;
+/**
+ * Generate a string from an alphabet using unbiased random selection.
+ * This is the core function for generating IDs.
+ */
+export declare function randomString(alphabet: string, length: number): string;
+/**
+ * Calculate the entropy bits for a given alphabet size and ID length.
+ */
+export declare function calculateEntropyBits(alphabetSize: number, length: number): number;
+/**
+ * Reset the entropy pool (useful for testing).
+ */
+export declare function resetPool(): void;
+//# sourceMappingURL=entropy.d.ts.map

package/dist/utils/id/entropy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entropy.d.ts","sourceRoot":"","sources":["../../../src/utils/id/entropy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,GAAE,MAA0B,GAAG,IAAI,CAK/D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAmBxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAsB9D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CA6DtF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAUrE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAGhC"}