@arcadiasystems/morse-sdk 0.1.4 → 0.3.0

package/dist/ops/file.js

@@ -0,0 +1,142 @@
+/**
+ * High-level file ops: build a PTB, sign and execute via the wallet adapter,
+ * parse the receipt into a typed result.
+ *
+ * Encrypted-file creation here registers the metadata record assuming the
+ * encrypted bytes are already on Walrus. The all-in-one upload+register
+ * flow is `uploadEncryptedFileFromBytes` in `file-from-bytes.ts`.
+ */
+import { Transaction, } from "@mysten/sui/transactions";
+import { toEncryptedFileId } from "../codecs.js";
+import { ValidationError } from "../errors.js";
+import { buildDeleteFile, buildNewEncryptedFile, buildNewPublicFile, buildShareFile, buildTransferFileOwnership, buildUpdateFileMetadata, } from "../ptb/file.js";
+import { findCreatedId } from "./internal.js";
+const MAX_FILE_NAME_LENGTH = 256;
+const MAX_CONTENT_TYPE_LENGTH = 255;
+/**
+ * Register on-chain metadata for an encrypted file already uploaded to Walrus.
+ * The bytes at `blobId` MUST be Seal-encrypted under an identity built from
+ * `allowlistId` (see `buildAllowlistSealId`); otherwise consumers will fail
+ * to decrypt. The SDK does not verify this binding.
+ *
+ * @throws {ValidationError} If `name` or `contentType` is empty or exceeds length limits.
+ * @throws {ContractAbortError} On Move abort (e.g. empty blob_id).
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function createEncryptedFile(adapter, config, args) {
+    validateFileFields(args.name, args.contentType);
+    const tx = new Transaction();
+    const created = buildNewEncryptedFile(tx, {
+        packageId: config.packageId,
+        blobId: args.blobId,
+        ...(args.blobObjectId === undefined
+            ? {}
+            : { blobObjectId: args.blobObjectId }),
+        name: args.name,
+        contentType: args.contentType,
+        size: args.size,
+        allowlistId: args.allowlistId,
+    });
+    const fileArg = created;
+    buildShareFile(tx, { packageId: config.packageId, file: fileArg });
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    // See ops/allowlist.ts: file::EncryptedFile was introduced in v2; type
+    // identity is rooted at config.packageId, not originalPackageId.
+    const typePrefix = config.packageId;
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        fileId: toEncryptedFileId(findCreatedId(receipt, `${typePrefix}::file::EncryptedFile`)),
+    };
+}
+/**
+ * Register on-chain metadata for an unencrypted file. The bytes at `blobId`
+ * are publicly readable via the Walrus aggregator.
+ */
+export async function createPublicFile(adapter, config, args) {
+    validateFileFields(args.name, args.contentType);
+    const tx = new Transaction();
+    const created = buildNewPublicFile(tx, {
+        packageId: config.packageId,
+        blobId: args.blobId,
+        ...(args.blobObjectId === undefined
+            ? {}
+            : { blobObjectId: args.blobObjectId }),
+        name: args.name,
+        contentType: args.contentType,
+        size: args.size,
+    });
+    const fileArg = created;
+    buildShareFile(tx, { packageId: config.packageId, file: fileArg });
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    // See ops/allowlist.ts: file::EncryptedFile was introduced in v2; type
+    // identity is rooted at config.packageId, not originalPackageId.
+    const typePrefix = config.packageId;
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        fileId: toEncryptedFileId(findCreatedId(receipt, `${typePrefix}::file::EncryptedFile`)),
+    };
+}
+/**
+ * Update the file's `name` and `content_type`. Other fields are immutable
+ * post-creation; create a new file record to swap the blob or change the
+ * allowlist. Owner only (sender must equal `file.owner` on-chain).
+ */
+export async function updateFileMetadata(adapter, config, args) {
+    validateFileFields(args.name, args.contentType);
+    const tx = new Transaction();
+    buildUpdateFileMetadata(tx, {
+        packageId: config.packageId,
+        fileId: args.fileId,
+        name: args.name,
+        contentType: args.contentType,
+    });
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return { digest: receipt.digest, gasUsedMist: receipt.gasUsedMist };
+}
+/**
+ * Transfer the metadata-mutation right to a new address. Decryption access
+ * is governed separately by the file's allowlist; the new owner must be
+ * added to that allowlist (and the previous owner removed, if desired) by
+ * the Cap holder. The two operations can be composed in one PTB by the
+ * caller if both rights need to move together.
+ */
+export async function transferFileOwnership(adapter, config, args) {
+    const tx = new Transaction();
+    buildTransferFileOwnership(tx, {
+        packageId: config.packageId,
+        fileId: args.fileId,
+        newOwner: args.newOwner,
+    });
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return { digest: receipt.digest, gasUsedMist: receipt.gasUsedMist };
+}
+/**
+ * Delete the on-chain metadata record. Does NOT delete the Walrus blob;
+ * that follows the Walrus lease lifecycle independently.
+ */
+export async function deleteFile(adapter, config, args) {
+    const tx = new Transaction();
+    buildDeleteFile(tx, {
+        packageId: config.packageId,
+        fileId: args.fileId,
+    });
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return { digest: receipt.digest, gasUsedMist: receipt.gasUsedMist };
+}
+function validateFileFields(name, contentType) {
+    if (name.length === 0) {
+        throw new ValidationError("File name cannot be empty", "name");
+    }
+    if (name.length > MAX_FILE_NAME_LENGTH) {
+        throw new ValidationError(`File name exceeds ${MAX_FILE_NAME_LENGTH} chars`, "name");
+    }
+    if (contentType.length === 0) {
+        throw new ValidationError("Content type cannot be empty", "contentType");
+    }
+    if (contentType.length > MAX_CONTENT_TYPE_LENGTH) {
+        throw new ValidationError(`Content type exceeds ${MAX_CONTENT_TYPE_LENGTH} chars`, "contentType");
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/ops/file.js.map

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

package/dist/ops/index.d.ts

@@ -1,9 +1,12 @@
 /**
  * Public barrel for the high-level ops layer.
  */
+export { type AddMemberArgs, type AllowlistOpResult, addMember, type CreateAllowlistArgs, type CreateAllowlistResult, createAllowlist, type DeleteAllowlistArgs, deleteAllowlist, type RemoveMemberArgs, removeMember, type TransferAllowlistCapArgs, transferAllowlistCap, } from "./allowlist.js";
 export { type DestroyPublisherCapArgs, type DestroyPublisherCapResult, destroyPublisherCap, type IssuePublisherCapArgs, type IssuePublisherCapResult, issuePublisherCap, type RevokePublisherCapArgs, type RevokePublisherCapResult, revokePublisherCap, type TransferPublisherCapArgs, type TransferPublisherCapResult, transferPublisherCap, } from "./cap.js";
 export { type CreateCollectionArgs, type CreateCollectionResult, createCollection, type DeleteCollectionArgs, type DeleteCollectionResult, deleteCollection, } from "./collection.js";
 export { type AddEncryptedEntryArgs, type AddEntryArgs, type AddEntryResult, type AppendDraftRevisionArgs, type AppendEncryptedDraftRevisionArgs, addEncryptedEntry, addEntry, appendDraftRevision, appendEncryptedDraftRevision, type DeleteEntryArgs, type DeleteEntryResult, deleteEntry, type PublishDirectArgs, type PublishFromDraftArgs, publishDirect, publishFromDraft, type RevisionAppendResult, } from "./entry.js";
 export { type AddEncryptedEntryFromBytesArgs, type AddEntryFromBytesArgs, type AddEntryFromBytesResult, addEncryptedEntryFromBytes, addEntryFromBytes, type ProgressCallback, type ProgressEvent, } from "./entry-from-bytes.js";
+export { type CreateEncryptedFileArgs, type CreateFileResult, type CreatePublicFileArgs, createEncryptedFile, createPublicFile, type DeleteFileArgs, deleteFile, type FileOpResult, type TransferFileOwnershipArgs, transferFileOwnership, type UpdateFileMetadataArgs, updateFileMetadata, } from "./file.js";
+export { type FileUploadProgressCallback, type FileUploadProgressEvent, type UploadEncryptedFileFromBytesArgs, type UploadFileResult, type UploadPublicFileFromBytesArgs, uploadEncryptedFileFromBytes, uploadPublicFileFromBytes, } from "./file-from-bytes.js";
 export { type CreatePublicationArgs, type CreatePublicationResult, createPublication, type DeletePublicationArgs, type DeletePublicationResult, deletePublication, type PublicationConfig, type TransferOwnershipArgs, type TransferOwnershipResult, transferOwnership, } from "./publication.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ops/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,oBAAoB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACrC,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,4BAA4B,EAC5B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,aAAa,EACb,gBAAgB,EAChB,KAAK,oBAAoB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,KAAK,8BAA8B,EACnC,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,0BAA0B,EAC1B,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ops/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,SAAS,EACT,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,eAAe,EACf,KAAK,mBAAmB,EACxB,eAAe,EACf,KAAK,gBAAgB,EACrB,YAAY,EACZ,KAAK,wBAAwB,EAC7B,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,oBAAoB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACrC,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,4BAA4B,EAC5B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,aAAa,EACb,gBAAgB,EAChB,KAAK,oBAAoB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,KAAK,8BAA8B,EACnC,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,0BAA0B,EAC1B,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,cAAc,EACnB,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,kBAAkB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,EACrC,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,4BAA4B,EAC5B,yBAAyB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,iBAAiB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/ops/index.js

@@ -1,9 +1,12 @@
 /**
  * Public barrel for the high-level ops layer.
  */
+export { addMember, createAllowlist, deleteAllowlist, removeMember, transferAllowlistCap, } from "./allowlist.js";
 export { destroyPublisherCap, issuePublisherCap, revokePublisherCap, transferPublisherCap, } from "./cap.js";
 export { createCollection, deleteCollection, } from "./collection.js";
 export { addEncryptedEntry, addEntry, appendDraftRevision, appendEncryptedDraftRevision, deleteEntry, publishDirect, publishFromDraft, } from "./entry.js";
 export { addEncryptedEntryFromBytes, addEntryFromBytes, } from "./entry-from-bytes.js";
+export { createEncryptedFile, createPublicFile, deleteFile, transferFileOwnership, updateFileMetadata, } from "./file.js";
+export { uploadEncryptedFileFromBytes, uploadPublicFileFromBytes, } from "./file-from-bytes.js";
 export { createPublication, deletePublication, transferOwnership, } from "./publication.js";
 //# sourceMappingURL=index.js.map

package/dist/ops/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ops/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGN,mBAAmB,EAGnB,iBAAiB,EAGjB,kBAAkB,EAGlB,oBAAoB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAGN,gBAAgB,EAGhB,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAMN,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,4BAA4B,EAG5B,WAAW,EAGX,aAAa,EACb,gBAAgB,GAEhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIN,0BAA0B,EAC1B,iBAAiB,GAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAGN,iBAAiB,EAGjB,iBAAiB,EAIjB,iBAAiB,GACjB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ops/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGN,SAAS,EAGT,eAAe,EAEf,eAAe,EAEf,YAAY,EAEZ,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAGN,mBAAmB,EAGnB,iBAAiB,EAGjB,kBAAkB,EAGlB,oBAAoB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAGN,gBAAgB,EAGhB,gBAAgB,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAMN,iBAAiB,EACjB,QAAQ,EACR,mBAAmB,EACnB,4BAA4B,EAG5B,WAAW,EAGX,aAAa,EACb,gBAAgB,GAEhB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIN,0BAA0B,EAC1B,iBAAiB,GAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAIN,mBAAmB,EACnB,gBAAgB,EAEhB,UAAU,EAGV,qBAAqB,EAErB,kBAAkB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAMN,4BAA4B,EAC5B,yBAAyB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGN,iBAAiB,EAGjB,iBAAiB,EAIjB,iBAAiB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/ptb/allowlist.d.ts

@@ -0,0 +1,65 @@
+/**
+ * PTB builders for `allowlist` module Move calls. Internal to the SDK;
+ * `ops/allowlist.ts` composes these into single atomic transactions.
+ */
+import type { Transaction, TransactionArgument, TransactionResult } from "@mysten/sui/transactions";
+import type { AllowlistCapId, AllowlistId, PackageId, SuiAddress } from "../types.js";
+export interface BuildNewAllowlistArgs {
+    readonly packageId: PackageId;
+    readonly name: string;
+}
+/**
+ * Add an `allowlist::new_allowlist` call. The result destructures into
+ * `[allowlist, cap]` in tuple order.
+ */
+export declare function buildNewAllowlist(tx: Transaction, args: BuildNewAllowlistArgs): TransactionResult;
+export interface BuildShareAllowlistArgs {
+    readonly packageId: PackageId;
+    readonly allowlist: TransactionArgument;
+}
+/** Add an `allowlist::share_allowlist` call. Consumes the allowlist. */
+export declare function buildShareAllowlist(tx: Transaction, args: BuildShareAllowlistArgs): TransactionResult;
+export interface BuildTransferAllowlistCapArgs {
+    readonly packageId: PackageId;
+    readonly cap: TransactionArgument | AllowlistCapId;
+    readonly recipient: SuiAddress;
+}
+/**
+ * Add an `allowlist::transfer_cap` call. Use this instead of `tx.transferObjects`
+ * because `Cap` is key-only (no `store`); the contract's typed transfer is the
+ * only way to move it.
+ */
+export declare function buildTransferAllowlistCap(tx: Transaction, args: BuildTransferAllowlistCapArgs): TransactionResult;
+export interface BuildAddMemberArgs {
+    readonly packageId: PackageId;
+    readonly allowlistId: AllowlistId;
+    readonly capId: AllowlistCapId;
+    readonly member: SuiAddress;
+}
+export declare function buildAddMember(tx: Transaction, args: BuildAddMemberArgs): TransactionResult;
+export interface BuildRemoveMemberArgs {
+    readonly packageId: PackageId;
+    readonly allowlistId: AllowlistId;
+    readonly capId: AllowlistCapId;
+    readonly member: SuiAddress;
+}
+export declare function buildRemoveMember(tx: Transaction, args: BuildRemoveMemberArgs): TransactionResult;
+export interface BuildDeleteAllowlistArgs {
+    readonly packageId: PackageId;
+    readonly allowlistId: AllowlistId;
+    readonly capId: AllowlistCapId;
+}
+export declare function buildDeleteAllowlist(tx: Transaction, args: BuildDeleteAllowlistArgs): TransactionResult;
+export interface BuildSealApproveAllowlistArgs {
+    readonly packageId: PackageId;
+    readonly identity: Uint8Array;
+    readonly allowlistId: AllowlistId;
+}
+/**
+ * Add a dry-run-only `allowlist::seal_approve` call. Seal key servers execute
+ * this against a dry-run of the PTB to decide whether to release decryption
+ * key shares; the transaction is not submitted on-chain. The `identity` bytes
+ * must be the same `SealId` used to encrypt the content.
+ */
+export declare function buildSealApproveAllowlist(tx: Transaction, args: BuildSealApproveAllowlistArgs): TransactionResult;
+//# sourceMappingURL=allowlist.d.ts.map

package/dist/ptb/allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../src/ptb/allowlist.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,SAAS,EACT,UAAU,EACV,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,qBAAqB,GACzB,iBAAiB,CAKnB;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;CACxC;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAClC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,uBAAuB,GAC3B,iBAAiB,CAKnB;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,mBAAmB,GAAG,cAAc,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,6BAA6B,GACjC,iBAAiB,CAMnB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAgB,cAAc,CAC7B,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,kBAAkB,GACtB,iBAAiB,CASnB;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAChC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,qBAAqB,GACzB,iBAAiB,CASnB;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAC/B;AAED,wBAAgB,oBAAoB,CACnC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,wBAAwB,GAC5B,iBAAiB,CAKnB;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,6BAA6B,GACjC,iBAAiB,CAQnB"}

package/dist/ptb/allowlist.js

@@ -0,0 +1,75 @@
+/**
+ * PTB builders for `allowlist` module Move calls. Internal to the SDK;
+ * `ops/allowlist.ts` composes these into single atomic transactions.
+ */
+/**
+ * Add an `allowlist::new_allowlist` call. The result destructures into
+ * `[allowlist, cap]` in tuple order.
+ */
+export function buildNewAllowlist(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::allowlist::new_allowlist`,
+        arguments: [tx.pure.string(args.name)],
+    });
+}
+/** Add an `allowlist::share_allowlist` call. Consumes the allowlist. */
+export function buildShareAllowlist(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::allowlist::share_allowlist`,
+        arguments: [args.allowlist],
+    });
+}
+/**
+ * Add an `allowlist::transfer_cap` call. Use this instead of `tx.transferObjects`
+ * because `Cap` is key-only (no `store`); the contract's typed transfer is the
+ * only way to move it.
+ */
+export function buildTransferAllowlistCap(tx, args) {
+    const cap = typeof args.cap === "string" ? tx.object(args.cap) : args.cap;
+    return tx.moveCall({
+        target: `${args.packageId}::allowlist::transfer_cap`,
+        arguments: [cap, tx.pure.address(args.recipient)],
+    });
+}
+export function buildAddMember(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::allowlist::add_member`,
+        arguments: [
+            tx.object(args.allowlistId),
+            tx.object(args.capId),
+            tx.pure.address(args.member),
+        ],
+    });
+}
+export function buildRemoveMember(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::allowlist::remove_member`,
+        arguments: [
+            tx.object(args.allowlistId),
+            tx.object(args.capId),
+            tx.pure.address(args.member),
+        ],
+    });
+}
+export function buildDeleteAllowlist(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::allowlist::delete_allowlist`,
+        arguments: [tx.object(args.allowlistId), tx.object(args.capId)],
+    });
+}
+/**
+ * Add a dry-run-only `allowlist::seal_approve` call. Seal key servers execute
+ * this against a dry-run of the PTB to decide whether to release decryption
+ * key shares; the transaction is not submitted on-chain. The `identity` bytes
+ * must be the same `SealId` used to encrypt the content.
+ */
+export function buildSealApproveAllowlist(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::allowlist::seal_approve`,
+        arguments: [
+            tx.pure.vector("u8", Array.from(args.identity)),
+            tx.object(args.allowlistId),
+        ],
+    });
+}
+//# sourceMappingURL=allowlist.js.map

