@maximem/synap-js-sdk 0.5.7 → 0.5.8

package/dist/index.d.cts

@@ -393,6 +393,15 @@ interface RawContextItem {
      * served from the prefetch cache.
      */
     matched_queries?: string[];
+    /**
+     * Anything the server sends that this SDK version has no named field for.
+     *
+     * This index signature already made unknown keys reachable in the TYPE; what
+     * dropped them was the normaliser, which built each item from a hand-picked
+     * list of keys. So `event_end` and `event_precision` were computed by the
+     * server, dropped by its own payload, and dropped a third time here, and a
+     * caller could not read "sometime in April" even once the server sent it.
+     */
     [key: string]: unknown;
 }
 interface RawConversationContext {
@@ -419,6 +428,17 @@ interface RawContext {
 }
 interface TemporalFields {
     eventDate: string | null;
+    /**
+     * The rest of the event window. `eventDate` is its START.
+     *
+     * "last month" is stored as 2023-04-01 to 2023-04-30 at precision "month",
+     * and reading only the start makes it look like the 1st, so arithmetic from
+     * it is wrong by up to the width of the window. `eventPrecision` carries the
+     * one distinction nothing else does: "approximate" has no end, so "around
+     * November 20" and "on November 20" differ only by this label.
+     */
+    eventEnd: string | null;
+    eventPrecision: string | null;
     /**
      * The day the words were SAID, which is not the day the event happened.
      *
@@ -478,6 +498,9 @@ interface TemporalEvent extends QueryAttribution {
     id: string;
     content: string;
     eventDate: string | null;
+    /** The rest of the window. See the note on `TemporalFields.eventEnd`. */
+    eventEnd: string | null;
+    eventPrecision: string | null;
     /** See the note on `TemporalFields.saidAt`. */
     saidAt: string | null;
     validUntil: string | null;
@@ -1678,7 +1701,7 @@ declare class SynapClient {
  * build when the two disagree, which is the only thing that makes a manual
  * publish safe.
  */
-declare const SDK_VERSION = "0.5.7";
+declare const SDK_VERSION = "0.5.8";
 
 /**
  * BM25 scorer for the anticipation cache.

package/dist/index.d.ts

@@ -393,6 +393,15 @@ interface RawContextItem {
      * served from the prefetch cache.
      */
     matched_queries?: string[];
+    /**
+     * Anything the server sends that this SDK version has no named field for.
+     *
+     * This index signature already made unknown keys reachable in the TYPE; what
+     * dropped them was the normaliser, which built each item from a hand-picked
+     * list of keys. So `event_end` and `event_precision` were computed by the
+     * server, dropped by its own payload, and dropped a third time here, and a
+     * caller could not read "sometime in April" even once the server sent it.
+     */
     [key: string]: unknown;
 }
 interface RawConversationContext {
@@ -419,6 +428,17 @@ interface RawContext {
 }
 interface TemporalFields {
     eventDate: string | null;
+    /**
+     * The rest of the event window. `eventDate` is its START.
+     *
+     * "last month" is stored as 2023-04-01 to 2023-04-30 at precision "month",
+     * and reading only the start makes it look like the 1st, so arithmetic from
+     * it is wrong by up to the width of the window. `eventPrecision` carries the
+     * one distinction nothing else does: "approximate" has no end, so "around
+     * November 20" and "on November 20" differ only by this label.
+     */
+    eventEnd: string | null;
+    eventPrecision: string | null;
     /**
      * The day the words were SAID, which is not the day the event happened.
      *
@@ -478,6 +498,9 @@ interface TemporalEvent extends QueryAttribution {
     id: string;
     content: string;
     eventDate: string | null;
+    /** The rest of the window. See the note on `TemporalFields.eventEnd`. */
+    eventEnd: string | null;
+    eventPrecision: string | null;
     /** See the note on `TemporalFields.saidAt`. */
     saidAt: string | null;
     validUntil: string | null;
@@ -1678,7 +1701,7 @@ declare class SynapClient {
  * build when the two disagree, which is the only thing that makes a manual
  * publish safe.
  */
-declare const SDK_VERSION = "0.5.7";
+declare const SDK_VERSION = "0.5.8";
 
 /**
  * BM25 scorer for the anticipation cache.

package/dist/index.js

@@ -638,6 +638,8 @@ function matchedQueries(item = {}) {
 function normalizeTemporalFields(item = {}) {
   return {
     eventDate: pick(item["eventDate"], item.event_date, null),
+    eventEnd: pick(item["eventEnd"], item.event_end, null),
+    eventPrecision: pick(item["eventPrecision"], item.event_precision, null),
     saidAt: pick(item["saidAt"], item.said_at, null),
     validUntil: pick(item["validUntil"], item.valid_until, null),
     temporalCategory: pick(item["temporalCategory"], item.temporal_category, null),
@@ -698,6 +700,8 @@ function normalizeTemporalEvent(item = {}) {
     id: item.id || "",
     content: item.content || "",
     eventDate: pick(item["eventDate"], item.event_date, null),
+    eventEnd: pick(item["eventEnd"], item.event_end, null),
+    eventPrecision: pick(item["eventPrecision"], item.event_precision, null),
     saidAt: pick(item["saidAt"], item.said_at, null),
     validUntil: pick(item["validUntil"], item.valid_until, null),
     temporalCategory: pick(item["temporalCategory"], item.temporal_category, ""),
@@ -1686,7 +1690,7 @@ function createInstanceNamespace(credentials, cache, onTurn) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.5.7";
+var SDK_VERSION = "0.5.8";
 
 // src/registry.ts
 var instances = /* @__PURE__ */ new Map();