@enbox/protocols 0.1.0

package/dist/esm/index.js

@@ -0,0 +1,17 @@
+/**
+ * Standard reusable DWN protocol definitions for the Enbox ecosystem.
+ *
+ * Each protocol exports:
+ * - A raw `ProtocolDefinition` (e.g. `SocialGraphDefinition`)
+ * - A typed protocol created via `defineProtocol()` (e.g. `SocialGraphProtocol`)
+ * - Data shape types for each record type (e.g. `FriendData`, `ProfileData`)
+ * - A `SchemaMap` type mapping type names to data shapes
+ *
+ * @packageDocumentation
+ */
+export * from './lists.js';
+export * from './preferences.js';
+export * from './profile.js';
+export * from './social-graph.js';
+export * from './status.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/esm/lists.js

@@ -0,0 +1,102 @@
+/**
+ * Lists Protocol — flexible list management with folders and collaboration.
+ *
+ * Supports both nesting patterns:
+ * - **Fixed-depth folders**: `folder/folder/folder` (3 levels max)
+ * - **Flat items with tag-based hierarchy**: `list/item` with `parentItemId` tag
+ *
+ * Composes with Social Graph for friend-scoped read access and
+ * defines a `collaborator` role for write access to shared lists.
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const ListsDefinition = {
+    protocol: 'https://enbox.org/protocols/lists',
+    published: false,
+    uses: {
+        social: 'https://enbox.org/protocols/social-graph',
+    },
+    types: {
+        list: {
+            schema: 'https://enbox.org/schemas/lists/list',
+            dataFormats: ['application/json'],
+        },
+        item: {
+            schema: 'https://enbox.org/schemas/lists/item',
+            dataFormats: ['application/json'],
+        },
+        folder: {
+            schema: 'https://enbox.org/schemas/lists/folder',
+            dataFormats: ['application/json'],
+        },
+        collaborator: {
+            schema: 'https://enbox.org/schemas/lists/collaborator',
+            dataFormats: ['application/json'],
+        },
+        comment: {
+            schema: 'https://enbox.org/schemas/lists/comment',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        list: {
+            $actions: [
+                { role: 'social:friend', can: ['read'] },
+            ],
+            $tags: {
+                $requiredTags: ['listType'],
+                $allowUndefinedTags: false,
+                listType: { type: 'string', enum: ['todo', 'bookmarks', 'reading', 'custom'] },
+            },
+            item: {
+                $actions: [
+                    { role: 'social:friend', can: ['read'] },
+                    { role: 'list/collaborator', can: ['create', 'read', 'update', 'delete'] },
+                ],
+                $tags: {
+                    $allowUndefinedTags: true,
+                    parentItemId: { type: 'string' },
+                },
+                comment: {
+                    $actions: [
+                        { role: 'list/collaborator', can: ['create', 'read'] },
+                    ],
+                },
+            },
+            collaborator: {
+                $role: true,
+                $actions: [
+                    { who: 'anyone', can: ['read'] },
+                ],
+                $tags: {
+                    $requiredTags: ['did'],
+                    $allowUndefinedTags: false,
+                    did: { type: 'string' },
+                },
+            },
+        },
+        folder: {
+            $actions: [],
+            $tags: {
+                $allowUndefinedTags: true,
+                sortOrder: { type: 'number' },
+            },
+            folder: {
+                $actions: [],
+                folder: {
+                    $actions: [],
+                },
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Lists protocol for use with `dwn.using()`. */
+export const ListsProtocol = defineProtocol(ListsDefinition, {});
+//# sourceMappingURL=lists.js.map

