stellarid-sdk 1.0.0

package/README.md

@@ -0,0 +1,158 @@
+# StellarID JavaScript SDK
+
+The official JavaScript/TypeScript SDK for **StellarID** — the protocol-grade identity and reputation layer on Stellar.
+
+Easily integrate user credential verification, reputation score lookups, on-chain credential issuance, and embeddable trust badges into your Web3 applications.
+
+---
+
+## Installation
+
+Install the package via npm, yarn, or pnpm:
+
+```bash
+npm install stellarid-sdk
+# or
+yarn add stellarid-sdk
+# or
+pnpm add stellarid-sdk
+```
+
+---
+
+## Quick Start
+
+### 1. Initialize the Client
+
+Obtain your Developer API Key from the StellarID Dashboard and instantiate the client:
+
+```typescript
+import { StellarID } from 'stellarid-sdk';
+
+const stellarId = new StellarID({
+  apiKey: 'your-developer-api-key',
+  // Optional: Custom base URL (e.g. for local testing)
+  // baseURL: 'http://localhost:5555/api/v1' 
+});
+```
+
+### 2. Verify a User's Reputation Score & Credentials
+
+Retrieve verified credentials and computed reputation levels for any Stellar wallet address:
+
+```typescript
+async function checkUserReputation(walletAddress: string) {
+  try {
+    const profile = await stellarId.verifyWallet(walletAddress);
+    
+    console.log(`Score: ${profile.reputation_score}`);
+    console.log(`Tier: ${profile.tier}`);
+    console.log(`Is Verified: ${profile.verified}`);
+    
+    // List user credentials
+    profile.credentials.forEach(cred => {
+      console.log(`- ${cred.name} (${cred.status}) issued by ${cred.issuer_name}`);
+    });
+  } catch (error) {
+    console.error('Verification failed:', error.message);
+  }
+}
+
+checkUserReputation('GA2C7...55');
+```
+
+### 3. Generate and Embed a Trust Badge
+
+Retrieve the ready-to-use `iframe` HTML code to render a gorgeous, glassmorphic trust badge on your website:
+
+```typescript
+async function renderUserBadge(walletAddress: string) {
+  const badge = await stellarId.getBadge({
+    walletAddress,
+    style: 'dark', // 'light' | 'dark'
+    size: 'md',     // 'sm' | 'md' | 'lg'
+  });
+
+  console.log('Insert this HTML to display the badge:');
+  console.log(badge.html);
+  
+  // Or get the direct URL to use as you wish:
+  console.log('Iframe URL:', badge.iframe_url);
+}
+```
+
+### 4. Issue a New Credential
+
+Programmatically issue credentials to builders. This inserts a pending credential and emails the recipient a secure link to claim it:
+
+```typescript
+async function sendDeveloperCredential(recipientEmail: string, walletAddress?: string) {
+  const result = await stellarId.issueCredential({
+    recipientEmail,
+    recipientWallet: walletAddress, // Optional
+    credential: {
+      name: 'github_developer',
+      description: 'Verified GitHub Contributor',
+      metadata: {
+        repositoriesContributionCount: 15,
+        languages: ['Rust', 'TypeScript']
+      },
+      expires_at: new Date(Date.now() + 365 * 24 * 60 * 60 * 1000).toISOString() // 1 year
+    }
+  });
+
+  console.log(`Credential Pending! Claim URL: ${result.claim_url}`);
+}
+```
+
+---
+
+## React Integration Pattern
+
+You can build a reactive hook or component to fetch reputation dynamically:
+
+```tsx
+import React, { useState, useEffect } from 'react';
+import { StellarID, VerifyWalletResponse } from 'stellarid-sdk';
+
+const stellarIdClient = new StellarID({ apiKey: process.env.NEXT_PUBLIC_STELLARID_KEY! });
+
+export function UserReputationWidget({ walletAddress }: { walletAddress: string }) {
+  const [data, setData] = useState<VerifyWalletResponse | null>(null);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    stellarIdClient.verifyWallet(walletAddress)
+      .then(setData)
+      .finally(() => setLoading(false));
+  }, [walletAddress]);
+
+  if (loading) return <div>Loading reputation...</div>;
+  if (!data) return <div>Unverified User</div>;
+
+  return (
+    <div className="reputation-card">
+      <h4>Reputation: {data.reputation_score}</h4>
+      <span className="tier-tag">{data.tier}</span>
+    </div>
+  );
+}
+```
+
+---
+
+## SDK API Reference
+
+| Method | Parameters | Return Type | Required API Permission | Description |
+| :--- | :--- | :--- | :--- | :--- |
+| `verifyWallet(walletAddress)` | `walletAddress: string` | `Promise<VerifyWalletResponse>` | `verify` | Fetches a wallet's full reputation score, credentials list, and tier. |
+| `getBadge(params)` | `{ walletAddress, style?, size? }` | `Promise<GetBadgeResponse>` | `verify` or `read_profile` | Generates iframe embedding HTML & source URL to show a micro-badge. |
+| `issueCredential(params)` | `{ recipientEmail, recipientWallet?, credential }` | `Promise<IssueCredentialResponse>` | `issue` | Creates a pending credential and triggers a verification email. |
+| `getCredential(credentialId)` | `credentialId: string` | `Promise<GetCredentialResponse>` | `read_profile` | Retrieves specific details of an existing, verified credential. |
+| `getProof(credentialId)` | `credentialId: string` | `Promise<GetProofResponse>` | `verify` | Retrieves details about a verified zero-knowledge proof for a credential. |
+
+---
+
+## License
+
+MIT License. Copyright (c) 2026 StellarID.

