@epilot/sdk 2.19.4 → 2.19.5

package/dist/{customer-portal.d-DTnk0yQf.d.cts → customer-portal.d-DJHJY-vb.d.cts}

@@ -1460,6 +1460,10 @@ declare namespace Components {
              * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
              */
             notification_triggers?: NotificationTriggerConfig[];
+            /**
+             * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+             */
+            engagement_center_enabled?: boolean;
         }
         export interface CommonConfigAttributesV3 {
             /**
@@ -3290,7 +3294,27 @@ declare namespace Components {
             templates?: {
                 [name: string]: string;
             };
-            templates_ref?: /* Reference to admin-authored portal configuration (a page block or a global search configuration item) from which the API derives Handlebars templates server-side. This replaces client-supplied template strings so portal users can never submit arbitrary templates for resolution. When both a reference and raw `templates` are provided, the reference wins and the raw templates are ignored. */ TemplatesRef;
+            /**
+             * Reference to admin-authored portal configuration (a page block or a global search configuration item) from which the API derives Handlebars templates server-side. This replaces client-supplied template strings so portal users can never submit arbitrary templates for resolution. When both a reference and raw `templates` are provided, the reference wins and the raw templates are ignored.
+             */
+            templates_ref?: {
+                /**
+                 * ID of the portal page to derive templates from. When given without `block_id`, templates are derived from every block of the page and returned resolved as a nested map keyed by block id (the entity detail page contract).
+                 */
+                page_id?: string;
+                /**
+                 * ID of a block within the page. Templates are derived from the block's content according to its block type (e.g. meter_selector, meter_reading, entity_list).
+                 */
+                block_id?: string;
+                /**
+                 * For blocks carrying a per-schema configuration array (entity_list), the id of the configuration item to derive templates from. Requires `page_id` and `block_id`.
+                 */
+                config_id?: string;
+                /**
+                 * ID of the portal's `global_search` configuration item to derive search result templates and the group title template from. Mutually exclusive with `page_id`.
+                 */
+                global_search_config_id?: string;
+            };
         }
         export interface EntityTemplates {
             /**
@@ -6610,6 +6634,10 @@ declare namespace Components {
              * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
              */
             notification_triggers?: NotificationTriggerConfig[];
+            /**
+             * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+             */
+            engagement_center_enabled?: boolean;
             /**
              * ID of the organization
              * example:
@@ -8103,11 +8131,14 @@ declare namespace Components {
              */
             code: string;
             /**
-             * The redirect uri
+             * The redirect uri used in the authorization request. Optional: when omitted it is
+             * resolved server-side from the provider's configured `redirect_uri`, falling back to
+             * the portal's own callback route (`https://<domain>/sso`).
+             *
              * example:
-             * https://customer-portal.com/login
+             * https://customer-portal.com/sso
              */
-            redirect_uri: string;
+            redirect_uri?: string;
             /**
              * The client id
              * example:
@@ -9011,6 +9042,10 @@ declare namespace Components {
              * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
              */
             notification_triggers?: NotificationTriggerConfig[];
+            /**
+             * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+             */
+            engagement_center_enabled?: boolean;
         }
         export interface UpsertPortalConfigV3 {
             /**
@@ -9664,7 +9699,7 @@ declare namespace Components {
             /**
              * Intervals supported for the current context. If omitted, all intervals are assumed supported.
              */
-            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M")[];
+            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y")[];
             data_range?: /* Earliest / latest timestamps for which data is available in the current context. */ VisualizationDataRange;
         }
         export interface VisualizationTypeOption {
@@ -11355,7 +11390,7 @@ declare namespace Paths {
             export type ExtensionId = string;
             export type From = string; // date-time
             export type HookId = string;
-            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M";
+            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y";
             export type MeterId = string;
             export type To = string; // date-time
         }
@@ -11712,7 +11747,7 @@ declare namespace Paths {
             export type ExtensionId = string;
             export type From = string; // date-time
             export type HookId = string;
-            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M";
+            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y";
             export type MeterId = string;
             export type To = string; // date-time
         }
@@ -13558,6 +13593,10 @@ declare namespace Paths {
                  * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
                  */
                 notification_triggers?: Components.Schemas.NotificationTriggerConfig[];
+                /**
+                 * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+                 */
+                engagement_center_enabled?: boolean;
                 /**
                  * ID of the organization
                  * example:
@@ -14180,6 +14219,10 @@ declare namespace Paths {
                  * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
                  */
                 notification_triggers?: Components.Schemas.NotificationTriggerConfig[];
+                /**
+                 * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+                 */
+                engagement_center_enabled?: boolean;
                 /**
                  * ID of the organization
                  * example:
@@ -14580,7 +14623,7 @@ declare namespace Paths {
             export type ExtensionId = string;
             export type From = string; // date-time
             export type HookId = string;
-            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M";
+            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y";
             export type MeterId = string;
             export type To = string; // date-time
         }

package/dist/{customer-portal.d-DTnk0yQf.d.ts → customer-portal.d-DJHJY-vb.d.ts}

@@ -1460,6 +1460,10 @@ declare namespace Components {
              * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
              */
             notification_triggers?: NotificationTriggerConfig[];
+            /**
+             * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+             */
+            engagement_center_enabled?: boolean;
         }
         export interface CommonConfigAttributesV3 {
             /**
@@ -3290,7 +3294,27 @@ declare namespace Components {
             templates?: {
                 [name: string]: string;
             };
-            templates_ref?: /* Reference to admin-authored portal configuration (a page block or a global search configuration item) from which the API derives Handlebars templates server-side. This replaces client-supplied template strings so portal users can never submit arbitrary templates for resolution. When both a reference and raw `templates` are provided, the reference wins and the raw templates are ignored. */ TemplatesRef;
+            /**
+             * Reference to admin-authored portal configuration (a page block or a global search configuration item) from which the API derives Handlebars templates server-side. This replaces client-supplied template strings so portal users can never submit arbitrary templates for resolution. When both a reference and raw `templates` are provided, the reference wins and the raw templates are ignored.
+             */
+            templates_ref?: {
+                /**
+                 * ID of the portal page to derive templates from. When given without `block_id`, templates are derived from every block of the page and returned resolved as a nested map keyed by block id (the entity detail page contract).
+                 */
+                page_id?: string;
+                /**
+                 * ID of a block within the page. Templates are derived from the block's content according to its block type (e.g. meter_selector, meter_reading, entity_list).
+                 */
+                block_id?: string;
+                /**
+                 * For blocks carrying a per-schema configuration array (entity_list), the id of the configuration item to derive templates from. Requires `page_id` and `block_id`.
+                 */
+                config_id?: string;
+                /**
+                 * ID of the portal's `global_search` configuration item to derive search result templates and the group title template from. Mutually exclusive with `page_id`.
+                 */
+                global_search_config_id?: string;
+            };
         }
         export interface EntityTemplates {
             /**
@@ -6610,6 +6634,10 @@ declare namespace Components {
              * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
              */
             notification_triggers?: NotificationTriggerConfig[];
+            /**
+             * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+             */
+            engagement_center_enabled?: boolean;
             /**
              * ID of the organization
              * example:
@@ -8103,11 +8131,14 @@ declare namespace Components {
              */
             code: string;
             /**
-             * The redirect uri
+             * The redirect uri used in the authorization request. Optional: when omitted it is
+             * resolved server-side from the provider's configured `redirect_uri`, falling back to
+             * the portal's own callback route (`https://<domain>/sso`).
+             *
              * example:
-             * https://customer-portal.com/login
+             * https://customer-portal.com/sso
              */
-            redirect_uri: string;
+            redirect_uri?: string;
             /**
              * The client id
              * example:
@@ -9011,6 +9042,10 @@ declare namespace Components {
              * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
              */
             notification_triggers?: NotificationTriggerConfig[];
+            /**
+             * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+             */
+            engagement_center_enabled?: boolean;
         }
         export interface UpsertPortalConfigV3 {
             /**
@@ -9664,7 +9699,7 @@ declare namespace Components {
             /**
              * Intervals supported for the current context. If omitted, all intervals are assumed supported.
              */
-            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M")[];
+            intervals?: ("PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y")[];
             data_range?: /* Earliest / latest timestamps for which data is available in the current context. */ VisualizationDataRange;
         }
         export interface VisualizationTypeOption {
@@ -11355,7 +11390,7 @@ declare namespace Paths {
             export type ExtensionId = string;
             export type From = string; // date-time
             export type HookId = string;
-            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M";
+            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y";
             export type MeterId = string;
             export type To = string; // date-time
         }
@@ -11712,7 +11747,7 @@ declare namespace Paths {
             export type ExtensionId = string;
             export type From = string; // date-time
             export type HookId = string;
-            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M";
+            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y";
             export type MeterId = string;
             export type To = string; // date-time
         }
@@ -13558,6 +13593,10 @@ declare namespace Paths {
                  * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
                  */
                 notification_triggers?: Components.Schemas.NotificationTriggerConfig[];
+                /**
+                 * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+                 */
+                engagement_center_enabled?: boolean;
                 /**
                  * ID of the organization
                  * example:
@@ -14180,6 +14219,10 @@ declare namespace Paths {
                  * Configures which 360 events generate an in-app notification for the portal user. Each enabled trigger renders the referenced notification template and creates a notification addressed to the portal user. Admin/builder-only — never exposed via the public portal config.
                  */
                 notification_triggers?: Components.Schemas.NotificationTriggerConfig[];
+                /**
+                 * Master toggle for the portal's engagement center (in-app notifications including the notification triggers above). Off when absent — portal users only see the engagement center and receive trigger notifications after an admin enables it.
+                 */
+                engagement_center_enabled?: boolean;
                 /**
                  * ID of the organization
                  * example:
@@ -14580,7 +14623,7 @@ declare namespace Paths {
             export type ExtensionId = string;
             export type From = string; // date-time
             export type HookId = string;
-            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M";
+            export type Interval = "PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y";
             export type MeterId = string;
             export type To = string; // date-time
         }

package/dist/index.cjs

@@ -158,7 +158,7 @@ var _chunkADSWGLIVcjs = require('./chunk-ADSWGLIV.cjs');
 
 
 
-var _chunkAD5FK5LKcjs = require('./chunk-AD5FK5LK.cjs');
+var _chunkVB6VABGZcjs = require('./chunk-VB6VABGZ.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -225,7 +225,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunkAD5FK5LKcjs.createApiClient.call(void 0, {
+    entry.instance = _chunkVB6VABGZcjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -258,7 +258,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunkAD5FK5LKcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunkVB6VABGZcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -601,9 +601,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunkAD5FK5LKcjs.createApiHandle.call(void 0, {
+    return _chunkVB6VABGZcjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunkAD5FK5LKcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunkVB6VABGZcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -651,9 +651,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunkAD5FK5LKcjs.help.call(void 0, apiName);
+          return (apiName) => _chunkVB6VABGZcjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunkAD5FK5LKcjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunkVB6VABGZcjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -683,4 +683,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkAD5FK5LKcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkAD5FK5LKcjs.help; exports.openapi = _chunkAD5FK5LKcjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkVB6VABGZcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkVB6VABGZcjs.help; exports.openapi = _chunkVB6VABGZcjs.openapi;

package/dist/index.d.cts

@@ -15,7 +15,7 @@ import { C as Client$8 } from './blueprint-manifest.d-BVxmCeu7.cjs';
 import { C as Client$9 } from './calendar.d-mk-ltGpk.cjs';
 import { C as Client$a } from './configuration-hub.d-Dv41yC3b.cjs';
 import { C as Client$b } from './consent.d-C2PROHhX.cjs';
-import { C as Client$c } from './customer-portal.d-DTnk0yQf.cjs';
+import { C as Client$c } from './customer-portal.d-DJHJY-vb.cjs';
 import { C as Client$d } from './dashboard.d-BSevFHjf.cjs';
 import { C as Client$e } from './data-governance.d-BbZ466j5.cjs';
 import { C as Client$f } from './deduplication.d-Cueh8bDD.cjs';

package/dist/index.d.ts

@@ -15,7 +15,7 @@ import { C as Client$8 } from './blueprint-manifest.d-BVxmCeu7.js';
 import { C as Client$9 } from './calendar.d-mk-ltGpk.js';
 import { C as Client$a } from './configuration-hub.d-Dv41yC3b.js';
 import { C as Client$b } from './consent.d-C2PROHhX.js';
-import { C as Client$c } from './customer-portal.d-DTnk0yQf.js';
+import { C as Client$c } from './customer-portal.d-DJHJY-vb.js';
 import { C as Client$d } from './dashboard.d-BSevFHjf.js';
 import { C as Client$e } from './data-governance.d-BbZ466j5.js';
 import { C as Client$f } from './deduplication.d-Cueh8bDD.js';

package/dist/index.js

@@ -158,7 +158,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-PHOP6DMJ.js";
+} from "./chunk-HWPPR3IM.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";

package/docs/customer-portal.md

@@ -627,7 +627,8 @@ const { data } = await client.upsertPortal(
         enabled: true,
         template_id: '3fa85f64-5717-4562-b3fc-2c963f66afa6'
       }
-    ]
+    ],
+    engagement_center_enabled: true
   },
 )
 ```
@@ -863,6 +864,7 @@ const { data } = await client.upsertPortal(
       "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
     }
   ],
+  "engagement_center_enabled": true,
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -1236,6 +1238,7 @@ const { data } = await client.getPortalConfigByDomain({
       "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
     }
   ],
+  "engagement_center_enabled": true,
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -1512,6 +1515,7 @@ const { data } = await client.getPortalConfig({
       "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
     }
   ],
+  "engagement_center_enabled": true,
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -2677,6 +2681,7 @@ const { data } = await client.getPublicPortalConfig({
       "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
     }
   ],
+  "engagement_center_enabled": true,
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -2953,6 +2958,7 @@ const { data } = await client.getOrgPortalConfig({
       "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
     }
   ],
+  "engagement_center_enabled": true,
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -3238,6 +3244,7 @@ const { data } = await client.getPublicPortalConfigV3({
       "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
     }
   ],
+  "engagement_center_enabled": true,
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -3514,6 +3521,7 @@ const { data } = await client.getOrgPortalConfigV3({
       "template_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
     }
   ],
+  "engagement_center_enabled": true,
   "id": 12345,
   "organization_id": 12345,
   "org_settings": {
@@ -3616,6 +3624,7 @@ const { data } = await client.getAllPortalConfigs()
       "pages": {},
       "global_blocks": {},
       "notification_triggers": [],
+      "engagement_center_enabled": true,
       "id": 12345,
       "organization_id": 12345,
       "org_settings": {},
@@ -7144,7 +7153,7 @@ const { data } = await client.ssoCallback(
     token_endpoint: 'https://www.facebook.com/v12.0/dialog/oauth',
     grant_type: 'authorization_code',
     code: '123456',
-    redirect_uri: 'https://customer-portal.com/login',
+    redirect_uri: 'https://customer-portal.com/sso',
     client_id: '123456',
     code_verifier: '123456'
   },
@@ -13166,7 +13175,7 @@ type VisualizationMetadata = {
     color?: "primary" | "slate" | "mauve" | "orange" | "red" | "tomato" | "amber" | "green" | "blue"
     precision?: number
   }>
-  intervals?: "PT15M" | "PT1H" | "P1D" | "P1M"[]
+  intervals?: "PT15M" | "PT1H" | "P1D" | "P1M" | "P1Y"[]
   data_range?: {
     from?: string // date-time
     to?: string // date-time
@@ -14134,7 +14143,7 @@ type SSOCallbackRequest = {
   token_endpoint: string
   grant_type: string
   code: string
-  redirect_uri: string
+  redirect_uri?: string
   client_id: string
   code_verifier: string
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/sdk",
-  "version": "2.19.4",
+  "version": "2.19.5",
   "description": "JavaScript/TypeScript SDK for epilot APIs",
   "type": "module",
   "main": "./dist/index.cjs",