@manta-eu/lib 0.1.6 → 0.1.8

package/README.md

@@ -3,6 +3,8 @@
 Small TypeScript helpers shared across the Manta packages — plain functions and types, no
 framework and no service calls.
 
+Documentation: [developers.manta.eu](https://developers.manta.eu)
+
 ## Installation
 
 ```bash
@@ -19,7 +21,7 @@ import { humanBytes, humanDuration } from "@manta-eu/lib/humanize";
 ```
 
 Modules include `array`, `date`, `number`, `color`, `file`, `enum`, `humanize`, `present`,
-`countries` and `ad-platform-links`. `present` carries `isPresent`, which is how this repo checks for
+`countries`, `ad-platform-links` and `connection-string`. `present` carries `isPresent`, which is how this repo checks for
 a value rather than testing `.length` or truthiness.
 
 This package exists so `@manta-eu/client`, `@manta-eu/react` and `@manta-eu/rdf-lib` share one copy

package/dist/backoff.d.ts

@@ -0,0 +1,8 @@
+export type Backoff = {
+    initialMs: number;
+    maxMs: number;
+    factor?: number;
+    jitterRatio?: number;
+};
+export declare function backoffDelayMs(attempt: number, backoff: Backoff, random?: () => number): number;
+//# sourceMappingURL=backoff.d.ts.map

package/dist/backoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backoff.d.ts","sourceRoot":"","sources":["../src/backoff.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAK5G"}

package/dist/backoff.js

@@ -0,0 +1,6 @@
+export function backoffDelayMs(attempt, backoff, random = Math.random) {
+    const { initialMs, maxMs, factor = 2, jitterRatio = 0 } = backoff;
+    const exponential = initialMs * factor ** Math.max(0, attempt);
+    const jitter = random() * exponential * jitterRatio;
+    return Math.min(maxMs, exponential + jitter);
+}

package/dist/connection-string.d.ts

@@ -0,0 +1,15 @@
+export type ConnectionString = {
+    scheme: string;
+    host?: string;
+    port?: string;
+    username?: string;
+    password?: string;
+    path: string[];
+    params: Record<string, string>;
+};
+export type ParseOptions = {
+    semicolonProperties?: boolean;
+};
+export declare function parseConnectionString(input: string, options?: ParseOptions): ConnectionString | undefined;
+export declare function unescapeBracedValue(value: string): string;
+//# sourceMappingURL=connection-string.d.ts.map

package/dist/connection-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-string.d.ts","sourceRoot":"","sources":["../src/connection-string.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAEzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,gBAAgB,GAAG,SAAS,CAoB7G;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/connection-string.js

@@ -0,0 +1,71 @@
+import { isPresent } from "./present.js";
+export function parseConnectionString(input, options = {}) {
+    const { semicolonProperties = false } = options;
+    const schemeAndRest = splitScheme(stripJdbcPrefix(input.trim()));
+    if (!schemeAndRest)
+        return undefined;
+    const { scheme, rest } = schemeAndRest;
+    const [head, properties] = semicolonProperties ? splitHead(rest) : [rest, ""];
+    if (head.includes("\\"))
+        return undefined;
+    try {
+        const { path, query, ...authority } = headParts(scheme, head, semicolonProperties);
+        return {
+            scheme,
+            ...withoutBlankValues(authority),
+            path,
+            params: Object.fromEntries([...query, ...propertyEntries(properties)]),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+export function unescapeBracedValue(value) {
+    const braced = /^\{(.*)\}$/s.exec(value);
+    return braced?.[1] === undefined ? value : braced[1].replaceAll("}}", "}");
+}
+function stripJdbcPrefix(input) {
+    return input.replace(/^jdbc:/i, "");
+}
+const schemePattern = /^([a-z][a-z0-9+.-]*):\/\//i;
+function splitScheme(text) {
+    const match = schemePattern.exec(text);
+    if (!match?.[1])
+        return undefined;
+    return { scheme: match[1].toLowerCase(), rest: text.slice(match[0].length) };
+}
+function splitHead(text) {
+    const [head = "", ...properties] = text.split(";");
+    return [head, properties.join(";")];
+}
+// The BigQuery JDBC head is an endpoint URL, so a head with its own scheme carries no host.
+function headParts(scheme, head, semicolonProperties) {
+    if (!isPresent(head) || (semicolonProperties && head.includes("://")))
+        return { path: [], query: [] };
+    return urlParts(scheme, head);
+}
+function urlParts(scheme, head) {
+    const url = new URL(`${scheme}://${head}`);
+    return {
+        host: url.hostname.replace(/^\[(.*)\]$/, "$1"),
+        port: url.port,
+        username: decodeURIComponent(url.username),
+        password: decodeURIComponent(url.password),
+        path: url.pathname.split("/").filter(Boolean).map(decodeURIComponent),
+        query: [...url.searchParams],
+    };
+}
+function withoutBlankValues(entries) {
+    return Object.fromEntries(Object.entries(entries).filter(([, value]) => isPresent(value)));
+}
+const propertyName = "([^;=]+)";
+// The SQL Server JDBC driver escapes a value in braces, and "}}" in the braces stands for one "}".
+const bracedValue = String.raw `\{(?:[^}]|\}\})*\}`;
+const plainValue = "[^;]*";
+const propertyPattern = new RegExp(String.raw `${propertyName}=\s*(${bracedValue}|${plainValue})`, "g");
+function propertyEntries(text) {
+    return [...text.matchAll(propertyPattern)]
+        .map(([, name = "", value = ""]) => [name.trim(), value.trim()])
+        .filter(([name]) => isPresent(name));
+}

package/dist/humanize.d.ts

@@ -8,9 +8,8 @@ export declare function humanDimensions({ width, height }: {
     height: number;
 }): string;
 export declare function humanPlural(word: string, count: number): string;
-export type HumanListOptions = {
+export type HumanListOptions = Intl.ListFormatOptions & {
     truncateAt?: number;
-    conjunction?: string;
 };
 export declare function humanList(list: string[], options?: HumanListOptions): string;
 export type HumanDurationArgs = {

package/dist/humanize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"humanize.d.ts","sourceRoot":"","sources":["../src/humanize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA0B,MAAM,UAAU,CAAC;AAOhE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CASxD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS1E;AAED,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE5F;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAc5E;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAYF,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAW7D"}
+{"version":3,"file":"humanize.d.ts","sourceRoot":"","sources":["../src/humanize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA0B,MAAM,UAAU,CAAC;AAMhE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CASxD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAS1E;AAED,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE5F;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,GAAG;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAY5E;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAYF,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAW7D"}

package/dist/humanize.js

@@ -1,6 +1,5 @@
 import { formatDuration, intervalToDuration } from "date-fns";
 import { filesize } from "filesize";
-import humanizeList from "humanize-list";
 import pluralize from "pluralize";
 import { isPresent } from "./present.js";
 export function humanBytes(input) {
@@ -40,16 +39,14 @@ export function humanPlural(word, count) {
     return pluralize(word, count, false);
 }
 export function humanList(list, options) {
-    const { truncateAt, conjunction = "and" } = options || {};
+    const { truncateAt, ...formatOptions } = options || {};
+    const listFormat = new Intl.ListFormat("en", formatOptions);
     if (!truncateAt || list.length <= truncateAt) {
-        return humanizeList(list, {
-            oxfordComma: list.length > 2,
-            conjunction,
-        });
+        return listFormat.format(list);
     }
     const remaining = list.length - truncateAt;
     const truncated = [...list.slice(0, truncateAt), `+${remaining} more`];
-    return humanizeList(truncated, { oxfordComma: true, conjunction });
+    return listFormat.format(truncated);
 }
 const periods = ["years", "months", "weeks", "days", "hours", "minutes", "seconds"];
 function getDurationFormat(duration, largest) {

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "@manta-eu/lib",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Pure TypeScript helpers shared across the Manta packages",
+  "homepage": "https://developers.manta.eu",
+  "keywords": [
+    "manta",
+    "knowledge-graph",
+    "typescript",
+    "utilities"
+  ],
   "license": "MIT",
   "type": "module",
   "exports": {
     "./*": {
+      "manta-source": "./src/*.ts",
       "types": "./dist/*.d.ts",
       "import": "./dist/*.js"
     }
@@ -16,7 +24,6 @@
   "dependencies": {
     "date-fns": "^4.1.0",
     "filesize": "^11.0.2",
-    "humanize-list": "^1.0.1",
     "pluralize": "^8.0.0",
     "ramda": "^0.32.0"
   },