package/dist/ptb/allowlist.js.map

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

package/dist/ptb/file.d.ts

@@ -0,0 +1,58 @@
+/**
+ * PTB builders for `file` module Move calls. Internal to the SDK;
+ * `ops/file.ts` composes these into single atomic transactions.
+ */
+import type { Transaction, TransactionArgument, TransactionResult } from "@mysten/sui/transactions";
+import type { AllowlistId, BlobObjectId, EncryptedFileId, PackageId, SuiAddress, WalrusBlobId } from "../types.js";
+export interface BuildNewEncryptedFileArgs {
+    readonly packageId: PackageId;
+    readonly blobId: WalrusBlobId;
+    readonly blobObjectId?: BlobObjectId;
+    readonly name: string;
+    readonly contentType: string;
+    readonly size: bigint;
+    readonly allowlistId: AllowlistId;
+}
+/**
+ * Add a `file::new_encrypted_file` call. Returns the new EncryptedFile as the
+ * first result. The caller must follow with `share_file` to make it accessible
+ * from any wallet.
+ */
+export declare function buildNewEncryptedFile(tx: Transaction, args: BuildNewEncryptedFileArgs): TransactionResult;
+export interface BuildNewPublicFileArgs {
+    readonly packageId: PackageId;
+    readonly blobId: WalrusBlobId;
+    readonly blobObjectId?: BlobObjectId;
+    readonly name: string;
+    readonly contentType: string;
+    readonly size: bigint;
+}
+/**
+ * Add a `file::new_public_file` call. Returns the new EncryptedFile (the
+ * `encrypted` flag is false). Follow with `share_file`.
+ */
+export declare function buildNewPublicFile(tx: Transaction, args: BuildNewPublicFileArgs): TransactionResult;
+export interface BuildShareFileArgs {
+    readonly packageId: PackageId;
+    readonly file: TransactionArgument;
+}
+export declare function buildShareFile(tx: Transaction, args: BuildShareFileArgs): TransactionResult;
+export interface BuildUpdateFileMetadataArgs {
+    readonly packageId: PackageId;
+    readonly fileId: EncryptedFileId;
+    readonly name: string;
+    readonly contentType: string;
+}
+export declare function buildUpdateFileMetadata(tx: Transaction, args: BuildUpdateFileMetadataArgs): TransactionResult;
+export interface BuildTransferFileOwnershipArgs {
+    readonly packageId: PackageId;
+    readonly fileId: EncryptedFileId;
+    readonly newOwner: SuiAddress;
+}
+export declare function buildTransferFileOwnership(tx: Transaction, args: BuildTransferFileOwnershipArgs): TransactionResult;
+export interface BuildDeleteFileArgs {
+    readonly packageId: PackageId;
+    readonly fileId: EncryptedFileId;
+}
+export declare function buildDeleteFile(tx: Transaction, args: BuildDeleteFileArgs): TransactionResult;
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/ptb/file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACX,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,EACT,UAAU,EACV,YAAY,EACZ,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,yBAAyB,GAC7B,iBAAiB,CAcnB;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,sBAAsB,GAC1B,iBAAiB,CAanB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACnC;AAED,wBAAgB,cAAc,CAC7B,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,kBAAkB,GACtB,iBAAiB,CAKnB;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,uBAAuB,CACtC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,2BAA2B,GAC/B,iBAAiB,CASnB;AAED,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;CAC9B;AAED,wBAAgB,0BAA0B,CACzC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,8BAA8B,GAClC,iBAAiB,CAKnB;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CACjC;AAED,wBAAgB,eAAe,CAC9B,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,mBAAmB,GACvB,iBAAiB,CAKnB"}

