@arcadiasystems/morse-sdk 0.1.0

package/dist/ops/entry.js

@@ -0,0 +1,235 @@
+/**
+ * High-level entry/revision ops. Non-encrypted, public access policy.
+ * Encrypted variants are exposed through a separate set of ops with their
+ * own args types.
+ *
+ * To surface the `u64` returned by Move (`entry_id` on add, `revision_id` on
+ * appends/publishes), each id-returning op simulates the PTB first to read
+ * the BCS-encoded return value, then signs and executes. Two RPC round-trips
+ * per call.
+ *
+ * Race-window caveat: there is a brief window between the simulate and the
+ * execute calls where another transaction can mutate the publication's
+ * shared state. In single-publisher write paths this window is narrow and
+ * the returned `entryId`/`revisionId` is reliable in practice. Under
+ * concurrent writes from multiple `PublisherCap` holders, the simulated
+ * id can be invalidated by an interleaving transaction; the SDK does not
+ * detect this and the returned id may be stale. Consumers running
+ * concurrent writers should treat the returned id as advisory and rely on
+ * `reader.listEntries(...)` for the authoritative entry set.
+ */
+import { Transaction } from "@mysten/sui/transactions";
+import { buildAddEncryptedEntry, buildAddEntry, buildAppendDraftRevision, buildAppendEncryptedDraftRevision, buildDeleteEntry, buildPublishDirect, buildPublishFromDraft, } from "../ptb/entry.js";
+import { decodeU64ReturnValue } from "./internal.js";
+/**
+ * Add a new entry to a collection with its first revision, given a
+ * pre-uploaded `blobObjectId`. For the typical "upload-then-add" flow,
+ * prefer `addEntryFromBytes`, which packs upload + addEntry into 2 wallet
+ * popups instead of 3. Use this lower-level form when reusing a blob across
+ * multiple entries (deduplication), decoupling upload time from publish
+ * time, or pre-uploading from a server.
+ *
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function addEntry(adapter, config, args) {
+    const tx = new Transaction();
+    buildAddEntry(tx, {
+        packageId: config.packageId,
+        publication: args.publicationId,
+        publisherCap: args.publisherCapId,
+        collectionName: args.collectionName,
+        name: args.name,
+        blobObjectId: args.blobObjectId,
+        ...(args.quiltPatchId === undefined
+            ? {}
+            : { quiltPatchId: args.quiltPatchId }),
+        contentType: args.contentType,
+    });
+    const simulated = await adapter.simulateTransaction(tx, args.signal);
+    const entryId = decodeU64ReturnValue(simulated, 0, 0);
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        entryId,
+        revisionId: 0,
+    };
+}
+/**
+ * Append a draft revision to an existing entry.
+ * @throws {ContractAbortError} On Move abort (e.g. entry not found surfaces as
+ *   `module: "collection", reason: "EEntryNotFound"`).
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function appendDraftRevision(adapter, config, args) {
+    const tx = new Transaction();
+    buildAppendDraftRevision(tx, {
+        packageId: config.packageId,
+        publication: args.publicationId,
+        publisherCap: args.publisherCapId,
+        collectionName: args.collectionName,
+        entryId: args.entryId,
+        blobObjectId: args.blobObjectId,
+        ...(args.quiltPatchId === undefined
+            ? {}
+            : { quiltPatchId: args.quiltPatchId }),
+        contentType: args.contentType,
+    });
+    const simulated = await adapter.simulateTransaction(tx, args.signal);
+    const revisionId = decodeU64ReturnValue(simulated, 0, 0);
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        revisionId,
+    };
+}
+/**
+ * Promote a draft to public. Despite the name, this appends a *new* public
+ * revision; `draftRevisionId` is only used by the contract to validate that
+ * the draft exists. `blobObjectId`/`quiltPatchId` are the published content
+ * and may differ from the draft's.
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function publishFromDraft(adapter, config, args) {
+    const tx = new Transaction();
+    buildPublishFromDraft(tx, {
+        packageId: config.packageId,
+        publication: args.publicationId,
+        publisherCap: args.publisherCapId,
+        collectionName: args.collectionName,
+        entryId: args.entryId,
+        draftRevisionId: args.draftRevisionId,
+        blobObjectId: args.blobObjectId,
+        ...(args.quiltPatchId === undefined
+            ? {}
+            : { quiltPatchId: args.quiltPatchId }),
+        contentType: args.contentType,
+    });
+    const simulated = await adapter.simulateTransaction(tx, args.signal);
+    const revisionId = decodeU64ReturnValue(simulated, 0, 0);
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        revisionId,
+    };
+}
+/**
+ * Append a public, non-encrypted revision in one step (no draft).
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function publishDirect(adapter, config, args) {
+    const tx = new Transaction();
+    buildPublishDirect(tx, {
+        packageId: config.packageId,
+        publication: args.publicationId,
+        publisherCap: args.publisherCapId,
+        collectionName: args.collectionName,
+        entryId: args.entryId,
+        blobObjectId: args.blobObjectId,
+        ...(args.quiltPatchId === undefined
+            ? {}
+            : { quiltPatchId: args.quiltPatchId }),
+        contentType: args.contentType,
+    });
+    const simulated = await adapter.simulateTransaction(tx, args.signal);
+    const revisionId = decodeU64ReturnValue(simulated, 0, 0);
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        revisionId,
+    };
+}
+/**
+ * Delete an entry from a collection. No client-side preflight.
+ * @throws {ContractAbortError} On Move abort. Missing entry surfaces as
+ *   `module: "collection", reason: "EEntryNotFound"`.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function deleteEntry(adapter, config, args) {
+    const tx = new Transaction();
+    buildDeleteEntry(tx, {
+        packageId: config.packageId,
+        publication: args.publicationId,
+        publisherCap: args.publisherCapId,
+        collectionName: args.collectionName,
+        entryId: args.entryId,
+    });
+    return adapter.signAndExecuteTransaction(tx, args.signal);
+}
+/**
+ * Add a new entry whose first revision is encrypted under the supplied
+ * `sealId` with the Publisher access policy, given pre-encrypted ciphertext
+ * already uploaded to Walrus. For the typical encrypt-upload-add flow,
+ * prefer `addEncryptedEntryFromBytes`, which handles encryption and 2-popup
+ * upload in a single call. Use this lower-level form when ciphertext
+ * already exists, you want to attach the same ciphertext to multiple
+ * entries, or you upload from a different process than the one calling
+ * this op.
+ *
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function addEncryptedEntry(adapter, config, args) {
+    const tx = new Transaction();
+    buildAddEncryptedEntry(tx, {
+        packageId: config.packageId,
+        publication: args.publicationId,
+        publisherCap: args.publisherCapId,
+        collectionName: args.collectionName,
+        name: args.name,
+        blobObjectId: args.blobObjectId,
+        ...(args.quiltPatchId === undefined
+            ? {}
+            : { quiltPatchId: args.quiltPatchId }),
+        contentType: args.contentType,
+        sealId: args.sealId,
+    });
+    const simulated = await adapter.simulateTransaction(tx, args.signal);
+    const entryId = decodeU64ReturnValue(simulated, 0, 0);
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        entryId,
+        revisionId: 0,
+    };
+}
+/**
+ * Append an encrypted draft revision to an existing entry. Each revision
+ * carries its own `sealId`; passing a different identity from the prior
+ * revision is valid on-chain.
+ *
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function appendEncryptedDraftRevision(adapter, config, args) {
+    const tx = new Transaction();
+    buildAppendEncryptedDraftRevision(tx, {
+        packageId: config.packageId,
+        publication: args.publicationId,
+        publisherCap: args.publisherCapId,
+        collectionName: args.collectionName,
+        entryId: args.entryId,
+        blobObjectId: args.blobObjectId,
+        ...(args.quiltPatchId === undefined
+            ? {}
+            : { quiltPatchId: args.quiltPatchId }),
+        contentType: args.contentType,
+        sealId: args.sealId,
+    });
+    const simulated = await adapter.simulateTransaction(tx, args.signal);
+    const revisionId = decodeU64ReturnValue(simulated, 0, 0);
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        revisionId,
+    };
+}
+//# sourceMappingURL=entry.js.map

package/dist/ops/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/ops/entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,EACN,sBAAsB,EACtB,aAAa,EACb,wBAAwB,EACxB,iCAAiC,EACjC,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACrB,MAAM,iBAAiB,CAAC;AAUzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAsBrD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC7B,OAAsB,EACtB,MAA0B,EAC1B,IAAkB;IAElB,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;QAC/B,YAAY,EAAE,IAAI,CAAC,cAAc;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW;KAC7B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,yBAAyB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO;QACP,UAAU,EAAE,CAAC;KACb,CAAC;AACH,CAAC;AAoBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAsB,EACtB,MAA0B,EAC1B,IAA6B;IAE7B,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,wBAAwB,CAAC,EAAE,EAAE;QAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;QAC/B,YAAY,EAAE,IAAI,CAAC,cAAc;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW;KAC7B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,yBAAyB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU;KACV,CAAC;AACH,CAAC;AAcD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,OAAsB,EACtB,MAA0B,EAC1B,IAA0B;IAE1B,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,qBAAqB,CAAC,EAAE,EAAE;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;QAC/B,YAAY,EAAE,IAAI,CAAC,cAAc;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW;KAC7B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,yBAAyB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU;KACV,CAAC;AACH,CAAC;AAaD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,OAAsB,EACtB,MAA0B,EAC1B,IAAuB;IAEvB,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,EAAE;QACtB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;QAC/B,YAAY,EAAE,IAAI,CAAC,cAAc;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW;KAC7B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,yBAAyB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU;KACV,CAAC;AACH,CAAC;AAYD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,OAAsB,EACtB,MAA0B,EAC1B,IAAqB;IAErB,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,gBAAgB,CAAC,EAAE,EAAE;QACpB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;QAC/B,YAAY,EAAE,IAAI,CAAC,cAAc;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO;KACrB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,yBAAyB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,CAAC;AAcD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,OAAsB,EACtB,MAA0B,EAC1B,IAA2B;IAE3B,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,sBAAsB,CAAC,EAAE,EAAE;QAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;QAC/B,YAAY,EAAE,IAAI,CAAC,cAAc;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;KACnB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,oBAAoB,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,yBAAyB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,OAAO;QACP,UAAU,EAAE,CAAC;KACb,CAAC;AACH,CAAC;AAcD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CACjD,OAAsB,EACtB,MAA0B,EAC1B,IAAsC;IAEtC,MAAM,EAAE,GAAG,IAAI,WAAW,EAAE,CAAC;IAC7B,iCAAiC,CAAC,EAAE,EAAE;QACrC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,IAAI,CAAC,aAAa;QAC/B,YAAY,EAAE,IAAI,CAAC,cAAc;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;KACnB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,oBAAoB,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,yBAAyB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU;KACV,CAAC;AACH,CAAC"}

package/dist/ops/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Public barrel for the high-level ops layer.
+ */
+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 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

