@pofky/asc-mcp 1.2.0 → 1.8.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 (119) hide show
  1. package/LIMITATIONS.md +41 -0
  2. package/README.md +91 -10
  3. package/USER_GUIDE.md +185 -0
  4. package/dist/client.d.ts +5 -0
  5. package/dist/client.d.ts.map +1 -1
  6. package/dist/client.js +58 -1
  7. package/dist/client.js.map +1 -1
  8. package/dist/doctor.d.ts +28 -0
  9. package/dist/doctor.d.ts.map +1 -0
  10. package/dist/doctor.js +178 -0
  11. package/dist/doctor.js.map +1 -0
  12. package/dist/editable.d.ts +9 -0
  13. package/dist/editable.d.ts.map +1 -0
  14. package/dist/editable.js +20 -0
  15. package/dist/editable.js.map +1 -0
  16. package/dist/elicitation.d.ts +39 -0
  17. package/dist/elicitation.d.ts.map +1 -0
  18. package/dist/elicitation.js +63 -0
  19. package/dist/elicitation.js.map +1 -0
  20. package/dist/gate.d.ts +8 -0
  21. package/dist/gate.d.ts.map +1 -0
  22. package/dist/gate.js +17 -0
  23. package/dist/gate.js.map +1 -0
  24. package/dist/index.js +308 -16
  25. package/dist/index.js.map +1 -1
  26. package/dist/license.js +1 -1
  27. package/dist/prompts.d.ts.map +1 -1
  28. package/dist/prompts.js +101 -0
  29. package/dist/prompts.js.map +1 -1
  30. package/dist/sampling.d.ts +53 -0
  31. package/dist/sampling.d.ts.map +1 -0
  32. package/dist/sampling.js +109 -0
  33. package/dist/sampling.js.map +1 -0
  34. package/dist/setup.d.ts +19 -0
  35. package/dist/setup.d.ts.map +1 -0
  36. package/dist/setup.js +153 -0
  37. package/dist/setup.js.map +1 -0
  38. package/dist/tools/age-rating.d.ts +14 -0
  39. package/dist/tools/age-rating.d.ts.map +1 -0
  40. package/dist/tools/age-rating.js +125 -0
  41. package/dist/tools/age-rating.js.map +1 -0
  42. package/dist/tools/app-details.js +2 -2
  43. package/dist/tools/availability.d.ts +20 -0
  44. package/dist/tools/availability.d.ts.map +1 -0
  45. package/dist/tools/availability.js +96 -0
  46. package/dist/tools/availability.js.map +1 -0
  47. package/dist/tools/builds.d.ts +26 -0
  48. package/dist/tools/builds.d.ts.map +1 -0
  49. package/dist/tools/builds.js +108 -0
  50. package/dist/tools/builds.js.map +1 -0
  51. package/dist/tools/draft-review-response.d.ts +37 -0
  52. package/dist/tools/draft-review-response.d.ts.map +1 -0
  53. package/dist/tools/draft-review-response.js +236 -0
  54. package/dist/tools/draft-review-response.js.map +1 -0
  55. package/dist/tools/eu-trader.d.ts +12 -0
  56. package/dist/tools/eu-trader.d.ts.map +1 -0
  57. package/dist/tools/eu-trader.js +25 -0
  58. package/dist/tools/eu-trader.js.map +1 -0
  59. package/dist/tools/guide.d.ts +38 -0
  60. package/dist/tools/guide.d.ts.map +1 -0
  61. package/dist/tools/guide.js +273 -0
  62. package/dist/tools/guide.js.map +1 -0
  63. package/dist/tools/iap.d.ts +43 -0
  64. package/dist/tools/iap.d.ts.map +1 -0
  65. package/dist/tools/iap.js +360 -0
  66. package/dist/tools/iap.js.map +1 -0
  67. package/dist/tools/list-apps.js +1 -1
  68. package/dist/tools/list-reviews.js +2 -2
  69. package/dist/tools/local-build.d.ts +26 -0
  70. package/dist/tools/local-build.d.ts.map +1 -0
  71. package/dist/tools/local-build.js +100 -0
  72. package/dist/tools/local-build.js.map +1 -0
  73. package/dist/tools/privacy.d.ts +15 -0
  74. package/dist/tools/privacy.d.ts.map +1 -0
  75. package/dist/tools/privacy.js +32 -0
  76. package/dist/tools/privacy.js.map +1 -0
  77. package/dist/tools/release-control.d.ts +22 -0
  78. package/dist/tools/release-control.d.ts.map +1 -0
  79. package/dist/tools/release-control.js +85 -0
  80. package/dist/tools/release-control.js.map +1 -0
  81. package/dist/tools/release-preflight.d.ts.map +1 -1
  82. package/dist/tools/release-preflight.js +139 -0
  83. package/dist/tools/release-preflight.js.map +1 -1
  84. package/dist/tools/review-screenshot.d.ts +14 -0
  85. package/dist/tools/review-screenshot.d.ts.map +1 -0
  86. package/dist/tools/review-screenshot.js +72 -0
  87. package/dist/tools/review-screenshot.js.map +1 -0
  88. package/dist/tools/review-status.js +2 -2
  89. package/dist/tools/sales-report.js +3 -3
  90. package/dist/tools/sales-report.js.map +1 -1
  91. package/dist/tools/screenshots.d.ts +15 -0
  92. package/dist/tools/screenshots.d.ts.map +1 -0
  93. package/dist/tools/screenshots.js +106 -0
  94. package/dist/tools/screenshots.js.map +1 -0
  95. package/dist/tools/signing.d.ts +21 -0
  96. package/dist/tools/signing.d.ts.map +1 -0
  97. package/dist/tools/signing.js +101 -0
  98. package/dist/tools/signing.js.map +1 -0
  99. package/dist/tools/submission.d.ts +47 -0
  100. package/dist/tools/submission.d.ts.map +1 -0
  101. package/dist/tools/submission.js +199 -0
  102. package/dist/tools/submission.js.map +1 -0
  103. package/dist/tools/testflight.d.ts +20 -0
  104. package/dist/tools/testflight.d.ts.map +1 -0
  105. package/dist/tools/testflight.js +75 -0
  106. package/dist/tools/testflight.js.map +1 -0
  107. package/dist/tools/triage-reviews.d.ts +35 -0
  108. package/dist/tools/triage-reviews.d.ts.map +1 -0
  109. package/dist/tools/triage-reviews.js +194 -0
  110. package/dist/tools/triage-reviews.js.map +1 -0
  111. package/dist/tools/update-version-metadata.d.ts +17 -0
  112. package/dist/tools/update-version-metadata.d.ts.map +1 -0
  113. package/dist/tools/update-version-metadata.js +148 -0
  114. package/dist/tools/update-version-metadata.js.map +1 -0
  115. package/dist/tools/version-control.d.ts +21 -0
  116. package/dist/tools/version-control.d.ts.map +1 -0
  117. package/dist/tools/version-control.js +144 -0
  118. package/dist/tools/version-control.js.map +1 -0
  119. package/package.json +5 -2
