@temboplus/afloat 0.2.1-beta.8 → 0.2.1

package/dist/modules/wallet/wallet.timezone.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Timezone helpers for the wallet statement flow.
+ *
+ * The statement endpoint accepts `YYYY-MM-DD` bounds and evaluates them
+ * against the EAT-anchored (UTC+3) database. To support a caller who
+ * wants "transactions whose `valueDate` falls on these calendar days in
+ * timezone `tz`", we:
+ *
+ *   1. Widen the EAT request by ±1 day, so the upstream window
+ *      definitely contains every instant the caller cares about. ±1 is
+ *      mathematically sufficient because the maximum delta from EAT
+ *      (UTC+3) to any timezone on earth is 15 hours, comfortably under
+ *      24h.
+ *   2. After the response comes back, filter entries by `valueDate`
+ *      rendered in the caller's zone, comparing as plain `YYYY-MM-DD`
+ *      strings (which is correct because string-comparing two ISO
+ *      calendar dates is equivalent to comparing the dates).
+ *
+ * The server's filter is on `valueDate` (verified empirically), so the
+ * client-side filter uses the same field — no risk of dropping records
+ * that were padded in.
+ */
+import type { PlainDate } from "./wallet.dtos.js";
+/** IANA id for EAT. The SDK short-circuits all timezone work for this. */
+export declare const EAT_TIMEZONE = "Africa/Nairobi";
+/**
+ * Add or subtract whole calendar days from a `YYYY-MM-DD` string.
+ * Pure string-in/string-out, no dependency on the JS runtime's local
+ * timezone — we pin to UTC noon so DST cliffs and ±1s rounding can't
+ * tip the result onto an adjacent day.
+ *
+ * @example
+ * shiftPlainDate("2026-05-15", 1);   // → "2026-05-16"
+ * shiftPlainDate("2026-05-15", -1);  // → "2026-05-14"
+ * shiftPlainDate("2026-05-31", 1);   // → "2026-06-01"   (month wrap)
+ * shiftPlainDate("2026-01-01", -1);  // → "2025-12-31"   (year wrap)
+ * shiftPlainDate("2026-03-08", 1);   // → "2026-03-09"   (DST-safe; US "spring forward" day)
+ */
+export declare function shiftPlainDate(date: PlainDate, days: number): PlainDate;
+/**
+ * Pad an EAT date range by ±1 day on each side. Used to ensure that an
+ * upstream EAT-anchored query returns every transaction that falls on
+ * the caller's local-zone window, regardless of timezone offset.
+ *
+ * @example
+ * padEatRange({ startDate: "2026-05-15", endDate: "2026-05-16" });
+ * // → { startDate: "2026-05-14", endDate: "2026-05-17" }
+ *
+ * padEatRange({ startDate: "2026-01-01", endDate: "2026-12-31" });
+ * // → { startDate: "2025-12-31", endDate: "2027-01-01" }   (year wraps on both ends)
+ */
+export declare function padEatRange(range: {
+    startDate: PlainDate;
+    endDate: PlainDate;
+}): {
+    startDate: PlainDate;
+    endDate: PlainDate;
+};
+/**
+ * Format an absolute instant as a `YYYY-MM-DD` string in the given
+ * IANA timezone. Uses `en-CA` locale because that's the one major
+ * locale whose default date format is already ISO-like — no need to
+ * stitch parts back together by hand.
+ *
+ * @example
+ * // A transaction's valueDate from the API ("+03:00" is EAT)
+ * const instant = new Date("2026-05-15T01:30:00+03:00");
+ *
+ * localDateInZone(instant, "Africa/Nairobi");    // → "2026-05-15"
+ * localDateInZone(instant, "UTC");               // → "2026-05-14" (22:30 prev day in UTC)
+ * localDateInZone(instant, "America/New_York");  // → "2026-05-14" (18:30 prev day in NY)
+ * localDateInZone(instant, "Pacific/Auckland");  // → "2026-05-15" (10:30 same day in NZ)
+ */
+export declare function localDateInZone(instant: Date, timezone: string): PlainDate;
+/**
+ * True when the caller's selected timezone is effectively EAT. Used to
+ * short-circuit padding + post-filtering so existing EAT callers see
+ * byte-identical behavior.
+ *
+ * @example
+ * isEatTimezone(undefined);          // → true   (no zone = legacy EAT behavior)
+ * isEatTimezone("Africa/Nairobi");   // → true   (canonical EAT id)
+ * isEatTimezone("UTC");              // → false
+ * isEatTimezone("America/New_York"); // → false
+ */
+export declare function isEatTimezone(timezone: string | undefined): boolean;
+//# sourceMappingURL=wallet.timezone.d.ts.map

