@glubean/scanner 0.1.2

package/dist/types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Scanner types - shared between scanner consumers.
+ */
+/** Export metadata for a single test export */
+export interface ExportMeta {
+    type: "test";
+    /** Unique test ID */
+    id: string;
+    /** Human-readable name */
+    name?: string;
+    /** Tags for filtering */
+    tags?: string[];
+    /** Optional per-test timeout from TestMeta.timeout (milliseconds) */
+    timeout?: number;
+    /** Whether the test is marked as skip (should not run) */
+    skip?: boolean;
+    /** Whether the test is marked as only (exclusive run) */
+    only?: boolean;
+    /**
+     * Test variant — indicates the SDK API shape used to define this test.
+     *
+     * - `"each"` — `test.each(data)("id-$key", fn)` (data-driven)
+     * - `"pick"` — `test.pick(examples)("id-$_pick", fn)` (example selection)
+     * - `undefined` — simple `test()` or builder `test("id").step(...)`
+     *
+     * Only populated by static analysis. Runtime extraction cannot distinguish
+     * `test.each` from `test.pick` since both produce `EachBuilder` objects.
+     */
+    variant?: "each" | "pick";
+    /**
+     * Trace grouping ID — the unresolved template ID for pick tests.
+     * When set, the CLI uses this as the trace directory name so all
+     * pick variants share one directory for easy diffing.
+     *
+     * Populated by runtime extraction when the SDK sets `groupId` on
+     * registered test metadata (i.e., for `test.pick` tests).
+     */
+    groupId?: string;
+    /** JavaScript export name (e.g., "myTest" or "default") */
+    exportName: string;
+    /** Source location */
+    location?: {
+        line: number;
+        col: number;
+    };
+    /** Steps for builder-style flows (visualization only) */
+    steps?: {
+        name: string;
+        group?: string;
+    }[];
+}
+/** File metadata in scan result */
+export interface FileMeta {
+    /** File content hash (sha256-...) */
+    hash: string;
+    /** Exported tests from this file */
+    exports: ExportMeta[];
+}
+/**
+ * Bundle metadata stored in metadata.json.
+ */
+export interface BundleMetadata {
+    /**
+     * Schema version for metadata.json.
+     * This is independent from the spec version used by the SDK.
+     */
+    schemaVersion: "1";
+    /** Spec version used when generating metadata */
+    specVersion: string;
+    /** Generator identifier, e.g. "@glubean/cli@0.2.0" */
+    generatedBy: string;
+    /** ISO timestamp when metadata was generated */
+    generatedAt: string;
+    /** Root hash derived from file paths + hashes */
+    rootHash: string;
+    /** Files with test exports: { "path/to/file.ts": FileMeta } */
+    files: Record<string, FileMeta>;
+    /** Total number of tests */
+    testCount: number;
+    /** Total number of files with tests */
+    fileCount: number;
+    /** All unique tags across all tests */
+    tags: string[];
+    /** Optional warnings from the scanner */
+    warnings?: string[];
+    /** Optional bundle version (used by CLI sync) */
+    version?: string;
+    /** Optional project id (used by CLI sync) */
+    projectId?: string;
+}
+/** Result of scanning a directory */
+export interface ScanResult {
+    /** Spec version used for scanning */
+    specVersion: string;
+    /** Files with test exports: { "path/to/file.ts": FileMeta } */
+    files: Record<string, FileMeta>;
+    /** Total number of tests */
+    testCount: number;
+    /** Total number of files with tests */
+    fileCount: number;
+    /** All unique tags across all tests */
+    tags: string[];
+    /** Diagnostic warnings (non-fatal issues) */
+    warnings: string[];
+}
+/** Options for scanning */
+export interface ScanOptions {
+    /** Spec version to use (defaults to current SPEC_VERSION) */
+    specVersion?: string;
+    /** Directories/patterns to skip (defaults: node_modules, .git, dist, build) */
+    skipDirs?: string[];
+    /** File extensions to scan (defaults: [".ts"]) */
+    extensions?: string[];
+    /** If true, require package.json in root (defaults: false, just warns) */
+    requirePackageJson?: boolean;
+}
+/** Project validation result */
+export interface ValidationResult {
+    /** Whether the directory is a valid Glubean project */
+    valid: boolean;
+    /** Validation errors (if not valid) */
+    errors: string[];
+    /** Validation warnings (non-fatal issues) */
+    warnings: string[];
+    /** Detected spec version (from package.json or default) */
+    detectedSpecVersion?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Scanner types - shared between scanner consumers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@glubean/scanner",
+  "version": "0.1.2",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./static": {
+      "types": "./dist/static.d.ts",
+      "import": "./dist/static.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run"
+  }
+}