@fatagnus/dink-sdk 2.13.2 → 2.15.0

package/README.md

@@ -81,6 +81,51 @@ const result = await center.call({
 console.log(result); // { temperature: 22.5 }
 ```
 
+## Loading Credentials
+
+Use `loadDinkEnv()` to load credentials from the `.dink/` directory (managed by the `dink env` CLI) with automatic fallback to `DINK_SERVER` / `DINK_API_KEY` environment variables.
+
+> **Note:** This is Node.js only (uses `node:fs`, `node:path`). Available via subpath import `@fatagnus/dink-sdk/env` or from the main entry point.
+
+```typescript
+import { loadDinkEnv } from '@fatagnus/dink-sdk/env';
+import { CenterClient, EdgeClient } from '@fatagnus/dink-sdk';
+
+// Load current environment (from .dink/.current) or fall back to env vars
+const env = await loadDinkEnv();
+
+const center = new CenterClient({ serverUrl: env.server, apiKey: env.apiKey });
+const edge = new EdgeClient({ apiKey: env.apiKey });
+```
+
+Load a specific named environment:
+
+```typescript
+const env = await loadDinkEnv('staging'); // reads .dink/staging.yaml
+```
+
+Credential resolution order:
+1. **Named env** — `.dink/<name>.yaml` (when a name is passed)
+2. **Current env** — `.dink/.current` → `.dink/<current>.yaml`
+3. **Env vars** — `DINK_SERVER` / `DINK_API_KEY` (CI/Docker fallback)
+
+Error handling:
+
+```typescript
+import { DinkEnvError } from '@fatagnus/dink-sdk/env';
+
+try {
+  const env = await loadDinkEnv();
+} catch (e) {
+  if (e instanceof DinkEnvError) {
+    // e.code === 'NO_ENVIRONMENT' — no .dink/ dir and no env vars set
+    // e.code === 'NOT_FOUND'      — named env file missing
+  }
+}
+```
+
+This integrates with `dink env` CLI commands for managing environments. In CI/Docker where no `.dink/` directory exists, set `DINK_SERVER` and `DINK_API_KEY` as environment variables — the same code works without changes.
+
 ## API Key Formats
 
 Dink supports two API key formats for edge authentication:
@@ -188,6 +233,7 @@ You can also import specific clients directly:
 ```typescript
 import { EdgeClient } from '@fatagnus/dink-sdk/edge';
 import { CenterClient } from '@fatagnus/dink-sdk/center';
+import { loadDinkEnv } from '@fatagnus/dink-sdk/env';
 ```
 
 ## Naming Rules

package/dist/env/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Credentials loaded from a .dink/ environment or env vars.
+ */
+export interface DinkEnv {
+    name: string;
+    server: string;
+    apiKey: string;
+    appId: string;
+    syncKey: string;
+}
+/**
+ * Options for loadDinkEnv.
+ */
+export interface LoadOptions {
+    app?: string;
+}
+/**
+ * Error thrown when environment resolution fails.
+ */
+export declare class DinkEnvError extends Error {
+    readonly code: 'NO_ENVIRONMENT' | 'NOT_FOUND';
+    constructor(message: string, code: 'NO_ENVIRONMENT' | 'NOT_FOUND');
+}
+/**
+ * Load Dink credentials.
+ *
+ * Resolution order:
+ * 1. If `name` provided: find `.dink/` dir, read `.dink/<name>.yaml`
+ * 2. If no `name`: find `.dink/` dir, read `.dink/.current` for active env name
+ * 3. Fall back to `DINK_SERVER` / `DINK_API_KEY` environment variables
+ * 4. Throw `DinkEnvError` with code `'NO_ENVIRONMENT'` if nothing found
+ *
+ * App resolution priority:
+ * 1. `options.app` if provided
+ * 2. `DINK_APP_ID` env var
+ * 3. `.current` second line
+ * 4. YAML `default_app`
+ * 5. empty string
+ */
+export declare function loadDinkEnv(name?: string, options?: LoadOptions): Promise<DinkEnv>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/env/index.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAAC;gBAElC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,WAAW;CAKlE;AAuID;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,OAAO,CAAC,CAmClB"}

package/dist/env/index.js

@@ -0,0 +1,225 @@
+import { readFile, stat } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+/**
+ * Error thrown when environment resolution fails.
+ */
+export class DinkEnvError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'DinkEnvError';
+        this.code = code;
+    }
+}
+/**
+ * Walk up from cwd looking for a .dink/ directory.
+ * Returns the absolute path to the .dink/ dir, or null if none found.
+ */
+async function findDinkDir() {
+    let dir = process.cwd();
+    for (;;) {
+        const candidate = join(dir, '.dink');
+        try {
+            const info = await stat(candidate);
+            if (info.isDirectory()) {
+                return candidate;
+            }
+        }
+        catch {
+            // not found, keep walking
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            // Reached filesystem root.
+            return null;
+        }
+        dir = parent;
+    }
+}
+/**
+ * Parse a trivial YAML file containing `server`, `api_key`, `default_app`,
+ * and an optional `apps:` section.
+ * No dependency — files are always simple key: value pairs with one level of nesting for apps.
+ */
+function parseEnvYaml(content) {
+    const serverMatch = content.match(/^server:\s*["']?(.*?)["']?\s*$/m);
+    const apiKeyMatch = content.match(/^api_key:\s*["']?(.*?)["']?\s*$/m);
+    const defaultAppMatch = content.match(/^default_app:\s*["']?(.*?)["']?\s*$/m);
+    const server = serverMatch ? serverMatch[1] : '';
+    const apiKey = apiKeyMatch ? apiKeyMatch[1] : '';
+    const defaultApp = defaultAppMatch ? defaultAppMatch[1] : '';
+    const apps = parseAppsSection(content);
+    return { server, apiKey, defaultApp, apps };
+}
+/**
+ * Parse the `apps:` section from YAML content.
+ * Handles the known two-level structure only:
+ *
+ *   apps:
+ *     app-name:
+ *       api_key: xxx
+ *       sync_key: yyy
+ *
+ * Uses indent-aware line parsing. NOT a full YAML parser.
+ */
+function parseAppsSection(content) {
+    const result = {};
+    const lines = content.split('\n');
+    // Find the `apps:` line at column 0
+    let i = 0;
+    for (; i < lines.length; i++) {
+        if (/^apps:\s*$/.test(lines[i])) {
+            i++;
+            break;
+        }
+    }
+    if (i >= lines.length)
+        return result;
+    // Parse app entries — each app name is indented (typically 2 spaces / 1 tab)
+    let currentApp = '';
+    for (; i < lines.length; i++) {
+        const line = lines[i];
+        // Blank line or comment — skip
+        if (/^\s*$/.test(line) || /^\s*#/.test(line))
+            continue;
+        // Non-indented line — we've left the apps block
+        if (/^\S/.test(line))
+            break;
+        // App name line: indented, ends with ':'
+        const appNameMatch = line.match(/^[ \t]+([^\s:]+):\s*$/);
+        if (appNameMatch) {
+            currentApp = appNameMatch[1];
+            result[currentApp] = { apiKey: '', syncKey: '' };
+            continue;
+        }
+        // Property line inside an app (deeper indent)
+        if (currentApp) {
+            const propMatch = line.match(/^[ \t]+([a-z_]+):\s*["']?(.*?)["']?\s*$/);
+            if (propMatch) {
+                const [, key, value] = propMatch;
+                if (key === 'api_key') {
+                    result[currentApp].apiKey = value;
+                }
+                else if (key === 'sync_key') {
+                    result[currentApp].syncKey = value;
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Read the .dink/.current file.
+ * New format: line 1 = envName, line 2 (optional) = appName.
+ * Old format: single trimmed line = envName.
+ */
+async function readCurrentContext(dinkDir) {
+    try {
+        const data = await readFile(join(dinkDir, '.current'), 'utf-8');
+        const lines = data.split('\n');
+        const envName = (lines[0] ?? '').trim();
+        const appName = (lines[1] ?? '').trim();
+        if (!envName)
+            return null;
+        return { envName, appName };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load Dink credentials.
+ *
+ * Resolution order:
+ * 1. If `name` provided: find `.dink/` dir, read `.dink/<name>.yaml`
+ * 2. If no `name`: find `.dink/` dir, read `.dink/.current` for active env name
+ * 3. Fall back to `DINK_SERVER` / `DINK_API_KEY` environment variables
+ * 4. Throw `DinkEnvError` with code `'NO_ENVIRONMENT'` if nothing found
+ *
+ * App resolution priority:
+ * 1. `options.app` if provided
+ * 2. `DINK_APP_ID` env var
+ * 3. `.current` second line
+ * 4. YAML `default_app`
+ * 5. empty string
+ */
+export async function loadDinkEnv(name, options) {
+    const dinkDir = await findDinkDir();
+    // If a name is explicitly provided, we require a .dink/ directory.
+    if (name !== undefined) {
+        if (!dinkDir) {
+            throw new DinkEnvError(`no .dink/ directory found while looking for environment "${name}"`, 'NOT_FOUND');
+        }
+        return loadFromFile(dinkDir, name, options);
+    }
+    // Try .dink/.current
+    if (dinkDir) {
+        const ctx = await readCurrentContext(dinkDir);
+        if (ctx) {
+            return loadFromFile(dinkDir, ctx.envName, options, ctx.appName);
+        }
+    }
+    // Fall back to env vars
+    const server = process.env['DINK_SERVER'];
+    const apiKey = process.env['DINK_API_KEY'];
+    if (server) {
+        const appId = resolveAppId(options?.app, '', '');
+        const syncKey = process.env['DINK_APP_SYNC_KEY'] ?? '';
+        return { name: '', server, apiKey: apiKey ?? '', appId, syncKey };
+    }
+    throw new DinkEnvError('no dink environment found: no .dink/ directory, no .current file, and DINK_SERVER is not set', 'NO_ENVIRONMENT');
+}
+/**
+ * Resolve appId from the priority chain.
+ * 1. options.app
+ * 2. DINK_APP_ID env var
+ * 3. currentAppName (from .current second line)
+ * 4. YAML default_app
+ * 5. empty string
+ */
+function resolveAppId(optionApp, currentAppName, yamlDefaultApp) {
+    if (optionApp)
+        return optionApp;
+    const envAppId = process.env['DINK_APP_ID'];
+    if (envAppId)
+        return envAppId;
+    if (currentAppName)
+        return currentAppName;
+    if (yamlDefaultApp)
+        return yamlDefaultApp;
+    return '';
+}
+/**
+ * Load and validate a named environment file from `.dink/<name>.yaml`.
+ */
+async function loadFromFile(dinkDir, name, options, currentAppName) {
+    const filePath = join(dinkDir, `${name}.yaml`);
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch {
+        throw new DinkEnvError(`environment "${name}" not found (expected ${filePath})`, 'NOT_FOUND');
+    }
+    const { server, apiKey, defaultApp, apps } = parseEnvYaml(content);
+    if (!server) {
+        throw new Error(`environment "${name}": server field is empty or missing`);
+    }
+    const appId = resolveAppId(options?.app, currentAppName ?? '', defaultApp);
+    // If the resolved app has its own api_key in the apps section, use it
+    let resolvedApiKey = apiKey;
+    let syncKey = '';
+    if (appId && apps[appId]) {
+        const appConfig = apps[appId];
+        if (appConfig.apiKey) {
+            resolvedApiKey = appConfig.apiKey;
+        }
+        syncKey = appConfig.syncKey;
+    }
+    // Env var fallback for sync key
+    if (!syncKey) {
+        syncKey = process.env['DINK_APP_SYNC_KEY'] ?? '';
+    }
+    return { name, server, apiKey: resolvedApiKey, appId, syncKey };
+}
+//# sourceMappingURL=index.js.map

package/dist/env/index.js.map

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

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export { extractPayload, wrapResponse } from './types.js';
 export { EdgeClient, parseEdgeKey, type ParsedEdgeKey } from './edge/client.js';
 export { ServiceBuilder } from './edge/service-builder.js';
 export { CenterClient } from './center/index.js';
+export { loadDinkEnv, DinkEnvError, type DinkEnv, type LoadOptions } from './env/index.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"}
+{"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"}

package/dist/index.js

@@ -7,4 +7,6 @@ export { EdgeClient, parseEdgeKey } from './edge/client.js';
 export { ServiceBuilder } from './edge/service-builder.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';
 //# 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"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatagnus/dink-sdk",
-  "version": "2.13.2",
+  "version": "2.15.0",
   "description": "TypeScript SDK for Dink edge mesh platform",
   "type": "module",
   "main": "dist/index.js",
@@ -21,6 +21,10 @@
     "./center": {
       "types": "./dist/center/index.d.ts",
       "import": "./dist/center/index.js"
+    },
+    "./env": {
+      "types": "./dist/env/index.d.ts",
+      "import": "./dist/env/index.js"
     }
   },
   "scripts": {