@routier/core 0.1.0-rc.2 → 0.2.1

package/dist/plugins/translators/TranslatedGroupValue.d.ts

@@ -1,6 +1,8 @@
 import { ITranslatedValue } from './types';
 export declare class TranslatedGroupValue<T> implements ITranslatedValue<T> {
     readonly value: T;
-    constructor(value: unknown);
+    readonly isTransformed: boolean;
+    readonly isEmpty: boolean;
+    constructor(value: unknown, isTransformed: boolean);
     forEach(callback: (item: unknown) => unknown): void;
 }

package/dist/plugins/translators/TranslatedSingleValue.d.ts

@@ -1,6 +1,8 @@
 import { ITranslatedValue } from './types';
 export declare class TranslatedSingleValue<T> implements ITranslatedValue<T> {
     value: T;
-    constructor(value: unknown);
+    readonly isTransformed: boolean;
+    readonly isEmpty: boolean;
+    constructor(value: unknown, isTransformed: boolean);
     forEach(callback: (item: unknown) => unknown): void;
 }

package/dist/plugins/translators/TranslatedValues.test.d.ts

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

package/dist/plugins/translators/types.d.ts

@@ -2,9 +2,16 @@ export interface ITranslatedValue<T> {
     readonly value: T;
     /**
      * Iterates over items in the collection, calling the callback for each item.
-     * If the callback returns a value, that value will replace the original item in the collection.
+     * If the callback returns a value, that value replaces the original item (e.g. so
+     * changeTracker.resolve() can swap in attached/merged entities).
      *
      * @param callback Function called for each item. If it returns a value, that value replaces the original item.
      */
     forEach(callback: (item: unknown) => unknown): void;
+    /**
+     * True if the translator remapped or transformed the data from the database shape;
+     * false if the data is unchanged and in the same shape as the database.
+     */
+    readonly isTransformed: boolean;
+    readonly isEmpty: boolean;
 }

package/dist/plugins/types.d.ts

@@ -41,8 +41,12 @@ export type DbPluginEvent = {
     schemas: SchemaCollection;
     /** Unique id of the event. */
     id: string;
-    /** Source of the request */
-    source: "data-store" | "collection" | "view";
+    /** The class/component that triggered this event */
+    source: string;
+    /** The action/operation type being performed */
+    action: "query" | "persist" | "destroy";
+    /** Optional context about why this operation is happening */
+    reason?: string;
 };
 /**
  * Event for a specific plugin operation, extending the base event with an operation payload.
@@ -67,14 +71,6 @@ export type ReplicationPluginOptions = {
      */
     read?: IDbPlugin;
 };
