@misofm/platform 0.20.0 → 0.21.0

package/src/index.ts

@@ -49,7 +49,7 @@ export * from "./share-template.ts";
 export * from "./release-graph.ts";
 export * from "./publication.ts";
 export * from "./catalog.ts";
-export * from "./mix.ts";
+export * from "./walrus-ids.ts";
 
 // High-level, JSON-safe platform projections used directly by clients and by
 // the thin HTTP read service. Namespaced because these composed view types are
@@ -62,7 +62,6 @@ export * from "./credits.ts";
 export * from "./cover.ts";
 export * from "./release-extensions.ts";
 export * from "./recording-extensions.ts";
-export * from "./mix.ts";
 export * from "./vault.ts";
 
 // Generated, ABI-bound bindings (BCS structs + type-safe Move calls).

package/src/publication.ts

@@ -150,6 +150,20 @@ type PublicationRecordingParent =
   | { readonly parentCompositionIndex: number; readonly parentCompositionId?: never }
   | { readonly parentCompositionIndex?: never; readonly parentCompositionId: string };
 
+/** One stem a Session V1 document references, paired with its Walrus blob. */
+export interface PublicationEngineSessionStem {
+  /** 32-byte SHA-256 of the stem's canonical PCM (engine STEM_IDENTITY_V1); bytes or 64 hex chars. */
+  readonly digest: Uint8Array | string;
+  /** Unencrypted Walrus blob holding the stem's FLAC, as its on-chain `u256`. */
+  readonly blobId: bigint | string;
+}
+
+export interface PublicationEngineSession {
+  /** Unencrypted Walrus blob holding the canonical Session V1 JSON, as its on-chain `u256`. */
+  readonly sessionBlobId: bigint | string;
+  readonly stems: readonly PublicationEngineSessionStem[];
+}
+
 export type PublicationRecordingLanguages =
   | { readonly kind: "instrumental" }
   | { readonly kind: "languages"; readonly codes: string[] };
