@bounded-sh/core 0.0.116 → 0.0.117

package/dist/client/mirror-sync.d.ts

@@ -0,0 +1,11 @@
+import type { SetOptions } from './operations';
+import type { MirrorSync } from '../types';
+/**
+ * Best-effort chain synchronization. A confirmed transaction must NEVER be lost to a
+ * synchronization failure, so this reports its outcome in `mirrorSync` and
+ * never rejects. The signature lets the server index the exact transaction,
+ * including hook-mutated documents beyond the requested destination paths.
+ */
+export declare function attemptMirrorSync(paths: string[], options?: SetOptions, transactionSignature?: string): Promise<MirrorSync>;
+/** Refresh concrete paths, or index a confirmed transaction and read its requested paths. */
+export declare function syncItems(paths: string[], options?: SetOptions, transactionSignature?: string): Promise<any>;

package/dist/client/operations.d.ts

@@ -282,13 +282,8 @@ export declare function runExpressionMany(many: {
     returnType?: 'Bool' | 'String' | 'Int' | 'UInt';
     _overrides?: RequestOverrides;
 }[]): Promise<RunExpressionResult[]>;
-/**
- * Best-effort mirror read. A confirmed transaction must NEVER be lost to a
- * synchronization failure, so this reports its outcome in `mirrorSync` and
- * never rejects. It reads the CONCRETE destination paths, so a collection
- * insert with a generated id syncs the path that actually exists.
- */
-export declare function attemptMirrorSync(paths: string[], options?: SetOptions, settleMs?: number): Promise<MirrorSync>;
+/** Best-effort readback, including a failure to load its lazy implementation. */
+export declare function attemptMirrorSync(paths: string[], options?: SetOptions, transactionSignature?: string): Promise<MirrorSync>;
 /**
  * Write a document at `path`. Sugar for a one-element {@link setMany}.
  *
@@ -395,4 +390,5 @@ export declare function setFile(path: string, file: File | null, options?: {
 export declare function signMessage(message: string): Promise<string>;
 export declare function signTransaction(transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
 export declare function signAndSubmitTransaction(transaction: Transaction | VersionedTransaction, feePayer?: PublicKey): Promise<string>;
-export declare function syncItems(paths: string[], options?: SetOptions): Promise<any>;
+/** Refresh concrete paths, or index a confirmed transaction and read its requested paths. */
+export declare function syncItems(paths: string[], options?: SetOptions, transactionSignature?: string): Promise<any>;

package/dist/{index-Db4lrwO6.mjs → index-C6ZW5Gt2.mjs}

