@knpkv/confluence-to-markdown 0.2.0 → 0.4.2

package/dist/ConfluenceError.d.ts

@@ -1,4 +1,4 @@
-declare const ConfigNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const ConfigNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "ConfigNotFoundError";
 } & Readonly<A>;
 /**
@@ -22,9 +22,13 @@ declare const ConfigNotFoundError_base: new <A extends Record<string, any> = {}>
  */
 export declare class ConfigNotFoundError extends ConfigNotFoundError_base<{
     readonly path: string;
+    readonly message: string;
 }> {
+    constructor(params: {
+        path: string;
+    });
 }
-declare const ConfigParseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const ConfigParseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "ConfigParseError";
 } & Readonly<A>;
 /**
@@ -35,9 +39,26 @@ declare const ConfigParseError_base: new <A extends Record<string, any> = {}>(ar
 export declare class ConfigParseError extends ConfigParseError_base<{
     readonly path: string;
     readonly cause: unknown;
+    readonly message: string;
+}> {
+    constructor(params: {
+        path: string;
+        cause: unknown;
+    });
+}
+declare const ConfigError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ConfigError";
+} & Readonly<A>;
+/**
+ * Error thrown when configuration validation fails.
+ *
+ * @category Errors
+ */
+export declare class ConfigError extends ConfigError_base<{
+    readonly message: string;
 }> {
 }
-declare const AuthMissingError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const AuthMissingError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "AuthMissingError";
 } & Readonly<A>;
 /**
@@ -51,8 +72,8 @@ declare const AuthMissingError_base: new <A extends Record<string, any> = {}>(ar
  * Effect.gen(function* () {
  *   // ... operation that needs auth
  * }).pipe(
- *   Effect.catchTag("AuthMissingError", () =>
- *     Effect.sync(() => console.error("Set CONFLUENCE_API_KEY or run: confluence auth login"))
+ *   Effect.catchTag("AuthMissingError", (error) =>
+ *     Effect.sync(() => console.error(error.message))
  *   )
  * )
  * ```
@@ -62,9 +83,11 @@ declare const AuthMissingError_base: new <A extends Record<string, any> = {}>(ar
 export declare class AuthMissingError extends AuthMissingError_base<{
     readonly message: string;
 }> {
-    constructor();
+    constructor(params?: {
+        message?: string;
+    });
 }
-declare const ApiError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const ApiError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "ApiError";
 } & Readonly<A>;
 /**
@@ -79,7 +102,7 @@ export declare class ApiError extends ApiError_base<{
     readonly pageId?: string;
 }> {
 }
-declare const RateLimitError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const RateLimitError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "RateLimitError";
 } & Readonly<A>;
 /**
@@ -88,10 +111,14 @@ declare const RateLimitError_base: new <A extends Record<string, any> = {}>(args
  * @category Errors
  */
 export declare class RateLimitError extends RateLimitError_base<{
-    readonly retryAfter?: number;
+    readonly retryAfter?: number | undefined;
+    readonly message: string;
 }> {
+    constructor(params?: {
+        retryAfter?: number;
+    });
 }
-declare const ConversionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const ConversionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "ConversionError";
 } & Readonly<A>;
 /**
@@ -102,9 +129,14 @@ declare const ConversionError_base: new <A extends Record<string, any> = {}>(arg
 export declare class ConversionError extends ConversionError_base<{
     readonly direction: "htmlToMarkdown" | "markdownToHtml";
     readonly cause: unknown;
+    readonly message: string;
 }> {
+    constructor(params: {
+        direction: "htmlToMarkdown" | "markdownToHtml";
+        cause: unknown;
+    });
 }
-declare const ConflictError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const ConflictError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "ConflictError";
 } & Readonly<A>;
 /**
@@ -117,9 +149,16 @@ export declare class ConflictError extends ConflictError_base<{
     readonly localVersion: number;
     readonly remoteVersion: number;
     readonly path: string;
+    readonly message: string;
 }> {
+    constructor(params: {
+        pageId: string;
+        localVersion: number;
+        remoteVersion: number;
+        path: string;
+    });
 }
-declare const FileSystemError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const FileSystemError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "FileSystemError";
 } & Readonly<A>;
 /**
@@ -131,9 +170,15 @@ export declare class FileSystemError extends FileSystemError_base<{
     readonly operation: "read" | "write" | "delete" | "mkdir" | "rename";
     readonly path: string;
     readonly cause: unknown;
+    readonly message: string;
 }> {
+    constructor(params: {
+        operation: "read" | "write" | "delete" | "mkdir" | "rename";
+        path: string;
+        cause: unknown;
+    });
 }
-declare const OAuthError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const OAuthError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "OAuthError";
 } & Readonly<A>;
 /**
@@ -142,11 +187,16 @@ declare const OAuthError_base: new <A extends Record<string, any> = {}>(args: im
  * @category Errors
  */
 export declare class OAuthError extends OAuthError_base<{
-    readonly step: "authorize" | "token" | "refresh";
+    readonly step: "authorize" | "token" | "refresh" | "revoke";
     readonly cause: unknown;
+    readonly message: string;
 }> {
+    constructor(params: {
+        step: "authorize" | "token" | "refresh" | "revoke";
+        cause: unknown;
+    });
 }
