@carthooks/arcubase-cli 0.1.22 → 0.1.24

package/bundle/arcubase-admin.mjs

@@ -1082,6 +1082,27 @@ var userCommands = [
     ],
     "responseType": "GlobalActionEntryRespVO"
   },
+  {
+    "scope": "user",
+    "module": "app",
+    "functionName": "getAppDetail",
+    "commandPath": [
+      "app",
+      "get"
+    ],
+    "method": "GET",
+    "endpoint": "/api/apps/:id",
+    "pathParams": [
+      {
+        "param": "id",
+        "flag": "app-id"
+      }
+    ],
+    "controller": "UserAction.AppDetail",
+    "requestType": null,
+    "queryParams": [],
+    "responseType": "AppDetailRespVO"
+  },
   {
     "scope": "user",
     "module": "dashboard",
@@ -18339,6 +18360,33 @@ var helpExamplesIndex = {
       }
     ]
   },
+  "admin.dashboard.update-options": {
+    "command": [
+      "dashboard",
+      "update-options"
+    ],
+    "examples": [
+      {
+        "title": "make a dashboard visible to one Arcubase user",
+        "body": {
+          "changed": [
+            "users"
+          ],
+          "users": [
+            {
+              "type": "user",
+              "id": 2188889901
+            }
+          ]
+        },
+        "notes": [
+          "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+          "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+          "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+        ]
+      }
+    ]
+  },
   "admin.widget.create": {
     "command": [
       "widget",
@@ -18434,6 +18482,68 @@ var helpExamplesIndex = {
           "supported Aggregate values are sum, avg, max, min, count, and distinct_count",
           "unsupported aggregate names fail local body validation before the request is sent"
         ]
+      },
+      {
+        "title": "preview filtered distinct_count grouped by source",
+        "body": {
+          "dataSource": 2188891001,
+          "dataSourceType": "entity",
+          "dimensions": [
+            {
+              "IsField": true,
+              "FieldID": 1004,
+              "Name": "Source"
+            }
+          ],
+          "conditions": {
+            "mode": "and",
+            "conditions": [
+              {
+                "column": ":1006",
+                "operator": "$eq",
+                "value": "yes"
+              }
+            ]
+          },
+          "measures": [
+            {
+              "FieldID": 1002,
+              "Aggregate": "distinct_count",
+              "Name": "Distinct Customers"
+            }
+          ]
+        },
+        "notes": [
+          "use conditions, not filters, for chart data filtering",
+          "for saved charts put the same condition set under options.charts.conditions",
+          "do not remove the condition and hand-calculate filtered statistics from row query results"
+        ]
+      }
+    ]
+  },
+  "admin.widget.update-ingress-options": {
+    "command": [
+      "widget",
+      "update-ingress-options"
+    ],
+    "examples": [
+      {
+        "title": "adjust an ingress list widget display configuration",
+        "body": {
+          "options": {
+            "cond_follow": true,
+            "cond_follow_tab": true,
+            "cond_follow_cols": [
+              ":1001",
+              ":1002"
+            ]
+          }
+        },
+        "notes": [
+          "use this only for widgets created with options.ingress_id",
+          "do not use dashboard update-layout for ingress widgets",
+          "verify with widget get after updating ingress options"
+        ]
       }
     ]
   },
