@arcadiasystems/morse-sdk 0.3.0 → 0.4.0

package/dist/ptb/recipient-file.d.ts

@@ -0,0 +1,82 @@
+/**
+ * PTB builders for the `recipient_file` module. Internal to the SDK; `ops/`
+ * composes these into single atomic transactions. All builders target
+ * `config.packageId` (the current published-at) because the
+ * `recipient_file` module was added in a package upgrade; calling it at
+ * `originalPackageId` would resolve to the v1 bytecode where the module
+ * does not exist.
+ */
+import type { Transaction, TransactionArgument, TransactionObjectArgument, TransactionResult } from "@mysten/sui/transactions";
+import type { BlobObjectId, PackageId, RecipientFileId, SuiAddress, WalrusBlobId } from "../types.js";
+/** Walrus system `Clock` shared object. Required by `new_recipient_file*`. */
+export declare const SUI_CLOCK_OBJECT_ID = "0x6";
+export interface BuildNewRecipientFileArgs {
+    readonly packageId: PackageId;
+    readonly blobId: WalrusBlobId;
+    readonly blobObjectId?: BlobObjectId;
+    readonly name: string;
+    readonly contentType: string;
+    readonly size: number;
+    readonly recipients: readonly SuiAddress[];
+}
+/**
+ * Add a `recipient_file::new_recipient_file` call. Returns the created
+ * `RecipientFile` by value; the caller must consume it (typically via
+ * `buildShareRecipientFile` in the same PTB).
+ */
+export declare function buildNewRecipientFile(tx: Transaction, args: BuildNewRecipientFileArgs): TransactionResult;
+export interface BuildNewRecipientFileWithSealPrefixArgs extends BuildNewRecipientFileArgs {
+    readonly sealIdPrefix: Uint8Array;
+}
+/**
+ * Add a `recipient_file::new_recipient_file_with_seal_prefix` call. The
+ * supplied prefix is the bytes that Seal identities for this file's
+ * encrypted content must start with (followed by tag=3 and a per-encrypt
+ * nonce). Returns the created `RecipientFile` by value.
+ */
+export declare function buildNewRecipientFileWithSealPrefix(tx: Transaction, args: BuildNewRecipientFileWithSealPrefixArgs): TransactionResult;
+export interface BuildShareRecipientFileArgs {
+    readonly packageId: PackageId;
+    readonly file: TransactionArgument;
+}
+/** Add a `recipient_file::share_recipient_file` call. Consumes the file. */
+export declare function buildShareRecipientFile(tx: Transaction, args: BuildShareRecipientFileArgs): TransactionResult;
+export interface BuildAddRecipientArgs {
+    readonly packageId: PackageId;
+    readonly file: RecipientFileId | TransactionObjectArgument;
+    readonly recipient: SuiAddress;
+}
+/** Add a `recipient_file::add_recipient` call. */
+export declare function buildAddRecipient(tx: Transaction, args: BuildAddRecipientArgs): TransactionResult;
+export interface BuildRemoveRecipientArgs {
+    readonly packageId: PackageId;
+    readonly file: RecipientFileId | TransactionObjectArgument;
+    readonly recipient: SuiAddress;
+}
+/** Add a `recipient_file::remove_recipient` call. */
+export declare function buildRemoveRecipient(tx: Transaction, args: BuildRemoveRecipientArgs): TransactionResult;
+export interface BuildTransferRecipientFileOwnershipArgs {
+    readonly packageId: PackageId;
+    readonly file: RecipientFileId | TransactionObjectArgument;
+    readonly newOwner: SuiAddress;
+}
+/**
+ * Add a `recipient_file::transfer_ownership` call. Does NOT touch `members`;
+ * compose with `add_recipient`/`remove_recipient` for a full handover.
+ */
+export declare function buildTransferRecipientFileOwnership(tx: Transaction, args: BuildTransferRecipientFileOwnershipArgs): TransactionResult;
+export interface BuildUpdateRecipientFileMetadataArgs {
+    readonly packageId: PackageId;
+    readonly file: RecipientFileId | TransactionObjectArgument;
+    readonly name: string;
+    readonly contentType: string;
+}
+/** Add a `recipient_file::update_metadata` call. */
+export declare function buildUpdateRecipientFileMetadata(tx: Transaction, args: BuildUpdateRecipientFileMetadataArgs): TransactionResult;
+export interface BuildDeleteRecipientFileArgs {
+    readonly packageId: PackageId;
+    readonly file: RecipientFileId | TransactionObjectArgument;
+}
+/** Add a `recipient_file::delete_file` call. Consumes the file. */
+export declare function buildDeleteRecipientFile(tx: Transaction, args: BuildDeleteRecipientFileArgs): TransactionResult;
+//# sourceMappingURL=recipient-file.d.ts.map

