@account-kit/signer 4.0.0-alpha.0

package/dist/esm/session/manager.js

@@ -0,0 +1,223 @@
+import EventEmitter from "eventemitter3";
+import { z } from "zod";
+import { createJSONStorage, persist, subscribeWithSelector, } from "zustand/middleware";
+import { createStore } from "zustand/vanilla";
+export const DEFAULT_SESSION_MS = 15 * 60 * 1000;
+export const SessionManagerParamsSchema = z.object({
+    sessionKey: z.string().default("alchemy-signer-session"),
+    storage: z
+        .enum(["localStorage", "sessionStorage"])
+        .default("localStorage")
+        .or(z.custom()),
+    expirationTimeMs: z
+        .number()
+        .default(DEFAULT_SESSION_MS)
+        .describe("The time in milliseconds that a session should last before expiring [default: 15 minutes]"),
+    client: z.custom(),
+});
+export class SessionManager {
+    constructor(params) {
+        Object.defineProperty(this, "sessionKey", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "eventEmitter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "expirationTimeMs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "store", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "getSessionUser", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async () => {
+                const existingSession = this.getSession();
+                if (existingSession == null) {
+                    return null;
+                }
+                switch (existingSession.type) {
+                    case "email": {
+                        const result = await this.client
+                            .completeEmailAuth({
+                            bundle: existingSession.bundle,
+                            orgId: existingSession.user.orgId,
+                        })
+                            .catch((e) => {
+                            console.warn("Failed to load user from session", e);
+                            return null;
+                        });
+                        if (!result) {
+                            this.clearSession();
+                            return null;
+                        }
+                        return result;
+                    }
+                    case "passkey": {
+                        return this.client.lookupUserWithPasskey(existingSession.user);
+                    }
+                    default:
+                        throw new Error("Unknown session type");
+                }
+            }
+        });
+        Object.defineProperty(this, "clearSession", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                this.store.setState({ session: null });
+            }
+        });
+        Object.defineProperty(this, "setTemporarySession", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (session) => {
+                localStorage.setItem(`${this.sessionKey}:temporary`, JSON.stringify(session));
+            }
+        });
+        Object.defineProperty(this, "getTemporarySession", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                const sessionStr = localStorage.getItem(`${this.sessionKey}:temporary`);
+                if (!sessionStr) {
+                    return null;
+                }
+                return JSON.parse(sessionStr);
+            }
+        });
+        Object.defineProperty(this, "on", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (event, listener) => {
+                this.eventEmitter.on(event, listener);
+                return () => this.eventEmitter.removeListener(event, listener);
+            }
+        });
+        Object.defineProperty(this, "getSession", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                const session = this.store.getState().session;
+                if (!session) {
+                    return null;
+                }
+                if (session.expirationDateMs < Date.now()) {
+                    this.store.setState({ session: null });
+                    return null;
+                }
+                return session;
+            }
+        });
+        Object.defineProperty(this, "setSession", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (session) => {
+                this.store.setState({
+                    session: {
+                        ...session,
+                        expirationDateMs: Date.now() + this.expirationTimeMs,
+                    },
+                });
+            }
+        });
+        Object.defineProperty(this, "registerEventListeners", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                this.store.subscribe(({ session }) => session, (session, prevSession) => {
+                    if (session != null && prevSession == null) {
+                        this.eventEmitter.emit("connected", session);
+                    }
+                    else if (session == null && prevSession != null) {
+                        this.eventEmitter.emit("disconnected");
+                    }
+                });
+                this.client.on("disconnected", () => this.clearSession());
+                this.client.on("connectedEmail", (user, bundle) => {
+                    const existingSession = this.getSession();
+                    if (existingSession != null &&
+                        existingSession.type === "email" &&
+                        existingSession.user.userId === user.userId &&
+                        existingSession.bundle === bundle) {
+                        return;
+                    }
+                    this.setSession({ type: "email", user, bundle });
+                });
+                this.client.on("connectedPasskey", (user) => {
+                    const existingSession = this.getSession();
+                    if (existingSession != null &&
+                        existingSession.type === "passkey" &&
+                        existingSession.user.userId === user.userId) {
+                        return;
+                    }
+                    this.setSession({ type: "passkey", user });
+                });
+                window.addEventListener("focus", () => {
+                    this.store.persist.rehydrate();
+                    this.initialize();
+                });
+            }
+        });
+        const { sessionKey, storage: storageType, expirationTimeMs, client, } = SessionManagerParamsSchema.parse(params);
+        this.sessionKey = sessionKey;
+        const storage = typeof storageType === "string"
+            ? storageType === "localStorage"
+                ? localStorage
+                : sessionStorage
+            : storageType;
+        this.expirationTimeMs = expirationTimeMs;
+        this.client = client;
+        this.eventEmitter = new EventEmitter();
+        this.store = createStore(subscribeWithSelector(persist(this.getInitialState, {
+            name: this.sessionKey,
+            storage: createJSONStorage(() => storage),
+        })));
+        this.registerEventListeners();
+    }
+    initialize() {
+        this.getSessionUser()
+            .then((user) => {
+            if (user)
+                this.eventEmitter.emit("connected", this.getSession());
+            else
+                this.eventEmitter.emit("disconnected");
+        })
+            .finally(() => {
+            this.eventEmitter.emit("initialized");
+        });
+    }
+    getInitialState() {
+        return {
+            session: null,
+        };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/esm/session/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/session/manager.ts"],"names":[],"mappings":"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","sourcesContent":["import EventEmitter from \"eventemitter3\";\nimport { z } from \"zod\";\nimport {\n  createJSONStorage,\n  persist,\n  subscribeWithSelector,\n} from \"zustand/middleware\";\nimport { createStore, type Mutate, type StoreApi } from \"zustand/vanilla\";\nimport type { BaseSignerClient } from \"../client/base\";\nimport type { User } from \"../client/types\";\nimport type { Session, SessionManagerEvents } from \"./types\";\n\nexport const DEFAULT_SESSION_MS = 15 * 60 * 1000; // 15 minutes\n\nexport const SessionManagerParamsSchema = z.object({\n  sessionKey: z.string().default(\"alchemy-signer-session\"),\n  storage: z\n    .enum([\"localStorage\", \"sessionStorage\"])\n    .default(\"localStorage\")\n    .or(z.custom<Storage>()),\n  expirationTimeMs: z\n    .number()\n    .default(DEFAULT_SESSION_MS)\n    .describe(\n      \"The time in milliseconds that a session should last before expiring [default: 15 minutes]\"\n    ),\n  client: z.custom<BaseSignerClient>(),\n});\n\nexport type SessionManagerParams = z.input<typeof SessionManagerParamsSchema>;\n\ntype SessionState = {\n  session: Session | null;\n};\n\ntype Store = Mutate<\n  StoreApi<SessionState>,\n  [[\"zustand/subscribeWithSelector\", never], [\"zustand/persist\", SessionState]]\n>;\n\nexport class SessionManager {\n  private sessionKey: string;\n  private client: BaseSignerClient;\n  private eventEmitter: EventEmitter<SessionManagerEvents>;\n  readonly expirationTimeMs: number;\n  private store: Store;\n\n  constructor(params: SessionManagerParams) {\n    const {\n      sessionKey,\n      storage: storageType,\n      expirationTimeMs,\n      client,\n    } = SessionManagerParamsSchema.parse(params);\n    this.sessionKey = sessionKey;\n    const storage =\n      typeof storageType === \"string\"\n        ? storageType === \"localStorage\"\n          ? localStorage\n          : sessionStorage\n        : storageType;\n    this.expirationTimeMs = expirationTimeMs;\n    this.client = client;\n    this.eventEmitter = new EventEmitter<SessionManagerEvents>();\n\n    this.store = createStore(\n      subscribeWithSelector(\n        persist(this.getInitialState, {\n          name: this.sessionKey,\n          storage: createJSONStorage<SessionState>(() => storage),\n        })\n      )\n    );\n\n    this.registerEventListeners();\n  }\n\n  public getSessionUser = async (): Promise<User | null> => {\n    const existingSession = this.getSession();\n    if (existingSession == null) {\n      return null;\n    }\n\n    switch (existingSession.type) {\n      case \"email\": {\n        const result = await this.client\n          .completeEmailAuth({\n            bundle: existingSession.bundle,\n            orgId: existingSession.user.orgId,\n          })\n          .catch((e) => {\n            console.warn(\"Failed to load user from session\", e);\n            return null;\n          });\n\n        if (!result) {\n          this.clearSession();\n          return null;\n        }\n\n        return result;\n      }\n      case \"passkey\": {\n        // we don't need to do much here if we already have a user\n        // this will setup the client with the user context, but\n        // requests still have to be signed by the user on first request\n        // so this is fine\n        return this.client.lookupUserWithPasskey(existingSession.user);\n      }\n      default:\n        throw new Error(\"Unknown session type\");\n    }\n  };\n\n  public clearSession = () => {\n    this.store.setState({ session: null });\n  };\n\n  public setTemporarySession = (session: { orgId: string }) => {\n    // temporary session must be placed in localStorage so that it can be accessed across tabs\n    localStorage.setItem(\n      `${this.sessionKey}:temporary`,\n      JSON.stringify(session)\n    );\n  };\n\n  public getTemporarySession = (): { orgId: string } | null => {\n    // temporary session must be placed in localStorage so that it can be accessed across tabs\n    const sessionStr = localStorage.getItem(`${this.sessionKey}:temporary`);\n\n    if (!sessionStr) {\n      return null;\n    }\n\n    return JSON.parse(sessionStr);\n  };\n\n  on = <E extends keyof SessionManagerEvents>(\n    event: E,\n    listener: SessionManagerEvents[E]\n  ) => {\n    this.eventEmitter.on(event, listener as any);\n\n    return () => this.eventEmitter.removeListener(event, listener as any);\n  };\n\n  private getSession = (): Session | null => {\n    const session = this.store.getState().session;\n\n    if (!session) {\n      return null;\n    }\n\n    /**\n     * TODO: this isn't really good enough\n     * A user's session could be about to expire and we would still return it\n     *\n     * Instead we should check if a session is about to expire and refresh it\n     * We should revisit this later\n     */\n    if (session.expirationDateMs < Date.now()) {\n      this.store.setState({ session: null });\n      return null;\n    }\n\n    return session;\n  };\n\n  private setSession = (\n    session:\n      | Omit<Extract<Session, { type: \"email\" }>, \"expirationDateMs\">\n      | Omit<Extract<Session, { type: \"passkey\" }>, \"expirationDateMs\">\n  ) => {\n    this.store.setState({\n      session: {\n        ...session,\n        expirationDateMs: Date.now() + this.expirationTimeMs,\n      },\n    });\n  };\n\n  public initialize() {\n    this.getSessionUser()\n      .then((user) => {\n        // once we complete auth we can update the state of the session to connected or disconnected\n        if (user) this.eventEmitter.emit(\"connected\", this.getSession()!);\n        else this.eventEmitter.emit(\"disconnected\");\n      })\n      .finally(() => {\n        this.eventEmitter.emit(\"initialized\");\n      });\n  }\n\n  private getInitialState(): SessionState {\n    return {\n      session: null,\n    };\n  }\n\n  private registerEventListeners = () => {\n    this.store.subscribe(\n      ({ session }) => session,\n      (session, prevSession) => {\n        if (session != null && prevSession == null) {\n          this.eventEmitter.emit(\"connected\", session);\n        } else if (session == null && prevSession != null) {\n          this.eventEmitter.emit(\"disconnected\");\n        }\n      }\n    );\n\n    this.client.on(\"disconnected\", () => this.clearSession());\n\n    this.client.on(\"connectedEmail\", (user, bundle) => {\n      const existingSession = this.getSession();\n      if (\n        existingSession != null &&\n        existingSession.type === \"email\" &&\n        existingSession.user.userId === user.userId &&\n        // if the bundle is different, then we've refreshed the session\n        // so we need to reset the session\n        existingSession.bundle === bundle\n      ) {\n        return;\n      }\n\n      this.setSession({ type: \"email\", user, bundle });\n    });\n\n    this.client.on(\"connectedPasskey\", (user) => {\n      const existingSession = this.getSession();\n      if (\n        existingSession != null &&\n        existingSession.type === \"passkey\" &&\n        existingSession.user.userId === user.userId\n      ) {\n        return;\n      }\n\n      this.setSession({ type: \"passkey\", user });\n    });\n\n    // sync local state if persisted state has changed from another tab\n    window.addEventListener(\"focus\", () => {\n      this.store.persist.rehydrate();\n      this.initialize();\n    });\n  };\n}\n"]}

