@meridianjs/project 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,116 @@
+# @meridianjs/project
+
+Project module for MeridianJS. Manages projects, labels, milestones, and custom project statuses. The Kanban board columns and issue status fields are driven entirely by `ProjectStatus` records — not hard-coded enums.
+
+Auto-loaded by `@meridianjs/meridian` — you do not need to add this to `modules[]` yourself.
+
+## Service: `projectModuleService`
+
+```typescript
+const svc = req.scope.resolve("projectModuleService") as any
+```
+
+### Auto-generated CRUD
+
+```typescript
+// Projects
+await svc.listProjects(filters?, options?)
+await svc.listAndCountProjects(filters?, options?)
+await svc.retrieveProject(id)
+await svc.createProject(data)
+await svc.updateProject(id, data)
+await svc.deleteProject(id)
+
+// Labels
+await svc.listLabels(filters?)
+await svc.createLabel(data)
+await svc.updateLabel(id, data)
+await svc.deleteLabel(id)
+
+// Milestones
+await svc.listMilestones(filters?)
+await svc.createMilestone(data)
+await svc.updateMilestone(id, data)
+await svc.deleteMilestone(id)
+
+// Project Statuses
+await svc.listProjectStatuses(filters?)
+await svc.retrieveProjectStatus(id)
+await svc.createProjectStatus(data)
+await svc.updateProjectStatus(id, data)
+await svc.deleteProjectStatus(id)
+```
+
+### Custom Methods
+
+```typescript
+// Find a project by its short identifier (e.g. "SITE", "APP")
+const project = await svc.retrieveProjectByIdentifier("SITE")
+
+// Auto-generate an identifier from a project name
+const identifier = svc.generateIdentifier("Website Redesign")  // → "WEBS"
+
+// List all labels for a project
+const labels = await svc.listLabelsByProject(projectId)
+
+// List all statuses for a project, ordered by position
+const statuses = await svc.listStatusesByProject(projectId)
+```
+
+## Data Models
+
+### Project
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | `uuid` | Primary key |
+| `name` | `text` | Project name |
+| `identifier` | `text` | Short uppercase code (e.g. `"SITE"`) |
+| `description` | `text` | Optional description |
+| `color` | `text` | Hex colour for UI |
+| `workspace_id` | `text` | Owning workspace |
+| `status` | `text` | `"active"` \| `"archived"` \| `"paused"` |
+| `visibility` | `text` | `"private"` \| `"public"` \| `"workspace"` |
+| `created_at` | `datetime` | — |
+| `updated_at` | `datetime` | — |
+
+### ProjectStatus
+
+Custom Kanban columns. Created automatically by `createProjectWorkflow` with 6 defaults, then fully managed via the statuses API.
+
+| Field | Type | Description |
+|---|---|---|
+| `id` | `uuid` | Primary key |
+| `project_id` | `text` | Owning project |
+| `name` | `text` | Display name (e.g. `"In Progress"`) |
+| `key` | `text` | Machine key (e.g. `"in_progress"`) |
+| `color` | `text` | Hex colour for the Kanban column |
+| `category` | `text` | `"backlog"` \| `"unstarted"` \| `"started"` \| `"completed"` \| `"cancelled"` |
+| `position` | `number` | Column order |
+
+### Default Statuses (seeded on project creation)
+
+| Name | Key | Category |
+|---|---|---|
+| Backlog | `backlog` | `backlog` |
+| Todo | `todo` | `unstarted` |
+| In Progress | `in_progress` | `started` |
+| In Review | `in_review` | `started` |
+| Done | `done` | `completed` |
+| Cancelled | `cancelled` | `cancelled` |
+
+## API Routes
+
+| Method | Path | Description |
+|---|---|---|
+| `GET/POST` | `/admin/projects` | List / create projects |
+| `GET/PUT/DELETE` | `/admin/projects/:id` | Get / update / delete project |
+| `GET/POST` | `/admin/projects/:id/statuses` | List / create custom statuses |
+| `PUT/DELETE` | `/admin/projects/:id/statuses/:statusId` | Update / delete a status |
+| `POST` | `/admin/projects/:id/statuses/reorder` | Reorder columns |
+| `GET/POST` | `/admin/projects/:id/labels` | Manage project labels |
+| `GET/POST` | `/admin/projects/:id/milestones` | Manage milestones |
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -21,6 +21,12 @@ declare class ProjectModuleService extends ProjectModuleService_base {
     listMilestonesByProject(projectId: string): Promise<any[]>;
     /** List all statuses for a given project, ordered by position. */
     listStatusesByProject(projectId: string): Promise<any[]>;
+    /** Generate a random share token and set visibility to "public". */
+    generateShareToken(projectId: string): Promise<any>;
+    /** Remove the share token and set visibility back to "private". */
+    revokeShareToken(projectId: string): Promise<any>;
+    /** Find a project by share token. Returns null if not found or not public. */
+    retrieveProjectByShareToken(token: string): Promise<any | null>;
     /** Update position field for each status to match the provided orderedIds index. */
     reorderStatuses(projectId: string, orderedIds: string[]): Promise<void>;
 }

