@terreno/mcp 0.29.0 → 0.30.0

package/dist/docs/versioned/0.29.0/reference/generated/api/classes/InternalServerError.md

@@ -0,0 +1,165 @@
+500 Internal Server Error.
+
+## Extends
+
+- [`APIError`](APIError.md)
+
+## Constructors
+
+### Constructor
+
+> **new InternalServerError**(`options`): `InternalServerError`
+
+#### Parameters
+
+##### options
+
+[`APIErrorSubclassOptions`](../type-aliases/APIErrorSubclassOptions.md)
+
+#### Returns
+
+`InternalServerError`
+
+#### Overrides
+
+[`APIError`](APIError.md).[`constructor`](APIError.md#constructor)
+
+## Properties
+
+### code
+
+> **code**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`code`](APIError.md#code)
+
+***
+
+### detail
+
+> **detail**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`detail`](APIError.md#detail)
+
+***
+
+### disableExternalErrorTracking?
+
+> `optional` **disableExternalErrorTracking?**: `boolean`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`disableExternalErrorTracking`](APIError.md#disableexternalerrortracking)
+
+***
+
+### id
+
+> **id**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`id`](APIError.md#id)
+
+***
+
+### isTerrenoAPIError
+
+> `readonly` **isTerrenoAPIError**: `true` = `true`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`isTerrenoAPIError`](APIError.md#isterrenoapierror)
+
+***
+
+### links
+
+> **links**: \{ `about?`: `string`; `type?`: `string`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`links`](APIError.md#links)
+
+***
+
+### meta
+
+> **meta**: \{\[`id`: `string`\]: `unknown`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`meta`](APIError.md#meta)
+
+***
+
+### source
+
+> **source**: \{ `header?`: `string`; `parameter?`: `string`; `pointer?`: `string`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`source`](APIError.md#source)
+
+***
+
+### status
+
+> **status**: `number`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`status`](APIError.md#status)
+
+## Accessors
+
+### error
+
+#### Get Signature
+
+> **get** **error**(): `unknown`
+
+##### Deprecated
+
+Use the standard `cause` field instead.
+
+##### Returns
+
+`unknown`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`error`](APIError.md#error)
+
+***
+
+### title
+
+#### Get Signature
+
+> **get** **title**(): `string`
+
+##### Returns
+
+`string`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`title`](APIError.md#title)
+
+## Methods
+
+### toJSON()
+
+> **toJSON**(): [`APIErrorBody`](../interfaces/APIErrorBody.md)
+
+#### Returns
+
+[`APIErrorBody`](../interfaces/APIErrorBody.md)
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`toJSON`](APIError.md#tojson)

package/dist/docs/versioned/0.29.0/reference/generated/api/classes/NotFoundError.md

@@ -0,0 +1,165 @@
+404 Not Found.
+
+## Extends
+
+- [`APIError`](APIError.md)
+
+## Constructors
+
+### Constructor
+
+> **new NotFoundError**(`options`): `NotFoundError`
+
+#### Parameters
+
+##### options
+
+[`APIErrorSubclassOptions`](../type-aliases/APIErrorSubclassOptions.md)
+
+#### Returns
+
+`NotFoundError`
+
+#### Overrides
+
+[`APIError`](APIError.md).[`constructor`](APIError.md#constructor)
+
+## Properties
+
+### code
+
+> **code**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`code`](APIError.md#code)
+
+***
+
+### detail
+
+> **detail**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`detail`](APIError.md#detail)
+
+***
+
+### disableExternalErrorTracking?
+
+> `optional` **disableExternalErrorTracking?**: `boolean`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`disableExternalErrorTracking`](APIError.md#disableexternalerrortracking)
+
+***
+
+### id
+
+> **id**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`id`](APIError.md#id)
+
+***
+
+### isTerrenoAPIError
+
+> `readonly` **isTerrenoAPIError**: `true` = `true`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`isTerrenoAPIError`](APIError.md#isterrenoapierror)
+
+***
+
+### links
+
+> **links**: \{ `about?`: `string`; `type?`: `string`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`links`](APIError.md#links)
+
+***
+
+### meta
+
+> **meta**: \{\[`id`: `string`\]: `unknown`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`meta`](APIError.md#meta)
+
+***
+
+### source
+
+> **source**: \{ `header?`: `string`; `parameter?`: `string`; `pointer?`: `string`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`source`](APIError.md#source)
+
+***
+
+### status
+
+> **status**: `number`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`status`](APIError.md#status)
+
+## Accessors
+
+### error
+
+#### Get Signature
+
+> **get** **error**(): `unknown`
+
+##### Deprecated
+
+Use the standard `cause` field instead.
+
+##### Returns
+
+`unknown`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`error`](APIError.md#error)
+
+***
+
+### title
+
+#### Get Signature
+
+> **get** **title**(): `string`
+
+##### Returns
+
+`string`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`title`](APIError.md#title)
+
+## Methods
+
+### toJSON()
+
+> **toJSON**(): [`APIErrorBody`](../interfaces/APIErrorBody.md)
+
+#### Returns
+
+[`APIErrorBody`](../interfaces/APIErrorBody.md)
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`toJSON`](APIError.md#tojson)

package/dist/docs/versioned/0.29.0/reference/generated/api/classes/UnauthorizedError.md

@@ -0,0 +1,165 @@
+401 Unauthorized.
+
+## Extends
+
+- [`APIError`](APIError.md)
+
+## Constructors
+
+### Constructor
+
+> **new UnauthorizedError**(`options`): `UnauthorizedError`
+
+#### Parameters
+
+##### options
+
+[`APIErrorSubclassOptions`](../type-aliases/APIErrorSubclassOptions.md)
+
+#### Returns
+
+`UnauthorizedError`
+
+#### Overrides
+
+[`APIError`](APIError.md).[`constructor`](APIError.md#constructor)
+
+## Properties
+
+### code
+
+> **code**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`code`](APIError.md#code)
+
+***
+
+### detail
+
+> **detail**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`detail`](APIError.md#detail)
+
+***
+
+### disableExternalErrorTracking?
+
+> `optional` **disableExternalErrorTracking?**: `boolean`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`disableExternalErrorTracking`](APIError.md#disableexternalerrortracking)
+
+***
+
+### id
+
+> **id**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`id`](APIError.md#id)
+
+***
+
+### isTerrenoAPIError
+
+> `readonly` **isTerrenoAPIError**: `true` = `true`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`isTerrenoAPIError`](APIError.md#isterrenoapierror)
+
+***
+
+### links
+
+> **links**: \{ `about?`: `string`; `type?`: `string`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`links`](APIError.md#links)
+
+***
+
+### meta
+
+> **meta**: \{\[`id`: `string`\]: `unknown`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`meta`](APIError.md#meta)
+
+***
+
+### source
+
+> **source**: \{ `header?`: `string`; `parameter?`: `string`; `pointer?`: `string`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`source`](APIError.md#source)
+
+***
+
+### status
+
+> **status**: `number`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`status`](APIError.md#status)
+
+## Accessors
+
+### error
+
+#### Get Signature
+
+> **get** **error**(): `unknown`
+
+##### Deprecated
+
+Use the standard `cause` field instead.
+
+##### Returns
+
+`unknown`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`error`](APIError.md#error)
+
+***
+
+### title
+
+#### Get Signature
+
+> **get** **title**(): `string`
+
+##### Returns
+
+`string`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`title`](APIError.md#title)
+
+## Methods
+
+### toJSON()
+
+> **toJSON**(): [`APIErrorBody`](../interfaces/APIErrorBody.md)
+
+#### Returns
+
+[`APIErrorBody`](../interfaces/APIErrorBody.md)
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`toJSON`](APIError.md#tojson)

package/dist/docs/versioned/0.29.0/reference/generated/api/classes/ValidationError.md

@@ -0,0 +1,165 @@
+400 Bad Request with a "ValidationError" type, for request/schema validation failures.
+
+## Extends
+
+- [`APIError`](APIError.md)
+
+## Constructors
+
+### Constructor
+
+> **new ValidationError**(`options`): `ValidationError`
+
+#### Parameters
+
+##### options
+
+[`APIErrorSubclassOptions`](../type-aliases/APIErrorSubclassOptions.md)
+
+#### Returns
+
+`ValidationError`
+
+#### Overrides
+
+[`APIError`](APIError.md).[`constructor`](APIError.md#constructor)
+
+## Properties
+
+### code
+
+> **code**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`code`](APIError.md#code)
+
+***
+
+### detail
+
+> **detail**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`detail`](APIError.md#detail)
+
+***
+
+### disableExternalErrorTracking?
+
+> `optional` **disableExternalErrorTracking?**: `boolean`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`disableExternalErrorTracking`](APIError.md#disableexternalerrortracking)
+
+***
+
+### id
+
+> **id**: `string` \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`id`](APIError.md#id)
+
+***
+
+### isTerrenoAPIError
+
+> `readonly` **isTerrenoAPIError**: `true` = `true`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`isTerrenoAPIError`](APIError.md#isterrenoapierror)
+
+***
+
+### links
+
+> **links**: \{ `about?`: `string`; `type?`: `string`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`links`](APIError.md#links)
+
+***
+
+### meta
+
+> **meta**: \{\[`id`: `string`\]: `unknown`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`meta`](APIError.md#meta)
+
+***
+
+### source
+
+> **source**: \{ `header?`: `string`; `parameter?`: `string`; `pointer?`: `string`; \} \| `undefined`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`source`](APIError.md#source)
+
+***
+
+### status
+
+> **status**: `number`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`status`](APIError.md#status)
+
+## Accessors
+
+### error
+
+#### Get Signature
+
+> **get** **error**(): `unknown`
+
+##### Deprecated
+
+Use the standard `cause` field instead.
+
+##### Returns
+
+`unknown`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`error`](APIError.md#error)
+
+***
+
+### title
+
+#### Get Signature
+
+> **get** **title**(): `string`
+
+##### Returns
+
+`string`
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`title`](APIError.md#title)
+
+## Methods
+
+### toJSON()
+
+> **toJSON**(): [`APIErrorBody`](../interfaces/APIErrorBody.md)
+
+#### Returns
+
+[`APIErrorBody`](../interfaces/APIErrorBody.md)
+
+#### Inherited from
+
+[`APIError`](APIError.md).[`toJSON`](APIError.md#tojson)

package/dist/docs/versioned/{0.25.0 → 0.29.0}/reference/generated/api/functions/findOneOrNoneFor.md

@@ -28,7 +28,7 @@ Mongoose query object
 
 ### errorArgs?
 
-`Partial`\<[`APIErrorConstructor`](../interfaces/APIErrorConstructor.md)\>
+`Partial`\<[`APIErrorOptions`](../interfaces/APIErrorOptions.md)\>
 
 Optional overrides for the thrown [APIError](../classes/APIError.md) when multiple match
 

package/{src/docs/versioned/0.25.0 → dist/docs/versioned/0.29.0}/reference/generated/api/functions/getAPIErrorBody.md

@@ -1,5 +1,7 @@
 > **getAPIErrorBody**(`error`): `Record`\<`string`, `unknown`\>
 
+Creates an APIError body to send to clients as JSON.
+
 ## Parameters
 
 ### error
@@ -9,3 +11,7 @@
 ## Returns
 
 `Record`\<`string`, `unknown`\>
+
+## Deprecated
+
+Use `error.toJSON()` instead.

package/dist/docs/versioned/{0.25.0 → 0.29.0}/reference/generated/api/functions/withApiErrorHandling.md

@@ -6,9 +6,8 @@ once, and rethrown.
 
 In "raw" mode (default) the wrapper logs the normalized shape via the injected logger
 and rethrows the original error. In "apiError" mode the wrapper throws a terreno
-APIError — whose constructor already logs — so the wrapper itself stays silent to
-preserve the log-once contract. The APIError title is stable per JSONAPI convention;
-per-occurrence text goes in `detail`, built from the (redacted) normalized messages.
+APIError with a stable title (per-occurrence text goes in `detail`) and stays silent
+itself — apiErrorMiddleware logs APIErrors, so logging here too would double-log.
 
 ## Type Parameters