@terreno/mcp 0.21.0 → 0.22.1

package/dist/docs/versioned/0.21.0/reference/generated/api/interfaces/ModelRouterOptions.md

@@ -0,0 +1,524 @@
+This is the main configuration.
+
+## Type Parameters
+
+### T
+
+`T`
+
+the base document type. This should not include Mongoose models, just the types of the object.
+
+## Properties
+
+### allowAnonymous?
+
+> `optional` **allowAnonymous?**: `boolean`
+
+Allow anonymous users to access the resource.
+Defaults to false.
+
+***
+
+### collectionActions?
+
+> `optional` **collectionActions?**: `Record`\<`string`, [`CollectionActionConfig`](CollectionActionConfig.md)\<`unknown`, `unknown`, `unknown`\>\>
+
+Named collection-scoped operations at `/:actionName` (GET or POST).
+
+***
+
+### defaultLimit?
+
+> `optional` **defaultLimit?**: `number`
+
+Default limit applied to list queries if not specified by the user. Defaults to 100.
+
+***
+
+### defaultQueryParams?
+
+> `optional` **defaultQueryParams?**: `Record`\<`string`, `unknown`\>
+
+Default queries to provide to Mongo before any user queries or transforms happen when making
+list queries. Accepts any Mongoose-style queries, and runs for all user types.
+   defaultQueryParams: {hidden: false} // By default, don't show objects with hidden=true
+These can be overridden by the user if not disallowed by queryFilter.
+
+***
+
+### endpoints?
+
+> `optional` **endpoints?**: (`router`, `options?`) => `void`
+
+Custom route setup function. Receives the router and optionally the full options (including openApi).
+
+#### Parameters
+
+##### router
+
+`Router`
+
+##### options?
+
+`Partial`\<`ModelRouterOptions`\<`T`\>\>
+
+#### Returns
+
+`void`
+
+***
+
+### instanceActions?
+
+> `optional` **instanceActions?**: `Record`\<`string`, [`InstanceActionConfig`](InstanceActionConfig.md)\<`T`, `unknown`, `unknown`, `unknown`\>\>
+
+Named instance-scoped operations at `/:id/:actionName` (GET or POST).
+
+***
+
+### maxLimit?
+
+> `optional` **maxLimit?**: `number`
+
+Maximum query limit the user can request. Defaults to 500, and is the lowest of the limit
+query, max limit,
+ or 500.
+
+***
+
+### openApi?
+
+> `optional` **openApi?**: [`OpenApiMiddleware`](OpenApiMiddleware.md)
+
+The OpenAPI generator for this server. This is used to generate the OpenAPI documentation.
+
+***
+
+### openApiExtraModelProperties?
+
+> `optional` **openApiExtraModelProperties?**: `Record`\<`string`, `unknown`\>
+
+Overwrite parts of the model properties for the OpenAPI generator.
+This will be merged with the generated configuration.
+This is useful if you add custom properties to the model during serialize, for example,
+that you want to be documented and typed in the SDK.
+
+***
+
+### openApiOverwrite?
+
+> `optional` **openApiOverwrite?**: `object`
+
+Overwrite parts of the configuration for the OpenAPI generator.
+This will be merged with the generated configuration.
+
+#### create?
+
+> `optional` **create?**: `Record`\<`string`, `unknown`\>
+
+#### delete?
+
+> `optional` **delete?**: `Record`\<`string`, `unknown`\>
+
+#### get?
+
+> `optional` **get?**: `Record`\<`string`, `unknown`\>
+
+#### list?
+
+> `optional` **list?**: `Record`\<`string`, `unknown`\>
+
+#### update?
+
+> `optional` **update?**: `Record`\<`string`, `unknown`\>
+
+***
+
+### permissions
+
+> **permissions**: [`RESTPermissions`](RESTPermissions.md)\<`T`\>
+
+A group of method-level (create/read/update/delete/list) permissions.
+Determine if the user can perform the operation at all, and for read/update/delete methods,
+whether the user can perform the operation on the object referenced.
+
+***
+
+### populatePaths?
+
+> `optional` **populatePaths?**: [`PopulatePath`](PopulatePath.md)[]
+
+Manages Mongoose populations before returning from all methods (list, read, create, etc).
+For each population:
+ path: Accepts Mongoose-style populate strings for path. e.g. "user" or "users.userId"
+   (for an array of subschemas with userId)
+ fields: An array of strings to filter on the populated objects, following Mongoose's select
+   rules. If each field starts a preceding "-", will act as a block list and only remove those
+   fields. If each field does not start with a "-", will act as an allow list and only
+   return those fields. Mixing allow and blocking is not supported. e.g. "-created updated"
+   is an error.
+ openApiComponent: If you have a component already registered,
+   use that instead of autogenerating the types for the populated fields.
+
+***
+
+### postCreate?
+
+> `optional` **postCreate?**: (`value`, `request`) => `void` \| `Promise`\<`void`\>
+
+Hook that runs after the object is created but before the responseHandler serializes and
+returned. This is a good spot to perform dependent changes to other models or performing async
+tasks/side effects, such as sending a push notification.
+Throw an APIError to return a 400 with an error message.
+
+#### Parameters
+
+##### value
+
+`T`
+
+##### request
+
+`Request`
+
+#### Returns
+
+`void` \| `Promise`\<`void`\>
+
+***
+
+### postDelete?
+
+> `optional` **postDelete?**: (`request`, `value`) => `void` \| `Promise`\<`void`\>
+
+Hook that runs after the object is deleted. This is a good spot to perform dependent changes
+to other models or performing async tasks/side effects, such as cascading object deletions.
+Throw an APIError to return a 400 with an error message.
+
+#### Parameters
+
+##### request
+
+`Request`
+
+The Express request object.
+
+##### value
+
+`T`
+
+The document that was deleted, after the soft update of deleted: true (type: T).
+
+#### Returns
+
+`void` \| `Promise`\<`void`\>
+
+***
+
+### postGet?
+
+> `optional` **postGet?**: (`value`, `request`) => `Promise`\<`T`\> \| `undefined`
+
+Hook that runs after the object is fetched but before it is serialized.
+Returns a promise so that asynchronous actions can be included in the function.
+Throw an APIError to return a 400 with an error message.
+@deprecated: Use responseHandler instead.
+
+#### Parameters
+
+##### value
+
+`T`
+
+##### request
+
+`Request`
+
+#### Returns
+
+`Promise`\<`T`\> \| `undefined`
+
+***
+
+### postList?
+
+> `optional` **postList?**: (`value`, `request`) => `Promise`\<`Document`\<`unknown`, `unknown`, `unknown`, `Record`\<`string`, `any`\>, \{ \}\> & `T`[]\>
+
+Hook that runs after the list of objects is fetched but before they are serialized.
+Returns a promise so that asynchronous actions can be included in the function.
+Throw an APIError to return a 400 with an error message.
+@deprecated: Use responseHandler instead.
+
+#### Parameters
+
+##### value
+
+`Document`\<`unknown`, `unknown`, `unknown`, `Record`\<`string`, `any`\>, \{ \}\> & `T`[]
+
+##### request
+
+`Request`
+
+#### Returns
+
+`Promise`\<`Document`\<`unknown`, `unknown`, `unknown`, `Record`\<`string`, `any`\>, \{ \}\> & `T`[]\>
+
+***
+
+### postUpdate?
+
+> `optional` **postUpdate?**: (`value`, `cleanedBody`, `request`, `prevValue`) => `void` \| `Promise`\<`void`\>
+
+Hook that runs after the object is updated but before the responseHandler serializes and
+returned. This is a good spot to perform dependent changes to other models or perform async
+tasks/side effects, such as sending a push notification.
+Throw an APIError to return a 400 with an error message.
+
+#### Parameters
+
+##### value
+
+`T`
+
+The document after it has been updated (type: T).
+
+##### cleanedBody
+
+`Partial`\<`T`\>
+
+The request body relative to the model update (type: Partial<T>).
+
+##### request
+
+`Request`
+
+The Express request object.
+
+##### prevValue
+
+`T`
+
+The entire document before it was updated (type: T).
+
+#### Returns
+
+`void` \| `Promise`\<`void`\>
+
+***
+
+### preCreate?
+
+> `optional` **preCreate?**: (`value`, `request`) => `T` \| `Promise`\<`T`\> \| `null`
+
+Hook that runs after `transformer.transform` but before the object is created.
+Can update the body fields based on the request or the user.
+Return null to return a generic 403 error. Throw an APIError to return a 400 with specific
+error information.
+
+#### Parameters
+
+##### value
+
+`Partial`\<`T`\> \| (`Partial`\<`T`\> \| `undefined`)[] \| `null` \| `undefined`
+
+##### request
+
+`Request`
+
+#### Returns
+
+`T` \| `Promise`\<`T`\> \| `null`
+
+***
+
+### preDelete?
+
+> `optional` **preDelete?**: (`value`, `request`) => `T` \| `Promise`\<`T`\> \| `null`
+
+Hook that runs after `transformer.transform` but before the object is deleted.
+Return null to return a generic 403 error.
+Throw an APIError to return a 400 with specific error information.
+
+#### Parameters
+
+##### value
+
+`T`
+
+The document to be deleted, before the soft update of deleted: true (type: T).
+
+##### request
+
+`Request`
+
+The Express request object.
+
+#### Returns
+
+`T` \| `Promise`\<`T`\> \| `null`
+
+***
+
+### preUpdate?
+
+> `optional` **preUpdate?**: (`value`, `request`) => `T` \| `Promise`\<`T`\> \| `null`
+
+Hook that runs after `transformer.transform` but before changes are made for update operations.
+Can update the body fields based on the request or the user.
+Also applies to all array operations. Return null to return a generic 403 error.
+Throw an APIError to return a 400 with specific error information.
+
+#### Parameters
+
+##### value
+
+`Partial`\<`T`\>
+
+The request body relative to the model update (type: Partial<T>). Note: this does not contain the entire document to be updated, only the fields being updated.
+
+##### request
+
+`Request`
+
+The Express request object.
+
+#### Returns
+
+`T` \| `Promise`\<`T`\> \| `null`
+
+***
+
+### queryFields?
+
+> `optional` **queryFields?**: `string`[]
+
+A list of fields on the model that can be queried using standard comparisons for booleans,
+strings, dates
+   (as ISOStrings), and numbers.
+For example:
+ ?foo=true // boolean query
+ ?foo=bar // string query
+ ?foo=1 // number query
+ ?foo=2022-07-23T02:34:07.118Z // date query (should first be encoded for query params, not shown here)
+Note: `limit` and `page` are automatically supported and are reserved.
+
+***
+
+### queryFilter?
+
+> `optional` **queryFilter?**: (`user?`, `query?`) => `Record`\<`string`, `unknown`\> \| `Promise`\<`Record`\<`string`, `unknown`\> \| `null`\> \| `null`
+
+queryFilter is a function to parse the query params and see if the query should be allowed.
+This can be used for permissioning to make sure less privileged users are not making
+privileged queries. If a query should not be allowed,
+return `null` from the function and an empty query result will be returned to the client
+without an error. You can also throw an APIError to be explicit about the issues.
+You can transform the given query params by returning different values.
+If the query is acceptable as-is, return `query` as-is.
+
+#### Parameters
+
+##### user?
+
+[`User`](User.md)
+
+##### query?
+
+`Record`\<`string`, `unknown`\>
+
+#### Returns
+
+`Record`\<`string`, `unknown`\> \| `Promise`\<`Record`\<`string`, `unknown`\> \| `null`\> \| `null`
+
+***
+
+### realtime?
+
+> `optional` **realtime?**: [`RealtimeConfig`](RealtimeConfig.md)
+
+Enable real-time sync for this model via WebSocket events.
+When configured, CRUD operations will emit events to connected clients
+through the RealtimeApp plugin's change stream watcher.
+
+Requires the RealtimeApp plugin to be registered with TerrenoApp.
+
+***
+
+### responseHandler?
+
+> `optional` **responseHandler?**: (`value`, `method`, `request`, `options`) => `Promise`\<[`JSONValue`](../type-aliases/JSONValue.md)\>
+
+Serialize an object or list of objects before returning to the client.
+This is a good spot to remove sensitive information from the object, such as passwords or API
+keys. Throw an APIError to return a 400 with an error message.
+
+#### Parameters
+
+##### value
+
+`Document`\<`unknown`, `unknown`, `unknown`, `Record`\<`string`, `any`\>, \{ \}\> & `T` \| `Document`\<`unknown`, `unknown`, `unknown`, `Record`\<`string`, `any`\>, \{ \}\> & `T`[]
+
+##### method
+
+`"delete"` \| `"list"` \| `"create"` \| `"read"` \| `"update"`
+
+##### request
+
+`Request`
+
+##### options
+
+`ModelRouterOptions`\<`T`\>
+
+#### Returns
+
+`Promise`\<[`JSONValue`](../type-aliases/JSONValue.md)\>
+
+***
+
+### sort?
+
+> `optional` **sort?**: `string` \| \{\[`key`: `string`\]: `"ascending"` \| `"descending"`; \}
+
+Default sort for list operations. Can be a single field, a space-seperated list of fields, or an object.
+?sort=foo // single field: foo ascending
+?sort=-foo // single field: foo descending
+?sort=-foo bar // multi field: foo descending, bar ascending
+?sort={foo: 'ascending', bar: 'descending'} // object: foo ascending, bar descending
+
+Note: you should have an index field on these fields or Mongo may slow down considerably.
+
+***
+
+### ~~transformer?~~
+
+> `optional` **transformer?**: [`TerrenoTransformer`](TerrenoTransformer.md)\<`T`\>
+
+Transformers allow data to be transformed before actions are executed,
+and serialized before being returned to the user.
+
+Transformers can be used to throw out fields that the user should not be able to write to, such as the `admin` flag.
+Serializers can be used to hide data from the client or change how it is presented. Serializers run after the data
+has been changed or queried but before returning to the client.
+
+#### Deprecated
+
+Use preCreate/preUpdate/preDelete hooks instead of transformer.transform. Use serialize instead of
+transformer.serialize.
+
+***
+
+### validation?
+
+> `optional` **validation?**: `boolean` \| [`ModelRouterValidationOptions`](ModelRouterValidationOptions.md)
+
+Enable runtime validation of request bodies against the OpenAPI schema.
+When enabled, requests that don't match the documented schema will return 400 errors.
+
+Can be set to:
+- `true`: Enable validation for create and update operations
+- `false`: Disable validation (default)
+- Object with `validateCreate` and `validateUpdate` booleans for fine-grained control
+
+Note: Global validation can be enabled via `configureOpenApiValidator()`.
+This option overrides the global setting for this specific router.

