@de./types 1.0.0

package/src/lsp/zones.ts

@@ -0,0 +1,148 @@
+import { Type, Static } from '@sinclair/typebox'
+import { ActionRecordSchema, DateTimeZoneSchema } from '../time'
+import { ContextSchema } from '../context'
+import { CoordinatesSchema, GeoBoundarySchema } from '../geo'
+
+/**
+ * Discriminates standard dispatch zones from swarm (pod-anchor) zones.
+ * Swarm zones optionally carry an anchorPodId in their metadata field
+ * which Rally uses for logging and density signals.
+ */
+export const ZoneTypeSchema = Type.Union([
+	Type.Literal('STANDARD'),
+	Type.Literal('SWARM')
+])
+
+export const ZoneStatusSchema = Type.Union([
+	Type.Literal('ACTIVE'),
+	Type.Literal('DORMANT'),
+	Type.Literal('SUSPENDED')
+])
+
+export const ZoneSupplyStatusSchema = Type.Union([
+	Type.Literal('OVER_SUPPLIED'),
+	Type.Literal('AVERAGE'),
+	Type.Literal('UNDER_SUPPLIED'),
+	Type.Literal('UNKNOWN')
+])
+export const ZoneDensityStatusSchema = Type.Union([
+	Type.Literal('HIGH'),
+	Type.Literal('NORMAL'),
+	Type.Literal('LOW'),
+	Type.Literal('UNKNOWN')
+])
+
+export const ZoneTelemetrySchema = Type.Object({
+	activeRiders: Type.Number({ minimum: 0 }),
+	pendingOrders: Type.Number({ minimum: 0 }),
+	demandScore: Type.Number({ minimum: 0, maximum: 100 }),
+	batchActive: Type.Boolean(),
+	updatedAt: DateTimeZoneSchema
+})
+
+export const ZoneDensitySchema = Type.Composite([
+	Type.Object({
+		zoneId: Type.String(),
+		name: Type.String(),
+		status: ZoneDensityStatusSchema,
+		supplyStatus: ZoneSupplyStatusSchema
+	}),
+	ZoneTelemetrySchema
+])
+
+export const ZoneSchema = Type.Object({
+  context: ContextSchema,
+	id: Type.String(),
+	name: Type.String(),
+	type: ZoneTypeSchema,
+	status: ZoneStatusSchema,
+	boundary: GeoBoundarySchema,
+	centroid: Type.Optional( CoordinatesSchema ),
+	metadata: Type.Optional( Type.Record( Type.String(), Type.Unknown() ) ),
+	parentZoneIds: Type.Optional( Type.Array( Type.String() ) ),
+  adjacentZones: Type.Array(Type.String()),
+	density: Type.Optional(ZoneDensitySchema),
+	created: ActionRecordSchema,
+	updated: Type.Optional(ActionRecordSchema)
+})
+
+export const ZoneQuerySchema = Type.Object({
+  at: Type.Optional(CoordinatesSchema),
+  adjacentTo: Type.Optional(Type.String()),
+  nearest: Type.Optional(CoordinatesSchema),
+  limit: Type.Optional(Type.Number())
+})
+
+export type ZoneType = Static<typeof ZoneTypeSchema>
+export type ZoneStatus = Static<typeof ZoneStatusSchema>
+export type ZoneSupplyStatus = Static<typeof ZoneSupplyStatusSchema>
+export type ZoneDensityStatus = Static<typeof ZoneDensityStatusSchema>
+export type ZoneDensity = Static<typeof ZoneDensitySchema>
+export type ZoneTelemetry = Static<typeof ZoneTelemetrySchema>
+export type Zone = Static<typeof ZoneSchema>
+export type ZoneQuery = Static<typeof ZoneQuerySchema>
+
+// ─── Request Validation Schemas ───────────────────────────────────────────────
+
+import {
+	APIErrorSchema,
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory
+} from '../api'
+
+export const LSPZoneListRVS = {
+	headers:     APIHeadersSchema,
+	querystring: ZoneQuerySchema,
+	response: {
+		200:   APIResponseDataSchemaFactory({ zones: Type.Array(ZoneSchema), total: Type.Number() }),
+		'4XX': APIErrorSchema
+	}
+}
+
+export const LSPZoneDensityRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	response: {
+		200:   APIResponseDataSchemaFactory({ density: ZoneDensitySchema }),
+		'4XX': APIErrorSchema
+	}
+}
+
+export const LSPZoneCreateRVS = {
+	headers:  APIHeadersSchema,
+	body:     Type.Object({
+		name:     Type.String({ minLength: 1, maxLength: 100 }),
+		boundary: Type.Any(),
+		metadata: Type.Optional(Type.Record(Type.String(), Type.Unknown()))
+	}),
+	response: {
+		201:   APIResponseDataSchemaFactory({ zoneId: Type.String() }),
+		'4XX': APIErrorSchema
+	}
+}
+
+export const LSPZoneUpdateStatusRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     Type.Object({ status: ZoneStatusSchema }),
+	response: {
+		200:   APIResponseDataSchemaFactory({ zone: ZoneSchema }),
+		'4XX': APIErrorSchema
+	}
+}
+
+export const LSPZoneRemoveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	response: {
+		200:   APIResponseBaseSchema,
+		'4XX': APIErrorSchema
+	}
+}
+
+export type LSPZoneListValidation         = { querystring: Static<typeof LSPZoneListRVS.querystring>, response: Static<(typeof LSPZoneListRVS.response)[200]> }
+export type LSPZoneDensityValidation      = { params: Static<typeof LSPZoneDensityRVS.params>, response: Static<(typeof LSPZoneDensityRVS.response)[200]> }
+export type LSPZoneCreateValidation       = { body: Static<typeof LSPZoneCreateRVS.body>, response: Static<(typeof LSPZoneCreateRVS.response)[201]> }
+export type LSPZoneUpdateStatusValidation = { params: Static<typeof LSPZoneUpdateStatusRVS.params>, body: Static<typeof LSPZoneUpdateStatusRVS.body>, response: Static<(typeof LSPZoneUpdateStatusRVS.response)[200]> }
+export type LSPZoneRemoveValidation       = { params: Static<typeof LSPZoneRemoveRVS.params>, response: Static<(typeof LSPZoneRemoveRVS.response)[200]> }