-declare const FrontMatterError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+declare const FrontMatterError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "FrontMatterError";
 } & Readonly<A>;
 /**
@@ -157,6 +207,39 @@ declare const FrontMatterError_base: new <A extends Record<string, any> = {}>(ar
 export declare class FrontMatterError extends FrontMatterError_base<{
     readonly path: string;
     readonly cause: unknown;
+    readonly message: string;
+}> {
+    constructor(params: {
+        path: string;
+        cause: unknown;
+    });
+}
+declare const StructureError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "StructureError";
+} & Readonly<A>;
+/**
+ * Error thrown when directory structure is inconsistent.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect"
+ * import { StructureError } from "@knpkv/confluence-to-markdown/ConfluenceError"
+ *
+ * Effect.gen(function* () {
+ *   // ... validate structure
+ * }).pipe(
+ *   Effect.catchTag("StructureError", (error) =>
+ *     Effect.sync(() => console.error(`${error.message}\nAdvice: ${error.advice}`))
+ *   )
+ * )
+ * ```
+ *
+ * @category Errors
+ */
+export declare class StructureError extends StructureError_base<{
+    readonly path: string;
+    readonly advice: string;
+    readonly message: string;
 }> {
 }
 /**
@@ -164,7 +247,7 @@ export declare class FrontMatterError extends FrontMatterError_base<{
  *
  * @category Errors
  */
