@lssm/lib.metering 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/contracts/index.js

@@ -1 +1,1034 @@
-import{l as e}from"../schema/dist/ScalarTypeEnum.js";import{n as t}from"../schema/dist/SchemaModel.js";import"../schema/dist/index.js";import{n,t as r}from"./dist/spec.js";import"./dist/index.js";const i=[`platform.metering`],a=t({name:`MetricDefinition`,description:`Represents a metric definition`,fields:{id:{type:e.String_unsecure(),isOptional:!1},key:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},unit:{type:e.String_unsecure(),isOptional:!1},aggregationType:{type:e.String_unsecure(),isOptional:!1},resetPeriod:{type:e.String_unsecure(),isOptional:!1},category:{type:e.String_unsecure(),isOptional:!0},isActive:{type:e.Boolean(),isOptional:!1},orgId:{type:e.String_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`UsageRecord`,description:`Represents a usage record`,fields:{id:{type:e.String_unsecure(),isOptional:!1},metricKey:{type:e.String_unsecure(),isOptional:!1},subjectType:{type:e.String_unsecure(),isOptional:!1},subjectId:{type:e.String_unsecure(),isOptional:!1},quantity:{type:e.Float_unsecure(),isOptional:!1},source:{type:e.String_unsecure(),isOptional:!0},resourceId:{type:e.String_unsecure(),isOptional:!0},resourceType:{type:e.String_unsecure(),isOptional:!0},metadata:{type:e.JSON(),isOptional:!0},timestamp:{type:e.DateTime(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),s=t({name:`UsageSummary`,description:`Represents aggregated usage`,fields:{id:{type:e.String_unsecure(),isOptional:!1},metricKey:{type:e.String_unsecure(),isOptional:!1},subjectType:{type:e.String_unsecure(),isOptional:!1},subjectId:{type:e.String_unsecure(),isOptional:!1},periodType:{type:e.String_unsecure(),isOptional:!1},periodStart:{type:e.DateTime(),isOptional:!1},periodEnd:{type:e.DateTime(),isOptional:!1},totalQuantity:{type:e.Float_unsecure(),isOptional:!1},recordCount:{type:e.Int_unsecure(),isOptional:!1},minQuantity:{type:e.Float_unsecure(),isOptional:!0},maxQuantity:{type:e.Float_unsecure(),isOptional:!0},avgQuantity:{type:e.Float_unsecure(),isOptional:!0}}}),c=t({name:`UsageThreshold`,description:`Represents a usage threshold`,fields:{id:{type:e.String_unsecure(),isOptional:!1},metricKey:{type:e.String_unsecure(),isOptional:!1},subjectType:{type:e.String_unsecure(),isOptional:!0},subjectId:{type:e.String_unsecure(),isOptional:!0},name:{type:e.String_unsecure(),isOptional:!1},threshold:{type:e.Float_unsecure(),isOptional:!1},warnThreshold:{type:e.Float_unsecure(),isOptional:!0},periodType:{type:e.String_unsecure(),isOptional:!1},action:{type:e.String_unsecure(),isOptional:!1},currentValue:{type:e.Float_unsecure(),isOptional:!1},isActive:{type:e.Boolean(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),l=t({name:`DefineMetricInput`,description:`Input for defining a metric`,fields:{key:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},description:{type:e.String_unsecure(),isOptional:!0},unit:{type:e.String_unsecure(),isOptional:!1},aggregationType:{type:e.String_unsecure(),isOptional:!0},resetPeriod:{type:e.String_unsecure(),isOptional:!0},category:{type:e.String_unsecure(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!0},metadata:{type:e.JSON(),isOptional:!0}}}),u=t({name:`UpdateMetricInput`,description:`Input for updating a metric`,fields:{metricId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!0},description:{type:e.String_unsecure(),isOptional:!0},category:{type:e.String_unsecure(),isOptional:!0},isActive:{type:e.Boolean(),isOptional:!0},metadata:{type:e.JSON(),isOptional:!0}}}),d=t({name:`DeleteMetricInput`,description:`Input for deleting a metric`,fields:{metricId:{type:e.String_unsecure(),isOptional:!1}}}),f=t({name:`GetMetricInput`,description:`Input for getting a metric`,fields:{key:{type:e.String_unsecure(),isOptional:!1},orgId:{type:e.String_unsecure(),isOptional:!0}}}),p=t({name:`ListMetricsInput`,description:`Input for listing metrics`,fields:{orgId:{type:e.String_unsecure(),isOptional:!0},category:{type:e.String_unsecure(),isOptional:!0},isActive:{type:e.Boolean(),isOptional:!0},limit:{type:e.Int_unsecure(),isOptional:!0},offset:{type:e.Int_unsecure(),isOptional:!0}}}),m=t({name:`ListMetricsOutput`,description:`Output for listing metrics`,fields:{metrics:{type:a,isArray:!0,isOptional:!1},total:{type:e.Int_unsecure(),isOptional:!1}}}),h=t({name:`RecordUsageInput`,description:`Input for recording usage`,fields:{metricKey:{type:e.String_unsecure(),isOptional:!1},subjectType:{type:e.String_unsecure(),isOptional:!1},subjectId:{type:e.String_unsecure(),isOptional:!1},quantity:{type:e.Float_unsecure(),isOptional:!1},timestamp:{type:e.DateTime(),isOptional:!0},source:{type:e.String_unsecure(),isOptional:!0},resourceId:{type:e.String_unsecure(),isOptional:!0},resourceType:{type:e.String_unsecure(),isOptional:!0},metadata:{type:e.JSON(),isOptional:!0},idempotencyKey:{type:e.String_unsecure(),isOptional:!0}}}),g=t({name:`RecordBatchUsageInput`,description:`Input for recording batch usage`,fields:{records:{type:h,isArray:!0,isOptional:!1}}}),_=t({name:`RecordBatchUsageOutput`,description:`Output for recording batch usage`,fields:{recordedCount:{type:e.Int_unsecure(),isOptional:!1},skippedCount:{type:e.Int_unsecure(),isOptional:!1},recordIds:{type:e.JSON(),isOptional:!1}}}),v=t({name:`GetUsageInput`,description:`Input for getting usage`,fields:{metricKey:{type:e.String_unsecure(),isOptional:!1},subjectType:{type:e.String_unsecure(),isOptional:!1},subjectId:{type:e.String_unsecure(),isOptional:!1},startDate:{type:e.DateTime(),isOptional:!1},endDate:{type:e.DateTime(),isOptional:!1},limit:{type:e.Int_unsecure(),isOptional:!0},offset:{type:e.Int_unsecure(),isOptional:!0}}}),y=t({name:`GetUsageOutput`,description:`Output for getting usage`,fields:{records:{type:o,isArray:!0,isOptional:!1},total:{type:e.Int_unsecure(),isOptional:!1},totalQuantity:{type:e.Float_unsecure(),isOptional:!1}}}),b=t({name:`GetUsageSummaryInput`,description:`Input for getting usage summary`,fields:{metricKey:{type:e.String_unsecure(),isOptional:!1},subjectType:{type:e.String_unsecure(),isOptional:!1},subjectId:{type:e.String_unsecure(),isOptional:!1},periodType:{type:e.String_unsecure(),isOptional:!1},startDate:{type:e.DateTime(),isOptional:!1},endDate:{type:e.DateTime(),isOptional:!0}}}),x=t({name:`GetUsageSummaryOutput`,description:`Output for getting usage summary`,fields:{summaries:{type:s,isArray:!0,isOptional:!1},total:{type:e.Int_unsecure(),isOptional:!1}}}),S=t({name:`CreateThresholdInput`,description:`Input for creating a threshold`,fields:{metricKey:{type:e.String_unsecure(),isOptional:!1},subjectType:{type:e.String_unsecure(),isOptional:!0},subjectId:{type:e.String_unsecure(),isOptional:!0},name:{type:e.String_unsecure(),isOptional:!1},threshold:{type:e.Float_unsecure(),isOptional:!1},warnThreshold:{type:e.Float_unsecure(),isOptional:!0},periodType:{type:e.String_unsecure(),isOptional:!0},action:{type:e.String_unsecure(),isOptional:!0},notifyEmails:{type:e.JSON(),isOptional:!0},notifyWebhook:{type:e.String_unsecure(),isOptional:!0}}}),C=t({name:`UpdateThresholdInput`,description:`Input for updating a threshold`,fields:{thresholdId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!0},threshold:{type:e.Float_unsecure(),isOptional:!0},warnThreshold:{type:e.Float_unsecure(),isOptional:!0},action:{type:e.String_unsecure(),isOptional:!0},notifyEmails:{type:e.JSON(),isOptional:!0},notifyWebhook:{type:e.String_unsecure(),isOptional:!0},isActive:{type:e.Boolean(),isOptional:!0}}}),w=t({name:`DeleteThresholdInput`,description:`Input for deleting a threshold`,fields:{thresholdId:{type:e.String_unsecure(),isOptional:!1}}}),T=t({name:`ListThresholdsInput`,description:`Input for listing thresholds`,fields:{metricKey:{type:e.String_unsecure(),isOptional:!0},subjectType:{type:e.String_unsecure(),isOptional:!0},subjectId:{type:e.String_unsecure(),isOptional:!0},isActive:{type:e.Boolean(),isOptional:!0}}}),E=t({name:`ListThresholdsOutput`,description:`Output for listing thresholds`,fields:{thresholds:{type:c,isArray:!0,isOptional:!1},total:{type:e.Int_unsecure(),isOptional:!1}}}),D=t({name:`SuccessOutput`,description:`Generic success output`,fields:{success:{type:e.Boolean(),isOptional:!1}}}),O=r({meta:{name:`metric.define`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`metric`,`define`],description:`Define a new usage metric.`,goal:`Create a new metric for tracking usage.`,context:`Called when setting up metering.`},io:{input:l,output:a,errors:{METRIC_KEY_EXISTS:{description:`Metric key already exists`,http:409,gqlCode:`METRIC_KEY_EXISTS`,when:`A metric with this key already exists`}}},policy:{auth:`admin`}}),k=r({meta:{name:`metric.update`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`metric`,`update`],description:`Update a metric definition.`,goal:`Modify metric configuration.`,context:`Called when updating metric settings.`},io:{input:u,output:a,errors:{METRIC_NOT_FOUND:{description:`Metric does not exist`,http:404,gqlCode:`METRIC_NOT_FOUND`,when:`Metric ID is invalid`}}},policy:{auth:`admin`}}),A=r({meta:{name:`metric.delete`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`metric`,`delete`],description:`Delete a metric definition.`,goal:`Remove a metric and its data.`,context:`Called when removing a metric.`},io:{input:d,output:D,errors:{METRIC_NOT_FOUND:{description:`Metric does not exist`,http:404,gqlCode:`METRIC_NOT_FOUND`,when:`Metric ID is invalid`}}},policy:{auth:`admin`}}),j=n({meta:{name:`metric.get`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`metric`,`get`],description:`Get a metric by key.`,goal:`Retrieve metric definition.`,context:`Called to inspect metric details.`},io:{input:f,output:a,errors:{METRIC_NOT_FOUND:{description:`Metric does not exist`,http:404,gqlCode:`METRIC_NOT_FOUND`,when:`Metric key is invalid`}}},policy:{auth:`user`}}),M=n({meta:{name:`metric.list`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`metric`,`list`],description:`List all metrics.`,goal:`View configured metrics.`,context:`Called to browse metrics.`},io:{input:p,output:m},policy:{auth:`user`}}),N=r({meta:{name:`usage.record`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`usage`,`record`],description:`Record a usage event.`,goal:`Track usage for billing and monitoring.`,context:`Called when usage occurs.`},io:{input:h,output:o,errors:{METRIC_NOT_FOUND:{description:`Metric does not exist`,http:404,gqlCode:`METRIC_NOT_FOUND`,when:`Metric key is invalid`},DUPLICATE_RECORD:{description:`Record already exists`,http:409,gqlCode:`DUPLICATE_RECORD`,when:`Idempotency key already used`}}},policy:{auth:`admin`}}),P=r({meta:{name:`usage.recordBatch`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`usage`,`batch`],description:`Record multiple usage events.`,goal:`Efficiently track bulk usage.`,context:`Called for batch processing.`},io:{input:g,output:_},policy:{auth:`admin`}}),F=n({meta:{name:`usage.get`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`usage`,`get`],description:`Get usage records for a subject.`,goal:`View detailed usage history.`,context:`Called to analyze usage.`},io:{input:v,output:y},policy:{auth:`user`}}),I=n({meta:{name:`usage.getSummary`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`usage`,`summary`],description:`Get aggregated usage summary.`,goal:`View usage totals for billing.`,context:`Called for billing and reporting.`},io:{input:b,output:x},policy:{auth:`user`}}),L=r({meta:{name:`threshold.create`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`threshold`,`create`],description:`Create a usage threshold.`,goal:`Set up usage limits and alerts.`,context:`Called when configuring limits.`},io:{input:S,output:c,errors:{METRIC_NOT_FOUND:{description:`Metric does not exist`,http:404,gqlCode:`METRIC_NOT_FOUND`,when:`Metric key is invalid`}}},policy:{auth:`admin`}}),R=r({meta:{name:`threshold.update`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`threshold`,`update`],description:`Update a threshold.`,goal:`Modify threshold configuration.`,context:`Called when adjusting limits.`},io:{input:C,output:c,errors:{THRESHOLD_NOT_FOUND:{description:`Threshold does not exist`,http:404,gqlCode:`THRESHOLD_NOT_FOUND`,when:`Threshold ID is invalid`}}},policy:{auth:`admin`}}),z=r({meta:{name:`threshold.delete`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`threshold`,`delete`],description:`Delete a threshold.`,goal:`Remove a usage threshold.`,context:`Called when removing limits.`},io:{input:w,output:D,errors:{THRESHOLD_NOT_FOUND:{description:`Threshold does not exist`,http:404,gqlCode:`THRESHOLD_NOT_FOUND`,when:`Threshold ID is invalid`}}},policy:{auth:`admin`}}),B=n({meta:{name:`threshold.list`,version:1,stability:`stable`,owners:[...i],tags:[`metering`,`threshold`,`list`],description:`List usage thresholds.`,goal:`View configured limits.`,context:`Called to browse thresholds.`},io:{input:T,output:E},policy:{auth:`user`}});export{L as CreateThresholdContract,O as DefineMetricContract,A as DeleteMetricContract,z as DeleteThresholdContract,j as GetMetricContract,F as GetUsageContract,I as GetUsageSummaryContract,M as ListMetricsContract,B as ListThresholdsContract,a as MetricDefinitionModel,P as RecordBatchUsageContract,N as RecordUsageContract,k as UpdateMetricContract,R as UpdateThresholdContract,o as UsageRecordModel,s as UsageSummaryModel,c as UsageThresholdModel};
+import { ScalarTypeEnum } from "../schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "../schema/dist/SchemaModel.js";
+import "../schema/dist/index.js";
+import { defineCommand, defineQuery } from "./dist/spec.js";
+import "./dist/index.js";
+
+//#region src/contracts/index.ts
+const OWNERS = ["platform.metering"];
+const MetricDefinitionModel = defineSchemaModel({
+	name: "MetricDefinition",
+	description: "Represents a metric definition",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		unit: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		aggregationType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		resetPeriod: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		isActive: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const UsageRecordModel = defineSchemaModel({
+	name: "UsageRecord",
+	description: "Represents a usage record",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		metricKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		quantity: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		source: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		resourceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		resourceType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const UsageSummaryModel = defineSchemaModel({
+	name: "UsageSummary",
+	description: "Represents aggregated usage",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		metricKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		periodType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		periodStart: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		periodEnd: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		totalQuantity: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		recordCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		minQuantity: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		maxQuantity: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		avgQuantity: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const UsageThresholdModel = defineSchemaModel({
+	name: "UsageThreshold",
+	description: "Represents a usage threshold",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		metricKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		threshold: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		warnThreshold: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		periodType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		action: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		currentValue: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		isActive: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const DefineMetricInput = defineSchemaModel({
+	name: "DefineMetricInput",
+	description: "Input for defining a metric",
+	fields: {
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		unit: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		aggregationType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		resetPeriod: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		}
+	}
+});
+const UpdateMetricInput = defineSchemaModel({
+	name: "UpdateMetricInput",
+	description: "Input for updating a metric",
+	fields: {
+		metricId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		description: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		isActive: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		}
+	}
+});
+const DeleteMetricInput = defineSchemaModel({
+	name: "DeleteMetricInput",
+	description: "Input for deleting a metric",
+	fields: { metricId: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+const GetMetricInput = defineSchemaModel({
+	name: "GetMetricInput",
+	description: "Input for getting a metric",
+	fields: {
+		key: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const ListMetricsInput = defineSchemaModel({
+	name: "ListMetricsInput",
+	description: "Input for listing metrics",
+	fields: {
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		category: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		isActive: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		},
+		limit: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		offset: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const ListMetricsOutput = defineSchemaModel({
+	name: "ListMetricsOutput",
+	description: "Output for listing metrics",
+	fields: {
+		metrics: {
+			type: MetricDefinitionModel,
+			isArray: true,
+			isOptional: false
+		},
+		total: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const RecordUsageInput = defineSchemaModel({
+	name: "RecordUsageInput",
+	description: "Input for recording usage",
+	fields: {
+		metricKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		quantity: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		source: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		resourceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		resourceType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		metadata: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		idempotencyKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const RecordBatchUsageInput = defineSchemaModel({
+	name: "RecordBatchUsageInput",
+	description: "Input for recording batch usage",
+	fields: { records: {
+		type: RecordUsageInput,
+		isArray: true,
+		isOptional: false
+	} }
+});
+const RecordBatchUsageOutput = defineSchemaModel({
+	name: "RecordBatchUsageOutput",
+	description: "Output for recording batch usage",
+	fields: {
+		recordedCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		skippedCount: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		recordIds: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: false
+		}
+	}
+});
+const GetUsageInput = defineSchemaModel({
+	name: "GetUsageInput",
+	description: "Input for getting usage",
+	fields: {
+		metricKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		startDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		endDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		limit: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		offset: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const GetUsageOutput = defineSchemaModel({
+	name: "GetUsageOutput",
+	description: "Output for getting usage",
+	fields: {
+		records: {
+			type: UsageRecordModel,
+			isArray: true,
+			isOptional: false
+		},
+		total: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		totalQuantity: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const GetUsageSummaryInput = defineSchemaModel({
+	name: "GetUsageSummaryInput",
+	description: "Input for getting usage summary",
+	fields: {
+		metricKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		periodType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		startDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		endDate: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const GetUsageSummaryOutput = defineSchemaModel({
+	name: "GetUsageSummaryOutput",
+	description: "Output for getting usage summary",
+	fields: {
+		summaries: {
+			type: UsageSummaryModel,
+			isArray: true,
+			isOptional: false
+		},
+		total: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const CreateThresholdInput = defineSchemaModel({
+	name: "CreateThresholdInput",
+	description: "Input for creating a threshold",
+	fields: {
+		metricKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		threshold: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: false
+		},
+		warnThreshold: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		periodType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		action: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		notifyEmails: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		notifyWebhook: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const UpdateThresholdInput = defineSchemaModel({
+	name: "UpdateThresholdInput",
+	description: "Input for updating a threshold",
+	fields: {
+		thresholdId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		name: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		threshold: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		warnThreshold: {
+			type: ScalarTypeEnum.Float_unsecure(),
+			isOptional: true
+		},
+		action: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		notifyEmails: {
+			type: ScalarTypeEnum.JSON(),
+			isOptional: true
+		},
+		notifyWebhook: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		isActive: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const DeleteThresholdInput = defineSchemaModel({
+	name: "DeleteThresholdInput",
+	description: "Input for deleting a threshold",
+	fields: { thresholdId: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+const ListThresholdsInput = defineSchemaModel({
+	name: "ListThresholdsInput",
+	description: "Input for listing thresholds",
+	fields: {
+		metricKey: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		subjectType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		subjectId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		isActive: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: true
+		}
+	}
+});
+const ListThresholdsOutput = defineSchemaModel({
+	name: "ListThresholdsOutput",
+	description: "Output for listing thresholds",
+	fields: {
+		thresholds: {
+			type: UsageThresholdModel,
+			isArray: true,
+			isOptional: false
+		},
+		total: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const SuccessOutput = defineSchemaModel({
+	name: "SuccessOutput",
+	description: "Generic success output",
+	fields: { success: {
+		type: ScalarTypeEnum.Boolean(),
+		isOptional: false
+	} }
+});
+/**
+* Define a metric.
+*/
+const DefineMetricContract = defineCommand({
+	meta: {
+		name: "metric.define",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"metric",
+			"define"
+		],
+		description: "Define a new usage metric.",
+		goal: "Create a new metric for tracking usage.",
+		context: "Called when setting up metering."
+	},
+	io: {
+		input: DefineMetricInput,
+		output: MetricDefinitionModel,
+		errors: { METRIC_KEY_EXISTS: {
+			description: "Metric key already exists",
+			http: 409,
+			gqlCode: "METRIC_KEY_EXISTS",
+			when: "A metric with this key already exists"
+		} }
+	},
+	policy: { auth: "admin" }
+});
+/**
+* Update a metric.
+*/
+const UpdateMetricContract = defineCommand({
+	meta: {
+		name: "metric.update",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"metric",
+			"update"
+		],
+		description: "Update a metric definition.",
+		goal: "Modify metric configuration.",
+		context: "Called when updating metric settings."
+	},
+	io: {
+		input: UpdateMetricInput,
+		output: MetricDefinitionModel,
+		errors: { METRIC_NOT_FOUND: {
+			description: "Metric does not exist",
+			http: 404,
+			gqlCode: "METRIC_NOT_FOUND",
+			when: "Metric ID is invalid"
+		} }
+	},
+	policy: { auth: "admin" }
+});
+/**
+* Delete a metric.
+*/
+const DeleteMetricContract = defineCommand({
+	meta: {
+		name: "metric.delete",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"metric",
+			"delete"
+		],
+		description: "Delete a metric definition.",
+		goal: "Remove a metric and its data.",
+		context: "Called when removing a metric."
+	},
+	io: {
+		input: DeleteMetricInput,
+		output: SuccessOutput,
+		errors: { METRIC_NOT_FOUND: {
+			description: "Metric does not exist",
+			http: 404,
+			gqlCode: "METRIC_NOT_FOUND",
+			when: "Metric ID is invalid"
+		} }
+	},
+	policy: { auth: "admin" }
+});
+/**
+* Get a metric by key.
+*/
+const GetMetricContract = defineQuery({
+	meta: {
+		name: "metric.get",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"metric",
+			"get"
+		],
+		description: "Get a metric by key.",
+		goal: "Retrieve metric definition.",
+		context: "Called to inspect metric details."
+	},
+	io: {
+		input: GetMetricInput,
+		output: MetricDefinitionModel,
+		errors: { METRIC_NOT_FOUND: {
+			description: "Metric does not exist",
+			http: 404,
+			gqlCode: "METRIC_NOT_FOUND",
+			when: "Metric key is invalid"
+		} }
+	},
+	policy: { auth: "user" }
+});
+/**
+* List metrics.
+*/
+const ListMetricsContract = defineQuery({
+	meta: {
+		name: "metric.list",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"metric",
+			"list"
+		],
+		description: "List all metrics.",
+		goal: "View configured metrics.",
+		context: "Called to browse metrics."
+	},
+	io: {
+		input: ListMetricsInput,
+		output: ListMetricsOutput
+	},
+	policy: { auth: "user" }
+});
+/**
+* Record usage.
+*/
+const RecordUsageContract = defineCommand({
+	meta: {
+		name: "usage.record",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"usage",
+			"record"
+		],
+		description: "Record a usage event.",
+		goal: "Track usage for billing and monitoring.",
+		context: "Called when usage occurs."
+	},
+	io: {
+		input: RecordUsageInput,
+		output: UsageRecordModel,
+		errors: {
+			METRIC_NOT_FOUND: {
+				description: "Metric does not exist",
+				http: 404,
+				gqlCode: "METRIC_NOT_FOUND",
+				when: "Metric key is invalid"
+			},
+			DUPLICATE_RECORD: {
+				description: "Record already exists",
+				http: 409,
+				gqlCode: "DUPLICATE_RECORD",
+				when: "Idempotency key already used"
+			}
+		}
+	},
+	policy: { auth: "admin" }
+});
+/**
+* Record batch usage.
+*/
+const RecordBatchUsageContract = defineCommand({
+	meta: {
+		name: "usage.recordBatch",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"usage",
+			"batch"
+		],
+		description: "Record multiple usage events.",
+		goal: "Efficiently track bulk usage.",
+		context: "Called for batch processing."
+	},
+	io: {
+		input: RecordBatchUsageInput,
+		output: RecordBatchUsageOutput
+	},
+	policy: { auth: "admin" }
+});
+/**
+* Get usage records.
+*/
+const GetUsageContract = defineQuery({
+	meta: {
+		name: "usage.get",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"usage",
+			"get"
+		],
+		description: "Get usage records for a subject.",
+		goal: "View detailed usage history.",
+		context: "Called to analyze usage."
+	},
+	io: {
+		input: GetUsageInput,
+		output: GetUsageOutput
+	},
+	policy: { auth: "user" }
+});
+/**
+* Get usage summary.
+*/
+const GetUsageSummaryContract = defineQuery({
+	meta: {
+		name: "usage.getSummary",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"usage",
+			"summary"
+		],
+		description: "Get aggregated usage summary.",
+		goal: "View usage totals for billing.",
+		context: "Called for billing and reporting."
+	},
+	io: {
+		input: GetUsageSummaryInput,
+		output: GetUsageSummaryOutput
+	},
+	policy: { auth: "user" }
+});
+/**
+* Create a threshold.
+*/
+const CreateThresholdContract = defineCommand({
+	meta: {
+		name: "threshold.create",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"threshold",
+			"create"
+		],
+		description: "Create a usage threshold.",
+		goal: "Set up usage limits and alerts.",
+		context: "Called when configuring limits."
+	},
+	io: {
+		input: CreateThresholdInput,
+		output: UsageThresholdModel,
+		errors: { METRIC_NOT_FOUND: {
+			description: "Metric does not exist",
+			http: 404,
+			gqlCode: "METRIC_NOT_FOUND",
+			when: "Metric key is invalid"
+		} }
+	},
+	policy: { auth: "admin" }
+});
+/**
+* Update a threshold.
+*/
+const UpdateThresholdContract = defineCommand({
+	meta: {
+		name: "threshold.update",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"threshold",
+			"update"
+		],
+		description: "Update a threshold.",
+		goal: "Modify threshold configuration.",
+		context: "Called when adjusting limits."
+	},
+	io: {
+		input: UpdateThresholdInput,
+		output: UsageThresholdModel,
+		errors: { THRESHOLD_NOT_FOUND: {
+			description: "Threshold does not exist",
+			http: 404,
+			gqlCode: "THRESHOLD_NOT_FOUND",
+			when: "Threshold ID is invalid"
+		} }
+	},
+	policy: { auth: "admin" }
+});
+/**
+* Delete a threshold.
+*/
+const DeleteThresholdContract = defineCommand({
+	meta: {
+		name: "threshold.delete",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"threshold",
+			"delete"
+		],
+		description: "Delete a threshold.",
+		goal: "Remove a usage threshold.",
+		context: "Called when removing limits."
+	},
+	io: {
+		input: DeleteThresholdInput,
+		output: SuccessOutput,
+		errors: { THRESHOLD_NOT_FOUND: {
+			description: "Threshold does not exist",
+			http: 404,
+			gqlCode: "THRESHOLD_NOT_FOUND",
+			when: "Threshold ID is invalid"
+		} }
+	},
+	policy: { auth: "admin" }
+});
+/**
+* List thresholds.
+*/
+const ListThresholdsContract = defineQuery({
+	meta: {
+		name: "threshold.list",
+		version: 1,
+		stability: "stable",
+		owners: [...OWNERS],
+		tags: [
+			"metering",
+			"threshold",
+			"list"
+		],
+		description: "List usage thresholds.",
+		goal: "View configured limits.",
+		context: "Called to browse thresholds."
+	},
+	io: {
+		input: ListThresholdsInput,
+		output: ListThresholdsOutput
+	},
+	policy: { auth: "user" }
+});
+
+//#endregion
+export { CreateThresholdContract, DefineMetricContract, DeleteMetricContract, DeleteThresholdContract, GetMetricContract, GetUsageContract, GetUsageSummaryContract, ListMetricsContract, ListThresholdsContract, MetricDefinitionModel, RecordBatchUsageContract, RecordUsageContract, UpdateMetricContract, UpdateThresholdContract, UsageRecordModel, UsageSummaryModel, UsageThresholdModel };