package/src/measure.ts

@@ -0,0 +1,240 @@
+import { Type, Static, TSchema } from '@sinclair/typebox'
+
+// ─── Length & Distance ────────────────────────────────────────────────────────
+
+export const LengthUnitSchema = Type.Union([
+	Type.Literal('km', { description: 'kilometer' }),
+	Type.Literal('mi', { description: 'mile' }),
+	Type.Literal('m',  { description: 'meter' }),
+	Type.Literal('cm', { description: 'centimeter' }),
+	Type.Literal('mm', { description: 'millimeter' }),
+	Type.Literal('ft', { description: 'feet' }),
+	Type.Literal('in', { description: 'inch' })
+])
+export const LengthSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  LengthUnitSchema
+})
+export const DistanceSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  LengthUnitSchema
+})
+export const DistanceRangeSchema = Type.Object({
+	from: DistanceSchema,
+	to:   DistanceSchema
+})
+
+// ─── Weight ───────────────────────────────────────────────────────────────────
+
+export const WeightUnitSchema = Type.Union([
+	Type.Literal('ton'),
+	Type.Literal('kg'),
+	Type.Literal('lb'),
+	Type.Literal('g'),
+	Type.Literal('oz')
+])
+export const WeightSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  WeightUnitSchema
+})
+
+// ─── Volume ───────────────────────────────────────────────────────────────────
+
+export const VolumeSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit: Type.Union([
+		Type.Literal('cbm'),
+		Type.Literal('l'),
+		Type.Literal('ml')
+	])
+})
+
+// ─── Dimensions ───────────────────────────────────────────────────────────────
+
+export const DimensionsSchema = Type.Object({
+	length: Type.Number({ minimum: 0 }),
+	width:  Type.Number({ minimum: 0 }),
+	height: Type.Number({ minimum: 0 }),
+	unit:   LengthUnitSchema
+})
+
+// ─── Area ─────────────────────────────────────────────────────────────────────
+
+export const AreaUnitSchema = Type.Union([
+	Type.Literal('sqft'),
+	Type.Literal('sqm'),
+	Type.Literal('sqkm'),
+	Type.Literal('sqmi')
+])
+export const AreaTypeSchema = Type.Union([
+	Type.Literal('PHYSICAL'),
+	Type.Literal('FUNCTIONAL')
+])
+export const AreaSchema = Type.Object({
+	type:  AreaTypeSchema,
+	value: Type.Number({ minimum: 0 }),
+	unit:  AreaUnitSchema
+})
+
+// ─── Temperature ──────────────────────────────────────────────────────────────
+
+export const TemperatureTypeSchema = Type.Union([
+	Type.Literal('FROZEN'),       // -18°C and below
+	Type.Literal('REFRIGERATED'), // 0°C to 8°C
+	Type.Literal('COOL'),         // 8°C to 15°C
+	Type.Literal('AMBIENT'),      // 15°C to 25°C
+	Type.Literal('CONTROLLED'),   // custom range
+	Type.Literal('HEATED')        // above ambient
+])
+export const TemperatureSchema = Type.Object({
+	type: TemperatureTypeSchema,
+	min:  Type.Number(),
+	max:  Type.Number(),
+	unit: Type.Union([Type.Literal('C'), Type.Literal('F')])
+})
+
+// ─── Money & Currency ─────────────────────────────────────────────────────────
+
+export const CurrencySchema = Type.Object({
+	code:            Type.String(),
+	name:            Type.String(),
+	plural:          Type.Optional(Type.String()),
+	symbol:          Type.String(),
+	symbol_native:   Type.Optional(Type.String())
+})
+export const MoneySchema = Type.Object({
+	amount:   Type.Number({ example: 12.50 }),
+	currency: Type.Union([
+		CurrencySchema,
+		Type.String({ description: 'ISO 4217 currency code', example: 'USD' })
+	])
+})
+
+// ─── Power / Bandwidth / Memory ───────────────────────────────────────────────
+
+export const PowerUnitSchema = Type.Union([
+	Type.Literal('KW'),
+	Type.Literal('W')
+])
+export const PowerSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  PowerUnitSchema
+})
+export const BandwidthUnitSchema = Type.Union([
+	Type.Literal('Mbps')
+])
+export const BandwidthSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  BandwidthUnitSchema
+})
+export const MemoryUnitSchema = Type.Union([
+	Type.Literal('TB'),
+	Type.Literal('GB'),
+	Type.Literal('MB'),
+	Type.Literal('B')
+])
+export const MemorySchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  MemoryUnitSchema
+})
+export const NoiseLevelUnitSchema = Type.Union([
+	Type.Literal('dbl', { description: 'decibel' })
+])
+export const NoiseLevelSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  NoiseLevelUnitSchema
+})
+
+// ─── Per-unit rates ───────────────────────────────────────────────────────────
+
+export const PerTimeSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  Type.String(),
+	per:   Type.String() // TimeUnit value
+})
+export const PerDistanceSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  Type.String(),
+	per:   LengthUnitSchema
+})
+export const PerAreaSchema = Type.Object({
+	value: Type.Number({ minimum: 0 }),
+	unit:  Type.String(),
+	per:   AreaUnitSchema
+})
+
+// ─── Special handling & compliance ───────────────────────────────────────────
+
+export const SpecialHandlingSchema = Type.Union([
+	Type.Literal('FRAGILE'),
+	Type.Literal('HAZMAT'),
+	Type.Literal('PERISHABLE'),
+	Type.Literal('HIGH_VALUE'),
+	Type.Literal('TEMPERATURE_SENSITIVE'),
+	Type.Literal('SIGNATURE_REQUIRED')
+])
+export const AccuracySchema = Type.Union([
+	Type.Literal('ESTIMATE'),
+	Type.Literal('STANDARD'),
+	Type.Literal('PRECISE')
+])
+export const SourceSchema = Type.Union([
+	Type.Literal('INTERNAL'),
+	Type.Literal('EXTERNAL'),
+	Type.Literal('HYBRID')
+])
+
+// ─── Service & severity levels ────────────────────────────────────────────────
+
+export const ServiceLevelSchema = Type.Union([
+	Type.Literal('SAME_DAY'),
+	Type.Literal('NEXT_DAY'),
+	Type.Literal('STANDARD'),
+	Type.Literal('ECONOMY'),
+	Type.Literal('EXPRESS'),
+	Type.Literal('INTERNATIONAL')
+])
+export const SeverityLevelSchema = Type.Union([
+	Type.Literal('LOW'),
+	Type.Literal('MEDIUM'),
+	Type.Literal('HIGH'),
+	Type.Literal('CRITICAL')
+])
+
+// ─── Generic Capacity Record ────────────────────────────────────────────────
+
+export const CapacityRecordSchema = <T extends TSchema>(measureSchema: T) => Type.Object({
+  max: measureSchema,
+  used: measureSchema
+})
+
+// ─── TypeScript types ─────────────────────────────────────────────────────────
+
+export type LengthUnit      = Static<typeof LengthUnitSchema>
+export type Length          = Static<typeof LengthSchema>
+export type Distance        = Static<typeof DistanceSchema>
+export type DistanceRange   = Static<typeof DistanceRangeSchema>
+export type WeightUnit      = Static<typeof WeightUnitSchema>
+export type Weight          = Static<typeof WeightSchema>
+export type Volume          = Static<typeof VolumeSchema>
+export type Dimensions      = Static<typeof DimensionsSchema>
+export type AreaUnit        = Static<typeof AreaUnitSchema>
+export type AreaType        = Static<typeof AreaTypeSchema>
+export type Area            = Static<typeof AreaSchema>
+export type TemperatureType = Static<typeof TemperatureTypeSchema>
+export type Temperature     = Static<typeof TemperatureSchema>
+export type Currency        = Static<typeof CurrencySchema>
+export type Money           = Static<typeof MoneySchema>
+export type Power           = Static<typeof PowerSchema>
+export type Bandwidth       = Static<typeof BandwidthSchema>
+export type Memory          = Static<typeof MemorySchema>
+export type NoiseLevel      = Static<typeof NoiseLevelSchema>
+export type PerTime         = Static<typeof PerTimeSchema>
+export type PerDistance     = Static<typeof PerDistanceSchema>
+export type PerArea         = Static<typeof PerAreaSchema>
+export type SpecialHandling = Static<typeof SpecialHandlingSchema>
+export type Accuracy        = Static<typeof AccuracySchema>
+export type Source          = Static<typeof SourceSchema>
+export type ServiceLevel    = Static<typeof ServiceLevelSchema>
+export type SeverityLevel   = Static<typeof SeverityLevelSchema>
+export type CapacityRecord<T extends TSchema> = Static<ReturnType<typeof CapacityRecordSchema<T>>>

