@seed-hypermedia/client 0.0.3 → 0.0.5

package/dist/blocks-to-markdown.d.ts

@@ -31,3 +31,30 @@ export declare function emitFrontmatter(metadata: HMMetadata): string;
  * as placeholder links (not resolved).
  */
 export declare function blocksToMarkdown(doc: HMDocument, options?: BlocksToMarkdownOptions): string;
+/**
+ * Convert a title string into a URL-safe slug.
+ *
+ * - Lowercases the string
+ * - Replaces non-alphanumeric characters with hyphens
+ * - Trims leading/trailing hyphens
+ * - Truncates to 60 characters
+ */
+export declare function slugify(title: string): string;
+/**
+ * Build a draft filename from a slug and nanoid.
+ * Format: `<slug>_<nanoid>.md` — human-readable + collision-safe.
+ * If the slug is empty, the filename is just `<nanoid>.md`.
+ */
+export declare function draftFilename(slug: string, id: string): string;
+/**
+ * Extract the draft ID (nanoid) from a draft filename.
+ *
+ * Handles both formats:
+ * - `<slug>_<nanoid>.md` → returns the nanoid part
+ * - `<nanoid>.md` → returns the nanoid (legacy/no-slug)
+ * - `<nanoid>.json` → returns the nanoid (legacy JSON)
+ */
+export declare function parseDraftFilename(filename: string): {
+    id: string;
+    ext: string;
+};

package/dist/{chunk-X57BIZUK.mjs → chunk-B5WCMFR5.mjs}

