@defdone/annon 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/node/shell/welcome.js

@@ -0,0 +1,39 @@
+/** The session's opening lines. Read-only: no prompt, no network, no secret, nothing written. */
+import { join } from 'node:path';
+import { fileStore } from '../../pay/store-node.js';
+import { agentPolicy } from '../agent.js';
+import { loadConfig, trustId } from '../config.js';
+import { cleanText, networkName } from '../output/text.js';
+import { version } from '../version.js';
+const probe = { command: 'shops' };
+/**
+ * A session needs a person at a terminal. Pipes, agent mode and a config that cannot say whether
+ * it is an agent config all keep the one-shot behavior.
+ */
+export async function sessionAllowed(argv, terminal, env) {
+    if (!terminal || !(argv.length === 0 || (argv.length === 1 && argv[0] === 'shell')))
+        return false;
+    try {
+        return !(await agentPolicy(probe, env));
+    }
+    catch {
+        return false;
+    }
+}
+/** Human text only for a person at a terminal outside agent mode. */
+export const humanOutput = async (terminal, env) => terminal &&
+    (await agentPolicy(probe, env).then((agent) => !agent, () => false));
+export async function welcome(env) {
+    const lines = [`Annon ${version}`];
+    try {
+        const c = await loadConfig({ command: 'login' }, env, true);
+        const trusted = c.trustContract === true ||
+            (await fileStore(join(c.stateDir, 'trust')).load(trustId(c))) !== null;
+        lines.push(`Network: ${networkName(c.network)}`, `Account: ${c.signer ? cleanText(c.signer.identity.id) : 'not signed in (run login)'}`, `Contract: ${c.contractId ? `${c.contractId} (${trusted ? 'trusted' : 'not trusted yet'})` : 'not configured'}`);
+    }
+    catch {
+        lines.push('Config: could not be read. Run a command to see why.');
+    }
+    lines.push('Type help for commands, exit to leave. Tab completes.');
+    return lines.join('\n');
+}

package/dist/node/shell/words.d.ts

@@ -0,0 +1 @@
+export declare function splitWords(line: string): string[];

package/dist/node/shell/words.js

@@ -0,0 +1,36 @@
+/** Splits a session line into arguments: spaces separate, quotes and backslashes keep them. */
+import { AdapterError } from '../errors.js';
+export function splitWords(line) {
+    const words = [];
+    let word;
+    let quote;
+    for (let i = 0; i < line.length; i++) {
+        const ch = line.charAt(i);
+        if (quote) {
+            if (ch === quote)
+                quote = undefined;
+            else if (ch === '\\' && quote === '"' && i + 1 < line.length)
+                word += line.charAt(++i);
+            else
+                word += ch;
+        }
+        else if (ch === '"' || ch === "'") {
+            quote = ch;
+            word ??= '';
+        }
+        else if (ch === '\\' && i + 1 < line.length)
+            word = (word ?? '') + line.charAt(++i);
+        else if (/\s/.test(ch)) {
+            if (word !== undefined)
+                words.push(word);
+            word = undefined;
+        }
+        else
+            word = (word ?? '') + ch;
+    }
+    if (quote)
+        throw new AdapterError('invalid_arguments', 'A quote is not closed.', 2);
+    if (word !== undefined)
+        words.push(word);
+    return words;
+}

package/dist/node/shops.d.ts

@@ -15,3 +15,8 @@ export declare function selectedShopRules(config: DiscoveryConfig, id: string |
     };
     rules: import("../shops/discovery.js").ShopRules;
 }>;
+/**
+ * `buy <row>`: the resource URL of that row in the listing `catalog` prints for the same `--shop`
+ * and `--search`. The buy then checks the file and its terms as for a URL typed by hand.
+ */
+export declare function catalogRow(input: Input, env: Environment, notify: ((message: string) => void) | undefined, fetcher?: typeof fetch): Promise<Input>;

package/dist/node/shops.js

@@ -4,6 +4,8 @@ import { dirname } from 'node:path';
 import { AnnonError } from '../errors.js';
 import { canonicalManifestUrl, catalog, listShops, readShop, validateDiscoveryConfig, } from '../shops/discovery.js';
 import { configPath } from './agent.js';
