@live-state/sync 0.0.1-alpha.1 → 0.0.1-alpha.3

package/dist/index-NDRWVwih.d.ts

@@ -0,0 +1,343 @@
+import { ZodTypeAny, z } from 'zod';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+type Promisify<T> = T extends Promise<any> ? T : Promise<T>;
+type Awaitable<T> = T | Promise<T>;
+type Generatable<T, Arg = never> = T | ((arg: Arg) => T);
+
+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 OptionalLiveType<T extends LiveTypeAny> extends LiveType<T["_value"] | undefined, T["_meta"], T["_encodeInput"], T["_decodeInput"]> {
+    readonly inner: T;
+    constructor(inner: T);
+    encodeMutation(mutationType: MutationType, input: T["_value"] | undefined, timestamp: string): T["_decodeInput"];
+    mergeMutation(mutationType: MutationType, encodedMutation: T["_decodeInput"], materializedShape?: MaterializedLiveType<LiveType<T["_value"] | undefined, T["_meta"], T["_value"] | Partial<T["_value"] | undefined>, T["_decodeInput"]>> | undefined): [
+        MaterializedLiveType<LiveType<T["_value"] | undefined, T["_meta"], T["_value"] | Partial<T["_value"] | undefined>, T["_decodeInput"]>>,
+        T["_decodeInput"] | null
+    ];
+    getStorageFieldType(): StorageFieldType;
+}
+type LiveAtomicTypeMeta = {
+    timestamp: string;
+} & LiveTypeMeta;
+declare class LiveAtomicType<Value> 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?: Value;
+    readonly foreignReference?: string;
+    readonly isPrimary: boolean;
+    constructor(storageType: string, convertFunc?: (value: any) => Value, index?: boolean, unique?: boolean, defaultValue?: Value, 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>;
+    index(): LiveAtomicType<Value>;
+    default(value: Value): LiveAtomicType<Value>;
+    primary(): LiveAtomicType<Value>;
+    optional(): OptionalLiveType<this>;
+}
+declare class LiveString extends LiveAtomicType<string> {
+    private constructor();
+    static create(): LiveString;
+    static createId(): LiveAtomicType<string>;
+    static createReference(foreignField: `${string}.${string}`): LiveString;
+}
+
+type InferLiveObjectWithoutRelations<T extends LiveObjectAny> = {
+    [K in keyof T["fields"]]: InferLiveType<T["fields"][K]>;
+};
+type InferLiveObject<T extends LiveObjectAny> = InferLiveObjectWithoutRelations<T> & {
+    [K in keyof T["relations"]]: T["relations"][K]["type"] extends "one" ? InferLiveObject<T["relations"][K]["entity"]> : InferLiveObject<T["relations"][K]["entity"]>[];
+};
+type InferRelationalColumns<T extends Record<string, RelationAny>> = {
+    [K in keyof T as T[K] extends Relation<any, any, any, infer ColumnName, any, any> ? ColumnName extends string ? ColumnName : never : never]: T[K]["type"] extends "one" ? T[K] extends Relation<infer Entity, any, any, any, any, any> ? T[K]["required"] extends true ? InferIndex<Entity> : InferIndex<Entity> | undefined : never : never;
+};
+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>;
+}
+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;
+} & 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;
+    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>;
+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"];
+};
+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;
+};
+type WhereClause<T extends LiveObjectAny> = {
+    [K in keyof T["fields"]]?: InferLiveType<T["fields"][K]>;
+} & {
+    [K in keyof T["relations"]]?: WhereClause<T["relations"][K]["entity"]>;
+};
+
+type RouteRecord = Record<string, AnyRoute>;
+declare class Router<TRoutes extends RouteRecord> {
+    readonly routes: TRoutes;
+    private constructor();
+    static create<TRoutes extends RouteRecord>(opts: {
+        routes: TRoutes;
+    }): Router<TRoutes>;
+}
+type AnyRouter = Router<RouteRecord>;
+type RequestHandler<TInput, TResult, TSchema extends Schema<any> = Schema<any>> = (opts: {
+    req: ParsedRequest<TInput>;
+    db: Storage;
+    schema: TSchema;
+}) => Promise<TResult>;
+type Mutation<TInputValidator extends ZodTypeAny, // TODO use StandardSchema instead
+THandler extends RequestHandler<z.infer<TInputValidator>, any, any>> = {
+    inputValidator: TInputValidator;
+    handler: THandler;
+};
+declare const mutationCreator: <TInputValidator extends ZodTypeAny>(validator?: TInputValidator) => {
+    handler: <THandler extends RequestHandler<z.infer<TInputValidator>, any, any>>(handler: THandler) => Mutation<TInputValidator, THandler>;
+};
+declare class Route<TResourceSchema extends LiveObjectAny, TMiddleware extends Middleware<any>, TCustomMutations extends Record<string, Mutation<any, RequestHandler<any, any>>>> {
+    readonly _resourceSchema: TResourceSchema;
+    readonly resourceName: TResourceSchema["name"];
+    readonly middlewares: Set<TMiddleware>;
+    readonly customMutations: TCustomMutations;
+    constructor(resourceName: TResourceSchema["name"], customMutations?: TCustomMutations);
+    private handleFind;
+    private handleSet;
+    handleRequest(opts: {
+        req: ParsedRequest;
+        db: Storage;
+        schema: Schema<any>;
+    }): Promise<any>;
+    use(...middlewares: TMiddleware[]): this;
+    withMutations<T extends Record<string, Mutation<any, RequestHandler<any, any>>>>(mutationFactory: (opts: {
+        mutation: typeof mutationCreator;
+    }) => T): Route<TResourceSchema, TMiddleware, T>;
+}
+type AnyRoute = Route<LiveObjectAny, Middleware<any>, Record<string, any>>;
+
+declare abstract class Storage {
+    abstract updateSchema(opts: Schema<any>): Promise<void>;
+    abstract findById<T extends LiveObjectAny>(resourceName: string, id: string): Promise<MaterializedLiveType<T> | undefined>;
+    abstract find<T extends LiveObjectAny>(resourceName: string, where?: Record<string, any>): Promise<Record<string, MaterializedLiveType<T>>>;
+    abstract upsert<T extends LiveObjectAny>(resourceName: string, resourceId: string, value: MaterializedLiveType<T>): Promise<MaterializedLiveType<T>>;
+}
+
+type ParsedRequest<TInput = any> = {
+    headers: Record<string, string>;
+    cookies: Record<string, string>;
+    query: Record<string, string>;
+    resourceName: string;
+    procedure?: string;
+    context: Record<string, any>;
+    where?: Record<string, any>;
+    type: "QUERY" | "MUTATE";
+    resourceId?: string;
+    input?: TInput;
+};
+type NextFunction<T> = (req: ParsedRequest) => Promise<T> | T;
+type Middleware<T = any> = (opts: {
+    req: ParsedRequest;
+    next: NextFunction<T>;
+}) => ReturnType<NextFunction<T>>;
+
+type Simplify<T> = T extends Record<string, any> ? {
+    [K in keyof T]: Simplify<T[K]>;
+} : T;
+
+type WebSocketClientEventMap = WebSocketEventMap & {
+    connectionChange: {
+        open: boolean;
+    };
+};
+declare class WebSocketClient {
+    private ws;
+    private url;
+    private autoConnect;
+    private autoReconnect;
+    private reconnectTimeout;
+    private reconnectLimit?;
+    private reconnectAttempts;
+    private eventListeners;
+    private reconnectTimer;
+    private intentionallyDisconnected;
+    private credentials?;
+    constructor(options: {
+        url: string;
+        autoConnect?: boolean;
+        autoReconnect?: boolean;
+        reconnectTimeout?: number;
+        reconnectLimit?: number;
+        credentials?: ClientOptions["credentials"];
+    });
+    connected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): void;
+    addEventListener<K extends keyof WebSocketClientEventMap>(event: K, callback: (event: WebSocketClientEventMap[K]) => void): void;
+    removeEventListener<K extends keyof WebSocketClientEventMap>(event: K, callback: (event: WebSocketClientEventMap[K]) => void): void;
+    send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
+    private handleOpen;
+    private handleClose;
+    private handleError;
+    private handleMessage;
+    private scheduleReconnect;
+    private dispatchEvent;
+}
+
+declare const useLiveQuery: <T extends ObservableClientState<U>, U>(observable: T, opts?: {
+    subscribeToRemote?: boolean;
+}) => Simplify<ReturnType<T["get"]>>;
+declare const SubscriptionProvider: ({ children, client, }: {
+    children: React.ReactNode;
+    client: Client<AnyRouter>["client"];
+}) => react_jsx_runtime.JSX.Element;
+
+type RawObjPool = Record<string, Record<string, MaterializedLiveType<LiveObjectAny> | undefined> | undefined>;
+type ClientState<TRouter extends AnyRouter> = {
+    [K in keyof TRouter["routes"]]: Record<InferIndex<TRouter["routes"][K]["_resourceSchema"]>, InferLiveObject<TRouter["routes"][K]["_resourceSchema"]>> | undefined;
+};
+type ObservableClientState<T> = {
+    [K in keyof T]: ObservableClientState<T[K]>;
+} & {
+    get: () => T;
+    subscribe: (callback: (value: T) => void) => () => void;
+    subscribeToRemote: () => () => void;
+};
+type Client<TRouter extends AnyRouter> = {
+    client: {
+        ws: WebSocketClient;
+        subscribeToRemote: (resourceType?: string[]) => () => void;
+    };
+    store: ObservableClientState<ClientState<TRouter>> & {
+        [K in keyof TRouter["routes"]]: {
+            insert: (input: Simplify<LiveObjectMutationInput<TRouter["routes"][K]["_resourceSchema"]>>) => void;
+            update: (id: string, value: Omit<Simplify<LiveObjectMutationInput<TRouter["routes"][K]["_resourceSchema"]>>, "id">) => void;
+        };
+    } & {
+        [K in keyof TRouter["routes"]]: {
+            [K2 in keyof TRouter["routes"][K]["customMutations"]]: (input: z.infer<TRouter["routes"][K]["customMutations"][K2]["inputValidator"]>) => Promisify<ReturnType<TRouter["routes"][K]["customMutations"][K2]["handler"]>>;
+        };
+    };
+};
+type ClientOptions = {
+    url: string;
+    schema: Schema<any>;
+    credentials?: Generatable<Awaitable<Record<string, string>>>;
+};
+declare const createClient: <TRouter extends AnyRouter>(opts: ClientOptions) => Client<TRouter>;
+
+export { type AnyRouter as A, type ClientOptions as C, type InferLiveObject as I, type LiveObjectAny as L, type ObservableClientState as O, type RawObjPool as R, type Simplify as S, type WhereClause as W, type LiveObjectMutationInput as a, type ClientState as b, type Client as c, createClient as d, SubscriptionProvider as e, useLiveQuery as u };

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var o=class{_value;_meta;_encodeInput;_decodeInput};var T=class extends o{encodeMutation(n,t,e){throw new Error("Method not implemented.")}mergeMutation(n,t,e){throw new Error("Method not implemented.")}},s=class extends o{constructor(){super(),this.optional=this.optional.bind(this);}optional(){return new T}},y=class a extends s{encodeMutation(n,t,e){return {value:t,_meta:{timestamp:e}}}mergeMutation(n,t,e){return e&&e._meta.timestamp.localeCompare(t._meta.timestamp)>=0?[e,null]:[{value:Number(t.value),_meta:t._meta},t]}static create(){return new a}},M=y.create,c=class a extends s{encodeMutation(n,t,e){return {value:t,_meta:{timestamp:e}}}mergeMutation(n,t,e){return e&&e._meta.timestamp.localeCompare(t._meta.timestamp)>=0?[e,null]:[t,t]}static create(){return new a}},h=c.create;var u=class a extends o{name;fields;relations;constructor(n,t,e){super(),this.name=n,this.fields=t,this.relations=e??{};}encodeMutation(n,t,e){return Object.fromEntries(Object.entries(t).map(([r,i])=>[r,(this.fields[r]??this.relations[r]).encodeMutation("set",i,e)]))}mergeMutation(n,t,e){let r={};return [{value:{...(e==null?void 0:e.value)??{},...Object.fromEntries(Object.entries(t).map(([i,d])=>{let[v,m]=(this.fields[i]??this.relations[i]).mergeMutation(n,d,e==null?void 0:e.value[i]);return m&&(r[i]=m),[i,v]}))}},r]}setRelations(n){return new a(this.name,this.fields,n)}static create(n,t){return new a(n,t)}},A=u.create,l=class a extends o{entity;type;required;relationalColumn;foreignColumn;sourceEntity;constructor(n,t,e,r,i){super(),this.entity=n,this.type=t,this.required=i??false,this.relationalColumn=e,this.foreignColumn=r;}encodeMutation(n,t,e){if(n!=="set")throw new Error("Mutation type not implemented.");if(this.type==="many")throw new Error("Many not implemented.");return {value:t,_meta:{timestamp:e}}}mergeMutation(n,t,e){if(this.type==="many")throw new Error("Many not implemented.");return e&&e._meta.timestamp.localeCompare(t._meta.timestamp)>=0?[e,null]:[t,t]}static createOneFactory(){return (n,t,e)=>new a(n,"one",t,void 0,e??false)}static createManyFactory(){return (n,t,e)=>new a(n,"many",void 0,t,e??false)}},K=(a,n)=>({$type:"relations",objectName:a.name,relations:n({one:l.createOneFactory(),many:l.createManyFactory()})}),p=a=>Array.isArray(a.value)?a.value.map(n=>p(n)):typeof a.value!="object"?a.value:Object.fromEntries(Object.entries(a.value).map(([n,t])=>[n,p(t)])),E=a=>Object.fromEntries(Object.entries(a).flatMap(([n,t])=>{if(t.$type==="relations")return [];let e=t,r=Object.values(a).find(i=>i.$type==="relations"&&i.objectName===t.name);return r&&(e=e.setRelations(r.relations)),[[e.name,e]]}));exports.LiveNumber=y;exports.LiveObject=u;exports.LiveString=c;exports.LiveType=o;exports.Relation=l;exports.createRelations=K;exports.createSchema=E;exports.inferValue=p;exports.number=M;exports.object=A;exports.string=h;
+'use strict';var o=class{_value;_meta;_encodeInput;_decodeInput};var T=class extends o{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}}},s=class a extends o{storageType;convertFunc;isIndex;isUnique;defaultValue;foreignReference;isPrimary;constructor(e,t,n,r,i,y,c){super(),this.storageType=e,this.convertFunc=t,this.isIndex=n??false,this.isUnique=r??false,this.defaultValue=i,this.foreignReference=y,this.isPrimary=c??false;}encodeMutation(e,t,n){return {value:t,_meta:{timestamp:n}}}mergeMutation(e,t,n){return n&&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)}optional(){return new T(this)}},d=class a extends s{constructor(){super("integer",e=>Number(e));}static create(){return new a}},O=d.create,l=class a extends s{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)}},j=l.create,S=l.createId,w=l.createReference,p=class a extends s{constructor(){super("boolean",e=>typeof e=="string"?e.toLowerCase()==="true":!!e);}static create(){return new a}},I=p.create,m=class a extends s{constructor(){super("timestamp",e=>typeof e=="string"?new Date(e):e);}static create(){return new a}},A=m.create;var v=class a extends o{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,y])=>{let[c,f]=(this.fields[i]??this.relations[i]).mergeMutation(e,y,n==null?void 0:n.value[i]);return f&&(r[i]=f),[i,c]}))}},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)}},P=v.create,u=class a extends o{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.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")}`}}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)}},D=(a,e)=>({$type:"relations",objectName:a.name,relations:e({one:u.createOneFactory(),many:u.createManyFactory()})}),h=a=>{if(a)return Array.isArray(a.value)?a.value.map(e=>h(e)):typeof a.value!="object"?a.value:Object.fromEntries(Object.entries(a.value).map(([e,t])=>[e,h(t)]))},k=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=p;exports.LiveNumber=d;exports.LiveObject=v;exports.LiveString=l;exports.LiveTimestamp=m;exports.LiveType=o;exports.Relation=u;exports.boolean=I;exports.createRelations=D;exports.createSchema=k;exports.id=S;exports.inferValue=h;exports.number=O;exports.object=P;exports.reference=w;exports.string=j;exports.timestamp=A;

package/dist/index.d.cts

@@ -1,2 +1,209 @@
-export { C as ClientMessage, t as InferIndex, I as InferLiveObject, c as InferLiveObjectWithRelationalIds, r as InferLiveType, j as LiveNumber, e as LiveObject, L as LiveObjectAny, d as LiveObjectMutationInput, k as LiveString, p as LiveType, q as LiveTypeAny, l as LiveTypeMeta, g as MaterializedLiveObject, M as MaterializedLiveType, m as MutationType, R as Relation, S as Schema, b as ServerMessage, f as createRelations, h as createSchema, i as inferValue, n as number, o as object, s as string } from './index-sSVirsfN.cjs';
-import 'zod';
+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 OptionalLiveType<T extends LiveTypeAny> extends LiveType<T["_value"] | undefined, T["_meta"], T["_encodeInput"], T["_decodeInput"]> {
+    readonly inner: T;
+    constructor(inner: T);
+    encodeMutation(mutationType: MutationType, input: T["_value"] | undefined, timestamp: string): T["_decodeInput"];
+    mergeMutation(mutationType: MutationType, encodedMutation: T["_decodeInput"], materializedShape?: MaterializedLiveType<LiveType<T["_value"] | undefined, T["_meta"], T["_value"] | Partial<T["_value"] | undefined>, T["_decodeInput"]>> | undefined): [
+        MaterializedLiveType<LiveType<T["_value"] | undefined, T["_meta"], T["_value"] | Partial<T["_value"] | undefined>, T["_decodeInput"]>>,
+        T["_decodeInput"] | null
+    ];
+    getStorageFieldType(): StorageFieldType;
+}
+type LiveAtomicTypeMeta = {
+    timestamp: string;
+} & LiveTypeMeta;
+declare class LiveAtomicType<Value> 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?: Value;
+    readonly foreignReference?: string;
+    readonly isPrimary: boolean;
+    constructor(storageType: string, convertFunc?: (value: any) => Value, index?: boolean, unique?: boolean, defaultValue?: Value, 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>;
+    index(): LiveAtomicType<Value>;
+    default(value: Value): LiveAtomicType<Value>;
+    primary(): LiveAtomicType<Value>;
+    optional(): OptionalLiveType<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>;
+    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;
+
+type InferLiveObjectWithoutRelations<T extends LiveObjectAny> = {
+    [K in keyof T["fields"]]: InferLiveType<T["fields"][K]>;
+};
+type InferLiveObject<T extends LiveObjectAny> = InferLiveObjectWithoutRelations<T> & {
+    [K in keyof T["relations"]]: T["relations"][K]["type"] extends "one" ? InferLiveObject<T["relations"][K]["entity"]> : InferLiveObject<T["relations"][K]["entity"]>[];
+};
+type InferRelationalColumns<T extends Record<string, RelationAny>> = {
+    [K in keyof T as T[K] extends Relation<any, any, any, infer ColumnName, any, any> ? ColumnName extends string ? ColumnName : never : never]: T[K]["type"] extends "one" ? T[K] extends Relation<infer Entity, any, any, any, any, any> ? T[K]["required"] extends true ? InferIndex<Entity> : InferIndex<Entity> | undefined : never : never;
+};
+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;
+} & 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;
+    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]>;
+} & {
+    [K in keyof T["relations"]]?: WhereClause<T["relations"][K]["entity"]>;
+};
+
+export { type InferIndex, type InferLiveObject, type InferLiveObjectWithRelationalIds, type InferLiveType, LiveBoolean, LiveNumber, LiveObject, type LiveObjectAny, type LiveObjectMutationInput, LiveString, LiveTimestamp, LiveType, type LiveTypeAny, type LiveTypeMeta, type MaterializedLiveType, type MutationType, Relation, type Schema, type StorageFieldType, type WhereClause, boolean, createRelations, createSchema, id, inferValue, number, object, reference, string, timestamp };