@fatagnus/dink-web 0.1.0

package/README.md

@@ -0,0 +1,133 @@
+# @fatagnus/dink-web
+
+Browser SDK for connecting to [dinkd](https://github.com/ozanturksever/dink) via NATS WebSocket.
+
+## Install
+
+```bash
+npm install @fatagnus/dink-web
+```
+
+## Quick Start
+
+```typescript
+import { DinkWebClient } from '@fatagnus/dink-web';
+
+const client = new DinkWebClient({
+  url: 'wss://dinkd.example.com:9222',
+  token: 'dk_dev_wb_...',
+  appId: 'my-app',
+});
+
+await client.connect();
+
+// Call an edge service
+const result = await client.call('edge-1', 'SensorService', 'ReadTemperature', {
+  sensorId: 'temp-1',
+});
+
+// Call a center (cloud) service
+const user = await client.callCenter('UserService', 'GetProfile', { userId: '123' });
+
+// Subscribe to streaming updates
+const sub = await client.subscribe(
+  'edge-1', 'SensorService', 'WatchTemperature',
+  { sensorId: 'temp-1' },
+  (update) => console.log('Temperature:', update),
+);
+
+// Later
+sub.unsubscribe();
+await client.close();
+```
+
+## Token Refresh
+
+Web tokens expire (default 1 hour, max 24 hours). The SDK can auto-refresh them:
+
+```typescript
+const client = new DinkWebClient({
+  url: 'wss://dinkd.example.com:9222',
+  token: initialToken,
+  expiresAt: initialExpiresAt,
+  appId: 'my-app',
+
+  // Called 1 minute before expiry (configurable via refreshBeforeExpiryMs)
+  tokenRefresher: async () => {
+    const resp = await fetch('/api/keys/web-token', {
+      method: 'POST',
+      headers: { 'X-API-Key': backendApiKey },
+      body: JSON.stringify({ app_id: 'my-app' }),
+    });
+    return resp.json(); // { token, ws_url, expires_at }
+  },
+});
+```
+
+The client will drain the old connection and reconnect with the new token seamlessly.
+
+## Connection Quality
+
+```typescript
+// Check stats at any time
+const { status, reconnectCount, rttMs, tokenExpiresAt } = client.stats;
+console.log(`RTT: ${rttMs}ms, reconnects: ${reconnectCount}`);
+
+// React to status changes
+const client = new DinkWebClient({
+  // ...
+  onStatusChange: (status) => {
+    if (status === 'error') showOfflineBanner();
+    if (status === 'connected') hideOfflineBanner();
+  },
+});
+```
+
+RTT is measured every 30 seconds via NATS flush.
+
+## Generated Clients
+
+Use `dink codegen --output-mode web-client` to generate typed clients:
+
+```typescript
+import { DinkWebClient } from '@fatagnus/dink-web';
+import { SensorServiceClient } from './generated/sensorservice.client';
+
+const client = new DinkWebClient({ url, token, appId });
+await client.connect();
+
+const sensor = new SensorServiceClient('edge-1', client);
+const reading = await sensor.ReadTemperature({ sensorId: 'temp-1' });
+```
+
+## API
+
+### `DinkWebClient`
+
+| Method | Description |
+|--------|-------------|
+| `connect()` | Establish WebSocket connection |
+| `close()` | Drain connection and close |
+| `call(edgeId, service, method, req)` | Request/reply to edge service |
+| `callCenter(service, method, req)` | Request/reply to center service |
+| `subscribe(edgeId, service, method, req, handler)` | Stream from edge service |
+| `service(edgeId, ClientClass)` | Create typed service client |
+| `status` | Current connection status |
+| `stats` | Connection statistics (RTT, reconnects, token expiry) |
+
+### Config
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `url` | `string` | required | WebSocket URL |
+| `token` | `string` | required | Web token |
+| `appId` | `string` | required | App ID |
+| `expiresAt` | `string \| Date` | - | Token expiry (enables auto-refresh) |
+| `timeout` | `number` | 30000 | Request timeout (ms) |
+| `onStatusChange` | `function` | - | Status change callback |
+| `tokenRefresher` | `function` | - | Returns fresh token |
+| `refreshBeforeExpiryMs` | `number` | 60000 | Refresh lead time (ms) |
+
+## License
+
+Apache-2.0

package/dist/client.d.ts

@@ -0,0 +1,57 @@
+import type { DinkWebConfig, ServiceCaller, Subscription, ConnectionStatus, ConnectionStats } from './types.js';
+/**
+ * DinkWebClient connects to dinkd via NATS WebSocket from the browser.
+ * Implements ServiceCaller so generated client code works unchanged.
+ *
+ * Features:
+ * - Auto token refresh before expiry (requires tokenRefresher config)
+ * - Connection quality monitoring (RTT, reconnect count)
+ * - Automatic reconnection (built into nats.ws)
+ * - Center and edge service calls
+ */
+export declare class DinkWebClient implements ServiceCaller {
+    private nc;
+    private config;
+    private _status;
+    private _reconnectCount;
+    private _rttMs;
+    private _tokenExpiresAt;
+    private _refreshTimer;
+    private _rttInterval;
+    constructor(config: DinkWebConfig);
+    get status(): ConnectionStatus;
+    /** Current connection statistics */
+    get stats(): ConnectionStats;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Call an edge service via request/reply.
+     * Subject: edge.{appId}.{edgeId}.services.{service}.{method}
+     */
+    call<Req, Resp>(edgeId: string, service: string, method: string, req: Req): Promise<Resp>;
+    /**
+     * Call a center (cloud) service via request/reply.
+     * Subject: center.{appId}.services.{service}.{method}
+     */
+    callCenter<Req, Resp>(service: string, method: string, req: Req): Promise<Resp>;
+    /**
+     * Subscribe to a streaming edge service.
+     * Subject: edge.{appId}.{edgeId}.services.{service}.{method}.stream
+     */
+    subscribe<Req, Resp>(edgeId: string, service: string, method: string, req: Req, handler: (resp: Resp) => void): Promise<Subscription>;
+    /**
+     * Create a typed service client for an edge.
+     * Usage: const svc = client.service('edge-1', MyServiceClient);
+     */
+    service<T>(edgeId: string, factory: new (edgeId: string, caller: ServiceCaller) => T): T;
+    private scheduleTokenRefresh;
+    private refreshToken;
+    private startRttProbe;
+    private monitorStatus;
+    private stopTimers;
+    private setStatus;
+    private ensureConnected;
+    private encode;
+    private decode;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EAEf,MAAM,YAAY,CAAC;AAKpB;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,aAAa;IAClD,OAAO,CAAC,EAAE,CAA+B;IACzC,OAAO,CAAC,MAAM,CAA2E;IACzF,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,YAAY,CAA+C;gBAEvD,MAAM,EAAE,aAAa;IAQjC,IAAI,MAAM,IAAI,gBAAgB,CAE7B;IAED,oCAAoC;IACpC,IAAI,KAAK,IAAI,eAAe,CAO3B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;OAGG;IACG,IAAI,CAAC,GAAG,EAAE,IAAI,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,GACN,OAAO,CAAC,IAAI,CAAC;IAUhB;;;OAGG;IACG,UAAU,CAAC,GAAG,EAAE,IAAI,EACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,GACN,OAAO,CAAC,IAAI,CAAC;IAUhB;;;OAGG;IACG,SAAS,CAAC,GAAG,EAAE,IAAI,EACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAC3B,OAAO,CAAC,YAAY,CAAC;IAyBxB;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,KAAK,CAAC,GAAG,CAAC;IAMxF,OAAO,CAAC,oBAAoB;YAiBd,YAAY;IAwC1B,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,MAAM;CAGd"}

package/dist/client.js

@@ -0,0 +1,244 @@
+import { connect } from 'nats.ws';
+const DEFAULT_TIMEOUT = 30_000;
+const DEFAULT_REFRESH_BEFORE_EXPIRY_MS = 60_000; // 1 minute before expiry
+/**
+ * DinkWebClient connects to dinkd via NATS WebSocket from the browser.
+ * Implements ServiceCaller so generated client code works unchanged.
+ *
+ * Features:
+ * - Auto token refresh before expiry (requires tokenRefresher config)
+ * - Connection quality monitoring (RTT, reconnect count)
+ * - Automatic reconnection (built into nats.ws)
+ * - Center and edge service calls
+ */
+export class DinkWebClient {
+    nc = null;
+    config;
+    _status = 'connecting';
+    _reconnectCount = 0;
+    _rttMs = null;
+    _tokenExpiresAt = null;
+    _refreshTimer = null;
+    _rttInterval = null;
+    constructor(config) {
+        this.config = { timeout: DEFAULT_TIMEOUT, ...config };
+        if (config.expiresAt) {
+            this._tokenExpiresAt =
+                config.expiresAt instanceof Date ? config.expiresAt : new Date(config.expiresAt);
+        }
+    }
+    get status() {
+        return this._status;
+    }
+    /** Current connection statistics */
+    get stats() {
+        return {
+            status: this._status,
+            reconnectCount: this._reconnectCount,
+            rttMs: this._rttMs,
+            tokenExpiresAt: this._tokenExpiresAt,
+        };
+    }
+    async connect() {
+        this.setStatus('connecting');
+        try {
+            this.nc = await connect({
+                servers: this.config.url,
+                token: this.config.token,
+                maxReconnectAttempts: -1,
+                reconnectTimeWait: 2000,
+            });
+            this.setStatus('connected');
+            this.monitorStatus();
+            this.scheduleTokenRefresh();
+            this.startRttProbe();
+        }
+        catch (err) {
+            this.setStatus('error');
+            throw err;
+        }
+    }
+    async close() {
+        this.stopTimers();
+        if (this.nc) {
+            await this.nc.drain();
+            this.nc = null;
+        }
+        this.setStatus('closed');
+    }
+    /**
+     * Call an edge service via request/reply.
+     * Subject: edge.{appId}.{edgeId}.services.{service}.{method}
+     */
+    async call(edgeId, service, method, req) {
+        this.ensureConnected();
+        const subject = `edge.${this.config.appId}.${edgeId}.services.${service}.${method}`;
+        const payload = this.encode(req);
+        const msg = await this.nc.request(subject, payload, {
+            timeout: this.config.timeout ?? DEFAULT_TIMEOUT,
+        });
+        return this.decode(msg);
+    }
+    /**
+     * Call a center (cloud) service via request/reply.
+     * Subject: center.{appId}.services.{service}.{method}
+     */
+    async callCenter(service, method, req) {
+        this.ensureConnected();
+        const subject = `center.${this.config.appId}.services.${service}.${method}`;
+        const payload = this.encode(req);
+        const msg = await this.nc.request(subject, payload, {
+            timeout: this.config.timeout ?? DEFAULT_TIMEOUT,
+        });
+        return this.decode(msg);
+    }
+    /**
+     * Subscribe to a streaming edge service.
+     * Subject: edge.{appId}.{edgeId}.services.{service}.{method}.stream
+     */
+    async subscribe(edgeId, service, method, req, handler) {
+        this.ensureConnected();
+        const subject = `edge.${this.config.appId}.${edgeId}.services.${service}.${method}.stream`;
+        const inbox = this.nc.subscribe(subject);
+        const payload = this.encode(req);
+        this.nc.publish(subject, payload);
+        (async () => {
+            for await (const msg of inbox) {
+                try {
+                    const resp = this.decode(msg);
+                    handler(resp);
+                }
+                catch {
+                    // Skip malformed messages
+                }
+            }
+        })().catch(() => { });
+        return {
+            unsubscribe: () => {
+                inbox.unsubscribe();
+            },
+        };
+    }
+    /**
+     * Create a typed service client for an edge.
+     * Usage: const svc = client.service('edge-1', MyServiceClient);
+     */
+    service(edgeId, factory) {
+        return new factory(edgeId, this);
+    }
+    // ── Token refresh ───────────────────────────────────────────────
+    scheduleTokenRefresh() {
+        if (!this.config.tokenRefresher || !this._tokenExpiresAt)
+            return;
+        const refreshBeforeMs = this.config.refreshBeforeExpiryMs ?? DEFAULT_REFRESH_BEFORE_EXPIRY_MS;
+        const msUntilExpiry = this._tokenExpiresAt.getTime() - Date.now();
+        const msUntilRefresh = msUntilExpiry - refreshBeforeMs;
+        if (msUntilRefresh <= 0) {
+            // Already past refresh window — refresh immediately
+            this.refreshToken();
+            return;
+        }
+        this._refreshTimer = setTimeout(() => this.refreshToken(), msUntilRefresh);
+    }
+    async refreshToken() {
+        if (!this.config.tokenRefresher)
+            return;
+        try {
+            const resp = await this.config.tokenRefresher();
+            this._tokenExpiresAt = new Date(resp.expires_at);
+            // Reconnect with new token
+            const wasConnected = this._status === 'connected';
+            if (this.nc) {
+                await this.nc.drain();
+                this.nc = null;
+            }
+            this.config.token = resp.token;
+            if (resp.ws_url) {
+                this.config.url = resp.ws_url;
+            }
+            if (wasConnected) {
+                this.nc = await connect({
+                    servers: this.config.url,
+                    token: this.config.token,
+                    maxReconnectAttempts: -1,
+                    reconnectTimeWait: 2000,
+                });
+                this.setStatus('connected');
+                this.monitorStatus();
+            }
+            // Schedule next refresh
+            this.scheduleTokenRefresh();
+        }
+        catch {
+            // Retry in 10 seconds on failure
+            this._refreshTimer = setTimeout(() => this.refreshToken(), 10_000);
+        }
+    }
+    // ── Connection quality ──────────────────────────────────────────
+    startRttProbe() {
+        // Measure RTT every 30s using a NATS flush (round-trip to server)
+        const probe = async () => {
+            if (!this.nc || this._status !== 'connected')
+                return;
+            try {
+                const start = performance.now();
+                await this.nc.flush();
+                this._rttMs = Math.round(performance.now() - start);
+            }
+            catch {
+                this._rttMs = null;
+            }
+        };
+        // Initial probe
+        probe();
+        this._rttInterval = setInterval(probe, 30_000);
+    }
+    // ── Internal ────────────────────────────────────────────────────
+    monitorStatus() {
+        if (!this.nc)
+            return;
+        (async () => {
+            for await (const s of this.nc.status()) {
+                switch (s.type) {
+                    case 'reconnecting':
+                        this.setStatus('reconnecting');
+                        break;
+                    case 'reconnect':
+                        this._reconnectCount++;
+                        this.setStatus('connected');
+                        break;
+                    case 'disconnect':
+                    case 'error':
+                        this.setStatus('error');
+                        break;
+                }
+            }
+        })().catch(() => { });
+    }
+    stopTimers() {
+        if (this._refreshTimer) {
+            clearTimeout(this._refreshTimer);
+            this._refreshTimer = null;
+        }
+        if (this._rttInterval) {
+            clearInterval(this._rttInterval);
+            this._rttInterval = null;
+        }
+    }
+    setStatus(status) {
+        this._status = status;
+        this.config.onStatusChange?.(status);
+    }
+    ensureConnected() {
+        if (!this.nc) {
+            throw new Error('DinkWebClient is not connected. Call connect() first.');
+        }
+    }
+    encode(data) {
+        return new TextEncoder().encode(JSON.stringify(data));
+    }
+    decode(msg) {
+        return JSON.parse(new TextDecoder().decode(msg.data));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { DinkWebClient } from './client.js';
+export type { DinkWebConfig, ServiceCaller, Subscription, ServiceDefinition, ConnectionStatus, ConnectionStats, WebTokenResponse, TokenRefresher, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// @fatagnus/dink-web - Browser SDK for Dink edge mesh via NATS WebSocket
+export { DinkWebClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+export interface ServiceCaller {
+    call<Req, Resp>(edgeId: string, service: string, method: string, req: Req): Promise<Resp>;
+    callCenter<Req, Resp>(service: string, method: string, req: Req): Promise<Resp>;
+    subscribe<Req, Resp>(edgeId: string, service: string, method: string, req: Req, handler: (resp: Resp) => void): Promise<Subscription>;
+}
+export interface Subscription {
+    unsubscribe(): void;
+}
+export interface ServiceDefinition {
+    name: string;
+    version: string;
+    methods: string[];
+}
+/** Response from POST /api/keys/web-token */
+export interface WebTokenResponse {
+    token: string;
+    ws_url: string;
+    expires_at: string;
+}
+/**
+ * Callback that fetches a fresh web token.
+ * Called automatically when the current token is about to expire.
+ * Should POST to /api/keys/web-token and return the response.
+ */
+export type TokenRefresher = () => Promise<WebTokenResponse>;
+export interface DinkWebConfig {
+    /** WebSocket URL (e.g., "wss://host:9222") */
+    url: string;
+    /** Authentication token (from /api/keys/web-token) */
+    token: string;
+    /** Token expiry time (ISO 8601 string or Date). Enables auto-refresh when set with tokenRefresher. */
+    expiresAt?: string | Date;
+    /** App ID for subject routing */
+    appId: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Called when connection state changes */
+    onStatusChange?: (status: ConnectionStatus) => void;
+    /**
+     * Called to obtain a fresh token before the current one expires.
+     * If not set, the client will not auto-refresh tokens.
+     */
+    tokenRefresher?: TokenRefresher;
+    /**
+     * How many ms before expiry to trigger a refresh (default: 60000 = 1 minute).
+     */
+    refreshBeforeExpiryMs?: number;
+}
+export interface ConnectionStats {
+    /** Current connection status */
+    status: ConnectionStatus;
+    /** Number of reconnections since connect() */
+    reconnectCount: number;
+    /** Last measured round-trip time in ms, or null if not yet measured */
+    rttMs: number | null;
+    /** When the current token expires, or null if unknown */
+    tokenExpiresAt: Date | null;
+}
+export type ConnectionStatus = 'connecting' | 'connected' | 'reconnecting' | 'closed' | 'error';
+//# 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":"AAEA,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,SAAS,CAAC,GAAG,EAAE,IAAI,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAC3B,OAAO,CAAC,YAAY,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B,WAAW,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC7B,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,sGAAsG;IACtG,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACpD;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC/B,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yDAAyD;IACzD,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// @fatagnus/dink-web - Shared types for browser SDK
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oDAAoD"}

package/package.json

@@ -0,0 +1,68 @@
+{
+	"name": "@fatagnus/dink-web",
+	"version": "0.1.0",
+	"description": "Browser SDK for Dink edge mesh platform via NATS WebSocket",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./types": {
+			"types": "./dist/types.d.ts",
+			"import": "./dist/types.js"
+		}
+	},
+	"typesVersions": {
+		"*": {
+			"types": ["dist/types.d.ts"]
+		}
+	},
+	"scripts": {
+		"build": "tsc",
+		"clean": "rm -rf dist",
+		"prebuild": "npm run clean",
+		"prepublishOnly": "npm run build",
+		"typecheck": "tsc --noEmit"
+	},
+	"keywords": [
+		"dink",
+		"nats",
+		"websocket",
+		"edge",
+		"browser",
+		"real-time"
+	],
+	"author": "Ozan Turksever",
+	"license": "Apache-2.0",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/ozanturksever/dink.git",
+		"directory": "sdk/web"
+	},
+	"homepage": "https://github.com/ozanturksever/dink#readme",
+	"bugs": {
+		"url": "https://github.com/ozanturksever/dink/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": false,
+	"dependencies": {
+		"nats.ws": "^1.29.2"
+	},
+	"devDependencies": {
+		"@types/node": "^20.10.0",
+		"typescript": "^5.3.0"
+	},
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE"
+	]
+}