@domino-sdk/relay 1.1.0 → 1.1.1

package/dist/{browser-J7tUpXxy.d.ts → browser-Cf1opQjX.d.ts}

@@ -1,6 +1,6 @@
 import { b as QuestEnrollmentInput, Q as QuestClaimInput, f as QuestOutcomeQuery, i as QuestView, P as questExperienceSchema, n as RewardDeliveryAction, A as contentQualificationQuerySchema } from './outcomes-kVB-Juzs.js';
 import { aG as referralAcceptSchema, g as LeaderboardQuery, b as CampaignEnrollmentInput, d as CampaignWithdrawalInput, m as PointHistoryQuery, k as PointEntryKind, V as engagementPageQuerySchema } from './groups-Ck-OxzjD.js';
-import { n as createRelayClient, g as RelayError, m as SubmissionStore, k as RelayRequestOptions, c as QuestController, a as ProgressObservation, b as ProgressObserver, P as PhotoSubmission, e as QuizSubmission, C as ClaimSubmission, V as ValueSubmission } from './client-XiuFnug_.js';
+import { n as createRelayClient, g as RelayError, m as SubmissionStore, k as RelayRequestOptions, c as QuestController, a as ProgressObservation, b as ProgressObserver, P as PhotoSubmission, e as QuizSubmission, C as ClaimSubmission, V as ValueSubmission } from './client-gqnRUHpC.js';
 import { a as PageQuery, g as exchangeSchema, R as RelayEvent, b as ParticipantActivity } from './pages-BBYD21IE.js';
 import { a as AuthProvider } from './submission-input-BZkm6ohU.js';
 import { C as CosmosChain, a as CosmosNetwork, f as WalletSigner, d as WalletSignInNetwork, y as walletAddressInputSchema, I as walletSignatureSchema, L as LinkedWallet } from './wallet-YssWxGg8.js';

package/dist/browser.d.ts

@@ -1,11 +1,11 @@
 import './outcomes-kVB-Juzs.js';
 import './groups-Ck-OxzjD.js';
-import './client-XiuFnug_.js';
+import './client-gqnRUHpC.js';
 import './pages-BBYD21IE.js';
 import './submission-input-BZkm6ohU.js';
 import './wallet-YssWxGg8.js';
 import './schema-DfJzH2ci.js';
 import './profiles-D2aFcOxu.js';
-export { C as CosmosChains, D as DiscoveredWallet, f as Eip1193Provider, E as EmailSignInOption, K as KeplrLike, O as OAuthSignInOption, g as SignInClient, e as SignInIcon, S as SignInMethods, a as SignInOption, h as SignInOptions, b as SignInUnavailable, d as SignInWallet, i as SolanaInjectedProvider, j as StandardWallet, k as StandardWalletAccount, W as WalletSignInOption, l as browserSubmissionStore, m as cosmosChainList, n as cosmosSigner, c as createBrowserRelayClient, o as discoverCosmosWallets, p as discoverEvmWallets, q as discoverSignInWallets, r as discoverSolanaWallets, s as evmSigner, t as signInOptions, u as solanaSigner, w as walletStandardSolanaSigner } from './browser-J7tUpXxy.js';
+export { C as CosmosChains, D as DiscoveredWallet, f as Eip1193Provider, E as EmailSignInOption, K as KeplrLike, O as OAuthSignInOption, g as SignInClient, e as SignInIcon, S as SignInMethods, a as SignInOption, h as SignInOptions, b as SignInUnavailable, d as SignInWallet, i as SolanaInjectedProvider, j as StandardWallet, k as StandardWalletAccount, W as WalletSignInOption, l as browserSubmissionStore, m as cosmosChainList, n as cosmosSigner, c as createBrowserRelayClient, o as discoverCosmosWallets, p as discoverEvmWallets, q as discoverSignInWallets, r as discoverSolanaWallets, s as evmSigner, t as signInOptions, u as solanaSigner, w as walletStandardSolanaSigner } from './browser-Cf1opQjX.js';
 import 'zod';
 import './request-error-DWduJCGV.js';

package/dist/browser.js

@@ -11,8 +11,8 @@ import {
   signInOptions,
   solanaSigner,
   walletStandardSolanaSigner
-} from "./chunk-ZVIRG24J.js";
-import "./chunk-GZ6FJAXN.js";
+} from "./chunk-24AFCBZN.js";
+import "./chunk-DGWMLN35.js";
 import "./chunk-EYH5RDIE.js";
 import "./chunk-36HTX2BM.js";
 import "./chunk-6QJ3LADK.js";

package/dist/{chunk-ZVIRG24J.js → chunk-24AFCBZN.js}

