pubky-app-specs 0.4.3 → 0.5.0

package/pubky_app_specs.d.ts

@@ -1,194 +1,71 @@
 /* tslint:disable */
 /* eslint-disable */
-export function baseUriBuilder(user_id: string): string;
-/**
- * Builds an User URI of the form "pubky://<user_pubky_id>/pub/pubky.app/profile.json"
- */
-export function userUriBuilder(user_id: string): string;
-/**
- * Builds a Post URI of the form "pubky://<author_id>/pub/pubky.app/posts/<post_id>"
- */
-export function postUriBuilder(author_id: string, post_id: string): string;
-/**
- * Builds a Follow URI of the form "pubky://<author_id>/pub/pubky.app/follows/<follow_id>"
- */
-export function followUriBuilder(author_id: string, follow_id: string): string;
-/**
- * Builds a Mute URI of the form "pubky://<author_id>/pub/pubky.app/mutes/<mute_id>"
- */
-export function muteUriBuilder(author_id: string, mute_id: string): string;
-/**
- * Builds a Bookmark URI of the form "pubky://<author_id>/pub/pubky.app/bookmarks/<bookmark_id>"
- */
-export function bookmarkUriBuilder(author_id: string, bookmark_id: string): string;
-/**
- * Builds a Tag URI of the form "pubky://<author_id>/pub/pubky.app/tags/<tag_id>"
- */
-export function tagUriBuilder(author_id: string, tag_id: string): string;
-/**
- * Builds a File URI of the form "pubky://<author_id>/pub/pubky.app/files/<file_id>"
- */
-export function fileUriBuilder(author_id: string, file_id: string): string;
-/**
- * Builds a Blob URI of the form "pubky://<author_id>/pub/pubky.app/blobs/<blob_id>"
- */
-export function blobUriBuilder(author_id: string, blob_id: string): string;
-/**
- * Builds a Feed URI of the form "pubky://<author_id>/pub/pubky.app/feeds/<feed_id>"
- */
-export function feedUriBuilder(author_id: string, feed_id: string): string;
-/**
- * Builds a LastRead URI of the form "pubky://<author_id>/pub/pubky.app/last_read"
- */
-export function lastReadUriBuilder(author_id: string): string;
-/**
- * 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!");
- * }
- * ```
- */
-export function getValidMimeTypes(): any[];
-/**
- * Parses a Pubky URI and returns a strongly typed `ParsedUriResult`.
- *
- * This function wraps the internal ParsedUri ust parsing logic. It converts the result into a
- * strongly typed object that is easier to use in TypeScript.
- *
- * # Parameters
- *
- * - `uri`: A string slice representing the Pubky URI. The URI should follow the format:
- *   `pubky://<user_id>/pub/pubky.app/<resource>[/<id>]`.
- *
- * # Returns
- *
- * On success, returns a `ParsedUriResult` with:
- * - `user_id`: the parsed user ID,
- * - `resource`: a string (derived from the Display implementation of internal `Resource` enum),
- * - `resource_id`: an optional resource identifier (if applicable).
- *
- * On failure, returns a JavaScript error (`String`) containing an error message.
- *
- * # Example (TypeScript)
- *
- * ```typescript
- * import { parse_uri } from "pubky-app-specs";
- *
- * try {
- *   const result = parse_uri("pubky://user123/pub/pubky.app/posts/abc123");
- *   console.log(result.user_id);        // e.g. "user123"
- *   console.log(result.resource);    // e.g. "posts"
- *   console.log(result.resource_id);      // e.g. "abc123" or null
- * } catch (error) {
- *   console.error("Error parsing URI:", error);
- * }
- * ```
- */
-export function parse_uri(uri: string): ParsedUriResult;
-/**
- * Enum representing the layout of the feed.
- */
-export enum PubkyAppFeedLayout {
-  Columns = 0,
-  Wide = 1,
-  Visual = 2,
-}
-/**
- * Enum representing the reach of the feed.
- */
-export enum PubkyAppFeedReach {
-  Following = 0,
-  Followers = 1,
-  Friends = 2,
-  All = 3,
-}
-/**
- * Enum representing the sort order of the feed.
- */
-export enum PubkyAppFeedSort {
-  Recent = 0,
-  Popularity = 1,
-}
-/**
- * Represents the type of pubky-app posted data
- * Used primarily to best display the content in UI
- */
-export enum PubkyAppPostKind {
-  Short = 0,
-  Long = 1,
-  Image = 2,
-  Video = 3,
-  Link = 4,
-  File = 5,
-}
+
 export class BlobResult {
-  private constructor();
-  free(): void;
-  readonly blob: PubkyAppBlob;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly blob: PubkyAppBlob;
+    readonly meta: Meta;
 }
