@hydradb/sdk 0.0.2 → 2.0.0

package/dist/core/schemas/builders/list/list.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.list = list;
+const Schema_js_1 = require("../../Schema.js");
+const getErrorMessageForIncorrectType_js_1 = require("../../utils/getErrorMessageForIncorrectType.js");
+const maybeSkipValidation_js_1 = require("../../utils/maybeSkipValidation.js");
+const index_js_1 = require("../schema-utils/index.js");
+function list(schema) {
+    const baseSchema = {
+        parse: (raw, opts) => validateAndTransformArray(raw, (item, index) => schema.parse(item, {
+            ...opts,
+            breadcrumbsPrefix: [...(opts?.breadcrumbsPrefix ?? []), `[${index}]`],
+        })),
+        json: (parsed, opts) => validateAndTransformArray(parsed, (item, index) => schema.json(item, {
+            ...opts,
+            breadcrumbsPrefix: [...(opts?.breadcrumbsPrefix ?? []), `[${index}]`],
+        })),
+        getType: () => Schema_js_1.SchemaType.LIST,
+    };
+    return {
+        ...(0, maybeSkipValidation_js_1.maybeSkipValidation)(baseSchema),
+        ...(0, index_js_1.getSchemaUtils)(baseSchema),
+    };
+}
+function validateAndTransformArray(value, transformItem) {
+    if (!Array.isArray(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    message: (0, getErrorMessageForIncorrectType_js_1.getErrorMessageForIncorrectType)(value, "list"),
+                    path: [],
+                },
+            ],
+        };
+    }
+    const result = [];
+    const errors = [];
+    for (let i = 0; i < value.length; i++) {
+        const item = transformItem(value[i], i);
+        if (item.ok) {
+            result.push(item.value);
+        }
+        else {
+            errors.push(...item.errors);
+        }
+    }
+    if (errors.length === 0) {
+        return { ok: true, value: result };
+    }
+    return { ok: false, errors };
+}

package/dist/core/schemas/builders/literals/booleanLiteral.d.ts

@@ -0,0 +1,2 @@
+import { type Schema } from "../../Schema.js";
+export declare function booleanLiteral<V extends boolean>(literal: V): Schema<V, V>;

package/dist/core/schemas/builders/literals/booleanLiteral.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.booleanLiteral = booleanLiteral;
+const Schema_js_1 = require("../../Schema.js");
+const createIdentitySchemaCreator_js_1 = require("../../utils/createIdentitySchemaCreator.js");
+const getErrorMessageForIncorrectType_js_1 = require("../../utils/getErrorMessageForIncorrectType.js");
+function booleanLiteral(literal) {
+    const schemaCreator = (0, createIdentitySchemaCreator_js_1.createIdentitySchemaCreator)(Schema_js_1.SchemaType.BOOLEAN_LITERAL, (value, { breadcrumbsPrefix = [] } = {}) => {
+        if (value === literal) {
+            return {
+                ok: true,
+                value: literal,
+            };
+        }
+        else {
+            return {
+                ok: false,
+                errors: [
+                    {
+                        path: breadcrumbsPrefix,
+                        message: (0, getErrorMessageForIncorrectType_js_1.getErrorMessageForIncorrectType)(value, `${literal.toString()}`),
+                    },
+                ],
+            };
+        }
+    });
+    return schemaCreator();
+}

package/dist/core/schemas/builders/literals/index.d.ts

@@ -0,0 +1,2 @@
+export { booleanLiteral } from "./booleanLiteral.js";
+export { stringLiteral } from "./stringLiteral.js";

package/dist/core/schemas/builders/literals/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringLiteral = exports.booleanLiteral = void 0;
+var booleanLiteral_js_1 = require("./booleanLiteral.js");
+Object.defineProperty(exports, "booleanLiteral", { enumerable: true, get: function () { return booleanLiteral_js_1.booleanLiteral; } });
+var stringLiteral_js_1 = require("./stringLiteral.js");
+Object.defineProperty(exports, "stringLiteral", { enumerable: true, get: function () { return stringLiteral_js_1.stringLiteral; } });

package/dist/core/schemas/builders/literals/stringLiteral.d.ts

