@clientcasa/sdk 0.1.3 → 0.3.0

package/src/funcs/{calendar-events-list-calendar-events.ts → calendar-events-list.ts}

@@ -4,6 +4,7 @@
 
 import * as z from "zod/v4-mini";
 import { ClientCasaCore } from "../core.js";
+import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -20,31 +21,42 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/response-validation-error.js";
 import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
 import * as operations from "../models/operations/index.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
+import {
+  createPageIterator,
+  haltIterator,
+  PageIterator,
+  Paginator,
+} from "../types/operations.js";
 
 /**
  * List calendar events
  */
-export function calendarEventsListCalendarEvents(
+export function calendarEventsList(
   client: ClientCasaCore,
   security: operations.ListCalendarEventsSecurity,
   request?: operations.ListCalendarEventsRequest | undefined,
   options?: RequestOptions,
 ): APIPromise<
-  Result<
-    operations.ListCalendarEventsResponse,
-    | ClientCasaError
-    | ResponseValidationError
-    | ConnectionError
-    | RequestAbortedError
-    | RequestTimeoutError
-    | InvalidRequestError
-    | UnexpectedClientError
-    | SDKValidationError
+  PageIterator<
+    Result<
+      operations.ListCalendarEventsResponse,
+      | errors.ApiError
+      | ClientCasaError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    { page: number }
   >
 > {
   return new APIPromise($do(
@@ -62,16 +74,20 @@ async function $do(
   options?: RequestOptions,
 ): Promise<
   [
-    Result<
-      operations.ListCalendarEventsResponse,
-      | ClientCasaError
-      | ResponseValidationError
-      | ConnectionError
-      | RequestAbortedError
-      | RequestTimeoutError
-      | InvalidRequestError
-      | UnexpectedClientError
-      | SDKValidationError
+    PageIterator<
+      Result<
+        operations.ListCalendarEventsResponse,
+        | errors.ApiError
+        | ClientCasaError
+        | ResponseValidationError
+        | ConnectionError
+        | RequestAbortedError
+        | RequestTimeoutError
+        | InvalidRequestError
+        | UnexpectedClientError
+        | SDKValidationError
+      >,
+      { page: number }
     >,
     APICall,
   ]
@@ -86,7 +102,7 @@ async function $do(
     "Input validation failed",
   );
   if (!parsed.ok) {
-    return [parsed, { status: "invalid" }];
+    return [haltIterator(parsed), { status: "invalid" }];
   }
   const payload = parsed.value;
   const body = null;
@@ -134,8 +150,18 @@ async function $do(
     securitySource: security,
     retryConfig: options?.retries
       || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 30000,
+          exponent: 1.5,
+          maxElapsedTime: 30000,
+        },
+        retryConnectionErrors: true,
+      }
       || { strategy: "none" },
-    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+    retryCodes: options?.retryCodes || ["429", "5XX"],
   };
 
   const requestRes = client._createRequest(context, {
@@ -150,7 +176,7 @@ async function $do(
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
   }, options);
   if (!requestRes.ok) {
-    return [requestRes, { status: "invalid" }];
+    return [haltIterator(requestRes), { status: "invalid" }];
   }
   const req = requestRes.value;
 
@@ -162,12 +188,17 @@ async function $do(
     retryCodes: context.retryCodes,
   });
   if (!doResult.ok) {
-    return [doResult, { status: "request-error", request: req }];
+    return [haltIterator(doResult), { status: "request-error", request: req }];
   }
   const response = doResult.value;
 
-  const [result] = await M.match<
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result, raw] = await M.match<
     operations.ListCalendarEventsResponse,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -177,13 +208,74 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, operations.ListCalendarEventsResponse$inboundSchema),
+    M.json(200, operations.ListCalendarEventsResponse$inboundSchema, {
+      key: "Result",
+    }),
+    M.jsonErr([400, 401, 403, 429], errors.ApiError$inboundSchema),
+    M.jsonErr(500, errors.ApiError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
-    return [result, { status: "complete", request: req, response }];
+    return [haltIterator(result), {
+      status: "complete",
+      request: req,
+      response,
+    }];
   }
 