@@ -19775,16 +19885,38 @@ function buildBodyGuidance(requestType) {
         dataSource: 2188891001,
         dataSourceType: "entity",
         dimensions: [{ IsField: true, FieldID: 1004, Name: "Source" }],
-        measures: [{ FieldID: 1005, Aggregate: "sum", Name: "Total Amount" }]
+        measures: [{ FieldID: 1005, Aggregate: "sum", Name: "Total Amount" }],
+        conditions: { mode: "and", conditions: [{ column: ":1006", operator: "$eq", value: "yes" }] }
       },
       commonMistakes: [
         "widget preview-data body is the chart query itself",
         "do not send a saved widget object with id, entity_id, or options",
         "field dimensions with FieldID must set IsField:true",
+        "use conditions, not filters, for chart data filtering",
+        "do not retry without conditions and then hand-calculate filtered statistics",
         "unsupported aggregates are invalid; use sum, avg, max, min, count, or distinct_count"
       ],
       suggestions: [
-        `retry with: arcubase-admin widget preview-data --app-id <app_id> --body-json '{"dataSource":<table_id>,"dataSourceType":"entity","dimensions":[{"IsField":true,"FieldID":<field_id>,"Name":"Source"}],"measures":[{"FieldID":<number_field_id>,"Aggregate":"sum","Name":"Total Amount"}]}'`
+        `retry with: arcubase-admin widget preview-data --app-id <app_id> --body-json '{"dataSource":<table_id>,"dataSourceType":"entity","dimensions":[{"IsField":true,"FieldID":<field_id>,"Name":"Source"}],"measures":[{"FieldID":<number_field_id>,"Aggregate":"sum","Name":"Total Amount"}]}'`,
+        `conditional stats: arcubase-admin widget preview-data --app-id <app_id> --body-json '{"dataSource":<table_id>,"dataSourceType":"entity","dimensions":[{"IsField":true,"FieldID":<source_field_id>,"Name":"Source"}],"conditions":{"mode":"and","conditions":[{"column":":1006","operator":"$eq","value":"yes"}]},"measures":[{"FieldID":<customer_field_id>,"Aggregate":"distinct_count","Name":"Distinct Customers"}]}'`
+      ]
+    };
+  }
+  if (requestType === "AppNewWidgetsReqVO") {
+    return {
+      shapeHint: {
+        type: "list",
+        options: { ingress_id: 2188893001 }
+      },
+      commonMistakes: [
+        "dashboard widgets use options.dashboard_id",
+        "ingress widgets use options.ingress_id",
+        "do not put entity_id at body top level or under options when creating a widget",
+        "after creating an ingress widget, use widget update-ingress-options to adjust display configuration"
+      ],
+      suggestions: [
+        `dashboard chart: arcubase-admin widget create --app-id <app_id> --body-json '{"type":"chart","options":{"dashboard_id":<dashboard_id>}}'`,
+        `ingress list: arcubase-admin widget create --app-id <app_id> --body-json '{"type":"list","options":{"ingress_id":<ingress_id>}}'`
       ]
     };
   }
@@ -19797,14 +19929,38 @@ function buildBodyGuidance(requestType) {
             entity_id: 2188891001,
             dimensions: [{ IsField: true, FieldID: 1004, Name: "Source" }],
             measures: [{ FieldID: 1005, Aggregate: "sum", Name: "Total Amount" }],
+            conditions: { mode: "and", conditions: [{ column: ":1006", operator: "$eq", value: "yes" }] },
             type: "bar"
           }
         }
       },
       commonMistakes: [
         "dashboard chart config belongs in body.options.charts",
+        "ingress/list display settings use widget update-ingress-options, not widget update",
+        "do not put ingress_id, list, default_cols, page_size, or entry display settings in widget update",
         "field dimensions with FieldID must set IsField:true",
+        "use options.charts.conditions, not filters, for chart data filtering",
+        "do not retry without conditions and then hand-calculate filtered statistics",
         "verify persistence with widget get or widget list after update"
+      ],
+      suggestions: [
+        `dashboard chart: arcubase-admin widget update --app-id <app_id> --widget-id <widget_id> --body-json '{"entity_id":<table_id>,"options":{"charts":{"entity_id":<table_id>,"dimensions":[{"IsField":true,"FieldID":<field_id>,"Name":"Source"}],"measures":[{"FieldID":<number_field_id>,"Aggregate":"sum","Name":"Total Amount"}],"type":"bar"}}}'`,
+        `ingress list display: arcubase-admin widget update-ingress-options --app-id <app_id> --widget-id <widget_id> --body-json '{"options":{"cond_follow":true,"cond_follow_tab":true,"cond_follow_cols":[":1001",":1002"]}}'`
+      ]
+    };
+  }
+  if (requestType === "AppUpdateWidgetsIngressOptionsReqVO") {
+    return {
+      shapeHint: {
+        options: { cond_follow: true, cond_follow_tab: true, cond_follow_cols: [":1001", ":1002"] }
+      },
+      commonMistakes: [
+        "widget update-ingress-options is for ingress widgets, not dashboard chart widgets",
+        "put display settings under body.options",
+        "verify the ingress widget with widget get after update"
+      ],
+      suggestions: [
+        `retry with: arcubase-admin widget update-ingress-options --app-id <app_id> --widget-id <widget_id> --body-json '{"options":{"cond_follow":true,"cond_follow_tab":true,"cond_follow_cols":[":1001",":1002"]}}'`
       ]
     };
   }

