@lifestreamdynamics/vault-sdk 1.0.0

package/dist/resources/ai.d.ts

@@ -0,0 +1,184 @@
+import type { KyInstance } from 'ky';
+/** An AI chat session with optional vault context. */
+export interface AiChatSession {
+    /** Unique session identifier. */
+    id: string;
+    /** Auto-generated or user-provided session title. */
+    title: string;
+    /** ID of the vault scoped to this session, or `null` for cross-vault sessions. */
+    vaultId: string | null;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 last-updated timestamp. */
+    updatedAt: string;
+}
+/** A single message in an AI chat session. */
+export interface AiChatMessage {
+    /** Unique message identifier. */
+    id: string;
+    /** The role of the message sender. */
+    role: 'user' | 'assistant' | 'system';
+    /** Message text content. */
+    content: string;
+    /** Number of tokens consumed by this message. */
+    tokensUsed: number;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+}
+/**
+ * Resource for AI-powered chat and document analysis.
+ *
+ * Provides conversational AI with optional vault context for document-aware
+ * responses, as well as standalone document summarization. Requires a
+ * subscription tier that includes AI features.
+ *
+ * @example
+ * ```typescript
+ * const response = await client.ai.chat({
+ *   message: 'Summarize my recent meeting notes',
+ *   vaultId: 'vault-uuid',
+ * });
+ * console.log(response.message.content);
+ * ```
+ */
+export declare class AiResource {
+    private http;
+    constructor(http: KyInstance);
+    /**
+     * Sends a message to the AI chat and receives a response.
+     *
+     * If `sessionId` is provided, the message is appended to an existing
+     * conversation. Otherwise, a new session is created automatically.
+     * When `vaultId` is provided, the AI has access to documents in that
+     * vault for context-aware responses.
+     *
+     * @param params - Chat parameters
+     * @param params.message - The user's message text (required)
+     * @param params.sessionId - Optional existing session ID to continue a conversation
+     * @param params.vaultId - Optional vault ID to scope the AI's document context
+     * @returns The AI response with session ID, message content, document sources, and token usage
+     * @throws {NotFoundError} If the specified session or vault does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * // Start a new conversation
+     * const response = await client.ai.chat({
+     *   message: 'What are my open action items?',
+     *   vaultId: 'vault-uuid',
+     * });
+     * console.log(response.message.content);
+     * console.log('Sources:', response.message.sources);
+     *
+     * // Continue the conversation
+     * const followUp = await client.ai.chat({
+     *   message: 'Which ones are due this week?',
+     *   sessionId: response.sessionId,
+     * });
+     * ```
+     *
+     * @see {@link AiResource.listSessions} to list past conversations
+     */
+    chat(params: {
+        message: string;
+        sessionId?: string;
+        vaultId?: string;
+    }): Promise<{
+        sessionId: string;
+        message: {
+            role: string;
+            content: string;
+            sources: string[];
+        };
+        tokensUsed: number;
+    }>;
+    /**
+     * Lists all AI chat sessions for the authenticated user.
+     *
+     * @returns Array of chat session objects, ordered by most recent first
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const sessions = await client.ai.listSessions();
+     * for (const session of sessions) {
+     *   console.log(session.title, session.createdAt);
+     * }
+     * ```
+     */
+    listSessions(): Promise<AiChatSession[]>;
+    /**
+     * Retrieves a chat session with its full message history.
+     *
+     * @param sessionId - The unique identifier of the session
+     * @returns The session metadata and array of all messages in chronological order
+     * @throws {NotFoundError} If no session exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const { session, messages } = await client.ai.getSession('session-uuid');
+     * console.log(`Session: ${session.title}`);
+     * for (const msg of messages) {
+     *   console.log(`[${msg.role}] ${msg.content}`);
+     * }
+     * ```
+     */
+    getSession(sessionId: string): Promise<{
+        session: AiChatSession;
+        messages: AiChatMessage[];
+    }>;
+    /**
+     * Permanently deletes a chat session and all its messages.
+     *
+     * This action is irreversible.
+     *
+     * @param sessionId - The unique identifier of the session to delete
+     * @throws {NotFoundError} If no session exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.ai.deleteSession('session-uuid');
+     * ```
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * Generates an AI summary of a specific document.
+     *
+     * Analyzes the document content and produces a concise summary along
+     * with a list of key topics identified in the text.
+     *
+     * @param vaultId - The vault ID containing the document
+     * @param documentPath - File path of the document to summarize
+     * @returns Object containing the summary text, extracted key topics, and token usage
+     * @throws {NotFoundError} If the vault or document does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const result = await client.ai.summarize('vault-uuid', 'notes/long-article.md');
+     * console.log(result.summary);
+     * console.log('Key topics:', result.keyTopics.join(', '));
+     * console.log(`Tokens used: ${result.tokensUsed}`);
+     * ```
+     *
+     * @see {@link AiResource.chat} for interactive document Q&A
+     */
+    summarize(vaultId: string, documentPath: string): Promise<{
+        summary: string;
+        keyTopics: string[];
+        tokensUsed: number;
+    }>;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/resources/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/resources/ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAGrC,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,IAAI,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAQrH;;;;;;;;;;;;;;;OAeG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAS9C;;;;;;;;;;;;;;;;;;OAkBG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IAQnG;;;;;;;;;;;;;;;OAeG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAS9H"}

package/dist/resources/ai.js

@@ -0,0 +1,179 @@
+import { handleError } from '../handle-error.js';
+/**
+ * Resource for AI-powered chat and document analysis.
+ *
+ * Provides conversational AI with optional vault context for document-aware
+ * responses, as well as standalone document summarization. Requires a
+ * subscription tier that includes AI features.
+ *
+ * @example
+ * ```typescript
+ * const response = await client.ai.chat({
+ *   message: 'Summarize my recent meeting notes',
+ *   vaultId: 'vault-uuid',
+ * });
+ * console.log(response.message.content);
+ * ```
+ */
+export class AiResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Sends a message to the AI chat and receives a response.
+     *
+     * If `sessionId` is provided, the message is appended to an existing
+     * conversation. Otherwise, a new session is created automatically.
+     * When `vaultId` is provided, the AI has access to documents in that
+     * vault for context-aware responses.
+     *
+     * @param params - Chat parameters
+     * @param params.message - The user's message text (required)
+     * @param params.sessionId - Optional existing session ID to continue a conversation
+     * @param params.vaultId - Optional vault ID to scope the AI's document context
+     * @returns The AI response with session ID, message content, document sources, and token usage
+     * @throws {NotFoundError} If the specified session or vault does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * // Start a new conversation
+     * const response = await client.ai.chat({
+     *   message: 'What are my open action items?',
+     *   vaultId: 'vault-uuid',
+     * });
+     * console.log(response.message.content);
+     * console.log('Sources:', response.message.sources);
+     *
+     * // Continue the conversation
+     * const followUp = await client.ai.chat({
+     *   message: 'Which ones are due this week?',
+     *   sessionId: response.sessionId,
+     * });
+     * ```
+     *
+     * @see {@link AiResource.listSessions} to list past conversations
+     */
+    async chat(params) {
+        try {
+            return await this.http.post('ai/chat', { json: params }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'AI Chat', params.sessionId ?? '');
+        }
+    }
+    /**
+     * Lists all AI chat sessions for the authenticated user.
+     *
+     * @returns Array of chat session objects, ordered by most recent first
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const sessions = await client.ai.listSessions();
+     * for (const session of sessions) {
+     *   console.log(session.title, session.createdAt);
+     * }
+     * ```
+     */
+    async listSessions() {
+        try {
+            const data = await this.http.get('ai/sessions').json();
+            return data.sessions;
+        }
+        catch (error) {
+            throw await handleError(error, 'AI Sessions', '');
+        }
+    }
+    /**
+     * Retrieves a chat session with its full message history.
+     *
+     * @param sessionId - The unique identifier of the session
+     * @returns The session metadata and array of all messages in chronological order
+     * @throws {NotFoundError} If no session exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const { session, messages } = await client.ai.getSession('session-uuid');
+     * console.log(`Session: ${session.title}`);
+     * for (const msg of messages) {
+     *   console.log(`[${msg.role}] ${msg.content}`);
+     * }
+     * ```
+     */
+    async getSession(sessionId) {
+        try {
+            return await this.http.get(`ai/sessions/${sessionId}`).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'AI Session', sessionId);
+        }
+    }
+    /**
+     * Permanently deletes a chat session and all its messages.
+     *
+     * This action is irreversible.
+     *
+     * @param sessionId - The unique identifier of the session to delete
+     * @throws {NotFoundError} If no session exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.ai.deleteSession('session-uuid');
+     * ```
+     */
+    async deleteSession(sessionId) {
+        try {
+            await this.http.delete(`ai/sessions/${sessionId}`);
+        }
+        catch (error) {
+            throw await handleError(error, 'AI Session', sessionId);
+        }
+    }
+    /**
+     * Generates an AI summary of a specific document.
+     *
+     * Analyzes the document content and produces a concise summary along
+     * with a list of key topics identified in the text.
+     *
+     * @param vaultId - The vault ID containing the document
+     * @param documentPath - File path of the document to summarize
+     * @returns Object containing the summary text, extracted key topics, and token usage
+     * @throws {NotFoundError} If the vault or document does not exist
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's subscription does not include AI features
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const result = await client.ai.summarize('vault-uuid', 'notes/long-article.md');
+     * console.log(result.summary);
+     * console.log('Key topics:', result.keyTopics.join(', '));
+     * console.log(`Tokens used: ${result.tokensUsed}`);
+     * ```
+     *
+     * @see {@link AiResource.chat} for interactive document Q&A
+     */
+    async summarize(vaultId, documentPath) {
+        try {
+            return await this.http.post('ai/summarize', {
+                json: { vaultId, documentPath },
+            }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'AI Summarize', documentPath);
+        }
+    }
+}
+//# sourceMappingURL=ai.js.map

