@enbox/protocols 0.2.5 → 0.2.6

package/README.md

@@ -0,0 +1,259 @@
+# @enbox/protocols
+
+> **Research Preview** -- Enbox is under active development. APIs may change without notice.
+
+Production-ready DWN protocol definitions for the Enbox ecosystem. Each protocol ships with:
+
+- A raw `ProtocolDefinition` constant (e.g. `SocialGraphDefinition`)
+- A typed protocol via `defineProtocol()` (e.g. `SocialGraphProtocol`)
+- TypeScript data shape types (e.g. `FriendData`, `ProfileData`)
+- A `SchemaMap` type mapping type names to data shapes
+- JSON Schema files in `schemas/` for validation and code generation
+- `$recordLimit` annotations on natural singleton types
+
+## Installation
+
+```bash
+bun add @enbox/protocols
+```
+
+## Quick Start
+
+```ts
+import { repository, Web5 } from '@enbox/api';
+import { ProfileProtocol, SocialGraphProtocol } from '@enbox/protocols';
+
+const { web5 } = await Web5.connect({ password: 'secret' });
+
+// Use the repository pattern for ergonomic CRUD
+const social = repository(web5.using(SocialGraphProtocol));
+await social.configure();
+
+// Collections: create, query, get, delete, subscribe
+const { record } = await social.friend.create({
+  data: { did: 'did:dht:alice...', alias: 'Alice' },
+});
+
+const { records: friends } = await social.friend.query();
+for (const f of friends) {
+  const data = await f.data.json(); // FriendData -- typed
+  console.log(data.alias);
+}
+
+// Singletons: set, get, delete
+const profile = repository(web5.using(ProfileProtocol));
+await profile.configure();
+
+await profile.profile.set({
+  data: { displayName: 'Bob', bio: 'Building the decentralized web' },
+});
+
+const { record: p } = await profile.profile.get();
+console.log(await p.data.json()); // ProfileData
+```
+
+## Protocol Catalog
+
+### Social Graph
+
+**URI**: `https://identity.foundation/protocols/social-graph`
+**Published**: yes
+**Import**: `SocialGraphProtocol`, `SocialGraphDefinition`
+
+Foundation protocol for relationship management. Other protocols compose with this via `uses` to leverage the `friend` role for cross-protocol authorization.
+
+| Type | Data Shape | Singleton | Notes |
+|------|-----------|-----------|-------|
+| `friend` | `FriendData` | no | `$role: true` -- used for cross-protocol auth |
+| `block` | `BlockData` | no | |
+| `group` | `GroupData` | no | |
+| `group/member` | `MemberData` | no | Nested under group |
+
+```ts
+type FriendData = { did: string; alias?: string; note?: string };
+type BlockData  = { did: string; reason?: string };
+type GroupData  = { name: string; description?: string; icon?: string };
+type MemberData = { did: string; alias?: string };
+```
+
+---
+
+### Profile
+
+**URI**: `https://identity.foundation/protocols/profile`
+**Published**: yes
+**Composes with**: Social Graph (`social:friend` role for private notes)
+**Import**: `ProfileProtocol`, `ProfileDefinition`
+
+Public and semi-private identity information with avatar/hero images and social links.
+
+| Type | Data Shape | Singleton | Notes |
+|------|-----------|-----------|-------|
+| `profile` | `ProfileData` | **yes** | 10 KB max |
+| `profile/avatar` | `AvatarData` (Blob) | **yes** | 12 MB max, image formats |
+| `profile/hero` | `HeroData` (Blob) | **yes** | 24 MB max, image formats |
+| `profile/link` | `LinkData` | no | Social links nested under profile |
+| `privateNote` | `PrivateNoteData` | no | Readable only by friends |
+
+```ts
+type ProfileData     = { displayName: string; bio?: string; tagline?: string; location?: string; website?: string; pronouns?: string };
+type AvatarData      = Blob;  // no JSON schema -- binary only
+type HeroData        = Blob;  // no JSON schema -- binary only
+type LinkData        = { url: string; title: string; icon?: string; sortOrder?: number };
+type PrivateNoteData = { content: string };
+```
+
+---
+
+### Preferences
+
+**URI**: `https://identity.foundation/protocols/preferences`
+**Published**: no (owner-only)
+**Import**: `PreferencesProtocol`, `PreferencesDefinition`
+
+User configuration and settings. The `privacy` type uses `encryptionRequired: true` for at-rest encryption.
+
+| Type | Data Shape | Singleton | Notes |
+|------|-----------|-----------|-------|
+| `theme` | `ThemeData` | **yes** | |
+| `locale` | `LocaleData` | **yes** | |
+| `privacy` | `PrivacyData` | **yes** | Encrypted at rest |
+| `notification` | `NotificationData` | no | Multiple channels, tagged by `channel` |
+
+```ts
+type ThemeData        = { mode: 'light' | 'dark' | 'system'; accentColor?: string; fontSize?: 'small' | 'medium' | 'large' };
+type LocaleData       = { language: string; region?: string; timezone?: string; dateFormat?: string; hourCycle?: '12h' | '24h' };
+type PrivacyData      = { cookieConsent: { analytics: boolean; marketing: boolean; functional: boolean }; shareUsageData: boolean };
+type NotificationData = { channel: string; enabled: boolean; quietHoursStart?: string; quietHoursEnd?: string };
+```
+
+---
+
+### Status
+
+**URI**: `https://identity.foundation/protocols/status`
+**Published**: yes
+**Composes with**: Social Graph (friend-scoped reactions)
+**Import**: `StatusProtocol`, `StatusDefinition`
+
+Ephemeral status updates with reactions. Published statuses are readable by anyone; reactions are friend-scoped.
+
+| Type | Data Shape | Singleton | Notes |
+|------|-----------|-----------|-------|
+| `status` | `StatusData` | no | 5 KB max |
+| `status/reaction` | `ReactionData` | no | Friend-only create/read/delete |
+
+```ts
+type StatusData   = { text: string; emoji?: string; activity?: 'online' | 'away' | 'busy' | 'offline'; expiresAt?: string };
+type ReactionData = { emoji: string };
+```
+
+---
+
+### Lists
+
+**URI**: `https://identity.foundation/protocols/lists`
+**Published**: no
+**Composes with**: Social Graph (friend-scoped reads, collaborator role)
+**Import**: `ListsProtocol`, `ListsDefinition`
+
+Flexible list management with collaboration. Supports nested items with tag-based hierarchy and 3-level folder nesting.
+
+| Type | Data Shape | Singleton | Notes |
+|------|-----------|-----------|-------|
+| `list` | `ListData` | no | Tagged by `listType` |
+| `list/item` | `ItemData` | no | Collaborators can CRUD |
+| `list/item/comment` | `CommentData` | no | Collaborators can create/read |
+| `list/collaborator` | `CollaboratorData` | no | `$role: true` for write access |
+| `folder` | `FolderData` | no | 3-level nesting: `folder/folder/folder` |
+
+```ts
+type ListData         = { name: string; description?: string; icon?: string; listType: 'todo' | 'bookmarks' | 'reading' | 'custom' };
+type ItemData         = { title: string; url?: string; note?: string; completed?: boolean; sortOrder?: number };
+type CommentData      = { text: string };
+type CollaboratorData = { did: string; alias?: string };
+type FolderData       = { name: string; icon?: string; sortOrder?: number };
+```
+
+---
+
+### Connect
+
+**URI**: `https://identity.foundation/protocols/connect`
+**Published**: yes
+**Import**: `ConnectProtocol`, `ConnectDefinition`
+
+Wallet and app discovery information.
+
+| Type | Data Shape | Singleton | Notes |
+|------|-----------|-----------|-------|
+| `wallet` | `WalletData` | **yes** | Publicly readable |
+
+```ts
+type WalletData = { webWallets: string[] };
+```
+
+## JSON Schemas
+
+Each protocol type with `application/json` data format has a corresponding JSON Schema file in `schemas/<protocol>/<type>.json`. These schemas:
+
+- Match the TypeScript data shapes exactly
+- Use Draft-07 (`$schema: "http://json-schema.org/draft-07/schema#"`)
+- Have `$id` URIs matching the `schema` field in the protocol definition
+- Are compatible with `@enbox/protocol-codegen` for TypeScript type generation
+
+```
+schemas/
+  social-graph/  friend.json, block.json, group.json, member.json
+  profile/       profile.json, link.json, private-note.json
+  preferences/   theme.json, locale.json, privacy.json, notification.json
+  status/        status.json, reaction.json
+  lists/         list.json, item.json, folder.json, collaborator.json, comment.json
+  connect/       wallet.json
+```
+
+Binary-only types (`avatar`, `hero`) do not have JSON Schemas since they store raw image data.
+
+## Singleton Detection
+
+Types annotated with `$recordLimit: { max: 1, strategy: 'reject' }` in the protocol structure are treated as singletons by the `repository()` factory. This means:
+
+- **Singletons** get `set()` (upsert) and `get()` instead of `create()` and `query()`
+- The DWN engine enforces the limit -- a second `create` for a singleton is rejected
+- Currently annotated singletons: `profile`, `avatar`, `hero`, `theme`, `locale`, `privacy`, `wallet`
+
+## Exports
+
+All protocols re-export from the package root:
+
+```ts
+import {
+  // Social Graph
+  SocialGraphProtocol, SocialGraphDefinition,
+  type SocialGraphSchemaMap, type FriendData, type BlockData, type GroupData, type MemberData,
+
+  // Profile
+  ProfileProtocol, ProfileDefinition,
+  type ProfileSchemaMap, type ProfileData, type AvatarData, type HeroData, type LinkData, type PrivateNoteData,
+
+  // Preferences
+  PreferencesProtocol, PreferencesDefinition,
+  type PreferencesSchemaMap, type ThemeData, type LocaleData, type PrivacyData, type NotificationData,
+
+  // Status
+  StatusProtocol, StatusDefinition,
+  type StatusSchemaMap, type StatusData, type ReactionData,
+
+  // Lists
+  ListsProtocol, ListsDefinition,
+  type ListsSchemaMap, type ListData, type ItemData, type FolderData, type CollaboratorData, type CommentData,
+
+  // Connect
+  ConnectProtocol, ConnectDefinition,
+  type ConnectSchemaMap, type WalletData,
+} from '@enbox/protocols';
+```
+
+## License
+
+Apache-2.0

