@atomicmail/agent-skill-openclaw 0.3.24

package/esm/lib/core/shared-assets.js

@@ -0,0 +1,46 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve as resolvePath } from "node:path";
+import { fileURLToPath } from "node:url";
+const moduleDir = dirname(fileURLToPath(globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url));
+function resolveSharedRoot() {
+    let current = moduleDir;
+    for (let depth = 0; depth < 12; depth++) {
+        const candidate = resolvePath(current, "shared");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = resolvePath(current, "..");
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    throw new Error(`Shared asset directory was not found from module path: ${moduleDir}`);
+}
+let cachedSharedRoot;
+export function getSharedRootPath() {
+    if (!cachedSharedRoot)
+        cachedSharedRoot = resolveSharedRoot();
+    return cachedSharedRoot;
+}
+export function readSharedText(relativePath) {
+    const fullPath = resolvePath(getSharedRootPath(), relativePath);
+    return readFileSync(fullPath, "utf-8");
+}
+export function readSharedJson(relativePath) {
+    return JSON.parse(readSharedText(relativePath));
+}
+export function tryReadSharedText(relativePath) {
+    try {
+        return readSharedText(relativePath);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function tryReadSharedJson(relativePath) {
+    try {
+        return readSharedJson(relativePath);
+    }
+    catch {
+        return undefined;
+    }
+}

package/esm/lib/core/types.d.ts

@@ -0,0 +1,2 @@
+export type MaybePromise<R> = R | Promise<R>;
+//# sourceMappingURL=types.d.ts.map

package/esm/lib/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/core/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/esm/lib/core/types.js

@@ -0,0 +1,2 @@
+// Shared type utilities (lib core).
+export {};

package/esm/lib/core/utils.d.ts

@@ -0,0 +1,12 @@
+import type { MaybePromise } from "./types.js";
+export declare function delay(ms: number): Promise<void>;
+export type RetryCfg = {
+    maxTimeoutMs?: number;
+    startTimeoutMs?: number;
+    backoffMul?: number;
+    /** Optional hook before the next retry; must not throw. */
+    onBeforeRetry?: (e: unknown) => MaybePromise<void>;
+};
+/** Retries `fn` on throw with exponential backoff until `maxTimeoutMs` is exceeded. */
+export declare function retry<R>(fn: () => MaybePromise<R>, config: RetryCfg): Promise<R>;
+//# sourceMappingURL=utils.d.ts.map

package/esm/lib/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/core/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;CACpD,CAAC;AAQF,uFAAuF;AACvF,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,EACzB,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/esm/lib/core/utils.js

@@ -0,0 +1,29 @@
+// Small async helpers (delay, exponential backoff retry).
+import { ONE_SEC_MS } from "./consts.js";
+export function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+const defaultCfg = {
+    maxTimeoutMs: ONE_SEC_MS * 32,
+    startTimeoutMs: ONE_SEC_MS,
+    backoffMul: 2,
+};
+/** Retries `fn` on throw with exponential backoff until `maxTimeoutMs` is exceeded. */
+export async function retry(fn, config) {
+    const cfg = { ...defaultCfg, ...config };
+    let curTimeoutMs = cfg.startTimeoutMs;
+    while (true) {
+        try {
+            const res = await fn();
+            return res;
+        }
+        catch (e) {
+            if (cfg.onBeforeRetry)
+                await cfg.onBeforeRetry(e);
+            if (curTimeoutMs > cfg.maxTimeoutMs)
+                throw e;
+            await delay(curTimeoutMs);
+            curTimeoutMs = Math.floor(curTimeoutMs * cfg.backoffMul);
+        }
+    }
+}

package/esm/lib/integrations/create-agent-session.d.ts

@@ -0,0 +1,25 @@
+import { AgentSession } from "../agent/session/agent-session.js";
+import type { CredentialStore } from "../agent/session/agent-credentials-store.js";
+import { type KeyValueStore } from "./key-value-credential-store.js";
+export interface IntegrationEnv {
+    authUrl?: string;
+    apiUrl?: string;
+    scryptSalt?: string;
+}
+export interface CreateAgentSessionInput {
+    store: CredentialStore;
+    env?: IntegrationEnv;
+    apiKey?: string;
+    /** Virtual credential namespace label (for logging / parity). */
+    credentialDir?: string;
+}
+export interface CreateAgentSessionFromKeyValueInput {
+    storage: KeyValueStore;
+    accountId?: string;
+    env?: IntegrationEnv;
+    apiKey?: string;
+    credentialDir?: string;
+}
+export declare function createAgentSession(input: CreateAgentSessionInput): Promise<AgentSession>;
+export declare function createAgentSessionFromKeyValue(input: CreateAgentSessionFromKeyValueInput): Promise<AgentSession>;
+//# sourceMappingURL=create-agent-session.d.ts.map

package/esm/lib/integrations/create-agent-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-session.d.ts","sourceRoot":"","sources":["../../../src/lib/integrations/create-agent-session.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,eAAe,CAAC;IACvB,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAcD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,mCAAmC,GACzC,OAAO,CAAC,YAAY,CAAC,CAUvB"}

package/esm/lib/integrations/create-agent-session.js

@@ -0,0 +1,36 @@
+// Create AgentSession for integration hosts (Activepieces, Dify-style runtimes).
+import { DEFAULT_API_URL, DEFAULT_AUTH_URL, DEFAULT_POW_SCRYPT_SALT_HEX, } from "../core/consts.js";
+import { AgentSession } from "../agent/session/agent-session.js";
+import { KeyValueCredentialStore, } from "./key-value-credential-store.js";
+function resolveIntegrationEnv(env) {
+    return {
+        authUrl: (env?.authUrl ?? DEFAULT_AUTH_URL).replace(/\/+$/, ""),
+        apiUrl: (env?.apiUrl ?? DEFAULT_API_URL).replace(/\/+$/, ""),
+        scryptSalt: env?.scryptSalt ?? DEFAULT_POW_SCRYPT_SALT_HEX,
+    };
+}
+export async function createAgentSession(input) {
+    const resolved = resolveIntegrationEnv(input.env);
+    const loaded = await input.store.load();
+    const creds = loaded.credentials;
+    return AgentSession.create({
+        authUrl: creds?.authUrl ?? resolved.authUrl,
+        apiUrl: creds?.apiUrl ?? resolved.apiUrl,
+        scryptSalt: creds?.scryptSalt ?? resolved.scryptSalt,
+        apiKey: input.apiKey ?? creds?.apiKey,
+        inboxId: creds?.inboxId,
+        credentialDir: input.credentialDir ?? "integration://default",
+        store: input.store,
+    });
+}
+export async function createAgentSessionFromKeyValue(input) {
+    const accountId = input.accountId ?? "default";
+    const store = new KeyValueCredentialStore(input.storage, accountId);
+    return createAgentSession({
+        store,
+        env: input.env,
+        apiKey: input.apiKey,
+        credentialDir: input.credentialDir ??
+            `integration://account/${accountId}`,
+    });
+}

package/esm/lib/integrations/key-value-credential-store.d.ts

@@ -0,0 +1,21 @@
+import { type CredentialArtifacts, type CredentialStore } from "../agent/session/agent-credentials-store.js";
+export interface KeyValueStore {
+    get(key: string): Promise<string | undefined>;
+    set(key: string, value: string): Promise<void>;
+    delete(key: string): Promise<void>;
+    has?(key: string): Promise<boolean>;
+}
+export declare class KeyValueCredentialStore implements CredentialStore {
+    private readonly storage;
+    private readonly accountId;
+    constructor(storage: KeyValueStore, accountId?: string);
+    private key;
+    private get credentialsKey();
+    private get sessionKey();
+    private get capabilityKey();
+    private exists;
+    load(): Promise<CredentialArtifacts>;
+    save(artifacts: CredentialArtifacts): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=key-value-credential-store.d.ts.map

package/esm/lib/integrations/key-value-credential-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-value-credential-store.d.ts","sourceRoot":"","sources":["../../../src/lib/integrations/key-value-credential-store.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EAIrB,MAAM,6CAA6C,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,uBAAwB,YAAW,eAAe;IAE3D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,OAAO,EAAE,aAAa,EACtB,SAAS,SAAY;IAGxC,OAAO,CAAC,GAAG;IAIX,OAAO,KAAK,cAAc,GAEzB;IAED,OAAO,KAAK,UAAU,GAErB;IAED,OAAO,KAAK,aAAa,GAExB;YAEa,MAAM;IAQd,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAwBpC,IAAI,CAAC,SAAS,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}

package/esm/lib/integrations/key-value-credential-store.js

@@ -0,0 +1,71 @@
+// Credential persistence backed by a host-provided key-value store (Dify, Activepieces, …).
+import { parseCredentialsJson, serializeCredentials, } from "../agent/session/agent-credentials-store.js";
+export class KeyValueCredentialStore {
+    storage;
+    accountId;
+    constructor(storage, accountId = "default") {
+        this.storage = storage;
+        this.accountId = accountId;
+    }
+    key(suffix) {
+        return `account:${this.accountId}:${suffix}`;
+    }
+    get credentialsKey() {
+        return this.key("credentials.json");
+    }
+    get sessionKey() {
+        return this.key("session.jwt");
+    }
+    get capabilityKey() {
+        return this.key("capability.jwt");
+    }
+    async exists(key) {
+        if (this.storage.has) {
+            return this.storage.has(key);
+        }
+        const value = await this.storage.get(key);
+        return value !== undefined;
+    }
+    async load() {
+        let credentials;
+        const rawCredentials = await this.storage.get(this.credentialsKey);
+        if (rawCredentials) {
+            try {
+                credentials = parseCredentialsJson(rawCredentials, this.credentialsKey);
+            }
+            catch {
+                credentials = undefined;
+            }
+        }
+        const sessionJwt = await this.storage.get(this.sessionKey);
+        const capabilityJwt = await this.storage.get(this.capabilityKey);
+        return {
+            credentials,
+            sessionJwt,
+            capabilityJwt,
+        };
+    }
+    async save(artifacts) {
+        if (artifacts.credentials !== undefined) {
+            await this.storage.set(this.credentialsKey, serializeCredentials(artifacts.credentials));
+        }
+        if (artifacts.sessionJwt !== undefined) {
+            await this.storage.set(this.sessionKey, artifacts.sessionJwt);
+        }
+        if (artifacts.capabilityJwt !== undefined) {
+            await this.storage.set(this.capabilityKey, artifacts.capabilityJwt);
+        }
+    }
+    async clear() {
+        for (const key of [this.credentialsKey, this.sessionKey, this.capabilityKey]) {
+            try {
+                if (await this.exists(key)) {
+                    await this.storage.delete(key);
+                }
+            }
+            catch {
+                // non-fatal
+            }
+        }
+    }
+}

package/esm/lib/integrations/n8n-credential-store.d.ts

@@ -0,0 +1,18 @@
+import type { CredentialStore } from "../agent/session/agent-credentials-store.js";
+/** Host-provided backend (n8n static data object, custom adapter, …). */
+export interface N8nKeyValueBackend {
+    get(key: string): Promise<string | undefined> | string | undefined;
+    set(key: string, value: string): Promise<void> | void;
+    delete(key: string): Promise<void> | void;
+    has?(key: string): Promise<boolean> | boolean;
+}
+/**
+ * Wrap n8n host storage as a CredentialStore.
+ * Keys: `atomicmail:{accountId}:account:{accountId}:credentials.json`, etc.
+ */
+export declare function createN8nCredentialStore(backend: N8nKeyValueBackend, accountId?: string): CredentialStore;
+/** Alias for integration hosts that expect a generic factory name. */
+export declare const createKeyValueStore: typeof createN8nCredentialStore;
+/** Adapter for n8n `getWorkflowStaticData()`-style object storage. */
+export declare function n8nStaticDataBackend(data: Record<string, unknown>): N8nKeyValueBackend;
+//# sourceMappingURL=n8n-credential-store.d.ts.map

package/esm/lib/integrations/n8n-credential-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-credential-store.d.ts","sourceRoot":"","sources":["../../../src/lib/integrations/n8n-credential-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAMnF,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IACnE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1C,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/C;AA0CD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,EAC3B,SAAS,SAAY,GACpB,eAAe,CAKjB;AAED,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,iCAA2B,CAAC;AAE5D,sEAAsE;AACtE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,kBAAkB,CAgBpB"}

package/esm/lib/integrations/n8n-credential-store.js

@@ -0,0 +1,62 @@
+// n8n credential persistence via host key-value / static-data storage.
+import { KeyValueCredentialStore, } from "./key-value-credential-store.js";
+const KEY_PREFIX = "atomicmail";
+function scopedKey(accountId, suffix) {
+    return `${KEY_PREFIX}:${accountId}:${suffix}`;
+}
+function normalizeBackend(backend) {
+    return {
+        async get(key) {
+            const value = await backend.get(key);
+            return value === undefined || value === null ? undefined : String(value);
+        },
+        async set(key, value) {
+            await backend.set(key, value);
+        },
+        async delete(key) {
+            await backend.delete(key);
+        },
+        ...(backend.has && {
+            async has(key) {
+                return Boolean(await backend.has(key));
+            },
+        }),
+    };
+}
+function prefixingStore(backend, accountId) {
+    return {
+        get: (key) => backend.get(scopedKey(accountId, key)),
+        set: (key, value) => backend.set(scopedKey(accountId, key), value),
+        delete: (key) => backend.delete(scopedKey(accountId, key)),
+        ...(backend.has && {
+            has: (key) => backend.has(scopedKey(accountId, key)),
+        }),
+    };
+}
+/**
+ * Wrap n8n host storage as a CredentialStore.
+ * Keys: `atomicmail:{accountId}:account:{accountId}:credentials.json`, etc.
+ */
+export function createN8nCredentialStore(backend, accountId = "default") {
+    return new KeyValueCredentialStore(prefixingStore(normalizeBackend(backend), accountId), accountId);
+}
+/** Alias for integration hosts that expect a generic factory name. */
+export const createKeyValueStore = createN8nCredentialStore;
+/** Adapter for n8n `getWorkflowStaticData()`-style object storage. */
+export function n8nStaticDataBackend(data) {
+    return {
+        get(key) {
+            const value = data[key];
+            return typeof value === "string" ? value : undefined;
+        },
+        set(key, value) {
+            data[key] = value;
+        },
+        delete(key) {
+            delete data[key];
+        },
+        has(key) {
+            return Object.prototype.hasOwnProperty.call(data, key);
+        },
+    };
+}

package/esm/lib/mod.d.ts

@@ -0,0 +1,23 @@
+export * from "./network/auth-client.js";
+export * from "./core/utils.js";
+export * from "./core/read-npm-package-readme.js";
+export * from "./core/consts.js";
+export * from "./core/messages.js";
+export * from "./core/shared-assets.js";
+export * from "./core/types.js";
+export * from "./agent/session/agent-credentials-store.js";
+export * from "./agent/session/inbox-id-to-mailbox-email.js";
+export * from "./agent/auth/agent-jwt.js";
+export * from "./agent/auth/agent-pow.js";
+export * from "./agent/auth/agent-auth-http.js";
+export * from "./agent/jmap/agent-jmap.js";
+export * from "./agent/jmap/agent-jmap-verify.js";
+export * from "./agent/session/agent-session.js";
+export * from "./agent/session/agent-resolve-config.js";
+export * from "./agent/session/agent-session-for-dir.js";
+export * from "./agent/jmap/agent-help-content.js";
+export * from "./agent/jmap/agent-vars.js";
+export * from "./integrations/key-value-credential-store.js";
+export * from "./integrations/create-agent-session.js";
+export * from "./integrations/n8n-credential-store.js";
+//# sourceMappingURL=mod.d.ts.map

package/esm/lib/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/lib/mod.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mCAAmC,CAAC;AAClD,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,8CAA8C,CAAC;AAC7D,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC;AAE3C,cAAc,8CAA8C,CAAC;AAC7D,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC"}

package/esm/lib/mod.js

@@ -0,0 +1,22 @@
+export * from "./network/auth-client.js";
+export * from "./core/utils.js";
+export * from "./core/read-npm-package-readme.js";
+export * from "./core/consts.js";
+export * from "./core/messages.js";
+export * from "./core/shared-assets.js";
+export * from "./core/types.js";
+export * from "./agent/session/agent-credentials-store.js";
+export * from "./agent/session/inbox-id-to-mailbox-email.js";
+export * from "./agent/auth/agent-jwt.js";
+export * from "./agent/auth/agent-pow.js";
+export * from "./agent/auth/agent-auth-http.js";
+export * from "./agent/jmap/agent-jmap.js";
+export * from "./agent/jmap/agent-jmap-verify.js";
+export * from "./agent/session/agent-session.js";
+export * from "./agent/session/agent-resolve-config.js";
+export * from "./agent/session/agent-session-for-dir.js";
+export * from "./agent/jmap/agent-help-content.js";
+export * from "./agent/jmap/agent-vars.js";
+export * from "./integrations/key-value-credential-store.js";
+export * from "./integrations/create-agent-session.js";
+export * from "./integrations/n8n-credential-store.js";

package/esm/lib/network/auth-client.d.ts

@@ -0,0 +1,57 @@
+export interface AuthClientOptions {
+    /** Base URL of auth-service, e.g. "http://localhost:8000". Trailing slashes are stripped. */
+    baseUrl: string;
+    /**
+     * PoW scrypt salt (hex string). When omitted, {@link DEFAULT_POW_SCRYPT_SALT_HEX}
+     * is used so clients match the bundled auth-service.
+     */
+    scryptSaltHex?: string;
+}
+export interface SignupResult {
+    /** Freshly minted API key. The server only returns it once — persist it. */
+    apiKey: string;
+    sessionJWT: string;
+}
+export interface LoginResult {
+    sessionJWT: string;
+}
+export interface RenewResult {
+    capabilityJWT: string;
+}
+/** Thrown for any non-2xx HTTP response or malformed payload. */
+export declare class AuthClientError extends Error {
+    status: number;
+    bodyText: string;
+    constructor(status: number, bodyText: string, message: string);
+}
+export declare class AuthClient {
+    private readonly baseUrl;
+    private readonly scryptSaltHex;
+    constructor(options: AuthClientOptions);
+    /**
+     * Register a new inbox under `username`. Returns the freshly minted API key
+     * (the server only ever returns it once — the caller MUST persist it) and
+     * a session JWT.
+     */
+    signup(username: string): Promise<SignupResult>;
+    /** Exchange an existing API key for a fresh session JWT. */
+    login(apiKey: string): Promise<LoginResult>;
+    /**
+     * Exchange a session JWT for a short-lived capability JWT (audience:
+     * api-service).
+     */
+    renew(sessionJWT: string): Promise<RenewResult>;
+    private fetchChallenge;
+    private postSession;
+    private parseJsonOrThrow;
+    /**
+     * Brute-force a PoW nonce. Mirrors `generatePow` in
+     * services/auth-service/src/crypto.ts: scrypt(`${challenge}:${nonce}`, salt,
+     * 64) until `difficulty` leading bits of the digest are zero.
+     *
+     * Expected work at the server's POW_DIFFICULTY=6 is ~2^6 = 64 attempts; well
+     * within the challenge JWT's 3-minute TTL.
+     */
+    private solvePoW;
+}
+//# sourceMappingURL=auth-client.d.ts.map

package/esm/lib/network/auth-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-client.d.ts","sourceRoot":"","sources":["../../../src/lib/network/auth-client.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,iEAAiE;AACjE,qBAAa,eAAgB,SAAQ,KAAK;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;gBAEL,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM9D;AAOD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,EAAE,iBAAiB;IAKtC;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBrD,4DAA4D;IACtD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAgBjD;;;OAGG;IACG,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YAoBvC,cAAc;YAsCd,WAAW;YAyCX,gBAAgB;IAuB9B;;;;;;;OAOG;YACW,QAAQ;CAgBvB"}