@zapier/zapier-sdk 0.30.0 → 0.31.1

package/dist/types/credentials.js

@@ -8,6 +8,86 @@
  * - PKCE: OAuth client ID for interactive login (CLI only)
  * - Function: Lazy/dynamic credential resolution
  */
+import { z } from "zod";
+/**
+ * Client credentials for OAuth client_credentials flow.
+ * The SDK will exchange these for an access token.
+ */
+export const ClientCredentialsObjectSchema = z.object({
+    type: z.enum(["client_credentials"]).optional().meta({ internal: true }),
+    clientId: z
+        .string()
+        .describe("OAuth client ID for authentication.")
+        .meta({ valueHint: "id" }),
+    clientSecret: z
+        .string()
+        .describe("OAuth client secret for authentication.")
+        .meta({ valueHint: "secret" }),
+    baseUrl: z
+        .string()
+        .optional()
+        .describe("Override authentication base URL.")
+        .meta({ valueHint: "url" }),
+    scope: z
+        .string()
+        .optional()
+        .describe("Authentication scope.")
+        .meta({ internal: true }),
+});
+/**
+ * PKCE credentials for interactive OAuth flow.
+ * Only works when @zapier/zapier-sdk-cli-login is available.
+ */
+export const PkceCredentialsObjectSchema = z.object({
+    type: z.enum(["pkce"]).optional().meta({ internal: true }),
+    clientId: z
+        .string()
+        .describe("OAuth client ID for authentication.")
+        .meta({ valueHint: "id" }),
+    baseUrl: z
+        .string()
+        .optional()
+        .describe("Override authentication base URL.")
+        .meta({ valueHint: "url" }),
+    scope: z
+        .string()
+        .optional()
+        .describe("Authentication scope.")
+        .meta({ internal: true }),
+});
+/**
+ * Union of all credential object types.
+ */
+export const CredentialsObjectSchema = z.union([
+    ClientCredentialsObjectSchema,
+    PkceCredentialsObjectSchema,
+]);
+/**
+ * Resolved credentials - what a credentials function must return.
+ * Either a string (token) or a credentials object.
+ * Functions are not allowed to return other functions.
+ */
+export const ResolvedCredentialsSchema = z.union([
+    z.string().describe("Authentication token.").meta({ valueHint: "token" }),
+    CredentialsObjectSchema,
+]);
+/**
+ * Lazy/dynamic credential resolution — a function returning resolved credentials.
+ */
+export const CredentialsFunctionSchema = z
+    .function()
+    .input([])
+    .output(z.union([ResolvedCredentialsSchema, z.promise(ResolvedCredentialsSchema)]));
+/**
+ * Credentials can be:
+ * - A string (token or API key)
+ * - A credentials object (client_credentials or pkce)
+ * - A function that returns credentials (sync or async)
+ */
+export const CredentialsSchema = z.union([
+    ResolvedCredentialsSchema,
+    CredentialsFunctionSchema,
+]);
 /**
  * Type guard for client credentials objects.
  */

package/dist/types/meta.d.ts

@@ -0,0 +1,9 @@
+declare module "zod" {
+    interface GlobalMeta {
+        internal?: boolean;
+        deprecated?: boolean;
+        valueHint?: string;
+    }
+}
+export {};
+//# sourceMappingURL=meta.d.ts.map

package/dist/types/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/types/meta.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,KAAK,CAAC;IACnB,UAAU,UAAU;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAGD,OAAO,EAAE,CAAC"}

package/dist/types/meta.js

@@ -0,0 +1,3 @@
+// Augment the Zod Metadata Registry
+// https://zod.dev/metadata?id=metadata
+export {};

package/dist/types/sdk.d.ts

@@ -1,49 +1,75 @@
 /**
  * SDK-related types and interfaces
  */
+import { z } from "zod";
 import type { EventCallback } from "./events";
 import type { EventEmissionConfig } from "../plugins/eventEmission";
 import type { Manifest } from "../plugins/manifest";
