@shipfox/api-projects 2.0.0

package/drizzle/0000_initial.sql

@@ -0,0 +1,37 @@
+CREATE TABLE "projects_projects" (
+	"id" uuid PRIMARY KEY DEFAULT uuidv7() NOT NULL,
+	"workspace_id" uuid NOT NULL,
+	"source_connection_id" uuid NOT NULL,
+	"source_external_repository_id" text NOT NULL,
+	"name" text NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "projects_outbox" (
+	"id" uuid PRIMARY KEY DEFAULT uuidv7() NOT NULL,
+	"event_type" text NOT NULL,
+	"ordering_key" text,
+	"payload" jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"dispatched_at" timestamp with time zone,
+	"dispatch_attempts" integer DEFAULT 0 NOT NULL,
+	"next_dispatch_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"last_dispatch_error" jsonb,
+	"last_dispatch_failed_at" timestamp with time zone,
+	"dead_lettered_at" timestamp with time zone
+);
+--> statement-breakpoint
+CREATE TABLE "projects_integration_event_dedup" (
+	"integration_event_id" uuid NOT NULL,
+	"project_id" uuid NOT NULL,
+	"received_at" timestamp with time zone DEFAULT now() NOT NULL,
+	CONSTRAINT "projects_integration_event_dedup_integration_event_id_project_id_pk" PRIMARY KEY ("integration_event_id","project_id")
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX "projects_source_unique" ON "projects_projects" USING btree ("source_connection_id","source_external_repository_id");--> statement-breakpoint
+CREATE INDEX "projects_workspace_created_id_idx" ON "projects_projects" USING btree ("workspace_id","created_at","id");--> statement-breakpoint
+CREATE INDEX "projects_outbox_pending_idx" ON "projects_outbox" USING btree ("next_dispatch_at","created_at") WHERE "dispatched_at" IS NULL AND "dead_lettered_at" IS NULL;
+--> statement-breakpoint
+CREATE INDEX "projects_outbox_dispatched_retention_idx" ON "projects_outbox" USING btree ("dispatched_at","id") WHERE "dispatched_at" IS NOT NULL;--> statement-breakpoint
+CREATE INDEX "projects_integration_event_dedup_received_at_idx" ON "projects_integration_event_dedup" USING btree ("received_at");

package/drizzle/meta/0000_snapshot.json

@@ -0,0 +1,307 @@
+{
+  "id": "2686798f-1741-47d6-8d93-6554f138baa6",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "public.projects_integration_event_dedup": {
+      "name": "projects_integration_event_dedup",
+      "schema": "",
+      "columns": {
+        "integration_event_id": {
+          "name": "integration_event_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "project_id": {
+          "name": "project_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "received_at": {
+          "name": "received_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "projects_integration_event_dedup_received_at_idx": {
+          "name": "projects_integration_event_dedup_received_at_idx",
+          "columns": [
+            {
+              "expression": "received_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {
+        "projects_integration_event_dedup_integration_event_id_project_id_pk": {
+          "name": "projects_integration_event_dedup_integration_event_id_project_id_pk",
+          "columns": ["integration_event_id", "project_id"]
+        }
+      },
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.projects_outbox": {
+      "name": "projects_outbox",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "uuidv7()"
+        },
+        "event_type": {
+          "name": "event_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "ordering_key": {
+          "name": "ordering_key",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "payload": {
+          "name": "payload",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "dispatched_at": {
+          "name": "dispatched_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "dispatch_attempts": {
+          "name": "dispatch_attempts",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "default": 0
+        },
+        "next_dispatch_at": {
+          "name": "next_dispatch_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "last_dispatch_error": {
+          "name": "last_dispatch_error",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "last_dispatch_failed_at": {
+          "name": "last_dispatch_failed_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "dead_lettered_at": {
+          "name": "dead_lettered_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": false
+        }
+      },
+      "indexes": {
+        "projects_outbox_pending_idx": {
+          "name": "projects_outbox_pending_idx",
+          "columns": [
+            {
+              "expression": "next_dispatch_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "created_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "where": "\"dispatched_at\" IS NULL AND \"dead_lettered_at\" IS NULL",
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "projects_outbox_dispatched_retention_idx": {
+          "name": "projects_outbox_dispatched_retention_idx",
+          "columns": [
+            {
+              "expression": "dispatched_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "where": "\"dispatched_at\" IS NOT NULL",
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.projects_projects": {
+      "name": "projects_projects",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "uuidv7()"
+        },
+        "workspace_id": {
+          "name": "workspace_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "source_connection_id": {
+          "name": "source_connection_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "source_external_repository_id": {
+          "name": "source_external_repository_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp with time zone",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {
+        "projects_source_unique": {
+          "name": "projects_source_unique",
+          "columns": [
+            {
+              "expression": "source_connection_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "source_external_repository_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": true,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        },
+        "projects_workspace_created_id_idx": {
+          "name": "projects_workspace_created_id_idx",
+          "columns": [
+            {
+              "expression": "workspace_id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "created_at",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            },
+            {
+              "expression": "id",
+              "isExpression": false,
+              "asc": true,
+              "nulls": "last"
+            }
+          ],
+          "isUnique": false,
+          "concurrently": false,
+          "method": "btree",
+          "with": {}
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {},
+  "schemas": {},
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}

package/drizzle/meta/_journal.json

@@ -0,0 +1,13 @@
+{
+  "version": "7",
+  "dialect": "postgresql",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "7",
+      "when": 1777381200000,
+      "tag": "0000_initial",
+      "breakpoints": true
+    }
+  ]
+}

package/drizzle.config.ts

@@ -0,0 +1,7 @@
+import {defineConfig} from 'drizzle-kit';
+
+export default defineConfig({
+  schema: './src/db/schema/*.ts',
+  out: './drizzle',
+  dialect: 'postgresql',
+});

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@shipfox/api-projects",
+  "license": "MIT",
+  "version": "2.0.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ShipfoxHQ/shipfox.git",
+    "directory": "libs/api/projects"
+  },
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "imports": {
+    "#test/*": "./test/*",
+    "#*": {
+      "workspace-source": "./src/*",
+      "development": "./src/*",
+      "default": "./dist/*"
+    }
+  },
+  "exports": {
+    ".": {
+      "development": {
+        "types": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
+      "default": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "dependencies": {
+    "@temporalio/workflow": "^1.16.1",
+    "drizzle-orm": "^0.45.2",
+    "zod": "^4.4.3",
+    "@shipfox/api-auth-context": "2.0.0",
+    "@shipfox/api-integration-core-dto": "2.0.0",
+    "@shipfox/api-integration-core": "2.0.0",
+    "@shipfox/node-fastify": "0.2.1",
+    "@shipfox/api-projects-dto": "2.0.0",
+    "@shipfox/node-drizzle": "0.2.1",
+    "@shipfox/node-opentelemetry": "0.5.0",
+    "@shipfox/node-outbox": "0.2.1",
+    "@shipfox/node-temporal": "0.2.0",
+    "@shipfox/node-module": "0.2.0",
+    "@shipfox/node-postgres": "0.4.1"
+  },
+  "devDependencies": {
+    "@temporalio/activity": "^1.16.1",
+    "@temporalio/client": "^1.16.1",
+    "@temporalio/common": "^1.16.1",
+    "@temporalio/testing": "^1.16.1",
+    "@temporalio/worker": "^1.16.1",
+    "@types/pg": "^8.15.5",
+    "drizzle-kit": "^0.31.10",
+    "fastify": "^5.3.3",
+    "fastify-type-provider-zod": "^6.0.0",
+    "fishery": "^2.2.2",
+    "@shipfox/swc": "1.2.5",
+    "@shipfox/typescript": "1.1.6",
+    "@shipfox/ts-config": "1.3.8",
+    "@shipfox/biome": "1.8.1",
+    "@shipfox/vitest": "1.2.2"
+  },
+  "scripts": {
+    "build": "shipfox-swc",
+    "check": "shipfox-biome-check",
+    "check:fix": "shipfox-biome-check --write",
+    "test": "shipfox-vitest-run",
+    "test:watch": "shipfox-vitest-watch",
+    "type": "shipfox-tsc-check",
+    "type:emit": "shipfox-tsc-emit"
+  }
+}

package/src/core/entities/index.ts

@@ -0,0 +1 @@
+export type * from './project.js';

package/src/core/entities/project.ts

@@ -0,0 +1,9 @@
+export interface Project {
+  id: string;
+  workspaceId: string;
+  sourceConnectionId: string;
+  sourceExternalRepositoryId: string;
+  name: string;
+  createdAt: Date;
+  updatedAt: Date;
+}

package/src/core/errors.ts

@@ -0,0 +1,26 @@
+export class ProjectNotFoundError extends Error {
+  constructor(projectId: string) {
+    super(`Project not found: ${projectId}`);
+    this.name = 'ProjectNotFoundError';
+  }
+}
+
+export class ProjectAccessDeniedError extends Error {
+  constructor(projectId: string) {
+    super(`Access denied for project: ${projectId}`);
+    this.name = 'ProjectAccessDeniedError';
+  }
+}
+
+export class ProjectAlreadyExistsError extends Error {
+  constructor(
+    public readonly existingProjectId: string,
+    public readonly sourceConnectionId: string,
+    public readonly sourceExternalRepositoryId: string,
+  ) {
+    super(
+      `Project already exists for source repository: ${sourceConnectionId}/${sourceExternalRepositoryId}`,
+    );
+    this.name = 'ProjectAlreadyExistsError';
+  }
+}

package/src/core/index.ts

@@ -0,0 +1,8 @@
+export type * from './entities/index.js';
+export {
+  ProjectAccessDeniedError,
+  ProjectAlreadyExistsError,
+  ProjectNotFoundError,
+} from './errors.js';
+export type {CreateProjectFromSourceParams} from './projects.js';
+export {createProjectFromSource} from './projects.js';

package/src/core/projects.test.ts

@@ -0,0 +1,142 @@
+import type {IntegrationSourceControlService} from '@shipfox/api-integration-core';
+import {IntegrationProviderError} from '@shipfox/api-integration-core';
+import {sql} from 'drizzle-orm';
+import {db} from '#db/index.js';
+import {projectsOutbox} from '#db/schema/outbox.js';
+import {createProjectFromSource} from './projects.js';
+
+describe('createProjectFromSource', () => {
+  let actorId: string;
+  let workspaceId: string;
+  let sourceConnectionId: string;
+  let sourceControl: IntegrationSourceControlService;
+
+  beforeEach(() => {
+    actorId = crypto.randomUUID();
+    workspaceId = crypto.randomUUID();
+    sourceConnectionId = crypto.randomUUID();
+    sourceControl = {
+      getConnection: vi.fn(),
+      listRepositories: vi.fn(),
+      resolveRepository: vi.fn(async () => {
+        await Promise.resolve();
+        return {
+          connection: {
+            id: sourceConnectionId,
+            workspaceId,
+            provider: 'gitea' as const,
+            externalAccountId: 'gitea-owner',
+            slug: 'gitea_owner',
+            displayName: 'Gitea',
+            lifecycleStatus: 'active' as const,
+            capabilities: ['source_control' as const],
+            createdAt: new Date(),
+            updatedAt: new Date(),
+          },
+          repository: {
+            externalRepositoryId: 'gitea:gitea-owner/platform',
+            owner: 'gitea-owner',
+            name: 'platform',
+            fullName: 'gitea-owner/platform',
+            defaultBranch: 'main',
+            visibility: 'private' as const,
+            cloneUrl: 'https://gitea.local/gitea-owner/platform.git',
+            htmlUrl: 'https://gitea.local/gitea-owner/platform',
+          },
+        };
+      }),
+      listFiles: vi.fn(),
+      fetchFile: vi.fn(),
+      createCheckoutSpec: vi.fn(),
+    };
+  });
+
+  test('creates a project bound to a source repository', async () => {
+    const project = await createProjectFromSource({
+      actorId,
+      workspaceId,
+      name: 'Platform',
+      sourceConnectionId,
+      sourceExternalRepositoryId: 'gitea:gitea-owner/platform',
+      sourceControl,
+    });
+
+    expect(project.workspaceId).toBe(workspaceId);
+    expect(project.name).toBe('Platform');
+    expect(project.sourceConnectionId).toBe(sourceConnectionId);
+    expect(project.sourceExternalRepositoryId).toBe('gitea:gitea-owner/platform');
+  });
+
+  test('emits project lifecycle events in the same transaction', async () => {
+    const project = await createProjectFromSource({
+      actorId,
+      workspaceId,
+      name: 'Platform',
+      sourceConnectionId,
+      sourceExternalRepositoryId: 'gitea:gitea-owner/platform',
+      sourceControl,
+    });
+
+    const events = await db()
+      .select()
+      .from(projectsOutbox)
+      .where(sql`${projectsOutbox.payload}->>'projectId' = ${project.id}`);
+
+    expect(events.map((event) => event.eventType).sort()).toEqual([
+      'projects.project.created',
+      'projects.project.source_bound',
+    ]);
+    expect(events.map((event) => event.payload)).toEqual(
+      expect.arrayContaining([
+        expect.objectContaining({
+          sourceConnectionId,
+          sourceExternalRepositoryId: 'gitea:gitea-owner/platform',
+        }),
+        expect.objectContaining({
+          sourceConnectionId,
+          externalRepositoryId: 'gitea:gitea-owner/platform',
+          provider: 'gitea',
+        }),
+      ]),
+    );
+  });
+
+  test('rejects a second project for the same source repository', async () => {
+    await createProjectFromSource({
+      actorId,
+      workspaceId,
+      name: 'Platform',
+      sourceConnectionId,
+      sourceExternalRepositoryId: 'gitea:gitea-owner/platform',
+      sourceControl,
+    });
+
+    const result = createProjectFromSource({
+      actorId,
+      workspaceId,
+      name: 'Platform Again',
+      sourceConnectionId,
+      sourceExternalRepositoryId: 'gitea:gitea-owner/platform',
+      sourceControl,
+    });
+
+    await expect(result).rejects.toThrow('Project already exists');
+  });
+
+  test('surfaces provider repository access failures', async () => {
+    vi.mocked(sourceControl.resolveRepository).mockRejectedValueOnce(
+      new IntegrationProviderError('repository-not-found', 'Repository not found'),
+    );
+
+    const result = createProjectFromSource({
+      actorId,
+      workspaceId,
+      name: 'Missing',
+      sourceConnectionId,
+      sourceExternalRepositoryId: 'not-found',
+      sourceControl,
+    });
+
+    await expect(result).rejects.toMatchObject({reason: 'repository-not-found'});
+  });
+});