@ibgib/web-gib 0.0.1

package/dist/witness/space/metaspace/metaspace-webspace/metaspace-webspace-helper.mjs

@@ -0,0 +1,267 @@
+import { extractErrorMsg, getTimestamp, getUUID, pretty } from "@ibgib/helper-gib/dist/helpers/utils-helper.mjs";
+import { getGib, isPrimitive } from "@ibgib/ts-gib/dist/V1/transforms/transform-helper.mjs";
+import { GIB } from "@ibgib/ts-gib/dist/V1/constants.mjs";
+import { getIbAndGib } from "@ibgib/ts-gib/dist/helper.mjs";
+import { fnObs } from "@ibgib/core-gib/dist/common/pubsub/observer/observer-helper.mjs";
+import { isSpaceIb, spaceNameIsValid } from "@ibgib/core-gib/dist/witness/space/space-helper.mjs";
+import { IBGIB_BASE_DIR, IBGIB_BASE_SUBPATH, IBGIB_BIN_SUBPATH, IBGIB_DNA_SUBPATH, IBGIB_ENCODING, IBGIB_IBGIBS_SUBPATH, IBGIB_META_SUBPATH } from "@ibgib/core-gib/dist/witness/space/filesystem-space/filesystem-constants.mjs";
+import { DEFAULT_LOCAL_SPACE_DESCRIPTION, DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS, PERSIST_OPTS_AND_RESULTS_IBGIBS_DEFAULT } from "@ibgib/core-gib/dist/witness/space/space-constants.mjs";
+import { toDto } from "@ibgib/core-gib/dist/common/other/ibgib-helper.mjs";
+import { GLOBAL_LOG_A_LOT } from "../../../../constants.mjs";
+import { getFnPrompt } from "../../../../common/prompt-functions.web.mjs";
+import { WebFilesystemSpace_V1 } from "../../web-filesystem-space/web-filesystem-space-v1.mjs";
+/**
+ * used in verbose logging (across all ibgib libs atow)
+ */
+const logalot = GLOBAL_LOG_A_LOT;
+export const fnCreateNewLocalSpace = async ({ allowCancel, spaceName, logalot, }) => {
+    const lc = `[fnCreateNewLocalSpace]`;
+    try {
+        if (logalot) {
+            console.log(`${lc} starting... (I: b05e12810c1d32269b0fa7e965ccfd24)`);
+        }
+        if (spaceName && !spaceNameIsValid(spaceName)) {
+            throw new Error(`spaceName (${spaceName}) is invalid.  (E: c54aa952ee34102befe5f47681cdf624)`);
+            // throw because this is used in RCLI and automated testing...
+        }
+        if (!spaceName) {
+            const promptName = async () => {
+                const fnPrompt = getFnPrompt();
+                const resName = await fnPrompt({
+                    title: 'greetings program', msg: `this website does not use cookies. it's driven by ibgib's innovative protocol, and all of YOUR data is stored in a "local space" on YOUR device. in browsers, this means in IndexedDB.
+
+so give your local space a name like 'phone_alice' or 'web_bob_foo', or leave blank to get a random name. then click ok.
+`
+                });
+                if (resName === '' && !allowCancel) {
+                    spaceName = 'space_' + (await getUUID()).slice(0, 10);
+                }
+                else {
+                    if (resName && spaceNameIsValid(resName)) {
+                        spaceName = resName;
+                    }
+                }
+            };
+            // ...prompt for name
+            await promptName();
+            if (!spaceName) {
+                return undefined; /* <<<< returns early */
+            }
+        }
+        // ...create in memory with defaults
+        const now = new Date();
+        const timestamp = getTimestamp(now);
+        const timestampMs = now.getMilliseconds();
+        const newLocalSpace = new WebFilesystemSpace_V1(/*initialData*/ {
+            version: '1',
+            uuid: await getUUID(),
+            isTjp: true,
+            timestamp,
+            timestampMs,
+            name: spaceName,
+            baseDir: IBGIB_BASE_DIR,
+            spaceSubPath: spaceName,
+            baseSubPath: IBGIB_BASE_SUBPATH,
+            binSubPath: IBGIB_BIN_SUBPATH,
+            dnaSubPath: IBGIB_DNA_SUBPATH,
+            ibgibsSubPath: IBGIB_IBGIBS_SUBPATH,
+            metaSubPath: IBGIB_META_SUBPATH,
+            encoding: IBGIB_ENCODING,
+            persistOptsAndResultIbGibs: PERSIST_OPTS_AND_RESULTS_IBGIBS_DEFAULT,
+            validateIbGibAddrsMatchIbGibs: true,
+            trace: false,
+            description: DEFAULT_LOCAL_SPACE_DESCRIPTION,
+            allowPrimitiveArgs: false,
+            catchAllErrors: true,
+            longPollingIntervalMs: DEFAULT_LOCAL_SPACE_POLLING_INTERVAL_MS,
+        }, /*initialRel8ns*/ undefined);
+        if (logalot) {
+            console.log(`${lc} localSpace.ib: ${newLocalSpace.ib} (I: f57802654c5be84eb96d36d477425924)`);
+        }
+        if (logalot) {
+            console.log(`${lc} localSpace.gib: ${newLocalSpace.gib} (before sha256v1) (I: 4171271b7c1484e90205824a31067924)`);
+        }
+        if (logalot) {
+            console.log(`${lc} localSpace.data: ${pretty(newLocalSpace.data || 'falsy')} (I: 01221a1d7f6f19accf05b17534e3e624)`);
+        }
+        if (logalot) {
+            console.log(`${lc} localSpace.rel8ns: ${pretty(newLocalSpace.rel8ns || 'falsy')} (I: 750a7ec2b25b5d344dea900cf14ca524)`);
+        }
+        // trying out with tjp, can't remember why didn't have it except for
+        // backwards compatability which i'm no longer shooting for (will be
+        // able to project old spaces to new ones i believe)
+        // newLocalSpace.gib = await getGib({ ibGib: newLocalSpace, hasTjp: false });
+        newLocalSpace.gib = await getGib({ ibGib: toDto({ ibGib: newLocalSpace }), hasTjp: true });
+        if (newLocalSpace.gib === GIB) {
+            throw new Error(`localSpace.gib not updated correctly. (E: 277f8305ec3fd8dd4b023616c1fa0624)`);
+        }
+        if (logalot) {
+            console.log(`${lc} localSpace.gib: ${newLocalSpace.gib} (after sha256v1) (I: d3ab464fdb4500d95a50bf1e7c036524)`);
+        }
+        return newLocalSpace;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot) {
+            console.log(`${lc} complete.`);
+        }
+    }
+};
+export const fnDtoToSpace_webFilesystem = (spaceDto) => {
+    return Promise.resolve(WebFilesystemSpace_V1.createFromDto(spaceDto));
+};
+/**
+ * wrapper around metaspace.syncIbGibs
+ * @param param0
+ * @returns
+ */
+export async function doSync_awaitAllSagas({ addr, metaspace, localSpace, syncSpaces, sagaReporter, verbose, }) {
+    const lc = `[${doSync_awaitAllSagas.name}]`;
+    try {
+        if (logalot || verbose) {
+            console.log(`${lc} starting... (I: 78bf9e5bea88d9b3827bb991eeedc524)`);
+        }
+        const { ib, gib } = getIbAndGib({ ibGibAddr: addr });
+        if (isPrimitive({ gib })) {
+            throw new Error(`can't sync primitive ibgib (${addr}) (E: 915b331b00118b5f69e630ef5d2b8d24)`);
+        }
+        if (isSpaceIb({ ib })) {
+            throw new Error(`can't sync entire space ibgib (${addr}) (E: bd1b991e35a683df5a79c379c21d3924)`);
+        }
+        if (syncSpaces.length === 0) {
+            throw new Error(`syncSpaces required (E: 671b4f4adc6e009ed304419d662b2d24)`);
+        }
+        if (syncSpaces.some(x => !x.witness)) {
+            throw new Error(`(UNEXPECTED) syncSpaces.some(x => !x.witness)? sync spaces should all be witnesses (and have a witness function). these are not supposed to be just dtos (with ib, gib, data, rel8ns props). (E: 879c32b69856218f7eeafb89db491524)`);
+        }
+        if (verbose) {
+            await sagaReporter('getDependencyGraph starting... (I: 35cb6f89e87d7300b3be4088b4176a24)', null);
+        }
+        const dependencyGraph = await metaspace.getDependencyGraph({
+            space: localSpace,
+            ibGibAddr: addr,
+            live: true,
+            msBetweenRetries: 1000,
+        });
+        if (verbose) {
+            await sagaReporter('getDependencyGraph complete. (I: ec9aadd538ac3a61da3873c53852d324)', null);
+            await sagaReporter('syncIbGibs spinning off... (I: a15ddf897f8797848b350ad6a2067b24)', null);
+        }
+        const sagas = await metaspace.syncIbGibs({
+            dependencyGraphIbGibs: Object.values(dependencyGraph),
+            syncSpaceIbGibs: syncSpaces,
+            localSpace,
+        }) ?? [];
+        if (sagas.length === 0) {
+            throw new Error(`(UNEXPECTED) metaspace.syncIbGibs returned undefined (no sagas)? (E: 4d7faeb9ed95fe4b162f2a1377928b24)`);
+        }
+        if (verbose) {
+            await sagaReporter('syncIbGibs spin off complete. these are not yet done, it/they are just spun off and going. (I: a958a6b706c9b66933cb82ea7bbfcc24)', sagas.at(0) ?? null);
+        }
+        let sagaCount = sagas.length;
+        let sagaErrorCounter = 0;
+        /**
+         * using this during debugging...
+         */
+        const sagaErrorMsgs = [];
+        let sagaCompleteOrErrorCounter = 0;
+        let allSagasCompletePromise = new Promise((resolve, reject) => {
+            const interval = setInterval(async () => {
+                if (sagaCompleteOrErrorCounter === sagaCount) {
+                    if (sagaErrorCounter > 0) {
+                        reject(`saga had errors: ${sagaErrorMsgs.join('|')} (E: c039232a158cd69669e233a84f9be924)`);
+                    }
+                    clearInterval(interval);
+                    resolve();
+                }
+            }, 500);
+        });
+        const fnIncCompleteOrError = async (saga) => {
+            const lcInner = `${lc}[fnIncCompleteOrError]`;
+            if (logalot || verbose) {
+                console.log(`${lcInner} starting... (I: 1c41e7aaab13ecdf4f3608533f38b324)`);
+            }
+            try {
+                sagaCompleteOrErrorCounter++;
+                let updateText;
+                if (sagaCompleteOrErrorCounter < sagaCount) {
+                    updateText = `saga (${saga.sagaId}) complete or errored. ONLY SOME (${sagaCompleteOrErrorCounter}/${sagaCount}) have completed or errored. still more to go...`;
+                }
+                else if (sagaCompleteOrErrorCounter === sagaCount) {
+                    updateText = `saga (${saga.sagaId}) complete or errored. ALL ${sagaCount} sync sagas COMPLETE OR ERRORED.`;
+                }
+                else {
+                    debugger; // unexpected error state. sagaCompleteOrErrorCounter > sagaCount
+                    updateText = `uhh, there is an error here. we have incremented sagaCompleteOrErrorCounter (${sagaCompleteOrErrorCounter}) to be greater than sagaCount (${sagaCount}) (E: b8e934cfce188f40a93cb90a462c7c24)`;
+                }
+                if (logalot || verbose) {
+                    console.log(`${lc} ${updateText} (I: 519a895d1a7ddc44cf8b4532cf3b6524)`);
+                    await sagaReporter(`${lcInner} ${updateText}`, saga);
+                }
+            }
+            catch (error) {
+                console.error(`${lc} ${extractErrorMsg(error)}`);
+                throw error;
+            }
+            finally {
+                if (logalot || verbose) {
+                    console.log(`${lc}[fnIncCompleteOrError] complete. (I: f2be67aa53e59ab2e5a7f89b26b4df24)`);
+                }
+            }
+        };
+        for (let i = 0; i < sagas.length; i++) {
+            const saga = sagas[i];
+            let subscription = await saga.syncStatus$.subscribe(fnObs({
+                next: async (status) => {
+                    if (logalot || verbose) {
+                        console.log(`${lc} console.dir(status)... (I: e786c4449ebf14be5b2d63a61d22c824)`);
+                        console.dir(status);
+                    }
+                    else {
+                        let statusCode = status.data?.statusCode;
+                        if (statusCode === "already_synced") {
+                            process.stdout.write('.');
+                        }
+                        else {
+                            console.log(statusCode);
+                        }
+                    }
+                },
+                complete: async () => {
+                    if (logalot || verbose) {
+                        console.log(`${lc}[saga complete] triggered for saga (${saga.spaceId}, ${saga.multiSpaceOpId}). (I: 999536aeb555ac9eaac88c98aee71224)`);
+                    }
+                    await fnIncCompleteOrError(saga);
+                    await subscription.unsubscribe();
+                },
+                error: async (err) => {
+                    const errorMsg = extractErrorMsg(err);
+                    sagaErrorMsgs.push(errorMsg);
+                    if (errorMsg.includes('EAI_AGAIN')) {
+                        console.error(`this error may be because of no internet connection. ${errorMsg}`);
+                    }
+                    console.error(`${lc}[error] err: ${errorMsg} (E: 90b11d262194884ae8320ccbf7252124)`);
+                    sagaErrorCounter++;
+                    await fnIncCompleteOrError(saga);
+                    await subscription.unsubscribe();
+                    // sagaCompleteOrErrorCounter++;
+                }
+            }));
+        }
+        await allSagasCompletePromise;
+        return sagas;
+    }
+    catch (error) {
+        console.error(`${lc} ${extractErrorMsg(error)}`);
+        throw error;
+    }
+    finally {
+        if (logalot || verbose) {
+            console.log(`${lc} complete.`);
+        }
+    }
+}
+//# sourceMappingURL=metaspace-webspace-helper.mjs.map

