feat: add expire method

[Julien-R44]

add a new expire method

this method is slightly different from delete:

• when we delete a key, it is completely removed and forgotten. This means that even if we use grace periods, the value will no longer be available.
• expire works like delete, except that instead of completely removing the value, we just mark it as expired but keep it for the grace period. For example:

// Set a value with a grace period of 6 minutes
await cache.set({ 
  key: 'hello',
  value: 'world',
  grace: '6m'
})

// Expire the value. It is kept in the cache but marked as STALE for 6 minutes
await cache.expire({ key: 'hello' })

// Here, a get with grace: false will return nothing, because the value is stale
const r1 = await cache.get({ key: 'hello', grace: false })

// Here, a get with grace: true will return the value, because it is still within the grace period
const r2 = await cache.get({ key: 'hello' })

assert.deepEqual(r1, undefined)
assert.deepEqual(r2, 'world')

[changeset-bot]

🦋 Changeset detected

Latest commit: 5e88efe

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
bentocache	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[dunhamjared]

Ooooo this is awesome!