warp-hr 0.0.2

package/src/internal/utils/values.ts

@@ -0,0 +1,105 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { WarpHrError } from '../../core/error';
+
+// https://url.spec.whatwg.org/#url-scheme-string
+const startsWithSchemeRegexp = /^[a-z][a-z0-9+.-]*:/i;
+
+export const isAbsoluteURL = (url: string): boolean => {
+  return startsWithSchemeRegexp.test(url);
+};
+
+export let isArray = (val: unknown): val is unknown[] => ((isArray = Array.isArray), isArray(val));
+export let isReadonlyArray = isArray as (val: unknown) => val is readonly unknown[];
+
+/** Returns an object if the given value isn't an object, otherwise returns as-is */
+export function maybeObj(x: unknown): object {
+  if (typeof x !== 'object') {
+    return {};
+  }
+
+  return x ?? {};
+}
+
+// https://stackoverflow.com/a/34491287
+export function isEmptyObj(obj: Object | null | undefined): boolean {
+  if (!obj) return true;
+  for (const _k in obj) return false;
+  return true;
+}
+
+// https://eslint.org/docs/latest/rules/no-prototype-builtins
+export function hasOwn<T extends object = object>(obj: T, key: PropertyKey): key is keyof T {
+  return Object.prototype.hasOwnProperty.call(obj, key);
+}
+
+export function isObj(obj: unknown): obj is Record<string, unknown> {
+  return obj != null && typeof obj === 'object' && !Array.isArray(obj);
+}
+
+export const ensurePresent = <T>(value: T | null | undefined): T => {
+  if (value == null) {
+    throw new WarpHrError(`Expected a value to be given but received ${value} instead.`);
+  }
+
+  return value;
+};
+
+export const validatePositiveInteger = (name: string, n: unknown): number => {
+  if (typeof n !== 'number' || !Number.isInteger(n)) {
+    throw new WarpHrError(`${name} must be an integer`);
+  }
+  if (n < 0) {
+    throw new WarpHrError(`${name} must be a positive integer`);
+  }
+  return n;
+};
+
+export const coerceInteger = (value: unknown): number => {
+  if (typeof value === 'number') return Math.round(value);
+  if (typeof value === 'string') return parseInt(value, 10);
+
+  throw new WarpHrError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceFloat = (value: unknown): number => {
+  if (typeof value === 'number') return value;
+  if (typeof value === 'string') return parseFloat(value);
+
+  throw new WarpHrError(`Could not coerce ${value} (type: ${typeof value}) into a number`);
+};
+
+export const coerceBoolean = (value: unknown): boolean => {
+  if (typeof value === 'boolean') return value;
+  if (typeof value === 'string') return value === 'true';
+  return Boolean(value);
+};
+
+export const maybeCoerceInteger = (value: unknown): number | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceInteger(value);
+};
+
+export const maybeCoerceFloat = (value: unknown): number | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceFloat(value);
+};
+
+export const maybeCoerceBoolean = (value: unknown): boolean | undefined => {
+  if (value == null) {
+    return undefined;
+  }
+  return coerceBoolean(value);
+};
+
+export const safeJSON = (text: string) => {
+  try {
+    return JSON.parse(text);
+  } catch (err) {
+    return undefined;
+  }
+};

package/src/internal/utils.ts

@@ -0,0 +1,8 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './utils/values';
+export * from './utils/base64';
+export * from './utils/env';
+export * from './utils/log';
+export * from './utils/uuid';
+export * from './utils/sleep';

package/src/lib/.keep

@@ -0,0 +1,4 @@
+File generated from our OpenAPI spec by Stainless.
+
+This directory can be used to store custom files to expand the SDK.
+It is ignored by Stainless code generation and its content (other than this keep file) won't be touched.

package/src/resource.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/resource instead */
+export * from './core/resource';

package/src/resources/index.ts

