feedkeeper 0.29.0 → 0.30.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedkeeper",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "description": "A lightweight, self-hosted RSS reader and remote MCP server for your news, blogs, and AI workflows.",
   "keywords": [
     "rss",

package/server/dist/api/v1/index.js

@@ -39,6 +39,7 @@ const FEATURES = [
     "edition.revisions",
     "native-preferences",
     "native-preferences.edition-size",
+    "native-preferences.client-settings",
     "edition.overview",
     "edition.layout",
     "search.fts",

package/server/dist/native/preferences.js

@@ -12,6 +12,11 @@ const timezone = z.string().max(100).refine((value) => {
         return false;
     }
 }, "Use an IANA time zone");
+/** Reverse-DNS style names keep clients from overwriting each other's documents. */
+const clientNamespace = z.string().regex(/^[a-z0-9]+([.-][a-z0-9]+)+$/).max(64);
+const CLIENT_DOCUMENT_BYTES = 16 * 1024;
+const clientDocument = z.record(z.string(), z.unknown()).refine((value) => Buffer.byteLength(JSON.stringify(value)) <= CLIENT_DOCUMENT_BYTES, "Document too large");
+const clientSettingsPatch = z.record(clientNamespace, clientDocument.nullable()).refine((value) => Object.keys(value).length <= 8, "Too many namespaces");
 export const preferenceFields = {
     timeZone: timezone,
     editionSize: z.number().int().min(1).max(24).nullable(),
@@ -20,6 +25,8 @@ export const preferenceFields = {
     hiddenFolderIds: distinctIds,
     preferredFolderIds: distinctIds,
     showUnfiled: z.boolean(),
+    /** Opaque documents per client namespace; a null document removes the namespace. */
+    clientSettings: clientSettingsPatch,
 };
 export const preferencePatchSchema = z.object(preferenceFields).partial().extend({
     requestId: z.uuid(),
@@ -28,6 +35,7 @@ export const preferencePatchSchema = z.object(preferenceFields).partial().extend
 const defaults = {
     timeZone: "UTC", editionSize: 24, editionSizeIsCustom: false, readingMinutes: null,
     folderOrder: [], hiddenFolderIds: [], preferredFolderIds: [], showUnfiled: true,
+    clientSettings: {},
 };
 export function getNativePreferences(userId) {
     const row = db.prepare("SELECT revision, settings, updated_at FROM native_preferences WHERE user_id = ?").get(userId);
@@ -50,6 +58,18 @@ export function patchNativePreferences(userId, input) {
             if (ids?.some((id) => id !== null && !ownedIds.has(id)))
                 throw new NativeError("folder_not_found", 404);
         }
+        if (patch.clientSettings) {
+            const merged = { ...current.clientSettings };
+            for (const [name, document] of Object.entries(patch.clientSettings)) {
+                if (document === null)
+                    delete merged[name];
+                else
+                    merged[name] = document;
+            }
+            if (Object.keys(merged).length > 8)
+                throw new NativeError("invalid_input");
+            patch.clientSettings = merged;
+        }
         const { revision, updatedAt: _updatedAt, ...settings } = current;
         const next = { ...settings, ...patch, editionSize: patch.editionSize === null ? defaults.editionSize : patch.editionSize ?? current.editionSize,
             editionSizeIsCustom: patch.editionSize === undefined ? current.editionSizeIsCustom : patch.editionSize !== null };

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feedkeeper/server",
-  "version": "0.29.0",
+  "version": "0.30.0",
   "private": true,
   "type": "module"
 }