@voltmem/client 0.1.0 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +11 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +36 -0
- package/dist/index.js.map +1 -1
- package/dist/types.d.ts +24 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +9 -1
- package/src/index.ts +72 -0
- package/src/types.ts +27 -0
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import type { AddData, AddOptions, DomainStats, MemoryHit, MemoryItem, SearchOptions, UserOptions, VoltMemClientOptions, WriteResult } from "./types.js";
|
|
2
|
-
export type { AddData, AddOptions, DomainStat, DomainStats, MemoryHit, MemoryItem, Message, SearchOptions, UserOptions, VoltMemClientOptions, WriteResult, } from "./types.js";
|
|
1
|
+
import type { AddData, AddOptions, AddEventOptions, DomainStats, Facet, MaintenanceTriggerOptions, MemoryHit, MemoryItem, SearchOptions, UserOptions, VoltMemClientOptions, WriteResult } from "./types.js";
|
|
2
|
+
export type { AddData, AddOptions, AddEventOptions, DomainStat, DomainStats, Facet, MaintenanceTriggerOptions, MemoryHit, MemoryItem, Message, SearchOptions, UserOptions, VoltMemClientOptions, WriteResult, } from "./types.js";
|
|
3
3
|
export declare class VoltMemError extends Error {
|
|
4
4
|
readonly status: number;
|
|
5
5
|
readonly body: unknown;
|
|
@@ -21,6 +21,8 @@ export declare class VoltMemClient {
|
|
|
21
21
|
status: string;
|
|
22
22
|
}>;
|
|
23
23
|
add(data: AddData, options?: AddOptions): Promise<WriteResult | WriteResult[]>;
|
|
24
|
+
addEvent(event_id: string, facets: Facet[], options?: AddEventOptions): Promise<WriteResult[]>;
|
|
25
|
+
getEvent(eventId: string, options?: UserOptions): Promise<MemoryItem[]>;
|
|
24
26
|
search(query: string, options?: SearchOptions): Promise<MemoryHit[]>;
|
|
25
27
|
getAll(options?: UserOptions): Promise<MemoryItem[]>;
|
|
26
28
|
get(memoryId: string, options?: UserOptions): Promise<MemoryItem>;
|
|
@@ -32,6 +34,13 @@ export declare class VoltMemClient {
|
|
|
32
34
|
}>;
|
|
33
35
|
summary(options?: UserOptions): Promise<Record<string, unknown>>;
|
|
34
36
|
domainStats(options?: UserOptions): Promise<DomainStats>;
|
|
37
|
+
maintenanceTrigger(options?: MaintenanceTriggerOptions): Promise<Record<string, unknown>>;
|
|
38
|
+
maintenanceRollback(runId: string, options?: UserOptions): Promise<Record<string, unknown>>;
|
|
39
|
+
maintenanceTasks(options?: UserOptions): Promise<Array<{
|
|
40
|
+
name: string;
|
|
41
|
+
description: string;
|
|
42
|
+
interval: number;
|
|
43
|
+
}>>;
|
|
35
44
|
private requireUserId;
|
|
36
45
|
private request;
|
|
37
46
|
}
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,UAAU,EACV,UAAU,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,OAAO,EACP,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM3D;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,OAAO,EAAE,oBAAoB;IAOzC,yEAAyE;IACzE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAUhC,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAIrC,GAAG,CACP,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,WAAW,GAAG,WAAW,EAAE,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -44,8 +44,27 @@ export class VoltMemClient {
|
|
|
44
44
|
body.source = options.source;
|
|
45
45
|
if (options.extract !== undefined)
|
|
46
46
|
body.extract = options.extract;
|
|
47
|
+
if (options.event_id !== undefined)
|
|
48
|
+
body.event_id = options.event_id;
|
|
49
|
+
if (options.modality !== undefined)
|
|
50
|
+
body.modality = options.modality;
|
|
51
|
+
if (options.expires_at !== undefined)
|
|
52
|
+
body.expires_at = options.expires_at;
|
|
53
|
+
if (options.ttl_seconds !== undefined)
|
|
54
|
+
body.ttl_seconds = options.ttl_seconds;
|
|
47
55
|
return this.request("POST", `/v1/users/${encodeURIComponent(userId)}/memories`, { body });
|
|
48
56
|
}
|
|
57
|
+
async addEvent(event_id, facets, options = {}) {
|
|
58
|
+
const userId = this.requireUserId(options.userId);
|
|
59
|
+
const body = { event_id, facets };
|
|
60
|
+
if (options.source !== undefined)
|
|
61
|
+
body.source = options.source;
|
|
62
|
+
return this.request("POST", `/v1/users/${encodeURIComponent(userId)}/events`, { body });
|
|
63
|
+
}
|
|
64
|
+
async getEvent(eventId, options = {}) {
|
|
65
|
+
const userId = this.requireUserId(options.userId);
|
|
66
|
+
return this.request("GET", `/v1/users/${encodeURIComponent(userId)}/events/${encodeURIComponent(eventId)}`);
|
|
67
|
+
}
|
|
49
68
|
async search(query, options = {}) {
|
|
50
69
|
const userId = this.requireUserId(options.userId);
|
|
51
70
|
const params = new URLSearchParams({ q: query });
|
|
@@ -80,6 +99,23 @@ export class VoltMemClient {
|
|
|
80
99
|
const userId = this.requireUserId(options.userId);
|
|
81
100
|
return this.request("GET", `/v1/users/${encodeURIComponent(userId)}/domain_stats`);
|
|
82
101
|
}
|
|
102
|
+
async maintenanceTrigger(options = {}) {
|
|
103
|
+
const userId = this.requireUserId(options.userId);
|
|
104
|
+
const body = {};
|
|
105
|
+
if (options.task !== undefined)
|
|
106
|
+
body.task = options.task;
|
|
107
|
+
if (options.dry_run !== undefined)
|
|
108
|
+
body.dry_run = options.dry_run;
|
|
109
|
+
return this.request("POST", `/v1/users/${encodeURIComponent(userId)}/maintenance/trigger`, { body });
|
|
110
|
+
}
|
|
111
|
+
async maintenanceRollback(runId, options = {}) {
|
|
112
|
+
const userId = this.requireUserId(options.userId);
|
|
113
|
+
return this.request("POST", `/v1/users/${encodeURIComponent(userId)}/maintenance/rollback`, { body: { run_id: runId } });
|
|
114
|
+
}
|
|
115
|
+
async maintenanceTasks(options = {}) {
|
|
116
|
+
const userId = this.requireUserId(options.userId);
|
|
117
|
+
return this.request("GET", `/v1/users/${encodeURIComponent(userId)}/maintenance/tasks`);
|
|
118
|
+
}
|
|
83
119
|
requireUserId(override) {
|
|
84
120
|
const userId = override ?? this.userId;
|
|
85
121
|
if (!userId) {
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgCA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,MAAM,CAAS;IACf,IAAI,CAAU;IAEvB,YAAY,OAAe,EAAE,MAAc,EAAE,IAAa;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IACf,OAAO,CAAS;IAChB,MAAM,CAAqB;IAC3B,MAAM,CAAqB;IACnB,SAAS,CAAe;IAEzC,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC;IAED,yEAAyE;IACzE,OAAO,CAAC,MAAc;QACpB,MAAM,OAAO,GAAyB;YACpC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM;YACN,KAAK,EAAE,IAAI,CAAC,SAAS;SACtB,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5D,OAAO,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,OAAO,CAAqB,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAa,EACb,UAAsB,EAAE;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,CAAC;QAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/D,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAClE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACrE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACrE,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAC3E,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAC9E,OAAO,IAAI,CAAC,OAAO,CACjB,MAAM,EACN,aAAa,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAClD,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,MAAe,EACf,UAA2B,EAAE;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAA4B,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/D,OAAO,IAAI,CAAC,OAAO,CACjB,MAAM,EACN,aAAa,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAChD,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAAe,EACf,UAAuB,EAAE;QAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,aAAa,kBAAkB,CAAC,MAAM,CAAC,WAAW,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAChF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,UAAyB,EAAE;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5E,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,aAAa,kBAAkB,CAAC,MAAM,CAAC,oBAAoB,MAAM,EAAE,CACpE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAuB,EAAE;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,aAAa,kBAAkB,CAAC,MAAM,CAAC,WAAW,CACnD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,QAAgB,EAChB,UAAuB,EAAE;QAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,aAAa,kBAAkB,CAAC,MAAM,CAAC,aAAa,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,QAAgB,EAChB,UAAuB,EAAE;QAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,QAAQ,EACR,aAAa,kBAAkB,CAAC,MAAM,CAAC,aAAa,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CACnF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,UAAuB,EAAE;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,QAAQ,EACR,aAAa,kBAAkB,CAAC,MAAM,CAAC,WAAW,CACnD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAuB,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,aAAa,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAClD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAuB,EAAE;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,aAAa,kBAAkB,CAAC,MAAM,CAAC,eAAe,CACvD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,UAAqC,EAAE;QAEvC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CACjB,MAAM,EACN,aAAa,kBAAkB,CAAC,MAAM,CAAC,sBAAsB,EAC7D,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,KAAa,EACb,UAAuB,EAAE;QAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,MAAM,EACN,aAAa,kBAAkB,CAAC,MAAM,CAAC,uBAAuB,EAC9D,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,UAAuB,EAAE;QAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,aAAa,kBAAkB,CAAC,MAAM,CAAC,oBAAoB,CAC5D,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,QAAiB;QACrC,MAAM,MAAM,GAAG,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,OAA2C,EAAE;QAE7C,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QACF,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvC,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;YAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAEjE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,GAAY,SAAS,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,YAAY,CACpB,WAAW,MAAM,IAAI,IAAI,YAAY,GAAG,CAAC,MAAM,GAAG,EAClD,GAAG,CAAC,MAAM,EACV,MAAM,CACP,CAAC;QACJ,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;CACF"}
|
package/dist/types.d.ts
CHANGED
|
@@ -5,6 +5,14 @@ export type Message = {
|
|
|
5
5
|
};
|
|
6
6
|
/** String fact, one chat message, or a list of messages (extractable). */
|
|
7
7
|
export type AddData = string | Message | Message[];
|
|
8
|
+
/** Facet for multi-facet event storage. */
|
|
9
|
+
export type Facet = {
|
|
10
|
+
content: string;
|
|
11
|
+
domain: string;
|
|
12
|
+
modality?: string;
|
|
13
|
+
ttl_seconds?: number;
|
|
14
|
+
expires_at?: number;
|
|
15
|
+
};
|
|
8
16
|
export type WriteResult = {
|
|
9
17
|
id: string;
|
|
10
18
|
memory: string;
|
|
@@ -19,6 +27,9 @@ export type MemoryItem = {
|
|
|
19
27
|
source: string;
|
|
20
28
|
created_at: number;
|
|
21
29
|
last_confirmed_at: number;
|
|
30
|
+
event_id?: string;
|
|
31
|
+
modality?: string;
|
|
32
|
+
expires_at?: number;
|
|
22
33
|
};
|
|
23
34
|
export type MemoryHit = MemoryItem & {
|
|
24
35
|
score: number;
|
|
@@ -48,6 +59,14 @@ export type AddOptions = {
|
|
|
48
59
|
source?: string;
|
|
49
60
|
extract?: boolean;
|
|
50
61
|
userId?: string;
|
|
62
|
+
event_id?: string;
|
|
63
|
+
modality?: string;
|
|
64
|
+
expires_at?: number;
|
|
65
|
+
ttl_seconds?: number;
|
|
66
|
+
};
|
|
67
|
+
export type AddEventOptions = {
|
|
68
|
+
source?: string;
|
|
69
|
+
userId?: string;
|
|
51
70
|
};
|
|
52
71
|
export type SearchOptions = {
|
|
53
72
|
limit?: number;
|
|
@@ -57,4 +76,9 @@ export type SearchOptions = {
|
|
|
57
76
|
export type UserOptions = {
|
|
58
77
|
userId?: string;
|
|
59
78
|
};
|
|
79
|
+
export type MaintenanceTriggerOptions = {
|
|
80
|
+
task?: string;
|
|
81
|
+
dry_run?: boolean;
|
|
82
|
+
userId?: string;
|
|
83
|
+
};
|
|
60
84
|
//# sourceMappingURL=types.d.ts.map
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,9 +1,17 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@voltmem/client",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Workers-safe TypeScript client for the VoltMem HTTP sidecar",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/Rouche01/voltmem.git",
|
|
10
|
+
"directory": "clients/typescript"
|
|
11
|
+
},
|
|
12
|
+
"publishConfig": {
|
|
13
|
+
"access": "public"
|
|
14
|
+
},
|
|
7
15
|
"main": "./dist/index.js",
|
|
8
16
|
"types": "./dist/index.d.ts",
|
|
9
17
|
"exports": {
|
package/src/index.ts
CHANGED
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import type {
|
|
2
2
|
AddData,
|
|
3
3
|
AddOptions,
|
|
4
|
+
AddEventOptions,
|
|
4
5
|
DomainStats,
|
|
6
|
+
Facet,
|
|
7
|
+
MaintenanceTriggerOptions,
|
|
5
8
|
MemoryHit,
|
|
6
9
|
MemoryItem,
|
|
7
10
|
SearchOptions,
|
|
@@ -13,8 +16,11 @@ import type {
|
|
|
13
16
|
export type {
|
|
14
17
|
AddData,
|
|
15
18
|
AddOptions,
|
|
19
|
+
AddEventOptions,
|
|
16
20
|
DomainStat,
|
|
17
21
|
DomainStats,
|
|
22
|
+
Facet,
|
|
23
|
+
MaintenanceTriggerOptions,
|
|
18
24
|
MemoryHit,
|
|
19
25
|
MemoryItem,
|
|
20
26
|
Message,
|
|
@@ -76,6 +82,10 @@ export class VoltMemClient {
|
|
|
76
82
|
const body: Record<string, unknown> = { data };
|
|
77
83
|
if (options.source !== undefined) body.source = options.source;
|
|
78
84
|
if (options.extract !== undefined) body.extract = options.extract;
|
|
85
|
+
if (options.event_id !== undefined) body.event_id = options.event_id;
|
|
86
|
+
if (options.modality !== undefined) body.modality = options.modality;
|
|
87
|
+
if (options.expires_at !== undefined) body.expires_at = options.expires_at;
|
|
88
|
+
if (options.ttl_seconds !== undefined) body.ttl_seconds = options.ttl_seconds;
|
|
79
89
|
return this.request<WriteResult | WriteResult[]>(
|
|
80
90
|
"POST",
|
|
81
91
|
`/v1/users/${encodeURIComponent(userId)}/memories`,
|
|
@@ -83,6 +93,32 @@ export class VoltMemClient {
|
|
|
83
93
|
);
|
|
84
94
|
}
|
|
85
95
|
|
|
96
|
+
async addEvent(
|
|
97
|
+
event_id: string,
|
|
98
|
+
facets: Facet[],
|
|
99
|
+
options: AddEventOptions = {},
|
|
100
|
+
): Promise<WriteResult[]> {
|
|
101
|
+
const userId = this.requireUserId(options.userId);
|
|
102
|
+
const body: Record<string, unknown> = { event_id, facets };
|
|
103
|
+
if (options.source !== undefined) body.source = options.source;
|
|
104
|
+
return this.request<WriteResult[]>(
|
|
105
|
+
"POST",
|
|
106
|
+
`/v1/users/${encodeURIComponent(userId)}/events`,
|
|
107
|
+
{ body },
|
|
108
|
+
);
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
async getEvent(
|
|
112
|
+
eventId: string,
|
|
113
|
+
options: UserOptions = {},
|
|
114
|
+
): Promise<MemoryItem[]> {
|
|
115
|
+
const userId = this.requireUserId(options.userId);
|
|
116
|
+
return this.request<MemoryItem[]>(
|
|
117
|
+
"GET",
|
|
118
|
+
`/v1/users/${encodeURIComponent(userId)}/events/${encodeURIComponent(eventId)}`,
|
|
119
|
+
);
|
|
120
|
+
}
|
|
121
|
+
|
|
86
122
|
async search(
|
|
87
123
|
query: string,
|
|
88
124
|
options: SearchOptions = {},
|
|
@@ -153,6 +189,42 @@ export class VoltMemClient {
|
|
|
153
189
|
);
|
|
154
190
|
}
|
|
155
191
|
|
|
192
|
+
async maintenanceTrigger(
|
|
193
|
+
options: MaintenanceTriggerOptions = {},
|
|
194
|
+
): Promise<Record<string, unknown>> {
|
|
195
|
+
const userId = this.requireUserId(options.userId);
|
|
196
|
+
const body: Record<string, unknown> = {};
|
|
197
|
+
if (options.task !== undefined) body.task = options.task;
|
|
198
|
+
if (options.dry_run !== undefined) body.dry_run = options.dry_run;
|
|
199
|
+
return this.request<Record<string, unknown>>(
|
|
200
|
+
"POST",
|
|
201
|
+
`/v1/users/${encodeURIComponent(userId)}/maintenance/trigger`,
|
|
202
|
+
{ body },
|
|
203
|
+
);
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
async maintenanceRollback(
|
|
207
|
+
runId: string,
|
|
208
|
+
options: UserOptions = {},
|
|
209
|
+
): Promise<Record<string, unknown>> {
|
|
210
|
+
const userId = this.requireUserId(options.userId);
|
|
211
|
+
return this.request<Record<string, unknown>>(
|
|
212
|
+
"POST",
|
|
213
|
+
`/v1/users/${encodeURIComponent(userId)}/maintenance/rollback`,
|
|
214
|
+
{ body: { run_id: runId } },
|
|
215
|
+
);
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
async maintenanceTasks(
|
|
219
|
+
options: UserOptions = {},
|
|
220
|
+
): Promise<Array<{ name: string; description: string; interval: number }>> {
|
|
221
|
+
const userId = this.requireUserId(options.userId);
|
|
222
|
+
return this.request<Array<{ name: string; description: string; interval: number }>>(
|
|
223
|
+
"GET",
|
|
224
|
+
`/v1/users/${encodeURIComponent(userId)}/maintenance/tasks`,
|
|
225
|
+
);
|
|
226
|
+
}
|
|
227
|
+
|
|
156
228
|
private requireUserId(override?: string): string {
|
|
157
229
|
const userId = override ?? this.userId;
|
|
158
230
|
if (!userId) {
|
package/src/types.ts
CHANGED
|
@@ -8,6 +8,15 @@ export type Message = {
|
|
|
8
8
|
/** String fact, one chat message, or a list of messages (extractable). */
|
|
9
9
|
export type AddData = string | Message | Message[];
|
|
10
10
|
|
|
11
|
+
/** Facet for multi-facet event storage. */
|
|
12
|
+
export type Facet = {
|
|
13
|
+
content: string;
|
|
14
|
+
domain: string;
|
|
15
|
+
modality?: string;
|
|
16
|
+
ttl_seconds?: number;
|
|
17
|
+
expires_at?: number;
|
|
18
|
+
};
|
|
19
|
+
|
|
11
20
|
export type WriteResult = {
|
|
12
21
|
id: string;
|
|
13
22
|
memory: string;
|
|
@@ -23,6 +32,9 @@ export type MemoryItem = {
|
|
|
23
32
|
source: string;
|
|
24
33
|
created_at: number;
|
|
25
34
|
last_confirmed_at: number;
|
|
35
|
+
event_id?: string;
|
|
36
|
+
modality?: string;
|
|
37
|
+
expires_at?: number;
|
|
26
38
|
};
|
|
27
39
|
|
|
28
40
|
export type MemoryHit = MemoryItem & {
|
|
@@ -57,6 +69,15 @@ export type AddOptions = {
|
|
|
57
69
|
source?: string;
|
|
58
70
|
extract?: boolean;
|
|
59
71
|
userId?: string;
|
|
72
|
+
event_id?: string;
|
|
73
|
+
modality?: string;
|
|
74
|
+
expires_at?: number;
|
|
75
|
+
ttl_seconds?: number;
|
|
76
|
+
};
|
|
77
|
+
|
|
78
|
+
export type AddEventOptions = {
|
|
79
|
+
source?: string;
|
|
80
|
+
userId?: string;
|
|
60
81
|
};
|
|
61
82
|
|
|
62
83
|
export type SearchOptions = {
|
|
@@ -68,3 +89,9 @@ export type SearchOptions = {
|
|
|
68
89
|
export type UserOptions = {
|
|
69
90
|
userId?: string;
|
|
70
91
|
};
|
|
92
|
+
|
|
93
|
+
export type MaintenanceTriggerOptions = {
|
|
94
|
+
task?: string;
|
|
95
|
+
dry_run?: boolean;
|
|
96
|
+
userId?: string;
|
|
97
|
+
};
|