package/dist/esm/lists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lists.js","sourceRoot":"","sources":["../../src/lists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAsD5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAI,mCAAmC;IAC/C,SAAS,EAAG,KAAK;IACjB,IAAI,EAAQ;QACV,MAAM,EAAE,0CAA0C;KACnD;IACD,KAAK,EAAE;QACL,IAAI,EAAE;YACJ,MAAM,EAAQ,sCAAsC;YACpD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,IAAI,EAAE;YACJ,MAAM,EAAQ,sCAAsC;YACpD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,MAAM,EAAE;YACN,MAAM,EAAQ,wCAAwC;YACtD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,YAAY,EAAE;YACZ,MAAM,EAAQ,8CAA8C;YAC5D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,OAAO,EAAE;YACP,MAAM,EAAQ,yCAAyC;YACvD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,IAAI,EAAE;YACJ,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aACzC;YACD,KAAK,EAAE;gBACL,aAAa,EAAS,CAAC,UAAU,CAAC;gBAClC,mBAAmB,EAAG,KAAK;gBAC3B,QAAQ,EAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE;aAC3F;YACD,IAAI,EAAE;gBACJ,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;oBACxC,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE;iBAC3E;gBACD,KAAK,EAAE;oBACL,mBAAmB,EAAG,IAAI;oBAC1B,YAAY,EAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACzC;gBACD,OAAO,EAAE;oBACP,QAAQ,EAAE;wBACR,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;qBACvD;iBACF;aACF;YACD,YAAY,EAAE;gBACZ,KAAK,EAAM,IAAI;gBACf,QAAQ,EAAG;oBACT,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;iBACjC;gBACD,KAAK,EAAE;oBACL,aAAa,EAAS,CAAC,KAAK,CAAC;oBAC7B,mBAAmB,EAAG,KAAK;oBAC3B,GAAG,EAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACzC;aACF;SACF;QACD,MAAM,EAAE;YACN,QAAQ,EAAG,EAAE;YACb,KAAK,EAAM;gBACT,mBAAmB,EAAG,IAAI;gBAC1B,SAAS,EAAa,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzC;YACD,MAAM,EAAE;gBACN,QAAQ,EAAG,EAAE;gBACb,MAAM,EAAK;oBACT,QAAQ,EAAE,EAAE;iBACb;aACF;SACF;KACF;CACoC,CAAC;AAExC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CACzC,eAAe,EACf,EAAoB,CACrB,CAAC"}

package/dist/esm/preferences.js

@@ -0,0 +1,61 @@
+/**
+ * Preferences Protocol — user configuration and settings.
+ *
+ * Stores theme, locale, privacy, and notification preferences.
+ * Fully owner-only (no external reads). The `privacy` type uses
+ * `encryptionRequired` for at-rest encryption of sensitive settings.
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const PreferencesDefinition = {
+    protocol: 'https://enbox.org/protocols/preferences',
+    published: false,
+    types: {
+        theme: {
+            schema: 'https://enbox.org/schemas/preferences/theme',
+            dataFormats: ['application/json'],
+        },
+        locale: {
+            schema: 'https://enbox.org/schemas/preferences/locale',
+            dataFormats: ['application/json'],
+        },
+        privacy: {
+            schema: 'https://enbox.org/schemas/preferences/privacy',
+            dataFormats: ['application/json'],
+            encryptionRequired: true,
+        },
+        notification: {
+            schema: 'https://enbox.org/schemas/preferences/notification',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        theme: {
+            $actions: [],
+        },
+        locale: {
+            $actions: [],
+        },
+        privacy: {
+            $actions: [],
+        },
+        notification: {
+            $actions: [],
+            $tags: {
+                $requiredTags: ['channel'],
+                $allowUndefinedTags: false,
+                channel: { type: 'string' },
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Preferences protocol for use with `dwn.using()`. */
+export const PreferencesProtocol = defineProtocol(PreferencesDefinition, {});
+//# sourceMappingURL=preferences.js.map

package/dist/esm/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../src/preferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoD5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAI,yCAAyC;IACrD,SAAS,EAAG,KAAK;IACjB,KAAK,EAAO;QACV,KAAK,EAAE;YACL,MAAM,EAAQ,6CAA6C;YAC3D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,MAAM,EAAE;YACN,MAAM,EAAQ,8CAA8C;YAC5D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,OAAO,EAAE;YACP,MAAM,EAAe,+CAA+C;YACpE,WAAW,EAAU,CAAC,kBAAkB,CAAC;YACzC,kBAAkB,EAAG,IAAI;SAC1B;QACD,YAAY,EAAE;YACZ,MAAM,EAAQ,oDAAoD;YAClE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,KAAK,EAAE;YACL,QAAQ,EAAE,EAAE;SACb;QACD,MAAM,EAAE;YACN,QAAQ,EAAE,EAAE;SACb;QACD,OAAO,EAAE;YACP,QAAQ,EAAE,EAAE;SACb;QACD,YAAY,EAAE;YACZ,QAAQ,EAAG,EAAE;YACb,KAAK,EAAM;gBACT,aAAa,EAAS,CAAC,SAAS,CAAC;gBACjC,mBAAmB,EAAG,KAAK;gBAC3B,OAAO,EAAe,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzC;SACF;KACF;CACoC,CAAC;AAExC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAC/C,qBAAqB,EACrB,EAA0B,CAC3B,CAAC"}

