@stacknet/stacks 0.2.0 → 0.2.2

package/src/types/stack.ts

@@ -1,269 +0,0 @@
-/**
- * Stack management type definitions
- * Types for stack CRUD, configuration, providers, capabilities, and allowlists
- */
-
-// ============================================================================
-// Stack Configuration
-// ============================================================================
-
-export interface StackConfig {
-  id: string;
-  name: string;
-  displayName: string;
-  description?: string;
-  ownerId: string;
-  allowedChains: string[];
-  oauthProviders: StackOAuthProvider[];
-  web3Providers?: StackWeb3Provider[];
-  stripeProvider?: StackStripeProvider;
-  webhookEndpoint?: string;
-  allowedOrigins: string[];
-  rateLimits?: { requestsPerMinute: number; requestsPerDay: number };
-  features?: { web3Auth: boolean; oauthAuth: boolean; apiKeyAuth: boolean; billing: boolean };
-  metadata?: Record<string, any>;
-  modelAliases?: StackModelAlias[];
-  logoCid?: string;
-  logoUrl?: string;
-  createdAt: number;
-  updatedAt: number;
-  isActive: boolean;
-  capabilityBitmask?: number;
-}
-
-export interface CreateStackRequest {
-  name: string;
-  displayName: string;
-  description?: string;
-  allowedChains?: string[];
-  allowedOrigins?: string[];
-}
-
-export interface StackResponse {
-  stack: StackConfig;
-}
-
-export interface StackListResponse {
-  stacks: StackConfig[];
-}
-
-// ============================================================================
-// Auth Providers
-// ============================================================================
-
-export interface StackOAuthProvider {
-  provider: string;
-  clientId: string;
-  scopes: string[];
-  redirectUri?: string;
-  enabled: boolean;
-}
-
-export interface StackWeb3Provider {
-  provider: 'siwe' | 'siws';
-  domain: string;
-  statement: string;
-  chainId: string;
-  expirationTime?: number;
-  enabled: boolean;
-}
-
-export interface StackStripeProvider {
-  provider: 'stripe';
-  publishableKey: string;
-  enabled: boolean;
-  mode: 'test' | 'live';
-}
-
-/**
- * @server-only — Contains secrets. Only use from server-side code (API routes, server actions).
- * Never import or call from browser/client bundles.
- */
-export interface ConfigureOAuthInput {
-  clientId: string;
-  /** @secret OAuth client secret — never expose to the browser */
-  clientSecret: string;
-  scopes?: string[];
-  redirectUri?: string;
-}
-
-export interface ConfigureWeb3Input {
-  domain: string;
-  statement: string;
-  chainId: string;
-  expirationTime?: number;
-}
-
-/**
- * @server-only — Contains secrets. Only use from server-side code (API routes, server actions).
- * Never import or call from browser/client bundles.
- */
-export interface ConfigureStripeInput {
-  publishableKey: string;
-  /** @secret Stripe secret key — never expose to the browser */
-  secretKey: string;
-}
-
-// ============================================================================
-// Stack Keys
-// ============================================================================
-
-export interface StackKeyInfo {
-  id: string;
-  keyPrefix: string;
-  name: string;
-  permission: 'read' | 'write';
-  lastUsedAt: number | null;
-  createdAt: number;
-  isRevoked: boolean;
-}
-
-export interface CreateKeyResponse {
-  key: string;
-  keyId: string;
-  keyPrefix: string;
-}
-
-export interface StackKeysListResponse {
-  keys: StackKeyInfo[];
-}
-
-// ============================================================================
-// Allowlist
-// ============================================================================
-
-export type AllowlistMode = 'global_fallback' | 'open' | 'explicit';
-
-export interface AllowlistConfig {
-  solana: string[];
-  evm: string[];
-  solanaMode: AllowlistMode;
-  evmMode: AllowlistMode;
-  customSignInMessage: string | null;
-}
-
-export interface AllowlistUpdateInput {
-  solana?: string[];
-  evm?: string[];
-  customSignInMessage?: string | null;
-}
-
-// ============================================================================
-// Model Layers
-// ============================================================================
-
-export interface StackModelAlias {
-  layer: string;
-  capability: string;
-  alias: string;
-}
-
-export interface ModelLayerInfo {
-  name: string;
-  aliases: Array<{
-    capability: string;
-    alias: string;
-    defaultAlias: string;
-    modelId: string;
-  }>;
-}
-
-export interface ModelLayersResponse {
-  layers: ModelLayerInfo[];
-}
-
-// ============================================================================
-// Capabilities Bitmask
-// ============================================================================
-
-export const CAPABILITY_BITS = {
-  text_input:        1 << 0,
-  image_input:       1 << 1,
-  file_input:        1 << 2,
-  audio_input:       1 << 3,
-  video_input:       1 << 4,
-  music_input:       1 << 5,
-  text_output:       1 << 6,
-  image_output:      1 << 7,
-  audio_output:      1 << 8,
-  video_output:      1 << 9,
-  embeddings_output: 1 << 10,
-  music_output:      1 << 11,
-  skills:            1 << 12,
-  loops:             1 << 13,
-  tools:             1 << 14,
-  pipelines:         1 << 15,
-  training:          1 << 16,
-} as const;
-
-export const ALL_CAPABILITIES_BITMASK = 0x1FFFF;
-
-export type CapabilityKey = keyof typeof CAPABILITY_BITS;
-
-export interface StackCapabilities {
-  text_input: boolean;
-  image_input: boolean;
-  file_input: boolean;
-  audio_input: boolean;
-  video_input: boolean;
-  music_input: boolean;
-  text_output: boolean;
-  image_output: boolean;
-  audio_output: boolean;
-  video_output: boolean;
-  embeddings_output: boolean;
-  music_output: boolean;
-  skills: boolean;
-  loops: boolean;
-  tools: boolean;
-  pipelines: boolean;
-  training: boolean;
-}
-
-export function capabilitiesToBitmask(caps: StackCapabilities): number {
-  let mask = 0;
-  for (const [key, bit] of Object.entries(CAPABILITY_BITS)) {
-    if (caps[key as CapabilityKey]) mask |= bit;
-  }
-  return mask;
-}
-
-export function bitmaskToCapabilities(mask: number): StackCapabilities {
-  const caps = {} as StackCapabilities;
-  for (const [key, bit] of Object.entries(CAPABILITY_BITS)) {
-    caps[key as CapabilityKey] = (mask & bit) !== 0;
-  }
-  return caps;
-}
-
-// ============================================================================
-// Members
-// ============================================================================
-
-export interface StackMember {
-  id: string;
-  stack_id: string;
-  user_id: string;
-  role: 'admin' | 'user';
-  auth_method?: string;
-  display_name?: string;
-  created_at: number;
-  last_seen_at: number;
-}
-
-export interface StackMemberStats {
-  total: number;
-  admins: number;
-  users: number;
-  activeLastWeek: number;
-}
-
-// ============================================================================
-// Client Config
-// ============================================================================
-
-export interface StackManagementClientConfig {
-  baseUrl?: string;
-  /** JWT auth token for authenticated requests */
-  authToken?: string;
-}