+
 export class BookmarkResult {
-  private constructor();
-  free(): void;
-  readonly bookmark: PubkyAppBookmark;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly bookmark: PubkyAppBookmark;
+    readonly meta: Meta;
 }
+
 export class FeedResult {
-  private constructor();
-  free(): void;
-  readonly feed: PubkyAppFeed;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly feed: PubkyAppFeed;
+    readonly meta: Meta;
 }
+
 export class FileResult {
-  private constructor();
-  free(): void;
-  readonly file: PubkyAppFile;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly file: PubkyAppFile;
+    readonly meta: Meta;
 }
+
 export class FollowResult {
-  private constructor();
-  free(): void;
-  readonly follow: PubkyAppFollow;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly follow: PubkyAppFollow;
+    readonly meta: Meta;
 }
+
 export class LastReadResult {
-  private constructor();
-  free(): void;
-  readonly last_read: PubkyAppLastRead;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly last_read: PubkyAppLastRead;
+    readonly meta: Meta;
 }
-/**
- * Each FFI function:
- * - Accepts minimal fields in a JavaScript-friendly manner (e.g. strings, JSON).
- * - Creates the Rust model, sanitizes, and validates it.
- * - Generates the ID (if applicable).
- * - Generates the path (if applicable).
- * - Returns { json, id, path, url } or a descriptive error.
- */
+
 export class Meta {
-  private constructor();
-  free(): void;
-  readonly id: string;
-  readonly path: string;
-  readonly url: string;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly id: string;
+    readonly path: string;
+    readonly url: string;
 }
+
 export class MuteResult {
-  private constructor();
-  free(): void;
-  readonly mute: PubkyAppMute;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly meta: Meta;
+    readonly mute: PubkyAppMute;
 }
+
 /**
  * This object represents the result of parsing a Pubky URI. It contains:
  * - `user_id`: the parsed user ID as a string.
@@ -196,41 +73,47 @@ export class MuteResult {
  * - `resource_id`: an optional resource identifier (if applicable).
  */
 export class ParsedUriResult {
-  private constructor();
-  free(): void;
-  /**
-   * Returns the user ID.
-   */
-  readonly user_id: string;
-  /**
-   * Returns the resource kind.
-   */
-  readonly resource: string;
-  /**
-   * Returns the resource ID if present.
-   */
-  readonly resource_id: string | undefined;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Returns the resource kind.
+     */
+    readonly resource: string;
+    /**
+     * Returns the resource ID if present.
+     */
+    readonly resource_id: string | undefined;
+    /**
+     * Returns the user ID.
+     */
+    readonly user_id: string;
 }
+
 export class PostResult {
-  private constructor();
-  free(): void;
-  readonly post: PubkyAppPost;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly meta: Meta;
+    readonly post: PubkyAppPost;
 }
+
 /**
  * Represents a blob, which backs a file uploaded by the user.
  * URI: /pub/pubky.app/blobs/:blob_id
  */
 export class PubkyAppBlob {
-  private constructor();
-  free(): void;
-  static fromJson(js_value: any): PubkyAppBlob;
-  toJson(): any;
-  /**
-   * Getter for the blob data as a `Uint8Array`.
-   */
-  readonly data: Uint8Array;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppBlob;
+    toJson(): any;
+    /**
+     * Getter for the blob data as a `Uint8Array`.
+     */
+    readonly data: Uint8Array;
 }
+
 /**
  * Represents raw homeserver bookmark with id
  * URI: /pub/pubky.app/bookmarks/:bookmark_id
@@ -242,84 +125,119 @@ export class PubkyAppBlob {
  * Where bookmark_id is Crockford-base32(Blake3("{uri_bookmarked}"")[:half])
  */
 export class PubkyAppBookmark {
-  private constructor();
-  free(): void;
-  /**
-   * Serialize to JSON for WASM.
-   */
-  static fromJson(js_value: any): PubkyAppBookmark;
-  toJson(): any;
-  created_at: bigint;
-  /**
-   * Getter for `uri`.
-   */
-  readonly uri: string;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Serialize to JSON for WASM.
+     */
+    static fromJson(js_value: any): PubkyAppBookmark;
+    toJson(): any;
+    created_at: bigint;
+    /**
+     * Getter for `uri`.
+     */
+    readonly uri: string;
 }
