@seed-hypermedia/client 0.0.1

package/dist/ref.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Ref SDK — create signed ref blobs for document version, tombstone, and redirect operations.
+ */
+import type { HMPublishBlobsInput, HMSigner } from './hm-types';
+export type CreateVersionRefInput = {
+    /** Account UID (base58btc-encoded principal) */
+    space: string;
+    /** Document path (API format, e.g., "/my-doc") */
+    path: string;
+    /** Genesis CID string */
+    genesis: string;
+    /** Version string (dot-separated CID strings) */
+    version: string;
+    /** Generation number */
+    generation: number;
+    /** Optional capability CID string */
+    capability?: string;
+};
+export type CreateTombstoneRefInput = {
+    /** Account UID (base58btc-encoded principal) */
+    space: string;
+    /** Document path (API format, e.g., "/my-doc") */
+    path: string;
+    /** Genesis CID string */
+    genesis: string;
+    /** Generation number */
+    generation: number;
+    /** Optional capability CID string */
+    capability?: string;
+};
+export type CreateRedirectRefInput = {
+    /** Account UID (base58btc-encoded principal) */
+    space: string;
+    /** Document path (API format, e.g., "/my-doc") */
+    path: string;
+    /** Genesis CID string */
+    genesis: string;
+    /** Generation number */
+    generation: number;
+    /** Target account UID (omit or set same as space if same account) */
+    targetSpace?: string;
+    /** Target document path */
+    targetPath: string;
+    /** If true, republish target content at this location */
+    republish?: boolean;
+    /** Optional capability CID string */
+    capability?: string;
+};
+/**
+ * Create a signed version ref blob ready for publishing.
+ * Points to a specific document version (genesis + heads).
+ * Used for fork/branch operations and normal document refs.
+ */
+export declare function createVersionRef(input: CreateVersionRefInput, signer: HMSigner): Promise<HMPublishBlobsInput>;
+/**
+ * Create a signed tombstone ref blob ready for publishing.
+ * Marks a document as deleted (empty heads, no redirect).
+ */
+export declare function createTombstoneRef(input: CreateTombstoneRefInput, signer: HMSigner): Promise<HMPublishBlobsInput>;
+/**
+ * Create a signed redirect ref blob ready for publishing.
+ * Redirects this document path to a different account/path.
+ * Optionally republishes the target content at this location.
+ */
+export declare function createRedirectRef(input: CreateRedirectRefInput, signer: HMSigner): Promise<HMPublishBlobsInput>;

package/dist/signing.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Internal signing utilities shared across blob creation modules.
+ * Not exported from the package index.
+ */
+import type { HMPublishBlobsInput, HMSigner } from './hm-types';
+export declare const cborCodec: {
+    code: 113;
+    encode: (input: unknown) => import("multiformats").ByteView<unknown>;
+    name: "DAG-CBOR";
+};
+export declare function normalizeBytes(data: Uint8Array): Uint8Array<ArrayBuffer>;
+export declare function signObject(signer: HMSigner, data: unknown): Promise<Uint8Array>;
+export declare function toPublishInput(blobData: Uint8Array, extraBlobs?: Array<{
+    cid?: string;
+    data: Uint8Array;
+}>): HMPublishBlobsInput;

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@seed-hypermedia/client",
+  "version": "0.0.1",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./*": {
+      "import": "./dist/*.js",
+      "types": "./dist/*.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ipld/dag-cbor": "^9.2.5",
+    "multiformats": "^13.4.1",
+    "superjson": "2.2.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "5.8.3",
+    "vitest": "0.34.2",
+    "zod": "3.25.76"
+  },
+  "peerDependencies": {
+    "zod": ">=3.20.0"
+  },
+  "scripts": {
+    "build": "tsup && tsc --project tsconfig.build.json",
+    "format:check": "prettier --check .",
+    "format:write": "prettier --write .",
+    "test": "vitest --run",
+    "typecheck": "tsc --noEmit --project tsconfig.app.json"
+  }
+}