@lit-protocol/vincent-app-sdk 0.0.4-mma

package/dist/src/utils/delegation.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDelegatorsAgentPkpAddresses = getDelegatorsAgentPkpAddresses;
+const vincent_contracts_sdk_1 = require("@lit-protocol/vincent-contracts-sdk");
+/** Get a (paginated) list of delegator agent PKPs for a specific app version
+ *
+ * See documentation at {@link vincent-contracts-sdk!getDelegatedPkpEthAddresses | vincent-contracts-sdk/getDelegatedPkpEthAddresses}
+ */
+async function getDelegatorsAgentPkpAddresses(params) {
+    const { appId, appVersion, signer, pageOpts } = params;
+    const contractClient = (0, vincent_contracts_sdk_1.getClient)({ signer });
+    return await contractClient.getDelegatedPkpEthAddresses({
+        appId,
+        version: appVersion,
+        pageOpts,
+    });
+}
+//# sourceMappingURL=delegation.js.map

package/dist/src/utils/delegation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.js","sourceRoot":"","sources":["../../../src/utils/delegation.ts"],"names":[],"mappings":";;AAQA,wEASC;AAjBD,+EAAgE;AAIhE;;;GAGG;AACI,KAAK,UAAU,8BAA8B,CAAC,MAAoC;IACvF,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEvD,MAAM,cAAc,GAAG,IAAA,iCAAS,EAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,MAAM,cAAc,CAAC,2BAA2B,CAAC;QACtD,KAAK;QACL,OAAO,EAAE,UAAU;QACnB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/dist/src/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { getDelegatorsAgentPkpAddresses } from './delegation';
+export type { GetDelegatorsAgentPkpsParams } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE9D,YAAY,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC"}

package/dist/src/utils/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDelegatorsAgentPkpAddresses = void 0;
+var delegation_1 = require("./delegation");
+Object.defineProperty(exports, "getDelegatorsAgentPkpAddresses", { enumerable: true, get: function () { return delegation_1.getDelegatorsAgentPkpAddresses; } });
+//# sourceMappingURL=index.js.map

package/dist/src/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,2CAA8D;AAArD,4HAAA,8BAA8B,OAAA"}

package/dist/src/utils/typedocRoot.d.ts

@@ -0,0 +1,7 @@
+/** Utility functions for interacting with the Vincent delegation backend
+ *
+ * @module utils
+ * @packageDocumentation
+ */
+export { getDelegatorsAgentPkpAddresses } from './delegation';
+//# sourceMappingURL=typedocRoot.d.ts.map

package/dist/src/utils/typedocRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedocRoot.d.ts","sourceRoot":"","sources":["../../../src/utils/typedocRoot.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/utils/typedocRoot.js

@@ -0,0 +1,13 @@
+"use strict";
+// This file exists because the function params and options are inlined and expanded, and delegated to the docs in the contracts-sdk
+// We don't want them to be 'root-level' exports for Typedoc purpose, or they appear under an 'Other' category and are not navigable
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDelegatorsAgentPkpAddresses = void 0;
+/** Utility functions for interacting with the Vincent delegation backend
+ *
+ * @module utils
+ * @packageDocumentation
+ */
+var delegation_1 = require("./delegation");
+Object.defineProperty(exports, "getDelegatorsAgentPkpAddresses", { enumerable: true, get: function () { return delegation_1.getDelegatorsAgentPkpAddresses; } });
+//# sourceMappingURL=typedocRoot.js.map

package/dist/src/utils/typedocRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedocRoot.js","sourceRoot":"","sources":["../../../src/utils/typedocRoot.ts"],"names":[],"mappings":";AAAA,oIAAoI;AACpI,oIAAoI;;;AAEpI;;;;GAIG;AAEH,2CAA8D;AAArD,4HAAA,8BAA8B,OAAA"}

package/dist/src/utils/types.d.ts

