@zlink-systems/framework 0.30.0 → 0.30.1

package/src/runtime/host/spot-address-transport.ts

@@ -336,7 +336,8 @@ export class ZLinkHostSpotAddressTransport implements ZLinkSpotAddressTransport
         instanceSpot: call.instanceSpot,
         timeoutMs: deadline.requireRemaining(),
         signal: deadline.signal,
-        metadata: call.metadata
+        metadata: call.metadata,
+        onAdmitted: call.onAdmitted
       }),
       deadline.signal
     );
@@ -416,7 +417,8 @@ export class ZLinkHostSpotAddressTransport implements ZLinkSpotAddressTransport
           encoded,
           deadlineUnixMs,
           call.sourceSpot === undefined ? undefined : String(call.sourceSpot.routingId),
-          call.metadata
+          call.metadata,
+          call.onAdmitted
         ),
       deadline.signal
     );

package/src/runtime/host/spot-runtime-options-factory.ts

@@ -333,6 +333,8 @@ export class ZLinkSpotRuntimeOptionsFactory {
         );
       },
       actorTransferRuntime,
+      releaseActorMembers: (meshName, spotId) =>
+        this.options.actorManager()?.releaseSpotActorMembers(meshName, spotId) ?? Promise.resolve(),
       boundSessionRuntime: this.options.boundSessionRelay.boundSessions,
       actorHandoffRuntime: this.options.actorHandoff,
       metrics: this.options.metrics,

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

@@ -12,6 +12,10 @@ import { ZLinkSpotKind } from '../../contracts/Spots';
 import { ZLinkLocationKeyCodec } from './key-codec';
 import { encodeAuthorityKey } from './authority-key-codec';
 import { routingIdsEqual } from '../routing-id';
