@fatagnus/dink-sdk 2.17.1 → 2.19.0

package/README.md

@@ -16,7 +16,26 @@ This SDK is for **Lite Edge** - edges that require constant connectivity. For of
 npm install @fatagnus/dink-sdk
 ```
 
-## Quick Start
+## Quick Start (createEdgeWorker)
+
+The fastest way to start an edge service:
+
+```typescript
+import { createEdgeWorker } from '@fatagnus/dink-sdk/edge';
+import { createServices } from './generated/registry.js';
+import { SensorServiceImpl } from './sensor-impl.js';
+
+await createEdgeWorker({
+	services: createServices({ sensor: new SensorServiceImpl() }),
+	labels: { region: 'us-east', type: 'sensor' },
+});
+```
+
+Credentials resolve automatically from `DINK_EDGE_KEY` or `DINK_API_KEY` environment variables. Graceful shutdown on SIGINT/SIGTERM is built-in.
+
+For more control, see the [EdgeClient](#quick-start-edgeclient) section below.
+
+## Quick Start (EdgeClient)
 
 ### Edge Client
 
@@ -81,6 +100,23 @@ const result = await center.call({
 console.log(result); // { temperature: 22.5 }
 ```
 
+### Error Types
+
+Typed errors for structured error handling:
+
+```typescript
+import { ConnectionError, AuthError, ServiceError, TimeoutError, ConfigError } from '@fatagnus/dink-sdk';
+```
+
+| Error | Code | Fields | Use Case |
+|-------|------|--------|----------|
+| `DinkError` | varies | `code` | Base class for all SDK errors |
+| `ConnectionError` | `CONNECTION_ERROR` | | NATS connection issues |
+| `AuthError` | `AUTH_ERROR` | | Invalid/expired/revoked keys |
+| `ServiceError` | `SERVICE_ERROR` | `status`, `service`, `method` | RPC call failures |
+| `TimeoutError` | `TIMEOUT` | `timeoutMs` | Request timeouts |
+| `ConfigError` | `CONFIG_ERROR` | | Missing required configuration |
+
 ### Peer RPC (Edge-to-Edge)
 
 Edges in the same group can call each other's services directly:

package/dist/edge/index.d.ts

@@ -1,3 +1,4 @@
 export { EdgeClient } from './client.js';
 export { ServiceBuilder } from './service-builder.js';
+export { createEdgeWorker, type EdgeWorkerOptions, type EdgeWorkerHandle } from './worker.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/edge/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/edge/index.js

@@ -1,3 +1,4 @@
 export { EdgeClient } from './client.js';
 export { ServiceBuilder } from './service-builder.js';
+export { createEdgeWorker } from './worker.js';
 //# sourceMappingURL=index.js.map

package/dist/edge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/edge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAiD,MAAM,aAAa,CAAC"}

package/dist/edge/worker.d.ts

@@ -0,0 +1,58 @@
+import { EdgeClient } from './client.js';
+import type { ServiceHandler } from '../types.js';
+/**
+ * Options for createEdgeWorker.
+ */
+export interface EdgeWorkerOptions {
+    /** Services to expose. Required, at least one. */
+    services: ServiceHandler[];
+    /** API key. Defaults to process.env.DINK_EDGE_KEY || process.env.DINK_API_KEY */
+    apiKey?: string;
+    /** Server URL. Optional if using new key format with embedded URL. Defaults to process.env.DINK_SERVER_URL */
+    serverUrl?: string;
+    /** Display name for the edge. Defaults to process.env.EDGE_NAME */
+    edgeName?: string;
+    /** Labels for edge discovery */
+    labels?: Record<string, string>;
+    /** Heartbeat interval in ms (default: 30000) */
+    heartbeatInterval?: number;
+    /** Whether to register SIGINT/SIGTERM handlers for graceful shutdown (default: true) */
+    gracefulShutdown?: boolean;
+    /** Callback when connected */
+    onConnected?: (edge: EdgeClient) => void;
+    /** Callback when disconnected */
+    onDisconnected?: () => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+}
+/**
+ * Handle returned by createEdgeWorker for lifecycle control.
+ */
+export interface EdgeWorkerHandle {
+    /** The underlying EdgeClient instance */
+    client: EdgeClient;
+    /** Gracefully shut down the worker */
+    shutdown: () => Promise<void>;
+    /** Promise that resolves when the worker shuts down */
+    done: Promise<void>;
+}
+/**
+ * Create and start an edge worker with minimal configuration.
+ *
+ * Handles credential resolution from environment, connection, service exposure,
+ * signal handling, and graceful shutdown automatically.
+ *
+ * @example
+ * ```typescript
+ * import { createEdgeWorker } from '@fatagnus/dink-sdk/edge'
+ * import { SensorServiceHandler } from './generated/sensorservice.handler.js'
+ * import { SensorServiceImpl } from './sensor-impl.js'
+ *
+ * await createEdgeWorker({
+ *   services: [new SensorServiceHandler(new SensorServiceImpl())],
+ *   labels: { region: 'us-east', type: 'sensor' },
+ * })
+ * ```
+ */
+export declare function createEdgeWorker(options: EdgeWorkerOptions): Promise<EdgeWorkerHandle>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/edge/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/edge/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,QAAQ,EAAE,cAAc,EAAE,CAAA;IAE1B,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,8GAA8G;IAC9G,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE/B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAE1B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;IAExC,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAE3B,wBAAwB;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,yCAAyC;IACzC,MAAM,EAAE,UAAU,CAAA;IAElB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAE7B,uDAAuD;IACvD,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiF5F"}

