https://github.com/alenap93/kysely-cache

Cache layer for kysely
https://github.com/alenap93/kysely-cache

Last synced: 29 days ago
JSON representation

Cache layer for kysely

• Host: GitHub
• URL: https://github.com/alenap93/kysely-cache
• Owner: alenap93
• License: mit
• Created: 2025-01-17T12:15:07.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2025-01-18T14:32:06.000Z (about 1 month ago)
• Last Synced: 2025-01-18T15:33:01.378Z (about 1 month ago)
• Language: TypeScript
• Homepage:
• Size: 16.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-kysely - kysely-cache - Cache layer for [Kysely](https://kysely.dev).    (Addons)

README

        

# kysely-cache

[![CI](https://github.com/alenap93/kysely-cache/actions/workflows/ci.yml/badge.svg)](https://github.com/alenap93/kysely-cache/actions/workflows/ci.yml)

[![NPM version](https://img.shields.io/npm/v/kysely-cache.svg?style=flat)](https://www.npmjs.com/package/kysely-cache)

[![NPM downloads](https://img.shields.io/npm/dm/kysely-cache.svg?style=flat)](https://www.npmjs.com/package/kysely-cache)

[![js-prettier-style](https://img.shields.io/badge/code%20style-prettier-brightgreen.svg?style=flat)](https://prettier.io/)

Kysely Cache plugin; with this plugin you can cache a query and make next queries faster, that will not go directly to the database, but will be getted from the cache.

This plugin has two different implementation **KyselyLRUSQLCache** and **KyselyLRUCache**.

## Install

```

npm i kysely kysely-cache

```

## Usage

### KyselyLRUSQLCache

**Description**

This cache stores data inside a DB (sqlite, mysql or postgres) and sets a cached query (and results) lifetime (ttl) and a maximum number of queries (and elements)

**Options**

- max:  *max number of items (query results) in cache, default 50*

- ttl:  *time to live (milliseconds), default: 60000*

- dialect:  *Kysely Dialect, default: SQLite Dialect with in memory DB*

- queryCompiler:  *sqlite, mysql or postgres, default: sqlite*

**Api**

- clear(): *clear the cache, return: Promise\*

- destroy(): *clear the cache and release all resources and disconnects from the cache database, return: Promise\*

- createCache(opts): *create the cache, return: Promise\\>*

- execute(queryBuilder: SelectQueryBuilder): *execute the query or return data from the cache as a list of items*

- executeTakeFirst(queryBuilder: SelectQueryBuilder): *execute the query or return data from the cache, it return only the first element*

- executeTakeFirstOrThrow(queryBuilder: SelectQueryBuilder, errorConstructor:  NoResultErrorConstructor): *execute the query or return data from the cache, it return only the first element, if no element will be found, it will throw an error*

**How to use**

    const sqliteDialect = new SqliteDialect({ database: new Database(':memory:')})

    

    const kyselyInstance = new Kysely({ dialect:  sqliteDialect })

    

    await kyselyInstance.schema

    .createTable('person')

    .addColumn('id', 'integer', (col) => col.primaryKey())

    .addColumn('first_name', 'varchar(255)')

    .addColumn('last_name', 'varchar(255)')

    .addColumn('gender', 'varchar(255)')

    .execute()

    

    await kyselyInstance

    .insertInto('person')

    .values({

    first_name: 'Max',

    last_name: 'Jack',

    gender: 'man',

    })

    .execute()

    

    const kyselyLRUSQLCacheInstance = await KyselyLRUSQLCache.createCache(opt.config)

    

    const queryBuilderSelectFrom = kyselyInstance

    .selectFrom('person')

    .selectAll()

    

    const people = await kyselyLRUSQLCacheInstance.execute(queryBuilderSelectFrom)

### KyselyLRUCache

**Description**

This cache keeps data in memory (inside an object) and sets a cache query (and results) lifetime (ttl) and a maximum number of queries (and elements)

**Options**

- max:  *max number of items (query results) in cache, default 50*

- ttl:  *time to live (milliseconds), default: 60000*

**Api**

- clear(): *clear the cache, return: void*

- createCache(opts): *create the cache, return: KyselyLRUCache\*

- execute(queryBuilder: SelectQueryBuilder): *execute the query or return data from the cache as a list of items*

- executeTakeFirst(queryBuilder: SelectQueryBuilder): *execute the query or return data from the cache, it return only the first element*

- executeTakeFirstOrThrow(queryBuilder: SelectQueryBuilder, errorConstructor:  NoResultErrorConstructor): *execute the query or return data from the cache, it return only the first element, if no element will be found, it will throw an error*

**How to use**

    const sqliteDialect = new SqliteDialect( { database: new  Database(':memory:') } )

    

    const kyselyInstance = new Kysely( { dialect:  sqliteDialect } )

    

    await kyselyInstance.schema.createTable('person')

    .addColumn('id', 'integer', (col) =>  col.primaryKey())

    .addColumn('first_name', 'varchar(255)')

    .addColumn('last_name', 'varchar(255)')

    .addColumn('gender', 'varchar(255)')

    .execute()

    

    await kyselyInstance.insertInto('person').values( { first_name: 'Max', last_name: 'Jack', gender: 'man' } )

    .execute()

    

    const kyselyLRUCacheInstance = KyselyLRUCache.createCache( { max: 50, ttl: 60000 } )

    

    const kyselySelectQueryBuilderOne = kyselyInstance.selectFrom('person').selectAll()

    const persone = await KyselyLRUCacheInstance.executeTakeFirstOrThrow(kyselySelectQueryBuilderOne)

## License

Licensed under [MIT](./LICENSE).