@@ -0,0 +1,17 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  TimeOff,
+  type TimeOffListAssignmentsResponse,
+  type TimeOffListBalancesResponse,
+  type TimeOffListRequestsResponse,
+  type TimeOffListAssignmentsParams,
+  type TimeOffListBalancesParams,
+  type TimeOffListRequestsParams,
+} from './time-off/time-off';
+export {
+  Workers,
+  type WorkerRetrieveResponse,
+  type WorkerListResponse,
+  type WorkerListParams,
+} from './workers';

package/src/resources/time-off/index.ts

@@ -0,0 +1,12 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Policies, type PolicyRetrieveResponse, type PolicyListResponse } from './policies';
+export {
+  TimeOff,
+  type TimeOffListAssignmentsResponse,
+  type TimeOffListBalancesResponse,
+  type TimeOffListRequestsResponse,
+  type TimeOffListAssignmentsParams,
+  type TimeOffListBalancesParams,
+  type TimeOffListRequestsParams,
+} from './time-off';

package/src/resources/time-off/policies.ts

@@ -0,0 +1,79 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Policies extends APIResource {
+  retrieve(id: string, options?: RequestOptions): APIPromise<PolicyRetrieveResponse> {
+    return this._client.get(path`/v1/time_off/policies/${id}`, options);
+  }
+
+  list(options?: RequestOptions): APIPromise<PolicyListResponse> {
+    return this._client.get('/v1/time_off/policies', options);
+  }
+}
+
+export interface PolicyRetrieveResponse {
+  id: string;
+
+  description: string | null;
+
+  hoursWorkedPerChunk: number | null;
+
+  isUnlimited: boolean;
+
+  minutesPerChunk: number | null;
+
+  minutesPerPeriod: number | null;
+
+  name: string;
+
+  paid: boolean;
+
+  schedule: 'per_hour_worked' | 'monthly' | 'yearly' | 'unlimited';
+
+  timeOffTypeId: string;
+
+  timeOffTypeName: string;
+
+  unit: 'hour' | 'day';
+}
+
+export type PolicyListResponse = Array<PolicyListResponse.PolicyListResponseItem>;
+
+export namespace PolicyListResponse {
+  export interface PolicyListResponseItem {
+    id: string;
+
+    description: string | null;
+
+    hoursWorkedPerChunk: number | null;
+
+    isUnlimited: boolean;
+
+    minutesPerChunk: number | null;
+
+    minutesPerPeriod: number | null;
+
+    name: string;
+
+    paid: boolean;
+
+    schedule: 'per_hour_worked' | 'monthly' | 'yearly' | 'unlimited';
+
+    timeOffTypeId: string;
+
+    timeOffTypeName: string;
+
+    unit: 'hour' | 'day';
+  }
+}
+
+export declare namespace Policies {
+  export {
+    type PolicyRetrieveResponse as PolicyRetrieveResponse,
+    type PolicyListResponse as PolicyListResponse,
+  };
+}

package/src/resources/time-off/time-off.ts

