aimeat 1.5.0 → 1.7.0

package/dist/src/routes/sharing-groups.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file sharing-groups.ts
+ * @description REST endpoints for Sharing Group CRUD and member management
+ * @structure
+ *   - POST   /v1/groups              -- Create group
+ *   - GET    /v1/groups              -- List own + member-of groups
+ *   - GET    /v1/groups/:id          -- Get group detail
+ *   - PATCH  /v1/groups/:id          -- Update group
+ *   - DELETE /v1/groups/:id          -- Delete group
+ *   - POST   /v1/groups/:id/members  -- Add member
+ *   - PATCH  /v1/groups/:id/members/:identifier -- Update member permissions
+ *   - DELETE /v1/groups/:id/members/:identifier -- Remove member
+ * @version-history
+ *   v1.0.0 -- 2026-05-21 -- Initial creation for Agent Dashboard Phase 1
+ */
+import { Router } from 'express';
+import type { AimeatConfig } from '../config.js';
+import type { Storage } from '../storage/interface.js';
+export declare function sharingGroupsRouter(config: AimeatConfig, storage: Storage): Router;
+//# sourceMappingURL=sharing-groups.d.ts.map

package/dist/src/routes/sharing-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharing-groups.d.ts","sourceRoot":"","sources":["../../../src/routes/sharing-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,yBAAyB,CAAC;AAY3E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAyUlF"}

package/dist/src/routes/sharing-groups.js