@@ -0,0 +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"}

package/dist/ops/index.js

@@ -0,0 +1,9 @@
+/**
+ * Public barrel for the high-level ops layer.
+ */
+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 { createPublication, deletePublication, transferOwnership, } from "./publication.js";
+//# sourceMappingURL=index.js.map

package/dist/ops/index.js.map

@@ -0,0 +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"}

package/dist/ops/internal.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared helpers for ops. Internal to `ops/`; not exported from `src/index.ts`.
+ */
+import type { TxReceipt } from "../types.js";
+import type { SimulationReturnValues } from "../wallets/adapter.js";
+/**
+ * Find the object ID of the single created object whose type exactly matches
+ * `expectedType`. Used to extract typed handles from a transaction receipt.
+ *
+ * @throws {TransportError} If no created object matches the expected type.
+ */
+export declare function findCreatedId(receipt: TxReceipt, expectedType: string): string;
+/**
+ * Decode a `u64` return value from a simulated PTB. Validates the result is a
+ * safe JS integer; on overflow or shape mismatch, throws `TransportError`.
+ *
+ * @throws {TransportError} If the indices are out of range or the value
+ *   exceeds `Number.MAX_SAFE_INTEGER`.
+ */
+export declare function decodeU64ReturnValue(values: SimulationReturnValues, commandIndex: number, returnIndex: number): number;
+//# sourceMappingURL=internal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/ops/internal.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC5B,OAAO,EAAE,SAAS,EAClB,YAAY,EAAE,MAAM,GAClB,MAAM,CAUR;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,sBAAsB,EAC9B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GACjB,MAAM,CAqBR"}

