bruce-models 7.1.128 → 7.1.130

package/dist/types/report/report-template-section.d.ts

@@ -0,0 +1,131 @@
+import { Api } from "../api/api";
+import { BruceApi } from "../api/bruce-api";
+import { ReportTemplate } from "./report-template";
+/**
+ * Ordered sections belonging to a single Report Template; every route requires the owning template ID.
+ * Access can be granted directly or inherited through the parent template's permissions.
+ */
+export declare namespace ReportTemplateSection {
+    /**
+     * JSON settings specific to a section; the API does not prescribe their internal schema.
+     */
+    type TSettings = {
+        [key: string]: unknown;
+    };
+    /**
+     * A section whose identity and owning template are controlled by the request path.
+     */
+    interface ISection {
+        /**
+         * Database-assigned bigint identity. Omit or use 0 when creating a section.
+         */
+        ID?: ReportTemplate.TId;
+        /**
+         * Identity of the owning template; ignored in the body when the route specifies a parent.
+         */
+        "ReportTemplate.ID"?: ReportTemplate.TId;
+        /**
+         * Signed 32-bit integer position, ascending; defaults to 1 when omitted on creation.
+         */
+        DisplayOrder?: number;
+        /**
+         * Section heading, required on creation; 1 to 200 characters and not entirely whitespace.
+         */
+        Title?: string;
+        /**
+         * Settings for this section. Null clears them; omission preserves them on update.
+         */
+        Settings?: TSettings | null;
+    }
+    /**
+     * Inputs for reading a section through the template that owns it.
+     */
+    interface IGetParams {
+        api?: BruceApi.Api;
+        reportTemplateId: ReportTemplate.TId;
+        /**
+         * Positive identity of a section belonging to reportTemplateId.
+         */
+        sectionId: ReportTemplate.TId;
+        req?: Api.IReqParams;
+    }
+    /**
+     * The section returned by a single-record read.
+     */
+    interface IGetRes {
+        reportTemplateSection: ISection;
+    }
+    /**
+     * Inputs for listing sections within an existing template; no paging is supported.
+     */
+    interface IGetListParams {
+        api?: BruceApi.Api;
+        reportTemplateId: ReportTemplate.TId;
+        req?: Api.IReqParams;
+    }
+    /**
+     * Visible sections ordered by DisplayOrder ascending, then ID ascending to break ties.
+     */
+    interface IGetListRes {
+        reportTemplateSections: ISection[];
+    }
+    /**
+     * Inputs for creating or updating a section; the path always controls its parent and identity.
+     */
+    interface IUpdateParams {
+        api?: BruceApi.Api;
+        /**
+         * Explicit parent takes precedence over reportTemplateSection["ReportTemplate.ID"].
+         */
+        reportTemplateId?: ReportTemplate.TId;
+        /**
+         * Overrides the section's ID. Omit both section IDs, or use 0, to create under the parent.
+         */
+        sectionId?: ReportTemplate.TId;
+        /**
+         * Fields to save. Title is required on creation; omitted fields are preserved on update.
+         */
+        reportTemplateSection: ISection;
+        req?: Api.IReqParams;
+    }
+    /**
+     * The saved section, including its server-assigned identity and owning template.
+     */
+    interface IUpdateRes {
+        reportTemplateSection: ISection;
+    }
+    /**
+     * Inputs for deleting a section through its owning template.
+     */
+    interface IDeleteParams {
+        api?: BruceApi.Api;
+        reportTemplateId: ReportTemplate.TId;
+        sectionId: ReportTemplate.TId;
+        req?: Api.IReqParams;
+    }
+    /**
+     * Reads one section; a section belonging to another template is rejected by the server.
+     */
+    function Get(params: IGetParams): Promise<IGetRes>;
+    /**
+     * Lists visible sections of a template in display order, filtered by the caller's permissions.
+     */
+    function GetList(params: IGetListParams): Promise<IGetListRes>;
+    /**
+     * Creates with section ID 0 or updates under an existing parent; Settings accepts null to clear it.
+     * The server ignores body IDs, preserves omitted fields and never moves a section to another parent.
+     */
+    function Update(params: IUpdateParams): Promise<IUpdateRes>;
+    /**
+     * Deletes only the identified section, preserving its template and sibling sections.
+     */
+    function Delete(params: IDeleteParams): Promise<void>;
+    /**
+     * Cache identifier scoped to both parent and section, so another parent's read cannot reuse it.
+     */
+    function GetCacheKey(reportTemplateId: ReportTemplate.TId, sectionId: ReportTemplate.TId): string;
+    /**
+     * Cache identifier for one template's visible section list.
+     */
+    function GetListCacheKey(reportTemplateId: ReportTemplate.TId): string;
+}

package/dist/types/report/report-template.d.ts