@@ -0,0 +1,297 @@
+/**
+ * @file sharing-groups.ts
+ * @description REST endpoints for Sharing Group CRUD and member management
+ * @structure
+ *   - POST   /v1/groups              -- Create group
+ *   - GET    /v1/groups              -- List own + member-of groups
+ *   - GET    /v1/groups/:id          -- Get group detail
+ *   - PATCH  /v1/groups/:id          -- Update group
+ *   - DELETE /v1/groups/:id          -- Delete group
+ *   - POST   /v1/groups/:id/members  -- Add member
+ *   - PATCH  /v1/groups/:id/members/:identifier -- Update member permissions
+ *   - DELETE /v1/groups/:id/members/:identifier -- Remove member
+ * @version-history
+ *   v1.0.0 -- 2026-05-21 -- Initial creation for Agent Dashboard Phase 1
+ */
+import { Router } from 'express';
+import { v4 as uuidv4 } from 'uuid';
+import { success, error } from '../middleware/envelope.js';
+import { requireAuth, requireRole } from '../auth/middleware.js';
+import { resolveIdentity } from '../utils/gaii.js';
+import { emitChange } from '../services/event-bus.js';
+import { SharingGroupCreateSchema, SharingGroupUpdateSchema, SharingGroupAddMemberSchema, SharingGroupUpdateMemberSchema, } from '../models/sharing-group-schemas.js';
+export function sharingGroupsRouter(config, storage) {
+    const router = Router();
+    /** Resolve effective identity -- owner sessions use GHII, agents use GAII */
+    const resolve = (req) => resolveIdentity(req.auth, config.nodeId);
+    /* ── POST /v1/groups -- Create a sharing group ── */
+    router.post('/v1/groups', requireAuth(), requireRole('owner'), async (req, res) => {
+        const ownerGaii = resolve(req);
+        const parsed = SharingGroupCreateSchema.safeParse(req.body);
+        if (!parsed.success) {
+            res.status(400).json(error(config.nodeId, 'INVALID_INPUT', parsed.error.issues.map(i => i.message).join(', ')));
+            return;
+        }
+        const { name, description, members, default_permissions } = parsed.data;
+        // Max 50 groups per owner
+        const existing = await storage.listSharingGroups(ownerGaii);
+        if (existing.length >= 50) {
+            res.status(409).json(error(config.nodeId, 'LIMIT_REACHED', 'Maximum 50 sharing groups per owner'));
+            return;
+        }
+        const now = new Date().toISOString();
+        const id = uuidv4();
+        // Convert members from request format (identifier_type) to storage format (identifierType)
+        const storageMbers = members.map(m => ({
+            identifier: m.identifier,
+            identifierType: m.identifier_type,
+            permissions: m.permissions ?? default_permissions,
+            addedAt: now,
+            addedBy: ownerGaii,
+        }));
+        const record = await storage.createSharingGroup({
+            id,
+            name: name.trim(),
+            description: description?.trim(),
+            ownerGaii,
+            members: storageMbers,
+            defaultPermissions: default_permissions,
+            createdAt: now,
+            updatedAt: now,
+        });
+        res.status(201).json(success(config.nodeId, { group: record }, [
+            { description: 'View group', method: 'GET', url: `/v1/groups/${id}` },
+            { description: 'Add member', method: 'POST', url: `/v1/groups/${id}/members` },
+        ]));
+        emitChange('groups');
+    });
+    /* ── GET /v1/groups -- List own + member-of groups ── */
+    router.get('/v1/groups', requireAuth(), async (req, res) => {
+        const isOwnerSession = req.auth.roles.includes('owner') && !req.auth.roles.includes('agent');
+        const identity = resolve(req);
+        let groups;
+        if (isOwnerSession) {
+            // Owner sees their owned groups + groups where they are a member
+            const ownerGhii = `${req.auth.owner}@${config.nodeId}`;
+            const owned = await storage.listSharingGroups(ownerGhii);
+            const memberOf = await storage.listSharingGroupsByMember(ownerGhii);
+            // Merge and deduplicate by id
+            const seen = new Set(owned.map(g => g.id));
+            groups = [...owned];
+            for (const g of memberOf) {
+                if (!seen.has(g.id)) {
+                    groups.push(g);
+                    seen.add(g.id);
+                }
+            }
+        }
+        else {
+            // Agent sees groups where it is a member
+            groups = await storage.listSharingGroupsByMember(identity);
+        }
+        res.json(success(config.nodeId, { groups, total: groups.length }));
+    });
+    /* ── GET /v1/groups/:id -- Get group detail ── */
+    router.get('/v1/groups/:id', requireAuth(), async (req, res) => {
+        const id = req.params.id;
+        const identity = resolve(req);
+        const group = await storage.getSharingGroup(id);
+        if (!group) {
+            res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'Sharing group not found'));
+            return;
+        }
+        // Must be owner or member
+        const isOwner = group.ownerGaii === identity;
+        const isMember = group.members.some(m => m.identifier === identity);
+        // For owner sessions, also check if the bare owner matches
+        const isOwnerSession = req.auth.roles.includes('owner') && !req.auth.roles.includes('agent');
+        const ownerGhii = isOwnerSession ? `${req.auth.owner}@${config.nodeId}` : null;
+        const isOwnerByGhii = ownerGhii ? group.ownerGaii === ownerGhii : false;
+        const isMemberByGhii = ownerGhii ? group.members.some(m => m.identifier === ownerGhii) : false;
+        if (!isOwner && !isMember && !isOwnerByGhii && !isMemberByGhii) {
+            res.status(403).json(error(config.nodeId, 'ACCESS_DENIED', 'You are not a member of this group'));
+            return;
+        }
+        res.json(success(config.nodeId, { group }));
+    });
+    /* ── PATCH /v1/groups/:id -- Update group ── */
+    router.patch('/v1/groups/:id', requireAuth(), requireRole('owner'), async (req, res) => {
+        const id = req.params.id;
+        const ownerGaii = resolve(req);
+        const group = await storage.getSharingGroup(id);
+        if (!group) {
+            res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'Sharing group not found'));
+            return;
+        }
+        if (group.ownerGaii !== ownerGaii) {
+            res.status(403).json(error(config.nodeId, 'ACCESS_DENIED', 'Only the group owner can update'));
+            return;
+        }
+        const parsed = SharingGroupUpdateSchema.safeParse(req.body);
+        if (!parsed.success) {
+            res.status(400).json(error(config.nodeId, 'INVALID_INPUT', parsed.error.issues.map(i => i.message).join(', ')));
+            return;
+        }
+        const updates = { updatedAt: new Date().toISOString() };
+        if (parsed.data.name !== undefined)
+            updates.name = parsed.data.name.trim();
+        if (parsed.data.description !== undefined)
+            updates.description = parsed.data.description.trim();
+        if (parsed.data.default_permissions !== undefined)
+            updates.defaultPermissions = parsed.data.default_permissions;
+        const updated = await storage.updateSharingGroup(id, updates);
+        if (!updated) {
+            res.status(500).json(error(config.nodeId, 'INTERNAL', 'Failed to update group'));
+            return;
+        }
+        res.json(success(config.nodeId, { group: updated }));
+        emitChange('groups');
+    });
+    /* ── DELETE /v1/groups/:id -- Delete group ── */
+    router.delete('/v1/groups/:id', requireAuth(), requireRole('owner'), async (req, res) => {
+        const id = req.params.id;
+        const ownerGaii = resolve(req);
+        const group = await storage.getSharingGroup(id);
+        if (!group) {
+            res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'Sharing group not found'));
+            return;
+        }
+        if (group.ownerGaii !== ownerGaii) {
+            res.status(403).json(error(config.nodeId, 'ACCESS_DENIED', 'Only the group owner can delete'));
+            return;
+        }
+        // Check if any memory entries reference this group
+        const refCount = await storage.countEntriesReferencingGroup(id);
+        await storage.deleteSharingGroup(id);
+        res.json(success(config.nodeId, {
+            deleted: true,
+            warning: refCount > 0
+                ? `${refCount} memory entries referenced this group and will fall back to private visibility`
+                : undefined,
+        }));
+        emitChange('groups');
+    });
+    /* ── POST /v1/groups/:id/members -- Add member ── */
+    router.post('/v1/groups/:id/members', requireAuth(), requireRole('owner'), async (req, res) => {
+        const id = req.params.id;
+        const ownerGaii = resolve(req);
+        const group = await storage.getSharingGroup(id);
+        if (!group) {
+            res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'Sharing group not found'));
+            return;
+        }
+        if (group.ownerGaii !== ownerGaii) {
+            res.status(403).json(error(config.nodeId, 'ACCESS_DENIED', 'Only the group owner can add members'));
+            return;
+        }
+        if (group.members.length >= 100) {
+            res.status(409).json(error(config.nodeId, 'LIMIT_REACHED', 'Maximum 100 members per group'));
+            return;
+        }
+        const parsed = SharingGroupAddMemberSchema.safeParse(req.body);
+        if (!parsed.success) {
+            res.status(400).json(error(config.nodeId, 'INVALID_INPUT', parsed.error.issues.map(i => i.message).join(', ')));
+            return;
+        }
+        const { identifier, identifier_type, permissions } = parsed.data;
+        // Check for duplicate
+        if (group.members.some(m => m.identifier === identifier)) {
+            res.status(409).json(error(config.nodeId, 'DUPLICATE', 'Member already exists in this group'));
+            return;
+        }
+        const now = new Date().toISOString();
+        const newMember = {
+            identifier,
+            identifierType: identifier_type,
+            permissions: permissions ?? group.defaultPermissions,
+            addedAt: now,
+            addedBy: ownerGaii,
+        };
+        const updatedMembers = [...group.members, newMember];
+        const updated = await storage.updateSharingGroup(id, {
+            members: updatedMembers,
+            updatedAt: now,
+        });
+        if (!updated) {
+            res.status(500).json(error(config.nodeId, 'INTERNAL', 'Failed to add member'));
+            return;
+        }
+        res.status(201).json(success(config.nodeId, { group: updated, added: newMember }));
+        emitChange('groups');
+    });
+    /* ── PATCH /v1/groups/:id/members/:identifier -- Update member permissions ── */
+    router.patch('/v1/groups/:id/members/:identifier', requireAuth(), requireRole('owner'), async (req, res) => {
+        const id = req.params.id;
+        const identifier = req.params.identifier;
+        const ownerGaii = resolve(req);
+        const group = await storage.getSharingGroup(id);
+        if (!group) {
+            res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'Sharing group not found'));
+            return;
+        }
+        if (group.ownerGaii !== ownerGaii) {
+            res.status(403).json(error(config.nodeId, 'ACCESS_DENIED', 'Only the group owner can update members'));
+            return;
+        }
+        const parsed = SharingGroupUpdateMemberSchema.safeParse(req.body);
+        if (!parsed.success) {
+            res.status(400).json(error(config.nodeId, 'INVALID_INPUT', parsed.error.issues.map(i => i.message).join(', ')));
+            return;
+        }
+        const memberIdx = group.members.findIndex(m => m.identifier === identifier);
+        if (memberIdx === -1) {
+            res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'Member not found in this group'));
+            return;
+        }
+        const updatedMembers = [...group.members];
+        updatedMembers[memberIdx] = {
+            ...updatedMembers[memberIdx],
+            permissions: parsed.data.permissions,
+        };
+        const now = new Date().toISOString();
+        const updated = await storage.updateSharingGroup(id, {
+            members: updatedMembers,
+            updatedAt: now,
+        });
+        if (!updated) {
+            res.status(500).json(error(config.nodeId, 'INTERNAL', 'Failed to update member'));
+            return;
+        }
+        res.json(success(config.nodeId, { group: updated }));
+        emitChange('groups');
+    });
+    /* ── DELETE /v1/groups/:id/members/:identifier -- Remove member ── */
+    router.delete('/v1/groups/:id/members/:identifier', requireAuth(), requireRole('owner'), async (req, res) => {
+        const id = req.params.id;
+        const identifier = req.params.identifier;
+        const ownerGaii = resolve(req);
+        const group = await storage.getSharingGroup(id);
+        if (!group) {
+            res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'Sharing group not found'));
+            return;
+        }
+        if (group.ownerGaii !== ownerGaii) {
+            res.status(403).json(error(config.nodeId, 'ACCESS_DENIED', 'Only the group owner can remove members'));
+            return;
+        }
+        const memberIdx = group.members.findIndex(m => m.identifier === identifier);
+        if (memberIdx === -1) {
+            res.status(404).json(error(config.nodeId, 'NOT_FOUND', 'Member not found in this group'));
+            return;
+        }
+        const updatedMembers = group.members.filter(m => m.identifier !== identifier);
+        const now = new Date().toISOString();
+        const updated = await storage.updateSharingGroup(id, {
+            members: updatedMembers,
+            updatedAt: now,
+        });
+        if (!updated) {
+            res.status(500).json(error(config.nodeId, 'INTERNAL', 'Failed to remove member'));
+            return;
+        }
+        res.json(success(config.nodeId, { group: updated, removed: identifier }));
+        emitChange('groups');
+    });
+    return router;
+}
+//# sourceMappingURL=sharing-groups.js.map

