@lifestreamdynamics/vault-sdk 1.0.0

package/dist/resources/api-keys.js

@@ -0,0 +1,166 @@
+import { handleError } from '../handle-error.js';
+/**
+ * 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 class ApiKeysResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    async list() {
+        try {
+            const data = await this.http.get('api-keys').json();
+            return data.apiKeys;
+        }
+        catch (error) {
+            throw await handleError(error, 'API keys', '');
+        }
+    }
+    /**
+     * 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);
+     * ```
+     */
+    async get(keyId) {
+        try {
+            const data = await this.http.get(`api-keys/${keyId}`).json();
+            return data.apiKey;
+        }
+        catch (error) {
+            throw await handleError(error, 'API key', keyId);
+        }
+    }
+    /**
+     * 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);
+     * ```
+     */
+    async create(params) {
+        try {
+            return await this.http.post('api-keys', { json: params }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'API key', params.name);
+        }
+    }
+    /**
+     * 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,
+     * });
+     * ```
+     */
+    async update(keyId, params) {
+        try {
+            const data = await this.http.patch(`api-keys/${keyId}`, { json: params }).json();
+            return data.apiKey;
+        }
+        catch (error) {
+            throw await handleError(error, 'API key', keyId);
+        }
+    }
+    /**
+     * 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');
+     * ```
+     */
+    async delete(keyId) {
+        try {
+            await this.http.delete(`api-keys/${keyId}`);
+        }
+        catch (error) {
+            throw await handleError(error, 'API key', keyId);
+        }
+    }
+}
+//# sourceMappingURL=api-keys.js.map

package/dist/resources/api-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.js","sourceRoot":"","sources":["../../src/resources/api-keys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAoDjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAExC;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,EAAyB,CAAC;YAC3E,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,GAAG,CAAC,KAAa;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,IAAI,EAAsB,CAAC;YACjF,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,KAAK,CAAC,MAAM,CAAC,MAA0B;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAoB,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAA0B;QACpD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAsB,CAAC;YACrG,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF"}

package/dist/resources/connectors.d.ts

