@fuul/mcp-server 1.4.0 → 1.6.0

package/dist/metadata-scope/types.js

@@ -0,0 +1,2 @@
+export const METADATA_VERSIONS_NOTE = 'Use published_trigger_id for live triggers (from GET customizations). published_conversion_id stays null until a published-incentives API exists; use draft_conversion_id for edits.';
+//# sourceMappingURL=types.js.map

package/dist/metadata-scope/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/metadata-scope/types.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,sBAAsB,GACjC,sLAAsL,CAAC"}

package/dist/referral-attribution/referral-attribution-handlers.d.ts

@@ -0,0 +1,14 @@
+import { type FuulApiClient } from '../http/fuul-api-client.js';
+import type { RemoveUserFromReferralCodeInput, SwapUserReferralCodeInput, UpdateUserReferrerInput } from '../tools/tool-schemas.js';
+export declare function isAlreadyRemovedMessage(message: string): boolean;
+export declare function buildUpdateUserReferrerBody(fields: Pick<UpdateUserReferrerInput, 'user_identifier' | 'user_identifier_type' | 'referrer_identifier' | 'referrer_identifier_type' | 'referral_code'>): Record<string, unknown>;
+export declare function buildDeleteReferralPath(code: string, query: {
+    user_identifier: string;
+    user_identifier_type: string;
+    referrer_identifier: string;
+    referrer_identifier_type: string;
+}): string;
+export declare function runUpdateUserReferrer(api: FuulApiClient, bearer: string, input: UpdateUserReferrerInput): Promise<unknown>;
+export declare function runRemoveUserFromReferralCode(api: FuulApiClient, bearer: string, input: RemoveUserFromReferralCodeInput): Promise<unknown>;
+export declare function runSwapUserReferralCode(api: FuulApiClient, bearer: string, input: SwapUserReferralCodeInput): Promise<unknown>;
+//# sourceMappingURL=referral-attribution-handlers.d.ts.map

package/dist/referral-attribution/referral-attribution-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referral-attribution-handlers.d.ts","sourceRoot":"","sources":["../../src/referral-attribution/referral-attribution-handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEjF,OAAO,KAAK,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAQpI,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CACV,uBAAuB,EACvB,iBAAiB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,0BAA0B,GAAG,eAAe,CAClH,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IACL,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;CAClC,GACA,MAAM,CAIR;AAED,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAUhI;AAED,wBAAsB,6BAA6B,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBhJ;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiDpI"}

package/dist/referral-attribution/referral-attribution-handlers.js

