@fingerly/svelte 0.1.0 → 0.1.1

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/README.md CHANGED
@@ -4,7 +4,7 @@ Svelte bindings for the Fingerly SDK. One state per app, held in Svelte's
4
4
  context, read as plain reactive properties.
5
5
 
6
6
  Requires Svelte **5**. The state is built with runes, which is what lets a
7
- component read `fingerly.verdicts` and re-render with no store, no subscription
7
+ component read `fingerly.suspectLevel` and re-render with no store, no subscription
8
8
  and no `$` prefix at the call site.
9
9
 
10
10
  ```
@@ -18,21 +18,47 @@ pnpm add @fingerly/svelte
18
18
  <script lang="ts">
19
19
  import { setupFingerly } from '@fingerly/svelte'
20
20
 
21
+ let { children } = $props()
22
+
21
23
  // consent: 'granted' only once you have consent (or another lawful basis)
22
- setupFingerly({ apiKey: 'fly_pk_production_…', consent: 'granted' })
24
+ setupFingerly({ apiKey: 'fly_pk_production_…', endpoints: '/k7x2qm4a', consent: 'granted' })
23
25
  </script>
24
26
 
25
- <slot />
27
+ {@render children()}
26
28
  ```
27
29
 
28
- The key is a **public** SDK key from the dashboard, and it belongs in the page —
30
+ `endpoints` is the path of your first-party proxy, the one the dashboard
31
+ issued. With `@fingerly/node` it is a SvelteKit endpoint at that path:
32
+
33
+ ```js
34
+ // src/routes/k7x2qm4a/+server.js
35
+ import { Fingerly } from '@fingerly/node'
36
+
37
+ // Built on the first request rather than at import: the build imports this
38
+ // module, and the proxy key is a runtime secret.
39
+ let proxy
40
+ const addresses = new WeakMap()
41
+
42
+ export function POST(event) {
43
+ proxy ??= Fingerly.createProxy({
44
+ proxyKey: process.env.FINGERLY_PROXY_KEY,
45
+ clientIp: (request) => addresses.get(request) ?? '',
46
+ })
47
+ // The connection's peer address, which adapter-node takes from its
48
+ // ADDRESS_HEADER setting when the app runs behind a trusted proxy.
49
+ addresses.set(event.request, event.getClientAddress())
50
+ return proxy(event.request)
51
+ }
52
+ ```
53
+
54
+ The key is a **public** SDK key from the dashboard, and it belongs in the page:
29
55
  it is scoped to the origins you list, which is what makes it safe there. A
30
56
  **secret** key is refused if it arrives with an `Origin`, so pasting one here
31
57
  does not work by design.
32
58
 
33
59
  Setting up collects nothing. It makes the client reachable and no more; when to
34
60
  identify is the page's decision. Like every Svelte context call it has to run
35
- during component initialisation — a `<script>` block, not an event handler and
61
+ during component initialisation: a `<script>` block, not an event handler and
36
62
  not an `$effect`.
37
63
 
38
64
  Consent defaults to `pending`, and nothing is collected or sent until it is
