pubky-app-specs 0.5.2 → 0.6.0

package/README.md

@@ -1,15 +1,13 @@
-# Pubky App Specs · `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:
+JavaScript and TypeScript bindings for Pubky.app data models, generated from the canonical Rust specs.
 
-- **Sanitized** and **Validated** via Rust logic.
-- **Auto-ID’ed** and **Auto-Pathed** according to your domain rules.
-- **Exported** to JavaScript/TypeScript with minimal overhead.
+The package initializes WASM automatically, so no manual `.wasm` loading is required.
 
-## 🤔 Why Use This Crate Instead of [Manual JSONs](https://github.com/pubky/pubky-app-specs?tab=readme-ov-file#data-models)?
+## Why Use This Package Instead of Manual JSONs?
 
 - **Validation Consistency**: Ensures your app uses the same sanitization and validation rules as [Pubky indexers](https://github.com/pubky/pubky-nexus), avoiding errors.
 - **Schema Versioning**: Automatically stay up-to-date with schema changes, reducing maintenance overhead.
@@ -17,257 +15,67 @@ A WASM library for building and validating structured JSON models compatible wit
 - **Rust-to-JavaScript Compatibility**: Type-safe models that work seamlessly across Rust and JavaScript/TypeScript.
 - **Future-Proof**: Easily adapt to new Pubky object types without rewriting JSON manually.
 
----
-
-## ⚙️ Installation
+## Installation
 
 ```bash
 npm install pubky-app-specs
-# or
-yarn add pubky-app-specs
 ```
 
-> **Note**: This package uses WASM with embedded bytes for automatic initialization. No manual WASM loading required - just import and use!
-
----
-
-## 🚀 Quick Start
-
-1. **Import** the library.
-2. **Construct** a `PubkySpecsBuilder(pubkyId)` object.
-3. **Create** validated domain objects (User, Post, Tag, etc.).
-4. **Store** them on the [PubKy homeserver](https://github.com/synonymdev/pubky) or any distributed storage solution you prefer.
-
-### Import & Usage
-
-```js
-// ES Modules
-import { PubkySpecsBuilder } from "pubky-app-specs";
-
-// OR CommonJS
-const { PubkySpecsBuilder } = require("pubky-app-specs");
-
-function loadSpecs(pubkyId) {
-  // Create a specs builder instance - WASM is already initialized
-  const specs = new PubkySpecsBuilder(pubkyId);
-  return specs;
-}
-```
-
----
-
-## 🎨 Example Usage
-
-Below are **succinct** examples to illustrate how to create or update data using **`pubky-app-specs`** and then **store** it with [`@synonymdev/pubky`](https://www.npmjs.com/package/@synonymdev/pubky).
-
-### 1) Creating a New User
-
-```js
-import { Client, PublicKey } from "@synonymdev/pubky";
-import { PubkySpecsBuilder } from "pubky-app-specs";
-
-async function createUser(pubkyId) {
-  const client = new Client();
-  const specs = new PubkySpecsBuilder(pubkyId);
-
-  // Create user object with minimal fields
-  const { user, meta } = specs.createUser(
-    "Alice", // Name
-    "Hello from WASM", // Bio
-    null, // Image URL or File
-    null, // Links
-    "active", // Status
-  );
-
-  // meta contains { id, path, url }.
-  // user is the Rust "PubkyAppUser" object.
-
-  // We bring the Rust object to JS using the .toJson() method.
-  const userJson = user.toJson();
-
-  // Store in homeserver via pubky
-  const response = await client.fetch(meta.url, {
-    method: "PUT",
-    body: JSON.stringify(userJson),
-    credentials: "include",
-  });
-
-  if (!response.ok) {
-    throw new Error(`Failed to store user: ${response.statusText}`);
-  }
-
-  console.log("User stored at:", meta.url);
-  return { user, meta };
-}
-```
-
-### 2) Creating a Post
-
-```js
-import { Client } from "@synonymdev/pubky";
-import { PubkySpecsBuilder, PubkyAppPostKind } from "pubky-app-specs";
-
-async function createPost(pubkyId, content) {
-  const client = new Client();
-  const specs = new PubkySpecsBuilder(pubkyId);
-
-  // Create the Post object
-  const { post, meta } = specs.createPost(
-    content,
-    PubkyAppPostKind.Short,
-    null, // parent post URI (for replies)
-    null, // embed object (for reposts)
-    null, // attachments (array of file URLs, max 3)
-  );
-
-  // Store the post
-  const postJson = post.toJson();
-  await client.fetch(meta.url, {
-    method: "PUT",
-    body: JSON.stringify(postJson),
-  });
-
-  console.log("Post stored at:", meta.url);
-  return { post, meta };
-}
-```
-
-### 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 };
-}
+```bash
+yarn add pubky-app-specs
 ```
 
-### 4) Following a User
+## Quick Start
 
 ```js
-import { Client } from "@synonymdev/pubky";
-import { PubkySpecsBuilder } from "pubky-app-specs";
-
-async function followUser(myPubkyId, userToFollow) {
-  const client = new Client();
-  const specs = new PubkySpecsBuilder(myPubkyId);
-
-  const { follow, meta } = specs.createFollow(userToFollow);
-
-  // We only need to store the JSON in the homeserver
-  await client.fetch(meta.url, {
-    method: "PUT",
-    body: JSON.stringify(follow.toJson()),
-  });
-
-  console.log(`Successfully followed: ${userToFollow}`);
-}
-```
+import { PubkyAppPostKind, PubkySpecsBuilder } from "pubky-app-specs";
 
----
+const pubkyId = "8kkppkmiubfq4pxn6f73nqrhhhgkb5xyfprntc9si3np9ydbotto";
+const specs = new PubkySpecsBuilder(pubkyId);
 
-## 📁 Additional Models
+const { user, meta: userMeta } = specs.createUser(
+  "Alice",
+  "Building on Pubky",
+  null,
+  null,
+  "active"
+);
 
-This library supports many more domain objects beyond `User` and `Post`. Here are a few more you can explore:
+console.log(userMeta.url); // pubky://.../pub/pubky.app/profile.json
+console.log(user.toJson());
 
-- **Feeds**: `createFeed(...)`
-- **Bookmarks**: `createBookmark(...)`
-- **Tags**: `createTag(...)`
-- **Mutes**: `createMute(...)`
-- **Follows**: `createFollow(...)`
-- **LastRead**: `createLastRead(...)`
-- **Blobs**: `createBlob(...)`
-- **Files**: `createFile(...)`
+const { post, meta: postMeta } = specs.createPost(
+  "Hello, Pubky!",
+  PubkyAppPostKind.Short
+);
 
-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 };
-}
+console.log(postMeta.url);
+console.log(post.toJson());
 ```
 
----
+Each create method returns:
 
-## ✅ Validating File MIME Types
+- `meta`: generated `id`, storage `path`, and full `url`
+- a typed WASM model object with `.toJson()`
 
-Use `getValidMimeTypes()` to get the list of allowed MIME types for file attachments. This helps validate files before upload without duplicating the validation list.
+## Common Models
 
 ```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}`);
-}
+const { user, meta } = specs.createUser(name, bio, image, links, status);
+const { post, meta } = specs.createPost(content, kind, parent, embed, attachments, lock);
+const { file, meta } = specs.createFile(name, src, contentType, size);
+const { blob, meta } = specs.createBlob(bytes);
+const { bookmark, meta } = specs.createBookmark(uri);
+const { tag, meta } = specs.createTag(uri, label);
+const { follow, meta } = specs.createFollow(pubkyId);
+const { mute, meta } = specs.createMute(pubkyId);
+const { feed, meta } = specs.createFeed(tags, reach, layout, sort, content, name);
+const { last_read, meta } = specs.createLastRead();
 ```
 
