@agentshouse/mdruntime-adapter 0.1.0-cd028205a5103 → 0.1.0-ce3fe65a95f49

package/dist/read.d.ts

@@ -1,4 +1,4 @@
-import type { BootstrapPage, RefreshResult, RoomAttachment } from '@agentshouse/mdruntime';
+import type { BinaryFile, BootstrapPage, RefreshResult } from '@agentshouse/mdruntime';
 import type { TrackedAuthority } from './discovery.js';
 import type { HouseMode } from './transport.js';
 import { type LogPosition } from './version.js';
@@ -8,6 +8,7 @@ export type HouseManifestFile = {
     revision: string | undefined;
     version: string;
     head?: HeadChange;
+    binary?: BinaryFile;
 };
 export type HouseContent = {
     path: string;
@@ -17,10 +18,14 @@ export type HouseScope = LogPosition & {
     anchor: string;
     files: readonly HouseManifestFile[];
     contents: readonly HouseContent[];
-    attachments?: readonly RoomAttachment[];
+};
+export type HouseCursor = {
+    room: string;
+    path: string | null;
 };
 export type HouseEnvelope = {
     scopes: readonly HouseScope[];
+    next?: HouseCursor;
 };
 export type HouseGrant = {
     method: 'GET';
@@ -41,14 +46,14 @@ export type HouseChange = {
     head?: HeadChange;
 } | {
     path: string;
-    reference: {
-        revision: string;
-    };
+    binary: BinaryFile;
+    revision: string | undefined;
+    version: string;
+    head?: HeadChange;
 };
 export type HouseView = LogPosition & {
     authority: string;
     changes: readonly HouseChange[];
-    attachments?: readonly RoomAttachment[];
 };
 export type HouseEnumeration = {
     authorities: readonly HouseView[];
@@ -61,9 +66,11 @@ export declare function headChange(held: {
     readonly author?: unknown;
     readonly created_at?: unknown;
 }): HeadChange | undefined | null;
-export declare function parseOriginals(value: unknown): readonly RoomAttachment[] | null;
+export declare function binaryFileOf(held: Readonly<Record<string, unknown>>): BinaryFile | undefined | null;
 export declare function parseEnvelope(body: unknown): HouseEnvelope | null;
 export declare function parseSiteBootstrap(body: unknown): HouseScope | null;
+export declare function siteBootstrapNext(body: unknown): string | null;
+export declare function siteBootstrapOffset(body: unknown): number | null;
 export declare function parseEnumeration(body: unknown, mode: HouseMode): HouseEnumeration | null;
 export declare function advancedScope(scope: HouseScope, view: HouseView): HouseScope;
 export declare function matchesScope(scope: HouseScope, tracked: TrackedAuthority): boolean;

package/dist/read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEb,aAAa,EACb,cAAc,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,GAC/B;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,SAAS,SAAS,EAAE,CAAC;CACnC,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,MAAM,EAAE,CAK5E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAU3D;AAWD,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B,GAAG,UAAU,GAAG,SAAS,GAAG,IAAI,CAMhC;AAeD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,cAAc,EAAE,GAAG,IAAI,CAS/E;AAmDD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAUjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAEnE;AAoCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAyBxF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,CA2B5E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAElF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAsB5D;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAO9E;AAED,wBAAgB,MAAM,CACpB,WAAW,EAAE,gBAAgB,EAC7B,OAAO,EAAE,gBAAgB,GACxB,SAAS,GAAG,SAAS,CAEvB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,aAAa,CA+BnF"}
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"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"}

package/dist/read.js

@@ -51,32 +51,19 @@ export function headChange(held) {
 function headed(head) {
     return head === undefined ? {} : { head };
 }
-function parseOriginal(value) {
-    if (typeof value !== 'object' || value === null)
-        return null;
-    const { attachment, name, bytes, media_type: mediaType } = value;
-    if (typeof attachment !== 'string' || typeof name !== 'string')
-        return null;
-    if (typeof bytes !== 'number' || !Number.isSafeInteger(bytes) || bytes < 0)
-        return null;
-    if (mediaType !== null && typeof mediaType !== 'string')
-        return null;
-    return { reference: attachment, name, byteLength: bytes, mediaType, entry: value };
-}
-export function parseOriginals(value) {
-    if (!Array.isArray(value))
+export function binaryFileOf(held) {
+    if (held.file === undefined)
+        return undefined;
+    const { file, bytes, media_type: mediaType, sha256 } = held;
+    if (typeof file !== 'string' ||
+        typeof bytes !== 'number' ||
+        typeof mediaType !== 'string' ||
+        typeof sha256 !== 'string')
         return null;
-    const attachments = [];
-    for (const entry of value) {
-        const attachment = parseOriginal(entry);
-        if (attachment === null)
-            return null;
-        attachments.push(attachment);
-    }
-    return attachments;
+    return { fileRef: file, byteLength: bytes, mediaType, sha256 };
 }
-function declared(attachments) {
-    return attachments === undefined ? {} : { attachments };
+function binaried(binary) {
+    return binary === undefined ? {} : { binary };
 }
 function parseFile(value, mode) {
     if (typeof value !== 'object' || value === null)
@@ -85,16 +72,29 @@ function parseFile(value, mode) {
     if (typeof file.path !== 'string')
         return null;
     const head = headChange(file);
-    if (head === null)
+    const binary = binaryFileOf(file);
+    if (head === null || binary === null)
         return null;
     if (mode === 'site') {
         if (typeof file.sha256 !== 'string')
             return null;
-        return { path: file.path, revision: undefined, version: file.sha256, ...headed(head) };
+        return {
+            path: file.path,
+            revision: binary?.sha256,
+            version: file.sha256,
+            ...headed(head),
+            ...binaried(binary),
+        };
     }
     if (typeof file.revision !== 'string')
         return null;
-    return { path: file.path, revision: file.revision, version: file.revision, ...headed(head) };
+    return {
+        path: file.path,
+        revision: file.revision,
+        version: file.revision,
+        ...headed(head),
+        ...binaried(binary),
+    };
 }
 function parseScope(value, mode) {
     if (typeof value !== 'object' || value === null)
@@ -130,12 +130,15 @@ function parseScope(value, mode) {
             return null;
         contents.push({ path: content.path, content: content.content });
     }
-    if (mode === 'site')
-        return { anchor: manifest.anchor, ...at, files, contents };
-    const attachments = parseOriginals(held.originals);
-    if (attachments === null)
+    return { anchor: manifest.anchor, ...at, files, contents };
+}
+function parseCursor(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const { room, path } = value;
+    if (typeof room !== 'string' || (path !== null && typeof path !== 'string'))
         return null;
-    return { anchor: manifest.anchor, ...at, files, contents, attachments };
+    return { room, path };
 }
 export function parseEnvelope(body) {
     if (typeof body !== 'object' || body === null)
@@ -149,11 +152,26 @@ export function parseEnvelope(body) {
             return null;
         scopes.push(scope);
     }
-    return { scopes };
+    if (!('next' in body) || body.next === undefined)
+        return { scopes };
+    const next = parseCursor(body.next);
+    return next === null ? null : { scopes, next };
 }
 export function parseSiteBootstrap(body) {
     return parseScope(body, 'site');
 }
+export function siteBootstrapNext(body) {
+    if (typeof body !== 'object' || body === null || !('next' in body))
+        return null;
+    return typeof body.next === 'string' && body.next.length > 0 ? body.next : null;
+}
+export function siteBootstrapOffset(body) {
+    if (typeof body !== 'object' || body === null || !('offset' in body))
+        return null;
+    return Number.isSafeInteger(body.offset) && body.offset > 0
+        ? body.offset
+        : null;
+}
 function parseChange(value, mode) {
     if (typeof value !== 'object' || value === null)
         return null;
@@ -163,8 +181,15 @@ function parseChange(value, mode) {
     if (held.removed === true)
         return { path: held.path, removed: true };
     const head = headChange(held);
-    if (head === null)
+    const binary = binaryFileOf(held);
+    if (head === null || binary === null)
         return null;
+    if (binary !== undefined) {
+        if (mode === 'credential' && typeof held.revision !== 'string')
+            return null;
+        const revision = typeof held.revision === 'string' ? held.revision : binary.sha256;
+        return { path: held.path, binary, revision, version: revision, ...headed(head) };
+    }
     if (mode === 'site') {
         if (typeof held.content !== 'string' || typeof held.sha256 !== 'string')
             return null;
@@ -185,12 +210,6 @@ function parseChange(value, mode) {
             ...headed(head),
         };
     }
-    if (typeof held.reference === 'object' && held.reference !== null) {
-        const reference = held.reference;
-        if (typeof reference.revision !== 'string')
-            return null;
-        return { path: held.path, reference: { revision: reference.revision } };
-    }
     return null;
 }
 export function parseEnumeration(body, mode) {
@@ -215,14 +234,7 @@ export function parseEnumeration(body, mode) {
                 return null;
             changes.push(mapped);
         }
-        if (mode === 'site') {
-            authorities.push({ authority: held.authority, ...at, changes });
-            continue;
-        }
-        const attachments = parseOriginals(held.originals);
-        if (attachments === null)
-            return null;
-        authorities.push({ authority: held.authority, ...at, changes, attachments });
+        authorities.push({ authority: held.authority, ...at, changes });
     }
     return { authorities };
 }
@@ -234,18 +246,15 @@ export function advancedScope(scope, view) {
         contents.delete(change.path);
         if ('removed' in change)
             continue;
-        if ('content' in change) {
-            files.set(change.path, {
-                path: change.path,
-                revision: change.revision,
-                version: change.version,
-                ...headed(change.head),
-            });
+        files.set(change.path, {
+            path: change.path,
+            revision: change.revision,
+            version: change.version,
+            ...headed(change.head),
+            ...('binary' in change ? { binary: change.binary } : {}),
+        });
+        if ('content' in change)
             contents.set(change.path, change.content);
-            continue;
-        }
-        const { revision } = change.reference;
-        files.set(change.path, { path: change.path, revision, version: revision });
     }
     return {
         ...scope,
@@ -263,16 +272,16 @@ export function bootstrapOf(scope) {
     const documents = {};
     const revisions = {};
     const changes = {};
-    const binaryTargets = [];
+    const binaryFiles = {};
     for (const file of scope.files) {
         if (file.revision !== undefined)
             revisions[file.path] = file.revision;
         if (file.head !== undefined)
             changes[file.path] = file.head;
         const content = contents.get(file.path);
-        if (content === undefined)
-            binaryTargets.push(file.path);
-        else
+        if (file.binary !== undefined)
+            binaryFiles[file.path] = file.binary;
+        else if (content !== undefined)
             documents[file.path] = content;
     }
     return {
@@ -281,8 +290,7 @@ export function bootstrapOf(scope) {
         documents,
         revisions,
         changes,
-        binaryTargets: binaryTargets.sort(),
-        ...declared(scope.attachments),
+        binaryFiles,
     };
 }
 export function schemaOf(scope, schema) {
@@ -303,23 +311,21 @@ export function refreshFrom(view, fromRoomVersion) {
     const documents = {};
     const revisions = {};
     const changes = {};
-    const binaryTargets = [];
+    const binaryFiles = {};
     const removals = [];
     for (const change of view.changes) {
         if ('removed' in change) {
             removals.push(change.path);
             continue;
         }
-        if ('content' in change) {
+        if ('content' in change)
             documents[change.path] = change.content;
-            if (change.revision !== undefined)
-                revisions[change.path] = change.revision;
-            if (change.head !== undefined)
-                changes[change.path] = change.head;
-            continue;
-        }
-        binaryTargets.push(change.path);
-        revisions[change.path] = change.reference.revision;
+        else
+            binaryFiles[change.path] = change.binary;
+        if (change.revision !== undefined)
+            revisions[change.path] = change.revision;
+        if (change.head !== undefined)
+            changes[change.path] = change.head;
     }
     return {
         kind: 'net-advancement',
@@ -327,8 +333,7 @@ export function refreshFrom(view, fromRoomVersion) {
         documents,
         revisions,
         changes,
-        binaryTargets: binaryTargets.sort(),
+        binaryFiles,
         removals: removals.sort(),
-        ...declared(view.attachments),
     };
 }

package/dist/referrer.d.ts

@@ -0,0 +1,7 @@
+import type { TrackedAuthority } from './discovery.js';
+export type HouseReferrer = {
+    locator: string;
+    referrer: Readonly<Record<string, string>>;
+};
+export declare function houseReferrer(referrer: unknown, tracked: ReadonlyMap<string, TrackedAuthority>): HouseReferrer | null;
+//# sourceMappingURL=referrer.d.ts.map

package/dist/referrer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referrer.d.ts","sourceRoot":"","sources":["../src/referrer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAgB5F,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,aAAa,GAAG,IAAI,CAqBtB"}

package/dist/referrer.js

@@ -0,0 +1,35 @@
+function fields(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function named(held, ...keys) {
+    const present = Object.keys(held);
+    return (present.length === keys.length &&
+        keys.every((key) => typeof held[key] === 'string' && held[key] !== ''));
+}
+export function houseReferrer(referrer, tracked) {
+    const held = fields(referrer);
+    if (held === null)
+        return null;
+    if (named(held, 'room', 'path')) {
+        const entry = tracked.get(held.room);
+        if (entry === undefined)
+            return null;
+        return {
+            locator: entry.locator,
+            referrer: { room_ref: entry.authority, path: held.path },
+        };
+    }
+    if (named(held, 'room_ref', 'record')) {
+        const roomRef = held.room_ref;
+        const entry = [...tracked.values()].find((candidate) => candidate.authority === roomRef);
+        return {
+            locator: entry?.locator ?? roomRef,
+            referrer: { room_ref: roomRef, record: held.record },
+        };
+    }
+    if (named(held, 'message'))
+        return { locator: '', referrer: { message: held.message } };
+    return null;
+}

package/dist/refusal.d.ts

@@ -1,9 +1,6 @@
 import type { AdapterFailure, DiscoverResult, ProviderRefusal, ScopedRefusal } from '@agentshouse/mdruntime';
-export type DoorRefusal = ProviderRefusal & {
-    retryable: boolean;
-};
-export declare function doorRefusal(body: unknown): DoorRefusal | null;
-export declare function scopedRefusal(locator: string, scope: ScopedRefusal['scope'], refusal: DoorRefusal): ScopedRefusal;
+export declare function doorRefusal(body: unknown): ProviderRefusal | null;
+export declare function scopedRefusal(locator: string, scope: ScopedRefusal['scope'], refusal: ProviderRefusal): ScopedRefusal;
 export declare function classifyDoor(status: number, body: unknown, locator: string): AdapterFailure | null;
 export declare function classifyRead(status: number, body: unknown, locator: string): AdapterFailure | {
     kind: 'beyond-horizon';

package/dist/refusal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../src/refusal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAO7D;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,GACnB,aAAa,CAEf;AAmBD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAMvB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAYrF"}
+{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../src/refusal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAOjE;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAC7B,OAAO,EAAE,eAAe,GACvB,aAAa,CAEf;AAqBD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG,IAAI,CAMvB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,GACd,cAAc,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAGpD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQrF"}

package/dist/refusal.js

@@ -6,11 +6,11 @@ export function doorRefusal(body) {
     const error = body.error;
     if (typeof error.code !== 'string')
         return null;
-    const { code, ...fields } = error;
-    return { code, fields, retryable: error.retryable === true };
+    const { code, retryable, ...fields } = error;
+    return { code, fields, retryable: retryable === true };
 }
 export function scopedRefusal(locator, scope, refusal) {
-    return { kind: 'scoped-refusal', locator, scope, code: refusal.code, fields: refusal.fields };
+    return { kind: 'scoped-refusal', locator, scope, ...refusal };
 }
 function doorFailure(status, body) {
     if (status === 0)
@@ -18,8 +18,9 @@ function doorFailure(status, body) {
     const refusal = doorRefusal(body);
     if (status === 401)
         return { kind: 'revoked-authorization' };
-    if (refusal?.retryable === true)
+    if (refusal?.retryable === true || refusal?.code === 'update_required') {
         return { kind: 'transport-uncertainty' };
+    }
     if (status === 404 || refusal?.code === 'room_not_found')
         return { kind: 'room-not-readable' };
     if (status < 400)
@@ -50,11 +51,7 @@ export function discoveryFailure(status, body) {
     if (failure.kind === 'revoked-authorization')
         return failure;
     if (failure.kind === 'refused') {
-        return {
-            kind: 'contract-unavailable',
-            code: failure.refusal.code,
-            fields: failure.refusal.fields,
-        };
+        return { kind: 'contract-unavailable', ...failure.refusal };
     }
     return { kind: 'transport-uncertainty' };
 }

package/dist/site.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAMR,MAAM,wBAAwB,CAAC;AAsBhC,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAgCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAkIxE"}
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAOR,MAAM,wBAAwB,CAAC;AAyBhC,OAAO,EAOL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAmCxB,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAqPxE"}