@@ -64,10 +90,10 @@ Consent defaults to `pending`, and nothing is collected or sent until it is
64
90
  {#if fingerly.error}<p>{fingerly.error.message}</p>{/if}
65
91
  ```
66
92
 
67
- `identify()` collects, scores locally, and submits. It resolves as soon as the
68
- server has a receipt — IP geolocation and the velocity windows are computed
69
- after the response, so what comes back is a `requestId` rather than a finished
70
- event.
93
+ `identify()` collects and submits, and resolves with the server's answer in the
94
+ same round trip: the `requestId`, who the visitor is (`visitorId`), and the
95
+ `suspectScore` and `suspectLevel`, unless the key hides them. Nothing is decided
96
+ in the page: scoring lives on the server, under the weights you set.
71
97
 
72
98
  ### On mount instead
73
99
 
@@ -77,7 +103,7 @@ event.
77
103
  </script>
78
104
  ```
79
105
 
80
- `immediate` runs in an `$effect`, which is what makes it **safe under SSR** —
106
+ `immediate` runs in an `$effect`, which is what makes it **safe under SSR**:
81
107
  effects do not run during a server render, so a SvelteKit page using this
82
108
  renders on the server and collects on the client with no guard of its own.
83
109
 
@@ -92,7 +118,7 @@ asking whether the visitor is suspicious produce **one** submission, one
92
118
  `requestId`, and one line on your bill:
93
119
 
94
120
  ```svelte
95
- <!-- Header.svelte, CheckoutForm.svelte, RiskBanner.svelte — all three: -->
121
+ <!-- All three of Header.svelte, CheckoutForm.svelte, RiskBanner.svelte: -->
96
122
  const fingerly = useIdentify({ immediate: true })
97
123
  <!-- → one network request, one shared answer -->
98
124
  ```
@@ -101,48 +127,22 @@ Context rather than a module-level singleton, and the reason is the server: a
101
127
  module-level state on a SvelteKit server is shared by every request the process
102
128
  renders. Context is per component tree, and a component tree is per request.
103
129
 
104
- To deliberately identify again — a long-lived app reaching a second checkout:
130
+ To deliberately identify again (a long-lived app reaching a second checkout):
105
131
 
106
132
  ```svelte
107
133
  await fingerly.refresh() // ignores the cached result and collects afresh
108
134
  ```
109
135
 
110
- ## A single verdict
111
-
112
- ```svelte
113
- <script lang="ts">
114
- import { useVerdict } from '@fingerly/svelte'
136
+ ## Reading the answer
115
137
 
116
- const automation = useVerdict('automation')
117
- </script>
118
-
119
- {#if automation.matched}
120
- <aside>
121
- Automated access suspected ({automation.confidence})
122
- <ul>{#each automation.reasons as reason (reason)}<li>{reason}</li>{/each}</ul>
123
- </aside>
124
- {/if}
125
- ```
138
+ `suspectLevel` is the server's band for this submission, under the weights you
139
+ set. `isSuspicious` is `true` for `medium` or `high`, `false` for `low`, and
140
+ `null` when the level is absent: no server has answered yet, the submission went
141
+ unscored, or the SDK key hides the score from the page, which cannot tell those
142
+ apart. Null is not a clean result.
126
143
 
127
- Names: `incognito` · `tor` · `emulator` · `automation` · `farm`.
128
-
129
- `matched` requires **medium confidence or better** by default. A
130
- `low`-confidence verdict is a single weak tell — one removable flag, or one
131
- countermeasure a privacy-conscious real user might equally be running — and
132
- acting on it would generate false positives. Raise or lower it explicitly:
133
-
134
- ```ts
135
- const tor = useVerdict('tor', { min: 'high' }) // block only when certain
136
- const tor = useVerdict('tor', { min: 'low' }) // observe everything
137
- ```
138
-
139
- Both arguments accept a getter as well as a value, because this is called once
140
- when the component initialises and its arguments may be props that change after
141
- that:
142
-
143
- ```svelte
144
- const verdict = useVerdict(() => name, { min: () => threshold })
145
- ```
144
+ Signals are read on your backend, by `requestId`, never in the page: which check
145
+ tripped is what a fraudster wants to learn.
146
146
 
147
147
  ## A correlation tag
148
148
 
@@ -156,16 +156,16 @@ const fingerly = useIdentify({ tag: () => `checkout:${page.params.orderId}` })
156
156
 
157
157
  ## Collect without submitting
158
158
 
159
- For a page that wants the local verdicts and nothing else:
159
+ For a debug page that wants the raw report and nothing else:
160
160
 
161
161
  ```ts
162
162
  setupFingerly({ apiKey: 'fly_pk_production_…', submit: false })
163
163
  ```
164
164
 
165
165
  Everything the server decides comes back empty: no `requestId`, no `visitorId`,
166
- and `suspectScore` is `null` rather than `0`. That is the honest answer rather
167
- than a gap — nothing was sent, so nobody scored it, and a `0` would read as
168
- "scored, found nothing".
166
+ `suspectScore` is `null` rather than `0`, and `isSuspicious` is
167
+ `null` rather than `false`. That is the honest answer rather than a gap: nothing
168
+ was sent, so nobody scored it, and this SDK decides nothing on its own.
169
169
 
170
170
  ## Waiting for consent
171
171
 
@@ -202,24 +202,22 @@ running stops it before it submits, and it fails with a `ConsentError`.
202
202
  ```ts
203
203
  const fingerly = useIdentify()
204
204
 
205
- fingerly.requestId // string | null — identifies this submission
206
- fingerly.visitorId // string | null — who the server decided this is
207
- fingerly.visitorIsNew // boolean — never seen before
208
- fingerly.visitorConfidence // number — 0 to 100
209
- fingerly.identifiable // boolean — false when the signals were too thin
210
- fingerly.duplicate // boolean — answered before; this is the first answer
211
- fingerly.state // string | null — the server's disposition
212
- fingerly.reason // string | null — why, when state needs explaining
213
- fingerly.suspectScore // number | null — null when nothing scored it
214
- fingerly.suspectLevel // string | null — low, medium, high
215
- fingerly.triggers // IdentifyTrigger[] — what the server scored on
216
- fingerly.verdicts // Verdicts | null — the five local verdicts
217
- fingerly.report // SignalReport | null — every source, with status and timing
205
+ fingerly.requestId // string | null: identifies this submission
206
+ fingerly.visitorId // string | null: who the server decided this is
207
+ fingerly.visitorIsNew // boolean: never seen before
208
+ fingerly.visitorConfidence // number: 0 to 100
209
+ fingerly.identifiable // boolean: false when the signals were too thin
210
+ fingerly.duplicate // boolean: answered before; this is the first answer
211
+ fingerly.state // string | null: the server's disposition
212
+ fingerly.reason // string | null: always null (deprecated); your backend reads it on the event
213
+ fingerly.suspectScore // number | null: null when nothing scored it
214
+ fingerly.suspectLevel // string | null: low, medium, high
215
+ fingerly.report // SignalReport | null: every source, with status and timing
218
216
  fingerly.error // Error | null
219
217
  fingerly.consent // ConsentState (granted, pending or denied)
220
218
  fingerly.isLoading // boolean
221
- fingerly.isReady // boolean — finished, successfully or not
222
- fingerly.isSuspicious // boolean — any verdict at medium+
219
+ fingerly.isReady // boolean: finished, successfully or not
220
+ fingerly.isSuspicious // boolean | null: true for medium or high; null when the level is absent
223
221
  fingerly.identify() // Promise<IdentifyResult>
224
222
  fingerly.refresh() // Promise<IdentifyResult>
225
223
  fingerly.setConsent('granted')
@@ -230,21 +228,19 @@ it and reading one in an event handler gets the current value. None of them is
230
228
  settable: the state is shared, so a component that could assign to it would be
231
229
  changing what every other component sees.
232
230
 
233
- A verdict is `{ value, confidence, reasons }` — `reasons` is ordered strongest
234
- first, and exists because a boolean that cannot say why it is true is not
235
- something you can defend to a customer whose user you blocked.
231
+ Weights and signal names never reach the browser: your backend reads them on the
232
+ server-side event read.
236
233
 
237
- These verdicts are **advisory**. The same detectors run again server-side over
238
- the stored report, where the rules improve without every integration
239
- redeploying. Treat the client's answer as a hint for the UI and the server's as
240
- the decision.
234
+ The detectors run on the server, over the report this package sends, so rules
235
+ improve without every integration redeploying. Everything here that says
236
+ anything about a visitor came from the server.
241
237
 
242
238
  ## The visitor is never asked for anything
243
239
 
244
240
  No permission prompt, no picker, no dialog, on any browser. Reading a
245
241
  permission's *state* prompts nobody and is used freely; requesting is banned
246
242
  outright and enforced by a test in `@fingerly/web-js`. The one API that prompts on
247
- some browsers — canvas readback, which raises a doorhanger in Tor Browser — is
243
+ some browsers (canvas readback, which raises a doorhanger in Tor Browser) is
248
244
  skipped when the SDK measures a clamped clock.
249
245
 
250
246
  You can drop this into a checkout without it ever interrupting the checkout.
@@ -265,12 +261,18 @@ try {
265
261
  {#if fingerly.error}<p>{fingerly.error.message}</p>{/if}
266
262
  ```
267
263
 
268
- A failed identification is forgotten rather than remembered, so the next call
269
- tries again instead of being handed the same rejection.
264
+ A failed identification is not repeated behind your back. When the server
265
+ answers `429` with `Retry-After`, every call, `refresh()` included, gets the
266
+ same error until that time has passed; the error carries it as
267
+ `retryAfterMs`. After a transient failure without one (a `5xx`, a network
268
+ error), components that identify automatically wait 5 seconds, doubling per
269
+ consecutive failure up to a minute, so route changes during an outage send
270
+ nothing; a call you make yourself, such as on a click, still tries at once.
271
+ Any other failure, such as a wrong key, is tried again on the next call.
270
272
 
271
273
  `TransportError` carries a `status`. The two worth branching on are `401` (the
272
274
  key is wrong, or was used from an origin it does not list) and `402` (the
273
- organisation is not accepting traffic) — both are your configuration rather than
275
+ organisation is not accepting traffic). Both are your configuration rather than
274
276
  the visitor's.
