@domino-sdk/relay 1.44.0 → 1.46.0

package/build.d.mts

@@ -1,5 +1,18 @@
-/** Bundle a default-exported quest module without executing it on the build host. */
+/** The SDK runtime a quest bundle imports instead of bundling the SDK (`sdkRuntimeSchema`). */
+export type BuiltSdkRuntime = {
+  digest: string
+  sdkVersion: string
+  zodVersion: string
+  modules: Record<string, string>
+}
+
+/**
+ * Bundle a default-exported quest module without executing it on the build host. With `runtime`,
+ * the SDK the quest resolves (and zod, at the SDK runtime's version) stays out of the bundle when
+ * that SDK ships a runtime: the code imports `./runtime/<file>`, and `runtime` is the runtime it
+ * needs. An SDK without one is bundled in, and `runtime` is absent.
+ */
 export declare function buildQuest(
   entry: string,
-  options?: { exportName?: string }
-): Promise<{ code: string }>
+  options?: { exportName?: string; runtime?: boolean }
+): Promise<{ code: string; runtime?: BuiltSdkRuntime }>

package/build.mjs

@@ -1,4 +1,6 @@
-import { resolve, dirname } from "node:path"
+import { createHash } from "node:crypto"
+import { readFile, stat } from "node:fs/promises"
+import { resolve, dirname, join } from "node:path"
 
 // esbuild is an optional peer dependency: only quest builds need it, so apps that use the runtime
 // client do not install its native binary. `@domino-sdk/relay-cli` depends on it.
@@ -31,6 +33,168 @@ const testsOnly = {
   },
 }
 
