@eazo/sdk 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -2,8 +2,10 @@ export { auth } from "./internal/capabilities/auth";
 export { device } from "./internal/capabilities/device";
 export { storage } from "./internal/capabilities/storage";
 export { ai } from "./internal/capabilities/ai";
+export { memory } from "./internal/capabilities/memory";
 export type { LoginOptions } from "./internal/capabilities/auth";
 export type { StorageCredentials, UploadResult } from "./internal/capabilities/storage";
+export type { MemoryActionParams } from "./internal/capabilities/memory";
 export type { ChatCompletion, ChatCompletionChunk, ChatCompletionCreateParamsNonStreaming, ChatCompletionCreateParamsStreaming, } from "./internal/capabilities/ai";
 export type { User, DeviceContext, AuthState, EazoState } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAEhD,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACxF,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,sCAAsC,EACtC,mCAAmC,GACpC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,OAAO,EAAE,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAExD,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACxF,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,sCAAsC,EACtC,mCAAmC,GACpC,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ai = exports.storage = exports.device = exports.auth = void 0;
+exports.memory = exports.ai = exports.storage = exports.device = exports.auth = void 0;
 var auth_1 = require("./internal/capabilities/auth");
 Object.defineProperty(exports, "auth", { enumerable: true, get: function () { return auth_1.auth; } });
 var device_1 = require("./internal/capabilities/device");
@@ -9,4 +9,6 @@ var storage_1 = require("./internal/capabilities/storage");
 Object.defineProperty(exports, "storage", { enumerable: true, get: function () { return storage_1.storage; } });
 var ai_1 = require("./internal/capabilities/ai");
 Object.defineProperty(exports, "ai", { enumerable: true, get: function () { return ai_1.ai; } });
+var memory_1 = require("./internal/capabilities/memory");
+Object.defineProperty(exports, "memory", { enumerable: true, get: function () { return memory_1.memory; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AAA3C,4FAAA,IAAI,OAAA;AACb,yDAAwD;AAA/C,gGAAA,MAAM,OAAA;AACf,2DAA0D;AAAjD,kGAAA,OAAO,OAAA;AAChB,iDAAgD;AAAvC,wFAAA,EAAE,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AAA3C,4FAAA,IAAI,OAAA;AACb,yDAAwD;AAA/C,gGAAA,MAAM,OAAA;AACf,2DAA0D;AAAjD,kGAAA,OAAO,OAAA;AAChB,iDAAgD;AAAvC,wFAAA,EAAE,OAAA;AACX,yDAAwD;AAA/C,gGAAA,MAAM,OAAA"}

package/dist/internal/capabilities/memory.d.ts

@@ -0,0 +1,45 @@
+export interface MemoryActionParams {
+    /** Readable description of the user action, e.g. "User clicked the publish button on the app editor page" */
+    content: string;
+    /** ISO 8601 timestamp. Defaults to now when omitted. */
+    timestamp?: string;
+    /** Associate this action with a Gum session ID */
+    session_id?: string;
+    /** Action category, e.g. "click", "search", "page_view" */
+    event_type?: string;
+    /** Page identifier where the action occurred, e.g. "app_editor" */
+    page?: string;
+    /** Business ID anchors for retrieval, e.g. { app_id: "app_123" } */
+    anchors?: Record<string, string>;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Entity tags associated with this action */
+    entities?: string[];
+    /** Device identifier */
+    device_id?: string;
+    /** App identifier */
+    app?: string;
+    /** Platform, e.g. "web", "ios", "android" */
+    platform?: string;
+}
+export declare const memory: {
+    /**
+     * Report a user action event to Gum memory service.
+     *
+     * Requires the user to be authenticated — the current session is forwarded
+     * automatically via `x-eazo-session`. The developer public key is read from
+     * `NEXT_PUBLIC_EAZO_PUBLIC_KEY` or set via `auth.configure({ publicKey })`.
+     *
+     * @example
+     * ```ts
+     * await memory.reportAction({
+     *   content: "User clicked the publish button on the app editor page",
+     *   event_type: "click",
+     *   page: "app_editor",
+     *   anchors: { app_id: "app_123" },
+     * });
+     * ```
+     */
+    reportAction(params: MemoryActionParams): Promise<void>;
+};
+//# sourceMappingURL=memory.d.ts.map

package/dist/internal/capabilities/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/internal/capabilities/memory.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,kBAAkB;IACjC,6GAA6G;IAC7G,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD,eAAO,MAAM,MAAM;IACjB;;;;;;;;;;;;;;;;OAgBG;yBACwB,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAkC9D,CAAC"}

package/dist/internal/capabilities/memory.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memory = void 0;
+const config_1 = require("../config");
+const auth_1 = require("./auth");
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+exports.memory = {
+    /**
+     * Report a user action event to Gum memory service.
+     *
+     * Requires the user to be authenticated — the current session is forwarded
+     * automatically via `x-eazo-session`. The developer public key is read from
+     * `NEXT_PUBLIC_EAZO_PUBLIC_KEY` or set via `auth.configure({ publicKey })`.
+     *
+     * @example
+     * ```ts
+     * await memory.reportAction({
+     *   content: "User clicked the publish button on the app editor page",
+     *   event_type: "click",
+     *   page: "app_editor",
+     *   anchors: { app_id: "app_123" },
+     * });
+     * ```
+     */
+    async reportAction(params) {
+        const publicKey = (0, config_1.getPublicKey)();
+        if (!publicKey) {
+            throw new Error("@eazo/sdk: missing public key. Set NEXT_PUBLIC_EAZO_PUBLIC_KEY or call auth.configure({ publicKey }).");
+        }
+        const session = await auth_1.auth.getSessionHeader();
+        if (!session) {
+            throw new Error("@eazo/sdk: user is not authenticated. Call auth.login() before reporting memory actions.");
+        }
+        const res = await fetch(`${(0, config_1.getApiBase)()}/api/open/gum/action`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-eazo-publickey": publicKey,
+                "x-eazo-session": session,
+            },
+            body: JSON.stringify(params),
+        });
+        if (!res.ok) {
+            let message = `Failed to report memory action: ${res.status}`;
+            try {
+                const body = await res.json();
+                if (body?.message)
+                    message = body.message;
+            }
+            catch { /* ignore */ }
+            throw new Error(message);
+        }
+    },
+};
+//# sourceMappingURL=memory.js.map

package/dist/internal/capabilities/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/internal/capabilities/memory.ts"],"names":[],"mappings":";;;AAAA,sCAAqD;AACrD,iCAA8B;AA+B9B,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAEjE,QAAA,MAAM,GAAG;IACpB;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,MAAM,SAAS,GAAG,IAAA,qBAAY,GAAE,CAAC;QACjC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,WAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAA,mBAAU,GAAE,sBAAsB,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,kBAAkB,EAAE,SAAS;gBAC7B,gBAAgB,EAAE,OAAO;aAC1B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC7B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,OAAO,GAAG,mCAAmC,GAAG,CAAC,MAAM,EAAE,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA0B,CAAC;gBACtD,IAAI,IAAI,EAAE,OAAO;oBAAE,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eazo/sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Eazo platform SDK — capability-first API for web apps that run on Eazo Mobile and the web browser",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",