@domino-sdk/relay 1.0.0-next.9 → 1.0.0

package/dist/browser.js

@@ -11,12 +11,14 @@ import {
   signInOptions,
   solanaSigner,
   walletStandardSolanaSigner
-} from "./chunk-P6FK43GG.js";
-import "./chunk-X2F2RAR3.js";
-import "./chunk-QR7ZA2BJ.js";
-import "./chunk-PHU5VDLR.js";
-import "./chunk-7Q4BGGT6.js";
-import "./chunk-YYD4QUBO.js";
+} from "./chunk-ZVIRG24J.js";
+import "./chunk-GZ6FJAXN.js";
+import "./chunk-EYH5RDIE.js";
+import "./chunk-36HTX2BM.js";
+import "./chunk-6QJ3LADK.js";
+import "./chunk-NPGENI7K.js";
+import "./chunk-XFMSUPNS.js";
+import "./chunk-JON5SESL.js";
 export {
   browserSubmissionStore,
   cosmosChainList,

package/dist/{integrations-Ba5TtqTv.d.ts → capability-error-DNMwKmlL.d.ts}

@@ -3,7 +3,7 @@ import { z } from 'zod';
 declare const resourceSourceSchema: z.ZodUnion<readonly [z.ZodObject<{
     provider: z.ZodLiteral<"domino">;
     resource: z.ZodLiteral<"point-ledger">;
-}, z.core.$strict>, z.ZodObject<{
+}, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
     provider: z.ZodLiteral<"discord">;
     resource: z.ZodLiteral<"channel">;
     types: z.ZodArray<z.ZodEnum<{
@@ -14,13 +14,13 @@ declare const resourceSourceSchema: z.ZodUnion<readonly [z.ZodObject<{
     provider: z.ZodLiteral<"discord">;
     resource: z.ZodLiteral<"role">;
     assignable: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strict>]>;
+}, z.core.$strict>]>]>;
 type ResourceSource = z.infer<typeof resourceSourceSchema>;
 declare const resourceRequestSchema: z.ZodObject<{
     source: z.ZodUnion<readonly [z.ZodObject<{
         provider: z.ZodLiteral<"domino">;
         resource: z.ZodLiteral<"point-ledger">;
-    }, z.core.$strict>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
         provider: z.ZodLiteral<"discord">;
         resource: z.ZodLiteral<"channel">;
         types: z.ZodArray<z.ZodEnum<{
@@ -31,7 +31,7 @@ declare const resourceRequestSchema: z.ZodObject<{
         provider: z.ZodLiteral<"discord">;
         resource: z.ZodLiteral<"role">;
         assignable: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strict>]>;
+    }, z.core.$strict>]>]>;
     query: z.ZodOptional<z.ZodString>;
     cursor: z.ZodOptional<z.ZodString>;
     ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -51,7 +51,7 @@ type ResourceOption = z.infer<typeof resourceOptionsSchema>["options"][number];
 
 declare const settingFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"point-ledger">;
-    default: z.ZodString;
+    default: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
@@ -65,7 +65,7 @@ declare const settingFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     source: z.ZodUnion<readonly [z.ZodObject<{
         provider: z.ZodLiteral<"domino">;
         resource: z.ZodLiteral<"point-ledger">;
-    }, z.core.$strict>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
         provider: z.ZodLiteral<"discord">;
         resource: z.ZodLiteral<"channel">;
         types: z.ZodArray<z.ZodEnum<{
@@ -76,7 +76,7 @@ declare const settingFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         provider: z.ZodLiteral<"discord">;
         resource: z.ZodLiteral<"role">;
         assignable: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strict>]>;
+    }, z.core.$strict>]>]>;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
@@ -122,7 +122,7 @@ declare const settingFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 type SettingField = z.infer<typeof settingFieldSchema>;
 declare const settingsFieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"point-ledger">;
-    default: z.ZodString;
+    default: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
@@ -136,7 +136,7 @@ declare const settingsFieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedU
     source: z.ZodUnion<readonly [z.ZodObject<{
         provider: z.ZodLiteral<"domino">;
         resource: z.ZodLiteral<"point-ledger">;
-    }, z.core.$strict>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
         provider: z.ZodLiteral<"discord">;
         resource: z.ZodLiteral<"channel">;
         types: z.ZodArray<z.ZodEnum<{
@@ -147,7 +147,7 @@ declare const settingsFieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedU
         provider: z.ZodLiteral<"discord">;
         resource: z.ZodLiteral<"role">;
         assignable: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strict>]>;
+    }, z.core.$strict>]>]>;
     label: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
@@ -276,54 +276,54 @@ declare const xRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 type XConnection = z.infer<typeof xConnectionSchema>;
 type XProfile = z.infer<typeof xProfileSchema>;
 type XPost = z.infer<typeof xPostSchema>;
