@1password/sdk 0.3.0 → 0.4.0-beta.1

package/README.md

@@ -107,8 +107,9 @@ Field types:
 - [x] Address
 - [x] Date
 - [x] MM/YY
-- [x] Files attachments and Document items
+- [x] File attachments and Document items
 - [x] Menu
+- [ ] Passkeys
 
 ### Vault management
 - [ ] Retrieve vaults

package/dist/client.d.ts

@@ -2,9 +2,11 @@ import { InnerClient } from "./core.js";
 import { SecretsApi } from "./secrets.js";
 import { ItemsApi } from "./items.js";
 import { VaultsApi } from "./vaults.js";
+import { GroupsApi } from "./groups.js";
 export declare class Client {
     secrets: SecretsApi;
     items: ItemsApi;
     vaults: VaultsApi;
+    groups: GroupsApi;
     constructor(innerClient: InnerClient);
 }

package/dist/client.js

@@ -5,11 +5,13 @@ exports.Client = void 0;
 const secrets_js_1 = require("./secrets.js");
 const items_js_1 = require("./items.js");
 const vaults_js_1 = require("./vaults.js");
+const groups_js_1 = require("./groups.js");
 class Client {
     constructor(innerClient) {
         this.secrets = new secrets_js_1.Secrets(innerClient);
         this.items = new items_js_1.Items(innerClient);
         this.vaults = new vaults_js_1.Vaults(innerClient);
+        this.groups = new groups_js_1.Groups(innerClient);
     }
 }
 exports.Client = Client;

package/dist/client_builder.d.ts

@@ -1,8 +1,8 @@
-import { Core } from "./core.js";
+import { SharedCore } from "./core.js";
 import { ClientConfiguration } from "./configuration.js";
 import { Client } from "./client.js";
 /**
  * Creates a 1Password SDK client with a given core implementation.
  * @returns The authenticated 1Password SDK client.
  */
-export declare const createClientWithCore: (config: ClientConfiguration, core: Core) => Promise<Client>;
+export declare const createClientWithCore: (config: ClientConfiguration, core: SharedCore) => Promise<Client>;

package/dist/client_builder.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createClientWithCore = void 0;
 const configuration_js_1 = require("./configuration.js");
 const client_js_1 = require("./client.js");
+const shared_lib_core_js_1 = require("./shared_lib_core.js");
 const finalizationRegistry = new FinalizationRegistry((heldClient) => {
     heldClient.core.releaseClient(heldClient.id);
 });