package/dist/esm/session/types.d.ts

@@ -0,0 +1,16 @@
+import type { User } from "../client/types";
+export type Session = {
+    type: "email";
+    bundle: string;
+    expirationDateMs: number;
+    user: User;
+} | {
+    type: "passkey";
+    user: User;
+    expirationDateMs: number;
+};
+export type SessionManagerEvents = {
+    connected(session: Session): void;
+    disconnected(): void;
+    initialized(): void;
+};

package/dist/esm/session/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/session/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { User } from \"../client/types\";\n\nexport type Session =\n  | {\n      type: \"email\";\n      bundle: string;\n      expirationDateMs: number;\n      user: User;\n    }\n  | { type: \"passkey\"; user: User; expirationDateMs: number };\n\nexport type SessionManagerEvents = {\n  connected(session: Session): void;\n  disconnected(): void;\n  initialized(): void;\n};\n"]}

package/dist/esm/signer.d.ts

@@ -0,0 +1,262 @@
+import { z } from "zod";
+import { BaseAlchemySigner } from "./base.js";
+import { AlchemySignerWebClient } from "./client/index.js";
+import type { CredentialCreationOptionOverrides } from "./client/types.js";
+export type AuthParams = {
+    type: "email";
+    email: string;
+    redirectParams?: URLSearchParams;
+} | {
+    type: "email";
+    bundle: string;
+    orgId?: string;
+} | {
+    type: "passkey";
+    createNew: false;
+} | {
+    type: "passkey";
+    createNew: true;
+    username: string;
+    creationOpts?: CredentialCreationOptionOverrides;
+};
+export declare const AlchemySignerParamsSchema: z.ZodObject<{
+    client: z.ZodUnion<[z.ZodType<AlchemySignerWebClient, z.ZodTypeDef, AlchemySignerWebClient>, z.ZodObject<{
+        connection: z.ZodUnion<[z.ZodObject<{
+            rpcUrl: z.ZodOptional<z.ZodNever>;
+            apiKey: z.ZodString;
+            jwt: z.ZodOptional<z.ZodNever>;
+        }, "strip", z.ZodTypeAny, {
+            apiKey: string;
+            rpcUrl?: undefined;
+            jwt?: undefined;
+        }, {
+            apiKey: string;
+            rpcUrl?: undefined;
+            jwt?: undefined;
+        }>, z.ZodObject<{
+            rpcUrl: z.ZodOptional<z.ZodNever>;
+            apiKey: z.ZodOptional<z.ZodNever>;
+            jwt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            jwt: string;
+            rpcUrl?: undefined;
+            apiKey?: undefined;
+        }, {
+            jwt: string;
+            rpcUrl?: undefined;
+            apiKey?: undefined;
+        }>, z.ZodObject<{
+            rpcUrl: z.ZodString;
+            apiKey: z.ZodOptional<z.ZodNever>;
+            jwt: z.ZodOptional<z.ZodNever>;
+        }, "strip", z.ZodTypeAny, {
+            rpcUrl: string;
+            apiKey?: undefined;
+            jwt?: undefined;
+        }, {
+            rpcUrl: string;
+            apiKey?: undefined;
+            jwt?: undefined;
+        }>, z.ZodObject<{
+            rpcUrl: z.ZodString;
+            apiKey: z.ZodOptional<z.ZodNever>;
+            jwt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            rpcUrl: string;
+            jwt: string;
+            apiKey?: undefined;
+        }, {
+            rpcUrl: string;
+            jwt: string;
+            apiKey?: undefined;
+        }>]>;
+        iframeConfig: z.ZodObject<{
+            iframeElementId: z.ZodDefault<z.ZodString>;
+            iframeContainerId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            iframeElementId: string;
+            iframeContainerId: string;
+        }, {
+            iframeContainerId: string;
+            iframeElementId?: string | undefined;
+        }>;
+        rpId: z.ZodOptional<z.ZodString>;
+        rootOrgId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        connection: {
+            apiKey: string;
+            rpcUrl?: undefined;
+            jwt?: undefined;
+        } | {
+            jwt: string;
+            rpcUrl?: undefined;
+            apiKey?: undefined;
+        } | {
+            rpcUrl: string;
+            apiKey?: undefined;
+            jwt?: undefined;
+        } | {
+            rpcUrl: string;
+            jwt: string;
+            apiKey?: undefined;
+        };
+        rootOrgId: string;
+        iframeConfig: {
+            iframeElementId: string;
+            iframeContainerId: string;
+        };
+        rpId?: string | undefined;
+    }, {
+        connection: {
+            apiKey: string;
+            rpcUrl?: undefined;
+            jwt?: undefined;
+        } | {
+            jwt: string;
+            rpcUrl?: undefined;
+            apiKey?: undefined;
+        } | {
+            rpcUrl: string;
+            apiKey?: undefined;
+            jwt?: undefined;
+        } | {
+            rpcUrl: string;
+            jwt: string;
+            apiKey?: undefined;
+        };
+        iframeConfig: {
+            iframeContainerId: string;
+            iframeElementId?: string | undefined;
+        };
+        rpId?: string | undefined;
+        rootOrgId?: string | undefined;
+    }>]>;
+    sessionConfig: z.ZodOptional<z.ZodObject<Omit<{
+        sessionKey: z.ZodDefault<z.ZodString>;
+        storage: z.ZodUnion<[z.ZodDefault<z.ZodEnum<["localStorage", "sessionStorage"]>>, z.ZodType<Storage, z.ZodTypeDef, Storage>]>;
+        expirationTimeMs: z.ZodDefault<z.ZodNumber>;
+        client: z.ZodType<import("./index.js").BaseSignerClient<unknown>, z.ZodTypeDef, import("./index.js").BaseSignerClient<unknown>>;
+    }, "client">, "strip", z.ZodTypeAny, {
+        sessionKey: string;
+        storage: ("localStorage" | "sessionStorage" | Storage) & ("localStorage" | "sessionStorage" | Storage | undefined);
+        expirationTimeMs: number;
+    }, {
+        sessionKey?: string | undefined;
+        storage?: "localStorage" | "sessionStorage" | Storage | undefined;
+        expirationTimeMs?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    client: ({
+        connection: {
+            apiKey: string;
+            rpcUrl?: undefined;
+            jwt?: undefined;
+        } | {
+            jwt: string;
+            rpcUrl?: undefined;
+            apiKey?: undefined;
+        } | {
+            rpcUrl: string;
+            apiKey?: undefined;
+            jwt?: undefined;
+        } | {
+            rpcUrl: string;
+            jwt: string;
+            apiKey?: undefined;
+        };
+        rootOrgId: string;
+        iframeConfig: {
+            iframeElementId: string;
+            iframeContainerId: string;
+        };
+        rpId?: string | undefined;
+    } | AlchemySignerWebClient) & ({
+        connection: {
+            apiKey: string;
+            rpcUrl?: undefined;
+            jwt?: undefined;
+        } | {
+            jwt: string;
+            rpcUrl?: undefined;
+            apiKey?: undefined;
+        } | {
+            rpcUrl: string;
+            apiKey?: undefined;
+            jwt?: undefined;
+        } | {
+            rpcUrl: string;
+            jwt: string;
+            apiKey?: undefined;
+        };
+        rootOrgId: string;
+        iframeConfig: {
+            iframeElementId: string;
+            iframeContainerId: string;
+        };
+        rpId?: string | undefined;
+    } | AlchemySignerWebClient | undefined);
+    sessionConfig?: {
+        sessionKey: string;
+        storage: ("localStorage" | "sessionStorage" | Storage) & ("localStorage" | "sessionStorage" | Storage | undefined);
+        expirationTimeMs: number;
+    } | undefined;
+}, {
+    client: ({
+        connection: {
+            apiKey: string;
+            rpcUrl?: undefined;
+            jwt?: undefined;
+        } | {
+            jwt: string;
+            rpcUrl?: undefined;
+            apiKey?: undefined;
+        } | {
+            rpcUrl: string;
+            apiKey?: undefined;
+            jwt?: undefined;
+        } | {
+            rpcUrl: string;
+            jwt: string;
+            apiKey?: undefined;
+        };
+        iframeConfig: {
+            iframeContainerId: string;
+            iframeElementId?: string | undefined;
+        };
+        rpId?: string | undefined;
+        rootOrgId?: string | undefined;
+    } | AlchemySignerWebClient) & ({
+        connection: {
+            apiKey: string;
+            rpcUrl?: undefined;
+            jwt?: undefined;
+        } | {
+            jwt: string;
+            rpcUrl?: undefined;
+            apiKey?: undefined;
+        } | {
+            rpcUrl: string;
+            apiKey?: undefined;
+            jwt?: undefined;
+        } | {
+            rpcUrl: string;
+            jwt: string;
+            apiKey?: undefined;
+        };
+        iframeConfig: {
+            iframeContainerId: string;
+            iframeElementId?: string | undefined;
+        };
+        rpId?: string | undefined;
+        rootOrgId?: string | undefined;
+    } | AlchemySignerWebClient | undefined);
+    sessionConfig?: {
+        sessionKey?: string | undefined;
+        storage?: "localStorage" | "sessionStorage" | Storage | undefined;
+        expirationTimeMs?: number | undefined;
+    } | undefined;
+}>;
+export type AlchemySignerParams = z.input<typeof AlchemySignerParamsSchema>;
+export declare class AlchemyWebSigner extends BaseAlchemySigner<AlchemySignerWebClient> {
+    constructor(params_: AlchemySignerParams);
+}

package/dist/esm/signer.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { BaseAlchemySigner } from "./base.js";
+import { AlchemySignerClientParamsSchema, AlchemySignerWebClient, } from "./client/index.js";
+import { SessionManagerParamsSchema } from "./session/manager.js";
+export const AlchemySignerParamsSchema = z
+    .object({
+    client: z
+        .custom()
+        .or(AlchemySignerClientParamsSchema),
+})
+    .extend({
+    sessionConfig: SessionManagerParamsSchema.omit({ client: true }).optional(),
+});
+export class AlchemyWebSigner extends BaseAlchemySigner {
+    constructor(params_) {
+        const { sessionConfig, ...params } = AlchemySignerParamsSchema.parse(params_);
+        let client;
+        if ("connection" in params.client) {
+            client = new AlchemySignerWebClient(params.client);
+        }
+        else {
+            client = params.client;
+        }
+        super({
+            client,
+            sessionConfig,
+        });
+    }
+}
+//# sourceMappingURL=signer.js.map

package/dist/esm/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../../src/signer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAgBlE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,MAAM,EAAE,CAAC;SACN,MAAM,EAA0B;SAChC,EAAE,CAAC,+BAA+B,CAAC;CACvC,CAAC;KACD,MAAM,CAAC;IACN,aAAa,EAAE,0BAA0B,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC5E,CAAC,CAAC;AAOL,MAAM,OAAO,gBAAiB,SAAQ,iBAAyC;IAC7E,YAAY,OAA4B;QACtC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,GAChC,yBAAyB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,MAA8B,CAAC;QACnC,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,GAAG,IAAI,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,CAAC;QACD,KAAK,CAAC;YACJ,MAAM;YACN,aAAa;SACd,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { z } from \"zod\";\nimport { BaseAlchemySigner } from \"./base.js\";\nimport {\n  AlchemySignerClientParamsSchema,\n  AlchemySignerWebClient,\n} from \"./client/index.js\";\nimport type { CredentialCreationOptionOverrides } from \"./client/types.js\";\nimport { SessionManagerParamsSchema } from \"./session/manager.js\";\n\nexport type AuthParams =\n  | { type: \"email\"; email: string; redirectParams?: URLSearchParams }\n  | { type: \"email\"; bundle: string; orgId?: string }\n  | {\n      type: \"passkey\";\n      createNew: false;\n    }\n  | {\n      type: \"passkey\";\n      createNew: true;\n      username: string;\n      creationOpts?: CredentialCreationOptionOverrides;\n    };\n\nexport const AlchemySignerParamsSchema = z\n  .object({\n    client: z\n      .custom<AlchemySignerWebClient>()\n      .or(AlchemySignerClientParamsSchema),\n  })\n  .extend({\n    sessionConfig: SessionManagerParamsSchema.omit({ client: true }).optional(),\n  });\n\nexport type AlchemySignerParams = z.input<typeof AlchemySignerParamsSchema>;\n\n/**\n * A SmartAccountSigner that can be used with any SmartContractAccount\n */\nexport class AlchemyWebSigner extends BaseAlchemySigner<AlchemySignerWebClient> {\n  constructor(params_: AlchemySignerParams) {\n    const { sessionConfig, ...params } =\n      AlchemySignerParamsSchema.parse(params_);\n\n    let client: AlchemySignerWebClient;\n    if (\"connection\" in params.client) {\n      client = new AlchemySignerWebClient(params.client);\n    } else {\n      client = params.client;\n    }\n    super({\n      client,\n      sessionConfig,\n    });\n  }\n}\n"]}

