@nextera.one/tps-standard 0.5.3 → 0.5.34

package/dist/utils/calendar.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Shared Calendar Math Utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gregorianToJdn = gregorianToJdn;
+exports.jdnToGregorian = jdnToGregorian;
+exports.julianToJdn = julianToJdn;
+exports.jdnToJulian = jdnToJulian;
+exports.persianToJdn = persianToJdn;
+exports.jdnToPersian = jdnToPersian;
+exports.gregorianToHijri = gregorianToHijri;
+exports.hijriToGregorian = hijriToGregorian;
+/**
+ * Gregorian -> Julian Day Number
+ */
+function gregorianToJdn(gy, gm, gd) {
+    const a = Math.floor((14 - gm) / 12);
+    const y = gy + 4800 - a;
+    const m = gm + 12 * a - 3;
+    return (gd +
+        Math.floor((153 * m + 2) / 5) +
+        365 * y +
+        Math.floor(y / 4) -
+        Math.floor(y / 100) +
+        Math.floor(y / 400) -
+        32045);
+}
+/**
+ * Julian Day Number -> Gregorian
+ */
+function jdnToGregorian(jdn) {
+    const a = jdn + 32044;
+    const b = Math.floor((4 * a + 3) / 146097);
+    const c = a - Math.floor((146097 * b) / 4);
+    const d = Math.floor((4 * c + 3) / 1461);
+    const e = c - Math.floor((1461 * d) / 4);
+    const m = Math.floor((5 * e + 2) / 153);
+    const gd = e - Math.floor((153 * m + 2) / 5) + 1;
+    const gm = m + 3 - 12 * Math.floor(m / 10);
+    const gy = 100 * b + d - 4800 + Math.floor(m / 10);
+    return { gy, gm, gd };
+}
+/**
+ * Julian -> Julian Day Number
+ */
+function julianToJdn(jy, jm, jd) {
+    const a = Math.floor((14 - jm) / 12);
+    const y = jy + 4800 - a;
+    const m = jm + 12 * a - 3;
+    return (jd + Math.floor((153 * m + 2) / 5) + 365 * y + Math.floor(y / 4) - 32083);
+}
+/**
+ * Julian Day Number -> Julian
+ */
+function jdnToJulian(jdn) {
+    const c = jdn + 32082;
+    const d = Math.floor((4 * c + 3) / 1461);
+    const e = c - Math.floor((1461 * d) / 4);
+    const m = Math.floor((5 * e + 2) / 153);
+    const jd = e - Math.floor((153 * m + 2) / 5) + 1;
+    const jm = m + 3 - 12 * Math.floor(m / 10);
+    const jy = d - 4800 + Math.floor(m / 10);
+    return { jy, jm, jd };
+}
+/**
+ * Persian -> Julian Day Number
+ */
+function persianToJdn(jy, jm, jd) {
+    const EPOCH = 1948320;
+    const epbase = jy - (jy >= 0 ? 474 : 473);
+    const epyear = 474 + (epbase % 2820);
+    return (jd +
+        (jm <= 7 ? (jm - 1) * 31 : (jm - 1) * 30 + 6) +
+        Math.floor((epyear * 682 - 110) / 2816) +
+        (epyear - 1) * 365 +
+        Math.floor(epbase / 2820) * 1029983 +
+        EPOCH -
+        1);
+}
+/**
+ * Julian Day Number -> Persian
+ */
+function jdnToPersian(jdn) {
+    const depoch = jdn - persianToJdn(475, 1, 1);
+    const cycle = Math.floor(depoch / 1029983);
+    const cyear = depoch % 1029983;
+    let ycycle;
+    if (cyear === 1029982) {
+        ycycle = 2820;
+    }
+    else {
+        const aux1 = Math.floor(cyear / 366);
+        const aux2 = cyear % 366;
+        ycycle =
+            Math.floor((2134 * aux1 + 2816 * aux2 + 2815) / 1028522) + aux1 + 1;
+    }
+    const jy = ycycle + 2820 * cycle + 474;
+    const yday = jdn - persianToJdn(jy, 1, 1) + 1;
+    const jm = yday <= 186 ? Math.ceil(yday / 31) : Math.ceil((yday - 6) / 30);
+    const jd = jdn - persianToJdn(jy, jm, 1) + 1;
+    return { jy: jy <= 0 ? jy - 1 : jy, jm, jd };
+}
+/**
+ * Convert Gregorian to Hijri (Tabular Islamic Calendar).
+ */
+function gregorianToHijri(gy, gm, gd) {
+    const jdn = gregorianToJdn(gy, gm, gd);
+    const L = jdn - 1948440 + 10632;
+    const N = Math.floor((L - 1) / 10631);
+    const L2 = L - 10631 * N + 354;
+    const J = Math.floor((10985 - L2) / 5316) * Math.floor((50 * L2) / 17719) +
+        Math.floor(L2 / 5670) * Math.floor((43 * L2) / 15238);
+    const L3 = L2 -
+        Math.floor((30 - J) / 15) * Math.floor((17719 * J) / 50) -
+        Math.floor(J / 16) * Math.floor((15238 * J) / 43) +
+        29;
+    const hm = Math.floor((24 * L3) / 709);
+    const hd = L3 - Math.floor((709 * hm) / 24);
+    const hy = 30 * N + J - 30;
+    return { hy, hm, hd };
+}
+/**
+ * Convert Hijri to Gregorian.
+ */
+function hijriToGregorian(hy, hm, hd) {
+    const jdn = Math.floor((11 * hy + 3) / 30) +
+        354 * hy +
+        30 * hm -
+        Math.floor((hm - 1) / 2) +
+        hd +
+        1948440 -
+        385;
+    return jdnToGregorian(jdn);
+}
+//# sourceMappingURL=calendar.js.map