@@ -0,0 +1,2 @@
+import { type Schema } from "../../Schema.js";
+export declare function stringLiteral<V extends string>(literal: V): Schema<V, V>;

package/dist/core/schemas/builders/literals/stringLiteral.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringLiteral = stringLiteral;
+const Schema_js_1 = require("../../Schema.js");
+const createIdentitySchemaCreator_js_1 = require("../../utils/createIdentitySchemaCreator.js");
+const getErrorMessageForIncorrectType_js_1 = require("../../utils/getErrorMessageForIncorrectType.js");
+function stringLiteral(literal) {
+    const schemaCreator = (0, createIdentitySchemaCreator_js_1.createIdentitySchemaCreator)(Schema_js_1.SchemaType.STRING_LITERAL, (value, { breadcrumbsPrefix = [] } = {}) => {
+        if (value === literal) {
+            return {
+                ok: true,
+                value: literal,
+            };
+        }
+        else {
+            return {
+                ok: false,
+                errors: [
+                    {
+                        path: breadcrumbsPrefix,
+                        message: (0, getErrorMessageForIncorrectType_js_1.getErrorMessageForIncorrectType)(value, `"${literal}"`),
+                    },
+                ],
+            };
+        }
+    });
+    return schemaCreator();
+}

package/dist/core/schemas/builders/object/index.d.ts

@@ -0,0 +1,6 @@
+export { getObjectUtils, object } from "./object.js";
+export type { inferObjectWithoutOptionalPropertiesSchemaFromPropertySchemas, inferParsedObjectWithoutOptionalPropertiesFromPropertySchemas, } from "./objectWithoutOptionalProperties.js";
+export { objectWithoutOptionalProperties } from "./objectWithoutOptionalProperties.js";
+export type { Property } from "./property.js";
+export { isProperty, property } from "./property.js";
+export type { BaseObjectSchema, inferObjectSchemaFromPropertySchemas, inferParsedObject, inferParsedObjectFromPropertySchemas, inferParsedPropertySchema, inferRawKey, inferRawObject, inferRawObjectFromPropertySchemas, inferRawPropertySchema, ObjectSchema, ObjectUtils, PropertySchemas, } from "./types.js";

package/dist/core/schemas/builders/object/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.property = exports.isProperty = exports.objectWithoutOptionalProperties = exports.object = exports.getObjectUtils = void 0;
+var object_js_1 = require("./object.js");
+Object.defineProperty(exports, "getObjectUtils", { enumerable: true, get: function () { return object_js_1.getObjectUtils; } });
+Object.defineProperty(exports, "object", { enumerable: true, get: function () { return object_js_1.object; } });
+var objectWithoutOptionalProperties_js_1 = require("./objectWithoutOptionalProperties.js");
+Object.defineProperty(exports, "objectWithoutOptionalProperties", { enumerable: true, get: function () { return objectWithoutOptionalProperties_js_1.objectWithoutOptionalProperties; } });
+var property_js_1 = require("./property.js");
+Object.defineProperty(exports, "isProperty", { enumerable: true, get: function () { return property_js_1.isProperty; } });
+Object.defineProperty(exports, "property", { enumerable: true, get: function () { return property_js_1.property; } });

package/dist/core/schemas/builders/object/object.d.ts

@@ -0,0 +1,3 @@
+import type { BaseObjectSchema, inferObjectSchemaFromPropertySchemas, ObjectUtils, PropertySchemas } from "./types.js";
+export declare function object<ParsedKeys extends string, T extends PropertySchemas<ParsedKeys>>(schemas: T): inferObjectSchemaFromPropertySchemas<T>;
+export declare function getObjectUtils<Raw, Parsed>(schema: BaseObjectSchema<Raw, Parsed>): ObjectUtils<Raw, Parsed>;

package/dist/core/schemas/builders/object/object.js

