@foruai/shared 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,126 @@
+# @foruai/shared
+
+Shared types, constants, and API path definitions for the ForU Gatekeeper AI ecosystem.
+
+## Installation
+
+```bash
+npm install @foruai/shared
+# or
+pnpm add @foruai/shared
+# or
+bun add @foruai/shared
+```
+
+## Usage
+
+### Types
+
+```typescript
+import type {
+  // Badge verification
+  VerifyBadgeRequest,
+  VerifyBadgeResponse,
+  VerifiedBadge,
+  BadgeInfo,
+  BadgeRuleInfo,
+  OnchainProof,
+  AwardSource,
+  MintingInfo,
+  ChainConfig,
+
+  // Discord
+  DiscordCheckRequest,
+  DiscordCheckResponse,
+  DiscordServerStatus,
+
+  // Profile
+  ProfileRequest,
+  ProfileResponse,
+
+  // Chat
+  ChatRequest,
+  ChatResponse,
+
+  // Auth
+  HmacToken,
+
+  // Discovery
+  HealthResponse,
+  ServicesCatalog,
+  ServiceEntry,
+} from '@foruai/shared'
+```
+
+### Constants
+
+```typescript
+import {
+  API_PATHS,
+  BADGE_STATUS,
+  HMAC_MAX_AGE_MS,
+  VALIDATOR_CATEGORIES,
+  VALIDATOR_LABELS,
+} from '@foruai/shared'
+
+// API endpoint paths
+console.log(API_PATHS.VERIFY_BADGE) // '/v1/verify-badge'
+console.log(API_PATHS.CHAT)         // '/v1/chat'
+console.log(API_PATHS.DISCORD)      // '/v1/discord'
+console.log(API_PATHS.PROFILE)      // '/v1/profile'
+console.log(API_PATHS.BADGES)       // '/v1/badges'
+console.log(API_PATHS.HEALTH)       // '/v1/health'
+console.log(API_PATHS.SERVICES)     // '/v1/services'
+
+// Badge statuses
+console.log(BADGE_STATUS.VERIFIED)     // 'verified'
+console.log(BADGE_STATUS.NOT_VERIFIED) // 'not_verified'
+console.log(BADGE_STATUS.NOT_FOUND)    // 'not_found'
+```
+
+### Type Reference
+
+#### Badge Verification
+
+| Type | Description |
+|------|-------------|
+| `VerifyBadgeRequest` | Request body for badge verification. Identify user by `user_address`, `username`, or `discord_username`. Optionally filter by `badge_id`. |
+| `VerifyBadgeResponse` | Response containing `badges[]` with confidence scores, rules breakdown, on-chain proofs, and attribution. |
+| `VerifiedBadge` | Individual badge with `status`, `confidence` (0-1), `badge_type`, `rules_breakdown`, `rules[]`, `awarded_via`, `minting`, `onchain_proof`, `chains[]`, `exp_earned`. |
+| `BadgeRuleInfo` | Single rule: `validator_key`, `validator_label`, `operator`, `value`, `params_schema` (may include chain/contract info). |
+| `OnchainProof` | On-chain verification: `contract_address`, `chain_id`, `wallet_address`, `balance`, `verified_onchain`. |
+| `AwardSource` | Attribution: `source_type` (campaign/quest), campaign/quest names, community, rank, rep score. |
+| `MintingInfo` | NFT minting status: `is_minted`, `mint_hash`, `chain_name`, `token_id`, `minting_cost`. |
+| `BadgeInfo` | Badge catalog entry: `id`, `name`, `description`, `image`, `shape`, `source`. |
+
+#### Discord
+
+| Type | Description |
+|------|-------------|
+| `DiscordCheckRequest` | Identify user + optional `server_id` filter. |
+| `DiscordCheckResponse` | `linked` status, `discord_username`, `servers[]` with membership details. |
+| `DiscordServerStatus` | Per-server: `is_member`, `joined_at`, `nickname`, `roles[]`. |
+
+#### Profile
+
+| Type | Description |
+|------|-------------|
+| `ProfileRequest` | Identify user by any linked account. |
+| `ProfileResponse` | `wallets[]`, `twitter`, `discord`, `badges` (total + minted counts). |
+
+#### Chat & Auth
+
+| Type | Description |
+|------|-------------|
+| `ChatRequest` | `message` + optional `sessionId` for conversation continuity. |
+| `ChatResponse` | `reply`, `sessionId`, optional `routed` (which intent was matched). |
+| `HmacToken` | `nonce`, `timestamp`, `signature` for HMAC-SHA256 authentication. |
+
+## Companion Packages
+
+- [`@foruai/gatekeeper-server`](https://www.npmjs.com/package/@foruai/gatekeeper-server) — Server-side HMAC token signing
+- [`@foruai/gatekeeper-client`](https://www.npmjs.com/package/@foruai/gatekeeper-client) — Full API client for browser & Node.js
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -4,10 +4,21 @@ export declare const BADGE_STATUS: {
     readonly NOT_FOUND: "not_found";
 };
 export declare const API_PATHS: {
-    readonly VERIFY: "/v1/verify";
-    readonly BADGES: "/v1/badges";
     readonly HEALTH: "/v1/health";
+    readonly BADGES: "/v1/badges";
+    readonly VERIFY: "/v1/verify";
+    readonly VERIFY_BADGE: "/v1/verify-badge";
     readonly CHAT: "/v1/chat";
+    readonly DISCORD: "/v1/discord";
+    readonly PROFILE: "/v1/profile";
+    readonly SERVICES: "/v1/services";
 };
 export declare const HMAC_MAX_AGE_MS: number;
+export declare const NONCE_PRUNE_INTERVAL_MS: number;
+export declare const SESSION_TTL_MS: number;
+export declare const MAX_CHAT_HISTORY = 20;
+export declare const AGENT_TIMEOUT_MS = 120000;
+export declare const VALIDATOR_CATEGORIES: Record<string, string[]>;
+export declare const VALIDATOR_LABELS: Record<string, string>;
+export declare const RPC_URLS: Record<number, string>;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;CAIf,CAAA;AAEV,eAAO,MAAM,SAAS;;;;;CAKZ,CAAA;AAEV,eAAO,MAAM,eAAe,QAAgB,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;CAIf,CAAA;AAEV,eAAO,MAAM,SAAS;;;;;;;;;CASZ,CAAA;AAEV,eAAO,MAAM,eAAe,QAAgB,CAAA;AAC5C,eAAO,MAAM,uBAAuB,QAAiB,CAAA;AACrD,eAAO,MAAM,cAAc,QAAiB,CAAA;AAC5C,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,eAAO,MAAM,gBAAgB,SAAU,CAAA;AAEvC,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAoBzD,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+BnD,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG3C,CAAA"}

package/dist/index.js

@@ -6,14 +6,102 @@ var BADGE_STATUS = {
   NOT_FOUND: "not_found"
 };
 var API_PATHS = {
-  VERIFY: "/v1/verify",
-  BADGES: "/v1/badges",
   HEALTH: "/v1/health",
-  CHAT: "/v1/chat"
+  BADGES: "/v1/badges",
+  VERIFY: "/v1/verify",
+  VERIFY_BADGE: "/v1/verify-badge",
+  CHAT: "/v1/chat",
+  DISCORD: "/v1/discord",
+  PROFILE: "/v1/profile",
+  SERVICES: "/v1/services"
 };
 var HMAC_MAX_AGE_MS = 5 * 60 * 1000;
+var NONCE_PRUNE_INTERVAL_MS = 10 * 60 * 1000;
+var SESSION_TTL_MS = 30 * 60 * 1000;
+var MAX_CHAT_HISTORY = 20;
+var AGENT_TIMEOUT_MS = 120000;
+var VALIDATOR_CATEGORIES = {
+  onchain: [
+    "nft_holder_validator",
+    "evm_balance_validator",
+    "evm_transaction_count",
+    "evm_wallet_age",
+    "evm_token_holder_count",
+    "multi_nft_holder",
+    "nft_holder_count_validator",
+    "onchain_community_membership",
+    "badge_minted_count",
+    "lilstar_nft_testnet_snapshot_holder_validator"
+  ],
+  social: [
+    "follower_count_twitter",
+    "reply_count_twitter",
+    "twitter_age",
+    "twitter_relationship",
+    "connected_twitter",
+    "discord_role",
+    "discord_age"
+  ],
+  ai: ["required_persona", "fused_ai_did"],
+  platform: [
+    "user",
+    "required_badge",
+    "daily_checkin_streak",
+    "foru_miniapp_explorer",
+    "foru_ai_agent_early_bird"
+  ],
+  campaign: [
+    "somnia_7d_leaderboard_kaito_yapper",
+    "somnia_yapstorm_core",
+    "somnia_yapstorm_yapper",
+    "airdrop_og"
+  ]
+};
+var VALIDATOR_LABELS = {
+  user: "Registered user account",
+  empty_rule: "Auto-awarded (no specific requirement)",
+  nft_holder_validator: "Must hold NFT on-chain",
+  discord_role: "Must have a specific Discord role",
+  fused_ai_did: "Must have a Fused AI DID",
+  minimum_achieved_loyalty_daily_checkin_leaderboard: "Daily check-in leaderboard rank",
+  required_persona: "Must have a specific persona",
+  daily_checkin_streak: "Daily check-in streak count",
+  follower_count_twitter: "Minimum Twitter/X follower count",
+  discord_age: "Discord account age requirement",
+  evm_balance_validator: "Minimum EVM wallet balance",
+  twitter_age: "Twitter/X account age requirement",
+  twitter_relationship: "Twitter/X relationship (following/followed)",
+  evm_transaction_count: "Minimum EVM transaction count",
+  evm_wallet_age: "EVM wallet age requirement",
+  foru_miniapp_explorer: "ForU mini-app explorer activity",
+  lilstar_nft_testnet_snapshot_holder_validator: "LilStar NFT testnet snapshot holder",
+  onchain_community_membership: "On-chain community membership",
+  required_badge: "Must hold a prerequisite badge",
+  airdrop_og: "Original airdrop participant",
+  badge_minted_count: "Number of badges minted",
+  connected_twitter: "Must have connected Twitter/X account",
+  evm_token_holder_count: "EVM token holder count",
+  foru_ai_agent_early_bird: "ForU AI Agent early bird",
+  multi_nft_holder: "Must hold multiple NFTs",
+  nft_holder_count_validator: "NFT holder count threshold",
+  reply_count_twitter: "Twitter/X reply count",
+  somnia_7d_leaderboard_kaito_yapper: "Somnia 7-day Kaito Yapper leaderboard",
+  somnia_yapstorm_core: "Somnia YapStorm core participant",
+  somnia_yapstorm_yapper: "Somnia YapStorm yapper"
+};
+var RPC_URLS = {
+  56: process.env.BSC_RPC_URL || "https://bsc-dataseed.bnbchain.org",
+  5031: "https://dream-rpc.somnia.network"
+};
 export {
+  VALIDATOR_LABELS,
+  VALIDATOR_CATEGORIES,
+  SESSION_TTL_MS,
+  RPC_URLS,
+  NONCE_PRUNE_INTERVAL_MS,
+  MAX_CHAT_HISTORY,
   HMAC_MAX_AGE_MS,
   BADGE_STATUS,
-  API_PATHS
+  API_PATHS,
+  AGENT_TIMEOUT_MS
 };

package/dist/types.d.ts

@@ -111,5 +111,120 @@ export interface ChatRequest {
 export interface ChatResponse {
     reply: string;
     sessionId: string;
+    routed?: string;
+}
+export interface VerifyBadgeRequest {
+    user_address?: string;
+    username?: string;
+    discord_username?: string;
+    badge_id?: number;
+}
+export interface VerifyBadgeResponse {
+    user_address: string;
+    total_badges: number;
+    badges: VerifiedBadge[];
+    verified_at: string;
+}
+export interface VerifiedBadge {
+    badge_id: number;
+    name: string | null;
+    description: string | null;
+    image: string | null;
+    status: string;
+    badge_type: 'rule_based' | 'campaign_reward' | 'admin_grant' | 'auto_awarded';
+    confidence: number;
+    unlocked_at?: string;
+    rules_breakdown: {
+        total: number;
+        by_category: Record<string, number>;
+    };
+    rules: BadgeRuleInfo[];
+    awarded_via?: AwardSource;
+    minting?: MintingInfo;
+    onchain_proof?: OnchainProof;
+    chains?: ChainConfig[];
+    exp_earned?: string;
+    identifi_reward?: string;
+}
+export interface ChainConfig {
+    chain_id: number;
+    chain_name: string | null;
+    contract_address: string;
+}
+export interface DiscordCheckRequest {
+    user_address?: string;
+    username?: string;
+    discord_username?: string;
+    server_id?: string;
+}
+export interface DiscordCheckResponse {
+    linked: boolean;
+    discord_username: string | null;
+    discord_id?: string;
+    servers: DiscordServerStatus[];
+    checked_at: string;
+}
+export interface DiscordServerStatus {
+    server_id: string;
+    server_name: string | null;
+    is_member: boolean;
+    joined_at?: string | null;
+    nickname?: string | null;
+    roles?: string[];
+}
+export interface ProfileRequest {
+    user_address?: string;
+    username?: string;
+    discord_username?: string;
+}
+export interface ProfileResponse {
+    wallets: {
+        address: string;
+        is_primary: boolean;
+    }[];
+    twitter: {
+        username: string | null;
+        linked: boolean;
+    };
+    discord: {
+        username: string | null;
+        discord_id?: string;
+        linked: boolean;
+    };
+    badges: {
+        total: number;
+        minted: number;
+    };
+    resolved_at: string;
+}
+export interface ServicesCatalog {
+    name: string;
+    version: string;
+    description: string;
+    services: ServiceEntry[];
+    authentication: {
+        schemes: string[];
+        hmac_format: string;
+        bearer_format: string;
+    };
+    erc8004: {
+        status: string;
+        registry: string;
+    };
+}
+export interface ServiceEntry {
+    id: string;
+    name: string;
+    description: string;
+    endpoint: string;
+    input?: Record<string, string>;
+    output?: string;
+    pricing?: {
+        amount: string;
+        asset?: string;
+        network?: string;
+        note?: string;
+    };
+    status?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,24 @@
 {
   "name": "@foruai/shared",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "description": "Shared types, constants, and API path definitions for the ForU Gatekeeper AI ecosystem",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": ["dist", "README.md"],
   "scripts": {
     "build": "bun build src/index.ts --outdir dist --target bun && tsc --emitDeclarationOnly"
   },
+  "keywords": ["foruai", "gatekeeper", "badges", "web3", "erc-8004", "types"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/untukmuai/foru-gatekeeper-ai",
+    "directory": "packages/shared"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "devDependencies": {
     "bun-types": "latest",
     "typescript": "^5.7.0"

package/src/constants.ts

@@ -1,14 +0,0 @@
-export const BADGE_STATUS = {
-  VERIFIED: 'verified',
-  NOT_VERIFIED: 'not_verified',
-  NOT_FOUND: 'not_found',
-} as const
-
-export const API_PATHS = {
-  VERIFY: '/v1/verify',
-  BADGES: '/v1/badges',
-  HEALTH: '/v1/health',
-  CHAT: '/v1/chat',
-} as const
-
-export const HMAC_MAX_AGE_MS = 5 * 60 * 1000 // 5 minutes

package/src/index.ts

@@ -1,2 +0,0 @@
-export * from './types'
-export * from './constants'

package/src/types.ts

@@ -1,130 +0,0 @@
-export interface VerificationRequest {
-  identity: {
-    wallet_address?: string
-    x_username?: string
-  }
-  badge_ids?: number[]
-  discord_server_id?: string
-}
-
-export interface VerificationResponse {
-  identity: {
-    resolved_user_id: number | null
-    wallet_address?: string
-    x_username?: string
-  }
-  badges: BadgeResult[]
-  discord?: DiscordResult
-  verified_at: string
-}
-
-export interface BadgeResult {
-  badge_id: number
-  name?: string
-  description?: string
-  status: BadgeStatus
-  image?: string
-  rarity?: string
-  unlocked_at?: string
-  reason?: BadgeReason
-  onchain_proof?: OnchainProof
-}
-
-export interface OnchainProof {
-  contract_address: string
-  chain_id: number
-  rpc_url: string
-  nft_erc_type: string
-  wallet_address: string
-  balance: string
-  proof_method: string
-  verified_onchain: boolean
-}
-
-export interface BadgeReason {
-  rules: BadgeRuleInfo[]
-  awarded_via?: AwardSource
-  minting?: MintingInfo
-  exp_earned?: string
-  identifi_reward?: string
-  metadata?: Record<string, unknown>
-}
-
-export interface BadgeRuleInfo {
-  validator_key: string
-  validator_label: string
-  operator: string
-  value: unknown
-  value_type: string
-  params_schema?: {
-    rpc_url?: string
-    chain_id?: number
-    contract_address?: string
-    nft_erc_type?: string
-    [key: string]: unknown
-  }
-}
-
-export interface AwardSource {
-  source_type: 'campaign' | 'quest_campaign'
-  campaign_id?: number
-  campaign_name?: string
-  quest_campaign_id?: number
-  quest_name?: string
-  community_name?: string
-  user_rank?: number
-  user_rep_score?: string
-  claimed_at?: string
-}
-
-export interface MintingInfo {
-  is_minted: boolean
-  mint_hash?: string
-  chain_name?: string
-  chain_id?: number
-  contract_address?: string
-  token_id?: string
-  minting_cost?: string
-  minting_cost_asset?: string
-}
-
-export interface DiscordResult {
-  server_id: string
-  is_member: boolean
-  discord_username?: string
-}
-
-export type BadgeStatus = 'verified' | 'not_verified' | 'not_found'
-
-export interface BadgeInfo {
-  id: number
-  name: string
-  description: string | null
-  image: string | null
-  shape: string | null
-  source: string | null
-}
-
-export interface HealthResponse {
-  status: 'ok' | 'error'
-  db: 'connected' | 'disconnected'
-  timestamp: string
-}
-
-// HMAC auth types
-
-export interface HmacToken {
-  nonce: string
-  timestamp: number
-  signature: string
-}
-
-export interface ChatRequest {
-  message: string
-  sessionId?: string
-}
-
-export interface ChatResponse {
-  reply: string
-  sessionId: string
-}

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src"]
-}