@econ-v1/domain 7.6.172 → 7.6.174

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -10,6 +10,7 @@ export { LanCandidateRefreshService } from "./services/lan-candidate-refresh-ser
10
10
  export { DeviceBootStateService } from "./services/device-boot-state-service.js";
11
11
  export { OnboardingStatusService } from "./services/onboarding-status-service.js";
12
12
  export { InviteRedemptionService } from "./services/invite-redemption-service.js";
13
+ export { GiftWalletService } from "./services/gift-wallet-service.js";
13
14
  export { WifiProvisioningService } from "./services/wifi-provisioning-service.js";
14
15
  export { DeviceCleanupService } from "./services/device-cleanup-service.js";
15
16
  export { LcdDecisionService } from "./services/lcd-decision-service.js";
@@ -203,10 +204,13 @@ export type OnboardingStatusServiceOptions = import("./services/onboarding-statu
203
204
  export type OnboardingStatusWire = import("./services/onboarding-status-service.js").OnboardingStatusWire;
204
205
  export type InviteRedemptionOutcome = import("./services/invite-redemption-service.js").InviteRedemptionOutcome;
205
206
  export type InviteRedemptionServiceOptions = import("./services/invite-redemption-service.js").InviteRedemptionServiceOptions;
207
+ export type GiftWalletServiceOptions = import("./services/gift-wallet-service.js").GiftWalletServiceOptions;
206
208
  export type OnboardingCheckpoint = import("./services/onboarding-checkpoint-store.js").OnboardingCheckpoint;
207
209
  export type OnboardingCheckpointStoreOptions = import("./services/onboarding-checkpoint-store.js").OnboardingCheckpointStoreOptions;
208
210
  export type OnboardingFlowApprovalState = import("./services/onboarding-flow-service.js").OnboardingFlowApprovalState;
209
211
  export type OnboardingFlowClaimPort = import("./services/onboarding-flow-service.js").OnboardingFlowClaimPort;
212
+ export type OnboardingFlowGiftStatus = import("./services/onboarding-flow-service.js").OnboardingFlowGiftStatus;
213
+ export type OnboardingFlowGiftStep = import("./services/onboarding-flow-service.js").OnboardingFlowGiftStep;
210
214
  export type OnboardingFlowInvitePort = import("./services/onboarding-flow-service.js").OnboardingFlowInvitePort;
211
215
  export type OnboardingFlowLcdPort = import("./services/onboarding-flow-service.js").OnboardingFlowLcdPort;
212
216
  export type OnboardingFlowLcdScreen = import("./services/onboarding-flow-service.js").OnboardingFlowLcdScreen;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ /** The host's invoke budget for each call. The host cuts a capability call at 30 s unless the
2
+ * request names a budget, and `wallet.gift.redeem` is allowed 55 s by its own contract, so the
3
+ * redeem must ask for more. The two reads ask for less than the default on purpose: nobody is
4
+ * helped by a status answer that arrives after the next poll. */
5
+ export const GIFT_CHECK_BUDGET_MS: 8000;
6
+ export const GIFT_REDEEM_BUDGET_MS: 60000;
7
+ export const GIFT_STATUS_BUDGET_MS: 5000;
8
+ /**
9
+ * The node side of the onboarding gift wallet: the wallet app's `wallet.gift.check`,
10
+ * `wallet.gift.redeem` and `wallet.gift.status`, called through the AUTHENTICATED home-node
11
+ * client (the owner exists and this browser holds a device session by the time any of them is
12
+ * asked).
13
+ *
14
+ * Every method resolves. A transport failure, a refusal (`success: false`), a missing
15
+ * capability on an older wallet app, or an answer of an unexpected shape is reported as an
16
+ * outcome: `none` from `check`, `failed` from `redeem`, `unavailable` from `status`. Nothing a
17
+ * node sends is trusted before it is narrowed here, field by field.
18
+ *
19
+ * No timer lives here. The caller owns its own deadlines; this service only tells the host how
20
+ * long each call may run.
21
+ * @implements {GiftWalletPort}
22
+ */
23
+ export class GiftWalletService implements GiftWalletPort {
24
+ /** @param {GiftWalletServiceOptions} options */
25
+ constructor(options: GiftWalletServiceOptions);
26
+ /** @returns {Promise<GiftWalletCheckOutcome>} */
27
+ check(): Promise<GiftWalletCheckOutcome>;
28
+ /** @returns {Promise<GiftWalletRedeemOutcome>} */
29
+ redeem(): Promise<GiftWalletRedeemOutcome>;
30
+ /** @returns {Promise<GiftWalletStatusOutcome>} */
31
+ status(): Promise<GiftWalletStatusOutcome>;
32
+ #private;
33
+ }
34
+ export type GiftWalletCheckOutcome = import("@econ-v1/ports").GiftWalletCheckOutcome;
35
+ export type GiftWalletNoneReason = import("@econ-v1/ports").GiftWalletNoneReason;
36
+ export type GiftWalletPort = import("@econ-v1/ports").GiftWalletPort;
37
+ export type GiftWalletRedeemOutcome = import("@econ-v1/ports").GiftWalletRedeemOutcome;
38
+ export type GiftWalletStatusOutcome = import("@econ-v1/ports").GiftWalletStatusOutcome;
39
+ export type GiftWalletStep = import("@econ-v1/ports").GiftWalletStep;
40
+ export type HomeNodeClient = import("@econ-v1/ports").HomeNodeClient;
41
+ export type GiftWalletServiceOptions = {
42
+ /**
43
+ * The AUTHENTICATED home-node client. Never the pre-pairing client: these capabilities belong to
44
+ * the owner, and the pre-pairing client carries no session.
45
+ */
46
+ node: Pick<HomeNodeClient, "invoke">;
47
+ };
48
+ //# sourceMappingURL=gift-wallet-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gift-wallet-service.d.ts","sourceRoot":"","sources":["../../src/services/gift-wallet-service.js"],"names":[],"mappings":"AAWA;;;iEAGiE;AACjE,mCAAoC,IAAK,CAAC;AAC1C,oCAAqC,KAAM,CAAC;AAC5C,oCAAqC,IAAK,CAAC;AAU3C;;;;;;;;;;;;;;GAcG;AACH,0CAFgB,cAAc;IAK5B,gDAAgD;IAChD,qBADY,wBAAwB,EAGnC;IACD,iDAAiD;IACjD,SADc,OAAO,CAAC,sBAAsB,CAAC,CAiB5C;IACD,kDAAkD;IAClD,UADc,OAAO,CAAC,uBAAuB,CAAC,CAsB7C;IACD,kDAAkD;IAClD,UADc,OAAO,CAAC,uBAAuB,CAAC,CAmB7C;;CAqBF;qCAjIa,OAAO,gBAAgB,EAAE,sBAAsB;mCAC/C,OAAO,gBAAgB,EAAE,oBAAoB;6BAC7C,OAAO,gBAAgB,EAAE,cAAc;sCACvC,OAAO,gBAAgB,EAAE,uBAAuB;sCAChD,OAAO,gBAAgB,EAAE,uBAAuB;6BAChD,OAAO,gBAAgB,EAAE,cAAc;6BACvC,OAAO,gBAAgB,EAAE,cAAc;;;;;;UAsJvC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC"}
@@ -42,6 +42,12 @@ export type OnboardingCheckpoint = {
42
42
  * deadline is discarded on read so a stale run cannot strand a later one mid-flow.
43
43
  */
44
44
  deadline?: string;
45
+ /**
46
+ * The size of the gift wallet the `gift` step is installing, so a reload of that step shows the
47
+ * same amount at once instead of zero until the node answers. An amount, not a credential: the
48
+ * wallet itself never leaves the node.
49
+ */
50
+ giftAmountSats?: number;
45
51
  operationHash?: string;
46
52
  stepId: string;
47
53
  targetSsid?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"onboarding-checkpoint-store.d.ts","sourceRoot":"","sources":["../../src/services/onboarding-checkpoint-store.js"],"names":[],"mappings":"AA8EA;;;GAGG;AACH,6DAFa,+BAA+B,CAe3C;AA9FD,0GAA0G;AAC1G;IASE;;OAEG;IACH,qBAFW,gCAAgC,EAK1C;IACD;;OAEG;IACH,SAFa,IAAI,CAIhB;IACD;;OAEG;IACH,QAFa,oBAAoB,GAAG,SAAS,CA4B5C;IACD;;;OAGG;IACH,kBAHW,oBAAoB,GAClB,IAAI,CAoBhB;;CACF;8CA5Ea,OAAO,gBAAgB,EAAE,+BAA+B;;;;;;;;;;;;;;;;;eA6IxD,MAAM;oBAEN,MAAM;YACN,MAAM;iBACN,MAAM;sBACN,MAAM;;;SAIN,MAAM,MAAM;aACZ,+BAA+B"}
1
+ {"version":3,"file":"onboarding-checkpoint-store.d.ts","sourceRoot":"","sources":["../../src/services/onboarding-checkpoint-store.js"],"names":[],"mappings":"AAiFA;;;GAGG;AACH,6DAFa,+BAA+B,CAe3C;AAjGD,0GAA0G;AAC1G;IASE;;OAEG;IACH,qBAFW,gCAAgC,EAK1C;IACD;;OAEG;IACH,SAFa,IAAI,CAIhB;IACD;;OAEG;IACH,QAFa,oBAAoB,GAAG,SAAS,CA4B5C;IACD;;;OAGG;IACH,kBAHW,oBAAoB,GAClB,IAAI,CAuBhB;;CACF;8CA/Ea,OAAO,gBAAgB,EAAE,+BAA+B;;;;;;;;;;;;;;;;;eA+JxD,MAAM;;;;;;qBAEN,MAAM;oBAGN,MAAM;YACN,MAAM;iBACN,MAAM;sBACN,MAAM;;;SAIN,MAAM,MAAM;aACZ,+BAA+B"}
@@ -1,5 +1,5 @@
1
- /** @type {readonly ["join-qr", "open-browser", "choose-network", "network-password", "handoff", "way-back", "install", "match-code", "invitation", "identity", "trusted"]} */
2
- export const ONBOARDING_FLOW_STEP_IDS: readonly ["join-qr", "open-browser", "choose-network", "network-password", "handoff", "way-back", "install", "match-code", "invitation", "identity", "trusted"];
1
+ /** @type {readonly ["join-qr", "open-browser", "choose-network", "network-password", "handoff", "way-back", "install", "match-code", "invitation", "identity", "gift", "trusted"]} */
2
+ export const ONBOARDING_FLOW_STEP_IDS: readonly ["join-qr", "open-browser", "choose-network", "network-password", "handoff", "way-back", "install", "match-code", "invitation", "identity", "gift", "trusted"];
3
3
  export class OnboardingFlowService {
4
4
  /**
5
5
  * @param {OnboardingFlowServiceOptions} options
@@ -78,6 +78,10 @@ export class OnboardingFlowService {
78
78
  tick(): void;
79
79
  #private;
80
80
  }
81
+ export type GiftWalletPort = import("@econ-v1/ports").GiftWalletPort;
82
+ export type GiftWalletRedeemOutcome = import("@econ-v1/ports").GiftWalletRedeemOutcome;
83
+ export type GiftWalletStatusOutcome = import("@econ-v1/ports").GiftWalletStatusOutcome;
84
+ export type GiftWalletStep = import("@econ-v1/ports").GiftWalletStep;
81
85
  export type OnboardingAccessCodeStore = import("@econ-v1/ports").OnboardingAccessCodeStore;
82
86
  export type OnboardingPresencePhase = import("@econ-v1/ports").OnboardingPresencePhase;
83
87
  export type OnboardingPresencePort = import("@econ-v1/ports").OnboardingPresencePort;
@@ -92,6 +96,20 @@ export type OnboardingFlowStepId = (typeof ONBOARDING_FLOW_STEP_IDS)[number];
92
96
  export type OnboardingFlowPhase = "connect" | "install" | "secure" | "identify" | "ready";
93
97
  export type OnboardingFlowLcdScreenId = "onboard_qr" | "onboard_open_browser" | "onboard_home_qr" | "onboard_wifi_setup" | "onboard_wifi_joined" | "onboard_working" | "onboard_code" | "onboard_trusted" | "onboard_rejected";
94
98
  export type OnboardingFlowWifiSecurity = "open" | "wep" | "wpa2" | "wpa3";
99
+ /**
100
+ * What the gift step's screen says. `arriving` = the transfer is running. `ready` = the wallet
101
+ * is on this node and spendable. `later` = this screen has stopped waiting (imported but not
102
+ * spendable yet, a failed or unanswered redeem, the deadline): the person can continue.
103
+ */
104
+ export type OnboardingFlowGiftStatus = "arriving" | "ready" | "later";
105
+ /**
106
+ * One of the gift step's three rows.
107
+ */
108
+ export type OnboardingFlowGiftStep = {
109
+ id: GiftWalletStep;
110
+ state: "done" | "active" | "retrying" | "pending";
111
+ detail?: string;
112
+ };
95
113
  export type OnboardingFlowApprovalState = "waiting" | "approved" | "rejected" | "expired" | "cancelled";
96
114
  /**
97
115
  * Access-code rail (2026-08-10 design): `code-already-bound`/`access-code-invalid` are the
@@ -124,6 +142,17 @@ export type OnboardingFlowRow = OnboardingFlowRowBase & ({
124
142
  readonly stepId: "identity";
125
143
  readonly submitting: boolean;
126
144
  } | {
145
+ readonly amountSats: number;
146
+ readonly giftErrorCode?: string;
147
+ readonly giftId?: string;
148
+ readonly giftStatus: OnboardingFlowGiftStatus;
149
+ readonly giftSteps: readonly OnboardingFlowGiftStep[];
150
+ readonly nodeName?: string;
151
+ readonly stepId: "gift";
152
+ readonly walletId?: string;
153
+ } | {
154
+ readonly giftSats?: number;
155
+ readonly giftSpendable?: boolean;
127
156
  readonly nodeName?: string;
128
157
  readonly sessionEstablished: boolean;
129
158
  readonly stepId: "trusted";
@@ -131,7 +160,7 @@ export type OnboardingFlowRow = OnboardingFlowRowBase & ({
131
160
  readonly ssid: string;
132
161
  readonly stepId: "handoff";
133
162
  } | {
134
- readonly stepId: Exclude<OnboardingFlowStepId, "choose-network" | "handoff" | "identity" | "invitation" | "match-code" | "network-password" | "trusted">;
163
+ readonly stepId: Exclude<OnboardingFlowStepId, "choose-network" | "gift" | "handoff" | "identity" | "invitation" | "match-code" | "network-password" | "trusted">;
135
164
  });
136
165
  export type OnboardingFlowClaimPort = Pick<OwnerClaimService, "awaitConfirmation" | "cancel" | "completeClaim" | "prepareClaim">;
137
166
  export type OnboardingFlowInvitePort = Pick<InviteRedemptionService, "redeem" | "resume"> & Partial<Pick<InviteRedemptionService, "progress">>;
@@ -180,12 +209,20 @@ export type OnboardingFlowServiceOptions = {
180
209
  checkpoints: Pick<OnboardingCheckpointStore, "clear" | "read" | "write">;
181
210
  claim: OnboardingFlowClaimPort;
182
211
  defaultNodeName?: () => string | undefined;
212
+ /**
213
+ * The node's gift wallet (`wallet.gift.*`), reached through the AUTHENTICATED home-node client.
214
+ * Asked only after a claim that left this browser with a device session. Absent = no gift is
215
+ * ever offered and the flow is unchanged — the right wiring for a composition with no such
216
+ * client (tests, headless).
217
+ */
218
+ gift?: GiftWalletPort;
183
219
  invitationRequired?: () => boolean;
184
220
  invitationsEnabled: () => boolean;
185
221
  invites: OnboardingFlowInvitePort;
186
222
  lcd?: OnboardingFlowLcdPort;
187
223
  /**
188
- * Waits between invitation progress polls; absent = no live progress.
224
+ * Waits between invitation progress polls, and paces the gift step's status poll and its
225
+ * deadlines; absent = no live progress and no gift deadline.
189
226
  */
190
227
  delay?: (ms: number) => Promise<void>;
191
228
  now: () => string;
@@ -194,7 +231,7 @@ export type OnboardingFlowServiceOptions = {
194
231
  wifi: OnboardingFlowWifiPort;
195
232
  };
196
233
  export type OnboardingFlowStep = {
197
- gate?: "invitations";
234
+ gate?: "invitations" | "gift";
198
235
  id: OnboardingFlowStepId;
199
236
  lcdScreenId: OnboardingFlowLcdScreenId;
200
237
  phase: OnboardingFlowPhase;
@@ -1 +1 @@
1
- {"version":3,"file":"onboarding-flow-service.d.ts","sourceRoot":"","sources":["../../src/services/onboarding-flow-service.js"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"onboarding-flow-service.d.ts","sourceRoot":"","sources":["../../src/services/onboarding-flow-service.js"],"names":[],"mappings":"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"}
@@ -63,6 +63,19 @@ export class TransportManager {
63
63
  markReconnecting(attempt: number, nextRetryAt: string): void;
64
64
  /** @param {TransportOfflineReason} [reason] @returns {void} */
65
65
  markOffline(reason?: TransportOfflineReason): void;
66
+ /**
67
+ * Lets an adapter force every offline/reconnecting verdict this manager publishes to
68
+ * carry a specific reason, without patching `markOffline`/`markReconnecting` on this
69
+ * object. While `overrideFn` is set and returns a reason: `markOffline(undefined)` and
70
+ * `markOffline("node-unreachable")` publish that reason instead, `markOffline` with any
71
+ * other explicit reason (e.g. `"session-required"`) passes through unchanged, and
72
+ * `markReconnecting(...)` publishes offline with that reason instead of a reconnecting
73
+ * state. `overrideFn` returning `undefined` (or no override set) leaves both methods
74
+ * unchanged. Pass `undefined` to clear the override.
75
+ * @param {(() => TransportOfflineReason | undefined) | undefined} overrideFn
76
+ * @returns {void}
77
+ */
78
+ setOfflineOverride(overrideFn: (() => TransportOfflineReason | undefined) | undefined): void;
66
79
  /**
67
80
  * Stops everything in flight. This is a global teardown primitive — `close()` and
68
81
  * `disconnect()` on the seam above call it — never a per-caller cancel, so it stays
@@ -1 +1 @@
1
- {"version":3,"file":"transport-manager.d.ts","sourceRoot":"","sources":["../../src/services/transport-manager.js"],"names":[],"mappings":"AAsaA,sFAAsF;AACtF,+CADY,cAAc,QAAkB,cAAc,GAAiB,OAAO,CAqBjF;AA6ED;;;GAGG;AACH,oDAHW,MAAM,GACJ,MAAM,CAoBlB;AAKD,iDAAiD;AACjD,oDADY,UAAU,GAAgB,OAAO,CAW5C;AAzhBD,oYAAoY;AACpY,qKAAqK;AACrK,gGAAgG;AAChG,yFAAyF;AACzF,kKAAkK;AAClK,8GAA8G;AAC9G,wHAAwH;AACxH,wFAAwF;AAExF;IA4CE,+CAA+C;IAC/C,qBADY,uBAAuB,EAWlC;IAED,gCAAgC;IAChC,aADc,cAAc,CAG3B;IAED,qDAAqD;IACrD,yBADc,uBAAuB,GAAG,SAAS,CAKhD;IAED,oFAAoF;IACpF,qBADY,cAAc,GAAmB,uBAAuB,GAAG,SAAS,CAI/E;IAED,4EAA4E;IAC5E,0BADY,OAAO,GAAkB,uBAAuB,GAAG,SAAS,CAIvE;IAED;;;OAGG;IACH,oBAHW,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAC7B,MAAM,IAAI,CAKtB;IAED;;;;;;OAMG;IACH,kBAFa,SAAS,uBAAuB,EAAE,CAI9C;IAED;;;OAGG;IACH,8BAHW,SAAS,uBAAuB,EAAE,GAChC,IAAI,CAIhB;IAED;;;OAGG;IACH,kBAHW,uBAAuB,GACrB,OAAO,CAAC,cAAc,CAAC,CA0BnC;IAED;;;;OAIG;IACH,oBAHW,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,EAAE;QAAC,MAAM,EAAE,WAAW,CAAA;KAAC,CAAC,GACzF,IAAI,CAMhB;IAED,8CAA8C;IAC9C,wBADY,MAAM,GAAoB,IAAI,CAQzC;IAED,0EAA0E;IAC1E,0BADY,MAAM,eAAkB,MAAM,GAAwB,IAAI,CASrE;IAED,+DAA+D;IAC/D,qBADY,sBAAsB,GAAqB,IAAI,CAQ1D;IAED;;;;;;;;;;OAUG;IACH,SAFa,IAAI,CAMhB;;CAkMF;wBAlaa,OAAO,gBAAgB,EAAE,SAAS;sCAClC,OAAO,gBAAgB,EAAE,uBAAuB;kCAChD,OAAO,gBAAgB,EAAE,mBAAmB;6BAC5C,OAAO,gBAAgB,EAAE,cAAc;qCACvC,OAAO,gBAAgB,EAAE,sBAAsB;6BAC/C,OAAO,gBAAgB,EAAE,cAAc;8BACvC,OAAO,mBAAmB,EAAE,eAAe;yBAC3C,OAAO,sBAAsB,EAAE,UAAU;sCAYzC;IAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,uBAAuB,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAA;CAAE;sCAC1V;IAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE;qCAC3H,cAAc,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE;kCACvD;IAAE,KAAK,IAAI,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE;0BACnD;IAAE,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CAAE;wBACpI;IAAE,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;CAAE;0BAClF;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAA;CAAE;0BAC1F;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE"}
1
+ {"version":3,"file":"transport-manager.d.ts","sourceRoot":"","sources":["../../src/services/transport-manager.js"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@econ-v1/domain",
3
- "version": "7.6.172",
3
+ "version": "7.6.174",
4
4
  "description": "Platform-neutral domain contracts and errors for Node clients",
5
5
  "license": "MIT OR Apache-2.0",
6
6
  "author": "Node contributors",
@@ -57,6 +57,6 @@
57
57
  "access": "public"
58
58
  },
59
59
  "dependencies": {
60
- "@econ-v1/ports": "7.6.172"
60
+ "@econ-v1/ports": "7.6.174"
61
61
  }
62
62
  }
package/src/index.js CHANGED
@@ -459,10 +459,13 @@
459
459
  */
460
460
  /** @typedef {import("./services/invite-redemption-service.js").InviteRedemptionOutcome} InviteRedemptionOutcome */
461
461
  /** @typedef {import("./services/invite-redemption-service.js").InviteRedemptionServiceOptions} InviteRedemptionServiceOptions */
462
+ /** @typedef {import("./services/gift-wallet-service.js").GiftWalletServiceOptions} GiftWalletServiceOptions */
462
463
  /** @typedef {import("./services/onboarding-checkpoint-store.js").OnboardingCheckpoint} OnboardingCheckpoint */
463
464
  /** @typedef {import("./services/onboarding-checkpoint-store.js").OnboardingCheckpointStoreOptions} OnboardingCheckpointStoreOptions */
464
465
  /** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowApprovalState} OnboardingFlowApprovalState */
465
466
  /** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowClaimPort} OnboardingFlowClaimPort */
467
+ /** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowGiftStatus} OnboardingFlowGiftStatus */
468
+ /** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowGiftStep} OnboardingFlowGiftStep */
466
469
  /** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowInvitePort} OnboardingFlowInvitePort */
467
470
  /** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowLcdPort} OnboardingFlowLcdPort */
468
471
  /** @typedef {import("./services/onboarding-flow-service.js").OnboardingFlowLcdScreen} OnboardingFlowLcdScreen */
@@ -550,6 +553,7 @@ export { createDiscoveryCandidatesQuery, DISCOVERY_CANDIDATES_QUERY } from "./qu
550
553
  export { OnboardingStatusService } from "./services/onboarding-status-service.js";
551
554
  export { createOnboardingStatusQuery, ONBOARDING_STATUS_QUERY } from "./queries/onboarding-status.js";
552
555
  export { InviteRedemptionService } from "./services/invite-redemption-service.js";
556
+ export { GiftWalletService } from "./services/gift-wallet-service.js";
553
557
  export { createInMemoryOnboardingCheckpointStorage, OnboardingCheckpointStore } from "./services/onboarding-checkpoint-store.js";
554
558
  export { ONBOARDING_FLOW_STEP_IDS, OnboardingFlowService } from "./services/onboarding-flow-service.js";
555
559
  export { createOnboardingFlowQuery, ONBOARDING_FLOW_QUERY_NAME } from "./queries/onboarding-flow.js";
@@ -0,0 +1,160 @@
1
+ // @ts-check
2
+ /** @typedef {import('@econ-v1/ports').GiftWalletCheckOutcome} GiftWalletCheckOutcome */
3
+ /** @typedef {import('@econ-v1/ports').GiftWalletNoneReason} GiftWalletNoneReason */
4
+ /** @typedef {import('@econ-v1/ports').GiftWalletPort} GiftWalletPort */
5
+ /** @typedef {import('@econ-v1/ports').GiftWalletRedeemOutcome} GiftWalletRedeemOutcome */
6
+ /** @typedef {import('@econ-v1/ports').GiftWalletStatusOutcome} GiftWalletStatusOutcome */
7
+ /** @typedef {import('@econ-v1/ports').GiftWalletStep} GiftWalletStep */
8
+ /** @typedef {import('@econ-v1/ports').HomeNodeClient} HomeNodeClient */
9
+ import { CAPABILITY_INVOKE_OPERATION } from "@econ-v1/ports";
10
+
11
+ const CALLER = "kernel:gift-wallet-service";
12
+ /** The host's invoke budget for each call. The host cuts a capability call at 30 s unless the
13
+ * request names a budget, and `wallet.gift.redeem` is allowed 55 s by its own contract, so the
14
+ * redeem must ask for more. The two reads ask for less than the default on purpose: nobody is
15
+ * helped by a status answer that arrives after the next poll. */
16
+ export const GIFT_CHECK_BUDGET_MS = 8_000;
17
+ export const GIFT_REDEEM_BUDGET_MS = 60_000;
18
+ export const GIFT_STATUS_BUDGET_MS = 5_000;
19
+ /** @type {readonly GiftWalletNoneReason[]} */
20
+ const NODE_NONE_REASONS = ["not_configured", "unreachable", "none", "already_claimed"];
21
+ /** @type {readonly GiftWalletStep[]} */
22
+ const STEPS = ["reserved", "moving", "spendable"];
23
+ const STATUS_VALUES = /** @type {const} */ (["none", "available", "redeeming", "installed", "ready", "failed"]);
24
+ /** Ids and codes end up behind the gift screen's "Show details". They are the node's words,
25
+ * so they are accepted only as short machine tokens — never free text. */
26
+ const TOKEN = /^[A-Za-z0-9_.:-]{1,96}$/u;
27
+
28
+ /**
29
+ * The node side of the onboarding gift wallet: the wallet app's `wallet.gift.check`,
30
+ * `wallet.gift.redeem` and `wallet.gift.status`, called through the AUTHENTICATED home-node
31
+ * client (the owner exists and this browser holds a device session by the time any of them is
32
+ * asked).
33
+ *
34
+ * Every method resolves. A transport failure, a refusal (`success: false`), a missing
35
+ * capability on an older wallet app, or an answer of an unexpected shape is reported as an
36
+ * outcome: `none` from `check`, `failed` from `redeem`, `unavailable` from `status`. Nothing a
37
+ * node sends is trusted before it is narrowed here, field by field.
38
+ *
39
+ * No timer lives here. The caller owns its own deadlines; this service only tells the host how
40
+ * long each call may run.
41
+ * @implements {GiftWalletPort}
42
+ */
43
+ export class GiftWalletService {
44
+ /** @readonly @type {Pick<HomeNodeClient, "invoke">} */
45
+ #node;
46
+ /** @param {GiftWalletServiceOptions} options */
47
+ constructor(options) {
48
+ this.#node = options.node;
49
+ }
50
+ /** @returns {Promise<GiftWalletCheckOutcome>} */
51
+ async check() {
52
+ const wire = await this.#invoke("wallet.gift.check", GIFT_CHECK_BUDGET_MS);
53
+ if (wire === undefined) return { reason: "unavailable", status: "none" };
54
+ const amountSats = readAmount(wire.amount_sats);
55
+ if (wire.status === "available") {
56
+ const giftId = readToken(wire.gift_id);
57
+ if (amountSats === undefined || giftId === undefined) return { reason: "unavailable", status: "none" };
58
+ return { amountSats, giftId, status: "available" };
59
+ }
60
+ if (wire.status === "installed") {
61
+ const walletId = readToken(wire.wallet_id);
62
+ if (amountSats === undefined || walletId === undefined) return { reason: "unavailable", status: "none" };
63
+ return { amountSats, spendable: wire.spendable === true, status: "installed", walletId };
64
+ }
65
+ if (wire.status === "none") return { reason: readNoneReason(wire.reason), status: "none" };
66
+ return { reason: "unavailable", status: "none" };
67
+ }
68
+ /** @returns {Promise<GiftWalletRedeemOutcome>} */
69
+ async redeem() {
70
+ const wire = await this.#invoke("wallet.gift.redeem", GIFT_REDEEM_BUDGET_MS);
71
+ if (wire === undefined) return { errorCode: "call_failed", status: "failed" };
72
+ const amountSats = readAmount(wire.amount_sats);
73
+ const walletId = readToken(wire.wallet_id);
74
+ if (wire.status === "ready" || wire.status === "installed") {
75
+ if (amountSats === undefined || walletId === undefined) return { errorCode: "unexpected_response", status: "failed" };
76
+ // `installed` with `spendable: true` is not something the node is specified to send; the
77
+ // word it sent is what is reported, so "ready" is only ever the node's own claim.
78
+ return { amountSats, status: wire.status, walletId };
79
+ }
80
+ if (wire.status === "failed") {
81
+ return {
82
+ ...(amountSats === undefined ? {} : { amountSats }),
83
+ errorCode: readToken(wire.error_code) ?? "unknown",
84
+ status: "failed",
85
+ ...(wire.step === "reserved" || wire.step === "moving" ? { step: wire.step } : {}),
86
+ };
87
+ }
88
+ if (wire.status === "none") return { reason: readNoneReason(wire.reason), status: "none" };
89
+ return { errorCode: "unexpected_response", status: "failed" };
90
+ }
91
+ /** @returns {Promise<GiftWalletStatusOutcome>} */
92
+ async status() {
93
+ const wire = await this.#invoke("wallet.gift.status", GIFT_STATUS_BUDGET_MS);
94
+ if (wire === undefined) return { status: "unavailable" };
95
+ const status = STATUS_VALUES.find((value) => value === wire.status);
96
+ if (status === undefined) return { status: "unavailable" };
97
+ const amountSats = readAmount(wire.amount_sats);
98
+ const walletId = readToken(wire.wallet_id);
99
+ const giftId = readToken(wire.gift_id);
100
+ const errorCode = readToken(wire.error_code);
101
+ const step = STEPS.find((value) => value === wire.step);
102
+ return {
103
+ ...(amountSats === undefined ? {} : { amountSats }),
104
+ ...(errorCode === undefined ? {} : { errorCode }),
105
+ ...(giftId === undefined ? {} : { giftId }),
106
+ status,
107
+ ...(step === undefined ? {} : { step }),
108
+ ...(walletId === undefined ? {} : { walletId }),
109
+ };
110
+ }
111
+ /**
112
+ * One capability call. `undefined` for anything that is not a JSON object answer.
113
+ * @param {"wallet.gift.check" | "wallet.gift.redeem" | "wallet.gift.status"} capability
114
+ * @param {number} budgetMs
115
+ * @returns {Promise<Record<string, unknown> | undefined>}
116
+ */
117
+ async #invoke(capability, budgetMs) {
118
+ try {
119
+ /** @type {unknown} */
120
+ const result = await this.#node.invoke({
121
+ caller: CALLER,
122
+ operation: CAPABILITY_INVOKE_OPERATION,
123
+ payload: { capability, payload: {}, timeout_ms: budgetMs },
124
+ });
125
+ if (result === null || typeof result !== "object" || Array.isArray(result)) return undefined;
126
+ return /** @type {Record<string, unknown>} */ (result);
127
+ } catch {
128
+ return undefined;
129
+ }
130
+ }
131
+ }
132
+ /**
133
+ * Whole sats, never negative. A fractional or absurd amount is a shape this client does not
134
+ * understand, not a number to round.
135
+ * @param {unknown} value
136
+ * @returns {number | undefined}
137
+ */
138
+ function readAmount(value) {
139
+ return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
140
+ }
141
+ /**
142
+ * @param {unknown} value
143
+ * @returns {string | undefined}
144
+ */
145
+ function readToken(value) {
146
+ return typeof value === "string" && TOKEN.test(value) ? value : undefined;
147
+ }
148
+ /**
149
+ * An unknown reason is still the node saying "no gift": it keeps the node's `none`.
150
+ * @param {unknown} value
151
+ * @returns {GiftWalletNoneReason}
152
+ */
153
+ function readNoneReason(value) {
154
+ return NODE_NONE_REASONS.find((reason) => reason === value) ?? "none";
155
+ }
156
+ /**
157
+ * @typedef {object} GiftWalletServiceOptions
158
+ * @property {Pick<HomeNodeClient, "invoke">} node The AUTHENTICATED home-node client. Never the pre-pairing client: these capabilities belong to
159
+ * the owner, and the pre-pairing client carries no session.
160
+ */
@@ -63,6 +63,9 @@ export class OnboardingCheckpointStore {
63
63
  ...(checkpoint.deadline === undefined
64
64
  ? {}
65
65
  : { deadline: checkpoint.deadline }),
66
+ ...(checkpoint.giftAmountSats === undefined
67
+ ? {}
68
+ : { giftAmountSats: checkpoint.giftAmountSats }),
66
69
  ...(checkpoint.operationHash === undefined
67
70
  ? {}
68
71
  : { operationHash: checkpoint.operationHash }),
@@ -105,12 +108,16 @@ function toCheckpoint(value) {
105
108
  if (typeof record.stepId !== "string" || record.stepId.length === 0)
106
109
  return undefined;
107
110
  if (!isOptionalString(record.deadline)) return undefined;
111
+ if (!isOptionalAmount(record.giftAmountSats)) return undefined;
108
112
  if (!isOptionalString(record.operationHash)) return undefined;
109
113
  if (!isOptionalString(record.targetSsid)) return undefined;
110
114
  if (!isOptionalString(record.wifiOperationId)) return undefined;
111
115
  return {
112
116
  stepId: record.stepId,
113
117
  ...(record.deadline === undefined ? {} : { deadline: record.deadline }),
118
+ ...(record.giftAmountSats === undefined
119
+ ? {}
120
+ : { giftAmountSats: record.giftAmountSats }),
114
121
  ...(record.operationHash === undefined
115
122
  ? {}
116
123
  : { operationHash: record.operationHash }),
@@ -129,6 +136,17 @@ function toCheckpoint(value) {
129
136
  function isOptionalString(value) {
130
137
  return value === undefined || typeof value === "string";
131
138
  }
139
+ /**
140
+ * Whole, non-negative sats — the only number the checkpoint carries.
141
+ * @param {unknown} value
142
+ * @returns {value is number | undefined}
143
+ */
144
+ function isOptionalAmount(value) {
145
+ return (
146
+ value === undefined ||
147
+ (typeof value === "number" && Number.isSafeInteger(value) && value >= 0)
148
+ );
149
+ }
132
150
  /**
133
151
  * The onboarding flow's resume point (design §6.3).
134
152
  *
@@ -142,6 +160,9 @@ function isOptionalString(value) {
142
160
  * @typedef {object} OnboardingCheckpoint
143
161
  * @property {string} [deadline] ISO instant after which the in-flight operation is dead. A checkpoint past its own
144
162
  * deadline is discarded on read so a stale run cannot strand a later one mid-flow.
163
+ * @property {number} [giftAmountSats] The size of the gift wallet the `gift` step is installing, so a reload of that step shows the
164
+ * same amount at once instead of zero until the node answers. An amount, not a credential: the
165
+ * wallet itself never leaves the node.
145
166
  * @property {string} [operationHash]
146
167
  * @property {string} stepId
147
168
  * @property {string} [targetSsid]