-export type OptimisticReplicationPluginOptions = {
-    /** The primary database plugin that handles all write operations, do not include in the list of replicas. */
-    source: IDbPlugin;
-    /** Array of replica database plugins that can be used for read operations. */
-    replicas: IDbPlugin[];
-    /** Must be a MemoryPlugin */
-    read: IDbPlugin;
-};
 export type EntityUpdateInfo<T extends {}> = {
     entity: InferType<T>;
     changeType: EntityChangeType;

package/dist/results/Result.d.ts

@@ -11,13 +11,13 @@ declare abstract class BaseResult {
 }
 export declare class Result extends BaseResult {
     static success<T>(data: T): ResultType<T>;
-    static success<T>(): ResultType<never>;
+    static success(): ResultType<never>;
     static error<T>(error: any): ResultType<T>;
     static partial<T>(data: T, error: any): PartialResultType<T>;
 }
 export declare class PluginEventResult extends BaseResult {
     static success<T>(id: string, data: T): PluginEventResultType<T>;
-    static success<T>(id: string): PluginEventResultType<never>;
+    static success(id: string): PluginEventResultType<never>;
     static error<T>(id: string, error: any): PluginEventResultType<T>;
     static partial<T>(id: string, data: T, error: any): PluginEventPartialResultType<T>;
     static assertSuccess<T>(result: PluginEventResultType<T>): asserts result is {

package/dist/results/Result.test.d.ts

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

package/dist/results/index.js

@@ -1,9 +1,5 @@
 var __webpack_modules__ = ({
-"./src/results/Result.ts": 
-/*!*******************************!*\
-  !*** ./src/results/Result.ts ***!
-  \*******************************/
-(function (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+"./src/results/Result.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   PluginEventResult: () => (PluginEventResult),
@@ -85,22 +81,18 @@ class PluginEventResult extends BaseResult {
 }
 
 
-}),
-"./src/results/utils.ts": 
-/*!******************************!*\
-  !*** ./src/results/utils.ts ***!
-  \******************************/
-(function (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+},
+"./src/results/utils.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   toPromise: () => (toPromise)
 });
-/* ESM import */var _Result__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./Result */ "./src/results/Result.ts");
+/* import */ var _Result__rspack_import_0 = __webpack_require__("./src/results/Result.ts");
 
 function toPromise(fn) {
     return new Promise((resolve, reject) => {
         fn((r) => {
-            if (r.ok === _Result__WEBPACK_IMPORTED_MODULE_0__.Result.ERROR) {
+            if (r.ok === _Result__rspack_import_0.Result.ERROR) {
                 reject(r.error);
                 return;
             }
@@ -110,10 +102,9 @@ function toPromise(fn) {
 }
 
 
-}),
+},
 
 });
-/************************************************************************/
 // The module cache
 var __webpack_module_cache__ = {};
 
@@ -137,7 +128,6 @@ return module.exports;
 
 }
 
-/************************************************************************/
 // webpack/runtime/define_property_getters
 (() => {
 __webpack_require__.d = (exports, definition) => {
@@ -162,22 +152,17 @@ __webpack_require__.r = (exports) => {
 	Object.defineProperty(exports, '__esModule', { value: true });
 };
 })();
-/************************************************************************/
 var __webpack_exports__ = {};
 // This entry needs to be wrapped in an IIFE because it needs to be isolated against other modules in the chunk.
 (() => {
-
-/*!******************************!*\
-  !*** ./src/results/index.ts ***!
-  \******************************/
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-  PluginEventResult: () => (/* reexport safe */ _Result__WEBPACK_IMPORTED_MODULE_0__.PluginEventResult),
-  Result: () => (/* reexport safe */ _Result__WEBPACK_IMPORTED_MODULE_0__.Result),
-  toPromise: () => (/* reexport safe */ _utils__WEBPACK_IMPORTED_MODULE_1__.toPromise)
+  PluginEventResult: () => (/* reexport safe */ _Result__rspack_import_0.PluginEventResult),
+  Result: () => (/* reexport safe */ _Result__rspack_import_0.Result),
+  toPromise: () => (/* reexport safe */ _utils__rspack_import_1.toPromise)
 });
-/* ESM import */var _Result__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./Result */ "./src/results/Result.ts");
-/* ESM import */var _utils__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./utils */ "./src/results/utils.ts");
+/* import */ var _Result__rspack_import_0 = __webpack_require__("./src/results/Result.ts");
+/* import */ var _utils__rspack_import_1 = __webpack_require__("./src/results/utils.ts");
 
 
 

package/dist/results/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"results/index.js","sources":["webpack://@routier/core/./src/results/Result.ts","webpack://@routier/core/./src/results/utils.ts","webpack://@routier/core/webpack/runtime/define_property_getters","webpack://@routier/core/webpack/runtime/has_own_property","webpack://@routier/core/webpack/runtime/make_namespace_object","webpack://@routier/core/./src/results/index.ts"],"sourcesContent":["import { PartialResultType, PluginEventPartialResultType, PluginEventResultType, ResultType } from \"./types\";\n\nabstract class BaseResult {\n    static ERROR = \"error\" as const;\n    static SUCCESS = \"success\" as const;\n    static PARTIAL = \"partial\" as const;\n\n    static resolve<T>(result: ResultType<T> | PartialResultType<T>, resolve: (data: T) => void, reject: (error?: any) => void) {\n        if (result.ok === BaseResult.SUCCESS) {\n            resolve(result.data);\n            return;\n        }\n\n        if (result.ok === BaseResult.PARTIAL) {\n            reject({\n                partial: result.data,\n                error: result.error\n            });\n            return;\n        }\n\n        reject(result.error);\n    }\n\n    static assertSuccess<T>(result: any): asserts result is { ok: \"success\"; data: T } {\n        if (result.ok !== BaseResult.SUCCESS) {\n            throw new Error(`Expected success result, but got ${result.ok}: ${result.error}`);\n        }\n    }\n}\n\nexport class Result extends BaseResult {\n    static success<T>(data: T): ResultType<T>;\n    static success<T>(): ResultType<never>;\n    static success<T>(data?: T): ResultType<T> {\n        return {\n            ok: Result.SUCCESS,\n            data\n        }\n    }\n\n    static error<T>(error: any): ResultType<T> {\n        return {\n            ok: Result.ERROR,\n            error\n        }\n    }\n\n    static partial<T>(data: T, error: any): PartialResultType<T> {\n        return {\n            ok: Result.PARTIAL,\n            data,\n            error\n        }\n    }\n}\n\nexport class PluginEventResult extends BaseResult {\n    static success<T>(id: string, data: T): PluginEventResultType<T>;\n    static success<T>(id: string): PluginEventResultType<never>;\n    static success<T>(id: string, data?: T): PluginEventResultType<T> {\n        return {\n            id,\n            ok: Result.SUCCESS,\n            data\n        }\n    }\n\n    static error<T>(id: string, error: any): PluginEventResultType<T> {\n        return {\n            id,\n            ok: Result.ERROR,\n            error\n        }\n    }\n\n    static partial<T>(id: string, data: T, error: any): PluginEventPartialResultType<T> {\n        return {\n            id,\n            ok: Result.PARTIAL,\n            data,\n            error\n        }\n    }\n\n    static assertSuccess<T>(result: PluginEventResultType<T>): asserts result is { ok: \"success\"; data: T; id: string } {\n        if (result.ok !== Result.SUCCESS) {\n            throw new Error(`Expected success result, but got ${result.ok}: ${result.error}`);\n        }\n    }\n}\n","import { Result } from \"./Result\";\nimport { CallbackResult } from \"./types\";\n\nexport function toPromise<T>(fn: (callback: CallbackResult<T>) => void) {\n    return new Promise<T>((resolve, reject) => {\n        fn((r) => {\n            if (r.ok === Result.ERROR) {\n                reject(r.error);\n                return;\n            }\n\n            resolve(r.data);\n        });\n    });\n}\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","export * from './Result';\nexport * from './types';\nexport * from './utils';"],"names":[],"mappings":";;;;;;;;;;;AAEA,MAAe,UAAU;IACrB,MAAM,CAAC,KAAK,GAAG,OAAgB,CAAC;IAChC,MAAM,CAAC,OAAO,GAAG,SAAkB,CAAC;IACpC,MAAM,CAAC,OAAO,GAAG,SAAkB,CAAC;IAEpC,MAAM,CAAC,OAAO,CAAI,MAA4C,EAAE,OAA0B,EAAE,MAA6B;QACrH,IAAI,MAAM,CAAC,EAAE,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO;QACX,CAAC;QAED,IAAI,MAAM,CAAC,EAAE,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,CAAC,IAAI;gBACpB,KAAK,EAAE,MAAM,CAAC,KAAK;aACtB,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,aAAa,CAAI,MAAW;QAC/B,IAAI,MAAM,CAAC,EAAE,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACtF,CAAC;IACL,CAAC;;AAGE,MAAM,MAAO,SAAQ,UAAU;IAGlC,MAAM,CAAC,OAAO,CAAI,IAAQ;QACtB,OAAO;YACH,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,IAAI;SACP;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAI,KAAU;QACtB,OAAO;YACH,EAAE,EAAE,MAAM,CAAC,KAAK;YAChB,KAAK;SACR;IACL,CAAC;IAED,MAAM,CAAC,OAAO,CAAI,IAAO,EAAE,KAAU;QACjC,OAAO;YACH,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,IAAI;YACJ,KAAK;SACR;IACL,CAAC;CACJ;AAEM,MAAM,iBAAkB,SAAQ,UAAU;IAG7C,MAAM,CAAC,OAAO,CAAI,EAAU,EAAE,IAAQ;QAClC,OAAO;YACH,EAAE;YACF,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,IAAI;SACP;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAI,EAAU,EAAE,KAAU;QAClC,OAAO;YACH,EAAE;YACF,EAAE,EAAE,MAAM,CAAC,KAAK;YAChB,KAAK;SACR;IACL,CAAC;IAED,MAAM,CAAC,OAAO,CAAI,EAAU,EAAE,IAAO,EAAE,KAAU;QAC7C,OAAO;YACH,EAAE;YACF,EAAE,EAAE,MAAM,CAAC,OAAO;YAClB,IAAI;YACJ,KAAK;SACR;IACL,CAAC;IAED,MAAM,CAAC,aAAa,CAAI,MAAgC;QACpD,IAAI,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACtF,CAAC;IACL,CAAC;CACJ;;;;;;;;;;;;;;AC1FiC;AAG3B,SAAS,SAAS,CAAI,EAAyC;IAClE,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACL,IAAI,CAAC,CAAC,EAAE,KAAK,iDAAY,EAAE,CAAC;gBACxB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAChB,OAAO;YACX,CAAC;YAED,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACdD;AACA;AACA;AACA,kDAAkD,wCAAwC;AAC1F;AACA;AACA;;;;ACNA;;;;ACAA;AACA;AACA;AACA,uDAAuD,iBAAiB;AACxE;AACA,gDAAgD,aAAa;AAC7D;;;;;;;;;;;;;;;;;;ACNyB;AACD;AACA"}
+{"version":3,"file":"results/index.js","sources":["webpack://@routier/core/./src/results/Result.ts","webpack://@routier/core/./src/results/utils.ts","webpack://@routier/core/webpack/runtime/define_property_getters","webpack://@routier/core/webpack/runtime/has_own_property","webpack://@routier/core/webpack/runtime/make_namespace_object","webpack://@routier/core/./src/results/index.ts"],"sourcesContent":["import { PartialResultType, PluginEventPartialResultType, PluginEventResultType, ResultType } from \"./types\";\n\nabstract class BaseResult {\n    static ERROR = \"error\" as const;\n    static SUCCESS = \"success\" as const;\n    static PARTIAL = \"partial\" as const;\n\n    static resolve<T>(result: ResultType<T> | PartialResultType<T>, resolve: (data: T) => void, reject: (error?: any) => void) {\n        if (result.ok === BaseResult.SUCCESS) {\n            resolve(result.data);\n            return;\n        }\n\n        if (result.ok === BaseResult.PARTIAL) {\n            reject({\n                partial: result.data,\n                error: result.error\n            });\n            return;\n        }\n\n        reject(result.error);\n    }\n\n    static assertSuccess<T>(result: any): asserts result is { ok: \"success\"; data: T } {\n        if (result.ok !== BaseResult.SUCCESS) {\n            throw new Error(`Expected success result, but got ${result.ok}: ${result.error}`);\n        }\n    }\n}\n\nexport class Result extends BaseResult {\n    static success<T>(data: T): ResultType<T>;\n    static success(): ResultType<never>;\n    static success<T>(data?: T): ResultType<T> {\n        return {\n            ok: Result.SUCCESS,\n            data\n        }\n    }\n\n    static error<T>(error: any): ResultType<T> {\n        return {\n            ok: Result.ERROR,\n            error\n        }\n    }\n\n    static partial<T>(data: T, error: any): PartialResultType<T> {\n        return {\n            ok: Result.PARTIAL,\n            data,\n            error\n        }\n    }\n}\n\nexport class PluginEventResult extends BaseResult {\n    static success<T>(id: string, data: T): PluginEventResultType<T>;\n    static success(id: string): PluginEventResultType<never>;\n    static success<T>(id: string, data?: T): PluginEventResultType<T> {\n        return {\n            id,\n            ok: Result.SUCCESS,\n            data\n        }\n    }\n\n    static error<T>(id: string, error: any): PluginEventResultType<T> {\n        return {\n            id,\n            ok: Result.ERROR,\n            error\n        }\n    }\n\n    static partial<T>(id: string, data: T, error: any): PluginEventPartialResultType<T> {\n        return {\n            id,\n            ok: Result.PARTIAL,\n            data,\n            error\n        }\n    }\n\n    static assertSuccess<T>(result: PluginEventResultType<T>): asserts result is { ok: \"success\"; data: T; id: string } {\n        if (result.ok !== Result.SUCCESS) {\n            throw new Error(`Expected success result, but got ${result.ok}: ${result.error}`);\n        }\n    }\n}\n","import { Result } from \"./Result\";\nimport { CallbackResult } from \"./types\";\n\nexport function toPromise<T>(fn: (callback: CallbackResult<T>) => void) {\n    return new Promise<T>((resolve, reject) => {\n        fn((r) => {\n            if (r.ok === Result.ERROR) {\n                reject(r.error);\n                return;\n            }\n\n            resolve(r.data);\n        });\n    });\n}\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","export * from './Result';\nexport * from './types';\nexport * from './utils';"],"names":[],"mappings":"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"}

package/dist/results/utils.test.d.ts

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

package/dist/schema/PropertyInfo.d.ts

@@ -1,6 +1,6 @@
 import { UnknownRecord } from '../utilities';
 import { SchemaBase } from './property/base/SchemaBase';
-import { DefaultValue, FunctionBody, PropertyDeserializer, PropertySerializer, SchemaTypes } from './types';
+import { DefaultValue, ForeignKey, FunctionBody, PropertyDeserializer, PropertySerializer, SchemaTypes } from './types';
 /**
  * Represents metadata and utilities for a property in a schema, including its type, name, parent, children, and serialization details.
  */
@@ -18,6 +18,8 @@ export declare class PropertyInfo<T extends {}> {
     readonly isOptional: boolean;
     /** Whether the property is a key. */
     readonly isKey: boolean;
+    /** Foreign key schema and property */
+    readonly foreignKeyDefinition: ForeignKey<unknown> | null;
     /** Whether the property is an identity property. */
     readonly isIdentity: boolean;
     /** Whether the property is readonly. */
@@ -46,6 +48,8 @@ export declare class PropertyInfo<T extends {}> {
     readonly innerSchema?: SchemaBase<unknown, any>;
     /** Literal values allowed for this property. */
     readonly literals: T[];
+    /** Tags passed from the schema */
+    readonly tags: string[];
     /** The parent property, if any. */
     readonly parent?: PropertyInfo<T>;
     private _propertyChainCache?;

package/dist/schema/SchemaDefinition.d.ts

@@ -1,17 +1,46 @@
 import { SchemaFunction } from './table/SchemaFunction';
 import { SchemaComputed } from './table/SchemaComputed';
 import { SchemaBase } from "./property/base/SchemaBase";
-import { CompiledSchema, InferType, SchemaTypes } from './types';
+import { CollectionName, CompiledSchema, CompiledSchemaWithMetadata, InferCreateType, InferType, SchemaTypes } from './types';
+import { StandardJSONSchemaV1 } from './utils/standardJsonSchema';
 export declare class SchemaDefinition<T extends {}> extends SchemaBase<T, any> {
     instance: T;
     type: SchemaTypes;
-    collectionName: string;
-    constructor(collectionName: string, schema: T);
+    collectionName: CollectionName;
+    constructor(collectionName: CollectionName, schema: T);
+    /**
+     * Creates a SchemaDefinition from a JSON string containing a JSON Schema.
+     * Parses the JSON string, rehydrates the schema structure, and compiles it.
+     *
+     * @param jsonString - The JSON string containing the JSON Schema (typically from `schema['~standard'].jsonSchema.input()` or `output()`)
+     * @param collectionName - Optional collection name override (if not present in JSON Schema metadata)
+     * @returns A compiled schema ready to use
+     * @throws Error if the JSON string is invalid or doesn't contain a valid JSON Schema
+     *
+     * @example
+     * ```typescript
+     * // Serialize a schema to JSON
+     * const jsonSchema = mySchema['~standard'].jsonSchema.input({ target: 'draft-2020-12' });
+     * const jsonString = JSON.stringify(jsonSchema);
+     *
+     * // Rehydrate from JSON string
+     * const rehydratedSchema = SchemaDefinition.fromJson(jsonString);
+     * // Schema is already compiled and ready to use
+     * ```
+     */
+    static fromJson(jsonString: string, collectionName?: string): CompiledSchema<any>;
+    /**
+     * Standard JSON Schema V1 implementation.
+     * Provides JSON Schema conversion for Routier schemas.
+     */
+    get '~standard'(): StandardJSONSchemaV1.Props<InferCreateType<T>, InferType<T>>;
+    private createReturnFunction;
+    private createFunction;
     modify<R>(builder: (d: {
-        function: <UU, I = never>(fn: (entity: InferType<CompiledSchema<T>>, collectionName: string, injected: I) => UU, injected?: I) => SchemaFunction<UU, I, "unmapped">;
-        computed: <UU, I = never>(fn: (entity: InferType<CompiledSchema<T>>, collectionName: string, injected: I) => UU, injected?: I) => SchemaComputed<UU, I, "computed" | "unmapped">;
+        function: <UU, I = never>(fn: (entity: InferType<CompiledSchema<T>>, collectionName: CollectionName, injected: I) => UU, injected?: I) => SchemaFunction<UU, I, "unmapped">;
+        computed: <UU, I = never>(fn: (entity: InferType<CompiledSchema<T>>, collectionName: CollectionName, injected: I) => UU, injected?: I) => SchemaComputed<UU, I, "computed" | "unmapped">;
     }) => R): SchemaDefinition<R & T>;
     private _iterate;
-    private createChangeTracker;
+    compile<TMetadata>(metadata: TMetadata): CompiledSchemaWithMetadata<T, TMetadata>;
     compile(): CompiledSchema<T>;
 }

package/dist/schema/communication/broadcast.test.d.ts

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

package/dist/schema/index.d.ts

@@ -5,3 +5,5 @@ export * from './property/modifiers';
 export * from './property/types';
 export * from './PropertyInfo';
 export * from './types';
+export * from './utils/standardJsonSchema';
+export * from './SchemaDefinition';