package/dist/utils/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/utils/calendar.ts"],"names":[],"mappings":"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"}

package/dist/utils/env.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Environment & Compatibility Layer
+ * Abstracts Node.js vs Browser differences.
+ */
+export declare const Env: {
+    isNode: boolean;
+    randomBytes(length: number): Uint8Array;
+    deflate(data: Uint8Array): Uint8Array;
+    inflate(data: Uint8Array): Uint8Array;
+    signEd25519(data: Uint8Array, privateKey: any): Uint8Array;
+    verifyEd25519(data: Uint8Array, signature: Uint8Array, publicKey: any): boolean;
+};

package/dist/utils/env.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Environment & Compatibility Layer
+ * Abstracts Node.js vs Browser differences.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Env = void 0;
+/* eslint-disable @typescript-eslint/no-require-imports */
+const isNode = typeof require !== "undefined";
+/**
+ * Node.js crypto module (conditional)
+ */
+const crypto = isNode ? require("crypto") : null;
+/**
+ * Node.js zlib module (conditional)
+ */
+const zlib = isNode ? require("zlib") : null;
+exports.Env = {
+    isNode,
+    randomBytes(length) {
+        if (isNode && crypto) {
+            return new Uint8Array(crypto.randomBytes(length));
+        }
+        if (typeof window !== "undefined" && window.crypto) {
+            return window.crypto.getRandomValues(new Uint8Array(length));
+        }
+        throw new Error("TPS: randomBytes not available in this environment");
+    },
+    deflate(data) {
+        if (isNode && zlib) {
+            return new Uint8Array(zlib.deflateRawSync(data));
+        }
+        throw new Error("TPS: deflate not available in this environment");
+    },
+    inflate(data) {
+        if (isNode && zlib) {
+            return new Uint8Array(zlib.inflateRawSync(data));
+        }
+        throw new Error("TPS: inflate not available in this environment");
+    },
+    signEd25519(data, privateKey) {
+        if (isNode && crypto) {
+            let key;
+            if (typeof privateKey === "string") {
+                if (privateKey.includes("PRIVATE KEY")) {
+                    key = privateKey;
+                }
+                else {
+                    key = crypto.createPrivateKey({
+                        key: Buffer.from(privateKey, "hex"),
+                        format: "der",
+                        type: "pkcs8",
+                    });
+                }
+            }
+            else if (typeof privateKey === "object" &&
+                privateKey !== null &&
+                "asymmetricKeyType" in privateKey) {
+                key = privateKey;
+            }
+            else {
+                key = crypto.createPrivateKey({
+                    key: Buffer.from(privateKey),
+                    format: "der",
+                    type: "pkcs8",
+                });
+            }
+            return new Uint8Array(crypto.sign(null, data, key));
+        }
+        throw new Error("TPS: signEd25519 not available in this environment");
+    },
+    verifyEd25519(data, signature, publicKey) {
+        if (isNode && crypto) {
+            return crypto.verify(null, data, publicKey, signature);
+        }
+        throw new Error("TPS: verifyEd25519 not available in this environment");
+    },
+};
+//# sourceMappingURL=env.js.map

