@zlink-systems/framework 0.21.0 → 0.23.0

package/src/runtime/locations/spot-location-claims.ts

@@ -1,4 +1,7 @@
-import { ZLinkFrameworkInternalErrorKind, createInternalFrameworkException  } from '../framework-errors-internal';
+import {
+  ZLinkFrameworkInternalErrorKind,
+  createInternalFrameworkException
+} from '../framework-errors-internal';
 import type { RoutingId } from '../../contracts/Common';
 import type {
   ZLinkAuthoritySnapshot,
@@ -12,10 +15,7 @@ import {
 } from './internal-location-contracts';
 import { ZLinkSpotKind } from '../../contracts/Spots';
 import { ZLinkLocationKeyCodec } from './key-codec';
-import type {
-  IZLinkLocationLifecycleRuntime,
-  ZLinkOwnershipLostEvent
-} from './lifecycle-runtime';
+import type { IZLinkLocationLifecycleRuntime, ZLinkOwnershipLostEvent } from './lifecycle-runtime';
 import type { ZLinkAuthorityStore, ZLinkSpotLocationStore } from './internal-store-contracts';
 import { encodeAuthorityKey } from './authority-key-codec';
 import { routingIdsEqual } from '../routing-id';
@@ -63,20 +63,17 @@ export class ZLinkSpotLocationClaims {
     const result = await this.runtime.writeSpot(row, ZLinkLocationWriteIntent.NewClaim);
     if (result.status === ZLinkLocationWriteStatus.Stored) {
       const owner = this.runtime.currentOwnerToken;
-      this.spots.set(
-        ZLinkLocationKeyCodec.encodeSpotKey({ meshName, spotId }),
-        {
-          kind: 'legacy',
-          row: {
-            ...row,
-            ownerId: this.runtime.ownerId,
-            leaseGeneration: owner?.leaseGeneration ?? row.leaseGeneration,
-            updatedAt: result.updatedAt
-          },
-          generation: result.generation,
-          deactivate
-        }
-      );
+      this.spots.set(ZLinkLocationKeyCodec.encodeSpotKey({ meshName, spotId }), {
+        kind: 'legacy',
+        row: {
+          ...row,
+          ownerId: this.runtime.ownerId,
+          leaseGeneration: owner?.leaseGeneration ?? row.leaseGeneration,
+          updatedAt: result.updatedAt
+        },
+        generation: result.generation,
+        deactivate
+      });
     }
     return result.status;
   }
@@ -106,8 +103,8 @@ export class ZLinkSpotLocationClaims {
       return;
     }
     if (
-      expectedObjectGeneration !== undefined
-      && (tracked.kind !== 'authority' || tracked.objectGeneration !== expectedObjectGeneration)
+      expectedObjectGeneration !== undefined &&
+      (tracked.kind !== 'authority' || tracked.objectGeneration !== expectedObjectGeneration)
     ) {
       return;
     }
@@ -148,27 +145,23 @@ export class ZLinkSpotLocationClaims {
     if (decoded?.state !== 'ready' || decoded.activationRecovery !== undefined) {
       return undefined;
     }
-    const result = await store.compareExchangeAuthority(
-      key,
-      current.storeVersion,
-      {
-        kind: 'put',
-        generationTransition: 'preserve',
-        payload: replaceServiceRelocationAuthorityApplicationPayload(
-          current.payload,
-          encodeServiceInstanceAuthorityPayload({
-            state: 'closing',
-            stableType: decoded.stableType,
-            spotId: decoded.spotId,
-            ownerId: decoded.ownerId,
-            ownerLeaseGeneration: decoded.ownerLeaseGeneration,
-            ownerMeshName: decoded.ownerMeshName,
-            ownerNodeRid: decoded.ownerNodeRid,
-            ownerNodeGeneration: decoded.ownerNodeGeneration
-          })
-        )
-      }
-    );
+    const result = await store.compareExchangeAuthority(key, current.storeVersion, {
+      kind: 'put',
+      generationTransition: 'preserve',
+      payload: replaceServiceRelocationAuthorityApplicationPayload(
+        current.payload,
+        encodeServiceInstanceAuthorityPayload({
+          state: 'closing',
+          stableType: decoded.stableType,
+          spotId: decoded.spotId,
+          ownerId: decoded.ownerId,
+          ownerLeaseGeneration: decoded.ownerLeaseGeneration,
+          ownerMeshName: decoded.ownerMeshName,
+          ownerNodeRid: decoded.ownerNodeRid,
+          ownerNodeGeneration: decoded.ownerNodeGeneration
+        })
+      )
+    });
     if (result.kind !== 'stored') {
       return undefined;
     }
@@ -178,27 +171,23 @@ export class ZLinkSpotLocationClaims {
     return {
       restoreReady: async () => {
         if (restored) return;
-        const restore = await store.compareExchangeAuthority(
-          key,
-          result.storeVersion,
-          {
-            kind: 'put',
-            generationTransition: 'preserve',
-            payload: replaceServiceRelocationAuthorityApplicationPayload(
-              current.payload,
-              encodeServiceInstanceAuthorityPayload({
-                state: 'ready',
-                stableType: decoded.stableType,
-                spotId: decoded.spotId,
-                ownerId: decoded.ownerId,
-                ownerLeaseGeneration: decoded.ownerLeaseGeneration,
-                ownerMeshName: decoded.ownerMeshName,
-                ownerNodeRid: decoded.ownerNodeRid,
-                ownerNodeGeneration: decoded.ownerNodeGeneration
-              })
-            )
-          }
-        );
+        const restore = await store.compareExchangeAuthority(key, result.storeVersion, {
+          kind: 'put',
+          generationTransition: 'preserve',
+          payload: replaceServiceRelocationAuthorityApplicationPayload(
+            current.payload,
+            encodeServiceInstanceAuthorityPayload({
+              state: 'ready',
+              stableType: decoded.stableType,
+              spotId: decoded.spotId,
+              ownerId: decoded.ownerId,
+              ownerLeaseGeneration: decoded.ownerLeaseGeneration,
+              ownerMeshName: decoded.ownerMeshName,
+              ownerNodeRid: decoded.ownerNodeRid,
+              ownerNodeGeneration: decoded.ownerNodeGeneration
+            })
+          )
+        });
         if (restore.kind !== 'stored') {
           throw createInternalFrameworkException(
             ZLinkFrameworkInternalErrorKind.SpotMoving,
@@ -243,10 +232,12 @@ export class ZLinkSpotLocationClaims {
             spotId: tracked.row.spotId
           });
           if (this.spots.get(canonical) !== tracked) continue;
-          if (current === undefined
-            || current.ownerId !== owner.ownerId
-            || (current.leaseGeneration !== tracked.row.leaseGeneration
-              && current.leaseGeneration !== owner.leaseGeneration)) {
+          if (
+            current === undefined ||
+            current.ownerId !== owner.ownerId ||
+            (current.leaseGeneration !== tracked.row.leaseGeneration &&
+              current.leaseGeneration !== owner.leaseGeneration)
+          ) {
             if (this.spots.get(canonical) !== tracked) continue;
             this.spots.delete(canonical);
             await tracked.deactivate?.();
@@ -258,14 +249,13 @@ export class ZLinkSpotLocationClaims {
             continue;
           }
           if (this.spots.get(canonical) !== tracked) continue;
-          const result = await this.runtime.writeSpot(
-            current,
-            ZLinkLocationWriteIntent.Takeover
-          );
+          const result = await this.runtime.writeSpot(current, ZLinkLocationWriteIntent.Takeover);
           if (result.status !== ZLinkLocationWriteStatus.Stored) {
-            failures.push(new Error(
-              `Spot location recovery for '${tracked.row.spotId}' was rejected with status ${result.status}.`
-            ));
+            failures.push(
+              new Error(
+                `Spot location recovery for '${tracked.row.spotId}' was rejected with status ${result.status}.`
+              )
+            );
             continue;
           }
           if (this.spots.get(canonical) !== tracked) continue;
@@ -282,9 +272,12 @@ export class ZLinkSpotLocationClaims {
         const key = encodeAuthorityKey('instance_spot', String(tracked.spotId));
         const current = await this.authorityStore?.readAuthority(key);
         if (this.spots.get(canonical) !== tracked) continue;
-        if (current === undefined || current.kind === 'missing'
-          || !matchesTrackedAuthorityIdentity(current, tracked)
-          || current.ownerId !== owner.ownerId) {
+        if (
+          current === undefined ||
+          current.kind === 'missing' ||
+          !matchesTrackedAuthorityIdentity(current, tracked) ||
+          current.ownerId !== owner.ownerId
+        ) {
           if (this.spots.get(canonical) !== tracked) continue;
           this.spots.delete(canonical);
           await tracked.deactivate?.();
@@ -306,9 +299,11 @@ export class ZLinkSpotLocationClaims {
             }
           );
           if (rebound.kind !== 'stored') {
-            failures.push(new Error(
-              `Instance Spot '${String(tracked.spotId)}' authority recovery returned '${rebound.kind}'.`
-            ));
+            failures.push(
+              new Error(
+                `Instance Spot '${String(tracked.spotId)}' authority recovery returned '${rebound.kind}'.`
+              )
+            );
             continue;
           }
           if (this.spots.get(canonical) !== tracked) continue;
@@ -337,26 +332,25 @@ export class ZLinkSpotLocationClaims {
       { kind: 'delete' }
     );
     if (
-      result.kind === 'conflict'
-      && result.current.kind === 'snapshot'
-      && matchesTrackedAuthority(result.current, tracked)
+      result.kind === 'conflict' &&
+      result.current.kind === 'snapshot' &&
+      matchesTrackedAuthority(result.current, tracked)
     ) {
-      result = await store.compareExchangeAuthority(
-        key,
-        result.current.storeVersion,
-        { kind: 'delete' }
-      );
+      result = await store.compareExchangeAuthority(key, result.current.storeVersion, {
+        kind: 'delete'
+      });
     }
     if (
-      result.kind === 'conflict'
-      && result.current.kind === 'snapshot'
-      && !matchesTrackedAuthority(result.current, tracked)
+      result.kind === 'conflict' &&
+      result.current.kind === 'snapshot' &&
+      !matchesTrackedAuthority(result.current, tracked)
     ) {
       return;
     }
-    if (result.kind === 'deleted' || (
-      result.kind === 'conflict' && result.current.kind === 'missing'
-    )) {
+    if (
+      result.kind === 'deleted' ||
+      (result.kind === 'conflict' && result.current.kind === 'missing')
+    ) {
       return;
     }
     if (result.kind === 'generationExhausted') {
@@ -408,28 +402,32 @@ function matchesTrackedAuthority(
   snapshot: ZLinkAuthoritySnapshot,
   tracked: TrackedAuthoritySpot
 ): boolean {
-  return snapshot.objectGeneration === tracked.objectGeneration
-    && snapshot.authorityOwnerGeneration === tracked.authorityOwnerGeneration
-    && snapshot.ownerId === tracked.ownerId
-    && snapshot.ownerLeaseGeneration === tracked.ownerLeaseGeneration
-    && snapshot.allocation.state === 'active'
-    && snapshot.allocation.objectKind === 'instance_spot'
-    && snapshot.allocation.stableType === tracked.stableType
-    && snapshot.allocation.descriptor.meshName === tracked.meshName
-    && routingIdsEqual(snapshot.allocation.descriptor.rid, tracked.nodeRid)
-    && snapshot.allocation.descriptorLifecycleGeneration === tracked.nodeGeneration;
+  return (
+    snapshot.objectGeneration === tracked.objectGeneration &&
+    snapshot.authorityOwnerGeneration === tracked.authorityOwnerGeneration &&
+    snapshot.ownerId === tracked.ownerId &&
+    snapshot.ownerLeaseGeneration === tracked.ownerLeaseGeneration &&
+    snapshot.allocation.state === 'active' &&
+    snapshot.allocation.objectKind === 'instance_spot' &&
+    snapshot.allocation.stableType === tracked.stableType &&
+    snapshot.allocation.descriptor.meshName === tracked.meshName &&
+    routingIdsEqual(snapshot.allocation.descriptor.rid, tracked.nodeRid) &&
+    snapshot.allocation.descriptorLifecycleGeneration === tracked.nodeGeneration
+  );
 }
 
 function matchesTrackedAuthorityIdentity(
   snapshot: ZLinkAuthoritySnapshot,
   tracked: TrackedAuthoritySpot
 ): boolean {
-  return snapshot.objectGeneration === tracked.objectGeneration
-    && snapshot.authorityOwnerGeneration === tracked.authorityOwnerGeneration
-    && snapshot.allocation.state === 'active'
-    && snapshot.allocation.objectKind === 'instance_spot'
-    && snapshot.allocation.stableType === tracked.stableType
-    && snapshot.allocation.descriptor.meshName === tracked.meshName
-    && routingIdsEqual(snapshot.allocation.descriptor.rid, tracked.nodeRid)
-    && snapshot.allocation.descriptorLifecycleGeneration === tracked.nodeGeneration;
+  return (
+    snapshot.objectGeneration === tracked.objectGeneration &&
+    snapshot.authorityOwnerGeneration === tracked.authorityOwnerGeneration &&
+    snapshot.allocation.state === 'active' &&
+    snapshot.allocation.objectKind === 'instance_spot' &&
+    snapshot.allocation.stableType === tracked.stableType &&
+    snapshot.allocation.descriptor.meshName === tracked.meshName &&
+    routingIdsEqual(snapshot.allocation.descriptor.rid, tracked.nodeRid) &&
+    snapshot.allocation.descriptorLifecycleGeneration === tracked.nodeGeneration
+  );
 }

package/src/runtime/messaging/creation-payload-codec.ts

@@ -1,4 +1,7 @@
-import { ZLinkFrameworkInternalErrorKind, createInternalFrameworkException } from '../framework-errors-internal';
+import {
+  ZLinkFrameworkInternalErrorKind,
+  createInternalFrameworkException
+} from '../framework-errors-internal';
 import { ZLinkBufferMessage as RuntimeMessage } from '../backend/runtime-message';
 import type { ZLinkMessageSerializer } from '../../contracts';
 import {

package/src/runtime/messaging/framework-json-v1.ts

@@ -45,9 +45,9 @@ function frameworkJsonV1Replacer(
     throw new TypeError('framework-json-v1 does not implicitly encode Date values.');
   }
   if (
-    typeof source === 'object'
-    && source !== null
-    && typeof (source as { readonly toJSON?: unknown }).toJSON === 'function'
+    typeof source === 'object' &&
+    source !== null &&
+    typeof (source as { readonly toJSON?: unknown }).toJSON === 'function'
   ) {
     throw new TypeError('framework-json-v1 does not implicitly invoke custom toJSON methods.');
   }
@@ -64,9 +64,7 @@ export function parseFrameworkJsonV1(
   }
   new JsonPropertyScanner(text, options).scan();
   const parsed = JSON.parse(text);
-  return schema === undefined
-    ? parsed
-    : validateFrameworkJsonV1Value(parsed, schema, '$', true);
+  return schema === undefined ? parsed : validateFrameworkJsonV1Value(parsed, schema, '$', true);
 }
 
 //  Sticky pattern shared across scans; matching happens synchronously so the
@@ -92,10 +90,15 @@ function validateFrameworkJsonV1Value(
       if (typeof value !== 'string') schemaFailure(path, 'a string');
       return value;
     case 'number':
-      if (typeof value !== 'number' || !Number.isFinite(value)) schemaFailure(path, 'a finite number');
+      if (typeof value !== 'number' || !Number.isFinite(value))
+        schemaFailure(path, 'a finite number');
       return value;
     case 'int32':
-      if (!Number.isInteger(value) || (value as number) < INT32_MIN || (value as number) > INT32_MAX) {
+      if (
+        !Number.isInteger(value) ||
+        (value as number) < INT32_MIN ||
+        (value as number) > INT32_MAX
+      ) {
         schemaFailure(path, 'an int32 JSON number');
       }
       return value;
@@ -113,7 +116,8 @@ function validateFrameworkJsonV1Value(
         schemaFailure(path, 'padded RFC 4648 base64');
       }
       const bytes = Buffer.from(value as string, 'base64');
-      if (bytes.toString('base64') !== value) schemaFailure(path, 'canonical padded RFC 4648 base64');
+      if (bytes.toString('base64') !== value)
+        schemaFailure(path, 'canonical padded RFC 4648 base64');
       return decode ? Uint8Array.from(bytes) : value;
     }
     case 'enum':
@@ -128,7 +132,8 @@ function validateFrameworkJsonV1Value(
     case 'array':
       if (!Array.isArray(value)) schemaFailure(path, 'an array');
       return (value as unknown[]).map((item, index) =>
-        validateFrameworkJsonV1Value(item, schema.items, `${path}[${index}]`, decode));
+        validateFrameworkJsonV1Value(item, schema.items, `${path}[${index}]`, decode)
+      );
     case 'record': {
       if (!isJsonObject(value)) schemaFailure(path, 'an object');
       const result: Record<string, unknown> = {};
@@ -154,21 +159,35 @@ function validateFrameworkJsonV1Value(
           }
           continue;
         }
-        result[name] = validateFrameworkJsonV1Value(item, propertySchema as ZLinkJsonSchema, `${path}.${name}`, decode);
+        result[name] = validateFrameworkJsonV1Value(
+          item,
+          propertySchema as ZLinkJsonSchema,
+          `${path}.${name}`,
+          decode
+        );
       }
       return decode ? result : value;
     }
   }
 }
 
-function validateDecimalInteger(value: unknown, path: string, signed: boolean, decode: boolean): unknown {
+function validateDecimalInteger(
+  value: unknown,
+  path: string,
+  signed: boolean,
+  decode: boolean
+): unknown {
   if (typeof value !== 'string' || !/^(?:0|[1-9][0-9]*|-[1-9][0-9]*)$/u.test(value)) {
-    schemaFailure(path, signed ? 'a canonical int64 decimal string' : 'a canonical uint64 decimal string');
+    schemaFailure(
+      path,
+      signed ? 'a canonical int64 decimal string' : 'a canonical uint64 decimal string'
+    );
   }
   const parsed = BigInt(value as string);
   const minimum = signed ? SIGNED_64_MIN : 0n;
   const maximum = signed ? (1n << 63n) - 1n : UNSIGNED_64_MAX;
-  if (parsed < minimum || parsed > maximum) schemaFailure(path, signed ? 'an int64 value' : 'a uint64 value');
+  if (parsed < minimum || parsed > maximum)
+    schemaFailure(path, signed ? 'an int64 value' : 'a uint64 value');
   return decode ? parsed : value;
 }
 
@@ -266,7 +285,7 @@ class JsonPropertyScanner {
         //  Without escapes the token content is verbatim; the outer
         //  JSON.parse pass still rejects any raw control characters.
         return sawEscape
-          ? JSON.parse(this.text.slice(start, this.index)) as string
+          ? (JSON.parse(this.text.slice(start, this.index)) as string)
           : this.text.slice(start + 1, this.index - 1);
       }
       if (character === '\\') {

package/src/runtime/messaging/packet-name.ts

@@ -20,9 +20,10 @@ export function resolveFrameworkPacketName(
   explicitPacketName: string | undefined,
   surface: string
 ): string {
-  const packetName = normalizePacketName(explicitPacketName)
-    ?? tryDecoratorPacketName(payload)
-    ?? tryConstructorPacketName(payload);
+  const packetName =
+    normalizePacketName(explicitPacketName) ??
+    tryDecoratorPacketName(payload) ??
+    tryConstructorPacketName(payload);
   if (packetName === undefined) {
     throw new ZLinkConfigurationException(
       `${surface} packetName is required when the payload type cannot provide one.`
@@ -48,9 +49,10 @@ export function readFrameworkPacketJsonContract(
   const expectedPacketName = normalizePacketName(explicitPacketName);
   for (const metadata of readZLinkDecoratorMetadata(type)) {
     if (
-      metadata.kind === 'packet'
-      && metadata.jsonContract !== undefined
-      && (expectedPacketName === undefined || normalizePacketName(metadata.packetName) === expectedPacketName)
+      metadata.kind === 'packet' &&
+      metadata.jsonContract !== undefined &&
+      (expectedPacketName === undefined ||
+        normalizePacketName(metadata.packetName) === expectedPacketName)
     ) {
       return metadata.jsonContract;
     }

package/src/runtime/messaging/payload-codec.ts

@@ -1,4 +1,7 @@
-import { ZLinkFrameworkInternalErrorKind, createInternalFrameworkException  } from '../framework-errors-internal';
+import {
+  ZLinkFrameworkInternalErrorKind,
+  createInternalFrameworkException
+} from '../framework-errors-internal';
 import { ZLinkBufferMessage as RuntimeMessage } from '../backend/runtime-message';
 import {
   isZLinkMessage,
@@ -13,18 +16,15 @@ import {
   materializeZLinkMessageValue,
   readZLinkMessageDeclaredType
 } from '../../contracts/Common/ZLinkMessage';
-import { adoptEncodedPayload, borrowEncodedPayload } from '../../contracts/Common/encoded-payload-storage';
-import { ZLinkConfigurationException } from '../configuration';
 import {
-  parseFrameworkJsonV1,
-  stringifyFrameworkJsonV1
-} from './framework-json-v1';
+  adoptEncodedPayload,
+  borrowEncodedPayload
+} from '../../contracts/Common/encoded-payload-storage';
+import { ZLinkConfigurationException } from '../configuration';
+import { parseFrameworkJsonV1, stringifyFrameworkJsonV1 } from './framework-json-v1';
 import type { ZLinkJsonSchema } from '../../contracts/Handlers/JsonContract';
 import { readZLinkPacketJsonContract } from '../../contracts/Handlers/Attributes';
-import {
-  readFrameworkPacketJsonContract,
-  resolveFrameworkPacketJsonContract
-} from './packet-name';
+import { readFrameworkPacketJsonContract, resolveFrameworkPacketJsonContract } from './packet-name';
 import { isCanonicalCodecContentType } from '../../contracts/Configuration/CodecContentType';
 import {
   codecSerializerSelectionsOf,
@@ -82,7 +82,10 @@ export function encodeFrameworkPayload(
   if (isZLinkMessage(payload)) {
     if (payload.isEncoded()) {
       return {
-        message: rememberContentType(toRuntimeMessage(payload.toEncodedPayload()), 'application/octet-stream'),
+        message: rememberContentType(
+          toRuntimeMessage(payload.toEncodedPayload()),
+          'application/octet-stream'
+        ),
         contentType: 'application/octet-stream'
       };
     }
@@ -113,11 +116,17 @@ export function encodeFrameworkPayload(
 
   return {
     message: rememberContentType(
-      RuntimeMessage.fromOwned(Buffer.from(stringifyFrameworkJsonV1(
-        payload,
-        (resolveFrameworkPacketJsonContract(payload, packetName)
-          ?? (packetName === undefined ? undefined : readZLinkPacketJsonContract(packetName)))?.[contractPart]
-      ))),
+      RuntimeMessage.fromOwned(
+        Buffer.from(
+          stringifyFrameworkJsonV1(
+            payload,
+            (resolveFrameworkPacketJsonContract(payload, packetName) ??
+              (packetName === undefined ? undefined : readZLinkPacketJsonContract(packetName)))?.[
+              contractPart
+            ]
+          )
+        )
+      ),
       JSON_CONTENT_TYPE
     ),
     contentType: JSON_CONTENT_TYPE
@@ -194,7 +203,8 @@ export function wrapFrameworkPayloadMessage(
 ): ZLinkMessage {
   const payload = encodedPayloadFromOwned(message.data());
   return createZLinkMessageFromEncoded(payload, <T>(type?: Type<T>) =>
-    decodeFrameworkEncodedPayload(payload, registry, type, contentType, packetName, contractPart));
+    decodeFrameworkEncodedPayload(payload, registry, type, contentType, packetName, contractPart)
+  );
 }
 
 function decodeFrameworkEncodedPayload<T>(
@@ -217,11 +227,10 @@ function decodeFrameworkEncodedPayload<T>(
   if (payload.isEmpty()) return undefined as T;
   const text = payload.getString('utf8');
   try {
-    return materializeZLinkMessageValue(parseFrameworkJsonV1(
-      text,
-      {},
-      schemaForDecode(type, packetName, contractPart)
-    ) as T, type);
+    return materializeZLinkMessageValue(
+      parseFrameworkJsonV1(text, {}, schemaForDecode(type, packetName, contractPart)) as T,
+      type
+    );
   } catch (error) {
     throw createInternalFrameworkException(
       ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed,
@@ -237,10 +246,12 @@ function schemaForDecode(
   packetName: string | undefined,
   contractPart: 'payload' | 'reply'
 ): ZLinkJsonSchema | undefined {
-  const contract = type === undefined
-    ? undefined
-    : readFrameworkPacketJsonContract(type, packetName);
-  return (contract ?? (packetName === undefined ? undefined : readZLinkPacketJsonContract(packetName)))?.[contractPart];
+  const contract =
+    type === undefined ? undefined : readFrameworkPacketJsonContract(type, packetName);
+  return (contract ??
+    (packetName === undefined ? undefined : readZLinkPacketJsonContract(packetName)))?.[
+    contractPart
+  ];
 }
 
 export function selectDefaultSerializer(
@@ -262,9 +273,7 @@ export function selectSerializerWithContentType(
   registry?: ZLinkSerializerRegistryLike | ReadonlyMap<string, ZLinkMessageSerializer>,
   declaredType?: Type
 ): ZLinkSerializerSelectionEntry | undefined {
-  return serializerSelectionPlanOf(registry)?.select(
-    declaredType ?? outboundBusinessType(value)
-  );
+  return serializerSelectionPlanOf(registry)?.select(declaredType ?? outboundBusinessType(value));
 }
 
 function serializerSelectionPlanOf(
@@ -321,17 +330,21 @@ function serializerSelectionPlanOf(
 function outboundBusinessType(value: unknown): Type | undefined {
   if (value === null || value === undefined) return undefined;
   switch (typeof value) {
-    case 'string': return String as unknown as Type;
-    case 'number': return Number as unknown as Type;
-    case 'boolean': return Boolean as unknown as Type;
-    case 'bigint': return BigInt as unknown as Type;
-    case 'symbol': return Symbol as unknown as Type;
-    case 'function': return Function as unknown as Type;
+    case 'string':
+      return String as unknown as Type;
+    case 'number':
+      return Number as unknown as Type;
+    case 'boolean':
+      return Boolean as unknown as Type;
+    case 'bigint':
+      return BigInt as unknown as Type;
+    case 'symbol':
+      return Symbol as unknown as Type;
+    case 'function':
+      return Function as unknown as Type;
     case 'object': {
       const constructor = (value as { constructor?: unknown }).constructor;
-      return typeof constructor === 'function'
-        ? constructor as Type
-        : Object as Type;
+      return typeof constructor === 'function' ? (constructor as Type) : (Object as Type);
     }
   }
   throw new TypeError('Unsupported payload type.');
@@ -365,15 +378,20 @@ function unsupportedContentType(contentType: string): Error {
   );
 }
 
-function parseJsonPayload(message: Message, schema?: ZLinkJsonSchema): {
-  readonly valid: true;
-  readonly value: unknown;
-  readonly error?: undefined;
-} | {
-  readonly valid: false;
-  readonly value?: undefined;
-  readonly error: unknown;
-} {
+function parseJsonPayload(
+  message: Message,
+  schema?: ZLinkJsonSchema
+):
+  | {
+      readonly valid: true;
+      readonly value: unknown;
+      readonly error?: undefined;
+    }
+  | {
+      readonly valid: false;
+      readonly value?: undefined;
+      readonly error: unknown;
+    } {
   try {
     return { valid: true, value: parseFrameworkJsonV1(message.getString('utf8'), {}, schema) };
   } catch (error) {
@@ -391,9 +409,11 @@ function serializerMapOf(
 }
 
 function isMessage(value: unknown): value is Message {
-  return typeof value === 'object'
-    && value !== null
-    && typeof (value as { data?: unknown }).data === 'function';
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    typeof (value as { data?: unknown }).data === 'function'
+  );
 }
 
 function toRuntimeMessage(payload: ZLinkEncodedPayload): Message {