@@ -264,6 +264,7 @@ var HMCommentSchema = z.object({
   targetPath: z.string().optional(),
   targetVersion: z.string(),
   replyParent: z.string().optional(),
+  replyParentVersion: z.string().optional(),
   threadRoot: z.string().optional(),
   threadRootVersion: z.string().optional(),
   capability: z.string().optional(),
@@ -604,7 +605,11 @@ var HMDraftMetaBaseSchema = z.object({
   editUid: z.string().optional(),
   editPath: z.array(z.string()).optional(),
   metadata: HMDocumentMetadataSchema,
-  visibility: HMResourceVisibilitySchema.optional().default("PUBLIC")
+  visibility: HMResourceVisibilitySchema.optional().default("PUBLIC"),
+  // deps and navigation live in the index entry for .md drafts
+  // (for .json drafts they come from the content file for backwards compat)
+  deps: z.array(z.string().min(1)).default([]),
+  navigation: z.array(HMNavigationItemSchema).optional()
 });
 var draftLocationRefinement = (data) => data.editUid || data.locationUid;
 var HMDraftMetaSchema = HMDraftMetaBaseSchema.refine(draftLocationRefinement, {
@@ -925,6 +930,17 @@ var HMPrepareDocumentChangeRequestSchema = z.object({
   input: HMPrepareDocumentChangeInputSchema,
   output: HMPrepareDocumentChangeOutputSchema
 });
+var HMListCommentVersionsInputSchema = z.object({
+  id: z.string()
+});
+var HMListCommentVersionsOutputSchema = z.object({
+  versions: z.array(HMCommentSchema)
+});
+var HMListCommentVersionsRequestSchema = z.object({
+  key: z.literal("ListCommentVersions"),
+  input: HMListCommentVersionsInputSchema,
+  output: HMListCommentVersionsOutputSchema
+});
 var HMGetRequestSchema = z.discriminatedUnion("key", [
   HMResourceRequestSchema,
   HMResourceMetadataRequestSchema,
@@ -945,7 +961,8 @@ var HMGetRequestSchema = z.discriminatedUnion("key", [
   HMListCitationsRequestSchema,
   HMListChangesRequestSchema,
   HMListCapabilitiesRequestSchema,
-  HMInteractionSummaryRequestSchema
+  HMInteractionSummaryRequestSchema,
+  HMListCommentVersionsRequestSchema
 ]);
 var HMActionSchema = z.discriminatedUnion("key", [
   HMPublishBlobsRequestSchema,
@@ -972,6 +989,7 @@ var HMRequestSchema = z.discriminatedUnion("key", [
   HMListChangesRequestSchema,
   HMListCapabilitiesRequestSchema,
   HMInteractionSummaryRequestSchema,
+  HMListCommentVersionsRequestSchema,
   HMPublishBlobsRequestSchema,
   HMPrepareDocumentChangeRequestSchema
 ]);
@@ -1274,6 +1292,9 @@ export {
   HMPrepareDocumentChangeInputSchema,
   HMPrepareDocumentChangeOutputSchema,
   HMPrepareDocumentChangeRequestSchema,
+  HMListCommentVersionsInputSchema,
+  HMListCommentVersionsOutputSchema,
+  HMListCommentVersionsRequestSchema,
   HMGetRequestSchema,
   HMActionSchema,
   HMRequestSchema,

package/dist/comment.d.ts

@@ -40,6 +40,19 @@ export type DeleteCommentInput = {
     visibility?: 'Private' | '';
 };
 export declare function deleteComment(input: DeleteCommentInput, signer: HMSigner): Promise<HMPublishBlobsInput>;
+/** Input for updating an existing comment. */
+export type UpdateCommentInput = {
+    commentId: string;
+    targetAccount: string;
+    targetPath: string;
+    targetVersion: string;
+    content: HMBlockNode[];
+    replyParentVersion?: string | null;
+    rootReplyCommentVersion?: string | null;
+    visibility?: 'Private' | '';
+};
+/** Creates a signed update blob for an existing comment. */
+export declare function updateComment(input: UpdateCommentInput, signer: HMSigner): Promise<HMPublishBlobsInput>;
 /**
  * Compute the record ID ("authority/tsid") from raw CBOR-encoded comment blob bytes.
  * The TSID is a 10-byte base58btc value: 6 bytes ms timestamp + 4 bytes SHA256 prefix.

package/dist/editor-types.d.ts

@@ -0,0 +1,157 @@
+import { HMBlockChildrenType } from './hm-types';
+export type EditorBlock = EditorParagraphBlock | EditorHeadingBlock | EditorCodeBlock | EditorImageBlock | EditorVideoBlock | EditorFileBlock | EditorButtonBlock | EditorEmbedBlock | EditorWebEmbedBlock | EditorMathBlock | EditorNostrBlock | EditorQueryBlock | EditorUnknownBlock;
+export type HMInlineContent = EditorText | EditorInlineEmbed | EditorLink;
+export interface EditorBaseBlock {
+    id: string;
+    props: EditorBlockProps;
+    children: Array<EditorBlock>;
+}
+export interface EditorBlockProps {
+    childrenType?: HMBlockChildrenType;
+    columnCount?: string;
+    listLevel?: string;
+    level?: number | string;
+    ref?: string;
+    revision?: string;
+}
+export interface EditorParagraphBlock extends EditorBaseBlock {
+    type: 'paragraph';
+    content: Array<HMInlineContent>;
+}
+export interface EditorHeadingBlock extends EditorBaseBlock {
+    type: 'heading';
+    content: Array<HMInlineContent>;
+}
+export interface EditorCodeBlock extends EditorBaseBlock {
+    type: 'code-block';
+    content: Array<HMInlineContent>;
+    props: EditorBlockProps & {
+        language?: string;
+    };
+}
+export interface DraftMediaRef {
+    draftId: string;
+    mediaId: string;
+    name: string;
+    mime: string;
+    size: number;
+}
+export interface MediaBlockProps extends EditorBlockProps {
+    url?: string;
+    src?: string;
+    displaySrc?: string;
+    fileBinary?: Uint8Array | number[];
+    mediaRef?: DraftMediaRef;
+    name?: string;
+    width?: string;
+    defaultOpen?: string;
+    size?: string;
+    alignment?: string;
+}
+export interface EditorImageBlock extends EditorBaseBlock {
+    type: 'image';
+    props: MediaBlockProps;
+    content: Array<HMInlineContent>;
+}
+export interface EditorVideoBlock extends EditorBaseBlock {
+    type: 'video';
+    props: MediaBlockProps;
+    content: Array<HMInlineContent>;
+}
+export interface EditorFileBlock extends EditorBaseBlock {
+    type: 'file';
+    props: MediaBlockProps;
+    content: Array<HMInlineContent>;
+}
+export interface EditorButtonBlock extends EditorBaseBlock {
+    type: 'button';
+    props: MediaBlockProps;
+    content: Array<HMInlineContent>;
+}
+export interface EditorEmbedBlock extends EditorBaseBlock {
+    type: 'embed';
+    props: EditorBlockProps & {
+        view: 'Content' | 'Card';
+        url: string;
+    };
+    content: Array<HMInlineContent>;
+}
+export interface EditorMathBlock extends EditorBaseBlock {
+    type: 'math';
+    content: Array<HMInlineContent>;
+}
+export type EditorWebEmbedBlock = EditorBaseBlock & {
+    type: 'web-embed';
+    props: EditorBlockProps & {
+        url?: string;
+    };
+    content: Array<HMInlineContent>;
+};
+export type EditorNostrBlock = EditorBaseBlock & {
+    type: 'nostr';
+    props: EditorBlockProps & {
+        name?: string;
+        url?: string;
+        text?: string;
+        size?: string;
+    };
+    content: Array<HMInlineContent>;
+};
+export type EditorQueryBlock = EditorBaseBlock & {
+    type: 'query';
+    props: EditorBlockProps & {
+        style: 'Card' | 'List';
+        columnCount?: '1' | '2' | '3';
+        queryLimit?: string;
+        queryIncludes?: string;
+        querySort?: string;
+        banner?: 'true' | 'false';
+    };
+    content: Array<HMInlineContent>;
+};
+export type EditorUnknownBlock = EditorBaseBlock & {
+    type: 'unknown';
+    props: EditorBlockProps & {
+        originalType: string;
+        originalData: string;
+    };
+    content: Array<HMInlineContent>;
+};
+export interface EditorText {
+    type: 'text';
+    text: string;
+    styles: EditorInlineStyles;
+}
+export interface EditorLink {
+    type: 'link';
+    href: string;
+    content: Array<HMInlineContent>;
+}
+export interface EditorInlineEmbed {
+    type: 'inline-embed';
+    link: string;
+    styles: EditorInlineStyles | {};
+}
+export interface EditorInlineStyles {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+    code?: boolean;
+    math?: boolean;
+    range?: boolean;
+}
+export type EditorAnnotationType = 'bold' | 'italic' | 'underline' | 'strike' | 'code' | 'link' | 'inline-embed' | 'range';
+export type EditorBlockType = EditorBlock['type'];
+export type SearchResult = {
+    key: string;
+    title: string;
+    subtitle?: string;
+    icon?: string;
+    path?: string[] | null;
+    versionTime?: string;
+    searchQuery?: string;
+    onSelect?: () => void | Promise<void>;
+    onFocus: () => void;
+    onMouseEnter: () => void;
+};

package/dist/editorblock-to-hmblock.d.ts

@@ -0,0 +1,12 @@
+import { EditorBlock } from './editor-types';
+import { HMBlock, HMBlockNode } from './hm-types';
+/** Convert a single BlockNote EditorBlock into an HMBlock. */
+export declare function editorBlockToHMBlock(editorBlock: EditorBlock): HMBlock;
+/**
+ * Convert an array of BlockNote EditorBlocks into an HMBlockNode tree.
+ *
+ * This is the tree-level wrapper around `editorBlockToHMBlock` that recursively
+ * converts children. Useful when serializing editor content to the HM block format
+ * (e.g. for saving drafts as markdown or publishing documents).
+ */
+export declare function editorBlocksToHMBlockNodes(editorBlocks: EditorBlock[]): HMBlockNode[];