-## 🔗 URI Builder Utilities
+For runnable examples covering posts, embeds, files, feeds, URI helpers, and MIME type validation, see [`example.js`](https://github.com/pubky/pubky-app-specs/blob/main/pkg/example.js).
 
-These helper functions construct properly formatted Pubky URIs:
+## URI Helpers
 
 ```js
 import {
@@ -281,129 +89,72 @@ import {
   blobUriBuilder,
   fileUriBuilder,
   feedUriBuilder,
+  parse_uri,
 } 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.
+const userUri = userUriBuilder(pubkyId);
+const postUri = postUriBuilder(pubkyId, "0033SSE3B1FQ0");
+const parsed = parse_uri(postUri);
 
-**Usage:**
-
-```js
-import { parse_uri } from "pubky-app-specs";
-
-try {
-  const result = parse_uri("pubky://userID/pub/pubky.app/posts/postID");
-  console.log(result.user_id); // "userID"
-  console.log(result.resource); // e.g. "posts"
-  console.log(result.resource_id); // "postID" or null
-} catch (error) {
-  console.error("URI parse error:", error);
-}
+console.log(parsed.user_id);
+console.log(parsed.resource);
+console.log(parsed.resource_id);
 ```
 
-**Returns:**
-
-A `ParsedUriResult` object with:
+## Validation Limits
 
-- **user_id:** The parsed user identifier.
-- **resource:** A string indicating the resource type.
-- **resource_id:** An optional resource identifier.
-
----
-
-## Validation limits
-
-Validation limits are published as JSON so UIs and tests can reuse the
-canonical rules without WASM, plus optional WASM accessors when needed.
-
-### ✅ Recommended (no WASM)
-
-**Named export from the package root:**
+Validation limits are published as JSON so apps can reuse canonical limits without initializing WASM.
 
 ```js
-import { validationLimits, getValidationLimits } from "pubky-app-specs";
+import limits, {
+  getValidationLimits,
+  validationLimits,
+} from "pubky-app-specs/validationLimits";
+
+console.log(validationLimits.userNameMaxLength);
+console.log(limits.postShortContentMaxLength);
 
-console.log(validationLimits);
 const copy = getValidationLimits();
 ```
 
-**Direct subpath import (ESM):**
+For raw JSON imports:
 
 ```js
-import limits from "pubky-app-specs/validationLimits";
-// or
 import limitsJson from "pubky-app-specs/validationLimits.json";
+
+console.log(limitsJson.postAttachmentsMaxCount);
 ```
 
-**Direct subpath import (CJS):**
+## MIME Types
 
 ```js
-const { validationLimits, getValidationLimits } = require("pubky-app-specs");
-// or
-const limits = require("pubky-app-specs/validationLimits");
+import { getValidMimeTypes } from "pubky-app-specs";
+
+const validMimeTypes = getValidMimeTypes();
+
+if (!validMimeTypes.includes(file.type)) {
+  throw new Error(`Unsupported file type: ${file.type}`);
+}
 ```
 
-### WASM accessors
+## Specification
 
-```js
-import { PubkySpecsBuilder, getValidationLimits } from "pubky-app-specs";
+See the [full data model specification](https://github.com/pubky/pubky-app-specs/blob/main/SPEC.md) for URI layout, field rules, examples, and validation behavior.
 
-const limitsFromWasm = getValidationLimits();
+## Building from Source
 
-const builder = new PubkySpecsBuilder("pubky_id_here");
-const limitsFromBuilder = builder.validationLimits;
-```
+Prerequisites: Rust, the `wasm32-unknown-unknown` target, [`wasm-pack`](https://rustwasm.github.io/wasm-pack/), and Node.js.
 
-Example output shape:
-
-```json
-{
-  "maxBlobSizeBytes": 104857600,
-  "maxFileSizeBytes": 104857600,
-  "tagLabelMinLength": 1,
-  "tagLabelMaxLength": 20,
-  "tagInvalidChars": [",", ":", " ", "\t", "\n", "\r"],
-  "userNameMinLength": 3,
-  "userNameMaxLength": 50,
-  "userBioMaxLength": 160,
-  "userImageUrlMaxLength": 300,
-  "userLinksMaxCount": 5,
-  "userLinkTitleMaxLength": 100,
-  "userLinkUrlMaxLength": 300,
-  "userStatusMaxLength": 50,
-  "postShortContentMaxLength": 2000,
-  "postLongContentMaxLength": 50000,
-  "postAttachmentsMaxCount": 4,
-  "postAttachmentUrlMaxLength": 200,
-  "postAllowedAttachmentProtocols": ["pubky", "http", "https"],
-  "fileNameMinLength": 1,
-  "fileNameMaxLength": 255,
-  "fileSrcMaxLength": 1024,
-  "feedTagsMaxCount": 5
-}
-```
+```bash
+rustup target add wasm32-unknown-unknown
 
----
+cd pkg
+npm install
+npm run build
+npm run test
+npm run example
+```
 
-## 📄 License
+## License
 
 MIT

package/example.js

@@ -14,6 +14,7 @@ import {
   feedUriBuilder,
   getValidMimeTypes,
 } from "./index.js";
+import { getValidationLimits, validationLimits } from "./validationLimits.js";
 
 // =============================================================================
 // ANSI color helpers for pretty output
@@ -30,6 +31,8 @@ const c = {
   gray: "\x1b[90m",
   white: "\x1b[37m",
   bgBlue: "\x1b[44m",
+  bgGreen: "\x1b[42m",
+  black: "\x1b[30m",
 };
 
 const divider = () => console.log(c.gray + "─".repeat(70) + c.reset);
@@ -82,10 +85,7 @@ header("POSTS");
 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
+  PubkyAppPostKind.Short
 );
 field("ID", meta.id);
 field("URL", meta.url);
@@ -97,9 +97,7 @@ 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
+  userMeta.url
 );
 field("ID", replyMeta.id);
 field("Parent", replyPost.toJson().parent);
@@ -115,8 +113,7 @@ const { post: repost, meta: repostMeta } = specsBuilder.createPost(
   "Check out this awesome video!",
   PubkyAppPostKind.Short,
   null,
-  embed,
-  null
+  embed
 );
 field("ID", repostMeta.id);
 field("Embed URI", repost.toJson().embed.uri);
@@ -137,6 +134,22 @@ const { post: postWithAttachments, meta: postWithAttachmentsMeta } = specsBuilde
 );
 field("ID", postWithAttachmentsMeta.id);
 field("Attachments", `${postWithAttachments.toJson().attachments.length} files`);
+console.log();
+
+// Locked post (gated behind a lock server)
+console.log(`  ${c.yellow}▸ Locked Post${c.reset}`);
+const lockUrl = `pubky://${RIO}/pub/locks/0034A0X7NJ52G`;
+const { post: lockedPost, meta: lockedPostMeta } = specsBuilder.createPost(
+  "We were reckless adopting Lightning without understanding the tradeoffs.",
+  PubkyAppPostKind.Long,
+  null,
+  null,
+  null,
+  lockUrl
+);
+field("ID", lockedPostMeta.id);
+field("Content", lockedPost.toJson().content);
+field("Lock", lockedPost.lock);
 
 // =============================================================================
 // 3. Social Actions
@@ -285,11 +298,22 @@ testTypes.forEach(type => {
   console.log(`    ${icon} ${type}`);
 });
 
+// =============================================================================
+// 8. Validation Limits
+// =============================================================================
+header("VALIDATION LIMITS");
+const limitsCopy = getValidationLimits();
+
+field("User name max", validationLimits.userNameMaxLength);
+field("Short post max", validationLimits.postShortContentMaxLength);
+field("Max attachments", validationLimits.postAttachmentsMaxCount);
+field("Copy matches", JSON.stringify(limitsCopy) === JSON.stringify(validationLimits));
+
 // =============================================================================
 // 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(`${c.bgGreen}${c.black}${c.bright}                                                                      ${c.reset}`);
+console.log(`${c.bgGreen}${c.black}${c.bright}                 ALL EXAMPLES COMPLETED SUCCESSFULLY!                 ${c.reset}`);
+console.log(`${c.bgGreen}${c.black}${c.bright}                                                                      ${c.reset}`);
 console.log();

package/index.cjs

@@ -743,12 +743,13 @@ exports.PubkyAppFeedConfig = PubkyAppFeedConfig;
 
 /**
  * Enum representing the layout of the feed.
- * @enum {0 | 1 | 2}
+ * @enum {0 | 1 | 2 | 3}
  */
 const PubkyAppFeedLayout = Object.freeze({
     Columns: 0, "0": "Columns",
     Wide: 1, "1": "Wide",
     Visual: 2, "2": "Visual",
+    List: 3, "3": "List",
 });
 exports.PubkyAppFeedLayout = PubkyAppFeedLayout;
 
@@ -1170,6 +1171,18 @@ class PubkyAppPost {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * @returns {string | undefined}
+     */
+    get lock() {
+        const ret = wasm.pubkyapppost_lock(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]).slice();
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
     /**
      * Creates a new `PubkyAppPost` instance and sanitizes it.
      * @param {string} content
@@ -1195,6 +1208,33 @@ class PubkyAppPost {
         PubkyAppPostFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
+    /**
+     * Creates a new lockable `PubkyAppPost` instance and sanitizes it.
+     * @param {string} content
+     * @param {PubkyAppPostKind} kind
+     * @param {string | null} [parent]
+     * @param {PubkyAppPostEmbed | null} [embed]
+     * @param {string[] | null} [attachments]
+     * @param {string | null} [lock]
+     * @returns {PubkyAppPost}
+     */
+    static new_with_lock(content, kind, parent, embed, attachments, lock) {
+        const ptr0 = passStringToWasm0(content, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        const len0 = WASM_VECTOR_LEN;
+        var ptr1 = isLikeNone(parent) ? 0 : passStringToWasm0(parent, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len1 = WASM_VECTOR_LEN;
+        let ptr2 = 0;
+        if (!isLikeNone(embed)) {
+            _assertClass(embed, PubkyAppPostEmbed);
+            ptr2 = embed.__destroy_into_raw();
+        }
+        var ptr3 = isLikeNone(attachments) ? 0 : passArrayJsValueToWasm0(attachments, wasm.__wbindgen_malloc);
+        var len3 = WASM_VECTOR_LEN;
+        var ptr4 = isLikeNone(lock) ? 0 : passStringToWasm0(lock, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len4 = WASM_VECTOR_LEN;
+        const ret = wasm.pubkyapppost_new_with_lock(ptr0, len0, kind, ptr1, len1, ptr2, ptr3, len3, ptr4, len4);
+        return PubkyAppPost.__wrap(ret);
+    }
     /**
      * @returns {string | undefined}
      */
@@ -1784,14 +1824,16 @@ class PubkySpecsBuilder {
         return MuteResult.__wrap(ret[0]);
     }
     /**
+     * Optional `lock`: `pubky://` URL with a host pointing at a lock server.
      * @param {string} content
      * @param {PubkyAppPostKind} kind
      * @param {string | null} [parent]
      * @param {PubkyAppPostEmbed | null} [embed]
      * @param {string[] | null} [attachments]
+     * @param {string | null} [lock]
      * @returns {PostResult}
      */
-    createPost(content, kind, parent, embed, attachments) {
+    createPost(content, kind, parent, embed, attachments, lock) {
         const ptr0 = passStringToWasm0(content, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
         const len0 = WASM_VECTOR_LEN;
         var ptr1 = isLikeNone(parent) ? 0 : passStringToWasm0(parent, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -1803,7 +1845,9 @@ class PubkySpecsBuilder {
         }
         var ptr3 = isLikeNone(attachments) ? 0 : passArrayJsValueToWasm0(attachments, wasm.__wbindgen_malloc);
         var len3 = WASM_VECTOR_LEN;
-        const ret = wasm.pubkyspecsbuilder_createPost(this.__wbg_ptr, ptr0, len0, kind, ptr1, len1, ptr2, ptr3, len3);
+        var ptr4 = isLikeNone(lock) ? 0 : passStringToWasm0(lock, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len4 = WASM_VECTOR_LEN;
+        const ret = wasm.pubkyspecsbuilder_createPost(this.__wbg_ptr, ptr0, len0, kind, ptr1, len1, ptr2, ptr3, len3, ptr4, len4);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }