@hardfin/cli 0.1.1-dev.61 → 0.1.1-dev.63

package/dist/{program-CkKf46kC.js → program-DW6GS9xO.js}

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d29068e8-3e79-5da9-aa3a-0c5201101ca3")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="980cc947-6ea9-593a-bdbf-bc8ecfc40c65")}catch(e){}}();
 import { a as defineCommand, i as GLOBAL_FLAGS, r as ExitCode, t as toInvocation } from "./scrub-BZ0egWxC.js";
 import { n as toAnswer$1, r as toCompletion, t as PATH_VALUES } from "./completion-tree-DLC6ARLR.js";
 import { createRequire } from "node:module";
-import { Command, CommanderError, Option } from "commander";
+import { Command, CommanderError, InvalidArgumentError, Option } from "commander";
 import { z } from "zod";
-import { accessSync, chmodSync, closeSync, constants, existsSync, mkdirSync, openAsBlob, openSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync, writeSync } from "node:fs";
+import { accessSync, chmodSync, closeSync, constants, existsSync, mkdirSync, openAsBlob, openSync, readFileSync, readSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync, writeSync } from "node:fs";
 import { basename, delimiter, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { parseEnv } from "node:util";
 import { fileURLToPath } from "node:url";
@@ -106,6 +106,7 @@ function toProgram(root, command, onRun, isSilent) {
 		const option = new Option(`${short}--${flag.name}${value}`, flag.description);
 		if (flag.negatable) program.addOption(new Option(`--no-${flag.name}`, `${flag.description}, turned off`));
 		if (flag.repeatable) option.argParser(collect);
+		if (!flag.repeatable && flag.valueName) option.argParser(toOnce(flag.name));
 		if (flag.defaultValue !== void 0) option.default(flag.defaultValue);
 		program.addOption(option);
 	}
@@ -139,6 +140,15 @@ function toArgumentList(value) {
 	if (Array.isArray(value)) return value.map(String);
 	return value === void 0 ? [] : [toText(value)];
 }
+/** toOnce refuses a flag given a second time. */
+function toOnce(name) {
+	let isGiven = false;
+	return (value) => {
+		if (isGiven) throw new InvalidArgumentError(`--${name} takes one value and is given more than once`);
+		isGiven = true;
+		return value;
+	};
+}
 function collect(value, previous) {
 	return [...previous ?? [], value];
 }
@@ -248,7 +258,7 @@ function toRelease(of) {
 //#endregion
 //#region src/config/settings.ts
 /** The API version this build was written against, sent on every request. */
-const API_VERSION = "2026-09-17";
+const API_VERSION = "2026-10-12";
 /** The file a local build reads its overrides from, in the working directory. */
 const CONFIG_FILE = "config.local.json";
 const DEFAULT_API_URL = "https://api.hardfin.com/v2";
@@ -1490,7 +1500,8 @@ function toDescribed(flag) {
 		schema: toFlagSchema(flag),
 		sends: sent.queryName !== void 0 ? { query: sent.queryName } : sent.jsonPath !== void 0 ? { body: sent.jsonPath } : void 0,
 		element: sent.element,
-		elementTypes: sent.elementTypes
+		elementTypes: sent.elementTypes,
+		elementLists: sent.elementLists
 	};
 	return Object.fromEntries(Object.entries(described).filter(([, value]) => value !== void 0 && value !== false));
 }
@@ -1554,21 +1565,58 @@ var InputFailure = class extends Error {
 		this.name = "InputFailure";
 	}
 };
+/** toStandardInput reads everything piped to the command, however slowly it arrives. */
+function toStandardInput() {
+	const chunks = [];
+	const chunk = Buffer.alloc(65536);
+	const pause = new Int32Array(new SharedArrayBuffer(4));
+	for (;;) {
+		let size;
+		try {
+			size = readSync(0, chunk, 0, chunk.length, null);
+		} catch (error) {
+			const code = error.code;
+			if (code === "EAGAIN") {
+				Atomics.wait(pause, 0, 0, 5);
+				continue;
+			}
+			if (code === "EOF") break;
+			throw error;
+		}
+		if (size === 0) break;
+		chunks.push(Buffer.from(chunk.subarray(0, size)));
+	}
+	return Buffer.concat(chunks).toString("utf8");
+}
+/** The deepest a body may nest, which is far past any the API takes and well short of what Node can copy. */
+const DEEPEST_BODY = 100;
+/** isTooDeep reports whether a value nests past the limit, without recursing into it. */
+function isTooDeep(value) {
+	let level = [value];
+	for (let depth = 0; level.length > 0; depth++) {
+		if (depth > DEEPEST_BODY) return true;
+		level = level.flatMap((entry) => typeof entry === "object" && entry !== null ? Object.values(entry) : []);
+	}
+	return false;
+}
 /** toJSONInput reads the JSON a command was given with --input, from a file or from standard input. */
 function toJSONInput(source) {
 	const name = source === "-" ? "standard input" : source;
 	let text;
 	try {
-		text = readFileSync(source === "-" ? 0 : source, "utf8");
+		text = source === "-" ? toStandardInput() : readFileSync(source, "utf8");
 	} catch {
 		return new InputFailure(`${name} cannot be read`);
 	}
 	if (text.trim() === "") return new InputFailure(`${name} is empty, and a body needs JSON`);
+	let parsed;
 	try {
-		return JSON.parse(text);
+		parsed = JSON.parse(text);
 	} catch {
 		return new InputFailure(`${name} does not hold JSON`);
 	}
+	if (isTooDeep(parsed)) return new InputFailure(`${name} nests more than ${DEEPEST_BODY} levels deep, which no endpoint takes`);
+	return parsed;
 }
 //#endregion
 //#region src/command/operation.ts
