npm - @posthog/wizard - Versions diffs - 0.7.0 → 0.8.0 - Mend

@posthog/wizard 0.7.0 → 0.8.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 (138) hide show

package/dist/bin.d.ts +2 -0
package/dist/bin.js +28 -0
package/dist/bin.js.map +1 -0
package/dist/src/lib/config.d.ts +49 -0
package/dist/src/lib/config.js +85 -0
package/dist/src/lib/config.js.map +1 -0
package/dist/src/lib/constants.d.ts +25 -0
package/dist/src/lib/constants.js +45 -0
package/dist/src/lib/constants.js.map +1 -0
package/dist/src/lib/messages.d.ts +17 -0
package/dist/src/lib/messages.js +68 -0
package/dist/src/lib/messages.js.map +1 -0
package/dist/src/lib/prompts.d.ts +16 -0
package/dist/src/lib/prompts.js +83 -0
package/dist/src/lib/prompts.js.map +1 -0
package/dist/src/nextjs/docs.d.ts +8 -0
package/dist/src/nextjs/docs.js +257 -0
package/dist/src/nextjs/docs.js.map +1 -0
package/dist/src/nextjs/nextjs-wizard.d.ts +2 -0
package/dist/src/nextjs/nextjs-wizard.js +136 -0
package/dist/src/nextjs/nextjs-wizard.js.map +1 -0
package/dist/src/nextjs/utils.d.ts +9 -0
package/dist/src/nextjs/utils.js +83 -0
package/dist/src/nextjs/utils.js.map +1 -0
package/dist/src/react/docs.d.ts +4 -0
package/dist/src/react/docs.js +46 -0
package/dist/src/react/docs.js.map +1 -0
package/dist/src/react/react-wizard.d.ts +2 -0
package/dist/src/react/react-wizard.js +115 -0
package/dist/src/react/react-wizard.js.map +1 -0
package/dist/src/react-native/docs.d.ts +5 -0
package/dist/src/react-native/docs.js +31 -0
package/dist/src/react-native/docs.js.map +1 -0
package/dist/src/react-native/react-native-wizard.d.ts +2 -0
package/dist/src/react-native/react-native-wizard.js +124 -0
package/dist/src/react-native/react-native-wizard.js.map +1 -0
package/dist/src/run.d.ts +13 -0
package/dist/src/run.js +85 -0
package/dist/src/run.js.map +1 -0
package/dist/src/steps/__tests__/add-editor-rules.test.d.ts +1 -0
package/dist/src/steps/__tests__/add-editor-rules.test.js +218 -0
package/dist/src/steps/__tests__/add-editor-rules.test.js.map +1 -0
package/dist/src/steps/__tests__/create-pr.test.d.ts +1 -0
package/dist/src/steps/__tests__/create-pr.test.js +193 -0
package/dist/src/steps/__tests__/create-pr.test.js.map +1 -0
package/dist/src/steps/add-editor-rules.d.ts +9 -0
package/dist/src/steps/add-editor-rules.js +92 -0
package/dist/src/steps/add-editor-rules.js.map +1 -0
package/dist/src/steps/add-or-update-environment-variables.d.ts +10 -0
package/dist/src/steps/add-or-update-environment-variables.js +194 -0
package/dist/src/steps/add-or-update-environment-variables.js.map +1 -0
package/dist/src/steps/create-pr.d.ts +27 -0
package/dist/src/steps/create-pr.js +305 -0
package/dist/src/steps/create-pr.js.map +1 -0
package/dist/src/steps/index.d.ts +4 -0
package/dist/src/steps/index.js +21 -0
package/dist/src/steps/index.js.map +1 -0
package/dist/src/steps/run-prettier.d.ts +5 -0
package/dist/src/steps/run-prettier.js +93 -0
package/dist/src/steps/run-prettier.js.map +1 -0
package/dist/src/steps/upload-environment-variables/EnvironmentProvider.d.ts +8 -0
package/dist/src/steps/upload-environment-variables/EnvironmentProvider.js +12 -0
package/dist/src/steps/upload-environment-variables/EnvironmentProvider.js.map +1 -0
package/dist/src/steps/upload-environment-variables/index.d.ts +6 -0
package/dist/src/steps/upload-environment-variables/index.js +66 -0
package/dist/src/steps/upload-environment-variables/index.js.map +1 -0
package/dist/src/steps/upload-environment-variables/providers/__tests__/vercel.test.d.ts +1 -0
package/dist/src/steps/upload-environment-variables/providers/__tests__/vercel.test.js +117 -0
package/dist/src/steps/upload-environment-variables/providers/__tests__/vercel.test.js.map +1 -0
package/dist/src/steps/upload-environment-variables/providers/vercel.d.ts +14 -0
package/dist/src/steps/upload-environment-variables/providers/vercel.js +146 -0
package/dist/src/steps/upload-environment-variables/providers/vercel.js.map +1 -0
package/dist/src/svelte/docs.d.ts +3 -0
package/dist/src/svelte/docs.js +110 -0
package/dist/src/svelte/docs.js.map +1 -0
package/dist/src/svelte/svelte-wizard.d.ts +2 -0
package/dist/src/svelte/svelte-wizard.js +115 -0
package/dist/src/svelte/svelte-wizard.js.map +1 -0
package/dist/src/telemetry.d.ts +2 -0
package/dist/src/telemetry.js +13 -0
package/dist/src/telemetry.js.map +1 -0
package/dist/src/utils/__tests__/clack-utils.test.d.ts +1 -0
package/dist/src/utils/__tests__/clack-utils.test.js +128 -0
package/dist/src/utils/__tests__/clack-utils.test.js.map +1 -0
package/dist/src/utils/analytics.d.ts +12 -0
package/dist/src/utils/analytics.js +59 -0
package/dist/src/utils/analytics.js.map +1 -0
package/dist/src/utils/bash.d.ts +2 -0
package/dist/src/utils/bash.js +54 -0
package/dist/src/utils/bash.js.map +1 -0
package/dist/src/utils/clack-utils.d.ts +180 -0
package/dist/src/utils/clack-utils.js +634 -0
package/dist/src/utils/clack-utils.js.map +1 -0
package/dist/src/utils/clack.d.ts +2 -0
package/dist/src/utils/clack.js +9 -0
package/dist/src/utils/clack.js.map +1 -0
package/dist/src/utils/debug.d.ts +2 -0
package/dist/src/utils/debug.js +22 -0
package/dist/src/utils/debug.js.map +1 -0
package/dist/src/utils/environment.d.ts +3 -0
package/dist/src/utils/environment.js +64 -0
package/dist/src/utils/environment.js.map +1 -0
package/dist/src/utils/file-utils.d.ts +29 -0
package/dist/src/utils/file-utils.js +177 -0
package/dist/src/utils/file-utils.js.map +1 -0
package/dist/src/utils/logging.d.ts +9 -0
package/dist/src/utils/logging.js +50 -0
package/dist/src/utils/logging.js.map +1 -0
package/dist/src/utils/package-json.d.ts +25 -0
package/dist/src/utils/package-json.js +27 -0
package/dist/src/utils/package-json.js.map +1 -0
package/dist/src/utils/package-manager.d.ts +21 -0
package/dist/src/utils/package-manager.js +208 -0
package/dist/src/utils/package-manager.js.map +1 -0
package/dist/src/utils/query.d.ts +8 -0
package/dist/src/utils/query.js +27 -0
package/dist/src/utils/query.js.map +1 -0
package/dist/src/utils/rules/next-rules.md +9 -0
package/dist/src/utils/rules/react-native-rules.md +7 -0
package/dist/src/utils/rules/react-rules.md +7 -0
package/dist/src/utils/rules/svelte-rules.md +7 -0
package/dist/src/utils/rules/universal.md +20 -0
package/dist/src/utils/semver.d.ts +5 -0
package/dist/src/utils/semver.js +25 -0
package/dist/src/utils/semver.js.map +1 -0
package/dist/src/utils/string.d.ts +1 -0
package/dist/src/utils/string.js +9 -0
package/dist/src/utils/string.js.map +1 -0
package/dist/src/utils/types.d.ts +48 -0
package/dist/src/utils/types.js +3 -0
package/dist/src/utils/types.js.map +1 -0
package/dist/src/utils/urls.d.ts +4 -0
package/dist/src/utils/urls.js +35 -0
package/dist/src/utils/urls.js.map +1 -0
package/dist/src/utils/vendor/is-unicorn-supported.d.ts +1 -0
package/dist/src/utils/vendor/is-unicorn-supported.js +24 -0
package/dist/src/utils/vendor/is-unicorn-supported.js.map +1 -0
package/package.json +5 -1

