@greensecurity/javascript-sdk 0.45.0-beta.7 → 0.45.0-beta.9

package/src/react-query/invoicesConvertQuote.ts

@@ -0,0 +1,124 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import {
+  MutationKey,
+  useMutation,
+  UseMutationResult,
+} from "@tanstack/react-query";
+import { GreenSecurityCore } from "../core.js";
+import { invoicesConvertQuote } from "../funcs/invoicesConvertQuote.js";
+import { combineSignals } from "../lib/primitives.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { GreenSecurityError } from "../models/errors/greensecurityerror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { unwrapAsync } from "../types/fp.js";
+import { useGreenSecurityContext } from "./_context.js";
+import { MutationHookOptions } from "./_types.js";
+
+export type InvoicesConvertQuoteMutationVariables = {
+  request: operations.ConvertQuoteRequest;
+  options?: RequestOptions;
+};
+
+export type InvoicesConvertQuoteMutationData =
+  operations.ConvertQuoteConvertQuoteOk;
+
+export type InvoicesConvertQuoteMutationError =
+  | errors.ApiErrorResponse
+  | GreenSecurityError
+  | ResponseValidationError
+  | ConnectionError
+  | RequestAbortedError
+  | RequestTimeoutError
+  | InvalidRequestError
+  | UnexpectedClientError
+  | SDKValidationError;
+
+/**
+ * Convert a quote into an invoice
+ *
+ * @remarks
+ * Converts a quote into the real invoice its caller will be charged for, and
+ * returns the new invoice with its calculated totals. Any `VendorCredential`
+ * linked to the quote is re-pointed at the new invoice.
+ *
+ * The operation is idempotent: converting a quote that has already been
+ * processed returns the invoice previously created from it rather than
+ * creating a second one, so a retried request is safe.
+ *
+ * The referenced invoice must actually be a quote — a non-quote invoice id
+ * responds `400`. Requires a caller whose access scope permits creating
+ * invoices; a caller allowed to create the invoice but not to update the
+ * linked `VendorCredential` responds `401`.
+ *
+ * Takes no request body.
+ */
+export function useInvoicesConvertQuoteMutation(
+  options?: MutationHookOptions<
+    InvoicesConvertQuoteMutationData,
+    InvoicesConvertQuoteMutationError,
+    InvoicesConvertQuoteMutationVariables
+  >,
+): UseMutationResult<
+  InvoicesConvertQuoteMutationData,
+  InvoicesConvertQuoteMutationError,
+  InvoicesConvertQuoteMutationVariables
+> {
+  const client = useGreenSecurityContext();
+  return useMutation({
+    ...buildInvoicesConvertQuoteMutation(client, options),
+    ...options,
+  });
+}
+
+export function mutationKeyInvoicesConvertQuote(): MutationKey {
+  return ["@greensecurity/javascript-sdk", "invoices", "convertQuote"];
+}
+
+export function buildInvoicesConvertQuoteMutation(
+  client$: GreenSecurityCore,
+  hookOptions?: RequestOptions,
+): {
+  mutationKey: MutationKey;
+  mutationFn: (
+    variables: InvoicesConvertQuoteMutationVariables,
+  ) => Promise<InvoicesConvertQuoteMutationData>;
+} {
+  return {
+    mutationKey: mutationKeyInvoicesConvertQuote(),
+    mutationFn: function invoicesConvertQuoteMutationFn({
+      request,
+      options,
+    }): Promise<InvoicesConvertQuoteMutationData> {
+      const mergedOptions = {
+        ...hookOptions,
+        ...options,
+        fetchOptions: {
+          ...hookOptions?.fetchOptions,
+          ...options?.fetchOptions,
+          signal: combineSignals(
+            hookOptions?.fetchOptions?.signal,
+            options?.fetchOptions?.signal,
+          ),
+        },
+      };
+      return unwrapAsync(invoicesConvertQuote(
+        client$,
+        request,
+        mergedOptions,
+      ));
+    },
+  };
+}

package/src/sdk/invoices.ts

@@ -2,6 +2,7 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import { invoicesConvertQuote } from "../funcs/invoicesConvertQuote.js";
 import { invoicesCreateInvoice } from "../funcs/invoicesCreateInvoice.js";
 import {
   DownloadInvoicesExportAcceptEnum,
@@ -152,6 +153,36 @@ export class Invoices extends ClientSDK {
     ));
   }
 
+  /**
+   * Convert a quote into an invoice
+   *
+   * @remarks
+   * Converts a quote into the real invoice its caller will be charged for, and
+   * returns the new invoice with its calculated totals. Any `VendorCredential`
+   * linked to the quote is re-pointed at the new invoice.
+   *
+   * The operation is idempotent: converting a quote that has already been
+   * processed returns the invoice previously created from it rather than
+   * creating a second one, so a retried request is safe.
+   *
+   * The referenced invoice must actually be a quote — a non-quote invoice id
+   * responds `400`. Requires a caller whose access scope permits creating
+   * invoices; a caller allowed to create the invoice but not to update the
+   * linked `VendorCredential` responds `401`.
+   *
+   * Takes no request body.
+   */
+  async convertQuote(
+    request: operations.ConvertQuoteRequest,
+    options?: RequestOptions,
+  ): Promise<operations.ConvertQuoteConvertQuoteOk> {
+    return unwrapAsync(invoicesConvertQuote(
+      this,
+      request,
+      options,
+    ));
+  }
+
   /**
    * Export invoices to csv (async)
    *