@appsemble/utils 0.20.8 → 0.20.11

package/miscellaneous.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripNullValues = exports.rethrow = exports.identity = void 0;
+/**
+ * Return the input data.
+ *
+ * @param data The data to return.
+ * @returns The input data.
+ */
+function identity(data) {
+    return data;
+}
+exports.identity = identity;
+/**
+ * Throw the input data.
+ *
+ * @param data The data to throw.
+ * @throws The input data.
+ */
+function rethrow(data) {
+    throw data;
+}
+exports.rethrow = rethrow;
+/**
+ * Strip all null, undefined, and empty array values from an object.
+ *
+ * @param value The value to strip.
+ * @param options Additional options for stripping null values.
+ * @returns A copy of the input, but with all nullish values removed recursively.
+ */
+function stripNullValues(value, { depth = Number.POSITIVE_INFINITY, ...options } = {}) {
+    if (value == null) {
+        return;
+    }
+    if (typeof value !== 'object') {
+        return value;
+    }
+    if (depth <= 0) {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        const result = [];
+        for (const val of value) {
+            if (val != null) {
+                result.push(stripNullValues(val, { depth: depth - 1, ...options }));
+            }
+        }
+        return result;
+    }
+    const result = {};
+    for (const [key, val] of Object.entries(value)) {
+        if (val != null) {
+            result[key] = stripNullValues(val, { depth: depth - 1, ...options });
+        }
+    }
+    return result;
+}
+exports.stripNullValues = stripNullValues;
+//# sourceMappingURL=miscellaneous.js.map

package/miscellaneous.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miscellaneous.js","sourceRoot":"","sources":["miscellaneous.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,SAAgB,QAAQ,CAAI,IAAO;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAFD,4BAEC;AAED;;;;;GAKG;AACH,SAAgB,OAAO,CAAC,IAAa;IACnC,MAAM,IAAI,CAAC;AACb,CAAC;AAFD,0BAEC;AAWD;;;;;;GAMG;AACH,SAAgB,eAAe,CAC7B,KAAc,EACd,EAAE,KAAK,GAAG,MAAM,CAAC,iBAAiB,EAAE,GAAG,OAAO,KAA6B,EAAE;IAE7E,IAAI,KAAK,IAAI,IAAI,EAAE;QACjB,OAAO;KACR;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;QAC7B,OAAO,KAAK,CAAC;KACd;IAED,IAAI,KAAK,IAAI,CAAC,EAAE;QACd,OAAO,KAAK,CAAC;KACd;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACxB,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE;YACvB,IAAI,GAAG,IAAI,IAAI,EAAE;gBACf,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;aACrE;SACF;QACD,OAAO,MAAM,CAAC;KACf;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QAC9C,IAAI,GAAG,IAAI,IAAI,EAAE;YACf,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;SACtE;KACF;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAjCD,0CAiCC"}

package/miscellaneous.test.d.ts

@@ -0,0 +1 @@
+export {};

package/miscellaneous.test.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const miscellaneous_1 = require("./miscellaneous");
+/**
+ * Return the input data.
+ *
+ * @param data The data to return.
+ * @returns The input data.
+ */
+describe('identity', () => {
+    it('should return the input data', () => {
+        const input = {};
+        expect((0, miscellaneous_1.identity)(input)).toBe(input);
+    });
+});
+/**
+ * Throw the input data.
+ *
+ * @param data The data to throw.
+ * @throws The input data.
+ */
+describe('rethrow', () => {
+    it('should throw the input data', () => {
+        expect(() => (0, miscellaneous_1.rethrow)('Test')).toThrow('Test');
+    });
+});
+describe('stripNullValues', () => {
+    it('should convert null to undefined', () => {
+        const input = null;
+        expect((0, miscellaneous_1.stripNullValues)(input)).toBeUndefined();
+    });
+    it('should return raw primitives', () => {
+        const input = 42;
+        expect((0, miscellaneous_1.stripNullValues)(input)).toBe(42);
+    });
+    it('should remove empty, undefined, and null from arrays', () => {
+        const input = [, undefined, null];
+        expect((0, miscellaneous_1.stripNullValues)(input)).toStrictEqual([]);
+    });
+    it('should remove undefined, and null values from objects', () => {
+        const input = {
+            foo: null,
+            bar: undefined,
+            baz: 42,
+        };
+        expect((0, miscellaneous_1.stripNullValues)(input)).toStrictEqual({ baz: 42 });
+    });
+    it('should remove empty, undefined, and null values recursively', () => {
+        const input = {
+            foo: {
+                bar: {
+                    fooz: null,
+                    baz: [, undefined, null],
+                },
+            },
+        };
+        expect((0, miscellaneous_1.stripNullValues)(input)).toStrictEqual({ foo: { bar: { baz: [] } } });
+    });
+    it('should respect depth for objects', () => {
+        const input = {
+            foo: {
+                bar: {
+                    asd: null,
+                },
+                baz: null,
+            },
+            fooz: null,
+        };
+        expect((0, miscellaneous_1.stripNullValues)(input, { depth: 2 })).toStrictEqual({ foo: { bar: { asd: null } } });
+    });
+    it('should respect depth for arrays', () => {
+        const input = [null, [null, [null]]];
+        expect((0, miscellaneous_1.stripNullValues)(input, { depth: 2 })).toStrictEqual([[[null]]]);
+    });
+});
+//# sourceMappingURL=miscellaneous.test.js.map

package/miscellaneous.test.js.map

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

package/miscellaneous.test.ts

@@ -0,0 +1,82 @@
+import { identity, rethrow, stripNullValues } from './miscellaneous';
+
+/**
+ * Return the input data.
+ *
+ * @param data The data to return.
+ * @returns The input data.
+ */
+describe('identity', () => {
+  it('should return the input data', () => {
+    const input = {};
+    expect(identity(input)).toBe(input);
+  });
+});
+
+/**
+ * Throw the input data.
+ *
+ * @param data The data to throw.
+ * @throws The input data.
+ */
+describe('rethrow', () => {
+  it('should throw the input data', () => {
+    expect(() => rethrow('Test')).toThrow('Test');
+  });
+});
+
+describe('stripNullValues', () => {
+  it('should convert null to undefined', () => {
+    const input: unknown = null;
+    expect(stripNullValues(input)).toBeUndefined();
+  });
+
+  it('should return raw primitives', () => {
+    const input = 42;
+    expect(stripNullValues(input)).toBe(42);
+  });
+
+  it('should remove empty, undefined, and null from arrays', () => {
+    const input: unknown = [, undefined, null];
+    expect(stripNullValues(input)).toStrictEqual([]);
+  });
+
+  it('should remove undefined, and null values from objects', () => {
+    const input: unknown = {
+      foo: null,
+      bar: undefined,
+      baz: 42,
+    };
+    expect(stripNullValues(input)).toStrictEqual({ baz: 42 });
+  });
+
+  it('should remove empty, undefined, and null values recursively', () => {
+    const input: unknown = {
+      foo: {
+        bar: {
+          fooz: null,
+          baz: [, undefined, null],
+        },
+      },
+    };
+    expect(stripNullValues(input)).toStrictEqual({ foo: { bar: { baz: [] } } });
+  });
+
+  it('should respect depth for objects', () => {
+    const input: unknown = {
+      foo: {
+        bar: {
+          asd: null,
+        },
+        baz: null,
+      },
+      fooz: null,
+    };
+    expect(stripNullValues(input, { depth: 2 })).toStrictEqual({ foo: { bar: { asd: null } } });
+  });
+
+  it('should respect depth for arrays', () => {
+    const input: unknown = [null, [null, [null]]];
+    expect(stripNullValues(input, { depth: 2 })).toStrictEqual([[[null]]]);
+  });
+});

package/miscellaneous.ts

@@ -0,0 +1,70 @@
+/**
+ * Return the input data.
+ *
+ * @param data The data to return.
+ * @returns The input data.
+ */
+export function identity<T>(data: T): T {
+  return data;
+}
+
+/**
+ * Throw the input data.
+ *
+ * @param data The data to throw.
+ * @throws The input data.
+ */
+export function rethrow(data: unknown): never {
+  throw data;
+}
+
+export interface StripNullValuesOptions {
+  /**
+   * How deep to recurse into objects and arrays to remove null values.
+   *
+   * @default Infinity
+   */
+  depth?: number;
+}
+
+/**
+ * Strip all null, undefined, and empty array values from an object.
+ *
+ * @param value The value to strip.
+ * @param options Additional options for stripping null values.
+ * @returns A copy of the input, but with all nullish values removed recursively.
+ */
+export function stripNullValues(
+  value: unknown,
+  { depth = Number.POSITIVE_INFINITY, ...options }: StripNullValuesOptions = {},
+): unknown {
+  if (value == null) {
+    return;
+  }
+
+  if (typeof value !== 'object') {
+    return value;
+  }
+
+  if (depth <= 0) {
+    return value;
+  }
+
+  if (Array.isArray(value)) {
+    const result: unknown[] = [];
+    for (const val of value) {
+      if (val != null) {
+        result.push(stripNullValues(val, { depth: depth - 1, ...options }));
+      }
+    }
+    return result;
+  }
+
+  const result: Record<string, unknown> = {};
+  for (const [key, val] of Object.entries(value)) {
+    if (val != null) {
+      result[key] = stripNullValues(val, { depth: depth - 1, ...options });
+    }
+  }
+  return result;
+}

package/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["noop.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,gEAAgE;AAChE,SAAgB,IAAI,KAAU,CAAC;AAA/B,oBAA+B"}

package/noop.ts

@@ -0,0 +1,5 @@
+/**
+ * Do nothing.
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+export function noop(): void {}

package/normalize.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Turn a string into a URL friendly variant by stripping any weird formatting.
+ *
+ * - Accents are stripped;
+ * - Non-alphanumeric is replaced with a hyphen;
+ * - The resulting string is lower case.
+ *
+ * @param input The input string to normalize.
+ * @param stripTrailingHyphen Strip a trailing hyphen. Disable for example when processing user
+ * input directly while the user is typing.
+ * @returns The normalized string.
+ */
+export declare function normalize(input: string, stripTrailingHyphen?: boolean): string;

package/normalize.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalize = void 0;
+/**
+ * Turn a string into a URL friendly variant by stripping any weird formatting.
+ *
+ * - Accents are stripped;
+ * - Non-alphanumeric is replaced with a hyphen;
+ * - The resulting string is lower case.
+ *
+ * @param input The input string to normalize.
+ * @param stripTrailingHyphen Strip a trailing hyphen. Disable for example when processing user
+ * input directly while the user is typing.
+ * @returns The normalized string.
+ */
+function normalize(input, stripTrailingHyphen = true) {
+    const normalized = input
+        // Normalize accents. https://stackoverflow.com/a/37511463/1154610
+        .normalize('NFD')
+        .replace(/[\u0300-\u036F]/g, '')
+        // Make it lower case.
+        .toLowerCase()
+        // Replace any non-alphanumeric with single hyphens them at the start.
+        .replace(/[^\da-z]+/g, (match, index) => (index ? '-' : ''));
+    return stripTrailingHyphen ? normalized.replace(/-$/, '') : normalized;
+}
+exports.normalize = normalize;
+//# sourceMappingURL=normalize.js.map

package/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["normalize.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,SAAgB,SAAS,CAAC,KAAa,EAAE,mBAAmB,GAAG,IAAI;IACjE,MAAM,UAAU,GAAG,KAAK;QACtB,kEAAkE;SACjE,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAChC,sBAAsB;SACrB,WAAW,EAAE;QACd,sEAAsE;SACrE,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,OAAO,mBAAmB,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AACzE,CAAC;AAVD,8BAUC"}

package/normalize.test.d.ts

@@ -0,0 +1 @@
+export {};

package/normalize.test.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const normalize_1 = require("./normalize");
+const fixtures = [
+    ['Foo', 'foo'],
+    ['A somewhat long sentence.', 'a-somewhat-long-sentence'],
+    ['Ĺòt’s øf wəìŕð ćĥâṙąçṫœ®ş', 'lot-s-f-w-ir-charact-s'],
+    ['I___contain_underscores', 'i-contain-underscores'],
+    ['many----hyphens', 'many-hyphens'],
+    ['includes.dot', 'includes-dot'],
+    ['trailing-hyphen-', 'trailing-hyphen'],
+    ['0123456789 digits', '0123456789-digits'],
+    ['-leading-hyphen', 'leading-hyphen'],
+    ['*-multiple-leading-non-word-characters', 'multiple-leading-non-word-characters'],
+];
+it.each(fixtures)('should turn “%s” into “%s”', (actual, expected) => {
+    const result = (0, normalize_1.normalize)(actual);
+    expect(result).toBe(expected);
+});
+it('should have an option to not support a trailing hyphen', () => {
+    const result = (0, normalize_1.normalize)('trailing-hyphen-', false);
+    expect(result).toBe('trailing-hyphen-');
+});
+//# sourceMappingURL=normalize.test.js.map

package/normalize.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.test.js","sourceRoot":"","sources":["normalize.test.ts"],"names":[],"mappings":";;AAAA,2CAAwC;AAExC,MAAM,QAAQ,GAAG;IACf,CAAC,KAAK,EAAE,KAAK,CAAC;IACd,CAAC,2BAA2B,EAAE,0BAA0B,CAAC;IACzD,CAAC,2BAA2B,EAAE,wBAAwB,CAAC;IACvD,CAAC,yBAAyB,EAAE,uBAAuB,CAAC;IACpD,CAAC,iBAAiB,EAAE,cAAc,CAAC;IACnC,CAAC,cAAc,EAAE,cAAc,CAAC;IAChC,CAAC,kBAAkB,EAAE,iBAAiB,CAAC;IACvC,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAC1C,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IACrC,CAAC,wCAAwC,EAAE,sCAAsC,CAAC;CACnF,CAAC;AAEF,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,4BAA4B,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;IACnE,MAAM,MAAM,GAAG,IAAA,qBAAS,EAAC,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;IAChE,MAAM,MAAM,GAAG,IAAA,qBAAS,EAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC"}

package/normalize.test.ts

@@ -0,0 +1,24 @@
+import { normalize } from './normalize';
+
+const fixtures = [
+  ['Foo', 'foo'],
+  ['A somewhat long sentence.', 'a-somewhat-long-sentence'],
+  ['Ĺòt’s øf wəìŕð ćĥâṙąçṫœ®ş', 'lot-s-f-w-ir-charact-s'],
+  ['I___contain_underscores', 'i-contain-underscores'],
+  ['many----hyphens', 'many-hyphens'],
+  ['includes.dot', 'includes-dot'],
+  ['trailing-hyphen-', 'trailing-hyphen'],
+  ['0123456789 digits', '0123456789-digits'],
+  ['-leading-hyphen', 'leading-hyphen'],
+  ['*-multiple-leading-non-word-characters', 'multiple-leading-non-word-characters'],
+];
+
+it.each(fixtures)('should turn “%s” into “%s”', (actual, expected) => {
+  const result = normalize(actual);
+  expect(result).toBe(expected);
+});
+
+it('should have an option to not support a trailing hyphen', () => {
+  const result = normalize('trailing-hyphen-', false);
+  expect(result).toBe('trailing-hyphen-');
+});

package/normalize.ts

@@ -0,0 +1,23 @@
+/**
+ * Turn a string into a URL friendly variant by stripping any weird formatting.
+ *
+ * - Accents are stripped;
+ * - Non-alphanumeric is replaced with a hyphen;
+ * - The resulting string is lower case.
+ *
+ * @param input The input string to normalize.
+ * @param stripTrailingHyphen Strip a trailing hyphen. Disable for example when processing user
+ * input directly while the user is typing.
+ * @returns The normalized string.
+ */
+export function normalize(input: string, stripTrailingHyphen = true): string {
+  const normalized = input
+    // Normalize accents. https://stackoverflow.com/a/37511463/1154610
+    .normalize('NFD')
+    .replace(/[\u0300-\u036F]/g, '')
+    // Make it lower case.
+    .toLowerCase()
+    // Replace any non-alphanumeric with single hyphens them at the start.
+    .replace(/[^\da-z]+/g, (match, index) => (index ? '-' : ''));
+  return stripTrailingHyphen ? normalized.replace(/-$/, '') : normalized;
+}

package/objectCache.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Create a function for memoizing values.
+ *
+ * The cache accepts a favtory function which is used for creating a value. If cache is called with
+ * the value, the factory is called and the returned value is memoized. If the cache is called with
+ * the same value again, the memoized value is returned.
+ *
+ * @param factory The function that generats new values if necessary.
+ * @returns A getter funcion which returns the generated or memoized value.
+ */
+export declare function objectCache<T, K = string>(factory: (id: K) => T): (id: K) => T;

package/objectCache.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectCache = void 0;
+/**
+ * Create a function for memoizing values.
+ *
+ * The cache accepts a favtory function which is used for creating a value. If cache is called with
+ * the value, the factory is called and the returned value is memoized. If the cache is called with
+ * the same value again, the memoized value is returned.
+ *
+ * @param factory The function that generats new values if necessary.
+ * @returns A getter funcion which returns the generated or memoized value.
+ */
+function objectCache(factory) {
+    const cache = new Map();
+    return (id) => {
+        if (cache.has(id)) {
+            return cache.get(id);
+        }
+        const item = factory(id);
+        cache.set(id, item);
+        return item;
+    };
+}
+exports.objectCache = objectCache;
+//# sourceMappingURL=objectCache.js.map

package/objectCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectCache.js","sourceRoot":"","sources":["objectCache.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,SAAgB,WAAW,CAAgB,OAAqB;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAQ,CAAC;IAE9B,OAAO,CAAC,EAAE,EAAE,EAAE;QACZ,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YACjB,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACtB;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAXD,kCAWC"}

package/objectCache.test.d.ts

@@ -0,0 +1 @@
+export {};

package/objectCache.test.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const objectCache_1 = require("./objectCache");
+describe('objectCache', () => {
+    it('should cache reslts', () => {
+        let count = 0;
+        const cache = (0, objectCache_1.objectCache)((id) => {
+            count += 1;
+            return { id, count };
+        });
+        const a = cache('a');
+        expect(a).toStrictEqual({ id: 'a', count: 1 });
+        const b = cache('b');
+        expect(b).toStrictEqual({ id: 'b', count: 2 });
+        expect(b).not.toBe(a);
+        const c = cache('a');
+        expect(c).toStrictEqual({ id: 'a', count: 1 });
+        expect(c).toBe(a);
+    });
+});
+//# sourceMappingURL=objectCache.test.js.map

package/objectCache.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectCache.test.js","sourceRoot":"","sources":["objectCache.test.ts"],"names":[],"mappings":";;AAAA,+CAA4C;AAE5C,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,KAAK,GAAG,IAAA,yBAAW,EAAC,CAAC,EAAE,EAAE,EAAE;YAC/B,KAAK,IAAI,CAAC,CAAC;YACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/objectCache.test.ts

@@ -0,0 +1,19 @@
+import { objectCache } from './objectCache';
+
+describe('objectCache', () => {
+  it('should cache reslts', () => {
+    let count = 0;
+    const cache = objectCache((id) => {
+      count += 1;
+      return { id, count };
+    });
+    const a = cache('a');
+    expect(a).toStrictEqual({ id: 'a', count: 1 });
+    const b = cache('b');
+    expect(b).toStrictEqual({ id: 'b', count: 2 });
+    expect(b).not.toBe(a);
+    const c = cache('a');
+    expect(c).toStrictEqual({ id: 'a', count: 1 });
+    expect(c).toBe(a);
+  });
+});

package/objectCache.ts

@@ -0,0 +1,22 @@
+/**
+ * Create a function for memoizing values.
+ *
+ * The cache accepts a favtory function which is used for creating a value. If cache is called with
+ * the value, the factory is called and the returned value is memoized. If the cache is called with
+ * the same value again, the memoized value is returned.
+ *
+ * @param factory The function that generats new values if necessary.
+ * @returns A getter funcion which returns the generated or memoized value.
+ */
+export function objectCache<T, K = string>(factory: (id: K) => T): (id: K) => T {
+  const cache = new Map<K, T>();
+
+  return (id) => {
+    if (cache.has(id)) {
+      return cache.get(id);
+    }
+    const item = factory(id);
+    cache.set(id, item);
+    return item;
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsemble/utils",
-  "version": "0.20.8",
+  "version": "0.20.11",
   "description": "Utility functions used in Appsemble internally",
   "keywords": [
     "app",
@@ -20,27 +20,28 @@
   "license": "LGPL-3.0-only",
   "author": "Appsemble <info@appsemble.com> (https://appsemble.com)",
   "sideEffects": false,
-  "main": "dist",
   "files": [
-    "dist"
+    "**/*.d.ts",
+    "**/*.js",
+    "!*.config.js"
   ],
   "scripts": {
-    "prepack": "tsc -p tsconfig.build.json",
+    "prepack": "tsc --noEmit false",
     "test": "jest"
   },
   "dependencies": {
-    "@appsemble/types": "0.20.8",
+    "@appsemble/types": "0.20.11",
     "axios": "^0.27.0",
     "cron-parser": "^4.0.0",
     "date-fns": "^2.0.0",
     "fast-deep-equal": "^3.0.0",
     "ics": "^2.0.0",
-    "intl-messageformat": "^9.0.0",
+    "intl-messageformat": "^10.0.0",
     "jsonschema": "^1.0.0",
     "langmap": "^0.0.16",
     "language-tags": "^1.0.0",
     "lcm": "^0.0.3",
-    "openapi-types": "^11.0.0",
+    "openapi-types": "^12.0.0",
     "parse-duration": "^1.0.0",
     "postcss": "^8.0.0",
     "type-fest": "^2.0.0"
@@ -52,7 +53,7 @@
     "@types/lcm": "^0.0.0",
     "@types/sinonjs__fake-timers": "^8.0.0",
     "bulma": "0.9.3",
-    "koas-core": "^0.6.0",
+    "koas-core": "^0.7.0",
     "yaml": "^2.0.0"
   },
   "engines": {

package/pem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pem.js","sourceRoot":"","sources":["pem.ts"],"names":[],"mappings":";;;AAAA,SAAgB,QAAQ,CAAC,GAAW,EAAE,cAAc,GAAG,KAAK;IAC1D,OAAO,GAAG;SACP,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC;SACzC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC;SACvC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAC7C,IAAI,EAAE,CAAC;AACZ,CAAC;AAND,4BAMC;AAED,SAAgB,OAAO,CAAC,GAAW,EAAE,IAAY;IAC/C,OAAO,cAAc,IAAI,UAAU,GAAG,cAAc,IAAI,OAAO,CAAC;AAClE,CAAC;AAFD,0BAEC"}

package/pem.ts

@@ -0,0 +1,11 @@
+export function stripPem(pem: string, removeNewlines = false): string {
+  return pem
+    .replace(/^[\s-]*BEGIN [A-Z]+[\s-]*/g, '')
+    .replace(/[\s-]*END [A-Z]+[\s-]*$/g, '')
+    .replace(/\r?\n/g, removeNewlines ? '' : '\n')
+    .trim();
+}
+
+export function wrapPem(pem: string, type: string): string {
+  return `-----BEGIN ${type}-----\n${pem}\n-----END ${type}-----`;
+}

package/prefix.d.ts

@@ -0,0 +1,8 @@
+/**
+ * If the prefix is truthy, concatenate prefix and string. Otherwise, return string.
+ *
+ * @param string The string to add a conditional prefix to.
+ * @param p The string to add as a prefix.
+ * @returns The prefixed or unprefixed string.
+ */
+export declare function prefix(string: string, p: string): string;