@live-state/sync 0.0.4-beta.1 → 0.0.4-beta.10

package/dist/index-COp5Ib0a.d.cts

@@ -0,0 +1,282 @@
+type LiveTypeMeta = {};
+type MutationType = "set";
+type StorageFieldType = {
+    type: string;
+    nullable: boolean;
+    default?: any;
+    unique?: boolean;
+    index?: boolean;
+    primary?: boolean;
+    references?: string;
+};
+declare abstract class LiveType<Value = any, Meta extends LiveTypeMeta = LiveTypeMeta, EncodeInput = Partial<Value> | Value, DecodeInput = {
+    value: Value;
+    _meta: keyof Meta extends never ? never : Meta;
+}> {
+    readonly _value: Value;
+    readonly _meta: Meta;
+    readonly _encodeInput: EncodeInput;
+    readonly _decodeInput: DecodeInput;
+    abstract encodeMutation(mutationType: MutationType, input: EncodeInput, timestamp: string): DecodeInput;
+    /**
+     * Merges the materialized shape with the encoded mutation
+     * @param mutationType The type of mutation
+     * @param encodedMutation The encoded mutation
+     * @param materializedShape The materialized shape
+     * @returns A tuple of the new materialized shape and the accepted diff
+     */
+    abstract mergeMutation(mutationType: MutationType, encodedMutation: DecodeInput, materializedShape?: MaterializedLiveType<LiveType<Value, Meta>>): [MaterializedLiveType<LiveType<Value, Meta>>, DecodeInput | null];
+    abstract getStorageFieldType(): StorageFieldType;
+}
+type LiveTypeAny = LiveType<any, LiveTypeMeta, any, any>;
+type InferLiveType<T extends LiveTypeAny> = T["_value"] extends Record<string, LiveTypeAny> ? {
+    [K in keyof T["_value"]]: InferLiveType<T["_value"][K]>;
+} : T["_value"];
+type InferIndex<T extends LiveTypeAny> = string;
+
+declare class NullableLiveType<T extends LiveTypeAny> extends LiveType<T["_value"] | null, T["_meta"], T["_encodeInput"], T["_decodeInput"]> {
+    readonly inner: T;
+    constructor(inner: T);
+    encodeMutation(mutationType: MutationType, input: T["_value"] | null, timestamp: string): T["_decodeInput"];
+    mergeMutation(mutationType: MutationType, encodedMutation: T["_decodeInput"], materializedShape?: MaterializedLiveType<LiveType<T["_value"] | null, T["_meta"], T["_value"] | Partial<T["_value"] | null>, T["_decodeInput"]>> | undefined): [
+        MaterializedLiveType<LiveType<T["_value"] | null, T["_meta"], T["_value"] | Partial<T["_value"] | null>, T["_decodeInput"]>>,
+        T["_decodeInput"] | null
+    ];
+    getStorageFieldType(): StorageFieldType;
+}
+type LiveAtomicTypeMeta = {
+    timestamp: string | null;
+} & LiveTypeMeta;
+declare class LiveAtomicType<Value, DefaultValue = undefined> extends LiveType<Value, LiveAtomicTypeMeta, Value, {
+    value: Value;
+    _meta: LiveAtomicTypeMeta;
+}> {
+    readonly storageType: string;
+    readonly convertFunc?: (value: any) => Value;
+    readonly isIndex: boolean;
+    readonly isUnique: boolean;
+    readonly defaultValue: DefaultValue;
+    readonly foreignReference?: string;
+    readonly isPrimary: boolean;
+    constructor(storageType: string, convertFunc?: (value: any) => Value, index?: boolean, unique?: boolean, defaultValue?: DefaultValue, references?: string, primary?: boolean);
+    encodeMutation(mutationType: MutationType, input: Value, timestamp: string): {
+        value: Value;
+        _meta: LiveAtomicTypeMeta;
+    };
+    mergeMutation(mutationType: MutationType, encodedMutation: {
+        value: Value;
+        _meta: LiveAtomicTypeMeta;
+    }, materializedShape?: MaterializedLiveType<LiveType<Value, LiveAtomicTypeMeta, Value | Partial<Value>, {
+        value: Value;
+        _meta: LiveAtomicTypeMeta;
+    }>>): [
+        MaterializedLiveType<LiveType<Value, LiveAtomicTypeMeta, Value | Partial<Value>, {
+            value: Value;
+            _meta: LiveAtomicTypeMeta;
+        }>>,
+        {
+            value: Value;
+            _meta: LiveAtomicTypeMeta;
+        } | null
+    ];
+    getStorageFieldType(): StorageFieldType;
+    unique(): LiveAtomicType<Value, undefined>;
+    index(): LiveAtomicType<Value, undefined>;
+    default(value: Value): LiveAtomicType<Value, Value>;
+    primary(): LiveAtomicType<Value, undefined>;
+    nullable(): NullableLiveType<this>;
+}
+declare class LiveNumber extends LiveAtomicType<number> {
+    private constructor();
+    static create(): LiveNumber;
+}
+declare const number: typeof LiveNumber.create;
+declare class LiveString extends LiveAtomicType<string> {
+    private constructor();
+    static create(): LiveString;
+    static createId(): LiveAtomicType<string, undefined>;
+    static createReference(foreignField: `${string}.${string}`): LiveString;
+}
+declare const string: typeof LiveString.create;
+declare const id: typeof LiveString.createId;
+declare const reference: typeof LiveString.createReference;
+declare class LiveBoolean extends LiveAtomicType<boolean> {
+    private constructor();
+    static create(): LiveBoolean;
+}
+declare const boolean: typeof LiveBoolean.create;
+declare class LiveTimestamp extends LiveAtomicType<Date> {
+    private constructor();
+    static create(): LiveTimestamp;
+}
+declare const timestamp: typeof LiveTimestamp.create;
+
+/** biome-ignore-all lint/complexity/noBannedTypes: false positive */
+
+type InferLiveObjectWithoutRelations<T extends LiveObjectAny> = {
+    [K in keyof T["fields"]]: InferLiveType<T["fields"][K]>;
+};
+type InferLiveObject<T extends LiveObjectAny, Include extends IncludeClause<T> | undefined = undefined> = InferLiveObjectWithoutRelations<T> & (Include extends IncludeClause<T> ? {
+    [K in keyof T["relations"] as Include[K] extends true ? K : never]: T["relations"][K]["type"] extends "one" ? T["fields"][Exclude<T["relations"][K]["relationalColumn"], undefined>] extends NullableLiveType<any> ? InferLiveObject<T["relations"][K]["entity"]> | null : InferLiveObject<T["relations"][K]["entity"]> : InferLiveObject<T["relations"][K]["entity"]>[];
+} : {});
+type InferRelationalColumns<T extends Record<string, RelationAny>> = {
+    [K in keyof T as T[K]["type"] extends "many" ? never : T[K]["relationalColumn"]]: T[K]["required"] extends true ? InferIndex<T[K]["entity"]> : InferIndex<T[K]["entity"]> | null;
+};
+type InferLiveObjectWithRelationalIds<T extends LiveObjectAny> = keyof T["relations"] extends string ? InferLiveObjectWithoutRelations<T> & InferRelationalColumns<T["relations"]> : InferLiveObjectWithoutRelations<T>;
+type LiveObjectMutationInput<TSchema extends LiveObjectAny> = Partial<InferLiveObjectWithRelationalIds<TSchema>>;
+declare class LiveObject<TName extends string, TSchema extends Record<string, LiveTypeAny>, TRelations extends Record<string, RelationAny>> extends LiveType<TSchema, LiveTypeMeta, LiveObjectMutationInput<any>, Record<string, MaterializedLiveType<LiveTypeAny>>> {
+    readonly name: TName;
+    readonly fields: TSchema;
+    readonly relations: TRelations;
+    constructor(name: TName, fields: TSchema, relations?: TRelations);
+    encodeMutation(_mutationType: MutationType, input: LiveObjectMutationInput<this>, timestamp: string): Record<string, any>;
+    mergeMutation(mutationType: MutationType, encodedMutations: Record<string, MaterializedLiveType<LiveTypeAny>>, materializedShape?: MaterializedLiveType<this> | undefined): [MaterializedLiveType<this>, Record<string, any> | null];
+    setRelations<TRelations extends Record<string, RelationAny>>(relations: TRelations): LiveObject<this["name"], this["fields"], TRelations>;
+    getStorageFieldType(): StorageFieldType;
+    static create<TName extends string, TSchema extends Record<string, LiveTypeAny>>(name: TName, schema: TSchema): LiveObject<TName, TSchema, never>;
+}
+declare const object: typeof LiveObject.create;
+type LiveObjectAny = LiveObject<string, Record<string, LiveTypeAny>, any>;
+declare class Relation<TEntity extends LiveObjectAny, TSourceEntity extends LiveObjectAny, TType extends "one" | "many", TRelationalColumn extends keyof TSourceEntity["fields"], TForeignColumn extends keyof TEntity["fields"], TRequired extends boolean> extends LiveType<InferIndex<TEntity>, {
+    timestamp: string | null;
+} & LiveTypeMeta> {
+    readonly entity: TEntity;
+    readonly type: TType;
+    readonly required: TRequired;
+    readonly relationalColumn?: TRelationalColumn;
+    readonly foreignColumn?: TForeignColumn;
+    readonly sourceEntity: TSourceEntity;
+    private constructor();
+    encodeMutation(mutationType: MutationType, input: string, timestamp: string): {
+        value: string;
+        _meta: {
+            timestamp: string;
+        };
+    };
+    mergeMutation(mutationType: MutationType, encodedMutation: {
+        value: string;
+        _meta: {
+            timestamp: string;
+        };
+    }, materializedShape?: MaterializedLiveType<LiveString> | undefined): [
+        MaterializedLiveType<LiveString>,
+        {
+            value: string;
+            _meta: {
+                timestamp: string;
+            };
+        } | null
+    ];
+    getStorageFieldType(): StorageFieldType;
+    toJSON(): {
+        entityName: string;
+        type: TType;
+        required: TRequired;
+        relationalColumn: TRelationalColumn | undefined;
+        foreignColumn: TForeignColumn | undefined;
+    };
+    static createOneFactory<TOriginEntity extends LiveObjectAny>(): <TEntity extends LiveObjectAny, TColumn extends keyof TOriginEntity["fields"], TRequired extends boolean = false>(entity: TEntity, column: TColumn, required?: TRequired) => Relation<TEntity, TOriginEntity, "one", TColumn, never, TRequired>;
+    static createManyFactory<TOriginEntity extends LiveObjectAny>(): <TEntity extends LiveObjectAny, TColumn extends keyof TEntity["fields"], TRequired extends boolean = false>(entity: TEntity, foreignColumn: TColumn, required?: TRequired) => Relation<TEntity, TOriginEntity, "many", never, TColumn, TRequired>;
+}
+type RelationAny = Relation<LiveObjectAny, LiveObjectAny, any, any, any, any>;
+declare const createRelations: <TSourceObject extends LiveObjectAny, TRelations extends Record<string, RelationAny>>(liveObject: TSourceObject, factory: (connectors: {
+    one: ReturnType<typeof Relation.createOneFactory<TSourceObject>>;
+    many: ReturnType<typeof Relation.createManyFactory<TSourceObject>>;
+}) => TRelations) => RelationsDecl<TSourceObject["name"], TRelations>;
+type MaterializedLiveType<T extends LiveTypeAny> = {
+    value: T["_value"] extends Record<string, LiveTypeAny> ? {
+        [K in keyof T["_value"]]: MaterializedLiveType<T["_value"][K]>;
+    } : T["_value"];
+    _meta: T["_meta"];
+};
+declare const inferValue: <T extends LiveTypeAny>(type?: MaterializedLiveType<T>) => InferLiveType<T> | undefined;
+type ExtractObjectValues<T> = T[keyof T];
+type RelationsDecl<TObjectName extends string = string, TRelations extends Record<string, RelationAny> = Record<string, RelationAny>> = {
+    $type: "relations";
+    objectName: TObjectName;
+    relations: TRelations;
+};
+type ParseRelationsFromSchema<TRawSchema extends RawSchema, TObjectName extends string> = ExtractObjectValues<{
+    [K in keyof TRawSchema]: TRawSchema[K] extends RelationsDecl<infer TObjectName_, any> ? TObjectName_ extends TObjectName ? {
+        [K2 in keyof TRawSchema[K]["relations"]]: Relation<ParseObjectFromSchema<TRawSchema, TRawSchema[K]["relations"][K2]["entity"]["name"]>, TRawSchema[K]["relations"][K2]["sourceEntity"], TRawSchema[K]["relations"][K2]["type"], Exclude<TRawSchema[K]["relations"][K2]["relationalColumn"], undefined>, Exclude<TRawSchema[K]["relations"][K2]["foreignColumn"], undefined>, TRawSchema[K]["relations"][K2]["required"]>;
+    } : never : never;
+}>;
+type ParseObjectFromSchema<TRawSchema extends RawSchema, TObjectName extends string> = ExtractObjectValues<{
+    [K in keyof TRawSchema]: TRawSchema[K] extends LiveObjectAny ? TRawSchema[K]["name"] extends TObjectName ? LiveObject<TRawSchema[K]["name"], TRawSchema[K]["fields"], ParseRelationsFromSchema<TRawSchema, TRawSchema[K]["name"]>> : never : never;
+}>;
+type RawSchema = Record<string, LiveObjectAny | RelationsDecl>;
+type Schema<TRawSchema extends RawSchema> = {
+    [K in keyof TRawSchema as TRawSchema[K] extends LiveObjectAny ? TRawSchema[K]["name"] : never]: TRawSchema[K] extends LiveObjectAny ? ParseObjectFromSchema<TRawSchema, TRawSchema[K]["name"]> : never;
+};
+declare const createSchema: <TRawSchema extends RawSchema>(schema: TRawSchema) => Schema<TRawSchema>;
+type WhereClause<T extends LiveObjectAny> = ({
+    [K in keyof T["fields"]]?: InferLiveType<T["fields"][K]> | ({
+        $eq?: InferLiveType<T["fields"][K]>;
+        $in?: InferLiveType<T["fields"][K]>[];
+        $not?: InferLiveType<T["fields"][K]> | {
+            $in?: InferLiveType<T["fields"][K]>[];
+            $eq?: InferLiveType<T["fields"][K]>;
+        };
+    } & (Exclude<InferLiveType<T["fields"][K]>, null | undefined> extends number | Date ? {
+        $gt?: InferLiveType<T["fields"][K]>;
+        $gte?: InferLiveType<T["fields"][K]>;
+        $lt?: InferLiveType<T["fields"][K]>;
+        $lte?: InferLiveType<T["fields"][K]>;
+    } : {}));
+} & {
+    [K in keyof T["relations"]]?: WhereClause<T["relations"][K]["entity"]>;
+}) | {
+    $and?: WhereClause<T>[];
+    $or?: WhereClause<T>[];
+};
+type IncludeClause<T extends LiveObjectAny> = {
+    [K in keyof T["relations"]]?: boolean | IncludeClause<T["relations"][K]["entity"]>;
+};
+type GetFieldType<T> = T extends NullableLiveType<any> ? T["inner"] : T;
+type HasDefaultValue<T> = T extends LiveAtomicType<any, undefined> ? false : true;
+type InferInsert<T extends LiveObjectAny> = {
+    [K in keyof T["fields"] as HasDefaultValue<GetFieldType<T["fields"][K]>> extends true ? never : K]: InferLiveType<T["fields"][K]>;
+} & {
+    [K in keyof T["fields"] as HasDefaultValue<GetFieldType<T["fields"][K]>> extends false ? never : K]?: InferLiveType<T["fields"][K]>;
+};
+type InferUpdate<T extends LiveObjectAny> = Omit<LiveObjectMutationInput<T>, "id">;
+
+type Simplify<T> = T extends Record<string, unknown> ? {
+    [K in keyof T]: Simplify<T[K]>;
+} : T extends Array<infer U> ? Array<Simplify<U>> : T;
+declare const LogLevel: {
+    readonly CRITICAL: 0;
+    readonly ERROR: 1;
+    readonly WARN: 2;
+    readonly INFO: 3;
+    readonly DEBUG: 4;
+};
+type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+/**
+ * Logger configuration options
+ */
+interface LoggerOptions {
+    /**
+     * Minimum log level to display. Anything below this level will be muted.
+     * @default LogLevel.INFO
+     */
+    level?: LogLevel;
+    /**
+     * Optional prefix to add to all log messages
+     */
+    prefix?: string;
+}
+declare class Logger {
+    private level;
+    private prefix;
+    constructor(options?: LoggerOptions);
+    critical(...args: any[]): void;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+}
+
+export { type MutationType as A, type StorageFieldType as B, LiveType as C, type LiveTypeAny as D, type InferLiveType as E, type InferIndex as F, type InferLiveObjectWithRelationalIds as I, type LiveObjectAny as L, type MaterializedLiveType as M, NullableLiveType as N, Relation as R, type Simplify as S, type WhereClause as W, type Schema as a, type IncludeClause as b, type InferLiveObject as c, type InferInsert as d, type InferUpdate as e, Logger as f, LogLevel as g, type InferLiveObjectWithoutRelations as h, type LiveObjectMutationInput as i, LiveObject as j, createRelations as k, inferValue as l, createSchema as m, LiveAtomicType as n, object as o, LiveNumber as p, number as q, LiveString as r, string as s, id as t, reference as u, LiveBoolean as v, boolean as w, LiveTimestamp as x, timestamp as y, type LiveTypeMeta as z };

