@levo-so/core 0.3.10 → 0.3.12

package/dist/index.d.ts

@@ -1185,6 +1185,45 @@ export declare namespace ILevoAudience {
         properties: Record<string, any>;
         withLock?: boolean;
     }
+    /**
+     * The session-scoped facts of a /v2 ingest request, sent as the envelope's
+     * `session` key: `{ session, events }`. A request belongs to exactly one
+     * visit, so these are request-level facts, the events array describes only
+     * the actions.
+     *
+     * Every field is optional and sent at most once per session. The server
+     * merges whatever arrives onto the session row, so late-resolving facts can
+     * ride a later request as a partial object. The merge rule differs per
+     * field: `properties` gap-fills, where the first value recorded for a key
+     * wins and a later value for the same key is dropped; `referrer` and the
+     * campaign params are written once and then frozen; `url` is set when the
+     * row is created and never patched; `locale`, `timezone` and the booleans
+     * take the freshest value.
+     */
+    export interface SessionTraits {
+        /** When the SESSION started, not when the request was sent. */
+        created_at?: string;
+        dark_mode?: Traits["dark_mode"];
+        locale?: Traits["locale"];
+        private_mode?: Traits["private_mode"];
+        /**
+         * The device/environment bag: screen, GPU, memory, cores, battery,
+         * camera/mic. Maps 1:1 onto the session row's column of the same name, and
+         * at envelope level there is no collision with the event's own bag.
+         *
+         * Gap-filled server-side, so a key sent twice keeps its first value. Send a
+         * corrected reading and the server ignores it.
+         */
+        properties?: Traits["properties"];
+        referrer?: Traits["referrer"];
+        timezone?: Traits["timezone"];
+        /**
+         * The LANDING url. The page the visit started on, query string included.
+         * The session row is only ever created from a request carrying it, and its
+         * campaign attribution is derived from nothing else.
+         */
+        url?: string;
+    }
     export type BaseProperties = Traits & {
         resource: string;
         identifier: string;
@@ -2045,6 +2084,8 @@ export declare namespace LevoEvent {
         accept_registration: boolean;
         one_attendee_per_account: boolean;
         max_capacity: number;
+        /** Registered attendees, returned by the list/read endpoints — no extra call needed. */
+        attendee_count?: number;
         banners: IMediaObject[];
         created_at: Date;
         created_by: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@levo-so/core",
   "description": "Levo common utilities",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "author": "Levo Engineering <devs@theinternetfolks.com>",
   "dependencies": {
     "wretch": "2.9.0"