@interfere/vite 0.1.2 → 10.0.1-canary.0

package/dist/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../src/plugin.ts"],"sourcesContent":["import { execSync } from \"node:child_process\";\nimport type { HtmlTagDescriptor, Plugin } from \"vite\";\n\nexport interface InterfereViteOptions {\n  buildId?: string;\n  releaseId?: string;\n}\n\nfunction resolveGitSha(): string | null {\n  try {\n    return execSync(\"git rev-parse HEAD\", { encoding: \"utf8\" }).trim();\n  } catch {\n    return null;\n  }\n}\n\nexport function interfere(options?: InterfereViteOptions): Plugin {\n  let buildId: string;\n  let releaseId: string;\n  let publicKey: string | undefined;\n\n  return {\n    name: \"interfere\",\n    enforce: \"pre\",\n\n    configResolved(config) {\n      buildId =\n        options?.buildId ??\n        config.env[\"VITE_INTERFERE_BUILD_ID\"] ??\n        resolveGitSha() ??\n        crypto.randomUUID();\n\n      releaseId = options?.releaseId ?? buildId;\n\n      publicKey = config.env[\"VITE_INTERFERE_PUBLIC_KEY\"];\n    },\n\n    transformIndexHtml() {\n      const assignments = [\n        `globalThis[\"__INTERFERE_BUILD_ID__\"]=${JSON.stringify(buildId)};`,\n        `globalThis[\"__INTERFERE_RELEASE_ID__\"]=${JSON.stringify(releaseId)};`,\n      ];\n\n      if (publicKey) {\n        assignments.push(\n          `globalThis[\"__INTERFERE_PUBLIC_KEY__\"]=${JSON.stringify(publicKey)};`\n        );\n      }\n\n      return [\n        {\n          tag: \"script\",\n          children: assignments.join(\"\"),\n          injectTo: \"head-prepend\",\n        },\n      ] satisfies HtmlTagDescriptor[];\n    },\n  };\n}\n\nexport default interfere;\n"],"mappings":";;AAQA,SAAS,gBAA+B;AACtC,KAAI;AACF,SAAO,SAAS,sBAAsB,EAAE,UAAU,QAAQ,CAAC,CAAC,MAAM;SAC5D;AACN,SAAO;;;AAIX,SAAgB,UAAU,SAAwC;CAChE,IAAI;CACJ,IAAI;CACJ,IAAI;AAEJ,QAAO;EACL,MAAM;EACN,SAAS;EAET,eAAe,QAAQ;AACrB,aACE,SAAS,WACT,OAAO,IAAI,8BACX,eAAe,IACf,OAAO,YAAY;AAErB,eAAY,SAAS,aAAa;AAElC,eAAY,OAAO,IAAI;;EAGzB,qBAAqB;GACnB,MAAM,cAAc,CAClB,wCAAwC,KAAK,UAAU,QAAQ,CAAC,IAChE,0CAA0C,KAAK,UAAU,UAAU,CAAC,GACrE;AAED,OAAI,UACF,aAAY,KACV,0CAA0C,KAAK,UAAU,UAAU,CAAC,GACrE;AAGH,UAAO,CACL;IACE,KAAK;IACL,UAAU,YAAY,KAAK,GAAG;IAC9B,UAAU;IACX,CACF;;EAEJ"}
+{"version":3,"file":"plugin.mjs","names":["resolvePath"],"sources":["../src/plugin.ts"],"sourcesContent":["import { API_URL } from \"@interfere/constants/api\";\nimport {\n  deriveReleaseSlug,\n  type ReleaseSlug,\n} from \"@interfere/types/releases/slug\";\n\nimport { existsSync, readdirSync, statSync } from \"node:fs\";\nimport { join, resolve as resolvePath } from \"node:path\";\nimport {\n  type HtmlTagDescriptor,\n  type Logger,\n  loadEnv,\n  type Plugin,\n  type ResolvedConfig,\n} from \"vite\";\n\nimport {\n  createSdkClient,\n  runReleasePipeline,\n} from \"./internal/build/pipeline.js\";\nimport { discoverByPairing } from \"./internal/build/source-maps.js\";\nimport { resolveCommitSha } from \"./internal/release-slug.js\";\nimport { PRODUCER_VERSION } from \"./version.js\";\n\nexport type InterfereViteMode = \"auto\" | \"direct\" | \"proxy\";\n\nexport interface InterfereViteOptions {\n  /**\n   * Override the commit SHA used to derive the release slug. Defaults\n   * to `VITE_INTERFERE_COMMIT_SHA` env then `git rev-parse HEAD`.\n   * Set this when the build runs outside a git checkout (e.g. a\n   * Docker layer-cached image build).\n   */\n  commitSha?: string;\n  /**\n   * How the runtime SDK should reach the collector.\n   *\n   *   - `\"auto\"` (default) — detect from the surrounding plugin set:\n   *     if `tanstack-start` / `nitro` is present, choose\n   *     `\"proxy\"`; otherwise `\"direct\"`.\n   *   - `\"direct\"` — stamp `__INTERFERE_PUBLIC_KEY__` into the bundle\n   *     so the kernel posts ingest at the configured collector URL\n   *     directly (`in.interfere.com/v2/sink`). The only option for\n   *     vanilla Vite SPAs.\n   *   - `\"proxy\"` — stamp the public key and force the kernel to post\n   *     ingest at `/api/interfere/*`. The server-side handler forwards\n   *     requests through as a first-party collector proxy. Strongly\n   *     preferred for any deployment with a server origin because adblock filter\n   *     lists target the collector hostname more aggressively than\n   *     first-party paths.\n   */\n  mode?: InterfereViteMode;\n  /**\n   * `false` skips the post-build release metadata pipeline. Defaults\n   * to enabled when an `INTERFERE_API_KEY` is set; defaults to\n   * disabled when one isn't (so dev runs without creds don't fail).\n   * Useful when source maps are uploaded out-of-band via the\n   * `@interfere/cli`.\n   */\n  sourceMaps?: boolean;\n}\n\nconst SERVER_RUNTIME_PLUGIN_HINTS = [\n  \"tanstack-start\",\n  \"nitro\",\n  \"@tanstack/react-start\",\n] as const;\n\nfunction isTruthyEnvFlag(value: string | undefined): boolean {\n  if (!value) {\n    return false;\n  }\n  const normalized = value.trim().toLowerCase();\n  return normalized === \"1\" || normalized === \"true\";\n}\n\nfunction isTestEnv(): boolean {\n  return Boolean(process.env[\"VITEST\"] || process.env[\"VITEST_WORKER_ID\"]);\n}\n\n/**\n * Fail the build with a Next-style error block when the public key\n * env var is absent during a production build. Skipped\n * in dev (`vite serve`) and in\n * test runs (so plugin-level tests can exercise the configuration\n * surface without crashing the test process).\n */\nfunction failMissingPublicKey(): never {\n  const lines = [\n    \"interfere() requires VITE_INTERFERE_PUBLIC_KEY to identify your project at runtime.\",\n    \"Set the VITE_INTERFERE_PUBLIC_KEY environment variable, or remove interfere() from your Vite config.\",\n    \"See: https://support.interfere.com/docs/guides/vite\",\n  ];\n  if (isTestEnv()) {\n    throw new Error(`Interfere: Public key not set\\n${lines.join(\"\\n\")}`);\n  }\n  console.error(\"\\n⨯ Interfere → Public key not set\");\n  for (let i = 0; i < lines.length; i += 1) {\n    const line = lines[i];\n    if (!line) {\n      continue;\n    }\n    const connector = i === lines.length - 1 ? \"└\" : \"├\";\n    console.error(` ${connector} ${line}`);\n  }\n  process.exit(1);\n}\n\nfunction detectServerRuntime(config: ResolvedConfig): boolean {\n  return config.plugins.some((p) =>\n    SERVER_RUNTIME_PLUGIN_HINTS.some((hint) => p.name?.includes(hint))\n  );\n}\n\nfunction resolveMode(\n  optsMode: InterfereViteMode | undefined,\n  config: ResolvedConfig,\n  logger: Logger\n): \"direct\" | \"proxy\" {\n  const requested = optsMode ?? \"auto\";\n  if (requested !== \"auto\") {\n    logger.info(\n      `[interfere] mode=${requested} (explicit). Plugin will ${\n        requested === \"direct\"\n          ? \"stamp the public key for direct ingestion\"\n          : \"stamp the public key and run the SDK in proxy mode\"\n      }.`\n    );\n    return requested;\n  }\n  const detected = detectServerRuntime(config) ? \"proxy\" : \"direct\";\n  logger.info(\n    `[interfere] mode=${detected} (auto-detected). Override with \\`interfere({ mode: \"...\" })\\`.`\n  );\n  return detected;\n}\n\ninterface PluginState {\n  apiKey: string | undefined;\n  apiUrl: string;\n  /**\n   * The runtime collector URL stamped onto `__INTERFERE_API_URL__`\n   * for the browser kernel. Distinct from `apiUrl` (server-side\n   * env, used by the build pipeline) — direct-mode customers\n   * pointing at a regional collector / self-hosted gateway /\n   * localhost need to set `VITE_INTERFERE_API_URL` separately so\n   * the browser bundle's destination matches the server-side one.\n   * `undefined` in proxy mode and when the env is unset (kernel\n   * falls through to the compiled-in `API_URL`).\n   */\n  browserApiUrl: string | undefined;\n  buildStartedAt: number;\n  commitSha: string | null;\n  enableUpload: boolean;\n  forceEnable: boolean;\n  logger: Logger;\n  mode: \"direct\" | \"proxy\";\n  projectDir: string;\n  publicKey: string | undefined;\n  releaseSlug: ReleaseSlug | null;\n  uploadOutDir: string;\n  uploadStarted: boolean;\n}\n\ntype UploadReadyPluginState = PluginState & {\n  apiKey: string;\n  commitSha: string;\n  releaseSlug: ReleaseSlug;\n};\n\nfunction hasFreshServerSourceMaps(root: string, sinceMs: number): boolean {\n  if (!existsSync(root)) {\n    return false;\n  }\n  const entries = readdirSync(root, { withFileTypes: true });\n  for (const entry of entries) {\n    const absolute = join(root, entry.name);\n    if (entry.isDirectory()) {\n      if (hasFreshServerSourceMaps(absolute, sinceMs)) {\n        return true;\n      }\n      continue;\n    }\n    if (!entry.name.endsWith(\".map\")) {\n      continue;\n    }\n    if (statSync(absolute).mtimeMs >= sinceMs) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction isUploadReady(state: PluginState): state is UploadReadyPluginState {\n  return Boolean(\n    state.enableUpload &&\n      state.apiKey &&\n      state.releaseSlug &&\n      state.commitSha &&\n      !state.uploadStarted\n  );\n}\n\nfunction shouldWaitForServerOutput(state: UploadReadyPluginState): boolean {\n  return (\n    state.mode === \"proxy\" &&\n    !hasFreshServerSourceMaps(\n      join(state.uploadOutDir, \"server\"),\n      state.buildStartedAt\n    )\n  );\n}\n\ntype ReleasePipelineFailure = Extract<\n  Awaited<ReturnType<typeof runReleasePipeline>>,\n  { ok: false }\n>[\"failure\"];\ntype ReleasePipelineSuccess = Extract<\n  Awaited<ReturnType<typeof runReleasePipeline>>,\n  { ok: true }\n>;\n\nfunction logSkippedRelease(\n  logger: Logger,\n  failure: ReleasePipelineFailure\n): void {\n  if (failure.kind === \"missing_source_provider\") {\n    logger.warn(\n      `[interfere] release skipped: this surface has no version control provider configured. Configure one at https://interfere.com/~/${failure.config.org.slug}/surfaces/${failure.config.surface.slug}.`\n    );\n    return;\n  }\n  logger.warn(\n    `[interfere] release skipped: this surface has no deployment target configured. Configure one at https://interfere.com/~/${failure.config.org.slug}/surfaces/${failure.config.surface.slug}.`\n  );\n}\n\nfunction logCleanupFailures(\n  logger: Logger,\n  failures: ReleasePipelineSuccess[\"data\"][\"cleanupFailures\"]\n): void {\n  for (const failure of failures) {\n    logger.warn(\n      `[interfere] cleanup left ${failure.absolute} on disk: ${failure.code ?? failure.message}`\n    );\n  }\n}\n\nasync function uploadSourceMaps(state: UploadReadyPluginState): Promise<void> {\n  const {\n    apiKey,\n    apiUrl,\n    releaseSlug,\n    commitSha,\n    logger,\n    projectDir,\n    uploadOutDir,\n  } = state;\n\n  logger.info(`[interfere] uploading source maps for release ${releaseSlug}…`);\n\n  try {\n    const { sdk } = createSdkClient({ apiKey, apiUrl });\n\n    const [discovered, releasesConfig] = await Promise.all([\n      discoverByPairing({\n        projectDir,\n        distDir: uploadOutDir,\n        // Walk the entire dist tree as a flat root. Covers vanilla Vite\n        // and TanStack Start + Nitro under one preflighted release.\n        subtrees: [\".\"],\n        // Nitro serves `dist/public` at the deployment root, while server\n        // chunks keep their `server/...` filesystem suffix.\n        publicPathRewrites: [{ from: \"public\", to: \"\" }],\n      }),\n      sdk.releases.getConfig(),\n    ]);\n\n    if (discovered.files.length === 0) {\n      logger.info(\"[interfere] no source maps found, skipping upload.\");\n      return;\n    }\n\n    const result = await runReleasePipeline({\n      apiKey,\n      apiUrl,\n      bundler: \"rollup\",\n      buildId: commitSha,\n      discovery: discovered,\n      producerVersion: PRODUCER_VERSION,\n      releasesConfig,\n      releaseSlug,\n    });\n\n    if (!result.ok) {\n      logSkippedRelease(logger, result.failure);\n      return;\n    }\n\n    logCleanupFailures(logger, result.data.cleanupFailures);\n    logger.info(\n      `[interfere] release ${result.data.releaseSlug} confirmed — ${result.data.fileCount} maps, ${result.data.timing.total}ms.`\n    );\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    logger.warn(\n      `[interfere] release pipeline failed: ${message}. Build continues; events from this release will ingest but be ignored as evidence.`\n    );\n  }\n}\n\nasync function uploadSourceMapsWhenReady(state: PluginState): Promise<void> {\n  if (!isUploadReady(state)) {\n    return;\n  }\n  if (shouldWaitForServerOutput(state)) {\n    state.logger.info(\n      \"[interfere] waiting for Nitro server output before uploading source maps.\"\n    );\n    return;\n  }\n  state.uploadStarted = true;\n  await uploadSourceMaps(state);\n}\n\nfunction emitSetupWarnings(\n  state: Pick<PluginState, \"apiKey\" | \"logger\" | \"mode\" | \"releaseSlug\"> & {\n    isProductionBuild: boolean;\n    publicKeyPresent: boolean;\n    sourceMapsExplicit: boolean | undefined;\n  }\n): void {\n  const {\n    logger,\n    mode,\n    publicKeyPresent,\n    apiKey,\n    releaseSlug,\n    sourceMapsExplicit,\n    isProductionBuild,\n  } = state;\n\n  if (mode === \"proxy\" && publicKeyPresent) {\n    logger.info(\n      \"[interfere] mode=proxy: using VITE_INTERFERE_PUBLIC_KEY with the first-party proxy route.\"\n    );\n  }\n  if (sourceMapsExplicit !== false && apiKey && !releaseSlug) {\n    logger.warn(\n      \"[interfere] No commit SHA available. Release metadata publishing is disabled. Set INTERFERE_SOURCE_ID, expose VERCEL_GIT_COMMIT_SHA / GITHUB_SHA, or run inside a git checkout.\"\n    );\n  }\n  if (isProductionBuild && sourceMapsExplicit !== false && !apiKey) {\n    logger.warn(\n      \"[interfere] INTERFERE_API_KEY is not set. Release metadata will not be published. Create an Interfere API key in the dashboard and set it in your build environment, or pass `interfere({ sourceMaps: false })` to suppress this warning if release metadata is intentionally handled out-of-band.\"\n    );\n  }\n}\n\nfunction buildPluginState(\n  options: InterfereViteOptions,\n  config: ResolvedConfig\n): PluginState {\n  const logger = config.logger;\n  const mode = resolveMode(options.mode, config, logger);\n  const publicKey = config.env[\"VITE_INTERFERE_PUBLIC_KEY\"];\n\n  if (config.command === \"build\" && !publicKey) {\n    failMissingPublicKey();\n  }\n\n  const explicitSha =\n    options.commitSha ?? config.env[\"VITE_INTERFERE_COMMIT_SHA\"];\n  const commitSha = explicitSha ?? resolveCommitSha();\n  const releaseSlug = commitSha ? deriveReleaseSlug(commitSha) : null;\n\n  const fileEnv = loadEnv(config.mode, config.envDir, \"\");\n  const pickEnv = (key: string): string | undefined => {\n    const shell = process.env[key];\n    if (shell && shell.length > 0) {\n      return shell;\n    }\n    const file = fileEnv[key];\n    return file && file.length > 0 ? file : undefined;\n  };\n  const apiKey = pickEnv(\"INTERFERE_API_KEY\");\n  const apiUrl = pickEnv(\"INTERFERE_API_URL\") ?? API_URL;\n  const enableUpload =\n    options.sourceMaps ??\n    (apiKey !== undefined && apiKey.length > 0 && releaseSlug !== null);\n\n  const rawBrowserApiUrl = config.env[\"VITE_INTERFERE_API_URL\"];\n  const browserApiUrl =\n    rawBrowserApiUrl && rawBrowserApiUrl.length > 0\n      ? rawBrowserApiUrl\n      : undefined;\n\n  emitSetupWarnings({\n    apiKey,\n    isProductionBuild: config.command === \"build\",\n    logger,\n    mode,\n    publicKeyPresent: Boolean(publicKey),\n    releaseSlug,\n    sourceMapsExplicit: options.sourceMaps,\n  });\n\n  return {\n    apiKey,\n    apiUrl,\n    browserApiUrl: mode === \"direct\" ? browserApiUrl : undefined,\n    commitSha,\n    enableUpload,\n    forceEnable: isTruthyEnvFlag(config.env[\"VITE_INTERFERE_FORCE_ENABLE\"]),\n    logger,\n    mode,\n    projectDir: config.root,\n    publicKey,\n    releaseSlug,\n    uploadOutDir: resolvePath(config.root, config.build.outDir),\n    uploadStarted: false,\n    buildStartedAt: Date.now(),\n  };\n}\n\nexport function interfere(options: InterfereViteOptions = {}): Plugin {\n  let state: PluginState | null = null;\n\n  return {\n    name: \"interfere\",\n    enforce: \"pre\",\n\n    configResolved(config) {\n      const next = buildPluginState(options, config);\n      if (state?.mode === \"proxy\" && next.mode === \"proxy\") {\n        next.uploadOutDir = state.uploadOutDir;\n        next.uploadStarted = state.uploadStarted;\n        next.buildStartedAt = state.buildStartedAt;\n      }\n      state = next;\n    },\n\n    transformIndexHtml() {\n      const assignments: string[] = [];\n      if (state?.releaseSlug) {\n        assignments.push(\n          `globalThis[\"__INTERFERE_RELEASE_SLUG__\"]=${JSON.stringify(state.releaseSlug)};`\n        );\n      }\n      if (state?.publicKey) {\n        assignments.push(\n          `globalThis[\"__INTERFERE_PUBLIC_KEY__\"]=${JSON.stringify(state.publicKey)};`\n        );\n      }\n      if (state?.forceEnable) {\n        assignments.push('globalThis[\"__INTERFERE_FORCE_ENABLE__\"]=true;');\n      }\n      if (state?.mode === \"proxy\" && state.publicKey) {\n        assignments.push('globalThis[\"__INTERFERE_PROXY_MODE__\"]=true;');\n      }\n      if (state?.mode === \"direct\" && state.browserApiUrl) {\n        assignments.push(\n          `globalThis[\"__INTERFERE_API_URL__\"]=${JSON.stringify(state.browserApiUrl)};`\n        );\n      }\n\n      if (assignments.length === 0) {\n        return [];\n      }\n\n      return [\n        {\n          tag: \"script\",\n          children: assignments.join(\"\"),\n          injectTo: \"head-prepend\",\n        },\n      ] satisfies HtmlTagDescriptor[];\n    },\n\n    async closeBundle() {\n      if (!state) {\n        return;\n      }\n      await uploadSourceMapsWhenReady(state);\n    },\n  };\n}\n\nexport default interfere;\n"],"mappings":"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"}

