@amalgm/live 0.2.55 → 0.2.57

package/dist-cjs/transfer/ranges.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Ranged pack reading.
+ *
+ * Sealed envelopes of many small objects live inside one immutable pack.
+ * Requests for ranges of the same pack URL made in the same event-loop turn
+ * merge into minimal byte spans — one ranged GET per span — and every
+ * requester receives exactly its envelope slice. A small hole between wanted
+ * ranges is cheaper to read through than to split a request over, so spans
+ * merge across gaps up to RANGE_MERGE_GAP_BYTES. Wrong or shifted bytes can
+ * never leak: every dispensed slice is still an authenticated envelope the
+ * caller opens and hash-verifies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPAN_FETCH_MAX_IN_FLIGHT_BYTES = exports.RANGE_MERGE_GAP_BYTES = void 0;
+exports.planSpans = planSpans;
+exports.createSpanFetcher = createSpanFetcher;
+/** Read through holes up to this size rather than splitting a range request. */
+exports.RANGE_MERGE_GAP_BYTES = 64 * 1024;
+/** Merged span bytes one fetcher may hold in flight at once. Admission of
+ * spans — not just of the objects above them — is byte-bounded, so a wide
+ * same-turn fan-out can never hold every pack's sealed bytes at once. */
+exports.SPAN_FETCH_MAX_IN_FLIGHT_BYTES = 64 * 1024 * 1024;
+function invalidSpan(span) {
+    return !Number.isSafeInteger(span.offset) || span.offset < 0
+        || !Number.isSafeInteger(span.length) || span.length < 1
+        || !Number.isSafeInteger(span.offset + span.length);
+}
+/** Merge wanted ranges into minimal fetch spans. Pure planning — no IO. */
+function planSpans(requests, mergeGap) {
+    if (requests.length === 0)
+        return { spans: [], slices: [] };
+    if (!Number.isSafeInteger(mergeGap) || mergeGap < 0) {
+        throw new Error('range plan received an invalid merge gap');
+    }
+    if (requests.some(invalidSpan))
+        throw new Error('range plan received an invalid byte span');
+    const order = requests.map((request, index) => ({ request, index }))
+        .sort((a, b) => a.request.offset - b.request.offset || a.request.length - b.request.length);
+    const spans = [];
+    const slices = new Array(requests.length);
+    for (const { request, index } of order) {
+        const end = request.offset + request.length;
+        const current = spans[spans.length - 1];
+        if (current && request.offset <= current.end + mergeGap) {
+            current.end = Math.max(current.end, end);
+        }
+        else {
+            spans.push({ offset: request.offset, end });
+        }
+        slices[index] = { span: spans.length - 1, start: request.offset - spans[spans.length - 1].offset };
+    }
+    return {
+        spans: spans.map((span) => ({ offset: span.offset, length: span.end - span.offset })),
+        slices,
+    };
+}
+function createSpanFetcher(ports) {
+    const pending = new Map();
+    let scheduled = false;
+    // The memory law: merged span bytes in flight are admission-bounded. A
+    // span above the cap admits alone rather than deadlocking.
+    let inFlightSpanBytes = 0;
+    const waitingSpans = [];
+    const spanWeight = (length) => Math.min(length, exports.SPAN_FETCH_MAX_IN_FLIGHT_BYTES);
+    const admitSpan = (length) => new Promise((admit) => {
+        const weight = spanWeight(length);
+        if (inFlightSpanBytes === 0 || inFlightSpanBytes + weight <= exports.SPAN_FETCH_MAX_IN_FLIGHT_BYTES) {
+            inFlightSpanBytes += weight;
+            admit();
+            return;
+        }
+        waitingSpans.push({ weight, admit });
+    });
+    const releaseSpan = (length) => {
+        inFlightSpanBytes -= spanWeight(length);
+        while (waitingSpans.length > 0) {
+            const next = waitingSpans[0];
+            if (inFlightSpanBytes !== 0
+                && inFlightSpanBytes + next.weight > exports.SPAN_FETCH_MAX_IN_FLIGHT_BYTES)
+                return;
+            waitingSpans.shift();
+            inFlightSpanBytes += next.weight;
+            next.admit();
+        }
+    };
+    const flushUrl = async (url, waiters) => {
+        let plan;
+        try {
+            plan = planSpans(waiters.map((waiter) => waiter.range), exports.RANGE_MERGE_GAP_BYTES);
+        }
+        catch (error) {
+            waiters.forEach((waiter) => waiter.reject(error));
+            return;
+        }
+        await Promise.all(plan.spans.map(async (span, spanIndex) => {
+            const served = [];
+            plan.slices.forEach((slice, index) => {
+                if (slice.span === spanIndex)
+                    served.push({ waiter: waiters[index], start: slice.start });
+            });
+            await admitSpan(span.length);
+            try {
+                const bytes = await ports.fetchSpan(url, span);
+                if (bytes.length !== span.length) {
+                    throw new Error(`pack range answered ${bytes.length} bytes where ${span.length} were requested`);
+                }
+                // Copies, not views: a dispensed slice must never pin the whole
+                // merged span buffer for as long as its consumer holds it.
+                served.forEach(({ waiter, start }) => waiter.resolve(bytes.slice(start, start + waiter.range.length)));
+            }
+            catch (error) {
+                served.forEach(({ waiter }) => waiter.reject(error));
+            }
+            finally {
+                releaseSpan(span.length);
+            }
+        }));
+    };
+    const flush = () => {
+        scheduled = false;
+        const batches = [...pending.entries()];
+        pending.clear();
+        for (const [url, waiters] of batches)
+            void flushUrl(url, waiters);
+    };
+    return {
+        fetch(ref) {
+            if (ref.offset == null && ref.length == null) {
+                return ports.fetchSpan(ref.url, null);
+            }
+            const range = { offset: ref.offset ?? -1, length: ref.length ?? -1 };
+            if (invalidSpan(range)) {
+                return Promise.reject(new Error('content ref carries an invalid pack range'));
+            }
+            return new Promise((resolve, reject) => {
+                const waiters = pending.get(ref.url);
+                if (waiters)
+                    waiters.push({ range, resolve, reject });
+                else
+                    pending.set(ref.url, [{ range, resolve, reject }]);
+                if (!scheduled) {
+                    scheduled = true;
+                    setTimeout(flush, 0);
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=ranges.js.map

package/dist-cjs/transfer/ranges.js.map

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

package/dist-cjs/transfer/refs.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Content-ref brokering for direct content-storage fetches.
+ *
+ * Downloads fetch every storage object straight from content storage. Callers
+ * ask where one object lives at a time; the broker coalesces every request
+ * made in the same event-loop turn into one batched refs call. The authority
+ * answers each object with a short-lived URL and, when the object's sealed
+ * envelope rides inside an immutable pack, the exact byte range holding it.
+ * URLs are used immediately and never cached — their expiry is the gateway's
+ * revocation lever.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTENT_REFS_BATCH_OBJECTS = void 0;
+exports.createRefsBroker = createRefsBroker;
+/** One law shared with the gateway: the most objects one refs call may name. */
+exports.CONTENT_REFS_BATCH_OBJECTS = 2048;
+function createRefsBroker(ports) {
+    let pending = [];
+    let scheduled = false;
+    const flush = async () => {
+        scheduled = false;
+        while (pending.length > 0) {
+            const batch = pending.splice(0, exports.CONTENT_REFS_BATCH_OBJECTS);
+            try {
+                const refs = await ports.requestRefs(batch.map((waiter) => waiter.object));
+                if (refs.length !== batch.length) {
+                    throw new Error('content refs answered the wrong number of objects');
+                }
+                batch.forEach((waiter, index) => waiter.resolve(refs[index]));
+            }
+            catch (error) {
+                batch.forEach((waiter) => waiter.reject(error));
+            }
+        }
+    };
+    return {
+        ref(object) {
+            return new Promise((resolve, reject) => {
+                pending.push({ object, resolve, reject });
+                if (!scheduled) {
+                    scheduled = true;
+                    setTimeout(() => { void flush(); }, 0);
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=refs.js.map

package/dist-cjs/transfer/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/transfer/refs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAmCH,4CA+BC;AAhED,gFAAgF;AACnE,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAgC/C,SAAgB,gBAAgB,CAAC,KAAsB;IACrD,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,SAAS,GAAG,KAAK,CAAC;QAClB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,kCAA0B,CAAC,CAAC;YAC5D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;gBACvE,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC;YACjE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,CAAC,MAAyB;YAC3B,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACjD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,SAAS,GAAG,IAAI,CAAC;oBACjB,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/live",
-  "version": "0.2.55",
+  "version": "0.2.57",
   "description": "Portable realtime SDK for Amalgm — wire contracts, mutation discipline, and delivery state machines behind host-injected adapters.",
   "type": "module",
   "main": "./dist-cjs/index.js",
@@ -94,7 +94,7 @@
     "certification:smoke": "node certification/src/release.mjs prepare --profile smoke --amalgm-version latest",
     "certification:release": "node certification/src/release.mjs prepare --profile certification",
     "certification:preflight": "node certification/src/release.mjs preflight",
-    "test": "npm run build && node --test tests/",
+    "test": "npm run build && node --test",
     "test:parity": "npm run build && node --test tests/parity/"
   },
   "devDependencies": {

package/dist/transfer/presign.d.ts

@@ -1,26 +0,0 @@
-/**
- * Presigned-URL brokering for direct content-storage fetches.
- *
- * Downloads fetch every storage object straight from content storage using
- * short-lived URLs the gateway signs. Callers ask for one object's URL at a
- * time; the broker coalesces every request made in the same event-loop turn
- * into one batched signing call, so thousands of tiny fetches cost a handful
- * of control-plane round trips. URLs are used immediately and never cached —
- * their expiry is the gateway's revocation lever.
- */
-/** One law shared with the gateway: the most objects one signing call may name. */
-export declare const PRESIGN_BATCH_OBJECTS = 2048;
-export interface PresignObject {
-    /** 'manifest' names a whole artifact by content hash; 'block' one chunk by its sha256. */
-    readonly kind: 'manifest' | 'block';
-    readonly sha256: string;
-}
-export interface PresignBrokerPorts {
-    /** Sign every named object, returning URLs aligned by index. */
-    requestUrls(objects: readonly PresignObject[]): Promise<readonly string[]>;
-}
-export interface PresignBroker {
-    url(object: PresignObject): Promise<string>;
-}
-export declare function createPresignBroker(ports: PresignBrokerPorts): PresignBroker;
-//# sourceMappingURL=presign.d.ts.map

package/dist/transfer/presign.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"presign.d.ts","sourceRoot":"","sources":["../../src/transfer/presign.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,WAAW,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAQD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CA+B5E"}

package/dist/transfer/presign.js

@@ -1,44 +0,0 @@
-/**
- * Presigned-URL brokering for direct content-storage fetches.
- *
- * Downloads fetch every storage object straight from content storage using
- * short-lived URLs the gateway signs. Callers ask for one object's URL at a
- * time; the broker coalesces every request made in the same event-loop turn
- * into one batched signing call, so thousands of tiny fetches cost a handful
- * of control-plane round trips. URLs are used immediately and never cached —
- * their expiry is the gateway's revocation lever.
- */
-/** One law shared with the gateway: the most objects one signing call may name. */
-export const PRESIGN_BATCH_OBJECTS = 2048;
-export function createPresignBroker(ports) {
-    let pending = [];
-    let scheduled = false;
-    const flush = async () => {
-        scheduled = false;
-        while (pending.length > 0) {
-            const batch = pending.splice(0, PRESIGN_BATCH_OBJECTS);
-            try {
-                const urls = await ports.requestUrls(batch.map((waiter) => waiter.object));
-                if (urls.length !== batch.length) {
-                    throw new Error('presign returned the wrong number of urls');
-                }
-                batch.forEach((waiter, index) => waiter.resolve(urls[index]));
-            }
-            catch (error) {
-                batch.forEach((waiter) => waiter.reject(error));
-            }
-        }
-    };
-    return {
-        url(object) {
-            return new Promise((resolve, reject) => {
-                pending.push({ object, resolve, reject });
-                if (!scheduled) {
-                    scheduled = true;
-                    setTimeout(() => { void flush(); }, 0);
-                }
-            });
-        },
-    };
-}
-//# sourceMappingURL=presign.js.map

package/dist/transfer/presign.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"presign.js","sourceRoot":"","sources":["../../src/transfer/presign.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAuB1C,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,SAAS,GAAG,KAAK,CAAC;QAClB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBAC/D,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC;YACjE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,CAAC,MAAqB;YACvB,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,SAAS,GAAG,IAAI,CAAC;oBACjB,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist-cjs/transfer/presign.js

@@ -1,48 +0,0 @@
-"use strict";
-/**
- * Presigned-URL brokering for direct content-storage fetches.
- *
- * Downloads fetch every storage object straight from content storage using
- * short-lived URLs the gateway signs. Callers ask for one object's URL at a
- * time; the broker coalesces every request made in the same event-loop turn
- * into one batched signing call, so thousands of tiny fetches cost a handful
- * of control-plane round trips. URLs are used immediately and never cached —
- * their expiry is the gateway's revocation lever.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PRESIGN_BATCH_OBJECTS = void 0;
-exports.createPresignBroker = createPresignBroker;
-/** One law shared with the gateway: the most objects one signing call may name. */
-exports.PRESIGN_BATCH_OBJECTS = 2048;
-function createPresignBroker(ports) {
-    let pending = [];
-    let scheduled = false;
-    const flush = async () => {
-        scheduled = false;
-        while (pending.length > 0) {
-            const batch = pending.splice(0, exports.PRESIGN_BATCH_OBJECTS);
-            try {
-                const urls = await ports.requestUrls(batch.map((waiter) => waiter.object));
-                if (urls.length !== batch.length) {
-                    throw new Error('presign returned the wrong number of urls');
-                }
-                batch.forEach((waiter, index) => waiter.resolve(urls[index]));
-            }
-            catch (error) {
-                batch.forEach((waiter) => waiter.reject(error));
-            }
-        }
-    };
-    return {
-        url(object) {
-            return new Promise((resolve, reject) => {
-                pending.push({ object, resolve, reject });
-                if (!scheduled) {
-                    scheduled = true;
-                    setTimeout(() => { void flush(); }, 0);
-                }
-            });
-        },
-    };
-}
-//# sourceMappingURL=presign.js.map

package/dist-cjs/transfer/presign.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"presign.js","sourceRoot":"","sources":["../../src/transfer/presign.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA0BH,kDA+BC;AAvDD,mFAAmF;AACtE,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAuB1C,SAAgB,mBAAmB,CAAC,KAAyB;IAC3D,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,SAAS,GAAG,KAAK,CAAC;QAClB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,6BAAqB,CAAC,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC3E,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBAC/D,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC;YACjE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,CAAC,MAAqB;YACvB,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC7C,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,SAAS,GAAG,IAAI,CAAC;oBACjB,UAAU,CAAC,GAAG,EAAE,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}