@bcts/hubert 1.0.0-alpha.17

package/src/index.ts

@@ -0,0 +1,145 @@
+/**
+ * Hubert - Distributed infrastructure for secure multiparty transactions.
+ *
+ * This library provides distributed key-value storage using ARID-based addressing
+ * with multiple storage backends for FROST threshold signature protocols.
+ *
+ * Port of lib.rs from hubert-rust.
+ *
+ * @packageDocumentation
+ * @module @bcts/hubert
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { KvStore, deriveIpfsKeyName } from "@bcts/hubert";
+ * import { ARID } from "@bcts/components";
+ * import { Envelope } from "@bcts/envelope";
+ *
+ * // Create an ARID
+ * const arid = ARID.new();
+ *
+ * // Create an envelope
+ * const envelope = Envelope.new("Hello, Hubert!");
+ *
+ * // Use any KvStore implementation to store/retrieve
+ * async function example(store: KvStore) {
+ *   await store.put(arid, envelope);
+ *   const result = await store.get(arid);
+ * }
+ * ```
+ */
+
+// =============================================================================
+// Error Types
+// =============================================================================
+
+export {
+  HubertError,
+  AlreadyExistsError,
+  NotFoundError,
+  InvalidAridError,
+  IoError,
+} from "./error.js";
+
+// =============================================================================
+// KvStore Interface
+// =============================================================================
+
+export { type KvStore } from "./kv-store.js";
+
+// =============================================================================
+// ARID Derivation
+// =============================================================================
+
+export {
+  deriveKey,
+  deriveIpfsKeyName,
+  deriveMainlineKey,
+  obfuscateWithArid,
+} from "./arid-derivation.js";
+
+// =============================================================================
+// Logging Utilities
+// =============================================================================
+
+export { timestamp, verbosePrintln, verbosePrintDot, verboseNewline } from "./logging.js";
+
+// =============================================================================
+// Server Module
+// =============================================================================
+
+export {
+  // Error types
+  ServerError,
+  ServerGeneralError,
+  ServerNetworkError,
+  ServerParseError,
+  SqliteError,
+  // Storage backends
+  MemoryKv,
+  SqliteKv,
+  type ServerKv,
+  createMemoryKv,
+  createSqliteKv,
+  // HTTP server
+  Server,
+  type ServerConfig,
+  defaultServerConfig,
+  // HTTP client
+  ServerKvClient,
+} from "./server/index.js";
+
+// =============================================================================
+// IPFS Module
+// =============================================================================
+
+export {
+  // Error types
+  IpfsError,
+  EnvelopeTooLargeError,
+  IpfsDaemonError,
+  IpfsTimeoutError,
+  UnexpectedIpnsPathFormatError,
+  // IPFS value helpers
+  addBytes,
+  catBytes,
+  pinCid,
+  // IPFS KvStore implementation
+  IpfsKv,
+} from "./ipfs/index.js";
+
+// =============================================================================
+// Mainline Module
+// =============================================================================
+
+export {
+  // Error types
+  MainlineError,
+  ValueTooLargeError,
+  DhtError,
+  PutQueryError,
+  DecodeIdError,
+  PutMutableError,
+  MainlineIoError,
+  // Mainline DHT KvStore implementation
+  MainlineDhtKv,
+} from "./mainline/index.js";
+
+// =============================================================================
+// Hybrid Module
+// =============================================================================
+
+export {
+  // Error types
+  HybridError,
+  ContentNotFoundError,
+  NotReferenceEnvelopeError,
+  InvalidReferenceAridError,
+  NoIdAssertionError,
+  // Reference envelope utilities
+  createReferenceEnvelope,
+  isReferenceEnvelope,
+  extractReferenceArid,
+  // Hybrid KvStore implementation
+  HybridKv,
+} from "./hybrid/index.js";

package/src/ipfs/error.ts

@@ -0,0 +1,83 @@
+/**
+ * IPFS-specific errors.
+ *
+ * Port of ipfs/error.rs from hubert-rust.
+ *
+ * @module
+ */
+
+import { HubertError } from "../error.js";
+
+/**
+ * Base class for IPFS-specific errors.
+ *
+ * @category IPFS
+ */
+export class IpfsError extends HubertError {
+  constructor(message: string) {
+    super(message);
+    this.name = "IpfsError";
+  }
+}
+
+/**
+ * Envelope size exceeds practical limit.
+ *
+ * Port of `Error::EnvelopeTooLarge { size }` from ipfs/error.rs line 5.
+ *
+ * @category IPFS
+ */
+export class EnvelopeTooLargeError extends IpfsError {
+  readonly size: number;
+
+  constructor(size: number) {
+    super(`Envelope size ${size} exceeds practical limit`);
+    this.name = "EnvelopeTooLargeError";
+    this.size = size;
+  }
+}
+
+/**
+ * IPFS daemon error.
+ *
+ * Port of `Error::DaemonError` from ipfs/error.rs line 8.
+ *
+ * @category IPFS
+ */
+export class IpfsDaemonError extends IpfsError {
+  constructor(message: string) {
+    super(`IPFS daemon error: ${message}`);
+    this.name = "IpfsDaemonError";
+  }
+}
+
+/**
+ * Operation timed out.
+ *
+ * Port of `Error::Timeout` from ipfs/error.rs line 11.
+ *
+ * @category IPFS
+ */
+export class IpfsTimeoutError extends IpfsError {
+  constructor() {
+    super("Operation timed out");
+    this.name = "IpfsTimeoutError";
+  }
+}
+
+/**
+ * Unexpected IPNS path format.
+ *
+ * Port of `Error::UnexpectedIpnsPathFormat` from ipfs/error.rs line 14.
+ *
+ * @category IPFS
+ */
+export class UnexpectedIpnsPathFormatError extends IpfsError {
+  readonly path: string;
+
+  constructor(path: string) {
+    super(`Unexpected IPNS path format: ${path}`);
+    this.name = "UnexpectedIpnsPathFormatError";
+    this.path = path;
+  }
+}

package/src/ipfs/index.ts

@@ -0,0 +1,24 @@
+/**
+ * IPFS module for Hubert distributed storage.
+ *
+ * This module provides IPFS-backed storage using IPNS for ARID-based addressing.
+ *
+ * Port of ipfs/mod.rs from hubert-rust.
+ *
+ * @module
+ */
+
+// Error types
+export {
+  IpfsError,
+  EnvelopeTooLargeError,
+  IpfsDaemonError,
+  IpfsTimeoutError,
+  UnexpectedIpnsPathFormatError,
+} from "./error.js";
+
+// IPFS value helpers
+export { addBytes, catBytes, pinCid } from "./value.js";
+
+// IPFS KvStore implementation
+export { IpfsKv } from "./kv.js";