npm - @sealmetrics/mcp - Versions diffs - 0.1.0 → 1.3.0 - Mend

@sealmetrics/mcp 0.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (103) hide show

package/README.md +173 -0
package/dist/client.d.ts +68 -0
package/dist/client.d.ts.map +1 -0
package/dist/client.js +225 -0
package/dist/client.js.map +1 -0
package/dist/embedded.d.ts +29 -0
package/dist/embedded.d.ts.map +1 -0
package/dist/embedded.js +37 -0
package/dist/embedded.js.map +1 -0
package/dist/errors.d.ts +10 -0
package/dist/errors.d.ts.map +1 -0
package/dist/errors.js +55 -0
package/dist/errors.js.map +1 -0
package/dist/index.d.ts +1 -6
package/dist/index.d.ts.map +1 -0
package/dist/index.js +3809 -780
package/dist/index.js.map +1 -0
package/dist/resources/tracking-guide.d.ts +13 -0
package/dist/resources/tracking-guide.d.ts.map +1 -0
package/dist/resources/tracking-guide.js +479 -0
package/dist/resources/tracking-guide.js.map +1 -0
package/dist/sealmetrics.mcpb +0 -0
package/dist/server.d.ts +38 -0
package/dist/server.d.ts.map +1 -0
package/dist/server.js +132 -0
package/dist/server.js.map +1 -0
package/dist/tools/alerts.d.ts +5 -0
package/dist/tools/alerts.d.ts.map +1 -0
package/dist/tools/alerts.js +80 -0
package/dist/tools/alerts.js.map +1 -0
package/dist/tools/audience.d.ts +7 -0
package/dist/tools/audience.d.ts.map +1 -0
package/dist/tools/audience.js +146 -0
package/dist/tools/audience.js.map +1 -0
package/dist/tools/bots.d.ts +4 -0
package/dist/tools/bots.d.ts.map +1 -0
package/dist/tools/bots.js +52 -0
package/dist/tools/bots.js.map +1 -0
package/dist/tools/channels.d.ts +5 -0
package/dist/tools/channels.d.ts.map +1 -0
package/dist/tools/channels.js +88 -0
package/dist/tools/channels.js.map +1 -0
package/dist/tools/content.d.ts +3 -0
package/dist/tools/content.d.ts.map +1 -0
package/dist/tools/content.js +47 -0
package/dist/tools/content.js.map +1 -0
package/dist/tools/conversions.d.ts +9 -0
package/dist/tools/conversions.d.ts.map +1 -0
package/dist/tools/conversions.js +427 -0
package/dist/tools/conversions.js.map +1 -0
package/dist/tools/funnel.d.ts +3 -0
package/dist/tools/funnel.d.ts.map +1 -0
package/dist/tools/funnel.js +27 -0
package/dist/tools/funnel.js.map +1 -0
package/dist/tools/index.d.ts +16 -0
package/dist/tools/index.d.ts.map +1 -0
package/dist/tools/index.js +83 -0
package/dist/tools/index.js.map +1 -0
package/dist/tools/overview.d.ts +3 -0
package/dist/tools/overview.d.ts.map +1 -0
package/dist/tools/overview.js +26 -0
package/dist/tools/overview.js.map +1 -0
package/dist/tools/pages.d.ts +7 -0
package/dist/tools/pages.d.ts.map +1 -0
package/dist/tools/pages.js +307 -0
package/dist/tools/pages.js.map +1 -0
package/dist/tools/properties.d.ts +5 -0
package/dist/tools/properties.d.ts.map +1 -0
package/dist/tools/properties.js +107 -0
package/dist/tools/properties.js.map +1 -0
package/dist/tools/segments.d.ts +4 -0
package/dist/tools/segments.d.ts.map +1 -0
package/dist/tools/segments.js +49 -0
package/dist/tools/segments.js.map +1 -0
package/dist/tools/setup.d.ts +49 -0
package/dist/tools/setup.d.ts.map +1 -0
package/dist/tools/setup.js +347 -0
package/dist/tools/setup.js.map +1 -0
package/dist/tools/shared.d.ts +33 -0
package/dist/tools/shared.d.ts.map +1 -0
package/dist/tools/shared.js +40 -0
package/dist/tools/shared.js.map +1 -0
package/dist/tools/sites.d.ts +4 -0
package/dist/tools/sites.d.ts.map +1 -0
package/dist/tools/sites.js +36 -0
package/dist/tools/sites.js.map +1 -0
package/dist/tools/tracking.d.ts +3 -0
package/dist/tools/tracking.d.ts.map +1 -0
package/dist/tools/tracking.js +220 -0
package/dist/tools/tracking.js.map +1 -0
package/dist/tools/traffic.d.ts +10 -0
package/dist/tools/traffic.d.ts.map +1 -0
package/dist/tools/traffic.js +273 -0
package/dist/tools/traffic.js.map +1 -0
package/dist/tools/webhooks.d.ts +5 -0
package/dist/tools/webhooks.d.ts.map +1 -0
package/dist/tools/webhooks.js +101 -0
package/dist/tools/webhooks.js.map +1 -0
package/dist/types.d.ts +118 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +22 -0
package/dist/types.js.map +1 -0
package/package.json +44 -27

