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

package/README.md

@@ -18,7 +18,7 @@
 
 To use the 1Password JavaScript SDK in your project:
 
-1. [Create a service account](https://my.1password.com/developer-tools/infrastructure-secrets/serviceaccount/) and give it the appropriate permissions in the vaults where the items you want to use with the SDK are saved.
+1. [Create a service account](https://my.1password.com/developer-tools/infrastructure-secrets/serviceaccount/?source=github-sdk) and give it the appropriate permissions in the vaults where the items you want to use with the SDK are saved.
 2. Provision your service account token. We recommend provisioning your token from the environment. For example, to export your token to the `OP_SERVICE_ACCOUNT_TOKEN` environment variable:
 
    **macOS or Linux**

package/dist/client_builder.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createClientWithCore = void 0;
+const core_js_1 = require("./core.js");
 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");
@@ -26,10 +27,7 @@ const createClientWithCore = (config, core) => __awaiter(void 0, void 0, void 0,
         core.setInner(new shared_lib_core_js_1.SharedLibCore(authConfig.accountName));
     }
     const clientId = yield core.initClient(authConfig);
-    const inner = {
-        id: parseInt(clientId, 10),
-        core,
-    };
+    const inner = new core_js_1.InnerClient(parseInt(clientId, 10), core, authConfig);
     const client = new client_js_1.Client(inner);
     // Cleans up associated memory from core when client instance goes out of scope.
     finalizationRegistry.register(client, inner);

package/dist/configuration.d.ts

@@ -1,6 +1,6 @@
 import { ClientAuthConfig } from "./core.js";
 export declare const LANGUAGE = "JS";
-export declare const VERSION = "0040001";
+export declare const VERSION = "0040003";
 export interface ClientConfiguration {
     auth: Auth;
     integrationName: string;
@@ -8,7 +8,7 @@ export interface ClientConfiguration {
 }
 type Auth = string | DesktopAuth;
 /**
- * Setting that specifies that a client should use the desktop app to authenticate.
+ * Setting that specifies a client should use the desktop app to authenticate. Set accountName to your 1Password account name as shown at the top left sidebar of the app, or your account UUID.
  */
 export declare class DesktopAuth {
     accountName: string;

package/dist/configuration.js

@@ -9,7 +9,7 @@ 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.
+ * Setting that specifies a client should use the desktop app to authenticate. Set accountName to your 1Password account name as shown at the top left sidebar of the app, or your account UUID.
  */
 class DesktopAuth {
     constructor(accountName) {

package/dist/core.d.ts

@@ -82,8 +82,11 @@ export declare class SharedCore {
 /**
  *  Represents the client instance on which a call is made.
  */
-export interface InnerClient {
+export declare class InnerClient {
     id: number;
-    core: SharedCore;
+    readonly core: SharedCore;
+    config: ClientAuthConfig;
+    constructor(id: number, core: SharedCore, config: ClientAuthConfig);
+    invoke(config: InvokeConfig): Promise<string>;
 }
 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 = exports.WasmCore = void 0;
+exports.InnerClient = exports.SharedCore = exports.WasmCore = void 0;
 const sdk_core_1 = require("@1password/sdk-core");
 const types_1 = require("./types");
 const errors_1 = require("./errors");
@@ -61,12 +61,7 @@ class SharedCore {
     initClient(config) {
         return __awaiter(this, void 0, void 0, function* () {
             const serializedConfig = JSON.stringify(config);
-            try {
-                return yield this.inner.initClient(serializedConfig);
-            }
-            catch (e) {
-                (0, errors_1.throwError)(e);
-            }
+            return this.inner.initClient(serializedConfig);
         });
     }
     invoke(config) {
@@ -77,12 +72,7 @@ class SharedCore {
             if (new TextEncoder().encode(serializedConfig).length > messageLimit) {
                 (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 this.inner.invoke(serializedConfig);
-            }
-            catch (e) {
-                (0, errors_1.throwError)(e);
-            }
+            return this.inner.invoke(serializedConfig);
         });
     }
     invoke_sync(config) {
@@ -92,12 +82,7 @@ class SharedCore {
         if (new TextEncoder().encode(serializedConfig).length > messageLimit) {
             (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 (0, sdk_core_1.invoke_sync)(serializedConfig);
-        }
-        catch (e) {
-            (0, errors_1.throwError)(e);
-        }
+        return (0, sdk_core_1.invoke_sync)(serializedConfig);
     }
     releaseClient(clientId) {
         const serializedId = JSON.stringify(clientId);
@@ -105,3 +90,30 @@ class SharedCore {
     }
 }
 exports.SharedCore = SharedCore;
+/**
+ *  Represents the client instance on which a call is made.
+ */
+class InnerClient {
+    constructor(id, core, config) {
+        this.id = id;
+        this.core = core;
+        this.config = config;
+    }
+    invoke(config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                return yield this.core.invoke(config);
+            }
+            catch (err) {
+                if (err instanceof errors_1.DesktopSessionExpiredError) {
+                    const newId = yield this.core.initClient(this.config);
+                    this.id = parseInt(newId, 10);
+                    config.invocation.clientId = this.id;
+                    return yield this.core.invoke(config);
+                }
+                throw err;
+            }
+        });
+    }
+}
+exports.InnerClient = InnerClient;

package/dist/errors.d.ts

@@ -1,3 +1,7 @@
+export declare class DesktopSessionExpiredError extends Error {
+    message: string;
+    constructor(message: string);
+}
 export declare class RateLimitExceededError extends Error {
     message: string;
     constructor(message: string);

package/dist/errors.js

@@ -1,7 +1,14 @@
 "use strict";
 // Code generated by op-codegen - DO NOT EDIT MANUALLY
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.throwError = exports.RateLimitExceededError = void 0;
+exports.throwError = exports.RateLimitExceededError = exports.DesktopSessionExpiredError = void 0;
+class DesktopSessionExpiredError extends Error {
+    constructor(message) {
+        super();
+        this.message = message;
+    }
+}
+exports.DesktopSessionExpiredError = DesktopSessionExpiredError;
 class RateLimitExceededError extends Error {
     constructor(message) {
         super();
@@ -18,6 +25,8 @@ const throwError = (errString) => {
         throw new Error(errString);
     }
     switch (err.name) {
+        case "DesktopSessionExpired":
+            throw new DesktopSessionExpiredError(err.message);
         case "RateLimitExceeded":
             throw new RateLimitExceededError(err.message);
         default:

package/dist/groups.d.ts

@@ -4,10 +4,16 @@ 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 a group by its ID and parameters.
+     */
     get(groupId: string, groupParams: GroupGetParams): Promise<Group>;
 }
 export declare class Groups implements GroupsApi {
     #private;
     constructor(inner: InnerClient);
+    /**
+     * Get a group by its ID and parameters.
+     */
     get(groupId: string, groupParams: GroupGetParams): Promise<Group>;
 }

package/dist/groups.js

@@ -29,6 +29,9 @@ class Groups {
         _Groups_inner.set(this, void 0);
         __classPrivateFieldSet(this, _Groups_inner, inner, "f");
     }
+    /**
+     * Get a group by its ID and parameters.
+     */
     get(groupId, groupParams) {
         return __awaiter(this, void 0, void 0, function* () {
             const invocationConfig = {
@@ -43,7 +46,7 @@ class Groups {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Groups_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Groups_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
 }

package/dist/items.d.ts

@@ -17,7 +17,7 @@ export interface ItemsApi {
      */
     createAll(vaultId: string, params: ItemCreateParams[]): Promise<ItemsUpdateAllResponse>;
     /**
-     * Get an item by vault and item ID
+     * Get an item by vault and item ID.
      */
     get(vaultId: string, itemId: string): Promise<Item>;
     /**
@@ -31,7 +31,7 @@ export interface ItemsApi {
     /**
      * Delete an item.
      */
-    delete(vaultId: string, itemId: string): any;
+    delete(vaultId: string, itemId: string): Promise<void>;
     /**
      * Delete items in batch, within a single vault.
      */
@@ -39,7 +39,7 @@ export interface ItemsApi {
     /**
      * Archive an item.
      */
-    archive(vaultId: string, itemId: string): any;
+    archive(vaultId: string, itemId: string): Promise<void>;
     /**
      * List items based on filters.
      */
@@ -59,7 +59,7 @@ export declare class Items implements ItemsApi {
      */
     createAll(vaultId: string, params: ItemCreateParams[]): Promise<ItemsUpdateAllResponse>;
     /**
-     * Get an item by vault and item ID
+     * Get an item by vault and item ID.
      */
     get(vaultId: string, itemId: string): Promise<Item>;
     /**

package/dist/items.js

@@ -49,7 +49,7 @@ class Items {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -69,11 +69,11 @@ class Items {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
-     * Get an item by vault and item ID
+     * Get an item by vault and item ID.
      */
     get(vaultId, itemId) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -89,7 +89,7 @@ class Items {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -109,7 +109,7 @@ class Items {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -128,7 +128,7 @@ class Items {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -148,7 +148,7 @@ class Items {
                     },
                 },
             };
-            yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig);
+            yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig);
         });
     }
     /**
@@ -168,7 +168,7 @@ class Items {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -188,7 +188,7 @@ class Items {
                     },
                 },
             };
-            yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig);
+            yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig);
         });
     }
     /**
@@ -208,7 +208,7 @@ class Items {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Items_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
 }

package/dist/items_files.d.ts

@@ -2,19 +2,19 @@ import { InnerClient } from "./core.js";
 import { DocumentCreateParams, FileAttributes, FileCreateParams, Item } from "./types.js";
 export interface ItemsFilesApi {
     /**
-     * Attach files to Items
+     * Attach files to Items.
      */
     attach(item: Item, fileParams: FileCreateParams): Promise<Item>;
     /**
-     * Read file content from the Item
+     * Read file content from the Item.
      */
     read(vaultId: string, itemId: string, attr: FileAttributes): Promise<Uint8Array>;
     /**
-     * Delete a field file from Item using the section and field IDs
+     * Delete a field file from Item using the section and field IDs.
      */
     delete(item: Item, sectionId: string, fieldId: string): Promise<Item>;
     /**
-     * Replace the document file within a document item
+     * Replace the document file within a document item.
      */
     replaceDocument(item: Item, docParams: DocumentCreateParams): Promise<Item>;
 }
@@ -22,19 +22,19 @@ export declare class ItemsFiles implements ItemsFilesApi {
     #private;
     constructor(inner: InnerClient);
     /**
-     * Attach files to Items
+     * Attach files to Items.
      */
     attach(item: Item, fileParams: FileCreateParams): Promise<Item>;
     /**
-     * Read file content from the Item
+     * Read file content from the Item.
      */
     read(vaultId: string, itemId: string, attr: FileAttributes): Promise<Uint8Array>;
     /**
-     * Delete a field file from Item using the section and field IDs
+     * Delete a field file from Item using the section and field IDs.
      */
     delete(item: Item, sectionId: string, fieldId: string): Promise<Item>;
     /**
-     * Replace the document file within a document item
+     * Replace the document file within a document item.
      */
     replaceDocument(item: Item, docParams: DocumentCreateParams): Promise<Item>;
 }

package/dist/items_files.js

@@ -30,7 +30,7 @@ class ItemsFiles {
         __classPrivateFieldSet(this, _ItemsFiles_inner, inner, "f");
     }
     /**
-     * Attach files to Items
+     * Attach files to Items.
      */
     attach(item, fileParams) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -46,11 +46,11 @@ class ItemsFiles {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsFiles_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsFiles_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
-     * Read file content from the Item
+     * Read file content from the Item.
      */
     read(vaultId, itemId, attr) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -67,11 +67,11 @@ class ItemsFiles {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsFiles_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsFiles_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
-     * Delete a field file from Item using the section and field IDs
+     * Delete a field file from Item using the section and field IDs.
      */
     delete(item, sectionId, fieldId) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -88,11 +88,11 @@ class ItemsFiles {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsFiles_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsFiles_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
-     * Replace the document file within a document item
+     * Replace the document file within a document item.
      */
     replaceDocument(item, docParams) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -108,7 +108,7 @@ class ItemsFiles {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsFiles_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsFiles_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
 }

package/dist/items_shares.js

@@ -46,7 +46,7 @@ class ItemsShares {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsShares_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsShares_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -66,7 +66,7 @@ class ItemsShares {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsShares_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsShares_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -87,7 +87,7 @@ class ItemsShares {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsShares_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _ItemsShares_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
 }

package/dist/sdk.d.ts

@@ -3,10 +3,10 @@ import { Client } from "./client.js";
 export declare const DEFAULT_INTEGRATION_NAME = "Unknown";
 export declare const DEFAULT_INTEGRATION_VERSION = "Unknown";
 export { Secrets } from "./secrets.js";
+export { DesktopAuth } from "./configuration.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

@@ -32,11 +32,11 @@ exports.DEFAULT_INTEGRATION_VERSION = "Unknown";
 // auto-generated static exports
 var secrets_js_1 = require("./secrets.js");
 Object.defineProperty(exports, "Secrets", { enumerable: true, get: function () { return secrets_js_1.Secrets; } });
+var configuration_js_1 = require("./configuration.js");
+Object.defineProperty(exports, "DesktopAuth", { enumerable: true, get: function () { return configuration_js_1.DesktopAuth; } });
 __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/secrets.d.ts

@@ -2,7 +2,7 @@ import { InnerClient } from "./core.js";
 import { GeneratePasswordResponse, PasswordRecipe, ResolveAllResponse } from "./types.js";
 /**
  * The Secrets API includes all operations the SDK client can perform on secrets.
- * Use secret reference URIs to securely load secrets from 1Password: op://<vault-name>/<item-name>[/<section-name>]/<field-name>
+ * Use secret reference URIs to securely load secrets from 1Password: `op://<vault-name>/<item-name>[/<section-name>]/<field-name>`
  */
 export interface SecretsApi {
     /**
@@ -29,5 +29,8 @@ export declare class Secrets implements SecretsApi {
      * Validate the secret reference to ensure there are no syntax errors.
      */
     static validateSecretReference(secretReference: string): void;
+    /**
+     * Generate a password using the provided recipe.
+     */
     static generatePassword(recipe: PasswordRecipe): GeneratePasswordResponse;
 }

package/dist/secrets.js

@@ -46,7 +46,7 @@ class Secrets {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Secrets_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Secrets_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -65,7 +65,7 @@ class Secrets {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Secrets_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Secrets_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
     /**
@@ -85,6 +85,9 @@ class Secrets {
         };
         sharedCore.invoke_sync(invocationConfig);
     }
+    /**
+     * Generate a password using the provided recipe.
+     */
     static generatePassword(recipe) {
         const sharedCore = new core_js_1.SharedCore();
         const invocationConfig = {

package/dist/shared_lib_core.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : 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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __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) {
@@ -36,6 +46,7 @@ exports.SharedLibCore = void 0;
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
+const errors_1 = require("./errors");
 /**
  * Find the 1Password shared lib path by asking an the wasm core synchronously.
  */
@@ -58,6 +69,14 @@ const find1PasswordLibPath = () => {
                 "/snap/bin/1password/libop_sdk_ipc_client.so",
             ];
             break;
+        case "win32": // Windows
+            searchPaths = [
+                path.join(os.homedir(), "/AppData/Local/1Password/op_sdk_ipc_client.dll"),
+                "C:/Program Files/1Password/app/8/op_sdk_ipc_client.dll",
+                "C:/Program Files (x86)/1Password/app/8/op_sdk_ipc_client.dll",
+                path.join(os.homedir(), "/AppData/Local/1Password/app/8/op_sdk_ipc_client.dll"),
+            ];
+            break;
         default:
             throw new Error(`Unsupported platform: ${platform}`);
     }
@@ -118,30 +137,23 @@ class SharedLibCore {
                 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}`);
-                }
+            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;
             }
-            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;
+            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);
+                (0, errors_1.throwError)(errorMessage);
             }
         });
     }

package/dist/types.d.ts

@@ -114,9 +114,28 @@ export interface Group {
     state: GroupState;
     vaultAccess?: VaultAccess[];
 }
+/**
+ * Represents a group's access to a 1Password vault.
+ * This is used for granting permissions
+ */
+export interface GroupAccess {
+    /** The group's ID */
+    groupId: string;
+    /** The group's set of permissions for the vault */
+    permissions: number;
+}
 export interface GroupGetParams {
     vaultPermissions?: boolean;
 }
+/** Represents a group's access to a 1Password vault. */
+export interface GroupVaultAccess {
+    /** The vault's ID */
+    vaultId: string;
+    /** The group's ID */
+    groupId: string;
+    /** The group's set of permissions for the vault */
+    permissions: number;
+}
 export declare enum ItemCategory {
     Login = "Login",
     SecureNote = "SecureNote",
@@ -203,7 +222,7 @@ export interface ItemSection {
  * Controls the auto-fill behavior of a website.
  *
  *
- * For more information, visit https://support.1password.com/autofill-behavior/
+ * For more information, visit <https://support.1password.com/autofill-behavior/>
  */
 export declare enum AutofillBehavior {
     /** Auto-fill any page that’s part of the website, including subdomains */
@@ -221,7 +240,7 @@ export interface Website {
     /**
      * The auto-fill behavior of the website
      *
-     * For more information, visit https://support.1password.com/autofill-behavior/
+     * For more information, visit <https://support.1password.com/autofill-behavior/>
      */
     autofillBehavior: AutofillBehavior;
 }
@@ -591,6 +610,11 @@ export interface Vault {
     /** The access information associated with the vault. */
     access?: VaultAccess[];
 }
+export interface VaultCreateParams {
+    title: string;
+    description?: string;
+    allowAdminsAccess?: boolean;
+}
 /** Represents the possible query parameters used for retrieving extra information about a vault. */
 export interface VaultGetParams {
     /** The vault's accessor params. */
@@ -620,6 +644,10 @@ export interface VaultOverview {
     /** The time the vault was updated at */
     updatedAt: Date;
 }
+export interface VaultUpdateParams {
+    title?: string;
+    description?: string;
+}
 export type ItemListFilter = {
     type: "ByState";
     content: {
@@ -703,6 +731,20 @@ export declare enum WordListType {
     /** Three (random) letter "words" */
     ThreeLetters = "threeLetters"
 }
+export declare const ARCHIVE_ITEMS: number;
+export declare const CREATE_ITEMS: number;
+export declare const DELETE_ITEMS: number;
+export declare const EXPORT_ITEMS: number;
+export declare const IMPORT_ITEMS: number;
+export declare const MANAGE_VAULT: number;
+export declare const NO_ACCESS: number;
+export declare const PRINT_ITEMS: number;
+export declare const READ_ITEMS: number;
+export declare const RECOVER_VAULT: number;
+export declare const REVEAL_ITEM_PASSWORD: number;
+export declare const SEND_ITEMS: number;
+export declare const UPDATE_ITEMS: number;
+export declare const UPDATE_ITEM_HISTORY: number;
 /**
  * Custom JSON reviver and replacer functions for dynamic data transformation
  * ReviverFunc is used during JSON parsing to detect and transform specific data structures

package/dist/types.js

@@ -3,7 +3,7 @@
  Generated by typeshare 1.13.2
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+exports.ReplacerFunc = exports.ReviverFunc = exports.UPDATE_ITEM_HISTORY = exports.UPDATE_ITEMS = exports.SEND_ITEMS = exports.REVEAL_ITEM_PASSWORD = exports.RECOVER_VAULT = exports.READ_ITEMS = exports.PRINT_ITEMS = exports.NO_ACCESS = exports.MANAGE_VAULT = exports.IMPORT_ITEMS = exports.EXPORT_ITEMS = exports.DELETE_ITEMS = exports.CREATE_ITEMS = exports.ARCHIVE_ITEMS = 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) {
     /**
@@ -107,7 +107,7 @@ var ItemFieldType;
  * Controls the auto-fill behavior of a website.
  *
  *
- * For more information, visit https://support.1password.com/autofill-behavior/
+ * For more information, visit <https://support.1password.com/autofill-behavior/>
  */
 var AutofillBehavior;
 (function (AutofillBehavior) {
@@ -214,6 +214,20 @@ var WordListType;
     /** Three (random) letter "words" */
     WordListType["ThreeLetters"] = "threeLetters";
 })(WordListType || (exports.WordListType = WordListType = {}));
+exports.ARCHIVE_ITEMS = 256;
+exports.CREATE_ITEMS = 128;
+exports.DELETE_ITEMS = 512;
+exports.EXPORT_ITEMS = 4194304;
+exports.IMPORT_ITEMS = 2097152;
+exports.MANAGE_VAULT = 2;
+exports.NO_ACCESS = 0;
+exports.PRINT_ITEMS = 8388608;
+exports.READ_ITEMS = 32;
+exports.RECOVER_VAULT = 1;
+exports.REVEAL_ITEM_PASSWORD = 16;
+exports.SEND_ITEMS = 1048576;
+exports.UPDATE_ITEMS = 64;
+exports.UPDATE_ITEM_HISTORY = 1024;
 /**
  * Custom JSON reviver and replacer functions for dynamic data transformation
  * ReviverFunc is used during JSON parsing to detect and transform specific data structures

package/dist/vaults.d.ts

@@ -1,23 +1,83 @@
 import { InnerClient } from "./core.js";
-import { Vault, VaultGetParams, VaultListParams, VaultOverview } from "./types.js";
+import { GroupAccess, GroupVaultAccess, Vault, VaultCreateParams, VaultGetParams, VaultListParams, VaultOverview, VaultUpdateParams } from "./types.js";
 /**
  * The Vaults API holds all the operations the SDK client can perform on 1Password vaults.
  */
 export interface VaultsApi {
+    /**
+     * Create a new user vault.
+     */
+    create(params: VaultCreateParams): Promise<Vault>;
     /**
      * List information about vaults that's configurable based on some input parameters.
      */
     list(params?: VaultListParams): Promise<VaultOverview[]>;
-    getOverview(vaultUuid: string): Promise<VaultOverview>;
-    get(vaultUuid: string, vaultParams: VaultGetParams): Promise<Vault>;
+    /**
+     * Get an overview of a vault by its ID.
+     */
+    getOverview(vaultId: string): Promise<VaultOverview>;
+    /**
+     * Get detailed vault information by vault ID and parameters.
+     */
+    get(vaultId: string, vaultParams: VaultGetParams): Promise<Vault>;
+    /**
+     * Update a vault
+     */
+    update(vaultId: string, params: VaultUpdateParams): Promise<Vault>;
+    /**
+     * Delete a vault by its ID.
+     */
+    delete(vaultId: string): Promise<void>;
+    /**
+     * Grant group permissions to a vault.
+     */
+    grantGroupPermissions(vaultId: string, groupPermissionsList: GroupAccess[]): Promise<void>;
+    /**
+     * Update group permissions for vaults.
+     */
+    updateGroupPermissions(groupPermissionsList: GroupVaultAccess[]): Promise<void>;
+    /**
+     * Revoke group permissions from a vault.
+     */
+    revokeGroupPermissions(vaultId: string, groupId: string): Promise<void>;
 }
 export declare class Vaults implements VaultsApi {
     #private;
     constructor(inner: InnerClient);
+    /**
+     * Create a new user vault.
+     */
+    create(params: VaultCreateParams): Promise<Vault>;
     /**
      * List information about vaults that's configurable based on some input parameters.
      */
-    list(params: VaultListParams): Promise<VaultOverview[]>;
-    getOverview(vaultUuid: string): Promise<VaultOverview>;
-    get(vaultUuid: string, vaultParams: VaultGetParams): Promise<Vault>;
+    list(params?: VaultListParams): Promise<VaultOverview[]>;
+    /**
+     * Get an overview of a vault by its ID.
+     */
+    getOverview(vaultId: string): Promise<VaultOverview>;
+    /**
+     * Get detailed vault information by vault ID and parameters.
+     */
+    get(vaultId: string, vaultParams: VaultGetParams): Promise<Vault>;
+    /**
+     * Update a vault
+     */
+    update(vaultId: string, params: VaultUpdateParams): Promise<Vault>;
+    /**
+     * Delete a vault by its ID.
+     */
+    delete(vaultId: string): Promise<void>;
+    /**
+     * Grant group permissions to a vault.
+     */
+    grantGroupPermissions(vaultId: string, groupPermissionsList: GroupAccess[]): Promise<void>;
+    /**
+     * Update group permissions for vaults.
+     */
+    updateGroupPermissions(groupPermissionsList: GroupVaultAccess[]): Promise<void>;
+    /**
+     * Revoke group permissions from a vault.
+     */
+    revokeGroupPermissions(vaultId: string, groupId: string): Promise<void>;
 }

package/dist/vaults.js

@@ -29,6 +29,25 @@ class Vaults {
         _Vaults_inner.set(this, void 0);
         __classPrivateFieldSet(this, _Vaults_inner, inner, "f");
     }
+    /**
+     * Create a new user vault.
+     */
+    create(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
+                    parameters: {
+                        name: "VaultsCreate",
+                        parameters: {
+                            params,
+                        },
+                    },
+                },
+            };
+            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
     /**
      * List information about vaults that's configurable based on some input parameters.
      */
@@ -45,10 +64,13 @@ class Vaults {
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
-    getOverview(vaultUuid) {
+    /**
+     * Get an overview of a vault by its ID.
+     */
+    getOverview(vaultId) {
         return __awaiter(this, void 0, void 0, function* () {
             const invocationConfig = {
                 invocation: {
@@ -56,15 +78,18 @@ class Vaults {
                     parameters: {
                         name: "VaultsGetOverview",
                         parameters: {
-                            vault_uuid: vaultUuid,
+                            vault_id: vaultId,
                         },
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
         });
     }
-    get(vaultUuid, vaultParams) {
+    /**
+     * Get detailed vault information by vault ID and parameters.
+     */
+    get(vaultId, vaultParams) {
         return __awaiter(this, void 0, void 0, function* () {
             const invocationConfig = {
                 invocation: {
@@ -72,13 +97,111 @@ class Vaults {
                     parameters: {
                         name: "VaultsGet",
                         parameters: {
-                            vault_uuid: vaultUuid,
+                            vault_id: vaultId,
                             vault_params: vaultParams,
                         },
                     },
                 },
             };
-            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").core.invoke(invocationConfig), types_js_1.ReviverFunc);
+            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
+    /**
+     * Update a vault
+     */
+    update(vaultId, params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
+                    parameters: {
+                        name: "VaultsUpdate",
+                        parameters: {
+                            vault_id: vaultId,
+                            params,
+                        },
+                    },
+                },
+            };
+            return JSON.parse(yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig), types_js_1.ReviverFunc);
+        });
+    }
+    /**
+     * Delete a vault by its ID.
+     */
+    delete(vaultId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
+                    parameters: {
+                        name: "VaultsDelete",
+                        parameters: {
+                            vault_id: vaultId,
+                        },
+                    },
+                },
+            };
+            yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig);
+        });
+    }
+    /**
+     * Grant group permissions to a vault.
+     */
+    grantGroupPermissions(vaultId, groupPermissionsList) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
+                    parameters: {
+                        name: "VaultsGrantGroupPermissions",
+                        parameters: {
+                            vault_id: vaultId,
+                            group_permissions_list: groupPermissionsList,
+                        },
+                    },
+                },
+            };
+            yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig);
+        });
+    }
+    /**
+     * Update group permissions for vaults.
+     */
+    updateGroupPermissions(groupPermissionsList) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
+                    parameters: {
+                        name: "VaultsUpdateGroupPermissions",
+                        parameters: {
+                            group_permissions_list: groupPermissionsList,
+                        },
+                    },
+                },
+            };
+            yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig);
+        });
+    }
+    /**
+     * Revoke group permissions from a vault.
+     */
+    revokeGroupPermissions(vaultId, groupId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const invocationConfig = {
+                invocation: {
+                    clientId: __classPrivateFieldGet(this, _Vaults_inner, "f").id,
+                    parameters: {
+                        name: "VaultsRevokeGroupPermissions",
+                        parameters: {
+                            vault_id: vaultId,
+                            group_id: groupId,
+                        },
+                    },
+                },
+            };
+            yield __classPrivateFieldGet(this, _Vaults_inner, "f").invoke(invocationConfig);
         });
     }
 }

package/dist/version.d.ts

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

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.4.0-beta.1";
-exports.SDK_BUILD_NUMBER = "0040001";
-const SDK_CORE_VERSION = "0.4.0-beta.1";
+exports.SDK_VERSION = "0.4.0";
+exports.SDK_BUILD_NUMBER = "0040003";
+const SDK_CORE_VERSION = "0.4.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1password/sdk",
-  "version": "0.4.0-beta.1",
+  "version": "0.4.0",
   "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.4.0-beta.1"
+    "@1password/sdk-core": "0.4.0"
   },
   "devDependencies": {
     "@1password/eslint-config": "^4.0.0",