@dosgato/templating 0.0.23 → 0.0.26

package/dist/apitemplate.d.ts

@@ -1,6 +1,16 @@
-import { PageWithAncestors, ComponentData } from './component.js';
+import { PageRecord, ComponentData, PageData } from './component.js';
 import { LinkDefinition } from './links.js';
 export declare type APITemplateType = 'page' | 'component' | 'data';
+export declare enum ValidationMessageType {
+    ERROR = "error",
+    WARNING = "warning",
+    SUCCESS = "success"
+}
+export interface ValidationFeedback {
+    type: `${ValidationMessageType}`;
+    path?: string;
+    message: string;
+}
 /**
  * This interface lays out the structure the API needs for each template in the system.
  */
@@ -41,17 +51,22 @@ export interface APITemplate {
     getFulltext: FulltextGatheringFn;
     /**
      * Each template must provide a validation function so that the API can enforce its data is
-     * shaped properly. If there are no issues, it should return an empty object {}, otherwise it
-     * should return an object with keys that reference the path to the error and values that
-     * are an array of error messages pertaining to that path.
+     * shaped properly.
+     *
+     * Each entry in the return array can have a type of error, warning, or success. Errors
+     * represent a validation failure and mean that saving will not succeed. Warnings are shown
+     * to the editor but do not prevent saving. Success messages postively affirm valid input - for
+     * instance, a name they chose is available.
      *
-     * For instance, if name is required and the user didn't provide one, you would return:
-     * { name: ['A name is required.'] }
+     * As an example, if name is required and the user didn't provide one, you would return:
+     * [{ type: 'error', path: 'name', message: 'A name is required.' }]
      *
      * This method is async so that you can do things like look in the database for conflicting
-     * names.
+     * names. The full page data, the path to this component, and a GraphQL query executor are
+     * available as parameters in case you need them. Keep in mind that the current editor MUST
+     * have access to any data you attempt to query in GraphQL.
      */
-    validate: (data: any) => Promise<Record<string, string[]>>;
+    validate: (data: ComponentData, query: <T>(query: string, variables?: any) => Promise<T>, page: PageData, path: string) => Promise<ValidationFeedback[]>;
     /**
      * Hard-coded properties that may be set on page templates to influence the rendering of
      * components on the page. For instance, a set of color choices that are customized for
@@ -85,8 +100,8 @@ export interface APITemplate {
  */
 export interface Migration {
     createdAt: Date;
-    up: (data: ComponentData, page: PageWithAncestors) => ComponentData | Promise<ComponentData>;
-    down: (data: ComponentData, page: PageWithAncestors) => ComponentData | Promise<ComponentData>;
+    up: (data: ComponentData, page: PageRecord) => ComponentData | Promise<ComponentData>;
+    down: (data: ComponentData, page: PageRecord) => ComponentData | Promise<ComponentData>;
 }
 export declare type LinkGatheringFn = (data: any) => LinkDefinition[];
 export declare type FulltextGatheringFn = (data: any) => string[];

package/dist/apitemplate.js

@@ -1,4 +1,10 @@
 import { stopwords } from './stopwords.js';
+export var ValidationMessageType;
+(function (ValidationMessageType) {
+    ValidationMessageType["ERROR"] = "error";
+    ValidationMessageType["WARNING"] = "warning";
+    ValidationMessageType["SUCCESS"] = "success";
+})(ValidationMessageType || (ValidationMessageType = {}));
 /**
  * This function is used by API template definitions to help them identify links inside large blocks
  * of text and return them for indexing.

package/dist/component.d.ts

@@ -166,9 +166,6 @@ export interface PageRecord<DataType extends PageData = PageData> {
     path: string;
     data: DataType;
 }
-export interface PageWithAncestors<DataType extends PageData = PageData> extends PageRecord<DataType> {
-    ancestors: PageRecord<PageData>[];
-}
 export interface ComponentData {
     templateKey: string;
     areas?: Record<string, ComponentData[]>;
@@ -194,7 +191,6 @@ export interface ContextBase {
 }
 export declare abstract class Page<DataType extends PageData = any, FetchedType = any, RenderContextType extends ContextBase = any> extends Component<DataType, FetchedType, RenderContextType> {
     pagePath: string;
-    ancestors: PageRecord[];
     /**
      * we will fill this before rendering, stuff that dosgato knows needs to be added to
      * the <head> element
@@ -202,5 +198,5 @@ export declare abstract class Page<DataType extends PageData = any, FetchedType
      */
     headContent: string;
     protected passError(e: Error, path: string): void;
-    constructor(page: PageWithAncestors<DataType>);
+    constructor(page: PageRecord<DataType>);
 }

package/dist/component.js

@@ -167,7 +167,6 @@ export class Page extends Component {
     constructor(page) {
         super(page.data, '/', undefined);
         this.pagePath = page.path;
-        this.ancestors = page.ancestors;
     }
     passError(e, path) {
         console.warn(`Recoverable issue occured during render of ${this.pagePath}. Component at ${path} threw the following error:`, e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosgato/templating",
-  "version": "0.0.23",
+  "version": "0.0.26",
   "description": "A library to support building templates for dosgato CMS.",
   "type": "module",
   "exports": {