@bessemer/cornerstone 0.5.1 → 0.5.4

package/dist/array.d.ts

@@ -0,0 +1,57 @@
+import { Equalitor } from '@bessemer/cornerstone/equalitor';
+import { Signable } from '@bessemer/cornerstone/signature';
+import { Either } from '@bessemer/cornerstone/either';
+import { Comparator } from '@bessemer/cornerstone/comparator';
+import { Arrayable } from 'type-fest';
+export declare const equalWith: <T>(first: Array<T>, second: Array<T>, equalitor: Equalitor<T>) => boolean;
+export declare const equalBy: <T>(first: Array<T>, second: Array<T>, mapper: (element: T) => Signable) => boolean;
+export declare const equal: <T extends Signable>(first: Array<T>, second: Array<T>) => boolean;
+export declare const differenceWith: <T>(first: Array<T>, second: Array<T>, equalitor: Equalitor<T>) => Array<T>;
+export declare const differenceBy: <T>(first: Array<T>, second: Array<T>, mapper: (element: T) => Signable) => Array<T>;
+export declare const difference: <T extends Signable>(first: Array<T>, second: Array<T>) => Array<T>;
+export declare const removeWith: <T>(array: Array<T>, element: T, equalitor: Equalitor<T>) => Array<T>;
+export declare const removeBy: <T>(array: Array<T>, element: T, mapper: (element: T) => Signable) => Array<T>;
+export declare const remove: <T extends Signable>(array: Array<T>, element: T) => Array<T>;
+export declare const containsWith: <T>(array: Array<T>, element: T, equalitor: Equalitor<T>) => boolean;
+export declare const containsBy: <T>(array: Array<T>, element: T, mapper: (element: T) => Signable) => boolean;
+export declare const contains: <T extends Signable>(array: Array<T>, element: T) => boolean;
+export declare const containsAllWith: <T>(first: Array<T>, second: Array<T>, equalitor: Equalitor<T>) => boolean;
+export declare const containsAllBy: <T>(first: Array<T>, second: Array<T>, mapper: (element: T) => Signable) => boolean;
+export declare const containsAll: <T extends Signable>(first: Array<T>, second: Array<T>) => boolean;
+export declare const dedupeWith: <T>(array: Array<T>, equalitor: Equalitor<T>) => Array<T>;
+export declare const dedupeBy: <T>(array: Array<T>, mapper: (element: T) => Signable) => Array<T>;
+export declare const dedupe: <T extends Signable>(array: Array<T>) => Array<T>;
+export declare const sortWith: <T>(array: Array<T>, comparator: Comparator<T>) => Array<T>;
+export declare const sortBy: <T>(array: Array<T>, mapper: (element: T) => Signable) => Array<T>;
+export declare const sort: <T extends Signable>(array: Array<T>) => Array<T>;
+export declare const concatenate: <T>(...values: Array<import("lodash").Many<T>>) => T[];
+export declare const first: {
+    <T>(array: readonly [T, ...unknown[]]): T;
+    <T>(array: import("lodash").List<T> | null | undefined): T | undefined;
+};
+export declare const only: <T>(array: Array<T>) => T;
+export declare const last: <T>(array: import("lodash").List<T> | null | undefined) => T | undefined;
+export declare const isEmpty: {
+    <T extends {
+        __trapAny: any;
+    }>(value?: T): boolean;
+    (value: string): value is "";
+    (value: Map<any, any> | Set<any> | import("lodash").List<any> | null | undefined): boolean;
+    (value: object): boolean;
+    <T extends object>(value: T | null | undefined): value is import("lodash").EmptyObjectOf<T> | null | undefined;
+    (value?: any): boolean;
+};
+export declare const range: {
+    (start: number, end?: number, step?: number): number[];
+    (end: number, index: string | number, guard: object): number[];
+};
+export declare const groupBy: {
+    <T>(collection: import("lodash").List<T> | null | undefined, iteratee?: import("lodash").ValueIteratee<T>): import("lodash").Dictionary<T[]>;
+    <T extends object>(collection: T | null | undefined, iteratee?: import("lodash").ValueIteratee<T[keyof T]>): import("lodash").Dictionary<Array<T[keyof T]>>;
+};
+export declare const rest: <T>(array: Array<T>, elementsToSkip?: number) => Array<T>;
+export declare const clear: (array: Array<unknown>) => void;
+export declare const bisect: <T, L, R>(array: Array<T>, bisector: (element: T, index: number) => Either<L, R>) => [Array<L>, Array<R>];
+export declare const toArray: <T>(array: Arrayable<T>) => Array<T>;
+export declare const flatten: <T>(array: import("lodash").List<import("lodash").Many<T>> | null | undefined) => T[];
+//# sourceMappingURL=array.d.ts.map

package/dist/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,SAAS,CAAC,CAAC,CAAC,KAAG,OAMzF,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,KAAG,OAEhG,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAG,OAE7E,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,SAAS,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAErG,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,KAAG,KAAK,CAAC,CAAC,CAE5G,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAEzF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW,SAAS,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAE3F,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,KAAG,KAAK,CAAC,CAAC,CAElG,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,KAAG,KAAK,CAAC,CAAC,CAE/E,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW,SAAS,CAAC,CAAC,CAAC,KAAG,OAEtF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,KAAG,OAE7F,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,KAAG,OAAsD,CAAA;AAEjI,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,SAAS,CAAC,CAAC,CAAC,KAAG,OAC7C,CAAA;AAEnD,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,KAAG,OACzD,CAAA;AAE9C,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,KAAG,OAA6C,CAAA;AAEjI,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,SAAS,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAE/E,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,KAAG,KAAK,CAAC,CAAC,CAEtF,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAEnE,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,YAAY,UAAU,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAE/E,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,QAAQ,KAAG,KAAK,CAAC,CAAC,CAKpF,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,QAAQ,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAAmC,CAAA;AAErG,eAAO,MAAM,WAAW,wDAAS,CAAA;AAEjC,eAAO,MAAM,KAAK;;;CAAS,CAAA;AAE3B,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAG,CAGzC,CAAA;AAED,eAAO,MAAM,IAAI,0EAAQ,CAAA;AAEzB,eAAO,MAAM,OAAO;;;;;;;;;CAAW,CAAA;AAE/B,eAAO,MAAM,KAAK;;;CAAS,CAAA;AAE3B,eAAO,MAAM,OAAO;;;CAAW,CAAA;AAE/B,eAAO,MAAM,IAAI,GAAI,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,iBAAgB,MAAU,KAAG,KAAK,CAAC,CAAC,CAE5E,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,CAAC,OAAO,CAAC,KAAG,IAE7C,CAAA;AAED,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAE3H,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,SAAS,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,CAMvD,CAAA;AAED,eAAO,MAAM,OAAO,uFAAW,CAAA"}

package/dist/array.js

@@ -0,0 +1,137 @@
+// src/array.ts
+import {
+  concat,
+  differenceBy as _differenceBy,
+  differenceWith as _differenceWith,
+  first as _first,
+  flatten as _flatten,
+  groupBy as _groupBy,
+  isEmpty as _isEmpty,
+  last as _last,
+  range as _range,
+  remove as _remove,
+  uniqBy,
+  uniqWith
+} from "lodash-es";
+import { Comparators, Eithers, Preconditions, Signatures } from "@bessemer/cornerstone";
+var equalWith = (first2, second, equalitor) => {
+  if (first2.length !== second.length) {
+    return false;
+  }
+  return first2.every((element, index) => equalitor(element, second[index]));
+};
+var equalBy = (first2, second, mapper) => {
+  return equalWith(first2, second, (first3, second2) => Signatures.sign(mapper(first3)) === Signatures.sign(mapper(second2)));
+};
+var equal = (first2, second) => {
+  return equalBy(first2, second, Signatures.sign);
+};
+var differenceWith = (first2, second, equalitor) => {
+  return _differenceWith(first2, second, equalitor);
+};
+var differenceBy = (first2, second, mapper) => {
+  return _differenceBy(first2, second, (it) => Signatures.sign(mapper(it)));
+};
+var difference = (first2, second) => {
+  return differenceBy(first2, second, Signatures.sign);
+};
+var removeWith = (array, element, equalitor) => {
+  return differenceWith(array, [element], equalitor);
+};
+var removeBy = (array, element, mapper) => {
+  return differenceBy(array, [element], mapper);
+};
+var remove = (array, element) => {
+  return difference(array, [element]);
+};
+var containsWith = (array, element, equalitor) => {
+  return array.some((it) => equalitor(it, element));
+};
+var containsBy = (array, element, mapper) => {
+  return containsWith(array, element, (first2, second) => Signatures.sign(mapper(first2)) === Signatures.sign(mapper(second)));
+};
+var contains = (array, element) => containsBy(array, element, Signatures.sign);
+var containsAllWith = (first2, second, equalitor) => isEmpty(differenceWith(second, first2, equalitor));
+var containsAllBy = (first2, second, mapper) => isEmpty(differenceBy(second, first2, mapper));
+var containsAll = (first2, second) => isEmpty(difference(second, first2));
+var dedupeWith = (array, equalitor) => {
+  return uniqWith(array, equalitor);
+};
+var dedupeBy = (array, mapper) => {
+  return uniqBy(array, (it) => Signatures.sign(mapper(it)));
+};
+var dedupe = (array) => {
+  return dedupeBy(array, Signatures.sign);
+};
+var sortWith = (array, comparator) => {
+  return [...array].sort(comparator);
+};
+var sortBy = (array, mapper) => {
+  return sortWith(
+    array,
+    Comparators.compareBy((it) => Signatures.sign(mapper(it)), Comparators.natural())
+  );
+};
+var sort = (array) => sortBy(array, Signatures.sign);
+var concatenate = concat;
+var first = _first;
+var only = (array) => {
+  Preconditions.isTrue(array.length === 1);
+  return first(array);
+};
+var last = _last;
+var isEmpty = _isEmpty;
+var range = _range;
+var groupBy = _groupBy;
+var rest = (array, elementsToSkip = 1) => {
+  return array.slice(elementsToSkip);
+};
+var clear = (array) => {
+  _remove(array, () => true);
+};
+var bisect = (array, bisector) => {
+  return Eithers.split(array.map(bisector));
+};
+var toArray = (array) => {
+  if (Array.isArray(array)) {
+    return array;
+  }
+  return [array];
+};
+var flatten = _flatten;
+export {
+  bisect,
+  clear,
+  concatenate,
+  contains,
+  containsAll,
+  containsAllBy,
+  containsAllWith,
+  containsBy,
+  containsWith,
+  dedupe,
+  dedupeBy,
+  dedupeWith,
+  difference,
+  differenceBy,
+  differenceWith,
+  equal,
+  equalBy,
+  equalWith,
+  first,
+  flatten,
+  groupBy,
+  isEmpty,
+  last,
+  only,
+  range,
+  remove,
+  removeBy,
+  removeWith,
+  rest,
+  sort,
+  sortBy,
+  sortWith,
+  toArray
+};
+//# sourceMappingURL=array.js.map

package/dist/array.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/array.ts"],"sourcesContent":["import {\n  concat,\n  differenceBy as _differenceBy,\n  differenceWith as _differenceWith,\n  first as _first,\n  flatten as _flatten,\n  groupBy as _groupBy,\n  isEmpty as _isEmpty,\n  last as _last,\n  range as _range,\n  remove as _remove,\n  uniqBy,\n  uniqWith,\n} from 'lodash-es'\nimport { Equalitor } from '@bessemer/cornerstone/equalitor'\nimport { Signable } from '@bessemer/cornerstone/signature'\nimport { Comparators, Eithers, Preconditions, Signatures } from '@bessemer/cornerstone'\nimport { Either } from '@bessemer/cornerstone/either'\nimport { Comparator } from '@bessemer/cornerstone/comparator'\nimport { Arrayable } from 'type-fest'\n\nexport const equalWith = <T>(first: Array<T>, second: Array<T>, equalitor: Equalitor<T>): boolean => {\n  if (first.length !== second.length) {\n    return false\n  }\n\n  return first.every((element, index) => equalitor(element, second[index]!))\n}\n\nexport const equalBy = <T>(first: Array<T>, second: Array<T>, mapper: (element: T) => Signable): boolean => {\n  return equalWith(first, second, (first, second) => Signatures.sign(mapper(first)) === Signatures.sign(mapper(second)))\n}\n\nexport const equal = <T extends Signable>(first: Array<T>, second: Array<T>): boolean => {\n  return equalBy(first, second, Signatures.sign)\n}\n\nexport const differenceWith = <T>(first: Array<T>, second: Array<T>, equalitor: Equalitor<T>): Array<T> => {\n  return _differenceWith(first, second, equalitor)\n}\n\nexport const differenceBy = <T>(first: Array<T>, second: Array<T>, mapper: (element: T) => Signable): Array<T> => {\n  return _differenceBy(first, second, (it) => Signatures.sign(mapper(it)))\n}\n\nexport const difference = <T extends Signable>(first: Array<T>, second: Array<T>): Array<T> => {\n  return differenceBy(first, second, Signatures.sign)\n}\n\nexport const removeWith = <T>(array: Array<T>, element: T, equalitor: Equalitor<T>): Array<T> => {\n  return differenceWith(array, [element], equalitor)\n}\n\nexport const removeBy = <T>(array: Array<T>, element: T, mapper: (element: T) => Signable): Array<T> => {\n  return differenceBy(array, [element], mapper)\n}\n\nexport const remove = <T extends Signable>(array: Array<T>, element: T): Array<T> => {\n  return difference(array, [element])\n}\n\nexport const containsWith = <T>(array: Array<T>, element: T, equalitor: Equalitor<T>): boolean => {\n  return array.some((it) => equalitor(it, element))\n}\n\nexport const containsBy = <T>(array: Array<T>, element: T, mapper: (element: T) => Signable): boolean => {\n  return containsWith(array, element, (first, second) => Signatures.sign(mapper(first)) === Signatures.sign(mapper(second)))\n}\n\nexport const contains = <T extends Signable>(array: Array<T>, element: T): boolean => containsBy(array, element, Signatures.sign)\n\nexport const containsAllWith = <T>(first: Array<T>, second: Array<T>, equalitor: Equalitor<T>): boolean =>\n  isEmpty(differenceWith(second, first, equalitor))\n\nexport const containsAllBy = <T>(first: Array<T>, second: Array<T>, mapper: (element: T) => Signable): boolean =>\n  isEmpty(differenceBy(second, first, mapper))\n\nexport const containsAll = <T extends Signable>(first: Array<T>, second: Array<T>): boolean => isEmpty(difference(second, first))\n\nexport const dedupeWith = <T>(array: Array<T>, equalitor: Equalitor<T>): Array<T> => {\n  return uniqWith(array, equalitor)\n}\n\nexport const dedupeBy = <T>(array: Array<T>, mapper: (element: T) => Signable): Array<T> => {\n  return uniqBy(array, (it) => Signatures.sign(mapper(it)))\n}\n\nexport const dedupe = <T extends Signable>(array: Array<T>): Array<T> => {\n  return dedupeBy(array, Signatures.sign)\n}\n\nexport const sortWith = <T>(array: Array<T>, comparator: Comparator<T>): Array<T> => {\n  return [...array].sort(comparator)\n}\n\nexport const sortBy = <T>(array: Array<T>, mapper: (element: T) => Signable): Array<T> => {\n  return sortWith(\n    array,\n    Comparators.compareBy((it) => Signatures.sign(mapper(it)), Comparators.natural())\n  )\n}\n\nexport const sort = <T extends Signable>(array: Array<T>): Array<T> => sortBy(array, Signatures.sign)\n\nexport const concatenate = concat\n\nexport const first = _first\n\nexport const only = <T>(array: Array<T>): T => {\n  Preconditions.isTrue(array.length === 1)\n  return first(array)!\n}\n\nexport const last = _last\n\nexport const isEmpty = _isEmpty\n// TODO make a better range function\nexport const range = _range\n// TODO should this live in collections?\nexport const groupBy = _groupBy\n\nexport const rest = <T>(array: Array<T>, elementsToSkip: number = 1): Array<T> => {\n  return array.slice(elementsToSkip)\n}\n\nexport const clear = (array: Array<unknown>): void => {\n  _remove(array, () => true)\n}\n\nexport const bisect = <T, L, R>(array: Array<T>, bisector: (element: T, index: number) => Either<L, R>): [Array<L>, Array<R>] => {\n  return Eithers.split(array.map(bisector))\n}\n\nexport const toArray = <T>(array: Arrayable<T>): Array<T> => {\n  if (Array.isArray(array)) {\n    return array\n  }\n\n  return [array]\n}\n\nexport const flatten = _flatten\n"],"mappings":"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","names":["first","second"]}

package/dist/async.d.ts

@@ -0,0 +1,59 @@
+import { Duration } from '@bessemer/cornerstone/duration';
+export type PendingValue = {
+    isSuccess: false;
+    isError: false;
+    isLoading: false;
+    isFetching: boolean;
+    data: undefined;
+};
+export type LoadingValue = {
+    isSuccess: false;
+    isError: false;
+    isLoading: true;
+    isFetching: boolean;
+    data: undefined;
+};
+export type ErrorValue = {
+    isSuccess: false;
+    isError: true;
+    isLoading: false;
+    isFetching: boolean;
+    data: unknown;
+};
+export type FetchingValueSuccess<T> = {
+    isSuccess: true;
+    isError: false;
+    isLoading: false;
+    isFetching: true;
+    data: T;
+};
+export type FetchingValueError = {
+    isSuccess: false;
+    isError: true;
+    isLoading: false;
+    isFetching: true;
+    data: unknown;
+};
+export type SettledValue<T> = {
+    isSuccess: true;
+    isError: false;
+    isLoading: false;
+    isFetching: false;
+    data: T;
+};
+export type AsyncValue<T> = PendingValue | LoadingValue | ErrorValue | FetchingValueSuccess<T> | FetchingValueError | SettledValue<T>;
+export declare const isSettled: <T>(value: AsyncValue<T>) => value is SettledValue<T>;
+export declare const loading: () => LoadingValue;
+export declare const fetching: <T>(data: T) => FetchingValueSuccess<T>;
+export declare const settled: <T>(data: T) => SettledValue<T>;
+export declare const error: (error: unknown) => ErrorValue;
+export declare const handle: <T, N>(value: AsyncValue<T | null>, handlers: {
+    loading: () => N;
+    error: (error: unknown) => N;
+    absent: () => N;
+    success: (data: T) => N;
+}) => N;
+export declare const map: <T, N>(value: AsyncValue<T>, mapper: (value: T) => N) => AsyncValue<N>;
+export declare const execute: <T>(runnable: () => Promise<T>) => Promise<T>;
+export declare const sleep: (duration: Duration) => Promise<void>;
+//# sourceMappingURL=async.d.ts.map

package/dist/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../src/async.ts"],"names":[],"mappings":"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"}

package/dist/async.js

@@ -0,0 +1,62 @@
+// src/async.ts
+import { Durations, Objects } from "@bessemer/cornerstone";
+var isSettled = (value) => {
+  return value.isSuccess && !value.isError && !value.isLoading && !value.isFetching;
+};
+var loading = () => ({ isSuccess: false, isError: false, isLoading: true, isFetching: true, data: void 0 });
+var fetching = (data) => ({
+  isSuccess: true,
+  isError: false,
+  isLoading: false,
+  isFetching: true,
+  data
+});
+var settled = (data) => ({ isSuccess: true, isError: false, isLoading: false, isFetching: false, data });
+var error = (error2) => ({ isSuccess: false, isError: true, isLoading: false, isFetching: false, data: error2 });
+var handle = (value, handlers) => {
+  if (value.isLoading || value.isError && value.isFetching) {
+    return handlers.loading();
+  }
+  if (value.isError) {
+    return handlers.error(value.data);
+  }
+  if (Objects.isNil(value.data)) {
+    return handlers.absent();
+  }
+  return handlers.success(value.data);
+};
+var map = (value, mapper) => {
+  if (!value.isSuccess) {
+    return value;
+  }
+  return { ...value, data: mapper(value.data) };
+};
+var execute = (runnable) => {
+  return new Promise(async (resolve, reject) => {
+    setTimeout(async () => {
+      try {
+        const value = await runnable();
+        resolve(value);
+      } catch (e) {
+        reject(e);
+      }
+    }, 0);
+  });
+};
+var sleep = (duration) => {
+  return new Promise((resolve) => {
+    setTimeout(resolve, Durations.inMilliseconds(duration));
+  });
+};
+export {
+  error,
+  execute,
+  fetching,
+  handle,
+  isSettled,
+  loading,
+  map,
+  settled,
+  sleep
+};
+//# sourceMappingURL=async.js.map

package/dist/async.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/async.ts"],"sourcesContent":["import { Duration } from '@bessemer/cornerstone/duration'\nimport { Durations, Objects } from '@bessemer/cornerstone'\n\nexport type PendingValue = {\n  isSuccess: false\n  isError: false\n  isLoading: false\n  isFetching: boolean\n  data: undefined\n}\n\nexport type LoadingValue = {\n  isSuccess: false\n  isError: false\n  isLoading: true\n  isFetching: boolean\n  data: undefined\n}\n\nexport type ErrorValue = {\n  isSuccess: false\n  isError: true\n  isLoading: false\n  isFetching: boolean\n  data: unknown\n}\n\nexport type FetchingValueSuccess<T> = {\n  isSuccess: true\n  isError: false\n  isLoading: false\n  isFetching: true\n  data: T\n}\n\nexport type FetchingValueError = {\n  isSuccess: false\n  isError: true\n  isLoading: false\n  isFetching: true\n  data: unknown\n}\n\nexport type SettledValue<T> = {\n  isSuccess: true\n  isError: false\n  isLoading: false\n  isFetching: false\n  data: T\n}\n\nexport type AsyncValue<T> = PendingValue | LoadingValue | ErrorValue | FetchingValueSuccess<T> | FetchingValueError | SettledValue<T>\n\nexport const isSettled = <T>(value: AsyncValue<T>): value is SettledValue<T> => {\n  return value.isSuccess && !value.isError && !value.isLoading && !value.isFetching\n}\n\nexport const loading = (): LoadingValue => ({ isSuccess: false, isError: false, isLoading: true, isFetching: true, data: undefined })\n\nexport const fetching = <T>(data: T): FetchingValueSuccess<T> => ({\n  isSuccess: true,\n  isError: false,\n  isLoading: false,\n  isFetching: true,\n  data,\n})\n\nexport const settled = <T>(data: T): SettledValue<T> => ({ isSuccess: true, isError: false, isLoading: false, isFetching: false, data })\n\nexport const error = (error: unknown): ErrorValue => ({ isSuccess: false, isError: true, isLoading: false, isFetching: false, data: error })\n\nexport const handle = <T, N>(\n  value: AsyncValue<T | null>,\n  handlers: { loading: () => N; error: (error: unknown) => N; absent: () => N; success: (data: T) => N }\n): N => {\n  if (value.isLoading || (value.isError && value.isFetching)) {\n    return handlers.loading()\n  }\n  if (value.isError) {\n    return handlers.error(value.data)\n  }\n  if (Objects.isNil(value.data)) {\n    return handlers.absent()\n  }\n\n  return handlers.success(value.data)\n}\n\nexport const map = <T, N>(value: AsyncValue<T>, mapper: (value: T) => N): AsyncValue<N> => {\n  if (!value.isSuccess) {\n    return value\n  }\n\n  return { ...value, data: mapper(value.data) }\n}\n\nexport const execute = <T>(runnable: () => Promise<T>): Promise<T> => {\n  return new Promise(async (resolve, reject) => {\n    setTimeout(async () => {\n      try {\n        const value = await runnable()\n        resolve(value)\n      } catch (e) {\n        reject(e)\n      }\n    }, 0)\n  })\n}\n\nexport const sleep = (duration: Duration): Promise<void> => {\n  return new Promise((resolve) => {\n    setTimeout(resolve, Durations.inMilliseconds(duration))\n  })\n}\n"],"mappings":";AACA,SAAS,WAAW,eAAe;AAoD5B,IAAM,YAAY,CAAI,UAAmD;AAC9E,SAAO,MAAM,aAAa,CAAC,MAAM,WAAW,CAAC,MAAM,aAAa,CAAC,MAAM;AACzE;AAEO,IAAM,UAAU,OAAqB,EAAE,WAAW,OAAO,SAAS,OAAO,WAAW,MAAM,YAAY,MAAM,MAAM,OAAU;AAE5H,IAAM,WAAW,CAAI,UAAsC;AAAA,EAChE,WAAW;AAAA,EACX,SAAS;AAAA,EACT,WAAW;AAAA,EACX,YAAY;AAAA,EACZ;AACF;AAEO,IAAM,UAAU,CAAI,UAA8B,EAAE,WAAW,MAAM,SAAS,OAAO,WAAW,OAAO,YAAY,OAAO,KAAK;AAE/H,IAAM,QAAQ,CAACA,YAAgC,EAAE,WAAW,OAAO,SAAS,MAAM,WAAW,OAAO,YAAY,OAAO,MAAMA,OAAM;AAEnI,IAAM,SAAS,CACpB,OACA,aACM;AACN,MAAI,MAAM,aAAc,MAAM,WAAW,MAAM,YAAa;AAC1D,WAAO,SAAS,QAAQ;AAAA,EAC1B;AACA,MAAI,MAAM,SAAS;AACjB,WAAO,SAAS,MAAM,MAAM,IAAI;AAAA,EAClC;AACA,MAAI,QAAQ,MAAM,MAAM,IAAI,GAAG;AAC7B,WAAO,SAAS,OAAO;AAAA,EACzB;AAEA,SAAO,SAAS,QAAQ,MAAM,IAAI;AACpC;AAEO,IAAM,MAAM,CAAO,OAAsB,WAA2C;AACzF,MAAI,CAAC,MAAM,WAAW;AACpB,WAAO;AAAA,EACT;AAEA,SAAO,EAAE,GAAG,OAAO,MAAM,OAAO,MAAM,IAAI,EAAE;AAC9C;AAEO,IAAM,UAAU,CAAI,aAA2C;AACpE,SAAO,IAAI,QAAQ,OAAO,SAAS,WAAW;AAC5C,eAAW,YAAY;AACrB,UAAI;AACF,cAAM,QAAQ,MAAM,SAAS;AAC7B,gBAAQ,KAAK;AAAA,MACf,SAAS,GAAG;AACV,eAAO,CAAC;AAAA,MACV;AAAA,IACF,GAAG,CAAC;AAAA,EACN,CAAC;AACH;AAEO,IAAM,QAAQ,CAAC,aAAsC;AAC1D,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,eAAW,SAAS,UAAU,eAAe,QAAQ,CAAC;AAAA,EACxD,CAAC;AACH;","names":["error"]}

package/dist/cache.d.ts

@@ -0,0 +1,106 @@
+import { AbstractLocalKeyValueStore, AbstractRemoteKeyValueStore, LocalKeyValueStore, RemoteKeyValueStore } from '@bessemer/cornerstone/store';
+import { Duration } from '@bessemer/cornerstone/duration';
+import { ResourceKey, ResourceNamespace } from '@bessemer/cornerstone/resource';
+import { AbstractApplicationContext } from '@bessemer/cornerstone/context';
+import { NominalType } from '@bessemer/cornerstone/types';
+import { Entry } from '@bessemer/cornerstone/entry';
+import { GlobPattern } from '@bessemer/cornerstone/glob';
+import { Arrayable } from 'type-fest';
+import { ZodType } from 'zod';
+export type CacheProps = {
+    maxSize: number | null;
+    timeToLive: Duration;
+    timeToStale: Duration | null;
+};
+export type CacheOptions = Partial<CacheProps>;
+export declare namespace CacheProps {
+    const buildCacheProps: (options?: CacheOptions) => CacheProps;
+}
+export declare namespace CacheKey {
+    const disableCaching: () => ResourceNamespace;
+    const isDisabled: (key: ResourceNamespace) => boolean;
+}
+export type CacheSector = {
+    globs: Array<GlobPattern>;
+};
+export declare namespace CacheSector {
+    const of: (globs: Arrayable<GlobPattern>) => {
+        globs: GlobPattern[];
+    };
+    const namespace: (namespace: ResourceNamespace, sector: CacheSector) => CacheSector;
+}
+export type CacheName = NominalType<string, 'CacheName'>;
+export declare const CacheNameSchema: ZodType<CacheName>;
+export interface AbstractCache<T> {
+    name: CacheName;
+}
+export interface Cache<T> extends AbstractCache<T> {
+    fetchValue(namespace: ResourceNamespace, key: ResourceKey, fetch: () => Promise<T>): Promise<T>;
+    fetchValues(namespace: ResourceNamespace, keys: Array<ResourceKey>, fetch: (keys: Array<ResourceKey>) => Promise<Array<Entry<T>>>): Promise<Array<Entry<T>>>;
+    writeValue(namespace: ResourceNamespace, key: ResourceKey, value: T | undefined): Promise<void>;
+    writeValues(namespace: ResourceNamespace, entries: Array<Entry<T | undefined>>): Promise<void>;
+    evictAll(sector: CacheSector): Promise<void>;
+}
+export interface CacheProvider<T> extends RemoteKeyValueStore<CacheEntry<T>> {
+    type: CacheProviderType;
+    evictAll(sector: CacheSector): Promise<void>;
+}
+export declare abstract class AbstractCacheProvider<T> extends AbstractRemoteKeyValueStore<CacheEntry<T>> implements CacheProvider<T> {
+    abstract type: CacheProviderType;
+    abstract evictAll(sector: CacheSector): Promise<void>;
+}
+export interface LocalCache<T> extends AbstractCache<T> {
+    getValue(namespace: ResourceNamespace, key: ResourceKey, fetch: () => T): T;
+    getValues(namespace: ResourceNamespace, keys: Array<ResourceKey>, fetch: (keys: Array<ResourceKey>) => Array<Entry<T>>): Array<Entry<T>>;
+    setValue(namespace: ResourceNamespace, key: ResourceKey, value: T | undefined): void;
+    setValues(namespace: ResourceNamespace, entries: Array<Entry<T | undefined>>): void;
+    removeAll(sector: CacheSector): void;
+}
+export interface LocalCacheProvider<T> extends LocalKeyValueStore<CacheEntry<T>>, CacheProvider<T> {
+    removeAll(sector: CacheSector): void;
+}
+export declare abstract class AbstractLocalCacheProvider<T> extends AbstractLocalKeyValueStore<CacheEntry<T>> implements LocalCacheProvider<T> {
+    abstract type: CacheProviderType;
+    abstract removeAll(sector: CacheSector): void;
+    evictAll(sector: CacheSector): Promise<void>;
+}
+export type CacheEntry<T> = {
+    value: T;
+    liveTimestamp: Date | null;
+    staleTimestamp: Date | null;
+};
+export declare namespace CacheEntry {
+    const isActive: <T>(entry: CacheEntry<T>) => boolean;
+    const isDead: <T>(entry: CacheEntry<T> | undefined) => boolean;
+    const isAlive: <T>(entry: CacheEntry<T> | undefined) => boolean;
+    const isStale: <T>(entry: CacheEntry<T>) => boolean;
+    const of: <T>(value: T) => CacheEntry<T>;
+    const applyProps: <T>(originalEntry: CacheEntry<T>, props: CacheProps) => CacheEntry<T>;
+}
+export type CacheConfigurationOptions = CacheConfigurationSection & {
+    local: CacheConfigurationSection;
+};
+export type CacheConfigurationSection = {
+    defaults: CacheDefinition;
+    /**
+     * These options map from cache name key to configuration. They are a way for the tenant to override the configurations
+     * for specific caches from the cache configuration here.
+     */
+    caches?: Record<string, Partial<CacheDefinition>>;
+};
+export type CacheDefinition = {
+    options?: CacheOptions;
+    providers: Array<CacheProviderConfiguration>;
+};
+export type CacheProviderType = NominalType<string, 'CacheProviderType'>;
+export type CacheProviderConfiguration = CacheOptions & {
+    type: CacheProviderType;
+};
+export type CacheConfiguration = CacheConfigurationSection & {
+    local: CacheConfigurationSection;
+};
+export type CacheProviderRegistry<ContextType extends AbstractApplicationContext> = {
+    type: CacheProviderType;
+    construct: <T>(props: CacheProps, context: ContextType) => CacheProvider<T>;
+};
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/cache.js