@@ -0,0 +1,385 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.object = object;
+exports.getObjectUtils = getObjectUtils;
+const Schema_js_1 = require("../../Schema.js");
+const entries_js_1 = require("../../utils/entries.js");
+const filterObject_js_1 = require("../../utils/filterObject.js");
+const getErrorMessageForIncorrectType_js_1 = require("../../utils/getErrorMessageForIncorrectType.js");
+const isPlainObject_js_1 = require("../../utils/isPlainObject.js");
+const keys_js_1 = require("../../utils/keys.js");
+const maybeSkipValidation_js_1 = require("../../utils/maybeSkipValidation.js");
+const partition_js_1 = require("../../utils/partition.js");
+const index_js_1 = require("../object-like/index.js");
+const index_js_2 = require("../schema-utils/index.js");
+const property_js_1 = require("./property.js");
+// eslint-disable-next-line @typescript-eslint/unbound-method
+const _hasOwn = Object.prototype.hasOwnProperty;
+function object(schemas) {
+    // All property metadata is lazily computed on first use.
+    // This keeps schema construction free of iteration, which matters when
+    // many schemas are defined but only some are exercised at runtime.
+    // Required-key computation is also deferred because lazy() schemas may
+    // not be resolved at construction time.
+    let _rawKeyToProperty;
+    function getRawKeyToProperty() {
+        if (_rawKeyToProperty == null) {
+            _rawKeyToProperty = {};
+            for (const [parsedKey, schemaOrObjectProperty] of (0, entries_js_1.entries)(schemas)) {
+                const rawKey = (0, property_js_1.isProperty)(schemaOrObjectProperty)
+                    ? schemaOrObjectProperty.rawKey
+                    : parsedKey;
+                const valueSchema = (0, property_js_1.isProperty)(schemaOrObjectProperty)
+                    ? schemaOrObjectProperty.valueSchema
+                    : schemaOrObjectProperty;
+                _rawKeyToProperty[rawKey] = {
+                    rawKey,
+                    parsedKey: parsedKey,
+                    valueSchema,
+                };
+            }
+        }
+        return _rawKeyToProperty;
+    }
+    let _parseRequiredKeys;
+    let _jsonRequiredKeys;
+    let _parseRequiredKeysSet;
+    let _jsonRequiredKeysSet;
+    function getParseRequiredKeys() {
+        if (_parseRequiredKeys == null) {
+            _parseRequiredKeys = [];
+            _jsonRequiredKeys = [];
+            for (const [parsedKey, schemaOrObjectProperty] of (0, entries_js_1.entries)(schemas)) {
+                const rawKey = (0, property_js_1.isProperty)(schemaOrObjectProperty)
+                    ? schemaOrObjectProperty.rawKey
+                    : parsedKey;
+                const valueSchema = (0, property_js_1.isProperty)(schemaOrObjectProperty)
+                    ? schemaOrObjectProperty.valueSchema
+                    : schemaOrObjectProperty;
+                if (isSchemaRequired(valueSchema)) {
+                    _parseRequiredKeys.push(rawKey);
+                    _jsonRequiredKeys.push(parsedKey);
+                }
+            }
+            _parseRequiredKeysSet = new Set(_parseRequiredKeys);
+            _jsonRequiredKeysSet = new Set(_jsonRequiredKeys);
+        }
+        return _parseRequiredKeys;
+    }
+    function getJsonRequiredKeys() {
+        if (_jsonRequiredKeys == null) {
+            getParseRequiredKeys();
+        }
+        return _jsonRequiredKeys;
+    }
+    function getParseRequiredKeysSet() {
+        if (_parseRequiredKeysSet == null) {
+            getParseRequiredKeys();
+        }
+        return _parseRequiredKeysSet;
+    }
+    function getJsonRequiredKeysSet() {
+        if (_jsonRequiredKeysSet == null) {
+            getParseRequiredKeys();
+        }
+        return _jsonRequiredKeysSet;
+    }
+    const baseSchema = {
+        _getRawProperties: () => Object.entries(schemas).map(([parsedKey, propertySchema]) => (0, property_js_1.isProperty)(propertySchema) ? propertySchema.rawKey : parsedKey),
+        _getParsedProperties: () => (0, keys_js_1.keys)(schemas),
+        parse: (raw, opts) => {
+            const breadcrumbsPrefix = opts?.breadcrumbsPrefix ?? [];
+            return validateAndTransformObject({
+                value: raw,
+                requiredKeys: getParseRequiredKeys(),
+                requiredKeysSet: getParseRequiredKeysSet(),
+                getProperty: (rawKey) => {
+                    const property = getRawKeyToProperty()[rawKey];
+                    if (property == null) {
+                        return undefined;
+                    }
+                    return {
+                        transformedKey: property.parsedKey,
+                        transform: (propertyValue) => {
+                            const childBreadcrumbs = [...breadcrumbsPrefix, rawKey];
+                            return property.valueSchema.parse(propertyValue, {
+                                ...opts,
+                                breadcrumbsPrefix: childBreadcrumbs,
+                            });
+                        },
+                    };
+                },
+                unrecognizedObjectKeys: opts?.unrecognizedObjectKeys,
+                skipValidation: opts?.skipValidation,
+                breadcrumbsPrefix,
+                omitUndefined: opts?.omitUndefined,
+            });
+        },
+        json: (parsed, opts) => {
+            const breadcrumbsPrefix = opts?.breadcrumbsPrefix ?? [];
+            return validateAndTransformObject({
+                value: parsed,
+                requiredKeys: getJsonRequiredKeys(),
+                requiredKeysSet: getJsonRequiredKeysSet(),
+                getProperty: (parsedKey) => {
+                    const property = schemas[parsedKey];
+                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+                    if (property == null) {
+                        return undefined;
+                    }
+                    if ((0, property_js_1.isProperty)(property)) {
+                        return {
+                            transformedKey: property.rawKey,
+                            transform: (propertyValue) => {
+                                const childBreadcrumbs = [...breadcrumbsPrefix, parsedKey];
+                                return property.valueSchema.json(propertyValue, {
+                                    ...opts,
+                                    breadcrumbsPrefix: childBreadcrumbs,
+                                });
+                            },
+                        };
+                    }
+                    else {
+                        return {
+                            transformedKey: parsedKey,
+                            transform: (propertyValue) => {
+                                const childBreadcrumbs = [...breadcrumbsPrefix, parsedKey];
+                                return property.json(propertyValue, {
+                                    ...opts,
+                                    breadcrumbsPrefix: childBreadcrumbs,
+                                });
+                            },
+                        };
+                    }
+                },
+                unrecognizedObjectKeys: opts?.unrecognizedObjectKeys,
+                skipValidation: opts?.skipValidation,
+                breadcrumbsPrefix,
+                omitUndefined: opts?.omitUndefined,
+            });
+        },
+        getType: () => Schema_js_1.SchemaType.OBJECT,
+    };
+    return {
+        ...(0, maybeSkipValidation_js_1.maybeSkipValidation)(baseSchema),
+        ...(0, index_js_2.getSchemaUtils)(baseSchema),
+        ...(0, index_js_1.getObjectLikeUtils)(baseSchema),
+        ...getObjectUtils(baseSchema),
+    };
+}
+function validateAndTransformObject({ value, requiredKeys, requiredKeysSet, getProperty, unrecognizedObjectKeys = "fail", skipValidation = false, breadcrumbsPrefix = [], }) {
+    if (!(0, isPlainObject_js_1.isPlainObject)(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: (0, getErrorMessageForIncorrectType_js_1.getErrorMessageForIncorrectType)(value, "object"),
+                },
+            ],
+        };
+    }
+    // Track which required keys have been seen.
+    // Use a counter instead of copying the Set to avoid per-call allocation.
+    let missingRequiredCount = requiredKeys.length;
+    const errors = [];
+    const transformed = {};
+    for (const preTransformedKey in value) {
+        if (!_hasOwn.call(value, preTransformedKey)) {
+            continue;
+        }
+        const preTransformedItemValue = value[preTransformedKey];
+        const property = getProperty(preTransformedKey);
+        if (property != null) {
+            if (missingRequiredCount > 0 && requiredKeysSet.has(preTransformedKey)) {
+                missingRequiredCount--;
+            }
+            const value = property.transform(preTransformedItemValue);
+            if (value.ok) {
+                transformed[property.transformedKey] = value.value;
+            }
+            else {
+                transformed[preTransformedKey] = preTransformedItemValue;
+                errors.push(...value.errors);
+            }
+        }
+        else {
+            switch (unrecognizedObjectKeys) {
+                case "fail":
+                    errors.push({
+                        path: [...breadcrumbsPrefix, preTransformedKey],
+                        message: `Unexpected key "${preTransformedKey}"`,
+                    });
+                    break;
+                case "strip":
+                    break;
+                case "passthrough":
+                    transformed[preTransformedKey] = preTransformedItemValue;
+                    break;
+            }
+        }
+    }
+    if (missingRequiredCount > 0) {
+        for (const key of requiredKeys) {
+            if (!(key in value)) {
+                errors.push({
+                    path: breadcrumbsPrefix,
+                    message: `Missing required key "${key}"`,
+                });
+            }
+        }
+    }
+    if (errors.length === 0 || skipValidation) {
+        return {
+            ok: true,
+            value: transformed,
+        };
+    }
+    else {
+        return {
+            ok: false,
+            errors,
+        };
+    }
+}
+function getObjectUtils(schema) {
+    return {
+        extend: (extension) => {
+            const baseSchema = {
+                _getParsedProperties: () => [...schema._getParsedProperties(), ...extension._getParsedProperties()],
+                _getRawProperties: () => [...schema._getRawProperties(), ...extension._getRawProperties()],
+                parse: (raw, opts) => {
+                    return validateAndTransformExtendedObject({
+                        extensionKeys: extension._getRawProperties(),
+                        value: raw,
+                        transformBase: (rawBase) => schema.parse(rawBase, opts),
+                        transformExtension: (rawExtension) => extension.parse(rawExtension, opts),
+                        breadcrumbsPrefix: opts?.breadcrumbsPrefix,
+                    });
+                },
+                json: (parsed, opts) => {
+                    return validateAndTransformExtendedObject({
+                        extensionKeys: extension._getParsedProperties(),
+                        value: parsed,
+                        transformBase: (parsedBase) => schema.json(parsedBase, opts),
+                        transformExtension: (parsedExtension) => extension.json(parsedExtension, opts),
+                        breadcrumbsPrefix: opts?.breadcrumbsPrefix,
+                    });
+                },
+                getType: () => Schema_js_1.SchemaType.OBJECT,
+            };
+            return {
+                ...baseSchema,
+                ...(0, index_js_2.getSchemaUtils)(baseSchema),
+                ...(0, index_js_1.getObjectLikeUtils)(baseSchema),
+                ...getObjectUtils(baseSchema),
+            };
+        },
+        passthrough: () => {
+            const knownRawKeys = new Set(schema._getRawProperties());
+            const knownParsedKeys = new Set(schema._getParsedProperties());
+            const baseSchema = {
+                _getParsedProperties: () => schema._getParsedProperties(),
+                _getRawProperties: () => schema._getRawProperties(),
+                parse: (raw, opts) => {
+                    const transformed = schema.parse(raw, { ...opts, unrecognizedObjectKeys: "passthrough" });
+                    if (!transformed.ok) {
+                        return transformed;
+                    }
+                    const extraProperties = {};
+                    if (typeof raw === "object" && raw != null) {
+                        for (const [key, value] of Object.entries(raw)) {
+                            if (!knownRawKeys.has(key)) {
+                                extraProperties[key] = value;
+                            }
+                        }
+                    }
+                    return {
+                        ok: true,
+                        value: {
+                            ...extraProperties,
+                            ...transformed.value,
+                        },
+                    };
+                },
+                json: (parsed, opts) => {
+                    const transformed = schema.json(parsed, { ...opts, unrecognizedObjectKeys: "passthrough" });
+                    if (!transformed.ok) {
+                        return transformed;
+                    }
+                    const extraProperties = {};
+                    if (typeof parsed === "object" && parsed != null) {
+                        for (const [key, value] of Object.entries(parsed)) {
+                            if (!knownParsedKeys.has(key)) {
+                                extraProperties[key] = value;
+                            }
+                        }
+                    }
+                    return {
+                        ok: true,
+                        value: {
+                            ...extraProperties,
+                            ...transformed.value,
+                        },
+                    };
+                },
+                getType: () => Schema_js_1.SchemaType.OBJECT,
+            };
+            return {
+                ...baseSchema,
+                ...(0, index_js_2.getSchemaUtils)(baseSchema),
+                ...(0, index_js_1.getObjectLikeUtils)(baseSchema),
+                ...getObjectUtils(baseSchema),
+            };
+        },
+    };
+}
+function validateAndTransformExtendedObject({ extensionKeys, value, transformBase, transformExtension, breadcrumbsPrefix = [], }) {
+    if (!(0, isPlainObject_js_1.isPlainObject)(value)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    path: breadcrumbsPrefix,
+                    message: (0, getErrorMessageForIncorrectType_js_1.getErrorMessageForIncorrectType)(value, "object"),
+                },
+            ],
+        };
+    }
+    const extensionPropertiesSet = new Set(extensionKeys);
+    const [extensionProperties, baseProperties] = (0, partition_js_1.partition)((0, keys_js_1.keys)(value), (key) => extensionPropertiesSet.has(key));
+    const transformedBase = transformBase((0, filterObject_js_1.filterObject)(value, baseProperties));
+    const transformedExtension = transformExtension((0, filterObject_js_1.filterObject)(value, extensionProperties));
+    if (transformedBase.ok && transformedExtension.ok) {
+        return {
+            ok: true,
+            value: {
+                ...transformedBase.value,
+                ...transformedExtension.value,
+            },
+        };
+    }
+    else {
+        return {
+            ok: false,
+            errors: [
+                ...(transformedBase.ok ? [] : transformedBase.errors),
+                ...(transformedExtension.ok ? [] : transformedExtension.errors),
+            ],
+        };
+    }
+}
+function isSchemaRequired(schema) {
+    return !isSchemaOptional(schema);
+}
+function isSchemaOptional(schema) {
+    switch (schema.getType()) {
+        case Schema_js_1.SchemaType.ANY:
+        case Schema_js_1.SchemaType.UNKNOWN:
+        case Schema_js_1.SchemaType.OPTIONAL:
+        case Schema_js_1.SchemaType.OPTIONAL_NULLABLE:
+            return true;
+        default:
+            return false;
+    }
+}

