@domino-sdk/relay 0.7.0 → 0.8.0

package/dist/authoring.d.ts

@@ -1,5 +1,5 @@
-import { O as Observation, D as DiscordMember, a as DiscordMessage, W as WalletConnection, S as SolanaBalance, o as observationTriggerSchema, B as Budget, I as IntegrationProvider } from './settings-CU_oBcx0.js';
-export { d as defineLeaderboard, b as defineReferral, c as discord, s as settings } from './settings-CU_oBcx0.js';
+import { O as Observation, D as DiscordMember, a as DiscordMessage, W as WalletConnection, S as SolanaBalance, o as observationTriggerSchema, B as Budget, A as AuthoringIdentity, I as IntegrationProvider } from './settings-BA8XjT4m.js';
+export { d as defineLeaderboard, b as defineReferral, c as discord, p as pointLedgers, s as settings } from './settings-BA8XjT4m.js';
 import { z } from 'zod';
 import { PhotoResult, rewardSchema, triggerSchema, QuestPresentation, QuizEvidence, Decision, TieredRewardDefinition } from './schema.js';
 
@@ -68,9 +68,7 @@ declare const keyed: (key: (ctx: {
         eligibleAt: number;
     }) => string;
 };
-declare const completed: (quest: {
-    id: string;
-} | string) => {
+declare const completed: (quest: AuthoringIdentity | string) => {
     quest: string;
     scope: "ever";
 };
@@ -80,7 +78,9 @@ declare const untracked: () => {
 declare const staffHandover: () => {
     kind: "staff-handover";
 };
-declare function defineTieredReward(input: TieredRewardDefinition): {
+declare function defineTieredReward(input: Omit<TieredRewardDefinition, "id"> & AuthoringIdentity): {
+    key: string;
+    /** @deprecated Authoring key alias. Use key. */
     id: string;
     tier: (tier: string) => {
         kind: "tier";
@@ -177,8 +177,7 @@ type QuestInput<T extends Trigger> = T extends {
 } : T extends {
     input: "quiz";
 } ? QuizEvidence : Record<string, never>;
-declare function defineQuest<T extends Record<string, z.ZodType>, const G extends Trigger>(definition: {
-    id: string;
+declare function defineQuest<T extends Record<string, z.ZodType>, const G extends Trigger>(definition: AuthoringIdentity & {
     title: string | ((ctx: {
         settings: z.output<z.ZodObject<T>>;
     }) => string);
@@ -202,6 +201,8 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
     }) => Reward[]);
     evaluate?: Evaluator<z.output<z.ZodObject<T>>, QuestInput<G>>;
 }): {
+    key: string;
+    /** @deprecated Authoring key alias. Use key. */
     id: string;
     describe: (input: unknown) => {
         quest: string;
@@ -242,6 +243,9 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
             kind: "resource";
             default: string;
             source: {
+                provider: "domino";
+                resource: "point-ledger";
+            } | {
                 provider: "discord";
                 resource: "channel";
                 types: ("text" | "announcement")[];
@@ -365,7 +369,7 @@ declare function defineQuest<T extends Record<string, z.ZodType>, const G extend
         humanReview: boolean;
     }): Promise<Decision>;
 };
-/** Publish this artifact as a reusable type. Its id identifies the type;
+/** Publish this artifact as a reusable type. Its key names the type;
  * Console instances receive independent quest identities and pinned versions. */
 declare const defineQuestType: typeof defineQuest;
 

package/dist/authoring.js

@@ -1,13 +1,15 @@
 import {
+  authoringKey,
   defineLeaderboard,
   defineReferral
-} from "./chunk-TYVT5BPZ.js";
+} from "./chunk-XVHWBZRG.js";
 import {
   budgetSchema,
   decisionSchema,
   discord,
   integrationRewardSchema,
   parseSettings,
+  pointLedgers,
   pointsRewardSchema,
   questDescriptionSchema,
   quizAnswersSchema,
@@ -16,7 +18,7 @@ import {
   settings,
   tierRewardSchema,
   tieredRewardDefinitionSchema
-} from "./chunk-6QUCADMF.js";
+} from "./chunk-Z43O273V.js";
 
 // src/authoring.ts
 import { z } from "zod";
@@ -45,14 +47,18 @@ var automatic = (observation) => ({
 var budget = (definition) => budgetSchema.parse(definition);
 var keyed = (key) => ({ kind: "keyed", key });
 var completed = (quest) => ({
-  quest: typeof quest === "string" ? quest : quest.id,
+  quest: typeof quest === "string" ? quest : authoringKey(quest),
   scope: "ever"
 });
 var untracked = () => ({ kind: "untracked" });
 var staffHandover = () => ({ kind: "staff-handover" });
 function defineTieredReward(input) {
-  const reward = tieredRewardDefinitionSchema.parse(input);
+  const { key: _, id: __, ...properties } = input;
+  const key = authoringKey(input);
+  const reward = tieredRewardDefinitionSchema.parse({ id: key, ...properties });
   return {
+    key: reward.id,
+    /** @deprecated Authoring key alias. Use key. */
     id: reward.id,
     tier: (tier) => tierRewardSchema.parse({ kind: "tier", reward, tier })
   };
@@ -99,11 +105,12 @@ var evaluators = {
   }
 };
 function defineQuest(definition) {
+  const key = authoringKey(definition);
   if (definition.trigger.kind === "manual" && definition.trigger.input !== "none" && !definition.evaluate)
     throw new Error("Evidence quests require an evaluator");
   const fields = Object.fromEntries(
-    Object.entries(definition.settings.shape).map(([key, schema]) => [
-      key,
+    Object.entries(definition.settings.shape).map(([key2, schema]) => [
+      key2,
       settingFieldSchema.parse(schema.meta())
     ])
   );
@@ -114,7 +121,7 @@ function defineQuest(definition) {
       typeof definition.rewards === "function" ? definition.rewards({ settings: settings2 }) : definition.rewards
     );
     return questDescriptionSchema.parse({
-      quest: definition.id,
+      quest: key,
       runtimeVersion: 2,
       title: typeof definition.title === "function" ? definition.title({ settings: settings2 }) : definition.title,
       presentation: definition.presentation?.({ settings: settings2 }) ?? {},
@@ -130,7 +137,7 @@ function defineQuest(definition) {
             (reward) => reward.kind === "integration" ? [reward.provider] : []
           ),
           ...Object.values(fields).flatMap(
-            (field) => field.kind === "resource" ? [field.source.provider] : []
+            (field) => field.kind === "resource" && field.source.provider !== "domino" ? [field.source.provider] : []
           )
         ])
       ],
@@ -141,7 +148,9 @@ function defineQuest(definition) {
     });
   }
   return {
-    id: definition.id,
+    key,
+    /** @deprecated Authoring key alias. Use key. */
+    id: key,
     describe,
     async evaluate(ctx) {
       const settings2 = definition.settings.parse(ctx.settings);
@@ -186,6 +195,7 @@ export {
   keyed,
   manual,
   once,
+  pointLedgers,
   points,
   settings,
   staffHandover,

package/dist/browser.d.ts

@@ -1,6 +1,6 @@
 import { SubmitInput, ReviewListOptions, MemberListOptions, ReleaseInput, beginHandoverSchema } from './schema.js';
 import { SubmissionStore, createRelayClient, QuestView, QuestController, ProgressObservation, questExperienceSchema, ProgressObserver, ExchangeInput, PhotoSubmission, QuizSubmission, ClaimSubmission } from './index.js';
-import { r as referralAcceptSchema, L as LeaderboardQuery, w as walletChallengeInputSchema, e as walletProofSchema, A as AuthProvider } from './settings-CU_oBcx0.js';
+import { r as referralAcceptSchema, L as LeaderboardQuery, w as walletChallengeInputSchema, e as walletProofSchema, f as AuthProvider } from './settings-BA8XjT4m.js';
 import * as zod from 'zod';
 
 /** Browser client with durable submission recovery; safe to construct during SSR. */
@@ -99,6 +99,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 durationDays?: number | undefined;
                 maxPoints?: number | undefined;
             }[];
+            key?: string | undefined;
             inviterGroup?: string | undefined;
         }[]>;
         summary: () => Promise<{
@@ -198,6 +199,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                         durationDays?: number | undefined;
                         maxPoints?: number | undefined;
                     }[];
+                    key?: string | undefined;
                     inviterGroup?: string | undefined;
                 };
                 qualified: number;
@@ -274,6 +276,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 };
             };
             access: "participants" | "public";
+            key?: string | undefined;
             group?: string | undefined;
         }[]>;
         standings: (board: string, options?: LeaderboardQuery) => Promise<{
@@ -442,6 +445,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
             rewards: {
                 label: string;
             }[];
+            key?: string | undefined;
         }>;
         retry: (view: QuestView) => Promise<{
             id: string;
@@ -621,6 +625,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 rewards: {
                     label: string;
                 }[];
+                key?: string | undefined;
             }[];
             collections: {
                 id: string;
@@ -754,7 +759,9 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     rewards: {
                         label: string;
                     }[];
+                    key?: string | undefined;
                 }[];
+                key?: string | undefined;
             }[];
         }>;
         collection: (id: string) => Promise<{
@@ -889,7 +896,9 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 rewards: {
                     label: string;
                 }[];
+                key?: string | undefined;
             }[];