package/dist/ptb/file.js

@@ -0,0 +1,108 @@
+/**
+ * PTB builders for `file` module Move calls. Internal to the SDK;
+ * `ops/file.ts` composes these into single atomic transactions.
+ */
+/** Canonical Sui clock shared object id. The `file::new_*` calls take it as input. */
+const SUI_CLOCK_OBJECT_ID = "0x6";
+/**
+ * Add a `file::new_encrypted_file` call. Returns the new EncryptedFile as the
+ * first result. The caller must follow with `share_file` to make it accessible
+ * from any wallet.
+ */
+export function buildNewEncryptedFile(tx, args) {
+    const blobIdBytes = walrusBlobIdToBytes(args.blobId);
+    return tx.moveCall({
+        target: `${args.packageId}::file::new_encrypted_file`,
+        arguments: [
+            tx.pure.vector("u8", Array.from(blobIdBytes)),
+            optionSomeId(tx, args.blobObjectId),
+            tx.pure.string(args.name),
+            tx.pure.string(args.contentType),
+            tx.pure.u64(args.size),
+            tx.pure.address(args.allowlistId),
+            tx.object(SUI_CLOCK_OBJECT_ID),
+        ],
+    });
+}
+/**
+ * Add a `file::new_public_file` call. Returns the new EncryptedFile (the
+ * `encrypted` flag is false). Follow with `share_file`.
+ */
+export function buildNewPublicFile(tx, args) {
+    const blobIdBytes = walrusBlobIdToBytes(args.blobId);
+    return tx.moveCall({
+        target: `${args.packageId}::file::new_public_file`,
+        arguments: [
+            tx.pure.vector("u8", Array.from(blobIdBytes)),
+            optionSomeId(tx, args.blobObjectId),
+            tx.pure.string(args.name),
+            tx.pure.string(args.contentType),
+            tx.pure.u64(args.size),
+            tx.object(SUI_CLOCK_OBJECT_ID),
+        ],
+    });
+}
+export function buildShareFile(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::file::share_file`,
+        arguments: [args.file],
+    });
+}
+export function buildUpdateFileMetadata(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::file::update_metadata`,
+        arguments: [
+            tx.object(args.fileId),
+            tx.pure.string(args.name),
+            tx.pure.string(args.contentType),
+        ],
+    });
+}
+export function buildTransferFileOwnership(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::file::transfer_ownership`,
+        arguments: [tx.object(args.fileId), tx.pure.address(args.newOwner)],
+    });
+}
+export function buildDeleteFile(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::file::delete_file`,
+        arguments: [tx.object(args.fileId)],
+    });
+}
+/**
+ * Walrus blob IDs are 43-char URL-safe base64 strings carrying a 32-byte
+ * content digest. The Move layer stores them as `vector<u8>`; we decode the
+ * 32 bytes here for the PTB so on-chain reads match what Walrus returns.
+ */
+function walrusBlobIdToBytes(blobId) {
+    const base64 = blobId
+        .replace(/-/g, "+")
+        .replace(/_/g, "/");
+    const padded = base64 + "=".repeat((4 - (base64.length % 4)) % 4);
+    const binary = atob(padded);
+    const out = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i += 1) {
+        out[i] = binary.charCodeAt(i);
+    }
+    return out;
+}
+/**
+ * Build a Move `Option<ID>` argument. Sui's PTB layer does not have a native
+ * Option builder, so we go through the std::option helpers.
+ */
+function optionSomeId(tx, value) {
+    if (value === undefined) {
+        return tx.moveCall({
+            target: "0x1::option::none",
+            typeArguments: ["0x2::object::ID"],
+            arguments: [],
+        });
+    }
+    return tx.moveCall({
+        target: "0x1::option::some",
+        typeArguments: ["0x2::object::ID"],
+        arguments: [tx.pure.id(value)],
+    });
+}
+//# sourceMappingURL=file.js.map

