@fuul/mcp-server 0.2.0 → 1.0.0

package/README.md

@@ -187,7 +187,8 @@ mcp_server/
 │       └── skills/fuul/SKILL.md
 ├── src/                      # TypeScript source
 ├── docs/                     # Maintainer and integrator docs
-├── .github/workflows/        # ci.yml, publish.yml
+├── .github/workflows/        # ci.yml, release.yml (semantic-release; name must match npm Trusted Publishing)
+├── release.config.cjs        # semantic-release plugins and branches
 └── dist/                     # `npm run build` (gitignored)
 ```
 
@@ -198,9 +199,19 @@ mcp_server/
 
 ## CI and releases
 
-On each push/PR to `main` / `master`, GitHub Actions runs **lint**, **test**, and **build** in parallel.
+On each push/PR to `main` / `master`, GitHub Actions runs **lint**, **test**, and **build** in parallel (see [.github/workflows/ci.yml](.github/workflows/ci.yml)). Pushes to `beta` / `alpha` also run CI on those branches.
 
-Publishing to npm is triggered by publishing a **GitHub Release** (see [.github/workflows/publish.yml](.github/workflows/publish.yml)); the repository needs an `NPM_TOKEN` secret.
+## Publishing
+
+**npm** releases are performed by **semantic-release** in GitHub Actions (same approach as [fuul-sdk](https://github.com/kuyen-labs/fuul-sdk)). You do not need to create a GitHub Release manually or run `npm publish` locally for the default flow.
+
+1. **npm — [Trusted publishing](https://docs.npmjs.com/trusted-publishers) (OIDC):** [.github/workflows/release.yml](.github/workflows/release.yml) uses the same **steps and permissions** as [fuul-sdk](https://github.com/kuyen-labs/fuul-sdk)’s release job (`id-token: write`, no `NPM_TOKEN` in the workflow). The **filename** is **`release.yml`** here so it matches what you enter in npm’s trusted-publisher form (fuul-sdk uses **`versioning.yml`** instead — that name is only for that repo). On npmjs.com, **`@fuul/mcp-server`** must list workflow **`.github/workflows/release.yml`** for **`kuyen-labs` / `mcp_server`**. If npm still shows **`OIDC … 404`**, the path/org/repo in npm does not match this file.  
+   **About `NPM_TOKEN` in caps:** npm docs use that name for **classic token** auth. With **Trusted Publishing** you do **not** put a token value into npm for OIDC; GitHub provides the identity. You also do **not** need a GitHub secret named `NPM_TOKEN` for this flow. (If the npm UI showed `NPM_TOKEN`, it is usually help text for the non-OIDC case.)
+2. **Branches**: on **push** to `main`, `beta`, or `alpha`, that workflow runs `npm ci`, **build**, **`npm run test:ci`**, then `npx semantic-release` on push only.
+3. **Config**: [release.config.cjs](release.config.cjs) matches fuul-sdk’s plugin list and order; `@semantic-release/exec` uses the same **`verifyReleaseCmd`** writing `src/release.json` (placeholder [src/release.json](src/release.json)); `@semantic-release/git` commits **`package.json`** only.
+4. **Commits**: use [Conventional Commits](https://www.conventionalcommits.org/) on releasable branches (e.g. `feat:`, `fix:`, `BREAKING CHANGE:`) so the next version is computed; if nothing warrants a release, the job exits without publishing (expected).
+
+Local dry run of the same CLI: `npm run semantic-release` (needs a clean git state, tags, and env vars; in practice CI after merge is enough).
 
 ## Scripts
 
@@ -212,6 +223,8 @@ Publishing to npm is triggered by publishing a **GitHub Release** (see [.github/
 | `npm run dev` | MCP via `tsx` (`src/index.ts`) |
 | `npm run lint` | ESLint on `src/` |
 | `npm run test` | Vitest |
+| `npm run test:ci` | Vitest (same as `test`; used by `release.yml` like fuul-sdk’s `test:ci` in `versioning.yml`) |
+| `npm run semantic-release` | Run semantic-release locally (CI runs `npx semantic-release` on eligible pushes) |
 
 ## License
 

package/dist/agent/write-confirmation.d.ts

@@ -4,7 +4,16 @@ import { z } from 'zod';
  * Flow: first call with dry_run: true (or omit confirmed) to get validation / preview;
  * second call with confirmed: true to execute.
  */
-export declare const writeConfirmationFieldsSchema: any;
+export declare const writeConfirmationFieldsSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
 export type WriteConfirmationFields = z.infer<typeof writeConfirmationFieldsSchema>;
 export declare class WriteNotConfirmedError extends Error {
     readonly code: "WRITE_NOT_CONFIRMED";

package/dist/agent/write-confirmation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-confirmation.d.ts","sourceRoot":"","sources":["../../src/agent/write-confirmation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,KAGxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;gBAEnC,OAAO,SAAiG;CAKrH;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAQjF"}
+{"version":3,"file":"write-confirmation.d.ts","sourceRoot":"","sources":["../../src/agent/write-confirmation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;EAGxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAG,qBAAqB,CAAU;gBAEnC,OAAO,SAAiG;CAKrH;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAQjF"}

package/dist/config/env.d.ts

@@ -1,5 +1,21 @@
 import { z } from 'zod';
-declare const envSchema: any;
+declare const envSchema: z.ZodObject<{
+    FUUL_API_BASE_URL: z.ZodDefault<z.ZodString>;
+    FUUL_OAUTH_CLIENT_ID: z.ZodDefault<z.ZodString>;
+    FUUL_OAUTH_REDIRECT_URI: z.ZodDefault<z.ZodString>;
+    /** Max wall time per MCP tool call (ms). Covers refresh + retry on 401. */
+    FUUL_MCP_TOOL_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    FUUL_API_BASE_URL: string;
+    FUUL_OAUTH_CLIENT_ID: string;
+    FUUL_OAUTH_REDIRECT_URI: string;
+    FUUL_MCP_TOOL_TIMEOUT_MS: number;
+}, {
+    FUUL_API_BASE_URL?: string | undefined;
+    FUUL_OAUTH_CLIENT_ID?: string | undefined;
+    FUUL_OAUTH_REDIRECT_URI?: string | undefined;
+    FUUL_MCP_TOOL_TIMEOUT_MS?: number | undefined;
+}>;
 export type Env = z.infer<typeof envSchema> & {
     debug: boolean;
 };

package/dist/config/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,SAAS,KAMb,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAMjE,wBAAgB,OAAO,CAAC,UAAU,GAAE,MAAM,CAAC,UAAwB,GAAG,GAAG,CAWxE;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEjD"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,SAAS;;;;IAIb,2EAA2E;;;;;;;;;;;;EAE3E,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAMjE,wBAAgB,OAAO,CAAC,UAAU,GAAE,MAAM,CAAC,UAAwB,GAAG,GAAG,CAWxE;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEjD"}

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

@@ -1,35 +1,584 @@
 import { z } from 'zod';
-export declare const listProjectsInputSchema: any;
-export declare const projectIdParamSchema: any;
-export declare const getIncentiveInputSchema: any;
-export declare const getTriggerInputSchema: any;
-export declare const payoutTermSchema: any;
+export declare const listProjectsInputSchema: z.ZodObject<{
+    page: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    page?: number | undefined;
+    query?: string | undefined;
+}, {
+    page?: number | undefined;
+    query?: string | undefined;
+}>;
+export declare const projectIdParamSchema: z.ZodObject<{
+    project_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+}, {
+    project_id: string;
+}>;
+export declare const getIncentiveInputSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    conversion_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    conversion_id: string;
+}, {
+    project_id: string;
+    conversion_id: string;
+}>;
+export declare const getTriggerInputSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    trigger_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    trigger_id: string;
+}, {
+    project_id: string;
+    trigger_id: string;
+}>;
+export declare const payoutTermSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 /** Body must match server PayoutTermDto (see fuul-server payouts/payout-terms/dto/payout-term.dto). */
-export declare const updatePayoutTermInputSchema: any;
+export declare const updatePayoutTermInputSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    conversion_id: z.ZodString;
+    payout_term_id: z.ZodString;
+    payout_term: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    conversion_id: string;
+    payout_term_id: string;
+    payout_term: Record<string, unknown>;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}, {
+    project_id: string;
+    conversion_id: string;
+    payout_term_id: string;
+    payout_term: Record<string, unknown>;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+}>;
 export type UpdatePayoutTermInput = z.infer<typeof updatePayoutTermInputSchema>;
 /** Registered on MCP tools; use {@link updateProjectTierInputSchema} in handlers for full validation. */
-export declare const updateProjectTierFieldsSchema: any;
-export declare const updateProjectTierInputSchema: any;
+export declare const updateProjectTierFieldsSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    tier_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    rank: z.ZodOptional<z.ZodNumber>;
+    audience_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    tier_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | null | undefined;
+    rank?: number | undefined;
+    audience_id?: string | null | undefined;
+}, {
+    project_id: string;
+    tier_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | null | undefined;
+    rank?: number | undefined;
+    audience_id?: string | null | undefined;
+}>;
+export declare const updateProjectTierInputSchema: z.ZodEffects<z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    tier_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNull]>>;
+    rank: z.ZodOptional<z.ZodNumber>;
+    audience_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    tier_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | null | undefined;
+    rank?: number | undefined;
+    audience_id?: string | null | undefined;
+}, {
+    project_id: string;
+    tier_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | null | undefined;
+    rank?: number | undefined;
+    audience_id?: string | null | undefined;
+}>, {
+    project_id: string;
+    tier_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | null | undefined;
+    rank?: number | undefined;
+    audience_id?: string | null | undefined;
+}, {
+    project_id: string;
+    tier_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | null | undefined;
+    rank?: number | undefined;
+    audience_id?: string | null | undefined;
+}>;
 export type UpdateProjectTierInput = z.infer<typeof updateProjectTierInputSchema>;
 /** Registered on MCP tools; use {@link updateAudienceInputSchema} in handlers. */
-export declare const updateAudienceFieldsSchema: any;
-export declare const updateAudienceInputSchema: any;
+export declare const updateAudienceFieldsSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    audience_id: z.ZodString;
+    name: z.ZodString;
+    conditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        signature: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }, {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }>, "many">>;
+    condition_match_mode: z.ZodOptional<z.ZodEnum<["any", "all"]>>;
+    contractId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    name: string;
+    audience_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    conditions?: {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }[] | undefined;
+    condition_match_mode?: "any" | "all" | undefined;
+    contractId?: string | undefined;
+}, {
+    project_id: string;
+    name: string;
+    audience_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    conditions?: {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }[] | undefined;
+    condition_match_mode?: "any" | "all" | undefined;
+    contractId?: string | undefined;
+}>;
+export declare const updateAudienceInputSchema: z.ZodEffects<z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    audience_id: z.ZodString;
+    name: z.ZodString;
+    conditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        signature: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }, {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }>, "many">>;
+    condition_match_mode: z.ZodOptional<z.ZodEnum<["any", "all"]>>;
+    contractId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    name: string;
+    audience_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    conditions?: {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }[] | undefined;
+    condition_match_mode?: "any" | "all" | undefined;
+    contractId?: string | undefined;
+}, {
+    project_id: string;
+    name: string;
+    audience_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    conditions?: {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }[] | undefined;
+    condition_match_mode?: "any" | "all" | undefined;
+    contractId?: string | undefined;
+}>, {
+    project_id: string;
+    name: string;
+    audience_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    conditions?: {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }[] | undefined;
+    condition_match_mode?: "any" | "all" | undefined;
+    contractId?: string | undefined;
+}, {
+    project_id: string;
+    name: string;
+    audience_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    conditions?: {
+        signature: string;
+        parameters: Record<string, unknown>;
+    }[] | undefined;
+    condition_match_mode?: "any" | "all" | undefined;
+    contractId?: string | undefined;
+}>;
 export type UpdateAudienceInput = z.infer<typeof updateAudienceInputSchema>;
 /** Registered on MCP tools; use {@link updateTriggerInputSchema} in handlers. */
-export declare const updateTriggerFieldsSchema: any;
-export declare const updateTriggerInputSchema: any;
+export declare const updateTriggerFieldsSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    trigger_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    event_type: z.ZodOptional<z.ZodString>;
+    condition_expression: z.ZodOptional<z.ZodString>;
+    amount_expression: z.ZodOptional<z.ZodString>;
+    volume_expression: z.ZodOptional<z.ZodString>;
+    revenue_expression: z.ZodOptional<z.ZodString>;
+    currency_expression: z.ZodOptional<z.ZodString>;
+    volume_currency_expression: z.ZodOptional<z.ZodString>;
+    revenue_currency_expression: z.ZodOptional<z.ZodString>;
+    end_user_identifier_property: z.ZodOptional<z.ZodString>;
+    end_user_identifier_expression: z.ZodOptional<z.ZodString>;
+    payable: z.ZodOptional<z.ZodBoolean>;
+    ref: z.ZodOptional<z.ZodString>;
+    contract_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    event_type?: string | undefined;
+    condition_expression?: string | undefined;
+    amount_expression?: string | undefined;
+    volume_expression?: string | undefined;
+    revenue_expression?: string | undefined;
+    currency_expression?: string | undefined;
+    volume_currency_expression?: string | undefined;
+    revenue_currency_expression?: string | undefined;
+    end_user_identifier_property?: string | undefined;
+    end_user_identifier_expression?: string | undefined;
+    payable?: boolean | undefined;
+    ref?: string | undefined;
+    contract_ids?: string[] | undefined;
+}, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    event_type?: string | undefined;
+    condition_expression?: string | undefined;
+    amount_expression?: string | undefined;
+    volume_expression?: string | undefined;
+    revenue_expression?: string | undefined;
+    currency_expression?: string | undefined;
+    volume_currency_expression?: string | undefined;
+    revenue_currency_expression?: string | undefined;
+    end_user_identifier_property?: string | undefined;
+    end_user_identifier_expression?: string | undefined;
+    payable?: boolean | undefined;
+    ref?: string | undefined;
+    contract_ids?: string[] | undefined;
+}>;
+export declare const updateTriggerInputSchema: z.ZodEffects<z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    trigger_id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    event_type: z.ZodOptional<z.ZodString>;
+    condition_expression: z.ZodOptional<z.ZodString>;
+    amount_expression: z.ZodOptional<z.ZodString>;
+    volume_expression: z.ZodOptional<z.ZodString>;
+    revenue_expression: z.ZodOptional<z.ZodString>;
+    currency_expression: z.ZodOptional<z.ZodString>;
+    volume_currency_expression: z.ZodOptional<z.ZodString>;
+    revenue_currency_expression: z.ZodOptional<z.ZodString>;
+    end_user_identifier_property: z.ZodOptional<z.ZodString>;
+    end_user_identifier_expression: z.ZodOptional<z.ZodString>;
+    payable: z.ZodOptional<z.ZodBoolean>;
+    ref: z.ZodOptional<z.ZodString>;
+    contract_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    event_type?: string | undefined;
+    condition_expression?: string | undefined;
+    amount_expression?: string | undefined;
+    volume_expression?: string | undefined;
+    revenue_expression?: string | undefined;
+    currency_expression?: string | undefined;
+    volume_currency_expression?: string | undefined;
+    revenue_currency_expression?: string | undefined;
+    end_user_identifier_property?: string | undefined;
+    end_user_identifier_expression?: string | undefined;
+    payable?: boolean | undefined;
+    ref?: string | undefined;
+    contract_ids?: string[] | undefined;
+}, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    event_type?: string | undefined;
+    condition_expression?: string | undefined;
+    amount_expression?: string | undefined;
+    volume_expression?: string | undefined;
+    revenue_expression?: string | undefined;
+    currency_expression?: string | undefined;
+    volume_currency_expression?: string | undefined;
+    revenue_currency_expression?: string | undefined;
+    end_user_identifier_property?: string | undefined;
+    end_user_identifier_expression?: string | undefined;
+    payable?: boolean | undefined;
+    ref?: string | undefined;
+    contract_ids?: string[] | undefined;
+}>, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    event_type?: string | undefined;
+    condition_expression?: string | undefined;
+    amount_expression?: string | undefined;
+    volume_expression?: string | undefined;
+    revenue_expression?: string | undefined;
+    currency_expression?: string | undefined;
+    volume_currency_expression?: string | undefined;
+    revenue_currency_expression?: string | undefined;
+    end_user_identifier_property?: string | undefined;
+    end_user_identifier_expression?: string | undefined;
+    payable?: boolean | undefined;
+    ref?: string | undefined;
+    contract_ids?: string[] | undefined;
+}, {
+    project_id: string;
+    trigger_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    event_type?: string | undefined;
+    condition_expression?: string | undefined;
+    amount_expression?: string | undefined;
+    volume_expression?: string | undefined;
+    revenue_expression?: string | undefined;
+    currency_expression?: string | undefined;
+    volume_currency_expression?: string | undefined;
+    revenue_currency_expression?: string | undefined;
+    end_user_identifier_property?: string | undefined;
+    end_user_identifier_expression?: string | undefined;
+    payable?: boolean | undefined;
+    ref?: string | undefined;
+    contract_ids?: string[] | undefined;
+}>;
 export type UpdateTriggerInput = z.infer<typeof updateTriggerInputSchema>;
-export declare const listPayoutsPendingApprovalSchema: any;
-export declare const listRewardsPayoutsSchema: any;
-export declare const payoutBatchActionInputSchema: any;
+export declare const listPayoutsPendingApprovalSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    page: z.ZodOptional<z.ZodNumber>;
+    page_size: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    page?: number | undefined;
+    page_size?: number | undefined;
+}, {
+    project_id: string;
+    page?: number | undefined;
+    page_size?: number | undefined;
+}>;
+export declare const listRewardsPayoutsSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    page: z.ZodOptional<z.ZodNumber>;
+    page_size: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodString>;
+    from_date: z.ZodOptional<z.ZodString>;
+    to_date: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    status?: string | undefined;
+    page?: number | undefined;
+    page_size?: number | undefined;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+}, {
+    project_id: string;
+    status?: string | undefined;
+    page?: number | undefined;
+    page_size?: number | undefined;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+}>;
+export declare const payoutBatchActionInputSchema: z.ZodObject<{
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+    confirmed: z.ZodOptional<z.ZodBoolean>;
+} & {
+    project_id: z.ZodString;
+    payout_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    from_date: z.ZodOptional<z.ZodString>;
+    to_date: z.ZodOptional<z.ZodString>;
+    user_address: z.ZodOptional<z.ZodString>;
+    affiliate_address: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+    payout_ids?: string[] | undefined;
+    user_address?: string | undefined;
+    affiliate_address?: string | undefined;
+}, {
+    project_id: string;
+    dry_run?: boolean | undefined;
+    confirmed?: boolean | undefined;
+    from_date?: string | undefined;
+    to_date?: string | undefined;
+    payout_ids?: string[] | undefined;
+    user_address?: string | undefined;
+    affiliate_address?: string | undefined;
+}>;
 export type PayoutBatchActionInput = z.infer<typeof payoutBatchActionInputSchema>;
 /** GET .../affiliate-portal/stats — matches fuul-server GetAffiliateStatsDto query names. */
-export declare const getAffiliatePortalStatsSchema: any;
+export declare const getAffiliatePortalStatsSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    user_identifier: z.ZodString;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    this_month: z.ZodOptional<z.ZodString>;
+    conversion_external_id: z.ZodOptional<z.ZodNumber>;
+    conversion_name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    user_identifier: string;
+    from?: string | undefined;
+    to?: string | undefined;
+    this_month?: string | undefined;
+    conversion_external_id?: number | undefined;
+    conversion_name?: string | undefined;
+}, {
+    project_id: string;
+    user_identifier: string;
+    from?: string | undefined;
+    to?: string | undefined;
+    this_month?: string | undefined;
+    conversion_external_id?: number | undefined;
+    conversion_name?: string | undefined;
+}>;
 export type GetAffiliatePortalStatsInput = z.infer<typeof getAffiliatePortalStatsSchema>;
 /** GET .../affiliate-portal/total-stats — matches GetTotalStatsDto. */
-export declare const getProjectAffiliateTotalStatsSchema: any;
+export declare const getProjectAffiliateTotalStatsSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    statuses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    regions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    audiences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    dateRange: z.ZodOptional<z.ZodEnum<["7d", "30d", "90d", "MTD", "QTD", "custom", "all"]>>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    statuses?: string[] | undefined;
+    regions?: string[] | undefined;
+    audiences?: string[] | undefined;
+    tiers?: string[] | undefined;
+    dateRange?: "custom" | "all" | "7d" | "30d" | "90d" | "MTD" | "QTD" | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+}, {
+    project_id: string;
+    statuses?: string[] | undefined;
+    regions?: string[] | undefined;
+    audiences?: string[] | undefined;
+    tiers?: string[] | undefined;
+    dateRange?: "custom" | "all" | "7d" | "30d" | "90d" | "MTD" | "QTD" | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+}>;
 export type GetProjectAffiliateTotalStatsInput = z.infer<typeof getProjectAffiliateTotalStatsSchema>;
 /** GET .../affiliate-portal/global-breakdown — matches GetProjectAffiliatesBreakdownDto (groupBy required). */
-export declare const getProjectAffiliatesBreakdownSchema: any;
+export declare const getProjectAffiliatesBreakdownSchema: z.ZodObject<{
+    project_id: z.ZodString;
+    groupBy: z.ZodEnum<["audience", "tier", "region", "status"]>;
+    dateRange: z.ZodOptional<z.ZodEnum<["7d", "30d", "90d", "MTD", "QTD", "custom", "all"]>>;
+    dateFrom: z.ZodOptional<z.ZodString>;
+    dateTo: z.ZodOptional<z.ZodString>;
+    sortBy: z.ZodOptional<z.ZodEnum<["totalReferralVolume", "revenueFromReferrals", "earnings", "pointsPaid"]>>;
+    sortOrder: z.ZodOptional<z.ZodEnum<["asc", "desc"]>>;
+    statuses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    regions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    audiences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tiers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    project_id: string;
+    groupBy: "status" | "audience" | "tier" | "region";
+    statuses?: string[] | undefined;
+    regions?: string[] | undefined;
+    audiences?: string[] | undefined;
+    tiers?: string[] | undefined;
+    dateRange?: "custom" | "all" | "7d" | "30d" | "90d" | "MTD" | "QTD" | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+    sortBy?: "totalReferralVolume" | "revenueFromReferrals" | "earnings" | "pointsPaid" | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+}, {
+    project_id: string;
+    groupBy: "status" | "audience" | "tier" | "region";
+    statuses?: string[] | undefined;
+    regions?: string[] | undefined;
+    audiences?: string[] | undefined;
+    tiers?: string[] | undefined;
+    dateRange?: "custom" | "all" | "7d" | "30d" | "90d" | "MTD" | "QTD" | undefined;
+    dateFrom?: string | undefined;
+    dateTo?: string | undefined;
+    sortBy?: "totalReferralVolume" | "revenueFromReferrals" | "earnings" | "pointsPaid" | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+}>;
 export type GetProjectAffiliatesBreakdownInput = z.infer<typeof getProjectAffiliatesBreakdownSchema>;
 //# 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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB,KAGlC,CAAC;AAEH,eAAO,MAAM,oBAAoB,KAE/B,CAAC;AAEH,eAAO,MAAM,uBAAuB,KAGlC,CAAC;AAEH,eAAO,MAAM,qBAAqB,KAGhC,CAAC;AAEH,eAAO,MAAM,gBAAgB,KAAoC,CAAC;AAElE,uGAAuG;AACvG,eAAO,MAAM,2BAA2B,KAKtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,yGAAyG;AACzG,eAAO,MAAM,6BAA6B,KAOxC,CAAC;AAEH,eAAO,MAAM,4BAA4B,KAGxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAOlF,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,KAOrC,CAAC;AAEH,eAAO,MAAM,yBAAyB,KAGrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,KAkBpC,CAAC;AAEH,eAAO,MAAM,wBAAwB,KAkBpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,gCAAgC,KAI3C,CAAC;AAEH,eAAO,MAAM,wBAAwB,KAOnC,CAAC;AAEH,eAAO,MAAM,4BAA4B,KAOvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAIlF,6FAA6F;AAC7F,eAAO,MAAM,6BAA6B,KAQxC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEzF,uEAAuE;AACvE,eAAO,MAAM,mCAAmC,KAS9C,CAAC;AAEH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAKrG,+GAA+G;AAC/G,eAAO,MAAM,mCAAmC,KAY9C,CAAC;AAEH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC"}
+{"version":3,"file":"tool-schemas.d.ts","sourceRoot":"","sources":["../../src/tools/tool-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;EAGlC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH,eAAO,MAAM,gBAAgB,wCAAoC,CAAC;AAElE,uGAAuG;AACvG,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;EAKtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,yGAAyG;AACzG,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOxC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGxC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAOlF,kFAAkF;AAClF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOrC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGrC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,iFAAiF;AACjF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBpC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,gCAAgC;;;;;;;;;;;;EAI3C,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAOnC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAIlF,6FAA6F;AAC7F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;EAQxC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEzF,uEAAuE;AACvE,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS9C,CAAC;AAEH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAKrG,+GAA+G;AAC/G,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY9C,CAAC;AAEH,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuul/mcp-server",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "description": "Fuul MCP server for program management via MCP-compatible clients",
   "keywords": [
     "Fuul",
@@ -27,12 +27,14 @@
   },
   "scripts": {
     "build": "tsc",
+    "semantic-release": "semantic-release",
     "start": "node dist/index.js",
     "cli": "tsx src/cli.ts",
     "dev": "tsx src/index.ts",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",
     "test": "vitest run",
+    "test:ci": "vitest run",
     "test:watch": "vitest",
     "format": "prettier --write 'src/**/*.ts' '*.json' 'eslint.config.js' --config ./.prettierrc"
   },
@@ -45,18 +47,23 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",
+    "@semantic-release/exec": "^7.1.0",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^13.1.3",
     "@types/node": "^22.10.0",
     "eslint": "^9.39.4",
     "eslint-config-prettier": "^9.1.2",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "prettier": "^3.4.2",
+    "semantic-release": "^25.0.3",
     "tsx": "^4.19.0",
     "typescript": "^5.7.0",
     "typescript-eslint": "^8.58.0",
     "vitest": "^3.0.0"
   },
   "publishConfig": {
+    "tag": "latest",
     "access": "public"
   },
   "overrides": {