@domino-sdk/relay 1.0.0-next.10 → 1.0.0-next.13

package/dist/{chunk-P6FK43GG.js → chunk-WQ24ILGO.js}

@@ -1,11 +1,11 @@
 import {
   createRelayClient
-} from "./chunk-X2F2RAR3.js";
+} from "./chunk-EZWNGI5B.js";
 import {
   RelayErrorCode,
   clientError,
   cosmosChain
-} from "./chunk-PHU5VDLR.js";
+} from "./chunk-OA2KMQVZ.js";
 
 // src/base58.ts
 var alphabet = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
@@ -492,59 +492,158 @@ function createBrowserRelayClient(options) {
     submissionStore: options.submissionStore ?? browserSubmissionStore()
   });
 }
+var DATABASE = "domino-relay-submissions";
+var STORE = "submissions";
+var BLOCKED_GRACE_MS = 1e3;
+function errorName(error) {
+  return typeof error === "object" && error !== null && "name" in error ? String(error.name) : void 0;
+}
+function storageError(error, action) {
+  const name = errorName(error);
+  if (name === "QuotaExceededError") {
+    return clientError(
+      "Browser storage is full, so submission progress could not be saved. Free some space, then resume the saved submission.",
+      RelayErrorCode.SubmissionStorageQuota,
+      { cause: error }
+    );
+  }
+  if (name === "VersionError") {
+    return clientError(
+      "Another tab upgraded submission storage. Reload this page to continue.",
+      RelayErrorCode.SubmissionStorage,
+      { cause: error }
+    );
+  }
+  return clientError(
+    action === "open" ? "Could not open submission storage. Try again, and check that this browser allows site storage (private browsing can turn it off)." : action === "read" ? "Could not read the saved submission. Do not start another claim; try again when browser storage is available." : "Could not save submission progress. Resume the saved submission when browser storage is available.",
+    RelayErrorCode.SubmissionStorage,
+    { cause: error }
+  );
+}
 function browserSubmissionStore() {
-  let database;
-  function open() {
+  let opening;
+  function release(db) {
+    db.close();
+    if (opening?.db === db) {
+      opening = void 0;
+    }
+  }
+  function start() {
+    let unblock;
+    const current = {
+      blocked: new Promise((resolve) => unblock = resolve),
+      done: new Promise((resolve, reject) => {
+        let request;
+        try {
+          request = indexedDB.open(DATABASE, 1);
+        } catch (error) {
+          reject(storageError(error, "open"));
+          return;
+        }
+        request.onupgradeneeded = () => {
+          if (!request.result.objectStoreNames.contains(STORE)) {
+            request.result.createObjectStore(STORE);
+          }
+        };
+        request.onblocked = unblock;
+        request.onerror = () => reject(storageError(request.error, "open"));
+        request.onsuccess = () => {
+          const db = request.result;
+          db.onversionchange = () => release(db);
+          db.onclose = () => release(db);
+          current.db = db;
+          resolve(db);
+        };
+      })
+    };
+    current.done.catch(() => {
+      if (opening === current) {
+        opening = void 0;
+      }
+    });
+    return current;
+  }
+  async function connect() {
     if (!globalThis.indexedDB || !globalThis.navigator?.locks) {
       throw clientError(
         "This browser cannot safely save submissions. Use a browser with IndexedDB and Web Locks enabled.",
         RelayErrorCode.SubmissionStorage
       );
     }
-    return database ??= new Promise((resolve, reject) => {
-      const request = indexedDB.open("domino-relay-submissions", 1);
-      request.onupgradeneeded = () => request.result.createObjectStore("submissions");
-      request.onerror = () => reject(
-        clientError(
-          "Could not open submission storage",
-          RelayErrorCode.SubmissionStorage
-        )
-      );
-      request.onsuccess = () => resolve(request.result);
-      request.onblocked = () => reject(
-        clientError(
-          "Close other Relay tabs and try again",
-          RelayErrorCode.SubmissionStorage
+    if (opening?.db) {
+      return opening.db;
+    }
+    const attempt = opening ??= start();
+    let timer;
+    try {
+      return await Promise.race([
+        attempt.done,
+        attempt.blocked.then(
+          () => new Promise((_, reject) => {
+            timer = setTimeout(
+              () => reject(
+                clientError(
+                  "Submission storage is blocked by another Relay tab. Close or reload other Relay tabs, then try again.",
+                  RelayErrorCode.SubmissionStorage
+                )
+              ),
+              BLOCKED_GRACE_MS
+            );
+          })
         )
-      );
-    });
+      ]);
+    } finally {
+      clearTimeout(timer);
+    }
   }
-  async function transact(key, value) {
-    const db = await open();
-    return new Promise((resolve, reject) => {
-      const transaction = db.transaction(
-        "submissions",
-        value === void 0 ? "readonly" : "readwrite",
-        { durability: "strict" }
-      );
-      const store = transaction.objectStore("submissions");
-      const request = value === void 0 ? store.get(key) : store.put(value, key);
-      transaction.oncomplete = () => resolve(request.result);
-      transaction.onerror = transaction.onabort = () => reject(
-        clientError(
-          "Could not save submission progress. Resume the saved submission when browser storage is available.",
-          RelayErrorCode.SubmissionStorage
-        )
-      );
-    });
+  async function transact(key, action, value) {
+    for (let retry = true; ; retry = false) {
+      const db = await connect();
+      let transaction;
+      try {
+        transaction = db.transaction(
+          STORE,
+          action === "read" ? "readonly" : "readwrite",
+          { durability: "strict" }
+        );
+      } catch (error) {
+        release(db);
+        if (retry && errorName(error) === "InvalidStateError") {
+          continue;
+        }
+        throw storageError(error, action);
+      }
+      return new Promise((resolve, reject) => {
+        let request;
+        function fail(error) {
+          if (errorName(error) !== "QuotaExceededError") {
+            release(db);
+          }
+          reject(storageError(error, action));
+        }
+        try {
+          const objects = transaction.objectStore(STORE);
+          request = action === "read" ? objects.get(key) : objects.put(value, key);
+        } catch (error) {
+          try {
+            transaction.abort();
+          } catch {
+          }
+          fail(error);
+          return;
+        }
+        transaction.oncomplete = () => resolve(request.result);
+        transaction.onabort = () => fail(transaction.error ?? request.error);
+      });
+    }
   }
   return {
-    read: (key) => transact(key),
+    read: (key) => transact(key, "read"),
     write: async (key, value) => {
-      await transact(key, value);
+      await transact(key, "write", value);
     },
     exclusive: async (key, task) => {
-      await open();
+      await connect();
       return navigator.locks.request(key, task);
     }
   };

package/dist/{client-CT4-S5vc.d.ts → client-Bf9PNUIi.d.ts}

@@ -1,60 +1,12 @@
-import { V as ValueEvidence, i as referralAcceptSchema, d as LeaderboardQuery, a as AuthProvider, j as engagementPageQuerySchema, k as contentQualificationQuerySchema, m as contentAdmissionQuerySchema, n as contentEnrollmentInputSchema, o as contentReleaseInputSchema } from './submission-input-0OOGaq8c.js';
-import { b as QuizEvidence, A as Attempt, M as MemberProgress, s as submitSchema, g as contentPerformanceQuerySchema } from './schema-Di3aLSiK.js';
-import { c as ParticipantSession, e as QuestView, a as PageQuery, q as questExperienceSchema, f as exchangeSchema } from './pages-D3titw5B.js';
+import { h as QuestView, J as questExperienceSchema, e as PointHistoryQuery, c as PointEntryKind } from './catalog-C85V1NgW.js';
+import { V as ValueEvidence, a as AuthProvider } from './submission-input-CccwAl5Z.js';
+import { R as RequestError, a as RequestErrorDetails, b as RequestErrorKind } from './request-error-VnTiMXc3.js';
+import { b as QuizEvidence, A as Attempt, M as MemberProgress, ao as submitSchema, x as contentPerformanceQuerySchema } from './schema-BF_TQsmT.js';
 import { z } from 'zod';
-import { p as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-DDMFBRKe.js';
-import { w as walletAddressInputSchema, l as walletSignatureSchema, L as LinkedWallet, f as WalletSigner } from './wallet-BGOfFkG9.js';
-
-/**
- * The request-error core every Domino client error extends: the participant `RelayError` and the
- * management client's error share these fields, so one handler serves both.
- *
- * `kind` says what happened:
- *
- * - `http`: the server answered with an error status.
- * - `network`: the transport failed, including a response body cut off after its headers.
- * - `timeout`: the client's deadline passed.
- * - `aborted`: the caller cancelled the request.
- * - `invalid-response`: a 2xx answer that is not JSON, or not the shape this SDK version expects.
- * - `client`: the client refused the call without sending it, such as for invalid input.
- */
-type RequestErrorKind = "http" | "network" | "timeout" | "aborted" | "invalid-response" | "client";
-/**
- * What to do when `uncertain` is true. `replay`: sending the call again with the same
- * `operationId` is safe, because the server applies it at most once. `reconcile`: read the state
- * first, since repeating the call could apply it twice.
- */
-type RequestRecovery = "replay" | "reconcile";
-type RequestErrorDetails = {
-    kind: RequestErrorKind;
-    /** True only when a write may have been applied. Reads are never uncertain. */
-    uncertain?: boolean;
-    /** The HTTP status, whenever response headers arrived. Never invented. */
-    status?: number;
-    /** A machine-readable code: open, so a newer server's codes are kept. */
-    code?: string;
-    /** The call's idempotency or action ID, to replay it with. */
-    operationId?: string;
-    cause?: unknown;
-};
-declare const requestErrorBrand: unique symbol;
-/**
- * Whether `value` is a `RequestError` from any copy of the SDK. Prefer it to `instanceof`, which
- * fails when an app bundles two copies of the package.
- */
-declare function isRequestError(value: unknown): value is RequestError;
-declare class RequestError extends Error {
-    readonly name: string;
-    readonly [requestErrorBrand] = true;
-    readonly kind: RequestErrorKind;
-    readonly uncertain: boolean;
-    readonly status: number | undefined;
-    readonly code: string | undefined;
-    readonly operationId: string | undefined;
-    /** `replay` when there is an `operationId`, else `reconcile`; only when `uncertain`. */
-    readonly recovery: RequestRecovery | undefined;
-    constructor(message: string, details: RequestErrorDetails);
-}
+import { c as ParticipantSession, a as PageQuery, f as exchangeSchema } from './pages-KYK1L60W.js';
+import { a6 as referralAcceptSchema, c as LeaderboardQuery, G as engagementPageQuerySchema, s as contentQualificationQuerySchema, i as contentAdmissionQuerySchema, k as contentEnrollmentInputSchema, u as contentReleaseInputSchema } from './referrals-KQfP4pBf.js';
+import { F as profileUpdateSchema, c as ProfileCompletionQuery } from './profiles-BtOXMGcC.js';
+import { x as walletAddressInputSchema, M as walletSignatureSchema, L as LinkedWallet, f as WalletSigner } from './wallet-BtiG0Xhr.js';
 
 /** What happened, as in every Domino client error (see `RequestError`). */
 type RelayErrorKind = RequestErrorKind;
@@ -82,8 +34,13 @@ declare const RelayErrorCode: {
     readonly NotFound: "not-found";
     /** The quest has no failed attempt the member can retry. */
     readonly RetryUnavailable: "retry-unavailable";
-    /** Durable submission storage is missing, blocked or unreadable. */
+    /**
+     * Durable submission storage is missing, blocked or unreadable. Nothing was lost: call the
+     * handle's `status()` or `resume()` again once storage is available.
+     */
     readonly SubmissionStorage: "submission-storage";
+    /** Browser storage is full, so submission progress was not saved. Free space, then resume. */
+    readonly SubmissionStorageQuota: "submission-storage-quota";
     /** The saved submission is in a state that does not allow this action. */
     readonly SubmissionConflict: "submission-conflict";
     /** The quest changed since the member saw it; review it before submitting again. */
@@ -94,6 +51,10 @@ declare const RelayErrorCode: {
     readonly InvalidSubmission: "invalid-submission";
     /** A page cursor Relay cannot read; start again from the first page. */
     readonly InvalidCursor: "invalid-cursor";
+    /** No point ledger in the project has the key or ID the call named. */
+    readonly PointLedgerNotFound: "point-ledger-not-found";
+    /** The member has not joined this project, so it holds no points here. */
+    readonly NotJoined: "not-joined";
     /** A wallet signer failed or the member refused to sign; `cause` is the wallet's own error. */
     readonly WalletSigner: "wallet-signer";
 };
@@ -517,7 +478,6 @@ declare function createRelayClient(options: RelayClientOptions): {
                 } | {
                     kind: "calendar";
                     period: "day" | "week" | "month";
-                    timeZone: string;
                 };
                 kind: "earned";
                 quests?: string[] | undefined;
@@ -535,7 +495,6 @@ declare function createRelayClient(options: RelayClientOptions): {
                 } | {
                     kind: "calendar";
                     period: "day" | "week" | "month";
-                    timeZone: string;
                 };
             };
             access: "participants" | "public";
@@ -933,7 +892,6 @@ declare function createRelayClient(options: RelayClientOptions): {
             completion: {
                 kind: "streak";
                 days: number;
-                timeZone: string;
             } | {
                 kind: "once";
             } | {
@@ -1249,7 +1207,6 @@ declare function createRelayClient(options: RelayClientOptions): {
                 completion: {
                     kind: "streak";
                     days: number;
-                    timeZone: string;
                 } | {
                     kind: "once";
                 } | {
@@ -1511,7 +1468,6 @@ declare function createRelayClient(options: RelayClientOptions): {
                     completion: {
                         kind: "streak";
                         days: number;
-                        timeZone: string;
                     } | {
                         kind: "once";
                     } | {
@@ -1776,7 +1732,6 @@ declare function createRelayClient(options: RelayClientOptions): {
                 completion: {
                     kind: "streak";
                     days: number;
-                    timeZone: string;
                 } | {
                     kind: "once";
                 } | {
@@ -2276,7 +2231,6 @@ declare function createRelayClient(options: RelayClientOptions): {
                 completion: {
                     kind: "streak";
                     days: number;
-                    timeZone: string;
                 } | {
                     kind: "once";
                 } | {
@@ -2470,6 +2424,33 @@ declare function createRelayClient(options: RelayClientOptions): {
                 deliveredAt: number | null;
             }[];
         }>;
+        /**
+         * `{ items }`: the member's balance in each of the project's point ledgers, in the project's
+         * ledger order, zero in a ledger they have no entries in.
+         */
+        balances: (requestOptions?: RelayRequestOptions) => Promise<{
+            items: {
+                ledger: {
+                    id: string;
+                    key: string | null;
+                    name: string;
+                };
+                balance: number;
+                available: number;
+            }[];
+        }>;
+        /** The member's own entries in one ledger, by key or ID, most recently recorded first. */
+        pointHistory: (query: PointHistoryQuery, requestOptions?: RelayRequestOptions) => Promise<{
+            items: {
+                id: string;
+                amount: number;
+                kind: PointEntryKind;
+                at: number;
+                quest: string | null;
+                reverses: string | null;
+            }[];
+            nextCursor: string | null;
+        }>;
         /** Claims a quest for the signed-in member. Quest controllers (`quests.open`) call this. */
         claim: (value: Omit<z.input<typeof submitSchema>, "member">, requestOptions?: RelayRequestOptions) => Promise<{
             id: string;
@@ -2548,11 +2529,11 @@ declare function createRelayClient(options: RelayClientOptions): {
                     metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
                     baseline: "historical";
                     maxAgeMs: number;
-                    budget: {
-                        projectDaily?: number | undefined;
-                        memberDaily?: number | undefined;
-                        projectLifetime?: number | undefined;
-                    };
+                    budgets: {
+                        scope: "member" | "project";
+                        period: "lifetime" | "day" | "week" | "month";
+                        limit: number;
+                    }[];
                 };
                 publishedAt: number;
             };
@@ -2594,11 +2575,11 @@ declare function createRelayClient(options: RelayClientOptions): {
                     metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
                     baseline: "historical";
                     maxAgeMs: number;
-                    budget: {
-                        projectDaily?: number | undefined;
-                        memberDaily?: number | undefined;
-                        projectLifetime?: number | undefined;
-                    };
+                    budgets: {
+                        scope: "member" | "project";
+                        period: "lifetime" | "day" | "week" | "month";
+                        limit: number;
+                    }[];
                 };
                 publishedAt: number;
             } | null;
@@ -2611,11 +2592,11 @@ declare function createRelayClient(options: RelayClientOptions): {
                     metrics: ("likes" | "replies" | "reposts" | "quotes" | "views" | "bookmarks")[];
                     baseline: "historical";
                     maxAgeMs: number;
-                    budget: {
-                        projectDaily?: number | undefined;
-                        memberDaily?: number | undefined;
-                        projectLifetime?: number | undefined;
-                    };
+                    budgets: {
+                        scope: "member" | "project";
+                        period: "lifetime" | "day" | "week" | "month";
+                        limit: number;
+                    }[];
                 };
                 publishedAt: number;
             };
@@ -2713,4 +2694,4 @@ declare function createRelayClient(options: RelayClientOptions): {
 /** The participant client `createRelayClient` returns. */
 type RelayClient = ReturnType<typeof createRelayClient>;
 
-export { type ClaimSubmission as C, type KnownRelayErrorCode as K, type PhotoSubmission as P, type QuestActionResult as Q, type RelayClient as R, type SubmissionDraft as S, type ValueSubmission as V, type ProgressObservation as a, type ProgressObserver as b, type QuestController as c, QuestUpdatedError as d, type QuizSubmission as e, type RelayClientOptions as f, RelayError as g, RelayErrorCode as h, type RelayErrorDetails as i, type RelayErrorKind as j, type RelayRequestOptions as k, RequestError as l, type RequestErrorDetails as m, type RequestErrorKind as n, type RequestRecovery as o, type SubmissionStatus as p, type SubmissionStore as q, createRelayClient as r, isRelayError as s, isRequestError as t };
+export { type ClaimSubmission as C, type KnownRelayErrorCode as K, type PhotoSubmission as P, type QuestActionResult as Q, type RelayClient as R, type SubmissionDraft as S, type ValueSubmission as V, type ProgressObservation as a, type ProgressObserver as b, type QuestController as c, QuestUpdatedError as d, type QuizSubmission as e, type RelayClientOptions as f, RelayError as g, RelayErrorCode as h, type RelayErrorDetails as i, type RelayErrorKind as j, type RelayRequestOptions as k, type SubmissionStatus as l, type SubmissionStore as m, createRelayClient as n, isRelayError as o };