@vendure/docs 0.0.0-202601201808 → 0.0.0-202601211028

package/docs/reference/typescript-api/auth/external-authentication-service.mdx

@@ -2,14 +2,10 @@
 title: "ExternalAuthenticationService"
 generated: true
 ---
-
-
-## ExternalAuthenticationService
-
 <GenerationInfo sourceFile="packages/core/src/service/helpers/external-authentication/external-authentication.service.ts" sourceLine="24" packageName="@vendure/core" />
 
 This is a helper service which exposes methods related to looking up and creating Users based on an
-external <a href='/reference/typescript-api/auth/authentication-strategy#authenticationstrategy'>AuthenticationStrategy</a>.
+external <DocsLink href="/reference/typescript-api/auth/authentication-strategy#authenticationstrategy">AuthenticationStrategy</DocsLink>.
 
 ```ts title="Signature"
 class ExternalAuthenticationService {
@@ -50,7 +46,7 @@ class ExternalAuthenticationService {
 
 ### findCustomerUser
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, strategy: string, externalIdentifier: string, checkCurrentChannelOnly:  = true) => Promise&#60;<a href='/reference/typescript-api/entities/user#user'>User</a> | undefined&#62;`}   />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, strategy: string, externalIdentifier: string, checkCurrentChannelOnly:  = true) => Promise<<a href='/reference/typescript-api/entities/user#user'>User</a> | undefined>`}   />
 
 Looks up a User based on their identifier from an external authentication
 provider, ensuring this User is associated with a Customer account.
@@ -60,13 +56,13 @@ By passing `false` as the `checkCurrentChannelOnly` argument, _all_ channels
 will be checked.
 ### findAdministratorUser
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, strategy: string, externalIdentifier: string) => Promise&#60;<a href='/reference/typescript-api/entities/user#user'>User</a> | undefined&#62;`}   />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, strategy: string, externalIdentifier: string) => Promise<<a href='/reference/typescript-api/entities/user#user'>User</a> | undefined>`}   />
 
 Looks up a User based on their identifier from an external authentication
 provider, ensuring this User is associated with an Administrator account.
 ### createCustomerAndUser
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, config: {             strategy: string;             externalIdentifier: string;             emailAddress: string;             firstName: string;             lastName: string;             verified?: boolean;         }) => Promise&#60;<a href='/reference/typescript-api/entities/user#user'>User</a>&#62;`}   />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, config: {             strategy: string;             externalIdentifier: string;             emailAddress: string;             firstName: string;             lastName: string;             verified?: boolean;         }) => Promise<<a href='/reference/typescript-api/entities/user#user'>User</a>>`}   />
 
 If a customer has been successfully authenticated by an external authentication provider, yet cannot
 be found using `findCustomerUser`, then we need to create a new User and
@@ -81,12 +77,12 @@ be found using `findAdministratorUser`, then we need to create a new User and
 Administrator record in Vendure for that user.
 ### findUser
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, strategy: string, externalIdentifier: string) => Promise&#60;<a href='/reference/typescript-api/entities/user#user'>User</a> | undefined&#62;`}   />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, strategy: string, externalIdentifier: string) => Promise<<a href='/reference/typescript-api/entities/user#user'>User</a> | undefined>`}   />
 
 
 ### createUser
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, config: {             strategy: string;             externalIdentifier: string;         }) => Promise&#60;<a href='/reference/typescript-api/entities/user#user'>User</a>&#62;`}   />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, config: {             strategy: string;             externalIdentifier: string;         }) => Promise<<a href='/reference/typescript-api/entities/user#user'>User</a>>`}   />
 
 Looks up a User based on their identifier from an external authentication
 provider. Creates the user if does not exist. Unlike `findCustomerUser` and `findAdministratorUser`,

package/docs/reference/typescript-api/auth/in-memory-session-cache-strategy.mdx

@@ -2,10 +2,6 @@
 title: "InMemorySessionCacheStrategy"
 generated: true
 ---
-
-
-## InMemorySessionCacheStrategy
-
 <GenerationInfo sourceFile="packages/core/src/config/session-cache/in-memory-session-cache-strategy.ts" sourceLine="16" packageName="@vendure/core" />
 
 Caches session in memory, using a LRU cache implementation. Not suitable for

package/docs/reference/typescript-api/auth/native-authentication-strategy.mdx

@@ -2,10 +2,6 @@
 title: "NativeAuthenticationStrategy"
 generated: true
 ---
-
-
-## NativeAuthenticationStrategy
-
 <GenerationInfo sourceFile="packages/core/src/config/auth/native-authentication-strategy.ts" sourceLine="28" packageName="@vendure/core" />
 
 This strategy implements a username/password credential-based authentication, with the credentials
@@ -21,7 +17,7 @@ class NativeAuthenticationStrategy implements AuthenticationStrategy<NativeAuthe
     verifyUserPassword(ctx: RequestContext, userId: ID, password: string) => Promise<boolean>;
 }
 ```
-* Implements: <code><a href='/reference/typescript-api/auth/authentication-strategy#authenticationstrategy'>AuthenticationStrategy</a>&#60;NativeAuthenticationData&#62;</code>
+* Implements: <code><a href='/reference/typescript-api/auth/authentication-strategy#authenticationstrategy'>AuthenticationStrategy</a><NativeAuthenticationData></code>
 
 
 
@@ -44,12 +40,12 @@ class NativeAuthenticationStrategy implements AuthenticationStrategy<NativeAuthe
 
 ### authenticate
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, data: NativeAuthenticationData) => Promise&#60;<a href='/reference/typescript-api/entities/user#user'>User</a> | false&#62;`}   />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, data: NativeAuthenticationData) => Promise<<a href='/reference/typescript-api/entities/user#user'>User</a> | false>`}   />
 
 
 ### verifyUserPassword
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, userId: <a href='/reference/typescript-api/common/id#id'>ID</a>, password: string) => Promise&#60;boolean&#62;`}   />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, userId: <a href='/reference/typescript-api/common/id#id'>ID</a>, password: string) => Promise<boolean>`}   />
 
 
 

package/docs/reference/typescript-api/auth/noop-session-cache-strategy.mdx

@@ -2,10 +2,6 @@
 title: "NoopSessionCacheStrategy"
 generated: true
 ---
-
-
-## NoopSessionCacheStrategy
-
 <GenerationInfo sourceFile="packages/core/src/config/session-cache/noop-session-cache-strategy.ts" sourceLine="10" packageName="@vendure/core" />
 
 A cache that doesn't cache. The cache lookup will miss every time

package/docs/reference/typescript-api/auth/password-hashing-strategy.mdx

@@ -2,13 +2,9 @@
 title: "PasswordHashingStrategy"
 generated: true
 ---
-
-
-## PasswordHashingStrategy
-
 <GenerationInfo sourceFile="packages/core/src/config/auth/password-hashing-strategy.ts" sourceLine="17" packageName="@vendure/core" since="1.3.0" />
 
-Defines how user passwords get hashed when using the <a href='/reference/typescript-api/auth/native-authentication-strategy#nativeauthenticationstrategy'>NativeAuthenticationStrategy</a>.
+Defines how user passwords get hashed when using the <DocsLink href="/reference/typescript-api/auth/native-authentication-strategy#nativeauthenticationstrategy">NativeAuthenticationStrategy</DocsLink>.
 
 :::info
 
