@de./types 1.0.0

package/src/routing.ts

@@ -0,0 +1,69 @@
+import { Type, Static } from '@sinclair/typebox'
+import { AddressSchema, ContactsSchema, RTLocationSchema } from './geo'
+import { DistanceSchema } from './measure'
+import { DateTimeScheduleSchema, DurationSchema } from './time'
+
+// ─── Waypoint ─────────────────────────────────────────────────────────────────
+
+export const WaypointActionSchema = Type.Union([
+	Type.Literal('PICKUP'),
+	Type.Literal('DROPOFF'),
+	Type.Literal('CONSOLIDATION'),
+	Type.Literal('DECONSOLIDATION')
+])
+export const WaypointLocationTypeSchema = Type.Union([
+	Type.Literal('ANY'),
+	Type.Literal('HUB'),
+	Type.Literal('WAREHOUSE'),
+	Type.Literal('PICKUP_POINT'),
+	Type.Literal('CONSOLIDATION_POINT'),
+	Type.Literal('DECONSOLIDATION_POINT'),
+	Type.Literal('CUSTOMER')
+])
+export const WaypointSchema = Type.Object({
+	no:       Type.Number({ minimum: 1 }),  // Position in route sequence
+	action:   WaypointActionSchema,
+	type:     WaypointLocationTypeSchema,
+	address:  AddressSchema,
+	contact:  ContactsSchema,
+	handshake: Type.Optional(Type.Object({
+		code: Type.Number(),
+		link: Type.Optional(Type.String({ format: 'uri' }))
+	})),
+	schedule: Type.Optional(DateTimeScheduleSchema),
+	note:     Type.Optional(Type.String({ maxLength: 500 }))
+})
+
+// ─── Routing ──────────────────────────────────────────────────────────────────
+//
+// RoutingSegmentSchema.transitMode is typed as string here because
+// CoverageTransitModeSchema lives in de.arch LSP types.
+// Use the full RoutingSegmentSchema from de.arch for LSP-specific contexts.
+
+export const RoutingSegmentSchema = Type.Object({
+	from:        WaypointSchema,
+	to:          WaypointSchema,
+	distance:    Type.Optional(DistanceSchema),
+	duration:    Type.Optional(DurationSchema),
+	transitMode: Type.String()  // CoverageTransitMode in LSP context
+})
+export const RoutingOptimizationSchema = Type.Object({
+	score: Type.Optional(Type.Number({ minimum: 0, maximum: 100 })),
+	route: Type.Object({}, { additionalProperties: true })  // GeoJSON route
+})
+export const RoutingSchema = Type.Object({
+	id:              Type.String(),
+	sequence:        Type.Number({ minimum: 1 }),
+	segments:        Type.Array(RoutingSegmentSchema),
+	optimization:    Type.Optional(RoutingOptimizationSchema),
+	currentLocation: Type.Optional(RTLocationSchema)
+})
+
+// ─── TypeScript types ─────────────────────────────────────────────────────────
+
+export type WaypointAction       = Static<typeof WaypointActionSchema>
+export type WaypointLocationType = Static<typeof WaypointLocationTypeSchema>
+export type Waypoint             = Static<typeof WaypointSchema>
+export type RoutingSegment       = Static<typeof RoutingSegmentSchema>
+export type RoutingOptimization  = Static<typeof RoutingOptimizationSchema>
+export type Routing              = Static<typeof RoutingSchema>

package/src/service.ts