package/dist/ptb/file.js.map

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

package/dist/read/files-events.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Event type constants and pure reconciliation helpers for the file +
+ * allowlist modules. Designed for consumers integrating a Sui indexer of
+ * their choice: fetch events from your indexer, pass them here, get back a
+ * deduplicated `EncryptedFileSummary[]` that reflects the current state.
+ *
+ * The SDK intentionally does NOT ship an event-fetching client. Sui v2 gRPC
+ * has no historical event query method, and the legacy `suix_queryEvents`
+ * JSON-RPC endpoint is on Mysten's deprecation track. Picking an indexer
+ * (Mysten public, self-hosted, third-party) is a consumer concern; the SDK
+ * owns the parsing + reconciliation logic which is the morse-contract-
+ * specific part.
+ *
+ * Pagination, retention, auth, and CORS are entirely the consumer's
+ * responsibility; they live with the indexer client, not here.
+ */
+import type { EncryptedFileSummary, PackageId, SuiAddress } from "../types.js";
+/** Fully-qualified event type strings emitted by the `file` and `allowlist` modules. */
+export interface FilesEventTypes {
+    readonly FileCreated: string;
+    readonly FileDeleted: string;
+    readonly FileMetadataUpdated: string;
+    readonly FileOwnershipTransferred: string;
+    readonly AllowlistCreated: string;
+    readonly AllowlistDeleted: string;
+    readonly MemberAdded: string;
+    readonly MemberRemoved: string;
+    readonly CapTransferred: string;
+}
+/**
+ * Build the fully-qualified event type strings for a given file-events
+ * origin package id. The origin id is the package where the event structs
+ * were FIRST defined, which is independent of `config.packageId` (the
+ * current published-at, which moves on every upgrade).
+ *
+ * Pass `config.filesEventOriginPackageId` here. The SDK ships the testnet
+ * default in `morseConfig`; custom deployments supply their own.
+ *
+ * @throws {ValidationError} If `packageId` is missing.
+ */
+export declare function buildFilesEventTypes(packageId: PackageId): FilesEventTypes;
+/**
+ * Minimal event shape consumed by the reconcile helpers. Compatible with
+ * Sui RPC `SuiEvent` and most indexer event payloads. Map your indexer's
+ * output to this shape before calling.
+ */
+export interface FilesEventInput {
+    /** Fully-qualified event type, e.g. `${pkg}::file::FileCreated`. */
+    readonly type: string;
+    /** Decoded event payload (the Move struct's fields, snake_case). */
+    readonly parsedJson: unknown;
+    /**
+     * Transaction timestamp in milliseconds, sourced from the event
+     * envelope. May be null on pending events (skip those; they do not
+     * count as confirmed history).
+     */
+    readonly timestampMs?: string | number | null;
+}
+/**
+ * Reconcile a stream of Sui events into the current set of files owned by
+ * `address`. Caller is responsible for fetching events (typically via an
+ * indexer); pass all `FileCreated`, `FileOwnershipTransferred`, and
+ * `FileDeleted` events from the event types built via `buildFilesEventTypes`.
+ *
+ * Order-independence: events are sorted internally by `timestampMs` before
+ * reconciliation, so passing them in arbitrary order produces the same
+ * result. Events with `timestampMs === null` are skipped (unconfirmed).
+ *
+ * Best-effort: if `FileOwnershipTransferred` references a `file` whose
+ * `FileCreated` is missing from the input (e.g. retention pruning), the
+ * incoming transfer is dropped silently; there is no way to recover the
+ * metadata without the original event. Increase the indexer's event
+ * window if completeness is critical.
+ */
+export declare function reconcileFilesOwnedBy(events: readonly FilesEventInput[], address: SuiAddress, eventTypes: FilesEventTypes): EncryptedFileSummary[];
+/**
+ * Reconcile a stream of events into the current set of files where
+ * `address` has decrypt access via allowlist membership. Caller passes
+ * `MemberAdded`, `MemberRemoved`, `AllowlistDeleted`, `FileCreated`, and
+ * `FileDeleted` events.
+ *
+ * Same best-effort guarantees as `reconcileFilesOwnedBy`. Files referencing
+ * an `AllowlistDeleted` allowlist are dropped (the on-chain `seal_approve`
+ * dry-run would fail for them anyway).
+ */
+export declare function reconcileFilesAccessibleBy(events: readonly FilesEventInput[], address: SuiAddress, eventTypes: FilesEventTypes): EncryptedFileSummary[];
+//# sourceMappingURL=files-events.d.ts.map

package/dist/read/files-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-events.d.ts","sourceRoot":"","sources":["../../src/read/files-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAGX,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,MAAM,aAAa,CAAC;AAErB,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,SAAS,GAAG,eAAe,CAkB1E;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9C;AAmCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,GACzB,oBAAoB,EAAE,CA+BxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,eAAe,GACzB,oBAAoB,EAAE,CA2CxB"}