@memosyne/sdk 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# @memosyne/sdk
+
+Official TypeScript client for the [Memosyne](https://usememosyne.com) API.
+
+## Install
+
+```
+npm install @memosyne/sdk
+```
+
+## Usage
+
+```ts
+import { Memosyne } from "@memosyne/sdk";
+
+const memosyne = new Memosyne({
+  apiKey: process.env.MEMOSYNE_API_KEY!,
+  baseUrl: "https://api.usememosyne.com",
+});
+
+await memosyne.logEvent({
+  action: "user.login",
+  actor: "user_123",
+  resourceType: "session",
+  resourceId: "sess_abc123",
+});
+```
+
+## API
+
+### `logEvent(input)`
+
+Logs an action without a before/after diff.
+
+### `logChange(input)`
+
+Computes and stores the diff between two object snapshots.
+
+```ts
+await memosyne.logChange({
+  before: { status: "active" },
+  after: { status: "archived" },
+  actor: "user_123",
+  resourceType: "facility",
+  resourceId: "fac_1",
+});
+```
+
+### `getEvents(options)`
+
+Fetches logged events for a resource.
+
+```ts
+const { events, nextCursor } = await memosyne.getEvents({
+  resourceType: "facility",
+  resourceId: "fac_1",
+  limit: 25,
+});
+```
+
+## Errors
+
+Failed requests throw `MemosyneError`, which carries the HTTP `status` and a `code`
+(`UNAUTHORIZED`, `INVALID_REQUEST`, `NOT_FOUND`, `RATE_LIMITED`, or `SERVER_ERROR`).

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+type ChangeType = "added" | "updated" | "removed";
+interface FieldChange {
+    path: string;
+    type: ChangeType;
+    from: unknown;
+    to: unknown;
+}
+interface Actor {
+    id: string;
+    name?: string;
+    email?: string;
+}
+interface ChangeEvent {
+    id: string;
+    resourceType: string;
+    resourceId: string;
+    actor: Actor;
+    action?: string;
+    changes: FieldChange[];
+    metadata: Record<string, unknown>;
+    timestamp: string;
+}
+interface LogChangeInput {
+    before: Record<string, unknown>;
+    after: Record<string, unknown>;
+    actor: string | Actor;
+    resourceType: string;
+    resourceId: string;
+    metadata?: Record<string, unknown>;
+    redact?: string[];
+}
+interface LogEventInput {
+    action: string;
+    actor: string | Actor;
+    resourceType: string;
+    resourceId: string;
+    metadata?: Record<string, unknown>;
+}
+interface QueryOptions {
+    resourceType: string;
+    resourceId: string;
+    limit?: number;
+    cursor?: string;
+}
+interface QueryResult {
+    events: ChangeEvent[];
+    nextCursor: string | null;
+}
+interface MemosyneConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+
+declare class Memosyne {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(config: MemosyneConfig);
+    logChange(input: LogChangeInput): Promise<ChangeEvent>;
+    logEvent(input: LogEventInput): Promise<ChangeEvent>;
+    getEvents(options: QueryOptions): Promise<QueryResult>;
+    private request;
+}
+
+declare class MemosyneError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(message: string, status: number, code: string);
+}
+
+export { type Actor, type ChangeEvent, type ChangeType, type FieldChange, type LogChangeInput, type LogEventInput, Memosyne, type MemosyneConfig, MemosyneError, type QueryOptions, type QueryResult };

package/dist/index.js