@@ -0,0 +1,263 @@
+import type { KyInstance } from 'ky';
+/** Supported connector providers. */
+export type ConnectorProvider = 'google_drive';
+/** Sync direction for a connector. */
+export type SyncDirection = 'pull' | 'push' | 'bidirectional';
+/** Current status of a connector. */
+export type ConnectorStatus = 'inactive' | 'active' | 'syncing' | 'error';
+/** A connector object returned by the API. */
+export interface Connector {
+    /** Unique connector identifier. */
+    id: string;
+    /** User ID of the connector owner. */
+    userId: string;
+    /** Vault ID the connector is associated with. */
+    vaultId: string;
+    /** Connector provider type. */
+    provider: ConnectorProvider;
+    /** Display name for the connector. */
+    name: string;
+    /** Provider-specific configuration (sensitive fields stripped). */
+    config: Record<string, unknown>;
+    /** Direction of synchronization. */
+    syncDirection: SyncDirection;
+    /** Optional path prefix for syncing. */
+    syncPath: string | null;
+    /** ISO 8601 timestamp of the last successful sync, or null if never synced. */
+    lastSyncAt: string | null;
+    /** Current connector status. */
+    status: ConnectorStatus;
+    /** Whether the connector is active. */
+    isActive: boolean;
+    /** ISO 8601 creation timestamp. */
+    createdAt: string;
+    /** ISO 8601 last-updated timestamp. */
+    updatedAt: string;
+}
+/** A sync log entry for a connector. */
+export interface ConnectorSyncLog {
+    /** Unique log entry identifier. */
+    id: string;
+    /** ID of the connector this log belongs to. */
+    connectorId: string;
+    /** Sync status (e.g., 'success', 'error'). */
+    status: string;
+    /** Number of files added during sync. */
+    filesAdded: number;
+    /** Number of files updated during sync. */
+    filesUpdated: number;
+    /** Number of files deleted during sync. */
+    filesDeleted: number;
+    /** Array of error details, or null if no errors. */
+    errors: Record<string, unknown>[] | null;
+    /** Duration of the sync in milliseconds, or null. */
+    durationMs: number | null;
+    /** ISO 8601 timestamp when the sync occurred. */
+    createdAt: string;
+}
+/** Parameters for creating a new connector. */
+export interface CreateConnectorParams {
+    /** Connector provider type. */
+    provider: ConnectorProvider;
+    /** Display name for the connector. */
+    name: string;
+    /** Vault ID to associate the connector with. */
+    vaultId: string;
+    /** Direction of synchronization. */
+    syncDirection: SyncDirection;
+    /** Optional path prefix for syncing. */
+    syncPath?: string;
+    /** Provider-specific configuration. */
+    config?: Record<string, unknown>;
+}
+/** Parameters for updating an existing connector. */
+export interface UpdateConnectorParams {
+    /** New display name. */
+    name?: string;
+    /** New sync direction. */
+    syncDirection?: SyncDirection;
+    /** New sync path, or `null` to clear. */
+    syncPath?: string | null;
+    /** Updated provider configuration. */
+    config?: Record<string, unknown>;
+    /** Whether the connector is active. */
+    isActive?: boolean;
+}
+/** Result of testing a connector's connection. */
+export interface TestConnectionResult {
+    /** Whether the connection test succeeded. */
+    success: boolean;
+    /** Error message if the test failed. */
+    error?: string;
+}
+/** Result of triggering a connector sync. */
+export interface TriggerSyncResult {
+    /** Confirmation message. */
+    message: string;
+}
+/**
+ * Resource for managing external connectors (e.g., Google Drive).
+ *
+ * Connectors allow bidirectional synchronization between vaults and
+ * external storage providers. Requires the `connectors` plan feature.
+ *
+ * @example
+ * ```typescript
+ * const connectors = await client.connectors.list();
+ * const connector = await client.connectors.create({
+ *   provider: 'google_drive',
+ *   name: 'My Drive',
+ *   vaultId: 'vault-uuid',
+ *   syncDirection: 'bidirectional',
+ * });
+ * ```
+ */
+export declare class ConnectorsResource {
+    private http;
+    constructor(http: KyInstance);
+    /**
+     * Lists all connectors for the authenticated user.
+     *
+     * @param vaultId - Optional vault ID to filter connectors by
+     * @returns Array of connector objects
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's plan does not include connectors
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const connectors = await client.connectors.list();
+     * const vaultConnectors = await client.connectors.list('vault-uuid');
+     * ```
+     */
+    list(vaultId?: string): Promise<Connector[]>;
+    /**
+     * Retrieves a single connector by ID.
+     *
+     * @param connectorId - The unique identifier of the connector
+     * @returns The connector object
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const connector = await client.connectors.get('connector-uuid');
+     * console.log(connector.name, connector.status);
+     * ```
+     */
+    get(connectorId: string): Promise<Connector>;
+    /**
+     * Creates a new connector.
+     *
+     * @param params - Connector creation parameters
+     * @returns The newly created connector object
+     * @throws {ValidationError} If the request body is invalid
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's plan does not include connectors
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const connector = await client.connectors.create({
+     *   provider: 'google_drive',
+     *   name: 'Work Drive',
+     *   vaultId: 'vault-uuid',
+     *   syncDirection: 'bidirectional',
+     * });
+     * ```
+     */
+    create(params: CreateConnectorParams): Promise<Connector>;
+    /**
+     * Updates an existing connector.
+     *
+     * Only the provided fields are modified; omitted fields remain unchanged.
+     *
+     * @param connectorId - The unique identifier of the connector to update
+     * @param params - Fields to update
+     * @returns The updated connector object
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {ValidationError} If the update parameters are invalid
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.connectors.update('connector-uuid', {
+     *   name: 'Renamed Drive',
+     *   syncDirection: 'pull',
+     * });
+     * ```
+     */
+    update(connectorId: string, params: UpdateConnectorParams): Promise<Connector>;
+    /**
+     * Permanently deletes a connector.
+     *
+     * @param connectorId - The unique identifier of the connector to delete
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.connectors.delete('connector-uuid');
+     * ```
+     */
+    delete(connectorId: string): Promise<void>;
+    /**
+     * Tests a connector's connection to the external provider.
+     *
+     * @param connectorId - The unique identifier of the connector to test
+     * @returns Object indicating success or failure with optional error message
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const result = await client.connectors.test('connector-uuid');
+     * if (result.success) {
+     *   console.log('Connection works!');
+     * } else {
+     *   console.error('Connection failed:', result.error);
+     * }
+     * ```
+     */
+    test(connectorId: string): Promise<TestConnectionResult>;
+    /**
+     * Triggers a sync for a connector. The sync runs asynchronously via a background worker.
+     *
+     * @param connectorId - The unique identifier of the connector to sync
+     * @returns Object with a confirmation message
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {ValidationError} If the connector is inactive
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const result = await client.connectors.sync('connector-uuid');
+     * console.log(result.message); // 'Sync triggered successfully'
+     * ```
+     */
+    sync(connectorId: string): Promise<TriggerSyncResult>;
+    /**
+     * Retrieves recent sync logs for a connector.
+     *
+     * @param connectorId - The unique identifier of the connector
+     * @returns Array of sync log entries, ordered by most recent first
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const logs = await client.connectors.logs('connector-uuid');
+     * for (const log of logs) {
+     *   console.log(`${log.status}: +${log.filesAdded} ~${log.filesUpdated} -${log.filesDeleted}`);
+     * }
+     * ```
+     */
+    logs(connectorId: string): Promise<ConnectorSyncLog[]>;
+}
+//# sourceMappingURL=connectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../../src/resources/connectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAGrC,qCAAqC;AACrC,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAE/C,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;AAE9D,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1E,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oCAAoC;IACpC,aAAa,EAAE,aAAa,CAAC;IAC7B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gCAAgC;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;IACzC,qDAAqD;IACrD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,aAAa,EAAE,aAAa,CAAC;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qDAAqD;AACrD,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IASlD;;;;;;;;;;;;;;OAcG;IACG,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAQlD;;;;;;;;;;;;;;;;;;;OAmBG;IACG,MAAM,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC;IAQ/D;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC;IAQpF;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;;;;;;;;;;;;;;;;;OAkBG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAQ9D;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQ3D;;;;;;;;;;;;;;;;OAgBG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAO7D"}

