cache-manager - add named return type to createCache

[PoOwAa]

Please check if the PR fulfills these requirements

• Followed the Contributing guidelines.
• Tests for the changes have been added (for bug fixes/features) with 100% code coverage.
• Docs have been added / updated (for bug fixes / features)

What kind of change does this PR introduce? (Bug fix, feature, docs update, ...)
Solves #923

This PR introduces a named return type, Cache, for the createCache() method. This type explicitly defines the structure of the cache instance, enabling:
Improved type inference and autocomplete in TypeScript.
Easier integration with frameworks like NestJS by allowing direct reference to the Cache type.
Stronger type guarantees, ensuring compatibility with future updates.

Does this PR introduce a breaking change?
No. The changes are fully backward compatible. The new type definition is an explicit representation of the existing inferred type, so no runtime behavior is affected.

Code example

import { Cache, createCache } from 'cache-manager';

const cache: Cache = createCache();

cache.set('key', 'value', 60).then(() => {
  cache.get<string>('key').then((value) => {
    console.log(value); // Outputs: 'value'
  });
});

[jaredwray]

@PoOwAa thanks so much for the pull request!

[jaredwray]

@PoOwAa - I should have this released in the next week or so. Will that work?

[PoOwAa]

@PoOwAa - I should have this released in the next week or so. Will that work?

Perfect, thanks for the quick reply!