fireflyy 3.0.11 → 4.0.0-dev.352994a

package/dist/result.constructors-C9M1MP3_.js

@@ -0,0 +1,261 @@
+import { err, errAsync, ok, okAsync } from "neverthrow";
+import z$1 from "zod";
+
+//#region src/core/result/error.types.ts
+/**
+* Canonical list of Firefly error codes used for classification and handling.
+*
+* - `VALIDATION`: Input or schema validation failure.
+* - `NOT_FOUND`: Resource not present or lookup failed.
+* - `CONFLICT`: Business-logic or state conflicts.
+* - `IO`: I/O related errors such as file system or network failures.
+* - `TIMEOUT`: Operations that exceeded an allowed time window.
+* - `UNEXPECTED`: Unexpected or unknown errors.
+* - `FAILED`: Generic operation failure where a command or task returned an error code.
+* - `INVALID`: Invalid state or arguments not covered by `VALIDATION`.
+*/
+const FireflyErrorCodeSchema = z$1.enum([
+	"VALIDATION",
+	"NOT_FOUND",
+	"CONFLICT",
+	"IO",
+	"TIMEOUT",
+	"UNEXPECTED",
+	"FAILED",
+	"INVALID"
+]);
+/**
+* Standardized Firefly error shape validated using Zod. This object is the
+* canonical structure used throughout the codebase to represent errors.
+*
+* - `code`: One of `FireflyErrorCodeSchema` values that categorizes the error.
+* - `message`: A human-friendly explanatory message for the error.
+* - `details`: Optional additional structured or unstructured data with context.
+* - `cause`: Optional underlying error or value that caused this error (opaque).
+* - `retryable`: Optional boolean indicating whether the operation may be retried.
+* - `source`: Optional string describing the subsystem or module that emitted the error.
+*/
+const FireflyErrorSchema = z$1.object({
+	code: FireflyErrorCodeSchema,
+	message: z$1.string(),
+	details: z$1.unknown().optional(),
+	cause: z$1.unknown().optional(),
+	retryable: z$1.boolean().optional(),
+	source: z$1.string().optional()
+});
+
+//#endregion
+//#region src/core/result/error.factories.ts
+/**
+* Creates a frozen FireflyError instance with an attached stack trace.
+*
+* @param error - The FireflyError object to enhance.
+* @returns Frozen FireflyError with an optional stack trace.
+*/
+function createFireflyError(error) {
+	const err$1 = new Error(error.message, { cause: error.cause });
+	return Object.freeze({
+		...error,
+		stack: err$1.stack
+	});
+}
+/**
+* Converts an unknown error into a FireflyError.
+*
+* @param err - The unknown error to convert.
+* @param code - The FireflyErrorCode to assign.
+* @param source - The source of the error.
+* @returns FireflyError instance.
+*/
+function toFireflyError(err$1, code = "UNEXPECTED", source) {
+	const base = {
+		code,
+		message: err$1 instanceof Error ? err$1.message : String(err$1),
+		cause: err$1 instanceof Error ? err$1.cause : void 0,
+		source
+	};
+	return createFireflyError(FireflyErrorSchema.parse(base));
+}
+/**
+* Wraps an error message with additional context prefix.
+*
+* @param error - Original error
+* @param prefix - Message prefix to add
+* @returns New error with prefixed message
+*
+* @example
+* ```ts
+* const wrapped = wrapErrorMessage(error, "Failed to execute release");
+* // Result: "Failed to execute release: original message"
+* ```
+*/
+function wrapErrorMessage(error, prefix) {
+	return createFireflyError({
+		...error,
+		message: `${prefix}: ${error.message}`
+	});
+}
+/**
+* Creates a validation error.
+*
+* @example
+* ```ts
+* return FireflyErr(validationError({ message: "Invalid version format", source: "release" }));
+* ```
+*/
+function validationError(opts) {
+	return createFireflyError({
+		code: "VALIDATION",
+		...opts
+	});
+}
+/**
+* Creates a not-found error.
+*
+* @example
+* ```ts
+* return FireflyErr(notFoundError({ message: "Config file not found", source: "cli" }));
+* ```
+*/
+function notFoundError(opts) {
+	return createFireflyError({
+		code: "NOT_FOUND",
+		...opts
+	});
+}
+/**
+* Creates a conflict error.
+*
+* @example
+* ```ts
+* return FireflyErr(conflictError({ message: "Working directory is not clean" }));
+* ```
+*/
+function conflictError(opts) {
+	return createFireflyError({
+		code: "CONFLICT",
+		...opts
+	});
+}
+/**
+* Creates a timeout error.
+*
+* @example
+* ```ts
+* return FireflyErr(timeoutError({ message: "Operation timed out after 30s", retryable: true }));
+* ```
+*/
+function timeoutError(opts) {
+	return createFireflyError({
+		code: "TIMEOUT",
+		...opts
+	});
+}
+/**
+* Creates a failed operation error.
+*
+* @example
+* ```ts
+* return FireflyErr(failedError({ message: "Git command failed", details: stderr }));
+* ```
+*/
+function failedError(opts) {
+	return createFireflyError({
+		code: "FAILED",
+		...opts
+	});
+}
+/**
+* Creates an invalid state/input error.
+*
+* @example
+* ```ts
+* return FireflyErr(invalidError({ message: "Invalid bump type specified" }));
+* ```
+*/
+function invalidError(opts) {
+	return createFireflyError({
+		code: "INVALID",
+		...opts
+	});
+}
+
+//#endregion
+//#region src/core/result/result.constructors.ts
+/**
+* Creates a successful sync result.
+*
+* @example
+* ```ts
+* return FireflyOk(computedValue);
+* ```
+*/
+const FireflyOk = (value) => ok(value);
+/**
+* Creates a failed sync result.
+*
+* @example
+* ```ts
+* return FireflyErr(validationError({ message: "Invalid input" }));
+* ```
+*/
+const FireflyErr = (error) => err(error);
+/**
+* Creates a successful async result.
+*
+* @example
+* ```ts
+* return FireflyOkAsync(fetchedData);
+* ```
+*/
+const FireflyOkAsync = (value) => okAsync(value);
+/**
+* Creates a failed async result.
+*
+* @example
+* ```ts
+* return FireflyErrAsync(notFoundError({ message: "Config not found" }));
+* ```
+*/
+const FireflyErrAsync = (error) => errAsync(error);
+/**
+* Creates a sync validation error result.
+*
+* @example
+* ```ts
+* if (!isValid) return validationErr({ message: "Invalid version format" });
+* ```
+*/
+const validationErr = (opts) => err(validationError(opts));
+/**
+* Creates an async validation error result.
+*/
+const validationErrAsync = (opts) => errAsync(validationError(opts));
+/**
+* Creates an async not-found error result.
+*/
+const notFoundErrAsync = (opts) => errAsync(notFoundError(opts));
+/**
+* Creates an async conflict error result.
+*/
+const conflictErrAsync = (opts) => errAsync(conflictError(opts));
+/**
+* Creates an async failed error result.
+*/
+const failedErrAsync = (opts) => errAsync(failedError(opts));
+/**
+* Creates a sync invalid error result.
+*
+* @example
+* ```ts
+* if (!taskFn) return invalidErr({ message: "Task must have an execute function" });
+* ```
+*/
+const invalidErr = (opts) => err(invalidError(opts));
+/**
+* Creates an async timeout error result.
+*/
+const timeoutErrAsync = (opts) => errAsync(timeoutError(opts));
+
+//#endregion
+export { validationError as _, conflictErrAsync as a, notFoundErrAsync as c, validationErrAsync as d, conflictError as f, toFireflyError as g, notFoundError as h, FireflyOkAsync as i, timeoutErrAsync as l, failedError as m, FireflyErrAsync as n, failedErrAsync as o, createFireflyError as p, FireflyOk as r, invalidErr as s, FireflyErr as t, validationErr as u, wrapErrorMessage as v };

