@ensera/plugin-backend 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -391,4 +391,17 @@ type CommandRegistry = {
 declare function createCommandRegistry(): CommandRegistry;
 declare function createCoreRouter(app: Express, registry: CommandRegistry): void;
 
-export { type BackendNotification, type CommandHandler, type CommandRegistry, type CoreRequestContext, type JsonObject, type JsonValue, type NotificationAction, type NotificationApiPayload, type NotificationBulkApiPayload, type NotificationBulkResponse, type NotificationCancelResponse, type NotificationCapabilities, type NotificationOptions, type NotificationPublishResponse, type NotificationPublisher, type NotificationPublisherConfig, type NotificationTypeConfig, type PluginAuthOptions, type PluginContext, PluginError, type PluginErrorResponse, type PluginScope, type RequestWithContext, type ScheduleOptions, assertPluginScope, buildDateTime, calculateScheduleTime, createCommandRegistry, createCoreRouter, createNotificationPublisher, forbidClientInstanceId, formatTime, getPluginScope, isPastDate, pluginAuth, pluginErrorHandler, requireFeature, requirePermission, requireTabView, requireTaskScope, resolveEffectiveInstanceId, toDateString, withCoreServiceToken, withInstanceOnly, withInstanceScope, withUserAndInstance };
+type CreateDbOptions = {
+    prismaDir?: string;
+    coreApiUrl?: string;
+    serviceToken?: string;
+    runMigrations?: boolean;
+};
+type DbProvisionResult = {
+    connectionString: string;
+    schemaName: string;
+    featureSlug: string;
+};
+declare function provisionDb(options?: CreateDbOptions): Promise<DbProvisionResult>;
+
+export { type BackendNotification, type CommandHandler, type CommandRegistry, type CoreRequestContext, type CreateDbOptions, type DbProvisionResult, type JsonObject, type JsonValue, type NotificationAction, type NotificationApiPayload, type NotificationBulkApiPayload, type NotificationBulkResponse, type NotificationCancelResponse, type NotificationCapabilities, type NotificationOptions, type NotificationPublishResponse, type NotificationPublisher, type NotificationPublisherConfig, type NotificationTypeConfig, type PluginAuthOptions, type PluginContext, PluginError, type PluginErrorResponse, type PluginScope, type RequestWithContext, type ScheduleOptions, assertPluginScope, buildDateTime, calculateScheduleTime, createCommandRegistry, createCoreRouter, createNotificationPublisher, forbidClientInstanceId, formatTime, getPluginScope, isPastDate, pluginAuth, pluginErrorHandler, provisionDb, requireFeature, requirePermission, requireTabView, requireTaskScope, resolveEffectiveInstanceId, toDateString, withCoreServiceToken, withInstanceOnly, withInstanceScope, withUserAndInstance };

package/dist/index.js

@@ -751,6 +751,108 @@ function createCoreRouter(app, registry) {
     })
   );
 }
+
+// src/createDb.ts
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function getString(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function parseProvisionResult(value) {
+  if (!isRecord(value)) {
+    throw new Error("provisionDb: Core returned an invalid response body");
+  }
+  const connectionString = getString(value.connectionString);
+  const schemaName = getString(value.schemaName);
+  const featureSlug = getString(value.featureSlug);
+  if (!connectionString) {
+    throw new Error("provisionDb: Core did not return a connectionString");
+  }
+  if (!schemaName) {
+    throw new Error("provisionDb: Core did not return a schemaName");
+  }
+  if (!featureSlug) {
+    throw new Error("provisionDb: Core did not return a featureSlug");
+  }
+  return {
+    connectionString,
+    schemaName,
+    featureSlug
+  };
+}
+async function provisionDb(options = {}) {
+  const coreApiUrl = (options.coreApiUrl ?? process.env.CORE_API_URL)?.replace(/\/+$/, "");
+  const serviceToken = options.serviceToken ?? process.env.CORE_SERVICE_TOKEN;
+  if (!coreApiUrl) {
+    throw new Error(
+      "provisionDb: CORE_API_URL is not set. Add it to your .env file."
+    );
+  }
+  if (!serviceToken) {
+    throw new Error(
+      "provisionDb: CORE_SERVICE_TOKEN is not set. Add it to your .env file."
+    );
+  }
+  const response = await fetch(`${coreApiUrl}/api/internal/db/provision`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${serviceToken}`
+    }
+  });
+  let payload = null;
+  try {
+    payload = await response.json();
+  } catch {
+    payload = null;
+  }
+  if (!response.ok) {
+    const errorMessage = isRecord(payload) ? getString(payload.error) : void 0;
+    throw new Error(
+      `provisionDb: Core returned ${response.status}. ${errorMessage ?? "Unknown error"}`
+    );
+  }
+  const result = parseProvisionResult(payload);
+  const shouldMigrate = options.runMigrations !== false;
+  if (shouldMigrate) {
+    const prismaDir = options.prismaDir ?? path.join(process.cwd(), "prisma");
+    const migrationsDir = path.join(prismaDir, "migrations");
+    if (fs.existsSync(prismaDir) && fs.existsSync(migrationsDir)) {
+      console.log(
+        `[ensera-db] Running migrations for schema: ${result.schemaName}`
+      );
+      try {
+        execSync("npx prisma migrate deploy", {
+          cwd: path.dirname(prismaDir),
+          stdio: "inherit",
+          env: {
+            ...process.env,
+            DATABASE_URL: result.connectionString
+          }
+        });
+        console.log("[ensera-db] Migrations complete");
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown migration error";
+        throw new Error(`[ensera-db] Migration failed: ${message}`);
+      }
+    } else if (fs.existsSync(prismaDir)) {
+      console.warn(
+        `[ensera-db] No prisma migrations found at ${migrationsDir}. Skipping migrations.`
+      );
+    } else {
+      console.warn(
+        `[ensera-db] No prisma directory found at ${prismaDir}. Skipping migrations.`
+      );
+    }
+  }
+  return result;
+}
 export {
   PluginError,
   assertPluginScope,
@@ -765,6 +867,7 @@ export {
   isPastDate,
   pluginAuth,
   pluginErrorHandler,
+  provisionDb,
   requireFeature,
   requirePermission,
   requireTabView,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ensera/plugin-backend",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Runtime backend SDK for Ensera plugins.",
   "type": "module",
   "main": "./dist/index.js",