package/dist/doctor.js ADDED
@@ -0,0 +1,178 @@
1
+ "use strict";
2
+ /**
3
+ * Self-diagnosis for setup. The #1 newbie failure mode is "it doesn't work" with
4
+ * no idea why: missing .p8, wrong Issuer ID, a key without the right role, or an
5
+ * unset license. `runDoctor` checks each link in the chain and, for every
6
+ * failure, prints the exact next step. Powers both `asc-mcp doctor` (CLI, runs
7
+ * before the server is even configured) and the free `asc_setup_check` MCP tool.
8
+ */
9
+ Object.defineProperty(exports, "__esModule", { value: true });
10
+ exports.runDoctor = runDoctor;
11
+ exports.formatDoctor = formatDoctor;
12
+ const node_fs_1 = require("node:fs");
13
+ const node_path_1 = require("node:path");
14
+ const node_os_1 = require("node:os");
15
+ const auth_js_1 = require("./auth.js");
16
+ const license_js_1 = require("./license.js");
17
+ const setup_js_1 = require("./setup.js");
18
+ const INTEGRATIONS_URL = "https://appstoreconnect.apple.com/access/integrations/api";
19
+ function resolvePath(p) {
20
+ return p.startsWith("~") ? (0, node_path_1.resolve)((0, node_os_1.homedir)(), p.slice(2)) : (0, node_path_1.resolve)(p);
21
+ }
22
+ /**
23
+ * Run the full setup diagnosis. Reads env + the standard .p8 path, then attempts
24
+ * a real authenticated API call so "looks configured" and "actually works" are
25
+ * never confused.
26
+ */
27
+ async function runDoctor() {
28
+ const checks = [];
29
+ // 1. Private key (.p8) discovery / path.
30
+ const discovered = (0, setup_js_1.discoverPrivateKey)();
31
+ const keyPath = process.env.ASC_PRIVATE_KEY_PATH || discovered?.path;
32
+ if (!keyPath) {
33
+ checks.push({
34
+ name: "API key file (.p8)",
35
+ status: "fail",
36
+ detail: "No .p8 found in ~/.appstoreconnect/private_keys/ and ASC_PRIVATE_KEY_PATH is unset.",
37
+ fix: `Create a key at ${INTEGRATIONS_URL} (role: App Manager), download the .p8 once, and drop it into ~/.appstoreconnect/private_keys/.`,
38
+ });
39
+ }
40
+ else if (!(0, node_fs_1.existsSync)(resolvePath(keyPath))) {
41
+ checks.push({
42
+ name: "API key file (.p8)",
43
+ status: "fail",
44
+ detail: `Path is set but the file does not exist: ${keyPath}`,
45
+ fix: "Check the path, or move the .p8 to ~/.appstoreconnect/private_keys/ and unset ASC_PRIVATE_KEY_PATH to auto-detect it.",
46
+ });
47
+ }
48
+ else {
49
+ checks.push({
50
+ name: "API key file (.p8)",
51
+ status: "ok",
52
+ detail: `Found ${keyPath}`,
53
+ });
54
+ }
55
+ // 2. Key ID.
56
+ const keyId = process.env.ASC_KEY_ID || discovered?.keyId;
57
+ if (!keyId) {
58
+ checks.push({
59
+ name: "Key ID",
60
+ status: "fail",
61
+ detail: "No Key ID. It is normally read from the .p8 filename (AuthKey_XXXXXXXXXX.p8).",
62
+ fix: "Either name the file AuthKey_<KeyID>.p8 in the standard folder, or set ASC_KEY_ID.",
63
+ });
64
+ }
65
+ else {
66
+ checks.push({ name: "Key ID", status: "ok", detail: keyId });
67
+ }
68
+ // 3. Issuer ID.
69
+ const issuerId = process.env.ASC_ISSUER_ID;
70
+ if (!issuerId) {
71
+ checks.push({
72
+ name: "Issuer ID",
73
+ status: "fail",
74
+ detail: "ASC_ISSUER_ID is unset.",
75
+ fix: `Copy the Issuer ID (a UUID at the top of ${INTEGRATIONS_URL}) and set ASC_ISSUER_ID. Run \`asc-mcp init\` to generate the config.`,
76
+ });
77
+ }
78
+ else {
79
+ checks.push({ name: "Issuer ID", status: "ok", detail: issuerId });
80
+ }
81
+ // 4. Live authentication: only attempt if the three inputs are present.
82
+ if (keyId && issuerId && keyPath && (0, node_fs_1.existsSync)(resolvePath(keyPath))) {
83
+ try {
84
+ (0, auth_js_1.clearTokenCache)();
85
+ const token = await (0, auth_js_1.getToken)(keyId, issuerId, keyPath);
86
+ const res = await fetch("https://api.appstoreconnect.apple.com/v1/apps?limit=1", { headers: { Authorization: `Bearer ${token}` } });
87
+ if (res.ok) {
88
+ checks.push({
89
+ name: "Live connection",
90
+ status: "ok",
91
+ detail: "Authenticated against App Store Connect and listed apps.",
92
+ });
93
+ }
94
+ else if (res.status === 401) {
95
+ checks.push({
96
+ name: "Live connection",
97
+ status: "fail",
98
+ detail: "Apple rejected the credentials (401).",
99
+ fix: "Issuer ID, Key ID, or .p8 mismatch. Recheck the Issuer ID UUID and confirm the .p8 matches the Key ID. Regenerate the key if unsure.",
100
+ });
101
+ }
102
+ else if (res.status === 403) {
103
+ checks.push({
104
+ name: "Live connection",
105
+ status: "fail",
106
+ detail: "Authenticated but not authorized (403).",
107
+ fix: "The key's role is too low. Give it App Manager (or higher) at the Integrations page, or generate a new key with that role.",
108
+ });
109
+ }
110
+ else {
111
+ checks.push({
112
+ name: "Live connection",
113
+ status: "fail",
114
+ detail: `App Store Connect returned ${res.status}.`,
115
+ fix: "Transient Apple error or network issue. Retry; if it persists, regenerate the key.",
116
+ });
117
+ }
118
+ }
119
+ catch (err) {
120
+ const msg = err instanceof Error ? err.message : String(err);
121
+ checks.push({
122
+ name: "Live connection",
123
+ status: "fail",
124
+ detail: `Could not sign or send the request: ${msg}`,
125
+ fix: "Usually a malformed .p8 (must be the downloaded PKCS#8 file, unchanged) or no network. Re-download the key if needed.",
126
+ });
127
+ }
128
+ }
129
+ else {
130
+ checks.push({
131
+ name: "Live connection",
132
+ status: "warn",
133
+ detail: "Skipped: fix the credential checks above first.",
134
+ });
135
+ }
136
+ // 5. License tier.
137
+ const licenseKey = process.env.ASC_LICENSE_KEY;
138
+ if (!licenseKey) {
139
+ checks.push({
140
+ name: "License",
141
+ status: "warn",
142
+ detail: "Free tier: read + intelligence tools only.",
143
+ fix: "To unlock write/control tools (edit metadata, screenshots, builds, submit, IAP/subs), set ASC_LICENSE_KEY. Get one at https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu",
144
+ });
145
+ }
146
+ else {
147
+ const tier = await (0, license_js_1.validateLicense)(licenseKey);
148
+ if (tier === "pro") {
149
+ checks.push({ name: "License", status: "ok", detail: "Pro: all tools unlocked." });
150
+ }
151
+ else {
152
+ checks.push({
153
+ name: "License",
154
+ status: "fail",
155
+ detail: "A license key is set but did not validate as Pro.",
156
+ fix: "Check the key (retrieve it at https://asc-mcp-license.remewdy.workers.dev/key). Network issues fall back to free; retry if you are online.",
157
+ });
158
+ }
159
+ }
160
+ const healthy = !checks.some((c) => c.status === "fail");
161
+ return { checks, healthy };
162
+ }
163
+ const ICON = { ok: "[OK] ", warn: "[WARN]", fail: "[FAIL]" };
164
+ /** Human-readable report for the CLI and the MCP tool. */
165
+ function formatDoctor(report) {
166
+ const lines = ["App Store Connect MCP, setup check", "=".repeat(40), ""];
167
+ for (const c of report.checks) {
168
+ lines.push(`${ICON[c.status]} ${c.name}: ${c.detail}`);
169
+ if (c.fix && c.status !== "ok")
170
+ lines.push(` Fix: ${c.fix}`);
171
+ }
172
+ lines.push("");
173
+ lines.push(report.healthy
174
+ ? "Ready. Try `list_apps`, then `asc_guide` (topic:overview) to see every flow."
175
+ : "Not ready yet. Fix the [FAIL] lines above, then run this again.");
176
+ return lines.join("\n");
177
+ }
178
+ //# sourceMappingURL=doctor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * The single definition of which App Store version states are still editable
3
+ * (metadata writable, build attachable, submittable). Previously each tool kept
4
+ * its own copy and they drifted (INVALID_BINARY was in one but not the others),
5
+ * so a rejected-binary version could be edited but not re-attached/submitted.
6
+ * Import this everywhere instead of redefining.
7
+ */
8
+ export declare const EDITABLE_VERSION_STATES: Set<string>;
9
+ //# sourceMappingURL=editable.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editable.d.ts","sourceRoot":"","sources":["../src/editable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,aAQlC,CAAC"}
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.EDITABLE_VERSION_STATES = void 0;
4
+ /**
5
+ * The single definition of which App Store version states are still editable
6
+ * (metadata writable, build attachable, submittable). Previously each tool kept
7
+ * its own copy and they drifted (INVALID_BINARY was in one but not the others),
8
+ * so a rejected-binary version could be edited but not re-attached/submitted.
9
+ * Import this everywhere instead of redefining.
10
+ */
11
+ exports.EDITABLE_VERSION_STATES = new Set([
12
+ "PREPARE_FOR_SUBMISSION",
13
+ "DEVELOPER_REJECTED",
14
+ "REJECTED",
15
+ "METADATA_REJECTED",
16
+ // Binary was rejected; the version is still editable so a new build can be
17
+ // attached and the version resubmitted.
18
+ "INVALID_BINARY",
19
+ ]);
20
+ //# sourceMappingURL=editable.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"editable.js","sourceRoot":"","sources":["../src/editable.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACU,QAAA,uBAAuB,GAAG,IAAI,GAAG,CAAC;IAC7C,wBAAwB;IACxB,oBAAoB;IACpB,UAAU;IACV,mBAAmB;IACnB,2EAA2E;IAC3E,wCAAwC;IACxC,gBAAgB;CACjB,CAAC,CAAC"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * MCP Elicitation helper.
3
+ *
4
+ * Lets a tool ask the user structured questions mid-call via
5
+ * `server.elicitInput(...)`. The client renders a dialog with the schema.
6
+ *
7
+ * Capability detection: if the client does not advertise elicitation, we
8
+ * return `{ unsupported: true }` so the caller can fall back to a default.
9
+ */
10
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
11
+ export type ElicitationResult = {
12
+ ok: true;
13
+ values: Record<string, unknown>;
14
+ } | {
15
+ ok: false;
16
+ unsupported: true;
17
+ } | {
18
+ ok: false;
19
+ declined: true;
20
+ } | {
21
+ ok: false;
22
+ cancelled: true;
23
+ } | {
24
+ ok: false;
25
+ error: string;
26
+ };
27
+ export interface ElicitationSchema {
28
+ type: "object";
29
+ properties: Record<string, unknown>;
30
+ required?: string[];
31
+ }
32
+ export interface ElicitationRequest {
33
+ message: string;
34
+ schema: ElicitationSchema;
35
+ timeoutMs?: number;
36
+ }
37
+ export declare function clientSupportsElicitation(server: McpServer): boolean;
38
+ export declare function elicit(server: McpServer, req: ElicitationRequest): Promise<ElicitationResult>;
39
+ //# sourceMappingURL=elicitation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,IAAI,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAOpE;AAED,wBAAsB,MAAM,CAC1B,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}
@@ -0,0 +1,63 @@
1
+ "use strict";
2
+ /**
3
+ * MCP Elicitation helper.
4
+ *
5
+ * Lets a tool ask the user structured questions mid-call via
6
+ * `server.elicitInput(...)`. The client renders a dialog with the schema.
7
+ *
8
+ * Capability detection: if the client does not advertise elicitation, we
9
+ * return `{ unsupported: true }` so the caller can fall back to a default.
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.clientSupportsElicitation = clientSupportsElicitation;
13
+ exports.elicit = elicit;
14
+ const DEFAULT_TIMEOUT_MS = 60_000;
15
+ function clientSupportsElicitation(server) {
16
+ try {
17
+ const caps = server.server.getClientCapabilities();
18
+ return Boolean(caps?.elicitation);
19
+ }
20
+ catch {
21
+ return false;
22
+ }
23
+ }
24
+ async function elicit(server, req) {
25
+ if (!clientSupportsElicitation(server)) {
26
+ return { ok: false, unsupported: true };
27
+ }
28
+ const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;
29
+ try {
30
+ const result = (await withTimeout(server.server.elicitInput({
31
+ mode: "form",
32
+ message: req.message,
33
+ requestedSchema: req.schema,
34
+ }), timeoutMs));
35
+ if (result.action === "decline")
36
+ return { ok: false, declined: true };
37
+ if (result.action === "cancel")
38
+ return { ok: false, cancelled: true };
39
+ if (result.action !== "accept") {
40
+ return { ok: false, error: `Unknown elicit action: ${result.action}` };
41
+ }
42
+ return { ok: true, values: result.content ?? {} };
43
+ }
44
+ catch (err) {
45
+ const msg = err instanceof Error ? err.message : String(err);
46
+ return { ok: false, error: msg };
47
+ }
48
+ }
49
+ function withTimeout(promise, ms) {
50
+ return new Promise((resolve, reject) => {
51
+ const timer = setTimeout(() => {
52
+ reject(new Error(`Elicitation timed out after ${ms}ms`));
53
+ }, ms);
54
+ promise.then((v) => {
55
+ clearTimeout(timer);
56
+ resolve(v);
57
+ }, (e) => {
58
+ clearTimeout(timer);
59
+ reject(e);
60
+ });
61
+ });
62
+ }
63
+ //# sourceMappingURL=elicitation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"elicitation.js","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAyBH,8DAOC;AAED,wBA8BC;AAzCD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,SAAgB,yBAAyB,CAAC,MAAiB;IACzD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,MAAM,CAC1B,MAAiB,EACjB,GAAuB;IAEvB,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,WAAW,CAC/B,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YACxB,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,eAAe,EAAE,GAAG,CAAC,MAAe;SACrC,CAAC,EACF,SAAS,CACV,CAAmF,CAAC;QAErF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACtE,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACtE,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACzE,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAI,OAAmB,EAAE,EAAU;IACrD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,OAAO,CAAC,IAAI,CACV,CAAC,CAAC,EAAE,EAAE;YACJ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,EACD,CAAC,CAAC,EAAE,EAAE;YACJ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,CAAC,CAAC,CAAC;QACZ,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
package/dist/gate.d.ts ADDED
@@ -0,0 +1,8 @@
1
+ import type { Tier } from "./types.js";
2
+ export declare const UPGRADE_URL = "https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu";
3
+ /**
4
+ * Returns an upgrade message string when the tier is not Pro, otherwise null.
5
+ * Write/control tools call this first and early-return the message.
6
+ */
7
+ export declare function requirePro(tier: Tier, capability: string): string | null;
8
+ //# sourceMappingURL=gate.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,WAAW,8EACqD,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxE"}
package/dist/gate.js ADDED
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.UPGRADE_URL = void 0;
4
+ exports.requirePro = requirePro;
5
+ exports.UPGRADE_URL = "https://buy.polar.sh/polar_cl_Ta3OxEA1EbRyYNPFtSsRXgYWBCCtjwMxlbAeW35RLuu";
6
+ /**
7
+ * Returns an upgrade message string when the tier is not Pro, otherwise null.
8
+ * Write/control tools call this first and early-return the message.
9
+ */
10
+ function requirePro(tier, capability) {
11
+ if (tier === "pro")
12
+ return null;
13
+ return (`${capability} requires a Pro license ($9/mo).\n` +
14
+ `Get your license at: ${exports.UPGRADE_URL}\n\n` +
15
+ "Set ASC_LICENSE_KEY in your MCP server config to unlock.");
16
+ }
17
+ //# sourceMappingURL=gate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gate.js","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":";;;AASA,gCAOC;AAdY,QAAA,WAAW,GACtB,2EAA2E,CAAC;AAE9E;;;GAGG;AACH,SAAgB,UAAU,CAAC,IAAU,EAAE,UAAkB;IACvD,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,CACL,GAAG,UAAU,oCAAoC;QACjD,wBAAwB,mBAAW,MAAM;QACzC,0DAA0D,CAC3D,CAAC;AACJ,CAAC"}