@contractspec/lib.metering 1.44.0

package/dist/entities/index.js

@@ -0,0 +1,418 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/index.ts
+/**
+* Aggregation type enum.
+*/
+const AggregationTypeEnum = defineEntityEnum({
+	name: "AggregationType",
+	values: [
+		"COUNT",
+		"SUM",
+		"AVG",
+		"MAX",
+		"MIN",
+		"LAST"
+	],
+	schema: "lssm_metering",
+	description: "How to aggregate metric values."
+});
+/**
+* Reset period enum.
+*/
+const ResetPeriodEnum = defineEntityEnum({
+	name: "ResetPeriod",
+	values: [
+		"NEVER",
+		"HOURLY",
+		"DAILY",
+		"WEEKLY",
+		"MONTHLY",
+		"YEARLY"
+	],
+	schema: "lssm_metering",
+	description: "When to reset metric counters."
+});
+/**
+* Period type enum.
+*/
+const PeriodTypeEnum = defineEntityEnum({
+	name: "PeriodType",
+	values: [
+		"HOURLY",
+		"DAILY",
+		"WEEKLY",
+		"MONTHLY",
+		"YEARLY"
+	],
+	schema: "lssm_metering",
+	description: "Time period for aggregation."
+});
+/**
+* Threshold action enum.
+*/
+const ThresholdActionEnum = defineEntityEnum({
+	name: "ThresholdAction",
+	values: [
+		"NONE",
+		"ALERT",
+		"WARN",
+		"BLOCK",
+		"DOWNGRADE"
+	],
+	schema: "lssm_metering",
+	description: "Action to take when threshold is exceeded."
+});
+/**
+* MetricDefinition entity - defines a trackable metric.
+*/
+const MetricDefinitionEntity = defineEntity({
+	name: "MetricDefinition",
+	description: "Definition of a usage metric.",
+	schema: "lssm_metering",
+	map: "metric_definition",
+	fields: {
+		id: field.id({ description: "Unique identifier" }),
+		key: field.string({
+			isUnique: true,
+			description: "Metric key (e.g., api_calls, storage_gb)"
+		}),
+		name: field.string({ description: "Human-readable name" }),
+		description: field.string({
+			isOptional: true,
+			description: "Metric description"
+		}),
+		unit: field.string({ description: "Unit of measurement (calls, bytes, etc.)" }),
+		aggregationType: field.enum("AggregationType", {
+			default: "SUM",
+			description: "How to aggregate values"
+		}),
+		resetPeriod: field.enum("ResetPeriod", {
+			default: "MONTHLY",
+			description: "When to reset counters"
+		}),
+		precision: field.int({
+			default: 2,
+			description: "Decimal precision"
+		}),
+		orgId: field.string({
+			isOptional: true,
+			description: "Organization scope (null = global metric)"
+		}),
+		category: field.string({
+			isOptional: true,
+			description: "Category for grouping"
+		}),
+		displayOrder: field.int({
+			default: 0,
+			description: "Order for display"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		isActive: field.boolean({
+			default: true,
+			description: "Whether metric is active"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		usageRecords: field.hasMany("UsageRecord"),
+		usageSummaries: field.hasMany("UsageSummary"),
+		thresholds: field.hasMany("UsageThreshold")
+	},
+	indexes: [
+		index.on(["orgId", "key"]),
+		index.on(["category"]),
+		index.on(["isActive"])
+	],
+	enums: [AggregationTypeEnum, ResetPeriodEnum]
+});
+/**
+* UsageRecord entity - individual usage event.
+*/
+const UsageRecordEntity = defineEntity({
+	name: "UsageRecord",
+	description: "A single usage event.",
+	schema: "lssm_metering",
+	map: "usage_record",
+	fields: {
+		id: field.id({ description: "Unique identifier" }),
+		metricKey: field.string({ description: "Metric being recorded" }),
+		metricId: field.string({
+			isOptional: true,
+			description: "Metric ID (for FK)"
+		}),
+		subjectType: field.string({ description: "Subject type (org, user, project)" }),
+		subjectId: field.string({ description: "Subject identifier" }),
+		quantity: field.decimal({ description: "Usage quantity" }),
+		source: field.string({
+			isOptional: true,
+			description: "Source of usage (endpoint, feature, etc.)"
+		}),
+		resourceId: field.string({
+			isOptional: true,
+			description: "Related resource ID"
+		}),
+		resourceType: field.string({
+			isOptional: true,
+			description: "Related resource type"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional context"
+		}),
+		idempotencyKey: field.string({
+			isOptional: true,
+			description: "Idempotency key for deduplication"
+		}),
+		timestamp: field.dateTime({ description: "When usage occurred" }),
+		createdAt: field.createdAt(),
+		aggregated: field.boolean({
+			default: false,
+			description: "Whether included in summary"
+		}),
+		aggregatedAt: field.dateTime({
+			isOptional: true,
+			description: "When aggregated"
+		})
+	},
+	indexes: [
+		index.on([
+			"metricKey",
+			"subjectType",
+			"subjectId",
+			"timestamp"
+		]),
+		index.on([
+			"subjectType",
+			"subjectId",
+			"timestamp"
+		]),
+		index.on(["timestamp"]),
+		index.on(["aggregated", "timestamp"]),
+		index.unique(["idempotencyKey"], { name: "usage_record_idempotency" })
+	]
+});
+/**
+* UsageSummary entity - pre-aggregated usage.
+*/
+const UsageSummaryEntity = defineEntity({
+	name: "UsageSummary",
+	description: "Pre-aggregated usage summary.",
+	schema: "lssm_metering",
+	map: "usage_summary",
+	fields: {
+		id: field.id({ description: "Unique identifier" }),
+		metricKey: field.string({ description: "Metric key" }),
+		metricId: field.string({
+			isOptional: true,
+			description: "Metric ID (for FK)"
+		}),
+		subjectType: field.string({ description: "Subject type" }),
+		subjectId: field.string({ description: "Subject identifier" }),
+		periodType: field.enum("PeriodType", { description: "Period type" }),
+		periodStart: field.dateTime({ description: "Period start time" }),
+		periodEnd: field.dateTime({ description: "Period end time" }),
+		totalQuantity: field.decimal({ description: "Total/aggregated quantity" }),
+		recordCount: field.int({
+			default: 0,
+			description: "Number of records aggregated"
+		}),
+		minQuantity: field.decimal({
+			isOptional: true,
+			description: "Minimum value"
+		}),
+		maxQuantity: field.decimal({
+			isOptional: true,
+			description: "Maximum value"
+		}),
+		avgQuantity: field.decimal({
+			isOptional: true,
+			description: "Average value"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	},
+	indexes: [
+		index.unique([
+			"metricKey",
+			"subjectType",
+			"subjectId",
+			"periodType",
+			"periodStart"
+		], { name: "usage_summary_unique" }),
+		index.on([
+			"subjectType",
+			"subjectId",
+			"periodType",
+			"periodStart"
+		]),
+		index.on([
+			"metricKey",
+			"periodType",
+			"periodStart"
+		])
+	],
+	enums: [PeriodTypeEnum]
+});
+/**
+* UsageThreshold entity - threshold configuration.
+*/
+const UsageThresholdEntity = defineEntity({
+	name: "UsageThreshold",
+	description: "Usage threshold configuration.",
+	schema: "lssm_metering",
+	map: "usage_threshold",
+	fields: {
+		id: field.id({ description: "Unique identifier" }),
+		metricKey: field.string({ description: "Metric to monitor" }),
+		metricId: field.string({
+			isOptional: true,
+			description: "Metric ID (for FK)"
+		}),
+		subjectType: field.string({
+			isOptional: true,
+			description: "Subject type"
+		}),
+		subjectId: field.string({
+			isOptional: true,
+			description: "Subject identifier"
+		}),
+		name: field.string({ description: "Threshold name" }),
+		threshold: field.decimal({ description: "Threshold value" }),
+		warnThreshold: field.decimal({
+			isOptional: true,
+			description: "Warning threshold (e.g., 80%)"
+		}),
+		periodType: field.enum("PeriodType", {
+			default: "MONTHLY",
+			description: "Period to evaluate"
+		}),
+		action: field.enum("ThresholdAction", {
+			default: "ALERT",
+			description: "Action when exceeded"
+		}),
+		notifyEmails: field.json({
+			isOptional: true,
+			description: "Email addresses to notify"
+		}),
+		notifyWebhook: field.string({
+			isOptional: true,
+			description: "Webhook URL to call"
+		}),
+		currentValue: field.decimal({
+			default: 0,
+			description: "Current usage value"
+		}),
+		lastCheckedAt: field.dateTime({
+			isOptional: true,
+			description: "Last threshold check"
+		}),
+		lastExceededAt: field.dateTime({
+			isOptional: true,
+			description: "Last time threshold was exceeded"
+		}),
+		isActive: field.boolean({
+			default: true,
+			description: "Whether threshold is active"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	},
+	indexes: [
+		index.on(["metricKey"]),
+		index.on(["subjectType", "subjectId"]),
+		index.on(["isActive", "metricKey"])
+	],
+	enums: [ThresholdActionEnum]
+});
+/**
+* UsageAlert entity - threshold violation alerts.
+*/
+const UsageAlertEntity = defineEntity({
+	name: "UsageAlert",
+	description: "Alert generated when threshold is exceeded.",
+	schema: "lssm_metering",
+	map: "usage_alert",
+	fields: {
+		id: field.id({ description: "Unique identifier" }),
+		thresholdId: field.foreignKey({ description: "Threshold that triggered alert" }),
+		metricKey: field.string({ description: "Metric key" }),
+		subjectType: field.string({
+			isOptional: true,
+			description: "Subject type"
+		}),
+		subjectId: field.string({
+			isOptional: true,
+			description: "Subject identifier"
+		}),
+		alertType: field.string({ description: "Alert type (warn, exceed, etc.)" }),
+		threshold: field.decimal({ description: "Threshold value" }),
+		actualValue: field.decimal({ description: "Actual usage value" }),
+		percentageUsed: field.decimal({ description: "Percentage of threshold used" }),
+		status: field.string({
+			default: "\"pending\"",
+			description: "Alert status (pending, acknowledged, resolved)"
+		}),
+		acknowledgedBy: field.string({
+			isOptional: true,
+			description: "User who acknowledged"
+		}),
+		acknowledgedAt: field.dateTime({
+			isOptional: true,
+			description: "When acknowledged"
+		}),
+		resolvedAt: field.dateTime({
+			isOptional: true,
+			description: "When resolved"
+		}),
+		notificationsSent: field.json({
+			isOptional: true,
+			description: "Notifications sent"
+		}),
+		triggeredAt: field.dateTime({ description: "When alert was triggered" }),
+		createdAt: field.createdAt(),
+		thresholdRelation: field.belongsTo("UsageThreshold", ["thresholdId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.on(["thresholdId", "status"]),
+		index.on(["metricKey", "triggeredAt"]),
+		index.on(["status", "triggeredAt"])
+	]
+});
+/**
+* All metering entities for schema composition.
+*/
+const meteringEntities = [
+	MetricDefinitionEntity,
+	UsageRecordEntity,
+	UsageSummaryEntity,
+	UsageThresholdEntity,
+	UsageAlertEntity
+];
+/**
+* Module schema contribution for metering.
+*/
+const meteringSchemaContribution = {
+	moduleId: "@contractspec/lib.metering",
+	entities: meteringEntities,
+	enums: [
+		AggregationTypeEnum,
+		ResetPeriodEnum,
+		PeriodTypeEnum,
+		ThresholdActionEnum
+	]
+};
+
+//#endregion
+export { AggregationTypeEnum, MetricDefinitionEntity, PeriodTypeEnum, ResetPeriodEnum, ThresholdActionEnum, UsageAlertEntity, UsageRecordEntity, UsageSummaryEntity, UsageThresholdEntity, meteringEntities, meteringSchemaContribution };
+//# sourceMappingURL=index.js.map

package/dist/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["meteringSchemaContribution: ModuleSchemaContribution"],"sources":["../../src/entities/index.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\nimport type { ModuleSchemaContribution } from '@contractspec/lib.schema';\n\n/**\n * Aggregation type enum.\n */\nexport const AggregationTypeEnum = defineEntityEnum({\n  name: 'AggregationType',\n  values: ['COUNT', 'SUM', 'AVG', 'MAX', 'MIN', 'LAST'] as const,\n  schema: 'lssm_metering',\n  description: 'How to aggregate metric values.',\n});\n\n/**\n * Reset period enum.\n */\nexport const ResetPeriodEnum = defineEntityEnum({\n  name: 'ResetPeriod',\n  values: ['NEVER', 'HOURLY', 'DAILY', 'WEEKLY', 'MONTHLY', 'YEARLY'] as const,\n  schema: 'lssm_metering',\n  description: 'When to reset metric counters.',\n});\n\n/**\n * Period type enum.\n */\nexport const PeriodTypeEnum = defineEntityEnum({\n  name: 'PeriodType',\n  values: ['HOURLY', 'DAILY', 'WEEKLY', 'MONTHLY', 'YEARLY'] as const,\n  schema: 'lssm_metering',\n  description: 'Time period for aggregation.',\n});\n\n/**\n * Threshold action enum.\n */\nexport const ThresholdActionEnum = defineEntityEnum({\n  name: 'ThresholdAction',\n  values: ['NONE', 'ALERT', 'WARN', 'BLOCK', 'DOWNGRADE'] as const,\n  schema: 'lssm_metering',\n  description: 'Action to take when threshold is exceeded.',\n});\n\n/**\n * MetricDefinition entity - defines a trackable metric.\n */\nexport const MetricDefinitionEntity = defineEntity({\n  name: 'MetricDefinition',\n  description: 'Definition of a usage metric.',\n  schema: 'lssm_metering',\n  map: 'metric_definition',\n  fields: {\n    id: field.id({ description: 'Unique identifier' }),\n    key: field.string({\n      isUnique: true,\n      description: 'Metric key (e.g., api_calls, storage_gb)',\n    }),\n    name: field.string({ description: 'Human-readable name' }),\n    description: field.string({\n      isOptional: true,\n      description: 'Metric description',\n    }),\n\n    // Configuration\n    unit: field.string({\n      description: 'Unit of measurement (calls, bytes, etc.)',\n    }),\n    aggregationType: field.enum('AggregationType', {\n      default: 'SUM',\n      description: 'How to aggregate values',\n    }),\n    resetPeriod: field.enum('ResetPeriod', {\n      default: 'MONTHLY',\n      description: 'When to reset counters',\n    }),\n\n    // Precision\n    precision: field.int({ default: 2, description: 'Decimal precision' }),\n\n    // Scope\n    orgId: field.string({\n      isOptional: true,\n      description: 'Organization scope (null = global metric)',\n    }),\n\n    // Display\n    category: field.string({\n      isOptional: true,\n      description: 'Category for grouping',\n    }),\n    displayOrder: field.int({ default: 0, description: 'Order for display' }),\n\n    // Metadata\n    metadata: field.json({\n      isOptional: true,\n      description: 'Additional metadata',\n    }),\n\n    // Status\n    isActive: field.boolean({\n      default: true,\n      description: 'Whether metric is active',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    usageRecords: field.hasMany('UsageRecord'),\n    usageSummaries: field.hasMany('UsageSummary'),\n    thresholds: field.hasMany('UsageThreshold'),\n  },\n  indexes: [\n    index.on(['orgId', 'key']),\n    index.on(['category']),\n    index.on(['isActive']),\n  ],\n  enums: [AggregationTypeEnum, ResetPeriodEnum],\n});\n\n/**\n * UsageRecord entity - individual usage event.\n */\nexport const UsageRecordEntity = defineEntity({\n  name: 'UsageRecord',\n  description: 'A single usage event.',\n  schema: 'lssm_metering',\n  map: 'usage_record',\n  fields: {\n    id: field.id({ description: 'Unique identifier' }),\n\n    // Metric reference\n    metricKey: field.string({ description: 'Metric being recorded' }),\n    metricId: field.string({\n      isOptional: true,\n      description: 'Metric ID (for FK)',\n    }),\n\n    // Subject\n    subjectType: field.string({\n      description: 'Subject type (org, user, project)',\n    }),\n    subjectId: field.string({ description: 'Subject identifier' }),\n\n    // Usage value\n    quantity: field.decimal({ description: 'Usage quantity' }),\n\n    // Context\n    source: field.string({\n      isOptional: true,\n      description: 'Source of usage (endpoint, feature, etc.)',\n    }),\n    resourceId: field.string({\n      isOptional: true,\n      description: 'Related resource ID',\n    }),\n    resourceType: field.string({\n      isOptional: true,\n      description: 'Related resource type',\n    }),\n\n    // Metadata\n    metadata: field.json({\n      isOptional: true,\n      description: 'Additional context',\n    }),\n\n    // Idempotency\n    idempotencyKey: field.string({\n      isOptional: true,\n      description: 'Idempotency key for deduplication',\n    }),\n\n    // Timestamps\n    timestamp: field.dateTime({ description: 'When usage occurred' }),\n    createdAt: field.createdAt(),\n\n    // Aggregation status\n    aggregated: field.boolean({\n      default: false,\n      description: 'Whether included in summary',\n    }),\n    aggregatedAt: field.dateTime({\n      isOptional: true,\n      description: 'When aggregated',\n    }),\n  },\n  indexes: [\n    index.on(['metricKey', 'subjectType', 'subjectId', 'timestamp']),\n    index.on(['subjectType', 'subjectId', 'timestamp']),\n    index.on(['timestamp']),\n    index.on(['aggregated', 'timestamp']),\n    index.unique(['idempotencyKey'], { name: 'usage_record_idempotency' }),\n  ],\n});\n\n/**\n * UsageSummary entity - pre-aggregated usage.\n */\nexport const UsageSummaryEntity = defineEntity({\n  name: 'UsageSummary',\n  description: 'Pre-aggregated usage summary.',\n  schema: 'lssm_metering',\n  map: 'usage_summary',\n  fields: {\n    id: field.id({ description: 'Unique identifier' }),\n\n    // Metric reference\n    metricKey: field.string({ description: 'Metric key' }),\n    metricId: field.string({\n      isOptional: true,\n      description: 'Metric ID (for FK)',\n    }),\n\n    // Subject\n    subjectType: field.string({ description: 'Subject type' }),\n    subjectId: field.string({ description: 'Subject identifier' }),\n\n    // Period\n    periodType: field.enum('PeriodType', { description: 'Period type' }),\n    periodStart: field.dateTime({ description: 'Period start time' }),\n    periodEnd: field.dateTime({ description: 'Period end time' }),\n\n    // Aggregated values\n    totalQuantity: field.decimal({ description: 'Total/aggregated quantity' }),\n    recordCount: field.int({\n      default: 0,\n      description: 'Number of records aggregated',\n    }),\n\n    // Statistics (for AVG, MIN, MAX)\n    minQuantity: field.decimal({\n      isOptional: true,\n      description: 'Minimum value',\n    }),\n    maxQuantity: field.decimal({\n      isOptional: true,\n      description: 'Maximum value',\n    }),\n    avgQuantity: field.decimal({\n      isOptional: true,\n      description: 'Average value',\n    }),\n\n    // Metadata\n    metadata: field.json({\n      isOptional: true,\n      description: 'Additional metadata',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n  },\n  indexes: [\n    index.unique(\n      ['metricKey', 'subjectType', 'subjectId', 'periodType', 'periodStart'],\n      { name: 'usage_summary_unique' }\n    ),\n    index.on(['subjectType', 'subjectId', 'periodType', 'periodStart']),\n    index.on(['metricKey', 'periodType', 'periodStart']),\n  ],\n  enums: [PeriodTypeEnum],\n});\n\n/**\n * UsageThreshold entity - threshold configuration.\n */\nexport const UsageThresholdEntity = defineEntity({\n  name: 'UsageThreshold',\n  description: 'Usage threshold configuration.',\n  schema: 'lssm_metering',\n  map: 'usage_threshold',\n  fields: {\n    id: field.id({ description: 'Unique identifier' }),\n\n    // Metric reference\n    metricKey: field.string({ description: 'Metric to monitor' }),\n    metricId: field.string({\n      isOptional: true,\n      description: 'Metric ID (for FK)',\n    }),\n\n    // Subject (optional - can be global)\n    subjectType: field.string({\n      isOptional: true,\n      description: 'Subject type',\n    }),\n    subjectId: field.string({\n      isOptional: true,\n      description: 'Subject identifier',\n    }),\n\n    // Threshold configuration\n    name: field.string({ description: 'Threshold name' }),\n    threshold: field.decimal({ description: 'Threshold value' }),\n    warnThreshold: field.decimal({\n      isOptional: true,\n      description: 'Warning threshold (e.g., 80%)',\n    }),\n\n    // Period\n    periodType: field.enum('PeriodType', {\n      default: 'MONTHLY',\n      description: 'Period to evaluate',\n    }),\n\n    // Actions\n    action: field.enum('ThresholdAction', {\n      default: 'ALERT',\n      description: 'Action when exceeded',\n    }),\n    notifyEmails: field.json({\n      isOptional: true,\n      description: 'Email addresses to notify',\n    }),\n    notifyWebhook: field.string({\n      isOptional: true,\n      description: 'Webhook URL to call',\n    }),\n\n    // Status tracking\n    currentValue: field.decimal({\n      default: 0,\n      description: 'Current usage value',\n    }),\n    lastCheckedAt: field.dateTime({\n      isOptional: true,\n      description: 'Last threshold check',\n    }),\n    lastExceededAt: field.dateTime({\n      isOptional: true,\n      description: 'Last time threshold was exceeded',\n    }),\n\n    // Status\n    isActive: field.boolean({\n      default: true,\n      description: 'Whether threshold is active',\n    }),\n\n    // Metadata\n    metadata: field.json({\n      isOptional: true,\n      description: 'Additional metadata',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n  },\n  indexes: [\n    index.on(['metricKey']),\n    index.on(['subjectType', 'subjectId']),\n    index.on(['isActive', 'metricKey']),\n  ],\n  enums: [ThresholdActionEnum],\n});\n\n/**\n * UsageAlert entity - threshold violation alerts.\n */\nexport const UsageAlertEntity = defineEntity({\n  name: 'UsageAlert',\n  description: 'Alert generated when threshold is exceeded.',\n  schema: 'lssm_metering',\n  map: 'usage_alert',\n  fields: {\n    id: field.id({ description: 'Unique identifier' }),\n\n    // Threshold reference\n    thresholdId: field.foreignKey({\n      description: 'Threshold that triggered alert',\n    }),\n\n    // Context\n    metricKey: field.string({ description: 'Metric key' }),\n    subjectType: field.string({\n      isOptional: true,\n      description: 'Subject type',\n    }),\n    subjectId: field.string({\n      isOptional: true,\n      description: 'Subject identifier',\n    }),\n\n    // Alert details\n    alertType: field.string({ description: 'Alert type (warn, exceed, etc.)' }),\n    threshold: field.decimal({ description: 'Threshold value' }),\n    actualValue: field.decimal({ description: 'Actual usage value' }),\n    percentageUsed: field.decimal({\n      description: 'Percentage of threshold used',\n    }),\n\n    // Status\n    status: field.string({\n      default: '\"pending\"',\n      description: 'Alert status (pending, acknowledged, resolved)',\n    }),\n    acknowledgedBy: field.string({\n      isOptional: true,\n      description: 'User who acknowledged',\n    }),\n    acknowledgedAt: field.dateTime({\n      isOptional: true,\n      description: 'When acknowledged',\n    }),\n    resolvedAt: field.dateTime({\n      isOptional: true,\n      description: 'When resolved',\n    }),\n\n    // Notifications\n    notificationsSent: field.json({\n      isOptional: true,\n      description: 'Notifications sent',\n    }),\n\n    // Timestamps\n    triggeredAt: field.dateTime({ description: 'When alert was triggered' }),\n    createdAt: field.createdAt(),\n\n    // Relations\n    thresholdRelation: field.belongsTo(\n      'UsageThreshold',\n      ['thresholdId'],\n      ['id'],\n      { onDelete: 'Cascade' }\n    ),\n  },\n  indexes: [\n    index.on(['thresholdId', 'status']),\n    index.on(['metricKey', 'triggeredAt']),\n    index.on(['status', 'triggeredAt']),\n  ],\n});\n\n/**\n * All metering entities for schema composition.\n */\nexport const meteringEntities = [\n  MetricDefinitionEntity,\n  UsageRecordEntity,\n  UsageSummaryEntity,\n  UsageThresholdEntity,\n  UsageAlertEntity,\n];\n\n/**\n * Module schema contribution for metering.\n */\nexport const meteringSchemaContribution: ModuleSchemaContribution = {\n  moduleId: '@contractspec/lib.metering',\n  entities: meteringEntities,\n  enums: [\n    AggregationTypeEnum,\n    ResetPeriodEnum,\n    PeriodTypeEnum,\n    ThresholdActionEnum,\n  ],\n};\n"],"mappings":"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"}