@xmtp/agent-sdk 0.0.1 → 0.0.2

package/dist/core/Agent.d.ts

@@ -0,0 +1,29 @@
+import EventEmitter from "node:events";
+import type { ContentCodec } from "@xmtp/content-type-primitives";
+import { Client, type ClientOptions } from "@xmtp/node-sdk";
+import { AgentContext } from "./AgentContext";
+interface EventHandlerMap<ContentTypes> {
+    error: [error: Error];
+    message: [ctx: AgentContext<ContentTypes>];
+    start: [];
+    stop: [];
+}
+export interface AgentOptions<ContentTypes> {
+    client: Client<ContentTypes>;
+}
+export type AgentMiddleware<ContentTypes> = (ctx: AgentContext<ContentTypes>, next: () => Promise<void>) => Promise<void>;
+export declare class Agent<ContentTypes> extends EventEmitter<EventHandlerMap<ContentTypes>> {
+    #private;
+    constructor({ client }: AgentOptions<ContentTypes>);
+    static create<ContentCodecs extends ContentCodec[] = []>(signer: Parameters<typeof Client.create>[0], options?: Omit<ClientOptions, "codecs"> & {
+        codecs?: ContentCodecs;
+    }): Promise<Agent<import("@xmtp/node-sdk").ExtractCodecContentTypes<ContentCodecs>>>;
+    static build<ContentCodecs extends ContentCodec[] = []>(identifier: Parameters<typeof Client.build>[0], options?: Omit<ClientOptions, "codecs"> & {
+        codecs?: ContentCodecs;
+    }): Promise<Agent<import("@xmtp/node-sdk").ExtractCodecContentTypes<ContentCodecs>>>;
+    use(middleware: AgentMiddleware<ContentTypes>): this;
+    start(): Promise<void>;
+    get client(): Client<ContentTypes>;
+    stop(): void;
+}
+export {};

package/dist/core/Agent.js

