wolfronix-sdk 2.3.0 → 2.4.1

package/dist/chunk-EDTKPA2L.mjs

@@ -0,0 +1,33 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateIn = (member, obj) => Object(obj) !== obj ? __typeError('Cannot use the "in" operator on this value') : member.has(obj);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
+
+export {
+  __require,
+  __commonJS,
+  __publicField,
+  __privateIn,
+  __privateGet,
+  __privateAdd,
+  __privateSet,
+  __privateMethod
+};

package/dist/index.d.mts

@@ -3,7 +3,7 @@
  * Zero-knowledge encryption made simple
  *
  * @package @wolfronix/sdk
- * @version 2.3.0
+ * @version 2.4.0
  */
 interface WolfronixConfig {
     /** Wolfronix server base URL */
@@ -30,6 +30,14 @@ interface EncryptResponse {
     file_id: string;
     file_size: number;
     enc_time_ms: number;
+    /** Detailed timing breakdown from server */
+    upload_ms?: number;
+    read_ms?: number;
+    encrypt_ms?: number;
+    store_ms?: number;
+    total_ms?: number;
+    /** Any extra fields from the server response */
+    [key: string]: unknown;
 }
 interface FileInfo {
     file_id: string;
@@ -108,6 +116,72 @@ interface StreamChunk {
     data: string;
     seq: number;
 }
+/** Supported managed connector database types */
+type DBType = 'supabase' | 'mongodb' | 'mysql' | 'firebase' | 'postgresql' | 'custom_api';
+interface WolfronixAdminConfig {
+    /** Wolfronix server base URL */
+    baseUrl: string;
+    /** Admin API key (X-Admin-Key header) */
+    adminKey: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Skip SSL verification for self-signed certs (default: false) */
+    insecure?: boolean;
+}
+interface EnterpriseClient {
+    id: number;
+    client_id: string;
+    client_name: string;
+    api_endpoint: string;
+    api_key: string;
+    wolfronix_key: string;
+    db_type: DBType;
+    db_config: string;
+    user_count: number;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface RegisterClientRequest {
+    /** Unique client identifier */
+    client_id: string;
+    /** Human-readable client name */
+    client_name: string;
+    /** Database type — managed connector or custom_api */
+    db_type: DBType;
+    /** JSON string with database credentials (required for managed connectors) */
+    db_config?: string;
+    /** Client's storage API URL (required only for custom_api) */
+    api_endpoint?: string;
+    /** API key for client's custom API (optional) */
+    api_key?: string;
+}
+interface RegisterClientResponse {
+    status: string;
+    client_id: string;
+    wolfronix_key: string;
+    db_type: DBType;
+    message: string;
+    connector?: string;
+    api_endpoint?: string;
+}
+interface ListClientsResponse {
+    clients: EnterpriseClient[] | null;
+    count: number;
+}
+interface UpdateClientRequest {
+    api_endpoint?: string;
+    db_type?: DBType;
+    db_config?: string;
+}
+interface UpdateClientResponse {
+    status: string;
+    message: string;
+}
+interface DeactivateClientResponse {
+    status: string;
+    message: string;
+}
 declare class WolfronixError extends Error {
     readonly code: string;
     readonly statusCode?: number;
@@ -480,5 +554,65 @@ declare class WolfronixStream {
  * ```
  */
 declare function createClient(config: WolfronixConfig | string): Wolfronix;
+/**
+ * Admin client for managing enterprise clients.
+ * Uses X-Admin-Key authentication (not user auth).
+ *
+ * @example
+ * ```typescript
+ * import { WolfronixAdmin } from '@wolfronix/sdk';
+ *
+ * const admin = new WolfronixAdmin({
+ *   baseUrl: 'https://wolfronix-server:9443',
+ *   adminKey: 'your-admin-api-key'
+ * });
+ *
+ * // Register a client with managed Supabase connector
+ * const result = await admin.registerClient({
+ *   client_id: 'acme_corp',
+ *   client_name: 'Acme Corporation',
+ *   db_type: 'supabase',
+ *   db_config: JSON.stringify({
+ *     supabase_url: 'https://xxx.supabase.co',
+ *     supabase_service_key: 'eyJ...'
+ *   })
+ * });
+ * console.log('Wolfronix key:', result.wolfronix_key);
+ * ```
+ */
+declare class WolfronixAdmin {
+    private readonly baseUrl;
+    private readonly adminKey;
+    private readonly timeout;
+    private readonly insecure;
+    constructor(config: WolfronixAdminConfig);
+    private request;
+    /**
+     * Register a new enterprise client.
+     * For managed connectors (supabase, mongodb, mysql, firebase, postgresql),
+     * provide db_type + db_config. For custom APIs, use db_type: 'custom_api' + api_endpoint.
+     */
+    registerClient(params: RegisterClientRequest): Promise<RegisterClientResponse>;
+    /**
+     * List all registered enterprise clients.
+     */
+    listClients(): Promise<ListClientsResponse>;
+    /**
+     * Get details for a specific client.
+     */
+    getClient(clientId: string): Promise<EnterpriseClient>;
+    /**
+     * Update a client's configuration (api_endpoint, db_type, db_config).
+     */
+    updateClient(clientId: string, params: UpdateClientRequest): Promise<UpdateClientResponse>;
+    /**
+     * Deactivate (soft-delete) a client. Their wolfronix_key will stop working.
+     */
+    deactivateClient(clientId: string): Promise<DeactivateClientResponse>;
+    /**
+     * Check server health.
+     */
+    healthCheck(): Promise<boolean>;
+}
 
-export { type AuthResponse, AuthenticationError, type DeleteResponse, type EncryptMessagePacket, type EncryptResponse, type FileInfo, FileNotFoundError, type KeyPartResponse, type ListFilesResponse, type MetricsResponse, NetworkError, PermissionDeniedError, type ServerBatchEncryptResult, type ServerDecryptParams, type ServerEncryptResult, type StreamChunk, type StreamSession, ValidationError, Wolfronix, type WolfronixConfig, WolfronixError, WolfronixStream, createClient, Wolfronix as default };
+export { type AuthResponse, AuthenticationError, type DBType, type DeactivateClientResponse, type DeleteResponse, type EncryptMessagePacket, type EncryptResponse, type EnterpriseClient, type FileInfo, FileNotFoundError, type KeyPartResponse, type ListClientsResponse, type ListFilesResponse, type MetricsResponse, NetworkError, PermissionDeniedError, type RegisterClientRequest, type RegisterClientResponse, type ServerBatchEncryptResult, type ServerDecryptParams, type ServerEncryptResult, type StreamChunk, type StreamSession, type UpdateClientRequest, type UpdateClientResponse, ValidationError, Wolfronix, WolfronixAdmin, type WolfronixAdminConfig, type WolfronixConfig, WolfronixError, WolfronixStream, createClient, Wolfronix as default };

package/dist/index.d.ts

@@ -3,7 +3,7 @@
  * Zero-knowledge encryption made simple
  *
  * @package @wolfronix/sdk
- * @version 2.3.0
+ * @version 2.4.0
  */
 interface WolfronixConfig {
     /** Wolfronix server base URL */
@@ -30,6 +30,14 @@ interface EncryptResponse {
     file_id: string;
     file_size: number;
     enc_time_ms: number;
+    /** Detailed timing breakdown from server */
+    upload_ms?: number;
+    read_ms?: number;
+    encrypt_ms?: number;
+    store_ms?: number;
+    total_ms?: number;
+    /** Any extra fields from the server response */
+    [key: string]: unknown;
 }
 interface FileInfo {
     file_id: string;
@@ -108,6 +116,72 @@ interface StreamChunk {
     data: string;
     seq: number;
 }
+/** Supported managed connector database types */
+type DBType = 'supabase' | 'mongodb' | 'mysql' | 'firebase' | 'postgresql' | 'custom_api';
+interface WolfronixAdminConfig {
+    /** Wolfronix server base URL */
+    baseUrl: string;
+    /** Admin API key (X-Admin-Key header) */
+    adminKey: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Skip SSL verification for self-signed certs (default: false) */
+    insecure?: boolean;
+}
+interface EnterpriseClient {
+    id: number;
+    client_id: string;
+    client_name: string;
+    api_endpoint: string;
+    api_key: string;
+    wolfronix_key: string;
+    db_type: DBType;
+    db_config: string;
+    user_count: number;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+interface RegisterClientRequest {
+    /** Unique client identifier */
+    client_id: string;
+    /** Human-readable client name */
+    client_name: string;
+    /** Database type — managed connector or custom_api */
+    db_type: DBType;
+    /** JSON string with database credentials (required for managed connectors) */
+    db_config?: string;
+    /** Client's storage API URL (required only for custom_api) */
+    api_endpoint?: string;
+    /** API key for client's custom API (optional) */
+    api_key?: string;
+}
+interface RegisterClientResponse {
+    status: string;
+    client_id: string;
+    wolfronix_key: string;
+    db_type: DBType;
+    message: string;
+    connector?: string;
+    api_endpoint?: string;
+}
+interface ListClientsResponse {
+    clients: EnterpriseClient[] | null;
+    count: number;
+}
+interface UpdateClientRequest {
+    api_endpoint?: string;
+    db_type?: DBType;
+    db_config?: string;
+}
+interface UpdateClientResponse {
+    status: string;
+    message: string;
+}
+interface DeactivateClientResponse {
+    status: string;
+    message: string;
+}
 declare class WolfronixError extends Error {
     readonly code: string;
     readonly statusCode?: number;
@@ -480,5 +554,65 @@ declare class WolfronixStream {
  * ```
  */
 declare function createClient(config: WolfronixConfig | string): Wolfronix;
+/**
+ * Admin client for managing enterprise clients.
+ * Uses X-Admin-Key authentication (not user auth).
+ *
+ * @example
+ * ```typescript
+ * import { WolfronixAdmin } from '@wolfronix/sdk';
+ *
+ * const admin = new WolfronixAdmin({
+ *   baseUrl: 'https://wolfronix-server:9443',
+ *   adminKey: 'your-admin-api-key'
+ * });
+ *
+ * // Register a client with managed Supabase connector
+ * const result = await admin.registerClient({
+ *   client_id: 'acme_corp',
+ *   client_name: 'Acme Corporation',
+ *   db_type: 'supabase',
+ *   db_config: JSON.stringify({
+ *     supabase_url: 'https://xxx.supabase.co',
+ *     supabase_service_key: 'eyJ...'
+ *   })
+ * });
+ * console.log('Wolfronix key:', result.wolfronix_key);
+ * ```
+ */
+declare class WolfronixAdmin {
+    private readonly baseUrl;
+    private readonly adminKey;
+    private readonly timeout;
+    private readonly insecure;
+    constructor(config: WolfronixAdminConfig);
+    private request;
+    /**
+     * Register a new enterprise client.
+     * For managed connectors (supabase, mongodb, mysql, firebase, postgresql),
+     * provide db_type + db_config. For custom APIs, use db_type: 'custom_api' + api_endpoint.
+     */
+    registerClient(params: RegisterClientRequest): Promise<RegisterClientResponse>;
+    /**
+     * List all registered enterprise clients.
+     */
+    listClients(): Promise<ListClientsResponse>;
+    /**
+     * Get details for a specific client.
+     */
+    getClient(clientId: string): Promise<EnterpriseClient>;
+    /**
+     * Update a client's configuration (api_endpoint, db_type, db_config).
+     */
+    updateClient(clientId: string, params: UpdateClientRequest): Promise<UpdateClientResponse>;
+    /**
+     * Deactivate (soft-delete) a client. Their wolfronix_key will stop working.
+     */
+    deactivateClient(clientId: string): Promise<DeactivateClientResponse>;
+    /**
+     * Check server health.
+     */
+    healthCheck(): Promise<boolean>;
+}
 
-export { type AuthResponse, AuthenticationError, type DeleteResponse, type EncryptMessagePacket, type EncryptResponse, type FileInfo, FileNotFoundError, type KeyPartResponse, type ListFilesResponse, type MetricsResponse, NetworkError, PermissionDeniedError, type ServerBatchEncryptResult, type ServerDecryptParams, type ServerEncryptResult, type StreamChunk, type StreamSession, ValidationError, Wolfronix, type WolfronixConfig, WolfronixError, WolfronixStream, createClient, Wolfronix as default };
+export { type AuthResponse, AuthenticationError, type DBType, type DeactivateClientResponse, type DeleteResponse, type EncryptMessagePacket, type EncryptResponse, type EnterpriseClient, type FileInfo, FileNotFoundError, type KeyPartResponse, type ListClientsResponse, type ListFilesResponse, type MetricsResponse, NetworkError, PermissionDeniedError, type RegisterClientRequest, type RegisterClientResponse, type ServerBatchEncryptResult, type ServerDecryptParams, type ServerEncryptResult, type StreamChunk, type StreamSession, type UpdateClientRequest, type UpdateClientResponse, ValidationError, Wolfronix, WolfronixAdmin, type WolfronixAdminConfig, type WolfronixConfig, WolfronixError, WolfronixStream, createClient, Wolfronix as default };