@clientcasa/sdk 0.1.0

package/src/models/contract-update.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type ContractUpdate = {
+  title?: string | undefined;
+  effectiveDate?: Date | null | undefined;
+  expirationDate?: Date | null | undefined;
+  archived?: boolean | undefined;
+};
+
+/** @internal */
+export type ContractUpdate$Outbound = {
+  title?: string | undefined;
+  effectiveDate?: string | null | undefined;
+  expirationDate?: string | null | undefined;
+  archived?: boolean | undefined;
+};
+
+/** @internal */
+export const ContractUpdate$outboundSchema: z.ZodMiniType<
+  ContractUpdate$Outbound,
+  ContractUpdate
+> = z.object({
+  title: z.optional(z.string()),
+  effectiveDate: z.optional(
+    z.nullable(z.pipe(
+      z.date(),
+      z.transform(v => v.toISOString().slice(0, "YYYY-MM-DD".length)),
+    )),
+  ),
+  expirationDate: z.optional(
+    z.nullable(z.pipe(
+      z.date(),
+      z.transform(v => v.toISOString().slice(0, "YYYY-MM-DD".length)),
+    )),
+  ),
+  archived: z.optional(z.boolean()),
+});
+
+export function contractUpdateToJSON(contractUpdate: ContractUpdate): string {
+  return JSON.stringify(ContractUpdate$outboundSchema.parse(contractUpdate));
+}

package/src/models/contract.ts

@@ -0,0 +1,202 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
+import { ClosedEnum, OpenEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { smartUnion } from "../types/smart-union.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export const ContractStatus = {
+  Draft: "draft",
+  Sent: "sent",
+  Viewed: "viewed",
+  Active: "active",
+  Completed: "completed",
+  Expired: "expired",
+  Voided: "voided",
+} as const;
+export type ContractStatus = OpenEnum<typeof ContractStatus>;
+
+export const SigningMode = {
+  ClientOnly: "client_only",
+  CounterSign: "counter_sign",
+  AutoCounterSign: "auto_counter_sign",
+} as const;
+export type SigningMode = OpenEnum<typeof SigningMode>;
+
+export const ContentType = {
+  Tiptap: "tiptap",
+  Pdf: "pdf",
+} as const;
+export type ContentType = OpenEnum<typeof ContentType>;
+
+export const EmailEnum = {
+  Unknown: "",
+} as const;
+export type EmailEnum = ClosedEnum<typeof EmailEnum>;
+
+export type Email = string | EmailEnum;
+
+export type Signer = {
+  /**
+   * UUID v4
+   */
+  contactId: string | null;
+  name: string;
+  email: string | EmailEnum;
+  role: string;
+  order: number;
+  status: string;
+  /**
+   * ISO 8601 timestamp (UTC)
+   */
+  signedAt: Date | null;
+};
+
+export type Contract = {
+  /**
+   * UUID v4
+   */
+  id: string;
+  contractNumber: string;
+  title: string;
+  /**
+   * UUID v4
+   */
+  clientId: string;
+  /**
+   * UUID v4
+   */
+  billingContactId: string | null;
+  /**
+   * UUID v4
+   */
+  proposalId: string | null;
+  /**
+   * UUID v4
+   */
+  projectId: string | null;
+  /**
+   * UUID v4
+   */
+  sourceTemplateId: string | null;
+  status: ContractStatus;
+  signingMode: SigningMode;
+  contentType: ContentType;
+  issueDate: Date | null;
+  effectiveDate: Date | null;
+  expirationDate: Date | null;
+  /**
+   * ISO 8601 timestamp (UTC)
+   */
+  signedDate: Date | null;
+  currency: string;
+  contractValue: number | null;
+  signers: Array<Signer>;
+  archived: boolean;
+  /**
+   * ISO 8601 timestamp (UTC)
+   */
+  createdAt: Date;
+  /**
+   * ISO 8601 timestamp (UTC)
+   */
+  updatedAt: Date;
+};
+
+/** @internal */
+export const ContractStatus$inboundSchema: z.ZodMiniType<
+  ContractStatus,
+  unknown
+> = openEnums.inboundSchema(ContractStatus);
+
+/** @internal */
+export const SigningMode$inboundSchema: z.ZodMiniType<SigningMode, unknown> =
+  openEnums.inboundSchema(SigningMode);
+
+/** @internal */
+export const ContentType$inboundSchema: z.ZodMiniType<ContentType, unknown> =
+  openEnums.inboundSchema(ContentType);
+
+/** @internal */
+export const EmailEnum$inboundSchema: z.ZodMiniEnum<typeof EmailEnum> = z.enum(
+  EmailEnum,
+);
+
+/** @internal */
+export const Email$inboundSchema: z.ZodMiniType<Email, unknown> = smartUnion([
+  types.string(),
+  EmailEnum$inboundSchema,
+]);
+
+export function emailFromJSON(
+  jsonString: string,
+): SafeParseResult<Email, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Email$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Email' from JSON`,
+  );
+}
+
+/** @internal */
+export const Signer$inboundSchema: z.ZodMiniType<Signer, unknown> = z.object({
+  contactId: types.nullable(types.string()),
+  name: types.string(),
+  email: smartUnion([types.string(), EmailEnum$inboundSchema]),
+  role: types.string(),
+  order: types.number(),
+  status: types.string(),
+  signedAt: types.nullable(types.date()),
+});
+
+export function signerFromJSON(
+  jsonString: string,
+): SafeParseResult<Signer, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Signer$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Signer' from JSON`,
+  );
+}
+
+/** @internal */
+export const Contract$inboundSchema: z.ZodMiniType<Contract, unknown> = z
+  .object({
+    id: types.string(),
+    contractNumber: types.string(),
+    title: types.string(),
+    clientId: types.string(),
+    billingContactId: types.nullable(types.string()),
+    proposalId: types.nullable(types.string()),
+    projectId: types.nullable(types.string()),
+    sourceTemplateId: types.nullable(types.string()),
+    status: ContractStatus$inboundSchema,
+    signingMode: SigningMode$inboundSchema,
+    contentType: ContentType$inboundSchema,
+    issueDate: types.nullable(types.date()),
+    effectiveDate: types.nullable(types.date()),
+    expirationDate: types.nullable(types.date()),
+    signedDate: types.nullable(types.date()),
+    currency: types.string(),
+    contractValue: types.nullable(types.number()),
+    signers: z.array(z.lazy(() => Signer$inboundSchema)),
+    archived: types.boolean(),
+    createdAt: types.date(),
+    updatedAt: types.date(),
+  });
+
+export function contractFromJSON(
+  jsonString: string,
+): SafeParseResult<Contract, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Contract$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Contract' from JSON`,
+  );
+}