package/dist/provider.d.mts

@@ -0,0 +1,20 @@
+import { useInterfere, useSession } from "@interfere/react/provider";
+import { PropsWithChildren, ReactNode } from "react";
+import { ConsentCategory, ConsentState, ConsentState as ConsentState$1, GateableCategory } from "@interfere/types/sdk/plugins/manifest";
+
+//#region src/provider.d.ts
+interface InterfereProviderProps extends PropsWithChildren {
+  consent?: ConsentState$1 | undefined;
+  errorBoundary?: boolean;
+}
+/**
+ * Vite wrapper around `@interfere/react`'s provider that reads the
+ * kernel created by `@interfere/vite/init`.
+ */
+declare function InterfereProvider({
+  children,
+  consent,
+  errorBoundary
+}: InterfereProviderProps): ReactNode;
+//#endregion
+export { type ConsentCategory, type ConsentState, type GateableCategory, InterfereProvider, useInterfere, useSession };

package/dist/provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.mts","names":[],"sources":["../src/provider.tsx"],"mappings":";;;;;UAaU,sBAAA,SAA+B,iBAAiB;EACxD,OAAA,GAAU,cAAA;EACV,aAAA;AAAA;;;;;iBAOc,iBAAA,CAAA;EACd,QAAA;EACA,OAAA;EACA;AAAA,GACC,sBAAA,GAAyB,SAAA"}

