@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 +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/services/gift-wallet-service.d.ts +48 -0
- package/dist/services/gift-wallet-service.d.ts.map +1 -0
- package/dist/services/onboarding-checkpoint-store.d.ts +6 -0
- package/dist/services/onboarding-checkpoint-store.d.ts.map +1 -1
- package/dist/services/onboarding-flow-service.d.ts +42 -5
- package/dist/services/onboarding-flow-service.d.ts.map +1 -1
- package/dist/services/transport-manager.d.ts +13 -0
- package/dist/services/transport-manager.d.ts.map +1 -1
- package/package.json +2 -2
- package/src/index.js +4 -0
- package/src/services/gift-wallet-service.js +160 -0
- package/src/services/onboarding-checkpoint-store.js +21 -0
- package/src/services/onboarding-flow-service.js +525 -4
- package/src/services/transport-manager.js +38 -0
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;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"
|
|
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":"
|
|
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
|
|
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":"
|
|
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":"
|
|
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.
|
|
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.
|
|
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]
|