package/src/models/errors/client-casa-default-error.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ClientCasaError } from "./client-casa-error.js";
+
+/** The fallback error class if no more specific error class is matched */
+export class ClientCasaDefaultError extends ClientCasaError {
+  constructor(
+    message: string,
+    httpMeta: {
+      response: Response;
+      request: Request;
+      body: string;
+    },
+  ) {
+    if (message) {
+      message += `: `;
+    }
+    message += `Status ${httpMeta.response.status}`;
+    const contentType = httpMeta.response.headers.get("content-type") || `""`;
+    if (contentType !== "application/json") {
+      message += ` Content-Type ${
+        contentType.includes(" ") ? `"${contentType}"` : contentType
+      }`;
+    }
+    const body = httpMeta.body || `""`;
+    message += body.length > 100 ? "\n" : ". ";
+    let bodyDisplay = body;
+    if (body.length > 10000) {
+      const truncated = body.substring(0, 10000);
+      const remaining = body.length - 10000;
+      bodyDisplay = `${truncated}...and ${remaining} more chars`;
+    }
+    message += `Body: ${bodyDisplay}`;
+    message = message.trim();
+    super(message, httpMeta);
+    this.name = "ClientCasaDefaultError";
+  }
+}

package/src/models/errors/client-casa-error.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+/** The base class for all HTTP error responses */
+export class ClientCasaError extends Error {
+  /** HTTP status code */
+  public readonly statusCode: number;
+  /** HTTP body */
+  public readonly body: string;
+  /** HTTP headers */
+  public readonly headers: Headers;
+  /** HTTP content type */
+  public readonly contentType: string;
+  /** Raw response */
+  public readonly rawResponse: Response;
+
+  constructor(
+    message: string,
+    httpMeta: {
+      response: Response;
+      request: Request;
+      body: string;
+    },
+  ) {
+    super(message);
+    this.statusCode = httpMeta.response.status;
+    this.body = httpMeta.body;
+    this.headers = httpMeta.response.headers;
+    this.contentType = httpMeta.response.headers.get("content-type") || "";
+    this.rawResponse = httpMeta.response;
+
+    this.name = "ClientCasaError";
+  }
+}

