@guillaume-docquier/tools-ts 2.1.0 → 2.2.0

package/README.md

@@ -1,3 +1,99 @@
 # tools-ts
 
 A collection of small typescript tools published to npm
+
+## Exported Tools Overview
+
+This package is a grab bag of focused TypeScript utilities. Use this README as the
+orientation layer: it tells you which tool to reach for and when. The individual
+modules contain the deeper API examples and implementation notes.
+
+### Error Handling And Assertions
+
+Use these tools when code needs to distinguish expected failures from broken
+program assumptions.
+
+| Export                         | What it is                                                                         | Use it when                                                                                                                                    |
+| ------------------------------ | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `Result`, `Success`, `Failure` | A typed success/failure return shape plus helper constructors and guards.          | You want expected failures to be returned and handled explicitly instead of thrown. Prefer this for recoverable application outcomes.          |
+| `Result.tryCatch`              | A wrapper that converts thrown or rejected non-fatal errors into `Failure`.        | You are calling code that may throw, especially third-party APIs, and want to bring it back into the `Result` flow.                            |
+| `Assert`                       | Runtime assertion helpers that throw `AssertionError` and narrow TypeScript types. | TypeScript cannot express an invariant strongly enough, or test code needs a clear fatal assertion.                                            |
+| `AssertionError`               | A fatal error for violated assumptions, with structured context.                   | A program invariant is broken and continuing would hide a bug or corrupt later state. Usually use `Assert` unless you need a custom assertion. |
+| `FatalError`                   | Base fatal error class with an `isFatal` flag and structured context.              | An error should crash or escape normal expected-error handling. Extend this for domain-specific fatal errors.                                  |
+| `Rethrow`                      | Helpers for catch blocks that should not swallow fatal errors.                     | You catch `unknown` but only intend to handle recoverable `Error` instances.                                                                   |
+| `NotImplementedError`          | A fatal placeholder error with tracking context.                                   | A code path intentionally exists before the feature is implemented, and the missing work should be traceable.                                  |
+| `isNodeJSError`                | Type guard for Node-style `ErrnoException` properties on `Error`.                  | You need to inspect fields like `code`, `path`, `errno`, or `syscall` after catching a Node.js error.                                          |
+
+### Type And Value Guards
+
+Use these tools at runtime boundaries: parsed JSON, environment variables,
+external APIs, CLI input, local storage, or other unknown data.
+
+| Export       | What it is                                                                        | Use it when                                                                                 |
+| ------------ | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| `TypeGuard`  | Small runtime guards for primitives, arrays, records, integers, and enum members. | You need non-throwing checks that also narrow types.                                        |
+| `getEnumKey` | Looks up the enum key associated with a value.                                    | You have an enum value and need the more descriptive key for display, logs, or diagnostics. |
+| `asArray`    | Normalizes a single value or array into an array.                                 | An API accepts both `T` and `T[]`, but downstream logic should iterate uniformly.           |
+
+### Numeric Ranges
+
+Use this tool when code needs a reusable, validated numeric interval instead of
+duplicating min/max checks across call sites.
+
+| Export  | What it is                                                       | Use it when                                                                                   |
+| ------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
+| `Range` | Helpers for creating, validating, comparing, and testing ranges. | You need finite integer or float intervals with inclusive minimums and configurable maximums. |
+
+### Utility Types
+
+These exports are type-only helpers for common TypeScript modeling problems.
+
+| Export                                     | What it is                                                      | Use it when                                                                                |
+| ------------------------------------------ | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| `ConstructorType`                          | A type for class constructors.                                  | A function accepts a class and later uses `new` or `instanceof` against it.                |
+| `EnumKeyType`, `EnumValueType`, `EnumType` | Broad shapes for enum-like objects.                             | You are writing generic utilities that operate on TypeScript enums or const-object enums.  |
+| `Enumify`                                  | Converts a const object into a union of its values.             | A project avoids TypeScript `enum` but wants enum-like ergonomics from `as const` objects. |
+| `ValueOf`                                  | Produces a union of an object's value types.                    | You need the values of a lookup object as a type.                                          |
+| `Prettify`                                 | Re-expands an object type for easier editor hovers.             | Intersections or mapped types are correct but hard to read in tooling.                     |
+| `OmitOverUnion`                            | Applies `Omit` distributively across union members.             | Native `Omit` collapses a discriminated union in a way that loses member-specific fields.  |
+| `PartialProperties`                        | Makes selected object properties partial, not the whole object. | Only nested property objects should become partial while the parent shape stays required.  |
+| `Mutable`                                  | Removes `readonly` from selected properties.                    | You have a narrow, deliberate mutation need. Avoid this unless there is no cleaner model.  |
+
+### Logging
+
+Use the logging tools when an application or library needs structured logs with
+consistent context, scopes, formatting, and redaction.
+
+| Export                      | What it is                                                                                      | Use it when                                                                                                                     |
+| --------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `Logger`                    | The package logger facade, backed by LogTape, with root configuration and child scoped loggers. | Application code needs to configure sinks/context, or library code needs a logger that can be configured later by the host app. |
+| `createConsoleLogSink`      | Console sink factory with production-oriented defaults.                                         | You need a ready-to-use console sink with JSON lines, non-blocking writes, and secret redaction by default.                     |
+| `jsonLineFormatter`         | Structured one-record-per-line log formatter.                                                   | Logs are going to production systems, aggregators, or files where machine parsing matters.                                      |
+| `prettyConsoleFormatter`    | Human-readable console formatter with expandable structured context.                            | Local development needs readable console output.                                                                                |
+| `RECOMMENDED_LOG_REDACTION` | Default field redaction rules for common secrets.                                               | You want a baseline set of credential and sensitive-field protections for logs.                                                 |
+| `LogSink`                   | Type alias for supported logging sinks.                                                         | You are typing sink integrations or custom sink factories.                                                                      |
+| `LogContext`                | Type for user-provided structured log context.                                                  | You attach serializable context to log calls or logger instances.                                                               |
+| `LoggerContext`             | Type for the final context shape passed to sinks and formatters.                                | You are writing a formatter or sink and need the logger-reserved `scopes` field.                                                |
+| `LogContextProvider`        | Interface for dynamic context providers.                                                        | Log context changes over time, such as the active user, request, tenant, or job.                                                |
+
+### Runtime Utilities
+
+Use these small utilities to keep common asynchronous and callback patterns
+consistent.
+
+| Export            | What it is                    | Use it when                                                                     |
+| ----------------- | ----------------------------- | ------------------------------------------------------------------------------- |
+| `setTimeoutAsync` | Promise-based timeout helper. | You want `await`-friendly delays that work in browser and Node environments.    |
+| `debounce`        | Creates a debounced callback. | A repeated event should trigger work only after calls have settled for a delay. |
+| `noop`            | Synchronous no-op function.   | You need a safe default callback that intentionally does nothing.               |
+| `asyncNoop`       | Asynchronous no-op function.  | You need a safe default async callback or hook that resolves immediately.       |
+
+### Measurement
+
+Use these helpers for lightweight operational visibility, not for rigorous
+benchmarking.
+
+| Export                  | What it is                                      | Use it when                                                                          |
+| ----------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------ |
+| `Measure.executionTime` | Wraps sync or async work and logs elapsed time. | You need quick timing instrumentation around a named operation.                      |
+| `Measure.memoryUsage`   | Logs process memory usage in megabytes.         | You need a snapshot of Node.js process memory for diagnostics or runtime visibility. |

package/dist/Range.d.ts

@@ -0,0 +1,110 @@
+import { Result } from "./Result.js";
+/**
+ * A finite numeric interval with an inclusive minimum and either an inclusive or exclusive maximum.
+ * Use {@link Range.createMaxInclusive} and {@link Range.createMaxExclusive} factory methods to create valid ranges.
+ */
+export type Range<TNumericType extends NumericType = NumericType> = InclusiveRange<TNumericType> | ExclusiveRange<TNumericType>;
+/**
+ * A finite numeric interval whose maximum value is included in the range.
+ * Use the {@link Range.createMaxInclusive} factory method to create valid InclusiveRanges.
+ */
+export type InclusiveRange<TNumericType extends NumericType> = {
+    /**
+     * Discriminator for ranges where the maximum value is included.
+     */
+    readonly type: "MaxInclusive";
+    /**
+     * The kind of numeric values accepted by the range.
+     */
+    readonly numericType: TNumericType;
+    /**
+     * The inclusive lower bound.
+     */
+    readonly min: number;
+    /**
+     * The inclusive upper bound.
+     */
+    readonly maxInclusive: number;
+    /**
+     * Optional outer range that this range must stay within.
+     */
+    readonly limits?: Range<TNumericType>;
+};
+/**
+ * A finite numeric interval whose maximum value is excluded from the range.
+ * Use the {@link Range.createMaxExclusive} factory method to create valid ExclusiveRanges.
+ */
+export type ExclusiveRange<TNumericType extends NumericType> = {
+    /**
+     * Discriminator for ranges where the maximum value is excluded.
+     */
+    readonly type: "MaxExclusive";
+    /**
+     * The kind of numeric values accepted by the range.
+     */
+    readonly numericType: TNumericType;
+    /**
+     * The inclusive lower bound.
+     */
+    readonly min: number;
+    /**
+     * The exclusive upper bound.
+     */
+    readonly maxExclusive: number;
+    /**
+     * Optional outer range that this range must stay within.
+     */
+    readonly limits?: Range<TNumericType>;
+};
+type NumericType = "float" | "integer";
+/**
+ * Helpers for creating, validating, comparing, and narrowing numeric ranges.
+ */
+export declare const Range: {
+    /**
+     * Creates a range that includes its maximum value.
+     * The function returns a Failure if the Range parameters are invalid.
+     *
+     * @param range The range values, excluding the discriminator added by this function.
+     */
+    createMaxInclusive: <TNumericType extends NumericType>(range: Omit<InclusiveRange<TNumericType>, "type">) => Result<InclusiveRange<TNumericType>, string>;
+    /**
+     * Creates a range that excludes its maximum value.
+     * The function returns a Failure if the Range parameters are invalid.
+     *
+     * @param range The range values, excluding the discriminator added by this function.
+     */
+    createMaxExclusive: <TNumericType extends NumericType>(range: Omit<ExclusiveRange<TNumericType>, "type">) => Result<ExclusiveRange<TNumericType>, string>;
+    /**
+     * Creates a new range with the same discriminator, numeric type, and limits as another range.
+     *
+     * @param fromRange The range to copy the shape from.
+     * @param withValues The replacement minimum and maximum values.
+     */
+    from: <TRange extends Range<TNumericType>, TNumericType extends NumericType>(fromRange: TRange, withValues: {
+        min: number;
+        max: number;
+    }) => Result<TRange, string>;
+    /**
+     * Checks whether a Range is valid.
+     * This is only useful to run on untrusted input since the Range constructors already ensures the Range is valid.
+     *
+     * @param range The range to validate.
+     */
+    validate: (range: Range) => string | undefined;
+    /**
+     * Checks whether a numeric value is inside the Range.
+     *
+     * @param range The range to test against.
+     * @param value The value to test.
+     */
+    isWithin: (range: Range, value: number) => boolean;
+    /**
+     * Checks whether two Ranges share at least one value.
+     *
+     * @param a The first range.
+     * @param b The second range.
+     */
+    overlaps: <TNumericType extends NumericType>(a: Range<TNumericType>, b: Range<TNumericType>) => boolean;
+};
+export {};

package/dist/Range.js

@@ -0,0 +1,153 @@
+import { Result } from "./Result.js";
+/**
+ * Helpers for creating, validating, comparing, and narrowing numeric ranges.
+ */
+export const Range = {
+    /**
+     * Creates a range that includes its maximum value.
+     * The function returns a Failure if the Range parameters are invalid.
+     *
+     * @param range The range values, excluding the discriminator added by this function.
+     */
+    createMaxInclusive: (range) => {
+        const inclusiveRange = {
+            ...range,
+            type: "MaxInclusive",
+        };
+        const invalidReason = Range.validate(inclusiveRange);
+        if (invalidReason !== undefined) {
+            return Result.Failure(invalidReason);
+        }
+        return Result.Success(inclusiveRange);
+    },
+    /**
+     * Creates a range that excludes its maximum value.
+     * The function returns a Failure if the Range parameters are invalid.
+     *
+     * @param range The range values, excluding the discriminator added by this function.
+     */
+    createMaxExclusive: (range) => {
+        const exclusiveRange = {
+            ...range,
+            type: "MaxExclusive",
+        };
+        const invalidReason = Range.validate(exclusiveRange);
+        if (invalidReason !== undefined) {
+            return Result.Failure(invalidReason);
+        }
+        return Result.Success(exclusiveRange);
+    },
+    /**
+     * Creates a new range with the same discriminator, numeric type, and limits as another range.
+     *
+     * @param fromRange The range to copy the shape from.
+     * @param withValues The replacement minimum and maximum values.
+     */
+    from: (fromRange, withValues) => {
+        switch (fromRange.type) {
+            case "MaxExclusive":
+                return Range.createMaxExclusive({
+                    numericType: fromRange.numericType,
+                    min: withValues.min,
+                    maxExclusive: withValues.max,
+                    limits: fromRange.limits,
+                });
+            case "MaxInclusive":
+                return Range.createMaxInclusive({
+                    numericType: fromRange.numericType,
+                    min: withValues.min,
+                    maxInclusive: withValues.max,
+                    limits: fromRange.limits,
+                });
+        }
+    },
+    /**
+     * Checks whether a Range is valid.
+     * This is only useful to run on untrusted input since the Range constructors already ensures the Range is valid.
+     *
+     * @param range The range to validate.
+     */
+    validate: (range) => {
+        for (const rule of RANGE_VALIDATION_RULES) {
+            const reason = rule(range);
+            if (reason !== undefined) {
+                return reason;
+            }
+        }
+        return undefined;
+    },
+    /**
+     * Checks whether a numeric value is inside the Range.
+     *
+     * @param range The range to test against.
+     * @param value The value to test.
+     */
+    isWithin: (range, value) => {
+        if (value < range.min) {
+            return false;
+        }
+        switch (range.type) {
+            case "MaxExclusive":
+                return value < range.maxExclusive;
+            case "MaxInclusive":
+                return value <= range.maxInclusive;
+        }
+    },
+    /**
+     * Checks whether two Ranges share at least one value.
+     *
+     * @param a The first range.
+     * @param b The second range.
+     */
+    overlaps: (a, b) => {
+        return Range.isWithin(a, b.min) || Range.isWithin(b, a.min);
+    },
+};
+const RANGE_VALIDATION_RULES = [
+    minIsFinite,
+    maxIsFinite,
+    minIsValidNumberType,
+    maxIsValidNumberType,
+    minIsSmallerThanMax,
+    limitsAreValid,
+    minIsWithinLimits,
+    maxIsWithinLimits,
+];
+function minIsFinite(range) {
+    return Number.isFinite(range.min) ? undefined : "Min must be a finite number";
+}
+function maxIsFinite(range) {
+    return Number.isFinite(getMax(range)) ? undefined : "Min must be a finite number";
+}
+function minIsValidNumberType(range) {
+    return range.numericType === "float" || Number.isInteger(range.min) ? undefined : `Min must be a ${range.numericType} number`;
+}
+function maxIsValidNumberType(range) {
+    return range.numericType === "float" || Number.isInteger(getMax(range)) ? undefined : `Max must be a ${range.numericType} number`;
+}
+function minIsSmallerThanMax(range) {
+    switch (range.type) {
+        case "MaxExclusive":
+            return range.min < range.maxExclusive ? undefined : "Min must be smaller than the exclusive max";
+        case "MaxInclusive":
+            return range.min <= range.maxInclusive ? undefined : "Min must be smaller or equal to the inclusive max";
+    }
+}
+function limitsAreValid(range) {
+    return range.limits === undefined ? undefined : Range.validate(range.limits);
+}
+function minIsWithinLimits(range) {
+    return range.limits === undefined || Range.isWithin(range.limits, range.min) ? undefined : "Min must be within limits";
+}
+function maxIsWithinLimits(range) {
+    return range.limits === undefined || Range.isWithin(range.limits, getMax(range)) ? undefined : "Max must be within limits";
+}
+function getMax(range) {
+    switch (range.type) {
+        case "MaxExclusive":
+            return range.maxExclusive;
+        case "MaxInclusive":
+            return range.maxInclusive;
+    }
+}
+//# sourceMappingURL=Range.js.map