package/bundle/arcubase.mjs

@@ -1082,6 +1082,27 @@ var userCommands = [
     ],
     "responseType": "GlobalActionEntryRespVO"
   },
+  {
+    "scope": "user",
+    "module": "app",
+    "functionName": "getAppDetail",
+    "commandPath": [
+      "app",
+      "get"
+    ],
+    "method": "GET",
+    "endpoint": "/api/apps/:id",
+    "pathParams": [
+      {
+        "param": "id",
+        "flag": "app-id"
+      }
+    ],
+    "controller": "UserAction.AppDetail",
+    "requestType": null,
+    "queryParams": [],
+    "responseType": "AppDetailRespVO"
+  },
   {
     "scope": "user",
     "module": "dashboard",
@@ -18339,6 +18360,33 @@ var helpExamplesIndex = {
       }
     ]
   },
+  "admin.dashboard.update-options": {
+    "command": [
+      "dashboard",
+      "update-options"
+    ],
+    "examples": [
+      {
+        "title": "make a dashboard visible to one Arcubase user",
+        "body": {
+          "changed": [
+            "users"
+          ],
+          "users": [
+            {
+              "type": "user",
+              "id": 2188889901
+            }
+          ]
+        },
+        "notes": [
+          "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+          "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+          "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+        ]
+      }
+    ]
+  },
   "admin.widget.create": {
     "command": [
       "widget",
@@ -18434,6 +18482,68 @@ var helpExamplesIndex = {
           "supported Aggregate values are sum, avg, max, min, count, and distinct_count",
           "unsupported aggregate names fail local body validation before the request is sent"
         ]
+      },
+      {
+        "title": "preview filtered distinct_count grouped by source",
+        "body": {
+          "dataSource": 2188891001,
+          "dataSourceType": "entity",
+          "dimensions": [
+            {
+              "IsField": true,
+              "FieldID": 1004,
+              "Name": "Source"
+            }
+          ],
+          "conditions": {
+            "mode": "and",
+            "conditions": [
+              {
+                "column": ":1006",
+                "operator": "$eq",
+                "value": "yes"
+              }
+            ]
+          },
+          "measures": [
+            {
+              "FieldID": 1002,
+              "Aggregate": "distinct_count",
+              "Name": "Distinct Customers"
+            }
+          ]
+        },
+        "notes": [
+          "use conditions, not filters, for chart data filtering",
+          "for saved charts put the same condition set under options.charts.conditions",
+          "do not remove the condition and hand-calculate filtered statistics from row query results"
+        ]
+      }
+    ]
+  },
+  "admin.widget.update-ingress-options": {
+    "command": [
+      "widget",
+      "update-ingress-options"
+    ],
+    "examples": [
+      {
+        "title": "adjust an ingress list widget display configuration",
+        "body": {
+          "options": {
+            "cond_follow": true,
+            "cond_follow_tab": true,
+            "cond_follow_cols": [
+              ":1001",
+              ":1002"
+            ]
+          }
+        },
+        "notes": [
+          "use this only for widgets created with options.ingress_id",
+          "do not use dashboard update-layout for ingress widgets",
+          "verify with widget get after updating ingress options"
+        ]
       }
     ]
   },