package/dist/ptb/recipient-file.d.ts.map

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

package/dist/ptb/recipient-file.js

@@ -0,0 +1,148 @@
+/**
+ * PTB builders for the `recipient_file` module. Internal to the SDK; `ops/`
+ * composes these into single atomic transactions. All builders target
+ * `config.packageId` (the current published-at) because the
+ * `recipient_file` module was added in a package upgrade; calling it at
+ * `originalPackageId` would resolve to the v1 bytecode where the module
+ * does not exist.
+ */
+import { ValidationError } from "../errors.js";
+import { resolveObjectArg } from "./internal.js";
+/** Walrus system `Clock` shared object. Required by `new_recipient_file*`. */
+export const SUI_CLOCK_OBJECT_ID = "0x6";
+/**
+ * Add a `recipient_file::new_recipient_file` call. Returns the created
+ * `RecipientFile` by value; the caller must consume it (typically via
+ * `buildShareRecipientFile` in the same PTB).
+ */
+export function buildNewRecipientFile(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::recipient_file::new_recipient_file`,
+        arguments: [
+            tx.pure.vector("u8", Array.from(walrusBlobIdToBytes(args.blobId))),
+            optionObjectId(tx, args.blobObjectId),
+            tx.pure.string(args.name),
+            tx.pure.string(args.contentType),
+            tx.pure.u64(args.size),
+            tx.pure.vector("address", [...args.recipients]),
+            tx.object(SUI_CLOCK_OBJECT_ID),
+        ],
+    });
+}
+/**
+ * Add a `recipient_file::new_recipient_file_with_seal_prefix` call. The
+ * supplied prefix is the bytes that Seal identities for this file's
+ * encrypted content must start with (followed by tag=3 and a per-encrypt
+ * nonce). Returns the created `RecipientFile` by value.
+ */
+export function buildNewRecipientFileWithSealPrefix(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::recipient_file::new_recipient_file_with_seal_prefix`,
+        arguments: [
+            tx.pure.vector("u8", Array.from(args.sealIdPrefix)),
+            tx.pure.vector("u8", Array.from(walrusBlobIdToBytes(args.blobId))),
+            optionObjectId(tx, args.blobObjectId),
+            tx.pure.string(args.name),
+            tx.pure.string(args.contentType),
+            tx.pure.u64(args.size),
+            tx.pure.vector("address", [...args.recipients]),
+            tx.object(SUI_CLOCK_OBJECT_ID),
+        ],
+    });
+}
+/** Add a `recipient_file::share_recipient_file` call. Consumes the file. */
+export function buildShareRecipientFile(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::recipient_file::share_recipient_file`,
+        arguments: [args.file],
+    });
+}
+/** Add a `recipient_file::add_recipient` call. */
+export function buildAddRecipient(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::recipient_file::add_recipient`,
+        arguments: [
+            resolveObjectArg(tx, args.file),
+            tx.pure.address(args.recipient),
+        ],
+    });
+}
+/** Add a `recipient_file::remove_recipient` call. */
+export function buildRemoveRecipient(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::recipient_file::remove_recipient`,
+        arguments: [
+            resolveObjectArg(tx, args.file),
+            tx.pure.address(args.recipient),
+        ],
+    });
+}
+/**
+ * Add a `recipient_file::transfer_ownership` call. Does NOT touch `members`;
+ * compose with `add_recipient`/`remove_recipient` for a full handover.
+ */
+export function buildTransferRecipientFileOwnership(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::recipient_file::transfer_ownership`,
+        arguments: [
+            resolveObjectArg(tx, args.file),
+            tx.pure.address(args.newOwner),
+        ],
+    });
+}
+/** Add a `recipient_file::update_metadata` call. */
+export function buildUpdateRecipientFileMetadata(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::recipient_file::update_metadata`,
+        arguments: [
+            resolveObjectArg(tx, args.file),
+            tx.pure.string(args.name),
+            tx.pure.string(args.contentType),
+        ],
+    });
+}
+/** Add a `recipient_file::delete_file` call. Consumes the file. */
+export function buildDeleteRecipientFile(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::recipient_file::delete_file`,
+        arguments: [resolveObjectArg(tx, args.file)],
+    });
+}
+function optionObjectId(tx, id) {
+    if (id === undefined) {
+        return tx.moveCall({
+            target: "0x1::option::none",
+            typeArguments: ["0x2::object::ID"],
+        });
+    }
+    return tx.moveCall({
+        target: "0x1::option::some",
+        typeArguments: ["0x2::object::ID"],
+        arguments: [tx.pure.id(id)],
+    });
+}
+const WALRUS_BLOB_ID_CHARS = 43;
+/**
+ * Walrus blob ids are 43-char URL-safe base64 (32 bytes decoded). The Move
+ * contract expects raw bytes. Decoding here keeps PTB builders pure.
+ *
+ * Defends against a mis-branded input by asserting the length even though
+ * `toWalrusBlobId` already validates at the codec entry. Surfaces a
+ * meaningful error rather than an opaque `atob` exception if the brand
+ * invariant is ever violated.
+ */
+function walrusBlobIdToBytes(blobId) {
+    const raw = blobId;
+    if (raw.length !== WALRUS_BLOB_ID_CHARS) {
+        throw new ValidationError(`WalrusBlobId must be ${WALRUS_BLOB_ID_CHARS} chars; got ${raw.length}`, "blobId");
+    }
+    // URL-safe base64 -> standard base64. 43 chars -> single `=` padding.
+    const padded = `${raw.replace(/-/g, "+").replace(/_/g, "/")}=`;
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+//# sourceMappingURL=recipient-file.js.map

package/dist/ptb/recipient-file.js.map

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

package/dist/read/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Public barrel for the read layer.
  */
-export { buildFilesEventTypes, type FilesEventInput, type FilesEventTypes, reconcileFilesAccessibleBy, reconcileFilesOwnedBy, } from "./files-events.js";
-export { type AllowlistCapListPage, type FilesListOptions, type FilesReader, RpcFilesReader, } from "./files-reader.js";
 export { type EntryListPage, type ListEntriesOptions, type ListPublicationsOptions, type ListPublisherCapsOptions, type OwnedPublication, type PublicationListPage, type PublicationReader, type PublisherCapListPage, RpcPublicationReader, type ScanEntriesOptions, } from "./reader.js";
+export { buildRecipientFileEventTypes, type RecipientFileEventInput, type RecipientFileEventTypes, reconcileRecipientFilesAccessibleBy, reconcileRecipientFilesOwnedBy, } from "./recipient-file-events.js";
+export { type RecipientFilesReader, RpcRecipientFilesReader, type RpcRecipientFilesReaderConfig, } from "./recipient-files-reader.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/read/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,0BAA0B,EAC1B,qBAAqB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,cAAc,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,kBAAkB,GACvB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,kBAAkB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,4BAA4B,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,mCAAmC,EACnC,8BAA8B,GAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACN,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,KAAK,6BAA6B,GAClC,MAAM,6BAA6B,CAAC"}

