@aouda/client 0.0.1 → 0.0.3

package/README.md

@@ -146,6 +146,8 @@ npm run lint     # Lint code
 
 See [AGENTS.md](./AGENTS.md) for development workflow.
 
+Maintainers: see [Release Process](./docs/dev/Release-Process.md) for Changesets and npm publish. After publish, follow **`Cross-Repo-Release-And-Version-Bump.md`** in the shared docs repo (`D:\GitHub\docs\` or `C:\Data\GitHub\docs\`) to bump Studio and update the compatibility matrix.
+
 ## License
 
 MIT

package/dist/cli/index.cjs

@@ -418,6 +418,74 @@ var fs3 = __toESM(require("fs"), 1);
 var path3 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 
+// 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) => {
@@ -517,6 +585,54 @@ 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);
+}
+
 // src/auth/auth-handler.ts
 var DEFAULT_REFRESH_THRESHOLD_MS = 12e4;
 var CONTENT_TYPE_JSON = "application/json";
@@ -707,7 +823,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)
@@ -740,7 +856,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)
@@ -767,7 +883,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 }),
@@ -807,7 +923,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),
@@ -1160,7 +1276,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,
@@ -1483,7 +1599,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) {
@@ -1597,7 +1713,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;
       }
@@ -4441,6 +4557,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) {
@@ -4452,6 +4641,7 @@ var AdminApi = class {
     this.backup = new BackupAdminApi(transport);
     this.config = new ConfigAdminApi(transport);
     this.node = new NodeAdminApi(transport);
+    this.notifications = new NotificationsAdminApi(transport);
   }
 };
 
@@ -4912,7 +5102,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;
@@ -5554,6 +5744,9 @@ function createAoudaClient(options) {
   return new AoudaClient(options);
 }
 
+// src/index.ts
+var version = package_default.version;
+
 // src/cli/index.ts
 var import_meta = {};
 var HELP = `Aouda TypeScript client CLI