@savvy-web/silk-effects 7.5.2 → 8.0.0

package/changesets/api/changelog.js

@@ -1,4 +1,4 @@
-import changelogFunctions from "../changelog/index.js";
+import { makeChangelogFunctions } from "../changelog/index.js";
 
 //#region src/changesets/api/changelog.ts
 /**
@@ -103,10 +103,13 @@ var Changelog = class {
 	* @param versionType - The semantic version bump type (`"major"`, `"minor"`, or `"patch"`)
 	* @param options - Configuration object; must include `repo` in `"owner/repo"` format.
 	*   Pass `null` to use defaults (no GitHub link resolution).
+	* @param logMode - How a failed GitHub lookup is reported (`"stderr"` when omitted);
+	*   the host reads its own environment and passes `"github"` / `"silent"` — this
+	*   engine never does. See `ChangesetLogMode`.
 	* @returns A promise resolving to the formatted markdown string
 	*/
-	static async formatReleaseLine(changeset, versionType, options) {
-		return changelogFunctions.getReleaseLine(changeset, versionType, options);
+	static async formatReleaseLine(changeset, versionType, options, logMode) {
+		return makeChangelogFunctions(logMode === void 0 ? {} : { logMode }).getReleaseLine(changeset, versionType, options);
 	}
 	/**
 	* Format dependency update release lines into a markdown table.
@@ -121,11 +124,13 @@ var Changelog = class {
 	*   old/new versions and package metadata
 	* @param options - Configuration object; must include `repo` in `"owner/repo"` format.
 	*   Pass `null` to use defaults.
+	* @param logMode - How a failed GitHub lookup is reported (`"stderr"` when omitted);
+	*   see {@link Changelog.formatReleaseLine}.
 	* @returns A promise resolving to the formatted markdown string containing
 	*   the dependency update table
 	*/
-	static async formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
-		return changelogFunctions.getDependencyReleaseLine(changesets, dependenciesUpdated, options);
+	static async formatDependencyReleaseLine(changesets, dependenciesUpdated, options, logMode) {
+		return makeChangelogFunctions(logMode === void 0 ? {} : { logMode }).getDependencyReleaseLine(changesets, dependenciesUpdated, options);
 	}
 };
 

package/changesets/changelog/getReleaseLine.js

@@ -1,10 +1,10 @@
 import { resolveCommitType } from "../categories/index.js";
 import { GitHubService } from "../services/github.js";
+import { logWarning } from "../utils/logger.js";
 import { parseMarkdown, stringifyMarkdown } from "../utils/remark-pipeline.js";
 import { GitHubInfoSchema } from "../schemas/github.js";
 import { parseCommitMessage } from "../utils/commit-parser.js";
 import { parseIssueReferences } from "../utils/issue-refs.js";
-import { logWarning } from "../utils/logger.js";
 import { parseChangesetSections } from "../utils/section-parser.js";
 import { formatChangelogEntry, formatPRAndUserAttribution } from "./formatting.js";
 import { Effect, Schema } from "effect";
@@ -177,10 +177,7 @@ function getReleaseLine(changeset, versionType, options) {
 		if (changeset.commit) commitInfo = yield* (yield* GitHubService).getInfo({
 			commit: changeset.commit,
 			repo: options.repo
-		}).pipe(Effect.flatMap((raw) => Schema.decodeUnknownEffect(GitHubInfoSchema)(raw).pipe(Effect.map(() => raw), Effect.catch(() => Effect.succeed(raw)))), Effect.catch((error) => {
-			logWarning("Could not fetch GitHub info for commit:", changeset.commit ?? "", String(error));
-			return Effect.succeed(null);
-		}));
+		}).pipe(Effect.flatMap((raw) => Schema.decodeUnknownEffect(GitHubInfoSchema)(raw).pipe(Effect.map(() => raw), Effect.catch(() => Effect.succeed(raw)))), Effect.catch((error) => logWarning("Could not fetch GitHub info for commit:", changeset.commit ?? "", String(error)).pipe(Effect.as(null))));
 		const parsed = parseChangesetSections(changeset.summary);
 		const firstLine = changeset.summary.split("\n")[0];
 		const commitMsg = parseCommitMessage(firstLine);

package/changesets/changelog/index.js

@@ -1,5 +1,6 @@
 import { validateChangesetOptions } from "../schemas/options.js";
 import { GitHubService } from "../services/github.js";
+import { ChangesetLogMode } from "../utils/logger.js";
 import { getDependencyReleaseLine } from "./getDependencyReleaseLine.js";
 import { getReleaseLine } from "./getReleaseLine.js";
 import { Effect } from "effect";
