@snowtop/ent 0.1.0-alpha14 → 0.1.0-alpha140

package/action/orchestrator.d.ts

@@ -1,11 +1,12 @@
-import { ID, Data, Ent, Viewer, EntConstructor, LoadEntOptions } from "../core/base";
-import { AssocEdgeInputOptions, DataOperation } from "../core/ent";
+import { ID, Data, Ent, Viewer, LoadEntOptions, CreateRowOptions } from "../core/base";
 import { SchemaInputType, FieldInfoMap } from "../schema/schema";
-import { Changeset, Executor } from "../action/action";
+import { Changeset, ChangesetOptions, Executor } from "../action/action";
+import { AssocEdgeInputOptions, DataOperation, AssocEdgeOptions } from "./operations";
 import { WriteOperation, Builder, Action } from "../action";
-declare type MaybeNull<T extends Ent> = T | null;
-declare type TMaybleNullableEnt<T extends Ent> = T | MaybeNull<T>;
-export interface OrchestratorOptions<TEnt extends Ent<TViewer>, TViewer extends Viewer, TInput extends Data, TExistingEnt extends TMaybleNullableEnt<TEnt> = MaybeNull<TEnt>> {
+import * as clause from "../core/clause";
+type MaybeNull<T extends Ent> = T | null;
+type TMaybleNullableEnt<T extends Ent> = T | MaybeNull<T>;
+export interface OrchestratorOptions<TEnt extends Ent<TViewer>, TInput extends Data, TViewer extends Viewer, TExistingEnt extends TMaybleNullableEnt<TEnt> = MaybeNull<TEnt>> {
     viewer: Viewer;
     operation: WriteOperation;
     tableName: string;
@@ -16,6 +17,7 @@ export interface OrchestratorOptions<TEnt extends Ent<TViewer>, TViewer extends
     schema: SchemaInputType;
     editedFields(): Map<string, any> | Promise<Map<string, any>>;
     updateInput?: (data: TInput) => void;
+    expressions?: Map<string, clause.Clause>;
     fieldInfo: FieldInfoMap;
 }
 interface edgeInputDataOpts {
@@ -35,6 +37,7 @@ export declare class Orchestrator<TEnt extends Ent<TViewer>, TInput extends Data
     private options;
     private edgeSet;
     private edges;
+    private conditionalEdges;
     private validatedFields;
     private logValues;
     private changesets;
@@ -47,14 +50,17 @@ export declare class Orchestrator<TEnt extends Ent<TViewer>, TInput extends Data
     private actualOperation;
     private existingEnt;
     private disableTransformations;
+    private onConflict;
     private memoizedGetFields;
-    constructor(options: OrchestratorOptions<TEnt, TViewer, TInput, TExistingEnt>);
+    constructor(options: OrchestratorOptions<TEnt, TInput, TViewer, TExistingEnt>);
+    __getOptions(): OrchestratorOptions<any, any, any, any>;
     private addEdge;
     setDisableTransformations(val: boolean): void;
+    setOnConflictOptions(onConflict: CreateRowOptions["onConflict"]): void;
     addInboundEdge<T2 extends Ent>(id1: ID | Builder<T2, any>, edgeType: string, nodeType: string, options?: AssocEdgeInputOptions): void;
     addOutboundEdge<T2 extends Ent>(id2: ID | Builder<T2, any>, edgeType: string, nodeType: string, options?: AssocEdgeInputOptions): void;
-    removeInboundEdge(id1: ID, edgeType: string): void;
-    removeOutboundEdge(id2: ID, edgeType: string): void;
+    removeInboundEdge(id1: ID, edgeType: string, options?: AssocEdgeOptions): void;
+    removeOutboundEdge(id2: ID, edgeType: string, options?: AssocEdgeOptions): void;
     getInputEdges(edgeType: string, op: WriteOperation): EdgeInputData[];
     clearInputEdges(edgeType: string, op: WriteOperation, id?: ID): void;
     private buildMainOp;
@@ -66,6 +72,11 @@ export declare class Orchestrator<TEnt extends Ent<TViewer>, TInput extends Data
     private getWriteOpForSQLStamentOp;
     getPossibleUnsafeEntForPrivacy(): Promise<TEnt>;
     getEditedData(): Promise<Data>;
+    /**
+     * @returns validated and formatted fields that would be written to the db
+     * throws an error if called before valid() or validX() has been called
+     */
+    getValidatedFields(): Data;
     private getFieldsInfo;
     private validate;
     private triggers;
@@ -79,7 +90,17 @@ export declare class Orchestrator<TEnt extends Ent<TViewer>, TInput extends Data
     private formatAndValidateFields;
     valid(): Promise<boolean>;
     validX(): Promise<void>;
+    /**
+     * @experimental API that's not guaranteed to remain in the future which returns
+     * a list of errors encountered
+     * 0 errors indicates valid
+     * NOTE that this currently doesn't catch errors returned by validators().
+     * If those throws, this still throws and doesn't return them
+     */
+    validWithErrors(): Promise<Error[]>;
+    private buildPlusChangeset;
     build(): Promise<EntChangeset<TEnt>>;
+    buildWithOptions_BETA(options: ChangesetOptions): Promise<EntChangeset<TEnt>>;
     private viewerForEntLoad;
     returnedRow(): Promise<Data | null>;
     editedEnt(): Promise<TEnt | null>;
@@ -87,14 +108,16 @@ export declare class Orchestrator<TEnt extends Ent<TViewer>, TInput extends Data
 }
 export declare class EntChangeset<T extends Ent> implements Changeset {
     viewer: Viewer;
+    private builder;
     readonly placeholderID: ID;
-    readonly ent: EntConstructor<T>;
+    private conditionalOverride;
     operations: DataOperation[];
     dependencies?: Map<ID, Builder<Ent<Viewer<Ent<any> | null, ID | null>>, Viewer<Ent<any> | null, ID | null>, Ent<Viewer<Ent<any> | null, ID | null>> | null>> | undefined;
     changesets?: Changeset[] | undefined;
     private options?;
     private _executor;
-    constructor(viewer: Viewer, placeholderID: ID, ent: EntConstructor<T>, operations: DataOperation[], dependencies?: Map<ID, Builder<Ent<Viewer<Ent<any> | null, ID | null>>, Viewer<Ent<any> | null, ID | null>, Ent<Viewer<Ent<any> | null, ID | null>> | null>> | undefined, changesets?: Changeset[] | undefined, options?: OrchestratorOptions<T, Viewer<Ent<any> | null, ID | null>, Data, MaybeNull<T>> | undefined);
+    constructor(viewer: Viewer, builder: Builder<T>, placeholderID: ID, conditionalOverride: boolean, operations: DataOperation[], dependencies?: Map<ID, Builder<Ent<Viewer<Ent<any> | null, ID | null>>, Viewer<Ent<any> | null, ID | null>, Ent<Viewer<Ent<any> | null, ID | null>> | null>> | undefined, changesets?: Changeset[] | undefined, options?: OrchestratorOptions<T, Data, Viewer<Ent<any> | null, ID | null>, MaybeNull<T>> | undefined);
+    static changesetFrom(builder: Builder<any, any, any>, ops: DataOperation[]): EntChangeset<any>;
     executor(): Executor;
 }
 export {};