@maesn/typescript-sdk 0.2.1 → 0.2.3

package/src/funcs/webhooks-delete-webhook-tenant.ts

@@ -24,6 +24,7 @@ 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 * as types$ from "../types/primitives.js";
 
 export function webhooksDeleteWebhookTenant(
   client: MaesnCore,
@@ -31,7 +32,7 @@ export function webhooksDeleteWebhookTenant(
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    void,
+    string,
     | MaesnError
     | ResponseValidationError
     | ConnectionError
@@ -56,7 +57,7 @@ async function $do(
 ): Promise<
   [
     Result<
-      void,
+      string,
       | MaesnError
       | ResponseValidationError
       | ConnectionError
@@ -90,7 +91,7 @@ async function $do(
   const path = pathToFunc("/tenant/{webhookId}")(pathParams);
 
   const headers = new Headers(compactMap({
-    Accept: "*/*",
+    Accept: "application/json",
   }));
 
   const securityInput = await extractSecurity(client._options.security);
@@ -138,7 +139,7 @@ async function $do(
   const response = doResult.value;
 
   const [result] = await M.match<
-    void,
+    string,
     | MaesnError
     | ResponseValidationError
     | ConnectionError
@@ -148,7 +149,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.nil(200, z.void()),
+    M.json(200, types$.string()),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req);

package/src/funcs/webhooks-delete-webhook.ts

@@ -31,7 +31,7 @@ export function webhooksDeleteWebhook(
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    void,
+    operations.DeleteWebhookResponse,
     | MaesnError
     | ResponseValidationError
     | ConnectionError
@@ -56,7 +56,7 @@ async function $do(
 ): Promise<
   [
     Result<
-      void,
+      operations.DeleteWebhookResponse,
       | MaesnError
       | ResponseValidationError
       | ConnectionError
@@ -94,7 +94,7 @@ async function $do(
   });
 
   const headers = new Headers(compactMap({
-    Accept: "*/*",
+    Accept: "application/json",
   }));
 
   const securityInput = await extractSecurity(client._options.security);
@@ -143,7 +143,7 @@ async function $do(
   const response = doResult.value;
 
   const [result] = await M.match<
-    void,
+    operations.DeleteWebhookResponse,
     | MaesnError
     | ResponseValidationError
     | ConnectionError
@@ -153,7 +153,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.nil(200, z.void()),
+    M.json(200, operations.DeleteWebhookResponse$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req);

package/src/funcs/webhooks-get-webhooks.ts

@@ -31,7 +31,7 @@ export function webhooksGetWebhooks(
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    void,
+    operations.GetWebhooksResponse,
     | MaesnError
     | ResponseValidationError
     | ConnectionError
@@ -56,7 +56,7 @@ async function $do(
 ): Promise<
   [
     Result<
-      void,
+      operations.GetWebhooksResponse,
       | MaesnError
       | ResponseValidationError
       | ConnectionError
@@ -90,7 +90,7 @@ async function $do(
   });
 
   const headers = new Headers(compactMap({
-    Accept: "*/*",
+    Accept: "application/json",
   }));
 
   const securityInput = await extractSecurity(client._options.security);
@@ -139,7 +139,7 @@ async function $do(
   const response = doResult.value;
 
   const [result] = await M.match<
-    void,
+    operations.GetWebhooksResponse,
     | MaesnError
     | ResponseValidationError
     | ConnectionError
@@ -149,7 +149,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.nil(200, z.void()),
+    M.json(200, operations.GetWebhooksResponse$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req);

package/src/lib/config.ts

@@ -47,8 +47,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0",
-  sdkVersion: "0.2.1",
-  genVersion: "2.869.25",
-  userAgent:
-    "speakeasy-sdk/typescript 0.2.1 2.869.25 1.0 @maesn/typescript-sdk",
+  sdkVersion: "0.2.3",
+  genVersion: "2.879.1",
+  userAgent: "speakeasy-sdk/typescript 0.2.3 2.879.1 1.0 @maesn/typescript-sdk",
 } as const;

package/src/lib/security.ts

@@ -240,8 +240,9 @@ function applyBearer(
 
 export function resolveGlobalSecurity(
   security: Partial<models.Security> | null | undefined,
+  allowedFields?: number[],
 ): SecurityState | null {
-  return resolveSecurity(
+  let inputs: SecurityInput[][] = [
     [
       {
         fieldName: "X-API-KEY",
@@ -254,7 +255,18 @@ export function resolveGlobalSecurity(
         value: security?.accountKey ?? env().MAESN_ACCOUNT_KEY,
       },
     ],
-  );
+  ];
+
+  if (allowedFields) {
+    inputs = allowedFields.map((i) => {
+      if (i < 0 || i >= inputs.length) {
+        throw new RangeError(`invalid allowedFields index ${i}`);
+      }
+      return inputs[i]!;
+    });
+  }
+
+  return resolveSecurity(...inputs);
 }
 
 export async function extractSecurity<

package/src/models/base-response-dto.ts

@@ -0,0 +1,133 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import * as types from "../types/primitives.js";
+import { SDKValidationError } from "./errors/sdk-validation-error.js";
+
+export type Pagination = {
+  total: number;
+  perPage: number;
+  currentPage: number;
+  totalPages: number;
+};
+
+export type Meta = {
+  warnings?: Array<string> | null | undefined;
+  pagination?: Pagination | null | undefined;
+};
+
+export type Data = {};
+
+export type Errors = {};
+
+export type RawData = {};
+
+export type BaseResponseDto = {
+  meta?: Meta | null | undefined;
+  data: Data;
+  errors: Errors | null;
+  rawData: RawData | null;
+};
+
+/** @internal */
+export const Pagination$inboundSchema: z.ZodMiniType<Pagination, unknown> = z
+  .object({
+    total: types.number(),
+    perPage: types.number(),
+    currentPage: types.number(),
+    totalPages: types.number(),
+  });
+
+export function paginationFromJSON(
+  jsonString: string,
+): SafeParseResult<Pagination, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Pagination$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Pagination' from JSON`,
+  );
+}
+
+/** @internal */
+export const Meta$inboundSchema: z.ZodMiniType<Meta, unknown> = z.object({
+  warnings: z.optional(z.nullable(z.array(types.string()))),
+  pagination: z.optional(z.nullable(z.lazy(() => Pagination$inboundSchema))),
+});
+
+export function metaFromJSON(
+  jsonString: string,
+): SafeParseResult<Meta, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Meta$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Meta' from JSON`,
+  );
+}
+
+/** @internal */
+export const Data$inboundSchema: z.ZodMiniType<Data, unknown> = z.object({});
+
+export function dataFromJSON(
+  jsonString: string,
+): SafeParseResult<Data, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Data$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Data' from JSON`,
+  );
+}
+
+/** @internal */
+export const Errors$inboundSchema: z.ZodMiniType<Errors, unknown> = z.object(
+  {},
+);
+
+export function errorsFromJSON(
+  jsonString: string,
+): SafeParseResult<Errors, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Errors$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Errors' from JSON`,
+  );
+}
+
+/** @internal */
+export const RawData$inboundSchema: z.ZodMiniType<RawData, unknown> = z.object(
+  {},
+);
+
+export function rawDataFromJSON(
+  jsonString: string,
+): SafeParseResult<RawData, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => RawData$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'RawData' from JSON`,
+  );
+}
+
+/** @internal */
+export const BaseResponseDto$inboundSchema: z.ZodMiniType<
+  BaseResponseDto,
+  unknown
+> = z.object({
+  meta: z.optional(z.nullable(z.lazy(() => Meta$inboundSchema))),
+  data: z.lazy(() => Data$inboundSchema),
+  errors: types.nullable(z.lazy(() => Errors$inboundSchema)),
+  rawData: types.nullable(z.lazy(() => RawData$inboundSchema)),
+});
+
+export function baseResponseDtoFromJSON(
+  jsonString: string,
+): SafeParseResult<BaseResponseDto, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BaseResponseDto$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BaseResponseDto' from JSON`,
+  );
+}

package/src/models/company-response-dto.ts

@@ -8,13 +8,7 @@ import { safeParse } from "../lib/schemas.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
-
-export type Subscription = {
-  id: string | null;
-  name?: string | null | undefined;
-  status?: string | null | undefined;
-  active?: boolean | null | undefined;
-};
+import { Subscription, Subscription$inboundSchema } from "./subscription.js";
 
 export type CompanyResponseDto = {
   id: string | null;
@@ -22,28 +16,9 @@ export type CompanyResponseDto = {
   environmentId?: string | null | undefined;
   clientNumber?: number | null | undefined;
   consultantNumber?: number | null | undefined;
-  subscription?: Subscription | null | undefined;
+  subscription?: Array<Subscription> | null | undefined;
 };
 
-/** @internal */
-export const Subscription$inboundSchema: z.ZodMiniType<Subscription, unknown> =
-  z.object({
-    id: types.nullable(types.string()),
-    name: z.optional(z.nullable(types.string())),
-    status: z.optional(z.nullable(types.string())),
-    active: z.optional(z.nullable(types.boolean())),
-  });
-
-export function subscriptionFromJSON(
-  jsonString: string,
-): SafeParseResult<Subscription, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => Subscription$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'Subscription' from JSON`,
-  );
-}
-
 /** @internal */
 export const CompanyResponseDto$inboundSchema: z.ZodMiniType<
   CompanyResponseDto,
@@ -55,9 +30,7 @@ export const CompanyResponseDto$inboundSchema: z.ZodMiniType<
     environmentId: z.optional(z.nullable(types.string())),
     client_number: z.optional(z.nullable(types.number())),
     consultant_number: z.optional(z.nullable(types.number())),
-    subscription: z.optional(
-      z.nullable(z.lazy(() => Subscription$inboundSchema)),
-    ),
+    subscription: z.optional(z.nullable(z.array(Subscription$inboundSchema))),
   }),
   z.transform((v) => {
     return remap$(v, {

package/src/models/index.ts

@@ -11,6 +11,7 @@ export * from "./bank-account-request-common-dto-v2.js";
 export * from "./bank-account-response-dto.js";
 export * from "./bank-account-response.js";
 export * from "./bank-account.js";
+export * from "./base-response-dto.js";
 export * from "./bill-dimension-request-dto.js";
 export * from "./bill-dimension-response-dto.js";
 export * from "./bill-line-item-response-dto.js";
@@ -135,6 +136,7 @@ export * from "./sales-order-line-item-response-dto.js";
 export * from "./sales-order-response-dto.js";
 export * from "./security.js";
 export * from "./submission-page-style-dto.js";
+export * from "./subscription.js";
 export * from "./system-registration-dto.js";
 export * from "./tax-rate-input.js";
 export * from "./tax-rate-response-dto.js";
@@ -146,3 +148,4 @@ export * from "./vedor-credit-dimension-request-dto.js";
 export * from "./vendor-credit-dimension-response-dto.js";
 export * from "./vendor-credit-line-item-response-dto.js";
 export * from "./vendor-credit-response-dto.js";
+export * from "./webhook-response-dto.js";

package/src/models/operations/api-key-confirmation.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * API key confirmed and redirect URL returned successfully
+ */
+export type ApiKeyConfirmationResponse = {
+  url?: string | undefined;
+};
+
+/** @internal */
+export const ApiKeyConfirmationResponse$inboundSchema: z.ZodMiniType<
+  ApiKeyConfirmationResponse,
+  unknown
+> = z.object({
+  url: types.optional(types.string()),
+});
+
+export function apiKeyConfirmationResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ApiKeyConfirmationResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ApiKeyConfirmationResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ApiKeyConfirmationResponse' from JSON`,
+  );
+}

package/src/models/operations/callback.ts

@@ -4,20 +4,43 @@
 
 import * as z from "zod/v4-mini";
 import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
 
 export type CallbackRequest = {
   targetSystem: string;
-  code?: string | undefined;
+  /**
+   * OAuth state parameter returned by the target system, encoding tenant and user context
+   */
   state: string;
+  /**
+   * Authorization code returned by the target system after successful OAuth consent
+   */
+  code?: string | undefined;
+  /**
+   * Realm ID returned by QuickBooks Online after OAuth consent
+   */
   realmId?: string | undefined;
+  /**
+   * Access token returned directly by some target systems that do not use an authorization code flow
+   */
   token?: string | undefined;
 };
 
+/**
+ * OAuth callback processed and redirect URL returned successfully
+ */
+export type CallbackResponse = {
+  url?: string | undefined;
+};
+
 /** @internal */
 export type CallbackRequest$Outbound = {
   TARGET_SYSTEM: string;
-  code?: string | undefined;
   state: string;
+  code?: string | undefined;
   realmId?: string | undefined;
   token?: string | undefined;
 };
@@ -29,8 +52,8 @@ export const CallbackRequest$outboundSchema: z.ZodMiniType<
 > = z.pipe(
   z.object({
     targetSystem: z.string(),
-    code: z.optional(z.string()),
     state: z.string(),
+    code: z.optional(z.string()),
     realmId: z.optional(z.string()),
     token: z.optional(z.string()),
   }),
@@ -46,3 +69,21 @@ export function callbackRequestToJSON(
 ): string {
   return JSON.stringify(CallbackRequest$outboundSchema.parse(callbackRequest));
 }
+
+/** @internal */
+export const CallbackResponse$inboundSchema: z.ZodMiniType<
+  CallbackResponse,
+  unknown
+> = z.object({
+  url: types.optional(types.string()),
+});
+
+export function callbackResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CallbackResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CallbackResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CallbackResponse' from JSON`,
+  );
+}