+import {
+  decodeActorAuthorityIdentity,
+  rewriteActorAuthorityRoute
+} from '../actors/actor-authority-publication';
 import type { IZLinkLocationLifecycleRuntime, ZLinkOwnershipLostEvent } from './lifecycle-runtime';
 
 export enum ZLinkActorClaimStatus {
@@ -203,41 +207,59 @@ export class ZLinkActorLocationClaims {
     return { status: ZLinkActorClaimStatus.Claimed, claimed, generation: result.generation };
   }
 
-  async notifyJoinedSpot(
+  async commitMembership(
     actorType: string,
-    actorId: string,
-    _spotMeshName: string,
+    actorRef: ActorRef,
+    authorityOwnerGeneration: bigint,
     spotId: RoutingId,
     spotGeneration: bigint,
-    membershipEpoch: bigint,
+    spotKind: ZLinkSpotKind.Entry | ZLinkSpotKind.User,
     ownerNodeGeneration: bigint
   ): Promise<void> {
-    await this.renew(actorType, actorId, (row) => ({
-      ...row,
-      spotKind: ZLinkSpotKind.User,
-      spotId,
-      spotGeneration,
-      membershipEpoch,
-      ownerNodeGeneration
-    }));
-  }
-
-  async notifyLeftSpot(
-    actorType: string,
-    actorId: string,
-    entrySpotId: RoutingId,
-    entrySpotGeneration: bigint,
-    membershipEpoch: bigint,
-    ownerNodeGeneration: bigint
-  ): Promise<void> {
-    await this.renew(actorType, actorId, (row) => ({
-      ...row,
-      spotKind: ZLinkSpotKind.Entry,
-      spotId: entrySpotId,
-      spotGeneration: entrySpotGeneration,
-      membershipEpoch,
-      ownerNodeGeneration
-    }));
+    const actorId = actorRef.actorId;
+    const store = this.authorityStore;
+    const owner = this.runtime.currentOwnerToken;
+    if (store === undefined || owner === undefined) {
+      throw new Error('Actor membership commit requires Location Store authority and owner.');
+    }
+    const key = encodeAuthorityKey('actor', actorId);
+    const current = await store.readAuthority(key);
+    if (
+      !matchesActorAuthority(current, actorRef, owner) ||
+      current.allocation.stableType !== actorType ||
+      current.authorityOwnerGeneration !== authorityOwnerGeneration ||
+      current.allocation.descriptorLifecycleGeneration !== ownerNodeGeneration
+    ) {
+      throw new Error(`Actor '${actorId}' membership authority fence does not match.`);
+    }
+    const identity = decodeActorAuthorityIdentity(current.payload, current.objectGeneration);
+    if (
+      identity === undefined ||
+      identity.actorType !== actorType ||
+      identity.ownerNodeGeneration !== ownerNodeGeneration ||
+      identity.owner.ownerId !== owner.ownerId ||
+      identity.owner.leaseGeneration !== owner.leaseGeneration ||
+      !routingIdsEqual(identity.actor.nodeRid, actorRef.nodeRid) ||
+      identity.meshName !== actorRef.meshName
+    ) {
+      throw new Error(`Actor '${actorId}' membership authority identity does not match.`);
+    }
+    const result = await store.compareExchangeAuthority(key, current.storeVersion, {
+      kind: 'put',
+      generationTransition: 'preserve',
+      payload: rewriteActorAuthorityRoute(
+        current.payload,
+        actorRef,
+        String(spotId),
+        spotGeneration,
+        spotKind
+      )
+    });
+    if (result.kind !== 'stored') {
+      throw new Error(
+        `Actor '${actorId}' membership commit was rejected with status ${result.kind}.`
+      );
+    }
   }
 
   async release(_actorType: string, actorId: string, actorRef?: ActorRef): Promise<void> {

package/src/runtime/locations/lifecycle.ts

@@ -118,40 +118,22 @@ export class ZLinkLocationLifecycle {
     );
   }
 
-  async notifyActorJoinedSpot(
+  async commitActorMembership(
     actorType: string,
-    actorId: string,
-    spotMeshName: string,
+    actorRef: ActorRef,
+    authorityOwnerGeneration: bigint,
     spotId: RoutingId,
     spotGeneration: bigint,
-    membershipEpoch: bigint,
+    spotKind: ZLinkSpotKind.Entry | ZLinkSpotKind.User,
     ownerNodeGeneration: bigint
   ): Promise<void> {
-    await this.actorClaims.notifyJoinedSpot(
+    await this.actorClaims.commitMembership(
       actorType,
-      actorId,
-      spotMeshName,
+      actorRef,
+      authorityOwnerGeneration,
       spotId,
       spotGeneration,
-      membershipEpoch,
-      ownerNodeGeneration
-    );
-  }
-
-  async notifyActorLeftSpot(
-    actorType: string,
-    actorId: string,
-    entrySpotId: RoutingId,
-    entrySpotGeneration: bigint,
-    membershipEpoch: bigint,
-    ownerNodeGeneration: bigint
-  ): Promise<void> {
-    await this.actorClaims.notifyLeftSpot(
-      actorType,
-      actorId,
-      entrySpotId,
-      entrySpotGeneration,
-      membershipEpoch,
+      spotKind,
       ownerNodeGeneration
     );
   }

package/src/runtime/locations/runtime.ts

@@ -162,7 +162,7 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
     readonly name: string;
   }[];
   private readonly rewriteAuthorityPayloadForOwner?: ZLinkLocationRuntimeOptions['rewriteAuthorityPayloadForOwner'];
-  private nextLeaseRenewAtMs?: number;
+  private leaseOperationStartedAtMs = 0;
   private ownerToken?: ZLinkLocationOwnerToken;
   private lastOwnerToken?: ZLinkLocationOwnerToken;
   private ownerLeaseDeadlineMs?: number;
@@ -342,12 +342,7 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
     const claim = this.renewOwnerLeaseOnce(signal, shutdownSignal);
     this.heartbeatRenewal = claim;
     try {
-      const claimed = await claim;
-      if (claimed) {
-        this.scheduleHeartbeat();
-        return;
-      }
-      this.nextLeaseRenewAtMs = this.monotonicNowMs() + this.options.ownerLeaseRenewIntervalMs;
+      await claim;
       this.scheduleHeartbeat();
     } catch (error) {
       this.started = false;
@@ -362,7 +357,7 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
       this.clearTimer(this.heartbeatTimer);
       this.heartbeatTimer = undefined;
     }
-    this.nextLeaseRenewAtMs = undefined;
+    this.leaseOperationStartedAtMs = 0;
     this.ownerLeaseDeadlineMs = undefined;
     await this.cleanupOwner(signal);
   }
@@ -422,6 +417,7 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
     const wasOwnerLeaseUsable = this.ownerLeaseUsable;
     try {
       const renewStartedAtMs = this.monotonicNowMs();
+      this.leaseOperationStartedAtMs = renewStartedAtMs;
       const result = await withTimeout(
         (renewSignal) =>
           this.stores.ownerLeaseStore.renewOwnerLease(
@@ -475,10 +471,15 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
     shutdownSignal?: () => AbortSignal
   ): Promise<boolean> {
     const claimStartedAtMs = this.monotonicNowMs();
-    const timeoutDeadline = performance.now() + this.options.ownerLeaseRenewTimeoutMs;
+    this.leaseOperationStartedAtMs = claimStartedAtMs;
+    const timeoutStartedAtMs = performance.now();
     let claim: Awaited<ReturnType<ZLinkOwnerLeaseStore['claimOwnerLease']>>;
     try {
-      claim = await this.claimOwnerLeaseWithConfirmation(timeoutDeadline, signal, shutdownSignal);
+      claim = await this.claimOwnerLeaseWithConfirmation(
+        timeoutStartedAtMs,
+        signal,
+        shutdownSignal
+      );
     } catch (error) {
       if (signal?.aborted === true) throw error;
       if (error instanceof ZLinkOwnerLeaseClaimError) throw error;
@@ -508,7 +509,6 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
         claim.storeNow
       );
       this.lastError = undefined;
-      this.nextLeaseRenewAtMs = this.monotonicNowMs() + this.options.ownerLeaseRenewIntervalMs;
       for (const handler of this.ownerLeaseRenewedHandlers) {
         handler({
           kind: 'renewed',
@@ -525,7 +525,7 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
   }
 
   private async claimOwnerLeaseWithConfirmation(
-    timeoutDeadline: number,
+    timeoutStartedAtMs: number,
     signal?: AbortSignal,
     shutdownSignal?: () => AbortSignal
   ): Promise<Awaited<ReturnType<ZLinkOwnerLeaseStore['claimOwnerLease']>>> {
@@ -540,7 +540,7 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
             this.options.ownerLeaseTtlMs,
             claimSignal
           )),
-        remainingTimeoutMs(timeoutDeadline),
+        remainingTimeoutMs(timeoutStartedAtMs, this.options.ownerLeaseRenewTimeoutMs),
         signal
       );
     } catch (error) {
@@ -550,7 +550,9 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
         try {
           await withTimeout(
             () => request!,
-            cleanupSignal === undefined ? remainingTimeoutMs(timeoutDeadline) : undefined,
+            cleanupSignal === undefined
+              ? remainingTimeoutMs(timeoutStartedAtMs, this.options.ownerLeaseRenewTimeoutMs)
+              : undefined,
             cleanupSignal
           );
         } catch (completionError) {
@@ -567,7 +569,7 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
       }
       const confirmed = await this.confirmOwnerLease(
         error,
-        timeoutDeadline,
+        timeoutStartedAtMs,
         signal,
         shutdownSignal
       );
@@ -577,13 +579,13 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
     if (claim.kind !== 'conflict') return claim;
     const conflict = new ZLinkOwnerLeaseClaimError(claim.kind);
     return (
-      (await this.confirmOwnerLease(conflict, timeoutDeadline, signal, shutdownSignal)) ?? claim
+      (await this.confirmOwnerLease(conflict, timeoutStartedAtMs, signal, shutdownSignal)) ?? claim
     );
   }
 
   private async confirmOwnerLease(
     originalError: unknown,
-    timeoutDeadline: number,
+    timeoutStartedAtMs: number,
     signal?: AbortSignal,
     shutdownSignal?: () => AbortSignal
   ): Promise<
@@ -593,7 +595,9 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
     const cancelled = signal?.aborted === true;
     const cleanupSignal = cancelled ? shutdownSignal?.() : undefined;
     const confirmationTimeoutMs =
-      cleanupSignal === undefined ? remainingTimeoutMs(timeoutDeadline) : undefined;
+      cleanupSignal === undefined
+        ? remainingTimeoutMs(timeoutStartedAtMs, this.options.ownerLeaseRenewTimeoutMs)
+        : undefined;
     if (confirmationTimeoutMs !== undefined && confirmationTimeoutMs <= 0) throw originalError;
     let confirmed: Awaited<ReturnType<ZLinkOwnerLeaseStore['readOwnerLease']>>;
     try {
@@ -615,7 +619,9 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
         await withTimeout(
           (releaseSignal) =>
             this.stores.ownerLeaseStore.releaseOwnerLease(confirmed.token, releaseSignal),
-          cleanupSignal === undefined ? remainingTimeoutMs(timeoutDeadline) : undefined,
+          cleanupSignal === undefined
+            ? remainingTimeoutMs(timeoutStartedAtMs, this.options.ownerLeaseRenewTimeoutMs)
+            : undefined,
           cleanupSignal
         );
       } catch (releaseError) {
@@ -1250,8 +1256,7 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
     if (!this.started) {
       return;
     }
-    const scheduledAt =
-      this.nextLeaseRenewAtMs ?? this.monotonicNowMs() + this.options.ownerLeaseRenewIntervalMs;
+    const scheduledAt = this.leaseOperationStartedAtMs + this.options.ownerLeaseRenewIntervalMs;
     const delayMs = Math.max(0, scheduledAt - this.monotonicNowMs());
     this.heartbeatTimer = this.setTimer(() => {
       this.heartbeatTimer = undefined;
@@ -1259,7 +1264,6 @@ export class ZLinkLocationRuntime implements ZLinkLocationRuntimeQuery {
       for (const scope of this.leaseScopes) {
         this.metrics?.recordOwnerLeaseRenewLateness(lateness, scope.kind, scope.name);
       }
-      this.nextLeaseRenewAtMs = this.monotonicNowMs() + this.options.ownerLeaseRenewIntervalMs;
       if (
         this.ownerLeaseDeadlineMs !== undefined &&
         this.monotonicNowMs() >= this.ownerLeaseDeadlineMs
@@ -1413,8 +1417,8 @@ class OwnerLeaseRenewTimeoutError extends Error {
   }
 }
 
-function remainingTimeoutMs(timeoutDeadline: number): number {
-  return Math.max(0, timeoutDeadline - performance.now());
+function remainingTimeoutMs(timeoutStartedAtMs: number, timeoutMs: number): number {
+  return Math.max(0, timeoutMs - (performance.now() - timeoutStartedAtMs));
 }
 
 function errorMessage(error: unknown): string {

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

@@ -1,326 +1,6 @@
-import type { ZLinkJsonSchema } from '../../contracts/Handlers/JsonContract';
+import * as profile from '@zlink-systems/stream-wire/internal/json';
 
-export const FRAMEWORK_JSON_V1_PROFILE = 'framework-json-v1';
-
-const SIGNED_64_MIN = -(1n << 63n);
-const UNSIGNED_64_MAX = (1n << 64n) - 1n;
-
-export interface FrameworkJsonParseOptions {
-  readonly rejectPropertyName?: (name: string) => boolean;
-}
-
-export function stringifyFrameworkJsonV1(value: unknown, schema?: ZLinkJsonSchema): string {
-  if (value === undefined || typeof value === 'function' || typeof value === 'symbol') {
-    throw new TypeError('framework-json-v1 payload is not a JSON value.');
-  }
-  const encoded = JSON.stringify(value, frameworkJsonV1Replacer);
-  if (schema !== undefined) {
-    validateFrameworkJsonV1Value(JSON.parse(encoded), schema, '$', false);
-  }
-  return encoded;
-}
-
-//  Module-level so JSON.stringify does not allocate a fresh closure per
-//  encoded message. On the root call `this` is the {'': value} wrapper, so
-//  this[key] resolves the raw (pre-toJSON) source for every key including ''.
-function frameworkJsonV1Replacer(
-  this: Record<string, unknown>,
-  key: string,
-  item: unknown
-): unknown {
-  const source = this[key];
-  if (typeof source === 'number' && !Number.isFinite(source)) {
-    throw new TypeError('framework-json-v1 only accepts finite JSON numbers.');
-  }
-  if (typeof source === 'bigint') {
-    if (source < SIGNED_64_MIN || source > UNSIGNED_64_MAX) {
-      throw new RangeError('framework-json-v1 64-bit integer is outside the supported range.');
-    }
-    return source.toString(10);
-  }
-  if (source instanceof Uint8Array) {
-    return Buffer.from(source.buffer, source.byteOffset, source.byteLength).toString('base64');
-  }
-  if (source instanceof Date) {
-    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'
-  ) {
-    throw new TypeError('framework-json-v1 does not implicitly invoke custom toJSON methods.');
-  }
-  return item;
-}
-
-export function parseFrameworkJsonV1(
-  text: string,
-  options: FrameworkJsonParseOptions = {},
-  schema?: ZLinkJsonSchema
-): unknown {
-  if (text.charCodeAt(0) === 0xfeff) {
-    throw new SyntaxError('framework-json-v1 does not allow a UTF-8 BOM.');
-  }
-  new JsonPropertyScanner(text, options).scan();
-  const parsed = JSON.parse(text);
-  return schema === undefined ? parsed : validateFrameworkJsonV1Value(parsed, schema, '$', true);
-}
-
-//  Sticky pattern shared across scans; matching happens synchronously so the
-//  mutable lastIndex never crosses calls.
-const NUMBER_TOKEN_PATTERN = /-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?/uy;
-
-const BASE64_PATTERN = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u;
-const INT32_MIN = -2_147_483_648;
-const INT32_MAX = 2_147_483_647;
-const UINT32_MAX = 4_294_967_295;
-
-function validateFrameworkJsonV1Value(
-  value: unknown,
-  schema: ZLinkJsonSchema,
-  path: string,
-  decode: boolean
-): unknown {
-  switch (schema.type) {
-    case 'boolean':
-      if (typeof value !== 'boolean') schemaFailure(path, 'a boolean');
-      return value;
-    case 'string':
-      if (typeof value !== 'string') schemaFailure(path, 'a string');
-      return value;
-    case '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
-      ) {
-        schemaFailure(path, 'an int32 JSON number');
-      }
-      return value;
-    case 'uint32':
-      if (!Number.isInteger(value) || (value as number) < 0 || (value as number) > UINT32_MAX) {
-        schemaFailure(path, 'a uint32 JSON number');
-      }
-      return value;
-    case 'int64':
-      return validateDecimalInteger(value, path, true, decode);
-    case 'uint64':
-      return validateDecimalInteger(value, path, false, decode);
-    case 'bytes': {
-      if (typeof value !== 'string' || !BASE64_PATTERN.test(value)) {
-        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');
-      return decode ? Uint8Array.from(bytes) : value;
-    }
-    case 'enum':
-      if (typeof value !== 'string' || !schema.names.includes(value)) {
-        schemaFailure(path, `one of ${schema.names.join(', ')}`);
-      }
-      return value;
-    case 'nullable':
-      return value === null
-        ? null
-        : validateFrameworkJsonV1Value(value, schema.value, path, decode);
-    case 'array':
-      if (!Array.isArray(value)) schemaFailure(path, 'an array');
-      return (value as unknown[]).map((item, index) =>
-        validateFrameworkJsonV1Value(item, schema.items, `${path}[${index}]`, decode)
-      );
-    case 'record': {
-      if (!isJsonObject(value)) schemaFailure(path, 'an object');
-      const result: Record<string, unknown> = {};
-      for (const [name, item] of Object.entries(value as Record<string, unknown>)) {
-        result[name] = validateFrameworkJsonV1Value(item, schema.values, `${path}.${name}`, decode);
-      }
-      return decode ? result : value;
-    }
-    case 'object': {
-      if (!isJsonObject(value)) schemaFailure(path, 'an object');
-      const input = value as Record<string, unknown>;
-      for (const name of schema.required) {
-        if (!Object.prototype.hasOwnProperty.call(input, name)) {
-          throw new TypeError(`framework-json-v1 required property '${path}.${name}' is missing.`);
-        }
-      }
-      const result: Record<string, unknown> = {};
-      for (const [name, item] of Object.entries(input)) {
-        const propertySchema: unknown = schema.properties[name];
-        if (propertySchema === undefined) {
-          if (schema.additionalProperties === false) {
-            throw new TypeError(`framework-json-v1 property '${path}.${name}' is not allowed.`);
-          }
-          continue;
-        }
-        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 {
-  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'
-    );
-  }
-  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');
-  return decode ? parsed : value;
-}
-
-function isJsonObject(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function schemaFailure(path: string, expected: string): never {
-  throw new TypeError(`framework-json-v1 value '${path}' must be ${expected}.`);
-}
-
-class JsonPropertyScanner {
-  private index = 0;
-
-  constructor(
-    private readonly text: string,
-    private readonly options: FrameworkJsonParseOptions
-  ) {}
-
-  scan(): void {
-    this.skipWhitespace();
-    this.scanValue();
-    this.skipWhitespace();
-    if (this.index !== this.text.length) this.fail('trailing data');
-  }
-
-  private scanValue(): void {
-    this.skipWhitespace();
-    const token = this.text[this.index];
-    if (token === '{') return this.scanObject();
-    if (token === '[') return this.scanArray();
-    if (token === '"') {
-      this.scanString();
-      return;
-    }
-    if (token === 't') return this.scanLiteral('true');
-    if (token === 'f') return this.scanLiteral('false');
-    if (token === 'n') return this.scanLiteral('null');
-    this.scanNumber();
-  }
-
-  private scanObject(): void {
-    this.index++;
-    this.skipWhitespace();
-    if (this.text[this.index] === '}') {
-      this.index++;
-      return;
-    }
-    const properties = new Set<string>();
-    for (;;) {
-      this.skipWhitespace();
-      if (this.text[this.index] !== '"') this.fail('object property name');
-      const property = this.scanString();
-      if (properties.has(property)) {
-        throw new SyntaxError(`framework-json-v1 duplicate property '${property}'.`);
-      }
-      properties.add(property);
-      if (this.options.rejectPropertyName?.(property) === true) {
-        throw new SyntaxError(`framework-json-v1 property '${property}' is not allowed.`);
-      }
-      this.skipWhitespace();
-      if (this.text[this.index] !== ':') this.fail("':' after object property");
-      this.index++;
-      this.scanValue();
-      this.skipWhitespace();
-      const delimiter = this.text[this.index++];
-      if (delimiter === '}') return;
-      if (delimiter !== ',') this.fail("',' or '}' after object property");
-    }
-  }
-
-  private scanArray(): void {
-    this.index++;
-    this.skipWhitespace();
-    if (this.text[this.index] === ']') {
-      this.index++;
-      return;
-    }
-    for (;;) {
-      this.scanValue();
-      this.skipWhitespace();
-      const delimiter = this.text[this.index++];
-      if (delimiter === ']') return;
-      if (delimiter !== ',') this.fail("',' or ']' after array item");
-    }
-  }
-
-  private scanString(): string {
-    const start = this.index++;
-    let sawEscape = false;
-    for (;;) {
-      if (this.index >= this.text.length) this.fail('unterminated string');
-      const character = this.text[this.index++]!;
-      if (character === '"') {
-        //  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)
-          : this.text.slice(start + 1, this.index - 1);
-      }
-      if (character === '\\') {
-        sawEscape = true;
-        if (this.index >= this.text.length) this.fail('unterminated escape');
-        const escaped = this.text[this.index++]!;
-        if (escaped === 'u') this.index += 4;
-      }
-    }
-  }
-
-  private scanLiteral(value: 'true' | 'false' | 'null'): void {
-    if (!this.text.startsWith(value, this.index)) this.fail(value);
-    this.index += value.length;
-  }
-
-  private scanNumber(): void {
-    NUMBER_TOKEN_PATTERN.lastIndex = this.index;
-    const match = NUMBER_TOKEN_PATTERN.exec(this.text);
-    if (match === null) this.fail('JSON value');
-    this.index += match[0].length;
-  }
-
-  private skipWhitespace(): void {
-    for (;;) {
-      const code = this.text.charCodeAt(this.index);
-      if (code === 0x20 || code === 0x09 || code === 0x0a || code === 0x0d) {
-        this.index += 1;
-        continue;
-      }
-      return;
-    }
-  }
-
-  private fail(expected: string): never {
-    throw new SyntaxError(`framework-json-v1 expected ${expected} at offset ${this.index}.`);
-  }
-}
+export const FRAMEWORK_JSON_V1_PROFILE = profile.FRAMEWORK_JSON_V1_PROFILE;
+export const stringifyFrameworkJsonV1 = profile.stringifyFrameworkJsonV1;
+export const parseFrameworkJsonV1 = profile.parseFrameworkJsonV1;
+export type { FrameworkJsonParseOptions } from '@zlink-systems/stream-wire/internal/json';