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

package/declarations/core/core.did.d.ts

@@ -18,6 +18,18 @@ export type BlockTarget = { 'driverCanister' : Principal } |
   { 'driver' : { 'driverKey' : string, 'canister' : Principal } } |
   { 'rider' : Principal };
 export interface CanisterArgs { 'canister' : Principal }
+export interface ChatConfig {
+  'chatCoordinatorId' : Principal,
+  'projectId' : string,
+}
+export interface ChatRoomsStatus {
+  'failures' : bigint,
+  'pending' : bigint,
+  'lastError' : [] | [string],
+  'config' : [] | [ChatConfig],
+  'pendingSinceNs' : [] | [bigint],
+  'rooms' : bigint,
+}
 export interface DriverCanister {
   'moduleHash' : [] | [Uint8Array | number[]],
   'owner' : Principal,
@@ -39,6 +51,14 @@ export interface DriverCanistersPage {
   'total' : bigint,
   'canisters' : Array<DriverCanister>,
 }
+export interface DriverRoomView {
+  'recipient' : Principal,
+  'driverKey' : string,
+  'canister' : Principal,
+  'lastError' : [] | [string],
+  'roomId' : string,
+  'synced' : boolean,
+}
 export interface Error { 'details' : ErrorDetails, 'logsJson' : string }
 export type ErrorDetails = { 'InterCanisterConnectionError' : null } |
   { 'RemoteCanisterError' : string } |
@@ -79,6 +99,7 @@ export interface Profile {
 }
 export interface ProfileEntry { 'principal' : Principal, 'name' : string }
 export interface ProfilesArgs { 'principals' : Array<Principal> }
+export interface Rating { 'sum' : bigint, 'count' : bigint }
 export interface RatingEntry {
   'requestId' : string,
   'side' : RatingSide,
@@ -98,46 +119,54 @@ export type Result = { 'ok' : bigint } |
   { 'err' : Error };
 export type Result_1 = { 'ok' : Uint8Array | number[] } |
   { 'err' : Error };
-export type Result_10 = { 'ok' : Wiring } |
+export type Result_10 = { 'ok' : RideBatchResult } |
+  { 'err' : Error };
+export type Result_11 = {
+    'ok' : {
+      'subjects' : bigint,
+      'headSeq' : bigint,
+      'lastError' : [] | [string],
+      'laggingWorkers' : bigint,
+    }
+  } |
   { 'err' : Error };
-export type Result_11 = { 'ok' : Array<ProfileEntry> } |
+export type Result_12 = { 'ok' : Wiring } |
   { 'err' : Error };
-export type Result_12 = { 'ok' : RidesPage } |
+export type Result_13 = { 'ok' : Array<ProfileEntry> } |
   { 'err' : Error };
-export type Result_13 = { 'ok' : DriverCanister } |
+export type Result_14 = { 'ok' : RidesPage } |
   { 'err' : Error };
-export type Result_14 = { 'ok' : FactoryStatus } |
+export type Result_15 = { 'ok' : [] | [Rating] } |
   { 'err' : Error };
-export type Result_15 = { 'ok' : [] | [RolloutView] } |
+export type Result_16 = { 'ok' : DriverCanister } |
   { 'err' : Error };
-export type Result_16 = { 'ok' : Array<Principal> } |
+export type Result_17 = { 'ok' : FactoryStatus } |
   { 'err' : Error };
-export type Result_17 = { 'ok' : Principal } |
+export type Result_18 = { 'ok' : [] | [RolloutView] } |
   { 'err' : Error };
-export type Result_18 = { 'ok' : WasmInfo } |
+export type Result_19 = { 'ok' : ChatRoomsStatus } |
   { 'err' : Error };
 export type Result_2 = { 'ok' : boolean } |
   { 'err' : Error };
+export type Result_20 = { 'ok' : Array<Principal> } |
+  { 'err' : Error };
+export type Result_21 = { 'ok' : Principal } |
+  { 'err' : Error };
+export type Result_22 = { 'ok' : WasmInfo } |
+  { 'err' : Error };
 export type Result_3 = { 'ok' : RolloutView } |
   { 'err' : Error };
 export type Result_4 = { 'ok' : Profile } |
   { 'err' : Error };
-export type Result_5 = { 'ok' : DriverCanistersPage } |
+export type Result_5 = { 'ok' : ChatConfig } |
   { 'err' : Error };
-export type Result_6 = { 'ok' : Array<Block> } |
+export type Result_6 = { 'ok' : Array<DriverRoomView> } |
   { 'err' : Error };
-export type Result_7 = { 'ok' : LeaseAnswer } |
+export type Result_7 = { 'ok' : DriverCanistersPage } |
   { 'err' : Error };
-export type Result_8 = { 'ok' : RideBatchResult } |
+export type Result_8 = { 'ok' : Array<Block> } |
   { 'err' : Error };
-export type Result_9 = {
-    'ok' : {
-      'subjects' : bigint,
-      'headSeq' : bigint,
-      'lastError' : [] | [string],
-      'laggingWorkers' : bigint,
-    }
-  } |
+export type Result_9 = { 'ok' : LeaseAnswer } |
   { 'err' : Error };
 export interface RideBatch {
   'ratings' : Array<RatingEntry>,
@@ -200,7 +229,7 @@ export interface TigiCore {
   /**
    * / Admins: a canister the core controls joins the demo pool (U-35).
    */
-  'addPoolCanister' : ActorMethod<[CanisterArgs], Result_13>,
+  'addPoolCanister' : ActorMethod<[CanisterArgs], Result_16>,
   /**
    * / Admins: a driver canister, or one driver in it (`driverKey`), is blocked; the workers
    * / drop it at once (WO-2).
@@ -215,44 +244,58 @@ export interface TigiCore {
    * / Admins: the chunks become THE module of their kind. A new driver wasm is released
    * / (F-11) and its hash goes to the workers.
    */
-  'commitDriverWasm' : ActorMethod<[WasmCommitArgs], Result_18>,
+  'commitDriverWasm' : ActorMethod<[WasmCommitArgs], Result_22>,
   /**
    * / Admins, localTest: an empty canister from the core's cycles joins the demo pool.
    */
-  'createLocalPoolCanister' : ActorMethod<[], Result_13>,
+  'createLocalPoolCanister' : ActorMethod<[], Result_16>,
   /**
    * / F-2 … F-4, F-10: the caller's own driver canister (localTest: from the core's cycles).
    */
-  'createMyDriverCanister' : ActorMethod<[], Result_13>,
+  'createMyDriverCanister' : ActorMethod<[], Result_16>,
   /**
    * / Admins: the simulator, created once (F-18).
    */
-  'ensureSimulator' : ActorMethod<[], Result_17>,
+  'ensureSimulator' : ActorMethod<[], Result_21>,
   /**
    * / F-8: 15 min more for the holder of a demo canister.
    */
-  'extendDemoLease' : ActorMethod<[], Result_13>,
-  'getAdmins' : ActorMethod<[], Result_16>,
+  'extendDemoLease' : ActorMethod<[], Result_16>,
+  'getAdmins' : ActorMethod<[], Result_20>,
+  /**
+   * / For the fronts (through the package): where the chat of this environment is. Null =
+   * / no chat here yet. The room of a driver is `ChatRoomFunctions.driverRoomId`.
+   */
+  'getChatConfig' : ActorMethod<[], [] | [ChatConfig]>,
+  /**
+   * / Admins: how far the driver rooms are (C-15).
+   */
+  'getChatRoomsStatus' : ActorMethod<[], Result_19>,
   /**
    * / WO-1, WO-2: what the core knows of a canister — for the workers and anybody.
    */
   'getDriverCanisterStatus' : ActorMethod<[CanisterArgs], DriverCanisterStatus>,
-  'getDriverRollout' : ActorMethod<[], Result_15>,
-  'getFactoryStatus' : ActorMethod<[], Result_14>,
+  'getDriverRollout' : ActorMethod<[], Result_18>,
+  'getFactoryStatus' : ActorMethod<[], Result_17>,
   'getLogs' : ActorMethod<[], string>,
   /**
    * / The caller's own canister, or the demo canister the caller holds now.
    */
-  'getMyDriverCanister' : ActorMethod<[], Result_13>,
+  'getMyDriverCanister' : ActorMethod<[], Result_16>,
   'getMyProfile' : ActorMethod<[], Result_4>,
+  /**
+   * / C-16, PF-4: the caller's own rating as a rider (sum and count of stars; null = no
+   * / rating yet). Ratings reach the core in the workers' batches, up to a minute late.
+   */
+  'getMyRating' : ActorMethod<[], Result_15>,
   /**
    * / C-8: the caller's rides, newest first.
    */
-  'getMyRides' : ActorMethod<[RidesPageArgs], Result_12>,
+  'getMyRides' : ActorMethod<[RidesPageArgs], Result_14>,
   /**
    * / C-3: the names of up to MAX_PROFILES_PER_CALL principals; unknown ones are left out.
    */
-  'getProfiles' : ActorMethod<[ProfilesArgs], Result_11>,
+  'getProfiles' : ActorMethod<[ProfilesArgs], Result_13>,
   /**
    * / F-11: the driver wasms released so far, oldest first.
    */
@@ -264,11 +307,11 @@ export interface TigiCore {
   /**
    * / Admins: the coordinator, the workers confirmed so far, the mode.
    */
-  'getWiring' : ActorMethod<[], Result_10>,
+  'getWiring' : ActorMethod<[], Result_12>,
   /**
    * / Admins: how far the outbox to the workers is (C-6, C-7).
    */
-  'getWorkerOutbox' : ActorMethod<[], Result_9>,
+  'getWorkerOutbox' : ActorMethod<[], Result_11>,
   /**
    * / Workers of the group: the core asks the coordinator once and remembers the worker,
    * / which then gets the network state through the outbox. A worker calls it once after
@@ -280,15 +323,31 @@ export interface TigiCore {
    * / Idempotent: a known requestId and a counted rating count once. Invalid entries are
    * / rejected and logged; the worker drops the whole batch after an ok.
    */
-  'ingestRideBatch' : ActorMethod<[RideBatch], Result_8>,
+  'ingestRideBatch' : ActorMethod<[RideBatch], Result_10>,
+  /**
+   * / C-14: the accounts gate of the chat (U-43). The chat core asks this group's
+   * / coordinator WHERE (`accountsCanisterFor` → this core) and asks here: true = an
+   * / account with a name exists for the principal and the rider is not blocked.
+   */
+  'isUser' : ActorMethod<[Principal], boolean>,
   /**
    * / F-5 … F-7: a demo canister for 15 min (outside prod).
    */
-  'leaseDemoDriverCanister' : ActorMethod<[], Result_7>,
-  'listBlocks' : ActorMethod<[PageArgs], Result_6>,
-  'listDriverCanisters' : ActorMethod<[PageArgs], Result_5>,
+  'leaseDemoDriverCanister' : ActorMethod<[], Result_9>,
+  'listBlocks' : ActorMethod<[PageArgs], Result_8>,
+  'listDriverCanisters' : ActorMethod<[PageArgs], Result_7>,
+  /**
+   * / Admins: the driver rooms as the core wants them, 100 a page at most.
+   */
+  'listDriverRooms' : ActorMethod<[PageArgs], Result_6>,
   'removeAdmin' : ActorMethod<[PrincipalArgs], Result_2>,
   'resumeDriverRollout' : ActorMethod<[], Result_3>,
+  /**
+   * / Admins: the chat of this environment — the chat group's coordinator and the project
+   * / (whose admin and accounts field are this group's coordinator). Every call sends every
+   * / driver room again (a new project, a chat group set up again).
+   */
+  'setChatConfig' : ActorMethod<[ChatConfig], Result_5>,
   'setLoggingEnabled' : ActorMethod<[boolean], Result_2>,
   /**
    * / The coordinator only: the balance below which the core asks for cycles.

package/declarations/core/core.did.js

@@ -61,7 +61,7 @@ export const idlFactory = ({ IDL }) => {
     'installedAtNs' : IDL.Opt(IDL.Int),
     'leaseUntilNs' : IDL.Opt(IDL.Int),
   });
-  const Result_13 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
+  const Result_16 = IDL.Variant({ 'ok' : DriverCanister, 'err' : Error });
   const BlockDriverArgs = IDL.Record({
     'driverKey' : IDL.Opt(IDL.Text),
     'canister' : IDL.Principal,
@@ -83,18 +83,31 @@ export const idlFactory = ({ IDL }) => {
     'size' : IDL.Nat,
     'committedAtNs' : IDL.Int,
   });
-  const Result_18 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
-  const Result_17 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
-  const Result_16 = IDL.Variant({
+  const Result_22 = IDL.Variant({ 'ok' : WasmInfo, 'err' : Error });
+  const Result_21 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
+  const Result_20 = IDL.Variant({
     'ok' : IDL.Vec(IDL.Principal),
     'err' : Error,
   });
+  const ChatConfig = IDL.Record({
+    'chatCoordinatorId' : IDL.Principal,
+    'projectId' : IDL.Text,
+  });
+  const ChatRoomsStatus = IDL.Record({
+    'failures' : IDL.Nat,
+    'pending' : IDL.Nat,
+    'lastError' : IDL.Opt(IDL.Text),
+    'config' : IDL.Opt(ChatConfig),
+    'pendingSinceNs' : IDL.Opt(IDL.Int),
+    'rooms' : IDL.Nat,
+  });
+  const Result_19 = IDL.Variant({ 'ok' : ChatRoomsStatus, 'err' : Error });
   const DriverCanisterStatus = IDL.Record({
     'moduleHash' : IDL.Opt(IDL.Vec(IDL.Nat8)),
     'blocked' : IDL.Bool,
     'registered' : IDL.Bool,
   });
-  const Result_15 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
+  const Result_18 = IDL.Variant({ 'ok' : IDL.Opt(RolloutView), 'err' : Error });
   const FactoryStatus = IDL.Record({
     'simulator' : IDL.Opt(IDL.Principal),
     'mode' : Mode,
@@ -106,13 +119,15 @@ export const idlFactory = ({ IDL }) => {
     'driverWasm' : IDL.Opt(WasmInfo),
     'registered' : IDL.Nat,
   });
-  const Result_14 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
+  const Result_17 = IDL.Variant({ 'ok' : FactoryStatus, 'err' : Error });
   const Profile = IDL.Record({
     'updatedAtNs' : IDL.Int,
     'name' : IDL.Text,
     'createdAtNs' : IDL.Int,
   });
   const Result_4 = IDL.Variant({ 'ok' : Profile, 'err' : Error });
+  const Rating = IDL.Record({ 'sum' : IDL.Nat, 'count' : IDL.Nat });
+  const Result_15 = IDL.Variant({ 'ok' : IDL.Opt(Rating), 'err' : Error });
   const RidesPageArgs = IDL.Record({
     'beforeIndex' : IDL.Opt(IDL.Nat),
     'limit' : IDL.Nat,
@@ -136,13 +151,13 @@ export const idlFactory = ({ IDL }) => {
     'nextBeforeIndex' : IDL.Opt(IDL.Nat),
     'rides' : IDL.Vec(RideEntry),
   });
-  const Result_12 = IDL.Variant({ 'ok' : RidesPage, 'err' : Error });
+  const Result_14 = IDL.Variant({ 'ok' : RidesPage, 'err' : Error });
   const ProfilesArgs = IDL.Record({ 'principals' : IDL.Vec(IDL.Principal) });
   const ProfileEntry = IDL.Record({
     'principal' : IDL.Principal,
     'name' : IDL.Text,
   });
-  const Result_11 = IDL.Variant({
+  const Result_13 = IDL.Variant({
     'ok' : IDL.Vec(ProfileEntry),
     'err' : Error,
   });
@@ -156,8 +171,8 @@ export const idlFactory = ({ IDL }) => {
     'knownWorkers' : IDL.Vec(IDL.Principal),
     'coordinator' : IDL.Opt(IDL.Principal),
   });
-  const Result_10 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
-  const Result_9 = IDL.Variant({
+  const Result_12 = IDL.Variant({ 'ok' : Wiring, 'err' : Error });
+  const Result_11 = IDL.Variant({
     'ok' : IDL.Record({
       'subjects' : IDL.Nat,
       'headSeq' : IDL.Nat64,
@@ -188,12 +203,12 @@ export const idlFactory = ({ IDL }) => {
     'rejected' : IDL.Nat,
     'ratingsCounted' : IDL.Nat,
   });
-  const Result_8 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
+  const Result_10 = IDL.Variant({ 'ok' : RideBatchResult, 'err' : Error });
   const LeaseAnswer = IDL.Variant({
     'busy' : IDL.Record({ 'untilNs' : IDL.Int }),
     'leased' : DriverCanister,
   });
-  const Result_7 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
+  const Result_9 = IDL.Variant({ 'ok' : LeaseAnswer, 'err' : Error });
   const PageArgs = IDL.Record({ 'offset' : IDL.Nat, 'limit' : IDL.Nat });
   const BlockTarget = IDL.Variant({
     'driverCanister' : IDL.Principal,
@@ -209,12 +224,25 @@ export const idlFactory = ({ IDL }) => {
     'target' : BlockTarget,
     'reason' : IDL.Text,
   });
-  const Result_6 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
+  const Result_8 = IDL.Variant({ 'ok' : IDL.Vec(Block), 'err' : Error });
   const DriverCanistersPage = IDL.Record({
     'total' : IDL.Nat,
     'canisters' : IDL.Vec(DriverCanister),
   });
-  const Result_5 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
+  const Result_7 = IDL.Variant({ 'ok' : DriverCanistersPage, 'err' : Error });
+  const DriverRoomView = IDL.Record({
+    'recipient' : IDL.Principal,
+    'driverKey' : IDL.Text,
+    'canister' : IDL.Principal,
+    'lastError' : IDL.Opt(IDL.Text),
+    'roomId' : IDL.Text,
+    'synced' : IDL.Bool,
+  });
+  const Result_6 = IDL.Variant({
+    'ok' : IDL.Vec(DriverRoomView),
+    'err' : Error,
+  });
+  const Result_5 = IDL.Variant({ 'ok' : ChatConfig, 'err' : Error });
   const SetProfileArgs = IDL.Record({ 'name' : IDL.Text });
   const UnblockDriverArgs = IDL.Record({
     'driverKey' : IDL.Opt(IDL.Text),
@@ -231,39 +259,45 @@ export const idlFactory = ({ IDL }) => {
   const TigiCore = IDL.Service({
     'abortDriverRollout' : IDL.Func([], [Result_3], []),
     'addAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
-    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_13], []),
+    'addPoolCanister' : IDL.Func([CanisterArgs], [Result_16], []),
     'blockDriver' : IDL.Func([BlockDriverArgs], [Result_2], []),
     'blockRider' : IDL.Func([BlockRiderArgs], [Result_2], []),
     'clearLogs' : IDL.Func([], [], []),
-    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_18], []),
-    'createLocalPoolCanister' : IDL.Func([], [Result_13], []),
-    'createMyDriverCanister' : IDL.Func([], [Result_13], []),
-    'ensureSimulator' : IDL.Func([], [Result_17], []),
-    'extendDemoLease' : IDL.Func([], [Result_13], []),
-    'getAdmins' : IDL.Func([], [Result_16], ['query']),
+    'commitDriverWasm' : IDL.Func([WasmCommitArgs], [Result_22], []),
+    'createLocalPoolCanister' : IDL.Func([], [Result_16], []),
+    'createMyDriverCanister' : IDL.Func([], [Result_16], []),
+    'ensureSimulator' : IDL.Func([], [Result_21], []),
+    'extendDemoLease' : IDL.Func([], [Result_16], []),
+    'getAdmins' : IDL.Func([], [Result_20], ['query']),
+    'getChatConfig' : IDL.Func([], [IDL.Opt(ChatConfig)], ['query']),
+    'getChatRoomsStatus' : IDL.Func([], [Result_19], ['query']),
     'getDriverCanisterStatus' : IDL.Func(
         [CanisterArgs],
         [DriverCanisterStatus],
         ['query'],
       ),
-    'getDriverRollout' : IDL.Func([], [Result_15], ['query']),
-    'getFactoryStatus' : IDL.Func([], [Result_14], ['query']),
+    'getDriverRollout' : IDL.Func([], [Result_18], ['query']),
+    'getFactoryStatus' : IDL.Func([], [Result_17], ['query']),
     'getLogs' : IDL.Func([], [IDL.Text], ['query']),
-    'getMyDriverCanister' : IDL.Func([], [Result_13], ['query']),
+    'getMyDriverCanister' : IDL.Func([], [Result_16], ['query']),
     'getMyProfile' : IDL.Func([], [Result_4], ['query']),
-    'getMyRides' : IDL.Func([RidesPageArgs], [Result_12], ['query']),
-    'getProfiles' : IDL.Func([ProfilesArgs], [Result_11], ['query']),
+    'getMyRating' : IDL.Func([], [Result_15], ['query']),
+    'getMyRides' : IDL.Func([RidesPageArgs], [Result_14], ['query']),
+    'getProfiles' : IDL.Func([ProfilesArgs], [Result_13], ['query']),
     'getReleasedDriverWasms' : IDL.Func([], [IDL.Vec(ReleasedWasm)], ['query']),
     'getSimulator' : IDL.Func([], [IDL.Opt(IDL.Principal)], ['query']),
-    'getWiring' : IDL.Func([], [Result_10], ['query']),
-    'getWorkerOutbox' : IDL.Func([], [Result_9], ['query']),
+    'getWiring' : IDL.Func([], [Result_12], ['query']),
+    'getWorkerOutbox' : IDL.Func([], [Result_11], ['query']),
     'helloFromWorker' : IDL.Func([], [Result_2], []),
-    'ingestRideBatch' : IDL.Func([RideBatch], [Result_8], []),
-    'leaseDemoDriverCanister' : IDL.Func([], [Result_7], []),
-    'listBlocks' : IDL.Func([PageArgs], [Result_6], ['query']),
-    'listDriverCanisters' : IDL.Func([PageArgs], [Result_5], ['query']),
+    'ingestRideBatch' : IDL.Func([RideBatch], [Result_10], []),
+    'isUser' : IDL.Func([IDL.Principal], [IDL.Bool], ['query']),
+    'leaseDemoDriverCanister' : IDL.Func([], [Result_9], []),
+    'listBlocks' : IDL.Func([PageArgs], [Result_8], ['query']),
+    'listDriverCanisters' : IDL.Func([PageArgs], [Result_7], ['query']),
+    'listDriverRooms' : IDL.Func([PageArgs], [Result_6], ['query']),
     'removeAdmin' : IDL.Func([PrincipalArgs], [Result_2], []),
     'resumeDriverRollout' : IDL.Func([], [Result_3], []),
+    'setChatConfig' : IDL.Func([ChatConfig], [Result_5], []),
     'setLoggingEnabled' : IDL.Func([IDL.Bool], [Result_2], []),
     'setLowCyclesBelow' : IDL.Func([IDL.Nat], [Result_2], []),
     'setMyProfile' : IDL.Func([SetProfileArgs], [Result_4], []),

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"}