@keeper-security/keeper-sdk-javascript 0.1.0

package/dist/src/folders/folderTree.js

@@ -0,0 +1,250 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.folderTreeAscii = exports.renderFolderTreeAscii = exports.buildFolderTree = exports.recordPermissionToText = exports.userPermissionToText = void 0;
+const keeperapi_1 = require("@keeper-security/keeperapi");
+const RecordUtils_1 = require("../records/RecordUtils");
+const listFolder_1 = require("./listFolder");
+const changeDirectory_1 = require("./changeDirectory");
+const folderHelpers_1 = require("./folderHelpers");
+var TreeItemKind;
+(function (TreeItemKind) {
+    TreeItemKind["Permission"] = "perm";
+    TreeItemKind["Record"] = "record";
+    TreeItemKind["Folder"] = "folder";
+})(TreeItemKind || (TreeItemKind = {}));
+function userPermissionToText(manageUsers, manageRecords) {
+    if (manageUsers && manageRecords)
+        return 'Can Manage Users & Records';
+    if (manageUsers)
+        return 'Can Manage Users';
+    if (manageRecords)
+        return 'Can Manage Records';
+    return 'No User Permissions';
+}
+exports.userPermissionToText = userPermissionToText;
+function recordPermissionToText(canEdit, canShare) {
+    if (canEdit && canShare)
+        return 'Can Edit & Share';
+    if (canEdit)
+        return 'Can Edit';
+    if (canShare)
+        return 'Can Share';
+    return 'View Only';
+}
+exports.recordPermissionToText = recordPermissionToText;
+function buildAccountUidEmailMap(storage) {
+    const accountUidToEmail = new Map();
+    for (const user of storage.getAll(folderHelpers_1.VaultObjectKind.User)) {
+        const uid = user.accountUid ? (0, keeperapi_1.webSafe64FromBytes)(user.accountUid) : '';
+        const email = (user.username || '').trim();
+        if (uid && email)
+            accountUidToEmail.set(uid, email);
+    }
+    return accountUidToEmail;
+}
+function resolveUserDisplayName(accountUid, accountUsername, emailMap) {
+    const explicit = (accountUsername || '').trim();
+    if (explicit)
+        return explicit;
+    if (accountUid) {
+        const fromMap = emailMap.get(accountUid);
+        if (fromMap)
+            return fromMap;
+        return accountUid;
+    }
+    return 'unknown';
+}
+async function collectSharedFolderPermissions(storage, sharedFolder, verbose, hideSharesKey, emailMap) {
+    const rows = [];
+    const seenUserUids = new Set();
+    for (const sharedUser of storage.getAll(folderHelpers_1.VaultObjectKind.SharedFolderUser)) {
+        if (sharedUser.sharedFolderUid !== sharedFolder.uid)
+            continue;
+        if (sharedUser.accountUid)
+            seenUserUids.add(sharedUser.accountUid);
+        const permissionText = userPermissionToText(sharedUser.manageUsers, sharedUser.manageRecords);
+        let name = resolveUserDisplayName(sharedUser.accountUid, sharedUser.accountUsername, emailMap);
+        if (verbose && sharedUser.accountUid)
+            name += ` (${sharedUser.accountUid})`;
+        const suffix = hideSharesKey ? '' : ` [User]`;
+        rows.push({
+            display: `${name}: ${permissionText}${suffix}`,
+            sortKey: name.toLowerCase(),
+        });
+    }
+    if (sharedFolder.ownerAccountUid && !seenUserUids.has(sharedFolder.ownerAccountUid)) {
+        const ownerName = resolveUserDisplayName(sharedFolder.ownerAccountUid, sharedFolder.ownerUsername, emailMap);
+        let display = ownerName;
+        if (verbose)
+            display += ` (${sharedFolder.ownerAccountUid})`;
+        const suffix = hideSharesKey ? '' : ` [User]`;
+        rows.push({
+            display: `${display}: ${userPermissionToText(true, true)}${suffix}`,
+            sortKey: ownerName.toLowerCase(),
+        });
+    }
+    for (const sharedTeam of storage.getAll(folderHelpers_1.VaultObjectKind.SharedFolderTeam)) {
+        if (sharedTeam.sharedFolderUid !== sharedFolder.uid)
+            continue;
+        const permissionText = userPermissionToText(sharedTeam.manageUsers, sharedTeam.manageRecords);
+        let name = sharedTeam.name || `(${sharedTeam.teamUid})`;
+        if (verbose && sharedTeam.teamUid)
+            name += ` (${sharedTeam.teamUid})`;
+        const suffix = hideSharesKey ? '' : ` [Team]`;
+        rows.push({
+            display: `${name}: ${permissionText}${suffix}`,
+            sortKey: name.toLowerCase(),
+        });
+    }
+    rows.sort((rowA, rowB) => rowA.sortKey.localeCompare(rowB.sortKey));
+    return rows.map((row) => ({ display: row.display }));
+}
+async function buildFolderSubtree(storage, folderUid, opts) {
+    var _a;
+    const userFolder = storage.getByUid(folderHelpers_1.FolderKind.UserFolder, folderUid);
+    const sharedFolder = storage.getByUid(folderHelpers_1.FolderKind.SharedFolder, folderUid);
+    const sharedFolderFolder = storage.getByUid(folderHelpers_1.FolderKind.SharedFolderFolder, folderUid);
+    if (!userFolder && !sharedFolder && !sharedFolderFolder) {
+        return { displayName: `(missing folder ${folderUid})`, children: [] };
+    }
+    let baseName;
+    if (userFolder)
+        baseName = (0, folderHelpers_1.userFolderName)(userFolder);
+    else if (sharedFolder)
+        baseName = (0, folderHelpers_1.sharedFolderName)(sharedFolder);
+    else
+        baseName = (0, folderHelpers_1.sharedFolderFolderName)(sharedFolderFolder);
+    let displayName = baseName;
+    if (opts.verbose) {
+        displayName = `${baseName} (${folderUid})`;
+    }
+    if (sharedFolder) {
+        displayName += ' [Shared]';
+    }
+    const node = { displayName, children: [] };
+    if (opts.showShares && sharedFolder) {
+        node.permissions = await collectSharedFolderPermissions(storage, sharedFolder, opts.verbose, opts.hideSharesKey, opts.accountUidEmailMap);
+    }
+    const listed = await (0, listFolder_1.listFolder)(storage, {
+        folderUid: folderUid,
+        showFolders: true,
+        showRecords: opts.showRecords,
+    });
+    for (const childFolder of listed.folders) {
+        if ((_a = opts.promotedRootSharedUids) === null || _a === void 0 ? void 0 : _a.has(childFolder.uid))
+            continue;
+        node.children.push(await buildFolderSubtree(storage, childFolder.uid, opts));
+    }
+    if (opts.showRecords && 'records' in listed) {
+        const records = listed.records;
+        node.records = records.map((recordRow) => {
+            const record = storage.getByUid(folderHelpers_1.VaultObjectKind.Record, recordRow.uid);
+            const title = record ? (0, RecordUtils_1.getRecordTitle)(record) : recordRow.name;
+            const display = opts.verbose && record ? `${title} (${recordRow.uid}) [Record]` : `${title} [Record]`;
+            return { display };
+        });
+    }
+    return node;
+}
+async function buildVaultRootTree(storage, opts) {
+    var _a;
+    const node = { displayName: '', children: [] };
+    const { rows, promotedRootSharedUids } = await (0, listFolder_1.listVaultRootFolders)(storage);
+    const optsWithPromoted = { ...opts, promotedRootSharedUids };
+    for (const folderRow of rows) {
+        node.children.push(await buildFolderSubtree(storage, folderRow.uid, optsWithPromoted));
+    }
+    const listed = await (0, listFolder_1.listFolder)(storage, {
+        folderUid: undefined,
+        showFolders: true,
+        showRecords: opts.showRecords,
+    });
+    if (opts.showRecords && ((_a = listed.records) === null || _a === void 0 ? void 0 : _a.length)) {
+        node.records = listed.records.map((recordRow) => {
+            const record = storage.getByUid(folderHelpers_1.VaultObjectKind.Record, recordRow.uid);
+            const title = record ? (0, RecordUtils_1.getRecordTitle)(record) : recordRow.name;
+            const display = opts.verbose && record ? `${title} (${recordRow.uid}) [Record]` : `${title} [Record]`;
+            return { display };
+        });
+    }
+    return node;
+}
+async function resolveTreeStart(storage, session, folderPath) {
+    const trimmedPath = folderPath === null || folderPath === void 0 ? void 0 : folderPath.trim();
+    if (trimmedPath) {
+        const resolved = await (0, changeDirectory_1.resolveSingleFolder)(storage, session, trimmedPath);
+        return { folderUid: resolved.folderUid };
+    }
+    return { folderUid: session.currentFolderUid || null };
+}
+async function buildFolderTree(storage, session, options = {}) {
+    const opts = {
+        verbose: options.verbose === true,
+        showRecords: options.showRecords === true,
+        showShares: options.showShares === true,
+        hideSharesKey: options.hideSharesKey === true,
+        accountUidEmailMap: buildAccountUidEmailMap(storage),
+    };
+    const { folderUid } = await resolveTreeStart(storage, session, options.folderPath);
+    const root = folderUid === null
+        ? await buildVaultRootTree(storage, opts)
+        : await buildFolderSubtree(storage, folderUid, opts);
+    return { title: options.title || undefined, root };
+}
+exports.buildFolderTree = buildFolderTree;
+function gatherItems(node) {
+    const items = [];
+    if (node.permissions) {
+        for (const permission of node.permissions) {
+            items.push({ kind: TreeItemKind.Permission, display: permission.display });
+        }
+    }
+    for (const child of node.children) {
+        items.push({ kind: TreeItemKind.Folder, node: child });
+    }
+    if (node.records) {
+        for (const record of node.records) {
+            items.push({ kind: TreeItemKind.Record, display: record.display });
+        }
+    }
+    return items;
+}
+function renderFolderTreeAscii(result) {
+    const lines = [];
+    if (result.title) {
+        lines.push(result.title);
+    }
+    renderNode(result.root, lines, true, '', true);
+    return lines.join('\n');
+}
+exports.renderFolderTreeAscii = renderFolderTreeAscii;
+function renderNode(node, lines, isRoot, prefix, isLast) {
+    if (isRoot) {
+        if (node.displayName) {
+            lines.push(node.displayName);
+        }
+    }
+    else {
+        const connector = isLast ? '\\-- ' : '+-- ';
+        lines.push(prefix + connector + node.displayName);
+    }
+    const childBase = isRoot ? ' ' : prefix + (isLast ? '    ' : '|   ');
+    const items = gatherItems(node);
+    for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
+        const isLastItem = itemIndex === items.length - 1;
+        const item = items[itemIndex];
+        if (item.kind === TreeItemKind.Permission || item.kind === TreeItemKind.Record) {
+            const connector = isLastItem ? '\\-- ' : '+-- ';
+            lines.push(childBase + connector + item.display);
+        }
+        else {
+            renderNode(item.node, lines, false, childBase, isLastItem);
+        }
+    }
+}
+async function folderTreeAscii(storage, session, options) {
+    const built = await buildFolderTree(storage, session, options || {});
+    return renderFolderTreeAscii(built);
+}
+exports.folderTreeAscii = folderTreeAscii;
+//# sourceMappingURL=folderTree.js.map

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

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

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

