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

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

@@ -58,6 +58,18 @@ export interface DriverCanistersPage {
   'total' : bigint,
   'canisters' : Array<DriverCanister>,
 }
+export interface DriverFeeAccountView {
+  'pending' : FeeUsage,
+  'bill' : [] | [FeeBill],
+  'lastSettledDay' : [] | [bigint],
+  'canister' : Principal,
+  'paidTotal' : bigint,
+  'lastFee' : [] | [FeeRecord],
+}
+export interface DriverRatingArgs {
+  'driverKey' : string,
+  'canister' : Principal,
+}
 export interface DriverRoomView {
   'recipient' : Principal,
   'driverKey' : string,
@@ -66,6 +78,12 @@ export interface DriverRoomView {
   'roomId' : string,
   'synced' : boolean,
 }
+export interface DriverUsage {
+  'quoteRequests' : bigint,
+  'canister' : Principal,
+  'registrations' : bigint,
+  'rides' : bigint,
+}
 export interface Error { 'details' : ErrorDetails, 'logsJson' : string }
 export type ErrorDetails = { 'InterCanisterConnectionError' : null } |
   { 'RemoteCanisterError' : string } |
@@ -85,6 +103,46 @@ export interface FactoryStatus {
   'driverWasm' : [] | [WasmInfo],
   'registered' : bigint,
 }
+export interface FeeBill {
+  'day' : bigint,
+  'settled' : boolean,
+  'usage' : FeeUsage,
+  'amount' : bigint,
+  'multiplierPermille' : bigint,
+  'rates' : FeeRates,
+}
+export interface FeePaid {
+  'day' : bigint,
+  'accepted' : bigint,
+  'amount' : bigint,
+}
+export interface FeePayArgs { 'day' : bigint }
+export interface FeeRates {
+  'perRegistration' : bigint,
+  'perQuoteRequest' : bigint,
+  'perRide' : bigint,
+}
+export interface FeeRecord {
+  'day' : bigint,
+  'paidAtNs' : bigint,
+  'amount' : bigint,
+}
+export interface FeeStatus {
+  'multiplier' : [] | [{ 'day' : bigint, 'permille' : bigint }],
+  'today' : bigint,
+  'toForward' : bigint,
+  'forwardedTotal' : bigint,
+  'lastForwardError' : [] | [string],
+  'accounts' : bigint,
+  'paidTotal' : bigint,
+  'rates' : FeeRates,
+}
+export interface FeeUsage {
+  'quoteRequests' : bigint,
+  'registrations' : bigint,
+  'rides' : bigint,
+}
+export interface Geo { 'lat' : number, 'lng' : number }
 export interface InitArgs {
   'mode' : Mode,
   'admins' : Array<Principal>,
@@ -117,6 +175,10 @@ export interface Profile {
 }
 export interface ProfileEntry { 'principal' : Principal, 'name' : string }
 export interface ProfilesArgs { 'principals' : Array<Principal> }
+export interface RateRideArgs { 'requestId' : string, 'stars' : number }
+export type RateRideOutcome = { 'notRatable' : string } |
+  { 'rated' : null } |
+  { 'alreadyRated' : null };
 export interface Rating { 'sum' : bigint, 'count' : bigint }
 export interface RatingEntry {
   'requestId' : string,
@@ -133,15 +195,24 @@ export interface ReleasedWasm {
   'size' : bigint,
   'releasedAtNs' : bigint,
 }
+export interface RequestIdArgs { 'requestId' : string }
 export type Result = { 'ok' : bigint } |
   { 'err' : Error };
 export type Result_1 = { 'ok' : Uint8Array | number[] } |
   { 'err' : Error };
-export type Result_10 = { 'ok' : LeaseAnswer } |
+export type Result_10 = { 'ok' : Array<DriverRoomView> } |
+  { 'err' : Error };
+export type Result_11 = { 'ok' : Array<DriverFeeAccountView> } |
   { 'err' : Error };
-export type Result_11 = { 'ok' : RideBatchResult } |
+export type Result_12 = { 'ok' : DriverCanistersPage } |
   { 'err' : Error };
-export type Result_12 = {
+export type Result_13 = { 'ok' : Array<Block> } |
+  { 'err' : Error };
+export type Result_14 = { 'ok' : LeaseAnswer } |
+  { 'err' : Error };
+export type Result_15 = { 'ok' : RideBatchResult } |
+  { 'err' : Error };
+export type Result_16 = {
     'ok' : {
       'subjects' : bigint,
       'headSeq' : bigint,
@@ -150,47 +221,56 @@ export type Result_12 = {
     }
   } |
   { 'err' : Error };
-export type Result_13 = { 'ok' : Wiring } |
+export type Result_17 = { 'ok' : Wiring } |
   { 'err' : Error };
-export type Result_14 = { 'ok' : Array<ProfileEntry> } |
+export type Result_18 = { 'ok' : Array<ProfileEntry> } |
   { 'err' : Error };
-export type Result_15 = { 'ok' : RidesPage } |
+export type Result_19 = { 'ok' : RidesPage } |
   { 'err' : Error };
-export type Result_16 = { 'ok' : [] | [Rating] } |
+export type Result_2 = { 'ok' : boolean } |
   { 'err' : Error };
-export type Result_17 = { 'ok' : DriverCanister } |
+export type Result_20 = { 'ok' : RideView } |
   { 'err' : Error };
-export type Result_18 = { 'ok' : FactoryStatus } |
+export type Result_21 = { 'ok' : [] | [Rating] } |
   { 'err' : Error };
-export type Result_19 = { 'ok' : [] | [RolloutView] } |
+export type Result_22 = { 'ok' : DriverCanister } |
   { 'err' : Error };
-export type Result_2 = { 'ok' : boolean } |
+export type Result_23 = { 'ok' : FeeStatus } |
+  { 'err' : Error };
+export type Result_24 = { 'ok' : FactoryStatus } |
+  { 'err' : Error };
+export type Result_25 = { 'ok' : [] | [RolloutView] } |
   { 'err' : Error };
-export type Result_20 = { 'ok' : ChatRoomsStatus } |
+export type Result_26 = { 'ok' : FeeBill } |
   { 'err' : Error };
-export type Result_21 = { 'ok' : Array<Principal> } |
+export type Result_27 = { 'ok' : DriverFeeAccountView } |
   { 'err' : Error };
-export type Result_22 = { 'ok' : Principal } |
+export type Result_28 = { 'ok' : ChatRoomsStatus } |
   { 'err' : Error };
-export type Result_23 = { 'ok' : WasmInfo } |
+export type Result_29 = { 'ok' : Array<Principal> } |
   { 'err' : Error };
 export type Result_3 = { 'ok' : RolloutView } |
   { 'err' : Error };
+export type Result_30 = { 'ok' : Principal } |
+  { 'err' : Error };
+export type Result_31 = { 'ok' : WasmInfo } |
+  { 'err' : Error };
 export type Result_4 = { 'ok' : Profile } |
   { 'err' : Error };
-export type Result_5 = { 'ok' : ChatConfig } |
+export type Result_5 = { 'ok' : FeeRates } |
   { 'err' : Error };
-export type Result_6 = { 'ok' : ClaimCode } |
+export type Result_6 = { 'ok' : ChatConfig } |
   { 'err' : Error };
-export type Result_7 = { 'ok' : Array<DriverRoomView> } |
+export type Result_7 = { 'ok' : RateRideOutcome } |
   { 'err' : Error };
-export type Result_8 = { 'ok' : DriverCanistersPage } |
+export type Result_8 = { 'ok' : FeePaid } |
   { 'err' : Error };
-export type Result_9 = { 'ok' : Array<Block> } |
+export type Result_9 = { 'ok' : ClaimCode } |
   { 'err' : Error };
 export interface RideBatch {
   'ratings' : Array<RatingEntry>,
-  'rides' : Array<RideEntry>,
+  'usage' : [] | [UsageBatch],
+  'rides' : Array<RideEntryIn>,
 }
 export interface RideBatchResult {
   'duplicates' : bigint,
@@ -201,18 +281,33 @@ export interface RideBatchResult {
 export type RideEnd = { 'completed' : null } |
   { 'cancelledByRider' : null } |
   { 'cancelledByDriver' : null };
-export interface RideEntry {
+export interface RideEntryIn {
+  'end' : RideEnd,
+  'destination' : [] | [Geo],
+  'requestId' : string,
+  'endedAtNs' : bigint,
+  'pickup' : [] | [Geo],
+  'driverKey' : string,
+  'driverCanister' : Principal,
+  'price' : [] | [Money],
+  'rider' : Principal,
+}
+export interface RideView {
   'end' : RideEnd,
+  'destination' : [] | [Geo],
   'requestId' : string,
   'endedAtNs' : bigint,
+  'ratable' : [] | [boolean],
+  'pickup' : [] | [Geo],
   'driverKey' : string,
   'driverCanister' : Principal,
   'price' : [] | [Money],
   'rider' : Principal,
+  'myRating' : [] | [number],
 }
 export interface RidesPage {
   'nextBeforeIndex' : [] | [bigint],
-  'rides' : Array<RideEntry>,
+  'rides' : Array<RideView>,
 }
 export interface RidesPageArgs {
   'beforeIndex' : [] | [bigint],
@@ -240,6 +335,8 @@ export interface RolloutView {
   'finishedAtNs' : [] | [bigint],
 }
 export interface SetProfileArgs { 'name' : string }
+export interface SimulatorRouterArgs { 'router' : [] | [Principal] }
+export interface TestDayArgs { 'days' : bigint }
 export interface TigiCore {
   'abortDriverRollout' : ActorMethod<[], Result_3>,
   /**
@@ -249,7 +346,7 @@ export interface TigiCore {
   /**
    * / Admins: a canister the core controls joins the demo pool (U-35).
    */
-  'addPoolCanister' : ActorMethod<[CanisterArgs], Result_17>,
+  'addPoolCanister' : ActorMethod<[CanisterArgs], Result_22>,
   /**
    * / Admins: a driver canister, or one driver in it (`driverKey`), is blocked; the workers
    * / drop it at once (WO-2).
@@ -264,30 +361,30 @@ export interface TigiCore {
    * / over the demo canister with the code of the link. Single use, 15 min; every refusal
    * / answers the same NotAuthorized. The room of the canister gets the caller (C-15).
    */
-  'claimDriverCanister' : ActorMethod<[ClaimArgs], Result_17>,
+  'claimDriverCanister' : ActorMethod<[ClaimArgs], Result_22>,
   'clearLogs' : ActorMethod<[], undefined>,
   /**
    * / 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_23>,
+  'commitDriverWasm' : ActorMethod<[WasmCommitArgs], Result_31>,
   /**
    * / Admins, localTest: an empty canister from the core's cycles joins the demo pool.
    */
-  'createLocalPoolCanister' : ActorMethod<[], Result_17>,
+  'createLocalPoolCanister' : ActorMethod<[], Result_22>,
   /**
    * / F-2 … F-4, F-10: the caller's own driver canister (localTest: from the core's cycles).
    */
-  'createMyDriverCanister' : ActorMethod<[], Result_17>,
+  'createMyDriverCanister' : ActorMethod<[], Result_22>,
   /**
    * / Admins: the simulator, created once (F-18).
    */
-  'ensureSimulator' : ActorMethod<[], Result_22>,
+  'ensureSimulator' : ActorMethod<[], Result_30>,
   /**
    * / F-8: 15 min more for the holder of a demo canister.
    */
-  'extendDemoLease' : ActorMethod<[], Result_17>,
-  'getAdmins' : ActorMethod<[], Result_21>,
+  'extendDemoLease' : ActorMethod<[], Result_22>,
+  'getAdmins' : ActorMethod<[], Result_29>,
   /**
    * / 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`.
@@ -296,32 +393,58 @@ export interface TigiCore {
   /**
    * / Admins: how far the driver rooms are (C-15).
    */
-  'getChatRoomsStatus' : ActorMethod<[], Result_20>,
+  'getChatRoomsStatus' : ActorMethod<[], Result_28>,
   /**
    * / WO-1, WO-2: what the core knows of a canister — for the workers and anybody.
    */
   'getDriverCanisterStatus' : ActorMethod<[CanisterArgs], DriverCanisterStatus>,
-  'getDriverRollout' : ActorMethod<[], Result_19>,
-  'getFactoryStatus' : ActorMethod<[], Result_18>,
+  /**
+   * / Admins: the account of one driver canister (C-17 … C-20).
+   */
+  'getDriverFeeAccount' : ActorMethod<[CanisterArgs], Result_27>,
+  /**
+   * / C-19: a driver canister of the registry asks for its bill — the events since its
+   * / last settlement, priced on the fee's day. Called by the canister at its first
+   * / "Przyjmuję zlecenia" of a day. A pool canister owes nothing (C-18).
+   */
+  'getDriverFeeBill' : ActorMethod<[], Result_26>,
+  /**
+   * / Admins (stage 7): the aggregated rating of one driver (sum and count of stars; null =
+   * / no rating yet) — the value the workers get through the outbox (C-6).
+   */
+  'getDriverRating' : ActorMethod<[DriverRatingArgs], Result_21>,
+  'getDriverRollout' : ActorMethod<[], Result_25>,
+  'getFactoryStatus' : ActorMethod<[], Result_24>,
+  /**
+   * / C-22: the rates, the day, the multiplier cached, the totals.
+   */
+  'getFeeStatus' : ActorMethod<[], Result_23>,
   'getLogs' : ActorMethod<[], string>,
   /**
    * / The caller's own canister, or the demo canister the caller holds now.
    */
-  'getMyDriverCanister' : ActorMethod<[], Result_17>,
+  'getMyDriverCanister' : ActorMethod<[], Result_22>,
   '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_16>,
+  'getMyRating' : ActorMethod<[], Result_21>,
+  /**
+   * / C-8 (KU-4, stage 7): one line of the caller's history by its requestId — for the
+   * / details screen after a reload and to show the rating after `rateMyRide`. Another
+   * / rider's ride → `NotAuthorized`; not in the core (yet, K-9) → `NotFound`.
+   */
+  'getMyRide' : ActorMethod<[RequestIdArgs], Result_20>,
   /**
-   * / C-8: the caller's rides, newest first.
+   * / C-8: the caller's rides, newest first, with the places (KU-4) and whether the driver
+   * / can still be rated (KU-5, C-23).
    */
-  'getMyRides' : ActorMethod<[RidesPageArgs], Result_15>,
+  'getMyRides' : ActorMethod<[RidesPageArgs], Result_19>,
   /**
    * / C-3: the names of up to MAX_PROFILES_PER_CALL principals; unknown ones are left out.
    */
-  'getProfiles' : ActorMethod<[ProfilesArgs], Result_14>,
+  'getProfiles' : ActorMethod<[ProfilesArgs], Result_18>,
   /**
    * / F-11: the driver wasms released so far, oldest first.
    */
@@ -333,11 +456,11 @@ export interface TigiCore {
   /**
    * / Admins: the coordinator, the workers confirmed so far, the mode.
    */
-  'getWiring' : ActorMethod<[], Result_13>,
+  'getWiring' : ActorMethod<[], Result_17>,
   /**
    * / Admins: how far the outbox to the workers is (C-6, C-7).
    */
-  'getWorkerOutbox' : ActorMethod<[], Result_12>,
+  'getWorkerOutbox' : ActorMethod<[], Result_16>,
   /**
    * / 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
@@ -349,7 +472,7 @@ 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_11>,
+  'ingestRideBatch' : ActorMethod<[RideBatch], Result_15>,
   /**
    * / 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
@@ -360,18 +483,36 @@ export interface TigiCore {
    * / F-5 … F-7: a demo canister for 15 min (outside prod). A fresh lease comes with a
    * / one-time claim code (F-20, U-45).
    */
-  'leaseDemoDriverCanister' : ActorMethod<[], Result_10>,
-  'listBlocks' : ActorMethod<[PageArgs], Result_9>,
-  'listDriverCanisters' : ActorMethod<[PageArgs], Result_8>,
+  'leaseDemoDriverCanister' : ActorMethod<[], Result_14>,
+  'listBlocks' : ActorMethod<[PageArgs], Result_13>,
+  'listDriverCanisters' : ActorMethod<[PageArgs], Result_12>,
+  /**
+   * / Admins: the accounts, 100 a page at most.
+   */
+  'listDriverFeeAccounts' : ActorMethod<[PageArgs], Result_11>,
   /**
    * / Admins: the driver rooms as the core wants them, 100 a page at most.
    */
-  'listDriverRooms' : ActorMethod<[PageArgs], Result_7>,
+  'listDriverRooms' : ActorMethod<[PageArgs], Result_10>,
   /**
    * / F-20: a fresh claim code for the caller's running demo lease; the old one stops
    * / working.
    */
-  'newClaimCode' : ActorMethod<[], Result_6>,
+  'newClaimCode' : ActorMethod<[], Result_9>,
+  /**
+   * / C-20: the driver canister pays the bill of `day` with the cycles attached to this
+   * / call. The core takes exactly the bill (the rest goes back), or nothing when less is
+   * / attached (`FEE_SHORT`); a day paid already answers `accepted = 0`.
+   */
+  'payDriverFee' : ActorMethod<[FeePayArgs], Result_8>,
+  /**
+   * / C-23 (KU-5, stage 7): the rider rates the driver of a finished ride from the history.
+   * / Only the ride's rider; a completed ride within 24 h of its end (K-8); once per ride
+   * / over both paths — a live rating through the worker and this one count once together
+   * / (the first to reach the core). The driver's aggregate goes to the workers as a
+   * / batch's does (C-6). Counted in the caller's `#account` pool.
+   */
+  'rateMyRide' : ActorMethod<[RateRideArgs], Result_7>,
   'removeAdmin' : ActorMethod<[PrincipalArgs], Result_2>,
   'resumeDriverRollout' : ActorMethod<[], Result_3>,
   /**
@@ -379,18 +520,33 @@ export interface TigiCore {
    * / (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>,
+  'setChatConfig' : ActorMethod<[ChatConfig], Result_6>,
   /**
    * / Admins, localTest only: new claim codes live this long (the local check of an
    * / expired code). Heap only: an upgrade brings back 15 min.
    */
   'setClaimCodeTtl' : ActorMethod<[ClaimTtlArgs], Result>,
+  /**
+   * / Admins: the cycles per event (C-18).
+   */
+  'setFeeRates' : ActorMethod<[FeeRates], Result_5>,
   'setLoggingEnabled' : ActorMethod<[boolean], Result_2>,
   /**
    * / The coordinator only: the balance below which the core asks for cycles.
    */
   'setLowCyclesBelow' : ActorMethod<[bigint], Result_2>,
   'setMyProfile' : ActorMethod<[SetProfileArgs], Result_4>,
+  /**
+   * / F-21 (2026-10-24, route line): admins — the one principal that routes the simulator's
+   * / quotes (S-N13, a Node process like a driver's front); null removes it. The simulator
+   * / takes it from the core only.
+   */
+  'setSimulatorRouter' : ActorMethod<[SimulatorRouterArgs], Result_2>,
+  /**
+   * / Admins, localTest only: the fee's day moves this many days on (the local check of
+   * / "the next day"). Heap only: an upgrade brings back the real day.
+   */
+  'setTestDayOffset' : ActorMethod<[TestDayArgs], Result>,
   /**
    * / Admins: a rollout of the current driver wasm (F-12): the canary, then the rest, one
    * / canister a step, never during a ride (F-13).
@@ -412,6 +568,10 @@ export interface UnblockDriverArgs {
   'canister' : Principal,
 }
 export interface UnblockRiderArgs { 'rider' : Principal }
+export interface UsageBatch {
+  'entries' : Array<DriverUsage>,
+  'batchId' : bigint,
+}
 export interface WasmChunkArgs {
   'kind' : WasmKind,
   'bytes' : Uint8Array | number[],