npmpackage.info

@keyv/memcache

Simple key-value storage with support for multiple backends

2.0.1

2,675

MIT

TypeScript

16.73 kB

6,880,824 5.8

Installations

npm install @keyv/memcache

Developer Guide

BETA

Typescript

Yes

Module System

ESM

Score

95.1

Supply Chain

99.3

Quality

79.6

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

1,000

Closed

50

Merged

950

Issues

Open

0

Total

259

Closed

259

Releases

2024-12-21

Published on 21 Dec 2024

2024-12-11

Published on 12 Dec 2024

2024-12-09

Published on 09 Dec 2024

2024-11-22

Published on 22 Nov 2024

2024-11-16

Published on 16 Nov 2024

2024-11-13

Published on 13 Nov 2024

View all 66 releases

Contributors

View all 68 contributors

Languages

TypeScript

CSS

Shell

JavaScript

TypeScript (99.12%)

CSS (0.37%)

Shell (0.36%)

JavaScript (0.16%)

Developer

jaredwray

Download Statistics

Total Downloads

6,880,824

Last Day

2,945

Last Week

113,440

Last Month

404,697

Last Year

4,019,417

GitHub Statistics

2,675 Stars

1,434 Commits

152 Forks

19 Watching

2 Branches

68 Contributors

Maintainers

Package Meta Information

Latest Version

2.0.1

Package Id

@keyv/memcache@2.0.1

Unpacked Size

16.73 kB

Size

4.81 kB

File Count

Publised On

21 Aug 2024

Total Downloads

Cumulative downloads

Total Downloads

6,880,824

Last day

-14.4%

2,945

Compared to previous day

Last week

14.9%

113,440

Compared to previous week

Last month

13.5%

404,697

Compared to previous month

Last year

48%

4,019,417

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

@keyv/serialize buffer memjs

Dev Dependencies

@keyv/test-suite @types/memjs keyv ts-node tsd typescript xo

Versions

@keyv/memcache

Memcache storage adapter for Keyv

Install

1npm install --save @keyv/memcache

yarn add @keyv/memcache

Usage

1import Keyv from 'keyv';
2import KeyvMemcache from '@keyv/memcache';
3
4const memcache = new KeyvMemcache('user:pass@localhost:11211');
5const keyv = new Keyv({ store: memcache });
6
7//set 
8await keyv.set("foo","bar", 6000) //Expiring time is optional
9
10//get
11const obj = await keyv.get("foo");
12
13//delete
14await keyv.delete("foo");
15
16//clear
17await keyv.clear();
18

Usage with Namespaces

1import Keyv from 'keyv';
2import KeyvMemcache from '@keyv/memcache';
3
4const memcache = new KeyvMemcache('user:pass@localhost:11211');
5const keyv1 = new Keyv({ store: memcache, namespace: "namespace1" });
6const keyv2 = new Keyv({ store: memcache, namespace: "namespace2" });
7
8//set 
9await keyv1.set("foo","bar1", 6000) //Expiring time is optional
10await keyv2.set("foo","bar2", 6000) //Expiring time is optional
11
12//get
13const obj1 = await keyv1.get("foo"); //will return bar1
14const obj2 = await keyv2.get("foo"); //will return bar2
15

Works with Memcached, Memcachier, Redislabs, and Google Cloud

Using Memcached

Install Memcached and start an instance

1
2//set the server to the correct address and port 
3const server = "localhost:11211"
4
5const Keyv = require("keyv");
6const KeyvMemcache = require("@keyv/memcache");
7
8const memcache = new KeyvMemcache(server);
9const keyv = new Keyv({ store: memcache});

Using Memcachier

Go to https://www.memcachier.com and signup
Create a cache and setup where.
In the screen take the username, password, and url and place it into your code:

1
2//best practice is to not hard code your config in code. 
3const user = "";
4const pass = "";
5const server = "XXX.XXX.XXX.memcachier.com:11211"
6
7const Keyv = require("keyv");
8const KeyvMemcache = require("@keyv/memcache");
9
10const memcache = new KeyvMemcache(user +":"+ pass +"@"+ server);
11const keyv = new Keyv({ store: memcache});
12

Using Redislabs Memcache Protocol

Go to https://www.redislabs.com and signup
Create a database and make sure to set the Protocol to memcached
In the screen take the username, password, and endpoint (the server) and place it into your code:

1
2//best practice is to not hard code your config in code. 
3const user = "";
4const pass = "";
5const server = "XXX.XXX.XXX.XXX.cloud.redislabs.com:XXX"
6
7const Keyv = require("keyv");
8const KeyvMemcache = require("@keyv/memcache");
9
10const memcache = new KeyvMemcache(user +":"+ pass +"@"+ server);
11const keyv = new Keyv({ store: memcache});
12

Using Google Cloud

Go to https://cloud.google.com/ and sign up.
Go to the memcached configuration page in the google cloud console by navigating to Memorystore > Memcached.
On the memcached page (Eg. https://console.cloud.google.com/memorystore/memcached/instances?project=example), Click Create Instance
Fill in all mandatory fields as needed. You will need to set up a private service connection.
To set up a private service connection, click the Set Up Connection button.
Once required fields are complete, click the Create button to create the instance.
Google provides further documentation for connecting to and managing your Memecached instance here.

1import Keyv from 'keyv';
2import KeyvMemcache from '@keyv/memcache';
3
4const memcache = new KeyvMemcache("insert the internal google memcached discovery endpoint");
5const keyv = new Keyv({ store: memcache});
6

License

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Security-Policy

Determines if the project has published a security policy.

10

Maintained

Determines if the project is "actively maintained".

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

SAST

Determines if the project uses static code analysis.

2

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Fuzzing

Determines if the project uses fuzzing.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codecov.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codecov.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codecov.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codecov.yaml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/codecov.yaml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codecov.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codeql-analysis.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codeql-analysis.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codeql-analysis.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:70: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/codeql-analysis.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deploy-website.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/deploy-website.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deploy-website.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/deploy-website.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/deploy-website.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/deploy-website.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yaml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/tests.yaml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tests.yaml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/jaredwray/keyv/tests.yaml/main?enable=pin
Warn: containerImage not pinned by hash: packages/postgres/Dockerfile.ssl:1: pin your Docker image by updating postgres:latest to postgres:latest@sha256:888402a8cd6075c5dc83a31f58287f13306c318eaad016661ed12e076f3e6341
Warn: npmCommand not pinned by hash: .github/workflows/codecov.yaml:25
Warn: npmCommand not pinned by hash: .github/workflows/deploy-website.yml:30
Warn: npmCommand not pinned by hash: .github/workflows/tests.yaml:25
Info: 0 out of 10 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 2 third-party GitHubAction dependencies pinned
Info: 0 out of 1 containerImage dependencies pinned
Info: 0 out of 3 npmCommand dependencies pinned

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

Score

5.8

/10

Last Scanned on 2024-12-23

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to @keyv/memcache

keyv-memcache

1.3.3

Memcache storage adapter for Keyv