package/dist/Range.js.map

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

package/dist/entry.tools-ts.d.ts

@@ -9,6 +9,7 @@ export { asArray } from "./asArray.js";
 export { Assert } from "./Assert.js";
 export { Result, type Success, type Failure } from "./Result.js";
 export { Measure } from "./Measure.js";
+export { Range } from "./Range.js";
 export { TypeGuard } from "./TypeGuard.js";
 export { setTimeoutAsync } from "./setTimeoutAsync.js";
 export { noop, asyncNoop } from "./noop.js";

package/dist/entry.tools-ts.js

@@ -8,6 +8,7 @@ export { asArray } from "./asArray.js";
 export { Assert } from "./Assert.js";
 export { Result } from "./Result.js";
 export { Measure } from "./Measure.js";
+export { Range } from "./Range.js";
 export { TypeGuard } from "./TypeGuard.js";
 export { setTimeoutAsync } from "./setTimeoutAsync.js";
 export { noop, asyncNoop } from "./noop.js";

package/dist/entry.tools-ts.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.tools-ts.js","sourceRoot":"","sources":["../src/entry.tools-ts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAA8B,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA;AAEtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAKvE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"entry.tools-ts.js","sourceRoot":"","sources":["../src/entry.tools-ts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAI5C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,MAAM,EAA8B,MAAM,aAAa,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAA;AAEtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAKvE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guillaume-docquier/tools-ts",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "My personal collection of typescript tools",
   "homepage": "https://github.com/Guillaume-Docquier/tools-ts",
   "repository": {
@@ -47,30 +47,30 @@
     "semi": false
   },
   "dependencies": {
-    "@logtape/logtape": "^2.0.5",
-    "@logtape/redaction": "^2.0.5"
+    "@logtape/logtape": "^2.1.1",
+    "@logtape/redaction": "^2.1.1"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/github": "^12.0.8",
     "@semantic-release/npm": "^13.1.5",
-    "@semantic-release/release-notes-generator": "^14.1.0",
-    "@types/node": "^25.5.0",
-    "@vitest/coverage-v8": "^4.1.2",
-    "conventional-changelog-conventionalcommits": "^9.3.0",
-    "eslint": "^10.1.0",
+    "@semantic-release/release-notes-generator": "^14.1.1",
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.7",
+    "conventional-changelog-conventionalcommits": "^9.3.1",
+    "eslint": "^10.4.0",
     "husky": "^9.1.7",
-    "jiti": "^2.6.1",
+    "jiti": "^2.7.0",
     "lint-staged": "^16.4.0",
-    "prettier": "^3.8.1",
+    "prettier": "^3.8.3",
     "semantic-release": "^25.0.3",
     "sort-package-json": "^3.6.1",
-    "typescript": "^6.0.2",
-    "typescript-eslint": "^8.57.2",
-    "vitest": "^4.1.2"
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.59.4",
+    "vitest": "^4.1.7"
   },
-  "packageManager": "pnpm@10.33.0+sha512.10568bb4a6afb58c9eb3630da90cc9516417abebd3fabbe6739f0ae795728da1491e9db5a544c76ad8eb7570f5c4bb3d6c637b2cb41bfdcdb47fa823c8649319",
+  "packageManager": "pnpm@11.3.0+sha512.2c403d6594527287672b1f7056343a1f7c3634036a67ffabfcc2b3d7595d843768f8787148d1b57cf7956c90606bbd192857c363af19e96d2d0ec9ec5741d215",
   "publishConfig": {
     "access": "public",
     "provenance": true