@fatagnus/dink-sdk 2.26.1 → 2.27.2

package/dist/edgefs/client.d.ts

@@ -0,0 +1,100 @@
+import { NatsConnection } from 'nats';
+import type { FileStat, DirEntry, TreeNode, SearchResult, EditOp, ActorInfo, WriteMode, ChangeEntry, DiffResult, ChangeEvent, WatchOptions, WatchSubscription, PushConfig } from './types.js';
+/**
+ * Options for creating an EdgeFSClient.
+ */
+export interface EdgeFSClientOptions {
+    /** NATS connection to use. */
+    nc: NatsConnection;
+    /** Filesystem identifier. */
+    fsID: string;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeout?: number;
+    /** App ID for change-event subject (required for watch). */
+    appID?: string;
+}
+/**
+ * EdgeFSClient provides a typed TypeScript client for the EdgeFS NATS micro service.
+ *
+ * Each method sends a JSON request to the `edgefs.{Method}` NATS subject and
+ * parses the response, throwing on errors.
+ */
+export declare class EdgeFSClient {
+    private readonly nc;
+    private readonly fsID;
+    private readonly timeout;
+    private readonly appID;
+    constructor(opts: EdgeFSClientOptions);
+    private rpc;
+    /** Get file or directory metadata. */
+    stat(path: string): Promise<FileStat>;
+    /** List entries in a directory, optionally filtered by a glob pattern. */
+    list(path: string, glob?: string): Promise<DirEntry[]>;
+    /** Get a recursive tree of the filesystem starting at `path`. */
+    tree(path: string, depth?: number): Promise<TreeNode>;
+    /** Search file contents by regex pattern. */
+    search(pattern: string, path?: string, glob?: string): Promise<SearchResult[]>;
+    /** Find files matching a glob pattern. */
+    find(glob: string, path?: string): Promise<string[]>;
+    /** Read a file's content. Returns `{ content, size }`. */
+    read(path: string, offset?: number, limit?: number): Promise<{
+        content: string;
+        size: number;
+    }>;
+    /** Read multiple files at once. Returns a map of path to content/error. */
+    readMulti(paths: string[]): Promise<Record<string, {
+        content?: string;
+        size?: number;
+        error?: string;
+    }>>;
+    /** Write content to a file. */
+    write(path: string, content: Uint8Array | string, actor: ActorInfo, opts?: {
+        mode?: WriteMode;
+        message?: string;
+    }): Promise<FileStat>;
+    /** Apply line-based edits to a file. */
+    edit(path: string, edits: EditOp[], actor: ActorInfo, message?: string): Promise<FileStat>;
+    /** Delete a file or directory. */
+    delete(path: string, actor: ActorInfo, recursive?: boolean): Promise<{
+        deleted: boolean;
+    }>;
+    /** Rename (move) a file or directory. */
+    rename(from: string, to: string, actor: ActorInfo): Promise<{
+        renamed: boolean;
+    }>;
+    /** Create a directory. */
+    mkdir(path: string, recursive?: boolean): Promise<{
+        created: boolean;
+    }>;
+    /** Get the change log for a path (or the whole filesystem). */
+    log(path?: string, limit?: number): Promise<ChangeEntry[]>;
+    /** Get a unified diff between two versions of a file. */
+    diff(path: string, versionA: number, versionB: number): Promise<DiffResult>;
+    /** Create a named snapshot of the filesystem. */
+    snapshot(message?: string, actor?: string): Promise<{
+        id: string;
+    }>;
+    /** Restore a file to a previous version. */
+    restore(path: string, version: number, actor: ActorInfo): Promise<FileStat>;
+    /** Configure Convex push sync for a filesystem. */
+    setPushConfig(fsID: string, convexSiteURL: string, pushSecret: string, enabled?: boolean): Promise<{
+        success: boolean;
+    }>;
+    /** Get the current push sync configuration for a filesystem. */
+    getPushConfig(fsID: string): Promise<PushConfig>;
+    /** Remove push sync configuration for a filesystem. */
+    deletePushConfig(fsID: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Watch for filesystem change events via NATS subscription.
+     *
+     * Events are published by the Go service to `edgefs.{appID}.{fsID}.changes`.
+     * Client-side filtering is applied based on the provided options.
+     *
+     * @param handler - Called for each matching change event.
+     * @param opts - Optional filters (path prefix, operation types).
+     * @returns A subscription handle with an `unsubscribe()` method.
+     */
+    watch(handler: (event: ChangeEvent) => void, opts?: WatchOptions): WatchSubscription;
+}

package/dist/edgefs/client.js

@@ -0,0 +1,192 @@
+import { StringCodec } from 'nats';
+const sc = StringCodec();
+/**
+ * EdgeFSClient provides a typed TypeScript client for the EdgeFS NATS micro service.
+ *
+ * Each method sends a JSON request to the `edgefs.{Method}` NATS subject and
+ * parses the response, throwing on errors.
+ */
+export class EdgeFSClient {
+    nc;
+    fsID;
+    timeout;
+    appID;
+    constructor(opts) {
+        this.nc = opts.nc;
+        this.fsID = opts.fsID;
+        this.timeout = opts.timeout ?? 30000;
+        this.appID = opts.appID ?? '';
+    }
+    // ------------------------------------------------------------------
+    // Internal helper
+    // ------------------------------------------------------------------
+    async rpc(method, payload) {
+        const subject = `edgefs.${method}`;
+        const body = { fs: this.fsID, ...payload };
+        const msg = await this.nc.request(subject, sc.encode(JSON.stringify(body)), {
+            timeout: this.timeout,
+        });
+        const resp = JSON.parse(sc.decode(msg.data));
+        if (!resp.success) {
+            const code = resp.error?.code ?? 'unknown';
+            const message = resp.error?.message ?? 'Unknown EdgeFS error';
+            throw new Error(`EdgeFS ${method} failed [${code}]: ${message}`);
+        }
+        return resp.data;
+    }
+    // ------------------------------------------------------------------
+    // Mapping
+    // ------------------------------------------------------------------
+    /** Get file or directory metadata. */
+    async stat(path) {
+        return this.rpc('Stat', { path });
+    }
+    /** List entries in a directory, optionally filtered by a glob pattern. */
+    async list(path, glob) {
+        return this.rpc('List', { path, glob });
+    }
+    /** Get a recursive tree of the filesystem starting at `path`. */
+    async tree(path, depth) {
+        return this.rpc('Tree', { path, depth });
+    }
+    // ------------------------------------------------------------------
+    // Discovery
+    // ------------------------------------------------------------------
+    /** Search file contents by regex pattern. */
+    async search(pattern, path, glob) {
+        return this.rpc('Search', { pattern, path, glob });
+    }
+    /** Find files matching a glob pattern. */
+    async find(glob, path) {
+        return this.rpc('Find', { glob, path });
+    }
+    // ------------------------------------------------------------------
+    // Context (reading)
+    // ------------------------------------------------------------------
+    /** Read a file's content. Returns `{ content, size }`. */
+    async read(path, offset, limit) {
+        return this.rpc('Read', { path, offset, limit });
+    }
+    /** Read multiple files at once. Returns a map of path to content/error. */
+    async readMulti(paths) {
+        return this.rpc('ReadMulti', { paths });
+    }
+    // ------------------------------------------------------------------
+    // Execution (writing)
+    // ------------------------------------------------------------------
+    /** Write content to a file. */
+    async write(path, content, actor, opts) {
+        const raw = typeof content === 'string' ? new TextEncoder().encode(content) : content;
+        // Encode as base64 for JSON transport (Go side expects []byte → base64)
+        const b64 = btoa(String.fromCharCode(...raw));
+        return this.rpc('Write', {
+            path,
+            content: b64,
+            mode: opts?.mode,
+            actor,
+            message: opts?.message,
+        });
+    }
+    /** Apply line-based edits to a file. */
+    async edit(path, edits, actor, message) {
+        return this.rpc('Edit', { path, edits, actor, message });
+    }
+    /** Delete a file or directory. */
+    async delete(path, actor, recursive) {
+        return this.rpc('Delete', { path, actor, recursive });
+    }
+    /** Rename (move) a file or directory. */
+    async rename(from, to, actor) {
+        return this.rpc('Rename', { from, to, actor });
+    }
+    /** Create a directory. */
+    async mkdir(path, recursive) {
+        return this.rpc('Mkdir', { path, recursive });
+    }
+    // ------------------------------------------------------------------
+    // History
+    // ------------------------------------------------------------------
+    /** Get the change log for a path (or the whole filesystem). */
+    async log(path, limit) {
+        return this.rpc('Log', { path, limit });
+    }
+    /** Get a unified diff between two versions of a file. */
+    async diff(path, versionA, versionB) {
+        return this.rpc('Diff', { path, version_a: versionA, version_b: versionB });
+    }
+    /** Create a named snapshot of the filesystem. */
+    async snapshot(message, actor) {
+        return this.rpc('Snapshot', { message, actor });
+    }
+    /** Restore a file to a previous version. */
+    async restore(path, version, actor) {
+        return this.rpc('Restore', { path, version, actor });
+    }
+    // ------------------------------------------------------------------
+    // Reactivity
+    // ------------------------------------------------------------------
+    // ------------------------------------------------------------------
+    // Push Config
+    // ------------------------------------------------------------------
+    /** Configure Convex push sync for a filesystem. */
+    async setPushConfig(fsID, convexSiteURL, pushSecret, enabled = true) {
+        return this.rpc('SetPushConfig', {
+            fs_id: fsID,
+            convex_site_url: convexSiteURL,
+            push_secret: pushSecret,
+            enabled,
+        });
+    }
+    /** Get the current push sync configuration for a filesystem. */
+    async getPushConfig(fsID) {
+        return this.rpc('GetPushConfig', { fs_id: fsID });
+    }
+    /** Remove push sync configuration for a filesystem. */
+    async deletePushConfig(fsID) {
+        return this.rpc('DeletePushConfig', { fs_id: fsID });
+    }
+    /**
+     * Watch for filesystem change events via NATS subscription.
+     *
+     * Events are published by the Go service to `edgefs.{appID}.{fsID}.changes`.
+     * Client-side filtering is applied based on the provided options.
+     *
+     * @param handler - Called for each matching change event.
+     * @param opts - Optional filters (path prefix, operation types).
+     * @returns A subscription handle with an `unsubscribe()` method.
+     */
+    watch(handler, opts) {
+        if (!this.appID) {
+            throw new Error('EdgeFSClient: appID is required for watch()');
+        }
+        const subject = `edgefs.${this.appID}.${this.fsID}.changes`;
+        let sub = null;
+        sub = this.nc.subscribe(subject, {
+            callback: (_err, msg) => {
+                if (_err)
+                    return;
+                try {
+                    const event = JSON.parse(sc.decode(msg.data));
+                    // Client-side filtering
+                    if (opts?.pathPrefix && !event.path.startsWith(opts.pathPrefix)) {
+                        return;
+                    }
+                    if (opts?.operations && opts.operations.length > 0 && !opts.operations.includes(event.operation)) {
+                        return;
+                    }
+                    handler(event);
+                }
+                catch {
+                    // Ignore malformed events
+                }
+            },
+        });
+        return {
+            unsubscribe: () => {
+                sub?.unsubscribe();
+                sub = null;
+            },
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/edgefs/client.js.map

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

package/dist/edgefs/index.d.ts

@@ -0,0 +1,3 @@
+export { EdgeFSClient, type EdgeFSClientOptions } from './client.js';
+export { WriteMode } from './types.js';
+export type { FileStat, DirEntry, TreeNode, SearchResult, EditOp, ActorInfo, ChangeEntry, DiffResult, ChangeEvent, WatchOptions, WatchSubscription, PushConfig, } from './types.js';

package/dist/edgefs/index.js

@@ -0,0 +1,3 @@
+export { EdgeFSClient } from './client.js';
+export { WriteMode } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/edgefs/index.js.map

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

package/dist/edgefs/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Write mode for file operations.
+ */
+export declare enum WriteMode {
+    /** Replace the entire file contents. */
+    Overwrite = 0,
+    /** Append data to the end of the file. */
+    Append = 1
+}
+/**
+ * File or directory metadata.
+ */
+export interface FileStat {
+    path: string;
+    size: number;
+    is_dir: boolean;
+    mode: number;
+    mod_time: string;
+    ino?: number;
+    nlink?: number;
+}
+/**
+ * An entry in a directory listing.
+ */
+export interface DirEntry {
+    name: string;
+    size: number;
+    is_dir: boolean;
+    mode: number;
+}
+/**
+ * A node in a filesystem tree.
+ */
+export interface TreeNode {
+    name: string;
+    path: string;
+    is_dir: boolean;
+    size: number;
+    children?: TreeNode[];
+}
+/**
+ * A match found by a content search.
+ */
+export interface SearchResult {
+    path: string;
+    line: number;
+    content: string;
+}
+/**
+ * A single edit operation (line-based replacement).
+ */
+export interface EditOp {
+    start_line: number;
+    end_line: number;
+    new_text: string;
+}
+/**
+ * Identifies who performed an operation.
+ */
+export interface ActorInfo {
+    id: string;
+    type: string;
+}
+/**
+ * A single version change record for a file.
+ */
+export interface ChangeEntry {
+    id: number;
+    path: string;
+    version: number;
+    operation: string;
+    actor: string;
+    actor_type: string;
+    message?: string;
+    data_hash: string;
+    metadata?: string;
+    created_at: string;
+}
+/**
+ * A unified diff between two versions of a file.
+ */
+export interface DiffResult {
+    path: string;
+    version_a: number;
+    version_b: number;
+    unified: string;
+}
+/**
+ * A filesystem change event published via NATS.
+ */
+export interface ChangeEvent {
+    fs_id: string;
+    path: string;
+    operation: string;
+    actor?: string;
+    actor_type?: string;
+    timestamp: number;
+    content?: string;
+    content_hash?: string;
+    size?: number;
+}
+/**
+ * Options for the watch method.
+ */
+export interface WatchOptions {
+    /** Only receive events for paths matching this prefix. */
+    pathPrefix?: string;
+    /** Only receive events for these operations (e.g., "write", "delete"). */
+    operations?: string[];
+}
+/**
+ * A watch subscription handle.
+ */
+export interface WatchSubscription {
+    unsubscribe(): void;
+}
+/**
+ * Per-filesystem push sync configuration.
+ */
+export interface PushConfig {
+    fs_id: string;
+    convex_site_url: string;
+    push_secret: string;
+    enabled: boolean;
+    created_at: string;
+    updated_at: string;
+}

package/dist/edgefs/types.js

@@ -0,0 +1,13 @@
+// EdgeFS TypeScript SDK types
+// These types mirror the Go types in pkg/edgefs/types.go and pkg/edgefs/history_types.go
+/**
+ * Write mode for file operations.
+ */
+export var WriteMode;
+(function (WriteMode) {
+    /** Replace the entire file contents. */
+    WriteMode[WriteMode["Overwrite"] = 0] = "Overwrite";
+    /** Append data to the end of the file. */
+    WriteMode[WriteMode["Append"] = 1] = "Append";
+})(WriteMode || (WriteMode = {}));
+//# sourceMappingURL=types.js.map

package/dist/edgefs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/edgefs/types.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,yFAAyF;AAEzF;;GAEG;AACH,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACpB,wCAAwC;IACxC,mDAAa,CAAA;IACb,0CAA0C;IAC1C,6CAAU,CAAA;AACX,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 // Generated by dts-bundle-generator v9.5.1
 
+import { NatsConnection } from 'nats';
+
 /**
  * Service definition metadata
  */
@@ -1125,5 +1127,230 @@ export declare class ConfigError extends DinkError {
 export declare class WebhookError extends DinkError {
 	constructor(message: string, code?: string);
 }
+/**
+ * Write mode for file operations.
+ */
+export declare enum WriteMode {
+	/** Replace the entire file contents. */
+	Overwrite = 0,
+	/** Append data to the end of the file. */
+	Append = 1
+}
+/**
+ * File or directory metadata.
+ */
+export interface FileStat {
+	path: string;
+	size: number;
+	is_dir: boolean;
+	mode: number;
+	mod_time: string;
+	ino?: number;
+	nlink?: number;
+}
+/**
+ * An entry in a directory listing.
+ */
+export interface DirEntry {
+	name: string;
+	size: number;
+	is_dir: boolean;
+	mode: number;
+}
+/**
+ * A node in a filesystem tree.
+ */
+export interface TreeNode {
+	name: string;
+	path: string;
+	is_dir: boolean;
+	size: number;
+	children?: TreeNode[];
+}
+/**
+ * A match found by a content search.
+ */
+export interface SearchResult {
+	path: string;
+	line: number;
+	content: string;
+}
+/**
+ * A single edit operation (line-based replacement).
+ */
+export interface EditOp {
+	start_line: number;
+	end_line: number;
+	new_text: string;
+}
+/**
+ * Identifies who performed an operation.
+ */
+export interface ActorInfo {
+	id: string;
+	type: string;
+}
+/**
+ * A single version change record for a file.
+ */
+export interface ChangeEntry {
+	id: number;
+	path: string;
+	version: number;
+	operation: string;
+	actor: string;
+	actor_type: string;
+	message?: string;
+	data_hash: string;
+	metadata?: string;
+	created_at: string;
+}
+/**
+ * A unified diff between two versions of a file.
+ */
+export interface DiffResult {
+	path: string;
+	version_a: number;
+	version_b: number;
+	unified: string;
+}
+/**
+ * A filesystem change event published via NATS.
+ */
+export interface ChangeEvent {
+	fs_id: string;
+	path: string;
+	operation: string;
+	actor?: string;
+	actor_type?: string;
+	timestamp: number;
+	content?: string;
+	content_hash?: string;
+	size?: number;
+}
+/**
+ * Options for the watch method.
+ */
+export interface WatchOptions {
+	/** Only receive events for paths matching this prefix. */
+	pathPrefix?: string;
+	/** Only receive events for these operations (e.g., "write", "delete"). */
+	operations?: string[];
+}
+/**
+ * A watch subscription handle.
+ */
+export interface WatchSubscription {
+	unsubscribe(): void;
+}
+/**
+ * Per-filesystem push sync configuration.
+ */
+export interface PushConfig {
+	fs_id: string;
+	convex_site_url: string;
+	push_secret: string;
+	enabled: boolean;
+	created_at: string;
+	updated_at: string;
+}
+/**
+ * Options for creating an EdgeFSClient.
+ */
+export interface EdgeFSClientOptions {
+	/** NATS connection to use. */
+	nc: NatsConnection;
+	/** Filesystem identifier. */
+	fsID: string;
+	/** Request timeout in milliseconds (default: 30000). */
+	timeout?: number;
+	/** App ID for change-event subject (required for watch). */
+	appID?: string;
+}
+/**
+ * EdgeFSClient provides a typed TypeScript client for the EdgeFS NATS micro service.
+ *
+ * Each method sends a JSON request to the `edgefs.{Method}` NATS subject and
+ * parses the response, throwing on errors.
+ */
+export declare class EdgeFSClient {
+	private readonly nc;
+	private readonly fsID;
+	private readonly timeout;
+	private readonly appID;
+	constructor(opts: EdgeFSClientOptions);
+	private rpc;
+	/** Get file or directory metadata. */
+	stat(path: string): Promise<FileStat>;
+	/** List entries in a directory, optionally filtered by a glob pattern. */
+	list(path: string, glob?: string): Promise<DirEntry[]>;
+	/** Get a recursive tree of the filesystem starting at `path`. */
+	tree(path: string, depth?: number): Promise<TreeNode>;
+	/** Search file contents by regex pattern. */
+	search(pattern: string, path?: string, glob?: string): Promise<SearchResult[]>;
+	/** Find files matching a glob pattern. */
+	find(glob: string, path?: string): Promise<string[]>;
+	/** Read a file's content. Returns `{ content, size }`. */
+	read(path: string, offset?: number, limit?: number): Promise<{
+		content: string;
+		size: number;
+	}>;
+	/** Read multiple files at once. Returns a map of path to content/error. */
+	readMulti(paths: string[]): Promise<Record<string, {
+		content?: string;
+		size?: number;
+		error?: string;
+	}>>;
+	/** Write content to a file. */
+	write(path: string, content: Uint8Array | string, actor: ActorInfo, opts?: {
+		mode?: WriteMode;
+		message?: string;
+	}): Promise<FileStat>;
+	/** Apply line-based edits to a file. */
+	edit(path: string, edits: EditOp[], actor: ActorInfo, message?: string): Promise<FileStat>;
+	/** Delete a file or directory. */
+	delete(path: string, actor: ActorInfo, recursive?: boolean): Promise<{
+		deleted: boolean;
+	}>;
+	/** Rename (move) a file or directory. */
+	rename(from: string, to: string, actor: ActorInfo): Promise<{
+		renamed: boolean;
+	}>;
+	/** Create a directory. */
+	mkdir(path: string, recursive?: boolean): Promise<{
+		created: boolean;
+	}>;
+	/** Get the change log for a path (or the whole filesystem). */
+	log(path?: string, limit?: number): Promise<ChangeEntry[]>;
+	/** Get a unified diff between two versions of a file. */
+	diff(path: string, versionA: number, versionB: number): Promise<DiffResult>;
+	/** Create a named snapshot of the filesystem. */
+	snapshot(message?: string, actor?: string): Promise<{
+		id: string;
+	}>;
+	/** Restore a file to a previous version. */
+	restore(path: string, version: number, actor: ActorInfo): Promise<FileStat>;
+	/** Configure Convex push sync for a filesystem. */
+	setPushConfig(fsID: string, convexSiteURL: string, pushSecret: string, enabled?: boolean): Promise<{
+		success: boolean;
+	}>;
+	/** Get the current push sync configuration for a filesystem. */
+	getPushConfig(fsID: string): Promise<PushConfig>;
+	/** Remove push sync configuration for a filesystem. */
+	deletePushConfig(fsID: string): Promise<{
+		success: boolean;
+	}>;
+	/**
+	 * Watch for filesystem change events via NATS subscription.
+	 *
+	 * Events are published by the Go service to `edgefs.{appID}.{fsID}.changes`.
+	 * Client-side filtering is applied based on the provided options.
+	 *
+	 * @param handler - Called for each matching change event.
+	 * @param opts - Optional filters (path prefix, operation types).
+	 * @returns A subscription handle with an `unsubscribe()` method.
+	 */
+	watch(handler: (event: ChangeEvent) => void, opts?: WatchOptions): WatchSubscription;
+}
 
 export {};

package/dist/index.js

@@ -12,4 +12,6 @@ export { CenterClient } from './center/index.js';
 export { loadDinkEnv, DinkEnvError } from './env/index.js';
 // Export error types
 export { DinkError, ConnectionError, AuthError, ServiceError, TimeoutError, ConfigError, WebhookError } from './errors.js';
+// Export EdgeFS client for filesystem operations on the edge
+export * from './edgefs/index.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;AAuB3E,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,EAAsE,MAAM,kBAAkB,CAAC;AAExH,qEAAqE;AACrE,OAAO,EAAE,YAAY,EAAsB,MAAM,mBAAmB,CAAC;AAErE,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,YAAY,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,2EAA2E;AAuB3E,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,EAAsE,MAAM,kBAAkB,CAAC;AAExH,qEAAqE;AACrE,OAAO,EAAE,YAAY,EAAsB,MAAM,mBAAmB,CAAC;AAErE,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,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1H,6DAA6D;AAC7D,cAAc,mBAAmB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatagnus/dink-sdk",
-  "version": "2.26.1",
+  "version": "2.27.2",
   "description": "TypeScript SDK for Dink edge mesh platform",
   "type": "module",
   "main": "dist/index.js",
@@ -25,6 +25,10 @@
     "./env": {
       "types": "./dist/env/index.d.ts",
       "import": "./dist/env/index.js"
+    },
+    "./edgefs": {
+      "types": "./dist/edgefs/index.d.ts",
+      "import": "./dist/edgefs/index.js"
     }
   },
   "typesVersions": {
@@ -38,6 +42,9 @@
       "env": [
         "dist/env/index.d.ts"
       ],
+      "edgefs": [
+        "dist/edgefs/index.d.ts"
+      ],
       "types": [
         "dist/types.d.ts"
       ]