Updating server function configs to support more properties, allowing for setting description via the config, and fixing bug where tabi tables could not be lowercase

Author: aarongoin

index.d.ts

@@ -6,14 +6,18 @@ type Visibility = 'PUBLIC' | 'TENANT' | 'ENVIRONMENT';
 type PolyDeployable<CustomConfig extends Record<string, any> = {}> = {
   context: string;
   name: string;
+  description?: string;
   disableAi?: boolean; // Disable use of AI for filling in missing descriptions
 } & CustomConfig;
 
-type PolyFunction = PolyDeployable<{ logsEnabled?: boolean; visibility?: Visibility }>;
+type PolyFunction = PolyDeployable<{ visibility?: Visibility }>;
 
 export type PolyServerFunction = PolyFunction & { 
-  alwaysOn?: boolean; 
+  alwaysOn?: boolean;
+  logsEnabled?: boolean;
+  serverSideAsync?: boolean;
   cachePolyLibrary?: boolean;
+  generateContexts?: string[];
 };
 
 export type PolyClientFunction = PolyFunction;

package.json

@@ -1,6 +1,6 @@
 {
   "name": "polyapi",
-  "version": "0.24.2",
+  "version": "0.24.3",
   "description": "Poly is a CLI tool to help create and manage your Poly definitions.",
   "license": "MIT",
   "repository": {

src/commands/generate/table.ts

@@ -38,7 +38,7 @@ const buildTableTree = (specs: TableSpecification[]): TableRoot[] => {
     const last = contextParts.length - 1;
     for (let i = 0; i <= last; i++) {
       const name = contextParts[i];
-      const interfaceName = i === last ? toPascalCase(name) : toPascalCase(contextParts[i]);
+      const interfaceName = toPascalCase(i === last ? name : contextParts[i]);
       const path = contextParts.slice(0, i + 1).join('.');
       const parent = i ? contextParts.slice(0, i).join('.') : 'default';
       if (schemas[path]) continue;
@@ -81,7 +81,7 @@ const printTableInterface = (table: TableSpecification | string): string => {
 };
 
 const printTableNamespace = (schema: JsonSchema, name: string, depth = 1): string => {
-  return `${ws(depth)}namespace ${name} {${EOL}${
+  return `${ws(depth)}namespace ${toPascalCase(name)} {${EOL}${
     printSchemaAsType(schema, 'Row', depth + 1)
   }${EOL}${EOL}${ws(depth + 1)}${
     [

src/dependencies.ts

@@ -11,7 +11,7 @@ export const libraryMinVersionMap: Record<string, VersionT> = {
   'ts-node': '5.0.0',
   typescript: '4.0.2',
 };
-const MIN_NODE_VERSION: VersionT = '18.20.5';
+const MIN_NODE_VERSION: VersionT = '20.19.3';
 
 const DEFAULT_TS_CONFIG = {
   compilerOptions: {

src/deployables.ts

@@ -43,6 +43,7 @@ export type ParsedDeployableConfig = {
   context: string;
   name: string;
   type: DeployableTypes;
+  description?: string;
   disableAi?: boolean;
   config: Record<string, any>;
 };

src/transpiler.ts

@@ -367,6 +367,7 @@ const getFunctionDetails = (
       const types = parseTSTypes(node, sourceFile);
       if (
         jsDoc &&
+        types.params.length === jsDoc.params.length &&
         types.params.every(
           (p, i) =>
             p.type === jsDoc.params[i].type && p.name === jsDoc.params[i].name,
@@ -419,6 +420,14 @@ const parseDeployableFunction = (
 ): DeployableRecord => {
   const [deployments, deploymentCommentRanges] = getDeployComments(sourceFile);
   const functionDetails = getFunctionDetails(sourceFile, polyConfig.name);
+  if (polyConfig.description) {
+    if (polyConfig.description !== functionDetails.types.description) {
+      functionDetails.types.description = polyConfig.description;
+      functionDetails.dirty = true;
+    }
+  } else {
+    polyConfig.description = functionDetails.types.description || '';
+  }
   const dependencies = getDependencies(sourceFile.getFullText(), sourceFile.fileName, baseUrl);
   const typeSchemas = generateTypeSchemas(sourceFile.fileName, DeployableTypeEntries.map(d => d[0]), polyConfig.name);
   return {

test/generateTables.spec.ts

@@ -16,9 +16,9 @@ describe('printTableSpecs', () => {
       const specs: TableSpecification[] = [
         {
           'id': 'ad5edb98-9eeb-4bb5-8122-32f9a6f6b512',
-          'name': 'MyTable',
+          'name': 'myTable',
           'context': 'aaron.testing',
-          'contextName': 'aaron.testing.MyTable',
+          'contextName': 'aaron.testing.myTable',
           'type': 'table',
           'schema': {
             'type': 'object',
@@ -109,7 +109,7 @@ describe('printTableSpecs', () => {
           '  }',
           '',
           '  interface Testing {',
-          '    MyTable: {',
+          '    myTable: {',
           '      count(query: Aaron.Testing.MyTable.CountQuery): Promise<Aaron.Testing.MyTable.CountResult>;',
           '      selectMany(query: Aaron.Testing.MyTable.SelectManyQuery): Promise<Aaron.Testing.MyTable.QueryResults>;',
           '      selectOne(query: Aaron.Testing.MyTable.SelectOneQuery): Promise<Aaron.Testing.MyTable.QueryResult>;',