package/dist/index-COp5Ib0a.d.ts

@@ -0,0 +1,282 @@
+type LiveTypeMeta = {};
+type MutationType = "set";
+type StorageFieldType = {
+    type: string;
+    nullable: boolean;
+    default?: any;
+    unique?: boolean;
+    index?: boolean;
+    primary?: boolean;
+    references?: string;
+};
+declare abstract class LiveType<Value = any, Meta extends LiveTypeMeta = LiveTypeMeta, EncodeInput = Partial<Value> | Value, DecodeInput = {
+    value: Value;
+    _meta: keyof Meta extends never ? never : Meta;
+}> {
+    readonly _value: Value;
+    readonly _meta: Meta;
+    readonly _encodeInput: EncodeInput;
+    readonly _decodeInput: DecodeInput;
+    abstract encodeMutation(mutationType: MutationType, input: EncodeInput, timestamp: string): DecodeInput;
+    /**
+     * Merges the materialized shape with the encoded mutation
+     * @param mutationType The type of mutation
+     * @param encodedMutation The encoded mutation
+     * @param materializedShape The materialized shape
+     * @returns A tuple of the new materialized shape and the accepted diff
+     */
+    abstract mergeMutation(mutationType: MutationType, encodedMutation: DecodeInput, materializedShape?: MaterializedLiveType<LiveType<Value, Meta>>): [MaterializedLiveType<LiveType<Value, Meta>>, DecodeInput | null];
+    abstract getStorageFieldType(): StorageFieldType;
+}
+type LiveTypeAny = LiveType<any, LiveTypeMeta, any, any>;
+type InferLiveType<T extends LiveTypeAny> = T["_value"] extends Record<string, LiveTypeAny> ? {
+    [K in keyof T["_value"]]: InferLiveType<T["_value"][K]>;
+} : T["_value"];
+type InferIndex<T extends LiveTypeAny> = string;
+
+declare class NullableLiveType<T extends LiveTypeAny> extends LiveType<T["_value"] | null, T["_meta"], T["_encodeInput"], T["_decodeInput"]> {
+    readonly inner: T;
+    constructor(inner: T);
+    encodeMutation(mutationType: MutationType, input: T["_value"] | null, timestamp: string): T["_decodeInput"];
+    mergeMutation(mutationType: MutationType, encodedMutation: T["_decodeInput"], materializedShape?: MaterializedLiveType<LiveType<T["_value"] | null, T["_meta"], T["_value"] | Partial<T["_value"] | null>, T["_decodeInput"]>> | undefined): [
+        MaterializedLiveType<LiveType<T["_value"] | null, T["_meta"], T["_value"] | Partial<T["_value"] | null>, T["_decodeInput"]>>,
+        T["_decodeInput"] | null
+    ];
+    getStorageFieldType(): StorageFieldType;
+}
+type LiveAtomicTypeMeta = {
+    timestamp: string | null;
+} & LiveTypeMeta;
+declare class LiveAtomicType<Value, DefaultValue = undefined> extends LiveType<Value, LiveAtomicTypeMeta, Value, {
+    value: Value;
+    _meta: LiveAtomicTypeMeta;
+}> {
+    readonly storageType: string;
+    readonly convertFunc?: (value: any) => Value;
+    readonly isIndex: boolean;
+    readonly isUnique: boolean;
+    readonly defaultValue: DefaultValue;
+    readonly foreignReference?: string;
+    readonly isPrimary: boolean;
+    constructor(storageType: string, convertFunc?: (value: any) => Value, index?: boolean, unique?: boolean, defaultValue?: DefaultValue, references?: string, primary?: boolean);
+    encodeMutation(mutationType: MutationType, input: Value, timestamp: string): {
+        value: Value;
+        _meta: LiveAtomicTypeMeta;
+    };
+    mergeMutation(mutationType: MutationType, encodedMutation: {
+        value: Value;
+        _meta: LiveAtomicTypeMeta;
+    }, materializedShape?: MaterializedLiveType<LiveType<Value, LiveAtomicTypeMeta, Value | Partial<Value>, {
+        value: Value;
+        _meta: LiveAtomicTypeMeta;
+    }>>): [
+        MaterializedLiveType<LiveType<Value, LiveAtomicTypeMeta, Value | Partial<Value>, {
+            value: Value;
+            _meta: LiveAtomicTypeMeta;
+        }>>,
+        {
+            value: Value;
+            _meta: LiveAtomicTypeMeta;
+        } | null
+    ];
+    getStorageFieldType(): StorageFieldType;
+    unique(): LiveAtomicType<Value, undefined>;
+    index(): LiveAtomicType<Value, undefined>;
+    default(value: Value): LiveAtomicType<Value, Value>;
+    primary(): LiveAtomicType<Value, undefined>;
+    nullable(): NullableLiveType<this>;
+}
+declare class LiveNumber extends LiveAtomicType<number> {
+    private constructor();
+    static create(): LiveNumber;
+}
+declare const number: typeof LiveNumber.create;
+declare class LiveString extends LiveAtomicType<string> {
+    private constructor();
+    static create(): LiveString;
+    static createId(): LiveAtomicType<string, undefined>;
+    static createReference(foreignField: `${string}.${string}`): LiveString;
+}
+declare const string: typeof LiveString.create;
+declare const id: typeof LiveString.createId;
+declare const reference: typeof LiveString.createReference;
+declare class LiveBoolean extends LiveAtomicType<boolean> {
+    private constructor();
+    static create(): LiveBoolean;
+}
+declare const boolean: typeof LiveBoolean.create;
+declare class LiveTimestamp extends LiveAtomicType<Date> {
+    private constructor();
+    static create(): LiveTimestamp;
+}
+declare const timestamp: typeof LiveTimestamp.create;
+
+/** biome-ignore-all lint/complexity/noBannedTypes: false positive */
+
+type InferLiveObjectWithoutRelations<T extends LiveObjectAny> = {
+    [K in keyof T["fields"]]: InferLiveType<T["fields"][K]>;
+};
+type InferLiveObject<T extends LiveObjectAny, Include extends IncludeClause<T> | undefined = undefined> = InferLiveObjectWithoutRelations<T> & (Include extends IncludeClause<T> ? {
+    [K in keyof T["relations"] as Include[K] extends true ? K : never]: T["relations"][K]["type"] extends "one" ? T["fields"][Exclude<T["relations"][K]["relationalColumn"], undefined>] extends NullableLiveType<any> ? InferLiveObject<T["relations"][K]["entity"]> | null : InferLiveObject<T["relations"][K]["entity"]> : InferLiveObject<T["relations"][K]["entity"]>[];
+} : {});
+type InferRelationalColumns<T extends Record<string, RelationAny>> = {
+    [K in keyof T as T[K]["type"] extends "many" ? never : T[K]["relationalColumn"]]: T[K]["required"] extends true ? InferIndex<T[K]["entity"]> : InferIndex<T[K]["entity"]> | null;
+};
+type InferLiveObjectWithRelationalIds<T extends LiveObjectAny> = keyof T["relations"] extends string ? InferLiveObjectWithoutRelations<T> & InferRelationalColumns<T["relations"]> : InferLiveObjectWithoutRelations<T>;
+type LiveObjectMutationInput<TSchema extends LiveObjectAny> = Partial<InferLiveObjectWithRelationalIds<TSchema>>;
+declare class LiveObject<TName extends string, TSchema extends Record<string, LiveTypeAny>, TRelations extends Record<string, RelationAny>> extends LiveType<TSchema, LiveTypeMeta, LiveObjectMutationInput<any>, Record<string, MaterializedLiveType<LiveTypeAny>>> {
+    readonly name: TName;
+    readonly fields: TSchema;
+    readonly relations: TRelations;
+    constructor(name: TName, fields: TSchema, relations?: TRelations);
+    encodeMutation(_mutationType: MutationType, input: LiveObjectMutationInput<this>, timestamp: string): Record<string, any>;
+    mergeMutation(mutationType: MutationType, encodedMutations: Record<string, MaterializedLiveType<LiveTypeAny>>, materializedShape?: MaterializedLiveType<this> | undefined): [MaterializedLiveType<this>, Record<string, any> | null];
+    setRelations<TRelations extends Record<string, RelationAny>>(relations: TRelations): LiveObject<this["name"], this["fields"], TRelations>;
+    getStorageFieldType(): StorageFieldType;
+    static create<TName extends string, TSchema extends Record<string, LiveTypeAny>>(name: TName, schema: TSchema): LiveObject<TName, TSchema, never>;
+}
+declare const object: typeof LiveObject.create;
+type LiveObjectAny = LiveObject<string, Record<string, LiveTypeAny>, any>;
+declare class Relation<TEntity extends LiveObjectAny, TSourceEntity extends LiveObjectAny, TType extends "one" | "many", TRelationalColumn extends keyof TSourceEntity["fields"], TForeignColumn extends keyof TEntity["fields"], TRequired extends boolean> extends LiveType<InferIndex<TEntity>, {
+    timestamp: string | null;
+} & LiveTypeMeta> {
+    readonly entity: TEntity;
+    readonly type: TType;
+    readonly required: TRequired;
+    readonly relationalColumn?: TRelationalColumn;
+    readonly foreignColumn?: TForeignColumn;
+    readonly sourceEntity: TSourceEntity;
+    private constructor();
+    encodeMutation(mutationType: MutationType, input: string, timestamp: string): {
+        value: string;
+        _meta: {
+            timestamp: string;
+        };
+    };
+    mergeMutation(mutationType: MutationType, encodedMutation: {
+        value: string;
+        _meta: {
+            timestamp: string;
+        };
+    }, materializedShape?: MaterializedLiveType<LiveString> | undefined): [
+        MaterializedLiveType<LiveString>,
+        {
+            value: string;
+            _meta: {
+                timestamp: string;
+            };
+        } | null
+    ];
+    getStorageFieldType(): StorageFieldType;
+    toJSON(): {
+        entityName: string;
+        type: TType;
+        required: TRequired;
+        relationalColumn: TRelationalColumn | undefined;
+        foreignColumn: TForeignColumn | undefined;
+    };
+    static createOneFactory<TOriginEntity extends LiveObjectAny>(): <TEntity extends LiveObjectAny, TColumn extends keyof TOriginEntity["fields"], TRequired extends boolean = false>(entity: TEntity, column: TColumn, required?: TRequired) => Relation<TEntity, TOriginEntity, "one", TColumn, never, TRequired>;
+    static createManyFactory<TOriginEntity extends LiveObjectAny>(): <TEntity extends LiveObjectAny, TColumn extends keyof TEntity["fields"], TRequired extends boolean = false>(entity: TEntity, foreignColumn: TColumn, required?: TRequired) => Relation<TEntity, TOriginEntity, "many", never, TColumn, TRequired>;
+}
+type RelationAny = Relation<LiveObjectAny, LiveObjectAny, any, any, any, any>;
+declare const createRelations: <TSourceObject extends LiveObjectAny, TRelations extends Record<string, RelationAny>>(liveObject: TSourceObject, factory: (connectors: {
+    one: ReturnType<typeof Relation.createOneFactory<TSourceObject>>;
+    many: ReturnType<typeof Relation.createManyFactory<TSourceObject>>;
+}) => TRelations) => RelationsDecl<TSourceObject["name"], TRelations>;
+type MaterializedLiveType<T extends LiveTypeAny> = {
+    value: T["_value"] extends Record<string, LiveTypeAny> ? {
+        [K in keyof T["_value"]]: MaterializedLiveType<T["_value"][K]>;
+    } : T["_value"];
+    _meta: T["_meta"];
+};
+declare const inferValue: <T extends LiveTypeAny>(type?: MaterializedLiveType<T>) => InferLiveType<T> | undefined;
+type ExtractObjectValues<T> = T[keyof T];
+type RelationsDecl<TObjectName extends string = string, TRelations extends Record<string, RelationAny> = Record<string, RelationAny>> = {
+    $type: "relations";
+    objectName: TObjectName;
+    relations: TRelations;
+};
+type ParseRelationsFromSchema<TRawSchema extends RawSchema, TObjectName extends string> = ExtractObjectValues<{
+    [K in keyof TRawSchema]: TRawSchema[K] extends RelationsDecl<infer TObjectName_, any> ? TObjectName_ extends TObjectName ? {
+        [K2 in keyof TRawSchema[K]["relations"]]: Relation<ParseObjectFromSchema<TRawSchema, TRawSchema[K]["relations"][K2]["entity"]["name"]>, TRawSchema[K]["relations"][K2]["sourceEntity"], TRawSchema[K]["relations"][K2]["type"], Exclude<TRawSchema[K]["relations"][K2]["relationalColumn"], undefined>, Exclude<TRawSchema[K]["relations"][K2]["foreignColumn"], undefined>, TRawSchema[K]["relations"][K2]["required"]>;
+    } : never : never;
+}>;
+type ParseObjectFromSchema<TRawSchema extends RawSchema, TObjectName extends string> = ExtractObjectValues<{
+    [K in keyof TRawSchema]: TRawSchema[K] extends LiveObjectAny ? TRawSchema[K]["name"] extends TObjectName ? LiveObject<TRawSchema[K]["name"], TRawSchema[K]["fields"], ParseRelationsFromSchema<TRawSchema, TRawSchema[K]["name"]>> : never : never;
+}>;
+type RawSchema = Record<string, LiveObjectAny | RelationsDecl>;
+type Schema<TRawSchema extends RawSchema> = {
+    [K in keyof TRawSchema as TRawSchema[K] extends LiveObjectAny ? TRawSchema[K]["name"] : never]: TRawSchema[K] extends LiveObjectAny ? ParseObjectFromSchema<TRawSchema, TRawSchema[K]["name"]> : never;
+};
+declare const createSchema: <TRawSchema extends RawSchema>(schema: TRawSchema) => Schema<TRawSchema>;
+type WhereClause<T extends LiveObjectAny> = ({
+    [K in keyof T["fields"]]?: InferLiveType<T["fields"][K]> | ({
+        $eq?: InferLiveType<T["fields"][K]>;
+        $in?: InferLiveType<T["fields"][K]>[];
+        $not?: InferLiveType<T["fields"][K]> | {
+            $in?: InferLiveType<T["fields"][K]>[];
+            $eq?: InferLiveType<T["fields"][K]>;
+        };
+    } & (Exclude<InferLiveType<T["fields"][K]>, null | undefined> extends number | Date ? {
+        $gt?: InferLiveType<T["fields"][K]>;
+        $gte?: InferLiveType<T["fields"][K]>;
+        $lt?: InferLiveType<T["fields"][K]>;
+        $lte?: InferLiveType<T["fields"][K]>;
+    } : {}));
+} & {
+    [K in keyof T["relations"]]?: WhereClause<T["relations"][K]["entity"]>;
+}) | {
+    $and?: WhereClause<T>[];
+    $or?: WhereClause<T>[];
+};
+type IncludeClause<T extends LiveObjectAny> = {
+    [K in keyof T["relations"]]?: boolean | IncludeClause<T["relations"][K]["entity"]>;
+};
+type GetFieldType<T> = T extends NullableLiveType<any> ? T["inner"] : T;
+type HasDefaultValue<T> = T extends LiveAtomicType<any, undefined> ? false : true;
+type InferInsert<T extends LiveObjectAny> = {
+    [K in keyof T["fields"] as HasDefaultValue<GetFieldType<T["fields"][K]>> extends true ? never : K]: InferLiveType<T["fields"][K]>;
+} & {
+    [K in keyof T["fields"] as HasDefaultValue<GetFieldType<T["fields"][K]>> extends false ? never : K]?: InferLiveType<T["fields"][K]>;
+};
+type InferUpdate<T extends LiveObjectAny> = Omit<LiveObjectMutationInput<T>, "id">;
+
+type Simplify<T> = T extends Record<string, unknown> ? {
+    [K in keyof T]: Simplify<T[K]>;
+} : T extends Array<infer U> ? Array<Simplify<U>> : T;
+declare const LogLevel: {
+    readonly CRITICAL: 0;
+    readonly ERROR: 1;
+    readonly WARN: 2;
+    readonly INFO: 3;
+    readonly DEBUG: 4;
+};
+type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+/**
+ * Logger configuration options
+ */
+interface LoggerOptions {
+    /**
+     * Minimum log level to display. Anything below this level will be muted.
+     * @default LogLevel.INFO
+     */
+    level?: LogLevel;
+    /**
+     * Optional prefix to add to all log messages
+     */
+    prefix?: string;
+}
+declare class Logger {
+    private level;
+    private prefix;
+    constructor(options?: LoggerOptions);
+    critical(...args: any[]): void;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+}
+
+export { type MutationType as A, type StorageFieldType as B, LiveType as C, type LiveTypeAny as D, type InferLiveType as E, type InferIndex as F, type InferLiveObjectWithRelationalIds as I, type LiveObjectAny as L, type MaterializedLiveType as M, NullableLiveType as N, Relation as R, type Simplify as S, type WhereClause as W, type Schema as a, type IncludeClause as b, type InferLiveObject as c, type InferInsert as d, type InferUpdate as e, Logger as f, LogLevel as g, type InferLiveObjectWithoutRelations as h, type LiveObjectMutationInput as i, LiveObject as j, createRelations as k, inferValue as l, createSchema as m, LiveAtomicType as n, object as o, LiveNumber as p, number as q, LiveString as r, string as s, id as t, reference as u, LiveBoolean as v, boolean as w, LiveTimestamp as x, timestamp as y, type LiveTypeMeta as z };

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var s=class{_value;_meta;_encodeInput;_decodeInput};var c=class extends s{inner;constructor(e){super(),this.inner=e;}encodeMutation(e,t,n){return this.inner.encodeMutation(e,t,n)}mergeMutation(e,t,n){return this.inner.mergeMutation(e,t,n)}getStorageFieldType(){return {...this.inner.getStorageFieldType(),nullable:true}}},o=class a extends s{storageType;convertFunc;isIndex;isUnique;defaultValue;foreignReference;isPrimary;constructor(e,t,n,r,i,u,y){super(),this.storageType=e,this.convertFunc=t,this.isIndex=n??false,this.isUnique=r??false,this.defaultValue=i,this.foreignReference=u,this.isPrimary=y??false;}encodeMutation(e,t,n){return {value:t,_meta:{timestamp:n}}}mergeMutation(e,t,n){return n&&n._meta.timestamp&&t._meta.timestamp&&n._meta.timestamp.localeCompare(t._meta.timestamp)>=0?[n,null]:[{value:this.convertFunc?this.convertFunc(t.value):t.value,_meta:t._meta},t]}getStorageFieldType(){return {type:this.storageType,nullable:false,index:this.isIndex,unique:this.isUnique,default:this.defaultValue,references:this.foreignReference,primary:this.isPrimary}}unique(){return new a(this.storageType,this.convertFunc,this.isIndex,true,this.defaultValue,this.foreignReference,this.isPrimary)}index(){return new a(this.storageType,this.convertFunc,true,this.isUnique,this.defaultValue,this.foreignReference,this.isPrimary)}default(e){return new a(this.storageType,this.convertFunc,this.isIndex,this.isUnique,e,this.foreignReference,this.isPrimary)}primary(){return new a(this.storageType,this.convertFunc,this.isIndex,this.isUnique,this.defaultValue,this.foreignReference,true)}nullable(){return new c(this)}},p=class a extends o{constructor(){super("integer",e=>Number(e));}static create(){return new a}},g=p.create,l=class a extends o{constructor(e){super("varchar",void 0,void 0,void 0,void 0,e);}static create(){return new a}static createId(){return new a().index().unique().primary()}static createReference(e){return new a(e)}},b=l.create,M=l.createId,I=l.createReference,d=class a extends o{constructor(){super("boolean",e=>typeof e=="string"?e.toLowerCase()==="true":!!e);}static create(){return new a}},O=d.create,m=class a extends o{constructor(){super("timestamp",e=>typeof e=="string"?new Date(e):e);}static create(){return new a}},j=m.create;var v=class a extends s{name;fields;relations;constructor(e,t,n){super(),this.name=e,this.fields=t,this.relations=n??{};}encodeMutation(e,t,n){return Object.fromEntries(Object.entries(t).map(([r,i])=>[r,(this.fields[r]??this.relations[r]).encodeMutation("set",i,n)]))}mergeMutation(e,t,n){let r={};return [{value:{...(n==null?void 0:n.value)??{},...Object.fromEntries(Object.entries(t).map(([i,u])=>{let y=this.fields[i]??this.relations[i];if(!y)return [i,u];let[x,f]=y.mergeMutation(e,u,n==null?void 0:n.value[i]);return f&&(r[i]=f),[i,x]}))}},r]}setRelations(e){return new a(this.name,this.fields,e)}getStorageFieldType(){throw new Error("Method not implemented.")}static create(e,t){return new a(e,t)}},K=v.create,T=class a extends s{entity;type;required;relationalColumn;foreignColumn;sourceEntity;constructor(e,t,n,r,i){super(),this.entity=e,this.type=t,this.required=i??false,this.relationalColumn=n,this.foreignColumn=r;}encodeMutation(e,t,n){if(e!=="set")throw new Error("Mutation type not implemented.");if(this.type==="many")throw new Error("Many not implemented.");return {value:t,_meta:{timestamp:n}}}mergeMutation(e,t,n){if(this.type==="many")throw new Error("Many not implemented.");return n&&n._meta.timestamp&&t._meta.timestamp&&n._meta.timestamp.localeCompare(t._meta.timestamp)>=0?[n,null]:[t,t]}getStorageFieldType(){return {type:"varchar",nullable:!this.required,references:`${this.entity.name}.${String(this.foreignColumn??this.relationalColumn??"id")}`}}toJSON(){return {entityName:this.entity.name,type:this.type,required:this.required,relationalColumn:this.relationalColumn,foreignColumn:this.foreignColumn}}static createOneFactory(){return (e,t,n)=>new a(e,"one",t,void 0,n??false)}static createManyFactory(){return (e,t,n)=>new a(e,"many",void 0,t,n??false)}},A=(a,e)=>({$type:"relations",objectName:a.name,relations:e({one:T.createOneFactory(),many:T.createManyFactory()})}),h=a=>{if(a)return Array.isArray(a.value)?a.value.map(e=>h(e)):typeof a.value!="object"||a.value===null||a.value instanceof Date?a.value:Object.fromEntries(Object.entries(a.value).map(([e,t])=>[e,h(t)]))},_=a=>Object.fromEntries(Object.entries(a).flatMap(([e,t])=>{if(t.$type==="relations")return [];let n=t,r=Object.values(a).find(i=>i.$type==="relations"&&i.objectName===t.name);return r&&(n=n.setRelations(r.relations)),[[n.name,n]]}));exports.LiveBoolean=d;exports.LiveNumber=p;exports.LiveObject=v;exports.LiveString=l;exports.LiveTimestamp=m;exports.LiveType=s;exports.Relation=T;exports.boolean=O;exports.createRelations=A;exports.createSchema=_;exports.id=M;exports.inferValue=h;exports.number=g;exports.object=K;exports.reference=I;exports.string=b;exports.timestamp=j;
+'use strict';require('js-xxhash');var s=class{_value;_meta;_encodeInput;_decodeInput};var T=class extends s{inner;constructor(e){super(),this.inner=e;}encodeMutation(e,n,t){return this.inner.encodeMutation(e,n,t)}mergeMutation(e,n,t){return this.inner.mergeMutation(e,n,t)}getStorageFieldType(){return {...this.inner.getStorageFieldType(),nullable:true}}},l=class i extends s{storageType;convertFunc;isIndex;isUnique;defaultValue;foreignReference;isPrimary;constructor(e,n,t,a,r,u,y){super(),this.storageType=e,this.convertFunc=n,this.isIndex=t??false,this.isUnique=a??false,this.defaultValue=r,this.foreignReference=u,this.isPrimary=y??false;}encodeMutation(e,n,t){return {value:n,_meta:{timestamp:t}}}mergeMutation(e,n,t){return t&&t._meta.timestamp&&n._meta.timestamp&&t._meta.timestamp.localeCompare(n._meta.timestamp)>=0?[t,null]:[{value:this.convertFunc?this.convertFunc(n.value):n.value,_meta:n._meta},n]}getStorageFieldType(){return {type:this.storageType,nullable:false,index:this.isIndex,unique:this.isUnique,default:this.defaultValue,references:this.foreignReference,primary:this.isPrimary}}unique(){return new i(this.storageType,this.convertFunc,this.isIndex,true,this.defaultValue,this.foreignReference,this.isPrimary)}index(){return new i(this.storageType,this.convertFunc,true,this.isUnique,this.defaultValue,this.foreignReference,this.isPrimary)}default(e){return new i(this.storageType,this.convertFunc,this.isIndex,this.isUnique,e,this.foreignReference,this.isPrimary)}primary(){return new i(this.storageType,this.convertFunc,this.isIndex,this.isUnique,this.defaultValue,this.foreignReference,true)}nullable(){return new T(this)}},p=class i extends l{constructor(){super("integer",e=>Number(e));}static create(){return new i}},b=p.create,o=class i extends l{constructor(e){super("varchar",void 0,void 0,void 0,void 0,e);}static create(){return new i}static createId(){return new i().index().unique().primary()}static createReference(e){return new i(e)}},I=o.create,O=o.createId,A=o.createReference,d=class i extends l{constructor(){super("boolean",e=>typeof e=="string"?e.toLowerCase()==="true":!!e);}static create(){return new i}},M=d.create,f=class i extends l{constructor(){super("timestamp",e=>typeof e=="string"?new Date(e):e);}static create(){return new i}},j=f.create;var v=class i extends s{name;fields;relations;constructor(e,n,t){super(),this.name=e,this.fields=n,this.relations=t??{};}encodeMutation(e,n,t){return Object.fromEntries(Object.entries(n).map(([a,r])=>[a,(this.fields[a]??this.relations[a]).encodeMutation("set",r,t)]))}mergeMutation(e,n,t){let a={};return [{value:{...(t==null?void 0:t.value)??{},...Object.fromEntries(Object.entries(n).map(([r,u])=>{let y=this.fields[r]??this.relations[r];if(!y)return [r,u];let[L,h]=y.mergeMutation(e,u,t==null?void 0:t.value[r]);return h&&(a[r]=h),[r,L]}))}},a]}setRelations(e){return new i(this.name,this.fields,e)}getStorageFieldType(){throw new Error("Method not implemented.")}static create(e,n){return new i(e,n)}},w=v.create,c=class i extends s{entity;type;required;relationalColumn;foreignColumn;sourceEntity;constructor(e,n,t,a,r){super(),this.entity=e,this.type=n,this.required=r??false,this.relationalColumn=t,this.foreignColumn=a;}encodeMutation(e,n,t){if(e!=="set")throw new Error("Mutation type not implemented.");if(this.type==="many")throw new Error("Many not implemented.");return {value:n,_meta:{timestamp:t}}}mergeMutation(e,n,t){if(this.type==="many")throw new Error("Many not implemented.");return t&&t._meta.timestamp&&n._meta.timestamp&&t._meta.timestamp.localeCompare(n._meta.timestamp)>=0?[t,null]:[n,n]}getStorageFieldType(){return {type:"varchar",nullable:!this.required,references:`${this.entity.name}.${String(this.foreignColumn??this.relationalColumn??"id")}`}}toJSON(){return {entityName:this.entity.name,type:this.type,required:this.required,relationalColumn:this.relationalColumn,foreignColumn:this.foreignColumn}}static createOneFactory(){return (e,n,t)=>new i(e,"one",n,void 0,t??false)}static createManyFactory(){return (e,n,t)=>new i(e,"many",void 0,n,t??false)}},V=(i,e)=>({$type:"relations",objectName:i.name,relations:e({one:c.createOneFactory(),many:c.createManyFactory()})}),m=i=>i?Array.isArray(i.value)?i.value.map(n=>m(n)):typeof i.value!="object"||i.value===null||i.value instanceof Date?i.value:Object.fromEntries(Object.entries(i.value).map(([n,t])=>Array.isArray(t)?[n,t.map(a=>m(a))]:[n,m(t)])):void 0,C=i=>Object.fromEntries(Object.entries(i).flatMap(([e,n])=>{if(n.$type==="relations")return [];let t=n,a=Object.values(i).find(r=>r.$type==="relations"&&r.objectName===n.name);return a&&(t=t.setRelations(a.relations)),[[t.name,t]]}));var x={CRITICAL:0,ERROR:1,WARN:2,INFO:3,DEBUG:4};exports.LiveAtomicType=l;exports.LiveBoolean=d;exports.LiveNumber=p;exports.LiveObject=v;exports.LiveString=o;exports.LiveTimestamp=f;exports.LiveType=s;exports.LogLevel=x;exports.NullableLiveType=T;exports.Relation=c;exports.boolean=M;exports.createRelations=V;exports.createSchema=C;exports.id=O;exports.inferValue=m;exports.number=b;exports.object=w;exports.reference=A;exports.string=I;exports.timestamp=j;