package/dist/src/nextjs/docs.js ADDED Viewed

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNextjsPagesRouterDocs = exports.getNextjsAppRouterDocs = void 0;
+const urls_1 = require("../utils/urls");
+const getNextjsAppRouterDocs = ({ host, language, }) => {
+    return `
+==============================
+FILE: PostHogProvider.${language === 'typescript' ? 'tsx' : 'jsx'} (put it somewhere where client files are, like the components folder)
+LOCATION: Wherever other providers are, or the components folder
+==============================
+Changes:
+- Create a PostHogProvider component that will be imported into the layout file.
+Example:
+--------------------------------------------------
+"use client"
+import posthog from "posthog-js"
+import { PostHogProvider as PHProvider, usePostHog } from "posthog-js/react"
+import { Suspense, useEffect } from "react"
+import { usePathname, useSearchParams } from "next/navigation"
+export function PostHogProvider({ children }: { children: React.ReactNode }) {
+  useEffect(() => {
+    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
+      api_host: "/ingest",
+      ui_host: "${(0, urls_1.getUiHostFromHost)(host)}",
+      capture_pageview: false, // We capture pageviews manually
+      capture_pageleave: true, // Enable pageleave capture
+      debug: process.env.NODE_ENV === "development",
+    })
+  }, [])
+  return (
+    <PHProvider client={posthog}>
+      <SuspendedPostHogPageView />
+      {children}
+    </PHProvider>
+  )
+}
+function PostHogPageView() {
+  const pathname = usePathname()
+  const searchParams = useSearchParams()
+  const posthog = usePostHog()
+  useEffect(() => {
+    if (pathname && posthog) {
+      let url = window.origin + pathname
+      const search = searchParams.toString()
+      if (search) {
+        url += "?" + search
+      }
+      posthog.capture("$pageview", { "$current_url": url })
+    }
+  }, [pathname, searchParams, posthog])
+  return null
+}
+function SuspendedPostHogPageView() {
+  return (
+    <Suspense fallback={null}>
+      <PostHogPageView />
+    </Suspense>
+  )
+}
+--------------------------------------------------
+==============================
+FILE: layout.${language === 'typescript' ? 'tsx' : 'jsx'}
+LOCATION: Wherever the root layout is
+==============================
+Changes:
+- Import the PostHogProvider from the providers file and wrap the app in it.
+Example:
+--------------------------------------------------
+// other imports
+import { PostHogProvider } from "LOCATION_OF_POSTHOG_PROVIDER"
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en">
+      <body>
+        <PostHogProvider>
+          {/* other providers */}
+          {children}
+          {/* other providers */}
+        </PostHogProvider>
+      </body>
+    </html>
+  )
+}
+--------------------------------------------------
+==============================
+FILE: posthog.${language === 'typescript' ? 'ts' : 'js'}
+LOCATION: Wherever works best given the project structure
+==============================
+Changes:
+- Initialize the PostHog Node.js client
+Example:
+--------------------------------------------------
+import { PostHog } from "posthog-node"
+export default function PostHogClient() {
+  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
+    host: process.env.NEXT_PUBLIC_POSTHOG_HOST,
+    flushAt: 1,
+    flushInterval: 0,
+  })
+  return posthogClient
+}
+--------------------------------------------------
+==============================
+FILE: next.config.{js,ts,mjs,cjs}
+LOCATION: Wherever the root next config is
+==============================
+Changes:
+- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.
+- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.
+- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.
+Example:
+--------------------------------------------------
+const nextConfig = {
+  // other config
+  async rewrites() {
+    return [
+      {
+        source: "/ingest/static/:path*",
+        destination: "${(0, urls_1.getAssetHostFromHost)(host)}/static/:path*",
+      },
+      {
+        source: "/ingest/:path*",
+        destination: "${host}/:path*",
+      },
+      {
+        source: "/ingest/decide",
+        destination: "${host}/decide",
+      },
+    ];
+  },
+  // This is required to support PostHog trailing slash API requests
+  skipTrailingSlashRedirect: true,
+}
+module.exports = nextConfig
+--------------------------------------------------`;
+};
+exports.getNextjsAppRouterDocs = getNextjsAppRouterDocs;
+const getNextjsPagesRouterDocs = ({ host, language, }) => {
+    return `
+==============================
+FILE: _app.${language === 'typescript' ? 'tsx' : 'jsx'}
+LOCATION: Wherever the root _app.${language === 'typescript' ? 'tsx' : 'jsx'} file is
+==============================
+Changes:
+- Initialize PostHog in _app.js.
+- Wrap the application in PostHogProvider.
+- Manually capture $pageview events.
+Example:
+--------------------------------------------------
+import { useEffect } from "react"
+import { Router } from "next/router"
+import posthog from "posthog-js"
+import { PostHogProvider } from "posthog-js/react"
+export default function App({ Component, pageProps }) {
+  useEffect(() => {
+    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY, {
+      api_host: "/ingest",
+      ui_host: "${(0, urls_1.getUiHostFromHost)(host)}",
+      loaded: (posthog) => {
+        if (process.env.NODE_ENV === "development") posthog.debug()
+      },
+      debug: process.env.NODE_ENV === "development",
+    })
+    const handleRouteChange = () => posthog?.capture("$pageview")
+    Router.events.on("routeChangeComplete", handleRouteChange)
+    return () => {
+      Router.events.off("routeChangeComplete", handleRouteChange)
+    }
+  }, [])
+  return (
+    <PostHogProvider client={posthog}>
+      <Component {...pageProps} />
+    </PostHogProvider>
+  )
+}
+--------------------------------------------------
+==============================
+FILE: posthog.${language === 'typescript' ? 'ts' : 'js'}
+LOCATION: Wherever works best given the project structure
+==============================
+Changes:
+- Initialize the PostHog Node.js client
+Example:
+--------------------------------------------------
+import { PostHog } from "posthog-node"
+export default function PostHogClient() {
+  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
+    host: process.env.NEXT_PUBLIC_POSTHOG_HOST,
+    flushAt: 1,
+    flushInterval: 0,
+  })
+  return posthogClient
+}
+--------------------------------------------------
+==============================
+FILE: next.config.{js,ts,mjs,cjs}
+LOCATION: Wherever the root next config is
+==============================
+Changes:
+- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.
+- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.
+- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.
+Example:
+--------------------------------------------------
+const nextConfig = {
+  // other config
+  async rewrites() {
+    return [
+      {
+        source: "/ingest/static/:path*",
+        destination: "${(0, urls_1.getAssetHostFromHost)(host)}/static/:path*",
+      },
+      {
+        source: "/ingest/:path*",
+        destination: "${host}/:path*",
+      },
+      {
+        source: "/ingest/decide",
+        destination: "${host}/decide",
+      },
+    ];
+  },
+  // This is required to support PostHog trailing slash API requests
+  skipTrailingSlashRedirect: true,
+}
+module.exports = nextConfig
+--------------------------------------------------`;
+};
+exports.getNextjsPagesRouterDocs = getNextjsPagesRouterDocs;
+//# sourceMappingURL=docs.js.map