package/dist/tools/setup.js ADDED Viewed

@@ -0,0 +1,347 @@
+/**
+ * MCP write-path setup tools (Fase 3 Bloque 2, RF-3203). These let a user register
+ * + verify a SealMetrics site **from the chat** (Claude Desktop, no terminal),
+ * reusing `@sealmetrics/setup-core` (Bloque 1) so the logic is never duplicated
+ * CLI↔MCP. The MCP never edits the user's source (RF-3204) — provision_site hands
+ * back the snippet + guide; the agent (with repo) or the human (paste) places it.
+ *
+ * Privacy/secret handling (VAL-3201/3203, RF-3207):
+ *  - provision_site NEVER returns the api_key to the model (it is adopted into
+ *    memory to enable the read-only tools and saved by the user via env/email).
+ *  - provision_site NEVER returns the claim_url magic-link token (it goes by
+ *    email); it returns `claim_email_sent_to` + `dashboard_url` only.
+ */
+import { detectFramework, buildProvisionBody, unwrapProvisionData, provisionErrorForStatus, fetchPixelStatus, pollPixelStatus, getInstrumentationGuide, getStackGuide, getPlatformPluginGuide, checkInstrumentation, detectPII, } from "@sealmetrics/setup-core";
+import { SealMetricsAPIError } from "../errors.js";
+/** Terms of Service URL — shown so the human can read them before accepting (parity with the CLI). */
+const TOS_URL = "https://sealmetrics.com/terms";
+function str(v) {
+    if (v === undefined || v === null)
+        return undefined;
+    const s = String(v).trim();
+    return s.length > 0 ? s : undefined;
+}
+/** Build the five (RF-3203) setup tools bound to a context. */
+export function createSetupTools(ctx) {
+    const provisionSite = {
+        name: "provision_site",
+        description: "Register a NEW free SealMetrics site from the chat (no terminal needed). Creates the account, returns the tracker snippet to place in your site's <head>, and emails you a claim link to set a password. After this succeeds, the read-only analytics tools are enabled in this session. Does NOT edit your code — you (or the agent, if it has the repo) place the snippet.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                site_name: { type: "string", description: "Human-friendly name for the site (e.g. 'My Shop')." },
+                domain: { type: "string", description: "Primary domain of the site (e.g. 'myshop.com'). Optional." },
+                email: { type: "string", description: "Your email — receives the claim link to set a password." },
+                name: { type: "string", description: "Your name. Optional." },
+                accept_terms: {
+                    type: "boolean",
+                    description: "Must be true: confirms the user has read and accepts the SealMetrics Terms of Service (https://sealmetrics.com/terms). Show the user this link first; do NOT accept on their behalf.",
+                },
+            },
+            required: ["site_name", "email", "accept_terms"],
+        },
+        annotations: { title: "Provision a SealMetrics site", readOnlyHint: false, openWorldHint: true },
+        handler: async (args) => {
+            if (args.accept_terms !== true && args.accept_terms !== "true") {
+                throw new Error(`accept_terms must be true. Show the user the SealMetrics Terms of Service (${TOS_URL}) and ask them to confirm — do not accept on their behalf.`);
+            }
+            const siteName = str(args.site_name);
+            const email = str(args.email);
+            if (!siteName)
+                throw new Error("site_name is required.");
+            if (!email)
+                throw new Error("email is required.");
+            const input = {
+                siteName,
+                domain: str(args.domain),
+                email,
+                name: str(args.name),
+                installSource: ctx.installSource, // "mcp" — attribution (RF-3205/RF-3604)
+            };
+            let envelope;
+            try {
+                envelope = await ctx.client.post("/provision", buildProvisionBody(input), {
+                    provisionKey: ctx.provisionKey,
+                });
+            }
+            catch (e) {
+                if (e instanceof SealMetricsAPIError) {
+                    // Map HTTP status → the shared ProvisionError code/message (TEST-3203/3601).
+                    const pe = provisionErrorForStatus(e.statusCode);
+                    throw new Error(`${pe.code}: ${pe.message}`);
+                }
+                throw e;
+            }
+            const result = unwrapProvisionData(envelope);
+            // Adopt the api_key + enable read-only tools (RF-3202b). NEVER returned to the model.
+            ctx.onProvisioned(result.api_key, result.account_id);
+            ctx.state.provisioned = true;
+            ctx.state.accountId = result.account_id;
+            // Return ONLY non-secret fields: no api_key (VAL-3201), no claim_url token (RF-3207/VAL-3203).
+            return {
+                account_id: result.account_id,
+                snippet: result.snippet,
+                dashboard_url: result.dashboard_url,
+                claim_email_sent_to: email,
+                free_quota: result.free_quota,
+                next_steps: [
+                    "Place the snippet in your site's <head> on every page. If the agent has your repo it can do this; otherwise paste it yourself.",
+                    "Run verify_setup once the snippet is live to confirm the pixel is sending data.",
+                    "Read-only analytics tools are now enabled in THIS session.",
+                    "To keep them after restarting Claude Desktop, paste the api_key from your welcome email into the SEALMETRICS_API_KEY field of the extension settings.",
+                    "Check your email to claim the account (set a password) — this unlocks the web dashboard. Analytics work without it.",
+                ],
+            };
+        },
+    };
+    const verifySetup = {
+        name: "verify_setup",
+        description: "Poll until the SealMetrics pixel is confirmed installed (a real pageview has reached the backend) or it times out. Run this after placing the snippet. Reads only — sends no data.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                account_id: {
+                    type: "string",
+                    description: "Site/account id to verify. Defaults to the site provisioned in this session.",
+                },
+                timeout_seconds: {
+                    type: "number",
+                    description: "Max seconds to wait for the first hit (default 25).",
+                },
+            },
+        },
+        annotations: { title: "Verify pixel install", readOnlyHint: true, openWorldHint: true },
+        handler: async (args) => {
+            const accountId = str(args.account_id) ?? ctx.state.accountId;
+            if (!accountId)
+                throw new Error("account_id is required (provision a site first).");
+            const apiKey = ctx.client.getApiKey();
+            if (!apiKey) {
+                throw new Error("AUTH_REQUIRED: no api_key available to verify. Provision a site first, or set SEALMETRICS_API_KEY.");
+            }
+            const timeoutMs = ctx.pollDefaults?.timeoutMs ??
+                (typeof args.timeout_seconds === "number" ? Math.max(0, args.timeout_seconds) * 1000 : 25_000);
+            const intervalMs = ctx.pollDefaults?.intervalMs ?? 2_000;
+            const res = await pollPixelStatus({
+                fetchStatus: () => fetchPixelStatus(accountId, { baseUrl: ctx.baseUrl, apiKey }),
+                timeoutMs,
+                intervalMs,
+            });
+            if (res.verified === true)
+                ctx.state.pixelVerified = true;
+            return {
+                account_id: accountId,
+                installed: res.verified === true,
+                status: res.verified === true ? "verified" : "pending",
+                total_hits: res.totalHits ?? 0,
+                next_steps: res.verified === true
+                    ? ["Pixel confirmed. You can now query analytics with the read-only tools."]
+                    : [
+                        "No hits yet. Make sure the snippet is in the <head> of a live page, then load that page and re-run verify_setup.",
+                    ],
+            };
+        },
+    };
+    const getSetupStatus = {
+        name: "get_setup_status",
+        description: "Report where the setup flow is: whether a site has been provisioned in this session and whether its pixel has been verified.",
+        inputSchema: { type: "object", properties: {} },
+        annotations: { title: "Setup status", readOnlyHint: true },
+        handler: async () => ({
+            provisioned: ctx.state.provisioned,
+            account_id: ctx.state.accountId,
+            pixel_verified: ctx.state.pixelVerified,
+        }),
+    };
+    const detectFrameworkTool = {
+        name: "detect_framework",
+        description: "Best-effort detect the web framework/CMS of a project so the snippet can be placed correctly. Pass `path` if you have the repo; in a pure chat (no repo) returns 'unknown' plus the manual guide. Read-only — never edits files.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Absolute path to the project root. Optional; omit if you don't have the repo.",
+                },
+            },
+        },
+        annotations: { title: "Detect framework", readOnlyHint: true },
+        handler: async (args) => {
+            const path = str(args.path) ?? ctx.cwd;
+            if (!path) {
+                const guide = getStackGuide("unknown");
+                return {
+                    framework: "unknown",
+                    strategy: "manual",
+                    location: guide.location,
+                    placement: guide.placement,
+                    provision_only: true,
+                    note: "No project path available (e.g. Claude Desktop chat). Provide `path` if you have the repo, or place the snippet manually using loading_notes.",
+                    loading_notes: guide.notes,
+                };
+            }
+            const d = detectFramework(path);
+            const guide = getStackGuide(d.framework);
+            return {
+                framework: d.framework,
+                platform: d.platform,
+                strategy: d.strategy,
+                location: d.recommendedLocation,
+                placement: d.placementHint,
+                provision_only: d.provisionOnly,
+                loading_notes: guide.notes,
+                ...(d.platform
+                    ? { plugin_guidance: getPlatformPluginGuide(d.platform, ctx.state.accountId ?? "[YOUR_ACCOUNT_ID]") }
+                    : {}),
+            };
+        },
+    };
+    const getInstrumentationGuideTool = {
+        name: "get_instrumentation_guide",
+        description: "Return the canonical SealMetrics event-instrumentation guide (closed conv/micro taxonomy + privacy rules) with your account_id substituted. Use it before writing sealmetrics.conv()/micro() calls. The MCP does NOT write these calls — the agent does, guided by this.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                account_id: {
+                    type: "string",
+                    description: "Account id to substitute into the guide. Defaults to the provisioned site.",
+                },
+            },
+        },
+        annotations: { title: "Instrumentation guide", readOnlyHint: true },
+        handler: async (args) => {
+            const accountId = str(args.account_id) ?? ctx.state.accountId ?? "[YOUR_ACCOUNT_ID]";
+            return { account_id: accountId, guide: getInstrumentationGuide(accountId) };
+        },
+    };
+    const verifyEventInstrumented = {
+        name: "verify_event_instrumented",
+        description: "Close the instrumentation loop (Fase 3 Bloque 4): after you add a sealmetrics.conv()/micro() call AND trigger it (a test visit/action), confirm the event reached the backend with the expected type. ALSO validates the event name against the closed taxonomy and rejects PII in properties before declaring success. Reads only.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                account_id: { type: "string", description: "Site/account id. Defaults to the provisioned site." },
+                kind: { type: "string", enum: ["conv", "micro"], description: "Event kind: 'conv' or 'micro'." },
+                name: { type: "string", description: "Event name (must be in the closed taxonomy, e.g. 'purchase')." },
+                timeout_seconds: { type: "number", description: "Max seconds to wait for the event (default 25)." },
+            },
+            required: ["kind", "name"],
+        },
+        annotations: { title: "Verify instrumented event", readOnlyHint: true, openWorldHint: true },
+        handler: async (args) => {
+            const accountId = str(args.account_id) ?? ctx.state.accountId;
+            if (!accountId)
+                throw new Error("account_id is required (provision a site first).");
+            const kind = str(args.kind);
+            const name = str(args.name);
+            if (kind !== "conv" && kind !== "micro")
+                throw new Error("kind must be 'conv' or 'micro'.");
+            if (!name)
+                throw new Error("name is required.");
+            const apiKey = ctx.client.getApiKey();
+            if (!apiKey)
+                throw new Error("AUTH_REQUIRED: no api_key available. Provision a site first or set SEALMETRICS_API_KEY.");
+            // 1) Static gate: taxonomy (VAL-3401) + PII (VAL-3402). Reject before confirming.
+            const check = checkInstrumentation(kind, name);
+            if (!check.taxonomy.valid) {
+                return {
+                    status: "rejected",
+                    reason: "out_of_taxonomy",
+                    name,
+                    suggestion: check.taxonomy.suggestion,
+                    message: `'${name}' is not in the closed ${kind} taxonomy.${check.taxonomy.suggestion ? ` Did you mean '${check.taxonomy.suggestion}'?` : ""} Fix the event name before verifying.`,
+                };
+            }
+            // 2) Confirm the event reached the backend by polling the raw endpoint and
+            //    matching by recency (the raw routes filter by date, not last-N-seconds).
+            const path = kind === "conv" ? "/stats/conversions/raw" : "/stats/microconversions/raw";
+            const typeParam = kind === "conv" ? "conversion_type" : "microconversion_type";
+            const timeoutMs = ctx.pollDefaults?.timeoutMs ??
+                (typeof args.timeout_seconds === "number" ? Math.max(0, args.timeout_seconds) * 1000 : 25_000);
+            const intervalMs = ctx.pollDefaults?.intervalMs ?? 3_000;
+            const startedAt = ctx.now ? ctx.now() : Date.now();
+            const deadline = startedAt + timeoutMs;
+            let found;
+            let piiFlagged = [];
+            for (;;) {
+                try {
+                    const raw = await ctx.client.requestDirect(path, {
+                        site_id: accountId,
+                        period: "today",
+                        [typeParam]: name,
+                        include_properties: "true",
+                        page_size: "20",
+                    });
+                    const rows = Array.isArray(raw?.data) ? raw.data : [];
+                    // Match the most recent row whose timestamp is at/after we started.
+                    for (const row of rows) {
+                        const ts = Date.parse(String(row.timestamp_utc ?? ""));
+                        if (Number.isFinite(ts) && ts >= startedAt - 5_000) {
+                            found = row;
+                            const findings = detectPropertiesPII(row.properties);
+                            piiFlagged = findings;
+                            break;
+                        }
+                    }
+                }
+                catch {
+                    // transient — keep polling until the deadline
+                }
+                if (found)
+                    break;
+                const nowMs = ctx.now ? ctx.now() : Date.now();
+                if (nowMs + intervalMs >= deadline)
+                    break;
+                await sleep(intervalMs, ctx.sleep);
+            }
+            if (!found) {
+                return {
+                    status: "pending",
+                    account_id: accountId,
+                    kind,
+                    name,
+                    message: `No '${name}' ${kind} event seen yet. Trigger the event (a test visit/action), then re-run. Raw endpoints lag ~2-5s.`,
+                };
+            }
+            if (piiFlagged.length > 0) {
+                return {
+                    status: "warning_pii",
+                    account_id: accountId,
+                    kind,
+                    name,
+                    pii_properties: piiFlagged,
+                    message: `Event '${name}' arrived, but its properties look like PII (${piiFlagged
+                        .map((f) => f.key)
+                        .join(", ")}). Remove personal data / order/user IDs — these must NEVER be tracked.`,
+                };
+            }
+            return {
+                status: "verified",
+                account_id: accountId,
+                kind,
+                name,
+                message: `Event '${name}' confirmed in SealMetrics with no PII. Instrumentation verified.`,
+            };
+        },
+    };
+    return [
+        provisionSite,
+        verifySetup,
+        getSetupStatus,
+        detectFrameworkTool,
+        getInstrumentationGuideTool,
+        verifyEventInstrumented,
+    ];
+}
+// Local helpers ---------------------------------------------------------------
+function sleep(ms, custom) {
+    if (custom)
+        return custom(ms);
+    return new Promise((r) => setTimeout(r, ms));
+}
+function detectPropertiesPII(properties) {
+    if (!properties || typeof properties !== "object")
+        return [];
+    return detectPII(properties).map((f) => ({ reason: f.reason, key: f.key }));
+}
+//# sourceMappingURL=setup.js.map