package/dist/ops/internal.js

@@ -0,0 +1,42 @@
+/**
+ * Shared helpers for ops. Internal to `ops/`; not exported from `src/index.ts`.
+ */
+import { bcs } from "@mysten/sui/bcs";
+import { TransportError } from "../errors.js";
+/**
+ * Find the object ID of the single created object whose type exactly matches
+ * `expectedType`. Used to extract typed handles from a transaction receipt.
+ *
+ * @throws {TransportError} If no created object matches the expected type.
+ */
+export function findCreatedId(receipt, expectedType) {
+    const created = receipt.createdObjects.find((object) => object.objectType === expectedType);
+    if (!created) {
+        throw new TransportError(`Receipt is missing a created object of type ${expectedType}`);
+    }
+    return created.objectId;
+}
+/**
+ * Decode a `u64` return value from a simulated PTB. Validates the result is a
+ * safe JS integer; on overflow or shape mismatch, throws `TransportError`.
+ *
+ * @throws {TransportError} If the indices are out of range or the value
+ *   exceeds `Number.MAX_SAFE_INTEGER`.
+ */
+export function decodeU64ReturnValue(values, commandIndex, returnIndex) {
+    const command = values[commandIndex];
+    if (!command) {
+        throw new TransportError(`Simulation has no command at index ${commandIndex} (got ${values.length} commands)`);
+    }
+    const bytes = command[returnIndex];
+    if (!bytes) {
+        throw new TransportError(`Simulation command ${commandIndex} has no return value at index ${returnIndex} (got ${command.length} return values)`);
+    }
+    const decoded = bcs.u64().parse(bytes);
+    const asNumber = Number(decoded);
+    if (!Number.isSafeInteger(asNumber)) {
+        throw new TransportError(`Simulated u64 return value ${decoded} exceeds Number.MAX_SAFE_INTEGER`);
+    }
+    return asNumber;
+}
+//# sourceMappingURL=internal.js.map