@@ -0,0 +1,66 @@
+import { Type, Static } from '@sinclair/typebox'
+import { ContextSchema } from './context'
+import { FAQDefinitionSchema } from './faq'
+import { ActionRecordSchema, TimeZoneSchema } from './time'
+import { AddressSchema, ContactsSchema } from './geo'
+import { AlertSchema, EntityStatusSchema, OperatingHoursSchema, OperatingModeSchema } from './entity'
+import { ServiceLevelSchema } from './measure'
+import { SubscriptionSchema } from './billing'
+
+// ─── Base service definition ──────────────────────────────────────────────────
+//
+// Shared profile schema for all De. service providers (LSP, CSP, IoTSP, etc.).
+// Each service extends this with its own capability and capacity fields.
+
+export const BaseServiceDefinitionProfileSchema = Type.Object({
+	context:         ContextSchema,
+	id:              Type.String(),
+	type:            Type.String(),
+	name:            Type.String({ minLength: 1, maxLength: 100 }),
+	code:            Type.String({ minLength: 1, maxLength: 50 }),
+	description:     Type.String({ maxLength: 1000 }),
+	website:         Type.Optional(Type.String()),
+	address:         AddressSchema,
+	contacts:        ContactsSchema,
+	operatingMode:   OperatingModeSchema,
+	operatingHours:  Type.Array(OperatingHoursSchema),
+	healthScore:     Type.Optional(Type.Number({ minimum: 0, maximum: 100 })),
+	digitalTwinSync: Type.Boolean(),
+	status:          EntityStatusSchema,
+	timezone:        TimeZoneSchema,
+	alerts:          Type.Optional(Type.Array(AlertSchema)),
+	tags:            Type.Optional(Type.Array(Type.String())),
+	customAttributes: Type.Optional(Type.Record(Type.String(), Type.Any())),
+	created:         ActionRecordSchema,
+	updated:         Type.Optional(ActionRecordSchema)
+})
+
+export const BaseServiceDefinitionSchema = Type.Composite([
+	BaseServiceDefinitionProfileSchema,
+	Type.Object({
+		subscription: Type.Optional(SubscriptionSchema),
+		faqs:         Type.Array(FAQDefinitionSchema)
+	})
+])
+
+export const BaseServiceDefinitionUpdateSchema = Type.Object({
+	name:            Type.Optional(Type.String({ minLength: 1, maxLength: 100 })),
+	code:            Type.Optional(Type.String({ minLength: 1, maxLength: 50 })),
+	description:     Type.Optional(Type.String({ maxLength: 1000 })),
+	website:         Type.Optional(Type.String()),
+	address:         Type.Optional(AddressSchema),
+	contacts:        Type.Optional(ContactsSchema),
+	operatingMode:   Type.Optional(OperatingModeSchema),
+	operatingHours:  Type.Optional(Type.Array(OperatingHoursSchema)),
+	serviceLevel:    Type.Optional(ServiceLevelSchema),
+	status:          Type.Optional(EntityStatusSchema),
+	timezone:        Type.Optional(TimeZoneSchema),
+	tags:            Type.Optional(Type.Array(Type.String())),
+	customAttributes: Type.Optional(Type.Record(Type.String(), Type.Any()))
+}, { additionalProperties: false })
+
+// ─── TypeScript types ─────────────────────────────────────────────────────────
+
+export type BaseServiceDefinitionProfile = Static<typeof BaseServiceDefinitionProfileSchema>
+export type BaseServiceDefinition        = Static<typeof BaseServiceDefinitionSchema>
+export type BaseServiceDefinitionUpdate  = Static<typeof BaseServiceDefinitionUpdateSchema>

package/src/shared/access.ts

@@ -0,0 +1,58 @@
+import { Type, Static } from '@sinclair/typebox'
+import {
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory,
+	RequestTokenBodySchema,
+	RotateTokenBodySchema,
+	RevokeTokenBodySchema
+} from '../api'
+import { ConnectorConfigSchema, ConnectorTypeSchema } from '../workspace/connector'
+
+export const SharedGetTokenRVS = {
+	headers: Type.Object({
+		origin: Type.String(),
+		'de-user-agent': Type.Optional(Type.String())
+	}),
+	body: RequestTokenBodySchema,
+	response: APIResponseDataSchemaFactory({ token: Type.String() })
+}
+
+export const SharedRotateTokenRVS = {
+	headers: APIHeadersSchema,
+	body: RotateTokenBodySchema,
+	response: APIResponseDataSchemaFactory({ token: Type.String() })
+}
+
+export const SharedRevokeTokenRVS = {
+	headers: APIHeadersSchema,
+	body: RevokeTokenBodySchema,
+	response: APIResponseBaseSchema,
+}
+
+export const SharedGetConfigRVS = {
+	headers: APIHeadersSchema,
+	querystring: Type.Object({ expects: Type.Optional(ConnectorTypeSchema) }),
+	response: APIResponseDataSchemaFactory({ config: ConnectorConfigSchema })
+}
+
+export type SharedGetTokenValidation = {
+	headers: Static<typeof SharedGetTokenRVS.headers>,
+	body: Static<typeof SharedGetTokenRVS.body>,
+	response: Static<typeof SharedGetTokenRVS.response>
+}
+export type SharedRotateTokenValidation = {
+	headers: Static<typeof SharedRotateTokenRVS.headers>,
+	body: Static<typeof SharedRotateTokenRVS.body>,
+	response: Static<typeof SharedRotateTokenRVS.response>
+}
+export type SharedRevokeTokenValidation = {
+	headers: Static<typeof SharedRevokeTokenRVS.headers>,
+	body: Static<typeof SharedRevokeTokenRVS.body>,
+	response: Static<typeof SharedRevokeTokenRVS.response>
+}
+export type SharedGetConfigValidation = {
+	headers: Static<typeof SharedGetConfigRVS.headers>,
+	querystring: Static<typeof SharedGetConfigRVS.querystring>,
+	response: Static<typeof SharedGetConfigRVS.response>
+}