package/src/models/errors/http-client-errors.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+/**
+ * Base class for all HTTP errors.
+ */
+export class HTTPClientError extends Error {
+  /** The underlying cause of the error. */
+  override readonly cause: unknown;
+  override name = "HTTPClientError";
+  constructor(message: string, opts?: { cause?: unknown }) {
+    let msg = message;
+    if (opts?.cause) {
+      msg += `: ${opts.cause}`;
+    }
+
+    super(msg, opts);
+    // In older runtimes, the cause field would not have been assigned through
+    // the super() call.
+    if (typeof this.cause === "undefined") {
+      this.cause = opts?.cause;
+    }
+  }
+}
+
+/**
+ * An error to capture unrecognised or unexpected errors when making HTTP calls.
+ */
+export class UnexpectedClientError extends HTTPClientError {
+  override name = "UnexpectedClientError";
+}
+
+/**
+ * An error that is raised when any inputs used to create a request are invalid.
+ */
+export class InvalidRequestError extends HTTPClientError {
+  override name = "InvalidRequestError";
+}
+
+/**
+ * An error that is raised when a HTTP request was aborted by the client error.
+ */
+export class RequestAbortedError extends HTTPClientError {
+  override readonly name = "RequestAbortedError";
+}
+
+/**
+ * An error that is raised when a HTTP request timed out due to an AbortSignal
+ * signal timeout.
+ */
+export class RequestTimeoutError extends HTTPClientError {
+  override readonly name = "RequestTimeoutError";
+}
+
+/**
+ * An error that is raised when a HTTP client is unable to make a request to
+ * a server.
+ */
+export class ConnectionError extends HTTPClientError {
+  override readonly name = "ConnectionError";
+}

package/src/models/errors/index.ts

@@ -0,0 +1,9 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export * from "./client-casa-default-error.js";
+export * from "./client-casa-error.js";
+export * from "./http-client-errors.js";
+export * from "./response-validation-error.js";
+export * from "./sdk-validation-error.js";

package/src/models/errors/response-validation-error.ts

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4/core";
+import { ClientCasaError } from "./client-casa-error.js";
+import { formatZodError } from "./sdk-validation-error.js";
+
+export class ResponseValidationError extends ClientCasaError {
+  /**
+   * The raw value that failed validation.
+   */
+  public readonly rawValue: unknown;
+
+  /**
+   * The raw message that failed validation.
+   */
+  public readonly rawMessage: unknown;
+
+  constructor(
+    message: string,
+    extra: {
+      response: Response;
+      request: Request;
+      body: string;
+      cause: unknown;
+      rawValue: unknown;
+      rawMessage: unknown;
+    },
+  ) {
+    super(message, extra);
+    this.name = "ResponseValidationError";
+    this.cause = extra.cause;
+    this.rawValue = extra.rawValue;
+    this.rawMessage = extra.rawMessage;
+  }
+
+  /**
+   * Return a pretty-formatted error message if the underlying validation error
+   * is a ZodError or some other recognized error type, otherwise return the
+   * default error message.
+   */
+  public pretty(): string {
+    if (this.cause instanceof z.$ZodError) {
+      return `${this.rawMessage}\n${formatZodError(this.cause)}`;
+    } else {
+      return this.toString();
+    }
+  }
+}

package/src/models/errors/sdk-validation-error.ts

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4/core";
+
+export class SDKValidationError extends Error {
+  /**
+   * The raw value that failed validation.
+   */
+  public readonly rawValue: unknown;
+
+  /**
+   * The raw message that failed validation.
+   */
+  public readonly rawMessage: unknown;
+
+  // Allows for backwards compatibility for `instanceof` checks of `ResponseValidationError`
+  static override [Symbol.hasInstance](
+    instance: unknown,
+  ): instance is SDKValidationError {
+    if (!(instance instanceof Error)) return false;
+    if (!("rawValue" in instance)) return false;
+    if (!("rawMessage" in instance)) return false;
+    if (!("pretty" in instance)) return false;
+    if (typeof instance.pretty !== "function") return false;
+    return true;
+  }
+
+  constructor(message: string, cause: unknown, rawValue: unknown) {
+    super(`${message}: ${cause}`);
+    this.name = "SDKValidationError";
+    this.cause = cause;
+    this.rawValue = rawValue;
+    this.rawMessage = message;
+  }
+
+  /**
+   * Return a pretty-formatted error message if the underlying validation error
+   * is a ZodError or some other recognized error type, otherwise return the
+   * default error message.
+   */
+  public pretty(): string {
+    if (this.cause instanceof z.$ZodError) {
+      return `${this.rawMessage}\n${formatZodError(this.cause)}`;
+    } else {
+      return this.toString();
+    }
+  }
+}
+
+export function formatZodError(err: z.$ZodError): string {
+  return z.prettifyError(err);
+}