package/dist/witness/space/metaspace/metaspace-webspace/metaspace-webspace-helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaspace-webspace-helper.mjs","sourceRoot":"","sources":["../../../../../src/witness/space/metaspace/metaspace-webspace/metaspace-webspace-helper.mts"],"names":[],"mappings":"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"}

package/dist/witness/space/metaspace/metaspace-webspace/metaspace-webspace.d.mts

@@ -0,0 +1,134 @@
+/**
+ * @module metaspace-webspace driven by a web indexeddb storage substrate
+ *
+ * a metaspace is a space of spaces. it adds/removes spaces and does
+ * inter-spatial composition related things. it's similar to what people think
+ * of in terms of a node in a p2p network.
+ */
+import { IbGibAddr } from '@ibgib/ts-gib/dist/types.mjs';
+import { IbGibSpaceAny } from '@ibgib/core-gib/dist/witness/space/space-base-v1.mjs';
+import { IbGibCacheService } from '@ibgib/core-gib/dist/common/cache/cache-types.mjs';
+import { MetaspaceBase } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-base.mjs';
+import { MetaspaceFactory, MetaspaceInitializeOptions } from '@ibgib/core-gib/dist/witness/space/metaspace/metaspace-types.mjs';
+import { SpaceId } from '@ibgib/core-gib/dist/witness/space/space-types.mjs';
+import { IbGib_V1 } from '@ibgib/ts-gib/dist/V1/types.mjs';
+import { SpecialIbGibType } from '@ibgib/core-gib/dist/common/other/other-types.mjs';
+/**
+ * All-purpose mega service (todo: which we'll need to break up!) to interact
+ * with ibgibs at the app/device level.
+ *
+ * This works with the local app user space.
+ *
+ * ## regarding special ibgibs
+ *
+ * Special ibgibs' behaviors are what hold in other apps configuration data.
+ * Of course the difference is that most special ibgibs can leverage the "on-chain"
+ * functionality of "regular" ibgibs.
+ *
+ * There are a couple meta ibgibs (which I also call "special"):
+ *   * roots^gib
+ *     * tracks other special root^gib ibgibs, which are like local app-level indexes.
+ *   * tags^gib
+ *     * tracks other special tag^gib ibgibs, which you can apply to any ibgib
+ *   * latest^gib
+ *     * tracks mappings between tjp -> latest ib^gib address
+ *     * ephemeral (deletes past rel8ns and past ibGib frames)
+ *   * ...
+ *
+ * ## regarding latest ibgibs
+ *
+ * The tjp (temporal junction point) defines atow the beginning of an ibGib
+ * timeline.  it's like the birthday for an ibGib. (Or you can think if it as
+ * the id for the stream of ibgib frames in a given timeline.)
+ *
+ * The latest ibGib in that timeline is also special, because it's often what
+ * you want to work with.
+ *
+ * So ideally, when an ibgib, A, has a tjp A1, and it is updated to A2, A3, An
+ * via `mut8` and/or `rel8` transforms, that ibgib creates a single timeline.
+ * This service attempts to track the relationship between that starting tjp
+ * address and its corresponding latest frame in that timeline, i.e., A1 -> An.
+ *
+ * ### mapping persistence implementation details
+ *
+ * The latest ibGib service is backed by a special ibgib that maintains the
+ * mapping index.  It does this by rel8-ing that special backing ibgib via the
+ * tjp pointer, e.g. [special latest ibgib^XXX000].rel8ns[A^TJP123] ===
+ * [A^N12345] . It does this via the ib^gib content address pointer, so this
+ * becomes a mapping from A^TJP123 to A^N12345.
+ *
+ * This backing ibGib is special (even for special ibGibs) in that:
+ *   * it does not relate itself with the current root of the application
+ *   * it does not maintain references to its past (i.e. rel8ns['past'] === [])
+ *   * it DELETES its previous incarnation from the files service
+ *
+ * In other words, this service is meant to be as ephemeral as possible. I am
+ * keeping it as an ibGib and not some other data format (like straight in
+ * storage/some other db) because I've found this is often useful and what I end
+ * up doing anyway to leverage other ibgib behavior. For example, in the future
+ * it may be good to take snapshots, which is a simple copy operation of the
+ * file persistence.
+ *
+ * ### current naive implementation notes
+ *
+ * questions:
+ *   * What do we want to do if we can't locate an ibGib record?
+ *   * How/when do we want to alert the user/our own code that we've found
+ *     multiple timelines for an ibGib with a tjp (usually a thing we want to
+ *     avoid)?
+ *   * Who do we want to notify when new ibGibs arrive?
+ *   * How often do we want to check external sources for latest?
+ *   * When do we get to merging ibGib timelines?
+ *
+ * This is behavior that is somewhat taken care of, e.g. in git, with the HEAD
+ * pointer for a repo.  But we're talking about here basically as a metarepo or
+ * "repo of repos", and unlike git, we don't want our HEAD metadata living "off
+ * chain" (outside of the DLT itself that it's modifying).  So eventually, what
+ * we want is just like what we want with ALL ibGibs: perspective. From "the
+ * app"'s perspective, the latest is mapped. But really, apps can't view slices
+ * of ibGib graphs in all sorts of interesting ways and still be productive &
+ * beneficial to the ecosystem as a whole.
+ */
+export declare class Metaspace_Webspace extends MetaspaceBase {
+    protected cacheSvc: IbGibCacheService | undefined;
+    protected lc: string;
+    get zeroSpace(): IbGibSpaceAny;
+    constructor(cacheSvc: IbGibCacheService | undefined);
+    protected initializeMetaspaceFactory({ metaspaceFactory }: {
+        metaspaceFactory: MetaspaceFactory;
+    }): Promise<void>;
+    initialize(args: MetaspaceInitializeOptions): Promise<void>;
+    initializeZeroSpace(): Promise<void>;
+    /**
+     * I'm overriding this to troubleshoot figuring out why the space is
+     * becoming invalid.
+     */
+    getLocalUserSpace({ lock, localSpaceId, }: {
+        lock?: boolean;
+        localSpaceId?: SpaceId;
+    }): Promise<IbGibSpaceAny | undefined>;
+    /**
+     * overriding to try to execute serially via commanding architecture.
+     *
+     * just wraps super call with {@link commandifyAnonFn}.
+     *
+     * @see {@link commandifyAnonFn}
+     */
+    rel8ToCurrentRoot(opts: {
+        ibGib: IbGib_V1;
+        linked?: boolean;
+        rel8nName?: string;
+        space?: IbGibSpaceAny;
+    }): Promise<void>;
+    rel8ToSpecialIbGib(opts: {
+        type: SpecialIbGibType;
+        rel8nName: string;
+        ibGibsToRel8?: IbGib_V1[];
+        ibGibsToUnRel8?: IbGib_V1[];
+        linked?: boolean;
+        severPast?: boolean;
+        deletePreviousSpecialIbGib?: boolean;
+        space?: IbGibSpaceAny;
+    }): Promise<IbGibAddr>;
+}
+//# sourceMappingURL=metaspace-webspace.d.mts.map

