@pofky/asc-mcp 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +186 -0
  3. package/dist/auth.d.ts +9 -0
  4. package/dist/auth.d.ts.map +1 -0
  5. package/dist/auth.js +85 -0
  6. package/dist/auth.js.map +1 -0
  7. package/dist/client.d.ts +25 -0
  8. package/dist/client.d.ts.map +1 -0
  9. package/dist/client.js +124 -0
  10. package/dist/client.js.map +1 -0
  11. package/dist/index.d.ts +3 -0
  12. package/dist/index.d.ts.map +1 -0
  13. package/dist/index.js +97 -0
  14. package/dist/index.js.map +1 -0
  15. package/dist/license.d.ts +10 -0
  16. package/dist/license.d.ts.map +1 -0
  17. package/dist/license.js +47 -0
  18. package/dist/license.js.map +1 -0
  19. package/dist/tools/app-details.d.ts +19 -0
  20. package/dist/tools/app-details.d.ts.map +1 -0
  21. package/dist/tools/app-details.js +78 -0
  22. package/dist/tools/app-details.js.map +1 -0
  23. package/dist/tools/daily-briefing.d.ts +20 -0
  24. package/dist/tools/daily-briefing.d.ts.map +1 -0
  25. package/dist/tools/daily-briefing.js +141 -0
  26. package/dist/tools/daily-briefing.js.map +1 -0
  27. package/dist/tools/list-apps.d.ts +18 -0
  28. package/dist/tools/list-apps.d.ts.map +1 -0
  29. package/dist/tools/list-apps.js +31 -0
  30. package/dist/tools/list-apps.js.map +1 -0
  31. package/dist/tools/list-reviews.d.ts +36 -0
  32. package/dist/tools/list-reviews.d.ts.map +1 -0
  33. package/dist/tools/list-reviews.js +75 -0
  34. package/dist/tools/list-reviews.js.map +1 -0
  35. package/dist/tools/release-notes.d.ts +29 -0
  36. package/dist/tools/release-notes.d.ts.map +1 -0
  37. package/dist/tools/release-notes.js +160 -0
  38. package/dist/tools/release-notes.js.map +1 -0
  39. package/dist/tools/release-preflight.d.ts +20 -0
  40. package/dist/tools/release-preflight.d.ts.map +1 -0
  41. package/dist/tools/release-preflight.js +310 -0
  42. package/dist/tools/release-preflight.js.map +1 -0
  43. package/dist/tools/review-status.d.ts +19 -0
  44. package/dist/tools/review-status.d.ts.map +1 -0
  45. package/dist/tools/review-status.js +95 -0
  46. package/dist/tools/review-status.js.map +1 -0
  47. package/dist/tools/sales-report.d.ts +31 -0
  48. package/dist/tools/sales-report.d.ts.map +1 -0
  49. package/dist/tools/sales-report.js +104 -0
  50. package/dist/tools/sales-report.js.map +1 -0
  51. package/dist/types.d.ts +85 -0
  52. package/dist/types.d.ts.map +1 -0
  53. package/dist/types.js +4 -0
  54. package/dist/types.js.map +1 -0
  55. package/package.json +63 -0