package/dist/result.utilities-B03Jkhlx.js

@@ -0,0 +1,32 @@
+import { d as validationErrAsync, g as toFireflyError, i as FireflyOkAsync, p as createFireflyError } from "./result.constructors-C9M1MP3_.js";
+import { ResultAsync, okAsync } from "neverthrow";
+
+//#region src/core/result/result.utilities.ts
+/**
+* Wraps a Promise into a FireflyAsyncResult, converting any errors into FireflyError.
+*
+* @param promise - The Promise to wrap.
+* @returns FireflyAsyncResult representing the outcome of the Promise.
+*/
+function wrapPromise(promise) {
+	return ResultAsync.fromPromise(promise, (e) => createFireflyError(toFireflyError(e)));
+}
+/**
+* Async version of ensureNot.
+*/
+function ensureNotAsync(condition, errorOpts) {
+	return condition ? validationErrAsync(errorOpts) : FireflyOkAsync(void 0);
+}
+/**
+* Async version of zip3.
+*/
+function zip3Async(resultA, resultB, resultC) {
+	return ResultAsync.combine([
+		resultA,
+		resultB,
+		resultC
+	]);
+}
+
+//#endregion
+export { wrapPromise as n, zip3Async as r, ensureNotAsync as t };

package/dist/schema.utilities-BGd9t1wm.js

