@glassly/cloud-client 0.3.7 → 0.3.8-beta.1013

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glassly/cloud-client",
-  "version": "0.3.7",
+  "version": "0.3.8-beta.1013",
   "type": "module",
   "main": "./src/index.ts",
   "exports": {
@@ -12,7 +12,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@glassly/cloud-protocol": "0.3.7",
+    "@glassly/cloud-protocol": "0.3.8-beta.1013",
     "tweetnacl": "^1.0.3"
   },
   "devDependencies": {

package/src/index.ts

@@ -51,6 +51,8 @@ export type {
   StoreListingHardwareRequirement,
   StoreListingPermission,
   StoreListingScreenshot,
+  StoreRelease,
+  StoreReleasesResponse,
 } from "./modules/core/core";
 
 export type {

package/src/modules/core/core.ts

@@ -105,6 +105,25 @@ export interface StoreCatalogResponse {
   listings: StoreListing[];
 }
 
+/** One published release of a listing (`GET /api/client/store/:packageName/releases`). */
+export interface StoreRelease {
+  version: string;
+  /** The listing's active release. */
+  current: boolean;
+  /** Lowest Glassly App version the release runs on; null when its manifest sets none. */
+  minHostVersion: string | null;
+  sdkVersion: string | null;
+  releaseNotes: string | null;
+  bundle: { url: string; sha256: string; sizeBytes: number };
+  publishedAt: string;
+}
+
+export interface StoreReleasesResponse {
+  packageName: string;
+  /** Newest version first. */
+  releases: StoreRelease[];
+}
+
 /**
  * `install_once`: installed by default, once. `mandatory`: reinstalled
  * whenever it is missing. Neither updates a miniapp the phone has; the Store
@@ -144,6 +163,8 @@ export interface CoreDeps {
   http: HttpClient;
 }
 
+const NO_CACHE = { "Cache-Control": "no-cache" };
+
 /**
  * `cloud.core`. Stateless REST grouped by resource.
  *
@@ -158,6 +179,7 @@ export class Core {
   readonly store: {
     list(): Promise<StoreCatalogResponse>;
     get(packageName: string): Promise<StoreListing>;
+    releases(packageName: string): Promise<StoreReleasesResponse>;
     fetchAsset(url: string): Promise<Uint8Array>;
   };
   readonly reports: {
@@ -197,12 +219,23 @@ export class Core {
       },
     };
     this.store = {
-      /** The whole catalog. Small enough that search and tag filters stay on the device. */
+      /**
+       * The whole catalog. Small enough that search and tag filters stay on the device.
+       * Always revalidated: older Cores mark it cacheable for five minutes, and the
+       * platform HTTP cache (NSURLCache on iOS) would otherwise answer a refresh.
+       */
       list(): Promise<StoreCatalogResponse> {
-        return http.get<StoreCatalogResponse>("/api/client/store");
+        return http.get<StoreCatalogResponse>("/api/client/store", { headers: NO_CACHE });
       },
       get(packageName: string): Promise<StoreListing> {
-        return http.get<StoreListing>(`/api/client/store/${encodeURIComponent(packageName)}`);
+        return http.get<StoreListing>(`/api/client/store/${encodeURIComponent(packageName)}`, { headers: NO_CACHE });
+      },
+      /** Every published release of a listing, newest first, each with its own bundle. */
+      releases(packageName: string): Promise<StoreReleasesResponse> {
+        return http.get<StoreReleasesResponse>(
+          `/api/client/store/${encodeURIComponent(packageName)}/releases`,
+          { headers: NO_CACHE },
+        );
       },
       /**
        * Icons and screenshots need the user Bearer, which an <Image> cannot