@bcts/frost-hubert 1.0.0-alpha.17

package/dist/index-BJeUYrdE.d.mts

@@ -0,0 +1,396 @@
+import { ARID, PublicKeys, SigningPublicKey, XID } from "@bcts/components";
+import { XIDDocument } from "@bcts/xid";
+
+//#region src/registry/group-record.d.ts
+/**
+ * A participant in a group.
+ *
+ * Port of `struct GroupParticipant` from group_record.rs lines 9-13.
+ */
+declare class GroupParticipant {
+  private readonly _xid;
+  constructor(xid: XID);
+  xid(): XID;
+  toJSON(): string;
+  static fromJSON(value: string): GroupParticipant;
+}
+/**
+ * Contribution paths for DKG state files.
+ *
+ * Port of `struct ContributionPaths` from group_record.rs lines 21-29.
+ */
+declare class ContributionPaths {
+  round1Secret?: string | undefined;
+  round1Package?: string | undefined;
+  round2Secret?: string | undefined;
+  keyPackage?: string | undefined;
+  constructor(init?: Partial<ContributionPaths>);
+  /**
+   * Merge missing fields from another ContributionPaths.
+   *
+   * Port of `ContributionPaths::merge_missing()` from group_record.rs lines 32-45.
+   */
+  mergeMissing(other: ContributionPaths): void;
+  /**
+   * Check if all fields are empty.
+   *
+   * Port of `ContributionPaths::is_empty()` from group_record.rs lines 47-53.
+   */
+  isEmpty(): boolean;
+  toJSON(): Record<string, string>;
+  static fromJSON(json: Record<string, string>): ContributionPaths;
+}
+/**
+ * Tracks pending communication with participants (coordinator-side).
+ *
+ * Port of `struct PendingRequests` from group_record.rs lines 71-75.
+ */
+declare class PendingRequests {
+  private readonly requests;
+  /**
+   * Add a pending request where we only know where to collect from.
+   *
+   * Port of `PendingRequests::add_collect_only()` from group_record.rs lines 90-99.
+   */
+  addCollectOnly(participant: XID, collectFromArid: ARID): void;
+  /**
+   * Add a pending request where we know where to send AND where to collect.
+   *
+   * Port of `PendingRequests::add_send_and_collect()` from group_record.rs lines 103-115.
+   */
+  addSendAndCollect(participant: XID, sendToArid: ARID, collectFromArid: ARID): void;
+  /**
+   * Add a pending request where we only know where to send.
+   *
+   * Port of `PendingRequests::add_send_only()` from group_record.rs lines 118-127.
+   */
+  addSendOnly(participant: XID, sendToArid: ARID): void;
+  /**
+   * Check if there are no pending requests.
+   *
+   * Port of `PendingRequests::is_empty()` from group_record.rs line 129.
+   */
+  isEmpty(): boolean;
+  /**
+   * Get the number of pending requests.
+   *
+   * Port of `PendingRequests::len()` from group_record.rs line 165.
+   */
+  len(): number;
+  /**
+   * Iterate over (participant, collectFromArid) pairs.
+   *
+   * Port of `PendingRequests::iter_collect()` from group_record.rs lines 132-138.
+   */
+  iterCollect(): Generator<[XID, ARID]>;
+  /**
+   * Iterate over (participant, sendToArid) pairs.
+   *
+   * Port of `PendingRequests::iter_send()` from group_record.rs lines 141-150.
+   */
+  iterSend(): Generator<[XID, ARID]>;
+  /**
+   * Iterate over full (participant, sendToArid, collectFromArid) tuples.
+   *
+   * Port of `PendingRequests::iter_full()` from group_record.rs lines 153-163.
+   */
+  iterFull(): Generator<[XID, ARID | undefined, ARID]>;
+  toJSON(): unknown[];
+  static fromJSON(json: unknown[]): PendingRequests;
+}
+/**
+ * Record of a DKG group.
+ *
+ * Port of `struct GroupRecord` from group_record.rs lines 168-186.
+ */
+declare class GroupRecord {
+  private readonly _charter;
+  private readonly _minSigners;
+  private readonly _coordinator;
+  private readonly _participants;
+  private _contributions;
+  private _listeningAtArid?;
+  private _pendingRequests;
+  private _verifyingKey?;
+  constructor(charter: string, minSigners: number, coordinator: GroupParticipant, participants: GroupParticipant[]);
+  coordinator(): GroupParticipant;
+  participants(): GroupParticipant[];
+  minSigners(): number;
+  charter(): string;
+  contributions(): ContributionPaths;
+  setContributions(contributions: ContributionPaths): void;
+  mergeContributions(other: ContributionPaths): void;
+  listeningAtArid(): ARID | undefined;
+  setListeningAtArid(arid: ARID): void;
+  clearListeningAtArid(): void;
+  pendingRequests(): PendingRequests;
+  setPendingRequests(requests: PendingRequests): void;
+  clearPendingRequests(): void;
+  /**
+   * Check if the config matches another group record.
+   *
+   * Port of `GroupRecord::config_matches()` from group_record.rs lines 247-253.
+   */
+  configMatches(other: GroupRecord): boolean;
+  verifyingKey(): SigningPublicKey | undefined;
+  setVerifyingKey(key: SigningPublicKey): void;
+  toJSON(): Record<string, unknown>;
+  static fromJSON(json: Record<string, unknown>): GroupRecord;
+}
+//#endregion
+//#region src/registry/owner-record.d.ts
+/**
+ * Record of the registry owner (coordinator).
+ *
+ * Port of `struct OwnerRecord` from owner_record.rs lines 13-17.
+ */
+declare class OwnerRecord {
+  private readonly _xidDocumentUr;
+  private readonly _xidDocument;
+  private readonly _petName;
+  private constructor();
+  /**
+   * Create an owner record from a signed XID UR string.
+   *
+   * Port of `OwnerRecord::from_signed_xid_ur()` from owner_record.rs lines 20-32.
+   */
+  static fromSignedXidUr(xidDocumentUr: string, petName?: string): OwnerRecord;
+  /**
+   * Get the XID of the owner.
+   *
+   * Port of `OwnerRecord::xid()` from owner_record.rs line 34.
+   */
+  xid(): XID;
+  /**
+   * Get the XID document of the owner.
+   *
+   * Port of `OwnerRecord::xid_document()` from owner_record.rs line 36.
+   */
+  xidDocument(): XIDDocument;
+  /**
+   * Get the UR string of the XID document.
+   *
+   * Port of `OwnerRecord::xid_document_ur()` from owner_record.rs line 38.
+   */
+  xidDocumentUr(): string;
+  /**
+   * Get the pet name of the owner.
+   *
+   * Port of `OwnerRecord::pet_name()` from owner_record.rs line 40.
+   */
+  petName(): string | undefined;
+  /**
+   * Serialize to JSON object.
+   */
+  toJSON(): Record<string, unknown>;
+  /**
+   * Deserialize from JSON object.
+   */
+  static fromJSON(json: Record<string, unknown>): OwnerRecord;
+}
+//#endregion
+//#region src/registry/participant-record.d.ts
+/**
+ * Record of a participant in the registry.
+ *
+ * Port of `struct ParticipantRecord` from participant_record.rs lines 12-17.
+ */
+declare class ParticipantRecord {
+  private readonly _xidDocumentUr;
+  private readonly _xidDocument;
+  private readonly _publicKeys;
+  private readonly _petName;
+  private constructor();
+  /**
+   * Create a participant record from a signed XID UR string.
+   *
+   * Port of `ParticipantRecord::from_signed_xid_ur()` from participant_record.rs lines 20-26.
+   */
+  static fromSignedXidUr(xidDocumentUr: string, petName?: string): ParticipantRecord;
+  /**
+   * Get the pet name of the participant.
+   *
+   * Port of `ParticipantRecord::pet_name()` from participant_record.rs line 28.
+   */
+  petName(): string | undefined;
+  /**
+   * Get the public keys of the participant.
+   *
+   * Port of `ParticipantRecord::public_keys()` from participant_record.rs line 29.
+   */
+  publicKeys(): PublicKeys;
+  /**
+   * Get the XID of the participant.
+   *
+   * Port of `ParticipantRecord::xid()` from participant_record.rs line 30.
+   */
+  xid(): XID;
+  /**
+   * Get the XID document of the participant.
+   *
+   * Port of `ParticipantRecord::xid_document()` from participant_record.rs line 31.
+   */
+  xidDocument(): XIDDocument;
+  /**
+   * Get the UR string of the XID document.
+   *
+   * Port of `ParticipantRecord::xid_document_ur()` from participant_record.rs line 32.
+   */
+  xidDocumentUr(): string;
+  /**
+   * Build from constituent parts.
+   *
+   * Port of `ParticipantRecord::build_from_parts()` from participant_record.rs lines 34-49.
+   */
+  private static buildFromParts;
+  /**
+   * Recreate from serialized data.
+   *
+   * Port of `ParticipantRecord::recreate_from_serialized()` from participant_record.rs lines 51-57.
+   */
+  private static recreateFromSerialized;
+  /**
+   * Serialize to JSON object.
+   */
+  toJSON(): Record<string, unknown>;
+  /**
+   * Deserialize from JSON object.
+   */
+  static fromJSON(json: Record<string, unknown>): ParticipantRecord;
+}
+//#endregion
+//#region src/registry/registry-impl.d.ts
+/**
+ * Outcome of adding a participant to the registry.
+ *
+ * Port of `enum AddOutcome` from registry_impl.rs.
+ */
+declare enum AddOutcome {
+  /** Participant was already present in the registry */
+  AlreadyPresent = "already_present",
+  /** Participant was successfully inserted */
+  Inserted = "inserted"
+}
+/**
+ * Outcome of setting the owner in the registry.
+ *
+ * Port of `enum OwnerOutcome` from registry_impl.rs.
+ */
+declare enum OwnerOutcome {
+  /** Owner was already present in the registry */
+  AlreadyPresent = "already_present",
+  /** Owner was successfully inserted */
+  Inserted = "inserted"
+}
+/**
+ * Outcome of recording a group in the registry.
+ *
+ * Port of `enum GroupOutcome` from registry_impl.rs.
+ */
+declare enum GroupOutcome {
+  /** Group was successfully inserted as new */
+  Inserted = "inserted",
+  /** Group already existed and was updated (contributions merged) */
+  Updated = "updated"
+}
+/**
+ * Registry for managing participants and groups.
+ *
+ * Port of `struct Registry` from registry_impl.rs lines 22-26.
+ */
+declare class Registry {
+  private _owner?;
+  private readonly _participants;
+  private readonly _groups;
+  constructor();
+  /**
+   * Get the owner record.
+   */
+  owner(): OwnerRecord | undefined;
+  /**
+   * Set the owner record.
+   *
+   * Returns the outcome indicating whether the owner was already present or newly inserted.
+   *
+   * Port of `Registry::set_owner()` from registry_impl.rs.
+   */
+  setOwner(owner: OwnerRecord): OwnerOutcome;
+  /**
+   * Get all participants.
+   */
+  participants(): Map<string, ParticipantRecord>;
+  /**
+   * Get a participant by XID.
+   */
+  participant(xid: XID): ParticipantRecord | undefined;
+  /**
+   * Add a participant.
+   *
+   * Returns the outcome indicating whether the participant was already present or newly inserted.
+   */
+  addParticipant(xid: XID, record: ParticipantRecord): AddOutcome;
+  /**
+   * Check if a pet name is already used.
+   */
+  petNameExists(petName: string): boolean;
+  /**
+   * Find a participant by pet name.
+   *
+   * Port of `Registry::participant_by_pet_name()` from registry_impl.rs.
+   */
+  participantByPetName(petName: string): [XID, ParticipantRecord] | undefined;
+  /**
+   * Get all groups.
+   */
+  groups(): Map<string, GroupRecord>;
+  /**
+   * Get a group by ARID.
+   */
+  group(arid: ARID): GroupRecord | undefined;
+  /**
+   * Get a mutable reference to a group by ARID.
+   */
+  groupMut(arid: ARID): GroupRecord | undefined;
+  /**
+   * Record a group in the registry.
+   *
+   * If the group already exists:
+   * - Validates that the config matches
+   * - Merges contributions from the new record
+   * - Updates verifying key if not already set
+   *
+   * Port of `Registry::record_group()` from registry_impl.rs.
+   */
+  recordGroup(groupId: ARID, record: GroupRecord): GroupOutcome;
+  /**
+   * Add a group (simple variant without merge logic).
+   *
+   * @deprecated Use recordGroup() for proper merge behavior.
+   */
+  addGroup(arid: ARID, record: GroupRecord): void;
+  /**
+   * Load a registry from a file.
+   */
+  static load(filePath: string): Registry;
+  /**
+   * Save the registry to a file.
+   */
+  save(filePath: string): void;
+  /**
+   * Serialize to JSON object.
+   */
+  toJSON(): Record<string, unknown>;
+  /**
+   * Deserialize from JSON object.
+   */
+  static fromJSON(json: Record<string, unknown>): Registry;
+}
+/**
+ * Resolve the registry file path from a given argument.
+ *
+ * Port of `resolve_registry_path()` from registry/mod.rs lines 49-78.
+ */
+declare function resolveRegistryPath(registryArg: string | undefined, cwd: string): string;
+//#endregion
+export { resolveRegistryPath as a, ContributionPaths as c, PendingRequests as d, Registry as i, GroupParticipant as l, GroupOutcome as n, ParticipantRecord as o, OwnerOutcome as r, OwnerRecord as s, AddOutcome as t, GroupRecord as u };
+//# sourceMappingURL=index-BJeUYrdE.d.mts.map

package/dist/index-BJeUYrdE.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BJeUYrdE.d.mts","names":[],"sources":["../src/registry/group-record.ts","../src/registry/owner-record.ts","../src/registry/participant-record.ts","../src/registry/registry-impl.ts"],"mappings":"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"}