@jsm-mit/sultana-core-motoko-package 0.0.21 → 0.0.22

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { AdminActor } from "./actors/admin-actor.js";
-export { VideoUploadClient, uploadVideoToWorkersAsyncUnsafe, getSalonAssetsWithStatusAsyncUnsafe, parseAssetError, AssetValidationError } from "./video-upload-client.js";
+export { VideoUploadClient, uploadVideoToWorkersAsyncUnsafe, getSalonAssetsWithStatusAsyncUnsafe, getSalonAssetsWithCoreStatusAsyncUnsafe, refineAssetStatusAsyncUnsafe, parseAssetError, AssetValidationError } from "./video-upload-client.js";
 export type { SalonAssetWithStatus, AssetError, AssetErrorCode, AssetFlowStatus } from "./video-upload-client.js";
 export type { VideoUploadStage, VideoUploadProgress, VideoUploadOptions, VideoUploadAcceptance, VideoUploadResult, VideoTranscodeCheck, } from "./video-upload-client.js";
 export type { ActionQuotaRole, CallActivityStats } from "./actors/admin-actor.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,mCAAmC,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC1K,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAClH,YAAY,EACR,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gEAAgE,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC1G,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAClH,YAAY,EACR,KAAK,EACL,SAAS,EACT,YAAY,EACZ,OAAO,EACP,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,GAClB,MAAM,gEAAgE,CAAC;AACxE,YAAY,EACR,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACzB,MAAM,gEAAgE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,+BAA+B,EAAE,mCAAmC,EAAE,uCAAuC,EAAE,4BAA4B,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACjP,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAClH,YAAY,EACR,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gEAAgE,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACvG,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC1G,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAClH,YAAY,EACR,KAAK,EACL,SAAS,EACT,YAAY,EACZ,OAAO,EACP,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,GAClB,MAAM,gEAAgE,CAAC;AACxE,YAAY,EACR,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACzB,MAAM,gEAAgE,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 export { AdminActor } from "./actors/admin-actor.js";
-export { VideoUploadClient, uploadVideoToWorkersAsyncUnsafe, getSalonAssetsWithStatusAsyncUnsafe, parseAssetError, AssetValidationError } from "./video-upload-client.js";
+export { VideoUploadClient, uploadVideoToWorkersAsyncUnsafe, getSalonAssetsWithStatusAsyncUnsafe, getSalonAssetsWithCoreStatusAsyncUnsafe, refineAssetStatusAsyncUnsafe, parseAssetError, AssetValidationError } from "./video-upload-client.js";
 export { BulkActor } from "./actors/bulk-actor.js";
 export { AppointmentsActor } from "./actors/appointments-actor.js";
 export { AssetsActor } from "./actors/assets-actor.js";

package/dist/video-upload-client.d.ts