-export type ConfluenceError = ConfigNotFoundError | ConfigParseError | AuthMissingError | ApiError | RateLimitError | ConversionError | ConflictError | FileSystemError | OAuthError | FrontMatterError;
+export type ConfluenceError = ConfigNotFoundError | ConfigParseError | ConfigError | AuthMissingError | ApiError | RateLimitError | ConversionError | ConflictError | FileSystemError | OAuthError | FrontMatterError | StructureError;
 /**
  * Type guard to check if error is a ConfluenceError.
  *

package/dist/ConfluenceError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfluenceError.d.ts","sourceRoot":"","sources":["../src/ConfluenceError.ts"],"names":[],"mappings":";;;AAOA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,sBAAqC;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAiB,SAAQ,sBAAqC;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;;CAID;;;;AAED;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,cAA6B;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,gBAAgB,CAAA;IACvD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,mBAAkC;IACnE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,gBAA+B;IAC7D,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;;;;AAEL;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,sBAAqC;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAC;CAAG;AAEL;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,gBAAgB,GAChB,gBAAgB,GAChB,QAAQ,GACR,cAAc,GACd,eAAe,GACf,aAAa,GACb,eAAe,GACf,UAAU,GACV,gBAAgB,CAAA;AAEpB;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAed,CAAA"}
+{"version":3,"file":"ConfluenceError.d.ts","sourceRoot":"","sources":["../src/ConfluenceError.ts"],"names":[],"mappings":"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"}

package/dist/ConfluenceError.js

@@ -24,6 +24,12 @@ import * as Data from "effect/Data";
  * @category Errors
  */
 export class ConfigNotFoundError extends Data.TaggedError("ConfigNotFoundError") {
+    constructor(params) {
+        super({
+            path: params.path,
+            message: `Config not found: ${params.path}\nRun 'confluence clone' to initialize.`
+        });
+    }
 }
 /**
  * Error thrown when .confluence.json parsing fails.
@@ -31,6 +37,20 @@ export class ConfigNotFoundError extends Data.TaggedError("ConfigNotFoundError")
  * @category Errors
  */
 export class ConfigParseError extends Data.TaggedError("ConfigParseError") {
+    constructor(params) {
+        super({
+            path: params.path,
+            cause: params.cause,
+            message: `Invalid config file: ${params.path}`
+        });
+    }
+}
+/**
+ * Error thrown when configuration validation fails.
+ *
+ * @category Errors
+ */
+export class ConfigError extends Data.TaggedError("ConfigError") {
 }
 /**
  * Error thrown when authentication is missing.
@@ -43,8 +63,8 @@ export class ConfigParseError extends Data.TaggedError("ConfigParseError") {
  * Effect.gen(function* () {
  *   // ... operation that needs auth
  * }).pipe(
- *   Effect.catchTag("AuthMissingError", () =>
- *     Effect.sync(() => console.error("Set CONFLUENCE_API_KEY or run: confluence auth login"))
+ *   Effect.catchTag("AuthMissingError", (error) =>
+ *     Effect.sync(() => console.error(error.message))
  *   )
  * )
  * ```
@@ -52,8 +72,11 @@ export class ConfigParseError extends Data.TaggedError("ConfigParseError") {
  * @category Errors
  */
 export class AuthMissingError extends Data.TaggedError("AuthMissingError") {
-    constructor() {
-        super({ message: "CONFLUENCE_API_KEY env var or OAuth2 credentials required" });
+    constructor(params) {
+        super({
+            message: params?.message ??
+                "Not authenticated. Run 'confluence login' or set CONFLUENCE_API_KEY + CONFLUENCE_EMAIL"
+        });
     }
 }
 /**
@@ -69,6 +92,12 @@ export class ApiError extends Data.TaggedError("ApiError") {
  * @category Errors
  */
 export class RateLimitError extends Data.TaggedError("RateLimitError") {
+    constructor(params) {
+        const message = params?.retryAfter
+            ? `Rate limited. Retry after ${params.retryAfter}s.`
+            : "Rate limited. Please wait and try again.";
+        super({ retryAfter: params?.retryAfter, message });
+    }
 }
 /**
  * Error thrown when HTML/Markdown conversion fails.
@@ -76,6 +105,13 @@ export class RateLimitError extends Data.TaggedError("RateLimitError") {
  * @category Errors
  */
 export class ConversionError extends Data.TaggedError("ConversionError") {
+    constructor(params) {
+        super({
+            direction: params.direction,
+            cause: params.cause,
+            message: `Conversion failed (${params.direction}): ${params.cause}`
+        });
+    }
 }
 /**
  * Error thrown when sync conflict is detected.
@@ -83,6 +119,12 @@ export class ConversionError extends Data.TaggedError("ConversionError") {
  * @category Errors
  */
 export class ConflictError extends Data.TaggedError("ConflictError") {
+    constructor(params) {
+        super({
+            ...params,
+            message: `Conflict: ${params.path} (local v${params.localVersion} vs remote v${params.remoteVersion})`
+        });
+    }
 }
 /**
  * Error thrown when file system operation fails.
@@ -90,6 +132,12 @@ export class ConflictError extends Data.TaggedError("ConflictError") {
  * @category Errors
  */
 export class FileSystemError extends Data.TaggedError("FileSystemError") {
+    constructor(params) {
+        super({
+            ...params,
+            message: `File ${params.operation} failed: ${params.path}`
+        });
+    }
 }
 /**
  * Error thrown when OAuth2 flow fails.
@@ -97,6 +145,12 @@ export class FileSystemError extends Data.TaggedError("FileSystemError") {
  * @category Errors
  */
 export class OAuthError extends Data.TaggedError("OAuthError") {
+    constructor(params) {
+        super({
+            ...params,
+            message: `OAuth ${params.step} failed: ${params.cause}`
+        });
+    }
 }
 /**
  * Error thrown when front-matter parsing fails.
@@ -104,6 +158,33 @@ export class OAuthError extends Data.TaggedError("OAuthError") {
  * @category Errors
  */
 export class FrontMatterError extends Data.TaggedError("FrontMatterError") {
+    constructor(params) {
+        super({
+            ...params,
+            message: `Invalid front-matter in: ${params.path}`
+        });
+    }
+}
+/**
+ * Error thrown when directory structure is inconsistent.
+ *
+ * @example
+ * ```typescript
+ * import { Effect } from "effect"
+ * import { StructureError } from "@knpkv/confluence-to-markdown/ConfluenceError"
+ *
+ * Effect.gen(function* () {
+ *   // ... validate structure
+ * }).pipe(
+ *   Effect.catchTag("StructureError", (error) =>
+ *     Effect.sync(() => console.error(`${error.message}\nAdvice: ${error.advice}`))
+ *   )
+ * )
+ * ```
+ *
+ * @category Errors
+ */
+export class StructureError extends Data.TaggedError("StructureError") {
 }
 /**
  * Type guard to check if error is a ConfluenceError.
@@ -119,6 +200,7 @@ export const isConfluenceError = (error) => typeof error === "object" &&
     [
         "ConfigNotFoundError",
         "ConfigParseError",
+        "ConfigError",
         "AuthMissingError",
         "ApiError",
         "RateLimitError",
@@ -126,6 +208,7 @@ export const isConfluenceError = (error) => typeof error === "object" &&
         "ConflictError",
         "FileSystemError",
         "OAuthError",
-        "FrontMatterError"
+        "FrontMatterError",
+        "StructureError"
     ].includes(error._tag);
 //# sourceMappingURL=ConfluenceError.js.map

package/dist/ConfluenceError.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfluenceError.js","sourceRoot":"","sources":["../src/ConfluenceError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAE7E;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAGvE;CAAG;AAEL;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAEvE;IACA;QACE,KAAK,CAAC,EAAE,OAAO,EAAE,2DAA2D,EAAE,CAAC,CAAA;IACjF,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,IAAI,CAAC,WAAW,CAAC,UAAU,CAKvD;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAEnE;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAGrE;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,IAAI,CAAC,WAAW,CAAC,eAAe,CAKjE;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAIrE;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,UAAW,SAAQ,IAAI,CAAC,WAAW,CAAC,YAAY,CAG3D;CAAG;AAEL;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAGvE;CAAG;AAmBL;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA4B,EAAE,CAC5E,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,MAAM,IAAI,KAAK;IACf;QACE,qBAAqB;QACrB,kBAAkB;QAClB,kBAAkB;QAClB,UAAU;QACV,gBAAgB;QAChB,iBAAiB;QACjB,eAAe;QACf,iBAAiB;QACjB,YAAY;QACZ,kBAAkB;KACnB,CAAC,QAAQ,CAAE,KAA0B,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"ConfluenceError.js","sourceRoot":"","sources":["../src/ConfluenceError.ts"],"names":[],"mappings":"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"}

package/dist/GitError.d.ts

@@ -0,0 +1,103 @@
+declare const GitError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "GitError";
+} & Readonly<A>;
+/**
+ * Base git error for command execution failures.
+ *
+ * @example
+ * ```typescript
+ * import { GitError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitError({
+ *   command: "git commit",
+ *   message: "nothing to commit",
+ *   exitCode: 1
+ * })
+ * ```
+ *
+ * @category Error
+ */
+export declare class GitError extends GitError_base<{
+    readonly command: string;
+    readonly message: string;
+    readonly exitCode?: number;
+}> {
+}
+declare const GitNotInstalledError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "GitNotInstalledError";
+} & Readonly<A>;
+/**
+ * Error when git is not installed on the system.
+ *
+ * @example
+ * ```typescript
+ * import { GitNotInstalledError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitNotInstalledError({
+ *   message: "git command not found"
+ * })
+ * ```
+ *
+ * @category Error
+ */
+export declare class GitNotInstalledError extends GitNotInstalledError_base<{
+    readonly message: string;
+}> {
+}
+declare const GitNoChangesError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "GitNoChangesError";
+} & Readonly<A>;
+/**
+ * Error when there are no changes to commit.
+ *
+ * @example
+ * ```typescript
+ * import { GitNoChangesError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitNoChangesError({})
+ * ```
+ *
+ * @category Error
+ */
+export declare class GitNoChangesError extends GitNoChangesError_base<{}> {
+}
+declare const GitMergeConflictError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "GitMergeConflictError";
+} & Readonly<A>;
+/**
+ * Error when merge conflicts exist.
+ *
+ * @example
+ * ```typescript
+ * import { GitMergeConflictError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitMergeConflictError({
+ *   files: ["docs/page1.md", "docs/page2.md"]
+ * })
+ * ```
+ *
+ * @category Error
+ */
+export declare class GitMergeConflictError extends GitMergeConflictError_base<{
+    readonly files: ReadonlyArray<string>;
+}> {
+}
+declare const GitNotInitializedError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "GitNotInitializedError";
+} & Readonly<A>;
+/**
+ * Error when git repository is not initialized.
+ *
+ * @example
+ * ```typescript
+ * import { GitNotInitializedError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitNotInitializedError({})
+ * ```
+ *
+ * @category Error
+ */
+export declare class GitNotInitializedError extends GitNotInitializedError_base<{}> {
+}
+export {};
+//# sourceMappingURL=GitError.d.ts.map

