@miradorlabs/web-grpc 2.75.0 → 2.77.0

package/proto/gateway/web/v1/metric_gateway.ts

@@ -186,6 +186,45 @@ export function timeseriesStyleToJSON(object: TimeseriesStyle): string {
   }
 }
 
+export enum StatReduction {
+  /** STAT_REDUCTION_UNSPECIFIED - Sum of each series' latest value. */
+  STAT_REDUCTION_UNSPECIFIED = 0,
+  /**
+   * STAT_REDUCTION_COUNT - Number of series whose latest value is non-zero. A client that merges
+   * series (e.g. the principals seated to one organization member) counts the
+   * merged ones.
+   */
+  STAT_REDUCTION_COUNT = 1,
+  UNRECOGNIZED = -1,
+}
+
+export function statReductionFromJSON(object: any): StatReduction {
+  switch (object) {
+    case 0:
+    case "STAT_REDUCTION_UNSPECIFIED":
+      return StatReduction.STAT_REDUCTION_UNSPECIFIED;
+    case 1:
+    case "STAT_REDUCTION_COUNT":
+      return StatReduction.STAT_REDUCTION_COUNT;
+    case -1:
+    case "UNRECOGNIZED":
+    default:
+      return StatReduction.UNRECOGNIZED;
+  }
+}
+
+export function statReductionToJSON(object: StatReduction): string {
+  switch (object) {
+    case StatReduction.STAT_REDUCTION_UNSPECIFIED:
+      return "STAT_REDUCTION_UNSPECIFIED";
+    case StatReduction.STAT_REDUCTION_COUNT:
+      return "STAT_REDUCTION_COUNT";
+    case StatReduction.UNRECOGNIZED:
+    default:
+      return "UNRECOGNIZED";
+  }
+}
+
 export interface StreamMetricsRequest {
   /** Verified against the caller's identity before proxying. */
   organizationId: string;
@@ -400,6 +439,11 @@ export interface Widget {
   timeseriesStyle: TimeseriesStyle;
   /** MARKDOWN widgets only: the rendered content (≤16 KiB). */
   markdown: string;
+  /**
+   * STAT only: how the figure reduces the query's series. UNSPECIFIED sums
+   * each series' latest value.
+   */
+  statReduction: StatReduction;
 }
 
 /**
@@ -463,7 +507,7 @@ export interface DashboardSummary {
 
 /**
  * UpdateDashboardRequest replaces the dashboard document. A version mismatch
- * fails with FAILED_PRECONDITION and the caller re-fetches, merges, retries.
+ * reports STATUS_CODE_CONFLICT and the caller re-fetches, merges, retries.
  */
 export interface UpdateDashboardRequest {
   /** Verified against the caller's identity before proxying. */
@@ -493,6 +537,47 @@ export interface DeleteDashboardResponse {
   status: ResponseStatus | undefined;
 }
 
+/**
+ * DashboardTemplate is a starter dashboard document, identified by a stable,
+ * product-prefixed id (e.g. `terma.spend-tokens`) that is never renamed.
+ */
+export interface DashboardTemplate {
+  id: string;
+  name: string;
+  description: string;
+  defaultTimeWindow: AnalyticsTimeWindow;
+  widgets: Widget[];
+}
+
+export interface ListDashboardTemplatesRequest {
+  /** Verified against the caller's identity before proxying. */
+  organizationId: string;
+}
+
+export interface ListDashboardTemplatesResponse {
+  status: ResponseStatus | undefined;
+  templates: DashboardTemplate[];
+}
+
+export interface CreateDashboardFromTemplateRequest {
+  /** Verified against the caller's identity before proxying. */
+  organizationId: string;
+  projectId: string;
+  templateId: string;
+  /** Unset = the template's. */
+  name?: string | undefined;
+  description?:
+    | string
+    | undefined;
+  /** UNSPECIFIED = the template's. */
+  defaultTimeWindow: AnalyticsTimeWindow;
+}
+
+export interface CreateDashboardFromTemplateResponse {
+  status: ResponseStatus | undefined;
+  dashboard: Dashboard | undefined;
+}
+
 export interface StreamDashboardDataRequest {
   /** Verified against the caller's identity before proxying. */
   organizationId: string;
@@ -3053,6 +3138,7 @@ function createBaseWidget(): Widget {
     timeInterval: 0,
     timeseriesStyle: 0,
     markdown: "",
+    statReduction: 0,
   };
 }
 
@@ -3085,6 +3171,9 @@ export const Widget: MessageFns<Widget> = {
     if (message.markdown !== "") {
       writer.uint32(74).string(message.markdown);
     }
+    if (message.statReduction !== 0) {
+      writer.uint32(80).int32(message.statReduction);
+    }
     return writer;
   },
 
@@ -3173,6 +3262,14 @@ export const Widget: MessageFns<Widget> = {
             message.markdown = reader.string();
             continue;
           }
+          case 10: {
+            if (tag !== 80) {
+              break;
+            }
+
+            message.statReduction = reader.int32() as any;
+            continue;
+          }
         }
         if ((tag & 7) === 4 || tag === 0) {
           break;
@@ -3212,6 +3309,11 @@ export const Widget: MessageFns<Widget> = {
         ? timeseriesStyleFromJSON(object.timeseries_style)
         : 0,
       markdown: isSet(object.markdown) ? globalThis.String(object.markdown) : "",
+      statReduction: isSet(object.statReduction)
+        ? statReductionFromJSON(object.statReduction)
+        : isSet(object.stat_reduction)
+        ? statReductionFromJSON(object.stat_reduction)
+        : 0,
     };
   },
 
@@ -3244,6 +3346,9 @@ export const Widget: MessageFns<Widget> = {
     if (message.markdown !== "") {
       obj.markdown = message.markdown;
     }
+    if (message.statReduction !== 0) {
+      obj.statReduction = statReductionToJSON(message.statReduction);
+    }
     return obj;
   },
 
@@ -3263,6 +3368,7 @@ export const Widget: MessageFns<Widget> = {
     message.timeInterval = object.timeInterval ?? 0;
     message.timeseriesStyle = object.timeseriesStyle ?? 0;
     message.markdown = object.markdown ?? "";
+    message.statReduction = object.statReduction ?? 0;
     return message;
   },
 };