package/src/shared/account.ts

@@ -0,0 +1,25 @@
+import { Static, Type } from '@sinclair/typebox'
+import {
+	APIHeadersSchema,
+	APIResponseDataSchemaFactory
+} from '../api'
+import { UserAccountPublicSchema } from '../user'
+
+export const SharedAccountKnowsRVS = {
+	headers: APIHeadersSchema,
+	response: APIResponseDataSchemaFactory({ uid: Type.String(), connected: Type.Boolean() })
+}
+
+export const SharedAccountRetrieveRVS = {
+	headers: APIHeadersSchema,
+	response: APIResponseDataSchemaFactory({ account: UserAccountPublicSchema })
+}
+
+export type SharedAccountKnowsValidation = {
+	headers: Static<typeof SharedAccountKnowsRVS.headers>
+	response: Static<typeof SharedAccountKnowsRVS.response>
+}
+export type SharedAccountRetrieveValidation = {
+	headers: Static<typeof SharedAccountRetrieveRVS.headers>
+	response: Static<typeof SharedAccountRetrieveRVS.response>
+}

package/src/shared/auth.ts

@@ -0,0 +1,30 @@
+import { Static, Type } from '@sinclair/typebox'
+import {
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory,
+	APIServiceHeadersSchema
+} from '../api'
+
+export const SharedAuthSetupRVS = {
+	headers: APIServiceHeadersSchema,
+	body: Type.Object({
+		phone: Type.String({ example: '+33612345678' }),
+		country: Type.Object({}, { example: { code: 'FR', name: 'France' } })
+	}),
+	response: APIResponseDataSchemaFactory({ uid: Type.String() })
+}
+
+export const SharedAuthSignoutRVS = {
+	headers: APIServiceHeadersSchema,
+	body: Type.Object({ uid: Type.String({ example: 'usr-abc123' }) }),
+	response: APIResponseBaseSchema
+}
+
+export type SharedAuthSetupValidation = {
+	body: Static<typeof SharedAuthSetupRVS.body>,
+	response: Static<typeof SharedAuthSetupRVS.response>
+}
+export type SharedAuthSignoutValidation = {
+	body: Static<typeof SharedAuthSignoutRVS.body>,
+	response: Static<typeof SharedAuthSignoutRVS.response>
+}

package/src/shared/bucket.ts