package/dist/core/schemas/builders/object/objectWithoutOptionalProperties.d.ts

@@ -0,0 +1,6 @@
+import type { inferParsedPropertySchema, inferRawObjectFromPropertySchemas, ObjectSchema, PropertySchemas } from "./types.js";
+export declare function objectWithoutOptionalProperties<ParsedKeys extends string, T extends PropertySchemas<ParsedKeys>>(schemas: T): inferObjectWithoutOptionalPropertiesSchemaFromPropertySchemas<T>;
+export type inferObjectWithoutOptionalPropertiesSchemaFromPropertySchemas<T extends PropertySchemas<keyof T>> = ObjectSchema<inferRawObjectFromPropertySchemas<T>, inferParsedObjectWithoutOptionalPropertiesFromPropertySchemas<T>>;
+export type inferParsedObjectWithoutOptionalPropertiesFromPropertySchemas<T extends PropertySchemas<keyof T>> = {
+    [K in keyof T]: inferParsedPropertySchema<T[K]>;
+};

package/dist/core/schemas/builders/object/objectWithoutOptionalProperties.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectWithoutOptionalProperties = objectWithoutOptionalProperties;
+const object_js_1 = require("./object.js");
+function objectWithoutOptionalProperties(schemas) {
+    return (0, object_js_1.object)(schemas);
+}