package/dist/src/routes/sharing-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharing-groups.js","sourceRoot":"","sources":["../../../src/routes/sharing-groups.ts"],"names":[],"mappings":"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"}

package/dist/src/routes/stats.d.ts

@@ -1,3 +1,17 @@
+/**
+ * @file stats.ts
+ * @description Stats and metrics route handlers. Serves node statistics at GET /v1/stats
+ *   (with optional from/to time-range filtering) and Prometheus metrics at GET /v1/metrics.
+ * @structure
+ *   - statsRouter() -- Express router factory for /v1/stats and /v1/metrics
+ * @usage
+ *   import { statsRouter } from '../routes/stats.js';
+ *   app.use(statsRouter(config, storage, stats, metricsRegistry));
+ * @version-history
+ *   v1.0.0 -- 2026-05-01 -- Initial stats route with consent permission breakdown
+ *   v1.1.0 -- 2026-05-21 -- Add time-range support (from/to query params), gauges, daily field
+ *   v1.1.1 -- 2026-05-21 -- Fix range response to return same flat shape as full snapshot
+ */
 import { Router } from 'express';
 import type { Registry } from 'prom-client';
 import type { AimeatConfig } from '../config.js';

package/dist/src/routes/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/routes/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,cAAc,EACrB,eAAe,CAAC,EAAE,QAAQ,GACzB,MAAM,CA8FR"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/routes/stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,cAAc,EACrB,eAAe,CAAC,EAAE,QAAQ,GACzB,MAAM,CAiKR"}

