@jskit-ai/crud-server-generator 0.1.29 → 0.1.31

package/package.descriptor.mjs

@@ -1,7 +1,7 @@
 export default Object.freeze({
   packageVersion: 1,
   packageId: "@jskit-ai/crud-server-generator",
-  version: "0.1.29",
+  version: "0.1.31",
   kind: "generator",
   description: "CRUD server generator with routes, actions, and persistence scaffolding.",
   options: {
@@ -80,10 +80,39 @@ export default Object.freeze({
     }
   },
   metadata: {
+    generatorPrimarySubcommand: "scaffold",
     generatorSubcommands: {
-      "add-field": {
+      "scaffold": {
+        description: "Scaffold a CRUD resource package for a table (same behavior as running generate with no subcommand).",
+        optionNames: [
+          "namespace",
+          "surface",
+          "ownership-filter",
+          "table-name",
+          "id-column",
+          "directory-prefix"
+        ]
+      },
+      "scaffold-field": {
         entrypoint: "src/server/subcommands/addField.js",
-        export: "runGeneratorSubcommand"
+        export: "runGeneratorSubcommand",
+        description: "Patch one writable field into an existing generated CRUD resource module.",
+        positionalArgs: [
+          {
+            name: "<fieldKey>",
+            required: true,
+            description: "Resource field key (camelCase) resolved from the DB snapshot."
+          },
+          {
+            name: "<targetFile>",
+            required: true,
+            description: "Path to the generated CRUD resource file relative to app root."
+          }
+        ],
+        optionNames: [
+          "table-name",
+          "id-column"
+        ]
       }
     },
     apiSummary: {
@@ -105,13 +134,13 @@ export default Object.freeze({
   mutations: {
     dependencies: {
       runtime: {
-        "@jskit-ai/auth-core": "0.1.20",
-        "@jskit-ai/crud-core": "0.1.29",
-        "@jskit-ai/database-runtime": "0.1.21",
-        "@jskit-ai/http-runtime": "0.1.20",
-        "@jskit-ai/kernel": "0.1.21",
-        "@jskit-ai/realtime": "0.1.20",
-        "@jskit-ai/users-core": "0.1.30",
+        "@jskit-ai/auth-core": "0.1.22",
+        "@jskit-ai/crud-core": "0.1.31",
+        "@jskit-ai/database-runtime": "0.1.23",
+        "@jskit-ai/http-runtime": "0.1.22",
+        "@jskit-ai/kernel": "0.1.23",
+        "@jskit-ai/realtime": "0.1.22",
+        "@jskit-ai/users-core": "0.1.32",
         "@local/${option:namespace|kebab}": "file:packages/${option:namespace|kebab}",
         "typebox": "^1.0.81"
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jskit-ai/crud-server-generator",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "type": "module",
   "scripts": {
     "test": "node --test"
@@ -13,11 +13,11 @@
   },
   "dependencies": {
     "@babel/parser": "^7.29.2",
-    "@jskit-ai/crud-core": "0.1.29",
-    "@jskit-ai/database-runtime": "0.1.21",
-    "@jskit-ai/http-runtime": "0.1.20",
-    "@jskit-ai/kernel": "0.1.21",
-    "@jskit-ai/users-core": "0.1.30",
+    "@jskit-ai/crud-core": "0.1.31",
+    "@jskit-ai/database-runtime": "0.1.23",
+    "@jskit-ai/http-runtime": "0.1.22",
+    "@jskit-ai/kernel": "0.1.23",
+    "@jskit-ai/users-core": "0.1.32",
     "recast": "^0.23.11",
     "typebox": "^1.0.81"
   }

package/src/server/buildTemplateContext.js

@@ -751,32 +751,34 @@ function renderMigrationForeignKeyLines(snapshot) {
   return lines.join("\n");
 }
 
-function mergeFieldMetaEntries(baseEntries = [], patchEntries = []) {
+function mergeFieldMetaEntries(...entryGroups) {
   const mergedByKey = new Map();
-  for (const sourceEntry of [...baseEntries, ...patchEntries]) {
-    const key = normalizeText(sourceEntry?.key);
-    if (!key) {
-      continue;
-    }
-    const existing = mergedByKey.get(key) || {};
-    const next = {
-      ...existing,
-      ...sourceEntry,
-      key
-    };
-    if (existing.relation || sourceEntry.relation) {
-      next.relation = {
-        ...(existing.relation && typeof existing.relation === "object" ? existing.relation : {}),
-        ...(sourceEntry.relation && typeof sourceEntry.relation === "object" ? sourceEntry.relation : {})
-      };
-    }
-    if (existing.ui || sourceEntry.ui) {
-      next.ui = {
-        ...(existing.ui && typeof existing.ui === "object" ? existing.ui : {}),
-        ...(sourceEntry.ui && typeof sourceEntry.ui === "object" ? sourceEntry.ui : {})
+  for (const sourceEntries of entryGroups) {
+    for (const sourceEntry of Array.isArray(sourceEntries) ? sourceEntries : []) {
+      const key = normalizeText(sourceEntry?.key);
+      if (!key) {
+        continue;
+      }
+      const existing = mergedByKey.get(key) || {};
+      const next = {
+        ...existing,
+        ...sourceEntry,
+        key
       };
+      if (existing.relation || sourceEntry.relation) {
+        next.relation = {
+          ...(existing.relation && typeof existing.relation === "object" ? existing.relation : {}),
+          ...(sourceEntry.relation && typeof sourceEntry.relation === "object" ? sourceEntry.relation : {})
+        };
+      }
+      if (existing.ui || sourceEntry.ui) {
+        next.ui = {
+          ...(existing.ui && typeof existing.ui === "object" ? existing.ui : {}),
+          ...(sourceEntry.ui && typeof sourceEntry.ui === "object" ? sourceEntry.ui : {})
+        };
+      }
+      mergedByKey.set(key, next);
     }
-    mergedByKey.set(key, next);
   }
 
   return [...mergedByKey.values()].sort((left, right) => left.key.localeCompare(right.key));
@@ -791,6 +793,87 @@ function resolveLookupNamespaceFromTableName(tableName = "") {
   return normalizedTableName.replace(/_/g, "-");
 }
 
+function toFieldLabel(key = "") {
+  const normalizedKey = normalizeText(key);
+  if (!normalizedKey) {
+    return "";
+  }
+
+  const words = normalizedKey
+    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+    .replace(/[_\-.]+/g, " ")
+    .split(/\s+/)
+    .map((entry) => normalizeText(entry))
+    .filter(Boolean);
+  if (words.length < 1) {
+    return "";
+  }
+
+  return words
+    .map((entry) => `${entry.slice(0, 1).toUpperCase()}${entry.slice(1)}`)
+    .join(" ");
+}
+
+function isSupportedSelectOptionValue(value) {
+  return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+
+function toSelectOptionIdentity(value) {
+  return `${typeof value}:${String(value)}`;
+}
+
+function toSelectOptionLabel(value) {
+  if (typeof value === "string") {
+    return toFieldLabel(value) || value;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  return "";
+}
+
+function normalizeFieldMetaUiOptions(rawOptions = []) {
+  if (!Array.isArray(rawOptions)) {
+    return [];
+  }
+
+  const options = [];
+  const seenValues = new Set();
+  for (const rawEntry of rawOptions) {
+    if (!rawEntry || typeof rawEntry !== "object" || Array.isArray(rawEntry)) {
+      continue;
+    }
+    const value = rawEntry.value;
+    if (!isSupportedSelectOptionValue(value)) {
+      continue;
+    }
+
+    const identity = toSelectOptionIdentity(value);
+    if (seenValues.has(identity)) {
+      continue;
+    }
+    seenValues.add(identity);
+
+    const explicitLabel = normalizeText(rawEntry.label);
+    options.push({
+      value,
+      label: explicitLabel || toSelectOptionLabel(value) || String(value)
+    });
+  }
+
+  return options;
+}
+
+function resolveEnumFieldMetaUiOptions(enumValues = []) {
+  const options = Array.isArray(enumValues)
+    ? enumValues.map((value) => ({
+        value,
+        label: toSelectOptionLabel(value)
+      }))
+    : [];
+  return normalizeFieldMetaUiOptions(options);
+}
+
 function buildFieldMetaEntries({ outputColumns = [], writableColumns = [], snapshot = {} } = {}) {
   const fieldColumns = [...outputColumns, ...writableColumns];
   const fieldColumnsByName = new Map();
@@ -858,7 +941,33 @@ function buildFieldMetaEntries({ outputColumns = [], writableColumns = [], snaps
     });
   }
 
-  return mergeFieldMetaEntries(dbColumnEntries, relationEntries);
+  const relationFieldKeys = new Set(
+    relationEntries
+      .map((entry) => normalizeText(entry?.key))
+      .filter(Boolean)
+  );
+  const enumEntries = [];
+  for (const column of fieldColumnsByKey.values()) {
+    const key = normalizeText(column?.key);
+    if (!key || relationFieldKeys.has(key)) {
+      continue;
+    }
+
+    const options = resolveEnumFieldMetaUiOptions(column?.enumValues);
+    if (options.length < 1) {
+      continue;
+    }
+
+    enumEntries.push({
+      key,
+      ui: {
+        formControl: "select",
+        options
+      }
+    });
+  }
+
+  return mergeFieldMetaEntries(dbColumnEntries, relationEntries, enumEntries);
 }
 
 function renderFieldMetaEntryLines(entry = {}) {
@@ -896,17 +1005,39 @@ function renderFieldMetaEntryLines(entry = {}) {
     topLevelProperties.push(relationLines.join("\n"));
   }
 
+  const fieldUiOptions = normalizeFieldMetaUiOptions(entry?.ui?.options);
   const formControl = checkCrudLookupFormControl(entry?.ui?.formControl, {
     context: `resource.fieldMeta["${normalizeText(entry.key)}"].ui.formControl`,
-    defaultValue: relation ? "autocomplete" : ""
+    defaultValue: relation ? "autocomplete" : (fieldUiOptions.length > 0 ? "select" : "")
   });
-  if (formControl) {
+  if (formControl || fieldUiOptions.length > 0) {
+    const uiPropertyBlocks = [];
+    if (formControl) {
+      uiPropertyBlocks.push([
+        `formControl: ${JSON.stringify(formControl)}${relation ? " // or \"select\"" : ""}`
+      ]);
+    }
+    if (fieldUiOptions.length > 0) {
+      const optionsJsonLines = JSON.stringify(fieldUiOptions, null, 2).split("\n");
+      const optionPropertyLines = [`options: ${optionsJsonLines[0]}`];
+      for (const jsonLine of optionsJsonLines.slice(1)) {
+        optionPropertyLines.push(jsonLine);
+      }
+      uiPropertyBlocks.push(optionPropertyLines);
+    }
+
+    const uiLines = ["ui: {"];
+    for (const [propertyIndex, propertyLines] of uiPropertyBlocks.entries()) {
+      const isLastProperty = propertyIndex >= uiPropertyBlocks.length - 1;
+      const propertySuffix = isLastProperty ? "" : ",";
+      for (const [lineIndex, line] of propertyLines.entries()) {
+        const isLastLine = lineIndex >= propertyLines.length - 1;
+        uiLines.push(`  ${line}${isLastLine ? propertySuffix : ""}`);
+      }
+    }
+    uiLines.push("}");
     topLevelProperties.push(
-      [
-        "ui: {",
-        `  formControl: ${JSON.stringify(formControl)} // or "select"`,
-        "}"
-      ].join("\n")
+      uiLines.join("\n")
     );
   }
 

package/src/server/subcommands/addField.js

@@ -35,12 +35,12 @@ function toPosixPath(value = "") {
 function resolveTargetFilePath(appRoot, targetFile) {
   const appRootAbsolute = path.resolve(String(appRoot || ""));
   if (!appRootAbsolute) {
-    throw new Error("crud-server-generator add-field requires appRoot.");
+    throw new Error("crud-server-generator scaffold-field requires appRoot.");
   }
 
   const normalizedTargetFile = normalizeText(targetFile);
   if (!normalizedTargetFile) {
-    throw new Error("crud-server-generator add-field requires target file path.");
+    throw new Error("crud-server-generator scaffold-field requires target file path.");
   }
 
   const absolutePath = path.isAbsolute(normalizedTargetFile)
@@ -53,7 +53,7 @@ function resolveTargetFilePath(appRoot, targetFile) {
     relativePath.startsWith(`..${path.sep}`) ||
     path.isAbsolute(relativePath)
   ) {
-    throw new Error("crud-server-generator add-field target file must stay within app root.");
+    throw new Error("crud-server-generator scaffold-field target file must stay within app root.");
   }
 
   return {
@@ -68,10 +68,10 @@ function parseSubcommandArgs(args = []) {
   const targetFile = normalizeText(source[1]);
 
   if (!fieldKey) {
-    throw new Error("crud-server-generator add-field requires <fieldKey>.");
+    throw new Error("crud-server-generator scaffold-field requires <fieldKey>.");
   }
   if (!targetFile) {
-    throw new Error("crud-server-generator add-field requires <targetFile>.");
+    throw new Error("crud-server-generator scaffold-field requires <targetFile>.");
   }
 
   return {
@@ -80,7 +80,7 @@ function parseSubcommandArgs(args = []) {
   };
 }
 
-function resolveRequestedTableConfig(source = "", options = {}, context = "crud-server-generator add-field") {
+function resolveRequestedTableConfig(source = "", options = {}, context = "crud-server-generator scaffold-field") {
   const defaults = resolveCrudResourceDefaults(source, context);
   const tableName = normalizeText(options?.["table-name"] || defaults.tableName);
   if (!tableName) {
@@ -110,7 +110,7 @@ function resolveColumnForField(snapshot = {}, fieldKey = "", { idColumn = "id" }
     .filter(Boolean)
     .join(", ");
   throw new Error(
-    `crud-server-generator add-field could not find field "${key}" in DB snapshot columns. Available: ${available || "<none>"}.`
+    `crud-server-generator scaffold-field could not find field "${key}" in DB snapshot columns. Available: ${available || "<none>"}.`
   );
 }
 
@@ -178,7 +178,7 @@ async function runGeneratorSubcommand({
   resolveSnapshot = resolveGenerationSnapshot
 } = {}) {
   const normalizedSubcommand = normalizeText(subcommand).toLowerCase();
-  if (normalizedSubcommand !== "add-field") {
+  if (normalizedSubcommand !== "scaffold-field") {
     throw new Error(`Unsupported crud-server-generator subcommand: ${normalizedSubcommand || "<empty>"}.`);
   }
 
@@ -197,7 +197,7 @@ async function runGeneratorSubcommand({
   const column = resolveColumnForField(snapshot, fieldKey, { idColumn });
   if (column?.writable !== true) {
     throw new Error(
-      `crud-server-generator add-field cannot patch non-writable field "${fieldKey}" (column "${column.name}").`
+      `crud-server-generator scaffold-field cannot patch non-writable field "${fieldKey}" (column "${column.name}").`
     );
   }
 

package/src/server/subcommands/resourceAst.js

@@ -37,7 +37,7 @@ function isIdentifierName(value = "") {
   return IDENTIFIER_PATTERN.test(String(value || ""));
 }
 
-function parseModule(source = "", context = "crud-server-generator add-field") {
+function parseModule(source = "", context = "crud-server-generator scaffold-field") {
   try {
     return recast.parse(String(source || ""), { parser: BABEL_REC_AST_PARSER });
   } catch (error) {
@@ -47,7 +47,7 @@ function parseModule(source = "", context = "crud-server-generator add-field") {
   }
 }
 
-function parseExpression(source = "", context = "crud-server-generator add-field") {
+function parseExpression(source = "", context = "crud-server-generator scaffold-field") {
   const expressionSource = `const __jskitFieldExpression = ${String(source || "")};`;
   const ast = parseModule(expressionSource, context);
   const statement = ast?.program?.body?.[0];
@@ -61,7 +61,7 @@ function parseExpression(source = "", context = "crud-server-generator add-field
   return declaration.init;
 }
 
-function parseStatement(source = "", context = "crud-server-generator add-field") {
+function parseStatement(source = "", context = "crud-server-generator scaffold-field") {
   const ast = parseModule(String(source || ""), context);
   const statement = ast?.program?.body?.[0];
   if (!statement) {
@@ -114,7 +114,7 @@ function findVariableDeclarator(programNode, variableName = "") {
   return null;
 }
 
-function requireVariableDeclarator(programNode, variableName = "", context = "crud-server-generator add-field") {
+function requireVariableDeclarator(programNode, variableName = "", context = "crud-server-generator scaffold-field") {
   const declaration = findVariableDeclarator(programNode, variableName);
   if (declaration) {
     return declaration;
@@ -122,7 +122,7 @@ function requireVariableDeclarator(programNode, variableName = "", context = "cr
   throw new Error(`${context} could not find const ${variableName}.`);
 }
 
-function requireSchemaPropertiesObject(programNode, variableName = "", context = "crud-server-generator add-field") {
+function requireSchemaPropertiesObject(programNode, variableName = "", context = "crud-server-generator scaffold-field") {
   const declaration = requireVariableDeclarator(programNode, variableName, context);
   const initExpression = declaration.init;
   if (!n.CallExpression.check(initExpression)) {
@@ -149,7 +149,7 @@ function requireSchemaPropertiesObject(programNode, variableName = "", context =
   return firstArgument;
 }
 
-function requireObjectFreezePayloadObject(programNode, variableName = "", context = "crud-server-generator add-field") {
+function requireObjectFreezePayloadObject(programNode, variableName = "", context = "crud-server-generator scaffold-field") {
   const declaration = requireVariableDeclarator(programNode, variableName, context);
   const initExpression = declaration.init;
   if (!n.CallExpression.check(initExpression)) {
@@ -197,7 +197,7 @@ function findObjectPropertyByName(objectNode, propertyName = "") {
   return null;
 }
 
-function requireNormalizeFunctionBody(programNode, variableName = "", context = "crud-server-generator add-field") {
+function requireNormalizeFunctionBody(programNode, variableName = "", context = "crud-server-generator scaffold-field") {
   const validatorObject = requireObjectFreezePayloadObject(programNode, variableName, context);
   const normalizeProperty = findObjectPropertyByName(validatorObject, "normalize");
   if (!normalizeProperty) {
@@ -218,7 +218,7 @@ function requireNormalizeFunctionBody(programNode, variableName = "", context =
   throw new Error(`${context} expected ${variableName}.normalize to be a function with a block body.`);
 }
 
-function requireNormalizedObjectLiteral(functionBody, context = "crud-server-generator add-field") {
+function requireNormalizedObjectLiteral(functionBody, context = "crud-server-generator scaffold-field") {
   for (const statement of functionBody.body || []) {
     if (!n.VariableDeclaration.check(statement)) {
       continue;
@@ -248,7 +248,7 @@ function insertObjectProperty(
   propertyName = "",
   valueExpressionSource = "",
   {
-    context = "crud-server-generator add-field",
+    context = "crud-server-generator scaffold-field",
     insertBeforeComputed = false
   } = {}
 ) {
@@ -448,7 +448,7 @@ function resolveObjectPropertyStringValue(objectNode, propertyName = "") {
   return "";
 }
 
-function resolveCrudResourceDefaults(source = "", context = "crud-server-generator add-field") {
+function resolveCrudResourceDefaults(source = "", context = "crud-server-generator scaffold-field") {
   const ast = parseModule(source, context);
   const statements = Array.isArray(ast?.program?.body) ? ast.program.body : [];
 
@@ -478,7 +478,7 @@ function resolveCrudResourceDefaults(source = "", context = "crud-server-generat
 function renderResourceFieldMetaPushStatement(entry = {}) {
   const key = normalizeText(entry?.key);
   if (!key) {
-    throw new Error("crud-server-generator add-field fieldMeta entry requires key.");
+    throw new Error("crud-server-generator scaffold-field fieldMeta entry requires key.");
   }
 
   const lines = ["RESOURCE_FIELD_META.push({"];
@@ -495,7 +495,7 @@ function renderResourceFieldMetaPushStatement(entry = {}) {
       normalizeCrudLookupNamespace(relation.namespace) ||
       normalizeCrudLookupNamespace(relation.apiPath);
     if (!relationNamespace) {
-      throw new Error("crud-server-generator add-field fieldMeta relation requires namespace.");
+      throw new Error("crud-server-generator scaffold-field fieldMeta relation requires namespace.");
     }
     lines.push("  relation: {");
     lines.push(`    kind: ${JSON.stringify(normalizeText(relation.kind) || "lookup")},`);
@@ -530,7 +530,7 @@ function applyCrudResourceFieldPatch(
     normalizeImportNames = [],
     databaseRuntimeImportNames = [],
     databaseRuntimeRepositoryOptionsImportNames = [],
-    context = "crud-server-generator add-field"
+    context = "crud-server-generator scaffold-field"
   } = {}
 ) {
   const normalizedFieldKey = normalizeText(fieldKey);

package/src/shared/crud/crudResource.js

@@ -183,4 +183,21 @@ const crudResource = {
 
 void CRUD_RESOURCE_FIELD_META;
 
+// Example 1:n collection hydration:
+// CRUD_RESOURCE_FIELD_META.push({
+//   key: "pets",
+//   relation: {
+//     kind: "collection",
+//     namespace: "pets",
+//     foreignKey: "customerId",
+//     parentValueKey: "id",
+//     hydrateOnList: false, // list: opt-in with include=pets
+//     hydrateOnView: true // view: hydrated by default
+//   }
+// });
+//
+// To hydrate child lookups too, request nested include paths:
+// - include=pets
+// - include=pets,pets.breedId
+
 export { crudResource };

package/templates/src/local-package/server/CrudProvider.js

@@ -45,7 +45,9 @@ class ${option:namespace|pascal}Provider {
     });
 
     app.singleton("crud.lookup.${option:namespace|snake}", (scope) => {
-      return createCrudLookupProvider(scope.make("repository.${option:namespace|snake}"));
+      return createCrudLookupProvider(scope.make("repository.${option:namespace|snake}"), {
+        ownershipFilter: crudPolicy.ownershipFilter
+      });
     });
 
     app.service(

package/templates/src/local-package/server/actions.js

@@ -65,7 +65,7 @@ function createActions({ surface = "" } = {}) {
         require: "authenticated"
       },
       inputValidator: [workspaceSlugParamsValidator, recordIdParamsValidator, lookupIncludeQueryValidator],
-      outputValidator: ${option:namespace|singular|camel}Resource.operations.view.outputValidator,
+      outputValidator: resource.operations.view.outputValidator,
       idempotency: "none",
       audit: {
         actionName: actionIds.view

package/templates/src/local-package/server/repository.js

@@ -3,6 +3,7 @@ import {
   crudRepositoryList,
   crudRepositoryFindById,
   crudRepositoryListByIds,
+  crudRepositoryListByForeignIds,
   crudRepositoryCreate,
   crudRepositoryUpdateById,
   crudRepositoryDeleteById
@@ -37,6 +38,17 @@ function createRepository(knex, options = {}) {
     return crudRepositoryListByIds(repositoryRuntime, knex, ids, options, callOptions);
   }
 
+  async function listByForeignIds(ids = [], foreignKey = "", callOptions = {}) {
+    return crudRepositoryListByForeignIds(
+      repositoryRuntime,
+      knex,
+      ids,
+      foreignKey,
+      options,
+      callOptions
+    );
+  }
+
   async function create(payload = {}, callOptions = {}) {
     return crudRepositoryCreate(repositoryRuntime, knex, payload, options, callOptions);
   }
@@ -53,6 +65,7 @@ function createRepository(knex, options = {}) {
     list,
     findById,
     listByIds,
+    listByForeignIds,
     create,
     updateById,
     deleteById

package/templates/src/local-package/shared/crudResource.js

@@ -138,4 +138,21 @@ export { resource };
 // @jskit-contract crud.resource.field-meta.${option:namespace|snake}.v1
 void RESOURCE_FIELD_META;
 
+// Example 1:n collection hydration:
+// RESOURCE_FIELD_META.push({
+//   key: "pets",
+//   relation: {
+//     kind: "collection",
+//     namespace: "pets",
+//     foreignKey: "customerId",
+//     parentValueKey: "id",
+//     hydrateOnList: false, // list: opt-in with include=pets
+//     hydrateOnView: true // view: hydrated by default
+//   }
+// });
+//
+// To hydrate child lookups too, request nested include paths:
+// - include=pets
+// - include=pets,pets.breedId
+
 __JSKIT_CRUD_RESOURCE_FIELD_META_PUSH_LINES__

package/templates/src/local-package/shared/index.js

@@ -1,3 +1,3 @@
 export {
-  ${option:namespace|singular|camel}Resource
+  resource
 } from "./${option:namespace|singular|camel}Resource.js";

package/test/addFieldSubcommand.test.js

@@ -86,7 +86,7 @@ export { resource };
 `;
 
 async function withTempApp(run) {
-  const appRoot = await mkdtemp(path.join(tmpdir(), "crud-server-add-field-"));
+  const appRoot = await mkdtemp(path.join(tmpdir(), "crud-server-scaffold-field-"));
   try {
     await run(appRoot);
   } finally {
@@ -129,14 +129,14 @@ function createSnapshot() {
   };
 }
 
-test("add-field patches CRUD resource file using DB snapshot metadata", async () => {
+test("scaffold-field patches CRUD resource file using DB snapshot metadata", async () => {
   await withTempApp(async (appRoot) => {
     const resourceFile = "packages/contacts/src/shared/contactResource.js";
     await writeAppFile(appRoot, resourceFile, RESOURCE_SOURCE);
 
     const result = await runGeneratorSubcommand({
       appRoot,
-      subcommand: "add-field",
+      subcommand: "scaffold-field",
       args: ["categoryId", resourceFile],
       options: {},
       resolveSnapshot: async () => createSnapshot()
@@ -157,7 +157,7 @@ test("add-field patches CRUD resource file using DB snapshot metadata", async ()
 
     const secondRun = await runGeneratorSubcommand({
       appRoot,
-      subcommand: "add-field",
+      subcommand: "scaffold-field",
       args: ["categoryId", resourceFile],
       options: {},
       resolveSnapshot: async () => createSnapshot()

package/test/buildTemplateContext.test.js

@@ -285,6 +285,47 @@ test("buildReplacementsFromSnapshot renders append-only field meta entries from
   assert.match(replacements.__JSKIT_CRUD_MIGRATION_FOREIGN_KEY_LINES__, /table\.foreign\(\["vet_id"\]/);
 });
 
+test("buildReplacementsFromSnapshot renders enum field meta options as select controls", () => {
+  const baseSnapshot = createSnapshot({
+    hasWorkspaceOwnerColumn: false,
+    hasUserOwnerColumn: false
+  });
+  const snapshot = {
+    ...baseSnapshot,
+    columns: Object.freeze([
+      ...baseSnapshot.columns,
+      Object.freeze({
+        name: "temperament",
+        key: "temperament",
+        dataType: "enum",
+        columnType: "enum('relaxed','friendly_excitable','unknown')",
+        typeKind: "string",
+        nullable: false,
+        hasDefault: false,
+        defaultValue: null,
+        autoIncrement: false,
+        unsigned: false,
+        extra: "",
+        maxLength: null,
+        numericPrecision: null,
+        numericScale: null,
+        enumValues: Object.freeze(["relaxed", "friendly_excitable", "unknown"])
+      })
+    ])
+  };
+
+  const replacements = __testables.buildReplacementsFromSnapshot({
+    snapshot,
+    resolvedOwnershipFilter: "public"
+  });
+
+  assert.match(replacements.__JSKIT_CRUD_RESOURCE_FIELD_META_PUSH_LINES__, /key: "temperament"/);
+  assert.match(replacements.__JSKIT_CRUD_RESOURCE_FIELD_META_PUSH_LINES__, /formControl: "select"/);
+  assert.match(replacements.__JSKIT_CRUD_RESOURCE_FIELD_META_PUSH_LINES__, /options: \[/);
+  assert.match(replacements.__JSKIT_CRUD_RESOURCE_FIELD_META_PUSH_LINES__, /"value": "friendly_excitable"/);
+  assert.match(replacements.__JSKIT_CRUD_RESOURCE_FIELD_META_PUSH_LINES__, /"label": "Friendly Excitable"/);
+});
+
 test("renderMigrationColumnLine ignores SQL NULL string defaults", () => {
   const line = __testables.renderMigrationColumnLine(
     {
@@ -445,6 +486,9 @@ test("crud provider template uses shared lookup provider helpers instead of inli
     /from "@jskit-ai\/crud-core\/server\/lookupProviders";/
   );
   assert.match(templateSource, /resolveLookupProvider: createCrudLookupProviderResolver\(scope\)/);
-  assert.match(templateSource, /return createCrudLookupProvider\(scope\.make\("repository\.\$\{option:namespace\|snake\}"\)\);/);
+  assert.match(
+    templateSource,
+    /return createCrudLookupProvider\(scope\.make\("repository\.\$\{option:namespace\|snake\}"\), \{\s*ownershipFilter: crudPolicy\.ownershipFilter\s*\}\);/
+  );
   assert.doesNotMatch(templateSource, /normalizePathname\(relation\.apiPath\)/);
 });

package/test/templateSymbolConsistency.test.js

@@ -0,0 +1,40 @@
+import assert from "node:assert/strict";
+import { readFile } from "node:fs/promises";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+
+function resolveTemplatePath(relativePath) {
+  return fileURLToPath(new URL(`../templates/${relativePath}`, import.meta.url));
+}
+
+test("actions template uses resource symbol for view output validator", async () => {
+  const actionsTemplate = await readFile(
+    resolveTemplatePath("src/local-package/server/actions.js"),
+    "utf8"
+  );
+
+  assert.match(
+    actionsTemplate,
+    /outputValidator:\s*resource\.operations\.view\.outputValidator,/
+  );
+  assert.doesNotMatch(
+    actionsTemplate,
+    /\$\{option:namespace\|singular\|camel\}Resource\.operations\.view\.outputValidator/
+  );
+});
+
+test("shared index template re-exports standardized resource symbol", async () => {
+  const sharedIndexTemplate = await readFile(
+    resolveTemplatePath("src/local-package/shared/index.js"),
+    "utf8"
+  );
+
+  assert.match(
+    sharedIndexTemplate,
+    /export\s*\{\s*resource\s*\}\s*from\s*"\.\/\$\{option:namespace\|singular\|camel\}Resource\.js";/s
+  );
+  assert.doesNotMatch(
+    sharedIndexTemplate,
+    /export\s*\{\s*\$\{option:namespace\|singular\|camel\}Resource\s*\}/s
+  );
+});