first

.dockerignore

+# compiled output
+/dist
+/node_modules
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# OS
+.DS_Store
+
+# Tests
+/coverage
+/.nyc_output
+
+# IDEs and editors
+/.idea
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.sublime-workspace
+
+# IDE - VSCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+/data
+/output
+/config.yaml
+
+.git*
+Dockerfile
+.dockerignore
+/tests

.eslintignore

+webpack.config.js
+dist/*
+build/*
+*.js

.eslintrc.js

+module.exports = {
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: 'tsconfig.json',
+    sourceType: 'module',
+  },
+  plugins: ['@typescript-eslint/eslint-plugin'],
+  extends: [
+    'plugin:@typescript-eslint/recommended',
+    'plugin:prettier/recommended',
+  ],
+  root: true,
+  env: {
+    node: true,
+    jest: true,
+  },
+  ignorePatterns: ['.eslintrc.js'],
+  rules: {
+    '@typescript-eslint/interface-name-prefix': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+  },
+};

.gitignore

+# compiled output
+/dist
+/node_modules
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# OS
+.DS_Store
+
+# Tests
+/coverage
+/.nyc_output
+
+# IDEs and editors
+/.idea
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.sublime-workspace
+
+# IDE - VSCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+/data
+/output
+/config.yaml

.gitlab-ci.docker.yml

+stages:
+  - build
+  - combine
+  - deploy
+variables:
+  GIT_DEPTH: "1"
+  CONTAINER_TEST_IMAGE: $CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG
+  CONTAINER_TEST_ARM_IMAGE: $CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG-arm
+  CONTAINER_TEST_X86_IMAGE: $CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG-x86
+  CONTAINER_RELEASE_IMAGE: $CI_REGISTRY_IMAGE:latest
+before_script:
+  - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+build-x86:
+  stage: build
+  tags:
+    - docker
+  script:
+    - TARGET_IMAGE=$CONTAINER_TEST_X86_IMAGE
+    - docker build --pull -t $TARGET_IMAGE .
+    - docker push $TARGET_IMAGE
+build-arm:
+  stage: build
+  tags:
+    - docker-arm
+  script:
+    - TARGET_IMAGE=$CONTAINER_TEST_ARM_IMAGE
+    - docker build --pull -t $TARGET_IMAGE .
+    - docker push $TARGET_IMAGE
+combine:
+  stage: combine
+  tags:
+    - docker
+  script:
+    - TARGET_IMAGE=$CONTAINER_TEST_IMAGE
+    - SOURCE_IMAGE_2=$CONTAINER_TEST_ARM_IMAGE
+    - SOURCE_IMAGE_1=$CONTAINER_TEST_X86_IMAGE
+    - docker pull $SOURCE_IMAGE_1
+    - docker pull $SOURCE_IMAGE_2
+    - docker manifest create $TARGET_IMAGE --amend $SOURCE_IMAGE_1 --amend
+      $SOURCE_IMAGE_2
+    - docker manifest push $TARGET_IMAGE
+deploy_latest:
+  stage: deploy
+  tags:
+    - docker
+  script:
+    - TARGET_IMAGE=$CONTAINER_RELEASE_IMAGE
+    - SOURCE_IMAGE=$CONTAINER_TEST_IMAGE
+    - docker pull $SOURCE_IMAGE
+    - docker tag $SOURCE_IMAGE $TARGET_IMAGE
+    - docker push $TARGET_IMAGE
+  only:
+    - master
+deploy_tag:
+  stage: deploy
+  tags:
+    - docker
+  script:
+    - TARGET_IMAGE=$CI_REGISTRY_IMAGE:$CI_COMMIT_TAG
+    - SOURCE_IMAGE=$CONTAINER_TEST_IMAGE
+    - docker pull $SOURCE_IMAGE
+    - docker tag $SOURCE_IMAGE $TARGET_IMAGE
+    - docker push $TARGET_IMAGE
+  only:
+    - tags

.gitlab-ci.upload.yml

+stages:
+  - install
+  - build
+  - deploy
+
+variables:
+  GIT_DEPTH: "1"
+
+npm_ci:
+  stage: install
+  tags:
+    - linux
+  script:
+    - npm ci
+  artifacts:
+    paths:
+      - node_modules
+
+.build_base:
+  stage: build
+  tags:
+    - linux
+  dependencies:
+    - npm_ci
+
+build:
+  extends: .build_base
+  script: npm run build
+  artifacts:
+    paths:
+      - dist/
+
+upload_to_minio:
+  stage: deploy
+  dependencies:
+    - build
+  tags:
+    - linux
+  script:
+    - aws s3 --endpoint=https://minio.momobako.com:9000 sync --delete dist/ s3://nanahira/path
+  only:
+    - master

.gitlab-ci.yml

+stages:
+  - install
+  - build
+  - deploy
+
+variables:
+  GIT_DEPTH: "1"
+
+npm_ci:
+  stage: install
+  tags:
+    - linux
+  script:
+    - npm ci
+  artifacts:
+    paths:
+      - node_modules
+
+.build_base:
+  stage: build
+  tags:
+    - linux
+  dependencies:
+    - npm_ci
+
+build:
+  extends:
+    - .build_base
+  script:
+    - npm run build
+  artifacts:
+    paths:
+      - dist/
+
+unit-test:
+  extends:
+    - .build_base
+  script:
+    - npm run test
+
+deploy_npm:
+  stage: deploy
+  dependencies:
+    - build
+  tags:
+    - linux
+  script:
+    - apt update;apt -y install coreutils
+    - echo $NPMRC | base64 --decode > ~/.npmrc
+    - npm publish . || true
+  only:
+    - master

.npmignore

+/install-npm.sh
+.git*
+/data
+/output
+/config.yaml
+.idea
+.dockerignore
+Dockerfile
+/src
+/coverage
+/tests
+/dist/tests

.prettierrc

+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}
\ No newline at end of file

Dockerfile

+FROM node:lts-bullseye-slim as base
+LABEL Author="Nanahira <nanahira@momobako.com>"
+
+RUN apt update && apt -y install python3 build-essential && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* /var/log/*
+WORKDIR /usr/src/app
+COPY ./package*.json ./
+
+FROM base as builder
+RUN npm ci && npm cache clean --force
+COPY . ./
+RUN npm run build
+
+FROM base
+ENV NODE_ENV production
+RUN npm ci && npm cache clean --force
+COPY --from=builder /usr/src/app/dist ./dist
+
+CMD [ "npm", "start" ]

LICENSE

+The MIT License (MIT)
+
+Copyright (c) 2021 Nanahira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

install-npm.sh

+#!/bin/bash
+
+npm install --save-dev \
+	@types/node \
+	typescript \
+	'@typescript-eslint/eslint-plugin@^4.28.2' \
+	'@typescript-eslint/parser@^4.28.2 '\
+	'eslint@^7.30.0' \
+	'eslint-config-prettier@^8.3.0' \
+	'eslint-plugin-prettier@^3.4.0' \
+	prettier \
+	jest \
+	@types/jest \
+	ts-jest \
+	rimraf

package.json

+{
+  "name": "myproject",
+  "description": "myproject-desc",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "lint": "eslint --fix .",
+    "build": "rimraf dist && tsc",
+    "test": "jest --passWithNoTests",
+    "start": "node dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://code.mycard.moe/3rdeye/myproject.git"
+  },
+  "author": "Nanahira <nanahira@momobako.com>",
+  "license": "MIT",
+  "keywords": [],
+  "bugs": {
+    "url": "https://code.mycard.moe/3rdeye/myproject/issues"
+  },
+  "homepage": "https://code.mycard.moe/3rdeye/myproject",
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "tests",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  },
+  "devDependencies": {
+    "@types/jest": "^28.1.6",
+    "@types/node": "^18.6.0",
+    "@typescript-eslint/eslint-plugin": "^4.33.0",
+    "@typescript-eslint/parser": "^4.33.0",
+    "eslint": "^7.32.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-plugin-prettier": "^3.4.1",
+    "jest": "^28.1.3",
+    "prettier": "^2.7.1",
+    "rimraf": "^3.0.2",
+    "ts-jest": "^28.0.7",
+    "typescript": "^4.7.4"
+  },
+  "dependencies": {
+    "better-lock": "^2.0.3",
+    "class-transformer": "^0.5.1",
+    "cosmokit": "^1.2.1",
+    "encoded-buffer": "^0.2.6",
+    "ioredis": "^5.2.2",
+    "lru-cache": "^7.13.1",
+    "redlock": "^5.0.0-beta.2",
+    "typed-reflector": "^1.0.11"
+  }
+}

src/aragami.ts

+import { BaseDriver } from './base-driver';
+import { AnyClass, AragamiOptions, ClassType } from './def';
+import { RedisDriver } from './drivers/redis';
+import { MemoryDriver } from './drivers/memory';
+import { reflector } from './metadata';
+import { instanceToPlain, plainToInstance } from 'class-transformer';
+import { encode, decode } from 'encoded-buffer';
+import { Awaitable } from 'cosmokit';
+import { makeArray, MayBeArray } from './utility/utility';
+
+export class Aragami {
+  readonly driver: BaseDriver;
+
+  constructor(private options: AragamiOptions = {}) {
+    this.driver = options.redis
+      ? new RedisDriver(options.redis)
+      : new MemoryDriver();
+  }
+
+  private getBaseKey(o: string | any): string {
+    if (typeof o === 'string') {
+      return o;
+    }
+    const keyFromMetadata = reflector.get('AragamiCachePrefix', o);
+    if (keyFromMetadata) {
+      return keyFromMetadata;
+    }
+    const keyFromConstructor =
+      typeof o === 'function' ? o.name : o.constructor?.name;
+    if (keyFromConstructor) {
+      return keyFromConstructor;
+    }
+    return 'default';
+  }
+
+  private async getKey(o: any) {
+    if (typeof o === 'string') {
+      return o;
+    }
+    const keyTransformer = reflector.get('AragamiCacheKey', o);
+    return keyTransformer ? await keyTransformer(o) : '';
+  }
+
+  private getTTL(o: any) {
+    return (
+      reflector.get('AragamiCacheTTL', o) || this.options.defaultTTL || 1000
+    );
+  }
+
+  private encode(o: any) {
+    return encode(instanceToPlain(o));
+  }
+
+  private decode<T>(cl: ClassType<T>, value: Buffer) {
+    return plainToInstance(cl, decode(value)[0]);
+  }
+
+  async get<T>(cl: ClassType<T>, key: string) {
+    const value = await this.driver.get(this.getBaseKey(cl), key);
+    if (!value) {
+      return;
+    }
+    return this.decode(cl, value);
+  }
+
+  async set<T>(
+    o: T,
+    options: { ttl?: number; key?: string; prototype?: AnyClass } = {},
+  ) {
+    if (!o) {
+      return o;
+    }
+    const buf = this.encode(o);
+    await this.driver.set(
+      this.getBaseKey(options.prototype || o),
+      options.key || (await this.getKey(o)),
+      buf,
+      options.ttl || this.getTTL(options.prototype || o),
+    );
+    return o;
+  }
+
+  async has(base: AnyClass | string, key: string): Promise<boolean>;
+  async has(base: any): Promise<boolean>;
+  async has(base: any, key?: string) {
+    return this.driver.has(
+      this.getBaseKey(base),
+      key || (await this.getKey(base)),
+    );
+  }
+
+  async del(base: AnyClass | string, key: string): Promise<boolean>;
+  async del(base: any): Promise<boolean>;
+  async del(base: any, key?: string) {
+    return this.driver.del(
+      this.getBaseKey(base),
+      key || (await this.getKey(base)),
+    );
+  }
+
+  async clear(base: AnyClass | string) {
+    return this.driver.clear(this.getBaseKey(base));
+  }
+
+  async keys(base: AnyClass | string) {
+    return this.driver.keys(this.getBaseKey(base));
+  }
+
+  async values<T>(cl: ClassType<T>) {
+    const buffers = await this.driver.values(this.getBaseKey(cl));
+    return buffers.map((buf) => this.decode(cl, buf));
+  }
+
+  async entries<T>(cl: ClassType<T>): Promise<[string, T][]> {
+    const entries = await this.driver.entries(this.getBaseKey(cl));
+    return entries.map(([key, buf]) => [key, this.decode(cl, buf)]);
+  }
+
+  wrap<T, A extends any[]>(
+    cl: ClassType<T>,
+    cb: (...args: A) => T | Promise<T>,
+    keySource: (...args: A) => Awaitable<string | T>,
+  ) {
+    return async (...args: A): Promise<T> => {
+      const keyMeta = await keySource(...args);
+      const key = await this.getKey(keyMeta);
+      const cachedValue = await this.get(cl, key);
+      if (cachedValue) {
+        return cachedValue;
+      }
+      const value = await cb(...args);
+      if (value) {
+        await this.set(value, { key, prototype: cl });
+      }
+      return value;
+    };
+  }
+
+  private async getLockKeys(o: any) {
+    if (typeof o === 'string') {
+      return [o];
+    }
+    const baseKey = this.getBaseKey(o);
+    const keyTransformers = reflector.getArray('AragamiLockKeys', o);
+    return Promise.all(
+      keyTransformers.map(
+        async (keyTransformer) => `${baseKey}:${await keyTransformer(o)}`,
+      ),
+    );
+  }
+
+  lock<A extends any[], R>(
+    cb: (...args: A) => R,
+    keySource: (...args: A) => Awaitable<MayBeArray<string | any>>,
+  ) {
+    return async (...args: A): Promise<Awaited<R>> => {
+      const keyMeta = makeArray(await keySource(...args));
+      const keys = (
+        await Promise.all(keyMeta.map((o) => this.getLockKeys(o)))
+      ).flat();
+      if (!keys.length) {
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        return cb(...args);
+      }
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore
+      return this.driver.lock(keys, async () => await cb(...args));
+    };
+  }
+}

src/base-driver.ts

+export class BaseDriver {
+  protected usingKey(baseKey: string, key: string): string {
+    return `${baseKey}:${key}`;
+  }
+
+  async get(baseKey: string, key: string): Promise<Buffer> {
+    return;
+  }
+
+  async has(baseKey: string, key: string): Promise<boolean> {
+    return !!(await this.get(baseKey, key));
+  }
+
+  async set(
+    baseKey: string,
+    key: string,
+    value: Buffer,
+    ttl: number,
+  ): Promise<void> {}
+
+  async del(baseKey: string, key: string): Promise<boolean> {
+    return false;
+  }
+
+  async keys(baseKey: string): Promise<string[]> {
+    return [];
+  }
+
+  async values(baseKey: string): Promise<Buffer[]> {
+    const keys = await this.keys(baseKey);
+    return Promise.all(keys.map((key) => this.get(baseKey, key)));
+  }
+
+  async entries(baseKey: string): Promise<[string, Buffer][]> {
+    const keys = await this.keys(baseKey);
+    return Promise.all(
+      keys.map(async (key) => [key, await this.get(baseKey, key)]),
+    );
+  }
+
+  async clear(baseKey: string) {
+    const keys = await this.keys(baseKey);
+    await Promise.all(keys.map((key) => this.del(baseKey, key)));
+  }
+
+  lock<R>(keys: string[], cb: () => Promise<R>) {
+    return cb();
+  }
+}

src/decorators.ts

+import { Metadata } from './metadata';
+import { Awaitable } from 'cosmokit';
+import { TypedMethodDecorator } from './def';
+
+export const CacheTTL = (ttl: number): ClassDecorator =>
+  Metadata.set('AragamiCacheTTL', ttl);
+
+export const CachePrefix = (prefix: string): ClassDecorator =>
+  Metadata.set('AragamiCachePrefix', prefix);
+
+type ObjectKeyFunction = (o: any) => Awaitable<string>;
+
+const DrainKey =
+  (decoratorFactory: (cb: ObjectKeyFunction) => ClassDecorator) =>
+  (
+    fun: ObjectKeyFunction = (obj) => obj.toString(),
+  ): PropertyDecorator & TypedMethodDecorator<ObjectKeyFunction> =>
+  (obj, key, des?) => {
+    let cb: ObjectKeyFunction;
+    if (des) {
+      // method decorator
+      cb = async (o) => fun(await o[key]());
+    } else {
+      // property decorator
+      cb = (o) => fun(o[key]);
+    }
+    return decoratorFactory(cb)(obj.constructor);
+  };
+
+export const CacheKey = DrainKey((cb) => Metadata.set('AragamiCacheKey', cb));
+export const LockKey = DrainKey((cb) => Metadata.append('AragamiLockKeys', cb));

src/def.ts

+import { RedisOptions } from 'ioredis';
+import { Settings } from 'redlock';
+
+export type RedisDriverOptions = RedisOptions & {
+  uri?: string;
+  lock?: Settings & { duration?: number; prefix?: string };
+};
+
+export interface AragamiOptions {
+  redis?: RedisDriverOptions;
+  defaultTTL?: number;
+}
+
+// eslint-disable-next-line @typescript-eslint/ban-types
+export type TypedMethodDecorator<F extends Function> = <T extends F>(
+  // eslint-disable-next-line @typescript-eslint/ban-types
+  target: Object,
+  propertyKey: string | symbol,
+  descriptor: TypedPropertyDescriptor<T>,
+) => TypedPropertyDescriptor<T> | void;
+
+export type AnyClass = new (...args: any[]) => any;
+export type ClassType<T> = new (...args: any[]) => T;

src/drivers/memory.ts

+import LRUCache from 'lru-cache';
+import { BaseDriver } from '../base-driver';
+import BetterLock from 'better-lock';
+
+export class MemoryDriver extends BaseDriver {
+  private cacheMap = new Map<string, LRUCache<string, Buffer>>();
+  private betterLock = new BetterLock();
+
+  private getCacheInstance(baseKey: string) {
+    if (!this.cacheMap.has(baseKey)) {
+      this.cacheMap.set(
+        baseKey,
+        new LRUCache({
+          ttl: 1000,
+          updateAgeOnGet: false,
+          updateAgeOnHas: false,
+        }),
+      );
+    }
+    return this.cacheMap.get(baseKey);
+  }
+
+  override async get(baseKey: string, key: string): Promise<Buffer> {
+    const cache = this.getCacheInstance(baseKey);
+    return cache.get(key);
+  }
+
+  override async set(
+    baseKey: string,
+    key: string,
+    value: Buffer,
+    ttl: number,
+  ): Promise<void> {
+    const cache = this.getCacheInstance(baseKey);
+    cache.set(key, value, { ttl });
+  }
+
+  override async del(baseKey: string, key: string): Promise<boolean> {
+    const cache = this.getCacheInstance(baseKey);
+    return cache.delete(key);
+  }
+
+  override async keys(baseKey: string): Promise<string[]> {
+    const cache = this.getCacheInstance(baseKey);
+    return Array.from(cache.keys());
+  }
+
+  override async clear(baseKey: string): Promise<void> {
+    const cache = this.getCacheInstance(baseKey);
+    cache.clear();
+  }
+
+  override lock<R>(keys: string[], cb: () => Promise<R>): Promise<R> {
+    return this.betterLock.acquire(keys, cb);
+  }
+}

src/drivers/redis.ts

+import { BaseDriver } from '../base-driver';
+import Redis from 'ioredis';
+import Redlock from 'redlock';
+import { RedisDriverOptions } from '../def';
+
+export class RedisDriver extends BaseDriver {
+  private readonly redis: Redis;
+  private readonly redlock: Redlock;
+  constructor(private options: RedisDriverOptions) {
+    super();
+    if (options.uri) {
+      this.redis = new Redis(options.uri);
+    } else {
+      this.redis = new Redis(options);
+    }
+    this.redlock = new Redlock([this.redis], options.lock);
+  }
+
+  override async get(baseKey: string, key: string): Promise<Buffer> {
+    return this.redis.getBuffer(this.usingKey(baseKey, key));
+  }
+
+  override async set(
+    baseKey: string,
+    key: string,
+    value: Buffer,
+    ttl: number,
+  ): Promise<void> {
+    await this.redis.set(this.usingKey(baseKey, key), value, 'PX', ttl);
+  }
+
+  override async del(baseKey: string, key: string): Promise<boolean> {
+    return !!this.redis.del(this.usingKey(baseKey, key));
+  }
+
+  private originalKeys(baseKey: string) {
+    return this.redis.keys(this.usingKey(baseKey, '*'));
+  }
+
+  override async keys(baseKey: string): Promise<string[]> {
+    const keys = await this.originalKeys(baseKey);
+    return keys.map((key) => key.slice(baseKey.length + 1));
+  }
+
+  override async clear(baseKey: string): Promise<void> {
+    const keys = await this.originalKeys(baseKey);
+    if (!keys.length) {
+      return;
+    }
+    await this.redis.del(keys);
+  }
+
+  override lock<R>(keys: string[], cb: () => Promise<R>): Promise<R> {
+    return this.redlock.using(
+      keys.map((key) => `${this.options.lock?.prefix || '_lock'}:${key}`),
+      this.options.lock?.duration || 5000,
+      cb,
+    );
+  }
+}

src/metadata.ts

+import { Awaitable } from 'cosmokit';
+import { MetadataSetter, Reflector } from 'typed-reflector';
+
+export class MetadataMap {
+  AragamiCacheTTL: number;
+  AragamiCachePrefix: string;
+  AragamiCacheKey: (obj: any) => Awaitable<string>;
+}
+
+export class MetadataArrayMap {
+  AragamiLockKeys: (obj: any) => Awaitable<string>;
+}
+
+export const Metadata = new MetadataSetter<MetadataMap, MetadataArrayMap>();
+export const reflector = new Reflector<MetadataMap, MetadataArrayMap>();

src/utility/utility.ts

+export type MayBeArray<T> = T | T[];
+export function makeArray<T>(o: MayBeArray<T>): T[] {
+  return Array.isArray(o) ? o : [o];
+}

tests/sample.spec.ts

+import { Aragami } from '../src/aragami';
+import { CacheKey, CachePrefix, CacheTTL } from '../src/decorators';
+
+describe('Aragami.', () => {
+  let aragami: Aragami;
+
+  beforeEach(() => {
+    aragami = new Aragami({
+      redis: { uri: 'redis://localhost:6379' },
+    });
+  });
+
+  it('Should store value', async () => {
+    @CachePrefix('user')
+    @CacheTTL(100)
+    class User {
+      name: string;
+      age: number;
+
+      @CacheKey()
+      async getName() {
+        return `n.${this.name}`;
+      }
+    }
+
+    const user = new User();
+    await aragami.clear(User);
+    user.name = 'John';
+    user.age = 30;
+    const userSet = await aragami.set(user);
+    expect(userSet).toEqual(user);
+    await expect(aragami.has(user)).resolves.toBeTruthy();
+    await expect(aragami.has(User, 'n.John')).resolves.toBeTruthy();
+    await expect(aragami.has('user', 'n.John')).resolves.toBeTruthy();
+    const userGet = await aragami.get(User, 'n.John');
+    expect(userGet).toEqual({ name: 'John', age: 30 });
+    expect(userGet).toBeInstanceOf(User);
+    await expect(aragami.keys(User)).resolves.toEqual(['n.John']);
+    await expect(aragami.values(User)).resolves.toEqual([
+      { name: 'John', age: 30 },
+    ]);
+    await expect(aragami.entries(User)).resolves.toEqual([
+      ['n.John', { name: 'John', age: 30 }],
+    ]);
+    await expect(aragami.del(User, 'n.John')).resolves.toBeTruthy();
+    await expect(aragami.has(user)).resolves.toBeFalsy();
+
+    const wrapped = aragami.wrap(
+      User,
+      (name: string, age: number) => {
+        const user = new User();
+        user.name = name;
+        user.age = age;
+        console.log('new', user);
+        return user;
+      },
+      (name) => name,
+    );
+    await expect(wrapped('John', 30)).resolves.toBeInstanceOf(User);
+    await expect(wrapped('John', 30)).resolves.toBeInstanceOf(User);
+  });
+
+  it('should expire', async () => {
+    @CacheTTL(100)
+    class Dress {
+      @CacheKey()
+      name: string;
+    }
+
+    const dress = new Dress();
+    await aragami.clear(Dress);
+    dress.name = 'Yuzu';
+    await aragami.set(dress);
+    await expect(aragami.has(dress)).resolves.toBeTruthy();
+    await new Promise((resolve) => setTimeout(resolve, 101));
+    await expect(aragami.has(dress)).resolves.toBeFalsy();
+  });
+
+  it('should lock', async () => {
+    const fun = aragami.lock(
+      async (foo: string, bar: string) => {
+        await new Promise((resolve) => setTimeout(resolve, 1000));
+        return `${foo}.${bar}`;
+      },
+      (foo, bar) => [foo, bar],
+    );
+    await expect(fun('foo', 'bar')).resolves.toEqual('foo.bar');
+  });
+});

tsconfig.json

+{
+	"compilerOptions": {
+		"outDir": "dist",
+		"module": "commonjs",
+		"target": "es2021",
+		"esModuleInterop": true,
+		"emitDecoratorMetadata": true,
+		"experimentalDecorators": true,
+		"declaration": true,
+		"sourceMap": true
+	},
+	"compileOnSave": true,
+	"allowJs": true,
+	"include": [
+		"*.ts",
+		"src/**/*.ts",
+		"test/**/*.ts",
+		"tests/**/*.ts"
+	]
+}