package/src/operator.ts

@@ -0,0 +1,39 @@
+import { Type, type TSchema, Static } from '@sinclair/typebox'
+import { ContextSchema } from './context'
+import { ActionRecordSchema } from './time'
+import { RTLocationSchema, ContactsSchema, AddressSchema } from './geo'
+
+// Operator Status Schema
+export const OperatorStatusSchema = Type.Union([
+  Type.Literal('ACTIVE'),
+  Type.Literal('INACTIVE'),
+  Type.Literal('SUSPENDED')
+])
+
+// Operator Schema
+export const OperatorSchema = <R extends TSchema>(roleSchema: R) => Type.Object({
+  id: Type.String(),
+  context: ContextSchema,
+  bio: Type.Optional(Type.String({ maxLength: 500 })),
+  contacts: ContactsSchema,
+  address: Type.Optional(AddressSchema),
+  role: roleSchema,
+  // permissions: Type.Array(PermissionSchema), // Uncomment when Permission type is available
+  status: OperatorStatusSchema,
+  currentLocation: Type.Optional(RTLocationSchema),
+  added: ActionRecordSchema,
+  updated: Type.Optional(ActionRecordSchema)
+})
+export const OperatorUpdateSchema = <R extends TSchema>(roleSchema: R) => Type.Object({
+  bio: Type.Optional(Type.String({ maxLength: 500 })),
+  contacts: Type.Optional(ContactsSchema),
+  address: Type.Optional(AddressSchema),
+  role: Type.Optional(roleSchema),
+  // permissions: Type.Array(PermissionSchema), // Uncomment when Permission type is available
+  status: Type.Optional(OperatorStatusSchema)
+}, { additionalProperties: false })
+
+// Generate TypeScript types from schemas
+export type OperatorStatus = Static<typeof OperatorStatusSchema>
+export type Operator<R> = Static<ReturnType<typeof OperatorSchema<TSchema>>>
+export type OperatorUpdate<R> = Static<ReturnType<typeof OperatorUpdateSchema<TSchema>>>