gigabuddy 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gigabuddy",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Command-line sign-in for Gigabuddy. Authenticates your machine and configures npm for @gigabuddy packages.",
   "type": "module",
   "license": "MIT",

package/src/lib/trust.d.ts

@@ -0,0 +1,61 @@
+/** One vouched sender. `placeId` scopes the vouch to wakes from that room. */
+export interface TrustedSender {
+    id: string;
+    name?: string;
+    placeId?: string;
+    placeName?: string;
+    addedAt?: string;
+}
+/** The slice of channel-policy.json this command owns. Other keys pass through untouched. */
+export interface ChannelPolicy {
+    trustedSenders?: Array<TrustedSender | string>;
+    [key: string]: unknown;
+}
+export interface RosterMember {
+    actorId: string;
+    actorType?: string;
+    displayName?: string;
+}
+export interface Room {
+    id: string;
+    name: string;
+    members: RosterMember[];
+}
+/** Everything that touches the network or the clock — injected so the command is testable offline. */
+export interface TrustDeps {
+    /** GET `url` with the human's bearer, parsed as JSON. */
+    fetchJson: (url: string) => Promise<unknown>;
+    now?: () => Date;
+    say?: (line?: string) => void;
+}
+export interface TrustOptions {
+    /** Room name or `place:` id to resolve in. Defaults to the repo's pinned room. */
+    in?: string;
+    account?: string;
+    staging?: boolean;
+    cwd?: string;
+}
+export declare function policyPath(repoRoot: string): string;
+export declare function readPolicy(repoRoot: string): ChannelPolicy;
+export declare function writePolicy(repoRoot: string, policy: ChannelPolicy): void;
+/** Normalise the legacy bare-string form to entries. */
+export declare function trustedSendersOf(policy: ChannelPolicy): TrustedSender[];
+/**
+ * Pick the room: a `place:` id matches by id, anything else by exact
+ * (case-insensitive) name. Ambiguity is an error that lists the candidates —
+ * never a guess.
+ */
+export declare function resolveRoom(rooms: Room[], query: string): Room;
+/**
+ * Pick the member: a prefixed id (`user:` / `agent:` / `buddy:` …) matches by
+ * id, anything else by exact (case-insensitive) display name. Same rule: two
+ * members with one name is an error listing both ids, not a pick.
+ */
+export declare function resolveMember(room: Room, query: string): RosterMember;
+/** Bearer-authenticated JSON GET on the human credential. */
+export declare function defaultDeps(options: TrustOptions): TrustDeps & {
+    apiUrl: string;
+};
+export declare function trustCommand(sub: string | undefined, target: string | undefined, options?: TrustOptions, deps?: TrustDeps & {
+    apiUrl?: string;
+}): Promise<void>;