@clientcasa/sdk 0.1.2 → 0.3.0

package/src/funcs/{milestones-list-milestones.ts → milestones-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 milestones
  */
-export function milestonesListMilestones(
+export function milestonesList(
   client: ClientCasaCore,
   security: operations.ListMilestonesSecurity,
   request?: operations.ListMilestonesRequest | undefined,
   options?: RequestOptions,
 ): APIPromise<
-  Result<
-    operations.ListMilestonesResponse,
-    | ClientCasaError
-    | ResponseValidationError
-    | ConnectionError
-    | RequestAbortedError
-    | RequestTimeoutError
-    | InvalidRequestError
-    | UnexpectedClientError
-    | SDKValidationError
+  PageIterator<
+    Result<
+      operations.ListMilestonesResponse,
+      | 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.ListMilestonesResponse,
-      | ClientCasaError
-      | ResponseValidationError
-      | ConnectionError
-      | RequestAbortedError
-      | RequestTimeoutError
-      | InvalidRequestError
-      | UnexpectedClientError
-      | SDKValidationError
+    PageIterator<
+      Result<
+        operations.ListMilestonesResponse,
+        | 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;
@@ -133,8 +149,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, {
@@ -149,7 +175,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;
 
@@ -161,12 +187,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.ListMilestonesResponse,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -176,13 +207,74 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, operations.ListMilestonesResponse$inboundSchema),
+    M.json(200, operations.ListMilestonesResponse$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.ListMilestonesResponse,
+        | 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 = () =>
+      milestonesList(
+        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/{milestones-update-milestone.ts → milestones-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";
@@ -30,7 +31,7 @@ import { Result } from "../types/fp.js";
 /**
  * Update a milestone
  */
-export function milestonesUpdateMilestone(
+export function milestonesUpdate(
   client: ClientCasaCore,
   security: operations.UpdateMilestoneSecurity,
   request: operations.UpdateMilestoneRequest,
@@ -38,6 +39,7 @@ export function milestonesUpdateMilestone(
 ): APIPromise<
   Result<
     models.Milestone,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -65,6 +67,7 @@ async function $do(
   [
     Result<
       models.Milestone,
+      | errors.ApiError
       | ClientCasaError
       | ResponseValidationError
       | ConnectionError
@@ -129,8 +132,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, {
@@ -160,8 +173,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     models.Milestone,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -172,9 +190,11 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.Milestone$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/{payments-create-payment.ts → payments-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
  * Records a manually-collected payment (check, bank transfer, cash, etc.). Stripe payments are recorded automatically via webhooks and cannot be created here. Payments are immutable after creation except for `reference` and `notes`. To reverse a payment, record a refund (kind=refund, negative amount, refundOfId pointing at the original).
  */
-export function paymentsCreatePayment(
+export function paymentsCreate(
   client: ClientCasaCore,
   security: operations.CreatePaymentSecurity,
-  request: models.PaymentCreate,
+  request: operations.CreatePaymentRequest,
   options?: RequestOptions,
 ): APIPromise<
   Result<
     models.Payment,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -62,12 +64,13 @@ export function paymentsCreatePayment(
 async function $do(
   client: ClientCasaCore,
   security: operations.CreatePaymentSecurity,
-  request: models.PaymentCreate,
+  request: operations.CreatePaymentRequest,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
       models.Payment,
+      | errors.ApiError
       | ClientCasaError
       | ResponseValidationError
       | ConnectionError
@@ -82,20 +85,25 @@ async function $do(
 > {
   const parsed = safeParse(
     request,
-    (value) => z.parse(models.PaymentCreate$outboundSchema, value),
+    (value) => z.parse(operations.CreatePaymentRequest$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/payments")();
 
   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 +165,13 @@ async function $do(
   }
   const response = doResult.value;
 
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
   const [result] = await M.match<
     models.Payment,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -169,9 +182,11 @@ async function $do(
     | SDKValidationError
   >(
     M.json(201, models.Payment$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/{payments-get-payment.ts → payments-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 payment
  */
-export function paymentsGetPayment(
+export function paymentsGet(
   client: ClientCasaCore,
   security: operations.GetPaymentSecurity,
   request: operations.GetPaymentRequest,
@@ -38,6 +39,7 @@ export function paymentsGetPayment(
 ): APIPromise<
   Result<
     models.Payment,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -65,6 +67,7 @@ async function $do(
   [
     Result<
       models.Payment,
+      | 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.Payment,
+    | errors.ApiError
     | ClientCasaError
     | ResponseValidationError
     | ConnectionError
@@ -171,9 +189,11 @@ async function $do(
     | SDKValidationError
   >(
     M.json(200, models.Payment$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 }];
   }