@seedprotocol/publish 0.4.17 → 0.4.20

package/README.md

@@ -110,6 +110,12 @@ PublishManager.createPublish(item, address, account, {
 
 You can also provide `signDataItems` or `dataItemSigner` in the PublishProvider config as a fallback when the signer is available at startup.
 
+### Arweave upload tags
+
+Add optional tags (e.g. `App-Name`) on **`PublishProvider` / `initPublish` config** as **`arweaveUploadTags`**, and/or per publish via **`createPublish` options**. Resolved order: **`[...configTags, ...perPublishTags]`**, appended after `Content-SHA-256` / `Content-Type` on each upload.
+
+When implementing **`signDataItems`**, use **`upload.tags`** as the tag list for each DataItem. Avoid rebuilding tags from `contentHash` / `contentType` only, or you will drop configured tags.
+
 ## Development
 
 ```bash

package/dist/config.d.ts

@@ -1,3 +1,4 @@
+import { type TransactionTag } from '@seedprotocol/sdk';
 import { ethers } from 'ethers';
 /** Serialized upload item for Arweave signing (input to callback or used internally with JWK) */
 export interface SerializedPublishUpload {
@@ -30,6 +31,11 @@ export interface PublishConfig {
      * Defaults to {@link uploadApiBaseUrl} (e.g. set `ARWEAVE_UPLOAD_API_BASE_URL` as `uploadApiBaseUrl`).
      */
     arweaveUploadVerificationBaseUrl?: string;
+    /**
+     * Arweave gateway GraphQL URL for resolving L1 bundle tx ids after bundler upload.
+     * Defaults to {@link DEFAULT_ARWEAVE_GRAPHQL_URL}.
+     */
+    arweaveGraphqlUrl?: string;
     /**
      * Use integer indices instead of string localId/publishLocalId for multiPublish (gas-efficient).
      * Set to true when using the new contract that expects uint256 localIdIndex/publishLocalIdIndex.
@@ -42,8 +48,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,12 +60,27 @@ 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.
      * Uses uploadApiBaseUrl for the bundler endpoint. Not yet validated for production.
      */
     useArweaveBundler?: boolean;
+    /**
+     * Tags appended to every Arweave upload after Content-SHA-256 / Content-Type (e.g. App-Name).
+     * Merged at publish time with {@link CreatePublishOptions.arweaveUploadTags} as
+     * `[...config, ...options]`.
+     */
+    arweaveUploadTags?: TransactionTag[];
     /**
      * Optional fallback: Sign Arweave upload transactions (non-bundler path). Prefer passing at createPublish time.
      */
@@ -79,12 +101,18 @@ export interface PublishConfig {
     dataItemSigner?: ethers.Wallet | import('thirdweb/wallets').Account;
     /**
      * Optional fallback: Sign DataItems when useArweaveBundler is true. Prefer passing at createPublish time.
+     * Each upload includes `tags` (content + configured {@link arweaveUploadTags}); forward them into the DataItem.
      */
     signDataItems?: (uploads: import('./services/publish/helpers/getPublishUploadData').PublishUploadData[]) => Promise<ArweaveDataItemInfoResult[]>;
 }
 /** Options passed at createPublish time. Signers here override config fallbacks. */
 export interface CreatePublishOptions {
-    /** Required when useArweaveBundler: sign DataItems (wallet flow) */
+    /** `patch` (default): pending properties only. `new_version`: new Version attestation + all properties. */
+    publishMode?: import('./types').PublishMode;
+    /**
+     * Required when useArweaveBundler: sign DataItems (wallet flow).
+     * Use each upload's `tags` when building the signed DataItem.
+     */
     signDataItems?: (uploads: import('./services/publish/helpers/getPublishUploadData').PublishUploadData[]) => Promise<ArweaveDataItemInfoResult[]>;
     /** Required when useArweaveBundler: signer for DataItems (backend/script flow) */
     dataItemSigner?: ethers.Wallet | import('thirdweb/wallets').Account;
@@ -98,6 +126,11 @@ export interface CreatePublishOptions {
         d?: string;
         [key: string]: unknown;
     };
+    /**
+     * Extra tags for this publish only, appended after {@link PublishConfig.arweaveUploadTags}.
+     * Resolved order: `[...initPublishTags, ...theseTags]`.
+     */
+    arweaveUploadTags?: TransactionTag[];
 }
 /**
  * Internal: Set config ref. Called by PublishProvider on mount or initPublish.
@@ -120,12 +153,16 @@ export interface ResolvedPublishConfig extends PublishConfig {
     uploadApiBaseUrl: string;
     /** Resolved verification origin (defaults to uploadApiBaseUrl). */
     arweaveUploadVerificationBaseUrl: string;
+    /** Resolved GraphQL endpoint for L1 tx resolution (defaults to DEFAULT_ARWEAVE_GRAPHQL_URL). */
+    arweaveGraphqlUrl: string;
     easContractAddress: string;
     useIntegerLocalIds: boolean;
     useDirectEas: boolean;
     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":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAQ1B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,iGAAiG;AACjG,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC;AAED,kEAAkE;AAClE,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IAC3D,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,yJAAyJ;IACzJ,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;OAGG;IACH,gCAAgC,CAAC,EAAE,MAAM,CAAA;IACzC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;OAIG;IACH,4BAA4B,CAAC,EAAE,MAAM,CAAA;IACrC,2FAA2F;IAC3F,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC;;OAEG;IACH,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAA;IACpC;;OAEG;IACH,uBAAuB,CAAC,EAAE,CACxB,OAAO,EAAE,uBAAuB,EAAE,KAC/B,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAA;IAC5C;;OAEG;IACH,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IACtF;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,kBAAkB,EAAE,OAAO,CAAA;IACnE;;;OAGG;IACH,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,OAAO,iDAAiD,EAAE,iBAAiB,EAAE,KACnF,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAA;CAC1C;AAED,oFAAoF;AACpF,MAAM,WAAW,oBAAoB;IACnC,2GAA2G;IAC3G,WAAW,CAAC,EAAE,OAAO,SAAS,EAAE,WAAW,CAAA;IAC3C;;;OAGG;IACH,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,OAAO,iDAAiD,EAAE,iBAAiB,EAAE,KACnF,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAA;IACzC,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,OAAO,kBAAkB,EAAE,OAAO,CAAA;IACnE,qEAAqE;IACrE,uBAAuB,CAAC,EAAE,CACxB,OAAO,EAAE,uBAAuB,EAAE,KAC/B,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAAA;IAC5C,sEAAsE;IACtE,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;IACtF;;;OAGG;IACH,iBAAiB,CAAC,EAAE,cAAc,EAAE,CAAA;CACrC;AAKD;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,aAAa,GAAG,IAAI,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAmBlD;AAED,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,oBAAc,CAAA;AAE3C,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,6BAA6B,EAAE,MAAM,CAAA;IACrC,gBAAgB,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,gCAAgC,EAAE,MAAM,CAAA;IACxC,gGAAgG;IAChG,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,YAAY,EAAE,OAAO,CAAA;IACrB,wBAAwB,EAAE,MAAM,CAAA;IAChC,kBAAkB,EAAE,OAAO,CAAA;IAC3B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,mCAAmC;IACnC,wBAAwB,EAAE,OAAO,CAAA;CAClC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAwBxD"}

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/arweave.d.ts

@@ -4,6 +4,7 @@ interface Tag {
     name: string;
     value: string;
 }
+export declare function buildPublishAnchorBytes(walletAddress: string, timestampMs: number, uniqueness: bigint): Uint8Array;
 /**
  * Type guard: true if signer is ethers.Wallet (has privateKey). Thirdweb Account does not.
  */
@@ -21,7 +22,7 @@ export declare const writeUint64LE: (value: number) => Uint8Array;
 /**
  * Create a signed ANS-104 DataItem. Uses deep-hash for the message to sign (per arbundles/Irys).
  */
-export declare const createSignedDataItem: (data: Uint8Array, signer: ethers.Wallet, tags: Tag[]) => Promise<{
+export declare const createSignedDataItem: (data: Uint8Array, signer: ethers.Wallet, tags: Tag[], rawAnchor?: Uint8Array) => Promise<{
     id: string;
     raw: Uint8Array;
 }>;
@@ -29,7 +30,7 @@ export declare const createSignedDataItem: (data: Uint8Array, signer: ethers.Wal
  * Create a signed ANS-104 DataItem using a Thirdweb Account (EOA, ManagedAccount, Modular Account).
  * Uses deep-hash for the message to sign (per arbundles/Irys).
  */
-export declare const createSignedDataItemWithAccount: (data: Uint8Array, account: Account, tags: Tag[]) => Promise<{
+export declare const createSignedDataItemWithAccount: (data: Uint8Array, account: Account, tags: Tag[], rawAnchor?: Uint8Array) => Promise<{
     id: string;
     raw: Uint8Array;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"arweave.d.ts","sourceRoot":"","sources":["../../src/helpers/arweave.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAsB/C,UAAU,GAAG;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,CAOvE;AAkBD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,GAAG,EAAE,KAAG,UA+B3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,UAO7C,CAAA;AA4GD;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,UAAU,EAChB,QAAQ,MAAM,CAAC,MAAM,EACrB,MAAM,GAAG,EAAE,KACV,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,CAkBzC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B,GAC1C,MAAM,UAAU,EAChB,SAAS,OAAO,EAChB,MAAM,GAAG,EAAE,KACV,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,CA8BzC,CAAA;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CA0CtE;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,UAAU,KAAG,MAM7C,CAAA"}
+{"version":3,"file":"arweave.d.ts","sourceRoot":"","sources":["../../src/helpers/arweave.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAsB/C,UAAU,GAAG;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAUD,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,UAAU,CAMZ;AAaD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,CAOvE;AAkBD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,GAAG,EAAE,KAAG,UA+B3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,UAO7C,CAAA;AAkHD;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,UAAU,EAChB,QAAQ,MAAM,CAAC,MAAM,EACrB,MAAM,GAAG,EAAE,EACX,YAAW,UAA8B,KACxC,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,CAiBzC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B,GAC1C,MAAM,UAAU,EAChB,SAAS,OAAO,EAChB,MAAM,GAAG,EAAE,EACX,YAAW,UAA8B,KACxC,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,CA6BzC,CAAA;AAsCD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CA0CtE;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,UAAU,KAAG,MAM7C,CAAA"}

package/dist/helpers/arweave.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=arweave.test.d.ts.map

package/dist/helpers/arweave.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arweave.test.d.ts","sourceRoot":"","sources":["../../src/helpers/arweave.test.ts"],"names":[],"mappings":""}

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/ensureManagedAccountReady.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ensureManagedAccountReady.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensureManagedAccountReady.test.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureManagedAccountReady.test.ts"],"names":[],"mappings":""}

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/useArweaveL1Finalize.d.ts

@@ -0,0 +1,23 @@
+export type ArweaveL1FinalizeJobRow = {
+    id: number;
+    seedLocalId: string;
+    dataItemId: string;
+    l1TransactionId: string | null;
+    bundleId: string | null;
+    phase: string;
+    statusJson: string | null;
+    errorMessage: string | null;
+    versionLocalId: string | null;
+    itemPropertyName: string | null;
+    updatedAt: number | null;
+};
+/**
+ * Live L1 finalization jobs for a seed (bundler path). Empty when not using bundler or no jobs.
+ */
+export declare function useArweaveL1Finalize(seedLocalId: string | undefined): {
+    hasPendingL1: boolean;
+    pendingCount: number;
+    confirmedCount: number;
+    jobs: ArweaveL1FinalizeJobRow[];
+};
+//# sourceMappingURL=useArweaveL1Finalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useArweaveL1Finalize.d.ts","sourceRoot":"","sources":["../../src/hooks/useArweaveL1Finalize.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;;;;;EA0BnE"}

package/dist/hooks/useItemPublishStatus.d.ts

@@ -19,5 +19,13 @@ export declare function useItemPublishStatus(seedLocalId: string | undefined): {
     publishProcess: import("xstate").ActorRef<any, any, import("xstate").EventObject> | null;
     isActive: boolean;
     publishValue: string | undefined;
+    arweaveL1Pending: boolean;
+    arweaveL1Jobs: import("./useArweaveL1Finalize").ArweaveL1FinalizeJobRow[];
+    arweaveL1Summary: {
+        hasPendingL1: boolean;
+        pendingCount: number;
+        confirmedCount: number;
+        jobs: import("./useArweaveL1Finalize").ArweaveL1FinalizeJobRow[];
+    };
 };
 //# sourceMappingURL=useItemPublishStatus.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useItemPublishStatus.d.ts","sourceRoot":"","sources":["../../src/hooks/useItemPublishStatus.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAA;AAEzF,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,oBAAoB,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;;;;;EAwBnE"}
+{"version":3,"file":"useItemPublishStatus.d.ts","sourceRoot":"","sources":["../../src/hooks/useItemPublishStatus.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAA;AAEzF,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,oBAAoB,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;;;;;;;;;;;;;EA4BnE"}

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"}