package/dist/src/nextjs/docs.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/nextjs/docs.ts"],"names":[],"mappings":";;;AAAA,wCAAwE;AAEjE,MAAM,sBAAsB,GAAG,CAAC,EACrC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;wBAGL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;;kBAmBgB,IAAA,wBAAiB,EAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA6C1B,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA2BxC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqC/B,IAAA,2BAAoB,EAAC,IAAI,CAAC;;;;wBAI1B,IAAI;;;;wBAIJ,IAAI;;;;;;;;mDAQuB,CAAC;AACpD,CAAC,CAAC;AA5JW,QAAA,sBAAsB,0BA4JjC;AAEK,MAAM,wBAAwB,GAAG,CAAC,EACvC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;aAEI,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;mCAElD,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;kBAkBgB,IAAA,wBAAiB,EAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;gBAwBzB,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqC/B,IAAA,2BAAoB,EAAC,IAAI,CAAC;;;;wBAI1B,IAAI;;;;wBAIJ,IAAI;;;;;;;;mDAQuB,CAAC;AACpD,CAAC,CAAC;AA5GW,QAAA,wBAAwB,4BA4GnC","sourcesContent":["import { getAssetHostFromHost, getUiHostFromHost } from '../utils/urls';\n\nexport const getNextjsAppRouterDocs = ({\n host,\n language,\n}: {\n host: string;\n language: 'typescript' | 'javascript';\n}) => {\n return `\n==============================\nFILE: PostHogProvider.${\n language === 'typescript' ? 'tsx' : 'jsx'\n } (put it somewhere where client files are, like the components folder)\nLOCATION: Wherever other providers are, or the components folder\n==============================\nChanges:\n- Create a PostHogProvider component that will be imported into the layout file.\n\nExample:\n--------------------------------------------------\n\"use client\"\n\nimport posthog from \"posthog-js\"\nimport { PostHogProvider as PHProvider, usePostHog } from \"posthog-js/react\"\nimport { Suspense, useEffect } from \"react\"\nimport { usePathname, useSearchParams } from \"next/navigation\"\n\nexport function PostHogProvider({ children }: { children: React.ReactNode }) {\n useEffect(() => {\n posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n api_host: \"/ingest\",\n ui_host: \"${getUiHostFromHost(host)}\",\n capture_pageview: false, // We capture pageviews manually\n capture_pageleave: true, // Enable pageleave capture\n debug: process.env.NODE_ENV === \"development\",\n })\n }, [])\n\n return (\n <PHProvider client={posthog}>\n <SuspendedPostHogPageView />\n {children}\n </PHProvider>\n )\n}\n\n\nfunction PostHogPageView() {\n const pathname = usePathname()\n const searchParams = useSearchParams()\n const posthog = usePostHog()\n\n useEffect(() => {\n if (pathname && posthog) {\n let url = window.origin + pathname\n const search = searchParams.toString()\n if (search) {\n url += \"?\" + search\n }\n posthog.capture(\"$pageview\", { \"$current_url\": url })\n }\n }, [pathname, searchParams, posthog])\n\n return null\n}\n\nfunction SuspendedPostHogPageView() {\n return (\n <Suspense fallback={null}>\n <PostHogPageView />\n </Suspense>\n )\n}\n--------------------------------------------------\n\n==============================\nFILE: layout.${language === 'typescript' ? 'tsx' : 'jsx'}\nLOCATION: Wherever the root layout is\n==============================\nChanges:\n- Import the PostHogProvider from the providers file and wrap the app in it.\n\nExample:\n--------------------------------------------------\n// other imports\nimport { PostHogProvider } from \"LOCATION_OF_POSTHOG_PROVIDER\"\n\nexport default function RootLayout({ children }) {\n return (\n <html lang=\"en\">\n <body>\n <PostHogProvider>\n {/* other providers */}\n {children}\n {/* other providers */}\n </PostHogProvider>\n </body>\n </html>\n )\n}\n--------------------------------------------------\n\n==============================\nFILE: posthog.${language === 'typescript' ? 'ts' : 'js'}\nLOCATION: Wherever works best given the project structure\n==============================\nChanges:\n- Initialize the PostHog Node.js client\n\nExample:\n--------------------------------------------------\nimport { PostHog } from \"posthog-node\"\n\nexport default function PostHogClient() {\n const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n host: process.env.NEXT_PUBLIC_POSTHOG_HOST,\n flushAt: 1,\n flushInterval: 0,\n })\n return posthogClient\n}\n--------------------------------------------------\n\n==============================\nFILE: next.config.{js,ts,mjs,cjs}\nLOCATION: Wherever the root next config is\n==============================\nChanges:\n- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.\n- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.\n- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.\n\nExample:\n--------------------------------------------------\nconst nextConfig = {\n // other config\n async rewrites() {\n return [\n {\n source: \"/ingest/static/:path*\",\n destination: \"${getAssetHostFromHost(host)}/static/:path*\",\n },\n {\n source: \"/ingest/:path*\",\n destination: \"${host}/:path*\",\n },\n {\n source: \"/ingest/decide\",\n destination: \"${host}/decide\",\n },\n ];\n },\n // This is required to support PostHog trailing slash API requests\n skipTrailingSlashRedirect: true,\n}\nmodule.exports = nextConfig\n--------------------------------------------------`;\n};\n\nexport const getNextjsPagesRouterDocs = ({\n host,\n language,\n}: {\n host: string;\n language: 'typescript' | 'javascript';\n}) => {\n return `\n==============================\nFILE: _app.${language === 'typescript' ? 'tsx' : 'jsx'}\nLOCATION: Wherever the root _app.${\n language === 'typescript' ? 'tsx' : 'jsx'\n } file is\n==============================\nChanges:\n- Initialize PostHog in _app.js.\n- Wrap the application in PostHogProvider.\n- Manually capture $pageview events.\n\nExample:\n--------------------------------------------------\nimport { useEffect } from \"react\"\nimport { Router } from \"next/router\"\nimport posthog from \"posthog-js\"\nimport { PostHogProvider } from \"posthog-js/react\"\n\nexport default function App({ Component, pageProps }) {\n useEffect(() => {\n posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY, {\n api_host: \"/ingest\",\n ui_host: \"${getUiHostFromHost(host)}\",\n loaded: (posthog) => {\n if (process.env.NODE_ENV === \"development\") posthog.debug()\n },\n debug: process.env.NODE_ENV === \"development\",\n })\n\n const handleRouteChange = () => posthog?.capture(\"$pageview\")\n Router.events.on(\"routeChangeComplete\", handleRouteChange)\n\n return () => {\n Router.events.off(\"routeChangeComplete\", handleRouteChange)\n }\n }, [])\n\n return (\n <PostHogProvider client={posthog}>\n <Component {...pageProps} />\n </PostHogProvider>\n )\n}\n--------------------------------------------------\n\n==============================\nFILE: posthog.${language === 'typescript' ? 'ts' : 'js'}\nLOCATION: Wherever works best given the project structure\n==============================\nChanges:\n- Initialize the PostHog Node.js client\n\nExample:\n--------------------------------------------------\nimport { PostHog } from \"posthog-node\"\n\nexport default function PostHogClient() {\n const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n host: process.env.NEXT_PUBLIC_POSTHOG_HOST,\n flushAt: 1,\n flushInterval: 0,\n })\n return posthogClient\n}\n--------------------------------------------------\n\n==============================\nFILE: next.config.{js,ts,mjs,cjs}\nLOCATION: Wherever the root next config is\n==============================\nChanges:\n- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.\n- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.\n- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.\n\nExample:\n--------------------------------------------------\nconst nextConfig = {\n // other config\n async rewrites() {\n return [\n {\n source: \"/ingest/static/:path*\",\n destination: \"${getAssetHostFromHost(host)}/static/:path*\",\n },\n {\n source: \"/ingest/:path*\",\n destination: \"${host}/:path*\",\n },\n {\n source: \"/ingest/decide\",\n destination: \"${host}/decide\",\n },\n ];\n },\n // This is required to support PostHog trailing slash API requests\n skipTrailingSlashRedirect: true,\n}\nmodule.exports = nextConfig\n--------------------------------------------------`;\n};\n"]}