@@ -0,0 +1,15 @@
+import type { Signer } from 'ethers';
+/**
+ * @inline
+ * @expand
+ */
+export interface GetDelegatorsAgentPkpsParams {
+    appId: number;
+    appVersion: number;
+    signer: Signer;
+    pageOpts?: {
+        offset?: number;
+        limit?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD"}

package/dist/src/utils/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":""}

package/dist/src/webAuthClient/app.d.ts

@@ -0,0 +1,7 @@
+import type { WebAuthClientConfig, WebAuthClient } from './types';
+/** Create a new {@link WebAuthClient} instance.
+ *
+ * - `appId` is the numeric app ID displayed for your app on the Vincent Dashboard
+ * */
+export declare const getWebAuthClient: (appClientConfig: WebAuthClientConfig) => WebAuthClient;
+//# sourceMappingURL=app.d.ts.map

package/dist/src/webAuthClient/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/webAuthClient/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,aAAa,EACd,MAAM,SAAS,CAAC;AAsBjB;;;KAGK;AACL,eAAO,MAAM,gBAAgB,GAAI,iBAAiB,mBAAmB,KAAG,aA6BvE,CAAC"}

package/dist/src/webAuthClient/app.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWebAuthClient = void 0;
+const constants_1 = require("./constants");
+const internal_1 = require("./internal");
+const { isLoginUri, composeDelegationAuthUrl, removeSearchParam, decodeVincentJWTFromUri } = internal_1.uriHelpers;
+const redirectToDelegationAuthPage = ({ appId, redirectUri, delegationAuthPageUrl, }) => window.open(composeDelegationAuthUrl(appId, redirectUri, delegationAuthPageUrl).toString(), '_self');
+/** Create a new {@link WebAuthClient} instance.
+ *
+ * - `appId` is the numeric app ID displayed for your app on the Vincent Dashboard
+ * */
+const getWebAuthClient = (appClientConfig) => {
+    const { appId } = appClientConfig;
+    return {
+        redirectToDelegationAuthPage: (redirectDelegationAuthPageConfig) => {
+            const { delegationAuthPageUrl, redirectUri } = redirectDelegationAuthPageConfig;
+            redirectToDelegationAuthPage({
+                appId,
+                delegationAuthPageUrl,
+                redirectUri,
+            });
+        },
+        isLogin: () => isLoginUri(window.location.href),
+        decodeVincentLoginJWT: (expectedAudience) => decodeVincentJWTFromUri({
+            uri: window.location.href,
+            expectedAudience: expectedAudience,
+            requiredAppId: appId,
+        }),
+        removeLoginJWTFromURI: () => {
+            const urlWithoutJWTSearchParam = removeSearchParam({
+                paramName: constants_1.JWT_URL_KEY,
+                uri: window.location.href,
+            });
+            window.history.replaceState({}, document.title, urlWithoutJWTSearchParam);
+        },
+    };
+};
+exports.getWebAuthClient = getWebAuthClient;
+//# sourceMappingURL=app.js.map

package/dist/src/webAuthClient/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../src/webAuthClient/app.ts"],"names":[],"mappings":";;;AAMA,2CAA0C;AAC1C,yCAAwC;AAExC,MAAM,EAAE,UAAU,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,GACxF,qBAAU,CAAC;AAEb,MAAM,4BAA4B,GAAG,CAAC,EACpC,KAAK,EACL,WAAW,EACX,qBAAqB,GAKtB,EAAE,EAAE,CACH,MAAM,CAAC,IAAI,CACT,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC,QAAQ,EAAE,EAC9E,OAAO,CACR,CAAC;AAEJ;;;KAGK;AACE,MAAM,gBAAgB,GAAG,CAAC,eAAoC,EAAiB,EAAE;IACtF,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,CAAC;IAElC,OAAO;QACL,4BAA4B,EAAE,CAC5B,gCAAuE,EACvE,EAAE;YACF,MAAM,EAAE,qBAAqB,EAAE,WAAW,EAAE,GAAG,gCAAgC,CAAC;YAChF,4BAA4B,CAAC;gBAC3B,KAAK;gBACL,qBAAqB;gBACrB,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC/C,qBAAqB,EAAE,CAAC,gBAAwB,EAAE,EAAE,CAClD,uBAAuB,CAAC;YACtB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;YACzB,gBAAgB,EAAE,gBAAgB;YAClC,aAAa,EAAE,KAAK;SACrB,CAAC;QACJ,qBAAqB,EAAE,GAAG,EAAE;YAC1B,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;gBACjD,SAAS,EAAE,uBAAW;gBACtB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;aAC1B,CAAC,CAAC;YACH,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AA7BW,QAAA,gBAAgB,oBA6B3B"}

package/dist/src/webAuthClient/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const PRODUCTION_VINCENT_DASHBOARD_URL = "https://dashboard.heyvincent.ai/";
+export declare const JWT_URL_KEY = "jwt";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/webAuthClient/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/webAuthClient/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gCAAgC,qCAAqC,CAAC;AACnF,eAAO,MAAM,WAAW,QAAQ,CAAC"}

package/dist/src/webAuthClient/constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JWT_URL_KEY = exports.PRODUCTION_VINCENT_DASHBOARD_URL = void 0;
+exports.PRODUCTION_VINCENT_DASHBOARD_URL = 'https://dashboard.heyvincent.ai/';
+exports.JWT_URL_KEY = 'jwt';
+//# sourceMappingURL=constants.js.map

package/dist/src/webAuthClient/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/webAuthClient/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,gCAAgC,GAAG,kCAAkC,CAAC;AACtE,QAAA,WAAW,GAAG,KAAK,CAAC"}

package/dist/src/webAuthClient/index.d.ts

@@ -0,0 +1,13 @@
+/** The webAuthClient module contains methods and types that are used to implement authentication in Vincent web apps
+ * Authentication is handled via redirects to the Vincent dashboard portal that return JWTs with authentication information
+ * that can be used to secure your backend Vincent app UI.
+ *
+ * ```typescript
+ * import { getWebAuthClient } from '@lit-protocol/vincent-app-sdk/webAuthClient';
+ * ```
+ * @packageDocumentation
+ */
+import { getWebAuthClient } from './app';
+export { getWebAuthClient };
+export type { WebAuthClient, WebAuthClientConfig, RedirectToVincentDelegationPageParams, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/webAuthClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/webAuthClient/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,qCAAqC,GACtC,MAAM,SAAS,CAAC"}

package/dist/src/webAuthClient/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getWebAuthClient = void 0;
+/** The webAuthClient module contains methods and types that are used to implement authentication in Vincent web apps
+ * Authentication is handled via redirects to the Vincent dashboard portal that return JWTs with authentication information
+ * that can be used to secure your backend Vincent app UI.
+ *
+ * ```typescript
+ * import { getWebAuthClient } from '@lit-protocol/vincent-app-sdk/webAuthClient';
+ * ```
+ * @packageDocumentation
+ */
+const app_1 = require("./app");
+Object.defineProperty(exports, "getWebAuthClient", { enumerable: true, get: function () { return app_1.getWebAuthClient; } });
+//# sourceMappingURL=index.js.map

package/dist/src/webAuthClient/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/webAuthClient/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,+BAAyC;AAEhC,iGAFA,sBAAgB,OAEA"}

package/dist/src/webAuthClient/internal/index.d.ts

@@ -0,0 +1,3 @@
+import * as uriHelpers from './uriHelpers';
+export { uriHelpers };
+//# sourceMappingURL=index.d.ts.map

package/dist/src/webAuthClient/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/webAuthClient/internal/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/src/webAuthClient/internal/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uriHelpers = void 0;
+const tslib_1 = require("tslib");
+const uriHelpers = tslib_1.__importStar(require("./uriHelpers"));
+exports.uriHelpers = uriHelpers;
+//# sourceMappingURL=index.js.map

package/dist/src/webAuthClient/internal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/webAuthClient/internal/index.ts"],"names":[],"mappings":";;;;AAAA,iEAA2C;AAElC,gCAAU"}

package/dist/src/webAuthClient/internal/uriHelpers.d.ts

@@ -0,0 +1,15 @@
+export declare const decodeVincentJWTFromUri: ({ uri, expectedAudience, requiredAppId, }: {
+    uri: string;
+    expectedAudience: string;
+    requiredAppId: number;
+}) => {
+    decodedJWT: import("../../jwt").VincentJWTAppSpecific;
+    jwtStr: string;
+} | null;
+export declare const isLoginUri: (uri: string) => boolean;
+export declare function composeDelegationAuthUrl(appId: number, redirectUri: string, delegationAuthPageUrl?: string): URL;
+export declare const removeSearchParam: ({ paramName, uri, }: {
+    paramName: string;
+    uri: string;
+}) => string;
+//# sourceMappingURL=uriHelpers.d.ts.map

package/dist/src/webAuthClient/internal/uriHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uriHelpers.d.ts","sourceRoot":"","sources":["../../../../src/webAuthClient/internal/uriHelpers.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB,GAAI,2CAIrC;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;;;QAcA,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,YAKrC,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,qBAAqB,CAAC,EAAE,MAAM,OAM/B;AAED,eAAO,MAAM,iBAAiB,GAAI,qBAG/B;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,KAAG,MAKH,CAAC"}

package/dist/src/webAuthClient/internal/uriHelpers.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeSearchParam = exports.isLoginUri = exports.decodeVincentJWTFromUri = void 0;
+exports.composeDelegationAuthUrl = composeDelegationAuthUrl;
+const validate_1 = require("../../jwt/core/validate");
+const constants_1 = require("../constants");
+const decodeVincentJWTFromUri = ({ uri, expectedAudience, requiredAppId, }) => {
+    const url = new URL(uri);
+    const jwt = url.searchParams.get(constants_1.JWT_URL_KEY);
+    if (!jwt) {
+        return null;
+    }
+    try {
+        return { decodedJWT: (0, validate_1.verify)({ jwt, expectedAudience, requiredAppId }), jwtStr: jwt };
+    }
+    catch (error) {
+        // Explicitly throw if the JWT doesn't contain the required appId
+        throw new Error(`Failed to decode JWT: ${error.message}`);
+    }
+};
+exports.decodeVincentJWTFromUri = decodeVincentJWTFromUri;
+const isLoginUri = (uri) => {
+    const url = new URL(uri);
+    const loginJwt = url.searchParams.get(constants_1.JWT_URL_KEY);
+    return !!loginJwt;
+};
+exports.isLoginUri = isLoginUri;
+function composeDelegationAuthUrl(appId, redirectUri, delegationAuthPageUrl) {
+    return new URL(`/user/consent/appId/${String(appId)}?redirectUri=${redirectUri}`, delegationAuthPageUrl || constants_1.PRODUCTION_VINCENT_DASHBOARD_URL);
+}
+const removeSearchParam = ({ paramName, uri, }) => {
+    const url = new URL(uri);
+    url.searchParams.delete(paramName);
+    // Update the browser's history without reloading the page
+    return url.toString();
+};
+exports.removeSearchParam = removeSearchParam;
+//# sourceMappingURL=uriHelpers.js.map

package/dist/src/webAuthClient/internal/uriHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uriHelpers.js","sourceRoot":"","sources":["../../../../src/webAuthClient/internal/uriHelpers.ts"],"names":[],"mappings":";;;AAkCA,4DASC;AA3CD,sDAAiD;AACjD,4CAA6E;AAEtE,MAAM,uBAAuB,GAAG,CAAC,EACtC,GAAG,EACH,gBAAgB,EAChB,aAAa,GAKd,EAAE,EAAE;IACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAW,CAAC,CAAC;IAE9C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,EAAE,UAAU,EAAE,IAAA,iBAAM,EAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACvF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iEAAiE;QACjE,MAAM,IAAI,KAAK,CAAC,yBAA0B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC,CAAC;AAtBW,QAAA,uBAAuB,2BAsBlC;AAEK,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE;IACxC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,uBAAW,CAAC,CAAC;IAEnD,OAAO,CAAC,CAAC,QAAQ,CAAC;AACpB,CAAC,CAAC;AALW,QAAA,UAAU,cAKrB;AAEF,SAAgB,wBAAwB,CACtC,KAAa,EACb,WAAmB,EACnB,qBAA8B;IAE9B,OAAO,IAAI,GAAG,CACZ,uBAAuB,MAAM,CAAC,KAAK,CAAC,gBAAgB,WAAW,EAAE,EACjE,qBAAqB,IAAI,4CAAgC,CAC1D,CAAC;AACJ,CAAC;AAEM,MAAM,iBAAiB,GAAG,CAAC,EAChC,SAAS,EACT,GAAG,GAIJ,EAAU,EAAE;IACX,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,0DAA0D;IAC1D,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC,CAAC;AAXW,QAAA,iBAAiB,qBAW5B"}

package/dist/src/webAuthClient/types.d.ts

@@ -0,0 +1,109 @@
+import type { VincentJWTAppSpecific } from '../jwt/types';
+export interface WebAuthClientConfig {
+    appId: number;
+}
+export interface RedirectToVincentDelegationPageParams {
+    redirectUri: string;
+    /** This only needs to be provided for local development with the entire stack
+     * @hidden
+     * */
+    delegationAuthPageUrl?: string;
+}
+/**
+ * The Vincent Web Application Client is used in web apps to handle interactions with the Vincent app portal.
+ *
+ * - Delegation authorization page redirection
+ * - Authentication helpers that are browser specific
+ *
+ */
+export interface WebAuthClient {
+    /**
+     * Redirects the user to the Vincent delegation auth page.
+     *
+     * If the user approves your app permissions, they will be redirected back to the `redirectUri`.
+     *
+     * Use {@link WebAuthClient.isLogin} to detect if a user has just opened your app via the delegation auth page
+     *
+     * Use {@link WebAuthClient.decodeVincentLoginJWT} to decode and verify the {@link VincentJWT} from the page URI, and store it for later usage
+     *
+     * NOTE: You must register the `redirectUri` on your Vincent app for it to be considered a valid redirect target
+     *
+     * @example
+     * ```typescript
+     * import { getWebAuthClient } from '@lit-protocol/vincent-app-sdk/webAuthClient';
+     *
+     * const vincentAppClient = getWebAuthClient({ appId: MY_APP_ID });
+     * // ... In your app logic:
+     * if(vincentAppClient.isLogin()) {
+     *   // Handle app logic for the user has just logged in
+     *   const { decoded, jwtStr } = vincentAppClient.decodeVincentLoginJWT(EXPECTED_AUDIENCE);
+     *   // Store `jwtStr` for later usage; the user is now logged in.
+     * } else {
+     *   // Handle app logic for the user is already logged in (check for stored & unexpired JWT)
+     *   // ...
+     *    *   // Handle app logic for the user is not yet logged in
+     *  vincentAppClient.redirectToDelegationAuthPage({ redirectUri: window.location.href });
+     * }
+     * ```
+     * @function
+     * @inline
+     */
+    redirectToDelegationAuthPage: (redirectConfig: RedirectToVincentDelegationPageParams) => void;
+    /**
+     * Determines whether the current window location is a login URI associated with Vincent
+  
+     * You can use this to detect if a user is loading your app as a result of approving permissions
+     * on the Vincent delegation auth page -- e.g. they just logged in
+     *
+     * See: {@link WebAuthClient.redirectToDelegationAuthPage} for example usage
+     *
+     * @function
+     * @inline
+     * @returns `true` if the current window URI is a login URI, otherwise `false`.
+     */
+    isLogin: () => boolean;
+    /**
+     * Extracts a decoded/parsed Vincent JWT (JSON Web Token) from the current window location
+     *
+     * The token is verified as part of this process; if the token is invalid or expired, this method will throw.
+     *
+     * See: {@link WebAuthClient.redirectToDelegationAuthPage} for example usage
+     *
+     * @param expectedAudience Provide a valid `redirectUri` for your app; this is typically your app's origin
+     * @function
+     * @inline
+     * @returns {decodedJWT: VincentJWTAppSpecific; jwtStr: string | null} `null` if no JWT is found, otherwise both the decoded jwt and the original JWT string is returned
+     * @throws {Error} If there was a JWT in the page URL, but it was invalid / could not be verified
+     */
+    decodeVincentLoginJWT: (expectedAudience: string) => {
+        decodedJWT: VincentJWTAppSpecific;
+        jwtStr: string;
+    } | null;
+    /**
+     * Removes the Vincent login JWT from the current window URI.
+     *
+     * This is useful for cleaning up the URL after decoding and storing the JWT,
+     * ensuring the redirect URL looks clean for the user and no sensitive information
+     * is exposed in the URI.
+     *
+     * @example
+     * ```typescript
+     * import { getWebAuthClient } from '@lit-protocol/vincent-app-sdk/webAuthClient';
+     *
+     * const vincentAppClient = getWebAuthClient({ appId: MY_APP_ID });
+     *
+     * if (vincentAppClient.isLogin()) {
+     *   const { decodedJWT, jwtStr } = vincentAppClient.decodeVincentLoginJWT();
+     *   // Store the JWT and use it for authentication
+     *
+     *   // Now we can remove the JWT from the URL searchParams
+     *   vincentAppClient.removeLoginJWTFromURI();
+     * }
+     * ```
+     *
+     * @function
+     * @inline
+     */
+    removeLoginJWTFromURI: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/webAuthClient/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/webAuthClient/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qCAAqC;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB;;SAEK;IACL,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,4BAA4B,EAAE,CAAC,cAAc,EAAE,qCAAqC,KAAK,IAAI,CAAC;IAE9F;;;;;;;;;;;OAWG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC;IAEvB;;;;;;;;;;;;OAYG;IACH,qBAAqB,EAAE,CACrB,gBAAgB,EAAE,MAAM,KACrB;QAAE,UAAU,EAAE,qBAAqB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAElE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,qBAAqB,EAAE,MAAM,IAAI,CAAC;CACnC"}

package/dist/src/webAuthClient/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/webAuthClient/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/webAuthClient/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@lit-protocol/vincent-app-sdk",
+  "version": "0.0.4-mma",
+  "description": "Vincent SDK for browser and backend",
+  "author": "Lit Protocol",
+  "license": "ISC",
+  "access": "public",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": "^20.11.1",
+    "pnpm": "10.7.0"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./jwt": {
+      "import": "./dist/src/jwt/index.js",
+      "require": "./dist/src/jwt/index.js",
+      "types": "./dist/src/jwt/index.d.ts"
+    },
+    "./toolClient": {
+      "import": "./dist/src/toolClient/index.js",
+      "require": "./dist/src/toolClient/index.js",
+      "types": "./dist/src/toolClient/index.d.ts"
+    },
+    "./webAuthClient": {
+      "import": "./dist/src/webAuthClient/index.js",
+      "require": "./dist/src/webAuthClient/index.js",
+      "types": "./dist/src/webAuthClient/index.d.ts"
+    },
+    "./expressMiddleware": {
+      "import": "./dist/src/expressMiddleware/index.js",
+      "require": "./dist/src/expressMiddleware/index.js",
+      "types": "./dist/src/expressMiddleware/index.d.ts"
+    },
+    "./utils": {
+      "import": "./dist/src/utils/index.js",
+      "require": "./dist/src/utils/index.js",
+      "types": "./dist/src/utils/index.d.ts"
+    }
+  },
+  "keywords": [
+    "jwt",
+    "authentication",
+    "sdk"
+  ],
+  "dependencies": {
+    "@lit-protocol/auth-helpers": "^7.0.9",
+    "@lit-protocol/constants": "^7.0.8",
+    "@lit-protocol/lit-node-client": "^7.0.8",
+    "@noble/secp256k1": "^2.2.3",
+    "did-jwt": "^8.0.8",
+    "ethers": "5.8.0",
+    "tslib": "^2.8.1",
+    "zod": "3.25.64",
+    "@lit-protocol/vincent-contracts-sdk": "1.0.0-4",
+    "@lit-protocol/vincent-tool-sdk": "1.0.2"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist/**/*",
+    "*.md"
+  ],
+  "devDependencies": {
+    "@lit-protocol/pkp-ethers": "^7.2.0",
+    "@lit-protocol/types": "^7.0.8",
+    "@types/express": "^5.0.1",
+    "chokidar-cli": "^3.0.0",
+    "live-server": "^1.2.2",
+    "typedoc": "0.27.9",
+    "typedoc-material-theme": "1.3.0",
+    "typedoc-plugin-extras": "^4.0.0",
+    "typedoc-plugin-zod": "^1.4.1",
+    "vercel": "^41.6.2"
+  },
+  "scripts": {
+    "type-tests": "./scripts/run-typecheck.sh",
+    "watch:type-tests": "chokidar 'src/**/*' --initial --await-write-finish --delay 100 --silent -c './scripts/run-typecheck.sh'",
+    "typecheck": "./scripts/precommit-check.sh"
+  }
+}