@@ -0,0 +1,106 @@
+import { assertWriteConfirmedOrDryRun } from '../agent/write-confirmation.js';
+import { ApiRequestError } from '../http/fuul-api-client.js';
+import { buildNestQueryString } from '../http/nest-query.js';
+const ALREADY_REMOVED_MESSAGES = new Set([
+    'User has not used this referral code',
+    'User referrer relationship not found',
+    'User referrer relationship does not match the referral code',
+]);
+export function isAlreadyRemovedMessage(message) {
+    return ALREADY_REMOVED_MESSAGES.has(message);
+}
+export function buildUpdateUserReferrerBody(fields) {
+    const body = {
+        user_identifier: fields.user_identifier,
+        user_identifier_type: fields.user_identifier_type,
+        referrer_identifier: fields.referrer_identifier,
+        referrer_identifier_type: fields.referrer_identifier_type,
+    };
+    if (fields.referral_code != null && fields.referral_code !== '') {
+        body.referral_code = fields.referral_code;
+    }
+    return body;
+}
+export function buildDeleteReferralPath(code, query) {
+    const qs = buildNestQueryString(query);
+    const encoded = encodeURIComponent(code);
+    return qs ? `/api/v1/referral_codes/${encoded}/referrals?${qs}` : `/api/v1/referral_codes/${encoded}/referrals`;
+}
+export async function runUpdateUserReferrer(api, bearer, input) {
+    assertWriteConfirmedOrDryRun(input);
+    const body = buildUpdateUserReferrerBody(input);
+    const path = '/api/v1/user-referrers';
+    if (input.dry_run === true) {
+        return { dry_run: true, would_put: path, body };
+    }
+    return api.putJson(path, body, { bearerToken: bearer });
+}
+export async function runRemoveUserFromReferralCode(api, bearer, input) {
+    assertWriteConfirmedOrDryRun(input);
+    const path = buildDeleteReferralPath(input.referral_code, {
+        user_identifier: input.user_identifier,
+        user_identifier_type: input.user_identifier_type,
+        referrer_identifier: input.referrer_identifier,
+        referrer_identifier_type: input.referrer_identifier_type,
+    });
+    if (input.dry_run === true) {
+        return { dry_run: true, would_delete: path, body: {} };
+    }
+    try {
+        return await api.deleteJson(path, { bearerToken: bearer, data: {} });
+    }
+    catch (e) {
+        if (e instanceof ApiRequestError && e.status === 422 && isAlreadyRemovedMessage(e.message)) {
+            return { already_removed: true, reason: e.message };
+        }
+        throw e;
+    }
+}
+export async function runSwapUserReferralCode(api, bearer, input) {
+    assertWriteConfirmedOrDryRun(input);
+    const removePath = buildDeleteReferralPath(input.from_referral_code, {
+        user_identifier: input.user_identifier,
+        user_identifier_type: input.user_identifier_type,
+        referrer_identifier: input.from_referrer_identifier,
+        referrer_identifier_type: input.from_referrer_identifier_type,
+    });
+    const putBody = buildUpdateUserReferrerBody({
+        user_identifier: input.user_identifier,
+        user_identifier_type: input.user_identifier_type,
+        referrer_identifier: input.to_referrer_identifier,
+        referrer_identifier_type: input.to_referrer_identifier_type,
+        referral_code: input.to_referral_code,
+    });
+    if (input.dry_run === true) {
+        return {
+            dry_run: true,
+            step1_remove: { would_delete: removePath, body: {} },
+            step2_assign: { would_put: '/api/v1/user-referrers', body: putBody },
+        };
+    }
+    let removeResult;
+    try {
+        removeResult = await api.deleteJson(removePath, { bearerToken: bearer, data: {} });
+    }
+    catch (e) {
+        if (e instanceof ApiRequestError && e.status === 422 && isAlreadyRemovedMessage(e.message)) {
+            removeResult = { already_removed: true, reason: e.message };
+        }
+        else {
+            throw e;
+        }
+    }
+    try {
+        const putResult = await api.putJson('/api/v1/user-referrers', putBody, { bearerToken: bearer });
+        return { remove: removeResult, assign: putResult };
+    }
+    catch (e) {
+        const assignError = e instanceof ApiRequestError ? { message: e.message, status: e.status } : { message: e instanceof Error ? e.message : String(e) };
+        return {
+            partial: true,
+            remove: removeResult,
+            assign_error: assignError,
+        };
+    }
+}
+//# sourceMappingURL=referral-attribution-handlers.js.map

