@elevasis/core 0.1.0

package/src/execution/engine/tools/integration/types/signature-api.ts

@@ -0,0 +1,164 @@
+/**
+ * Shared SignatureAPI param/result types (browser-safe)
+ *
+ * These types define the public interface for SignatureAPI eSignature operations --
+ * used by both the server-side adapter and the SDK typed wrappers. They contain
+ * zero Node.js dependencies and are safe to import in any environment.
+ *
+ * Uses Uint8Array instead of Buffer for browser safety.
+ *
+ * Server-internal types (API response shapes, credentials) remain in
+ * server/adapters/signature-api/fetch/utils/types.ts
+ */
+
+// ============================================================================
+// Helper Types
+// ============================================================================
+
+/**
+ * Valid SignatureAPI field types
+ */
+export type SignatureApiFieldType =
+  | 'signature'
+  | 'initials'
+  | 'recipient_completed_date'
+  | 'envelope_completed_date'
+  | 'recipient_name'
+  | 'recipient_email'
+  | 'text'
+  | 'text_input'
+  | 'boxed_text_input'
+  | 'multi_line_text_input'
+  | 'checkbox'
+  | 'dropdown'
+
+/**
+ * Signing place configuration
+ */
+export interface SigningPlace {
+  recipientKey: string
+  type: SignatureApiFieldType
+  page: number
+  x: number
+  y: number
+  width?: number
+  height?: number
+  fontColor?: string
+}
+
+/**
+ * Document for signing
+ */
+export interface EnvelopeDocument {
+  name: string
+  url: string
+  places?: SigningPlace[]
+}
+
+/**
+ * Recipient/signer configuration
+ */
+export interface Recipient {
+  key: string
+  type: 'signer' | 'viewer' | 'approver'
+  name: string
+  email: string
+  language?: string
+}
+
+// ============================================================================
+// Create Envelope
+// ============================================================================
+
+/**
+ * Create envelope parameters
+ */
+export interface CreateEnvelopeParams {
+  title: string
+  message?: string
+  documents: EnvelopeDocument[]
+  recipients: Recipient[]
+  metadata?: Record<string, string>
+  webhookUrl?: string
+  routing?: 'parallel' | 'sequential'
+}
+
+/**
+ * Create envelope result
+ */
+export interface CreateEnvelopeResult {
+  id: string
+  status: string
+  signingUrl?: string
+}
+
+// ============================================================================
+// Void Envelope
+// ============================================================================
+
+/**
+ * Void envelope parameters
+ */
+export interface VoidEnvelopeParams {
+  envelopeId: string
+  reason?: string
+}
+
+/**
+ * Void envelope result
+ */
+export interface VoidEnvelopeResult {
+  id: string
+  status: 'voided'
+}
+
+// ============================================================================
+// Download Document
+// ============================================================================
+
+/**
+ * Download document parameters
+ */
+export interface DownloadDocumentParams {
+  envelopeId: string
+  documentType?: 'combined' | 'original' | 'audit'
+}
+
+/**
+ * Download document result (Uint8Array for browser safety)
+ */
+export interface DownloadDocumentResult {
+  content: Uint8Array
+  contentType: string
+  filename: string
+}
+
+// ============================================================================
+// Get Envelope
+// ============================================================================
+
+/**
+ * Get envelope parameters
+ */
+export interface GetEnvelopeParams {
+  envelopeId: string
+}
+
+/**
+ * Get envelope result
+ */
+export interface GetEnvelopeResult {
+  id: string
+  title: string
+  status: 'processing' | 'pending' | 'completed' | 'declined' | 'voided'
+  createdAt: string
+  completedAt?: string
+  metadata: Record<string, string>
+  recipients: Array<{
+    key: string
+    name: string
+    email: string
+    status: 'pending' | 'signed' | 'declined'
+    signedAt?: string
+  }>
+}

package/src/execution/engine/tools/integration/types/stripe.ts