package/src/models/operations/cancel.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * Cancellation redirect URL returned successfully
+ */
+export type CancelResponse = {
+  url?: string | undefined;
+};
+
+/** @internal */
+export const CancelResponse$inboundSchema: z.ZodMiniType<
+  CancelResponse,
+  unknown
+> = z.object({
+  url: types.optional(types.string()),
+});
+
+export function cancelResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CancelResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CancelResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CancelResponse' from JSON`,
+  );
+}

package/src/models/operations/check.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdk-validation-error.js";
+
+/**
+ * Service is healthy.
+ */
+export type CheckResponse = {};
+
+/** @internal */
+export const CheckResponse$inboundSchema: z.ZodMiniType<
+  CheckResponse,
+  unknown
+> = z.object({});
+
+export function checkResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CheckResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CheckResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CheckResponse' from JSON`,
+  );
+}

package/src/models/operations/create-account.ts

@@ -10,7 +10,13 @@ import { SDKValidationError } from "../errors/sdk-validation-error.js";
 import * as models from "../index.js";
 
 export type CreateAccountRequest = {
+  /**
+   * Environment name (required for multi-environment systems such as Business Central)
+   */
   environmentName?: string | undefined;
+  /**
+   * ID of the company (required for multi-company target systems)
+   */
   companyId?: string | undefined;
   body: models.CreateAccountRequestDto;
 };
@@ -31,6 +37,9 @@ export type CreateAccountErrors = {};
 
 export type CreateAccountRawData = {};
 
+/**
+ * Account created successfully
+ */
 export type CreateAccountResponse = {
   meta?: CreateAccountMeta | null | undefined;
   data: models.AccountResponseDto;

package/src/models/operations/create-bank-account.ts

@@ -10,7 +10,13 @@ import { SDKValidationError } from "../errors/sdk-validation-error.js";
 import * as models from "../index.js";
 
 export type CreateBankAccountRequest = {
+  /**
+   * Environment name (required for multi-environment systems such as Business Central)
+   */
   environmentName?: string | undefined;
+  /**
+   * ID of the company (required for multi-company target systems)
+   */
   companyId?: string | undefined;
   body: models.CreateBankAccountRequestDto;
 };
@@ -31,6 +37,9 @@ export type CreateBankAccountErrors = {};
 
 export type CreateBankAccountRawData = {};
 
+/**
+ * Bank account created successfully
+ */
 export type CreateBankAccountResponse = {
   meta?: CreateBankAccountMeta | null | undefined;
   data: models.BankAccountResponseDto;

package/src/models/operations/create-bill-line-item.ts

@@ -11,6 +11,9 @@ import * as models from "../index.js";
 
 export type CreateBillLineItemRequest = {
   billId: string;
+  /**
+   * ID of the company (required for multi-company target systems)
+   */
   companyId?: string | undefined;
   body: models.CreateBillLineItemRequestDto;
 };
@@ -31,6 +34,9 @@ export type CreateBillLineItemErrors = {};
 
 export type CreateBillLineItemRawData = {};
 
+/**
+ * Bill line item created successfully
+ */
 export type CreateBillLineItemResponse = {
   meta?: CreateBillLineItemMeta | null | undefined;
   data: Array<models.BillLineItemResponseDto>;

package/src/models/operations/create-bill.ts

@@ -10,7 +10,13 @@ import { SDKValidationError } from "../errors/sdk-validation-error.js";
 import * as models from "../index.js";
 
 export type CreateBillRequest = {
+  /**
+   * Environment name (required for multi-environment systems such as Business Central)
+   */
   environmentName?: string | undefined;
+  /**
+   * ID of the company (required for multi-company target systems)
+   */
   companyId?: string | undefined;
   body: models.CreateBillRequestDto;
 };
@@ -31,6 +37,9 @@ export type CreateBillErrors = {};
 
 export type CreateBillRawData = {};
 
+/**
+ * Bill created successfully
+ */
 export type CreateBillResponse = {
   meta?: CreateBillMeta | null | undefined;
   data: models.BillResponseDto;

package/src/models/operations/create-booking-proposal-v2.ts

@@ -28,6 +28,9 @@ export type CreateBookingProposalV2RequestBody = {
 };
 
 export type CreateBookingProposalV2Request = {
+  /**
+   * ID of the company (required for multi-company target systems)
+   */
   companyId?: string | undefined;
   body: CreateBookingProposalV2RequestBody;
 };
@@ -48,6 +51,9 @@ export type CreateBookingProposalV2Errors = {};
 
 export type CreateBookingProposalV2RawData = {};
 
+/**
+ * Booking proposal created successfully. Returns 202 with taskId if processed asynchronously.
+ */
 export type CreateBookingProposalV2Response = {
   meta?: CreateBookingProposalV2Meta | null | undefined;
   data: models.BookingProposalResponseDtoV2;