package/dist/src/nextjs/nextjs-wizard.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { WizardOptions } from '../utils/types';
2	+ export declare function runNextjsWizard(options: WizardOptions): Promise<void>;

package/dist/src/nextjs/nextjs-wizard.js ADDED Viewed

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runNextjsWizard = runNextjsWizard;
+/* eslint-disable max-lines */
+const clack_utils_1 = require("../utils/clack-utils");
+const package_json_1 = require("../utils/package-json");
+const utils_1 = require("./utils");
+const clack_1 = __importDefault(require("../utils/clack"));
+const constants_1 = require("../lib/constants");
+const docs_1 = require("./docs");
+const analytics_1 = require("../utils/analytics");
+const file_utils_1 = require("../utils/file-utils");
+const clack_utils_2 = require("../utils/clack-utils");
+const messages_1 = require("../lib/messages");
+const steps_1 = require("../steps");
+const upload_environment_variables_1 = require("../steps/upload-environment-variables");
+async function runNextjsWizard(options) {
+    (0, clack_utils_1.printWelcome)({
+        wizardName: 'PostHog Next.js Wizard',
+    });
+    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
+    if (!aiConsent) {
+        await (0, clack_utils_1.abort)('The Next.js wizard requires AI to get setup right now. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js', 0);
+    }
+    const cloudRegion = options.cloudRegion ?? (await (0, clack_utils_2.askForCloudRegion)());
+    const typeScriptDetected = (0, clack_utils_1.isUsingTypeScript)(options);
+    await (0, clack_utils_1.confirmContinueIfNoOrDirtyGitRepo)(options);
+    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+    await (0, clack_utils_1.ensurePackageIsInstalled)(packageJson, 'next', 'Next.js');
+    const nextVersion = (0, package_json_1.getPackageVersion)('next', packageJson);
+    analytics_1.analytics.setTag('nextjs-version', (0, utils_1.getNextJsVersionBucket)(nextVersion));
+    const { projectApiKey, wizardHash, host } = await (0, clack_utils_1.getOrAskForProjectData)({
+        ...options,
+        cloudRegion,
+    });
+    const sdkAlreadyInstalled = (0, package_json_1.hasPackageInstalled)('posthog-js', packageJson);
+    analytics_1.analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);
+    const { packageManager: packageManagerFromInstallStep } = await (0, clack_utils_1.installPackage)({
+        packageName: 'posthog-js',
+        packageNameDisplayLabel: 'posthog-js',
+        alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],
+        forceInstall: options.forceInstall,
+        askBeforeUpdating: false,
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+    });
+    await (0, clack_utils_1.installPackage)({
+        packageName: 'posthog-node',
+        packageNameDisplayLabel: 'posthog-node',
+        packageManager: packageManagerFromInstallStep,
+        alreadyInstalled: !!packageJson?.dependencies?.['posthog-node'],
+        forceInstall: options.forceInstall,
+        askBeforeUpdating: false,
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+    });
+    const router = await (0, utils_1.getNextJsRouter)(options);
+    const relevantFiles = await (0, file_utils_1.getRelevantFilesForIntegration)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+    });
+    const installationDocumentation = getInstallationDocumentation({
+        router,
+        host,
+        language: typeScriptDetected ? 'typescript' : 'javascript',
+    });
+    clack_1.default.log.info(`Reviewing PostHog documentation for ${(0, utils_1.getNextJsRouterName)(router)}`);
+    const filesToChange = await (0, file_utils_1.getFilesToChange)({
+        integration: constants_1.Integration.nextjs,
+        relevantFiles,
+        documentation: installationDocumentation,
+        wizardHash,
+        cloudRegion,
+    });
+    await (0, file_utils_1.generateFileChangesForIntegration)({
+        integration: constants_1.Integration.nextjs,
+        filesToChange,
+        wizardHash,
+        installDir: options.installDir,
+        documentation: installationDocumentation,
+        cloudRegion,
+    });
+    const packageManagerForOutro = packageManagerFromInstallStep ?? (await (0, clack_utils_1.getPackageManager)(options));
+    await (0, steps_1.runPrettierStep)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+    });
+    const { relativeEnvFilePath, addedEnvVariables } = await (0, steps_1.addOrUpdateEnvironmentVariablesStep)({
+        variables: {
+            NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,
+            NEXT_PUBLIC_POSTHOG_HOST: host,
+        },
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+    });
+    const uploadedEnvVars = await (0, upload_environment_variables_1.uploadEnvironmentVariablesStep)({
+        NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,
+        NEXT_PUBLIC_POSTHOG_HOST: host,
+    }, {
+        integration: constants_1.Integration.nextjs,
+        options,
+    });
+    const addedEditorRules = await (0, steps_1.addEditorRulesStep)({
+        rulesName: 'next-rules.md',
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+        default: options.default,
+    });
+    const prUrl = await (0, steps_1.createPRStep)({
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+        addedEditorRules,
+    });
+    const outroMessage = (0, messages_1.getOutroMessage)({
+        options,
+        integration: constants_1.Integration.nextjs,
+        cloudRegion,
+        addedEditorRules,
+        packageManager: packageManagerForOutro,
+        envFileChanged: addedEnvVariables ? relativeEnvFilePath : undefined,
+        prUrl,
+        uploadedEnvVars,
+    });
+    clack_1.default.outro(outroMessage);
+    await analytics_1.analytics.shutdown('success');
+}
+function getInstallationDocumentation({ router, host, language, }) {
+    if (router === utils_1.NextJsRouter.PAGES_ROUTER) {
+        return (0, docs_1.getNextjsPagesRouterDocs)({ host, language });
+    }
+    return (0, docs_1.getNextjsAppRouterDocs)({ host, language });
+}
+//# sourceMappingURL=nextjs-wizard.js.map

