@contractspec/example.saas-boilerplate 1.57.0 → 1.59.0

package/dist/node/project/project.entity.js

@@ -0,0 +1,77 @@
+// src/project/project.entity.ts
+import {
+  defineEntity,
+  defineEntityEnum,
+  field,
+  index
+} from "@contractspec/lib.schema";
+var ProjectStatusEnum = defineEntityEnum({
+  name: "ProjectStatus",
+  values: ["DRAFT", "ACTIVE", "ARCHIVED", "DELETED"],
+  schema: "saas_app",
+  description: "Status of a project."
+});
+var ProjectEntity = defineEntity({
+  name: "Project",
+  description: "A project belonging to an organization.",
+  schema: "saas_app",
+  map: "project",
+  fields: {
+    id: field.id({ description: "Unique project ID" }),
+    name: field.string({ description: "Project name" }),
+    description: field.string({
+      isOptional: true,
+      description: "Project description"
+    }),
+    slug: field.string({
+      isOptional: true,
+      description: "URL-friendly identifier"
+    }),
+    organizationId: field.foreignKey({ description: "Owning organization" }),
+    createdBy: field.foreignKey({
+      description: "User who created the project"
+    }),
+    status: field.enum("ProjectStatus", { default: "DRAFT" }),
+    isPublic: field.boolean({
+      default: false,
+      description: "Whether project is publicly visible"
+    }),
+    settings: field.json({
+      isOptional: true,
+      description: "Project-specific settings"
+    }),
+    tags: field.string({ isArray: true, description: "Project tags" }),
+    metadata: field.json({ isOptional: true }),
+    createdAt: field.createdAt(),
+    updatedAt: field.updatedAt(),
+    archivedAt: field.dateTime({ isOptional: true })
+  },
+  indexes: [
+    index.on(["organizationId", "status"]),
+    index.on(["organizationId", "createdAt"]),
+    index.unique(["organizationId", "slug"])
+  ],
+  enums: [ProjectStatusEnum]
+});
+var ProjectMemberEntity = defineEntity({
+  name: "ProjectMember",
+  description: "User access to a specific project.",
+  schema: "saas_app",
+  map: "project_member",
+  fields: {
+    id: field.id(),
+    projectId: field.foreignKey(),
+    userId: field.foreignKey(),
+    role: field.string({
+      description: "Role in project (owner, editor, viewer)"
+    }),
+    addedBy: field.string({ isOptional: true }),
+    createdAt: field.createdAt()
+  },
+  indexes: [index.unique(["projectId", "userId"])]
+});
+export {
+  ProjectStatusEnum,
+  ProjectMemberEntity,
+  ProjectEntity
+};

package/dist/node/project/project.enum.js

@@ -0,0 +1,18 @@
+// src/project/project.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var ProjectStatusSchemaEnum = defineEnum("ProjectStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "ARCHIVED",
+  "DELETED"
+]);
+var ProjectStatusFilterEnum = defineEnum("ProjectStatusFilter", [
+  "DRAFT",
+  "ACTIVE",
+  "ARCHIVED",
+  "all"
+]);
+export {
+  ProjectStatusSchemaEnum,
+  ProjectStatusFilterEnum
+};

package/dist/node/project/project.event.js