package/dist/edge/worker.js

@@ -0,0 +1,89 @@
+import { EdgeClient } from './client.js';
+/**
+ * Create and start an edge worker with minimal configuration.
+ *
+ * Handles credential resolution from environment, connection, service exposure,
+ * signal handling, and graceful shutdown automatically.
+ *
+ * @example
+ * ```typescript
+ * import { createEdgeWorker } from '@fatagnus/dink-sdk/edge'
+ * import { SensorServiceHandler } from './generated/sensorservice.handler.js'
+ * import { SensorServiceImpl } from './sensor-impl.js'
+ *
+ * await createEdgeWorker({
+ *   services: [new SensorServiceHandler(new SensorServiceImpl())],
+ *   labels: { region: 'us-east', type: 'sensor' },
+ * })
+ * ```
+ */
+export async function createEdgeWorker(options) {
+    if (!options.services || options.services.length === 0) {
+        throw new Error('At least one service is required');
+    }
+    // Resolve credentials from options or environment
+    const apiKey = options.apiKey
+        || (typeof process !== 'undefined' ? process.env.DINK_EDGE_KEY : undefined)
+        || (typeof process !== 'undefined' ? process.env.DINK_API_KEY : undefined);
+    if (!apiKey) {
+        throw new Error('Edge API key is required. Set DINK_EDGE_KEY or DINK_API_KEY environment variable, '
+            + 'or pass apiKey in options.');
+    }
+    const serverUrl = options.serverUrl
+        || (typeof process !== 'undefined' ? process.env.DINK_SERVER_URL : undefined);
+    const edgeName = options.edgeName
+        || (typeof process !== 'undefined' ? process.env.EDGE_NAME : undefined);
+    const edge = new EdgeClient({
+        apiKey,
+        serverUrl,
+        edgeName,
+        labels: options.labels,
+        heartbeatInterval: options.heartbeatInterval,
+    });
+    // Connect
+    await edge.connect();
+    if (options.onConnected) {
+        options.onConnected(edge);
+    }
+    // Expose all services
+    for (const service of options.services) {
+        await edge.exposeService(service);
+    }
+    // Track connection quality changes for callbacks
+    if (options.onDisconnected || options.onError) {
+        edge.onConnectionQualityChange((quality) => {
+            if (quality.state === 'disconnected' && options.onDisconnected) {
+                options.onDisconnected();
+            }
+        });
+    }
+    // Create shutdown function
+    let shutdownCalled = false;
+    let resolveShutdown;
+    const done = new Promise((resolve) => {
+        resolveShutdown = resolve;
+    });
+    const shutdown = async () => {
+        if (shutdownCalled)
+            return;
+        shutdownCalled = true;
+        try {
+            await edge.disconnect();
+        }
+        catch {
+            // Ignore disconnect errors during shutdown
+        }
+        resolveShutdown();
+    };
+    // Register signal handlers for graceful shutdown
+    const enableSignals = options.gracefulShutdown !== false;
+    if (enableSignals && typeof process !== 'undefined' && process.on) {
+        const handler = () => {
+            shutdown();
+        };
+        process.on('SIGINT', handler);
+        process.on('SIGTERM', handler);
+    }
+    return { client: edge, shutdown, done };
+}
+//# sourceMappingURL=worker.js.map

package/dist/edge/worker.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Base error class for all Dink SDK errors.
+ */
+export declare class DinkError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Connection-related errors (NATS connect, disconnect, timeout).
+ */
+export declare class ConnectionError extends DinkError {
+    constructor(message: string, code?: string);
+}
+/**
+ * Authentication/authorization errors (invalid key, expired, revoked).
+ */
+export declare class AuthError extends DinkError {
+    constructor(message: string, code?: string);
+}
+/**
+ * Service RPC errors with status codes.
+ */
+export declare class ServiceError extends DinkError {
+    readonly status: number;
+    readonly service: string;
+    readonly method: string;
+    constructor(message: string, opts: {
+        status?: number;
+        service?: string;
+        method?: string;
+        code?: string;
+    });
+}
+/**
+ * Timeout errors for requests that exceeded their deadline.
+ */
+export declare class TimeoutError extends DinkError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number);
+}
+/**
+ * Configuration errors (missing required fields, invalid values).
+ */
+export declare class ConfigError extends DinkError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAKzC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA2B;CAI9D;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,SAAS;gBAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAqB;CAIxD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBAEX,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;CAOxG;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;gBAEd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAK9C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,SAAS;gBAC7B,OAAO,EAAE,MAAM;CAI3B"}

