@hardfin/cli 0.0.2-dev.12 → 0.0.2-dev.14

package/README.md

@@ -67,8 +67,19 @@ hardfin asset move execute create \
   --move assetId=ast_b2,locationId=loc_y
 ```
 
-An enum carries its values, so a wrong one fails locally with exit code 2 rather than at the
-API. A required field missing is caught the same way, before any request is made.
+A value is sent as the type the document names. `--useful-life 36` sends the number 36. A
+decimal such as `--salvage-value 1500.00` stays a string, which is how the API takes money
+without losing precision.
+
+Clear a field with `--unset`, naming the flag:
+
+```sh
+hardfin asset accounting update ast_4f9xk2mq7plr8stz --unset useful-life
+```
+
+Three things fail locally with exit code 2, before any request is made: a value outside an
+enum, a required field that is missing, and `--unset` on a field the API will not take null
+for.
 
 ### Overrides
 
@@ -274,9 +285,9 @@ Nothing secret is printed. An API key and a refresh token are each reported as a
 `sha256:` fingerprint, which identifies a credential across two machines without disclosing
 it.
 
-`refreshExpiresAt` is an estimate. Hardfin expires an unused refresh token after 90 days,
-but the token endpoint reports no expiry, so the CLI applies that rule to the date it last
-renewed. The flag `refreshExpiryIsEstimated` says so in the output.
+`refreshExpiresAt` is what the server said when it issued the token. A sign in stored before
+the server reported one falls back to Hardfin's 90-day rule, and `refreshExpiryIsEstimated`
+says which of the two you are looking at.
 
 ## Local configuration
 

package/dist/cli.js

@@ -293,6 +293,7 @@ const TokenResponse = z.looseObject({
 	token_type: z.string(),
 	expires_in: z.number().optional(),
 	refresh_token: z.string().optional(),
+	refresh_token_expires_in: z.number().optional(),
 	scope: z.string().optional()
 });
 /** GrantFailure is a token request the authorization server refused. */
@@ -351,6 +352,7 @@ async function toTokens(url, form) {
 	return {
 		accessToken: parsed.data.access_token,
 		refreshToken: parsed.data.refresh_token,
+		refreshExpiresAt: parsed.data.refresh_token_expires_in === void 0 ? void 0 : Date.now() + parsed.data.refresh_token_expires_in * 1e3,
 		scope: parsed.data.scope,
 		expiresAt: parsed.data.expires_in === void 0 ? void 0 : Date.now() + parsed.data.expires_in * 1e3
 	};
@@ -375,12 +377,13 @@ function toCredentialPath() {
 * family lifetime runs from. Callers hold the credential lock, which is what makes a write
 * from another process merge rather than disappear.
 */
-function keep(issuer, refreshToken) {
+function keep(issuer, refreshToken, expiresAt) {
 	const now = (/* @__PURE__ */ new Date()).toISOString();
 	const record = {
 		refreshToken,
 		signedInAt: toCredential(issuer)?.signedInAt ?? now,
-		renewedAt: now
+		renewedAt: now,
+		expiresAt: expiresAt === void 0 ? void 0 : new Date(expiresAt).toISOString()
 	};
 	const keyring = toKeyring(issuer);
 	if (keyring) try {
@@ -566,7 +569,7 @@ async function toAccessToken(settings, refreshToken) {
 		try {
 			const tokens = await toTokensFromRefresh(metadata.token_endpoint, settings.clientId, latest);
 			held.set(settings.issuerUrl, tokens);
-			if (tokens.refreshToken && tokens.refreshToken !== latest) keep(settings.issuerUrl, tokens.refreshToken);
+			if (tokens.refreshToken && tokens.refreshToken !== latest) keep(settings.issuerUrl, tokens.refreshToken, tokens.refreshExpiresAt);
 			return tokens;
 		} catch (error) {
 			if (error instanceof GrantFailure && isDead(error.code)) {
@@ -1366,7 +1369,7 @@ async function toSignedIn(input, metadata, tokens) {
 		writeFailure("the authorization server issued no refresh token, so this sign in cannot be kept", input.isJSON);
 		return ExitCode.ERROR;
 	}
-	const backend = await withLock(() => keep(input.resolved.settings.issuerUrl, refreshToken));
+	const backend = await withLock(() => keep(input.resolved.settings.issuerUrl, refreshToken, tokens.refreshExpiresAt));
 	if (input.isJSON) {
 		writeData({
 			signedIn: true,
@@ -1632,6 +1635,13 @@ async function runMcp(input) {
 }
 //#endregion
 //#region src/command/operation.ts
+const UNSET_FLAG = {
+	name: "unset",
+	description: "A field to clear, named as its flag is, repeatable",
+	valueName: "field",
+	repeatable: true,
+	schema: z.array(z.string())
+};
 const FILE_FLAG = {
 	name: "file",
 	description: "The file to upload",
@@ -1648,6 +1658,7 @@ function defineOperation(operation) {
 	const flags = [
 		...operation.queryFlags,
 		...operation.bodyFlags,
+		...operation.bodyFlags.some((flag) => flag.nullable) ? [UNSET_FLAG] : [],
 		...operation.upload ? [...operation.upload.fields, FILE_FLAG] : [],
 		JSON_FLAG
 	];
@@ -1661,6 +1672,10 @@ function defineOperation(operation) {
 			description: operation.summary,
 			command: operation.example
 		}] : [],
+		endpoint: {
+			method: operation.method,
+			path: operation.path
+		},
 		run: (input) => runOperation(operation, input)
 	};
 }
@@ -1764,10 +1779,25 @@ function toBody(operation, flags) {
 			hasField = true;
 			continue;
 		}
-		set(body, flag.jsonPath, value);
+		const parsed = flag.schema.safeParse(value);
+		set(body, flag.jsonPath, parsed.success ? parsed.data : value);
 		hasField = true;
 	}
-	return hasField ? body : void 0;
+	const cleared = toCleared(operation, flags, body);
+	if (cleared instanceof Error) return cleared;
+	return hasField || cleared ? body : void 0;
+}
+/** toCleared sends null for each field named by --unset, which is how a field is cleared. */
+function toCleared(operation, flags, body) {
+	const named = flags["unset"];
+	const names = Array.isArray(named) ? named.map(String) : named === void 0 ? [] : [String(named)];
+	for (const name of names) {
+		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`);
+		set(body, flag.jsonPath, null);
+	}
+	return names.length > 0;
 }
 /** toElements reads the key=value pairs a repeated flag carries for one array element. */
 function toElements(flag, values) {
@@ -2007,6 +2037,7 @@ const surfaceCommands = [
 						jsonPath: ["allocatedIndirect"],
 						description: "One unit's share of overhead, a cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2014,6 +2045,7 @@ const surfaceCommands = [
 						jsonPath: ["billOfMaterials"],
 						description: "The parts cost of one unit, a cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2033,6 +2065,7 @@ const surfaceCommands = [
 						jsonPath: ["description"],
 						description: "A free-form description of the asset",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2040,6 +2073,7 @@ const surfaceCommands = [
 						jsonPath: ["directLabor"],
 						description: "The labor cost to build one unit, a cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2047,6 +2081,7 @@ const surfaceCommands = [
 						jsonPath: ["freightInbound"],
 						description: "The shipping cost to receive one unit, a cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2054,6 +2089,7 @@ const surfaceCommands = [
 						jsonPath: ["freightOutbound"],
 						description: "The shipping cost to deploy one unit, a deployment cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2061,6 +2097,7 @@ const surfaceCommands = [
 						jsonPath: ["functionalStatus"],
 						description: "The asset's starting functional status, FUNCTIONAL when absent, which cannot be SCRAPPED",
 						valueName: "value",
+						nullable: true,
 						schema: z.enum([
 							"FUNCTIONAL",
 							"NEEDS_REVIEW",
@@ -2080,6 +2117,7 @@ const surfaceCommands = [
 						jsonPath: ["inServiceDate"],
 						description: "The day the asset was put into service, which Hardfin sets itself when absent",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2087,6 +2125,7 @@ const surfaceCommands = [
 						jsonPath: ["installation"],
 						description: "The cost to install one unit, a deployment cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2094,6 +2133,7 @@ const surfaceCommands = [
 						jsonPath: ["interest"],
 						description: "The financing cost of one unit, a cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2116,6 +2156,7 @@ const surfaceCommands = [
 						jsonPath: ["salvageValue"],
 						description: "The value one unit keeps at the end of its useful life, or null to clear it",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2131,6 +2172,7 @@ const surfaceCommands = [
 						jsonPath: ["simpleCostBasis"],
 						description: "A single cost for one unit, which cannot be sent together with the cost components",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2138,6 +2180,7 @@ const surfaceCommands = [
 						jsonPath: ["tariffs"],
 						description: "The import duty paid on one unit, a cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2145,6 +2188,7 @@ const surfaceCommands = [
 						jsonPath: ["tax"],
 						description: "The tax paid on one unit, a cost component",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2152,6 +2196,7 @@ const surfaceCommands = [
 						jsonPath: ["usefulLife"],
 						description: "The number of months one unit is depreciated over, or null to clear it",
 						valueName: "number",
+						nullable: true,
 						schema: z.coerce.number()
 					}
 				]
@@ -2257,6 +2302,7 @@ const surfaceCommands = [
 						jsonPath: ["description"],
 						description: "The asset's new description, or null to clear it",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2264,6 +2310,7 @@ const surfaceCommands = [
 						jsonPath: ["functionalStatus"],
 						description: "The asset's new functional status, which cannot be SCRAPPED because scrapping has its own endpoint",
 						valueName: "value",
+						nullable: true,
 						schema: z.enum([
 							"FUNCTIONAL",
 							"NEEDS_REVIEW",
@@ -2276,6 +2323,7 @@ const surfaceCommands = [
 						jsonPath: ["inInventoryDate"],
 						description: "The day the asset entered inventory, which cannot be in the future",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2283,6 +2331,7 @@ const surfaceCommands = [
 						jsonPath: ["initialLocationId"],
 						description: "The ID of the location the asset entered inventory at",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -2299,6 +2348,7 @@ const surfaceCommands = [
 						jsonPath: ["serial"],
 						description: "The asset's new serial number, which cannot be empty",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					}
 				]
@@ -2327,6 +2377,7 @@ const surfaceCommands = [
 							jsonPath: ["allocatedIndirect"],
 							description: "One unit's share of overhead, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2334,6 +2385,7 @@ const surfaceCommands = [
 							jsonPath: ["billOfMaterials"],
 							description: "The parts cost of one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2353,6 +2405,7 @@ const surfaceCommands = [
 							jsonPath: ["directLabor"],
 							description: "The labor cost to build one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2360,6 +2413,7 @@ const surfaceCommands = [
 							jsonPath: ["freightInbound"],
 							description: "The shipping cost to receive one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2367,6 +2421,7 @@ const surfaceCommands = [
 							jsonPath: ["freightOutbound"],
 							description: "The shipping cost to deploy one unit, a deployment cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2374,6 +2429,7 @@ const surfaceCommands = [
 							jsonPath: ["inServiceDate"],
 							description: "The day the asset was put into service and began depreciating, or null to clear it",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2381,6 +2437,7 @@ const surfaceCommands = [
 							jsonPath: ["installation"],
 							description: "The cost to install one unit, a deployment cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2388,12 +2445,14 @@ const surfaceCommands = [
 							jsonPath: ["interest"],
 							description: "The financing cost of one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
 							name: "is-in-service-date-managed-automatically",
 							jsonPath: ["isInServiceDateManagedAutomatically"],
 							description: "Whether Hardfin sets the in-service date itself, which sending an in-service date turns off",
+							nullable: true,
 							schema: z.boolean()
 						},
 						{
@@ -2401,6 +2460,7 @@ const surfaceCommands = [
 							jsonPath: ["salvageValue"],
 							description: "The value one unit keeps at the end of its useful life, or null to clear it",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2408,6 +2468,7 @@ const surfaceCommands = [
 							jsonPath: ["simpleCostBasis"],
 							description: "A single cost for one unit, which cannot be sent together with the cost components",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2415,6 +2476,7 @@ const surfaceCommands = [
 							jsonPath: ["tariffs"],
 							description: "The import duty paid on one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2422,6 +2484,7 @@ const surfaceCommands = [
 							jsonPath: ["tax"],
 							description: "The tax paid on one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2429,6 +2492,7 @@ const surfaceCommands = [
 							jsonPath: ["usefulLife"],
 							description: "The number of months one unit is depreciated over, or null to clear it",
 							valueName: "number",
+							nullable: true,
 							schema: z.coerce.number()
 						}
 					]
@@ -2508,6 +2572,7 @@ const surfaceCommands = [
 							jsonPath: ["notes"],
 							description: "Free-form detail about the adjustment, which a reason of OTHER requires",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2716,6 +2781,7 @@ const surfaceCommands = [
 								jsonPath: ["salePrice"],
 								description: "What the customer paid for the asset, which cannot be negative",
 								valueName: "value",
+								nullable: true,
 								schema: z.string()
 							}
 						]
@@ -2781,6 +2847,7 @@ const surfaceCommands = [
 								jsonPath: ["customerId"],
 								description: "The ID of the customer that owned the asset during the segment",
 								valueName: "value",
+								nullable: true,
 								schema: z.string()
 							},
 							{
@@ -2788,6 +2855,7 @@ const surfaceCommands = [
 								jsonPath: ["date"],
 								description: "The day the segment's owner took ownership, which cannot be in the future",
 								valueName: "value",
+								nullable: true,
 								schema: z.string()
 							},
 							{
@@ -2795,6 +2863,7 @@ const surfaceCommands = [
 								jsonPath: ["salePrice"],
 								description: "What the owner paid for the asset, which cannot be negative",
 								valueName: "value",
+								nullable: true,
 								schema: z.string()
 							}
 						]
@@ -2851,6 +2920,7 @@ const surfaceCommands = [
 							jsonPath: ["disposalPrice"],
 							description: "What the scrapped asset was sold for, or null when it was not sold",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -2858,6 +2928,7 @@ const surfaceCommands = [
 							jsonPath: ["disposalReason"],
 							description: "Why the asset was scrapped",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						}
 					]
@@ -2920,6 +2991,7 @@ const surfaceCommands = [
 						jsonPath: ["name"],
 						description: "The link's display name, or null to show the address instead",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					}, {
 						name: "url",
@@ -2963,6 +3035,7 @@ const surfaceCommands = [
 							jsonPath: ["notes"],
 							description: "Free-form detail about the revision, which a reason of OTHER requires",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3092,6 +3165,7 @@ const surfaceCommands = [
 						jsonPath: ["billingAddress"],
 						description: "The address invoices are sent to",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3099,6 +3173,7 @@ const surfaceCommands = [
 						jsonPath: ["billingContact", "email"],
 						description: "The billing contact's email address",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3106,6 +3181,7 @@ const surfaceCommands = [
 						jsonPath: ["billingContact", "name"],
 						description: "The billing contact's name",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3113,6 +3189,7 @@ const surfaceCommands = [
 						jsonPath: ["billingContact", "phone"],
 						description: "The billing contact's phone number",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3120,6 +3197,7 @@ const surfaceCommands = [
 						jsonPath: ["comment"],
 						description: "A free-form note about the customer",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3127,6 +3205,7 @@ const surfaceCommands = [
 						jsonPath: ["domain"],
 						description: "The customer's web domain, used to look up its logo",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3134,6 +3213,7 @@ const surfaceCommands = [
 						jsonPath: ["externalId"],
 						description: "The customer's identifier in another system",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3190,6 +3270,7 @@ const surfaceCommands = [
 						jsonPath: ["billingAddress"],
 						description: "The address invoices are sent to",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3197,6 +3278,7 @@ const surfaceCommands = [
 						jsonPath: ["billingContact", "email"],
 						description: "The billing contact's email address",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3204,6 +3286,7 @@ const surfaceCommands = [
 						jsonPath: ["billingContact", "name"],
 						description: "The billing contact's name",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3211,6 +3294,7 @@ const surfaceCommands = [
 						jsonPath: ["billingContact", "phone"],
 						description: "The billing contact's phone number",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3218,6 +3302,7 @@ const surfaceCommands = [
 						jsonPath: ["comment"],
 						description: "A free-form note about the customer",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3225,6 +3310,7 @@ const surfaceCommands = [
 						jsonPath: ["domain"],
 						description: "The customer's web domain, used to look up its logo",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3232,24 +3318,28 @@ const surfaceCommands = [
 						jsonPath: ["externalId"],
 						description: "The customer's identifier in another system",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
 						name: "is-archived",
 						jsonPath: ["isArchived"],
 						description: "Whether the customer is archived",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
 						name: "is-customer",
 						jsonPath: ["isCustomer"],
 						description: "Whether the company is a customer",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
 						name: "is-supplier",
 						jsonPath: ["isSupplier"],
 						description: "Whether the company is a supplier",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
@@ -3257,6 +3347,7 @@ const surfaceCommands = [
 						jsonPath: ["name"],
 						description: "The customer's display name",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					}
 				]
@@ -3433,6 +3524,7 @@ const surfaceCommands = [
 						jsonPath: ["description"],
 						description: "A free-form description of the item",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3561,6 +3653,7 @@ const surfaceCommands = [
 						name: "accepts-bulk-serials",
 						jsonPath: ["acceptsBulkSerials"],
 						description: "Whether a BULK item records serial numbers on its units, read only beside type",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
@@ -3568,6 +3661,7 @@ const surfaceCommands = [
 						jsonPath: ["description"],
 						description: "The item's new description, or null to clear it",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3587,6 +3681,7 @@ const surfaceCommands = [
 						name: "is-archived",
 						jsonPath: ["isArchived"],
 						description: "Whether the item is archived, which cannot be null",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
@@ -3594,6 +3689,7 @@ const surfaceCommands = [
 						jsonPath: ["name"],
 						description: "The item's new display name, which cannot be empty",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3601,6 +3697,7 @@ const surfaceCommands = [
 						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()
 					},
 					{
@@ -3608,6 +3705,7 @@ const surfaceCommands = [
 						jsonPath: ["type"],
 						description: "The type to convert the item to, when the item's assets and inventory history allow the conversion",
 						valueName: "value",
+						nullable: true,
 						schema: z.enum([
 							"BULK",
 							"DEVICE",
@@ -3640,6 +3738,7 @@ const surfaceCommands = [
 							jsonPath: ["allocatedIndirect"],
 							description: "One unit's share of overhead, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3647,6 +3746,7 @@ const surfaceCommands = [
 							jsonPath: ["billOfMaterials"],
 							description: "The parts cost of one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3666,6 +3766,7 @@ const surfaceCommands = [
 							jsonPath: ["directLabor"],
 							description: "The labor cost to build one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3673,6 +3774,7 @@ const surfaceCommands = [
 							jsonPath: ["freightInbound"],
 							description: "The shipping cost to receive one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3680,6 +3782,7 @@ const surfaceCommands = [
 							jsonPath: ["freightOutbound"],
 							description: "The shipping cost to deploy one unit, a deployment cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3687,6 +3790,7 @@ const surfaceCommands = [
 							jsonPath: ["installation"],
 							description: "The cost to install one unit, a deployment cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3694,6 +3798,7 @@ const surfaceCommands = [
 							jsonPath: ["interest"],
 							description: "The financing cost of one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3701,6 +3806,7 @@ const surfaceCommands = [
 							jsonPath: ["salvageValue"],
 							description: "The value one unit keeps at the end of its useful life, or null to clear it",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3708,6 +3814,7 @@ const surfaceCommands = [
 							jsonPath: ["simpleCostBasis"],
 							description: "A single cost for one unit, which cannot be sent together with the cost components",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3715,6 +3822,7 @@ const surfaceCommands = [
 							jsonPath: ["tariffs"],
 							description: "The import duty paid on one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3722,6 +3830,7 @@ const surfaceCommands = [
 							jsonPath: ["tax"],
 							description: "The tax paid on one unit, a cost component",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						},
 						{
@@ -3729,6 +3838,7 @@ const surfaceCommands = [
 							jsonPath: ["usefulLife"],
 							description: "The number of months one unit is depreciated over, or null to clear it",
 							valueName: "number",
+							nullable: true,
 							schema: z.coerce.number()
 						}
 					]
@@ -3785,6 +3895,7 @@ const surfaceCommands = [
 								description: "The field's position within its section, starting at 0",
 								valueName: "number",
 								required: true,
+								nullable: true,
 								schema: z.coerce.number()
 							},
 							{
@@ -3793,6 +3904,7 @@ const surfaceCommands = [
 								description: "The group the field is shown in, starting at 0",
 								valueName: "number",
 								required: true,
+								nullable: true,
 								schema: z.coerce.number()
 							}
 						]
@@ -3818,6 +3930,7 @@ const surfaceCommands = [
 							jsonPath: ["label"],
 							description: "The field's new display name, which cannot be empty",
 							valueName: "value",
+							nullable: true,
 							schema: z.string()
 						}]
 					}),
@@ -3958,6 +4071,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "addressLine1"],
 						description: "The first line of the street address",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3965,6 +4079,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "addressLine2"],
 						description: "The second line of the street address, such as a suite",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3972,6 +4087,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "city"],
 						description: "The city",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3979,6 +4095,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "country"],
 						description: "The country",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3986,6 +4103,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "formattedAddress"],
 						description: "The whole address on one line",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -3993,6 +4111,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "postalCode"],
 						description: "The postal or ZIP code",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4000,6 +4119,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "state"],
 						description: "The state or region",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4007,6 +4127,7 @@ const surfaceCommands = [
 						jsonPath: ["consignee"],
 						description: "The ID of the customer a zone is designated for, such as for reservations, provisioning or a 3PL",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4014,6 +4135,7 @@ const surfaceCommands = [
 						jsonPath: ["customerId"],
 						description: "The ID of the customer to assign a site to, or null for your organization's own site",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4021,6 +4143,7 @@ const surfaceCommands = [
 						jsonPath: ["description"],
 						description: "A free-form description of a zone",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4053,6 +4176,7 @@ const surfaceCommands = [
 						jsonPath: ["parentLocationId"],
 						description: "The ID of the site a zone belongs to, required for a zone and refused for a site",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4100,6 +4224,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "addressLine1"],
 						description: "The first line of the street address",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4107,6 +4232,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "addressLine2"],
 						description: "The second line of the street address, such as a suite",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4114,6 +4240,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "city"],
 						description: "The city",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4121,6 +4248,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "country"],
 						description: "The country",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4128,6 +4256,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "formattedAddress"],
 						description: "The whole address on one line",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4135,6 +4264,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "postalCode"],
 						description: "The postal or ZIP code",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4142,6 +4272,7 @@ const surfaceCommands = [
 						jsonPath: ["address", "state"],
 						description: "The state or region",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4149,6 +4280,7 @@ const surfaceCommands = [
 						jsonPath: ["consignee"],
 						description: "The ID of the customer a zone is designated for, such as for reservations, provisioning or a 3PL",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4156,6 +4288,7 @@ const surfaceCommands = [
 						jsonPath: ["customerId"],
 						description: "The ID of the customer to assign a site to, or null for your organization's own site",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4163,30 +4296,35 @@ const surfaceCommands = [
 						jsonPath: ["description"],
 						description: "A free-form description of a zone",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
 						name: "is-archived",
 						jsonPath: ["isArchived"],
 						description: "Whether the location is archived, and archiving a site archives its zones",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
 						name: "is-inventory",
 						jsonPath: ["isInventory"],
 						description: "Whether assets at the location count as inventory for reporting",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
 						name: "is-inventory-override",
 						jsonPath: ["isInventoryOverride"],
 						description: "Whether a zone sets its own isInventory rather than inheriting its parent site's, which a site refuses",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
 						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",
+						nullable: true,
 						schema: z.boolean()
 					},
 					{
@@ -4194,6 +4332,7 @@ const surfaceCommands = [
 						jsonPath: ["name"],
 						description: "The location's display name",
 						valueName: "value",
+						nullable: true,
 						schema: z.string()
 					},
 					{
@@ -4242,6 +4381,23 @@ const surfaceCommands = [
 			}
 		]
 	},
+	{
+		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",
@@ -4280,12 +4436,14 @@ const surfaceCommands = [
 					jsonPath: ["name"],
 					description: "The link's display name, or null to show the address instead",
 					valueName: "value",
+					nullable: true,
 					schema: z.string()
 				}, {
 					name: "url",
 					jsonPath: ["url"],
 					description: "The address the link points to, which cannot be empty or null",
 					valueName: "value",
+					nullable: true,
 					schema: z.string()
 				}]
 			}),
@@ -4376,8 +4534,8 @@ function toFile(path) {
 //#endregion
 //#region src/command/status.ts
 /**
-* Hardfin expires an unused refresh token after this long. It is the server's rule, not the
-* CLI's, and the token endpoint reports no expiry, so what this produces is an estimate.
+* What the CLI falls back to for an older sign in, stored before the server began reporting
+* when a refresh token expires. Hardfin's own rule, and an estimate rather than a fact.
 */
 const REFRESH_SLIDING_DAYS = 90;
 const statusCommand = defineCommand({
@@ -4481,8 +4639,8 @@ function toCredentialReport(apiKey, stored) {
 		fingerprint: toFingerprint(stored.refreshToken),
 		signedInAt: stored.signedInAt ?? null,
 		renewedAt: stored.renewedAt ?? null,
-		refreshExpiresAt: toRefreshExpiry(stored.renewedAt),
-		refreshExpiryIsEstimated: true
+		refreshExpiresAt: stored.expiresAt ?? toRefreshExpiry(stored.renewedAt),
+		refreshExpiryIsEstimated: stored.expiresAt === void 0
 	};
 }
 function toServerReport(metadata) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hardfin/cli",
-    "version": "0.0.2-dev.12",
+    "version": "0.0.2-dev.14",
     "description": "Command line interface for the Hardfin API",
     "license": "Apache-2.0",
     "author": "Hardfin, Inc.",