cloudcruise 0.0.6 → 1.0.1

package/dist/vault/VaultClient.d.ts

@@ -1,4 +1,4 @@
-import type { GetVaultEntriesFilters, VaultEntry } from './types.js';
+import type { GetVaultEntriesFilters, VaultEntry, VaultTfaCode } from './types.js';
 export declare class VaultClient {
     private readonly makeRequest;
     private readonly encryptionKey;
@@ -15,6 +15,19 @@ export declare class VaultClient {
      * @param filters.decryptCredentials - Whether to decrypt sensitive fields (default: true)
      */
     get(filters?: GetVaultEntriesFilters): Promise<VaultEntry[]>;
+    /**
+     * Gets the current 2FA code for a single vault entry.
+     *
+     * The code returned depends on the credential's 2FA method:
+     * - Authenticator (TOTP): a freshly generated code, with `expires_in_seconds`.
+     * - Email: the most recently received code (within the freshness window), with `received_at`.
+     *
+     * SMS and magic-link credentials are not supported (the endpoint returns 409).
+     *
+     * @param permissioned_user_id - User identifier for the vault entry
+     * @param domain - Target domain of the vault entry
+     */
+    getTfaCode(permissioned_user_id: string, domain: string): Promise<VaultTfaCode>;
     /**
      * Updates an existing vault entry
      * @param updates - Vault entry updates including required fields

package/dist/vault/VaultClient.js

@@ -50,6 +50,30 @@ export class VaultClient {
         }
         return entries;
     }
+    /**
+     * Gets the current 2FA code for a single vault entry.
+     *
+     * The code returned depends on the credential's 2FA method:
+     * - Authenticator (TOTP): a freshly generated code, with `expires_in_seconds`.
+     * - Email: the most recently received code (within the freshness window), with `received_at`.
+     *
+     * SMS and magic-link credentials are not supported (the endpoint returns 409).
+     *
+     * @param permissioned_user_id - User identifier for the vault entry
+     * @param domain - Target domain of the vault entry
+     */
+    async getTfaCode(permissioned_user_id, domain) {
+        if (!permissioned_user_id) {
+            throw new Error('permissioned_user_id is required to get a TFA code');
+        }
+        if (!domain) {
+            throw new Error('domain is required to get a TFA code');
+        }
+        const params = new URLSearchParams();
+        params.append('permissioned_user_id', permissioned_user_id);
+        params.append('domain', domain);
+        return await this.makeRequest('GET', `/vault/tfa-code?${params.toString()}`);
+    }
     /**
      * Updates an existing vault entry
      * @param updates - Vault entry updates including required fields

package/dist/vault/types.d.ts

@@ -48,3 +48,13 @@ export interface GetVaultEntriesFilters {
     domain?: string;
     decryptCredentials?: boolean;
 }
+/**
+ * The current 2FA code for a vault entry. `expires_in_seconds` is present for
+ * authenticator (TOTP) codes; `received_at` is present for email codes.
+ */
+export interface VaultTfaCode {
+    type: 'authenticator' | 'email';
+    code: string;
+    expires_in_seconds?: number;
+    received_at?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcruise",
-  "version": "0.0.6",
+  "version": "1.0.1",
   "description": "The official CloudCruise JS/TS client.",
   "homepage": "https://github.com/CloudCruise/cloudcruise-js#readme",
   "bugs": {
@@ -18,16 +18,17 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "pnpm build && node --test test/*.test.js"
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0"
   },
   "engines": {
     "node": ">=18.0.0"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "pnpm build && node --test test/*.test.js"
   }
-}
+}