@@ -0,0 +1,88 @@
+import EventEmitter from "node:events";
+import { Client, } from "@xmtp/node-sdk";
+import { filter } from "@/utils/filter";
+import { AgentContext } from "./AgentContext";
+export class Agent extends EventEmitter {
+    #client;
+    #middleware = [];
+    #isListening = false;
+    constructor({ client }) {
+        super();
+        this.#client = client;
+    }
+    static async create(signer, 
+    // Note: we need to omit this so that "Client.create" can correctly infer the codecs.
+    options) {
+        const client = await Client.create(signer, options);
+        return new Agent({ client });
+    }
+    static async build(identifier, 
+    // Note: we need to omit this so that "Client.build" can correctly infer the codecs.
+    options) {
+        const client = await Client.build(identifier, options);
+        return new Agent({ client });
+    }
+    use(middleware) {
+        this.#middleware.push(middleware);
+        return this;
+    }
+    async start() {
+        if (this.#isListening) {
+            return;
+        }
+        try {
+            this.#isListening = true;
+            void this.emit("start");
+            const stream = await this.#client.conversations.streamAllMessages();
+            for await (const message of stream) {
+                // The "stop()" method sets "isListening"
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+                if (!this.#isListening)
+                    break;
+                try {
+                    await this.#processMessage(message);
+                }
+                catch (error) {
+                    this.#throwError(error);
+                }
+            }
+        }
+        catch (error) {
+            this.#isListening = false;
+            this.#throwError(error);
+        }
+    }
+    async #processMessage(message) {
+        const conversation = await this.#client.conversations.getConversationById(message.conversationId);
+        if (!conversation) {
+            this.#throwError(new Error(`Failed to process message ID "${message.id}" for conversation ID "${message.conversationId}" because the conversation could not be found.`));
+            return;
+        }
+        const context = new AgentContext(message, conversation, this.#client);
+        let middlewareIndex = 0;
+        const next = async () => {
+            if (middlewareIndex < this.#middleware.length) {
+                const currentMiddleware = this.#middleware[middlewareIndex++];
+                await currentMiddleware(context, next);
+            }
+            else if (filter.notFromSelf(message, this.#client)) {
+                // Note: we are filtering the agent's own message to avoid
+                // infinite message loops when a "message" listener replies
+                void this.emit("message", context);
+            }
+        };
+        await next();
+    }
+    get client() {
+        return this.#client;
+    }
+    stop() {
+        this.#isListening = false;
+        void this.emit("stop");
+    }
+    #throwError(error) {
+        const newError = error instanceof Error ? error : new Error(String(error));
+        void this.emit("error", newError);
+    }
+}
+//# sourceMappingURL=Agent.js.map

package/dist/core/Agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../../src/core/Agent.ts"],"names":[],"mappings":"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"}

package/dist/core/AgentContext.d.ts

@@ -0,0 +1,11 @@
+import type { Client, Conversation, DecodedMessage } from "@xmtp/node-sdk";
+export declare class AgentContext<ContentTypes = unknown> {
+    #private;
+    constructor(message: DecodedMessage<ContentTypes>, conversation: Conversation, client: Client<ContentTypes>);
+    sendText(text: string): Promise<void>;
+    sendTextReply(text: string): Promise<void>;
+    getSenderAddress(): Promise<string>;
+    get message(): DecodedMessage<ContentTypes>;
+    get conversation(): Conversation<unknown>;
+    get client(): Client<ContentTypes>;
+}

package/dist/core/AgentContext.js

@@ -0,0 +1,40 @@
+import { ContentTypeReply } from "@xmtp/content-type-reply";
+import { ContentTypeText } from "@xmtp/content-type-text";
+export class AgentContext {
+    #client;
+    #message;
+    #conversation;
+    constructor(message, conversation, client) {
+        this.#message = message;
+        this.#conversation = conversation;
+        this.#client = client;
+    }
+    async sendText(text) {
+        await this.#conversation.send(text, ContentTypeText);
+    }
+    async sendTextReply(text) {
+        const reply = {
+            reference: this.#message.id,
+            referenceInboxId: this.#message.senderInboxId,
+            contentType: ContentTypeText,
+            content: text,
+        };
+        await this.#conversation.send(reply, ContentTypeReply);
+    }
+    async getSenderAddress() {
+        const inboxState = await this.#client.preferences.inboxStateFromInboxIds([
+            this.#message.senderInboxId,
+        ]);
+        return inboxState[0].identifiers[0].identifier;
+    }
+    get message() {
+        return this.#message;
+    }
+    get conversation() {
+        return this.#conversation;
+    }
+    get client() {
+        return this.#client;
+    }
+}
+//# sourceMappingURL=AgentContext.js.map

package/dist/core/AgentContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentContext.js","sourceRoot":"","sources":["../../src/core/AgentContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAc,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,MAAM,OAAO,YAAY;IACvB,OAAO,CAAuB;IAC9B,QAAQ,CAA+B;IACvC,aAAa,CAAe;IAE5B,YACE,OAAqC,EACrC,YAA0B,EAC1B,MAA4B;QAE5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY;QAC9B,MAAM,KAAK,GAAU;YACnB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAC3B,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa;YAC7C,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,IAAI;SACd,CAAC;QACF,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,sBAAsB,CAAC;YACvE,IAAI,CAAC,QAAQ,CAAC,aAAa;SAC5B,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACjD,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/core/index.d.ts

@@ -0,0 +1 @@
+export * from "./Agent";

package/dist/core/index.js

@@ -0,0 +1,2 @@
+export * from "./Agent";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/demo.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/demo.js