package/dist/core/schemas/builders/object/property.d.ts

@@ -0,0 +1,8 @@
+import type { Schema } from "../../Schema.js";
+export declare function property<RawKey extends string, RawValue, ParsedValue>(rawKey: RawKey, valueSchema: Schema<RawValue, ParsedValue>): Property<RawKey, RawValue, ParsedValue>;
+export interface Property<RawKey extends string, RawValue, ParsedValue> {
+    rawKey: RawKey;
+    valueSchema: Schema<RawValue, ParsedValue>;
+    isProperty: true;
+}
+export declare function isProperty<O extends Property<any, any, any>>(maybeProperty: unknown): maybeProperty is O;

package/dist/core/schemas/builders/object/property.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.property = property;
+exports.isProperty = isProperty;
+function property(rawKey, valueSchema) {
+    return {
+        rawKey,
+        valueSchema,
+        isProperty: true,
+    };
+}
+function isProperty(maybeProperty) {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    return maybeProperty.isProperty;
+}

package/dist/core/schemas/builders/object/types.d.ts

@@ -0,0 +1,31 @@
+import type { BaseSchema, inferParsed, inferRaw, Schema } from "../../Schema.js";
+import type { addQuestionMarksToNullableProperties } from "../../utils/addQuestionMarksToNullableProperties.js";
+import type { ObjectLikeUtils } from "../object-like/index.js";
+import type { SchemaUtils } from "../schema-utils/index.js";
+import type { Property } from "./property.js";
+export type ObjectSchema<Raw, Parsed> = BaseObjectSchema<Raw, Parsed> & ObjectLikeUtils<Raw, Parsed> & ObjectUtils<Raw, Parsed> & SchemaUtils<Raw, Parsed>;
+export interface BaseObjectSchema<Raw, Parsed> extends BaseSchema<Raw, Parsed> {
+    _getRawProperties: () => (keyof Raw)[];
+    _getParsedProperties: () => (keyof Parsed)[];
+}
+export interface ObjectUtils<Raw, Parsed> {
+    extend: <RawExtension, ParsedExtension>(schemas: ObjectSchema<RawExtension, ParsedExtension>) => ObjectSchema<Raw & RawExtension, Parsed & ParsedExtension>;
+    passthrough: () => ObjectSchema<Raw & {
+        [key: string]: unknown;
+    }, Parsed & {
+        [key: string]: unknown;
+    }>;
+}
+export type inferRawObject<O extends ObjectSchema<any, any>> = O extends ObjectSchema<infer Raw, any> ? Raw : never;
+export type inferParsedObject<O extends ObjectSchema<any, any>> = O extends ObjectSchema<any, infer Parsed> ? Parsed : never;
+export type inferObjectSchemaFromPropertySchemas<T extends PropertySchemas<keyof T>> = ObjectSchema<inferRawObjectFromPropertySchemas<T>, inferParsedObjectFromPropertySchemas<T>>;
+export type inferRawObjectFromPropertySchemas<T extends PropertySchemas<keyof T>> = addQuestionMarksToNullableProperties<{
+    [ParsedKey in keyof T as inferRawKey<ParsedKey, T[ParsedKey]>]: inferRawPropertySchema<T[ParsedKey]>;
+}>;
+export type inferParsedObjectFromPropertySchemas<T extends PropertySchemas<keyof T>> = addQuestionMarksToNullableProperties<{
+    [K in keyof T]: inferParsedPropertySchema<T[K]>;
+}>;
+export type PropertySchemas<ParsedKeys extends string | number | symbol> = Record<ParsedKeys, Property<any, any, any> | Schema<any, any>>;
+export type inferRawPropertySchema<P extends Property<any, any, any> | Schema<any, any>> = P extends Property<any, infer Raw, any> ? Raw : P extends Schema<any, any> ? inferRaw<P> : never;
+export type inferParsedPropertySchema<P extends Property<any, any, any> | Schema<any, any>> = P extends Property<any, any, infer Parsed> ? Parsed : P extends Schema<any, any> ? inferParsed<P> : never;
+export type inferRawKey<ParsedKey extends string | number | symbol, P extends Property<any, any, any> | Schema<any, any>> = P extends Property<infer Raw, any, any> ? Raw : ParsedKey;

package/dist/core/schemas/builders/object-like/getObjectLikeUtils.d.ts

@@ -0,0 +1,9 @@
+import type { BaseSchema } from "../../Schema.js";
+import type { ObjectLikeSchema, ObjectLikeUtils } from "./types.js";
+export declare function getObjectLikeUtils<Raw, Parsed>(schema: BaseSchema<Raw, Parsed>): ObjectLikeUtils<Raw, Parsed>;
+/**
+ * object-like utils are defined in one file to resolve issues with circular imports
+ */
+export declare function withParsedProperties<RawObjectShape, ParsedObjectShape, Properties>(objectLike: BaseSchema<RawObjectShape, ParsedObjectShape>, properties: {
+    [K in keyof Properties]: Properties[K] | ((parsed: ParsedObjectShape) => Properties[K]);
+}): ObjectLikeSchema<RawObjectShape, ParsedObjectShape & Properties>;