package/dist/esm/connect.js

@@ -22,6 +22,7 @@ export const ConnectDefinition = {
     },
     structure: {
         wallet: {
+            $recordLimit: { max: 1, strategy: 'reject' },
             $actions: [
                 { who: 'anyone', can: ['read'] },
             ],

package/dist/esm/connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/connect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqB5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAI,+CAA+C;IAC3D,SAAS,EAAG,IAAI;IAChB,KAAK,EAAO;QACV,MAAM,EAAE;YACN,MAAM,EAAQ,oDAAoD;YAClE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,MAAM,EAAE;YACN,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aACjC;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"}
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../src/connect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqB5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAI,+CAA+C;IAC3D,SAAS,EAAG,IAAI;IAChB,KAAK,EAAO;QACV,MAAM,EAAE;YACN,MAAM,EAAQ,oDAAoD;YAClE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,MAAM,EAAE;YACN,YAAY,EAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAC7C,QAAQ,EAAO;gBACb,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aACjC;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/preferences.js

@@ -35,12 +35,15 @@ export const PreferencesDefinition = {
     },
     structure: {
         theme: {
+            $recordLimit: { max: 1, strategy: 'reject' },
             $actions: [],
         },
         locale: {
+            $recordLimit: { max: 1, strategy: 'reject' },
             $actions: [],
         },
         privacy: {
+            $recordLimit: { max: 1, strategy: 'reject' },
             $actions: [],
         },
         notification: {

package/dist/esm/preferences.js.map

@@ -1 +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,mDAAmD;IAC/D,SAAS,EAAG,KAAK;IACjB,KAAK,EAAO;QACV,KAAK,EAAE;YACL,MAAM,EAAQ,uDAAuD;YACrE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,MAAM,EAAE;YACN,MAAM,EAAQ,wDAAwD;YACtE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,OAAO,EAAE;YACP,MAAM,EAAe,yDAAyD;YAC9E,WAAW,EAAU,CAAC,kBAAkB,CAAC;YACzC,kBAAkB,EAAG,IAAI;SAC1B;QACD,YAAY,EAAE;YACZ,MAAM,EAAQ,8DAA8D;YAC5E,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"}
+{"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,mDAAmD;IAC/D,SAAS,EAAG,KAAK;IACjB,KAAK,EAAO;QACV,KAAK,EAAE;YACL,MAAM,EAAQ,uDAAuD;YACrE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,MAAM,EAAE;YACN,MAAM,EAAQ,wDAAwD;YACtE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,OAAO,EAAE;YACP,MAAM,EAAe,yDAAyD;YAC9E,WAAW,EAAU,CAAC,kBAAkB,CAAC;YACzC,kBAAkB,EAAG,IAAI;SAC1B;QACD,YAAY,EAAE;YACZ,MAAM,EAAQ,8DAA8D;YAC5E,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,KAAK,EAAE;YACL,YAAY,EAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAC7C,QAAQ,EAAO,EAAE;SAClB;QACD,MAAM,EAAE;YACN,YAAY,EAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAC7C,QAAQ,EAAO,EAAE;SAClB;QACD,OAAO,EAAE;YACP,YAAY,EAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAC7C,QAAQ,EAAO,EAAE;SAClB;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

@@ -39,17 +39,20 @@ export const ProfileDefinition = {
     },
     structure: {
         profile: {
+            $recordLimit: { max: 1, strategy: 'reject' },
             $size: { max: 10000 },
             $actions: [
                 { who: 'anyone', can: ['read'] },
             ],
             avatar: {
+                $recordLimit: { max: 1, strategy: 'reject' },
                 $size: { max: 12582912 },
                 $actions: [
                     { who: 'anyone', can: ['read'] },
                 ],
             },
             hero: {
+                $recordLimit: { max: 1, strategy: 'reject' },
                 $size: { max: 25165824 },
                 $actions: [
                     { who: 'anyone', can: ['read'] },

package/dist/esm/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgD5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAI,+CAA+C;IAC3D,SAAS,EAAG,IAAI;IAChB,IAAI,EAAQ;QACV,MAAM,EAAE,oDAAoD;KAC7D;IACD,KAAK,EAAE;QACL,OAAO,EAAE;YACP,MAAM,EAAQ,qDAAqD;YACnE,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,WAAW,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;SACpE;QACD,IAAI,EAAE;YACJ,MAAM,EAAQ,kDAAkD;YAChE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,WAAW,EAAE;YACX,MAAM,EAAQ,0DAA0D;YACxE,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,QAAQ,EAAE;gBAC5B,QAAQ,EAAG;oBACT,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;iBACjC;aACF;YACD,IAAI,EAAE;gBACJ,KAAK,EAAM,EAAE,GAAG,EAAE,QAAQ,EAAE;gBAC5B,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"}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgD5C,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAI,+CAA+C;IAC3D,SAAS,EAAG,IAAI;IAChB,IAAI,EAAQ;QACV,MAAM,EAAE,oDAAoD;KAC7D;IACD,KAAK,EAAE;QACL,OAAO,EAAE;YACP,MAAM,EAAQ,qDAAqD;YACnE,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,WAAW,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;SACpE;QACD,IAAI,EAAE;YACJ,MAAM,EAAQ,kDAAkD;YAChE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;QACD,WAAW,EAAE;YACX,MAAM,EAAQ,0DAA0D;YACxE,WAAW,EAAG,CAAC,kBAAkB,CAAC;SACnC;KACF;IACD,SAAS,EAAE;QACT,OAAO,EAAE;YACP,YAAY,EAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAC7C,KAAK,EAAU,EAAE,GAAG,EAAE,KAAK,EAAE;YAC7B,QAAQ,EAAO;gBACb,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;aACjC;YACD,MAAM,EAAE;gBACN,YAAY,EAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;gBAC7C,KAAK,EAAU,EAAE,GAAG,EAAE,QAAQ,EAAE;gBAChC,QAAQ,EAAO;oBACb,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE;iBACjC;aACF;YACD,IAAI,EAAE;gBACJ,YAAY,EAAG,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;gBAC7C,KAAK,EAAU,EAAE,GAAG,EAAE,QAAQ,EAAE;gBAChC,QAAQ,EAAO;oBACb,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/types/connect.d.ts

@@ -27,6 +27,10 @@ export declare const ConnectDefinition: {
     };
     readonly structure: {
         readonly wallet: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $actions: [{
                 readonly who: "anyone";
                 readonly can: ["read"];
@@ -46,6 +50,10 @@ export declare const ConnectProtocol: import("@enbox/api").TypedProtocol<{
     };
     readonly structure: {
         readonly wallet: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $actions: [{
                 readonly who: "anyone";
                 readonly can: ["read"];

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

@@ -1 +1 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/connect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG;IACvB,gEAAgE;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAgBS,CAAC;AAMxC,yDAAyD;AACzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;oBAG3B,CAAC"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/connect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG;IACvB,gEAAgE;IAChE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;CAiBS,CAAC;AAMxC,yDAAyD;AACzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;oBAG3B,CAAC"}

package/dist/types/preferences.d.ts

@@ -68,12 +68,24 @@ export declare const PreferencesDefinition: {
     };
     readonly structure: {
         readonly theme: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $actions: [];
         };
         readonly locale: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $actions: [];
         };
         readonly privacy: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $actions: [];
         };
         readonly notification: {
@@ -113,12 +125,24 @@ export declare const PreferencesProtocol: import("@enbox/api").TypedProtocol<{
     };
     readonly structure: {
         readonly theme: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $actions: [];
         };
         readonly locale: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $actions: [];
         };
         readonly privacy: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $actions: [];
         };
         readonly notification: {

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

@@ -1 +1 @@
-{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/preferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,wCAAwC;AACxC,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CACzC,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CAC3B,CAAC;AAEF,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,EAAE;QACb,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAMF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCK,CAAC;AAMxC,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAG/B,CAAC"}
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../src/preferences.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,wCAAwC;AACxC,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CACzC,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CAC3B,CAAC;AAEF,0CAA0C;AAC1C,MAAM,MAAM,WAAW,GAAG;IACxB,aAAa,EAAE;QACb,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,cAAc,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAMF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CK,CAAC;AAMxC,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAG/B,CAAC"}

package/dist/types/profile.d.ts

@@ -67,6 +67,10 @@ export declare const ProfileDefinition: {
     };
     readonly structure: {
         readonly profile: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $size: {
                 readonly max: 10000;
             };
@@ -75,6 +79,10 @@ export declare const ProfileDefinition: {
                 readonly can: ["read"];
             }];
             readonly avatar: {
+                readonly $recordLimit: {
+                    readonly max: 1;
+                    readonly strategy: "reject";
+                };
                 readonly $size: {
                     readonly max: 12582912;
                 };
@@ -84,6 +92,10 @@ export declare const ProfileDefinition: {
                 }];
             };
             readonly hero: {
+                readonly $recordLimit: {
+                    readonly max: 1;
+                    readonly strategy: "reject";
+                };
                 readonly $size: {
                     readonly max: 25165824;
                 };
@@ -136,6 +148,10 @@ export declare const ProfileProtocol: import("@enbox/api").TypedProtocol<{
     };
     readonly structure: {
         readonly profile: {
+            readonly $recordLimit: {
+                readonly max: 1;
+                readonly strategy: "reject";
+            };
             readonly $size: {
                 readonly max: 10000;
             };
@@ -144,6 +160,10 @@ export declare const ProfileProtocol: import("@enbox/api").TypedProtocol<{
                 readonly can: ["read"];
             }];
             readonly avatar: {
+                readonly $recordLimit: {
+                    readonly max: 1;
+                    readonly strategy: "reject";
+                };
                 readonly $size: {
                     readonly max: 12582912;
                 };
@@ -153,6 +173,10 @@ export declare const ProfileProtocol: import("@enbox/api").TypedProtocol<{
                 }];
             };
             readonly hero: {
+                readonly $recordLimit: {
+                    readonly max: 1;
+                    readonly strategy: "reject";
+                };
                 readonly $size: {
                     readonly max: 25165824;
                 };

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

@@ -1 +1 @@
-{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC;AAE9B,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC;AAE5B,wDAAwD;AACxD,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;CAC9B,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDS,CAAC;AAMxC,yDAAyD;AACzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAG3B,CAAC"}
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC;AAE9B,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC;AAE5B,wDAAwD;AACxD,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;CAC9B,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DS,CAAC;AAMxC,yDAAyD;AACzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAG3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enbox/protocols",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Standard reusable DWN protocol definitions for the Enbox ecosystem",
   "type": "module",
   "main": "./dist/esm/index.js",
@@ -25,6 +25,7 @@
   "license": "Apache-2.0",
   "files": [
     "dist",
+    "schemas",
     "src"
   ],
   "exports": {
@@ -46,8 +47,8 @@
     "bun": ">=1.0.0"
   },
   "dependencies": {
-    "@enbox/api": "0.2.3",
-    "@enbox/dwn-sdk-js": "0.0.7"
+    "@enbox/api": "0.2.4",
+    "@enbox/dwn-sdk-js": "0.0.8"
   },
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "8.32.1",

package/schemas/connect/wallet.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/connect/wallet",
+  "title": "WalletData",
+  "description": "Data shape for wallet connection info.",
+  "type": "object",
+  "properties": {
+    "webWallets": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "URLs of web wallet applications associated with this DID."
+    }
+  },
+  "required": ["webWallets"],
+  "additionalProperties": false
+}

package/schemas/lists/collaborator.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/lists/collaborator",
+  "title": "CollaboratorData",
+  "description": "Data shape for a collaborator record.",
+  "type": "object",
+  "properties": {
+    "did": {
+      "type": "string",
+      "description": "The DID of the collaborator."
+    },
+    "alias": {
+      "type": "string",
+      "description": "An optional alias for the collaborator."
+    }
+  },
+  "required": ["did"],
+  "additionalProperties": false
+}

package/schemas/lists/comment.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/lists/comment",
+  "title": "CommentData",
+  "description": "Data shape for a comment on a list item.",
+  "type": "object",
+  "properties": {
+    "text": {
+      "type": "string",
+      "description": "The comment text."
+    }
+  },
+  "required": ["text"],
+  "additionalProperties": false
+}

package/schemas/lists/folder.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/lists/folder",
+  "title": "FolderData",
+  "description": "Data shape for a folder record.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the folder."
+    },
+    "icon": {
+      "type": "string",
+      "description": "An optional icon for the folder."
+    },
+    "sortOrder": {
+      "type": "number",
+      "description": "An optional sort order for display."
+    }
+  },
+  "required": ["name"],
+  "additionalProperties": false
+}

package/schemas/lists/item.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/lists/item",
+  "title": "ItemData",
+  "description": "Data shape for a list item.",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string",
+      "description": "The title of the item."
+    },
+    "url": {
+      "type": "string",
+      "description": "An optional URL associated with the item."
+    },
+    "note": {
+      "type": "string",
+      "description": "An optional note about the item."
+    },
+    "completed": {
+      "type": "boolean",
+      "description": "Whether the item is completed."
+    },
+    "sortOrder": {
+      "type": "number",
+      "description": "An optional sort order for display."
+    }
+  },
+  "required": ["title"],
+  "additionalProperties": false
+}

package/schemas/lists/list.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/lists/list",
+  "title": "ListData",
+  "description": "Data shape for a list record.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the list."
+    },
+    "description": {
+      "type": "string",
+      "description": "An optional description of the list."
+    },
+    "icon": {
+      "type": "string",
+      "description": "An optional icon for the list."
+    },
+    "listType": {
+      "type": "string",
+      "enum": ["todo", "bookmarks", "reading", "custom"],
+      "description": "The type of list."
+    }
+  },
+  "required": ["name", "listType"],
+  "additionalProperties": false
+}

package/schemas/preferences/locale.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/preferences/locale",
+  "title": "LocaleData",
+  "description": "Data shape for locale preferences.",
+  "type": "object",
+  "properties": {
+    "language": {
+      "type": "string",
+      "description": "The preferred language (e.g. BCP 47 tag)."
+    },
+    "region": {
+      "type": "string",
+      "description": "An optional region code."
+    },
+    "timezone": {
+      "type": "string",
+      "description": "An optional IANA timezone identifier."
+    },
+    "dateFormat": {
+      "type": "string",
+      "description": "An optional date format string."
+    },
+    "hourCycle": {
+      "type": "string",
+      "enum": ["12h", "24h"],
+      "description": "An optional hour cycle preference."
+    }
+  },
+  "required": ["language"],
+  "additionalProperties": false
+}

package/schemas/preferences/notification.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/preferences/notification",
+  "title": "NotificationData",
+  "description": "Data shape for notification preferences.",
+  "type": "object",
+  "properties": {
+    "channel": {
+      "type": "string",
+      "description": "The notification channel identifier."
+    },
+    "enabled": {
+      "type": "boolean",
+      "description": "Whether the channel is enabled."
+    },
+    "quietHoursStart": {
+      "type": "string",
+      "description": "Optional quiet hours start time (HH:MM format)."
+    },
+    "quietHoursEnd": {
+      "type": "string",
+      "description": "Optional quiet hours end time (HH:MM format)."
+    }
+  },
+  "required": ["channel", "enabled"],
+  "additionalProperties": false
+}

