@dispatch-foo/protocol 0.0.0 → 0.2.0

package/dist/federation/index.d.ts

@@ -0,0 +1,360 @@
+import "../constants-CUM7Sm5u.js";
+import { C as JsonValue, F as Address, T as Message, f as DeliveryVia, i as RevisionCause, n as LinkRel, r as LinkTarget, t as DocStatus } from "../untrusted-DJNiucEX-tUd9XZzz.js";
+
+//#region src/federation/ops.d.ts
+type OpType = 'key' | 'roster' | 'task' | 'presence' | 'agent' | 'channel' | 'mail' | 'state' | 'memory' | 'doc' | 'a2a';
+declare const OP_TYPES: readonly OpType[];
+declare const SEALED_TYPES: ReadonlySet<string>;
+declare const STUBBABLE_TYPES: ReadonlySet<string>;
+declare const MAX_OP_BYTES = 1048576;
+declare const MAX_SEALED_RECIPIENTS = 256;
+declare const MAX_STATE_ENTRIES = 500;
+declare const REPLICA_ID: RegExp;
+declare const ZERO_HASH: string;
+declare const TAG: {
+  readonly op: "dispatch-op-v2";
+  readonly sealed: "dispatch-sealed-v1";
+  readonly ack: "dispatch-ack-v1";
+  readonly relay: "dispatch-relay-v1";
+  readonly invite: "dispatch-invite-v1";
+  readonly recovery: "dispatch-recovery-v1";
+  readonly fingerprint: "dispatch-fp-v1";
+};
+interface OpHeader {
+  v: 2;
+  replica: string;
+  seq: number;
+  prev: string;
+  hlc: string;
+  type: string;
+  to?: string[];
+  bodyHash: string;
+}
+interface Sealed {
+  nonce: string;
+  ct: string;
+  keys: Record<string, {
+    enc: string;
+    ct: string;
+  }>;
+}
+interface FederatedOp extends OpHeader {
+  body?: JsonValue;
+  sealed?: Sealed;
+  sig: string;
+}
+interface OpStub extends OpHeader {
+  sig: string;
+  pruned: true;
+}
+type LogEntry = FederatedOp | OpStub;
+interface MailPayload {
+  message: Message;
+  targets: MailTarget[];
+}
+interface MailTarget {
+  recipient: Address;
+  via: DeliveryVia;
+  homes: string[];
+  wakeAt?: string;
+}
+interface ForwardPayload {
+  target: Address;
+  key: string;
+}
+interface StatePayload {
+  entries: ({
+    t: 'delivery';
+    message: string;
+    recipient: Address;
+    state: 'held' | 'pushed' | 'notified' | 'read' | 'answered';
+    at: string;
+  } | {
+    t: 'settle';
+    question: string;
+    answer: string;
+    closed?: string;
+    at: string;
+  } | {
+    t: 'refused';
+    message: string;
+    reason: string;
+    at: string;
+  })[];
+}
+interface KeyBody {
+  handle: string;
+  device: string;
+  build: string;
+  signPub: string;
+  sealPub: string;
+  legacy: {
+    throughSeq: number;
+    digest: string;
+  } | null;
+  invite?: {
+    id: string;
+    sig: string;
+  };
+  caps?: string[];
+}
+type RosterBody = {
+  rv: 1;
+} & ({
+  action: 'found';
+  name: string;
+  legacy: LegacyAttestation[];
+  recoveryPub: string;
+} | {
+  action: 'admit';
+  replica: string;
+  handle: string;
+  role: 'member' | 'admin';
+  fingerprint: string;
+  hosts?: string[];
+  observer?: true;
+} | {
+  action: 'revoke';
+  replica: string;
+  afterSeq: number;
+  afterHash: string;
+  reason: string;
+} | {
+  action: 'role';
+  replica: string;
+  role: 'member' | 'admin';
+  afterSeq?: number;
+  afterHash?: string;
+} | {
+  action: 'hosts';
+  replica: string;
+  hosts: string[];
+  afterSeq?: number;
+  afterHash?: string;
+} | {
+  action: 'close-legacy';
+  entries: LegacyAttestation[];
+} | {
+  action: 'license';
+  key: string;
+} | {
+  action: 'invite';
+  id: string;
+  pub: string;
+  handle: string;
+  expires: string;
+} | {
+  action: 'recover';
+  proof: string;
+} | {
+  action: 'recovery-key';
+  pub: string;
+} | {
+  action: 'transport';
+  kind: 'git' | 'relay';
+  url?: string;
+} | {
+  action: 'dismiss';
+  replica: string;
+  seq: number;
+  hash: string;
+});
+interface LegacyAttestation {
+  replica: string;
+  throughSeq: number;
+  digest: string;
+}
+type PresenceBody = {
+  kind: 'replica';
+  build: string;
+  device: string;
+  wall: number;
+} | {
+  kind: 'replica';
+  build: string;
+  device: string;
+  wall: number;
+  caps: string[];
+} | {
+  kind: 'run';
+  run: string;
+  task: string | null;
+  runKind: string;
+  live: boolean;
+  waitingOn?: string;
+} | {
+  kind: 'resolve';
+  run: string;
+  replica: string;
+};
+interface AgentBody {
+  address: Address;
+  displayName: string;
+  client: string;
+  status: 'pending' | 'approved' | 'revoked';
+}
+interface ChannelBody {
+  channel: string;
+  member: Address;
+  joined: boolean;
+}
+interface MemoryBody {
+  memory: string;
+  kind: 'put' | 'remove';
+  fields?: Record<string, unknown>;
+  trust: 'human' | 'confirmed' | 'agent';
+  by?: string;
+}
+interface DocBody {
+  doc: string;
+  kind: 'put' | 'remove';
+  by: Address;
+  revision?: {
+    id: string;
+    parents: string[];
+    title: string;
+    body: string;
+    hash: string;
+    author: Address;
+    cause: RevisionCause;
+    summary: string;
+    createdAt: string;
+    approval?: {
+      by: Address;
+      policy?: {
+        rung: number;
+      };
+    };
+    task?: string;
+  };
+  meta?: {
+    slug?: string;
+    aliases?: string[];
+    title?: string;
+    status?: DocStatus;
+    links?: {
+      target: LinkTarget;
+      rel: LinkRel;
+    }[];
+  };
+  review?: {
+    rev: string;
+  };
+}
+declare function isStub(e: LogEntry): e is OpStub;
+declare function headerOf(e: LogEntry): OpHeader;
+declare function contentHash(content: {
+  body?: JsonValue;
+  sealed?: Sealed;
+}): string;
+declare function opHash(e: LogEntry): string;
+declare function stubOf(op: FederatedOp): OpStub;
+//#endregion
+//#region src/federation/chain.d.ts
+interface ChainHead {
+  seq: number;
+  hash: string;
+  hlc: string;
+}
+declare function buildOp(fields: {
+  replica: string;
+  seq: number;
+  prev: string;
+  hlc: string;
+  type: string;
+  body?: JsonValue;
+  to?: string[];
+  sealed?: Sealed;
+}, signPriv: string): FederatedOp;
+declare function verifyEntry(head: ChainHead | null, e: LogEntry, signPub: string): {
+  ok: true;
+  head: ChainHead;
+} | {
+  ok: false;
+  reason: string;
+};
+//#endregion
+//#region src/federation/encoding.d.ts
+declare function b64u(bytes: Uint8Array): string;
+declare function fromB64u(text: string): Buffer;
+declare function sha256Hex(data: string | Uint8Array): string;
+declare function crockford32(bytes: Uint8Array): string;
+//#endregion
+//#region src/federation/fingerprint.d.ts
+declare function fingerprint(signPub: string, sealPub: string): string;
+//#endregion
+//#region src/federation/hlc.d.ts
+declare const MAX_HLC_COUNTER = 999999999;
+interface ParsedHlc {
+  ms: number;
+  counter: number;
+  replica: string;
+}
+declare function parseOpHlc(hlc: string): ParsedHlc | null;
+declare function compareHlc(a: ParsedHlc, b: ParsedHlc): number;
+declare const MAX_CLOCK_LEAD_MS: number;
+/** Whether a reading's wall time is past the bound for the wall time `nowMs`. */
+declare function aheadOfClock(hlc: string, nowMs: number): boolean;
+declare function hlcWallMs(hlc: string): number | null;
+declare class OpClock {
+  private readonly replica;
+  private readonly now;
+  private ms;
+  private counter;
+  constructor(replica: string, last?: string | null, now?: () => number);
+  /** A reading for a change made now, after every reading seen so far. */
+  tick(): string;
+  /** Moves past a reading from elsewhere, so the next tick sorts after it,
+   *  unless it is past the bound (FW-R21); false when it refused. */
+  observe(remote: string): boolean;
+  /** The latest reading, for persisting across restarts. */
+  get last(): string;
+}
+//#endregion
+//#region src/federation/jcs.d.ts
+declare class CanonicalizeError extends TypeError {
+  name: string;
+}
+declare const MAX_JSON_DEPTH = 256;
+declare function canonicalize(value: unknown): string;
+//#endregion
+//#region src/federation/keys.d.ts
+interface ReplicaKeys {
+  signPriv: string;
+  signPub: string;
+  sealPriv: string;
+  sealPub: string;
+}
+declare function generateReplicaKeys(): ReplicaKeys;
+declare function ed25519FromSeed(seed: Uint8Array): {
+  signPriv: string;
+  signPub: string;
+};
+declare function publicOfPrivate(der: string): string;
+declare function signText(signPriv: string, text: string): string;
+declare function verifyText(signPub: string, text: string, sig: string): boolean;
+//#endregion
+//#region src/federation/seal.d.ts
+declare function sealedAad(replica: string, seq: number, type: string): string;
+declare function sealPayload(input: {
+  replica: string;
+  seq: number;
+  type: 'mail' | 'state' | 'a2a';
+  payload: JsonValue;
+  recipients: ReadonlyMap<string, string>;
+}): {
+  to: string[];
+  sealed: Sealed;
+  key: Buffer;
+};
+declare function canSealTo(sealPub: string): boolean;
+declare function wrapContentKey(key: Buffer, aad: string, recipient: string, sealPub: string): {
+  enc: string;
+  ct: string;
+};
+declare function unwrapContentKey(op: FederatedOp, me: string, sealPriv: string): Buffer | null;
+declare function openWithKey(op: FederatedOp, key: Buffer): JsonValue | null;
+declare function openPayload(op: FederatedOp, me: string, sealPriv: string): JsonValue | null;
+//#endregion
+export { type AgentBody, CanonicalizeError, type ChainHead, type ChannelBody, type DocBody, type FederatedOp, type ForwardPayload, type KeyBody, type LegacyAttestation, type LogEntry, MAX_CLOCK_LEAD_MS, MAX_HLC_COUNTER, MAX_JSON_DEPTH, MAX_OP_BYTES, MAX_SEALED_RECIPIENTS, MAX_STATE_ENTRIES, type MailPayload, type MailTarget, type MemoryBody, OP_TYPES, OpClock, type OpHeader, type OpStub, type OpType, type ParsedHlc, type PresenceBody, REPLICA_ID, type ReplicaKeys, type RosterBody, SEALED_TYPES, STUBBABLE_TYPES, type Sealed, type StatePayload, TAG, ZERO_HASH, aheadOfClock, b64u, buildOp, canSealTo, canonicalize, compareHlc, contentHash, crockford32, ed25519FromSeed, fingerprint, fromB64u, generateReplicaKeys, headerOf, hlcWallMs, isStub, opHash, openPayload, openWithKey, parseOpHlc, publicOfPrivate, sealPayload, sealedAad, sha256Hex, signText, stubOf, unwrapContentKey, verifyEntry, verifyText, wrapContentKey };
+//# sourceMappingURL=index.d.ts.map

package/dist/federation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/federation/ops.ts","../../src/federation/chain.ts","../../src/federation/encoding.ts","../../src/federation/fingerprint.ts","../../src/federation/hlc.ts","../../src/federation/jcs.ts","../../src/federation/keys.ts","../../src/federation/seal.ts"],"sourcesContent":[],"mappings":"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"}