package/src/models/index.ts

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export * from "./calendar-event-create.js";
+export * from "./calendar-event-update.js";
+export * from "./calendar-event.js";
+export * from "./catalog-item-create.js";
+export * from "./catalog-item-update.js";
+export * from "./catalog-item.js";
+export * from "./client-create.js";
+export * from "./client-update.js";
+export * from "./client.js";
+export * from "./contact-create.js";
+export * from "./contact-update.js";
+export * from "./contact.js";
+export * from "./contract-create.js";
+export * from "./contract-update.js";
+export * from "./contract.js";
+export * from "./inquiry-create.js";
+export * from "./inquiry-update.js";
+export * from "./inquiry.js";
+export * from "./invoice-create.js";
+export * from "./invoice-line-item.js";
+export * from "./invoice-update.js";
+export * from "./invoice.js";
+export * from "./milestone-create.js";
+export * from "./milestone-update.js";
+export * from "./milestone.js";
+export * from "./pagination-meta.js";
+export * from "./payment-create.js";
+export * from "./payment-update.js";
+export * from "./payment.js";
+export * from "./payout.js";
+export * from "./project-create.js";
+export * from "./project-update.js";
+export * from "./project.js";
+export * from "./proposal-create.js";
+export * from "./proposal-update.js";
+export * from "./proposal.js";
+export * from "./security.js";
+export * from "./time-entry-create.js";
+export * from "./time-entry-update.js";
+export * from "./time-entry.js";
+export * from "./transaction-create.js";
+export * from "./transaction-update.js";
+export * from "./transaction.js";
+export * from "./webhook-create.js";
+export * from "./webhook-update.js";
+export * from "./webhook.js";

package/src/models/inquiry-create.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { ClosedEnum } from "../types/enums.js";
+
+export const InquiryCreateSource = {
+  InquiryForm: "inquiry_form",
+  Manual: "manual",
+  Referral: "referral",
+  Other: "other",
+} as const;
+export type InquiryCreateSource = ClosedEnum<typeof InquiryCreateSource>;
+
+export type InquiryCreate = {
+  name: string;
+  email: string;
+  phone?: string | undefined;
+  preferredDate?: Date | undefined;
+  message?: string | undefined;
+  source?: InquiryCreateSource | undefined;
+  customAnswers?: { [k: string]: any } | undefined;
+  /**
+   * UUID v4
+   */
+  contactId?: string | undefined;
+  notes?: string | undefined;
+};
+
+/** @internal */
+export const InquiryCreateSource$outboundSchema: z.ZodMiniEnum<
+  typeof InquiryCreateSource
+> = z.enum(InquiryCreateSource);
+
+/** @internal */
+export type InquiryCreate$Outbound = {
+  name: string;
+  email: string;
+  phone?: string | undefined;
+  preferredDate?: string | undefined;
+  message?: string | undefined;
+  source: string;
+  customAnswers?: { [k: string]: any } | undefined;
+  contactId?: string | undefined;
+  notes?: string | undefined;
+};
+
+/** @internal */
+export const InquiryCreate$outboundSchema: z.ZodMiniType<
+  InquiryCreate$Outbound,
+  InquiryCreate
+> = z.object({
+  name: z.string(),
+  email: z.string(),
+  phone: z.optional(z.string()),
+  preferredDate: z.optional(
+    z.pipe(
+      z.date(),
+      z.transform(v => v.toISOString().slice(0, "YYYY-MM-DD".length)),
+    ),
+  ),
+  message: z.optional(z.string()),
+  source: z._default(InquiryCreateSource$outboundSchema, "manual"),
+  customAnswers: z.optional(z.record(z.string(), z.any())),
+  contactId: z.optional(z.string()),
+  notes: z.optional(z.string()),
+});
+
+export function inquiryCreateToJSON(inquiryCreate: InquiryCreate): string {
+  return JSON.stringify(InquiryCreate$outboundSchema.parse(inquiryCreate));
+}