@defdone/annon 0.0.0-stage → 0.1.0-alpha.1

package/dist/browser/download.d.ts

@@ -0,0 +1,19 @@
+/** Bounded, proof-authorized ciphertext download. Plaintext and released keys stay in memory. */
+import { type DownloadOptions } from '../download/download.js';
+import { type Listing } from '../envelope/pay2.js';
+/** The cap includes the PAY2 header and ciphertext overhead. Larger files use the CLI. */
+export declare const BROWSER_DOWNLOAD_LIMIT = 50086016;
+export interface BrowserDownloadProgress {
+    phase: 'downloading' | 'decrypting' | 'ready';
+    received: number;
+    total?: number;
+}
+export interface BrowserDownloadOptions extends Omit<DownloadOptions, 'maxBytes'> {
+    listing: Listing;
+    checkedHeaderHash: string;
+    /** Known encrypted file size, if the host advertises one. The stream cap always applies. */
+    size?: number;
+    onProgress?: (event: BrowserDownloadProgress) => void;
+}
+export declare function downloadProgress(callback: BrowserDownloadOptions['onProgress'], event: BrowserDownloadProgress): void;
+export declare function browserDownload(o: BrowserDownloadOptions): Promise<Uint8Array>;

package/dist/browser/download.js

@@ -0,0 +1,52 @@
+/** Bounded, proof-authorized ciphertext download. Plaintext and released keys stay in memory. */
+import { DownloadError, download } from '../download/download.js';
+import { concat, inspectHeader } from '../envelope/pay2.js';
+import { MAX_PAY2_BYTES } from '../limits.js';
+import { hex } from '../settle-near/codec.js';
+/** The cap includes the PAY2 header and ciphertext overhead. Larger files use the CLI. */
+export const BROWSER_DOWNLOAD_LIMIT = MAX_PAY2_BYTES;
+export function downloadProgress(callback, event) {
+    try {
+        callback?.(event);
+    }
+    catch {
+        /* Page observers cannot interrupt opening a purchase. */
+    }
+}
+export async function browserDownload(o) {
+    if (o.size !== undefined && (!Number.isSafeInteger(o.size) || o.size < 0))
+        throw new TypeError('invalid file size');
+    if (o.size !== undefined && o.size > BROWSER_DOWNLOAD_LIMIT)
+        throw new DownloadError('too_large', 'File exceeds the 50 MB size limit.');
+    if (o.signal?.aborted)
+        throw new DownloadError('cancelled');
+    const inspected = await inspectHeader(o.header, o.listing, o.contractId);
+    if (hex(inspected.headerHash) !== o.checkedHeaderHash)
+        throw new DownloadError('file_mismatch', 'header differs from the checked purchase header');
+    const reader = download({ ...o, maxBytes: BROWSER_DOWNLOAD_LIMIT }).getReader();
+    const parts = [];
+    let received = 0;
+    try {
+        for (;;) {
+            const next = await reader.read();
+            if (o.signal?.aborted)
+                throw new DownloadError('cancelled');
+            if (next.done)
+                return concat(...parts);
+            received += next.value.length;
+            // Defense in depth if the underlying downloader changes its buffering behavior.
+            if (received > BROWSER_DOWNLOAD_LIMIT)
+                throw new DownloadError('too_large', 'File exceeds the 50 MB size limit.');
+            parts.push(next.value);
+            downloadProgress(o.onProgress, {
+                phase: 'downloading',
+                received,
+                ...(o.size === undefined ? {} : { total: o.size }),
+            });
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => { });
+        reader.releaseLock();
+    }
+}

package/dist/browser/index.d.ts

