miakapi 3.0.31 → 4.0.0-alpha.1

package/dist/internal/control-plane-response.js

@@ -0,0 +1,283 @@
+const MAXIMUM_RESPONSE_BYTES = 65_536;
+const MAXIMUM_JSON_DEPTH = 8;
+const MAXIMUM_JSON_VALUES = 128;
+const MAXIMUM_JSON_STRING_BYTES = 16_384;
+const MAXIMUM_JSON_OBJECT_ENTRIES = 32;
+const MAXIMUM_JSON_ARRAY_ITEMS = 32;
+const CONTROL_CHARACTER = /\p{Cc}/u;
+const UTF8 = new TextEncoder();
+function invalidResponse() {
+    throw new TypeError('Invalid control-plane response');
+}
+export function cancelResponseBody(response) {
+    try {
+        const cancellation = response?.body?.cancel();
+        void cancellation?.catch(() => undefined);
+    }
+    catch {
+        // Rejection still wins even if a custom Fetch implementation exposes a hostile body.
+    }
+}
+function hasUnpairedSurrogate(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const unit = value.charCodeAt(index);
+        if (unit >= 0xd800 && unit <= 0xdbff) {
+            const following = value.charCodeAt(index + 1);
+            if (index + 1 >= value.length || following < 0xdc00 || following > 0xdfff)
+                return true;
+            index += 1;
+        }
+        else if (unit >= 0xdc00 && unit <= 0xdfff) {
+            return true;
+        }
+    }
+    return false;
+}
+export function exactResponseRecord(value, required, optional) {
+    if (value === null || Array.isArray(value) || typeof value !== 'object')
+        return invalidResponse();
+    const keys = Object.keys(value);
+    const allowed = new Set([...required, ...optional]);
+    if (Reflect.ownKeys(value).length !== keys.length
+        || required.some((key) => !Object.hasOwn(value, key))
+        || keys.some((key) => !allowed.has(key)))
+        return invalidResponse();
+    return value;
+}
+export function boundedResponseString(value, minimum, maximum) {
+    if (typeof value !== 'string'
+        || hasUnpairedSurrogate(value)
+        || CONTROL_CHARACTER.test(value))
+        return invalidResponse();
+    const bytes = UTF8.encode(value).byteLength;
+    if (bytes < minimum || bytes > maximum)
+        return invalidResponse();
+    return value;
+}
+export function canonicalRelayUrl(value) {
+    const relayUrl = boundedResponseString(value, 1, 2_048);
+    let parsed;
+    try {
+        parsed = new URL(relayUrl);
+    }
+    catch {
+        return invalidResponse();
+    }
+    if (parsed.protocol !== 'wss:'
+        || parsed.hostname === ''
+        || parsed.username !== ''
+        || parsed.password !== ''
+        || parsed.search !== ''
+        || parsed.hash !== ''
+        || !parsed.pathname.endsWith('/ws')
+        || parsed.href !== relayUrl)
+        return invalidResponse();
+    return relayUrl;
+}
+export function parseResponseJson(input) {
+    let text;
+    try {
+        text = new TextDecoder('utf-8', { fatal: true }).decode(input);
+    }
+    catch {
+        return invalidResponse();
+    }
+    let index = 0;
+    let values = 0;
+    const skipWhitespace = () => {
+        while (index < text.length) {
+            const code = text.charCodeAt(index);
+            if (code !== 0x20 && code !== 0x09 && code !== 0x0a && code !== 0x0d)
+                break;
+            index += 1;
+        }
+    };
+    const parseString = () => {
+        if (text[index] !== '"')
+            return invalidResponse();
+        const start = index;
+        index += 1;
+        let escaped = false;
+        while (index < text.length) {
+            const character = text[index];
+            if (!escaped && character === '"') {
+                index += 1;
+                let decoded;
+                try {
+                    decoded = JSON.parse(text.slice(start, index));
+                }
+                catch {
+                    return invalidResponse();
+                }
+                if (typeof decoded !== 'string'
+                    || hasUnpairedSurrogate(decoded)
+                    || UTF8.encode(decoded).byteLength > MAXIMUM_JSON_STRING_BYTES) {
+                    return invalidResponse();
+                }
+                return decoded;
+            }
+            if (!escaped && character === '\\')
+                escaped = true;
+            else
+                escaped = false;
+            index += 1;
+        }
+        return invalidResponse();
+    };
+    const parseNumber = () => {
+        const match = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?/.exec(text.slice(index));
+        if (match === null)
+            return invalidResponse();
+        index += match[0].length;
+        const number = Number(match[0]);
+        if (!Number.isFinite(number))
+            return invalidResponse();
+        return number;
+    };
+    const parseValue = (depth) => {
+        if (depth > MAXIMUM_JSON_DEPTH)
+            return invalidResponse();
+        values += 1;
+        if (values > MAXIMUM_JSON_VALUES)
+            return invalidResponse();
+        skipWhitespace();
+        const character = text[index];
+        if (character === '"')
+            return parseString();
+        if (character === '-' || (character !== undefined && character >= '0' && character <= '9')) {
+            return parseNumber();
+        }
+        if (text.startsWith('true', index)) {
+            index += 4;
+            return true;
+        }
+        if (text.startsWith('false', index)) {
+            index += 5;
+            return false;
+        }
+        if (text.startsWith('null', index)) {
+            index += 4;
+            return null;
+        }
+        if (character === '[') {
+            index += 1;
+            const result = [];
+            skipWhitespace();
+            if (text[index] === ']') {
+                index += 1;
+                return result;
+            }
+            while (true) {
+                if (result.length >= MAXIMUM_JSON_ARRAY_ITEMS)
+                    return invalidResponse();
+                result.push(parseValue(depth + 1));
+                skipWhitespace();
+                if (text[index] === ']') {
+                    index += 1;
+                    return result;
+                }
+                if (text[index] !== ',')
+                    return invalidResponse();
+                index += 1;
+                skipWhitespace();
+            }
+        }
+        if (character === '{') {
+            index += 1;
+            const result = Object.create(null);
+            const keys = new Set();
+            skipWhitespace();
+            if (text[index] === '}') {
+                index += 1;
+                return result;
+            }
+            while (true) {
+                if (keys.size >= MAXIMUM_JSON_OBJECT_ENTRIES)
+                    return invalidResponse();
+                const key = parseString();
+                if (keys.has(key) || key === '__proto__' || key === 'prototype' || key === 'constructor') {
+                    return invalidResponse();
+                }
+                keys.add(key);
+                skipWhitespace();
+                if (text[index] !== ':')
+                    return invalidResponse();
+                index += 1;
+                result[key] = parseValue(depth + 1);
+                skipWhitespace();
+                if (text[index] === '}') {
+                    index += 1;
+                    return result;
+                }
+                if (text[index] !== ',')
+                    return invalidResponse();
+                index += 1;
+                skipWhitespace();
+            }
+        }
+        return invalidResponse();
+    };
+    skipWhitespace();
+    const parsed = parseValue(1);
+    skipWhitespace();
+    if (index !== text.length)
+        return invalidResponse();
+    return parsed;
+}
+export async function boundedResponseBody(response, signal) {
+    const contentLength = response.headers.get('content-length');
+    if (contentLength !== null
+        && (!/^(?:0|[1-9][0-9]*)$/.test(contentLength)
+            || Number(contentLength) > MAXIMUM_RESPONSE_BYTES)) {
+        cancelResponseBody(response);
+        return invalidResponse();
+    }
+    if (response.body === null)
+        return invalidResponse();
+    const reader = response.body.getReader();
+    const chunks = [];
+    let size = 0;
+    const cancelReader = () => {
+        try {
+            void reader.cancel().catch(() => undefined);
+        }
+        catch {
+            // The caller's validation or cancellation result remains authoritative.
+        }
+    };
+    if (signal !== undefined) {
+        signal.addEventListener('abort', cancelReader, { once: true });
+        if (signal.aborted)
+            cancelReader();
+    }
+    try {
+        while (true) {
+            const item = await reader.read();
+            if (item.done)
+                break;
+            size += item.value.byteLength;
+            if (size > MAXIMUM_RESPONSE_BYTES) {
+                cancelReader();
+                return invalidResponse();
+            }
+            chunks.push(item.value);
+        }
+    }
+    catch {
+        return invalidResponse();
+    }
+    finally {
+        signal?.removeEventListener('abort', cancelReader);
+        reader.releaseLock();
+    }
+    if (size === 0)
+        return invalidResponse();
+    const body = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        body.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return body;
+}
+//# sourceMappingURL=control-plane-response.js.map

