ts-repo-utils 1.0.1 → 1.1.0

package/README.md

@@ -27,23 +27,20 @@ console.log(exists); // true or false
 
 #### `assertPathExists(filePath: string, description?: string): Promise<void>`
 
-Validates that a path exists and throws an error if it doesn't.
+Validates that a path exists and exits with code 1 if it doesn't.
 
 ```typescript
 import { assertPathExists } from 'ts-repo-utils';
 
-try {
-    await assertPathExists('./src/index.ts', 'Entry point file');
-} catch (error) {
-    console.error('Entry point file does not exist');
-}
+// If the file doesn't exist, this will exit the process with code 1
+await assertPathExists('./src/index.ts', 'Entry point file');
 ```
 
 ### File Extension Validation
 
 #### `assertExt(config: CheckExtConfig): Promise<void>`
 
-Validates that all files in specified directories have the correct extensions.
+Validates that all files in specified directories have the correct extensions. Exits with code 1 if any files have incorrect extensions.
 
 ```typescript
 import { assertExt } from 'ts-repo-utils';
@@ -269,17 +266,14 @@ await formatFiles('dist/**/*.js');
 ### Project Validation
 
 ```typescript
-import { pathExists, assertPathExists, repoIsDirty } from 'ts-repo-utils';
+import { pathExists, assertPathExists, assertRepoIsDirty } from 'ts-repo-utils';
 
-// Check required files exist
+// Check required files exist (exits with code 1 if files don't exist)
 await assertPathExists('./package.json', 'Package manifest');
 await assertPathExists('./tsconfig.json', 'TypeScript config');
 
