@decentrl/sdk 0.0.1

package/dist/test-helpers.js

@@ -0,0 +1,65 @@
+import { vi } from 'vitest';
+export const makeContract = (overrides) => ({
+    id: overrides.id ?? `contract-${Math.random().toString(36).slice(2)}`,
+    participantDid: overrides.participantDid,
+    signedCommunicationContract: {
+        communication_contract: {
+            requestor_did: overrides.signedCommunicationContract?.communication_contract?.requestor_did ??
+                'did:decentrl:alice',
+            recipient_did: overrides.participantDid,
+            requestor_signing_key_id: 'did:decentrl:alice#signing',
+            recipient_signing_key_id: `${overrides.participantDid}#signing`,
+            requestor_encryption_public_key: 'key-a',
+            recipient_encryption_public_key: 'key-b',
+            expires_at: overrides.expiresAt,
+            timestamp: overrides.timestamp,
+        },
+        requestor_signature: 'sig-a',
+        recipient_signature: 'sig-b',
+    },
+    rootSecret: overrides.rootSecret ?? 'c2VjcmV0',
+    createdAt: overrides.createdAt ?? Date.now(),
+    status: overrides.status ?? 'active',
+});
+export const createMockIdentityManager = (overrides = {}) => ({
+    requireIdentity: vi.fn(() => ({
+        did: 'did:decentrl:alice',
+        mediatorDid: 'did:web:mediator',
+        mediatorEndpoint: 'http://mediator',
+        keys: {
+            signing: {
+                privateKey: new Uint8Array(32),
+                publicKey: new Uint8Array(32),
+            },
+            encryption: {
+                privateKey: new Uint8Array(32),
+                publicKey: new Uint8Array(32),
+            },
+            storageKey: new Uint8Array(32),
+        },
+    })),
+    getIdentity: vi.fn(() => null),
+    ...overrides,
+});
+export const createMockTransport = (overrides = {}) => ({
+    refreshContracts: vi.fn(async () => []),
+    processAutoRenewals: vi.fn(async () => { }),
+    processContractCleanup: vi.fn(async () => { }),
+    requestContract: vi.fn(async () => { }),
+    getPendingContracts: vi.fn(async () => []),
+    acceptContract: vi.fn(async () => { }),
+    getActiveContracts: vi.fn(() => []),
+    processPendingEvents: vi.fn(async () => []),
+    ...overrides,
+});
+export const createMockEventProcessor = (overrides = {}) => ({
+    processBatch: vi.fn(() => 0),
+    computeTagsSafe: vi.fn((type) => [`tag:${type}`]),
+    ...overrides,
+});
+export const createMockContractManager = (overrides = {}) => ({
+    refresh: vi.fn(async () => { }),
+    processAutoRenewals: vi.fn(async () => { }),
+    processContractCleanup: vi.fn(async () => { }),
+    ...overrides,
+});

package/dist/transport.d.ts

