@oneuptime/common 13.0.0 → 13.0.1

package/build/dist/Models/DatabaseModels/VMwareResource.js

@@ -0,0 +1,1201 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import VMwareVCenter from "./VMwareVCenter";
+import Project from "./Project";
+import User from "./User";
+import BaseModel from "./DatabaseBaseModel/DatabaseBaseModel";
+import Route from "../../Types/API/Route";
+import ColumnAccessControl from "../../Types/Database/AccessControl/ColumnAccessControl";
+import TableAccessControl from "../../Types/Database/AccessControl/TableAccessControl";
+import ColumnLength from "../../Types/Database/ColumnLength";
+import ColumnType from "../../Types/Database/ColumnType";
+import CrudApiEndpoint from "../../Types/Database/CrudApiEndpoint";
+import TableColumn from "../../Types/Database/TableColumn";
+import TableColumnType from "../../Types/Database/TableColumnType";
+import TableMetadata from "../../Types/Database/TableMetadata";
+import TenantColumn from "../../Types/Database/TenantColumn";
+import IconProp from "../../Types/Icon/IconProp";
+import ObjectID from "../../Types/ObjectID";
+import Permission from "../../Types/Permission";
+import { Column, Entity, Index, JoinColumn, ManyToOne } from "typeorm";
+/*
+ * ------------------------------------------------------------------
+ *                          VMwareResource
+ * ------------------------------------------------------------------
+ *
+ * Inventory snapshot of a single vSphere object (Datacenter, Cluster,
+ * ESXi Host, Virtual Machine, Datastore or Resource Pool) as seen
+ * through one vCenter. Populated by the OTel metrics ingest path from
+ * the OpenTelemetry Collector `vcenter` receiver — identity arrives in
+ * the RESOURCE attributes of every metric batch (vcenter.datacenter.name,
+ * vcenter.cluster.name, vcenter.host.name, vcenter.vm.name / vcenter.vm.id,
+ * vcenter.datastore.name, vcenter.resource_pool.inventory_path), so no
+ * separate object stream is needed.
+ *
+ * `externalId` is derived from those attributes and is immutable and
+ * collision-free within a vCenter:
+ *   datacenter/<dc>            cluster/<dc>/<cluster>
+ *   host/<dc>/<host>           vm/<vcenter.vm.id | vcenter.vm_template.id>
+ *   datastore/<dc>/<datastore> resourcepool/<inventory path>
+ * The column is ShortText (100). An id longer than that (a deeply
+ * nested resource-pool path, the vm/<dc>/<host>/<name> fallback) is
+ * shortened by the snapshot scan to a prefix + "~" + 16-hex sha1 of the
+ * full id, so two long paths never share a row; the full path stays in
+ * the LongText resourcePoolPath column.
+ *
+ * Power state is inferred rather than reported: the receiver emits
+ * vcenter.vm.cpu.* ONLY for powered-on virtual machines, so a VM whose
+ * batch carried memory/disk points but no CPU point is powered off (or
+ * suspended — the receiver does not distinguish). Templates never carry
+ * a power state.
+ *
+ * Count columns that fan out over datapoint attributes (status,
+ * power_state, effective) are SUMMED across the newest timestamp for
+ * that (resource, metric) — never "newest datapoint wins".
+ *
+ * The list/detail pages read this table instead of groupBy-ing over
+ * 24h of ClickHouse metric data. Rows are upserted per collection and
+ * hard-deleted once lastSeenAt falls behind the staleness threshold for
+ * vCenters that remain connected.
+ *
+ * Writes go through VMwareResourceService under isRoot; users never
+ * create/update/delete rows directly.
+ *
+ * ------------------------------------------------------------------
+ */
+const READ_PERMISSIONS = [
+    Permission.ProjectOwner,
+    Permission.ProjectAdmin,
+    Permission.ProjectMember,
+    Permission.Viewer,
+    Permission.SettingsAdmin,
+    Permission.SettingsMember,
+    Permission.SettingsViewer,
+    Permission.ReadVMwareVCenter,
+];
+let VMwareResource = class VMwareResource extends BaseModel {
+    constructor() {
+        super(...arguments);
+        this.project = undefined;
+        this.projectId = undefined;
+        this.vmwareVCenter = undefined;
+        this.vmwareVCenterId = undefined;
+        this.kind = undefined;
+        this.externalId = undefined;
+        this.name = undefined;
+        this.datacenterName = undefined;
+        this.clusterName = undefined;
+        this.hostName = undefined;
+        this.resourcePoolName = undefined;
+        this.resourcePoolPath = undefined;
+        this.virtualAppName = undefined;
+        this.vmInstanceUuid = undefined;
+        this.isTemplate = undefined;
+        this.isPoweredOn = undefined;
+        this.latestCpuPercent = undefined;
+        this.latestCpuMhz = undefined;
+        this.cpuCapacityMhz = undefined;
+        this.cpuEffectiveMhz = undefined;
+        this.latestMemoryBytes = undefined;
+        this.maxMemoryBytes = undefined;
+        this.memoryEffectiveBytes = undefined;
+        this.latestMemoryPercent = undefined;
+        this.latestDiskBytes = undefined;
+        this.maxDiskBytes = undefined;
+        this.latestDiskPercent = undefined;
+        this.cpuReadinessPercent = undefined;
+        this.memoryBalloonedBytes = undefined;
+        this.memorySwappedBytes = undefined;
+        this.hostCount = undefined;
+        this.effectiveHostCount = undefined;
+        this.poweredOnHostCount = undefined;
+        this.vmCount = undefined;
+        this.poweredOnVmCount = undefined;
+        this.vmTemplateCount = undefined;
+        this.datastoreCount = undefined;
+        this.clusterCount = undefined;
+        this.metricsUpdatedAt = undefined;
+        this.lastSeenAt = undefined;
+        this.createdByUser = undefined;
+        this.createdByUserId = undefined;
+        this.deletedByUser = undefined;
+        this.deletedByUserId = undefined;
+    }
+};
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        manyToOneRelationColumn: "projectId",
+        type: TableColumnType.Entity,
+        modelType: Project,
+        title: "Project",
+        description: "Relation to Project this resource belongs to.",
+    }),
+    ManyToOne(() => {
+        return Project;
+    }, {
+        eager: false,
+        nullable: true,
+        onDelete: "CASCADE",
+        orphanedRowAction: "nullify",
+    }),
+    JoinColumn({ name: "projectId" }),
+    __metadata("design:type", Project)
+], VMwareResource.prototype, "project", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    Index(),
+    TableColumn({
+        type: TableColumnType.ObjectID,
+        required: true,
+        canReadOnRelationQuery: true,
+        title: "Project ID",
+        description: "ID of the Project this resource belongs to.",
+    }),
+    Column({
+        type: ColumnType.ObjectID,
+        nullable: false,
+        transformer: ObjectID.getDatabaseTransformer(),
+    }),
+    __metadata("design:type", ObjectID)
+], VMwareResource.prototype, "projectId", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        manyToOneRelationColumn: "vmwareVCenterId",
+        type: TableColumnType.Entity,
+        modelType: VMwareVCenter,
+        title: "vCenter",
+        description: "vCenter this resource is inventoried through.",
+    }),
+    ManyToOne(() => {
+        return VMwareVCenter;
+    }, {
+        eager: false,
+        nullable: true,
+        onDelete: "CASCADE",
+        orphanedRowAction: "nullify",
+    }),
+    JoinColumn({ name: "vmwareVCenterId" }),
+    __metadata("design:type", VMwareVCenter)
+], VMwareResource.prototype, "vmwareVCenter", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    Index(),
+    TableColumn({
+        type: TableColumnType.ObjectID,
+        required: true,
+        canReadOnRelationQuery: true,
+        title: "vCenter ID",
+        description: "ID of the vCenter this resource is inventoried through.",
+    }),
+    Column({
+        type: ColumnType.ObjectID,
+        nullable: false,
+        transformer: ObjectID.getDatabaseTransformer(),
+    }),
+    __metadata("design:type", ObjectID)
+], VMwareResource.prototype, "vmwareVCenterId", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: true,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "Kind",
+        description: "vSphere object kind in singular PascalCase: Datacenter, Cluster, Host, VirtualMachine, Datastore or ResourcePool.",
+    }),
+    Column({
+        nullable: false,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "kind", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: true,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "External ID",
+        description: "Immutable, collision-free identity within a vCenter, derived from the vcenter receiver's resource attributes: datacenter/<dc>, cluster/<dc>/<cluster>, host/<dc>/<host>, vm/<instance uuid> (fallback vm/<dc>/<host>/<name>), datastore/<dc>/<datastore>, resourcepool/<inventory path>. Also the URL-encoded detail-route param. Ids longer than 100 characters are shortened by the ingest layer to an 83-character prefix plus '~' and a 16-hex sha1 suffix of the full id, so two long inventory paths never collapse to the same key; the full inventory path stays in resourcePoolPath.",
+    }),
+    Column({
+        nullable: false,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "externalId", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "Name",
+        description: "Display name of the object as shown in the vSphere Client — the vcenter.datacenter.name, vcenter.cluster.name, vcenter.host.name, vcenter.vm.name / vcenter.vm_template.name, vcenter.datastore.name or vcenter.resource_pool.name resource attribute.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "name", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "Datacenter Name",
+        description: "The vcenter.datacenter.name resource attribute — the vSphere datacenter this object lives in. Every kind carries it.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "datacenterName", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "Cluster Name",
+        description: "The vcenter.cluster.name resource attribute — the vSphere cluster this host, virtual machine or resource pool belongs to. Null for standalone ESXi hosts and their VMs, and for Datacenter / Datastore kinds.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "clusterName", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "Host Name",
+        description: "The vcenter.host.name resource attribute — the ESXi host a virtual machine currently runs on, or the owner host of a resource pool on a standalone host. For Host kinds this equals name.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "hostName", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "Resource Pool Name",
+        description: "The vcenter.resource_pool.name resource attribute — the resource pool a virtual machine is placed in. Null when the VM belongs to a vApp instead, and for non-VM kinds other than ResourcePool.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "resourcePoolName", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.LongText,
+        canReadOnRelationQuery: true,
+        title: "Resource Pool Inventory Path",
+        description: "The vcenter.resource_pool.inventory_path resource attribute (e.g. /DC1/host/Cluster1/Resources/Prod). For VMs placed in a vApp this holds vcenter.virtual_app.inventory_path instead. Stored as long text because vSphere inventory paths regularly exceed 100 characters.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.LongText,
+        length: ColumnLength.LongText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "resourcePoolPath", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "vApp Name",
+        description: "The vcenter.virtual_app.name resource attribute — the vApp a virtual machine belongs to. Null unless the VM is a vApp member.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "virtualAppName", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.ShortText,
+        canReadOnRelationQuery: true,
+        title: "VM Instance UUID",
+        description: "The vcenter.vm.id (or vcenter.vm_template.id) resource attribute — the virtual machine's instance UUID, stable across vMotion and renames. Null for non-VM kinds.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.ShortText,
+        length: ColumnLength.ShortText,
+    }),
+    __metadata("design:type", String)
+], VMwareResource.prototype, "vmInstanceUuid", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Boolean,
+        canReadOnRelationQuery: true,
+        title: "Is Template",
+        description: "True when this VirtualMachine row is a VM template (reported under vcenter.vm_template.*). Templates only report disk usage and never have a power state. Null for non-VM kinds.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Boolean,
+    }),
+    __metadata("design:type", Boolean)
+], VMwareResource.prototype, "isTemplate", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Boolean,
+        canReadOnRelationQuery: true,
+        title: "Is Powered On",
+        description: "Inferred power state for VirtualMachine rows: true when the latest collection carried any vcenter.vm.cpu.* datapoint (the receiver emits those only for powered-on VMs), false when it carried memory or disk points but no CPU point (powered off or suspended — the receiver does not distinguish). Null for templates and non-VM kinds.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Boolean,
+    }),
+    __metadata("design:type", Boolean)
+], VMwareResource.prototype, "isPoweredOn", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Latest CPU Percent",
+        description: "Most recent CPU utilization percent — vcenter.host.cpu.utilization for hosts, vcenter.vm.cpu.utilization for virtual machines (already a 0-100 percent, so no denominator cache is needed). Stored as decimal so sub-percent precision survives the round trip. Null for other kinds and until the first metric arrives.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Decimal,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return value;
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                if (typeof value === "number") {
+                    return value;
+                }
+                const parsed = parseFloat(value);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "latestCpuPercent", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Latest CPU MHz",
+        description: "Most recent CPU usage in MHz — vcenter.host.cpu.usage, vcenter.vm.cpu.usage or vcenter.resource_pool.cpu.usage. Rounded to a whole MHz by the ingest layer.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "latestCpuMhz", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "CPU Capacity MHz",
+        description: "Total CPU capacity in MHz — vcenter.host.cpu.capacity for hosts, vcenter.cluster.cpu.limit for clusters, vcenter.datacenter.cpu.limit for datacenters. The denominator for the CPU usage bar.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "cpuCapacityMhz", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "CPU Effective MHz",
+        description: "vcenter.cluster.cpu.effective — CPU capacity in MHz actually available to virtual machines after vSphere HA / maintenance-mode reservations. Cluster kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "cpuEffectiveMhz", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.BigPositiveNumber,
+        canReadOnRelationQuery: true,
+        title: "Latest Memory Bytes",
+        description: "Most recent memory usage in bytes — vcenter.host.memory.usage, vcenter.vm.memory.usage or vcenter.resource_pool.memory.usage (guest type), converted from MiB. Stored as bigint so values past 2 GiB don't overflow.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.BigPositiveNumber,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return Math.trunc(value).toString();
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                const parsed = parseInt(value, 10);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "latestMemoryBytes", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.BigPositiveNumber,
+        canReadOnRelationQuery: true,
+        title: "Max Memory Bytes",
+        description: "Total memory in bytes — vcenter.host.memory.capacity for hosts (falling back to usage / utilization), derived from usage and utilization for virtual machines, vcenter.cluster.memory.limit for clusters, vcenter.datacenter.memory.limit for datacenters. The denominator for the memory usage bar.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.BigPositiveNumber,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return Math.trunc(value).toString();
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                const parsed = parseInt(value, 10);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "maxMemoryBytes", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.BigPositiveNumber,
+        canReadOnRelationQuery: true,
+        title: "Memory Effective Bytes",
+        description: "vcenter.cluster.memory.effective — memory in bytes actually available to virtual machines after vSphere HA / maintenance-mode reservations. Cluster kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.BigPositiveNumber,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return Math.trunc(value).toString();
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                const parsed = parseInt(value, 10);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "memoryEffectiveBytes", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Latest Memory Percent",
+        description: "Most recent memory utilization percent — vcenter.host.memory.utilization or vcenter.vm.memory.utilization. Stored as decimal — mirrors latestCpuPercent — so list views can sort/filter without dividing bigints client-side.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Decimal,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return value;
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                if (typeof value === "number") {
+                    return value;
+                }
+                const parsed = parseFloat(value);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "latestMemoryPercent", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.BigPositiveNumber,
+        canReadOnRelationQuery: true,
+        title: "Latest Disk Bytes",
+        description: "Most recent used disk space in bytes — vcenter.vm.disk.usage{disk_state=used} for virtual machines, vcenter.datastore.disk.usage{disk_state=used} for datastores, vcenter.datacenter.disk.space{disk_state=used} for datacenters. Null for other kinds.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.BigPositiveNumber,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return Math.trunc(value).toString();
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                const parsed = parseInt(value, 10);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "latestDiskBytes", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.BigPositiveNumber,
+        canReadOnRelationQuery: true,
+        title: "Max Disk Bytes",
+        description: "Total disk space in bytes — the used plus available disk_state datapoints of the same metric that feeds latestDiskBytes. The denominator for the disk / datastore usage bar.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.BigPositiveNumber,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return Math.trunc(value).toString();
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                const parsed = parseInt(value, 10);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "maxDiskBytes", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Latest Disk Percent",
+        description: "Most recent disk utilization percent — vcenter.vm.disk.utilization or vcenter.datastore.disk.utilization; derived as used / (used + available) x 100 for datacenters.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Decimal,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return value;
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                if (typeof value === "number") {
+                    return value;
+                }
+                const parsed = parseFloat(value);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "latestDiskPercent", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "CPU Readiness Percent",
+        description: "vcenter.vm.cpu.readiness — percentage of time the virtual machine was ready to run but could not be scheduled on a physical CPU (CPU ready). Sustained values above 10% mean host CPU contention. VirtualMachine kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Decimal,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return value;
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                if (typeof value === "number") {
+                    return value;
+                }
+                const parsed = parseFloat(value);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "cpuReadinessPercent", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.BigPositiveNumber,
+        canReadOnRelationQuery: true,
+        title: "Memory Ballooned Bytes",
+        description: "vcenter.vm.memory.ballooned or vcenter.resource_pool.memory.ballooned converted from MiB — guest memory reclaimed by the balloon driver. Any non-zero value means the host is under memory pressure.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.BigPositiveNumber,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return Math.trunc(value).toString();
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                const parsed = parseInt(value, 10);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "memoryBalloonedBytes", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.BigPositiveNumber,
+        canReadOnRelationQuery: true,
+        title: "Memory Swapped Bytes",
+        description: "vcenter.vm.memory.swapped or vcenter.resource_pool.memory.swapped converted from MiB — guest memory swapped to disk by the hypervisor. Any non-zero value is a critical memory-pressure signal.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.BigPositiveNumber,
+        transformer: {
+            to: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                return Math.trunc(value).toString();
+            },
+            from: (value) => {
+                if (value === null || value === undefined) {
+                    return null;
+                }
+                const parsed = parseInt(value, 10);
+                return isNaN(parsed) ? null : parsed;
+            },
+        },
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "memorySwappedBytes", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Host Count",
+        description: "ESXi hosts in this cluster or datacenter — the sum of vcenter.cluster.host.count over both effective values, or of vcenter.datacenter.host.count over every status and power_state. Cluster and Datacenter kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "hostCount", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Effective Host Count",
+        description: "vcenter.cluster.host.count{effective=true} — hosts that are connected, not in maintenance mode and contributing resources to the cluster. A gap against hostCount means a host is in maintenance mode or unresponsive. Cluster kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "effectiveHostCount", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Powered On Host Count",
+        description: "Sum of vcenter.datacenter.host.count{power_state=on} across every status. Datacenter kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "poweredOnHostCount", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "VM Count",
+        description: "Virtual machines in this cluster or datacenter — the sum of vcenter.cluster.vm.count over every power_state, or of vcenter.datacenter.vm.count over every status and power_state. Cluster and Datacenter kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "vmCount", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Powered On VM Count",
+        description: "vcenter.cluster.vm.count{power_state=on}, or the sum of vcenter.datacenter.vm.count{power_state=on} across every status. Cluster and Datacenter kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "poweredOnVmCount", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "VM Template Count",
+        description: "vcenter.cluster.vm_template.count — VM templates registered in this cluster. Cluster kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "vmTemplateCount", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Datastore Count",
+        description: "vcenter.datacenter.datastore.count — datastores visible in this datacenter. Datacenter kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "datastoreCount", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Number,
+        canReadOnRelationQuery: true,
+        title: "Cluster Count",
+        description: "Sum of vcenter.datacenter.cluster.count across every status — clusters in this datacenter. Datacenter kinds only.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Number,
+    }),
+    __metadata("design:type", Number)
+], VMwareResource.prototype, "clusterCount", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: false,
+        type: TableColumnType.Date,
+        canReadOnRelationQuery: true,
+        title: "Metrics Updated At",
+        description: "Observed timestamp of the latest metric point. Acts as the monotonic guard for metric updates and the cutoff for staleness rendering.",
+    }),
+    Column({
+        nullable: true,
+        type: ColumnType.Date,
+    }),
+    __metadata("design:type", Date)
+], VMwareResource.prototype, "metricsUpdatedAt", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        required: true,
+        type: TableColumnType.Date,
+        canReadOnRelationQuery: true,
+        title: "Last Seen At",
+        description: "Agent-observed timestamp of the most recent collection containing this resource. Also acts as the monotonic guard for upserts and the staleness delete threshold.",
+    }),
+    Column({
+        nullable: false,
+        type: ColumnType.Date,
+    }),
+    __metadata("design:type", Date)
+], VMwareResource.prototype, "lastSeenAt", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        manyToOneRelationColumn: "createdByUserId",
+        type: TableColumnType.Entity,
+        modelType: User,
+        title: "Created By User",
+        description: "Not user-facing; ingest writes as isRoot so this stays null in practice.",
+    }),
+    ManyToOne(() => {
+        return User;
+    }, {
+        eager: false,
+        nullable: true,
+        onDelete: "SET NULL",
+        orphanedRowAction: "nullify",
+    }),
+    JoinColumn({ name: "createdByUserId" }),
+    __metadata("design:type", User)
+], VMwareResource.prototype, "createdByUser", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        type: TableColumnType.ObjectID,
+        title: "Created By User ID",
+        description: "ID of the user who created this row.",
+    }),
+    Column({
+        type: ColumnType.ObjectID,
+        nullable: true,
+        transformer: ObjectID.getDatabaseTransformer(),
+    }),
+    __metadata("design:type", ObjectID)
+], VMwareResource.prototype, "createdByUserId", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        manyToOneRelationColumn: "deletedByUserId",
+        type: TableColumnType.Entity,
+        modelType: User,
+        title: "Deleted By User",
+        description: "Relation to the user who deleted this row.",
+    }),
+    ManyToOne(() => {
+        return User;
+    }, {
+        eager: false,
+        nullable: true,
+        onDelete: "SET NULL",
+        orphanedRowAction: "nullify",
+    }),
+    JoinColumn({ name: "deletedByUserId" }),
+    __metadata("design:type", User)
+], VMwareResource.prototype, "deletedByUser", void 0);
+__decorate([
+    ColumnAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+    }),
+    TableColumn({
+        type: TableColumnType.ObjectID,
+        title: "Deleted By User ID",
+        description: "ID of the user who deleted this row.",
+    }),
+    Column({
+        type: ColumnType.ObjectID,
+        nullable: true,
+        transformer: ObjectID.getDatabaseTransformer(),
+    }),
+    __metadata("design:type", ObjectID)
+], VMwareResource.prototype, "deletedByUserId", void 0);
+VMwareResource = __decorate([
+    TenantColumn("projectId"),
+    TableAccessControl({
+        create: [],
+        read: READ_PERMISSIONS,
+        update: [],
+        delete: [],
+    }),
+    CrudApiEndpoint(new Route("/vmware-resource")),
+    TableMetadata({
+        tableName: "VMwareResource",
+        singularName: "VMware Resource",
+        pluralName: "VMware Resources",
+        icon: IconProp.Cube,
+        tableDescription: "Snapshot of a vSphere object (datacenter, cluster, ESXi host, virtual machine, datastore or resource pool) as last reported by the VMware agent through vCenter. Populated by the telemetry ingest pipeline; not user-editable.",
+    }),
+    Index(["projectId", "vmwareVCenterId", "kind", "externalId"], {
+        unique: true,
+    }),
+    Entity({
+        name: "VMwareResource",
+    })
+], VMwareResource);
+export default VMwareResource;
+//# sourceMappingURL=VMwareResource.js.map