package/dist/ops/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/ops/internal.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC5B,OAAkB,EAClB,YAAoB;IAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAC1C,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,KAAK,YAAY,CAC9C,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,cAAc,CACvB,+CAA+C,YAAY,EAAE,CAC7D,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC;AACzB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CACnC,MAA8B,EAC9B,YAAoB,EACpB,WAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,cAAc,CACvB,sCAAsC,YAAY,SAAS,MAAM,CAAC,MAAM,YAAY,CACpF,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,cAAc,CACvB,sBAAsB,YAAY,iCAAiC,WAAW,SAAS,OAAO,CAAC,MAAM,iBAAiB,CACtH,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,cAAc,CACvB,8BAA8B,OAAO,kCAAkC,CACvE,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/ops/publication.d.ts

@@ -0,0 +1,74 @@
+/**
+ * High-level publication ops: build a PTB, sign and execute via the wallet
+ * adapter, parse the receipt into a typed result.
+ */
+import type { MorsePackageConfig, NetworkConfig } from "../config.js";
+import type { PublicationReader } from "../read/reader.js";
+import type { OwnerCapId, PublicationId, PublisherCapId, SuiAddress } from "../types.js";
+import type { WalletAdapter } from "../wallets/adapter.js";
+/** Subset of `NetworkConfig` required by publication ops; adds `registryId` to `MorsePackageConfig`. */
+export type PublicationConfig = MorsePackageConfig & Pick<NetworkConfig, "registryId">;
+export interface CreatePublicationArgs {
+    readonly name: string;
+    readonly slug: string;
+    readonly signal?: AbortSignal;
+}
+export interface CreatePublicationResult {
+    readonly digest: string;
+    readonly gasUsedMist: bigint;
+    readonly publicationId: PublicationId;
+    readonly ownerCapId: OwnerCapId;
+    readonly publisherCapId: PublisherCapId;
+}
+/**
+ * Create a publication, share it, and transfer the resulting OwnerCap and
+ * the first PublisherCap to `adapter.address` — all in one atomic PTB. The
+ * caller can immediately use the returned `publisherCapId` for write ops
+ * and the `ownerCapId` for governance ops (issue/revoke caps, delete).
+ *
+ * Slug constraints (validated client-side and on-chain): non-empty,
+ * 1-64 chars, lowercase alphanumeric and hyphens, no leading or trailing
+ * hyphen. `ESlugAlreadyExists` aborts on collision with another active
+ * publication's slug.
+ *
+ * @throws {ValidationError} If `slug` violates the format rules.
+ * @throws {ContractAbortError} On Move abort (e.g. slug already taken).
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function createPublication(adapter: WalletAdapter, config: PublicationConfig, args: CreatePublicationArgs): Promise<CreatePublicationResult>;
+export interface DeletePublicationArgs {
+    readonly publicationId: PublicationId;
+    readonly ownerCapId: OwnerCapId;
+    readonly signal?: AbortSignal;
+}
+export interface DeletePublicationResult {
+    readonly digest: string;
+    readonly gasUsedMist: bigint;
+}
+/**
+ * Delete a publication. The client-side collection check is best-effort
+ * pre-flight; a concurrent transaction can still add a collection between
+ * the reader call and the delete, in which case the on-chain `destroy_empty`
+ * abort surfaces as `ContractAbortError`.
+ * @throws {ValidationError} If the publication still has collections at read time.
+ * @throws {NotFoundError} If the publication does not exist.
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function deletePublication(reader: PublicationReader, adapter: WalletAdapter, config: PublicationConfig, args: DeletePublicationArgs): Promise<DeletePublicationResult>;
+export interface TransferOwnershipArgs {
+    readonly ownerCapId: OwnerCapId;
+    readonly recipient: SuiAddress;
+    readonly signal?: AbortSignal;
+}
+export interface TransferOwnershipResult {
+    readonly digest: string;
+    readonly gasUsedMist: bigint;
+}
+/**
+ * Transfer the OwnerCap to a new address.
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export declare function transferOwnership(adapter: WalletAdapter, config: PublicationConfig, args: TransferOwnershipArgs): Promise<TransferOwnershipResult>;
+//# sourceMappingURL=publication.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../../src/ops/publication.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAStE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,cAAc,EACd,UAAU,EACV,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,wGAAwG;AACxG,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GACjD,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AAKnC,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACxC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,qBAAqB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CA+ClC;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,qBAAqB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CA0BlC;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,qBAAqB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAclC"}

package/dist/ops/publication.js

@@ -0,0 +1,123 @@
+/**
+ * High-level publication ops: build a PTB, sign and execute via the wallet
+ * adapter, parse the receipt into a typed result.
+ */
+import { Transaction, } from "@mysten/sui/transactions";
+import { toOwnerCapId, toPublicationId, toPublisherCapId } from "../codecs.js";
+import { ValidationError } from "../errors.js";
+import { buildCreatePublication, buildDeletePublication, buildSharePublication, buildTransferOwnerCap, buildTransferPublisherCap, } from "../ptb/publication.js";
+import { findCreatedId } from "./internal.js";
+const MAX_SLUG_LENGTH = 64;
+const SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
+/**
+ * Create a publication, share it, and transfer the resulting OwnerCap and
+ * the first PublisherCap to `adapter.address` — all in one atomic PTB. The
+ * caller can immediately use the returned `publisherCapId` for write ops
+ * and the `ownerCapId` for governance ops (issue/revoke caps, delete).
+ *
+ * Slug constraints (validated client-side and on-chain): non-empty,
+ * 1-64 chars, lowercase alphanumeric and hyphens, no leading or trailing
+ * hyphen. `ESlugAlreadyExists` aborts on collision with another active
+ * publication's slug.
+ *
+ * @throws {ValidationError} If `slug` violates the format rules.
+ * @throws {ContractAbortError} On Move abort (e.g. slug already taken).
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function createPublication(adapter, config, args) {
+    validateSlug(args.slug);
+    const tx = new Transaction();
+    const created = buildCreatePublication(tx, {
+        packageId: config.packageId,
+        registryId: config.registryId,
+        name: args.name,
+        slug: args.slug,
+    });
+    // new_publication returns (Publication, OwnerCap, PublisherCap); all object results.
+    const publicationArg = created[0];
+    const ownerCapArg = created[1];
+    const publisherCapArg = created[2];
+    buildSharePublication(tx, {
+        packageId: config.packageId,
+        publication: publicationArg,
+    });
+    // Caps are key-only; tx.transferObjects requires `store`. Use the contract's
+    // typed transfer wrappers instead.
+    buildTransferOwnerCap(tx, {
+        packageId: config.packageId,
+        ownerCap: ownerCapArg,
+        recipient: adapter.address,
+    });
+    buildTransferPublisherCap(tx, {
+        packageId: config.packageId,
+        publisherCap: publisherCapArg,
+        recipient: adapter.address,
+    });
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    const typePrefix = config.originalPackageId ?? config.packageId;
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+        publicationId: toPublicationId(findCreatedId(receipt, `${typePrefix}::publication::Publication`)),
+        ownerCapId: toOwnerCapId(findCreatedId(receipt, `${typePrefix}::publication::OwnerCap`)),
+        publisherCapId: toPublisherCapId(findCreatedId(receipt, `${typePrefix}::publication::PublisherCap`)),
+    };
+}
+/**
+ * Delete a publication. The client-side collection check is best-effort
+ * pre-flight; a concurrent transaction can still add a collection between
+ * the reader call and the delete, in which case the on-chain `destroy_empty`
+ * abort surfaces as `ContractAbortError`.
+ * @throws {ValidationError} If the publication still has collections at read time.
+ * @throws {NotFoundError} If the publication does not exist.
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function deletePublication(reader, adapter, config, args) {
+    const publication = await reader.getPublication(args.publicationId, args.signal);
+    if (publication.collections.length > 0) {
+        throw new ValidationError(`Cannot delete publication with ${publication.collections.length} collection(s); remove them first`, "publication.collections");
+    }
+    const tx = new Transaction();
+    buildDeletePublication(tx, {
+        packageId: config.packageId,
+        registryId: config.registryId,
+        publicationId: args.publicationId,
+        ownerCapId: args.ownerCapId,
+    });
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+    };
+}
+/**
+ * Transfer the OwnerCap to a new address.
+ * @throws {ContractAbortError} On Move abort.
+ * @throws {TransportError} On RPC, network, or response-parsing failure.
+ */
+export async function transferOwnership(adapter, config, args) {
+    const tx = new Transaction();
+    buildTransferOwnerCap(tx, {
+        packageId: config.packageId,
+        ownerCap: args.ownerCapId,
+        recipient: args.recipient,
+    });
+    const receipt = await adapter.signAndExecuteTransaction(tx, args.signal);
+    return {
+        digest: receipt.digest,
+        gasUsedMist: receipt.gasUsedMist,
+    };
+}
+function validateSlug(slug) {
+    if (slug.length === 0) {
+        throw new ValidationError("Slug cannot be empty", "slug");
+    }
+    if (slug.length > MAX_SLUG_LENGTH) {
+        throw new ValidationError(`Slug exceeds maximum length of ${MAX_SLUG_LENGTH} characters`, "slug");
+    }
+    if (!SLUG_PATTERN.test(slug)) {
+        throw new ValidationError("Slug must contain only lowercase alphanumeric characters and hyphens, and cannot start or end with a hyphen", "slug");
+    }
+}
+//# sourceMappingURL=publication.js.map

