@kkkermit/trading212.js 0.1.0 → 0.1.2

package/dist/csv.cjs

@@ -0,0 +1,54 @@
+'use strict';
+
+// src/csv/index.ts
+function parseCsvRows(text) {
+  const rows = [];
+  let row = [];
+  let field = "";
+  let quoted = false;
+  let index = text.charCodeAt(0) === 65279 ? 1 : 0;
+  for (; index < text.length; index++) {
+    const char = text.charAt(index);
+    if (quoted) {
+      if (char === '"') {
+        if (text[index + 1] === '"') {
+          field += '"';
+          index++;
+        } else quoted = false;
+      } else field += char;
+    } else if (char === '"' && field === "") quoted = true;
+    else if (char === ",") {
+      row.push(field);
+      field = "";
+    } else if (char === "\n" || char === "\r") {
+      if (char === "\r" && text[index + 1] === "\n") index++;
+      row.push(field);
+      rows.push(row);
+      row = [];
+      field = "";
+    } else field += char;
+  }
+  if (field !== "" || row.length > 0) {
+    row.push(field);
+    rows.push(row);
+  }
+  return rows;
+}
+function parseCsv(text) {
+  const [header, ...rows] = parseCsvRows(text);
+  if (!header) return [];
+  return rows.filter((row) => !(row.length === 1 && row[0] === "")).map((row) => Object.fromEntries(header.map((name, column) => [name, row[column] ?? ""])));
+}
+var DECIMAL = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
+var GROUPED = /^[+-]?[1-9]\d{0,2}(?:,\d{3})+(?:\.\d+)?$/;
+function csvNumber(value) {
+  const trimmed = value?.trim() ?? "";
+  const plain = GROUPED.test(trimmed) ? trimmed.replaceAll(",", "") : trimmed;
+  if (!DECIMAL.test(plain)) return void 0;
+  const number = Number(plain);
+  return Number.isFinite(number) ? number : void 0;
+}
+
+exports.csvNumber = csvNumber;
+exports.parseCsv = parseCsv;
+exports.parseCsvRows = parseCsvRows;

package/dist/csv.d.cts

@@ -0,0 +1,21 @@
+/**
+ * A small RFC 4180 CSV parser for Trading 212's report exports: quoted fields, doubled quotes, commas and newlines
+ * inside quotes, CRLF or LF line ends, and a leading byte-order mark. Values stay strings.
+ */
+declare function parseCsvRows(text: string): string[][];
+/**
+ * Parses CSV with a header row into one object per line, keyed by column name.
+ *
+ * @example
+ * import { parseCsv } from "@kkkermit/trading212.js/csv";
+ * const { csv } = await t212.reports.export({ from: "2026-01-01", to: "2026-06-30" });
+ * for (const row of parseCsv(csv)) console.log(row.Action, row.Ticker, row["Total"]);
+ */
+declare function parseCsv(text: string): Record<string, string>[];
+/**
+ * Reads a number from a CSV cell, such as `1234.56`, `1,234.56` or `-0.5`, or returns `undefined` for anything else.
+ * Trading 212 writes decimals with a full stop, so a comma is accepted only between groups of three digits.
+ */
+declare function csvNumber(value: string | undefined): number | undefined;
+
+export { csvNumber, parseCsv, parseCsvRows };

package/dist/csv.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A small RFC 4180 CSV parser for Trading 212's report exports: quoted fields, doubled quotes, commas and newlines
+ * inside quotes, CRLF or LF line ends, and a leading byte-order mark. Values stay strings.
+ */
+declare function parseCsvRows(text: string): string[][];
+/**
+ * Parses CSV with a header row into one object per line, keyed by column name.
+ *
+ * @example
+ * import { parseCsv } from "@kkkermit/trading212.js/csv";
+ * const { csv } = await t212.reports.export({ from: "2026-01-01", to: "2026-06-30" });
+ * for (const row of parseCsv(csv)) console.log(row.Action, row.Ticker, row["Total"]);
+ */
+declare function parseCsv(text: string): Record<string, string>[];
+/**
+ * Reads a number from a CSV cell, such as `1234.56`, `1,234.56` or `-0.5`, or returns `undefined` for anything else.
+ * Trading 212 writes decimals with a full stop, so a comma is accepted only between groups of three digits.
+ */
+declare function csvNumber(value: string | undefined): number | undefined;
+
+export { csvNumber, parseCsv, parseCsvRows };

package/dist/csv.js