package/dist/provider.mjs

@@ -0,0 +1 @@
+import{getKernelOrNull,subscribeToKernel}from"./init.mjs";import{InterfereProvider as InterfereProvider$1,useInterfere,useSession}from"@interfere/react/provider";import{useSyncExternalStore}from"react";import{jsx}from"react/jsx-runtime";const nullSnapshot=()=>null;function InterfereProvider({children,consent,errorBoundary}){return jsx(InterfereProvider$1,{kernel:useSyncExternalStore(subscribeToKernel,getKernelOrNull,nullSnapshot),...consent===void 0?{}:{consent},...errorBoundary===void 0?{}:{errorBoundary},children})}export{InterfereProvider,useInterfere,useSession};

package/dist/provider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.mjs","names":["CoreInterfereProvider"],"sources":["../src/provider.tsx"],"sourcesContent":["import { InterfereProvider as CoreInterfereProvider } from \"@interfere/react/provider\";\nimport type { ConsentState } from \"@interfere/types/sdk/plugins/manifest\";\n\nimport {\n  type PropsWithChildren,\n  type ReactNode,\n  useSyncExternalStore,\n} from \"react\";\n\nimport { getKernelOrNull, subscribeToKernel } from \"./init.js\";\n\nconst nullSnapshot = () => null;\n\ninterface InterfereProviderProps extends PropsWithChildren {\n  consent?: ConsentState | undefined;\n  errorBoundary?: boolean;\n}\n\n/**\n * Vite wrapper around `@interfere/react`'s provider that reads the\n * kernel created by `@interfere/vite/init`.\n */\nexport function InterfereProvider({\n  children,\n  consent,\n  errorBoundary,\n}: InterfereProviderProps): ReactNode {\n  const kernel = useSyncExternalStore(\n    subscribeToKernel,\n    getKernelOrNull,\n    nullSnapshot\n  );\n  return (\n    <CoreInterfereProvider\n      kernel={kernel}\n      {...(consent === undefined ? {} : { consent })}\n      {...(errorBoundary === undefined ? {} : { errorBoundary })}\n    >\n      {children}\n    </CoreInterfereProvider>\n  );\n}\n\n// biome-ignore lint/performance/noBarrelFile: Vite provider entrypoint re-exports the React SDK hooks for one-line customer setup.\nexport { useInterfere, useSession } from \"@interfere/react/provider\";\nexport type {\n  ConsentCategory,\n  ConsentState,\n  GateableCategory,\n} from \"@interfere/types/sdk/plugins/manifest\";\n"],"mappings":"6OAWA,MAAM,iBAAqB,KAW3B,SAAgB,kBAAkB,CAChC,SACA,QACA,eACoC,CAMpC,OACE,IAACA,oBAAD,CACE,OAPW,qBACb,kBACA,gBACA,YAIe,EACb,GAAK,UAAY,IAAA,GAAY,CAAC,EAAI,CAAE,OAAQ,EAC5C,GAAK,gBAAkB,IAAA,GAAY,CAAC,EAAI,CAAE,aAAc,EAEvD,QACoB,CAAA,CAE3B"}