@@ -0,0 +1,41 @@
+import type { EventEnvelope, PendingContractRequest, SerializedIdentity, StoredSignedContract } from './types.js';
+export interface DecentrlTransport {
+    createIdentity(options: {
+        alias: string;
+        mediatorDid: string;
+    }): Promise<SerializedIdentity>;
+    getIdentity(): SerializedIdentity | null;
+    loadIdentity?(serialized: SerializedIdentity): void;
+    publishEvent(envelope: EventEnvelope, options: {
+        tags: string[];
+        recipient?: string;
+        ephemeral?: boolean;
+    }): Promise<void>;
+    processPendingEvents(): Promise<EventEnvelope[]>;
+    processPreFetchedPendingEvents?(rawEvents: Array<{
+        id: string;
+        sender_did: string;
+        payload: string;
+    }>): Promise<EventEnvelope[]>;
+    requestContract(recipientDid: string, expiresIn?: number): Promise<void>;
+    getPendingContracts(): Promise<PendingContractRequest[]>;
+    acceptContract(pendingId: string, encryptedPayload: string, requestorEphemeralPublicKey: string): Promise<void>;
+    refreshContracts(): Promise<StoredSignedContract[]>;
+    getActiveContracts(): StoredSignedContract[];
+    processAutoRenewals?(threshold: number): Promise<void>;
+    processContractCleanup?(): Promise<void>;
+    getContractHistory?(): Promise<import('./types.js').ArchivedContract[]>;
+    queryEvents?(options?: import('./types.js').QueryOptions): Promise<import('./types.js').PaginatedResult<EventEnvelope>>;
+    onEvents?(listener: (events: EventEnvelope[]) => void): () => void;
+    onContractsChanged?(listener: () => void): () => void;
+    updateEventTags?(events: Array<{
+        eventId: string;
+        tags: string[];
+    }>): Promise<void>;
+    queryUnprocessedEvents?(pagination?: {
+        page: number;
+        pageSize: number;
+    }): Promise<import('./types.js').PaginatedResult<EventEnvelope>>;
+    dispose(): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,iBAAiB;IAEjC,cAAc,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC7F,WAAW,IAAI,kBAAkB,GAAG,IAAI,CAAC;IACzC,YAAY,CAAC,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAGpD,YAAY,CACX,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAClE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,oBAAoB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACjD,8BAA8B,CAAC,CAC9B,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACnE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAG5B,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACzD,cAAc,CACb,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,2BAA2B,EAAE,MAAM,GACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACpD,kBAAkB,IAAI,oBAAoB,EAAE,CAAC;IAG7C,mBAAmB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvD,sBAAsB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzC,kBAAkB,CAAC,IAAI,OAAO,CAAC,OAAO,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAGxE,WAAW,CAAC,CACX,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,YAAY,GACzC,OAAO,CAAC,OAAO,YAAY,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC;IAGhE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAGnE,kBAAkB,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAGtD,eAAe,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGpF,sBAAsB,CAAC,CAAC,UAAU,CAAC,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,YAAY,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC;IAEjE,OAAO,IAAI,IAAI,CAAC;CAChB"}

package/dist/transport.js

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

package/dist/types.d.ts

@@ -0,0 +1,131 @@
+import type { DecentrlIdentityKeys } from '@decentrl/crypto';
+import type { SignedCommunicationContract } from '@decentrl/identity/communication-contract/communication-contract.schema';
+import type { z } from 'zod';
+export interface EventDefinition<TSchema extends z.ZodType = z.ZodType> {
+    schema: TSchema;
+    tags: string[];
+}
+export type EventDefinitions = Record<string, {
+    schema: z.ZodType;
+    tags: string[];
+}>;
+export interface StateSliceDefinition<TSlice = unknown, TEvents extends EventDefinitions = EventDefinitions> {
+    initial: TSlice;
+    reduce: {
+        [K in keyof TEvents]?: (state: TSlice, data: z.infer<TEvents[K]['schema']>, meta: EventMeta) => TSlice;
+    };
+}
+export type StateDefinitions<TEvents extends EventDefinitions = EventDefinitions> = Record<string, StateSliceDefinition<any, TEvents>>;
+export type InferState<TState extends StateDefinitions> = {
+    [K in keyof TState]: TState[K]['initial'];
+};
+export interface EventMeta {
+    senderDid: string;
+    timestamp: number;
+    eventId: string;
+    ephemeral?: boolean;
+}
+export interface EventEnvelope {
+    type: string;
+    data: unknown;
+    meta: EventMeta;
+    tags?: string[];
+    _mediatorEventId?: string;
+}
+export interface DecentrlClientConfig {
+    mediatorDid: string;
+    /** Enable localStorage persistence. Pass a key prefix (e.g. "decentrl-myapp"). */
+    persist?: {
+        key: string;
+    };
+    /** Optional transport layer. Defaults to DirectTransport (direct HTTP to mediator). */
+    transport?: import('./transport.js').DecentrlTransport;
+}
+export interface DecentrlAppConfig<TEvents extends EventDefinitions = EventDefinitions, TState extends StateDefinitions<TEvents> = StateDefinitions<TEvents>> {
+    events: TEvents;
+    state: TState;
+}
+export interface SerializedKeyPair {
+    privateKey: string;
+    publicKey: string;
+}
+export interface SerializedIdentity {
+    did: string;
+    alias: string;
+    mediatorDid: string;
+    mediatorEndpoint: string;
+    keys: {
+        signing: SerializedKeyPair;
+        encryption: SerializedKeyPair;
+        storageKey: string;
+    };
+    mediatorContract: SignedCommunicationContract | null;
+}
+export interface IdentityState {
+    did: string;
+    alias: string;
+    mediatorDid: string;
+    mediatorEndpoint: string;
+    keys: DecentrlIdentityKeys;
+    mediatorContract: SignedCommunicationContract | null;
+}
+export interface StoredSignedContract {
+    id: string;
+    participantDid: string;
+    participantAlias?: string;
+    signedCommunicationContract: SignedCommunicationContract;
+    rootSecret: string;
+    createdAt: number;
+    status: 'active' | 'expired' | 'superseded';
+}
+export interface ArchivedContract {
+    contractId: string;
+    participantDid: string;
+    participantAlias?: string;
+    timestamp: number;
+    expiresAt: number;
+    supersededAt: number;
+    supersededBy: string;
+}
+export interface PendingContractRequest {
+    id: string;
+    senderDid: string;
+    encryptedPayload: string;
+    requestorEphemeralPublicKey: string;
+}
+export interface QueryOptions {
+    tags?: string[];
+    participantDid?: string;
+    afterTimestamp?: number;
+    beforeTimestamp?: number;
+    pagination?: {
+        page: number;
+        pageSize: number;
+    };
+}
+export interface PaginationMeta {
+    page: number;
+    pageSize: number;
+    total: number;
+}
+export interface PaginatedResult<T> {
+    data: T[];
+    pagination: PaginationMeta;
+}
+export interface PublishOptions {
+    recipient?: string;
+    ephemeral?: boolean;
+}
+export interface SyncOptions {
+    intervalMs?: number;
+    fallbackIntervalMs?: number;
+    onError?: (error: unknown) => void;
+    websocket?: boolean;
+    autoRenew?: {
+        enabled: boolean;
+        threshold?: number;
+    };
+}
+export type { ConnectionStatus } from './websocket-transport.js';
+export type StateListener<TState> = (state: TState) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

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

package/dist/websocket-transport.d.ts

@@ -0,0 +1,36 @@
+import { type DecentrlIdentityKeys } from '@decentrl/crypto';
+export type ConnectionStatus = 'disconnected' | 'connecting' | 'authenticating' | 'connected';
+export interface WebSocketTransportCallbacks {
+    onPendingEvents: (events: Array<{
+        id: string;
+        sender_did: string;
+        payload: string;
+    }>) => void;
+    onContractsUpdated: () => void;
+    onStatusChange: (status: ConnectionStatus) => void;
+}
+export interface WebSocketTransportIdentity {
+    did: string;
+    keys: DecentrlIdentityKeys;
+}
+export declare class WebSocketTransport {
+    private getIdentity;
+    private getWsUrl;
+    private callbacks;
+    private ws;
+    private status;
+    private reconnectAttempt;
+    private reconnectTimer;
+    private shouldReconnect;
+    constructor(getIdentity: () => WebSocketTransportIdentity | null, getWsUrl: () => string | null, callbacks: WebSocketTransportCallbacks);
+    connect(): void;
+    disconnect(): void;
+    getStatus(): ConnectionStatus;
+    private sendAuthenticate;
+    private handleMessage;
+    private send;
+    private setStatus;
+    private scheduleReconnect;
+}
+export declare function deriveWsUrl(httpEndpoint: string): string;
+//# sourceMappingURL=websocket-transport.d.ts.map

package/dist/websocket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.d.ts","sourceRoot":"","sources":["../src/websocket-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAkB,MAAM,kBAAkB,CAAC;AAE7E,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAE9F,MAAM,WAAW,2BAA2B;IAC3C,eAAe,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;IAC9F,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,cAAc,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,0BAA0B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,oBAAoB,CAAC;CAC3B;AAcD,qBAAa,kBAAkB;IAQ7B,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;IATlB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,eAAe,CAAS;gBAGvB,WAAW,EAAE,MAAM,0BAA0B,GAAG,IAAI,EACpD,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,EAC7B,SAAS,EAAE,2BAA2B;IAG/C,OAAO,IAAI,IAAI;IAoEf,UAAU,IAAI,IAAI;IAkBlB,SAAS,IAAI,gBAAgB;IAI7B,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,iBAAiB;CA2BzB;AAED,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMxD"}

package/dist/websocket-transport.js

@@ -0,0 +1,160 @@
+import { signJsonObject } from '@decentrl/crypto';
+const MAX_RECONNECT_ATTEMPTS = 10;
+const BASE_RECONNECT_MS = 1000;
+const MAX_RECONNECT_MS = 30_000;
+const JITTER_FACTOR = 0.2;
+export class WebSocketTransport {
+    getIdentity;
+    getWsUrl;
+    callbacks;
+    ws = null;
+    status = 'disconnected';
+    reconnectAttempt = 0;
+    reconnectTimer = null;
+    shouldReconnect = false;
+    constructor(getIdentity, getWsUrl, callbacks) {
+        this.getIdentity = getIdentity;
+        this.getWsUrl = getWsUrl;
+        this.callbacks = callbacks;
+    }
+    connect() {
+        if (this.ws) {
+            return;
+        }
+        const wsUrl = this.getWsUrl();
+        const identity = this.getIdentity();
+        if (!wsUrl || !identity) {
+            console.warn('[Decentrl:WS] connect() skipped — wsUrl:', !!wsUrl, 'identity:', !!identity);
+            return;
+        }
+        console.debug('[Decentrl:WS] Connecting to', wsUrl);
+        this.shouldReconnect = true;
+        this.setStatus('connecting');
+        try {
+            this.ws = new WebSocket(wsUrl);
+        }
+        catch (err) {
+            console.error('[Decentrl:WS] WebSocket constructor failed:', err);
+            this.setStatus('disconnected');
+            this.scheduleReconnect();
+            return;
+        }
+        this.ws.onopen = () => {
+            console.debug('[Decentrl:WS] Socket opened, authenticating...');
+            this.setStatus('authenticating');
+            this.sendAuthenticate(identity);
+        };
+        this.ws.onmessage = (event) => {
+            let data;
+            try {
+                data = JSON.parse(event.data);
+            }
+            catch {
+                return;
+            }
+            this.handleMessage(data);
+        };
+        this.ws.onclose = (event) => {
+            console.debug('[Decentrl:WS] Socket closed — code:', event.code, 'reason:', event.reason, 'willReconnect:', this.shouldReconnect);
+            this.ws = null;
+            this.setStatus('disconnected');
+            if (this.shouldReconnect) {
+                this.scheduleReconnect();
+            }
+        };
+        this.ws.onerror = () => {
+            console.error('[Decentrl:WS] Socket error (onclose will follow)');
+        };
+    }
+    disconnect() {
+        this.shouldReconnect = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.onclose = null;
+            this.ws.close();
+            this.ws = null;
+        }
+        this.reconnectAttempt = 0;
+        this.setStatus('disconnected');
+    }
+    getStatus() {
+        return this.status;
+    }
+    sendAuthenticate(identity) {
+        const payload = {
+            did: identity.did,
+            signing_key_id: `${identity.did}#signing`,
+            timestamp: Date.now(),
+            nonce: crypto.randomUUID(),
+        };
+        const signature = signJsonObject(payload, identity.keys.signing.privateKey);
+        this.send({
+            type: 'AUTHENTICATE',
+            ...payload,
+            signature,
+        });
+    }
+    handleMessage(data) {
+        if (data.type !== 'PING') {
+            console.debug('[Decentrl:WS] Received:', data.type, data.type === 'PENDING_EVENTS' ? `(${data.events.length} events)` : '');
+        }
+        switch (data.type) {
+            case 'AUTH_SUCCESS':
+                this.reconnectAttempt = 0;
+                this.setStatus('connected');
+                break;
+            case 'AUTH_FAILED':
+                console.error('[Decentrl:WS] Auth failed:', data.error_code);
+                // Don't reconnect on auth failure — would fail again
+                this.shouldReconnect = false;
+                this.ws?.close();
+                break;
+            case 'PENDING_EVENTS':
+                this.callbacks.onPendingEvents(data.events);
+                break;
+            case 'CONTRACTS_UPDATED':
+                this.callbacks.onContractsUpdated();
+                break;
+            case 'PING':
+                this.send({ type: 'PONG', timestamp: Date.now() });
+                break;
+        }
+    }
+    send(message) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(message));
+        }
+    }
+    setStatus(status) {
+        if (this.status !== status) {
+            console.debug('[Decentrl:WS] Status:', this.status, '→', status);
+            this.status = status;
+            this.callbacks.onStatusChange(status);
+        }
+    }
+    scheduleReconnect() {
+        if (this.reconnectAttempt >= MAX_RECONNECT_ATTEMPTS) {
+            console.warn('[Decentrl:WS] Max reconnect attempts reached (%d), giving up', MAX_RECONNECT_ATTEMPTS);
+            return;
+        }
+        const backoff = Math.min(BASE_RECONNECT_MS * 2 ** this.reconnectAttempt, MAX_RECONNECT_MS);
+        const jitter = backoff * JITTER_FACTOR * (Math.random() * 2 - 1);
+        const delay = Math.max(0, backoff + jitter);
+        this.reconnectAttempt++;
+        console.debug('[Decentrl:WS] Reconnecting in %dms (attempt %d/%d)', Math.round(delay), this.reconnectAttempt, MAX_RECONNECT_ATTEMPTS);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.ws = null;
+            this.connect();
+        }, delay);
+    }
+}
+export function deriveWsUrl(httpEndpoint) {
+    const url = new URL(httpEndpoint);
+    url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+    url.pathname = `${url.pathname.replace(/\/$/, '')}/ws`;
+    return url.toString();
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@decentrl/sdk",
+  "version": "0.0.1",
+  "description": "Declarative SDK for building Decentrl protocol applications",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "zod": "^4.0.10",
+    "axios": "1.11.0",
+    "@decentrl/crypto": "0.0.1",
+    "@decentrl/identity": "0.0.1",
+    "@decentrl/event-store": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "vitest": "3.2.4"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bash scripts/test-e2e.sh",
+    "test:unit": "vitest run --exclude 'src/**/*.e2e.test.ts'",
+    "test:watch": "vitest --exclude 'src/**/*.e2e.test.ts'",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  }
+}