@@ -0,0 +1,50 @@
+// src/csv/index.ts
+function parseCsvRows(text) {
+  const rows = [];
+  let row = [];
+  let field = "";
+  let quoted = false;
+  let index = text.charCodeAt(0) === 65279 ? 1 : 0;
+  for (; index < text.length; index++) {
+    const char = text.charAt(index);
+    if (quoted) {
+      if (char === '"') {
+        if (text[index + 1] === '"') {
+          field += '"';
+          index++;
+        } else quoted = false;
+      } else field += char;
+    } else if (char === '"' && field === "") quoted = true;
+    else if (char === ",") {
+      row.push(field);
+      field = "";
+    } else if (char === "\n" || char === "\r") {
+      if (char === "\r" && text[index + 1] === "\n") index++;
+      row.push(field);
+      rows.push(row);
+      row = [];
+      field = "";
+    } else field += char;
+  }
+  if (field !== "" || row.length > 0) {
+    row.push(field);
+    rows.push(row);
+  }
+  return rows;
+}
+function parseCsv(text) {
+  const [header, ...rows] = parseCsvRows(text);
+  if (!header) return [];
+  return rows.filter((row) => !(row.length === 1 && row[0] === "")).map((row) => Object.fromEntries(header.map((name, column) => [name, row[column] ?? ""])));
+}
+var DECIMAL = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
+var GROUPED = /^[+-]?[1-9]\d{0,2}(?:,\d{3})+(?:\.\d+)?$/;
+function csvNumber(value) {
+  const trimmed = value?.trim() ?? "";
+  const plain = GROUPED.test(trimmed) ? trimmed.replaceAll(",", "") : trimmed;
+  if (!DECIMAL.test(plain)) return void 0;
+  const number = Number(plain);
+  return Number.isFinite(number) ? number : void 0;
+}
+
+export { csvNumber, parseCsv, parseCsvRows };

package/dist/index.cjs

@@ -0,0 +1,154 @@
+'use strict';
+
+var chunkK766TWIM_cjs = require('./chunk-K766TWIM.cjs');
+
+
+
+Object.defineProperty(exports, "AuthenticationError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.AuthenticationError; }
+});
+Object.defineProperty(exports, "BASE_URLS", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.BASE_URLS; }
+});
+Object.defineProperty(exports, "ConfigurationError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.ConfigurationError; }
+});
+Object.defineProperty(exports, "ENDPOINTS", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.ENDPOINTS; }
+});
+Object.defineProperty(exports, "FINAL_ORDER_STATUSES", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.FINAL_ORDER_STATUSES; }
+});
+Object.defineProperty(exports, "HttpError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.HttpError; }
+});
+Object.defineProperty(exports, "InstrumentNotFoundError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.InstrumentNotFoundError; }
+});
+Object.defineProperty(exports, "MemoryCache", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.MemoryCache; }
+});
+Object.defineProperty(exports, "MissingScopeError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.MissingScopeError; }
+});
+Object.defineProperty(exports, "NetworkError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.NetworkError; }
+});
+Object.defineProperty(exports, "NotAvailableInDemoError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.NotAvailableInDemoError; }
+});
+Object.defineProperty(exports, "NotFoundError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.NotFoundError; }
+});
+Object.defineProperty(exports, "OrderOutcomeUnknownError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.OrderOutcomeUnknownError; }
+});
+Object.defineProperty(exports, "OrderRejectedError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.OrderRejectedError; }
+});
+Object.defineProperty(exports, "PermissionError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.PermissionError; }
+});
+Object.defineProperty(exports, "QUANTITY_DECIMALS", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.QUANTITY_DECIMALS; }
+});
+Object.defineProperty(exports, "RateLimitError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.RateLimitError; }
+});
+Object.defineProperty(exports, "SPEC_VERSION", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.SPEC_VERSION; }
+});
+Object.defineProperty(exports, "ServerError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.ServerError; }
+});
+Object.defineProperty(exports, "TIME_VALIDITIES", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.TIME_VALIDITIES; }
+});
+Object.defineProperty(exports, "TimeoutError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.TimeoutError; }
+});
+Object.defineProperty(exports, "Trading212", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.Trading212; }
+});
+Object.defineProperty(exports, "Trading212Error", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.Trading212Error; }
+});
+Object.defineProperty(exports, "TradingDisabledError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.TradingDisabledError; }
+});
+Object.defineProperty(exports, "UnexpectedResponseError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.UnexpectedResponseError; }
+});
+Object.defineProperty(exports, "VERSION", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.VERSION; }
+});
+Object.defineProperty(exports, "ValidationError", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.ValidationError; }
+});
+Object.defineProperty(exports, "buildPortfolioSnapshot", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.buildPortfolioSnapshot; }
+});
+Object.defineProperty(exports, "consoleLogger", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.consoleLogger; }
+});
+Object.defineProperty(exports, "decimalPlaces", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.decimalPlaces; }
+});
+Object.defineProperty(exports, "fieldsFirst", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.fieldsFirst; }
+});
+Object.defineProperty(exports, "isTrading212Error", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.isTrading212Error; }
+});
+Object.defineProperty(exports, "isValidQuantity", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.isValidQuantity; }
+});
+Object.defineProperty(exports, "parseErrorBody", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.parseErrorBody; }
+});
+Object.defineProperty(exports, "sessionAt", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.sessionAt; }
+});
+Object.defineProperty(exports, "silentLogger", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.silentLogger; }
+});
+Object.defineProperty(exports, "truncateQuantity", {
+  enumerable: true,
+  get: function () { return chunkK766TWIM_cjs.truncateQuantity; }
+});