@@ -0,0 +1,23 @@
+export { AnnonError, type AnnonErrorCode, isTransient, type PublicError, toPublicError, } from '../errors.js';
+/** Browser purchase logic. The embedding application supplies its own screen and wallets. */
+export { Annon, type AnnonOptions, type BuyOptions, type BuyRoute, SellError, } from '../api/annon.js';
+export type { HostedCheckpoint, Shared, ShareHosting, ShareOptions, ShareQuote, ShareStep, } from '../api/sharing.js';
+export { DownloadError, type DownloadErrorCode } from '../download/download.js';
+export { type UploadAuth, type UploadAuthorization, type UploadBaseSplit, type UploadBaseSplitResult, UploadClient, type UploadIntent, type UploadManifest, type UploadMetadata, type UploadPublished, type UploadStatus, uploadText, } from '../download/upload.js';
+export { Pay2Error, type Pay2ErrorCode } from '../envelope/pay2.js';
+export { SourceChangedError } from '../envelope/stream.js';
+export { CkdError, type CkdErrorCode } from '../keys/near-ckd.js';
+export { HTTP_RETRY_MAX_WAIT_SECONDS, MAX_PAY2_BYTES, MAX_PLAINTEXT_BYTES } from '../limits.js';
+export { NearError, type NearErrorCode, NearRpcRateLimited } from '../near/rpc.js';
+export { type FileFundingArgs, fileFundingText } from '../near/texts.js';
+export { type Deposit, OneClick, type OneClickQuote, OneClickQuoteExpired, OneClickRefused, type Origin, originFromToken, type PollCheckpoint, type PollOptions, type QuotePreview, type SwapStatus, type Token, validateRefundAddress, } from '../oneclick/oneclick.js';
+export { exportSellerKey, importSellerKey, newBackupSecret, type SellerKeyRecord, } from '../pay/backup.js';
+export { BaseRpcRateLimited, PayError, type PayErrorCode } from '../pay/base.js';
+export { BASE_ELIGIBILITY_MAX_AGE_SECONDS, type BaseSponsorship, type BaseSponsorshipOptions, checkBaseSponsorship, validBaseSponsorship, } from '../relay/capabilities.js';
+export { type CatalogEntry, type CatalogQuery, type ConfiguredShop, canonicalManifestUrl, catalog, type DiscoveryConfig, type DiscoveryPage, type DiscoveryQuery, listShops, type Shop, type ShopFailure, type ShopManifest, type ShopProfile, type ShopRules, } from '../shops/discovery.js';
+export { TransactionUncertain } from '../wallet/uncertain.js';
+export { type EvmWallet, FileFundingRefused, type IdentityWallet, type NearWallet, } from '../wallet/wallet.js';
+export { BROWSER_DOWNLOAD_LIMIT, type BrowserDownloadOptions, type BrowserDownloadProgress, browserDownload, } from './download.js';
+export { type BrowserOpenOptions, BrowserPurchaseController, type BrowserPurchaseRecord, type BrowserPurchaseState, type BrowserPurchaseStorage, browserAnnon, browserPurchaseStorage, type ControllerOptions, PurchaseLeaseBusy, type PurchaseProgress, type PurchaseSdk, type PurchaseTermsReview, } from './purchases.js';
+export { type BrowserSaleIndex, type BrowserSellerOptions, browserSellerSpool, browserSellerStorage, createBrowserSeller, type SaleHandle, type SaleView, type SellDraft, type SellerConnection, type SellerFacade, type SellProgress, type SellQuote, type SellStep, type SellTerms, } from './selling.js';
+export { type BrowserNearProvider, type BrowserNearTransaction, BrowserWalletError, type BrowserWalletErrorCode, browserEvmWallet, browserNearWallet, browserSolanaWallet, type InjectedEvmProvider, type InjectedSolanaKey, type InjectedSolanaProvider, signNearUpload, } from './wallets.js';

package/dist/browser/index.js

@@ -0,0 +1,22 @@
+export { AnnonError, isTransient, toPublicError, } from '../errors.js';
+/** Browser purchase logic. The embedding application supplies its own screen and wallets. */
+export { Annon, SellError, } from '../api/annon.js';
+export { DownloadError } from '../download/download.js';
+export { UploadClient, uploadText, } from '../download/upload.js';
+export { Pay2Error } from '../envelope/pay2.js';
+export { SourceChangedError } from '../envelope/stream.js';
+export { CkdError } from '../keys/near-ckd.js';
+export { HTTP_RETRY_MAX_WAIT_SECONDS, MAX_PAY2_BYTES, MAX_PLAINTEXT_BYTES } from '../limits.js';
+export { NearError, NearRpcRateLimited } from '../near/rpc.js';
+export { fileFundingText } from '../near/texts.js';
+export { OneClick, OneClickQuoteExpired, OneClickRefused, originFromToken, validateRefundAddress, } from '../oneclick/oneclick.js';
+export { exportSellerKey, importSellerKey, newBackupSecret, } from '../pay/backup.js';
+export { BaseRpcRateLimited, PayError } from '../pay/base.js';
+export { BASE_ELIGIBILITY_MAX_AGE_SECONDS, checkBaseSponsorship, validBaseSponsorship, } from '../relay/capabilities.js';
+export { canonicalManifestUrl, catalog, listShops, } from '../shops/discovery.js';
+export { TransactionUncertain } from '../wallet/uncertain.js';
+export { FileFundingRefused, } from '../wallet/wallet.js';
+export { BROWSER_DOWNLOAD_LIMIT, browserDownload, } from './download.js';
+export { BrowserPurchaseController, browserAnnon, browserPurchaseStorage, PurchaseLeaseBusy, } from './purchases.js';
+export { browserSellerSpool, browserSellerStorage, createBrowserSeller, } from './selling.js';
+export { BrowserWalletError, browserEvmWallet, browserNearWallet, browserSolanaWallet, signNearUpload, } from './wallets.js';