@@ -0,0 +1,56 @@
+import type { DSharedFolder, DSharedFolderFolder, DUserFolder } from '@keeper-security/keeperapi';
+import { InMemoryStorage } from '../storage/InMemoryStorage';
+import { FolderKind, FolderObjectType } from './folderHelpers';
+export declare enum GetFolderFormat {
+    Detail = "detail",
+    JSON = "json"
+}
+export type GetFolderFormatInput = GetFolderFormat | `${GetFolderFormat}`;
+export type GetFolderOptions = {
+    format?: GetFolderFormatInput;
+};
+export type GetFolderResult = GetFolderResultFolder | GetFolderResultSharedFolder;
+export type GetFolderResultFolder = {
+    objectType: FolderObjectType.Folder;
+    format: GetFolderFormat;
+    folder_uid: string;
+    folder_type: FolderKind.UserFolder | FolderKind.SharedFolderFolder;
+    name: string;
+    parent_uid: string | null;
+    shared_folder_scope_uid?: string;
+    json?: Record<string, unknown>;
+};
+export type GetFolderResultSharedFolder = {
+    objectType: FolderObjectType.SharedFolder;
+    format: GetFolderFormat;
+    shared_folder_uid: string;
+    name: string;
+    default_can_edit: boolean;
+    default_can_share: boolean;
+    default_manage_records: boolean;
+    default_manage_users: boolean;
+    record_permissions?: {
+        record_uid: string;
+        can_edit: boolean;
+        can_share: boolean;
+        owner: boolean;
+    }[];
+    user_permissions?: {
+        account_username?: string;
+        manage_records: boolean;
+        manage_users: boolean;
+    }[];
+    json?: Record<string, unknown>;
+};
+export type FoundFolder = {
+    kind: FolderKind.UserFolder;
+    folder: DUserFolder;
+} | {
+    kind: FolderKind.SharedFolder;
+    folder: DSharedFolder;
+} | {
+    kind: FolderKind.SharedFolderFolder;
+    folder: DSharedFolderFolder;
+};
+export declare function findFolder(storage: InMemoryStorage, nameOrUid: string): FoundFolder | undefined;
+export declare function getFolder(storage: InMemoryStorage, uidOrName: string, options?: GetFolderOptions): Promise<GetFolderResult>;

