@contractspec/example.saas-boilerplate 1.57.0 → 1.58.0

package/dist/project/index.js

@@ -1,9 +1,791 @@
-import { ProjectStatusFilterEnum, ProjectStatusSchemaEnum } from "./project.enum.js";
-import { CreateProjectInputModel, DeleteProjectInputModel, DeleteProjectOutputModel, GetProjectInputModel, ListProjectsInputModel, ListProjectsOutputModel, ProjectDeletedPayloadModel, ProjectModel, UpdateProjectInputModel } from "./project.schema.js";
-import { CreateProjectContract, DeleteProjectContract, GetProjectContract, ListProjectsContract, UpdateProjectContract } from "./project.operations.js";
-import { ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectUpdatedEvent } from "./project.event.js";
-import { ProjectEntity, ProjectMemberEntity, ProjectStatusEnum } from "./project.entity.js";
-import { ProjectDetailPresentation, ProjectListPresentation } from "./project.presentation.js";
-import { mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler } from "./project.handler.js";
-
-export { CreateProjectContract, CreateProjectInputModel, DeleteProjectContract, DeleteProjectInputModel, DeleteProjectOutputModel, GetProjectContract, GetProjectInputModel, ListProjectsContract, ListProjectsInputModel, ListProjectsOutputModel, ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectDeletedPayloadModel, ProjectDetailPresentation, ProjectEntity, ProjectListPresentation, ProjectMemberEntity, ProjectModel, ProjectStatusEnum, ProjectStatusFilterEnum, ProjectStatusSchemaEnum, ProjectUpdatedEvent, UpdateProjectContract, UpdateProjectInputModel, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler };
+// @bun
+// 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 };
+}
+
+// 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"
+]);
+
+// src/project/project.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var ProjectModel = defineSchemaModel({
+  name: "Project",
+  description: "A project within an organization",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: ProjectStatusSchemaEnum, isOptional: false },
+    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: false
+    },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var CreateProjectInputModel = defineSchemaModel({
+  name: "CreateProjectInput",
+  description: "Input for creating a project",
+  fields: {
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: true },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    }
+  }
+});
+var UpdateProjectInputModel = defineSchemaModel({
+  name: "UpdateProjectInput",
+  description: "Input for updating a project",
+  fields: {
+    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: true },
+    tags: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isArray: true,
+      isOptional: true
+    },
+    status: { type: ProjectStatusSchemaEnum, isOptional: true }
+  }
+});
+var GetProjectInputModel = defineSchemaModel({
+  name: "GetProjectInput",
+  fields: {
+    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var DeleteProjectInputModel = defineSchemaModel({
+  name: "DeleteProjectInput",
+  fields: {
+    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var DeleteProjectOutputModel = defineSchemaModel({
+  name: "DeleteProjectOutput",
+  fields: {
+    success: { type: ScalarTypeEnum.Boolean(), isOptional: false }
+  }
+});
+var ProjectDeletedPayloadModel = defineSchemaModel({
+  name: "ProjectDeletedPayload",
+  fields: {
+    projectId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
+});
+var ListProjectsInputModel = defineSchemaModel({
+  name: "ListProjectsInput",
+  description: "Input for listing projects",
+  fields: {
+    status: { type: ProjectStatusFilterEnum, isOptional: true },
+    search: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    limit: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 20
+    },
+    offset: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: true,
+      defaultValue: 0
+    }
+  }
+});
+var ListProjectsOutputModel = defineSchemaModel({
+  name: "ListProjectsOutput",
+  description: "Output for listing projects",
+  fields: {
+    projects: { type: ProjectModel, isArray: true, isOptional: false },
+    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
+  }
+});
+
+// src/project/project.operations.ts
+import {
+  defineCommand,
+  defineQuery
+} from "@contractspec/lib.contracts/operations";
+var OWNERS = ["example.saas-boilerplate"];
+var CreateProjectContract = defineCommand({
+  meta: {
+    key: "saas.project.create",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "project", "create"],
+    description: "Create a new project in the organization.",
+    goal: "Allow users to create projects for organizing work.",
+    context: "Called from project creation UI or API."
+  },
+  io: {
+    input: CreateProjectInputModel,
+    output: ProjectModel,
+    errors: {
+      SLUG_EXISTS: {
+        description: "A project with this slug already exists",
+        http: 409,
+        gqlCode: "SLUG_EXISTS",
+        when: "Slug is already taken in the organization"
+      },
+      LIMIT_REACHED: {
+        description: "Project limit reached for this plan",
+        http: 403,
+        gqlCode: "LIMIT_REACHED",
+        when: "Organization has reached project limit"
+      }
+    }
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "project.created",
+        version: "1.0.0",
+        when: "Project is created",
+        payload: ProjectModel
+      }
+    ],
+    audit: ["project.created"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "create-project-happy-path",
+        given: ["User is authenticated"],
+        when: ["User creates project"],
+        then: ["Project is created", "ProjectCreated event is emitted"]
+      }
+    ],
+    examples: [
+      {
+        key: "create-basic",
+        input: { name: "Website Redesign", slug: "website-redesign" },
+        output: { id: "proj-123", name: "Website Redesign", isArchived: false }
+      }
+    ]
+  }
+});
+var GetProjectContract = defineQuery({
+  meta: {
+    key: "saas.project.get",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "project", "get"],
+    description: "Get a project by ID.",
+    goal: "Retrieve project details.",
+    context: "Project detail page, API calls."
+  },
+  io: {
+    input: GetProjectInputModel,
+    output: ProjectModel,
+    errors: {
+      NOT_FOUND: {
+        description: "Project not found",
+        http: 404,
+        gqlCode: "NOT_FOUND",
+        when: "Project ID is invalid or user lacks access"
+      }
+    }
+  },
+  policy: {
+    auth: "user"
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "get-project-happy-path",
+        given: ["Project exists"],
+        when: ["User requests project"],
+        then: ["Project details are returned"]
+      }
+    ],
+    examples: [
+      {
+        key: "get-existing",
+        input: { projectId: "proj-123" },
+        output: { id: "proj-123", name: "Website Redesign" }
+      }
+    ]
+  }
+});
+var UpdateProjectContract = defineCommand({
+  meta: {
+    key: "saas.project.update",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "project", "update"],
+    description: "Update project details.",
+    goal: "Allow project owners/editors to modify project.",
+    context: "Project settings page."
+  },
+  io: {
+    input: UpdateProjectInputModel,
+    output: ProjectModel
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "project.updated",
+        version: "1.0.0",
+        when: "Project is updated",
+        payload: ProjectModel
+      }
+    ],
+    audit: ["project.updated"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "update-project-happy-path",
+        given: ["Project exists"],
+        when: ["User updates description"],
+        then: ["Project is updated", "ProjectUpdated event is emitted"]
+      }
+    ],
+    examples: [
+      {
+        key: "update-desc",
+        input: { projectId: "proj-123", description: "New description" },
+        output: { id: "proj-123", description: "New description" }
+      }
+    ]
+  }
+});
+var DeleteProjectContract = defineCommand({
+  meta: {
+    key: "saas.project.delete",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "project", "delete"],
+    description: "Delete a project (soft delete).",
+    goal: "Allow project owners to remove projects.",
+    context: "Project settings page."
+  },
+  io: {
+    input: DeleteProjectInputModel,
+    output: DeleteProjectOutputModel
+  },
+  policy: {
+    auth: "user"
+  },
+  sideEffects: {
+    emits: [
+      {
+        key: "project.deleted",
+        version: "1.0.0",
+        when: "Project is deleted",
+        payload: ProjectDeletedPayloadModel
+      }
+    ],
+    audit: ["project.deleted"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "delete-project-happy-path",
+        given: ["Project exists"],
+        when: ["User deletes project"],
+        then: ["Project is deleted", "ProjectDeleted event is emitted"]
+      }
+    ],
+    examples: [
+      {
+        key: "delete-existing",
+        input: { projectId: "proj-123" },
+        output: { success: true }
+      }
+    ]
+  }
+});
+var ListProjectsContract = defineQuery({
+  meta: {
+    key: "saas.project.list",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["saas", "project", "list"],
+    description: "List projects in the organization.",
+    goal: "Show all projects user has access to.",
+    context: "Project list page, dashboard."
+  },
+  io: {
+    input: ListProjectsInputModel,
+    output: ListProjectsOutputModel
+  },
+  policy: {
+    auth: "user"
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "list-projects-happy-path",
+        given: ["Projects exist"],
+        when: ["User lists projects"],
+        then: ["List of projects is returned"]
+      }
+    ],
+    examples: [
+      {
+        key: "list-all",
+        input: { limit: 10 },
+        output: { items: [], total: 5 }
+      }
+    ]
+  }
+});
+
+// src/project/project.event.ts
+import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
+import { defineEvent } from "@contractspec/lib.contracts";
+var ProjectCreatedPayload = defineSchemaModel2({
+  name: "ProjectCreatedPayload",
+  description: "Payload when a project is created",
+  fields: {
+    projectId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum2.String_unsecure(),
+      isOptional: false
+    },
+    createdBy: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    createdAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var ProjectUpdatedPayload = defineSchemaModel2({
+  name: "ProjectUpdatedPayload",
+  description: "Payload when a project is updated",
+  fields: {
+    projectId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    updatedFields: {
+      type: ScalarTypeEnum2.String_unsecure(),
+      isArray: true,
+      isOptional: false
+    },
+    updatedBy: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    updatedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var ProjectDeletedPayload = defineSchemaModel2({
+  name: "ProjectDeletedPayload",
+  description: "Payload when a project is deleted",
+  fields: {
+    projectId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum2.String_unsecure(),
+      isOptional: false
+    },
+    deletedBy: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    deletedAt: { type: ScalarTypeEnum2.DateTime(), isOptional: false }
+  }
+});
+var ProjectArchivedPayload = defineSchemaModel2({
+  name: "ProjectArchivedPayload",
+  description: "Payload when a project is archived",
+  fields: {
+    projectId: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    archivedBy: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
+    archivedAt: { type: ScalarTypeEnum2.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
+});
+
+// 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"])]
+});
+
+// src/project/project.presentation.ts
+import { definePresentation, StabilityEnum } from "@contractspec/lib.contracts";
+var ProjectListPresentation = definePresentation({
+  meta: {
+    key: "saas.project.list",
+    version: "1.0.0",
+    title: "Project List",
+    description: "List view of projects with status, tags, and last updated info",
+    domain: "saas-boilerplate",
+    owners: ["@saas-team"],
+    tags: ["project", "list", "dashboard"],
+    stability: StabilityEnum.Beta,
+    goal: "Browse and manage projects",
+    context: "Project list page"
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "ProjectListView",
+    props: ProjectModel
+  },
+  targets: ["react", "markdown", "application/json"],
+  policy: {
+    flags: ["saas.projects.enabled"]
+  }
+});
+var ProjectDetailPresentation = definePresentation({
+  meta: {
+    key: "saas.project.detail",
+    version: "1.0.0",
+    title: "Project Details",
+    description: "Detailed view of a project with settings and activity",
+    domain: "saas-boilerplate",
+    owners: ["@saas-team"],
+    tags: ["project", "detail"],
+    stability: StabilityEnum.Beta,
+    goal: "View and edit project details",
+    context: "Project detail page"
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "ProjectDetailView"
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["saas.projects.enabled"]
+  }
+});
+export {
+  mockUpdateProjectHandler,
+  mockListProjectsHandler,
+  mockGetProjectHandler,
+  mockDeleteProjectHandler,
+  mockCreateProjectHandler,
+  UpdateProjectInputModel,
+  UpdateProjectContract,
+  ProjectUpdatedEvent,
+  ProjectStatusSchemaEnum,
+  ProjectStatusFilterEnum,
+  ProjectStatusEnum,
+  ProjectModel,
+  ProjectMemberEntity,
+  ProjectListPresentation,
+  ProjectEntity,
+  ProjectDetailPresentation,
+  ProjectDeletedPayloadModel,
+  ProjectDeletedEvent,
+  ProjectCreatedEvent,
+  ProjectArchivedEvent,
+  ListProjectsOutputModel,
+  ListProjectsInputModel,
+  ListProjectsContract,
+  GetProjectInputModel,
+  GetProjectContract,
+  DeleteProjectOutputModel,
+  DeleteProjectInputModel,
+  DeleteProjectContract,
+  CreateProjectInputModel,
+  CreateProjectContract
+};