@smplkit/sdk 3.0.11 → 3.0.13

package/dist/index.d.cts

@@ -48,26 +48,29 @@ interface ListEventsPage {
 }
 
 /**
- * Audit namespace — `client.audit.events.{create,list,get}`.
+ * Audit namespace — `client.audit.events.{record,list,get}`.
  *
- * ADR-047 §2.6. Writes are fire-and-forget by default: `create` enqueues the
+ * ADR-047 §2.6. Writes are fire-and-forget by default: `record` enqueues the
  * event onto an in-memory bounded buffer and returns immediately. The buffer
  * worker flushes on a timer or when depth crosses a watermark, and retries
  * transient failures with exponential backoff. Reads are async and return
  * Promises that resolve to typed `AuditEvent` instances.
+ *
+ * All HTTP work is delegated to the auto-generated openapi-fetch client
+ * over `../generated/audit.d.ts` — the wrapper does not issue raw fetch
+ * calls.
  */
 
+type AuditHttp = ReturnType<typeof createClient<paths>>;
 declare class EventsClient {
-    private readonly _apiKey;
-    private readonly _baseUrl;
-    private readonly _timeoutMs;
-    private readonly _buffer;
     /** @internal */
-    _fetch: typeof fetch;
+    readonly _http: AuditHttp;
+    private readonly _buffer;
     constructor(opts: {
         apiKey: string;
         baseUrl: string;
         timeoutMs?: number;
+        fetch?: typeof fetch;
     });
     /**
      * Enqueue an audit event for asynchronous delivery.
@@ -77,7 +80,7 @@ declare class EventsClient {
      * reject those with a 403 (the buffer logs and drops permanent
      * failures, so a misuse will silently disappear from the queue).
      */
-    create(input: CreateEventInput): void;
+    record(input: CreateEventInput): void;
     list(params?: ListEventsParams): Promise<ListEventsPage>;
     get(eventId: string): Promise<AuditEvent>;
     /** Block until the in-memory buffer is drained or `timeoutMs` elapses. */
@@ -91,6 +94,7 @@ declare class AuditClient {
         apiKey: string;
         baseUrl: string;
         timeoutMs?: number;
+        fetch?: typeof fetch;
     });
     /** @internal */
     _close(): Promise<void>;

package/dist/index.d.ts

@@ -48,26 +48,29 @@ interface ListEventsPage {
 }
 
 /**
- * Audit namespace — `client.audit.events.{create,list,get}`.
+ * Audit namespace — `client.audit.events.{record,list,get}`.
  *
- * ADR-047 §2.6. Writes are fire-and-forget by default: `create` enqueues the
+ * ADR-047 §2.6. Writes are fire-and-forget by default: `record` enqueues the
  * event onto an in-memory bounded buffer and returns immediately. The buffer
  * worker flushes on a timer or when depth crosses a watermark, and retries
  * transient failures with exponential backoff. Reads are async and return
  * Promises that resolve to typed `AuditEvent` instances.
+ *
+ * All HTTP work is delegated to the auto-generated openapi-fetch client
+ * over `../generated/audit.d.ts` — the wrapper does not issue raw fetch
+ * calls.
  */
 
+type AuditHttp = ReturnType<typeof createClient<paths>>;
 declare class EventsClient {
-    private readonly _apiKey;
-    private readonly _baseUrl;
-    private readonly _timeoutMs;
-    private readonly _buffer;
     /** @internal */
-    _fetch: typeof fetch;
+    readonly _http: AuditHttp;
+    private readonly _buffer;
     constructor(opts: {
         apiKey: string;
         baseUrl: string;
         timeoutMs?: number;
+        fetch?: typeof fetch;
     });
     /**
      * Enqueue an audit event for asynchronous delivery.
@@ -77,7 +80,7 @@ declare class EventsClient {
      * reject those with a 403 (the buffer logs and drops permanent
      * failures, so a misuse will silently disappear from the queue).
      */
-    create(input: CreateEventInput): void;
+    record(input: CreateEventInput): void;
     list(params?: ListEventsParams): Promise<ListEventsPage>;
     get(eventId: string): Promise<AuditEvent>;
     /** Block until the in-memory buffer is drained or `timeoutMs` elapses. */
@@ -91,6 +94,7 @@ declare class AuditClient {
         apiKey: string;
         baseUrl: string;
         timeoutMs?: number;
+        fetch?: typeof fetch;
     });
     /** @internal */
     _close(): Promise<void>;