@@ -19775,16 +19885,38 @@ function buildBodyGuidance(requestType) {
         dataSource: 2188891001,
         dataSourceType: "entity",
         dimensions: [{ IsField: true, FieldID: 1004, Name: "Source" }],
-        measures: [{ FieldID: 1005, Aggregate: "sum", Name: "Total Amount" }]
+        measures: [{ FieldID: 1005, Aggregate: "sum", Name: "Total Amount" }],
+        conditions: { mode: "and", conditions: [{ column: ":1006", operator: "$eq", value: "yes" }] }
       },
       commonMistakes: [
         "widget preview-data body is the chart query itself",
         "do not send a saved widget object with id, entity_id, or options",
         "field dimensions with FieldID must set IsField:true",
+        "use conditions, not filters, for chart data filtering",
+        "do not retry without conditions and then hand-calculate filtered statistics",
         "unsupported aggregates are invalid; use sum, avg, max, min, count, or distinct_count"
       ],
       suggestions: [
-        `retry with: arcubase-admin widget preview-data --app-id <app_id> --body-json '{"dataSource":<table_id>,"dataSourceType":"entity","dimensions":[{"IsField":true,"FieldID":<field_id>,"Name":"Source"}],"measures":[{"FieldID":<number_field_id>,"Aggregate":"sum","Name":"Total Amount"}]}'`
+        `retry with: arcubase-admin widget preview-data --app-id <app_id> --body-json '{"dataSource":<table_id>,"dataSourceType":"entity","dimensions":[{"IsField":true,"FieldID":<field_id>,"Name":"Source"}],"measures":[{"FieldID":<number_field_id>,"Aggregate":"sum","Name":"Total Amount"}]}'`,
+        `conditional stats: arcubase-admin widget preview-data --app-id <app_id> --body-json '{"dataSource":<table_id>,"dataSourceType":"entity","dimensions":[{"IsField":true,"FieldID":<source_field_id>,"Name":"Source"}],"conditions":{"mode":"and","conditions":[{"column":":1006","operator":"$eq","value":"yes"}]},"measures":[{"FieldID":<customer_field_id>,"Aggregate":"distinct_count","Name":"Distinct Customers"}]}'`
+      ]
+    };
+  }
+  if (requestType === "AppNewWidgetsReqVO") {
+    return {
+      shapeHint: {
+        type: "list",
+        options: { ingress_id: 2188893001 }
+      },
+      commonMistakes: [
+        "dashboard widgets use options.dashboard_id",
+        "ingress widgets use options.ingress_id",
+        "do not put entity_id at body top level or under options when creating a widget",
+        "after creating an ingress widget, use widget update-ingress-options to adjust display configuration"
+      ],
+      suggestions: [
+        `dashboard chart: arcubase-admin widget create --app-id <app_id> --body-json '{"type":"chart","options":{"dashboard_id":<dashboard_id>}}'`,
+        `ingress list: arcubase-admin widget create --app-id <app_id> --body-json '{"type":"list","options":{"ingress_id":<ingress_id>}}'`
       ]
     };
   }
@@ -19797,14 +19929,38 @@ function buildBodyGuidance(requestType) {
             entity_id: 2188891001,
             dimensions: [{ IsField: true, FieldID: 1004, Name: "Source" }],
             measures: [{ FieldID: 1005, Aggregate: "sum", Name: "Total Amount" }],
+            conditions: { mode: "and", conditions: [{ column: ":1006", operator: "$eq", value: "yes" }] },
             type: "bar"
           }
         }
       },
       commonMistakes: [
         "dashboard chart config belongs in body.options.charts",
+        "ingress/list display settings use widget update-ingress-options, not widget update",
+        "do not put ingress_id, list, default_cols, page_size, or entry display settings in widget update",
         "field dimensions with FieldID must set IsField:true",
+        "use options.charts.conditions, not filters, for chart data filtering",
+        "do not retry without conditions and then hand-calculate filtered statistics",
         "verify persistence with widget get or widget list after update"
+      ],
+      suggestions: [
+        `dashboard chart: arcubase-admin widget update --app-id <app_id> --widget-id <widget_id> --body-json '{"entity_id":<table_id>,"options":{"charts":{"entity_id":<table_id>,"dimensions":[{"IsField":true,"FieldID":<field_id>,"Name":"Source"}],"measures":[{"FieldID":<number_field_id>,"Aggregate":"sum","Name":"Total Amount"}],"type":"bar"}}}'`,
+        `ingress list display: arcubase-admin widget update-ingress-options --app-id <app_id> --widget-id <widget_id> --body-json '{"options":{"cond_follow":true,"cond_follow_tab":true,"cond_follow_cols":[":1001",":1002"]}}'`
+      ]
+    };
+  }
+  if (requestType === "AppUpdateWidgetsIngressOptionsReqVO") {
+    return {
+      shapeHint: {
+        options: { cond_follow: true, cond_follow_tab: true, cond_follow_cols: [":1001", ":1002"] }
+      },
+      commonMistakes: [
+        "widget update-ingress-options is for ingress widgets, not dashboard chart widgets",
+        "put display settings under body.options",
+        "verify the ingress widget with widget get after update"
+      ],
+      suggestions: [
+        `retry with: arcubase-admin widget update-ingress-options --app-id <app_id> --widget-id <widget_id> --body-json '{"options":{"cond_follow":true,"cond_follow_tab":true,"cond_follow_cols":[":1001",":1002"]}}'`
       ]
     };
   }

