@terreno/mcp 0.27.0 → 0.28.0

package/src/docs/versioned/0.27.0/reference/generated/api/README.md

@@ -0,0 +1,294 @@
+## Classes
+
+- [APIError](classes/APIError.md)
+- [BetterAuthApp](classes/BetterAuthApp.md)
+- [CachingSecretProvider](classes/CachingSecretProvider.md)
+- [CompositeSecretProvider](classes/CompositeSecretProvider.md)
+- [ConfigurationApp](classes/ConfigurationApp.md)
+- [ConsentApp](classes/ConsentApp.md)
+- [DateOnly](classes/DateOnly.md)
+- [EnvSecretProvider](classes/EnvSecretProvider.md)
+- [GcpSecretProvider](classes/GcpSecretProvider.md)
+- [OpenApiMiddlewareBuilder](classes/OpenApiMiddlewareBuilder.md)
+- [RealtimeApp](classes/RealtimeApp.md)
+- [TaskCancelledError](classes/TaskCancelledError.md)
+- [TerrenoApp](classes/TerrenoApp.md)
+- [VersionCheckPlugin](classes/VersionCheckPlugin.md)
+
+## Interfaces
+
+- [ActionContext](interfaces/ActionContext.md)
+- [APIErrorConstructor](interfaces/APIErrorConstructor.md)
+- [AsyncHandlerOptions](interfaces/AsyncHandlerOptions.md)
+- [AuthenticatedClient](interfaces/AuthenticatedClient.md)
+- [AuthOptions](interfaces/AuthOptions.md)
+- [BackgroundTaskDocument](interfaces/BackgroundTaskDocument.md)
+- [BackgroundTaskMethods](interfaces/BackgroundTaskMethods.md)
+- [BackgroundTaskModel](interfaces/BackgroundTaskModel.md)
+- [BackgroundTaskStatics](interfaces/BackgroundTaskStatics.md)
+- [BaseUser](interfaces/BaseUser.md)
+- [BetterAuthAppOptions](interfaces/BetterAuthAppOptions.md)
+- [BetterAuthConfig](interfaces/BetterAuthConfig.md)
+- [BetterAuthOAuthProvider](interfaces/BetterAuthOAuthProvider.md)
+- [BetterAuthSession](interfaces/BetterAuthSession.md)
+- [BetterAuthSessionData](interfaces/BetterAuthSessionData.md)
+- [BetterAuthUser](interfaces/BetterAuthUser.md)
+- [CachingSecretProviderOptions](interfaces/CachingSecretProviderOptions.md)
+- [ChangeStreamConfig](interfaces/ChangeStreamConfig.md)
+- [CollectionActionConfig](interfaces/CollectionActionConfig.md)
+- [ConfigRegistration](interfaces/ConfigRegistration.md)
+- [ConfigurationAppOptions](interfaces/ConfigurationAppOptions.md)
+- [ConfigurationMetaResponse](interfaces/ConfigurationMetaResponse.md)
+- [ConfigurationModel](interfaces/ConfigurationModel.md)
+- [ConfigurationPermissions](interfaces/ConfigurationPermissions.md)
+- [ConfigurationPluginOptions](interfaces/ConfigurationPluginOptions.md)
+- [ConfigurationStatics](interfaces/ConfigurationStatics.md)
+- [ConsentAppOptions](interfaces/ConsentAppOptions.md)
+- [ConsentFormCheckbox](interfaces/ConsentFormCheckbox.md)
+- [ConsentFormDefinition](interfaces/ConsentFormDefinition.md)
+- [ConsentFormDocument](interfaces/ConsentFormDocument.md)
+- [ConsentFormModel](interfaces/ConsentFormModel.md)
+- [ConsentFormStatics](interfaces/ConsentFormStatics.md)
+- [ConsentResponseDocument](interfaces/ConsentResponseDocument.md)
+- [ConsentResponseMethods](interfaces/ConsentResponseMethods.md)
+- [ConsentResponseModel](interfaces/ConsentResponseModel.md)
+- [ConsentResponseStatics](interfaces/ConsentResponseStatics.md)
+- [CreateAuthenticatedClientOptions](interfaces/CreateAuthenticatedClientOptions.md)
+- [CreateBetterAuthOptions](interfaces/CreateBetterAuthOptions.md)
+- [CreatedDeleted](interfaces/CreatedDeleted.md)
+- [CreateFeatureFlaggedLoggerOptions](interfaces/CreateFeatureFlaggedLoggerOptions.md)
+- [CreateScopedLoggerOptions](interfaces/CreateScopedLoggerOptions.md)
+- [CreateValidatorOptions](interfaces/CreateValidatorOptions.md)
+- [DocumentSubscription](interfaces/DocumentSubscription.md)
+- [FindExactlyOnePlugin](interfaces/FindExactlyOnePlugin.md)
+- [FindOneOrNonePlugin](interfaces/FindOneOrNonePlugin.md)
+- [GcpSecretProviderOptions](interfaces/GcpSecretProviderOptions.md)
+- [GenerateTokensOptions](interfaces/GenerateTokensOptions.md)
+- [GitHubAuthOptions](interfaces/GitHubAuthOptions.md)
+- [GitHubUserFields](interfaces/GitHubUserFields.md)
+- [HasUpsert](interfaces/HasUpsert.md)
+- [HttpClientLogger](interfaces/HttpClientLogger.md)
+- [InstanceActionConfig](interfaces/InstanceActionConfig.md)
+- [IsDeleted](interfaces/IsDeleted.md)
+- [JSONArray](interfaces/JSONArray.md)
+- [JSONObject](interfaces/JSONObject.md)
+- [JwtSessionPayload](interfaces/JwtSessionPayload.md)
+- [LogContextFields](interfaces/LogContextFields.md)
+- [LoggingOptions](interfaces/LoggingOptions.md)
+- [ModelRouterOptions](interfaces/ModelRouterOptions.md)
+- [ModelRouterRegistration](interfaces/ModelRouterRegistration.md)
+- [ModelRouterValidationOptions](interfaces/ModelRouterValidationOptions.md)
+- [MongoClientLike](interfaces/MongoClientLike.md)
+- [NormalizedApiError](interfaces/NormalizedApiError.md)
+- [OpenApiBuildResult](interfaces/OpenApiBuildResult.md)
+- [OpenApiMiddleware](interfaces/OpenApiMiddleware.md)
+- [OpenApiParameter](interfaces/OpenApiParameter.md)
+- [OpenApiResponse](interfaces/OpenApiResponse.md)
+- [OpenApiSchema](interfaces/OpenApiSchema.md)
+- [OpenApiSchemaProperty](interfaces/OpenApiSchemaProperty.md)
+- [OpenApiValidatorConfig](interfaces/OpenApiValidatorConfig.md)
+- [PopulatePath](interfaces/PopulatePath.md)
+- [QuerySubscription](interfaces/QuerySubscription.md)
+- [QueryValidatorOptions](interfaces/QueryValidatorOptions.md)
+- [RealtimeAppOptions](interfaces/RealtimeAppOptions.md)
+- [RealtimeConfig](interfaces/RealtimeConfig.md)
+- [RealtimeEvent](interfaces/RealtimeEvent.md)
+- [RealtimeRegistryEntry](interfaces/RealtimeRegistryEntry.md)
+- [RealtimeSocketLike](interfaces/RealtimeSocketLike.md)
+- [RequestBodyValidatorOptions](interfaces/RequestBodyValidatorOptions.md)
+- [RequestContext](interfaces/RequestContext.md)
+- [RESTPermissions](interfaces/RESTPermissions.md)
+- [RetryPolicy](interfaces/RetryPolicy.md)
+- [ScopedLogger](interfaces/ScopedLogger.md)
+- [ScriptArgDef](interfaces/ScriptArgDef.md)
+- [ScriptArgs](interfaces/ScriptArgs.md)
+- [ScriptContext](interfaces/ScriptContext.md)
+- [ScriptResult](interfaces/ScriptResult.md)
+- [SecretFieldMeta](interfaces/SecretFieldMeta.md)
+- [SecretProvider](interfaces/SecretProvider.md)
+- [SyncConsentsOptions](interfaces/SyncConsentsOptions.md)
+- [SyncConsentsResult](interfaces/SyncConsentsResult.md)
+- [TerrenoAppOptions](interfaces/TerrenoAppOptions.md)
+- [TerrenoPlugin](interfaces/TerrenoPlugin.md)
+- [TerrenoRequestLogEntry](interfaces/TerrenoRequestLogEntry.md)
+- [TerrenoTransformer](interfaces/TerrenoTransformer.md)
+- [User](interfaces/User.md)
+- [UserModel](interfaces/UserModel.md)
+- [VersionCheckResponse](interfaces/VersionCheckResponse.md)
+- [VersionConfigDocument](interfaces/VersionConfigDocument.md)
+- [VersionConfigModel](interfaces/VersionConfigModel.md)
+- [WithApiErrorHandlingOptions](interfaces/WithApiErrorHandlingOptions.md)
+- [WrapScriptOptions](interfaces/WrapScriptOptions.md)
+
+## Type Aliases
+
+- [AddRoutes](type-aliases/AddRoutes.md)
+- [ApiErrorClassification](type-aliases/ApiErrorClassification.md)
+- [AuthProvider](type-aliases/AuthProvider.md)
+- [AuthStrategy](type-aliases/AuthStrategy.md)
+- [BetterAuthInstance](type-aliases/BetterAuthInstance.md)
+- [ConfigType](type-aliases/ConfigType.md)
+- [ConfigurationPostUpdateHook](type-aliases/ConfigurationPostUpdateHook.md)
+- [ConfigurationPreUpdateHook](type-aliases/ConfigurationPreUpdateHook.md)
+- [ConsentFormMethods](type-aliases/ConsentFormMethods.md)
+- [ConsentFormType](type-aliases/ConsentFormType.md)
+- [DeepPartial](type-aliases/DeepPartial.md)
+- [GooseRESTOptions](type-aliases/GooseRESTOptions.md)
+- [JSONPrimitive](type-aliases/JSONPrimitive.md)
+- [JSONValue](type-aliases/JSONValue.md)
+- [Paths](type-aliases/Paths.md)
+- [PathValue](type-aliases/PathValue.md)
+- [PermissionMethod](type-aliases/PermissionMethod.md)
+- [RequestContextAttributes](type-aliases/RequestContextAttributes.md)
+- [RESTMethod](type-aliases/RESTMethod.md)
+- [ScriptArgValue](type-aliases/ScriptArgValue.md)
+- [ScriptRunner](type-aliases/ScriptRunner.md)
+- [VersionCheckStatus](type-aliases/VersionCheckStatus.md)
+
+## Variables
+
+- [ACTION\_NAME\_PATTERN](variables/ACTION_NAME_PATTERN.md)
+- [BackgroundTask](variables/BackgroundTask.md)
+- [Config](variables/Config.md)
+- [ConsentForm](variables/ConsentForm.md)
+- [ConsentResponse](variables/ConsentResponse.md)
+- [consentResponsePopulatePaths](variables/consentResponsePopulatePaths.md)
+- [gooseRestRouter](variables/gooseRestRouter.md)
+- [logger](variables/logger.md)
+- [MAX\_DOCUMENT\_SUBSCRIPTIONS](variables/MAX_DOCUMENT_SUBSCRIPTIONS.md)
+- [MAX\_MODEL\_SUBSCRIPTIONS](variables/MAX_MODEL_SUBSCRIPTIONS.md)
+- [MAX\_QUERY\_SUBSCRIPTIONS](variables/MAX_QUERY_SUBSCRIPTIONS.md)
+- [Permissions](variables/Permissions.md)
+- [REQUEST\_CONTEXT\_ATTRIBUTE\_NAMES](variables/REQUEST_CONTEXT_ATTRIBUTE_NAMES.md)
+- [VersionConfig](variables/VersionConfig.md)
+- [winstonLogger](variables/winstonLogger.md)
+
+## Functions
+
+- [addAuthRoutes](functions/addAuthRoutes.md)
+- [addGitHubAuthRoutes](functions/addGitHubAuthRoutes.md)
+- [addMeRoutes](functions/addMeRoutes.md)
+- [addPopulateToQuery](functions/addPopulateToQuery.md)
+- [addQuerySubscription](functions/addQuerySubscription.md)
+- [AdminOwnerTransformer](functions/AdminOwnerTransformer.md)
+- [apiErrorMiddleware](functions/apiErrorMiddleware.md)
+- [apiFallthroughErrorMiddleware](functions/apiFallthroughErrorMiddleware.md)
+- [apiUnauthorizedMiddleware](functions/apiUnauthorizedMiddleware.md)
+- [applyRequestContextToSentry](functions/applyRequestContextToSentry.md)
+- [assertNoActionCollisions](functions/assertNoActionCollisions.md)
+- [asyncHandler](functions/asyncHandler.md)
+- [authenticateMiddleware](functions/authenticateMiddleware.md)
+- [baseUserPlugin](functions/baseUserPlugin.md)
+- [buildQuerySchemaFromFields](functions/buildQuerySchemaFromFields.md)
+- [checkModelsStrict](functions/checkModelsStrict.md)
+- [checkPermissions](functions/checkPermissions.md)
+- [clearQueryStore](functions/clearQueryStore.md)
+- [clearRealtimeRegistry](functions/clearRealtimeRegistry.md)
+- [computeQueryId](functions/computeQueryId.md)
+- [configurationPlugin](functions/configurationPlugin.md)
+- [configureOpenApiValidator](functions/configureOpenApiValidator.md)
+- [createActionOpenApiMiddleware](functions/createActionOpenApiMiddleware.md)
+- [createAuthenticatedClient](functions/createAuthenticatedClient.md)
+- [createBetterAuth](functions/createBetterAuth.md)
+- [createBetterAuthSessionMiddleware](functions/createBetterAuthSessionMiddleware.md)
+- [createdUpdatedPlugin](functions/createdUpdatedPlugin.md)
+- [createFeatureFlaggedLogger](functions/createFeatureFlaggedLogger.md)
+- [createModelValidators](functions/createModelValidators.md)
+- [createOpenApiBuilder](functions/createOpenApiBuilder.md)
+- [createRouter](functions/createRouter.md)
+- [createRouterWithAuth](functions/createRouterWithAuth.md)
+- [createScopedLogger](functions/createScopedLogger.md)
+- [createScriptArgs](functions/createScriptArgs.md)
+- [createValidator](functions/createValidator.md)
+- [cronjob](functions/cronjob.md)
+- [defaultResponseHandler](functions/defaultResponseHandler.md)
+- [defineCollectionAction](functions/defineCollectionAction.md)
+- [defineInstanceAction](functions/defineInstanceAction.md)
+- [envConfigurationPlugin](functions/envConfigurationPlugin.md)
+- [errorMessage](functions/errorMessage.md)
+- [errorsPlugin](functions/errorsPlugin.md)
+- [errorStack](functions/errorStack.md)
+- [findExactlyOne](functions/findExactlyOne.md)
+- [findOneOrNone](functions/findOneOrNone.md)
+- [findOneOrNoneFor](functions/findOneOrNoneFor.md)
+- [findRegistryEntryByCollection](functions/findRegistryEntryByCollection.md)
+- [findRegistryEntryByRoutePath](functions/findRegistryEntryByRoutePath.md)
+- [firebaseJWTPlugin](functions/firebaseJWTPlugin.md)
+- [fixMixedFields](functions/fixMixedFields.md)
+- [flattenToDotPaths](functions/flattenToDotPaths.md)
+- [formatLogContextSuffix](functions/formatLogContextSuffix.md)
+- [generateTokens](functions/generateTokens.md)
+- [getAPIErrorBody](functions/getAPIErrorBody.md)
+- [getBetterAuthSession](functions/getBetterAuthSession.md)
+- [getCurrentLogContext](functions/getCurrentLogContext.md)
+- [getCurrentRequestContext](functions/getCurrentRequestContext.md)
+- [getCurrentRequestContextAttributes](functions/getCurrentRequestContextAttributes.md)
+- [getDisableExternalErrorTracking](functions/getDisableExternalErrorTracking.md)
+- [getMongoClientFromMongoose](functions/getMongoClientFromMongoose.md)
+- [getOpenApiSpecForModel](functions/getOpenApiSpecForModel.md)
+- [getOpenApiValidatorConfig](functions/getOpenApiValidatorConfig.md)
+- [getQuerySubscriptionsForCollection](functions/getQuerySubscriptionsForCollection.md)
+- [getRealtimeRegistry](functions/getRealtimeRegistry.md)
+- [getRequestContextFromAttributes](functions/getRequestContextFromAttributes.md)
+- [getSchemaFromModel](functions/getSchemaFromModel.md)
+- [getSessionIdFromJwtPayload](functions/getSessionIdFromJwtPayload.md)
+- [githubUserPlugin](functions/githubUserPlugin.md)
+- [hasBetterAuthSession](functions/hasBetterAuthSession.md)
+- [installRealtimeSocketHandlers](functions/installRealtimeSocketHandlers.md)
+- [isAPIError](functions/isAPIError.md)
+- [isDeletedPlugin](functions/isDeletedPlugin.md)
+- [isDisabledPlugin](functions/isDisabledPlugin.md)
+- [isOpenApiValidatorConfigured](functions/isOpenApiValidatorConfigured.md)
+- [isValidObjectId](functions/isValidObjectId.md)
+- [jsonResponseRequestIdMiddleware](functions/jsonResponseRequestIdMiddleware.md)
+- [logRequests](functions/logRequests.md)
+- [markRetryUnsafe](functions/markRetryUnsafe.md)
+- [matchesQuery](functions/matchesQuery.md)
+- [modelRouter](functions/modelRouter.md)
+- [mongooseErrorToAPIError](functions/mongooseErrorToAPIError.md)
+- [mountBetterAuthRoutes](functions/mountBetterAuthRoutes.md)
+- [normalizeApiError](functions/normalizeApiError.md)
+- [openApiCompatMiddleware](functions/openApiCompatMiddleware.md)
+- [openApiEtagMiddleware](functions/openApiEtagMiddleware.md)
+- [OwnerQueryFilter](functions/OwnerQueryFilter.md)
+- [parseScriptArgs](functions/parseScriptArgs.md)
+- [patchAppUse](functions/patchAppUse.md)
+- [permissionMiddleware](functions/permissionMiddleware.md)
+- [registerActionRoutes](functions/registerActionRoutes.md)
+- [registerRealtime](functions/registerRealtime.md)
+- [removeAllSocketQueries](functions/removeAllSocketQueries.md)
+- [removeQuerySubscription](functions/removeQuerySubscription.md)
+- [requestContextMiddleware](functions/requestContextMiddleware.md)
+- [resetOpenApiValidatorConfig](functions/resetOpenApiValidatorConfig.md)
+- [runActionPermissions](functions/runActionPermissions.md)
+- [runWithRequestContext](functions/runWithRequestContext.md)
+- [runWithRequestContextAttributes](functions/runWithRequestContextAttributes.md)
+- [sendToGoogleChat](functions/sendToGoogleChat.md)
+- [sendToSlack](functions/sendToSlack.md)
+- [sendToZoom](functions/sendToZoom.md)
+- [sentryAppVersionMiddleware](functions/sentryAppVersionMiddleware.md)
+- [serialize](functions/serialize.md)
+- [setRequestContext](functions/setRequestContext.md)
+- [setupAuth](functions/setupAuth.md)
+- [setupBetterAuthUserSync](functions/setupBetterAuthUserSync.md)
+- [setupEnvironment](functions/setupEnvironment.md)
+- [setupGitHubAuth](functions/setupGitHubAuth.md)
+- [setupLogging](functions/setupLogging.md)
+- [signupUser](functions/signupUser.md)
+- [startChangeStreamWatcher](functions/startChangeStreamWatcher.md)
+- [stopChangeStreamWatcher](functions/stopChangeStreamWatcher.md)
+- [syncBetterAuthUser](functions/syncBetterAuthUser.md)
+- [syncConsents](functions/syncConsents.md)
+- [timeout](functions/timeout.md)
+- [transform](functions/transform.md)
+- [unpopulate](functions/unpopulate.md)
+- [updateRequestContextFromRequest](functions/updateRequestContextFromRequest.md)
+- [upsertPlugin](functions/upsertPlugin.md)
+- [validateActionRequest](functions/validateActionRequest.md)
+- [validateModelRequestBody](functions/validateModelRequestBody.md)
+- [validateQueryParams](functions/validateQueryParams.md)
+- [validateRequestBody](functions/validateRequestBody.md)
+- [validateResponseData](functions/validateResponseData.md)
+- [withApiErrorHandling](functions/withApiErrorHandling.md)
+- [wrapActionResponse](functions/wrapActionResponse.md)
+- [wrapScript](functions/wrapScript.md)