package/src/types/task.ts

@@ -1,41 +0,0 @@
-/**
- * Task-related type definitions
- */
-
-export type TaskType = 'video' | 'music' | 'image' | 'ai-prompt' | 'mcp-tool';
-
-export type TaskStatus = 'pending' | 'generating' | 'complete' | 'failed';
-
-export interface TaskState {
-  id: string;
-  chatId: string;
-  messageId: string;
-  type: TaskType;
-  status: TaskStatus;
-  progress: number;
-  message: string;
-  result?: string;
-  error?: string;
-  createdAt: number;
-  updatedAt: number;
-}
-
-export interface TaskPayload {
-  type: string;
-  model?: string;
-  prompt?: string;
-  sessionId?: string;
-  temperature?: number;
-  maxTokens?: number;
-  stream?: boolean;
-  search?: boolean; // Enable/disable web search tools (default: true)
-  noTools?: boolean; // Disable all tools
-  [key: string]: unknown;
-}
-
-export interface TaskResponse {
-  taskId: string;
-  status: TaskStatus;
-  result?: unknown;
-  error?: string;
-}

package/src/types/user.ts

@@ -1,29 +0,0 @@
-/**
- * User type definitions
- */
-
-export interface UserProfile {
-  mid: string;
-  username: string;
-  avatar_url: string | null;
-  bio?: string | null;
-  preferences?: string | null;
-  created_at?: string;
-  updated_at?: string;
-}
-
-export interface UserProfileUpdateInput {
-  username?: string;
-  avatar_url?: string | null;
-  bio?: string | null;
-  preferences?: string | null;
-}
-
-export interface UserProfileResponse {
-  profile?: UserProfile;
-  error?: string;
-}
-
-export interface UserClientConfig {
-  baseUrl?: string;
-}

package/src/types/widget.ts

