@kivel.io/sdk 0.0.0-stage → 0.6.1

package/dist/types.d.ts

@@ -0,0 +1,276 @@
+export interface WaitOptions {
+    token?: string;
+    after?: string;
+    timeoutSeconds?: number;
+}
+export interface AgentLogin {
+    userCode: string;
+    verificationUrl: string;
+    deviceCode: string;
+    expiresAt: string;
+    interval: number;
+    instructions: string;
+}
+export type AgentToken = {
+    status: 'pending';
+    interval: number;
+} | {
+    status: 'approved';
+    apiKey: string;
+    mcp: {
+        url: string;
+        header: string;
+    };
+    next: string;
+};
+export interface AgentTrial {
+    trialKey: string;
+    expiresAt: string;
+    limits: string;
+    claim: {
+        userCode: string;
+        claimUrl: string;
+        deviceCode: string;
+        humanNotified: boolean;
+    };
+    instructions: string;
+}
+export interface EmailInbox {
+    id: string;
+    address: string;
+    expiresAt: string | null;
+    persistent: boolean;
+    status?: 'active' | 'paused';
+    forwardingUrl?: string | null;
+    managementToken?: string;
+    messageCount?: number;
+    messageLimit?: number;
+}
+export interface EmailInboxSettings {
+    activeDays?: number | undefined;
+    localPart?: string | undefined;
+}
+export interface SocketEventSource {
+    kind: 'webhook' | 'email' | 'approval' | 'job' | 'sms';
+    id: string;
+    token?: string;
+    after?: string;
+}
+export interface SocketEvent {
+    kind: SocketEventSource['kind'];
+    id: string;
+    cursor: string;
+    requests?: import('./index.js').CapturedRequest[];
+    messages?: EmailMessage[];
+    approval?: Approval;
+    deliveries?: {
+        id: string;
+        at: string;
+        deliveryId: string;
+        attempt: number;
+        status: number | null;
+        error?: string;
+    }[];
+}
+export interface EmailMessage {
+    id: string;
+    receivedAt: string;
+    from: string;
+    mailFrom?: string;
+    to: string;
+    cc?: string[];
+    subject: string;
+    text: string;
+    html?: string;
+    codes: string[];
+    links: {
+        url: string;
+        kind: 'verification' | 'other';
+    }[];
+    attachments: {
+        id?: string;
+        filename: string;
+        mimeType: string;
+        size: number;
+    }[];
+    direction?: 'inbound' | 'outbound';
+    deliveryStatus?: 'pending' | 'sent';
+    messageId?: string;
+    inReplyTo?: string;
+    references?: string[];
+}
+export interface EmailContent {
+    to: string[];
+    cc?: string[];
+    subject: string;
+    text?: string | undefined;
+    html?: string | undefined;
+    replyTo?: string | undefined;
+}
+export interface SendEmailInput extends EmailContent {
+    idempotencyKey: string;
+}
+export interface EmailThreadSummary {
+    id: string;
+    inboxId: string;
+    subject: string;
+    lastAt: string;
+    from: string;
+    messageCount: number;
+}
+export interface EmailThread extends EmailThreadSummary {
+    messages: EmailMessage[];
+}
+export interface EmailThreadsPage {
+    threads: EmailThreadSummary[];
+    nextCursor: string | null;
+}
+export interface EmailDraft {
+    id: string;
+    inboxId: string;
+    subject: string;
+    status: 'draft' | 'awaitingApproval' | 'scheduled' | 'completed' | 'failed' | 'rejected' | 'expired';
+    sendAt: string | null;
+    expiresAt: string;
+    approvalId?: string;
+    approvalExpiresAt?: string;
+    answerUrl?: string;
+    events: {
+        id: string;
+        at: string;
+        attempt: number;
+        status: number | null;
+        error?: string;
+    }[];
+}
+export interface EmailRules {
+    requireApproval: boolean;
+    inboundAllow: string[];
+    inboundBlock: string[];
+    outboundAllow: string[];
+    outboundBlock: string[];
+}
+export interface MemoryEntry<T = unknown> {
+    namespace: string;
+    key: string;
+    value: T;
+    bytes: number;
+    expiresAt?: string;
+}
+export interface MonitorInput {
+    kind: 'http' | 'ssl' | 'heartbeat' | 'dns';
+    name: string;
+    target?: string;
+    intervalSeconds?: number;
+    graceSeconds?: number;
+    expectStatus?: number;
+    expectText?: string;
+    sslDays?: number;
+    dnsRecordType?: 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS' | 'CAA';
+    alertWebhook?: string;
+}
+export interface Monitor extends MonitorInput {
+    id: string;
+    status: 'pending' | 'up' | 'down';
+    paused: boolean;
+    failures: number;
+    createdAt: string;
+    nextRunAt: string;
+    lastCheckAt?: string;
+    lastPingAt?: string;
+    lastMessage?: string;
+    lastDurationMs?: number;
+    recentChecks?: {
+        at: string;
+        status: string;
+        durationMs: number;
+    }[];
+    dnsBaseline?: string[];
+    lastDnsAnswers?: string[];
+    pingUrl?: string;
+    events?: {
+        at: string;
+        status: string;
+        message: string;
+    }[];
+}
+export interface ApprovalInput {
+    question: string;
+    details?: string;
+    options?: string[];
+    timeoutMinutes?: number;
+}
+export interface Approval {
+    id: string;
+    agentName: string;
+    question: string;
+    details?: string;
+    options: string[];
+    status: 'pending' | 'answered' | 'expired';
+    answer?: string;
+    note?: string;
+    createdAt: string;
+    expiresAt: string;
+    answeredAt?: string;
+    answerUrl: string;
+    emailed?: boolean;
+    next?: string;
+}
+export interface Authenticator {
+    id: string;
+    name: string;
+    issuer: string;
+    accountName: string;
+    algorithm: 'SHA1' | 'SHA256' | 'SHA512';
+    digits: 6 | 7 | 8;
+    period: 30 | 60;
+    createdAt: string;
+}
+export interface AuthenticatorInput {
+    name: string;
+    uri?: string;
+    secret?: string;
+    imageBase64?: string;
+    algorithm?: 'SHA1' | 'SHA256' | 'SHA512';
+    digits?: 6 | 7 | 8;
+    period?: 30 | 60;
+}
+export interface TotpCode {
+    id: string;
+    code: string;
+    secondsRemaining: number;
+    expiresAt: string;
+    nextCode?: string;
+}
+export interface EmailAttachmentLink {
+    filename: string;
+    size: number;
+    expiresAt: string;
+    downloadUrl: string;
+}
+export type OAuthScenario = 'none' | 'access_denied' | 'invalid_grant' | 'expired_code' | 'wrong_redirect_uri' | 'invalid_pkce_verifier' | 'expired_tokens' | 'slow_token_endpoint' | 'rotated_signing_key';
+export interface OAuthProviderInput {
+    name: string;
+    redirectUris: string[];
+    users: {
+        sub: string;
+        email: string;
+        name: string;
+        claims?: Record<string, unknown>;
+    }[];
+    claims?: Record<string, unknown>;
+    headless?: boolean;
+    scenario?: OAuthScenario;
+}
+export interface OAuthProvider {
+    id: string;
+    issuer: string;
+    endpointUrl: string;
+    discoveryUrl: string;
+    client_id: string;
+    expiresAt: string;
+    oauth: OAuthProviderInput;
+}
+export interface CreatedOAuthProvider extends OAuthProvider {
+    client_secret: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@kivel.io/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "CHANGELOG.md"
+  ],
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^26.6.5"
+  },
+  "description": "TypeScript client for Kivel: agent login, webhooks, email, memory, monitors and approvals.",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "homepage": "https://kivel.io/docs/sdk/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TangoBeee/kivel.git",
+    "directory": "packages/sdk"
+  },
+  "bugs": {
+    "email": "support@kivel.io"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "beta"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', {recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }