@savvy-web/silk 2.0.0 → 2.1.0

package/packages/silk-effects/dist/dev/pkg/changesets/errors.cjs

@@ -1,386 +0,0 @@
-let effect = require("effect");
-
-//#region ../silk-effects/dist/dev/pkg/changesets/errors.js
-/**
-* Tagged errors for \@savvy-web/changesets.
-*
-* @remarks
-* All errors in this module extend Effect's `Data.TaggedError`, enabling
-* type-safe error handling via `Effect.catchTag`. Each error class carries
-* structured metadata (not just a string message) so that callers can
-* programmatically inspect failure details.
-*
-* The `*Base` exports are anonymous base classes generated by
-* `Data.TaggedError()`. They are exported solely for api-extractor
-* compatibility and should not be used directly.
-*
-* @see {@link https://effect.website/docs/data-types/data#taggerror | Effect TaggedError documentation}
-*
-*/
-/**
-* Base class for {@link ChangesetValidationError}.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Data.TaggedError creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const ChangesetValidationErrorBase = effect.Data.TaggedError("ChangesetValidationError");
-/**
-* Changeset file validation failure.
-*
-* @remarks
-* Raised when a changeset markdown file fails structural validation
-* (e.g., missing summary, invalid heading, malformed dependency table).
-* Carries an array of structured issues, each with a JSON-path pointing
-* to the problematic field and a human-readable message.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { ChangesetValidationError } from "@savvy-web/changesets";
-*
-* declare const program: Effect.Effect<void, ChangesetValidationError>;
-*
-* const handled = program.pipe(
-* 	Effect.catchTag("ChangesetValidationError", (err) => {
-* 		for (const issue of err.issues) {
-* 			console.error(`${issue.path}: ${issue.message}`);
-* 		}
-* 		return Effect.void;
-* 	}),
-* );
-* ```
-*
-* @see {@link ChangesetSchema} for the schema that drives validation
-*
-* @public
-*/
-var ChangesetValidationError = class extends ChangesetValidationErrorBase {
-	get message() {
-		return `${this.file ? `${this.file}: ` : ""}Changeset validation failed:\n${this.issues.map((i) => `  - ${i.path}: ${i.message}`).join("\n")}`;
-	}
-};
-/**
-* Base class for {@link GitHubApiError}.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Data.TaggedError creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const GitHubApiErrorBase = effect.Data.TaggedError("GitHubApiError");
-/**
-* GitHub API request failure.
-*
-* @remarks
-* Raised when a call to the GitHub API (via `\@changesets/get-github-info`)
-* fails due to network issues, authentication errors, rate limiting, or
-* server errors. Use the {@link GitHubApiError.isRetryable | isRetryable}
-* property to determine whether a retry strategy should be applied.
-* Rate-limited responses (403/429) and server errors (5xx) are considered
-* retryable.
-*
-* @example
-* ```typescript
-* import { Effect, Schedule } from "effect";
-* import { GitHubApiError } from "@savvy-web/changesets";
-*
-* declare const program: Effect.Effect<void, GitHubApiError>;
-*
-* const withRetry = program.pipe(
-* 	Effect.catchTag("GitHubApiError", (err) => {
-* 		if (err.isRetryable) {
-* 			return Effect.retry(program, Schedule.exponential("1 second"));
-* 		}
-* 		return Effect.fail(err);
-* 	}),
-* );
-* ```
-*
-* @see {@link GitHubService} for the Effect service that may produce this error
-*
-* @public
-*/
-var GitHubApiError = class extends GitHubApiErrorBase {
-	get message() {
-		const status = this.statusCode ? ` (${this.statusCode})` : "";
-		return `GitHub API error during ${this.operation}${status}: ${this.reason}`;
-	}
-	/** Whether this error is a rate-limit response (403 or 429). */
-	get isRateLimited() {
-		return this.statusCode === 403 || this.statusCode === 429;
-	}
-	/** Whether this error is eligible for retry (server errors or rate limits). */
-	get isRetryable() {
-		return this.statusCode !== void 0 && (this.statusCode >= 500 || this.isRateLimited);
-	}
-};
-/**
-* Base class for {@link MarkdownParseError}.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Data.TaggedError creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const MarkdownParseErrorBase = effect.Data.TaggedError("MarkdownParseError");
-/**
-* Markdown parsing failure.
-*
-* @remarks
-* Raised when a markdown file cannot be parsed into an AST by the unified/remark
-* pipeline. Carries optional source file location information (line, column)
-* for diagnostic display.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { MarkdownParseError } from "@savvy-web/changesets";
-*
-* declare const program: Effect.Effect<string, MarkdownParseError>;
-*
-* const handled = program.pipe(
-* 	Effect.catchTag("MarkdownParseError", (err) => {
-* 		console.error(err.message);
-* 		return Effect.succeed("");
-* 	}),
-* );
-* ```
-*
-* @see {@link MarkdownService} for the Effect service that may produce this error
-*
-* @public
-*/
-var MarkdownParseError = class extends MarkdownParseErrorBase {
-	get message() {
-		const loc = this.line ? `:${this.line}${this.column ? `:${this.column}` : ""}` : "";
-		return `${this.source ? `${this.source}${loc}: ` : ""}Markdown parse error: ${this.reason}`;
-	}
-};
-/**
-* Base class for {@link ConfigurationError}.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Data.TaggedError creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const ConfigurationErrorBase = effect.Data.TaggedError("ConfigurationError");
-/**
-* Invalid or missing configuration.
-*
-* @remarks
-* Raised when the changeset configuration (typically from `.changeset/config.json`)
-* is missing required fields, has invalid values, or cannot be parsed. The `field`
-* property identifies which configuration field is problematic, and `reason`
-* provides an actionable message.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { ConfigurationError, validateChangesetOptions } from "@savvy-web/changesets";
-*
-* const program = validateChangesetOptions({ repo: "invalid" }).pipe(
-* 	Effect.catchTag("ConfigurationError", (err) => {
-* 		console.error(`Field "${err.field}": ${err.reason}`);
-* 		return Effect.fail(err);
-* 	}),
-* );
-* ```
-*
-* @see {@link ChangesetOptionsSchema} for the expected configuration shape
-* @see {@link validateChangesetOptions} for the validation function that produces this error
-*
-* @public
-*/
-var ConfigurationError = class extends ConfigurationErrorBase {
-	get message() {
-		return `Configuration error (${this.field}): ${this.reason}`;
-	}
-};
-/**
-* Base class for {@link VersionFileError}.
-*
-* @privateRemarks
-* This export is required for api-extractor documentation generation.
-* Effect's Data.TaggedError creates an anonymous base class that must be
-* explicitly exported to avoid "forgotten export" warnings. Do not delete.
-*
-* @internal
-*/
-const VersionFileErrorBase = effect.Data.TaggedError("VersionFileError");
-/**
-* Version file update failure.
-*
-* @remarks
-* Raised when a JSON file targeted by the `versionFiles` configuration option
-* cannot be read, parsed, or updated at the specified JSONPath. Common causes
-* include missing files, invalid JSON, or JSONPath expressions that do not
-* match any field in the target file.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { VersionFileError } from "@savvy-web/changesets";
-*
-* declare const program: Effect.Effect<void, VersionFileError>;
-*
-* const handled = program.pipe(
-* 	Effect.catchTag("VersionFileError", (err) => {
-* 		console.error(`Failed to update ${err.filePath}: ${err.reason}`);
-* 		if (err.jsonPath) {
-* 			console.error(`  at JSONPath: ${err.jsonPath}`);
-* 		}
-* 		return Effect.void;
-* 	}),
-* );
-* ```
-*
-* @see {@link VersionFilesSchema} for the configuration that drives version file updates
-* @see {@link JsonPathSchema} for JSONPath expression validation
-*
-* @public
-*/
-var VersionFileError = class extends VersionFileErrorBase {
-	get message() {
-		const path = this.jsonPath ? ` at ${this.jsonPath}` : "";
-		return `Version file error (${this.filePath}${path}): ${this.reason}`;
-	}
-};
-/**
-* Base class for {@link GitError}.
-*
-* @privateRemarks
-* Effect's `Data.TaggedError` creates an anonymous base class that
-* api-extractor cannot follow without an explicit export.
-*
-* @internal
-*/
-const GitErrorBase = effect.Data.TaggedError("GitError");
-/**
-* Git command failure.
-*
-* @remarks
-* Raised by services that shell out to `git` — `BranchAnalyzer` is the
-* canonical consumer. Captures the failing command, the working directory
-* it was invoked in, and the underlying reason (often the captured stderr
-* from the child process) so callers can produce actionable diagnostics.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { GitError } from "@savvy-web/changesets";
-*
-* declare const program: Effect.Effect<void, GitError>;
-*
-* const handled = program.pipe(
-*   Effect.catchTag("GitError", (err) =>
-*     Effect.logError(`git failed in ${err.cwd}: ${err.command}\n${err.reason}`)
-*   ),
-* );
-* ```
-*
-* @see {@link BranchAnalyzer} which produces these errors when computing
-*   merge bases or running `git diff`
-*
-* @public
-*/
-var GitError = class extends GitErrorBase {
-	get message() {
-		return `git command failed in ${this.cwd}: ${this.command}\n${this.reason}`;
-	}
-};
-/**
-* Base class for {@link ChangesetIOError}.
-*
-* @privateRemarks
-* Effect's `Data.TaggedError` creates an anonymous base class that
-* api-extractor cannot follow without an explicit export.
-*
-* @internal
-*/
-const ChangesetIOErrorBase = effect.Data.TaggedError("ChangesetIOError");
-/**
-* Changeset file I/O failure.
-*
-* @remarks
-* Raised by {@link DepsRegen} when reading, writing, listing, or deleting
-* `.changeset/*.md` files fails. Deletion failures during
-* {@link DepsRegenShape.execute} are tolerated (stale changesets are
-* skip-and-continue, so an interrupted run stays safely re-runnable);
-* read, list, and write failures are loud.
-*
-* @example
-* ```typescript
-* import { Effect } from "effect";
-* import { ChangesetIOError } from "@savvy-web/changesets";
-*
-* declare const program: Effect.Effect<void, ChangesetIOError>;
-*
-* const handled = program.pipe(
-*   Effect.catchTag("ChangesetIOError", (err) =>
-*     Effect.logError(`changeset ${err.operation} failed at ${err.path}: ${err.reason}`)
-*   ),
-* );
-* ```
-*
-* @see {@link DepsRegen} which produces these errors during plan/execute
-*
-* @public
-*/
-var ChangesetIOError = class extends ChangesetIOErrorBase {
-	get message() {
-		return `changeset ${this.operation} failed at ${this.path}: ${this.reason}`;
-	}
-};
-/**
-* Base class for {@link ReleasePlanError}.
-*
-* @privateRemarks
-* Required export for api-extractor (anonymous Data.TaggedError base). Do not delete.
-*
-* @internal
-*/
-const ReleasePlanErrorBase = effect.Data.TaggedError("ReleasePlanError");
-/**
-* Release planning, preview, or apply failure.
-*
-* @remarks
-* Wraps any failure from the underlying `@changesets/*` machinery
-* (`getReleasePlan`, `applyReleasePlan`, config resolution) into a typed
-* Effect error, tagged with the phase that failed.
-*
-* @public
-*/
-var ReleasePlanError = class extends ReleasePlanErrorBase {
-	get message() {
-		return `Release plan error (${this.phase}): ${this.reason}`;
-	}
-};
-
-//#endregion
-exports.ChangesetIOError = ChangesetIOError;
-exports.ChangesetIOErrorBase = ChangesetIOErrorBase;
-exports.ChangesetValidationError = ChangesetValidationError;
-exports.ChangesetValidationErrorBase = ChangesetValidationErrorBase;
-exports.ConfigurationError = ConfigurationError;
-exports.ConfigurationErrorBase = ConfigurationErrorBase;
-exports.GitError = GitError;
-exports.GitErrorBase = GitErrorBase;
-exports.GitHubApiError = GitHubApiError;
-exports.GitHubApiErrorBase = GitHubApiErrorBase;
-exports.MarkdownParseError = MarkdownParseError;
-exports.MarkdownParseErrorBase = MarkdownParseErrorBase;
-exports.ReleasePlanError = ReleasePlanError;
-exports.ReleasePlanErrorBase = ReleasePlanErrorBase;
-exports.VersionFileError = VersionFileError;
-exports.VersionFileErrorBase = VersionFileErrorBase;