+            key?: string | undefined;
         }>;
         open: (view: QuestView) => Promise<QuestController>;
         observe: (listener: (value: ProgressObservation<zod.infer<typeof questExperienceSchema>>) => void, options?: {
@@ -1208,6 +1217,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                         release?: string | undefined;
                     } | undefined;
                 } | null;
+                key?: string | undefined;
                 release?: string | undefined;
             }[];
             entitlements: ({
@@ -1487,6 +1497,9 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     provider: "discord";
                     resource: "channel";
                     types: ("text" | "announcement")[];
+                } | {
+                    provider: "domino";
+                    resource: "point-ledger";
                 } | {
                     provider: "discord";
                     resource: "role";
@@ -1595,7 +1608,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
             budgets: {
                 id: string;
                 scope: "project" | "member";
-                period: "day" | "lifetime";
+                period: "lifetime" | "day";
                 limit: number;
                 cost: number | {
                     balance: string;
@@ -1647,6 +1660,9 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     provider: "discord";
                     resource: "channel";
                     types: ("text" | "announcement")[];
+                } | {
+                    provider: "domino";
+                    resource: "point-ledger";
                 } | {
                     provider: "discord";
                     resource: "role";
@@ -1755,7 +1771,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
             budgets: {
                 id: string;
                 scope: "project" | "member";
-                period: "day" | "lifetime";
+                period: "lifetime" | "day";
                 limit: number;
                 cost: number | {
                     balance: string;
@@ -1806,6 +1822,9 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     provider: "discord";
                     resource: "channel";
                     types: ("text" | "announcement")[];
+                } | {
+                    provider: "domino";
+                    resource: "point-ledger";
                 } | {
                     provider: "discord";
                     resource: "role";
@@ -1914,7 +1933,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
             budgets: {
                 id: string;
                 scope: "project" | "member";
-                period: "day" | "lifetime";
+                period: "lifetime" | "day";
                 limit: number;
                 cost: number | {
                     balance: string;
@@ -1926,6 +1945,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
             createdAt: number;
             legacy: boolean;
             lifecycle: "active" | "paused" | "archived";
+            key?: string | undefined;
             origin?: {
                 typeVersion: string;
             } | undefined;
@@ -2139,6 +2159,9 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 provider: "discord";
                 resource: "channel";
                 types: ("text" | "announcement")[];
+            } | {
+                provider: "domino";
+                resource: "point-ledger";
             } | {
                 provider: "discord";
                 resource: "role";
@@ -2247,7 +2270,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
         budgets: {
             id: string;
             scope: "project" | "member";
-            period: "day" | "lifetime";
+            period: "lifetime" | "day";
             limit: number;
             cost: number | {
                 balance: string;
@@ -2259,6 +2282,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
         createdAt: number;
         legacy: boolean;
         lifecycle: "active" | "paused" | "archived";
+        key?: string | undefined;
         origin?: {
             typeVersion: string;
         } | undefined;
@@ -2326,6 +2350,9 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                 provider: "discord";
                 resource: "channel";
                 types: ("text" | "announcement")[];
+            } | {
+                provider: "domino";
+                resource: "point-ledger";
             } | {
                 provider: "discord";
                 resource: "role";
@@ -2434,7 +2461,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
         budgets: {
             id: string;
             scope: "project" | "member";
-            period: "day" | "lifetime";
+            period: "lifetime" | "day";
             limit: number;
             cost: number | {
                 balance: string;
@@ -2446,6 +2473,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
         createdAt: number;
         legacy: boolean;
         lifecycle: "active" | "paused" | "archived";
+        key?: string | undefined;
         origin?: {
             typeVersion: string;
         } | undefined;
@@ -2596,6 +2624,7 @@ declare function createBrowserRelayClient(options: Parameters<typeof createRelay
                     release?: string | undefined;
                 } | undefined;
             } | null;
+            key?: string | undefined;
             release?: string | undefined;
         }[];
         entitlements: ({

package/dist/browser.js

@@ -1,9 +1,9 @@
 import {
   createRelayClient
-} from "./chunk-LXLNC4CN.js";
-import "./chunk-TYVT5BPZ.js";
-import "./chunk-36LZ3IOO.js";
-import "./chunk-6QUCADMF.js";
+} from "./chunk-APMYDKEX.js";
+import "./chunk-XVHWBZRG.js";
+import "./chunk-2BN7XZH3.js";
+import "./chunk-Z43O273V.js";
 
 // src/browser.ts
 function createBrowserRelayClient(options) {

package/dist/{chunk-36LZ3IOO.js → chunk-2BN7XZH3.js}

@@ -1,6 +1,6 @@
 import {
   identifier
-} from "./chunk-6QUCADMF.js";
+} from "./chunk-Z43O273V.js";
 
 // src/auth.ts
 import { z } from "zod";

package/dist/{chunk-LXLNC4CN.js → chunk-APMYDKEX.js}

@@ -1,21 +1,24 @@
 import {
+  authoringIdentityShape,
   leaderboardArtifactSchema,
   leaderboardDefinitionSchema,
   leaderboardPageSchema,
   leaderboardPreviewSchema,
   leaderboardQuerySchema,
+  normalizeAuthoringIdentity,
   publishedReferralSchema,
   referralAcceptSchema,
   referralArtifactSchema,
   referralDefinitionSchema,
   referralHistorySchema,
-  referralSummarySchema
-} from "./chunk-TYVT5BPZ.js";
+  referralSummarySchema,
+  validateAuthoringIdentity
+} from "./chunk-XVHWBZRG.js";
 import {
   authScopeSchema,
   exchangeResultSchema,
   sessionSchema
-} from "./chunk-36LZ3IOO.js";
+} from "./chunk-2BN7XZH3.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -39,15 +42,19 @@ import {
   settingsValuesSchema,
   snapshotSchema,
   templateSchema
-} from "./chunk-6QUCADMF.js";
+} from "./chunk-Z43O273V.js";
 
 // src/point-ledgers.ts
 import { z } from "zod";
-var pointLedgerSchema = z.object({
-  id: identifier,
+var pointLedgerPropertiesSchema = z.object({
   name: z.string().trim().min(1).max(120),
   description: z.string().trim().max(1e3).default("")
 }).strict();
+var createPointLedgerSchema = pointLedgerPropertiesSchema.extend({ actionId: identifier, key: identifier.optional() }).strict();
+var pointLedgerSchema = pointLedgerPropertiesSchema.extend({
+  id: identifier
+});
+var pointLedgerDeclarationSchema = pointLedgerPropertiesSchema.extend({ key: identifier }).strict();
 
 // src/reward-deliveries.ts
 import { z as z2 } from "zod";
@@ -70,19 +77,6 @@ var rewardDeliveriesSchema = z2.object({
   deliveries: z2.array(rewardDeliverySchema)
 });
 
-// src/resource-id.ts
-var alphabet = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
-function resourceId(prefix) {
-  let suffix = "";
-  while (suffix.length < 22) {
-    for (const byte of crypto.getRandomValues(new Uint8Array(32))) {
-      if (byte < 248) suffix += alphabet[byte % 62];
-      if (suffix.length === 22) break;
-    }
-  }
-  return `${prefix}_${suffix}`;
-}
-
 // src/catalog.ts
 import { z as z3 } from "zod";
 var interactionSchema = z3.enum([
@@ -96,6 +90,7 @@ function questInteraction(trigger) {
   return trigger.kind === "automatic" ? "automatic" : trigger.actor === "staff" ? "staff" : trigger.input === "none" ? "claim" : trigger.input;
 }
 var questTypeVersionSchema = z3.object({
+  key: identifier.optional(),
   id: identifier,
   version: identifier,
   code: z3.string(),
@@ -103,7 +98,12 @@ var questTypeVersionSchema = z3.object({
   provider: reviewModeSchema,
   createdAt: z3.number()
 });
-var collectionSlotSchema = z3.object({ id: identifier, title: z3.string().trim().min(1).max(120) }).strict();
+var collectionSlotSchema = z3.object({
+  id: identifier,
+  key: identifier.optional(),
+  title: z3.string().trim().min(1).max(120)
+}).strict();
+var collectionSlotDeclarationSchema = collectionSlotSchema.omit({ id: true }).extend(authoringIdentityShape).strict().superRefine(validateAuthoringIdentity).transform(normalizeAuthoringIdentity);
 var questCollectionSchema = collectionSlotSchema.extend({
   quests: z3.array(identifier).max(100).refine(
     (v) => new Set(v).size === v.length,
@@ -154,7 +154,7 @@ var catalogDeploymentSchema = z3.object({
       provider: reviewModeSchema
     })
   ).max(50).default([]),
-  collections: z3.array(collectionSlotSchema).max(50).default([]),
+  collections: z3.array(collectionSlotDeclarationSchema).max(50).default([]),
   supportedInteractions: z3.array(interactionSchema).min(1).optional()
 }).strict();
 var catalogDeploymentPreviewSchema = z3.object({
@@ -164,7 +164,8 @@ var catalogDeploymentPreviewSchema = z3.object({
   supportedInteractions: z3.array(interactionSchema)
 });
 var saveQuestDraftSchema = z3.object({
-  id: identifier,
+  id: identifier.optional(),
+  actionId: identifier,
   expectedRevision: z3.number().int().nonnegative(),
   baseRevision: z3.number().int().nonnegative(),
   changes: questDraftChangesSchema
@@ -179,6 +180,7 @@ var questViewSchema = memberProgressSchema.shape.quests.element.extend(
   }
 );
 var collectionViewSchema = z3.object({
+  key: identifier.optional(),
   id: identifier,
   title: z3.string(),
   quests: z3.array(questViewSchema)
@@ -193,6 +195,8 @@ var questPublicationPreviewSchema = z3.object({
   releases: z3.array(publishedReleaseSchema),
   affectedCollections: z3.array(questCollectionSchema)
 });
+var allocateQuestSchema = z3.object({ actionId: identifier }).strict();
+var allocatedQuestSchema = z3.object({ id: identifier });
 
 // src/errors.ts
 var RelayError = class extends Error {
@@ -727,16 +731,18 @@ function questConfiguration(release) {
 // src/deployments.ts
 import { z as z7 } from "zod";
 var projectCatalogArtifactSchema = catalogDeploymentSchema.omit({ expectedRevision: true }).extend({
+  pointLedgers: z7.array(pointLedgerDeclarationSchema).max(50).default([]),
   referrals: z7.array(referralArtifactSchema).max(50).default([]),
   leaderboards: z7.array(leaderboardArtifactSchema).max(50).default([])
 });
 var projectDeploymentSchema = projectCatalogArtifactSchema.extend({ releases: z7.array(releaseSchema).max(50).default([]) }).refine(
-  (value) => value.releases.length > 0 || value.leaderboards.length > 0 || value.referrals.length > 0 || value.types.length > 0 || value.collections.length > 0 || value.supportedInteractions !== void 0,
-  "No resources configured. Add quests, questTypes, leaderboards, collections, or supportedInteractions to relay.json."
+  (value) => value.pointLedgers.length > 0 || value.releases.length > 0 || value.leaderboards.length > 0 || value.referrals.length > 0 || value.types.length > 0 || value.collections.length > 0 || value.supportedInteractions !== void 0,
+  "No resources configured. Add quests, questTypes, pointLedgers, leaderboards, referrals, collections, or supportedInteractions to relay.json."
 );
 var deploymentPreviewSchema = z7.object({
   id: identifier,
   baseRevision: z7.number().int().nonnegative(),
+  pointLedgers: z7.array(pointLedgerSchema).default([]),
   releases: z7.array(publishedReleaseSchema),
   types: z7.array(questTypeVersionSchema),
   collections: z7.array(questCollectionSchema),
@@ -878,7 +884,9 @@ function createRelayClient(options) {
   }
   const experience = () => request("/v1/me/experience", questExperienceSchema);
   async function getQuest(id) {
-    const quest = (await experience()).quests.find((q) => q.quest === id);
+    const quest = (await experience()).quests.find(
+      (q) => q.quest === id || q.key === id
+    );
     if (!quest) throw new RelayError("Quest not found", 404);
     return quest;
   }
@@ -931,7 +939,7 @@ function createRelayClient(options) {
       experience,
       collection: async (id) => {
         const collection = (await experience()).collections.find(
-          (c) => c.id === id
+          (c) => c.id === id || c.key === id
         );
         if (!collection) throw new RelayError("Collection not found", 404);
         return collection;
@@ -1132,14 +1140,17 @@ function createRelayClient(options) {
 }
 
 export {
+  pointLedgerPropertiesSchema,
+  createPointLedgerSchema,
   pointLedgerSchema,
+  pointLedgerDeclarationSchema,
   rewardDeliverySchema,
   rewardDeliveriesSchema,
-  resourceId,
   interactionSchema,
   questInteraction,
   questTypeVersionSchema,
   collectionSlotSchema,
+  collectionSlotDeclarationSchema,
   questCollectionSchema,
   questInstanceSchema,
   questDraftChangesSchema,
@@ -1153,6 +1164,8 @@ export {
   collectionViewSchema,
   questExperienceSchema,
   questPublicationPreviewSchema,
+  allocateQuestSchema,
+  allocatedQuestSchema,
   RelayError,
   QuestUpdatedError,
   reconcileQuestDraft,