package/dist/src/nextjs/nextjs-wizard.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"nextjs-wizard.js","sourceRoot":"","sources":["../../../src/nextjs/nextjs-wizard.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-lines */\nimport {\n abort,\n askForAIConsent,\n confirmContinueIfNoOrDirtyGitRepo,\n ensurePackageIsInstalled,\n getOrAskForProjectData,\n getPackageDotJson,\n getPackageManager,\n installPackage,\n isUsingTypeScript,\n printWelcome,\n} from '../utils/clack-utils';\nimport { getPackageVersion, hasPackageInstalled } from '../utils/package-json';\nimport {\n getNextJsRouter,\n getNextJsRouterName,\n getNextJsVersionBucket,\n NextJsRouter,\n} from './utils';\nimport clack from '../utils/clack';\nimport { Integration } from '../lib/constants';\nimport { getNextjsAppRouterDocs, getNextjsPagesRouterDocs } from './docs';\nimport { analytics } from '../utils/analytics';\nimport {\n generateFileChangesForIntegration,\n getFilesToChange,\n getRelevantFilesForIntegration,\n} from '../utils/file-utils';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\nimport { getOutroMessage } from '../lib/messages';\nimport {\n addEditorRulesStep,\n addOrUpdateEnvironmentVariablesStep,\n createPRStep,\n runPrettierStep,\n} from '../steps';\nimport { uploadEnvironmentVariablesStep } from '../steps/upload-environment-variables';\nexport async function runNextjsWizard(options: WizardOptions): Promise<void> {\n printWelcome({\n wizardName: 'PostHog Next.js Wizard',\n });\n\n const aiConsent = await askForAIConsent(options);\n\n if (!aiConsent) {\n await abort(\n 'The Next.js wizard requires AI to get setup right now. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js',\n 0,\n );\n }\n\n const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n\n const typeScriptDetected = isUsingTypeScript(options);\n\n await confirmContinueIfNoOrDirtyGitRepo(options);\n\n const packageJson = await getPackageDotJson(options);\n\n await ensurePackageIsInstalled(packageJson, 'next', 'Next.js');\n\n const nextVersion = getPackageVersion('next', packageJson);\n\n analytics.setTag('nextjs-version', getNextJsVersionBucket(nextVersion));\n\n const { projectApiKey, wizardHash, host } = await getOrAskForProjectData({\n ...options,\n cloudRegion,\n });\n\n const sdkAlreadyInstalled = hasPackageInstalled('posthog-js', packageJson);\n\n analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);\n\n const { packageManager: packageManagerFromInstallStep } =\n await installPackage({\n packageName: 'posthog-js',\n packageNameDisplayLabel: 'posthog-js',\n alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],\n forceInstall: options.forceInstall,\n askBeforeUpdating: false,\n installDir: options.installDir,\n integration: Integration.nextjs,\n });\n\n await installPackage({\n packageName: 'posthog-node',\n packageNameDisplayLabel: 'posthog-node',\n packageManager: packageManagerFromInstallStep,\n alreadyInstalled: !!packageJson?.dependencies?.['posthog-node'],\n forceInstall: options.forceInstall,\n askBeforeUpdating: false,\n installDir: options.installDir,\n integration: Integration.nextjs,\n });\n\n const router = await getNextJsRouter(options);\n\n const relevantFiles = await getRelevantFilesForIntegration({\n installDir: options.installDir,\n integration: Integration.nextjs,\n });\n\n const installationDocumentation = getInstallationDocumentation({\n router,\n host,\n language: typeScriptDetected ? 'typescript' : 'javascript',\n });\n\n clack.log.info(\n `Reviewing PostHog documentation for ${getNextJsRouterName(router)}`,\n );\n\n const filesToChange = await getFilesToChange({\n integration: Integration.nextjs,\n relevantFiles,\n documentation: installationDocumentation,\n wizardHash,\n cloudRegion,\n });\n\n await generateFileChangesForIntegration({\n integration: Integration.nextjs,\n filesToChange,\n wizardHash,\n installDir: options.installDir,\n documentation: installationDocumentation,\n cloudRegion,\n });\n\n const packageManagerForOutro =\n packageManagerFromInstallStep ?? (await getPackageManager(options));\n\n await runPrettierStep({\n installDir: options.installDir,\n integration: Integration.nextjs,\n });\n\n const { relativeEnvFilePath, addedEnvVariables } =\n await addOrUpdateEnvironmentVariablesStep({\n variables: {\n NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,\n NEXT_PUBLIC_POSTHOG_HOST: host,\n },\n installDir: options.installDir,\n integration: Integration.nextjs,\n });\n\n const uploadedEnvVars = await uploadEnvironmentVariablesStep(\n {\n NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,\n NEXT_PUBLIC_POSTHOG_HOST: host,\n },\n {\n integration: Integration.nextjs,\n options,\n },\n );\n\n const addedEditorRules = await addEditorRulesStep({\n rulesName: 'next-rules.md',\n installDir: options.installDir,\n integration: Integration.nextjs,\n default: options.default,\n });\n\n const prUrl = await createPRStep({\n installDir: options.installDir,\n integration: Integration.nextjs,\n addedEditorRules,\n });\n\n const outroMessage = getOutroMessage({\n options,\n integration: Integration.nextjs,\n cloudRegion,\n addedEditorRules,\n packageManager: packageManagerForOutro,\n envFileChanged: addedEnvVariables ? relativeEnvFilePath : undefined,\n prUrl,\n uploadedEnvVars,\n });\n\n clack.outro(outroMessage);\n\n await analytics.shutdown('success');\n}\n\nfunction getInstallationDocumentation({\n router,\n host,\n language,\n}: {\n router: NextJsRouter;\n host: string;\n language: 'typescript' | 'javascript';\n}) {\n if (router === NextJsRouter.PAGES_ROUTER) {\n return getNextjsPagesRouterDocs({ host, language });\n }\n\n return getNextjsAppRouterDocs({ host, language });\n}\n"]}