@@ -4305,7 +4305,7 @@ class ServerSessionManager {
         const sessionConfig = (_a = this.sessionConfig) !== null && _a !== void 0 ? _a : undefined;
         /* fetch nonce from auth API (bound to the snapshotted app+issuer) */
         const nonce = await genAuthNonce(sessionConfig);
-        const { genSolanaMessage } = await import('./solana-message-BO6Dtgbv.mjs');
+        const { genSolanaMessage } = await import('./solana-message-CEjXjnaG.mjs');
         const message = await genSolanaMessage(address, nonce, sessionConfig === null || sessionConfig === void 0 ? void 0 : sessionConfig.appId);
         /* sign the message */
         const sigBytes = nacl.sign.detached(new TextEncoder().encode(message), kp.secretKey);
@@ -5051,6 +5051,7 @@ class BoundedDeclineError extends Error {
 
 const apiClient = axios.create();
 const TRANSIENT_GET_STATUSES = new Set([500, 502, 503, 504]);
+const TRANSIENT_SYNC_STATUSES = new Set([502, 503, 504]);
 const RATE_LIMIT_RETRY_BASE_DELAY_MS = 100;
 /** The window event emitted when the API responds with HTTP 429. */
 const RATE_LIMIT_EVENT_NAME = 'bounded:ratelimit';
@@ -5099,7 +5100,7 @@ function getRateLimitAttempt(error) {
 axiosRetry(apiClient, {
     retries: 2,
     retryCondition: (error) => {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         // A caller cancellation is final. In particular, never turn a route
         // unmount into a fresh GET after its AbortSignal has fired.
         const canceled = axios.isCancel(error)
@@ -5115,15 +5116,27 @@ axiosRetry(apiClient, {
         // safe for every method, including POST requests to the queries API.
         if (((_d = error.response) === null || _d === void 0 ? void 0 : _d.status) === 429)
             return true;
-        // Only retry idempotent GETs. Network failures and the small set of
-        // conventional transient gateway/runtime statuses get two bounded
-        // retries; auth, policy, invariant, and other terminal responses stay final.
-        // Writes are never retried because the server may already have applied
-        // them before the response was lost.
-        if (((_f = (_e = error.config) === null || _e === void 0 ? void 0 : _e.method) === null || _f === void 0 ? void 0 : _f.toLowerCase()) !== 'get')
+        // Sync only indexes existing chain state, so repeating it cannot submit
+        // a second transaction. Keep its retries in this same bounded transport
+        // loop instead of multiplying them with another SDK retry loop.
+        const method = (_f = (_e = error.config) === null || _e === void 0 ? void 0 : _e.method) === null || _f === void 0 ? void 0 : _f.toLowerCase();
+        let isSync = false;
+        if (method === 'put') {
+            try {
+                isSync = new URL(String((_g = error.config) === null || _g === void 0 ? void 0 : _g.url)).pathname === '/items/sync';
+            }
+            catch ( /* An unrecognized URL is never safe to retry. */_m) { /* An unrecognized URL is never safe to retry. */ }
+        }
+        if (isSync) {
+            return axiosRetry.isNetworkError(error)
+                || TRANSIENT_SYNC_STATUSES.has((_j = (_h = error.response) === null || _h === void 0 ? void 0 : _h.status) !== null && _j !== void 0 ? _j : 0);
+        }
+        // Ordinary writes are never retried: a lost response may follow commit.
+        // GET network and selected gateway/runtime failures are safe to repeat.
+        if (method !== 'get')
             return false;
         return axiosRetry.isNetworkError(error)
-            || TRANSIENT_GET_STATUSES.has((_h = (_g = error.response) === null || _g === void 0 ? void 0 : _g.status) !== null && _h !== void 0 ? _h : 0);
+            || TRANSIENT_GET_STATUSES.has((_l = (_k = error.response) === null || _k === void 0 ? void 0 : _k.status) !== null && _l !== void 0 ? _l : 0);
     },
     retryDelay: (retryCount, error) => {
         var _a;
@@ -7664,7 +7677,7 @@ async function doReconnectWithNewAuth() {
         console.warn('[WS v2] Failed to clear HTTP read cache on auth change:', error);
     }
     try {
-        const { reconnectRealtimeStoreWithNewAuth } = await import('./realtime-store-CNs5zURZ.mjs');
+        const { reconnectRealtimeStoreWithNewAuth } = await import('./realtime-store-FUjGL_Z8.mjs');
         await reconnectRealtimeStoreWithNewAuth();
     }
     catch (error) {
@@ -8850,12 +8863,6 @@ async function runExpressionMany(many) {
     }
 }
 /* ===================== WRITE RECEIPT HELPERS (W4) ======================== */
-/**
- * Settle delay before the best-effort mirror read on an on-chain write. It is
- * an optimization, not a correctness guarantee: the receipt is captured first
- * and returned regardless of what the mirror read reports.
- */
-const MIRROR_SYNC_SETTLE_MS = 1500;
 const SOLANA_CHAIN_TAGS = new Set(['solana_devnet', 'solana_mainnet']);
 /**
  * Read the execution-lane tag the WORKER reported. The SDK never infers it: a
@@ -8886,66 +8893,11 @@ function buildRequestedDocuments(documents) {
         });
     });
 }
-/** Look a concrete path up in a path-keyed map, tolerating a leading slash. */
-function pickPathDocument(source, path) {
-    if (Object.prototype.hasOwnProperty.call(source, path))
-        return source[path];
-    const withSlash = path.startsWith('/') ? path : `/${path}`;
-    if (Object.prototype.hasOwnProperty.call(source, withSlash))
-        return source[withSlash];
-    const withoutSlash = path.startsWith('/') ? path.slice(1) : path;
-    if (Object.prototype.hasOwnProperty.call(source, withoutSlash))
-        return source[withoutSlash];
-    return undefined;
-}
-/**
- * `observed: true` only when EVERY requested concrete path was read back as a
- * real document. The sync endpoint answers `null` for a document that is
- * absent, lagging, or read-denied, and a deleted path reads back as `null` too
- * — none of those are evidence of synchronization.
- */
-function validatePathKeyedDocuments(paths, source) {
-    if (!source || typeof source !== 'object' || Array.isArray(source)) {
-        return { observed: false, reason: 'the synchronization response was not a path-keyed document map' };
-    }
-    const map = source;
-    const documents = [];
-    const unobserved = [];
-    for (const path of paths) {
-        const document = pickPathDocument(map, path);
-        if (document == null || typeof document !== 'object' || Array.isArray(document)) {
-            unobserved.push(path);
-            documents.push({ path, document: null });
-            continue;
-        }
-        documents.push({ path, document: document });
-    }
-    if (unobserved.length > 0) {
-        return {
-            observed: false,
-            reason: `no readable document was returned for ${unobserved.join(', ')} ` +
-                '(absent, deleted, lagging, read-denied, or a passthrough write)',
-        };
-    }
-    return { observed: true, documents };
-}
-/**
- * Best-effort mirror read. A confirmed transaction must NEVER be lost to a
- * synchronization failure, so this reports its outcome in `mirrorSync` and
- * never rejects. It reads the CONCRETE destination paths, so a collection
- * insert with a generated id syncs the path that actually exists.
- */
-async function attemptMirrorSync(paths, options, settleMs = MIRROR_SYNC_SETTLE_MS) {
+/** Best-effort readback, including a failure to load its lazy implementation. */
+async function attemptMirrorSync(paths, options, transactionSignature) {
     try {
-        if (settleMs > 0)
-            await new Promise(resolve => setTimeout(resolve, settleMs));
-        const synced = await syncItems(paths, options);
-        // The sync endpoint answers `{ data: <path-keyed map>, status }`; a document
-        // path always contains a `/`, so a top-level `data` key is never one.
-        const map = (synced && typeof synced === 'object' && !Array.isArray(synced) && 'data' in synced)
-            ? synced.data
-            : synced;
-        return validatePathKeyedDocuments(paths, map);
+        const mirror = await import('./mirror-sync-kt9PzQen.mjs');
+        return await mirror.attemptMirrorSync(paths, options, transactionSignature);
     }
     catch (error) {
         const message = typeof (error === null || error === void 0 ? void 0 : error.message) === 'string' ? error.message : String(error);
@@ -9164,7 +9116,7 @@ async function setMany(many, options) {
                     if (typeof curTx.serializedTransaction !== 'string' || typeof curTx.poofnetIntentId !== 'string') {
                         throw new Error('Unsupported 202 transaction shape: a poofnet write needs serializedTransaction and poofnetIntentId');
                     }
-                    const { signPoofnetTransaction, buildExpectedWriteIntent } = await import('./solana-operations-DDt4CzRR.mjs');
+                    const { signPoofnetTransaction, buildExpectedWriteIntent } = await import('./solana-operations-5WjFwhnt.mjs');
                     const signedTransaction = await signPoofnetTransaction(curTx.serializedTransaction, authProvider, options, buildExpectedWriteIntent(documents));
                     // Signing-only, exactly as on a real chain: signed and NOT committed.
                     if ((options === null || options === void 0 ? void 0 : options.shouldSubmitTx) === false) {
@@ -9202,7 +9154,7 @@ async function setMany(many, options) {
                             'Nothing was signed or submitted.');
                     }
                     const solanaChain = workerChain;
-                    const { handlePreBuiltTransaction, buildExpectedWriteIntent } = await import('./solana-operations-DDt4CzRR.mjs');
+                    const { handlePreBuiltTransaction, buildExpectedWriteIntent } = await import('./solana-operations-5WjFwhnt.mjs');
                     // OA-0001: derive the expected intent from OUR OWN request (the one
                     // ground truth a tampered builder response cannot change) so the
                     // validator can reject any transaction whose operation semantics
@@ -9243,7 +9195,7 @@ async function setMany(many, options) {
                     // best-effort enrichment reported in `mirrorSync`, never a rejection.
                     const mirrorSync = grantLane
                         ? { observed: false, reason: 'not attempted: a venue grant authorizes only the write' }
-                        : await attemptMirrorSync(requestedPaths, options);
+                        : await attemptMirrorSync(requestedPaths, Object.assign(Object.assign({}, options), { _overrides: Object.assign(Object.assign({}, options === null || options === void 0 ? void 0 : options._overrides), { _config: config }) }), solanaOutcome.transactionSignature);
                     return {
                         status: 'confirmed', appId, requestedDocuments, chain: solanaChain,
                         transactionId: solanaOutcome.transactionSignature,
@@ -9515,15 +9467,6 @@ async function signAndSubmitTransaction(transaction, feePayer) {
     }
     return config.authProvider.signAndSubmitTransaction(transaction, feePayer);
 }
-async function syncItems(paths, options) {
-    try {
-        const response = await makeApiRequest('PUT', 'items/sync', { paths }, options === null || options === void 0 ? void 0 : options._overrides);
-        return response.data;
-    }
-    catch (error) {
-        throw error;
-    }
-}
 
 var operations = /*#__PURE__*/Object.freeze({
     __proto__: null,
@@ -9548,15 +9491,12 @@ var operations = /*#__PURE__*/Object.freeze({
     setMany: setMany,
     signAndSubmitTransaction: signAndSubmitTransaction,
     signMessage: signMessage,
-    signTransaction: signTransaction,
-    syncItems: syncItems
+    signTransaction: signTransaction
 });
 
 const DEFAULT_TIMEOUT_MS = 60000;
 const DEFAULT_MAX_ATTEMPTS$1 = 20;
 const DEFAULT_POLL_INTERVAL_MS = 3000;
-/** Mirror read after a late confirmation. No settle delay: the tx already landed. */
-const RECONCILE_MIRROR_SETTLE_MS = 0;
 function errorText(error) {
     const message = error === null || error === void 0 ? void 0 : error.message;
     return typeof message === 'string' && message.length > 0 ? message : String(error);
@@ -9605,12 +9545,12 @@ function assertReceiptMatchesContext(receipt, config) {
 function stillSubmitted(receipt, reason) {
     return Object.assign(Object.assign({}, receipt), { confirmation: Object.assign(Object.assign({}, receipt.confirmation), { reason }) });
 }
-async function mirrorFor(receipt, options) {
+async function mirrorFor(receipt, config, options) {
     const paths = receipt.requestedDocuments.map(entry => entry.path);
     if (paths.length === 0)
         return { observed: false, reason: 'the receipt carried no requested paths' };
-    const setOptions = (options === null || options === void 0 ? void 0 : options._overrides) ? { _overrides: options._overrides } : undefined;
-    return attemptMirrorSync(paths, setOptions, RECONCILE_MIRROR_SETTLE_MS);
+    const setOptions = { _overrides: Object.assign(Object.assign({}, options === null || options === void 0 ? void 0 : options._overrides), { _config: config }) };
+    return attemptMirrorSync(paths, setOptions, receipt.transactionId);
 }
 async function resolveSolanaRpc(config, options) {
     var _a, _b;
@@ -9692,7 +9632,7 @@ async function reconcileSolana(receipt, config, options) {
             signedTransaction: receipt.signedTransaction,
             fence: receipt.fence,
             confirmationContextSlot: typeof statusValue.slot === 'number' ? statusValue.slot : (contextSlot !== null && contextSlot !== void 0 ? contextSlot : 0),
-            mirrorSync: await mirrorFor(receipt, options),
+            mirrorSync: await mirrorFor(receipt, config, options),
         };
         return confirmed;
     }
@@ -11046,7 +10986,7 @@ function toMillis(seconds) {
 
 /** SIWS message creation is async already, so its onchain module can be lazy. */
 async function genSolanaMessage(address, nonce) {
-    const implementation = await import('./solana-message-BO6Dtgbv.mjs');
+    const implementation = await import('./solana-message-CEjXjnaG.mjs');
     return implementation.genSolanaMessage(address, nonce);
 }
 
@@ -11595,5 +11535,5 @@ function defineLiveModule(mod) {
     return mod;
 }
 
-export { RATE_LIMIT_EVENT_NAME as $, isWriteNotApplied as A, writeNotAppliedPhase as B, subscribe as C, closeAllSubscriptions as D, clearCache as E, getCachedData as F, reconnectWithNewAuth as G, createClient as H, InsufficientBalanceError as I, exchangeAppToken as J, clearAppTokenCache as K, createAppTokenAuthHeaders as L, AppTokenExchangeError as M, setWithVenueGrant as N, resolveVenueRpcUrl as O, subscribeQuery as P, closeAllQuerySubscriptions as Q, canonicalizeArgs as R, ScopedClientReadOnlyError as S, canonicalizeResult as T, DEFAULT_QUERY_POLL_INTERVAL_MS as U, MIN_QUERY_POLL_INTERVAL_MS as V, BoundedDeclineError as W, deriveDecline as X, dispatchDeclineEvent as Y, DECLINE_EVENT_NAME as Z, dispatchRateLimitEvent as _, getWebhookKeysUrl as a, hasActiveConnection as a0, increment as a1, serverTimestamp as a2, now as a3, toSeconds as a4, toMillis as a5, getIdToken as a6, deriveUserIdentityFromIdToken as a7, getSessionGeneration as a8, WebSessionManager as a9, normalizeEvmAddress as aA, toLowerEvmAddress as aB, functions as aC, invoke as aD, FunctionInvokeError as aE, live as aF, intent as aG, status as aH, subscribeView as aI, LiveIntentError as aJ, withEffects as aK, isEffectResult as aL, defineLiveModule as aM, EFFECT_INTENT_ADDRESS as aN, ReactNativeSessionManager as aa, getActiveSessionManager as ab, onSessionCleared as ac, announceSessionChange as ad, onSessionChange as ae, SESSION_SIGNAL_CHANNEL as af, SessionEnvironmentError as ag, UNSUPPORTED_ENVIRONMENT_CODE as ah, AUTH_CHANGED_CODE as ai, AUTH_EXPIRED_CODE as aj, isAuthExpiredError as ak, getFreshAuthToken as al, ServerSessionManager as am, createSessionWithSignature as an, refreshSession as ao, revokeSession as ap, signSessionCreateMessage as aq, genAuthNonce as ar, genSolanaMessage as as, createSolanaSignInRequest as at, createSolanaSignInMessageText as au, genSolanaSignInRequest as av, genSolanaSignInMessage as aw, browserSignInDomain as ax, SOLANA_SIGN_IN_STATEMENT as ay, genSiweMessage as az, bufferExports as b, getConfiguredAppId as c, get as d, getMany as e, docId as f, getConfig as g, setMany as h, init as i, setFile as j, getFiles as k, search as l, markWriteNotApplied as m, runQueryMany as n, runExpression as o, runExpressionMany as p, queryAggregate as q, runQuery as r, set as s, signMessage as t, signTransaction as u, signAndSubmitTransaction as v, count as w, aggregate as x, reconcileSetResult as y, waitForSetResult as z };
-//# sourceMappingURL=index-Db4lrwO6.mjs.map
+export { dispatchRateLimitEvent as $, waitForSetResult as A, isWriteNotApplied as B, writeNotAppliedPhase as C, subscribe as D, closeAllSubscriptions as E, clearCache as F, getCachedData as G, reconnectWithNewAuth as H, InsufficientBalanceError as I, createClient as J, exchangeAppToken as K, clearAppTokenCache as L, createAppTokenAuthHeaders as M, AppTokenExchangeError as N, setWithVenueGrant as O, resolveVenueRpcUrl as P, subscribeQuery as Q, closeAllQuerySubscriptions as R, ScopedClientReadOnlyError as S, canonicalizeArgs as T, canonicalizeResult as U, DEFAULT_QUERY_POLL_INTERVAL_MS as V, MIN_QUERY_POLL_INTERVAL_MS as W, BoundedDeclineError as X, deriveDecline as Y, dispatchDeclineEvent as Z, DECLINE_EVENT_NAME as _, markWriteNotApplied as a, RATE_LIMIT_EVENT_NAME as a0, hasActiveConnection as a1, increment as a2, serverTimestamp as a3, now as a4, toSeconds as a5, toMillis as a6, getIdToken as a7, deriveUserIdentityFromIdToken as a8, getSessionGeneration as a9, genSiweMessage as aA, normalizeEvmAddress as aB, toLowerEvmAddress as aC, functions as aD, invoke as aE, FunctionInvokeError as aF, live as aG, intent as aH, status as aI, subscribeView as aJ, LiveIntentError as aK, withEffects as aL, isEffectResult as aM, defineLiveModule as aN, EFFECT_INTENT_ADDRESS as aO, WebSessionManager as aa, ReactNativeSessionManager as ab, getActiveSessionManager as ac, onSessionCleared as ad, announceSessionChange as ae, onSessionChange as af, SESSION_SIGNAL_CHANNEL as ag, SessionEnvironmentError as ah, UNSUPPORTED_ENVIRONMENT_CODE as ai, AUTH_CHANGED_CODE as aj, AUTH_EXPIRED_CODE as ak, isAuthExpiredError as al, getFreshAuthToken as am, ServerSessionManager as an, createSessionWithSignature as ao, refreshSession as ap, revokeSession as aq, signSessionCreateMessage as ar, genAuthNonce as as, genSolanaMessage as at, createSolanaSignInRequest as au, createSolanaSignInMessageText as av, genSolanaSignInRequest as aw, genSolanaSignInMessage as ax, browserSignInDomain as ay, SOLANA_SIGN_IN_STATEMENT as az, bufferExports as b, getWebhookKeysUrl as c, getConfiguredAppId as d, get as e, getMany as f, getConfig as g, docId as h, init as i, setMany as j, setFile as k, getFiles as l, makeApiRequest as m, search as n, runQueryMany as o, runExpression as p, queryAggregate as q, runQuery as r, set as s, runExpressionMany as t, signMessage as u, signTransaction as v, signAndSubmitTransaction as w, count as x, aggregate as y, reconcileSetResult as z };
+//# sourceMappingURL=index-C6ZW5Gt2.mjs.map