@@ -0,0 +1,153 @@
+import { Type, Static } from '@sinclair/typebox'
+import {
+	APIErrorSchema,
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory
+} from '../api'
+import { UserTypeSchema } from '../user'
+import { BucketSchema, BucketUpdateSchema } from '../bucket'
+import { InventoryItemSchema } from '../inventory'
+import { OrderPackageCategorySchema } from '../order'
+import type { Bucket } from '../bucket'
+import type { InventoryItem } from '../inventory'
+
+export const SharedBucketCreateRVS = {
+	headers: APIHeadersSchema,
+	body: Type.Omit(BucketSchema, ['reference', 'context', 'PTC', 'items', 'assignees', 'locked', 'packaged', 'logs', 'created', 'updated']),
+	response: APIResponseDataSchemaFactory({ reference: Type.String() })
+}
+
+export const SharedBucketRetrieveRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	response: APIResponseDataSchemaFactory({ bucket: BucketSchema })
+}
+
+export const SharedBucketFetchRVS = {
+	headers: APIHeadersSchema,
+	response: APIResponseDataSchemaFactory({ buckets: Type.Array(BucketSchema) })
+}
+
+export const SharedBucketUpdateRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	body: BucketUpdateSchema,
+	response: APIResponseDataSchemaFactory({ bucket: BucketSchema })
+}
+
+export const SharedBucketRemoveRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	response: APIResponseBaseSchema
+}
+
+export const SharedBucketAssignRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String(), to: UserTypeSchema }),
+	body: Type.Object({
+		id: Type.String(),
+		permission: Type.Union([
+			Type.Literal('bucket.read'),
+			Type.Literal('bucket.write'),
+			Type.Literal('bucket.read-write')
+		])
+	}),
+	response: APIResponseBaseSchema
+}
+
+export const SharedBucketUnassignRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String(), to: UserTypeSchema }),
+	body: Type.Object({ id: Type.String() }),
+	response: APIResponseBaseSchema
+}
+
+export const SharedBucketLockOrUnlockRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({
+		reference: Type.String(),
+		ockstate: Type.Union([Type.Literal('lock'), Type.Literal('unlock')])
+	}),
+	response: APIResponseBaseSchema
+}
+
+export const SharedBucketAddOrRemoveItemRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	body: Type.Object({ id: Type.String() }),
+	response: APIResponseBaseSchema
+}
+
+export const SharedBucketFetchItemsRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	response: APIResponseDataSchemaFactory({ items: Type.Array(InventoryItemSchema) })
+}
+
+export const SharedBucketPackagedRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	body: Type.Object({ category: OrderPackageCategorySchema }),
+	response: APIResponseDataSchemaFactory({ package: Type.Array(BucketSchema) })
+}
+
+export type SharedBucketCreateValidation = {
+	headers: Static<typeof SharedBucketCreateRVS.headers>,
+	body: Static<typeof SharedBucketCreateRVS.body>,
+	response: Static<typeof SharedBucketCreateRVS.response>
+}
+export type SharedBucketRetrieveValidation = {
+	headers: Static<typeof SharedBucketFetchRVS.headers>,
+	params: Static<typeof SharedBucketRetrieveRVS.params>,
+	response: Static<typeof SharedBucketRetrieveRVS.response>
+}
+export type SharedBucketFetchValidation = {
+	headers: Static<typeof SharedBucketFetchRVS.headers>,
+	response: Static<typeof SharedBucketFetchRVS.response>
+}
+export type SharedBucketUpdateValidation = {
+	headers: Static<typeof SharedBucketUpdateRVS.headers>,
+	params: Static<typeof SharedBucketUpdateRVS.params>,
+	body: Static<typeof SharedBucketUpdateRVS.body>,
+	response: Static<typeof SharedBucketUpdateRVS.response>
+}
+export type SharedBucketRemoveValidation = {
+	headers: Static<typeof SharedBucketRemoveRVS.headers>,
+	params: Static<typeof SharedBucketRemoveRVS.params>,
+	response: Static<typeof SharedBucketRemoveRVS.response>
+}
+export type SharedBucketAssignValidation = {
+	headers: Static<typeof SharedBucketAssignRVS.headers>,
+	params: Static<typeof SharedBucketAssignRVS.params>,
+	body: Static<typeof SharedBucketAssignRVS.body>,
+	response: Static<typeof SharedBucketAssignRVS.response>
+}
+export type SharedBucketUnassignValidation = {
+	headers: Static<typeof SharedBucketUnassignRVS.headers>,
+	params: Static<typeof SharedBucketUnassignRVS.params>,
+	body: Static<typeof SharedBucketUnassignRVS.body>,
+	response: Static<typeof SharedBucketUnassignRVS.response>
+}
+export type SharedBucketLockOrUnlockValidation = {
+	headers: Static<typeof SharedBucketLockOrUnlockRVS.headers>,
+	params: Static<typeof SharedBucketLockOrUnlockRVS.params>,
+	response: Static<typeof SharedBucketLockOrUnlockRVS.response>
+}
+export type SharedBucketAddOrRemoveItemValidation = {
+	headers: Static<typeof SharedBucketAddOrRemoveItemRVS.headers>,
+	params: Static<typeof SharedBucketAddOrRemoveItemRVS.params>,
+	body: Static<typeof SharedBucketAddOrRemoveItemRVS.body>,
+	response: Static<typeof SharedBucketAddOrRemoveItemRVS.response>
+}
+export type SharedBucketFetchItemsValidation = {
+	headers: Static<typeof SharedBucketFetchItemsRVS.headers>,
+	params: Static<typeof SharedBucketFetchItemsRVS.params>,
+	response: Static<typeof SharedBucketFetchItemsRVS.response>
+}
+export type SharedBucketPackagedValidation = {
+	headers: Static<typeof SharedBucketPackagedRVS.headers>,
+	params: Static<typeof SharedBucketPackagedRVS.params>,
+	body: Static<typeof SharedBucketPackagedRVS.body>,
+	response: Static<typeof SharedBucketPackagedRVS.response>
+}

