@open-apime/sdk 0.2.2 → 0.3.0

package/dist/index.cjs

@@ -176,6 +176,18 @@ function errorFromResponse(status, body, headers) {
   }
 }
 
+// src/http/dispatcher.ts
+var import_node_dns = require("dns");
+var applied;
+function preferIpFamily(family) {
+  if (applied !== void 0) return;
+  try {
+    (0, import_node_dns.setDefaultResultOrder)(family === 4 ? "ipv4first" : "ipv6first");
+    applied = family;
+  } catch {
+  }
+}
+
 // src/http/url.ts
 var BLOCKED_HOSTS = /* @__PURE__ */ new Set(["169.254.169.254", "metadata.google.internal"]);
 function assertUsableBaseUrl(raw) {
@@ -237,6 +249,7 @@ var HttpClient = class {
     this.auth = options.auth;
     this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    if (options.ipFamily) preferIpFamily(options.ipFamily);
     this.fetchImpl = options.fetch ?? globalThis.fetch;
     this.userAgent = options.appName ? `open-apime-sdk (${options.appName})` : "open-apime-sdk";
     this.observer = options.observer;
@@ -745,6 +758,7 @@ function toHttpOptions(auth, options) {
     ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
     ...options.maxRetries !== void 0 ? { maxRetries: options.maxRetries } : {},
     ...options.fetch !== void 0 ? { fetch: options.fetch } : {},
+    ...options.ipFamily !== void 0 ? { ipFamily: options.ipFamily } : {},
     ...options.appName !== void 0 ? { appName: options.appName } : {},
     ...options.observer !== void 0 ? { observer: options.observer } : {},
     ...options.autoReport !== void 0 ? { autoReport: options.autoReport } : {}

package/dist/index.d.cts

@@ -79,6 +79,8 @@ interface Observer {
 /** True when the app has an initialized Sentry. Absent means every report is a no-op. */
 declare function hasSentry(): boolean;
 
+type IpFamily = 4 | 6;
+
 interface RequestOptions {
     timeoutMs?: number;
     maxRetries?: number;
@@ -97,6 +99,12 @@ interface HttpClientOptions {
     timeoutMs?: number;
     maxRetries?: number;
     fetch?: typeof globalThis.fetch;
+    /**
+     * Tries this IP family first when resolving the host. Use 4 when the apime
+     * answers AAAA but the network has no IPv6 route, so failed v6 attempts stop
+     * polluting the errors. Process-wide: Node offers no per-request knob.
+     */
+    ipFamily?: IpFamily;
     /** Appended to the User-Agent, to identify the calling app in the apime logs. */
     appName?: string;
     /** Where the app plugs its logger or error tracker. See Observer. */
@@ -461,6 +469,12 @@ interface ClientOptions {
     timeoutMs?: number;
     maxRetries?: number;
     fetch?: typeof globalThis.fetch;
+    /**
+     * Tries this IP family first when resolving the host. Use 4 when the apime
+     * answers AAAA but the network has no IPv6 route, so failed v6 attempts stop
+     * polluting the errors. Process-wide: Node offers no per-request knob.
+     */
+    ipFamily?: IpFamily;
     appName?: string;
     /**
      * Reports every request, failure and retry to the app's own logger or error
@@ -468,8 +482,8 @@ interface ClientOptions {
      */
     observer?: Observer;
     /**
-     * Sem `observer`, a falha definitiva ainda vai para o Sentry que o app já
-     * roda, achado pelo cliente global. Sem Sentry, não faz nada. `false` cala.
+     * With no `observer`, definitive failures still reach the Sentry the app
+     * already runs, found through its global client. No Sentry means no-op.
      */
     autoReport?: boolean;
 }
@@ -509,4 +523,4 @@ declare const Apime: {
     }, options: ClientOptions): ApimeInstanceClient;
 };
 
-export { type ApiToken, type ApiTokenAuth, Apime, ApimeError, ApimeInstanceClient, ApimeUserClient, type Auth, type AuthKind, type CheckNumberResult, type ClientOptions, type ContactEntry, type CreateInstanceInput, EventLogEntry, type FailureInfo, type GroupInfo, type GroupParticipant, Instance, InstanceInfo, type InstanceTokenAuth, type JoinRequestAction, type MarkReadInput, type Observer, type ParticipantAction, type PresenceState, Profile, QrCode, type QuoteInput, type RequestInfo, type RequestOptions, type SendAudioInput, type SendContactInput, type SendDocumentInput, type SendLocationInput, type SendMediaInput, type SendTextInput, SentMessage, type SuccessInfo, type UpdateInstanceInput, type User, type UserAuth, type UserJwtAuth, hasSentry };
+export { type ApiToken, type ApiTokenAuth, Apime, ApimeError, ApimeInstanceClient, ApimeUserClient, type Auth, type AuthKind, type CheckNumberResult, type ClientOptions, type ContactEntry, type CreateInstanceInput, EventLogEntry, type FailureInfo, type GroupInfo, type GroupParticipant, Instance, InstanceInfo, type InstanceTokenAuth, type IpFamily, type JoinRequestAction, type MarkReadInput, type Observer, type ParticipantAction, type PresenceState, Profile, QrCode, type QuoteInput, type RequestInfo, type RequestOptions, type SendAudioInput, type SendContactInput, type SendDocumentInput, type SendLocationInput, type SendMediaInput, type SendTextInput, SentMessage, type SuccessInfo, type UpdateInstanceInput, type User, type UserAuth, type UserJwtAuth, hasSentry };

package/dist/index.d.ts

@@ -79,6 +79,8 @@ interface Observer {
 /** True when the app has an initialized Sentry. Absent means every report is a no-op. */
 declare function hasSentry(): boolean;
 
+type IpFamily = 4 | 6;
+
 interface RequestOptions {
     timeoutMs?: number;
     maxRetries?: number;
@@ -97,6 +99,12 @@ interface HttpClientOptions {
     timeoutMs?: number;
     maxRetries?: number;
     fetch?: typeof globalThis.fetch;
+    /**
+     * Tries this IP family first when resolving the host. Use 4 when the apime
+     * answers AAAA but the network has no IPv6 route, so failed v6 attempts stop
+     * polluting the errors. Process-wide: Node offers no per-request knob.
+     */
+    ipFamily?: IpFamily;
     /** Appended to the User-Agent, to identify the calling app in the apime logs. */
     appName?: string;
     /** Where the app plugs its logger or error tracker. See Observer. */
@@ -461,6 +469,12 @@ interface ClientOptions {
     timeoutMs?: number;
     maxRetries?: number;
     fetch?: typeof globalThis.fetch;
+    /**
+     * Tries this IP family first when resolving the host. Use 4 when the apime
+     * answers AAAA but the network has no IPv6 route, so failed v6 attempts stop
+     * polluting the errors. Process-wide: Node offers no per-request knob.
+     */
+    ipFamily?: IpFamily;
     appName?: string;
     /**
      * Reports every request, failure and retry to the app's own logger or error
@@ -468,8 +482,8 @@ interface ClientOptions {
      */
     observer?: Observer;
     /**
-     * Sem `observer`, a falha definitiva ainda vai para o Sentry que o app já
-     * roda, achado pelo cliente global. Sem Sentry, não faz nada. `false` cala.
+     * With no `observer`, definitive failures still reach the Sentry the app
+     * already runs, found through its global client. No Sentry means no-op.
      */
     autoReport?: boolean;
 }
@@ -509,4 +523,4 @@ declare const Apime: {
     }, options: ClientOptions): ApimeInstanceClient;
 };
 
-export { type ApiToken, type ApiTokenAuth, Apime, ApimeError, ApimeInstanceClient, ApimeUserClient, type Auth, type AuthKind, type CheckNumberResult, type ClientOptions, type ContactEntry, type CreateInstanceInput, EventLogEntry, type FailureInfo, type GroupInfo, type GroupParticipant, Instance, InstanceInfo, type InstanceTokenAuth, type JoinRequestAction, type MarkReadInput, type Observer, type ParticipantAction, type PresenceState, Profile, QrCode, type QuoteInput, type RequestInfo, type RequestOptions, type SendAudioInput, type SendContactInput, type SendDocumentInput, type SendLocationInput, type SendMediaInput, type SendTextInput, SentMessage, type SuccessInfo, type UpdateInstanceInput, type User, type UserAuth, type UserJwtAuth, hasSentry };
+export { type ApiToken, type ApiTokenAuth, Apime, ApimeError, ApimeInstanceClient, ApimeUserClient, type Auth, type AuthKind, type CheckNumberResult, type ClientOptions, type ContactEntry, type CreateInstanceInput, EventLogEntry, type FailureInfo, type GroupInfo, type GroupParticipant, Instance, InstanceInfo, type InstanceTokenAuth, type IpFamily, type JoinRequestAction, type MarkReadInput, type Observer, type ParticipantAction, type PresenceState, Profile, QrCode, type QuoteInput, type RequestInfo, type RequestOptions, type SendAudioInput, type SendContactInput, type SendDocumentInput, type SendLocationInput, type SendMediaInput, type SendTextInput, SentMessage, type SuccessInfo, type UpdateInstanceInput, type User, type UserAuth, type UserJwtAuth, hasSentry };

package/dist/index.js

@@ -107,6 +107,18 @@ function errorFromResponse(status, body, headers) {
   }
 }
 
+// src/http/dispatcher.ts
+import { setDefaultResultOrder } from "dns";
+var applied;
+function preferIpFamily(family) {
+  if (applied !== void 0) return;
+  try {
+    setDefaultResultOrder(family === 4 ? "ipv4first" : "ipv6first");
+    applied = family;
+  } catch {
+  }
+}
+
 // src/http/url.ts
 var BLOCKED_HOSTS = /* @__PURE__ */ new Set(["169.254.169.254", "metadata.google.internal"]);
 function assertUsableBaseUrl(raw) {
@@ -168,6 +180,7 @@ var HttpClient = class {
     this.auth = options.auth;
     this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    if (options.ipFamily) preferIpFamily(options.ipFamily);
     this.fetchImpl = options.fetch ?? globalThis.fetch;
     this.userAgent = options.appName ? `open-apime-sdk (${options.appName})` : "open-apime-sdk";
     this.observer = options.observer;
@@ -676,6 +689,7 @@ function toHttpOptions(auth, options) {
     ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
     ...options.maxRetries !== void 0 ? { maxRetries: options.maxRetries } : {},
     ...options.fetch !== void 0 ? { fetch: options.fetch } : {},
+    ...options.ipFamily !== void 0 ? { ipFamily: options.ipFamily } : {},
     ...options.appName !== void 0 ? { appName: options.appName } : {},
     ...options.observer !== void 0 ? { observer: options.observer } : {},
     ...options.autoReport !== void 0 ? { autoReport: options.autoReport } : {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-apime/sdk",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Cliente TypeScript da API do apime: WhatsApp, instâncias e webhooks",
   "license": "MIT",
   "repository": {