-import type { Credentials } from "./credentials";
-export interface BaseSdkOptions {
-    /**
-     * Authentication credentials. Can be:
-     * - A string (token or API key)
-     * - An object with clientId/clientSecret for client_credentials flow
-     * - An object with clientId (no secret) for PKCE flow
-     * - A function returning any of the above
-     */
-    credentials?: Credentials;
-    /**
-     * @deprecated Use `credentials` instead.
-     */
-    token?: string;
-    onEvent?: EventCallback;
-    fetch?: typeof fetch;
-    baseUrl?: string;
-    trackingBaseUrl?: string;
-    debug?: boolean;
-    manifestPath?: string;
-    manifest?: Manifest;
-    eventEmission?: EventEmissionConfig;
-    /**
-     * Maximum number of retries for rate-limited requests (429 responses).
-     * Set to 0 to disable retries. Default is 3.
-     */
-    maxNetworkRetries?: number;
-    /**
-     * Maximum delay in milliseconds to wait for a rate limit retry.
-     * If the server requests a longer delay, the request fails immediately.
-     * Default is 60000 (60 seconds).
-     */
-    maxNetworkRetryDelayMs?: number;
-}
+export declare const BaseSdkOptionsSchema: z.ZodObject<{
+    credentials: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>, z.ZodFunction<z.core.$ZodTuple<readonly [], z.core.$ZodFunctionOut>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>, z.ZodPromise<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>>]>>]>>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    trackingBaseUrl: z.ZodOptional<z.ZodString>;
+    maxNetworkRetries: z.ZodOptional<z.ZodNumber>;
+    maxNetworkRetryDelayMs: z.ZodOptional<z.ZodNumber>;
+    manifestPath: z.ZodOptional<z.ZodString>;
+    manifest: z.ZodOptional<z.ZodCustom<Manifest, Manifest>>;
+    onEvent: z.ZodOptional<z.ZodCustom<EventCallback, EventCallback>>;
+    fetch: z.ZodOptional<z.ZodCustom<typeof fetch, typeof fetch>>;
+    eventEmission: z.ZodOptional<z.ZodCustom<EventEmissionConfig, EventEmissionConfig>>;
+    token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BaseSdkOptions = z.infer<typeof BaseSdkOptionsSchema>;
 import type { ListInputFieldsSdkFunction } from "../plugins/listInputFields/schemas";
 import type { GetConnectionSdkFunction } from "../plugins/getConnection/schemas";
 import type { FindFirstConnectionSdkFunction } from "../plugins/findFirstConnection/schemas";
 import type { FindUniqueConnectionSdkFunction } from "../plugins/findUniqueConnection/schemas";
 import type { RelayRequestSdkFunction } from "../plugins/request/schemas";
-import type { z } from "zod";
 import type { RegistryPluginProvides } from "../plugins/registry";
 import type { GetProfilePluginProvides } from "../plugins/getProfile";
 import type { EventEmissionProvides } from "../plugins/eventEmission";

package/dist/types/sdk.d.ts.map

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

package/dist/types/sdk.js

@@ -1,4 +1,58 @@
 /**
  * SDK-related types and interfaces
  */
-export {};
+import { z } from "zod";
+import { CredentialsSchema } from "./credentials";
+// SDK Configuration Types
+export const BaseSdkOptionsSchema = z.object({
+    credentials: CredentialsSchema.optional().describe("Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those."),
+    debug: z.boolean().optional().describe("Enable debug logging."),
+    baseUrl: z
+        .string()
+        .optional()
+        .describe("Base URL for Zapier API endpoints.")
+        .meta({ valueHint: "url" }),
+    trackingBaseUrl: z
+        .string()
+        .optional()
+        .describe("Base URL for Zapier tracking endpoints.")
+        .meta({ valueHint: "url" }),
+    /**
+     * Maximum number of retries for rate-limited requests (429 responses).
+     * Set to 0 to disable retries. Default is 3.
+     */
+    maxNetworkRetries: z
+        .number()
+        .optional()
+        .describe("Max retries for rate-limited requests (default: 3).")
+        .meta({ valueHint: "count" }),
+    /**
+     * Maximum delay in milliseconds to wait for a rate limit retry.
+     * If the server requests a longer delay, the request fails immediately.
+     * Default is 60000 (60 seconds).
+     */
+    maxNetworkRetryDelayMs: z
+        .number()
+        .optional()
+        .describe("Max delay in ms to wait for retry (default: 60000).")
+        .meta({ valueHint: "ms" }),
+    // Internal
+    manifestPath: z
+        .string()
+        .optional()
+        .describe("Path to a .zapierrc manifest file for app version locking.")
+        .meta({ internal: true }),
+    manifest: z
+        .custom()
+        .optional()
+        .describe("Manifest for app version locking.")
+        .meta({ internal: true }),
+    onEvent: z.custom().optional().meta({ internal: true }),
+    fetch: z.custom().optional().meta({ internal: true }),
+    eventEmission: z
+        .custom()
+        .optional()
+        .meta({ internal: true }),
+    // Deprecated
+    token: z.string().optional().meta({ deprecated: true }), // Use credentials instead
+});

package/dist/utils/telemetry-context.d.ts

@@ -1,3 +1,15 @@
+/**
+ * Async-local storage context for per-invocation telemetry state. Each top-level
+ * SDK method call runs in its own ALS scope (via runWithTelemetryContext), isolating
+ * its depth counter and method metadata from concurrent calls.
+ */
+export interface MethodMetadata {
+    selectedApi?: string | null;
+    operationType?: string | null;
+    operationKey?: string | null;
+}
 export declare function isTelemetryNested(): boolean;
 export declare function runWithTelemetryContext<T>(fn: () => T): T;