package/dist/modules/wallet/wallet.timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.timezone.d.ts","sourceRoot":"","sources":["../../../src/modules/wallet/wallet.timezone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,0EAA0E;AAC1E,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAUvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,SAAS,CAAA;CAAE,GAAG;IAChF,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;CACpB,CAKA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAQ1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE"}

package/dist/modules/wallet/wallet.utils.d.ts

@@ -1,5 +1,5 @@
-import { CountryCode } from "@temboplus/frontend-core";
-import { Wallet } from "./wallet.model.js";
+import type { CountryCode } from "@temboplus/frontend-core";
+import type { Wallet } from "./wallet.model.js";
 export declare const WalletUtils: {
     /**
      * Gets unique countries from a list of wallets
@@ -15,3 +15,4 @@ export declare const WalletUtils: {
      */
     getWalletsByCountry(wallets: Wallet[], countryCode: CountryCode): Wallet[];
 };
+//# sourceMappingURL=wallet.utils.d.ts.map

package/dist/modules/wallet/wallet.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.utils.d.ts","sourceRoot":"","sources":["../../../src/modules/wallet/wallet.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,eAAO,MAAM,WAAW;IACtB;;;;OAIG;gCACyB,MAAM,EAAE,GAAG,WAAW,EAAE;IAUpD;;;;;OAKG;iCAC0B,MAAM,EAAE,eAAe,WAAW,GAAG,MAAM,EAAE;CAG3E,CAAC"}

package/package.json

@@ -1,62 +1,73 @@
 {
   "name": "@temboplus/afloat",
-  "version": "0.2.1-beta.8",
+  "version": "0.2.1",
   "description": "A foundational library for Temboplus-Afloat projects.",
+  "author": "Okello Gerald",
+  "license": "MIT",
+  "keywords": [
+    "temboplus",
+    "afloat"
+  ],
+  "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",
-  "type": "module",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.esm.js",
-      "require": "./dist/index.cjs.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs.js"
     }
   },
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=20",
+    "bun": ">=1.1"
+  },
   "scripts": {
-    "build": "rollup -c rollup.config.js",
-    "prepare": "npm run build",
-    "dev": "npm run build -- --watch",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "dev": "bun x rollup -c rollup.config.js --watch",
+    "build": "bun x rollup -c rollup.config.js",
+    "test": "bun test --pass-with-no-tests",
+    "lint": "bun x @biomejs/biome check src",
+    "format": "bun x @biomejs/biome check --write src",
+    "typecheck": "bun x tsc --noEmit",
+    "release": "echo 'Releases are tag-driven. Update CHANGELOG.md, bump version in package.json, then: git tag vX.Y.Z && git push origin main --tags'",
+    "prepublishOnly": "bun run typecheck && bun run test && bun run build"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/TemboPlus-Frontend/afloat-js.git"
+    "url": "git+https://github.com/TemboPlus-Frontend/temboplus-afloat.git"
   },
-  "keywords": [
-    "temboplus",
-    "afloat"
-  ],
-  "author": "Okello Gerald",
-  "license": "MIT",
   "bugs": {
-    "url": "https://github.com/TemboPlus-Frontend/afloat-js/issues"
+    "url": "https://github.com/TemboPlus-Frontend/temboplus-afloat/issues"
+  },
+  "homepage": "https://github.com/TemboPlus-Frontend/temboplus-afloat#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@temboplus/frontend-core": "^1.0.3"
   },
-  "homepage": "https://github.com/TemboPlus-Frontend/afloat-js#readme",
   "peerDependencies": {
-    "@ts-rest/core": "^3.52.1",
+    "@ts-rest/core": "^3.53.0-rc.1",
     "tslib": "^2.8.1",
-    "uuid": "^11.1.0",
-    "zod": "^3.24.2"
+    "uuid": "^14.0.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
     "@rollup/plugin-alias": "^6.0.0",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-terser": "^1.0.0",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/jest": "^30.0.0",
-    "jest": "^30.2.0",
+    "@types/bun": "^1.3.14",
     "rollup": "^4.53.3",
-    "ts-jest": "^29.4.6",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "@temboplus/frontend-core": "^1.0.2"
+    "typescript": "^6.0.3"
   }
 }