@aouda/client 0.0.1 → 0.0.2

package/dist/{client-DXT2ZAeO.d.cts → client-otKeBYQG.d.cts}

@@ -1862,6 +1862,126 @@ declare class NodeAdminApi {
     private buildLogsPath;
 }
 
+/**
+ * Notification provider settings types.
+ * Mirrors Aouda server JSON payloads under /admin/notifications.
+ */
+/** Where the current provider config comes from. */
+type NotificationProviderSource = "db" | "env" | "none";
+/** Information about one configured notification provider (email or SMS). */
+interface NotificationProviderInfo {
+    /** Provider identifier, e.g. "sendgrid", "gatewayapi", "console", "none". */
+    provider: string;
+    /**
+     * Where the provider config was loaded from.
+     * "db" = persisted in _settings DB; "env" = appsettings/env var; "none" = no provider.
+     */
+    source: NotificationProviderSource;
+    /** Masked API key: "****" + last 4 chars, or null if not set. */
+    apiKeyMasked: string | null;
+    /** From address (email only). */
+    fromAddress?: string | null;
+    /** From display name (email only). */
+    fromName?: string | null;
+    /** Invite URL template (email only). */
+    inviteUrl?: string | null;
+    /** Password reset URL template (email only). */
+    passwordResetUrl?: string | null;
+    /** Sender name / short-code (SMS only). */
+    sender?: string | null;
+    /** SMS gateway base URL override (SMS only). */
+    baseUrl?: string | null;
+}
+/** Response from GET /admin/notifications. */
+interface NotificationSettingsResponse {
+    email: NotificationProviderInfo;
+    sms: NotificationProviderInfo;
+    availableEmailProviders: string[];
+    availableSmsProviders: string[];
+}
+/** Request body for PUT /admin/notifications/email. */
+interface PutEmailProviderRequest {
+    provider: string;
+    /**
+     * New API key. Omit or set to undefined/null to keep the existing stored key.
+     * Empty string "" is rejected with 400.
+     */
+    apiKey?: string | null;
+    fromAddress?: string | null;
+    fromName?: string | null;
+    inviteUrl?: string | null;
+    passwordResetUrl?: string | null;
+}
+/** Request body for PUT /admin/notifications/sms. */
+interface PutSmsProviderRequest {
+    provider: string;
+    /** New API key. Omit or null to keep the existing stored key. Empty string "" is rejected. */
+    apiKey?: string | null;
+    sender?: string | null;
+    baseUrl?: string | null;
+}
+/** Request body for POST /admin/notifications/email/test. */
+interface TestEmailRequest {
+    /** Recipient address for the test message. */
+    to: string;
+}
+/** Request body for POST /admin/notifications/sms/test. */
+interface TestSmsRequest {
+    /** Recipient phone number in E.164 format. */
+    to: string;
+}
+/** Response from POST /admin/notifications/{email|sms}/test. */
+interface TestSendResult {
+    success: boolean;
+    /** Error message if success is false. */
+    error?: string | null;
+}
+
+/**
+ * Admin notification provider settings API.
+ * Access via client.admin.notifications.
+ */
+
+declare class NotificationsAdminApi {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Get current notification provider state.
+     * GET /admin/notifications
+     */
+    get(): Promise<NotificationSettingsResponse>;
+    /**
+     * Set or update the email notification provider.
+     * PUT /admin/notifications/email
+     */
+    putEmail(request: PutEmailProviderRequest): Promise<NotificationSettingsResponse>;
+    /**
+     * Remove the email notification provider (reverts to env/appsettings).
+     * DELETE /admin/notifications/email
+     */
+    deleteEmail(): Promise<NotificationSettingsResponse>;
+    /**
+     * Set or update the SMS notification provider.
+     * PUT /admin/notifications/sms
+     */
+    putSms(request: PutSmsProviderRequest): Promise<NotificationSettingsResponse>;
+    /**
+     * Remove the SMS notification provider (reverts to env/appsettings).
+     * DELETE /admin/notifications/sms
+     */
+    deleteSms(): Promise<NotificationSettingsResponse>;
+    /**
+     * Send a test email via the currently configured provider.
+     * POST /admin/notifications/email/test
+     */
+    testEmail(request: TestEmailRequest): Promise<TestSendResult>;
+    /**
+     * Send a test SMS via the currently configured provider.
+     * POST /admin/notifications/sms/test
+     */
+    testSms(request: TestSmsRequest): Promise<TestSendResult>;
+}
+
 /**
  * Admin API: server info, memory, metrics, health, replication.
  * Access via client.admin.
@@ -1877,6 +1997,7 @@ declare class AdminApi {
     readonly backup: BackupAdminApi;
     readonly config: ConfigAdminApi;
     readonly node: NodeAdminApi;
+    readonly notifications: NotificationsAdminApi;
     constructor(transport: Transport);
 }
 

package/dist/{client-DXT2ZAeO.d.ts → client-otKeBYQG.d.ts}

@@ -1862,6 +1862,126 @@ declare class NodeAdminApi {
     private buildLogsPath;
 }
 
+/**
+ * Notification provider settings types.
+ * Mirrors Aouda server JSON payloads under /admin/notifications.
+ */
+/** Where the current provider config comes from. */
+type NotificationProviderSource = "db" | "env" | "none";
+/** Information about one configured notification provider (email or SMS). */
+interface NotificationProviderInfo {
+    /** Provider identifier, e.g. "sendgrid", "gatewayapi", "console", "none". */
+    provider: string;
+    /**
+     * Where the provider config was loaded from.
+     * "db" = persisted in _settings DB; "env" = appsettings/env var; "none" = no provider.
+     */
+    source: NotificationProviderSource;
+    /** Masked API key: "****" + last 4 chars, or null if not set. */
+    apiKeyMasked: string | null;
+    /** From address (email only). */
+    fromAddress?: string | null;
+    /** From display name (email only). */
+    fromName?: string | null;
+    /** Invite URL template (email only). */
+    inviteUrl?: string | null;
+    /** Password reset URL template (email only). */
+    passwordResetUrl?: string | null;
+    /** Sender name / short-code (SMS only). */
+    sender?: string | null;
+    /** SMS gateway base URL override (SMS only). */
+    baseUrl?: string | null;
+}
+/** Response from GET /admin/notifications. */
+interface NotificationSettingsResponse {
+    email: NotificationProviderInfo;
+    sms: NotificationProviderInfo;
+    availableEmailProviders: string[];
+    availableSmsProviders: string[];
+}
+/** Request body for PUT /admin/notifications/email. */
+interface PutEmailProviderRequest {
+    provider: string;
+    /**
+     * New API key. Omit or set to undefined/null to keep the existing stored key.
+     * Empty string "" is rejected with 400.
+     */
+    apiKey?: string | null;
+    fromAddress?: string | null;
+    fromName?: string | null;
+    inviteUrl?: string | null;
+    passwordResetUrl?: string | null;
+}
+/** Request body for PUT /admin/notifications/sms. */
+interface PutSmsProviderRequest {
+    provider: string;
+    /** New API key. Omit or null to keep the existing stored key. Empty string "" is rejected. */
+    apiKey?: string | null;
+    sender?: string | null;
+    baseUrl?: string | null;
+}
+/** Request body for POST /admin/notifications/email/test. */
+interface TestEmailRequest {
+    /** Recipient address for the test message. */
+    to: string;
+}
+/** Request body for POST /admin/notifications/sms/test. */
+interface TestSmsRequest {
+    /** Recipient phone number in E.164 format. */
+    to: string;
+}
+/** Response from POST /admin/notifications/{email|sms}/test. */
+interface TestSendResult {
+    success: boolean;
+    /** Error message if success is false. */
+    error?: string | null;
+}
+
+/**
+ * Admin notification provider settings API.
+ * Access via client.admin.notifications.
+ */
+
+declare class NotificationsAdminApi {
+    private readonly transport;
+    constructor(transport: Transport);
+    /**
+     * Get current notification provider state.
+     * GET /admin/notifications
+     */
+    get(): Promise<NotificationSettingsResponse>;
+    /**
+     * Set or update the email notification provider.
+     * PUT /admin/notifications/email
+     */
+    putEmail(request: PutEmailProviderRequest): Promise<NotificationSettingsResponse>;
+    /**
+     * Remove the email notification provider (reverts to env/appsettings).
+     * DELETE /admin/notifications/email
+     */
+    deleteEmail(): Promise<NotificationSettingsResponse>;
+    /**
+     * Set or update the SMS notification provider.
+     * PUT /admin/notifications/sms
+     */
+    putSms(request: PutSmsProviderRequest): Promise<NotificationSettingsResponse>;
+    /**
+     * Remove the SMS notification provider (reverts to env/appsettings).
+     * DELETE /admin/notifications/sms
+     */
+    deleteSms(): Promise<NotificationSettingsResponse>;
+    /**
+     * Send a test email via the currently configured provider.
+     * POST /admin/notifications/email/test
+     */
+    testEmail(request: TestEmailRequest): Promise<TestSendResult>;
+    /**
+     * Send a test SMS via the currently configured provider.
+     * POST /admin/notifications/sms/test
+     */
+    testSms(request: TestSmsRequest): Promise<TestSendResult>;
+}
+
 /**
  * Admin API: server info, memory, metrics, health, replication.
  * Access via client.admin.
@@ -1877,6 +1997,7 @@ declare class AdminApi {
     readonly backup: BackupAdminApi;
     readonly config: ConfigAdminApi;
     readonly node: NodeAdminApi;
+    readonly notifications: NotificationsAdminApi;
     constructor(transport: Transport);
 }
 

package/dist/index.cjs

@@ -4112,6 +4112,79 @@ function parseSseLogEvent(rawEvent) {
   return null;
 }
 
+// src/admin/notifications.ts
+var BASE_PATH7 = "/admin/notifications";
+var NotificationsAdminApi = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  /**
+   * Get current notification provider state.
+   * GET /admin/notifications
+   */
+  async get() {
+    return this.transport.get(BASE_PATH7);
+  }
+  /**
+   * Set or update the email notification provider.
+   * PUT /admin/notifications/email
+   */
+  async putEmail(request) {
+    return this.transport.put(
+      `${BASE_PATH7}/email`,
+      request
+    );
+  }
+  /**
+   * Remove the email notification provider (reverts to env/appsettings).
+   * DELETE /admin/notifications/email
+   */
+  async deleteEmail() {
+    return this.transport.delete(
+      `${BASE_PATH7}/email`
+    );
+  }
+  /**
+   * Set or update the SMS notification provider.
+   * PUT /admin/notifications/sms
+   */
+  async putSms(request) {
+    return this.transport.put(
+      `${BASE_PATH7}/sms`,
+      request
+    );
+  }
+  /**
+   * Remove the SMS notification provider (reverts to env/appsettings).
+   * DELETE /admin/notifications/sms
+   */
+  async deleteSms() {
+    return this.transport.delete(
+      `${BASE_PATH7}/sms`
+    );
+  }
+  /**
+   * Send a test email via the currently configured provider.
+   * POST /admin/notifications/email/test
+   */
+  async testEmail(request) {
+    return this.transport.post(
+      `${BASE_PATH7}/email/test`,
+      request
+    );
+  }
+  /**
+   * Send a test SMS via the currently configured provider.
+   * POST /admin/notifications/sms/test
+   */
+  async testSms(request) {
+    return this.transport.post(
+      `${BASE_PATH7}/sms/test`,
+      request
+    );
+  }
+};
+
 // src/admin/index.ts
 var AdminApi = class {
   constructor(transport) {
@@ -4123,6 +4196,7 @@ var AdminApi = class {
     this.backup = new BackupAdminApi(transport);
     this.config = new ConfigAdminApi(transport);
     this.node = new NodeAdminApi(transport);
+    this.notifications = new NotificationsAdminApi(transport);
   }
 };
 
@@ -5489,7 +5563,7 @@ function createAoudaClusterMcpToolSet(client) {
 }
 
 // src/index.ts
-var version = "0.0.1";
+var version = "0.0.2";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AOUDA_DATA_TYPES,