@@ -21,6 +22,9 @@ const finalizationRegistry = new FinalizationRegistry((heldClient) => {
  */
 const createClientWithCore = (config, core) => __awaiter(void 0, void 0, void 0, function* () {
     const authConfig = (0, configuration_js_1.clientAuthConfig)(config);
+    if (authConfig.accountName) {
+        core.setInner(new shared_lib_core_js_1.SharedLibCore(authConfig.accountName));
+    }
     const clientId = yield core.initClient(authConfig);
     const inner = {
         id: parseInt(clientId, 10),

package/dist/configuration.d.ts

@@ -1,12 +1,19 @@
 import { ClientAuthConfig } from "./core.js";
 export declare const LANGUAGE = "JS";
-export declare const VERSION = "0030001";
+export declare const VERSION = "0040001";
 export interface ClientConfiguration {
     auth: Auth;
     integrationName: string;
     integrationVersion: string;
 }
-type Auth = string;
+type Auth = string | DesktopAuth;
+/**
+ * Setting that specifies that a client should use the desktop app to authenticate.
+ */
+export declare class DesktopAuth {
+    accountName: string;
+    constructor(accountName: string);
+}
 /**
  * Creates a default client configuration.
  * @returns The client configuration to instantiate the client with.

package/dist/configuration.js

@@ -3,21 +3,38 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOsName = exports.clientAuthConfig = exports.VERSION = exports.LANGUAGE = void 0;
+exports.getOsName = exports.clientAuthConfig = exports.DesktopAuth = exports.VERSION = exports.LANGUAGE = void 0;
 const os_1 = __importDefault(require("os"));
 const version_js_1 = require("./version.js");
 exports.LANGUAGE = "JS";
 exports.VERSION = version_js_1.SDK_BUILD_NUMBER;
+/**
+ * Setting that specifies that a client should use the desktop app to authenticate.
+ */
+class DesktopAuth {
+    constructor(accountName) {
+        this.accountName = accountName;
+    }
+}
+exports.DesktopAuth = DesktopAuth;
 /**
  * Creates a default client configuration.
  * @returns The client configuration to instantiate the client with.
  */
 const clientAuthConfig = (userConfig) => {
-    var _a;
     // TODO: Add logic for computing the correct sanitized version value for each platform
     const defaultOsVersion = "0.0.0";
+    let serviceAccountToken;
+    let accountName;
+    if (typeof userConfig.auth === "string") {
+        serviceAccountToken = userConfig.auth;
+    }
+    else if (userConfig.auth instanceof DesktopAuth) {
+        accountName = userConfig.auth.accountName;
+    }
     return {
-        serviceAccountToken: (_a = userConfig.auth) !== null && _a !== void 0 ? _a : "",
+        serviceAccountToken: serviceAccountToken !== null && serviceAccountToken !== void 0 ? serviceAccountToken : "",
+        accountName,
         programmingLanguage: exports.LANGUAGE,
         sdkVersion: exports.VERSION,
         integrationName: userConfig.integrationName,

package/dist/core.d.ts

@@ -5,25 +5,20 @@ export interface Core {
     /**
      *  Allocates a new authenticated client and returns its id.
      */
-    initClient(config: ClientAuthConfig): Promise<string>;
+    initClient(config: string): Promise<string>;
     /**
      *  Calls async business logic from a given client and returns the result.
      */
-    invoke(config: InvokeConfig): Promise<string>;
-    /**
-     *  Calls sync business logic from a given client and returns the result.
-     */
-    invoke_sync(config: InvokeConfig): string;
+    invoke(config: string): Promise<string>;
     /**
      *  Deallocates memory held by the given client in the SDK core when it goes out of scope.
      */
-    releaseClient(clientId: number): void;
+    releaseClient(clientId: string): void;
 }
 /**
  *  Wraps configuration information needed to allocate and authenticate a client instance and sends it to the SDK core.
  */
 export interface ClientAuthConfig {
-    serviceAccountToken: string;
     programmingLanguage: string;
     sdkVersion: string;
     integrationName: string;
@@ -33,6 +28,8 @@ export interface ClientAuthConfig {
     os: string;
     osVersion: string;
     architecture: string;
+    serviceAccountToken?: string;
+    accountName?: string;
 }
 /**
  *  Contains the information sent to the SDK core when you call (invoke) a function.
@@ -65,10 +62,18 @@ export interface Parameters {
         [key: string]: unknown;
     };
 }
+export declare class WasmCore implements Core {
+    initClient(config: string): Promise<string>;
+    invoke(config: string): Promise<string>;
+    releaseClient(clientId: string): void;
+}
 /**
  *  An implementation of the `Core` interface that shares resources across all clients.
  */
-export declare class SharedCore implements Core {
+export declare class SharedCore {
+    private inner;
+    constructor();
+    setInner(core: Core): void;
     initClient(config: ClientAuthConfig): Promise<string>;
     invoke(config: InvokeConfig): Promise<string>;
     invoke_sync(config: InvokeConfig): string;
@@ -79,6 +84,6 @@ export declare class SharedCore implements Core {
  */
 export interface InnerClient {
     id: number;
-    core: Core;
+    core: SharedCore;
 }
 export {};

package/dist/core.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SharedCore = void 0;
+exports.SharedCore = exports.WasmCore = void 0;
 const sdk_core_1 = require("@1password/sdk-core");
 const types_1 = require("./types");
 const errors_1 = require("./errors");
@@ -17,15 +17,52 @@ const errors_1 = require("./errors");
 // is ~64MB. Past this limit, the wasm-bingen FFI will throw an error and the program will crash.
 // We set the limit to 50MB to be safe, to be reconsidered upon further testing.
 const messageLimit = 50 * 1024 * 1024;
+class WasmCore {
+    initClient(config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield (0, sdk_core_1.init_client)(config);
+            }
+            catch (e) {
+                (0, errors_1.throwError)(e);
+            }
+        });
+    }
+    invoke(config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield (0, sdk_core_1.invoke)(config);
+            }
+            catch (e) {
+                (0, errors_1.throwError)(e);
+            }
+        });
+    }
+    releaseClient(clientId) {
+        try {
+            (0, sdk_core_1.release_client)(clientId);
+        }
+        catch (e) {
+            console.warn("failed to release client:", e);
+        }
+    }
+}
+exports.WasmCore = WasmCore;
 /**
  *  An implementation of the `Core` interface that shares resources across all clients.
  */
 class SharedCore {
+    constructor() {
+        this.inner = new WasmCore();
+    }
+    setInner(core) {
+        this.inner = core;
+    }
     initClient(config) {
         return __awaiter(this, void 0, void 0, function* () {
             const serializedConfig = JSON.stringify(config);
             try {
-                return yield (0, sdk_core_1.init_client)(serializedConfig);
+                return yield this.inner.initClient(serializedConfig);
             }
             catch (e) {
                 (0, errors_1.throwError)(e);
@@ -41,7 +78,7 @@ class SharedCore {
                 (0, errors_1.throwError)(`message size exceeds the limit of ${messageLimit} bytes, please contact 1Password at support@1password.com or https://developer.1password.com/joinslack if you need help."`);
             }
             try {
-                return yield (0, sdk_core_1.invoke)(serializedConfig);
+                return yield this.inner.invoke(serializedConfig);
             }
             catch (e) {
                 (0, errors_1.throwError)(e);
@@ -64,7 +101,7 @@ class SharedCore {
     }
     releaseClient(clientId) {
         const serializedId = JSON.stringify(clientId);
-        (0, sdk_core_1.release_client)(serializedId);
+        this.inner.releaseClient(serializedId);
     }
 }
 exports.SharedCore = SharedCore;

package/dist/groups.d.ts

@@ -0,0 +1,13 @@
+import { InnerClient } from "./core.js";
+import { Group, GroupGetParams } from "./types.js";
+/**
+ * The Groups API holds all the operations the SDK client can perform on 1Password groups.
+ */
+export interface GroupsApi {
+    get(groupId: string, groupParams: GroupGetParams): Promise<Group>;
+}
+export declare class Groups implements GroupsApi {
+    #private;
+    constructor(inner: InnerClient);
+    get(groupId: string, groupParams: GroupGetParams): Promise<Group>;
+}

package/dist/groups.js

@@ -0,0 +1,51 @@
+"use strict";
+// Code generated by op-codegen - DO NOT EDIT MANUALLY
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Groups_inner;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Groups = void 0;
+const types_js_1 = require("./types.js");
+class Groups {
+    constructor(inner) {
+        _Groups_inner.set(this, void 0);
+        __classPrivateFieldSet(this, _Groups_inner, inner, "f");
+    }
+    get(groupId, groupParams) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Groups_inner, "f").id,
+                    parameters: {
+                        name: "GroupsGet",
+                        parameters: {
+                            group_id: groupId,
+                            group_params: groupParams,
+                        },
+                    },
+                },
+            };
+            return JSON.parse(yield __classPrivateFieldGet(this, _Groups_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
+}
+exports.Groups = Groups;
+_Groups_inner = new WeakMap();

package/dist/items.d.ts

@@ -1,5 +1,5 @@
 import { InnerClient } from "./core.js";
-import { Item, ItemCreateParams, ItemListFilter, ItemOverview } from "./types.js";
+import { Item, ItemCreateParams, ItemListFilter, ItemOverview, ItemsDeleteAllResponse, ItemsGetAllResponse, ItemsUpdateAllResponse } from "./types.js";
 import { ItemsSharesApi } from "./items_shares.js";
 import { ItemsFilesApi } from "./items_files.js";
 /**
@@ -12,10 +12,18 @@ export interface ItemsApi {
      * Create a new item.
      */
     create(params: ItemCreateParams): Promise<Item>;
+    /**
+     * Create items in batch, within a single vault.
+     */
+    createAll(vaultId: string, params: ItemCreateParams[]): Promise<ItemsUpdateAllResponse>;
     /**
      * Get an item by vault and item ID
      */
     get(vaultId: string, itemId: string): Promise<Item>;
+    /**
+     * Get items by vault and their item IDs.
+     */
+    getAll(vaultId: string, itemIds: string[]): Promise<ItemsGetAllResponse>;
     /**
      * Update an existing item.
      */
@@ -24,6 +32,10 @@ export interface ItemsApi {
      * Delete an item.
      */
     delete(vaultId: string, itemId: string): any;
+    /**
+     * Delete items in batch, within a single vault.
+     */
+    deleteAll(vaultId: string, itemIds: string[]): Promise<ItemsDeleteAllResponse>;
     /**
      * Archive an item.
      */
@@ -42,10 +54,18 @@ export declare class Items implements ItemsApi {
      * Create a new item.
      */
     create(params: ItemCreateParams): Promise<Item>;
+    /**
+     * Create items in batch, within a single vault.
+     */
+    createAll(vaultId: string, params: ItemCreateParams[]): Promise<ItemsUpdateAllResponse>;
     /**
      * Get an item by vault and item ID
      */
     get(vaultId: string, itemId: string): Promise<Item>;
+    /**
+     * Get items by vault and their item IDs.
+     */
+    getAll(vaultId: string, itemIds: string[]): Promise<ItemsGetAllResponse>;
     /**
      * Update an existing item.
      */
@@ -54,6 +74,10 @@ export declare class Items implements ItemsApi {
      * Delete an item.
      */
     delete(vaultId: string, itemId: string): Promise<void>;
+    /**
+     * Delete items in batch, within a single vault.
+     */
+    deleteAll(vaultId: string, itemIds: string[]): Promise<ItemsDeleteAllResponse>;
     /**
      * Archive an item.
      */

package/dist/items.js

@@ -52,6 +52,26 @@ class Items {
             return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
+    /**
+     * Create items in batch, within a single vault.
+     */
+    createAll(vaultId, params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Items_inner, "f").id,
+                    parameters: {
+                        name: "ItemsCreateAll",
+                        parameters: {
+                            vault_id: vaultId,
+                            params,
+                        },
+                    },
+                },
+            };
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
     /**
      * Get an item by vault and item ID
      */
@@ -72,6 +92,26 @@ class Items {
             return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
+    /**
+     * Get items by vault and their item IDs.
+     */
+    getAll(vaultId, itemIds) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Items_inner, "f").id,
+                    parameters: {
+                        name: "ItemsGetAll",
+                        parameters: {
+                            vault_id: vaultId,
+                            item_ids: itemIds,
+                        },
+                    },
+                },
+            };
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
     /**
      * Update an existing item.
      */
@@ -111,6 +151,26 @@ class Items {
             yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig);
         });
     }
+    /**
+     * Delete items in batch, within a single vault.
+     */
+    deleteAll(vaultId, itemIds) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Items_inner, "f").id,
+                    parameters: {
+                        name: "ItemsDeleteAll",
+                        parameters: {
+                            vault_id: vaultId,
+                            item_ids: itemIds,
+                        },
+                    },
+                },
+            };
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
     /**
      * Archive an item.
      */

package/dist/sdk.d.ts

@@ -6,6 +6,7 @@ export { Secrets } from "./secrets.js";
 export * from "./client.js";
 export * from "./errors.js";
 export * from "./types.js";
+export { DesktopAuth } from "./configuration.js";
 /**
  * Creates a default 1Password SDK client.
  * @returns The authenticated 1Password SDK client.

package/dist/sdk.js

@@ -24,7 +24,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createClient = exports.Secrets = exports.DEFAULT_INTEGRATION_VERSION = exports.DEFAULT_INTEGRATION_NAME = void 0;
+exports.createClient = exports.DesktopAuth = exports.Secrets = exports.DEFAULT_INTEGRATION_VERSION = exports.DEFAULT_INTEGRATION_NAME = void 0;
 const core_js_1 = require("./core.js");
 const client_builder_js_1 = require("./client_builder.js");
 exports.DEFAULT_INTEGRATION_NAME = "Unknown";
@@ -35,6 +35,8 @@ Object.defineProperty(exports, "Secrets", { enumerable: true, get: function () {
 __exportStar(require("./client.js"), exports);
 __exportStar(require("./errors.js"), exports);
 __exportStar(require("./types.js"), exports);
+var configuration_js_1 = require("./configuration.js");
+Object.defineProperty(exports, "DesktopAuth", { enumerable: true, get: function () { return configuration_js_1.DesktopAuth; } });
 /**
  * Creates a default 1Password SDK client.
  * @returns The authenticated 1Password SDK client.

package/dist/shared_lib_core.d.ts

@@ -0,0 +1,16 @@
+import { Core } from "./core";
+/**
+ * SharedLibCore: wrapper around the dynamically loaded shared library
+ */
+export declare class SharedLibCore implements Core {
+    private lib;
+    private acccountName;
+    constructor(accountName: string);
+    /**
+     * callSharedLibrary - send string to native function, receive string back.
+     */
+    private callSharedLibrary;
+    initClient(config: string): Promise<string>;
+    invoke(invokeConfigBytes: string): Promise<string>;
+    releaseClient(clientId: string): void;
+}

package/dist/shared_lib_core.js

@@ -0,0 +1,165 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedLibCore = void 0;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+/**
+ * Find the 1Password shared lib path by asking an the wasm core synchronously.
+ */
+const find1PasswordLibPath = () => {
+    const platform = os.platform();
+    const appRoot = path.dirname(process.execPath);
+    let searchPaths = [];
+    // Define lists of possible locations for each platform.
+    switch (platform) {
+        case "darwin": // macOS
+            searchPaths = [
+                "/Applications/1Password.app/Contents/Frameworks/libop_sdk_ipc_client.dylib",
+                path.join(os.homedir(), "/Applications/1Password.app/Contents/Frameworks/libop_sdk_ipc_client.dylib"),
+            ];
+            break;
+        case "linux": // Linux
+            searchPaths = [
+                "/usr/bin/1password/libop_sdk_ipc_client.so",
+                "/opt/1Password/libop_sdk_ipc_client.so",
+                "/snap/bin/1password/libop_sdk_ipc_client.so",
+            ];
+            break;
+        default:
+            throw new Error(`Unsupported platform: ${platform}`);
+    }
+    // Iterate through the possible paths and return the first one that exists.
+    for (const addonPath of searchPaths) {
+        if (fs.existsSync(addonPath)) {
+            return addonPath;
+        }
+    }
+    // If the loop completes without finding the file, throw an error.
+    throw new Error("1Password desktop application not found");
+};
+/**
+ * SharedLibCore: wrapper around the dynamically loaded shared library
+ */
+class SharedLibCore {
+    constructor(accountName) {
+        this.lib = null;
+        try {
+            const libPath = find1PasswordLibPath();
+            const moduleStub = { exports: {} };
+            process.dlopen(moduleStub, libPath);
+            // Safely check the structure of the loaded module before casting.
+            if (typeof moduleStub === "object" &&
+                moduleStub !== null &&
+                typeof moduleStub.exports === "object" &&
+                moduleStub.exports !== null &&
+                "sendMessage" in moduleStub.exports &&
+                typeof moduleStub.exports.sendMessage ===
+                    "function") {
+                this.lib = moduleStub.exports;
+            }
+            else {
+                throw new Error("Failed to initialize native library: sendMessage function not found on module.");
+            }
+        }
+        catch (e) {
+            console.error("A critical error occurred while loading the native addon:", e);
+            this.lib = null;
+        }
+        this.acccountName = accountName;
+    }
+    /**
+     * callSharedLibrary - send string to native function, receive string back.
+     */
+    callSharedLibrary(input, operation_type) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.lib) {
+                throw new Error("Native library is not available.");
+            }
+            if (!input || input.length === 0) {
+                throw new Error("internal: empty input");
+            }
+            const inputEncoded = Buffer.from(input, "utf8").toString("base64");
+            const req = {
+                account_name: this.acccountName,
+                kind: operation_type,
+                payload: inputEncoded,
+            };
+            const inputBuf = Buffer.from(JSON.stringify(req), "utf8");
+            try {
+                const nativeResponse = yield this.lib.sendMessage(inputBuf);
+                if (!(nativeResponse instanceof Uint8Array)) {
+                    throw new Error(`Native function returned an unexpected type. Expected Uint8Array, got ${typeof nativeResponse}`);
+                }
+                const respString = new TextDecoder().decode(nativeResponse);
+                const response = JSON.parse(respString);
+                if (response.success) {
+                    const decodedPayload = Buffer.from(response.payload).toString("utf8");
+                    // On success, the payload is the actual result string
+                    return decodedPayload;
+                }
+                else {
+                    // On failure, convert the error payload to a readable string and throw
+                    const errorMessage = Array.isArray(response.payload)
+                        ? String.fromCharCode(...response.payload)
+                        : JSON.stringify(response.payload);
+                    throw new Error(`Native library returned an error: ${errorMessage}`);
+                }
+            }
+            catch (e) {
+                // Catch errors from the native call or from JSON parsing
+                console.error("An error occurred during the native library call:", e);
+                throw e;
+            }
+        });
+    }
+    // Core interface implementation
+    initClient(config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.callSharedLibrary(config, "init_client");
+        });
+    }
+    invoke(invokeConfigBytes) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.callSharedLibrary(invokeConfigBytes, "invoke");
+        });
+    }
+    releaseClient(clientId) {
+        this.callSharedLibrary(clientId, "release_client").catch((err) => {
+            console.warn("failed to release client:", err);
+        });
+    }
+}
+exports.SharedLibCore = SharedLibCore;