package/dist/esm/types.d.ts

@@ -0,0 +1,14 @@
+import type { User } from "./client/types";
+export type AlchemySignerEvents = {
+    connected(user: User): void;
+    disconnected(): void;
+    statusChanged(status: AlchemySignerStatus): void;
+};
+export type AlchemySignerEvent = keyof AlchemySignerEvents;
+export declare enum AlchemySignerStatus {
+    INITIALIZING = "INITIALIZING",
+    CONNECTED = "CONNECTED",
+    DISCONNECTED = "DISCONNECTED",
+    AUTHENTICATING = "AUTHENTICATING",
+    AWAITING_EMAIL_AUTH = "AWAITING_EMAIL_AUTH"
+}

package/dist/esm/types.js

@@ -0,0 +1,9 @@
+export var AlchemySignerStatus;
+(function (AlchemySignerStatus) {
+    AlchemySignerStatus["INITIALIZING"] = "INITIALIZING";
+    AlchemySignerStatus["CONNECTED"] = "CONNECTED";
+    AlchemySignerStatus["DISCONNECTED"] = "DISCONNECTED";
+    AlchemySignerStatus["AUTHENTICATING"] = "AUTHENTICATING";
+    AlchemySignerStatus["AWAITING_EMAIL_AUTH"] = "AWAITING_EMAIL_AUTH";
+})(AlchemySignerStatus || (AlchemySignerStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAUA,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,oDAA6B,CAAA;IAC7B,8CAAuB,CAAA;IACvB,oDAA6B,CAAA;IAC7B,wDAAiC,CAAA;IACjC,kEAA2C,CAAA;AAC7C,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B","sourcesContent":["import type { User } from \"./client/types\";\n\nexport type AlchemySignerEvents = {\n  connected(user: User): void;\n  disconnected(): void;\n  statusChanged(status: AlchemySignerStatus): void;\n};\n\nexport type AlchemySignerEvent = keyof AlchemySignerEvents;\n\nexport enum AlchemySignerStatus {\n  INITIALIZING = \"INITIALIZING\",\n  CONNECTED = \"CONNECTED\",\n  DISCONNECTED = \"DISCONNECTED\",\n  AUTHENTICATING = \"AUTHENTICATING\",\n  AWAITING_EMAIL_AUTH = \"AWAITING_EMAIL_AUTH\",\n}\n"]}

