@use-stellar/vue 0.0.0-stage → 0.2.3

package/LICENSE

@@ -0,0 +1,134 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work.
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship.
+
+      "Contribution" shall mean any work of authorship submitted to the
+      Licensor for inclusion in the Work by the copyright owner or by an
+      individual or Legal Entity authorized to submit on behalf of the
+      copyright owner.
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and subsequently
+      incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      patent license to make, have made, use, offer to sell, sell, import,
+      and otherwise transfer the Work.
+
+   4. Redistribution. You may reproduce and distribute copies of the Work
+      or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You meet
+      the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative Works
+          a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works that
+          You distribute, all copyright, patent, trademark, and attribution
+          notices from the Source form of the Work; and
+
+      (d) If the Work includes a "NOTICE" text file, You must include a
+          readable copy of the attribution notices contained within such
+          NOTICE file.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution submitted for inclusion in the Work shall be under
+      the terms and conditions of this License, without any additional
+      terms or conditions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or agreed
+      to in writing, Licensor provides the Work on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law, shall any Contributor be liable
+      to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer, and
+      charge a fee for, acceptance of support, warranty, indemnity, or
+      other liability obligations consistent with this License. However,
+      in accepting such obligations, You may act only on Your own behalf
+      and on Your sole responsibility, not on behalf of any other
+      Contributor, and only if You agree to indemnify, defend, and hold
+      each Contributor harmless for any liability incurred by, or claims
+      asserted against, such Contributor by reason of your accepting any
+      such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2024 israelolrunfemi
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,188 @@
-# Temporary Holding Version
+# @use-stellar/vue
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Vue 3 composables for the Stellar network, built on [`use-stellar`](https://www.npmjs.com/package/use-stellar).
+
+The composables return Vue refs and clean up with their effect scope. Everything underneath — Horizon and Soroban fetchers, transaction building, fee policy, error codes, the query cache — is the same React-free code the React hooks use, imported from `use-stellar/core`. React is never loaded.
+
+## Installation
+
+```bash
+npm install @use-stellar/vue use-stellar vue
+```
+
+`use-stellar` and `vue` (3.3 or later) are peer dependencies: your app has one copy of each, shared with anything else that uses them.
+
+Install the SDK of the wallet you will sign with, exactly as for the React package — for example `npm install @stellar/freighter-api`. See [Supported wallets](https://github.com/RaceeyXo/use-stellar/tree/main/packages/core#supported-wallets).
+
+## Quick start
+
+Install the plugin once. It defaults to testnet.
+
+```ts
+// main.ts
+import { createApp } from "vue"
+import { createStellarPlugin } from "@use-stellar/vue"
+import App from "./App.vue"
+
+createApp(App)
+  .use(createStellarPlugin({ network: "testnet" }))
+  .mount("#app")
+```
+
+Then use the composables in any component:
+
+```vue
+<script setup lang="ts">
+import { ref } from "vue"
+import { useBalance } from "@use-stellar/vue"
+
+const address = ref("G...")
+const { balance, loading, error } = useBalance({ address })
+</script>
+
+<template>
+  <p v-if="loading">Loading…</p>
+  <p v-else-if="error">{{ error.message }}</p>
+  <p v-else>{{ balance }} XLM</p>
+</template>
+```
+
+Every option accepts a plain value, a ref, or a getter, and changes are picked up reactively.
+
+### Plugin options
+
+| Option          | Default                                  | Description                                                                  |
+| --------------- | ---------------------------------------- | ---------------------------------------------------------------------------- |
+| `network`       | `"testnet"`                              | `"testnet"`, `"mainnet"` or `"futurenet"`.                                   |
+| `networkConfig` | —                                        | Override `horizonUrl`, `sorobanUrl` or `networkPassphrase` for that network. |
+| `queryConfig`   | `{ staleTime: 30_000, gcTime: 300_000 }` | Cache timings in milliseconds, shared by every composable.                   |
+| `walletAddress` | `null`                                   | The address read composables default to when given none.                     |
+
+## Composables
+
+### Reading
+
+```ts
+// XLM, or any asset with `asset: { code, issuer }`
+const { balance, balances, loading, error, refetch } = useBalance({ address })
+
+// Claimable balances; defaults to the runtime's wallet address
+const { balances } = useClaimableBalance({ address })
+
+// Paginated payments
+const { payments, hasNext, fetchNext } = usePayments({ address, limit: 20 })
+
+// The same, filtered on Horizon by direction and asset
+const { payments: received } = usePaymentHistory({ address, direction: "incoming" })
+
+// Read-only Soroban contract call, simulated
+const { data } = useSorobanContract<number>({ contractId: "C...", method: "get_count" })
+
+// Poll a contract's events
+const { events, latestLedger } = useContractEvents({ contractIds: ["C..."] })
+```
+
+Requests are deduplicated and cached per app: two components asking for the same account share one request. `useBalance` accepts `maxRetries` (default 3) for rate limits.
+
+### Writing
+
+```ts
+const { send, loading, error, result } = useSendPayment()
+await send({ to: "G...", asset: "XLM", amount: "10" })
+
+const { addTrustline } = useAddTrustline()
+await addTrustline({ asset: { code: "USDC", issuer: "G..." } })
+
+const { pathPayment } = usePathPayment()
+await pathPayment({
+  mode: "strictSend",
+  destination: "G...",
+  sendAsset: "XLM",
+  sendAmount: "100",
+  destAsset: { code: "USDC", issuer: "G..." },
+  destMin: "24.75",
+})
+```
+
+Validation, fee policy, the network check, signing and cache invalidation are the core actions the React hooks use, so behaviour and error codes are identical.
+
+### Connecting a wallet
+
+This release has no `useWallet` composable yet. The write composables sign with the wallet set on the runtime, so connect through a core wallet adapter and hand the result to the runtime:
+
+```ts
+import { freighterAdapter, getWalletAdapter, registerWalletAdapter } from "use-stellar/core"
+import { useStellarRuntime } from "@use-stellar/vue"
+
+// Once, at startup. `use-stellar/core` registers no browser wallets itself.
+registerWalletAdapter(freighterAdapter, { override: true })
+
+const runtime = useStellarRuntime() // inside setup()
+
+async function connect() {
+  const adapter = getWalletAdapter("freighter")
+  const connection = await adapter.connect(runtime.network)
+  runtime.setWallet({
+    connected: true,
+    connecting: false,
+    address: connection.address,
+    network: runtime.network,
+    wallet: connection.wallet,
+    walletName: adapter.metadata.name,
+    error: null,
+    walletNetwork: connection.network,
+    walletNetworkPassphrase: connection.networkPassphrase,
+  })
+}
+```
+
+`setWallet` also sets the address the read composables default to. Register each wallet you offer the same way: `freighterAdapter` and `rabetAdapter` are exported from `use-stellar/core`, `createWalletConnectAdapter` creates a WalletConnect adapter, and any object implementing the `WalletAdapter` contract works.
+
+## Nuxt
+
+A Nuxt module is included. It installs the runtime and, on the client, can restore the previous wallet session:
+
+```ts
+// nuxt.config.ts
+export default defineNuxtConfig({
+  modules: ["@use-stellar/vue/nuxt"],
+  runtimeConfig: {
+    public: {
+      stellar: {
+        network: "testnet",
+        autoConnect: true, // or { enabled: true, storage: "session" }
+      },
+    },
+  },
+})
+```
+
+The settings are read from `runtimeConfig.public.stellar`, so they can also come from environment variables in the usual Nuxt way.
+
+Session restore never prompts: it reconnects only when the wallet allows a silent reconnect, and otherwise just remembers which wallet was used. Nothing is fetched during server rendering.
+
+## Testing
+
+`@use-stellar/vue/test-utils` gives a composable a runtime without mounting a component:
+
+```ts
+import { createStellarTestHarness } from "@use-stellar/vue/test-utils"
+import { useBalance } from "@use-stellar/vue"
+
+const harness = createStellarTestHarness({ network: "testnet" })
+const { balance } = harness.run(() => useBalance({ address: "G..." }))
+
+// ...assert...
+
+harness.dispose() // tears down every watcher created inside run()
+```
+
+Mock `@stellar/stellar-sdk`'s `Horizon.Server` in tests rather than calling the network.
+
+## Errors
+
+Every `error` ref holds a typed `StellarError` with a stable `code` (`ACCOUNT_NOT_FOUND`, `RATE_LIMITED`, `WALLET_NOT_CONNECTED`, `TX_TIMEOUT`, …) and a readable `message` — the same codes as the React package. See the [error-code table](https://github.com/RaceeyXo/use-stellar/tree/main/packages/core#error-codes).
+
+## License
+
+[Apache-2.0](https://github.com/RaceeyXo/use-stellar/blob/main/LICENSE)

package/dist/chunk-7ROX7ZPL.mjs

@@ -0,0 +1,123 @@
+import { shallowRef, inject } from 'vue';
+import { QueryStore, readWalletSession, getWalletAdapter } from 'use-stellar/core';
+
+// src/types.ts
+var NETWORK_PASSPHRASES = {
+  testnet: "Test SDF Network ; September 2015",
+  mainnet: "Public Global Stellar Network ; September 2015",
+  futurenet: "Test SDF Future Network ; October 2022"
+};
+var NETWORK_CONFIGS = {
+  testnet: {
+    network: "testnet",
+    horizonUrl: "https://horizon-testnet.stellar.org",
+    sorobanUrl: "https://soroban-testnet.stellar.org",
+    networkPassphrase: NETWORK_PASSPHRASES.testnet
+  },
+  mainnet: {
+    network: "mainnet",
+    horizonUrl: "https://horizon.stellar.org",
+    sorobanUrl: "https://soroban.stellar.org",
+    networkPassphrase: NETWORK_PASSPHRASES.mainnet
+  },
+  futurenet: {
+    network: "futurenet",
+    horizonUrl: "https://horizon-futurenet.stellar.org",
+    sorobanUrl: "https://rpc-futurenet.stellar.org",
+    networkPassphrase: NETWORK_PASSPHRASES.futurenet
+  }
+};
+var STELLAR_RUNTIME_KEY = /* @__PURE__ */ Symbol("use-stellar/vue:runtime");
+var DISCONNECTED_WALLET = {
+  connected: false,
+  connecting: false,
+  address: null,
+  network: null,
+  wallet: null,
+  walletName: null,
+  error: null,
+  walletNetwork: null,
+  walletNetworkPassphrase: null
+};
+function resolveNetworkConfig(network, override) {
+  const builtIn = NETWORK_CONFIGS[network];
+  if (!override) return builtIn;
+  return {
+    network,
+    horizonUrl: override.horizonUrl ?? builtIn.horizonUrl,
+    sorobanUrl: override.sorobanUrl ?? builtIn.sorobanUrl,
+    networkPassphrase: override.networkPassphrase ?? builtIn.networkPassphrase
+  };
+}
+function createStellarRuntime(options = {}) {
+  const network = options.network ?? "testnet";
+  const walletAddress = shallowRef(options.walletAddress ?? null);
+  const runtime = {
+    network,
+    networkConfig: resolveNetworkConfig(network, options.networkConfig),
+    queryStore: new QueryStore(options.queryConfig),
+    wallet: { ...DISCONNECTED_WALLET, address: options.walletAddress ?? null },
+    setWallet(wallet) {
+      runtime.wallet = wallet;
+      walletAddress.value = wallet.address;
+    },
+    walletAddress,
+    setWalletAddress(address) {
+      walletAddress.value = address;
+    }
+  };
+  return runtime;
+}
+async function restoreWalletSession(runtime, storage = "local") {
+  const session = await readWalletSession(storage);
+  if (!session) return;
+  try {
+    const adapter = getWalletAdapter(session.wallet);
+    const available = await adapter.isAvailable();
+    if (!available) return;
+    const canReconnect = adapter.canAutoConnect ? await adapter.canAutoConnect(runtime.network) : false;
+    if (!canReconnect) {
+      runtime.setWallet({
+        ...runtime.wallet,
+        wallet: session.wallet,
+        walletName: adapter.metadata.name,
+        address: session.address ?? null
+      });
+      return;
+    }
+    const connection = await adapter.connect(runtime.network);
+    const network = await adapter.getNetworkDetails(runtime.network);
+    runtime.setWallet({
+      connected: true,
+      connecting: false,
+      address: connection.address,
+      network: runtime.network,
+      wallet: connection.wallet,
+      walletName: adapter.metadata.name,
+      error: null,
+      walletNetwork: network.network,
+      walletNetworkPassphrase: network.networkPassphrase
+    });
+  } catch {
+  }
+}
+function createStellarPlugin(options = {}) {
+  return {
+    install(app) {
+      app.provide(STELLAR_RUNTIME_KEY, createStellarRuntime(options));
+    }
+  };
+}
+function useStellarRuntime() {
+  const runtime = inject(STELLAR_RUNTIME_KEY);
+  if (!runtime) {
+    throw new Error(
+      "@use-stellar/vue: no plugin installed. Call app.use(createStellarPlugin()) before using any composable."
+    );
+  }
+  return runtime;
+}
+
+export { NETWORK_CONFIGS, STELLAR_RUNTIME_KEY, createStellarPlugin, createStellarRuntime, restoreWalletSession, useStellarRuntime };
+//# sourceMappingURL=chunk-7ROX7ZPL.mjs.map
+//# sourceMappingURL=chunk-7ROX7ZPL.mjs.map

package/dist/chunk-7ROX7ZPL.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/plugin.ts"],"names":[],"mappings":";;;;AA0BA,IAAM,mBAAA,GAAsD;AAAA,EAC1D,OAAA,EAAS,mCAAA;AAAA,EACT,OAAA,EAAS,gDAAA;AAAA,EACT,SAAA,EAAW;AACb,CAAA;AAEO,IAAM,eAAA,GAAyD;AAAA,EACpE,OAAA,EAAS;AAAA,IACP,OAAA,EAAS,SAAA;AAAA,IACT,UAAA,EAAY,qCAAA;AAAA,IACZ,UAAA,EAAY,qCAAA;AAAA,IACZ,mBAAmB,mBAAA,CAAoB;AAAA,GACzC;AAAA,EACA,OAAA,EAAS;AAAA,IACP,OAAA,EAAS,SAAA;AAAA,IACT,UAAA,EAAY,6BAAA;AAAA,IACZ,UAAA,EAAY,6BAAA;AAAA,IACZ,mBAAmB,mBAAA,CAAoB;AAAA,GACzC;AAAA,EACA,SAAA,EAAW;AAAA,IACT,OAAA,EAAS,WAAA;AAAA,IACT,UAAA,EAAY,uCAAA;AAAA,IACZ,UAAA,EAAY,mCAAA;AAAA,IACZ,mBAAmB,mBAAA,CAAoB;AAAA;AAE3C;ACdO,IAAM,mBAAA,0BAA2D,yBAAyB;AAEjG,IAAM,mBAAA,GAAmC;AAAA,EACvC,SAAA,EAAW,KAAA;AAAA,EACX,UAAA,EAAY,KAAA;AAAA,EACZ,OAAA,EAAS,IAAA;AAAA,EACT,OAAA,EAAS,IAAA;AAAA,EACT,MAAA,EAAQ,IAAA;AAAA,EACR,UAAA,EAAY,IAAA;AAAA,EACZ,KAAA,EAAO,IAAA;AAAA,EACP,aAAA,EAAe,IAAA;AAAA,EACf,uBAAA,EAAyB;AAC3B,CAAA;AAEA,SAAS,oBAAA,CACP,SACA,QAAA,EACe;AACf,EAAA,MAAM,OAAA,GAAU,gBAAgB,OAAO,CAAA;AACvC,EAAA,IAAI,CAAC,UAAU,OAAO,OAAA;AAEtB,EAAA,OAAO;AAAA,IACL,OAAA;AAAA,IACA,UAAA,EAAY,QAAA,CAAS,UAAA,IAAc,OAAA,CAAQ,UAAA;AAAA,IAC3C,UAAA,EAAY,QAAA,CAAS,UAAA,IAAc,OAAA,CAAQ,UAAA;AAAA,IAC3C,iBAAA,EAAmB,QAAA,CAAS,iBAAA,IAAqB,OAAA,CAAQ;AAAA,GAC3D;AACF;AAOO,SAAS,oBAAA,CAAqB,OAAA,GAAgC,EAAC,EAAmB;AACvF,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,SAAA;AACnC,EAAA,MAAM,aAAA,GAAgB,UAAA,CAAW,OAAA,CAAQ,aAAA,IAAiB,IAAI,CAAA;AAE9D,EAAA,MAAM,OAAA,GAA0B;AAAA,IAC9B,OAAA;AAAA,IACA,aAAA,EAAe,oBAAA,CAAqB,OAAA,EAAS,OAAA,CAAQ,aAAa,CAAA;AAAA,IAClE,UAAA,EAAY,IAAI,UAAA,CAAW,OAAA,CAAQ,WAAW,CAAA;AAAA,IAC9C,QAAQ,EAAE,GAAG,qBAAqB,OAAA,EAAS,OAAA,CAAQ,iBAAiB,IAAA,EAAK;AAAA,IACzE,UAAU,MAAA,EAAc;AACtB,MAAA,OAAA,CAAQ,MAAA,GAAS,MAAA;AACjB,MAAA,aAAA,CAAc,QAAQ,MAAA,CAAO,OAAA;AAAA,IAC/B,CAAA;AAAA,IACA,aAAA;AAAA,IACA,iBAAiB,OAAA,EAA8B;AAC7C,MAAA,aAAA,CAAc,KAAA,GAAQ,OAAA;AAAA,IACxB;AAAA,GACF;AACA,EAAA,OAAO,OAAA;AACT;AAGA,eAAsB,oBAAA,CACpB,OAAA,EACA,OAAA,GAA+B,OAAA,EAChB;AACf,EAAA,MAAM,OAAA,GAAU,MAAM,iBAAA,CAAkB,OAAO,CAAA;AAC/C,EAAA,IAAI,CAAC,OAAA,EAAS;AAEd,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,gBAAA,CAAiB,OAAA,CAAQ,MAAM,CAAA;AAC/C,IAAA,MAAM,SAAA,GAAY,MAAM,OAAA,CAAQ,WAAA,EAAY;AAC5C,IAAA,IAAI,CAAC,SAAA,EAAW;AAEhB,IAAA,MAAM,YAAA,GAAe,QAAQ,cAAA,GACzB,MAAM,QAAQ,cAAA,CAAe,OAAA,CAAQ,OAAO,CAAA,GAC5C,KAAA;AACJ,IAAA,IAAI,CAAC,YAAA,EAAc;AACjB,MAAA,OAAA,CAAQ,SAAA,CAAU;AAAA,QAChB,GAAG,OAAA,CAAQ,MAAA;AAAA,QACX,QAAQ,OAAA,CAAQ,MAAA;AAAA,QAChB,UAAA,EAAY,QAAQ,QAAA,CAAS,IAAA;AAAA,QAC7B,OAAA,EAAS,QAAQ,OAAA,IAAW;AAAA,OAC7B,CAAA;AACD,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,UAAA,GAAa,MAAM,OAAA,CAAQ,OAAA,CAAQ,QAAQ,OAAO,CAAA;AACxD,IAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,iBAAA,CAAkB,QAAQ,OAAO,CAAA;AAC/D,IAAA,OAAA,CAAQ,SAAA,CAAU;AAAA,MAChB,SAAA,EAAW,IAAA;AAAA,MACX,UAAA,EAAY,KAAA;AAAA,MACZ,SAAS,UAAA,CAAW,OAAA;AAAA,MACpB,SAAS,OAAA,CAAQ,OAAA;AAAA,MACjB,QAAQ,UAAA,CAAW,MAAA;AAAA,MACnB,UAAA,EAAY,QAAQ,QAAA,CAAS,IAAA;AAAA,MAC7B,KAAA,EAAO,IAAA;AAAA,MACP,eAAe,OAAA,CAAQ,OAAA;AAAA,MACvB,yBAAyB,OAAA,CAAQ;AAAA,KAClC,CAAA;AAAA,EACH,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AAaO,SAAS,mBAAA,CAAoB,OAAA,GAAgC,EAAC,EAAG;AACtE,EAAA,OAAO;AAAA,IACL,QAAQ,GAAA,EAAgB;AACtB,MAAA,GAAA,CAAI,OAAA,CAAQ,mBAAA,EAAqB,oBAAA,CAAqB,OAAO,CAAC,CAAA;AAAA,IAChE;AAAA,GACF;AACF;AAQO,SAAS,iBAAA,GAAoC;AAClD,EAAA,MAAM,OAAA,GAAU,OAAO,mBAAmB,CAAA;AAC1C,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT","file":"chunk-7ROX7ZPL.mjs","sourcesContent":["// packages/vue/src/types.ts\n//\n// A small, self-contained type set for the Vue adapter. Deliberately not\n// imported from the `use-stellar` (React) package: that package declares\n// `react` as a required peer dependency, and pulling any part of it in here\n// would put a React peer-dependency warning in front of every Vue user who\n// installs this package — the exact installation friction `rn-03` fixed for\n// React Native. Custom networks aren't supported yet; only the three SDF\n// defaults are.\n\nexport type StellarNetwork = \"testnet\" | \"mainnet\" | \"futurenet\"\n\nexport interface NetworkConfig {\n  network: StellarNetwork\n  horizonUrl: string\n  sorobanUrl: string\n  networkPassphrase: string\n}\n\nexport type Asset = \"XLM\" | { code: string; issuer: string }\n\nexport type Balance =\n  | { asset: \"XLM\"; balance: string }\n  | { asset: { code: string; issuer: string }; balance: string; limit?: string }\n  | { asset: \"liquidity_pool_shares\"; balance: string; liquidityPoolId: string }\n\nconst NETWORK_PASSPHRASES: Record<StellarNetwork, string> = {\n  testnet: \"Test SDF Network ; September 2015\",\n  mainnet: \"Public Global Stellar Network ; September 2015\",\n  futurenet: \"Test SDF Future Network ; October 2022\",\n}\n\nexport const NETWORK_CONFIGS: Record<StellarNetwork, NetworkConfig> = {\n  testnet: {\n    network: \"testnet\",\n    horizonUrl: \"https://horizon-testnet.stellar.org\",\n    sorobanUrl: \"https://soroban-testnet.stellar.org\",\n    networkPassphrase: NETWORK_PASSPHRASES.testnet,\n  },\n  mainnet: {\n    network: \"mainnet\",\n    horizonUrl: \"https://horizon.stellar.org\",\n    sorobanUrl: \"https://soroban.stellar.org\",\n    networkPassphrase: NETWORK_PASSPHRASES.mainnet,\n  },\n  futurenet: {\n    network: \"futurenet\",\n    horizonUrl: \"https://horizon-futurenet.stellar.org\",\n    sorobanUrl: \"https://rpc-futurenet.stellar.org\",\n    networkPassphrase: NETWORK_PASSPHRASES.futurenet,\n  },\n}\n","// packages/vue/src/plugin.ts\n\nimport { inject, shallowRef, type App, type InjectionKey, type Ref } from \"vue\"\nimport {\n  QueryStore,\n  getWalletAdapter,\n  readWalletSession,\n  type QueryConfig,\n  type WalletState,\n} from \"use-stellar/core\"\nimport { NETWORK_CONFIGS, type NetworkConfig, type StellarNetwork } from \"./types\"\n\nexport interface StellarPluginOptions {\n  /** Defaults to `\"testnet\"`. */\n  network?: StellarNetwork\n  /** Override the built-in Horizon/Soroban endpoints for `network`. Any field left out keeps the default. */\n  networkConfig?: Partial<Pick<NetworkConfig, \"horizonUrl\" | \"sorobanUrl\" | \"networkPassphrase\">>\n  /** Cache configuration shared by every composable. */\n  queryConfig?: QueryConfig\n  /** Initial connected wallet address, primarily for restored client sessions. */\n  walletAddress?: string | null\n}\n\nexport interface StellarRuntime {\n  network: StellarNetwork\n  networkConfig: NetworkConfig\n  /** One query cache per app, shared by every composable. */\n  queryStore: QueryStore\n  /** The wallet connection the write composables sign with. */\n  wallet: WalletState\n  /** Replaces the wallet state, and keeps `walletAddress` in step with it. */\n  setWallet: (wallet: WalletState) => void\n  /** The address read composables default to when given none. */\n  walletAddress: Ref<string | null>\n  setWalletAddress: (address: string | null) => void\n}\n\nexport const STELLAR_RUNTIME_KEY: InjectionKey<StellarRuntime> = Symbol(\"use-stellar/vue:runtime\")\n\nconst DISCONNECTED_WALLET: WalletState = {\n  connected: false,\n  connecting: false,\n  address: null,\n  network: null,\n  wallet: null,\n  walletName: null,\n  error: null,\n  walletNetwork: null,\n  walletNetworkPassphrase: null,\n}\n\nfunction resolveNetworkConfig(\n  network: StellarNetwork,\n  override: StellarPluginOptions[\"networkConfig\"]\n): NetworkConfig {\n  const builtIn = NETWORK_CONFIGS[network]\n  if (!override) return builtIn\n\n  return {\n    network,\n    horizonUrl: override.horizonUrl ?? builtIn.horizonUrl,\n    sorobanUrl: override.sorobanUrl ?? builtIn.sorobanUrl,\n    networkPassphrase: override.networkPassphrase ?? builtIn.networkPassphrase,\n  }\n}\n\n/**\n * Builds a Stellar runtime without installing it as a plugin. Used by\n * {@link createStellarPlugin} itself, and by the test harness in\n * `use-stellar/vue/test-utils` to provide a runtime without a real app.\n */\nexport function createStellarRuntime(options: StellarPluginOptions = {}): StellarRuntime {\n  const network = options.network ?? \"testnet\"\n  const walletAddress = shallowRef(options.walletAddress ?? null)\n\n  const runtime: StellarRuntime = {\n    network,\n    networkConfig: resolveNetworkConfig(network, options.networkConfig),\n    queryStore: new QueryStore(options.queryConfig),\n    wallet: { ...DISCONNECTED_WALLET, address: options.walletAddress ?? null },\n    setWallet(wallet): void {\n      runtime.wallet = wallet\n      walletAddress.value = wallet.address\n    },\n    walletAddress,\n    setWalletAddress(address: string | null): void {\n      walletAddress.value = address\n    },\n  }\n  return runtime\n}\n\n/** Restores a persisted wallet without ever prompting during server rendering. */\nexport async function restoreWalletSession(\n  runtime: StellarRuntime,\n  storage: \"local\" | \"session\" = \"local\"\n): Promise<void> {\n  const session = await readWalletSession(storage)\n  if (!session) return\n\n  try {\n    const adapter = getWalletAdapter(session.wallet)\n    const available = await adapter.isAvailable()\n    if (!available) return\n\n    const canReconnect = adapter.canAutoConnect\n      ? await adapter.canAutoConnect(runtime.network)\n      : false\n    if (!canReconnect) {\n      runtime.setWallet({\n        ...runtime.wallet,\n        wallet: session.wallet,\n        walletName: adapter.metadata.name,\n        address: session.address ?? null,\n      })\n      return\n    }\n\n    const connection = await adapter.connect(runtime.network)\n    const network = await adapter.getNetworkDetails(runtime.network)\n    runtime.setWallet({\n      connected: true,\n      connecting: false,\n      address: connection.address,\n      network: runtime.network,\n      wallet: connection.wallet,\n      walletName: adapter.metadata.name,\n      error: null,\n      walletNetwork: network.network,\n      walletNetworkPassphrase: network.networkPassphrase,\n    })\n  } catch {\n    // Session restoration is best-effort; a normal disconnected app remains usable.\n  }\n}\n\n/**\n * Vue plugin that installs the Stellar runtime — resolved network config plus\n * one shared query cache — so every composable in this package reads and\n * writes through the same instance.\n *\n * @example\n * import { createApp } from \"vue\"\n * import { createStellarPlugin } from \"@use-stellar/vue\"\n *\n * createApp(App).use(createStellarPlugin({ network: \"testnet\" })).mount(\"#app\")\n */\nexport function createStellarPlugin(options: StellarPluginOptions = {}) {\n  return {\n    install(app: App): void {\n      app.provide(STELLAR_RUNTIME_KEY, createStellarRuntime(options))\n    },\n  }\n}\n\n/**\n * Reads the installed Stellar runtime.\n *\n * @throws {Error} when called outside a component tree the plugin was\n * installed on (or outside `app.runWithContext()` in tests).\n */\nexport function useStellarRuntime(): StellarRuntime {\n  const runtime = inject(STELLAR_RUNTIME_KEY)\n  if (!runtime) {\n    throw new Error(\n      \"@use-stellar/vue: no plugin installed. Call \" +\n        \"app.use(createStellarPlugin()) before using any composable.\"\n    )\n  }\n  return runtime\n}\n"]}