package/dist/src/routes/stats.js

@@ -1,3 +1,17 @@
+/**
+ * @file stats.ts
+ * @description Stats and metrics route handlers. Serves node statistics at GET /v1/stats
+ *   (with optional from/to time-range filtering) and Prometheus metrics at GET /v1/metrics.
+ * @structure
+ *   - statsRouter() -- Express router factory for /v1/stats and /v1/metrics
+ * @usage
+ *   import { statsRouter } from '../routes/stats.js';
+ *   app.use(statsRouter(config, storage, stats, metricsRegistry));
+ * @version-history
+ *   v1.0.0 -- 2026-05-01 -- Initial stats route with consent permission breakdown
+ *   v1.1.0 -- 2026-05-21 -- Add time-range support (from/to query params), gauges, daily field
+ *   v1.1.1 -- 2026-05-21 -- Fix range response to return same flat shape as full snapshot
+ */
 import { Router } from 'express';
 import { success, error } from '../middleware/envelope.js';
 export function statsRouter(config, storage, stats, metricsRegistry) {
@@ -50,12 +64,10 @@ export function statsRouter(config, storage, stats, metricsRegistry) {
             }
             catch { /* skip owners without consents */ }
         }
-        res.json(success(config.nodeId, {
-            node_id: config.nodeId,
-            ...snap,
+        // Shared fields included in both response paths
+        const shared = {
             active_owners: owners.length,
             active_agents: agents.length,
-            // Push notification status (REQ-007)
             push_notifications: {
                 enabled: config.pushEnabled && !!config.vapidPublicKey,
                 personal_node_support: config.personalNodesEnabled,
@@ -70,6 +82,69 @@ export function statsRouter(config, storage, stats, metricsRegistry) {
                 by_wildcard: permStats.by_wildcard,
                 unique_patterns: permStats.unique_patterns.size,
             },
+        };
+        // Point-in-time gauges (always from current snapshot, not summable)
+        const gauges = {
+            tunnel_connections_active: snap.tunnel.connections_active,
+            mailbox_items_total: snap.mailbox.items_total,
+            mailbox_bytes_total: snap.mailbox.bytes_total,
+            mailbox_oldest_item_age_seconds: snap.mailbox.oldest_item_age_seconds,
+        };
+        // Time-range filtering: if both from and to are provided, return range data
+        const fromParam = req.query.from;
+        const toParam = req.query.to;
+        if (fromParam && toParam) {
+            const range = stats.snapshotForRange(fromParam, toParam);
+            // Return the same flat shape as the full snapshot so the frontend
+            // can render both responses identically.  Counter fields default to
+            // 0 for the range (no activity = 0, not the cumulative total).
+            // Live state (tunnel, mailbox, uptime) comes from the full snapshot.
+            const rangeCounters = {
+                requests_total: 0,
+                memory_writes: 0,
+                memory_reads: 0,
+                consent_grants: 0,
+                consent_revocations: 0,
+                schema_validations: 0,
+                schema_validation_failures: 0,
+                auth_failures_total: 0,
+                rate_limit_hits_total: 0,
+                scope_denials_total: 0,
+                ...range.totals,
+            };
+            res.json(success(config.nodeId, {
+                node_id: config.nodeId,
+                from: fromParam,
+                to: toParam,
+                uptime_seconds: snap.uptime_seconds,
+                started_at: snap.started_at,
+                requests_by_method: snap.requests_by_method,
+                requests_by_status: snap.requests_by_status,
+                tunnel: snap.tunnel,
+                mailbox: snap.mailbox,
+                ...rangeCounters,
+                daily_history: range.daily,
+                daily: range.daily,
+                gauges,
+                ...shared,
+            }));
+            return;
+        }
+        // Default: full snapshot (backward compatible) with gauges and daily
+        const dailyCutoff = new Date();
+        dailyCutoff.setDate(dailyCutoff.getDate() - 30);
+        const dailyCutoffStr = dailyCutoff.toISOString().split('T')[0];
+        const daily = {};
+        for (const [day, counters] of Object.entries(snap.daily_history)) {
+            if (day >= dailyCutoffStr)
+                daily[day] = counters;
+        }
+        res.json(success(config.nodeId, {
+            node_id: config.nodeId,
+            ...snap,
+            gauges,
+            daily,
+            ...shared,
         }));
     });
     router.get('/v1/metrics', async (req, res) => {

package/dist/src/routes/stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/routes/stats.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/routes/stats.ts"],"names":[],"mappings":"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"}

package/dist/src/routes/storage-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-files.d.ts","sourceRoot":"","sources":["../../../src/routes/storage-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AA2BvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAihBjF"}
+{"version":3,"file":"storage-files.d.ts","sourceRoot":"","sources":["../../../src/routes/storage-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AA2BvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAwhBjF"}

package/dist/src/routes/storage-files.js

@@ -36,8 +36,11 @@ export function storageFilesRouter(config, storage) {
         let visibility;
         let fileData;
         let mimeType;
+        let federateFlag = false;
+        let groupId;
         if (contentType.includes('application/json')) {
-            const { key: k, visibility: v, data, mime_type, mode } = req.body ?? {};
+            const { key: k, visibility: v, data, mime_type, mode, federate: reqFederate, group_id: reqGroupId } = req.body ?? {};
+            federateFlag = reqFederate === true;
             // --- PRESIGNED MODE: return upload URL ---
             if (mode === 'presigned') {
                 if (!k) {
@@ -68,6 +71,7 @@ export function storageFilesRouter(config, storage) {
             }
             key = k;
             visibility = v ?? 'private';
+            groupId = visibility === 'group' ? reqGroupId : undefined;
             fileData = Buffer.from(data, 'base64');
             mimeType = mime_type ?? 'application/octet-stream';
         }
@@ -102,9 +106,11 @@ export function storageFilesRouter(config, storage) {
             key,
             ownerGaii: gaii,
             visibility: visibility,
+            groupId,
             mimeType,
             size: fileData.length,
             data: fileData,
+            federate: federateFlag === true,
             createdAt: new Date().toISOString(),
         });
         // M-3: Charge overage morsels if over quota (§15)
@@ -118,6 +124,7 @@ export function storageFilesRouter(config, storage) {
             size: file.size,
             mime_type: file.mimeType,
             visibility: file.visibility,
+            federate: file.federate ?? false,
             created_at: file.createdAt,
             overage_charged: storageQuota.overageMorsels > 0 ? storageQuota.overageMorsels : undefined,
         }, [