package/dist/tools/setup.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/tools/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,SAAS,GAEV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA4CnD,sGAAsG;AACtG,MAAM,OAAO,GAAG,+BAA+B,CAAC;AAEhD,SAAS,GAAG,CAAC,CAAU;IACrB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACpD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB,CAAC,GAAiB;IAChD,MAAM,aAAa,GAAiB;QAClC,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,8WAA8W;QAChX,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;gBAChG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2DAA2D,EAAE;gBACpG,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yDAAyD,EAAE;gBACjG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBAC7D,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EACT,sLAAsL;iBACzL;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC;SACjD;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;QAChG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,IAAI,IAAI,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;gBAC/D,MAAM,IAAI,KAAK,CACb,8EAA8E,OAAO,4DAA4D,CAClJ,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACzD,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAElD,MAAM,KAAK,GAAmB;gBAC5B,QAAQ;gBACR,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;gBACxB,KAAK;gBACL,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBACpB,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,wCAAwC;aAC3E,CAAC;YAEF,IAAI,QAAiB,CAAC;YACtB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE;oBACxE,YAAY,EAAE,GAAG,CAAC,YAAY;iBAC/B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,YAAY,mBAAmB,EAAE,CAAC;oBACrC,6EAA6E;oBAC7E,MAAM,EAAE,GAAG,uBAAuB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;oBACjD,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/C,CAAC;gBACD,MAAM,CAAC,CAAC;YACV,CAAC;YAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAE7C,sFAAsF;YACtF,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;YACrD,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;YAC7B,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC;YAExC,+FAA+F;YAC/F,OAAO;gBACL,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,mBAAmB,EAAE,KAAK;gBAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,UAAU,EAAE;oBACV,gIAAgI;oBAChI,iFAAiF;oBACjF,4DAA4D;oBAC5D,uJAAuJ;oBACvJ,qHAAqH;iBACtH;aACF,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,MAAM,WAAW,GAAiB;QAChC,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,oLAAoL;QACtL,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8EAA8E;iBAC5F;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;iBACnE;aACF;SACF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QACvF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;YAC9D,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACpF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,oGAAoG,CACrG,CAAC;YACJ,CAAC;YACD,MAAM,SAAS,GACb,GAAG,CAAC,YAAY,EAAE,SAAS;gBAC3B,CAAC,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACjG,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,EAAE,UAAU,IAAI,KAAK,CAAC;YAEzD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC;gBAChC,WAAW,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;gBAChF,SAAS;gBACT,UAAU;aACX,CAAC,CAAC;YACH,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI;gBAAE,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1D,OAAO;gBACL,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,GAAG,CAAC,QAAQ,KAAK,IAAI;gBAChC,MAAM,EAAE,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;gBACtD,UAAU,EAAE,GAAG,CAAC,SAAS,IAAI,CAAC;gBAC9B,UAAU,EACR,GAAG,CAAC,QAAQ,KAAK,IAAI;oBACnB,CAAC,CAAC,CAAC,wEAAwE,CAAC;oBAC5E,CAAC,CAAC;wBACE,kHAAkH;qBACnH;aACR,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,MAAM,cAAc,GAAiB;QACnC,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,8HAA8H;QAChI,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAC/C,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE;QAC1D,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACpB,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW;YAClC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS;YAC/B,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa;SACxC,CAAC;KACH,CAAC;IAEF,MAAM,mBAAmB,GAAiB;QACxC,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACT,kOAAkO;QACpO,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+EAA+E;iBAC7F;aACF;SACF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,IAAI,EAAE;QAC9D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC;YACvC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;gBACvC,OAAO;oBACL,SAAS,EAAE,SAAS;oBACpB,QAAQ,EAAE,QAAQ;oBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,cAAc,EAAE,IAAI;oBACpB,IAAI,EAAE,+IAA+I;oBACrJ,aAAa,EAAE,KAAK,CAAC,KAAK;iBAC3B,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACzC,OAAO;gBACL,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,mBAAmB;gBAC/B,SAAS,EAAE,CAAC,CAAC,aAAa;gBAC1B,cAAc,EAAE,CAAC,CAAC,aAAa;gBAC/B,aAAa,EAAE,KAAK,CAAC,KAAK;gBAC1B,GAAG,CAAC,CAAC,CAAC,QAAQ;oBACZ,CAAC,CAAC,EAAE,eAAe,EAAE,sBAAsB,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,mBAAmB,CAAC,EAAE;oBACrG,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,MAAM,2BAA2B,GAAiB;QAChD,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,0QAA0Q;QAC5Q,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4EAA4E;iBAC1F;aACF;SACF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,IAAI,EAAE;QACnE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,mBAAmB,CAAC;YACrF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,uBAAuB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9E,CAAC;KACF,CAAC;IAEF,MAAM,uBAAuB,GAAiB;QAC5C,IAAI,EAAE,2BAA2B;QACjC,WAAW,EACT,qUAAqU;QACvU,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;gBACjG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE;gBAChG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;gBACtG,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;aACpG;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;SAC3B;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;QAC5F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;YAC9D,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACpF,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YAC5F,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;YAExH,kFAAkF;YAClF,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAC1B,OAAO;oBACL,MAAM,EAAE,UAAU;oBAClB,MAAM,EAAE,iBAAiB;oBACzB,IAAI;oBACJ,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;oBACrC,OAAO,EAAE,IAAI,IAAI,0BAA0B,IAAI,aAAa,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,KAAK,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,uCAAuC;iBACpL,CAAC;YACJ,CAAC;YAED,2EAA2E;YAC3E,8EAA8E;YAC9E,MAAM,IAAI,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,6BAA6B,CAAC;YACxF,MAAM,SAAS,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,sBAAsB,CAAC;YAC/E,MAAM,SAAS,GACb,GAAG,CAAC,YAAY,EAAE,SAAS;gBAC3B,CAAC,OAAO,IAAI,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACjG,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,EAAE,UAAU,IAAI,KAAK,CAAC;YAEzD,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;YACvC,IAAI,KAA0C,CAAC;YAC/C,IAAI,UAAU,GAAsC,EAAE,CAAC;YACvD,SAAS,CAAC;gBACR,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,aAAa,CAA4C,IAAI,EAAE;wBAC1F,OAAO,EAAE,SAAS;wBAClB,MAAM,EAAE,OAAO;wBACf,CAAC,SAAS,CAAC,EAAE,IAAI;wBACjB,kBAAkB,EAAE,MAAM;wBAC1B,SAAS,EAAE,IAAI;qBAChB,CAAC,CAAC;oBACH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtD,oEAAoE;oBACpE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;wBACvB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;wBACvD,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,SAAS,GAAG,KAAK,EAAE,CAAC;4BACnD,KAAK,GAAG,GAAG,CAAC;4BACZ,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;4BACrD,UAAU,GAAG,QAAQ,CAAC;4BACtB,MAAM;wBACR,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,8CAA8C;gBAChD,CAAC;gBACD,IAAI,KAAK;oBAAE,MAAM;gBACjB,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC/C,IAAI,KAAK,GAAG,UAAU,IAAI,QAAQ;oBAAE,MAAM;gBAC1C,MAAM,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;oBACL,MAAM,EAAE,SAAS;oBACjB,UAAU,EAAE,SAAS;oBACrB,IAAI;oBACJ,IAAI;oBACJ,OAAO,EAAE,OAAO,IAAI,KAAK,IAAI,iGAAiG;iBAC/H,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO;oBACL,MAAM,EAAE,aAAa;oBACrB,UAAU,EAAE,SAAS;oBACrB,IAAI;oBACJ,IAAI;oBACJ,cAAc,EAAE,UAAU;oBAC1B,OAAO,EAAE,UAAU,IAAI,gDAAgD,UAAU;yBAC9E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;yBACjB,IAAI,CAAC,IAAI,CAAC,yEAAyE;iBACvF,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,UAAU,EAAE,SAAS;gBACrB,IAAI;gBACJ,IAAI;gBACJ,OAAO,EAAE,UAAU,IAAI,mEAAmE;aAC3F,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,aAAa;QACb,WAAW;QACX,cAAc;QACd,mBAAmB;QACnB,2BAA2B;QAC3B,uBAAuB;KACxB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,SAAS,KAAK,CAAC,EAAU,EAAE,MAAsC;IAC/D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,mBAAmB,CAAC,UAAmB;IAC9C,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC7D,OAAO,SAAS,CAAC,UAAqC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACzG,CAAC"}