package/dist/server.d.mts

@@ -0,0 +1,6 @@
+import { CaptureErrorContext } from "./internal/server/types.mjs";
+import { captureError } from "./internal/server/capture.mjs";
+import { ServerInstrumentationOptions } from "./internal/server/instrumentation-options.mjs";
+import { register } from "./internal/server/register.mjs";
+import { TraceMeta } from "./internal/server/trace-meta.mjs";
+export { type CaptureErrorContext, type ServerInstrumentationOptions, TraceMeta, captureError, register };

package/dist/server.mjs

@@ -0,0 +1 @@
+import{captureError}from"./internal/server/capture.mjs";import{register}from"./internal/server/register.mjs";import{TraceMeta}from"./internal/server/trace-meta.mjs";export{TraceMeta,captureError,register};

package/dist/version.mjs

@@ -1,5 +1 @@
-import { name, version } from "./package.mjs";
-//#region src/version.ts
-const PRODUCER_VERSION = `${name}@${version}`;
-//#endregion
-export { PRODUCER_VERSION };
+import{name,version}from"./package.mjs";const PRODUCER_VERSION=`${name}@${version}`;export{PRODUCER_VERSION};

package/dist/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","names":["pkg.name","pkg.version"],"sources":["../src/version.ts"],"sourcesContent":["import pkg from \"../package.json\" with { type: \"json\" };\n\nexport const PRODUCER_VERSION = `${pkg.name}@${pkg.version}`;\n"],"mappings":";;AAEA,MAAa,mBAAmB,GAAGA,KAAS,GAAGC"}
+{"version":3,"file":"version.mjs","names":["pkg.name","pkg.version"],"sources":["../src/version.ts"],"sourcesContent":["import pkg from \"../package.json\" with { type: \"json\" };\n\nexport const PRODUCER_VERSION = `${pkg.name}@${pkg.version}`;\n"],"mappings":"wCAEA,MAAa,iBAAmB,GAAGA,KAAS,GAAGC"}