package/dist/index.d.ts

@@ -21,6 +21,12 @@ declare class ProjectModuleService extends ProjectModuleService_base {
     listMilestonesByProject(projectId: string): Promise<any[]>;
     /** List all statuses for a given project, ordered by position. */
     listStatusesByProject(projectId: string): Promise<any[]>;
+    /** Generate a random share token and set visibility to "public". */
+    generateShareToken(projectId: string): Promise<any>;
+    /** Remove the share token and set visibility back to "private". */
+    revokeShareToken(projectId: string): Promise<any>;
+    /** Find a project by share token. Returns null if not found or not public. */
+    retrieveProjectByShareToken(token: string): Promise<any | null>;
     /** Update position field for each status to match the provided orderedIds index. */
     reorderStatuses(projectId: string, orderedIds: string[]): Promise<void>;
 }

package/dist/index.js

@@ -29,6 +29,7 @@ var import_framework_utils7 = require("@meridianjs/framework-utils");
 
 // src/service.ts
 var import_framework_utils5 = require("@meridianjs/framework-utils");
+var import_crypto = require("crypto");
 
 // src/models/project.ts
 var import_framework_utils = require("@meridianjs/framework-utils");
@@ -45,6 +46,7 @@ var Project = import_framework_utils.model.define("project", {
   /** Denormalized workspace reference — no FK constraint */
   workspace_id: import_framework_utils.model.text(),
   owner_id: import_framework_utils.model.text().nullable(),
+  share_token: import_framework_utils.model.text().nullable(),
   /** Arbitrary key/value storage for custom integrations */
   metadata: import_framework_utils.model.json().nullable()
 }, [
@@ -169,6 +171,24 @@ var ProjectModuleService = class extends (0, import_framework_utils5.MeridianSer
     const repo = this.container.resolve("projectStatusRepository");
     return repo.find({ project_id: projectId }, { orderBy: { position: "ASC" } });
   }
+  /** Generate a random share token and set visibility to "public". */
+  async generateShareToken(projectId) {
+    const token = (0, import_crypto.randomBytes)(32).toString("hex");
+    return this.updateProject(projectId, { share_token: token, visibility: "public" });
+  }
+  /** Remove the share token and set visibility back to "private". */
+  async revokeShareToken(projectId) {
+    return this.updateProject(projectId, { share_token: null, visibility: "private" });
+  }
+  /** Find a project by share token. Returns null if not found or not public. */
+  async retrieveProjectByShareToken(token) {
+    const repo = this.container.resolve("projectRepository");
+    try {
+      return await repo.findOneOrFail({ share_token: token, visibility: "public" });
+    } catch {
+      return null;
+    }
+  }
   /** Update position field for each status to match the provided orderedIds index. */
   async reorderStatuses(projectId, orderedIds) {
     const repo = this.container.resolve("projectStatusRepository");

package/dist/index.mjs

@@ -3,6 +3,7 @@ import { Module } from "@meridianjs/framework-utils";
 
 // src/service.ts
 import { MeridianService } from "@meridianjs/framework-utils";
+import { randomBytes } from "crypto";
 
 // src/models/project.ts
 import { model } from "@meridianjs/framework-utils";
@@ -19,6 +20,7 @@ var Project = model.define("project", {
   /** Denormalized workspace reference — no FK constraint */
   workspace_id: model.text(),
   owner_id: model.text().nullable(),
+  share_token: model.text().nullable(),
   /** Arbitrary key/value storage for custom integrations */
   metadata: model.json().nullable()
 }, [
@@ -143,6 +145,24 @@ var ProjectModuleService = class extends MeridianService({
     const repo = this.container.resolve("projectStatusRepository");
     return repo.find({ project_id: projectId }, { orderBy: { position: "ASC" } });
   }
+  /** Generate a random share token and set visibility to "public". */
+  async generateShareToken(projectId) {
+    const token = randomBytes(32).toString("hex");
+    return this.updateProject(projectId, { share_token: token, visibility: "public" });
+  }
+  /** Remove the share token and set visibility back to "private". */
+  async revokeShareToken(projectId) {
+    return this.updateProject(projectId, { share_token: null, visibility: "private" });
+  }
+  /** Find a project by share token. Returns null if not found or not public. */
+  async retrieveProjectByShareToken(token) {
+    const repo = this.container.resolve("projectRepository");
+    try {
+      return await repo.findOneOrFail({ share_token: token, visibility: "public" });
+    } catch {
+      return null;
+    }
+  }
   /** Update position field for each status to match the provided orderedIds index. */
   async reorderStatuses(projectId, orderedIds) {
     const repo = this.container.resolve("projectStatusRepository");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meridianjs/project",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Meridian project module — Project, Label, Milestone domain models",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",