@@ -0,0 +1,136 @@
+import { Api } from "../api/api";
+import { BruceApi } from "../api/bruce-api";
+/**
+ * Reusable report definitions whose ordered sections are separate ReportTemplateSection records.
+ * These calls require an API deployment that supports the Report Template concepts.
+ */
+export declare namespace ReportTemplate {
+    /**
+     * Database bigint identity; decimal strings preserve IDs beyond JavaScript's safe integer range.
+     */
+    type TId = number | string;
+    /**
+     * JSON settings for the report's main structure; the API does not prescribe their internal schema.
+     */
+    type TSettings = {
+        [key: string]: unknown;
+    };
+    /**
+     * A report template, without its sections; load those through ReportTemplateSection.GetList.
+     */
+    interface ITemplate {
+        /**
+         * Database-assigned identity. Omit or use 0 when creating a template.
+         */
+        ID?: TId;
+        /**
+         * Display name, required on creation; 1 to 200 characters and not entirely whitespace.
+         */
+        Name?: string;
+        /**
+         * Optional explanation of the template's purpose. Null clears it on update.
+         */
+        Description?: string | null;
+        /**
+         * Server-assigned creator, preserved on update and ignored in request bodies.
+         */
+        "Created.ByUser.ID"?: string;
+        /**
+         * Server-assigned creation time in ISO 8601 format, preserved on update.
+         */
+        "Created.DateTime"?: string;
+        /**
+         * Main report settings. Null clears them; section settings belong on each section record.
+         */
+        Settings?: TSettings | null;
+    }
+    /**
+     * Inputs for reading a single template in the current account and session.
+     */
+    interface IGetParams {
+        api?: BruceApi.Api;
+        /**
+         * Positive identity of the template to read.
+         */
+        reportTemplateId: TId;
+        req?: Api.IReqParams;
+    }
+    /**
+     * The template returned by a single-record read or save.
+     */
+    interface IGetRes {
+        reportTemplate: ITemplate;
+    }
+    /**
+     * Inputs for listing all templates visible to the current account session; no paging is supported.
+     */
+    interface IGetListParams {
+        api?: BruceApi.Api;
+        req?: Api.IReqParams;
+    }
+    /**
+     * Visible templates ordered by Name ascending, then ID ascending to break ties.
+     */
+    interface IGetListRes {
+        reportTemplates: ITemplate[];
+    }
+    /**
+     * Inputs for creating or updating a template; omitted fields retain their existing values.
+     */
+    interface IUpdateParams {
+        api?: BruceApi.Api;
+        /**
+         * Template fields to save. Name is required when creating; metadata is server-controlled.
+         */
+        reportTemplate: ITemplate;
+        /**
+         * Overrides reportTemplate.ID. Omit both IDs, or use 0, to create a template.
+         */
+        reportTemplateId?: TId;
+        req?: Api.IReqParams;
+    }
+    /**
+     * The saved template, including its identity and creation metadata.
+     */
+    interface IUpdateRes {
+        reportTemplate: ITemplate;
+    }
+    /**
+     * Inputs for deleting a template and all of its sections atomically.
+     */
+    interface IDeleteParams {
+        api?: BruceApi.Api;
+        reportTemplateId: TId;
+        req?: Api.IReqParams;
+    }
+    /**
+     * Validates and normalizes a signed 64-bit identity for routes and cache keys without rounding it.
+     * Zero is accepted only for creation; decimal strings can represent the full positive bigint range.
+     */
+    function NormalizeId(id: TId, allowZero?: boolean): string;
+    /**
+     * Reads a template by ID, subject to the caller's template view permission.
+     */
+    function Get(params: IGetParams): Promise<IGetRes>;
+    /**
+     * Lists visible templates in name order; the server filters out records the caller cannot view.
+     */
+    function GetList(params?: IGetListParams): Promise<IGetListRes>;
+    /**
+     * Creates with ID 0 or updates the identified template, preserving omitted fields on the server.
+     * Explicit null clears Description or Settings; identity and creation metadata come from the server.
+     */
+    function Update(params: IUpdateParams): Promise<IUpdateRes>;
+    /**
+     * Deletes a template and every section it owns; requires template delete permission.
+     */
+    function Delete(params: IDeleteParams): Promise<void>;
+    /**
+     * Cache identifier for one template, shared by numeric IDs and their decimal string equivalents.
+     */
+    function GetCacheKey(reportTemplateId: TId): string;
+    /**
+     * Cache identifier for the account's visible template list.
+     */
+    function GetListCacheKey(): string;
+}

package/dist/types/user/user-access-log.d.ts

@@ -0,0 +1,39 @@
+import { Api } from "../api/api";
+import { GuardianApi } from "../api/guardian-api";
+/**
+ * Guardian's record of sign-ins and other access, such as an access token used directly.
+ * Reading it needs account admin for an account, or super user for every account.
+ */
+export declare namespace UserAccessLog {
+    /**
+     * Describes an access log record.
+     */
+    interface IRecord {
+        Username: string;
+        "ClientAccount.ID"?: string;
+        Created: string;
+        IsLogin: boolean;
+        Type: string;
+        Success: boolean;
+        Message?: string;
+        UserAgent?: string;
+        IP?: string;
+        Environment?: string;
+    }
+    /**
+     * Returns access log records, newest first, or each user's newest one when grouped by user.
+     */
+    function GetList(params: {
+        api?: GuardianApi.Api;
+        accountId?: string;
+        userIds?: string[];
+        groupByUser?: boolean;
+        isLogin?: boolean | "*";
+        success?: boolean;
+        pageSize?: number;
+        pageIndex?: number;
+        req?: Api.IReqParams;
+    }): Promise<{
+        records: IRecord[];
+    }>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bruce-models",
-    "version": "7.1.128",
+    "version": "7.1.130",
     "description": "",
     "keywords": [],
     "main": "dist/bruce-models.umd.js",