@@ -1,57 +0,0 @@
-/**
- * Widget type definitions
- */
-
-export interface Widget {
-  id: string;
-  name: string;
-  description?: string;
-  component_code: string;
-  styles?: string;
-  props_schema?: Record<string, unknown>;
-  default_props?: Record<string, unknown>;
-  scope?: 'public' | 'private';
-  creator_mid?: string;
-  created_at?: string;
-  updated_at?: string;
-  usage_count?: number;
-}
-
-export interface WidgetsListResponse {
-  widgets: Widget[];
-}
-
-export interface WidgetResponse {
-  widget?: Widget;
-  id?: string;
-  error?: string;
-}
-
-export interface WidgetCreateInput {
-  name: string;
-  description?: string;
-  component_code: string;
-  styles?: string;
-  props_schema?: Record<string, unknown>;
-  default_props?: Record<string, unknown>;
-  scope?: 'public' | 'private';
-  creator_mid?: string;
-}
-
-export interface WidgetUpdateInput {
-  name?: string;
-  description?: string;
-  component_code?: string;
-  styles?: string;
-  props_schema?: Record<string, unknown>;
-  default_props?: Record<string, unknown>;
-  scope?: 'public' | 'private';
-}
-
-export interface WidgetSystemPromptResponse {
-  prompt: string;
-}
-
-export interface WidgetsClientConfig {
-  baseUrl?: string;
-}

package/src/utils/constants.ts

@@ -1,26 +0,0 @@
-/**
- * SDK Constants
- */
-
-export const DEFAULT_GLAYER_NETWORK_URL = 'https://stacknet.magma-rpc.com';
-
-/** @deprecated Use DEFAULT_GLAYER_NETWORK_URL */
-export const DEFAULT_TASK_NETWORK_URL = DEFAULT_GLAYER_NETWORK_URL;
-
-/** @deprecated Use DEFAULT_GLAYER_NETWORK_URL */
-export const DEFAULT_P2P_NETWORK_URL = DEFAULT_GLAYER_NETWORK_URL;
-export const DEFAULT_MAGMA_RPC_URL = 'http://geoff.magma-rpc.com';
-
-export const TASK_PREFIX = 'task:';
-export const CHAT_TASKS_PREFIX = 'chat:tasks:';
-export const TASK_TTL = 86400 * 7; // 7 days in seconds
-
-export const SSE_HEADERS = {
-  'Content-Type': 'text/event-stream',
-  'Cache-Control': 'no-cache',
-  'Connection': 'keep-alive',
-} as const;
-
-export const JSON_HEADERS = {
-  'Content-Type': 'application/json',
-} as const;

package/src/utils/errors.ts