@@ -155,6 +155,13 @@ export type SalonAssetWithStatus = SalonAsset & {
  * is presented as "failed" with TRANSCODING_INTERRUPTED. That verdict is presentational
  * only: core still holds #Pending and the stale-reservation sweep remains the durable
  * closure (~24h); the point is not to show false hope in the meantime.
+ *
+ * PERFORMANCE: this fans out per Pending entry — one get_asset_info canister query plus up
+ * to one HTTP status probe PER CONFIGURED WORKER for each Pending asset (in parallel, but
+ * the fetch waits for the slowest one; an unreachable worker costs a full fetch timeout).
+ * Libraries rarely hold many Pending entries at once, so users usually won't notice — but
+ * for latency-sensitive views prefer {@link getSalonAssetsWithCoreStatusAsyncUnsafe} for the
+ * list and {@link refineAssetStatusAsyncUnsafe} on demand for the entry being inspected.
  * @param assetsActor - AssetsActor bound to the core canister (any identity allowed to read the library).
  * @param videoClient - VideoUploadClient bound to the asset canister (source of worker URLs and statuses).
  * @param salonId - The salon whose library to fetch.
@@ -169,6 +176,40 @@ export type SalonAssetWithStatus = SalonAsset & {
 export declare function getSalonAssetsWithStatusAsyncUnsafe(assetsActor: AssetsActor, videoClient: VideoUploadClient, salonId: string, options?: {
     unknownGraceMs?: number;
 }): Promise<SalonAssetWithStatus[]>;
+/**
+ * Performance-first variant of {@link getSalonAssetsWithStatusAsyncUnsafe}: exactly ONE
+ * canister query, no transcoding-worker probes. `flowStatus` is derived from core's status
+ * alone, so #Pending entries stay "pending" — a Pending entry may actually be uploading,
+ * processing or interrupted; call {@link refineAssetStatusAsyncUnsafe} for the entry the
+ * user drills into (or wherever the live verdict matters) to find out.
+ * @param assetsActor - AssetsActor bound to the core canister (any identity allowed to read the library).
+ * @param salonId - The salon whose library to fetch.
+ * @returns A Promise that resolves to the library entries with the core-derived `flowStatus`
+ *          (+ `errorMessage` on #Failed ones).
+ * @throws Error with message 'CanisterError' / 'CriticalCanisterError' from the underlying
+ *         getSalonAssetsAsyncUnsafe (not the salon's owner, salon not found, canister crash).
+ */
+export declare function getSalonAssetsWithCoreStatusAsyncUnsafe(assetsActor: AssetsActor, salonId: string): Promise<SalonAssetWithStatus[]>;
+/**
+ * Live-status refinement for ONE library entry — the companion of
+ * {@link getSalonAssetsWithCoreStatusAsyncUnsafe}: fetch the list cheaply, then refine the
+ * entry the user actually looks at. Non-Pending entries are returned as-is (their core
+ * status is final); a #Pending entry gets the full {@link VideoUploadClient.checkVideoStatusAsyncUnsafe}
+ * verdict, including the presentational TRANSCODING_INTERRUPTED once it is older than
+ * `unknownGraceMs` with no worker signal (core stays untouched — see
+ * getSalonAssetsWithStatusAsyncUnsafe for the semantics).
+ * @param videoClient - VideoUploadClient bound to the asset canister (source of worker URLs and statuses).
+ * @param asset - The library entry to refine (from any of the library fetches).
+ * @param options - Optional. `workerUrls` — probe these workers instead of fetching the
+ *        canister's configured list; `unknownGraceMs` — see getSalonAssetsWithStatusAsyncUnsafe.
+ * @returns A Promise that resolves to the entry with its live `flowStatus` (+ `errorMessage` when failed).
+ * @throws Error (raw agent reject) when the asset canister calls (get_asset_info, get_workers)
+ *         fail. Worker status fetches never throw — an unreachable worker just yields "unknown".
+ */
+export declare function refineAssetStatusAsyncUnsafe(videoClient: VideoUploadClient, asset: SalonAsset, options?: {
+    workerUrls?: string[];
+    unknownGraceMs?: number;
+}): Promise<SalonAssetWithStatus>;
 /**
  * Uploads the source to the first worker in `uploadUrls` that accepts it, restarting from
  * chunk 0 on each failover. Exported separately from the client so the failover behavior is

package/dist/video-upload-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"video-upload-client.d.ts","sourceRoot":"","sources":["../src/video-upload-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gEAAgE,CAAC;AACjG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,gBAAgB,CAAC;IACxB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAC/B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8FAA8F;IAC9F,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;uEACmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACrD,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,wFAAwF;AACxF,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAC9B,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B;AAYD;;2BAE2B;AAC3B,qBAAa,oBAAqB,SAAQ,KAAK;aACE,OAAO,EAAE,UAAU;gBAApD,OAAO,EAAE,MAAM,EAAkB,OAAO,EAAE,UAAU;CAInE;AAiGD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACpB,cAAc,GACd,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,uBAAuB,GACvB,yBAAyB,GACzB,eAAe,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAcxD;AAED,mGAAmG;AACnG,MAAM,MAAM,mBAAmB,GACzB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE1F,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG;IAC5C,UAAU,EAAE,eAAe,CAAC;IAC5B,8FAA8F;IAC9F,YAAY,CAAC,EAAE,UAAU,CAAC;CAC7B,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mCAAmC,CACrD,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAsCjC;AAoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,+BAA+B,CACjD,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAehC;AAoFD;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,UAAU,CAAS;gBAEf,oBAAoB,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAM7D;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAY9I;;;;;;;;;;OAUG;IACU,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAcrI;;;;OAIG;IACU,wBAAwB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI1D;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8B9G;;;;;;;;;;;;;;;;OAgBG;IACU,uBAAuB,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAClH,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAuCpC"}
+{"version":3,"file":"video-upload-client.d.ts","sourceRoot":"","sources":["../src/video-upload-client.ts"],"names":[],"mappings":"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"}

package/dist/video-upload-client.js

@@ -127,6 +127,13 @@ const DEFAULT_UNKNOWN_GRACE_MS = 2 * 60 * 1000;
  * is presented as "failed" with TRANSCODING_INTERRUPTED. That verdict is presentational
  * only: core still holds #Pending and the stale-reservation sweep remains the durable
  * closure (~24h); the point is not to show false hope in the meantime.
+ *
+ * PERFORMANCE: this fans out per Pending entry — one get_asset_info canister query plus up
+ * to one HTTP status probe PER CONFIGURED WORKER for each Pending asset (in parallel, but
+ * the fetch waits for the slowest one; an unreachable worker costs a full fetch timeout).
+ * Libraries rarely hold many Pending entries at once, so users usually won't notice — but
+ * for latency-sensitive views prefer {@link getSalonAssetsWithCoreStatusAsyncUnsafe} for the
+ * list and {@link refineAssetStatusAsyncUnsafe} on demand for the entry being inspected.
  * @param assetsActor - AssetsActor bound to the core canister (any identity allowed to read the library).
  * @param videoClient - VideoUploadClient bound to the asset canister (source of worker URLs and statuses).
  * @param salonId - The salon whose library to fetch.
@@ -149,32 +156,77 @@ export async function getSalonAssetsWithStatusAsyncUnsafe(assetsActor, videoClie
             checks.set(asset.assetId, await videoClient.checkVideoStatusAsyncUnsafe(asset.assetId, workerUrls));
         }));
     }
-    return library.map((asset) => {
-        if ("Ready" in asset.status)
-            return { ...asset, flowStatus: "ready" };
-        if ("Failed" in asset.status) {
-            return { ...asset, flowStatus: "failed", errorMessage: parseAssetError(asset.status.Failed) };
-        }
-        // #Pending — refine with the live worker verdict.
-        const check = checks.get(asset.assetId);
-        if (check?.state === "uploading") {
-            return { ...asset, flowStatus: "uploading" };
-        }
-        if (check?.state === "processing" || check?.state === "stored") {
-            return { ...asset, flowStatus: "processing" };
-        }
-        if (check?.state === "failed") {
-            // The worker already reported the failure — show it now; core flips moments later.
-            return { ...asset, flowStatus: "failed", errorMessage: check.errorMessage };
-        }
-        // No worker signal at all. Past the grace window that means the upload was interrupted
-        // — presentational verdict only, core stays #Pending until the sweep closes it durably.
-        const ageMs = Date.now() - Number(asset.createdAt / 1000000n);
-        if (ageMs > unknownGraceMs) {
-            return { ...asset, flowStatus: "failed", errorMessage: { error: "TRANSCODING_INTERRUPTED" } };
-        }
-        return { ...asset, flowStatus: "pending" };
-    });
+    return library.map(asset => "Pending" in asset.status
+        ? refinePendingWithCheck(asset, checks.get(asset.assetId), unknownGraceMs)
+        : coreFlowStatus(asset));
+}
+/**
+ * Performance-first variant of {@link getSalonAssetsWithStatusAsyncUnsafe}: exactly ONE
+ * canister query, no transcoding-worker probes. `flowStatus` is derived from core's status
+ * alone, so #Pending entries stay "pending" — a Pending entry may actually be uploading,
+ * processing or interrupted; call {@link refineAssetStatusAsyncUnsafe} for the entry the
+ * user drills into (or wherever the live verdict matters) to find out.
+ * @param assetsActor - AssetsActor bound to the core canister (any identity allowed to read the library).
+ * @param salonId - The salon whose library to fetch.
+ * @returns A Promise that resolves to the library entries with the core-derived `flowStatus`
+ *          (+ `errorMessage` on #Failed ones).
+ * @throws Error with message 'CanisterError' / 'CriticalCanisterError' from the underlying
+ *         getSalonAssetsAsyncUnsafe (not the salon's owner, salon not found, canister crash).
+ */
+export async function getSalonAssetsWithCoreStatusAsyncUnsafe(assetsActor, salonId) {
+    const library = await assetsActor.getSalonAssetsAsyncUnsafe(salonId);
+    return library.map(coreFlowStatus);
+}
+/**
+ * Live-status refinement for ONE library entry — the companion of
+ * {@link getSalonAssetsWithCoreStatusAsyncUnsafe}: fetch the list cheaply, then refine the
+ * entry the user actually looks at. Non-Pending entries are returned as-is (their core
+ * status is final); a #Pending entry gets the full {@link VideoUploadClient.checkVideoStatusAsyncUnsafe}
+ * verdict, including the presentational TRANSCODING_INTERRUPTED once it is older than
+ * `unknownGraceMs` with no worker signal (core stays untouched — see
+ * getSalonAssetsWithStatusAsyncUnsafe for the semantics).
+ * @param videoClient - VideoUploadClient bound to the asset canister (source of worker URLs and statuses).
+ * @param asset - The library entry to refine (from any of the library fetches).
+ * @param options - Optional. `workerUrls` — probe these workers instead of fetching the
+ *        canister's configured list; `unknownGraceMs` — see getSalonAssetsWithStatusAsyncUnsafe.
+ * @returns A Promise that resolves to the entry with its live `flowStatus` (+ `errorMessage` when failed).
+ * @throws Error (raw agent reject) when the asset canister calls (get_asset_info, get_workers)
+ *         fail. Worker status fetches never throw — an unreachable worker just yields "unknown".
+ */
+export async function refineAssetStatusAsyncUnsafe(videoClient, asset, options) {
+    if (!("Pending" in asset.status))
+        return coreFlowStatus(asset);
+    const check = await videoClient.checkVideoStatusAsyncUnsafe(asset.assetId, options?.workerUrls);
+    return refinePendingWithCheck(asset, check, options?.unknownGraceMs ?? DEFAULT_UNKNOWN_GRACE_MS);
+}
+/** flowStatus from core's status alone — #Pending stays "pending" (no worker verdict involved). */
+function coreFlowStatus(asset) {
+    if ("Ready" in asset.status)
+        return { ...asset, flowStatus: "ready" };
+    if ("Failed" in asset.status) {
+        return { ...asset, flowStatus: "failed", errorMessage: parseAssetError(asset.status.Failed) };
+    }
+    return { ...asset, flowStatus: "pending" };
+}
+/** Refines a #Pending entry with a live worker verdict (undefined check = no signal). */
+function refinePendingWithCheck(asset, check, unknownGraceMs) {
+    if (check?.state === "uploading") {
+        return { ...asset, flowStatus: "uploading" };
+    }
+    if (check?.state === "processing" || check?.state === "stored") {
+        return { ...asset, flowStatus: "processing" };
+    }
+    if (check?.state === "failed") {
+        // The worker already reported the failure — show it now; core flips moments later.
+        return { ...asset, flowStatus: "failed", errorMessage: check.errorMessage };
+    }
+    // No worker signal at all. Past the grace window that means the upload was interrupted
+    // — presentational verdict only, core stays #Pending until the sweep closes it durably.
+    const ageMs = Date.now() - Number(asset.createdAt / 1000000n);
+    if (ageMs > unknownGraceMs) {
+        return { ...asset, flowStatus: "failed", errorMessage: { error: "TRANSCODING_INTERRUPTED" } };
+    }
+    return { ...asset, flowStatus: "pending" };
 }
 class WorkerHttpError extends Error {
     status;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/sultana-core-motoko-package",
-    "version": "0.0.21",
+    "version": "0.0.22",
     "description": "A TypeScript library for interacting with the Sultana Core Motoko actor on the Internet Computer (IC) platform.",
     "homepage": "https://github.com/JSM-Sultana/sultana-core-motoko-package#readme",
     "bugs": {