@@ -31,12 +27,12 @@ interface PasswordHashingStrategy extends InjectableStrategy {
 
 ### hash
 
-<MemberInfo kind="method" type={`(plaintext: string) => Promise&#60;string&#62;`}   />
+<MemberInfo kind="method" type={`(plaintext: string) => Promise<string>`}   />
 
 
 ### check
 
-<MemberInfo kind="method" type={`(plaintext: string, hash: string) => Promise&#60;boolean&#62;`}   />
+<MemberInfo kind="method" type={`(plaintext: string, hash: string) => Promise<boolean>`}   />
 
 
 

package/docs/reference/typescript-api/auth/password-validation-strategy.mdx

@@ -2,14 +2,10 @@
 title: "PasswordValidationStrategy"
 generated: true
 ---
-
-
-## PasswordValidationStrategy
-
 <GenerationInfo sourceFile="packages/core/src/config/auth/password-validation-strategy.ts" sourceLine="19" packageName="@vendure/core" since="1.5.0" />
 
 Defines validation to apply to new password (when creating an account or updating an existing account's
-password when using the <a href='/reference/typescript-api/auth/native-authentication-strategy#nativeauthenticationstrategy'>NativeAuthenticationStrategy</a>.
+password when using the <DocsLink href="/reference/typescript-api/auth/native-authentication-strategy#nativeauthenticationstrategy">NativeAuthenticationStrategy</DocsLink>.
 
 :::info
 
@@ -31,7 +27,7 @@ interface PasswordValidationStrategy extends InjectableStrategy {
 
 ### validate
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, password: string) => Promise&#60;boolean | string&#62; | boolean | string`}  since="1.5.0"  />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, password: string) => Promise<boolean | string> | boolean | string`}  since="1.5.0"  />
 
 Validates a password submitted during account registration or when a customer updates their password.
 The method should resolve to `true` if the password is acceptable. If not, it should return `false` or

package/docs/reference/typescript-api/auth/permission-definition.mdx

@@ -2,16 +2,12 @@
 title: "PermissionDefinition"
 generated: true
 ---
-
-
-## PermissionDefinition
-
 <GenerationInfo sourceFile="packages/core/src/common/permission-definition.ts" sourceLine="86" packageName="@vendure/core" />
 
 Defines a new Permission with which to control access to GraphQL resolvers & REST controllers.
-Used in conjunction with the <a href='/reference/typescript-api/request/allow-decorator#allow'>Allow</a> decorator (see example below).
+Used in conjunction with the <DocsLink href="/reference/typescript-api/request/allow-decorator#allow">Allow</DocsLink> decorator (see example below).
 
-**Note:** To define CRUD permissions, use the <a href='/reference/typescript-api/auth/permission-definition#crudpermissiondefinition'>CrudPermissionDefinition</a>.
+**Note:** To define CRUD permissions, use the <DocsLink href="/reference/typescript-api/auth/permission-definition#crudpermissiondefinition">CrudPermissionDefinition</DocsLink>.
 
 *Example*
 
@@ -61,14 +57,10 @@ class PermissionDefinition {
 <MemberInfo kind="property" type={`<a href='/reference/typescript-api/common/permission#permission'>Permission</a>`}   />
 
 Returns the permission defined by this definition, for use in the
-<a href='/reference/typescript-api/request/allow-decorator#allow'>Allow</a> decorator.
+<DocsLink href="/reference/typescript-api/request/allow-decorator#allow">Allow</DocsLink> decorator.
 
 
 </div>
-
-
-## CrudPermissionDefinition
-
 <GenerationInfo sourceFile="packages/core/src/common/permission-definition.ts" sourceLine="146" packageName="@vendure/core" />
 
 Defines a set of CRUD Permissions for the given name, i.e. a `name` of 'Wishlist' will create
@@ -117,7 +109,7 @@ class CrudPermissionDefinition extends PermissionDefinition {
 
 ### constructor
 
-<MemberInfo kind="method" type={`(name: string, descriptionFn?: (operation: 'create' | 'read' | 'update' | 'delete') =&#62; string) => CrudPermissionDefinition`}   />
+<MemberInfo kind="method" type={`(name: string, descriptionFn?: (operation: 'create' | 'read' | 'update' | 'delete') => string) => CrudPermissionDefinition`}   />
 
 
 ### Create
@@ -125,32 +117,28 @@ class CrudPermissionDefinition extends PermissionDefinition {
 <MemberInfo kind="property" type={`<a href='/reference/typescript-api/common/permission#permission'>Permission</a>`}   />
 
 Returns the 'Create' CRUD permission defined by this definition, for use in the
-<a href='/reference/typescript-api/request/allow-decorator#allow'>Allow</a> decorator.
+<DocsLink href="/reference/typescript-api/request/allow-decorator#allow">Allow</DocsLink> decorator.
 ### Read
 
 <MemberInfo kind="property" type={`<a href='/reference/typescript-api/common/permission#permission'>Permission</a>`}   />
 
 Returns the 'Read' CRUD permission defined by this definition, for use in the
-<a href='/reference/typescript-api/request/allow-decorator#allow'>Allow</a> decorator.
+<DocsLink href="/reference/typescript-api/request/allow-decorator#allow">Allow</DocsLink> decorator.
 ### Update
 
 <MemberInfo kind="property" type={`<a href='/reference/typescript-api/common/permission#permission'>Permission</a>`}   />
 
 Returns the 'Update' CRUD permission defined by this definition, for use in the
-<a href='/reference/typescript-api/request/allow-decorator#allow'>Allow</a> decorator.
+<DocsLink href="/reference/typescript-api/request/allow-decorator#allow">Allow</DocsLink> decorator.
 ### Delete
 
 <MemberInfo kind="property" type={`<a href='/reference/typescript-api/common/permission#permission'>Permission</a>`}   />
 
 Returns the 'Delete' CRUD permission defined by this definition, for use in the
-<a href='/reference/typescript-api/request/allow-decorator#allow'>Allow</a> decorator.
+<DocsLink href="/reference/typescript-api/request/allow-decorator#allow">Allow</DocsLink> decorator.
 
 
 </div>
-
-
-## RwPermissionDefinition
-
 <GenerationInfo sourceFile="packages/core/src/common/permission-definition.ts" sourceLine="245" packageName="@vendure/core" since="3.5.0" />
 
 Defines a set of Read-Write Permissions for the given name, i.e. a `name` of 'DashboardSavedViews' will create
@@ -203,7 +191,7 @@ class RwPermissionDefinition extends PermissionDefinition {
 
 ### constructor
 
-<MemberInfo kind="method" type={`(name: string, descriptionFn?: (operation: 'read' | 'write') =&#62; string) => RwPermissionDefinition`}   />
+<MemberInfo kind="method" type={`(name: string, descriptionFn?: (operation: 'read' | 'write') => string) => RwPermissionDefinition`}   />
 
 
 ### Read
@@ -211,23 +199,19 @@ class RwPermissionDefinition extends PermissionDefinition {
 <MemberInfo kind="property" type={`<a href='/reference/typescript-api/common/permission#permission'>Permission</a>`}   />
 
 Returns the 'Read' permission defined by this definition, for use in the
-<a href='/reference/typescript-api/request/allow-decorator#allow'>Allow</a> decorator.
+<DocsLink href="/reference/typescript-api/request/allow-decorator#allow">Allow</DocsLink> decorator.
 ### Write
 
 <MemberInfo kind="property" type={`<a href='/reference/typescript-api/common/permission#permission'>Permission</a>`}   />
 
 Returns the 'Write' permission defined by this definition, for use in the
-<a href='/reference/typescript-api/request/allow-decorator#allow'>Allow</a> decorator.
+<DocsLink href="/reference/typescript-api/request/allow-decorator#allow">Allow</DocsLink> decorator.
 
 
 </div>
-
-
-## PermissionDefinitionConfig
-
 <GenerationInfo sourceFile="packages/core/src/common/permission-definition.ts" sourceLine="10" packageName="@vendure/core" />
 
-Configures a <a href='/reference/typescript-api/auth/permission-definition#permissiondefinition'>PermissionDefinition</a>
+Configures a <DocsLink href="/reference/typescript-api/auth/permission-definition#permissiondefinition">PermissionDefinition</DocsLink>
 
 ```ts title="Signature"
 interface PermissionDefinitionConfig {

package/docs/reference/typescript-api/auth/session-cache-strategy.mdx

@@ -2,10 +2,6 @@
 title: "SessionCacheStrategy"
 generated: true
 ---
-
-
-## SessionCacheStrategy
-
 <GenerationInfo sourceFile="packages/core/src/config/session-cache/session-cache-strategy.ts" sourceLine="164" packageName="@vendure/core" />
 
 This strategy defines how sessions get cached. Since most requests will need the Session
@@ -13,18 +9,18 @@ object for permissions data, it can become a bottleneck to go to the database an
 SQL query each time. Therefore, we cache the session data only perform the SQL query once and upon
 invalidation of the cache.
 
-The Vendure default from v3.1+ is to use a the <a href='/reference/typescript-api/auth/default-session-cache-strategy#defaultsessioncachestrategy'>DefaultSessionCacheStrategy</a>, which delegates
-to the configured <a href='/reference/typescript-api/cache/cache-strategy#cachestrategy'>CacheStrategy</a> to store the session data. This should be suitable
+The Vendure default from v3.1+ is to use a the <DocsLink href="/reference/typescript-api/auth/default-session-cache-strategy#defaultsessioncachestrategy">DefaultSessionCacheStrategy</DocsLink>, which delegates
+to the configured <DocsLink href="/reference/typescript-api/cache/cache-strategy#cachestrategy">CacheStrategy</DocsLink> to store the session data. This should be suitable
 for most use-cases.
 
 :::note
 
 If you are using v3.1 or later, you should not normally need to implement a custom `SessionCacheStrategy`,
-since this is now handled by the <a href='/reference/typescript-api/auth/default-session-cache-strategy#defaultsessioncachestrategy'>DefaultSessionCacheStrategy</a>.
+since this is now handled by the <DocsLink href="/reference/typescript-api/auth/default-session-cache-strategy#defaultsessioncachestrategy">DefaultSessionCacheStrategy</DocsLink>.
 
 :::
 
-Prior to v3.1, the default was to use the <a href='/reference/typescript-api/auth/in-memory-session-cache-strategy#inmemorysessioncachestrategy'>InMemorySessionCacheStrategy</a>, which is fast but suitable for
+Prior to v3.1, the default was to use the <DocsLink href="/reference/typescript-api/auth/in-memory-session-cache-strategy#inmemorysessioncachestrategy">InMemorySessionCacheStrategy</DocsLink>, which is fast but suitable for
 single-instance deployments.
 
 :::info
@@ -137,33 +133,29 @@ interface SessionCacheStrategy extends InjectableStrategy {
 
 ### set
 
-<MemberInfo kind="method" type={`(session: <a href='/reference/typescript-api/auth/session-cache-strategy#cachedsession'>CachedSession</a>) => void | Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(session: <a href='/reference/typescript-api/auth/session-cache-strategy#cachedsession'>CachedSession</a>) => void | Promise<void>`}   />
 
 Store the session in the cache. When caching a session, the data
 should not be modified apart from performing any transforms needed to
 get it into a state to be stored, e.g. JSON.stringify().
 ### get
 
-<MemberInfo kind="method" type={`(sessionToken: string) => <a href='/reference/typescript-api/auth/session-cache-strategy#cachedsession'>CachedSession</a> | undefined | Promise&#60;<a href='/reference/typescript-api/auth/session-cache-strategy#cachedsession'>CachedSession</a> | undefined&#62;`}   />
+<MemberInfo kind="method" type={`(sessionToken: string) => <a href='/reference/typescript-api/auth/session-cache-strategy#cachedsession'>CachedSession</a> | undefined | Promise<<a href='/reference/typescript-api/auth/session-cache-strategy#cachedsession'>CachedSession</a> | undefined>`}   />
 
 Retrieve the session from the cache
 ### delete
 
-<MemberInfo kind="method" type={`(sessionToken: string) => void | Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(sessionToken: string) => void | Promise<void>`}   />
 
 Delete a session from the cache
 ### clear
 
-<MemberInfo kind="method" type={`() => void | Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`() => void | Promise<void>`}   />
 
 Clear the entire cache
 
 
 </div>
-
-
-## CachedSessionUser
-
 <GenerationInfo sourceFile="packages/core/src/config/session-cache/session-cache-strategy.ts" sourceLine="14" packageName="@vendure/core" />
 
 A simplified representation of the User associated with the
@@ -203,10 +195,6 @@ type CachedSessionUser = {
 
 
 </div>
-
-
-## CachedSession
-
 <GenerationInfo sourceFile="packages/core/src/config/session-cache/session-cache-strategy.ts" sourceLine="29" packageName="@vendure/core" />
 
 A simplified representation of a Session which is easy to

package/docs/reference/typescript-api/auth/superadmin-credentials.mdx

@@ -2,10 +2,6 @@
 title: "SuperadminCredentials"
 generated: true
 ---
-
-
-## SuperadminCredentials
-
 <GenerationInfo sourceFile="packages/core/src/config/vendure-config.ts" sourceLine="851" packageName="@vendure/core" />
 
 These credentials will be used to create the Superadmin user & administrator

package/docs/reference/typescript-api/auth/verification-token-strategy.mdx

@@ -2,10 +2,6 @@
 title: "VerificationTokenStrategy"
 generated: true
 ---
-
-
-## VerificationTokenStrategy
-
 <GenerationInfo sourceFile="packages/core/src/config/auth/verification-token-strategy.ts" sourceLine="18" packageName="@vendure/core" since="3.2.0" />
 
 Defines a custom strategy for creating and validating verification tokens.
@@ -31,12 +27,12 @@ interface VerificationTokenStrategy extends InjectableStrategy {
 
 ### generateVerificationToken
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>) => Promise&#60;string&#62; | string`}  since="3.2.0"  />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>) => Promise<string> | string`}  since="3.2.0"  />
 
 Generates a verification token.
 ### verifyVerificationToken
 
-<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, token: string) => Promise&#60;boolean&#62; | boolean`}  since="3.2.0"  />
+<MemberInfo kind="method" type={`(ctx: <a href='/reference/typescript-api/request/request-context#requestcontext'>RequestContext</a>, token: string) => Promise<boolean> | boolean`}  since="3.2.0"  />
 
 Checks the validity of a verification token.
 

package/docs/reference/typescript-api/cache/cache-config.mdx

@@ -2,13 +2,9 @@
 title: "CacheConfig"
 generated: true
 ---
-
-
-## CacheConfig
-
 <GenerationInfo sourceFile="packages/core/src/cache/cache.ts" sourceLine="14" packageName="@vendure/core" since="3.1.0" />
 
-Configuration for a new <a href='/reference/typescript-api/cache/#cache'>Cache</a> instance.
+Configuration for a new <DocsLink href="/reference/typescript-api/cache/#cache">Cache</DocsLink> instance.
 
 ```ts title="Signature"
 interface CacheConfig {
@@ -21,7 +17,7 @@ interface CacheConfig {
 
 ### getKey
 
-<MemberInfo kind="property" type={`(id: string | number) =&#62; string`}   />
+<MemberInfo kind="property" type={`(id: string | number) => string`}   />
 
 A function which generates a cache key from the given id.
 This key will be used to store the value in the cache.

package/docs/reference/typescript-api/cache/cache-service.mdx

@@ -2,15 +2,11 @@
 title: "CacheService"
 generated: true
 ---
-
-
-## CacheService
-
 <GenerationInfo sourceFile="packages/core/src/cache/cache.service.ts" sourceLine="21" packageName="@vendure/core" since="3.1.0" />
 
 The CacheService is used to cache data in order to optimize performance.
 
-Internally it makes use of the configured <a href='/reference/typescript-api/cache/cache-strategy#cachestrategy'>CacheStrategy</a> to persist
+Internally it makes use of the configured <DocsLink href="/reference/typescript-api/cache/cache-strategy#cachestrategy">CacheStrategy</DocsLink> to persist
 the cache into a key-value store.
 
 ```ts title="Signature"
@@ -41,19 +37,19 @@ class CacheService {
 
 <MemberInfo kind="method" type={`(config: <a href='/reference/typescript-api/cache/cache-config#cacheconfig'>CacheConfig</a>) => <a href='/reference/typescript-api/cache/#cache'>Cache</a>`}   />
 
-Creates a new <a href='/reference/typescript-api/cache/#cache'>Cache</a> instance with the given configuration.
+Creates a new <DocsLink href="/reference/typescript-api/cache/#cache">Cache</DocsLink> instance with the given configuration.
 
 The `Cache` instance provides a convenience wrapper around the `CacheService`
 methods.
 ### get
 
-<MemberInfo kind="method" type={`(key: string) => Promise&#60;T | undefined&#62;`}   />
+<MemberInfo kind="method" type={`(key: string) => Promise<T | undefined>`}   />
 
 Gets an item from the cache, or returns undefined if the key is not found, or the
 item has expired.
 ### set
 
-<MemberInfo kind="method" type={`(key: string, value: T, options?: <a href='/reference/typescript-api/cache/cache-strategy#setcachekeyoptions'>SetCacheKeyOptions</a>) => Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(key: string, value: T, options?: <a href='/reference/typescript-api/cache/cache-strategy#setcachekeyoptions'>SetCacheKeyOptions</a>) => Promise<void>`}   />
 
 Sets a key-value pair in the cache. The value must be serializable, so cannot contain
 things like functions, circular data structures, class instances etc.
@@ -62,12 +58,12 @@ Optionally a "time to live" (ttl) can be specified, which means that the key wil
 be considered stale after that many milliseconds.
 ### delete
 
-<MemberInfo kind="method" type={`(key: string) => Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(key: string) => Promise<void>`}   />
 
 Deletes an item from the cache.
 ### invalidateTags
 
-<MemberInfo kind="method" type={`(tags: string[]) => Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(tags: string[]) => Promise<void>`}   />
 
 Deletes all items from the cache which contain at least one matching tag.
 

package/docs/reference/typescript-api/cache/cache-strategy.mdx

@@ -2,15 +2,11 @@
 title: "CacheStrategy"
 generated: true
 ---
-
-
-## CacheStrategy
-
 <GenerationInfo sourceFile="packages/core/src/config/system/cache-strategy.ts" sourceLine="53" packageName="@vendure/core" since="3.1.0" />
 
 The CacheStrategy defines how the underlying shared cache mechanism is implemented.
 
-It is used by the <a href='/reference/typescript-api/cache/cache-service#cacheservice'>CacheService</a> to take care of storage and retrieval of items
+It is used by the <DocsLink href="/reference/typescript-api/cache/cache-service#cacheservice">CacheService</DocsLink> to take care of storage and retrieval of items
 from the cache.
 
 If you are using the `DefaultCachePlugin` or the `RedisCachePlugin`, you will not need to
@@ -40,13 +36,13 @@ interface CacheStrategy extends InjectableStrategy {
 
 ### get
 
-<MemberInfo kind="method" type={`(key: string) => Promise&#60;T | undefined&#62;`}   />
+<MemberInfo kind="method" type={`(key: string) => Promise<T | undefined>`}   />
 
 Gets an item from the cache, or returns undefined if the key is not found, or the
 item has expired.
 ### set
 
-<MemberInfo kind="method" type={`(key: string, value: T, options?: <a href='/reference/typescript-api/cache/cache-strategy#setcachekeyoptions'>SetCacheKeyOptions</a>) => Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(key: string, value: T, options?: <a href='/reference/typescript-api/cache/cache-strategy#setcachekeyoptions'>SetCacheKeyOptions</a>) => Promise<void>`}   />
 
 Sets a key-value pair in the cache. The value must be serializable, so cannot contain
 things like functions, circular data structures, class instances etc.
@@ -55,21 +51,17 @@ Optionally a "time to live" (ttl) can be specified, which means that the key wil
 be considered stale after that many milliseconds.
 ### delete
 
-<MemberInfo kind="method" type={`(key: string) => Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(key: string) => Promise<void>`}   />
 
 Deletes an item from the cache.
 ### invalidateTags
 
-<MemberInfo kind="method" type={`(tags: string[]) => Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(tags: string[]) => Promise<void>`}   />
 
 Deletes all items from the cache which contain at least one matching tag.
 
 
 </div>
-
-
-## SetCacheKeyOptions
-
 <GenerationInfo sourceFile="packages/core/src/config/system/cache-strategy.ts" sourceLine="13" packageName="@vendure/core" since="3.1.0" />
 
 Options available when setting the value in the cache.

package/docs/reference/typescript-api/cache/default-cache-plugin.mdx

@@ -2,17 +2,13 @@
 title: "DefaultCachePlugin"
 generated: true
 ---
-
-
-## DefaultCachePlugin
-
 <GenerationInfo sourceFile="packages/core/src/plugin/default-cache-plugin/default-cache-plugin.ts" sourceLine="48" packageName="@vendure/core" since="3.1.0" />
 
-This plugin provides a simple SQL-based cache strategy <a href='/reference/typescript-api/cache/sql-cache-strategy#sqlcachestrategy'>SqlCacheStrategy</a> which stores cached
+This plugin provides a simple SQL-based cache strategy <DocsLink href="/reference/typescript-api/cache/sql-cache-strategy#sqlcachestrategy">SqlCacheStrategy</DocsLink> which stores cached
 items in the database.
 
 It is suitable for production use (including multi-instance setups). For increased performance
-you can also consider using the <a href='/reference/typescript-api/cache/redis-cache-plugin#rediscacheplugin'>RedisCachePlugin</a>.
+you can also consider using the <DocsLink href="/reference/typescript-api/cache/redis-cache-plugin#rediscacheplugin">RedisCachePlugin</DocsLink>.
 
 ```ts title="Signature"
 class DefaultCachePlugin {
@@ -38,13 +34,9 @@ class DefaultCachePlugin {
 
 
 </div>
-
-
-## DefaultCachePluginInitOptions
-
 <GenerationInfo sourceFile="packages/core/src/plugin/default-cache-plugin/default-cache-plugin.ts" sourceLine="18" packageName="@vendure/core" since="3.1.0" />
 
-Configuration options for the <a href='/reference/typescript-api/cache/default-cache-plugin#defaultcacheplugin'>DefaultCachePlugin</a>.
+Configuration options for the <DocsLink href="/reference/typescript-api/cache/default-cache-plugin#defaultcacheplugin">DefaultCachePlugin</DocsLink>.
 
 ```ts title="Signature"
 interface DefaultCachePluginInitOptions {