package/dist/read/index.js

@@ -1,7 +1,7 @@
 /**
  * Public barrel for the read layer.
  */
-export { buildFilesEventTypes, reconcileFilesAccessibleBy, reconcileFilesOwnedBy, } from "./files-events.js";
-export { RpcFilesReader, } from "./files-reader.js";
 export { RpcPublicationReader, } from "./reader.js";
+export { buildRecipientFileEventTypes, reconcileRecipientFilesAccessibleBy, reconcileRecipientFilesOwnedBy, } from "./recipient-file-events.js";
+export { RpcRecipientFilesReader, } from "./recipient-files-reader.js";
 //# sourceMappingURL=index.js.map

package/dist/read/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,oBAAoB,EAGpB,0BAA0B,EAC1B,qBAAqB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIN,cAAc,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EASN,oBAAoB,GAEpB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EASN,oBAAoB,GAEpB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,4BAA4B,EAG5B,mCAAmC,EACnC,8BAA8B,GAC9B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEN,uBAAuB,GAEvB,MAAM,6BAA6B,CAAC"}

package/dist/read/recipient-file-events.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Event-driven reads for the `recipient_file` module. Pure reconciliation
+ * helpers that replay a stream of event payloads into a current-state
+ * snapshot, plus a string builder for the fully-qualified Sui event types
+ * indexers subscribe to.
+ *
+ * Event identity is rooted at `recipientFileEventOriginPackageId` (the
+ * package address where the `recipient_file` module was FIRST defined).
+ * Distinct from `packageId` (current published-at; moves on every upgrade)
+ * and `originalPackageId` (publication-modules v1 genesis).
+ */
+import type { PackageId, RecipientFileSummary, SuiAddress } from "../types.js";
+/** Fully-qualified Move event types for the recipient-file module. */
+export interface RecipientFileEventTypes {
+    readonly RecipientFileCreated: string;
+    readonly RecipientFileDeleted: string;
+    readonly RecipientFileMetadataUpdated: string;
+    readonly RecipientFileOwnershipTransferred: string;
+    readonly RecipientFileSealPrefixAttached: string;
+    readonly RecipientAdded: string;
+    readonly RecipientRemoved: string;
+}
+/**
+ * Build the fully-qualified event-type strings used by indexers to filter
+ * Sui event streams. Pass `config.recipientFileEventOriginPackageId` (NOT
+ * `config.packageId`, which moves on upgrades) as `originPackageId`.
+ */
+export declare function buildRecipientFileEventTypes(originPackageId: PackageId): RecipientFileEventTypes;
+/**
+ * Input shape for reconciliation. Indexers normalize Sui event envelopes
+ * into `{ type, json, timestampMs }`; the helpers below switch on `type`.
+ */
+export interface RecipientFileEventInput {
+    /** Fully-qualified Sui event type. */
+    readonly type: string;
+    /** Move event payload, decoded as JSON. */
+    readonly json: Record<string, unknown>;
+    /**
+     * Transaction timestamp in milliseconds. Sourced from the Sui event
+     * envelope; used only for `createdAtMs` on summaries.
+     */
+    readonly timestampMs: number;
+}
+/**
+ * Replay `events` in order to derive every RecipientFile currently owned by
+ * `owner`. Pure: same inputs always produce the same output.
+ *
+ * Files are dropped from the result on `RecipientFileDeleted` and when
+ * `RecipientFileOwnershipTransferred` moves them off `owner`. Files
+ * transferred TO `owner` are NOT added because the event payload does not
+ * carry the file metadata; consumers needing those should re-fetch via
+ * `getRecipientFile` or filter `RecipientFileCreated` upstream.
+ */
+export declare function reconcileRecipientFilesOwnedBy(events: readonly RecipientFileEventInput[], owner: SuiAddress, types: RecipientFileEventTypes): RecipientFileSummary[];
+/**
+ * Replay `events` in order to derive every RecipientFile where `address` is
+ * currently a recipient (owner or member). Pure.
+ *
+ * Files are added on `RecipientFileCreated` where `address` appears in
+ * `members`, and on `RecipientAdded` where `recipient == address`. Files
+ * are dropped on `RecipientFileDeleted` and on `RecipientRemoved` where
+ * `recipient == address`.
+ */
+export declare function reconcileRecipientFilesAccessibleBy(events: readonly RecipientFileEventInput[], address: SuiAddress, types: RecipientFileEventTypes): RecipientFileSummary[];
+//# sourceMappingURL=recipient-file-events.d.ts.map

package/dist/read/recipient-file-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipient-file-events.d.ts","sourceRoot":"","sources":["../../src/read/recipient-file-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACX,SAAS,EAET,oBAAoB,EACpB,UAAU,EACV,MAAM,aAAa,CAAC;AAErB,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,iCAAiC,EAAE,MAAM,CAAC;IACnD,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAC;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC3C,eAAe,EAAE,SAAS,GACxB,uBAAuB,CAWzB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACvC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAYD;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC7C,MAAM,EAAE,SAAS,uBAAuB,EAAE,EAC1C,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,uBAAuB,GAC5B,oBAAoB,EAAE,CAWxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,CAClD,MAAM,EAAE,SAAS,uBAAuB,EAAE,EAC1C,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,uBAAuB,GAC5B,oBAAoB,EAAE,CAWxB"}

package/dist/read/recipient-file-events.js

@@ -0,0 +1,172 @@
+/**
+ * Event-driven reads for the `recipient_file` module. Pure reconciliation
+ * helpers that replay a stream of event payloads into a current-state
+ * snapshot, plus a string builder for the fully-qualified Sui event types
+ * indexers subscribe to.
+ *
+ * Event identity is rooted at `recipientFileEventOriginPackageId` (the
+ * package address where the `recipient_file` module was FIRST defined).
+ * Distinct from `packageId` (current published-at; moves on every upgrade)
+ * and `originalPackageId` (publication-modules v1 genesis).
+ */
+import { toRecipientFileId, toSuiAddress } from "../codecs.js";
+import { ValidationError } from "../errors.js";
+/**
+ * Build the fully-qualified event-type strings used by indexers to filter
+ * Sui event streams. Pass `config.recipientFileEventOriginPackageId` (NOT
+ * `config.packageId`, which moves on upgrades) as `originPackageId`.
+ */
+export function buildRecipientFileEventTypes(originPackageId) {
+    const base = `${originPackageId}::recipient_file`;
+    return {
+        RecipientFileCreated: `${base}::RecipientFileCreated`,
+        RecipientFileDeleted: `${base}::RecipientFileDeleted`,
+        RecipientFileMetadataUpdated: `${base}::RecipientFileMetadataUpdated`,
+        RecipientFileOwnershipTransferred: `${base}::RecipientFileOwnershipTransferred`,
+        RecipientFileSealPrefixAttached: `${base}::RecipientFileSealPrefixAttached`,
+        RecipientAdded: `${base}::RecipientAdded`,
+        RecipientRemoved: `${base}::RecipientRemoved`,
+    };
+}
+/**
+ * Replay `events` in order to derive every RecipientFile currently owned by
+ * `owner`. Pure: same inputs always produce the same output.
+ *
+ * Files are dropped from the result on `RecipientFileDeleted` and when
+ * `RecipientFileOwnershipTransferred` moves them off `owner`. Files
+ * transferred TO `owner` are NOT added because the event payload does not
+ * carry the file metadata; consumers needing those should re-fetch via
+ * `getRecipientFile` or filter `RecipientFileCreated` upstream.
+ */
+export function reconcileRecipientFilesOwnedBy(events, owner, types) {
+    const validatedOwner = toSuiAddress(owner);
+    const byId = new Map();
+    for (const event of events) {
+        applyEvent(event, types, byId);
+    }
+    return [...byId.values()]
+        .filter((s) => s.owner === validatedOwner)
+        .map(toSummary);
+}
+/**
+ * Replay `events` in order to derive every RecipientFile where `address` is
+ * currently a recipient (owner or member). Pure.
+ *
+ * Files are added on `RecipientFileCreated` where `address` appears in
+ * `members`, and on `RecipientAdded` where `recipient == address`. Files
+ * are dropped on `RecipientFileDeleted` and on `RecipientRemoved` where
+ * `recipient == address`.
+ */
+export function reconcileRecipientFilesAccessibleBy(events, address, types) {
+    const validated = toSuiAddress(address);
+    const byId = new Map();
+    for (const event of events) {
+        applyEvent(event, types, byId);
+    }
+    return [...byId.values()]
+        .filter((s) => s.members.includes(validated))
+        .map(toSummary);
+}
+function applyEvent(event, types, byId) {
+    const j = event.json;
+    switch (event.type) {
+        case types.RecipientFileCreated: {
+            const id = readFileId(j);
+            const owner = toSuiAddress(readString(j, "owner"));
+            const members = readAddressArray(j, "members");
+            byId.set(id, {
+                id: id,
+                owner,
+                name: readString(j, "name"),
+                contentType: readString(j, "content_type"),
+                size: readSafeInteger(j, "size"),
+                members,
+                createdAtMs: event.timestampMs,
+            });
+            return;
+        }
+        case types.RecipientFileDeleted: {
+            byId.delete(readFileId(j));
+            return;
+        }
+        case types.RecipientFileMetadataUpdated: {
+            const summary = byId.get(readFileId(j));
+            if (!summary)
+                return;
+            summary.name = readString(j, "name");
+            summary.contentType = readString(j, "content_type");
+            return;
+        }
+        case types.RecipientFileOwnershipTransferred: {
+            const summary = byId.get(readFileId(j));
+            if (!summary)
+                return;
+            summary.owner = toSuiAddress(readString(j, "new_owner"));
+            return;
+        }
+        case types.RecipientAdded: {
+            const summary = byId.get(readFileId(j));
+            if (!summary)
+                return;
+            const recipient = toSuiAddress(readString(j, "recipient"));
+            if (!summary.members.includes(recipient))
+                summary.members.push(recipient);
+            return;
+        }
+        case types.RecipientRemoved: {
+            const summary = byId.get(readFileId(j));
+            if (!summary)
+                return;
+            const recipient = toSuiAddress(readString(j, "recipient"));
+            summary.members = summary.members.filter((m) => m !== recipient);
+            return;
+        }
+        default:
+            return;
+    }
+}
+// Normalize via `toRecipientFileId` so Map keys are canonical 64-char form
+// regardless of whether the indexer surfaces short-form or padded ids.
+function readFileId(json) {
+    return toRecipientFileId(readString(json, "file"));
+}
+function toSummary(s) {
+    return {
+        kind: "summary",
+        id: s.id,
+        owner: s.owner,
+        name: s.name,
+        contentType: s.contentType,
+        size: s.size,
+        members: [...s.members],
+        createdAtMs: s.createdAtMs,
+    };
+}
+function readString(json, key) {
+    const value = json[key];
+    if (typeof value !== "string") {
+        throw new ValidationError(`Event field ${key} is missing or not a string`, key);
+    }
+    return value;
+}
+function readSafeInteger(json, key) {
+    const raw = json[key];
+    const value = typeof raw === "string" ? Number(raw) : raw;
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+        throw new ValidationError(`Event field ${key} is not a non-negative safe integer: ${JSON.stringify(raw)}`, key);
+    }
+    return value;
+}
+function readAddressArray(json, key) {
+    const value = json[key];
+    if (!Array.isArray(value)) {
+        throw new ValidationError(`Event field ${key} is not an array`, key);
+    }
+    return value.map((entry, idx) => {
+        if (typeof entry !== "string") {
+            throw new ValidationError(`Event field ${key}[${idx}] is not a string`, key);
+        }
+        return toSuiAddress(entry);
+    });
+}
+//# sourceMappingURL=recipient-file-events.js.map

