@fourteensystems/shipguard 0.1.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 (139) hide show
  1. package/README.md +213 -0
  2. package/bin/shipguard.mjs +2 -0
  3. package/dist/cli/commands/baseline.d.ts +7 -0
  4. package/dist/cli/commands/baseline.d.ts.map +1 -0
  5. package/dist/cli/commands/baseline.js +22 -0
  6. package/dist/cli/commands/baseline.js.map +1 -0
  7. package/dist/cli/commands/ci.d.ts +13 -0
  8. package/dist/cli/commands/ci.d.ts.map +1 -0
  9. package/dist/cli/commands/ci.js +91 -0
  10. package/dist/cli/commands/ci.js.map +1 -0
  11. package/dist/cli/commands/explain.d.ts +2 -0
  12. package/dist/cli/commands/explain.d.ts.map +1 -0
  13. package/dist/cli/commands/explain.js +20 -0
  14. package/dist/cli/commands/explain.js.map +1 -0
  15. package/dist/cli/commands/init.d.ts +7 -0
  16. package/dist/cli/commands/init.d.ts.map +1 -0
  17. package/dist/cli/commands/init.js +91 -0
  18. package/dist/cli/commands/init.js.map +1 -0
  19. package/dist/cli/commands/rules.d.ts +2 -0
  20. package/dist/cli/commands/rules.d.ts.map +1 -0
  21. package/dist/cli/commands/rules.js +13 -0
  22. package/dist/cli/commands/rules.js.map +1 -0
  23. package/dist/cli/commands/scan.d.ts +10 -0
  24. package/dist/cli/commands/scan.d.ts.map +1 -0
  25. package/dist/cli/commands/scan.js +55 -0
  26. package/dist/cli/commands/scan.js.map +1 -0
  27. package/dist/cli/commands/waive.d.ts +8 -0
  28. package/dist/cli/commands/waive.d.ts.map +1 -0
  29. package/dist/cli/commands/waive.js +34 -0
  30. package/dist/cli/commands/waive.js.map +1 -0
  31. package/dist/cli/index.d.ts +2 -0
  32. package/dist/cli/index.d.ts.map +1 -0
  33. package/dist/cli/index.js +63 -0
  34. package/dist/cli/index.js.map +1 -0
  35. package/dist/engine/baseline.d.ts +11 -0
  36. package/dist/engine/baseline.d.ts.map +1 -0
  37. package/dist/engine/baseline.js +39 -0
  38. package/dist/engine/baseline.js.map +1 -0
  39. package/dist/engine/config.d.ts +8 -0
  40. package/dist/engine/config.d.ts.map +1 -0
  41. package/dist/engine/config.js +130 -0
  42. package/dist/engine/config.js.map +1 -0
  43. package/dist/engine/extensions/load.d.ts +11 -0
  44. package/dist/engine/extensions/load.d.ts.map +1 -0
  45. package/dist/engine/extensions/load.js +26 -0
  46. package/dist/engine/extensions/load.js.map +1 -0
  47. package/dist/engine/extensions/registry.d.ts +5 -0
  48. package/dist/engine/extensions/registry.d.ts.map +1 -0
  49. package/dist/engine/extensions/registry.js +11 -0
  50. package/dist/engine/extensions/registry.js.map +1 -0
  51. package/dist/engine/extensions/types.d.ts +51 -0
  52. package/dist/engine/extensions/types.d.ts.map +1 -0
  53. package/dist/engine/extensions/types.js +2 -0
  54. package/dist/engine/extensions/types.js.map +1 -0
  55. package/dist/engine/report.d.ts +5 -0
  56. package/dist/engine/report.d.ts.map +1 -0
  57. package/dist/engine/report.js +88 -0
  58. package/dist/engine/report.js.map +1 -0
  59. package/dist/engine/run.d.ts +9 -0
  60. package/dist/engine/run.d.ts.map +1 -0
  61. package/dist/engine/run.js +101 -0
  62. package/dist/engine/run.js.map +1 -0
  63. package/dist/engine/sarif.d.ts +3 -0
  64. package/dist/engine/sarif.d.ts.map +1 -0
  65. package/dist/engine/sarif.js +58 -0
  66. package/dist/engine/sarif.js.map +1 -0
  67. package/dist/engine/score.d.ts +13 -0
  68. package/dist/engine/score.d.ts.map +1 -0
  69. package/dist/engine/score.js +97 -0
  70. package/dist/engine/score.js.map +1 -0
  71. package/dist/engine/types.d.ts +119 -0
  72. package/dist/engine/types.d.ts.map +1 -0
  73. package/dist/engine/types.js +2 -0
  74. package/dist/engine/types.js.map +1 -0
  75. package/dist/engine/version.d.ts +5 -0
  76. package/dist/engine/version.d.ts.map +1 -0
  77. package/dist/engine/version.js +15 -0
  78. package/dist/engine/version.js.map +1 -0
  79. package/dist/engine/waivers.d.ts +9 -0
  80. package/dist/engine/waivers.d.ts.map +1 -0
  81. package/dist/engine/waivers.js +55 -0
  82. package/dist/engine/waivers.js.map +1 -0
  83. package/dist/index.d.ts +12 -0
  84. package/dist/index.d.ts.map +1 -0
  85. package/dist/index.js +11 -0
  86. package/dist/index.js.map +1 -0
  87. package/dist/next/deps.d.ts +4 -0
  88. package/dist/next/deps.d.ts.map +1 -0
  89. package/dist/next/deps.js +102 -0
  90. package/dist/next/deps.js.map +1 -0
  91. package/dist/next/detect.d.ts +10 -0
  92. package/dist/next/detect.d.ts.map +1 -0
  93. package/dist/next/detect.js +57 -0
  94. package/dist/next/detect.js.map +1 -0
  95. package/dist/next/index.d.ts +5 -0
  96. package/dist/next/index.d.ts.map +1 -0
  97. package/dist/next/index.js +41 -0
  98. package/dist/next/index.js.map +1 -0
  99. package/dist/next/middleware.d.ts +3 -0
  100. package/dist/next/middleware.d.ts.map +1 -0
  101. package/dist/next/middleware.js +33 -0
  102. package/dist/next/middleware.js.map +1 -0
  103. package/dist/next/routes.d.ts +5 -0
  104. package/dist/next/routes.d.ts.map +1 -0
  105. package/dist/next/routes.js +125 -0
  106. package/dist/next/routes.js.map +1 -0
  107. package/dist/next/server-actions.d.ts +4 -0
  108. package/dist/next/server-actions.d.ts.map +1 -0
  109. package/dist/next/server-actions.js +107 -0
  110. package/dist/next/server-actions.js.map +1 -0
  111. package/dist/next/trpc.d.ts +3 -0
  112. package/dist/next/trpc.d.ts.map +1 -0
  113. package/dist/next/trpc.js +339 -0
  114. package/dist/next/trpc.js.map +1 -0
  115. package/dist/next/types.d.ts +100 -0
  116. package/dist/next/types.d.ts.map +1 -0
  117. package/dist/next/types.js +2 -0
  118. package/dist/next/types.js.map +1 -0
  119. package/dist/rules/auth-boundary-missing.d.ts +5 -0
  120. package/dist/rules/auth-boundary-missing.d.ts.map +1 -0
  121. package/dist/rules/auth-boundary-missing.js +278 -0
  122. package/dist/rules/auth-boundary-missing.js.map +1 -0
  123. package/dist/rules/index.d.ts +12 -0
  124. package/dist/rules/index.d.ts.map +1 -0
  125. package/dist/rules/index.js +41 -0
  126. package/dist/rules/index.js.map +1 -0
  127. package/dist/rules/rate-limit-missing.d.ts +5 -0
  128. package/dist/rules/rate-limit-missing.d.ts.map +1 -0
  129. package/dist/rules/rate-limit-missing.js +230 -0
  130. package/dist/rules/rate-limit-missing.js.map +1 -0
  131. package/dist/rules/tenancy-scope-missing.d.ts +5 -0
  132. package/dist/rules/tenancy-scope-missing.d.ts.map +1 -0
  133. package/dist/rules/tenancy-scope-missing.js +149 -0
  134. package/dist/rules/tenancy-scope-missing.js.map +1 -0
  135. package/dist/util/paths.d.ts +6 -0
  136. package/dist/util/paths.d.ts.map +1 -0
  137. package/dist/util/paths.js +18 -0
  138. package/dist/util/paths.js.map +1 -0
  139. package/package.json +55 -0