package/schemas/preferences/privacy.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/preferences/privacy",
+  "title": "PrivacyData",
+  "description": "Data shape for privacy preferences.",
+  "type": "object",
+  "properties": {
+    "cookieConsent": {
+      "type": "object",
+      "description": "Cookie consent preferences.",
+      "properties": {
+        "analytics": {
+          "type": "boolean",
+          "description": "Whether analytics cookies are consented to."
+        },
+        "marketing": {
+          "type": "boolean",
+          "description": "Whether marketing cookies are consented to."
+        },
+        "functional": {
+          "type": "boolean",
+          "description": "Whether functional cookies are consented to."
+        }
+      },
+      "required": ["analytics", "marketing", "functional"],
+      "additionalProperties": false
+    },
+    "shareUsageData": {
+      "type": "boolean",
+      "description": "Whether usage data sharing is enabled."
+    }
+  },
+  "required": ["cookieConsent", "shareUsageData"],
+  "additionalProperties": false
+}

package/schemas/preferences/theme.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/preferences/theme",
+  "title": "ThemeData",
+  "description": "Data shape for theme preferences.",
+  "type": "object",
+  "properties": {
+    "mode": {
+      "type": "string",
+      "enum": ["light", "dark", "system"],
+      "description": "The theme mode."
+    },
+    "accentColor": {
+      "type": "string",
+      "description": "An optional accent color."
+    },
+    "fontSize": {
+      "type": "string",
+      "enum": ["small", "medium", "large"],
+      "description": "An optional font size preference."
+    }
+  },
+  "required": ["mode"],
+  "additionalProperties": false
+}

