@highstate/cli 0.9.19 → 0.9.21

package/src/commands/package/create.ts

@@ -1,10 +1,10 @@
 import { Command, Option } from "clipanion"
 import {
-  findWorkspaceRoot,
   createPackage,
-  updateTsconfigReferences,
-  scanWorkspacePackages,
+  findWorkspaceRoot,
   highstateConfigSchema,
+  scanWorkspacePackages,
+  updateTsconfigReferences,
 } from "../../shared"
 
 export class CreateCommand extends Command {

package/src/commands/package/index.ts

@@ -1,4 +1,4 @@
-export { UpdateReferencesCommand } from "./update-references"
-export { ListCommand } from "./list"
 export { CreateCommand } from "./create"
+export { ListCommand } from "./list"
 export { RemoveCommand } from "./remove"
+export { UpdateReferencesCommand } from "./update-references"

package/src/main.ts

@@ -1,13 +1,13 @@
 import { Builtins, Cli } from "clipanion"
 import { version } from "../package.json"
-import { DesignerCommand } from "./commands/designer"
-import { BuildCommand } from "./commands/build"
 import { BackendIdentityCommand } from "./commands/backend/identity"
+import { BuildCommand } from "./commands/build"
+import { DesignerCommand } from "./commands/designer"
 import {
-  UpdateReferencesCommand,
-  ListCommand as PackageListCommand,
   CreateCommand as PackageCreateCommand,
+  ListCommand as PackageListCommand,
   RemoveCommand as PackageRemoveCommand,
+  UpdateReferencesCommand,
 } from "./commands/package"
 
 const cli = new Cli({

package/src/shared/entry-points.ts

@@ -0,0 +1,116 @@
+import type { PackageJson } from "pkg-types"
+import { logger } from "./logger"
+
+export interface EntryPoint {
+  targetName: string
+  entryPoint: string
+  distPath: string
+  isBin: boolean
+  key: string
+}
+
+/**
+ * Extracts entry points from package.json exports and bin fields
+ */
+export function extractEntryPoints(packageJson: PackageJson): Record<string, EntryPoint> {
+  const exports = packageJson.exports
+  let bin = packageJson.bin
+
+  if (!exports && !bin) {
+    logger.warn("no exports or bin found in package.json")
+    return {}
+  }
+
+  if (exports !== undefined && (typeof exports !== "object" || Array.isArray(exports))) {
+    throw new Error("Exports field in package.json must be an object")
+  }
+
+  if (bin !== undefined && typeof bin !== "object") {
+    if (!packageJson.name) {
+      throw new Error("Package name is required when bin is a string")
+    }
+    bin = { [packageJson.name]: bin as string }
+  }
+
+  const result: Record<string, EntryPoint> = {}
+
+  // process exports entries
+  if (exports) {
+    for (const [key, value] of Object.entries(exports)) {
+      let distPath: string
+
+      if (typeof value === "string") {
+        distPath = value
+      } else if (typeof value === "object" && !Array.isArray(value)) {
+        if (!value.default) {
+          throw new Error(`Export "${key}" must have a default field in package.json`)
+        }
+
+        if (typeof value.default !== "string") {
+          throw new Error(`Export "${key}" default field must be a string in package.json`)
+        }
+
+        distPath = value.default
+      } else {
+        throw new Error(`Export "${key}" must be a string or an object in package.json`)
+      }
+
+      if (!distPath.startsWith("./dist/")) {
+        throw new Error(
+          `The default value of export "${key}" must start with "./dist/" in package.json, got "${distPath}"`,
+        )
+      }
+
+      if (!distPath.endsWith(".js")) {
+        throw new Error(
+          `The default value of export "${key}" must end with ".js" in package.json, got "${distPath}"`,
+        )
+      }
+
+      const targetName = distPath.slice(7).slice(0, -3)
+
+      result[targetName] = {
+        entryPoint: `./src/${targetName}.ts`,
+        targetName,
+        distPath,
+        isBin: false,
+        key,
+      }
+    }
+  }
+
+  // process bin entries
+  if (bin) {
+    for (const [key, value] of Object.entries(bin)) {
+      if (typeof value !== "string") {
+        throw new Error(`Bin entry "${key}" must be a string in package.json`)
+      }
+
+      const distPath = value
+
+      if (!distPath.startsWith("./dist/")) {
+        throw new Error(
+          `The value of bin entry "${key}" must start with "./dist/" in package.json, got "${distPath}"`,
+        )
+      }
+
+      if (!distPath.endsWith(".js")) {
+        throw new Error(
+          `The value of bin entry "${key}" must end with ".js" in package.json, got "${distPath}"`,
+        )
+      }
+
+      const targetName = distPath.slice(7).slice(0, -3)
+
+      result[targetName] = {
+        entryPoint: `./src/${targetName}.ts`,
+        targetName,
+        distPath,
+        isBin: true,
+        key,
+      }
+    }
+  }
+
+  return result
+}

package/src/shared/index.ts

@@ -1,7 +1,8 @@
-export * from "./services"
+export * from "./bin-transformer"
+export * from "./entry-points"
 export * from "./logger"
 export * from "./schema-transformer"
-export * from "./source-hash-calculator"
-export * from "./bin-transformer"
 export * from "./schemas"
+export * from "./services"
+export * from "./source-hash-calculator"
 export * from "./workspace"

package/src/shared/library-loader.ts

@@ -1,5 +1,6 @@
 import type { Logger } from "pino"
 import console from "node:console"
+import { Crc32, crc32 } from "@aws-crypto/crc32"
 import {
   type Component,
   type ComponentModel,
@@ -9,7 +10,6 @@ import {
   isEntity,
   isUnitModel,
 } from "@highstate/contract"
-import { Crc32, crc32 } from "@aws-crypto/crc32"
 import { encode } from "@msgpack/msgpack"
 import { int32ToBytes } from "./utils"
 

package/src/shared/logger.ts

@@ -1,6 +1,6 @@
 import { PassThrough } from "node:stream"
-import pino, { levels } from "pino"
 import { consola, LogLevels } from "consola"
+import pino, { levels } from "pino"
 
 export const logger = pino(
   {

package/src/shared/schema-transformer.spec.ts

@@ -1,4 +1,4 @@
-import { describe, it, expect } from "vitest"
+import { describe, expect, it } from "vitest"
 import { applySchemaTransformations } from "./schema-transformer"
 
 describe("applySchemaTransformations", () => {
@@ -200,6 +200,7 @@ const spec = {
     const result = await applySchemaTransformations(input)
 
     expect(result).toContain(
+      // biome-ignore lint/suspicious/noTemplateCurlyInString: it is example code
       "$addArgumentDescription(Type.String(), `This is a description with \\`backticks\\` and \\${template} literals.",
     )
     expect(result).toContain("It also has multiple lines.`)")

package/src/shared/schema-transformer.ts

@@ -1,14 +1,14 @@
 import type { Plugin } from "esbuild"
 import { readFile } from "node:fs/promises"
+import MagicString from "magic-string"
 import {
-  parseAsync,
-  type Comment,
   type CallExpression,
-  type ObjectProperty,
+  type Comment,
   type MemberExpression,
+  type ObjectProperty,
+  parseAsync,
 } from "oxc-parser"
-import { walk, type Node } from "oxc-walker"
-import MagicString from "magic-string"
+import { type Node, walk } from "oxc-walker"
 
 export const schemaTransformerPlugin: Plugin = {
   name: "schema-transformer",

package/src/shared/source-hash-calculator.ts

@@ -1,17 +1,17 @@
 import type { Logger } from "pino"
-import { dirname, relative, resolve } from "node:path"
 import { readFile, writeFile } from "node:fs/promises"
+import { dirname, relative, resolve } from "node:path"
 import { fileURLToPath, pathToFileURL } from "node:url"
-import { readPackageJSON, resolvePackageJSON, type PackageJson } from "pkg-types"
 import { crc32 } from "@aws-crypto/crc32"
 import { resolve as importMetaResolve } from "import-meta-resolve"
+import { type PackageJson, readPackageJSON, resolvePackageJSON } from "pkg-types"
 import { z } from "zod"
 import {
-  type HighstateManifest,
   type HighstateConfig,
-  type SourceHashConfig,
+  type HighstateManifest,
   highstateConfigSchema,
   highstateManifestSchema,
+  type SourceHashConfig,
   sourceHashConfigSchema,
 } from "./schemas"
 import { int32ToBytes } from "./utils"
@@ -202,7 +202,7 @@ export class SourceHashCalculator {
         return await this.getFileHash(dependency.fullPath)
       }
       case "npm": {
-        let resolvedUrl
+        let resolvedUrl: string
         try {
           const baseUrl = pathToFileURL(dirname(this.packageJsonPath))
 

package/src/shared/workspace.ts

@@ -1,6 +1,6 @@
-import { readdir, readFile, writeFile, mkdir } from "node:fs/promises"
-import { join, relative, resolve } from "node:path"
 import { existsSync } from "node:fs"
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises"
+import { join, relative, resolve } from "node:path"
 import { z } from "zod"
 import { highstateConfigSchema } from "./schemas"
 
@@ -221,13 +221,6 @@ export async function createPackage(
     "utf-8",
   )
 
-  // create CHANGELOG.md
-  await writeFile(
-    join(packagePath, "CHANGELOG.md"),
-    `# Changelog\n\nAll notable changes to this project will be documented in this file.\n`,
-    "utf-8",
-  )
-
   // create basic index.ts
   await writeFile(join(srcPath, "index.ts"), `// ${name} package\n`, "utf-8")