@tuppence/node 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,230 @@
+import { HttpClient } from "./http.js";
+import { resources } from "./resources.js";
+import { constructEvent, generateTestHeader } from "./webhooks.js";
+export { AGENT_PROOF_HEADER, signAgentProof } from "./agent-proof.js";
+export * from "./errors.js";
+export { DEFAULT_API_VERSION, VERSION } from "./http.js";
+export * from "./types.js";
+export { constructEvent, DEFAULT_TOLERANCE_SECONDS, SIGNATURE_HEADER } from "./webhooks.js";
+/**
+ * The Tuppence API for Node.js.
+ *
+ *   import { Tuppence } from "@tuppence/node";
+ *   const tuppence = new Tuppence(process.env.TUPPENCE_SECRET_KEY!);
+ *   const link = await tuppence.paymentLinks.create({ name: "Pro plan", amount: 2000, currency: "gbp" });
+ *
+ * Every POST carries an `Idempotency-Key` (yours, or a fresh one reused across this call's
+ * retries), so retries after a timeout never charge twice.
+ */
+export class Tuppence {
+    http;
+    // Kept for `as()`, out of sight: never enumerable, printed or serialised.
+    #apiKey;
+    #options;
+    account;
+    /** Bacs Direct Debit by application: its status, applying, and asking for higher limits. */
+    directDebit;
+    /** Tuppence Connect: your connected accounts, and their people, banks and capabilities. */
+    accounts;
+    accountLinks;
+    files;
+    /** Your fees on your connected accounts' payments, and the refunds of them. */
+    applicationFees;
+    /** Money from your Connect balance to your connected accounts, and its reversals. */
+    transfers;
+    plans;
+    subscriptions;
+    paymentLinks;
+    payments;
+    refunds;
+    customers;
+    balance;
+    payouts;
+    disputes;
+    events;
+    /** Tuppence Events: `ticketing.events`, `.promoCodes`, `.fundsHolds`, `.reports`. */
+    ticketing;
+    ticketTypes;
+    ticketOrders;
+    tickets;
+    webhookEndpoints;
+    paymentMethodDomains;
+    meters;
+    credits;
+    meterEvents;
+    agents;
+    cardholders;
+    spendPolicies;
+    cards;
+    cardAuthorizations;
+    cardTransactions;
+    /** Disputing a card purchase: a draft, its evidence and files, then submitted by a person. */
+    cardDisputes;
+    /**
+     * The cards' own balance and its top-ups — `issuing.balance`, `issuing.topups`,
+     * `issuing.fundingInstructions` — and Issuing's limits for the account's tier (`issuing.limits`).
+     */
+    issuing;
+    /** TEST MODE only: `testHelpers.issuing.topups.arrive(id)`. */
+    testHelpers;
+    approvals;
+    locations;
+    countryPacks;
+    serviceCategories;
+    services;
+    staff;
+    scheduleExceptions;
+    resources;
+    bookingPolicy;
+    bookingPage;
+    availability;
+    bookings;
+    classSessions;
+    bookingSeries;
+    waitlist;
+    // The store (94-02).
+    reviews;
+    changeSets;
+    storeImports;
+    assistantJobs;
+    channelReports;
+    storeBriefs;
+    sites;
+    store;
+    fulfilments;
+    returns;
+    shippingManifests;
+    carrierPickups;
+    postage;
+    carrierAccounts;
+    shippingProfiles;
+    shippingPackages;
+    shippingServices;
+    media;
+    digitalAssets;
+    imageStudio;
+    collections;
+    drops;
+    products;
+    orders;
+    sitePolicies;
+    storePrivacyRequests;
+    recommendationRules;
+    subscriptionOffers;
+    storeCampaigns;
+    storeFlows;
+    salesChannels;
+    listings;
+    storeThreads;
+    merchantSendingDomains;
+    webhooks = { constructEvent, generateTestHeader };
+    constructor(apiKey, options = {}) {
+        this.http = new HttpClient(apiKey, options);
+        this.#apiKey = apiKey;
+        this.#options = options;
+        const r = resources(this.http);
+        this.account = r.account;
+        this.directDebit = r.directDebit;
+        this.accounts = r.accounts;
+        this.accountLinks = r.accountLinks;
+        this.files = r.files;
+        this.applicationFees = r.applicationFees;
+        this.transfers = r.transfers;
+        this.plans = r.plans;
+        this.subscriptions = r.subscriptions;
+        this.paymentLinks = r.paymentLinks;
+        this.payments = r.payments;
+        this.refunds = r.refunds;
+        this.customers = r.customers;
+        this.balance = r.balance;
+        this.payouts = r.payouts;
+        this.disputes = r.disputes;
+        this.events = r.events;
+        this.ticketing = r.ticketing;
+        this.ticketTypes = r.ticketTypes;
+        this.ticketOrders = r.ticketOrders;
+        this.tickets = r.tickets;
+        this.webhookEndpoints = r.webhookEndpoints;
+        this.paymentMethodDomains = r.paymentMethodDomains;
+        this.meters = r.meters;
+        this.credits = r.credits;
+        this.meterEvents = r.meterEvents;
+        this.agents = r.agents;
+        this.cardholders = r.cardholders;
+        this.spendPolicies = r.spendPolicies;
+        this.cards = r.cards;
+        this.cardAuthorizations = r.cardAuthorizations;
+        this.cardTransactions = r.cardTransactions;
+        this.cardDisputes = r.cardDisputes;
+        this.issuing = r.issuing;
+        this.testHelpers = r.testHelpers;
+        this.approvals = r.approvals;
+        this.locations = r.locations;
+        this.countryPacks = r.countryPacks;
+        this.serviceCategories = r.serviceCategories;
+        this.services = r.services;
+        this.staff = r.staff;
+        this.scheduleExceptions = r.scheduleExceptions;
+        this.resources = r.resources;
+        this.bookingPolicy = r.bookingPolicy;
+        this.bookingPage = r.bookingPage;
+        this.availability = r.availability;
+        this.bookings = r.bookings;
+        this.classSessions = r.classSessions;
+        this.bookingSeries = r.bookingSeries;
+        this.waitlist = r.waitlist;
+        this.reviews = r.reviews;
+        this.changeSets = r.changeSets;
+        this.storeImports = r.storeImports;
+        this.assistantJobs = r.assistantJobs;
+        this.channelReports = r.channelReports;
+        this.storeBriefs = r.storeBriefs;
+        this.sites = r.sites;
+        this.store = r.store;
+        this.fulfilments = r.fulfilments;
+        this.returns = r.returns;
+        this.shippingManifests = r.shippingManifests;
+        this.carrierPickups = r.carrierPickups;
+        this.postage = r.postage;
+        this.carrierAccounts = r.carrierAccounts;
+        this.shippingProfiles = r.shippingProfiles;
+        this.shippingPackages = r.shippingPackages;
+        this.shippingServices = r.shippingServices;
+        this.media = r.media;
+        this.digitalAssets = r.digitalAssets;
+        this.imageStudio = r.imageStudio;
+        this.collections = r.collections;
+        this.drops = r.drops;
+        this.products = r.products;
+        this.orders = r.orders;
+        this.sitePolicies = r.sitePolicies;
+        this.storePrivacyRequests = r.storePrivacyRequests;
+        this.recommendationRules = r.recommendationRules;
+        this.subscriptionOffers = r.subscriptionOffers;
+        this.storeCampaigns = r.storeCampaigns;
+        this.storeFlows = r.storeFlows;
+        this.salesChannels = r.salesChannels;
+        this.listings = r.listings;
+        this.storeThreads = r.storeThreads;
+        this.merchantSendingDomains = r.merchantSendingDomains;
+    }
+    /**
+     * Tuppence Connect: a client that acts as one of your connected accounts on every request —
+     * the `Tuppence-Account` header, with your key. A NEW client: this one is unchanged, so one
+     * shared client can serve every account. A request's own `tuppenceAccount` still wins.
+     *
+     *   const bella = tuppence.as("acct_…");
+     *   await bella.bookings.create({ … });
+     */
+    as(accountId) {
+        if (!accountId || typeof accountId !== "string") {
+            throw new TypeError('tuppence.as(accountId): a connected account id ("acct_…") is required.');
+        }
+        return new Tuppence(this.#apiKey, { ...this.#options, tuppenceAccount: accountId });
+    }
+    /** Any endpoint the SDK has no method for yet — same auth, retries and idempotency. */
+    request(method, path, options = {}) {
+        return this.http.request(method, path, options);
+    }
+}
+export default Tuppence;