@obbyx/x402-obyte 0.0.0-stage → 0.2.0

package/src/index.ts

@@ -0,0 +1,111 @@
+export { type HubOutcome, hubCall } from './hub/hub-call.js';
+export {
+  EXACT_SCHEME,
+  type ExactExtra,
+  type ParsedExactRequirements,
+  acceptedMatches,
+  canonical,
+  exactExtraSchema,
+  parseExactRequirements,
+} from './exact/requirements.js';
+export {
+  type NewSettlement,
+  type SettlementEvent,
+  type SettlementRecord,
+  type SettlementState,
+  type SettlementStore,
+  SqliteSettlementStore,
+  type TransitionPatch,
+  StoreLockedError,
+  TERMINAL_STATES,
+} from './exact/store.js';
+export {
+  EXACT_SETTLE_REASONS,
+  HISTORY_PROBE_ADDRESS,
+  ExactObyteFacilitator,
+  type ExactObyteFacilitatorOptions,
+  type FinalityPolicy,
+} from './exact/facilitator.js';
+export { ExactObyteClient, type ExactObyteClientOptions } from './exact/client.js';
+export { type WatcherGateway, type WatcherHealth } from './batch/gateway.js';
+export {
+  BATCH_REASONS,
+  BATCH_SCHEME,
+  type BatchExtra,
+  type ParsedBatchRequirements,
+  type VoucherMessage,
+  batchExtraSchema,
+  parseBatchRequirements,
+  voucherMessageSchema,
+} from './batch/requirements.js';
+export {
+  type AppendInput,
+  type AppendResult,
+  type BatchStore,
+  SqliteBatchStore,
+  type ChannelRow,
+  type CommitmentRow,
+  type CommitmentState,
+} from './batch/store.js';
+export { BatchObyteFacilitator, type BatchObyteFacilitatorOptions } from './batch/facilitator.js';
+export {
+  type ClientMessage,
+  type CommitmentMessage,
+  type ServerMessage,
+  WATCHER_LOGIN_PURPOSE,
+  clientMessageSchema,
+  commitmentMessageSchema,
+  loginMessage,
+  serverMessageSchema,
+  verifyWatcherLogin,
+} from './batch/watcher-protocol.js';
+export { startHeartbeat } from './hub/heartbeat.js';
+export {
+  ClientChannelStore,
+  type ClientChannel,
+  type PendingVoucher,
+} from './batch/client-store.js';
+export {
+  BatchObyteClient,
+  type BatchClientOptions,
+  MIN_DEPOSIT,
+  TRIGGER_FEE,
+  addressOfKey,
+  closeChannel,
+  confirmClose,
+  deposit,
+  openChannel,
+} from './batch/client.js';
+export {
+  CoinReservations,
+  type HistoryJoint,
+  type ReservationRow,
+  ReservingComposer,
+  type ReservingComposerOptions,
+  type Utxo,
+  inputKey,
+  selectCoins,
+  unspentOutputs,
+} from './coins/index.js';
+export {
+  type BindingInput,
+  bindingsEqual,
+  computeBinding,
+  newQuoteId,
+  sha256Hex,
+} from './binding/binding.js';
+export {
+  ExactObyteFacilitatorV1,
+  type PaymentPayloadV1,
+  type PaymentRequirementsV1,
+  requirementsV1ToV2,
+  requirementsV2ToV1,
+} from './exact/facilitator-v1.js';
+export {
+  type LedgerUnit,
+  type ProofchainBall,
+  parseHistory,
+  parseLedgerUnit,
+  parseStateVars,
+} from './hub/schemas.js';
+export { KeyedQueue } from './util/keyed-queue.js';

package/src/util/keyed-queue.ts

@@ -0,0 +1,25 @@
+/**
+ * Runs tasks one at a time per key, in arrival order; different keys run in
+ * parallel. A failing task never blocks the ones queued after it. Used where
+ * check-then-act must not interleave within one process: per channel in the
+ * batch facilitator and in the seller watcher.
+ */
+export class KeyedQueue {
+  private readonly tails = new Map<string, Promise<unknown>>();
+
+  run<T>(key: string, task: () => Promise<T>): Promise<T> {
+    const previous = this.tails.get(key) ?? Promise.resolve();
+    const result = previous.then(task, task);
+    const tail = result.catch(() => undefined);
+    this.tails.set(key, tail);
+    void tail.then(() => {
+      if (this.tails.get(key) === tail) this.tails.delete(key);
+    });
+    return result;
+  }
+
+  /** Keys with queued or running tasks (for tests and diagnostics). */
+  get size(): number {
+    return this.tails.size;
+  }
+}