jobs-monorepo/libs/README.md
Elshimy Ziad Magdy Taha 2ab810be72
All checks were successful
Deploy scraper-google / build (push) Successful in 21m58s
Deploy scraper-google / deploy (push) Has been skipped
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

22 lines
917 B
Markdown

# 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`.