package/dist/resources/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/resources/ai.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA8BjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,KAAK,CAAC,IAAI,CAAC,MAIV;QACC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,EAAiC,CAAC;YACtF,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,YAAoB;QACnD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;gBAC1C,IAAI,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE;aAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;CACF"}

package/dist/resources/api-keys.d.ts

@@ -0,0 +1,172 @@
+import type { KyInstance } from 'ky';
+/** An API key object returned by the API (secret not included). */
+export interface ApiKey {
+    /** Unique API key identifier. */
+    id: string;
+    /** Human-readable name for the key. */
+    name: string;
+    /** Short prefix for identifying the key (e.g., `lsv_k_ab12cd34`). */
+    prefix: string;
+    /** Permission scopes granted to this key (e.g., `['read', 'write']`). */
+    scopes: string[];
+    /** Vault ID this key is restricted to, or `null` for unrestricted access. */
+    vaultId: string | null;
+    /** ISO 8601 expiration timestamp, or `null` if the key does not expire. */
+    expiresAt: string | null;
+    /** Whether the key is currently active. */
+    isActive: boolean;
+    /** ISO 8601 timestamp of last usage, or `null` if never used. */
+    lastUsedAt: string | null;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 last-updated timestamp. */
+    updatedAt: string;
+}
+/** An API key object that includes the full secret. Only returned on creation. */
+export interface ApiKeyWithSecret extends ApiKey {
+    /** The full API key string including secret. Only available at creation time. */
+    key: string;
+}
+/** Parameters for creating a new API key. */
+export interface CreateApiKeyParams {
+    /** Human-readable name for the key. */
+    name: string;
+    /** Permission scopes to grant (e.g., `['read', 'write']`). */
+    scopes: string[];
+    /** Optional vault ID to restrict the key to a single vault. */
+    vaultId?: string | null;
+    /** Optional ISO 8601 expiration date. */
+    expiresAt?: string | null;
+}
+/** Parameters for updating an existing API key. */
+export interface UpdateApiKeyParams {
+    /** New name for the key. */
+    name?: string;
+    /** Whether the key should be active. */
+    isActive?: boolean;
+}
+/**
+ * Resource for managing API keys.
+ *
+ * API keys provide programmatic access to the Lifestream Vault API.
+ * Keys can be scoped to specific permissions and optionally restricted
+ * to a single vault.
+ *
+ * @example
+ * ```typescript
+ * const keys = await client.apiKeys.list();
+ * const newKey = await client.apiKeys.create({
+ *   name: 'CI/CD Key',
+ *   scopes: ['read', 'write'],
+ * });
+ * ```
+ */
+export declare class ApiKeysResource {
+    private http;
+    constructor(http: KyInstance);
+    /**
+     * Lists all API keys for the authenticated user.
+     *
+     * Returns key metadata without secrets. Use this to audit existing keys
+     * or find keys to update/revoke.
+     *
+     * @returns Array of API key objects (without secrets)
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const keys = await client.apiKeys.list();
+     * for (const key of keys) {
+     *   console.log(key.name, key.prefix, key.isActive);
+     * }
+     * ```
+     */
+    list(): Promise<ApiKey[]>;
+    /**
+     * Retrieves a specific API key by ID.
+     *
+     * @param keyId - The unique identifier of the API key
+     * @returns The API key object (without secret)
+     * @throws {NotFoundError} If no API key exists with the given ID
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const key = await client.apiKeys.get('key-uuid');
+     * console.log(key.name, key.scopes);
+     * ```
+     */
+    get(keyId: string): Promise<ApiKey>;
+    /**
+     * Creates a new API key.
+     *
+     * The full key string (including secret) is only returned on creation.
+     * Store it securely — it cannot be retrieved later.
+     *
+     * @param params - API key creation parameters
+     * @param params.name - Human-readable name for the key
+     * @param params.scopes - Permission scopes to grant
+     * @param params.vaultId - Optional vault ID to restrict the key to
+     * @param params.expiresAt - Optional ISO 8601 expiration date
+     * @returns API key object including the full key string
+     * @throws {ValidationError} If parameters are invalid
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const apiKey = await client.apiKeys.create({
+     *   name: 'Production Key',
+     *   scopes: ['read', 'write'],
+     *   vaultId: 'vault-123',
+     *   expiresAt: '2027-01-01T00:00:00Z',
+     * });
+     * console.log('Save this key:', apiKey.key);
+     * ```
+     */
+    create(params: CreateApiKeyParams): Promise<ApiKeyWithSecret>;
+    /**
+     * Updates an existing API key.
+     *
+     * Only the provided fields are modified; omitted fields remain unchanged.
+     *
+     * @param keyId - The unique identifier of the API key to update
+     * @param params - Fields to update
+     * @param params.name - New name for the key
+     * @param params.isActive - Whether the key should be active
+     * @returns The updated API key object
+     * @throws {ValidationError} If parameters are invalid
+     * @throws {NotFoundError} If no API key exists with the given ID
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.apiKeys.update('key-uuid', {
+     *   name: 'Renamed Key',
+     *   isActive: false,
+     * });
+     * ```
+     */
+    update(keyId: string, params: UpdateApiKeyParams): Promise<ApiKey>;
+    /**
+     * Deletes an API key permanently.
+     *
+     * Once deleted, the key can no longer be used for authentication.
+     * This action is irreversible.
+     *
+     * @param keyId - The unique identifier of the API key to delete
+     * @throws {NotFoundError} If no API key exists with the given ID
+     * @throws {AuthenticationError} If not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.apiKeys.delete('key-uuid');
+     * ```
+     */
+    delete(keyId: string): Promise<void>;
+}
+//# sourceMappingURL=api-keys.d.ts.map

package/dist/resources/api-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.d.ts","sourceRoot":"","sources":["../../src/resources/api-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAGrC,mEAAmE;AACnE,MAAM,WAAW,MAAM;IACrB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAiB,SAAQ,MAAM;IAC9C,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;CACb;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;;;;;OAiBG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAS/B;;;;;;;;;;;;;;OAcG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASzC;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQnE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IASxE;;;;;;;;;;;;;;;OAeG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO3C"}