@stacknet/stacks 0.2.0 → 0.2.2

package/src/clients/stack-management.ts

@@ -1,279 +0,0 @@
-/**
- * Stack Management Client
- * CRUD operations for stacks, providers, keys, allowlists, capabilities, members, and model layers
- */
-
-import { DEFAULT_GLAYER_NETWORK_URL, JSON_HEADERS } from '../utils/constants';
-import { StacksSDKError } from '../utils/errors';
-import type {
-  StackConfig,
-  CreateStackRequest,
-  StackResponse,
-  StackListResponse,
-  StackOAuthProvider,
-  StackWeb3Provider,
-  StackStripeProvider,
-  ConfigureOAuthInput,
-  ConfigureWeb3Input,
-  ConfigureStripeInput,
-  StackKeyInfo,
-  CreateKeyResponse,
-  StackKeysListResponse,
-  AllowlistConfig,
-  AllowlistUpdateInput,
-  ModelLayersResponse,
-  StackMember,
-  StackMemberStats,
-  StackManagementClientConfig,
-} from '../types/stack';
-
-export type { StackManagementClientConfig } from '../types/stack';
-
-const API_PATH = '/api/v2';
-
-export class StackManagementClient {
-  private baseUrl: string;
-  private authToken: string | null;
-
-  constructor(config: StackManagementClientConfig = {}) {
-    this.baseUrl = config.baseUrl || DEFAULT_GLAYER_NETWORK_URL;
-    this.authToken = config.authToken || null;
-  }
-
-  /** Update the auth token (e.g. after login via userutils) */
-  setAuthToken(token: string | null) {
-    this.authToken = token;
-  }
-
-  private get headers(): Record<string, string> {
-    const h: Record<string, string> = { ...JSON_HEADERS };
-    if (this.authToken) {
-      h['Authorization'] = `Bearer ${this.authToken}`;
-    }
-    return h;
-  }
-
-  private url(path: string): string {
-    return `${this.baseUrl}${API_PATH}${path}`;
-  }
-
-  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {
-    const opts: RequestInit = { method, headers: this.headers };
-    if (body && method !== 'GET') {
-      opts.body = JSON.stringify(body);
-    }
-
-    const response = await fetch(this.url(path), opts);
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      const code = response.status === 404 ? 'not_found' : response.status === 401 ? 'unauthorized' : 'bad_request';
-      throw new StacksSDKError(
-        `${code}:api`,
-        data.error?.message || data.error || `Request failed: ${response.statusText}`
-      );
-    }
-
-    const data = await response.json();
-    // Unwrap server envelope { success, data }
-    return (data && typeof data === 'object' && 'data' in data) ? data.data : data;
-  }
-
-  // =========================================================================
-  // Stack CRUD
-  // =========================================================================
-
-  async createStack(input: CreateStackRequest): Promise<StackResponse> {
-    return this.request<StackResponse>('POST', '/stacks', input);
-  }
-
-  async listStacks(): Promise<StackListResponse> {
-    return this.request<StackListResponse>('GET', '/stacks');
-  }
-
-  async getStack(stackId: string): Promise<StackResponse> {
-    return this.request<StackResponse>('GET', `/stacks/${stackId}`);
-  }
-
-  async updateStack(stackId: string, updates: Partial<StackConfig>): Promise<StackResponse> {
-    return this.request<StackResponse>('PATCH', `/stacks/${stackId}`, updates);
-  }
-
-  async deleteStack(stackId: string): Promise<{ deleted: boolean }> {
-    return this.request<{ deleted: boolean }>('DELETE', `/stacks/${stackId}`);
-  }
-
-  // =========================================================================
-  // OAuth Providers
-  // =========================================================================
-
-  /** @server-only — Sends OAuth clientSecret. Only call from server-side code. */
-  async configureOAuthProvider(stackId: string, provider: string, config: ConfigureOAuthInput): Promise<StackOAuthProvider> {
-    return this.request<StackOAuthProvider>('POST', `/stacks/${stackId}/oauth/${provider}`, config);
-  }
-
-  async removeOAuthProvider(stackId: string, provider: string): Promise<{ removed: boolean }> {
-    return this.request<{ removed: boolean }>('DELETE', `/stacks/${stackId}/oauth/${provider}`);
-  }
-
-  // =========================================================================
-  // Web3 Providers
-  // =========================================================================
-
-  async configureWeb3Provider(stackId: string, provider: string, config: ConfigureWeb3Input): Promise<StackWeb3Provider> {
-    return this.request<StackWeb3Provider>('POST', `/stacks/${stackId}/web3/${provider}`, config);
-  }
-
-  async removeWeb3Provider(stackId: string, provider: string): Promise<{ removed: boolean }> {
-    return this.request<{ removed: boolean }>('DELETE', `/stacks/${stackId}/web3/${provider}`);
-  }
-
-  // =========================================================================
-  // Stripe Provider
-  // =========================================================================
-
-  /** @server-only — Sends Stripe secretKey. Only call from server-side code. */
-  async configureStripeProvider(stackId: string, config: ConfigureStripeInput): Promise<StackStripeProvider> {
-    return this.request<StackStripeProvider>('POST', `/stacks/${stackId}/stripe`, config);
-  }
-
-  async getStripeProvider(stackId: string): Promise<StackStripeProvider> {
-    return this.request<StackStripeProvider>('GET', `/stacks/${stackId}/stripe`);
-  }
-
-  async removeStripeProvider(stackId: string): Promise<{ removed: boolean }> {
-    return this.request<{ removed: boolean }>('DELETE', `/stacks/${stackId}/stripe`);
-  }
-
-  async createPaymentIntent(stackId: string, amountCents: number, metadata?: Record<string, string>): Promise<{ clientSecret: string; paymentIntentId: string }> {
-    return this.request('POST', `/stacks/${stackId}/stripe/payment-intent`, { amountCents, metadata });
-  }
-
-  // =========================================================================
-  // Stack Keys
-  // =========================================================================
-
-  async createKey(stackId: string, name: string, permission: 'read' | 'write'): Promise<CreateKeyResponse> {
-    return this.request<CreateKeyResponse>('POST', `/stacks/${stackId}/keys`, { name, permission });
-  }
-
-  async listKeys(stackId: string): Promise<StackKeysListResponse> {
-    return this.request<StackKeysListResponse>('GET', `/stacks/${stackId}/keys`);
-  }
-
-  async revokeKey(stackId: string, keyId: string): Promise<{ success: boolean }> {
-    return this.request<{ success: boolean }>('DELETE', `/stacks/${stackId}/keys/${keyId}`);
-  }
-
-  // =========================================================================
-  // Allowlist
-  // =========================================================================
-
-  async getAllowlist(stackId: string): Promise<AllowlistConfig> {
-    return this.request<AllowlistConfig>('GET', `/stacks/${stackId}/auth/allowlist`);
-  }
-
-  async updateAllowlist(stackId: string, config: AllowlistUpdateInput): Promise<AllowlistConfig> {
-    return this.request<AllowlistConfig>('PUT', `/stacks/${stackId}/auth/allowlist`, config);
-  }
-
-  // =========================================================================
-  // Capabilities
-  // =========================================================================
-
-  async updateCapabilities(stackId: string, capabilityBitmask: number): Promise<StackResponse> {
-    return this.request<StackResponse>('PATCH', `/stacks/${stackId}`, { capabilityBitmask });
-  }
-
-  // =========================================================================
-  // Model Layers
-  // =========================================================================
-
-  async getModelLayers(stackId: string): Promise<ModelLayersResponse> {
-    return this.request<ModelLayersResponse>('GET', `/stacks/${stackId}/model-layers`);
-  }
-
-  async updateModelAlias(stackId: string, layer: string, capability: string, alias: string): Promise<{ updated: boolean }> {
-    return this.request('PATCH', `/stacks/${stackId}/model-layers`, { layer, capability, alias });
-  }
-
-  async resetModelAlias(stackId: string, layer: string, capability: string): Promise<{ updated: boolean }> {
-    return this.request('DELETE', `/stacks/${stackId}/model-layers/${layer}/${capability}`);
-  }
-
-  // =========================================================================
-  // Logo
-  // =========================================================================
-
-  async uploadLogo(stackId: string, file: File): Promise<StackResponse> {
-    const url = `${this.baseUrl}${API_PATH}/stacks/${stackId}/logo`;
-    const formData = new FormData();
-    formData.append('logo', file);
-
-    const headers: Record<string, string> = {};
-    if (this.authToken) {
-      headers['Authorization'] = `Bearer ${this.authToken}`;
-    }
-
-    const response = await fetch(url, { method: 'POST', headers, body: formData });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError('bad_request:api', data.error?.message || `Failed to upload logo: ${response.statusText}`);
-    }
-
-    const data = await response.json();
-    return (data && typeof data === 'object' && 'data' in data) ? data.data : data;
-  }
-
-  async deleteLogo(stackId: string): Promise<StackResponse> {
-    return this.request<StackResponse>('DELETE', `/stacks/${stackId}/logo`);
-  }
-
-  // =========================================================================
-  // Members
-  // =========================================================================
-
-  async getMemberStats(stackId: string): Promise<StackMemberStats> {
-    return this.request<StackMemberStats>('GET', `/stacks/${stackId}/members/stats`);
-  }
-
-  async getMembers(stackId: string, opts?: { limit?: number; offset?: number; role?: string }): Promise<StackMember[]> {
-    const params = new URLSearchParams();
-    if (opts?.limit) params.set('limit', String(opts.limit));
-    if (opts?.offset) params.set('offset', String(opts.offset));
-    if (opts?.role) params.set('role', opts.role);
-    const qs = params.toString() ? `?${params}` : '';
-    return this.request<StackMember[]>('GET', `/stacks/${stackId}/members${qs}`);
-  }
-
-  async updateMemberRole(stackId: string, userId: string, role: 'admin' | 'user'): Promise<{ success: boolean }> {
-    return this.request<{ success: boolean }>('PATCH', `/stacks/${stackId}/members/${encodeURIComponent(userId)}/role`, { role });
-  }
-
-  // =========================================================================
-  // Usage Records
-  // =========================================================================
-
-  async getUsageRecords(stackId: string, opts?: { page?: number; limit?: number; days?: number; model?: string }): Promise<{ data: any[]; pagination: any }> {
-    const params = new URLSearchParams();
-    if (opts?.page) params.set('page', String(opts.page));
-    if (opts?.limit) params.set('limit', String(opts.limit));
-    if (opts?.days) params.set('days', String(opts.days));
-    if (opts?.model) params.set('model', opts.model);
-    const qs = params.toString() ? `?${params}` : '';
-    return this.request('GET', `/stacks/${stackId}/usage/records${qs}`);
-  }
-}
-
-/**
- * Create a StackManagementClient instance
- */
-export function createStackManagementClient(config: StackManagementClientConfig = {}): StackManagementClient {
-  return new StackManagementClient(config);
-}
-
-/**
- * Default stack management client instance
- */
-export const stackManagementClient = createStackManagementClient();