+/**
+ * Reads the member's linked X account and public X data. The account is pinned at the attempt's
+ * first X read: later links and unlinks do not change the attempt. `connection()`, `profile()`,
+ * `follows()` and `reposted()` resolve to `null` when the member has no linked X account;
+ * `post()` reads any public post and resolves to `null` when it does not exist. Provider failures
+ * throw `CapabilityError` with code `"provider-unavailable"`.
+ */
 interface XReader {
     connection(): Promise<XConnection | null>;
-    profile(): Promise<XProfile>;
+    profile(): Promise<XProfile | null>;
     post(input: {
         postId: string;
-    }): Promise<XPost>;
+    }): Promise<XPost | null>;
     follows(input: {
         userId: string;
-    }): Promise<boolean>;
+    }): Promise<boolean | null>;
     reposted(input: {
         postId: string;
-    }): Promise<boolean>;
+    }): Promise<boolean | null>;
 }
 
-declare const observationInputSchema: z.ZodObject<{
-    id: z.ZodString;
-    source: z.ZodString;
-    type: z.ZodString;
-    member: z.ZodString;
-    actor: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodString;
-        subject: z.ZodString;
-    }, z.core.$strict>>;
-    occurredAt: z.ZodNumber;
-    data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
-}, z.core.$strict>;
-declare const observationSchema: z.ZodObject<{
-    id: z.ZodString;
-    source: z.ZodString;
-    type: z.ZodString;
-    member: z.ZodString;
-    actor: z.ZodOptional<z.ZodObject<{
-        provider: z.ZodString;
-        subject: z.ZodString;
-    }, z.core.$strict>>;
-    occurredAt: z.ZodNumber;
-    data: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
-    receivedAt: z.ZodNumber;
-}, z.core.$strict>;
-type Observation = z.infer<typeof observationSchema>;
-declare const observationTriggerSchema: z.ZodObject<{
-    source: z.ZodString;
-    type: z.ZodString;
-}, z.core.$strict>;
 declare const completionPolicySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"streak">;
     days: z.ZodNumber;
-    timeZone: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"progress">;
+    goal: z.ZodObject<{
+        kind: z.ZodLiteral<"count">;
+        count: z.ZodNumber;
+    }, z.core.$strict>;
+    window: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"lifetime">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"calendar">;
+        period: z.ZodEnum<{
+            day: "day";
+            week: "week";
+            month: "month";
+        }>;
+        latenessMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"rolling">;
+        durationMs: z.ZodNumber;
+    }, z.core.$strict>], "kind">;
+    repeat: z.ZodDefault<z.ZodEnum<{
+        repeat: "repeat";
+        once: "once";
+    }>>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"once">;
 }, z.core.$strict>, z.ZodObject<{
@@ -337,9 +337,10 @@ declare const budgetSchema: z.ZodObject<{
         project: "project";
     }>;
     period: z.ZodEnum<{
-        day: "day";
         lifetime: "lifetime";
+        day: "day";
         week: "week";
+        month: "month";
     }>;
     limit: z.ZodNumber;
     cost: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
@@ -347,36 +348,16 @@ declare const budgetSchema: z.ZodObject<{
     }, z.core.$strict>]>;
 }, z.core.$strict>;
 type Budget = z.infer<typeof budgetSchema>;
-declare const observationReceiptSchema: z.ZodObject<{
-    id: z.ZodString;
-    source: z.ZodString;
-    attempts: z.ZodArray<z.ZodString>;
-    receivedAt: z.ZodNumber;
-}, z.core.$strip>;
-declare const discordReactionSchema: z.ZodObject<{
-    guildId: z.ZodString;
-    channelId: z.ZodString;
-    messageId: z.ZodString;
-    userId: z.ZodString;
-    messageAuthorId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    actorRoles: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    emoji: z.ZodObject<{
-        id: z.ZodNullable<z.ZodString>;
-        name: z.ZodString;
-    }, z.core.$strip>;
-    messagePublishedAt: z.ZodNumber;
-}, z.core.$strict>;
-declare const discordMessageSchema: z.ZodObject<{
-    guildId: z.ZodString;
-    channelId: z.ZodString;
-    messageId: z.ZodString;
-    userId: z.ZodString;
-    content: z.ZodNullable<z.ZodString>;
-    replyTo: z.ZodNullable<z.ZodString>;
-    publishedAt: z.ZodNumber;
-}, z.core.$strict>;
-type DiscordMessage = z.infer<typeof discordMessageSchema>;
 
+/** Modules a quest can declare to enable provider readers. Project connections are separate. */
+declare const evaluatorIntegrationProviderSchema: z.ZodEnum<{
+    discord: "discord";
+    x: "x";
+}>;
+type EvaluatorIntegrationProvider = z.infer<typeof evaluatorIntegrationProviderSchema>;
+type IntegrationModule = {
+    readonly provider: EvaluatorIntegrationProvider;
+};
 declare const integrationProviderSchema: z.ZodEnum<{
     discord: "discord";
 }>;
@@ -407,4 +388,71 @@ declare const projectIntegrationSchema: z.ZodObject<{
 }, z.core.$strip>;
 type ProjectIntegration = z.infer<typeof projectIntegrationSchema>;
 
