@aouda/client 0.0.1 → 0.0.3

package/dist/{client-DXT2ZAeO.d.cts → client-Bvs1yerF.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);
 }
 
@@ -1887,7 +2008,7 @@ declare class AdminApi {
  * Two-layer auth model: clients connect via API key (Layer 1); user sign-in is performed
  * explicitly via AuthClient.signIn() (Layer 2). There is no auto-authentication on first request.
  *
- * All auth endpoint calls use direct globalThis.fetch to avoid
+ * All auth endpoint calls use direct fetch (with LNA hints) to avoid
  * circular refresh through the transport pipeline.
  *
  * @internal

package/dist/{client-DXT2ZAeO.d.ts → client-Bvs1yerF.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);
 }
 
@@ -1887,7 +2008,7 @@ declare class AdminApi {
  * Two-layer auth model: clients connect via API key (Layer 1); user sign-in is performed
  * explicitly via AuthClient.signIn() (Layer 2). There is no auto-authentication on first request.
  *
- * All auth endpoint calls use direct globalThis.fetch to avoid
+ * All auth endpoint calls use direct fetch (with LNA hints) to avoid
  * circular refresh through the transport pipeline.
  *
  * @internal

package/dist/index.cjs

@@ -65,13 +65,85 @@ __export(index_exports, {
   TableQuery: () => TableQuery,
   TablesApi: () => TablesApi,
   WhereGroupBuilder: () => WhereGroupBuilder,
+  applyLocalNetworkAccess: () => applyLocalNetworkAccess,
   coerceColumnarValue: () => coerceColumnarValue,
   createAoudaClient: () => createAoudaClient,
   createAoudaClusterMcpToolSet: () => createAoudaClusterMcpToolSet,
+  installLocalNetworkFetch: () => installLocalNetworkFetch,
+  localNetworkFetch: () => localNetworkFetch,
+  resolveTargetAddressSpace: () => resolveTargetAddressSpace,
   version: () => version
 });
 module.exports = __toCommonJS(index_exports);
 
+// package.json
+var package_default = {
+  name: "@aouda/client",
+  version: "0.0.3",
+  description: "Official TypeScript/JavaScript client library for Aouda",
+  type: "module",
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  bin: "./dist/cli/index.js",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    }
+  },
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "https://github.com/aoudadb/aouda-client-ts.git"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  files: [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  scripts: {
+    changeset: "changeset",
+    "version-packages": "changeset version",
+    release: "changeset publish",
+    prepublishOnly: "npm run build",
+    build: "tsup",
+    dev: "tsup --watch",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    lint: "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    format: 'prettier --write "src/**/*.ts" "tests/**/*.ts"',
+    typecheck: "tsc --noEmit && tsc -p tsconfig.typecheck.json --noEmit",
+    "generate-types": "node dist/cli/index.js generate --server http://localhost:5000 --output ./types/schema.ts"
+  },
+  engines: {
+    node: ">=20"
+  },
+  devDependencies: {
+    "@changesets/cli": "^2.29.8",
+    "@eslint/js": "^9.15.0",
+    "@types/node": "^25.2.1",
+    "@types/ws": "^8.18.1",
+    eslint: "^9.15.0",
+    "eslint-config-prettier": "^9.1.0",
+    prettier: "^3.3.3",
+    tsup: "^8.3.5",
+    typescript: "^5.6.3",
+    "typescript-eslint": "^8.15.0",
+    vitest: "^2.1.4"
+  },
+  dependencies: {
+    "@msgpack/msgpack": "^3.1.3",
+    ws: "^8.20.0"
+  }
+};
+
 // src/types.ts
 var RetryPolicy;
 ((RetryPolicy2) => {
@@ -188,6 +260,70 @@ var AoudaCircuitBreakerOpenError = class extends AoudaError {
   }
 };
 
+// src/local-network-fetch.ts
+function resolveTargetAddressSpace(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return void 0;
+  }
+  const hostname = parsed.hostname.replace(/^\[|\]$/g, "").toLowerCase();
+  if (hostname === "localhost" || hostname === "::1") {
+    return "loopback";
+  }
+  const ipv4 = hostname.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
+  if (ipv4) {
+    const [first, second] = [Number(ipv4[1]), Number(ipv4[2])];
+    if (first === 127) return "loopback";
+    if (first === 10) return "local";
+    if (first === 172 && second >= 16 && second <= 31) return "local";
+    if (first === 192 && second === 168) return "local";
+    if (first === 169 && second === 254) return "local";
+  }
+  if (hostname.endsWith(".local")) {
+    return "local";
+  }
+  return void 0;
+}
+function applyLocalNetworkAccess(url, init) {
+  const space = resolveTargetAddressSpace(url);
+  if (!space) {
+    return init ?? {};
+  }
+  return { ...init, targetAddressSpace: space };
+}
+function resolveFetchUrl(input) {
+  if (typeof input === "string") {
+    return input;
+  }
+  if (input instanceof URL) {
+    return input.href;
+  }
+  return input.url;
+}
+function localNetworkFetch(input, init) {
+  const url = resolveFetchUrl(input);
+  const merged = applyLocalNetworkAccess(url, init);
+  return globalThis.fetch(input, merged);
+}
+var installed = false;
+function installLocalNetworkFetch() {
+  if (installed || typeof globalThis.window === "undefined") {
+    return;
+  }
+  installed = true;
+  const nativeFetch = globalThis.fetch.bind(globalThis);
+  globalThis.fetch = (input, init) => {
+    const url = resolveFetchUrl(input);
+    const space = resolveTargetAddressSpace(url);
+    if (!space) {
+      return nativeFetch(input, init);
+    }
+    return nativeFetch(input, applyLocalNetworkAccess(url, init));
+  };
+}
+
 // src/auth/auth-handler.ts
 var DEFAULT_REFRESH_THRESHOLD_MS = 12e4;
 var CONTENT_TYPE_JSON = "application/json";