@@ -4658,31 +4764,31 @@ export const DeleteDashboardResponse: MessageFns<DeleteDashboardResponse> = {
   },
 };
 
-function createBaseStreamDashboardDataRequest(): StreamDashboardDataRequest {
-  return { organizationId: "", projectId: "", dashboardId: "", widgetIds: [], timeRange: undefined };
+function createBaseDashboardTemplate(): DashboardTemplate {
+  return { id: "", name: "", description: "", defaultTimeWindow: 0, widgets: [] };
 }
 
-export const StreamDashboardDataRequest: MessageFns<StreamDashboardDataRequest> = {
-  encode(message: StreamDashboardDataRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
-    if (message.organizationId !== "") {
-      writer.uint32(10).string(message.organizationId);
+export const DashboardTemplate: MessageFns<DashboardTemplate> = {
+  encode(message: DashboardTemplate, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.id !== "") {
+      writer.uint32(10).string(message.id);
     }
-    if (message.projectId !== "") {
-      writer.uint32(18).string(message.projectId);
+    if (message.name !== "") {
+      writer.uint32(18).string(message.name);
     }
-    if (message.dashboardId !== "") {
-      writer.uint32(26).string(message.dashboardId);
+    if (message.description !== "") {
+      writer.uint32(26).string(message.description);
     }
-    for (const v of message.widgetIds) {
-      writer.uint32(34).string(v!);
+    if (message.defaultTimeWindow !== 0) {
+      writer.uint32(32).int32(message.defaultTimeWindow);
     }
-    if (message.timeRange !== undefined) {
-      TimeRange.encode(message.timeRange, writer.uint32(42).fork()).join();
+    for (const v of message.widgets) {
+      Widget.encode(v!, writer.uint32(42).fork()).join();
     }
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): StreamDashboardDataRequest {
+  decode(input: BinaryReader | Uint8Array, length?: number): DashboardTemplate {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -4691,7 +4797,7 @@ export const StreamDashboardDataRequest: MessageFns<StreamDashboardDataRequest>
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseStreamDashboardDataRequest();
+      const message = createBaseDashboardTemplate();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
@@ -4700,7 +4806,7 @@ export const StreamDashboardDataRequest: MessageFns<StreamDashboardDataRequest>
               break;
             }
 
-            message.organizationId = reader.string();
+            message.id = reader.string();
             continue;
           }
           case 2: {
@@ -4708,7 +4814,7 @@ export const StreamDashboardDataRequest: MessageFns<StreamDashboardDataRequest>
               break;
             }
 
-            message.projectId = reader.string();
+            message.name = reader.string();
             continue;
           }
           case 3: {
@@ -4716,15 +4822,15 @@ export const StreamDashboardDataRequest: MessageFns<StreamDashboardDataRequest>
               break;
             }
 
-            message.dashboardId = reader.string();
+            message.description = reader.string();
             continue;
           }
           case 4: {
-            if (tag !== 34) {
+            if (tag !== 32) {
               break;
             }
 
-            message.widgetIds.push(reader.string());
+            message.defaultTimeWindow = reader.int32() as any;
             continue;
           }
           case 5: {
@@ -4732,7 +4838,7 @@ export const StreamDashboardDataRequest: MessageFns<StreamDashboardDataRequest>
               break;
             }
 
-            message.timeRange = TimeRange.decode(reader, reader.uint32());
+            message.widgets.push(Widget.decode(reader, reader.uint32()));
             continue;
           }
         }
@@ -4747,97 +4853,67 @@ export const StreamDashboardDataRequest: MessageFns<StreamDashboardDataRequest>
     }
   },
 
-  fromJSON(object: any): StreamDashboardDataRequest {
+  fromJSON(object: any): DashboardTemplate {
     return {
-      organizationId: isSet(object.organizationId)
-        ? globalThis.String(object.organizationId)
-        : isSet(object.organization_id)
-        ? globalThis.String(object.organization_id)
-        : "",
-      projectId: isSet(object.projectId)
-        ? globalThis.String(object.projectId)
-        : isSet(object.project_id)
-        ? globalThis.String(object.project_id)
-        : "",
-      dashboardId: isSet(object.dashboardId)
-        ? globalThis.String(object.dashboardId)
-        : isSet(object.dashboard_id)
-        ? globalThis.String(object.dashboard_id)
-        : "",
-      widgetIds: globalThis.Array.isArray(object?.widgetIds)
-        ? object.widgetIds.map((e: any) => globalThis.String(e))
-        : globalThis.Array.isArray(object?.widget_ids)
-        ? object.widget_ids.map((e: any) => globalThis.String(e))
-        : [],
-      timeRange: isSet(object.timeRange)
-        ? TimeRange.fromJSON(object.timeRange)
-        : isSet(object.time_range)
-        ? TimeRange.fromJSON(object.time_range)
-        : undefined,
+      id: isSet(object.id) ? globalThis.String(object.id) : "",
+      name: isSet(object.name) ? globalThis.String(object.name) : "",
+      description: isSet(object.description) ? globalThis.String(object.description) : "",
+      defaultTimeWindow: isSet(object.defaultTimeWindow)
+        ? analyticsTimeWindowFromJSON(object.defaultTimeWindow)
+        : isSet(object.default_time_window)
+        ? analyticsTimeWindowFromJSON(object.default_time_window)
+        : 0,
+      widgets: globalThis.Array.isArray(object?.widgets) ? object.widgets.map((e: any) => Widget.fromJSON(e)) : [],
     };
   },
 
-  toJSON(message: StreamDashboardDataRequest): unknown {
+  toJSON(message: DashboardTemplate): unknown {
     const obj: any = {};
-    if (message.organizationId !== "") {
-      obj.organizationId = message.organizationId;
+    if (message.id !== "") {
+      obj.id = message.id;
     }
-    if (message.projectId !== "") {
-      obj.projectId = message.projectId;
+    if (message.name !== "") {
+      obj.name = message.name;
     }
-    if (message.dashboardId !== "") {
-      obj.dashboardId = message.dashboardId;
+    if (message.description !== "") {
+      obj.description = message.description;
     }
-    if (message.widgetIds?.length) {
-      obj.widgetIds = message.widgetIds;
+    if (message.defaultTimeWindow !== 0) {
+      obj.defaultTimeWindow = analyticsTimeWindowToJSON(message.defaultTimeWindow);
     }
-    if (message.timeRange !== undefined) {
-      obj.timeRange = TimeRange.toJSON(message.timeRange);
+    if (message.widgets?.length) {
+      obj.widgets = message.widgets.map((e) => Widget.toJSON(e));
     }
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<StreamDashboardDataRequest>, I>>(base?: I): StreamDashboardDataRequest {
-    return StreamDashboardDataRequest.fromPartial(base ?? ({} as any));
+  create<I extends Exact<DeepPartial<DashboardTemplate>, I>>(base?: I): DashboardTemplate {
+    return DashboardTemplate.fromPartial(base ?? ({} as any));
   },
-  fromPartial<I extends Exact<DeepPartial<StreamDashboardDataRequest>, I>>(object: I): StreamDashboardDataRequest {
-    const message = createBaseStreamDashboardDataRequest();
-    message.organizationId = object.organizationId ?? "";
-    message.projectId = object.projectId ?? "";
-    message.dashboardId = object.dashboardId ?? "";
-    message.widgetIds = object.widgetIds?.map((e) => e) || [];
-    message.timeRange = (object.timeRange !== undefined && object.timeRange !== null)
-      ? TimeRange.fromPartial(object.timeRange)
-      : undefined;
+  fromPartial<I extends Exact<DeepPartial<DashboardTemplate>, I>>(object: I): DashboardTemplate {
+    const message = createBaseDashboardTemplate();
+    message.id = object.id ?? "";
+    message.name = object.name ?? "";
+    message.description = object.description ?? "";
+    message.defaultTimeWindow = object.defaultTimeWindow ?? 0;
+    message.widgets = object.widgets?.map((e) => Widget.fromPartial(e)) || [];
     return message;
   },
 };
 
-function createBaseDashboardDataEnvelope(): DashboardDataEnvelope {
-  return { widgetId: "", queryIndex: 0, snapshot: undefined, update: undefined, error: undefined };
+function createBaseListDashboardTemplatesRequest(): ListDashboardTemplatesRequest {
+  return { organizationId: "" };
 }
 
-export const DashboardDataEnvelope: MessageFns<DashboardDataEnvelope> = {
-  encode(message: DashboardDataEnvelope, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
-    if (message.widgetId !== "") {
-      writer.uint32(10).string(message.widgetId);
-    }
-    if (message.queryIndex !== 0) {
-      writer.uint32(16).int32(message.queryIndex);
-    }
-    if (message.snapshot !== undefined) {
-      QuerySnapshot.encode(message.snapshot, writer.uint32(26).fork()).join();
-    }
-    if (message.update !== undefined) {
-      QuerySeriesUpdate.encode(message.update, writer.uint32(34).fork()).join();
-    }
-    if (message.error !== undefined) {
-      WidgetQueryError.encode(message.error, writer.uint32(42).fork()).join();
+export const ListDashboardTemplatesRequest: MessageFns<ListDashboardTemplatesRequest> = {
+  encode(message: ListDashboardTemplatesRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.organizationId !== "") {
+      writer.uint32(10).string(message.organizationId);
     }
     return writer;
   },
 
-  decode(input: BinaryReader | Uint8Array, length?: number): DashboardDataEnvelope {
+  decode(input: BinaryReader | Uint8Array, length?: number): ListDashboardTemplatesRequest {
     const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
     const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
     if (previousRecursionDepth >= 100) {
@@ -4846,7 +4922,7 @@ export const DashboardDataEnvelope: MessageFns<DashboardDataEnvelope> = {
     (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
     try {
       const end = length === undefined ? reader.len : reader.pos + length;
-      const message = createBaseDashboardDataEnvelope();
+      const message = createBaseListDashboardTemplatesRequest();
       while (reader.pos < end) {
         const tag = reader.uint32();
         switch (tag >>> 3) {
@@ -4855,39 +4931,7 @@ export const DashboardDataEnvelope: MessageFns<DashboardDataEnvelope> = {
               break;
             }
 
-            message.widgetId = reader.string();
-            continue;
-          }
-          case 2: {
-            if (tag !== 16) {
-              break;
-            }
-
-            message.queryIndex = reader.int32();
-            continue;
-          }
-          case 3: {
-            if (tag !== 26) {
-              break;
-            }
-
-            message.snapshot = QuerySnapshot.decode(reader, reader.uint32());
-            continue;
-          }
-          case 4: {
-            if (tag !== 34) {
-              break;
-            }
-
-            message.update = QuerySeriesUpdate.decode(reader, reader.uint32());
-            continue;
-          }
-          case 5: {
-            if (tag !== 42) {
-              break;
-            }
-
-            message.error = WidgetQueryError.decode(reader, reader.uint32());
+            message.organizationId = reader.string();
             continue;
           }
         }
@@ -4902,45 +4946,679 @@ export const DashboardDataEnvelope: MessageFns<DashboardDataEnvelope> = {
     }
   },
 
-  fromJSON(object: any): DashboardDataEnvelope {
+  fromJSON(object: any): ListDashboardTemplatesRequest {
     return {
-      widgetId: isSet(object.widgetId)
-        ? globalThis.String(object.widgetId)
-        : isSet(object.widget_id)
-        ? globalThis.String(object.widget_id)
+      organizationId: isSet(object.organizationId)
+        ? globalThis.String(object.organizationId)
+        : isSet(object.organization_id)
+        ? globalThis.String(object.organization_id)
         : "",
-      queryIndex: isSet(object.queryIndex)
-        ? globalThis.Number(object.queryIndex)
-        : isSet(object.query_index)
-        ? globalThis.Number(object.query_index)
-        : 0,
-      snapshot: isSet(object.snapshot) ? QuerySnapshot.fromJSON(object.snapshot) : undefined,
-      update: isSet(object.update) ? QuerySeriesUpdate.fromJSON(object.update) : undefined,
-      error: isSet(object.error) ? WidgetQueryError.fromJSON(object.error) : undefined,
     };
   },
 
-  toJSON(message: DashboardDataEnvelope): unknown {
+  toJSON(message: ListDashboardTemplatesRequest): unknown {
     const obj: any = {};
-    if (message.widgetId !== "") {
-      obj.widgetId = message.widgetId;
-    }
-    if (message.queryIndex !== 0) {
-      obj.queryIndex = Math.round(message.queryIndex);
-    }
-    if (message.snapshot !== undefined) {
-      obj.snapshot = QuerySnapshot.toJSON(message.snapshot);
-    }
-    if (message.update !== undefined) {
-      obj.update = QuerySeriesUpdate.toJSON(message.update);
-    }
-    if (message.error !== undefined) {
-      obj.error = WidgetQueryError.toJSON(message.error);
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
     }
     return obj;
   },
 
-  create<I extends Exact<DeepPartial<DashboardDataEnvelope>, I>>(base?: I): DashboardDataEnvelope {
+  create<I extends Exact<DeepPartial<ListDashboardTemplatesRequest>, I>>(base?: I): ListDashboardTemplatesRequest {
+    return ListDashboardTemplatesRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListDashboardTemplatesRequest>, I>>(
+    object: I,
+  ): ListDashboardTemplatesRequest {
+    const message = createBaseListDashboardTemplatesRequest();
+    message.organizationId = object.organizationId ?? "";
+    return message;
+  },
+};
+
+function createBaseListDashboardTemplatesResponse(): ListDashboardTemplatesResponse {
+  return { status: undefined, templates: [] };
+}
+
+export const ListDashboardTemplatesResponse: MessageFns<ListDashboardTemplatesResponse> = {
+  encode(message: ListDashboardTemplatesResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    for (const v of message.templates) {
+      DashboardTemplate.encode(v!, writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): ListDashboardTemplatesResponse {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseListDashboardTemplatesResponse();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.status = ResponseStatus.decode(reader, reader.uint32());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.templates.push(DashboardTemplate.decode(reader, reader.uint32()));
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): ListDashboardTemplatesResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      templates: globalThis.Array.isArray(object?.templates)
+        ? object.templates.map((e: any) => DashboardTemplate.fromJSON(e))
+        : [],
+    };
+  },
+
+  toJSON(message: ListDashboardTemplatesResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.templates?.length) {
+      obj.templates = message.templates.map((e) => DashboardTemplate.toJSON(e));
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<ListDashboardTemplatesResponse>, I>>(base?: I): ListDashboardTemplatesResponse {
+    return ListDashboardTemplatesResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<ListDashboardTemplatesResponse>, I>>(
+    object: I,
+  ): ListDashboardTemplatesResponse {
+    const message = createBaseListDashboardTemplatesResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.templates = object.templates?.map((e) => DashboardTemplate.fromPartial(e)) || [];
+    return message;
+  },
+};
+
+function createBaseCreateDashboardFromTemplateRequest(): CreateDashboardFromTemplateRequest {
+  return {
+    organizationId: "",
+    projectId: "",
+    templateId: "",
+    name: undefined,
+    description: undefined,
+    defaultTimeWindow: 0,
+  };
+}
+
+export const CreateDashboardFromTemplateRequest: MessageFns<CreateDashboardFromTemplateRequest> = {
+  encode(message: CreateDashboardFromTemplateRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.organizationId !== "") {
+      writer.uint32(10).string(message.organizationId);
+    }
+    if (message.projectId !== "") {
+      writer.uint32(18).string(message.projectId);
+    }
+    if (message.templateId !== "") {
+      writer.uint32(26).string(message.templateId);
+    }
+    if (message.name !== undefined) {
+      writer.uint32(34).string(message.name);
+    }
+    if (message.description !== undefined) {
+      writer.uint32(42).string(message.description);
+    }
+    if (message.defaultTimeWindow !== 0) {
+      writer.uint32(48).int32(message.defaultTimeWindow);
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): CreateDashboardFromTemplateRequest {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseCreateDashboardFromTemplateRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationId = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.projectId = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.templateId = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.name = reader.string();
+            continue;
+          }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.description = reader.string();
+            continue;
+          }
+          case 6: {
+            if (tag !== 48) {
+              break;
+            }
+
+            message.defaultTimeWindow = reader.int32() as any;
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): CreateDashboardFromTemplateRequest {
+    return {
+      organizationId: isSet(object.organizationId)
+        ? globalThis.String(object.organizationId)
+        : isSet(object.organization_id)
+        ? globalThis.String(object.organization_id)
+        : "",
+      projectId: isSet(object.projectId)
+        ? globalThis.String(object.projectId)
+        : isSet(object.project_id)
+        ? globalThis.String(object.project_id)
+        : "",
+      templateId: isSet(object.templateId)
+        ? globalThis.String(object.templateId)
+        : isSet(object.template_id)
+        ? globalThis.String(object.template_id)
+        : "",
+      name: isSet(object.name) ? globalThis.String(object.name) : undefined,
+      description: isSet(object.description) ? globalThis.String(object.description) : undefined,
+      defaultTimeWindow: isSet(object.defaultTimeWindow)
+        ? analyticsTimeWindowFromJSON(object.defaultTimeWindow)
+        : isSet(object.default_time_window)
+        ? analyticsTimeWindowFromJSON(object.default_time_window)
+        : 0,
+    };
+  },
+
+  toJSON(message: CreateDashboardFromTemplateRequest): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    if (message.templateId !== "") {
+      obj.templateId = message.templateId;
+    }
+    if (message.name !== undefined) {
+      obj.name = message.name;
+    }
+    if (message.description !== undefined) {
+      obj.description = message.description;
+    }
+    if (message.defaultTimeWindow !== 0) {
+      obj.defaultTimeWindow = analyticsTimeWindowToJSON(message.defaultTimeWindow);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<CreateDashboardFromTemplateRequest>, I>>(
+    base?: I,
+  ): CreateDashboardFromTemplateRequest {
+    return CreateDashboardFromTemplateRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<CreateDashboardFromTemplateRequest>, I>>(
+    object: I,
+  ): CreateDashboardFromTemplateRequest {
+    const message = createBaseCreateDashboardFromTemplateRequest();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    message.templateId = object.templateId ?? "";
+    message.name = object.name ?? undefined;
+    message.description = object.description ?? undefined;
+    message.defaultTimeWindow = object.defaultTimeWindow ?? 0;
+    return message;
+  },
+};
+
+function createBaseCreateDashboardFromTemplateResponse(): CreateDashboardFromTemplateResponse {
+  return { status: undefined, dashboard: undefined };
+}
+
+export const CreateDashboardFromTemplateResponse: MessageFns<CreateDashboardFromTemplateResponse> = {
+  encode(message: CreateDashboardFromTemplateResponse, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.status !== undefined) {
+      ResponseStatus.encode(message.status, writer.uint32(10).fork()).join();
+    }
+    if (message.dashboard !== undefined) {
+      Dashboard.encode(message.dashboard, writer.uint32(18).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): CreateDashboardFromTemplateResponse {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseCreateDashboardFromTemplateResponse();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.status = ResponseStatus.decode(reader, reader.uint32());
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.dashboard = Dashboard.decode(reader, reader.uint32());
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): CreateDashboardFromTemplateResponse {
+    return {
+      status: isSet(object.status) ? ResponseStatus.fromJSON(object.status) : undefined,
+      dashboard: isSet(object.dashboard) ? Dashboard.fromJSON(object.dashboard) : undefined,
+    };
+  },
+
+  toJSON(message: CreateDashboardFromTemplateResponse): unknown {
+    const obj: any = {};
+    if (message.status !== undefined) {
+      obj.status = ResponseStatus.toJSON(message.status);
+    }
+    if (message.dashboard !== undefined) {
+      obj.dashboard = Dashboard.toJSON(message.dashboard);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<CreateDashboardFromTemplateResponse>, I>>(
+    base?: I,
+  ): CreateDashboardFromTemplateResponse {
+    return CreateDashboardFromTemplateResponse.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<CreateDashboardFromTemplateResponse>, I>>(
+    object: I,
+  ): CreateDashboardFromTemplateResponse {
+    const message = createBaseCreateDashboardFromTemplateResponse();
+    message.status = (object.status !== undefined && object.status !== null)
+      ? ResponseStatus.fromPartial(object.status)
+      : undefined;
+    message.dashboard = (object.dashboard !== undefined && object.dashboard !== null)
+      ? Dashboard.fromPartial(object.dashboard)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseStreamDashboardDataRequest(): StreamDashboardDataRequest {
+  return { organizationId: "", projectId: "", dashboardId: "", widgetIds: [], timeRange: undefined };
+}
+
+export const StreamDashboardDataRequest: MessageFns<StreamDashboardDataRequest> = {
+  encode(message: StreamDashboardDataRequest, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.organizationId !== "") {
+      writer.uint32(10).string(message.organizationId);
+    }
+    if (message.projectId !== "") {
+      writer.uint32(18).string(message.projectId);
+    }
+    if (message.dashboardId !== "") {
+      writer.uint32(26).string(message.dashboardId);
+    }
+    for (const v of message.widgetIds) {
+      writer.uint32(34).string(v!);
+    }
+    if (message.timeRange !== undefined) {
+      TimeRange.encode(message.timeRange, writer.uint32(42).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): StreamDashboardDataRequest {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseStreamDashboardDataRequest();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.organizationId = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 18) {
+              break;
+            }
+
+            message.projectId = reader.string();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.dashboardId = reader.string();
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.widgetIds.push(reader.string());
+            continue;
+          }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.timeRange = TimeRange.decode(reader, reader.uint32());
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): StreamDashboardDataRequest {
+    return {
+      organizationId: isSet(object.organizationId)
+        ? globalThis.String(object.organizationId)
+        : isSet(object.organization_id)
+        ? globalThis.String(object.organization_id)
+        : "",
+      projectId: isSet(object.projectId)
+        ? globalThis.String(object.projectId)
+        : isSet(object.project_id)
+        ? globalThis.String(object.project_id)
+        : "",
+      dashboardId: isSet(object.dashboardId)
+        ? globalThis.String(object.dashboardId)
+        : isSet(object.dashboard_id)
+        ? globalThis.String(object.dashboard_id)
+        : "",
+      widgetIds: globalThis.Array.isArray(object?.widgetIds)
+        ? object.widgetIds.map((e: any) => globalThis.String(e))
+        : globalThis.Array.isArray(object?.widget_ids)
+        ? object.widget_ids.map((e: any) => globalThis.String(e))
+        : [],
+      timeRange: isSet(object.timeRange)
+        ? TimeRange.fromJSON(object.timeRange)
+        : isSet(object.time_range)
+        ? TimeRange.fromJSON(object.time_range)
+        : undefined,
+    };
+  },
+
+  toJSON(message: StreamDashboardDataRequest): unknown {
+    const obj: any = {};
+    if (message.organizationId !== "") {
+      obj.organizationId = message.organizationId;
+    }
+    if (message.projectId !== "") {
+      obj.projectId = message.projectId;
+    }
+    if (message.dashboardId !== "") {
+      obj.dashboardId = message.dashboardId;
+    }
+    if (message.widgetIds?.length) {
+      obj.widgetIds = message.widgetIds;
+    }
+    if (message.timeRange !== undefined) {
+      obj.timeRange = TimeRange.toJSON(message.timeRange);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<StreamDashboardDataRequest>, I>>(base?: I): StreamDashboardDataRequest {
+    return StreamDashboardDataRequest.fromPartial(base ?? ({} as any));
+  },
+  fromPartial<I extends Exact<DeepPartial<StreamDashboardDataRequest>, I>>(object: I): StreamDashboardDataRequest {
+    const message = createBaseStreamDashboardDataRequest();
+    message.organizationId = object.organizationId ?? "";
+    message.projectId = object.projectId ?? "";
+    message.dashboardId = object.dashboardId ?? "";
+    message.widgetIds = object.widgetIds?.map((e) => e) || [];
+    message.timeRange = (object.timeRange !== undefined && object.timeRange !== null)
+      ? TimeRange.fromPartial(object.timeRange)
+      : undefined;
+    return message;
+  },
+};
+
+function createBaseDashboardDataEnvelope(): DashboardDataEnvelope {
+  return { widgetId: "", queryIndex: 0, snapshot: undefined, update: undefined, error: undefined };
+}
+
+export const DashboardDataEnvelope: MessageFns<DashboardDataEnvelope> = {
+  encode(message: DashboardDataEnvelope, writer: BinaryWriter = new BinaryWriter()): BinaryWriter {
+    if (message.widgetId !== "") {
+      writer.uint32(10).string(message.widgetId);
+    }
+    if (message.queryIndex !== 0) {
+      writer.uint32(16).int32(message.queryIndex);
+    }
+    if (message.snapshot !== undefined) {
+      QuerySnapshot.encode(message.snapshot, writer.uint32(26).fork()).join();
+    }
+    if (message.update !== undefined) {
+      QuerySeriesUpdate.encode(message.update, writer.uint32(34).fork()).join();
+    }
+    if (message.error !== undefined) {
+      WidgetQueryError.encode(message.error, writer.uint32(42).fork()).join();
+    }
+    return writer;
+  },
+
+  decode(input: BinaryReader | Uint8Array, length?: number): DashboardDataEnvelope {
+    const reader = input instanceof BinaryReader ? input : new BinaryReader(input);
+    const previousRecursionDepth = (reader as any).__tsProtoDecodeDepth ?? 0;
+    if (previousRecursionDepth >= 100) {
+      throw new globalThis.Error("protobuf decode recursion limit exceeded");
+    }
+    (reader as any).__tsProtoDecodeDepth = previousRecursionDepth + 1;
+    try {
+      const end = length === undefined ? reader.len : reader.pos + length;
+      const message = createBaseDashboardDataEnvelope();
+      while (reader.pos < end) {
+        const tag = reader.uint32();
+        switch (tag >>> 3) {
+          case 1: {
+            if (tag !== 10) {
+              break;
+            }
+
+            message.widgetId = reader.string();
+            continue;
+          }
+          case 2: {
+            if (tag !== 16) {
+              break;
+            }
+
+            message.queryIndex = reader.int32();
+            continue;
+          }
+          case 3: {
+            if (tag !== 26) {
+              break;
+            }
+
+            message.snapshot = QuerySnapshot.decode(reader, reader.uint32());
+            continue;
+          }
+          case 4: {
+            if (tag !== 34) {
+              break;
+            }
+
+            message.update = QuerySeriesUpdate.decode(reader, reader.uint32());
+            continue;
+          }
+          case 5: {
+            if (tag !== 42) {
+              break;
+            }
+
+            message.error = WidgetQueryError.decode(reader, reader.uint32());
+            continue;
+          }
+        }
+        if ((tag & 7) === 4 || tag === 0) {
+          break;
+        }
+        reader.skip(tag & 7);
+      }
+      return message;
+    } finally {
+      (reader as any).__tsProtoDecodeDepth = previousRecursionDepth;
+    }
+  },
+
+  fromJSON(object: any): DashboardDataEnvelope {
+    return {
+      widgetId: isSet(object.widgetId)
+        ? globalThis.String(object.widgetId)
+        : isSet(object.widget_id)
+        ? globalThis.String(object.widget_id)
+        : "",
+      queryIndex: isSet(object.queryIndex)
+        ? globalThis.Number(object.queryIndex)
+        : isSet(object.query_index)
+        ? globalThis.Number(object.query_index)
+        : 0,
+      snapshot: isSet(object.snapshot) ? QuerySnapshot.fromJSON(object.snapshot) : undefined,
+      update: isSet(object.update) ? QuerySeriesUpdate.fromJSON(object.update) : undefined,
+      error: isSet(object.error) ? WidgetQueryError.fromJSON(object.error) : undefined,
+    };
+  },
+
+  toJSON(message: DashboardDataEnvelope): unknown {
+    const obj: any = {};
+    if (message.widgetId !== "") {
+      obj.widgetId = message.widgetId;
+    }
+    if (message.queryIndex !== 0) {
+      obj.queryIndex = Math.round(message.queryIndex);
+    }
+    if (message.snapshot !== undefined) {
+      obj.snapshot = QuerySnapshot.toJSON(message.snapshot);
+    }
+    if (message.update !== undefined) {
+      obj.update = QuerySeriesUpdate.toJSON(message.update);
+    }
+    if (message.error !== undefined) {
+      obj.error = WidgetQueryError.toJSON(message.error);
+    }
+    return obj;
+  },
+
+  create<I extends Exact<DeepPartial<DashboardDataEnvelope>, I>>(base?: I): DashboardDataEnvelope {
     return DashboardDataEnvelope.fromPartial(base ?? ({} as any));
   },
   fromPartial<I extends Exact<DeepPartial<DashboardDataEnvelope>, I>>(object: I): DashboardDataEnvelope {
@@ -5594,6 +6272,22 @@ export interface MetricGatewayService {
   ListDashboards(request: ListDashboardsRequest, metadata?: Metadata): Promise<ListDashboardsResponse>;
   UpdateDashboard(request: UpdateDashboardRequest, metadata?: Metadata): Promise<UpdateDashboardResponse>;
   DeleteDashboard(request: DeleteDashboardRequest, metadata?: Metadata): Promise<DeleteDashboardResponse>;
+  /**
+   * Starter dashboards for this gateway's product, with full widgets for
+   * previews. A product with none lists empty.
+   */
+  ListDashboardTemplates(
+    request: ListDashboardTemplatesRequest,
+    metadata?: Metadata,
+  ): Promise<ListDashboardTemplatesResponse>;
+  /**
+   * Creates a plain copy of a template in the project; an unknown id (or one
+   * of another product) reports STATUS_CODE_NOT_FOUND.
+   */
+  CreateDashboardFromTemplate(
+    request: CreateDashboardFromTemplateRequest,
+    metadata?: Metadata,
+  ): Promise<CreateDashboardFromTemplateResponse>;
   /**
    * One stream per dashboard view: every widget query runs server-side and
    * all results multiplex onto this stream tagged with widget_id. Per-widget
@@ -5632,6 +6326,8 @@ export class MetricGatewayServiceClientImpl implements MetricGatewayService {
     this.ListDashboards = this.ListDashboards.bind(this);
     this.UpdateDashboard = this.UpdateDashboard.bind(this);
     this.DeleteDashboard = this.DeleteDashboard.bind(this);
+    this.ListDashboardTemplates = this.ListDashboardTemplates.bind(this);
+    this.CreateDashboardFromTemplate = this.CreateDashboardFromTemplate.bind(this);
     this.StreamDashboardData = this.StreamDashboardData.bind(this);
     this.StreamDashboardPreviews = this.StreamDashboardPreviews.bind(this);
   }
@@ -5692,6 +6388,24 @@ export class MetricGatewayServiceClientImpl implements MetricGatewayService {
     return promise.then((data) => DeleteDashboardResponse.decode(new BinaryReader(data)));
   }
 
+  ListDashboardTemplates(
+    request: ListDashboardTemplatesRequest,
+    metadata?: Metadata,
+  ): Promise<ListDashboardTemplatesResponse> {
+    const data = ListDashboardTemplatesRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "ListDashboardTemplates", data, metadata);
+    return promise.then((data) => ListDashboardTemplatesResponse.decode(new BinaryReader(data)));
+  }
+
+  CreateDashboardFromTemplate(
+    request: CreateDashboardFromTemplateRequest,
+    metadata?: Metadata,
+  ): Promise<CreateDashboardFromTemplateResponse> {
+    const data = CreateDashboardFromTemplateRequest.encode(request).finish();
+    const promise = this.rpc.request(this.service, "CreateDashboardFromTemplate", data, metadata);
+    return promise.then((data) => CreateDashboardFromTemplateResponse.decode(new BinaryReader(data)));
+  }
+
   StreamDashboardData(request: StreamDashboardDataRequest, metadata?: Metadata): Observable<DashboardDataEnvelope> {
     const data = StreamDashboardDataRequest.encode(request).finish();
     const result = this.rpc.serverStreamingRequest(this.service, "StreamDashboardData", data, metadata);