@jsm-mit/sultana-assets-rust-package 0.1.0 → 0.2.0

package/README.md

@@ -56,9 +56,9 @@ types are exported too, and `./declarations/*` gives the generated files.
 `src/` is browser-safe — the same package serves the biz panel, the playground and the
 transcoding worker.
 
-Scripts: `build`, `typecheck`, `sync-declarations`, `test-suite`, `redeploy`, `sandbox`
+Scripts: `build`, `typecheck`, `sync-declarations`, `test-suite`, `test-smoke`, `test-upgrade`, `redeploy`, `sandbox`
 (an interactive console: `npm run sandbox -- <canister-id>`, caller from `IDENTITY_PEM` in
-`.env` or anonymous), `stamp-canister`, `publish-public`. See `CLAUDE.md` for who runs what.
+`.env.sandbox` or anonymous), `stamp-canister`, `publish-public`. See `CLAUDE.md` for who runs what.
 
 ## Integration tests
 
@@ -67,6 +67,11 @@ table's `short-living` slot (lease 3 minutes) and runs `tests/test-suite.ts` the
 `.env`, no PEMs: every identity is generated per run. A fresh canister has no core canister,
 so the suite claims that claim-once seat for a generated identity and plays core itself.
 
+`npm run test-smoke` does the same with `tests/test-smoke.ts`: setup, then one write and one
+read per domain (worker list, a few-byte single-shot upload read back over HTTP, a worker
+result, a salon upload refused by the stand-in core), one replication wait, ≈ 30 s.
+`publish-public` runs it too.
+
 What the suite covers: the core seat and the worker list; chunked and single-shot uploads
 with every owner and size check; reads, HTTP 200/206/404, certification header and
 streaming; the worker's system upload with a poster; `delete_asset` taking the thumb along;
@@ -79,8 +84,9 @@ the suite never touches it.
 
 Bump the version by hand, commit, push, then `npm run publish-public`. It refuses unless this
 repo and `../sultana-assets-rust` are on a clean, pushed `master` and the version is new on
-npm; it reinstalls the canister's master into `short-living` (lease 1), checks that its
+npm; it reinstalls the canister's master into `short-living` (lease 2), checks that its
 `candid:service` equals `declarations/sultana-assets-rust/sultana-assets-rust.did` as dfx
-rewrites it (the hand-written .did is normalized by a local `dfx build --check` first), stamps
+rewrites it (the hand-written .did is normalized by a local `dfx build --check` first), runs
+the smoke test (`tests/test-smoke.ts`) on that same deploy, stamps
 `sultanaAssets.{repo, repoUrl, commit}` into package.json, publishes and commits `Version bump
 to <version>`.

package/declarations/sultana-assets-rust/sultana-assets-rust.did

