@hotcodepush/node 0.1.0 → 0.2.1

package/dist/index.mjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.1.0";
+var version = "0.2.1";
 //#endregion
 //#region src/errors.ts
 /**
@@ -64,9 +64,16 @@ var HttpClient = class {
 		this.timeoutMs = options.timeout ?? JSON_TIMEOUT_MS;
 	}
 	async fetchBlob(options) {
-		const response = await this.fetchResponse(options);
-		await assertResponseOk(response);
-		return response.blob();
+		return (await this.fetchOkResponse(options)).blob();
+	}
+	async fetchBufferedResponse(options) {
+		const response = await this.fetchOkResponse(options);
+		const body = response.body === null ? null : await response.arrayBuffer();
+		return new Response(body, {
+			headers: response.headers,
+			status: response.status,
+			statusText: response.statusText
+		});
 	}
 	async fetchCreatingPost(options) {
 		return this.fetchJson({
@@ -81,9 +88,7 @@ var HttpClient = class {
 		return parseResponseBody(await this.fetchResponse(options));
 	}
 	async fetchStatus(options) {
-		const response = await this.fetchResponse(options);
-		await assertResponseOk(response);
-		await response.body?.cancel();
+		await (await this.fetchOkResponse(options)).body?.cancel();
 	}
 	async fetchUpload(options) {
 		const fetchWithTimeout = withTimeout(fetch, { timeoutMs: UPLOAD_TIMEOUT_MS });
@@ -100,6 +105,11 @@ var HttpClient = class {
 			method: "PUT"
 		}));
 	}
+	async fetchOkResponse(options) {
+		const response = await this.fetchResponse(options);
+		await assertResponseOk(response);
+		return response;
+	}
 	async fetchResponse(options) {
 		const fetchWithTimeout = withTimeout(fetch, { timeoutMs: this.timeoutMs });
 		return (options.isRetryable ?? IDEMPOTENT_METHODS.has(options.method) ? withRetry(fetchWithTimeout) : fetchWithTimeout)(this.resolveUrl(options), this.resolveRequestInit(options));
@@ -123,7 +133,10 @@ var HttpClient = class {
 		};
 	}
 	resolveRouteUrl(path) {
-		return new URL(this.baseUrl + path);
+		if (!path.startsWith("/")) throw new Error(`The path ${path} does not start with a slash.`);
+		const url = new URL(this.baseUrl + path);
+		if (!url.href.startsWith(new URL(`${this.baseUrl}/`).href)) throw new Error(`The path ${path} leaves the base URL.`);
+		return url;
 	}
 	resolveUrl(options) {
 		const url = this.resolveRouteUrl(options.path);
@@ -238,9 +251,14 @@ var BinariesResource = class {
 		});
 	}
 	async get(options) {
+		const { appId, binaryId, ...query } = options;
 		return this.httpClient.fetchJson({
 			method: "GET",
-			path: resolvePath("/v1/apps/{appId}/binaries/{binaryId}", options)
+			path: resolvePath("/v1/apps/{appId}/binaries/{binaryId}", {
+				appId,
+				binaryId
+			}),
+			query
 		});
 	}
 	/**
@@ -613,6 +631,7 @@ var ChannelReleasesResource = class {
 	}
 	/**
 	* Releases a ready bundle, or what another channel serves, in this channel.
+	* With `fromChannelId`, `platform` picks the newest active release of that channel serving the platform.
 	* The release gets the next number of the channel.
 	*/
 	async create(options) {
@@ -651,8 +670,8 @@ var RollbacksResource = class {
 		this.httpClient = httpClient;
 	}
 	/**
-	* Rolls the channel back to its previous bundle, or to the bundle of `toReleaseId`.
-	* A rollback is a new release.
+	* Rolls the channel back to the release before its newest active one, or before the newest active one serving `platform`.
+	* `toReleaseId` names the target instead. A rollback is a new release.
 	*/
 	async create(options) {
 		const { appId, channelId, idempotencyKey, ...body } = options;
@@ -1156,7 +1175,7 @@ var StatisticsFleetResource = class {
 		this.httpClient = httpClient;
 	}
 	/**
-	* Gets a snapshot of the fleet from the registry, for one channel when `channelId` is set.
+	* Gets a snapshot of the fleet from the registry, for one channel when `channelId` is set and for one binary when `binaryId` is set.
 	*/
 	async get(options) {
 		const { appId, ...query } = options;
@@ -2394,16 +2413,29 @@ var HotCodePush = class {
 	organizations;
 	qrCodes;
 	users;
+	httpClient;
 	constructor(options = {}) {
-		const httpClient = new HttpClient(options);
-		this.apps = new AppsResource(httpClient);
-		this.health = new HealthResource(httpClient);
-		this.invitations = new InvitationsResource(httpClient);
-		this.notificationPreferences = new NotificationPreferencesResource(httpClient);
-		this.notifications = new NotificationsResource(httpClient);
-		this.organizations = new OrganizationsResource(httpClient);
-		this.qrCodes = new QrCodesResource(httpClient);
-		this.users = new UsersResource(httpClient);
+		this.httpClient = new HttpClient(options);
+		this.apps = new AppsResource(this.httpClient);
+		this.health = new HealthResource(this.httpClient);
+		this.invitations = new InvitationsResource(this.httpClient);
+		this.notificationPreferences = new NotificationPreferencesResource(this.httpClient);
+		this.notifications = new NotificationsResource(this.httpClient);
+		this.organizations = new OrganizationsResource(this.httpClient);
+		this.qrCodes = new QrCodesResource(this.httpClient);
+		this.users = new UsersResource(this.httpClient);
+	}
+	/**
+	* Sends one request to a path of the API, for what no resource method covers.
+	* Returns the response with its status, its headers and its body already received.
+	* Throws a `HotCodePushError` on a status outside 2xx.
+	*/
+	request({ body, method, path }) {
+		return this.httpClient.fetchBufferedResponse({
+			body,
+			method,
+			path
+		});
 	}
 };
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hotcodepush/node",
   "description": "The typed Node client for the HotCodePush REST API",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "private": false,
   "keywords": [
     "hotcodepush",