@enbox/protocols 0.1.0 → 0.2.0

package/dist/esm/connect.js

@@ -0,0 +1,36 @@
+/**
+ * Connect Protocol — wallet and app discovery information.
+ *
+ * Stores metadata about which wallet applications and services a DID
+ * is associated with. Published so that other apps can discover how
+ * to connect to this identity.
+ *
+ * @module
+ */
+import { defineProtocol } from '@enbox/api';
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+export const ConnectDefinition = {
+    protocol: 'https://enbox.org/protocols/connect',
+    published: true,
+    types: {
+        wallet: {
+            schema: 'https://enbox.org/schemas/connect/wallet',
+            dataFormats: ['application/json'],
+        },
+    },
+    structure: {
+        wallet: {
+            $actions: [
+                { who: 'anyone', can: ['read'] },
+            ],
+        },
+    },
+};
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+/** Typed Connect protocol for use with `dwn.using()`. */
+export const ConnectProtocol = defineProtocol(ConnectDefinition, {});
+//# sourceMappingURL=connect.js.map

package/dist/esm/connect.js.map

@@ -0,0 +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,qCAAqC;IACjD,SAAS,EAAG,IAAI;IAChB,KAAK,EAAO;QACV,MAAM,EAAE;YACN,MAAM,EAAQ,0CAA0C;YACxD,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"}

package/dist/esm/index.js

@@ -9,6 +9,7 @@
  *
  * @packageDocumentation
  */
+export * from './connect.js';
 export * from './lists.js';
 export * from './preferences.js';
 export * from './profile.js';

package/dist/esm/index.js.map

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

package/dist/esm/profile.js

@@ -1,8 +1,9 @@
 /**
  * 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).
+ * Supports a published profile record, avatar and hero images (binary),
+ * links, and private notes visible only to friends (via Social Graph
+ * composition).
  *
  * @module
  */