package/dist/referral-attribution/referral-attribution-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"referral-attribution-handlers.js","sourceRoot":"","sources":["../../src/referral-attribution/referral-attribution-handlers.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-descriptions.d.ts

@@ -7,10 +7,10 @@ export declare const LIST_CHAINS_DESCRIPTION = "Lists supported blockchain chain
 export declare const LIST_TRIGGER_TYPES_DESCRIPTION = "Lists trigger type metadata from GET /public-api/v1/metadata/trigger-types (cached). Use ids from this response when building programs/triggers. Params: {}.";
 export declare const LIST_PAYOUT_SCHEMAS_DESCRIPTION = "Lists payout schema metadata from GET /public-api/v1/metadata/payout-schemas (cached). Params: {}.";
 export declare const LIST_PROJECTS_DESCRIPTION = "Lists dashboard projects for the current user: GET /api/v1/projects with optional ?page= (1-based) and ?query=. Example: {\"page\":1} or {\"query\":\"acme\"}.";
-export declare const GET_PROJECT_DESCRIPTION = "Loads one project: GET /api/v1/projects/:projectId. Example: {\"project_id\":\"550e8400-e29b-41d4-a716-446655440000\"}.";
-export declare const LIST_INCENTIVES_DESCRIPTION = "Lists draft incentives (conversions) for a project: GET /api/v1/projects/:projectId/incentives. Example: {\"project_id\":\"<uuid>\"}.";
-export declare const GET_INCENTIVE_DESCRIPTION = "Gets one incentive: GET /api/v1/projects/:projectId/incentives/:conversionId. Example: {\"project_id\":\"<uuid>\",\"conversion_id\":\"<uuid>\"}.";
-export declare const GET_TRIGGER_DESCRIPTION = "Gets trigger details (including triggerType for metadata checks): GET /api/v1/projects/:projectId/triggers/:triggerId. Example: {\"project_id\":\"<uuid>\",\"trigger_id\":\"<uuid>\"}.";
+export declare const GET_PROJECT_DESCRIPTION: string;
+export declare const LIST_INCENTIVES_DESCRIPTION: string;
+export declare const GET_INCENTIVE_DESCRIPTION: string;
+export declare const GET_TRIGGER_DESCRIPTION: string;
 export declare const UPDATE_PAYOUT_TERM_DESCRIPTION: string;
 export declare const UPDATE_PROJECT_TIER_DESCRIPTION: string;
 export declare const UPDATE_AUDIENCE_DESCRIPTION: string;
@@ -28,4 +28,7 @@ export declare const UPDATE_PROJECT_AFFILIATE_PUBLIC_DESCRIPTION: string;
 export declare const SEND_EVENT_DESCRIPTION: string;
 export declare const SEND_BATCH_EVENTS_DESCRIPTION: string;
 export declare const CHECK_EVENT_STATUS_DESCRIPTION: string;
+export declare const UPDATE_USER_REFERRER_DESCRIPTION: string;
+export declare const REMOVE_USER_FROM_REFERRAL_CODE_DESCRIPTION: string;
+export declare const SWAP_USER_REFERRAL_CODE_DESCRIPTION: string;
 //# sourceMappingURL=tool-descriptions.d.ts.map

package/dist/tools/tool-descriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/tool-descriptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,gBAAgB,qHAAmH,CAAC;AAEjJ,eAAO,MAAM,kBAAkB,oLACoJ,CAAC;AAEpL,eAAO,MAAM,uBAAuB,qdACgb,CAAC;AAErd,eAAO,MAAM,8BAA8B,iKACqH,CAAC;AAEjK,eAAO,MAAM,+BAA+B,uGAAuG,CAAC;AAEpJ,eAAO,MAAM,yBAAyB,mKACsH,CAAC;AAE7J,eAAO,MAAM,uBAAuB,4HACmF,CAAC;AAExH,eAAO,MAAM,2BAA2B,0IAC6F,CAAC;AAEtI,eAAO,MAAM,yBAAyB,qJACsG,CAAC;AAE7I,eAAO,MAAM,uBAAuB,2LAC8I,CAAC;AAEnL,eAAO,MAAM,8BAA8B,QAGwF,CAAC;AAEpI,eAAO,MAAM,+BAA+B,QAEyF,CAAC;AAEtI,eAAO,MAAM,2BAA2B,QAEgF,CAAC;AAEzH,eAAO,MAAM,0BAA0B,QAEgE,CAAC;AAExG,eAAO,MAAM,yCAAyC,0LAC2H,CAAC;AAElL,eAAO,MAAM,gCAAgC,mMAC+I,CAAC;AAE7L,eAAO,MAAM,2BAA2B,oQACiN,CAAC;AAE1P,eAAO,MAAM,0BAA0B,2GAA2G,CAAC;AAInJ,eAAO,MAAM,sCAAsC,QAKlC,CAAC;AAElB,eAAO,MAAM,6CAA6C,QAIzC,CAAC;AAElB,eAAO,MAAM,4CAA4C,QAIxC,CAAC;AAKlB,eAAO,MAAM,wCAAwC,QAGuC,CAAC;AAE7F,eAAO,MAAM,2CAA2C,QAG6G,CAAC;AAEtK,eAAO,MAAM,2CAA2C,QAG0D,CAAC;AAKnH,eAAO,MAAM,sBAAsB,QAY2G,CAAC;AAE/I,eAAO,MAAM,6BAA6B,QASsH,CAAC;AAEjK,eAAO,MAAM,8BAA8B,QAKyD,CAAC"}
+{"version":3,"file":"tool-descriptions.d.ts","sourceRoot":"","sources":["../../src/tools/tool-descriptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,gBAAgB,qHAAmH,CAAC;AAEjJ,eAAO,MAAM,kBAAkB,oLACoJ,CAAC;AAEpL,eAAO,MAAM,uBAAuB,qdACgb,CAAC;AAErd,eAAO,MAAM,8BAA8B,iKACqH,CAAC;AAEjK,eAAO,MAAM,+BAA+B,uGAAuG,CAAC;AAEpJ,eAAO,MAAM,yBAAyB,mKACsH,CAAC;AAE7J,eAAO,MAAM,uBAAuB,QAK+B,CAAC;AAEpE,eAAO,MAAM,2BAA2B,QAGH,CAAC;AAEtC,eAAO,MAAM,yBAAyB,QAGwB,CAAC;AAE/D,eAAO,MAAM,uBAAuB,QAGuB,CAAC;AAE5D,eAAO,MAAM,8BAA8B,QAGwF,CAAC;AAEpI,eAAO,MAAM,+BAA+B,QAEyF,CAAC;AAEtI,eAAO,MAAM,2BAA2B,QAEgF,CAAC;AAEzH,eAAO,MAAM,0BAA0B,QAEgE,CAAC;AAExG,eAAO,MAAM,yCAAyC,0LAC2H,CAAC;AAElL,eAAO,MAAM,gCAAgC,mMAC+I,CAAC;AAE7L,eAAO,MAAM,2BAA2B,oQACiN,CAAC;AAE1P,eAAO,MAAM,0BAA0B,2GAA2G,CAAC;AAInJ,eAAO,MAAM,sCAAsC,QAKlC,CAAC;AAElB,eAAO,MAAM,6CAA6C,QAIzC,CAAC;AAElB,eAAO,MAAM,4CAA4C,QAIxC,CAAC;AAKlB,eAAO,MAAM,wCAAwC,QAGuC,CAAC;AAE7F,eAAO,MAAM,2CAA2C,QAG6G,CAAC;AAEtK,eAAO,MAAM,2CAA2C,QAG0D,CAAC;AAKnH,eAAO,MAAM,sBAAsB,QAY2G,CAAC;AAE/I,eAAO,MAAM,6BAA6B,QASsH,CAAC;AAEjK,eAAO,MAAM,8BAA8B,QAKyD,CAAC;AAErG,eAAO,MAAM,gCAAgC,QAG8O,CAAC;AAE5R,eAAO,MAAM,0CAA0C,QAGiL,CAAC;AAEzO,eAAO,MAAM,mCAAmC,QAGgT,CAAC"}

package/dist/tools/tool-descriptions.js

@@ -7,10 +7,20 @@ export const LIST_CHAINS_DESCRIPTION = 'Lists supported blockchain chains from G
 export const LIST_TRIGGER_TYPES_DESCRIPTION = 'Lists trigger type metadata from GET /public-api/v1/metadata/trigger-types (cached). Use ids from this response when building programs/triggers. Params: {}.';
 export const LIST_PAYOUT_SCHEMAS_DESCRIPTION = 'Lists payout schema metadata from GET /public-api/v1/metadata/payout-schemas (cached). Params: {}.';
 export const LIST_PROJECTS_DESCRIPTION = 'Lists dashboard projects for the current user: GET /api/v1/projects with optional ?page= (1-based) and ?query=. Example: {"page":1} or {"query":"acme"}.';
-export const GET_PROJECT_DESCRIPTION = 'Loads one project: GET /api/v1/projects/:projectId. Example: {"project_id":"550e8400-e29b-41d4-a716-446655440000"}.';
-export const LIST_INCENTIVES_DESCRIPTION = 'Lists draft incentives (conversions) for a project: GET /api/v1/projects/:projectId/incentives. Example: {"project_id":"<uuid>"}.';
-export const GET_INCENTIVE_DESCRIPTION = 'Gets one incentive: GET /api/v1/projects/:projectId/incentives/:conversionId. Example: {"project_id":"<uuid>","conversion_id":"<uuid>"}.';
-export const GET_TRIGGER_DESCRIPTION = 'Gets trigger details (including triggerType for metadata checks): GET /api/v1/projects/:projectId/triggers/:triggerId. Example: {"project_id":"<uuid>","trigger_id":"<uuid>"}.';
+export const GET_PROJECT_DESCRIPTION = 'Loads one project (draft + published trigger mapping). Calls GET /api/v1/projects/:projectId and GET /api/v1/projects/:projectId/customizations in parallel. ' +
+    'Replaces triggers[] with scoped rows: ref, signature, draft_trigger_id, published_trigger_id, draft, published. ' +
+    'Stable key across versions is ref (not UUID). After publish, draft and published rows get different UUIDs for the same ref. ' +
+    'conversions[] are draft incentives with nested triggers merged the same way; published_conversion_id is null until a future published-incentives API. ' +
+    'Example: {"project_id":"550e8400-e29b-41d4-a716-446655440000"}.';
+export const LIST_INCENTIVES_DESCRIPTION = 'Lists draft incentives with published trigger IDs merged by ref. Calls GET /api/v1/projects/:projectId/incentives and GET .../customizations. ' +
+    'Each item: slug, draft_conversion_id, published_conversion_id (null for now), draft, published (null), triggers[] (scoped merge). ' +
+    'Example: {"project_id":"<uuid>"}.';
+export const GET_INCENTIVE_DESCRIPTION = 'Gets one draft incentive with scoped triggers (same merge as list_incentives). conversion_id is the **draft** conversion UUID from incentives API. ' +
+    'Use draft_trigger_id from triggers[] for PATCH update_trigger; published_trigger_id for live/prod comparisons (e.g. SQL on project.metadata_id). ' +
+    'Example: {"project_id":"<uuid>","conversion_id":"<uuid>"}.';
+export const GET_TRIGGER_DESCRIPTION = 'Gets one trigger row by UUID: GET /api/v1/projects/:projectId/triggers/:triggerId. Returns whichever row that UUID points to (draft or published copy). ' +
+    'Does not resolve project.metadata_id. Prefer get_project or get_incentive triggers[] for draft_trigger_id vs published_trigger_id by ref. ' +
+    'Example: {"project_id":"<uuid>","trigger_id":"<uuid>"}.';
 export const UPDATE_PAYOUT_TERM_DESCRIPTION = 'Updates one payout term on a draft conversion: PATCH /api/v1/projects/:projectId/conversions/:conversionId/payout_terms/:payoutTermId. ' +
     'Body is a single PayoutTermDto (use get_incentive or GET the payout term, modify, send as payout_term). dry_run then confirmed. ' +
     'Example dry_run: {"project_id":"<uuid>","conversion_id":"<uuid>","payout_term_id":"<uuid>","payout_term":{...},"dry_run":true}.';
@@ -76,4 +86,13 @@ export const CHECK_EVENT_STATUS_DESCRIPTION = 'Check if an event exists for a us
     EVENTS_SEND_RATE_LIMIT +
     RATE_LIMIT_HINT +
     ' Example: {"user_identifier":"0x...","user_identifier_type":"evm_address","event_name":"trade"}.';
+export const UPDATE_USER_REFERRER_DESCRIPTION = 'Create or overwrite a user referrer: PUT /api/v1/user-referrers (idempotent upsert). Sets user_referrers for the project inferred from the API key. Optional referral_code links referral_code_id on the row; does not create referral_code_uses or increment actual_uses. Requires project API key with service_role scope.' +
+    PROJECT_API_KEY_HINT +
+    ' dry_run then confirmed. Example dry_run (reassign KOL, no code): {"user_identifier":"0xUser...","user_identifier_type":"evm_address","referrer_identifier":"0xNewKol...","referrer_identifier_type":"evm_address","dry_run":true}. Example with code: add "referral_code":"PROMO2024".';
+export const REMOVE_USER_FROM_REFERRAL_CODE_DESCRIPTION = 'Remove a user from a referral code: DELETE /api/v1/referral_codes/:code/referrals. Atomically deletes user_referrers + referral_code_uses and decrements actual_uses. Not idempotent on the API; this tool maps known 422 cases to {"already_removed":true,"reason":"..."} for safe retries. Requires service_role project API key (no wallet signature).' +
+    PROJECT_API_KEY_HINT +
+    ' dry_run then confirmed. Example dry_run: {"referral_code":"PROMO2024","user_identifier":"0xUser...","user_identifier_type":"evm_address","referrer_identifier":"0xKol...","referrer_identifier_type":"evm_address","dry_run":true}.';
+export const SWAP_USER_REFERRAL_CODE_DESCRIPTION = 'Swap a user from one referral code to another referrer/code: DELETE from from_referral_code then PUT /api/v1/user-referrers (not a single atomic API transaction). Step 1 tolerates already-removed 422s. If PUT fails after DELETE, response includes partial:true with remove result and assign_error. Requires service_role project API key.' +
+    PROJECT_API_KEY_HINT +
+    ' dry_run then confirmed. Example dry_run: {"user_identifier":"0xUser...","user_identifier_type":"evm_address","from_referral_code":"OLD","from_referrer_identifier":"0xOldKol...","from_referrer_identifier_type":"evm_address","to_referrer_identifier":"0xNewKol...","to_referrer_identifier_type":"evm_address","to_referral_code":"NEW","dry_run":true}.';
 //# sourceMappingURL=tool-descriptions.js.map

package/dist/tools/tool-descriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-descriptions.js","sourceRoot":"","sources":["../../src/tools/tool-descriptions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,gHAAgH,CAAC;AAEjJ,MAAM,CAAC,MAAM,kBAAkB,GAC7B,iLAAiL,CAAC;AAEpL,MAAM,CAAC,MAAM,uBAAuB,GAClC,kdAAkd,CAAC;AAErd,MAAM,CAAC,MAAM,8BAA8B,GACzC,8JAA8J,CAAC;AAEjK,MAAM,CAAC,MAAM,+BAA+B,GAAG,oGAAoG,CAAC;AAEpJ,MAAM,CAAC,MAAM,yBAAyB,GACpC,0JAA0J,CAAC;AAE7J,MAAM,CAAC,MAAM,uBAAuB,GAClC,qHAAqH,CAAC;AAExH,MAAM,CAAC,MAAM,2BAA2B,GACtC,mIAAmI,CAAC;AAEtI,MAAM,CAAC,MAAM,yBAAyB,GACpC,0IAA0I,CAAC;AAE7I,MAAM,CAAC,MAAM,uBAAuB,GAClC,gLAAgL,CAAC;AAEnL,MAAM,CAAC,MAAM,8BAA8B,GACzC,yIAAyI;IACzI,kIAAkI;IAClI,iIAAiI,CAAC;AAEpI,MAAM,CAAC,MAAM,+BAA+B,GAC1C,mKAAmK;IACnK,mIAAmI,CAAC;AAEtI,MAAM,CAAC,MAAM,2BAA2B,GACtC,sRAAsR;IACtR,sHAAsH,CAAC;AAEzH,MAAM,CAAC,MAAM,0BAA0B,GACrC,2NAA2N;IAC3N,qGAAqG,CAAC;AAExG,MAAM,CAAC,MAAM,yCAAyC,GACpD,+KAA+K,CAAC;AAElL,MAAM,CAAC,MAAM,gCAAgC,GAC3C,0LAA0L,CAAC;AAE7L,MAAM,CAAC,MAAM,2BAA2B,GACtC,uPAAuP,CAAC;AAE1P,MAAM,CAAC,MAAM,0BAA0B,GAAG,wGAAwG,CAAC;AAEnJ,MAAM,eAAe,GAAG,sFAAsF,CAAC;AAE/G,MAAM,CAAC,MAAM,sCAAsC,GACjD,2GAA2G;IAC3G,2HAA2H;IAC3H,kHAAkH;IAClH,iEAAiE;IACjE,eAAe,CAAC;AAElB,MAAM,CAAC,MAAM,6CAA6C,GACxD,0GAA0G;IAC1G,yHAAyH;IACzH,gFAAgF;IAChF,eAAe,CAAC;AAElB,MAAM,CAAC,MAAM,4CAA4C,GACvD,+IAA+I;IAC/I,4HAA4H;IAC5H,wEAAwE;IACxE,eAAe,CAAC;AAElB,MAAM,oBAAoB,GACxB,wKAAwK,CAAC;AAE3K,MAAM,CAAC,MAAM,wCAAwC,GACnD,gJAAgJ;IAChJ,oBAAoB;IACpB,0FAA0F,CAAC;AAE7F,MAAM,CAAC,MAAM,2CAA2C,GACtD,sRAAsR;IACtR,oBAAoB;IACpB,mKAAmK,CAAC;AAEtK,MAAM,CAAC,MAAM,2CAA2C,GACtD,+OAA+O;IAC/O,oBAAoB;IACpB,gHAAgH,CAAC;AAEnH,MAAM,sBAAsB,GAAG,mCAAmC,CAAC;AACnE,MAAM,uBAAuB,GAAG,kCAAkC,CAAC;AAEnE,MAAM,CAAC,MAAM,sBAAsB,GACjC,yMAAyM;IACzM,uGAAuG;IACvG,oBAAoB;IACpB,sBAAsB;IACtB,eAAe;IACf,6KAA6K;IAC7K,yHAAyH;IACzH,2HAA2H;IAC3H,wHAAwH;IACxH,sIAAsI;IACtI,2IAA2I;IAC3I,4IAA4I,CAAC;AAE/I,MAAM,CAAC,MAAM,6BAA6B,GACxC,yOAAyO;IACzO,oBAAoB;IACpB,0BAA0B;IAC1B,uBAAuB;IACvB,eAAe;IACf,8KAA8K;IAC9K,uEAAuE;IACvE,kIAAkI;IAClI,8JAA8J,CAAC;AAEjK,MAAM,CAAC,MAAM,8BAA8B,GACzC,2LAA2L;IAC3L,oBAAoB;IACpB,sBAAsB;IACtB,eAAe;IACf,kGAAkG,CAAC"}
+{"version":3,"file":"tool-descriptions.js","sourceRoot":"","sources":["../../src/tools/tool-descriptions.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-schemas.d.ts

@@ -581,6 +581,8 @@ export declare const getProjectAffiliatesBreakdownSchema: z.ZodObject<{
     sortOrder?: "asc" | "desc" | undefined;
 }>;
 export type GetProjectAffiliatesBreakdownInput = z.infer<typeof getProjectAffiliatesBreakdownSchema>;
+/** Matches CreateOrUpdateUserReferrerDto / DeleteReferralQueryDto IdentifierType on fuul-server. */
+export declare const identifierTypeForReferrerSchema: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
 export declare const projectApiKeyBearerFieldsSchema: z.ZodObject<{
     project_api_key: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -3607,4 +3609,229 @@ export declare const checkEventStatusInputSchema: z.ZodObject<{
     project_api_key?: string | undefined;
 }>;
 export type CheckEventStatusInput = z.infer<typeof checkEventStatusInputSchema>;
+export declare const updateUserReferrerFieldsSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    referrer_identifier: z.ZodString;
+    referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    referral_code: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referrer_identifier: string;
+    referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    referral_code?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referrer_identifier: string;
+    referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    referral_code?: string | undefined;
+}>;
+export declare const updateUserReferrerInputSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    referrer_identifier: z.ZodString;
+    referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    referral_code: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referrer_identifier: string;
+    referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    referral_code?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referrer_identifier: string;
+    referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    referral_code?: string | undefined;
+}>;
+export type UpdateUserReferrerInput = z.infer<typeof updateUserReferrerInputSchema>;
+export declare const removeUserFromReferralCodeFieldsSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    referral_code: z.ZodString;
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    referrer_identifier: z.ZodString;
+    referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referrer_identifier: string;
+    referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referral_code: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referrer_identifier: string;
+    referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referral_code: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+}>;
+export declare const removeUserFromReferralCodeInputSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    referral_code: z.ZodString;
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    referrer_identifier: z.ZodString;
+    referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referrer_identifier: string;
+    referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referral_code: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referrer_identifier: string;
+    referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    referral_code: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+}>;
+export type RemoveUserFromReferralCodeInput = z.infer<typeof removeUserFromReferralCodeInputSchema>;
+export declare const swapUserReferralCodeFieldsSchema: z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    from_referral_code: z.ZodString;
+    from_referrer_identifier: z.ZodString;
+    from_referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    to_referrer_identifier: z.ZodString;
+    to_referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    to_referral_code: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    from_referral_code: string;
+    from_referrer_identifier: string;
+    from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referrer_identifier: string;
+    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    to_referral_code?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    from_referral_code: string;
+    from_referrer_identifier: string;
+    from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referrer_identifier: string;
+    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    to_referral_code?: string | undefined;
+}>;
+export declare const swapUserReferralCodeInputSchema: z.ZodEffects<z.ZodObject<{
+    project_api_key: z.ZodOptional<z.ZodString>;
+} & {
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    user_identifier: z.ZodString;
+    user_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    from_referral_code: z.ZodString;
+    from_referrer_identifier: z.ZodString;
+    from_referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    to_referrer_identifier: z.ZodString;
+    to_referrer_identifier_type: z.ZodEnum<["evm_address", "solana_address", "sui_address", "xrpl_address", "email", "uuid"]>;
+    to_referral_code: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    from_referral_code: string;
+    from_referrer_identifier: string;
+    from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referrer_identifier: string;
+    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    to_referral_code?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    from_referral_code: string;
+    from_referrer_identifier: string;
+    from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referrer_identifier: string;
+    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    to_referral_code?: string | undefined;
+}>, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    from_referral_code: string;
+    from_referrer_identifier: string;
+    from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referrer_identifier: string;
+    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    to_referral_code?: string | undefined;
+}, {
+    user_identifier: string;
+    user_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    from_referral_code: string;
+    from_referrer_identifier: string;
+    from_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    to_referrer_identifier: string;
+    to_referrer_identifier_type: "evm_address" | "solana_address" | "sui_address" | "xrpl_address" | "email" | "uuid";
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    project_api_key?: string | undefined;
+    to_referral_code?: string | undefined;
+}>;
+export type SwapUserReferralCodeInput = z.infer<typeof swapUserReferralCodeInputSchema>;
 //# sourceMappingURL=tool-schemas.d.ts.map