-// Verify clean repository state
-const isDirty = await repoIsDirty();
-if (isDirty) {
-    throw new Error('Repository has uncommitted changes');
-}
+// Verify clean repository state (exits with code 1 if repo is dirty)
+await assertRepoIsDirty();
 ```
 
 ## License

package/dist/functions/assert-ext.d.mts

@@ -15,8 +15,8 @@ export type CheckExtConfig = DeepReadonly<{
 }>;
 /**
  * Validates that all files in specified directories have the correct extensions.
+ * Exits with code 1 if any files have incorrect extensions.
  * @param config - Configuration specifying directories and expected extensions.
- * @throws Error with details of all incorrect files found.
  */
 export declare const assertExt: (config: CheckExtConfig) => Promise<void>;
 //# sourceMappingURL=assert-ext.d.mts.map

package/dist/functions/assert-ext.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"assert-ext.d.mts","sourceRoot":"","sources":["../../src/functions/assert-ext.mts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;IACxC,6DAA6D;IAC7D,WAAW,EAAE;QACX,8BAA8B;QAC9B,IAAI,EAAE,MAAM,CAAC;QACb,kDAAkD;QAClD,SAAS,EAAE,MAAM,CAAC;QAClB,sFAAsF;QACtF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,EAAE,CAAC;CACL,CAAC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAU,QAAQ,cAAc,KAAG,OAAO,CAAC,IAAI,CA2DpE,CAAC"}
+{"version":3,"file":"assert-ext.d.mts","sourceRoot":"","sources":["../../src/functions/assert-ext.mts"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;IACxC,6DAA6D;IAC7D,WAAW,EAAE;QACX,8BAA8B;QAC9B,IAAI,EAAE,MAAM,CAAC;QACb,kDAAkD;QAClD,SAAS,EAAE,MAAM,CAAC;QAClB,sFAAsF;QACtF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,EAAE,CAAC;CACL,CAAC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAU,QAAQ,cAAc,KAAG,OAAO,CAAC,IAAI,CA4DpE,CAAC"}

package/dist/functions/assert-ext.mjs

@@ -3,8 +3,8 @@ import { assertPathExists } from './assert-path-exists.mjs';
 
 /**
  * Validates that all files in specified directories have the correct extensions.
+ * Exits with code 1 if any files have incorrect extensions.
  * @param config - Configuration specifying directories and expected extensions.
- * @throws Error with details of all incorrect files found.
  */
 const assertExt = async (config) => {
     const allIncorrectFiles = [];
@@ -46,7 +46,8 @@ const assertExt = async (config) => {
             '',
             generateErrorMessage(),
         ].join('\n');
-        throw new Error(errorMessage);
+        echo(errorMessage);
+        process.exit(1);
     }
     echo('✓ All files have correct extensions');
 };

package/dist/functions/assert-ext.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"assert-ext.mjs","sources":["../../src/functions/assert-ext.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"assert-ext.mjs","sources":["../../src/functions/assert-ext.mts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/functions/assert-path-exists.d.mts

@@ -1,3 +1,4 @@
+import '../node-global.mjs';
 /**
  * Checks if a file or directory exists.
  * @param filePath - The path to check.
@@ -5,10 +6,9 @@
  */
 export declare const pathExists: (filePath: string) => Promise<boolean>;
 /**
- * Validates that a path exists and throws if it doesn't.
+ * Validates that a path exists and exits with code 1 if it doesn't.
  * @param filePath - The path to validate.
- * @param description - Description for error message.
- * @throws Error if path doesn't exist.
+ * @param description - Description for error message (defaults to 'Path').
  */
 export declare const assertPathExists: (filePath: string, description?: string) => Promise<void>;
 //# sourceMappingURL=assert-path-exists.d.mts.map

package/dist/functions/assert-path-exists.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"assert-path-exists.d.mts","sourceRoot":"","sources":["../../src/functions/assert-path-exists.mts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAOlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,oBAAoB,KACnB,OAAO,CAAC,IAAI,CAId,CAAC"}
+{"version":3,"file":"assert-path-exists.d.mts","sourceRoot":"","sources":["../../src/functions/assert-path-exists.mts"],"names":[],"mappings":"AACA,OAAO,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAOlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,oBAAoB,KACnB,OAAO,CAAC,IAAI,CAKd,CAAC"}

package/dist/functions/assert-path-exists.mjs

@@ -1,4 +1,5 @@
 import * as fs_ from 'node:fs/promises';
+import '../node-global.mjs';
 
 /**
  * Checks if a file or directory exists.
@@ -15,14 +16,14 @@ const pathExists = async (filePath) => {
     }
 };
 /**
- * Validates that a path exists and throws if it doesn't.
+ * Validates that a path exists and exits with code 1 if it doesn't.
  * @param filePath - The path to validate.
- * @param description - Description for error message.
- * @throws Error if path doesn't exist.
+ * @param description - Description for error message (defaults to 'Path').
  */
 const assertPathExists = async (filePath, description = 'Path') => {
     if (!(await pathExists(filePath))) {
-        throw new Error(`${description} does not exist: ${filePath}`);
+        echo(`${description} does not exist: ${filePath}`);
+        process.exit(1);
     }
 };
 

package/dist/functions/assert-path-exists.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"assert-path-exists.mjs","sources":["../../src/functions/assert-path-exists.mts"],"sourcesContent":[null],"names":["fs"],"mappings":";;AAEA;;;;AAIG;MACU,UAAU,GAAG,OAAO,QAAgB,KAAsB;AACrE,IAAA,IAAI;AACF,QAAA,MAAMA,GAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;AACzB,QAAA,OAAO,IAAI;;AACX,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;;AAEhB;AAEA;;;;;AAKG;AACI,MAAM,gBAAgB,GAAG,OAC9B,QAAgB,EAChB,WAAW,GAAG,MAAM,KACH;IACjB,IAAI,EAAE,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE;QACjC,MAAM,IAAI,KAAK,CAAC,CAAA,EAAG,WAAW,CAAoB,iBAAA,EAAA,QAAQ,CAAE,CAAA,CAAC;;AAEjE;;;;"}
+{"version":3,"file":"assert-path-exists.mjs","sources":["../../src/functions/assert-path-exists.mts"],"sourcesContent":[null],"names":["fs"],"mappings":";;;AAGA;;;;AAIG;MACU,UAAU,GAAG,OAAO,QAAgB,KAAsB;AACrE,IAAA,IAAI;AACF,QAAA,MAAMA,GAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;AACzB,QAAA,OAAO,IAAI;;AACX,IAAA,MAAM;AACN,QAAA,OAAO,KAAK;;AAEhB;AAEA;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,OAC9B,QAAgB,EAChB,WAAW,GAAG,MAAM,KACH;IACjB,IAAI,EAAE,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE;AACjC,QAAA,IAAI,CAAC,CAAG,EAAA,WAAW,oBAAoB,QAAQ,CAAA,CAAE,CAAC;AAClD,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;;AAEnB;;;;"}

package/dist/functions/assert-repo-is-dirty.d.mts

@@ -7,7 +7,7 @@ import '../node-global.mjs';
 export declare const repoIsDirty: () => Promise<boolean>;
 /**
  * Checks if the repository is dirty and exits with code 1 if it is.
- * @throws Error if git command fails.
+ * Shows git status and diff output before exiting.
  */
 export declare const assertRepoIsDirty: () => Promise<void>;
 //# sourceMappingURL=assert-repo-is-dirty.d.mts.map

package/dist/functions/assert-repo-is-dirty.mjs

@@ -11,7 +11,7 @@ const repoIsDirty = async () => {
 };
 /**
  * Checks if the repository is dirty and exits with code 1 if it is.
- * @throws Error if git command fails.
+ * Shows git status and diff output before exiting.
  */
 const assertRepoIsDirty = async () => {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-repo-utils",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "private": false,
   "keywords": [
     "typescript"

package/src/functions/assert-ext.mts

@@ -18,8 +18,8 @@ export type CheckExtConfig = DeepReadonly<{
 
 /**
  * Validates that all files in specified directories have the correct extensions.
+ * Exits with code 1 if any files have incorrect extensions.
  * @param config - Configuration specifying directories and expected extensions.
- * @throws Error with details of all incorrect files found.
  */
 export const assertExt = async (config: CheckExtConfig): Promise<void> => {
   const allIncorrectFiles: string[] = [];
@@ -76,7 +76,8 @@ export const assertExt = async (config: CheckExtConfig): Promise<void> => {
       generateErrorMessage(),
     ].join('\n');
 
-    throw new Error(errorMessage);
+    echo(errorMessage);
+    process.exit(1);
   }
 
   echo('✓ All files have correct extensions');

package/src/functions/assert-path-exists.mts

@@ -1,4 +1,5 @@
 import * as fs from 'node:fs/promises';
+import '../node-global.mjs';
 
 /**
  * Checks if a file or directory exists.
@@ -15,16 +16,16 @@ export const pathExists = async (filePath: string): Promise<boolean> => {
 };
 
 /**
- * Validates that a path exists and throws if it doesn't.
+ * Validates that a path exists and exits with code 1 if it doesn't.
  * @param filePath - The path to validate.
- * @param description - Description for error message.
- * @throws Error if path doesn't exist.
+ * @param description - Description for error message (defaults to 'Path').
  */
 export const assertPathExists = async (
   filePath: string,
   description = 'Path',
 ): Promise<void> => {
   if (!(await pathExists(filePath))) {
-    throw new Error(`${description} does not exist: ${filePath}`);
+    echo(`${description} does not exist: ${filePath}`);
+    process.exit(1);
   }
 };

package/src/functions/assert-repo-is-dirty.mts

@@ -12,7 +12,7 @@ export const repoIsDirty = async (): Promise<boolean> => {
 
 /**
  * Checks if the repository is dirty and exits with code 1 if it is.
- * @throws Error if git command fails.
+ * Shows git status and diff output before exiting.
  */
 export const assertRepoIsDirty = async (): Promise<void> => {
   try {