package/dist/vite-env.d.mts

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

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "@interfere/vite",
-  "version": "0.1.2",
+  "version": "10.0.1-canary.0",
   "license": "MIT",
-  "description": "Vite build plugin and client initialization for Interfere.",
+  "description": "Vite build plugin and client + server initialization for Interfere.",
   "keywords": [
     "observability",
-    "typescript",
+    "@typescript/native-preview",
     "vite",
+    "tanstack-start",
+    "nitro",
     "error-tracking",
     "session-replay"
   ],
@@ -26,34 +28,73 @@
   "type": "module",
   "exports": {
     "./plugin": {
-      "@source": "./src/plugin.ts",
+      "monorepo": "./src/plugin.ts",
       "types": "./dist/plugin.d.mts",
       "default": "./dist/plugin.mjs"
     },
     "./init": {
-      "@source": "./src/init.ts",
+      "monorepo": "./src/init.ts",
       "types": "./dist/init.d.mts",
       "default": "./dist/init.mjs"
+    },
+    "./provider": {
+      "monorepo": "./src/provider.tsx",
+      "types": "./dist/provider.d.mts",
+      "default": "./dist/provider.mjs"
+    },
+    "./server": {
+      "monorepo": "./src/server.ts",
+      "types": "./dist/server.d.mts",
+      "default": "./dist/server.mjs"
+    },
+    "./handler": {
+      "monorepo": "./src/handler.ts",
+      "types": "./dist/handler.d.mts",
+      "default": "./dist/handler.mjs"
     }
   },