@@ -378,7 +514,7 @@ var AuthHandler = class {
       headers["Authorization"] = `Bearer ${this._accessToken}`;
     }
     try {
-      await globalThis.fetch(url, {
+      await localNetworkFetch(url, {
         method: "POST",
         headers,
         signal: AbortSignal.timeout(this._timeout)
@@ -411,7 +547,7 @@ var AuthHandler = class {
     if (token) {
       headers["Authorization"] = `Bearer ${token}`;
     }
-    const response = await globalThis.fetch(url, {
+    const response = await localNetworkFetch(url, {
       method: "GET",
       headers,
       signal: AbortSignal.timeout(this._timeout)
@@ -438,7 +574,7 @@ var AuthHandler = class {
     if (token) {
       headers["Authorization"] = `Bearer ${token}`;
     }
-    const response = await globalThis.fetch(url, {
+    const response = await localNetworkFetch(url, {
       method: "PUT",
       headers,
       body: JSON.stringify({ currentPassword, newPassword }),
@@ -478,7 +614,7 @@ var AuthHandler = class {
     if (this._accessToken) {
       headers["Authorization"] = `Bearer ${this._accessToken}`;
     }
-    return globalThis.fetch(url, {
+    return localNetworkFetch(url, {
       method,
       headers,
       body: JSON.stringify(body),
@@ -831,7 +967,7 @@ var AuthClient = class {
     if (token) {
       headers["Authorization"] = `Bearer ${token}`;
     }
-    const response = await globalThis.fetch(endpoint, {
+    const response = await localNetworkFetch(endpoint, {
       method,
       headers,
       body: body !== void 0 && method !== "GET" && method !== "DELETE" ? JSON.stringify(body) : void 0,
@@ -1154,7 +1290,7 @@ var HttpTransport = class {
       init.body = JSON.stringify(config.body);
     }
     try {
-      const response = await fetch(url, init);
+      const response = await localNetworkFetch(url, init);
       if (!response.ok) {
         const text = await response.text();
         if (config.allowStatuses?.includes(response.status) && text) {
@@ -1268,7 +1404,7 @@ var HttpTransport = class {
       init.body = JSON.stringify(config.body);
     }
     try {
-      const response = await fetch(url, init);
+      const response = await localNetworkFetch(url, init);
       if (response.ok || config.allowStatuses?.includes(response.status)) {
         return response;
       }
@@ -4112,6 +4248,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 +4332,7 @@ var AdminApi = class {
     this.backup = new BackupAdminApi(transport);
     this.config = new ConfigAdminApi(transport);
     this.node = new NodeAdminApi(transport);
+    this.notifications = new NotificationsAdminApi(transport);
   }
 };
 
@@ -4596,7 +4806,7 @@ var LongPollTransport = class {
     this._authHandler = options.authHandler;
     this._onReconnected = options.onReconnected;
     this._waitMs = Math.max(1, options.waitMs ?? DEFAULT_WAIT_MS);
-    this._fetch = options.fetchImpl ?? fetch;
+    this._fetch = options.fetchImpl ?? localNetworkFetch;
   }
   get lastVersion() {
     return this._lastVersion;
@@ -5489,7 +5699,7 @@ function createAoudaClusterMcpToolSet(client) {
 }
 
 // src/index.ts
-var version = "0.0.1";
+var version = package_default.version;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AOUDA_DATA_TYPES,
@@ -5527,9 +5737,13 @@ var version = "0.0.1";
   TableQuery,
   TablesApi,
   WhereGroupBuilder,
+  applyLocalNetworkAccess,
   coerceColumnarValue,
   createAoudaClient,
   createAoudaClusterMcpToolSet,
+  installLocalNetworkFetch,
+  localNetworkFetch,
+  resolveTargetAddressSpace,
   version
 });
 //# sourceMappingURL=index.cjs.map