@routier/core 0.2.0 → 0.2.1

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

@@ -1,6 +1,8 @@
 import { ITranslatedValue } from './types';
 export declare class TranslatedArrayValue<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/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" | "capability";
+    /** 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.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":"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"}
+{"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":";;;;;;;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,qCAAY,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,E;;;;ACNA,wF;;;;ACAA;AACA;AACA;AACA,uDAAuD,iBAAiB;AACxE;AACA,gDAAgD,aAAa;AAC7D,E;;;;;;;;;;;;;ACNyB;AACD;AACA"}

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,12 +1,39 @@
 import { SchemaFunction } from './table/SchemaFunction';
 import { SchemaComputed } from './table/SchemaComputed';
 import { SchemaBase } from "./property/base/SchemaBase";
-import { CollectionName, 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: 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: {
@@ -14,5 +41,6 @@ export declare class SchemaDefinition<T extends {}> extends SchemaBase<T, any> {
         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;
+    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';