@meridianjs/project 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,31 @@
+import * as _meridianjs_types from '@meridianjs/types';
+import { MeridianContainer } from '@meridianjs/types';
+
+declare const ProjectModuleService_base: new (container: MeridianContainer) => _meridianjs_types.IModuleService;
+declare class ProjectModuleService extends ProjectModuleService_base {
+    private readonly container;
+    constructor(container: MeridianContainer);
+    /** Find a project by its short identifier code (e.g. "PROJ"). */
+    retrieveProjectByIdentifier(identifier: string): Promise<any | null>;
+    /**
+     * Generate a 3–5 character uppercase alphanumeric identifier from a project name.
+     * - Prefer at least 4 chars; if the name is only 3 letters, use those (e.g. "API" → "API").
+     * - Multiple words: acronym (first letter of each); if < 4 chars, extend with subsequent letters.
+     * - Single word 4+: first 4 (e.g. "Backend" → "BACK"). Single word 1–2: pad to 4 with "X".
+     * Examples: "My Project" → "MPYR", "API" → "API", "Backend" → "BACK", "Alpha Beta" → "ABLP".
+     */
+    generateIdentifier(name: string): string;
+    /** List all labels for a given project. */
+    listLabelsByProject(projectId: string): Promise<any[]>;
+    /** List all milestones for a given project. */
+    listMilestonesByProject(projectId: string): Promise<any[]>;
+    /** List all statuses for a given project, ordered by position. */
+    listStatusesByProject(projectId: string): Promise<any[]>;
+    /** Update position field for each status to match the provided orderedIds index. */
+    reorderStatuses(projectId: string, orderedIds: string[]): Promise<void>;
+}
+
+declare const PROJECT_MODULE = "projectModuleService";
+declare const _default: _meridianjs_types.ModuleDefinition;
+
+export { PROJECT_MODULE, ProjectModuleService, _default as default };

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import * as _meridianjs_types from '@meridianjs/types';
+import { MeridianContainer } from '@meridianjs/types';
+
+declare const ProjectModuleService_base: new (container: MeridianContainer) => _meridianjs_types.IModuleService;
+declare class ProjectModuleService extends ProjectModuleService_base {
+    private readonly container;
+    constructor(container: MeridianContainer);
+    /** Find a project by its short identifier code (e.g. "PROJ"). */
+    retrieveProjectByIdentifier(identifier: string): Promise<any | null>;
+    /**
+     * Generate a 3–5 character uppercase alphanumeric identifier from a project name.
+     * - Prefer at least 4 chars; if the name is only 3 letters, use those (e.g. "API" → "API").
+     * - Multiple words: acronym (first letter of each); if < 4 chars, extend with subsequent letters.
+     * - Single word 4+: first 4 (e.g. "Backend" → "BACK"). Single word 1–2: pad to 4 with "X".
+     * Examples: "My Project" → "MPYR", "API" → "API", "Backend" → "BACK", "Alpha Beta" → "ABLP".
+     */
+    generateIdentifier(name: string): string;
+    /** List all labels for a given project. */
+    listLabelsByProject(projectId: string): Promise<any[]>;
+    /** List all milestones for a given project. */
+    listMilestonesByProject(projectId: string): Promise<any[]>;
+    /** List all statuses for a given project, ordered by position. */
+    listStatusesByProject(projectId: string): Promise<any[]>;
+    /** Update position field for each status to match the provided orderedIds index. */
+    reorderStatuses(projectId: string, orderedIds: string[]): Promise<void>;
+}
+
+declare const PROJECT_MODULE = "projectModuleService";
+declare const _default: _meridianjs_types.ModuleDefinition;
+
+export { PROJECT_MODULE, ProjectModuleService, _default as default };

package/dist/index.js