@@ -0,0 +1,162 @@
+/**
+ * Shared Stripe param/result types (browser-safe)
+ *
+ * These types define the public interface for Stripe operations -- used by both
+ * the server-side adapter and the SDK typed wrappers. They contain zero Node.js
+ * dependencies and are safe to import in any environment.
+ *
+ * Server-internal types (API response shapes, credentials) remain in
+ * server/adapters/stripe/fetch/utils/types.ts
+ */
+
+// ============================================================================
+// Create Payment Link
+// ============================================================================
+
+/**
+ * Create payment link parameters
+ */
+export interface CreatePaymentLinkParams {
+  priceId: string
+  quantity?: number
+  metadata?: Record<string, string>
+  afterCompletionType?: 'redirect' | 'hosted_confirmation'
+  redirectUrl?: string
+  allowPromotionCodes?: boolean
+  automaticTax?: boolean
+  billingAddressCollection?: 'auto' | 'required'
+  invoiceCreation?: boolean
+}
+
+/**
+ * Create payment link result
+ */
+export interface CreatePaymentLinkResult {
+  id: string
+  url: string
+  active: boolean
+  livemode: boolean
+}
+
+// ============================================================================
+// Get Payment Link
+// ============================================================================
+
+/**
+ * Get payment link parameters
+ */
+export interface GetPaymentLinkParams {
+  paymentLinkId: string
+}
+
+/**
+ * Get payment link result
+ */
+export interface GetPaymentLinkResult {
+  id: string
+  url: string
+  active: boolean
+  livemode: boolean
+  metadata: Record<string, string>
+}
+
+// ============================================================================
+// Update Payment Link
+// ============================================================================
+
+/**
+ * Update payment link parameters
+ */
+export interface UpdatePaymentLinkParams {
+  paymentLinkId: string
+  active?: boolean
+  metadata?: Record<string, string>
+}
+
+/**
+ * Update payment link result
+ */
+export interface UpdatePaymentLinkResult {
+  id: string
+  active: boolean
+  url: string
+}
+
+// ============================================================================
+// List Payment Links
+// ============================================================================
+
+/**
+ * List payment links parameters
+ */
+export interface ListPaymentLinksParams {
+  active?: boolean
+  limit?: number
+  startingAfter?: string
+  endingBefore?: string
+}
+
+/**
+ * List payment links result
+ */
+export interface ListPaymentLinksResult {
+  data: Array<{
+    id: string
+    url: string
+    active: boolean
+    metadata: Record<string, string>
+  }>
+  hasMore: boolean
+}
+
+// ============================================================================
+// Create Auto Payment Link (Dynamic Pricing)
+// ============================================================================
+
+/**
+ * Create auto payment link parameters
+ */
+export interface CreateAutoPaymentLinkParams {
+  dealId: string
+  companyName: string
+  contactEmail: string
+  initialFee: number
+  monthlyFee: number
+}
+
+/**
+ * Create auto payment link result
+ */
+export interface CreateAutoPaymentLinkResult {
+  paymentLinkId: string
+  url: string
+  hasInitialFee: boolean
+  hasRecurring: boolean
+}
+
+// ============================================================================
+// Create Checkout Session
+// ============================================================================
+
+/**
+ * Create checkout session parameters
+ */
+export interface CreateCheckoutSessionParams {
+  amount: number
+  currency?: string
+  productName?: string
+  productDescription?: string
+  metadata?: Record<string, string>
+  successUrl: string
+  cancelUrl: string
+  customerEmail?: string
+}
+
+/**
+ * Create checkout session result
+ */
+export interface CreateCheckoutSessionResult {
+  id: string
+  url: string
+  expiresAt: number
+}

package/src/execution/engine/tools/integration/types/tomba.ts

@@ -0,0 +1,94 @@
+// ============================================================================
+// TOMBA TYPES
+// Browser-safe type definitions for the Tomba email discovery API (v1)
+// ============================================================================
+
+// ---------------------------------------------------------------------------
+// emailFinder - GET /v1/email-finder?domain=&first_name=&last_name=
+// ---------------------------------------------------------------------------
+
+export interface EmailFinderParams {
+  domain: string
+  firstName: string
+  lastName: string
+}
+
+export interface EmailFinderResult {
+  email: string
+  firstName: string
+  lastName: string
+  fullName: string
+  position: string
+  company: string
+  country: string
+  score: number
+  verificationDate: string
+  verificationStatus: string
+  sources: Array<{
+    uri: string
+    extractedOn: string
+    lastSeenOn: string
+    stillOnPage: boolean
+  }>
+  [key: string]: unknown
+}
+
+// ---------------------------------------------------------------------------
+// domainSearch - GET /v1/domain-search?domain=
+// ---------------------------------------------------------------------------
+
+export interface DomainSearchParams {
+  domain: string
+  limit?: number
+  department?: string
+  type?: 'personal' | 'generic'
+}
+
+export interface DomainSearchEmail {
+  email: string
+  firstName: string
+  lastName: string
+  fullName: string
+  position: string
+  department: string
+  verificationDate: string
+  verificationStatus: string
+  sources: Array<{
+    uri: string
+    extractedOn: string
+    lastSeenOn: string
+    stillOnPage: boolean
+  }>
+}
+
+export interface DomainSearchResult {
+  organizationName: string
+  domain: string
+  emails: DomainSearchEmail[]
+  [key: string]: unknown
+}
+
+// ---------------------------------------------------------------------------
+// emailVerifier - GET /v1/email-verifier?email=
+// ---------------------------------------------------------------------------
+
+export interface EmailVerifierParams {
+  email: string
+}
+
+export interface EmailVerifierResult {
+  email: string
+  result: string
+  status: string
+  score: number
+  mxRecords: boolean
+  smtpServer: boolean
+  smtpCheck: boolean
+  acceptAll: boolean
+  block: boolean
+  gibberish: boolean
+  disposable: boolean
+  webmail: boolean
+  regex: boolean
+  [key: string]: unknown
+}