@@ -0,0 +1,33 @@
+import { ReplyCodec } from "@xmtp/content-type-reply";
+import { Agent } from "./core";
+import { createSigner, createUser, filter as f, withFilter } from "./utils";
+const user = createUser();
+const signer = createSigner(user);
+const agent = await Agent.create(signer, {
+    codecs: [new ReplyCodec()],
+    dbPath: null,
+    env: "dev",
+});
+agent.on("message", (ctx) => {
+    void ctx.conversation.send("First message!");
+});
+agent.on("message", withFilter(f.and(f.notFromSelf, f.textOnly), (ctx) => {
+    void ctx.conversation.send("Goodbye!");
+    agent.stop();
+}));
+agent.on("message", (ctx) => {
+    console.log("Got message:", ctx.message.content);
+});
+const errorHandler = (error) => {
+    console.log("Caught error", error);
+};
+agent.on("error", errorHandler);
+agent.off("error", errorHandler);
+agent.on("start", () => {
+    const address = agent.client.accountIdentifier?.identifier;
+    const env = agent.client.options?.env;
+    const url = `http://xmtp.chat/dm/${address}?env=${env}`;
+    console.log(`We are online: ${url}`);
+});
+void agent.start();
+//# sourceMappingURL=demo.js.map

package/dist/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../src/demo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE5E,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;AAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;IACvC,MAAM,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,KAAK;CACX,CAAC,CAAC;AAEH,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;IAC1B,KAAK,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,EAAE,CACN,SAAS,EACT,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;IACnD,KAAK,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,EAAE,CAAC;AACf,CAAC,CAAC,CACH,CAAC;AAEF,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;IAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,EAAE;IACtC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAEhC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAEjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,iBAAiB,EAAE,UAAU,CAAC;IAC3D,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC;IACtC,MAAM,GAAG,GAAG,uBAAuB,OAAO,QAAQ,GAAG,EAAE,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core";
+export * from "./utils";

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/utils/filter.d.ts

@@ -0,0 +1,48 @@
+import type { Client, DecodedMessage } from "@xmtp/node-sdk";
+import type { AgentContext } from "@/core/AgentContext";
+/**
+ * Function type for filtering messages based on content and client state.
+ */
+export type MessageFilter<ContentTypes> = (message: DecodedMessage, client: Client<ContentTypes>) => boolean;
+/**
+ * Creates a filter for messages from specific senders
+ *
+ * @param senderInboxId - Single sender ID or array of sender IDs to match
+ * @returns Filter function
+ */
+declare function fromSender<ContentTypes>(senderInboxId: string | string[]): MessageFilter<ContentTypes>;
+/**
+ * Creates a filter that requires all provided filters to pass
+ *
+ * @param filters - Array of filters that must all return true
+ * @returns Filter function
+ */
+declare function and<ContentTypes>(...filters: MessageFilter<ContentTypes>[]): MessageFilter<ContentTypes>;
+/**
+ * Creates a filter that requires at least one provided filter to pass.
+ *
+ * @param filters - Array of filters where at least one must return true
+ * @returns Filter function
+ */
+declare function or<ContentTypes>(...filters: MessageFilter<ContentTypes>[]): MessageFilter<ContentTypes>;
+/**
+ * Creates a filter that inverts the result of another filter.
+ *
+ * @param filter - The filter to negate
+ * @returns Filter function
+ */
+declare function not<ContentTypes>(filter: MessageFilter<ContentTypes>): MessageFilter<ContentTypes>;
+/**
+ * Pre-configured filter instances and factory functions for common filtering scenarios
+ */
+export declare const filter: {
+    notFromSelf: MessageFilter<unknown>;
+    fromSelf: MessageFilter<unknown>;
+    textOnly: MessageFilter<unknown>;
+    fromSender: typeof fromSender;
+    and: typeof and;
+    or: typeof or;
+    not: typeof not;
+};
+export declare const withFilter: <ContentTypes>(filter: MessageFilter<ContentTypes>, listener: (ctx: AgentContext<ContentTypes>) => void) => (ctx: AgentContext<ContentTypes>) => void;
+export {};

