@adamhl8/configs 2.2.0 → 2.2.1

package/README.md

@@ -35,7 +35,7 @@ Scripts live in a shared [`just`](https://github.com/casey/just) base justfile i
 import "node_modules/@adamhl8/configs/dist/configs/justfile.base.just"
 ```
 
-It provides `lint`, `build`, `test`, `bump-deps`, `release`, `release-run`, and `prepare`. Run `just` to list them. `build` only runs `tsdown` if the project has a `tsdown.config.ts`, and `test` (`bun test`) passes when there are no tests, so projects without a build step or tests can use them as-is.
+It provides `lint`, `build`, `test`, `bump-deps`, `release`, `release-run`, `tofu-check`, and `prepare`. Run `just` to list them. The recipes degrade gracefully so projects can use them as-is: `build` only runs `tsdown` if the project has a `tsdown.config.ts`, `test` (`bun test`) passes when there are no tests, and `tofu-check` (a `tofu plan` drift check, which `build` also runs) skips itself unless run locally in a project with `.tofu` files.
 
 To customize a recipe, redefine it in your `justfile`. Each public recipe is a thin wrapper over a private `_recipe` that holds the actual body, so an override can still run the original instead of copying it:
 
@@ -109,7 +109,7 @@ const config = tsdownConfig({ ... })
 export default defineConfig(config)
 ```
 
-`tsdownBinConfig` is also exported for building `package.json` bin executables: a bundled, single-file, extensionless build with no type declarations.
+`tsdownBundleConfig` is also exported for single-file bundles that aren't published libraries: everything is bundled, with no type declarations or publish checks. `tsdownBinConfig` builds `package.json` bin executables: the same bundle for node, with an extensionless output file.
 
 ### commitlint
 
@@ -174,6 +174,24 @@ dist/
 
 Everything below the marker is left untouched. The sync can also be run manually by running `adamhl8-gitignore`.
 
+### env
+
+Utilities for validated environment variables, exported from the `/env` subpath:
+
+```ts
+import { parseEnv, requireWhen } from "@adamhl8/configs/env"
+
+const isProd = process.env["NODE_ENV"] === "production"
+
+export const env = parseEnv({
+  API_URL: "string.url",
+  // required in production, optional otherwise
+  SENTRY_DSN: requireWhen(isProd, "string.url"),
+})
+```
+
+`parseEnv` is `arkenv` with friendlier failures: invalid env prints the validation message and exits instead of throwing. `requireWhen` makes a var required while its condition is true and optional otherwise. An optional third argument supplies a fallback for when the var is unset (the fallback is exempt from validation, a set value never is).
+
 ## GitHub Actions
 
 This repo hosts three reusable workflows you can call from other projects instead of copy/pasting them. The calling project must use `bun`, have a `justfile` that imports the base justfile (see [just](#just)), and have a commitlint config (e.g. via these configs). The workflows set up bun and install just and lefthook themselves.

package/dist/configs/tsdown.base.d.ts

@@ -26,6 +26,7 @@ declare const baseConfig: {
   };
   readonly publint: true;
   readonly failOnWarn: true;
+  readonly suppressWarnings: ["does not yet have a stable API"];
 };
 type StrictBundleConfig = SetRequired<UserConfig, "platform" | "entry">;
 declare const bundleConfig: {
@@ -38,6 +39,7 @@ declare const bundleConfig: {
     readonly neverBundle: ["bun"];
   };
   readonly failOnWarn: true;
+  readonly suppressWarnings: ["does not yet have a stable API"];
   readonly entry: [];
   readonly unbundle: false;
   readonly sourcemap: false;
@@ -60,6 +62,7 @@ declare const binConfig: {
     readonly neverBundle: ["bun"];
   };
   readonly failOnWarn: true;
+  readonly suppressWarnings: ["does not yet have a stable API"];
   readonly entry: [];
   readonly unbundle: false;
   readonly sourcemap: false;

package/dist/configs/tsdown.base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tsdown.base.d.ts","names":[],"sources":["../../src/configs/tsdown.base.ts"],"mappings":";;;;KAOK,eAAe,YAAY;cAE1B;;;;;;;;;;aAUF;aACA;aACA;;;aAGA;;;aAGA;aACA;;;;;KAOC,qBAAqB,YAAY;cAGhC;;;;;;;aAdF;;;;;;;;;;aAuBA;eACE;;;;KAMD,kBAAkB,YAAY;cAG7B;;;;;;aAjCF;;;;;;;;;;aAuBA;eACE;;;;;;;;cAiBO,cAAc,cAAc,qBAAqB;cAKjD,oBAAoB,cAAc,2BAA2B;cAK7D,iBAAiB,cAAc,wBAAwB"}
+{"version":3,"file":"tsdown.base.d.ts","names":[],"sources":["../../src/configs/tsdown.base.ts"],"mappings":";;;;KAOK,eAAe,YAAY;cAE1B;;;;;;;;;;aAUF;aACA;aACA;;;aAGA;;;aAGA;aACA;;;;;;KAQC,qBAAqB,YAAY;cAGhC;;;;;;;aAfF;;;;;;;;;;;aAwBA;eACE;;;;KAMD,kBAAkB,YAAY;cAG7B;;;;;;aAlCF;;;;;;;;;;;aAwBA;eACE;;;;;;;;cAiBO,cAAc,cAAc,qBAAqB;cAKjD,oBAAoB,cAAc,2BAA2B;cAK7D,iBAAiB,cAAc,wBAAwB"}

package/dist/configs/tsdown.base.js

@@ -20,7 +20,8 @@ const baseConfig = {
 		profile: "esm-only"
 	},
 	publint: true,
-	failOnWarn: true
+	failOnWarn: true,
+	suppressWarnings: ["does not yet have a stable API"]
 };
 const bundleConfig = {
 	...baseConfig,

package/dist/configs/tsdown.base.js.map

@@ -1 +1 @@
-{"version":3,"file":"tsdown.base.js","names":[],"sources":["../../src/configs/tsdown.base.ts"],"sourcesContent":["import type { UserConfig } from \"tsdown\"\nimport type { SetRequired } from \"type-fest\"\n\nimport type { MergeConfigFn } from \"#merge-config/merge-config.ts\"\nimport { createMergeConfigFn } from \"#merge-config/merge-config.ts\"\n\n// Force projects to specify platform\ntype StrictConfig = SetRequired<UserConfig, \"platform\">\n\nconst baseConfig = {\n  entry: [\"./src/index.ts\"],\n  platform: \"neutral\",\n  target: false,\n  unbundle: true,\n  sourcemap: true,\n  minify: \"dce-only\",\n  fixedExtension: false,\n  hash: false,\n  dts: {\n    newContext: true,\n    tsgo: true,\n    sourcemap: true,\n  },\n  deps: {\n    neverBundle: [\"bun\"],\n  },\n  attw: {\n    level: \"error\",\n    profile: \"esm-only\",\n  },\n  publint: true,\n  failOnWarn: true,\n} as const satisfies StrictConfig\n\n// Force projects to specify platform and entry\ntype StrictBundleConfig = SetRequired<UserConfig, \"platform\" | \"entry\">\n\n// Single-file bundle (not a published library): bundle everything, drop types/lint/sourcemap.\nconst bundleConfig = {\n  ...baseConfig,\n  entry: [],\n  unbundle: false,\n  sourcemap: false,\n  dts: false,\n  attw: false,\n  publint: false,\n  inputOptions: {\n    experimental: {\n      attachDebugInfo: \"none\", // remove region comments from bundled output\n    },\n  },\n} as const satisfies StrictBundleConfig\n\n// Force projects to specify platform and entry\ntype StrictBinConfig = SetRequired<UserConfig, \"entry\">\n\n// A bin is a node bundle with no output file extension.\nconst binConfig = {\n  ...bundleConfig,\n  platform: \"node\",\n  outExtensions: () => ({ js: \"\" }) as const,\n} as const satisfies StrictBinConfig\n\n// The export annotations forbid the no-arg call (platform/entry must be provided) and are load-bearing for\n// declaration emit: without one, tsgo synthesizes the type and fails with TS2883 on tsdown's non-exported internals.\nexport const tsdownConfig: MergeConfigFn<StrictConfig, typeof baseConfig> = createMergeConfigFn<\n  StrictConfig,\n  typeof baseConfig\n>(baseConfig)\n\nexport const tsdownBundleConfig: MergeConfigFn<StrictBundleConfig, typeof bundleConfig> = createMergeConfigFn<\n  StrictBundleConfig,\n  typeof bundleConfig\n>(bundleConfig)\n\nexport const tsdownBinConfig: MergeConfigFn<StrictBinConfig, typeof binConfig> = createMergeConfigFn<\n  StrictBinConfig,\n  typeof binConfig\n>(binConfig)\n"],"mappings":";;AASA,MAAM,aAAa;CACjB,OAAO,CAAC,gBAAgB;CACxB,UAAU;CACV,QAAQ;CACR,UAAU;CACV,WAAW;CACX,QAAQ;CACR,gBAAgB;CAChB,MAAM;CACN,KAAK;EACH,YAAY;EACZ,MAAM;EACN,WAAW;CACb;CACA,MAAM,EACJ,aAAa,CAAC,KAAK,EACrB;CACA,MAAM;EACJ,OAAO;EACP,SAAS;CACX;CACA,SAAS;CACT,YAAY;AACd;AAMA,MAAM,eAAe;CACnB,GAAG;CACH,OAAO,CAAC;CACR,UAAU;CACV,WAAW;CACX,KAAK;CACL,MAAM;CACN,SAAS;CACT,cAAc,EACZ,cAAc,EACZ,iBAAiB,OACnB,EACF;AACF;AAMA,MAAM,YAAY;CAChB,GAAG;CACH,UAAU;CACV,sBAAsB,EAAE,IAAI,GAAG;AACjC;AAIA,MAAa,eAA+D,oBAG1E,UAAU;AAEZ,MAAa,qBAA6E,oBAGxF,YAAY;AAEd,MAAa,kBAAoE,oBAG/E,SAAS"}
+{"version":3,"file":"tsdown.base.js","names":[],"sources":["../../src/configs/tsdown.base.ts"],"sourcesContent":["import type { UserConfig } from \"tsdown\"\nimport type { SetRequired } from \"type-fest\"\n\nimport type { MergeConfigFn } from \"#merge-config/merge-config.ts\"\nimport { createMergeConfigFn } from \"#merge-config/merge-config.ts\"\n\n// Force projects to specify platform\ntype StrictConfig = SetRequired<UserConfig, \"platform\">\n\nconst baseConfig = {\n  entry: [\"./src/index.ts\"],\n  platform: \"neutral\",\n  target: false,\n  unbundle: true,\n  sourcemap: true,\n  minify: \"dce-only\",\n  fixedExtension: false,\n  hash: false,\n  dts: {\n    newContext: true,\n    tsgo: true,\n    sourcemap: true,\n  },\n  deps: {\n    neverBundle: [\"bun\"],\n  },\n  attw: {\n    level: \"error\",\n    profile: \"esm-only\",\n  },\n  publint: true,\n  failOnWarn: true,\n  suppressWarnings: [\"does not yet have a stable API\"],\n} as const satisfies StrictConfig\n\n// Force projects to specify platform and entry\ntype StrictBundleConfig = SetRequired<UserConfig, \"platform\" | \"entry\">\n\n// Single-file bundle (not a published library): bundle everything, drop types/lint/sourcemap.\nconst bundleConfig = {\n  ...baseConfig,\n  entry: [],\n  unbundle: false,\n  sourcemap: false,\n  dts: false,\n  attw: false,\n  publint: false,\n  inputOptions: {\n    experimental: {\n      attachDebugInfo: \"none\", // remove region comments from bundled output\n    },\n  },\n} as const satisfies StrictBundleConfig\n\n// Force projects to specify platform and entry\ntype StrictBinConfig = SetRequired<UserConfig, \"entry\">\n\n// A bin is a node bundle with no output file extension.\nconst binConfig = {\n  ...bundleConfig,\n  platform: \"node\",\n  outExtensions: () => ({ js: \"\" }) as const,\n} as const satisfies StrictBinConfig\n\n// The export annotations forbid the no-arg call (platform/entry must be provided) and are load-bearing for\n// declaration emit: without one, tsgo synthesizes the type and fails with TS2883 on tsdown's non-exported internals.\nexport const tsdownConfig: MergeConfigFn<StrictConfig, typeof baseConfig> = createMergeConfigFn<\n  StrictConfig,\n  typeof baseConfig\n>(baseConfig)\n\nexport const tsdownBundleConfig: MergeConfigFn<StrictBundleConfig, typeof bundleConfig> = createMergeConfigFn<\n  StrictBundleConfig,\n  typeof bundleConfig\n>(bundleConfig)\n\nexport const tsdownBinConfig: MergeConfigFn<StrictBinConfig, typeof binConfig> = createMergeConfigFn<\n  StrictBinConfig,\n  typeof binConfig\n>(binConfig)\n"],"mappings":";;AASA,MAAM,aAAa;CACjB,OAAO,CAAC,gBAAgB;CACxB,UAAU;CACV,QAAQ;CACR,UAAU;CACV,WAAW;CACX,QAAQ;CACR,gBAAgB;CAChB,MAAM;CACN,KAAK;EACH,YAAY;EACZ,MAAM;EACN,WAAW;CACb;CACA,MAAM,EACJ,aAAa,CAAC,KAAK,EACrB;CACA,MAAM;EACJ,OAAO;EACP,SAAS;CACX;CACA,SAAS;CACT,YAAY;CACZ,kBAAkB,CAAC,gCAAgC;AACrD;AAMA,MAAM,eAAe;CACnB,GAAG;CACH,OAAO,CAAC;CACR,UAAU;CACV,WAAW;CACX,KAAK;CACL,MAAM;CACN,SAAS;CACT,cAAc,EACZ,cAAc,EACZ,iBAAiB,OACnB,EACF;AACF;AAMA,MAAM,YAAY;CAChB,GAAG;CACH,UAAU;CACV,sBAAsB,EAAE,IAAI,GAAG;AACjC;AAIA,MAAa,eAA+D,oBAG1E,UAAU;AAEZ,MAAa,qBAA6E,oBAGxF,YAAY;AAEd,MAAa,kBAAoE,oBAG/E,SAAS"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adamhl8/configs",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "My shared configs for TS projects",
   "homepage": "https://github.com/adamhl8/configs",
   "bugs": {
@@ -46,14 +46,14 @@
     "prepare": "just prepare"
   },
   "dependencies": {
-    "@adamhl8/eslint-plugin-clean-modules": "^0.1.4",
+    "@adamhl8/eslint-plugin-clean-modules": "^0.1.5",
     "@commitlint/config-conventional": "^21.2.0",
     "@commitlint/types": "^21.2.0",
     "arkenv": "^0.12.2",
     "arktype": "^2.2.3",
     "es-toolkit": "^1.49.0",
     "smol-toml": "^1.7.0",
-    "ts-explicit-errors": "^4.1.2",
+    "ts-explicit-errors": "^4.1.3",
     "ts-extras": "^1.2.0",
     "type-fest": "^5.8.0"
   },
@@ -69,7 +69,7 @@
     "oxlint-tsgolint": "^0.24.0",
     "publint": "^0.3.21",
     "release-it": "^20.2.1",
-    "tsdown": "^0.22.5",
+    "tsdown": "^0.22.7",
     "typescript": "^7.0.2"
   },
   "peerDependencies": {