@bcts/hubert 1.0.0-alpha.17

package/dist/server-DVyk9gqU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-DVyk9gqU.mjs","names":["path"],"sources":["../src/server/error.ts","../src/server/memory-kv.ts","../src/server/sqlite-kv.ts","../src/server/server-kv.ts","../src/server/server.ts","../src/server/kv.ts"],"sourcesContent":["/**\n * Server-specific error types.\n *\n * Port of server/error.rs from hubert-rust.\n *\n * @module\n */\n\nimport { HubertError } from \"../error.js\";\n\n/**\n * Base error class for server errors.\n *\n * @category Server Errors\n */\nexport class ServerError extends HubertError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ServerError\";\n  }\n}\n\n/**\n * General server error.\n *\n * Port of `Error::General(String)` from server/error.rs line 4.\n *\n * @category Server Errors\n */\nexport class ServerGeneralError extends ServerError {\n  constructor(message: string) {\n    super(`Server error: ${message}`);\n    this.name = \"ServerGeneralError\";\n  }\n}\n\n/**\n * Network error during server communication.\n *\n * Port of `Error::NetworkError(String)` from server/error.rs line 7.\n *\n * @category Server Errors\n */\nexport class ServerNetworkError extends ServerError {\n  constructor(message: string) {\n    super(`Network error: ${message}`);\n    this.name = \"ServerNetworkError\";\n  }\n}\n\n/**\n * Parse error during data handling.\n *\n * Port of `Error::ParseError(String)` from server/error.rs line 10.\n *\n * @category Server Errors\n */\nexport class ServerParseError extends ServerError {\n  constructor(message: string) {\n    super(`Parse error: ${message}`);\n    this.name = \"ServerParseError\";\n  }\n}\n\n/**\n * SQLite database error.\n *\n * Port of `Error::Sqlite(e)` from server/error.rs line 19.\n *\n * @category Server Errors\n */\nexport class SqliteError extends ServerError {\n  /** The underlying error */\n  override readonly cause?: Error;\n\n  constructor(message: string, cause?: Error) {\n    super(`SQLite error: ${message}`);\n    this.name = \"SqliteError\";\n    if (cause !== undefined) {\n      this.cause = cause;\n    }\n  }\n}\n","/**\n * In-memory key-value store for Gordian Envelopes.\n *\n * Port of server/memory_kv.rs from hubert-rust.\n *\n * @module\n */\n\nimport { type ARID } from \"@bcts/components\";\nimport { type Envelope } from \"@bcts/envelope\";\n\nimport { AlreadyExistsError } from \"../error.js\";\nimport { type KvStore } from \"../kv-store.js\";\nimport { verbosePrintln } from \"../logging.js\";\n\n/**\n * Storage entry with envelope data and optional expiration.\n * @internal\n */\ninterface StorageEntry {\n  /** CBOR-encoded envelope data */\n  envelopeCbor: Uint8Array;\n  /** Expiration timestamp in milliseconds, or undefined for no expiration */\n  expiresAt?: number;\n}\n\n/**\n * In-memory key-value store for Gordian Envelopes.\n *\n * Provides volatile storage with TTL support and automatic cleanup of\n * expired entries.\n *\n * Port of `struct MemoryKv` from server/memory_kv.rs lines 14-21.\n *\n * @category Server Backend\n *\n * @example\n * ```typescript\n * const store = new MemoryKv();\n * const arid = ARID.new();\n * const envelope = Envelope.new(\"Hello, Memory!\");\n *\n * await store.put(arid, envelope, 3600); // 1 hour TTL\n * const result = await store.get(arid);\n * ```\n */\nexport class MemoryKv implements KvStore {\n  private readonly storage: Map<string, StorageEntry>;\n\n  /**\n   * Create a new in-memory key-value store.\n   *\n   * Port of `MemoryKv::new()` from server/memory_kv.rs lines 29-33.\n   */\n  constructor() {\n    this.storage = new Map();\n  }\n\n  /**\n   * Check if an ARID exists and is not expired.\n   *\n   * Port of `check_exists()` from server/memory_kv.rs lines 36-53.\n   *\n   * @internal\n   */\n  private checkExists(arid: ARID): boolean {\n    const key = arid.urString();\n    const entry = this.storage.get(key);\n\n    if (entry) {\n      if (entry.expiresAt !== undefined && Date.now() >= entry.expiresAt) {\n        // Entry is expired, remove it\n        this.storage.delete(key);\n        return false;\n      }\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Store an envelope at the given ARID.\n   *\n   * Port of `KvStore::put()` implementation from server/memory_kv.rs lines 62-102.\n   */\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async put(\n    arid: ARID,\n    envelope: Envelope,\n    ttlSeconds?: number,\n    verbose?: boolean,\n  ): Promise<string> {\n    const key = arid.urString();\n\n    // Check if already exists\n    if (this.storage.has(key)) {\n      if (verbose) {\n        verbosePrintln(`PUT ${key} ALREADY_EXISTS`);\n      }\n      throw new AlreadyExistsError(key);\n    }\n\n    const expiresAt = ttlSeconds !== undefined ? Date.now() + ttlSeconds * 1000 : undefined;\n    const envelopeCbor = envelope.taggedCborData();\n\n    const entry: StorageEntry = { envelopeCbor };\n    if (expiresAt !== undefined) {\n      entry.expiresAt = expiresAt;\n    }\n    this.storage.set(key, entry);\n\n    if (verbose) {\n      const ttlMsg = ttlSeconds !== undefined ? ` (TTL ${ttlSeconds}s)` : \"\";\n      verbosePrintln(`PUT ${key}${ttlMsg} OK (Memory)`);\n    }\n\n    return \"Stored in memory\";\n  }\n\n  /**\n   * Retrieve an envelope for the given ARID.\n   *\n   * Port of `KvStore::get()` implementation from server/memory_kv.rs lines 104-181.\n   */\n  async get(arid: ARID, timeoutSeconds?: number, verbose?: boolean): Promise<Envelope | null> {\n    const timeout = timeoutSeconds ?? 30;\n    const start = Date.now();\n    let firstAttempt = true;\n    const key = arid.urString();\n\n    // Dynamic import to avoid circular dependencies\n    const { EnvelopeDecoder } = await import(\"@bcts/envelope\");\n\n    while (true) {\n      const entry = this.storage.get(key);\n\n      if (entry) {\n        // Check if expired\n        if (entry.expiresAt !== undefined && Date.now() >= entry.expiresAt) {\n          // Entry is expired, remove it\n          this.storage.delete(key);\n          if (verbose) {\n            verbosePrintln(`GET ${key} EXPIRED`);\n          }\n          return null;\n        }\n\n        // Parse CBOR bytes back to Envelope\n        try {\n          const envelope = EnvelopeDecoder.tryFromCborData(entry.envelopeCbor);\n          if (verbose) {\n            verbosePrintln(`GET ${key} OK (Memory)`);\n          }\n          return envelope;\n        } catch {\n          // If parsing fails, treat as not found\n          return null;\n        }\n      }\n\n      // Not found yet\n      const elapsed = (Date.now() - start) / 1000;\n      if (elapsed >= timeout) {\n        if (verbose) {\n          verbosePrintln(`GET ${key} NOT_FOUND (timeout after ${timeout}s)`);\n        }\n        return null;\n      }\n\n      if (firstAttempt && verbose) {\n        verbosePrintln(`Polling for ${key} (timeout: ${timeout}s)`);\n        firstAttempt = false;\n      } else if (verbose) {\n        process.stdout.write(\".\");\n      }\n\n      // Wait 500ms before polling again\n      await new Promise((resolve) => setTimeout(resolve, 500));\n    }\n  }\n\n  /**\n   * Check if an envelope exists at the given ARID.\n   *\n   * Port of `KvStore::exists()` implementation from server/memory_kv.rs lines 183-186.\n   */\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async exists(arid: ARID): Promise<boolean> {\n    return this.checkExists(arid);\n  }\n}\n","/**\n * SQLite-backed key-value store for Gordian Envelopes.\n *\n * Port of server/sqlite_kv.rs from hubert-rust.\n *\n * @module\n */\n\nimport Database from \"better-sqlite3\";\nimport * as fs from \"fs\";\nimport * as path from \"path\";\n\nimport { type ARID } from \"@bcts/components\";\nimport { type Envelope } from \"@bcts/envelope\";\n\nimport { AlreadyExistsError } from \"../error.js\";\nimport { type KvStore } from \"../kv-store.js\";\nimport { verbosePrintln } from \"../logging.js\";\nimport { SqliteError } from \"./error.js\";\n\n/**\n * SQLite-backed key-value store for Gordian Envelopes.\n *\n * Provides persistent storage with TTL support and automatic cleanup of\n * expired entries.\n *\n * Port of `struct SqliteKv` from server/sqlite_kv.rs lines 16-24.\n *\n * @category Server Backend\n *\n * @example\n * ```typescript\n * const store = new SqliteKv(\"./hubert.db\");\n * const arid = ARID.new();\n * const envelope = Envelope.new(\"Hello, SQLite!\");\n *\n * await store.put(arid, envelope, 3600); // 1 hour TTL\n * const result = await store.get(arid);\n *\n * // Cleanup when done\n * store.close();\n * ```\n */\nexport class SqliteKv implements KvStore {\n  private readonly db: Database.Database;\n  private readonly dbPath: string;\n  private cleanupInterval: ReturnType<typeof setInterval> | null = null;\n\n  /**\n   * Create a new SQLite-backed key-value store.\n   *\n   * Port of `SqliteKv::new()` from server/sqlite_kv.rs lines 26-67.\n   *\n   * @param dbPath - Path to the SQLite database file. Will be created if it doesn't exist.\n   * @throws {SqliteError} If database initialization fails\n   */\n  constructor(dbPath: string) {\n    this.dbPath = dbPath;\n\n    // Create parent directory if it doesn't exist\n    const parentDir = path.dirname(dbPath);\n    if (parentDir && parentDir !== \".\" && !fs.existsSync(parentDir)) {\n      fs.mkdirSync(parentDir, { recursive: true });\n    }\n\n    try {\n      this.db = new Database(dbPath);\n\n      // Create table if it doesn't exist\n      this.db.exec(`\n        CREATE TABLE IF NOT EXISTS hubert_store (\n          arid TEXT PRIMARY KEY,\n          envelope TEXT NOT NULL,\n          expires_at INTEGER\n        );\n        CREATE INDEX IF NOT EXISTS idx_expires_at ON hubert_store(expires_at);\n      `);\n    } catch (error) {\n      throw new SqliteError(\n        `Failed to initialize database: ${error instanceof Error ? error.message : String(error)}`,\n        error instanceof Error ? error : undefined,\n      );\n    }\n\n    // Start background cleanup task\n    this.startCleanupTask();\n  }\n\n  /**\n   * Start a background task that prunes expired entries every minute.\n   *\n   * Port of `start_cleanup_task()` from server/sqlite_kv.rs lines 70-126.\n   *\n   * @internal\n   */\n  private startCleanupTask(): void {\n    this.cleanupInterval = setInterval(() => {\n      const now = Math.floor(Date.now() / 1000);\n\n      try {\n        // First collect the ARIDs that will be deleted\n        const selectStmt = this.db.prepare(\n          \"SELECT arid FROM hubert_store WHERE expires_at IS NOT NULL AND expires_at <= ?\",\n        );\n        const rows = selectStmt.all(now) as { arid: string }[];\n        const arids = rows.map((row) => row.arid);\n\n        if (arids.length > 0) {\n          // Now delete them\n          const deleteStmt = this.db.prepare(\n            \"DELETE FROM hubert_store WHERE expires_at IS NOT NULL AND expires_at <= ?\",\n          );\n          deleteStmt.run(now);\n\n          const count = arids.length;\n          const aridList = arids.join(\" \");\n          verbosePrintln(\n            `Pruned ${count} expired ${count === 1 ? \"entry\" : \"entries\"}: ${aridList}`,\n          );\n        }\n      } catch {\n        // Silently ignore cleanup errors\n      }\n    }, 60 * 1000); // Every 60 seconds\n  }\n\n  /**\n   * Check if an ARID exists and is not expired.\n   *\n   * Port of `check_exists()` from server/sqlite_kv.rs lines 129-170.\n   *\n   * @internal\n   */\n  private checkExists(arid: ARID): boolean {\n    const aridStr = arid.urString();\n    const now = Math.floor(Date.now() / 1000);\n\n    try {\n      const stmt = this.db.prepare(\"SELECT expires_at FROM hubert_store WHERE arid = ?\");\n      const row = stmt.get(aridStr) as { expires_at: number | null } | undefined;\n\n      if (row) {\n        // Check if expired\n        if (row.expires_at !== null && now >= row.expires_at) {\n          // Entry is expired, remove it\n          const deleteStmt = this.db.prepare(\"DELETE FROM hubert_store WHERE arid = ?\");\n          deleteStmt.run(aridStr);\n          return false;\n        }\n        return true;\n      }\n      return false;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Store an envelope at the given ARID.\n   *\n   * Port of `KvStore::put()` implementation from server/sqlite_kv.rs lines 175-236.\n   */\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async put(\n    arid: ARID,\n    envelope: Envelope,\n    ttlSeconds?: number,\n    verbose?: boolean,\n  ): Promise<string> {\n    // Check if already exists\n    if (this.checkExists(arid)) {\n      if (verbose) {\n        verbosePrintln(`PUT ${arid.urString()} ALREADY_EXISTS`);\n      }\n      throw new AlreadyExistsError(arid.urString());\n    }\n\n    const aridStr = arid.urString();\n    const envelopeStr = envelope.urString();\n\n    const expiresAt = ttlSeconds !== undefined ? Math.floor(Date.now() / 1000) + ttlSeconds : null;\n\n    try {\n      const stmt = this.db.prepare(\n        \"INSERT INTO hubert_store (arid, envelope, expires_at) VALUES (?, ?, ?)\",\n      );\n      stmt.run(aridStr, envelopeStr, expiresAt);\n\n      if (verbose) {\n        const ttlMsg = ttlSeconds !== undefined ? ` (TTL ${ttlSeconds}s)` : \"\";\n        verbosePrintln(`PUT ${aridStr}${ttlMsg} OK (SQLite: ${this.dbPath})`);\n      }\n\n      return `Stored in SQLite: ${this.dbPath}`;\n    } catch (error) {\n      throw new SqliteError(\n        `Failed to insert: ${error instanceof Error ? error.message : String(error)}`,\n        error instanceof Error ? error : undefined,\n      );\n    }\n  }\n\n  /**\n   * Retrieve an envelope for the given ARID.\n   *\n   * Port of `KvStore::get()` implementation from server/sqlite_kv.rs lines 238-354.\n   */\n  async get(arid: ARID, timeoutSeconds?: number, verbose?: boolean): Promise<Envelope | null> {\n    const timeout = timeoutSeconds ?? 30;\n    const start = Date.now();\n    let firstAttempt = true;\n    const aridStr = arid.urString();\n\n    // Dynamic import to avoid circular dependencies\n    const { Envelope } = await import(\"@bcts/envelope\");\n\n    while (true) {\n      const now = Math.floor(Date.now() / 1000);\n\n      try {\n        const stmt = this.db.prepare(\n          \"SELECT envelope, expires_at FROM hubert_store WHERE arid = ?\",\n        );\n        const row = stmt.get(aridStr) as\n          | { envelope: string; expires_at: number | null }\n          | undefined;\n\n        if (row) {\n          // Check if expired\n          if (row.expires_at !== null && now >= row.expires_at) {\n            // Entry is expired, remove it\n            const deleteStmt = this.db.prepare(\"DELETE FROM hubert_store WHERE arid = ?\");\n            deleteStmt.run(aridStr);\n\n            if (verbose) {\n              verbosePrintln(`GET ${aridStr} EXPIRED`);\n            }\n            return null;\n          }\n\n          // Entry found and not expired\n          const envelope = Envelope.fromUrString(row.envelope);\n\n          if (verbose) {\n            verbosePrintln(`GET ${aridStr} OK (SQLite: ${this.dbPath})`);\n          }\n\n          return envelope;\n        }\n      } catch {\n        // Query failed, treat as not found\n      }\n\n      // Not found yet\n      const elapsed = (Date.now() - start) / 1000;\n      if (elapsed >= timeout) {\n        if (verbose) {\n          verbosePrintln(`GET ${aridStr} NOT_FOUND (timeout after ${timeout}s)`);\n        }\n        return null;\n      }\n\n      if (firstAttempt && verbose) {\n        verbosePrintln(`Polling for ${aridStr} (timeout: ${timeout}s)`);\n        firstAttempt = false;\n      } else if (verbose) {\n        process.stdout.write(\".\");\n      }\n\n      // Wait 500ms before polling again\n      await new Promise((resolve) => setTimeout(resolve, 500));\n    }\n  }\n\n  /**\n   * Check if an envelope exists at the given ARID.\n   *\n   * Port of `KvStore::exists()` implementation from server/sqlite_kv.rs lines 356-359.\n   */\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async exists(arid: ARID): Promise<boolean> {\n    return this.checkExists(arid);\n  }\n\n  /**\n   * Close the database connection and stop the cleanup task.\n   */\n  close(): void {\n    if (this.cleanupInterval) {\n      clearInterval(this.cleanupInterval);\n      this.cleanupInterval = null;\n    }\n    this.db.close();\n  }\n}\n","/**\n * Server-side key-value storage backend union type.\n *\n * Port of server/server_kv.rs from hubert-rust.\n *\n * @module\n */\n\nimport { type ARID } from \"@bcts/components\";\nimport { type Envelope } from \"@bcts/envelope\";\n\nimport { type KvStore } from \"../kv-store.js\";\nimport { MemoryKv } from \"./memory-kv.js\";\nimport { type SqliteKv } from \"./sqlite-kv.js\";\n\n/**\n * Server-side key-value storage backend.\n *\n * This type allows selecting between in-memory and SQLite storage\n * at server setup time.\n *\n * Port of `enum ServerKv` from server/server_kv.rs lines 7-15.\n *\n * @category Server Backend\n */\nexport type ServerKv = MemoryKv | SqliteKv;\n\n/**\n * Create a new in-memory server KV store.\n *\n * Port of `ServerKv::memory()` from server/server_kv.rs line 19.\n *\n * @returns A new MemoryKv instance\n * @category Server Backend\n */\nexport function createMemoryKv(): MemoryKv {\n  return new MemoryKv();\n}\n\n/**\n * Create a new SQLite-backed server KV store.\n *\n * Port of `ServerKv::sqlite()` from server/server_kv.rs line 22.\n *\n * @param store - The SqliteKv instance to use\n * @returns The same SqliteKv instance\n * @category Server Backend\n */\nexport function createSqliteKv(store: SqliteKv): SqliteKv {\n  return store;\n}\n\n/**\n * Synchronously put an envelope into the store.\n *\n * This function wraps the async KvStore trait implementation for use\n * in synchronous HTTP handlers.\n *\n * Port of `put_sync()` from server/server_kv.rs lines 27-52.\n *\n * @param store - The KvStore to use\n * @param arid - The ARID to store at\n * @param envelope - The envelope to store\n * @param ttlSeconds - TTL in seconds\n * @returns Promise that resolves when storage is complete\n * @internal\n */\nexport async function putSync(\n  store: KvStore,\n  arid: ARID,\n  envelope: Envelope,\n  ttlSeconds: number,\n): Promise<void> {\n  await store.put(arid, envelope, ttlSeconds, false);\n}\n\n/**\n * Synchronously get an envelope from the store.\n *\n * This function wraps the async KvStore trait implementation for use\n * in synchronous HTTP handlers.\n *\n * Port of `get_sync()` from server/server_kv.rs lines 58-71.\n *\n * @param store - The KvStore to use\n * @param arid - The ARID to retrieve\n * @returns The envelope if found, or null\n * @internal\n */\nexport async function getSync(store: KvStore, arid: ARID): Promise<Envelope | null> {\n  return await store.get(arid, 0, false);\n}\n","/**\n * Hubert HTTP server implementation.\n *\n * Port of server/server.rs from hubert-rust.\n *\n * @module\n */\n\nimport Fastify, { type FastifyInstance, type FastifyRequest, type FastifyReply } from \"fastify\";\n\nimport { ARID } from \"@bcts/components\";\nimport { Envelope } from \"@bcts/envelope\";\n\nimport { verbosePrintln } from \"../logging.js\";\nimport { MemoryKv } from \"./memory-kv.js\";\nimport { type ServerKv, getSync, putSync } from \"./server-kv.js\";\nimport { type SqliteKv } from \"./sqlite-kv.js\";\n\n/**\n * Package version for health endpoint.\n */\nconst VERSION = \"1.0.0-alpha.1\";\n\n/**\n * Configuration for the Hubert server.\n *\n * Port of `struct ServerConfig` from server/server.rs lines 19-30.\n *\n * @category Server\n */\nexport interface ServerConfig {\n  /** Port to listen on */\n  port: number;\n  /**\n   * Maximum TTL in seconds allowed.\n   * If a put() specifies a TTL higher than this, it will be clamped.\n   * If put() specifies None, this value will be used.\n   * Hubert is intended for coordination, not long-term storage.\n   */\n  maxTtl: number;\n  /** Enable verbose logging with timestamps */\n  verbose: boolean;\n}\n\n/**\n * Default server configuration.\n *\n * Port of `impl Default for ServerConfig` from server/server.rs lines 32-40.\n */\nexport const defaultServerConfig: ServerConfig = {\n  port: 45678,\n  maxTtl: 86400, // 24 hours max (and default)\n  verbose: false,\n};\n\n/**\n * Shared server state.\n *\n * Port of `struct ServerState` from server/server.rs lines 43-47.\n *\n * @internal\n */\nclass ServerState {\n  storage: ServerKv;\n  config: ServerConfig;\n\n  constructor(config: ServerConfig, storage: ServerKv) {\n    this.storage = storage;\n    this.config = config;\n  }\n\n  /**\n   * Put an envelope into storage.\n   *\n   * Port of `ServerState::put()` from server/server.rs lines 54-101.\n   */\n  async put(\n    arid: ARID,\n    envelope: Envelope,\n    requestedTtl: number | undefined,\n    clientIp: string | undefined,\n  ): Promise<void> {\n    // Determine effective TTL:\n    // - If requested, use it (clamped to maxTtl)\n    // - If undefined requested, use maxTtl\n    // All entries expire (hubert is for coordination, not long-term storage)\n    const maxTtl = this.config.maxTtl;\n    let ttl: number;\n    if (requestedTtl !== undefined) {\n      ttl = requestedTtl > maxTtl ? maxTtl : requestedTtl;\n    } else {\n      ttl = maxTtl;\n    }\n\n    try {\n      await putSync(this.storage, arid, envelope, ttl);\n\n      if (this.config.verbose) {\n        const ipStr = clientIp ? `${clientIp}: ` : \"\";\n        verbosePrintln(`${ipStr}PUT ${arid.urString()} (TTL ${ttl}s) OK`);\n      }\n    } catch (error) {\n      if (this.config.verbose) {\n        const ipStr = clientIp ? `${clientIp}: ` : \"\";\n        const errorMsg = error instanceof Error ? error.message : String(error);\n        verbosePrintln(`${ipStr}PUT ${arid.urString()} (TTL ${ttl}s) ERROR: ${errorMsg}`);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Get an envelope from storage.\n   *\n   * Port of `ServerState::get()` from server/server.rs lines 103-126.\n   */\n  async get(arid: ARID, clientIp: string | undefined): Promise<Envelope | null> {\n    const result = await getSync(this.storage, arid);\n\n    if (this.config.verbose) {\n      const ipStr = clientIp ? `${clientIp}: ` : \"\";\n      const status = result ? \"OK\" : \"NOT_FOUND\";\n      verbosePrintln(`${ipStr}GET ${arid.urString()} ${status}`);\n    }\n\n    return result;\n  }\n}\n\n/**\n * Hubert HTTP server.\n *\n * Port of `struct Server` from server/server.rs lines 128-133.\n *\n * @category Server\n *\n * @example\n * ```typescript\n * const server = Server.newMemory({ port: 8080, maxTtl: 3600, verbose: true });\n * await server.run();\n * ```\n */\nexport class Server {\n  private readonly config: ServerConfig;\n  private readonly state: ServerState;\n  private readonly fastify: FastifyInstance;\n\n  /**\n   * Create a new server with the given configuration and storage backend.\n   *\n   * Port of `Server::new()` from server/server.rs lines 135-139.\n   */\n  constructor(config: ServerConfig, storage: ServerKv) {\n    this.config = config;\n    this.state = new ServerState(config, storage);\n    this.fastify = Fastify({ logger: false });\n    this.setupRoutes();\n  }\n\n  /**\n   * Create a new server with in-memory storage.\n   *\n   * Port of `Server::new_memory()` from server/server.rs lines 142-144.\n   */\n  static newMemory(config: Partial<ServerConfig> = {}): Server {\n    const fullConfig = { ...defaultServerConfig, ...config };\n    return new Server(fullConfig, new MemoryKv());\n  }\n\n  /**\n   * Create a new server with SQLite storage.\n   *\n   * Port of `Server::new_sqlite()` from server/server.rs lines 147-149.\n   */\n  static newSqlite(config: Partial<ServerConfig> = {}, storage: SqliteKv): Server {\n    const fullConfig = { ...defaultServerConfig, ...config };\n    return new Server(fullConfig, storage);\n  }\n\n  /**\n   * Setup HTTP routes.\n   * @internal\n   */\n  private setupRoutes(): void {\n    // Health check endpoint\n    this.fastify.get(\"/health\", this.handleHealth.bind(this));\n\n    // PUT endpoint\n    this.fastify.post(\"/put\", this.handlePut.bind(this));\n\n    // GET endpoint\n    this.fastify.post(\"/get\", this.handleGet.bind(this));\n  }\n\n  /**\n   * Handle health check requests.\n   *\n   * Port of `handle_health()` from server/server.rs lines 179-187.\n   */\n  // eslint-disable-next-line @typescript-eslint/require-await\n  private async handleHealth(_request: FastifyRequest, reply: FastifyReply): Promise<void> {\n    reply.send({\n      server: \"hubert\",\n      version: VERSION,\n      status: \"ok\",\n    });\n  }\n\n  /**\n   * Handle PUT requests.\n   *\n   * Port of `handle_put()` from server/server.rs lines 195-238.\n   */\n  private async handlePut(\n    request: FastifyRequest<{ Body: string }>,\n    reply: FastifyReply,\n  ): Promise<void> {\n    try {\n      const bodyStr = request.body;\n      if (typeof bodyStr !== \"string\") {\n        reply.status(400).send(\"Expected text body\");\n        return;\n      }\n\n      const lines = bodyStr.split(\"\\n\");\n      if (lines.length < 2) {\n        reply.status(400).send(\"Expected at least 2 lines: ur:arid and ur:envelope\");\n        return;\n      }\n\n      // Parse ARID\n      let arid: ARID;\n      try {\n        arid = ARID.fromUrString(lines[0]);\n      } catch {\n        reply.status(400).send(\"Invalid ur:arid\");\n        return;\n      }\n\n      // Parse Envelope\n      let envelope: Envelope;\n      try {\n        envelope = Envelope.fromUrString(lines[1]);\n      } catch {\n        reply.status(400).send(\"Invalid ur:envelope\");\n        return;\n      }\n\n      // Parse optional TTL\n      let ttl: number | undefined;\n      if (lines.length > 2 && lines[2].trim() !== \"\") {\n        const parsed = parseInt(lines[2], 10);\n        if (isNaN(parsed)) {\n          reply.status(400).send(\"Invalid TTL\");\n          return;\n        }\n        ttl = parsed;\n      }\n\n      // Get client IP\n      const clientIp = request.ip;\n\n      // Store the envelope\n      await this.state.put(arid, envelope, ttl, clientIp);\n\n      reply.status(200).send(\"OK\");\n    } catch (error) {\n      // Check if it's an AlreadyExists error\n      if (error instanceof Error && error.name === \"AlreadyExistsError\") {\n        reply.status(409).send(error.message);\n      } else {\n        reply.status(500).send(error instanceof Error ? error.message : \"Internal server error\");\n      }\n    }\n  }\n\n  /**\n   * Handle GET requests.\n   *\n   * Port of `handle_get()` from server/server.rs lines 244-269.\n   */\n  private async handleGet(\n    request: FastifyRequest<{ Body: string }>,\n    reply: FastifyReply,\n  ): Promise<void> {\n    try {\n      const bodyStr = request.body;\n      if (typeof bodyStr !== \"string\") {\n        reply.status(400).send(\"Expected text body\");\n        return;\n      }\n\n      const aridStr = bodyStr.trim();\n      if (aridStr === \"\") {\n        reply.status(400).send(\"Expected ur:arid\");\n        return;\n      }\n\n      // Parse ARID\n      let arid: ARID;\n      try {\n        arid = ARID.fromUrString(aridStr);\n      } catch {\n        reply.status(400).send(\"Invalid ur:arid\");\n        return;\n      }\n\n      // Get client IP\n      const clientIp = request.ip;\n\n      // Retrieve the envelope\n      const envelope = await this.state.get(arid, clientIp);\n\n      if (envelope) {\n        reply.status(200).send(envelope.urString());\n      } else {\n        reply.status(404).send(\"Not found\");\n      }\n    } catch (error) {\n      reply.status(500).send(error instanceof Error ? error.message : \"Internal server error\");\n    }\n  }\n\n  /**\n   * Run the server.\n   *\n   * Port of `Server::run()` from server/server.rs lines 152-170.\n   */\n  async run(): Promise<void> {\n    const addr = `127.0.0.1:${this.config.port}`;\n\n    // Configure Fastify to parse plain text bodies\n    this.fastify.addContentTypeParser(\n      \"text/plain\",\n      { parseAs: \"string\" },\n      (_request, payload, done) => {\n        done(null, payload);\n      },\n    );\n\n    // Also handle application/octet-stream and no content-type\n    this.fastify.addContentTypeParser(\n      \"application/octet-stream\",\n      { parseAs: \"string\" },\n      (_request, payload, done) => {\n        done(null, payload);\n      },\n    );\n\n    await this.fastify.listen({ port: this.config.port, host: \"127.0.0.1\" });\n    console.log(`✓ Hubert server listening on ${addr}`);\n  }\n\n  /**\n   * Get the port the server is configured to listen on.\n   *\n   * Port of `Server::port()` from server/server.rs line 173.\n   */\n  port(): number {\n    return this.config.port;\n  }\n\n  /**\n   * Stop the server.\n   */\n  async close(): Promise<void> {\n    await this.fastify.close();\n  }\n}\n","/**\n * Server-backed key-value store using HTTP API.\n *\n * Port of server/kv.rs from hubert-rust.\n *\n * @module\n */\n\nimport { type ARID } from \"@bcts/components\";\nimport { Envelope } from \"@bcts/envelope\";\n\nimport { AlreadyExistsError } from \"../error.js\";\nimport { type KvStore } from \"../kv-store.js\";\nimport { verboseNewline, verbosePrintDot, verbosePrintln } from \"../logging.js\";\nimport { ServerGeneralError, ServerNetworkError, ServerParseError } from \"./error.js\";\n\n/**\n * Server-backed key-value store using HTTP API.\n *\n * This implementation communicates with a Hubert server via HTTP POST requests.\n *\n * Port of `struct ServerKvClient` from server/kv.rs lines 6-37.\n *\n * @category Server Backend\n *\n * @example\n * ```typescript\n * const store = new ServerKvClient(\"http://127.0.0.1:45678\");\n * const arid = ARID.new();\n * const envelope = Envelope.new(\"Hello, Server!\");\n *\n * // Put envelope (write-once)\n * await store.put(arid, envelope);\n *\n * // Get envelope with verbose logging\n * const retrieved = await store.get(arid, undefined, true);\n * ```\n */\nexport class ServerKvClient implements KvStore {\n  private readonly baseUrl: string;\n\n  /**\n   * Create a new server KV store client.\n   *\n   * Port of `ServerKvClient::new()` from server/kv.rs lines 39-46.\n   *\n   * @param baseUrl - Base URL of the Hubert server (e.g., \"http://127.0.0.1:45678\")\n   */\n  constructor(baseUrl: string) {\n    this.baseUrl = baseUrl;\n  }\n\n  /**\n   * Store an envelope at the given ARID.\n   *\n   * Port of `KvStore::put()` implementation from server/kv.rs lines 67-122.\n   */\n  async put(\n    arid: ARID,\n    envelope: Envelope,\n    ttlSeconds?: number,\n    verbose?: boolean,\n  ): Promise<string> {\n    if (verbose) {\n      verbosePrintln(\"Starting server put operation\");\n    }\n\n    // Format body with optional TTL on third line\n    let body: string;\n    if (ttlSeconds !== undefined) {\n      body = `${arid.urString()}\\n${envelope.urString()}\\n${ttlSeconds}`;\n    } else {\n      body = `${arid.urString()}\\n${envelope.urString()}`;\n    }\n\n    if (verbose) {\n      verbosePrintln(\"Sending PUT request to server\");\n    }\n\n    try {\n      const response = await fetch(`${this.baseUrl}/put`, {\n        method: \"POST\",\n        body,\n        headers: {\n          \"Content-Type\": \"text/plain\",\n        },\n      });\n\n      if (response.status === 200) {\n        if (verbose) {\n          verbosePrintln(\"Server put operation completed\");\n        }\n        return \"Stored successfully\";\n      } else if (response.status === 409) {\n        if (verbose) {\n          verbosePrintln(\"Server put operation failed\");\n        }\n        throw new AlreadyExistsError(arid.urString());\n      } else {\n        if (verbose) {\n          verbosePrintln(\"Server put operation failed\");\n        }\n        const errorMsg = await response.text();\n        throw new ServerGeneralError(errorMsg);\n      }\n    } catch (error) {\n      if (error instanceof AlreadyExistsError || error instanceof ServerGeneralError) {\n        throw error;\n      }\n      throw new ServerNetworkError(error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  /**\n   * Retrieve an envelope for the given ARID.\n   *\n   * Port of `KvStore::get()` implementation from server/kv.rs lines 124-212.\n   */\n  async get(arid: ARID, timeoutSeconds?: number, verbose?: boolean): Promise<Envelope | null> {\n    let printedDot = false;\n\n    if (verbose) {\n      verbosePrintln(\"Starting server get operation\");\n    }\n\n    const timeout = timeoutSeconds ?? 30; // Default 30 seconds\n    const deadline = Date.now() + timeout * 1000;\n    // Changed to 1000ms for verbose mode polling\n    const pollInterval = 1000;\n\n    if (verbose) {\n      verbosePrintln(\"Polling server for value\");\n    }\n\n    while (true) {\n      const body = arid.urString();\n\n      try {\n        const response = await fetch(`${this.baseUrl}/get`, {\n          method: \"POST\",\n          body,\n          headers: {\n            \"Content-Type\": \"text/plain\",\n          },\n        });\n\n        if (response.status === 200) {\n          if (verbose && printedDot) {\n            verboseNewline();\n          }\n          if (verbose) {\n            verbosePrintln(\"Value found on server\");\n          }\n\n          const envelopeStr = await response.text();\n          try {\n            const envelope = Envelope.fromUrString(envelopeStr);\n\n            if (verbose) {\n              verbosePrintln(\"Server get operation completed\");\n            }\n\n            return envelope;\n          } catch (error) {\n            throw new ServerParseError(error instanceof Error ? error.message : String(error));\n          }\n        } else if (response.status === 404) {\n          // Not found yet - check if we should keep polling\n          if (Date.now() >= deadline) {\n            // Timeout reached\n            if (verbose && printedDot) {\n              verboseNewline();\n            }\n            if (verbose) {\n              verbosePrintln(\"Timeout reached, value not found\");\n            }\n            return null;\n          }\n\n          // Print polling dot if verbose\n          if (verbose) {\n            verbosePrintDot();\n            printedDot = true;\n          }\n\n          // Wait before retrying (now 1000ms)\n          await new Promise((resolve) => setTimeout(resolve, pollInterval));\n        } else {\n          const errorMsg = await response.text();\n          throw new ServerGeneralError(errorMsg);\n        }\n      } catch (error) {\n        if (error instanceof ServerGeneralError || error instanceof ServerParseError) {\n          throw error;\n        }\n        throw new ServerNetworkError(error instanceof Error ? error.message : String(error));\n      }\n    }\n  }\n\n  /**\n   * Check if an envelope exists at the given ARID.\n   *\n   * Port of `KvStore::exists()` implementation from server/kv.rs lines 214-218.\n   */\n  async exists(arid: ARID): Promise<boolean> {\n    // Use a short timeout for exists check (1 second), no verbose\n    const result = await this.get(arid, 1, false);\n    return result !== null;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,125 @@
+{
+  "name": "@bcts/hubert",
+  "version": "1.0.0-alpha.17",
+  "type": "module",
+  "description": "Hubert - Distributed infrastructure for secure multiparty transactions using Gordian Envelope",
+  "license": "BSD-2-Clause-Patent",
+  "contributors": [
+    {
+      "name": "Leonardo Custodio",
+      "email": "leonardo.custodio@parity.io",
+      "url": "https://github.com/leonardocustodio"
+    },
+    {
+      "name": "Karim Jedda",
+      "email": "karim@parity.io",
+      "url": "https://github.com/KarimJedda"
+    }
+  ],
+  "homepage": "https://bcts.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/leonardocustodio/bcts",
+    "directory": "packages/hubert"
+  },
+  "bugs": {
+    "url": "https://github.com/leonardocustodio/bcts/issues"
+  },
+  "bin": {
+    "hubert": "./dist/bin/hubert.mjs"
+  },
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    },
+    "./ipfs": {
+      "types": "./dist/ipfs/index.d.mts",
+      "import": "./dist/ipfs/index.mjs",
+      "require": "./dist/ipfs/index.cjs"
+    },
+    "./mainline": {
+      "types": "./dist/mainline/index.d.mts",
+      "import": "./dist/mainline/index.mjs",
+      "require": "./dist/mainline/index.cjs"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.mts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.cjs"
+    },
+    "./hybrid": {
+      "types": "./dist/hybrid/index.d.mts",
+      "import": "./dist/hybrid/index.mjs",
+      "require": "./dist/hybrid/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint 'src/**/*.ts' 'tests/**/*.ts'",
+    "lint:fix": "eslint 'src/**/*.ts' 'tests/**/*.ts' --fix",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs": "typedoc",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "keywords": [
+    "hubert",
+    "blockchain-commons",
+    "gordian-envelope",
+    "distributed-storage",
+    "dht",
+    "mainline",
+    "ipfs",
+    "frost",
+    "threshold-signatures",
+    "multiparty",
+    "arid",
+    "key-value-store"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@bcts/components": "workspace:*",
+    "@bcts/crypto": "workspace:*",
+    "@bcts/dcbor": "workspace:*",
+    "@bcts/envelope": "workspace:*",
+    "@bcts/known-values": "workspace:*",
+    "@bcts/rand": "workspace:*",
+    "@noble/ciphers": "^2.1.1",
+    "@noble/curves": "^2.0.1",
+    "better-sqlite3": "^12.6.2",
+    "bittorrent-dht": "^11.0.7",
+    "commander": "^13.1.0",
+    "fastify": "^5.7.1",
+    "kubo-rpc-client": "^6.0.2"
+  },
+  "devDependencies": {
+    "@bcts/eslint": "workspace:*",
+    "@bcts/tsconfig": "workspace:*",
+    "@eslint/js": "^9.39.2",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.0.10",
+    "eslint": "^9.39.2",
+    "globals": "^17.1.0",
+    "prettier": "^3.8.1",
+    "ts-node": "^10.9.2",
+    "tsdown": "^0.20.1",
+    "typedoc": "^0.28.16",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

package/src/arid-derivation.ts

@@ -0,0 +1,155 @@
+/**
+ * ARID key derivation and obfuscation utilities.
+ *
+ * Port of arid_derivation.rs from hubert-rust.
+ *
+ * @module
+ */
+
+import { type ARID } from "@bcts/components";
+import { hkdfHmacSha256 } from "@bcts/crypto";
+import { chacha20 } from "@noble/ciphers/chacha.js";
+
+/**
+ * Derive a deterministic key from an ARID using a specific salt.
+ *
+ * Uses HKDF to derive key material from the ARID, ensuring that:
+ * - Same ARID always produces same key for a given salt
+ * - Keys are cryptographically derived (not guessable)
+ * - Collision resistance inherited from ARID
+ * - No identifying information in the key (fully anonymized)
+ *
+ * Port of `derive_key()` from arid_derivation.rs lines 8-29.
+ *
+ * @param salt - Domain-specific salt to ensure different backends derive different keys
+ * @param arid - The ARID to derive from
+ * @param outputLen - Length of output in bytes (typically 20 or 32)
+ * @returns Derived key bytes
+ * @category ARID Derivation
+ *
+ * @example
+ * ```typescript
+ * const key = deriveKey(new TextEncoder().encode("my-salt"), arid, 32);
+ * ```
+ */
+export function deriveKey(salt: Uint8Array, arid: ARID, outputLen: number): Uint8Array {
+  const aridBytes = arid.data();
+  // Note: @bcts/crypto hkdfHmacSha256 takes (keyMaterial, salt, keyLen)
+  // Rust bc-crypto takes (salt, ikm, keyLen)
+  return hkdfHmacSha256(aridBytes, salt, outputLen);
+}
+
+/**
+ * Salt for IPFS IPNS key derivation.
+ * @internal
+ */
+const IPFS_KEY_NAME_SALT = new TextEncoder().encode("hubert-ipfs-ipns-v1");
+
+/**
+ * Salt for Mainline DHT key derivation.
+ * @internal
+ */
+const MAINLINE_KEY_SALT = new TextEncoder().encode("hubert-mainline-dht-v1");
+
+/**
+ * Salt for obfuscation key derivation.
+ * @internal
+ */
+const OBFUSCATION_SALT = new TextEncoder().encode("hubert-obfuscation-v1");
+
+/**
+ * Derive an IPNS key name from an ARID.
+ *
+ * Returns a 64-character hex string suitable for use as an IPFS key name.
+ *
+ * Port of `derive_ipfs_key_name()` from arid_derivation.rs lines 31-37.
+ *
+ * @param arid - The ARID to derive from
+ * @returns 64-character hex string
+ * @category ARID Derivation
+ *
+ * @example
+ * ```typescript
+ * const keyName = deriveIpfsKeyName(arid);
+ * // => "a1b2c3d4e5f6..." (64 hex characters)
+ * ```
+ */
+export function deriveIpfsKeyName(arid: ARID): string {
+  const keyBytes = deriveKey(IPFS_KEY_NAME_SALT, arid, 32);
+  return bytesToHex(keyBytes);
+}
+
+/**
+ * Derive Mainline DHT key material from an ARID.
+ *
+ * Returns 20 bytes of key material (SHA-1 compatible length).
+ *
+ * Port of `derive_mainline_key()` from arid_derivation.rs lines 39-45.
+ *
+ * @param arid - The ARID to derive from
+ * @returns 20 bytes of key material
+ * @category ARID Derivation
+ *
+ * @example
+ * ```typescript
+ * const key = deriveMainlineKey(arid);
+ * // => Uint8Array(20) [...]
+ * ```
+ */
+export function deriveMainlineKey(arid: ARID): Uint8Array {
+  return deriveKey(MAINLINE_KEY_SALT, arid, 20);
+}
+
+/**
+ * Obfuscate or deobfuscate data using ChaCha20 with an ARID-derived key.
+ *
+ * This function uses ChaCha20 as a stream cipher to XOR the data with a
+ * keystream derived from the ARID. Since XOR is symmetric, the same function
+ * is used for both obfuscation and deobfuscation.
+ *
+ * The result appears as uniform random data to anyone who doesn't have the
+ * ARID, hiding both the structure and content of the reference envelope.
+ *
+ * Port of `obfuscate_with_arid()` from arid_derivation.rs lines 47-91.
+ *
+ * @param arid - The ARID used to derive the obfuscation key
+ * @param data - The data to obfuscate or deobfuscate
+ * @returns The obfuscated (or deobfuscated) data
+ * @category ARID Derivation
+ *
+ * @example
+ * ```typescript
+ * const obfuscated = obfuscateWithArid(arid, plaintext);
+ * const deobfuscated = obfuscateWithArid(arid, obfuscated);
+ * // deobfuscated === plaintext
+ * ```
+ */
+export function obfuscateWithArid(arid: ARID, data: Uint8Array): Uint8Array {
+  if (data.length === 0) {
+    return new Uint8Array(0);
+  }
+
+  // Derive a 32-byte key from the ARID using HKDF with domain-specific salt
+  const key = deriveKey(OBFUSCATION_SALT, arid, 32);
+
+  // Derive IV from the key (last 12 bytes, reversed)
+  // Match Rust: key.iter().rev().take(12).copied().collect()
+  const iv = new Uint8Array(12);
+  for (let i = 0; i < 12; i++) {
+    iv[i] = key[31 - i];
+  }
+
+  // Use ChaCha20 to XOR the data
+  // @noble/ciphers chacha20 takes (key, nonce, data) and returns encrypted data
+  return chacha20(key, iv, data);
+}
+
+/**
+ * Convert bytes to lowercase hex string.
+ * @internal
+ */
+function bytesToHex(bytes: Uint8Array): string {
+  return Array.from(bytes)
+    .map((b) => b.toString(16).padStart(2, "0"))
+    .join("");
+}