@rage-against-the-pixel/app-store-connect-api 3.6.0

package/dist/app_store_connect_api/types.gen.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file is auto-generated by @hey-api/openapi-ts
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/client.d.ts

@@ -0,0 +1,45 @@
+import * as services from './app_store_connect_api/services.gen';
+/**
+ * Options for configuring the App Store Connect client.
+ * @see https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api
+ */
+interface AppStoreConnectOptions {
+    /**
+     * The issuer ID associated with the private key.
+     */
+    issuerId?: string;
+    /**
+     * The ID of the private key.
+     */
+    privateKeyId?: string;
+    /**
+     * The private key in PEM format.
+     */
+    privateKey?: string;
+    /**
+     * The path to the private key file.
+     */
+    privateKeyFile?: string;
+    /**
+     * A bearer token can be provided directly, which will be used instead of generating a new token
+     */
+    bearerToken?: string;
+    /**
+     * The time (in seconds) until the token expires (default 10 minutes)
+     */
+    expirationTime?: number;
+}
+declare class AppStoreConnectClient {
+    private appStoreConnectOptions;
+    private bearerToken;
+    private bearerTokenGeneratedAt;
+    api: typeof services;
+    constructor(appStoreConnectOptions: AppStoreConnectOptions);
+    private getToken;
+    /**
+     * Generates a JWT token for authenticating with the App Store Connect API.
+     * @see https://developer.apple.com/documentation/appstoreconnectapi/generating_tokens_for_api_requests
+    */
+    private generateAuthToken;
+}
+export { AppStoreConnectOptions, AppStoreConnectClient };

package/dist/client.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppStoreConnectClient = void 0;
+const services = __importStar(require("./app_store_connect_api/services.gen"));
+const jose = __importStar(require("jose"));
+const fs_1 = __importDefault(require("fs"));
+class AppStoreConnectClient {
+    appStoreConnectOptions;
+    bearerToken = null;
+    bearerTokenGeneratedAt = 0;
+    api = services;
+    constructor(appStoreConnectOptions) {
+        if (!appStoreConnectOptions) {
+            throw new Error('AppStoreConnectOptions is required');
+        }
+        this.appStoreConnectOptions = appStoreConnectOptions;
+        services.client.setConfig({ baseUrl: 'https://api.appstoreconnect.apple.com' });
+        services.client.interceptors.request.use(async (request, _options) => {
+            request.headers.set('Authorization', `Bearer ${await this.getToken()}`);
+            return request;
+        });
+    }
+    async getToken() {
+        if (this.appStoreConnectOptions.bearerToken) {
+            this.bearerToken = this.appStoreConnectOptions.bearerToken;
+        }
+        else {
+            if (this.appStoreConnectOptions.privateKeyId &&
+                this.appStoreConnectOptions.issuerId &&
+                (this.appStoreConnectOptions.privateKey || this.appStoreConnectOptions.privateKeyFile)) {
+                const defaultExpirationTime = 600; // 10 minutes
+                const expirationTime = this.appStoreConnectOptions.expirationTime ?? defaultExpirationTime;
+                if (!this.bearerToken || this.bearerTokenGeneratedAt + expirationTime * 1000 < Date.now()) {
+                    if (this.appStoreConnectOptions.privateKeyFile) {
+                        const fileHandle = await fs_1.default.promises.open(this.appStoreConnectOptions.privateKeyFile, 'r');
+                        try {
+                            this.appStoreConnectOptions.privateKey = await fileHandle.readFile('utf8');
+                        }
+                        finally {
+                            await fileHandle.close();
+                        }
+                    }
+                    this.bearerToken = await this.generateAuthToken(this.appStoreConnectOptions.issuerId, this.appStoreConnectOptions.privateKeyId, this.appStoreConnectOptions.privateKey, expirationTime);
+                }
+            }
+            else {
+                throw new Error('Bearer token or private key information is required to generate a token');
+            }
+        }
+        return this.bearerToken;
+    }
+    /**
+     * Generates a JWT token for authenticating with the App Store Connect API.
+     * @see https://developer.apple.com/documentation/appstoreconnectapi/generating_tokens_for_api_requests
+    */
+    async generateAuthToken(issuerId, privateKeyId, privateKey, expirationTime) {
+        const alg = "ES256";
+        const key = await jose.importPKCS8(privateKey, alg);
+        const token = await new jose.SignJWT({})
+            .setProtectedHeader({ alg, kid: privateKeyId, typ: "JWT" })
+            .setIssuer(issuerId)
+            .setAudience("appstoreconnect-v1")
+            .setExpirationTime(new Date(Date.now() + expirationTime * 1000))
+            .sign(key);
+        return token;
+    }
+}
+exports.AppStoreConnectClient = AppStoreConnectClient;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './client';

package/dist/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./client"), exports);

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@rage-against-the-pixel/app-store-connect-api",
+  "version": "3.6.0",
+  "description": "A TypeScript package for communicating with Apple App Store Connect API",
+  "author": "RageAgainstThePixel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RageAgainstThePixel/app-store-connect-api"
+  },
+  "keywords": [
+    "apple",
+    "app store",
+    "connect",
+    "api",
+    "api client",
+    "app store api",
+    "app store connect",
+    "app store connect api",
+    "app-store-connect",
+    "app-store-connect-api",
+    "typescript"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -w",
+    "openapi-ts": "openapi-ts",
+    "test": "jest",
+    "generate": "npx @hey-api/openapi-ts -f ./openapi-ts.config.ts && tsc"
+  },
+  "devDependencies": {
+    "@hey-api/openapi-ts": "^0.53.10",
+    "@types/jest": "^29.5.13",
+    "@types/node": "^22.7.5",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.3"
+  },
+  "dependencies": {
+    "@hey-api/client-fetch": "^0.4.1",
+    "jose": "^5.9.4"
+  }
+}