@@ -173,8 +187,8 @@ export type PublicationRecording = PublicationRecordingParent & {
   readonly masterReferenceBlobId?: bigint | string;
   /** Complete Walrus Quilt ID containing this Recording's streaming transcodes. */
   readonly streamingTranscodeQuiltId?: bigint | string;
-  /** Unencrypted Walrus blob ID of this Recording's Miso Engine session file. */
-  readonly engineSessionBlobId?: bigint | string;
+  /** This Recording's Miso Engine session: the Session V1 blob and every stem it plays. */
+  readonly engineSession?: PublicationEngineSession;
 };
 
 export interface PublicationFreshTrack {
@@ -654,7 +668,7 @@ export function publishAtomicCatalog(p: AtomicPublicationParams): TxThunk {
     );
   }
   if (
-    p.recordings.some((node) => node.engineSessionBlobId !== undefined) &&
+    p.recordings.some((node) => node.engineSession !== undefined) &&
     !p.deployment.packages.recordingEngineSession
   ) {
     throw new Error(
@@ -878,13 +892,14 @@ export function publishAtomicCatalog(p: AtomicPublicationParams): TxThunk {
         oriPackageId: p.deployment.packages.ori,
         quiltId: node.streamingTranscodeQuiltId,
       })(tx);
-      if (node.engineSessionBlobId !== undefined) setRecordingEngineSession({
+      if (node.engineSession !== undefined) setRecordingEngineSession({
         recordingId: parts.work, authority,
         recordingShareType: node.shareType,
         compositionShareType: node.compositionShareType,
         recordingEngineSessionPackageId: p.deployment.packages.recordingEngineSession!,
         oriPackageId: p.deployment.packages.ori,
-        sessionBlobId: node.engineSessionBlobId,
+        sessionBlobId: node.engineSession.sessionBlobId,
+        stems: node.engineSession.stems,
       })(tx);
     });
 

package/src/read/catalog.ts

@@ -38,10 +38,6 @@ import {
   releaseKindFieldId,
 } from "../release-extensions.ts";
 import { getRecordingMasterReferencesByIds } from "../recording-extensions.ts";
-import {
-  getReleaseMixReferences,
-  walrusBlobIdFromU256,
-} from "../mix.ts";
 import { getTrackCreditsByRecordingIds } from "../catalog.ts";
 import { getReleaseById, getReleasesByIds, isNotFound } from "@misofm/protocol";
 import type { Release } from "@misofm/protocol";
@@ -203,11 +199,9 @@ export function toTracks(
   release: Release,
   titles: Record<string, string>,
   masterBlobIds: Partial<Record<string, string>>,
-  mixBlobIds: Partial<Record<number, string>> = {},
 ): TrackView[] {
   return release.tracks.map((track, index) => {
     const masterBlobId = masterBlobIds[track.recordingId];
-    const mixBlobId = mixBlobIds[index];
     return {
       no: `${index + 1}`,
       title: titles[track.recordingId] ?? "Untitled",
@@ -216,7 +210,6 @@ export function toTracks(
       splitBps: int(track.splitBps.value),
       disc: 1,
       ...(masterBlobId ? { masterBlobId } : {}),
-      ...(mixBlobId ? { mixBlobId } : {}),
     };
   });
 }
@@ -364,8 +357,7 @@ export async function getReleaseDetail(
   );
 
   const recordingIds = release.tracks.map((track) => track.recordingId);
-  const mixPackageId = client.config.protocol.releaseMixReference;
-  const [titles, masterReferences, mixReferences, trackCredits] = await Promise.all([
+  const [titles, masterReferences, trackCredits] = await Promise.all([
     getRecordingTitles(
       client.protocol,
       client.graphql,
@@ -377,9 +369,6 @@ export async function getReleaseDetail(
       recordingIds,
       client.config.protocol.recordingMasterReference,
     ).catch(() => ({})),
-    mixPackageId
-      ? getReleaseMixReferences(client.protocol, releaseId, mixPackageId).catch(() => null)
-      : Promise.resolve(null),
     options.include?.includes("trackCredits")
       ? getTrackCreditsForRecordingIds(client, recordingIds)
       : Promise.resolve(undefined),
@@ -388,11 +377,6 @@ export async function getReleaseDetail(
   for (const [recordingId, blobId] of Object.entries(masterReferences)) {
     if (blobId) masterBlobIds[recordingId] = u256ToB64Url(blobId);
   }
-  const mixBlobIds: Record<number, string> = {};
-  for (let index = 0; index < (mixReferences?.length ?? 0); index += 1) {
-    const reference = mixReferences?.[index];
-    if (reference) mixBlobIds[index] = walrusBlobIdFromU256(reference.blobId);
-  }
 
   const creditViews = credits ?? [];
   return {
@@ -407,7 +391,7 @@ export async function getReleaseDetail(
     credits: creditViews,
     primaryArtists: primaryArtistNames(creditViews),
     discCount: release.tracks.length > 0 ? 1 : 0,
-    tracks: toTracks(release, titles, masterBlobIds, mixBlobIds),
+    tracks: toTracks(release, titles, masterBlobIds),
     ...(trackCredits !== undefined ? { trackCredits } : {}),
   };
 }

package/src/read/config.ts

@@ -33,8 +33,6 @@ export interface ProtocolIds {
   releaseKind: string;
   /** `recording_master_reference` — optional Walrus master pointers. */
   recordingMasterReference: string;
-  /** `release_mix_reference` — optional per-track delivery descriptor pointers. */
-  releaseMixReference?: string;
   /** `composition_credits` / `recording_credits` / `release_credits` extensions. */
   compositionCredits: string;
   recordingCredits: string;

package/src/read/internal/walrus.ts

@@ -3,7 +3,7 @@
 
 import { bcs } from "@mysten/sui/bcs";
 import { toBase64 } from "@mysten/sui/utils";
-import { walrusBlobIdFromU256 } from "../../mix.ts";
+import { walrusBlobIdFromU256 } from "../../walrus-ids.ts";
 
 const u256 = bcs.u256();
 

package/src/read/types.ts

@@ -76,8 +76,6 @@ export interface TrackView {
   disc: number;
   /** Base64url Walrus blob id for the master stream, when attached on-chain. */
   masterBlobId?: string;
-  /** Base64url Walrus blob id for the public mix-delivery descriptor. */
-  mixBlobId?: string;
 }
 
 /** A release with everything a page renders: metadata, cover, credits, tracklist. */

package/src/recording-extensions.ts

@@ -6,7 +6,8 @@
 import { bcs } from "@mysten/sui/bcs";
 import type { ClientWithCoreApi } from "@mysten/sui/client";
 import type { Transaction, TransactionArgument, TransactionObjectArgument } from "@mysten/sui/transactions";
-import { deriveDynamicFieldID } from "@mysten/sui/utils";
+import { deriveDynamicFieldID, fromHex, toHex } from "@mysten/sui/utils";
+import { isNotFound } from "@misofm/protocol";
 import type { TxThunk } from "./transactions.ts";
 import { invokeWithAdminCap, type AdminCapAuthority, type ObjectInput } from "./vault.ts";
 import * as advisory from "@misofm/protocol/contracts/recording_advisory/recording_advisory";
@@ -132,28 +133,76 @@ export type UnsetRecordingStreamingTranscodeParams = Omit<
   "oriPackageId" | "quiltId"
 >;
 
+/** One stem a Session V1 document references, paired with its Walrus blob. */
+export interface RecordingEngineSessionStemInput {
+  /** 32-byte SHA-256 of the stem's canonical PCM (engine STEM_IDENTITY_V1): raw bytes or 64 hex chars. */
+  readonly digest: Uint8Array | string;
+  /** Unencrypted Walrus blob holding the stem's FLAC, as its on-chain `u256`. */
+  readonly blobId: bigint | string;
+}
+
 export interface SetRecordingEngineSessionParams extends RecordingExtensionTarget {
   readonly recordingEngineSessionPackageId: string;
-  /** External `ori` package used to construct the plaintext Walrus blob reference. */
+  /** External `ori` package used to construct the plaintext Walrus blob references. */
   readonly oriPackageId: string;
-  /** Unencrypted Walrus blob ID of the Miso Engine session file, as its on-chain `u256`. */
+  /** Unencrypted Walrus blob holding the canonical Session V1 JSON, as its on-chain `u256`. */
   readonly sessionBlobId: bigint | string;
+  /** Every stem the document's sources reference. Order does not matter; the builder sorts. */
+  readonly stems: readonly RecordingEngineSessionStemInput[];
+}
+
+const STEM_DIGEST_BYTES = 32;
+
+function stemDigestBytes(digest: Uint8Array | string): Uint8Array {
+  const bytes = typeof digest === "string" ? fromHex(digest) : digest;
+  if (bytes.length !== STEM_DIGEST_BYTES) {
+    throw new Error(`stem digest must be ${STEM_DIGEST_BYTES} bytes`);
+  }
+  return bytes;
+}
+
+function compareBytes(a: Uint8Array, b: Uint8Array): number {
+  for (let index = 0; index < a.length; index += 1) {
+    if (a[index] !== b[index]) return a[index]! - b[index]!;
+  }
+  return 0;
 }
 
 /**
- * Sets or replaces the Miso Engine session file attached to a Recording.
- *
- * `recording_engine_session::new` rejects encrypted blobs on chain, so the
- * reference is always built as a plaintext `ori::data::WalrusBlob`.
+ * Sets or replaces the Miso Engine session attached to a Recording: the
+ * Session V1 blob plus one `Stem` per source. Stems are sorted by digest and
+ * checked for duplicates here, mirroring `recording_engine_session::new`, so a
+ * bad input fails before signing rather than on chain.
  */
 export function setRecordingEngineSession(p: SetRecordingEngineSessionParams): TxThunk {
+  const stems = p.stems
+    .map((stem) => ({ digest: stemDigestBytes(stem.digest), blobId: stem.blobId }))
+    .sort((a, b) => compareBytes(a.digest, b.digest));
+  for (let index = 1; index < stems.length; index += 1) {
+    if (compareBytes(stems[index - 1]!.digest, stems[index]!.digest) === 0) {
+      throw new Error(`duplicate stem digest ${toHex(stems[index]!.digest)}`);
+    }
+  }
   return (tx) => {
+    const pkg = p.recordingEngineSessionPackageId;
+    const sessionBlob = unencryptedWalrusBlob(tx, p.oriPackageId, p.sessionBlobId);
+    const stemValues = stems.map((stem) => tx.add(engineSession.newStem({
+      package: pkg,
+      arguments: [
+        tx.pure.vector("u8", Array.from(stem.digest)),
+        unencryptedWalrusBlob(tx, p.oriPackageId, stem.blobId),
+      ],
+    })));
+    const stemVector = tx.makeMoveVec({
+      type: `${pkg}::recording_engine_session::Stem`,
+      elements: stemValues,
+    });
     const session = tx.add(engineSession._new({
-      package: p.recordingEngineSessionPackageId,
-      arguments: [unencryptedWalrusBlob(tx, p.oriPackageId, p.sessionBlobId)],
+      package: pkg,
+      arguments: [sessionBlob, stemVector],
     }));
     invokeWithAdminCap(tx, p.authority, {
-      target: `${p.recordingEngineSessionPackageId}::recording_engine_session::set_engine_session`,
+      target: `${pkg}::recording_engine_session::set_engine_session`,
       typeArguments: [p.recordingShareType, p.compositionShareType],
       arguments: [object(tx, p.recordingId), session],
       adminCapIndex: 1,
@@ -163,7 +212,7 @@ export function setRecordingEngineSession(p: SetRecordingEngineSessionParams): T
 
 export type UnsetRecordingEngineSessionParams = Omit<
   SetRecordingEngineSessionParams,
-  "oriPackageId" | "sessionBlobId"
+  "oriPackageId" | "sessionBlobId" | "stems"
 >;
 
 /** Removes the Recording's Miso Engine session reference, if present. */
@@ -192,6 +241,73 @@ export function unsetRecordingStreamingTranscode(
   };
 }
 
+// ── Engine-session reads ─────────────────────────────────────────────────────
+
+/** A Recording's attached engine session, ids as decimal `u256` strings. */
+export interface RecordingEngineSessionView {
+  /** Unencrypted Walrus blob holding the canonical Session V1 JSON. */
+  readonly sessionBlobId: string;
+  /** Sorted by digest, as stored. `digest` is 64 lowercase hex chars. */
+  readonly stems: readonly { readonly digest: string; readonly blobId: string }[];
+}
+
+const EngineSessionField = bcs.struct("Field", {
+  id: bcs.Address,
+  name: engineSession.ExtensionKey,
+  value: engineSession.EngineSession,
+});
+const ENGINE_SESSION_KEY_BYTES = engineSession.ExtensionKey.serialize([false]).toBytes();
+
+/** Parse an engine-session dynamic field's BCS content. */
+export function parseRecordingEngineSessionContent(content: Uint8Array): RecordingEngineSessionView {
+  const { value } = EngineSessionField.parse(content);
+  if (value.data.confidentiality.$kind !== "Unencrypted") {
+    throw new Error("Recording engine session is unexpectedly encrypted");
+  }
+  return {
+    sessionBlobId: String(value.data.blob_id),
+    stems: value.stems.map((stem) => {
+      if (stem.data.confidentiality.$kind !== "Unencrypted") {
+        throw new Error("Recording engine session stem is unexpectedly encrypted");
+      }
+      return { digest: toHex(Uint8Array.from(stem.digest)), blobId: String(stem.data.blob_id) };
+    }),
+  };
+}
+
+/** Deterministic dynamic-field id for a Recording's engine session. */
+export function recordingEngineSessionFieldId(
+  recordingId: string,
+  recordingEngineSessionPackageId: string,
+): string {
+  return deriveDynamicFieldID(
+    recordingId,
+    `${recordingEngineSessionPackageId}::recording_engine_session::ExtensionKey`,
+    ENGINE_SESSION_KEY_BYTES,
+  );
+}
+
+/** Read one Recording's engine session, or null when none is attached. */
+export async function getRecordingEngineSession(
+  client: ClientWithCoreApi,
+  recordingId: string,
+  recordingEngineSessionPackageId: string,
+): Promise<RecordingEngineSessionView | null> {
+  const fieldId = recordingEngineSessionFieldId(recordingId, recordingEngineSessionPackageId);
+  const { objects } = await client.core.getObjects({
+    objectIds: [fieldId],
+    include: { content: true },
+  });
+  const field = objects[0];
+  if (!field) throw new Error("Recording engine-session read returned no result");
+  if (field instanceof Error) {
+    if (isNotFound(field)) return null;
+    throw field;
+  }
+  if (!field.content) throw new Error("Recording engine-session field is missing BCS content");
+  return parseRecordingEngineSessionContent(field.content);
+}
+
 // ── Master-reference reads ───────────────────────────────────────────────────
 
 // recording_master_reference stores the ori::data::WalrusBlob value inline in a

package/src/walrus-ids.ts

@@ -0,0 +1,102 @@
+// Copyright (c) Miso Labs, Inc.
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Walrus blob id conversions.
+ *
+ * On chain a blob id is a `u256` (BCS little-endian). Off chain it is the
+ * unpadded base64url encoding of those same 32 little-endian bytes, which is
+ * also its key in a `miso-sources` staging bucket and its path on an
+ * aggregator. Both directions here are canonical: a value that does not
+ * round-trip byte for byte is rejected.
+ */
+
+const ALPHABET =
+  "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+
+/** Parse a `bigint` or decimal string as an exact `u256`. */
+export function walrusU256(label: string, value: bigint | string): bigint {
+  let parsed: bigint;
+  try {
+    parsed = typeof value === "bigint" ? value : BigInt(value);
+  } catch {
+    throw new Error(`${label} must be an exact u256 integer`);
+  }
+  if (parsed < 0n || parsed >= 1n << 256n) {
+    throw new Error(`${label} is outside u256 range`);
+  }
+  return parsed;
+}
+
+/** The base64url Walrus blob id for an on-chain `u256` blob id. */
+export function walrusBlobIdFromU256(value: bigint | string): string {
+  let remaining = walrusU256("Walrus blob id", value);
+  const bytes = new Uint8Array(32);
+  for (let index = 0; index < 32; index += 1) {
+    bytes[index] = Number(remaining & 0xffn);
+    remaining >>= 8n;
+  }
+  return bytesToBase64Url(bytes);
+}
+
+/** The on-chain `u256` for a base64url Walrus blob id (43 characters). */
+export function walrusBlobIdToU256(blobId: string): bigint {
+  const bytes = base64UrlToBytes(blobId);
+  if (bytes.length !== 32) {
+    throw new Error("Walrus blob id must decode to exactly 32 bytes");
+  }
+  let value = 0n;
+  for (let index = 31; index >= 0; index -= 1) {
+    value = (value << 8n) | BigInt(bytes[index]!);
+  }
+  return value;
+}
+
+/** Unpadded base64url. */
+export function bytesToBase64Url(bytes: Uint8Array): string {
+  let output = "";
+  for (let index = 0; index < bytes.length; index += 3) {
+    const a = bytes[index] ?? 0;
+    const b = bytes[index + 1] ?? 0;
+    const c = bytes[index + 2] ?? 0;
+    output += ALPHABET[a >>> 2];
+    output += ALPHABET[((a & 3) << 4) | (b >>> 4)];
+    if (index + 1 < bytes.length) {
+      output += ALPHABET[((b & 15) << 2) | (c >>> 6)];
+    }
+    if (index + 2 < bytes.length) output += ALPHABET[c & 63];
+  }
+  return output;
+}
+
+/** Strict inverse of {@link bytesToBase64Url}: no padding, no stray bits. */
+export function base64UrlToBytes(value: string): Uint8Array {
+  if (
+    typeof value !== "string" ||
+    value.length % 4 === 1 ||
+    value.includes("=") ||
+    !/^[A-Za-z0-9_-]*$/.test(value)
+  ) {
+    throw new Error("invalid canonical base64url");
+  }
+  const bytes = new Uint8Array(Math.floor((value.length * 6) / 8));
+  let accumulator = 0;
+  let bits = 0;
+  let outputIndex = 0;
+  for (const character of value) {
+    const digit = ALPHABET.indexOf(character);
+    if (digit < 0) throw new Error("invalid canonical base64url");
+    accumulator = (accumulator << 6) | digit;
+    bits += 6;
+    if (bits >= 8) {
+      bits -= 8;
+      bytes[outputIndex] = (accumulator >>> bits) & 0xff;
+      outputIndex += 1;
+      accumulator &= (1 << bits) - 1;
+    }
+  }
+  if (bytesToBase64Url(bytes) !== value) {
+    throw new Error("invalid canonical base64url padding bits");
+  }
+  return bytes;
+}

package/dist/mix.d.ts

@@ -1,130 +0,0 @@
-import type { ClientWithCoreApi } from "@mysten/sui/client";
-export declare const RECORDING_SESSION_ID_BYTES = 98;
-export declare const RECORDING_SESSION_ID_SCHEMA: 1;
-export declare const RECORDING_SESSION_ID_KIND: 1;
-export declare const ENGINE_SESSION_SCHEMA_V1: "miso.engine-session/1";
-export declare const ENGINE_SESSION_NETWORK_V1: "testnet";
-export declare const STEM_CIPHER_FRAMING_V1: "aes-256-gcm-hkdf-stream/2";
-export declare const STEM_CIPHER_CHUNK_BYTES: 1048576;
-export declare const STEM_CIPHER_TAG_BYTES: 16;
-export declare const STEM_CIPHER_HEADER_BYTES: 25;
-export declare const MAX_ENGINE_SESSION_BYTES: number;
-export declare const MAX_ENGINE_SESSION_STEMS = 32;
-export declare const MAX_STEM_FLAC_BYTES: number;
-export declare const MAX_SESSION_FLAC_BYTES: number;
-export declare const MAX_STEM_CANONICAL_PCM_BYTES: number;
-export declare const ENGINE_SESSION_SAMPLE_RATES: readonly [44100, 48000, 88200, 96000];
-export type EngineSessionSampleRate = (typeof ENGINE_SESSION_SAMPLE_RATES)[number];
-export interface RecordingSessionIdentity {
-    readonly schema: typeof RECORDING_SESSION_ID_SCHEMA;
-    readonly kind: typeof RECORDING_SESSION_ID_KIND;
-    readonly recordGateId: string;
-    readonly recordingId: string;
-    readonly nonce: Uint8Array;
-}
-/** Encode `[schema | kind | gate | recording | 32-byte nonce]`. */
-export declare function encodeRecordingSessionIdentity(identity: Omit<RecordingSessionIdentity, "schema" | "kind"> & Partial<Pick<RecordingSessionIdentity, "schema" | "kind">>): Uint8Array;
-/** Strictly parse one exact identity; short and trailing bytes are rejected. */
-export declare function parseRecordingSessionIdentity(bytes: Uint8Array): RecordingSessionIdentity;
-export declare function recordingSessionIdentityHex(identity: Parameters<typeof encodeRecordingSessionIdentity>[0]): string;
-/** Stable unique HKDF/AAD domain for one encrypted stem. */
-export declare function stemCipherDomain(stemId: string): Uint8Array;
-export interface EngineSessionEffectPreset {
-    readonly slot: number;
-    readonly bypassed: boolean;
-    readonly params: Readonly<Record<string, number>>;
-}
-export interface EngineSessionStemPreset {
-    readonly faderDb: number;
-    readonly pan: number;
-    readonly muted: boolean;
-    readonly soloed: boolean;
-    readonly effects: readonly EngineSessionEffectPreset[];
-}
-export interface EngineSessionStemV1 {
-    /** Portable encryption-domain id, independent of PCM/container identity. */
-    readonly id: string;
-    /** Canonical decoded PCM identity consumed by the stem store. */
-    readonly identity: `sha256:${string}`;
-    readonly name: string;
-    readonly role: string;
-    readonly channels: 1 | 2;
-    readonly bitDepth: 16 | 24;
-    readonly frames: number;
-    readonly preset: EngineSessionStemPreset;
-    /** Standalone Walrus blob containing framed AES-GCM ciphertext. */
-    readonly blobId: string;
-    readonly ciphertextSha256: string;
-    readonly plainBytes: number;
-    readonly cipherBytes: number;
-}
-export interface EngineSessionV1 {
-    readonly schema: typeof ENGINE_SESSION_SCHEMA_V1;
-    readonly network: typeof ENGINE_SESSION_NETWORK_V1;
-    readonly recordingId: string;
-    readonly title: string;
-    readonly artist: string;
-    readonly sampleRateHz: EngineSessionSampleRate;
-    readonly seal: {
-        /** Canonical base64url Seal EncryptedObject wrapping exactly 32 AES bytes. */
-        readonly encryptedKey: string;
-    };
-    readonly cipher: {
-        readonly framing: typeof STEM_CIPHER_FRAMING_V1;
-        readonly chunkSize: typeof STEM_CIPHER_CHUNK_BYTES;
-        readonly tagSize: typeof STEM_CIPHER_TAG_BYTES;
-    };
-    readonly stems: readonly EngineSessionStemV1[];
-}
-/** Ciphertext length implied by the fixed authenticated-record framing. */
-export declare function stemCipherBytes(plainBytes: number): number;
-/** Validate exact shape, bounds, identity, and the embedded Seal object. */
-export declare function assertEngineSessionV1(value: unknown): asserts value is EngineSessionV1;
-/** Canonical plaintext bytes uploaded as the Recording's session blob. */
-export declare function encodeEngineSessionV1(session: EngineSessionV1): Uint8Array;
-/** Parse only canonical JSON: unknown keys, whitespace, and trailing data fail. */
-export declare function parseEngineSessionV1(input: Uint8Array | string): EngineSessionV1;
-export interface InspectedEngineSessionKey {
-    readonly packageId: string;
-    readonly innerId: Uint8Array;
-    readonly services: readonly (readonly [string, number])[];
-    readonly threshold: number;
-}
-/** Parse and constrain the official Seal object carrying the session AES key. */
-export declare function inspectEngineSessionKey(bytes: Uint8Array): InspectedEngineSessionKey;
-export interface RecordingEngineSessionReference {
-    readonly blobId: bigint;
-}
-export interface ReleaseMixReference {
-    readonly blobId: bigint;
-}
-/** Read the release-aligned optional descriptor references in track order. */
-export declare function getReleaseMixReferences(client: ClientWithCoreApi, releaseId: string, packageId: string): Promise<Array<ReleaseMixReference | null> | null>;
-export declare function recordingEngineSessionFieldId(recordingId: string, packageId: string): string;
-export declare function parseRecordingEngineSessionContent(content: Uint8Array): RecordingEngineSessionReference;
-export declare function getRecordingEngineSession(client: ClientWithCoreApi, recordingId: string, packageId: string): Promise<RecordingEngineSessionReference | null>;
-/** Exact concrete Record read using BCS, never transport-dependent JSON. */
-export declare function getRecordReleaseId(client: ClientWithCoreApi, recordId: string, recordPackageId: string): Promise<string>;
-export interface ResolvedRecordEngineSession {
-    readonly releaseId: string;
-    readonly recordingId: string;
-    readonly sessionBlobId: string;
-}
-/**
- * Resolve Record → immutable Release track → Recording dynamic field.
- *
- * Every edge is a direct Sui object read. No event scan, dynamic-field list,
- * API hint, or indexer-maintained relation participates in the answer.
- */
-export declare function resolveRecordEngineSession(client: ClientWithCoreApi, input: {
-    readonly recordId: string;
-    readonly trackIndex: number;
-    readonly recordPackageId: string;
-    readonly recordingEngineSessionPackageId: string;
-}): Promise<ResolvedRecordEngineSession>;
-export declare function walrusBlobIdFromU256(value: bigint | string): string;
-export declare function bytesToBase64Url(bytes: Uint8Array): string;
-export declare function base64UrlToBytes(value: string): Uint8Array;
-export declare function bytesToHex(bytes: Uint8Array): string;
-export declare function hexToBytes(value: string, expectedBytes?: number, label?: string): Uint8Array;
-//# sourceMappingURL=mix.d.ts.map

package/dist/mix.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mix.d.ts","sourceRoot":"","sources":["../src/mix.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAoB5D,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AACtD,eAAO,MAAM,yBAAyB,EAAG,CAAU,CAAC;AAEpD,eAAO,MAAM,wBAAwB,EAAG,uBAAgC,CAAC;AACzE,eAAO,MAAM,yBAAyB,EAAG,SAAkB,CAAC;AAC5D,eAAO,MAAM,sBAAsB,EACjC,2BAAoC,CAAC;AACvC,eAAO,MAAM,uBAAuB,EAAG,OAAkB,CAAC;AAC1D,eAAO,MAAM,qBAAqB,EAAG,EAAW,CAAC;AACjD,eAAO,MAAM,wBAAwB,EAAG,EAAW,CAAC;AACpD,eAAO,MAAM,wBAAwB,QAAa,CAAC;AACnD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,mBAAmB,QAAoB,CAAC;AACrD,eAAO,MAAM,sBAAsB,QAAoB,CAAC;AACxD,eAAO,MAAM,4BAA4B,QAAoB,CAAC;AAC9D,eAAO,MAAM,2BAA2B,YACtC,KAAM,EACN,KAAM,EACN,KAAM,EACN,KAAM,CACE,CAAC;AACX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAW/C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,2BAA2B,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,OAAO,yBAAyB,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,mEAAmE;AACnE,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,MAAM,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,GAC3D,UAAU,CAkBZ;AAED,gFAAgF;AAChF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,UAAU,GAChB,wBAAwB,CAmB1B;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC,CAAC,CAAC,GAC7D,MAAM,CAER;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAM3D;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,UAAU,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE,OAAO,yBAAyB,CAAC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE;QACb,8EAA8E;QAC9E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,OAAO,EAAE,OAAO,sBAAsB,CAAC;QAChD,QAAQ,CAAC,SAAS,EAAE,OAAO,uBAAuB,CAAC;QACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,qBAAqB,CAAC;KAChD,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAY1D;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,eAAe,CAqHlC;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,UAAU,CAO1E;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,GAAG,MAAM,GACzB,eAAe,CAuBjB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,GAChB,yBAAyB,CAqD3B;AA6BD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8EAA8E;AAC9E,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAqBnD;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAMR;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,UAAU,GAClB,+BAA+B,CAMjC;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAgBjD;AAED,4EAA4E;AAC5E,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE;IACL,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAC;CAClD,GACA,OAAO,CAAC,2BAA2B,CAAC,CAsBtC;AAQD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAQnE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAgB1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CA+B1D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAIpD;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EACtB,KAAK,SAAQ,GACZ,UAAU,CAYZ"}