@jsm-mit/tigi-sharded-package 0.1.0 → 0.3.0

package/dist/actors/driver-canisters-actor.js

@@ -0,0 +1,147 @@
+// The driver canister of the signed-in person in the core's factory (fabryka.md F-5 … F-8,
+// F-20; U-45): the demo lease, its extension, "mine", and the one-time claim code that hands
+// a demo canister over to the driver's principal on the canister's own front.
+//
+// Internet Identity gives one person a different principal on every origin: the lease is
+// taken on the rider's site, the driver signs in on `https://<canister>.icp0.io`. The
+// rider's site shows the link `claimLinkOf(canisterId, code)`; the driver's front reads the
+// code with `claimCodeOfHash(location.hash)` and calls `claimAsyncUnsafe` as the driver.
+//
+// The driver canister's id is the driver's own address (the link of his front), so these
+// views carry it — unlike the rider's views of other drivers (U-14).
+import { Principal } from "@icp-sdk/core/principal";
+import { errorKeyOf, executeAsyncUnsafe } from "../group/canister-actor.js";
+import { TigiGroup } from "../group/group.js";
+import { msOf } from "../mappers.js";
+/** The fragment key of a claim link: `https://<canister>.icp0.io/#claim=<code>`. */
+export const CLAIM_FRAGMENT_KEY = "claim";
+/** F-20a: a code is 32 characters of base64url; the core refuses more than this. */
+export const MAX_CLAIM_CODE_CHARS = 64;
+/**
+ * F-20: the link the rider's site shows after a lease ("Otwórz swój kanister"). The code
+ * rides in the fragment, which the browser never sends to a server.
+ * @param frontOrigin the origin of the driver canister's front; default `https://<canister>.icp0.io`
+ */
+export function claimLinkOf(canisterId, code, frontOrigin = `https://${canisterId}.icp0.io`) {
+    return `${frontOrigin}/#${CLAIM_FRAGMENT_KEY}=${encodeURIComponent(code)}`;
+}
+/**
+ * F-20: the claim code in a location hash (`#claim=<code>`, also among other `&` parts), or
+ * undefined. The driver's front clears the fragment after the claim.
+ */
+export function claimCodeOfHash(hash) {
+    const text = hash.startsWith("#") ? hash.slice(1) : hash;
+    for (const part of text.split("&")) {
+        const [key, ...rest] = part.split("=");
+        if (key !== CLAIM_FRAGMENT_KEY)
+            continue;
+        let code;
+        try {
+            code = decodeURIComponent(rest.join("="));
+        }
+        catch {
+            return undefined;
+        }
+        return code.length > 0 && code.length <= MAX_CLAIM_CODE_CHARS && /^[A-Za-z0-9_-]+$/.test(code) ? code : undefined;
+    }
+    return undefined;
+}
+/** @internal */
+export function driverCanisterOf(record) {
+    const until = record.leaseUntilNs[0];
+    return {
+        canisterId: record.canister.toText(),
+        kind: "pool" in record.kind ? "pool" : "own",
+        ownerPrincipal: record.owner.toText(),
+        leaseUntilMs: until === undefined ? undefined : msOf(BigInt(until)),
+        blocked: record.blocked,
+    };
+}
+/** @internal */
+export function claimCodeOf(claim) {
+    return { canisterId: claim.canister.toText(), code: claim.code, expiresAtMs: msOf(BigInt(claim.expiresAtNs)) };
+}
+export class DriverCanistersActor {
+    group;
+    constructor(coordinatorId, identity, options = {}) {
+        this.group = TigiGroup.of(coordinatorId, identity, options);
+    }
+    /**
+     * F-5 … F-7, F-20a: a demo canister for 15 minutes, reinstalled with the caller as its
+     * owner — or the caller's lease already (no reinstall, no code: `newClaimCodeAsyncUnsafe`).
+     * @returns `leased` with `claim` after a fresh lease (undefined when the core could make
+     *          no code — ask `newClaimCodeAsyncUnsafe`); `busy` with the time the pool frees up
+     * @throws Error with message `CanisterError` — `NotAuthorized` (prod), `NotFound` (no pool),
+     *         `InvalidData` (no driver wasm), `RemoteCanisterError` (the install failed)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async leaseDemoAsyncUnsafe() {
+        const answer = await executeAsyncUnsafe(async () => (await this.group.coreAsync()).leaseDemoDriverCanister());
+        if ("busy" in answer)
+            return { kind: "busy", untilMs: msOf(BigInt(answer.busy.untilNs)) };
+        const leased = answer.leased;
+        const claim = leased.claim[0];
+        return { kind: "leased", canister: driverCanisterOf(leased), claim: claim === undefined ? undefined : claimCodeOf(claim) };
+    }
+    /**
+     * F-8: 15 minutes more for the holder of the demo canister (at most 30 ahead), also after
+     * the end while nobody took it over. The owner stays (F-20f).
+     * @throws Error with message `CanisterError` — `NotFound` (no lease of the caller), `InvalidData` (being installed)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async extendDemoAsyncUnsafe() {
+        return driverCanisterOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).extendDemoLease()));
+    }
+    /**
+     * The caller's own driver canister, or the demo canister the caller holds now (as the
+     * lease holder — after a claim the canister's owner is the driver, `ownerPrincipal`).
+     * @returns undefined when the caller has none
+     * @throws Error with message `CanisterError` — `NotAuthorized` (anonymous)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async getMineAsyncUnsafe() {
+        try {
+            return driverCanisterOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).getMyDriverCanister()));
+        }
+        catch (err) {
+            if (errorKeyOf(err) === "NotFound")
+                return undefined;
+            throw err;
+        }
+    }
+    /**
+     * F-20c: a new claim code for the caller's running demo lease ("Nowy link"); the code
+     * before it stops working. Good for 15 minutes, once.
+     * @throws Error with message `CanisterError` — `NotFound` (no running lease of the caller),
+     *         `InvalidData` (being installed), `RemoteCanisterError` (no randomness — try again)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async newClaimCodeAsyncUnsafe() {
+        return claimCodeOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).newClaimCode()));
+    }
+    /**
+     * F-20d, F-20e: the caller — the driver signed in on the canister's own front — takes
+     * over the demo canister with the code of the link. The canister's owner becomes the
+     * caller, and so does the recipient of its chat room; the lease stays with its holder.
+     * @returns the canister with the caller as `ownerPrincipal`
+     * @throws Error with message `CanisterError` — `NotAuthorized` (the code is wrong, expired,
+     *         used, or not for this canister — one answer for all), `InvalidData` (the canister
+     *         is busy — try again), `RemoteCanisterError` (the driver canister did not take it;
+     *         the code stays good)
+     * @throws Error with message `CallRefusedAtInspectionStage` — anonymous, or the daily limit (30)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async claimAsyncUnsafe(canisterId, code) {
+        let canister;
+        try {
+            canister = Principal.fromText(canisterId);
+        }
+        catch {
+            throw new Error("CanisterError", { cause: { errorKey: "InvalidData", errorMessage: "not a canister id", logs: [] } });
+        }
+        return driverCanisterOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).claimDriverCanister({ canister, code })));
+    }
+}

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

@@ -1,6 +1,6 @@
 import type { Identity } from "@icp-sdk/core/agent";
 import { type GroupOptions } from "../group/canister-actor.js";
-import type { Profile, RideHistoryPage } from "../interfaces.js";
+import type { MyRatingView, Profile, RideHistoryPage } from "../interfaces.js";
 /** KU-1: a page of the rider's history. */
 export declare const RIDES_PAGE = 20;
 export declare class ProfilesActor {
@@ -21,6 +21,14 @@ export declare class ProfilesActor {
      * @throws Error with message `CriticalCanisterError` — the core could not be reached
      */
     setMyProfileAsyncUnsafe(name: string): Promise<Profile>;
+    /**
+     * C-16, PF-4: the signed-in user's rating as a rider ("★ 4,87"). Ratings reach the core
+     * in the workers' batches, up to a minute after the driver rated (K-9).
+     * @returns undefined while nobody rated the user ("Brak ocen")
+     * @throws Error with message `CanisterError` — `NotAuthorized` (anonymous)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    getMyRatingAsyncUnsafe(): Promise<MyRatingView | undefined>;
     /**
      * C-8, KU-1: the rider's rides, newest first, `RIDES_PAGE` a page. A ride reaches the core
      * up to a minute after its end (K-9, KU-2).

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

@@ -1 +1 @@
-{"version":3,"file":"profiles-actor.d.ts","sourceRoot":"","sources":["../../src/actors/profiles-actor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/F,OAAO,KAAK,EAAE,OAAO,EAA6B,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG5F,2CAA2C;AAC3C,eAAO,MAAM,UAAU,KAAK,CAAC;AAkB7B,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB;IAIjF;;;;;;OAMG;IACU,uBAAuB,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IASpE;;;;;OAKG;IACU,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE;;;;;;OAMG;IACU,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;CAS5G"}
+{"version":3,"file":"profiles-actor.d.ts","sourceRoot":"","sources":["../../src/actors/profiles-actor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/F,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAA6B,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAG1G,2CAA2C;AAC3C,eAAO,MAAM,UAAU,KAAK,CAAC;AAkB7B,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB;IAIjF;;;;;;OAMG;IACU,uBAAuB,IAAI,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IASpE;;;;;OAKG;IACU,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpE;;;;;;OAMG;IACU,sBAAsB,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAUxE;;;;;;OAMG;IACU,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;CAS5G"}

package/dist/actors/profiles-actor.js

@@ -49,6 +49,22 @@ export class ProfilesActor {
     async setMyProfileAsyncUnsafe(name) {
         return profileOf(await executeAsyncUnsafe(async () => (await this.group.coreAsync()).setMyProfile({ name })));
     }
+    /**
+     * C-16, PF-4: the signed-in user's rating as a rider ("★ 4,87"). Ratings reach the core
+     * in the workers' batches, up to a minute after the driver rated (K-9).
+     * @returns undefined while nobody rated the user ("Brak ocen")
+     * @throws Error with message `CanisterError` — `NotAuthorized` (anonymous)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async getMyRatingAsyncUnsafe() {
+        const answer = await executeAsyncUnsafe(async () => (await this.group.coreAsync()).getMyRating());
+        const rating = answer[0];
+        if (rating === undefined || rating.count === 0n)
+            return undefined;
+        const sum = Number(rating.sum);
+        const count = Number(rating.count);
+        return { average: Math.round((sum / count) * 100) / 100, count, sum };
+    }
     /**
      * C-8, KU-1: the rider's rides, newest first, `RIDES_PAGE` a page. A ride reaches the core
      * up to a minute after its end (K-9, KU-2).

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

@@ -2,7 +2,7 @@ import type { Identity } from "@icp-sdk/core/agent";
 import { type GroupOptions } from "../group/canister-actor.js";
 import { TigiGroup } from "../group/group.js";
 import { type Geo } from "../geo.js";
-import type { ChooseOutcome, LicenceView, RequestSnapshot, RideView } from "../interfaces.js";
+import type { ChatPlace, ChooseOutcome, LicenceView, RequestSnapshot, RideView } from "../interfaces.js";
 /** U-29: the rider's radius, and the radius after `WIDEN_AFTER_MS` without offers. */
 export declare const SEARCH_RADIUS_METERS = 3000;
 export declare const WIDE_RADIUS_METERS = 6000;
@@ -192,6 +192,17 @@ export declare class RideRequest {
      * @throws Error with message `CriticalCanisterError` — the driver canister does not answer
      */
     getLicenceAsyncUnsafe(): Promise<LicenceView>;
+    /**
+     * U-43, K-12, PR-25: where the chat with the driver of the accepted ride is — give it to
+     * `@jsm-mit/chat-sharded-package` (`ChatsActor.openChatAsyncUnsafe({ projectId, roomId })`
+     * on `chatCoordinatorId`). The room is the driver's (one per driver, not per ride): the
+     * rider has one chat with that driver over all their rides. Show "Napisz do kierowcy"
+     * from `accepted` to the end of the ride only.
+     * @returns undefined when the environment has no chat, or the driver is simulated (no chat in MVP)
+     * @throws Error with message `CanisterError` — `NOT_ACCEPTED` (no driver accepted yet)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    getChatPlaceAsyncUnsafe(): Promise<ChatPlace | undefined>;
     /**
      * K-8: the rider rates the driver 1–5 after `completed`, once, within 24 h.
      * @returns false when the rider rated this ride already

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

@@ -1 +1 @@
-{"version":3,"file":"rides-actor.d.ts","sourceRoot":"","sources":["../../src/actors/rides-actor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rides-actor.d.ts","sourceRoot":"","sources":["../../src/actors/rides-actor.ts"],"names":[],"mappings":"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"}

package/dist/actors/rides-actor.js

@@ -10,6 +10,7 @@ import { canisterError, errorKeyOf, executeAsyncUnsafe, executeProtocolAsyncUnsa
 import { TigiGroup } from "../group/group.js";
 import { geohashesByWorker } from "../group/prefixes.js";
 import { cellsWithin, isValidGeo } from "../geo.js";
+import { driverChatPlaceAsyncUnsafe } from "../chat.js";
 import { cardOf, closeReasonOf, decodeToken, driverOfOfferId, encodeToken, mergedPhase, mergeOffers, moneyOf, msOf, offerIdOf, offerOf, phaseOf, placeOffers, rideStatusOf } from "../mappers.js";
 /** U-29: the rider's radius, and the radius after `WIDEN_AFTER_MS` without offers. */
 export const SEARCH_RADIUS_METERS = 3_000;
@@ -391,6 +392,22 @@ export class RideRequest {
         const licence = await executeProtocolAsyncUnsafe(async () => (await this.driverAsync(accepted.canister)).getLicence({ requestId: this.state.requestId, driverKey: accepted.driverKey }));
         return { image: Uint8Array.from(licence.image), mimeType: licence.mimeType, documentNumber: licence.documentNumber };
     }
+    /**
+     * U-43, K-12, PR-25: where the chat with the driver of the accepted ride is — give it to
+     * `@jsm-mit/chat-sharded-package` (`ChatsActor.openChatAsyncUnsafe({ projectId, roomId })`
+     * on `chatCoordinatorId`). The room is the driver's (one per driver, not per ride): the
+     * rider has one chat with that driver over all their rides. Show "Napisz do kierowcy"
+     * from `accepted` to the end of the ride only.
+     * @returns undefined when the environment has no chat, or the driver is simulated (no chat in MVP)
+     * @throws Error with message `CanisterError` — `NOT_ACCEPTED` (no driver accepted yet)
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async getChatPlaceAsyncUnsafe() {
+        const accepted = await this.acceptedAsyncUnsafe();
+        if (accepted.canister === (await this.simulatorIdAsync()))
+            return undefined;
+        return driverChatPlaceAsyncUnsafe(this.group, accepted.canister, accepted.driverKey);
+    }
     /**
      * K-8: the rider rates the driver 1–5 after `completed`, once, within 24 h.
      * @returns false when the rider rated this ride already

package/dist/chat.d.ts

@@ -0,0 +1,51 @@
+import type { Identity } from "@icp-sdk/core/agent";
+import { type GroupOptions } from "./group/canister-actor.js";
+import { TigiGroup } from "./group/group.js";
+import type { ChatPlace } from "./interfaces.js";
+/** A room id of chat-sharded: at most 50 characters, never '/' or '|'. */
+export declare const MAX_ROOM_ID_CHARS = 50;
+export declare const DRIVER_ROOM_PREFIX = "drv-";
+/** The chat config of the core is asked again after this long. */
+export declare const CHAT_CONFIG_TTL_MS = 60000;
+/**
+ * C-15: the room of a driver — the core's `ChatRoomFunctions.driverRoomId`, the same rule:
+ * "drv-<canister>" for a canister with one driver (`driverKey` = ""),
+ * "drv-<canister>-<driverKey>" otherwise; undefined when longer than 50 characters or
+ * holding '/' or '|'. The core makes rooms for the canisters of its registry only (one
+ * driver each), so a simulated driver has no room (MVP).
+ */
+export declare function driverRoomId(driverCanisterId: string, driverKey?: string): string | undefined;
+/** @internal */
+export declare function chatConfigOfAsyncUnsafe(group: TigiGroup): Promise<{
+    chatCoordinatorId: string;
+    projectId: string;
+} | undefined>;
+/** @internal — the place of a driver's room, or undefined (no chat here, no room for this driver). */
+export declare function driverChatPlaceAsyncUnsafe(group: TigiGroup, driverCanisterId: string, driverKey: string): Promise<ChatPlace | undefined>;
+/**
+ * The chat places of the group, for the fronts — the driver's front (its own room: the
+ * chats of its riders) and anybody that knows a driver canister. The rider's front takes
+ * the place of its ride from `RideRequest.getChatPlaceAsyncUnsafe` instead.
+ */
+export declare class ChatPlacesActor {
+    private readonly group;
+    constructor(coordinatorId: string, identity?: Identity, options?: GroupOptions);
+    /**
+     * The chat of this environment: the chat group's coordinator and the project.
+     * @returns undefined when the environment has no chat yet
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    getChatConfigAsyncUnsafe(): Promise<{
+        chatCoordinatorId: string;
+        projectId: string;
+    } | undefined>;
+    /**
+     * FK-20: the room of a driver canister (one driver, `driverKey` = ""). The driver's front
+     * lists the chats of this room as their recipient and shows only the current rider's.
+     * @returns undefined when the environment has no chat yet or the driver has no room
+     * @throws Error with message `CanisterError` (errorKey `InvalidData`) — not a principal
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    getDriverChatPlaceAsyncUnsafe(driverCanisterId: string, driverKey?: string): Promise<ChatPlace | undefined>;
+}
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,MAAM,GAAG,SAAS,CAKjG;AAQD,gBAAgB;AAChB,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CASrI;AAED,sGAAsG;AACtG,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAQ9I;AAED;;;;GAIG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAE,YAAiB;IAIlF;;;;OAIG;IACU,wBAAwB,IAAI,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAI9G;;;;;;OAMG;IACU,6BAA6B,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;CAQ/H"}

package/dist/chat.js

@@ -0,0 +1,87 @@
+// The chat with a driver (U-43, core.md C-15): one room per driver in chat-sharded, made by
+// the core through the group's coordinator; the recipient is the owner of the driver
+// canister, and every Tigi account may open a chat there. The fronts talk to the chat
+// themselves with `@jsm-mit/chat-sharded-package` — this package only says WHERE.
+import { Principal } from "@icp-sdk/core/principal";
+import { transportAsync } from "./group/canister-actor.js";
+import { TigiGroup } from "./group/group.js";
+/** A room id of chat-sharded: at most 50 characters, never '/' or '|'. */
+export const MAX_ROOM_ID_CHARS = 50;
+export const DRIVER_ROOM_PREFIX = "drv-";
+/** The chat config of the core is asked again after this long. */
+export const CHAT_CONFIG_TTL_MS = 60_000;
+/**
+ * C-15: the room of a driver — the core's `ChatRoomFunctions.driverRoomId`, the same rule:
+ * "drv-<canister>" for a canister with one driver (`driverKey` = ""),
+ * "drv-<canister>-<driverKey>" otherwise; undefined when longer than 50 characters or
+ * holding '/' or '|'. The core makes rooms for the canisters of its registry only (one
+ * driver each), so a simulated driver has no room (MVP).
+ */
+export function driverRoomId(driverCanisterId, driverKey = "") {
+    const base = DRIVER_ROOM_PREFIX + driverCanisterId;
+    const id = driverKey === "" ? base : `${base}-${driverKey}`;
+    if (id.length > MAX_ROOM_ID_CHARS || id.includes("/") || id.includes("|"))
+        return undefined;
+    return id;
+}
+/**
+ * The chat of the environment as the core names it (`getChatConfig`), kept for
+ * `CHAT_CONFIG_TTL_MS` per group.
+ */
+const configs = new WeakMap();
+/** @internal */
+export async function chatConfigOfAsyncUnsafe(group) {
+    const known = configs.get(group);
+    if (known && Date.now() - known.atMs < CHAT_CONFIG_TTL_MS)
+        return known.value;
+    const answer = await transportAsync(async () => (await group.coreAsync()).getChatConfig());
+    const config = answer[0];
+    const value = config === undefined ? undefined : { chatCoordinatorId: config.chatCoordinatorId.toText(), projectId: config.projectId };
+    configs.set(group, { atMs: Date.now(), value });
+    return value;
+}
+/** @internal — the place of a driver's room, or undefined (no chat here, no room for this driver). */
+export async function driverChatPlaceAsyncUnsafe(group, driverCanisterId, driverKey) {
+    const roomId = driverRoomId(driverCanisterId, driverKey);
+    if (roomId === undefined || driverKey !== "")
+        return undefined;
+    const config = await chatConfigOfAsyncUnsafe(group);
+    if (config === undefined)
+        return undefined;
+    return { chatCoordinatorId: config.chatCoordinatorId, projectId: config.projectId, roomId };
+}
+/**
+ * The chat places of the group, for the fronts — the driver's front (its own room: the
+ * chats of its riders) and anybody that knows a driver canister. The rider's front takes
+ * the place of its ride from `RideRequest.getChatPlaceAsyncUnsafe` instead.
+ */
+export class ChatPlacesActor {
+    group;
+    constructor(coordinatorId, identity, options = {}) {
+        this.group = TigiGroup.of(coordinatorId, identity, options);
+    }
+    /**
+     * The chat of this environment: the chat group's coordinator and the project.
+     * @returns undefined when the environment has no chat yet
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async getChatConfigAsyncUnsafe() {
+        return chatConfigOfAsyncUnsafe(this.group);
+    }
+    /**
+     * FK-20: the room of a driver canister (one driver, `driverKey` = ""). The driver's front
+     * lists the chats of this room as their recipient and shows only the current rider's.
+     * @returns undefined when the environment has no chat yet or the driver has no room
+     * @throws Error with message `CanisterError` (errorKey `InvalidData`) — not a principal
+     * @throws Error with message `CriticalCanisterError` — the core could not be reached
+     */
+    async getDriverChatPlaceAsyncUnsafe(driverCanisterId, driverKey = "") {
+        try {
+            Principal.fromText(driverCanisterId);
+        }
+        catch {
+            throw new Error("CanisterError", { cause: { errorKey: "InvalidData", errorMessage: "not a canister id", logs: [] } });
+        }
+        return driverChatPlaceAsyncUnsafe(this.group, driverCanisterId, driverKey);
+    }
+}

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export { MAINNET_HOST, STOPPED_RETRY_ATTEMPTS, canisterError, errorKeyOf, isCani
 export { RidesActor, RideRequest, refusalKeyOf, REFRESH_WAIT_MS, REQUEST_POLL_MS, RIDE_POLL_MS, RIDE_POLL_NEAR_MS, SEARCH_RADIUS_METERS, WIDE_RADIUS_METERS, WIDEN_AFTER_MS, type RequestRideArgs, } from "./actors/rides-actor.js";
 export { ProfilesActor, RIDES_PAGE } from "./actors/profiles-actor.js";
 export { TestManagerActor, SIMULATED_DRIVERS } from "./actors/test-manager-actor.js";
+export { DriverCanistersActor, CLAIM_FRAGMENT_KEY, MAX_CLAIM_CODE_CHARS, claimCodeOfHash, claimLinkOf } from "./actors/driver-canisters-actor.js";
+export { ChatPlacesActor, CHAT_CONFIG_TTL_MS, DRIVER_ROOM_PREFIX, MAX_ROOM_ID_CHARS, driverRoomId } from "./chat.js";
 export { cellsWithin, decodeGeohashCenter, distanceMeters, encodeGeohash } from "./geo.js";
 export type * from "./interfaces.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,QAAQ,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3F,mBAAmB,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACH,YAAY,EACZ,sBAAsB,EACtB,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,QAAQ,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACH,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,KAAK,eAAe,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAClJ,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3F,mBAAmB,iBAAiB,CAAC"}

package/dist/index.js

@@ -4,9 +4,15 @@
 //
 // The rider (night 1, step 7): `RidesActor` (a request in every worker in range, merged
 // offers, one choice at a time, the ride in the driver canister), `ProfilesActor` (the
-// account and the history in the core), `TestManagerActor` (simulated drivers, ×10).
+// account, the rating and the history in the core), `TestManagerActor` (simulated drivers,
+// ×10). The chat (U-43): `ChatPlacesActor` and `RideRequest.getChatPlaceAsyncUnsafe` say
+// WHERE a driver's room is; the fronts use `@jsm-mit/chat-sharded-package` for the messages.
+// The driver's own canister (U-45): `DriverCanistersActor` (the demo lease, its extension,
+// "mine", the one-time claim code and the claim from the canister's own front).
 export { MAINNET_HOST, STOPPED_RETRY_ATTEMPTS, canisterError, errorKeyOf, isCanisterStoppedError, retrySettings, } from "./group/canister-actor.js";
 export { RidesActor, RideRequest, refusalKeyOf, REFRESH_WAIT_MS, REQUEST_POLL_MS, RIDE_POLL_MS, RIDE_POLL_NEAR_MS, SEARCH_RADIUS_METERS, WIDE_RADIUS_METERS, WIDEN_AFTER_MS, } from "./actors/rides-actor.js";
 export { ProfilesActor, RIDES_PAGE } from "./actors/profiles-actor.js";
 export { TestManagerActor, SIMULATED_DRIVERS } from "./actors/test-manager-actor.js";
+export { DriverCanistersActor, CLAIM_FRAGMENT_KEY, MAX_CLAIM_CODE_CHARS, claimCodeOfHash, claimLinkOf } from "./actors/driver-canisters-actor.js";
+export { ChatPlacesActor, CHAT_CONFIG_TTL_MS, DRIVER_ROOM_PREFIX, MAX_ROOM_ID_CHARS, driverRoomId } from "./chat.js";
 export { cellsWithin, decodeGeohashCenter, distanceMeters, encodeGeohash } from "./geo.js";

package/dist/interfaces.d.ts

@@ -146,4 +146,51 @@ export interface SpawnResult {
     registered: number;
     problems: string[];
 }
+/** PF-4: the signed-in user's rating as a rider (C-16), from the core. */
+export interface MyRatingView {
+    /** The average of the stars, e.g. 4.87 (show "★ 4,87"). */
+    average: number;
+    /** How many ratings. */
+    count: number;
+    sum: number;
+}
+/**
+ * U-43, C-15: where the chat with a driver is — what `@jsm-mit/chat-sharded-package` needs:
+ * `new ChatsActor(chatCoordinatorId, identity).openChatAsyncUnsafe({ projectId, roomId })`.
+ * One room per driver; its recipient is the driver (the owner of the driver canister).
+ */
+export interface ChatPlace {
+    /** The chat group's coordinator (its address). */
+    chatCoordinatorId: string;
+    projectId: string;
+    roomId: string;
+}
+/**
+ * A driver canister of the signed-in person: their own (`own`) or a demo canister they
+ * hold (`pool`). Its id is the driver's own address (`https://<canisterId>.icp0.io`).
+ */
+export interface DriverCanisterView {
+    canisterId: string;
+    kind: "own" | "pool";
+    /** The admin of the canister: after a claim (F-20) the driver, not the lease holder. */
+    ownerPrincipal: string;
+    /** A demo lease ends then (pool canisters). */
+    leaseUntilMs?: number;
+    blocked: boolean;
+}
+/** F-20: a one-time code that hands the demo canister to whoever claims it, until `expiresAtMs`. */
+export interface ClaimCodeView {
+    canisterId: string;
+    code: string;
+    expiresAtMs: number;
+}
+/** F-6, F-20a: a lease (with a claim code after a fresh one), or busy until then. */
+export type DemoLeaseView = {
+    kind: "leased";
+    canister: DriverCanisterView;
+    claim?: ClaimCodeView;
+} | {
+    kind: "busy";
+    untilMs: number;
+};
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,YAAY,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,wEAAwE;AACxE,MAAM,WAAW,KAAK;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC;AAE7E,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhF;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACtB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,GAAG,EAAE,GAAG,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,KAAK,EAAE,OAAO,CAAC;IACf,qFAAqF;IACrF,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,kBAAkB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEpF,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,kBAAkB,GAAG,aAAa,GAAG,cAAc,CAAC;AAEhG,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAElI,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,oCAAoC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oIAAoI;IACpI,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,wFAAwF;IACxF,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IACxD,qBAAqB;IACrB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzB,2FAA2F;AAC3F,MAAM,WAAW,QAAQ;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC;CAChB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE7E,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC7B,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,YAAY,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC,wEAAwE;AACxE,MAAM,WAAW,KAAK;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC;AAE7E,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhF;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACtB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,GAAG,EAAE,GAAG,CAAC;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,KAAK,EAAE,OAAO,CAAC;IACf,qFAAqF;IACrF,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,iFAAiF;IACjF,SAAS,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,kBAAkB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEpF,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,kBAAkB,GAAG,aAAa,GAAG,cAAc,CAAC;AAEhG,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,eAAe,GAAG,YAAY,GAAG,WAAW,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAElI,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,oCAAoC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,2GAA2G;IAC3G,gBAAgB,EAAE,OAAO,CAAC;IAC1B,oIAAoI;IACpI,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,wFAAwF;IACxF,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IACxD,qBAAqB;IACrB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,GACzB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzB,2FAA2F;AAC3F,MAAM,WAAW,QAAQ;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,wCAAwC;IACxC,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,KAAK,CAAC;CAChB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE7E,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC7B,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IACzB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACtB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAClB;AAID;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,wFAAwF;IACxF,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,qFAAqF;AACrF,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,kBAAkB,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/tigi-sharded-package",
-    "version": "0.1.0",
+    "version": "0.3.0",
     "description": "The one package of the Tigi network group: takes the coordinator's id and hides the coordinator, the core and the workers — for a consumer the group is one canister; plus the rider's few driver-canister endpoints (U-14).",
     "homepage": "https://github.com/JSM-Tigi/tigi-sharded/tree/master/package#readme",
     "repository": {
@@ -38,7 +38,9 @@
         "test-simulator": "bash scripts/run-tests-local.sh tests/test-simulator.ts",
         "test-drivers": "bash scripts/run-tests-local.sh tests/test-drivers.ts",
         "test-split": "bash scripts/run-tests-local.sh tests/test-split.ts",
-        "test-e2e": "npm run test-drivers && npm run test-simulator && npm run test-split"
+        "test-claim": "bash scripts/run-tests-local.sh tests/test-claim.ts",
+        "load-local": "bash scripts/run-load-local.sh",
+        "test-e2e": "npm run test-drivers && npm run test-simulator && npm run test-split && npm run test-claim"
     },
     "dependencies": {
         "@icp-sdk/core": "^6.1.0"
@@ -54,11 +56,11 @@
     "tigiSharded": {
         "repo": "tigi-sharded",
         "repoUrl": "https://github.com/JSM-Tigi/tigi-sharded",
-        "commit": "c891268dc31d69e26e3c4235c12a77a71f90d95e"
+        "commit": "8b9fac7d28569db8ee2633e5e40364528bd5aaa1"
     },
     "tigiDriverRust": {
         "repo": "tigi-driver-rust",
         "repoUrl": "https://github.com/JSM-Tigi/tigi-driver-rust",
-        "commit": "4625c46295bdebf434ede4784a22528c1beeb461"
+        "commit": "6870f40829f8532baa7209832e1c553d2c270f94"
     }
 }