@domino-sdk/relay 0.27.0 → 0.29.0

package/dist/browser.js

@@ -1,27 +1,33 @@
 import {
   browserSubmissionStore,
+  cosmosChainList,
   cosmosSigner,
   createBrowserRelayClient,
   discoverCosmosWallets,
   discoverEvmWallets,
+  discoverSignInWallets,
   discoverSolanaWallets,
   evmSigner,
+  signInOptions,
   solanaSigner,
   walletStandardSolanaSigner
-} from "./chunk-RVGO2CRA.js";
-import "./chunk-D6AIUNSM.js";
-import "./chunk-AKB266O5.js";
-import "./chunk-M3R5V5WC.js";
-import "./chunk-D6BX627V.js";
-import "./chunk-IXLY3A7B.js";
+} from "./chunk-MVCKCDNR.js";
+import "./chunk-5LLU7UUV.js";
+import "./chunk-YKS6P4IP.js";
+import "./chunk-LAKQCIHX.js";
+import "./chunk-MRKFRCCI.js";
+import "./chunk-BE5V6RFD.js";
 export {
   browserSubmissionStore,
+  cosmosChainList,
   cosmosSigner,
   createBrowserRelayClient,
   discoverCosmosWallets,
   discoverEvmWallets,
+  discoverSignInWallets,
   discoverSolanaWallets,
   evmSigner,
+  signInOptions,
   solanaSigner,
   walletStandardSolanaSigner
 };

package/dist/{chunk-D6AIUNSM.js → chunk-5LLU7UUV.js}

@@ -8,6 +8,7 @@ import {
   leaderboardArtifactSchema,
   leaderboardDefinitionSchema,
   leaderboardPageSchema,
+  leaderboardPlacementSchema,
   leaderboardPreviewSchema,
   leaderboardQuerySchema,
   normalizeAuthoringIdentity,
@@ -18,7 +19,7 @@ import {
   referralHistorySchema,
   referralSummarySchema,
   validateAuthoringIdentity
-} from "./chunk-AKB266O5.js";
+} from "./chunk-YKS6P4IP.js";
 import {
   authScopeSchema,
   exchangeResultSchema,
@@ -35,14 +36,17 @@ import {
   walletSignInNetworksSchema,
   walletSignatureSchema,
   walletUnlinkInputSchema
-} from "./chunk-M3R5V5WC.js";
+} from "./chunk-LAKQCIHX.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   avatarUploadTypes,
   ownProfileSchema,
-  profileUpdateSchema,
-  publicProfileSchema
-} from "./chunk-D6BX627V.js";
+  profileCompletionPageSchema,
+  profileCompletionQuerySchema,
+  profileReferralSchema,
+  profileSummarySchema,
+  profileUpdateSchema
+} from "./chunk-MRKFRCCI.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -81,7 +85,7 @@ import {
   validateSubmissionValue,
   valueEvidenceSchema,
   xTweetSchema
-} from "./chunk-IXLY3A7B.js";
+} from "./chunk-BE5V6RFD.js";
 
 // src/point-ledgers.ts
 import { z } from "zod";
@@ -1871,7 +1875,16 @@ function createRelayClient(options) {
           query(`/v1/leaderboards/${identifier.parse(board)}`, parsed),
           leaderboardPageSchema
         );