@@ -67,31 +68,50 @@ import { Effect } from "effect";
 */
 const MainLayer = GitHubService.layer;
 /**
-* Changesets API `ChangelogFunctions` implementation.
+* Build a Changesets `ChangelogFunctions` implementation bound to a warning
+* mode.
 *
-* This object satisfies the `ChangelogFunctions` contract from
-* `\@changesets/types`. Each method validates options, runs the
-* corresponding Effect program with the merged service layer, and
-* returns a `Promise<string>`.
+* @remarks
+* This module is engine code and reads no environment; the host that installs
+* the functions (the `\@savvy-web/changelog` package under the changesets CLI)
+* decides the mode from its own `process.env` and passes it here. Each method
+* validates options, runs the corresponding Effect program with the merged
+* service layer and the chosen {@link ChangesetLogMode}, and returns a
+* `Promise<string>`.
 *
-* @internal
+* @param options - The warning mode to provide
+* @returns A `ChangelogFunctions` object for `.changeset/config.json`
+*
+* @public
 */
-const changelogFunctions = {
-	getReleaseLine: async (changeset, versionType, options) => {
-		const program = Effect.gen(function* () {
+function makeChangelogFunctions(options = {}) {
+	const run = (program) => {
+		const provided = program.pipe(Effect.provide(MainLayer));
+		return Effect.runPromise(options.logMode === void 0 ? provided : provided.pipe(Effect.provideService(ChangesetLogMode, options.logMode)));
+	};
+	return {
+		getReleaseLine: async (changeset, versionType, options) => run(Effect.gen(function* () {
 			const opts = yield* validateChangesetOptions(options);
 			return yield* getReleaseLine(changeset, versionType, opts);
-		});
-		return Effect.runPromise(program.pipe(Effect.provide(MainLayer)));
-	},
-	getDependencyReleaseLine: async (changesets, dependenciesUpdated, options) => {
-		const program = Effect.gen(function* () {
+		})),
+		getDependencyReleaseLine: async (changesets, dependenciesUpdated, options) => run(Effect.gen(function* () {
 			const opts = yield* validateChangesetOptions(options);
 			return yield* getDependencyReleaseLine(changesets, dependenciesUpdated, opts);
-		});
-		return Effect.runPromise(program.pipe(Effect.provide(MainLayer)));
-	}
-};
+		}))
+	};
+}
+/**
+* Changesets API `ChangelogFunctions` implementation with the default warning
+* mode (`"stderr"`).
+*
+* @remarks
+* Equivalent to `makeChangelogFunctions()`. A host that runs under GitHub
+* Actions or a test runner should call {@link makeChangelogFunctions} with the
+* mode it detects instead.
+*
+* @internal
+*/
+const changelogFunctions = makeChangelogFunctions();
 
 //#endregion
-export { changelogFunctions as default };
+export { changelogFunctions as default, makeChangelogFunctions };

package/changesets/index.js

@@ -5,11 +5,12 @@ import { JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema
 import { GlobSchema, PackageScopeSchema, PackagesRecordSchema } from "./schemas/package-scope.js";
 import { ChangesetOptionsSchema, RepoSchema } from "./schemas/options.js";
 import { GitHubService, makeGitHubTest } from "./services/github.js";
+import { ChangesetLogMode } from "./utils/logger.js";
 import { NonEmptyString, PositiveInteger } from "./schemas/primitives.js";
 import { DependencyActionSchema, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, VERSION_RE, VersionOrEmptySchema } from "./schemas/dependency-table.js";
 import { serializeDependencyTableToMarkdown } from "./utils/dependency-table.js";
 import { GitHubInfoSchema, IssueNumberSchema, UrlOrMarkdownLinkSchema, UsernameSchema } from "./schemas/github.js";
-import changelogFunctions from "./changelog/index.js";
+import changelogFunctions, { makeChangelogFunctions } from "./changelog/index.js";
 import { Changelog } from "./api/changelog.js";
 import { DependencyTable } from "./api/dependency-table.js";
 import { ContentStructureRule } from "./remark/rules/content-structure.js";
@@ -66,6 +67,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	ChangelogTransformer: () => ChangelogTransformer,
 	ChangesetIOError: () => ChangesetIOError,
 	ChangesetLinter: () => ChangesetLinter,
+	ChangesetLogMode: () => ChangesetLogMode,
 	ChangesetOptionsSchema: () => ChangesetOptionsSchema,
 	ChangesetPreviewSchema: () => ChangesetPreviewSchema,
 	ChangesetSchema: () => ChangesetSchema,
@@ -152,6 +154,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	isPureDependencyChangeset: () => isPureDependencyChangeset,
 	listPublishablePackageNames: () => listPublishablePackageNames,
 	makeBranchAnalyzerTest: () => makeBranchAnalyzerTest,
+	makeChangelogFunctions: () => makeChangelogFunctions,
 	makeConfigInspectorTest: () => makeConfigInspectorTest,
 	makeDepsRegenDefault: () => makeDepsRegenDefault,
 	makeGitHubTest: () => makeGitHubTest,
@@ -162,4 +165,4 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 });
 
 //#endregion
