@vorionsys/contracts 0.1.0

package/dist/aci/mapping.d.ts

@@ -0,0 +1,291 @@
+/**
+ * @fileoverview Cross-System Mappings
+ *
+ * Provides mapping functions between different tier systems, domain namespaces,
+ * and trust representations. These mappings enable interoperability between
+ * the ACI specification and Vorion runtime systems.
+ *
+ * Key mappings:
+ * - CertificationTier <-> RuntimeTier
+ * - ACI Domains <-> Vorion Namespaces
+ * - TrustBand <-> CertificationTier/RuntimeTier
+ *
+ * @module @vorion/contracts/aci/mapping
+ */
+import { z } from 'zod';
+import { type DomainCode } from './domains.js';
+import { CapabilityLevel } from './levels.js';
+import { CertificationTier, RuntimeTier } from './tiers.js';
+/**
+ * Maps a CertificationTier to the corresponding RuntimeTier.
+ *
+ * This is a direct 1:1 mapping since both use T0-T7 scale, but with
+ * different semantic meanings:
+ * - CertificationTier: External attestation status
+ * - RuntimeTier: Deployment autonomy level
+ *
+ * @param certificationTier - ACI certification tier
+ * @returns Corresponding Vorion runtime tier
+ *
+ * @example
+ * ```typescript
+ * certificationTierToRuntimeTier(CertificationTier.T3_MONITORED);
+ * // RuntimeTier.T3_MONITORED
+ * ```
+ */
+export declare function certificationTierToRuntimeTier(certificationTier: CertificationTier): RuntimeTier;
+/**
+ * Maps a RuntimeTier to the corresponding CertificationTier.
+ *
+ * @param runtimeTier - Vorion runtime tier
+ * @returns Corresponding ACI certification tier
+ *
+ * @example
+ * ```typescript
+ * runtimeTierToCertificationTier(RuntimeTier.T3_MONITORED);
+ * // CertificationTier.T3_MONITORED
+ * ```
+ */
+export declare function runtimeTierToCertificationTier(runtimeTier: RuntimeTier): CertificationTier;
+/**
+ * Mapping configuration for certification to runtime tier.
+ */
+export declare const CERTIFICATION_TO_RUNTIME_TIER_MAP: Readonly<Record<CertificationTier, RuntimeTier>>;
+/**
+ * Mapping configuration for runtime to certification tier.
+ */
+export declare const RUNTIME_TO_CERTIFICATION_TIER_MAP: Readonly<Record<RuntimeTier, CertificationTier>>;
+/**
+ * TrustBand values from Vorion canonical types.
+ * Replicated here to avoid circular dependencies.
+ *
+ * The 8-tier system (T0-T7) maps trust scores to discrete autonomy levels:
+ * - T0: Sandbox - Isolated testing, no real operations (0-199)
+ * - T1: Observed - Under active observation and supervision (200-349)
+ * - T2: Provisional - Limited operations with strict constraints (350-499)
+ * - T3: Monitored - Continuous monitoring with expanding freedom (500-649)
+ * - T4: Standard - Trusted for routine operations (650-799)
+ * - T5: Trusted - Expanded capabilities with minimal oversight (800-875)
+ * - T6: Certified - Independent operation with audit trail (876-950)
+ * - T7: Autonomous - Full autonomy for mission-critical operations (951-1000)
+ */
+export declare enum TrustBand {
+    T0_SANDBOX = 0,
+    T1_OBSERVED = 1,
+    T2_PROVISIONAL = 2,
+    T3_MONITORED = 3,
+    T4_STANDARD = 4,
+    T5_TRUSTED = 5,
+    T6_CERTIFIED = 6,
+    T7_AUTONOMOUS = 7
+}
+/**
+ * Zod schema for TrustBand validation.
+ */
+export declare const trustBandSchema: z.ZodNativeEnum<typeof TrustBand>;
+/**
+ * Maps a TrustBand to a CertificationTier.
+ *
+ * @param trustBand - Vorion trust band
+ * @returns Corresponding ACI certification tier
+ *
+ * @example
+ * ```typescript
+ * trustBandToCertificationTier(TrustBand.T3_STANDARD);
+ * // CertificationTier.T3_MONITORED
+ * ```
+ */
+export declare function trustBandToCertificationTier(trustBand: TrustBand): CertificationTier;
+/**
+ * Maps a TrustBand to a RuntimeTier.
+ *
+ * @param trustBand - Vorion trust band
+ * @returns Corresponding Vorion runtime tier
+ *
+ * @example
+ * ```typescript
+ * trustBandToRuntimeTier(TrustBand.T3_STANDARD);
+ * // RuntimeTier.T3_MONITORED
+ * ```
+ */
+export declare function trustBandToRuntimeTier(trustBand: TrustBand): RuntimeTier;
+/**
+ * Maps a CertificationTier to a TrustBand.
+ *
+ * @param certificationTier - ACI certification tier
+ * @returns Corresponding Vorion trust band
+ */
+export declare function certificationTierToTrustBand(certificationTier: CertificationTier): TrustBand;
+/**
+ * Maps a RuntimeTier to a TrustBand.
+ *
+ * @param runtimeTier - Vorion runtime tier
+ * @returns Corresponding Vorion trust band
+ */
+export declare function runtimeTierToTrustBand(runtimeTier: RuntimeTier): TrustBand;
+/**
+ * Converts a trust score to both certification and runtime tiers.
+ *
+ * Note: CertificationTier and RuntimeTier use different score ranges,
+ * so the same score may map to different tiers.
+ *
+ * @param score - Trust score (0-1000)
+ * @returns Both certification and runtime tiers
+ *
+ * @example
+ * ```typescript
+ * scoreToBothTiers(550);
+ * // { certificationTier: T3_MONITORED, runtimeTier: T3_TRUSTED }
+ * ```
+ */
+export declare function scoreToBothTiers(score: number): {
+    certificationTier: CertificationTier;
+    runtimeTier: RuntimeTier;
+};
+/**
+ * Normalizes a score between ACI and Vorion scales.
+ *
+ * ACI uses 0-1000 with boundaries at 100, 300, 500, 700, 900
+ * Vorion uses 0-1000 with boundaries at 166, 333, 500, 666, 833
+ *
+ * @param score - Trust score
+ * @param fromScale - Source scale ('aci' | 'vorion')
+ * @param toScale - Target scale ('aci' | 'vorion')
+ * @returns Normalized score in target scale
+ */
+export declare function normalizeScoreBetweenScales(score: number, fromScale: 'aci' | 'vorion', toScale: 'aci' | 'vorion'): number;
+/**
+ * Vorion namespace strings corresponding to ACI domains.
+ */
+export type VorionNamespace = 'admin' | 'business' | 'communications' | 'data' | 'external' | 'finance' | 'governance' | 'hospitality' | 'infrastructure' | 'security';
+/**
+ * Array of all Vorion namespaces.
+ */
+export declare const VORION_NAMESPACES: readonly VorionNamespace[];
+/**
+ * Zod schema for VorionNamespace validation.
+ */
+export declare const vorionNamespaceSchema: z.ZodEnum<["admin", "business", "communications", "data", "external", "finance", "governance", "hospitality", "infrastructure", "security"]>;
+/**
+ * Mapping from ACI domain codes to Vorion namespaces.
+ */
+export declare const DOMAIN_TO_NAMESPACE_MAP: Readonly<Record<DomainCode, VorionNamespace>>;
+/**
+ * Mapping from Vorion namespaces to ACI domain codes.
+ */
+export declare const NAMESPACE_TO_DOMAIN_MAP: Readonly<Record<VorionNamespace, DomainCode>>;
+/**
+ * Maps an ACI domain code to a Vorion namespace.
+ *
+ * @param domain - ACI domain code
+ * @returns Vorion namespace
+ *
+ * @example
+ * ```typescript
+ * aciDomainToVorionNamespace('F');  // 'finance'
+ * aciDomainToVorionNamespace('S');  // 'security'
+ * ```
+ */
+export declare function aciDomainToVorionNamespace(domain: DomainCode): VorionNamespace;
+/**
+ * Maps a Vorion namespace to an ACI domain code.
+ *
+ * @param namespace - Vorion namespace
+ * @returns ACI domain code
+ *
+ * @example
+ * ```typescript
+ * vorionNamespaceToAciDomain('finance');  // 'F'
+ * vorionNamespaceToAciDomain('security'); // 'S'
+ * ```
+ */
+export declare function vorionNamespaceToAciDomain(namespace: VorionNamespace): DomainCode;
+/**
+ * Maps an array of ACI domains to Vorion namespaces.
+ *
+ * @param domains - Array of ACI domain codes
+ * @returns Array of Vorion namespaces
+ */
+export declare function aciDomainsToVorionNamespaces(domains: readonly DomainCode[]): VorionNamespace[];
+/**
+ * Maps an array of Vorion namespaces to ACI domains.
+ *
+ * @param namespaces - Array of Vorion namespaces
+ * @returns Array of ACI domain codes
+ */
+export declare function vorionNamespacesToAciDomains(namespaces: readonly VorionNamespace[]): DomainCode[];
+/**
+ * Maps a capability level to a human-readable autonomy description.
+ *
+ * @param level - Capability level
+ * @returns Autonomy description
+ */
+export declare function capabilityLevelToAutonomyDescription(level: CapabilityLevel): string;
+/**
+ * Maps a capability level to a maximum allowed runtime tier.
+ *
+ * Higher capability levels require higher runtime tiers to operate.
+ *
+ * @param level - Capability level
+ * @returns Minimum runtime tier required
+ */
+export declare function capabilityLevelToMinRuntimeTier(level: CapabilityLevel): RuntimeTier;
+/**
+ * A bidirectional mapping between two types.
+ */
+export interface BidirectionalMap<A, B> {
+    forward: (a: A) => B;
+    reverse: (b: B) => A;
+    forwardMap: Readonly<Record<string, B>>;
+    reverseMap: Readonly<Record<string, A>>;
+}
+/**
+ * Creates a bidirectional mapping.
+ *
+ * @param mapping - Object mapping A values to B values
+ * @returns Bidirectional map with forward and reverse functions
+ */
+export declare function createBidirectionalMap<A extends string | number, B extends string | number>(mapping: Record<A, B>): BidirectionalMap<A, B>;
+/**
+ * Pre-built bidirectional map for domain <-> namespace.
+ */
+export declare const domainNamespaceMap: BidirectionalMap<DomainCode, VorionNamespace>;
+/**
+ * Pre-built bidirectional map for certification <-> runtime tier.
+ */
+export declare const certificationRuntimeMap: BidirectionalMap<CertificationTier, RuntimeTier>;
+/**
+ * Zod schema for tier mapping result.
+ */
+export declare const tierMappingResultSchema: z.ZodObject<{
+    certificationTier: z.ZodNativeEnum<typeof CertificationTier>;
+    runtimeTier: z.ZodNativeEnum<typeof RuntimeTier>;
+}, "strip", z.ZodTypeAny, {
+    certificationTier: CertificationTier;
+    runtimeTier: RuntimeTier;
+}, {
+    certificationTier: CertificationTier;
+    runtimeTier: RuntimeTier;
+}>;
+/**
+ * Zod schema for domain mapping result.
+ */
+export declare const domainMappingResultSchema: z.ZodObject<{
+    domain: z.ZodEnum<["A", "B", "C", "D", "E", "F", "G", "H", "I", "S"]>;
+    namespace: z.ZodEnum<["admin", "business", "communications", "data", "external", "finance", "governance", "hospitality", "infrastructure", "security"]>;
+}, "strip", z.ZodTypeAny, {
+    domain: "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | "S";
+    namespace: "external" | "admin" | "security" | "governance" | "data" | "business" | "communications" | "finance" | "hospitality" | "infrastructure";
+}, {
+    domain: "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | "S";
+    namespace: "external" | "admin" | "security" | "governance" | "data" | "business" | "communications" | "finance" | "hospitality" | "infrastructure";
+}>;
+/**
+ * Type guard for VorionNamespace.
+ */
+export declare function isVorionNamespace(value: unknown): value is VorionNamespace;
+/**
+ * Type guard for TrustBand.
+ */
+export declare function isTrustBand(value: unknown): value is TrustBand;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/aci/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../src/aci/mapping.ts"],"names":[],"mappings":"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"}