@agentronics/sdk 0.7.0 → 0.7.1

package/dist/index.d.cts

@@ -42,8 +42,25 @@ interface GatewayExporterOptions {
     gatewayUrl: string;
     publishableKey: string;
     fetcher?: typeof fetch;
+    /** Send queued events this often (ms). Default 2000. */
+    flushMs?: number;
+    /** Events per request; the API accepts at most 100. Default 50. */
+    maxBatch?: number;
+    /** Events kept while the API is unreachable; the oldest are dropped first. Default 500. */
+    maxQueue?: number;
 }
-declare const createGatewayExporter: ({ gatewayUrl, publishableKey, fetcher, }: GatewayExporterOptions) => TraceExporter;
+interface GatewayExporter extends TraceExporter {
+    /** Send everything queued now (`keepalive` lets it outlive the page); settles when the requests do. */
+    flush(keepalive?: boolean): Promise<void>;
+}
+/**
+ * Sends traces to the Agentronics API from the browser. Events are queued and
+ * sent in batches — every couple of seconds, when a batch fills, and when the
+ * page is hidden or closed — rather than one request per event, so a busy page
+ * stays within the API's per-visitor rate limit. Never throws into the page:
+ * a failed send drops that batch.
+ */
+declare const createGatewayExporter: ({ gatewayUrl, publishableKey, fetcher, flushMs, maxBatch, maxQueue, }: GatewayExporterOptions) => GatewayExporter;
 
 interface WebhookExporterOptions {
     url: string;

package/dist/index.d.ts

@@ -42,8 +42,25 @@ interface GatewayExporterOptions {
     gatewayUrl: string;
     publishableKey: string;
     fetcher?: typeof fetch;
+    /** Send queued events this often (ms). Default 2000. */
+    flushMs?: number;
+    /** Events per request; the API accepts at most 100. Default 50. */
+    maxBatch?: number;
+    /** Events kept while the API is unreachable; the oldest are dropped first. Default 500. */
+    maxQueue?: number;
 }
-declare const createGatewayExporter: ({ gatewayUrl, publishableKey, fetcher, }: GatewayExporterOptions) => TraceExporter;
+interface GatewayExporter extends TraceExporter {
+    /** Send everything queued now (`keepalive` lets it outlive the page); settles when the requests do. */
+    flush(keepalive?: boolean): Promise<void>;
+}
+/**
+ * Sends traces to the Agentronics API from the browser. Events are queued and
+ * sent in batches — every couple of seconds, when a batch fills, and when the
+ * page is hidden or closed — rather than one request per event, so a busy page
+ * stays within the API's per-visitor rate limit. Never throws into the page:
+ * a failed send drops that batch.
+ */
+declare const createGatewayExporter: ({ gatewayUrl, publishableKey, fetcher, flushMs, maxBatch, maxQueue, }: GatewayExporterOptions) => GatewayExporter;
 
 interface WebhookExporterOptions {
     url: string;