@deveye/types 0.25.2 → 0.25.3
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/package.json +1 -1
- package/src/domain/syncProtocol.ts +7 -3
- package/src/index.ts +2 -0
- package/src/protocol/agent.ts +34 -9
- package/src/sdk/client-ambient.d.ts +3 -3
- package/src/sdk/client.ts +19 -0
- package/src/sdk/providers.ts +7 -0
package/package.json
CHANGED
|
@@ -32,11 +32,15 @@ export const SYNC_RESUME_NONCES_MAX = Math.ceil((SYNC_RESUME_MAX_BLOCKS * 12) /
|
|
|
32
32
|
export const SYNC_FINGERPRINT_SEP = '\u0001';
|
|
33
33
|
/**
|
|
34
34
|
* Mode de scan demandé à l'agent.
|
|
35
|
-
* - `
|
|
36
|
-
* le disque, en se contentant d'annoncer l'empreinte de ce qu'il détient
|
|
35
|
+
* - `delta` → l'agent a le droit de répondre « rien n'a bougé » sans parcourir
|
|
36
|
+
* le disque, en se contentant d'annoncer l'empreinte de ce qu'il détient,
|
|
37
|
+
* ou de ne parcourir que ce que son watcher a vu bouger et de n'envoyer que
|
|
38
|
+
* ces entrées (`delta: true` sur `sync.index`) ;
|
|
37
39
|
* - `full` → parcours complet obligatoire (filet de sécurité horaire).
|
|
40
|
+
* Un agent qui ignore `delta` parcourt tout : la dissymétrie de version
|
|
41
|
+
* dégrade vers « on parcourt », jamais vers « on saute ».
|
|
38
42
|
*/
|
|
39
|
-
export const syncScanModeSchema = z.enum(['
|
|
43
|
+
export const syncScanModeSchema = z.enum(['delta', 'full']);
|
|
40
44
|
export type SyncScanMode = z.infer<typeof syncScanModeSchema>;
|
|
41
45
|
/**
|
|
42
46
|
* Empreinte d'un index : `{nombre}.{octets}.{sha256hex}`. Le pli est un XOR des
|
package/src/index.ts
CHANGED
|
@@ -241,6 +241,7 @@ export {
|
|
|
241
241
|
syncIndexEntrySchema,
|
|
242
242
|
syncIndexLineSchema,
|
|
243
243
|
syncIndexSkippedEntrySchema,
|
|
244
|
+
syncIndexGoneEntrySchema,
|
|
244
245
|
syncShareAssignmentSchema
|
|
245
246
|
} from './protocol/agent';
|
|
246
247
|
export type {
|
|
@@ -328,6 +329,7 @@ export type {
|
|
|
328
329
|
SyncIndexEntry,
|
|
329
330
|
SyncIndexLine,
|
|
330
331
|
SyncIndexSkippedEntry,
|
|
332
|
+
SyncIndexGoneEntry,
|
|
331
333
|
SyncShareAssignment
|
|
332
334
|
} from './protocol/agent';
|
|
333
335
|
|
package/src/protocol/agent.ts
CHANGED
|
@@ -438,10 +438,18 @@ export const syncIndexSkippedEntrySchema = z.object({
|
|
|
438
438
|
});
|
|
439
439
|
export type SyncIndexSkippedEntry = z.infer<typeof syncIndexSkippedEntrySchema>;
|
|
440
440
|
|
|
441
|
-
/**
|
|
441
|
+
/** A path the agent no longer holds, in a `delta: true` reply only. */
|
|
442
|
+
export const syncIndexGoneEntrySchema = z.object({
|
|
443
|
+
relPath: syncRelPath,
|
|
444
|
+
kind: z.literal('gone')
|
|
445
|
+
});
|
|
446
|
+
export type SyncIndexGoneEntry = z.infer<typeof syncIndexGoneEntrySchema>;
|
|
447
|
+
|
|
448
|
+
/** One line of a `sync.index` batch: an indexed entry, a skipped path, or a path gone since the last scan. */
|
|
442
449
|
export const syncIndexLineSchema = z.discriminatedUnion('kind', [
|
|
443
450
|
syncIndexEntrySchema,
|
|
444
|
-
syncIndexSkippedEntrySchema
|
|
451
|
+
syncIndexSkippedEntrySchema,
|
|
452
|
+
syncIndexGoneEntrySchema
|
|
445
453
|
]);
|
|
446
454
|
export type SyncIndexLine = z.infer<typeof syncIndexLineSchema>;
|
|
447
455
|
|
|
@@ -454,14 +462,25 @@ export const agentSyncIndexPayloadSchema = z.object({
|
|
|
454
462
|
entries: z.array(syncIndexLineSchema).max(SYNC_INDEX_BATCH_MAX),
|
|
455
463
|
done: z.boolean(),
|
|
456
464
|
/**
|
|
457
|
-
* L'agent a-t-il
|
|
458
|
-
* `sync.scan` en mode `
|
|
459
|
-
* aucune entrée, seule `fingerprint` est renseignée, et le
|
|
460
|
-
* qu'elle correspond à sa baseline (une vérification
|
|
461
|
-
* complet, jamais une divergence).
|
|
462
|
-
*
|
|
465
|
+
* L'agent a-t-il parcouru le disque en entier ? `false` sans `delta`
|
|
466
|
+
* répond à un `sync.scan` en mode `delta` sur un partage que le watcher
|
|
467
|
+
* sait intact : aucune entrée, seule `fingerprint` est renseignée, et le
|
|
468
|
+
* serveur VÉRIFIE qu'elle correspond à sa baseline (une vérification
|
|
469
|
+
* fausse coûte un scan complet, jamais une divergence). `false` avec
|
|
470
|
+
* `delta` : seuls les dossiers touchés ont été relus, les chemins écartés
|
|
471
|
+
* ne sont pas tous là. Le défaut `true` rend un vieil agent inoffensif.
|
|
463
472
|
*/
|
|
464
473
|
scanned: z.boolean().default(true),
|
|
474
|
+
/**
|
|
475
|
+
* Les entrées ne sont que ce qui a changé depuis le dernier scan (celles
|
|
476
|
+
* `gone` ont disparu) : l'index de l'appareil est la baseline du serveur
|
|
477
|
+
* corrigée de ces lignes, et `fingerprint` décrit cet index entier. Le
|
|
478
|
+
* serveur VÉRIFIE l'empreinte avant d'y croire, comme pour une réponse
|
|
479
|
+
* rapide. Jamais envoyé sans un `sync.scan` en mode `delta`, ou avec une
|
|
480
|
+
* empreinte `expected` que le parcours complet a retrouvée (`scanned`
|
|
481
|
+
* reste alors `true`).
|
|
482
|
+
*/
|
|
483
|
+
delta: z.boolean().default(false),
|
|
465
484
|
/** Empreinte de l'index détenu par l'agent, quand il sait la calculer. */
|
|
466
485
|
fingerprint: syncIndexFingerprintSchema.nullable().default(null),
|
|
467
486
|
/**
|
|
@@ -1095,7 +1114,13 @@ export const agentSyncScanPayloadSchema = z.object({
|
|
|
1095
1114
|
* dissymétrie de version dégradent vers « scan complet », jamais vers
|
|
1096
1115
|
* « saut ».
|
|
1097
1116
|
*/
|
|
1098
|
-
mode: syncScanModeSchema.default('full')
|
|
1117
|
+
mode: syncScanModeSchema.default('full'),
|
|
1118
|
+
/**
|
|
1119
|
+
* L'empreinte de la baseline que le serveur tient pour cet appareil. Un
|
|
1120
|
+
* parcours complet qui la retrouve répond sans ses entrées (`delta: true`,
|
|
1121
|
+
* rien de changé) : le serveur n'a alors rien à recharger.
|
|
1122
|
+
*/
|
|
1123
|
+
expected: syncIndexFingerprintSchema.optional()
|
|
1099
1124
|
});
|
|
1100
1125
|
export type AgentSyncScanPayload = z.infer<typeof agentSyncScanPayloadSchema>;
|
|
1101
1126
|
|
|
@@ -172,7 +172,7 @@ declare module 'deveye-sdk-client' {
|
|
|
172
172
|
export const LogOutput: ComponentType<LogOutputProps>;
|
|
173
173
|
export const Checkbox: ComponentType<{
|
|
174
174
|
checked: boolean;
|
|
175
|
-
/** Receives the state AFTER the click
|
|
175
|
+
/** Receives the state AFTER the click: no event to unwrap. */
|
|
176
176
|
onChange: (checked: boolean) => void;
|
|
177
177
|
children?: ReactNode;
|
|
178
178
|
disabled?: boolean;
|
|
@@ -459,7 +459,7 @@ declare module 'deveye-sdk-client' {
|
|
|
459
459
|
children: ReactNode;
|
|
460
460
|
className?: string;
|
|
461
461
|
}>;
|
|
462
|
-
/** One confirmation dialog for the whole app
|
|
462
|
+
/** One confirmation dialog for the whole app (see ConfirmDialog). */
|
|
463
463
|
export interface ConfirmRequest {
|
|
464
464
|
title: string;
|
|
465
465
|
description?: ReactNode;
|
|
@@ -772,7 +772,7 @@ declare module 'deveye-sdk-client' {
|
|
|
772
772
|
/**
|
|
773
773
|
* A resource key an EXTERNAL module may own: `x-<slug>.<name>`, as listed
|
|
774
774
|
* in its manifest `resources`. The app's bus is typed on the closed union
|
|
775
|
-
* of native keys plus this shape
|
|
775
|
+
* of native keys plus this shape: an arbitrary string is refused there,
|
|
776
776
|
* so it is refused here too.
|
|
777
777
|
*/
|
|
778
778
|
export type ExternalResourceKey = `x-${string}.${string}`;
|
package/src/sdk/client.ts
CHANGED
|
@@ -95,6 +95,13 @@ export interface FeatureClient {
|
|
|
95
95
|
* (`'notifications'`, `'permissions'`) need no panel.
|
|
96
96
|
*/
|
|
97
97
|
settingsPanels?: Readonly<Record<string, ComponentType<SettingsPanelProps>>>;
|
|
98
|
+
/**
|
|
99
|
+
* Whether a custom tab applies to this scope, for a tab that only means
|
|
100
|
+
* something to some items (Mail's Access tab, for a mailbox the Mail
|
|
101
|
+
* server hosts). Asked when the settings open, the tab hidden until the
|
|
102
|
+
* answer. Omitted, every declared tab shows.
|
|
103
|
+
*/
|
|
104
|
+
settingsTabApplies?(tabId: string, scope: SdkSettingsScope): Promise<boolean>;
|
|
98
105
|
/**
|
|
99
106
|
* The compact topbar widget declared by `manifest.topbarWidget`. Rendered
|
|
100
107
|
* with NO props: everything it shows must come through YOUR feature's
|
|
@@ -521,3 +528,15 @@ export interface MailClientProvider {
|
|
|
521
528
|
prefill?: MailAccountPrefill;
|
|
522
529
|
}>;
|
|
523
530
|
}
|
|
531
|
+
|
|
532
|
+
/**
|
|
533
|
+
* What the Mail server module offers under `MAILSERVER_CLIENT_PROVIDER`: Mail
|
|
534
|
+
* shows, on an account whose address the server hosts, the mailbox's own
|
|
535
|
+
* Access tab (its application passwords) and the way to its sheet.
|
|
536
|
+
*/
|
|
537
|
+
export interface MailserverClientProvider {
|
|
538
|
+
/** The hosted mailbox holding this address among those the caller can read, or null. */
|
|
539
|
+
findByAddress(address: string): Promise<{ id: number } | null>;
|
|
540
|
+
/** The mailbox's Access settings panel, to mount under a scope naming that mailbox. */
|
|
541
|
+
AccessPanel: ComponentType<SettingsPanelProps>;
|
|
542
|
+
}
|
package/src/sdk/providers.ts
CHANGED
|
@@ -288,6 +288,13 @@ export interface MailTransportMessage {
|
|
|
288
288
|
*/
|
|
289
289
|
export const MAIL_CLIENT_PROVIDER = 'mail.client' as const;
|
|
290
290
|
|
|
291
|
+
/**
|
|
292
|
+
* Key under `FeatureClient.providers` for what the Mail server offers Mail's
|
|
293
|
+
* screens: whether an address is hosted there, and the Access tab of its
|
|
294
|
+
* mailbox. The contract type lives in `@deveye/types/sdk/client`.
|
|
295
|
+
*/
|
|
296
|
+
export const MAILSERVER_CLIENT_PROVIDER = 'mailserver.client' as const;
|
|
297
|
+
|
|
291
298
|
/**
|
|
292
299
|
* Key under `FeatureService.providers` for the Audience sites the app's
|
|
293
300
|
* Projects feature links to: same shape and same reason as
|