package/dist/GitError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitError.d.ts","sourceRoot":"","sources":["../src/GitError.ts"],"names":[],"mappings":";;;AAOA;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,QAAS,SAAQ,cAA6B;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAC;CAAG;;;;AAEL;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,SAAQ,0BAAyC;IACjF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;;;;AAEL;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAkB,SAAQ,uBAAsC,EAAE,CAAC;CAAG;;;;AAEnF;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,SAAQ,2BAA0C;IACnF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACtC,CAAC;CAAG;;;;AAEL;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAuB,SAAQ,4BAA2C,EAAE,CAAC;CAAG"}

package/dist/GitError.js

@@ -0,0 +1,85 @@
+/**
+ * Git-specific error types.
+ *
+ * @module
+ */
+import * as Data from "effect/Data";
+/**
+ * Base git error for command execution failures.
+ *
+ * @example
+ * ```typescript
+ * import { GitError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitError({
+ *   command: "git commit",
+ *   message: "nothing to commit",
+ *   exitCode: 1
+ * })
+ * ```
+ *
+ * @category Error
+ */
+export class GitError extends Data.TaggedError("GitError") {
+}
+/**
+ * Error when git is not installed on the system.
+ *
+ * @example
+ * ```typescript
+ * import { GitNotInstalledError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitNotInstalledError({
+ *   message: "git command not found"
+ * })
+ * ```
+ *
+ * @category Error
+ */
+export class GitNotInstalledError extends Data.TaggedError("GitNotInstalledError") {
+}
+/**
+ * Error when there are no changes to commit.
+ *
+ * @example
+ * ```typescript
+ * import { GitNoChangesError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitNoChangesError({})
+ * ```
+ *
+ * @category Error
+ */
+export class GitNoChangesError extends Data.TaggedError("GitNoChangesError") {
+}
+/**
+ * Error when merge conflicts exist.
+ *
+ * @example
+ * ```typescript
+ * import { GitMergeConflictError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitMergeConflictError({
+ *   files: ["docs/page1.md", "docs/page2.md"]
+ * })
+ * ```
+ *
+ * @category Error
+ */
+export class GitMergeConflictError extends Data.TaggedError("GitMergeConflictError") {
+}
+/**
+ * Error when git repository is not initialized.
+ *
+ * @example
+ * ```typescript
+ * import { GitNotInitializedError } from "@knpkv/confluence-to-markdown/GitError"
+ *
+ * const error = new GitNotInitializedError({})
+ * ```
+ *
+ * @category Error
+ */
+export class GitNotInitializedError extends Data.TaggedError("GitNotInitializedError") {
+}
+//# sourceMappingURL=GitError.js.map

package/dist/GitError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitError.js","sourceRoot":"","sources":["../src/GitError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AAEnC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,QAAS,SAAQ,IAAI,CAAC,WAAW,CAAC,UAAU,CAIvD;CAAG;AAEL;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAqB,SAAQ,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAE/E;CAAG;AAEL;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAK;CAAG;AAEnF;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,qBAAsB,SAAQ,IAAI,CAAC,WAAW,CAAC,uBAAuB,CAEjF;CAAG;AAEL;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,sBAAuB,SAAQ,IAAI,CAAC,WAAW,CAAC,wBAAwB,CAAK;CAAG"}