package/src/clients/task-network.ts

@@ -1,303 +0,0 @@
-/**
- * TaskNetworkClient - OpenAI-compatible SDK for StackNet
- *
- * Provides streaming chat completions via the local StackNet
- */
-
-import type {
-  Message,
-  ChatCompletionRequest,
-  ChatCompletionChunk,
-  TaskPayload,
-} from '../types';
-import { DEFAULT_TASK_NETWORK_URL } from '../utils/constants';
-
-export interface TaskNetworkConfig {
-  baseUrl?: string;
-  apiKey?: string;
-  timeout?: number;
-}
-
-export class TaskNetworkClient {
-  private baseUrl: string;
-  private apiKey?: string;
-  private timeout: number;
-
-  constructor(config: TaskNetworkConfig = {}) {
-    this.baseUrl = (config.baseUrl || DEFAULT_TASK_NETWORK_URL).replace(/\/$/, '');
-    this.apiKey = config.apiKey;
-    this.timeout = config.timeout || 60000;
-  }
-
-  /**
-   * OpenAI-compatible streaming chat completions
-   */
-  async *chatCompletions(
-    request: ChatCompletionRequest
-  ): AsyncIterable<ChatCompletionChunk> {
-    const userMessages = request.messages.filter((m) => m.role === 'user');
-    const prompt = userMessages[userMessages.length - 1]?.content || '';
-
-    const taskId = await this.submitTask({
-      type: 'ai-prompt',
-      model: request.model,
-      prompt: prompt,
-      sessionId: request.sessionId,
-      temperature: request.temperature,
-      maxTokens: request.max_tokens,
-      stream: true,
-    });
-
-    yield* this.streamTaskResults(taskId, request.model);
-  }
-
-  /**
-   * Submit a task to the network
-   * Returns taskId. If result is immediately available, also includes output.
-   */
-  async submitTask(payload: TaskPayload): Promise<string> {
-    const response = await fetch(`${this.baseUrl}/tasks`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        ...(this.apiKey && { Authorization: `Bearer ${this.apiKey}` }),
-      },
-      body: JSON.stringify(payload),
-    });
-
-    if (!response.ok) {
-      const error = await response.text();
-      throw new Error(`Task submission failed: ${error}`);
-    }
-
-    const data = await response.json();
-    // Handle both taskId and id (StackNet uses different field names)
-    const taskId = data.taskId || data.id;
-    if (!taskId) {
-      throw new Error('Task submission did not return a taskId');
-    }
-    return taskId;
-  }
-
-  /**
-   * Submit a task and get full response (for immediate results)
-   */
-  async submitTaskFull(payload: TaskPayload): Promise<{ taskId: string; output?: unknown; status?: string }> {
-    const response = await fetch(`${this.baseUrl}/tasks`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        ...(this.apiKey && { Authorization: `Bearer ${this.apiKey}` }),
-      },
-      body: JSON.stringify(payload),
-    });
-
-    if (!response.ok) {
-      const error = await response.text();
-      throw new Error(`Task submission failed: ${error}`);
-    }
-
-    const data = await response.json();
-    return {
-      taskId: data.taskId || data.id,
-      output: data.output,
-      status: data.status,
-    };
-  }
-
-  /**
-   * Get task status
-   */
-  async getTask(taskId: string): Promise<{ status: string; result?: unknown }> {
-    const response = await fetch(`${this.baseUrl}/tasks/${taskId}`, {
-      headers: {
-        ...(this.apiKey && { Authorization: `Bearer ${this.apiKey}` }),
-      },
-    });
-
-    if (!response.ok) {
-      throw new Error(`Failed to get task: ${response.statusText}`);
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Stream task results as OpenAI-compatible chunks
-   */
-  async *streamTaskResults(
-    taskId: string,
-    model: string
-  ): AsyncIterable<ChatCompletionChunk> {
-    const response = await fetch(`${this.baseUrl}/tasks/${taskId}/stream`, {
-      headers: {
-        ...(this.apiKey && { Authorization: `Bearer ${this.apiKey}` }),
-      },
-    });
-
-    if (!response.ok) {
-      throw new Error(`Stream failed: ${response.statusText}`);
-    }
-
-    if (!response.body) {
-      throw new Error('Response body is null');
-    }
-
-    const reader = response.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = '';
-    let lastContent = '';
-    const created = Math.floor(Date.now() / 1000);
-
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-
-        if (done) {
-          yield {
-            id: taskId,
-            object: 'chat.completion.chunk',
-            created,
-            model,
-            choices: [
-              {
-                index: 0,
-                delta: {},
-                finish_reason: 'stop',
-              },
-            ],
-          };
-          break;
-        }
-
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split('\n');
-        buffer = lines.pop() || '';
-
-        for (const line of lines) {
-          if (line.startsWith('data: ')) {
-            try {
-              const data = JSON.parse(line.slice(6));
-
-              if (Array.isArray(data) && data.length > 0) {
-                const latestCommit = data[0];
-                const newContent = latestCommit.result || '';
-
-                if (newContent && newContent !== lastContent) {
-                  const delta = newContent.substring(lastContent.length);
-                  lastContent = newContent;
-
-                  if (delta) {
-                    yield {
-                      id: taskId,
-                      object: 'chat.completion.chunk',
-                      created,
-                      model,
-                      choices: [
-                        {
-                          index: 0,
-                          delta: {
-                            role: 'assistant',
-                            content: delta,
-                          },
-                          finish_reason: null,
-                        },
-                      ],
-                    };
-                  }
-                }
-              }
-            } catch {
-              // Skip invalid JSON
-            }
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
-  }
-
-  /**
-   * Stream raw task results (not OpenAI format)
-   */
-  async *streamTaskRaw(taskId: string): AsyncIterable<unknown> {
-    const response = await fetch(`${this.baseUrl}/tasks/${taskId}/stream`, {
-      headers: {
-        ...(this.apiKey && { Authorization: `Bearer ${this.apiKey}` }),
-      },
-    });
-
-    if (!response.ok) {
-      throw new Error(`Stream failed: ${response.statusText}`);
-    }
-
-    if (!response.body) {
-      throw new Error('Response body is null');
-    }
-
-    const reader = response.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = '';
-
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split('\n');
-        buffer = lines.pop() || '';
-
-        for (const line of lines) {
-          if (line.startsWith('data: ')) {
-            try {
-              yield JSON.parse(line.slice(6));
-            } catch {
-              // Skip invalid JSON
-            }
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
-  }
-
-  /**
-   * Health check
-   */
-  async healthCheck(): Promise<boolean> {
-    try {
-      const response = await fetch(`${this.baseUrl}/health`);
-      return response.ok;
-    } catch {
-      return false;
-    }
-  }
-
-  /**
-   * Get node information
-   */
-  async getNode(): Promise<unknown> {
-    const response = await fetch(`${this.baseUrl}/node`);
-    if (!response.ok) {
-      throw new Error(`Failed to get node info: ${response.statusText}`);
-    }
-    return response.json();
-  }
-}
-
-/**
- * Factory function to create a client
- */
-export function createTaskNetworkClient(
-  config?: TaskNetworkConfig
-): TaskNetworkClient {
-  return new TaskNetworkClient(config);
-}
-
-/**
- * Default singleton instance
- */
-export const taskNetworkClient = createTaskNetworkClient();

package/src/clients/user.ts

@@ -1,84 +0,0 @@
-/**
- * User Client
- * Client for interacting with user profile API
- */
-
-import { DEFAULT_TASK_NETWORK_URL, JSON_HEADERS } from '../utils/constants';
-import { StacksSDKError } from '../utils/errors';
-import type {
-  UserProfile,
-  UserProfileUpdateInput,
-  UserProfileResponse,
-  UserClientConfig,
-} from '../types/user';
-
-export type { UserClientConfig } from '../types/user';
-
-export class UserClient {
-  private baseUrl: string;
-
-  constructor(config: UserClientConfig = {}) {
-    this.baseUrl = config.baseUrl || DEFAULT_TASK_NETWORK_URL;
-  }
-
-  private get userUrl(): string {
-    return `${this.baseUrl}/user`;
-  }
-
-  /**
-   * Get user profile by MID
-   */
-  async getProfile(mid: string): Promise<UserProfile | null> {
-    try {
-      const response = await fetch(`${this.userUrl}/profile/${mid}`);
-
-      if (!response.ok) {
-        if (response.status === 404) {
-          return null;
-        }
-        throw new StacksSDKError(
-          'bad_request:api',
-          `Failed to get user profile: ${response.statusText}`
-        );
-      }
-
-      return response.json();
-    } catch (error) {
-      if (error instanceof StacksSDKError) throw error;
-      return null;
-    }
-  }
-
-  /**
-   * Update user profile
-   */
-  async updateProfile(mid: string, input: UserProfileUpdateInput): Promise<UserProfileResponse> {
-    const response = await fetch(`${this.userUrl}/profile/${mid}`, {
-      method: 'PUT',
-      headers: JSON_HEADERS,
-      body: JSON.stringify(input),
-    });
-
-    if (!response.ok) {
-      const data = await response.json().catch(() => ({}));
-      throw new StacksSDKError(
-        'bad_request:api',
-        data.error || `Failed to update user profile: ${response.statusText}`
-      );
-    }
-
-    return response.json();
-  }
-}
-
-/**
- * Create a UserClient instance
- */
-export function createUserClient(config: UserClientConfig = {}): UserClient {
-  return new UserClient(config);
-}
-
-/**
- * Default user client instance
- */
-export const userClient = createUserClient();