-      }
+      },
+      /**
+       * A profile's current rank and score on `board` (`profile.id` from a leaderboard row or
+       * `profiles.mine()`). Needs the board's access, like `standings`; a profile this viewer
+       * cannot see is a 404, as in `profiles.get`.
+       */
+      placement: (board, profile) => request(
+        `/v1/leaderboards/${identifier.parse(board)}/profiles/${identifier.parse(profile)}`,
+        leaderboardPlacementSchema
+      )
     },
     /**
      * Participant profiles: the display name and avatar other participants see where the project
@@ -1916,12 +1929,31 @@ function createRelayClient(options) {
         });
       },
       /**
-       * A profile page by its public ID (`profile.id` from a leaderboard row or `mine()`). A
-       * profile that is missing, hidden or not visible to this viewer is a 404.
+       * A profile's name and avatar by its public ID (`profile.id` from a leaderboard row or
+       * `mine()`). A profile that is missing, hidden or not visible to this viewer is a 404.
        */
       get: (profile) => request(
         `/v1/profiles/${identifier.parse(profile)}`,
-        publicProfileSchema
+        profileSummarySchema
+      ),
+      /**
+       * A page of the profile's completions of quests that show on profiles, most recently
+       * completed first. Pass the page's `nextCursor` as `cursor` for the next one.
+       */
+      completions: (profile, options2 = {}) => request(
+        query(
+          `/v1/profiles/${identifier.parse(profile)}/completions`,
+          profileCompletionQuerySchema.parse(options2)
+        ),
+        profileCompletionPageSchema
+      ),
+      /**
+       * The profile's invited and qualified counts and milestones in one referral program. Needs
+       * a signed-in participant, as referral programs do.
+       */
+      referral: (profile, program) => request(
+        `/v1/profiles/${identifier.parse(profile)}/referrals/${identifier.parse(program)}`,
+        profileReferralSchema
       )
     },
     quests: {

package/dist/{chunk-IXLY3A7B.js → chunk-BE5V6RFD.js}

@@ -1119,6 +1119,7 @@ var questPresentationSchema = z13.object({
     }).strict().optional()
   }).strict().optional()
 }).strict();