@@ -1,169 +0,0 @@
-/**
- * Error handling utilities for the Stacks SDK
- */
-
-export type ErrorType =
-  | 'bad_request'
-  | 'unauthorized'
-  | 'forbidden'
-  | 'not_found'
-  | 'rate_limit'
-  | 'payment_required'
-  | 'offline'
-  | 'internal';
-
-export type Surface =
-  | 'chat'
-  | 'auth'
-  | 'api'
-  | 'stream'
-  | 'database'
-  | 'history'
-  | 'vote'
-  | 'document'
-  | 'suggestions'
-  | 'task'
-  | 'agent'
-  | 'imagination';
-
-export type ErrorCode = `${ErrorType}:${Surface}`;
-
-export type ErrorVisibility = 'response' | 'log' | 'none';
-
-export const visibilityBySurface: Record<Surface, ErrorVisibility> = {
-  database: 'log',
-  chat: 'response',
-  auth: 'response',
-  stream: 'response',
-  api: 'response',
-  history: 'response',
-  vote: 'response',
-  document: 'response',
-  suggestions: 'response',
-  task: 'response',
-  agent: 'response',
-  imagination: 'response',
-};
-
-export class StacksSDKError extends Error {
-  public type: ErrorType;
-  public surface: Surface;
-  public statusCode: number;
-
-  constructor(errorCode: ErrorCode, cause?: string) {
-    super();
-
-    const [type, surface] = errorCode.split(':');
-
-    this.type = type as ErrorType;
-    this.cause = cause;
-    this.surface = surface as Surface;
-    this.message = getMessageByErrorCode(errorCode);
-    this.statusCode = getStatusCodeByType(this.type);
-  }
-
-  public toJSON() {
-    return {
-      code: `${this.type}:${this.surface}`,
-      message: this.message,
-      cause: this.cause,
-      statusCode: this.statusCode,
-    };
-  }
-
-  public toResponse(): Response {
-    const code: ErrorCode = `${this.type}:${this.surface}`;
-    const visibility = visibilityBySurface[this.surface];
-
-    const { message, cause, statusCode } = this;
-
-    if (visibility === 'log') {
-      console.error({ code, message, cause });
-      return Response.json(
-        { code: '', message: 'Something went wrong. Please try again later.' },
-        { status: statusCode }
-      );
-    }
-
-    return Response.json({ code, message, cause }, { status: statusCode });
-  }
-}
-
-export function getMessageByErrorCode(errorCode: ErrorCode): string {
-  if (errorCode.includes('database')) {
-    return 'An error occurred while executing a database query.';
-  }
-
-  switch (errorCode) {
-    case 'bad_request:api':
-      return "The request couldn't be processed. Please check your input and try again.";
-
-    case 'unauthorized:auth':
-      return 'You need to sign in before continuing.';
-    case 'unauthorized:api':
-      return 'Your session has expired. Please sign in again.';
-    case 'forbidden:auth':
-      return 'Your account does not have access to this feature.';
-
-    case 'rate_limit:chat':
-      return 'You have exceeded your maximum number of messages for the day. Please try again later.';
-    case 'not_found:chat':
-      return 'The requested chat was not found.';
-    case 'forbidden:chat':
-      return 'This chat belongs to another user.';
-    case 'unauthorized:chat':
-      return 'You need to sign in to view this chat.';
-    case 'offline:chat':
-      return "We're having trouble sending your message. Please check your internet connection.";
-
-    case 'not_found:task':
-      return 'The requested task was not found.';
-    case 'forbidden:task':
-      return 'You do not have access to this task.';
-
-    case 'not_found:agent':
-      return 'The requested agent was not found.';
-    case 'forbidden:agent':
-      return 'You do not have access to this agent.';
-
-    case 'not_found:imagination':
-      return 'The requested imagination was not found.';
-    case 'forbidden:imagination':
-      return 'You do not have access to this imagination.';
-
-    case 'not_found:document':
-      return 'The requested document was not found.';
-    case 'forbidden:document':
-      return 'This document belongs to another user.';
-    case 'unauthorized:document':
-      return 'You need to sign in to view this document.';
-    case 'bad_request:document':
-      return 'The request to create or update the document was invalid.';
-
-    default:
-      return 'Something went wrong. Please try again later.';
-  }
-}
-
-function getStatusCodeByType(type: ErrorType): number {
-  switch (type) {
-    case 'bad_request':
-      return 400;
-    case 'unauthorized':
-      return 401;
-    case 'payment_required':
-      return 402;
-    case 'forbidden':
-      return 403;
-    case 'not_found':
-      return 404;
-    case 'rate_limit':
-      return 429;
-    case 'offline':
-      return 503;
-    case 'internal':
-      return 500;
-    default:
-      return 500;
-  }
-}

package/src/utils/helpers.ts

@@ -1,85 +0,0 @@
-/**
- * Utility helper functions
- */
-
-/**
- * Generate a UUID v4
- */
-export function generateUUID(): string {
-  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-    const r = (Math.random() * 16) | 0;
-    const v = c === 'x' ? r : (r & 0x3) | 0x8;
-    return v.toString(16);
-  });
-}
-
-/**
- * Generate a CID-like hash from content
- */
-export async function generateCID(buffer: ArrayBuffer): Promise<string> {
-  const hashBuffer = await crypto.subtle.digest('SHA-256', buffer);
-  const hashArray = Array.from(new Uint8Array(hashBuffer));
-  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
-  return `baf${hashHex.substring(0, 52)}`;
-}
-
-/**
- * Sleep for a specified duration
- */
-export function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-/**
- * Retry a function with exponential backoff
- */
-export async function retry<T>(
-  fn: () => Promise<T>,
-  options: {
-    maxAttempts?: number;
-    initialDelay?: number;
-    maxDelay?: number;
-    backoffFactor?: number;
-  } = {}
-): Promise<T> {
-  const {
-    maxAttempts = 3,
-    initialDelay = 1000,
-    maxDelay = 30000,
-    backoffFactor = 2,
-  } = options;
-
-  let lastError: Error | undefined;
-  let delay = initialDelay;
-
-  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-    try {
-      return await fn();
-    } catch (error) {
-      lastError = error as Error;
-      if (attempt === maxAttempts) break;
-
-      await sleep(delay);
-      delay = Math.min(delay * backoffFactor, maxDelay);
-    }
-  }
-
-  throw lastError;
-}
-
-/**
- * Parse SSE data line
- */
-export function parseSSELine(line: string): { event?: string; data?: string } | null {
-  if (!line || line.startsWith(':')) return null;
-
-  if (line.startsWith('event:')) {
-    return { event: line.slice(6).trim() };
-  }
-
-  if (line.startsWith('data:')) {
-    return { data: line.slice(5).trim() };
-  }
-
-  return null;
-}

package/src/utils/index.ts

@@ -1,7 +0,0 @@
-/**
- * @stacknet/stacks - Utilities
- */
-
-export * from './errors';
-export * from './constants';
-export * from './helpers';