@xyo-network/xl1-react-client-sdk 2.0.0 → 2.0.2

package/dist/browser/client/components/connected/DataLakeAddToChainPanel.d.ts

@@ -0,0 +1,53 @@
+import type { StackProps } from '@mui/material';
+import type { Schema } from '@xyo-network/sdk-js';
+import type { GatewayName } from '@xyo-network/xl1-sdk';
+import React from 'react';
+export interface DataLakeAddToChainPanelProps extends StackProps {
+    /**
+     * Base URL of the XL1 explorer. Defaults to the production deploy at
+     * {@link DEFAULT_EXPLORER_URL}. The panel builds the per-transaction
+     * link via `ExplorerLinks(explorerUrl, gatewayName).transaction(txHash)`.
+     */
+    explorerUrl?: string;
+    /** Gateway to use for chain writes. Defaults to `SequenceNetwork.id`. */
+    gatewayName?: GatewayName;
+    /** Initial textarea content. Defaults to a stamped JSON envelope keyed by `payloadSchema`. */
+    initialPayloadJson?: string;
+    /** Schema for the test payload. Defaults to `network.xyo.observation.v2`. */
+    payloadSchema?: Schema;
+    /** Wallet-detection timeout, forwarded to the wallet hooks. */
+    timeout?: number;
+}
+/**
+ * End-to-end "data lake → chain" flow for manual Storybook testing. The
+ * panel walks the user through:
+ *
+ *  1. **Request permissions** — embedded {@link RequestPermissionsButton}
+ *     covering signer + accounts (so `gateway.addPayloadsToChain` can
+ *     pull the signer address) plus data-lake read + write (so the
+ *     insert step can run), all collected in one consent popup.
+ *  2. **Edit the test payload** — a JSON textarea seeded with a stamped
+ *     `{ schema, value, timestamp }` envelope; the timestamp guarantees
+ *     a fresh content-address on each mount.
+ *  3. **Pick a runner-capable lake** — reuses {@link ApprovedLakeSelector}
+ *     with `capability="runner"` so the dropdown is narrowed to lakes the
+ *     user has granted write access to.
+ *  4. **Insert into the lake** — calls `client.dataLakes.insert(lakeId, [payload])`,
+ *     stashes the echoed-back stored payload (with `_hash`) in state.
+ *  5. **Add to chain** — builds a `HashPayload` referencing the stored
+ *     payload's hash and calls
+ *     `gateway.addPayloadsToChain([hashPayload], [storedPayload])`.
+ *     `onChain` is the hash reference; `offChain` is the stored payload
+ *     itself (the gateway re-inserts it into its own data lake under the
+ *     hood, so the content ends up in two places — see the story docs).
+ *  6. **Link to the explorer** — once `addPayloadsToChain` resolves with
+ *     a `txHash`, surfaces `ExplorerLinks(explorerUrl, gatewayName).transaction(txHash)`
+ *     as a "View on explorer" link. No client-side confirmation polling —
+ *     the explorer is the source of truth for inclusion state.
+ *
+ * Errors at any step short-circuit the rest of the flow and render
+ * inline. The user can retry by clicking the same step's button again,
+ * or by editing the upstream step (e.g. re-edit the payload, re-insert).
+ */
+export declare const DataLakeAddToChainPanel: React.FC<DataLakeAddToChainPanelProps>;
+//# sourceMappingURL=DataLakeAddToChainPanel.d.ts.map

package/dist/browser/client/components/connected/DataLakeAddToChainPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataLakeAddToChainPanel.d.ts","sourceRoot":"","sources":["../../../../../src/client/components/connected/DataLakeAddToChainPanel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAS/C,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAI1D,OAAO,KAAK,EACI,WAAW,EAE1B,MAAM,sBAAsB,CAAA;AAK7B,OAAO,KAA4B,MAAM,OAAO,CAAA;AAoQhD,MAAM,WAAW,4BAA6B,SAAQ,UAAU;IAC9D;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yEAAyE;IACzE,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,4BAA4B,CA8J1E,CAAA"}

package/dist/browser/client/components/connected/index.d.ts

@@ -1,6 +1,7 @@
 export * from './account/index.ts';
 export * from './ApprovedLakeSelector.tsx';
 export * from './ConnectAccountsStack.tsx';
+export * from './DataLakeAddToChainPanel.tsx';
 export * from './DataLakeGetButton.tsx';
 export * from './DataLakeGetPanel.tsx';
 export * from './DataLakeInsertButton.tsx';

package/dist/browser/client/components/connected/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/client/components/connected/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,mCAAmC,CAAA;AACjD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/client/components/connected/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,0BAA0B,CAAA;AACxC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,mCAAmC,CAAA;AACjD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA"}