275
277
 
276
278
  `ConsentError` means consent is not `granted`. It carries `code:
@@ -284,20 +286,19 @@ the client.
284
286
 
285
287
  ## Running the playground
286
288
 
287
- `playground/` is this package's own state and hooks driving the real SDK — no
288
- mocks — with a `useVerdict()` card per verdict, all sharing one identification.
289
+ `playground/` is this package's own state and hooks driving the real SDK (no
290
+ mocks), showing `suspectScore` and `suspectLevel` beside the raw
291
+ report, all sharing one identification. It uses `submit: false`, so no server
292
+ answers: the raw report fills in, and the score and level read hidden.
289
293
 
290
294
  ```
291
295
  pnpm --filter @fingerly/svelte playground # http://localhost:4176
292
296
  ```
293
297
 
294
- Open it twice — an ordinary window and a private one — and watch the incognito
295
- card change. That pair is the only real test that verdict gets.
296
-
297
298
  ## A note on the build
298
299
 
299
300
  The package is emitted by `tsc`, not bundled, and that is a requirement rather
300
301
  than a preference. The runes in `*.svelte.js` are compiled by the *app's*
301
- Svelte plugin, which decides what to compile by the file name — bundling them
302
+ Svelte plugin, which decides what to compile by the file name. Bundling them
302
303
  into an `index.js` would hand the app a file full of `$state(…)` that nothing
303
304
  compiles, and `$state is not defined` at runtime.
package/dist/context.d.ts CHANGED
@@ -40,4 +40,3 @@ export declare function setupFingerly(options: FingerlyOptions): Fingerly;
40
40
  * write, and the fix - one call in a layout - is not guessable from that.
41
41
  */
42
42
  export declare function useFingerly(): Fingerly;
43
- //# sourceMappingURL=context.d.ts.map
package/dist/context.js CHANGED
@@ -54,4 +54,3 @@ export function useFingerly() {
54
54
  }
55
55
  return getContext(FINGERLY_KEY);
56
56
  }
57
- //# sourceMappingURL=context.js.map
@@ -1,16 +1,14 @@
1
1
  /**
2
- * The two things a component asks for: the identification, and one verdict.
2
+ * What a component asks for: the identification.
3
3
  *
4
- * Named `useIdentify` and `useVerdict` to match the Vue, React and Next
4
+ * Named `useIdentify` to match the Vue, React and Next
5
5
  * bindings rather than to follow any Svelte convention. An SDK whose four
6
6
  * bindings answer the same question under four different names makes its own
7
7
  * documentation harder to read than the code it documents. What is Svelte's
8
8
  * here is the *shape*: reactive objects read as plain properties, no refs, no
9
9
  * `$` prefix, no subscription.
10
10
  */
11
- import type { Confidence, Verdict, Verdicts } from '@fingerly/web-js';
12
11
  import type { Fingerly } from './state.svelte.js';
13
- export type VerdictName = keyof Verdicts;
14
12
  export interface UseIdentifyOptions {
15
13
  /**
16
14
  * Identify as soon as the component mounts.
@@ -50,37 +48,7 @@ export interface UseIdentifyOptions {
50
48
  * {/if}
51
49
  * ```
52
50
  *
53
- * Returns the same object `setupFingerly()` created, so `fingerly.verdicts` in a
54
- * template re-renders when the answer arrives.
51
+ * Returns the same object `setupFingerly()` created, so `fingerly.suspectLevel`
52
+ * in a template re-renders when the answer arrives.
55
53
  */
56
54
  export declare function useIdentify(options?: UseIdentifyOptions): Fingerly;