package/schemas/profile/link.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/profile/link",
+  "title": "LinkData",
+  "description": "Data shape for a link record (e.g. social links).",
+  "type": "object",
+  "properties": {
+    "url": {
+      "type": "string",
+      "description": "The URL of the link."
+    },
+    "title": {
+      "type": "string",
+      "description": "The display title of the link."
+    },
+    "icon": {
+      "type": "string",
+      "description": "An optional icon for the link."
+    },
+    "sortOrder": {
+      "type": "number",
+      "description": "An optional sort order for display."
+    }
+  },
+  "required": ["url", "title"],
+  "additionalProperties": false
+}

package/schemas/profile/private-note.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/profile/private-note",
+  "title": "PrivateNoteData",
+  "description": "Data shape for a private note (visible only to friends).",
+  "type": "object",
+  "properties": {
+    "content": {
+      "type": "string",
+      "description": "The content of the private note."
+    }
+  },
+  "required": ["content"],
+  "additionalProperties": false
+}

package/schemas/profile/profile.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/profile/profile",
+  "title": "ProfileData",
+  "description": "Data shape for a profile record.",
+  "type": "object",
+  "properties": {
+    "displayName": {
+      "type": "string",
+      "description": "The display name of the identity."
+    },
+    "bio": {
+      "type": "string",
+      "description": "An optional biography."
+    },
+    "tagline": {
+      "type": "string",
+      "description": "An optional tagline."
+    },
+    "location": {
+      "type": "string",
+      "description": "An optional location."
+    },
+    "website": {
+      "type": "string",
+      "description": "An optional website URL."
+    },
+    "pronouns": {
+      "type": "string",
+      "description": "Optional pronouns."
+    }
+  },
+  "required": ["displayName"],
+  "additionalProperties": false
+}

