@useinsider/guido 3.19.0 → 3.20.0-beta.0849ec7

package/dist/src/stores/guido-email-editor.d.ts

@@ -1,3 +1,13 @@
+/** Terminal outcome of an editor write, keyed by `${blueprintId}:${version}`. */
+export interface ApplyAck {
+    status: 'applied' | 'failed';
+    /** The `applyRequestedAt` of the click this ack answers — lets cortex drop stale acks. */
+    requestedAt: number;
+    /** Strictly increasing per key, so two acks in the same millisecond still order. */
+    ackAt: number;
+    /** Stringified — cortex JSON-clones store-derived payloads, an Error would not survive. */
+    error?: string;
+}
 /** The published editor snapshot — the shape a consumer reads off the shared store. */
 export interface GuidoEmailEditorState {
     /** Current Stripo HTML — stripe tables only, no DOCTYPE/wrapper. */
@@ -8,6 +18,10 @@ export interface GuidoEmailEditorState {
     lastUpdatedAt: number;
     /** Template id from the editor config, so a consumer can scope per-template. */
     templateId: string;
+    /** True while a mounted Guido bridge is consuming the chat store. Gates cortex's Apply button. */
+    bridgeActive: boolean;
+    /** `${blueprintId}:${version}` → terminal outcome of the editor write, written only after it settles. */
+    applyAcks: Record<string, ApplyAck>;
 }
 /**
  * Outbound contract Guido publishes to the host's shared Pinia singleton so a
@@ -18,17 +32,11 @@ export interface GuidoEmailEditorState {
  * Published as `@useinsider/guido/editor-state` and from the root barrel, so a
  * consumer imports this store instead of re-declaring one under the same id.
  *
- * State + getters only, no actions. `useGuidoStateBridge` is the only intended
- * writer, but that is Guido's own convention rather than something the store
- * enforces: publishing the definition hands a consumer `$patch` as well, exactly
- * as the runtime `pinia._s` probe always did.
+ * State-only by contract: cortex-fe reads `pinia.state.value['guidoEmailEditor']`, which misses
+ * actions and getters. Intended writers: `useGuidoStateBridge` and `useCortexBlueprintBridge`.
  *
- * Store id `guidoEmailEditor` is cross-MFE: cortex-fe reads it via
- * `pinia._s.get('guidoEmailEditor')` at runtime rather than importing it, so the
- * id stays part of the contract. The internal Guido editor store keeps id
- * `guidoEditor` — these are intentionally separate. The internal store carries
- * UI state a consumer should not see; this public store carries the contract
- * Guido is willing to share.
+ * The id `guidoEmailEditor` is part of the cross-MFE contract; the internal
+ * store `guidoEditor` is intentionally separate.
  */
 export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"guidoEmailEditor", GuidoEmailEditorState, {
     /** True once the bridge has published at least one snapshot. */
@@ -37,5 +45,7 @@ export declare const useGuidoEmailEditorStore: import("pinia").StoreDefinition<"
         css: string;
         lastUpdatedAt: number;
         templateId: string;
+        bridgeActive: boolean;
+        applyAcks: Record<string, ApplyAck>;
     } & import("pinia").PiniaCustomStateProperties<GuidoEmailEditorState>) => boolean;
 }, {}>;