package/dist/ops/publication.js.map

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

package/dist/ptb/cap.d.ts

@@ -0,0 +1,36 @@
+/**
+ * PTB builders for PublisherCap lifecycle Move calls. Internal to the SDK.
+ */
+import type { Transaction, TransactionObjectArgument, TransactionResult } from "@mysten/sui/transactions";
+import type { OwnerCapId, PackageId, PublicationId, PublisherCapId, SuiAddress } from "../types.js";
+export interface BuildIssuePublisherCapArgs {
+    readonly packageId: PackageId;
+    readonly publicationId: PublicationId | TransactionObjectArgument;
+    readonly ownerCap: OwnerCapId | TransactionObjectArgument;
+    readonly holder: SuiAddress;
+}
+/**
+ * Add a `publication::issue_publisher_cap` call. Returns the result handle for
+ * the freshly-minted `PublisherCap`; caller is responsible for transferring it
+ * to the bound holder address (typically via `buildTransferPublisherCap`).
+ */
+export declare function buildIssuePublisherCap(tx: Transaction, args: BuildIssuePublisherCapArgs): TransactionResult;
+export interface BuildRevokePublisherCapArgs {
+    readonly packageId: PackageId;
+    readonly publicationId: PublicationId | TransactionObjectArgument;
+    readonly ownerCap: OwnerCapId | TransactionObjectArgument;
+    readonly publisherCapId: PublisherCapId;
+}
+/** Add a `publication::revoke_publisher_cap` call. Adds the cap ID to the denylist. */
+export declare function buildRevokePublisherCap(tx: Transaction, args: BuildRevokePublisherCapArgs): TransactionResult;
+export interface BuildDestroyPublisherCapArgs {
+    readonly packageId: PackageId;
+    readonly publicationId: PublicationId | TransactionObjectArgument;
+    readonly publisherCap: PublisherCapId | TransactionObjectArgument;
+}
+/**
+ * Add a `publication::destroy_publisher_cap` call. Consumes the cap; only the
+ * cap's bound holder may call this.
+ */
+export declare function buildDestroyPublisherCap(tx: Transaction, args: BuildDestroyPublisherCapArgs): TransactionResult;
+//# sourceMappingURL=cap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cap.d.ts","sourceRoot":"","sources":["../../src/ptb/cap.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,yBAAyB,EACzB,iBAAiB,EACjB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACX,UAAU,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,UAAU,EACV,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,yBAAyB,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,yBAAyB,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,0BAA0B,GAC9B,iBAAiB,CASnB;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,yBAAyB,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,yBAAyB,CAAC;IAC1D,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACxC;AAED,uFAAuF;AACvF,wBAAgB,uBAAuB,CACtC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,2BAA2B,GAC/B,iBAAiB,CASnB;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,yBAAyB,CAAC;IAClE,QAAQ,CAAC,YAAY,EAAE,cAAc,GAAG,yBAAyB,CAAC;CAClE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,EAAE,EAAE,WAAW,EACf,IAAI,EAAE,4BAA4B,GAChC,iBAAiB,CAQnB"}