package/dist/esm/profile.js

@@ -0,0 +1,66 @@
+/**
+ * Profile Protocol — public and semi-private identity information.
+ *
+ * Supports a published profile record, avatar (binary), links, and
+ * private notes visible only to friends (via Social Graph composition).
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const ProfileDefinition = {
+    protocol: 'https://enbox.org/protocols/profile',
+    published: true,
+    uses: {
+        social: 'https://enbox.org/protocols/social-graph',
+    },
+    types: {
+        profile: {
+            schema: 'https://enbox.org/schemas/profile/profile',
+            dataFormats: ['application/json'],
+        },
+        avatar: {
+            dataFormats: ['image/png', 'image/jpeg', 'image/gif', 'image/webp'],
+        },
+        link: {
+            schema: 'https://enbox.org/schemas/profile/link',
+            dataFormats: ['application/json'],
+        },
+        privateNote: {
+            schema: 'https://enbox.org/schemas/profile/private-note',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        profile: {
+            $size: { max: 10000 },
+            $actions: [
+                { who: 'anyone', can: ['read'] },
+            ],
+            avatar: {
+                $size: { max: 1048576 },
+                $actions: [
+                    { who: 'anyone', can: ['read'] },
+                ],
+            },
+            link: {
+                $actions: [
+                    { who: 'anyone', can: ['read'] },
+                ],
+            },
+        },
+        privateNote: {
+            $actions: [
+                { role: 'social:friend', can: ['read'] },
+            ],
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Profile protocol for use with `dwn.using()`. */
+export const ProfileProtocol = defineProtocol(ProfileDefinition, {});
+//# sourceMappingURL=profile.js.map

package/dist/esm/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA2C5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAI,qCAAqC;IACjD,SAAS,EAAG,IAAI;IAChB,IAAI,EAAQ;QACV,MAAM,EAAE,0CAA0C;KACnD;IACD,KAAK,EAAE;QACL,OAAO,EAAE;YACP,MAAM,EAAQ,2CAA2C;YACzD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,MAAM,EAAE;YACN,WAAW,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;SACpE;QACD,IAAI,EAAE;YACJ,MAAM,EAAQ,wCAAwC;YACtD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,WAAW,EAAE;YACX,MAAM,EAAQ,gDAAgD;YAC9D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,OAAO,EAAE;YACP,KAAK,EAAM,EAAE,GAAG,EAAE,KAAK,EAAE;YACzB,QAAQ,EAAG;gBACT,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aACjC;YACD,MAAM,EAAE;gBACN,KAAK,EAAM,EAAE,GAAG,EAAE,OAAO,EAAE;gBAC3B,QAAQ,EAAG;oBACT,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;iBACjC;aACF;YACD,IAAI,EAAE;gBACJ,QAAQ,EAAE;oBACR,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;iBACjC;aACF;SACF;QACD,WAAW,EAAE;YACX,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aACzC;SACF;KACF;CACoC,CAAC;AAExC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,yDAAyD;AACzD,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAC3C,iBAAiB,EACjB,EAAsB,CACvB,CAAC"}

package/dist/esm/social-graph.js