@@ -0,0 +1,67 @@
+// src/errors.ts
+var MemosyneError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "MemosyneError";
+  }
+  status;
+  code;
+};
+
+// src/client.ts
+var Memosyne = class {
+  apiKey;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+  }
+  async logChange(input) {
+    const res = await this.request("POST", "/v1/events", input);
+    return res;
+  }
+  async logEvent(input) {
+    const res = await this.request("POST", "/v1/events/log", input);
+    return res;
+  }
+  async getEvents(options) {
+    const params = new URLSearchParams({
+      resourceType: options.resourceType,
+      resourceId: options.resourceId,
+      ...options.limit !== void 0 ? { limit: String(options.limit) } : {},
+      ...options.cursor !== void 0 ? { cursor: options.cursor } : {}
+    });
+    const res = await this.request("GET", `/v1/events?${params}`);
+    return res;
+  }
+  async request(method, path, body) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      method,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        ...body !== void 0 ? { "Content-Type": "application/json" } : {}
+      },
+      ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+    });
+    const json = await res.json().catch(() => ({}));
+    if (!res.ok) {
+      const message = json.error ?? "Request failed";
+      throw new MemosyneError(message, res.status, toErrorCode(res.status));
+    }
+    return json;
+  }
+};
+function toErrorCode(status) {
+  if (status === 401) return "UNAUTHORIZED";
+  if (status === 400) return "INVALID_REQUEST";
+  if (status === 404) return "NOT_FOUND";
+  if (status === 429) return "RATE_LIMITED";
+  return "SERVER_ERROR";
+}
+export {
+  Memosyne,
+  MemosyneError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"sourcesContent":["export class MemosyneError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly code: string,\n  ) {\n    super(message);\n    this.name = \"MemosyneError\";\n  }\n}\n","import { MemosyneError } from \"./errors.js\";\nimport type {\n  MemosyneConfig,\n  ChangeEvent,\n  QueryOptions,\n  QueryResult,\n  LogChangeInput,\n  LogEventInput,\n} from \"./types.js\";\n\nexport class Memosyne {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(config: MemosyneConfig) {\n    this.apiKey = config.apiKey;\n    this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n  }\n\n  async logChange(input: LogChangeInput): Promise<ChangeEvent> {\n    const res = await this.request(\"POST\", \"/v1/events\", input);\n    return res as ChangeEvent;\n  }\n\n  async logEvent(input: LogEventInput): Promise<ChangeEvent> {\n    const res = await this.request(\"POST\", \"/v1/events/log\", input);\n    return res as ChangeEvent;\n  }\n\n  async getEvents(options: QueryOptions): Promise<QueryResult> {\n    const params = new URLSearchParams({\n      resourceType: options.resourceType,\n      resourceId: options.resourceId,\n      ...(options.limit !== undefined ? { limit: String(options.limit) } : {}),\n      ...(options.cursor !== undefined ? { cursor: options.cursor } : {}),\n    });\n\n    const res = await this.request(\"GET\", `/v1/events?${params}`);\n    return res as QueryResult;\n  }\n\n  private async request(method: string, path: string, body?: unknown): Promise<unknown> {\n    const res = await fetch(`${this.baseUrl}${path}`, {\n      method,\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        ...(body !== undefined ? { \"Content-Type\": \"application/json\" } : {}),\n      },\n      ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n    });\n\n    const json = await res.json().catch(() => ({}));\n\n    if (!res.ok) {\n      const message = (json as { error?: string }).error ?? \"Request failed\";\n      throw new MemosyneError(message, res.status, toErrorCode(res.status));\n    }\n\n    return json;\n  }\n}\n\nfunction toErrorCode(status: number): string {\n  if (status === 401) return \"UNAUTHORIZED\";\n  if (status === 400) return \"INVALID_REQUEST\";\n  if (status === 404) return \"NOT_FOUND\";\n  if (status === 429) return \"RATE_LIMITED\";\n  return \"SERVER_ERROR\";\n}\n"],"mappings":";AAAO,IAAM,gBAAN,cAA4B,MAAM;AAAA,EACvC,YACE,SACgB,QACA,MAChB;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AAAA,EALkB;AAAA,EACA;AAKpB;;;ACCO,IAAM,WAAN,MAAe;AAAA,EACH;AAAA,EACA;AAAA,EAEjB,YAAY,QAAwB;AAClC,SAAK,SAAS,OAAO;AACrB,SAAK,UAAU,OAAO,QAAQ,QAAQ,OAAO,EAAE;AAAA,EACjD;AAAA,EAEA,MAAM,UAAU,OAA6C;AAC3D,UAAM,MAAM,MAAM,KAAK,QAAQ,QAAQ,cAAc,KAAK;AAC1D,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,SAAS,OAA4C;AACzD,UAAM,MAAM,MAAM,KAAK,QAAQ,QAAQ,kBAAkB,KAAK;AAC9D,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,UAAU,SAA6C;AAC3D,UAAM,SAAS,IAAI,gBAAgB;AAAA,MACjC,cAAc,QAAQ;AAAA,MACtB,YAAY,QAAQ;AAAA,MACpB,GAAI,QAAQ,UAAU,SAAY,EAAE,OAAO,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC;AAAA,MACtE,GAAI,QAAQ,WAAW,SAAY,EAAE,QAAQ,QAAQ,OAAO,IAAI,CAAC;AAAA,IACnE,CAAC;AAED,UAAM,MAAM,MAAM,KAAK,QAAQ,OAAO,cAAc,MAAM,EAAE;AAC5D,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,QAAQ,QAAgB,MAAc,MAAkC;AACpF,UAAM,MAAM,MAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI,IAAI;AAAA,MAChD;AAAA,MACA,SAAS;AAAA,QACP,eAAe,UAAU,KAAK,MAAM;AAAA,QACpC,GAAI,SAAS,SAAY,EAAE,gBAAgB,mBAAmB,IAAI,CAAC;AAAA,MACrE;AAAA,MACA,GAAI,SAAS,SAAY,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE,IAAI,CAAC;AAAA,IAC7D,CAAC;AAED,UAAM,OAAO,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAE9C,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,UAAW,KAA4B,SAAS;AACtD,YAAM,IAAI,cAAc,SAAS,IAAI,QAAQ,YAAY,IAAI,MAAM,CAAC;AAAA,IACtE;AAEA,WAAO;AAAA,EACT;AACF;AAEA,SAAS,YAAY,QAAwB;AAC3C,MAAI,WAAW,IAAK,QAAO;AAC3B,MAAI,WAAW,IAAK,QAAO;AAC3B,MAAI,WAAW,IAAK,QAAO;AAC3B,MAAI,WAAW,IAAK,QAAO;AAC3B,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@memosyne/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript client for the Memosyne API.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/comandel/memosyne.git",
+    "directory": "sdks/typescript"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  }
+}