@onlyne/lib 3.1.0 → 3.2.0

package/dist/resolve.d.ts

@@ -0,0 +1,18 @@
+import type { NodeId, Target, TrustEntry } from './types.ts';
+/**
+ * The one place an address is composed for the wire (RFC 0011 §4, RFC 0018 §5.1).
+ * The host resolver — usually the discovery catalog — answers first. When it reports
+ * `not_found` (never observed) or `unavailable` (recorded but no address answers), a
+ * trusted row's `base_url` is the authoritative fallback: probing it succeeds writes the
+ * address back into the discovery catalog, so a peer that moved stays reachable and the
+ * new address becomes visible to the model. A trusted row whose address also fails is
+ * `unavailable` — never degraded to `not_found`, which names an unknown identity.
+ */
+export declare function composeResolver(deps: {
+    resolve: (node: NodeId) => Promise<Target>;
+    trust?: {
+        entry(node: NodeId): Promise<TrustEntry | undefined>;
+    };
+    observe?: (base_url: string, source: string, expectedNode?: NodeId) => Promise<unknown>;
+}): (node: NodeId) => Promise<Target>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;KAAE,CAAC;IACjE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAsBpC"}

package/dist/resolve.js

@@ -0,0 +1,37 @@
+import { OnlyneError } from "./core.js";
+/**
+ * The one place an address is composed for the wire (RFC 0011 §4, RFC 0018 §5.1).
+ * The host resolver — usually the discovery catalog — answers first. When it reports
+ * `not_found` (never observed) or `unavailable` (recorded but no address answers), a
+ * trusted row's `base_url` is the authoritative fallback: probing it succeeds writes the
+ * address back into the discovery catalog, so a peer that moved stays reachable and the
+ * new address becomes visible to the model. A trusted row whose address also fails is
+ * `unavailable` — never degraded to `not_found`, which names an unknown identity.
+ */
+export function composeResolver(deps) {
+    return async (node) => {
+        try {
+            return await deps.resolve(node);
+        }
+        catch (error) {
+            const failure = error instanceof OnlyneError
+                ? error.error
+                : error?.error;
+            if (failure?.code !== 'not_found' && failure?.code !== 'unavailable')
+                throw error;
+            const entry = await deps.trust?.entry(node);
+            if (entry === undefined || entry.state !== 'trusted' || entry.base_url.length === 0)
+                throw error;
+            if (deps.observe !== undefined) {
+                try {
+                    await deps.observe(entry.base_url, 'trust-row', node);
+                }
+                catch {
+                    throw new OnlyneError('unavailable', `${node} holds a trusted row whose address is ${entry.base_url}, but no recorded address answered and that address did not verify either.`);
+                }
+            }
+            return { node_id: node, base_url: entry.base_url };
+        }
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAI/B;IACC,OAAO,KAAK,EAAC,IAAI,EAAC,EAAE;QAClB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAwB,KAAK,YAAY,WAAW;gBAC/D,CAAC,CAAC,KAAK,CAAC,KAAK;gBACb,CAAC,CAAE,KAAoC,EAAE,KAAK,CAAC;YACjD,IAAI,OAAO,EAAE,IAAI,KAAK,WAAW,IAAI,OAAO,EAAE,IAAI,KAAK,aAAa;gBAAE,MAAM,KAAK,CAAC;YAClF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAC;YACjG,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;gBACxD,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,WAAW,CAAC,aAAa,EACjC,GAAG,IAAI,yCAAyC,KAAK,CAAC,QAAQ,4EAA4E,CAAC,CAAC;gBAChJ,CAAC;YACH,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,25 @@
+import type { AckReceipt, Auth, HandoverProbe, Json, LogQuery, Mutation, OperationRecord, OperationRequest, OperationResult, Page, PageOptions, ProbeAnswer, Resource, ResourceEvent, ResourceRef, Transport } from './types.ts';
+import type { Context } from './core.ts';
+export interface ResourceService {
+    register(auth: Auth, resource: Resource): Promise<Resource>;
+    list(auth: Auth, options?: PageOptions): Promise<Page<Resource>>;
+    describe(auth: Auth, ref: ResourceRef): Promise<Resource>;
+    operate(auth: Auth, ref: ResourceRef, request: OperationRequest, signal?: AbortSignal): Promise<OperationResult>;
+    operation(auth: Auth, ref: ResourceRef, id: string): Promise<OperationRecord>;
+    operations(auth: Auth, ref: ResourceRef, options?: PageOptions): Promise<Page<OperationRecord>>;
+    receive(auth: Auth, ref: ResourceRef, input: {
+        source_id: string;
+        data: Json;
+        expires_at?: string;
+    }): Promise<ResourceEvent>;
+    log(auth: Auth, ref: ResourceRef, options?: LogQuery): Promise<Page<ResourceEvent>>;
+    event(auth: Auth, ref: ResourceRef, id: string): Promise<ResourceEvent>;
+    ack(auth: Auth, ref: ResourceRef, id: string, mutation: Mutation): Promise<AckReceipt>;
+    /** Target side of a handover: record and answer the probe an endpoint sent (RFC 0006 §4.3). */
+    probe(auth: Auth, probe: HandoverProbe): Promise<ProbeAnswer>;
+    /** The answer this node already recorded for a probe, read back by the initiator after a crash. */
+    probeAnswer(auth: Auth, operationId: string): Promise<ProbeAnswer>;
+    recover(): Promise<void>;
+}
+export declare function createResourceService(ctx: Context, transport: Transport): ResourceService;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAAE,IAAI,EAAW,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EACrG,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAkB,aAAa,EAAE,WAAW,EACrG,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5D,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACjH,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9E,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IAChG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7H,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACxE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACvF,+FAA+F;IAC/F,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9D,mGAAmG;IACnG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AA6GD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,eAAe,CA+mBzF"}