@keeper-security/keeper-sdk-javascript 0.1.0

package/dist/src/auth/SessionManager.d.ts

@@ -0,0 +1,67 @@
+import { type DeviceConfig, type SessionStorage, type KeeperHost, type SessionParams } from '@keeper-security/keeperapi';
+import type { Nullable } from '../utils';
+export type ConfigurationUser = {
+    user?: string;
+    server?: string;
+    last_device?: {
+        device_token?: string;
+    };
+};
+export type ConfigurationServerConfig = {
+    server?: string;
+    clone_code?: string;
+};
+export type ConfigurationDeviceConfig = {
+    device_token?: string;
+    private_key?: string;
+    server_info?: Array<ConfigurationServerConfig>;
+};
+export type KeeperJsonConfig = {
+    last_login?: string;
+    last_server?: string;
+    user?: string;
+    server?: string;
+    device_token?: string;
+    private_key?: string;
+    clone_code?: string;
+    users?: Array<ConfigurationUser>;
+    devices?: Array<ConfigurationDeviceConfig>;
+};
+export interface ConfigLoader {
+    load(): Promise<KeeperJsonConfig>;
+    save(config: KeeperJsonConfig): Promise<void>;
+    readonly configDir: string;
+}
+export declare class FileConfigLoader implements ConfigLoader {
+    readonly configDir: string;
+    constructor(configDir?: string);
+    load(): Promise<KeeperJsonConfig>;
+    save(config: KeeperJsonConfig): Promise<void>;
+}
+export declare class SessionManager implements SessionStorage {
+    private readonly configLoader;
+    private sessionParams;
+    private _lastUsername?;
+    private _keeperConfig;
+    private _deviceCache;
+    private sessionDevices;
+    private sessionCloneCodes;
+    constructor(configDir?: string);
+    constructor(loader: ConfigLoader);
+    get configDir(): string;
+    get lastUsername(): string | undefined;
+    getLastUsername(): Promise<string | undefined>;
+    getDeviceConfig(host: string): Promise<DeviceConfig>;
+    createOnDeviceConfig(host: string): (deviceConfig: DeviceConfig) => Promise<void>;
+    private cloneCodeKey;
+    getCloneCode(host: KeeperHost, username: string): Promise<Nullable<Uint8Array>>;
+    saveCloneCode(host: KeeperHost, username: string, cloneCode: Uint8Array): Promise<void>;
+    private updateKeeperConfigCloneCode;
+    getSessionParameters(): Promise<Nullable<SessionParams>>;
+    saveSessionParameters(params: Partial<SessionParams>): Promise<void>;
+    setLastUsername(username: string): void;
+    private loadKeeperConfig;
+    private findDeviceInKeeperConfig;
+    private lookupDeviceInKeeperConfig;
+    static isValidKeeperConfig(value: unknown): value is KeeperJsonConfig;
+}

package/dist/src/auth/SessionManager.js