package/src/shared/faq.ts

@@ -0,0 +1,139 @@
+import { Type, Static } from '@sinclair/typebox'
+import {
+	APIErrorSchema,
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory
+} from '../api'
+import { GenericServiceContextSchema } from '../context'
+import { FAQDefinitionSchema, FAQDefinitionUpdateSchema, FAQDefinitionStatusSchema } from '../faq'
+import type { FAQDefinition } from '../faq'
+
+export const SharedFAQAddRVS = {
+	headers: APIHeadersSchema,
+	body: Type.Omit(FAQDefinitionSchema, ['reference', 'context', 'status', 'contexts', 'locked', 'added', 'updated']),
+	response: APIResponseDataSchemaFactory({ reference: Type.String() })
+}
+
+export const SharedFAQRetrieveRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	response: APIResponseDataSchemaFactory({ faq: FAQDefinitionSchema })
+}
+
+export const SharedFAQFetchRVS = {
+	headers: APIHeadersSchema,
+	querystring: Type.Object({
+		limit: Type.Optional(Type.String()),
+		offset: Type.Optional(Type.String()),
+		status: Type.Optional(FAQDefinitionStatusSchema),
+		context: Type.Optional(Type.String())
+	}),
+	response: APIResponseDataSchemaFactory({ faqs: Type.Array(FAQDefinitionSchema), more: Type.Optional(Type.String()) }),
+}
+
+export const SharedFAQSearchRVS = {
+	headers: APIHeadersSchema,
+	querystring: Type.Object({
+		query: Type.String(),
+		limit: Type.Optional(Type.String()),
+		status: Type.Optional(FAQDefinitionStatusSchema)
+	}),
+	response: APIResponseDataSchemaFactory({ faqs: Type.Array(FAQDefinitionSchema), query: Type.String() })
+}
+
+export const SharedFAQUpdateRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	body: FAQDefinitionUpdateSchema,
+	response: APIResponseDataSchemaFactory({ faq: FAQDefinitionSchema })
+}
+
+export const SharedFAQRemoveRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	response: APIResponseBaseSchema
+}
+
+export const SharedFAQAddServiceContextRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	body: GenericServiceContextSchema,
+	response: APIResponseDataSchemaFactory({ faq: FAQDefinitionSchema })
+}
+
+export const SharedFAQRemoveServiceContextRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	body: Type.Partial(GenericServiceContextSchema),
+	response: APIResponseDataSchemaFactory({ faq: FAQDefinitionSchema })
+}
+
+export const SharedFAQArchiveOrRestoreRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({ reference: Type.String() }),
+	response: APIResponseBaseSchema
+}
+
+export const SharedFAQLockOrUnlockRVS = {
+	headers: APIHeadersSchema,
+	params: Type.Object({
+		reference: Type.String(),
+		ockstate: Type.Union([Type.Literal('lock'), Type.Literal('unlock')])
+	}),
+	response: APIResponseBaseSchema
+}
+
+export type SharedFAQAddValidation = {
+	headers: Static<typeof SharedFAQAddRVS.headers>,
+	body: Static<typeof SharedFAQAddRVS.body>,
+	response: Static<typeof SharedFAQAddRVS.response>
+}
+export type SharedFAQRetrieveValidation = {
+	headers: Static<typeof SharedFAQRetrieveRVS.headers>,
+	params: Static<typeof SharedFAQRetrieveRVS.params>,
+	response: Static<typeof SharedFAQRetrieveRVS.response>
+}
+export type SharedFAQFetchValidation = {
+	headers: Static<typeof SharedFAQFetchRVS.headers>,
+	querystring: Static<typeof SharedFAQFetchRVS.querystring>,
+	response: Static<typeof SharedFAQFetchRVS.response>
+}
+export type SharedFAQSearchValidation = {
+	headers: Static<typeof SharedFAQSearchRVS.headers>,
+	querystring: Static<typeof SharedFAQSearchRVS.querystring>,
+	response: Static<typeof SharedFAQSearchRVS.response>
+}
+export type SharedFAQUpdateValidation = {
+	headers: Static<typeof SharedFAQUpdateRVS.headers>,
+	params: Static<typeof SharedFAQUpdateRVS.params>,
+	body: Static<typeof SharedFAQUpdateRVS.body>,
+	response: Static<typeof SharedFAQUpdateRVS.response>
+}
+export type SharedFAQRemoveValidation = {
+	headers: Static<typeof SharedFAQRemoveRVS.headers>,
+	params: Static<typeof SharedFAQRemoveRVS.params>,
+	response: Static<typeof SharedFAQRemoveRVS.response>
+}
+export type SharedFAQAddServiceContextValidation = {
+	headers: Static<typeof SharedFAQAddServiceContextRVS.headers>,
+	params: Static<typeof SharedFAQAddServiceContextRVS.params>,
+	body: Static<typeof SharedFAQAddServiceContextRVS.body>,
+	response: Static<typeof SharedFAQAddServiceContextRVS.response>
+}
+export type SharedFAQRemoveServiceContextValidation = {
+	headers: Static<typeof SharedFAQRemoveServiceContextRVS.headers>,
+	params: Static<typeof SharedFAQRemoveServiceContextRVS.params>,
+	body: Static<typeof SharedFAQRemoveServiceContextRVS.body>,
+	response: Static<typeof SharedFAQRemoveServiceContextRVS.response>
+}
+export type SharedFAQArchiveOrRestoreValidation = {
+	headers: Static<typeof SharedFAQArchiveOrRestoreRVS.headers>,
+	params: Static<typeof SharedFAQArchiveOrRestoreRVS.params>,
+	response: Static<typeof SharedFAQArchiveOrRestoreRVS.response>
+}
+export type SharedFAQLockOrUnlockValidation = {
+	headers: Static<typeof SharedFAQLockOrUnlockRVS.headers>,
+	params: Static<typeof SharedFAQLockOrUnlockRVS.params>,
+	response: Static<typeof SharedFAQLockOrUnlockRVS.response>
+}