@@ -0,0 +1,103 @@
+// src/project/project.event.ts
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var ProjectCreatedPayload = defineSchemaModel({
+  name: "ProjectCreatedPayload",
+  description: "Payload when a project is created",
+  fields: {
+    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ProjectUpdatedPayload = defineSchemaModel({
+  name: "ProjectUpdatedPayload",
+  description: "Payload when a project is updated",
+  fields: {
+    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    updatedFields: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: false
+    },
+    updatedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ProjectDeletedPayload = defineSchemaModel({
+  name: "ProjectDeletedPayload",
+  description: "Payload when a project is deleted",
+  fields: {
+    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    deletedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    deletedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ProjectArchivedPayload = defineSchemaModel({
+  name: "ProjectArchivedPayload",
+  description: "Payload when a project is archived",
+  fields: {
+    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    archivedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    archivedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var ProjectCreatedEvent = defineEvent({
+  meta: {
+    key: "project.created",
+    version: "1.0.0",
+    description: "A new project has been created.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["project", "created"]
+  },
+  payload: ProjectCreatedPayload
+});
+var ProjectUpdatedEvent = defineEvent({
+  meta: {
+    key: "project.updated",
+    version: "1.0.0",
+    description: "A project has been updated.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["project", "updated"]
+  },
+  payload: ProjectUpdatedPayload
+});
+var ProjectDeletedEvent = defineEvent({
+  meta: {
+    key: "project.deleted",
+    version: "1.0.0",
+    description: "A project has been deleted.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["project", "deleted"]
+  },
+  payload: ProjectDeletedPayload
+});
+var ProjectArchivedEvent = defineEvent({
+  meta: {
+    key: "project.archived",
+    version: "1.0.0",
+    description: "A project has been archived.",
+    stability: "stable",
+    owners: ["@saas-team"],
+    tags: ["project", "archived"]
+  },
+  payload: ProjectArchivedPayload
+});
+export {
+  ProjectUpdatedEvent,
+  ProjectDeletedEvent,
+  ProjectCreatedEvent,
+  ProjectArchivedEvent
+};

package/dist/node/project/project.handler.js

@@ -0,0 +1,178 @@
+// src/shared/mock-data.ts
+var MOCK_PROJECTS = [
+  {
+    id: "proj-1",
+    name: "Marketing Website",
+    description: "Main company website redesign project",
+    slug: "marketing-website",
+    organizationId: "demo-org",
+    createdBy: "user-1",
+    status: "ACTIVE",
+    isPublic: false,
+    tags: ["marketing", "website", "redesign"],
+    createdAt: new Date("2024-01-15T10:00:00Z"),
+    updatedAt: new Date("2024-03-20T14:30:00Z")
+  },
+  {
+    id: "proj-2",
+    name: "Mobile App v2",
+    description: "Next generation mobile application",
+    slug: "mobile-app-v2",
+    organizationId: "demo-org",
+    createdBy: "user-2",
+    status: "ACTIVE",
+    isPublic: false,
+    tags: ["mobile", "app", "v2"],
+    createdAt: new Date("2024-02-01T09:00:00Z"),
+    updatedAt: new Date("2024-04-05T11:15:00Z")
+  },
+  {
+    id: "proj-3",
+    name: "API Integration",
+    description: "Third-party API integration project",
+    slug: "api-integration",
+    organizationId: "demo-org",
+    createdBy: "user-1",
+    status: "DRAFT",
+    isPublic: false,
+    tags: ["api", "integration"],
+    createdAt: new Date("2024-03-10T08:00:00Z"),
+    updatedAt: new Date("2024-03-10T08:00:00Z")
+  },
+  {
+    id: "proj-4",
+    name: "Analytics Dashboard",
+    description: "Internal analytics and reporting dashboard",
+    slug: "analytics-dashboard",
+    organizationId: "demo-org",
+    createdBy: "user-3",
+    status: "ARCHIVED",
+    isPublic: true,
+    tags: ["analytics", "dashboard", "reporting"],
+    createdAt: new Date("2023-10-01T12:00:00Z"),
+    updatedAt: new Date("2024-02-28T16:45:00Z")
+  }
+];
+var MOCK_SUBSCRIPTION = {
+  id: "sub-1",
+  organizationId: "demo-org",
+  planId: "pro",
+  planName: "Professional",
+  status: "ACTIVE",
+  currentPeriodStart: new Date("2024-04-01T00:00:00Z"),
+  currentPeriodEnd: new Date("2024-05-01T00:00:00Z"),
+  limits: {
+    projects: 25,
+    users: 10,
+    storage: 50,
+    apiCalls: 1e5
+  },
+  usage: {
+    projects: 4,
+    users: 5,
+    storage: 12.5,
+    apiCalls: 45230
+  }
+};
+var MOCK_USAGE_SUMMARY = {
+  organizationId: "demo-org",
+  period: "current_month",
+  apiCalls: {
+    total: 45230,
+    limit: 1e5,
+    percentUsed: 45.23
+  },
+  storage: {
+    totalGb: 12.5,
+    limitGb: 50,
+    percentUsed: 25
+  },
+  activeProjects: 4,
+  activeUsers: 5,
+  breakdown: [
+    { date: "2024-04-01", apiCalls: 3200, storageGb: 12.1 },
+    { date: "2024-04-02", apiCalls: 2800, storageGb: 12.2 },
+    { date: "2024-04-03", apiCalls: 4100, storageGb: 12.3 },
+    { date: "2024-04-04", apiCalls: 3600, storageGb: 12.4 },
+    { date: "2024-04-05", apiCalls: 3800, storageGb: 12.5 }
+  ]
+};
+
+// src/project/project.handler.ts
+async function mockListProjectsHandler(input) {
+  const { status, search, limit = 20, offset = 0 } = input;
+  let filtered = [...MOCK_PROJECTS];
+  if (status && status !== "all") {
+    filtered = filtered.filter((p) => p.status === status);
+  }
+  if (search) {
+    const q = search.toLowerCase();
+    filtered = filtered.filter((p) => p.name.toLowerCase().includes(q) || p.description?.toLowerCase().includes(q) || p.tags.some((t) => t.toLowerCase().includes(q)));
+  }
+  filtered.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+  const total = filtered.length;
+  const projects = filtered.slice(offset, offset + limit);
+  return {
+    projects,
+    total
+  };
+}
+async function mockGetProjectHandler(input) {
+  const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
+  if (!project) {
+    throw new Error("NOT_FOUND");
+  }
+  return project;
+}
+async function mockCreateProjectHandler(input, context) {
+  if (input.slug) {
+    const exists = MOCK_PROJECTS.some((p) => p.slug === input.slug);
+    if (exists) {
+      throw new Error("SLUG_EXISTS");
+    }
+  }
+  const now = new Date;
+  return {
+    id: `proj-${Date.now()}`,
+    name: input.name,
+    description: input.description,
+    slug: input.slug ?? input.name.toLowerCase().replace(/\s+/g, "-"),
+    organizationId: context.organizationId,
+    createdBy: context.userId,
+    status: "DRAFT",
+    isPublic: input.isPublic ?? false,
+    tags: input.tags ?? [],
+    createdAt: now,
+    updatedAt: now
+  };
+}
+async function mockUpdateProjectHandler(input) {
+  const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
+  if (!project) {
+    throw new Error("NOT_FOUND");
+  }
+  return {
+    ...project,
+    name: input.name ?? project.name,
+    description: input.description ?? project.description,
+    slug: input.slug ?? project.slug,
+    isPublic: input.isPublic ?? project.isPublic,
+    tags: input.tags ?? project.tags,
+    status: input.status ?? project.status,
+    updatedAt: new Date
+  };
+}
+async function mockDeleteProjectHandler(input) {
+  const project = MOCK_PROJECTS.find((p) => p.id === input.projectId);
+  if (!project) {
+    throw new Error("NOT_FOUND");
+  }
+  return { success: true };
+}
+export {
+  mockUpdateProjectHandler,
+  mockListProjectsHandler,
+  mockGetProjectHandler,
+  mockDeleteProjectHandler,
+  mockCreateProjectHandler
+};