/* * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT. */ import { GustoEmbeddedCore } from "../core.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"; import { safeParse } from "../lib/schemas.js"; import { RequestOptions } from "../lib/sdks.js"; import { resolveSecurity } from "../lib/security.js"; import { pathToFunc } from "../lib/url.js"; import { GustoEmbeddedError } from "../models/errors/gustoembeddederror.js"; import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError, } from "../models/errors/httpclienterrors.js"; import { PayrollDigestConflictError, PayrollDigestConflictError$inboundSchema, } from "../models/errors/payrolldigestconflicterror.js"; import { ResponseValidationError } from "../models/errors/responsevalidationerror.js"; import { SDKValidationError } from "../models/errors/sdkvalidationerror.js"; import { UnprocessableEntityError, UnprocessableEntityError$inboundSchema, } from "../models/errors/unprocessableentityerror.js"; import { PostV1PayrollDigestsRequest, PostV1PayrollDigestsRequest$outboundSchema, PostV1PayrollDigestsResponse, PostV1PayrollDigestsResponse$inboundSchema, PostV1PayrollDigestsSecurity, } from "../models/operations/postv1payrolldigests.js"; import { APICall, APIPromise } from "../types/async.js"; import { Result } from "../types/fp.js"; /** * Create a payroll digest batch * * @remarks * Triggers an asynchronous computation of payroll digest data (statuses, blockers, pay periods, totals) across up to 25 companies that the partner is mapped to. * * The batch is processed asynchronously. Use the returned batch UUID to poll `GET /v1/payroll_digests/{payroll_digest_uuid}` for status and results. * * Idempotency is scoped per `(partner, idempotency_key)`. A duplicate POST with the same `idempotency_key` returns a 409 Conflict referencing the existing batch UUID — no duplicate computation occurs. * * 📘 System Access Authentication * * This endpoint uses the [Bearer Auth scheme with the system-level access token in the HTTP Authorization header](https://docs.gusto.com/embedded-payroll/docs/system-access) * * scope: `payroll_digests:write` */ export function payrollDigestsPostV1PayrollDigests( client: GustoEmbeddedCore, security: PostV1PayrollDigestsSecurity, request: PostV1PayrollDigestsRequest, options?: RequestOptions, ): APIPromise< Result< PostV1PayrollDigestsResponse, | PayrollDigestConflictError | UnprocessableEntityError | GustoEmbeddedError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError > > { return new APIPromise($do( client, security, request, options, )); } async function $do( client: GustoEmbeddedCore, security: PostV1PayrollDigestsSecurity, request: PostV1PayrollDigestsRequest, options?: RequestOptions, ): Promise< [ Result< PostV1PayrollDigestsResponse, | PayrollDigestConflictError | UnprocessableEntityError | GustoEmbeddedError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError >, APICall, ] > { const parsed = safeParse( request, (value) => PostV1PayrollDigestsRequest$outboundSchema.parse(value), "Input validation failed", ); if (!parsed.ok) { return [parsed, { status: "invalid" }]; } const payload = parsed.value; const body = encodeJSON("body", payload.RequestBody, { explode: true }); const path = pathToFunc("/v1/payroll_digests")(); const headers = new Headers(compactMap({ "Content-Type": "application/json", Accept: "application/json", "X-Gusto-API-Version": encodeSimple( "X-Gusto-API-Version", payload["X-Gusto-API-Version"], { explode: false, charEncoding: "none" }, ), })); const requestSecurity = resolveSecurity( [ { fieldName: "Authorization", type: "http:bearer", value: security?.systemAccessAuth, }, ], ); const context = { options: client._options, baseURL: options?.serverURL ?? client._baseURL ?? "", operationID: "post-v1-payroll_digests", oAuth2Scopes: null, resolvedSecurity: requestSecurity, securitySource: security, retryConfig: options?.retries || client._options.retryConfig || { strategy: "none" }, retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"], }; const requestRes = client._createRequest(context, { security: requestSecurity, method: "POST", baseURL: options?.serverURL, path: path, headers: headers, body: body, userAgent: client._options.userAgent, timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1, }, options); if (!requestRes.ok) { return [requestRes, { status: "invalid" }]; } const req = requestRes.value; const doResult = await client._do(req, { context, isErrorStatusCode: (statusCode: number) => matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]), retryConfig: context.retryConfig, retryCodes: context.retryCodes, }); if (!doResult.ok) { return [doResult, { status: "request-error", request: req }]; } const response = doResult.value; const responseFields = { HttpMeta: { Response: response, Request: req }, }; const [result] = await M.match< PostV1PayrollDigestsResponse, | PayrollDigestConflictError | UnprocessableEntityError | GustoEmbeddedError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError >( M.json(201, PostV1PayrollDigestsResponse$inboundSchema, { key: "Payroll-Digest", }), M.jsonErr(409, PayrollDigestConflictError$inboundSchema), M.jsonErr(422, UnprocessableEntityError$inboundSchema), M.fail("4XX"), M.fail("5XX"), )(response, req, { extraFields: responseFields }); if (!result.ok) { return [result, { status: "complete", request: req, response }]; } return [result, { status: "complete", request: req, response }]; }