@procedures/client 0.48.0 → 0.48.1

package/dist/events/live-state.js

@@ -0,0 +1,501 @@
+/**
+ * The live state of a topic (documentation/LIVE-STATE-2026-11.md).
+ *
+ * Some state changes many times a second, and each reader needs only its latest value: who is here,
+ * and where a cursor is. This state keeps the latest value of each key of a topic in memory. It
+ * makes no store write and no numbered change.
+ *
+ * - A set keeps the value and publishes it to the subscribers of the topic, through the bus. The
+ *   first change on an idle topic goes at once and opens a window. One event at the end of the
+ *   window carries each key that changed in it, and that event opens the next window.
+ * - A snapshot gives the live values, so a new reader sees them at once.
+ * - A key ends after a stated time with no set, when the connection of its owner closes, and at a
+ *   leave call. Each end publishes a `gone` item.
+ *
+ * The state fills from the bus too. A bus that hosts share thus shares the state. A snapshot holds
+ * only what this host saw.
+ */
+import * as z from "zod";
+import { createProcedure } from "../procedures/define.js";
+import { InvocationError } from "../procedures/invoke.js";
+import { decodeSegment, encodeSegment } from "../procedures/segments.js";
+import { ms, toMs } from "../duration.js";
+import { realClock } from "../clock.js";
+/** The path of the procedure that sets a key of a live topic. */
+export const LIVE_SET_PATH = ["live", "set"];
+/** The path of the procedure that gives the live values of a topic. */
+export const LIVE_SNAPSHOT_PATH = ["live", "snapshot"];
+/** The path of the procedure that ends a key of a live topic. */
+export const LIVE_LEAVE_PATH = ["live", "leave"];
+/** The longest key of a live topic, in characters. */
+export const MAX_LIVE_KEY_LENGTH = 256;
+/** The default limit of the keys of one live topic. */
+export const DEFAULT_LIVE_KEYS = 1024;
+/** The default limit of the bytes of one value, as JSON. */
+export const DEFAULT_LIVE_VALUE_BYTES = 16384;
+/** The default limit of the topics of one live state. */
+export const DEFAULT_LIVE_TOPICS = 4096;
+/** The prefix of each live topic. */
+const PREFIX = "live.";
+/** The default window that joins the sets of a topic, in milliseconds. */
+const DEFAULT_WINDOW_MS = 120;
+/**
+ * This function gives a live topic: `live.<name>`, or `live.<name>.<partition>`. The name encodes
+ * `%` and `.`, so the first dot after the name ends the name, as in a topic of a collection.
+ *
+ * @example
+ * ```typescript
+ * liveTopic("presence"); // "live.presence"
+ * liveTopic("presence", "acme/board:b1"); // "live.presence.acme/board:b1"
+ * ```
+ */
+export function liveTopic(name, partition) {
+    const topic = `${PREFIX}${encodeSegment(name)}`;
+    return partition === undefined ? topic : `${topic}.${partition}`;
+}
+/**
+ * This function gives the name and the partition of a live topic, or undefined for another topic.
+ * Only the canonical form counts: `liveTopic()` gives the same topic back.
+ */
+export function liveTopicTarget(topic) {
+    if (!topic.startsWith(PREFIX))
+        return undefined;
+    const rest = topic.slice(PREFIX.length);
+    const dot = rest.indexOf(".");
+    const name = decodeSegment(dot === -1 ? rest : rest.slice(0, dot));
+    if (name.length === 0)
+        return undefined;
+    if (dot === -1)
+        return liveTopic(name) === topic ? { name } : undefined;
+    const partition = rest.slice(dot + 1);
+    if (partition.length === 0)
+        return undefined;
+    return liveTopic(name, partition) === topic ? { name, partition } : undefined;
+}
+/** True for a value of the form of a live event. */
+function isLiveEvent(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const event = value;
+    return typeof event.origin === "string" && Array.isArray(event.set) && Array.isArray(event.gone);
+}
+/** This function gives a refusal of a set. */
+function refused(message, reason, path = LIVE_SET_PATH) {
+    return new InvocationError("FORBIDDEN", message, [...path], reason);
+}
+/** This function gives a new id for a live state. */
+function newOrigin() {
+    const random = globalThis.crypto?.randomUUID;
+    return random ? random.call(globalThis.crypto) : `live-${Date.now()}-${Math.random()}`;
+}
+const entrySchema = z.object({
+    key: z.string(),
+    value: z.unknown(),
+    by: z.string().optional(),
+    at: z.number(),
+});
+/**
+ * The live values of the topics of one publisher. A host gets one with the option `live` of
+ * `EventPublisher`, and the server registers its `procedures`.
+ */
+export class LiveState {
+    /** The procedures `live.set`, `live.snapshot` and `live.leave`. The expose rule of the host applies to them. */
+    procedures;
+    bus;
+    clock;
+    admit;
+    admitSet;
+    admitLeave;
+    partition;
+    expiresMs;
+    windowOf;
+    maxKeys;
+    maxValueBytes;
+    maxTopics;
+    origin = newOrigin();
+    topics = new Map();
+    /** Each key in the order of its last set. All keys have the same time, so this is the order of the deadlines. */
+    deadlines = new Set();
+    owned = new Map();
+    timer;
+    closed = false;
+    constructor(options, host) {
+        if (typeof options.admitSet !== "function")
+            throw new TypeError("LiveState needs the option admitSet");
+        this.bus = host.bus;
+        this.clock = options.clock ?? host.clock ?? realClock;
+        this.admit = host.admit;
+        this.admitSet = options.admitSet;
+        this.admitLeave = options.admitLeave;
+        this.partition = options.partition;
+        this.expiresMs = toMs(options.expiresAfter, "expiresAfter");
+        if (this.expiresMs <= 0)
+            throw new RangeError("expiresAfter must be more than 0");
+        const window = options.window ?? ms(DEFAULT_WINDOW_MS);
+        this.windowOf = typeof window === "function" ? window : () => window;
+        this.maxKeys = options.maxKeysPerTopic ?? DEFAULT_LIVE_KEYS;
+        this.maxValueBytes = options.maxValueBytes ?? DEFAULT_LIVE_VALUE_BYTES;
+        this.maxTopics = options.maxTopics ?? DEFAULT_LIVE_TOPICS;
+        this.procedures = [this.setProcedure(host.topicSchema), this.snapshotProcedure(host.topicSchema), this.leaveProcedure(host.topicSchema)];
+    }
+    /** The number of live keys of this state. */
+    get size() {
+        return this.deadlines.size;
+    }
+    /**
+     * The topic of the bus for a live topic of a call, or undefined for another topic. The publisher
+     * calls it for each subscription and each re-check, so a change of the partition ends a
+     * subscription.
+     */
+    async route(topic, ctx) {
+        const target = liveTopicTarget(topic);
+        if (!target)
+            return undefined;
+        if (!this.partition) {
+            if (target.partition !== undefined)
+                throw refused(`The live topic "${topic}" has no partitions`, "partition-not-allowed");
+            return topic;
+        }
+        const partition = await this.partition(ctx, target.partition);
+        if (partition === null)
+            throw refused(`The call cannot use the partition of the live topic "${topic}"`, "partition-not-allowed");
+        return liveTopic(target.name, partition);
+    }
+    /**
+     * This method keeps the latest value of a key and publishes it. This is the direct form for the
+     * host: it runs no check of a right, and `topic` is a topic of the bus.
+     *
+     * @returns The time of the set on the clock
+     * @throws `InvocationError` with the code `FORBIDDEN` at a limit, and the existing values stay
+     */
+    set(topic, key, value, options = {}) {
+        if (this.closed)
+            throw refused("The live state is closed", "write-not-allowed");
+        this.checkValue(value);
+        const state = this.stateOf(topic);
+        if (!state)
+            throw refused(`The live state has its limit of ${this.maxTopics} topics`, "write-not-allowed");
+        const at = this.clock.now();
+        const entry = options.by === undefined ? { key, value, at } : { key, value, by: options.by, at };
+        let slot = state.keys.get(key);
+        if (slot) {
+            slot.entry = entry;
+        }
+        else {
+            if (state.keys.size >= this.maxKeys)
+                throw refused(`The live topic "${topic}" has its limit of ${this.maxKeys} keys`, "write-not-allowed");
+            slot = { state, key, entry, deadline: 0, owner: undefined };
+            state.keys.set(key, slot);
+        }
+        this.renew(slot, at);
+        this.own(slot, options.owner);
+        this.queue(state, (waiting) => {
+            waiting.gone.delete(key);
+            waiting.set.set(key, entry);
+        });
+        return at;
+    }
+    /** This method gives the live values of a topic of the bus. */
+    snapshot(topic) {
+        if (this.closed)
+            return [];
+        const state = this.stateOf(topic);
+        return state ? Array.from(state.keys.values(), (slot) => slot.entry) : [];
+    }
+    /**
+     * This method ends a key and publishes the end with the reason `left`. This is the direct form for
+     * the host: it runs no check of a right, and `topic` is a topic of the bus.
+     *
+     * @returns True when the key was live
+     */
+    leave(topic, key) {
+        const slot = this.topics.get(topic)?.keys.get(key);
+        if (this.closed || !slot)
+            return false;
+        this.end(slot, "left", true);
+        return true;
+    }
+    /** This method ends each key that the connection owns. The transport of the host calls it at a close. */
+    connectionClosed(connection) {
+        const slots = this.owned.get(connection);
+        if (!slots)
+            return;
+        this.owned.delete(connection);
+        for (const slot of slots) {
+            slot.owner = undefined;
+            this.end(slot, "closed", true);
+        }
+    }
+    /** This method stops the timers and the listeners. The state then holds nothing. */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.timer?.();
+        this.timer = undefined;
+        for (const state of this.topics.values()) {
+            state.window?.();
+            state.stop();
+        }
+        this.topics.clear();
+        this.deadlines.clear();
+        this.owned.clear();
+    }
+    /** This method refuses a value above the limit. A text has at most 3 bytes for each UTF-16 unit. */
+    checkValue(value) {
+        const text = JSON.stringify(value);
+        if (text === undefined)
+            throw refused("A live value must have a JSON form", "write-not-allowed");
+        const fits = text.length * 3 <= this.maxValueBytes
+            || (text.length <= this.maxValueBytes && new TextEncoder().encode(text).length <= this.maxValueBytes);
+        if (!fits)
+            throw refused(`A live value has more than ${this.maxValueBytes} bytes`, "write-not-allowed");
+    }
+    /**
+     * The state of a topic. The first use starts the listener of the bus. A topic stays after its
+     * last key, and goes when a new topic needs its place. Undefined means that no place is free.
+     */
+    stateOf(topic) {
+        const known = this.topics.get(topic);
+        if (known)
+            return known;
+        if (this.topics.size >= this.maxTopics) {
+            for (const state of this.topics.values()) {
+                if (state.keys.size === 0 && !state.window) {
+                    state.stop();
+                    this.topics.delete(state.topic);
+                }
+            }
+            if (this.topics.size >= this.maxTopics)
+                return undefined;
+        }
+        const stop = this.bus.on(topic, (event) => this.heard(topic, event));
+        const state = { topic, keys: new Map(), stop, windowMs: toMs(this.windowOf(topic), "window"), waiting: undefined, window: undefined };
+        this.topics.set(topic, state);
+        return state;
+    }
+    /** This method applies an event of another host. Its subscribers on this host got it from the bus. */
+    heard(topic, event) {
+        if (this.closed || !isLiveEvent(event) || event.origin === this.origin)
+            return;
+        const state = this.topics.get(topic);
+        if (!state)
+            return;
+        const now = this.clock.now();
+        for (const entry of event.set) {
+            let slot = state.keys.get(entry.key);
+            if (slot) {
+                slot.entry = entry;
+            }
+            else {
+                if (state.keys.size >= this.maxKeys)
+                    continue;
+                slot = { state, key: entry.key, entry, deadline: 0, owner: undefined };
+                state.keys.set(entry.key, slot);
+            }
+            // The connection of this key is on the other host: its deadline ends the key if that host dies
+            this.own(slot, undefined);
+            this.renew(slot, now);
+        }
+        for (const { key, reason } of event.gone) {
+            const slot = state.keys.get(key);
+            if (slot)
+                this.end(slot, reason, false);
+        }
+    }
+    /** This method moves a key to the end of the deadlines. */
+    renew(slot, now) {
+        slot.deadline = now + this.expiresMs;
+        this.deadlines.delete(slot);
+        this.deadlines.add(slot);
+        this.armDeadline();
+    }
+    /** This method sets the owner of a key. The owner is the connection of the last set. */
+    own(slot, owner) {
+        if (slot.owner === owner)
+            return;
+        if (slot.owner !== undefined) {
+            const slots = this.owned.get(slot.owner);
+            slots?.delete(slot);
+            if (slots?.size === 0)
+                this.owned.delete(slot.owner);
+        }
+        slot.owner = owner;
+        if (owner === undefined)
+            return;
+        const slots = this.owned.get(owner);
+        if (slots)
+            slots.add(slot);
+        else
+            this.owned.set(owner, new Set([slot]));
+    }
+    /** This method removes a key, and publishes its end when this host decided it. */
+    end(slot, reason, publish) {
+        this.own(slot, undefined);
+        this.deadlines.delete(slot);
+        slot.state.keys.delete(slot.key);
+        if (!publish)
+            return;
+        this.queue(slot.state, (waiting) => {
+            waiting.set.delete(slot.key);
+            waiting.gone.set(slot.key, { key: slot.key, reason });
+        });
+    }
+    /** This method starts the one timer of the deadlines, at the first deadline. */
+    armDeadline() {
+        if (this.timer || this.closed)
+            return;
+        const first = this.deadlines.values().next();
+        if (first.done)
+            return;
+        const timer = this.clock.after(Math.max(0, first.value.deadline - this.clock.now()), () => {
+            this.timer = undefined;
+            this.expire();
+        });
+        // A deadline does not keep a Node process alive
+        timer.unref?.();
+        this.timer = timer;
+    }
+    /** This method ends each key at its deadline. */
+    expire() {
+        const now = this.clock.now();
+        for (const slot of this.deadlines) {
+            if (slot.deadline > now)
+                break;
+            this.end(slot, "expired", true);
+        }
+        this.armDeadline();
+    }
+    /**
+     * This method adds a change to a topic. On an idle topic the change goes at once, so one writer
+     * has no added delay, and the window opens. In an open window the change waits, and the latest
+     * change of a key wins.
+     */
+    queue(state, change) {
+        let waiting = state.waiting;
+        if (!waiting) {
+            waiting = { set: new Map(), gone: new Map() };
+            state.waiting = waiting;
+        }
+        change(waiting);
+        if (!state.window)
+            this.publishWaiting(state);
+    }
+    /** This method publishes the changes that wait as one event, and opens the next window. */
+    publishWaiting(state) {
+        const waiting = state.waiting;
+        if (!waiting || this.closed)
+            return;
+        state.waiting = undefined;
+        if (state.windowMs > 0) {
+            const timer = this.clock.after(state.windowMs, () => {
+                state.window = undefined;
+                this.publishWaiting(state);
+            });
+            timer.unref?.();
+            state.window = timer;
+        }
+        const event = { origin: this.origin, set: [...waiting.set.values()], gone: [...waiting.gone.values()] };
+        this.bus.emit(state.topic, event);
+    }
+    /** The procedure `live.set`: the checks of a subscription, then `admitSet`, then the set. */
+    setProcedure(topicSchema) {
+        return createProcedure()
+            .path([...LIVE_SET_PATH])
+            .input(z.object({
+            topic: topicSchema,
+            key: z.string().min(1).max(MAX_LIVE_KEY_LENGTH).describe("The key of the value"),
+            value: z.unknown().refine((value) => value !== undefined, "A live set needs a value").describe("The latest value of the key"),
+        }))
+            .output(z.object({ at: z.number().describe("The time of the set on the clock of the host") }))
+            .meta({
+            description: "This procedure keeps the latest value of a key of a live topic and publishes it. It makes no store write.",
+            effects: { reads: ["events"], writes: ["live"] },
+        })
+            .handler(async (input, ctx) => {
+            const topic = await this.admit(input.topic, ctx);
+            if (!liveTopicTarget(topic))
+                throw refused(`The topic "${input.topic}" is not a live topic`, "write-not-allowed");
+            const admission = await this.admitSet({
+                topic,
+                key: input.key,
+                value: input.value,
+                capability: ctx.capability,
+                metadata: ctx.metadata,
+                ...(ctx.principal ? { principal: ctx.principal } : {}),
+            });
+            if (admission === null)
+                throw refused(`The call cannot set a key of the live topic "${input.topic}"`, "write-not-allowed");
+            const connection = ctx.metadata["connectionId"];
+            const owner = typeof connection === "string" ? connection : undefined;
+            // A connection that closed during the checks owns no new key
+            if (ctx.signal?.aborted)
+                throw refused("The call ended before the set", "write-not-allowed");
+            const value = admission.value !== undefined ? admission.value : input.value;
+            return { at: this.set(topic, input.key, value, { by: admission.by, owner }) };
+        })
+            .build();
+    }
+    /**
+     * The procedure `live.leave`: the checks of a subscription, then the right to end the key. A set
+     * that comes during the check of the right keeps the key, because the check read the older set.
+     */
+    leaveProcedure(topicSchema) {
+        return createProcedure()
+            .path([...LIVE_LEAVE_PATH])
+            .input(z.object({
+            topic: topicSchema,
+            key: z.string().min(1).max(MAX_LIVE_KEY_LENGTH).describe("The key to end"),
+        }))
+            .output(z.object({ ended: z.boolean().describe("True when the call ended a live key") }))
+            .meta({
+            description: "This procedure ends a key of a live topic. Each reader gets the end at once, or at the end of an open window.",
+            effects: { reads: ["events"], writes: ["live"] },
+        })
+            .handler(async (input, ctx) => {
+            const topic = await this.admit(input.topic, ctx);
+            if (!liveTopicTarget(topic))
+                throw refused(`The topic "${input.topic}" is not a live topic`, "write-not-allowed", LIVE_LEAVE_PATH);
+            const slot = this.topics.get(topic)?.keys.get(input.key);
+            if (!slot)
+                return { ended: false };
+            const { entry, owner } = slot;
+            const allowed = this.admitLeave
+                ? await this.admitLeave({
+                    topic,
+                    key: input.key,
+                    by: entry.by,
+                    owner,
+                    capability: ctx.capability,
+                    metadata: ctx.metadata,
+                    ...(ctx.principal ? { principal: ctx.principal } : {}),
+                })
+                : owner !== undefined && owner === ctx.metadata["connectionId"];
+            if (!allowed)
+                throw refused(`The call cannot end a key of the live topic "${input.topic}"`, "write-not-allowed", LIVE_LEAVE_PATH);
+            if (slot.entry !== entry || this.topics.get(topic)?.keys.get(input.key) !== slot)
+                return { ended: false };
+            return { ended: this.leave(topic, input.key) };
+        })
+            .build();
+    }
+    /** The procedure `live.snapshot`: the checks of a subscription, then the live values. */
+    snapshotProcedure(topicSchema) {
+        return createProcedure()
+            .path([...LIVE_SNAPSHOT_PATH])
+            .input(z.object({ topic: topicSchema }))
+            .output(z.object({ entries: z.array(entrySchema).describe("The live values of the topic") }))
+            .meta({
+            description: "This procedure gives the live values of a topic. A new subscriber reads it after its subscription starts.",
+            effects: { reads: ["events"], writes: [] },
+        })
+            .handler(async (input, ctx) => {
+            const topic = await this.admit(input.topic, ctx);
+            if (!liveTopicTarget(topic))
+                throw refused(`The topic "${input.topic}" is not a live topic`, "write-not-allowed");
+            return { entries: this.snapshot(topic) };
+        })
+            .build();
+    }
+}
+//# sourceMappingURL=live-state.js.map

