@jskit-ai/crud-server-generator 0.1.26

package/package.descriptor.mjs

@@ -0,0 +1,218 @@
+export default Object.freeze({
+  packageVersion: 1,
+  packageId: "@jskit-ai/crud-server-generator",
+  version: "0.1.26",
+  kind: "generator",
+  description: "CRUD server generator with routes, actions, and persistence scaffolding.",
+  options: {
+    namespace: {
+      required: true,
+      inputType: "text",
+      defaultValue: "",
+      promptLabel: "CRUD namespace",
+      promptHint: "Required slug (example: customers, appointments, vendors)."
+    },
+    surface: {
+      required: true,
+      inputType: "text",
+      defaultFromConfig: "surfaceDefaultId",
+      promptLabel: "Target surface",
+      promptHint: "Defaults to config.public.surfaceDefaultId. Must match an enabled surface id."
+    },
+    "ownership-filter": {
+      required: true,
+      inputType: "text",
+      defaultValue: "auto",
+      promptLabel: "Ownership filter",
+      promptHint: "auto | public | user | workspace | workspace_user"
+    },
+    "directory-prefix": {
+      required: false,
+      inputType: "text",
+      defaultValue: "",
+      promptLabel: "Route path prefix",
+      promptHint: "Optional subpath prepended to the CRUD route path (example: crm or ops/team-a)."
+    },
+    "table-name": {
+      required: true,
+      inputType: "text",
+      defaultValue: "",
+      promptLabel: "Table name",
+      promptHint: "Required existing MySQL table to introspect for CRUD schema generation."
+    },
+    "id-column": {
+      required: false,
+      inputType: "text",
+      defaultValue: "id",
+      promptLabel: "Id column",
+      promptHint: "Primary key column used by CRUD endpoints (default: id)."
+    }
+  },
+  optionPolicies: {
+    surfaceVisibility: {
+      visibilityOption: "ownership-filter"
+    }
+  },
+  dependsOn: [
+    "@jskit-ai/auth-core",
+    "@jskit-ai/crud-core",
+    "@jskit-ai/database-runtime",
+    "@jskit-ai/http-runtime",
+    "@jskit-ai/realtime",
+    "@jskit-ai/users-core"
+  ],
+  capabilities: {
+    provides: ["crud"],
+    requires: [
+      "runtime.actions",
+      "runtime.database",
+      "auth.policy",
+      "users.core"
+    ]
+  },
+  runtime: {
+    server: {
+      providers: [
+        {
+          entrypoint: "src/server/CrudServiceProvider.js",
+          export: "CrudServiceProvider"
+        }
+      ]
+    }
+  },
+  metadata: {
+    apiSummary: {
+      surfaces: [
+        {
+          subpath: "./server",
+          summary: "Scaffold package runtime provider (no-op) plus reference CRUD server modules."
+        },
+        {
+          subpath: "./shared",
+          summary: "Exports shared CRUD resource and module config helpers."
+        }
+      ],
+      containerTokens: {
+        server: []
+      }
+    }
+  },
+  mutations: {
+    dependencies: {
+      runtime: {
+        "@jskit-ai/auth-core": "0.1.17",
+        "@jskit-ai/crud-core": "0.1.26",
+        "@jskit-ai/database-runtime": "0.1.18",
+        "@jskit-ai/http-runtime": "0.1.17",
+        "@jskit-ai/kernel": "0.1.18",
+        "@jskit-ai/realtime": "0.1.17",
+        "@jskit-ai/users-core": "0.1.27",
+        "@local/${option:namespace|kebab}": "file:packages/${option:namespace|kebab}",
+        "typebox": "^1.0.81"
+      },
+      dev: {}
+    },
+    packageJson: {
+      scripts: {}
+    },
+    procfile: {},
+    files: [
+      {
+        op: "install-migration",
+        from: "templates/migrations/crud_initial.cjs",
+        toDir: "migrations",
+        extension: ".cjs",
+        reason: "Install CRUD schema migration.",
+        category: "crud",
+        id: "crud-initial-schema-${option:namespace|snake}",
+        templateContext: {
+          entrypoint: "src/server/buildTemplateContext.js",
+          export: "buildTemplateContext"
+        }
+      },
+      {
+        from: "templates/src/local-package/package.json",
+        to: "packages/${option:namespace|kebab}/package.json",
+        reason: "Install app-local CRUD package manifest.",
+        category: "crud",
+        id: "crud-local-package-json-${option:namespace|snake}"
+      },
+      {
+        from: "templates/src/local-package/package.descriptor.mjs",
+        to: "packages/${option:namespace|kebab}/package.descriptor.mjs",
+        reason: "Install app-local CRUD package descriptor.",
+        category: "crud",
+        id: "crud-local-package-descriptor-${option:namespace|snake}"
+      },
+      {
+        from: "templates/src/local-package/server/CrudServiceProvider.js",
+        to: "packages/${option:namespace|kebab}/src/server/${option:namespace|pascal}ServiceProvider.js",
+        reason: "Install app-local CRUD server provider.",
+        category: "crud",
+        id: "crud-local-package-server-provider-${option:namespace|snake}",
+        templateContext: {
+          entrypoint: "src/server/buildTemplateContext.js",
+          export: "buildTemplateContext"
+        }
+      },
+      {
+        from: "templates/src/local-package/server/actions.js",
+        to: "packages/${option:namespace|kebab}/src/server/actions.js",
+        reason: "Install app-local CRUD action definitions.",
+        category: "crud",
+        id: "crud-local-package-server-actions-${option:namespace|snake}"
+      },
+      {
+        from: "templates/src/local-package/server/actionIds.js",
+        to: "packages/${option:namespace|kebab}/src/server/actionIds.js",
+        reason: "Install app-local CRUD action IDs.",
+        category: "crud",
+        id: "crud-local-package-server-action-ids-${option:namespace|snake}"
+      },
+      {
+        from: "templates/src/local-package/server/registerRoutes.js",
+        to: "packages/${option:namespace|kebab}/src/server/registerRoutes.js",
+        reason: "Install app-local CRUD route registration.",
+        category: "crud",
+        id: "crud-local-package-server-routes-${option:namespace|snake}"
+      },
+      {
+        from: "templates/src/local-package/server/repository.js",
+        to: "packages/${option:namespace|kebab}/src/server/repository.js",
+        reason: "Install app-local CRUD repository.",
+        category: "crud",
+        id: "crud-local-package-server-repository-${option:namespace|snake}",
+        templateContext: {
+          entrypoint: "src/server/buildTemplateContext.js",
+          export: "buildTemplateContext"
+        }
+      },
+      {
+        from: "templates/src/local-package/server/service.js",
+        to: "packages/${option:namespace|kebab}/src/server/service.js",
+        reason: "Install app-local CRUD service.",
+        category: "crud",
+        id: "crud-local-package-server-service-${option:namespace|snake}"
+      },
+      {
+        from: "templates/src/local-package/shared/index.js",
+        to: "packages/${option:namespace|kebab}/src/shared/index.js",
+        reason: "Install app-local CRUD shared exports.",
+        category: "crud",
+        id: "crud-local-package-shared-index-${option:namespace|snake}"
+      },
+      {
+        from: "templates/src/local-package/shared/crudResource.js",
+        to: "packages/${option:namespace|kebab}/src/shared/${option:namespace|singular|camel}Resource.js",
+        reason: "Install app-local CRUD resource.",
+        category: "crud",
+        id: "crud-local-package-shared-resource-${option:namespace|snake}",
+        templateContext: {
+          entrypoint: "src/server/buildTemplateContext.js",
+          export: "buildTemplateContext"
+        }
+      }
+    ],
+    text: []
+  }
+});

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@jskit-ai/crud-server-generator",
+  "version": "0.1.26",
+  "type": "module",
+  "scripts": {
+    "test": "node --test"
+  },
+  "exports": {
+    "./server/CrudServiceProvider": "./src/server/CrudServiceProvider.js",
+    "./server/crudModuleConfig": "./src/server/crudModuleConfig.js",
+    "./shared": "./src/shared/index.js",
+    "./shared/crud/crudResource": "./src/shared/crud/crudResource.js"
+  },
+  "dependencies": {
+    "@jskit-ai/crud-core": "0.1.26",
+    "@jskit-ai/database-runtime": "0.1.18",
+    "@jskit-ai/http-runtime": "0.1.17",
+    "@jskit-ai/kernel": "0.1.18",
+    "@jskit-ai/users-core": "0.1.27",
+    "typebox": "^1.0.81"
+  }
+}

