@izak0s/spacebring-api 1.0.0 → 1.1.0

package/README.md

@@ -46,26 +46,38 @@ const sb = new Spacebring({
   // fetch: customFetch,                     // inject your own fetch (tests, proxies)
 });
 
-// Single-property envelopes are unwrapped: entities and plain arrays come back directly
-const invoice = await sb.billing.invoices.get(invoiceId);
-const locations = await sb.locations.list();
-await sb.visitors.visits.checkIn({ locationRef, visitRef });
-
-// Paginated lists return the page envelope, so nextPageToken stays available
-const { benefits, nextPageToken } = await sb.benefits.list({ locationRef });
+async function main() {
+  // Single-property envelopes are unwrapped: entities and plain arrays come back directly
+  const invoice = await sb.billing.invoices.get(invoiceId);
+  const locations = await sb.locations.list();
+  await sb.visitors.visits.checkIn({ locationRef, visitRef });
+
+  // Paginated lists return the page envelope, so nextPageToken stays available
+  const { benefits, nextPageToken } = await sb.benefits.list({ locationRef });
+
+  // ...or let iterate() walk nextPageToken for you; breaking early stops fetching
+  for await (const booking of sb.resources.bookings.iterate({ locationRef })) {
+    console.log(booking.id);
+  }
 
-// ...or let iterate() walk nextPageToken for you; breaking early stops fetching
-for await (const booking of sb.resources.bookings.iterate({ locationRef })) {
-  console.log(booking.id);
+  // Endpoints returning multiple payloads keep the envelope
+  const { invoice: paid, payment } = await sb.billing.invoices.pay(invoiceId, {
+    paymentMethod: { type: "stripe" },
+  });
 }
 
-// Endpoints returning multiple payloads keep the envelope
-const { invoice: paid, payment } = await sb.billing.invoices.pay(invoiceId, {
-  paymentMethod: { type: "stripe" },
-});
+main().catch(console.error);
 ```
 
-TypeScript helpers are exported too: `SpacebringConfig`, `SpacebringResources`, and the raw spec types `paths` / `components` / `operations` (e.g. `components["schemas"]["invoice"]`).
+Entity types are exported by name — `import type { Booking, Invoice, Membership } from "@izak0s/spacebring-api"` — matching what the methods return (`get`/`create`/`update` resolve to the entity, `iterate()` yields it). Lower-level helpers too: `SpacebringConfig`, `SpacebringResources`, and the raw spec types `paths` / `components` / `operations`.
+
+### Data formats
+
+Values are passed through exactly as the API sends them — no runtime conversion:
+
+- **Dates** (`createDate`, `startDate`, …) are ISO 8601 strings — wrap in `new Date(booking.startDate)` when you need a `Date`.
+- **Money** (`amount`, `price`, …) arrives as decimal floats. Fine for display; for accounting arithmetic convert to integer cents first to avoid floating-point drift.
+- **IDs** (`id`, `*Ref`) are UUID strings.
 
 ---
 

package/dist/index.cjs

@@ -40,13 +40,14 @@ function createClient(clientOptions) {
     fetch: baseFetch = globalThis.fetch,
     querySerializer: globalQuerySerializer,
     bodySerializer: globalBodySerializer,
+    pathSerializer: globalPathSerializer,
     headers: baseHeaders,
     requestInitExt = void 0,
     ...baseOptions
   } = { ...clientOptions };
   requestInitExt = supportsRequestInitExt() ? requestInitExt : void 0;
   baseUrl = removeTrailingSlash(baseUrl);
-  const middlewares = [];
+  const globalMiddlewares = [];
   async function coreFetch(schemaPath, fetchOptions) {
     const {
       baseUrl: localBaseUrl,
@@ -57,7 +58,9 @@ function createClient(clientOptions) {
       parseAs = "json",
       querySerializer: requestQuerySerializer,
       bodySerializer = globalBodySerializer ?? defaultBodySerializer,
+      pathSerializer: requestPathSerializer,
       body,
+      middleware: requestMiddlewares = [],
       ...init
     } = fetchOptions || {};
     let finalBaseUrl = baseUrl;
@@ -71,6 +74,7 @@ function createClient(clientOptions) {
         ...requestQuerySerializer
       });
     }
+    const pathSerializer = requestPathSerializer || globalPathSerializer || defaultPathSerializer;
     const serializedBody = body === void 0 ? void 0 : bodySerializer(
       body,
       // Note: we declare mergeHeaders() both here and below because it’s a bit of a chicken-or-egg situation:
@@ -90,6 +94,7 @@ function createClient(clientOptions) {
       headers,
       params.header
     );
+    const finalMiddlewares = [...globalMiddlewares, ...requestMiddlewares];
     const requestInit = {
       redirect: "follow",
       ...baseOptions,
@@ -100,7 +105,7 @@ function createClient(clientOptions) {
     let id;
     let options;
     let request = new Request(
-      createFinalURL(schemaPath, { baseUrl: finalBaseUrl, params, querySerializer }),
+      createFinalURL(schemaPath, { baseUrl: finalBaseUrl, params, querySerializer, pathSerializer }),
       requestInit
     );
     let response;
@@ -109,16 +114,17 @@ function createClient(clientOptions) {
         request[key] = init[key];
       }
     }
-    if (middlewares.length) {
+    if (finalMiddlewares.length) {
       id = randomID();
       options = Object.freeze({
         baseUrl: finalBaseUrl,
         fetch,
         parseAs,
         querySerializer,
-        bodySerializer
+        bodySerializer,
+        pathSerializer
       });
-      for (const m of middlewares) {
+      for (const m of finalMiddlewares) {
         if (m && typeof m === "object" && typeof m.onRequest === "function") {
           const result = await m.onRequest({
             request,
@@ -145,9 +151,9 @@ function createClient(clientOptions) {
         response = await fetch(request, requestInitExt);
       } catch (error2) {
         let errorAfterMiddleware = error2;
-        if (middlewares.length) {
-          for (let i = middlewares.length - 1; i >= 0; i--) {
-            const m = middlewares[i];
+        if (finalMiddlewares.length) {
+          for (let i = finalMiddlewares.length - 1; i >= 0; i--) {
+            const m = finalMiddlewares[i];
             if (m && typeof m === "object" && typeof m.onError === "function") {
               const result = await m.onError({
                 request,
@@ -176,9 +182,9 @@ function createClient(clientOptions) {
           throw errorAfterMiddleware;
         }
       }
-      if (middlewares.length) {
-        for (let i = middlewares.length - 1; i >= 0; i--) {
-          const m = middlewares[i];
+      if (finalMiddlewares.length) {
+        for (let i = finalMiddlewares.length - 1; i >= 0; i--) {
+          const m = finalMiddlewares[i];
           if (m && typeof m === "object" && typeof m.onResponse === "function") {
             const result = await m.onResponse({
               request,
@@ -198,14 +204,22 @@ function createClient(clientOptions) {
         }
       }
     }
-    if (response.status === 204 || request.method === "HEAD" || response.headers.get("Content-Length") === "0") {
+    const contentLength = response.headers.get("Content-Length");
+    if (response.status === 204 || request.method === "HEAD" || contentLength === "0" && !response.headers.get("Transfer-Encoding")?.includes("chunked")) {
       return response.ok ? { data: void 0, response } : { error: void 0, response };
     }
     if (response.ok) {
-      if (parseAs === "stream") {
-        return { data: response.body, response };
-      }
-      return { data: await response[parseAs](), response };
+      const getResponseData = async () => {
+        if (parseAs === "stream") {
+          return response.body;
+        }
+        if (parseAs === "json" && !contentLength) {
+          const raw = await response.text();
+          return raw ? JSON.parse(raw) : void 0;
+        }
+        return await response[parseAs]();
+      };
+      return { data: await getResponseData(), response };
     }
     let error = await response.text();
     try {
@@ -259,15 +273,15 @@ function createClient(clientOptions) {
         if (typeof m !== "object" || !("onRequest" in m || "onResponse" in m || "onError" in m)) {
           throw new Error("Middleware must be an object with one of `onRequest()`, `onResponse() or `onError()`");
         }
-        middlewares.push(m);
+        globalMiddlewares.push(m);
       }
     },
     /** Unregister middleware */
     eject(...middleware) {
       for (const m of middleware) {
-        const i = middlewares.indexOf(m);
+        const i = globalMiddlewares.indexOf(m);
         if (i !== -1) {
-          middlewares.splice(i, 1);
+          globalMiddlewares.splice(i, 1);
         }
       }
     }
@@ -448,7 +462,7 @@ function defaultBodySerializer(body, headers) {
 function createFinalURL(pathname, options) {
   let finalURL = `${options.baseUrl}${pathname}`;
   if (options.params?.path) {
-    finalURL = defaultPathSerializer(finalURL, options.params.path);
+    finalURL = options.pathSerializer(finalURL, options.params.path);
   }
   let search = options.querySerializer(options.params.query ?? {});
   if (search.startsWith("?")) {