limited-cache 1.1.1 → 2.1.0

package/CHANGELOG.md

@@ -1,6 +1,22 @@
 # Changelog
 
-All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
+## 2.1.0
+
+### Minor Changes
+
+- Update and modernize package build ([#56](https://github.com/spautz/package-template/issues/56)) ([5f210a6](https://github.com/spautz/package-template/commit/5f210a6a5f77cdffe73f004ea4574f4e791e5029))
+- Add NPM provenance via Github actions ([#56](https://github.com/spautz/package-template/issues/56)) ([5f210a6](https://github.com/spautz/package-template/commit/5f210a6a5f77cdffe73f004ea4574f4e791e5029))
+- Confirm support for Node 20 ([#56](https://github.com/spautz/package-template/issues/56)) ([5f210a6](https://github.com/spautz/package-template/commit/5f210a6a5f77cdffe73f004ea4574f4e791e5029))
+
+## [2.0.0](https://github.com/spautz/limited-cache/compare/v1.1.1...v2.0.0) (2021-10-23)
+
+- Add `getCacheMetaFromObject` for accessing the cacheMeta of a `LimitedCacheObject`: see docs
+- Internal package updates
+- Confirm support for Node 17
+
+### BREAKING CHANGES
+
+- Drop support for Node 10
 
 ### [1.1.1](https://github.com/spautz/limited-cache/compare/v1.1.0...v1.1.1) (2021-06-21)
 
@@ -54,14 +70,12 @@ reset to an empty state on next load.
 
 ## [0.4.1](https://github.com/spautz/limited-cache/compare/v0.4.0...v0.4.1) (2020-06-13)
 
-> Update devDependencies for security, update configs for dev tools
-
+- Update devDependencies for security, update configs for dev tools
 - No changes expected in limited-cache itself
 
 ## [0.4.0](https://github.com/spautz/limited-cache/compare/v0.3.0...v0.4.0) (2020-03-14)
 
-> Update devDependencies, the build system, and the package distribution
-
+- Update devDependencies, the build system, and the package distribution
 - No changes expected in limited-cache itself
 
 ## [0.3.0](https://github.com/spautz/limited-cache/compare/v0.2.1...v0.3.0) (2020-02-19)

package/CODE_OF_CONDUCT.md

@@ -2,75 +2,131 @@
 
 ## Our Pledge
 
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, sex characteristics, gender identity and expression,
-level of experience, education, socio-economic status, nationality, personal
-appearance, race, religion, or sexual identity and orientation.
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
 
 ## Our Standards
 
-Examples of behavior that contributes to creating a positive environment
-include:
+Examples of behavior that contributes to a positive environment for our
+community include:
 
-- Using welcoming and inclusive language
-- Being respectful of differing viewpoints and experiences
-- Gracefully accepting constructive criticism
-- Focusing on what is best for the community
-- Showing empathy towards other community members
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+- Focusing on what is best not just for us as individuals, but for the
+  overall community
 
-Examples of unacceptable behavior by participants include:
+Examples of unacceptable behavior include:
 
-- The use of sexualized language or imagery and unwelcome sexual attention or
-  advances
-- Trolling, insulting/derogatory comments, and personal or political attacks
+- The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
 - Public or private harassment
-- Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
+- Publishing others' private information, such as a physical or email
+  address, without their explicit permission
 - Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
-## Our Responsibilities
+## Enforcement Responsibilities
 
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
 
-Project maintainers have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
 
 ## Scope
 
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
 
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at spautz@gmail.com. All
-complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The project team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
+reported to the community leaders responsible for enforcement at
+spautz@gmail.com.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
 
-Project maintainers who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by other
-members of the project's leadership.
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+[https://www.contributor-covenant.org/version/2/0/code_of_conduct.html][v2.0].
 
-[homepage]: https://www.contributor-covenant.org
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][mozilla coc].
 
-For answers to common questions about this code of conduct, see
-https://www.contributor-covenant.org/faq
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][faq]. Translations are available
+at [https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html
+[mozilla coc]: https://github.com/mozilla/diversity
+[faq]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

package/{CONTRIBUTING.md → CONTRIBUTING.template.md}

@@ -40,11 +40,13 @@ to discuss your idea and make sure it is inline with the project goals.
 4. To test your local dev version of `limited-cache` in other projects, [Yalc](https://github.com/whitecolor/yalc)
    is an excellent tool.
 
-5. After you have made your changes, submit a pull request. Issues and pull requests are monitored, and you should receive a reply.
+5. After you have made your changes, submit a pull request. Issues and pull requests are monitored, and you should
+   receive a reply.
 
 ## Code and Project Standards
 
-Eslint, Typescript, and Prettier enforce most code standards. A pre-push hook will validate the project against those standards.
+Eslint, Typescript, and Prettier enforce most code standards.
+A pre-push hook will validate the project against those standards.
 
 Running `yarn test` will check the code against unit tests and generate a code coverage report (in `coverage/`).
 This project's goal is to be near 100% code coverage.

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019 Steven Pautz
+Copyright (c) 2022 Steven Pautz
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -4,9 +4,9 @@ A minimal JS cache. Like using an object to store keys and values, except it won
 
 [![npm version](https://img.shields.io/npm/v/limited-cache.svg)](https://www.npmjs.com/package/limited-cache)
 [![build status](https://github.com/spautz/limited-cache/workflows/CI/badge.svg)](https://github.com/spautz/limited-cache/actions)
-[![dependencies Status](https://status.david-dm.org/gh/spautz/limited-cache.svg)](https://david-dm.org/spautz/limited-cache)
-[![gzip size](https://img.badgesize.io/https://unpkg.com/limited-cache@latest/dist/limited-cache.cjs.production.min.js?compression=gzip)](https://bundlephobia.com/result?p=limited-cache)
 [![test coverage](https://img.shields.io/coveralls/github/spautz/limited-cache/main.svg)](https://coveralls.io/github/spautz/limited-cache?branch=main)
+[![dependencies status](https://img.shields.io/librariesio/release/npm/limited-cache.svg)](https://libraries.io/github/spautz/limited-cache)
+[![gzip size](https://img.badgesize.io/https://unpkg.com/limited-cache@latest/dist/index.cjs?compression=gzip)](https://bundlephobia.com/result?p=limited-cache)
 
 ## Motivation
 
@@ -55,7 +55,7 @@ return {
 };
 ```
 
-Typescript generics, if you want to define a type for items in the cache:
+Typescript generics, to define a type for items in the cache:
 
 ```typescript
 const stringCache = LimitedCache<string>();
@@ -92,23 +92,31 @@ Use a falsy value to disable.
 
 ## Low-level functions
 
-These functions are grouped together as `limitedCacheUtil`. The other interfaces are built on top of these.
+Under the hood, everything is tracked inside a single, serializable object (`cacheMeta`) which can be persisted to
+storage or kept in Redux or any other state.
 
-- `init(options)`
-- `get(cacheMeta, cacheKey)`
-- `getAll(cacheMeta)` - returns the entire cache, excluding expired items
-- `has(cacheMeta, cacheKey)`
-- `set(cacheMeta, cacheKey, value)`
-- `remove(cacheMeta, cacheKey)`
-- `reset(cacheMeta)`
-- `setOptions(cacheMeta, options)` - you can update options anytime
-
-You can also import these functions individually, if you want to optimize tree-shaking and minification:
+You can retrieve this object from a LimitedCache or LimitedCacheObject, or create it directly via `lowLevelInit`:
 
 ```javascript
-import { lowLevelInit, lowLevelGetOne, lowLevelGetAll, lowLevelSet } from 'limited-cache';
+myLimitedCache.getCacheMeta();
+getCacheMetaFromObject(myLimitedCacheObject);
 ```
 
+Do not manipulate cacheMeta directly: a set of low-level functions is available for that. Every action available
+on the higher-level LimitedCache and LimitedCacheObject is available as a low-level function.
+
+- `lowLevelInit(options)`
+- `lowLevelGetOne(cacheMeta, cacheKey)`
+- `lowLevelGetAll(cacheMeta)` - returns the entire cache, excluding expired items
+- `lowLevelHas(cacheMeta, cacheKey)`
+- `lowLevelSet(cacheMeta, cacheKey, value)`
+- `lowLevelRemove(cacheMeta, cacheKey)`
+- `lowLevelReset(cacheMeta)`
+- `lowLevelSetOptions(cacheMeta, options)` - you can update options anytime
+
+These functions are also grouped together as [limitedCacheUtil](https://github.com/spautz/limited-cache/blob/main/src/core/limitedCacheUtil.ts#L13-L23) --
+but minimization and tree-shaking will be slightly better if you import each individually.
+
 ## FAQ
 
 **Immutable?**
@@ -125,7 +133,7 @@ When new items are added, or if you try to `get` an item that has expired.
 
 **Is this a least-recently-used cache?**
 
-No: For performance it only tracks by `set` time.
+Not by default: For performance it only tracks by `set` time.
 
-If you want items to expire based on when they were last accessed (instead of when they were set), you can `set`
-the value that already exists: only the timestamp will be updated, so performance won't suffer.
+You can turn it into a least-recently-used cache by calling `set` each time you `get` an item, though: items will then
+expire based on when they were last accessed. This case has been optimized so performance won't suffer.

package/dist/core/LimitedCache.d.ts

@@ -1,3 +1,4 @@
-import { LimitedCacheInstance } from '../types';
-declare const LimitedCache: <ItemType = any>(options?: Partial<import("../types").LimitedCacheOptionsFull> | null | undefined) => LimitedCacheInstance<ItemType>;
-export default LimitedCache;
+import { LimitedCacheOptions, LimitedCacheInstance } from '../types';
+declare const LimitedCache: <ItemType = any>(options?: LimitedCacheOptions) => LimitedCacheInstance<ItemType>;
+export { LimitedCache };
+//# sourceMappingURL=LimitedCache.d.ts.map

package/dist/core/LimitedCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitedCache.d.ts","sourceRoot":"","sources":["../../src/core/LimitedCache.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,mBAAmB,EAEnB,oBAAoB,EAGrB,MAAM,UAAU,CAAC;AAUlB,QAAA,MAAM,YAAY,6BACN,mBAAmB,mCAsB9B,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/core/LimitedCache.js

@@ -0,0 +1,29 @@
+import { lowLevelInit, lowLevelGetOne, lowLevelGetAll, lowLevelHas, lowLevelSet, lowLevelRemove, lowLevelReset, lowLevelSetOptions, lowLevelDoMaintenance, } from './lowLevelFunctions';
+// Most public functions just call a low-level function directly, passing the cacheMeta.
+// Doing this via a helper function makes the typeChecks easier, and minifies better.
+const bindFunctionToCacheMeta = (
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+fn, cacheMeta) => fn.bind(null, cacheMeta);
+const LimitedCache = (options) => {
+    const cacheMeta = lowLevelInit(options);
+    return {
+        get: bindFunctionToCacheMeta(lowLevelGetOne, cacheMeta),
+        getAll: bindFunctionToCacheMeta(lowLevelGetAll, cacheMeta),
+        has: bindFunctionToCacheMeta(lowLevelHas, cacheMeta),
+        set: (cacheKey, item) => {
+            lowLevelSet(cacheMeta, cacheKey, item);
+            return item;
+        },
+        remove: (cacheKey) => {
+            lowLevelRemove(cacheMeta, cacheKey);
+            return true;
+        },
+        reset: bindFunctionToCacheMeta(lowLevelReset, cacheMeta),
+        getCacheMeta: () => cacheMeta,
+        getOptions: () => cacheMeta.options,
+        setOptions: bindFunctionToCacheMeta(lowLevelSetOptions, cacheMeta),
+        doMaintenance: bindFunctionToCacheMeta(lowLevelDoMaintenance, cacheMeta),
+    };
+};
+export { LimitedCache };
+//# sourceMappingURL=LimitedCache.js.map

package/dist/core/LimitedCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitedCache.js","sourceRoot":"","sources":["../../src/core/LimitedCache.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,EACX,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAS7B,wFAAwF;AACxF,qFAAqF;AACrF,MAAM,uBAAuB,GAAG;AAC9B,8DAA8D;AAC9D,EAAqE,EACrE,SAAqC,EACrC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAE9B,MAAM,YAAY,GAAG,CACnB,OAA6B,EACG,EAAE;IAClC,MAAM,SAAS,GAAG,YAAY,CAAW,OAAO,CAAC,CAAC;IAElD,OAAO;QACL,GAAG,EAAE,uBAAuB,CAAW,cAAc,EAAE,SAAS,CAAC;QACjE,MAAM,EAAE,uBAAuB,CAAW,cAAc,EAAE,SAAS,CAAC;QACpE,GAAG,EAAE,uBAAuB,CAAW,WAAW,EAAE,SAAS,CAAC;QAC9D,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAY,EAAE;YAChC,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,EAAE,CAAC,QAAQ,EAAQ,EAAE;YACzB,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,EAAE,uBAAuB,CAAW,aAAa,EAAE,SAAS,CAAC;QAClE,YAAY,EAAE,GAA+B,EAAE,CAAC,SAAS;QACzD,UAAU,EAAE,GAAgC,EAAE,CAAC,SAAS,CAAC,OAAO;QAChE,UAAU,EAAE,uBAAuB,CAAW,kBAAkB,EAAE,SAAS,CAAC;QAC5E,aAAa,EAAE,uBAAuB,CAAW,qBAAqB,EAAE,SAAS,CAAC;KACnF,CAAC;AACJ,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/core/LimitedCacheObject.d.ts

@@ -1,3 +1,5 @@
-import { LimitedCacheObjectInstance } from '../types';
-declare const LimitedCacheObject: <ItemType = any>(options?: Partial<import("../types").LimitedCacheOptionsFull> | null | undefined) => LimitedCacheObjectInstance<ItemType>;
-export default LimitedCacheObject;
+import { LimitedCacheOptions, LimitedCacheObjectInstance, LimitedCacheMeta } from '../types';
+declare const LimitedCacheObject: <ItemType = any>(options?: LimitedCacheOptions) => LimitedCacheObjectInstance<ItemType>;
+declare const getCacheMetaFromObject: (instance: LimitedCacheObjectInstance) => LimitedCacheMeta;
+export { LimitedCacheObject, getCacheMetaFromObject };
+//# sourceMappingURL=LimitedCacheObject.d.ts.map

package/dist/core/LimitedCacheObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitedCacheObject.d.ts","sourceRoot":"","sources":["../../src/core/LimitedCacheObject.ts"],"names":[],"mappings":"AASA,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AA4ClB,QAAA,MAAM,kBAAkB,6BACZ,mBAAmB,yCAO9B,CAAC;AAEF,QAAA,MAAM,sBAAsB,aAAc,0BAA0B,KAAG,gBAEtE,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/core/LimitedCacheObject.js

@@ -0,0 +1,52 @@
+import { hasOwnProperty } from './builtIns';
+import { lowLevelInit, lowLevelGetOne, lowLevelGetAll, lowLevelHas, lowLevelSet, lowLevelRemove, } from './lowLevelFunctions';
+// The `any` here doesn't escape out anywhere: it's overridden by the constructor below
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const proxyHandler = {
+    get: (cacheMeta, cacheKey) => {
+        if (cacheKey === 'hasOwnProperty') {
+            return hasOwnProperty;
+        }
+        return lowLevelGetOne(cacheMeta, cacheKey);
+    },
+    getOwnPropertyDescriptor: (cacheMeta, cacheKey) => {
+        const hasResult = lowLevelHas(cacheMeta, cacheKey);
+        const getResult = lowLevelGetOne(cacheMeta, cacheKey);
+        if (hasResult) {
+            return {
+                configurable: true,
+                enumerable: hasResult,
+                value: getResult,
+                writable: true,
+            };
+        }
+        return;
+    },
+    has: lowLevelHas,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    set: (cacheMeta, cacheKey, item) => {
+        lowLevelSet(cacheMeta, cacheKey, item);
+        return item;
+    },
+    deleteProperty: (cacheMeta, cacheKey) => {
+        lowLevelRemove(cacheMeta, cacheKey);
+        return true;
+    },
+    ownKeys: (cacheMeta) => Object.keys(lowLevelGetAll(cacheMeta)),
+};
+/**
+ * So that we can retrieve the cacheMeta for a LimitedCacheObject, without polluting its properties, each proxy
+ * is associated back to its internal cacheMeta here.
+ */
+const cacheMetasForProxies = new WeakMap();
+const LimitedCacheObject = (options) => {
+    const cacheMeta = lowLevelInit(options);
+    const limitedCacheObject = new Proxy(cacheMeta, proxyHandler);
+    cacheMetasForProxies.set(limitedCacheObject, cacheMeta);
+    return limitedCacheObject;
+};
+const getCacheMetaFromObject = (instance) => {
+    return cacheMetasForProxies.get(instance);
+};
+export { LimitedCacheObject, getCacheMetaFromObject };
+//# sourceMappingURL=LimitedCacheObject.js.map

package/dist/core/LimitedCacheObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitedCacheObject.js","sourceRoot":"","sources":["../../src/core/LimitedCacheObject.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,EACX,cAAc,GACf,MAAM,qBAAqB,CAAC;AAQ7B,uFAAuF;AACvF,8DAA8D;AAC9D,MAAM,YAAY,GAAkD;IAClE,GAAG,EAAE,CAAC,SAA2B,EAAE,QAAgB,EAAE,EAAE;QACrD,IAAI,QAAQ,KAAK,gBAAgB,EAAE;YACjC,OAAO,cAAc,CAAC;SACvB;QACD,OAAO,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IACD,wBAAwB,EAAE,CAAC,SAA2B,EAAE,QAAgB,EAAE,EAAE;QAC1E,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEtD,IAAI,SAAS,EAAE;YACb,OAAO;gBACL,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,SAAS;gBACrB,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,IAAI;aACf,CAAC;SACH;QACD,OAAO;IACT,CAAC;IACD,GAAG,EAAE,WAAW;IAChB,8DAA8D;IAC9D,GAAG,EAAE,CAAC,SAA2B,EAAE,QAAgB,EAAE,IAAS,EAAO,EAAE;QACrE,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,cAAc,EAAE,CAAC,SAA2B,EAAE,QAAgB,EAAQ,EAAE;QACtE,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC,SAA2B,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;CACjF,CAAC;AAEF;;;GAGG;AACH,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAAE,CAAC;AAE3C,MAAM,kBAAkB,GAAG,CACzB,OAA6B,EACS,EAAE;IACxC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,kBAAkB,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAE9D,oBAAoB,CAAC,GAAG,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;IACxD,OAAO,kBAAkB,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,QAAoC,EAAoB,EAAE;IACxF,OAAO,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/core/builtIns.d.ts

@@ -1,11 +1,12 @@
-declare const objectCreate: {
-    (o: object | null): any;
-    (o: object | null, properties: PropertyDescriptorMap & ThisType<any>): any;
-}, objectAssign: {
-    <T, U>(target: T, source: U): T & U;
-    <T_1, U_1, V>(target: T_1, source1: U_1, source2: V): T_1 & U_1 & V;
-    <T_2, U_2, V_1, W>(target: T_2, source1: U_2, source2: V_1, source3: W): T_2 & U_2 & V_1 & W;
-    (target: object, ...sources: any[]): any;
-}, hasOwnProperty: (v: string | number | symbol) => boolean;
-declare const dateNow: () => number;
-export { objectAssign, objectCreate, dateNow, hasOwnProperty };
+declare const objectCreate: {
+    (o: object | null): any;
+    (o: object | null, properties: PropertyDescriptorMap & ThisType<any>): any;
+}, objectAssign: {
+    <T extends {}, U>(target: T, source: U): T & U;
+    <T_1 extends {}, U_1, V>(target: T_1, source1: U_1, source2: V): T_1 & U_1 & V;
+    <T_2 extends {}, U_2, V_1, W>(target: T_2, source1: U_2, source2: V_1, source3: W): T_2 & U_2 & V_1 & W;
+    (target: object, ...sources: any[]): any;
+}, hasOwnProperty: (v: PropertyKey) => boolean;
+declare const dateNow: () => number;
+export { objectAssign, objectCreate, dateNow, hasOwnProperty };
+//# sourceMappingURL=builtIns.d.ts.map

package/dist/core/builtIns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtIns.d.ts","sourceRoot":"","sources":["../../src/core/builtIns.ts"],"names":[],"mappings":"AACA,QAAA,MACU,YAAY;;;GACZ,YAAY;;;;;GACP,cAAc,6BACnB,CAAC;AACX,QAAA,MAAM,OAAO,cAAW,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/builtIns.js

@@ -0,0 +1,5 @@
+// To help minification
+const { create: objectCreate, assign: objectAssign, prototype: { hasOwnProperty }, } = Object;
+const dateNow = Date.now;
+export { objectAssign, objectCreate, dateNow, hasOwnProperty };
+//# sourceMappingURL=builtIns.js.map

package/dist/core/builtIns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtIns.js","sourceRoot":"","sources":["../../src/core/builtIns.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,MAAM,EACJ,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,EAAE,cAAc,EAAE,GAC9B,GAAG,MAAM,CAAC;AACX,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/defaultOptions.d.ts

@@ -1,6 +1,6 @@
-import { LimitedCacheOptionsReadonly } from '../types';
-declare const CURRENT_META_VERSION = 2;
-declare const MAXIMUM_CACHE_TIME: number;
-declare const defaultOptions: LimitedCacheOptionsReadonly;
-export default defaultOptions;
-export { CURRENT_META_VERSION, MAXIMUM_CACHE_TIME };
+import { LimitedCacheOptionsReadonly } from '../types';
+declare const CURRENT_META_VERSION = 2;
+declare const MAXIMUM_CACHE_TIME: number;
+declare const defaultOptions: LimitedCacheOptionsReadonly;
+export { CURRENT_META_VERSION, MAXIMUM_CACHE_TIME, defaultOptions };
+//# sourceMappingURL=defaultOptions.d.ts.map

package/dist/core/defaultOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultOptions.d.ts","sourceRoot":"","sources":["../../src/core/defaultOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAEvD,QAAA,MAAM,oBAAoB,IAAI,CAAC;AAC/B,QAAA,MAAM,kBAAkB,QAAqB,CAAC;AAE9C,QAAA,MAAM,cAAc,EAAE,2BASrB,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/defaultOptions.js

@@ -0,0 +1,14 @@
+const CURRENT_META_VERSION = 2;
+const MAXIMUM_CACHE_TIME = 365 * 86400 * 1000;
+const defaultOptions = {
+    // Public
+    maxCacheSize: 100,
+    maxCacheTime: 86400 * 1000,
+    // Development-only
+    warnIfItemPurgedBeforeTime: 5000,
+    // Private
+    opLimit: 200,
+    scanLimit: 50,
+};
+export { CURRENT_META_VERSION, MAXIMUM_CACHE_TIME, defaultOptions };
+//# sourceMappingURL=defaultOptions.js.map

package/dist/core/defaultOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultOptions.js","sourceRoot":"","sources":["../../src/core/defaultOptions.ts"],"names":[],"mappings":"AAEA,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,kBAAkB,GAAG,GAAG,GAAG,KAAK,GAAG,IAAI,CAAC;AAE9C,MAAM,cAAc,GAAgC;IAClD,SAAS;IACT,YAAY,EAAE,GAAG;IACjB,YAAY,EAAE,KAAK,GAAG,IAAI;IAC1B,mBAAmB;IACnB,0BAA0B,EAAE,IAAI;IAChC,UAAU;IACV,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/limitedCacheUtil.d.ts

@@ -1,12 +1,13 @@
-declare const limitedCacheUtil: {
-    init: <ItemType = any>(optionsOrCacheMeta?: Partial<import("..").LimitedCacheOptionsFull> | import("..").LimitedCacheMeta<ItemType> | null | undefined) => import("..").LimitedCacheMeta<ItemType>;
-    get: <ItemType_1 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_1>, cacheKey: string) => ItemType_1 | undefined;
-    getAll: <ItemType_2 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_2>) => Record<string, ItemType_2>;
-    has: <ItemType_3 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_3>, cacheKey: string) => boolean;
-    set: <ItemType_4 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_4>, cacheKey: string, item: ItemType_4) => import("..").LimitedCacheMeta<ItemType_4>;
-    remove: <ItemType_5 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_5>, cacheKey: string) => import("..").LimitedCacheMeta<ItemType_5>;
-    reset: <ItemType_6 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_6>) => import("..").LimitedCacheMeta<ItemType_6>;
-    doMaintenance: <ItemType_7 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_7>) => import("..").LimitedCacheMeta<ItemType_7>;
-    setOptions: <ItemType_8 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_8>, options: import("..").LimitedCacheOptions) => Readonly<import("..").LimitedCacheOptionsFull>;
-};
-export default limitedCacheUtil;
+declare const limitedCacheUtil: {
+    init: <ItemType = any>(optionsOrCacheMeta?: import("..").LimitedCacheOptions | import("..").LimitedCacheMeta<ItemType> | undefined) => import("..").LimitedCacheMeta<ItemType>;
+    get: <ItemType_1 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_1>, cacheKey: string) => ItemType_1 | undefined;
+    getAll: <ItemType_2 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_2>) => Record<string, ItemType_2>;
+    has: <ItemType_3 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_3>, cacheKey: string) => boolean;
+    set: <ItemType_4 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_4>, cacheKey: string, item: ItemType_4) => import("..").LimitedCacheMeta<ItemType_4>;
+    remove: <ItemType_5 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_5>, cacheKey: string) => import("..").LimitedCacheMeta<ItemType_5>;
+    reset: <ItemType_6 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_6>) => import("..").LimitedCacheMeta<ItemType_6>;
+    doMaintenance: <ItemType_7 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_7>) => import("..").LimitedCacheMeta<ItemType_7>;
+    setOptions: <ItemType_8 = any>(cacheMeta: import("..").LimitedCacheMeta<ItemType_8>, options: import("..").LimitedCacheOptions) => Readonly<import("..").LimitedCacheOptionsFull>;
+};
+export { limitedCacheUtil };
+//# sourceMappingURL=limitedCacheUtil.d.ts.map

package/dist/core/limitedCacheUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limitedCacheUtil.d.ts","sourceRoot":"","sources":["../../src/core/limitedCacheUtil.ts"],"names":[],"mappings":"AAYA,QAAA,MAAM,gBAAgB;;;;;;;;;;CAUrB,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/core/limitedCacheUtil.js

@@ -0,0 +1,14 @@
+import { lowLevelGetOne, lowLevelGetAll, lowLevelHas, lowLevelInit, lowLevelDoMaintenance, lowLevelRemove, lowLevelReset, lowLevelSet, lowLevelSetOptions, } from './lowLevelFunctions';
+const limitedCacheUtil = {
+    init: lowLevelInit,
+    get: lowLevelGetOne,
+    getAll: lowLevelGetAll,
+    has: lowLevelHas,
+    set: lowLevelSet,
+    remove: lowLevelRemove,
+    reset: lowLevelReset,
+    doMaintenance: lowLevelDoMaintenance,
+    setOptions: lowLevelSetOptions,
+};
+export { limitedCacheUtil };
+//# sourceMappingURL=limitedCacheUtil.js.map

package/dist/core/limitedCacheUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limitedCacheUtil.js","sourceRoot":"","sources":["../../src/core/limitedCacheUtil.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,WAAW,EACX,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,cAAc;IACnB,MAAM,EAAE,cAAc;IACtB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,aAAa;IACpB,aAAa,EAAE,qBAAqB;IACpC,UAAU,EAAE,kBAAkB;CAC/B,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/core/lowLevelFunctions.d.ts

@@ -1,13 +1,14 @@
-import { LimitedCacheOptions, LimitedCacheOptionsReadonly, LimitedCacheMeta, LimitedCacheOptionsFull } from '../types';
-declare const isCacheMeta: (cacheMeta: LimitedCacheMeta) => boolean;
-declare const upgradeCacheMeta: (cacheMeta: LimitedCacheMeta) => void;
-declare const lowLevelSetOptions: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, options: LimitedCacheOptions) => LimitedCacheOptionsReadonly;
-declare const lowLevelInit: <ItemType = any>(optionsOrCacheMeta?: Partial<LimitedCacheOptionsFull> | LimitedCacheMeta<ItemType> | null | undefined) => LimitedCacheMeta<ItemType>;
-declare const lowLevelDoMaintenance: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>) => LimitedCacheMeta<ItemType>;
-declare const lowLevelHas: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, cacheKey: string) => boolean;
-declare const lowLevelGetOne: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, cacheKey: string) => ItemType | undefined;
-declare const lowLevelGetAll: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>) => Record<string, ItemType>;
-declare const lowLevelSet: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, cacheKey: string, item: ItemType) => LimitedCacheMeta<ItemType>;
-declare const lowLevelRemove: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, cacheKey: string) => LimitedCacheMeta<ItemType>;
-declare const lowLevelReset: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>) => LimitedCacheMeta<ItemType>;
-export { isCacheMeta, upgradeCacheMeta, lowLevelInit, lowLevelGetOne, lowLevelGetAll, lowLevelHas, lowLevelSet, lowLevelRemove, lowLevelReset, lowLevelDoMaintenance, lowLevelSetOptions, };
+import { LimitedCacheOptions, LimitedCacheOptionsReadonly, LimitedCacheMeta } from '../types';
+declare const isCacheMeta: (cacheMeta: LimitedCacheMeta) => boolean;
+declare const upgradeCacheMeta: (cacheMeta: LimitedCacheMeta) => void;
+declare const lowLevelSetOptions: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, options: LimitedCacheOptions) => LimitedCacheOptionsReadonly;
+declare const lowLevelInit: <ItemType = any>(optionsOrCacheMeta?: LimitedCacheOptions | LimitedCacheMeta<ItemType> | undefined) => LimitedCacheMeta<ItemType>;
+declare const lowLevelDoMaintenance: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>) => LimitedCacheMeta<ItemType>;
+declare const lowLevelHas: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, cacheKey: string) => boolean;
+declare const lowLevelGetOne: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, cacheKey: string) => ItemType | undefined;
+declare const lowLevelGetAll: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>) => Record<string, ItemType>;
+declare const lowLevelSet: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, cacheKey: string, item: ItemType) => LimitedCacheMeta<ItemType>;
+declare const lowLevelRemove: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>, cacheKey: string) => LimitedCacheMeta<ItemType>;
+declare const lowLevelReset: <ItemType = any>(cacheMeta: LimitedCacheMeta<ItemType>) => LimitedCacheMeta<ItemType>;
+export { isCacheMeta, upgradeCacheMeta, lowLevelInit, lowLevelGetOne, lowLevelGetAll, lowLevelHas, lowLevelSet, lowLevelRemove, lowLevelReset, lowLevelDoMaintenance, lowLevelSetOptions, };
+//# sourceMappingURL=lowLevelFunctions.d.ts.map