package/dist/generated/command_registry.generated.d.ts

@@ -699,6 +699,21 @@ export declare const userCommands: readonly [{
         readonly fixedValue: "true";
     }];
     readonly responseType: "GlobalActionEntryRespVO";
+}, {
+    readonly scope: "user";
+    readonly module: "app";
+    readonly functionName: "getAppDetail";
+    readonly commandPath: readonly ["app", "get"];
+    readonly method: "GET";
+    readonly endpoint: "/api/apps/:id";
+    readonly pathParams: readonly [{
+        readonly param: "id";
+        readonly flag: "app-id";
+    }];
+    readonly controller: "UserAction.AppDetail";
+    readonly requestType: null;
+    readonly queryParams: readonly [];
+    readonly responseType: "AppDetailRespVO";
 }, {
     readonly scope: "user";
     readonly module: "dashboard";

package/dist/generated/command_registry.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command_registry.generated.d.ts","sourceRoot":"","sources":["../../src/generated/command_registry.generated.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7G,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAi5BhB,CAAA;AAEV,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAszBf,CAAA"}
+{"version":3,"file":"command_registry.generated.d.ts","sourceRoot":"","sources":["../../src/generated/command_registry.generated.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,SAAS;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,WAAW,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7G,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAi5BhB,CAAA;AAEV,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA20Bf,CAAA"}

package/dist/generated/command_registry.generated.js

@@ -937,6 +937,27 @@ export const userCommands = [
         ],
         "responseType": "GlobalActionEntryRespVO"
     },
+    {
+        "scope": "user",
+        "module": "app",
+        "functionName": "getAppDetail",
+        "commandPath": [
+            "app",
+            "get"
+        ],
+        "method": "GET",
+        "endpoint": "/api/apps/:id",
+        "pathParams": [
+            {
+                "param": "id",
+                "flag": "app-id"
+            }
+        ],
+        "controller": "UserAction.AppDetail",
+        "requestType": null,
+        "queryParams": [],
+        "responseType": "AppDetailRespVO"
+    },
     {
         "scope": "user",
         "module": "dashboard",

package/dist/generated/help_examples.generated.d.ts

@@ -262,6 +262,20 @@ export declare const helpExamplesIndex: {
             readonly notes: readonly ["the request body is a top-level array", "do not wrap the array as {\"layout\":[...]}"];
         }];
     };