package/src/docs/versioned/0.27.0/reference/generated/api/functions/addQuerySubscription.md

@@ -0,0 +1,26 @@
+> **addQuerySubscription**(`socketId`, `collection`, `query`, `queryId`): `void`
+
+Register a query subscription for a socket.
+The socket joins the `query:{queryId}` room (handled by the caller).
+
+## Parameters
+
+### socketId
+
+`string`
+
+### collection
+
+`string`
+
+### query
+
+`Record`\<`string`, `unknown`\>
+
+### queryId
+
+`string`
+
+## Returns
+
+`void`

package/src/docs/versioned/0.27.0/reference/generated/api/functions/computeQueryId.md

@@ -0,0 +1,18 @@
+> **computeQueryId**(`collection`, `query`): `string`
+
+Compute a deterministic queryId from collection and query on the server side.
+This prevents clients from hijacking other subscriptions by providing a colliding queryId.
+
+## Parameters
+
+### collection
+
+`string`
+
+### query
+
+`Record`\<`string`, `unknown`\>
+
+## Returns
+
+`string`

package/src/docs/versioned/0.27.0/reference/generated/api/functions/createAuthenticatedClient.md

@@ -0,0 +1,28 @@
+> **createAuthenticatedClient**(`options`): [`AuthenticatedClient`](../interfaces/AuthenticatedClient.md)
+
+Creates an axios instance with a pluggable auth strategy, token caching, and a retry
+policy for transient failures.
+
+Auth: tokens/keys are fetched lazily on the first request and cached on the client;
+`invalidateToken()` drops the cache. The oauth2 strategy fetches a client-credentials
+token (HTTP Basic auth, form-encoded `grant_type=client_credentials`) and, with
+`refreshOn401`, refreshes and retries exactly once when a request returns 401.
+
+Retries: failures classified in `retry.retryOn` (default: rateLimited, server,
+network) are retried with exponential backoff and jitter up to `maxAttempts` total
+attempts, honoring a parseable Retry-After header. Only idempotent methods
+(GET/HEAD/OPTIONS) are retried unless the request opts in via markRetryUnsafe().
+
+Logging: the client logs retries and token refreshes at debug level only and always
+rejects with the original axios error — error-level logging is left to the call site
+(typically via withApiErrorHandling) so composed usage logs each failure exactly once.
+
+## Parameters
+
+### options
+
+[`CreateAuthenticatedClientOptions`](../interfaces/CreateAuthenticatedClientOptions.md)
+
+## Returns
+
+[`AuthenticatedClient`](../interfaces/AuthenticatedClient.md)