package/dist/resources/connectors.js

@@ -0,0 +1,226 @@
+import { handleError } from '../handle-error.js';
+/**
+ * Resource for managing external connectors (e.g., Google Drive).
+ *
+ * Connectors allow bidirectional synchronization between vaults and
+ * external storage providers. Requires the `connectors` plan feature.
+ *
+ * @example
+ * ```typescript
+ * const connectors = await client.connectors.list();
+ * const connector = await client.connectors.create({
+ *   provider: 'google_drive',
+ *   name: 'My Drive',
+ *   vaultId: 'vault-uuid',
+ *   syncDirection: 'bidirectional',
+ * });
+ * ```
+ */
+export class ConnectorsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Lists all connectors for the authenticated user.
+     *
+     * @param vaultId - Optional vault ID to filter connectors by
+     * @returns Array of connector objects
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's plan does not include connectors
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const connectors = await client.connectors.list();
+     * const vaultConnectors = await client.connectors.list('vault-uuid');
+     * ```
+     */
+    async list(vaultId) {
+        try {
+            const searchParams = vaultId ? { vaultId } : undefined;
+            return await this.http.get('connectors', { searchParams }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Connectors', '');
+        }
+    }
+    /**
+     * Retrieves a single connector by ID.
+     *
+     * @param connectorId - The unique identifier of the connector
+     * @returns The connector object
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const connector = await client.connectors.get('connector-uuid');
+     * console.log(connector.name, connector.status);
+     * ```
+     */
+    async get(connectorId) {
+        try {
+            return await this.http.get(`connectors/${connectorId}`).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Connector', connectorId);
+        }
+    }
+    /**
+     * Creates a new connector.
+     *
+     * @param params - Connector creation parameters
+     * @returns The newly created connector object
+     * @throws {ValidationError} If the request body is invalid
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {AuthorizationError} If the user's plan does not include connectors
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const connector = await client.connectors.create({
+     *   provider: 'google_drive',
+     *   name: 'Work Drive',
+     *   vaultId: 'vault-uuid',
+     *   syncDirection: 'bidirectional',
+     * });
+     * ```
+     */
+    async create(params) {
+        try {
+            return await this.http.post('connectors', { json: params }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Connector', params.name);
+        }
+    }
+    /**
+     * Updates an existing connector.
+     *
+     * Only the provided fields are modified; omitted fields remain unchanged.
+     *
+     * @param connectorId - The unique identifier of the connector to update
+     * @param params - Fields to update
+     * @returns The updated connector object
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {ValidationError} If the update parameters are invalid
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.connectors.update('connector-uuid', {
+     *   name: 'Renamed Drive',
+     *   syncDirection: 'pull',
+     * });
+     * ```
+     */
+    async update(connectorId, params) {
+        try {
+            return await this.http.put(`connectors/${connectorId}`, { json: params }).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Connector', connectorId);
+        }
+    }
+    /**
+     * Permanently deletes a connector.
+     *
+     * @param connectorId - The unique identifier of the connector to delete
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * await client.connectors.delete('connector-uuid');
+     * ```
+     */
+    async delete(connectorId) {
+        try {
+            await this.http.delete(`connectors/${connectorId}`);
+        }
+        catch (error) {
+            throw await handleError(error, 'Connector', connectorId);
+        }
+    }
+    /**
+     * Tests a connector's connection to the external provider.
+     *
+     * @param connectorId - The unique identifier of the connector to test
+     * @returns Object indicating success or failure with optional error message
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const result = await client.connectors.test('connector-uuid');
+     * if (result.success) {
+     *   console.log('Connection works!');
+     * } else {
+     *   console.error('Connection failed:', result.error);
+     * }
+     * ```
+     */
+    async test(connectorId) {
+        try {
+            return await this.http.post(`connectors/${connectorId}/test`).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Connector', connectorId);
+        }
+    }
+    /**
+     * Triggers a sync for a connector. The sync runs asynchronously via a background worker.
+     *
+     * @param connectorId - The unique identifier of the connector to sync
+     * @returns Object with a confirmation message
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {ValidationError} If the connector is inactive
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const result = await client.connectors.sync('connector-uuid');
+     * console.log(result.message); // 'Sync triggered successfully'
+     * ```
+     */
+    async sync(connectorId) {
+        try {
+            return await this.http.post(`connectors/${connectorId}/sync`).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Connector', connectorId);
+        }
+    }
+    /**
+     * Retrieves recent sync logs for a connector.
+     *
+     * @param connectorId - The unique identifier of the connector
+     * @returns Array of sync log entries, ordered by most recent first
+     * @throws {NotFoundError} If no connector exists with the given ID
+     * @throws {AuthenticationError} If the request is not authenticated
+     * @throws {NetworkError} If the request fails due to network issues
+     *
+     * @example
+     * ```typescript
+     * const logs = await client.connectors.logs('connector-uuid');
+     * for (const log of logs) {
+     *   console.log(`${log.status}: +${log.filesAdded} ~${log.filesUpdated} -${log.filesDeleted}`);
+     * }
+     * ```
+     */
+    async logs(connectorId) {
+        try {
+            return await this.http.get(`connectors/${connectorId}/logs`).json();
+        }
+        catch (error) {
+            throw await handleError(error, 'Connector', connectorId);
+        }
+    }
+}
+//# sourceMappingURL=connectors.js.map

package/dist/resources/connectors.js.map

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