@deveye/types 0.15.2 → 0.16.0

package/src/features/registry.ts

@@ -1,28 +1,12 @@
 import { z } from 'zod';
-import { audienceCommands } from './audience';
-import { backupCommands } from './backup';
-import { deviceCommands } from './device';
-import { deviceFilesCommands } from './deviceFiles';
-import { deviceLogCommands } from './deviceLogs';
-import { deviceTerminalCommands } from './deviceTerminal';
-import { databaseCommands } from './database';
-import { deployCommands } from './deploy';
-import { financeCommands } from './finance';
-import { gitCommands } from './git';
+import { agentCommands } from './agent';
 import { homeCommands } from './home';
 import { liveCommands } from './live';
 import { logsCommands } from './logs';
-import { mailCommands } from './mail';
-import { metricsCommands } from './metrics';
-import { noteCommands } from './note';
 import { notifyCommands } from './notify';
 import { sharingCommands } from './sharing';
-import { passwordCommands } from './password';
-import { projectCommands } from './project';
 import { secrecyCommands } from './secrecy';
-import { sentinelCommands } from './sentinel';
 import { twoFactorCommands } from './twoFactor';
-import { uptimeCommands } from './uptime';
 import { userCommands } from './user';
 import { adminCommands } from './admin';
 import { workspaceCommands } from './workspace';