package/dist/index.js

@@ -16614,7 +16614,10 @@ var require_pino = __commonJS({
 });
 
 // src/client.ts
-import createClient5 from "openapi-fetch";
+import createClient6 from "openapi-fetch";
+
+// src/audit/client.ts
+import createClient from "openapi-fetch";
 
 // src/audit/buffer.ts
 var MAX_BUFFER_SIZE = 1e3;
@@ -16659,10 +16662,10 @@ var AuditEventBuffer = class {
       void this._drainOnce();
     }
   }
-  /** Block (cooperatively) until the buffer is empty or `timeoutMs` elapses. */
+  /** Block (cooperatively) until the buffer is idle or `timeoutMs` elapses. */
   async flush(timeoutMs = 5e3) {
     const deadline = Date.now() + timeoutMs;
-    while (this._queue.length > 0) {
+    while (this._queue.length > 0 || this._draining) {
       if (Date.now() >= deadline) {
         console.warn(`[smplkit.audit] flush timed out after ${timeoutMs}ms`);
         return;
@@ -16726,10 +16729,7 @@ var AuditEventBuffer = class {
 };
 
 // src/audit/client.ts
-var JSONAPI_HEADERS = {
-  "Content-Type": "application/vnd.api+json",
-  Accept: "application/vnd.api+json"
-};
+var JSONAPI_CONTENT_TYPE = "application/vnd.api+json";
 function _attributesFromInput(input) {
   const attrs = {
     action: input.action,
@@ -16762,37 +16762,33 @@ function _eventFromResource(resource) {
   };
 }
 var EventsClient = class {
-  _apiKey;
-  _baseUrl;
-  _timeoutMs;
-  _buffer;
   /** @internal */
-  _fetch = fetch;
+  _http;
+  _buffer;
   constructor(opts) {
-    this._apiKey = opts.apiKey;
-    this._baseUrl = opts.baseUrl.replace(/\/$/, "");
-    this._timeoutMs = opts.timeoutMs ?? 1e4;
+    const baseUrl = opts.baseUrl.replace(/\/$/, "");
+    this._http = createClient({
+      baseUrl,
+      fetch: opts.fetch,
+      headers: {
+        Authorization: `Bearer ${opts.apiKey}`,
+        Accept: JSONAPI_CONTENT_TYPE,
+        "Content-Type": JSONAPI_CONTENT_TYPE
+      }
+    });
     this._buffer = new AuditEventBuffer({
       post: async (item) => {
         try {
-          const headers = {
-            ...JSONAPI_HEADERS,
-            Authorization: `Bearer ${this._apiKey}`
-          };
-          if (item.idempotencyKey !== null) headers["Idempotency-Key"] = item.idempotencyKey;
-          const ctrl = new AbortController();
-          const t = setTimeout(() => ctrl.abort(), this._timeoutMs);
-          try {
-            const resp = await this._fetch(`${this._baseUrl}/api/v1/events`, {
-              method: "POST",
-              headers,
-              body: JSON.stringify(item.body),
-              signal: ctrl.signal
-            });
-            return { status: resp.status };
-          } finally {
-            clearTimeout(t);
-          }
+          const headerInit = {};
+          if (item.idempotencyKey !== null) headerInit["Idempotency-Key"] = item.idempotencyKey;
+          const result = await this._http.POST("/api/v1/events", {
+            // Casting through unknown because the generated body type is
+            // EventResponse with id required, while the wrapper builds an
+            // unsaved-resource body without an id (server assigns).
+            body: item.body,
+            headers: headerInit
+          });
+          return { status: result.response.status };
         } catch {
           return { status: 0 };
         }
@@ -16807,32 +16803,33 @@ var EventsClient = class {
    * reject those with a 403 (the buffer logs and drops permanent
    * failures, so a misuse will silently disappear from the queue).
    */
-  create(input) {
+  record(input) {
     const body = {
-      data: { type: "event", attributes: _attributesFromInput(input) }
+      data: { id: "", type: "event", attributes: _attributesFromInput(input) }
     };
     this._buffer.enqueue(body, input.idempotencyKey ?? null);
   }
   async list(params = {}) {
-    const qs = new URLSearchParams();
-    if (params.action !== void 0) qs.set("filter[action]", params.action);
-    if (params.resourceType !== void 0) qs.set("filter[resource_type]", params.resourceType);
-    if (params.resourceId !== void 0) qs.set("filter[resource_id]", params.resourceId);
-    if (params.actorType !== void 0) qs.set("filter[actor_type]", params.actorType);
-    if (params.actorId !== void 0) qs.set("filter[actor_id]", params.actorId);
-    if (params.occurredAtRange !== void 0) qs.set("filter[occurred_at]", params.occurredAtRange);
-    if (params.pageSize !== void 0) qs.set("page[size]", String(params.pageSize));
-    if (params.pageAfter !== void 0) qs.set("page[after]", params.pageAfter);
-    const resp = await this._fetch(`${this._baseUrl}/api/v1/events?${qs.toString()}`, {
-      headers: {
-        Authorization: `Bearer ${this._apiKey}`,
-        Accept: "application/vnd.api+json"
-      }
+    const query = {};
+    if (params.action !== void 0) query["filter[action]"] = params.action;
+    if (params.resourceType !== void 0) query["filter[resource_type]"] = params.resourceType;
+    if (params.resourceId !== void 0) query["filter[resource_id]"] = params.resourceId;
+    if (params.actorType !== void 0) query["filter[actor_type]"] = params.actorType;
+    if (params.actorId !== void 0) query["filter[actor_id]"] = params.actorId;
+    if (params.occurredAtRange !== void 0) query["filter[occurred_at]"] = params.occurredAtRange;
+    if (params.pageSize !== void 0) query["page[size]"] = params.pageSize;
+    if (params.pageAfter !== void 0) query["page[after]"] = params.pageAfter;
+    const result = await this._http.GET("/api/v1/events", {
+      // openapi-fetch's typed query map is constrained by the spec's
+      // exact param names (filteraction etc.); the JSON:API filter[*]
+      // / page[*] format isn't expressible in that shape, so we cast
+      // and let openapi-fetch URL-encode the literal keys.
+      params: { query }
     });
-    if (!resp.ok) {
-      throw new Error(`audit list failed: ${resp.status} ${resp.statusText}`);
+    if (!result.response.ok || result.data === void 0) {
+      throw new Error(`audit list failed: ${result.response.status} ${result.response.statusText}`);
     }
-    const body = await resp.json();
+    const body = result.data;
     const events = (body.data ?? []).map(_eventFromResource);
     let nextCursor = null;
     const nextLink = body.links?.next;
@@ -16842,17 +16839,13 @@ var EventsClient = class {
     return { events, nextCursor };
   }
   async get(eventId) {
-    const resp = await this._fetch(`${this._baseUrl}/api/v1/events/${eventId}`, {
-      headers: {
-        Authorization: `Bearer ${this._apiKey}`,
-        Accept: "application/vnd.api+json"
-      }
+    const result = await this._http.GET("/api/v1/events/{event_id}", {
+      params: { path: { event_id: eventId } }
     });
-    if (!resp.ok) {
-      throw new Error(`audit get failed: ${resp.status} ${resp.statusText}`);
+    if (!result.response.ok || result.data === void 0) {
+      throw new Error(`audit get failed: ${result.response.status} ${result.response.statusText}`);
     }
-    const body = await resp.json();
-    return _eventFromResource(body.data);
+    return _eventFromResource(result.data.data);
   }
   /** Block until the in-memory buffer is drained or `timeoutMs` elapses. */
   async flush(timeoutMs = 5e3) {
@@ -16875,7 +16868,7 @@ var AuditClient = class {
 };
 
 // src/config/client.ts
-import createClient from "openapi-fetch";
+import createClient2 from "openapi-fetch";
 
 // src/errors.ts
 var SmplError = class extends Error {
@@ -17542,7 +17535,7 @@ var ConfigClient = class {
     const resolvedBaseUrl = baseUrl ?? BASE_URL;
     this._baseUrl = resolvedBaseUrl;
     const ms = timeout ?? 3e4;
-    this._http = createClient({
+    this._http = createClient2({
       baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
@@ -17833,7 +17826,7 @@ var ConfigClient = class {
 };
 
 // src/flags/client.ts
-import createClient3 from "openapi-fetch";
+import createClient4 from "openapi-fetch";
 
 // src/flags/models.ts
 var FlagValue = class {
@@ -18163,7 +18156,7 @@ var JsonFlag = class extends Flag {
 import jsonLogic from "json-logic-js";
 
 // src/management/client.ts
-import createClient2 from "openapi-fetch";
+import createClient3 from "openapi-fetch";
 
 // src/management/types.ts
 var EnvironmentClassification = /* @__PURE__ */ ((EnvironmentClassification3) => {
@@ -20369,19 +20362,19 @@ var SmplManagementClient = class {
       Authorization: `Bearer ${cfg.apiKey}`,
       Accept: "application/json"
     };
-    this._appHttpRef = createClient2({
+    this._appHttpRef = createClient3({
       baseUrl: appBaseUrl,
       headers
     });
-    this._configHttpRef = createClient2({
+    this._configHttpRef = createClient3({
       baseUrl: configBaseUrl,
       headers
     });
-    this._flagsHttpRef = createClient2({
+    this._flagsHttpRef = createClient3({
       baseUrl: flagsBaseUrl,
       headers
     });
-    this._loggingHttpRef = createClient2({
+    this._loggingHttpRef = createClient3({
       baseUrl: loggingBaseUrl,
       headers
     });
@@ -20610,7 +20603,7 @@ var FlagsClient = class {
         clearTimeout(timer);
       }
     };
-    this._http = createClient3({
+    this._http = createClient4({
       baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
@@ -20618,7 +20611,7 @@ var FlagsClient = class {
       },
       fetch: fetchWithTimeout
     });
-    this._appHttp = createClient3({
+    this._appHttp = createClient4({
       baseUrl: resolvedAppBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
@@ -21172,7 +21165,7 @@ var FlagsClient = class {
 };
 
 // src/logging/client.ts
-import createClient4 from "openapi-fetch";
+import createClient5 from "openapi-fetch";
 var LOGGING_BASE_URL = "https://logging.smplkit.com";
 var LoggerRegistrationBuffer2 = class {
   _seen = /* @__PURE__ */ new Set();
@@ -21226,7 +21219,7 @@ var LoggingClient = class {
     const resolvedBaseUrl = baseUrl ?? LOGGING_BASE_URL;
     this._baseUrl = resolvedBaseUrl;
     const ms = timeout ?? 3e4;
-    this._http = createClient4({
+    this._http = createClient5({
       baseUrl: resolvedBaseUrl,
       headers: {
         Authorization: `Bearer ${apiKey}`,
@@ -22189,7 +22182,7 @@ var SmplClient = class {
       "lifecycle",
       `SmplClient created (api_key=${maskedKey}, environment=${cfg.environment}, service=${cfg.service})`
     );
-    this._appHttp = createClient5({
+    this._appHttp = createClient6({
       baseUrl: appBaseUrl,
       headers: {
         Authorization: `Bearer ${cfg.apiKey}`,