57
- export interface UseVerdictReturn {
58
- /** True only when the verdict fired *and* met the confidence floor. */
59
- readonly matched: boolean;
60
- /** The verdict itself, or null before the first identification. */
61
- readonly verdict: Verdict | null;
62
- readonly confidence: Confidence | null;
63
- /** Why, strongest first. Empty before identification, never null. */
64
- readonly reasons: readonly string[];
65
- }
66
- /**
67
- * Watch one verdict.
68
- *
69
- * ```svelte
70
- * <script lang="ts">
71
- * const incognito = useVerdict('incognito')
72
- * </script>
73
- *
74
- * {#if incognito.matched}Private window ({incognito.confidence}){/if}
75
- * ```
76
- *
77
- * `min` defaults to `medium`. A `low`-confidence verdict is a single weak tell
78
- * - one removable flag, or one countermeasure a privacy-conscious real user
79
- * might equally be running - and defaulting to acting on it would make this a
80
- * false-positive generator. Pass `min: 'low'` deliberately if the intent is to
81
- * observe rather than to block.
82
- */
83
- export declare function useVerdict(name: VerdictName | (() => VerdictName), options?: {
84
- min?: Confidence | (() => Confidence);
85
- }): UseVerdictReturn;
86
- //# sourceMappingURL=hooks.svelte.d.ts.map
@@ -1,7 +1,7 @@
1
1
  /**
2
- * The two things a component asks for: the identification, and one verdict.
2
+ * What a component asks for: the identification.
3
3
  *
4
- * Named `useIdentify` and `useVerdict` to match the Vue, React and Next
4
+ * Named `useIdentify` to match the Vue, React and Next
5
5
  * bindings rather than to follow any Svelte convention. An SDK whose four
6
6
  * bindings answer the same question under four different names makes its own
7
7
  * documentation harder to read than the code it documents. What is Svelte's
@@ -23,8 +23,8 @@ import { useFingerly } from './context.js';
23
23
  * {/if}
24
24
  * ```
25
25
  *
26
- * Returns the same object `setupFingerly()` created, so `fingerly.verdicts` in a
27
- * template re-renders when the answer arrives.
26
+ * Returns the same object `setupFingerly()` created, so `fingerly.suspectLevel`
27
+ * in a template re-renders when the answer arrives.
28
28
  */
29
29
  export function useIdentify(options = {}) {
30
30
  const fingerly = useFingerly();
@@ -52,7 +52,10 @@ export function useIdentify(options = {}) {
52
52
  // one: the failure is already in `fingerly.error`, which is where a
53
53
  // component that opted into `immediate` will look for it. A caller who
54
54
  // wants to await the outcome calls identify() themselves.
55
- void identify().catch(() => undefined);
55
+ // Marked automatic, so a failure's hold applies: a remount while the
56
+ // API is refusing must not send another identification.
57
+ const tag = resolveTag();
58
+ void fingerly.identify({ ...(tag === undefined ? {} : { tag }), automatic: true }).catch(() => undefined);
56
59
  });
57
60
  }
