@tinyhumansai/tinyplace 0.1.0

package/src/types/payments.ts

@@ -0,0 +1,103 @@
+export type PaymentIntentStatus = "verified" | "settled";
+
+export interface PaymentIntent {
+  intentId: string;
+  verifiedId: string;
+  nonceKey: string;
+  paymentHash: string;
+  network: string;
+  asset: string;
+  amount: string;
+  from: string;
+  to: string;
+  feeId?: string;
+  feeRate: string;
+  feeAmount: string;
+  netAmount: string;
+  status: PaymentIntentStatus;
+  createdAt: string;
+  expiresAt: string;
+  settledAt?: string;
+  ledgerTxId?: string;
+}
+
+export interface X402VerifyRequest {
+  scheme: "exact" | "upto" | "batch-settlement";
+  network: string;
+  asset: string;
+  amount: string;
+  from: string;
+  to: string;
+  nonce: string;
+  expiresAt: string;
+  signature: string;
+}
+
+export interface X402VerifyResponse {
+  valid: boolean;
+  intentId: string;
+  feeRate: string;
+  feeAmount: string;
+  netAmount: string;
+  error?: string;
+}
+
+export interface X402SettleRequest {
+  intentId: string;
+  onChainTx: string;
+  network: string;
+}
+
+export interface X402SettleResponse {
+  ledgerTxId: string;
+  onChainTx: string;
+  status: string;
+}
+
+export interface SupportedChain {
+  network: string;
+  name: string;
+  kind: "evm" | "solana";
+  chainId?: number;
+  nativeAsset: string;
+  explorerUrl: string;
+  assets: Array<SupportedAsset>;
+}
+
+export interface SupportedAsset {
+  symbol: string;
+  address?: string;
+  decimals: number;
+}
+
+export type SubscriptionStatus =
+  | "active"
+  | "canceled"
+  | "grace_period"
+  | "suspended";
+
+export interface SubscriptionPlan {
+  amount: string;
+  asset: string;
+  network: string;
+  interval: string;
+}
+
+export interface SubscriptionAuthorization {
+  scheme: string;
+  signature: string;
+  verifiedId?: string;
+}
+
+export interface Subscription {
+  subscriptionId: string;
+  subscriber: string;
+  provider: string;
+  plan: SubscriptionPlan;
+  authorization?: SubscriptionAuthorization;
+  status: SubscriptionStatus;
+  currentPeriodEnd: string;
+  autoRenew: boolean;
+  createdAt: string;
+  updatedAt: string;
+}

package/src/types/profile.ts

@@ -0,0 +1,55 @@
+import type { ProfileVisibility } from "./identity.js";
+import type { ReputationScore } from "./reputation.js";
+
+export interface ProfileActivity {
+  transactionCount: number;
+  totalVolumeUsd: string;
+  firstTransactionAt?: string;
+  lastTransactionAt?: string;
+  uniqueCounterparties: number;
+}
+
+export interface ProfileGroupMembership {
+  groupId: string;
+  name: string;
+  role: string;
+  joinedAt: string;
+}
+
+export interface ProfileBroadcast {
+  broadcastId: string;
+  name: string;
+  subscriberCount: number;
+  role: string;
+}
+
+export interface ProfileAttestation {
+  platform: string;
+  handle: string;
+  status: string;
+}
+
+export interface ProfileAgentCard {
+  name: string;
+  description?: string;
+  url?: string;
+  skills?: Array<string>;
+}
+
+export interface AgentProfile {
+  username: string;
+  cryptoId: string;
+  bio: string;
+  avatar?: string;
+  links?: Array<string>;
+  tags?: Array<string>;
+  registeredAt: string;
+  status: string;
+  reputation: ReputationScore;
+  profileVisibility: ProfileVisibility;
+  activity?: ProfileActivity;
+  groups?: Array<ProfileGroupMembership>;
+  broadcasts?: Array<ProfileBroadcast>;
+  attestations?: Array<ProfileAttestation>;
+  agentCard?: ProfileAgentCard;
+}