@@ -0,0 +1,216 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PROJECT_MODULE: () => PROJECT_MODULE,
+  ProjectModuleService: () => ProjectModuleService,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_framework_utils7 = require("@meridianjs/framework-utils");
+
+// src/service.ts
+var import_framework_utils5 = require("@meridianjs/framework-utils");
+
+// src/models/project.ts
+var import_framework_utils = require("@meridianjs/framework-utils");
+var Project = import_framework_utils.model.define("project", {
+  id: import_framework_utils.model.id().primaryKey(),
+  name: import_framework_utils.model.text(),
+  /** Short uppercase code used as issue identifier prefix, e.g. "PROJ" */
+  identifier: import_framework_utils.model.text(),
+  description: import_framework_utils.model.text().nullable(),
+  status: import_framework_utils.model.enum(["active", "archived", "paused"]).default("active"),
+  visibility: import_framework_utils.model.enum(["private", "public", "workspace"]).default("private"),
+  icon: import_framework_utils.model.text().nullable(),
+  color: import_framework_utils.model.text().nullable(),
+  /** Denormalized workspace reference — no FK constraint */
+  workspace_id: import_framework_utils.model.text(),
+  owner_id: import_framework_utils.model.text().nullable()
+}, [
+  { columns: ["workspace_id"] },
+  { columns: ["identifier"], unique: true }
+]);
+var project_default = Project;
+
+// src/models/label.ts
+var import_framework_utils2 = require("@meridianjs/framework-utils");
+var Label = import_framework_utils2.model.define("label", {
+  id: import_framework_utils2.model.id().primaryKey(),
+  name: import_framework_utils2.model.text(),
+  color: import_framework_utils2.model.text(),
+  project_id: import_framework_utils2.model.text()
+});
+var label_default = Label;
+
+// src/models/milestone.ts
+var import_framework_utils3 = require("@meridianjs/framework-utils");
+var Milestone = import_framework_utils3.model.define("milestone", {
+  id: import_framework_utils3.model.id().primaryKey(),
+  name: import_framework_utils3.model.text(),
+  description: import_framework_utils3.model.text().nullable(),
+  project_id: import_framework_utils3.model.text(),
+  status: import_framework_utils3.model.enum(["open", "closed"]).default("open"),
+  due_date: import_framework_utils3.model.date().nullable()
+});
+var milestone_default = Milestone;
+
+// src/models/project-status.ts
+var import_framework_utils4 = require("@meridianjs/framework-utils");
+var ProjectStatus = import_framework_utils4.model.define("project_status", {
+  id: import_framework_utils4.model.id().primaryKey(),
+  /** Denormalized project reference — no FK constraint */
+  project_id: import_framework_utils4.model.text(),
+  /** Display label, e.g. "In Progress" */
+  name: import_framework_utils4.model.text(),
+  /** URL-safe slug stored on Issue.status, e.g. "in_progress" */
+  key: import_framework_utils4.model.text(),
+  /** Hex color, e.g. "#6366f1" */
+  color: import_framework_utils4.model.text(),
+  /** Semantic category used for board icon and grouping */
+  category: import_framework_utils4.model.enum(["backlog", "unstarted", "started", "completed", "cancelled"]),
+  /** Zero-indexed column order */
+  position: import_framework_utils4.model.number()
+}, [
+  { columns: ["project_id"] }
+]);
+var project_status_default = ProjectStatus;
+
+// src/service.ts
+var ProjectModuleService = class extends (0, import_framework_utils5.MeridianService)({
+  Project: project_default,
+  Label: label_default,
+  Milestone: milestone_default,
+  ProjectStatus: project_status_default
+}) {
+  container;
+  constructor(container) {
+    super(container);
+    this.container = container;
+  }
+  /** Find a project by its short identifier code (e.g. "PROJ"). */
+  async retrieveProjectByIdentifier(identifier) {
+    const repo = this.container.resolve("projectRepository");
+    try {
+      return await repo.findOneOrFail({ identifier: identifier.toUpperCase() });
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Generate a 3–5 character uppercase alphanumeric identifier from a project name.
+   * - Prefer at least 4 chars; if the name is only 3 letters, use those (e.g. "API" → "API").
+   * - Multiple words: acronym (first letter of each); if < 4 chars, extend with subsequent letters.
+   * - Single word 4+: first 4 (e.g. "Backend" → "BACK"). Single word 1–2: pad to 4 with "X".
+   * Examples: "My Project" → "MPYR", "API" → "API", "Backend" → "BACK", "Alpha Beta" → "ABLP".
+   */
+  generateIdentifier(name) {
+    const words = name.trim().split(/\s+/).map((w) => w.replace(/[^A-Za-z0-9]/g, "").toUpperCase()).filter(Boolean);
+    if (words.length === 0) return "PROJ";
+    const maxLen = 5;
+    if (words.length === 1) {
+      const word = words[0];
+      if (word.length >= 4) return word.substring(0, maxLen);
+      if (word.length === 3) return word;
+      return word.padEnd(4, "X").substring(0, maxLen);
+    }
+    let acronym = words.map((w) => w[0]).join("");
+    if (acronym.length >= 4) return acronym.substring(0, maxLen);
+    let result = acronym;
+    let wi = 0;
+    let ci = 1;
+    while (result.length < 4 && wi < words.length) {
+      const word = words[wi];
+      if (ci < word.length) {
+        result += word[ci];
+        ci++;
+      } else {
+        wi++;
+        ci = 1;
+      }
+    }
+    result = result.substring(0, maxLen);
+    return result.length >= 4 ? result : result.padEnd(4, "X").substring(0, maxLen);
+  }
+  /** List all labels for a given project. */
+  async listLabelsByProject(projectId) {
+    const repo = this.container.resolve("labelRepository");
+    return repo.find({ project_id: projectId });
+  }
+  /** List all milestones for a given project. */
+  async listMilestonesByProject(projectId) {
+    const repo = this.container.resolve("milestoneRepository");
+    return repo.find({ project_id: projectId });
+  }
+  /** List all statuses for a given project, ordered by position. */
+  async listStatusesByProject(projectId) {
+    const repo = this.container.resolve("projectStatusRepository");
+    return repo.find({ project_id: projectId }, { orderBy: { position: "ASC" } });
+  }
+  /** Update position field for each status to match the provided orderedIds index. */
+  async reorderStatuses(projectId, orderedIds) {
+    const repo = this.container.resolve("projectStatusRepository");
+    for (let i = 0; i < orderedIds.length; i++) {
+      const entity = await repo.findOneOrFail({ id: orderedIds[i], project_id: projectId });
+      Object.assign(entity, { position: i });
+    }
+    await repo.flush();
+  }
+};
+
+// src/loaders/default.ts
+var import_framework_utils6 = require("@meridianjs/framework-utils");
+var ProjectSchema = (0, import_framework_utils6.dmlToEntitySchema)(project_default);
+var LabelSchema = (0, import_framework_utils6.dmlToEntitySchema)(label_default);
+var MilestoneSchema = (0, import_framework_utils6.dmlToEntitySchema)(milestone_default);
+var ProjectStatusSchema = (0, import_framework_utils6.dmlToEntitySchema)(project_status_default);
+var entitySchemas = [ProjectSchema, LabelSchema, MilestoneSchema, ProjectStatusSchema];
+async function defaultLoader({ container }) {
+  const config = container.resolve("config");
+  const { databaseUrl } = config.projectConfig;
+  const orm = await (0, import_framework_utils6.createModuleOrm)(entitySchemas, databaseUrl);
+  const em = orm.em.fork();
+  container.register({
+    projectRepository: (0, import_framework_utils6.createRepository)(em, "project"),
+    labelRepository: (0, import_framework_utils6.createRepository)(em, "label"),
+    milestoneRepository: (0, import_framework_utils6.createRepository)(em, "milestone"),
+    projectStatusRepository: (0, import_framework_utils6.createRepository)(em, "project_status"),
+    projectOrm: orm
+  });
+}
+
+// src/index.ts
+var PROJECT_MODULE = "projectModuleService";
+var index_default = (0, import_framework_utils7.Module)(PROJECT_MODULE, {
+  service: ProjectModuleService,
+  models: [project_default, label_default, milestone_default, project_status_default],
+  loaders: [defaultLoader],
+  linkable: {
+    project: { tableName: "project", primaryKey: "id" },
+    label: { tableName: "label", primaryKey: "id" },
+    milestone: { tableName: "milestone", primaryKey: "id" }
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PROJECT_MODULE,
+  ProjectModuleService
+});

package/dist/index.mjs

@@ -0,0 +1,190 @@
+// src/index.ts
+import { Module } from "@meridianjs/framework-utils";
+
+// src/service.ts
+import { MeridianService } from "@meridianjs/framework-utils";
+
+// src/models/project.ts
+import { model } from "@meridianjs/framework-utils";
+var Project = model.define("project", {
+  id: model.id().primaryKey(),
+  name: model.text(),
+  /** Short uppercase code used as issue identifier prefix, e.g. "PROJ" */
+  identifier: model.text(),
+  description: model.text().nullable(),
+  status: model.enum(["active", "archived", "paused"]).default("active"),
+  visibility: model.enum(["private", "public", "workspace"]).default("private"),
+  icon: model.text().nullable(),
+  color: model.text().nullable(),
+  /** Denormalized workspace reference — no FK constraint */
+  workspace_id: model.text(),
+  owner_id: model.text().nullable()
+}, [
+  { columns: ["workspace_id"] },
+  { columns: ["identifier"], unique: true }
+]);
+var project_default = Project;
+
+// src/models/label.ts
+import { model as model2 } from "@meridianjs/framework-utils";
+var Label = model2.define("label", {
+  id: model2.id().primaryKey(),
+  name: model2.text(),
+  color: model2.text(),
+  project_id: model2.text()
+});
+var label_default = Label;
+
+// src/models/milestone.ts
+import { model as model3 } from "@meridianjs/framework-utils";
+var Milestone = model3.define("milestone", {
+  id: model3.id().primaryKey(),
+  name: model3.text(),
+  description: model3.text().nullable(),
+  project_id: model3.text(),
+  status: model3.enum(["open", "closed"]).default("open"),
+  due_date: model3.date().nullable()
+});
+var milestone_default = Milestone;
+
+// src/models/project-status.ts
+import { model as model4 } from "@meridianjs/framework-utils";
+var ProjectStatus = model4.define("project_status", {
+  id: model4.id().primaryKey(),
+  /** Denormalized project reference — no FK constraint */
+  project_id: model4.text(),
+  /** Display label, e.g. "In Progress" */
+  name: model4.text(),
+  /** URL-safe slug stored on Issue.status, e.g. "in_progress" */
+  key: model4.text(),
+  /** Hex color, e.g. "#6366f1" */
+  color: model4.text(),
+  /** Semantic category used for board icon and grouping */
+  category: model4.enum(["backlog", "unstarted", "started", "completed", "cancelled"]),
+  /** Zero-indexed column order */
+  position: model4.number()
+}, [
+  { columns: ["project_id"] }
+]);
+var project_status_default = ProjectStatus;
+
+// src/service.ts
+var ProjectModuleService = class extends MeridianService({
+  Project: project_default,
+  Label: label_default,
+  Milestone: milestone_default,
+  ProjectStatus: project_status_default
+}) {
+  container;
+  constructor(container) {
+    super(container);
+    this.container = container;
+  }
+  /** Find a project by its short identifier code (e.g. "PROJ"). */
+  async retrieveProjectByIdentifier(identifier) {
+    const repo = this.container.resolve("projectRepository");
+    try {
+      return await repo.findOneOrFail({ identifier: identifier.toUpperCase() });
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Generate a 3–5 character uppercase alphanumeric identifier from a project name.
+   * - Prefer at least 4 chars; if the name is only 3 letters, use those (e.g. "API" → "API").
+   * - Multiple words: acronym (first letter of each); if < 4 chars, extend with subsequent letters.
+   * - Single word 4+: first 4 (e.g. "Backend" → "BACK"). Single word 1–2: pad to 4 with "X".
+   * Examples: "My Project" → "MPYR", "API" → "API", "Backend" → "BACK", "Alpha Beta" → "ABLP".
+   */
+  generateIdentifier(name) {
+    const words = name.trim().split(/\s+/).map((w) => w.replace(/[^A-Za-z0-9]/g, "").toUpperCase()).filter(Boolean);
+    if (words.length === 0) return "PROJ";
+    const maxLen = 5;
+    if (words.length === 1) {
+      const word = words[0];
+      if (word.length >= 4) return word.substring(0, maxLen);
+      if (word.length === 3) return word;
+      return word.padEnd(4, "X").substring(0, maxLen);
+    }
+    let acronym = words.map((w) => w[0]).join("");
+    if (acronym.length >= 4) return acronym.substring(0, maxLen);
+    let result = acronym;
+    let wi = 0;
+    let ci = 1;
+    while (result.length < 4 && wi < words.length) {
+      const word = words[wi];
+      if (ci < word.length) {
+        result += word[ci];
+        ci++;
+      } else {
+        wi++;
+        ci = 1;
+      }
+    }
+    result = result.substring(0, maxLen);
+    return result.length >= 4 ? result : result.padEnd(4, "X").substring(0, maxLen);
+  }
+  /** List all labels for a given project. */
+  async listLabelsByProject(projectId) {
+    const repo = this.container.resolve("labelRepository");
+    return repo.find({ project_id: projectId });
+  }
+  /** List all milestones for a given project. */
+  async listMilestonesByProject(projectId) {
+    const repo = this.container.resolve("milestoneRepository");
+    return repo.find({ project_id: projectId });
+  }
+  /** List all statuses for a given project, ordered by position. */
+  async listStatusesByProject(projectId) {
+    const repo = this.container.resolve("projectStatusRepository");
+    return repo.find({ project_id: projectId }, { orderBy: { position: "ASC" } });
+  }
+  /** Update position field for each status to match the provided orderedIds index. */
+  async reorderStatuses(projectId, orderedIds) {
+    const repo = this.container.resolve("projectStatusRepository");
+    for (let i = 0; i < orderedIds.length; i++) {
+      const entity = await repo.findOneOrFail({ id: orderedIds[i], project_id: projectId });
+      Object.assign(entity, { position: i });
+    }
+    await repo.flush();
+  }
+};
+
+// src/loaders/default.ts
+import { dmlToEntitySchema, createRepository, createModuleOrm } from "@meridianjs/framework-utils";
+var ProjectSchema = dmlToEntitySchema(project_default);
+var LabelSchema = dmlToEntitySchema(label_default);
+var MilestoneSchema = dmlToEntitySchema(milestone_default);
+var ProjectStatusSchema = dmlToEntitySchema(project_status_default);
+var entitySchemas = [ProjectSchema, LabelSchema, MilestoneSchema, ProjectStatusSchema];
+async function defaultLoader({ container }) {
+  const config = container.resolve("config");
+  const { databaseUrl } = config.projectConfig;
+  const orm = await createModuleOrm(entitySchemas, databaseUrl);
+  const em = orm.em.fork();
+  container.register({
+    projectRepository: createRepository(em, "project"),
+    labelRepository: createRepository(em, "label"),
+    milestoneRepository: createRepository(em, "milestone"),
+    projectStatusRepository: createRepository(em, "project_status"),
+    projectOrm: orm
+  });
+}
+
+// src/index.ts
+var PROJECT_MODULE = "projectModuleService";
+var index_default = Module(PROJECT_MODULE, {
+  service: ProjectModuleService,
+  models: [project_default, label_default, milestone_default, project_status_default],
+  loaders: [defaultLoader],
+  linkable: {
+    project: { tableName: "project", primaryKey: "id" },
+    label: { tableName: "label", primaryKey: "id" },
+    milestone: { tableName: "milestone", primaryKey: "id" }
+  }
+});
+export {
+  PROJECT_MODULE,
+  ProjectModuleService,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@meridianjs/project",
+  "version": "0.1.0",
+  "description": "Meridian project module — Project, Label, Milestone domain models",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@meridianjs/framework-utils": "^0.1.0",
+    "@meridianjs/types": "^0.1.0",
+    "@mikro-orm/core": "^6.4.3",
+    "@mikro-orm/postgresql": "^6.4.3"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "*"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}