+
 /**
  * Represents a feed configuration.
  */
 export class PubkyAppFeed {
-  private constructor();
-  free(): void;
-  /**
-   * Serialize to JSON for WASM.
-   */
-  static fromJson(js_value: any): PubkyAppFeed;
-  toJson(): any;
-  created_at: bigint;
-  /**
-   * Getter for `feed`.
-   */
-  readonly feed: PubkyAppFeedConfig;
-  /**
-   * Getter for `name`.
-   */
-  readonly name: string;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Serialize to JSON for WASM.
+     */
+    static fromJson(js_value: any): PubkyAppFeed;
+    toJson(): any;
+    created_at: bigint;
+    /**
+     * Getter for `feed`.
+     */
+    readonly feed: PubkyAppFeedConfig;
+    /**
+     * Getter for `name`.
+     */
+    readonly name: string;
 }
+
 /**
  * Configuration object for the feed.
  */
 export class PubkyAppFeedConfig {
-  private constructor();
-  free(): void;
-  static fromJson(js_value: any): PubkyAppFeedConfig;
-  toJson(): any;
-  /**
-   * Getter for `tags`.
-   */
-  readonly tags: string[] | undefined;
-  /**
-   * Getter for `name`.
-   */
-  readonly reach: PubkyAppFeedReach;
-  /**
-   * Getter for `layout`.
-   */
-  readonly layout: PubkyAppFeedLayout;
-  /**
-   * Getter for `sort`.
-   */
-  readonly sort: PubkyAppFeedSort;
-  /**
-   * Getter for `content`.
-   */
-  readonly content: PubkyAppPostKind | undefined;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppFeedConfig;
+    toJson(): any;
+    /**
+     * Getter for `content`.
+     */
+    readonly content: PubkyAppPostKind | undefined;
+    /**
+     * Getter for `layout`.
+     */
+    readonly layout: PubkyAppFeedLayout;
+    /**
+     * Getter for `name`.
+     */
+    readonly reach: PubkyAppFeedReach;
+    /**
+     * Getter for `sort`.
+     */
+    readonly sort: PubkyAppFeedSort;
+    /**
+     * Getter for `tags`.
+     */
+    readonly tags: string[] | undefined;
 }
+
+/**
+ * Enum representing the layout of the feed.
+ */
+export enum PubkyAppFeedLayout {
+    Columns = 0,
+    Wide = 1,
+    Visual = 2,
+}
+
+/**
+ * Enum representing the reach of the feed.
+ */
+export enum PubkyAppFeedReach {
+    Following = 0,
+    Followers = 1,
+    Friends = 2,
+    All = 3,
+}
+
+/**
+ * Enum representing the sort order of the feed.
+ */
+export enum PubkyAppFeedSort {
+    Recent = 0,
+    Popularity = 1,
+}
+
 /**
  * Represents a file uploaded by the user.
  * URI: /pub/pubky.app/files/:file_id
  */
 export class PubkyAppFile {
-  private constructor();
-  free(): void;
-  static fromJson(js_value: any): PubkyAppFile;
-  toJson(): any;
-  created_at: bigint;
-  size: number;
-  readonly name: string;
-  readonly src: string;
-  readonly content_type: string;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppFile;
+    toJson(): any;
+    created_at: bigint;
+    size: number;
+    readonly content_type: string;
+    readonly name: string;
+    readonly src: string;
 }
+
 /**
  * Represents raw homeserver follow object with timestamp
  *
@@ -332,23 +250,27 @@ export class PubkyAppFile {
  * `/pub/pubky.app/follows/pxnu33x7jtpx9ar1ytsi4yxbp6a5o36gwhffs8zoxmbuptici1jy`
  */
 export class PubkyAppFollow {
-  private constructor();
-  free(): void;
-  static fromJson(js_value: any): PubkyAppFollow;
-  toJson(): any;
-  created_at: bigint;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppFollow;
+    toJson(): any;
+    created_at: bigint;
 }
+
 /**
  * Represents the last read timestamp for notifications.
  * URI: /pub/pubky.app/last_read
  */
 export class PubkyAppLastRead {
-  private constructor();
-  free(): void;
-  static fromJson(js_value: any): PubkyAppLastRead;
-  toJson(): any;
-  timestamp: bigint;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppLastRead;
+    toJson(): any;
+    timestamp: bigint;
 }
