@glubean/scanner 0.4.0 → 0.5.0

package/dist/extractor-static.d.ts

@@ -1,27 +1,19 @@
 /**
- * Static analysis extractor for Glubean test files.
- *
- * Uses regex patterns to extract test metadata WITHOUT importing files.
- * This is useful for:
- * - Build systems that scan code without execution
- * - CI/CD pipelines
- * - IDE extensions (VSCode)
- *
- * Note: Static analysis may miss dynamically computed metadata.
- *
- * **Limitations:**
- * - Template variables (`$id`, `$_pick`) in IDs are preserved as-is, not resolved.
- * - Dynamically computed IDs or tags are not detected.
- * - `test.each()` / `test.pick()` produce one ExportMeta with the template ID,
- *   not one per data row (row count is unknown statically).
- * - Deeply nested or multi-line object literals with complex expressions may
- *   not be fully parsed.
+ * Static guards + shared static-metadata types for Glubean scanning.
+ *
+ * The test/contract/pick EXTRACTORS that used to live here are gone — they are
+ * now AST-based (@babel/parser) in `extractor-ast.ts`. What remains are the two
+ * cheap regex GUARDS that run over every candidate file in phase 1 (no TS
+ * expression parsing, so a parser would only add cost):
+ *   - `isGlubeanFile` — does this file import the SDK / a test-like function?
+ *   - `extractAliasesFromSource` — `const x = test.extend(...)` alias names.
+ * Plus the result types consumed across packages (`ExportMeta` lives in
+ * `types.ts`; `PickMeta` / `Contract*StaticMeta` live here).
  */
-import type { ExportMeta } from "./types.js";
 /**
  * Check if a file's content looks like a Glubean test/task file.
  *
- * Useful as a fast guard before running the more expensive `extractFromSource`.
+ * A fast, parse-free guard run before the (AST) extractors.
  *
  * Detection layers (any match → true):
  * 1. Direct SDK module import (`jsr:@glubean/sdk`, `@glubean/sdk`)
@@ -49,39 +41,6 @@ export declare function isGlubeanFile(content: string, customFns?: string[]): bo
  * @returns Array of discovered alias names
  */
 export declare function extractAliasesFromSource(content: string): string[];
-/**
- * Extract test metadata from TypeScript source using static analysis (regex).
- *
- * Recognizes the following patterns:
- * - `export const x = test("id", fn)` — simple test with string ID
- * - `export const x = test({ id, name, tags }, fn)` — simple test with meta
- * - `export const x = test("id").step(...)` — builder with steps
- * - `export const x = test.each(data)("id-$key", fn)` — data-driven
- * - `export const x = test.pick(examples)("id-$_pick", fn)` — example selection
- *
- * This is a pure function — no file system or runtime access needed.
- *
- * @param content - TypeScript source code
- * @param customFns - Additional function names discovered via `extractAliasesFromSource`.
- *                    When provided, these names are matched alongside `test` and `task`.
- *                    When omitted, falls back to `*Test` / `*Task` convention matching.
- * @returns Array of extracted export metadata
- */
-export declare function extractFromSource(content: string, customFns?: string[]): ExportMeta[];
-/**
- * Create a static metadata extractor that uses file system to read content.
- *
- * Aliases can be supplied at two levels:
- * - `customFns` (construction-time): baked-in aliases known upfront.
- * - `runtimeFns` (call-time): aliases discovered during a Scanner two-phase
- *   scan. These are merged with `customFns` so the extractor benefits from
- *   aliases discovered after construction.
- *
- * @param readFile - Function to read file content as string
- * @param customFns - Additional function names (from alias discovery)
- * @returns MetadataExtractor function
- */
-export declare function createStaticExtractor(readFile: (path: string) => Promise<string>, customFns?: string[]): (filePath: string, runtimeFns?: string[]) => Promise<ExportMeta[]>;
 /** Metadata for a discovered test.pick() call. */
 export interface PickMeta {
     /** The test ID template (e.g. "create-user-$_pick") */
@@ -128,36 +87,6 @@ export interface PickMeta {
         path: string;
     };
 }
-/**
- * Extract test.pick() metadata from TypeScript source for CodeLens rendering.
- *
- * Handles data source patterns:
- * 1. Inline object literal: `test.pick({ "key1": ..., "key2": ... })`
- * 2. JSON import variable: `import X from "./data.json"` then `test.pick(X)`
- * 3. fromDir.merge variable: `const X = await fromDir.merge("./dir/")` then `test.pick(X)`
- * 4. fromDir variable: `const X = await fromDir("./dir/")` then `test.pick(X)`
- * 5. fromDir.concat variable: `const X = await fromDir.concat("./dir/")` then `test.pick(X)`
- * 6. fromYaml.map variable: `const X = await fromYaml.map("./file.yaml")` then `test.pick(X)`
- * 7. fromJson variable: `const X = await fromJson("./file.json")` then `test.each(X)`
- * 8. fromJson.map variable: `const X = await fromJson.map("./file.json")` then `test.pick(X)`
- *
- * For other patterns (dynamic vars, etc.), returns keys: null.
- *
- * @param content - TypeScript source code
- * @param options - Optional settings
- * @param options.customFns - Additional function names discovered via alias scanning.
- * @param options.filePath - Source file path. When provided, file-relative
- *                           paths are resolved against this file's directory.
- * @param options.projectRoot - Project root. When provided, bare paths are
- *                              resolved against the project root instead of
- *                              the source file directory.
- * @returns Array of PickMeta, or empty if no test.pick calls found
- */
-export declare function extractPickExamples(content: string, options?: {
-    customFns?: string[];
-    filePath?: string;
-    projectRoot?: string;
-}): PickMeta[];
 /** Metadata for a discovered contract case. */
 export type ContractVerifyRule = string | {
     id?: string;
@@ -218,17 +147,15 @@ export interface ContractStaticMeta {
     /** Cases */
     cases: ContractCaseStaticMeta[];
 }
-/**
- * Extract contract.http()/contract.grpc()/etc. metadata from TypeScript source.
- *
- * Statically extracts:
- * - Contract ID, endpoint, export name, line number
- * - Each case key with its line number
- * - Expected status code (if literal number)
- * - Deferred reason (if literal string)
- *
- * @param content - TypeScript source code
- * @returns Array of ContractStaticMeta, or empty if no contract calls found
- */
-export declare function extractContractCases(content: string): ContractStaticMeta[];
+/** Metadata for a discovered `<fn>.flow("id")` export (structural — no marker). */
+export interface FlowStaticMeta {
+    /** Export variable name (e.g. "signupFlow") */
+    exportName: string;
+    /** Source location (1-based line number) of the export */
+    line: number;
+    /** Flow ID — the literal string arg to `.flow(...)` */
+    flowId: string;
+    /** Skip-at-declaration reason from `.meta({ skip })`, if present */
+    skip?: string;
+}
 //# sourceMappingURL=extractor-static.d.ts.map

package/dist/extractor-static.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractor-static.d.ts","sourceRoot":"","sources":["../src/extractor-static.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extractor-static.d.ts","sourceRoot":"","sources":["../src/extractor-static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoCH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAU5E;AA8ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAUlE;AAMD,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtB;;;;;;;OAOG;IACH,UAAU,CAAC,EACP;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,GAClB;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACrC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACnC;QAAE,IAAI,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC7B;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACpC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAClC;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACrC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAMD,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN;IACE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEN,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}