@terreno/mcp 0.24.0 → 0.26.0

package/dist/docs/versioned/0.24.0/reference/generated/api/interfaces/ScopedLogger.md

@@ -0,0 +1,100 @@
+Logger-shaped object returned by [createScopedLogger](../functions/createScopedLogger.md) and [createFeatureFlaggedLogger](../functions/createFeatureFlaggedLogger.md).
+Method signatures match the global [logger](../variables/logger.md) so the three are interchangeable at call sites.
+
+## Properties
+
+### catch
+
+> **catch**: (`e`) => `void`
+
+Log a caught exception. Suitable as a promise handler: `promise.catch(log.catch)`.
+
+#### Parameters
+
+##### e
+
+`unknown`
+
+#### Returns
+
+`void`
+
+***
+
+### debug
+
+> **debug**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+***
+
+### error
+
+> **error**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+***
+
+### info
+
+> **info**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+***
+
+### warn
+
+> **warn**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`

package/dist/docs/versioned/0.24.0/reference/generated/api/interfaces/ScriptArgDef.md

@@ -0,0 +1,60 @@
+Optional declaration for a single script argument. Declarations are purely
+advisory: they drive validation, type coercion, default values, and help text
+but a script can still read any argument the caller supplied. This keeps
+argument handling flexible — declare the args you care about, ignore the rest.
+
+## Properties
+
+### aliases?
+
+> `optional` **aliases?**: `string`[]
+
+Alternate names accepted on the CLI (e.g. ["l"] enables `-l`).
+
+***
+
+### default?
+
+> `optional` **default?**: [`ScriptArgValue`](../type-aliases/ScriptArgValue.md)
+
+Default applied when the argument is not provided.
+
+***
+
+### description
+
+> **description**: `string`
+
+Human-readable description shown in CLI help and the admin UI.
+
+***
+
+### example?
+
+> `optional` **example?**: `string`
+
+Example value shown in help text.
+
+***
+
+### name
+
+> **name**: `string`
+
+Canonical name (used as `--name` on the CLI and as the key in the args map).
+
+***
+
+### required?
+
+> `optional` **required?**: `boolean`
+
+When true, parsing fails if the argument is missing.
+
+***
+
+### type?
+
+> `optional` **type?**: `"string"` \| `"number"` \| `"boolean"`
+
+Type used for coercion and validation. Defaults to "string".

package/dist/docs/versioned/0.24.0/reference/generated/api/interfaces/ScriptArgs.md

@@ -0,0 +1,121 @@
+Typed, ergonomic accessor over the parsed arguments passed to a script. Scripts
+read values via the typed getters; `raw` and `positional` expose everything for
+advanced cases.
+
+## Properties
+
+### getBoolean
+
+> **getBoolean**: (`name`, `fallback?`) => `boolean`
+
+Read a boolean value ("true"/"1"/"yes"/"on" are truthy).
+
+#### Parameters
+
+##### name
+
+`string`
+
+##### fallback?
+
+`boolean`
+
+#### Returns
+
+`boolean`
+
+***
+
+### getNumber
+
+> **getNumber**: (`name`, `fallback?`) => `number` \| `undefined`
+
+Read a numeric value (coerces strings; returns fallback when missing/NaN).
+
+#### Parameters
+
+##### name
+
+`string`
+
+##### fallback?
+
+`number`
+
+#### Returns
+
+`number` \| `undefined`
+
+***
+
+### getString
+
+> **getString**: (`name`, `fallback?`) => `string` \| `undefined`
+
+Read a string value (coerces numbers/booleans; first element of arrays).
+
+#### Parameters
+
+##### name
+
+`string`
+
+##### fallback?
+
+`string`
+
+#### Returns
+
+`string` \| `undefined`
+
+***
+
+### getStringArray
+
+> **getStringArray**: (`name`) => `string`[]
+
+Read a string array (single values become a one-element array).
+
+#### Parameters
+
+##### name
+
+`string`
+
+#### Returns
+
+`string`[]
+
+***
+
+### has
+
+> **has**: (`name`) => `boolean`
+
+Whether a named argument was supplied (or has a default).
+
+#### Parameters
+
+##### name
+
+`string`
+
+#### Returns
+
+`boolean`
+
+***
+
+### positional
+
+> **positional**: `string`[]
+
+Positional (non-flag) arguments, in order.
+
+***
+
+### raw
+
+> **raw**: `Record`\<`string`, [`ScriptArgValue`](../type-aliases/ScriptArgValue.md)\>
+
+All named values keyed by canonical name.

package/dist/docs/versioned/0.24.0/reference/generated/api/interfaces/ScriptContext.md

@@ -0,0 +1,67 @@
+## Properties
+
+### addLog
+
+> **addLog**: (`level`, `message`) => `Promise`\<`void`\>
+
+Add a log entry to the task.
+
+#### Parameters
+
+##### level
+
+`"error"` \| `"info"` \| `"warn"`
+
+##### message
+
+`string`
+
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+### args
+
+> **args**: [`ScriptArgs`](ScriptArgs.md)
+
+Arguments supplied to this run (from the CLI, HTTP body, or admin UI).
+
+***
+
+### checkCancellation
+
+> **checkCancellation**: () => `Promise`\<`void`\>
+
+Check if the task has been cancelled. Throws TaskCancelledError if so.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+***
+
+### updateProgress
+
+> **updateProgress**: (`percentage`, `stage?`, `message?`) => `Promise`\<`void`\>
+
+Update progress on the task.
+
+#### Parameters
+
+##### percentage
+
+`number`
+
+##### stage?
+
+`string`
+
+##### message?
+
+`string`
+
+#### Returns
+
+`Promise`\<`void`\>

package/dist/docs/versioned/0.24.0/reference/generated/api/interfaces/TerrenoAppOptions.md

@@ -0,0 +1,112 @@
+Configuration options for TerrenoApp.
+
+## Properties
+
+### arrayLimit?
+
+> `optional` **arrayLimit?**: `number`
+
+Maximum number of array items in query parameters (default: 200)
+
+***
+
+### authOptions?
+
+> `optional` **authOptions?**: [`AuthOptions`](AuthOptions.md)
+
+Authentication configuration options
+
+***
+
+### beforeJsonSetup?
+
+> `optional` **beforeJsonSetup?**: (`app`) => `void`
+
+Runs after CORS and before the `addMiddleware` chain and JSON body parsing.
+Use to attach early middleware via `app.use(...)` before JSON parsing.
+
+#### Parameters
+
+##### app
+
+`Application`
+
+#### Returns
+
+`void`
+
+***
+
+### configureApp?
+
+> `optional` **configureApp?**: [`AddRoutes`](../type-aliases/AddRoutes.md)
+
+Invoked after registered plugins/model routers and before `/auth/me`.
+Receives the Express app and OpenAPI bundle for `modelRouter` / `createOpenApiBuilder` wiring.
+
+***
+
+### corsOrigin?
+
+> `optional` **corsOrigin?**: `CorsOrigin`
+
+CORS origin configuration (default: "*")
+
+***
+
+### githubAuth?
+
+> `optional` **githubAuth?**: [`GitHubAuthOptions`](GitHubAuthOptions.md)
+
+GitHub OAuth configuration (enables GitHub authentication if provided)
+
+***
+
+### loggingOptions?
+
+> `optional` **loggingOptions?**: [`LoggingOptions`](LoggingOptions.md)
+
+Logging configuration options
+
+***
+
+### logRequests?
+
+> `optional` **logRequests?**: `boolean`
+
+Whether to log all incoming requests (default: true)
+
+***
+
+### realtime?
+
+> `optional` **realtime?**: `boolean` \| [`RealtimeAppOptions`](RealtimeAppOptions.md)
+
+Real-time sync configuration. When provided, Socket.io and MongoDB change streams
+are set up automatically — no need to register RealtimeApp as a separate plugin.
+
+Set to `true` for defaults, or pass a RealtimeAppOptions object for full control.
+
+***
+
+### sentryOptions?
+
+> `optional` **sentryOptions?**: `BunOptions`
+
+Sentry configuration options
+
+***
+
+### skipListen?
+
+> `optional` **skipListen?**: `boolean`
+
+Skip calling app.listen() in start() method (useful for testing)
+
+***
+
+### userModel
+
+> **userModel**: [`UserModel`](UserModel.md)
+
+Mongoose User model with passport-local-mongoose plugin

package/dist/docs/versioned/0.24.0/reference/generated/api/interfaces/TerrenoRequestLogEntry.md

@@ -0,0 +1,13 @@
+Always attached to Winston metadata while a request/job ALS scope is active.
+
+## Properties
+
+### requestId
+
+> **requestId**: `string`
+
+***
+
+### userId
+
+> **userId**: `string` \| `null`

package/dist/docs/versioned/0.24.0/reference/generated/api/type-aliases/AuthProvider.md

@@ -0,0 +1,5 @@
+> **AuthProvider** = `"jwt"` \| `"better-auth"`
+
+Auth provider selection for TerrenoApp.
+- "jwt": Traditional JWT/Passport authentication (default)
+- "better-auth": Better Auth with OAuth support

package/dist/docs/versioned/0.24.0/reference/generated/api/type-aliases/ScriptArgValue.md

@@ -0,0 +1,3 @@
+> **ScriptArgValue** = `string` \| `number` \| `boolean` \| `string`[]
+
+A single parsed argument value. Repeated flags collapse into a string array.

package/dist/docs/versioned/0.24.0/reference/generated/api/variables/REQUEST_CONTEXT_ATTRIBUTE_NAMES.md

@@ -0,0 +1,39 @@
+> `const` **REQUEST\_CONTEXT\_ATTRIBUTE\_NAMES**: `object`
+
+Canonical HTTP header names for each correlation field. Use these to propagate context to
+downstream services (pair with [getCurrentRequestContextAttributes](../functions/getCurrentRequestContextAttributes.md)) or to read it from an
+incoming request (pair with [getRequestContextFromAttributes](../functions/getRequestContextFromAttributes.md)).
+
+## Type Declaration
+
+### jobId
+
+> `readonly` **jobId**: `"x-job-id"` = `JOB_ID_HEADER`
+
+### requestId
+
+> `readonly` **requestId**: `"x-request-id"` = `"x-request-id"`
+
+### sessionId
+
+> `readonly` **sessionId**: `"x-session-id"` = `SESSION_ID_HEADER`
+
+### spanId
+
+> `readonly` **spanId**: `"x-span-id"` = `SPAN_ID_HEADER`
+
+### traceId
+
+> `readonly` **traceId**: `"x-trace-id"` = `TRACE_ID_HEADER`
+
+### traceParent
+
+> `readonly` **traceParent**: `"traceparent"` = `TRACE_PARENT_HEADER`
+
+### traceSampled
+
+> `readonly` **traceSampled**: `"x-trace-sampled"` = `TRACE_SAMPLED_HEADER`
+
+### userId
+
+> `readonly` **userId**: `"x-user-id"` = `USER_ID_HEADER`

package/dist/docs/versioned/0.24.0/reference/generated/api/variables/consentResponsePopulatePaths.md

@@ -0,0 +1,3 @@
+> `const` **consentResponsePopulatePaths**: [`PopulatePath`](../interfaces/PopulatePath.md)[]
+
+Shared populate config for consent response list/read endpoints.

package/dist/docs/versioned/0.24.0/reference/generated/api/variables/logger.md

@@ -0,0 +1,109 @@
+> `const` **logger**: `object`
+
+Global application logger. Each method writes through Winston (console/file transports) and, when
+`USE_SENTRY_LOGGING=true`, mirrors the line to Sentry with the active request context attached.
+
+Prefer [createScopedLogger](../functions/createScopedLogger.md) when a workflow spans multiple log lines that should share a
+prefix or labels.
+
+## Type Declaration
+
+### catch
+
+> **catch**: (`e`) => `void`
+
+#### Parameters
+
+##### e
+
+`unknown`
+
+#### Returns
+
+`void`
+
+### debug
+
+> **debug**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+### error
+
+> **error**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+### info
+
+> **info**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+### warn
+
+> **warn**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+## Example
+
+```typescript
+import {logger} from "@terreno/api";
+
+logger.info("Server started", {port: 4000});
+logger.warn("Slow query", {ms: 500});
+logger.error("Failed to process", {error});
+logger.debug("Request details", {body: req.body});
+
+// Convenient `.catch` handler for promises – logs and captures the exception.
+await chargeCard(id).catch(logger.catch);
+```