sg-widgets-core 0.2.0 → 0.3.1

package/dist/mock.d.mts

@@ -1,4 +1,4 @@
-import { A as UploadFile, At as TextSearchFilter, D as TextSearchRow, H as StatusRecord, S as SummarizeResult, _ as SearchOptions, a as EntityTypeInfo, b as SgClient, c as EventLogResult, d as HierarchyPath, ft as FieldSchema, i as EntityRow, j as UploadResult, k as ThreadRow, l as FollowingOptions, n as BatchResult, s as EventLogOptions, t as BatchRequest, u as HierarchyNode, v as SearchResult, wt as EntityRef, x as SummarizeOptions } from "./client-B2PCySg9.mjs";
+import { A as ThreadRow, C as SummarizeResult, M as UploadResult, O as TextSearchRow, S as SummarizeOptions, Tt as EntityRef, U as StatusRecord, a as EntityTypeInfo, c as EventLogResult, d as HierarchyPath, h as ReadOptions, i as EntityRow, j as UploadFile, jt as TextSearchFilter, l as FollowingOptions, n as BatchResult, pt as FieldSchema, s as EventLogOptions, t as BatchRequest, u as HierarchyNode, v as SearchOptions, x as SgClient, y as SearchResult } from "./client-CP9sWEVZ.mjs";
 //#region src/mock.d.ts
 /** What the next call should throw instead of answering. */
 export interface MockFailure {
@@ -38,6 +38,10 @@ export declare class MockClient implements SgClient {
   private readonly retired;
   /** Rows a batch created with no `project`: no read reaches them, a delete does (report 001). */
   private readonly unreadable;
+  /** What a Task delete did to other rows, by `Task:id`, for its revive to undo (089_task_delete_side_effects). */
+  private readonly cascades;
+  /** The highest id handed out per type, so an erased row's id is never reused. */
+  private readonly issued;
   private deletes;
   constructor(options?: MockClientOptions);
   /**
@@ -53,6 +57,7 @@ export declare class MockClient implements SgClient {
   fields(entityType: string, projectId?: number): Promise<Record<string, FieldSchema>>;
   fieldWithProject(entityType: string, field: string, projectId: number): Promise<FieldSchema>;
   search(entityType: string, options: SearchOptions): Promise<SearchResult>;
+  read(entityType: string, id: number, options?: ReadOptions): Promise<EntityRow>;
   textSearch(text: string, entityTypes: Record<string, TextSearchFilter>, page?: {
     size?: number;
     number?: number;
@@ -118,13 +123,50 @@ export declare class MockClient implements SgClient {
   private createRow;
   /**
    * Retire one row: reads skip it and a second delete is 404 (delete_entity_type_id).
-   * The mock retires only the row; what a delete does to rows that link to it
-   * (probe 060, 089_task_delete_side_effects) is not modelled.
+   * A Task takes its TaskDependency rows with it and leaves `Version.sg_task` and
+   * `PublishedFile.task` null until its revive (089_task_delete_side_effects), alone or
+   * in a batch (103_batch_delete_revive). A TaskTemplate retires its tasks
+   * (entity_types/TaskTemplate). What a Shot delete does to its Versions (probe 060)
+   * is not modelled.
    */
   delete(entityType: string, id: number): Promise<void>;
   private deleteRow;
-  /** Bring a retired row back with its values; `false` for a row that is already live (post_entity_type_id). */
+  /**
+   * Bring a retired row back with its values; `false` for a row that is already live
+   * (post_entity_type_id). A Task gets back what its delete took (089_task_delete_side_effects).
+   * A TaskDependency whose pair is linked again refuses, the pair being a unique index
+   * (095_dependency_remove_undo). A TaskTemplate's tasks stay retired: unmeasured.
+   */
   revive(entityType: string, id: number): Promise<boolean>;
+  private retire;
+  private unretire;
+  /** Remove a row for good: no read reaches it and no revive brings it back. */
+  private erase;
+  private live;
+  /** The live TaskDependency rows with this Task at either end. */
+  private edgesOf;
+  /** Whether a live row already links this row's pair. */
+  private pairTaken;
+  /** Whether `from` depends on `target`, directly or through other Tasks. */
+  private dependsOn;
+  /**
+   * The checks a TaskDependency create makes: one of four types, one row per pair, and
+   * no loop of any length (085_task_dependency_types, 107_dependency_three_task_loop).
+   */
+  private checkEdge;
+  /**
+   * A write to `upstream_tasks` or `downstream_tasks`: a new neighbour gets a row of the
+   * default type and no offset, a dropped one's row is erased, not retired
+   * (086_batch_tasks_with_dependencies, 095_dependency_remove_undo).
+   */
+  private writeEdges;
+  /** Where the written field is one side of a two-sided link, make the other side agree. */
+  private mirror;
+  /**
+   * What the server derives from other rows: a Task's two edge lists from the
+   * TaskDependency rows, their ids and name, and a template's task count, a string.
+   */
+  private derive;
   /**
    * Apply the requests in order, and undo all of them when one fails (recipes/002).
    * A create or update row carries the record under `data`; a delete row is flat.
@@ -147,6 +189,13 @@ export declare class MockClient implements SgClient {
    * missing key (field_types/entity).
    */
   private checkLink;
+  /**
+   * Values the server checks beyond their shape. A status code must be in the site-wide
+   * `valid_values`, hidden ones included, and a create or any batch request wraps the
+   * refusal (field_types/status_list, recipes/002, 094_permission_preflight). A
+   * TaskTemplate's `entity_type` must name a type (entity_types/TaskTemplate).
+   */
+  private checkValue;
   /** The next free id of a type, which is what a create takes. */
   private nextId;
   /** The reverse view of a link the server fills in: a Reply lands in `Note.replies`. */