package/dist/src/nextjs/utils.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import type { WizardOptions } from '../utils/types';
+export declare function getNextJsVersionBucket(version: string | undefined): string;
+export declare enum NextJsRouter {
+    APP_ROUTER = "app-router",
+    PAGES_ROUTER = "pages-router"
+}
+export declare const IGNORE_PATTERNS: string[];
+export declare function getNextJsRouter({ installDir, }: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter>;
+export declare const getNextJsRouterName: (router: NextJsRouter) => "app router" | "pages router";

package/dist/src/nextjs/utils.js ADDED Viewed

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNextJsRouterName = exports.IGNORE_PATTERNS = exports.NextJsRouter = void 0;
+exports.getNextJsVersionBucket = getNextJsVersionBucket;
+exports.getNextJsRouter = getNextJsRouter;
+const semver_1 = require("semver");
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const clack_utils_1 = require("../utils/clack-utils");
+const clack_1 = __importDefault(require("../utils/clack"));
+function getNextJsVersionBucket(version) {
+    if (!version) {
+        return 'none';
+    }
+    try {
+        const minVer = (0, semver_1.minVersion)(version);
+        if (!minVer) {
+            return 'invalid';
+        }
+        const majorVersion = (0, semver_1.major)(minVer);
+        if (majorVersion >= 11) {
+            return `${majorVersion}.x`;
+        }
+        return '<11.0.0';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+var NextJsRouter;
+(function (NextJsRouter) {
+    NextJsRouter["APP_ROUTER"] = "app-router";
+    NextJsRouter["PAGES_ROUTER"] = "pages-router";
+})(NextJsRouter || (exports.NextJsRouter = NextJsRouter = {}));
+exports.IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/public/**',
+];
+async function getNextJsRouter({ installDir, }) {
+    const pagesMatches = await (0, fast_glob_1.default)('**/pages/_app.@(ts|tsx|js|jsx)', {
+        dot: true,
+        cwd: installDir,
+        ignore: exports.IGNORE_PATTERNS,
+    });
+    const hasPagesDir = pagesMatches.length > 0;
+    const appMatches = await (0, fast_glob_1.default)('**/app/**/layout.@(ts|tsx|js|jsx)', {
+        dot: true,
+        cwd: installDir,
+        ignore: exports.IGNORE_PATTERNS,
+    });
+    const hasAppDir = appMatches.length > 0;
+    if (hasPagesDir && !hasAppDir) {
+        clack_1.default.log.info(`Detected ${(0, exports.getNextJsRouterName)(NextJsRouter.PAGES_ROUTER)} 📃`);
+        return NextJsRouter.PAGES_ROUTER;
+    }
+    if (hasAppDir && !hasPagesDir) {
+        clack_1.default.log.info(`Detected ${(0, exports.getNextJsRouterName)(NextJsRouter.APP_ROUTER)} 📱`);
+        return NextJsRouter.APP_ROUTER;
+    }
+    const result = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
+        message: 'What router are you using?',
+        options: [
+            {
+                label: (0, exports.getNextJsRouterName)(NextJsRouter.APP_ROUTER),
+                value: NextJsRouter.APP_ROUTER,
+            },
+            {
+                label: (0, exports.getNextJsRouterName)(NextJsRouter.PAGES_ROUTER),
+                value: NextJsRouter.PAGES_ROUTER,
+            },
+        ],
+    }));
+    return result;
+}
+const getNextJsRouterName = (router) => {
+    return router === NextJsRouter.APP_ROUTER ? 'app router' : 'pages router';
+};
+exports.getNextJsRouterName = getNextJsRouterName;
+//# sourceMappingURL=utils.js.map