package/dist/events/live-state.js.map

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

package/dist/events/live-view.d.ts

@@ -0,0 +1,38 @@
+import type { Method } from "../client/types.js";
+import { type LiveEntry } from "./live-state.js";
+import type { RemoteEventHandler, SubscribeOptions, Subscription } from "./remote.js";
+/** The parts of a client that a view uses. A `Client` has them. */
+export interface LiveClient {
+    /** This method starts a subscription. */
+    subscribe<T = unknown>(topics: string | readonly string[], handler: RemoteEventHandler<T>, options?: SubscribeOptions): Subscription;
+    /** This method calls a procedure. */
+    call<TReq, TRes>(method: Method, payload: TReq): Promise<TRes>;
+}
+/** The options of a view. */
+export interface LiveViewOptions<T = unknown> extends SubscribeOptions {
+    /** This function gets the values after each change. */
+    onChange?: ((values: ReadonlyMap<string, LiveEntry<T>>) => void) | undefined;
+    /** This function gets the error of a read of the snapshot. The view keeps its values and its subscription. */
+    onReadError?: ((error: unknown) => void) | undefined;
+}
+/** The live values of a topic for one reader. */
+export interface LiveView<T = unknown> {
+    /** The live values by key. */
+    readonly values: ReadonlyMap<string, LiveEntry<T>>;
+    /** This promise resolves after the first snapshot. It rejects when the first subscription or read fails. */
+    readonly ready: Promise<void>;
+    /** This method ends the subscription. A second call does nothing. */
+    close(): void;
+}
+/**
+ * This function gives a view of a live topic.
+ *
+ * @example
+ * ```typescript
+ * const view = liveView(client, liveTopic("presence", "board-1"), { onChange: render });
+ * await view.ready;
+ * view.close();
+ * ```
+ */
+export declare function liveView<T = unknown>(client: LiveClient, topic: string, options?: LiveViewOptions<T>): LiveView<T>;
+//# sourceMappingURL=live-view.d.ts.map

package/dist/events/live-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-view.d.ts","sourceRoot":"","sources":["../../src/events/live-view.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAsB,KAAK,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtF,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,YAAY,CAAC;IACrI,qCAAqC;IACrC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED,6BAA6B;AAC7B,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,gBAAgB;IACpE,uDAAuD;IACvD,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC7E,8GAA8G;IAC9G,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACtD;AAED,iDAAiD;AACjD,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACnC,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,qEAAqE;IACrE,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAoFtH"}