@@ -1,6 +1,6 @@
 import {
   createRelayClient
-} from "./chunk-GZ6FJAXN.js";
+} from "./chunk-DGWMLN35.js";
 import {
   RelayErrorCode,
   asRelayError,

package/dist/{chunk-GZ6FJAXN.js → chunk-DGWMLN35.js}

@@ -22,6 +22,7 @@ import {
   engagementBoundaryPageSchema,
   engagementPageQuerySchema,
   engagementPageSchema,
+  isRelayError,
   leaderboardDefinitionSchema,
   leaderboardPageSchema,
   leaderboardPlacementSchema,
@@ -104,7 +105,7 @@ var draftSchema = z.union([
   claimInputSchema,
   z.object({ kind: z.literal("photo"), file: z.instanceof(Blob) })
 ]);
-var recordSchema = z.union([
+var activeRecordSchema = z.union([
   z.object({
     ...common,
     stage: z.literal("review"),
@@ -131,6 +132,14 @@ var recordSchema = z.union([
     attempt: identifier
   })
 ]);
+var recordSchema = z.union([
+  activeRecordSchema,
+  z.object({
+    ...common,
+    stage: z.literal("retired"),
+    previous: activeRecordSchema
+  })
+]);
 function submissions(transport, configuredStore, namespace) {
   async function open(quest, options = {
     input: "photo"
@@ -184,7 +193,7 @@ function submissions(transport, configuredStore, namespace) {
       }
       const record = parsed.data;
       const input = record.stage === "review" ? record.draft?.kind : "input" in record ? record.input.kind : "photo";
-      if (!options.recoverPrevious && input !== options.input) {
+      if (record.stage !== "retired" && !options.recoverPrevious && input !== options.input) {
         throw clientError(
           "Saved submission uses a different input type. Reopen it with its original type to recover it.",
           RelayErrorCode.SubmissionConflict
@@ -192,18 +201,40 @@ function submissions(transport, configuredStore, namespace) {
       }
       return record;
     }
-    function claim(record) {
-      return transport.claim(
-        {
-          quest,
-          actionId: record.id,
-          ...record.release ? { release: record.release } : {},
-          ..."evidence" in record ? { evidence: record.evidence } : record.input.kind !== "none" ? { input: record.input } : {}
-        },
-        sessionId
+    async function claim(record) {
+      try {
+        return await transport.claim(
+          {
+            quest,
+            actionId: record.id,
+            ...record.release ? { release: record.release } : {},
+            ..."evidence" in record ? { evidence: record.evidence } : record.input.kind !== "none" ? { input: record.input } : {}
+          },
+          sessionId
+        );
+      } catch (error) {
+        if (isRelayError(error) && error.kind === "http" && !error.uncertain && error.status === 409 && error.code === "operation-retired") {
+          await store.write(key, {
+            id: record.id,
+            quest,
+            release: record.release,
+            stage: "retired",
+            previous: record
+          });
+        }
+        throw error;
+      }
+    }
+    function retiredError() {
+      return clientError(
+        "This saved submission was retired. Review the current quest, then discard it before starting a new submission.",
+        "operation-retired"
       );
     }
     async function resumeRecord(saved) {
+      if (saved.stage === "retired") {
+        throw retiredError();
+      }
       if (saved.stage === "review") {
         throw new QuestUpdatedError(
           "This quest changed. Review it before submitting again.",
@@ -267,6 +298,9 @@ function submissions(transport, configuredStore, namespace) {
       return store.exclusive(key, async () => {
         await currentSession();
         const existing = await read();
+        if (existing?.stage === "retired") {
+          throw retiredError();
+        }
         if (existing?.stage === "review" && existing.release === record.release) {
           throw new QuestUpdatedError(
             "Review the latest quest before submitting again.",
@@ -301,6 +335,10 @@ function submissions(transport, configuredStore, namespace) {
           if (!record) {
             return;
           }
+          if (record.stage === "retired") {
+            await store.write(key, null);
+            return;
+          }
           if (record.stage !== "submitted") {
             throw clientError(
               "Resume the unfinished submission before starting over.",
@@ -323,6 +361,9 @@ function submissions(transport, configuredStore, namespace) {
         if (!record) {
           return { kind: "empty" };
         }
+        if (record.stage === "retired") {
+          return { kind: "needs-review", reason: "operation-retired" };
+        }
         if (record.stage === "review") {
           return { kind: "needs-review" };
         }

package/dist/{client-XiuFnug_.d.ts → client-gqnRUHpC.d.ts}

@@ -99,6 +99,7 @@ type SubmissionStatus = {
     kind: "empty";
 } | {
     kind: "needs-review";
+    reason?: "operation-retired";
 } | {
     kind: "pending";
     stage: "upload" | "claim";
@@ -3415,7 +3416,17 @@ declare function createRelayClient(options: RelayClientOptions): {
             (quest: string, options?: {
                 input: "photo";
                 release?: string;
-                recoverPrevious?: boolean;
+                recoverPrevious
+                /**
+                 * The session ID the app read (`auth.session()`). Relay refuses the call with a `RelayError`
+                 * whose code is `stale-session` if the member's session changed since. Calls Relay binds to a
+                 * session (wallet linking, collection passes, retries) read the current session when omitted.
+                 */
+                ? /**
+                 * The session ID the app read (`auth.session()`). Relay refuses the call with a `RelayError`
+                 * whose code is `stale-session` if the member's session changed since. Calls Relay binds to a
+                 * session (wallet linking, collection passes, retries) read the current session when omitted.
+                 */: boolean;
                 repeatable?: boolean;
             }): Promise<PhotoSubmission>;
             (quest: string, options: {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { C as ClaimSubmission, K as KnownRelayErrorCode, P as PhotoSubmission, a as ProgressObservation, b as ProgressObserver, Q as QuestActionResult, c as QuestController, d as QuestUpdatedError, e as QuizSubmission, R as RelayClient, f as RelayClientOptions, g as RelayError, h as RelayErrorCode, i as RelayErrorDetails, j as RelayErrorKind, k as RelayRequestOptions, S as SubmissionDraft, l as SubmissionStatus, m as SubmissionStore, V as ValueSubmission, n as createRelayClient, o as isRelayError } from './client-XiuFnug_.js';
+export { C as ClaimSubmission, K as KnownRelayErrorCode, P as PhotoSubmission, a as ProgressObservation, b as ProgressObserver, Q as QuestActionResult, c as QuestController, d as QuestUpdatedError, e as QuizSubmission, R as RelayClient, f as RelayClientOptions, g as RelayError, h as RelayErrorCode, i as RelayErrorDetails, j as RelayErrorKind, k as RelayRequestOptions, S as SubmissionDraft, l as SubmissionStatus, m as SubmissionStore, V as ValueSubmission, n as createRelayClient, o as isRelayError } from './client-gqnRUHpC.js';
 export { R as RequestError, a as RequestErrorDetails, b as RequestErrorKind, c as RequestRecovery, i as isRequestError } from './request-error-DWduJCGV.js';
 export { A as Attempt, a as AttemptStatus, E as Entitlement, b as EvaluatorProgress, K as KnownAttemptStatus, c as KnownTrackerSkipCode, M as MemberProgress, Q as QuestBudgetView, d as QuestPresentation, e as QuestProfile, f as QuizEvidence, R as Reward, S as SubmissionEvidence, g as SubmitInput, T as TieredRewardReference, h as TrackerSkipCode } from './schema-DfJzH2ci.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';

package/dist/index.js

@@ -5,7 +5,7 @@ import {
 import {
   QuestUpdatedError,
   createRelayClient
-} from "./chunk-GZ6FJAXN.js";
+} from "./chunk-DGWMLN35.js";
 import {
   QuestOutcomeState
 } from "./chunk-EYH5RDIE.js";

package/dist/react/index.d.ts

@@ -1,5 +1,5 @@
 import { P as Page, d as ParticipantSession, R as RelayEvent, b as ParticipantActivity, a as PageQuery, g as exchangeSchema, M as MemberSummary } from '../pages-BBYD21IE.js';
-import { g as RelayError, k as RelayRequestOptions, c as QuestController, a as ProgressObservation, b as ProgressObserver, P as PhotoSubmission, e as QuizSubmission, C as ClaimSubmission, V as ValueSubmission, S as SubmissionDraft } from '../client-XiuFnug_.js';
+import { g as RelayError, k as RelayRequestOptions, c as QuestController, a as ProgressObservation, b as ProgressObserver, P as PhotoSubmission, e as QuizSubmission, C as ClaimSubmission, V as ValueSubmission, S as SubmissionDraft } from '../client-gqnRUHpC.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { i as QuestView, b as QuestEnrollmentInput, Q as QuestClaimInput, f as QuestOutcomeQuery, P as questExperienceSchema, n as RewardDeliveryAction, A as contentQualificationQuerySchema, d as QuestOutcome } from '../outcomes-kVB-Juzs.js';
@@ -7,8 +7,8 @@ import { aG as referralAcceptSchema, g as LeaderboardQuery, b as CampaignEnrollm
 import { E as Entitlement, a as AttemptStatus, h as TrackerSkipCode, bI as submitSchema, aI as contentPerformanceQuerySchema, T as TieredRewardReference } from '../schema-DfJzH2ci.js';
 import { y as walletAddressInputSchema, I as walletSignatureSchema, L as LinkedWallet, f as WalletSigner, d as WalletSignInNetwork } from '../wallet-YssWxGg8.js';
 import { F as profileUpdateSchema, c as ProfileCompletionQuery, f as ProfileUpdate, e as ProfileSummary, a as ProfileCompletion, d as ProfileReferral } from '../profiles-D2aFcOxu.js';
-import { c as createBrowserRelayClient, J as JSONType, S as SignInMethods, C as CosmosChains, a as SignInOption, b as SignInUnavailable, d as SignInWallet, D as DiscoveredWallet } from '../browser-J7tUpXxy.js';
-export { E as EmailSignInOption, O as OAuthSignInOption, e as SignInIcon, W as WalletSignInOption } from '../browser-J7tUpXxy.js';
+import { c as createBrowserRelayClient, J as JSONType, S as SignInMethods, C as CosmosChains, a as SignInOption, b as SignInUnavailable, d as SignInWallet, D as DiscoveredWallet } from '../browser-Cf1opQjX.js';
+export { E as EmailSignInOption, O as OAuthSignInOption, e as SignInIcon, W as WalletSignInOption } from '../browser-Cf1opQjX.js';
 import * as zod from 'zod';
 import { z } from 'zod';
 import { a as AuthProvider, A as AccountConnection } from '../submission-input-BZkm6ohU.js';
@@ -4971,6 +4971,8 @@ declare function useQuest(observed: QuestView): {
     error: RelayError | null;
     busy: boolean;
     saved: SavedSubmission;
+    /** Review and explicitly restart this terminally retired saved submission. */
+    retired: boolean;
     /** The attempt the last "received" notice is about. */
     receipt: string | null;
     startingFresh: boolean;

package/dist/react/index.js

@@ -8,8 +8,8 @@ import {
   discoverSolanaWallets,
   readSignInMethods,
   signInOptionsFrom
-} from "../chunk-ZVIRG24J.js";
-import "../chunk-GZ6FJAXN.js";
+} from "../chunk-24AFCBZN.js";
+import "../chunk-DGWMLN35.js";
 import "../chunk-EYH5RDIE.js";
 import {
   RelayErrorCode,
@@ -1447,6 +1447,8 @@ function useQuest(observed) {
   const [busy, setBusy] = useState4(false);
   const [discardedAttempt, setDiscardedAttempt] = useState4(null);
   const [saved, setSaved] = useState4("none");
+  const [recoveryRevision, setRecoveryRevision] = useState4(0);
+  const [retired, setRetired] = useState4(false);
   const [receipt, setReceipt] = useState4(null);
   useEffect5(() => setLatest(null), [observed.release]);
   const view = latest ?? observed;
@@ -1459,6 +1461,9 @@ function useQuest(observed) {
       if (!active) {
         return;
       }
+      setRetired(
+        !completed && status.kind === "needs-review" && status.reason === "operation-retired"
+      );
       setSaved(
         completed || status.kind === "empty" || status.kind === "submitted" ? "none" : status.kind === "needs-review" ? "outdated" : "interrupted"
       );
@@ -1467,7 +1472,7 @@ function useQuest(observed) {
     return () => {
       active = false;
     };
-  }, [relay, quest, release, completed, attempt, busy]);
+  }, [relay, quest, release, completed, attempt, busy, recoveryRevision]);
   const run = useCallback4(
     async (action) => {
       setBusy(true);
@@ -1489,6 +1494,7 @@ function useQuest(observed) {
         setError(asRelayError(cause, "Something went wrong."));
       } finally {
         setBusy(false);
+        setRecoveryRevision((revision) => revision + 1);
       }
     },
     [store]
@@ -1507,12 +1513,14 @@ function useQuest(observed) {
           await (await relay.quests.open(current)).discard();
           setDiscardedAttempt(current.attempt?.id ?? null);
           setSaved("none");
+          setRetired(false);
           setDraft(null);
           setNotice(null);
         } catch (cause) {
           setError(asRelayError(cause, "Could not start a new submission."));
         } finally {
           setBusy(false);
+          setRecoveryRevision((revision) => revision + 1);
         }
       },
       submit: (input) => run(async () => {
@@ -1573,12 +1581,25 @@ function useQuest(observed) {
       error,
       busy,
       saved,
+      /** Review and explicitly restart this terminally retired saved submission. */
+      retired,
       /** The attempt the last "received" notice is about. */
       receipt,
       startingFresh,
       ...actions
     }),
-    [view, draft, notice, error, busy, saved, receipt, startingFresh, actions]
+    [
+      view,
+      draft,
+      notice,
+      error,
+      busy,
+      saved,
+      retired,
+      receipt,
+      startingFresh,
+      actions
+    ]
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domino-sdk/relay",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "type": "module",
   "exports": {
     ".": {