package/dist/index.d.cts

@@ -0,0 +1,35 @@
+export { A as AccountBucketDetailedResponse, a as AccountBucketInstrumentResult, b as AccountBucketInstrumentsDetailedResponse, c as AccountBucketResultResponse, d as AccountResource, e as AccountSummary, f as AuthenticationError, B as BASE_URLS, C as CacheStore, g as CallOptions, h as Cash, i as ConfigurationError, j as ConsoleLike, D as Dividend, k as DividendDetails, l as DryRunResult, m as DuplicateBucketRequest, E as ENDPOINTS, n as EndpointBudget, o as EndpointDefinition, p as EndpointId, q as EndpointKind, r as EndpointRateLimit, s as EnqueuedReportResponse, t as EnvSource, u as Environment, v as ErrorCode, w as ErrorDetails, x as Exchange, y as ExchangesResource, z as ExportResult, F as FINAL_ORDER_STATUSES, G as FetchLike, H as FieldsFirstMethod, I as Fill, J as FillWalletImpact, K as HistoricalOrder, L as HistoryDividendItem, M as HistoryResource, N as HistoryTransactionItem, O as HoldingSnapshot, P as Hooks, Q as HttpError, R as HttpMethod, S as Instrument, T as InstrumentIssue, U as InstrumentNotFoundError, V as InstrumentSuggestion, W as InstrumentsResource, X as InvestmentResult, Y as Investments, Z as IterateOptions, _ as LimitOrderRequest, $ as LimitRequest, a0 as ListOptions, a1 as LogFields, a2 as LogLevel, a3 as Logger, a4 as MarketOrderRequest, a5 as MarketRequest, a6 as MarketSession, a7 as MarketStatus, a8 as MemoryCache, a9 as MissingScopeError, aa as NetworkError, ab as NotAvailableInDemoError, ac as NotFoundError, ad as Order, ae as OrderInput, af as OrderOutcomeUnknownError, ag as OrderRejectedError, ah as OrderRejectionReason, ai as OrderTimeValidity, aj as OrderType, ak as OrdersResource, al as Page, am as PageOptions, an as PagedList, ao as PaginatedResponseHistoricalOrder, ap as PaginatedResponseHistoryDividendItem, aq as PaginatedResponseHistoryTransactionItem, ar as PermissionError, as as Pie, at as PieDetails, au as PieInput, av as PieRequest, aw as PiesResource, ax as PlaceOptions, ay as Placed, az as PortfolioResource, aA as PortfolioSnapshot, aB as Position, aC as PositionWalletImpact, aD as PositionsResource, aE as PublicReportRequest, aF as RateLimitError, aG as RateLimitInfo, aH as RateLimitMode, aI as RateLimitWaitEvent, aJ as Report, aK as ReportDataIncluded, aL as ReportRequest, aM as ReportResponse, aN as ReportWaitOptions, aO as ReportsResource, aP as RequestDescription, aQ as RequestEvent, aR as ResolveOptions, aS as ResponseEvent, aT as RetryEvent, aU as RetryOptions, aV as SPEC_VERSION, aW as SearchOptions, aX as SellAllOptions, aY as ServerError, aZ as StopLimitOrderRequest, a_ as StopLimitRequest, a$ as StopOrderRequest, b0 as StopRequest, b1 as TIME_VALIDITIES, b2 as Tax, b3 as TimeEvent, b4 as TimeValidity, b5 as TimeoutError, b6 as TradableInstrument, b7 as Trading212, b8 as Trading212Error, b9 as Trading212Options, ba as TradingDisabledError, bb as Transaction, bc as UnexpectedResponseError, bd as ValidationError, be as ValidationIssue, bf as VerifyResult, bg as WaitOptions, bh as WorkingSchedule, bi as buildPortfolioSnapshot, bj as consoleLogger, bk as fieldsFirst, bl as isTrading212Error, bm as sessionAt, bn as silentLogger } from './client-BSQXqdxj.cjs';
+
+interface ParsedErrorBody {
+    /** Trading 212's own code, from `code`, or the last part of a problem-details `type`. */
+    readonly apiCode?: string;
+    /** The most human sentence the body offered. */
+    readonly message?: string;
+    /** Trading 212's reference for the request, from `traceId`. */
+    readonly traceId?: string;
+    /** The body as parsed JSON, or its text when it was not JSON. */
+    readonly body?: unknown;
+}
+/**
+ * Reads every error body shape Trading 212 is known to send: problem details (`type`, `title`, `detail`, `traceId`),
+ * the older `{ code, errorMessage }` it uses for a 429, `{ code, clarification }`, plain text, and nothing at all.
+ */
+declare function parseErrorBody(text: string): ParsedErrorBody;
+
+/** The most decimal places Trading 212 accepts in an order quantity. Positions can hold more. */
+declare const QUANTITY_DECIMALS = 4;
+/** How many decimal places a number has, as written. */
+declare function decimalPlaces(value: number): number;
+/**
+ * Cuts a quantity to `decimals` places, always towards zero, so selling a whole 12.09032128-share position sends
+ * 12.0903 and never more than you hold. Works on the number's exact text, not floating-point arithmetic.
+ */
+declare function truncateQuantity(value: number, decimals?: number): number;
+/** True when Trading 212 will accept the number as an order quantity: finite, not zero, at most 4 decimal places. */
+declare function isValidQuantity(value: number): boolean;
+
+/** This package's version, replaced at build time. */
+declare const VERSION: string;
+
+export { QUANTITY_DECIMALS, VERSION, decimalPlaces, isValidQuantity, parseErrorBody, truncateQuantity };
+export type { ParsedErrorBody };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+export { A as AccountBucketDetailedResponse, a as AccountBucketInstrumentResult, b as AccountBucketInstrumentsDetailedResponse, c as AccountBucketResultResponse, d as AccountResource, e as AccountSummary, f as AuthenticationError, B as BASE_URLS, C as CacheStore, g as CallOptions, h as Cash, i as ConfigurationError, j as ConsoleLike, D as Dividend, k as DividendDetails, l as DryRunResult, m as DuplicateBucketRequest, E as ENDPOINTS, n as EndpointBudget, o as EndpointDefinition, p as EndpointId, q as EndpointKind, r as EndpointRateLimit, s as EnqueuedReportResponse, t as EnvSource, u as Environment, v as ErrorCode, w as ErrorDetails, x as Exchange, y as ExchangesResource, z as ExportResult, F as FINAL_ORDER_STATUSES, G as FetchLike, H as FieldsFirstMethod, I as Fill, J as FillWalletImpact, K as HistoricalOrder, L as HistoryDividendItem, M as HistoryResource, N as HistoryTransactionItem, O as HoldingSnapshot, P as Hooks, Q as HttpError, R as HttpMethod, S as Instrument, T as InstrumentIssue, U as InstrumentNotFoundError, V as InstrumentSuggestion, W as InstrumentsResource, X as InvestmentResult, Y as Investments, Z as IterateOptions, _ as LimitOrderRequest, $ as LimitRequest, a0 as ListOptions, a1 as LogFields, a2 as LogLevel, a3 as Logger, a4 as MarketOrderRequest, a5 as MarketRequest, a6 as MarketSession, a7 as MarketStatus, a8 as MemoryCache, a9 as MissingScopeError, aa as NetworkError, ab as NotAvailableInDemoError, ac as NotFoundError, ad as Order, ae as OrderInput, af as OrderOutcomeUnknownError, ag as OrderRejectedError, ah as OrderRejectionReason, ai as OrderTimeValidity, aj as OrderType, ak as OrdersResource, al as Page, am as PageOptions, an as PagedList, ao as PaginatedResponseHistoricalOrder, ap as PaginatedResponseHistoryDividendItem, aq as PaginatedResponseHistoryTransactionItem, ar as PermissionError, as as Pie, at as PieDetails, au as PieInput, av as PieRequest, aw as PiesResource, ax as PlaceOptions, ay as Placed, az as PortfolioResource, aA as PortfolioSnapshot, aB as Position, aC as PositionWalletImpact, aD as PositionsResource, aE as PublicReportRequest, aF as RateLimitError, aG as RateLimitInfo, aH as RateLimitMode, aI as RateLimitWaitEvent, aJ as Report, aK as ReportDataIncluded, aL as ReportRequest, aM as ReportResponse, aN as ReportWaitOptions, aO as ReportsResource, aP as RequestDescription, aQ as RequestEvent, aR as ResolveOptions, aS as ResponseEvent, aT as RetryEvent, aU as RetryOptions, aV as SPEC_VERSION, aW as SearchOptions, aX as SellAllOptions, aY as ServerError, aZ as StopLimitOrderRequest, a_ as StopLimitRequest, a$ as StopOrderRequest, b0 as StopRequest, b1 as TIME_VALIDITIES, b2 as Tax, b3 as TimeEvent, b4 as TimeValidity, b5 as TimeoutError, b6 as TradableInstrument, b7 as Trading212, b8 as Trading212Error, b9 as Trading212Options, ba as TradingDisabledError, bb as Transaction, bc as UnexpectedResponseError, bd as ValidationError, be as ValidationIssue, bf as VerifyResult, bg as WaitOptions, bh as WorkingSchedule, bi as buildPortfolioSnapshot, bj as consoleLogger, bk as fieldsFirst, bl as isTrading212Error, bm as sessionAt, bn as silentLogger } from './client-BSQXqdxj.js';
+
+interface ParsedErrorBody {
+    /** Trading 212's own code, from `code`, or the last part of a problem-details `type`. */
+    readonly apiCode?: string;
+    /** The most human sentence the body offered. */
+    readonly message?: string;
+    /** Trading 212's reference for the request, from `traceId`. */
+    readonly traceId?: string;
+    /** The body as parsed JSON, or its text when it was not JSON. */
+    readonly body?: unknown;
+}
+/**
+ * Reads every error body shape Trading 212 is known to send: problem details (`type`, `title`, `detail`, `traceId`),
+ * the older `{ code, errorMessage }` it uses for a 429, `{ code, clarification }`, plain text, and nothing at all.
+ */
+declare function parseErrorBody(text: string): ParsedErrorBody;
+
+/** The most decimal places Trading 212 accepts in an order quantity. Positions can hold more. */
+declare const QUANTITY_DECIMALS = 4;
+/** How many decimal places a number has, as written. */
+declare function decimalPlaces(value: number): number;
+/**
+ * Cuts a quantity to `decimals` places, always towards zero, so selling a whole 12.09032128-share position sends
+ * 12.0903 and never more than you hold. Works on the number's exact text, not floating-point arithmetic.
+ */
+declare function truncateQuantity(value: number, decimals?: number): number;
+/** True when Trading 212 will accept the number as an order quantity: finite, not zero, at most 4 decimal places. */
+declare function isValidQuantity(value: number): boolean;
+
+/** This package's version, replaced at build time. */
+declare const VERSION: string;
+
+export { QUANTITY_DECIMALS, VERSION, decimalPlaces, isValidQuantity, parseErrorBody, truncateQuantity };
+export type { ParsedErrorBody };

package/dist/index.js

@@ -0,0 +1 @@
+export { AuthenticationError, BASE_URLS, ConfigurationError, ENDPOINTS, FINAL_ORDER_STATUSES, HttpError, InstrumentNotFoundError, MemoryCache, MissingScopeError, NetworkError, NotAvailableInDemoError, NotFoundError, OrderOutcomeUnknownError, OrderRejectedError, PermissionError, QUANTITY_DECIMALS, RateLimitError, SPEC_VERSION, ServerError, TIME_VALIDITIES, TimeoutError, Trading212, Trading212Error, TradingDisabledError, UnexpectedResponseError, VERSION, ValidationError, buildPortfolioSnapshot, consoleLogger, decimalPlaces, fieldsFirst, isTrading212Error, isValidQuantity, parseErrorBody, sessionAt, silentLogger, truncateQuantity } from './chunk-AVOYEH6N.js';