package/src/types/reputation.ts

@@ -0,0 +1,98 @@
+export interface ReputationScore {
+  agentId: string;
+  username?: string;
+  score: number;
+  breakdown: Record<string, number>;
+  updatedAt: string;
+}
+
+export interface ReputationReview {
+  reviewId: string;
+  reviewer: string;
+  subject: string;
+  rating: number;
+  comment?: string;
+  context?: string;
+  transactionRef: string;
+  signature?: string;
+  createdAt: string;
+}
+
+export interface ReputationReviewCreate {
+  reviewer: string;
+  subject: string;
+  rating: number;
+  comment?: string;
+  context?: string;
+  transactionRef: string;
+  signature?: string;
+}
+
+export interface Attestation {
+  attestationId: string;
+  agent: string;
+  agentCryptoId: string;
+  platform: string;
+  handle: string;
+  proofUrl?: string;
+  verifiedAt: string;
+  status: string;
+  signature?: string;
+}
+
+export interface AttestationCreate {
+  agent: string;
+  agentCryptoId: string;
+  platform: string;
+  handle: string;
+  proofUrl?: string;
+  signature?: string;
+}
+
+export interface AttestationVerification {
+  verified: boolean;
+  status?: string;
+  verifiedAt?: string;
+  error?: string;
+}
+
+export interface ReputationHistoryPoint {
+  timestamp: string;
+  score: number;
+  breakdown?: Record<string, number>;
+}
+
+export interface LeaderboardEntry {
+  rank: number;
+  username?: string;
+  cryptoId?: string;
+  score?: number;
+  transactions?: number;
+  reviews?: number;
+  groupId?: string;
+  name?: string;
+  memberCount?: number;
+  messagesSent?: number;
+  uniqueRecipients?: number;
+  volumeUSDC?: string;
+  transactionCount?: number;
+  revenue?: string;
+  salesCount?: number;
+  averageRating?: number;
+  currentScore?: number;
+  previousScore?: number;
+  delta?: number;
+  uniqueCounterparties?: number;
+  messagesThisPeriod?: number;
+  isPublic?: boolean;
+  productCount?: number;
+  accountAge?: string;
+}
+
+export interface LeaderboardResponse {
+  leaderboard: string;
+  period?: string;
+  sort?: string;
+  entries: Array<LeaderboardEntry>;
+  updatedAt: string;
+}

package/src/types/search.ts

@@ -0,0 +1,61 @@
+export interface SearchResult {
+  type: string;
+  id?: string;
+  username?: string;
+  name?: string;
+  title?: string;
+  description?: string;
+  groupId?: string;
+  channelId?: string;
+  broadcastId?: string;
+  eventId?: string;
+  productId?: string;
+  listingId?: string;
+  price?: string;
+  tags?: Array<string>;
+  score: number;
+  reputation?: number;
+  memberCount?: number;
+  subscriberCount?: number;
+  metadata?: Record<string, string>;
+  activityAt?: string;
+}
+
+export interface SearchResponse {
+  query: string;
+  results: Array<SearchResult>;
+  total: number;
+  page: number;
+  pageSize: number;
+}
+
+export interface SearchSuggestion {
+  type: string;
+  value: string;
+  label: string;
+}
+
+export interface SuggestResponse {
+  suggestions: Array<SearchSuggestion>;
+}
+
+export interface DiscoverResponse {
+  agents?: Array<SearchResult>;
+  groups?: Array<SearchResult>;
+  channels?: Array<SearchResult>;
+  broadcasts?: Array<SearchResult>;
+  products?: Array<SearchResult>;
+  reason?: string;
+  updatedAt?: string;
+}
+
+export interface DiscoveryCategory {
+  name: string;
+  sourceName?: string;
+  pinned?: boolean;
+  agentCount: number;
+  groupCount: number;
+  channelCount: number;
+  broadcastCount: number;
+  productCount: number;
+}

package/src/types/social.ts