package/dist/errors.js

@@ -0,0 +1,65 @@
+/**
+ * Base error class for all Dink SDK errors.
+ */
+export class DinkError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'DinkError';
+        this.code = code;
+    }
+}
+/**
+ * Connection-related errors (NATS connect, disconnect, timeout).
+ */
+export class ConnectionError extends DinkError {
+    constructor(message, code = 'CONNECTION_ERROR') {
+        super(message, code);
+        this.name = 'ConnectionError';
+    }
+}
+/**
+ * Authentication/authorization errors (invalid key, expired, revoked).
+ */
+export class AuthError extends DinkError {
+    constructor(message, code = 'AUTH_ERROR') {
+        super(message, code);
+        this.name = 'AuthError';
+    }
+}
+/**
+ * Service RPC errors with status codes.
+ */
+export class ServiceError extends DinkError {
+    status;
+    service;
+    method;
+    constructor(message, opts) {
+        super(message, opts.code ?? 'SERVICE_ERROR');
+        this.name = 'ServiceError';
+        this.status = opts.status ?? 500;
+        this.service = opts.service ?? '';
+        this.method = opts.method ?? '';
+    }
+}
+/**
+ * Timeout errors for requests that exceeded their deadline.
+ */
+export class TimeoutError extends DinkError {
+    timeoutMs;
+    constructor(message, timeoutMs) {
+        super(message, 'TIMEOUT');
+        this.name = 'TimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Configuration errors (missing required fields, invalid values).
+ */
+export class ConfigError extends DinkError {
+    constructor(message) {
+        super(message, 'CONFIG_ERROR');
+        this.name = 'ConfigError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC1B,IAAI,CAAQ;IAErB,YAAY,OAAe,EAAE,IAAY;QACxC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACjB,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC7C,YAAY,OAAe,EAAE,OAAe,kBAAkB;QAC7D,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC9B,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,SAAS;IACvC,YAAY,OAAe,EAAE,OAAe,YAAY;QACvD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;IACxB,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IACjC,MAAM,CAAQ;IACd,OAAO,CAAQ;IACf,MAAM,CAAQ;IAEvB,YAAY,OAAe,EAAE,IAA2E;QACvG,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC,CAAA;QAC5C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAA;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAA;QACjC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAA;IAChC,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IACjC,SAAS,CAAQ;IAE1B,YAAY,OAAe,EAAE,SAAiB;QAC7C,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QACzB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;CACD;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACzC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAA;QAC9B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC1B,CAAC;CACD"}

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export type { ServiceDefinition, ServiceHandler, ServiceCaller, Subscription, Ke
 export { extractPayload, wrapResponse } from './types.js';
 export { EdgeClient, parseEdgeKey, type ParsedEdgeKey } from './edge/client.js';
 export { ServiceBuilder } from './edge/service-builder.js';
+export { createEdgeWorker, type EdgeWorkerOptions, type EdgeWorkerHandle } from './edge/worker.js';
 export { CenterClient } from './center/index.js';
 export { loadDinkEnv, DinkEnvError, type DinkEnv, type LoadOptions } from './env/index.js';
+export { DinkError, ConnectionError, AuthError, ServiceError, TimeoutError, ConfigError } from './errors.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,YAAY,EAEZ,OAAO,EACP,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,YAAY,EAEZ,OAAO,EACP,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGnG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG3F,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -5,8 +5,11 @@ export { extractPayload, wrapResponse } from './types.js';
 // Export edge client for connecting edge devices to dinkd
 export { EdgeClient, parseEdgeKey } from './edge/client.js';
 export { ServiceBuilder } from './edge/service-builder.js';
+export { createEdgeWorker } from './edge/worker.js';
 // Export center client for connecting to dinkd from the center/cloud
 export { CenterClient } from './center/index.js';
 // Export environment/credential loader (Node.js only)
 export { loadDinkEnv, DinkEnvError } from './env/index.js';
+// Export error types
+export { DinkError, ConnectionError, AuthError, ServiceError, TimeoutError, ConfigError } from './errors.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,2EAA2E;AAiB3E,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,0DAA0D;AAC1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,qEAAqE;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAkC,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,2EAA2E;AAiB3E,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D,0DAA0D;AAC1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAiD,MAAM,kBAAkB,CAAC;AAEnG,qEAAqE;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,sDAAsD;AACtD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAkC,MAAM,gBAAgB,CAAC;AAE3F,qBAAqB;AACrB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatagnus/dink-sdk",
-  "version": "2.17.1",
+  "version": "2.19.0",
   "description": "TypeScript SDK for Dink edge mesh platform",
   "type": "module",
   "main": "dist/index.js",