package/src/docs/versioned/0.27.0/reference/generated/api/functions/logRequests.md

@@ -0,0 +1,19 @@
+> **logRequests**(`req`, `res`, `next`): `void`
+
+## Parameters
+
+### req
+
+`LoggableRequest`
+
+### res
+
+`LoggableResponse`
+
+### next
+
+`NextFunction`
+
+## Returns
+
+`void`

package/src/docs/versioned/0.27.0/reference/generated/api/functions/markRetryUnsafe.md

@@ -0,0 +1,17 @@
+> **markRetryUnsafe**(`config?`): `AxiosRequestConfig`
+
+Opts a non-idempotent request (POST/PUT/PATCH/DELETE) into the retry policy of a
+createAuthenticatedClient instance: `client.axios.post(url, body, markRetryUnsafe())`.
+Callers must be sure the operation is safe to repeat, and the request body must be
+replayable — JSON objects are fine, but streams/FormData are consumed on first send.
+Has no effect on axios instances not created by createAuthenticatedClient.
+
+## Parameters
+
+### config?
+
+`AxiosRequestConfig` = `{}`
+
+## Returns
+
+`AxiosRequestConfig`

package/src/docs/versioned/0.27.0/reference/generated/api/functions/normalizeApiError.md

@@ -0,0 +1,32 @@
+> **normalizeApiError**(`error`, `context`): [`NormalizedApiError`](../interfaces/NormalizedApiError.md)
+
+Normalizes an unknown thrown value from an external API call into a stable shape:
+status code, human-readable messages, and a machine classification. Axios errors are
+unwrapped (response body messages extracted); axios errors without a response are
+classified as "network"; non-axios errors fall through to "unknown" with the error
+message preserved.
+
+Raw payload bodies are not carried on the normalized shape — only recognized message
+fields are extracted, and plain-string bodies are truncated. Consumers whose services
+put sensitive data inside those message fields should additionally use a redactError
+hook.
+
+## Parameters
+
+### error
+
+`unknown`
+
+### context
+
+#### apiName
+
+`string`
+
+#### operation
+
+`string`
+
+## Returns
+
+[`NormalizedApiError`](../interfaces/NormalizedApiError.md)