package/dist/src/folders/getFolder.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFolder = exports.findFolder = exports.GetFolderFormat = void 0;
+const utils_1 = require("../utils");
+const changeDirectory_1 = require("./changeDirectory");
+const folderHelpers_1 = require("./folderHelpers");
+var GetFolderFormat;
+(function (GetFolderFormat) {
+    GetFolderFormat["Detail"] = "detail";
+    GetFolderFormat["JSON"] = "json";
+})(GetFolderFormat = exports.GetFolderFormat || (exports.GetFolderFormat = {}));
+function findByUidOrName(items, nameOrUid, getUid, getName) {
+    const trimmedNameOrUid = nameOrUid.trim();
+    if (!trimmedNameOrUid)
+        return undefined;
+    const lowerNameOrUid = trimmedNameOrUid.toLowerCase();
+    let exactNameHit;
+    let lowerNameHit;
+    for (const item of items) {
+        if (getUid(item) === trimmedNameOrUid)
+            return item;
+        if (!exactNameHit) {
+            const itemName = getName(item);
+            if (itemName === trimmedNameOrUid) {
+                exactNameHit = item;
+            }
+            else if (!lowerNameHit && itemName.toLowerCase() === lowerNameOrUid) {
+                lowerNameHit = item;
+            }
+        }
+    }
+    return exactNameHit || lowerNameHit;
+}
+function findSharedFolder(storage, nameOrUid) {
+    return findByUidOrName(storage.getAll(folderHelpers_1.FolderKind.SharedFolder), nameOrUid, (sharedFolder) => sharedFolder.uid, (sharedFolder) => (sharedFolder.name || '').trim());
+}
+function findUserFolder(storage, nameOrUid) {
+    return findByUidOrName(storage.getAll(folderHelpers_1.FolderKind.UserFolder), nameOrUid, (userFolder) => userFolder.uid, (userFolder) => (0, folderHelpers_1.userFolderName)(userFolder));
+}
+function findSharedFolderFolder(storage, nameOrUid) {
+    return findByUidOrName(storage.getAll(folderHelpers_1.FolderKind.SharedFolderFolder), nameOrUid, (sharedFolderFolder) => sharedFolderFolder.uid, (sharedFolderFolder) => (0, folderHelpers_1.sharedFolderFolderName)(sharedFolderFolder));
+}
+function findFolder(storage, nameOrUid) {
+    const trimmedNameOrUid = nameOrUid.trim();
+    if (!trimmedNameOrUid)
+        return undefined;
+    const sharedFolder = findSharedFolder(storage, trimmedNameOrUid);
+    if (sharedFolder)
+        return { kind: folderHelpers_1.FolderKind.SharedFolder, folder: sharedFolder };
+    const userFolder = findUserFolder(storage, trimmedNameOrUid);
+    if (userFolder)
+        return { kind: folderHelpers_1.FolderKind.UserFolder, folder: userFolder };
+    const sharedFolderFolder = findSharedFolderFolder(storage, trimmedNameOrUid);
+    if (sharedFolderFolder)
+        return { kind: folderHelpers_1.FolderKind.SharedFolderFolder, folder: sharedFolderFolder };
+    return undefined;
+}
+exports.findFolder = findFolder;
+async function formatRegularFolder(storage, folder, format) {
+    const isUser = folder.kind === folderHelpers_1.FolderKind.UserFolder;
+    const folder_uid = folder.uid;
+    const folder_type = isUser
+        ? folderHelpers_1.FolderKind.UserFolder
+        : folderHelpers_1.FolderKind.SharedFolderFolder;
+    const name = isUser ? (0, folderHelpers_1.userFolderName)(folder) : (0, folderHelpers_1.sharedFolderFolderName)(folder);
+    const parent_uid = await (0, changeDirectory_1.findParentFolderUid)(storage, folder_uid);
+    const base = {
+        objectType: folderHelpers_1.FolderObjectType.Folder,
+        format,
+        folder_uid,
+        folder_type,
+        name,
+        parent_uid,
+    };
+    if (!isUser) {
+        base.shared_folder_scope_uid = folder.sharedFolderUid;
+    }
+    if (format === GetFolderFormat.JSON) {
+        base.json = { ...base, objectType: folderHelpers_1.FolderObjectType.Folder };
+    }
+    return base;
+}
+function formatSharedFolder(storage, sharedFolder, format) {
+    const sharedFolderUid = sharedFolder.uid;
+    const recordPermissions = storage
+        .getAll(folderHelpers_1.VaultObjectKind.SharedFolderRecord)
+        .filter((record) => record.sharedFolderUid === sharedFolderUid)
+        .map((record) => ({
+        record_uid: record.recordUid,
+        can_edit: record.canEdit,
+        can_share: record.canShare,
+        owner: record.owner,
+    }));
+    const userPermissions = storage
+        .getAll(folderHelpers_1.VaultObjectKind.SharedFolderUser)
+        .filter((user) => user.sharedFolderUid === sharedFolderUid)
+        .map((user) => ({
+        account_username: user.accountUsername,
+        manage_records: user.manageRecords,
+        manage_users: user.manageUsers,
+    }));
+    const base = {
+        objectType: folderHelpers_1.FolderObjectType.SharedFolder,
+        format,
+        shared_folder_uid: sharedFolder.uid,
+        name: (sharedFolder.name || '').trim() || sharedFolder.uid,
+        default_can_edit: sharedFolder.defaultCanEdit,
+        default_can_share: sharedFolder.defaultCanShare,
+        default_manage_records: sharedFolder.defaultManageRecords,
+        default_manage_users: sharedFolder.defaultManageUsers,
+        record_permissions: recordPermissions.length ? recordPermissions : undefined,
+        user_permissions: userPermissions.length ? userPermissions : undefined,
+    };
+    if (format === GetFolderFormat.JSON) {
+        base.json = { ...base, objectType: folderHelpers_1.FolderObjectType.SharedFolder };
+    }
+    return base;
+}
+function normalizeFormat(format) {
+    if (format === GetFolderFormat.JSON)
+        return GetFolderFormat.JSON;
+    return GetFolderFormat.Detail;
+}
+async function getFolder(storage, uidOrName, options = {}) {
+    const trimmed = uidOrName.trim();
+    if (!trimmed) {
+        throw new utils_1.KeeperSdkError('Folder UID or name is required.', 'missing_folder_ref');
+    }
+    const found = findFolder(storage, trimmed);
+    if (!found) {
+        throw new utils_1.KeeperSdkError(`"${trimmed}" not found as a folder or shared folder`, 'folder_not_found');
+    }
+    const format = normalizeFormat(options.format);
+    switch (found.kind) {
+        case folderHelpers_1.FolderKind.SharedFolder:
+            return formatSharedFolder(storage, found.folder, format);
+        case folderHelpers_1.FolderKind.UserFolder:
+        case folderHelpers_1.FolderKind.SharedFolderFolder:
+            return formatRegularFolder(storage, found.folder, format);
+    }
+}
+exports.getFolder = getFolder;
+//# sourceMappingURL=getFolder.js.map

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

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

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