+
 /**
  * Represents raw homeserver Mute object with timestamp
  * URI: /pub/pubky.app/mutes/:user_id
@@ -358,12 +280,14 @@ export class PubkyAppLastRead {
  * `/pub/pubky.app/mutes/pxnu33x7jtpx9ar1ytsi4yxbp6a5o36gwhffs8zoxmbuptici1jy`
  */
 export class PubkyAppMute {
-  private constructor();
-  free(): void;
-  static fromJson(js_value: any): PubkyAppMute;
-  toJson(): any;
-  created_at: bigint;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppMute;
+    toJson(): any;
+    created_at: bigint;
 }
+
 /**
  * Represents raw post in homeserver with content and kind
  * URI: /pub/pubky.app/posts/:post_id
@@ -374,28 +298,47 @@ export class PubkyAppMute {
  * `/pub/pubky.app/posts/00321FCW75ZFY`
  */
 export class PubkyAppPost {
-  free(): void;
-  static fromJson(js_value: any): PubkyAppPost;
-  toJson(): any;
-  /**
-   * Creates a new `PubkyAppPost` instance and sanitizes it.
-   */
-  constructor(content: string, kind: PubkyAppPostKind, parent?: string | null, embed?: PubkyAppPostEmbed | null, attachments?: string[] | null);
-  readonly content: string;
-  readonly kind: string;
-  readonly parent: string | undefined;
-  readonly embed: PubkyAppPostEmbed | undefined;
-  readonly attachments: string[] | undefined;
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppPost;
+    /**
+     * Creates a new `PubkyAppPost` instance and sanitizes it.
+     */
+    constructor(content: string, kind: PubkyAppPostKind, parent?: string | null, embed?: PubkyAppPostEmbed | null, attachments?: string[] | null);
+    toJson(): any;
+    readonly attachments: string[] | undefined;
+    readonly content: string;
+    readonly embed: PubkyAppPostEmbed | undefined;
+    readonly kind: string;
+    readonly parent: string | undefined;
 }
+
 /**
  * Represents embedded content within a post
  */
 export class PubkyAppPostEmbed {
-  free(): void;
-  constructor(uri: string, kind: PubkyAppPostKind);
-  readonly kind: string;
-  readonly uri: string;
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(uri: string, kind: PubkyAppPostKind);
+    readonly kind: string;
+    readonly uri: string;
+}
+
+/**
+ * Represents the type of pubky-app posted data
+ * Used primarily to best display the content in UI
+ */
+export enum PubkyAppPostKind {
+    Short = 0,
+    Long = 1,
+    Image = 2,
+    Video = 3,
+    Link = 4,
+    File = 5,
+    Collection = 6,
+    Unknown = 7,
 }
+
 /**
  * Represents raw homeserver tag with id
  * URI: /pub/pubky.app/tags/:tag_id
@@ -407,96 +350,242 @@ export class PubkyAppPostEmbed {
  * Where tag_id is Crockford-base32(Blake3("{uri_tagged}:{label}")[:half])
  */
 export class PubkyAppTag {
-  private constructor();
-  free(): void;
-  static fromJson(js_value: any): PubkyAppTag;
-  /**
-   * Serialize to JSON for WASM.
-   */
-  toJson(): any;
-  created_at: bigint;
-  /**
-   * Getter for `uri`.
-   */
-  readonly uri: string;
-  /**
-   * Getter for `label`.
-   */
-  readonly label: string;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppTag;
+    /**
+     * Serialize to JSON for WASM.
+     */
+    toJson(): any;
+    created_at: bigint;
+    /**
+     * Getter for `label`.
+     */
+    readonly label: string;
+    /**
+     * Getter for `uri`.
+     */
+    readonly uri: string;
 }
+
 /**
  * URI: /pub/pubky.app/profile.json
  */
 export class PubkyAppUser {
-  free(): void;
-  static fromJson(js_value: any): PubkyAppUser;
-  toJson(): any;
-  /**
-   * Creates a new `PubkyAppUser` instance and sanitizes it.
-   */
-  constructor(name: string, bio?: string | null, image?: string | null, links?: PubkyAppUserLink[] | null, status?: string | null);
-  readonly name: string;
-  readonly bio: string | undefined;
-  readonly image: string | undefined;
-  readonly links: PubkyAppUserLink[] | undefined;
-  readonly status: string | undefined;
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromJson(js_value: any): PubkyAppUser;
+    /**
+     * Creates a new `PubkyAppUser` instance and sanitizes it.
+     */
+    constructor(name: string, bio?: string | null, image?: string | null, links?: PubkyAppUserLink[] | null, status?: string | null);
+    toJson(): any;
+    readonly bio: string | undefined;
+    readonly image: string | undefined;
+    readonly links: PubkyAppUserLink[] | undefined;
+    readonly name: string;
+    readonly status: string | undefined;
 }