package/dist/src/nextjs/utils.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/nextjs/utils.ts"],"names":[],"mappings":";;;;;;AAMA,wDAkBC;AAaD,0CAkDC;AAvFD,mCAA2C;AAC3C,0DAA2B;AAC3B,sDAAwD;AACxD,2DAAmC;AAGnC,SAAgB,sBAAsB,CAAC,OAA2B;IAChE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,YAAY,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,CAAC;QACnC,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,GAAG,YAAY,IAAI,CAAC;QAC7B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,6CAA6B,CAAA;AAC/B,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AAEY,QAAA,eAAe,GAAG;IAC7B,oBAAoB;IACpB,YAAY;IACZ,aAAa;IACb,cAAc;CACf,CAAC;AACK,KAAK,UAAU,eAAe,CAAC,EACpC,UAAU,GACwB;IAClC,MAAM,YAAY,GAAG,MAAM,IAAA,mBAAE,EAAC,gCAAgC,EAAE;QAC9D,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,uBAAe;KACxB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,MAAM,IAAA,mBAAE,EAAC,mCAAmC,EAAE;QAC/D,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,uBAAe;KACxB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAExC,IAAI,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,eAAK,CAAC,GAAG,CAAC,IAAI,CACZ,YAAY,IAAA,2BAAmB,EAAC,YAAY,CAAC,YAAY,CAAC,KAAK,CAChE,CAAC;QACF,OAAO,YAAY,CAAC,YAAY,CAAC;IACnC,CAAC;IAED,IAAI,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,eAAK,CAAC,GAAG,CAAC,IAAI,CACZ,YAAY,IAAA,2BAAmB,EAAC,YAAY,CAAC,UAAU,CAAC,KAAK,CAC9D,CAAC;QACF,OAAO,YAAY,CAAC,UAAU,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAiB,MAAM,IAAA,8BAAgB,EACjD,eAAK,CAAC,MAAM,CAAC;QACX,OAAO,EAAE,4BAA4B;QACrC,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,IAAA,2BAAmB,EAAC,YAAY,CAAC,UAAU,CAAC;gBACnD,KAAK,EAAE,YAAY,CAAC,UAAU;aAC/B;YACD;gBACE,KAAK,EAAE,IAAA,2BAAmB,EAAC,YAAY,CAAC,YAAY,CAAC;gBACrD,KAAK,EAAE,YAAY,CAAC,YAAY;aACjC;SACF;KACF,CAAC,CACH,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,MAAM,mBAAmB,GAAG,CAAC,MAAoB,EAAE,EAAE;IAC1D,OAAO,MAAM,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;AAC5E,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B","sourcesContent":["import { major, minVersion } from 'semver';\nimport fg from 'fast-glob';\nimport { abortIfCancelled } from '../utils/clack-utils';\nimport clack from '../utils/clack';\nimport type { WizardOptions } from '../utils/types';\n\nexport function getNextJsVersionBucket(version: string | undefined) {\n if (!version) {\n return 'none';\n }\n\n try {\n const minVer = minVersion(version);\n if (!minVer) {\n return 'invalid';\n }\n const majorVersion = major(minVer);\n if (majorVersion >= 11) {\n return `${majorVersion}.x`;\n }\n return '<11.0.0';\n } catch {\n return 'unknown';\n }\n}\n\nexport enum NextJsRouter {\n APP_ROUTER = 'app-router',\n PAGES_ROUTER = 'pages-router',\n}\n\nexport const IGNORE_PATTERNS = [\n '**/node_modules/**',\n '**/dist/**',\n '**/build/**',\n '**/public/**',\n];\nexport async function getNextJsRouter({\n installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter> {\n const pagesMatches = await fg('**/pages/_app.@(ts|tsx|js|jsx)', {\n dot: true,\n cwd: installDir,\n ignore: IGNORE_PATTERNS,\n });\n\n const hasPagesDir = pagesMatches.length > 0;\n\n const appMatches = await fg('**/app/**/layout.@(ts|tsx|js|jsx)', {\n dot: true,\n cwd: installDir,\n ignore: IGNORE_PATTERNS,\n });\n\n const hasAppDir = appMatches.length > 0;\n\n if (hasPagesDir && !hasAppDir) {\n clack.log.info(\n `Detected ${getNextJsRouterName(NextJsRouter.PAGES_ROUTER)} 📃`,\n );\n return NextJsRouter.PAGES_ROUTER;\n }\n\n if (hasAppDir && !hasPagesDir) {\n clack.log.info(\n `Detected ${getNextJsRouterName(NextJsRouter.APP_ROUTER)} 📱`,\n );\n return NextJsRouter.APP_ROUTER;\n }\n\n const result: NextJsRouter = await abortIfCancelled(\n clack.select({\n message: 'What router are you using?',\n options: [\n {\n label: getNextJsRouterName(NextJsRouter.APP_ROUTER),\n value: NextJsRouter.APP_ROUTER,\n },\n {\n label: getNextJsRouterName(NextJsRouter.PAGES_ROUTER),\n value: NextJsRouter.PAGES_ROUTER,\n },\n ],\n }),\n );\n\n return result;\n}\n\nexport const getNextJsRouterName = (router: NextJsRouter) => {\n return router === NextJsRouter.APP_ROUTER ? 'app router' : 'pages router';\n};\n"]}

package/dist/src/react/docs.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export declare const getReactDocumentation: ({ language, envVarPrefix, }: {
+    language: "typescript" | "javascript";
+    envVarPrefix: string;
+}) => string;

package/dist/src/react/docs.js ADDED Viewed

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getReactDocumentation = void 0;
+const getReactDocumentation = ({ language, envVarPrefix, }) => {
+    const apiKeyText = envVarPrefix === 'VITE_PUBLIC_'
+        ? 'import.meta.env.VITE_PUBLIC_POSTHOG_KEY'
+        : `process.env.${envVarPrefix}POSTHOG_KEY`;
+    const hostText = envVarPrefix === 'VITE_PUBLIC_'
+        ? 'import.meta.env.VITE_PUBLIC_POSTHOG_HOST'
+        : `process.env.${envVarPrefix}POSTHOG_HOST`;
+    return `
+==============================
+FILE: {index / App}.${language === 'typescript' ? 'tsx' : 'jsx'} (wherever the root of the app is)
+LOCATION: Wherever the root of the app is
+==============================
+Changes:
+- Add the PostHogProvider to the root of the app in the provider tree.
+Example:
+--------------------------------------------------
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+import { PostHogProvider} from 'posthog-js/react'
+const root = ReactDOM.createRoot(document.getElementById('root'));
+root.render(
+  <React.StrictMode>
+    <PostHogProvider
+      apiKey={${apiKeyText}}
+      options={{
+        api_host: ${hostText},
+        debug: ${envVarPrefix === 'VITE_PUBLIC_'
+        ? 'import.meta.env.MODE === "development"'
+        : 'process.env.NODE_ENV === "development"'},
+      }}
+    >
+      <App />
+    </PostHogProvider>
+  </React.StrictMode>
+--------------------------------------------------`;
+};
+exports.getReactDocumentation = getReactDocumentation;
+//# sourceMappingURL=docs.js.map

package/dist/src/react/docs.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/react/docs.ts"],"names":[],"mappings":";;;AAAO,MAAM,qBAAqB,GAAG,CAAC,EACpC,QAAQ,EACR,YAAY,GAIb,EAAE,EAAE;IACH,MAAM,UAAU,GACd,YAAY,KAAK,cAAc;QAC7B,CAAC,CAAC,yCAAyC;QAC3C,CAAC,CAAC,eAAe,YAAY,aAAa,CAAC;IAE/C,MAAM,QAAQ,GACZ,YAAY,KAAK,cAAc;QAC7B,CAAC,CAAC,0CAA0C;QAC5C,CAAC,CAAC,eAAe,YAAY,cAAc,CAAC;IAEhD,OAAO;;sBAGL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;;gBAmBc,UAAU;;oBAEN,QAAQ;iBAElB,YAAY,KAAK,cAAc;QAC7B,CAAC,CAAC,wCAAwC;QAC1C,CAAC,CAAC,wCACN;;;;;;mDAM2C,CAAC;AACpD,CAAC,CAAC;AAtDW,QAAA,qBAAqB,yBAsDhC","sourcesContent":["export const getReactDocumentation = ({\n language,\n envVarPrefix,\n}: {\n language: 'typescript' | 'javascript';\n envVarPrefix: string;\n}) => {\n const apiKeyText =\n envVarPrefix === 'VITE_PUBLIC_'\n ? 'import.meta.env.VITE_PUBLIC_POSTHOG_KEY'\n : `process.env.${envVarPrefix}POSTHOG_KEY`;\n\n const hostText =\n envVarPrefix === 'VITE_PUBLIC_'\n ? 'import.meta.env.VITE_PUBLIC_POSTHOG_HOST'\n : `process.env.${envVarPrefix}POSTHOG_HOST`;\n\n return `\n==============================\nFILE: {index / App}.${\n language === 'typescript' ? 'tsx' : 'jsx'\n } (wherever the root of the app is)\nLOCATION: Wherever the root of the app is\n==============================\nChanges:\n- Add the PostHogProvider to the root of the app in the provider tree.\n\nExample:\n--------------------------------------------------\nimport React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport App from './App';\n\nimport { PostHogProvider} from 'posthog-js/react'\n\nconst root = ReactDOM.createRoot(document.getElementById('root'));\n\nroot.render(\n <React.StrictMode>\n <PostHogProvider\n apiKey={${apiKeyText}}\n options={{\n api_host: ${hostText},\n debug: ${\n envVarPrefix === 'VITE_PUBLIC_'\n ? 'import.meta.env.MODE === \"development\"'\n : 'process.env.NODE_ENV === \"development\"'\n },\n }}\n >\n <App />\n </PostHogProvider>\n </React.StrictMode>\n--------------------------------------------------`;\n};\n"]}

package/dist/src/react/react-wizard.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { WizardOptions } from '../utils/types';
2	+ export declare function runReactWizard(options: WizardOptions): Promise<void>;