package/dist/read/recipient-file-events.js.map

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

package/dist/read/recipient-files-reader.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Live object read for `RecipientFile`. Parses the shared object's JSON
+ * representation into the typed `RecipientFile` record.
+ *
+ * RecipientFile was introduced in the v3 contract upgrade; both the type
+ * filter and the move-call target paths use `config.packageId` (current
+ * published-at), not `originalPackageId` (publication-modules genesis).
+ */
+import type { ObjectReader } from "../clients.js";
+import type { PackageId, RecipientFile, RecipientFileId } from "../types.js";
+/** Interface for reading `RecipientFile` objects. */
+export interface RecipientFilesReader {
+    getRecipientFile(id: RecipientFileId, signal?: AbortSignal): Promise<RecipientFile>;
+}
+/** Configuration accepted by `RpcRecipientFilesReader.fromConfig`. */
+export interface RpcRecipientFilesReaderConfig {
+    readonly packageId: PackageId;
+}
+/** RPC-backed implementation. */
+export declare class RpcRecipientFilesReader implements RecipientFilesReader {
+    private readonly client;
+    private readonly packageId;
+    private constructor();
+    static fromConfig(client: ObjectReader, config: RpcRecipientFilesReaderConfig): RpcRecipientFilesReader;
+    getRecipientFile(id: RecipientFileId, signal?: AbortSignal): Promise<RecipientFile>;
+}
+//# sourceMappingURL=recipient-files-reader.d.ts.map

package/dist/read/recipient-files-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipient-files-reader.d.ts","sourceRoot":"","sources":["../../src/read/recipient-files-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQlD,OAAO,KAAK,EAEX,SAAS,EACT,aAAa,EACb,eAAe,EAGf,MAAM,aAAa,CAAC;AAErB,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACpC,gBAAgB,CACf,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;CAC1B;AAED,sEAAsE;AACtE,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC9B;AAED,iCAAiC;AACjC,qBAAa,uBAAwB,YAAW,oBAAoB;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAEtC,OAAO;IAKP,MAAM,CAAC,UAAU,CAChB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,6BAA6B,GACnC,uBAAuB;IAIpB,gBAAgB,CACrB,EAAE,EAAE,eAAe,EACnB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC;CA4BzB"}