@@ -0,0 +1,60 @@
+import { g as toFireflyError, p as createFireflyError, r as FireflyOk, t as FireflyErr } from "./result.constructors-C9M1MP3_.js";
+import { ResultAsync } from "neverthrow";
+import z$1 from "zod";
+
+//#region src/core/result/schema.utilities.ts
+/**
+* Formats Zod validation errors into a human-readable string.
+*
+* @param error - The Zod error object
+* @returns A formatted string with each issue on a new line
+*/
+function formatZodErrors(error) {
+	return error.issues.map((issue) => `${issue.message} for ${issue.path.join(".")}`).join("\n");
+}
+/**
+* Compose multiple Zod schemas using intersection semantics.
+* The first schema is used as the base and all remaining schemas are intersected
+* with it. This effectively merges validation rules across schemas.
+*
+* @param schemas - A non-empty list of Zod schemas to intersect.
+* @returns Zod schema that is the intersection of the provided schemas.
+*/
+function composeEffects(...schemas) {
+	return schemas.slice(1).reduce((acc, s) => z$1.intersection(acc, s), schemas[0]);
+}
+/**
+* Merge raw object shapes into a base Zod object schema and return an extended
+* object schema.
+*
+* @param base - The root Zod object schema to extend.
+* @param shapes - Raw Zod shapes (plain objects of Zod schema definitions) to merge into the base.
+* @returns New Zod object schema that extends `base` with merged `shapes`.
+*/
+function composeShape(base, ...shapes) {
+	const merged = {};
+	for (const s of shapes) Object.assign(merged, s);
+	return base.extend(merged);
+}
+/**
+* Convert a `SchemaInput` descriptor into a Zod schema instance.
+* If the input is already a Zod schema it is returned verbatim. If a descriptor
+* is supplied, the appropriate composition helper is invoked to produce a
+* schema instance.
+*
+* @internal
+* @param input - Either a Zod schema or a descriptor describing how to compose one.
+* @returns Concrete `z.ZodType` instance resulting from the input.
+*/
+function toSchema(input) {
+	if ("_def" in input && typeof input._def !== "undefined") return input;
+	const desc = input;
+	return desc.mode === "effect" ? composeEffects(...desc.schemas) : composeShape(desc.base, ...desc.shapes);
+}
+function parseSchema(schemaOrDescriptor, data) {
+	const result = toSchema(schemaOrDescriptor).safeParse(data);
+	return result.success ? FireflyOk(result.data) : FireflyErr(createFireflyError(toFireflyError(result.error)));
+}
+
+//#endregion
+export { parseSchema as n, formatZodErrors as t };

package/package.json