package/dist/utils/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"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"}

package/dist/utils/tps-string.d.ts

@@ -0,0 +1,12 @@
+import { TPSComponents, TimeOrder } from "../types";
+/**
+ * Generate the canonical `T:` time string for a set of components.
+ */
+export declare function buildTimePart(comp: TPSComponents): string;
+/**
+ * Parse the time portion of a TPS string into components.
+ */
+export declare function parseTimeString(input: string): {
+    components: Partial<TPSComponents>;
+    order: TimeOrder;
+} | null;

package/dist/utils/tps-string.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTimePart = buildTimePart;
+exports.parseTimeString = parseTimeString;
+const types_1 = require("../types");
+/**
+ * Generate the canonical `T:` time string for a set of components.
+ */
+function buildTimePart(comp) {
+    const calendar = (comp.calendar || "").toLowerCase();
+    if (!/^[a-z]{3,4}$/.test(calendar)) {
+        throw new Error(`Invalid calendar code '${comp.calendar}'. Calendar code width must be 3–4 lowercase letters.`);
+    }
+    let time = `T:${calendar}`;
+    if (calendar === types_1.DefaultCalendars.UNIX) {
+        if (comp.unixSeconds !== undefined) {
+            time += `.s${comp.unixSeconds}`;
+        }
+        return time;
+    }
+    const tokens = [
+        ["m", comp.millennium, 8],
+        ["c", comp.century, 7],
+        ["y", comp.year, 6],
+        ["m", comp.month, 5],
+        ["d", comp.day, 4],
+        ["h", comp.hour, 3],
+        ["m", comp.minute, 2],
+        ["s", comp.second, 1],
+        ["m", comp.millisecond, 0],
+    ];
+    const order = comp.order || types_1.TimeOrder.DESC;
+    const activeTokens = order === types_1.TimeOrder.ASC ? [...tokens].reverse() : tokens;
+    for (const [pref, val] of activeTokens) {
+        if (val !== undefined) {
+            time += `.${pref}${val}`;
+        }
+    }
+    if (comp.signature) {
+        time += `!${comp.signature}`;
+    }
+    return time;
+}
+/**
+ * Parse the time portion of a TPS string into components.
+ */
+function parseTimeString(input) {
+    let s = input.trim();
+    s = s.split(/[!;?#]/)[0];
+    if (s.startsWith("T:"))
+        s = s.slice(2);
+    const parts = s.split(".");
+    if (parts.length === 0)
+        return null;
+    const calendar = parts[0];
+    const comp = { calendar };
+    const fixedRankMap = {
+        c: 7,
+        y: 6,
+        d: 4,
+        h: 3,
+        s: 1,
+    };
+    let initialOrder = types_1.TimeOrder.DESC;
+    if (calendar !== types_1.DefaultCalendars.UNIX) {
+        const nonMRanks = [];
+        for (let i = 1; i < parts.length; i++) {
+            const pr = parts[i]?.charAt(0);
+            if (pr && pr in fixedRankMap)
+                nonMRanks.push(fixedRankMap[pr]);
+        }
+        if (nonMRanks.length >= 2) {
+            const isAsc = nonMRanks.every((v, i, a) => i === 0 || a[i - 1] <= v);
+            if (isAsc)
+                initialOrder = types_1.TimeOrder.ASC;
+        }
+    }
+    const assignMRank = (lastRank, ord) => {
+        if (ord === types_1.TimeOrder.DESC) {
+            if (lastRank === null)
+                return 8;
+            if (lastRank > 5)
+                return 5;
+            if (lastRank > 2)
+                return 2;
+            return 0;
+        }
+        else {
+            if (lastRank === null)
+                return 0;
+            if (lastRank < 2)
+                return 2;
+            if (lastRank < 5)
+                return 5;
+            return 8;
+        }
+    };
+    const ranks = [];
+    let lastAssignedRank = null;
+    for (let i = 1; i < parts.length; i++) {
+        const token = parts[i];
+        if (!token)
+            continue;
+        const prefix = token.charAt(0);
+        const value = token.slice(1);
+        if (calendar === types_1.DefaultCalendars.UNIX && prefix === "s") {
+            comp.unixSeconds = parseFloat(value);
+            ranks.push(9);
+            continue;
+        }
+        if (prefix === "m") {
+            const rank = assignMRank(lastAssignedRank, initialOrder);
+            switch (rank) {
+                case 8:
+                    comp.millennium = parseInt(value, 10);
+                    break;
+                case 5:
+                    comp.month = parseInt(value, 10);
+                    break;
+                case 2:
+                    comp.minute = parseInt(value, 10);
+                    break;
+                case 0:
+                    comp.millisecond = parseInt(value, 10);
+                    break;
+            }
+            ranks.push(rank);
+            lastAssignedRank = rank;
+        }
+        else {
+            const rank = fixedRankMap[prefix];
+            if (rank !== undefined) {
+                switch (prefix) {
+                    case "c":
+                        comp.century = parseInt(value, 10);
+                        break;
+                    case "y":
+                        comp.year = parseInt(value, 10);
+                        break;
+                    case "d":
+                        comp.day = parseInt(value, 10);
+                        break;
+                    case "h":
+                        comp.hour = parseInt(value, 10);
+                        break;
+                    case "s":
+                        comp.second = parseFloat(value);
+                        break;
+                }
+                ranks.push(rank);
+                lastAssignedRank = rank;
+            }
+        }
+    }
+    let order = types_1.TimeOrder.DESC;
+    if (ranks.length > 1) {
+        const isAsc = ranks.every((v, i, a) => i === 0 || a[i - 1] <= v);
+        const isDesc = ranks.every((v, i, a) => i === 0 || a[i - 1] >= v);
+        if (isAsc && !isDesc)
+            order = types_1.TimeOrder.ASC;
+    }
+    return { components: comp, order };
+}
+//# sourceMappingURL=tps-string.js.map

package/dist/utils/tps-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tps-string.js","sourceRoot":"","sources":["../../src/utils/tps-string.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextera.one/tps-standard",
-  "version": "0.5.3",
+  "version": "0.5.34",
   "description": "The Universal Protocol for Space-Time Coordinates. A standard URI scheme (tps://) combining WGS84 spatial data with hierarchical, multi-calendar temporal coordinates. Includes TPS-UID: time-first, reversible event identifiers.",
   "keywords": [
     "tps",

package/src/date.ts

@@ -0,0 +1,243 @@
+/**
+ * TpsDate Date-like wrapper with native TPS conversion helpers.
+ */
+
+import { TPSComponents, DefaultCalendars, TimeOrder } from "./types";
+import { TPS } from "./index";
+
+export class TpsDate {
+  private readonly internal: Date;
+  private _cachedComponents: TPSComponents | null = null;
+  private _cachedTps: string | null = null;
+
+  constructor();
+  constructor(value: string | number | Date | TpsDate);
+  constructor(
+    year: number,
+    monthIndex: number,
+    day?: number,
+    hours?: number,
+    minutes?: number,
+    seconds?: number,
+    ms?: number,
+  );
+  constructor(
+    ...args:
+      | []
+      | [string | number | Date | TpsDate]
+      | [number, number, number?, number?, number?, number?, number?]
+  ) {
+    if (args.length === 0) {
+      this.internal = new Date();
+      return;
+    }
+
+    if (args.length === 1) {
+      const value = args[0];
+      if (value instanceof TpsDate) {
+        this.internal = new Date(value.getTime());
+        return;
+      }
+      if (value instanceof Date) {
+        this.internal = new Date(value.getTime());
+        return;
+      }
+      if (typeof value === "string" && TpsDate.looksLikeTPS(value)) {
+        const parsed = TPS.toDate(value);
+        if (!parsed) {
+          throw new RangeError(`Invalid TPS date string: ${value}`);
+        }
+        this.internal = parsed;
+        return;
+      }
+
+      this.internal = new Date(value);
+      return;
+    }
+
+    const [year, monthIndex, day, hours, minutes, seconds, ms] = args;
+    this.internal = new Date(
+      year,
+      monthIndex,
+      day ?? 1,
+      hours ?? 0,
+      minutes ?? 0,
+      seconds ?? 0,
+      ms ?? 0,
+    );
+  }
+
+  private static looksLikeTPS(input: string): boolean {
+    const s = input.trim();
+    return s.startsWith("tps://") || s.startsWith("T:") || s.startsWith("t:");
+  }
+
+  private getTpsComponents(): TPSComponents {
+    const currentTps = this.toTPS(DefaultCalendars.TPS);
+    if (this._cachedTps === currentTps && this._cachedComponents) {
+      return this._cachedComponents;
+    }
+
+    const parsed = TPS.parse(currentTps);
+    if (!parsed) {
+      throw new Error("TpsDate: failed to derive TPS components");
+    }
+
+    this._cachedTps = currentTps;
+    this._cachedComponents = parsed;
+    return parsed;
+  }
+
+  private getTpsFullYear(): number {
+    const comp = this.getTpsComponents();
+    return (comp.millennium - 1) * 1000 + (comp.century - 1) * 100 + comp.year;
+  }
+
+  static now(): number {
+    return Date.now();
+  }
+
+  static parse(input: string): number {
+    if (this.looksLikeTPS(input)) {
+      const d = TPS.toDate(input);
+      return d ? d.getTime() : Number.NaN;
+    }
+    return Date.parse(input);
+  }
+
+  static UTC(
+    year: number,
+    monthIndex: number,
+    day?: number,
+    hours?: number,
+    minutes?: number,
+    seconds?: number,
+    ms?: number,
+  ): number {
+    return Date.UTC(
+      year,
+      monthIndex,
+      day ?? 1,
+      hours ?? 0,
+      minutes ?? 0,
+      seconds ?? 0,
+      ms ?? 0,
+    );
+  }
+
+  static fromTPS(tps: string): TpsDate {
+    return new TpsDate(tps);
+  }
+
+  toGregorianDate(): Date {
+    return new Date(this.internal.getTime());
+  }
+
+  toDate(): Date {
+    return this.toGregorianDate();
+  }
+
+  toTPS(
+    calendar: string = DefaultCalendars.TPS,
+    opts?: { order?: TimeOrder },
+  ): string {
+    return TPS.fromDate(this.internal, calendar, opts);
+  }
+
+  toTPSURI(
+    calendar: string = DefaultCalendars.TPS,
+    opts?: {
+      order?: TimeOrder;
+      latitude?: number;
+      longitude?: number;
+      altitude?: number;
+      isUnknownLocation?: boolean;
+      isHiddenLocation?: boolean;
+      isRedactedLocation?: boolean;
+    },
+  ): string {
+    const time = this.toTPS(calendar, { order: opts?.order });
+    const comp = TPS.parse(time) as TPSComponents;
+
+    if (opts?.latitude !== undefined && opts?.longitude !== undefined) {
+      comp.latitude = opts.latitude;
+      comp.longitude = opts.longitude;
+      if (opts.altitude !== undefined) comp.altitude = opts.altitude;
+    } else if (opts?.isHiddenLocation) {
+      comp.isHiddenLocation = true;
+    } else if (opts?.isRedactedLocation) {
+      comp.isRedactedLocation = true;
+    } else {
+      comp.isUnknownLocation = true;
+    }
+
+    return TPS.toURI(comp);
+  }
+
+  getTime(): number {
+    return this.internal.getTime();
+  }
+  valueOf(): number {
+    return this.internal.valueOf();
+  }
+  toString(): string {
+    return this.toTPS(DefaultCalendars.TPS);
+  }
+  toISOString(): string {
+    return this.internal.toISOString();
+  }
+  toUTCString(): string {
+    return this.internal.toUTCString();
+  }
+  toJSON(): string | null {
+    return this.internal.toJSON();
+  }
+
+  getFullYear(): number {
+    return this.getTpsFullYear();
+  }
+  getUTCFullYear(): number {
+    return this.getTpsFullYear();
+  }
+  getMonth(): number {
+    return this.getTpsComponents().month - 1;
+  }
+  getUTCMonth(): number {
+    return this.getTpsComponents().month - 1;
+  }
+  getDate(): number {
+    return this.getTpsComponents().day;
+  }
+  getUTCDate(): number {
+    return this.getTpsComponents().day;
+  }
+  getHours(): number {
+    return this.getTpsComponents().hour;
+  }
+  getUTCHours(): number {
+    return this.getTpsComponents().hour;
+  }
+  getMinutes(): number {
+    return this.getTpsComponents().minute;
+  }
+  getUTCMinutes(): number {
+    return this.getTpsComponents().minute;
+  }
+  getSeconds(): number {
+    return this.getTpsComponents().second;
+  }
+  getUTCSeconds(): number {
+    return this.getTpsComponents().second;
+  }
+  getMilliseconds(): number {
+    return this.getTpsComponents().millisecond;
+  }
+  getUTCMilliseconds(): number {
+    return this.getTpsComponents().millisecond;
+  }
+
+  [Symbol.toPrimitive](hint: string): string | number {
+    if (hint === "number") return this.valueOf();
+    return this.toString();
+  }
+}