package/dist/types.d.ts

@@ -44,6 +44,79 @@ export interface GeneratePasswordResponse {
     /** The generated password. */
     password: string;
 }
+export declare enum GroupType {
+    /**
+     * The owners group, which gives the following permissions:
+     * - Do everything the Admin group can do
+     * - See every vault other than the personal vaults
+     * - Change people's names
+     * - See billing
+     * - Change billing
+     * - Make other people owners
+     * - Delete a person
+     */
+    Owners = "owners",
+    /**
+     * The administrators group, which gives the following permissions:
+     * - Perform recovery
+     * - Create new vaults
+     * - Invite new members
+     * - See vault metadata, including the vault name and who has access.
+     * - Make other people admins
+     */
+    Administrators = "administrators",
+    /**
+     * The recovery group. It contains recovery keysets, and is added to every vault to allow for recovery.
+     *
+     * No one is added to this.
+     */
+    Recovery = "recovery",
+    /**
+     * The external account managers group or EAM is a mandatory group for managed accounts that has
+     * same permissions as the owners.
+     */
+    ExternalAccountManagers = "externalAccountManagers",
+    /** Members of a team that a user is on. */
+    TeamMembers = "teamMembers",
+    /** A custom, user defined group. */
+    UserDefined = "userDefined",
+    /** Support for new or renamed group types */
+    Unsupported = "unsupported"
+}
+export declare enum GroupState {
+    /** This group is active */
+    Active = "active",
+    /** This group has been deleted */
+    Deleted = "deleted",
+    /** This group is in an unknown state */
+    Unsupported = "unsupported"
+}
+export declare enum VaultAccessorType {
+    User = "user",
+    Group = "group"
+}
+/** Represents the vault access information. */
+export interface VaultAccess {
+    /** The vault's UUID. */
+    vaultUuid: string;
+    /** The vault's accessor type. */
+    accessorType: VaultAccessorType;
+    /** The vault's accessor UUID. */
+    accessorUuid: string;
+    /** The permissions granted to this vault */
+    permissions: number;
+}
+export interface Group {
+    id: string;
+    title: string;
+    description: string;
+    groupType: GroupType;
+    state: GroupState;
+    vaultAccess?: VaultAccess[];
+}
+export interface GroupGetParams {
+    vaultPermissions?: boolean;
+}
 export declare enum ItemCategory {
     Login = "Login",
     SecureNote = "SecureNote",
@@ -331,6 +404,62 @@ export interface ItemShareParams {
     /** Whether the item can only be viewed once per recipient */
     oneTimeOnly: boolean;
 }
+export interface Response<T, E> {
+    content?: T;
+    error?: E;
+}
+export type ItemUpdateFailureReason = 
+/** Item update operation failed due to bad user input. */
+{
+    type: "itemValidationError";
+    message: ErrorMessage;
+}
+/** Item update operation is forbidden, permission issue. Make sure you have the correct permissions to update items in this vault. */
+ | {
+    type: "itemStatusPermissionError";
+    message?: undefined;
+}
+/** Item update operation failed due to incorrect version. */
+ | {
+    type: "itemStatusIncorrectItemVersion";
+    message?: undefined;
+}
+/** Item update operation failed because a file reference didn't match a known file. */
+ | {
+    type: "itemStatusFileNotFound";
+    message?: undefined;
+}
+/** Item update request is too big to be sent to the server. */
+ | {
+    type: "itemStatusTooBig";
+    message?: undefined;
+}
+/** The item was not found */
+ | {
+    type: "itemNotFound";
+    message?: undefined;
+}
+/** Item update operation experienced an internal error. */
+ | {
+    type: "internal";
+    message: ErrorMessage;
+};
+export interface ItemsDeleteAllResponse {
+    individualResponses: Record<string, Response<undefined, ItemUpdateFailureReason>>;
+}
+export type ItemsGetAllError = {
+    type: "itemNotFound";
+    message?: undefined;
+} | {
+    type: "internal";
+    message: ErrorMessage;
+};
+export interface ItemsGetAllResponse {
+    individualResponses: Response<Item, ItemsGetAllError>[];
+}
+export interface ItemsUpdateAllResponse {
+    individualResponses: Response<Item, ItemUpdateFailureReason>[];
+}
 /** Additional attributes for OTP fields. */
 export interface OtpFieldDetails {
     /** The OTP code, if successfully computed */
@@ -338,10 +467,6 @@ export interface OtpFieldDetails {
     /** The error message, if the OTP code could not be computed */
     errorMessage?: string;
 }
-export interface Response<T, E> {
-    content?: T;
-    error?: E;
-}
 export interface ResolvedReference {
     secret: string;
     itemId: string;
@@ -439,12 +564,61 @@ export interface SshKeyAttributes {
     /** The key type ("Ed25519" or "RSA, {length}-bit") */
     keyType: string;
 }
-/** Represents a decrypted 1Password vault. */
+/** Represents the vault type. */
+export declare enum VaultType {
+    Personal = "personal",
+    Everyone = "everyone",
+    Transfer = "transfer",
+    UserCreated = "userCreated",
+    Unsupported = "unsupported"
+}
+/** Represents regular vault information together with the vault's access information. */
+export interface Vault {
+    /** The vault's ID. */
+    id: string;
+    /** The vault's title. */
+    title: string;
+    /** The description of the vault. */
+    description: string;
+    /** The type of the vault. */
+    vaultType: VaultType;
+    /** The number of active items within the vault. */
+    activeItemCount: number;
+    /** The content version number of the vault. It gets incremented whenever the state of the vault's contents changes (e.g. items from within the vault get created or updated). */
+    contentVersion: number;
+    /** The attribute version number of the vault. It gets incremented whenever vault presentation information changes, such as its title or icon. */
+    attributeVersion: number;
+    /** The access information associated with the vault. */
+    access?: VaultAccess[];
+}
+/** Represents the possible query parameters used for retrieving extra information about a vault. */
+export interface VaultGetParams {
+    /** The vault's accessor params. */
+    accessors?: boolean;
+}
+export interface VaultListParams {
+    decryptDetails?: boolean;
+}
+/** Holds information about a 1Password Vault. */
 export interface VaultOverview {
-    /** The vault's ID */
+    /** The vault's ID. */
     id: string;
-    /** The vault's title */
+    /** The vault's title. */
     title: string;
+    /** The description of this vault. */
+    description: string;
+    /** The type of the vault. */
+    vaultType: VaultType;
+    /** The number of active items within the vault. */
+    activeItemCount: number;
+    /** The content version number of the vault. It gets incremented whenever the state of the vault's contents changes (e.g. items from within the vault get created or updated). */
+    contentVersion: number;
+    /** The attribute version number of the vault. It gets incremented whenever vault presentation information changes, such as its title or icon. */
+    attributeVersion: number;
+    /** The time the vault was created at */
+    createdAt: Date;
+    /** The time the vault was updated at */
+    updatedAt: Date;
 }
 export type ItemListFilter = {
     type: "ByState";

package/dist/types.js

@@ -3,7 +3,61 @@
  Generated by typeshare 1.13.2
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReplacerFunc = exports.ReviverFunc = exports.WordListType = exports.SeparatorType = exports.AllowedRecipientType = exports.AllowedType = exports.ItemShareDuration = exports.ItemState = exports.AutofillBehavior = exports.ItemFieldType = exports.ItemCategory = void 0;
+exports.ReplacerFunc = exports.ReviverFunc = exports.WordListType = exports.SeparatorType = exports.VaultType = exports.AllowedRecipientType = exports.AllowedType = exports.ItemShareDuration = exports.ItemState = exports.AutofillBehavior = exports.ItemFieldType = exports.ItemCategory = exports.VaultAccessorType = exports.GroupState = exports.GroupType = void 0;
+var GroupType;
+(function (GroupType) {
+    /**
+     * The owners group, which gives the following permissions:
+     * - Do everything the Admin group can do
+     * - See every vault other than the personal vaults
+     * - Change people's names
+     * - See billing
+     * - Change billing
+     * - Make other people owners
+     * - Delete a person
+     */
+    GroupType["Owners"] = "owners";
+    /**
+     * The administrators group, which gives the following permissions:
+     * - Perform recovery
+     * - Create new vaults
+     * - Invite new members
+     * - See vault metadata, including the vault name and who has access.
+     * - Make other people admins
+     */
+    GroupType["Administrators"] = "administrators";
+    /**
+     * The recovery group. It contains recovery keysets, and is added to every vault to allow for recovery.
+     *
+     * No one is added to this.
+     */
+    GroupType["Recovery"] = "recovery";
+    /**
+     * The external account managers group or EAM is a mandatory group for managed accounts that has
+     * same permissions as the owners.
+     */
+    GroupType["ExternalAccountManagers"] = "externalAccountManagers";
+    /** Members of a team that a user is on. */
+    GroupType["TeamMembers"] = "teamMembers";
+    /** A custom, user defined group. */
+    GroupType["UserDefined"] = "userDefined";
+    /** Support for new or renamed group types */
+    GroupType["Unsupported"] = "unsupported";
+})(GroupType || (exports.GroupType = GroupType = {}));
+var GroupState;
+(function (GroupState) {
+    /** This group is active */
+    GroupState["Active"] = "active";
+    /** This group has been deleted */
+    GroupState["Deleted"] = "deleted";
+    /** This group is in an unknown state */
+    GroupState["Unsupported"] = "unsupported";
+})(GroupState || (exports.GroupState = GroupState = {}));
+var VaultAccessorType;
+(function (VaultAccessorType) {
+    VaultAccessorType["User"] = "user";
+    VaultAccessorType["Group"] = "group";
+})(VaultAccessorType || (exports.VaultAccessorType = VaultAccessorType = {}));
 var ItemCategory;
 (function (ItemCategory) {
     ItemCategory["Login"] = "Login";
@@ -102,6 +156,15 @@ var AllowedRecipientType;
     /** Recipients can be specified by domain */
     AllowedRecipientType["Domain"] = "Domain";
 })(AllowedRecipientType || (exports.AllowedRecipientType = AllowedRecipientType = {}));
+/** Represents the vault type. */
+var VaultType;
+(function (VaultType) {
+    VaultType["Personal"] = "personal";
+    VaultType["Everyone"] = "everyone";
+    VaultType["Transfer"] = "transfer";
+    VaultType["UserCreated"] = "userCreated";
+    VaultType["Unsupported"] = "unsupported";
+})(VaultType || (exports.VaultType = VaultType = {}));
 var SeparatorType;
 (function (SeparatorType) {
     /**

package/dist/vaults.d.ts

@@ -1,19 +1,23 @@
 import { InnerClient } from "./core.js";
-import { VaultOverview } from "./types.js";
+import { Vault, VaultGetParams, VaultListParams, VaultOverview } from "./types.js";
 /**
  * The Vaults API holds all the operations the SDK client can perform on 1Password vaults.
  */
 export interface VaultsApi {
     /**
-     * List all vaults
+     * List information about vaults that's configurable based on some input parameters.
      */
-    list(): Promise<VaultOverview[]>;
+    list(params?: VaultListParams): Promise<VaultOverview[]>;
+    getOverview(vaultUuid: string): Promise<VaultOverview>;
+    get(vaultUuid: string, vaultParams: VaultGetParams): Promise<Vault>;
 }
 export declare class Vaults implements VaultsApi {
     #private;
     constructor(inner: InnerClient);
     /**
-     * List all vaults
+     * List information about vaults that's configurable based on some input parameters.
      */
-    list(): Promise<VaultOverview[]>;
+    list(params: VaultListParams): Promise<VaultOverview[]>;
+    getOverview(vaultUuid: string): Promise<VaultOverview>;
+    get(vaultUuid: string, vaultParams: VaultGetParams): Promise<Vault>;
 }

package/dist/vaults.js

@@ -30,16 +30,51 @@ class Vaults {
         __classPrivateFieldSet(this, _Vaults_inner, inner, "f");
     }
     /**
-     * List all vaults
+     * List information about vaults that's configurable based on some input parameters.
      */
-    list() {
+    list(params) {
         return __awaiter(this, void 0, void 0, function* () {
             const invocationConfig = {
                 invocation: {
                     clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
                     parameters: {
                         name: "VaultsList",
-                        parameters: {},
+                        parameters: {
+                            params,
+                        },
+                    },
+                },
+            };
+            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
+    getOverview(vaultUuid) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
+                    parameters: {
+                        name: "VaultsGetOverview",
+                        parameters: {
+                            vault_uuid: vaultUuid,
+                        },
+                    },
+                },
+            };
+            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
+    get(vaultUuid, vaultParams) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
+                    parameters: {
+                        name: "VaultsGet",
+                        parameters: {
+                            vault_uuid: vaultUuid,
+                            vault_params: vaultParams,
+                        },
                     },
                 },
             };

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "0.3.0";
-export declare const SDK_BUILD_NUMBER = "0030001";
+export declare const SDK_VERSION = "0.4.0-beta.1";
+export declare const SDK_BUILD_NUMBER = "0040001";

package/dist/version.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_BUILD_NUMBER = exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.3.0";
-exports.SDK_BUILD_NUMBER = "0030001";
-const SDK_CORE_VERSION = "0.3.0";
+exports.SDK_VERSION = "0.4.0-beta.1";
+exports.SDK_BUILD_NUMBER = "0040001";
+const SDK_CORE_VERSION = "0.4.0-beta.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1password/sdk",
-  "version": "0.3.0",
+  "version": "0.4.0-beta.1",
   "description": "The 1Password JavaScript SDK offers programmatic read access to your secrets in 1Password in an interface native to JavaScript. The SDK currently supports `Node.JS`",
   "scripts": {
     "build": "tsc",
@@ -26,7 +26,7 @@
   "main": "./dist/sdk.js",
   "types": "./dist/sdk.d.ts",
   "dependencies": {
-    "@1password/sdk-core": "0.3.0"
+    "@1password/sdk-core": "0.4.0-beta.1"
   },
   "devDependencies": {
     "@1password/eslint-config": "^4.0.0",