@@ -0,0 +1,101 @@
1
+ import { DEFAULT_CONFIG, loadConfigIfExists } from "./config.js";
2
+ import { buildNextIndex } from "../next/index.js";
3
+ import { runAllRules } from "../rules/index.js";
4
+ import { loadWaivers, applyWaivers } from "./waivers.js";
5
+ import { computeScore, summarizeFindings } from "./score.js";
6
+ import { SHIPGUARD_VERSION, INDEX_VERSION, hashConfig } from "./version.js";
7
+ export async function runScan(opts) {
8
+ const userConfig = loadConfigIfExists(opts.rootDir);
9
+ const config = {
10
+ ...DEFAULT_CONFIG,
11
+ ...userConfig,
12
+ ...opts.configOverrides,
13
+ scoring: {
14
+ ...DEFAULT_CONFIG.scoring,
15
+ ...userConfig?.scoring,
16
+ ...opts.configOverrides?.scoring,
17
+ penalties: {
18
+ ...DEFAULT_CONFIG.scoring.penalties,
19
+ ...userConfig?.scoring?.penalties,
20
+ ...opts.configOverrides?.scoring?.penalties,
21
+ },
22
+ },
23
+ hints: {
24
+ auth: {
25
+ functions: userConfig?.hints?.auth?.functions ?? DEFAULT_CONFIG.hints.auth.functions,
26
+ middlewareFiles: userConfig?.hints?.auth?.middlewareFiles ?? DEFAULT_CONFIG.hints.auth.middlewareFiles,
27
+ allowlistPaths: userConfig?.hints?.auth?.allowlistPaths ?? DEFAULT_CONFIG.hints.auth.allowlistPaths,
28
+ },
29
+ rateLimit: {
30
+ wrappers: userConfig?.hints?.rateLimit?.wrappers ?? DEFAULT_CONFIG.hints.rateLimit.wrappers,
31
+ allowlistPaths: userConfig?.hints?.rateLimit?.allowlistPaths ?? DEFAULT_CONFIG.hints.rateLimit.allowlistPaths,
32
+ },
33
+ tenancy: {
34
+ orgFieldNames: userConfig?.hints?.tenancy?.orgFieldNames ?? DEFAULT_CONFIG.hints.tenancy.orgFieldNames,
35
+ },
36
+ },
37
+ ci: {
38
+ ...DEFAULT_CONFIG.ci,
39
+ ...userConfig?.ci,
40
+ ...opts.configOverrides?.ci,
41
+ },
42
+ rules: opts.configOverrides?.rules ?? {
43
+ ...DEFAULT_CONFIG.rules,
44
+ ...userConfig?.rules,
45
+ },
46
+ };
47
+ // Merge additional excludes from CLI flags
48
+ if (opts.additionalExclude?.length) {
49
+ config.exclude = [...config.exclude, ...opts.additionalExclude];
50
+ }
51
+ // Build Next.js index
52
+ const index = await buildNextIndex(opts.rootDir, config.exclude);
53
+ // Merge auto-detected hints with user config
54
+ const mergedHints = mergeHints(config.hints, index.hints);
55
+ // Run rules
56
+ const rawFindings = runAllRules(index, { ...config, hints: mergedHints });
57
+ // Apply waivers
58
+ const waivers = loadWaivers(opts.rootDir, config.waiversFile);
59
+ const { active, waived } = applyWaivers(rawFindings, waivers);
60
+ // Score
61
+ const score = computeScore(active, config.scoring);
62
+ const counts = summarizeFindings(active);
63
+ return {
64
+ version: 1,
65
+ shipguardVersion: SHIPGUARD_VERSION,
66
+ configHash: hashConfig(config),
67
+ indexVersion: INDEX_VERSION,
68
+ timestamp: new Date().toISOString(),
69
+ framework: index.framework,
70
+ detected: {
71
+ deps: index.deps,
72
+ trpc: index.trpc.detected,
73
+ middleware: index.middleware.authLikely || index.middleware.rateLimitLikely,
74
+ },
75
+ score,
76
+ findings: active,
77
+ waivedFindings: waived,
78
+ summary: {
79
+ total: active.length,
80
+ ...counts,
81
+ waived: waived.length,
82
+ },
83
+ };
84
+ }
85
+ function mergeHints(userHints, detectedHints) {
86
+ return {
87
+ auth: {
88
+ functions: [...new Set([...(userHints.auth?.functions ?? []), ...(detectedHints.auth?.functions ?? [])])],
89
+ middlewareFiles: [...new Set([...(userHints.auth?.middlewareFiles ?? []), ...(detectedHints.auth?.middlewareFiles ?? [])])],
90
+ allowlistPaths: [...new Set([...(userHints.auth?.allowlistPaths ?? []), ...(detectedHints.auth?.allowlistPaths ?? [])])],
91
+ },
92
+ rateLimit: {
93
+ wrappers: [...new Set([...(userHints.rateLimit?.wrappers ?? []), ...(detectedHints.rateLimit?.wrappers ?? [])])],
94
+ allowlistPaths: [...new Set([...(userHints.rateLimit?.allowlistPaths ?? []), ...(detectedHints.rateLimit?.allowlistPaths ?? [])])],
95
+ },
96
+ tenancy: {
97
+ orgFieldNames: [...new Set([...(userHints.tenancy?.orgFieldNames ?? []), ...(detectedHints.tenancy?.orgFieldNames ?? [])])],
98
+ },
99
+ };
100
+ }
101
+ //# sourceMappingURL=run.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/engine/run.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { ScanResult } from "./types.js";
2
+ export declare function formatSarif(result: ScanResult): string;
3
+ //# sourceMappingURL=sarif.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../src/engine/sarif.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAW,MAAM,YAAY,CAAC;AAwCtD,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAiCtD"}
@@ -0,0 +1,58 @@
1
+ import { SHIPGUARD_VERSION } from "./version.js";
2
+ const SEVERITY_TO_SARIF_LEVEL = {
3
+ critical: "error",
4
+ high: "warning",
5
+ med: "note",
6
+ low: "note",
7
+ };
8
+ export function formatSarif(result) {
9
+ const ruleMap = new Map();
10
+ for (const f of result.findings) {
11
+ if (!ruleMap.has(f.ruleId)) {
12
+ ruleMap.set(f.ruleId, {
13
+ id: f.ruleId,
14
+ shortDescription: { text: f.message },
15
+ defaultConfiguration: { level: SEVERITY_TO_SARIF_LEVEL[f.severity] ?? "note" },
16
+ });
17
+ }
18
+ }
19
+ const sarifResults = result.findings.map(findingToSarif);
20
+ const log = {
21
+ $schema: "https://docs.oasis-open.org/sarif/sarif/v2.1.0/cos02/schemas/sarif-schema-2.1.0.json",
22
+ version: "2.1.0",
23
+ runs: [
24
+ {
25
+ tool: {
26
+ driver: {
27
+ name: "Shipguard",
28
+ version: SHIPGUARD_VERSION,
29
+ rules: [...ruleMap.values()],
30
+ },
31
+ },
32
+ results: sarifResults,
33
+ },
34
+ ],
35
+ };
36
+ return JSON.stringify(log, null, 2);
37
+ }
38
+ function findingToSarif(f) {
39
+ return {
40
+ ruleId: f.ruleId,
41
+ level: SEVERITY_TO_SARIF_LEVEL[f.severity] ?? "note",
42
+ message: { text: f.message },
43
+ locations: [
44
+ {
45
+ physicalLocation: {
46
+ artifactLocation: { uri: f.file },
47
+ ...(f.line ? { region: { startLine: f.line, ...(f.column ? { startColumn: f.column } : {}) } } : {}),
48
+ },
49
+ },
50
+ ],
51
+ properties: {
52
+ confidence: f.confidence,
53
+ evidence: f.evidence,
54
+ remediation: f.remediation,
55
+ },
56
+ };
57
+ }
58
+ //# sourceMappingURL=sarif.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sarif.js","sourceRoot":"","sources":["../../src/engine/sarif.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAgCjD,MAAM,uBAAuB,GAA2B;IACtD,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;CACZ,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE7C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE;gBACpB,EAAE,EAAE,CAAC,CAAC,MAAM;gBACZ,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;gBACrC,oBAAoB,EAAE,EAAE,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE;aAC/E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAkB,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAExE,MAAM,GAAG,GAAa;QACpB,OAAO,EAAE,sFAAsF;QAC/F,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACJ;gBACE,IAAI,EAAE;oBACJ,MAAM,EAAE;wBACN,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE,iBAAiB;wBAC1B,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;qBAC7B;iBACF;gBACD,OAAO,EAAE,YAAY;aACtB;SACF;KACF,CAAC;IAEF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,CAAU;IAChC,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,uBAAuB,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,MAAM;QACpD,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;QAC5B,SAAS,EAAE;YACT;gBACE,gBAAgB,EAAE;oBAChB,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE;oBACjC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACrG;aACF;SACF;QACD,UAAU,EAAE;YACV,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,13 @@
1
+ import type { Finding, ScoringConfig, ScanResult } from "./types.js";
2
+ import type { Severity, Confidence } from "../next/types.js";
3
+ export declare function computeScore(findings: Finding[], config?: ScoringConfig): number;
4
+ export declare function summarizeFindings(findings: Finding[]): Record<Severity, number>;
5
+ export declare function parseConfidence(input: string): Confidence;
6
+ export declare function parseSeverity(input: string): Severity;
7
+ export declare function parseIntOrThrow(input: string, name: string): number;
8
+ export declare function confidenceLevel(c: Confidence): number;
9
+ export declare function severityLevel(s: Severity): number;
10
+ export type ScoreStatus = "PASS" | "WARN" | "FAIL";
11
+ export declare function scoreStatus(score: number): ScoreStatus;
12
+ export declare function buildDetectedList(result: ScanResult): string[];
13
+ //# sourceMappingURL=score.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"score.d.ts","sourceRoot":"","sources":["../../src/engine/score.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO7D,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,GAAE,aAA+B,GACtC,MAAM,CASR;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAM/E;AAKD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAGzD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAGrD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAOrD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAQjD;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAEtD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAqB9D"}
@@ -0,0 +1,97 @@
1
+ const DEFAULT_SCORING = {
2
+ start: 100,
3
+ penalties: { critical: 25, high: 10, med: 3, low: 1 },
4
+ };
5
+ export function computeScore(findings, config = DEFAULT_SCORING) {
6
+ let score = config.start;
7
+ for (const f of findings) {
8
+ const penalty = config.penalties[f.severity] ?? 0;
9
+ score -= penalty;
10
+ }
11
+ return Math.max(0, score);
12
+ }
13
+ export function summarizeFindings(findings) {
14
+ const counts = { critical: 0, high: 0, med: 0, low: 0 };
15
+ for (const f of findings) {
16
+ counts[f.severity]++;
17
+ }
18
+ return counts;
19
+ }
20
+ const VALID_CONFIDENCES = new Set(["high", "med", "low"]);
21
+ const VALID_SEVERITIES = new Set(["critical", "high", "med", "low"]);
22
+ export function parseConfidence(input) {
23
+ if (VALID_CONFIDENCES.has(input))
24
+ return input;
25
+ throw new Error(`Invalid confidence level: "${input}". Valid values: high, med, low`);
26
+ }
27
+ export function parseSeverity(input) {
28
+ if (VALID_SEVERITIES.has(input))
29
+ return input;
30
+ throw new Error(`Invalid severity level: "${input}". Valid values: critical, high, med, low`);
31
+ }
32
+ export function parseIntOrThrow(input, name) {
33
+ const n = parseInt(input, 10);
34
+ if (isNaN(n))
35
+ throw new Error(`Invalid ${name}: "${input}" is not a number`);
36
+ return n;
37
+ }
38
+ export function confidenceLevel(c) {
39
+ switch (c) {
40
+ case "high": return 3;
41
+ case "med": return 2;
42
+ case "low": return 1;
43
+ default: return 1;
44
+ }
45
+ }
46
+ export function severityLevel(s) {
47
+ switch (s) {
48
+ case "critical": return 4;
49
+ case "high": return 3;
50
+ case "med": return 2;
51
+ case "low": return 1;
52
+ default: return 1;
53
+ }
54
+ }
55
+ export function scoreStatus(score) {
56
+ return score >= 80 ? "PASS" : score >= 50 ? "WARN" : "FAIL";
57
+ }
58
+ export function buildDetectedList(result) {
59
+ const detected = ["next-app-router"];
60
+ const d = result.detected.deps;
61
+ if (d.hasNextAuth)
62
+ detected.push("next-auth");
63
+ if (d.hasClerk)
64
+ detected.push("clerk");
65
+ if (d.hasSupabase)
66
+ detected.push("supabase");
67
+ if (d.hasKinde)
68
+ detected.push("kinde");
69
+ if (d.hasWorkOS)
70
+ detected.push("workos");
71
+ if (d.hasBetterAuth)
72
+ detected.push("better-auth");
73
+ if (d.hasLucia)
74
+ detected.push("lucia");
75
+ if (d.hasAuth0)
76
+ detected.push("auth0");
77
+ if (d.hasIronSession)
78
+ detected.push("iron-session");
79
+ if (d.hasFirebaseAuth)
80
+ detected.push("firebase-auth");
81
+ if (d.hasPrisma)
82
+ detected.push("prisma");
83
+ if (d.hasDrizzle)
84
+ detected.push("drizzle");
85
+ if (d.hasTrpc)
86
+ detected.push("trpc");
87
+ if (d.hasUpstashRatelimit)
88
+ detected.push("upstash");
89
+ if (d.hasArcjet)
90
+ detected.push("arcjet");
91
+ if (d.hasUnkey)
92
+ detected.push("unkey");
93
+ if (result.detected.middleware)
94
+ detected.push("middleware");
95
+ return detected;
96
+ }
97
+ //# sourceMappingURL=score.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/engine/score.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,119 @@
1
+ import type { Severity, Confidence, NextDepsIndex } from "../next/types.js";
2
+ export interface Finding {
3
+ ruleId: string;
4
+ severity: Severity;
5
+ confidence: Confidence;
6
+ message: string;
7
+ file: string;
8
+ line?: number;
9
+ column?: number;
10
+ endLine?: number;
11
+ endColumn?: number;
12
+ snippet?: string;
13
+ evidence: string[];
14
+ confidenceRationale: string;
15
+ remediation: string[];
16
+ tags: string[];
17
+ }
18
+ export interface Waiver {
19
+ ruleId: string;
20
+ file: string;
21
+ reason: string;
22
+ expiry?: string;
23
+ createdAt: string;
24
+ }
25
+ export interface WaiversFile {
26
+ version: 1;
27
+ waivers: Waiver[];
28
+ }
29
+ export interface Baseline {
30
+ version: 1;
31
+ shipguardVersion: string;
32
+ configHash: string;
33
+ indexVersion: number;
34
+ createdAt: string;
35
+ score: number;
36
+ findingKeys: string[];
37
+ }
38
+ export interface ScanResult {
39
+ version: 1;
40
+ shipguardVersion: string;
41
+ configHash: string;
42
+ indexVersion: number;
43
+ timestamp: string;
44
+ framework: string;
45
+ detected: {
46
+ deps: NextDepsIndex;
47
+ trpc: boolean;
48
+ middleware: boolean;
49
+ };
50
+ score: number;
51
+ findings: Finding[];
52
+ waivedFindings: Finding[];
53
+ summary: {
54
+ total: number;
55
+ critical: number;
56
+ high: number;
57
+ med: number;
58
+ low: number;
59
+ waived: number;
60
+ };
61
+ }
62
+ export interface ScoringConfig {
63
+ start: number;
64
+ penalties: Record<Severity, number>;
65
+ }
66
+ export interface ShipguardConfig {
67
+ framework: "next-app-router";
68
+ include: string[];
69
+ exclude: string[];
70
+ ci: {
71
+ failOn: Severity;
72
+ minConfidence: Confidence;
73
+ minScore: number;
74
+ maxNewCritical: number;
75
+ maxNewHigh?: number;
76
+ };
77
+ scoring: ScoringConfig;
78
+ hints: {
79
+ auth: {
80
+ functions: string[];
81
+ middlewareFiles: string[];
82
+ allowlistPaths: string[];
83
+ };
84
+ rateLimit: {
85
+ wrappers: string[];
86
+ allowlistPaths: string[];
87
+ };
88
+ tenancy: {
89
+ orgFieldNames: string[];
90
+ };
91
+ };
92
+ rules: Record<string, {
93
+ severity: Severity;
94
+ }>;
95
+ waiversFile: string;
96
+ license?: {
97
+ key?: string;
98
+ };
99
+ /** Reserved for governance module. Ignored by OSS core if governance not loaded. */
100
+ governance?: {
101
+ enabled?: boolean;
102
+ requiredRules?: string[];
103
+ waiver?: {
104
+ requireReason?: boolean;
105
+ requireExpiry?: boolean;
106
+ maxDays?: number;
107
+ };
108
+ thresholds?: {
109
+ minScore?: number;
110
+ maxCritical?: number;
111
+ };
112
+ report?: {
113
+ preAudit?: boolean;
114
+ format?: "md" | "json" | "pdf";
115
+ outputDir?: string;
116
+ };
117
+ };
118
+ }
119
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,5 @@
1
+ import type { ShipguardConfig } from "./types.js";
2
+ export declare const SHIPGUARD_VERSION = "0.1.0";
3
+ export declare const INDEX_VERSION = 1;
4
+ export declare function hashConfig(config: ShipguardConfig): string;
5
+ //# sourceMappingURL=version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/engine/version.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAU1D"}
@@ -0,0 +1,15 @@
1
+ import { createHash } from "node:crypto";
2
+ export const SHIPGUARD_VERSION = "0.1.0";
3
+ export const INDEX_VERSION = 1;
4
+ export function hashConfig(config) {
5
+ const normalized = JSON.stringify({
6
+ framework: config.framework,
7
+ include: config.include,
8
+ exclude: config.exclude,
9
+ hints: config.hints,
10
+ rules: config.rules,
11
+ scoring: config.scoring,
12
+ });
13
+ return createHash("sha256").update(normalized).digest("hex").slice(0, 12);
14
+ }
15
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/engine/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B,MAAM,UAAU,UAAU,CAAC,MAAuB;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IACH,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC5E,CAAC"}
@@ -0,0 +1,9 @@
1
+ import type { Finding, Waiver } from "./types.js";
2
+ export declare function loadWaivers(rootDir: string, waiversFile: string): Waiver[];
3
+ export declare function saveWaivers(rootDir: string, waiversFile: string, waivers: Waiver[]): void;
4
+ export declare function addWaiver(rootDir: string, waiversFile: string, waiver: Omit<Waiver, "createdAt">): Waiver;
5
+ export declare function applyWaivers(findings: Finding[], waivers: Waiver[]): {
6
+ active: Finding[];
7
+ waived: Finding[];
8
+ };
9
+ //# sourceMappingURL=waivers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"waivers.d.ts","sourceRoot":"","sources":["../../src/engine/waivers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAe,MAAM,YAAY,CAAC;AAE/D,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAY1E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAIzF;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,GAChC,MAAM,CASR;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE,MAAM,EAAE,GAChB;IAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE,CAmB1C"}
@@ -0,0 +1,55 @@
1
+ import path from "node:path";
2
+ import { existsSync, readFileSync, writeFileSync } from "node:fs";
3
+ export function loadWaivers(rootDir, waiversFile) {
4
+ const abs = path.join(rootDir, waiversFile);
5
+ if (!existsSync(abs))
6
+ return [];
7
+ let raw;
8
+ try {
9
+ raw = JSON.parse(readFileSync(abs, "utf8"));
10
+ }
11
+ catch (err) {
12
+ throw new Error(`Failed to parse ${abs}: ${err instanceof Error ? err.message : String(err)}`);
13
+ }
14
+ // Support both legacy array format and versioned format
15
+ if (Array.isArray(raw))
16
+ return raw;
17
+ return raw.waivers ?? [];
18
+ }
19
+ export function saveWaivers(rootDir, waiversFile, waivers) {
20
+ const abs = path.join(rootDir, waiversFile);
21
+ const file = { version: 1, waivers };
22
+ writeFileSync(abs, JSON.stringify(file, null, 2) + "\n");
23
+ }
24
+ export function addWaiver(rootDir, waiversFile, waiver) {
25
+ const waivers = loadWaivers(rootDir, waiversFile);
26
+ const full = {
27
+ ...waiver,
28
+ createdAt: new Date().toISOString(),
29
+ };
30
+ waivers.push(full);
31
+ saveWaivers(rootDir, waiversFile, waivers);
32
+ return full;
33
+ }
34
+ export function applyWaivers(findings, waivers) {
35
+ const active = [];
36
+ const waived = [];
37
+ for (const f of findings) {
38
+ const hasWaiver = waivers.some((w) => w.ruleId === f.ruleId &&
39
+ w.file === f.file &&
40
+ !isExpired(w));
41
+ if (hasWaiver) {
42
+ waived.push(f);
43
+ }
44
+ else {
45
+ active.push(f);
46
+ }
47
+ }
48
+ return { active, waived };
49
+ }
50
+ function isExpired(w) {
51
+ if (!w.expiry)
52
+ return false;
53
+ return new Date(w.expiry) < new Date();
54
+ }
55
+ //# sourceMappingURL=waivers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"waivers.js","sourceRoot":"","sources":["../../src/engine/waivers.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGlE,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,WAAmB;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjG,CAAC;IACD,wDAAwD;IACxD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAe,CAAC;IAC/C,OAAQ,GAAmB,CAAC,OAAO,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,WAAmB,EAAE,OAAiB;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAgB,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;IAClD,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,WAAmB,EACnB,MAAiC;IAEjC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAClD,MAAM,IAAI,GAAW;QACnB,GAAG,MAAM;QACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAmB,EACnB,OAAiB;IAEjB,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAc,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YACrB,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YACjB,CAAC,SAAS,CAAC,CAAC,CAAC,CAChB,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IAC1B,IAAI,CAAC,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;AACzC,CAAC"}
@@ -0,0 +1,12 @@
1
+ export { runScan } from "./engine/run.js";
2
+ export { buildNextIndex } from "./next/index.js";
3
+ export { RULE_REGISTRY, runAllRules } from "./rules/index.js";
4
+ export { computeScore, confidenceLevel, severityLevel, scoreStatus, buildDetectedList, parseConfidence, parseSeverity, parseIntOrThrow } from "./engine/score.js";
5
+ export { formatPretty, formatJson } from "./engine/report.js";
6
+ export { formatSarif } from "./engine/sarif.js";
7
+ export { writeBaseline, loadBaseline, diffBaseline, type BaselineDiff } from "./engine/baseline.js";
8
+ export { loadWaivers, applyWaivers, addWaiver } from "./engine/waivers.js";
9
+ export { DEFAULT_CONFIG } from "./engine/config.js";
10
+ export type { ShipguardConfig, ScanResult, Finding, Waiver, Baseline } from "./engine/types.js";
11
+ export type { NextIndex, NextRoute, NextServerAction, Severity, Confidence } from "./next/types.js";
12
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAClK,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAChG,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,11 @@
1
+ // Public API for programmatic usage
2
+ export { runScan } from "./engine/run.js";
3
+ export { buildNextIndex } from "./next/index.js";
4
+ export { RULE_REGISTRY, runAllRules } from "./rules/index.js";
5
+ export { computeScore, confidenceLevel, severityLevel, scoreStatus, buildDetectedList, parseConfidence, parseSeverity, parseIntOrThrow } from "./engine/score.js";
6
+ export { formatPretty, formatJson } from "./engine/report.js";
7
+ export { formatSarif } from "./engine/sarif.js";
8
+ export { writeBaseline, loadBaseline, diffBaseline } from "./engine/baseline.js";
9
+ export { loadWaivers, applyWaivers, addWaiver } from "./engine/waivers.js";
10
+ export { DEFAULT_CONFIG } from "./engine/config.js";
11
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAClK,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAqB,MAAM,sBAAsB,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { NextDepsIndex, NextHints } from "./types.js";
2
+ export declare function readDeps(rootDir: string): NextDepsIndex;
3
+ export declare function defaultHintsFromDeps(deps: NextDepsIndex, hasMiddlewareTs: boolean): NextHints;
4
+ //# sourceMappingURL=deps.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/next/deps.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3D,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA4BvD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,GAAG,SAAS,CAwE7F"}