package/dist/tools/shared.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+export declare const PERIOD_SCHEMA: {
+    readonly type: "string";
+    readonly description: "Time period for the report. Examples: \"today\", \"yesterday\", \"7d\", \"30d\", \"90d\", \"this_month\", \"last_month\", \"this_year\". Default: \"30d\".";
+    readonly enum: readonly ["today", "yesterday", "7d", "30d", "90d", "12m", "this_week", "wtd", "last_week", "this_month", "mtd", "last_month", "this_quarter", "qtd", "last_quarter", "this_year", "ytd", "last_year"];
+    readonly default: "30d";
+};
+export declare const COMPARE_SCHEMA: {
+    readonly type: "string";
+    readonly description: "Comparison mode. \"previous\" compares with the prior period of the same length. \"yoy\" compares with the same dates last year.";
+    readonly enum: readonly ["previous", "yoy"];
+};
+export declare const LIMIT_SCHEMA: {
+    readonly type: "number";
+    readonly description: "Maximum number of rows to return (default: 20, max: 100).";
+    readonly default: 20;
+};
+export declare const SORT_ORDER_SCHEMA: {
+    readonly type: "string";
+    readonly description: "Sort direction: \"asc\" or \"desc\" (default: \"desc\").";
+    readonly enum: readonly ["asc", "desc"];
+    readonly default: "desc";
+};
+export declare const PAGE_SCHEMA: {
+    readonly type: "number";
+    readonly description: "Page number for paginated results (default: 1).";
+    readonly default: 1;
+};
+/**
+ * Resolve site_id from tool args or SEALMETRICS_SITE_ID env var.
+ * Throws if neither is available.
+ */
+export declare function resolveSiteId(args: Record<string, unknown>): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/tools/shared.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,eAAO,MAAM,cAAc;;;;CAKjB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CASnE"}