package/dist/utils/filter.js

@@ -0,0 +1,109 @@
+import { ContentTypeText } from "@xmtp/content-type-text";
+/**
+ * Creates a filter that excludes messages from the agent itself.
+ *
+ * @returns Filter function
+ */
+function notFromSelf() {
+    return (message, client) => {
+        return message.senderInboxId !== client.inboxId;
+    };
+}
+/**
+ * Creates a filter that includes only messages from the agent itself.
+ *
+ * @returns Filter function
+ */
+function fromSelf() {
+    return (message, client) => {
+        return message.senderInboxId === client.inboxId;
+    };
+}
+/**
+ * Creates a filter that includes only text messages.
+ *
+ * @returns Filter function
+ */
+function textOnly() {
+    return (message) => {
+        return !!message.contentType?.sameAs(ContentTypeText);
+    };
+}
+/**
+ * Creates a filter for messages from specific senders
+ *
+ * @param senderInboxId - Single sender ID or array of sender IDs to match
+ * @returns Filter function
+ */
+function fromSender(senderInboxId) {
+    const senderIds = Array.isArray(senderInboxId)
+        ? senderInboxId
+        : [senderInboxId];
+    return (message) => {
+        return senderIds.includes(message.senderInboxId);
+    };
+}
+/**
+ * Creates a filter that requires all provided filters to pass
+ *
+ * @param filters - Array of filters that must all return true
+ * @returns Filter function
+ */
+function and(...filters) {
+    return (message, client) => {
+        for (const filter of filters) {
+            const result = filter(message, client);
+            if (!result)
+                return false;
+        }
+        return true;
+    };
+}
+/**
+ * Creates a filter that requires at least one provided filter to pass.
+ *
+ * @param filters - Array of filters where at least one must return true
+ * @returns Filter function
+ */
+function or(...filters) {
+    return (message, client) => {
+        for (const filter of filters) {
+            const result = filter(message, client);
+            if (result)
+                return true;
+        }
+        return false;
+    };
+}
+/**
+ * Creates a filter that inverts the result of another filter.
+ *
+ * @param filter - The filter to negate
+ * @returns Filter function
+ */
+function not(filter) {
+    return (message, client) => {
+        return !filter(message, client);
+    };
+}
+/**
+ * Pre-configured filter instances and factory functions for common filtering scenarios
+ */
+export const filter = {
+    // basic filters
+    notFromSelf: notFromSelf(),
+    fromSelf: fromSelf(),
+    textOnly: textOnly(),
+    // factory functions
+    fromSender,
+    // combinators
+    and,
+    or,
+    not,
+};
+export const withFilter = (filter, listener) => (ctx) => {
+    if (filter(ctx.message, ctx.client)) {
+        listener(ctx);
+    }
+};
+//# sourceMappingURL=filter.js.map

package/dist/utils/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/utils/filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAY1D;;;;GAIG;AACH,SAAS,WAAW;IAClB,OAAO,CAAC,OAAuB,EAAE,MAA4B,EAAE,EAAE;QAC/D,OAAO,OAAO,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ;IACf,OAAO,CAAC,OAAuB,EAAE,MAA4B,EAAE,EAAE;QAC/D,OAAO,OAAO,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ;IACf,OAAO,CAAC,OAAuB,EAAE,EAAE;QACjC,OAAO,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CACjB,aAAgC;IAEhC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;QAC5C,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAEpB,OAAO,CAAC,OAAuB,EAAE,EAAE;QACjC,OAAO,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,GAAG,CACV,GAAG,OAAsC;IAEzC,OAAO,CAAC,OAAuB,EAAE,MAA4B,EAAE,EAAE;QAC/D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,EAAE,CACT,GAAG,OAAsC;IAEzC,OAAO,CAAC,OAAuB,EAAE,MAA4B,EAAE,EAAE;QAC/D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,MAAM;gBAAE,OAAO,IAAI,CAAC;QAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,GAAG,CACV,MAAmC;IAEnC,OAAO,CAAC,OAAuB,EAAE,MAA4B,EAAE,EAAE;QAC/D,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,gBAAgB;IAChB,WAAW,EAAE,WAAW,EAAE;IAC1B,QAAQ,EAAE,QAAQ,EAAE;IACpB,QAAQ,EAAE,QAAQ,EAAE;IACpB,oBAAoB;IACpB,UAAU;IACV,cAAc;IACd,GAAG;IACH,EAAE;IACF,GAAG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GACrB,CACE,MAAmC,EACnC,QAAmD,EACnD,EAAE,CACJ,CAAC,GAA+B,EAAE,EAAE;IAClC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;AACH,CAAC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./filter";
+export * from "./user";

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export * from "./filter";
+export * from "./user";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC"}