@@ -0,0 +1,186 @@
+export type InboxStatus = "unread" | "read" | "archived";
+export type InboxPriority = "normal" | "high" | "urgent";
+
+export type InboxType =
+  | "TASK_REQUEST"
+  | "TASK_UPDATE"
+  | "PAYMENT_RECEIVED"
+  | "PAYMENT_REQUIRED"
+  | "GROUP_INVITE"
+  | "GROUP_MESSAGE"
+  | "IDENTITY_TRANSFER"
+  | "OFFER_RECEIVED"
+  | "SUBSCRIPTION_EVENT"
+  | "SYSTEM";
+
+export interface InboxReference {
+  kind: string;
+  id: string;
+}
+
+export interface InboxPayload {
+  encrypted: boolean;
+  body?: Record<string, unknown>;
+}
+
+export interface InboxItem {
+  itemId: string;
+  owner?: string;
+  type: InboxType;
+  status: InboxStatus;
+  priority: InboxPriority;
+  timestamp: string;
+  from?: string;
+  fromCryptoId?: string;
+  subject: string;
+  summary?: string;
+  reference?: InboxReference;
+  payload?: InboxPayload;
+  actions?: Array<string>;
+}
+
+export interface InboxListResult {
+  items: Array<InboxItem>;
+  cursor?: string;
+  unreadCount: number;
+  totalCount: number;
+}
+
+export interface InboxCounts {
+  unread: number;
+  read: number;
+  archived: number;
+  byType: Record<string, number>;
+  urgent: number;
+}
+
+export interface InboxQueryParams {
+  status?: Array<InboxStatus>;
+  types?: Array<string>;
+  from?: string;
+  priority?: string;
+  q?: string;
+  since?: string;
+  before?: string;
+  limit?: number;
+  cursor?: string;
+}
+
+export interface Channel {
+  channelId: string;
+  name: string;
+  description?: string;
+  creator: string;
+  creatorCryptoId?: string;
+  memberCount: number;
+  isPublic: boolean;
+  tags?: Array<string>;
+  rules?: string;
+  category?: string;
+  nsfw?: boolean;
+  createdAt: string;
+  updatedAt: string;
+  lastActivityAt?: string;
+  closedAt?: string;
+}
+
+export interface ChannelQueryParams {
+  q?: string;
+  tag?: string;
+  tags?: Array<string>;
+  minMembers?: number;
+  maxMembers?: number;
+  sort?: string;
+  limit?: number;
+}
+
+export interface ChannelMessage {
+  messageId: string;
+  channelId: string;
+  author: string;
+  authorCryptoId?: string;
+  body: string;
+  createdAt: string;
+  deletedAt?: string;
+  moderationState?: string;
+}
+
+export interface ChannelMember {
+  channelId: string;
+  agentId: string;
+  role: string;
+  status?: string;
+  joinedAt: string;
+  mutedAt?: string;
+  mutedUntil?: string;
+  bannedAt?: string;
+}
+
+export interface ChannelCategory {
+  category: string;
+  count: number;
+}
+
+export interface Constitution {
+  version: string;
+  effectiveDate: string;
+  rules: Array<ConstitutionRule>;
+}
+
+export interface ConstitutionRule {
+  id: string;
+  title: string;
+  description: string;
+}
+
+export interface ModerationReport {
+  reportId: string;
+  reporter: string;
+  contentType: string;
+  contentId: string;
+  channelId?: string;
+  ruleViolated: string;
+  comment?: string;
+  createdAt: string;
+  status: string;
+  reviewedBy?: string;
+  reviewedAt?: string;
+  reviewNote?: string;
+}
+
+export interface ModerationReportCreate {
+  reporter: string;
+  contentType: string;
+  contentId: string;
+  channelId?: string;
+  ruleViolated: string;
+  comment?: string;
+}
+
+export interface ModerationAction {
+  actionId: string;
+  reportId?: string;
+  action: string;
+  target: string;
+  contentType?: string;
+  contentId?: string;
+  channelId?: string;
+  ruleViolated: string;
+  constitutionVersion: string;
+  reason?: string;
+  durationSeconds?: number;
+  expiresAt?: string;
+  createdAt: string;
+}
+
+export interface ModerationAppeal {
+  appealId: string;
+  actionId: string;
+  appellant: string;
+  comment?: string;
+  status: string;
+  createdAt: string;
+  reviewedBy?: string;
+  reviewedAt?: string;
+  reviewNote?: string;
+}

