asc-mcp-pro 0.1.0

package/build/tools/builds.js

@@ -0,0 +1,158 @@
+import { z } from "zod";
+import { DEFAULT_FIELDS } from "../lib/projections.js";
+import { patchBody, postBody, singleRel, maybeSend } from "../lib/jsonapi-write.js";
+import { APP_STORE_LOCALES } from "../lib/locales.js";
+export function buildsTools(client) {
+    return [
+        // ---- READS ----
+        {
+            name: "asc_builds_list",
+            description: "List builds, optionally filtered by app/version/state.",
+            inputSchema: z.object({
+                appId: z.string().optional(),
+                versionId: z.string().optional(),
+                preReleaseVersion: z.string().optional(),
+                processingState: z.enum(["PROCESSING", "FAILED", "INVALID", "VALID"]).optional(),
+                expired: z.boolean().optional(),
+                version: z.string().optional(),
+                limit: z.number().int().min(1).max(200).optional(),
+                sort: z.enum(["uploadedDate", "-uploadedDate", "version", "-version"]).optional(),
+                include: z.array(z.string()).optional(),
+            }),
+            handler: async ({ appId, versionId, preReleaseVersion, processingState, expired, version, limit, sort, include }) => client.request("/builds", {
+                query: {
+                    "filter[app]": appId,
+                    "filter[appStoreVersion]": versionId,
+                    "filter[preReleaseVersion]": preReleaseVersion,
+                    "filter[processingState]": processingState,
+                    "filter[expired]": expired !== undefined ? String(expired) : undefined,
+                    "filter[version]": version,
+                    limit: limit ?? 50,
+                    sort: sort ?? "-uploadedDate",
+                    include,
+                    "fields[builds]": DEFAULT_FIELDS.builds,
+                },
+            }),
+        },
+        {
+            name: "asc_builds_get",
+            description: "Get one build by id.",
+            inputSchema: z.object({
+                buildId: z.string(),
+                include: z.array(z.string()).optional(),
+            }),
+            handler: async ({ buildId, include }) => client.request(`/builds/${buildId}`, { query: { include } }),
+        },
+        {
+            name: "asc_builds_get_beta_details",
+            description: "Get TestFlight beta details for a build.",
+            inputSchema: z.object({ buildId: z.string() }),
+            handler: async ({ buildId }) => client.request(`/builds/${buildId}/buildBetaDetail`),
+        },
+        {
+            name: "asc_builds_list_beta_localizations",
+            description: "List per-locale 'What to Test' notes for a build.",
+            inputSchema: z.object({
+                buildId: z.string(),
+                limit: z.number().int().min(1).max(200).optional(),
+            }),
+            handler: async ({ buildId, limit }) => client.request(`/builds/${buildId}/betaBuildLocalizations`, { query: { limit: limit ?? 50 } }),
+        },
+        {
+            name: "asc_builds_get_beta_localization",
+            description: "Get a single beta build localization by id.",
+            inputSchema: z.object({ localizationId: z.string() }),
+            handler: async ({ localizationId }) => client.request(`/betaBuildLocalizations/${localizationId}`),
+        },
+        {
+            name: "asc_builds_get_pre_release_version",
+            description: "Get the pre-release version (TestFlight grouping) for a build.",
+            inputSchema: z.object({ buildId: z.string() }),
+            handler: async ({ buildId }) => client.request(`/builds/${buildId}/preReleaseVersion`),
+        },
+        {
+            name: "asc_builds_get_beta_review_submission",
+            description: "Get the Beta App Review submission record for a build.",
+            inputSchema: z.object({ buildId: z.string() }),
+            handler: async ({ buildId }) => client.request(`/builds/${buildId}/betaAppReviewSubmission`),
+        },
+        // ---- WRITES: Phase 2 ----
+        {
+            name: "asc_builds_update_beta_details",
+            description: "Update build beta details (autoNotifyEnabled for external testers).",
+            inputSchema: z.object({
+                buildBetaDetailId: z.string().describe("ID of the buildBetaDetail resource (not the build id)"),
+                autoNotifyEnabled: z.boolean(),
+                dryRun: z.boolean().optional(),
+            }),
+            handler: async ({ buildBetaDetailId, autoNotifyEnabled, dryRun }) => {
+                const body = patchBody("buildBetaDetails", buildBetaDetailId, { autoNotifyEnabled });
+                return maybeSend(client, dryRun, "PATCH", `/buildBetaDetails/${buildBetaDetailId}`, body);
+            },
+        },
+        {
+            name: "asc_builds_update_beta_localization",
+            description: "Update 'What to Test' text for a build in one locale.",
+            inputSchema: z.object({
+                localizationId: z.string(),
+                whatsNew: z.string().max(4000),
+                dryRun: z.boolean().optional(),
+            }),
+            handler: async ({ localizationId, whatsNew, dryRun }) => {
+                const body = patchBody("betaBuildLocalizations", localizationId, { whatsNew });
+                return maybeSend(client, dryRun, "PATCH", `/betaBuildLocalizations/${localizationId}`, body);
+            },
+        },
+        {
+            name: "asc_builds_create_beta_localization",
+            description: "Add a new 'What to Test' localization to a build.",
+            inputSchema: z.object({
+                buildId: z.string(),
+                locale: z.enum(APP_STORE_LOCALES),
+                whatsNew: z.string().max(4000),
+                dryRun: z.boolean().optional(),
+            }),
+            handler: async ({ buildId, locale, whatsNew, dryRun }) => {
+                const body = postBody("betaBuildLocalizations", { locale, whatsNew }, { build: singleRel("builds", buildId) });
+                return maybeSend(client, dryRun, "POST", `/betaBuildLocalizations`, body);
+            },
+        },
+        {
+            name: "asc_builds_delete_beta_localization",
+            description: "Delete a beta build localization.",
+            inputSchema: z.object({
+                localizationId: z.string(),
+                dryRun: z.boolean().optional(),
+            }),
+            handler: async ({ localizationId, dryRun }) => maybeSend(client, dryRun, "DELETE", `/betaBuildLocalizations/${localizationId}`),
+        },
+        {
+            name: "asc_builds_update_expiration",
+            description: "Mark a build expired or unexpired.",
+            inputSchema: z.object({
+                buildId: z.string(),
+                expired: z.boolean(),
+                dryRun: z.boolean().optional(),
+            }),
+            handler: async ({ buildId, expired, dryRun }) => {
+                const body = patchBody("builds", buildId, { expired });
+                return maybeSend(client, dryRun, "PATCH", `/builds/${buildId}`, body);
+            },
+        },
+        // ---- WRITES: Phase 3 (export compliance + ITC bypass) ----
+        {
+            name: "asc_builds_update_export_compliance",
+            description: "Set the build's usesNonExemptEncryption flag (Export Compliance). Required before submitting if not declared in Info.plist.",
+            inputSchema: z.object({
+                buildId: z.string(),
+                usesNonExemptEncryption: z.boolean(),
+                dryRun: z.boolean().optional(),
+            }),
+            handler: async ({ buildId, usesNonExemptEncryption, dryRun }) => {
+                const body = patchBody("builds", buildId, { usesNonExemptEncryption });
+                return maybeSend(client, dryRun, "PATCH", `/builds/${buildId}`, body);
+            },
+        },
+    ];
+}
+//# sourceMappingURL=builds.js.map

package/build/tools/builds.js.map

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

package/build/tools/iap.d.ts

@@ -0,0 +1,3 @@
+import type { AscClient } from "../client.js";
+import type { ToolDef } from "./types.js";
+export declare function iapTools(client: AscClient): ToolDef[];