package/dist/internal/control-plane-response.js.map

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

package/dist/internal/declarations.d.ts

@@ -0,0 +1,88 @@
+import type { CoordinatorAccess, CoordinatorConfiguration, DeclarationReceipt, EventDeclaration, FunctionHandler, ProtocolValue, StateMutation, UserEventAccess, UserStateAccess } from '../api.js';
+import { type Frame } from '../protocol/codec.js';
+import { type CoordinatorError } from './errors.js';
+import type { RelaySession } from './session.js';
+export type DeclarationDomain = 'state' | 'state_access' | 'events' | 'event_access' | 'functions';
+export declare const DECLARATION_DOMAINS: readonly DeclarationDomain[];
+interface DeclarationRevisions {
+    state: number;
+    state_access: number;
+    events: number;
+    event_access: number;
+    functions: number;
+}
+export interface DeclarationSnapshot {
+    state: Readonly<Record<string, ProtocolValue>>;
+    stateAccess: readonly UserStateAccess[];
+    events: readonly EventDeclaration[];
+    eventAccess: readonly UserEventAccess[];
+    functions: Readonly<Record<string, FunctionHandler>>;
+    revisions: DeclarationRevisions;
+}
+export interface ActiveDeclarations {
+    readonly snapshot: DeclarationSnapshot;
+    readonly receipt: DeclarationReceipt;
+    readonly stateIds: ReadonlyMap<string, number>;
+    readonly topicIds: ReadonlyMap<string, number>;
+    readonly functionIds: ReadonlyMap<string, number>;
+}
+export interface DeclarationHost {
+    nextRequestId(): number;
+    currentSession(): RelaySession | undefined;
+    synchronizing(): void;
+    activeDeclarationsChanged(active: ActiveDeclarations): void;
+    declarationsReady(receipt: DeclarationReceipt): void;
+    declarationFailure(failure: CoordinatorError, hasActiveConfiguration: boolean, hasQueuedSnapshot: boolean): void;
+    transportFailure(error: unknown): void;
+    /**
+     * Activation staged the declared value for paths whose acknowledged state is
+     * a deletion, which `STATE_SYNC` cannot express; the host reapplies them.
+     */
+    restoreDeletions(session: RelaySession, active: ActiveDeclarations, paths: readonly string[]): void;
+}
+export declare class DeclarationManager {
+    #private;
+    constructor(host: DeclarationHost);
+    get desired(): DeclarationSnapshot;
+    get active(): ActiveDeclarations | undefined;
+    configure(configuration: CoordinatorConfiguration): void;
+    declareState(state: Readonly<Record<string, ProtocolValue>>, signal?: AbortSignal): Promise<DeclarationReceipt>;
+    declareStateAccess(stateAccess: readonly UserStateAccess[], signal?: AbortSignal): Promise<DeclarationReceipt>;
+    declareEvents(events: readonly EventDeclaration[], signal?: AbortSignal): Promise<DeclarationReceipt>;
+    declareEventAccess(eventAccess: readonly UserEventAccess[], signal?: AbortSignal): Promise<DeclarationReceipt>;
+    declareFunctions(functions: Readonly<Record<string, FunctionHandler>>, signal?: AbortSignal): Promise<DeclarationReceipt>;
+    synchronize(session: RelaySession): void;
+    /**
+     * Records a mutation batch the relay acknowledged with `STATE_SET_OK`.
+     *
+     * Every later re-declaration of the same state slice carries these values
+     * instead of the declared ones, because `STATE_SYNC` replaces the relay's
+     * values and an ACL, event or function change — or a reconnect — must not
+     * roll the home back. Only acknowledged batches are recorded: a rejected or
+     * unknown mutation never reaches this method, so it is never replayed.
+     *
+     * `sequence` is the order in which the batches were sent. The relay applies
+     * one connection's frames in order, so the later batch wins a path.
+     */
+    recordConfirmed(mutations: readonly StateMutation[], revision: number, sequence: number): void;
+    /**
+     * The relay refused to reapply an acknowledged deletion, so it holds the
+     * declared value again. That value becomes the acknowledged one, unless a
+     * newer mutation of the path was acknowledged meanwhile.
+     */
+    restorationRefused(paths: ReadonlyMap<string, number>): void;
+    /** The confirmed entry sequence of each path, for a restoration in flight. */
+    confirmedSequences(paths: readonly string[]): Map<string, number>;
+    handleFrame(frame: Frame): boolean;
+    handleError(requestId: number, code: number, retryable: boolean): boolean;
+    disconnected(): void;
+    stop(): void;
+}
+export declare class AccessManager implements CoordinatorAccess {
+    #private;
+    constructor(declarations: DeclarationManager);
+    declareState(entries: readonly UserStateAccess[], options?: import('../api.js').DeclarationOptions): Promise<DeclarationReceipt>;
+    declareEvents(entries: readonly UserEventAccess[], options?: import('../api.js').DeclarationOptions): Promise<DeclarationReceipt>;
+}
+export {};
+//# sourceMappingURL=declarations.d.ts.map

package/dist/internal/declarations.d.ts.map

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