-  "sideEffects": false,
   "publishConfig": {
-    "access": "public",
-    "tag": "alpha"
+    "access": "public"
   },
   "scripts": {
     "build": "tsdown",
-    "test": "vitest run --coverage",
-    "typecheck": "tsc --noEmit --incremental"
+    "test": "vitest run",
+    "typecheck": "tsgo --noEmit --incremental"
   },
   "dependencies": {
-    "@interfere/react": "^9.0.0",
-    "@interfere/types": "^9.0.0"
+    "@interfere/constants": "^9.0.2-canary.0",
+    "@interfere/helpers": "^9.0.0",
+    "@interfere/react": "^10.0.1-canary.0",
+    "@interfere/sdk": "^10.0.1-canary.0",
+    "@interfere/types": "^9.0.3-canary.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/api-logs": "^0.218.0",
+    "@opentelemetry/baggage-span-processor": "^0.5.0",
+    "@opentelemetry/context-async-hooks": "^2.7.1",
+    "@opentelemetry/core": "^2.7.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.218.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.218.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",
+    "@opentelemetry/instrumentation": "^0.218.0",
+    "@opentelemetry/instrumentation-undici": "^0.28.0",
+    "@opentelemetry/resources": "^2.7.0",
+    "@opentelemetry/sdk-logs": "^0.218.0",
+    "@opentelemetry/sdk-metrics": "^2.7.0",
+    "@opentelemetry/sdk-trace-base": "^2.7.0",
+    "@opentelemetry/sdk-trace-node": "^2.7.1"
   },
   "peerDependencies": {
-    "vite": ">=8.0.9"
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "vite": "^8.0.13"
   },
   "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
     "vite": {
       "optional": true
     }
@@ -62,10 +103,14 @@
     "@interfere/test-utils": "^9.0.0",
     "@interfere/typescript-config": "^9.0.0",
     "@types/node": "^24.12.0",
-    "@vitest/coverage-v8": "^4.1.5",
-    "tsdown": "^0.21.10",
-    "typescript": "6.0.3",
-    "vite": "^8.0.9",
-    "vitest": "^4.1.5"
+    "@types/react": "19.2.15",
+    "@types/react-dom": "19.2.3",
+    "@typescript/native-preview": "7.0.0-dev.20260522.1",
+    "@vitest/coverage-v8": "^4.1.6",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "tsdown": "^0.22.0",
+    "vite": "^8.0.13",
+    "vitest": "^4.1.6"
   }
 }