@@ -0,0 +1,80 @@
+/**
+ * Social Graph Protocol — foundation protocol for relationship management.
+ *
+ * Provides friend, block, group, and member types with role-based access.
+ * Other protocols compose with this via `uses` to leverage the `friend` role
+ * for cross-protocol authorization.
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const SocialGraphDefinition = {
+    protocol: 'https://enbox.org/protocols/social-graph',
+    published: true,
+    types: {
+        friend: {
+            schema: 'https://enbox.org/schemas/social-graph/friend',
+            dataFormats: ['application/json'],
+        },
+        block: {
+            schema: 'https://enbox.org/schemas/social-graph/block',
+            dataFormats: ['application/json'],
+        },
+        group: {
+            schema: 'https://enbox.org/schemas/social-graph/group',
+            dataFormats: ['application/json'],
+        },
+        member: {
+            schema: 'https://enbox.org/schemas/social-graph/member',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        friend: {
+            $role: true,
+            $actions: [
+                { who: 'anyone', can: ['create'] },
+                { who: 'author', of: 'friend', can: ['read'] },
+            ],
+            $tags: {
+                $requiredTags: ['did'],
+                $allowUndefinedTags: false,
+                did: { type: 'string' },
+            },
+        },
+        block: {
+            $actions: [
+                { who: 'anyone', can: ['create'] },
+            ],
+            $tags: {
+                $requiredTags: ['did'],
+                $allowUndefinedTags: false,
+                did: { type: 'string' },
+            },
+        },
+        group: {
+            $actions: [
+                { who: 'anyone', can: ['read'] },
+            ],
+            member: {
+                $actions: [
+                    { who: 'anyone', can: ['read'] },
+                ],
+                $tags: {
+                    $requiredTags: ['did'],
+                    $allowUndefinedTags: false,
+                    did: { type: 'string' },
+                },
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Social Graph protocol for use with `dwn.using()`. */
+export const SocialGraphProtocol = defineProtocol(SocialGraphDefinition, {});
+//# sourceMappingURL=social-graph.js.map

package/dist/esm/social-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-graph.js","sourceRoot":"","sources":["../../src/social-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA4C5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAI,0CAA0C;IACtD,SAAS,EAAG,IAAI;IAChB,KAAK,EAAO;QACV,MAAM,EAAE;YACN,MAAM,EAAQ,+CAA+C;YAC7D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,KAAK,EAAE;YACL,MAAM,EAAQ,8CAA8C;YAC5D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,KAAK,EAAE;YACL,MAAM,EAAQ,8CAA8C;YAC5D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,MAAM,EAAE;YACN,MAAM,EAAQ,+CAA+C;YAC7D,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,MAAM,EAAE;YACN,KAAK,EAAM,IAAI;YACf,QAAQ,EAAG;gBACT,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE;gBAClC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aAC/C;YACD,KAAK,EAAE;gBACL,aAAa,EAAS,CAAC,KAAK,CAAC;gBAC7B,mBAAmB,EAAG,KAAK;gBAC3B,GAAG,EAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzC;SACF;QACD,KAAK,EAAE;YACL,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE;aACnC;YACD,KAAK,EAAE;gBACL,aAAa,EAAS,CAAC,KAAK,CAAC;gBAC7B,mBAAmB,EAAG,KAAK;gBAC3B,GAAG,EAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzC;SACF;QACD,KAAK,EAAE;YACL,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aACjC;YACD,MAAM,EAAE;gBACN,QAAQ,EAAE;oBACR,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;iBACjC;gBACD,KAAK,EAAE;oBACL,aAAa,EAAS,CAAC,KAAK,CAAC;oBAC7B,mBAAmB,EAAG,KAAK;oBAC3B,GAAG,EAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACzC;aACF;SACF;KACF;CACoC,CAAC;AAExC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAC/C,qBAAqB,EACrB,EAA0B,CAC3B,CAAC"}

package/dist/esm/status.js