@@ -0,0 +1,160 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.releaseNotesDefinition = void 0;
4
+ exports.releaseNotes = releaseNotes;
5
+ const child_process_1 = require("child_process");
6
+ const WHATS_NEW_MAX = 4000;
7
+ exports.releaseNotesDefinition = {
8
+ name: "release_notes",
9
+ description: "Extract git commits since the last tag and return them in a structured format for writing App Store 'What's New' release notes. The AI agent uses this output to draft user-facing release notes. Also validates against Apple's 4000-character limit.",
10
+ inputSchema: {
11
+ type: "object",
12
+ properties: {
13
+ project_path: {
14
+ type: "string",
15
+ description: "Path to the git project directory. If omitted, uses the current working directory.",
16
+ },
17
+ since_tag: {
18
+ type: "string",
19
+ description: "Git tag to compare from (e.g. 'v1.0.0'). If omitted, uses the latest tag automatically.",
20
+ },
21
+ max_commits: {
22
+ type: "number",
23
+ description: "Maximum number of commits to include (default 50).",
24
+ },
25
+ },
26
+ required: [],
27
+ },
28
+ };
29
+ async function releaseNotes(args, tier) {
30
+ if (tier !== "pro") {
31
+ return ("Release notes generation requires a Pro license ($9/mo).\n" +
32
+ "Get your license at: https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu\n\n" +
33
+ "Set ASC_LICENSE_KEY in your MCP server config to unlock.");
34
+ }
35
+ const cwd = args.project_path || process.cwd();
36
+ const maxCommits = args.max_commits || 50;
37
+ // Check if this is a git repo
38
+ try {
39
+ (0, child_process_1.execSync)("git rev-parse --is-inside-work-tree", {
40
+ cwd,
41
+ encoding: "utf-8",
42
+ stdio: ["pipe", "pipe", "pipe"],
43
+ });
44
+ }
45
+ catch {
46
+ return "Error: not a git repository. Run this tool from a git project directory.";
47
+ }
48
+ // Find the base tag to diff from
49
+ let sinceTag = args.since_tag || "";
50
+ if (!sinceTag) {
51
+ try {
52
+ sinceTag = (0, child_process_1.execSync)("git describe --tags --abbrev=0 HEAD 2>/dev/null", {
53
+ cwd,
54
+ encoding: "utf-8",
55
+ stdio: ["pipe", "pipe", "pipe"],
56
+ }).trim();
57
+ }
58
+ catch {
59
+ // No tags exist, use first commit
60
+ sinceTag = "";
61
+ }
62
+ }
63
+ // Get commits
64
+ let gitLogCmd;
65
+ if (sinceTag) {
66
+ gitLogCmd = `git log ${sinceTag}..HEAD --oneline --no-merges --max-count=${maxCommits}`;
67
+ }
68
+ else {
69
+ gitLogCmd = `git log --oneline --no-merges --max-count=${maxCommits}`;
70
+ }
71
+ let commits;
72
+ try {
73
+ commits = (0, child_process_1.execSync)(gitLogCmd, {
74
+ cwd,
75
+ encoding: "utf-8",
76
+ stdio: ["pipe", "pipe", "pipe"],
77
+ }).trim();
78
+ }
79
+ catch {
80
+ return "Error: could not read git log.";
81
+ }
82
+ if (!commits) {
83
+ return sinceTag
84
+ ? `No new commits since tag '${sinceTag}'.`
85
+ : "No commits found in this repository.";
86
+ }
87
+ const commitLines = commits.split("\n");
88
+ // Categorize commits by conventional commit type
89
+ const categories = {
90
+ features: [],
91
+ fixes: [],
92
+ improvements: [],
93
+ other: [],
94
+ };
95
+ for (const line of commitLines) {
96
+ // Remove the hash prefix
97
+ const message = line.replace(/^[a-f0-9]+ /, "");
98
+ const lower = message.toLowerCase();
99
+ if (lower.startsWith("feat") || lower.startsWith("add")) {
100
+ categories.features.push(message);
101
+ }
102
+ else if (lower.startsWith("fix") ||
103
+ lower.startsWith("bug") ||
104
+ lower.startsWith("patch")) {
105
+ categories.fixes.push(message);
106
+ }
107
+ else if (lower.startsWith("refactor") ||
108
+ lower.startsWith("perf") ||
109
+ lower.startsWith("improve") ||
110
+ lower.startsWith("update") ||
111
+ lower.startsWith("enhance")) {
112
+ categories.improvements.push(message);
113
+ }
114
+ else {
115
+ categories.other.push(message);
116
+ }
117
+ }
118
+ // Build structured output
119
+ let result = `## Git History for Release Notes\n\n`;
120
+ result += `**Since**: ${sinceTag || "(beginning of history)"}\n`;
121
+ result += `**Commits**: ${commitLines.length}\n`;
122
+ result += `**Character limit**: ${WHATS_NEW_MAX} chars for "What's New"\n\n`;
123
+ if (categories.features.length > 0) {
124
+ result += `### New Features (${categories.features.length})\n`;
125
+ for (const c of categories.features) {
126
+ result += `- ${c}\n`;
127
+ }
128
+ result += "\n";
129
+ }
130
+ if (categories.fixes.length > 0) {
131
+ result += `### Bug Fixes (${categories.fixes.length})\n`;
132
+ for (const c of categories.fixes) {
133
+ result += `- ${c}\n`;
134
+ }
135
+ result += "\n";
136
+ }
137
+ if (categories.improvements.length > 0) {
138
+ result += `### Improvements (${categories.improvements.length})\n`;
139
+ for (const c of categories.improvements) {
140
+ result += `- ${c}\n`;
141
+ }
142
+ result += "\n";
143
+ }
144
+ if (categories.other.length > 0) {
145
+ result += `### Other Changes (${categories.other.length})\n`;
146
+ for (const c of categories.other) {
147
+ result += `- ${c}\n`;
148
+ }
149
+ result += "\n";
150
+ }
151
+ result += `---\n`;
152
+ result += `**Instructions for the AI agent**: Use the commit list above to write user-facing "What's New" text for the App Store. Guidelines:\n`;
153
+ result += `- Write for end users, not developers (no commit hashes, no technical jargon)\n`;
154
+ result += `- Lead with the most impactful change\n`;
155
+ result += `- Keep it under ${WHATS_NEW_MAX} characters\n`;
156
+ result += `- Use short bullet points\n`;
157
+ result += `- Do not mention internal refactors or build changes unless they affect the user\n`;
158
+ return result;
159
+ }
160
+ //# sourceMappingURL=release-notes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"release-notes.js","sourceRoot":"","sources":["../../src/tools/release-notes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import type { ASCClient } from "../client.js";
2
+ import type { Tier } from "../types.js";
3
+ export declare const releasePreflightDefinition: {
4
+ name: string;
5
+ description: string;
6
+ inputSchema: {
7
+ type: "object";
8
+ properties: {
9
+ app_id: {
10
+ type: string;
11
+ description: string;
12
+ };
13
+ };
14
+ required: string[];
15
+ };
16
+ };
17
+ export declare function releasePreflight(client: ASCClient, args: {
18
+ app_id: string;
19
+ }, tier: Tier): Promise<string>;
20
+ //# sourceMappingURL=release-preflight.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"release-preflight.d.ts","sourceRoot":"","sources":["../../src/tools/release-preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAkDxC,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;CAetC,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EACxB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,MAAM,CAAC,CAiTjB"}
@@ -0,0 +1,310 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.releasePreflightDefinition = void 0;
4
+ exports.releasePreflight = releasePreflight;
5
+ // Apple's metadata character limits
6
+ const LIMITS = {
7
+ description: { min: 10, max: 4000 },
8
+ keywords: { max: 100 },
9
+ whatsNew: { max: 4000 },
10
+ promotionalText: { max: 170 },
11
+ appName: { max: 30 },
12
+ subtitle: { max: 30 },
13
+ };
14
+ // Required screenshot display types per device class
15
+ const REQUIRED_SCREENSHOT_TYPES = [
16
+ "APP_IPHONE_67", // iPhone 6.7" (required)
17
+ "APP_IPHONE_65", // iPhone 6.5" (required)
18
+ ];
19
+ exports.releasePreflightDefinition = {
20
+ name: "release_preflight",
21
+ description: "Run a pre-submission audit on a pending app version. Checks metadata completeness, character limits, screenshot coverage, build status, and common rejection causes. Returns a pass/warn/fail report.",
22
+ inputSchema: {
23
+ type: "object",
24
+ properties: {
25
+ app_id: {
26
+ type: "string",
27
+ description: "The App Store Connect app ID. Use list_apps to find it.",
28
+ },
29
+ },
30
+ required: ["app_id"],
31
+ },
32
+ };
33
+ async function releasePreflight(client, args, tier) {
34
+ if (tier !== "pro") {
35
+ return ("Release preflight audit requires a Pro license ($9/mo).\n" +
36
+ "Get your license at: https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu\n\n" +
37
+ "Set ASC_LICENSE_KEY in your MCP server config to unlock.");
38
+ }
39
+ const checks = [];
40
+ // 1. Get latest version
41
+ const versionsResponse = await client.get(`/v1/apps/${args.app_id}/appStoreVersions`, {
42
+ "fields[appStoreVersions]": "versionString,platform,appStoreState,createdDate",
43
+ limit: "5",
44
+ });
45
+ const versions = Array.isArray(versionsResponse.data)
46
+ ? versionsResponse.data
47
+ : [versionsResponse.data];
48
+ if (versions.length === 0) {
49
+ return "No versions found for this app. Nothing to preflight.";
50
+ }
51
+ // Find the editable version (not yet live)
52
+ const editableStates = [
53
+ "PREPARE_FOR_SUBMISSION",
54
+ "READY_FOR_REVIEW",
55
+ "WAITING_FOR_REVIEW",
56
+ "DEVELOPER_REJECTED",
57
+ ];
58
+ const pendingVersion = versions.find((v) => editableStates.includes(v.attributes.appStoreState));
59
+ const targetVersion = pendingVersion || versions[0];
60
+ const versionId = targetVersion.id;
61
+ const versionString = targetVersion.attributes.versionString;
62
+ const versionState = targetVersion.attributes.appStoreState;
63
+ let result = `## Release Preflight: v${versionString}\n\n`;
64
+ result += `**State**: ${versionState}\n`;
65
+ result += `**Platform**: ${targetVersion.attributes.platform}\n\n`;
66
+ if (!pendingVersion) {
67
+ checks.push({
68
+ status: "warn",
69
+ message: "No pending version found. Auditing the latest version instead. Create a new version in App Store Connect if you intend to submit an update.",
70
+ });
71
+ }
72
+ // 2. Get localizations for this version
73
+ let localizations = [];
74
+ try {
75
+ const locResponse = await client.get(`/v1/appStoreVersions/${versionId}/appStoreVersionLocalizations`, {
76
+ "fields[appStoreVersionLocalizations]": "locale,description,keywords,whatsNew,promotionalText,marketingUrl,supportUrl",
77
+ limit: "30",
78
+ });
79
+ localizations = Array.isArray(locResponse.data)
80
+ ? locResponse.data
81
+ : [locResponse.data];
82
+ }
83
+ catch (err) {
84
+ const msg = err instanceof Error ? err.message : String(err);
85
+ checks.push({
86
+ status: "fail",
87
+ message: `Could not fetch localizations: ${msg.slice(0, 200)}`,
88
+ });
89
+ }
90
+ // 3. Check each localization
91
+ for (const loc of localizations) {
92
+ const a = loc.attributes;
93
+ const locale = a.locale;
94
+ // Description required
95
+ if (!a.description || a.description.trim().length === 0) {
96
+ checks.push({
97
+ status: "fail",
98
+ message: `[${locale}] Description is EMPTY. Required for submission.`,
99
+ });
100
+ }
101
+ else if (a.description.length < LIMITS.description.min) {
102
+ checks.push({
103
+ status: "fail",
104
+ message: `[${locale}] Description too short (${a.description.length} chars, min ${LIMITS.description.min}).`,
105
+ });
106
+ }
107
+ else if (a.description.length > LIMITS.description.max) {
108
+ checks.push({
109
+ status: "fail",
110
+ message: `[${locale}] Description too long (${a.description.length}/${LIMITS.description.max} chars).`,
111
+ });
112
+ }
113
+ else {
114
+ checks.push({
115
+ status: "pass",
116
+ message: `[${locale}] Description OK (${a.description.length}/${LIMITS.description.max} chars).`,
117
+ });
118
+ }
119
+ // Keywords
120
+ if (a.keywords && a.keywords.length > LIMITS.keywords.max) {
121
+ checks.push({
122
+ status: "fail",
123
+ message: `[${locale}] Keywords too long (${a.keywords.length}/${LIMITS.keywords.max} chars).`,
124
+ });
125
+ }
126
+ else if (!a.keywords || a.keywords.trim().length === 0) {
127
+ checks.push({
128
+ status: "warn",
129
+ message: `[${locale}] Keywords empty. Not required but strongly recommended for discoverability.`,
130
+ });
131
+ }
132
+ else {
133
+ checks.push({
134
+ status: "pass",
135
+ message: `[${locale}] Keywords OK (${a.keywords.length}/${LIMITS.keywords.max} chars).`,
136
+ });
137
+ }
138
+ // What's New (required for updates, not for first version)
139
+ if (versionString !== "1.0" && versionString !== "1.0.0") {
140
+ if (!a.whatsNew || a.whatsNew.trim().length === 0) {
141
+ checks.push({
142
+ status: "fail",
143
+ message: `[${locale}] "What's New" is EMPTY. Required for updates.`,
144
+ });
145
+ }
146
+ else if (a.whatsNew.length > LIMITS.whatsNew.max) {
147
+ checks.push({
148
+ status: "fail",
149
+ message: `[${locale}] "What's New" too long (${a.whatsNew.length}/${LIMITS.whatsNew.max}).`,
150
+ });
151
+ }
152
+ else {
153
+ checks.push({
154
+ status: "pass",
155
+ message: `[${locale}] "What's New" OK (${a.whatsNew.length} chars).`,
156
+ });
157
+ }
158
+ }
159
+ // Promotional text
160
+ if (a.promotionalText && a.promotionalText.length > LIMITS.promotionalText.max) {
161
+ checks.push({
162
+ status: "fail",
163
+ message: `[${locale}] Promotional text too long (${a.promotionalText.length}/${LIMITS.promotionalText.max}).`,
164
+ });
165
+ }
166
+ // Support URL (required)
167
+ if (!a.supportUrl || a.supportUrl.trim().length === 0) {
168
+ checks.push({
169
+ status: "fail",
170
+ message: `[${locale}] Support URL is EMPTY. Required for submission.`,
171
+ });
172
+ }
173
+ }
174
+ if (localizations.length === 0) {
175
+ checks.push({
176
+ status: "fail",
177
+ message: "No localizations found. At least one locale is required.",
178
+ });
179
+ }
180
+ // 4. Check screenshot sets (via localizations)
181
+ try {
182
+ let totalScreenshotSets = 0;
183
+ const allDisplayTypes = new Set();
184
+ for (const loc of localizations.slice(0, 5)) {
185
+ try {
186
+ const setsResponse = await client.get(`/v1/appStoreVersionLocalizations/${loc.id}/appScreenshotSets`, {
187
+ "fields[appScreenshotSets]": "screenshotDisplayType",
188
+ limit: "20",
189
+ });
190
+ const sets = Array.isArray(setsResponse.data)
191
+ ? setsResponse.data
192
+ : setsResponse.data ? [setsResponse.data] : [];
193
+ totalScreenshotSets += sets.length;
194
+ for (const s of sets) {
195
+ allDisplayTypes.add(s.attributes.screenshotDisplayType);
196
+ }
197
+ }
198
+ catch {
199
+ // Individual locale screenshot check failed, continue
200
+ }
201
+ }
202
+ if (totalScreenshotSets === 0 && localizations.length > 0) {
203
+ checks.push({
204
+ status: "fail",
205
+ message: "No screenshot sets found in any locale. Screenshots are required for submission.",
206
+ });
207
+ }
208
+ else if (totalScreenshotSets > 0) {
209
+ checks.push({
210
+ status: "pass",
211
+ message: `${totalScreenshotSets} screenshot set(s) found across ${Math.min(localizations.length, 5)} locale(s).`,
212
+ });
213
+ for (const required of REQUIRED_SCREENSHOT_TYPES) {
214
+ if (!allDisplayTypes.has(required)) {
215
+ checks.push({
216
+ status: "warn",
217
+ message: `Missing screenshot set for ${required}. May be required depending on device support.`,
218
+ });
219
+ }
220
+ }
221
+ }
222
+ }
223
+ catch (err) {
224
+ const msg = err instanceof Error ? err.message : String(err);
225
+ checks.push({
226
+ status: "warn",
227
+ message: `Could not check screenshots: ${msg.slice(0, 200)}`,
228
+ });
229
+ }
230
+ // 5. Check build attachment
231
+ try {
232
+ const buildResponse = await client.get(`/v1/appStoreVersions/${versionId}/build`, {
233
+ "fields[builds]": "version,processingState,uploadedDate",
234
+ });
235
+ const build = Array.isArray(buildResponse.data)
236
+ ? buildResponse.data[0]
237
+ : buildResponse.data;
238
+ if (!build) {
239
+ checks.push({
240
+ status: "fail",
241
+ message: "No build attached to this version. Upload a build first.",
242
+ });
243
+ }
244
+ else {
245
+ const state = build.attributes.processingState;
246
+ if (state === "VALID") {
247
+ checks.push({
248
+ status: "pass",
249
+ message: `Build ${build.attributes.version} attached and valid.`,
250
+ });
251
+ }
252
+ else if (state === "PROCESSING") {
253
+ checks.push({
254
+ status: "warn",
255
+ message: `Build ${build.attributes.version} is still processing. Wait before submitting.`,
256
+ });
257
+ }
258
+ else {
259
+ checks.push({
260
+ status: "fail",
261
+ message: `Build ${build.attributes.version} state: ${state}. May not be submittable.`,
262
+ });
263
+ }
264
+ }
265
+ }
266
+ catch (err) {
267
+ const msg = err instanceof Error ? err.message : String(err);
268
+ checks.push({
269
+ status: "warn",
270
+ message: `Could not check build: ${msg.slice(0, 200)}`,
271
+ });
272
+ }
273
+ // 6. Compile report
274
+ const fails = checks.filter((c) => c.status === "fail");
275
+ const warns = checks.filter((c) => c.status === "warn");
276
+ const passes = checks.filter((c) => c.status === "pass");
277
+ if (fails.length === 0 && warns.length === 0) {
278
+ result += "### PASS: Ready to submit\n\n";
279
+ }
280
+ else if (fails.length === 0) {
281
+ result += `### PASS (with ${warns.length} warning${warns.length > 1 ? "s" : ""})\n\n`;
282
+ }
283
+ else {
284
+ result += `### FAIL: ${fails.length} issue${fails.length > 1 ? "s" : ""} must be fixed before submission\n\n`;
285
+ }
286
+ if (fails.length > 0) {
287
+ result += "**Failures (must fix):**\n";
288
+ for (const c of fails) {
289
+ result += `- ${c.message}\n`;
290
+ }
291
+ result += "\n";
292
+ }
293
+ if (warns.length > 0) {
294
+ result += "**Warnings (recommended):**\n";
295
+ for (const c of warns) {
296
+ result += `- ${c.message}\n`;
297
+ }
298
+ result += "\n";
299
+ }
300
+ if (passes.length > 0) {
301
+ result += `**Passing checks:** ${passes.length}\n`;
302
+ for (const c of passes) {
303
+ result += `- ${c.message}\n`;
304
+ }
305
+ }
306
+ result += `\n---\nTotal: ${passes.length} pass, ${warns.length} warn, ${fails.length} fail\n`;
307
+ result += `Locales checked: ${localizations.length}\n`;
308
+ return result;
309
+ }
310
+ //# sourceMappingURL=release-preflight.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"release-preflight.js","sourceRoot":"","sources":["../../src/tools/release-preflight.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { ASCClient } from "../client.js";
2
+ export declare const reviewStatusDefinition: {
3
+ name: string;
4
+ description: string;
5
+ inputSchema: {
6
+ type: "object";
7
+ properties: {
8
+ app_id: {
9
+ type: string;
10
+ description: string;
11
+ };
12
+ };
13
+ required: string[];
14
+ };
15
+ };
16
+ export declare function reviewStatus(client: ASCClient, args: {
17
+ app_id: string;
18
+ }): Promise<string>;
19
+ //# sourceMappingURL=review-status.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"review-status.d.ts","sourceRoot":"","sources":["../../src/tools/review-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAc9C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAelC,CAAC;AAEF,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC,MAAM,CAAC,CAqEjB"}
@@ -0,0 +1,95 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.reviewStatusDefinition = void 0;
4
+ exports.reviewStatus = reviewStatus;
5
+ exports.reviewStatusDefinition = {
6
+ name: "review_status",
7
+ description: "Check the current App Store review status for an app. Shows whether the app is in review, waiting for review, approved, or rejected.",
8
+ inputSchema: {
9
+ type: "object",
10
+ properties: {
11
+ app_id: {
12
+ type: "string",
13
+ description: "The App Store Connect app ID. Use list_apps to find it.",
14
+ },
15
+ },
16
+ required: ["app_id"],
17
+ },
18
+ };
19
+ async function reviewStatus(client, args) {
20
+ // Get all versions sorted by newest first
21
+ const versionsResponse = await client.get(`/v1/apps/${args.app_id}/appStoreVersions`, {
22
+ "fields[appStoreVersions]": "versionString,platform,appStoreState,createdDate",
23
+ limit: "5",
24
+ });
25
+ const versions = Array.isArray(versionsResponse.data)
26
+ ? versionsResponse.data
27
+ : [versionsResponse.data];
28
+ if (versions.length === 0) {
29
+ return "No versions found for this app.";
30
+ }
31
+ const reviewStates = [
32
+ "WAITING_FOR_REVIEW",
33
+ "IN_REVIEW",
34
+ "PENDING_APPLE_RELEASE",
35
+ "PENDING_DEVELOPER_RELEASE",
36
+ "READY_FOR_REVIEW",
37
+ ];
38
+ const activeVersions = versions.filter((v) => reviewStates.includes(v.attributes.appStoreState));
39
+ const latestVersion = versions[0];
40
+ let result = `## Review Status for App ${args.app_id}\n\n`;
41
+ result += `**Latest version**: v${latestVersion.attributes.versionString} (${latestVersion.attributes.platform})\n`;
42
+ result += `**State**: ${formatReviewState(latestVersion.attributes.appStoreState)}\n`;
43
+ result += `**Created**: ${latestVersion.attributes.createdDate.split("T")[0]}\n\n`;
44
+ if (activeVersions.length > 0) {
45
+ const active = activeVersions[0];
46
+ const state = active.attributes.appStoreState;
47
+ if (state === "IN_REVIEW") {
48
+ result += "Your app is **currently being reviewed** by Apple. Typical review time is 24-48 hours.\n";
49
+ }
50
+ else if (state === "WAITING_FOR_REVIEW") {
51
+ result += "Your app is **in the review queue**. It has not been picked up by a reviewer yet.\n";
52
+ }
53
+ else if (state === "PENDING_APPLE_RELEASE") {
54
+ result += "Your app has been **approved** and is pending Apple's release.\n";
55
+ }
56
+ else if (state === "PENDING_DEVELOPER_RELEASE") {
57
+ result += "Your app has been **approved** and is waiting for you to release it.\n";
58
+ }
59
+ else if (state === "READY_FOR_REVIEW") {
60
+ result += "Your version is **ready for review** but has not been submitted yet.\n";
61
+ }
62
+ }
63
+ else if (latestVersion.attributes.appStoreState === "READY_FOR_SALE") {
64
+ result += "Your latest version is **live on the App Store**. No pending reviews.\n";
65
+ }
66
+ else if (latestVersion.attributes.appStoreState === "REJECTED") {
67
+ result += "Your latest version was **rejected**. Check App Store Connect for rejection details.\n";
68
+ }
69
+ else if (latestVersion.attributes.appStoreState === "METADATA_REJECTED") {
70
+ result += "Your latest version has a **metadata rejection**. Update metadata and resubmit.\n";
71
+ }
72
+ // Show all recent versions
73
+ if (versions.length > 1) {
74
+ result += "\n### All Recent Versions\n\n";
75
+ for (const v of versions) {
76
+ result += `- v${v.attributes.versionString} (${v.attributes.platform}): ${formatReviewState(v.attributes.appStoreState)}\n`;
77
+ }
78
+ }
79
+ return result;
80
+ }
81
+ function formatReviewState(state) {
82
+ const emoji = {
83
+ WAITING_FOR_REVIEW: "Waiting for Review",
84
+ IN_REVIEW: "In Review",
85
+ PENDING_APPLE_RELEASE: "Approved — Pending Release",
86
+ PENDING_DEVELOPER_RELEASE: "Approved — Pending Your Release",
87
+ READY_FOR_SALE: "Live",
88
+ REJECTED: "Rejected",
89
+ METADATA_REJECTED: "Metadata Rejected",
90
+ PREPARE_FOR_SUBMISSION: "Preparing",
91
+ READY_FOR_REVIEW: "Ready for Review (not submitted)",
92
+ };
93
+ return emoji[state] || state;
94
+ }
95
+ //# sourceMappingURL=review-status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"review-status.js","sourceRoot":"","sources":["../../src/tools/review-status.ts"],"names":[],"mappings":"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"}