package/dist/tools/shared.js ADDED Viewed

@@ -0,0 +1,40 @@
+import { VALID_PERIODS } from "../types.js";
+export const PERIOD_SCHEMA = {
+    type: "string",
+    description: `Time period for the report. Examples: "today", "yesterday", "7d", "30d", "90d", "this_month", "last_month", "this_year". Default: "30d".`,
+    enum: [...VALID_PERIODS],
+    default: "30d",
+};
+export const COMPARE_SCHEMA = {
+    type: "string",
+    description: 'Comparison mode. "previous" compares with the prior period of the same length. "yoy" compares with the same dates last year.',
+    enum: ["previous", "yoy"],
+};
+export const LIMIT_SCHEMA = {
+    type: "number",
+    description: "Maximum number of rows to return (default: 20, max: 100).",
+    default: 20,
+};
+export const SORT_ORDER_SCHEMA = {
+    type: "string",
+    description: 'Sort direction: "asc" or "desc" (default: "desc").',
+    enum: ["asc", "desc"],
+    default: "desc",
+};
+export const PAGE_SCHEMA = {
+    type: "number",
+    description: "Page number for paginated results (default: 1).",
+    default: 1,
+};
+/**
+ * Resolve site_id from tool args or SEALMETRICS_SITE_ID env var.
+ * Throws if neither is available.
+ */
+export function resolveSiteId(args) {
+    const siteId = args.site_id ?? process.env.SEALMETRICS_SITE_ID;
+    if (!siteId) {
+        throw new Error('site_id is required. Either pass it as a parameter or set the SEALMETRICS_SITE_ID environment variable.');
+    }
+    return siteId;
+}
+//# sourceMappingURL=shared.js.map