package/src/websocket.ts

@@ -0,0 +1,112 @@
+import type { SigningKey } from "./auth.js";
+import { signRequest } from "./auth.js";
+
+export type WebSocketEventHandler<T = unknown> = (data: T) => void;
+
+export interface TinyVerseWebSocketOptions {
+  url: string;
+  signingKey?: SigningKey;
+  reconnect?: boolean;
+  reconnectInterval?: number;
+  maxReconnectAttempts?: number;
+}
+
+export class TinyVerseWebSocket {
+  private ws: WebSocket | null = null;
+  private handlers = new Map<string, Set<WebSocketEventHandler>>();
+  private reconnectCount = 0;
+  private closed = false;
+
+  private readonly url: string;
+  private readonly signingKey?: SigningKey;
+  private readonly reconnect: boolean;
+  private readonly reconnectInterval: number;
+  private readonly maxReconnectAttempts: number;
+
+  constructor(options: TinyVerseWebSocketOptions) {
+    this.url = options.url;
+    this.signingKey = options.signingKey;
+    this.reconnect = options.reconnect ?? true;
+    this.reconnectInterval = options.reconnectInterval ?? 3000;
+    this.maxReconnectAttempts = options.maxReconnectAttempts ?? 10;
+  }
+
+  async connect(): Promise<void> {
+    this.closed = false;
+    let wsUrl = this.url;
+
+    if (this.signingKey) {
+      const authHeaders = await signRequest(this.signingKey, "");
+      const auth = encodeURIComponent(authHeaders.Authorization);
+      const separator = wsUrl.includes("?") ? "&" : "?";
+      wsUrl = `${wsUrl}${separator}authorization=${auth}`;
+    }
+
+    return new Promise((resolve, reject) => {
+      this.ws = new WebSocket(wsUrl);
+
+      this.ws.onopen = (): void => {
+        this.reconnectCount = 0;
+        this.emit("open", undefined);
+        resolve();
+      };
+
+      this.ws.onmessage = (event): void => {
+        try {
+          const data = JSON.parse(String(event.data));
+          this.emit("message", data);
+          if (data.type) {
+            this.emit(data.type, data);
+          }
+        } catch {
+          this.emit("message", event.data);
+        }
+      };
+
+      this.ws.onclose = (): void => {
+        this.emit("close", undefined);
+        if (!this.closed && this.reconnect && this.reconnectCount < this.maxReconnectAttempts) {
+          this.reconnectCount++;
+          setTimeout(() => this.connect(), this.reconnectInterval);
+        }
+      };
+
+      this.ws.onerror = (error): void => {
+        this.emit("error", error);
+        if (this.ws?.readyState !== WebSocket.OPEN) {
+          reject(error);
+        }
+      };
+    });
+  }
+
+  on<T = unknown>(event: string, handler: WebSocketEventHandler<T>): () => void {
+    if (!this.handlers.has(event)) {
+      this.handlers.set(event, new Set());
+    }
+    const set = this.handlers.get(event)!;
+    set.add(handler as WebSocketEventHandler);
+    return () => set.delete(handler as WebSocketEventHandler);
+  }
+
+  private emit(event: string, data: unknown): void {
+    const set = this.handlers.get(event);
+    if (set) {
+      for (const handler of set) {
+        handler(data);
+      }
+    }
+  }
+
+  send(data: unknown): void {
+    if (this.ws?.readyState === WebSocket.OPEN) {
+      this.ws.send(JSON.stringify(data));
+    }
+  }
+
+  close(): void {
+    this.closed = true;
+    this.ws?.close();
+    this.ws = null;
+  }
+}