package/dist/witness/space/metaspace/metaspace-webspace/metaspace-webspace.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaspace-webspace.d.mts","sourceRoot":"","sources":["../../../../../src/witness/space/metaspace/metaspace-webspace/metaspace-webspace.mts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mDAAmD,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,iEAAiE,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAQhI,OAAO,EAAE,OAAO,EAAE,MAAM,oDAAoD,CAAC;AAE7E,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAyBrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IAqB7C,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS;IAlBrD,SAAS,CAAC,EAAE,EAAE,MAAM,CAAkC;IAEtD,IAAI,SAAS,IAAI,aAAa,CAW7B;gBAKa,QAAQ,EAAE,iBAAiB,GAAG,SAAS;cAarC,0BAA0B,CAAC,EAAE,gBAAgB,EAAE,EAAE;QAC7D,gBAAgB,EAAE,gBAAgB,CAAC;KACtC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEF,UAAU,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC1C;;;OAGG;IACY,iBAAiB,CAAC,EAAE,IAAI,EAAE,YAAY,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC;KAAE,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAyB1I;;;;;;OAMG;IACY,iBAAiB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,aAAa,CAAC;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CzH,kBAAkB,CAAC,IAAI,EAAE;QACpC,IAAI,EAAE,gBAAgB,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC1B,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,0BAA0B,CAAC,EAAE,OAAO,CAAC;QACrC,KAAK,CAAC,EAAE,aAAa,CAAC;KACzB,GAAG,OAAO,CAAC,SAAS,CAAC;CAwCzB"}