+/** The package directory that holds `file`: the nearest package.json named `name`. */
+async function packageRoot(file, name) {
+  let dir = dirname(file)
+
+  while (dirname(dir) !== dir) {
+    const manifest = await readFile(join(dir, "package.json"), "utf8").catch(
+      () => null
+    )
+
+    if (manifest !== null && JSON.parse(manifest).name === name) {
+      return { dir, version: JSON.parse(manifest).version }
+    }
+
+    dir = dirname(dir)
+  }
+
+  return null
+}
+
+const runtimes = new Map()
+
+/**
+ * The SDK runtime of the SDK installed at `root` (dist/runtime, built by scripts/build-runtime.mjs),
+ * or null for an SDK built without one. Read once per installed manifest: reinstalling the SDK in
+ * place (a long `domino dev`) changes the manifest's modification time and reads it again.
+ */
+async function installedRuntime(root) {
+  const changed = await stat(join(root, "dist/runtime/manifest.json")).then(
+    (manifest) => manifest.mtimeMs,
+    () => null
+  )
+  const key = `${root}\0${changed}`
+
+  if (!runtimes.has(key)) {
+    runtimes.set(
+      key,
+      (async () => {
+        const dir = join(root, "dist/runtime")
+        const manifest = await readFile(join(dir, "manifest.json"), "utf8")
+          .then(JSON.parse)
+          .catch(() => null)
+
+        if (manifest?.format !== 1) {
+          return null
+        }
+
+        const modules = Object.fromEntries(
+          await Promise.all(
+            [...manifest.modules]
+              .sort()
+              .map(async (path) => [
+                path,
+                await readFile(join(dir, path), "utf8"),
+              ])
+          )
+        )
+        // sdkRuntimeDigest: SHA-256 of the path-sorted [path, source] pairs.
+        const digest = createHash("sha256")
+          .update(JSON.stringify(Object.entries(modules)))
+          .digest("hex")
+
+        if (digest !== manifest.digest) {
+          throw new Error(
+            `The SDK runtime in ${dir} does not match its manifest. Reinstall @domino-sdk/relay.`
+          )
+        }
+
+        return {
+          entries: manifest.entries,
+          runtime: {
+            digest,
+            sdkVersion: manifest.sdkVersion,
+            zodVersion: manifest.zodVersion,
+            modules,
+          },
+        }
+      })()
+    )
+  }
+
+  return runtimes.get(key)
+}
+
+const probe = { domino: "sdk-runtime-probe" }
+
+/**
+ * Leaves the SDK (and zod, when the app resolves the version the SDK runtime carries) out of the
+ * bundle: their imports become `./runtime/<file>`, which the platform loads beside the quest from
+ * the runtime this build records in `used`. An SDK without a runtime is bundled as before.
+ */
+function sdkRuntime(used) {
+  return {
+    name: "domino:sdk-runtime",
+    setup(build) {
+      const resolved = async (path, args) => {
+        const result = await build.resolve(path, {
+          kind: args.kind,
+          resolveDir: args.resolveDir,
+          pluginData: probe,
+        })
+
+        return result.errors.length ? null : result.path
+      }
+
+      const runtimeFor = async (args) => {
+        const sdk = await resolved("@domino-sdk/relay/authoring", args)
+        const root = sdk && (await packageRoot(sdk, "@domino-sdk/relay"))
+
+        return root ? installedRuntime(root.dir) : null
+      }
+
+      const external = (installed, specifier) => {
+        if (used.runtime && used.runtime.digest !== installed.runtime.digest) {
+          throw new Error(
+            `This quest imports two different @domino-sdk/relay installations (${used.runtime.sdkVersion} and ${installed.runtime.sdkVersion}). Install one SDK version.`
+          )
+        }
+
+        used.runtime = installed.runtime
+
+        return {
+          path: "./runtime/" + installed.entries[specifier],
+          external: true,
+        }
+      }
+
+      build.onResolve(
+        { filter: /^@domino-sdk\/relay\/(authoring|schema)$/ },
+        async (args) => {
+          if (args.pluginData === probe) {
+            return undefined
+          }
+
+          const installed = await runtimeFor(args)
+
+          if (!installed?.entries[args.path]) {
+            used.bundled = true
+
+            return undefined
+          }
+
+          return external(installed, args.path)
+        }
+      )
+      build.onResolve({ filter: /^zod$/ }, async (args) => {
+        if (args.pluginData === probe) {
+          return undefined
+        }
+
+        const installed = await runtimeFor(args)
+        const zod = installed?.entries.zod && (await resolved("zod", args))
+        const root = zod && (await packageRoot(zod, "zod"))
+
+        // A different zod would be a different module; bundle the app's own.
+        return root && root.version === installed.runtime.zodVersion
+          ? external(installed, "zod")
+          : undefined
+      })
+    },
+  }
+}
+
 /** Bundle an authored quest without evaluating developer code in the build process. */
 export async function buildQuest(entry, options = {}) {
   if (
@@ -41,6 +205,7 @@ export async function buildQuest(entry, options = {}) {
   }
 
   const { build } = await esbuild()
+  const used = {}
   const result = await build({
     ...(options.exportName
       ? {
@@ -59,7 +224,7 @@ export async function buildQuest(entry, options = {}) {
     platform: "neutral",
     target: "es2022",
     minify: true,
-    plugins: [testsOnly],
+    plugins: options.runtime ? [testsOnly, sdkRuntime(used)] : [testsOnly],
   })
   const file = result.outputFiles[0]
 
@@ -67,5 +232,13 @@ export async function buildQuest(entry, options = {}) {
     throw new Error("Quest build produced no module")
   }
 
-  return { code: file.text }
+  if (used.runtime && used.bundled) {
+    throw new Error(
+      "This quest imports one @domino-sdk/relay installation that ships an SDK runtime and another that does not. Install one SDK version."
+    )
+  }
+
+  return used.runtime
+    ? { code: file.text, runtime: used.runtime }
+    : { code: file.text }
 }

package/dist/authoring.js

@@ -10,7 +10,7 @@ import {
   sourceDataSchema,
   sourceRoles,
   validateQuestShape
-} from "./chunk-ZY4RI4DJ.js";
+} from "./chunk-R5BDN7US.js";
 import {
   badgeDeclarationSchema,
   defineOffer,
@@ -20,11 +20,11 @@ import {
   leaderboardAuthoringSchema,
   pointLedgerDeclarationSchema,
   referralAuthoringSchema
-} from "./chunk-WSOUOG6S.js";
+} from "./chunk-SKBZ7UVZ.js";
 import {
   telegramReactionDataSchema,
   telegramReactionsNamespace
-} from "./chunk-J7YJHMF7.js";
+} from "./chunk-TJ2OH3MQ.js";
 import {
   authoringKey,
   badgeReward,
@@ -82,7 +82,7 @@ import {
   whereSchemaIssue,
   whereSettings,
   xSearchSourceSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/builders.ts
 import * as z from "zod";

package/dist/browser.js

@@ -12,16 +12,16 @@ import {
   solanaSigner,
   telegramMiniAppInitData,
   walletStandardSolanaSigner
-} from "./chunk-IGUT3HCM.js";
-import "./chunk-RXM7LBLH.js";
-import "./chunk-UOHYYB7V.js";
-import "./chunk-TEPZZXDI.js";
-import "./chunk-WSOUOG6S.js";
-import "./chunk-J7YJHMF7.js";
-import "./chunk-NNGGEUMQ.js";
-import "./chunk-ZNFAIBTJ.js";
-import "./chunk-Q5PX3GDA.js";
-import "./chunk-PMSCHJKX.js";
+} from "./chunk-4W4FXLGM.js";
+import "./chunk-SESHFICW.js";
+import "./chunk-EC5MEEZD.js";
+import "./chunk-Y22GX76Y.js";
+import "./chunk-SKBZ7UVZ.js";
+import "./chunk-TJ2OH3MQ.js";
+import "./chunk-WE6LLVR5.js";
+import "./chunk-OXIXMXFB.js";
+import "./chunk-KHFDDXAM.js";
+import "./chunk-DJAIFEV4.js";
 export {
   browserSubmissionStore,
   cosmosChainList,

package/dist/{chunk-YBMCF54E.js → chunk-2VBCWGBG.js}

@@ -6,7 +6,7 @@ import {
   imageSightingsSchema,
   imageUploadsSchema,
   publishedImageSchema
-} from "./chunk-ILH73K3H.js";
+} from "./chunk-6IC332LX.js";
 import {
   catalogDeploymentSchema,
   collectionPassSchema,
@@ -24,7 +24,7 @@ import {
   questTypeVersionSchema,
   questViewSchema,
   rewardDeliveriesSchema
-} from "./chunk-TEPZZXDI.js";
+} from "./chunk-Y22GX76Y.js";
 import {
   badgeArtifactSchema,
   badgeSchema,
@@ -58,15 +58,15 @@ import {
   referralDefinitionSchema,
   referralHistorySchema,
   referralSummarySchema
-} from "./chunk-WSOUOG6S.js";
+} from "./chunk-SKBZ7UVZ.js";
 import {
   telegramAccountConnectionSchema
-} from "./chunk-J7YJHMF7.js";
+} from "./chunk-TJ2OH3MQ.js";
 import {
   exchangeResultSchema,
   memberSummarySchema,
   participantSessionSchema
-} from "./chunk-Q5PX3GDA.js";
+} from "./chunk-KHFDDXAM.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -87,6 +87,7 @@ import {
   publishedReleaseSchema,
   publishedTrackerSchema,
   questBudgetViewSchema,
+  questScaleLimits,
   releaseSchema,
   responseListSchema,
   responseSchema,
@@ -98,7 +99,7 @@ import {
   walletBalanceSchema,
   walletMessageChallengeSchema,
   walletSignInNetworksSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/deployments.ts
 import * as z from "zod";
@@ -119,7 +120,9 @@ var projectCatalogArtifactSchema = catalogDeploymentSchema.omit({ expectedRevisi
    */
   runtimes: z.array(sdkRuntimeSchema).max(4).default([])
 });
-var projectDeploymentSchema = projectCatalogArtifactSchema.extend({ releases: z.array(releaseSchema).max(50).default([]) }).refine(
+var projectDeploymentSchema = projectCatalogArtifactSchema.extend({
+  releases: z.array(releaseSchema).max(questScaleLimits.quests).default([])
+}).refine(
   (value) => value.engagement.length > 0 || value.trackers.length > 0 || value.pointLedgers.length > 0 || value.badges.length > 0 || value.offers.length > 0 || value.releases.length > 0 || value.leaderboards.length > 0 || value.referrals.length > 0 || value.images.length > 0 || value.types.length > 0 || value.collections.length > 0 || value.supportedInteractions !== void 0 || value.calendar !== void 0,
   "No resources configured. Add engagement, trackers, quests, questTypes, badges, pointLedgers, offers, leaderboards, referrals, images, collections, supportedInteractions, or calendar to relay.json."
 );

package/dist/{chunk-HO4FZJSH.js → chunk-3UCK2C2P.js}

@@ -4,10 +4,10 @@ import {
   imageFieldsSchema,
   imageInspectionSchema,
   imageSightingsSchema
-} from "./chunk-ILH73K3H.js";
+} from "./chunk-6IC332LX.js";
 import {
   photoResultSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/image-results.ts
 import * as z from "zod";

package/dist/{chunk-IGUT3HCM.js → chunk-4W4FXLGM.js}

@@ -1,12 +1,12 @@
 import {
   createRelayClient
-} from "./chunk-RXM7LBLH.js";
+} from "./chunk-SESHFICW.js";
 import {
   RelayErrorCode,
   asRelayError,
   clientError,
   cosmosChain
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/base58.ts
 var alphabet = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";

package/dist/{chunk-ILH73K3H.js → chunk-6IC332LX.js}

@@ -2,7 +2,7 @@ import {
   identifier,
   responseShape,
   xTweetSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/x.ts
 import * as z from "zod";

package/dist/{chunk-PMSCHJKX.js → chunk-DJAIFEV4.js}

@@ -2102,6 +2102,11 @@ var trackerTriggerContextSchema = z13.object({
 
 // src/sdk-runtime.ts
 import * as z14 from "zod";
+var questScaleLimits = {
+  quests: 1e3,
+  questTypes: 200,
+  collections: 1e3
+};
 var sdkRuntimeLimits = {
   modules: 200,
   /** Characters of module source, summed over all modules. */
@@ -3043,7 +3048,9 @@ var releaseSchema = artifactSchema.extend({
   expectedRelease: identifier.nullable().optional(),
   settingRenames: z27.record(z27.string(), z27.string()).optional()
 }).strict();
-var batchReleaseSchema = z27.object({ releases: z27.array(releaseSchema).min(1).max(50) }).strict();
+var batchReleaseSchema = z27.object({
+  releases: z27.array(releaseSchema).min(1).max(questScaleLimits.quests)
+}).strict();
 var questSettingsInputSchema = z27.object({
   quest: identifier,
   expectedRelease: identifier,
@@ -3717,6 +3724,7 @@ export {
   trackerContentStageSchema,
   trackerTriggerContextSchema,
   maxPointsAmount,
+  questScaleLimits,
   sdkRuntimeLimits,
   sdkRuntimeModulePathSchema,
   sdkRuntimeReferenceSchema,

package/dist/{chunk-UOHYYB7V.js → chunk-EC5MEEZD.js}

@@ -2,7 +2,7 @@ import {
   RelayErrorCode,
   clientError,
   isRequestError
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/action.ts
 function withActionId(value) {

package/dist/{chunk-W5UBRNDT.js → chunk-JPFPLYQS.js}

@@ -8,7 +8,7 @@ import {
   rewardBundleSchema,
   settingsValuesSchema,
   trackerTriggerContextSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/server/attempt-captures.ts
 import * as z from "zod";

package/dist/{chunk-Q5PX3GDA.js → chunk-KHFDDXAM.js}

@@ -1,6 +1,6 @@
 import {
   identifier
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/auth.ts
 import * as z from "zod";

package/dist/{chunk-ZNFAIBTJ.js → chunk-OXIXMXFB.js}

@@ -1,6 +1,6 @@
 // package.json
 var name = "@domino-sdk/relay";
-var version = "1.44.0";
+var version = "1.46.0";
 
 // src/client-identity.ts
 function clientIdentity() {

package/dist/{chunk-ZY4RI4DJ.js → chunk-R5BDN7US.js}

@@ -5,7 +5,7 @@ import {
   isKnownTrackerSource,
   trackerDataSchema,
   xAccountRoles
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/quest-shape.ts
 function validateQuestShape(description, options = {}) {

package/dist/{chunk-RXM7LBLH.js → chunk-SESHFICW.js}

@@ -1,7 +1,7 @@
 import {
   createRelayAction,
   withActionId
-} from "./chunk-UOHYYB7V.js";
+} from "./chunk-EC5MEEZD.js";
 import {
   collectionPassSchema,
   participantActivityQuerySchema,
@@ -17,7 +17,7 @@ import {
   questOutcomeSchema,
   rewardDeliveriesSchema,
   rewardDeliveryQuerySchema
-} from "./chunk-TEPZZXDI.js";
+} from "./chunk-Y22GX76Y.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   avatarUploadTypes,
@@ -48,29 +48,29 @@ import {
   referralDefinitionSchema,
   referralHistorySchema,
   referralSummarySchema
-} from "./chunk-WSOUOG6S.js";
+} from "./chunk-SKBZ7UVZ.js";
 import {
   telegramAccountConnectionSchema,
   telegramMiniAppSignInSchema,
   telegramSignInMethodsSchema
-} from "./chunk-J7YJHMF7.js";
+} from "./chunk-TJ2OH3MQ.js";
 import {
   PARTICIPANT_TIMEOUT,
   lifetime,
   retryAfter,
   retrying,
   validTimeout
-} from "./chunk-NNGGEUMQ.js";
+} from "./chunk-WE6LLVR5.js";
 import {
   clientIdentity
-} from "./chunk-ZNFAIBTJ.js";
+} from "./chunk-OXIXMXFB.js";
 import {
   exchangeResultSchema,
   exchangeSchema,
   memberSummarySchema,
   participantSessionSchema,
   sessionMember
-} from "./chunk-Q5PX3GDA.js";
+} from "./chunk-KHFDDXAM.js";
 import {
   RelayError,
   RelayErrorCode,
@@ -109,7 +109,7 @@ import {
   walletSignInNetworksSchema,
   walletSignatureSchema,
   walletUnlinkInputSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/legacy-submissions.ts
 import * as z from "zod";

package/dist/{chunk-WSOUOG6S.js → chunk-SKBZ7UVZ.js}

@@ -12,7 +12,7 @@ import {
   responseShape,
   rewardKey,
   tierRewardSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/badges.ts
 import * as z from "zod";

package/dist/{chunk-J7YJHMF7.js → chunk-TJ2OH3MQ.js}

@@ -1,6 +1,6 @@
 import {
   accountConnectionSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/telegram.ts
 import * as z from "zod";

package/dist/{chunk-NNGGEUMQ.js → chunk-WE6LLVR5.js}

@@ -1,6 +1,6 @@
 import {
   isRequestError
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/request-lifetime.ts
 var PARTICIPANT_TIMEOUT = 15e3;

package/dist/{chunk-TEPZZXDI.js → chunk-Y22GX76Y.js}

@@ -1,7 +1,7 @@
 import {
   badgeSchema,
   pointLedgerReferenceSchema
-} from "./chunk-WSOUOG6S.js";
+} from "./chunk-SKBZ7UVZ.js";
 import {
   authoringIdentityShape,
   entitlementSchema,
@@ -14,6 +14,7 @@ import {
   prerequisiteSchema,
   publishedReleaseSchema,
   questPresentationContentSchema,
+  questScaleLimits,
   responseShape,
   retryCooldownMsSchema,
   reviewModeSchema,
@@ -22,7 +23,7 @@ import {
   storedQuestDescriptionSchema,
   storedReviewModeSchema,
   tieredRewardReferenceSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/participant-activity.ts
 import * as z from "zod";
@@ -170,8 +171,8 @@ var questInstanceSchema = z2.object({
 var questDraftChangesSchema = z2.object({
   quests: z2.array(
     questInstanceSchema.extend({ expectedRelease: identifier.nullable() })
-  ).max(50),
-  collections: z2.array(questCollectionSchema.omit({ archivedAt: true })).max(50)
+  ).max(questScaleLimits.quests),
+  collections: z2.array(questCollectionSchema.omit({ archivedAt: true })).max(questScaleLimits.collections)
 }).strict();
 var draftBase = z2.object({
   id: identifier,
@@ -207,8 +208,8 @@ var catalogDeploymentSchema = z2.object({
       runtime: sdkRuntimeReferenceSchema.optional(),
       provider: reviewModeSchema
     })
-  ).max(50).default([]),
-  collections: z2.array(collectionSlotDeclarationSchema).max(50).default([]),
+  ).max(questScaleLimits.questTypes).default([]),
+  collections: z2.array(collectionSlotDeclarationSchema).max(questScaleLimits.collections).default([]),
   supportedInteractions: z2.array(interactionSchema).min(1).optional()
 }).strict();
 var catalogDeploymentPreviewSchema = responseShape(

package/dist/{chunk-REANELDK.js → chunk-ZRTNPNNG.js}

@@ -4,20 +4,20 @@ import {
   retryAfter,
   retrying,
   validTimeout
-} from "./chunk-NNGGEUMQ.js";
+} from "./chunk-WE6LLVR5.js";
 import {
   clientIdentity
-} from "./chunk-ZNFAIBTJ.js";
+} from "./chunk-OXIXMXFB.js";
 import {
   authScopeSchema
-} from "./chunk-Q5PX3GDA.js";
+} from "./chunk-KHFDDXAM.js";
 import {
   RequestError,
   appIdentityKindSchema,
   isRequestError,
   knownResponse,
   openIdentityKindSchema
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 
 // src/configuration.ts
 function questConfiguration(release) {

package/dist/index.js

@@ -5,22 +5,22 @@ import {
 import {
   QuestUpdatedError,
   createRelayClient
-} from "./chunk-RXM7LBLH.js";
+} from "./chunk-SESHFICW.js";
 import {
   createRelayAction
-} from "./chunk-UOHYYB7V.js";
+} from "./chunk-EC5MEEZD.js";
 import {
   QuestOutcomeState
-} from "./chunk-TEPZZXDI.js";
+} from "./chunk-Y22GX76Y.js";
 import {
   PointEntryKind
-} from "./chunk-WSOUOG6S.js";
-import "./chunk-J7YJHMF7.js";
-import "./chunk-NNGGEUMQ.js";
-import "./chunk-ZNFAIBTJ.js";
+} from "./chunk-SKBZ7UVZ.js";
+import "./chunk-TJ2OH3MQ.js";
+import "./chunk-WE6LLVR5.js";
+import "./chunk-OXIXMXFB.js";
 import {
   sessionMember
-} from "./chunk-Q5PX3GDA.js";
+} from "./chunk-KHFDDXAM.js";
 import {
   AttemptStatus,
   RelayError,
@@ -29,7 +29,7 @@ import {
   isRelayError,
   isRequestError,
   paginate
-} from "./chunk-PMSCHJKX.js";
+} from "./chunk-DJAIFEV4.js";
 export {
   AttemptStatus,
   PointEntryKind,