@@ -0,0 +1,173 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as PoliciesAPI from './policies';
+import { Policies, PolicyListResponse, PolicyRetrieveResponse } from './policies';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+
+export class TimeOff extends APIResource {
+  policies: PoliciesAPI.Policies = new PoliciesAPI.Policies(this._client);
+
+  listAssignments(
+    query: TimeOffListAssignmentsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TimeOffListAssignmentsResponse> {
+    return this._client.get('/v1/time_off/assignments', { query, ...options });
+  }
+
+  listBalances(
+    query: TimeOffListBalancesParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TimeOffListBalancesResponse> {
+    return this._client.get('/v1/time_off/balances', { query, ...options });
+  }
+
+  listRequests(
+    query: TimeOffListRequestsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<TimeOffListRequestsResponse> {
+    return this._client.get('/v1/time_off/requests', { query, ...options });
+  }
+}
+
+export type TimeOffListAssignmentsResponse =
+  Array<TimeOffListAssignmentsResponse.TimeOffListAssignmentsResponseItem>;
+
+export namespace TimeOffListAssignmentsResponse {
+  export interface TimeOffListAssignmentsResponseItem {
+    /**
+     * a string to be decoded into a Date
+     */
+    assignedAt: string;
+
+    legacyWorkerId: string;
+
+    policyId: string;
+  }
+}
+
+export type TimeOffListBalancesResponse = Array<TimeOffListBalancesResponse.TimeOffListBalancesResponseItem>;
+
+export namespace TimeOffListBalancesResponse {
+  export interface TimeOffListBalancesResponseItem {
+    accruedLocked: number;
+
+    accruedUnlocked: number;
+
+    available: number;
+
+    holds: number;
+
+    legacyWorkerId: string;
+
+    policyId: string;
+
+    used: number;
+  }
+}
+
+export type TimeOffListRequestsResponse = Array<TimeOffListRequestsResponse.TimeOffListRequestsResponseItem>;
+
+export namespace TimeOffListRequestsResponse {
+  export interface TimeOffListRequestsResponseItem {
+    id: string;
+
+    /**
+     * a string to be decoded into a Date
+     */
+    createdAt: string;
+
+    /**
+     * a string to be decoded into a Date
+     */
+    endAt: string;
+
+    reason: string | null;
+
+    requestedMinutes: number;
+
+    /**
+     * a string to be decoded into a Date
+     */
+    startAt: string;
+
+    status: 'pending' | 'approved' | 'denied';
+
+    timeOffPolicyId: string;
+
+    /**
+     * The id of the worker.
+     */
+    workerId: string;
+  }
+}
+
+export interface TimeOffListAssignmentsParams {
+  policyIds?: Array<string>;
+
+  workerIds?: Array<string>;
+}
+
+export interface TimeOffListBalancesParams {
+  /**
+   * a string to be decoded into a Date
+   */
+  endDate?: string;
+
+  policyIds?: Array<string>;
+
+  /**
+   * a string to be decoded into a Date
+   */
+  startDate?: string;
+
+  workerIds?: Array<string>;
+}
+
+export interface TimeOffListRequestsParams {
+  /**
+   * a string to be decoded into a Date
+   */
+  endsBefore?: string;
+
+  /**
+   * a string to be decoded into a Date
+   */
+  endsOnOrAfter?: string;
+
+  policyIds?: Array<string>;
+
+  /**
+   * a string to be decoded into a Date
+   */
+  startsBefore?: string;
+
+  /**
+   * a string to be decoded into a Date
+   */
+  startsOnOrAfter?: string;
+
+  statuses?: Array<'pending' | 'approved' | 'denied'>;
+
+  workerIds?: Array<string>;
+}
+
+TimeOff.Policies = Policies;
+
+export declare namespace TimeOff {
+  export {
+    type TimeOffListAssignmentsResponse as TimeOffListAssignmentsResponse,
+    type TimeOffListBalancesResponse as TimeOffListBalancesResponse,
+    type TimeOffListRequestsResponse as TimeOffListRequestsResponse,
+    type TimeOffListAssignmentsParams as TimeOffListAssignmentsParams,
+    type TimeOffListBalancesParams as TimeOffListBalancesParams,
+    type TimeOffListRequestsParams as TimeOffListRequestsParams,
+  };
+
+  export {
+    Policies as Policies,
+    type PolicyRetrieveResponse as PolicyRetrieveResponse,
+    type PolicyListResponse as PolicyListResponse,
+  };
+}

package/src/resources/time-off.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './time-off/index';

package/src/resources/workers.ts

@@ -0,0 +1,137 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import { APIPromise } from '../core/api-promise';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Workers extends APIResource {
+  retrieve(id: string, options?: RequestOptions): APIPromise<WorkerRetrieveResponse> {
+    return this._client.get(path`/v1/workers/${id}`, options);
+  }
+
+  list(
+    query: WorkerListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<WorkerListResponse> {
+    return this._client.get('/v1/workers', { query, ...options });
+  }
+}
+
+export interface WorkerRetrieveResponse {
+  /**
+   * The id of the worker.
+   */
+  id: string;
+
+  businessName: string | null;
+
+  /**
+   * The "ui" name of a worker. If it's a business contractor business name is used.
+   * Otherwise we default to preferred name, then first-last.
+   */
+  displayName: string;
+
+  /**
+   * An email with a reasonably valid regex (shamelessly taken from zod)
+   */
+  email: string;
+
+  /**
+   * A date string in the form YYYY-MM-DD
+   */
+  endDate: string | null;
+
+  firstName: string;
+
+  isBusiness: boolean | null;
+
+  lastName: string;
+
+  position: string;
+
+  preferredName: string | null;
+
+  /**
+   * A date string in the form YYYY-MM-DD
+   */
+  startDate: string;
+
+  status: 'onboarding' | 'active' | 'offboarding' | 'inactive';
+
+  type: 'employee' | 'contractor';
+
+  /**
+   * An email with a reasonably valid regex (shamelessly taken from zod)
+   */
+  workEmail: string | null;
+}
+
+export type WorkerListResponse = Array<WorkerListResponse.WorkerListResponseItem>;
+
+export namespace WorkerListResponse {
+  export interface WorkerListResponseItem {
+    /**
+     * The id of the worker.
+     */
+    id: string;
+
+    businessName: string | null;
+
+    /**
+     * The "ui" name of a worker. If it's a business contractor business name is used.
+     * Otherwise we default to preferred name, then first-last.
+     */
+    displayName: string;
+
+    /**
+     * An email with a reasonably valid regex (shamelessly taken from zod)
+     */
+    email: string;
+
+    /**
+     * A date string in the form YYYY-MM-DD
+     */
+    endDate: string | null;
+
+    firstName: string;
+
+    isBusiness: boolean | null;
+
+    lastName: string;
+
+    position: string;
+
+    preferredName: string | null;
+
+    /**
+     * A date string in the form YYYY-MM-DD
+     */
+    startDate: string;
+
+    status: 'onboarding' | 'active' | 'offboarding' | 'inactive';
+
+    type: 'employee' | 'contractor';
+
+    /**
+     * An email with a reasonably valid regex (shamelessly taken from zod)
+     */
+    workEmail: string | null;
+  }
+}
+
+export interface WorkerListParams {
+  statuses?: Array<'onboarding' | 'active' | 'offboarding' | 'inactive'>;
+
+  types?: Array<'employee' | 'contractor'>;
+
+  workEmail?: string;
+}
+
+export declare namespace Workers {
+  export {
+    type WorkerRetrieveResponse as WorkerRetrieveResponse,
+    type WorkerListResponse as WorkerListResponse,
+    type WorkerListParams as WorkerListParams,
+  };
+}

package/src/resources.ts

@@ -0,0 +1 @@
+export * from './resources/index';

package/src/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  // this config is included in the published src directory to prevent TS errors
+  // from appearing when users go to source, and VSCode opens the source .ts file
+  // via declaration maps
+  "include": ["index.ts"],
+  "compilerOptions": {
+    "target": "ES2015",
+    "lib": ["DOM", "DOM.Iterable", "ES2018"],
+    "moduleResolution": "node"
+  }
+}

package/src/uploads.ts

@@ -0,0 +1,2 @@
+/** @deprecated Import from ./core/uploads instead */
+export * from './core/uploads';

package/src/version.ts

@@ -0,0 +1 @@
+export const VERSION = '0.0.2'; // x-release-please-version

package/uploads.d.mts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/uploads.js";
+//# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/uploads.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("./internal/tslib.js");
+/** @deprecated Import from ./core/uploads instead */
+tslib_1.__exportStar(require("./core/uploads.js"), exports);
+//# sourceMappingURL=uploads.js.map

package/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AACrD,4DAA+B"}

package/uploads.mjs

@@ -0,0 +1,2 @@
+export * from "./core/uploads.mjs";
+//# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}

package/version.d.mts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.0.2";
+//# sourceMappingURL=version.d.mts.map

package/version.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.mts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.0.2";
+//# sourceMappingURL=version.d.ts.map

package/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.VERSION = '0.0.2'; // x-release-please-version
+//# sourceMappingURL=version.js.map

package/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":";;;AAAa,QAAA,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}

package/version.mjs

@@ -0,0 +1,2 @@
+export const VERSION = '0.0.2'; // x-release-please-version
+//# sourceMappingURL=version.mjs.map

package/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,2BAA2B"}