@@ -24,6 +25,9 @@ export const ProfileDefinition = {
         avatar: {
             dataFormats: ['image/png', 'image/jpeg', 'image/gif', 'image/webp'],
         },
+        hero: {
+            dataFormats: ['image/png', 'image/jpeg', 'image/gif', 'image/webp'],
+        },
         link: {
             schema: 'https://enbox.org/schemas/profile/link',
             dataFormats: ['application/json'],
@@ -45,6 +49,12 @@ export const ProfileDefinition = {
                     { who: 'anyone', can: ['read'] },
                 ],
             },
+            hero: {
+                $size: { max: 2097152 },
+                $actions: [
+                    { who: 'anyone', can: ['read'] },
+                ],
+            },
             link: {
                 $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;;;;;;;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"}
+{"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,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,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,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/types/connect.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Connect Protocol — wallet and app discovery information.
+ *
+ * Stores metadata about which wallet applications and services a DID
+ * is associated with. Published so that other apps can discover how
+ * to connect to this identity.
+ *
+ * @module
+ */
+/** Data shape for wallet connection info. */
+export type WalletData = {
+    /** URLs of web wallet applications associated with this DID. */
+    webWallets: string[];
+};
+/** Maps protocol type names to their TypeScript data shapes. */
+export type ConnectSchemaMap = {
+    wallet: WalletData;
+};
+export declare const ConnectDefinition: {
+    readonly protocol: "https://enbox.org/protocols/connect";
+    readonly published: true;
+    readonly types: {
+        readonly wallet: {
+            readonly schema: "https://enbox.org/schemas/connect/wallet";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly wallet: {
+            readonly $actions: [{
+                readonly who: "anyone";
+                readonly can: ["read"];
+            }];
+        };
+    };
+};
+/** Typed Connect protocol for use with `dwn.using()`. */
+export declare const ConnectProtocol: import("@enbox/api").TypedProtocol<{
+    readonly protocol: "https://enbox.org/protocols/connect";
+    readonly published: true;
+    readonly types: {
+        readonly wallet: {
+            readonly schema: "https://enbox.org/schemas/connect/wallet";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly wallet: {
+            readonly $actions: [{
+                readonly who: "anyone";
+                readonly can: ["read"];
+            }];
+        };
+    };
+}, ConnectSchemaMap>;
+//# sourceMappingURL=connect.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/index.d.ts

@@ -9,6 +9,7 @@
  *
  * @packageDocumentation
  */
+export * from './connect.js';
 export * from './lists.js';
 export * from './preferences.js';
 export * from './profile.js';

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

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

package/dist/types/profile.d.ts

@@ -1,8 +1,9 @@
 /**
  * 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).
+ * Supports a published profile record, avatar and hero images (binary),
+ * links, and private notes visible only to friends (via Social Graph
+ * composition).
  *
  * @module
  */
@@ -10,12 +11,15 @@
 export type ProfileData = {
     displayName: string;
     bio?: string;
+    tagline?: string;
     location?: string;
     website?: string;
     pronouns?: string;
 };
 /** Avatar is stored as binary data (Blob). */
 export type AvatarData = Blob;
+/** Hero banner is stored as binary data (Blob). */
+export type HeroData = Blob;
 /** Data shape for a link record (e.g. social links). */
 export type LinkData = {
     url: string;
@@ -31,6 +35,7 @@ export type PrivateNoteData = {
 export type ProfileSchemaMap = {
     profile: ProfileData;
     avatar: AvatarData;
+    hero: HeroData;
     link: LinkData;
     privateNote: PrivateNoteData;
 };
@@ -48,6 +53,9 @@ export declare const ProfileDefinition: {
         readonly avatar: {
             readonly dataFormats: ["image/png", "image/jpeg", "image/gif", "image/webp"];
         };
+        readonly hero: {
+            readonly dataFormats: ["image/png", "image/jpeg", "image/gif", "image/webp"];
+        };
         readonly link: {
             readonly schema: "https://enbox.org/schemas/profile/link";
             readonly dataFormats: ["application/json"];
@@ -75,6 +83,15 @@ export declare const ProfileDefinition: {
                     readonly can: ["read"];
                 }];
             };
+            readonly hero: {
+                readonly $size: {
+                    readonly max: 2097152;
+                };
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }];
+            };
             readonly link: {
                 readonly $actions: [{
                     readonly who: "anyone";
@@ -105,6 +122,9 @@ export declare const ProfileProtocol: import("@enbox/api").TypedProtocol<{
         readonly avatar: {
             readonly dataFormats: ["image/png", "image/jpeg", "image/gif", "image/webp"];
         };
+        readonly hero: {
+            readonly dataFormats: ["image/png", "image/jpeg", "image/gif", "image/webp"];
+        };
         readonly link: {
             readonly schema: "https://enbox.org/schemas/profile/link";
             readonly dataFormats: ["application/json"];
@@ -132,6 +152,15 @@ export declare const ProfileProtocol: import("@enbox/api").TypedProtocol<{
                     readonly can: ["read"];
                 }];
             };
+            readonly hero: {
+                readonly $size: {
+                    readonly max: 2097152;
+                };
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }];
+            };
             readonly link: {
                 readonly $actions: [{
                     readonly who: "anyone";

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

@@ -1 +1 @@
-{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,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,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,WAAW,EAAE,eAAe,CAAC;CAC9B,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CS,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDS,CAAC;AAMxC,yDAAyD;AACzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAG3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enbox/protocols",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Standard reusable DWN protocol definitions for the Enbox ecosystem",
   "type": "module",
   "main": "./dist/esm/index.js",
@@ -46,8 +46,8 @@
     "bun": ">=1.0.0"
   },
   "dependencies": {
-    "@enbox/api": "0.1.0",
-    "@enbox/dwn-sdk-js": "0.0.5"
+    "@enbox/api": "0.1.1",
+    "@enbox/dwn-sdk-js": "0.0.6"
   },
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "8.32.1",

package/src/connect.ts

@@ -0,0 +1,64 @@
+/**
+ * Connect Protocol — wallet and app discovery information.
+ *
+ * Stores metadata about which wallet applications and services a DID
+ * is associated with. Published so that other apps can discover how
+ * to connect to this identity.
+ *
+ * @module
+ */
+
+import type { ProtocolDefinition } from '@enbox/dwn-sdk-js';
+
+import { defineProtocol } from '@enbox/api';
+
+// ---------------------------------------------------------------------------
+// Data types
+// ---------------------------------------------------------------------------
+
+/** Data shape for wallet connection info. */
+export type WalletData = {
+  /** URLs of web wallet applications associated with this DID. */
+  webWallets: string[];
+};
+
+// ---------------------------------------------------------------------------
+// Schema map
+// ---------------------------------------------------------------------------
+
+/** Maps protocol type names to their TypeScript data shapes. */
+export type ConnectSchemaMap = {
+  wallet: WalletData;
+};
+
+// ---------------------------------------------------------------------------
+// Protocol definition
+// ---------------------------------------------------------------------------
+
+export const ConnectDefinition = {
+  protocol  : 'https://enbox.org/protocols/connect',
+  published : true,
+  types     : {
+    wallet: {
+      schema      : 'https://enbox.org/schemas/connect/wallet',
+      dataFormats : ['application/json'],
+    },
+  },
+  structure: {
+    wallet: {
+      $actions: [
+        { who: 'anyone', can: ['read'] },
+      ],
+    },
+  },
+} as const satisfies ProtocolDefinition;
+
+// ---------------------------------------------------------------------------
+// Typed protocol export
+// ---------------------------------------------------------------------------
+
+/** Typed Connect protocol for use with `dwn.using()`. */
+export const ConnectProtocol = defineProtocol(
+  ConnectDefinition,
+  {} as ConnectSchemaMap,
+);

package/src/index.ts

@@ -10,6 +10,7 @@
  * @packageDocumentation
  */
 
+export * from './connect.js';
 export * from './lists.js';
 export * from './preferences.js';
 export * from './profile.js';

package/src/profile.ts

@@ -1,8 +1,9 @@
 /**
  * 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).
+ * Supports a published profile record, avatar and hero images (binary),
+ * links, and private notes visible only to friends (via Social Graph
+ * composition).
  *
  * @module
  */
@@ -19,6 +20,7 @@ import { defineProtocol } from '@enbox/api';
 export type ProfileData = {
   displayName: string;
   bio?: string;
+  tagline?: string;
   location?: string;
   website?: string;
   pronouns?: string;
@@ -27,6 +29,9 @@ export type ProfileData = {
 /** Avatar is stored as binary data (Blob). */
 export type AvatarData = Blob;
 
+/** Hero banner is stored as binary data (Blob). */
+export type HeroData = Blob;
+
 /** Data shape for a link record (e.g. social links). */
 export type LinkData = {
   url: string;
@@ -48,6 +53,7 @@ export type PrivateNoteData = {
 export type ProfileSchemaMap = {
   profile: ProfileData;
   avatar: AvatarData;
+  hero: HeroData;
   link: LinkData;
   privateNote: PrivateNoteData;
 };
@@ -70,6 +76,9 @@ export const ProfileDefinition = {
     avatar: {
       dataFormats: ['image/png', 'image/jpeg', 'image/gif', 'image/webp'],
     },
+    hero: {
+      dataFormats: ['image/png', 'image/jpeg', 'image/gif', 'image/webp'],
+    },
     link: {
       schema      : 'https://enbox.org/schemas/profile/link',
       dataFormats : ['application/json'],
@@ -91,6 +100,12 @@ export const ProfileDefinition = {
           { who: 'anyone', can: ['read'] },
         ],
       },
+      hero: {
+        $size    : { max: 2097152 },
+        $actions : [
+          { who: 'anyone', can: ['read'] },
+        ],
+      },
       link: {
         $actions: [
           { who: 'anyone', can: ['read'] },