@buildkitchen/validation 0.0.0-stage → 0.0.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kwasi A. Mensah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,52 @@
-# Temporary Holding Version
+# 📦 @buildkitchen/validation
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A library for validating data across serialization/deserialization boundaries.
+
+## Installation
+
+Install the package via your preferred package manager:
+
+```bash
+npm install @buildkitchen/validation
+```
+
+Or using yarn/pnpm:
+
+```bash
+yarn add @buildkitchen/validation
+pnpm add @buildkitchen/validation
+```
+
+## Usage
+
+```typescript
+interface Test extends JSONObject {
+  readonly foo: string;
+  readonly x: number;
+}
+const test = JSON.stringify({ foo: "bar", x: 42 });
+const unvalidated = Unvalidated.createFromJSON<Test>(
+  test,
+  "loaded from helloWorld.txt"
+);
+validateString(unvalidated.get("foo")); // "bar"
+validateNumber(unvalidated.get("x")); // 42
+
+// Typescript won't compile because foo1 is not a member of the validated type.
+// Also paired with a runtime error.
+validateString(unvalidated.get("foo1"));
+```
+
+We wrap unvalidated values with this called and use the validate* functions to check types and get clean errors when there's a mismatch.
+
+## API Reference
+
+[Full documentation on Codeberg](https://codeberg.org/buildkitchen/validation/src/branch/main/docs)
+
+## Contributing
+
+We're not actively soliticing contributions but please let us know of any bugs/issues you find in this code and we'll try to resolve them in a timely manner.
+
+## License
+
+Distributed under the MIT License. See `LICENSE` for more information.

package/index.d.ts

@@ -0,0 +1,166 @@
+/**
+ * @document README.md
+ * @packageDocumentation
+ * @module
+ * @mergeModuleWith <project>
+ */
+/**
+ * Represent data who's type hasn't been validated yet.
+ *
+ * ```typescript
+ *  interface Test extends JSONObject {
+ *    readonly foo: string;
+ *    readonly x: number;
+ *  }
+ *  const test = JSON.stringify({foo: "bar", x: 42})
+ *  const unvalidated = Unvalidated.createFromJSON<Test>(test, "loaded from helloWorld.txt");
+ *  validateString(unvalidated.get("foo")); // "bar"
+ *  validateNumber(unvalidated.get("x")); // 42
+ *
+ *  // Typescript won't compile because foo1 is not a member of the validated type.
+ *  // Also paired with a runtime error.
+ *  validateString(unvalidated.get("foo1"));
+ * ```
+ *
+ *
+ * @typeParam T - An interface describing the shape the object should have. Used in the typing of {@link Unvalidated.get}
+ * to statically enforce type safety.
+ */
+export declare class Unvalidated<T> {
+    readonly rawValue: unknown;
+    readonly context: ReadonlyArray<string | number>;
+    /** @internal */
+    readonly __typeCheck: T;
+    /**
+     * Creates an instance of UserProfile.
+     *
+     * @param rawValue The unvalidated data. Allows direct access for complex validation cases.
+     * @param context Context used for reporting errors during validation.
+     */
+    private constructor();
+    /**
+     * Create an Unvalidated<T> from an in-memory object.
+     *
+     * Useful when getting data from a source who's schema still needs to be checked i.e. database results etc.
+     *
+     * @typeParam T - An interface describing the shape the object should have.
+     * @param rawValue
+     * @param context
+     * @param relevantValue
+     * @returns
+     */
+    static create<T>(rawValue: T, context: string | number, relevantValue?: Unvalidated<unknown>): Unvalidated<T>;
+    /**
+     * Create an Unvalidated<T> from JSON text.
+     *
+     * Shortcut for creating an Unvalidated<T> from JSON.
+     *
+     * @typeParam T - An interface describing the shape the object should have.
+     * @param json
+     * @param context
+     * @returns
+     */
+    static createFromJSON<T extends JSONValue>(json: string, context: string): Unvalidated<T>;
+    /**
+     * Access a value from an Unvalidated object.
+     *
+     * returns Unvalidated<undefined> of this key does not exist on the object.
+     *
+     * @param key
+     * @returns
+     */
+    get<K extends (T extends undefined ? never : keyof T)>(key: K & (string | number)): Unvalidated<T extends undefined ? undefined : T[K]>;
+    /**
+     * Helper to allow casting parent types to child types.
+     *
+     * Mostly used after type discrimination with {@link validateIsMember}
+     *
+     * @returns
+     */
+    castTo<U extends T>(): Unvalidated<U>;
+    /**
+     * Wrap the Unvalidated's context around an error throw during validation.
+     *
+     * @param cause
+     */
+    throwValidationError(cause: Error): never;
+}
+/**
+ * Validate possibly undefined value with a custom validator
+ *
+ * @param value
+ * @param validator
+ * @returns
+ */
+export declare function validateMaybeUndefined<T, V>(value: Unvalidated<T | undefined>, validator: (value: Unvalidated<T>) => V): V | undefined;
+/**
+ * Validate that the value is a string.
+ *
+ * @param value
+ * @returns
+ */
+export declare function validateString(value: Unvalidated<string>): string;
+/**
+ * Validate that the value is number.
+ * @param value
+ * @returns
+ */
+export declare function validateNumber(value: Unvalidated<number>): number;
+/**
+ * Validate that the value is a BigInt.
+ * @param value
+ * @returns
+ */
+export declare function validateBigInt(value: Unvalidated<bigint>): bigint;
+/**
+ * Validate that the value us a boolean.
+ * @param value
+ * @returns
+ */
+export declare function validateBoolean(value: Unvalidated<boolean>): boolean;
+/**
+ * Validate that the value is an array, using a custom validator for each element.
+ * @param array
+ * @param validator
+ * @returns
+ */
+export declare function validateArray<T, V = T>(array: Unvalidated<ReadonlyArray<T>>, validator: (object: Unvalidated<T>, index: number) => V): Array<V>;
+/**
+ * Shortuct for combining {@link validateArray} with {@link validateString}
+ * @param object
+ * @returns
+ */
+export declare function validateStringArray(object: Unvalidated<ReadonlyArray<string>>): ReadonlyArray<string>;
+/**
+ * Validate a Record with string keys with a custom validator for the values.
+ * @param value
+ * @param validator
+ * @returns
+ */
+export declare function validateObject<T, S>(value: Unvalidated<Record<string, T>>, validator: (unvalidated: Unvalidated<T>, key: string) => S): Record<string, S>;
+/**
+ * Validate that value is a string that is a member of group.
+ *
+ * Useful when relying on type discrimination to help figure out which child type to cast a parent type to.
+ * @param value
+ * @param group
+ * @returns
+ */
+export declare function validateIsMember<S extends string>(value: Unvalidated<S>, group: ReadonlySet<S>): S;
+export type JSONPrimitive = string | number | boolean | null | undefined;
+export type JSONValue = JSONPrimitive | JSONObject | ReadonlyArray<JSONValue>;
+export interface JSONObject {
+    [key: string]: JSONValue | undefined;
+}
+/**
+ * Validate a JSON value.
+ * @param value
+ * @returns
+ */
+export declare function validateJSONValue(value: Unvalidated<JSONValue>): JSONValue;
+/**
+ * Validate a JSON object.
+ * @param jsonObject
+ * @returns
+ */
+export declare function validateJSONObject(jsonObject: Unvalidated<JSONObject>): JSONObject;

package/index.js

@@ -0,0 +1,273 @@
+/**
+ * @document README.md
+ * @packageDocumentation
+ * @module
+ * @mergeModuleWith <project>
+ */
+/**
+ * Represent data who's type hasn't been validated yet.
+ *
+ * ```typescript
+ *  interface Test extends JSONObject {
+ *    readonly foo: string;
+ *    readonly x: number;
+ *  }
+ *  const test = JSON.stringify({foo: "bar", x: 42})
+ *  const unvalidated = Unvalidated.createFromJSON<Test>(test, "loaded from helloWorld.txt");
+ *  validateString(unvalidated.get("foo")); // "bar"
+ *  validateNumber(unvalidated.get("x")); // 42
+ *
+ *  // Typescript won't compile because foo1 is not a member of the validated type.
+ *  // Also paired with a runtime error.
+ *  validateString(unvalidated.get("foo1"));
+ * ```
+ *
+ *
+ * @typeParam T - An interface describing the shape the object should have. Used in the typing of {@link Unvalidated.get}
+ * to statically enforce type safety.
+ */
+export class Unvalidated {
+    rawValue;
+    context;
+    // This makes sure that each instance of Unvalidated isn't ducktyped to each other
+    /** @internal */
+    __typeCheck;
+    /**
+     * Creates an instance of UserProfile.
+     *
+     * @param rawValue The unvalidated data. Allows direct access for complex validation cases.
+     * @param context Context used for reporting errors during validation.
+     */
+    constructor(rawValue, context) {
+        this.rawValue = rawValue;
+        this.context = context;
+        this.__typeCheck = undefined;
+    }
+    /**
+     * Create an Unvalidated<T> from an in-memory object.
+     *
+     * Useful when getting data from a source who's schema still needs to be checked i.e. database results etc.
+     *
+     * @typeParam T - An interface describing the shape the object should have.
+     * @param rawValue
+     * @param context
+     * @param relevantValue
+     * @returns
+     */
+    static create(rawValue, context, relevantValue) {
+        return new Unvalidated(rawValue, relevantValue?.context === undefined
+            ? [context]
+            : [...relevantValue.context, context]);
+    }
+    /**
+     * Create an Unvalidated<T> from JSON text.
+     *
+     * Shortcut for creating an Unvalidated<T> from JSON.
+     *
+     * @typeParam T - An interface describing the shape the object should have.
+     * @param json
+     * @param context
+     * @returns
+     */
+    static createFromJSON(json, context) {
+        try {
+            return new Unvalidated(JSON.parse(json), [context]);
+        }
+        catch (e) {
+            throw new Error(`Error parsing json`, { cause: e });
+        }
+    }
+    /**
+     * Access a value from an Unvalidated object.
+     *
+     * returns Unvalidated<undefined> of this key does not exist on the object.
+     *
+     * @param key
+     * @returns
+     */
+    get(key) {
+        if (this.rawValue === undefined) {
+            return new Unvalidated(undefined, [...this.context, key]);
+        }
+        return new Unvalidated(this.rawValue[key], [
+            ...this.context,
+            key
+        ]);
+    }
+    /**
+     * Helper to allow casting parent types to child types.
+     *
+     * Mostly used after type discrimination with {@link validateIsMember}
+     *
+     * @returns
+     */
+    castTo() {
+        return this;
+    }
+    /**
+     * Wrap the Unvalidated's context around an error throw during validation.
+     *
+     * @param cause
+     */
+    throwValidationError(cause) {
+        throw new Error(`In validation context: '${JSON.stringify(this.context)}'`, { cause });
+    }
+}
+/**
+ * Validate possibly undefined value with a custom validator
+ *
+ * @param value
+ * @param validator
+ * @returns
+ */
+export function validateMaybeUndefined(value, validator) {
+    if (value.rawValue === undefined) {
+        return undefined;
+    }
+    return validator(value.castTo());
+}
+/**
+ * Validate that the value is a string.
+ *
+ * @param value
+ * @returns
+ */
+export function validateString(value) {
+    if (typeof value.rawValue !== "string") {
+        value.throwValidationError(new Error(`value is not a string. It is '${typeof value.rawValue}'`));
+    }
+    return value.rawValue;
+}
+/**
+ * Validate that the value is number.
+ * @param value
+ * @returns
+ */
+export function validateNumber(value) {
+    if (typeof value.rawValue !== "number") {
+        value.throwValidationError(new Error(`value is not a number. It is '${typeof value.rawValue}'`));
+    }
+    return value.rawValue;
+}
+/**
+ * Validate that the value is a BigInt.
+ * @param value
+ * @returns
+ */
+export function validateBigInt(value) {
+    if (typeof value.rawValue === "number") {
+        return BigInt(value.rawValue);
+    }
+    if (typeof value.rawValue !== "bigint") {
+        value.throwValidationError(new Error(`value is not a bigint. It is '${typeof value.rawValue}'`));
+    }
+    return value.rawValue;
+}
+/**
+ * Validate that the value us a boolean.
+ * @param value
+ * @returns
+ */
+export function validateBoolean(value) {
+    if (typeof value.rawValue !== "boolean") {
+        value.throwValidationError(new Error(`value is not a boolean. It is '${typeof value.rawValue}'`));
+    }
+    return value.rawValue;
+}
+/**
+ * Validate that the value is an array, using a custom validator for each element.
+ * @param array
+ * @param validator
+ * @returns
+ */
+export function validateArray(array, validator) {
+    if (!Array.isArray(array.rawValue)) {
+        array.throwValidationError(new Error(`value is not an array. It is '${typeof array.rawValue}'`));
+    }
+    return array.rawValue.map((_, index) => {
+        return validator(array.get(index), index);
+    });
+}
+/**
+ * Shortuct for combining {@link validateArray} with {@link validateString}
+ * @param object
+ * @returns
+ */
+export function validateStringArray(object) {
+    return validateArray(object, validateString);
+}
+/**
+ * Validate a Record with string keys with a custom validator for the values.
+ * @param value
+ * @param validator
+ * @returns
+ */
+export function validateObject(value, validator) {
+    const rawValue = value.rawValue;
+    if (typeof rawValue !== "object") {
+        value.throwValidationError(new Error(`value is not an object`));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    if (rawValue === null) {
+        value.throwValidationError(new Error(`value is null`));
+    }
+    if (Array.isArray(rawValue)) {
+        value.throwValidationError(new Error(`value is not an object. it is an array`));
+    }
+    const resultObject = {};
+    for (const key of Object.keys(rawValue)) {
+        resultObject[key] = validator(value.get(key), key);
+    }
+    return resultObject;
+}
+/**
+ * Validate that value is a string that is a member of group.
+ *
+ * Useful when relying on type discrimination to help figure out which child type to cast a parent type to.
+ * @param value
+ * @param group
+ * @returns
+ */
+export function validateIsMember(value, group) {
+    const stringValue = validateString(value);
+    if (group.has(stringValue)) {
+        return stringValue;
+    }
+    value.throwValidationError(new Error(`'${stringValue}' was not found in '${JSON.stringify([...group])}'`));
+}
+/**
+ * Validate a JSON value.
+ * @param value
+ * @returns
+ */
+export function validateJSONValue(value) {
+    if (value.rawValue === null) {
+        return value.rawValue;
+    }
+    if (value.rawValue === undefined) {
+        return value.rawValue;
+    }
+    switch (typeof value.rawValue) {
+        case "string":
+        case "number":
+        case "boolean":
+            return value.rawValue;
+        case "object": {
+            if (Array.isArray(value.rawValue)) {
+                return validateArray(value.castTo(), validateJSONValue);
+            }
+            return validateJSONObject(value.castTo());
+        }
+        default:
+            value.throwValidationError(new Error(`value is not a json value`));
+    }
+}
+/**
+ * Validate a JSON object.
+ * @param jsonObject
+ * @returns
+ */
+export function validateJSONObject(jsonObject) {
+    return validateObject(jsonObject, validateJSONValue);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9AYnVpbGRraXRjaGVuL3ZhbGlkYXRpb24vaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7O0dBS0c7QUFDSDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBcUJHO0FBQ0gsTUFBTSxPQUFPLFdBQVc7SUFXSjtJQUNBO0lBWGxCLGtGQUFrRjtJQUNsRixnQkFBZ0I7SUFDUCxXQUFXLENBQUk7SUFDeEI7Ozs7O09BS0c7SUFDSCxZQUNrQixRQUFpQixFQUNqQixPQUF1QztRQUR2QyxhQUFRLEdBQVIsUUFBUSxDQUFTO1FBQ2pCLFlBQU8sR0FBUCxPQUFPLENBQWdDO1FBRXZELElBQUksQ0FBQyxXQUFXLEdBQUcsU0FBeUIsQ0FBQztJQUMvQyxDQUFDO0lBRUQ7Ozs7Ozs7Ozs7T0FVRztJQUNILE1BQU0sQ0FBQyxNQUFNLENBQ1gsUUFBVyxFQUNYLE9BQXdCLEVBQ3hCLGFBQW9DO1FBRXBDLE9BQU8sSUFBSSxXQUFXLENBQ3BCLFFBQVEsRUFDUixhQUFhLEVBQUUsT0FBTyxLQUFLLFNBQVM7WUFDbEMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDO1lBQ1gsQ0FBQyxDQUFDLENBQUMsR0FBRyxhQUFhLENBQUMsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUN4QyxDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTRztJQUNILE1BQU0sQ0FBQyxjQUFjLENBQ25CLElBQVksRUFDWixPQUFlO1FBRWYsSUFBSSxDQUFDO1lBQ0gsT0FBTyxJQUFJLFdBQVcsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBTSxFQUFFLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQztRQUMzRCxDQUFDO1FBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUNYLE1BQU0sSUFBSSxLQUFLLENBQUMsb0JBQW9CLEVBQUUsRUFBRSxLQUFLLEVBQUUsQ0FBQyxFQUFFLENBQUMsQ0FBQztRQUN0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QUFDO1FBQ2QsS0FBSyxRQUFRLENBQUM7UUFDZCxLQUFLLFNBQVM7WUFDWixPQUFPLEtBQUssQ0FBQyxRQUFRLENBQUM7UUFDeEIsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDO1lBQ2QsSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO2dCQUNsQyxPQUFPLGFBQWEsQ0FDbEIsS0FBSyxDQUFDLE1BQU0sRUFBNEIsRUFDeEMsaUJBQWlCLENBQ2xCLENBQUM7WUFDSixDQUFDO1lBQ0QsT0FBTyxrQkFBa0IsQ0FBQyxLQUFLLENBQUMsTUFBTSxFQUFjLENBQUMsQ0FBQztRQUN4RCxDQUFDO1FBQ0Q7WUFDRSxLQUFLLENBQUMsb0JBQW9CLENBQUMsSUFBSSxLQUFLLENBQUMsMkJBQTJCLENBQUMsQ0FBQyxDQUFDO0lBQ3ZFLENBQUM7QUFDSCxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sVUFBVSxrQkFBa0IsQ0FDaEMsVUFBbUM7SUFFbkMsT0FBTyxjQUFjLENBQUMsVUFBVSxFQUFFLGlCQUFpQixDQUFDLENBQUM7QUFDdkQsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGRvY3VtZW50IFJFQURNRS5tZFxuICogQHBhY2thZ2VEb2N1bWVudGF0aW9uXG4gKiBAbW9kdWxlXG4gKiBAbWVyZ2VNb2R1bGVXaXRoIDxwcm9qZWN0PlxuICovXG4vKipcbiAqIFJlcHJlc2VudCBkYXRhIHdobydzIHR5cGUgaGFzbid0IGJlZW4gdmFsaWRhdGVkIHlldC5cbiAqXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiAgaW50ZXJmYWNlIFRlc3QgZXh0ZW5kcyBKU09OT2JqZWN0IHtcbiAqICAgIHJlYWRvbmx5IGZvbzogc3RyaW5nO1xuICogICAgcmVhZG9ubHkgeDogbnVtYmVyO1xuICogIH1cbiAqICBjb25zdCB0ZXN0ID0gSlNPTi5zdHJpbmdpZnkoe2ZvbzogXCJiYXJcIiwgeDogNDJ9KVxuICogIGNvbnN0IHVudmFsaWRhdGVkID0gVW52YWxpZGF0ZWQuY3JlYXRlRnJvbUpTT048VGVzdD4odGVzdCwgXCJsb2FkZWQgZnJvbSBoZWxsb1dvcmxkLnR4dFwiKTtcbiAqICB2YWxpZGF0ZVN0cmluZyh1bnZhbGlkYXRlZC5nZXQoXCJmb29cIikpOyAvLyBcImJhclwiXG4gKiAgdmFsaWRhdGVOdW1iZXIodW52YWxpZGF0ZWQuZ2V0KFwieFwiKSk7IC8vIDQyXG4gKlxuICogIC8vIFR5cGVzY3JpcHQgd29uJ3QgY29tcGlsZSBiZWNhdXNlIGZvbzEgaXMgbm90IGEgbWVtYmVyIG9mIHRoZSB2YWxpZGF0ZWQgdHlwZS5cbiAqICAvLyBBbHNvIHBhaXJlZCB3aXRoIGEgcnVudGltZSBlcnJvci5cbiAqICB2YWxpZGF0ZVN0cmluZyh1bnZhbGlkYXRlZC5nZXQoXCJmb28xXCIpKTtcbiAqIGBgYFxuICpcbiAqXG4gKiBAdHlwZVBhcmFtIFQgLSBBbiBpbnRlcmZhY2UgZGVzY3JpYmluZyB0aGUgc2hhcGUgdGhlIG9iamVjdCBzaG91bGQgaGF2ZS4gVXNlZCBpbiB0aGUgdHlwaW5nIG9mIHtAbGluayBVbnZhbGlkYXRlZC5nZXR9XG4gKiB0byBzdGF0aWNhbGx5IGVuZm9yY2UgdHlwZSBzYWZldHkuXG4gKi9cbmV4cG9ydCBjbGFzcyBVbnZhbGlkYXRlZDxUPiB7XG4gIC8vIFRoaXMgbWFrZXMgc3VyZSB0aGF0IGVhY2ggaW5zdGFuY2Ugb2YgVW52YWxpZGF0ZWQgaXNuJ3QgZHVja3R5cGVkIHRvIGVhY2ggb3RoZXJcbiAgLyoqIEBpbnRlcm5hbCAqL1xuICByZWFkb25seSBfX3R5cGVDaGVjazogVDtcbiAgLyoqXG4gICAqIENyZWF0ZXMgYW4gaW5zdGFuY2Ugb2YgVXNlclByb2ZpbGUuXG4gICAqXG4gICAqIEBwYXJhbSByYXdWYWx1ZSBUaGUgdW52YWxpZGF0ZWQgZGF0YS4gQWxsb3dzIGRpcmVjdCBhY2Nlc3MgZm9yIGNvbXBsZXggdmFsaWRhdGlvbiBjYXNlcy5cbiAgICogQHBhcmFtIGNvbnRleHQgQ29udGV4dCB1c2VkIGZvciByZXBvcnRpbmcgZXJyb3JzIGR1cmluZyB2YWxpZGF0aW9uLlxuICAgKi9cbiAgcHJpdmF0ZSBjb25zdHJ1Y3RvcihcbiAgICBwdWJsaWMgcmVhZG9ubHkgcmF3VmFsdWU6IHVua25vd24sXG4gICAgcHVibGljIHJlYWRvbmx5IGNvbnRleHQ6IFJlYWRvbmx5QXJyYXk8c3RyaW5nIHwgbnVtYmVyPlxuICApIHtcbiAgICB0aGlzLl9fdHlwZUNoZWNrID0gdW5kZWZpbmVkIGFzIHVua25vd24gYXMgVDtcbiAgfVxuXG4gIC8qKlxuICAgKiBDcmVhdGUgYW4gVW52YWxpZGF0ZWQ8VD4gZnJvbSBhbiBpbi1tZW1vcnkgb2JqZWN0LlxuICAgKlxuICAgKiBVc2VmdWwgd2hlbiBnZXR0aW5nIGRhdGEgZnJvbSBhIHNvdXJjZSB3aG8ncyBzY2hlbWEgc3RpbGwgbmVlZHMgdG8gYmUgY2hlY2tlZCBpLmUuIGRhdGFiYXNlIHJlc3VsdHMgZXRjLlxuICAgKlxuICAgKiBAdHlwZVBhcmFtIFQgLSBBbiBpbnRlcmZhY2UgZGVzY3JpYmluZyB0aGUgc2hhcGUgdGhlIG9iamVjdCBzaG91bGQgaGF2ZS5cbiAgICogQHBhcmFtIHJhd1ZhbHVlXG4gICAqIEBwYXJhbSBjb250ZXh0XG4gICAqIEBwYXJhbSByZWxldmFudFZhbHVlXG4gICAqIEByZXR1cm5zXG4gICAqL1xuICBzdGF0aWMgY3JlYXRlPFQ+KFxuICAgIHJhd1ZhbHVlOiBULFxuICAgIGNvbnRleHQ6IHN0cmluZyB8IG51bWJlcixcbiAgICByZWxldmFudFZhbHVlPzogVW52YWxpZGF0ZWQ8dW5rbm93bj5cbiAgKTogVW52YWxpZGF0ZWQ8VD4ge1xuICAgIHJldHVybiBuZXcgVW52YWxpZGF0ZWQoXG4gICAgICByYXdWYWx1ZSxcbiAgICAgIHJlbGV2YW50VmFsdWU/LmNvbnRleHQgPT09IHVuZGVmaW5lZFxuICAgICAgICA/IFtjb250ZXh0XVxuICAgICAgICA6IFsuLi5yZWxldmFudFZhbHVlLmNvbnRleHQsIGNvbnRleHRdXG4gICAgKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDcmVhdGUgYW4gVW52YWxpZGF0ZWQ8VD4gZnJvbSBKU09OIHRleHQuXG4gICAqXG4gICAqIFNob3J0Y3V0IGZvciBjcmVhdGluZyBhbiBVbnZhbGlkYXRlZDxUPiBmcm9tIEpTT04uXG4gICAqXG4gICAqIEB0eXBlUGFyYW0gVCAtIEFuIGludGVyZmFjZSBkZXNjcmliaW5nIHRoZSBzaGFwZSB0aGUgb2JqZWN0IHNob3VsZCBoYXZlLlxuICAgKiBAcGFyYW0ganNvblxuICAgKiBAcGFyYW0gY29udGV4dFxuICAgKiBAcmV0dXJuc1xuICAgKi9cbiAgc3RhdGljIGNyZWF0ZUZyb21KU09OPFQgZXh0ZW5kcyBKU09OVmFsdWU+KFxuICAgIGpzb246IHN0cmluZyxcbiAgICBjb250ZXh0OiBzdHJpbmdcbiAgKTogVW52YWxpZGF0ZWQ8VD4ge1xuICAgIHRyeSB7XG4gICAgICByZXR1cm4gbmV3IFVudmFsaWRhdGVkKEpTT04ucGFyc2UoanNvbikgYXMgVCwgW2NvbnRleHRdKTtcbiAgICB9IGNhdGNoIChlKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYEVycm9yIHBhcnNpbmcganNvbmAsIHsgY2F1c2U6IGUgfSk7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIEFjY2VzcyBhIHZhbHVlIGZyb20gYW4gVW52YWxpZGF0ZWQgb2JqZWN0LlxuICAgKlxuICAgKiByZXR1cm5zIFVudmFsaWRhdGVkPHVuZGVmaW5lZD4gb2YgdGhpcyBrZXkgZG9lcyBub3QgZXhpc3Qgb24gdGhlIG9iamVjdC5cbiAgICpcbiAgICogQHBhcmFtIGtleVxuICAgKiBAcmV0dXJuc1xuICAgKi9cbiAgZ2V0PEsgZXh0ZW5kcyAoVCBleHRlbmRzIHVuZGVmaW5lZCA/IG5ldmVyIDoga2V5b2YgVCk+KFxuICAgIGtleTogSyAmIChzdHJpbmcgfCBudW1iZXIpXG4gICk6IFVudmFsaWRhdGVkPFQgZXh0ZW5kcyB1bmRlZmluZWQgPyB1bmRlZmluZWQgOiBUW0tdPiB7XG4gICAgaWYgKHRoaXMucmF3VmFsdWUgPT09IHVuZGVmaW5lZCkge1xuICAgICAgcmV0dXJuIG5ldyBVbnZhbGlkYXRlZCh1bmRlZmluZWQsIFsuLi50aGlzLmNvbnRleHQsIGtleV0pO1xuICAgIH1cbiAgICByZXR1cm4gbmV3IFVudmFsaWRhdGVkKCh0aGlzLnJhd1ZhbHVlIGFzIEV4Y2x1ZGU8VCwgdW5kZWZpbmVkPilba2V5XSwgW1xuICAgICAgLi4udGhpcy5jb250ZXh0LFxuICAgICAga2V5XG4gICAgXSk7XG4gIH1cblxuICAvKipcbiAgICogSGVscGVyIHRvIGFsbG93IGNhc3RpbmcgcGFyZW50IHR5cGVzIHRvIGNoaWxkIHR5cGVzLlxuICAgKlxuICAgKiBNb3N0bHkgdXNlZCBhZnRlciB0eXBlIGRpc2NyaW1pbmF0aW9uIHdpdGgge0BsaW5rIHZhbGlkYXRlSXNNZW1iZXJ9XG4gICAqXG4gICAqIEByZXR1cm5zXG4gICAqL1xuICBjYXN0VG88VSBleHRlbmRzIFQ+KCk6IFVudmFsaWRhdGVkPFU+IHtcbiAgICByZXR1cm4gdGhpcyBhcyB1bmtub3duIGFzIFVudmFsaWRhdGVkPFU+O1xuICB9XG5cbiAgLyoqXG4gICAqIFdyYXAgdGhlIFVudmFsaWRhdGVkJ3MgY29udGV4dCBhcm91bmQgYW4gZXJyb3IgdGhyb3cgZHVyaW5nIHZhbGlkYXRpb24uXG4gICAqXG4gICAqIEBwYXJhbSBjYXVzZVxuICAgKi9cbiAgdGhyb3dWYWxpZGF0aW9uRXJyb3IoY2F1c2U6IEVycm9yKTogbmV2ZXIge1xuICAgIHRocm93IG5ldyBFcnJvcihcbiAgICAgIGBJbiB2YWxpZGF0aW9uIGNvbnRleHQ6ICcke0pTT04uc3RyaW5naWZ5KHRoaXMuY29udGV4dCl9J2AsXG4gICAgICB7IGNhdXNlIH1cbiAgICApO1xuICB9XG59XG5cbi8qKlxuICogVmFsaWRhdGUgcG9zc2libHkgdW5kZWZpbmVkIHZhbHVlIHdpdGggYSBjdXN0b20gdmFsaWRhdG9yXG4gKlxuICogQHBhcmFtIHZhbHVlXG4gKiBAcGFyYW0gdmFsaWRhdG9yXG4gKiBAcmV0dXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVNYXliZVVuZGVmaW5lZDxULCBWPihcbiAgdmFsdWU6IFVudmFsaWRhdGVkPFQgfCB1bmRlZmluZWQ+LFxuICB2YWxpZGF0b3I6ICh2YWx1ZTogVW52YWxpZGF0ZWQ8VD4pID0+IFZcbik6IFYgfCB1bmRlZmluZWQge1xuICBpZiAodmFsdWUucmF3VmFsdWUgPT09IHVuZGVmaW5lZCkge1xuICAgIHJldHVybiB1bmRlZmluZWQ7XG4gIH1cbiAgcmV0dXJuIHZhbGlkYXRvcih2YWx1ZS5jYXN0VG88VD4oKSk7XG59XG5cbi8qKlxuICogVmFsaWRhdGUgdGhhdCB0aGUgdmFsdWUgaXMgYSBzdHJpbmcuXG4gKlxuICogQHBhcmFtIHZhbHVlXG4gKiBAcmV0dXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVTdHJpbmcodmFsdWU6IFVudmFsaWRhdGVkPHN0cmluZz4pOiBzdHJpbmcge1xuICBpZiAodHlwZW9mIHZhbHVlLnJhd1ZhbHVlICE9PSBcInN0cmluZ1wiKSB7XG4gICAgdmFsdWUudGhyb3dWYWxpZGF0aW9uRXJyb3IoXG4gICAgICBuZXcgRXJyb3IoYHZhbHVlIGlzIG5vdCBhIHN0cmluZy4gSXQgaXMgJyR7dHlwZW9mIHZhbHVlLnJhd1ZhbHVlfSdgKVxuICAgICk7XG4gIH1cbiAgcmV0dXJuIHZhbHVlLnJhd1ZhbHVlO1xufVxuXG4vKipcbiAqIFZhbGlkYXRlIHRoYXQgdGhlIHZhbHVlIGlzIG51bWJlci5cbiAqIEBwYXJhbSB2YWx1ZVxuICogQHJldHVybnNcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHZhbGlkYXRlTnVtYmVyKHZhbHVlOiBVbnZhbGlkYXRlZDxudW1iZXI+KTogbnVtYmVyIHtcbiAgaWYgKHR5cGVvZiB2YWx1ZS5yYXdWYWx1ZSAhPT0gXCJudW1iZXJcIikge1xuICAgIHZhbHVlLnRocm93VmFsaWRhdGlvbkVycm9yKFxuICAgICAgbmV3IEVycm9yKGB2YWx1ZSBpcyBub3QgYSBudW1iZXIuIEl0IGlzICcke3R5cGVvZiB2YWx1ZS5yYXdWYWx1ZX0nYClcbiAgICApO1xuICB9XG4gIHJldHVybiB2YWx1ZS5yYXdWYWx1ZTtcbn1cblxuLyoqXG4gKiBWYWxpZGF0ZSB0aGF0IHRoZSB2YWx1ZSBpcyBhIEJpZ0ludC5cbiAqIEBwYXJhbSB2YWx1ZVxuICogQHJldHVybnNcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHZhbGlkYXRlQmlnSW50KHZhbHVlOiBVbnZhbGlkYXRlZDxiaWdpbnQ+KTogYmlnaW50IHtcbiAgaWYgKHR5cGVvZiB2YWx1ZS5yYXdWYWx1ZSA9PT0gXCJudW1iZXJcIikge1xuICAgIHJldHVybiBCaWdJbnQodmFsdWUucmF3VmFsdWUpO1xuICB9XG4gIGlmICh0eXBlb2YgdmFsdWUucmF3VmFsdWUgIT09IFwiYmlnaW50XCIpIHtcbiAgICB2YWx1ZS50aHJvd1ZhbGlkYXRpb25FcnJvcihcbiAgICAgIG5ldyBFcnJvcihgdmFsdWUgaXMgbm90IGEgYmlnaW50LiBJdCBpcyAnJHt0eXBlb2YgdmFsdWUucmF3VmFsdWV9J2ApXG4gICAgKTtcbiAgfVxuICByZXR1cm4gdmFsdWUucmF3VmFsdWU7XG59XG5cbi8qKlxuICogVmFsaWRhdGUgdGhhdCB0aGUgdmFsdWUgdXMgYSBib29sZWFuLlxuICogQHBhcmFtIHZhbHVlXG4gKiBAcmV0dXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVCb29sZWFuKHZhbHVlOiBVbnZhbGlkYXRlZDxib29sZWFuPik6IGJvb2xlYW4ge1xuICBpZiAodHlwZW9mIHZhbHVlLnJhd1ZhbHVlICE9PSBcImJvb2xlYW5cIikge1xuICAgIHZhbHVlLnRocm93VmFsaWRhdGlvbkVycm9yKFxuICAgICAgbmV3IEVycm9yKGB2YWx1ZSBpcyBub3QgYSBib29sZWFuLiBJdCBpcyAnJHt0eXBlb2YgdmFsdWUucmF3VmFsdWV9J2ApXG4gICAgKTtcbiAgfVxuICByZXR1cm4gdmFsdWUucmF3VmFsdWU7XG59XG5cbi8qKlxuICogVmFsaWRhdGUgdGhhdCB0aGUgdmFsdWUgaXMgYW4gYXJyYXksIHVzaW5nIGEgY3VzdG9tIHZhbGlkYXRvciBmb3IgZWFjaCBlbGVtZW50LlxuICogQHBhcmFtIGFycmF5XG4gKiBAcGFyYW0gdmFsaWRhdG9yXG4gKiBAcmV0dXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVBcnJheTxULCBWID0gVD4oXG4gIGFycmF5OiBVbnZhbGlkYXRlZDxSZWFkb25seUFycmF5PFQ+PixcbiAgdmFsaWRhdG9yOiAob2JqZWN0OiBVbnZhbGlkYXRlZDxUPiwgaW5kZXg6IG51bWJlcikgPT4gVlxuKTogQXJyYXk8Vj4ge1xuICBpZiAoIUFycmF5LmlzQXJyYXkoYXJyYXkucmF3VmFsdWUpKSB7XG4gICAgYXJyYXkudGhyb3dWYWxpZGF0aW9uRXJyb3IoXG4gICAgICBuZXcgRXJyb3IoYHZhbHVlIGlzIG5vdCBhbiBhcnJheS4gSXQgaXMgJyR7dHlwZW9mIGFycmF5LnJhd1ZhbHVlfSdgKVxuICAgICk7XG4gIH1cbiAgcmV0dXJuIGFycmF5LnJhd1ZhbHVlLm1hcCgoXywgaW5kZXgpID0+IHtcbiAgICByZXR1cm4gdmFsaWRhdG9yKGFycmF5LmdldChpbmRleCksIGluZGV4KTtcbiAgfSk7XG59XG5cbi8qKlxuICogU2hvcnR1Y3QgZm9yIGNvbWJpbmluZyB7QGxpbmsgdmFsaWRhdGVBcnJheX0gd2l0aCB7QGxpbmsgdmFsaWRhdGVTdHJpbmd9XG4gKiBAcGFyYW0gb2JqZWN0XG4gKiBAcmV0dXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVTdHJpbmdBcnJheShcbiAgb2JqZWN0OiBVbnZhbGlkYXRlZDxSZWFkb25seUFycmF5PHN0cmluZz4+XG4pOiBSZWFkb25seUFycmF5PHN0cmluZz4ge1xuICByZXR1cm4gdmFsaWRhdGVBcnJheShvYmplY3QsIHZhbGlkYXRlU3RyaW5nKTtcbn1cblxuLyoqXG4gKiBWYWxpZGF0ZSBhIFJlY29yZCB3aXRoIHN0cmluZyBrZXlzIHdpdGggYSBjdXN0b20gdmFsaWRhdG9yIGZvciB0aGUgdmFsdWVzLlxuICogQHBhcmFtIHZhbHVlXG4gKiBAcGFyYW0gdmFsaWRhdG9yXG4gKiBAcmV0dXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVPYmplY3Q8VCwgUz4oXG4gIHZhbHVlOiBVbnZhbGlkYXRlZDxSZWNvcmQ8c3RyaW5nLCBUPj4sXG4gIHZhbGlkYXRvcjogKHVudmFsaWRhdGVkOiBVbnZhbGlkYXRlZDxUPiwga2V5OiBzdHJpbmcpID0+IFNcbik6IFJlY29yZDxzdHJpbmcsIFM+IHtcbiAgY29uc3QgcmF3VmFsdWUgPSB2YWx1ZS5yYXdWYWx1ZSBhcyBSZWNvcmQ8c3RyaW5nLCBUPjtcbiAgaWYgKHR5cGVvZiByYXdWYWx1ZSAhPT0gXCJvYmplY3RcIikge1xuICAgIHZhbHVlLnRocm93VmFsaWRhdGlvbkVycm9yKG5ldyBFcnJvcihgdmFsdWUgaXMgbm90IGFuIG9iamVjdGApKTtcbiAgfVxuXG4gIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW5uZWNlc3NhcnktY29uZGl0aW9uXG4gIGlmIChyYXdWYWx1ZSA9PT0gbnVsbCkge1xuICAgIHZhbHVlLnRocm93VmFsaWRhdGlvbkVycm9yKG5ldyBFcnJvcihgdmFsdWUgaXMgbnVsbGApKTtcbiAgfVxuXG4gIGlmIChBcnJheS5pc0FycmF5KHJhd1ZhbHVlKSkge1xuICAgIHZhbHVlLnRocm93VmFsaWRhdGlvbkVycm9yKFxuICAgICAgbmV3IEVycm9yKGB2YWx1ZSBpcyBub3QgYW4gb2JqZWN0LiBpdCBpcyBhbiBhcnJheWApXG4gICAgKTtcbiAgfVxuXG4gIGNvbnN0IHJlc3VsdE9iamVjdDogUmVjb3JkPHN0cmluZywgUz4gPSB7fTtcbiAgZm9yIChjb25zdCBrZXkgb2YgT2JqZWN0LmtleXMocmF3VmFsdWUpKSB7XG4gICAgcmVzdWx0T2JqZWN0W2tleV0gPSB2YWxpZGF0b3IodmFsdWUuZ2V0KGtleSksIGtleSk7XG4gIH1cbiAgcmV0dXJuIHJlc3VsdE9iamVjdDtcbn1cblxuLyoqXG4gKiBWYWxpZGF0ZSB0aGF0IHZhbHVlIGlzIGEgc3RyaW5nIHRoYXQgaXMgYSBtZW1iZXIgb2YgZ3JvdXAuXG4gKlxuICogVXNlZnVsIHdoZW4gcmVseWluZyBvbiB0eXBlIGRpc2NyaW1pbmF0aW9uIHRvIGhlbHAgZmlndXJlIG91dCB3aGljaCBjaGlsZCB0eXBlIHRvIGNhc3QgYSBwYXJlbnQgdHlwZSB0by5cbiAqIEBwYXJhbSB2YWx1ZVxuICogQHBhcmFtIGdyb3VwXG4gKiBAcmV0dXJuc1xuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVJc01lbWJlcjxTIGV4dGVuZHMgc3RyaW5nPihcbiAgdmFsdWU6IFVudmFsaWRhdGVkPFM+LFxuICBncm91cDogUmVhZG9ubHlTZXQ8Uz5cbik6IFMge1xuICBjb25zdCBzdHJpbmdWYWx1ZSA9IHZhbGlkYXRlU3RyaW5nKHZhbHVlKTtcbiAgaWYgKGdyb3VwLmhhcyhzdHJpbmdWYWx1ZSBhcyBTKSkge1xuICAgIHJldHVybiBzdHJpbmdWYWx1ZSBhcyBTO1xuICB9XG4gIHZhbHVlLnRocm93VmFsaWRhdGlvbkVycm9yKFxuICAgIG5ldyBFcnJvcihcbiAgICAgIGAnJHtzdHJpbmdWYWx1ZX0nIHdhcyBub3QgZm91bmQgaW4gJyR7SlNPTi5zdHJpbmdpZnkoWy4uLmdyb3VwXSl9J2BcbiAgICApXG4gICk7XG59XG5cbmV4cG9ydCB0eXBlIEpTT05QcmltaXRpdmUgPSBzdHJpbmcgfCBudW1iZXIgfCBib29sZWFuIHwgbnVsbCB8IHVuZGVmaW5lZDtcbmV4cG9ydCB0eXBlIEpTT05WYWx1ZSA9IEpTT05QcmltaXRpdmUgfCBKU09OT2JqZWN0IHwgUmVhZG9ubHlBcnJheTxKU09OVmFsdWU+O1xuZXhwb3J0IGludGVyZmFjZSBKU09OT2JqZWN0IHtcbiAgW2tleTogc3RyaW5nXTogSlNPTlZhbHVlIHwgdW5kZWZpbmVkO1xufVxuXG4vKipcbiAqIFZhbGlkYXRlIGEgSlNPTiB2YWx1ZS5cbiAqIEBwYXJhbSB2YWx1ZVxuICogQHJldHVybnNcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHZhbGlkYXRlSlNPTlZhbHVlKHZhbHVlOiBVbnZhbGlkYXRlZDxKU09OVmFsdWU+KTogSlNPTlZhbHVlIHtcbiAgaWYgKHZhbHVlLnJhd1ZhbHVlID09PSBudWxsKSB7XG4gICAgcmV0dXJuIHZhbHVlLnJhd1ZhbHVlO1xuICB9XG4gIGlmICh2YWx1ZS5yYXdWYWx1ZSA9PT0gdW5kZWZpbmVkKSB7XG4gICAgcmV0dXJuIHZhbHVlLnJhd1ZhbHVlO1xuICB9XG5cbiAgc3dpdGNoICh0eXBlb2YgdmFsdWUucmF3VmFsdWUpIHtcbiAgICBjYXNlIFwic3RyaW5nXCI6XG4gICAgY2FzZSBcIm51bWJlclwiOlxuICAgIGNhc2UgXCJib29sZWFuXCI6XG4gICAgICByZXR1cm4gdmFsdWUucmF3VmFsdWU7XG4gICAgY2FzZSBcIm9iamVjdFwiOiB7XG4gICAgICBpZiAoQXJyYXkuaXNBcnJheSh2YWx1ZS5yYXdWYWx1ZSkpIHtcbiAgICAgICAgcmV0dXJuIHZhbGlkYXRlQXJyYXkoXG4gICAgICAgICAgdmFsdWUuY2FzdFRvPFJlYWRvbmx5QXJyYXk8SlNPTlZhbHVlPj4oKSxcbiAgICAgICAgICB2YWxpZGF0ZUpTT05WYWx1ZVxuICAgICAgICApO1xuICAgICAgfVxuICAgICAgcmV0dXJuIHZhbGlkYXRlSlNPTk9iamVjdCh2YWx1ZS5jYXN0VG88SlNPTk9iamVjdD4oKSk7XG4gICAgfVxuICAgIGRlZmF1bHQ6XG4gICAgICB2YWx1ZS50aHJvd1ZhbGlkYXRpb25FcnJvcihuZXcgRXJyb3IoYHZhbHVlIGlzIG5vdCBhIGpzb24gdmFsdWVgKSk7XG4gIH1cbn1cblxuLyoqXG4gKiBWYWxpZGF0ZSBhIEpTT04gb2JqZWN0LlxuICogQHBhcmFtIGpzb25PYmplY3RcbiAqIEByZXR1cm5zXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB2YWxpZGF0ZUpTT05PYmplY3QoXG4gIGpzb25PYmplY3Q6IFVudmFsaWRhdGVkPEpTT05PYmplY3Q+XG4pOiBKU09OT2JqZWN0IHtcbiAgcmV0dXJuIHZhbGlkYXRlT2JqZWN0KGpzb25PYmplY3QsIHZhbGlkYXRlSlNPTlZhbHVlKTtcbn1cbiJdfQ==

package/package.json

@@ -1,6 +1,25 @@
 {
+  "description": "Library for validiating JSON-adjacent types",
+  "homepage": "https://codeberg.org/buildkitchen/validation",
+  "bugs": {
+    "url": "https://codeberg.org/buildkitchen/validation"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Kwasi Mensah",
+    "email": "kwasi.mensah@gmail.com"
+  },
+  "keywords": [
+    "validation",
+    "serialize",
+    "json"
+  ],
   "name": "@buildkitchen/validation",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "bin": {},
+  "private": false,
+  "version": "0.0.8",
+  "__buildkitchen": "Generated by buildkitchen",
+  "type": "module",
+  "bundledDependencies": [],
+  "dependencies": {}
 }