package/dist/tools/shared.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,0IAA0I;IACvJ,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC;IACxB,OAAO,EAAE,KAAK;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,8HAA8H;IAChI,IAAI,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC;CACjB,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,2DAA2D;IACxE,OAAO,EAAE,EAAE;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,oDAAoD;IACjE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iDAAiD;IAC9D,OAAO,EAAE,CAAC;CACF,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAA6B;IACzD,MAAM,MAAM,GACT,IAAI,CAAC,OAA8B,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/sites.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import type { ToolDef } from "./index.js";
+export declare const listSitesTool: ToolDef;
+export declare const getSiteTool: ToolDef;
+//# sourceMappingURL=sites.d.ts.map

package/dist/tools/sites.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"sites.d.ts","sourceRoot":"","sources":["../../src/tools/sites.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,aAAa,EAAE,OAiB3B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,OAiBzB,CAAC"}

package/dist/tools/sites.js ADDED Viewed

@@ -0,0 +1,36 @@
+import { resolveSiteId } from "./shared.js";
+export const listSitesTool = {
+    name: "list_sites",
+    description: "List all sites (web properties) accessible with your API key. Returns site IDs, names, and domains. Use this to find the site_id needed for other tools.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+    handler: async (client) => {
+        const data = await client.request("/sites");
+        return data.sites.map((s) => ({
+            site_id: s.id,
+            name: s.name,
+            domains: s.domains,
+            timezone: s.timezone,
+        }));
+    },
+};
+export const getSiteTool = {
+    name: "get_site",
+    description: "Get detailed information about a specific site: name, domains, timezone, configuration, and tracking status. Use list_sites first to find available site IDs.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        const siteId = resolveSiteId(args);
+        return client.request(`/sites/${encodeURIComponent(siteId)}`);
+    },
+};
+//# sourceMappingURL=sites.js.map

package/dist/tools/sites.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"sites.js","sourceRoot":"","sources":["../../src/tools/sites.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,0JAA0J;IAC5J,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE,EAAE;KACf;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAmB,QAAQ,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC,CAAC,EAAE;YACb,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAY;IAClC,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,+JAA+J;IACjK,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,OAAO,CAAU,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;CACF,CAAC"}

package/dist/tools/tracking.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./index.js";
+export declare const getTrackingCodeTool: ToolDef;
+//# sourceMappingURL=tracking.d.ts.map

package/dist/tools/tracking.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/tools/tracking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAoN1C,eAAO,MAAM,mBAAmB,EAAE,OA+BjC,CAAC"}