package/dist/docs/versioned/0.21.0/reference/generated/api/interfaces/ModelRouterRegistration.md

@@ -0,0 +1,33 @@
+Registration object returned by modelRouter when called with a path.
+
+Used with `TerrenoApp.register()` to mount model routers at specific paths.
+Contains the Express router and the path it should be mounted at.
+
+## See
+
+ - modelRouter for creating registrations
+ - TerrenoApp for registering routers
+
+## Properties
+
+### \_\_type
+
+> **\_\_type**: `"modelRouter"`
+
+Internal type discriminator for registration detection
+
+***
+
+### path
+
+> **path**: `string`
+
+The path where the router should be mounted (e.g., "/todos")
+
+***
+
+### router
+
+> **router**: `Router`
+
+The Express router containing CRUD endpoints

package/dist/docs/versioned/0.21.0/reference/generated/api/interfaces/ModelRouterValidationOptions.md

@@ -0,0 +1,89 @@
+Options for creating validation middleware for a modelRouter.
+
+## Properties
+
+### excludeFromCreate?
+
+> `optional` **excludeFromCreate?**: `string`[]
+
+Fields to exclude from create validation (e.g. fields injected by preCreate).
+
+***
+
+### excludeFromUpdate?
+
+> `optional` **excludeFromUpdate?**: `string`[]
+
+Fields to exclude from update validation (e.g. fields injected by preUpdate).
+
+***
+
+### onAdditionalPropertiesRemoved?
+
+> `optional` **onAdditionalPropertiesRemoved?**: (`removedProperties`, `req`) => `void`
+
+Callback fired when additional properties are removed from a request body.
+Overrides the global onAdditionalPropertiesRemoved for this router.
+
+#### Parameters
+
+##### removedProperties
+
+`string`[]
+
+##### req
+
+`Request`
+
+#### Returns
+
+`void`
+
+***
+
+### onError?
+
+> `optional` **onError?**: (`errors`, `req`) => `void`
+
+Custom error handler for validation failures.
+
+#### Parameters
+
+##### errors
+
+`ErrorObject`\<`string`, `Record`\<`string`, `any`\>, `unknown`\>[]
+
+##### req
+
+`Request`
+
+#### Returns
+
+`void`
+
+***
+
+### validateCreate?
+
+> `optional` **validateCreate?**: `boolean`
+
+Enable validation for create (POST) requests.
+Default: true (when validation is globally enabled)
+
+***
+
+### validateQuery?
+
+> `optional` **validateQuery?**: `boolean`
+
+Enable validation for query (GET list) requests.
+Default: true (when validation is globally enabled)
+
+***
+
+### validateUpdate?
+
+> `optional` **validateUpdate?**: `boolean`
+
+Enable validation for update (PATCH) requests.
+Default: true (when validation is globally enabled)

package/dist/docs/versioned/0.21.0/reference/generated/api/interfaces/MongoClientLike.md

@@ -0,0 +1,11 @@
+Options for creating a Better Auth instance.
+
+## Properties
+
+### db
+
+> **db**: () => `any`
+
+#### Returns
+
+`any`

package/dist/docs/versioned/0.21.0/reference/generated/api/interfaces/OpenApiBuildResult.md

@@ -0,0 +1,34 @@
+Result from building OpenAPI middleware with schemas exposed.
+Useful when you want to use the schemas with asyncHandler's validation.
+
+## Properties
+
+### bodySchema?
+
+> `optional` **bodySchema?**: `Record`\<`string`, [`OpenApiSchemaProperty`](OpenApiSchemaProperty.md)\>
+
+Request body schema if defined
+
+***
+
+### middleware
+
+> **middleware**: `RequestHandler`
+
+The OpenAPI documentation middleware
+
+***
+
+### querySchema?
+
+> `optional` **querySchema?**: `Record`\<`string`, [`OpenApiSchemaProperty`](OpenApiSchemaProperty.md)\>
+
+Query parameter schemas if defined
+
+***
+
+### validationEnabled
+
+> **validationEnabled**: `boolean`
+
+Whether validation was enabled on this builder