package/schemas/social-graph/block.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/social-graph/block",
+  "title": "BlockData",
+  "description": "Data shape for a block record.",
+  "type": "object",
+  "properties": {
+    "did": {
+      "type": "string",
+      "description": "The DID of the blocked identity."
+    },
+    "reason": {
+      "type": "string",
+      "description": "An optional reason for blocking."
+    }
+  },
+  "required": ["did"],
+  "additionalProperties": false
+}

package/schemas/social-graph/friend.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/social-graph/friend",
+  "title": "FriendData",
+  "description": "Data shape for a friend record.",
+  "type": "object",
+  "properties": {
+    "did": {
+      "type": "string",
+      "description": "The DID of the friend."
+    },
+    "alias": {
+      "type": "string",
+      "description": "An optional alias for the friend."
+    },
+    "note": {
+      "type": "string",
+      "description": "An optional note about the friend."
+    }
+  },
+  "required": ["did"],
+  "additionalProperties": false
+}

package/schemas/social-graph/group.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/social-graph/group",
+  "title": "GroupData",
+  "description": "Data shape for a group record.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the group."
+    },
+    "description": {
+      "type": "string",
+      "description": "An optional description of the group."
+    },
+    "icon": {
+      "type": "string",
+      "description": "An optional icon for the group."
+    }
+  },
+  "required": ["name"],
+  "additionalProperties": false
+}