@@ -0,0 +1,212 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = exports.FileConfigLoader = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const keeperapi_1 = require("@keeper-security/keeperapi");
+const utils_1 = require("../utils");
+class FileConfigLoader {
+    constructor(configDir) {
+        this.configDir = configDir || path_1.default.join(os_1.default.homedir(), utils_1.SdkDefaults.CONFIG_DIR);
+    }
+    async load() {
+        const configPath = path_1.default.join(this.configDir, 'config.json');
+        try {
+            const content = await promises_1.default.readFile(configPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            if (SessionManager.isValidKeeperConfig(parsed)) {
+                return parsed;
+            }
+        }
+        catch (err) {
+            utils_1.logger.debug('Failed to load keeper config:', (0, utils_1.extractErrorMessage)(err));
+        }
+        return {};
+    }
+    async save(config) {
+        const configPath = path_1.default.join(this.configDir, 'config.json');
+        await promises_1.default.writeFile(configPath, JSON.stringify(config, null, 2), {
+            mode: 0o600,
+        });
+    }
+}
+exports.FileConfigLoader = FileConfigLoader;
+class SessionManager {
+    constructor(configDirOrLoader) {
+        this.sessionParams = null;
+        this._keeperConfig = null;
+        this._deviceCache = null;
+        this.sessionDevices = new Map();
+        this.sessionCloneCodes = new Map();
+        if (typeof configDirOrLoader === 'string' || configDirOrLoader === undefined) {
+            this.configLoader = new FileConfigLoader(configDirOrLoader);
+        }
+        else {
+            this.configLoader = configDirOrLoader;
+        }
+    }
+    get configDir() {
+        return this.configLoader.configDir;
+    }
+    get lastUsername() {
+        return this._lastUsername;
+    }
+    async getLastUsername() {
+        if (this._lastUsername)
+            return this._lastUsername;
+        const keeperConfig = await this.loadKeeperConfig();
+        return keeperConfig.last_login || keeperConfig.user || undefined;
+    }
+    async getDeviceConfig(host) {
+        const username = await this.getLastUsername();
+        if (username) {
+            const device = await this.findDeviceInKeeperConfig(username);
+            if (device) {
+                return {
+                    deviceToken: device.deviceToken,
+                    privateKey: device.privateKey,
+                };
+            }
+        }
+        return this.sessionDevices.get(host) || {};
+    }
+    createOnDeviceConfig(host) {
+        return async (deviceConfig) => {
+            this.sessionDevices.set(host, { ...deviceConfig });
+        };
+    }
+    cloneCodeKey(host, username) {
+        return `${host}::${username}`;
+    }
+    async getCloneCode(host, username) {
+        const hostStr = String(host);
+        const key = this.cloneCodeKey(host, username);
+        const sessionCode = this.sessionCloneCodes.get(key);
+        if (sessionCode)
+            return sessionCode;
+        const device = await this.findDeviceInKeeperConfig(username);
+        if (device) {
+            const serverInfo = device.serverInfo.find((entry) => entry.server === hostStr);
+            if (serverInfo) {
+                return (0, keeperapi_1.normal64Bytes)(serverInfo.clone_code);
+            }
+        }
+        return null;
+    }
+    async saveCloneCode(host, username, cloneCode) {
+        const key = this.cloneCodeKey(host, username);
+        this.sessionCloneCodes.set(key, cloneCode);
+        await this.updateKeeperConfigCloneCode(String(host), username, cloneCode);
+    }
+    async updateKeeperConfigCloneCode(host, username, cloneCode) {
+        var _a, _b;
+        try {
+            const parsed = await this.configLoader.load();
+            if (!parsed || Object.keys(parsed).length === 0)
+                return;
+            let updated = false;
+            const encodedCloneCode = Buffer.from(cloneCode).toString('base64url');
+            const server = parsed.last_server || parsed.server;
+            if (((_a = parsed.user) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === username.toLowerCase() && server === host) {
+                parsed.clone_code = encodedCloneCode;
+                updated = true;
+            }
+            const user = (parsed.users || []).find((configUser) => { var _a; return ((_a = configUser.user) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === username.toLowerCase(); });
+            if ((_b = user === null || user === void 0 ? void 0 : user.last_device) === null || _b === void 0 ? void 0 : _b.device_token) {
+                const device = (parsed.devices || []).find((configDevice) => configDevice.device_token === user.last_device.device_token);
+                if (device === null || device === void 0 ? void 0 : device.server_info) {
+                    const serverInfo = device.server_info.find((entry) => entry.server === host);
+                    if (serverInfo) {
+                        serverInfo.clone_code = encodedCloneCode;
+                        updated = true;
+                    }
+                }
+            }
+            if (updated) {
+                await this.configLoader.save(parsed);
+                this._keeperConfig = null;
+                this._deviceCache = null;
+            }
+        }
+        catch (err) {
+            utils_1.logger.warn('Failed to update keeper config clone code:', (0, utils_1.extractErrorMessage)(err));
+        }
+    }
+    async getSessionParameters() {
+        return this.sessionParams;
+    }
+    async saveSessionParameters(params) {
+        this.sessionParams = { ...this.sessionParams, ...params };
+        if (params.username) {
+            this._lastUsername = params.username;
+        }
+    }
+    setLastUsername(username) {
+        this._lastUsername = username;
+    }
+    async loadKeeperConfig() {
+        if (this._keeperConfig)
+            return this._keeperConfig;
+        this._keeperConfig = await this.configLoader.load();
+        return this._keeperConfig;
+    }
+    async findDeviceInKeeperConfig(username) {
+        var _a;
+        const normalizedUsername = username.toLowerCase();
+        if (((_a = this._deviceCache) === null || _a === void 0 ? void 0 : _a.username) === normalizedUsername) {
+            return this._deviceCache.device;
+        }
+        const device = await this.lookupDeviceInKeeperConfig(normalizedUsername);
+        this._deviceCache = { username: normalizedUsername, device };
+        return device;
+    }
+    async lookupDeviceInKeeperConfig(normalizedUsername) {
+        var _a, _b;
+        const keeperConfig = await this.loadKeeperConfig();
+        if (keeperConfig.users && keeperConfig.devices) {
+            const user = keeperConfig.users.find((configUser) => { var _a; return ((_a = configUser.user) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === normalizedUsername; });
+            if ((_a = user === null || user === void 0 ? void 0 : user.last_device) === null || _a === void 0 ? void 0 : _a.device_token) {
+                const deviceTokenStr = user.last_device.device_token;
+                const device = keeperConfig.devices.find((configDevice) => configDevice.device_token === deviceTokenStr);
+                if (device === null || device === void 0 ? void 0 : device.private_key) {
+                    return {
+                        deviceToken: (0, keeperapi_1.normal64Bytes)(deviceTokenStr),
+                        privateKey: (0, keeperapi_1.normal64Bytes)(device.private_key),
+                        serverInfo: (device.server_info || []).filter((entry) => !!entry.server && !!entry.clone_code),
+                    };
+                }
+            }
+        }
+        if (keeperConfig.device_token &&
+            keeperConfig.private_key &&
+            ((_b = keeperConfig.user) === null || _b === void 0 ? void 0 : _b.toLowerCase()) === normalizedUsername) {
+            const serverInfo = [];
+            const server = keeperConfig.last_server || keeperConfig.server;
+            if (server && keeperConfig.clone_code) {
+                serverInfo.push({ server, clone_code: keeperConfig.clone_code });
+            }
+            return {
+                deviceToken: (0, keeperapi_1.normal64Bytes)(keeperConfig.device_token),
+                privateKey: (0, keeperapi_1.normal64Bytes)(keeperConfig.private_key),
+                serverInfo,
+            };
+        }
+        return null;
+    }
+    static isValidKeeperConfig(value) {
+        if (typeof value !== 'object' || value === null)
+            return false;
+        const obj = value;
+        if (obj.users !== undefined && !Array.isArray(obj.users))
+            return false;
+        if (obj.devices !== undefined && !Array.isArray(obj.devices))
+            return false;
+        return true;
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=SessionManager.js.map

package/dist/src/auth/SessionManager.js.map

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

package/dist/src/folders/FolderManager.d.ts

@@ -0,0 +1,57 @@
+import type { Auth } from '@keeper-security/keeperapi';
+import { InMemoryStorage } from '../storage/InMemoryStorage';
+import type { AddFolderInput, AddFolderResult, MkdirOptions } from './addFolder';
+import type { ChangeDirectoryResult, TryResolvePathResult, VaultFolderSession } from './changeDirectory';
+import type { DeleteFolderResult, RmdirOptions } from './deleteFolder';
+import type { FolderTreeBuildOptions, FolderTreeResult } from './folderTree';
+import type { FoundFolder, GetFolderOptions, GetFolderResult } from './getFolder';
+import type { ListFolderFolderSimple, ListFolderOptions, ListFolderResult } from './listFolder';
+import type { RenameFolderResult, UpdateFolderInput, UpdateFolderResult } from './updateFolder';
+export type AuthProvider = () => Auth;
+export type SharedFolderPermissionsInput = {
+    manageUsers?: boolean | null;
+    manageRecords?: boolean | null;
+    canShare?: boolean | null;
+    canEdit?: boolean | null;
+};
+export declare class FolderManager {
+    private readonly storage;
+    private readonly session;
+    private readonly authProvider;
+    constructor(storage: InMemoryStorage, session: VaultFolderSession, authProvider: AuthProvider);
+    static createSession(): VaultFolderSession;
+    static splitPathComponents(path: string): string[];
+    getSession(): VaultFolderSession;
+    getCurrentFolderUid(): string | null;
+    getWorkingFolderDisplayName(): string;
+    private requireAuth;
+    listFolder(options?: ListFolderOptions): Promise<ListFolderResult>;
+    listRootUserFolders(): Promise<import("@keeper-security/keeperapi").DUserFolder[]>;
+    listVaultRootFolders(): Promise<{
+        rows: ListFolderFolderSimple[];
+        promotedRootSharedUids: Set<string>;
+    }>;
+    findFolderUidByNameOrUid(nameOrUid: string): string | undefined;
+    findFolder(nameOrUid: string): FoundFolder | undefined;
+    findParentFolderUid(folderUid: string): Promise<string | null>;
+    getFolder(uidOrName: string, options?: GetFolderOptions): Promise<GetFolderResult>;
+    changeDirectory(path: string): Promise<ChangeDirectoryResult>;
+    tryResolvePath(path: string): Promise<TryResolvePathResult>;
+    resolveSingleFolder(folderName: string): Promise<ChangeDirectoryResult>;
+    addFolder(input: AddFolderInput): Promise<AddFolderResult>;
+    mkdir(path: string, options?: MkdirOptions): Promise<{
+        folderUid: string;
+        success: boolean;
+        message?: string;
+    }>;
+    updateFolder(input: UpdateFolderInput): Promise<UpdateFolderResult>;
+    renameFolder(folderPath: string, newName: string): Promise<RenameFolderResult>;
+    updateSharedFolderPermissions(sharedFolderUid: string, permissions: SharedFolderPermissionsInput): Promise<UpdateFolderResult>;
+    deleteFolder(folderRefs: string[], confirm?: (summary: string) => boolean | Promise<boolean>): Promise<DeleteFolderResult>;
+    rmdir(patterns: string[], options?: RmdirOptions): Promise<DeleteFolderResult>;
+    resolveRmdirPatternsToFolderUids(pattern: string): Promise<Set<string>>;
+    buildFolderDeleteObject(folderUid: string): Promise<import("@keeper-security/keeperapi").DeleteObject>;
+    buildFolderTree(options?: FolderTreeBuildOptions): Promise<FolderTreeResult>;
+    folderTreeAscii(options?: FolderTreeBuildOptions): Promise<string>;
+    renderFolderTreeAscii(tree: FolderTreeResult): string;
+}

package/dist/src/folders/FolderManager.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FolderManager = void 0;
+const utils_1 = require("../utils");
+const addFolder_1 = require("./addFolder");
+const changeDirectory_1 = require("./changeDirectory");
+const deleteFolder_1 = require("./deleteFolder");
+const folderTree_1 = require("./folderTree");
+const getFolder_1 = require("./getFolder");
+const listFolder_1 = require("./listFolder");
+const updateFolder_1 = require("./updateFolder");
+class FolderManager {
+    constructor(storage, session, authProvider) {
+        this.storage = storage;
+        this.session = session;
+        this.authProvider = authProvider;
+    }
+    static createSession() {
+        return (0, changeDirectory_1.createVaultFolderSession)();
+    }
+    static splitPathComponents(path) {
+        return (0, changeDirectory_1.splitPathComponents)(path);
+    }
+    getSession() {
+        return this.session;
+    }
+    getCurrentFolderUid() {
+        return this.session.currentFolderUid;
+    }
+    getWorkingFolderDisplayName() {
+        return (0, changeDirectory_1.getWorkingFolderDisplayName)(this.storage, this.session.currentFolderUid);
+    }
+    requireAuth() {
+        const auth = this.authProvider();
+        if (!auth) {
+            throw new utils_1.KeeperSdkError('Not logged in. Call login() first.', utils_1.ResultCodes.NOT_LOGGED_IN);
+        }
+        return auth;
+    }
+    async listFolder(options = {}) {
+        return (0, listFolder_1.listFolder)(this.storage, options);
+    }
+    listRootUserFolders() {
+        return (0, listFolder_1.listRootUserFolders)(this.storage);
+    }
+    async listVaultRootFolders() {
+        return (0, listFolder_1.listVaultRootFolders)(this.storage);
+    }
+    findFolderUidByNameOrUid(nameOrUid) {
+        return (0, listFolder_1.findFolderUidByNameOrUid)(this.storage, nameOrUid);
+    }
+    findFolder(nameOrUid) {
+        return (0, getFolder_1.findFolder)(this.storage, nameOrUid);
+    }
+    async findParentFolderUid(folderUid) {
+        return (0, changeDirectory_1.findParentFolderUid)(this.storage, folderUid);
+    }
+    async getFolder(uidOrName, options = {}) {
+        return (0, getFolder_1.getFolder)(this.storage, uidOrName, options);
+    }
+    async changeDirectory(path) {
+        return (0, changeDirectory_1.changeDirectory)(this.storage, this.session, path);
+    }
+    async tryResolvePath(path) {
+        return (0, changeDirectory_1.tryResolvePath)(this.storage, this.session, path);
+    }
+    async resolveSingleFolder(folderName) {
+        return (0, changeDirectory_1.resolveSingleFolder)(this.storage, this.session, folderName);
+    }
+    async addFolder(input) {
+        return (0, addFolder_1.addFolder)(this.requireAuth(), this.storage, input);
+    }
+    async mkdir(path, options = {}) {
+        return (0, addFolder_1.mkdir)(this.requireAuth(), this.storage, this.session, path, options);
+    }
+    async updateFolder(input) {
+        return (0, updateFolder_1.updateFolder)(this.requireAuth(), this.storage, input);
+    }
+    async renameFolder(folderPath, newName) {
+        return (0, updateFolder_1.renameFolder)(this.requireAuth(), this.storage, this.session, folderPath, newName);
+    }
+    async updateSharedFolderPermissions(sharedFolderUid, permissions) {
+        return (0, updateFolder_1.updateSharedFolderPermissions)(this.requireAuth(), this.storage, sharedFolderUid, permissions);
+    }
+    async deleteFolder(folderRefs, confirm) {
+        return (0, deleteFolder_1.deleteFolder)(this.requireAuth(), this.storage, folderRefs, confirm);
+    }
+    async rmdir(patterns, options = {}) {
+        return (0, deleteFolder_1.rmdir)(this.requireAuth(), this.storage, this.session, patterns, options);
+    }
+    async resolveRmdirPatternsToFolderUids(pattern) {
+        return (0, deleteFolder_1.resolveRmdirPatternsToFolderUids)(this.storage, this.session, pattern);
+    }
+    async buildFolderDeleteObject(folderUid) {
+        return (0, deleteFolder_1.buildFolderDeleteObject)(this.storage, folderUid);
+    }
+    async buildFolderTree(options = {}) {
+        return (0, folderTree_1.buildFolderTree)(this.storage, this.session, options);
+    }
+    async folderTreeAscii(options = {}) {
+        return (0, folderTree_1.folderTreeAscii)(this.storage, this.session, options);
+    }
+    renderFolderTreeAscii(tree) {
+        return (0, folderTree_1.renderFolderTreeAscii)(tree);
+    }
+}
+exports.FolderManager = FolderManager;
+//# sourceMappingURL=FolderManager.js.map

package/dist/src/folders/FolderManager.js.map

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

package/dist/src/folders/addFolder.d.ts

@@ -0,0 +1,32 @@
+import type { Auth } from '@keeper-security/keeperapi';
+import { InMemoryStorage } from '../storage/InMemoryStorage';
+import { type VaultFolderSession } from './changeDirectory';
+export type AddFolderInput = {
+    folderName: string;
+    isSharedFolder?: boolean;
+    parentUid?: string | null;
+    manageUsers?: boolean;
+    manageRecords?: boolean;
+    canShare?: boolean;
+    canEdit?: boolean;
+};
+export type AddFolderResult = {
+    folderUid: string;
+    success: boolean;
+    message?: string;
+};
+export type MkdirOptions = {
+    sharedFolder?: boolean;
+    userFolder?: boolean;
+    grantAll?: boolean;
+    manageUsers?: boolean;
+    manageRecords?: boolean;
+    canShare?: boolean;
+    canEdit?: boolean;
+};
+export declare function addFolder(auth: Auth, storage: InMemoryStorage, input: AddFolderInput): Promise<AddFolderResult>;
+export declare function mkdir(auth: Auth, storage: InMemoryStorage, session: VaultFolderSession, path: string, options?: MkdirOptions): Promise<{
+    folderUid: string;
+    success: boolean;
+    message?: string;
+}>;