-export { settingsFieldsSchema as A, type Budget as B, settingsValuesSchema as C, type DiscordMessage as D, xConnectionSchema as E, xIdSchema as F, xPostSchema as G, xProfileSchema as H, type IntegerSettings as I, xRequestSchema as J, type Observation as O, type ProjectIntegration as P, type ResourceSource as R, type Setting as S, type XReader as X, type IntegrationProvider as a, type ResourceOption as b, type SettingField as c, type SettingsValues as d, type XConnection as e, type XPost as f, type XProfile as g, budgetSchema as h, compatibleSettingKinds as i, completionKeySchema as j, completionPolicySchema as k, discordMessageSchema as l, discordReactionSchema as m, discordServerSchema as n, observationTriggerSchema as o, integrationProviderSchema as p, missingResourceSettings as q, observationInputSchema as r, observationReceiptSchema as s, observationSchema as t, parseSettings as u, projectIntegrationSchema as v, resourceOptionsSchema as w, resourceRequestSchema as x, resourceSourceSchema as y, settingFieldSchema as z };
+/**
+ * Why an evaluator capability could not answer:
+ *
+ * - `not-linked`: the call needs a member account that is not linked, and its result cannot be
+ *   null, such as an image check of the member's X profile picture. Readers of the member's own
+ *   accounts return `null` instead.
+ * - `provider-unavailable`: the provider (X, Discord, a chain RPC, AI review) did not answer, or
+ *   the project's integration cannot reach it.
+ * - `author-error`: the call cannot be answered as written: invalid input, an undeclared
+ *   integration, an unknown tracker, a chain Relay does not read, a wallet the member never
+ *   linked, or an image that does not exist.
+ *
+ * Later versions can add codes. Treat an unknown code as a failure its `message` explains.
+ */
+declare const capabilityErrorCodes: readonly ["not-linked", "provider-unavailable", "author-error"];
+type KnownCapabilityErrorCode = (typeof capabilityErrorCodes)[number];
+/** A known code, or one a newer Relay added. */
+type CapabilityErrorCode = KnownCapabilityErrorCode | (string & {});
+/**
+ * A capability failure as it crosses the sandbox boundary and as Relay captures it. Open, so a
+ * newer Relay can add codes and fields without breaking an older evaluator or Worker.
+ */
+declare const capabilityFailureSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    /**
+     * True when Relay retries the attempt if the error reaches it uncaught, and calls the provider
+     * again. A failure that is not retryable is captured (or follows from the attempt's pinned
+     * inputs), so every run of the attempt sees it again. A retryable failure that quest code
+     * handles and moves past is final for the attempt; one that escapes the evaluation is retried.
+     */
+    retryable: z.ZodBoolean;
+}, z.core.$loose>;
+type CapabilityFailure = z.infer<typeof capabilityFailureSchema>;
+/**
+ * Thrown by an evaluator capability (`ctx.x`, `ctx.discord`, `ctx.wallet`, `ctx.trackers`,
+ * `ctx.images`, `ctx.review`) that could not answer. A capability whose subject is missing (an
+ * account the member has not linked, a deleted post or message) returns `null` instead of
+ * throwing.
+ *
+ * Catch it to decide yourself; rethrow anything else. An uncaught retryable error makes Relay
+ * retry the attempt later; an uncaught one that is not retryable fails it.
+ *
+ * ```ts
+ * try {
+ *   return (await ctx.x.follows({ userId })) ? decision.accept() : decision.reject({ reason })
+ * } catch (error) {
+ *   if (error instanceof CapabilityError && error.code === "provider-unavailable")
+ *     return decision.review({ reason: "X is unavailable" })
+ *   throw error
+ * }
+ * ```
+ */
+declare class CapabilityError extends Error {
+    readonly code: CapabilityErrorCode;
+    readonly retryable: boolean;
+    constructor(code: CapabilityErrorCode, message: string, options?: {
+        retryable?: boolean;
+    });
+    static [Symbol.hasInstance](value: unknown): boolean;
+    /**
+     * The error for a captured or transported failure. A code this SDK does not know is never
+     * retryable: nothing tells it a retry would help.
+     */
+    static from(failure: CapabilityFailure): CapabilityError;
+}
+
+export { settingsValuesSchema as A, type Budget as B, type CapabilityErrorCode as C, xConnectionSchema as D, type EvaluatorIntegrationProvider as E, xIdSchema as F, xPostSchema as G, xProfileSchema as H, type IntegerSettings as I, xRequestSchema as J, type KnownCapabilityErrorCode as K, CapabilityError as L, type ProjectIntegration as P, type ResourceOption as R, type Setting as S, type XConnection as X, type CapabilityFailure as a, type IntegrationModule as b, type IntegrationProvider as c, type ResourceSource as d, type SettingField as e, type SettingsValues as f, type XPost as g, type XProfile as h, type XReader as i, budgetSchema as j, capabilityErrorCodes as k, capabilityFailureSchema as l, compatibleSettingKinds as m, completionKeySchema as n, completionPolicySchema as o, discordServerSchema as p, evaluatorIntegrationProviderSchema as q, integrationProviderSchema as r, missingResourceSettings as s, parseSettings as t, projectIntegrationSchema as u, resourceOptionsSchema as v, resourceRequestSchema as w, resourceSourceSchema as x, settingFieldSchema as y, settingsFieldsSchema as z };