@crowdstrike/aidr 1.0.2

package/src/internal/request-options.ts

@@ -0,0 +1,57 @@
+import type { HeadersLike } from './headers';
+import type { HTTPMethod } from './types';
+
+export type RequestOptions = {
+  /** Query parameters to include in the request URL. */
+  query?: object | undefined | null;
+
+  /**
+   * The request body. Can be a string, JSON object, FormData, or other
+   * supported types.
+   */
+  body?: unknown;
+
+  /**
+   * The maximum number of times that the client will retry a request in case of
+   * a temporary failure, like a network error or a 5XX error from the server.
+   *
+   * @default 2
+   */
+  maxRetries?: number;
+
+  /**
+   * The maximum number of times that the client will poll for an async request
+   * result when receiving a HTTP/202 response.
+   *
+   * @default 5
+   */
+  maxPollingAttempts?: number;
+
+  /**
+   * The maximum amount of time (in milliseconds) that the client should wait
+   * for a response from the server before timing out a single request.
+   *
+   * @unit milliseconds
+   */
+  timeout?: number;
+
+  /**
+   * Template for constructing the base URL for API requests. The placeholder
+   * `{SERVICE_NAME}` will be replaced with the service name slug.
+   */
+  baseURLTemplate?: string;
+
+  /**
+   * HTTP headers to include with the request. Can be a Headers object, plain
+   * object, or array of tuples.
+   */
+  headers?: HeadersLike;
+
+  /** An AbortSignal that can be used to cancel the request. */
+  signal?: AbortSignal | undefined | null;
+};
+
+export type FinalRequestOptions = RequestOptions & {
+  method: HTTPMethod;
+  path: string;
+};

package/src/internal/types.ts

@@ -0,0 +1,3 @@
+export type PromiseOrValue<T> = T | Promise<T>;
+export type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
+export type FinalizedRequestInit = RequestInit & { headers: Headers };

package/src/internal/utils/sleep.ts

@@ -0,0 +1,3 @@
+export function sleep(ms: number): Promise<void> {
+  return new Promise<void>((resolve) => setTimeout(resolve, ms));
+}

package/src/internal/utils/values.ts

@@ -0,0 +1,38 @@
+import * as Errors from '../../core/error';
+
+const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
+
+export function isAbsoluteURL(url: string): boolean {
+  return startsWithSchemeRegexp.test(url);
+}
+
+export function stringifyQuery(query: Record<string, unknown>): string {
+  return Object.entries(query)
+    .filter(([_, value]) => typeof value !== 'undefined')
+    .map(([key, value]) => {
+      if (
+        typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean'
+      ) {
+        return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
+      }
+      if (value === null) {
+        return `${encodeURIComponent(key)}=`;
+      }
+      throw new Errors.AIDRError(
+        `Cannot stringify type ${typeof value}; Expected string, number, boolean, or null.`
+      );
+    })
+    .join('&');
+}
+
+export let isArray = (val: unknown): val is unknown[] =>
+  (
+    // biome-ignore lint/suspicious/noAssignInExpressions: matches upstream.
+    // biome-ignore lint/complexity/noCommaOperator: matches upstream.
+    (isArray = Array.isArray), isArray(val)
+  );
+export const isReadonlyArray = isArray as (
+  val: unknown
+) => val is readonly unknown[];