-  return [result, { status: "complete", request: req, response }];
+  const nextFunc = (
+    responseData: unknown,
+  ): {
+    next: Paginator<
+      Result<
+        operations.ListCalendarEventsResponse,
+        | errors.ApiError
+        | ClientCasaError
+        | ResponseValidationError
+        | ConnectionError
+        | RequestAbortedError
+        | RequestTimeoutError
+        | InvalidRequestError
+        | UnexpectedClientError
+        | SDKValidationError
+      >
+    >;
+    "~next"?: { page: number };
+  } => {
+    const page = request?.page ?? 1;
+    const nextPage = page + 1;
+
+    if (!responseData) {
+      return { next: () => null };
+    }
+    const results = dlv(responseData, "data");
+    if (!Array.isArray(results) || !results.length) {
+      return { next: () => null };
+    }
+    const limit = request?.pageSize ?? 25;
+    if (results.length < limit) {
+      return { next: () => null };
+    }
+
+    const nextVal = () =>
+      calendarEventsList(
+        client,
+        security,
+        {
+          ...request!,
+          page: nextPage,
+        },
+        options,
+      );
+
+    return { next: nextVal, "~next": { page: nextPage } };
+  };
+
+  const page = { ...result, ...nextFunc(raw) };
+  return [{ ...page, ...createPageIterator(page, (v) => !v.ok) }, {
+    status: "complete",
+    request: req,
+    response,
+  }];
 }

package/src/funcs/{calendar-events-update-calendar-event.ts → calendar-events-update.ts}

@@ -20,6 +20,7 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/response-validation-error.js";
 import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
 import * as models from "../models/index.js";
@@ -33,7 +34,7 @@ import { Result } from "../types/fp.js";
  * @remarks
  * Externally-sourced events (google/microsoft/apple) are read-only.
  */