@@ -0,0 +1,50 @@
+/**
+ * Status Protocol — ephemeral status updates with reactions.
+ *
+ * Uses the `published` flag on individual records to control visibility:
+ * published statuses are readable by anyone, unpublished ones only by friends.
+ * Composes with Social Graph for friend-scoped access and reactions.
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const StatusDefinition = {
+    protocol: 'https://enbox.org/protocols/status',
+    published: true,
+    uses: {
+        social: 'https://enbox.org/protocols/social-graph',
+    },
+    types: {
+        status: {
+            schema: 'https://enbox.org/schemas/status/status',
+            dataFormats: ['application/json'],
+        },
+        reaction: {
+            schema: 'https://enbox.org/schemas/status/reaction',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        status: {
+            $size: { max: 5000 },
+            $actions: [
+                { who: 'anyone', can: ['read'] },
+                { role: 'social:friend', can: ['read'] },
+            ],
+            reaction: {
+                $actions: [
+                    { role: 'social:friend', can: ['create', 'read', 'delete'] },
+                ],
+            },
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Status protocol for use with `dwn.using()`. */
+export const StatusProtocol = defineProtocol(StatusDefinition, {});
+//# sourceMappingURL=status.js.map

package/dist/esm/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA6B5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAI,oCAAoC;IAChD,SAAS,EAAG,IAAI;IAChB,IAAI,EAAQ;QACV,MAAM,EAAE,0CAA0C;KACnD;IACD,KAAK,EAAE;QACL,MAAM,EAAE;YACN,MAAM,EAAQ,yCAAyC;YACvD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,QAAQ,EAAE;YACR,MAAM,EAAQ,2CAA2C;YACzD,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,MAAM,EAAE;YACN,KAAK,EAAM,EAAE,GAAG,EAAE,IAAI,EAAE;YACxB,QAAQ,EAAG;gBACT,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;gBAChC,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aACzC;YACD,QAAQ,EAAE;gBACR,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;iBAC7D;aACF;SACF;KACF;CACoC,CAAC;AAExC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,wDAAwD;AACxD,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAC1C,gBAAgB,EAChB,EAAqB,CACtB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Standard reusable DWN protocol definitions for the Enbox ecosystem.
+ *
+ * Each protocol exports:
+ * - A raw `ProtocolDefinition` (e.g. `SocialGraphDefinition`)
+ * - A typed protocol created via `defineProtocol()` (e.g. `SocialGraphProtocol`)
+ * - Data shape types for each record type (e.g. `FriendData`, `ProfileData`)
+ * - A `SchemaMap` type mapping type names to data shapes
+ *
+ * @packageDocumentation
+ */
+export * from './lists.js';
+export * from './preferences.js';
+export * from './profile.js';
+export * from './social-graph.js';
+export * from './status.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/types/lists.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Lists Protocol — flexible list management with folders and collaboration.
+ *
+ * Supports both nesting patterns:
+ * - **Fixed-depth folders**: `folder/folder/folder` (3 levels max)
+ * - **Flat items with tag-based hierarchy**: `list/item` with `parentItemId` tag
+ *
+ * Composes with Social Graph for friend-scoped read access and
+ * defines a `collaborator` role for write access to shared lists.
+ *
+ * @module
+ */
+/** Data shape for a list record. */
+export type ListData = {
+    name: string;
+    description?: string;
+    icon?: string;
+    listType: 'todo' | 'bookmarks' | 'reading' | 'custom';
+};
+/** Data shape for a list item. */
+export type ItemData = {
+    title: string;
+    url?: string;
+    note?: string;
+    completed?: boolean;
+    sortOrder?: number;
+};
+/** Data shape for a folder record. */
+export type FolderData = {
+    name: string;
+    icon?: string;
+    sortOrder?: number;
+};
+/** Data shape for a collaborator record. */
+export type CollaboratorData = {
+    did: string;
+    alias?: string;
+};
+/** Data shape for a comment on a list item. */
+export type CommentData = {
+    text: string;
+};
+/** Maps protocol type names to their TypeScript data shapes. */
+export type ListsSchemaMap = {
+    list: ListData;
+    item: ItemData;
+    folder: FolderData;
+    collaborator: CollaboratorData;
+    comment: CommentData;
+};
+export declare const ListsDefinition: {
+    readonly protocol: "https://enbox.org/protocols/lists";
+    readonly published: false;
+    readonly uses: {
+        readonly social: "https://enbox.org/protocols/social-graph";
+    };
+    readonly types: {
+        readonly list: {
+            readonly schema: "https://enbox.org/schemas/lists/list";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly item: {
+            readonly schema: "https://enbox.org/schemas/lists/item";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly folder: {
+            readonly schema: "https://enbox.org/schemas/lists/folder";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly collaborator: {
+            readonly schema: "https://enbox.org/schemas/lists/collaborator";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly comment: {
+            readonly schema: "https://enbox.org/schemas/lists/comment";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly list: {
+            readonly $actions: [{
+                readonly role: "social:friend";
+                readonly can: ["read"];
+            }];
+            readonly $tags: {
+                readonly $requiredTags: ["listType"];
+                readonly $allowUndefinedTags: false;
+                readonly listType: {
+                    readonly type: "string";
+                    readonly enum: ["todo", "bookmarks", "reading", "custom"];
+                };
+            };
+            readonly item: {
+                readonly $actions: [{
+                    readonly role: "social:friend";
+                    readonly can: ["read"];
+                }, {
+                    readonly role: "list/collaborator";
+                    readonly can: ["create", "read", "update", "delete"];
+                }];
+                readonly $tags: {
+                    readonly $allowUndefinedTags: true;
+                    readonly parentItemId: {
+                        readonly type: "string";
+                    };
+                };
+                readonly comment: {
+                    readonly $actions: [{
+                        readonly role: "list/collaborator";
+                        readonly can: ["create", "read"];
+                    }];
+                };
+            };
+            readonly collaborator: {
+                readonly $role: true;
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["did"];
+                    readonly $allowUndefinedTags: false;
+                    readonly did: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly folder: {
+            readonly $actions: [];
+            readonly $tags: {
+                readonly $allowUndefinedTags: true;
+                readonly sortOrder: {
+                    readonly type: "number";
+                };
+            };
+            readonly folder: {
+                readonly $actions: [];
+                readonly folder: {
+                    readonly $actions: [];
+                };
+            };
+        };
+    };
+};
+/** Typed Lists protocol for use with `dwn.using()`. */
+export declare const ListsProtocol: import("@enbox/api").TypedProtocol<{
+    readonly protocol: "https://enbox.org/protocols/lists";
+    readonly published: false;
+    readonly uses: {
+        readonly social: "https://enbox.org/protocols/social-graph";
+    };
+    readonly types: {
+        readonly list: {
+            readonly schema: "https://enbox.org/schemas/lists/list";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly item: {
+            readonly schema: "https://enbox.org/schemas/lists/item";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly folder: {
+            readonly schema: "https://enbox.org/schemas/lists/folder";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly collaborator: {
+            readonly schema: "https://enbox.org/schemas/lists/collaborator";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly comment: {
+            readonly schema: "https://enbox.org/schemas/lists/comment";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly list: {
+            readonly $actions: [{
+                readonly role: "social:friend";
+                readonly can: ["read"];
+            }];
+            readonly $tags: {
+                readonly $requiredTags: ["listType"];
+                readonly $allowUndefinedTags: false;
+                readonly listType: {
+                    readonly type: "string";
+                    readonly enum: ["todo", "bookmarks", "reading", "custom"];
+                };
+            };
+            readonly item: {
+                readonly $actions: [{
+                    readonly role: "social:friend";
+                    readonly can: ["read"];
+                }, {
+                    readonly role: "list/collaborator";
+                    readonly can: ["create", "read", "update", "delete"];
+                }];
+                readonly $tags: {
+                    readonly $allowUndefinedTags: true;
+                    readonly parentItemId: {
+                        readonly type: "string";
+                    };
+                };
+                readonly comment: {
+                    readonly $actions: [{
+                        readonly role: "list/collaborator";
+                        readonly can: ["create", "read"];
+                    }];
+                };
+            };
+            readonly collaborator: {
+                readonly $role: true;
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["did"];
+                    readonly $allowUndefinedTags: false;
+                    readonly did: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly folder: {
+            readonly $actions: [];
+            readonly $tags: {
+                readonly $allowUndefinedTags: true;
+                readonly sortOrder: {
+                    readonly type: "number";
+                };
+            };
+            readonly folder: {
+                readonly $actions: [];
+                readonly folder: {
+                    readonly $actions: [];
+                };
+            };
+        };
+    };
+}, ListsSchemaMap>;
+//# sourceMappingURL=lists.d.ts.map