+import { AdapterError } from './errors.js';
+import { cleanText } from './output/text.js';
 export const isDiscovery = (input) => ['shops', 'shop', 'catalog'].includes(input.command);
 async function readConfig(path) {
     try {
@@ -72,3 +74,23 @@ export async function selectedShopRules(config, id, fetcher) {
         ? { shop: { manifest: shop.manifest, name: shop.info.name }, rules: shop.info.rules }
         : {};
 }
+/**
+ * `buy <row>`: the resource URL of that row in the listing `catalog` prints for the same `--shop`
+ * and `--search`. The buy then checks the file and its terms as for a URL typed by hand.
+ */
+export async function catalogRow(input, env, notify, fetcher = globalThis.fetch) {
+    const row = Number(input.target);
+    const config = validateDiscoveryConfig(await readConfig(configPath(input, env)));
+    const listing = await catalog(config, {
+        offset: row - 1,
+        limit: 1,
+        ...(input.search !== undefined ? { search: input.search } : {}),
+        ...(input.shop !== undefined ? { shop: input.shop } : {}),
+    }, fetcher);
+    const [entry] = listing.items;
+    if (!entry)
+        throw new AdapterError('invalid_arguments', `The catalog has no row ${row}. Run annon catalog to list the rows.`, 2);
+    notify?.(`Row ${row}: ${cleanText(entry.title)} (${entry.url})`);
+    const { shop: _shop, search: _search, ...rest } = input;
+    return { ...rest, target: entry.url };
+}

package/dist/node/version.d.ts

@@ -0,0 +1 @@
+export declare const version: string;

package/dist/node/version.js

@@ -0,0 +1,3 @@
+/** The installed package version; package.json sits two levels above both src/node and dist/node. */
+import { createRequire } from 'node:module';
+export const { version } = createRequire(import.meta.url)('../../package.json');

package/dist/node/wallets.d.ts

@@ -3,11 +3,11 @@ import type { SplitCall } from '../pay/split.js';
 import { type IdentityWallet } from '../wallet/wallet.js';
 import type { Input } from './cli.js';
 import { type Keychain } from './keychain.js';
+export { readBackupSecret } from './backup-secret.js';
 export type Environment = Record<string, string | undefined>;
 export type LocalWallet = IdentityWallet & {
     signUpload?: (intent: UploadIntent) => Promise<UploadAuth>;
     sendBase?: (call: SplitCall, rpc: string) => Promise<void>;
 };
 export declare function identity(value: string): import("../settle-near/identity.js").Identity;
-export declare function readBackupSecret(o: Partial<Input>, env: Environment): Promise<Uint8Array>;
 export declare function loadWallet(o: Partial<Input>, env: Environment, nearRpc: string, keychain?: Keychain): Promise<LocalWallet>;

package/dist/node/wallets.js

@@ -7,11 +7,12 @@ import { privateKeyToAccount } from 'viem/accounts';
 import { base } from 'viem/chains';
 import { signNearUpload } from '../browser/wallets.js';
 import { nep413Hash } from '../near/nep413.js';
-import { bytes, hex } from '../settle-near/codec.js';
+import { hex } from '../settle-near/codec.js';
 import { identityJson, parseIdentity } from '../settle-near/identity.js';
 import { nearKeyPairWallet } from '../wallet/wallet.js';
 import { AdapterError } from './errors.js';
 import { decodeKeychain, osKeychain } from './keychain.js';
+export { readBackupSecret } from './backup-secret.js';
 const credentialsError = () => new AdapterError('credentials_required', 'Select a wallet and provide its key through the documented environment variable or a named key file. Check the recovery identity matches.', 2);
 export function identity(value) {
     const at = value.indexOf(':');
@@ -24,15 +25,6 @@ async function source(file, env) {
         return env.trim();
     throw credentialsError();
 }
-export async function readBackupSecret(o, env) {
-    try {
-        const text = await source(o.backupSecretFile ?? env.ANNON_BACKUP_SECRET_FILE, env.ANNON_BACKUP_SECRET);
-        return bytes(text.startsWith('0x') ? text : `0x${text}`, 32);
-    }
-    catch {
-        throw new AdapterError('backup_secret_required', 'Provide a 32-byte random backup secret as 64 hex characters in ANNON_BACKUP_SECRET or a named backup secret file.', 2);
-    }
-}
 export async function loadWallet(o, env, nearRpc, keychain = osKeychain) {
     try {
         const selected = o.wallet ?? (o.recovery ? identity(o.recovery).kind : env.ANNON_WALLET);

package/dist/pay/purchase.d.ts

@@ -76,9 +76,10 @@ export interface PurchaseRecord extends Versioned {
     recoveryProved: boolean;
     /** Source details are the reviewed 1Click quote. */
     payment: PaymentSummary;
+    /** A NEAR send that may be on chain; `txHash` only when the wallet returned one. */
     nearSubmission?: {
         state: 'uncertain';
-        txHash: string;
+        txHash?: string;
     };
     paymentState?: 'expired' | 'canceled';
     purchase: Purchase;

package/dist/wallet/uncertain.d.ts

@@ -1,8 +1,11 @@
 import { AnnonError } from '../errors.js';
-/** Public evidence to retain whenever a submitted NEAR transaction cannot be confirmed. */
+/**
+ * Public evidence to retain whenever a submitted NEAR transaction cannot be confirmed. `txHash` is
+ * absent when a wallet may have broadcast but never returned a hash: unknown, never invented.
+ */
 export declare class TransactionUncertain extends AnnonError {
-    readonly txHash: string;
+    readonly txHash: string | undefined;
     readonly purchaseId?: string | undefined;
     readonly code = "transaction_uncertain";
-    constructor(txHash: string, purchaseId?: string | undefined);
+    constructor(txHash: string | undefined, purchaseId?: string | undefined);
 }

package/dist/wallet/uncertain.js

@@ -1,5 +1,8 @@
 import { AnnonError } from '../errors.js';
-/** Public evidence to retain whenever a submitted NEAR transaction cannot be confirmed. */
+/**
+ * Public evidence to retain whenever a submitted NEAR transaction cannot be confirmed. `txHash` is
+ * absent when a wallet may have broadcast but never returned a hash: unknown, never invented.
+ */
 export class TransactionUncertain extends AnnonError {
     txHash;
     purchaseId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defdone/annon",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "Files only the buyer can open: encrypted on the client, the key released by NEAR once the payment is verified.",
   "license": "Apache-2.0",
   "homepage": "https://annon.dev",