package/dist/index.d.mts

@@ -0,0 +1,126 @@
+interface StellarIDConfig {
+    apiKey: string;
+    baseURL?: string;
+}
+interface CredentialListItem {
+    id: string;
+    name: string;
+    issuer_name: string;
+    issuer_verified: boolean;
+    issuer_verification_status: string;
+    issued_at: string;
+    expires_at: string;
+    status: 'active' | 'revoked' | 'expired';
+    tx_hash?: string;
+}
+interface VerifyWalletResponse {
+    wallet_address: string;
+    reputation_score: number;
+    tier: 'Verified' | 'Proven' | 'Elite Builder';
+    credential_count: number;
+    verified: boolean;
+    credentials: CredentialListItem[];
+    last_updated: string;
+}
+interface IssueCredentialParams {
+    recipientEmail: string;
+    recipientWallet?: string;
+    credential: {
+        name: string;
+        description?: string;
+        expires_at?: string;
+        metadata?: Record<string, any>;
+    };
+}
+interface IssueCredentialResponse {
+    success: boolean;
+    pending_credential_id: string;
+    claim_token: string;
+    claim_url: string;
+    expires_at: string;
+    created_at: string;
+}
+interface GetCredentialResponse {
+    id: string;
+    name: string;
+    claim_data: Record<string, any>;
+    wallet_address: string;
+    issuer: {
+        name: string;
+        verified: boolean;
+        verification_status: string;
+    };
+    status: 'active' | 'revoked' | 'expired';
+    issued_at: string;
+    expires_at: string;
+    revoked_at?: string;
+    on_chain: {
+        tx_hash?: string;
+        ipfs_hash?: string;
+        nft_token_id?: string;
+    };
+    zk_proof_available: boolean;
+    zk_proof: {
+        proof_id: string;
+        circuit_type: string;
+        public_token: string;
+        verified_at: string;
+    } | null;
+}
+interface GetProofResponse {
+    proof_id: string;
+    credential_name: string;
+    issuer_name: string;
+    circuit_type: string;
+    claim_type: string;
+    status: string;
+    public_token: string;
+    verification_url: string;
+    proof_time_ms: number;
+    created_at: string;
+    expires_at?: string;
+    valid: boolean;
+}
+interface GetBadgeParams {
+    walletAddress: string;
+    style?: 'light' | 'dark';
+    size?: 'sm' | 'md' | 'lg';
+}
+interface GetBadgeResponse {
+    html: string;
+    iframe_url: string;
+}
+
+declare class StellarID {
+    private apiKey;
+    private baseURL;
+    constructor(config: StellarIDConfig);
+    private request;
+    /**
+     * Verifies a Stellar wallet address, returning its reputation score, tier, and credentials.
+     * @param walletAddress Valid Stellar wallet address (G...)
+     */
+    verifyWallet(walletAddress: string): Promise<VerifyWalletResponse>;
+    /**
+     * Issues a pending credential to a recipient via email.
+     * @param params recipient details and credential metadata
+     */
+    issueCredential(params: IssueCredentialParams): Promise<IssueCredentialResponse>;
+    /**
+     * Retrieves details of a specific credential.
+     * @param credentialId The unique ID of the credential
+     */
+    getCredential(credentialId: string): Promise<GetCredentialResponse>;
+    /**
+     * Retrieves the ZK proof associated with a credential.
+     * @param credentialId The unique ID of the credential
+     */
+    getProof(credentialId: string): Promise<GetProofResponse>;
+    /**
+     * Gets the HTML embed code and iframe URL for a wallet badge.
+     * @param params parameters for styling and sizing the badge
+     */
+    getBadge(params: GetBadgeParams): Promise<GetBadgeResponse>;
+}
+
+export { type CredentialListItem, type GetBadgeParams, type GetBadgeResponse, type GetCredentialResponse, type GetProofResponse, type IssueCredentialParams, type IssueCredentialResponse, StellarID, StellarID as StellarIDClient, type StellarIDConfig, type VerifyWalletResponse };

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+interface StellarIDConfig {
+    apiKey: string;
+    baseURL?: string;
+}
+interface CredentialListItem {
+    id: string;
+    name: string;
+    issuer_name: string;
+    issuer_verified: boolean;
+    issuer_verification_status: string;
+    issued_at: string;
+    expires_at: string;
+    status: 'active' | 'revoked' | 'expired';
+    tx_hash?: string;
+}
+interface VerifyWalletResponse {
+    wallet_address: string;
+    reputation_score: number;
+    tier: 'Verified' | 'Proven' | 'Elite Builder';
+    credential_count: number;
+    verified: boolean;
+    credentials: CredentialListItem[];
+    last_updated: string;
+}
+interface IssueCredentialParams {
+    recipientEmail: string;
+    recipientWallet?: string;
+    credential: {
+        name: string;
+        description?: string;
+        expires_at?: string;
+        metadata?: Record<string, any>;
+    };
+}
+interface IssueCredentialResponse {
+    success: boolean;
+    pending_credential_id: string;
+    claim_token: string;
+    claim_url: string;
+    expires_at: string;
+    created_at: string;
+}
+interface GetCredentialResponse {
+    id: string;
+    name: string;
+    claim_data: Record<string, any>;
+    wallet_address: string;
+    issuer: {
+        name: string;
+        verified: boolean;
+        verification_status: string;
+    };
+    status: 'active' | 'revoked' | 'expired';
+    issued_at: string;
+    expires_at: string;
+    revoked_at?: string;
+    on_chain: {
+        tx_hash?: string;
+        ipfs_hash?: string;
+        nft_token_id?: string;
+    };
+    zk_proof_available: boolean;
+    zk_proof: {
+        proof_id: string;
+        circuit_type: string;
+        public_token: string;
+        verified_at: string;
+    } | null;
+}
+interface GetProofResponse {
+    proof_id: string;
+    credential_name: string;
+    issuer_name: string;
+    circuit_type: string;
+    claim_type: string;
+    status: string;
+    public_token: string;
+    verification_url: string;
+    proof_time_ms: number;
+    created_at: string;
+    expires_at?: string;
+    valid: boolean;
+}
+interface GetBadgeParams {
+    walletAddress: string;
+    style?: 'light' | 'dark';
+    size?: 'sm' | 'md' | 'lg';
+}
+interface GetBadgeResponse {
+    html: string;
+    iframe_url: string;
+}
+
+declare class StellarID {
+    private apiKey;
+    private baseURL;
+    constructor(config: StellarIDConfig);
+    private request;
+    /**
+     * Verifies a Stellar wallet address, returning its reputation score, tier, and credentials.
+     * @param walletAddress Valid Stellar wallet address (G...)
+     */
+    verifyWallet(walletAddress: string): Promise<VerifyWalletResponse>;
+    /**
+     * Issues a pending credential to a recipient via email.
+     * @param params recipient details and credential metadata
+     */
+    issueCredential(params: IssueCredentialParams): Promise<IssueCredentialResponse>;
+    /**
+     * Retrieves details of a specific credential.
+     * @param credentialId The unique ID of the credential
+     */
+    getCredential(credentialId: string): Promise<GetCredentialResponse>;
+    /**
+     * Retrieves the ZK proof associated with a credential.
+     * @param credentialId The unique ID of the credential
+     */
+    getProof(credentialId: string): Promise<GetProofResponse>;
+    /**
+     * Gets the HTML embed code and iframe URL for a wallet badge.
+     * @param params parameters for styling and sizing the badge
+     */
+    getBadge(params: GetBadgeParams): Promise<GetBadgeResponse>;
+}
+
+export { type CredentialListItem, type GetBadgeParams, type GetBadgeResponse, type GetCredentialResponse, type GetProofResponse, type IssueCredentialParams, type IssueCredentialResponse, StellarID, StellarID as StellarIDClient, type StellarIDConfig, type VerifyWalletResponse };