package/dist/ptb/cap.js

@@ -0,0 +1,44 @@
+/**
+ * PTB builders for PublisherCap lifecycle Move calls. Internal to the SDK.
+ */
+import { resolveObjectArg } from "./internal.js";
+/**
+ * Add a `publication::issue_publisher_cap` call. Returns the result handle for
+ * the freshly-minted `PublisherCap`; caller is responsible for transferring it
+ * to the bound holder address (typically via `buildTransferPublisherCap`).
+ */
+export function buildIssuePublisherCap(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::publication::issue_publisher_cap`,
+        arguments: [
+            resolveObjectArg(tx, args.publicationId),
+            resolveObjectArg(tx, args.ownerCap),
+            tx.pure.address(args.holder),
+        ],
+    });
+}
+/** Add a `publication::revoke_publisher_cap` call. Adds the cap ID to the denylist. */
+export function buildRevokePublisherCap(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::publication::revoke_publisher_cap`,
+        arguments: [
+            resolveObjectArg(tx, args.publicationId),
+            resolveObjectArg(tx, args.ownerCap),
+            tx.pure.id(args.publisherCapId),
+        ],
+    });
+}
+/**
+ * Add a `publication::destroy_publisher_cap` call. Consumes the cap; only the
+ * cap's bound holder may call this.
+ */
+export function buildDestroyPublisherCap(tx, args) {
+    return tx.moveCall({
+        target: `${args.packageId}::publication::destroy_publisher_cap`,
+        arguments: [
+            resolveObjectArg(tx, args.publicationId),
+            resolveObjectArg(tx, args.publisherCap),
+        ],
+    });
+}
+//# sourceMappingURL=cap.js.map