@threadbase-sh/streamer 1.57.0 → 1.58.0

package/dist/index.d.cts

@@ -1204,6 +1204,11 @@ interface DeviceRow {
     created_at: number;
     last_seen_at: number | null;
     revoked_at: number | null;
+    /** Noise static public key, base64. Null on every row that predates E2EE. */
+    e2ee_static_pub: string | null;
+    /** The downgrade lock. 1 once this device has completed a handshake. */
+    e2ee_required: number;
+    e2ee_version: number | null;
 }
 /** A device as reported over the API. Deliberately carries no credential. */
 interface DeviceView {
@@ -1213,6 +1218,16 @@ interface DeviceView {
     createdAt: number;
     lastSeenAt: number | null;
     revokedAt: number | null;
+    /**
+     * Whether this device is pinned to encryption.
+     *
+     * A boolean, never the key and never a hash of it: `GET /api/devices` exists
+     * so a user can spot a device they did not pair, and answering "is this one
+     * encrypted" needs no key material to do it. Publishing the static key would
+     * hand an attacker who reached this endpoint the value that identifies a
+     * device.
+     */
+    e2ee: boolean;
 }
 interface RegisteredDevice {
     deviceId: string;
@@ -1229,6 +1244,8 @@ declare class DevicesRepository {
     private touchStmt;
     private deleteStmt;
     private deleteRevokedStmt;
+    private byE2eeStaticPubStmt;
+    private repairStmt;
     constructor(db: Database.Database);
     /**
      * Record a newly paired device and mint its token.
@@ -1241,7 +1258,16 @@ declare class DevicesRepository {
         name?: string | null;
         preset?: CapabilityPreset;
         now?: number;
+        /**
+         * The device's Noise static public key, base64, when pairing completed a
+         * handshake. Absent on a plaintext pairing, which stays exactly as it is
+         * today: no key, no pin, no behaviour change.
+         */
+        e2eeStaticPub?: string;
+        e2eeVersion?: number;
     }): RegisteredDevice;
+    /** The device that owns a Noise static key, or null. */
+    getByE2eeStaticPub(staticPub: string): DeviceRow | null;
     /**
      * Resolve a presented token to a device, or null.
      *

package/dist/index.d.ts

@@ -1204,6 +1204,11 @@ interface DeviceRow {
     created_at: number;
     last_seen_at: number | null;
     revoked_at: number | null;
+    /** Noise static public key, base64. Null on every row that predates E2EE. */
+    e2ee_static_pub: string | null;
+    /** The downgrade lock. 1 once this device has completed a handshake. */
+    e2ee_required: number;
+    e2ee_version: number | null;
 }
 /** A device as reported over the API. Deliberately carries no credential. */
 interface DeviceView {
@@ -1213,6 +1218,16 @@ interface DeviceView {
     createdAt: number;
     lastSeenAt: number | null;
     revokedAt: number | null;
+    /**
+     * Whether this device is pinned to encryption.
+     *
+     * A boolean, never the key and never a hash of it: `GET /api/devices` exists
+     * so a user can spot a device they did not pair, and answering "is this one
+     * encrypted" needs no key material to do it. Publishing the static key would
+     * hand an attacker who reached this endpoint the value that identifies a
+     * device.
+     */
+    e2ee: boolean;
 }
 interface RegisteredDevice {
     deviceId: string;
@@ -1229,6 +1244,8 @@ declare class DevicesRepository {
     private touchStmt;
     private deleteStmt;
     private deleteRevokedStmt;
+    private byE2eeStaticPubStmt;
+    private repairStmt;
     constructor(db: Database.Database);
     /**
      * Record a newly paired device and mint its token.
@@ -1241,7 +1258,16 @@ declare class DevicesRepository {
         name?: string | null;
         preset?: CapabilityPreset;
         now?: number;
+        /**
+         * The device's Noise static public key, base64, when pairing completed a
+         * handshake. Absent on a plaintext pairing, which stays exactly as it is
+         * today: no key, no pin, no behaviour change.
+         */
+        e2eeStaticPub?: string;
+        e2eeVersion?: number;
     }): RegisteredDevice;
+    /** The device that owns a Noise static key, or null. */
+    getByE2eeStaticPub(staticPub: string): DeviceRow | null;
     /**
      * Resolve a presented token to a device, or null.
      *

package/dist/index.js

@@ -4135,7 +4135,12 @@ function toDeviceView(row) {
     capabilities: parseCapabilities(row.capabilities),
     createdAt: row.created_at,
     lastSeenAt: row.last_seen_at,
-    revokedAt: row.revoked_at
+    revokedAt: row.revoked_at,
+    // Reported from `e2ee_required` rather than from the key's presence. The
+    // two agree today, but they answer different questions — the key is what a
+    // handshake is checked against, `e2ee_required` is whether plaintext is
+    // refused — and it is the second one a user is asking about.
+    e2ee: row.e2ee_required === 1
   };
 }
 var DevicesRepository = class {
@@ -4147,14 +4152,30 @@ var DevicesRepository = class {
   touchStmt;
   deleteStmt;
   deleteRevokedStmt;
+  byE2eeStaticPubStmt;
+  repairStmt;
   constructor(db) {
     this.insertStmt = db.prepare(`
       INSERT INTO devices (
-        device_id, public_key, token_hash, name, capabilities, created_at
+        device_id, public_key, token_hash, name, capabilities, created_at,
+        e2ee_static_pub, e2ee_required, e2ee_version
       ) VALUES (
-        @device_id, @public_key, @token_hash, @name, @capabilities, @created_at
+        @device_id, @public_key, @token_hash, @name, @capabilities, @created_at,
+        @e2ee_static_pub, @e2ee_required, @e2ee_version
       )
     `);
+    this.byE2eeStaticPubStmt = db.prepare("SELECT * FROM devices WHERE e2ee_static_pub = ?");
+    this.repairStmt = db.prepare(`
+      UPDATE devices SET
+        public_key = @public_key,
+        token_hash = @token_hash,
+        name = @name,
+        capabilities = @capabilities,
+        e2ee_required = 1,
+        e2ee_version = @e2ee_version,
+        revoked_at = NULL
+      WHERE device_id = @device_id
+    `);
     this.byTokenHashStmt = db.prepare("SELECT * FROM devices WHERE token_hash = ?");
     this.byIdStmt = db.prepare("SELECT * FROM devices WHERE device_id = ?");
     this.listStmt = db.prepare("SELECT * FROM devices ORDER BY created_at DESC");
@@ -4170,19 +4191,42 @@ var DevicesRepository = class {
    * moment it exists outside the client.
    */
   register(args) {
-    const deviceId = randomUUID3();
     const deviceToken = generateDeviceToken();
     const capabilities = capabilitiesForPreset(args.preset ?? "full");
+    const now = args.now ?? Date.now();
+    const existing = args.e2eeStaticPub ? this.byE2eeStaticPubStmt.get(args.e2eeStaticPub) : void 0;
+    if (existing) {
+      this.repairStmt.run({
+        device_id: existing.device_id,
+        public_key: args.publicKey,
+        token_hash: hashDeviceToken(deviceToken),
+        name: args.name ?? null,
+        capabilities: JSON.stringify(capabilities),
+        e2ee_version: args.e2eeVersion ?? null
+      });
+      return { deviceId: existing.device_id, deviceToken, capabilities };
+    }
+    const deviceId = randomUUID3();
     this.insertStmt.run({
       device_id: deviceId,
       public_key: args.publicKey,
       token_hash: hashDeviceToken(deviceToken),
       name: args.name ?? null,
       capabilities: JSON.stringify(capabilities),
-      created_at: args.now ?? Date.now()
+      created_at: now,
+      e2ee_static_pub: args.e2eeStaticPub ?? null,
+      // The downgrade lock, set in the same write that records the key. Once
+      // set, nothing a client can send clears it (design.md §6.3) — which is
+      // what makes it a lock rather than a preference.
+      e2ee_required: args.e2eeStaticPub ? 1 : 0,
+      e2ee_version: args.e2eeVersion ?? null
     });
     return { deviceId, deviceToken, capabilities };
   }
+  /** The device that owns a Noise static key, or null. */
+  getByE2eeStaticPub(staticPub) {
+    return this.byE2eeStaticPubStmt.get(staticPub) ?? null;
+  }
   /**
    * Resolve a presented token to a device, or null.
    *