@@ -0,0 +1,48 @@
+import type { DUserFolder } from '@keeper-security/keeperapi';
+import { InMemoryStorage } from '../storage/InMemoryStorage';
+import { FolderKind } from './folderHelpers';
+export type ListFolderOptions = {
+    folderUid?: string | null;
+    pattern?: string | null;
+    showFolders?: boolean;
+    showRecords?: boolean;
+    detail?: boolean;
+};
+export type ListFolderFolderSimple = {
+    uid: string;
+    name: string;
+    folderKind: FolderKind;
+};
+export type ListFolderRecordSimple = {
+    uid: string;
+    name: string;
+    type: string;
+};
+export type ListFolderFolderDetail = ListFolderFolderSimple & {
+    flags: string;
+    recordCount: number;
+    subfolderCount: number;
+};
+export type ListFolderRecordDetail = ListFolderRecordSimple & {
+    flags: string;
+    version: number;
+    isOwner: boolean;
+    hasAttachments: boolean;
+    isShared: boolean;
+};
+export type ListFolderResult = {
+    detail: true;
+    folders: ListFolderFolderDetail[];
+    records: ListFolderRecordDetail[];
+} | {
+    detail: false;
+    folders: ListFolderFolderSimple[];
+    records: ListFolderRecordSimple[];
+};
+export declare function listRootUserFolders(storage: InMemoryStorage): Promise<DUserFolder[]>;
+export declare function listVaultRootFolders(storage: InMemoryStorage): Promise<{
+    rows: ListFolderFolderSimple[];
+    promotedRootSharedUids: Set<string>;
+}>;
+export declare function findFolderUidByNameOrUid(storage: InMemoryStorage, nameOrUid: string): string | undefined;
+export declare function listFolder(storage: InMemoryStorage, options?: ListFolderOptions): Promise<ListFolderResult>;