package/src/shared/index.ts

@@ -0,0 +1,9 @@
+export * from './access'
+export * from './auth'
+export * from './account'
+export * from './bucket'
+export * from './faq'
+export * from './invitation'
+export * from './operator'
+export * from './tracking'
+export * from './user'

package/src/shared/invitation.ts

@@ -0,0 +1,124 @@
+import { Type, Static, type TObject } from '@sinclair/typebox'
+import {
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory
+} from '../api'
+import { AdminSchema } from '../workspace/admin'
+import { AgentProfileSchema } from '../aux/agents'
+import { DeveloperSchema } from '../dev/developer'
+import { OperatorSchema } from '../operator'
+import { type ContextType, CSPOperatorRoleSchema, DEVOperatorRoleSchema, LSPOperatorRoleSchema } from '..'
+
+// ─── Builder ──────────────────────────────────────────────────────────────────
+
+const buildInvitationRVS = <Op extends TObject>( operatorSchema: Op ) => {
+	const headersSchema = APIHeadersSchema
+	const
+	adminField = Type.Omit(AdminSchema, ['id', 'context', 'added', 'updated'] as const),
+	agentField = Type.Omit(AgentProfileSchema, ['id', 'context', 'added', 'updated'] as const),
+	operatorField = Type.Omit(operatorSchema, ['id', 'context', 'currentLocation', 'added', 'updated'] as const),
+	developerField = Type.Omit(DeveloperSchema, ['id', 'context', 'added', 'updated'] as const)
+
+	return {
+		operatorField,
+		invite: {
+			headers: headersSchema,
+			params: Type.Object({
+				wid: Type.Optional(Type.String()),
+				xcode: Type.Optional(Type.String()),
+				as: Type.String()
+			}),
+			body: Type.Object({
+				phone: Type.String(),
+				name: Type.String(),
+				admin: Type.Optional(adminField),
+				agent: Type.Optional(agentField),
+				operator: Type.Optional(operatorField),
+				developer: Type.Optional(developerField)
+			}, { additionalProperties: false }),
+			response: APIResponseDataSchemaFactory({ vcode: Type.String() })
+		},
+		cancel: {
+			headers: headersSchema,
+			body: Type.Object({ vcode: Type.String() }),
+			response: APIResponseBaseSchema
+		},
+		accept: {
+			headers: headersSchema,
+			body: Type.Object({ vcode: Type.String() }),
+			response: APIResponseBaseSchema
+		}
+	}
+}
+
+// ─── Per-context RVS ──────────────────────────────────────────────────────────
+
+export const DEVSharedInvitationRVS = buildInvitationRVS( OperatorSchema(DEVOperatorRoleSchema) )
+export const CSPSharedInvitationRVS = buildInvitationRVS( OperatorSchema(CSPOperatorRoleSchema) )
+export const LSPSharedInvitationRVS = buildInvitationRVS( OperatorSchema(LSPOperatorRoleSchema) )
+
+// ─── ctype dispatcher ─────────────────────────────────────────────────────────
+
+export const SharedInvitationRVS = ( ctype: ContextType ) => {
+	switch( ctype ){
+		case 'DEV': return DEVSharedInvitationRVS
+		case 'CSP': return CSPSharedInvitationRVS
+		case 'LSP': return LSPSharedInvitationRVS
+		default: return LSPSharedInvitationRVS
+	}
+}
+
+// ─── Validation types ─────────────────────────────────────────────────────────
+
+export type DEVSharedInvitationSendValidation = {
+	headers: Static<typeof DEVSharedInvitationRVS.invite.headers>
+	params: Static<typeof DEVSharedInvitationRVS.invite.params>
+	body: Static<typeof DEVSharedInvitationRVS.invite.body>
+	response: Static<typeof DEVSharedInvitationRVS.invite.response>
+}
+export type DEVSharedInvitationCancelValidation = {
+	headers: Static<typeof DEVSharedInvitationRVS.cancel.headers>
+	body: Static<typeof DEVSharedInvitationRVS.cancel.body>
+	response: Static<typeof DEVSharedInvitationRVS.cancel.response>
+}
+export type DEVSharedInvitationAcceptValidation = {
+	headers: Static<typeof DEVSharedInvitationRVS.accept.headers>
+	body: Static<typeof DEVSharedInvitationRVS.accept.body>
+	response: Static<typeof DEVSharedInvitationRVS.accept.response>
+}
+
+export type CSPSharedInvitationSendValidation = {
+	headers: Static<typeof CSPSharedInvitationRVS.invite.headers>
+	params: Static<typeof CSPSharedInvitationRVS.invite.params>
+	body: Static<typeof CSPSharedInvitationRVS.invite.body>
+	response: Static<typeof CSPSharedInvitationRVS.invite.response>
+}
+export type CSPSharedInvitationCancelValidation = {
+	headers: Static<typeof CSPSharedInvitationRVS.cancel.headers>
+	body: Static<typeof CSPSharedInvitationRVS.cancel.body>
+	response: Static<typeof CSPSharedInvitationRVS.cancel.response>
+}
+export type CSPSharedInvitationAcceptValidation = {
+	headers: Static<typeof CSPSharedInvitationRVS.accept.headers>
+	body: Static<typeof CSPSharedInvitationRVS.accept.body>
+	response: Static<typeof CSPSharedInvitationRVS.accept.response>
+}
+
+export type LSPSharedInvitationSendValidation = {
+	headers: Static<typeof LSPSharedInvitationRVS.invite.headers>
+	params: Static<typeof LSPSharedInvitationRVS.invite.params>
+	body: Static<typeof LSPSharedInvitationRVS.invite.body>
+	response: Static<typeof LSPSharedInvitationRVS.invite.response>
+}
+export type LSPSharedInvitationCancelValidation = {
+	headers: Static<typeof LSPSharedInvitationRVS.cancel.headers>
+	body: Static<typeof LSPSharedInvitationRVS.cancel.body>
+	response: Static<typeof LSPSharedInvitationRVS.cancel.response>
+}
+export type LSPSharedInvitationAcceptValidation = {
+	headers: Static<typeof LSPSharedInvitationRVS.accept.headers>
+	body: Static<typeof LSPSharedInvitationRVS.accept.body>
+	response: Static<typeof LSPSharedInvitationRVS.accept.response>
+}
+