package/dist/utils/user.d.ts

@@ -0,0 +1,10 @@
+import { type Identifier, type Signer } from "@xmtp/node-sdk";
+import { type Chain, type Hex, type PrivateKeyAccount, type WalletClient } from "viem";
+export type User = {
+    key: Hex;
+    account: PrivateKeyAccount;
+    wallet: WalletClient;
+};
+export declare const createUser: (key?: `0x${string}`, chain?: Chain) => User;
+export declare const createIdentifier: (user: User) => Identifier;
+export declare const createSigner: (user: User) => Signer;

package/dist/utils/user.js

@@ -0,0 +1,35 @@
+import { createWalletClient, http, toBytes, } from "viem";
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+import { sepolia } from "viem/chains";
+export const createUser = (key, chain = sepolia) => {
+    const accountKey = key ?? generatePrivateKey();
+    const account = privateKeyToAccount(accountKey);
+    return {
+        key: accountKey,
+        account,
+        wallet: createWalletClient({
+            account,
+            chain,
+            transport: http(),
+        }),
+    };
+};
+export const createIdentifier = (user) => ({
+    identifier: user.account.address.toLowerCase(),
+    identifierKind: 0 /* IdentifierKind.Ethereum */,
+});
+export const createSigner = (user) => {
+    const identifier = createIdentifier(user);
+    return {
+        type: "EOA",
+        getIdentifier: () => identifier,
+        signMessage: async (message) => {
+            const signature = await user.wallet.signMessage({
+                account: user.account,
+                message,
+            });
+            return toBytes(signature);
+        },
+    };
+};
+//# sourceMappingURL=user.js.map

package/dist/utils/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/utils/user.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,IAAI,EACJ,OAAO,GAKR,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQtC,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,GAAmB,EACnB,QAAe,OAAO,EAChB,EAAE;IACR,MAAM,UAAU,GAAG,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAChD,OAAO;QACL,GAAG,EAAE,UAAU;QACf,OAAO;QACP,MAAM,EAAE,kBAAkB,CAAC;YACzB,OAAO;YACP,KAAK;YACL,SAAS,EAAE,IAAI,EAAE;SAClB,CAAC;KACH,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAAc,EAAE,CAAC,CAAC;IAC3D,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE;IAC9C,cAAc,iCAAyB;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAU,EAAU,EAAE;IACjD,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO;QACL,IAAI,EAAE,KAAK;QACX,aAAa,EAAE,GAAG,EAAE,CAAC,UAAU;QAC/B,WAAW,EAAE,KAAK,EAAE,OAAe,EAAE,EAAE;YACrC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;gBAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO;aACR,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -22,7 +22,7 @@
     "node": ">=20"
   },
   "files": [
-    "dist/src",
+    "dist",
     "!dist/**/*.test.*"
   ],
   "homepage": "https://github.com/xmtp/xmtp-js",
@@ -62,5 +62,5 @@
     "typecheck": "tsc --noEmit"
   },
   "type": "module",
-  "version": "0.0.1"
+  "version": "0.0.2"
 }