package/dist/esm/utils/base64UrlEncode.d.ts

@@ -0,0 +1 @@
+export declare const base64UrlEncode: (challenge: ArrayBuffer) => string;

package/dist/esm/utils/base64UrlEncode.js

@@ -0,0 +1,8 @@
+export const base64UrlEncode = (challenge) => {
+    return Buffer.from(challenge)
+        .toString("base64")
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=/g, "");
+};
+//# sourceMappingURL=base64UrlEncode.js.map

package/dist/esm/utils/base64UrlEncode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64UrlEncode.js","sourceRoot":"","sources":["../../../src/utils/base64UrlEncode.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAsB,EAAU,EAAE;IAChE,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;SAC1B,QAAQ,CAAC,QAAQ,CAAC;SAClB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACvB,CAAC,CAAC","sourcesContent":["export const base64UrlEncode = (challenge: ArrayBuffer): string => {\n  return Buffer.from(challenge)\n    .toString(\"base64\")\n    .replace(/\\+/g, \"-\")\n    .replace(/\\//g, \"_\")\n    .replace(/=/g, \"\");\n};\n"]}

package/dist/esm/utils/generateRandomBuffer.d.ts

@@ -0,0 +1 @@
+export declare const generateRandomBuffer: () => ArrayBuffer;

package/dist/esm/utils/generateRandomBuffer.js

@@ -0,0 +1,6 @@
+export const generateRandomBuffer = () => {
+    const arr = new Uint8Array(32);
+    crypto.getRandomValues(arr);
+    return arr.buffer;
+};
+//# sourceMappingURL=generateRandomBuffer.js.map

package/dist/esm/utils/generateRandomBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRandomBuffer.js","sourceRoot":"","sources":["../../../src/utils/generateRandomBuffer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAgB,EAAE;IACpD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;IAC/B,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC,CAAC","sourcesContent":["export const generateRandomBuffer = (): ArrayBuffer => {\n  const arr = new Uint8Array(32);\n  crypto.getRandomValues(arr);\n  return arr.buffer;\n};\n"]}

package/dist/esm/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "4.0.0-alpha.0";

package/dist/esm/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "4.0.0-alpha.0";
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"4.0.0-alpha.0\";\n"]}