@contractspec/example.saas-boilerplate 1.56.1 → 1.58.0

package/dist/handlers/index.js

@@ -1,5 +1,359 @@
-import { mockCheckFeatureAccessHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler } from "../billing/billing.handler.js";
-import { mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler } from "../project/project.handler.js";
-import { createSaasHandlers } from "./saas.handlers.js";
+// @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 }
+  ]
+};
 
-export { createSaasHandlers, mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler };
+// src/billing/billing.handler.ts
+async function mockGetSubscriptionHandler() {
+  return MOCK_SUBSCRIPTION;
+}
+async function mockGetUsageSummaryHandler(input) {
+  return {
+    ...MOCK_USAGE_SUMMARY,
+    period: input.period ?? "current_month"
+  };
+}
+async function mockRecordUsageHandler(input) {
+  const currentUsage = MOCK_USAGE_SUMMARY.apiCalls.total;
+  const newTotal = currentUsage + input.quantity;
+  return {
+    recorded: true,
+    newTotal
+  };
+}
+async function mockCheckFeatureAccessHandler(input) {
+  const { feature } = input;
+  const featureMap = {
+    custom_domains: {
+      allowed: true
+    },
+    api_access: {
+      allowed: true,
+      currentUsage: MOCK_USAGE_SUMMARY.apiCalls.total,
+      limit: MOCK_USAGE_SUMMARY.apiCalls.limit
+    },
+    advanced_analytics: {
+      allowed: false,
+      reason: "FEATURE_NOT_INCLUDED"
+    },
+    unlimited_projects: {
+      allowed: false,
+      reason: "PLAN_LIMIT",
+      currentUsage: MOCK_SUBSCRIPTION.usage.projects,
+      limit: MOCK_SUBSCRIPTION.limits.projects
+    }
+  };
+  return featureMap[feature] ?? { allowed: true };
+}
+
+// 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/handlers/saas.handlers.ts
+import { web } from "@contractspec/lib.runtime-sandbox";
+var { generateId } = web;
+function rowToProject(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    organizationId: row.organizationId,
+    name: row.name,
+    description: row.description ?? undefined,
+    status: row.status,
+    tier: row.tier,
+    createdAt: new Date(row.createdAt),
+    updatedAt: new Date(row.updatedAt)
+  };
+}
+function rowToSubscription(row) {
+  return {
+    id: row.id,
+    projectId: row.projectId,
+    organizationId: row.organizationId,
+    plan: row.plan,
+    status: row.status,
+    billingCycle: row.billingCycle,
+    currentPeriodStart: new Date(row.currentPeriodStart),
+    currentPeriodEnd: new Date(row.currentPeriodEnd),
+    cancelAtPeriodEnd: Boolean(row.cancelAtPeriodEnd)
+  };
+}
+function createSaasHandlers(db) {
+  async function listProjects(input) {
+    const {
+      projectId,
+      organizationId,
+      status,
+      search,
+      limit = 20,
+      offset = 0
+    } = input;
+    let whereClause = "WHERE projectId = ?";
+    const params = [projectId];
+    if (organizationId) {
+      whereClause += " AND organizationId = ?";
+      params.push(organizationId);
+    }
+    if (status && status !== "all") {
+      whereClause += " AND status = ?";
+      params.push(status);
+    }
+    if (search) {
+      whereClause += " AND (name LIKE ? OR description LIKE ?)";
+      params.push(`%${search}%`, `%${search}%`);
+    }
+    const countResult = (await db.query(`SELECT COUNT(*) as count FROM saas_project ${whereClause}`, params)).rows;
+    const total = countResult[0]?.count ?? 0;
+    const rows = (await db.query(`SELECT * FROM saas_project ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`, [...params, limit, offset])).rows;
+    return {
+      items: rows.map(rowToProject),
+      total,
+      hasMore: offset + rows.length < total
+    };
+  }
+  async function getProject(id) {
+    const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [id])).rows;
+    return rows[0] ? rowToProject(rows[0]) : null;
+  }
+  async function createProject(input, context) {
+    const id = generateId("proj");
+    const now = new Date().toISOString();
+    await db.execute(`INSERT INTO saas_project (id, projectId, organizationId, name, description, status, tier, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+      id,
+      context.projectId,
+      context.organizationId,
+      input.name,
+      input.description ?? null,
+      "DRAFT",
+      input.tier ?? "FREE",
+      now,
+      now
+    ]);
+    const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [id])).rows;
+    return rowToProject(rows[0]);
+  }
+  async function updateProject(input) {
+    const now = new Date().toISOString();
+    const updates = ["updatedAt = ?"];
+    const params = [now];
+    if (input.name !== undefined) {
+      updates.push("name = ?");
+      params.push(input.name);
+    }
+    if (input.description !== undefined) {
+      updates.push("description = ?");
+      params.push(input.description);
+    }
+    if (input.status !== undefined) {
+      updates.push("status = ?");
+      params.push(input.status);
+    }
+    params.push(input.id);
+    await db.execute(`UPDATE saas_project SET ${updates.join(", ")} WHERE id = ?`, params);
+    const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [input.id])).rows;
+    if (!rows[0]) {
+      throw new Error("NOT_FOUND");
+    }
+    return rowToProject(rows[0]);
+  }
+  async function deleteProject(id) {
+    await db.execute(`DELETE FROM saas_project WHERE id = ?`, [id]);
+  }
+  async function getSubscription(input) {
+    let query = `SELECT * FROM saas_subscription WHERE projectId = ?`;
+    const params = [input.projectId];
+    if (input.organizationId) {
+      query += " AND organizationId = ?";
+      params.push(input.organizationId);
+    }
+    query += " LIMIT 1";
+    const rows = (await db.query(query, params)).rows;
+    return rows[0] ? rowToSubscription(rows[0]) : null;
+  }
+  return {
+    listProjects,
+    getProject,
+    createProject,
+    updateProject,
+    deleteProject,
+    getSubscription
+  };
+}
+export {
+  mockUpdateProjectHandler,
+  mockRecordUsageHandler,
+  mockListProjectsHandler,
+  mockGetUsageSummaryHandler,
+  mockGetSubscriptionHandler,
+  mockGetProjectHandler,
+  mockDeleteProjectHandler,
+  mockCreateProjectHandler,
+  mockCheckFeatureAccessHandler,
+  createSaasHandlers
+};

package/dist/handlers/saas.handlers.d.ts

@@ -1,68 +1,68 @@
-import { DatabasePort } from "@contractspec/lib.runtime-sandbox";
-
-//#region src/handlers/saas.handlers.d.ts
-
-interface Project {
-  id: string;
-  projectId: string;
-  organizationId: string;
-  name: string;
-  description?: string;
-  status: 'DRAFT' | 'ACTIVE' | 'ARCHIVED';
-  tier: 'FREE' | 'PRO' | 'ENTERPRISE';
-  createdAt: Date;
-  updatedAt: Date;
+/**
+ * Runtime-local SaaS Boilerplate handlers
+ *
+ * Database-backed handlers for project and billing management.
+ */
+import type { DatabasePort } from '@contractspec/lib.runtime-sandbox';
+export interface Project {
+    id: string;
+    projectId: string;
+    organizationId: string;
+    name: string;
+    description?: string;
+    status: 'DRAFT' | 'ACTIVE' | 'ARCHIVED';
+    tier: 'FREE' | 'PRO' | 'ENTERPRISE';
+    createdAt: Date;
+    updatedAt: Date;
 }
-interface Subscription {
-  id: string;
-  projectId: string;
-  organizationId: string;
-  plan: 'FREE' | 'PRO' | 'ENTERPRISE';
-  status: 'ACTIVE' | 'PAST_DUE' | 'CANCELED';
-  billingCycle: 'MONTHLY' | 'YEARLY';
-  currentPeriodStart: Date;
-  currentPeriodEnd: Date;
-  cancelAtPeriodEnd: boolean;
+export interface Subscription {
+    id: string;
+    projectId: string;
+    organizationId: string;
+    plan: 'FREE' | 'PRO' | 'ENTERPRISE';
+    status: 'ACTIVE' | 'PAST_DUE' | 'CANCELED';
+    billingCycle: 'MONTHLY' | 'YEARLY';
+    currentPeriodStart: Date;
+    currentPeriodEnd: Date;
+    cancelAtPeriodEnd: boolean;
 }
-interface ListProjectsInput {
-  projectId: string;
-  organizationId?: string;
-  status?: Project['status'] | 'all';
-  search?: string;
-  limit?: number;
-  offset?: number;
+export interface ListProjectsInput {
+    projectId: string;
+    organizationId?: string;
+    status?: Project['status'] | 'all';
+    search?: string;
+    limit?: number;
+    offset?: number;
 }
-interface ListProjectsOutput {
-  items: Project[];
-  total: number;
-  hasMore: boolean;
+export interface ListProjectsOutput {
+    items: Project[];
+    total: number;
+    hasMore: boolean;
 }
-interface CreateProjectInput {
-  name: string;
-  description?: string;
-  tier?: Project['tier'];
+export interface CreateProjectInput {
+    name: string;
+    description?: string;
+    tier?: Project['tier'];
 }
-interface UpdateProjectInput {
-  id: string;
-  name?: string;
-  description?: string;
-  status?: Project['status'];
+export interface UpdateProjectInput {
+    id: string;
+    name?: string;
+    description?: string;
+    status?: Project['status'];
 }
-declare function createSaasHandlers(db: DatabasePort): {
-  listProjects: (input: ListProjectsInput) => Promise<ListProjectsOutput>;
-  getProject: (id: string) => Promise<Project | null>;
-  createProject: (input: CreateProjectInput, context: {
-    projectId: string;
-    organizationId: string;
-  }) => Promise<Project>;
-  updateProject: (input: UpdateProjectInput) => Promise<Project>;
-  deleteProject: (id: string) => Promise<void>;
-  getSubscription: (input: {
-    projectId: string;
-    organizationId?: string;
-  }) => Promise<Subscription | null>;
+export declare function createSaasHandlers(db: DatabasePort): {
+    listProjects: (input: ListProjectsInput) => Promise<ListProjectsOutput>;
+    getProject: (id: string) => Promise<Project | null>;
+    createProject: (input: CreateProjectInput, context: {
+        projectId: string;
+        organizationId: string;
+    }) => Promise<Project>;
+    updateProject: (input: UpdateProjectInput) => Promise<Project>;
+    deleteProject: (id: string) => Promise<void>;
+    getSubscription: (input: {
+        projectId: string;
+        organizationId?: string;
+    }) => Promise<Subscription | null>;
 };
-type SaasHandlers = ReturnType<typeof createSaasHandlers>;
-//#endregion
-export { CreateProjectInput, ListProjectsInput, ListProjectsOutput, Project, SaasHandlers, Subscription, UpdateProjectInput, createSaasHandlers };
+export type SaasHandlers = ReturnType<typeof createSaasHandlers>;
 //# sourceMappingURL=saas.handlers.d.ts.map

package/dist/handlers/saas.handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saas.handlers.d.ts","names":[],"sources":["../../src/handlers/saas.handlers.ts"],"sourcesContent":[],"mappings":";;;;AA6CiB,UAjCA,OAAA,CAiCkB;EAMlB,EAAA,EAAA,MAAA;EAMA,SAAA,EAAA,MAAA;EA+DD,cAAA,EAAA,MAAkB;EAAK,IAAA,EAAA,MAAA;EAK5B,WAAA,CAAA,EAAA,MAAA;EACE,MAAA,EAAA,OAAA,GAAA,QAAA,GAAA,UAAA;EAAR,IAAA,EAAA,MAAA,GAAA,KAAA,GAAA,YAAA;EAqD4C,SAAA,EA/JpC,IA+JoC;EAAR,SAAA,EA9J5B,IA8J4B;;AAa5B,UAxKI,YAAA,CAwKJ;EAAR,EAAA,EAAA,MAAA;EA8BiC,SAAA,EAAA,MAAA;EAA6B,cAAA,EAAA,MAAA;EAAR,IAAA,EAAA,MAAA,GAAA,KAAA,GAAA,YAAA;EAyCf,MAAA,EAAA,QAAA,GAAA,UAAA,GAAA,UAAA;EAU9B,YAAA,EAAA,SAAA,GAAA,QAAA;EAAR,kBAAA,EAlPgB,IAkPhB;EAAO,gBAAA,EAjPO,IAiPP;EA0BD,iBAAY,EAAA,OAAA;;UAvQP,iBAAA;;;WAGN;;;;;UAMM,kBAAA;SACR;;;;UAKQ,kBAAA;;;SAGR;;UAGQ,kBAAA;;;;WAIN;;iBA2DK,kBAAA,KAAuB;wBAK5B,sBACN,QAAQ;8BAqD4B,QAAQ;yBAWtC;;;QAEN,QAAQ;yBA8ByB,uBAAqB,QAAQ;iCAyCvB;;;;QAUtC,QAAQ;;KA0BF,YAAA,GAAe,kBAAkB"}
+{"version":3,"file":"saas.handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/saas.handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAOtE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IACpC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IACpC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IAC3C,YAAY,EAAE,SAAS,GAAG,QAAQ,CAAC;IACnC,kBAAkB,EAAE,IAAI,CAAC;IACzB,gBAAgB,EAAE,IAAI,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5B;AA0DD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY;0BAKxC,iBAAiB,KACvB,OAAO,CAAC,kBAAkB,CAAC;qBAqDA,MAAM,KAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;2BAWrD,kBAAkB,WAChB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,KACrD,OAAO,CAAC,OAAO,CAAC;2BA8BiB,kBAAkB,KAAG,OAAO,CAAC,OAAO,CAAC;wBAyCxC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;6BAOjB;QACpC,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,KAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;EAwBjC;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}