package/src/server/CrudServiceProvider.js

@@ -0,0 +1,11 @@
+class CrudServiceProvider {
+  static id = "crud";
+
+  static dependsOn = [];
+
+  register() {}
+
+  boot() {}
+}
+
+export { CrudServiceProvider };

package/src/server/actionIds.js

@@ -0,0 +1,22 @@
+function requireActionIdPrefix(actionIdPrefix) {
+  const prefix = String(actionIdPrefix || "").trim();
+  if (!prefix) {
+    throw new TypeError("createActionIds requires actionIdPrefix.");
+  }
+
+  return prefix;
+}
+
+function createActionIds(actionIdPrefix) {
+  const prefix = requireActionIdPrefix(actionIdPrefix);
+
+  return Object.freeze({
+    list: `${prefix}.list`,
+    view: `${prefix}.view`,
+    create: `${prefix}.create`,
+    update: `${prefix}.update`,
+    delete: `${prefix}.delete`
+  });
+}
+
+export { requireActionIdPrefix, createActionIds };

package/src/server/actions.js

@@ -0,0 +1,152 @@
+import {
+  cursorPaginationQueryValidator,
+  recordIdParamsValidator
+} from "@jskit-ai/kernel/shared/validators";
+import { workspaceSlugParamsValidator } from "@jskit-ai/users-core/server/validators/routeParamsValidator";
+import { crudResource } from "../shared/crud/crudResource.js";
+import { createActionIds } from "./actionIds.js";
+
+function requireActionSurface(surface = "") {
+  const normalizedSurface = String(surface || "").trim().toLowerCase();
+  if (!normalizedSurface) {
+    throw new TypeError("createActions requires a non-empty surface.");
+  }
+
+  return normalizedSurface;
+}
+
+function createActions({ actionIdPrefix, surface = "" } = {}) {
+  const actionIds = createActionIds(actionIdPrefix);
+  const actionSurface = requireActionSurface(surface);
+
+  return Object.freeze([
+    {
+      id: actionIds.list,
+      version: 1,
+      kind: "query",
+      channels: ["api", "automation", "internal"],
+      surfaces: [actionSurface],
+      permission: {
+        require: "authenticated"
+      },
+      inputValidator: [workspaceSlugParamsValidator, cursorPaginationQueryValidator],
+      outputValidator: crudResource.operations.list.outputValidator,
+      idempotency: "none",
+      audit: {
+        actionName: actionIds.list
+      },
+      observability: {},
+      async execute(input, context, deps) {
+        return deps.crudService.listRecords(input, {
+          context,
+          visibilityContext: context?.visibilityContext
+        });
+      }
+    },
+    {
+      id: actionIds.view,
+      version: 1,
+      kind: "query",
+      channels: ["api", "automation", "internal"],
+      surfaces: [actionSurface],
+      permission: {
+        require: "authenticated"
+      },
+      inputValidator: [workspaceSlugParamsValidator, recordIdParamsValidator],
+      outputValidator: crudResource.operations.view.outputValidator,
+      idempotency: "none",
+      audit: {
+        actionName: actionIds.view
+      },
+      observability: {},
+      async execute(input, context, deps) {
+        return deps.crudService.getRecord(input.recordId, {
+          context,
+          visibilityContext: context?.visibilityContext
+        });
+      }
+    },
+    {
+      id: actionIds.create,
+      version: 1,
+      kind: "command",
+      channels: ["api", "automation", "internal"],
+      surfaces: [actionSurface],
+      permission: {
+        require: "authenticated"
+      },
+      inputValidator: [
+        workspaceSlugParamsValidator,
+        {
+          payload: crudResource.operations.create.bodyValidator
+        }
+      ],
+      outputValidator: crudResource.operations.create.outputValidator,
+      idempotency: "optional",
+      audit: {
+        actionName: actionIds.create
+      },
+      observability: {},
+      async execute(input, context, deps) {
+        return deps.crudService.createRecord(input.payload, {
+          context,
+          visibilityContext: context?.visibilityContext
+        });
+      }
+    },
+    {
+      id: actionIds.update,
+      version: 1,
+      kind: "command",
+      channels: ["api", "automation", "internal"],
+      surfaces: [actionSurface],
+      permission: {
+        require: "authenticated"
+      },
+      inputValidator: [
+        workspaceSlugParamsValidator,
+        recordIdParamsValidator,
+        {
+          patch: crudResource.operations.patch.bodyValidator
+        }
+      ],
+      outputValidator: crudResource.operations.patch.outputValidator,
+      idempotency: "optional",
+      audit: {
+        actionName: actionIds.update
+      },
+      observability: {},
+      async execute(input, context, deps) {
+        return deps.crudService.updateRecord(input.recordId, input.patch, {
+          context,
+          visibilityContext: context?.visibilityContext
+        });
+      }
+    },
+    {
+      id: actionIds.delete,
+      version: 1,
+      kind: "command",
+      channels: ["api", "automation", "internal"],
+      surfaces: [actionSurface],
+      permission: {
+        require: "authenticated"
+      },
+      inputValidator: [workspaceSlugParamsValidator, recordIdParamsValidator],
+      outputValidator: crudResource.operations.delete.outputValidator,
+      idempotency: "optional",
+      audit: {
+        actionName: actionIds.delete
+      },
+      observability: {},
+      async execute(input, context, deps) {
+        return deps.crudService.deleteRecord(input.recordId, {
+          context,
+          visibilityContext: context?.visibilityContext
+        });
+      }
+    }
+  ]);
+}
+
+export { createActions };