pubky-app-specs 0.4.0 → 0.4.2

package/README.md

@@ -1,5 +1,8 @@
 # Pubky App Specs · `pubky-app-specs`
 
+[![npm version](https://img.shields.io/npm/v/pubky-app-specs)](https://www.npmjs.com/package/pubky-app-specs)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 A WASM library for building and validating structured JSON models compatible with Pubky.App social powered by [`@synonymdev/pubky`](https://www.npmjs.com/package/@synonymdev/pubky). It handles domain objects like **Users**, **Posts**, **Feeds**, **Bookmarks**, **Tags**, and more. Each object is:
 
 - **Sanitized** and **Validated** via Rust logic.
@@ -42,7 +45,7 @@ yarn add pubky-app-specs
 import { PubkySpecsBuilder } from "pubky-app-specs";
 
 // OR CommonJS
-const { PubkySpecsBuilder } = require("pubky-app-specs/index.cjs");
+const { PubkySpecsBuilder } = require("pubky-app-specs");
 
 function loadSpecs(pubkyId) {
   // Create a specs builder instance - WASM is already initialized
@@ -83,7 +86,7 @@ async function createUser(pubkyId) {
   const userJson = user.toJson();
 
   // Store in homeserver via pubky
-  const response = await client.fetch(userResult.meta.url, {
+  const response = await client.fetch(meta.url, {
     method: "PUT",
     body: JSON.stringify(userJson),
     credentials: "include",
@@ -93,8 +96,8 @@ async function createUser(pubkyId) {
     throw new Error(`Failed to store user: ${response.statusText}`);
   }
 
-  console.log("User stored at:", userResult.meta.url);
-  return userResult;
+  console.log("User stored at:", meta.url);
+  return { user, meta };
 }
 ```
 
@@ -105,17 +108,16 @@ import { Client } from "@synonymdev/pubky";
 import { PubkySpecsBuilder, PubkyAppPostKind } from "pubky-app-specs";
 
 async function createPost(pubkyId, content) {
-  // fileData can be a File (browser) or a raw Blob/Buffer (Node).
   const client = new Client();
   const specs = new PubkySpecsBuilder(pubkyId);
 
-  // Create the Post object referencing your (optional) attachment
+  // Create the Post object
   const {post, meta} = specs.createPost(
     content,
     PubkyAppPostKind.Short,
-    null, // parent post
-    null, // embed
-    null // attachments list of urls
+    null, // parent post URI (for replies)
+    null, // embed object (for reposts)
+    null  // attachments (array of file URLs, max 3)
   );
 
   // Store the post
@@ -130,7 +132,39 @@ async function createPost(pubkyId, content) {
 }
 ```
 
-### 3) Following a User
+### 3) Creating a Post with Attachments
+
+```js
+import { Client } from "@synonymdev/pubky";
+import { PubkySpecsBuilder, PubkyAppPostKind } from "pubky-app-specs";
+
+async function createPostWithAttachments(pubkyId, content, fileUrls) {
+  const client = new Client();
+  const specs = new PubkySpecsBuilder(pubkyId);
+
+  // Create post with attachments (max 3 allowed)
+  const {post, meta} = specs.createPost(
+    content,
+    PubkyAppPostKind.Image,
+    null, // parent
+    null, // embed
+    fileUrls // e.g. ["pubky://user/pub/pubky.app/files/abc123"]
+  );
+
+  const postJson = post.toJson();
+  console.log("Attachments:", postJson.attachments);
+
+  await client.fetch(meta.url, {
+    method: "PUT",
+    body: JSON.stringify(postJson),
+  });
+
+  console.log("Post with attachments stored at:", meta.url);
+  return {post, meta};
+}
+```
+
+### 4) Following a User
 
 ```js
 import { Client } from "@synonymdev/pubky";
@@ -164,9 +198,109 @@ This library supports many more domain objects beyond `User` and `Post`. Here ar
 - **Mutes**: `createMute(...)`
 - **Follows**: `createFollow(...)`
 - **LastRead**: `createLastRead(...)`
+- **Blobs**: `createBlob(...)`
+- **Files**: `createFile(...)`
 
 Each has a `meta` field for storing relevant IDs/paths and a typed data object.
 
+### Creating a File with Blob
+
+```js
+import { Client } from "@synonymdev/pubky";
+import { PubkySpecsBuilder, getValidMimeTypes } from "pubky-app-specs";
+
+async function uploadFile(pubkyId, fileData, fileName, contentType, fileSize) {
+  const client = new Client();
+  const specs = new PubkySpecsBuilder(pubkyId);
+
+  // First, create and store the blob (raw binary data)
+  const { blob, meta: blobMeta } = specs.createBlob(fileData);
+  
+  await client.fetch(blobMeta.url, {
+    method: "PUT",
+    body: JSON.stringify(blob.toJson()),
+  });
+
+  // Then create the file metadata pointing to the blob
+  const { file, meta: fileMeta } = specs.createFile(
+    fileName,       // e.g. "vacation-photo.jpg"
+    blobMeta.url,   // Reference to the blob
+    contentType,    // e.g. "image/jpeg"
+    fileSize        // Size in bytes
+  );
+
+  await client.fetch(fileMeta.url, {
+    method: "PUT",
+    body: JSON.stringify(file.toJson()),
+  });
+
+  console.log("File stored at:", fileMeta.url);
+  return { file, meta: fileMeta };
+}
+```
+
+---
+
+## ✅ Validating File MIME Types
+
+Use `getValidMimeTypes()` to get the list of allowed MIME types for file attachments. This helps validate files before upload without duplicating the validation list.
+
+```js
+import { getValidMimeTypes } from "pubky-app-specs";
+
+// Get the list of valid MIME types
+const validMimeTypes = getValidMimeTypes();
+// Returns: ["application/javascript", "application/json", "application/pdf", "image/png", ...]
+
+// Validate a file before upload
+function isValidFileType(mimeType) {
+  return validMimeTypes.includes(mimeType);
+}
+
+// Example usage
+if (isValidFileType(file.type)) {
+  // Proceed with upload
+} else {
+  console.error(`Invalid file type: ${file.type}`);
+}
+```
+
+## 🔗 URI Builder Utilities
+
+These helper functions construct properly formatted Pubky URIs:
+
+```js
+import {
+  userUriBuilder,
+  postUriBuilder,
+  bookmarkUriBuilder,
+  followUriBuilder,
+  tagUriBuilder,
+  muteUriBuilder,
+  lastReadUriBuilder,
+  blobUriBuilder,
+  fileUriBuilder,
+  feedUriBuilder,
+} from "pubky-app-specs";
+
+const userId = "8kkppkmiubfq4pxn6f73nqrhhhgkb5xyfprntc9si3np9ydbotto";
+const targetUserId = "dzswkfy7ek3bqnoc89jxuqqfbzhjrj6mi8qthgbxxcqkdugm3rio";
+
+// Build URIs for different resources
+userUriBuilder(userId);                    // pubky://{userId}/pub/pubky.app/profile.json
+postUriBuilder(userId, "0033SSE3B1FQ0");   // pubky://{userId}/pub/pubky.app/posts/{postId}
+bookmarkUriBuilder(userId, "ABC123");      // pubky://{userId}/pub/pubky.app/bookmarks/{bookmarkId}
+followUriBuilder(userId, targetUserId);    // pubky://{userId}/pub/pubky.app/follows/{targetUserId}
+tagUriBuilder(userId, "XYZ789");           // pubky://{userId}/pub/pubky.app/tags/{tagId}
+muteUriBuilder(userId, targetUserId);      // pubky://{userId}/pub/pubky.app/mutes/{targetUserId}
+lastReadUriBuilder(userId);                // pubky://{userId}/pub/pubky.app/last_read
+blobUriBuilder(userId, "BLOB123");         // pubky://{userId}/pub/pubky.app/blobs/{blobId}
+fileUriBuilder(userId, "FILE456");         // pubky://{userId}/pub/pubky.app/files/{fileId}
+feedUriBuilder(userId, "FEED789");         // pubky://{userId}/pub/pubky.app/feeds/{feedId}
+```
+
+---
+
 ## 📌 Parsing a Pubky URI
 
 The `parse_uri()` function converts a Pubky URI string into a strongly typed object.
@@ -193,3 +327,9 @@ A `ParsedUriResult` object with:
 - **user_id:** The parsed user identifier.
 - **resource:** A string indicating the resource type.
 - **resource_id:** An optional resource identifier.
+
+---
+
+## 📄 License
+
+MIT

package/example.js

@@ -1,93 +1,295 @@
-import { PubkyAppPostKind, PubkySpecsBuilder, PubkyAppPostEmbed } from "./index.js";
+import {
+  PubkyAppPostKind,
+  PubkySpecsBuilder,
+  PubkyAppPostEmbed,
+  userUriBuilder,
+  postUriBuilder,
+  bookmarkUriBuilder,
+  followUriBuilder,
+  tagUriBuilder,
+  muteUriBuilder,
+  lastReadUriBuilder,
+  blobUriBuilder,
+  fileUriBuilder,
+  feedUriBuilder,
+  getValidMimeTypes,
+} from "./index.js";
 
+// =============================================================================
+// ANSI color helpers for pretty output
+// =============================================================================
+const c = {
+  reset: "\x1b[0m",
+  bright: "\x1b[1m",
+  dim: "\x1b[2m",
+  cyan: "\x1b[36m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue: "\x1b[34m",
+  magenta: "\x1b[35m",
+  gray: "\x1b[90m",
+  white: "\x1b[37m",
+  bgBlue: "\x1b[44m",
+};
+
+const divider = () => console.log(c.gray + "─".repeat(70) + c.reset);
+const header = (title) => {
+  console.log();
+  console.log(`${c.bright}${c.blue}${title}${c.reset}`);
+  divider();
+};
+const field = (label, value) => {
+  console.log(`  ${c.dim}${label.padEnd(12)}${c.reset} ${c.white}${value}${c.reset}`);
+};
+
+// =============================================================================
+// Setup
+// =============================================================================
 const OTTO = "8kkppkmiubfq4pxn6f73nqrhhhgkb5xyfprntc9si3np9ydbotto";
 const RIO = "dzswkfy7ek3bqnoc89jxuqqfbzhjrj6mi8qthgbxxcqkdugm3rio";
 
-// 👤 Create a user profile
-console.log("👤 Creating User Profile...");
+console.log();
+console.log(`${c.bgBlue}${c.white}${c.bright}                                                                      ${c.reset}`);
+console.log(`${c.bgBlue}${c.white}${c.bright}                    PUBKY APP SPECS - EXAMPLES                        ${c.reset}`);
+console.log(`${c.bgBlue}${c.white}${c.bright}                                                                      ${c.reset}`);
+console.log();
+
 const specsBuilder = new PubkySpecsBuilder(OTTO);
-const { user, meta: userMeta } =
-  specsBuilder.createUser("Alice Smith", "Software Developer", null, null, "active");
-console.log("User Profile URL:", userMeta.url);
-console.log("User Data:", JSON.stringify(user.toJson(), null, 2));
-console.log("-".repeat(60));
-
-// 📝 Create different posts
-console.log("📝 Creating First Post...");
-const { post, meta } = specsBuilder.createPost("Hello, Pubky world! This is my first post.", PubkyAppPostKind.Short, null, null, null);
-console.log("Post ID:", meta.id);
-console.log("Post URL:", meta.url);
-console.log("Post Data:", JSON.stringify(post.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("💬 Creating Reply Post...");
-const { post: replyPost, meta: replyMeta } = specsBuilder.createPost("This is a reply to the first post!", PubkyAppPostKind.Short, userMeta.url, null, null);
-console.log("Reply Post ID:", replyMeta.id);
-console.log("Reply Post URL:", replyMeta.url);
-console.log("Reply Data:", JSON.stringify(replyPost.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("🔄 Creating Repost with Embed...");
-let embeed = new PubkyAppPostEmbed(`pubky://${RIO}/pub/pubky.app/posts/0033SREKPC4N0`, PubkyAppPostKind.Video);
-const { post: repost, meta: repostMeta } = specsBuilder.createPost("This is a repost to random post!", PubkyAppPostKind.Short, null, embeed, null);
-console.log("Repost Post ID:", repostMeta.id);
-console.log("Repost Post URL:", repostMeta.url);
-console.log("Repost Data:", JSON.stringify(repost.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("🔖 Creating Bookmark...");
-let { bookmark, meta: bookmarkMeta } = specsBuilder.createBookmark(`pubky://${RIO}/pub/pubky.app/posts/0033SREKPC4N0`);
-console.log("Bookmark ID:", bookmarkMeta.id);
-console.log("Bookmark URL:", bookmarkMeta.url);
-console.log("Bookmark Data:", JSON.stringify(bookmark.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("👥 Creating Follow...");
-let {follow, meta: followMeta} = specsBuilder.createFollow(RIO);
-console.log("Follow ID:", followMeta.id);
-console.log("Follow URL:", followMeta.url);
-console.log("Follow Data:", JSON.stringify(follow.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("🏷️ Creating Tag...");
-let {tag, meta: tagMeta} = specsBuilder.createTag(`pubky://${OTTO}/pub/pubky.app/profile.json`, "otto");
-console.log("Tag ID:", tagMeta.id);
-console.log("Tag URL:", tagMeta.url);
-console.log("Tag Data:", JSON.stringify(tag.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("🔇 Creating Mute...");
-let {mute, meta: muteMeta} = specsBuilder.createMute(RIO);
-console.log("Mute ID:", muteMeta.id);
-console.log("Mute URL:", muteMeta.url);
-console.log("Mute Data:", JSON.stringify(mute.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("📖 Creating Last Read...");
-let {last_read, meta: lastReadMeta} = specsBuilder.createLastRead(RIO);
-console.log("LastRead Timestamp:", lastReadMeta.url);
-console.log("LastRead Data:", JSON.stringify(last_read.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("💾 Creating Blob...");
-let { blob, meta: blobMeta } = specsBuilder.createBlob(Array.from({length: 8}, () => Math.floor(Math.random() * 256)));
-console.log("Blob ID:", blobMeta.id);
-console.log("Blob URL:", blobMeta.url);
-console.log("Blob Data:", JSON.stringify(blob.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("📄 Creating File...");
-let { file, meta: fileMeta } = specsBuilder.createFile("My adventures", blobMeta.url, "application/pdf", 88);
-console.log("File ID:", fileMeta.id);
-console.log("File URL:", fileMeta.url);
-console.log("File Data:", JSON.stringify(file.toJson(), null, 2));
-console.log("-".repeat(60));
-
-console.log("📰 Creating Feed...");
-let { feed, meta: feedMeta } = specsBuilder.createFeed(["mountain","hike"], "all", "columns", "recent", "image", "nature");
-console.log("Feed ID:", feedMeta.id);
-console.log("Feed URL:", feedMeta.url);
-console.log("Feed Data:", JSON.stringify(feed.toJson(), null, 2));
-console.log("=".repeat(60));
-console.log("🎉 All Pubky App Specs examples completed successfully!");
-console.log("=".repeat(60));
+console.log(`${c.dim}Using PubkyId: ${c.reset}${c.cyan}${OTTO}${c.reset}`);
+
+// =============================================================================
+// 1. User Profile
+// =============================================================================
+header("USER PROFILE");
+const { user, meta: userMeta } = specsBuilder.createUser(
+  "Alice Smith",
+  "Software Developer",
+  null,
+  null,
+  "active"
+);
+field("URL", userMeta.url);
+field("Name", user.toJson().name);
+field("Bio", user.toJson().bio);
+field("Status", user.toJson().status);
+
+// =============================================================================
+// 2. Posts
+// =============================================================================
+header("POSTS");
+
+// Simple post
+console.log(`  ${c.yellow}▸ Simple Post${c.reset}`);
+const { post, meta } = specsBuilder.createPost(
+  "Hello, Pubky world! This is my first post.",
+  PubkyAppPostKind.Short,
+  null,
+  null,
+  null
+);
+field("ID", meta.id);
+field("URL", meta.url);
+field("Content", post.toJson().content);
+console.log();
+
+// Reply post
+console.log(`  ${c.yellow}▸ Reply Post${c.reset}`);
+const { post: replyPost, meta: replyMeta } = specsBuilder.createPost(
+  "This is a reply to the first post!",
+  PubkyAppPostKind.Short,
+  userMeta.url,
+  null,
+  null
+);
+field("ID", replyMeta.id);
+field("Parent", replyPost.toJson().parent);
+console.log();
+
+// Repost with embed
+console.log(`  ${c.yellow}▸ Repost with Embed${c.reset}`);
+const embed = new PubkyAppPostEmbed(
+  `pubky://${RIO}/pub/pubky.app/posts/0033SREKPC4N0`,
+  PubkyAppPostKind.Video
+);
+const { post: repost, meta: repostMeta } = specsBuilder.createPost(
+  "Check out this awesome video!",
+  PubkyAppPostKind.Short,
+  null,
+  embed,
+  null
+);
+field("ID", repostMeta.id);
+field("Embed URI", repost.toJson().embed.uri);
+field("Embed Kind", repost.toJson().embed.kind);
+console.log();
+
+// Post with attachments
+console.log(`  ${c.yellow}▸ Post with Attachments${c.reset}`);
+const { post: postWithAttachments, meta: postWithAttachmentsMeta } = specsBuilder.createPost(
+  "Check out these photos from my trip!",
+  PubkyAppPostKind.Image,
+  null,
+  null,
+  [
+    `pubky://${OTTO}/pub/pubky.app/files/0034A0X7NJ52G`,
+    `pubky://${OTTO}/pub/pubky.app/files/0034A0X7NJ53H`,
+  ]
+);
+field("ID", postWithAttachmentsMeta.id);
+field("Attachments", `${postWithAttachments.toJson().attachments.length} files`);
+
+// =============================================================================
+// 3. Social Actions
+// =============================================================================
+header("SOCIAL ACTIONS");
+
+// Bookmark
+console.log(`  ${c.yellow}▸ Bookmark${c.reset}`);
+const { bookmark, meta: bookmarkMeta } = specsBuilder.createBookmark(
+  `pubky://${RIO}/pub/pubky.app/posts/0033SREKPC4N0`
+);
+field("ID", bookmarkMeta.id);
+field("URI", bookmark.toJson().uri);
+console.log();
+
+// Follow
+console.log(`  ${c.yellow}▸ Follow${c.reset}`);
+const { follow, meta: followMeta } = specsBuilder.createFollow(RIO);
+field("ID", followMeta.id);
+field("URL", followMeta.url);
+console.log();
+
+// Tag
+console.log(`  ${c.yellow}▸ Tag${c.reset}`);
+const { tag, meta: tagMeta } = specsBuilder.createTag(
+  `pubky://${OTTO}/pub/pubky.app/profile.json`,
+  "developer"
+);
+field("ID", tagMeta.id);
+field("Label", tag.toJson().label);
+field("URI", tag.toJson().uri);
+console.log();
+
+// Mute
+console.log(`  ${c.yellow}▸ Mute${c.reset}`);
+const { mute, meta: muteMeta } = specsBuilder.createMute(RIO);
+field("ID", muteMeta.id);
+field("URL", muteMeta.url);
+
+// =============================================================================
+// 4. Files & Blobs
+// =============================================================================
+header("FILES & BLOBS");
+
+// Blob
+console.log(`  ${c.yellow}▸ Blob (raw data)${c.reset}`);
+const blobData = Array.from({ length: 8 }, () => Math.floor(Math.random() * 256));
+const { blob, meta: blobMeta } = specsBuilder.createBlob(blobData);
+field("ID", blobMeta.id);
+field("URL", blobMeta.url);
+field("Size", `${blobData.length} bytes`);
+console.log();
+
+// File
+console.log(`  ${c.yellow}▸ File (metadata)${c.reset}`);
+const { file, meta: fileMeta } = specsBuilder.createFile(
+  "vacation-photos.pdf",
+  blobMeta.url,
+  "application/pdf",
+  1024
+);
+field("ID", fileMeta.id);
+field("Name", file.toJson().name);
+field("Type", file.toJson().content_type);
+field("Size", `${file.toJson().size} bytes`);
+field("Source", file.toJson().src);
+
+// =============================================================================
+// 5. Feeds & LastRead
+// =============================================================================
+header("FEEDS & LAST READ");
+
+// Feed
+console.log(`  ${c.yellow}▸ Custom Feed${c.reset}`);
+const { feed, meta: feedMeta } = specsBuilder.createFeed(
+  ["mountain", "hiking", "nature"],
+  "all",
+  "columns",
+  "recent",
+  "image",
+  "Outdoor Adventures"
+);
+field("ID", feedMeta.id);
+field("Name", feed.toJson().name);
+field("Tags", feed.toJson().feed.tags.join(", "));
+field("Layout", feed.toJson().feed.layout);
+field("Sort", feed.toJson().feed.sort);
+console.log();
+
+// LastRead
+console.log(`  ${c.yellow}▸ Last Read Marker${c.reset}`);
+const { last_read, meta: lastReadMeta } = specsBuilder.createLastRead();
+field("URL", lastReadMeta.url);
+field("Timestamp", new Date(last_read.toJson().timestamp / 1000).toISOString());
+
+// =============================================================================
+// 6. URI Builders
+// =============================================================================
+header("URI BUILDERS");
+const uris = [
+  ["User", userUriBuilder(OTTO)],
+  ["Post", postUriBuilder(OTTO, meta.id)],
+  ["Bookmark", bookmarkUriBuilder(OTTO, bookmarkMeta.id)],
+  ["Follow", followUriBuilder(OTTO, RIO)],
+  ["Tag", tagUriBuilder(OTTO, tagMeta.id)],
+  ["Mute", muteUriBuilder(OTTO, RIO)],
+  ["LastRead", lastReadUriBuilder(OTTO)],
+  ["Blob", blobUriBuilder(OTTO, blobMeta.id)],
+  ["File", fileUriBuilder(OTTO, fileMeta.id)],
+  ["Feed", feedUriBuilder(OTTO, feedMeta.id)],
+];
+uris.forEach(([name, uri]) => {
+  console.log(`  ${c.dim}${name.padEnd(10)}${c.reset} ${c.cyan}${uri}${c.reset}`);
+});
+
+// =============================================================================
+// 7. Valid MIME Types
+// =============================================================================
+header("VALID MIME TYPES");
+const validMimeTypes = getValidMimeTypes();
+console.log(`  ${c.dim}Total types:${c.reset} ${c.bright}${validMimeTypes.length}${c.reset}`);
+console.log();
+
+// Group by category
+const categories = {
+  "Images": validMimeTypes.filter(t => t.startsWith("image/")),
+  "Videos": validMimeTypes.filter(t => t.startsWith("video/")),
+  "Audio": validMimeTypes.filter(t => t.startsWith("audio/")),
+  "Documents": validMimeTypes.filter(t => t.startsWith("application/") || t.startsWith("text/")),
+};
+
+Object.entries(categories).forEach(([category, types]) => {
+  if (types.length > 0) {
+    console.log(`  ${c.yellow}${category}:${c.reset}`);
+    types.forEach(type => console.log(`    ${c.dim}-${c.reset} ${type}`));
+    console.log();
+  }
+});
+
+// Validation example
+console.log(`  ${c.yellow}Validation Example:${c.reset}`);
+const testTypes = ["image/png", "video/mp4", "application/x-executable"];
+testTypes.forEach(type => {
+  const isValid = validMimeTypes.includes(type);
+  const icon = isValid ? `${c.green}[ok]${c.reset}` : `${c.magenta}[x]${c.reset}`;
+  console.log(`    ${icon} ${type}`);
+});
+
+// =============================================================================
+// Done!
+// =============================================================================
+console.log();
+console.log(`${c.bgBlue}${c.white}${c.bright}                                                                      ${c.reset}`);
+console.log(`${c.bgBlue}${c.white}${c.bright}                 ALL EXAMPLES COMPLETED SUCCESSFULLY!                 ${c.reset}`);
+console.log(`${c.bgBlue}${c.white}${c.bright}                                                                      ${c.reset}`);
+console.log();

package/index.cjs

@@ -446,6 +446,32 @@ module.exports.lastReadUriBuilder = function(author_id) {
     }
 };
 
+/**
+ * Returns the list of valid MIME types for file attachments.
+ *
+ * This allows JavaScript consumers to validate file types before submission
+ * without having to duplicate the list.
+ *
+ * # Example (TypeScript)
+ *
+ * ```typescript
+ * import { get_valid_mime_types } from "pubky-app-specs";
+ *
+ * const validTypes = get_valid_mime_types();
+ * const fileType = "image/png";
+ * if (validTypes.includes(fileType)) {
+ *   console.log("Valid file type!");
+ * }
+ * ```
+ * @returns {any[]}
+ */
+module.exports.getValidMimeTypes = function() {
+    const ret = wasm.getValidMimeTypes();
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v1;
+};
+
 /**
  * Parses a Pubky URI and returns a strongly typed `ParsedUriResult`.
  *