package/src/docs/versioned/0.27.0/reference/generated/api/functions/withApiErrorHandling.md

@@ -0,0 +1,31 @@
+> **withApiErrorHandling**\<`T`\>(`fn`, `options`): `Promise`\<`T`\>
+
+Wraps an external API call with standardized error handling: failures are normalized
+via normalizeApiError, passed through the optional redactError hook, logged exactly
+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.
+
+## Type Parameters
+
+### T
+
+`T`
+
+## Parameters
+
+### fn
+
+() => `Promise`\<`T`\>
+
+### options
+
+[`WithApiErrorHandlingOptions`](../interfaces/WithApiErrorHandlingOptions.md)
+
+## Returns
+
+`Promise`\<`T`\>

package/src/docs/versioned/0.27.0/reference/generated/api/interfaces/AuthenticatedClient.md

@@ -0,0 +1,15 @@
+## Properties
+
+### axios
+
+> **axios**: `AxiosInstance`
+
+***
+
+### invalidateToken
+
+> **invalidateToken**: () => `void`
+
+#### Returns
+
+`void`

package/src/docs/versioned/0.27.0/reference/generated/api/interfaces/CreateAuthenticatedClientOptions.md

@@ -0,0 +1,45 @@
+## Properties
+
+### apiName?
+
+> `optional` **apiName?**: `string`
+
+***
+
+### auth
+
+> **auth**: [`AuthStrategy`](../type-aliases/AuthStrategy.md)
+
+***
+
+### baseURL
+
+> **baseURL**: `string`
+
+***
+
+### logger?
+
+> `optional` **logger?**: [`HttpClientLogger`](HttpClientLogger.md)
+
+***
+
+### redactError?
+
+> `optional` **redactError?**: (`normalized`) => [`NormalizedApiError`](NormalizedApiError.md)
+
+#### Parameters
+
+##### normalized
+
+[`NormalizedApiError`](NormalizedApiError.md)
+
+#### Returns
+
+[`NormalizedApiError`](NormalizedApiError.md)
+
+***
+
+### retry?
+
+> `optional` **retry?**: `Partial`\<[`RetryPolicy`](RetryPolicy.md)\>

