apps/cron-analyzer/internal/analyze-jobs.go

@@ -12,7 +12,7 @@ import (
 	"github.com/jobs-scraper/internal/infrastructure/rabbitmq"
 	"github.com/jobs-scraper/internal/openai"
 	"github.com/jobs-scraper/internal/openrouter"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
 )
 
 type JobAnalyzer struct {

libs/README.md

@@ -0,0 +1,22 @@
+# 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`.

services/api/cmd/server/main.go

@@ -12,7 +12,7 @@ import (
 	"github.com/gorilla/mux"
 	"github.com/jobs-scraper/internal/infrastructure"
 	"github.com/jobs-scraper/internal/infrastructure/rabbitmq"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
 	"github.com/jobs-scraper/services/api/internal/app"
 	httpHandler "github.com/jobs-scraper/services/api/pkg/http"
 	_ "github.com/jobs-scraper/services/api/pkg/swagger"

services/api/internal/app/app.go

@@ -5,9 +5,9 @@ import (
 
 	"github.com/gorilla/mux"
 	"github.com/jobs-scraper/internal/infrastructure/rabbitmq"
-	"github.com/jobs-scraper/libs/ports"
+	"github.com/jobs-scraper/internal/ports"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
-	"github.com/jobs-scraper/libs/server"
+	"github.com/jobs-scraper/internal/server"
 	jobCommands "github.com/jobs-scraper/services/api/internal/commands/job"
 	jobQueries "github.com/jobs-scraper/services/api/internal/queries/job"
 )

services/api/internal/commands/job/apply-for-job.go

@@ -5,7 +5,7 @@ import (
 
 	"github.com/jobs-scraper/internal/dto"
 	"github.com/jobs-scraper/internal/infrastructure/rabbitmq"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
 )
 
 type ApplyForJob struct {

services/api/internal/commands/job/create-job.go

@@ -7,8 +7,8 @@ import (
 
 	"github.com/jobs-scraper/internal/domain"
 	"github.com/jobs-scraper/internal/infrastructure/rabbitmq"
-	"github.com/jobs-scraper/libs/ports"
+	"github.com/jobs-scraper/internal/ports"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
 )
 
 type CreateJob struct {

services/api/internal/queries/job/get-jobs.go

@@ -2,8 +2,8 @@ package job
 
 import (
 	"github.com/jobs-scraper/internal/dto"
-	"github.com/jobs-scraper/libs/ports"
+	"github.com/jobs-scraper/internal/ports"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
 )
 
 type GetJobs struct {

services/api/pkg/http/job.go

@@ -9,9 +9,9 @@ import (
 
 	"github.com/gorilla/mux"
 	"github.com/gorilla/schema"
+	"github.com/jobs-scraper/internal/ports"
+	"github.com/jobs-scraper/internal/repo"
 	"github.com/jobs-scraper/internal/utils"
-	"github.com/jobs-scraper/libs/ports"
-	"github.com/jobs-scraper/libs/repo"
 )
 
 // JobHandler handles HTTP requests related to jobs

services/scraper-google/main.go

@@ -10,7 +10,7 @@ import (
 
 	"github.com/jobs-scraper/internal/browser"
 	"github.com/jobs-scraper/internal/domain"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
 	"github.com/jobs-scraper/services/scraper-google/analyzer"
 	si "github.com/jobs-scraper/services/scraper-google/setup-infrastructure"
 	"github.com/jobs-scraper/services/scraper-google/utils"

services/scraper-linkedin/main.go

@@ -13,7 +13,7 @@ import (
 	"github.com/jobs-scraper/internal/domain"
 	"github.com/jobs-scraper/internal/infrastructure"
 	"github.com/jobs-scraper/internal/infrastructure/rabbitmq"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
 	"github.com/jobs-scraper/services/scraper/pipeline"
 	"github.com/joho/godotenv"
 )

services/scraper-linkedin/pipeline/job_pipeline.go

@@ -10,7 +10,7 @@ import (
 	"time"
 
 	"github.com/jobs-scraper/internal/domain"
-	"github.com/jobs-scraper/libs/repo"
+	"github.com/jobs-scraper/internal/repo"
 )
 
 // JobDescriptionResult represents the result of job description scraping