Svc SDK

Service abstraction and orchestration

Installation

pnpm add sdk.do

Quick Start

import { $ } from 'sdk.do'

// Basic usage
$.svc({ input: data, transform: 'normalize' })

API Reference

Main Methods

`$.svc()`

Main entry point for svc.do operations.

$.svc({ input: data, transform: 'normalize' })

Parameters:

Configuration object specific to svc.do

Returns:

Promise resolving to operation result

Configuration

interface SvcConfig {
  // Configuration options for svc.do
  options?: Record<string, any>
  timeout?: number
  retries?: number
}

Usage Examples

Basic Example

import { $ } from 'sdk.do'

// Simple usage
$.svc({ input: data, transform: 'normalize' })

Advanced Example

import { $, on, send } from 'sdk.do'

// Advanced usage with event handling
$.svc({ input: data, transform: 'normalize' })

// Listen for events
on('svc.completed', async (result) => {
  console.log('Operation completed:', result)
  await send('notification.sent', { result })
})

Error Handling

try {
  $.svc({ input: data, transform: 'normalize' })
} catch (error) {
  if (error.code === 'TIMEOUT') {
    // Handle timeout
    console.error('Operation timed out')
  } else if (error.code === 'VALIDATION_ERROR') {
    // Handle validation error
    console.error('Invalid input:', error.message)
  } else {
    throw error
  }
}

TypeScript Support

Full TypeScript support with type inference:

import type { SvcResult, SvcConfig } from 'sdk.do'

const config: SvcConfig = {
  // Fully typed configuration
}

const result: SvcResult = await $.svc(config)

Integration with Events

import { $, on, send } from 'sdk.do'

// Trigger on event
on('user.created', async (user) => {
  $.svc({ input: data, transform: 'normalize' })
})

// Send event after completion
const result = await $.svc({
  /* config */
})
await send('svc.completed', result)

Best Practices

Error Handling - Always wrap operations in try/catch
Type Safety - Use TypeScript types for better DX
Event Integration - Leverage event system for workflows
Configuration - Use environment variables for sensitive data
Monitoring - Track operations for debugging

Svc SDK

On this page