bugblitz77/jobs-monorepo
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
jobs-monorepo/libs/README.md
Elshimy Ziad Magdy Taha 2ab810be72
All checks were successful
Deploy scraper-google / build (push) Successful in 21m58s
Details
Deploy scraper-google / deploy (push) Has been skipped
Details
Move shared Go packages from libs/ to internal/ 
internal/ and libs/ were both shared-code roots with no rule for which
one a package belonged in, so the split carried no information. Adopt a
rule the language answers by itself:

  shared Go          -> internal/
  shared TypeScript  -> libs/   (npm workspace packages)

libs/{ports,repo,server} move to internal/, leaving libs/ holding only
the two TypeScript packages (@jobs-scraper/rabbitmq-ts and
@jobs-scraper/browser-automation), which matches npm workspace
convention. internal/ is also Go's marker for code not importable from
outside the repo, which is accurate here since none of it is published.

Import paths are rewritten mechanically (jobs-scraper/libs/ ->
jobs-scraper/internal/) across 15 lines in 10 files. The 6 moved files
are pure renames with no content change. Doing this after the module
collapse in the previous commit meant no go.mod or replace-directive
edits were needed.

gofmt is applied to services/api/pkg/http/job.go, whose import group the
rewrite left out of order. Three files were already unformatted before
this refactor (internal/openai/interface.go, internal/ports/job-queries.go,
internal/repo/job-analysis-result.go) and are deliberately left alone to
keep this diff limited to the move.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-04 17:30:04 +05:00

917 B
Raw Permalink Blame History

libs/ — shared TypeScript packages

This directory holds shared TypeScript packages only, consumed via npm workspaces under the @jobs-scraper/* scope:

  • rabbitmq-ts — @jobs-scraper/rabbitmq-ts
  • browser-automation — @jobs-scraper/browser-automation

Shared Go code goes in internal/, not here. There is one shared root per language, so the language answers the "which directory?" question and there is nothing further to remember:

Shared code Lives in
Go internal/ (part of the root github.com/jobs-scraper module)
TypeScript libs/ (npm workspace packages)

internal/ is also Go's own marker for code that is not importable from outside this repository, which is accurate — none of it is published.

Deployable units — the API, the scrapers, the cron app — live in services/ and apps/ and each own their own Go module or package.json.