@mdbase-dev/sdk 0.1.0-beta.165 → 0.1.0-beta.167

package/dist/browser/mdbase-sdk.js

@@ -997,6 +997,7 @@ var MdbaseSDK = (() => {
     recordState: () => recordState,
     recordView: () => recordView,
     recovery: () => recovery,
+    resolveLinksResult: () => resolveLinksResult,
     resourceView: () => resourceView,
     resyncing: () => resyncing,
     role: () => role,
@@ -1017,7 +1018,7 @@ var MdbaseSDK = (() => {
   function bad(ty) {
     throw new SchemaError(ty, "wrong type");
   }
-  var version, RECOVERY, recovery, severity, issue, problem, clientFrame, helloParams, ROLES, role, grantInfo, INCIDENT_KINDS, incident, progress, resyncing, confirmedHead, appliedPrefixParams, appliedPrefix, syncStatus, helloResult, blobRef, textOrBlob, HOLD_REASONS, holdReason, holdRef, hold, HOLD_RESOLUTIONS, holdResolution, recordState, linkResolution, linkView, authorRef, fmMap, recordView, include, viewRef, queryGroup, queryMetadata, queryResult, queryUpdate, change, changesResult, MEDIA_CLASSES, mediaClass, conflictMode, baseField, bodyEdit, docVersion, fileInclusion, listsByField, op, validationLevel, submitParams, CONFLICT_FORMS, conflictValue, conflict, publishState, preflight, receipt, submitResult, conflictEntry, fileContentProfile, knownFileView, fileView, listFilesResult, openUploadParams, openUploadResult, uploadChunkParams, fileChunk, fileStreamFailure, TRANSFER_PHASES, transferProgress, materialization, peer, presencePush, fenceApply, fenceReport, fenceResult, PUSH_CODECS, opClock, mutation, confirmation, resourceView, listResourcesResult, backlinksResult, listViewsResult, viewSourceDocument, newTypeFile, describeResult, pendingOp, listPendingResult, target, queryParams, executeViewParams, TEMPORAL_HINTS, temporalHint, typingEntry, describeTypingResult, DESCRIBE_TYPING_MAX_TYPES, DESCRIBE_TYPING_MAX_PATHS;
+  var version, RECOVERY, recovery, severity, issue, problem, clientFrame, helloParams, ROLES, role, grantInfo, INCIDENT_KINDS, incident, progress, resyncing, confirmedHead, appliedPrefixParams, appliedPrefix, syncStatus, helloResult, blobRef, textOrBlob, HOLD_REASONS, holdReason, holdRef, hold, HOLD_RESOLUTIONS, holdResolution, recordState, linkResolution, linkView, authorRef, fmMap, recordView, include, viewRef, queryGroup, queryMetadata, queryResult, queryUpdate, change, changesResult, MEDIA_CLASSES, mediaClass, conflictMode, baseField, bodyEdit, docVersion, fileInclusion, listsByField, op, validationLevel, submitParams, CONFLICT_FORMS, conflictValue, conflict, publishState, preflight, receipt, submitResult, conflictEntry, fileContentProfile, knownFileView, fileView, listFilesResult, openUploadParams, openUploadResult, uploadChunkParams, fileChunk, fileStreamFailure, TRANSFER_PHASES, transferProgress, materialization, peer, presencePush, fenceApply, fenceReport, fenceResult, PUSH_CODECS, opClock, mutation, confirmation, resourceView, listResourcesResult, backlinksResult, resolveLinksResult, listViewsResult, viewSourceDocument, newTypeFile, describeResult, pendingOp, listPendingResult, target, queryParams, executeViewParams, TEMPORAL_HINTS, temporalHint, typingEntry, describeTypingResult, DESCRIBE_TYPING_MAX_TYPES, DESCRIBE_TYPING_MAX_PATHS;
   var init_wire = __esm({
     "src/wire.ts"() {
       "use strict";
@@ -1230,7 +1231,8 @@ var MdbaseSDK = (() => {
       linkResolution = struct("link-resolution", [
         [0, "kind", enumOf("link-kind", ["record", "file", "ambiguous", "not_found", "invalid"])],
         [1, "target", uuid, "opt"],
-        [2, "path", tstr, "opt"]
+        [2, "path", tstr, "opt"],
+        [3, "candidates", list(tstr, { nonEmpty: true }), "opt"]
       ]);
       linkView = struct("link-view", [
         [0, "raw", tstr],
@@ -1787,6 +1789,11 @@ var MdbaseSDK = (() => {
         [2, "complete", bool],
         [3, "asOf", uint]
       ]);
+      resolveLinksResult = struct("resolve-links-result", [
+        [0, "resolutions", list(linkResolution)],
+        [1, "asOf", uint],
+        [2, "complete", bool]
+      ]);
       listViewsResult = struct(
         "list-views-result",
         [
@@ -6080,7 +6087,7 @@ var MdbaseSDK = (() => {
   function connect(opts) {
     return MdbaseClient.connect(opts);
   }
-  var Write, LiveQuery, READ_METHODS, MdbaseClient;
+  var VALIDATE_PAGE, Write, LiveQuery, READ_METHODS, MdbaseClient;
   var init_client = __esm({
     "src/client.ts"() {
       "use strict";
@@ -6108,6 +6115,7 @@ var MdbaseSDK = (() => {
       init_wire();
       init_write_ledger();
       init_wire();
+      VALIDATE_PAGE = "validate-page-v1";
       Write = class {
         constructor(receipt4) {
           this.receipt = receipt4;
@@ -6468,7 +6476,7 @@ var MdbaseSDK = (() => {
             versions: API_VERSIONS,
             clientName: opts.app.name,
             clientVersion: opts.app.version,
-            features: [.../* @__PURE__ */ new Set([...opts.features ?? [], "declared-collection-setup-v1", "file-stream-failure-v1"])],
+            features: [.../* @__PURE__ */ new Set([...opts.features ?? [], "declared-collection-setup-v1", "file-stream-failure-v1", VALIDATE_PAGE])],
             ...tz ? { timezone: tz } : {}
           };
         }
@@ -7019,7 +7027,17 @@ var MdbaseSDK = (() => {
             throw mdbaseError("unavailable", "invalid contract query record binding", "contract_query_response");
           return result2;
         }
-        /** Records whose links resolve to `target` (index-backed, §4.2). */
+        /**
+         * One page of the records whose links resolve to `target`, from the
+         * replica's link index with Core resolution over the local view (pending
+         * changes included; the target's links to itself excluded). Referrers come
+         * in path order, each with its links to the target. Pass the returned
+         * `cursor` for the next page (`limit` 1–1000, default 128); a page may hold
+         * fewer than `limit`, and only an absent cursor ends the list. Any local
+         * change between pages refuses the continuation with `cursor_stale`: start
+         * again from the first page. A replica without the method refuses with
+         * `upgrade_required` / `backlinks_unsupported` (§4.2).
+         */
         backlinks(target2, o = {}) {
           return this.call(
             "backlinks",
@@ -7030,7 +7048,39 @@ var MdbaseSDK = (() => {
               [3, o.cursor]
             ]),
             { codec: backlinksResult, retry: true, ...o.signal ? { signal: o.signal } : {} }
-          );
+          ).catch((e) => {
+            if (isMdbaseError(e, "invalid_request") && e.reason === "unknown_method") {
+              throw mdbaseError("upgrade_required", "This collection's replica can't list backlinks yet.", "backlinks_unsupported");
+            }
+            throw e;
+          });
+        }
+        /**
+         * Resolve link occurrences written in the note at `from`, exactly as the
+         * replica resolves them for backlinks and rename: Core parsing and spec 08
+         * resolution over the local view, pending changes included. `from` need not
+         * exist yet (an unsaved draft). Each entry is one occurrence as written —
+         * `[[target]]`, `![[target#anchor|alias]]`, `[text](path)`, `![alt](path)` —
+         * and the result holds one resolution per entry, in order: a record or file
+         * with its ID and path, `ambiguous` with sorted candidate paths, or
+         * `not_found` / `invalid`. Titles and aliases are not link keys. 1–512
+         * entries of at most 4096 bytes each. A replica without the method refuses
+         * with `upgrade_required` / `resolve_links_unsupported` (§4.3).
+         */
+        resolveLinks(from, links, o = {}) {
+          return this.call(
+            "resolve_links",
+            params([
+              [0, from],
+              [1, [...links]]
+            ]),
+            { codec: resolveLinksResult, retry: true, ...o.signal ? { signal: o.signal } : {} }
+          ).catch((e) => {
+            if (isMdbaseError(e, "invalid_request") && e.reason === "unknown_method") {
+              throw mdbaseError("upgrade_required", "This collection's replica can't resolve links yet.", "resolve_links_unsupported");
+            }
+            throw e;
+          });
         }
         /** Definitions: `mdbase.yaml`, type files, contract files (§4.1). */
         resources = {
@@ -7392,16 +7442,32 @@ var MdbaseSDK = (() => {
           Object.defineProperties(watch, { state: { get: () => state2 }, error: { get: () => error4 } });
           return Object.freeze(watch);
         }
+        /** Validate these records, or every record. Every record is validated a
+         * page at a time when the replica grants `validate-page-v1`; each page is an
+         * independent READ, so records changed meanwhile may be missed or repeated.
+         * Older replicas validate every record in one bounded request. */
         async validate(refs, signal) {
           signal?.throwIfAborted();
           const { targets: targets2, expected } = captureValidation(refs);
-          const result2 = await this.call("validate", params([[0, targets2]]), {
+          const call2 = (p) => this.call("validate", p, {
             codec: recordValidations,
             retry: true,
             ...signal ? { signal } : {}
           });
-          signal?.throwIfAborted();
-          return bindValidation(result2, expected);
+          if (targets2 !== void 0 || !this.hello.features.includes(VALIDATE_PAGE)) {
+            const result2 = await call2(params([[0, targets2]]));
+            signal?.throwIfAborted();
+            return bindValidation(result2, expected);
+          }
+          const out = [];
+          for (let after; ; ) {
+            const page = await call2(params([[1, new Map(after === void 0 ? [] : [[0, uuid.enc(after)]])]]));
+            signal?.throwIfAborted();
+            const last = page[page.length - 1];
+            if (last === void 0) return out;
+            out.push(...page);
+            after = last.id;
+          }
         }
         /** Independent native app-host Bases READ, exact original held session.
          * Unsupported transports refuse: no generic execute_view/data fallback. */
@@ -12072,6 +12138,8 @@ var MdbaseSDK = (() => {
         describe_definitions_unsupported: "update_required",
         contract_records_unsupported: "update_required",
         record_links_unsupported: "update_required",
+        backlinks_unsupported: "update_required",
+        resolve_links_unsupported: "update_required",
         change_entity_unsupported: "update_required",
         timer_operation_recovery_unavailable: "update_required",
         contract_query_version: "update_required",
@@ -37210,6 +37278,9 @@ ${end.comment}` : end.comment;
       s.confirmedHead
     ]);
   }
+  function localCommitSignal(status) {
+    return status.mode === "local_only";
+  }
   function catalogFingerprint(catalog) {
     return JSON.stringify(catalog, (_key, value2) => typeof value2 === "bigint" ? `${value2}n` : value2 instanceof Map ? [...value2.entries()] : value2 instanceof Uint8Array ? [...value2] : value2);
   }
@@ -37432,9 +37503,9 @@ ${end.comment}` : end.comment;
           this.stops.push(
             this.watch.subscribe(this.invalidate),
             this.client.onLink(this.invalidate),
-            this.client.onStatus(() => {
+            this.client.onStatus((status) => {
               const next = statusStamp(this.client);
-              if (next !== this.lastStatus) {
+              if (next !== this.lastStatus || localCommitSignal(status)) {
                 this.lastStatus = next;
                 this.invalidate();
               }
@@ -37872,6 +37943,7 @@ ${end.comment}` : end.comment;
               if (!this.current()) break;
               if (source) await source.refresh();
             }
+            await this.reassessAfterSetup();
             return this.getSnapshot();
           }).finally(() => {
             if (this.pending !== pending) return;
@@ -37896,6 +37968,24 @@ ${end.comment}` : end.comment;
             return value2;
           });
         }
+        /** The native witness is taken before configuration, which may then apply
+         * setup (automatically for a new or unsynced collection). Its change notice
+         * can arrive after this refresh settles, so a settled native setup_required
+         * beside a configuration that settled ready is assessed once more here.
+         * One extra READ at most: a genuine disagreement stays setup_required. */
+        async reassessAfterSetup() {
+          if (!this.native || !this.current()) return;
+          const native = this.native.getSnapshot();
+          let configured = null;
+          try {
+            configured = this.sources.configuration?.getSnapshot() ?? null;
+          } catch {
+          }
+          if (native.checking || native.assessment?.status !== "setup_required" || configured?.checking || configured?.assessment?.status !== "ready") return;
+          await this.native.start().catch((error4) => {
+            if (!(isMdbaseError(error4) && error4.reason === "readiness_busy")) throw error4;
+          });
+        }
         close() {
           if (this.closing) return this.closing;
           this.closed = true;
@@ -38158,7 +38248,10 @@ ${end.comment}` : end.comment;
       check(signal, session);
       if (!stops.length) {
         lastStamp = stamp();
-        stops.push(input.client.onStatus(invalidate), input.client.onLink(invalidate));
+        stops.push(input.client.onStatus((status) => {
+          if (localCommitSignal(status)) lastStamp = null;
+          invalidate();
+        }), input.client.onLink(invalidate));
       }
       dirty = false;
       const { journaled, previous } = await recover(signal, session);
@@ -41091,12 +41184,12 @@ ${end.comment}` : end.comment;
   // src/application/asset-pins.json
   var asset_pins_default = {
     runtime: {
-      sha256: "4d377128dd7e76241cbbf63d00dd3f232286d8a506908fa240d20c6ac85c69a8",
-      bytes: 3811508,
-      maxBytes: 3811508,
+      sha256: "e70b55216318f5d12bde51ef75120c8f8fd285816e596817e766d484085aa073",
+      bytes: 3838960,
+      maxBytes: 3838960,
       source: {
         repository: "mdbase-dev/mdbase-connect",
-        commit: "419d7ddfaade89b3795836674685f99738db9427"
+        commit: "d9abf0ee991f4b7d3b558eb3def05b8285d5afc1"
       }
     },
     sqlite: {