package/schemas/social-graph/member.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/social-graph/member",
+  "title": "MemberData",
+  "description": "Data shape for a group member record.",
+  "type": "object",
+  "properties": {
+    "did": {
+      "type": "string",
+      "description": "The DID of the group member."
+    },
+    "alias": {
+      "type": "string",
+      "description": "An optional alias for the member."
+    }
+  },
+  "required": ["did"],
+  "additionalProperties": false
+}

package/schemas/status/reaction.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/status/reaction",
+  "title": "ReactionData",
+  "description": "Data shape for a reaction to a status.",
+  "type": "object",
+  "properties": {
+    "emoji": {
+      "type": "string",
+      "description": "The reaction emoji."
+    }
+  },
+  "required": ["emoji"],
+  "additionalProperties": false
+}

package/schemas/status/status.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://identity.foundation/schemas/status/status",
+  "title": "StatusData",
+  "description": "Data shape for a status update.",
+  "type": "object",
+  "properties": {
+    "text": {
+      "type": "string",
+      "description": "The status text."
+    },
+    "emoji": {
+      "type": "string",
+      "description": "An optional emoji for the status."
+    },
+    "activity": {
+      "type": "string",
+      "enum": ["online", "away", "busy", "offline"],
+      "description": "An optional activity state."
+    },
+    "expiresAt": {
+      "type": "string",
+      "description": "An optional ISO 8601 expiration timestamp."
+    }
+  },
+  "required": ["text"],
+  "additionalProperties": false
+}