-export function calendarEventsUpdateCalendarEvent(
+export function calendarEventsUpdate(
   client: ClientCasaCore,
   security: operations.UpdateCalendarEventSecurity,
   request: operations.UpdateCalendarEventRequest,
@@ -41,6 +42,7 @@ export function calendarEventsUpdateCalendarEvent(
 ): APIPromise<
   Result<
     models.CalendarEvent,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -68,6 +70,7 @@ async function $do(
   [
     Result<
       models.CalendarEvent,
+      | errors.ApiError
       | ClientCasaError
       | ResponseValidationError
       | ConnectionError
@@ -133,8 +136,18 @@ async function $do(
     securitySource: security,
     retryConfig: options?.retries
       || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 30000,
+          exponent: 1.5,
+          maxElapsedTime: 30000,
+        },
+        retryConnectionErrors: true,
+      }
       || { strategy: "none" },
-    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+    retryCodes: options?.retryCodes || ["429", "5XX"],
   };
 
   const requestRes = client._createRequest(context, {
@@ -164,8 +177,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     models.CalendarEvent,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -176,9 +194,11 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.CalendarEvent$inboundSchema),
+    M.jsonErr([400, 401, 403, 404, 429], errors.ApiError$inboundSchema),
+    M.jsonErr(500, errors.ApiError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }

package/src/funcs/{catalog-items-create-catalog-item.ts → catalog-items-create.ts}

@@ -4,7 +4,7 @@
 
 import * as z from "zod/v4-mini";
 import { ClientCasaCore } from "../core.js";
-import { encodeJSON } from "../lib/encodings.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
@@ -20,6 +20,7 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/response-validation-error.js";
 import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
 import * as models from "../models/index.js";
@@ -33,14 +34,15 @@ import { Result } from "../types/fp.js";
  * @remarks
  * `type: expense` items track cost; `type: charge` items track revenue.
  */
-export function catalogItemsCreateCatalogItem(
+export function catalogItemsCreate(
   client: ClientCasaCore,
   security: operations.CreateCatalogItemSecurity,
-  request: models.CatalogItemCreate,
+  request: operations.CreateCatalogItemRequest,
   options?: RequestOptions,
 ): APIPromise<
   Result<
     models.CatalogItem,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -62,12 +64,13 @@ export function catalogItemsCreateCatalogItem(
 async function $do(
   client: ClientCasaCore,
   security: operations.CreateCatalogItemSecurity,
-  request: models.CatalogItemCreate,
+  request: operations.CreateCatalogItemRequest,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
       models.CatalogItem,
+      | errors.ApiError
       | ClientCasaError
       | ResponseValidationError
       | ConnectionError
@@ -82,20 +85,26 @@ async function $do(
 > {
   const parsed = safeParse(
     request,
-    (value) => z.parse(models.CatalogItemCreate$outboundSchema, value),
+    (value) =>
+      z.parse(operations.CreateCatalogItemRequest$outboundSchema, value),
     "Input validation failed",
   );
   if (!parsed.ok) {
     return [parsed, { status: "invalid" }];
   }
   const payload = parsed.value;
-  const body = encodeJSON("body", payload, { explode: true });
+  const body = encodeJSON("body", payload.body, { explode: true });
 
   const path = pathToFunc("/api/v1/catalog-items")();
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
     Accept: "application/json",
+    "Idempotency-Key": encodeSimple(
+      "Idempotency-Key",
+      payload["Idempotency-Key"],
+      { explode: false, charEncoding: "none" },
+    ),
   }));
 
   const requestSecurity = resolveSecurity(
@@ -157,8 +166,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     models.CatalogItem,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -169,9 +183,11 @@ async function $do(
     | SDKValidationError
   >(
     M.json(201, models.CatalogItem$inboundSchema),
+    M.jsonErr([400, 401, 403, 409, 429], errors.ApiError$inboundSchema),
+    M.jsonErr(500, errors.ApiError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }

package/src/funcs/{catalog-items-delete-catalog-item.ts → catalog-items-delete.ts}

@@ -20,6 +20,7 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/response-validation-error.js";
 import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
 import * as operations from "../models/operations/index.js";
@@ -29,7 +30,7 @@ import { Result } from "../types/fp.js";
 /**
  * Delete a catalog item
  */
-export function catalogItemsDeleteCatalogItem(
+export function catalogItemsDelete(
   client: ClientCasaCore,
   security: operations.DeleteCatalogItemSecurity,
   request: operations.DeleteCatalogItemRequest,
@@ -37,6 +38,7 @@ export function catalogItemsDeleteCatalogItem(
 ): APIPromise<
   Result<
     void,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -64,6 +66,7 @@ async function $do(
   [
     Result<
       void,
+      | errors.ApiError
       | ClientCasaError
       | ResponseValidationError
       | ConnectionError
@@ -97,7 +100,7 @@ async function $do(
   const path = pathToFunc("/api/v1/catalog-items/{id}")(pathParams);
 
   const headers = new Headers(compactMap({
-    Accept: "*/*",
+    Accept: "application/json",
   }));
 
   const requestSecurity = resolveSecurity(
@@ -128,8 +131,18 @@ async function $do(
     securitySource: security,
     retryConfig: options?.retries
       || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 30000,
+          exponent: 1.5,
+          maxElapsedTime: 30000,
+        },
+        retryConnectionErrors: true,
+      }
       || { strategy: "none" },
-    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+    retryCodes: options?.retryCodes || ["429", "5XX"],
   };
 
   const requestRes = client._createRequest(context, {
@@ -159,8 +172,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     void,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -171,9 +189,11 @@ async function $do(
     | SDKValidationError
   >(
     M.nil(204, z.void()),
+    M.jsonErr([401, 403, 404, 429], errors.ApiError$inboundSchema),
+    M.jsonErr(500, errors.ApiError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }

package/src/funcs/{catalog-items-get-catalog-item.ts → catalog-items-get.ts}

@@ -20,6 +20,7 @@ import {
   RequestTimeoutError,
   UnexpectedClientError,
 } from "../models/errors/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/response-validation-error.js";
 import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
 import * as models from "../models/index.js";
@@ -30,7 +31,7 @@ import { Result } from "../types/fp.js";
 /**
  * Get a catalog item
  */
-export function catalogItemsGetCatalogItem(
+export function catalogItemsGet(
   client: ClientCasaCore,
   security: operations.GetCatalogItemSecurity,
   request: operations.GetCatalogItemRequest,
@@ -38,6 +39,7 @@ export function catalogItemsGetCatalogItem(
 ): APIPromise<
   Result<
     models.CatalogItem,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -65,6 +67,7 @@ async function $do(
   [
     Result<
       models.CatalogItem,
+      | errors.ApiError
       | ClientCasaError
       | ResponseValidationError
       | ConnectionError
@@ -128,8 +131,18 @@ async function $do(
     securitySource: security,
     retryConfig: options?.retries
       || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 30000,
+          exponent: 1.5,
+          maxElapsedTime: 30000,
+        },
+        retryConnectionErrors: true,
+      }
       || { strategy: "none" },
-    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+    retryCodes: options?.retryCodes || ["429", "5XX"],
   };
 
   const requestRes = client._createRequest(context, {
@@ -159,8 +172,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     models.CatalogItem,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -171,9 +189,11 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.CatalogItem$inboundSchema),
+    M.jsonErr([401, 403, 404, 429], errors.ApiError$inboundSchema),
+    M.jsonErr(500, errors.ApiError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
-  )(response, req);
+  )(response, req, { extraFields: responseFields });
   if (!result.ok) {
     return [result, { status: "complete", request: req, response }];
   }