@@ -80,6 +80,7 @@ service : () -> {
   finish_system_upload : (FinishSystemUploadArgs) -> (text);
   finish_upload : (text) -> (text);
   get_asset_info : (text) -> (opt AssetInfo) query;
+  get_coordinator : () -> (opt principal) query;
   get_core_canister : () -> (opt principal) query;
   get_workers : () -> (vec WorkerEntry) query;
   http_request : (HttpRequest) -> (HttpResponse) query;
@@ -88,6 +89,7 @@ service : () -> {
   reserve_render : (ReserveRenderArgs) -> (ReserveTranscodingUpload);
   reserve_transcoding_upload : (ReserveTranscodingUploadArgs) -> (ReserveTranscodingUpload);
   run_reservation_sweep : (nat64) -> (nat32);
+  set_coordinator : (opt principal) -> (bool);
   set_core_canister : (principal) -> (bool);
   set_workers : (vec WorkerEntry) -> (bool);
   start_upload : (StartUploadArgs) -> (text);

package/declarations/sultana-assets-rust/sultana-assets-rust.did.d.ts

@@ -100,6 +100,7 @@ export interface _SERVICE {
   'finish_system_upload' : ActorMethod<[FinishSystemUploadArgs], string>,
   'finish_upload' : ActorMethod<[string], string>,
   'get_asset_info' : ActorMethod<[string], [] | [AssetInfo]>,
+  'get_coordinator' : ActorMethod<[], [] | [Principal]>,
   'get_core_canister' : ActorMethod<[], [] | [Principal]>,
   'get_workers' : ActorMethod<[], Array<WorkerEntry>>,
   'http_request' : ActorMethod<[HttpRequest], HttpResponse>,
@@ -114,6 +115,7 @@ export interface _SERVICE {
     ReserveTranscodingUpload
   >,
   'run_reservation_sweep' : ActorMethod<[bigint], number>,
+  'set_coordinator' : ActorMethod<[[] | [Principal]], boolean>,
   'set_core_canister' : ActorMethod<[Principal], boolean>,
   'set_workers' : ActorMethod<[Array<WorkerEntry>], boolean>,
   'start_upload' : ActorMethod<[StartUploadArgs], string>,

package/declarations/sultana-assets-rust/sultana-assets-rust.did.js

@@ -111,6 +111,7 @@ export const idlFactory = ({ IDL }) => {
     'finish_system_upload' : IDL.Func([FinishSystemUploadArgs], [IDL.Text], []),
     'finish_upload' : IDL.Func([IDL.Text], [IDL.Text], []),
     'get_asset_info' : IDL.Func([IDL.Text], [IDL.Opt(AssetInfo)], ['query']),
+    'get_coordinator' : IDL.Func([], [IDL.Opt(IDL.Principal)], ['query']),
     'get_core_canister' : IDL.Func([], [IDL.Opt(IDL.Principal)], ['query']),
     'get_workers' : IDL.Func([], [IDL.Vec(WorkerEntry)], ['query']),
     'http_request' : IDL.Func([HttpRequest], [HttpResponse], ['query']),
@@ -131,6 +132,7 @@ export const idlFactory = ({ IDL }) => {
         [],
       ),
     'run_reservation_sweep' : IDL.Func([IDL.Nat64], [IDL.Nat32], []),
+    'set_coordinator' : IDL.Func([IDL.Opt(IDL.Principal)], [IDL.Bool], []),
     'set_core_canister' : IDL.Func([IDL.Principal], [IDL.Bool], []),
     'set_workers' : IDL.Func([IDL.Vec(WorkerEntry)], [IDL.Bool], []),
     'start_upload' : IDL.Func([StartUploadArgs], [IDL.Text], []),

package/dist/actors/admin-actor.d.ts

@@ -27,6 +27,27 @@ export declare class AssetsRustAdminActor extends ActorBase {
      * @throws CriticalCanisterError - Transport failure or an unreachable canister.
      */
     getCoreCanisterAsyncUnsafe(): Promise<string | null>;
+    /**
+     * Core-canister only: the coordinator of the sharded group (sultana-sharded) whose workers
+     * hold the salons — the trusted calls of a salon then go to its worker. The real path is
+     * the group core's `linkAssetsToGroup` (sultana-sharded-package
+     * `AdminActor.linkAssetsToGroupAsyncUnsafe`); `null` goes back to the one core.
+     * @param coordinatorPrincipal - The group's coordinator, or `null`.
+     * @returns A Promise that resolves to `true` when set, `false` when the caller is not the
+     *          core canister.
+     * @throws CanisterError - The canister trapped.
+     * @throws CallRefusedAtInspectionStage - The call was refused at the inspect stage.
+     * @throws CriticalCanisterError - Transport failure or an unreachable canister.
+     */
+    setCoordinatorAsyncUnsafe(coordinatorPrincipal: string | null): Promise<boolean>;
+    /**
+     * @returns A Promise that resolves to the coordinator of the sharded group, or `null` when
+     *          the canister serves one core.
+     * @throws CanisterError - The canister trapped.
+     * @throws CallRefusedAtInspectionStage - The call was refused at the inspect stage.
+     * @throws CriticalCanisterError - Transport failure or an unreachable canister.
+     */
+    getCoordinatorAsyncUnsafe(): Promise<string | null>;
     /**
      * Core-canister only: replaces the transcoding-worker list. The real path is core's
      * superadmin proxy (sultana-core-motoko-package `AdminActor.setAssetWorkersAsyncUnsafe`).

package/dist/actors/admin-actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-actor.d.ts","sourceRoot":"","sources":["../../src/actors/admin-actor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IAC/C;;;;;;;;;OASG;IACU,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhF;;;;;;OAMG;IACU,0BAA0B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKjE;;;;;;;;;OASG;IACU,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3E;;;;;;OAMG;IACU,qBAAqB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAK3D;;;;;;;;;;OAUG;IACU,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItE;;;;;;;;OAQG;IACU,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG9E"}
+{"version":3,"file":"admin-actor.d.ts","sourceRoot":"","sources":["../../src/actors/admin-actor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;IAC/C;;;;;;;;;OASG;IACU,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhF;;;;;;OAMG;IACU,0BAA0B,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKjE;;;;;;;;;;;OAWG;IACU,yBAAyB,CAAC,oBAAoB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7F;;;;;;OAMG;IACU,yBAAyB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKhE;;;;;;;;;OASG;IACU,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3E;;;;;;OAMG;IACU,qBAAqB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAK3D;;;;;;;;;;OAUG;IACU,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItE;;;;;;;;OAQG;IACU,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG9E"}

package/dist/actors/admin-actor.js

@@ -33,6 +33,32 @@ export class AssetsRustAdminActor extends ActorBase {
         const result = await this.executeFunctionAsyncUnsafe(() => this.actor.get_core_canister());
         return result.length === 0 ? null : result[0].toText();
     }
+    /**
+     * Core-canister only: the coordinator of the sharded group (sultana-sharded) whose workers
+     * hold the salons — the trusted calls of a salon then go to its worker. The real path is
+     * the group core's `linkAssetsToGroup` (sultana-sharded-package
+     * `AdminActor.linkAssetsToGroupAsyncUnsafe`); `null` goes back to the one core.
+     * @param coordinatorPrincipal - The group's coordinator, or `null`.
+     * @returns A Promise that resolves to `true` when set, `false` when the caller is not the
+     *          core canister.
+     * @throws CanisterError - The canister trapped.
+     * @throws CallRefusedAtInspectionStage - The call was refused at the inspect stage.
+     * @throws CriticalCanisterError - Transport failure or an unreachable canister.
+     */
+    async setCoordinatorAsyncUnsafe(coordinatorPrincipal) {
+        return this.executeFunctionAsyncUnsafe(() => this.actor.set_coordinator(coordinatorPrincipal === null ? [] : [Principal.fromText(coordinatorPrincipal)]));
+    }
+    /**
+     * @returns A Promise that resolves to the coordinator of the sharded group, or `null` when
+     *          the canister serves one core.
+     * @throws CanisterError - The canister trapped.
+     * @throws CallRefusedAtInspectionStage - The call was refused at the inspect stage.
+     * @throws CriticalCanisterError - Transport failure or an unreachable canister.
+     */
+    async getCoordinatorAsyncUnsafe() {
+        const result = await this.executeFunctionAsyncUnsafe(() => this.actor.get_coordinator());
+        return result.length === 0 ? null : result[0].toText();
+    }
     /**
      * Core-canister only: replaces the transcoding-worker list. The real path is core's
      * superadmin proxy (sultana-core-motoko-package `AdminActor.setAssetWorkersAsyncUnsafe`).

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/sultana-assets-rust-package",
-    "version": "0.1.0",
+    "version": "0.2.0",
     "description": "Wrapper TypeScript package for the sultana-assets-rust canister: chunked and single-shot uploads, salon images and transcoding reservations, the worker upload path, reads and asset URLs.",
     "license": "ISC",
     "author": "",
@@ -26,6 +26,8 @@
         "typecheck": "tsc --noEmit -p tsconfig.tests.json",
         "sync-declarations": "bash scripts/sync-declarations.sh",
         "test-suite": "bash scripts/run-tests.sh tests/test-suite.ts --lease 3",
+        "test-smoke": "bash scripts/run-tests.sh tests/test-smoke.ts --lease 3",
+        "test-upgrade": "bash scripts/run-tests.sh tests/test-upgrade.ts --lease 6",
         "redeploy": "bash scripts/redeploy.sh",
         "sandbox": "npx tsx sandbox/main.ts",
         "stamp-canister": "bash scripts/stamp-canister-commit.sh"
@@ -53,6 +55,6 @@
     "sultanaAssets": {
         "repo": "sultana-assets-rust",
         "repoUrl": "https://github.com/JSM-Sultana/sultana-assets-rust",
-        "commit": "a2fcfea02282aa858d683bddb26297f2091c431c"
+        "commit": "2360e780f543b7bb4eb2d67cc9e6f63d784bd404"
     }
 }