58
61
  return {
@@ -86,12 +89,6 @@ export function useIdentify(options = {}) {
86
89
  get suspectLevel() {
87
90
  return fingerly.suspectLevel;
88
91
  },
89
- get triggers() {
90
- return fingerly.triggers;
91
- },
92
- get verdicts() {
93
- return fingerly.verdicts;
94
- },
95
92
  get report() {
96
93
  return fingerly.report;
97
94
  },
@@ -116,49 +113,3 @@ export function useIdentify(options = {}) {
116
113
  client: fingerly.client,
117
114
  };
118
115
  }
119
- const RANK = { low: 0, medium: 1, high: 2 };
120
- /** One array for every un-identified verdict, rather than one per read. */
121
- const NO_REASONS = Object.freeze([]);
122
- /**
123
- * Watch one verdict.
124
- *
125
- * ```svelte
126
- * <script lang="ts">
127
- * const incognito = useVerdict('incognito')
128
- * </script>
129
- *
130
- * {#if incognito.matched}Private window ({incognito.confidence}){/if}
131
- * ```
132
- *
133
- * `min` defaults to `medium`. A `low`-confidence verdict is a single weak tell
134
- * - one removable flag, or one countermeasure a privacy-conscious real user
135
- * might equally be running - and defaulting to acting on it would make this a
136
- * false-positive generator. Pass `min: 'low'` deliberately if the intent is to
137
- * observe rather than to block.
138
- */
139
- export function useVerdict(name, options = {}) {
140
- const fingerly = useFingerly();
141
- // Getters accepted as well as values, because this is called once when the
142
- // component initialises and its arguments may be props that change after
143
- // that. A plain value read here would be the value that prop had at
144
- // initialisation, forever.
145
- const which = $derived(typeof name === 'function' ? name() : name);
146
- const floor = $derived((typeof options.min === 'function' ? options.min() : options.min) ?? 'medium');
147
- const verdict = $derived(fingerly.verdicts ? fingerly.verdicts[which] : null);
148
- const matched = $derived(verdict !== null && verdict.value && RANK[verdict.confidence] >= RANK[floor]);
149
- return {
150
- get verdict() {
151
- return verdict;
152
- },
153
- get confidence() {
154
- return verdict?.confidence ?? null;
155
- },
156
- get reasons() {
157
- return verdict?.reasons ?? NO_REASONS;
158
- },
159
- get matched() {
160
- return matched;
161
- },
162
- };
163
- }
164
- //# sourceMappingURL=hooks.svelte.js.map
package/dist/index.d.ts CHANGED
@@ -5,14 +5,13 @@
5
5
  * properties. See the README for the whole surface with examples.
6
6
  *
7
7
  * Requires Svelte 5: the state is built with runes, which is what lets a
8
- * component read `fingerly.verdicts` and re-render, with no store and no `$`
8
+ * component read `fingerly.suspectLevel` and re-render, with no store and no `$`
9
9
  * prefix at the call site.
10
10
  */
11
11
  export { FINGERLY_KEY, setupFingerly, useFingerly } from './context.js';
12
12
  export { createFingerly, FingerlyServerError } from './state.svelte.js';
13
13
  export type { Fingerly, FingerlyOptions } from './state.svelte.js';
14
- export { useIdentify, useVerdict } from './hooks.svelte.js';
15
- export type { UseIdentifyOptions, UseVerdictReturn, VerdictName } from './hooks.svelte.js';
16
- export type { FingerlyWebEvent, Confidence, ConsentState, IdentifyResult, IntegrityReport, Lie, SignalOutcome, SignalReport, SignalStatus, Verdict, Verdicts, } from '@fingerly/web-js';
14
+ export { useIdentify } from './hooks.svelte.js';
15
+ export type { UseIdentifyOptions } from './hooks.svelte.js';
16
+ export type { FingerlyWebEvent, Confidence, ConsentState, IdentifyResult, IntegrityReport, Lie, SignalOutcome, SignalReport, SignalStatus, } from '@fingerly/web-js';
17
17
  export { ConsentError, TransportError } from '@fingerly/web-js';
18
- //# sourceMappingURL=index.d.ts.map
package/dist/index.js CHANGED
@@ -5,11 +5,10 @@
5
5
  * properties. See the README for the whole surface with examples.
6
6
  *
7
7
  * Requires Svelte 5: the state is built with runes, which is what lets a
8
- * component read `fingerly.verdicts` and re-render, with no store and no `$`
8
+ * component read `fingerly.suspectLevel` and re-render, with no store and no `$`
9
9
  * prefix at the call site.
10
10
  */
11
11
  export { FINGERLY_KEY, setupFingerly, useFingerly } from './context.js';
12
12
  export { createFingerly, FingerlyServerError } from './state.svelte.js';
13
- export { useIdentify, useVerdict } from './hooks.svelte.js';
13
+ export { useIdentify } from './hooks.svelte.js';
14
14
  export { ConsentError, TransportError } from '@fingerly/web-js';
15
- //# sourceMappingURL=index.js.map
@@ -5,7 +5,7 @@
5
5
  * live outside a component: the file is compiled by the Svelte compiler in the
6
6
  * consuming app, so the fields below are reactive wherever they are read.
7
7
  * That is the whole reason this binding needs no store, no subscription and no
8
- * `$` prefix at the call site - a component reads `fingerly.verdicts` and
8
+ * `$` prefix at the call site - a component reads `fingerly.suspectLevel` and
9
9
  * re-renders when it changes.
10
10
  *
11
11
  * One state per app, not one per component. Identification is a *page-level*
@@ -14,7 +14,7 @@
14
14
  * bill the customer three times for one page load and hand the three
15
15
  * components three different `requestId`s for one visitor.
16
16
  */
17
- import { type ConsentState, type FingerlyClient, type IdentifyResult, type IdentifyTrigger, type SignalReport, type Verdicts } from '@fingerly/web-js';
17
+ import { type ConsentState, type FingerlyClient, type IdentifyResult, type SignalReport } from '@fingerly/web-js';
18
18
  /** Options for [[createFingerly]] and [[setupFingerly]]. */
19
19
  export interface FingerlyOptions {
20
20
  /** The SDK key from the dashboard. A public key is safe in a page. */
@@ -26,13 +26,12 @@ export interface FingerlyOptions {
26
26
  endpoints?: string | readonly string[];
27
27
  fallbackToDefaultEndpoint?: boolean;
28
28
  /**
29
- * Collect and score without submitting anything.
29
+ * Collect without submitting anything.
30
30
  *
31
- * For a page that wants the local verdicts and nothing else. Everything
32
- * the server decides comes back empty: no `requestId`, no `visitorId` and
33
- * no `suspectScore`. That is the honest answer rather than a gap - nothing
34
- * was sent, so nobody scored it, and a zero here would read as "scored,
35
- * found nothing".
31
+ * Everything the server decides comes back empty: no `requestId`, no
32
+ * `visitorId`, no `suspectScore`, no `suspectLevel`. That is the honest
33
+ * answer rather than a gap - nothing was sent, so nobody scored it, and
34
+ * this SDK decides nothing on its own.
36
35
  */
37
36
  submit?: boolean;
38
37
  /**
@@ -65,7 +64,11 @@ export interface Fingerly {
65
64
  readonly duplicate: boolean;
66
65
  /** The server's disposition of the check. */
67
66
  readonly state: string | null;
68
- /** Why, when `state` needs explaining. */
67
+ /**
68
+ * @deprecated Always `null`. A browser is no longer told why a check went
69
+ * unscored; your backend reads `reason` on the server-side event read, by
70
+ * `requestId`. Kept so code written against 0.1.0 still compiles.
71
+ */
69
72
  readonly reason: string | null;
70
73
  /**
71
74
  * The server's score, 0-100, or null when it did not score.
@@ -76,23 +79,19 @@ export interface Fingerly {
76
79
  readonly suspectScore: number | null;
77
80
  /** The score as a band - `low`, `medium`, `high`. Null when unscored. */
78
81
  readonly suspectLevel: string | null;
79
- /** What the server scored on. Empty when it found nothing. */
80
- readonly triggers: readonly IdentifyTrigger[];
81
- readonly verdicts: Verdicts | null;
82
82
  readonly report: SignalReport | null;
83
83
  readonly error: Error | null;
84
84
  readonly isLoading: boolean;
85
85
  /** True once an identification has completed, successfully or not. */
86
86
  readonly isReady: boolean;
87
87
  /**
88
- * True when the verdicts contain anything worth acting on.
89
- *
90
- * Deliberately conservative: it requires `medium` confidence or better,
91
- * because a `low`-confidence verdict is one weak tell and blocking on it
92
- * would be blocking real users. Anything more nuanced should read `verdicts`
93
- * directly - this is the "should I even look?" flag, not a policy.
88
+ * True when the server scored this `medium` or `high` under the weights you
89
+ * set: the "should I even look?" flag, and not a policy. `null` when no
90
+ * server has answered or the level is absent (not identified yet, `submit:
91
+ * false`, unscored, or hidden by the key), which is not a clean result.
92
+ * Anything more nuanced reads `suspectLevel`, or your backend reads the signals.
94
93
  */
95
- readonly isSuspicious: boolean;
94
+ readonly isSuspicious: boolean | null;
96
95
  /**
97
96
  * Whether the visitor has agreed to be identified, as last set here or on
98
97
  * the client. Automatic identification waits for `granted`.
@@ -111,6 +110,7 @@ export interface Fingerly {
111
110
  identify(options?: {
112
111
  tag?: string;
113
112
  force?: boolean;
113
+ automatic?: boolean;
114
114
  }): Promise<IdentifyResult>;
115
115
  /** Identify again from scratch, ignoring any previous result. */
116
116
  refresh(options?: {
@@ -131,5 +131,19 @@ export declare class FingerlyServerError extends Error {
131
131
  * factory that fingerprinted as it ran would collect during a server render
132
132
  * and take the choice of *when* away from the page that knows.
133
133
  */
134
+ /**
135
+ * How long a failed identification holds off the next one.
136
+ *
137
+ * Without this a failure was forgotten at once, and every component mounting
138
+ * with `immediate` started another identification - three requests per route
139
+ * change while the API was answering 429. A `Retry-After` the server sent
140
+ * holds every call, forced or not, until it passes. A transient failure
141
+ * without one (a 5xx, a network error) holds automatic calls only, for 5 s
142
+ * doubling per consecutive failure up to a minute; a click still tries at
143
+ * once. Anything else holds nothing.
144
+ */
145
+ export declare function failureHold(error: unknown, consecutive: number, now: number): {
146
+ until: number;
147
+ automaticUntil: number;
148
+ };
134
149
  export declare function createFingerly(options: FingerlyOptions): Fingerly;
135
- //# sourceMappingURL=state.svelte.d.ts.map
@@ -5,7 +5,7 @@
5
5
  * live outside a component: the file is compiled by the Svelte compiler in the
6
6
  * consuming app, so the fields below are reactive wherever they are read.
7
7
  * That is the whole reason this binding needs no store, no subscription and no
8
- * `$` prefix at the call site - a component reads `fingerly.verdicts` and
8
+ * `$` prefix at the call site - a component reads `fingerly.suspectLevel` and
9
9
  * re-renders when it changes.
10
10
  *
11
11
  * One state per app, not one per component. Identification is a *page-level*
@@ -14,7 +14,7 @@
14
14
  * bill the customer three times for one page load and hand the three
15
15
  * components three different `requestId`s for one visitor.
16
16
  */
17
- import { load, } from '@fingerly/web-js';
17
+ import { isSuspiciousLevel, load, } from '@fingerly/web-js';
18
18
  /** Thrown when the SDK is asked to collect somewhere there is no browser. */
19
19
  export class FingerlyServerError extends Error {
20
20
  name = 'FingerlyServerError';
@@ -31,6 +31,23 @@ export class FingerlyServerError extends Error {
31
31
  * factory that fingerprinted as it ran would collect during a server render
32
32
  * and take the choice of *when* away from the page that knows.
33
33
  */
34
+ /**
35
+ * How long a failed identification holds off the next one.
36
+ *
37
+ * Without this a failure was forgotten at once, and every component mounting
38
+ * with `immediate` started another identification - three requests per route
39
+ * change while the API was answering 429. A `Retry-After` the server sent
40
+ * holds every call, forced or not, until it passes. A transient failure
41
+ * without one (a 5xx, a network error) holds automatic calls only, for 5 s
42
+ * doubling per consecutive failure up to a minute; a click still tries at
43
+ * once. Anything else holds nothing.
44
+ */
45
+ export function failureHold(error, consecutive, now) {
46
+ const failure = error;
47
+ const retryAfter = typeof failure?.retryAfterMs === 'number' && failure.retryAfterMs > 0 ? failure.retryAfterMs : 0;
48
+ const backoff = failure?.retryable === true ? Math.min(60_000, 5_000 * 2 ** Math.max(0, consecutive - 1)) : 0;
49
+ return { until: now + retryAfter, automaticUntil: now + Math.max(retryAfter, backoff) };
50
+ }
34
51
  export function createFingerly(options) {
35
52
  let requestId = $state(null);
36
53
  let visitorId = $state(null);
@@ -39,22 +56,19 @@ export function createFingerly(options) {
39
56
  let identifiable = $state(false);
40
57
  let duplicate = $state(false);
41
58
  let checkState = $state(null);
42
- let reason = $state(null);
43
59
  let suspectScore = $state(null);
44
60
  let suspectLevel = $state(null);
45
- let triggers = $state([]);
46
- let verdicts = $state(null);
47
61
  let report = $state(null);
48
62
  let error = $state(null);
49
63
  let isLoading = $state(false);
50
64
  let consent = $state(options.consent ?? 'pending');
51
65
  const isReady = $derived(report !== null || error !== null);
52
- const isSuspicious = $derived(verdicts === null
53
- ? false
54
- : Object.values(verdicts).some((verdict) => verdict.value && verdict.confidence !== 'low'));
66
+ const isSuspicious = $derived(isSuspiciousLevel(suspectLevel));
55
67
  let clientPromise;
56
68
  let loaded;
57
69
  let current;
70
+ let held;
71
+ let consecutiveFailures = 0;
58
72
  const mirrorConsent = (next) => {
59
73
  consent = next;
60
74
  };
@@ -64,7 +78,9 @@ export function createFingerly(options) {
64
78
  // Built once and memoised. `load()` is cheap today but is the documented
65
79
  // place for future warm-up work, and warming up per component would undo
66
80
  // it.
67
- clientPromise ??= load({
81
+ // Through a promise even though load() returns one: a synchronous throw
82
+ // here would escape every caller's .catch and leave isLoading stuck.
83
+ clientPromise ??= Promise.resolve().then(() => load({
68
84
  apiKey: options.apiKey,
69
85
  ...(options.endpoint === undefined ? {} : { endpoint: options.endpoint }),
70
86
  ...(options.apiVersion === undefined ? {} : { apiVersion: options.apiVersion }),
@@ -81,7 +97,7 @@ export function createFingerly(options) {
81
97
  fingerly.onConsentChange(mirrorConsent);
82
98
  loaded = fingerly;
83
99
  return fingerly;
84
- });
100
+ }));
85
101
  return clientPromise;
86
102
  };
87
103
  const setConsent = (next) => {
@@ -103,6 +119,11 @@ export function createFingerly(options) {
103
119
  // whole fingerprint. A promise has an identity either way.
104
120
  if (current && !identifyOptions.force)
105
121
  return current;
122
+ // Holding off after a failure; see failureHold.
123
+ const now = Date.now();
124
+ if (held && (now < held.until || (identifyOptions.automatic && now < held.automaticUntil))) {
125
+ return Promise.reject(held.error);
126
+ }
106
127
  isLoading = true;
107
128
  error = null;
108
129
  const run = client()
@@ -118,16 +139,18 @@ export function createFingerly(options) {
118
139
  identifiable = result.identifiable;
119
140
  duplicate = result.duplicate;
120
141
  checkState = result.state === '' ? null : result.state;
121
- reason = result.reason === '' ? null : result.reason;
122
- suspectScore = result.suspectScore;
123
- suspectLevel = result.suspectLevel;
124
- triggers = result.triggers;
125
- verdicts = result.verdicts;
142
+ suspectScore = result.suspectScore ?? null;
143
+ suspectLevel = result.suspectLevel ?? null;
126
144
  report = result.report;
145
+ held = undefined;
146
+ consecutiveFailures = 0;
127
147
  return result;
128
148
  })
129
149
  .catch((cause) => {
130
- error = cause instanceof Error ? cause : new Error(String(cause));
150
+ const failure = cause instanceof Error ? cause : new Error(String(cause));
151
+ error = failure;
152
+ consecutiveFailures += 1;
153
+ held = { error: failure, ...failureHold(failure, consecutiveFailures, Date.now()) };
131
154
  // Forgotten, so the next caller retries rather than being handed a
132
155
  // rejected promise forever.
133
156
  if (current === run)
@@ -135,7 +158,7 @@ export function createFingerly(options) {
135
158
  // Rethrown as well as stored: a caller that awaited identify() should
136
159
  // be able to try/catch it, and a component that only reads `error`
137
160
  // should not have to.
138
- throw error;
161
+ throw failure;
139
162
  })
140
163
  .finally(() => {
141
164
  isLoading = false;
@@ -170,7 +193,8 @@ export function createFingerly(options) {
170
193
  return checkState;
171
194
  },
172
195
  get reason() {
173
- return reason;
196
+ // Deprecated: the server no longer tells a browser. See the interface.
197
+ return null;
174
198
  },
175
199
  get suspectScore() {
176
200
  return suspectScore;
@@ -178,12 +202,6 @@ export function createFingerly(options) {
178
202
  get suspectLevel() {
179
203
  return suspectLevel;
180
204
  },
181
- get triggers() {
182
- return triggers;
183
- },
184
- get verdicts() {
185
- return verdicts;
186
- },
187
205
  get report() {
188
206
  return report;
189
207
  },
@@ -208,4 +226,3 @@ export function createFingerly(options) {
208
226
  client,
209
227
  };
210
228
  }
211
- //# sourceMappingURL=state.svelte.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fingerly/svelte",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -26,7 +26,7 @@
26
26
  ],
27
27
  "sideEffects": false,
28
28
  "dependencies": {
29
- "@fingerly/web-js": "0.1.0"
29
+ "@fingerly/web-js": "0.1.1"
30
30
  },
31
31
  "peerDependencies": {
32
32
  "svelte": ">=5"
@@ -1 +0,0 @@
1
- {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAkB,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEvF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,MAA2B,CAAA;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAIhE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAYtC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAE3D,OAAO,EAAE,cAAc,EAAuC,MAAM,mBAAmB,CAAA;AAEvF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAkB,MAAM,CAAC,UAAU,CAAC,CAAA;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;IACxC,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;IAClC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,8EAA8E;YAC5E,sDAAsD;YACtD,wDAAwD;YACxD,2EAA2E;YAC3E,8BAA8B,CACjC,CAAA;IACH,CAAC;IAED,OAAO,UAAU,CAAW,YAAY,CAAC,CAAA;AAC3C,CAAC"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"hooks.svelte.d.ts","sourceRoot":"","sources":["../src/hooks.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAGrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAA;AAExC,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,CAAA;CAC1C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,QAAQ,CA8FtE;AAED,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;IACtC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,EACvC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,CAAA;CAAO,GACtD,gBAAgB,CA+BlB"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"hooks.svelte.js","sourceRoot":"","sources":["../src/hooks.svelte.ts"],"names":[],"mappings":"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"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAEvE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC3D,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAI1F,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,GAAG,EACH,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,QAAQ,GACT,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}
package/dist/index.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAEvE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAGvE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAkB3D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"state.svelte.d.ts","sourceRoot":"","sources":["../src/state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAA;AAEzB,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAA;IACd,iDAAiD;IACjD,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;IACtC,yBAAyB,CAAC,EAAE,OAAO,CAAA;IACnC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED,iFAAiF;AACjF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B;;;;;;;OAOG;IACH,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IACrC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC9E,iEAAiE;IACjE,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC5D,iDAAiD;IACjD,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;CAClC;AAED,6EAA6E;AAC7E,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAkB,IAAI,yBAAwB;;CAQ/C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CA4LjE"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"state.svelte.js","sourceRoot":"","sources":["../src/state.svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,IAAI,GAOL,MAAM,kBAAkB,CAAA;AAuGzB,6EAA6E;AAC7E,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC1B,IAAI,GAAG,qBAAqB,CAAA;IAC9C;QACE,KAAK,CACH,wFAAwF;YACtF,iFAAiF;YACjF,qCAAqC,CACxC,CAAA;IACH,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,IAAI,SAAS,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAA;IAC3C,IAAI,SAAS,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAA;IAC3C,IAAI,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,iBAAiB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACjC,IAAI,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7B,IAAI,UAAU,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAA;IAC5C,IAAI,MAAM,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAA;IACxC,IAAI,YAAY,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAA;IAC9C,IAAI,YAAY,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAA;IAC9C,IAAI,QAAQ,GAAG,MAAM,CAA6B,EAAE,CAAC,CAAA;IACrD,IAAI,QAAQ,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAA;IAC5C,IAAI,MAAM,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAA;IAC9C,IAAI,KAAK,GAAG,MAAM,CAAe,IAAI,CAAC,CAAA;IACtC,IAAI,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7B,IAAI,OAAO,GAAG,MAAM,CAAe,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC,CAAA;IAEhE,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,CAAA;IAC3D,MAAM,YAAY,GAAG,QAAQ,CAC3B,QAAQ,KAAK,IAAI;QACf,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC,CAC7F,CAAA;IAED,IAAI,aAAkD,CAAA;IACtD,IAAI,MAAkC,CAAA;IACtC,IAAI,OAA4C,CAAA;IAEhD,MAAM,aAAa,GAAG,CAAC,IAAkB,EAAQ,EAAE;QACjD,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,GAA4B,EAAE;QAC3C,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAA;QACnF,yEAAyE;QACzE,yEAAyE;QACzE,MAAM;QACN,aAAa,KAAK,IAAI,CAAC;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YACzE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;YAC/E,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;YAC5E,GAAG,CAAC,OAAO,CAAC,yBAAyB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,yBAAyB,EAAE,OAAO,CAAC,yBAAyB,EAAE,CAAC;YAC5H,OAAO;SACR,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACnB,sEAAsE;YACtE,8CAA8C;YAC9C,IAAI,QAAQ,CAAC,OAAO,KAAK,OAAO;gBAAE,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YAC9D,yEAAyE;YACzE,8DAA8D;YAC9D,QAAQ,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;YACvC,MAAM,GAAG,QAAQ,CAAA;YACjB,OAAO,QAAQ,CAAA;QACjB,CAAC,CAAC,CAAA;QACF,OAAO,aAAa,CAAA;IACtB,CAAC,CAAA;IAED,MAAM,UAAU,GAA2B,CAAC,IAAI,EAAE,EAAE;QAClD,0EAA0E;QAC1E,mDAAmD;QACnD,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAA;QACxB,aAAa,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC,CAAA;IAED,MAAM,QAAQ,GAAyB,CAAC,eAAe,GAAG,EAAE,EAAE,EAAE;QAC9D,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAA;QAEnF,wEAAwE;QACxE,yEAAyE;QACzE,WAAW;QACX,EAAE;QACF,2EAA2E;QAC3E,0EAA0E;QAC1E,uEAAuE;QACvE,2DAA2D;QAC3D,IAAI,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK;YAAE,OAAO,OAAO,CAAA;QAErD,SAAS,GAAG,IAAI,CAAA;QAChB,KAAK,GAAG,IAAI,CAAA;QAEZ,MAAM,GAAG,GAAG,MAAM,EAAE;aACjB,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACjB,QAAQ,CAAC,QAAQ,CAAC;YAChB,GAAG,CAAC,eAAe,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,CAAC,GAAG,EAAE,CAAC;YAC1E,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SACpE,CAAC,CACH;aACA,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,SAAS,GAAG,MAAM,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAA;YAC7D,SAAS,GAAG,MAAM,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAA;YAC7D,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;YAClC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAA;YAC5C,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;YAClC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAA;YAC5B,UAAU,GAAG,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;YACtD,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;YACpD,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;YAClC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;YAClC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;YAC1B,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;YAC1B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;YACtB,OAAO,MAAM,CAAA;QACf,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACjE,mEAAmE;YACnE,4BAA4B;YAC5B,IAAI,OAAO,KAAK,GAAG;gBAAE,OAAO,GAAG,SAAS,CAAA;YACxC,sEAAsE;YACtE,mEAAmE;YACnE,sBAAsB;YACtB,MAAM,KAAK,CAAA;QACb,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,SAAS,GAAG,KAAK,CAAA;QACnB,CAAC,CAAC,CAAA;QAEJ,OAAO,GAAG,GAAG,CAAA;QACb,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,MAAM,OAAO,GAAwB,CAAC,cAAc,GAAG,EAAE,EAAE,EAAE,CAC3D,QAAQ,CAAC,EAAE,GAAG,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAE9C,yEAAyE;IACzE,yEAAyE;IACzE,mEAAmE;IACnE,OAAO;QACL,IAAI,SAAS;YACX,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,IAAI,SAAS;YACX,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,IAAI,YAAY;YACd,OAAO,YAAY,CAAA;QACrB,CAAC;QACD,IAAI,iBAAiB;YACnB,OAAO,iBAAiB,CAAA;QAC1B,CAAC;QACD,IAAI,YAAY;YACd,OAAO,YAAY,CAAA;QACrB,CAAC;QACD,IAAI,SAAS;YACX,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,IAAI,KAAK;YACP,OAAO,UAAU,CAAA;QACnB,CAAC;QACD,IAAI,MAAM;YACR,OAAO,MAAM,CAAA;QACf,CAAC;QACD,IAAI,YAAY;YACd,OAAO,YAAY,CAAA;QACrB,CAAC;QACD,IAAI,YAAY;YACd,OAAO,YAAY,CAAA;QACrB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAA;QACjB,CAAC;QACD,IAAI,MAAM;YACR,OAAO,MAAM,CAAA;QACf,CAAC;QACD,IAAI,KAAK;YACP,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,SAAS;YACX,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,YAAY;YACd,OAAO,YAAY,CAAA;QACrB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,UAAU;QACV,QAAQ;QACR,OAAO;QACP,MAAM;KACP,CAAA;AACH,CAAC"}