@onlyworlds/sdk 4.42.1 → 4.42.3

package/CHANGELOG.md

@@ -5,6 +5,20 @@ earlier history lives in git log only.
 
 ## [Unreleased]
 
+## [4.42.3] - 2026-10-21
+
+### Fixed
+- **`parseDate` reads a down era's dates back to the step they were written from, with a mid-year pivot too.** 4.42.2 moved the display count to the year holding the step before the pivot, and the parse kept the old count, so with a mid-year pivot every date before it parsed back one year early ("6 Frost, 4 BG" read 20 steps early on a 20-step year). Year-boundary pivots were never affected. Found by Quillon porting 4.42.2 to the Unity SDK and confirmed on this kernel by Temper (OW Council h58 #8962, #9111); a round-trip test now holds every step on both sides of the pivot.
+- `redeemJoin`'s doc names a full world's refusal as 422 `world_full` (`isWorldFull`), as keel answers since the party link; it said `invalid_request` (Quillon, OW Keel h29 #9038).
+
+## [4.42.2] - 2026-10-20
+
+Two calendar reading fixes, found writing the `atlas_calendar` profile's conformance fixture (OW Council h58 #8943, #8946).
+
+### Fixed
+- **A down era has no year zero, even when its pivot falls mid-year.** Its year is now counted from the year holding the step just before the pivot, which reads `year_base` (1 by default). With the pivot mid-year, the earlier steps of the pivot's own year read year 0 ("0 BG") and every year before it one lower; with the pivot on a year's first step, nothing changes. The mirror of an up era, whose first partial year is year 1.
+- **Equal-start eras resolve by a stated rule:** an up era over a down one, then the later era in the list. The comparator returned `-1` for any pair led by an up era, so two eras of one direction came out in the sort's order rather than the list's.
+
 ## [4.42.1] - 2026-10-20
 
 The calendar reader refuses what the `atlas_calendar` profile refuses (schema-dist `profiles/calendar.md`; Quillon's Unity read, OW Council h58 #8917).

package/dist/index.d.ts

@@ -3278,7 +3278,7 @@ declare class OwV2Client {
      * deleted since, or none sent, is 422 `invalid_request`, param `character`
      * (`err.isCharacterInvalid`; read the preview again). With no list
      * (`name_required`), send `name` and no `character`: the player's fresh Character takes the
-     * name (missing: 422, param `name`). A world with its 50 players is 422 `invalid_request`;
+     * name (missing: 422, param `name`). A world with its 50 players is 422 `world_full` (`err.isWorldFull`);
      * the last place taken by someone else first is the one 404. A refusal spends nothing. A link
      * for one ignores `character`.
      */
@@ -3999,7 +3999,12 @@ interface EraDomain {
     hi: number;
 }
 declare function resolveEraDomains(eras: CalendarEra[]): EraDomain[];
-/** The era owning a step: domain containment; wild overlaps resolve to latest start (up wins ties). */
+/**
+ * The era owning a step: domain containment; overlaps resolve to the latest start, then an
+ * up era over a down one, then the later era in the list (the profile, calendar.md). The
+ * comparator was `up ? -1 : 1` before 4.42.2: inconsistent for two eras of one direction,
+ * so their order was the sort's, not the list's.
+ */
 declare function eraForStep(cfg: CalendarConfig, step: number): CalendarEra | null;
 /** The display year for a step under an era (or the absolute year without one). */
 declare function displayYear(cfg: CalendarConfig, step: number, era: CalendarEra | null): number;

package/dist/index.js

@@ -843,7 +843,7 @@ var OwV2Client = class {
    * deleted since, or none sent, is 422 `invalid_request`, param `character`
    * (`err.isCharacterInvalid`; read the preview again). With no list
    * (`name_required`), send `name` and no `character`: the player's fresh Character takes the
-   * name (missing: 422, param `name`). A world with its 50 players is 422 `invalid_request`;
+   * name (missing: 422, param `name`). A world with its 50 players is 422 `world_full` (`err.isWorldFull`);
    * the last place taken by someone else first is the one 404. A refusal spends nothing. A link
    * for one ignores `character`.
    */
@@ -3078,7 +3078,9 @@ function eraForStep(cfg, step) {
   if (eras.length === 0) return null;
   const holding = resolveEraDomains(eras).filter((d) => step >= d.lo && step < d.hi);
   if (holding.length === 0) return null;
-  holding.sort((a, b) => b.era.start - a.era.start || ((a.era.direction ?? "up") === "up" ? -1 : 1));
+  const place = new Map(eras.map((e, i) => [e, i]));
+  const down = (e) => (e.direction ?? "up") === "down" ? 1 : 0;
+  holding.sort((a, b) => b.era.start - a.era.start || down(a.era) - down(b.era) || (place.get(b.era) ?? 0) - (place.get(a.era) ?? 0));
   return holding[0].era;
 }
 function displayYear(cfg, step, era) {
@@ -3086,7 +3088,7 @@ function displayYear(cfg, step, era) {
   if (!era || era.restart === false) return abs;
   const base = era.year_base ?? 1;
   if ((era.direction ?? "up") === "down") {
-    return absoluteYear(cfg, era.start) - abs + base - 1;
+    return absoluteYear(cfg, era.start - 1) - abs + base;
   }
   return abs - absoluteYear(cfg, era.start) + base;
 }
@@ -3236,7 +3238,7 @@ function formatMidLabel(cfg, step) {
 function absYearForEraYear(cfg, era, Y) {
   if (era.restart === false) return Y;
   const base = era.year_base ?? 1;
-  if ((era.direction ?? "up") === "down") return absoluteYear(cfg, era.start) - (Y - base + 1);
+  if ((era.direction ?? "up") === "down") return absoluteYear(cfg, era.start - 1) - (Y - base);
   return absoluteYear(cfg, era.start) + (Y - base);
 }
 function defaultEra(cfg, now) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlyworlds/sdk",
-  "version": "4.42.1",
+  "version": "4.42.3",
   "description": "TypeScript SDK for the OnlyWorlds API - build world-building applications with type safety",
   "type": "module",
   "exports": {