-export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, CoexistingChangesetSchema, CommitHashSchema, ConfigInspector, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, FileStatusSchema, GitError, GitHubApiError, GitHubInfoSchema, GitHubService, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownParseError, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema, ReleasePlanError, ReleasePlanner, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };
+export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogTransformer, ChangesetIOError, ChangesetLinter, ChangesetLogMode, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ClassificationReasonSchema, ClassificationSchema, CoexistingChangesetSchema, CommitHashSchema, ConfigInspector, ConfigurationError, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenDefault, FileStatusSchema, GitError, GitHubApiError, GitHubInfoSchema, GitHubService, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownParseError, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, RegenDiffRowSchema, RegenPlanSchema, RegenResultSchema, ReleasePlanError, ReleasePlanner, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeChangelogFunctions, makeConfigInspectorTest, makeDepsRegenDefault, makeGitHubTest, makeReleasePlannerTest, parseChangesetPackages, serializeDependencyTableToMarkdown, vanillaChangelogFunctions };

package/changesets/utils/logger.js

@@ -1,37 +1,64 @@
+import { Context, Effect } from "effect";
+
 //#region src/changesets/utils/logger.ts
 /**
-* Log a warning message.
+* Warning output for changelog generation, parameterised by a
+* {@link ChangesetLogMode} reference instead of an ambient environment read.
 *
 * @remarks
-* Detection order:
-* 1. If `process.env.VITEST` is set, the message is silently discarded.
-* 2. If `process.env.GITHUB_ACTIONS === "true"`, the message is emitted
-*    as a `::warning::` annotation.
-* 3. Otherwise, `console.warn` is used.
+* This module is engine code shared by every front end, so it must not read
+* `process` — a `process.env` read here would bake one host's environment
+* into every other. The mode is a `Context.Reference` with a default of
+* `"stderr"`; a front end that knows it runs under GitHub Actions or a test
+* runner provides `"github"` or `"silent"` from its own `process.env` read.
 *
-* @param message - The warning message
-* @param args - Additional arguments (concatenated with a space in CI mode)
+* @packageDocumentation
+*/
+/**
+* The reference that selects the {@link ChangesetLogModeValue}.
+*
+* @remarks
+* Defaults to `"stderr"` when no front end provides it, so a program that
+* never touches the reference still reports. Provide with
+* `Layer.succeed(ChangesetLogMode, "github")` or
+* `Effect.provideService(ChangesetLogMode, "silent")`.
 *
 * @example
 * ```typescript
-* import { logWarning } from "../utils/logger.js";
+* import { Effect } from "effect";
+* import { Changesets } from "\@savvy-web/silk-effects";
 *
-* logWarning("Duplicate dependency entry", "effect@3.19.0");
-* // In CI: "::warning::Duplicate dependency entry effect@3.19.0"
-* // Locally: console.warn("Duplicate dependency entry", "effect@3.19.0")
+* const mode = process.env.GITHUB_ACTIONS === "true" ? "github" : "stderr";
+* program.pipe(Effect.provideService(Changesets.ChangesetLogMode, mode));
 * ```
 *
+* @public
+*/
+const ChangesetLogMode = Context.Reference("@savvy-web/silk-effects/Changesets/ChangesetLogMode", { defaultValue: () => "stderr" });
+/**
+* Log a warning message according to the {@link ChangesetLogMode} in context.
+*
+* @param message - The warning message
+* @param args - Additional arguments (concatenated with a space in `"github"` mode)
+* @returns An `Effect` that never fails
+*
 * @internal
 */
 function logWarning(message, ...args) {
-	/* v8 ignore start — environment-specific */
-	if (typeof process !== "undefined" && process.env.VITEST) return;
-	if (typeof process !== "undefined" && process.env.GITHUB_ACTIONS === "true") {
-		const text = args.length > 0 ? `${message} ${args.join(" ")}` : message;
-		console.warn(`::warning::${text}`);
-	} else console.warn(message, ...args);
-	/* v8 ignore stop */
+	return Effect.gen(function* () {
+		switch (yield* ChangesetLogMode) {
+			case "silent": return;
+			case "github": {
+				const text = args.length > 0 ? `${message} ${args.join(" ")}` : message;
+				console.warn(`::warning::${text}`);
+				return;
+			}
+			case "stderr":
+				console.warn(message, ...args);
+				return;
+		}
+	});
 }
 
 //#endregion
-export { logWarning };
+export { ChangesetLogMode, logWarning };