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

package/dist/browser.js

@@ -11,12 +11,14 @@ import {
   signInOptions,
   solanaSigner,
   walletStandardSolanaSigner
-} from "./chunk-6A6K5RUD.js";
-import "./chunk-V5R2DMGY.js";
-import "./chunk-MRIURJE3.js";
-import "./chunk-V7EZUZ3Z.js";
-import "./chunk-QBOHLT7M.js";
-import "./chunk-VARGF4JS.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/capability-error-DNMwKmlL.d.ts

@@ -0,0 +1,458 @@
+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.ZodUnion<readonly [z.ZodObject<{
+    provider: z.ZodLiteral<"discord">;
+    resource: z.ZodLiteral<"channel">;
+    types: z.ZodArray<z.ZodEnum<{
+        text: "text";
+        announcement: "announcement";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    provider: z.ZodLiteral<"discord">;
+    resource: z.ZodLiteral<"role">;
+    assignable: z.ZodDefault<z.ZodBoolean>;
+}, 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.ZodUnion<readonly [z.ZodObject<{
+        provider: z.ZodLiteral<"discord">;
+        resource: z.ZodLiteral<"channel">;
+        types: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            announcement: "announcement";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        provider: z.ZodLiteral<"discord">;
+        resource: z.ZodLiteral<"role">;
+        assignable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>]>]>;
+    query: z.ZodOptional<z.ZodString>;
+    cursor: z.ZodOptional<z.ZodString>;
+    ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+declare const resourceOptionsSchema: z.ZodObject<{
+    revision: z.ZodNumber;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
+        disabledReason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type ResourceOption = z.infer<typeof resourceOptionsSchema>["options"][number];
+
+declare const settingFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"point-ledger">;
+    default: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"datetime">;
+    default: z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"resource">;
+    default: z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>;
+    source: z.ZodUnion<readonly [z.ZodObject<{
+        provider: z.ZodLiteral<"domino">;
+        resource: z.ZodLiteral<"point-ledger">;
+    }, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+        provider: z.ZodLiteral<"discord">;
+        resource: z.ZodLiteral<"channel">;
+        types: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            announcement: "announcement";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        provider: z.ZodLiteral<"discord">;
+        resource: z.ZodLiteral<"role">;
+        assignable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>]>]>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"quiz">;
+    default: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        prompt: z.ZodString;
+        choices: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+        correct: z.ZodString;
+    }, z.core.$strict>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"text">;
+    default: z.ZodString;
+    minLength: z.ZodNumber;
+    maxLength: z.ZodNumber;
+    multiline: z.ZodBoolean;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"integer">;
+    default: z.ZodNumber;
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"boolean">;
+    default: z.ZodBoolean;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"choice">;
+    default: z.ZodString;
+    options: z.ZodArray<z.ZodString>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "kind">;
+type SettingField = z.infer<typeof settingFieldSchema>;
+declare const settingsFieldsSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"point-ledger">;
+    default: z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"datetime">;
+    default: z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"resource">;
+    default: z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>;
+    source: z.ZodUnion<readonly [z.ZodObject<{
+        provider: z.ZodLiteral<"domino">;
+        resource: z.ZodLiteral<"point-ledger">;
+    }, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+        provider: z.ZodLiteral<"discord">;
+        resource: z.ZodLiteral<"channel">;
+        types: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            announcement: "announcement";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        provider: z.ZodLiteral<"discord">;
+        resource: z.ZodLiteral<"role">;
+        assignable: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strict>]>]>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"quiz">;
+    default: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        prompt: z.ZodString;
+        choices: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>;
+        correct: z.ZodString;
+    }, z.core.$strict>>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"text">;
+    default: z.ZodString;
+    minLength: z.ZodNumber;
+    maxLength: z.ZodNumber;
+    multiline: z.ZodBoolean;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"integer">;
+    default: z.ZodNumber;
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"boolean">;
+    default: z.ZodBoolean;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"choice">;
+    default: z.ZodString;
+    options: z.ZodArray<z.ZodString>;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "kind">>;
+declare const settingsValuesSchema: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    prompt: z.ZodString;
+    choices: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strict>>;
+    correct: z.ZodString;
+}, z.core.$strict>>]>>;
+type SettingsValues = z.infer<typeof settingsValuesSchema>;
+/** Type-only marker of the builder that made a setting. It never exists at runtime. */
+declare const settingKind: unique symbol;
+/**
+ * A quest setting made by a `settings.*` builder, which records the field Console edits in the
+ * schema's metadata. Plain zod schemas are not settings.
+ */
+type Setting<K extends SettingField["kind"] = SettingField["kind"], S extends z.ZodType = z.ZodType> = S & {
+    readonly [settingKind]: K;
+};
+/** The names of a settings shape's integer settings. */
+type IntegerSettings<T> = {
+    [K in keyof T]: T[K] extends Setting<"integer"> ? K : never;
+}[keyof T] & string;
+declare function parseSettings(fields: Record<string, SettingField>, input: unknown): SettingsValues;
+declare function missingResourceSettings(fields: Record<string, SettingField>, values: SettingsValues): string[];
+declare function compatibleSettingKinds(previous: SettingField, next: SettingField): boolean;
+
+declare const xIdSchema: z.ZodString;
+declare const xConnectionSchema: z.ZodObject<{
+    userId: z.ZodString;
+}, z.core.$strip>;
+declare const xProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    username: z.ZodString;
+    name: z.ZodString;
+    bio: z.ZodNullable<z.ZodString>;
+    profileImageUrl: z.ZodNullable<z.ZodString>;
+    followersCount: z.ZodNullable<z.ZodNumber>;
+    verified: z.ZodNullable<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const xPostSchema: z.ZodObject<{
+    id: z.ZodString;
+    userId: z.ZodString;
+    content: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    author: z.ZodObject<{
+        id: z.ZodString;
+        username: z.ZodString;
+        name: z.ZodString;
+        verified: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$loose>;
+    likeCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    replyCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    retweetCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    quoteCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    viewCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    bookmarkCount: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    isReply: z.ZodBoolean;
+    isRetweet: z.ZodBoolean;
+    isQuoteTweet: z.ZodBoolean;
+    quotedTweetId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    inReplyToUserId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    inReplyToStatusId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    retweetedTweetId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | null, string | null | undefined>>;
+    media: z.ZodPipe<z.ZodUnknown, z.ZodTransform<{
+        type: string;
+        url: string;
+    }[], unknown>>;
+}, z.core.$loose>;
+declare const xRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    operation: z.ZodLiteral<"connection">;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"profile">;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"post">;
+    postId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"follows">;
+    userId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"reposted">;
+    postId: z.ZodString;
+}, z.core.$strict>], "operation">;
+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 | null>;
+    post(input: {
+        postId: string;
+    }): Promise<XPost | null>;
+    follows(input: {
+        userId: string;
+    }): Promise<boolean | null>;
+    reposted(input: {
+        postId: string;
+    }): Promise<boolean | null>;
+}
+
+declare const completionPolicySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"streak">;
+    days: z.ZodNumber;
+}, 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<{
+    kind: z.ZodLiteral<"keyed">;
+}, z.core.$strict>], "kind">;
+declare const completionKeySchema: z.ZodString;
+declare const budgetSchema: z.ZodObject<{
+    id: z.ZodString;
+    scope: z.ZodEnum<{
+        member: "member";
+        project: "project";
+    }>;
+    period: z.ZodEnum<{
+        lifetime: "lifetime";
+        day: "day";
+        week: "week";
+        month: "month";
+    }>;
+    limit: z.ZodNumber;
+    cost: z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+        balance: z.ZodString;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+type Budget = z.infer<typeof budgetSchema>;
+
+/** 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";
+}>;
+type IntegrationProvider = z.infer<typeof integrationProviderSchema>;
+declare const discordServerSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    icon: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const projectIntegrationSchema: z.ZodObject<{
+    provider: z.ZodEnum<{
+        discord: "discord";
+    }>;
+    configured: z.ZodBoolean;
+    status: z.ZodEnum<{
+        disconnected: "disconnected";
+        ready: "ready";
+        attention: "attention";
+    }>;
+    revision: z.ZodNumber;
+    server: z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        icon: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    issue: z.ZodNullable<z.ZodString>;
+    connectedAt: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type ProjectIntegration = z.infer<typeof projectIntegrationSchema>;
+
+/**
+ * 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 };