+
 /**
  * Represents a user's single link with a title and URL.
  */
 export class PubkyAppUserLink {
-  free(): void;
-  /**
-   * Creates a new `PubkyAppUserLink` instance and sanitizes it.
-   */
-  constructor(title: string, url: string);
-  readonly title: string;
-  readonly url: string;
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Creates a new `PubkyAppUserLink` instance and sanitizes it.
+     */
+    constructor(title: string, url: string);
+    readonly title: string;
+    readonly url: string;
 }
+
 /**
  * Represents user data with name, bio, image, links, and status.
  */
 export class PubkyId {
-  private constructor();
-  free(): void;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
 }
+
 /**
  * Represents a user's single link with a title and URL.
  */
 export class PubkySpecsBuilder {
-  free(): void;
-  /**
-   * Creates a new `PubkyAppBuilder` instance.
-   */
-  constructor(pubky_id: string);
-  createUser(name: string, bio: string | null | undefined, image: string | null | undefined, links: any, status?: string | null): UserResult;
-  createFeed(tags: any, reach: string, layout: string, sort: string, content: string | null | undefined, name: string): FeedResult;
-  createFile(name: string, src: string, content_type: string, size: number): FileResult;
-  createPost(content: string, kind: PubkyAppPostKind, parent?: string | null, embed?: PubkyAppPostEmbed | null, attachments?: string[] | null): PostResult;
-  /**
-   * Edits an existing post by updating its content while preserving its original ID and timestamp.
-   */
-  editPost(original_post: PubkyAppPost, post_id: string, new_content: string): PostResult;
-  createTag(uri: string, label: string): TagResult;
-  createBookmark(uri: string): BookmarkResult;
-  createFollow(followee_id: string): FollowResult;
-  createMute(mutee_id: string): MuteResult;
-  createLastRead(): LastReadResult;
-  createBlob(blob_data: any): BlobResult;
-  /**
-   * Returns validation limits as a JSON value for client-side use.
-   */
-  readonly validationLimits: any;
+    free(): void;
+    [Symbol.dispose](): void;
+    createBlob(blob_data: any): BlobResult;
+    createBookmark(uri: string): BookmarkResult;
+    /**
+     * Creates a `kind = Collection` post — a curated list of URIs under
+     * a name and optional description.
+     *
+     * Convenience wrapper around `createPost` that builds the
+     * `PubkyAppCollectionContent` envelope (`{ name, description, items }`) and
+     * JSON-serializes it into `content` internally, so JS callers don't
+     * have to stringify the envelope themselves.
+     *
+     * `parent` and `embed` are not supported for Collection posts — the
+     * validator rejects them — so this helper omits those arguments.
+     */
+    createCollectionPost(name: string, description?: string | null, items?: string[] | null): PostResult;
+    createFeed(tags: any, reach: string, layout: string, sort: string, content: string | null | undefined, name: string): FeedResult;
+    createFile(name: string, src: string, content_type: string, size: number): FileResult;
+    createFollow(followee_id: string): FollowResult;
+    createLastRead(): LastReadResult;
+    createMute(mutee_id: string): MuteResult;
+    createPost(content: string, kind: PubkyAppPostKind, parent?: string | null, embed?: PubkyAppPostEmbed | null, attachments?: string[] | null): PostResult;
+    createTag(uri: string, label: string): TagResult;
+    createUser(name: string, bio: string | null | undefined, image: string | null | undefined, links: any, status?: string | null): UserResult;
+    /**
+     * Edits an existing post by updating its content while preserving its original ID and timestamp.
+     */
+    editPost(original_post: PubkyAppPost, post_id: string, new_content: string): PostResult;
+    /**
+     * Creates a new `PubkyAppBuilder` instance.
+     */
+    constructor(pubky_id: string);
+    /**
+     * Returns validation limits as a JSON value for client-side use.
+     */
+    readonly validationLimits: any;
 }
+
 export class TagResult {
-  private constructor();
-  free(): void;
-  readonly tag: PubkyAppTag;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly meta: Meta;
+    readonly tag: PubkyAppTag;
 }