@@ -1,88 +1,92 @@
 {
-    "name": "fireflyy",
-    "version": "3.0.11",
-    "description": "CLI orchestrator for semantic versioning, changelog generation, and creating releases.",
-    "type": "module",
-    "license": "MIT",
-    "author": "Yehezkiel Dio Sinolungan <yehezkieldio@proton.me>",
-    "files": [
-        "dist/**/*.js",
-        "dist/**/*.d.ts",
-        "assets"
-    ],
-    "main": "./dist/index.js",
-    "module": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "exports": {
-        "./config": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        }
+  "name": "fireflyy",
+  "version": "4.0.0-dev.352994a",
+  "description": " CLI orchestrator for automatic semantic versioning, changelog generation, and creating releases. Built for my own use cases.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Yehezkiel Dio Sinolungan <yehezkieldio@proton.me>",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "assets"
+  ],
+  "main": "./dist/config.js",
+  "module": "./dist/config.js",
+  "types": "./dist/config.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
     },
-    "typesVersions": {
-        "*": {
-            "*": [
-                "./dist/*",
-                "./*"
-            ]
-        }
-    },
-    "bin": {
-        "firefly": "dist/main.js",
-        "ff": "dist/main.js"
-    },
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/",
-        "provenance": true
-    },
-    "scripts": {
-        "postbuild": "bun scripts/generate-json-schema.ts assets/firefly.schema.json",
-        "build": "tsdown",
-        "dev": "bun run src/platform/cli/main.ts",
-        "check": "biome check .",
-        "check:unsafe": "biome check --write --unsafe .",
-        "check:write": "biome check --write .",
-        "typecheck": "tsc --noEmit",
-        "format": "biome format . --write",
-        "lint": "biome lint .",
-        "lint:fix": "biome lint . --fix --unsafe"
-    },
-    "dependencies": {
-        "c12": "^3.3.1",
-        "commander": "^14.0.2",
-        "consola": "^3.4.2",
-        "git-cliff": "^2.10.1",
-        "neverthrow": "^8.2.0",
-        "semver": "^7.7.3",
-        "zod": "^4.1.12"
-    },
-    "devDependencies": {
-        "@biomejs/biome": "^2.3.4",
-        "@types/bun": "^1.3.2",
-        "@types/node": "^24.9.1",
-        "@types/semver": "^7.7.1",
-        "tsdown": "^0.16.1",
-        "typescript": "^5.9.3"
-    },
-    "keywords": [
-        "cli",
-        "changelog",
-        "git",
-        "github",
-        "gitlab",
-        "release",
-        "semver",
-        "versioning",
-        "automation",
-        "orchestrator"
-    ],
-    "homepage": "https://github.com/yehezkieldio/firefly#readme",
-    "bugs": {
-        "url": "https://github.com/yehezkieldio/firefly/issues"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/yehezkieldio/firefly.git"
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "config": [
+        "./dist/config.d.ts"
+      ]
     }
+  },
+  "bin": {
+    "firefly": "dist/main.js",
+    "ff": "dist/main.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsdown",
+    "build:json-schema": "bun run scripts/generate-json-schema.ts assets/firefly.schema.json",
+    "postbuild": "bun run build:json-schema",
+    "dev": "bun run src/cli/main.ts",
+    "check": "biome check .",
+    "check:unsafe": "biome check --write --unsafe .",
+    "check:write": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "format": "biome format . --write",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint . --fix --unsafe"
+  },
+  "dependencies": {
+    "c12": "^3.3.2",
+    "commander": "^14.0.2",
+    "consola": "^3.4.2",
+    "git-cliff": "^2.10.1",
+    "neverthrow": "^8.2.0",
+    "semver": "^7.7.3",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.8",
+    "@types/bun": "^1.3.3",
+    "@types/semver": "^7.7.1",
+    "tsdown": "^0.17.0-beta.5",
+    "typescript": "^5.9.3",
+    "ultracite": "6.3.8"
+  },
+  "keywords": [
+    "cli",
+    "changelog",
+    "git",
+    "github",
+    "gitlab",
+    "release",
+    "semver",
+    "versioning",
+    "automation",
+    "orchestrator"
+  ],
+  "homepage": "https://github.com/yehezkieldio/firefly#readme",
+  "bugs": {
+    "url": "https://github.com/yehezkieldio/firefly/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yehezkieldio/firefly.git"
+  }
 }