package/src/connect.ts

@@ -46,7 +46,8 @@ export const ConnectDefinition = {
   },
   structure: {
     wallet: {
-      $actions: [
+      $recordLimit : { max: 1, strategy: 'reject' },
+      $actions     : [
         { who: 'anyone', can: ['read'] },
       ],
     },

package/src/preferences.ts

@@ -90,13 +90,16 @@ export const PreferencesDefinition = {
   },
   structure: {
     theme: {
-      $actions: [],
+      $recordLimit : { max: 1, strategy: 'reject' },
+      $actions     : [],
     },
     locale: {
-      $actions: [],
+      $recordLimit : { max: 1, strategy: 'reject' },
+      $actions     : [],
     },
     privacy: {
-      $actions: [],
+      $recordLimit : { max: 1, strategy: 'reject' },
+      $actions     : [],
     },
     notification: {
       $actions : [],

package/src/profile.ts

@@ -90,19 +90,22 @@ export const ProfileDefinition = {
   },
   structure: {
     profile: {
-      $size    : { max: 10000 },
-      $actions : [
+      $recordLimit : { max: 1, strategy: 'reject' },
+      $size        : { max: 10000 },
+      $actions     : [
         { who: 'anyone', can: ['read'] },
       ],
       avatar: {
-        $size    : { max: 12582912 },
-        $actions : [
+        $recordLimit : { max: 1, strategy: 'reject' },
+        $size        : { max: 12582912 },
+        $actions     : [
           { who: 'anyone', can: ['read'] },
         ],
       },
       hero: {
-        $size    : { max: 25165824 },
-        $actions : [
+        $recordLimit : { max: 1, strategy: 'reject' },
+        $size        : { max: 25165824 },
+        $actions     : [
           { who: 'anyone', can: ['read'] },
         ],
       },