@seed-hypermedia/client 0.0.1

package/dist/client.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import type { HMPrepareDocumentChangeInput, HMRequest, HMSigner } from './hm-types';
+/**
+ * Deserializes a URL query string using a Zod schema.
+ * If the query contains only a __value key, returns the primitive value directly.
+ */
+export declare function deserializeQueryString<T>(queryString: string, schema: z.ZodType<T>): T;
+export type PublishDocumentInput = {
+    account: string;
+    changes: HMPrepareDocumentChangeInput['changes'];
+    path?: string;
+    baseVersion?: string;
+    genesis?: string;
+    generation?: number | bigint;
+    capability?: string;
+    visibility?: number;
+};
+export type SeedClientOptions = {
+    fetch?: typeof globalThis.fetch;
+    headers?: Record<string, string>;
+};
+type PublishBlobsRequest = Extract<HMRequest, {
+    key: 'PublishBlobs';
+}>;
+export type SeedClient = {
+    request<K extends HMRequest['key']>(key: K, input: Extract<HMRequest, {
+        key: K;
+    }>['input']): Promise<Extract<HMRequest, {
+        key: K;
+    }>['output']>;
+    publish(input: PublishBlobsRequest['input']): Promise<PublishBlobsRequest['output']>;
+    publishBlobs(input: PublishBlobsRequest['input']): Promise<PublishBlobsRequest['output']>;
+    publishDocument(input: PublishDocumentInput, signer: HMSigner): Promise<void>;
+    baseUrl: string;
+};
+export declare function createSeedClient(baseUrl: string, options?: SeedClientOptions): SeedClient;
+export {};

package/dist/comment.d.ts

@@ -0,0 +1,43 @@
+import type { HMBlockNode, HMPublishBlobsInput, HMSigner, UnpackedHypermediaId } from './hm-types';
+/**
+ * Removes trailing empty blocks from comment content before publishing.
+ * The editor always keeps a trailing empty paragraph for UX, but we
+ * don't want to publish it.
+ */
+export declare function trimTrailingEmptyBlocks(blocks: HMBlockNode[]): HMBlockNode[];
+export type CommentAttachmentBlob = {
+    cid: string;
+    data: Uint8Array;
+};
+type PrepareAttachments = (binaries: Uint8Array[]) => Promise<{
+    blobs: CommentAttachmentBlob[];
+    resultCIDs: string[];
+}>;
+type CreateCommentBaseInput = {
+    docId: UnpackedHypermediaId;
+    docVersion: string;
+    replyCommentVersion?: string | null;
+    rootReplyCommentVersion?: string | null;
+    quotingBlockId?: string;
+    visibility?: 'Private' | '';
+};
+export type CreateCommentInput = (CreateCommentBaseInput & {
+    content: HMBlockNode[];
+    blobs?: CommentAttachmentBlob[];
+}) | (CreateCommentBaseInput & {
+    getContent: (prepareAttachments: PrepareAttachments) => Promise<{
+        blockNodes: HMBlockNode[];
+        blobs: CommentAttachmentBlob[];
+    }>;
+    prepareAttachments?: PrepareAttachments;
+});
+export declare function createComment(input: CreateCommentInput, signer: HMSigner): Promise<HMPublishBlobsInput>;
+export type DeleteCommentInput = {
+    commentId: string;
+    targetAccount: string;
+    targetPath: string;
+    targetVersion: string;
+    visibility?: 'Private' | '';
+};
+export declare function deleteComment(input: DeleteCommentInput, signer: HMSigner): Promise<HMPublishBlobsInput>;
+export {};

package/dist/contact.d.ts

@@ -0,0 +1,42 @@
+import type { HMPublishBlobsInput, HMSigner } from './hm-types';
+export type CreateContactInput = {
+    /** The subject account UID (base58btc-encoded principal) */
+    subjectUid: string;
+    /** The display name for the contact */
+    name: string;
+};
+export type UpdateContactInput = {
+    /** The contact record ID in format "authority/tsid" */
+    contactId: string;
+    /** The subject account UID */
+    subjectUid: string;
+    /** The updated display name */
+    name: string;
+};
+export type DeleteContactInput = {
+    /** The contact record ID in format "authority/tsid" */
+    contactId: string;
+};
+export type CreateContactResult = HMPublishBlobsInput & {
+    /** The record ID in format "authority/tsid" */
+    recordId: string;
+};
+/**
+ * Create a new contact blob and compute its record ID.
+ * Returns the publish input plus a `recordId` in "authority/tsid" format.
+ */
+export declare function createContact(input: CreateContactInput, signer: HMSigner): Promise<CreateContactResult>;
+/**
+ * Update an existing contact blob. Reuses the original TSID.
+ */
+export declare function updateContact(input: UpdateContactInput, signer: HMSigner): Promise<HMPublishBlobsInput>;
+/**
+ * Delete a contact by publishing a tombstone blob.
+ * A tombstone has the same TSID but no subject and no name.
+ */
+export declare function deleteContact(input: DeleteContactInput, signer: HMSigner): Promise<HMPublishBlobsInput>;
+/**
+ * Compute the record ID ("authority/tsid") from raw CBOR-encoded contact blob bytes.
+ * Useful for resolving a CID to a record ID after fetching the blob.
+ */
+export declare function contactRecordIdFromBlob(blobData: Uint8Array): Promise<string>;

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class SeedClientError extends Error {
+    readonly status: number;
+    readonly body?: string;
+    constructor(message: string, status: number, body?: string);
+}
+export declare class SeedNetworkError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class SeedValidationError extends Error {
+    constructor(message: string);
+}