@greensecurity/javascript-sdk 0.44.0-beta.6 → 0.44.0-beta.61

package/src/funcs/reportsGetFullReport.ts

@@ -0,0 +1,204 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { GreenSecurityCore } from "../core.js";
+import { 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 { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.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 { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get a generated report's status and download URL
+ *
+ * @remarks
+ * Returns a completed report run and a short-lived signed `report_url` (valid 5 minutes).
+ *
+ * Only a completed run returns the `full_report` payload. A run that has not finished does
+ * **not** come back with a `status` field to inspect — it returns an error envelope. Poll on
+ * the status code alone; `409` is the only retryable outcome, so no error-message matching is
+ * needed:
+ *
+ * | Status | Meaning | What to do |
+ * | --- | --- | --- |
+ * | `200` | The run finished. | Download `full_report.report_url` within 5 minutes. |
+ * | `409` | Still pending or processing. | Retry, but bound it — see below. |
+ * | `422` | Terminal: the run was canceled or failed, or the id is not a positive integer. | Stop. |
+ * | `404` | No such run, or it is outside your access scope. | Stop. |
+ * | `403` | Your account is locked, or lacks the `scheduled_reports` view permission. | Stop. |
+ *
+ * **Bound your polling.** A `409` is not a promise that the run will finish. Report
+ * generation has no terminal failure state today, so a run whose generation crashed part way
+ * through stays in `processing` and keeps answering `409` indefinitely. Apply your own
+ * timeout or maximum attempt count and treat exhaustion as a failure; do not retry forever.
+ *
+ * Access control: the URL's `full_report_id` must be in the caller's read scope for
+ * `FullReport` — the facility or system it was run for, a recipient of the schedule that
+ * produced it, or a report whose app is activated for the API user. Callers outside that
+ * scope receive `404 Full report not found`.
+ *
+ * If set, this operation will use {@link Security.bearerJwt} from the global security.
+ */
+export function reportsGetFullReport(
+  client: GreenSecurityCore,
+  request: operations.GetFullReportRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.GetFullReportGetFullReportOk,
+    | errors.ApiErrorResponse
+    | errors.UnprocessableEntityOrValidationError
+    | GreenSecurityError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: GreenSecurityCore,
+  request: operations.GetFullReportRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.GetFullReportGetFullReportOk,
+      | errors.ApiErrorResponse
+      | errors.UnprocessableEntityOrValidationError
+      | GreenSecurityError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.GetFullReportRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    full_report_id: encodeSimple("full_report_id", payload.full_report_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/reports/{full_report_id}")(pathParams);
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const securityInput = await extractSecurity(client._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1]);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getFullReport",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.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: "GET",
+    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<
+    operations.GetFullReportGetFullReportOk,
+    | errors.ApiErrorResponse
+    | errors.UnprocessableEntityOrValidationError
+    | GreenSecurityError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.GetFullReportGetFullReportOk$inboundSchema),
+    M.jsonErr([400, 401, 403, 404, 409], errors.ApiErrorResponse$inboundSchema),
+    M.jsonErr(422, errors.UnprocessableEntityOrValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail([500, "5XX"]),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/reportsInitiateScheduledReport.ts

@@ -0,0 +1,205 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { GreenSecurityCore } from "../core.js";
+import { 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 { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.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 { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Generate a scheduled report now
+ *
+ * @remarks
+ * Immediately generates a new report run for a scheduled report, independent of its
+ * configured schedule. Returns a `poll_url` for the generated `FullReport`.
+ *
+ * Generation is asynchronous. Poll `GET /reports/{full_report_id}` on the **status code**,
+ * not on a status field: while the run is pending or processing that endpoint returns `409`
+ * with an error envelope and no `status` to read. Retry the `409` until it turns into `200`,
+ * which carries the `full_report` payload and the signed download URL. `409` is the only
+ * retryable status — a canceled or failed run returns `422`, so no error-message matching is
+ * needed to decide when to give up.
+ *
+ * Bound the retries with your own timeout or attempt limit. Report generation has no terminal
+ * failure state today, so a run whose generation crashed stays in `processing` and answers
+ * `409` indefinitely rather than turning into a `422`.
+ *
+ * Access control: the URL's `scheduled_report_id` must be in the caller's read scope
+ * for `ScheduledReport` — the facility or system it belongs to, a scheduled report the
+ * caller is an explicit recipient of, or a scheduled report whose app is activated for
+ * the API user. Callers outside that scope receive `404 Scheduled report not found`.
+ *
+ * If set, this operation will use {@link Security.bearerJwt} from the global security.
+ */
+export function reportsInitiateScheduledReport(
+  client: GreenSecurityCore,
+  request: operations.InitiateScheduledReportRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.InitiateScheduledReportInitiateScheduledReportOk,
+    | errors.ApiErrorResponse
+    | errors.UnprocessableEntityOrValidationError
+    | GreenSecurityError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: GreenSecurityCore,
+  request: operations.InitiateScheduledReportRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.InitiateScheduledReportInitiateScheduledReportOk,
+      | errors.ApiErrorResponse
+      | errors.UnprocessableEntityOrValidationError
+      | GreenSecurityError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.InitiateScheduledReportRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    scheduled_report_id: encodeSimple(
+      "scheduled_report_id",
+      payload.scheduled_report_id,
+      { explode: false, charEncoding: "percent" },
+    ),
+  };
+  const path = pathToFunc("/scheduled-reports/{scheduled_report_id}")(
+    pathParams,
+  );
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const securityInput = await extractSecurity(client._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1]);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "initiateScheduledReport",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.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<
+    operations.InitiateScheduledReportInitiateScheduledReportOk,
+    | errors.ApiErrorResponse
+    | errors.UnprocessableEntityOrValidationError
+    | GreenSecurityError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(
+      200,
+      operations.InitiateScheduledReportInitiateScheduledReportOk$inboundSchema,
+    ),
+    M.jsonErr([400, 401, 403, 404], errors.ApiErrorResponse$inboundSchema),
+    M.jsonErr(422, errors.UnprocessableEntityOrValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail([500, "5XX"]),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/supportArticlesListOrSearchSupportArticles.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } 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";
@@ -222,7 +221,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/systemsListSystems.ts

@@ -3,7 +3,6 @@
  */
 
 import { GreenSecurityCore } from "../core.js";
-import { dlv } from "../lib/dlv.js";
 import { encodeFormQuery, queryJoin } from "../lib/encodings.js";
 import { matchStatusCode } from "../lib/http.js";
 import * as M from "../lib/matchers.js";
@@ -231,7 +230,7 @@ async function $do(
     if (!responseData) {
       return { next: () => null };
     }
-    const results = dlv(responseData, "items");
+    const results = (responseData as { items: unknown }).items;
     if (!Array.isArray(results) || !results.length) {
       return { next: () => null };
     }

package/src/funcs/usersGetCurrentUser.ts

@@ -38,7 +38,7 @@ import { Result } from "../types/fp.js";
  *
  * Supported `expand` values:
  * - `user` — return the full user record, including all profile fields stored against the user (sensitive columns such as passwords, MFA codes, and payment-provider IDs are always omitted)
- * - `user.email_preferences` — include the user's `email_preferences` block (notification recipients and weekly email flags)
+ * - `user.email_preferences` — include the user's `email_preferences` block (notification recipients, weekly email flags, and — for company managers — `receive_vendor_emails`)
  * - `user.payment_profile` — include the user's `payment_profile` block (card type, last four digits, validity flags) when expanded; if no payment profile is associated with the user, the response returns `payment_profile: null`
  * - `company.location`, `company.vendor_type_restrictions`, `company.vendor_fields` — only valid for Company Manager users; embed extra fields on the user's company
  *

package/src/funcs/usersGetLinkedUsers.ts

@@ -30,12 +30,14 @@ import { Result } from "../types/fp.js";
  * Get linked users
  *
  * @remarks
- * Returns a list of users linked to the authenticated user.
+ * Returns a list of users linked to the requested user.
  *
- * For regular users, returns their own linked users.
+ * Pass `user_id=me` to fetch the linked users of the authenticated user. This
+ * is allowed for any authenticated user type.
  *
- * For API users, the `user_id` parameter is required. The API user must
- * have an active app activation for the requested user.
+ * API users may additionally pass a numeric `user_id` to fetch another user's
+ * linked users, provided they have an active app activation for that user.
+ * Non-API users may only pass `me`.
  *
  * If set, this operation will use {@link Security.bearerJwt} from the global security.
  */

package/src/funcs/usersGetUserById.ts

@@ -39,7 +39,7 @@ import { Result } from "../types/fp.js";
  *
  * Supported `expand` values:
  * - `user` — return the full user record (sensitive columns such as passwords and payment-provider IDs are always omitted)
- * - `user.email_preferences` — include the user's `email_preferences` block (notification recipients and weekly email flags)
+ * - `user.email_preferences` — include the user's `email_preferences` block (notification recipients, weekly email flags, and — for company managers — `receive_vendor_emails`)
  *
  * If set, this operation will use {@link Security.bearerJwt} from the global security.
  */

package/src/funcs/validateWebhook.ts

@@ -0,0 +1,88 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { GreenSecurityCore } from "../core.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as webhooks from "../models/webhooks/index.js";
+import { ERR, Result } from "../types/fp.js";
+import { WebhookAuthenticationError } from "../types/webhooks.js";
+
+export async function validateWebhook(client: GreenSecurityCore, {
+  request: rawRequest,
+  secret,
+}: {
+  request: {
+    body: BodyInit;
+    method: string;
+    url: string;
+    headers: Record<string, string> | Headers;
+  } | Request;
+  secret: string;
+}): Promise<
+  Result<
+    | webhooks.SendVendorCreatedRequest
+    | webhooks.SendVendorUpdatedRequest
+    | webhooks.SendVendorDestroyedRequest
+    | webhooks.SendTargetFacilityStatusChangeCreatedRequest
+    | webhooks.SendTargetFacilityStatusChangeUpdatedRequest
+    | webhooks.SendTargetFacilityStatusChangeDestroyedRequest
+    | webhooks.SendVendorScanCreatedRequest
+    | webhooks.SendVendorScanUpdatedRequest
+    | webhooks.SendVendorScanDestroyedRequest
+    | webhooks.SendVisitorCheckinCreatedRequest
+    | webhooks.SendVisitorCheckinUpdatedRequest
+    | webhooks.SendVisitorCheckinDestroyedRequest,
+    SDKValidationError | WebhookAuthenticationError
+  >
+> {
+  const request = normalizeRequest(rawRequest);
+  const verifyResult = await client._verifyWebhook({ request, secret });
+  if (!verifyResult.ok) {
+    return verifyResult;
+  }
+  const jsonString = await request.text();
+  const knownSchemas = [
+    webhooks.sendVendorCreatedRequestFromJSON,
+    webhooks.sendVendorUpdatedRequestFromJSON,
+    webhooks.sendVendorDestroyedRequestFromJSON,
+    webhooks.sendTargetFacilityStatusChangeCreatedRequestFromJSON,
+    webhooks.sendTargetFacilityStatusChangeUpdatedRequestFromJSON,
+    webhooks.sendTargetFacilityStatusChangeDestroyedRequestFromJSON,
+    webhooks.sendVendorScanCreatedRequestFromJSON,
+    webhooks.sendVendorScanUpdatedRequestFromJSON,
+    webhooks.sendVendorScanDestroyedRequestFromJSON,
+    webhooks.sendVisitorCheckinCreatedRequestFromJSON,
+    webhooks.sendVisitorCheckinUpdatedRequestFromJSON,
+    webhooks.sendVisitorCheckinDestroyedRequestFromJSON,
+  ];
+
+  for (const schema of knownSchemas) {
+    const ret = schema(jsonString);
+    if (ret.ok) {
+      return ret;
+    }
+  }
+
+  return ERR(
+    new SDKValidationError(
+      "No matching schema found for the given webhook payload",
+      jsonString,
+      jsonString,
+    ),
+  );
+}
+
+function normalizeRequest(
+  request: {
+    body: BodyInit;
+    method: string;
+    url: string;
+    headers: Record<string, string> | Headers;
+  } | Request,
+): Request {
+  if (request instanceof Request) {
+    return request;
+  }
+  return new Request(request.url, request);
+}