package/dist/core/lowLevelFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lowLevelFunctions.d.ts","sourceRoot":"","sources":["../../src/core/lowLevelFunctions.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,EAGjB,MAAM,UAAU,CAAC;AAqBlB,QAAA,MAAM,WAAW,cAAe,gBAAgB,KAAG,OAElD,CAAC;AAEF,QAAA,MAAM,gBAAgB,cAAe,gBAAgB,KAAG,IAWvD,CAAC;AAEF,QAAA,MAAM,kBAAkB,mEAEb,mBAAmB,KAC3B,2BAGF,CAAC;AAEF,QAAA,MAAM,YAAY,mIAkBjB,CAAC;AA0BF,QAAA,MAAM,qBAAqB,uFA+B1B,CAAC;AA4FF,QAAA,MAAM,WAAW,oEAEL,MAAM,KACf,OAWF,CAAC;AAEF,QAAA,MAAM,cAAc,oEAER,MAAM,yBAOjB,CAAC;AAEF,QAAA,MAAM,cAAc,qFAQnB,CAAC;AAEF,QAAA,MAAM,WAAW,oEAEL,MAAM,+CA+CjB,CAAC;AAEF,QAAA,MAAM,cAAc,oEAER,MAAM,+BAgBjB,CAAC;AAEF,QAAA,MAAM,aAAa,uFAUlB,CAAC;AAEF,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,EACX,WAAW,EACX,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,kBAAkB,GACnB,CAAC"}