package/dist/index.js

@@ -0,0 +1,3 @@
+'use strict';var s=class{constructor(e){if(!e.apiKey)throw new Error("StellarID SDK Error: apiKey is required");this.apiKey=e.apiKey;let r=e.baseURL||"https://stellarid.io/api/v1";this.baseURL=r.endsWith("/")?r.slice(0,-1):r;}async request(e,r={}){let l=`${this.baseURL}${e}`,n={"Content-Type":"application/json","X-API-Key":this.apiKey,...r.headers},t=await fetch(l,{...r,headers:n});if(!t.ok){let i=`StellarID request failed with status ${t.status}`;try{let a=await t.json();i=a.error||a.message||i;}catch{}throw new Error(`StellarID SDK Error: ${i}`)}return t.json()}async verifyWallet(e){if(!e||!/^G[A-Z2-7]{55}$/.test(e))throw new Error("StellarID SDK Error: Invalid Stellar wallet address format");return this.request(`/public/verify/${e}`)}async issueCredential(e){if(!e.recipientEmail)throw new Error("StellarID SDK Error: recipientEmail is required");if(!e.credential||!e.credential.name)throw new Error("StellarID SDK Error: credential.name is required");return this.request("/public/credentials/issue",{method:"POST",body:JSON.stringify({recipient_email:e.recipientEmail,recipient_wallet:e.recipientWallet,credential:e.credential})})}async getCredential(e){if(!e)throw new Error("StellarID SDK Error: credentialId is required");return this.request(`/public/credentials/${e}`)}async getProof(e){if(!e)throw new Error("StellarID SDK Error: credentialId is required");return this.request(`/public/proof/${e}`)}async getBadge(e){if(!e.walletAddress||!/^G[A-Z2-7]{55}$/.test(e.walletAddress))throw new Error("StellarID SDK Error: Invalid Stellar wallet address format");return this.request("/public/embed/badge",{method:"POST",body:JSON.stringify({wallet_address:e.walletAddress,style:e.style||"dark",size:e.size||"md"})})}};
+exports.StellarID=s;exports.StellarIDClient=s;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":["StellarID","config","base","path","options","url","headers","response","errorMessage","errorData","walletAddress","params","credentialId"],"mappings":"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","file":"index.js","sourcesContent":["import {\n  StellarIDConfig,\n  VerifyWalletResponse,\n  IssueCredentialParams,\n  IssueCredentialResponse,\n  GetCredentialResponse,\n  GetProofResponse,\n  GetBadgeParams,\n  GetBadgeResponse,\n} from './types';\n\nexport class StellarID {\n  private apiKey: string;\n  private baseURL: string;\n\n  constructor(config: StellarIDConfig) {\n    if (!config.apiKey) {\n      throw new Error('StellarID SDK Error: apiKey is required');\n    }\n    this.apiKey = config.apiKey;\n    // Strip trailing slash if present\n    const base = config.baseURL || 'https://stellarid.io/api/v1';\n    this.baseURL = base.endsWith('/') ? base.slice(0, -1) : base;\n  }\n\n  private async request<T>(path: string, options: RequestInit = {}): Promise<T> {\n    const url = `${this.baseURL}${path}`;\n    const headers = {\n      'Content-Type': 'application/json',\n      'X-API-Key': this.apiKey,\n      ...options.headers,\n    };\n\n    const response = await fetch(url, {\n      ...options,\n      headers,\n    });\n\n    if (!response.ok) {\n      let errorMessage = `StellarID request failed with status ${response.status}`;\n      try {\n        const errorData = await response.json();\n        errorMessage = errorData.error || errorData.message || errorMessage;\n      } catch (e) {\n        // ignore JSON parse errors, use fallback message\n      }\n      throw new Error(`StellarID SDK Error: ${errorMessage}`);\n    }\n\n    return response.json() as Promise<T>;\n  }\n\n  /**\n   * Verifies a Stellar wallet address, returning its reputation score, tier, and credentials.\n   * @param walletAddress Valid Stellar wallet address (G...)\n   */\n  async verifyWallet(walletAddress: string): Promise<VerifyWalletResponse> {\n    if (!walletAddress || !/^G[A-Z2-7]{55}$/.test(walletAddress)) {\n      throw new Error('StellarID SDK Error: Invalid Stellar wallet address format');\n    }\n    return this.request<VerifyWalletResponse>(`/public/verify/${walletAddress}`);\n  }\n\n  /**\n   * Issues a pending credential to a recipient via email.\n   * @param params recipient details and credential metadata\n   */\n  async issueCredential(params: IssueCredentialParams): Promise<IssueCredentialResponse> {\n    if (!params.recipientEmail) {\n      throw new Error('StellarID SDK Error: recipientEmail is required');\n    }\n    if (!params.credential || !params.credential.name) {\n      throw new Error('StellarID SDK Error: credential.name is required');\n    }\n    return this.request<IssueCredentialResponse>('/public/credentials/issue', {\n      method: 'POST',\n      body: JSON.stringify({\n        recipient_email: params.recipientEmail,\n        recipient_wallet: params.recipientWallet,\n        credential: params.credential,\n      }),\n    });\n  }\n\n  /**\n   * Retrieves details of a specific credential.\n   * @param credentialId The unique ID of the credential\n   */\n  async getCredential(credentialId: string): Promise<GetCredentialResponse> {\n    if (!credentialId) {\n      throw new Error('StellarID SDK Error: credentialId is required');\n    }\n    return this.request<GetCredentialResponse>(`/public/credentials/${credentialId}`);\n  }\n\n  /**\n   * Retrieves the ZK proof associated with a credential.\n   * @param credentialId The unique ID of the credential\n   */\n  async getProof(credentialId: string): Promise<GetProofResponse> {\n    if (!credentialId) {\n      throw new Error('StellarID SDK Error: credentialId is required');\n    }\n    return this.request<GetProofResponse>(`/public/proof/${credentialId}`);\n  }\n\n  /**\n   * Gets the HTML embed code and iframe URL for a wallet badge.\n   * @param params parameters for styling and sizing the badge\n   */\n  async getBadge(params: GetBadgeParams): Promise<GetBadgeResponse> {\n    if (!params.walletAddress || !/^G[A-Z2-7]{55}$/.test(params.walletAddress)) {\n      throw new Error('StellarID SDK Error: Invalid Stellar wallet address format');\n    }\n    return this.request<GetBadgeResponse>('/public/embed/badge', {\n      method: 'POST',\n      body: JSON.stringify({\n        wallet_address: params.walletAddress,\n        style: params.style || 'dark',\n        size: params.size || 'md',\n      }),\n    });\n  }\n}\n\n// Export under alternative alias name\nexport { StellarID as StellarIDClient };\n"]}

package/dist/index.mjs

@@ -0,0 +1,3 @@
+var s=class{constructor(e){if(!e.apiKey)throw new Error("StellarID SDK Error: apiKey is required");this.apiKey=e.apiKey;let r=e.baseURL||"https://stellarid.io/api/v1";this.baseURL=r.endsWith("/")?r.slice(0,-1):r;}async request(e,r={}){let l=`${this.baseURL}${e}`,n={"Content-Type":"application/json","X-API-Key":this.apiKey,...r.headers},t=await fetch(l,{...r,headers:n});if(!t.ok){let i=`StellarID request failed with status ${t.status}`;try{let a=await t.json();i=a.error||a.message||i;}catch{}throw new Error(`StellarID SDK Error: ${i}`)}return t.json()}async verifyWallet(e){if(!e||!/^G[A-Z2-7]{55}$/.test(e))throw new Error("StellarID SDK Error: Invalid Stellar wallet address format");return this.request(`/public/verify/${e}`)}async issueCredential(e){if(!e.recipientEmail)throw new Error("StellarID SDK Error: recipientEmail is required");if(!e.credential||!e.credential.name)throw new Error("StellarID SDK Error: credential.name is required");return this.request("/public/credentials/issue",{method:"POST",body:JSON.stringify({recipient_email:e.recipientEmail,recipient_wallet:e.recipientWallet,credential:e.credential})})}async getCredential(e){if(!e)throw new Error("StellarID SDK Error: credentialId is required");return this.request(`/public/credentials/${e}`)}async getProof(e){if(!e)throw new Error("StellarID SDK Error: credentialId is required");return this.request(`/public/proof/${e}`)}async getBadge(e){if(!e.walletAddress||!/^G[A-Z2-7]{55}$/.test(e.walletAddress))throw new Error("StellarID SDK Error: Invalid Stellar wallet address format");return this.request("/public/embed/badge",{method:"POST",body:JSON.stringify({wallet_address:e.walletAddress,style:e.style||"dark",size:e.size||"md"})})}};
+export{s as StellarID,s as StellarIDClient};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":["StellarID","config","base","path","options","url","headers","response","errorMessage","errorData","walletAddress","params","credentialId"],"mappings":"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","file":"index.mjs","sourcesContent":["import {\n  StellarIDConfig,\n  VerifyWalletResponse,\n  IssueCredentialParams,\n  IssueCredentialResponse,\n  GetCredentialResponse,\n  GetProofResponse,\n  GetBadgeParams,\n  GetBadgeResponse,\n} from './types';\n\nexport class StellarID {\n  private apiKey: string;\n  private baseURL: string;\n\n  constructor(config: StellarIDConfig) {\n    if (!config.apiKey) {\n      throw new Error('StellarID SDK Error: apiKey is required');\n    }\n    this.apiKey = config.apiKey;\n    // Strip trailing slash if present\n    const base = config.baseURL || 'https://stellarid.io/api/v1';\n    this.baseURL = base.endsWith('/') ? base.slice(0, -1) : base;\n  }\n\n  private async request<T>(path: string, options: RequestInit = {}): Promise<T> {\n    const url = `${this.baseURL}${path}`;\n    const headers = {\n      'Content-Type': 'application/json',\n      'X-API-Key': this.apiKey,\n      ...options.headers,\n    };\n\n    const response = await fetch(url, {\n      ...options,\n      headers,\n    });\n\n    if (!response.ok) {\n      let errorMessage = `StellarID request failed with status ${response.status}`;\n      try {\n        const errorData = await response.json();\n        errorMessage = errorData.error || errorData.message || errorMessage;\n      } catch (e) {\n        // ignore JSON parse errors, use fallback message\n      }\n      throw new Error(`StellarID SDK Error: ${errorMessage}`);\n    }\n\n    return response.json() as Promise<T>;\n  }\n\n  /**\n   * Verifies a Stellar wallet address, returning its reputation score, tier, and credentials.\n   * @param walletAddress Valid Stellar wallet address (G...)\n   */\n  async verifyWallet(walletAddress: string): Promise<VerifyWalletResponse> {\n    if (!walletAddress || !/^G[A-Z2-7]{55}$/.test(walletAddress)) {\n      throw new Error('StellarID SDK Error: Invalid Stellar wallet address format');\n    }\n    return this.request<VerifyWalletResponse>(`/public/verify/${walletAddress}`);\n  }\n\n  /**\n   * Issues a pending credential to a recipient via email.\n   * @param params recipient details and credential metadata\n   */\n  async issueCredential(params: IssueCredentialParams): Promise<IssueCredentialResponse> {\n    if (!params.recipientEmail) {\n      throw new Error('StellarID SDK Error: recipientEmail is required');\n    }\n    if (!params.credential || !params.credential.name) {\n      throw new Error('StellarID SDK Error: credential.name is required');\n    }\n    return this.request<IssueCredentialResponse>('/public/credentials/issue', {\n      method: 'POST',\n      body: JSON.stringify({\n        recipient_email: params.recipientEmail,\n        recipient_wallet: params.recipientWallet,\n        credential: params.credential,\n      }),\n    });\n  }\n\n  /**\n   * Retrieves details of a specific credential.\n   * @param credentialId The unique ID of the credential\n   */\n  async getCredential(credentialId: string): Promise<GetCredentialResponse> {\n    if (!credentialId) {\n      throw new Error('StellarID SDK Error: credentialId is required');\n    }\n    return this.request<GetCredentialResponse>(`/public/credentials/${credentialId}`);\n  }\n\n  /**\n   * Retrieves the ZK proof associated with a credential.\n   * @param credentialId The unique ID of the credential\n   */\n  async getProof(credentialId: string): Promise<GetProofResponse> {\n    if (!credentialId) {\n      throw new Error('StellarID SDK Error: credentialId is required');\n    }\n    return this.request<GetProofResponse>(`/public/proof/${credentialId}`);\n  }\n\n  /**\n   * Gets the HTML embed code and iframe URL for a wallet badge.\n   * @param params parameters for styling and sizing the badge\n   */\n  async getBadge(params: GetBadgeParams): Promise<GetBadgeResponse> {\n    if (!params.walletAddress || !/^G[A-Z2-7]{55}$/.test(params.walletAddress)) {\n      throw new Error('StellarID SDK Error: Invalid Stellar wallet address format');\n    }\n    return this.request<GetBadgeResponse>('/public/embed/badge', {\n      method: 'POST',\n      body: JSON.stringify({\n        wallet_address: params.walletAddress,\n        style: params.style || 'dark',\n        size: params.size || 'md',\n      }),\n    });\n  }\n}\n\n// Export under alternative alias name\nexport { StellarID as StellarIDClient };\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "stellarid-sdk",
+  "version": "1.0.0",
+  "description": "Official JavaScript SDK for StellarID, the protocol-grade identity layer on Stellar.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "keywords": [
+    "stellar",
+    "identity",
+    "sdk",
+    "zk-proof",
+    "verification",
+    "blockchain",
+    "did"
+  ],
+  "author": "StellarID Team",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.24",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "tsup": "^8.0.2",
+    "typescript": "^5.3.3"
+  }
+}