@@ -37,27 +21,11 @@ export const featureCommands = [
     ...workspaceCommands,
     ...adminCommands,
     ...userCommands,
-    ...passwordCommands,
-    ...noteCommands,
-    ...projectCommands,
-    ...gitCommands,
-    ...deployCommands,
-    ...backupCommands,
-    ...databaseCommands,
-    ...financeCommands,
-    ...audienceCommands,
-    ...deviceCommands,
-    ...deviceLogCommands,
-    ...deviceTerminalCommands,
-    ...deviceFilesCommands,
-    ...metricsCommands,
-    ...sentinelCommands,
-    ...uptimeCommands,
+    ...agentCommands,
     ...twoFactorCommands,
     ...secrecyCommands,
     ...logsCommands,
     ...homeCommands,
-    ...mailCommands,
     ...notifyCommands,
     ...sharingCommands,
     ...liveCommands
@@ -68,16 +36,11 @@ export const featureCommandRegistry: Record<string, FeatureCommandDescriptor> =
 );
 
 /**
- * Verse les contrats d'un module installé dans le registre des commandes,
- * celui que le `ws.send` du client consulte avant tout envoi. Sans cet
- * enregistrement, chaque commande d'un module serait refusée côté client
- * (« Unknown command ») avant même d'atteindre la socket, et son interface
- * resterait en chargement pour toujours.
- *
- * Une native rapatriée déclare les MÊMES objets que le registre publié : la
- * réinscription à l'identique est un no-op. Deux contrats différents sous le
- * même nom, en revanche, sont une collision de config, et le chargement doit
- * le dire plutôt que d'en servir un des deux au hasard.
+ * Verse les contrats d'un module installé dans le registre des commandes, que
+ * le `ws.send` du client consulte avant tout envoi ; sans cela, chaque commande
+ * du module serait refusée côté client (« Unknown command »). Réinscrire les
+ * mêmes objets est un no-op ; deux contrats différents sous le même nom sont
+ * une collision de config, et le chargement doit le dire.
  */
 export function registerFeatureCommands(commands: readonly FeatureCommandDescriptor[]): void {
     for (const c of commands) {

package/src/features/secrecy.ts

@@ -55,15 +55,10 @@ export const secrecySetReauth = {
 };
 
 /**
- * Hold (or release) the cached DEK for the duration of an open action popup.
- *
- * `active: true` is a heartbeat: it pins the DEK so the sliding grace window
- * cannot flush it while the user composes a long action, and must be re-sent
- * periodically — the server only honours the hold for a short lease, so if the
- * popup vanishes for *any* reason (close, navigation, crash, disconnect) the
- * heartbeats stop and the DEK reverts to a normal countdown. `active: false`
- * releases the hold and restarts a fresh grace window. The DEK can therefore
- * never linger indefinitely: only a genuinely-still-open popup keeps it alive.
+ * Hold (or release) the cached DEK while an action popup is open. `active:
+ * true` is a heartbeat: the server honours the hold for a short lease only, so
+ * if the popup vanishes for any reason the DEK reverts to a normal countdown.
+ * `active: false` releases the hold and restarts a fresh grace window.
  */
 export const secrecyHold = {
     command: 'secrecy.hold' as const,

package/src/features/sharing.ts

@@ -8,16 +8,10 @@ import {
 } from '../domain/sharing';
 
 /**
- * Le partage d'un élément et ses restrictions par rôle.
- *
- * Un module transversal plutôt qu'un jeu de commandes par fonctionnalité : ce
- * que ces commandes prennent est toujours le même couple `(feature, itemId)`, et
- * les recopier par émetteur aurait reproduit exactement ce que l'unification des
- * notifications vient de défaire.
- *
- * L'autorisation ne peut pas être déclarative — la fonctionnalité visée est une
- * **donnée d'entrée**. Elle est vérifiée en tête de handler, comme pour
- * `notify.route*` et `device.setConfig`.
+ * Le partage d'un élément et ses restrictions par rôle. Un module transversal :
+ * ces commandes prennent toujours le même couple `(feature, itemId)`.
+ * L'autorisation ne peut pas être déclarative, la fonctionnalité visée étant
+ * une donnée d'entrée : elle est vérifiée en tête de handler.
  */
 
 /** Où cet élément est visible, et pourquoi il ne pourrait pas l'être. */
@@ -28,10 +22,8 @@ export const shareGet = {
 };
 
 /**
- * Projette (ou retire) l'élément dans un espace.
- *
- * Un seul espace par appel : la case de l'écran est la commande, ce qui rend
- * l'échec lisible — cocher une case qui échoue ne laisse pas les autres dans un
+ * Projette (ou retire) l'élément dans un espace. Un seul espace par appel : la
+ * case de l'écran est la commande, et un échec ne laisse pas les autres dans un
  * état incertain.
  */
 export const shareSet = {
@@ -44,13 +36,10 @@ export const shareSet = {
 };
 
 /**
- * Ce que chaque rôle d'un espace voit de cet élément — l'hérité et l'exception.
- *
- * `workspaceId` absent = l'espace actif. Renseigné, il vise n'importe quel
- * espace où l'élément est visible : c'est ce qui permet de régler, depuis
- * l'onglet Partage du domicile, ce que chaque fenêtre montre — sans changer
- * d'espace. L'appelant doit être membre de l'espace visé ; y **écrire** exige
- * d'y tenir `workspace.roles`.
+ * Ce que chaque rôle d'un espace voit de cet élément (l'hérité et l'exception).
+ * `workspaceId` absent = l'espace actif ; renseigné, n'importe quel espace où
+ * l'élément est visible. L'appelant doit en être membre ; y écrire exige
+ * `workspace.roles`.
  */
 export const itemGrantList = {
     command: 'share.grantList' as const,
@@ -60,11 +49,8 @@ export const itemGrantList = {
 
 /**
  * Abaisse (ou rétablit) ce qu'un rôle peut faire sur cet élément, dans l'espace
- * visé (`workspaceId` absent = l'actif).
- *
- * `access: null` **retire** la restriction : le rôle reprend ce que la
- * fonctionnalité lui donne. C'est l'absence de ligne qui exprime « rien de
- * particulier », pas une valeur.
+ * visé (`workspaceId` absent = l'actif). `access: null` retire la restriction :
+ * le rôle reprend ce que la fonctionnalité lui donne.
  */
 export const itemGrantSet = {
     command: 'share.grantSet' as const,

package/src/features/user.ts

@@ -31,10 +31,9 @@ export const THEME_IMAGE_MAX_LENGTH = 4_200_000;
 export const THEME_SLOT_COUNT = 5;
 
 /**
- * Upper bound on one saved slot value. Slots hold *compressed* data URLs (the
- * client downscales before saving) or a short raw URL, so this is a safety cap,
- * not the typical size — it keeps the whole theme JSON (5 slots + active image)
- * within the browser's localStorage budget and the `users.theme` column.
+ * Upper bound on one saved slot value (a compressed data URL or a short raw
+ * URL): a safety cap keeping the whole theme JSON (5 slots + active image)
+ * within the browser's localStorage budget and the theme column.
  */
 export const THEME_SLOT_IMAGE_MAX_LENGTH = 1_500_000;
 
@@ -74,13 +73,9 @@ export const userSetColor = {
 };
 
 /**
- * Pose ou retire un drapeau de compte. Une commande unique pour tous les
- * drapeaux plutôt qu'une par réglage : le serveur n'a alors qu'un seul chemin de
- * lecture-modification-écriture sur `users.settings`, et un nouveau drapeau ne
- * coûte qu'une entrée dans `userSettingFlagSchema`.
- *
- * La sortie renvoie le sac **complet** tel qu'il vient d'être écrit : le client
- * peut s'aligner dessus au lieu de rejouer sa propre arithmétique.
+ * Pose ou retire un drapeau de compte. Une commande pour tous les drapeaux :
+ * un seul chemin lecture-modification-écriture sur `users.settings`. La sortie
+ * renvoie le sac complet tel qu'il vient d'être écrit.
  */
 export const userSetSetting = {
     command: 'user.setSetting' as const,

package/src/features/workspace.ts

@@ -24,12 +24,9 @@ export const workspaceDelete = {
 
 /**
  * Bascule vers un espace : renvoie son apparence et sa disposition d'accueil.
- *
- * L'espace visé n'apparaît pas dans l'entrée — il voyage sur l'enveloppe, et le
- * dispatcheur a déjà vérifié l'appartenance avant d'appeler le handler. Passer
- * par `/api/auth/me` ne conviendrait pas : cette route recalcule l'espace actif à
- * partir du favori et renverrait l'apparence de l'espace qu'*elle* choisit, pas
- * de celui vers lequel on bascule.
+ * L'espace visé voyage sur l'enveloppe, appartenance vérifiée par le
+ * dispatcheur. `/api/auth/me` ne conviendrait pas : il recalcule l'espace actif
+ * à partir du favori.
  */
 export const workspaceActivate = {
     command: 'workspace.activate' as const,
@@ -77,11 +74,9 @@ export const workspaceRemoveMember = {
 };
 
 /**
- * Ajoute un membre à l'espace actif, désigné par son adresse.
- *
- * Pas de lien, pas d'acceptation : le compte existe déjà (l'inscription est sur
- * invitation d'un administrateur), donc le désigner suffit. Un lien serait un
- * détour — et un secret transmissible de plus à surveiller.
+ * Ajoute un membre à l'espace actif, désigné par son adresse. Pas de lien ni
+ * d'acceptation : le compte existe déjà (inscription sur invitation), et un
+ * lien serait un secret transmissible de plus.
  */
 export const workspaceAddMember = {
     command: 'workspace.addMember' as const,

package/src/http/auth.ts

@@ -6,13 +6,11 @@ import { workspacePermissionsSchema } from '../domain/workspaceRole';
 import { themeStateSchema } from '../features/user';
 
 /**
- * Contenu commun à `/login`, `/refresh` et `/me` : le compte, les espaces
- * auxquels il a accès, et **l'espace actif seul** — son thème et sa disposition
- * d'accueil.
- *
- * Le thème des autres espaces n'est délibérément pas embarqué : `bgImages` peut
- * contenir plusieurs data URLs, et les livrer tous multiplierait la charge utile
- * par le nombre d'espaces. Basculer d'espace va chercher les siens.
+ * Contenu commun à `/login`, `/refresh` et `/me` : le compte, ses espaces, et
+ * le thème et la disposition d'accueil de l'espace actif seul. Les thèmes des
+ * autres espaces ne sont pas embarqués : `bgImages` peut porter plusieurs data
+ * URLs, et les livrer tous multiplierait la charge utile par le nombre
+ * d'espaces.
  */
 export const sessionBundleSchema = z.object({
     user: userSchema,
@@ -34,12 +32,7 @@ export const loginRequestSchema = z.object({
 
 export type LoginRequest = z.infer<typeof loginRequestSchema>;
 
-/**
- * L'inscription n'est plus libre : elle exige un jeton d'invitation émis par un
- * administrateur. La route existait déjà, ouverte à tous et connectant
- * automatiquement — simplement inatteignable depuis l'interface, ce qui n'est
- * pas une protection.
- */
+/** L'inscription exige un jeton d'invitation émis par un administrateur. */
 export const registerRequestSchema = z.object({
     inviteToken: z.string().min(1),
     username: z

package/src/http/device.ts

@@ -23,15 +23,14 @@ export const LINK_CODE_TTL_MAX_SECONDS = 30 * 24 * 60 * 60;
 export const linkCodeRequestSchema = z.object({
     ttlSeconds: z.number().int().positive().max(LINK_CODE_TTL_MAX_SECONDS).nullable().optional(),
     /**
-     * Approve the device automatically the moment it enrols with this code,
-     * instead of leaving it `pending` for manual approval. Defaults to `false`
-     * (manual approval stays the safe default).
+     * Approve the device the moment it enrols with this code, instead of
+     * leaving it `pending` for manual approval. Defaults to `false`.
      */
     autoApprove: z.boolean().default(false),
     /**
      * Espace dans lequel la machine sera rangée à l'enrôlement. Omis → l'espace
-     * personnel de l'émetteur. L'émetteur doit en être membre : appairer une
-     * machine dans un espace où l'on n'entre pas n'aurait aucun sens.
+     * actif de l'émetteur. Explicite (n'importe quel espace existant) : réservé
+     * à l'administrateur global.
      */
     workspaceId: z.number().int().positive().optional()
 });
@@ -84,13 +83,11 @@ export const enrollDeviceResponseSchema = z.object({
 export type EnrollDeviceResponse = z.infer<typeof enrollDeviceResponseSchema>;
 
 /**
- * Agent download matrix — the **single source of truth** for the set of
- * platform binaries shipped with a release. Consumed by:
- *  - the web UI (the "Télécharger l'agent" two-step picker), and
- *  - the server (validates the `:target` param and resolves the file on disk).
- *
- * The CI release workflow and `agent/build-all.sh` mirror the same labels (they
- * can't import TS) — keep all three in sync when adding/removing a target.
+ * Agent download matrix: the single source of truth for the platform binaries
+ * shipped with a release, consumed by the web UI picker and the server
+ * (`:target` validation, file lookup). The CI release workflow and
+ * `agent/build-all.sh` mirror the same labels: keep all three in sync when
+ * adding or removing a target.
  */
 export const agentTargetSchema = z.enum([
     'linux-x86_64',
@@ -203,11 +200,10 @@ export const agentManifestTargetSchema = z.object({
     sha256: z.string().regex(/^[a-f0-9]{64}$/),
     size: z.number().int().nonnegative(),
     /**
-     * Base64 ed25519 signature over the 32 raw bytes of `sha256`, produced by the
-     * CI release with the dedicated update-signing key. The agent verifies it with
-     * its embedded public key before self-replacing. **Optional**: a target with no
-     * signature stays manually downloadable but can never drive a self-update — so a
-     * pre-signing build degrades cleanly instead of being rejected outright.
+     * Base64 ed25519 signature over the 32 raw bytes of `sha256`, made by the CI
+     * release with the update-signing key; the agent verifies it with its
+     * embedded public key before self-replacing. Optional: an unsigned target
+     * stays downloadable but can never drive a self-update.
      */
     signature: z.string().min(1).optional()
 });

package/src/http/status.ts

@@ -1,19 +1,15 @@
 import { z } from 'zod';
 
 /**
- * Server readiness / boot status (HTTP, `GET /api/status`).
- *
- * Surfaces the deployment/startup tasks the server runs before it is "100%
- * ready" — today just the agent-binary reconcile, but the shape is a generic
- * task list so more steps can be added later. The web client shows a discreet
- * topbar zone while `ready` is false, then hides it for good.
+ * Server readiness / boot status (HTTP, `GET /api/status`): the startup tasks
+ * the server runs before it is fully ready, as a generic task list. The web
+ * client shows a topbar zone while `ready` is false.
  */
 
 /**
- * `warning` is a terminal-but-visible outcome: the step finished without fully
- * succeeding, yet the app is usable (e.g. the agent reconcile served an older set
- * because this deploy's build never landed). It keeps the topbar zone shown — like
- * `error` — but reads as a non-blocking caution rather than a hard failure.
+ * `warning` is terminal but visible: the step finished without fully succeeding
+ * (e.g. the agent reconcile served an older set), the app is usable, and the
+ * topbar zone stays shown as a non-blocking caution.
  */
 export const bootTaskStateSchema = z.enum(['pending', 'running', 'done', 'warning', 'error']);
 export type BootTaskState = z.infer<typeof bootTaskStateSchema>;