@seedprotocol/publish 0.4.16 → 0.4.18

package/dist/config.d.ts

@@ -42,8 +42,9 @@ export interface PublishConfig {
      */
     useDirectEas?: boolean;
     /**
-     * Optional IModularCore module to ensure is installed on the connected account contract.
-     * When set, onConnect will check getInstalledModules and install if missing.
+     * Optional IModularCore module to ensure is installed on the **ModularCore** account contract.
+     * When set, onConnect / publish prep will check getInstalledModules and install if missing.
+     * If the smart account is not ModularCore (no Router), install is skipped — typical for default EIP-4337 accounts.
      */
     modularAccountModuleContract?: string;
     /** Optional module install data (default "0x"). Used with modularAccountModuleContract. */
@@ -53,6 +54,15 @@ export interface PublishConfig {
      * Default: false (uses the smart wallet executor).
      */
     useModularExecutor?: boolean;
+    /**
+     * When true (and `useModularExecutor`), attempts to deploy the ManagedAccount via the factory
+     * if it is not yet deployed on Optimism Sepolia. Default: false (surface `managed_not_ready` instead).
+     */
+    autoDeployManagedAccount?: boolean;
+    /**
+     * Called when optional wallet setup steps fail after connect (e.g. executor module install).
+     */
+    onWalletSetupWarning?: (error: unknown) => void;
     /**
      * EXPERIMENTAL: Use Arweave bundler for instant uploads instead of reimbursement + chunk upload.
      * When true, skips sendReimbursementRequest, pollForConfirmation, and chunk-by-chunk uploadData.
@@ -84,6 +94,8 @@ export interface PublishConfig {
 }
 /** Options passed at createPublish time. Signers here override config fallbacks. */
 export interface CreatePublishOptions {
+    /** `patch` (default): pending properties only. `new_version`: new Version attestation + all properties. */
+    publishMode?: import('./types').PublishMode;
     /** Required when useArweaveBundler: sign DataItems (wallet flow) */
     signDataItems?: (uploads: import('./services/publish/helpers/getPublishUploadData').PublishUploadData[]) => Promise<ArweaveDataItemInfoResult[]>;
     /** Required when useArweaveBundler: signer for DataItems (backend/script flow) */
@@ -126,6 +138,8 @@ export interface ResolvedPublishConfig extends PublishConfig {
     modularAccountModuleData: string;
     useModularExecutor: boolean;
     useArweaveBundler: boolean;
+    /** Resolved: defaults to false. */
+    autoDeployManagedAccount: boolean;
 }
 /**
  * Internal: Get resolved config. Reads from ref set by initPublish or PublishProvider.

package/dist/config.d.ts.map

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

package/dist/errors.d.ts

@@ -5,4 +5,31 @@ export declare class AttestationVerificationError extends Error {
     readonly code: 'METADATA_PROPERTIES_MISSING';
     constructor(message: string, seedLocalId: string, expectedSchemas: string[], foundSchemas: string[], code?: 'METADATA_PROPERTIES_MISSING');
 }
+export type ManagedAccountPublishErrorCode = 'MANAGED_ACCOUNT_NOT_DEPLOYED' | 'MANAGED_ACCOUNT_UNAVAILABLE' | 'EXECUTOR_MODULE_NOT_INSTALLED';
+/**
+ * Thrown or returned when the managed publishing account (Optimism Sepolia) is missing,
+ * unreachable, or missing the executor module for the modular executor path.
+ */
+export declare class ManagedAccountPublishError extends Error {
+    readonly code: ManagedAccountPublishErrorCode;
+    readonly managedAddress?: string | undefined;
+    /** Original error when connection or deployment failed (avoids shadowing `Error.cause`). */
+    readonly underlyingCause?: unknown;
+    constructor(message: string, code: ManagedAccountPublishErrorCode, managedAddress?: string | undefined, underlyingCause?: unknown);
+}
+/**
+ * True when `e` is a managed-account publish error. Uses `name` + `code` as a fallback
+ * when `instanceof` fails across duplicate bundled class identities.
+ */
+export declare function isManagedAccountPublishError(e: unknown): e is ManagedAccountPublishError;
+/**
+ * Best-effort string for RPC / thirdweb / viem failures that are not plain `Error`
+ * (so logs and UIs can show the real revert or RPC reason).
+ */
+export declare function stringifyUnderlyingCause(u: unknown, maxLen?: number): string;
+/**
+ * True when the RPC/contract error indicates the account is **not** Thirdweb ModularCore
+ * (no Router / `getInstalledModules`), e.g. default EIP-4337 smart accounts.
+ */
+export declare function isRouterNonModularCoreAccountError(cause: unknown): boolean;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,4BAA6B,SAAQ,KAAK;aAGnC,WAAW,EAAE,MAAM;aACnB,eAAe,EAAE,MAAM,EAAE;aACzB,YAAY,EAAE,MAAM,EAAE;aACtB,IAAI,EAAE,6BAA6B;gBAJnD,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,GAAE,6BAA6D;CAKtF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,4BAA6B,SAAQ,KAAK;aAGnC,WAAW,EAAE,MAAM;aACnB,eAAe,EAAE,MAAM,EAAE;aACzB,YAAY,EAAE,MAAM,EAAE;aACtB,IAAI,EAAE,6BAA6B;gBAJnD,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,GAAE,6BAA6D;CAKtF;AAED,MAAM,MAAM,8BAA8B,GACtC,8BAA8B,GAC9B,6BAA6B,GAC7B,+BAA+B,CAAA;AAEnC;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;aAMjC,IAAI,EAAE,8BAA8B;aACpC,cAAc,CAAC,EAAE,MAAM;IANzC,4FAA4F;IAC5F,SAAgB,eAAe,CAAC,EAAE,OAAO,CAAA;gBAGvC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,8BAA8B,EACpC,cAAc,CAAC,EAAE,MAAM,YAAA,EACvC,eAAe,CAAC,EAAE,OAAO;CAM5B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,0BAA0B,CAKxF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,SAAM,GAAG,MAAM,CAqBzE;AAED;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE1E"}

package/dist/helpers/constants.d.ts

@@ -9,6 +9,12 @@ export declare const EAS_SCHEMA_NAME_ATTESTATION_UID: "0x44d562ac1d7cd77e2329786
 export declare const THIRDWEB_ACCOUNT_FACTORY_ADDRESS: "0x76f47d88bfaf670f5208911181fcdc0e160cb16d";
 /** EAS contract address on Optimism Sepolia (chain 11155420) */
 export declare const EAS_CONTRACT_ADDRESS: "0x4200000000000000000000000000000000000021";
+/**
+ * SeedProtocol contract on Optimism Sepolia — same deployment as
+ * `helpers/thirdweb/11155420/0xcd8c945872df8e664e55cf8885c85ea3ea8f2148` (multiPublish ABI).
+ * The Thirdweb managed smart account address is not this contract; `multiPublish` must target this `to`.
+ */
+export declare const SEED_PROTOCOL_CONTRACT_ADDRESS_OP_SEPOLIA: "0xcd8c945872df8e664e55cf8885c85ea3ea8f2148";
 export declare const PublishMachineStates: {
     readonly SUCCESS: "success";
     readonly FAILURE: "failure";

package/dist/helpers/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/helpers/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,EAClC,4CAAqD,CAAA;AAEvD,wEAAwE;AACxE,eAAO,MAAM,+BAA+B,EAC1C,oEAA6E,CAAA;AAE/E,2EAA2E;AAC3E,eAAO,MAAM,gCAAgC,EAC3C,4CAAqD,CAAA;AAEvD,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,EAC/B,4CAAqD,CAAA;AAEvD,eAAO,MAAM,oBAAoB;;;CAGvB,CAAA;AAEV,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,6EAI9B,CAAA;AAEV,eAAO,MAAM,yBAAyB,QAAS,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/helpers/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,+DAA+D;AAC/D,eAAO,MAAM,uBAAuB,EAClC,4CAAqD,CAAA;AAEvD,wEAAwE;AACxE,eAAO,MAAM,+BAA+B,EAC1C,oEAA6E,CAAA;AAE/E,2EAA2E;AAC3E,eAAO,MAAM,gCAAgC,EAC3C,4CAAqD,CAAA;AAEvD,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,EAC/B,4CAAqD,CAAA;AAEvD;;;;GAIG;AACH,eAAO,MAAM,yCAAyC,EACpD,4CAAqD,CAAA;AAEvD,eAAO,MAAM,oBAAoB;;;CAGvB,CAAA;AAEV,qFAAqF;AACrF,eAAO,MAAM,2BAA2B,6EAI9B,CAAA;AAEV,eAAO,MAAM,yBAAyB,QAAS,CAAA"}

package/dist/helpers/debugPublishIngest.d.ts

@@ -0,0 +1,2 @@
+export declare function debugPublishIngest(location: string, message: string, hypothesisId: string, data: Record<string, unknown>, runId?: string): void;
+//# sourceMappingURL=debugPublishIngest.d.ts.map

package/dist/helpers/debugPublishIngest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debugPublishIngest.d.ts","sourceRoot":"","sources":["../../src/helpers/debugPublishIngest.ts"],"names":[],"mappings":"AAOA,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,SAAkB,GACtB,IAAI,CAgBN"}

package/dist/helpers/ensureExecutorModule.d.ts

@@ -0,0 +1,15 @@
+import type { Account } from 'thirdweb/wallets';
+import type { PublishConfig } from '../config';
+/**
+ * Ensures `modularAccountModuleContract` is installed on `contractAddress` when that contract
+ * implements Thirdweb ModularCore (`getInstalledModules` / Router). If the account does not
+ * support ModularCore (RPC error `Router: function does not exist`), this is a **no-op** — many
+ * EIP-4337 managed accounts embed `multiPublish` without pluggable modules.
+ *
+ * No-op if `modularAccountModuleContract` is unset.
+ *
+ * @param contractAddress - Account contract to inspect (typically the managed smart account)
+ * @param account - Account that can sign `installModule` for that contract
+ */
+export declare function ensureExecutorModuleInstalled(contractAddress: string, account: Account, config: Pick<PublishConfig, 'modularAccountModuleContract'>): Promise<void>;
+//# sourceMappingURL=ensureExecutorModule.d.ts.map

package/dist/helpers/ensureExecutorModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureExecutorModule.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureExecutorModule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAI/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAM9C;;;;;;;;;;GAUG;AACH,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,8BAA8B,CAAC,GAC1D,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/helpers/ensureManagedAccountReady.d.ts

@@ -0,0 +1,36 @@
+import { ManagedAccountPublishError } from '../errors';
+export type EnsureManagedAccountReadyResult = {
+    kind: 'skip';
+} | {
+    kind: 'unavailable';
+    cause: unknown;
+} | {
+    kind: 'not_deployed';
+    managedAddress: string;
+} | {
+    kind: 'ready';
+    managedAddress: string;
+};
+/**
+ * Checks managed account deployment for the modular executor path.
+ * Returns `{ kind: 'skip' }` when `useModularExecutor` is false.
+ */
+export declare function ensureManagedAccountReady(): Promise<EnsureManagedAccountReadyResult>;
+/**
+ * Deploys the ManagedAccount via the factory using the managed in-app wallet signer.
+ * @throws ManagedAccountPublishError on missing account or deploy failure
+ */
+export declare function tryDeployManagedAccount(): Promise<void>;
+export type ModularExecutorPublishPrepResult = {
+    ok: true;
+    managedAddress: string;
+} | {
+    ok: false;
+    error: ManagedAccountPublishError;
+};
+/**
+ * Full gate for modular executor publish: deployment check, optional factory deploy, optional executor module on the managed contract.
+ * Call only when `useModularExecutor` is true.
+ */
+export declare function runModularExecutorPublishPrep(): Promise<ModularExecutorPublishPrepResult>;
+//# sourceMappingURL=ensureManagedAccountReady.d.ts.map

package/dist/helpers/ensureManagedAccountReady.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureManagedAccountReady.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureManagedAccountReady.ts"],"names":[],"mappings":"AASA,OAAO,EAAgC,0BAA0B,EAAE,MAAM,WAAW,CAAA;AAepF,MAAM,MAAM,+BAA+B,GACvC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7C;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,+BAA+B,CAAC,CAkB1F;AAYD;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO7D;AAED,MAAM,MAAM,gCAAgC,GACxC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,0BAA0B,CAAA;CAAE,CAAA;AAEpD;;;GAGG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,gCAAgC,CAAC,CAqE/F"}

package/dist/helpers/ensureSmartWalletThenPublish.d.ts

@@ -1,16 +1,26 @@
 import type { Account } from 'thirdweb/wallets';
 import type { Item } from '@seedprotocol/sdk';
 import type { CreatePublishOptions } from '../config';
+import { ManagedAccountPublishError } from '../errors';
 export type EnsureSmartWalletResult = {
     outcome: 'started';
 } | {
     outcome: 'no_address';
 } | {
     outcome: 'needs_deploy';
+} | {
+    outcome: 'managed_not_ready';
+    error: ManagedAccountPublishError;
 };
 /**
  * Resolves the smart wallet for the current account; if deployed, starts publish.
- * If the user has no deployed ManagedAccount, returns needs_deploy so the caller can open the deploy modal.
+ * If the user has no deployed ManagedAccount (non-modular path), returns needs_deploy so the caller can open the deploy modal.
+ *
+ * When `useModularExecutor` is true, runs {@link runModularExecutorPublishPrep} first and uses the **managed** account
+ * address as the publish `address` (context for `multiPublish`).
+ *
+ * Pass `options.publishMode`: `patch` (default) publishes only pending properties on the current Version;
+ * `new_version` creates a new Version attestation and re-attests all properties (requires an existing Seed UID).
  */
 export declare function ensureSmartWalletThenPublish(item: Item<any>, activeAccount: Account | null | undefined, getAddress: () => Promise<string | null>, options?: CreatePublishOptions): Promise<EnsureSmartWalletResult>;
 //# sourceMappingURL=ensureSmartWalletThenPublish.d.ts.map

package/dist/helpers/ensureSmartWalletThenPublish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ensureSmartWalletThenPublish.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureSmartWalletThenPublish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAErD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,GACtB;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,GACzB;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,CAAA;AAE/B;;;GAGG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EACf,aAAa,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EACzC,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EACxC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAclC"}
+{"version":3,"file":"ensureSmartWalletThenPublish.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureSmartWalletThenPublish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAG7C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAGrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAA;AAEtD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,GACtB;IAAE,OAAO,EAAE,YAAY,CAAA;CAAE,GACzB;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,GAC3B;IAAE,OAAO,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,0BAA0B,CAAA;CAAE,CAAA;AAKvE;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EACf,aAAa,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EACzC,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,EACxC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA0ClC"}

package/dist/helpers/publishDisplayHelpers.d.ts

@@ -5,4 +5,26 @@
  * machine value for display.
  */
 export declare function getDisplayStepId(machineValue: string): string;
+type PublishRowStatus = 'in_progress' | 'completed' | 'failed' | 'interrupted';
+/**
+ * Single source of truth for step UIs: the live machine while running; once the
+ * actor is gone, prefer the DB row status so we never flash an intermediate
+ * `persistedSnapshot` value (e.g. creatingAttestations) after a completed run.
+ */
+export declare function resolvePublishDisplayValue(publishProcess: unknown | null | undefined, record: {
+    status: PublishRowStatus;
+} | undefined, machineValue: string | undefined): string | undefined;
+export type PublishRowForDisplay = {
+    status: string;
+    persistedSnapshot: string;
+    completedAt?: number | null;
+};
+/**
+ * Derives the machine-state string for UI from the persisted DB row. Prefer
+ * `status` / `completedAt` over raw `persistedSnapshot` JSON so a stale or
+ * out-of-order snapshot write cannot force the UI back to an intermediate step
+ * after a terminal save (common when consumers read `JSON.parse(persistedSnapshot).value`).
+ */
+export declare function getPublishMachineValueForUi(record: PublishRowForDisplay | undefined): string | undefined;
+export {};
 //# sourceMappingURL=publishDisplayHelpers.d.ts.map

package/dist/helpers/publishDisplayHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publishDisplayHelpers.d.ts","sourceRoot":"","sources":["../../src/helpers/publishDisplayHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAK7D"}
+{"version":3,"file":"publishDisplayHelpers.d.ts","sourceRoot":"","sources":["../../src/helpers/publishDisplayHelpers.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAK7D;AAED,KAAK,gBAAgB,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAA;AAE9E;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAC1C,MAAM,EAAE;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG,SAAS,EAChD,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAKpB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CA6BxG"}

package/dist/hooks/usePublishProcess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePublishProcess.d.ts","sourceRoot":"","sources":["../../src/hooks/usePublishProcess.ts"],"names":[],"mappings":"AAIA,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM;;;EAwBpD"}
+{"version":3,"file":"usePublishProcess.d.ts","sourceRoot":"","sources":["../../src/hooks/usePublishProcess.ts"],"names":[],"mappings":"AAcA,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM;;;EAmHpD"}

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 export { initPublish, configurePublish, type PublishConfig, type ResolvedPublishConfig, type CreatePublishOptions, type SerializedPublishUpload, type ArweaveTransactionInfoResult, type ArweaveDataItemInfoResult, } from './config';
 export type { PublishUploadData } from './services/publish/helpers/getPublishUploadData';
-export { AttestationVerificationError } from './errors';
+export { AttestationVerificationError, isManagedAccountPublishError, isRouterNonModularCoreAccountError, ManagedAccountPublishError, type ManagedAccountPublishErrorCode, stringifyUnderlyingCause, } from './errors';
 export { default as ConnectButton } from './react/ConnectButton';
+export { PublishModeButtons } from './react/PublishModeButtons';
+export type { PublishModeButtonsProps } from './react/PublishModeButtons';
+export type { PublishMode } from './types';
 export { default as PublishProvider, usePublishConfig } from './react/PublishProvider';
 export type { PublishProviderProps } from './react/PublishProvider';
 export { SeedProvider } from '@seedprotocol/react';
@@ -14,7 +17,9 @@ export { usePublishProcess, useCanPublishItem, useItemPublishStatus, usePublishP
 export type { PublishProcessRecord, PublishProcessStatus } from './hooks/useItemPublishStatus';
 export { getArweave } from './helpers/blockchain';
 export { verifyDataItem } from './helpers/arweave';
-export { getDisplayStepId } from './helpers/publishDisplayHelpers';
+export { getDisplayStepId, getPublishMachineValueForUi, resolvePublishDisplayValue, type PublishRowForDisplay, } from './helpers/publishDisplayHelpers';
 export { transformPayloadToIntegerIds, type RequestWithStringIds, type RequestWithIntegerIds, } from './helpers/transformPayloadToIntegerIds';
 export { ensureSmartWalletThenPublish, type EnsureSmartWalletResult, } from './helpers/ensureSmartWalletThenPublish';
+export { ensureExecutorModuleInstalled } from './helpers/ensureExecutorModule';
+export { ensureManagedAccountReady, tryDeployManagedAccount, runModularExecutorPublishPrep, type EnsureManagedAccountReadyResult, type ModularExecutorPublishPrepResult, } from './helpers/ensureManagedAccountReady';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,GAC/B,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAA;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAA;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACtF,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,uBAAuB,GACxB,MAAM,6CAA6C,CAAA;AACpD,cAAc,wEAAwE,CAAA;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iCAAiC,EACjC,qBAAqB,EACrB,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAC7B,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,aAAa,GACd,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EACL,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EACL,4BAA4B,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,wCAAwC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,GAC/B,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAA;AACxF,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,8BAA8B,EACnC,wBAAwB,GACzB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACtF,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,uBAAuB,GACxB,MAAM,6CAA6C,CAAA;AACpD,cAAc,wEAAwE,CAAA;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,iCAAiC,EACjC,qBAAqB,EACrB,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAC7B,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,aAAa,GACd,MAAM,SAAS,CAAA;AAChB,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACL,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EACL,4BAA4B,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAA;AAC9E,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,6BAA6B,EAC7B,KAAK,+BAA+B,EACpC,KAAK,gCAAgC,GACtC,MAAM,qCAAqC,CAAA"}