+
 export class UserResult {
-  private constructor();
-  free(): void;
-  readonly user: PubkyAppUser;
-  readonly meta: Meta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly meta: Meta;
+    readonly user: PubkyAppUser;
 }
+
+export function baseUriBuilder(user_id: string): string;
+
+/**
+ * Builds a Blob URI of the form "pubky://<author_id>/pub/pubky.app/blobs/<blob_id>"
+ */
+export function blobUriBuilder(author_id: string, blob_id: string): string;
+
+/**
+ * Builds a Bookmark URI of the form "pubky://<author_id>/pub/pubky.app/bookmarks/<bookmark_id>"
+ */
+export function bookmarkUriBuilder(author_id: string, bookmark_id: string): string;
+
+/**
+ * Builds a Feed URI of the form "pubky://<author_id>/pub/pubky.app/feeds/<feed_id>"
+ */
+export function feedUriBuilder(author_id: string, feed_id: string): string;
+
+/**
+ * Builds a File URI of the form "pubky://<author_id>/pub/pubky.app/files/<file_id>"
+ */
+export function fileUriBuilder(author_id: string, file_id: string): string;
+
+/**
+ * Builds a Follow URI of the form "pubky://<author_id>/pub/pubky.app/follows/<follow_id>"
+ */
+export function followUriBuilder(author_id: string, follow_id: string): string;
+
+/**
+ * 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!");
+ * }
+ * ```
+ */
+export function getValidMimeTypes(): any[];
+
+/**
+ * Each FFI function:
+ * - Accepts minimal fields in a JavaScript-friendly manner (e.g. strings, JSON).
+ * - Creates the Rust model, sanitizes, and validates it.
+ * - Generates the ID (if applicable).
+ * - Generates the path (if applicable).
+ * - Returns { json, id, path, url } or a descriptive error.
+ * Returns validation limits as a JSON value for client-side use without a builder.
+ */
+export function getValidationLimits(): any;
+
+/**
+ * Builds a LastRead URI of the form "pubky://<author_id>/pub/pubky.app/last_read"
+ */
+export function lastReadUriBuilder(author_id: string): string;
+
+/**
+ * Builds a Mute URI of the form "pubky://<author_id>/pub/pubky.app/mutes/<mute_id>"
+ */
+export function muteUriBuilder(author_id: string, mute_id: string): string;
+
+/**
+ * Parses a Pubky URI and returns a strongly typed `ParsedUriResult`.
+ *
+ * This function wraps the internal ParsedUri ust parsing logic. It converts the result into a
+ * strongly typed object that is easier to use in TypeScript.
+ *
+ * # Parameters
+ *
+ * - `uri`: A string slice representing the Pubky URI. The URI should follow the format:
+ *   `pubky://<user_id>/pub/pubky.app/<resource>[/<id>]`.
+ *
+ * # Returns
+ *
+ * On success, returns a `ParsedUriResult` with:
+ * - `user_id`: the parsed user ID,
+ * - `resource`: a string (derived from the Display implementation of internal `Resource` enum),
+ * - `resource_id`: an optional resource identifier (if applicable).
+ *
+ * On failure, returns a JavaScript error (`String`) containing an error message.
+ *
+ * # Example (TypeScript)
+ *
+ * ```typescript
+ * import { parse_uri } from "pubky-app-specs";
+ *
+ * try {
+ *   const result = parse_uri("pubky://user123/pub/pubky.app/posts/abc123");
+ *   console.log(result.user_id);        // e.g. "user123"
+ *   console.log(result.resource);    // e.g. "posts"
+ *   console.log(result.resource_id);      // e.g. "abc123" or null
+ * } catch (error) {
+ *   console.error("Error parsing URI:", error);
+ * }
+ * ```
+ */
+export function parse_uri(uri: string): ParsedUriResult;
+
+/**
+ * Builds a Post URI of the form "pubky://<author_id>/pub/pubky.app/posts/<post_id>"
+ */
+export function postUriBuilder(author_id: string, post_id: string): string;
+
+/**
+ * Builds a Tag URI of the form "pubky://<author_id>/pub/pubky.app/tags/<tag_id>"
+ */
+export function tagUriBuilder(author_id: string, tag_id: string): string;
+
+/**
+ * Builds an User URI of the form "pubky://<user_pubky_id>/pub/pubky.app/profile.json"
+ */
+export function userUriBuilder(user_id: string): string;