idmp

分类: 数据库与数据存储 | 上传者: ha0z1 | 下载: 0 | 版本: v1.0（最新）

当您需要删除并发或重复的异步调用的重复数据、防止重复的 API 请求、缓存异步函数结果、使用指数退避添加自动重试、记住 Promise 中包装的繁重计算、替换 SWR/Provider 进行请求共享、使用刷新使缓存无效或将缓存数据持久保存到 localStorage、sessionStorage、node-fs 或 redis 时，请使用。涵盖浏览器、React 和 Node.js 项目中 idmp 的安装、使用和插件代码生成。

更新日志: Source: GitHub https://github.com/ha0z1/idmp

目录结构

当前层级: tree/main/.github/skills/idmp/

📄 SKILL.md 3.5 KB

SKILL.md

---
name: idmp
description: 'Use when you need to deduplicate concurrent or repeated async calls, prevent duplicate API requests, cache async function results, add automatic retry with exponential backoff, memoize heavy computation wrapped in Promise, replace SWR/Provider for request sharing, invalidate cache with flush, or persist cached data to localStorage, sessionStorage, node-fs, or redis. Covers install, usage, and plugin code generation for idmp in browser, React, and Node.js projects.'
---

# idmp

Use this skill whenever the task involves:

- Deduplicating concurrent or repeated async/network requests
- Preventing duplicate API calls across components or modules
- Caching async function results with a TTL (`maxAge`)
- Memoizing expensive computation wrapped in a Promise
- Adding automatic retry with exponential backoff on failure
- Replacing SWR, Provider, or Redux for simple data sharing
- Invalidating cache after mutations (`flush` / `flushAll`)
- Persisting cached data to localStorage, sessionStorage, file system, or Redis
- Installing `idmp` or any of its official plugins

## Installation

Install the main package:

```bash
npm install idmp
```

Or use any other package manager: `pnpm add idmp` / `yarn add idmp` / `bun add idmp`.

The official plugin entry points are exported from the same package:

- `idmp/browser-storage`
- `idmp/node-fs`
- `idmp/redis`

## Core Pattern

Wrap the original async function with a stable deduplication key.

```typescript
import idmp from 'idmp'

const fetchUser = async (userId: string) => {
  const response = await fetch(`/api/users/${userId}`)
  return await response.json()
}

export const fetchUserIdmp = (userId: string) =>
  idmp(`/api/users/${userId}`, () => fetchUser(userId))
```

## Options To Reach For

- `maxAge`: keep resolved data for a period of time (default 3000ms, max 7 days)
- `maxRetry`: retry transient failures automatically (default 30)
- `minRetryDelay`: minimum retry backoff in ms (default 50)
- `maxRetryDelay`: maximum retry backoff in ms (default 5000)
- `signal`: pass an `AbortSignal` to cancel all pending calls sharing this key
- `onBeforeRetry`: log or monitor retry attempts

```typescript
const controller = new AbortController()

const fetchUserIdmp = (userId: string) =>
  idmp(`/api/users/${userId}`, () => fetchUser(userId), {
    maxAge: 5_000,
    maxRetry: 5,
    signal: controller.signal,
  })

// Abort all pending calls for this key
controller.abort('user navigated away')
```

## Cache Invalidation

Use the same key when invalidating cache:

```typescript
idmp.flush(`/api/users/${userId}`)
idmp.flushAll()
```

## Official Plugins

Browser storage:

```typescript
import idmp from 'idmp'
import storageWrap from 'idmp/browser-storage'

const storageIdmp = storageWrap(idmp, 'localStorage')
```

Node file system:

```typescript
import idmp from 'idmp'
import fsWrap from 'idmp/node-fs'

const fsIdmp = fsWrap(idmp, 'your-project-namespace')
```

Redis:

```typescript
import idmp from 'idmp'
import redisWrap from 'idmp/redis'

const redisIdmp = redisWrap(idmp, 'your-project-namespace', {
  url: 'redis://localhost:6379',
})
```

## Guidance

- Prefer deterministic string keys that reflect the real request identity.
- When a function accepts parameters, build the key from those parameters.
- Preserve the original function return type by forwarding arguments into the wrapped function.
- Use `flush` after mutations when the next read must bypass cache.
- Use browser storage for frontend persistence, `node-fs` for local Node.js persistence, and `redis` for shared server-side persistence.

登录后下载/点赞/收藏 ❤ 41 | ★ 0

idmp

目录结构

SKILL.md

举报内容

提示