crumbtrail 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,78 @@
+export { B as BuildPlanInput, a as BuildPlanOptions, c as DENO_UNSUPPORTED_REASON, d as DOCKER_COMING_SOON_NOTE, D as DetectResult, E as EnvAction, f as ExecuteOptions, g as ExecuteResult, h as ExecutorIO, G as GitTargetStatus, I as InjectIO, P as PackageManager, i as Plan, j as PlanKind, R as Recipe, W as WorkspacePackage, b as buildPlan, k as defaultExecutorIO, l as defaultInjectIO, m as detect, n as detectPackageManager, e as executePlan, o as matchRecipe, p as parseNodeInvocation, q as parsePnpmWorkspace, r as projectAlreadyWired, s as resolveAngularEntry, t as resolveNestEntry, u as resolveOtlpStack, v as resolveReactNativeEntry, w as resolveRemixEntry, x as resolveViteEntry, y as supportsInstrumentationClient } from './executor-DKDrkhxM.cjs';
+import 'crumbtrail-design-system';
+
+interface SourceShape {
+    /** "" or the UTF-8 BOM if the source started with one. */
+    bom: string;
+    /** The line terminator the source uses (defaults to LF for empty input). */
+    eol: "\n" | "\r\n";
+    /** Body lines with the BOM stripped and split on either EOL. */
+    lines: string[];
+}
+/** Split source into BOM + EOL style + lines, preserving what we detect. */
+declare function analyzeSource(text: string): SourceShape;
+/**
+ * Number of leading lines that form the un-touchable prologue: an optional
+ * shebang followed by any directive-prologue lines ("use client"/"use strict"/
+ * "use server"), including blank lines interleaved between them. Injection is
+ * inserted immediately after this prologue.
+ */
+declare function prologueEnd(lines: string[]): number;
+/** True when the source already references either Crumbtrail SDK package. */
+declare function referencesCrumbtrail(text: string): boolean;
+/**
+ * Strictly prepend `block` into `existing`, after any shebang / directive
+ * prologue, preserving the source's BOM and CRLF/LF style. `block` is authored
+ * with LF newlines and is re-terminated to match the source.
+ */
+declare function prependIntoSource(existing: string, block: string): string;
+/** Ensure a create-file body ends in exactly one trailing newline. */
+declare function withTrailingNewline(text: string): string;
+
+/**
+ * Client init block (Next / SvelteKit / Vite). Matches the README exactly:
+ *   import { Crumbtrail, PRESET_PASSIVE } from "crumbtrail-core";
+ *   Crumbtrail.init({ ...PRESET_PASSIVE, httpEndpoint, httpAuthToken });
+ * The ingest key is inlined — it ships in the client bundle anyway (ingest-only,
+ * same posture as a Sentry DSN).
+ */
+declare function clientInitSnippet(endpoint: string, apiKey: string): string;
+/**
+ * Nuxt client plugin. Wraps the same init in `defineNuxtPlugin` (auto-imported
+ * by Nuxt) so it runs client-side on startup.
+ */
+declare function nuxtPluginSnippet(endpoint: string, apiKey: string): string;
+/**
+ * Node server init. Uses crumbtrail-node's `autoCapture`, which installs
+ * best-effort backend crash + console.error capture (uncaught exceptions,
+ * unhandled rejections, console.error) around a headless ingest session. It is
+ * dynamically imported so the block is valid whether the entry file is ESM,
+ * CommonJS, or TypeScript, and it is a plain expression (no top-level await) so
+ * it is safe to prepend at the very top of an entry file. The ingest key is read
+ * from process.env.CRUMBTRAIL_KEY, which autoCapture loads from `.env` (written by
+ * the CLI) itself — never inlined server-side. Express apps can additionally add
+ * `createCrumbtrailExpressMiddleware` for per-request capture (see
+ * crumbtrail-node's README).
+ */
+declare function nodeInitSnippet(endpoint: string): string;
+/**
+ * React Native / Expo init block. Imperative + prepend-safe: it calls
+ * `createReactNativeCrumbtrail` (which runs `Crumbtrail.init` and installs the
+ * global ErrorUtils crash handler) — the same posture as the node recipe. We do
+ * NOT wrap a `<CrumbtrailReactNativeProvider>`, because the injection engine only
+ * prepends a block or creates a file; it cannot transform JSX. The ingest key is
+ * inlined — it ships in the app bundle anyway (ingest-only, same posture as a
+ * Sentry DSN).
+ */
+declare function reactNativeInitSnippet(endpoint: string, apiKey: string): string;
+/**
+ * Tauri init block. Prepended into the frontend entry. Uses the core
+ * `transportInstance` override (NOT the `transport` string-mode field) with a
+ * `TauriTransport`, which routes bug reports to the local Rust store via the
+ * Tauri plugin — so no httpEndpoint / apiKey is needed in the block.
+ */
+declare function tauriInitSnippet(): string;
+/** The single line the CLI writes into `.env` for the Node recipe. */
+declare function envKeyLine(apiKey: string): string;
+
+export { type SourceShape, analyzeSource, clientInitSnippet, envKeyLine, nodeInitSnippet, nuxtPluginSnippet, prependIntoSource, prologueEnd, reactNativeInitSnippet, referencesCrumbtrail, tauriInitSnippet, withTrailingNewline };

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+export { B as BuildPlanInput, a as BuildPlanOptions, c as DENO_UNSUPPORTED_REASON, d as DOCKER_COMING_SOON_NOTE, D as DetectResult, E as EnvAction, f as ExecuteOptions, g as ExecuteResult, h as ExecutorIO, G as GitTargetStatus, I as InjectIO, P as PackageManager, i as Plan, j as PlanKind, R as Recipe, W as WorkspacePackage, b as buildPlan, k as defaultExecutorIO, l as defaultInjectIO, m as detect, n as detectPackageManager, e as executePlan, o as matchRecipe, p as parseNodeInvocation, q as parsePnpmWorkspace, r as projectAlreadyWired, s as resolveAngularEntry, t as resolveNestEntry, u as resolveOtlpStack, v as resolveReactNativeEntry, w as resolveRemixEntry, x as resolveViteEntry, y as supportsInstrumentationClient } from './executor-DKDrkhxM.js';
+import 'crumbtrail-design-system';
+
+interface SourceShape {
+    /** "" or the UTF-8 BOM if the source started with one. */
+    bom: string;
+    /** The line terminator the source uses (defaults to LF for empty input). */
+    eol: "\n" | "\r\n";
+    /** Body lines with the BOM stripped and split on either EOL. */
+    lines: string[];
+}
+/** Split source into BOM + EOL style + lines, preserving what we detect. */
+declare function analyzeSource(text: string): SourceShape;
+/**
+ * Number of leading lines that form the un-touchable prologue: an optional
+ * shebang followed by any directive-prologue lines ("use client"/"use strict"/
+ * "use server"), including blank lines interleaved between them. Injection is
+ * inserted immediately after this prologue.
+ */
+declare function prologueEnd(lines: string[]): number;
+/** True when the source already references either Crumbtrail SDK package. */
+declare function referencesCrumbtrail(text: string): boolean;
+/**
+ * Strictly prepend `block` into `existing`, after any shebang / directive
+ * prologue, preserving the source's BOM and CRLF/LF style. `block` is authored
+ * with LF newlines and is re-terminated to match the source.
+ */
+declare function prependIntoSource(existing: string, block: string): string;
+/** Ensure a create-file body ends in exactly one trailing newline. */
+declare function withTrailingNewline(text: string): string;
+
+/**
+ * Client init block (Next / SvelteKit / Vite). Matches the README exactly:
+ *   import { Crumbtrail, PRESET_PASSIVE } from "crumbtrail-core";
+ *   Crumbtrail.init({ ...PRESET_PASSIVE, httpEndpoint, httpAuthToken });
+ * The ingest key is inlined — it ships in the client bundle anyway (ingest-only,
+ * same posture as a Sentry DSN).
+ */
+declare function clientInitSnippet(endpoint: string, apiKey: string): string;
+/**
+ * Nuxt client plugin. Wraps the same init in `defineNuxtPlugin` (auto-imported
+ * by Nuxt) so it runs client-side on startup.
+ */
+declare function nuxtPluginSnippet(endpoint: string, apiKey: string): string;
+/**
+ * Node server init. Uses crumbtrail-node's `autoCapture`, which installs
+ * best-effort backend crash + console.error capture (uncaught exceptions,
+ * unhandled rejections, console.error) around a headless ingest session. It is
+ * dynamically imported so the block is valid whether the entry file is ESM,
+ * CommonJS, or TypeScript, and it is a plain expression (no top-level await) so
+ * it is safe to prepend at the very top of an entry file. The ingest key is read
+ * from process.env.CRUMBTRAIL_KEY, which autoCapture loads from `.env` (written by
+ * the CLI) itself — never inlined server-side. Express apps can additionally add
+ * `createCrumbtrailExpressMiddleware` for per-request capture (see
+ * crumbtrail-node's README).
+ */
+declare function nodeInitSnippet(endpoint: string): string;
+/**
+ * React Native / Expo init block. Imperative + prepend-safe: it calls
+ * `createReactNativeCrumbtrail` (which runs `Crumbtrail.init` and installs the
+ * global ErrorUtils crash handler) — the same posture as the node recipe. We do
+ * NOT wrap a `<CrumbtrailReactNativeProvider>`, because the injection engine only
+ * prepends a block or creates a file; it cannot transform JSX. The ingest key is
+ * inlined — it ships in the app bundle anyway (ingest-only, same posture as a
+ * Sentry DSN).
+ */
+declare function reactNativeInitSnippet(endpoint: string, apiKey: string): string;
+/**
+ * Tauri init block. Prepended into the frontend entry. Uses the core
+ * `transportInstance` override (NOT the `transport` string-mode field) with a
+ * `TauriTransport`, which routes bug reports to the local Rust store via the
+ * Tauri plugin — so no httpEndpoint / apiKey is needed in the block.
+ */
+declare function tauriInitSnippet(): string;
+/** The single line the CLI writes into `.env` for the Node recipe. */
+declare function envKeyLine(apiKey: string): string;
+
+export { type SourceShape, analyzeSource, clientInitSnippet, envKeyLine, nodeInitSnippet, nuxtPluginSnippet, prependIntoSource, prologueEnd, reactNativeInitSnippet, referencesCrumbtrail, tauriInitSnippet, withTrailingNewline };

package/dist/index.js

@@ -0,0 +1,64 @@
+import {
+  DENO_UNSUPPORTED_REASON,
+  DOCKER_COMING_SOON_NOTE,
+  analyzeSource,
+  buildPlan,
+  clientInitSnippet,
+  defaultExecutorIO,
+  defaultInjectIO,
+  detect,
+  detectPackageManager,
+  envKeyLine,
+  executePlan,
+  matchRecipe,
+  nodeInitSnippet,
+  nuxtPluginSnippet,
+  parseNodeInvocation,
+  parsePnpmWorkspace,
+  prependIntoSource,
+  projectAlreadyWired,
+  prologueEnd,
+  reactNativeInitSnippet,
+  referencesCrumbtrail,
+  resolveAngularEntry,
+  resolveNestEntry,
+  resolveOtlpStack,
+  resolveReactNativeEntry,
+  resolveRemixEntry,
+  resolveViteEntry,
+  supportsInstrumentationClient,
+  tauriInitSnippet,
+  withTrailingNewline
+} from "./chunk-UFJ2BODB.js";
+export {
+  DENO_UNSUPPORTED_REASON,
+  DOCKER_COMING_SOON_NOTE,
+  analyzeSource,
+  buildPlan,
+  clientInitSnippet,
+  defaultExecutorIO,
+  defaultInjectIO,
+  detect,
+  detectPackageManager,
+  envKeyLine,
+  executePlan,
+  matchRecipe,
+  nodeInitSnippet,
+  nuxtPluginSnippet,
+  parseNodeInvocation,
+  parsePnpmWorkspace,
+  prependIntoSource,
+  projectAlreadyWired,
+  prologueEnd,
+  reactNativeInitSnippet,
+  referencesCrumbtrail,
+  resolveAngularEntry,
+  resolveNestEntry,
+  resolveOtlpStack,
+  resolveReactNativeEntry,
+  resolveRemixEntry,
+  resolveViteEntry,
+  supportsInstrumentationClient,
+  tauriInitSnippet,
+  withTrailingNewline
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "crumbtrail",
+  "version": "0.1.0",
+  "description": "Crumbtrail setup CLI — detect your framework and wire the SDK into your app in one step.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oshabana/crumbtrail.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "crumbtrail",
+    "cli",
+    "setup",
+    "wizard",
+    "install"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "crumbtrail": "./dist/cli.cjs"
+  },
+  "engines": {
+    "node": ">=22.15.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "crumbtrail-design-system": "workspace:*",
+    "crumbtrail-install-shared": "workspace:*"
+  }
+}