+export declare function setMethodMetadata(metadata: MethodMetadata): void;
+export declare function getMethodMetadata(): MethodMetadata | undefined;
 //# sourceMappingURL=telemetry-context.d.ts.map

package/dist/utils/telemetry-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-context.d.ts","sourceRoot":"","sources":["../../src/utils/telemetry-context.ts"],"names":[],"mappings":"AAmBA,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAIzD"}
+{"version":3,"file":"telemetry-context.d.ts","sourceRoot":"","sources":["../../src/utils/telemetry-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAoBD,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAIzD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAKhE;AAED,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAG9D"}

package/dist/utils/telemetry-context.js

@@ -1,3 +1,8 @@
+/**
+ * Async-local storage context for per-invocation telemetry state. Each top-level
+ * SDK method call runs in its own ALS scope (via runWithTelemetryContext), isolating
+ * its depth counter and method metadata from concurrent calls.
+ */
 // Intentional dynamic require — one-time environment detection for AsyncLocalStorage
 // availability (e.g., unavailable in browsers). This is NOT lazy loading.
 let telemetryStore = null;
@@ -21,3 +26,16 @@ export function runWithTelemetryContext(fn) {
     const currentDepth = telemetryStore.getStore()?.depth ?? -1;
     return telemetryStore.run({ depth: currentDepth + 1 }, fn);
 }
+export function setMethodMetadata(metadata) {
+    if (!telemetryStore)
+        return;
+    const store = telemetryStore.getStore();
+    if (!store)
+        return;
+    store.methodMetadata = { ...store.methodMetadata, ...metadata };
+}
+export function getMethodMetadata() {
+    if (!telemetryStore)
+        return undefined;
+    return telemetryStore.getStore()?.methodMetadata;
+}

package/dist/utils/telemetry-context.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { isTelemetryNested, runWithTelemetryContext, } from "./telemetry-context";
+import { isTelemetryNested, runWithTelemetryContext, setMethodMetadata, getMethodMetadata, } from "./telemetry-context";
 describe("telemetry-context", () => {
     describe("isTelemetryNested", () => {
         it("returns false outside any context", () => {
@@ -69,6 +69,68 @@ describe("telemetry-context", () => {
             expect(task2Result?.nested).toBe(false);
         });
     });
+    describe("setMethodMetadata / getMethodMetadata", () => {
+        it("round-trips metadata within ALS context", () => {
+            runWithTelemetryContext(() => {
+                setMethodMetadata({
+                    selectedApi: "SlackCLIAPI@1.0.0",
+                    operationType: "write",
+                    operationKey: "send_message",
+                });
+                const metadata = getMethodMetadata();
+                expect(metadata).toEqual({
+                    selectedApi: "SlackCLIAPI@1.0.0",
+                    operationType: "write",
+                    operationKey: "send_message",
+                });
+            });
+        });
+        it("returns undefined outside any ALS context", () => {
+            expect(getMethodMetadata()).toBeUndefined();
+        });
+        it("is isolated between different runWithTelemetryContext scopes", () => {
+            runWithTelemetryContext(() => {
+                setMethodMetadata({ selectedApi: "parent" });
+                runWithTelemetryContext(() => {
+                    setMethodMetadata({ selectedApi: "child" });
+                    expect(getMethodMetadata()?.selectedApi).toBe("child");
+                });
+                expect(getMethodMetadata()?.selectedApi).toBe("parent");
+            });
+        });
+        it("merges partial metadata updates", () => {
+            runWithTelemetryContext(() => {
+                setMethodMetadata({ selectedApi: "SlackCLIAPI@1.0.0" });
+                setMethodMetadata({ operationType: "write" });
+                const metadata = getMethodMetadata();
+                expect(metadata).toEqual({
+                    selectedApi: "SlackCLIAPI@1.0.0",
+                    operationType: "write",
+                });
+            });
+        });
+        it("is readable in .then() handler within same ALS scope (paginated pattern)", async () => {
+            await runWithTelemetryContext(async () => {
+                setMethodMetadata({
+                    selectedApi: "SlackCLIAPI@1.0.0",
+                    operationType: "write",
+                    operationKey: "send_message",
+                });
+                const result = await Promise.resolve("done").then(() => {
+                    return getMethodMetadata();
+                });
+                expect(result).toEqual({
+                    selectedApi: "SlackCLIAPI@1.0.0",
+                    operationType: "write",
+                    operationKey: "send_message",
+                });
+            });
+        });
+        it("is a no-op outside ALS context", () => {
+            setMethodMetadata({ selectedApi: "test" });
+            expect(getMethodMetadata()).toBeUndefined();
+        });
+    });
     describe("runWithTelemetryContext", () => {
         it("returns the value from the wrapped function", () => {
             const result = runWithTelemetryContext(() => 42);

package/dist/utils/telemetry-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-utils.d.ts","sourceRoot":"","sources":["../../src/utils/telemetry-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,oBAAoB,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC,EAC3E,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAcpB"}
+{"version":3,"file":"telemetry-utils.d.ts","sourceRoot":"","sources":["../../src/utils/telemetry-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,oBAAoB,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC,EAC3E,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAkBpB"}

package/dist/utils/telemetry-utils.js

@@ -1,3 +1,4 @@
+import { getMethodMetadata } from "./telemetry-context";
 /**
  * Creates a standardized telemetry callback for SDK method invocations.
  *
@@ -41,6 +42,7 @@
 export function createTelemetryCallback(emitMethodCalled, methodName) {
     return {
         onMethodCalled: (data) => {
+            const metadata = getMethodMetadata();
             emitMethodCalled({
                 method_name: methodName,
                 execution_duration_ms: data.durationMs,
@@ -49,6 +51,9 @@ export function createTelemetryCallback(emitMethodCalled, methodName) {
                 error_type: data.error?.constructor.name ?? null,
                 argument_count: data.argumentCount,
                 is_paginated: data.isPaginated,
+                selected_api: metadata?.selectedApi ?? null,
+                operation_type: metadata?.operationType ?? null,
+                operation_key: metadata?.operationKey ?? null,
             });
         },
     };

package/dist/utils/telemetry-utils.test.js

@@ -1,5 +1,6 @@
 import { describe, it, expect, vi } from "vitest";
 import { createTelemetryCallback } from "./telemetry-utils";
+import { runWithTelemetryContext, setMethodMetadata, } from "./telemetry-context";
 describe("createTelemetryCallback", () => {
     it("should create callback that emits telemetry with explicit method name", () => {
         const mockEmit = vi.fn();
@@ -19,6 +20,9 @@ describe("createTelemetryCallback", () => {
             error_type: null,
             argument_count: 2,
             is_paginated: false,
+            selected_api: null,
+            operation_type: null,
+            operation_key: null,
         });
     });
     it("should include error details when method fails", () => {
@@ -41,6 +45,9 @@ describe("createTelemetryCallback", () => {
             error_type: "Error",
             argument_count: 1,
             is_paginated: false,
+            selected_api: null,
+            operation_type: null,
+            operation_key: null,
         });
     });
     it("should handle paginated method calls", () => {
@@ -61,6 +68,9 @@ describe("createTelemetryCallback", () => {
             error_type: null,
             argument_count: 1,
             is_paginated: true,
+            selected_api: null,
+            operation_type: null,
+            operation_key: null,
         });
     });
     it("should handle custom error types", () => {
@@ -89,6 +99,57 @@ describe("createTelemetryCallback", () => {
             error_type: "CustomError",
             argument_count: 3,
             is_paginated: false,
+            selected_api: null,
+            operation_type: null,
+            operation_key: null,
         });
     });
+    it("should include ALS metadata when set", () => {
+        const mockEmit = vi.fn();
+        const callback = createTelemetryCallback(mockEmit, "runAction");
+        runWithTelemetryContext(() => {
+            setMethodMetadata({
+                selectedApi: "SlackCLIAPI@1.0.0",
+                operationType: "write",
+                operationKey: "send_message",
+            });
+            callback.onMethodCalled({
+                methodName: "ignoredName",
+                durationMs: 100,
+                success: true,
+                argumentCount: 1,
+                isPaginated: false,
+            });
+        });
+        expect(mockEmit).toHaveBeenCalledWith({
+            method_name: "runAction",
+            execution_duration_ms: 100,
+            success_flag: true,
+            error_message: null,
+            error_type: null,
+            argument_count: 1,
+            is_paginated: false,
+            selected_api: "SlackCLIAPI@1.0.0",
+            operation_type: "write",
+            operation_key: "send_message",
+        });
+    });
+    it("should default metadata fields to null when no ALS metadata is set", () => {
+        const mockEmit = vi.fn();
+        const callback = createTelemetryCallback(mockEmit, "listApps");
+        runWithTelemetryContext(() => {
+            callback.onMethodCalled({
+                methodName: "ignoredName",
+                durationMs: 50,
+                success: true,
+                argumentCount: 0,
+                isPaginated: false,
+            });
+        });
+        expect(mockEmit).toHaveBeenCalledWith(expect.objectContaining({
+            selected_api: null,
+            operation_type: null,
+            operation_key: null,
+        }));
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.30.0",
+  "version": "0.31.1",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",