@@ -0,0 +1,112 @@
+// src/cache.ts
+import { AbstractLocalKeyValueStore, AbstractRemoteKeyValueStore } from "@bessemer/cornerstone/store";
+import { Arrays, Dates, Durations, Objects, Strings, Zod } from "@bessemer/cornerstone";
+import { ResourceKey } from "@bessemer/cornerstone/resource";
+var CacheProps;
+((CacheProps2) => {
+  const DefaultCacheProps = {
+    maxSize: 5e4,
+    timeToLive: Durations.OneDay,
+    timeToStale: Durations.OneHour
+  };
+  CacheProps2.buildCacheProps = (options) => {
+    options = options ?? {};
+    const props = Objects.merge(DefaultCacheProps, options);
+    if (props.maxSize === null && props.timeToLive === null) {
+      throw new Error("Invalid cache configuration, both maxSize and timeToLive are null");
+    }
+    return props;
+  };
+})(CacheProps || (CacheProps = {}));
+var CacheKey;
+((CacheKey2) => {
+  const DisableCacheToken = "f6822c1a-d527-4c65-b9dd-ddc24620b684";
+  CacheKey2.disableCaching = () => {
+    return DisableCacheToken;
+  };
+  CacheKey2.isDisabled = (key) => {
+    return Strings.contains(key, DisableCacheToken);
+  };
+})(CacheKey || (CacheKey = {}));
+var CacheSector;
+((CacheSector2) => {
+  CacheSector2.of = (globs) => {
+    return { globs: Arrays.toArray(globs) };
+  };
+  CacheSector2.namespace = (namespace2, sector) => {
+    return { globs: ResourceKey.namespaceAll(namespace2, sector.globs) };
+  };
+})(CacheSector || (CacheSector = {}));
+var CacheNameSchema = Zod.string();
+var AbstractCacheProvider = class extends AbstractRemoteKeyValueStore {
+};
+var AbstractLocalCacheProvider = class extends AbstractLocalKeyValueStore {
+  async evictAll(sector) {
+    this.removeAll(sector);
+  }
+};
+var CacheEntry;
+((CacheEntry2) => {
+  CacheEntry2.isActive = (entry) => {
+    if ((0, CacheEntry2.isDead)(entry) || (0, CacheEntry2.isStale)(entry)) {
+      return false;
+    }
+    return true;
+  };
+  CacheEntry2.isDead = (entry) => {
+    if (Objects.isNil(entry)) {
+      return true;
+    }
+    if (Objects.isNil(entry.liveTimestamp)) {
+      return false;
+    }
+    return Dates.isBefore(entry.liveTimestamp, Dates.now());
+  };
+  CacheEntry2.isAlive = (entry) => !(0, CacheEntry2.isDead)(entry);
+  CacheEntry2.isStale = (entry) => {
+    if (Objects.isNil(entry.staleTimestamp)) {
+      return false;
+    }
+    return Dates.isBefore(entry.staleTimestamp, Dates.now());
+  };
+  CacheEntry2.of = (value) => {
+    const entry = {
+      value,
+      liveTimestamp: null,
+      staleTimestamp: null
+    };
+    return entry;
+  };
+  CacheEntry2.applyProps = (originalEntry, props) => {
+    let liveTimestamp = originalEntry.liveTimestamp;
+    if (!Objects.isNil(props.timeToLive)) {
+      const limit = Dates.addMilliseconds(Dates.now(), Durations.inMilliseconds(props.timeToLive));
+      if (Dates.isBefore(limit, liveTimestamp ?? limit)) {
+        liveTimestamp = limit;
+      }
+    }
+    let staleTimestamp = originalEntry.staleTimestamp;
+    if (!Objects.isNil(props.timeToStale)) {
+      const limit = Dates.addMilliseconds(Dates.now(), Durations.inMilliseconds(props.timeToStale));
+      if (Dates.isBefore(limit, staleTimestamp ?? limit)) {
+        staleTimestamp = limit;
+      }
+    }
+    const limitedEntry = {
+      value: originalEntry.value,
+      liveTimestamp,
+      staleTimestamp
+    };
+    return limitedEntry;
+  };
+})(CacheEntry || (CacheEntry = {}));
+export {
+  AbstractCacheProvider,
+  AbstractLocalCacheProvider,
+  CacheEntry,
+  CacheKey,
+  CacheNameSchema,
+  CacheProps,
+  CacheSector
+};
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts"],"sourcesContent":["import { AbstractLocalKeyValueStore, AbstractRemoteKeyValueStore, LocalKeyValueStore, RemoteKeyValueStore } from '@bessemer/cornerstone/store'\nimport { Arrays, Dates, Durations, Objects, Strings, Zod } from '@bessemer/cornerstone'\nimport { Duration } from '@bessemer/cornerstone/duration'\nimport { ResourceKey, ResourceNamespace } from '@bessemer/cornerstone/resource'\nimport { AbstractApplicationContext } from '@bessemer/cornerstone/context'\nimport { NominalType } from '@bessemer/cornerstone/types'\nimport { Entry } from '@bessemer/cornerstone/entry'\nimport { GlobPattern } from '@bessemer/cornerstone/glob'\nimport { Arrayable } from 'type-fest'\nimport { ZodType } from 'zod'\n\n// JOHN should this even be in cornerstone? especially consider the config types down at the bottom\n\nexport type CacheProps = {\n  maxSize: number | null\n  timeToLive: Duration\n  timeToStale: Duration | null\n}\n\nexport type CacheOptions = Partial<CacheProps>\n\nexport namespace CacheProps {\n  const DefaultCacheProps = {\n    maxSize: 50000,\n    timeToLive: Durations.OneDay,\n    timeToStale: Durations.OneHour,\n  }\n\n  export const buildCacheProps = (options?: CacheOptions): CacheProps => {\n    options = options ?? {}\n\n    const props = Objects.merge(DefaultCacheProps, options)\n\n    if (props.maxSize === null && props.timeToLive === null) {\n      throw new Error('Invalid cache configuration, both maxSize and timeToLive are null')\n    }\n\n    return props\n  }\n}\n\nexport namespace CacheKey {\n  // We use a hardcoded UUID to represent a unique token value that serves as a flag to disable caching\n  const DisableCacheToken = 'f6822c1a-d527-4c65-b9dd-ddc24620b684'\n\n  export const disableCaching = (): ResourceNamespace => {\n    return DisableCacheToken\n  }\n\n  export const isDisabled = (key: ResourceNamespace): boolean => {\n    return Strings.contains(key, DisableCacheToken)\n  }\n}\n\nexport type CacheSector = {\n  globs: Array<GlobPattern>\n}\n\nexport namespace CacheSector {\n  export const of = (globs: Arrayable<GlobPattern>) => {\n    return { globs: Arrays.toArray(globs) }\n  }\n\n  export const namespace = (namespace: ResourceNamespace, sector: CacheSector): CacheSector => {\n    return { globs: ResourceKey.namespaceAll(namespace, sector.globs) }\n  }\n}\n\nexport type CacheName = NominalType<string, 'CacheName'>\nexport const CacheNameSchema: ZodType<CacheName> = Zod.string()\n\nexport interface AbstractCache<T> {\n  name: CacheName\n}\n\nexport interface Cache<T> extends AbstractCache<T> {\n  fetchValue(namespace: ResourceNamespace, key: ResourceKey, fetch: () => Promise<T>): Promise<T>\n\n  fetchValues(\n    namespace: ResourceNamespace,\n    keys: Array<ResourceKey>,\n    fetch: (keys: Array<ResourceKey>) => Promise<Array<Entry<T>>>\n  ): Promise<Array<Entry<T>>>\n\n  writeValue(namespace: ResourceNamespace, key: ResourceKey, value: T | undefined): Promise<void>\n\n  writeValues(namespace: ResourceNamespace, entries: Array<Entry<T | undefined>>): Promise<void>\n\n  evictAll(sector: CacheSector): Promise<void>\n}\n\nexport interface CacheProvider<T> extends RemoteKeyValueStore<CacheEntry<T>> {\n  type: CacheProviderType\n\n  evictAll(sector: CacheSector): Promise<void>\n}\n\nexport abstract class AbstractCacheProvider<T> extends AbstractRemoteKeyValueStore<CacheEntry<T>> implements CacheProvider<T> {\n  abstract type: CacheProviderType\n\n  abstract evictAll(sector: CacheSector): Promise<void>\n}\n\nexport interface LocalCache<T> extends AbstractCache<T> {\n  getValue(namespace: ResourceNamespace, key: ResourceKey, fetch: () => T): T\n\n  getValues(namespace: ResourceNamespace, keys: Array<ResourceKey>, fetch: (keys: Array<ResourceKey>) => Array<Entry<T>>): Array<Entry<T>>\n\n  setValue(namespace: ResourceNamespace, key: ResourceKey, value: T | undefined): void\n\n  setValues(namespace: ResourceNamespace, entries: Array<Entry<T | undefined>>): void\n\n  removeAll(sector: CacheSector): void\n}\n\nexport interface LocalCacheProvider<T> extends LocalKeyValueStore<CacheEntry<T>>, CacheProvider<T> {\n  removeAll(sector: CacheSector): void\n}\n\nexport abstract class AbstractLocalCacheProvider<T> extends AbstractLocalKeyValueStore<CacheEntry<T>> implements LocalCacheProvider<T> {\n  abstract type: CacheProviderType\n\n  abstract removeAll(sector: CacheSector): void\n\n  async evictAll(sector: CacheSector): Promise<void> {\n    this.removeAll(sector)\n  }\n}\n\nexport type CacheEntry<T> = {\n  value: T\n  liveTimestamp: Date | null\n  staleTimestamp: Date | null\n}\n\nexport namespace CacheEntry {\n  export const isActive = <T>(entry: CacheEntry<T>): boolean => {\n    if (isDead(entry) || isStale(entry)) {\n      return false\n    }\n\n    return true\n  }\n\n  export const isDead = <T>(entry: CacheEntry<T> | undefined): boolean => {\n    if (Objects.isNil(entry)) {\n      return true\n    }\n\n    if (Objects.isNil(entry.liveTimestamp)) {\n      return false\n    }\n\n    return Dates.isBefore(entry.liveTimestamp, Dates.now())\n  }\n\n  export const isAlive = <T>(entry: CacheEntry<T> | undefined): boolean => !isDead(entry)\n\n  export const isStale = <T>(entry: CacheEntry<T>): boolean => {\n    if (Objects.isNil(entry.staleTimestamp)) {\n      return false\n    }\n\n    return Dates.isBefore(entry.staleTimestamp, Dates.now())\n  }\n\n  export const of = <T>(value: T) => {\n    const entry: CacheEntry<T> = {\n      value,\n      liveTimestamp: null,\n      staleTimestamp: null,\n    }\n\n    return entry\n  }\n\n  // JOHN do we want to enforce some kind of minimum liveness threshold?\n  export const applyProps = <T>(originalEntry: CacheEntry<T>, props: CacheProps): CacheEntry<T> => {\n    let liveTimestamp: Date | null = originalEntry.liveTimestamp\n    if (!Objects.isNil(props.timeToLive)) {\n      const limit = Dates.addMilliseconds(Dates.now(), Durations.inMilliseconds(props.timeToLive))\n      if (Dates.isBefore(limit, liveTimestamp ?? limit)) {\n        liveTimestamp = limit\n      }\n    }\n\n    let staleTimestamp: Date | null = originalEntry.staleTimestamp\n    if (!Objects.isNil(props.timeToStale)) {\n      const limit = Dates.addMilliseconds(Dates.now(), Durations.inMilliseconds(props.timeToStale))\n      if (Dates.isBefore(limit, staleTimestamp ?? limit)) {\n        staleTimestamp = limit\n      }\n    }\n\n    const limitedEntry: CacheEntry<T> = {\n      value: originalEntry.value,\n      liveTimestamp,\n      staleTimestamp,\n    }\n\n    return limitedEntry\n  }\n}\n\nexport type CacheConfigurationOptions = CacheConfigurationSection & {\n  local: CacheConfigurationSection\n}\n\nexport type CacheConfigurationSection = {\n  defaults: CacheDefinition\n\n  /**\n   * These options map from cache name key to configuration. They are a way for the tenant to override the configurations\n   * for specific caches from the cache configuration here.\n   */\n  caches?: Record<string, Partial<CacheDefinition>>\n}\n\nexport type CacheDefinition = {\n  options?: CacheOptions\n  providers: Array<CacheProviderConfiguration>\n}\n\nexport type CacheProviderType = NominalType<string, 'CacheProviderType'>\nexport type CacheProviderConfiguration = CacheOptions & {\n  type: CacheProviderType\n}\n\nexport type CacheConfiguration = CacheConfigurationSection & {\n  local: CacheConfigurationSection\n}\n\nexport type CacheProviderRegistry<ContextType extends AbstractApplicationContext> = {\n  type: CacheProviderType\n  construct: <T>(props: CacheProps, context: ContextType) => CacheProvider<T>\n}\n"],"mappings":"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","names":["CacheProps","CacheKey","CacheSector","namespace","CacheEntry"]}

package/dist/combinable.d.ts

@@ -0,0 +1,16 @@
+export interface Combinable {
+    combinability: Combinability;
+}
+export type Combinability = {
+    type: CombinabilityType;
+    class: CombinabilityClass;
+};
+export declare enum CombinabilityType {
+    Stackable = "Stackable",
+    Singleton = "Singleton",
+    Totalitarian = "Totalitarian"
+}
+export type CombinabilityClass = string | null;
+export declare const DefaultCombinability: Combinability;
+export declare const combinations: <T extends Combinable>(combinables: Array<T>) => Array<Array<T>>;
+//# sourceMappingURL=combinable.d.ts.map

package/dist/combinable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinable.d.ts","sourceRoot":"","sources":["../src/combinable.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,aAAa,CAAA;CAC7B;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,kBAAkB,CAAA;CAC1B,CAAA;AAED,oBAAY,iBAAiB;IAC3B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAAA;AAE9C,eAAO,MAAM,oBAAoB,EAAE,aAGlC,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,UAAU,EAAE,aAAa,KAAK,CAAC,CAAC,CAAC,KAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAexF,CAAA"}