package/src/docs/versioned/0.27.0/reference/generated/api/interfaces/GitHubAuthOptions.md

@@ -0,0 +1,74 @@
+Options for configuring GitHub OAuth authentication
+
+## Properties
+
+### allowAccountLinking?
+
+> `optional` **allowAccountLinking?**: `boolean`
+
+Whether to allow linking GitHub to existing accounts.
+If true, authenticated users can link their GitHub account.
+Defaults to true.
+
+***
+
+### callbackURL
+
+> **callbackURL**: `string`
+
+Callback URL for GitHub OAuth (e.g., https://yourapp.com/auth/github/callback)
+
+***
+
+### clientId
+
+> **clientId**: `string`
+
+GitHub OAuth Client ID
+
+***
+
+### clientSecret
+
+> **clientSecret**: `string`
+
+GitHub OAuth Client Secret
+
+***
+
+### findOrCreateUser?
+
+> `optional` **findOrCreateUser?**: (`profile`, `accessToken`, `refreshToken`, `existingUser?`) => `Promise`\<`unknown`\>
+
+Custom function to handle user creation or lookup from GitHub profile.
+If not provided, a default implementation will be used.
+
+#### Parameters
+
+##### profile
+
+`Profile`
+
+##### accessToken
+
+`string`
+
+##### refreshToken
+
+`string`
+
+##### existingUser?
+
+`Record`\<`string`, `unknown`\>
+
+#### Returns
+
+`Promise`\<`unknown`\>
+
+***
+
+### scope?
+
+> `optional` **scope?**: `string`[]
+
+OAuth scopes to request from GitHub. Defaults to ["user:email"]

package/src/docs/versioned/0.27.0/reference/generated/api/interfaces/HttpClientLogger.md

@@ -0,0 +1,62 @@
+Minimal logging surface used by the HTTP client utilities so consumers (and tests)
+can inject their own logger. Defaults to the terreno logger.
+
+## Properties
+
+### debug
+
+> **debug**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+***
+
+### error
+
+> **error**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`
+
+***
+
+### warn
+
+> **warn**: (`msg`, ...`args`) => `void`
+
+#### Parameters
+
+##### msg
+
+`string`
+
+##### args
+
+...`unknown`[]
+
+#### Returns
+
+`void`