@bind-protocol/sdk 0.2.0

package/dist/core/index.js

@@ -0,0 +1,203 @@
+// src/core/errors.ts
+var BindError = class extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "BindError";
+  }
+};
+var ApiError = class extends BindError {
+  constructor(message, status, response) {
+    super(message, "API_ERROR", { status, response });
+    this.status = status;
+    this.response = response;
+    this.name = "ApiError";
+  }
+};
+var AuthenticationError = class extends BindError {
+  constructor(message = "Authentication failed") {
+    super(message, "AUTH_ERROR");
+    this.name = "AuthenticationError";
+  }
+};
+var TimeoutError = class extends BindError {
+  constructor(message, timeoutMs) {
+    super(message, "TIMEOUT_ERROR", { timeoutMs });
+    this.timeoutMs = timeoutMs;
+    this.name = "TimeoutError";
+  }
+};
+var InsufficientCreditsError = class extends BindError {
+  constructor(required, available) {
+    super(
+      `Insufficient credits: need ${required}, have ${available}`,
+      "INSUFFICIENT_CREDITS",
+      { required, available }
+    );
+    this.required = required;
+    this.available = available;
+    this.name = "InsufficientCreditsError";
+  }
+};
+
+// src/core/client.ts
+var DEFAULT_BASE_URL = "https://api.bindprotocol.com";
+var DEFAULT_POLL_INTERVAL_MS = 2e3;
+var DEFAULT_TIMEOUT_MS = 3e5;
+var BindClient = class {
+  apiKey;
+  baseUrl;
+  headers;
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl || process.env.BIND_API_URL || DEFAULT_BASE_URL;
+    this.headers = {
+      "X-API-Key": this.apiKey,
+      "Content-Type": "application/json"
+    };
+  }
+  // ==========================================================================
+  // Prove Job Methods
+  // ==========================================================================
+  /**
+   * Submit a prove job for async processing
+   * @param circuitId - The circuit identifier (e.g., "bind.mobility.riskband.v1")
+   * @param inputs - Circuit inputs as key-value pairs (all values must be strings)
+   * @returns The submitted job details
+   * @throws {ApiError} If the API request fails
+   * @throws {InsufficientCreditsError} If there aren't enough credits
+   */
+  async submitProveJob(circuitId, inputs) {
+    const response = await this.fetch("/api/prove", {
+      method: "POST",
+      body: JSON.stringify({ circuitId, inputs })
+    });
+    const result = await response.json();
+    if (!result.success && result.requiredCredits !== void 0 && result.availableCredits !== void 0) {
+      throw new InsufficientCreditsError(result.requiredCredits, result.availableCredits);
+    }
+    return result;
+  }
+  /**
+   * Get the status and results of a prove job
+   * @param jobId - The unique job identifier
+   * @returns The job details including status and outputs
+   */
+  async getProveJob(jobId) {
+    const response = await this.fetch(`/api/prove/${encodeURIComponent(jobId)}`);
+    return response.json();
+  }
+  /**
+   * List prove jobs for the authenticated organization
+   * @param options - Optional filters for status, limit, and offset
+   * @returns Paginated list of prove jobs
+   */
+  async listProveJobs(options = {}) {
+    const params = new URLSearchParams();
+    if (options.status) params.set("status", options.status);
+    if (options.limit !== void 0) params.set("limit", options.limit.toString());
+    if (options.offset !== void 0) params.set("offset", options.offset.toString());
+    const queryString = params.toString();
+    const path = queryString ? `/api/prove?${queryString}` : "/api/prove";
+    const response = await this.fetch(path);
+    return response.json();
+  }
+  /**
+   * Poll for prove job completion
+   * @param jobId - The unique job identifier
+   * @param options - Polling options
+   * @returns The completed or failed job
+   * @throws {TimeoutError} If the job doesn't complete within the timeout
+   */
+  async waitForProveJob(jobId, options = {}) {
+    const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+      const result = await this.getProveJob(jobId);
+      if (!result.success || !result.data) {
+        throw new ApiError(
+          result.error || "Failed to get prove job",
+          500,
+          result
+        );
+      }
+      const job = result.data;
+      if (options.onProgress) {
+        options.onProgress(job);
+      }
+      if (job.status === "completed" || job.status === "failed") {
+        return job;
+      }
+      await this.sleep(intervalMs);
+    }
+    throw new TimeoutError(
+      `Timeout waiting for prove job ${jobId} after ${timeoutMs}ms`,
+      timeoutMs
+    );
+  }
+  // ==========================================================================
+  // Policy Methods (Public, no authentication required)
+  // ==========================================================================
+  /**
+   * List all available public policies
+   * @returns Array of public policy specifications
+   */
+  async listPolicies() {
+    const response = await fetch(`${this.baseUrl}/api/policies`, {
+      method: "GET"
+    });
+    if (!response.ok) {
+      throw new ApiError(
+        `Failed to fetch policies: ${response.statusText}`,
+        response.status
+      );
+    }
+    return response.json();
+  }
+  /**
+   * Get a specific policy by ID
+   * @param policyId - The unique policy identifier
+   * @returns The public policy specification, or null if not found
+   */
+  async getPolicy(policyId) {
+    const response = await fetch(
+      `${this.baseUrl}/api/policies/${encodeURIComponent(policyId)}`,
+      { method: "GET" }
+    );
+    if (response.status === 404) {
+      return null;
+    }
+    if (!response.ok) {
+      throw new ApiError(
+        `Failed to fetch policy: ${response.statusText}`,
+        response.status
+      );
+    }
+    return response.json();
+  }
+  // ==========================================================================
+  // Private Helpers
+  // ==========================================================================
+  async fetch(path, init) {
+    const response = await fetch(`${this.baseUrl}${path}`, {
+      ...init,
+      headers: {
+        ...this.headers,
+        ...init?.headers
+      }
+    });
+    if (response.status === 401) {
+      throw new AuthenticationError();
+    }
+    return response;
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+export { ApiError, AuthenticationError, BindClient, BindError, InsufficientCreditsError, TimeoutError };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/errors.ts","../../src/core/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Custom error classes for the Bind Protocol SDK\n */\n\nexport class BindError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly details?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'BindError';\n  }\n}\n\nexport class ApiError extends BindError {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly response?: unknown\n  ) {\n    super(message, 'API_ERROR', { status, response });\n    this.name = 'ApiError';\n  }\n}\n\nexport class AuthenticationError extends BindError {\n  constructor(message = 'Authentication failed') {\n    super(message, 'AUTH_ERROR');\n    this.name = 'AuthenticationError';\n  }\n}\n\nexport class TimeoutError extends BindError {\n  constructor(message: string, public readonly timeoutMs: number) {\n    super(message, 'TIMEOUT_ERROR', { timeoutMs });\n    this.name = 'TimeoutError';\n  }\n}\n\nexport class InsufficientCreditsError extends BindError {\n  constructor(\n    public readonly required: number,\n    public readonly available: number\n  ) {\n    super(\n      `Insufficient credits: need ${required}, have ${available}`,\n      'INSUFFICIENT_CREDITS',\n      { required, available }\n    );\n    this.name = 'InsufficientCreditsError';\n  }\n}\n","/**\n * BindClient - Main client for interacting with the Bind Protocol API\n */\nimport type { PublicPolicySpec } from '@bind-protocol/policy-spec';\nimport {\n  ApiError,\n  AuthenticationError,\n  InsufficientCreditsError,\n  TimeoutError,\n} from './errors';\nimport type {\n  BindClientOptions,\n  ProveJobInputs,\n  SubmitProveJobResponse,\n  GetProveJobResponse,\n  ListProveJobsOptions,\n  ListProveJobsResponse,\n  ProveJob,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.bindprotocol.com';\nconst DEFAULT_POLL_INTERVAL_MS = 2000;\nconst DEFAULT_TIMEOUT_MS = 300000; // 5 minutes\n\nexport class BindClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly headers: Record<string, string>;\n\n  constructor(options: BindClientOptions) {\n    this.apiKey = options.apiKey;\n    this.baseUrl = options.baseUrl || process.env.BIND_API_URL || DEFAULT_BASE_URL;\n    this.headers = {\n      'X-API-Key': this.apiKey,\n      'Content-Type': 'application/json',\n    };\n  }\n\n  // ==========================================================================\n  // Prove Job Methods\n  // ==========================================================================\n\n  /**\n   * Submit a prove job for async processing\n   * @param circuitId - The circuit identifier (e.g., \"bind.mobility.riskband.v1\")\n   * @param inputs - Circuit inputs as key-value pairs (all values must be strings)\n   * @returns The submitted job details\n   * @throws {ApiError} If the API request fails\n   * @throws {InsufficientCreditsError} If there aren't enough credits\n   */\n  async submitProveJob(\n    circuitId: string,\n    inputs: ProveJobInputs\n  ): Promise<SubmitProveJobResponse> {\n    const response = await this.fetch('/api/prove', {\n      method: 'POST',\n      body: JSON.stringify({ circuitId, inputs }),\n    });\n\n    const result: SubmitProveJobResponse = await response.json();\n\n    // Check for insufficient credits\n    if (!result.success && result.requiredCredits !== undefined && result.availableCredits !== undefined) {\n      throw new InsufficientCreditsError(result.requiredCredits, result.availableCredits);\n    }\n\n    return result;\n  }\n\n  /**\n   * Get the status and results of a prove job\n   * @param jobId - The unique job identifier\n   * @returns The job details including status and outputs\n   */\n  async getProveJob(jobId: string): Promise<GetProveJobResponse> {\n    const response = await this.fetch(`/api/prove/${encodeURIComponent(jobId)}`);\n    return response.json();\n  }\n\n  /**\n   * List prove jobs for the authenticated organization\n   * @param options - Optional filters for status, limit, and offset\n   * @returns Paginated list of prove jobs\n   */\n  async listProveJobs(options: ListProveJobsOptions = {}): Promise<ListProveJobsResponse> {\n    const params = new URLSearchParams();\n    if (options.status) params.set('status', options.status);\n    if (options.limit !== undefined) params.set('limit', options.limit.toString());\n    if (options.offset !== undefined) params.set('offset', options.offset.toString());\n\n    const queryString = params.toString();\n    const path = queryString ? `/api/prove?${queryString}` : '/api/prove';\n\n    const response = await this.fetch(path);\n    return response.json();\n  }\n\n  /**\n   * Poll for prove job completion\n   * @param jobId - The unique job identifier\n   * @param options - Polling options\n   * @returns The completed or failed job\n   * @throws {TimeoutError} If the job doesn't complete within the timeout\n   */\n  async waitForProveJob(\n    jobId: string,\n    options: {\n      intervalMs?: number;\n      timeoutMs?: number;\n      onProgress?: (job: ProveJob) => void;\n    } = {}\n  ): Promise<ProveJob> {\n    const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    const startTime = Date.now();\n\n    while (Date.now() - startTime < timeoutMs) {\n      const result = await this.getProveJob(jobId);\n\n      if (!result.success || !result.data) {\n        throw new ApiError(\n          result.error || 'Failed to get prove job',\n          500,\n          result\n        );\n      }\n\n      const job = result.data;\n\n      if (options.onProgress) {\n        options.onProgress(job);\n      }\n\n      if (job.status === 'completed' || job.status === 'failed') {\n        return job;\n      }\n\n      await this.sleep(intervalMs);\n    }\n\n    throw new TimeoutError(\n      `Timeout waiting for prove job ${jobId} after ${timeoutMs}ms`,\n      timeoutMs\n    );\n  }\n\n  // ==========================================================================\n  // Policy Methods (Public, no authentication required)\n  // ==========================================================================\n\n  /**\n   * List all available public policies\n   * @returns Array of public policy specifications\n   */\n  async listPolicies(): Promise<PublicPolicySpec[]> {\n    const response = await fetch(`${this.baseUrl}/api/policies`, {\n      method: 'GET',\n    });\n\n    if (!response.ok) {\n      throw new ApiError(\n        `Failed to fetch policies: ${response.statusText}`,\n        response.status\n      );\n    }\n\n    return response.json();\n  }\n\n  /**\n   * Get a specific policy by ID\n   * @param policyId - The unique policy identifier\n   * @returns The public policy specification, or null if not found\n   */\n  async getPolicy(policyId: string): Promise<PublicPolicySpec | null> {\n    const response = await fetch(\n      `${this.baseUrl}/api/policies/${encodeURIComponent(policyId)}`,\n      { method: 'GET' }\n    );\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    if (!response.ok) {\n      throw new ApiError(\n        `Failed to fetch policy: ${response.statusText}`,\n        response.status\n      );\n    }\n\n    return response.json();\n  }\n\n  // ==========================================================================\n  // Private Helpers\n  // ==========================================================================\n\n  private async fetch(path: string, init?: RequestInit): Promise<Response> {\n    const response = await fetch(`${this.baseUrl}${path}`, {\n      ...init,\n      headers: {\n        ...this.headers,\n        ...init?.headers,\n      },\n    });\n\n    if (response.status === 401) {\n      throw new AuthenticationError();\n    }\n\n    return response;\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"]}

package/dist/index-5j-fuebC.d.cts

@@ -0,0 +1,155 @@
+import { a as ProveJobInputs } from './types-o4sbOK_a.cjs';
+
+/**
+ * Base types for data source adapters
+ *
+ * Adapters abstract away the data source specifics and provide a uniform
+ * interface for fetching data that can be used as circuit inputs.
+ */
+
+/**
+ * Base interface for all data source adapters
+ * Each adapter knows how to fetch data from a specific source
+ * and transform it into circuit inputs.
+ */
+interface DataAdapter<TConfig = unknown, TQuery = unknown, TData = unknown> {
+    /** Unique identifier for this adapter */
+    readonly id: string;
+    /** Human-readable name */
+    readonly name: string;
+    /** Description of what data source this adapter connects to */
+    readonly description: string;
+    /**
+     * Fetch raw data from the data source
+     * @param query - Adapter-specific query parameters
+     * @returns Raw data from the source
+     */
+    fetchData(query: TQuery): Promise<TData>;
+    /**
+     * Transform raw data into circuit inputs
+     * @param data - Raw data from fetchData
+     * @param circuitId - Target circuit ID (adapters may support multiple circuits)
+     * @returns Inputs ready for prove job submission
+     */
+    toCircuitInputs(data: TData, circuitId: string): ProveJobInputs;
+}
+/**
+ * Adapter registration entry
+ */
+interface AdapterRegistration<TConfig = unknown> {
+    /** Adapter factory function */
+    create: (config: TConfig) => DataAdapter;
+    /** Default configuration */
+    defaultConfig?: Partial<TConfig>;
+    /** Supported circuit IDs */
+    supportedCircuits: string[];
+}
+/**
+ * Common telemetry data structure that adapters can transform their data into
+ */
+interface TelemetryData {
+    /** Array of telemetry signal readings */
+    signals: TelemetrySignal[];
+    /** Timestamp of the data collection period start */
+    periodStart: string;
+    /** Timestamp of the data collection period end */
+    periodEnd: string;
+    /** Subject identifier (e.g., vehicle ID) */
+    subjectId: string;
+}
+/**
+ * Individual telemetry signal reading
+ */
+interface TelemetrySignal {
+    timestamp: string;
+    [key: string]: string | number | boolean | string[] | null;
+}
+
+/**
+ * DIMO Adapter Types
+ */
+/**
+ * Configuration for the DIMO adapter
+ */
+interface DimoAdapterConfig {
+    /** DIMO SDK client instance (from @dimo-network/data-sdk) */
+    dimoClient: DimoClient;
+}
+/**
+ * Query parameters for fetching DIMO telemetry
+ */
+interface DimoQuery {
+    /** Vehicle token ID */
+    vehicleTokenId: string;
+    /** Start date for telemetry range (ISO 8601) */
+    from: string;
+    /** End date for telemetry range (ISO 8601) */
+    to: string;
+}
+/**
+ * Telemetry data structure returned by DIMO API
+ */
+interface DimoTelemetryData {
+    signals: DimoSignal[];
+    timestamp: string;
+}
+/**
+ * Individual DIMO telemetry signal
+ */
+interface DimoSignal {
+    powertrainTransmissionTravelledDistance: number;
+    speed: number;
+    powertrainCombustionEngineSpeed: number;
+    obdEngineLoad: number;
+    obdDTCList: string[];
+    obdRunTime: number;
+    timestamp?: string;
+}
+/**
+ * Minimal interface for DIMO SDK client
+ * This allows us to work with the DIMO SDK without directly depending on it
+ */
+interface DimoClient {
+    telemetry: {
+        query: (graphqlQuery: string) => Promise<DimoTelemetryData>;
+    };
+}
+
+/**
+ * DIMO Adapter
+ *
+ * Fetches vehicle telemetry data from the DIMO network and transforms it
+ * into circuit inputs for Bind Protocol prove jobs.
+ */
+
+declare class DimoAdapter implements DataAdapter<DimoAdapterConfig, DimoQuery, DimoTelemetryData> {
+    readonly id = "dimo";
+    readonly name = "DIMO Network";
+    readonly description = "Fetches vehicle telemetry data from the DIMO decentralized network";
+    private readonly dimoClient;
+    constructor(config: DimoAdapterConfig);
+    /**
+     * Fetch telemetry data from DIMO for a vehicle
+     * @param query - Query parameters including vehicle token ID and date range
+     * @returns Raw telemetry data from DIMO
+     */
+    fetchData(query: DimoQuery): Promise<DimoTelemetryData>;
+    /**
+     * Transform DIMO telemetry data into circuit inputs
+     * @param data - Raw telemetry data from DIMO
+     * @param circuitId - Target circuit ID
+     * @returns Inputs ready for prove job submission
+     */
+    toCircuitInputs(data: DimoTelemetryData, circuitId: string): ProveJobInputs;
+    /**
+     * Get the list of circuits this adapter supports
+     */
+    getSupportedCircuits(): string[];
+    private toRiskBandInputs;
+}
+/**
+ * Factory function to create a DIMO adapter
+ */
+declare function createDimoAdapter(config: DimoAdapterConfig): DimoAdapter;
+
+export { type AdapterRegistration as A, DimoAdapter as D, type TelemetryData as T, type DimoAdapterConfig as a, type DimoQuery as b, createDimoAdapter as c, type DimoTelemetryData as d, type DimoSignal as e, type DimoClient as f, type DataAdapter as g, type TelemetrySignal as h };

package/dist/index-CASjN9Qe.d.ts

@@ -0,0 +1,155 @@
+import { a as ProveJobInputs } from './types-o4sbOK_a.js';
+
+/**
+ * Base types for data source adapters
+ *
+ * Adapters abstract away the data source specifics and provide a uniform
+ * interface for fetching data that can be used as circuit inputs.
+ */
+
+/**
+ * Base interface for all data source adapters
+ * Each adapter knows how to fetch data from a specific source
+ * and transform it into circuit inputs.
+ */
+interface DataAdapter<TConfig = unknown, TQuery = unknown, TData = unknown> {
+    /** Unique identifier for this adapter */
+    readonly id: string;
+    /** Human-readable name */
+    readonly name: string;
+    /** Description of what data source this adapter connects to */
+    readonly description: string;
+    /**
+     * Fetch raw data from the data source
+     * @param query - Adapter-specific query parameters
+     * @returns Raw data from the source
+     */
+    fetchData(query: TQuery): Promise<TData>;
+    /**
+     * Transform raw data into circuit inputs
+     * @param data - Raw data from fetchData
+     * @param circuitId - Target circuit ID (adapters may support multiple circuits)
+     * @returns Inputs ready for prove job submission
+     */
+    toCircuitInputs(data: TData, circuitId: string): ProveJobInputs;
+}
+/**
+ * Adapter registration entry
+ */
+interface AdapterRegistration<TConfig = unknown> {
+    /** Adapter factory function */
+    create: (config: TConfig) => DataAdapter;
+    /** Default configuration */
+    defaultConfig?: Partial<TConfig>;
+    /** Supported circuit IDs */
+    supportedCircuits: string[];
+}
+/**
+ * Common telemetry data structure that adapters can transform their data into
+ */
+interface TelemetryData {
+    /** Array of telemetry signal readings */
+    signals: TelemetrySignal[];
+    /** Timestamp of the data collection period start */
+    periodStart: string;
+    /** Timestamp of the data collection period end */
+    periodEnd: string;
+    /** Subject identifier (e.g., vehicle ID) */
+    subjectId: string;
+}
+/**
+ * Individual telemetry signal reading
+ */
+interface TelemetrySignal {
+    timestamp: string;
+    [key: string]: string | number | boolean | string[] | null;
+}
+
+/**
+ * DIMO Adapter Types
+ */
+/**
+ * Configuration for the DIMO adapter
+ */
+interface DimoAdapterConfig {
+    /** DIMO SDK client instance (from @dimo-network/data-sdk) */
+    dimoClient: DimoClient;
+}
+/**
+ * Query parameters for fetching DIMO telemetry
+ */
+interface DimoQuery {
+    /** Vehicle token ID */
+    vehicleTokenId: string;
+    /** Start date for telemetry range (ISO 8601) */
+    from: string;
+    /** End date for telemetry range (ISO 8601) */
+    to: string;
+}
+/**
+ * Telemetry data structure returned by DIMO API
+ */
+interface DimoTelemetryData {
+    signals: DimoSignal[];
+    timestamp: string;
+}
+/**
+ * Individual DIMO telemetry signal
+ */
+interface DimoSignal {
+    powertrainTransmissionTravelledDistance: number;
+    speed: number;
+    powertrainCombustionEngineSpeed: number;
+    obdEngineLoad: number;
+    obdDTCList: string[];
+    obdRunTime: number;
+    timestamp?: string;
+}
+/**
+ * Minimal interface for DIMO SDK client
+ * This allows us to work with the DIMO SDK without directly depending on it
+ */
+interface DimoClient {
+    telemetry: {
+        query: (graphqlQuery: string) => Promise<DimoTelemetryData>;
+    };
+}
+
+/**
+ * DIMO Adapter
+ *
+ * Fetches vehicle telemetry data from the DIMO network and transforms it
+ * into circuit inputs for Bind Protocol prove jobs.
+ */
+
+declare class DimoAdapter implements DataAdapter<DimoAdapterConfig, DimoQuery, DimoTelemetryData> {
+    readonly id = "dimo";
+    readonly name = "DIMO Network";
+    readonly description = "Fetches vehicle telemetry data from the DIMO decentralized network";
+    private readonly dimoClient;
+    constructor(config: DimoAdapterConfig);
+    /**
+     * Fetch telemetry data from DIMO for a vehicle
+     * @param query - Query parameters including vehicle token ID and date range
+     * @returns Raw telemetry data from DIMO
+     */
+    fetchData(query: DimoQuery): Promise<DimoTelemetryData>;
+    /**
+     * Transform DIMO telemetry data into circuit inputs
+     * @param data - Raw telemetry data from DIMO
+     * @param circuitId - Target circuit ID
+     * @returns Inputs ready for prove job submission
+     */
+    toCircuitInputs(data: DimoTelemetryData, circuitId: string): ProveJobInputs;
+    /**
+     * Get the list of circuits this adapter supports
+     */
+    getSupportedCircuits(): string[];
+    private toRiskBandInputs;
+}
+/**
+ * Factory function to create a DIMO adapter
+ */
+declare function createDimoAdapter(config: DimoAdapterConfig): DimoAdapter;
+
+export { type AdapterRegistration as A, DimoAdapter as D, type TelemetryData as T, type DimoAdapterConfig as a, type DimoQuery as b, createDimoAdapter as c, type DimoTelemetryData as d, type DimoSignal as e, type DimoClient as f, type DataAdapter as g, type TelemetrySignal as h };