package/dist/tools/tool-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/tool-schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/tool-schemas.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-schemas.js

@@ -143,6 +143,8 @@ export const getProjectAffiliatesBreakdownSchema = z.object({
     tiers: z.array(z.string().uuid()).optional(),
 });
 const identifierTypeForAffiliateSchema = z.enum(['evm_address', 'solana_address', 'sui_address', 'xrpl_address', 'email']);
+/** Matches CreateOrUpdateUserReferrerDto / DeleteReferralQueryDto IdentifierType on fuul-server. */
+export const identifierTypeForReferrerSchema = z.enum(['evm_address', 'solana_address', 'sui_address', 'xrpl_address', 'email', 'uuid']);
 export const projectApiKeyBearerFieldsSchema = z.object({
     project_api_key: z
         .string()
@@ -319,4 +321,43 @@ export const checkEventStatusInputSchema = projectApiKeyBearerFieldsSchema.exten
     user_identifier_type: identifierTypeForAffiliateSchema,
     event_name: z.string().min(1).describe('Case-sensitive trigger name.'),
 });
+export const updateUserReferrerFieldsSchema = projectApiKeyBearerFieldsSchema.merge(writeConfirmationFieldsSchema).extend({
+    user_identifier: z.string().min(1),
+    user_identifier_type: identifierTypeForReferrerSchema,
+    referrer_identifier: z.string().min(1),
+    referrer_identifier_type: identifierTypeForReferrerSchema,
+    referral_code: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Optional referral code string; links referral_code_id on user_referrers. Does not create referral_code_uses.'),
+});
+export const updateUserReferrerInputSchema = updateUserReferrerFieldsSchema;
+export const removeUserFromReferralCodeFieldsSchema = projectApiKeyBearerFieldsSchema.merge(writeConfirmationFieldsSchema).extend({
+    referral_code: z.string().min(1).describe('Referral code the user used (path segment).'),
+    user_identifier: z.string().min(1),
+    user_identifier_type: identifierTypeForReferrerSchema,
+    referrer_identifier: z.string().min(1).describe('Owner of the referral code.'),
+    referrer_identifier_type: identifierTypeForReferrerSchema,
+});
+export const removeUserFromReferralCodeInputSchema = removeUserFromReferralCodeFieldsSchema;
+export const swapUserReferralCodeFieldsSchema = projectApiKeyBearerFieldsSchema.merge(writeConfirmationFieldsSchema).extend({
+    user_identifier: z.string().min(1),
+    user_identifier_type: identifierTypeForReferrerSchema,
+    from_referral_code: z.string().min(1),
+    from_referrer_identifier: z.string().min(1),
+    from_referrer_identifier_type: identifierTypeForReferrerSchema,
+    to_referrer_identifier: z.string().min(1),
+    to_referrer_identifier_type: identifierTypeForReferrerSchema,
+    to_referral_code: z.string().min(1).optional(),
+});
+export const swapUserReferralCodeInputSchema = swapUserReferralCodeFieldsSchema.superRefine((val, ctx) => {
+    if (val.to_referral_code != null && val.to_referral_code !== '' && val.from_referral_code === val.to_referral_code) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'from_referral_code and to_referral_code must differ when both are set',
+            path: ['to_referral_code'],
+        });
+    }
+});
 //# sourceMappingURL=tool-schemas.js.map