@lssm/lib.metering 0.0.0-canary-20251217083314 → 0.0.0-canary-20251220002821

package/dist/entities/index.js

@@ -1,11 +1,10 @@
-import { defineEntity, defineEntityEnum, field, index } from "../schema/dist/entity/defineEntity.js";
-import "../schema/dist/index.js";
+import { L5, Z5, _5, b5 } from "../schema/dist/index.js";
 
 //#region src/entities/index.ts
 /**
 * Aggregation type enum.
 */
-const AggregationTypeEnum = defineEntityEnum({
+const AggregationTypeEnum = Z5({
 	name: "AggregationType",
 	values: [
 		"COUNT",
@@ -21,7 +20,7 @@ const AggregationTypeEnum = defineEntityEnum({
 /**
 * Reset period enum.
 */
-const ResetPeriodEnum = defineEntityEnum({
+const ResetPeriodEnum = Z5({
 	name: "ResetPeriod",
 	values: [
 		"NEVER",
@@ -37,7 +36,7 @@ const ResetPeriodEnum = defineEntityEnum({
 /**
 * Period type enum.
 */
-const PeriodTypeEnum = defineEntityEnum({
+const PeriodTypeEnum = Z5({
 	name: "PeriodType",
 	values: [
 		"HOURLY",
@@ -52,7 +51,7 @@ const PeriodTypeEnum = defineEntityEnum({
 /**
 * Threshold action enum.
 */
-const ThresholdActionEnum = defineEntityEnum({
+const ThresholdActionEnum = Z5({
 	name: "ThresholdAction",
 	values: [
 		"NONE",
@@ -67,193 +66,193 @@ const ThresholdActionEnum = defineEntityEnum({
 /**
 * MetricDefinition entity - defines a trackable metric.
 */
-const MetricDefinitionEntity = defineEntity({
+const MetricDefinitionEntity = L5({
 	name: "MetricDefinition",
 	description: "Definition of a usage metric.",
 	schema: "lssm_metering",
 	map: "metric_definition",
 	fields: {
-		id: field.id({ description: "Unique identifier" }),
-		key: field.string({
+		id: _5.id({ description: "Unique identifier" }),
+		key: _5.string({
 			isUnique: true,
 			description: "Metric key (e.g., api_calls, storage_gb)"
 		}),
-		name: field.string({ description: "Human-readable name" }),
-		description: field.string({
+		name: _5.string({ description: "Human-readable name" }),
+		description: _5.string({
 			isOptional: true,
 			description: "Metric description"
 		}),
-		unit: field.string({ description: "Unit of measurement (calls, bytes, etc.)" }),
-		aggregationType: field.enum("AggregationType", {
+		unit: _5.string({ description: "Unit of measurement (calls, bytes, etc.)" }),
+		aggregationType: _5.enum("AggregationType", {
 			default: "SUM",
 			description: "How to aggregate values"
 		}),
-		resetPeriod: field.enum("ResetPeriod", {
+		resetPeriod: _5.enum("ResetPeriod", {
 			default: "MONTHLY",
 			description: "When to reset counters"
 		}),
-		precision: field.int({
+		precision: _5.int({
 			default: 2,
 			description: "Decimal precision"
 		}),
-		orgId: field.string({
+		orgId: _5.string({
 			isOptional: true,
 			description: "Organization scope (null = global metric)"
 		}),
-		category: field.string({
+		category: _5.string({
 			isOptional: true,
 			description: "Category for grouping"
 		}),
-		displayOrder: field.int({
+		displayOrder: _5.int({
 			default: 0,
 			description: "Order for display"
 		}),
-		metadata: field.json({
+		metadata: _5.json({
 			isOptional: true,
 			description: "Additional metadata"
 		}),
-		isActive: field.boolean({
+		isActive: _5.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")
+		createdAt: _5.createdAt(),
+		updatedAt: _5.updatedAt(),
+		usageRecords: _5.hasMany("UsageRecord"),
+		usageSummaries: _5.hasMany("UsageSummary"),
+		thresholds: _5.hasMany("UsageThreshold")
 	},
 	indexes: [
-		index.on(["orgId", "key"]),
-		index.on(["category"]),
-		index.on(["isActive"])
+		b5.on(["orgId", "key"]),
+		b5.on(["category"]),
+		b5.on(["isActive"])
 	],
 	enums: [AggregationTypeEnum, ResetPeriodEnum]
 });
 /**
 * UsageRecord entity - individual usage event.
 */
-const UsageRecordEntity = defineEntity({
+const UsageRecordEntity = L5({
 	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({
+		id: _5.id({ description: "Unique identifier" }),
+		metricKey: _5.string({ description: "Metric being recorded" }),
+		metricId: _5.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({
+		subjectType: _5.string({ description: "Subject type (org, user, project)" }),
+		subjectId: _5.string({ description: "Subject identifier" }),
+		quantity: _5.decimal({ description: "Usage quantity" }),
+		source: _5.string({
 			isOptional: true,
 			description: "Source of usage (endpoint, feature, etc.)"
 		}),
-		resourceId: field.string({
+		resourceId: _5.string({
 			isOptional: true,
 			description: "Related resource ID"
 		}),
-		resourceType: field.string({
+		resourceType: _5.string({
 			isOptional: true,
 			description: "Related resource type"
 		}),
-		metadata: field.json({
+		metadata: _5.json({
 			isOptional: true,
 			description: "Additional context"
 		}),
-		idempotencyKey: field.string({
+		idempotencyKey: _5.string({
 			isOptional: true,
 			description: "Idempotency key for deduplication"
 		}),
-		timestamp: field.dateTime({ description: "When usage occurred" }),
-		createdAt: field.createdAt(),
-		aggregated: field.boolean({
+		timestamp: _5.dateTime({ description: "When usage occurred" }),
+		createdAt: _5.createdAt(),
+		aggregated: _5.boolean({
 			default: false,
 			description: "Whether included in summary"
 		}),
-		aggregatedAt: field.dateTime({
+		aggregatedAt: _5.dateTime({
 			isOptional: true,
 			description: "When aggregated"
 		})
 	},
 	indexes: [
-		index.on([
+		b5.on([
 			"metricKey",
 			"subjectType",
 			"subjectId",
 			"timestamp"
 		]),
-		index.on([
+		b5.on([
 			"subjectType",
 			"subjectId",
 			"timestamp"
 		]),
-		index.on(["timestamp"]),
-		index.on(["aggregated", "timestamp"]),
-		index.unique(["idempotencyKey"], { name: "usage_record_idempotency" })
+		b5.on(["timestamp"]),
+		b5.on(["aggregated", "timestamp"]),
+		b5.unique(["idempotencyKey"], { name: "usage_record_idempotency" })
 	]
 });
 /**
 * UsageSummary entity - pre-aggregated usage.
 */
-const UsageSummaryEntity = defineEntity({
+const UsageSummaryEntity = L5({
 	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({
+		id: _5.id({ description: "Unique identifier" }),
+		metricKey: _5.string({ description: "Metric key" }),
+		metricId: _5.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({
+		subjectType: _5.string({ description: "Subject type" }),
+		subjectId: _5.string({ description: "Subject identifier" }),
+		periodType: _5.enum("PeriodType", { description: "Period type" }),
+		periodStart: _5.dateTime({ description: "Period start time" }),
+		periodEnd: _5.dateTime({ description: "Period end time" }),
+		totalQuantity: _5.decimal({ description: "Total/aggregated quantity" }),
+		recordCount: _5.int({
 			default: 0,
 			description: "Number of records aggregated"
 		}),
-		minQuantity: field.decimal({
+		minQuantity: _5.decimal({
 			isOptional: true,
 			description: "Minimum value"
 		}),
-		maxQuantity: field.decimal({
+		maxQuantity: _5.decimal({
 			isOptional: true,
 			description: "Maximum value"
 		}),
-		avgQuantity: field.decimal({
+		avgQuantity: _5.decimal({
 			isOptional: true,
 			description: "Average value"
 		}),
-		metadata: field.json({
+		metadata: _5.json({
 			isOptional: true,
 			description: "Additional metadata"
 		}),
-		createdAt: field.createdAt(),
-		updatedAt: field.updatedAt()
+		createdAt: _5.createdAt(),
+		updatedAt: _5.updatedAt()
 	},
 	indexes: [
-		index.unique([
+		b5.unique([
 			"metricKey",
 			"subjectType",
 			"subjectId",
 			"periodType",
 			"periodStart"
 		], { name: "usage_summary_unique" }),
-		index.on([
+		b5.on([
 			"subjectType",
 			"subjectId",
 			"periodType",
 			"periodStart"
 		]),
-		index.on([
+		b5.on([
 			"metricKey",
 			"periodType",
 			"periodStart"
@@ -264,130 +263,130 @@ const UsageSummaryEntity = defineEntity({
 /**
 * UsageThreshold entity - threshold configuration.
 */
-const UsageThresholdEntity = defineEntity({
+const UsageThresholdEntity = L5({
 	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({
+		id: _5.id({ description: "Unique identifier" }),
+		metricKey: _5.string({ description: "Metric to monitor" }),
+		metricId: _5.string({
 			isOptional: true,
 			description: "Metric ID (for FK)"
 		}),
-		subjectType: field.string({
+		subjectType: _5.string({
 			isOptional: true,
 			description: "Subject type"
 		}),
-		subjectId: field.string({
+		subjectId: _5.string({
 			isOptional: true,
 			description: "Subject identifier"
 		}),
-		name: field.string({ description: "Threshold name" }),
-		threshold: field.decimal({ description: "Threshold value" }),
-		warnThreshold: field.decimal({
+		name: _5.string({ description: "Threshold name" }),
+		threshold: _5.decimal({ description: "Threshold value" }),
+		warnThreshold: _5.decimal({
 			isOptional: true,
 			description: "Warning threshold (e.g., 80%)"
 		}),
-		periodType: field.enum("PeriodType", {
+		periodType: _5.enum("PeriodType", {
 			default: "MONTHLY",
 			description: "Period to evaluate"
 		}),
-		action: field.enum("ThresholdAction", {
+		action: _5.enum("ThresholdAction", {
 			default: "ALERT",
 			description: "Action when exceeded"
 		}),
-		notifyEmails: field.json({
+		notifyEmails: _5.json({
 			isOptional: true,
 			description: "Email addresses to notify"
 		}),
-		notifyWebhook: field.string({
+		notifyWebhook: _5.string({
 			isOptional: true,
 			description: "Webhook URL to call"
 		}),
-		currentValue: field.decimal({
+		currentValue: _5.decimal({
 			default: 0,
 			description: "Current usage value"
 		}),
-		lastCheckedAt: field.dateTime({
+		lastCheckedAt: _5.dateTime({
 			isOptional: true,
 			description: "Last threshold check"
 		}),
-		lastExceededAt: field.dateTime({
+		lastExceededAt: _5.dateTime({
 			isOptional: true,
 			description: "Last time threshold was exceeded"
 		}),
-		isActive: field.boolean({
+		isActive: _5.boolean({
 			default: true,
 			description: "Whether threshold is active"
 		}),
-		metadata: field.json({
+		metadata: _5.json({
 			isOptional: true,
 			description: "Additional metadata"
 		}),
-		createdAt: field.createdAt(),
-		updatedAt: field.updatedAt()
+		createdAt: _5.createdAt(),
+		updatedAt: _5.updatedAt()
 	},
 	indexes: [
-		index.on(["metricKey"]),
-		index.on(["subjectType", "subjectId"]),
-		index.on(["isActive", "metricKey"])
+		b5.on(["metricKey"]),
+		b5.on(["subjectType", "subjectId"]),
+		b5.on(["isActive", "metricKey"])
 	],
 	enums: [ThresholdActionEnum]
 });
 /**
 * UsageAlert entity - threshold violation alerts.
 */
-const UsageAlertEntity = defineEntity({
+const UsageAlertEntity = L5({
 	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({
+		id: _5.id({ description: "Unique identifier" }),
+		thresholdId: _5.foreignKey({ description: "Threshold that triggered alert" }),
+		metricKey: _5.string({ description: "Metric key" }),
+		subjectType: _5.string({
 			isOptional: true,
 			description: "Subject type"
 		}),
-		subjectId: field.string({
+		subjectId: _5.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({
+		alertType: _5.string({ description: "Alert type (warn, exceed, etc.)" }),
+		threshold: _5.decimal({ description: "Threshold value" }),
+		actualValue: _5.decimal({ description: "Actual usage value" }),
+		percentageUsed: _5.decimal({ description: "Percentage of threshold used" }),
+		status: _5.string({
 			default: "\"pending\"",
 			description: "Alert status (pending, acknowledged, resolved)"
 		}),
-		acknowledgedBy: field.string({
+		acknowledgedBy: _5.string({
 			isOptional: true,
 			description: "User who acknowledged"
 		}),
-		acknowledgedAt: field.dateTime({
+		acknowledgedAt: _5.dateTime({
 			isOptional: true,
 			description: "When acknowledged"
 		}),
-		resolvedAt: field.dateTime({
+		resolvedAt: _5.dateTime({
 			isOptional: true,
 			description: "When resolved"
 		}),
-		notificationsSent: field.json({
+		notificationsSent: _5.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" })
+		triggeredAt: _5.dateTime({ description: "When alert was triggered" }),
+		createdAt: _5.createdAt(),
+		thresholdRelation: _5.belongsTo("UsageThreshold", ["thresholdId"], ["id"], { onDelete: "Cascade" })
 	},
 	indexes: [
-		index.on(["thresholdId", "status"]),
-		index.on(["metricKey", "triggeredAt"]),
-		index.on(["status", "triggeredAt"])
+		b5.on(["thresholdId", "status"]),
+		b5.on(["metricKey", "triggeredAt"]),
+		b5.on(["status", "triggeredAt"])
 	]
 });
 /**
@@ -415,4 +414,5 @@ const meteringSchemaContribution = {
 };
 
 //#endregion
-export { AggregationTypeEnum, MetricDefinitionEntity, PeriodTypeEnum, ResetPeriodEnum, ThresholdActionEnum, UsageAlertEntity, UsageRecordEntity, UsageSummaryEntity, UsageThresholdEntity, meteringEntities, meteringSchemaContribution };
+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":["defineEntityEnum","defineEntity","field","index","meteringSchemaContribution: ModuleSchemaContribution"],"sources":["../../src/entities/index.ts"],"sourcesContent":["import { defineEntity, defineEntityEnum, field, index } from '@lssm/lib.schema';\nimport type { ModuleSchemaContribution } from '@lssm/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: '@lssm/lib.metering',\n  entities: meteringEntities,\n  enums: [\n    AggregationTypeEnum,\n    ResetPeriodEnum,\n    PeriodTypeEnum,\n    ThresholdActionEnum,\n  ],\n};\n"],"mappings":"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"}