@@ -1579,6 +1627,15 @@ function toJSONInput(source) {
 function toEnum(values) {
 	return z.string().transform((value) => values.find((allowed) => allowed.toLowerCase() === value.toLowerCase()) ?? value).pipe(z.enum(values));
 }
+/** A number as a flag spells it, which is digits with an optional sign and fraction. */
+const NUMBER = /^-?\d+(\.\d+)?$/;
+/**
+* toNumber reads a flag's text as a number only when it is spelled as one. Coercing would
+* read an empty value as 0 and 0x5 as 5, and send a number nobody typed.
+*/
+function toNumber(bounds = z.number()) {
+	return z.union([z.number(), z.string().regex(NUMBER).transform(Number)]).pipe(bounds);
+}
 /** The word that clears a field the API takes null for, and the way to send that word as text. */
 const NULL_WORD = "null";
 /**
@@ -1663,11 +1720,13 @@ async function runOperation(operation, input) {
 		writeFailure("missing_flag", `this command needs ${missing.map((flag) => `--${flag.name}`).join(", ")}`, input.isJSON);
 		return ExitCode.USAGE;
 	}
-	const body = toBody(operation, input.flags, given);
-	if (body instanceof Error) {
-		writeFailure("invalid_flag", body.message, input.isJSON);
+	const built = toBody(operation, input.flags, given);
+	if (built instanceof Error) {
+		writeFailure("invalid_flag", built.message, input.isJSON);
 		return ExitCode.USAGE;
 	}
+	const isBareAction = operation.method === "POST" && operation.pathParameters.length > 0 && !operation.upload;
+	const body = built === void 0 && isBareAction && operation.bodyFlags.length > 0 ? {} : built;
 	if (operation.bodyFlags.length > 0 && body === void 0) {
 		writeFailure("empty_request", `this command changes nothing unless a flag is given, such as ${operation.bodyFlags.slice(0, 3).map((flag) => `--${flag.name}`).join(", ")}. Run it with --help for the rest`, input.isJSON);
 		return ExitCode.USAGE;
@@ -1749,6 +1808,7 @@ const NOT_A_KEY = /* @__PURE__ */ new Set([
 /** toPath fills the path template from the positional arguments, in order. */
 function toPath(operation, args) {
 	if (args.length !== operation.pathParameters.length || args.some((argument) => NOT_A_KEY.has(argument))) return;
+	if (args.some((argument) => /[/\\]/.test(argument))) return;
 	let path = operation.path;
 	for (const [index, parameter] of operation.pathParameters.entries()) path = path.replace(`{${parameter.name}}`, encodeURIComponent(args[index] ?? ""));
 	return path;
@@ -1841,6 +1901,7 @@ function toCleared(operation, flags, body) {
 		const flag = operation.bodyFlags.find((entry) => entry.name === name.replace(/^--/, ""));
 		if (!flag) return /* @__PURE__ */ new Error(`--unset names no field called ${name}`);
 		if (!flag.nullable) return /* @__PURE__ */ new Error(`--${flag.name} cannot be cleared, because the API does not accept null for it`);
+		if (flags[toOptionKey(flag.name)] !== void 0) return /* @__PURE__ */ new Error(`--${flag.name} is given a value and also named by --unset, and only one of them can be sent`);
 		set(body, flag.jsonPath, null);
 	}
 	return names.length > 0;
@@ -1850,19 +1911,29 @@ function toElements(flag, values) {
 	const elements = [];
 	for (const value of values) {
 		const element = {};
+		const given = /* @__PURE__ */ new Set();
 		for (const pair of value.split(",")) {
 			const split = pair.indexOf("=");
 			if (split < 1) return /* @__PURE__ */ new Error(`--${flag.name} takes ${flag.element?.join("=, ") ?? ""}=, such as --${flag.name} ${flag.element?.[0] ?? "field"}=value. A value cannot contain a comma`);
 			const isJSON = pair[split - 1] === ":";
 			const key = pair.slice(0, isJSON ? split - 1 : split).trim();
 			if (flag.element && !flag.element.includes(key)) return /* @__PURE__ */ new Error(`--${flag.name} has no field ${key}. It takes ${flag.element.join(", ")}`);
-			if (key in element) return /* @__PURE__ */ new Error(`--${flag.name} names ${key} twice in one element, so which one it takes is not clear`);
+			const isList = flag.elementLists?.includes(key) === true;
+			if (given.has(key) && !isList) return /* @__PURE__ */ new Error(`--${flag.name} names ${key} twice in one element, so which one it takes is not clear`);
+			const clash = [...given].find((other) => key.startsWith(`${other}.`) || other.startsWith(`${key}.`));
+			if (clash) return /* @__PURE__ */ new Error(`--${flag.name} gives both ${clash} and ${key} in one element, and only one of them can be sent`);
+			given.add(key);
 			const value = pair.slice(split + 1).trim();
+			if (isList && !isJSON) {
+				element[key] = [...element[key] ?? [], value];
+				continue;
+			}
 			if (flag.elementUuids?.includes(key) && !z.uuid().safeParse(value).success) return /* @__PURE__ */ new Error(`--${flag.name} needs a UUID for ${key}, such as 3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90, and ${value || "nothing"} is not one`);
 			const types = flag.elementTypes?.[key];
 			const typed = isJSON ? toJSONValue(value, types ?? ["string"]) : toTyped(value, types);
+			if (typed === NOT_TAKEN && types?.some((type) => type === "object" || type === "array")) return /* @__PURE__ */ new Error(`--${flag.name} cannot carry ${key}, which holds more than one value. Send the request body with --input instead`);
 			if (typed === NOT_TAKEN) return /* @__PURE__ */ new Error(`--${flag.name} needs ${toNamedTypes(types ?? ["string"])} for ${key}, and ${value || "nothing"} is not one`);
-			element[key] = typed;
+			set(element, key.split("."), typed);
 		}
 		elements.push(element);
 	}
@@ -1870,7 +1941,6 @@ function toElements(flag, values) {
 }
 /** Marks text that is none of the types a field takes. */
 const NOT_TAKEN = Symbol("not taken");
-const NUMBER = /^-?\d+(\.\d+)?$/;
 /**
 * toTyped reads the text after key= as the type the document gives the field. A field that
 * takes text is sent as typed, whatever it looks like, because 36 may be a serial number. A
@@ -1882,7 +1952,7 @@ function toTyped(text, types) {
 	if (types === void 0 || types.includes("string")) return text;
 	if ((types.includes("integer") || types.includes("number")) && NUMBER.test(text)) {
 		const value = Number(text);
-		if (types.includes("number") || Number.isInteger(value)) return value;
+		if (types.includes("number") || Number.isSafeInteger(value)) return value;
 	}
 	if (types.includes("boolean") && (text === "true" || text === "false")) return text === "true";
 	return NOT_TAKEN;
@@ -3032,7 +3102,7 @@ function toFiles(directory) {
 //#endregion
 //#region src/command/types.generated.ts
 /** API_TYPES is the TypeScript hardfin types prints. */
-const API_TYPES = "// Types for the Hardfin API, version 2026-09-17, generated from its published document.\n// Regenerate them with hardfin types after upgrading the CLI.\n\n/** ApiError is one entry in a response's errors. */\nexport interface ApiError {\n    error: string;\n    statusCode: number;\n}\n\n/** ApiEnvelope is the shape every response takes, with the record or records in data. */\nexport interface ApiEnvelope<T> {\n    data: T;\n    metadata: {\n        errors?: ApiError[] | null;\n        requestId?: string;\n        requestTime?: string;\n        statusCode?: number;\n        pagination?: unknown;\n    };\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ArchivedState = \"all\" | \"false\" | \"true\";\n\nexport type Asset = SparseAsset & AssetLocationData & {\n    /** The asset's cost basis, depreciation, and accounting history. */\n    accounting?: AssetAccountingDetails;\n    /** The asset's recent events, such as shipments and deliveries. */\n    activity?: AssetEvent[];\n    /** A free-form description of the asset. */\n    description?: string | null;\n    /** The number of files attached to the asset. */\n    fileCount?: number;\n    /** The day the asset entered inventory. */\n    inInventoryDate?: string;\n    /** The asset's value for each custom field its item defines. */\n    metadata?: AssetMetadataFieldWrapper[];\n    /** Who owns the asset now. */\n    ownership?: AssetOwnership;\n    /** The project the asset is assigned to, or null when it is unassigned. */\n    project?: SparseProject | null;\n    /** How and when the asset was scrapped, or null when it has not been. */\n    scrappedContext?: AssetScrappedContext | null;\n    /** The number of tickets about the asset. */\n    ticketCount?: number;\n    /** The number of links attached to the asset. */\n    urlLinkCount?: number;\n};\n\nexport interface AssetAccountingDetails {\n    /** The asset's inventory cost basis, before deployment costs, which is what inventory is relieved by when the asset leaves it. */\n    acquisitionCogs?: string | null;\n    /** The asset's share of overhead. */\n    allocatedIndirect?: string | null;\n    /** The problems that keep the asset's accounting from being computed, such as a missing cost basis. */\n    assetExceptions?: AssetExceptionType[];\n    /** The parts cost. */\n    billOfMaterials?: string | null;\n    /** The cost basis on the books now, the acquisition basis in inventory and the deployed basis once the asset is a fixed asset. */\n    capitalizedCosts?: string | null;\n    /** The capitalizations and impairments made to the asset's cost after it was acquired. */\n    costAdjustments?: AssetCostAdjustment[];\n    /** The method the asset is depreciated by. */\n    depreciationModel?: Depreciation;\n    /** The asset's book value month by month, from its inventory month, or null while it has an accounting exception. */\n    depreciationPeriods?: AssetDepreciationChartPeriod[] | null;\n    /** The labor cost to build the asset. */\n    directLabor?: string | null;\n    /** The shipping cost to receive the asset. */\n    freightInbound?: string | null;\n    /** The shipping cost to deploy the asset, a deployment cost. */\n    freightOutbound?: string | null;\n    /** The day the asset was put into service and began depreciating. */\n    inServiceDate?: string | null;\n    /** The cost to install the asset, a deployment cost. */\n    installation?: string | null;\n    /** The financing cost of the asset. */\n    interest?: string | null;\n    /** Whether Hardfin sets the in-service date itself rather than keeping one a person entered. */\n    isInServiceDateManagedAutomatically?: boolean;\n    /** The value the asset keeps at the end of its useful life. */\n    salvageValue?: string | null;\n    /** A single cost entered in place of the cost components. */\n    simpleCostBasis?: string | null;\n    /** The import duty paid on the asset. */\n    tariffs?: string | null;\n    /** The tax paid on the asset. */\n    tax?: string | null;\n    /** The deployed cost basis, including deployment costs, which is what is capitalized once the asset is put into service. */\n    totalPotentialCOGS?: string | null;\n    /** The number of months the asset is depreciated over. */\n    usefulLife?: number | null;\n    /** The changes made to the asset's useful life. */\n    usefulLifeRevisions?: AssetUsefulLifeRevision[];\n}\n\nexport interface AssetCostAdjustment {\n    /** CAPITALIZATION to add to the cost basis, or IMPAIRMENT to write it down. */\n    adjustmentType?: CostAdjustmentType;\n    /** The size of the adjustment. */\n    amount?: string;\n    /** When the adjustment was recorded. */\n    createdAt?: string;\n    /** The person who recorded the adjustment. */\n    createdBy?: SparsePerson;\n    /** The day the adjustment takes effect. */\n    effectiveDate?: string;\n    /** The cost adjustment's key. */\n    key?: string;\n    /** Free-form detail about the adjustment. */\n    notes?: string | null;\n    /** Why the cost changed. */\n    reason?: CostAdjustmentReason;\n}\n\nexport interface AssetDepreciationChartPeriod {\n    /** The depreciation charged from the in-service date through the end of the period. */\n    accumulated?: string;\n    /** The asset's value on the books at the end of the period. */\n    bookValue?: string;\n    /** The last day of the month the period covers. */\n    date?: string;\n    /** The depreciation charged in the period. */\n    depreciation?: string;\n}\n\nexport interface AssetEvent {\n    /** When the event was recorded. */\n    createdAt?: string;\n    /** The IANA time zone the event's times were entered in. */\n    eventTimezone?: string;\n    /** When the event is expected to happen, or null when no one has said. */\n    expectedAt?: string | null;\n    /** The event's unique identifier. */\n    id?: string;\n    /** Whether the event has to happen for its group to complete. */\n    isRequired?: boolean;\n    /** When the event happened, or null while it has not. */\n    occurredAt?: string | null;\n    /** The day the event was promised to a customer, or null when none was. */\n    promiseDate?: string | null;\n    /** The event's values a person set, such as carrier tracking. */\n    properties?: AssetEventProperty[];\n    /** The event's position within its group. */\n    sequence?: number;\n    /** When someone marked the event as happened in Hardfin, or null while it has not happened. */\n    triggeredAt?: string | null;\n    /** What kind of event this is. */\n    type?: AssetEventType;\n}\n\nexport interface AssetEventConfiguration {\n    /** The properties an event of the type carries. */\n    properties?: AssetEventProperty[];\n    /** The kind of event the configuration describes. */\n    type?: AssetEventType;\n}\n\nexport interface AssetEventGroup {\n    /** The kind of group this is, and the events it carries. */\n    configuration?: AssetEventGroupConfiguration;\n    /** Where the movement ends, or null when the group does not move the asset. */\n    destination?: SparseLocationWithParent | null;\n    /** The events the group has recorded so far. */\n    events?: AssetEvent[];\n    /** The event group's unique identifier. */\n    id?: string;\n    /** The event group's key, which the event group endpoints take as eventGroupKey. */\n    key?: string;\n    /** Where the movement started, or null when the group does not move the asset. */\n    origin?: SparseLocationWithParent | null;\n    /** The shipment the movement travels on, or null when it travels on none. */\n    shipment?: SparseShipment | null;\n}\n\nexport interface AssetEventGroupConfiguration {\n    /** The events a group of the kind carries, in the order they happen. */\n    events?: AssetEventConfiguration[];\n    /** The configuration's unique identifier. */\n    id?: string;\n    /** The configuration's key. */\n    key?: string;\n    /** What the configuration is called, such as ship and deliver. */\n    name?: string;\n}\n\nexport interface AssetEventProperty {\n    /** The event property's unique identifier. */\n    id?: string;\n    /** Whether Hardfin sets the property itself rather than a person, which responses leave out. */\n    isSystemProperty?: boolean;\n    /** The property's display name. */\n    label?: string;\n    /** The kind of value the property holds, such as CARRIER_TRACKING or CACHED_LOCATION. */\n    type?: string;\n    /** The property's value, whose JSON shape depends on the property's type. */\n    value?: unknown[] | boolean | number | Record<string, unknown> | string | null;\n}\n\nexport interface AssetEventType {\n    /** The event type's unique identifier. */\n    id?: string;\n    /** The event type's name, such as Ship or Deliver. */\n    name?: string;\n    /** Whether an event of this type only happens as part of a group, such as a shipment. */\n    requiresEventGroup?: boolean;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetExceptionType = \"DEPLOYMENT_WITHOUT_ACQUISITION\" | \"DISPOSAL_DATE_BEFORE_INVENTORY\" | \"FIRST_ASSIGNMENT_BEFORE_INVENTORY\" | \"FIRST_MOVEMENT_BEFORE_INVENTORY\" | \"FIRST_SALE_DATE_BEFORE_INVENTORY\" | \"IN_SERVICE_DATE_BEFORE_INVENTORY\" | \"MISSING_COST_BASIS\" | \"MISSING_USEFUL_LIFE\" | \"SALVAGE_EXCEEDS_50_PERCENT\" | \"UNKNOWN\";\n\nexport interface AssetFile {\n    /** The file's unique identifier. */\n    id?: string;\n    /** Whether the file is readable with any organization's API key. */\n    isPublic?: boolean;\n    /** The file's key, which the file endpoints take as fileKey. */\n    key?: string;\n    /** The file's media type, or an empty string when the upload named none. */\n    mimeType?: string;\n    /** The name the file had when it was uploaded. */\n    name?: string;\n    /** The file's size in bytes. */\n    size?: number;\n    /** The file type the file was uploaded as. */\n    type?: string;\n    /** When the file was uploaded. */\n    uploadedAt?: string;\n}\n\n/** Whether an asset works, is broken, awaits review, or has been scrapped. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetFunctionalStatus = \"FUNCTIONAL\" | \"NEEDS_REVIEW\" | \"NON-FUNCTIONAL\" | \"SCRAPPED\";\n\nexport interface AssetFunctionalStatusHistoryItem {\n    /** When the asset left the status, or null while it still holds it. */\n    end?: string | null;\n    /** When the asset took the status. */\n    start?: string;\n    /** Whether the asset worked, was broken, awaited review, or had been scrapped through the period. */\n    status?: AssetFunctionalStatus;\n}\n\nexport interface AssetListing {\n    /** The page of records. */\n    results?: Asset[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface AssetLocationData {\n    /** Where the asset is, or null while it is in transit. */\n    currentLocation?: SparseLocationWithParent | null;\n    /** Whether the asset has shipped and not yet been delivered. */\n    inTransit?: boolean;\n    /** Where a planned or in-progress move takes the asset, or null when none is planned. */\n    nextLocation?: SparseLocationWithParent | null;\n    /** The location the asset was at before its current one, or null when it has not moved. */\n    previousLocation?: SparseLocationWithParent | null;\n}\n\nexport interface AssetMetadataField {\n    /** The item field's unique identifier. */\n    id?: string;\n    /** The item field's key. */\n    key?: string;\n    /** The field's display name. */\n    label?: string;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n    /** The kind of value the field holds, which decides the JSON type of its value. */\n    type?: ItemFieldType;\n}\n\nexport type AssetMetadataFieldWrapper = {\n    field?: {\n        type?: \"BOOLEAN\";\n    };\n    value?: boolean | null;\n} | {\n    field?: {\n        type?: \"DATE\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"DATE_TIME\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"INTEGER\";\n    };\n    value?: number | null;\n} | {\n    field?: {\n        type?: \"MULTILINE_TEXT\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"NUMBER\";\n    };\n    value?: number | null;\n} | {\n    field?: {\n        type?: \"TEXT\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"TIME\";\n    };\n    value?: string | null;\n};\n\nexport interface AssetMoveToPlan {\n    /** The ID of the asset to move. */\n    assetId?: string;\n    /** When the asset reaches its destination, or null when the move only ships. */\n    deliverAt?: string | null;\n    /** The client's own name for the move, which the plan echoes back beside its answer. */\n    id?: string;\n    /** When the asset leaves its origin, or null when the move only delivers. */\n    shipAt?: string | null;\n}\n\nexport interface AssetOwnership {\n    /** The customer that owns the asset, or null when your organization owns it. */\n    customer?: SparseCustomer | null;\n    /** The day the asset's current owner took ownership, or null when its ownership has never changed. */\n    ownershipChangeDate?: string | null;\n}\n\nexport interface AssetOwnershipHistoryItem {\n    /** When the segment was recorded. */\n    createdAt?: string;\n    /** The customer that owned the asset during the segment, or null when your organization did. */\n    customer?: SparseCustomer | null;\n    /** The day the segment's owner took ownership. */\n    date?: string;\n    /** The ownership segment's unique identifier. */\n    id?: string;\n    /** The ownership segment's key, which the segment endpoints take as segmentKey. */\n    key?: string;\n    /** When the segment was last changed. */\n    lastModifiedAt?: string;\n    /** What the owner paid for the asset, or null when no price was recorded. */\n    salePrice?: string | null;\n}\n\nexport interface AssetPlannedIntersection {\n    /** The ID of the event group the move would collide with, or null when none names one. */\n    aegId?: string | null;\n    /** The key of the event group the move would collide with, or null when none names one. */\n    aegKey?: string | null;\n    /** When the colliding movement ends, or null while it has no end. */\n    end?: string | null;\n    /** When the colliding movement starts. */\n    start?: string;\n}\n\nexport interface AssetPlannedMove {\n    /** The client's own name for the move, echoed from the plan it asked about. */\n    id?: string;\n    /** The movement the move would collide with, or null when it collides with none. */\n    intersection?: AssetPlannedIntersection | null;\n    /** Whether the move can be carried out as asked. */\n    isValid?: boolean;\n}\n\nexport interface AssetProposedMultiMove {\n    /** The ID of the asset to move. */\n    assetId?: string;\n    /** When the asset reaches its destination, which a move sends unless it ships. */\n    deliverAt?: string | null;\n    /** The timezone the delivery time was entered in, or null for the organization's. */\n    deliverAtTimezone?: string | null;\n    /** The ID of the location the asset arrives at. */\n    destinationId?: string;\n    /** The ID of the location the asset leaves. */\n    originId?: string;\n    /** When the asset leaves its origin, which a move sends unless it delivers. */\n    shipAt?: string | null;\n    /** The timezone the ship time was entered in, or null for the organization's. */\n    shipAtTimezone?: string | null;\n}\n\nexport interface AssetScrappedContext {\n    /** The day the asset was scrapped. */\n    disposalDate?: string;\n    /** What the scrapped asset was sold for, or null when it was not sold. */\n    disposalPrice?: string | null;\n    /** Why the asset was scrapped. */\n    disposalReason?: string | null;\n}\n\nexport interface AssetUpdateMetadataItem {\n    /** The ID of the item field to set on the asset. */\n    fieldId?: string;\n    /** The field's new value, in the JSON type the field's type calls for, or null to clear it. */\n    value?: unknown[] | boolean | number | Record<string, unknown> | string | null;\n}\n\nexport interface AssetUsefulLifeRevision {\n    /** When the revision was recorded. */\n    createdAt?: string;\n    /** The person who recorded the revision. */\n    createdBy?: SparsePerson;\n    /** The day the new useful life takes effect. */\n    effectiveDate?: string;\n    /** The revision's key. */\n    key?: string;\n    /** Free-form detail about the revision. */\n    notes?: string | null;\n    /** Why the useful life changed. */\n    reason?: UsefulLifeRevisionReason;\n    /** The asset's new useful life in months. */\n    usefulLifeMonths?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingFrequency = \"ANNUALLY\" | \"BIENNIALLY\" | \"BIWEEKLY\" | \"DAILY\" | \"MONTHLY\" | \"ONCE\" | \"QUADRENNIALLY\" | \"QUARTERLY\" | \"QUINQUENNIALLY\" | \"SEMIANNUALLY\" | \"TRIENNIALLY\" | \"WEEKLY\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingSchedule = \"MILESTONE\" | \"PERIODIC\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingTiming = \"ADVANCE\" | \"ARREARS\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostAdjustmentReason = \"ADDITION\" | \"BETTERMENT\" | \"DAMAGE\" | \"INSTALLATION\" | \"LIFE_EXTENSION\" | \"MARKET_DECLINE\" | \"OBSOLESCENCE\" | \"OTHER\" | \"REGULATORY\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostAdjustmentType = \"CAPITALIZATION\" | \"IMPAIRMENT\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostBasisMode = \"ADVANCED\" | \"SIMPLE\" | null;\n\n/** The kind of credential a request was made with. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `API_KEY` | An API key, for an integration that runs unattended | | `OAUTH` | An OAuth access token, issued to an application a person connected | | `SESSION` | A person signed in to Hardfin in a browser | */\nexport type CredentialType = \"API_KEY\" | \"OAUTH\" | \"SESSION\";\n\nexport interface Currency {\n    /** The value as a decimal string with two decimal places. */\n    amount?: string;\n    /** The value's ISO 4217 currency code. */\n    isoCode?: string;\n}\n\nexport type Customer = SparseCustomer & {\n    /** The number of the customer's active projects. */\n    activeProjectCt?: number;\n    /** The number of assets the customer owns. */\n    assetCount?: number;\n    /** The number of assets at the customer's locations. */\n    assetsAtLocation?: number;\n    /** The address invoices are sent to. */\n    billingAddress?: string | null;\n    /** The person who receives the customer's invoices. */\n    billingContact?: CustomerBillingContact | null;\n    /** A free-form note about the customer. */\n    comment?: string | null;\n    /** The customer's web domain, used to look up its logo. */\n    domain?: string | null;\n    /** The customer's identifier in another system. */\n    externalId?: string | null;\n    /** The number of the customer's incomplete projects. */\n    incompleteProjectCt?: number;\n    /** The customer's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** The number of the customer's locations. */\n    locationCount?: number;\n    /** The customer's locations. */\n    locations?: SparseLocationWithParent[];\n    /** The storage key of the customer's logo file. */\n    logoFileKey?: string | null;\n    /** The number of the customer's past projects. */\n    pastProjectCt?: number;\n    /** The number of the customer's upcoming projects. */\n    upcomingProjectCt?: number;\n};\n\nexport interface CustomerBillingContact {\n    /** The billing contact's email address. */\n    email?: string | null;\n    /** The billing contact's name. */\n    name?: string | null;\n    /** The billing contact's phone number. */\n    phone?: string | null;\n}\n\nexport interface CustomerListing {\n    /** The page of records. */\n    results?: Customer[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type Depreciation = \"DOUBLE_DECLINING\" | \"STRAIGHT_LINE\" | \"SUM_YEAR\" | \"UNIT_OF_PRODUCTION\" | null;\n\nexport interface Error {\n    error: string;\n    statusCode: number;\n}\n\nexport interface FileNewUpload {\n    /** The uploaded file's unique identifier. */\n    fileId?: string;\n    /** The uploaded file's key, which the file endpoints take as fileKey. */\n    fileKey?: string;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FrontendItemType = \"BULK\" | \"DEVICE\" | \"SERVICE\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type IntegrationCategory = \"CRM\" | \"ERP\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type IntegrationID = \"HUBSPOT\" | \"NETSUITE\" | \"NONE\" | \"QBO\" | \"SFDC\";\n\nexport interface Item {\n    /** Whether a BULK item records serial numbers on its units, which is false for SERVICE and DEVICE items. */\n    acceptsBulkSerials?: boolean;\n    /** The number of assets of a DEVICE item, and null for other types. */\n    assetCount?: number | null;\n    /** A free-form description of the item. */\n    description?: string | null;\n    /** The item's unique identifier. */\n    id?: string;\n    /** The item's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** When the item was last changed. */\n    lastUpdatedAt?: string | null;\n    /** The person who last changed the item. */\n    lastUpdatedBy?: SparsePerson;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n}\n\nexport interface ItemAccounting {\n    /** The default share of overhead for one unit. */\n    allocatedIndirect?: string | null;\n    /** The default parts cost for one unit. */\n    billOfMaterials?: string | null;\n    /** The default method one unit is depreciated by. */\n    depreciationModel?: Depreciation;\n    /** The default labor cost to build one unit. */\n    directLabor?: string | null;\n    /** The default shipping cost to receive one unit. */\n    freightInbound?: string | null;\n    /** The default shipping cost to deliver one unit. */\n    freightOutbound?: string | null;\n    /** The default cost to install one unit. */\n    installation?: string | null;\n    /** The default financing cost for one unit. */\n    interest?: string | null;\n    /** The default value one unit keeps at the end of its useful life. */\n    salvageValue?: string | null;\n    /** A single default cost for one unit, used instead of the cost components. */\n    simpleCostBasis?: string | null;\n    /** The default import duty paid on one unit. */\n    tariffs?: string | null;\n    /** The default tax paid on one unit. */\n    tax?: string | null;\n    /** The default cost of goods sold for one unit, which is the simple cost basis when set and otherwise the sum of the cost components. */\n    totalCOGS?: string | null;\n    /** The default number of months one unit is depreciated over. */\n    usefulLife?: number | null;\n}\n\nexport interface ItemBOMItem {\n    /** The BULK part the bill of materials uses. */\n    item?: SparseItem;\n    /** The number of the part one unit of the item uses. */\n    quantity?: number;\n}\n\nexport interface ItemDetail {\n    /** Whether a BULK item records serial numbers on its units, which is false for SERVICE and DEVICE items. */\n    acceptsBulkSerials?: boolean;\n    /** The default costs and depreciation for a unit of a DEVICE or BULK item. */\n    accounting?: ItemAccounting;\n    /** The number of assets of a DEVICE item, and null for other types. */\n    assetCount?: number | null;\n    /** The bill of materials, the BULK parts one unit of the item is built from, or null when it has none. */\n    bom?: ItemBOMItem[] | null;\n    /** The pricing a project line item's billing plan starts from when it sells the item, or null when the item has none. */\n    defaultPricing?: ItemPricing | null;\n    /** A free-form description of the item. */\n    description?: string | null;\n    /** The custom fields each asset of a DEVICE item can hold. */\n    fields?: ItemField[];\n    /** Whether each unit of the item is tracked as its own asset, which is true for a DEVICE item. */\n    hasAssets?: boolean;\n    /** The item's unique identifier. */\n    id?: string;\n    /** The item's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** The number of inventory movements of a BULK item, and null for other types. */\n    inventoryMovementCount?: number | null;\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** Whether the item is physical, which is true for DEVICE and BULK items. */\n    isPhysical?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** When the item was last changed. */\n    lastUpdatedAt?: string | null;\n    /** The person who last changed the item. */\n    lastUpdatedBy?: SparsePerson;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n}\n\nexport interface ItemField {\n    /** The field's unique identifier. */\n    id?: string;\n    /** The field's key, which the item field endpoints take as fieldKey. */\n    key?: string;\n    /** The field's display name. */\n    label?: string;\n    /** The number of assets that hold a value for the field. */\n    metadataCount?: number;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n    /** The kind of value the field holds. */\n    type?: ItemFieldType;\n}\n\nexport interface ItemFieldOrderingUpdateItem {\n    /** The ID of the item field to move. */\n    fieldId?: string;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n}\n\n/** The kind of value an item's custom field holds. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ItemFieldType = \"BOOLEAN\" | \"DATE\" | \"DATE_TIME\" | \"INTEGER\" | \"MULTILINE_TEXT\" | \"NUMBER\" | \"TEXT\" | \"TIME\";\n\nexport interface ItemListing {\n    /** The page of records. */\n    results?: Item[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface ItemPricing {\n    /** How often a PERIODIC charge recurs. */\n    chargeFrequency?: BillingFrequency | null;\n    /** PERIODIC to charge on a recurring cadence, or MILESTONE to charge when a milestone is reached. */\n    chargeSchedule?: BillingSchedule | null;\n    /** The default price for the whole line, used when pricingMode is FIXED. */\n    fixedPrice?: Currency | null;\n    /** How often the charges are invoiced. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends. */\n    invoiceMode?: BillingTiming | null;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price for the line whatever its quantity. */\n    pricingMode?: PricingMode | null;\n    /** The default price for each unit, used when pricingMode is PER_UNIT. */\n    unitPrice?: Currency | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ItemType = \"marked_bulk\" | \"service\" | \"tracked_device\" | \"unmarked_bulk\";\n\nexport type Location = SparseLocationWithIntegration & {\n    /** The number of active projects at the location. */\n    activeProjectCount?: number;\n    /** The number of assets currently at the location. */\n    assetCount?: number;\n    /** The number of incomplete projects at the location. */\n    incompleteProjectCount?: number;\n    /** The number of past projects at the location. */\n    pastProjectCount?: number;\n    /** The number of upcoming projects at the location. */\n    upcomingProjectCount?: number;\n};\n\nexport interface LocationListing {\n    /** The page of records. */\n    results?: Location[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type LocationType = \"SITE\" | \"UNKNOWN\" | \"ZONE\" | null;\n\nexport interface Metadata {\n    errors: Error[] | null;\n    /** The identifier to quote when asking Hardfin about this request. */\n    requestId: string;\n    /** How long the server took to answer. */\n    requestTime: string;\n    statusCode: number;\n}\n\nexport interface MetadataLocationComponents {\n    /** The first line of the street address. */\n    addressLine1?: string | null;\n    /** The second line of the street address, such as a suite. */\n    addressLine2?: string | null;\n    /** The city. */\n    city?: string | null;\n    /** The country. */\n    country?: string | null;\n    /** The whole address on one line. */\n    formattedAddress?: string | null;\n    /** The postal or ZIP code. */\n    postalCode?: string | null;\n    /** The state or region. */\n    state?: string | null;\n}\n\nexport interface MetadataLocationSite {\n    /** The location's structured address, which a zone reads from its parent site. */\n    address?: MetadataLocationComponents | null;\n    /** Google's place ID for the address, when it was found through Google. */\n    googlePlaceId?: string | null;\n    /** The location's latitude, sent as a decimal string. */\n    latitude?: string | null;\n    /** The location's longitude, sent as a decimal string. */\n    longitude?: string | null;\n    /** The person or business that receives shipments at the location. */\n    shippingName?: string | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type PricingMode = \"FIXED\" | \"PER_UNIT\";\n\n/** The item type a request asks an item to become. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type RequestedItemType = \"BULK\" | \"DEVICE\" | \"SERVICE\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ScrappedState = \"all\" | \"false\" | \"true\";\n\nexport interface SharedBool {\n    /** Whether the operation completed. */\n    success?: boolean;\n}\n\nexport interface SharedIntegration {\n    /** The Hardfin error code of the failed sync, or null when the sync did not fail. */\n    errorCode?: number | null;\n    /** The integrated system, such as SFDC or HUBSPOT. */\n    id?: IntegrationID;\n    /** Whether the last sync with the external system failed. */\n    inError?: boolean;\n    /** Whether a sync with the external system is pending. */\n    isSyncing?: boolean;\n    /** The system's display name. */\n    label?: string;\n    /** A URL to the linked record in the external system. */\n    link?: string | null;\n    /** Whether the record differs from the external system and needs a person to review it. */\n    needsReview?: boolean;\n    /** The kind of system, CRM or ERP. */\n    type?: IntegrationCategory;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type SortOrder = \"ASC\" | \"DESC\";\n\nexport interface SparseAsset {\n    /** Whether the asset works, is broken, awaits review, or has been scrapped. */\n    functionalStatus?: AssetFunctionalStatus;\n    /** The asset's unique identifier. */\n    id?: string;\n    /** The day the asset entered inventory. */\n    inInventoryDate?: string;\n    /** Whether the asset is archived. */\n    isArchived?: boolean;\n    /** Whether the asset has shipped and not yet been delivered. */\n    isInTransit?: boolean;\n    /** The catalog item the asset is a unit of. */\n    item?: SparseItem;\n    /** The asset's key, which the asset endpoints take as assetKey. */\n    key?: string;\n    /** The asset's serial number, unique within its item. */\n    serial?: string;\n}\n\nexport interface SparseCustomer {\n    /** The customer's unique identifier. */\n    id?: string;\n    /** Whether the customer is archived. */\n    isArchived?: boolean;\n    /** Whether the company is a customer. */\n    isCustomer?: boolean;\n    /** Whether the company is a supplier. */\n    isSupplier?: boolean;\n    /** The customer's key, which the customer endpoints take as customerKey. */\n    key?: string;\n    /** The customer's display name. */\n    name?: string;\n}\n\nexport interface SparseItem {\n    /** Whether each unit of the item is tracked as its own asset, which is true for a DEVICE item. */\n    hasAssets?: boolean;\n    /** The item's unique identifier. */\n    id?: string;\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** Whether the item is physical, which is true for DEVICE and BULK items. */\n    isPhysical?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n    /** The unit the item's quantities are counted in. */\n    unitOfMeasure?: UnitOfMeasure;\n}\n\nexport type SparseLocation = MetadataLocationSite & {\n    /** The number of archived zones at a site. */\n    archivedZoneCount?: number;\n    /** The customer a zone is designated for, such as for reservations, provisioning or a 3PL. */\n    consignee?: SparseCustomer | null;\n    /** The customer the location is assigned to, which a zone reads from its parent site, or null for your organization's own locations. */\n    customer?: SparseCustomer | null;\n    /** A free-form description of a zone. */\n    description?: string | null;\n    /** The location's unique identifier. */\n    id?: string;\n    /** Whether the location is archived. */\n    isArchived?: boolean;\n    /** Whether assets at the location count as inventory for reporting. */\n    isInventory?: boolean;\n    /** Whether a zone sets its own isInventory rather than inheriting its parent site's. */\n    isInventoryOverride?: boolean;\n    /** Whether a third-party logistics (3PL) provider fulfills orders from the location. */\n    isThirdPartyEnabled?: boolean;\n    /** Whether assets make only occasional or temporary stops at the location, which hides it from location lists by default. */\n    isTransient?: boolean;\n    /** The location's key, which the location endpoints take as locationKey. */\n    key?: string;\n    /** The location's display name. */\n    name?: string;\n    /** The 3PL provider's identifier for the location. */\n    thirdPartyIdentifier?: string | null;\n    /** SITE for a site, or ZONE for a zone within a site. */\n    type?: LocationType;\n    /** The number of zones at a site. */\n    zoneCount?: number;\n    /** The site's zones. */\n    zones?: SparseZone[];\n};\n\nexport type SparseLocationWithIntegration = SparseLocationWithParent & {\n    /** The location's links to integrated systems. */\n    integrations?: SharedIntegration[];\n};\n\nexport type SparseLocationWithParent = SparseLocation & {\n    /** The site a zone belongs to, or null for a site. */\n    parentLocation?: SparseLocation | null;\n};\n\nexport interface SparseOrganization {\n    /** The organization's ID */\n    id?: string;\n    /** The public identifier that can be used in URLs */\n    key?: string;\n    /** The name of the organization */\n    name?: string;\n}\n\nexport interface SparsePerson {\n    /** The person's first name. */\n    firstName?: string | null;\n    /** The person's unique identifier. */\n    id?: string;\n    /** The person's key. */\n    key?: string;\n    /** The person's last name. */\n    lastName?: string | null;\n}\n\nexport interface SparseProject {\n    /** The customer the project is for. */\n    customer?: SparseCustomer | null;\n    /** The day the project ends. */\n    end?: string | null;\n    /** The project's unique identifier. */\n    id?: string;\n    /** The project's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** Whether the project is archived. */\n    isArchived?: boolean;\n    /** The project's key. */\n    key?: string;\n    /** The project's display name. */\n    name?: string;\n    /** The name of the project's payment term. */\n    paymentTermLabel?: string | null;\n    /** The customer's purchase order number, which new invoices for the project carry. */\n    purchaseOrderNumber?: string | null;\n    /** The day the project starts. */\n    start?: string | null;\n    /** Whether the project is upcoming, active, or past, judged from its dates. */\n    status?: string;\n}\n\nexport interface SparseShipment {\n    /** When the shipment arrived, or null while it has not. */\n    deliveredAt?: string | null;\n    /** The shipment's unique identifier. */\n    id?: string;\n    /** The shipment's key. */\n    key?: string;\n    /** The number the shipment is known by. */\n    shipmentNumber?: string;\n    /** What kind of movement the shipment carries. */\n    shipmentType?: string;\n    /** When the shipment left, or null while it has not. */\n    shippedAt?: string | null;\n}\n\nexport interface SparseZone {\n    /** The number of assets in the zone. */\n    assetCount?: number;\n    /** The customer the zone is designated for, such as for reservations, provisioning or a 3PL. */\n    consignee?: SparseCustomer | null;\n    /** A free-form description of the zone. */\n    description?: string | null;\n    /** The zone's unique identifier. */\n    id?: string;\n    /** Whether the zone is archived. */\n    isArchived?: boolean;\n    /** Whether assets in the zone count as inventory for reporting. */\n    isInventory?: boolean;\n    /** The zone's key. */\n    key?: string;\n    /** The zone's display name, unique within its site. */\n    name?: string;\n}\n\nexport interface Token {\n    /** When the API key was created, the application was connected, or the person signed in. */\n    createdAt?: string;\n    /** When the access token or session expires, or null for an API key, which does not. */\n    expiresAt?: string | null;\n    /** The API key's public identifier or the application's client_id, or null for a session. */\n    identifier?: string | null;\n    /** The API key's label or the application's name, or null when there is none. */\n    label?: string | null;\n    /** When the API key was last regenerated or the access token was issued, or null for a session. */\n    lastRegeneratedAt?: string | null;\n    /** The organization the credential acts in. */\n    organization?: SparseOrganization;\n    /** The person the credential acts for. */\n    person?: SparsePerson;\n    scopes?: string[];\n    /** The kind of credential. */\n    type?: CredentialType;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type TransientState = \"all\" | \"false\" | \"true\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type TransitStatus = \"IN_TRANSIT\" | \"IN_TRANSIT_TO_FIELD\" | \"IN_TRANSIT_TO_INVENTORY\" | \"NOT_IN_TRANSIT\";\n\nexport interface URLLink {\n    /** When the link was created. */\n    createdAt?: string;\n    /** The URL link's unique identifier. */\n    id?: string;\n    /** The URL link's key, which the URL link endpoints take as linkKey. */\n    key?: string;\n    /** The link's display name, or null when the link shows its address instead. */\n    name?: string | null;\n    /** When the link was last changed. */\n    updatedAt?: string;\n    /** The address the link points to. */\n    url?: string;\n}\n\n/** The unit a quantity is counted in, sent as its UNECE Recommendation 20 code. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `BG` | Bag | | `BO` | Bottle | | `BX` | Box | | `C62` | Unit | | `CMK` | Square centimeter (cm2) | | `CMT` | Centimeter (cm) | | `CR` | Crate | | `CS` | Case | | `CT` | Carton | | `DMQ` | Cubic decimeter (dm3) | | `DR` | Drum | | `DZN` | Dozen (doz) | | `EA` | Each (ea) | | `EN` | Envelope | | `FOT` | Foot (ft) | | `FTK` | Square foot (ft2) | | `FTQ` | Cubic foot (ft3) | | `GLL` | Gallon (gal) | | `GRM` | Gram (g) | | `GRO` | Gross | | `H87` | Piece (pc) | | `INH` | Inch (in) | | `INK` | Square inch (in2) | | `INQ` | Cubic inch (in3) | | `KG` | Keg | | `KGM` | Kilogram (kg) | | `KMT` | Kilometer (km) | | `KT` | Kit | | `LBR` | Pound (lb) | | `LO` | Lot | | `LTR` | Liter (L) | | `MGM` | Milligram (mg) | | `MLT` | Milliliter (mL) | | `MMK` | Square millimeter (mm2) | | `MMT` | Millimeter (mm) | | `MTK` | Square meter (m2) | | `MTQ` | Cubic meter (m3) | | `MTR` | Meter (m) | | `ONZ` | Ounce (oz) | | `OZA` | Fluid ounce (fl oz) | | `PK` | Pack | | `PR` | Pair (pr) | | `PTI` | Pint (pt) | | `PX` | Pallet | | `QTI` | Quart (qt) | | `RL` | Reel | | `RO` | Roll | | `SET` | Set | | `SMI` | Mile (mi) | | `ST` | Sheet | | `STN` | Ton US (NT) | | `SV` | Skid | | `TNE` | Tonne metric (t) | | `TU` | Tube | | `YDK` | Square yard (yd2) | | `YDQ` | Cubic yard (yd3) | | `YRD` | Yard (yd) | */\nexport type UnitOfMeasure = \"BG\" | \"BO\" | \"BX\" | \"C62\" | \"CMK\" | \"CMT\" | \"CR\" | \"CS\" | \"CT\" | \"DMQ\" | \"DR\" | \"DZN\" | \"EA\" | \"EN\" | \"FOT\" | \"FTK\" | \"FTQ\" | \"GLL\" | \"GRM\" | \"GRO\" | \"H87\" | \"INH\" | \"INK\" | \"INQ\" | \"KG\" | \"KGM\" | \"KMT\" | \"KT\" | \"LBR\" | \"LO\" | \"LTR\" | \"MGM\" | \"MLT\" | \"MMK\" | \"MMT\" | \"MTK\" | \"MTQ\" | \"MTR\" | \"ONZ\" | \"OZA\" | \"PK\" | \"PR\" | \"PTI\" | \"PX\" | \"QTI\" | \"RL\" | \"RO\" | \"SET\" | \"SMI\" | \"ST\" | \"STN\" | \"SV\" | \"TNE\" | \"TU\" | \"YDK\" | \"YDQ\" | \"YRD\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type UsefulLifeRevisionReason = \"CHANGE_IN_USE\" | \"DAMAGE\" | \"OBSOLESCENCE\" | \"OTHER\" | \"REASSESSMENT\" | \"REFURBISHMENT\" | \"REGULATORY\";\n";
+const API_TYPES = "// Types for the Hardfin API, version 2026-10-12, generated from its published document.\n// Regenerate them with hardfin types after upgrading the CLI.\n\n/** ApiError is one entry in a response's errors. */\nexport interface ApiError {\n    error: string;\n    statusCode: number;\n}\n\n/** ApiEnvelope is the shape every response takes, with the record or records in data. */\nexport interface ApiEnvelope<T> {\n    data: T;\n    metadata: {\n        errors?: ApiError[] | null;\n        requestId?: string;\n        requestTime?: string;\n        statusCode?: number;\n        pagination?: unknown;\n    };\n}\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type ArchivedState = \"all\" | \"false\" | \"true\";\n\nexport type Asset = SparseAsset & AssetLocationData & {\n    /** The asset's cost basis, depreciation, and accounting history. */\n    accounting?: AssetAccountingDetails;\n    /** The asset's recent events, such as shipments and deliveries. */\n    activity?: AssetEvent[];\n    /** A free-form description of the asset. */\n    description?: string | null;\n    /** The number of files attached to the asset. */\n    fileCount?: number;\n    /** The day the asset entered inventory. */\n    inInventoryDate?: string;\n    /** The asset's value for each custom field its item defines. */\n    metadata?: AssetMetadataFieldWrapper[];\n    /** Who owns the asset now. */\n    ownership?: AssetOwnership;\n    /** The project the asset is assigned to, or null when it is unassigned. */\n    project?: SparseProject | null;\n    /** How and when the asset was scrapped, or null when it has not been. */\n    scrappedContext?: AssetScrappedContext | null;\n    /** The number of tickets about the asset. */\n    ticketCount?: number;\n    /** The number of links attached to the asset. */\n    urlLinkCount?: number;\n};\n\nexport interface AssetAccountingDetails {\n    /** The asset's inventory cost basis, before deployment costs, which is what inventory is relieved by when the asset leaves it. */\n    acquisitionCogs?: string | null;\n    /** The asset's share of overhead. */\n    allocatedIndirect?: string | null;\n    /** The problems that keep the asset's accounting from being computed, such as a missing cost basis. */\n    assetExceptions?: AssetExceptionType[];\n    /** The parts cost. */\n    billOfMaterials?: string | null;\n    /** The cost basis on the books now, the acquisition basis in inventory and the deployed basis once the asset is a fixed asset. */\n    capitalizedCosts?: string | null;\n    /** The capitalizations and impairments made to the asset's cost after it was acquired. */\n    costAdjustments?: AssetCostAdjustment[];\n    /** The method the asset is depreciated by. */\n    depreciationModel?: Depreciation;\n    /** The asset's book value month by month, from its inventory month, or null while it has an accounting exception. */\n    depreciationPeriods?: AssetDepreciationChartPeriod[] | null;\n    /** The labor cost to build the asset. */\n    directLabor?: string | null;\n    /** The shipping cost to receive the asset. */\n    freightInbound?: string | null;\n    /** The shipping cost to deploy the asset, a deployment cost. */\n    freightOutbound?: string | null;\n    /** The day the asset was put into service and began depreciating. */\n    inServiceDate?: string | null;\n    /** The cost to install the asset, a deployment cost. */\n    installation?: string | null;\n    /** The financing cost of the asset. */\n    interest?: string | null;\n    /** Whether Hardfin sets the in-service date itself rather than keeping one a person entered. */\n    isInServiceDateManagedAutomatically?: boolean;\n    /** The value the asset keeps at the end of its useful life. */\n    salvageValue?: string | null;\n    /** A single cost entered in place of the cost components. */\n    simpleCostBasis?: string | null;\n    /** The import duty paid on the asset. */\n    tariffs?: string | null;\n    /** The tax paid on the asset. */\n    tax?: string | null;\n    /** The deployed cost basis, including deployment costs, which is what is capitalized once the asset is put into service. */\n    totalPotentialCOGS?: string | null;\n    /** The number of months the asset is depreciated over. */\n    usefulLife?: number | null;\n    /** The changes made to the asset's useful life. */\n    usefulLifeRevisions?: AssetUsefulLifeRevision[];\n}\n\nexport interface AssetCostAdjustment {\n    /** CAPITALIZATION to add to the cost basis, or IMPAIRMENT to write it down. */\n    adjustmentType?: CostAdjustmentType;\n    /** The size of the adjustment. */\n    amount?: string;\n    /** When the adjustment was recorded. */\n    createdAt?: string;\n    /** The person who recorded the adjustment. */\n    createdBy?: SparsePerson;\n    /** The day the adjustment takes effect. */\n    effectiveDate?: string;\n    /** The cost adjustment's key. */\n    key?: string;\n    /** Free-form detail about the adjustment. */\n    notes?: string | null;\n    /** Why the cost changed. */\n    reason?: CostAdjustmentReason;\n}\n\nexport interface AssetDepreciationChartPeriod {\n    /** The depreciation charged from the in-service date through the end of the period. */\n    accumulated?: string;\n    /** The asset's value on the books at the end of the period. */\n    bookValue?: string;\n    /** The last day of the month the period covers. */\n    date?: string;\n    /** The depreciation charged in the period. */\n    depreciation?: string;\n}\n\nexport interface AssetEvent {\n    /** When the event was recorded. */\n    createdAt?: string;\n    /** The IANA time zone the event's times were entered in. */\n    eventTimezone?: string;\n    /** When the event is expected to happen, or null when no one has said. */\n    expectedAt?: string | null;\n    /** The event's unique identifier. */\n    id?: string;\n    /** Whether the event has to happen for its group to complete. */\n    isRequired?: boolean;\n    /** When the event happened, or null while it has not. */\n    occurredAt?: string | null;\n    /** The day the event was promised to a customer, or null when none was. */\n    promiseDate?: string | null;\n    /** The event's values a person set, such as carrier tracking. */\n    properties?: AssetEventProperty[];\n    /** The event's position within its group. */\n    sequence?: number;\n    /** When someone marked the event as happened in Hardfin, or null while it has not happened. */\n    triggeredAt?: string | null;\n    /** What kind of event this is. */\n    type?: AssetEventType;\n}\n\nexport interface AssetEventConfiguration {\n    /** The properties an event of the type carries. */\n    properties?: AssetEventProperty[];\n    /** The kind of event the configuration describes. */\n    type?: AssetEventType;\n}\n\nexport interface AssetEventGroup {\n    /** The kind of group this is, and the events it carries. */\n    configuration?: AssetEventGroupConfiguration;\n    /** Where the movement ends, or null when the group does not move the asset. */\n    destination?: SparseLocationWithParent | null;\n    /** The events the group has recorded so far. */\n    events?: AssetEvent[];\n    /** The event group's unique identifier. */\n    id?: string;\n    /** The event group's key, which the event group endpoints take as eventGroupKey. */\n    key?: string;\n    /** Where the movement started, or null when the group does not move the asset. */\n    origin?: SparseLocationWithParent | null;\n    /** The shipment the movement travels on, or null when it travels on none. */\n    shipment?: SparseShipment | null;\n}\n\nexport interface AssetEventGroupConfiguration {\n    /** The events a group of the kind carries, in the order they happen. */\n    events?: AssetEventConfiguration[];\n    /** The configuration's unique identifier. */\n    id?: string;\n    /** The configuration's key. */\n    key?: string;\n    /** What the configuration is called, such as ship and deliver. */\n    name?: string;\n}\n\nexport interface AssetEventProperty {\n    /** The event property's unique identifier. */\n    id?: string;\n    /** Whether Hardfin sets the property itself rather than a person, which responses leave out. */\n    isSystemProperty?: boolean;\n    /** The property's display name. */\n    label?: string;\n    /** The kind of value the property holds, such as CARRIER_TRACKING or CACHED_LOCATION. */\n    type?: string;\n    /** The property's value, whose JSON shape depends on the property's type. */\n    value?: unknown[] | boolean | number | Record<string, unknown> | string | null;\n}\n\nexport interface AssetEventType {\n    /** The event type's unique identifier. */\n    id?: string;\n    /** The event type's name, such as Ship or Deliver. */\n    name?: string;\n    /** Whether an event of this type only happens as part of a group, such as a shipment. */\n    requiresEventGroup?: boolean;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetExceptionType = \"DEPLOYMENT_WITHOUT_ACQUISITION\" | \"DISPOSAL_DATE_BEFORE_INVENTORY\" | \"FIRST_ASSIGNMENT_BEFORE_INVENTORY\" | \"FIRST_MOVEMENT_BEFORE_INVENTORY\" | \"FIRST_SALE_DATE_BEFORE_INVENTORY\" | \"IN_SERVICE_DATE_BEFORE_INVENTORY\" | \"MISSING_COST_BASIS\" | \"MISSING_USEFUL_LIFE\" | \"SALVAGE_EXCEEDS_50_PERCENT\" | \"UNKNOWN\";\n\nexport interface AssetFile {\n    /** The file's unique identifier. */\n    id?: string;\n    /** Whether the file is readable with any organization's API key. */\n    isPublic?: boolean;\n    /** The file's key, which the file endpoints take as fileKey. */\n    key?: string;\n    /** The file's media type, or an empty string when the upload named none. */\n    mimeType?: string;\n    /** The name the file had when it was uploaded. */\n    name?: string;\n    /** The file's size in bytes. */\n    size?: number;\n    /** The file type the file was uploaded as. */\n    type?: string;\n    /** When the file was uploaded. */\n    uploadedAt?: string;\n}\n\n/** Whether an asset works, is broken, awaits review, or has been scrapped. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetFunctionalStatus = \"FUNCTIONAL\" | \"NEEDS_REVIEW\" | \"NON-FUNCTIONAL\" | \"SCRAPPED\";\n\nexport interface AssetFunctionalStatusHistoryItem {\n    /** When the asset left the status, or null while it still holds it. */\n    end?: string | null;\n    /** When the asset took the status. */\n    start?: string;\n    /** Whether the asset worked, was broken, awaited review, or had been scrapped through the period. */\n    status?: AssetFunctionalStatus;\n}\n\nexport interface AssetListing {\n    /** The page of records. */\n    results?: Asset[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface AssetLocationData {\n    /** Where the asset is, or null while it is in transit. */\n    currentLocation?: SparseLocationWithParent | null;\n    /** Whether the asset has shipped and not yet been delivered. */\n    inTransit?: boolean;\n    /** Where a planned or in-progress move takes the asset, or null when none is planned. */\n    nextLocation?: SparseLocationWithParent | null;\n    /** The location the asset was at before its current one, or null when it has not moved. */\n    previousLocation?: SparseLocationWithParent | null;\n}\n\nexport interface AssetMetadataField {\n    /** The item field's unique identifier. */\n    id?: string;\n    /** The item field's key. */\n    key?: string;\n    /** The field's display name. */\n    label?: string;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n    /** The kind of value the field holds, which decides the JSON type of its value. */\n    type?: ItemFieldType;\n}\n\nexport type AssetMetadataFieldWrapper = {\n    field?: {\n        type?: \"BOOLEAN\";\n    };\n    value?: boolean | null;\n} | {\n    field?: {\n        type?: \"DATE\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"DATE_TIME\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"INTEGER\";\n    };\n    value?: number | null;\n} | {\n    field?: {\n        type?: \"MULTILINE_TEXT\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"NUMBER\";\n    };\n    value?: number | null;\n} | {\n    field?: {\n        type?: \"TEXT\";\n    };\n    value?: string | null;\n} | {\n    field?: {\n        type?: \"TIME\";\n    };\n    value?: string | null;\n};\n\nexport interface AssetMoveToPlan {\n    /** The ID of the asset to move. */\n    assetId: string;\n    /** When the asset reaches its destination, or null when the move only ships. */\n    deliverAt?: string | null;\n    /** The client's own name for the move, which the plan echoes back beside its answer. */\n    id: string;\n    /** When the asset leaves its origin, or null when the move only delivers. */\n    shipAt?: string | null;\n}\n\nexport interface AssetOwnership {\n    /** The customer that owns the asset, or null when your organization owns it. */\n    customer?: SparseCustomer | null;\n    /** The day the asset's current owner took ownership, or null when its ownership has never changed. */\n    ownershipChangeDate?: string | null;\n}\n\nexport interface AssetOwnershipHistoryItem {\n    /** When the segment was recorded. */\n    createdAt?: string;\n    /** The customer that owned the asset during the segment, or null when your organization did. */\n    customer?: SparseCustomer | null;\n    /** The day the segment's owner took ownership. */\n    date?: string;\n    /** The ownership segment's unique identifier. */\n    id?: string;\n    /** The ownership segment's key, which the segment endpoints take as segmentKey. */\n    key?: string;\n    /** When the segment was last changed. */\n    lastModifiedAt?: string;\n    /** What the owner paid for the asset, or null when no price was recorded. */\n    salePrice?: string | null;\n}\n\nexport interface AssetPlannedIntersection {\n    /** The ID of the event group the move would collide with, or null when none names one. */\n    aegId?: string | null;\n    /** The key of the event group the move would collide with, or null when none names one. */\n    aegKey?: string | null;\n    /** When the colliding movement ends, or null while it has no end. */\n    end?: string | null;\n    /** When the colliding movement starts. */\n    start?: string;\n}\n\nexport interface AssetPlannedMove {\n    /** The client's own name for the move, echoed from the plan it asked about. */\n    id?: string;\n    /** The movement the move would collide with, or null when it collides with none. */\n    intersection?: AssetPlannedIntersection | null;\n    /** Whether the move can be carried out as asked. */\n    isValid?: boolean;\n}\n\n/** A project assignment the asset list filters by. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AssetProjectStatusFilter = \"ACTIVE\" | \"NONE\" | \"PAST\" | \"UPCOMING\";\n\nexport interface AssetProposedMultiMove {\n    /** The ID of the asset to move. */\n    assetId: string;\n    /** When the asset reaches its destination, and one of shipAt or deliverAt is required. */\n    deliverAt?: string | null;\n    /** The IANA time zone name the delivery time was entered in, such as America/Denver; when omitted, the delivery time's clock time is read in the organization's time zone. */\n    deliverAtTimezone?: string | null;\n    /** The ID of the location the asset arrives at. */\n    destinationId: string;\n    /** The ID of the location the asset leaves. */\n    originId: string;\n    /** When the asset leaves its origin, and one of shipAt or deliverAt is required. */\n    shipAt?: string | null;\n    /** The IANA time zone name the ship time was entered in, such as America/Denver; when omitted, the ship time's clock time is read in the organization's time zone. */\n    shipAtTimezone?: string | null;\n}\n\nexport interface AssetScrappedContext {\n    /** The day the asset was scrapped. */\n    disposalDate?: string;\n    /** What the scrapped asset was sold for, or null when it was not sold. */\n    disposalPrice?: string | null;\n    /** Why the asset was scrapped. */\n    disposalReason?: string | null;\n}\n\nexport interface AssetShippingData {\n    /** When Hardfin recorded the update. */\n    createdAt?: string;\n    /** The tracking update's unique identifier. */\n    id?: string;\n    /** The tracking update's key. */\n    key?: string;\n    /** Where the carrier reported the shipment, or null when it reported nowhere. */\n    location?: AssetShippingDataLocation | null;\n    /** When the carrier says the update happened. */\n    reportedAt?: string;\n    /** The carrier's status for the shipment at that point. */\n    status?: string;\n    /** What the carrier wrote about the update. */\n    statusText?: string;\n    /** The carrier's finer status, or null when it reported none. */\n    substatus?: string | null;\n    /** When Hardfin last changed the update. */\n    updatedAt?: string;\n}\n\nexport interface AssetShippingDataListing {\n    /** Who carries the shipment, or null when no carrier is named. */\n    carrier?: Carrier | null;\n    /** When the carrier now expects to deliver, or null when it says nothing. */\n    eta?: string | null;\n    /** When the carrier first expected to deliver, or null when it said nothing. */\n    originalEta?: string | null;\n    /** The carrier's name when it is one Hardfin does not track itself, or null. */\n    otherName?: string | null;\n    /** The carrier's service the shipment travels on, or null when it names none. */\n    serviceLevelName?: string | null;\n    /** What the carrier has reported, newest first. */\n    shippingHistory?: AssetShippingData[];\n    /** The number the carrier tracks the shipment by, or null when it has none. */\n    trackingNumber?: string | null;\n}\n\nexport interface AssetShippingDataLocation {\n    /** The city the carrier reported. */\n    city?: string;\n    /** The country the carrier reported. */\n    country?: string;\n    /** The state or region the carrier reported. */\n    state?: string;\n    /** The postal code the carrier reported. */\n    zip?: string;\n}\n\nexport interface AssetUpdateMetadataItem {\n    /** The ID of the item field to set on the asset. */\n    fieldId: string;\n    /** The field's new value, in the JSON type the field's type calls for, or null to clear it. */\n    value?: unknown[] | boolean | number | Record<string, unknown> | string | null;\n}\n\nexport interface AssetUsefulLifeRevision {\n    /** When the revision was recorded. */\n    createdAt?: string;\n    /** The person who recorded the revision. */\n    createdBy?: SparsePerson;\n    /** The day the new useful life takes effect. */\n    effectiveDate?: string;\n    /** The revision's key. */\n    key?: string;\n    /** Free-form detail about the revision. */\n    notes?: string | null;\n    /** Why the useful life changed. */\n    reason?: UsefulLifeRevisionReason;\n    /** The asset's new useful life in months. */\n    usefulLifeMonths?: number;\n}\n\n/** A machine-readable predicate describing why an entity needs attention. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AttentionReason = \"DELIVERED_NOT_RECEIVED\" | \"OPEN_NOT_SHIPPED\" | \"SHIPPED_NOT_DELIVERED\";\n\n/** An ordinal severity for the needs-attention signal. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type AttentionSeverity = \"CRITICAL\" | \"NOTICE\" | \"WARNING\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingFrequency = \"ANNUALLY\" | \"BIENNIALLY\" | \"BIWEEKLY\" | \"DAILY\" | \"MONTHLY\" | \"ONCE\" | \"QUADRENNIALLY\" | \"QUARTERLY\" | \"QUINQUENNIALLY\" | \"SEMIANNUALLY\" | \"TRIENNIALLY\" | \"WEEKLY\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingSchedule = \"MILESTONE\" | \"PERIODIC\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type BillingTiming = \"ADVANCE\" | \"ARREARS\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type Carrier = \"airterra\" | \"apc_postal\" | \"apg\" | \"aramex\" | \"asendia_us\" | \"australia_post\" | \"axlehire\" | \"better_trucks\" | \"borderguru\" | \"boxberry\" | \"bring\" | \"canada_post\" | \"cdl\" | \"chronopost\" | \"colissimo\" | \"collect_plus\" | \"correios_br\" | \"correos_espana\" | \"couriersplease\" | \"deutsche_post\" | \"dhl_benelux\" | \"dhl_ecommerce\" | \"dhl_express\" | \"dhl_germany\" | \"dhl_germany_c2c\" | \"dpd_de\" | \"dpd_uk\" | \"estafeta\" | \"fastway_australia\" | \"fedex\" | \"globegistics\" | \"gls_us\" | \"gophr\" | \"gso\" | \"hermes_germany_b2c\" | \"hermes_uk\" | \"hongkong_post\" | \"la_poste\" | \"lasership\" | \"lso\" | \"mondial_relay\" | \"new_zealand_post\" | \"nippon_express\" | \"ontrac\" | \"orangeds\" | \"other\" | \"parcel\" | \"parcelforce\" | \"passport\" | \"pcf\" | \"pitney_bowes\" | \"poste_italiane\" | \"posti\" | \"purolator\" | \"royal_mail\" | \"royal_mail_sf\" | \"rr_donnelley\" | \"russian_post\" | \"sendle\" | \"shippo\" | \"skypostal\" | \"stuart\" | \"swyft\" | \"uds\" | \"ups\" | \"usps\" | \"veho\" | \"x_delivery\" | \"yodel\";\n\nexport interface Charge {\n    /** The day the charge became billable, or null while it has not. */\n    billingEligibleDate?: string | null;\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge's unique identifier. */\n    id?: string;\n    /** True when a person added, edited or split the charge, and false when it came from the line item's billing plan unchanged. */\n    isCustomModified?: boolean;\n    /** The charge's key. */\n    key?: string;\n    /** The charge's display name, such as the period it covers or the milestone it follows. */\n    label?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The number of units the charge bills. */\n    quantity?: number;\n    /** The charge's position among its line item's charges, in ascending order. */\n    sequence?: number;\n    /** The last day of the period the charge covers. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** PLANNED before the charge can be invoiced, BILLABLE once it can, INVOICED once it is on an invoice, or CANCELLED when it will not be billed. */\n    status?: ChargeStatus;\n    /** The amount the charge bills. */\n    totalPrice?: Currency;\n    /** TIME when the charge becomes billable on ExpectedBillableDate, or MANUAL when a person marks it billable. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit behind the charge, or null when TotalPrice was not computed from one. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ChargeListItem {\n    /** The moment the charge became billable, or null while it has not. */\n    actualBillableAt?: string | null;\n    /** Why the charge was cancelled, or null when none was given or it is not cancelled. */\n    cancellationReason?: string | null;\n    /** The moment the charge was cancelled, or null when it is not cancelled. */\n    cancelledAt?: string | null;\n    /** The line item's schedule: PERIODIC when its charges recur at a regular frequency, or MILESTONE when each follows a project milestone. */\n    chargeSchedule?: BillingSchedule;\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge's unique identifier. */\n    id?: string;\n    /** The item the charge's line item bills for. */\n    item?: SparseItem;\n    /** The charge's key. */\n    key?: string;\n    /** The charge's display name, such as the period it covers or the milestone it follows. */\n    label?: string;\n    /** CONFIRMED when the line item's charges carry dates, or PENDING when its activation date is not yet known, and a PERIODIC charge can be marked billable only once it is CONFIRMED. */\n    lineItemChargeMode?: ChargeMode;\n    /** The key of the line item the charge belongs to. */\n    lineItemKey?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The project the charge belongs to, which carries the charge's customer. */\n    project?: SparseProject;\n    /** The number of units the charge bills. */\n    quantity?: number;\n    /** The last day of the period the charge covers. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** The number of charges split from one charge, which is 1 for a charge that was never split. */\n    splitCount?: number;\n    /** The charge's position among the charges split from one charge, counted from 1. */\n    splitIndex?: number;\n    /** PLANNED before the charge can be invoiced, BILLABLE once it can, INVOICED once it is on an invoice, or CANCELLED when it will not be billed. */\n    status?: ChargeStatus;\n    /** The amount the charge bills. */\n    totalPrice?: Currency;\n    /** TIME when the charge becomes billable on ExpectedBillableDate, or MANUAL when a person marks it billable. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit behind the charge, or null when TotalPrice was not computed from one. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ChargeMarkedBillable {\n    /** The billable charge created for the quantity billed now, or null when the whole charge was billed. */\n    newCharge?: Charge | null;\n    /** The charge the request named, which keeps the quantity not billed when the charge was split. */\n    updatedCharge?: Charge;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeMode = \"CONFIRMED\" | \"PENDING\";\n\nexport interface ChargePage {\n    /** The charges on this page. */\n    results?: ChargeListItem[];\n    /** The number of charges the filters match, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeStatus = \"BILLABLE\" | \"CANCELLED\" | \"INVOICED\" | \"PLANNED\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ChargeTriggerType = \"EVENT\" | \"MANUAL\" | \"TIME\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CompanyType = \"CUSTOMER\" | \"MANUFACTURER\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostAdjustmentReason = \"ADDITION\" | \"BETTERMENT\" | \"DAMAGE\" | \"INSTALLATION\" | \"LIFE_EXTENSION\" | \"MARKET_DECLINE\" | \"OBSOLESCENCE\" | \"OTHER\" | \"REGULATORY\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostAdjustmentType = \"CAPITALIZATION\" | \"IMPAIRMENT\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type CostBasisMode = \"ADVANCED\" | \"SIMPLE\" | null;\n\n/** The kind of credential a request was made with. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `API_KEY` | An API key, for an integration that runs unattended | | `OAUTH` | An OAuth access token, issued to an application a person connected | | `SESSION` | A person signed in to Hardfin in a browser | */\nexport type CredentialType = \"API_KEY\" | \"OAUTH\" | \"SESSION\";\n\nexport interface Currency {\n    /** The value as a decimal string with two decimal places. */\n    amount?: string;\n    /** The value's ISO 4217 currency code. */\n    isoCode?: string;\n}\n\nexport type Customer = SparseCustomer & {\n    /** The number of the customer's active projects. */\n    activeProjectCt?: number;\n    /** The number of assets the customer owns. */\n    assetCount?: number;\n    /** The number of assets at the customer's locations. */\n    assetsAtLocation?: number;\n    /** The address invoices are sent to. */\n    billingAddress?: string | null;\n    /** The person who receives the customer's invoices. */\n    billingContact?: CustomerBillingContact | null;\n    /** A free-form note about the customer. */\n    comment?: string | null;\n    /** The customer's web domain, used to look up its logo. */\n    domain?: string | null;\n    /** The customer's identifier in another system. */\n    externalId?: string | null;\n    /** The number of the customer's incomplete projects. */\n    incompleteProjectCt?: number;\n    /** The customer's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** The number of the customer's locations. */\n    locationCount?: number;\n    /** The customer's locations. */\n    locations?: SparseLocationWithParent[];\n    /** The storage key of the customer's logo file. */\n    logoFileKey?: string | null;\n    /** The number of the customer's past projects. */\n    pastProjectCt?: number;\n    /** The number of the customer's upcoming projects. */\n    upcomingProjectCt?: number;\n};\n\nexport interface CustomerBillingContact {\n    /** The billing contact's email address. */\n    email?: string | null;\n    /** The billing contact's name. */\n    name?: string | null;\n    /** The billing contact's phone number. */\n    phone?: string | null;\n}\n\nexport interface CustomerListing {\n    /** The page of records. */\n    results?: Customer[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type Depreciation = \"DOUBLE_DECLINING\" | \"STRAIGHT_LINE\" | \"SUM_YEAR\" | \"UNIT_OF_PRODUCTION\" | null;\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type EntityType = \"ASSET\" | \"BILLING\" | \"BILLING_PLAN\" | \"CHARGE\" | \"CONTACT\" | \"COST\" | \"CUSTOMER\" | \"FULFILLMENT_ORDER\" | \"INVOICE\" | \"ITEM\" | \"LOCATION\" | \"ORGANIZATION\" | \"PERSON\" | \"PROJECT\" | \"PURCHASE_ORDER\" | \"RETURN_ORDER\" | \"SHIPMENT\" | \"TIME_RECORD\";\n\nexport interface Error {\n    error: string;\n    statusCode: number;\n}\n\nexport interface FileNewUpload {\n    /** The uploaded file's unique identifier. */\n    fileId?: string;\n    /** The uploaded file's key, which the file endpoints take as fileKey. */\n    fileKey?: string;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type FrontendItemType = \"BULK\" | \"DEVICE\" | \"SERVICE\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type IntegrationCategory = \"CRM\" | \"ERP\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type IntegrationID = \"HUBSPOT\" | \"NETSUITE\" | \"NONE\" | \"QBO\" | \"SFDC\";\n\nexport interface Item {\n    /** Whether a BULK item records serial numbers on its units, which is false for SERVICE and DEVICE items. */\n    acceptsBulkSerials?: boolean;\n    /** The number of assets of a DEVICE item, and null for other types. */\n    assetCount?: number | null;\n    /** A free-form description of the item. */\n    description?: string | null;\n    /** The item's unique identifier. */\n    id?: string;\n    /** The item's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** When the item was last changed. */\n    lastUpdatedAt?: string | null;\n    /** The person who last changed the item. */\n    lastUpdatedBy?: SparsePerson;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n}\n\nexport interface ItemAccounting {\n    /** The default share of overhead for one unit. */\n    allocatedIndirect?: string | null;\n    /** The default parts cost for one unit. */\n    billOfMaterials?: string | null;\n    /** The default method one unit is depreciated by. */\n    depreciationModel?: Depreciation;\n    /** The default labor cost to build one unit. */\n    directLabor?: string | null;\n    /** The default shipping cost to receive one unit. */\n    freightInbound?: string | null;\n    /** The default shipping cost to deliver one unit. */\n    freightOutbound?: string | null;\n    /** The default cost to install one unit. */\n    installation?: string | null;\n    /** The default financing cost for one unit. */\n    interest?: string | null;\n    /** The default value one unit keeps at the end of its useful life. */\n    salvageValue?: string | null;\n    /** A single default cost for one unit, used instead of the cost components. */\n    simpleCostBasis?: string | null;\n    /** The default import duty paid on one unit. */\n    tariffs?: string | null;\n    /** The default tax paid on one unit. */\n    tax?: string | null;\n    /** The default cost of goods sold for one unit, which is the simple cost basis when set and otherwise the sum of the cost components. */\n    totalCOGS?: string | null;\n    /** The default number of months one unit is depreciated over. */\n    usefulLife?: number | null;\n}\n\nexport interface ItemBOMItem {\n    /** The BULK part the bill of materials uses. */\n    item?: SparseItem;\n    /** The number of the part one unit of the item uses. */\n    quantity?: number;\n}\n\nexport interface ItemDetail {\n    /** Whether a BULK item records serial numbers on its units, which is false for SERVICE and DEVICE items. */\n    acceptsBulkSerials?: boolean;\n    /** The default costs and depreciation for a unit of a DEVICE or BULK item. */\n    accounting?: ItemAccounting;\n    /** The number of assets of a DEVICE item, and null for other types. */\n    assetCount?: number | null;\n    /** The bill of materials, the BULK parts one unit of the item is built from, or null when it has none. */\n    bom?: ItemBOMItem[] | null;\n    /** The pricing a project line item's billing plan starts from when it sells the item, or null when the item has none. */\n    defaultPricing?: ItemPricing | null;\n    /** A free-form description of the item. */\n    description?: string | null;\n    /** The custom fields each asset of a DEVICE item can hold. */\n    fields?: ItemField[];\n    /** Whether each unit of the item is tracked as its own asset, which is true for a DEVICE item. */\n    hasAssets?: boolean;\n    /** The item's unique identifier. */\n    id?: string;\n    /** The item's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** The number of inventory movements of a BULK item, and null for other types. */\n    inventoryMovementCount?: number | null;\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** Whether the item is physical, which is true for DEVICE and BULK items. */\n    isPhysical?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** When the item was last changed. */\n    lastUpdatedAt?: string | null;\n    /** The person who last changed the item. */\n    lastUpdatedBy?: SparsePerson;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n}\n\nexport interface ItemField {\n    /** The field's unique identifier. */\n    id?: string;\n    /** The field's key, which the item field endpoints take as fieldKey. */\n    key?: string;\n    /** The field's display name. */\n    label?: string;\n    /** The number of assets that hold a value for the field. */\n    metadataCount?: number;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n    /** The kind of value the field holds. */\n    type?: ItemFieldType;\n}\n\nexport interface ItemFieldOrderingUpdateItem {\n    /** The ID of the item field to move. */\n    fieldId: string;\n    /** The field's position within its section, starting at 0. */\n    order?: number;\n    /** The group the field is shown in, starting at 0. */\n    section?: number;\n}\n\n/** The kind of value an item's custom field holds. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ItemFieldType = \"BOOLEAN\" | \"DATE\" | \"DATE_TIME\" | \"INTEGER\" | \"MULTILINE_TEXT\" | \"NUMBER\" | \"TEXT\" | \"TIME\";\n\nexport interface ItemListing {\n    /** The page of records. */\n    results?: Item[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\nexport interface ItemPricing {\n    /** How often a PERIODIC charge recurs. */\n    chargeFrequency?: BillingFrequency | null;\n    /** PERIODIC to charge on a recurring cadence, or MILESTONE to charge when a milestone is reached. */\n    chargeSchedule?: BillingSchedule | null;\n    /** The default price for the whole line, used when pricingMode is FIXED. */\n    fixedPrice?: Currency | null;\n    /** How often the charges are invoiced. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends. */\n    invoiceMode?: BillingTiming | null;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price for the line whatever its quantity. */\n    pricingMode?: PricingMode | null;\n    /** The default price for each unit, used when pricingMode is PER_UNIT. */\n    unitPrice?: Currency | null;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ItemType = \"marked_bulk\" | \"service\" | \"tracked_device\" | \"unmarked_bulk\";\n\nexport type Location = SparseLocationWithIntegration & {\n    /** The number of active projects at the location. */\n    activeProjectCount?: number;\n    /** The number of assets currently at the location. */\n    assetCount?: number;\n    /** The number of incomplete projects at the location. */\n    incompleteProjectCount?: number;\n    /** The number of past projects at the location. */\n    pastProjectCount?: number;\n    /** The number of upcoming projects at the location. */\n    upcomingProjectCount?: number;\n};\n\nexport interface LocationListing {\n    /** The page of records. */\n    results?: Location[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type LocationType = \"SITE\" | \"ZONE\" | null;\n\nexport interface Metadata {\n    errors: Error[] | null;\n    /** What the client should know about its request, beside any error. A notice never fails a request. */\n    notices?: Notice[];\n    /** The identifier to quote when asking Hardfin about this request. */\n    requestId: string;\n    /** How long the server took to answer. */\n    requestTime: string;\n    statusCode: number;\n}\n\nexport interface MetadataLocationComponents {\n    /** The first line of the street address. */\n    addressLine1?: string | null;\n    /** The second line of the street address, such as a suite. */\n    addressLine2?: string | null;\n    /** The city. */\n    city?: string | null;\n    /** The country. */\n    country?: string | null;\n    /** The whole address on one line. */\n    formattedAddress?: string | null;\n    /** The postal or ZIP code. */\n    postalCode?: string | null;\n    /** The state or region. */\n    state?: string | null;\n}\n\nexport interface MetadataLocationSite {\n    /** The location's structured address, which a zone reads from its parent site. */\n    address?: MetadataLocationComponents | null;\n    /** Google's place ID for the address, when it was found through Google. */\n    googlePlaceId?: string | null;\n    /** The location's latitude, sent as a decimal string. */\n    latitude?: string | null;\n    /** The location's longitude, sent as a decimal string. */\n    longitude?: string | null;\n    /** The person or business that receives shipments at the location. */\n    shippingName?: string | null;\n}\n\nexport interface MetadataMilestonePhaseEntry {\n    /** The phase's name, which its charge takes as a label, 255 characters or less. */\n    name?: string;\n    /** The share of the line item's total the phase bills, from 0 to 100. */\n    percentage?: string | null;\n}\n\nexport interface MetadataMilestonePhases {\n    /** The phases, in order. */\n    entries?: MetadataMilestonePhaseEntry[];\n    /** PERCENTAGE, the only way a phase's share is expressed. */\n    mode?: string;\n}\n\nexport interface Notice {\n    /** What the notice is about. API_VERSION_OUTDATED means an earlier version of the endpoint answered, because X-API-Version is behind its last change. Ignore a code that is not recognized. */\n    code: string;\n    /** The X-API-Version to move to so the notice stops. */\n    latestVersion: string;\n    message: string;\n}\n\nexport interface PaymentTerm {\n    /** The payment term's identifier. */\n    id?: string;\n    /** The payment term's key. */\n    key?: string;\n    /** The payment term's name as people read it. */\n    label?: string;\n    /** The number of days after the invoice date that payment is due. */\n    netDays?: number;\n    /** The payment term's machine name. */\n    value?: string;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type PricingMode = \"FIXED\" | \"PER_UNIT\";\n\nexport type Project = SparseProject & {\n    /** The day the customer accepted the project. */\n    acceptanceDate?: string | null;\n    /** The workflow the project is on, with the project's current stage marked active, or null when it has no workflow. */\n    activeWorkflow?: SparseActiveWorkflow | null;\n    /** The project's annual recurring revenue, with one total for each currency its recurring line items are priced in. */\n    annualRecurringRevenue?: ProjectCurrencyAmount[];\n    /** The billing address the project's invoices use in place of the customer's. */\n    billingAddress?: string | null;\n    /** The billing contact email the project's invoices use in place of the customer's. */\n    billingContactEmail?: string | null;\n    /** The billing contact name the project's invoices use in place of the customer's. */\n    billingContactName?: string | null;\n    /** The billing contact phone number the project's invoices use in place of the customer's. */\n    billingContactPhone?: string | null;\n    /** The number of charges on the project's line items. */\n    chargeCount?: number;\n    /** What follows the project for its customer: it was renewed, the customer kept a later-ending project, or nothing followed. */\n    completionClassification?: ProjectCompletionClassification;\n    /** The day the contract was signed. */\n    contractSignedOn?: string | null;\n    /** The number of costs recorded against the project. */\n    costCount?: number;\n    /** The project's single currency and the field that established it, or null when no currency-bearing field is set. */\n    currency?: ProjectCurrency | null;\n    /** The customer the project is for. */\n    customer?: SparseCustomer | null;\n    /** The project's default location, which counts among its locations even when no line item names it. */\n    defaultLocation?: SparseLocationWithParent | null;\n    /** The project's description. */\n    description?: string | null;\n    /** The discount applied to the project. */\n    discount?: Currency | null;\n    /** The number of files attached to the project. */\n    fileCount?: number;\n    /** The day the project goes live. */\n    goLiveDate?: string | null;\n    /** The day of the installation. */\n    installDate?: string | null;\n    /** The number of the project's charges that have been invoiced. */\n    invoicedChargeCount?: number;\n    /** The project's line items, each an item the project sells or provides as a service. */\n    items?: ProjectLineItem[];\n    /** Every location the project names: the ones its line items ask for, and its default location. */\n    locations?: SparseLocationWithParent[];\n    /** The memo new invoices for the project carry. */\n    memo?: string | null;\n    /** The number of notes on the project. */\n    noteCount?: number;\n    /** The project's payment term. */\n    paymentTerm?: PaymentTerm | null;\n    /** The project this one renews. */\n    previousProject?: SparseProject | null;\n    /** Whether the items the project asks for have been fulfilled, judged across all of its line items. */\n    projectFulfillmentStatus?: ProjectFulfillmentStatus;\n    /** The customer's purchase order number, which new invoices for the project carry. */\n    purchaseOrderNumber?: string | null;\n    /** The day of the site visit. */\n    siteVisitDate?: string | null;\n    /** How the project relates to the customer's earlier projects: a renewal of a prior project, new business, or an expansion. */\n    startClassification?: ProjectStartClassification;\n    /** The number of tickets on the project. */\n    ticketCount?: number;\n    /** The number of time activities recorded against the project. */\n    timeActivityCount?: number;\n    /** The contract's total value, as entered on the project. */\n    totalContractValue?: Currency | null;\n    /** The day of the training. */\n    trainingDate?: string | null;\n    /** The number of URL links attached to the project. */\n    urlLinkCount?: number;\n};\n\nexport interface ProjectChargeRequestItem {\n    /** The day the charge is planned to become billable, or null when it has no dates yet. */\n    expectedBillableDate?: string | null;\n    /** The charge to update, or null to add a new one, and no two charges in the list send the same one. */\n    id?: string | null;\n    /** True when a person added, edited or split the charge, and false when it follows the line item's billing plan unchanged. */\n    isCustomModified?: boolean;\n    /** The charge's display name, such as the period it covers or the milestone it follows, which is required and 255 characters or less once the spaces around it are trimmed. */\n    label?: string;\n    /** PER_UNIT when the charge bills a unit price for each unit, or FIXED when it bills a flat amount. */\n    pricingMode?: PricingMode;\n    /** The number of units the charge bills, which is at least 1 when UnitPrice is sent and 2,147,483,647 or less. */\n    quantity?: number;\n    /** The charge's position among its line item's charges, in ascending order, which is zero or more and sent by one charge in the list. */\n    sequence?: number;\n    /** The last day of the period the charge covers, on or after ServicePeriodStart. */\n    servicePeriodEnd?: string | null;\n    /** The first day of the period the charge covers, or null when the charge has no dates yet. */\n    servicePeriodStart?: string | null;\n    /** The charge's status: PLANNED, BILLABLE, INVOICED or CANCELLED. */\n    status?: ChargeStatus;\n    /** The amount the charge bills, which equals UnitPrice times Quantity when UnitPrice is sent. */\n    totalPrice?: Currency;\n    /** TIME when the charge becomes billable on ExpectedBillableDate, or MANUAL when a person marks it billable, and is TIME when omitted. */\n    triggerType?: ChargeTriggerType;\n    /** The price of one unit, in the currency of TotalPrice, and is null on a FIXED charge. */\n    unitPrice?: Currency | null;\n}\n\n/** What follows a project for its customer when it ends. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectCompletionClassification = \"CHURN\" | \"CONTRACTION\" | \"RENEWED\";\n\nexport interface ProjectCurrency {\n    /** The ISO 4217 code of the project's currency. */\n    isoCode?: string;\n    /** What fixed the project's currency: an invoiced charge, the contract value, the line items, or the discount. */\n    source?: ProjectCurrencySource;\n}\n\nexport interface ProjectCurrencyAmount {\n    /** The amount, in the currency IsoCode names. */\n    amount?: string;\n    /** The amount's ISO 4217 currency code. */\n    isoCode?: string;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectCurrencySource = \"DISCOUNT\" | \"INVOICED_CHARGE\" | \"LINE_ITEMS\" | \"PROJECT_VALUE\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectFulfillmentStatus = \"FULFILLED\" | \"OVER_FULFILLED\" | \"PARTIALLY_FULFILLED\" | \"UNFULFILLED\";\n\nexport interface ProjectItemBinding {\n    /** The day a periodic line item's charge schedule is anchored on, which defaults to StartOn. */\n    activationDate?: string | null;\n    /** The identifier that makes line items consecutive phases of one commitment when they send the same one, and is assigned when a new line item omits it. */\n    aggregationKey?: string;\n    /** The line item's single billing cadence, which fills ChargeFrequency and InvoiceFrequency on a periodic line item that omits them. */\n    billingFrequency?: BillingFrequency | null;\n    /** How often a periodic line item creates a charge, and is refused unless ChargeSchedule is PERIODIC. */\n    chargeFrequency?: BillingFrequency | null;\n    /** PERIODIC when charges recur at a regular frequency, or MILESTONE when each charge follows a project milestone. */\n    chargeSchedule?: BillingSchedule | null;\n    /** A free-form note about the line item, 65,536 characters or less. */\n    details?: string | null;\n    /** The last day of the line item's service window, on or after StartOn. */\n    endOn?: string | null;\n    /** The flat price when PricingMode is FIXED, and is not sent together with UnitPrice. */\n    fixedPrice?: Currency | null;\n    /** The line item to update, or omitted to add a new one. */\n    id?: string | null;\n    /** How often a periodic line item's charges are invoiced, which is never more often than ChargeFrequency. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, and is refused unless ChargeSchedule is PERIODIC. */\n    invoiceMode?: BillingTiming | null;\n    /** The catalog item the line item is for. */\n    itemId: string;\n    /** The location the line item is for. */\n    locationId?: string | null;\n    /** The named phases of a milestone line item and each one's share of its total. */\n    milestonePhases?: MetadataMilestonePhases | null;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price whatever the quantity. */\n    pricingMode?: PricingMode | null;\n    /** The number of units the line item covers, which is zero or more. */\n    quantity?: number;\n    /** The first day of the line item's own service window, sent together with EndOn. */\n    startOn?: string | null;\n    /** A negotiated total for a periodic line item that replaces the computed one, in the project's currency. */\n    totalOverride?: Currency | null;\n    /** SALE to sell the item, which only a physical item allows, or SERVICE to provide it as a service. */\n    transactionType: TransactionType;\n    /** The price of one unit for each charge, and is not sent together with FixedPrice. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ProjectLineItem {\n    /** The day a periodic line item's charge schedule is anchored on, or null while ChargeMode is PENDING and on a milestone line item. */\n    activationDate?: string | null;\n    /** The identifier shared by line items that are consecutive phases of one commitment, and unique to a line item that stands alone. */\n    aggregationKey?: string;\n    /** The line item's single billing cadence, which predates ChargeFrequency and InvoiceFrequency. */\n    billingFrequency?: BillingFrequency | null;\n    /** How often a periodic line item creates a charge, and is null on a milestone line item. */\n    chargeFrequency?: BillingFrequency | null;\n    /** CONFIRMED when the line item's charges carry dates, or PENDING when its activation date is not yet known and they do not. */\n    chargeMode?: ChargeMode;\n    /** PERIODIC when charges recur at a regular frequency, or MILESTONE when each charge follows a project milestone, and is null until the line item has a billing plan. */\n    chargeSchedule?: BillingSchedule | null;\n    /** The line item's charges, in Sequence order. */\n    charges?: Charge[];\n    /** A free-form note about the line item. */\n    details?: string | null;\n    /** The last day of the line item's service window. */\n    endOn?: string | null;\n    /** The flat price when PricingMode is FIXED: the amount of each charge on a periodic line item, and the total its phases split on a milestone one. */\n    fixedPrice?: Currency | null;\n    /** True when any of the line item's charges is invoiced, which stops the line item from being removed. */\n    hasInvoicedCharges?: boolean;\n    /** The line item's unique identifier. */\n    id?: string;\n    /** How often a periodic line item's charges are invoiced, which is never more often than ChargeFrequency. */\n    invoiceFrequency?: BillingFrequency | null;\n    /** ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, on a periodic line item. */\n    invoiceMode?: BillingTiming | null;\n    /** The catalog item the line item is for. */\n    item?: SparseItem;\n    /** The line item's key. */\n    key?: string;\n    /** The location the line item is for, or null when it has none. */\n    location?: SparseLocationWithParent | null;\n    /** The named phases of a milestone line item and each one's share of its total, or null on any other line item. */\n    milestonePhases?: MetadataMilestonePhases | null;\n    /** The line item's position among the line items sharing its AggregationKey, counted from 1 in order of StartOn. */\n    phaseRowNumber?: number;\n    /** PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price whatever the quantity, and is null until the line item has a billing plan. */\n    pricingMode?: PricingMode | null;\n    /** The number of units the line item covers. */\n    quantity?: number | null;\n    /** The first day of the line item's own service window, or null when it has no dates. */\n    startOn?: string | null;\n    /** A negotiated total for a periodic line item that replaces the computed one, or null to use the computed total. */\n    totalOverride?: Currency | null;\n    /** SALE when the item is sold, or SERVICE when it is provided as a service. */\n    transactionType?: TransactionType;\n    /** The price of one unit for each charge, or null when the line item is priced at a fixed price. */\n    unitPrice?: Currency | null;\n}\n\nexport interface ProjectListing {\n    /** The page of records. */\n    results?: Project[];\n    /** The number of records that match the filters, across every page. */\n    totalCount?: number;\n}\n\n/** How a project relates to the customer's earlier projects when it starts. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStartClassification = \"EXPANSION\" | \"NEW_BUSINESS\" | \"RENEWAL\";\n\n/** Where a project stands against its dates, which is computed and never stored. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStatus = \"ACTIVE\" | \"DATE_RANGE_INCOMPLETE\" | \"PAST\" | \"UPCOMING\";\n\n/** A project status the project list and the fulfillment report filter by. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ProjectStatusFilter = \"ACTIVE\" | \"DATE_RANGE_INCOMPLETE\" | \"PAST\" | \"UPCOMING\";\n\n/** The condition that stops a resolution the hold's type allows from running. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineResolutionBlockReason = \"SERIAL_ALREADY_TAKEN\";\n\n/** How a user resolved a quarantined serial. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineResolutionKind = \"ACCEPTED_SERIAL\" | \"CORRECTED_SERIAL\" | \"CREATED_ASSET\" | \"KEPT_HARDFIN_ITEM\" | \"UPDATED_EXISTING_ASSET\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type QuarantineType = \"DUPLICATE_ALREADY_EXISTS\" | \"DUPLICATE_IN_ORDER\" | \"MISSING_SERIAL\" | \"SERIAL_PATTERN_MISMATCH\" | \"SKU_TRANSMUTATION\" | \"UNKNOWN_SERIAL\";\n\n/** The item type a request asks an item to become. Accepted in any case. The listed spelling is the one the API sends back. */\nexport type RequestedItemType = \"BULK\" | \"DEVICE\" | \"SERVICE\";\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type ScrappedState = \"all\" | \"false\" | \"true\";\n\nexport interface SharedBool {\n    /** Whether the operation completed. */\n    success?: boolean;\n}\n\nexport interface SharedIntegration {\n    /** The Hardfin error code of the failed sync, or null when the sync did not fail. */\n    errorCode?: number | null;\n    /** The integrated system, such as SFDC or HUBSPOT. */\n    id?: IntegrationID;\n    /** Whether the last sync with the external system failed. */\n    inError?: boolean;\n    /** Whether a sync with the external system is pending. */\n    isSyncing?: boolean;\n    /** The system's display name. */\n    label?: string;\n    /** A URL to the linked record in the external system. */\n    link?: string | null;\n    /** Whether the record differs from the external system and needs a person to review it. */\n    needsReview?: boolean;\n    /** The kind of system, CRM or ERP. */\n    type?: IntegrationCategory;\n}\n\nexport interface Shipment {\n    /** When the shipment was cancelled, or null while it has not been. */\n    cancelledAt?: string | null;\n    /** The ID of the user who cancelled the shipment, or null while it has not been cancelled. */\n    cancelledBy?: string | null;\n    /** Why the shipment was cancelled, or null while it has not been. */\n    cancelledReason?: string | null;\n    /** Who carries the shipment, or null when no carrier is named. */\n    carrier?: Carrier | null;\n    /** When the shipment was created. */\n    createdAt?: string;\n    /** Who created the shipment. */\n    createdBy?: SparsePerson;\n    /** How long the shipment spent in each stage. */\n    cycleTime?: ShipmentCycleTime;\n    /** When the shipment arrived, or null while it has not. */\n    deliveredAt?: string | null;\n    /** The IANA time zone DeliveredAt was recorded in, or null when none was recorded. */\n    deliveredAtTimezone?: string | null;\n    /** The note written when the shipment was delivered, or null. */\n    deliveryNote?: string | null;\n    /** The sum of the lines' estimated values, or null when no line has an estimate. */\n    estimatedTotalValue?: string | null;\n    /** When the carrier now expects to deliver, or null when it says nothing. */\n    eta?: string | null;\n    /** The day the shipment is expected to arrive, or null when no one has said. */\n    expectedDeliveredOn?: string | null;\n    /** The day the shipment is expected to leave, or null when no one has said. */\n    expectedShippedOn?: string | null;\n    /** Where the shipment leaves from, or null when an inbound shipment names no origin. */\n    fromLocation?: SparseLocationWithIntegration | null;\n    /** The fulfillment order an outbound shipment fills, or null when it fills none. */\n    fulfillmentOrder?: SparseFulfillment | null;\n    /** The shipment's unique identifier. */\n    id?: string;\n    /** The shipment's line items. */\n    items?: ShipmentLineItem[];\n    /** The shipment's key, which the shipment endpoints take as shipmentKey. */\n    key?: string;\n    /** The carrier's name when Carrier is other, or null. */\n    otherCarrier?: string | null;\n    /** The purchase order an inbound shipment fills, or null when it fills none. */\n    purchaseOrder?: SparsePurchaseOrder | null;\n    /** The note written when the shipment was received, or null. */\n    receiptNote?: string | null;\n    /** When an inbound shipment's items were received, or null while they have not been. */\n    receivedAt?: string | null;\n    /** The IANA time zone ReceivedAt was recorded in, or null when none was recorded. */\n    receivedAtTimezone?: string | null;\n    /** The number the carrier tracks the shipment by, or null when it has none. */\n    referenceNumber?: string | null;\n    /** The return order an inbound shipment fills, or null when it fills none. */\n    returnOrder?: SparseReturnOrder | null;\n    /** The carrier's service the shipment travels on, or null when the carrier names none. */\n    serviceLevelName?: string | null;\n    /** The note written about the shipment itself, or null. */\n    shipmentNote?: string | null;\n    /** The number the shipment is known by. */\n    shipmentNumber?: string;\n    /** Whether the shipment is INBOUND to the organization or OUTBOUND from it. */\n    shipmentType?: ShipmentType | null;\n    /** When the shipment left, or null while it has not. */\n    shippedAt?: string | null;\n    /** The IANA time zone ShippedAt was recorded in, or null when none was recorded. */\n    shippedAtTimezone?: string | null;\n    /** What the shipment cost to send, or null when no cost is recorded. */\n    shippingCost?: Currency | null;\n    /** Where the shipment is in its life: OPEN, SHIPPED, DELIVERED, RECEIVED or CANCELLED. */\n    status?: ShipmentStatus;\n    /** Whether a third-party provider holds the shipment, which refuses changes made through the API. */\n    thirdPartyBound?: boolean;\n    /** How many days the shipment has held its status, or null once it is received or cancelled. */\n    timeInStatusDays?: string | null;\n    /** Where the shipment is going. */\n    toLocation?: SparseLocationWithIntegration;\n    /** What the shipment's assets are worth, or null when it has none to value. */\n    totalValue?: string | null;\n}\n\nexport interface ShipmentCycleTime {\n    /** The days from the shipment's creation to its ship time, or null while it has not shipped. */\n    createdToShippedDays?: string | null;\n    /** The days from the shipment's ship time to its delivery, or null while it has not been delivered. */\n    shippedToDeliveredDays?: string | null;\n}\n\nexport interface ShipmentItem {\n    /** The line's identifier in another system, or null when it has none. */\n    externalReference?: string | null;\n    /** The ID of the item the line carries. */\n    itemId?: string;\n    /** How many units the line ships, which an outbound shipment requires above 0 and an inbound shipment may leave null. */\n    quantity?: number | null;\n    /** The serial numbers of the units, for an item that is tracked by serial. */\n    serials?: string[];\n}\n\nexport interface ShipmentLineItem {\n    /** What the line was estimated to be worth while the shipment was open, or null when no estimate was made. */\n    estimatedValue?: string | null;\n    /** The line's identifier in the system that reported it, or null when it has none. */\n    externalReference?: string | null;\n    /** The item the line carries. */\n    item?: SparseItem;\n    /** The number of serial numbers in PendingSerials. */\n    pendingSerialCount?: number;\n    /** The serial numbers a third-party provider has reported but not yet confirmed as shipped. */\n    pendingSerials?: string[];\n    /** How many units the line ships, or null when the line was added without one. */\n    quantity?: number | null;\n    /** How many units arrived, or null until an inbound shipment is received. */\n    receivedQuantity?: number | null;\n    /** The number of serial numbers in Serials. */\n    serialCount?: number;\n    /** The serial numbers of the line's units, which is empty for an item that is not tracked by serial. */\n    serials?: string[];\n    /** What the line's assets are worth, or null when it has none to value. */\n    value?: string | null;\n}\n\nexport interface ShipmentListing {\n    /** The shipments on the page. */\n    results?: Shipment[];\n    /** The number of shipments the filters match, across every page. */\n    totalCount?: number;\n}\n\nexport interface ShipmentReceiveItem {\n    /** The line's identifier in another system, or null when it has none. */\n    externalReference?: string | null;\n    /** The ID of the item that arrived, which may be named once. */\n    itemId?: string;\n    /** How many units arrived, which is required and may be 0 for a line that did not arrive. */\n    quantity?: number | null;\n    /** The serial numbers of the units that arrived, for an item that is tracked by serial. */\n    serials?: string[];\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ShipmentStatus = \"CANCELLED\" | \"DELIVERED\" | \"OPEN\" | \"RECEIVED\" | \"SHIPPED\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type ShipmentType = \"INBOUND\" | \"OUTBOUND\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type SortOrder = \"ASC\" | \"DESC\";\n\nexport interface SparseActiveWorkflow {\n    id?: string;\n    key?: string;\n    name?: string;\n    stages?: SparseWorkflowStage[];\n}\n\nexport interface SparseAsset {\n    /** Whether the asset works, is broken, awaits review, or has been scrapped. */\n    functionalStatus?: AssetFunctionalStatus;\n    /** The asset's unique identifier. */\n    id?: string;\n    /** The day the asset entered inventory. */\n    inInventoryDate?: string;\n    /** Whether the asset is archived. */\n    isArchived?: boolean;\n    /** Whether the asset has shipped and not yet been delivered. */\n    isInTransit?: boolean;\n    /** The catalog item the asset is a unit of. */\n    item?: SparseItem;\n    /** The asset's key, which the asset endpoints take as assetKey. */\n    key?: string;\n    /** The asset's serial number, unique within its item. */\n    serial?: string;\n}\n\nexport interface SparseCustomer {\n    /** The customer's unique identifier. */\n    id?: string;\n    /** Whether the customer is archived. */\n    isArchived?: boolean;\n    /** Whether the company is a customer. */\n    isCustomer?: boolean;\n    /** Whether the company is a supplier. */\n    isSupplier?: boolean;\n    /** The customer's key, which the customer endpoints take as customerKey. */\n    key?: string;\n    /** The customer's display name. */\n    name?: string;\n}\n\nexport interface SparseFulfillment {\n    /** The number the fulfillment order is known by. */\n    foNumber?: string;\n    /** The fulfillment order's unique identifier. */\n    id?: string;\n    /** Whether a third-party provider fulfills the order. */\n    isThirdPartyFulfilled?: boolean;\n    /** The fulfillment order's key. */\n    key?: string;\n}\n\nexport interface SparseItem {\n    /** Whether each unit of the item is tracked as its own asset, which is true for a DEVICE item. */\n    hasAssets?: boolean;\n    /** The item's unique identifier. */\n    id?: string;\n    /** Whether the item is archived. */\n    isArchived?: boolean;\n    /** Whether the item is physical, which is true for DEVICE and BULK items. */\n    isPhysical?: boolean;\n    /** The item's key, which the item endpoints take as itemKey. */\n    key?: string;\n    /** The item's display name. */\n    name?: string;\n    /** Whether the item's units carry serial numbers, which is true for a DEVICE item and for a BULK item that accepts serials. */\n    shouldRenderSerialFields?: boolean;\n    /** The item's stock keeping unit, unique within your organization. */\n    sku?: string;\n    /** SERVICE for a non-physical item, DEVICE for a physical item tracked by serial number, or BULK for a part tracked by quantity. */\n    type?: FrontendItemType;\n    /** The unit the item's quantities are counted in. */\n    unitOfMeasure?: UnitOfMeasure;\n}\n\nexport type SparseLocation = MetadataLocationSite & {\n    /** The number of archived zones at a site. */\n    archivedZoneCount?: number;\n    /** The customer a zone is designated for, such as for reservations, provisioning or a 3PL. */\n    consignee?: SparseCustomer | null;\n    /** The customer the location is assigned to, which a zone reads from its parent site, or null for your organization's own locations. */\n    customer?: SparseCustomer | null;\n    /** A free-form description of a zone. */\n    description?: string | null;\n    /** The location's unique identifier. */\n    id?: string;\n    /** Whether Google resolved the site's address, which is always false for a zone. */\n    isAddressGeocoded?: boolean;\n    /** Whether the location is archived. */\n    isArchived?: boolean;\n    /** Whether assets at the location count as inventory for reporting. */\n    isInventory?: boolean;\n    /** Whether a zone sets its own isInventory rather than inheriting its parent site's. */\n    isInventoryOverride?: boolean;\n    /** Whether a third-party logistics (3PL) provider fulfills orders from the location. */\n    isThirdPartyEnabled?: boolean;\n    /** Whether assets make only occasional or temporary stops at the location, which hides it from location lists by default. */\n    isTransient?: boolean;\n    /** The location's key, which the location endpoints take as locationKey. */\n    key?: string;\n    /** The location's display name. */\n    name?: string;\n    /** The 3PL provider's identifier for the location. */\n    thirdPartyIdentifier?: string | null;\n    /** SITE for a site, or ZONE for a zone within a site. */\n    type?: LocationType;\n    /** The number of zones at a site. */\n    zoneCount?: number;\n    /** The site's zones. */\n    zones?: SparseZone[];\n};\n\nexport type SparseLocationWithIntegration = SparseLocationWithParent & {\n    /** The location's links to integrated systems. */\n    integrations?: SharedIntegration[];\n};\n\nexport type SparseLocationWithParent = SparseLocation & {\n    /** The site a zone belongs to, or null for a site. */\n    parentLocation?: SparseLocation | null;\n};\n\nexport interface SparseOrganization {\n    /** The organization's ID */\n    id?: string;\n    /** The public identifier that can be used in URLs */\n    key?: string;\n    /** The name of the organization */\n    name?: string;\n}\n\nexport interface SparsePerson {\n    /** The person's first name. */\n    firstName?: string | null;\n    /** The person's unique identifier. */\n    id?: string;\n    /** The person's key. */\n    key?: string;\n    /** The person's last name. */\n    lastName?: string | null;\n}\n\nexport interface SparseProject {\n    /** The customer the project is for. */\n    customer?: SparseCustomer | null;\n    /** The day the project ends. */\n    endOn?: string | null;\n    /** The project's unique identifier. */\n    id?: string;\n    /** The project's links to integrated systems. */\n    integrations?: SharedIntegration[];\n    /** Whether the project is archived. */\n    isArchived?: boolean;\n    /** The project's key. */\n    key?: string;\n    /** The project's display name. */\n    name?: string;\n    /** The name of the project's payment term. */\n    paymentTermLabel?: string | null;\n    /** The customer's purchase order number, which new invoices for the project carry. */\n    purchaseOrderNumber?: string | null;\n    /** The day the project starts. */\n    startOn?: string | null;\n    /** Whether the project is upcoming, active, or past, judged from its dates. */\n    status?: ProjectStatus;\n}\n\nexport interface SparsePurchaseOrder {\n    /** The supplier's own number for the purchase order, or null when it has none. */\n    externalPoNumber?: string | null;\n    /** The purchase order's unique identifier. */\n    id?: string;\n    /** The purchase order's key. */\n    key?: string;\n    /** The number the purchase order is known by. */\n    poNumber?: string;\n}\n\nexport interface SparseReturnOrder {\n    /** The return order's unique identifier. */\n    id?: string;\n    /** The return order's key. */\n    key?: string;\n    /** The number the return order is known by. */\n    roNumber?: string;\n}\n\nexport interface SparseShipment {\n    /** When the shipment arrived, or null while it has not. */\n    deliveredAt?: string | null;\n    /** The shipment's unique identifier. */\n    id?: string;\n    /** The shipment's key. */\n    key?: string;\n    /** The number the shipment is known by. */\n    shipmentNumber?: string;\n    /** What kind of movement the shipment carries. */\n    shipmentType?: string;\n    /** When the shipment left, or null while it has not. */\n    shippedAt?: string | null;\n}\n\nexport interface SparseWorkflowStage {\n    active?: boolean;\n    id?: string;\n    key?: string;\n    name?: string;\n    order?: number;\n}\n\nexport interface SparseZone {\n    /** The number of assets in the zone. */\n    assetCount?: number;\n    /** The customer the zone is designated for, such as for reservations, provisioning or a 3PL. */\n    consignee?: SparseCustomer | null;\n    /** A free-form description of the zone. */\n    description?: string | null;\n    /** The zone's unique identifier. */\n    id?: string;\n    /** Whether the zone is archived. */\n    isArchived?: boolean;\n    /** Whether assets in the zone count as inventory for reporting. */\n    isInventory?: boolean;\n    /** The zone's key. */\n    key?: string;\n    /** The zone's display name, unique within its site. */\n    name?: string;\n}\n\nexport interface Token {\n    /** When the API key was created, the application was connected, or the person signed in. */\n    createdAt?: string;\n    /** When the access token or session expires, or null for an API key, which does not. */\n    expiresAt?: string | null;\n    /** The API key's public identifier or the application's client_id, or null for a session. */\n    identifier?: string | null;\n    /** The API key's label or the application's name, or null when there is none. */\n    label?: string | null;\n    /** When the API key was last regenerated or the access token was issued, or null for a session. */\n    lastRegeneratedAt?: string | null;\n    /** The organization the credential acts in. */\n    organization?: SparseOrganization;\n    /** The person the credential acts for. */\n    person?: SparsePerson;\n    scopes?: string[];\n    /** The kind of credential. */\n    type?: CredentialType;\n}\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type TransactionType = \"SALE\" | \"SERVICE\";\n\n/** Accepted in any case, and also as t, f, 1, 0, or 2 for all. The listed spelling is the one the API sends back. */\nexport type TransientState = \"all\" | \"false\" | \"true\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type TransitStatus = \"IN_TRANSIT\" | \"IN_TRANSIT_TO_FIELD\" | \"IN_TRANSIT_TO_INVENTORY\" | \"NOT_IN_TRANSIT\";\n\nexport interface URLLink {\n    /** When the link was created. */\n    createdAt?: string;\n    /** The URL link's unique identifier. */\n    id?: string;\n    /** The URL link's key, which the URL link endpoints take as linkKey. */\n    key?: string;\n    /** The link's display name, or null when the link shows its address instead. */\n    name?: string | null;\n    /** When the link was last changed. */\n    updatedAt?: string;\n    /** The address the link points to. */\n    url?: string;\n}\n\n/** The unit a quantity is counted in, sent as its UNECE Recommendation 20 code. Accepted in any case. The listed spelling is the one the API sends back. | Value | Description | | --- | --- | | `BG` | Bag | | `BO` | Bottle | | `BX` | Box | | `C62` | Unit | | `CMK` | Square centimeter (cm2) | | `CMT` | Centimeter (cm) | | `CR` | Crate | | `CS` | Case | | `CT` | Carton | | `DMQ` | Cubic decimeter (dm3) | | `DR` | Drum | | `DZN` | Dozen (doz) | | `EA` | Each (ea) | | `EN` | Envelope | | `FOT` | Foot (ft) | | `FTK` | Square foot (ft2) | | `FTQ` | Cubic foot (ft3) | | `GLL` | Gallon (gal) | | `GRM` | Gram (g) | | `GRO` | Gross | | `H87` | Piece (pc) | | `INH` | Inch (in) | | `INK` | Square inch (in2) | | `INQ` | Cubic inch (in3) | | `KG` | Keg | | `KGM` | Kilogram (kg) | | `KMT` | Kilometer (km) | | `KT` | Kit | | `LBR` | Pound (lb) | | `LO` | Lot | | `LTR` | Liter (L) | | `MGM` | Milligram (mg) | | `MLT` | Milliliter (mL) | | `MMK` | Square millimeter (mm2) | | `MMT` | Millimeter (mm) | | `MTK` | Square meter (m2) | | `MTQ` | Cubic meter (m3) | | `MTR` | Meter (m) | | `ONZ` | Ounce (oz) | | `OZA` | Fluid ounce (fl oz) | | `PK` | Pack | | `PR` | Pair (pr) | | `PTI` | Pint (pt) | | `PX` | Pallet | | `QTI` | Quart (qt) | | `RL` | Reel | | `RO` | Roll | | `SET` | Set | | `SMI` | Mile (mi) | | `ST` | Sheet | | `STN` | Ton US (NT) | | `SV` | Skid | | `TNE` | Tonne metric (t) | | `TU` | Tube | | `YDK` | Square yard (yd2) | | `YDQ` | Cubic yard (yd3) | | `YRD` | Yard (yd) | */\nexport type UnitOfMeasure = \"BG\" | \"BO\" | \"BX\" | \"C62\" | \"CMK\" | \"CMT\" | \"CR\" | \"CS\" | \"CT\" | \"DMQ\" | \"DR\" | \"DZN\" | \"EA\" | \"EN\" | \"FOT\" | \"FTK\" | \"FTQ\" | \"GLL\" | \"GRM\" | \"GRO\" | \"H87\" | \"INH\" | \"INK\" | \"INQ\" | \"KG\" | \"KGM\" | \"KMT\" | \"KT\" | \"LBR\" | \"LO\" | \"LTR\" | \"MGM\" | \"MLT\" | \"MMK\" | \"MMT\" | \"MTK\" | \"MTQ\" | \"MTR\" | \"ONZ\" | \"OZA\" | \"PK\" | \"PR\" | \"PTI\" | \"PX\" | \"QTI\" | \"RL\" | \"RO\" | \"SET\" | \"SMI\" | \"ST\" | \"STN\" | \"SV\" | \"TNE\" | \"TU\" | \"YDK\" | \"YDQ\" | \"YRD\";\n\n/** Accepted in any case. The listed spelling is the one the API sends back. */\nexport type UsefulLifeRevisionReason = \"CHANGE_IN_USE\" | \"DAMAGE\" | \"OBSOLESCENCE\" | \"OTHER\" | \"REASSESSMENT\" | \"REFURBISHMENT\" | \"REGULATORY\";\n\nexport interface Workflow {\n    /** When the workflow was created. */\n    createdAt?: string;\n    /** The workflow's identifier. */\n    id?: string;\n    /** Whether this is the organization's default workflow. */\n    isDefault?: boolean;\n    /** The workflow's key. */\n    key?: string;\n    /** The workflow's name. */\n    name?: string;\n    /** The stages a project on this workflow moves through, in order. */\n    stages?: WorkflowStage[];\n    /** When the workflow was last changed. */\n    updatedAt?: string;\n}\n\nexport interface WorkflowStage {\n    /** When the stage was created. */\n    createdAt?: string;\n    /** The stage's identifier. */\n    id?: string;\n    /** The number of projects on the stage. */\n    inUseCount?: number;\n    /** The stage's key. */\n    key?: string;\n    /** The stage's name. */\n    name?: string;\n    /** The stage's position in its workflow. */\n    orderIndex?: number;\n    /** When the stage was last changed. */\n    updatedAt?: string;\n}\n";
 //#endregion
 //#region src/command/types.ts
 const typesCommand = defineCommand({
@@ -4239,7 +4309,7 @@ const REFUSED_COMMANDS = /* @__PURE__ */ new Map([
 /**
 * toParsed asks the CLI's own parser what a call would run, without running it. The server
 * decides from this answer and never from the words themselves, because a word such as
-* --help may be a flag's value, and a flag given twice takes its last value.
+* --help may be a flag's value, and a flag given twice is a mistake the parser refuses.
 */
 function toParsed(args, commands) {
 	let ran;
@@ -4690,14 +4760,14 @@ const commands = [
 							queryName: "page",
 							description: "The page to return, starting at 1",
 							valueName: "number",
-							schema: z.coerce.number().int()
+							schema: toNumber(z.number().int())
 						},
 						{
 							name: "limit",
 							queryName: "limit",
 							description: "The number of records per page, from 1 to 100",
 							valueName: "number",
-							schema: z.coerce.number().int().min(1).max(100)
+							schema: toNumber(z.number().int().min(1).max(100))
 						},
 						{
 							name: "sort-by",
@@ -4831,10 +4901,15 @@ const commands = [
 						{
 							name: "with-project-status",
 							queryName: "withProjectStatus",
-							description: "The project assignments to list: upcoming, active, past, or none",
+							description: "The project assignments to list: UPCOMING, ACTIVE, PAST, or NONE",
 							valueName: "value",
 							repeatable: true,
-							schema: z.array(z.string())
+							schema: z.array(toEnum([
+								"ACTIVE",
+								"NONE",
+								"PAST",
+								"UPCOMING"
+							]))
 						},
 						{
 							name: "with-owner",
@@ -4869,7 +4944,7 @@ const commands = [
 				defineOperation({
 					name: "create",
 					summary: "Create asset",
-					example: "hardfin asset create --item-id <uuid> --serial <value>",
+					example: "hardfin asset create --in-inventory-date <value> --item-id <uuid> --location-id <uuid>",
 					method: "POST",
 					path: "/asset",
 					pathParameters: [],
@@ -4954,6 +5029,7 @@ const commands = [
 							jsonPath: ["inInventoryDate"],
 							description: "The day the asset entered inventory, which cannot be in the future",
 							valueName: "value",
+							required: true,
 							schema: z.string()
 						},
 						{
@@ -4993,6 +5069,7 @@ const commands = [
 							jsonPath: ["locationId"],
 							description: "The ID of the location the asset enters inventory at",
 							valueName: "uuid",
+							required: true,
 							schema: z.uuid()
 						},
 						{
@@ -5038,10 +5115,10 @@ const commands = [
 						{
 							name: "useful-life",
 							jsonPath: ["usefulLife"],
-							description: "The number of months one unit is depreciated over, or null to clear it",
+							description: "The number of months one unit is depreciated over, from 1 to 480, or null to clear it",
 							valueName: "number",
 							nullable: true,
-							schema: z.coerce.number().int()
+							schema: toNumber(z.number().int())
 						}
 					]
 				}),
@@ -5217,7 +5294,6 @@ const commands = [
 							jsonPath: ["serial"],
 							description: "The asset's new serial number, which cannot be empty",
 							valueName: "value",
-							nullable: true,
 							schema: z.string()
 						}
 					]
@@ -5361,10 +5437,10 @@ const commands = [
 							{
 								name: "useful-life",
 								jsonPath: ["usefulLife"],
-								description: "The number of months one unit is depreciated over, or null to clear it",
+								description: "The number of months one unit is depreciated over, from 1 to 480, or null to clear it",
 								valueName: "number",
 								nullable: true,
-								schema: z.coerce.number().int()
+								schema: toNumber(z.number().int())
 							}
 						]
 					}), {
@@ -5932,13 +6008,279 @@ const commands = [
 								description: "The asset's revised useful life in months",
 								valueName: "number",
 								required: true,
-								schema: z.coerce.number().int()
+								schema: toNumber(z.number().int())
 							}
 						]
 					})]
 				}
 			]
 		},
+		{
+			name: "charge",
+			summary: "Charge commands",
+			arguments: [],
+			flags: [],
+			examples: [],
+			subcommands: [
+				defineOperation({
+					name: "list",
+					summary: "Get charges",
+					example: "hardfin charge list --limit 10",
+					method: "GET",
+					path: "/charge",
+					pathParameters: [],
+					queryFlags: [
+						{
+							name: "page",
+							queryName: "page",
+							description: "The page to return, starting at 1",
+							valueName: "number",
+							schema: toNumber(z.number().int())
+						},
+						{
+							name: "limit",
+							queryName: "limit",
+							description: "The number of records per page, from 1 to 100",
+							valueName: "number",
+							schema: toNumber(z.number().int().min(1).max(100))
+						},
+						{
+							name: "sort-by",
+							queryName: "sortBy",
+							description: "The field to sort by",
+							valueName: "value",
+							schema: toEnum([
+								"project",
+								"customer",
+								"label",
+								"totalPrice",
+								"servicePeriodStart",
+								"expectedBillableDate",
+								"status",
+								"item"
+							])
+						},
+						{
+							name: "sort-order",
+							queryName: "sortOrder",
+							description: "The sort direction",
+							valueName: "value",
+							schema: toEnum(["ASC", "DESC"])
+						},
+						{
+							name: "archived",
+							queryName: "archived",
+							description: "Whether to return unarchived records, archived records, or all of them",
+							valueName: "value",
+							schema: toEnum([
+								"all",
+								"false",
+								"true"
+							])
+						},
+						{
+							name: "search",
+							queryName: "search",
+							description: "Text to find in the charge's label, its project's name, its customer's name, or its item's SKU or name, and a number also finds a charge with exactly that total price",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "status",
+							queryName: "status",
+							description: "The one status to list: PLANNED, BILLABLE, INVOICED or CANCELLED",
+							valueName: "value",
+							schema: toEnum([
+								"BILLABLE",
+								"CANCELLED",
+								"INVOICED",
+								"PLANNED"
+							])
+						},
+						{
+							name: "customers",
+							queryName: "customers",
+							description: "The customers whose charges to list, each named by its ID or its key",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(z.string())
+						},
+						{
+							name: "include-no-customer",
+							queryName: "includeNoCustomer",
+							description: "True to also list the charges of projects that have no customer, alongside any Customers named",
+							schema: z.boolean()
+						},
+						{
+							name: "projects",
+							queryName: "projects",
+							description: "The projects whose charges to list, each named by its ID or its key",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(z.string())
+						},
+						{
+							name: "bill-date-start",
+							queryName: "billDateStart",
+							description: "A day, and only charges whose ExpectedBillableDate is on or after it are listed",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "bill-date-end",
+							queryName: "billDateEnd",
+							description: "A day, and only charges whose ExpectedBillableDate is on or before it are listed",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "amount-min",
+							queryName: "amountMin",
+							description: "An amount, and only charges whose total price is at least it are listed",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "amount-max",
+							queryName: "amountMax",
+							description: "An amount, and only charges whose total price is at most it are listed",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "trigger-types",
+							queryName: "triggerTypes",
+							description: "The trigger types to list: TIME, MANUAL or EVENT",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(toEnum([
+								"EVENT",
+								"MANUAL",
+								"TIME"
+							]))
+						}
+					],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "cancel",
+					summary: "Cancel charge",
+					example: "hardfin charge cancel chrg_9kp3xv7mq2wrt5bz",
+					method: "POST",
+					path: "/charge/{chargeKey}/cancel",
+					pathParameters: [{
+						name: "chargeKey",
+						description: "The key of the charge to cancel",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [{
+						name: "cancellation-reason",
+						jsonPath: ["cancellationReason"],
+						description: "Why the charge is cancelled, kept exactly as sent and 4,096 characters or less, or null for no reason",
+						valueName: "value",
+						nullable: true,
+						schema: z.string()
+					}]
+				}),
+				defineOperation({
+					name: "mark-billable",
+					summary: "Mark charge billable",
+					example: "hardfin charge mark-billable chrg_9kp3xv7mq2wrt5bz --billing-eligible-date <value> --quantity <number>",
+					method: "POST",
+					path: "/charge/{chargeKey}/mark-billable",
+					pathParameters: [{
+						name: "chargeKey",
+						description: "The key of the charge to mark billable",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "billing-eligible-date",
+							jsonPath: ["billingEligibleDate"],
+							description: "The day the charge became billable, which is required and does not change its ExpectedBillableDate",
+							valueName: "value",
+							required: true,
+							schema: z.string()
+						},
+						{
+							name: "quantity",
+							jsonPath: ["quantity"],
+							description: "The number of units to bill now, from 1 to the charge's quantity, and a smaller number splits the charge in two",
+							valueName: "number",
+							required: true,
+							schema: toNumber(z.number().int())
+						},
+						{
+							name: "service-period-end",
+							jsonPath: ["servicePeriodEnd"],
+							description: "The last day of the period the charge covers, required with ServicePeriodStart",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "service-period-start",
+							jsonPath: ["servicePeriodStart"],
+							description: "The first day of the period the charge covers, required when a milestone charge has no dates yet and ignored otherwise",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "total-price-override-amount",
+							jsonPath: ["totalPriceOverride", "amount"],
+							description: "The value as a decimal string with two decimal places",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "total-price-override-iso-code",
+							jsonPath: ["totalPriceOverride", "isoCode"],
+							description: "The value's ISO 4217 currency code",
+							valueName: "value",
+							schema: z.string()
+						}
+					]
+				}),
+				defineOperation({
+					name: "mark-not-billable",
+					summary: "Mark charge not billable",
+					example: "hardfin charge mark-not-billable chrg_9kp3xv7mq2wrt5bz",
+					method: "POST",
+					path: "/charge/{chargeKey}/mark-not-billable",
+					pathParameters: [{
+						name: "chargeKey",
+						description: "The key of the charge to return to planned",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [{
+						name: "expected-billable-date",
+						jsonPath: ["expectedBillableDate"],
+						description: "The new day the charge is planned to become billable, or omitted to keep the day it has",
+						valueName: "value",
+						nullable: true,
+						schema: z.string()
+					}]
+				}),
+				defineOperation({
+					name: "revert-cancellation",
+					summary: "Revert charge cancellation",
+					example: "hardfin charge revert-cancellation chrg_9kp3xv7mq2wrt5bz",
+					method: "POST",
+					path: "/charge/{chargeKey}/revert-cancellation",
+					pathParameters: [{
+						name: "chargeKey",
+						description: "The key of the cancelled charge to restore",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: []
+				})
+			]
+		},
 		{
 			name: "customer",
 			summary: "Customer commands",
@@ -5959,21 +6301,26 @@ const commands = [
 							queryName: "page",
 							description: "The page to return, starting at 1",
 							valueName: "number",
-							schema: z.coerce.number().int()
+							schema: toNumber(z.number().int())
 						},
 						{
 							name: "limit",
 							queryName: "limit",
 							description: "The number of records per page, from 1 to 100",
 							valueName: "number",
-							schema: z.coerce.number().int().min(1).max(100)
+							schema: toNumber(z.number().int().min(1).max(100))
 						},
 						{
 							name: "sort-by",
 							queryName: "sortBy",
 							description: "The field to sort by",
 							valueName: "value",
-							schema: z.string()
+							schema: toEnum([
+								"name",
+								"locationCount",
+								"assetCount",
+								"assetsAtLocation"
+							])
 						},
 						{
 							name: "sort-order",
@@ -6011,12 +6358,16 @@ const commands = [
 							description: "The CRM sync statuses to return: in-sync, out-of-sync, or not-linked",
 							valueName: "value",
 							repeatable: true,
-							schema: z.array(z.string())
+							schema: z.array(toEnum([
+								"in-sync",
+								"out-of-sync",
+								"not-linked"
+							]))
 						},
 						{
 							name: "search",
 							queryName: "search",
-							description: "Text to match against customer names",
+							description: "Text to match against customer names, ignored when shorter than three characters",
 							valueName: "value",
 							schema: z.string()
 						}
@@ -6224,7 +6575,6 @@ const commands = [
 							jsonPath: ["name"],
 							description: "The customer's display name",
 							valueName: "value",
-							nullable: true,
 							schema: z.string()
 						}
 					]
@@ -6255,7 +6605,7 @@ const commands = [
 							description: "The kind of file uploaded, which is ASSET_FILE, the only kind the API uploads",
 							valueName: "value",
 							required: true,
-							schema: z.string()
+							schema: toEnum(["ASSET_FILE"])
 						},
 						{
 							name: "for-entity",
@@ -6268,7 +6618,7 @@ const commands = [
 						{
 							name: "is-public",
 							jsonPath: ["isPublic"],
-							description: "Whether any organization's API key may download the file, which is false unless sent as true",
+							description: "Whether any organization's API key may download the file, sent as true or false in any case, and false when left out",
 							schema: z.boolean()
 						}
 					]
@@ -6332,14 +6682,14 @@ const commands = [
 							queryName: "page",
 							description: "The page to return, starting at 1",
 							valueName: "number",
-							schema: z.coerce.number().int()
+							schema: toNumber(z.number().int())
 						},
 						{
 							name: "limit",
 							queryName: "limit",
 							description: "The number of records per page, from 1 to 100",
 							valueName: "number",
-							schema: z.coerce.number().int().min(1).max(100)
+							schema: toNumber(z.number().int().min(1).max(100))
 						},
 						{
 							name: "sort-by",
@@ -6376,7 +6726,13 @@ const commands = [
 							queryName: "excludeLinkedIntegration",
 							description: "An integration whose already-linked items to leave out",
 							valueName: "value",
-							schema: z.string()
+							schema: toEnum([
+								"HUBSPOT",
+								"NETSUITE",
+								"NONE",
+								"QBO",
+								"SFDC"
+							])
 						}
 					],
 					bodyFlags: []
@@ -6566,7 +6922,6 @@ const commands = [
 							jsonPath: ["isArchived"],
 							description: "Whether the item is archived, which cannot be null",
 							negatable: true,
-							nullable: true,
 							schema: z.boolean()
 						},
 						{
@@ -6574,7 +6929,6 @@ const commands = [
 							jsonPath: ["name"],
 							description: "The item's new display name, which cannot be empty",
 							valueName: "value",
-							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -6582,7 +6936,6 @@ const commands = [
 							jsonPath: ["sku"],
 							description: "The item's new stock keeping unit, which cannot be empty and must be unique within your organization",
 							valueName: "value",
-							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -6722,10 +7075,10 @@ const commands = [
 							{
 								name: "useful-life",
 								jsonPath: ["usefulLife"],
-								description: "The number of months one unit is depreciated over, or null to clear it",
+								description: "The number of months one unit is depreciated over, from 1 to 480, or null to clear it",
 								valueName: "number",
 								nullable: true,
-								schema: z.coerce.number().int()
+								schema: toNumber(z.number().int())
 							}
 						]
 					})]
@@ -6782,7 +7135,7 @@ const commands = [
 									valueName: "number",
 									required: true,
 									nullable: true,
-									schema: z.coerce.number().int()
+									schema: toNumber(z.number().int())
 								},
 								{
 									name: "section",
@@ -6791,7 +7144,7 @@ const commands = [
 									valueName: "number",
 									required: true,
 									nullable: true,
-									schema: z.coerce.number().int()
+									schema: toNumber(z.number().int())
 								}
 							]
 						}),
@@ -6816,7 +7169,6 @@ const commands = [
 								jsonPath: ["label"],
 								description: "The field's new display name, which cannot be empty",
 								valueName: "value",
-								nullable: true,
 								schema: z.string()
 							}]
 						}),
@@ -6862,14 +7214,14 @@ const commands = [
 							queryName: "page",
 							description: "The page to return, starting at 1",
 							valueName: "number",
-							schema: z.coerce.number().int()
+							schema: toNumber(z.number().int())
 						},
 						{
 							name: "limit",
 							queryName: "limit",
 							description: "The number of records per page, from 1 to 100",
 							valueName: "number",
-							schema: z.coerce.number().int().min(1).max(100)
+							schema: toNumber(z.number().int().min(1).max(100))
 						},
 						{
 							name: "sort-by",
@@ -6921,7 +7273,7 @@ const commands = [
 						{
 							name: "for-customer-ids",
 							queryName: "forCustomerIds",
-							description: "The IDs of the customers whose locations to return",
+							description: "The IDs of the customers whose locations to return, where ORGANIZATION stands for your organization's own locations",
 							valueName: "value",
 							repeatable: true,
 							schema: z.array(z.string())
@@ -6938,7 +7290,11 @@ const commands = [
 							description: "The CRM sync statuses to return: in-sync, out-of-sync, or not-linked",
 							valueName: "value",
 							repeatable: true,
-							schema: z.array(z.string())
+							schema: z.array(toEnum([
+								"in-sync",
+								"out-of-sync",
+								"not-linked"
+							]))
 						}
 					],
 					bodyFlags: []
@@ -6946,7 +7302,7 @@ const commands = [
 				defineOperation({
 					name: "create",
 					summary: "Create location",
-					example: "hardfin location create",
+					example: "hardfin location create --name <value> --type <value>",
 					method: "POST",
 					path: "/location",
 					pathParameters: [],
@@ -7058,6 +7414,7 @@ const commands = [
 							jsonPath: ["name"],
 							description: "The location's display name",
 							valueName: "value",
+							required: true,
 							schema: z.string()
 						},
 						{
@@ -7073,12 +7430,9 @@ const commands = [
 							jsonPath: ["type"],
 							description: "SITE for a site, or ZONE for a zone within a site",
 							valueName: "value",
+							required: true,
 							nullable: true,
-							schema: toEnum([
-								"SITE",
-								"UNKNOWN",
-								"ZONE"
-							])
+							schema: toEnum(["SITE", "ZONE"])
 						}
 					]
 				}),
@@ -7168,7 +7522,7 @@ const commands = [
 						{
 							name: "consignee",
 							jsonPath: ["consignee"],
-							description: "The ID of the customer a zone is designated for, such as for reservations, provisioning or a 3PL",
+							description: "The ID of the customer a zone is designated for, such as for reservations, provisioning or a 3PL, which a site refuses",
 							valueName: "uuid",
 							nullable: true,
 							schema: z.uuid()
@@ -7176,7 +7530,7 @@ const commands = [
 						{
 							name: "customer-id",
 							jsonPath: ["customerId"],
-							description: "The ID of the customer to assign a site to, or null for your organization's own site",
+							description: "The ID of the customer to assign a site to, or null for your organization's own site, which a zone refuses",
 							valueName: "uuid",
 							nullable: true,
 							schema: z.uuid()
@@ -7184,7 +7538,7 @@ const commands = [
 						{
 							name: "description",
 							jsonPath: ["description"],
-							description: "A free-form description of a zone",
+							description: "A free-form description of a zone, which a site refuses",
 							valueName: "value",
 							nullable: true,
 							schema: z.string()
@@ -7216,7 +7570,7 @@ const commands = [
 						{
 							name: "is-transient",
 							jsonPath: ["isTransient"],
-							description: "Whether assets make only occasional or temporary stops at the location, which hides it from location lists by default",
+							description: "Whether assets make only occasional or temporary stops at the location, which hides it from location lists by default, and which a zone refuses",
 							negatable: true,
 							nullable: true,
 							schema: z.boolean()
@@ -7226,7 +7580,6 @@ const commands = [
 							jsonPath: ["name"],
 							description: "The location's display name",
 							valueName: "value",
-							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -7235,11 +7588,7 @@ const commands = [
 							description: "SITE for a site, or ZONE for a zone within a site",
 							valueName: "value",
 							nullable: true,
-							schema: toEnum([
-								"SITE",
-								"UNKNOWN",
-								"ZONE"
-							])
+							schema: toEnum(["SITE", "ZONE"])
 						}
 					]
 				}),
@@ -7277,39 +7626,1912 @@ const commands = [
 			]
 		},
 		{
-			name: "token",
-			summary: "Token commands",
+			name: "meta",
+			summary: "Meta commands",
 			arguments: [],
 			flags: [],
 			examples: [],
-			subcommands: [defineOperation({
-				name: "get",
-				summary: "Report the credential this CLI is calling with",
-				example: "hardfin token get",
-				method: "GET",
-				path: "/token",
-				pathParameters: [],
-				queryFlags: [],
-				bodyFlags: []
-			})]
+			subcommands: [{
+				name: "payment-terms",
+				summary: "Payment terms commands",
+				arguments: [],
+				flags: [],
+				examples: [],
+				subcommands: [defineOperation({
+					name: "list",
+					summary: "Get payment terms",
+					example: "hardfin meta payment-terms list",
+					method: "GET",
+					path: "/meta/payment-terms",
+					pathParameters: [],
+					queryFlags: [],
+					bodyFlags: []
+				})]
+			}]
 		},
 		{
-			name: "url-link",
-			summary: "URL link commands",
+			name: "project",
+			summary: "Project commands",
 			arguments: [],
 			flags: [],
 			examples: [],
 			subcommands: [
 				defineOperation({
-					name: "get",
-					summary: "Get URL link by key",
-					example: "hardfin url-link get link_7hq2mx9pcr4stz8w",
+					name: "list",
+					summary: "Get projects",
+					example: "hardfin project list --limit 10",
 					method: "GET",
-					path: "/url-link/{linkKey}",
-					pathParameters: [{
-						name: "linkKey",
-						description: "The URL link's key",
-						required: true
+					path: "/project",
+					pathParameters: [],
+					queryFlags: [
+						{
+							name: "page",
+							queryName: "page",
+							description: "The page to return, starting at 1",
+							valueName: "number",
+							schema: toNumber(z.number().int())
+						},
+						{
+							name: "limit",
+							queryName: "limit",
+							description: "The number of records per page, from 1 to 100",
+							valueName: "number",
+							schema: toNumber(z.number().int().min(1).max(100))
+						},
+						{
+							name: "sort-by",
+							queryName: "sortBy",
+							description: "The field to sort by",
+							valueName: "value",
+							schema: toEnum([
+								"name",
+								"startOn",
+								"endOn",
+								"workflow"
+							])
+						},
+						{
+							name: "sort-order",
+							queryName: "sortOrder",
+							description: "The sort direction",
+							valueName: "value",
+							schema: toEnum(["ASC", "DESC"])
+						},
+						{
+							name: "archived",
+							queryName: "archived",
+							description: "Whether to return unarchived records, archived records, or all of them",
+							valueName: "value",
+							schema: toEnum([
+								"all",
+								"false",
+								"true"
+							])
+						},
+						{
+							name: "search",
+							queryName: "search",
+							description: "Text of three or more characters to find in the project's name or description, its customer's name, or the items and locations of its line items",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "customer-ids",
+							queryName: "customerIds",
+							description: "The IDs of the customers whose projects to list",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "item-ids",
+							queryName: "itemIds",
+							description: "The IDs of the items whose projects to list, which are the projects with a line item for the item or holding one of its assets",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "project-ids",
+							queryName: "projectIds",
+							description: "The IDs of the projects to list",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "location-ids",
+							queryName: "locationIds",
+							description: "The IDs of the locations whose projects to list, which are the projects with a line item at the location or with it as their default location",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "statuses",
+							queryName: "statuses",
+							description: "The statuses to list: UPCOMING, ACTIVE, PAST, or DATE_RANGE_INCOMPLETE for a project missing a start or an end",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(toEnum([
+								"ACTIVE",
+								"DATE_RANGE_INCOMPLETE",
+								"PAST",
+								"UPCOMING"
+							]))
+						},
+						{
+							name: "start-by",
+							queryName: "startBy",
+							description: "A day, and only projects that start on or before it are listed",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "end-by",
+							queryName: "endBy",
+							description: "A day, and only projects that end on or before it are listed",
+							valueName: "value",
+							schema: z.string()
+						}
+					],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "create",
+					summary: "Create project",
+					example: "hardfin project create --line-item aggregationKey=<value>,itemId=<value>,quantity=<value>,transactionType=<value> --name <value>",
+					method: "POST",
+					path: "/project",
+					pathParameters: [],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "contract-signed-on",
+							jsonPath: ["contractSignedOn"],
+							description: "The day the contract was signed",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "customer-id",
+							jsonPath: ["customerId"],
+							description: "The ID of the customer the project is for",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "default-location-id",
+							jsonPath: ["defaultLocationId"],
+							description: "The ID of the project's default location",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "description",
+							jsonPath: ["description"],
+							description: "The project's description",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "end-on",
+							jsonPath: ["endOn"],
+							description: "The day the project ends",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "file-ids",
+							jsonPath: ["fileIds"],
+							description: "The IDs of uploaded files to attach to the project",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "inherit-previous-line-items",
+							jsonPath: ["inheritPreviousLineItems"],
+							description: "Whether to copy the line items of the project this one renews, which applies only when PreviousProjectID is sent",
+							negatable: true,
+							nullable: true,
+							schema: z.boolean()
+						},
+						{
+							name: "initial-workflow-stage-id",
+							jsonPath: ["initialWorkflowStageId"],
+							description: "The ID of the workflow stage the project starts on, which defaults to the workflow's first stage",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "install-date",
+							jsonPath: ["installDate"],
+							description: "The day of the installation",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "line-item",
+							jsonPath: ["lineItems"],
+							description: "The project's line items, each an item the project sells or provides as a service. Takes activationDate=, aggregationKey=, billingFrequency=, chargeFrequency=, chargeSchedule=, details=, endOn=, fixedPrice=, fixedPrice.amount=, fixedPrice.isoCode=, id=, invoiceFrequency=, invoiceMode=, itemId=, locationId=, milestonePhases=, pricingMode=, quantity=, startOn=, totalOverride=, totalOverride.amount=, totalOverride.isoCode=, transactionType=, unitPrice=, unitPrice.amount=, unitPrice.isoCode=",
+							valueName: "field=value,...",
+							repeatable: true,
+							element: [
+								"activationDate",
+								"aggregationKey",
+								"billingFrequency",
+								"chargeFrequency",
+								"chargeSchedule",
+								"details",
+								"endOn",
+								"fixedPrice",
+								"fixedPrice.amount",
+								"fixedPrice.isoCode",
+								"id",
+								"invoiceFrequency",
+								"invoiceMode",
+								"itemId",
+								"locationId",
+								"milestonePhases",
+								"pricingMode",
+								"quantity",
+								"startOn",
+								"totalOverride",
+								"totalOverride.amount",
+								"totalOverride.isoCode",
+								"transactionType",
+								"unitPrice",
+								"unitPrice.amount",
+								"unitPrice.isoCode"
+							],
+							elementUuids: [
+								"aggregationKey",
+								"id",
+								"itemId",
+								"locationId"
+							],
+							elementTypes: {
+								"activationDate": ["string", "null"],
+								"billingFrequency": ["string", "null"],
+								"chargeFrequency": ["string", "null"],
+								"chargeSchedule": ["string", "null"],
+								"details": ["string", "null"],
+								"endOn": ["string", "null"],
+								"fixedPrice": ["null"],
+								"id": ["string", "null"],
+								"invoiceFrequency": ["string", "null"],
+								"invoiceMode": ["string", "null"],
+								"locationId": ["string", "null"],
+								"milestonePhases": ["object", "null"],
+								"pricingMode": ["string", "null"],
+								"quantity": ["integer"],
+								"startOn": ["string", "null"],
+								"totalOverride": ["null"],
+								"unitPrice": ["null"]
+							},
+							schema: z.array(z.string())
+						},
+						{
+							name: "name",
+							jsonPath: ["name"],
+							description: "The project's name, which no other project in the organization may share",
+							valueName: "value",
+							required: true,
+							schema: z.string()
+						},
+						{
+							name: "previous-project-id",
+							jsonPath: ["previousProjectId"],
+							description: "The ID of the project this one renews",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "start-on",
+							jsonPath: ["startOn"],
+							description: "The day the project starts",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "total-contract-value-amount",
+							jsonPath: ["totalContractValue", "amount"],
+							description: "The value as a decimal string with two decimal places",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "total-contract-value-iso-code",
+							jsonPath: ["totalContractValue", "isoCode"],
+							description: "The value's ISO 4217 currency code",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "workflow-id",
+							jsonPath: ["workflowId"],
+							description: "The ID of the workflow to put the project on",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						}
+					]
+				}),
+				defineOperation({
+					name: "get",
+					summary: "Get project",
+					example: "hardfin project get proj_7hq2lm9xcr4twz8k",
+					method: "GET",
+					path: "/project/{projectKey}",
+					pathParameters: [{
+						name: "projectKey",
+						description: "The project's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "update",
+					summary: "Patch project",
+					example: "hardfin project update proj_7hq2lm9xcr4twz8k --line-item aggregationKey=<value>,itemId=<value>,quantity=<value>,transactionType=<value>",
+					method: "PATCH",
+					path: "/project/{projectKey}",
+					pathParameters: [{
+						name: "projectKey",
+						description: "The project's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "acceptance-date",
+							jsonPath: ["acceptanceDate"],
+							description: "The day the customer accepted the project",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "billing-address",
+							jsonPath: ["billingAddress"],
+							description: "The billing address the project's invoices use in place of the customer's",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "billing-contact-email",
+							jsonPath: ["billingContactEmail"],
+							description: "The billing contact email the project's invoices use in place of the customer's",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "billing-contact-name",
+							jsonPath: ["billingContactName"],
+							description: "The billing contact name the project's invoices use in place of the customer's",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "billing-contact-phone",
+							jsonPath: ["billingContactPhone"],
+							description: "The billing contact phone number the project's invoices use in place of the customer's",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "contract-signed-on",
+							jsonPath: ["contractSignedOn"],
+							description: "The day the contract was signed",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "customer-id",
+							jsonPath: ["customerId"],
+							description: "The ID of the customer the project is for",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "default-location-id",
+							jsonPath: ["defaultLocationId"],
+							description: "The ID of the project's default location",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "description",
+							jsonPath: ["description"],
+							description: "The project's description",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "discount-amount",
+							jsonPath: ["discount", "amount"],
+							description: "The value as a decimal string with two decimal places",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "discount-iso-code",
+							jsonPath: ["discount", "isoCode"],
+							description: "The value's ISO 4217 currency code",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "end-on",
+							jsonPath: ["endOn"],
+							description: "The day the project ends",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "go-live-date",
+							jsonPath: ["goLiveDate"],
+							description: "The day the project goes live",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "install-date",
+							jsonPath: ["installDate"],
+							description: "The day of the installation",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "is-archived",
+							jsonPath: ["isArchived"],
+							description: "Whether the project is archived",
+							negatable: true,
+							nullable: true,
+							schema: z.boolean()
+						},
+						{
+							name: "line-item",
+							jsonPath: ["lineItems"],
+							description: "The project's line items. Takes activationDate=, aggregationKey=, billingFrequency=, chargeFrequency=, chargeSchedule=, details=, endOn=, fixedPrice=, fixedPrice.amount=, fixedPrice.isoCode=, id=, invoiceFrequency=, invoiceMode=, itemId=, locationId=, milestonePhases=, pricingMode=, quantity=, startOn=, totalOverride=, totalOverride.amount=, totalOverride.isoCode=, transactionType=, unitPrice=, unitPrice.amount=, unitPrice.isoCode=",
+							valueName: "field=value,...",
+							repeatable: true,
+							element: [
+								"activationDate",
+								"aggregationKey",
+								"billingFrequency",
+								"chargeFrequency",
+								"chargeSchedule",
+								"details",
+								"endOn",
+								"fixedPrice",
+								"fixedPrice.amount",
+								"fixedPrice.isoCode",
+								"id",
+								"invoiceFrequency",
+								"invoiceMode",
+								"itemId",
+								"locationId",
+								"milestonePhases",
+								"pricingMode",
+								"quantity",
+								"startOn",
+								"totalOverride",
+								"totalOverride.amount",
+								"totalOverride.isoCode",
+								"transactionType",
+								"unitPrice",
+								"unitPrice.amount",
+								"unitPrice.isoCode"
+							],
+							elementUuids: [
+								"aggregationKey",
+								"id",
+								"itemId",
+								"locationId"
+							],
+							elementTypes: {
+								"activationDate": ["string", "null"],
+								"billingFrequency": ["string", "null"],
+								"chargeFrequency": ["string", "null"],
+								"chargeSchedule": ["string", "null"],
+								"details": ["string", "null"],
+								"endOn": ["string", "null"],
+								"fixedPrice": ["null"],
+								"id": ["string", "null"],
+								"invoiceFrequency": ["string", "null"],
+								"invoiceMode": ["string", "null"],
+								"locationId": ["string", "null"],
+								"milestonePhases": ["object", "null"],
+								"pricingMode": ["string", "null"],
+								"quantity": ["integer"],
+								"startOn": ["string", "null"],
+								"totalOverride": ["null"],
+								"unitPrice": ["null"]
+							},
+							schema: z.array(z.string())
+						},
+						{
+							name: "memo",
+							jsonPath: ["memo"],
+							description: "The memo new invoices for the project carry",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "name",
+							jsonPath: ["name"],
+							description: "The project's new name, which no other project in the organization may share",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "payment-term",
+							jsonPath: ["paymentTerm"],
+							description: "The project's payment term, named by the ID or the label the payment term list returns",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "previous-project-id",
+							jsonPath: ["previousProjectId"],
+							description: "The ID of the project this one renews",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "purchase-order-number",
+							jsonPath: ["purchaseOrderNumber"],
+							description: "The customer's purchase order number, which new invoices for the project carry",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "site-visit-date",
+							jsonPath: ["siteVisitDate"],
+							description: "The day of the site visit",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "start-on",
+							jsonPath: ["startOn"],
+							description: "The day the project starts",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "total-contract-value-amount",
+							jsonPath: ["totalContractValue", "amount"],
+							description: "The value as a decimal string with two decimal places",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "total-contract-value-iso-code",
+							jsonPath: ["totalContractValue", "isoCode"],
+							description: "The value's ISO 4217 currency code",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "training-date",
+							jsonPath: ["trainingDate"],
+							description: "The day of the training",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "workflow-id",
+							jsonPath: ["workflowId"],
+							description: "The ID of the workflow to put the project on",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "workflow-stage-id",
+							jsonPath: ["workflowStageId"],
+							description: "The ID of the workflow stage to move the project to, which has to belong to the project's workflow",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						}
+					]
+				}),
+				{
+					name: "line-item",
+					summary: "Line item commands",
+					arguments: [],
+					flags: [],
+					examples: [],
+					subcommands: [defineOperation({
+						name: "update",
+						summary: "Patch project line item",
+						example: "hardfin project line-item update proj_7hq2lm9xcr4twz8k ppb_4tn8wq2zkv7mx9cr --charge isCustomModified=<value>,label=<value>,pricingMode=<value>,quantity=<value>,sequence=<value>,status=<value>,triggerType=<value> --milestone-phases-entry name=<value>,percentage=<value>",
+						method: "PATCH",
+						path: "/project/{projectKey}/line-item/{lineItemKey}",
+						pathParameters: [{
+							name: "projectKey",
+							description: "The key of the project the line item belongs to",
+							required: true
+						}, {
+							name: "lineItemKey",
+							description: "The key of the line item to update",
+							required: true
+						}],
+						queryFlags: [],
+						bodyFlags: [
+							{
+								name: "activation-date",
+								jsonPath: ["activationDate"],
+								description: "The day a periodic line item's charge schedule is anchored on",
+								valueName: "value",
+								nullable: true,
+								schema: z.string()
+							},
+							{
+								name: "billing-frequency",
+								jsonPath: ["billingFrequency"],
+								description: "The line item's single billing cadence",
+								valueName: "value",
+								nullable: true,
+								schema: toEnum([
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								])
+							},
+							{
+								name: "charge-frequency",
+								jsonPath: ["chargeFrequency"],
+								description: "How often a periodic line item creates a charge, and is refused unless ChargeSchedule is PERIODIC",
+								valueName: "value",
+								nullable: true,
+								schema: toEnum([
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								])
+							},
+							{
+								name: "charge-mode",
+								jsonPath: ["chargeMode"],
+								description: "CONFIRMED when ActivationDate is sent, or PENDING when it is null, and a MILESTONE line item is CONFIRMED with no ActivationDate",
+								valueName: "value",
+								nullable: true,
+								schema: toEnum(["CONFIRMED", "PENDING"])
+							},
+							{
+								name: "charge-schedule",
+								jsonPath: ["chargeSchedule"],
+								description: "PERIODIC when charges recur at a regular frequency, or MILESTONE when each charge follows a project milestone",
+								valueName: "value",
+								nullable: true,
+								schema: toEnum(["MILESTONE", "PERIODIC"])
+							},
+							{
+								name: "charge",
+								jsonPath: ["charges"],
+								description: "The line item's whole charge list, which replaces the charges it has, or omitted to leave them as they are. Takes expectedBillableDate=, id=, isCustomModified=, label=, pricingMode=, quantity=, sequence=, servicePeriodEnd=, servicePeriodStart=, status=, totalPrice.amount=, totalPrice.isoCode=, triggerType=, unitPrice=, unitPrice.amount=, unitPrice.isoCode=",
+								valueName: "field=value,...",
+								repeatable: true,
+								element: [
+									"expectedBillableDate",
+									"id",
+									"isCustomModified",
+									"label",
+									"pricingMode",
+									"quantity",
+									"sequence",
+									"servicePeriodEnd",
+									"servicePeriodStart",
+									"status",
+									"totalPrice.amount",
+									"totalPrice.isoCode",
+									"triggerType",
+									"unitPrice",
+									"unitPrice.amount",
+									"unitPrice.isoCode"
+								],
+								elementUuids: ["id"],
+								elementTypes: {
+									"expectedBillableDate": ["string", "null"],
+									"id": ["string", "null"],
+									"isCustomModified": ["boolean"],
+									"quantity": ["integer"],
+									"sequence": ["integer"],
+									"servicePeriodEnd": ["string", "null"],
+									"servicePeriodStart": ["string", "null"],
+									"unitPrice": ["null"]
+								},
+								schema: z.array(z.string())
+							},
+							{
+								name: "details",
+								jsonPath: ["details"],
+								description: "A free-form note about the line item, 65,536 characters or less",
+								valueName: "value",
+								nullable: true,
+								schema: z.string()
+							},
+							{
+								name: "fixed-price-amount",
+								jsonPath: ["fixedPrice", "amount"],
+								description: "The value as a decimal string with two decimal places",
+								valueName: "value",
+								schema: z.string()
+							},
+							{
+								name: "fixed-price-iso-code",
+								jsonPath: ["fixedPrice", "isoCode"],
+								description: "The value's ISO 4217 currency code",
+								valueName: "value",
+								schema: z.string()
+							},
+							{
+								name: "generate",
+								jsonPath: ["generate"],
+								description: "True to replace the line item's charges with the schedule its billing plan produces, and is not sent together with Charges",
+								negatable: true,
+								schema: z.boolean()
+							},
+							{
+								name: "invoice-frequency",
+								jsonPath: ["invoiceFrequency"],
+								description: "How often a periodic line item's charges are invoiced, which is never more often than ChargeFrequency",
+								valueName: "value",
+								nullable: true,
+								schema: toEnum([
+									"ANNUALLY",
+									"BIENNIALLY",
+									"BIWEEKLY",
+									"DAILY",
+									"MONTHLY",
+									"ONCE",
+									"QUADRENNIALLY",
+									"QUARTERLY",
+									"QUINQUENNIALLY",
+									"SEMIANNUALLY",
+									"TRIENNIALLY",
+									"WEEKLY"
+								])
+							},
+							{
+								name: "invoice-mode",
+								jsonPath: ["invoiceMode"],
+								description: "ADVANCE to invoice a period before it starts, or ARREARS to invoice it after it ends, and is refused unless ChargeSchedule is PERIODIC",
+								valueName: "value",
+								nullable: true,
+								schema: toEnum(["ADVANCE", "ARREARS"])
+							},
+							{
+								name: "item-id",
+								jsonPath: ["itemId"],
+								description: "The catalog item the line item is for",
+								valueName: "uuid",
+								nullable: true,
+								schema: z.uuid()
+							},
+							{
+								name: "location-id",
+								jsonPath: ["locationId"],
+								description: "The location the line item is for",
+								valueName: "uuid",
+								nullable: true,
+								schema: z.uuid()
+							},
+							{
+								name: "milestone-phases-entry",
+								jsonPath: ["milestonePhases", "entries"],
+								description: "The phases, in order",
+								valueName: "name=,percentage=",
+								repeatable: true,
+								element: ["name", "percentage"],
+								elementTypes: { "percentage": ["string", "null"] },
+								schema: z.array(z.string())
+							},
+							{
+								name: "milestone-phases-mode",
+								jsonPath: ["milestonePhases", "mode"],
+								description: "PERCENTAGE, the only way a phase's share is expressed",
+								valueName: "value",
+								schema: z.string()
+							},
+							{
+								name: "pricing-mode",
+								jsonPath: ["pricingMode"],
+								description: "PER_UNIT to charge the unit price for each unit, or FIXED to charge the fixed price whatever the quantity",
+								valueName: "value",
+								nullable: true,
+								schema: toEnum(["FIXED", "PER_UNIT"])
+							},
+							{
+								name: "quantity",
+								jsonPath: ["quantity"],
+								description: "The number of units the line item covers, which is zero or more",
+								valueName: "number",
+								nullable: true,
+								schema: toNumber(z.number().int())
+							},
+							{
+								name: "total-override-amount",
+								jsonPath: ["totalOverride", "amount"],
+								description: "The value as a decimal string with two decimal places",
+								valueName: "value",
+								schema: z.string()
+							},
+							{
+								name: "total-override-iso-code",
+								jsonPath: ["totalOverride", "isoCode"],
+								description: "The value's ISO 4217 currency code",
+								valueName: "value",
+								schema: z.string()
+							},
+							{
+								name: "transaction-type",
+								jsonPath: ["transactionType"],
+								description: "SALE to sell the item, which only a physical item allows, or SERVICE to provide it as a service",
+								valueName: "value",
+								nullable: true,
+								schema: toEnum(["SALE", "SERVICE"])
+							},
+							{
+								name: "unit-price-amount",
+								jsonPath: ["unitPrice", "amount"],
+								description: "The value as a decimal string with two decimal places",
+								valueName: "value",
+								schema: z.string()
+							},
+							{
+								name: "unit-price-iso-code",
+								jsonPath: ["unitPrice", "isoCode"],
+								description: "The value's ISO 4217 currency code",
+								valueName: "value",
+								schema: z.string()
+							}
+						]
+					}), {
+						name: "charges",
+						summary: "Charges commands",
+						arguments: [],
+						flags: [],
+						examples: [],
+						subcommands: [defineOperation({
+							name: "list",
+							summary: "Get project line item charges",
+							example: "hardfin project line-item charges list proj_7hq2lm9xcr4twz8k ppb_4tn8wq2zkv7mx9cr",
+							method: "GET",
+							path: "/project/{projectKey}/line-item/{lineItemKey}/charges",
+							pathParameters: [{
+								name: "projectKey",
+								description: "The key of the project the line item belongs to",
+								required: true
+							}, {
+								name: "lineItemKey",
+								description: "The key of the line item whose charges to return",
+								required: true
+							}],
+							queryFlags: [],
+							bodyFlags: []
+						})]
+					}]
+				}
+			]
+		},
+		{
+			name: "shipment",
+			summary: "Shipment commands",
+			arguments: [],
+			flags: [],
+			examples: [],
+			subcommands: [
+				defineOperation({
+					name: "list",
+					summary: "List shipments",
+					example: "hardfin shipment list --limit 10",
+					method: "GET",
+					path: "/shipment",
+					pathParameters: [],
+					queryFlags: [
+						{
+							name: "page",
+							queryName: "page",
+							description: "The page to return, starting at 1",
+							valueName: "number",
+							schema: toNumber(z.number().int())
+						},
+						{
+							name: "limit",
+							queryName: "limit",
+							description: "The number of records per page, from 1 to 100",
+							valueName: "number",
+							schema: toNumber(z.number().int().min(1).max(100))
+						},
+						{
+							name: "sort-by",
+							queryName: "sortBy",
+							description: "The field to sort by",
+							valueName: "value",
+							schema: toEnum([
+								"shipmentNumber",
+								"shippingCostAmount",
+								"totalValue",
+								"status"
+							])
+						},
+						{
+							name: "sort-order",
+							queryName: "sortOrder",
+							description: "The sort direction",
+							valueName: "value",
+							schema: toEnum(["ASC", "DESC"])
+						},
+						{
+							name: "archived",
+							queryName: "archived",
+							description: "Whether to return unarchived records, archived records, or all of them",
+							valueName: "value",
+							schema: toEnum([
+								"all",
+								"false",
+								"true"
+							])
+						},
+						{
+							name: "status",
+							queryName: "status",
+							description: "The one status to list: OPEN, SHIPPED, DELIVERED, RECEIVED or CANCELLED",
+							valueName: "value",
+							schema: toEnum([
+								"CANCELLED",
+								"DELIVERED",
+								"OPEN",
+								"RECEIVED",
+								"SHIPPED"
+							])
+						},
+						{
+							name: "shipment-type",
+							queryName: "shipmentType",
+							description: "The one direction to list: INBOUND or OUTBOUND",
+							valueName: "value",
+							schema: toEnum(["INBOUND", "OUTBOUND"])
+						},
+						{
+							name: "search",
+							queryName: "search",
+							description: "Text to find in the shipment's number, its order numbers, its reference number, its locations' names, or its items' names and SKUs",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "fo-numbers",
+							queryName: "foNumbers",
+							description: "The fulfillment order numbers whose shipments to list",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(z.string())
+						},
+						{
+							name: "po-numbers",
+							queryName: "poNumbers",
+							description: "The purchase order numbers whose shipments to list",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(z.string())
+						},
+						{
+							name: "ro-numbers",
+							queryName: "roNumbers",
+							description: "The return order numbers whose shipments to list",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(z.string())
+						},
+						{
+							name: "location-ids",
+							queryName: "locationIds",
+							description: "The IDs of locations, and only shipments leaving from or going to one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "from-location-ids",
+							queryName: "fromLocationIds",
+							description: "The IDs of locations, and shipments leaving from one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "to-location-ids",
+							queryName: "toLocationIds",
+							description: "The IDs of locations, and shipments going to one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "from-customer-ids",
+							queryName: "fromCustomerIds",
+							description: "The IDs of customers, and shipments leaving from a location assigned to one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "to-customer-ids",
+							queryName: "toCustomerIds",
+							description: "The IDs of customers, and shipments going to a location assigned to one of them are listed",
+							valueName: "uuid",
+							repeatable: true,
+							schema: z.array(z.uuid())
+						},
+						{
+							name: "from-location-company-types",
+							queryName: "fromLocationCompanyTypes",
+							description: "The kind of site listed shipments leave from, a CUSTOMER site or one of the organization's own MANUFACTURER sites, and naming both filters nothing",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(toEnum(["CUSTOMER", "MANUFACTURER"]))
+						},
+						{
+							name: "to-location-company-types",
+							queryName: "toLocationCompanyTypes",
+							description: "The kind of site listed shipments go to, a CUSTOMER site or one of the organization's own MANUFACTURER sites, and naming both filters nothing",
+							valueName: "value",
+							repeatable: true,
+							schema: z.array(toEnum(["CUSTOMER", "MANUFACTURER"]))
+						}
+					],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "create",
+					summary: "Create shipment",
+					example: "hardfin shipment create --item externalReference=<value>,itemId=<value>,quantity=<value>,serials=<value> --shipment-type <value> --to-location-id <uuid>",
+					method: "POST",
+					path: "/shipment",
+					pathParameters: [],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "carrier",
+							jsonPath: ["carrier"],
+							description: "Who carries the shipment, or null when no carrier is named",
+							valueName: "value",
+							nullable: true,
+							schema: toEnum([
+								"airterra",
+								"apc_postal",
+								"apg",
+								"aramex",
+								"asendia_us",
+								"australia_post",
+								"axlehire",
+								"better_trucks",
+								"borderguru",
+								"boxberry",
+								"bring",
+								"canada_post",
+								"cdl",
+								"chronopost",
+								"colissimo",
+								"collect_plus",
+								"correios_br",
+								"correos_espana",
+								"couriersplease",
+								"deutsche_post",
+								"dhl_benelux",
+								"dhl_ecommerce",
+								"dhl_express",
+								"dhl_germany",
+								"dhl_germany_c2c",
+								"dpd_de",
+								"dpd_uk",
+								"estafeta",
+								"fastway_australia",
+								"fedex",
+								"globegistics",
+								"gls_us",
+								"gophr",
+								"gso",
+								"hermes_germany_b2c",
+								"hermes_uk",
+								"hongkong_post",
+								"la_poste",
+								"lasership",
+								"lso",
+								"mondial_relay",
+								"new_zealand_post",
+								"nippon_express",
+								"ontrac",
+								"orangeds",
+								"other",
+								"parcel",
+								"parcelforce",
+								"passport",
+								"pcf",
+								"pitney_bowes",
+								"poste_italiane",
+								"posti",
+								"purolator",
+								"royal_mail",
+								"royal_mail_sf",
+								"rr_donnelley",
+								"russian_post",
+								"sendle",
+								"shippo",
+								"skypostal",
+								"stuart",
+								"swyft",
+								"uds",
+								"ups",
+								"usps",
+								"veho",
+								"x_delivery",
+								"yodel"
+							])
+						},
+						{
+							name: "delivered-at",
+							jsonPath: ["deliveredAt"],
+							description: "When the shipment arrived, which cannot be before ShippedAt, or null while it has not",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "delivered-at-timezone",
+							jsonPath: ["deliveredAtTimezone"],
+							description: "The IANA time zone DeliveredAt is recorded in",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "expected-delivered-on",
+							jsonPath: ["expectedDeliveredOn"],
+							description: "The day the shipment is expected to arrive, which on an inbound shipment cannot be before ExpectedShippedOn",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "expected-shipped-on",
+							jsonPath: ["expectedShippedOn"],
+							description: "The day the shipment is expected to leave",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "from-location-id",
+							jsonPath: ["fromLocationId"],
+							description: "The ID of the location the shipment leaves from, which an outbound shipment requires",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "fulfillment-order-number",
+							jsonPath: ["fulfillmentOrderNumber"],
+							description: "The number of the fulfillment order an outbound shipment fills, or null for none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "item",
+							jsonPath: ["items"],
+							description: "The shipment's line items, from 1 to 100 of them",
+							valueName: "externalReference=,itemId=,quantity=,serials=",
+							repeatable: true,
+							required: true,
+							element: [
+								"externalReference",
+								"itemId",
+								"quantity",
+								"serials"
+							],
+							elementUuids: ["itemId"],
+							elementTypes: {
+								"externalReference": ["string", "null"],
+								"quantity": ["integer", "null"],
+								"serials": ["array"]
+							},
+							elementLists: ["serials"],
+							schema: z.array(z.string())
+						},
+						{
+							name: "other-carrier",
+							jsonPath: ["otherCarrier"],
+							description: "The carrier's name when Carrier is other",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "purchase-order-number",
+							jsonPath: ["purchaseOrderNumber"],
+							description: "The number of the purchase order an inbound shipment fills, or null for none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "reference-number",
+							jsonPath: ["referenceNumber"],
+							description: "The number the carrier tracks the shipment by, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "return-order-number",
+							jsonPath: ["returnOrderNumber"],
+							description: "The number of the return order an inbound shipment fills, or null for none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipment-note",
+							jsonPath: ["shipmentNote"],
+							description: "A note about the shipment",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipment-type",
+							jsonPath: ["shipmentType"],
+							description: "Whether the shipment is INBOUND to the organization or OUTBOUND from it",
+							valueName: "value",
+							required: true,
+							schema: toEnum(["INBOUND", "OUTBOUND"])
+						},
+						{
+							name: "shipped-at",
+							jsonPath: ["shippedAt"],
+							description: "When the shipment left, or null while it has not",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipped-at-timezone",
+							jsonPath: ["shippedAtTimezone"],
+							description: "The IANA time zone ShippedAt is recorded in",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipping-cost-amount",
+							jsonPath: ["shippingCost", "amount"],
+							description: "The value as a decimal string with two decimal places",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "shipping-cost-iso-code",
+							jsonPath: ["shippingCost", "isoCode"],
+							description: "The value's ISO 4217 currency code",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "to-location-id",
+							jsonPath: ["toLocationId"],
+							description: "The ID of the location the shipment is going to",
+							valueName: "uuid",
+							required: true,
+							schema: z.uuid()
+						}
+					]
+				}),
+				defineOperation({
+					name: "get",
+					summary: "Get shipment",
+					example: "hardfin shipment get shp_2wn8kq4lxp7rtz3m",
+					method: "GET",
+					path: "/shipment/{shipmentKey}",
+					pathParameters: [{
+						name: "shipmentKey",
+						description: "The shipment's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: []
+				}),
+				defineOperation({
+					name: "update",
+					summary: "Update shipment",
+					example: "hardfin shipment update shp_2wn8kq4lxp7rtz3m --item externalReference=<value>,itemId=<value>,quantity=<value>,serials=<value>",
+					method: "PATCH",
+					path: "/shipment/{shipmentKey}",
+					pathParameters: [{
+						name: "shipmentKey",
+						description: "The shipment's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "carrier",
+							jsonPath: ["carrier"],
+							description: "Who carries the shipment, or null when no carrier is named",
+							valueName: "value",
+							nullable: true,
+							schema: toEnum([
+								"airterra",
+								"apc_postal",
+								"apg",
+								"aramex",
+								"asendia_us",
+								"australia_post",
+								"axlehire",
+								"better_trucks",
+								"borderguru",
+								"boxberry",
+								"bring",
+								"canada_post",
+								"cdl",
+								"chronopost",
+								"colissimo",
+								"collect_plus",
+								"correios_br",
+								"correos_espana",
+								"couriersplease",
+								"deutsche_post",
+								"dhl_benelux",
+								"dhl_ecommerce",
+								"dhl_express",
+								"dhl_germany",
+								"dhl_germany_c2c",
+								"dpd_de",
+								"dpd_uk",
+								"estafeta",
+								"fastway_australia",
+								"fedex",
+								"globegistics",
+								"gls_us",
+								"gophr",
+								"gso",
+								"hermes_germany_b2c",
+								"hermes_uk",
+								"hongkong_post",
+								"la_poste",
+								"lasership",
+								"lso",
+								"mondial_relay",
+								"new_zealand_post",
+								"nippon_express",
+								"ontrac",
+								"orangeds",
+								"other",
+								"parcel",
+								"parcelforce",
+								"passport",
+								"pcf",
+								"pitney_bowes",
+								"poste_italiane",
+								"posti",
+								"purolator",
+								"royal_mail",
+								"royal_mail_sf",
+								"rr_donnelley",
+								"russian_post",
+								"sendle",
+								"shippo",
+								"skypostal",
+								"stuart",
+								"swyft",
+								"uds",
+								"ups",
+								"usps",
+								"veho",
+								"x_delivery",
+								"yodel"
+							])
+						},
+						{
+							name: "delivered-at",
+							jsonPath: ["deliveredAt"],
+							description: "When the shipment arrived, which cannot be before ShippedAt",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "delivered-at-timezone",
+							jsonPath: ["deliveredAtTimezone"],
+							description: "The IANA time zone DeliveredAt is recorded in",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "delivery-note",
+							jsonPath: ["deliveryNote"],
+							description: "The note written when the shipment was delivered",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "expected-delivered-on",
+							jsonPath: ["expectedDeliveredOn"],
+							description: "The day the shipment is expected to arrive, which on an inbound shipment cannot be before ExpectedShippedOn",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "expected-shipped-on",
+							jsonPath: ["expectedShippedOn"],
+							description: "The day the shipment is expected to leave",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "from-location-id",
+							jsonPath: ["fromLocationId"],
+							description: "The ID of the location the shipment leaves from, which an outbound shipment cannot clear",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						},
+						{
+							name: "fulfillment-order-number",
+							jsonPath: ["fulfillmentOrderNumber"],
+							description: "The number of the fulfillment order an outbound shipment fills, or null for none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "item",
+							jsonPath: ["items"],
+							description: "The 1 to 100 line items that replace the shipment's, where a line already on the shipment keeps its quantity when sent without one",
+							valueName: "externalReference=,itemId=,quantity=,serials=",
+							repeatable: true,
+							element: [
+								"externalReference",
+								"itemId",
+								"quantity",
+								"serials"
+							],
+							elementUuids: ["itemId"],
+							elementTypes: {
+								"externalReference": ["string", "null"],
+								"quantity": ["integer", "null"],
+								"serials": ["array"]
+							},
+							elementLists: ["serials"],
+							schema: z.array(z.string())
+						},
+						{
+							name: "other-carrier",
+							jsonPath: ["otherCarrier"],
+							description: "The carrier's name when Carrier is other",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "purchase-order-number",
+							jsonPath: ["purchaseOrderNumber"],
+							description: "The number of the purchase order an inbound shipment fills, or null for none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "receipt-note",
+							jsonPath: ["receiptNote"],
+							description: "The note written when the shipment was received",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "reference-number",
+							jsonPath: ["referenceNumber"],
+							description: "The number the carrier tracks the shipment by, or null when it has none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "return-order-number",
+							jsonPath: ["returnOrderNumber"],
+							description: "The number of the return order an inbound shipment fills, or null for none",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipment-note",
+							jsonPath: ["shipmentNote"],
+							description: "A note about the shipment",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipped-at",
+							jsonPath: ["shippedAt"],
+							description: "When the shipment left, or null while it has not",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipped-at-timezone",
+							jsonPath: ["shippedAtTimezone"],
+							description: "The IANA time zone ShippedAt is recorded in",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipping-cost-amount",
+							jsonPath: ["shippingCost", "amount"],
+							description: "The value as a decimal string with two decimal places",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "shipping-cost-iso-code",
+							jsonPath: ["shippingCost", "isoCode"],
+							description: "The value's ISO 4217 currency code",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "to-location-id",
+							jsonPath: ["toLocationId"],
+							description: "The ID of the location the shipment is going to, which cannot be cleared",
+							valueName: "uuid",
+							nullable: true,
+							schema: z.uuid()
+						}
+					]
+				}),
+				defineOperation({
+					name: "cancel",
+					summary: "Cancel shipment",
+					example: "hardfin shipment cancel shp_2wn8kq4lxp7rtz3m --reason <value>",
+					method: "POST",
+					path: "/shipment/{shipmentKey}/cancel",
+					pathParameters: [{
+						name: "shipmentKey",
+						description: "The shipment's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [{
+						name: "reason",
+						jsonPath: ["reason"],
+						description: "Why the shipment is cancelled, which is required",
+						valueName: "value",
+						required: true,
+						schema: z.string()
+					}, {
+						name: "remove-linked-shipping-cost",
+						jsonPath: ["removeLinkedShippingCost"],
+						description: "True to also remove the shipping cost recorded for the shipment",
+						negatable: true,
+						schema: z.boolean()
+					}]
+				}),
+				defineOperation({
+					name: "deliver",
+					summary: "Mark shipment as delivered",
+					example: "hardfin shipment deliver shp_2wn8kq4lxp7rtz3m --delivered-at <value> --delivery-location-id <uuid>",
+					method: "POST",
+					path: "/shipment/{shipmentKey}/deliver",
+					pathParameters: [{
+						name: "shipmentKey",
+						description: "The shipment's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "delivered-at",
+							jsonPath: ["deliveredAt"],
+							description: "When the shipment arrived",
+							valueName: "value",
+							required: true,
+							schema: z.string()
+						},
+						{
+							name: "delivered-at-timezone",
+							jsonPath: ["deliveredAtTimezone"],
+							description: "The IANA time zone DeliveredAt is recorded in",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "delivery-location-id",
+							jsonPath: ["deliveryLocationId"],
+							description: "The ID of the location the shipment was delivered to",
+							valueName: "uuid",
+							required: true,
+							schema: z.uuid()
+						},
+						{
+							name: "delivery-note",
+							jsonPath: ["deliveryNote"],
+							description: "A note about the delivery",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						}
+					]
+				}),
+				defineOperation({
+					name: "receive",
+					summary: "Mark inbound shipment as received",
+					example: "hardfin shipment receive shp_2wn8kq4lxp7rtz3m --item externalReference=<value>,itemId=<value>,quantity=<value>,serials=<value> --receive-location-id <uuid> --received-at <value>",
+					method: "POST",
+					path: "/shipment/{shipmentKey}/receive",
+					pathParameters: [{
+						name: "shipmentKey",
+						description: "The shipment's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "item",
+							jsonPath: ["items"],
+							description: "What arrived on each line",
+							valueName: "externalReference=,itemId=,quantity=,serials=",
+							repeatable: true,
+							element: [
+								"externalReference",
+								"itemId",
+								"quantity",
+								"serials"
+							],
+							elementUuids: ["itemId"],
+							elementTypes: {
+								"externalReference": ["string", "null"],
+								"quantity": ["integer", "null"],
+								"serials": ["array"]
+							},
+							elementLists: ["serials"],
+							schema: z.array(z.string())
+						},
+						{
+							name: "receipt-note",
+							jsonPath: ["receiptNote"],
+							description: "A note about the receipt",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "receive-location-id",
+							jsonPath: ["receiveLocationId"],
+							description: "The ID of the location the items were received at",
+							valueName: "uuid",
+							required: true,
+							schema: z.uuid()
+						},
+						{
+							name: "received-at",
+							jsonPath: ["receivedAt"],
+							description: "When the items were received",
+							valueName: "value",
+							required: true,
+							schema: z.string()
+						},
+						{
+							name: "received-at-timezone",
+							jsonPath: ["receivedAtTimezone"],
+							description: "The IANA time zone ReceivedAt is recorded in",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						}
+					]
+				}),
+				defineOperation({
+					name: "ship",
+					summary: "Mark outbound shipment as shipped",
+					example: "hardfin shipment ship shp_2wn8kq4lxp7rtz3m --item externalReference=<value>,itemId=<value>,quantity=<value>,serials=<value> --ship-location-id <uuid> --shipped-at <value>",
+					method: "POST",
+					path: "/shipment/{shipmentKey}/ship",
+					pathParameters: [{
+						name: "shipmentKey",
+						description: "The shipment's key",
+						required: true
+					}],
+					queryFlags: [],
+					bodyFlags: [
+						{
+							name: "item",
+							jsonPath: ["items"],
+							description: "What left on each line, with the serial numbers of the units tracked by serial",
+							valueName: "externalReference=,itemId=,quantity=,serials=",
+							repeatable: true,
+							element: [
+								"externalReference",
+								"itemId",
+								"quantity",
+								"serials"
+							],
+							elementUuids: ["itemId"],
+							elementTypes: {
+								"externalReference": ["string", "null"],
+								"quantity": ["integer", "null"],
+								"serials": ["array"]
+							},
+							elementLists: ["serials"],
+							schema: z.array(z.string())
+						},
+						{
+							name: "ship-location-id",
+							jsonPath: ["shipLocationId"],
+							description: "The ID of the location the shipment left from",
+							valueName: "uuid",
+							required: true,
+							schema: z.uuid()
+						},
+						{
+							name: "shipment-note",
+							jsonPath: ["shipmentNote"],
+							description: "A note about the shipment",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipped-at",
+							jsonPath: ["shippedAt"],
+							description: "When the shipment left",
+							valueName: "value",
+							required: true,
+							schema: z.string()
+						},
+						{
+							name: "shipped-at-timezone",
+							jsonPath: ["shippedAtTimezone"],
+							description: "The IANA time zone ShippedAt is recorded in",
+							valueName: "value",
+							nullable: true,
+							schema: z.string()
+						},
+						{
+							name: "shipping-cost-amount",
+							jsonPath: ["shippingCost", "amount"],
+							description: "The value as a decimal string with two decimal places",
+							valueName: "value",
+							schema: z.string()
+						},
+						{
+							name: "shipping-cost-iso-code",
+							jsonPath: ["shippingCost", "isoCode"],
+							description: "The value's ISO 4217 currency code",
+							valueName: "value",
+							schema: z.string()
+						}
+					]
+				}),
+				{
+					name: "tracking",
+					summary: "Tracking commands",
+					arguments: [],
+					flags: [],
+					examples: [],
+					subcommands: [defineOperation({
+						name: "list",
+						summary: "Get shipment tracking events",
+						example: "hardfin shipment tracking list shp_2wn8kq4lxp7rtz3m",
+						method: "GET",
+						path: "/shipment/{shipmentKey}/tracking",
+						pathParameters: [{
+							name: "shipmentKey",
+							description: "The shipment's key",
+							required: true
+						}],
+						queryFlags: [],
+						bodyFlags: []
+					})]
+				}
+			]
+		},
+		{
+			name: "token",
+			summary: "Token commands",
+			arguments: [],
+			flags: [],
+			examples: [],
+			subcommands: [defineOperation({
+				name: "get",
+				summary: "Report the credential this CLI is calling with",
+				example: "hardfin token get",
+				method: "GET",
+				path: "/token",
+				pathParameters: [],
+				queryFlags: [],
+				bodyFlags: []
+			})]
+		},
+		{
+			name: "url-link",
+			summary: "URL link commands",
+			arguments: [],
+			flags: [],
+			examples: [],
+			subcommands: [
+				defineOperation({
+					name: "get",
+					summary: "Get URL link by key",
+					example: "hardfin url-link get link_7hq2mx9pcr4stz8w",
+					method: "GET",
+					path: "/url-link/{linkKey}",
+					pathParameters: [{
+						name: "linkKey",
+						description: "The URL link's key",
+						required: true
 					}],
 					queryFlags: [],
 					bodyFlags: []
@@ -7329,16 +9551,15 @@ const commands = [
 					bodyFlags: [{
 						name: "name",
 						jsonPath: ["name"],
-						description: "The link's display name, or null to show the address instead",
+						description: "The link's display name, or null to show the address instead, and an update sends it, url, or both",
 						valueName: "value",
 						nullable: true,
 						schema: z.string()
 					}, {
 						name: "url",
 						jsonPath: ["url"],
-						description: "The address the link points to, which cannot be empty or null",
+						description: "The address the link points to, which cannot be empty, and an update sends it, name, or both",
 						valueName: "value",
-						nullable: true,
 						schema: z.string()
 					}]
 				}),
@@ -7357,6 +9578,36 @@ const commands = [
 					bodyFlags: []
 				})
 			]
+		},
+		{
+			name: "workflow",
+			summary: "Workflow commands",
+			arguments: [],
+			flags: [],
+			examples: [],
+			subcommands: [defineOperation({
+				name: "list",
+				summary: "Get workflows",
+				example: "hardfin workflow list",
+				method: "GET",
+				path: "/workflow",
+				pathParameters: [],
+				queryFlags: [],
+				bodyFlags: []
+			}), defineOperation({
+				name: "get",
+				summary: "Get workflow",
+				example: "hardfin workflow get wrkfl_6wqmaf1pp98jevep",
+				method: "GET",
+				path: "/workflow/{workflowKey}",
+				pathParameters: [{
+					name: "workflowKey",
+					description: "The workflow's key",
+					required: true
+				}],
+				queryFlags: [],
+				bodyFlags: []
+			})]
 		}
 	],
 	apiCommand,
@@ -7464,5 +9715,5 @@ async function toReported(error, isJSON, resolved, level = "error") {
 //#endregion
 export { toCli, toParseExitCode, toReported, wasReportAttempted, writeCrash };
 
-//# sourceMappingURL=program-CkKf46kC.js.map
-//# debugId=d29068e8-3e79-5da9-aa3a-0c5201101ca3
+//# sourceMappingURL=program-DW6GS9xO.js.map
+//# debugId=980cc947-6ea9-593a-bdbf-bc8ecfc40c65