+var questProfileSchema = z13.object({ visible: z13.boolean() }).strict();
 var questDescriptionSchema = z13.object({
   quest: identifier,
   runtimeVersion: z13.union([z13.literal(1), z13.literal(2)]).default(1),
@@ -1134,6 +1135,12 @@ var questDescriptionSchema = z13.object({
   requires: z13.array(prerequisiteSchema).max(30).default([]),
   completion: completionPolicySchema,
   visibility: z13.enum(["visible", "hidden"]).default("visible"),
+  /**
+   * Whether completions show on participant profiles (`/v1/profiles/:id/completions`). Absent
+   * is hidden. Optional, not defaulted: releases carry the key only when the author sets it, so
+   * clients and pods that predate it (strict release schemas) still read every other release.
+   */
+  profile: questProfileSchema.optional(),
   budgets: z13.array(budgetSchema).max(20).default([])
 }).strict();
 var artifactSchema = z13.object({ code: z13.string().min(1).max(1e6) }).strict();
@@ -1626,6 +1633,7 @@ export {
   rewardBundleSchema,
   mediaUrlSchema,
   questPresentationSchema,
+  questProfileSchema,
   questDescriptionSchema,
   artifactSchema,
   releaseSchema,

package/dist/{chunk-M3R5V5WC.js → chunk-LAKQCIHX.js}

@@ -1,6 +1,6 @@
 import {
   identifier
-} from "./chunk-IXLY3A7B.js";
+} from "./chunk-BE5V6RFD.js";
 
 // src/auth.ts
 import { z } from "zod";
@@ -72,6 +72,11 @@ function cosmosChain(chain) {
     throw new Error('Use a Cosmos network such as "cosmos:cosmoshub-4"');
   }
   const value = typeof chain === "string" ? { chainId: chain.slice("cosmos:".length) } : chain;
+  if (typeof value?.chainId !== "string") {
+    throw new Error(
+      'Pass a Cosmos chain as { chainId } or a network such as "cosmos:cosmoshub-4"'
+    );
+  }
   const network = `cosmos:${value.chainId}`;
   if (!cosmosNetworkPattern.test(network)) {
     throw new Error(

package/dist/{chunk-D6BX627V.js → chunk-MRKFRCCI.js}

@@ -1,6 +1,6 @@
 import {
   identifier
-} from "./chunk-IXLY3A7B.js";
+} from "./chunk-BE5V6RFD.js";
 
 // src/profiles.ts
 import { z } from "zod";
@@ -10,8 +10,12 @@ var profileVisibilitySchema = z.enum([
   "participants",
   "public"
 ]);
-var profileDefaultsSchema = z.enum(["generated", "accounts"]);
 var avatarProviderSchema = z.enum(["x", "discord", "google"]);
+var profileDefaultProviderSchema = z.enum(["x", "discord"]);
+var profileDefaultsSchema = z.array(profileDefaultProviderSchema).max(profileDefaultProviderSchema.options.length).refine(
+  (providers) => new Set(providers).size === providers.length,
+  "List each provider once"
+);
 var avatarSeedSchema = z.string().min(1).max(100);
 var profileAvatarSchema = z.discriminatedUnion("source", [
   z.object({
@@ -71,55 +75,38 @@ var ownProfileSchema = profileSummarySchema.extend({
     })
   )
 });
-var publicProfileSchema = profileSummarySchema.extend({
-  /** The profile is the viewer's own. */
-  self: z.boolean(),
-  leaderboards: z.array(
-    z.object({
-      leaderboard: identifier,
-      key: identifier.optional(),
-      title: z.string(),
-      rank: count.positive(),
-      score: z.number().int().safe(),
-      /** Ranked participants on the board. */
-      total: count
-    })
-  ).nullable(),
-  quests: z.array(
-    z.object({
-      quest: identifier,
-      key: identifier.optional(),
-      title: z.string(),
-      completions: count.positive(),
-      /** Null for completions recorded before completion times were. */
-      lastCompletedAt: count.nullable()
-    })
-  ).max(200).nullable(),
-  referrals: z.object({
-    /** Members this member invited. */
-    attributed: count,
-    programs: z.array(
-      z.object({
-        program: identifier,
-        key: identifier.optional(),
-        title: z.string(),
-        qualified: count,
-        milestones: z.array(
-          z.object({ id: identifier, count, reached: z.boolean() })
-        )
-      })
-    )
-  }).nullable()
+var cursor = z.string().min(1).max(512);
+var profileCompletionQuerySchema = z.object({
+  limit: z.coerce.number().int().min(1).max(100).default(20),
+  cursor: cursor.optional()
+}).strict();
+var profileCompletionSchema = z.object({
+  quest: identifier,
+  key: identifier.optional(),
+  title: z.string(),
+  completions: count.positive(),
+  /** Null for completions recorded before completion times were. */
+  lastCompletedAt: count.nullable()
+});
+var profileCompletionPageSchema = z.object({
+  items: z.array(profileCompletionSchema),
+  nextCursor: cursor.nullable()
+});
+var profileReferralSchema = z.object({
+  program: identifier,
+  key: identifier.optional(),
+  title: z.string(),
+  /** Members this member invited. Invitations are shared by every program. */
+  invited: count,
+  /** Invited members who qualified in this program. */
+  qualified: count,
+  milestones: z.array(
+    z.object({ id: identifier, count, reached: z.boolean() })
+  )
 });
 var profileSettingsSchema = z.object({
   visibility: profileVisibilitySchema,
   defaults: profileDefaultsSchema,
-  /** The sections a profile page shows. */
-  sections: z.object({
-    leaderboards: z.boolean(),
-    quests: z.boolean(),
-    referrals: z.boolean()
-  }),
   revision: count,
   actor: z.string().nullable(),
   updatedAt: count.nullable()
@@ -151,20 +138,26 @@ var managedProfileSchema = ownProfileSchema.omit({ options: true }).extend({
 var AVATAR_UPLOAD_LIMIT = 5 * 1024 * 1024;
 var avatarUploadTypes = ["image/jpeg", "image/png", "image/webp"];
 function isProfileParticipantRoute(path, method) {
-  return method === "GET" && (path === "/v1/me/profile" || /^\/v1\/profiles\/[\w-]+$/.test(path)) || method === "POST" && (path === "/v1/me/profile" || path === "/v1/me/profile/avatar");
+  return method === "GET" && (path === "/v1/me/profile" || /^\/v1\/profiles\/[\w-]+(?:\/completions|\/referrals\/[\w-]+)?$/.test(
+    path
+  ) || /^\/v1\/leaderboards\/[\w-]+\/profiles\/[\w-]+$/.test(path)) || method === "POST" && (path === "/v1/me/profile" || path === "/v1/me/profile/avatar");
 }
 
 export {
   profileVisibilitySchema,
-  profileDefaultsSchema,
   avatarProviderSchema,
+  profileDefaultProviderSchema,
+  profileDefaultsSchema,
   avatarSeedSchema,
   profileAvatarSchema,
   profileSummarySchema,
   displayNameSchema,
   profileUpdateSchema,
   ownProfileSchema,
-  publicProfileSchema,
+  profileCompletionQuerySchema,
+  profileCompletionSchema,
+  profileCompletionPageSchema,
+  profileReferralSchema,
   profileSettingsSchema,
   profileSettingsInputSchema,
   profileModerationSchema,

package/dist/{chunk-RVGO2CRA.js → chunk-MVCKCDNR.js}

@@ -1,9 +1,9 @@
 import {
   createRelayClient
-} from "./chunk-D6AIUNSM.js";
+} from "./chunk-5LLU7UUV.js";
 import {
   cosmosChain
-} from "./chunk-M3R5V5WC.js";
+} from "./chunk-LAKQCIHX.js";
 
 // src/base58.ts
 var alphabet = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
@@ -315,6 +315,173 @@ function discoverCosmosWallets(chain) {
   }
   return wallets;
 }
+function cosmosChainList(chains) {
+  return chains === void 0 ? [] : Array.isArray(chains) ? [...chains] : [chains];
+}
+async function discoverSignInWallets(families, cosmos) {
+  const tagged = (network, wallets) => wallets.map((wallet) => ({ ...wallet, network }));
+  const solana = families.includes("solana") ? tagged("solana", discoverSolanaWallets()) : [];
+  const chains = families.includes("cosmos") ? tagged(
+    "cosmos",
+    cosmosChainList(cosmos).flatMap((chain) => discoverCosmosWallets(chain))
+  ) : [];
+  const evm = families.includes("eip155") ? tagged("eip155", await discoverEvmWallets()) : [];
+  return [...evm, ...solana, ...chains];
+}
+
+// src/sign-in-options.ts
+var providerLabels = {
+  google: "Google",
+  apple: "Apple",
+  x: "X",
+  discord: "Discord"
+};
+var familyLabels = {
+  solana: "Solana",
+  eip155: "EVM",
+  cosmos: "Cosmos"
+};
+function walletLabels(wallets) {
+  const named = wallets.map(
+    (wallet) => wallets.some((other) => other !== wallet && other.name === wallet.name) ? `${wallet.name} (${wallet.signer.network?.slice("cosmos:".length) ?? familyLabels[wallet.network]})` : wallet.name
+  );
+  const seen = /* @__PURE__ */ new Map();
+  return named.map((label) => {
+    if (named.indexOf(label) === named.lastIndexOf(label)) {
+      return label;
+    }
+    const count = (seen.get(label) ?? 0) + 1;
+    seen.set(label, count);
+    return `${label} ${count}`;
+  });
+}
+function cosmosChainsError(chains) {
+  try {
+    for (const chain of cosmosChainList(chains)) {
+      cosmosChain(chain);
+    }
+    return null;
+  } catch (cause) {
+    return cause instanceof Error ? cause.message : String(cause);
+  }
+}
+function signInOptionsFrom(methods, wallets, input) {
+  const { actions } = input;
+  const invalid = cosmosChainsError(input.cosmos);
+  const chains = !invalid && cosmosChainList(input.cosmos).length > 0;
+  const offered = methods.wallets.filter(
+    (family) => family !== "cosmos" || chains
+  );
+  const found = wallets.filter((wallet) => offered.includes(wallet.network));
+  const labels = walletLabels(found);
+  const options = [
+    ...methods.providers.map((provider) => ({
+      kind: "oauth",
+      id: provider,
+      label: providerLabels[provider],
+      icon: provider,
+      start: () => actions.oauth(provider)
+    })),
+    ...found.map((wallet, index) => ({
+      kind: "wallet",
+      id: `wallet:${wallet.network}:${wallet.id}`,
+      label: labels[index] ?? wallet.name,
+      icon: "wallet",
+      ...wallet.icon ? { iconUrl: wallet.icon } : {},
+      family: wallet.network,
+      signer: wallet.signer,
+      start: () => actions.wallet(wallet.signer)
+    })),
+    ...methods.email ? [
+      {
+        kind: "email",
+        id: "email",
+        label: "Email",
+        icon: "email",
+        sendCode: actions.sendCode,
+        verifyCode: actions.verifyCode
+      }
+    ] : []
+  ];
+  const unavailable = [];
+  if (methods.wallets.includes("cosmos") && invalid) {
+    unavailable.push({
+      reason: "cosmos-chains-invalid",
+      families: ["cosmos"],
+      message: `This project takes Cosmos wallets, but this app's Cosmos chains are invalid, so none are offered: ${invalid}.`
+    });
+  } else if (methods.wallets.includes("cosmos") && !chains) {
+    unavailable.push({
+      reason: "cosmos-chains-missing",
+      families: ["cosmos"],
+      message: "This project takes Cosmos wallets, but this app names no Cosmos chains, so none are offered. Pass the chains as the cosmos option."
+    });
+  }
+  if (!input.walletsPending && offered.length > 0 && found.length === 0) {
+    const names = new Intl.ListFormat("en", { type: "disjunction" }).format(
+      offered.map((family) => familyLabels[family])
+    );
+    unavailable.push({
+      reason: "no-wallet-installed",
+      families: offered,
+      message: `Wallet sign-in accepts ${names} wallets. Install one in this browser, then reload this page.`
+    });
+  }
+  return {
+    options,
+    unavailable,
+    ...methods.error ? { methodsError: methods.error } : {}
+  };
+}
+async function readSignInMethods(relay) {
+  try {
+    const result = await relay.auth.providers();
+    return {
+      providers: result.providers.filter((entry) => entry.configured).map((entry) => entry.provider),
+      email: result.email,
+      wallets: result.wallets
+    };
+  } catch (cause) {
+    return {
+      providers: [],
+      email: true,
+      wallets: [],
+      error: cause instanceof Error && cause.message ? cause.message : "Couldn't read the project's sign-in methods."
+    };
+  }
+}
+async function signInOptions(relay, input = {}) {
+  const methods = await readSignInMethods(relay);
+  const wallets = await discoverSignInWallets(
+    methods.wallets,
+    cosmosChainsError(input.cosmos) ? void 0 : input.cosmos
+  );
+  let challenge = null;
+  return signInOptionsFrom(methods, wallets, {
+    cosmos: input.cosmos,
+    actions: {
+      async oauth(provider) {
+        const { url } = await relay.auth.start(provider, "sign-in");
+        window.location.assign(url);
+      },
+      async sendCode(email) {
+        challenge = null;
+        challenge = (await relay.auth.emailStart(email)).challenge;
+      },
+      async verifyCode(code) {
+        if (!challenge) {
+          throw new Error("Request a new code first.");
+        }
+        await relay.auth.emailVerify(challenge, code.trim());
+        challenge = null;
+      },
+      async wallet(signer) {
+        await relay.auth.wallet.signIn(signer);
+        challenge = null;
+      }
+    }
+  });
+}
 
 // src/browser.ts
 function createBrowserRelayClient(options) {
@@ -377,6 +544,12 @@ export {
   discoverEvmWallets,
   discoverSolanaWallets,
   discoverCosmosWallets,
+  cosmosChainList,
+  discoverSignInWallets,
+  cosmosChainsError,
+  signInOptionsFrom,
+  readSignInMethods,
+  signInOptions,
   createBrowserRelayClient,
   browserSubmissionStore
 };

package/dist/{chunk-AKB266O5.js → chunk-YKS6P4IP.js}

@@ -1,13 +1,13 @@
 import {
   profileSummarySchema
-} from "./chunk-D6BX627V.js";
+} from "./chunk-MRKFRCCI.js";
 import {
   contentMetricSchema,
   contentMetricsSchema,
   identifier,
   pointsRewardSchema,
   tierRewardSchema
-} from "./chunk-IXLY3A7B.js";
+} from "./chunk-BE5V6RFD.js";
 
 // src/engagement.ts
 import { z } from "zod";
@@ -447,6 +447,16 @@ var leaderboardPageSchema = z4.object({
   nearby: z4.array(leaderboardRowSchema),
   nextCursor: z4.string().nullable()
 });
+var leaderboardPlacementSchema = z4.object({
+  leaderboard: identifier,
+  key: identifier.optional(),
+  title: z4.string(),
+  profile: identifier,
+  rank: integer.positive().nullable(),
+  score: integer.nullable(),
+  /** Ranked participants on the board. */
+  total: integer.nonnegative()
+});
 var leaderboardPreviewSchema = z4.object({
   published: publishedLeaderboardSchema,
   before: leaderboardPageSchema.nullable(),
@@ -601,6 +611,7 @@ export {
   leaderboardQuerySchema,
   leaderboardRowSchema,
   leaderboardPageSchema,
+  leaderboardPlacementSchema,
   leaderboardPreviewSchema,
   pointsMutationSchema,
   pointsEntrySchema,