prismic-ts-codegen 0.1.3-alpha.0 → 0.1.3

package/bin/cli.mjs

@@ -209,10 +209,18 @@ const pascalCase = (input) => pascalCase$1(input, {
   transform: pascalCaseTransformMerge
 });
 
-const buildSharedSliceInterfaceName = (config) => {
+const buildSharedSliceInterfaceNamePart = (config) => {
   return pascalCase(`${config.id} Slice`);
 };
 
+const buildTypeName = (...parts) => {
+  let name = pascalCase(parts.filter(Boolean).join(" "));
+  if (/^[0-9]/.test(name) ? "_" : "") {
+    name = `_${name}`;
+  }
+  return name;
+};
+
 const addInterfacePropertyForField = (config) => {
   switch (config.model.type) {
     case "UID": {
@@ -262,12 +270,16 @@ const addInterfacePropertyForField = (config) => {
       if (config.fieldConfigs.embed?.providerTypes) {
         for (const providerType in config.fieldConfigs.embed?.providerTypes) {
           const configuredProviderType = config.fieldConfigs.embed?.providerTypes[providerType];
-          providerTypes.push(`({ provider_name: "${providerType}" } & ${configuredProviderType})`);
+          providerTypes.push(
+            `({ provider_name: "${providerType}" } & ${configuredProviderType})`
+          );
         }
       }
       config.interface.addProperty({
         name: config.id,
-        type: providerTypes.length > 0 ? `prismicT.EmbedField<prismicT.AnyOEmbed & prismicT.OEmbedExtra & (${providerTypes.join(" | ")})>` : "prismicT.EmbedField",
+        type: providerTypes.length > 0 ? `prismicT.EmbedField<prismicT.AnyOEmbed & prismicT.OEmbedExtra & (${providerTypes.join(
+          " | "
+        )})>` : "prismicT.EmbedField",
         docs: buildFieldDocs({
           id: config.id,
           model: config.model,
@@ -471,7 +483,13 @@ const addInterfacePropertyForField = (config) => {
     }
     case "Group": {
       const itemInterface = config.sourceFile.addInterface({
-        name: pascalCase(`${config.path[0].id} Document Data ${config.id} Item`),
+        name: buildTypeName(
+          config.path[0].id,
+          "Document",
+          "Data",
+          config.id,
+          "Item"
+        ),
         docs: [
           {
             description: (writer) => {
@@ -523,12 +541,22 @@ const addInterfacePropertyForField = (config) => {
         for (const choiceId in config.model.config.choices) {
           const choice = config.model.config.choices[choiceId];
           if (choice.type === CustomTypeModelSliceType.SharedSlice) {
-            choiceInterfaceNames.push(buildSharedSliceInterfaceName({ id: choiceId }));
+            choiceInterfaceNames.push(
+              buildSharedSliceInterfaceNamePart({ id: choiceId })
+            );
           } else if (choice.type === CustomTypeModelSliceType.Slice) {
             let primaryInterface;
             if (choice["non-repeat"] && Object.keys(choice["non-repeat"]).length > 0) {
               primaryInterface = config.sourceFile.addInterface({
-                name: pascalCase(`${config.path[0].id} Document Data ${config.id} ${choiceId} Slice Primary`),
+                name: buildTypeName(
+                  config.path[0].id,
+                  "Document",
+                  "Data",
+                  config.id,
+                  choiceId,
+                  "Slice",
+                  "Primary"
+                ),
                 docs: [
                   {
                     description: (writer) => {
@@ -549,7 +577,9 @@ const addInterfacePropertyForField = (config) => {
                           }
                         ]
                       });
-                      writer.writeLine(`Primary content in ${humanReadablePath}`);
+                      writer.writeLine(
+                        `Primary content in ${humanReadablePath}`
+                      );
                     }
                   }
                 ]
@@ -579,7 +609,15 @@ const addInterfacePropertyForField = (config) => {
             let itemInterface;
             if (choice.repeat && Object.keys(choice.repeat).length > 0) {
               itemInterface = config.sourceFile.addInterface({
-                name: pascalCase(`${config.path[0].id} Document Data ${config.id} ${choiceId} Slice Item`),
+                name: buildTypeName(
+                  config.path[0].id,
+                  "Document",
+                  "Data",
+                  config.id,
+                  choiceId,
+                  "Slice",
+                  "Item"
+                ),
                 docs: [
                   {
                     description: (writer) => {
@@ -629,7 +667,14 @@ const addInterfacePropertyForField = (config) => {
               });
             }
             const sliceType = config.sourceFile.addTypeAlias({
-              name: pascalCase(`${config.path[0].id} Document Data ${config.id} ${choiceId} Slice`),
+              name: buildTypeName(
+                config.path[0].id,
+                "Document",
+                "Data",
+                config.id,
+                choiceId,
+                "Slice"
+              ),
               type: `prismicT.Slice<"${choiceId}", ${primaryInterface ? `Simplify<${primaryInterface.getName()}>` : "Record<string, never>"}, ${itemInterface ? `Simplify<${itemInterface.getName()}>` : "never"}>`,
               isExported: true
             });
@@ -638,7 +683,13 @@ const addInterfacePropertyForField = (config) => {
         }
       }
       const slicesType = config.sourceFile.addTypeAlias({
-        name: pascalCase(`${config.path[0].id} Document Data ${config.id} Slice`),
+        name: buildTypeName(
+          config.path[0].id,
+          "Document",
+          "Data",
+          config.id,
+          "Slice"
+        ),
         type: choiceInterfaceNames.length > 0 ? choiceInterfaceNames.join(" | ") : "never",
         docs: [
           {
@@ -709,7 +760,7 @@ const addTypeAliasForCustomType = ({
   let dataInterface;
   if (hasDataFields) {
     dataInterface = sourceFile.addInterface({
-      name: pascalCase(`${model.id} Document Data`),
+      name: buildTypeName(model.id, "Document", "Data"),
       docs: [
         {
           description: `Content for ${model.label} documents`
@@ -734,7 +785,7 @@ const addTypeAliasForCustomType = ({
     }
   } else {
     dataInterface = sourceFile.addTypeAlias({
-      name: pascalCase(`${model.id} Document Data`),
+      name: buildTypeName(model.id, "Document", "Data"),
       type: `Record<string, never>`,
       docs: [
         {
@@ -744,7 +795,7 @@ const addTypeAliasForCustomType = ({
     });
   }
   return sourceFile.addTypeAlias({
-    name: pascalCase(`${model.id} Document`),
+    name: buildTypeName(model.id, "Document"),
     typeParameters: [
       {
         name: "Lang",
@@ -760,7 +811,9 @@ const addTypeAliasForCustomType = ({
           writer.blankLine();
           writer.writeLine(`- **API ID**: \`${model.id}\``);
           writer.writeLine(`- **Repeatable**: \`${model.repeatable}\``);
-          writer.writeLine(`- **Documentation**: ${CUSTOM_TYPES_DOCUMENTATION_URL}`);
+          writer.writeLine(
+            `- **Documentation**: ${CUSTOM_TYPES_DOCUMENTATION_URL}`
+          );
         },
         tags: [
           {
@@ -780,7 +833,11 @@ const addTypeAliasForSharedSlice = (config) => {
     let primaryInterface;
     if (variation.primary && Object.keys(variation.primary).length > 0) {
       primaryInterface = config.sourceFile.addInterface({
-        name: pascalCase(`${buildSharedSliceInterfaceName({ id: config.model.id })} ${variation.id} Primary`),
+        name: buildTypeName(
+          buildSharedSliceInterfaceNamePart({ id: config.model.id }),
+          variation.id,
+          "Primary"
+        ),
         docs: [
           {
             description: (writer) => {
@@ -821,7 +878,11 @@ const addTypeAliasForSharedSlice = (config) => {
     let itemInterface;
     if (variation.items && Object.keys(variation.items).length > 0) {
       itemInterface = config.sourceFile.addInterface({
-        name: pascalCase(`${buildSharedSliceInterfaceName({ id: config.model.id })} ${variation.id} Item`),
+        name: buildTypeName(
+          buildSharedSliceInterfaceNamePart({ id: config.model.id }),
+          variation.id,
+          "Item"
+        ),
         docs: [
           {
             description: (writer) => {
@@ -861,18 +922,23 @@ const addTypeAliasForSharedSlice = (config) => {
       });
     }
     const variationType = config.sourceFile.addTypeAlias({
-      name: pascalCase(`${buildSharedSliceInterfaceName({
-        id: config.model.id
-      })} ${variation.id}`),
+      name: buildTypeName(
+        buildSharedSliceInterfaceNamePart({ id: config.model.id }),
+        variation.id
+      ),
       type: `prismicT.SharedSliceVariation<"${variation.id}", ${primaryInterface ? `Simplify<${primaryInterface.getName()}>` : "Record<string, never>"}, ${itemInterface ? `Simplify<${itemInterface.getName()}>` : "never"}>`,
       docs: [
         {
           description: (writer) => {
-            writer.writeLine(`${variation.name} variation for ${config.model.name} Slice`);
+            writer.writeLine(
+              `${variation.name} variation for ${config.model.name} Slice`
+            );
             writer.blankLine();
             writer.writeLine(`- **API ID**: \`${variation.id}\``);
             writer.writeLine(`- **Description**: \`${variation.description}\``);
-            writer.writeLine(`- **Documentation**: ${SHARED_SLICES_DOCUMENTATION_URL}`);
+            writer.writeLine(
+              `- **Documentation**: ${SHARED_SLICES_DOCUMENTATION_URL}`
+            );
           }
         }
       ],
@@ -881,7 +947,7 @@ const addTypeAliasForSharedSlice = (config) => {
     variationTypeNames.push(variationType.getName());
   }
   const variationsType = config.sourceFile.addTypeAlias({
-    name: pascalCase(`${config.model.id} Slice Variation`),
+    name: buildTypeName(config.model.id, "Slice", "Variation"),
     type: variationTypeNames.length > 0 ? variationTypeNames.join(" | ") : "never",
     docs: [
       {
@@ -900,9 +966,9 @@ const addTypeAliasForSharedSlice = (config) => {
     ]
   });
   return config.sourceFile.addTypeAlias({
-    name: pascalCase(buildSharedSliceInterfaceName({
-      id: config.model.id
-    })),
+    name: buildTypeName(
+      buildSharedSliceInterfaceNamePart({ id: config.model.id })
+    ),
     type: `prismicT.SharedSlice<"${config.model.id}", ${variationsType.getName()}>`,
     docs: [
       {
@@ -910,8 +976,12 @@ const addTypeAliasForSharedSlice = (config) => {
           writer.writeLine(`${config.model.name} Shared Slice`);
           writer.blankLine();
           writer.writeLine(`- **API ID**: \`${config.model.id}\``);
-          writer.writeLine(`- **Description**: \`${config.model.description}\``);
-          writer.writeLine(`- **Documentation**: ${SHARED_SLICES_DOCUMENTATION_URL}`);
+          writer.writeLine(
+            `- **Description**: \`${config.model.description}\``
+          );
+          writer.writeLine(
+            `- **Documentation**: ${SHARED_SLICES_DOCUMENTATION_URL}`
+          );
         }
       }
     ],
@@ -936,7 +1006,7 @@ const generateTypes = (config = {}) => {
     leadingTrivia: NON_EDITABLE_FILE_HEADER
   });
   sourceFile.addStatements(BLANK_LINE_IDENTIFIER);
-  const simplifyTypeAlias = sourceFile.addTypeAlias({
+  sourceFile.addTypeAlias({
     name: "Simplify",
     typeParameters: [
       {
@@ -957,7 +1027,9 @@ const generateTypes = (config = {}) => {
     if (config.customTypeModels.length > 0) {
       sourceFile.addTypeAlias({
         name: "AllDocumentTypes",
-        type: config.customTypeModels.map((customTypeModel) => pascalCase(`${customTypeModel.id} Document`)).join(" | "),
+        type: config.customTypeModels.map(
+          (customTypeModel) => buildTypeName(customTypeModel.id, "Document")
+        ).join(" | "),
         isExported: true
       });
     }
@@ -971,7 +1043,7 @@ const generateTypes = (config = {}) => {
       });
     }
   }
-  if (config.clientIntegration?.includeCreateClientInterface || config.clientIntegration?.includeContentNamespace) {
+  if (config.clientIntegration?.includeCreateClientInterface) {
     sourceFile.addImportDeclaration({
       moduleSpecifier: "@prismicio/client",
       namespaceImport: "prismic",
@@ -982,44 +1054,25 @@ const generateTypes = (config = {}) => {
       hasDeclareKeyword: true,
       declarationKind: ModuleDeclarationKind.Module
     });
-    if (config.clientIntegration.includeCreateClientInterface) {
-      clientModuleDeclaration.addInterface({
-        name: "CreateClient",
-        callSignatures: [
-          {
-            parameters: [
-              {
-                name: "repositoryNameOrEndpoint",
-                type: "string"
-              },
-              {
-                name: "options",
-                type: "prismic.ClientConfig",
-                hasQuestionToken: true
-              }
-            ],
-            returnType: (config.customTypeModels?.length || 0) > 0 ? "prismic.Client<AllDocumentTypes>" : "prismic.Client"
-          }
-        ]
-      });
-    }
-    if (config.clientIntegration.includeContentNamespace) {
-      const contentNamespaceDeclaration = clientModuleDeclaration.addModule({
-        name: "Content",
-        declarationKind: ModuleDeclarationKind.Namespace
-      });
-      const exportSymbols = sourceFile.getExportSymbols().filter((exportSymbol) => {
-        return exportSymbol.getName() !== simplifyTypeAlias.getName();
-      });
-      contentNamespaceDeclaration.addExportDeclaration({
-        isTypeOnly: true,
-        namedExports: exportSymbols.map((exportSymbol) => {
-          return {
-            name: exportSymbol.getName()
-          };
-        })
-      });
-    }
+    clientModuleDeclaration.addInterface({
+      name: "CreateClient",
+      callSignatures: [
+        {
+          parameters: [
+            {
+              name: "repositoryNameOrEndpoint",
+              type: "string"
+            },
+            {
+              name: "options",
+              type: "prismic.ClientConfig",
+              hasQuestionToken: true
+            }
+          ],
+          returnType: (config.customTypeModels?.length || 0) > 0 ? "prismic.Client<AllDocumentTypes>" : "prismic.Client"
+        }
+      ]
+    });
   }
   return getSourceFileText(sourceFile);
 };
@@ -1036,20 +1089,28 @@ const configSchema = Joi.object({
   customTypesAPIToken: Joi.string(),
   output: Joi.string(),
   clientIntegration: Joi.object({
-    includeCreateClientInterface: Joi.boolean(),
-    includeContentNamespace: Joi.boolean()
+    includeCreateClientInterface: Joi.boolean()
   }),
-  locales: Joi.alternatives(Joi.array().items(Joi.string().required()), Joi.object({
-    ids: Joi.array().items(Joi.string().required()),
-    fetchFromRepository: Joi.boolean()
-  })),
-  models: Joi.alternatives(Joi.array().items(Joi.string()), Joi.object({
-    files: Joi.array().items(Joi.string()),
-    fetchFromRepository: Joi.boolean()
-  })),
+  locales: Joi.alternatives(
+    Joi.array().items(Joi.string().required()),
+    Joi.object({
+      ids: Joi.array().items(Joi.string().required()),
+      fetchFromRepository: Joi.boolean()
+    })
+  ),
+  models: Joi.alternatives(
+    Joi.array().items(Joi.string()),
+    Joi.object({
+      files: Joi.array().items(Joi.string()),
+      fetchFromRepository: Joi.boolean()
+    })
+  ),
   fields: Joi.object({
     embed: Joi.object({
-      providerTypes: Joi.object().pattern(Joi.string(), Joi.string().required())
+      providerTypes: Joi.object().pattern(
+        Joi.string(),
+        Joi.string().required()
+      )
     }),
     integrationFields: Joi.object({
       catalogTypes: Joi.object().pattern(Joi.string(), Joi.string().required())
@@ -1150,7 +1211,8 @@ const loadConfig = (config) => {
   return {};
 };
 
-const cli = meow(`
+const cli = meow(
+  `
 	Usage:
 	    prismic-ts-codegen [options...]
 	    prismic-ts-codegen init [options...]
@@ -1160,16 +1222,18 @@ const cli = meow(`
 
 	Options:
 	    -c, --config <path>  Path to a prismic-ts-codegen configuration file.
-	`, {
-  importMeta: import.meta,
-  flags: {
-    config: {
-      type: "string",
-      alias: "c",
-      isRequired: false
+	`,
+  {
+    importMeta: import.meta,
+    flags: {
+      config: {
+        type: "string",
+        alias: "c",
+        isRequired: false
+      }
     }
   }
-});
+);
 const main = async () => {
   if (cli.input[0] === "init") {
     const configPath = cli.flags.config || "prismicCodegen.config.ts";
@@ -1227,12 +1291,13 @@ Created prismic-ts-codegen config file: ${configPath}`);
         localeIDs,
         fieldConfigs: config.fields,
         clientIntegration: {
-          includeCreateClientInterface: hasCustomTypeModels ? config.clientIntegration?.includeCreateClientInterface ?? true : false,
-          includeContentNamespace: config.clientIntegration?.includeContentNamespace ?? true
+          includeCreateClientInterface: hasCustomTypeModels ? config.clientIntegration?.includeCreateClientInterface ?? true : false
         }
       });
       if (config.clientIntegration?.includeCreateClientInterface && !hasCustomTypeModels) {
-        console.info("[INFO]: prismic-ts-codegen was configured to automatically integrate with `@prismicio/client`, but the integration was not generated because no Custom Type models were found. Automatic integration requires at least one Custom Type model.");
+        console.info(
+          "[INFO]: prismic-ts-codegen was configured to automatically integrate with `@prismicio/client`, but the integration was generated because no Custom Type models were found. Automatic integration requires at least one Custom Type model."
+        );
       }
       if (config.output) {
         writeFileSync(resolve(config.output), types);