+    readonly "admin.dashboard.update-options": {
+        readonly command: readonly ["dashboard", "update-options"];
+        readonly examples: readonly [{
+            readonly title: "make a dashboard visible to one Arcubase user";
+            readonly body: {
+                readonly changed: readonly ["users"];
+                readonly users: readonly [{
+                    readonly type: "user";
+                    readonly id: 2188889901;
+                }];
+            };
+            readonly notes: readonly ["dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users", "use the currentSpeaker.arcubaseUserId value for the current human speaker", "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"];
+        }];
+    };
     readonly "admin.widget.create": {
         readonly command: readonly ["widget", "create"];
         readonly examples: readonly [{
@@ -323,6 +337,45 @@ export declare const helpExamplesIndex: {
                 }];
             };
             readonly notes: readonly ["supported Aggregate values are sum, avg, max, min, count, and distinct_count", "unsupported aggregate names fail local body validation before the request is sent"];
+        }, {
+            readonly title: "preview filtered distinct_count grouped by source";
+            readonly body: {
+                readonly dataSource: 2188891001;
+                readonly dataSourceType: "entity";
+                readonly dimensions: readonly [{
+                    readonly IsField: true;
+                    readonly FieldID: 1004;
+                    readonly Name: "Source";
+                }];
+                readonly conditions: {
+                    readonly mode: "and";
+                    readonly conditions: readonly [{
+                        readonly column: ":1006";
+                        readonly operator: "$eq";
+                        readonly value: "yes";
+                    }];
+                };
+                readonly measures: readonly [{
+                    readonly FieldID: 1002;
+                    readonly Aggregate: "distinct_count";
+                    readonly Name: "Distinct Customers";
+                }];
+            };
+            readonly notes: readonly ["use conditions, not filters, for chart data filtering", "for saved charts put the same condition set under options.charts.conditions", "do not remove the condition and hand-calculate filtered statistics from row query results"];
+        }];
+    };
+    readonly "admin.widget.update-ingress-options": {
+        readonly command: readonly ["widget", "update-ingress-options"];
+        readonly examples: readonly [{
+            readonly title: "adjust an ingress list widget display configuration";
+            readonly body: {
+                readonly options: {
+                    readonly cond_follow: true;
+                    readonly cond_follow_tab: true;
+                    readonly cond_follow_cols: readonly [":1001", ":1002"];
+                };
+            };
+            readonly notes: readonly ["use this only for widgets created with options.ingress_id", "do not use dashboard update-layout for ingress widgets", "verify with widget get after updating ingress options"];
         }];
     };
     readonly "user.row.bulk-update": {

package/dist/generated/help_examples.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help_examples.generated.d.ts","sourceRoot":"","sources":["../../src/generated/help_examples.generated.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6iBgF,CAAA"}
+{"version":3,"file":"help_examples.generated.d.ts","sourceRoot":"","sources":["../../src/generated/help_examples.generated.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsoBgF,CAAA"}

package/dist/generated/help_examples.generated.js

@@ -363,6 +363,33 @@ export const helpExamplesIndex = {
             }
         ]
     },
+    "admin.dashboard.update-options": {
+        "command": [
+            "dashboard",
+            "update-options"
+        ],
+        "examples": [
+            {
+                "title": "make a dashboard visible to one Arcubase user",
+                "body": {
+                    "changed": [
+                        "users"
+                    ],
+                    "users": [
+                        {
+                            "type": "user",
+                            "id": 2188889901
+                        }
+                    ]
+                },
+                "notes": [
+                    "dashboard visibility is controlled by DashboardUpdateOptionsReqVO.users",
+                    "use the currentSpeaker.arcubaseUserId value for the current human speaker",
+                    "after updating, verify from the user side with arcubase app get and require dashboards to include the dashboard"
+                ]
+            }
+        ]
+    },
     "admin.widget.create": {
         "command": [
             "widget",
@@ -458,6 +485,68 @@ export const helpExamplesIndex = {
                     "supported Aggregate values are sum, avg, max, min, count, and distinct_count",
                     "unsupported aggregate names fail local body validation before the request is sent"
                 ]
+            },
+            {
+                "title": "preview filtered distinct_count grouped by source",
+                "body": {
+                    "dataSource": 2188891001,
+                    "dataSourceType": "entity",
+                    "dimensions": [
+                        {
+                            "IsField": true,
+                            "FieldID": 1004,
+                            "Name": "Source"
+                        }
+                    ],
+                    "conditions": {
+                        "mode": "and",
+                        "conditions": [
+                            {
+                                "column": ":1006",
+                                "operator": "$eq",
+                                "value": "yes"
+                            }
+                        ]
+                    },
+                    "measures": [
+                        {
+                            "FieldID": 1002,
+                            "Aggregate": "distinct_count",
+                            "Name": "Distinct Customers"
+                        }
+                    ]
+                },
+                "notes": [
+                    "use conditions, not filters, for chart data filtering",
+                    "for saved charts put the same condition set under options.charts.conditions",
+                    "do not remove the condition and hand-calculate filtered statistics from row query results"
+                ]
+            }
+        ]
+    },
+    "admin.widget.update-ingress-options": {
+        "command": [
+            "widget",
+            "update-ingress-options"
+        ],
+        "examples": [
+            {
+                "title": "adjust an ingress list widget display configuration",
+                "body": {
+                    "options": {
+                        "cond_follow": true,
+                        "cond_follow_tab": true,
+                        "cond_follow_cols": [
+                            ":1001",
+                            ":1002"
+                        ]
+                    }
+                },
+                "notes": [
+                    "use this only for widgets created with options.ingress_id",
+                    "do not use dashboard update-layout for ingress widgets",
+                    "verify with widget get after updating ingress options"
+                ]
             }
         ]
     },