@knpkv/confluence-to-markdown 0.2.0 → 0.4.2

package/dist/internal/oauthServer.d.ts

@@ -0,0 +1,55 @@
+import * as HttpServer from "@effect/platform/HttpServer";
+import type { ServeError } from "@effect/platform/HttpServerError";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { OAuthError } from "../ConfluenceError.js";
+/**
+ * Factory service for creating HTTP servers.
+ * This allows mocking the server creation in tests.
+ *
+ * @category Services
+ */
+export interface HttpServerFactory {
+    readonly createServerLayer: (port: number) => Layer.Layer<HttpServer.HttpServer, ServeError, never>;
+}
+declare const HttpServerFactoryTag_base: Context.TagClass<HttpServerFactoryTag, "@knpkv/confluence-to-markdown/HttpServerFactory", HttpServerFactory>;
+/**
+ * Tag for the HttpServerFactory service.
+ *
+ * @category Services
+ */
+export declare class HttpServerFactoryTag extends HttpServerFactoryTag_base {
+}
+/**
+ * Create a HttpServerFactory layer from a layer factory function.
+ * This allows injecting platform-specific implementations.
+ *
+ * @param createLayerFn - Function that creates HttpServer layer for a given port
+ * @returns Layer providing HttpServerFactory
+ *
+ * @category Layers
+ */
+export declare const makeHttpServerFactory: (createLayerFn: (port: number) => Layer.Layer<HttpServer.HttpServer, ServeError, never>) => Layer.Layer<HttpServerFactoryTag>;
+/**
+ * Result from the OAuth callback server.
+ */
+export interface CallbackServerResult {
+    /** Promise that resolves with the authorization code */
+    readonly codePromise: Effect.Effect<string, OAuthError>;
+    /** Shutdown the callback server */
+    readonly shutdown: Effect.Effect<void, never>;
+    /** The port the server is listening on */
+    readonly port: number;
+}
+/**
+ * Start a local HTTP server to receive OAuth callback.
+ *
+ * @param expectedState - The state parameter to verify against CSRF
+ * @returns Server control interface with code promise, shutdown, and port
+ *
+ * @category OAuth
+ */
+export declare const startCallbackServer: (expectedState: string) => Effect.Effect<CallbackServerResult, OAuthError, HttpServerFactoryTag>;
+export {};
+//# sourceMappingURL=oauthServer.d.ts.map

package/dist/internal/oauthServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthServer.d.ts","sourceRoot":"","sources":["../../src/internal/oauthServer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAGlE,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAEzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAKlD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,KAAK,CACvD,UAAU,CAAC,UAAU,EACrB,UAAU,EACV,KAAK,CACN,CAAA;CACF;;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,yBAGvC;CAAG;AAEN;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,eAAe,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,KACrF,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAG/B,CAAA;AAyCJ;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACvD,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC7C,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAC9B,eAAe,MAAM,KACpB,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,CA6EnE,CAAA"}

package/dist/internal/oauthServer.js

@@ -0,0 +1,110 @@
+/**
+ * Local HTTP server for OAuth callback.
+ *
+ * @module
+ */
+import * as HttpRouter from "@effect/platform/HttpRouter";
+import * as HttpServer from "@effect/platform/HttpServer";
+import * as HttpServerRequest from "@effect/platform/HttpServerRequest";
+import * as HttpServerResponse from "@effect/platform/HttpServerResponse";
+import * as Context from "effect/Context";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import { OAuthError } from "../ConfluenceError.js";
+const DEFAULT_PORT = 8585;
+const MAX_PORT_ATTEMPTS = 10;
+/**
+ * Tag for the HttpServerFactory service.
+ *
+ * @category Services
+ */
+export class HttpServerFactoryTag extends Context.Tag("@knpkv/confluence-to-markdown/HttpServerFactory")() {
+}
+/**
+ * Create a HttpServerFactory layer from a layer factory function.
+ * This allows injecting platform-specific implementations.
+ *
+ * @param createLayerFn - Function that creates HttpServer layer for a given port
+ * @returns Layer providing HttpServerFactory
+ *
+ * @category Layers
+ */
+export const makeHttpServerFactory = (createLayerFn) => Layer.succeed(HttpServerFactoryTag, {
+    createServerLayer: createLayerFn
+});
+/**
+ * Check if a port is available by attempting to start a server.
+ */
+const isPortAvailable = (port) => Effect.gen(function* () {
+    const factory = yield* HttpServerFactoryTag;
+    const serverLayer = factory.createServerLayer(port);
+    // Try to acquire and immediately release
+    const result = yield* Layer.build(serverLayer).pipe(Effect.scoped, Effect.as(true), Effect.catchAll(() => Effect.succeed(false)));
+    return result;
+});
+/**
+ * Find an available port starting from the default.
+ */
+const findAvailablePort = () => Effect.gen(function* () {
+    for (let attempt = 0; attempt < MAX_PORT_ATTEMPTS; attempt++) {
+        const port = DEFAULT_PORT + attempt;
+        const available = yield* isPortAvailable(port);
+        if (available) {
+            return port;
+        }
+    }
+    return yield* Effect.fail(new OAuthError({
+        step: "authorize",
+        cause: `Could not find available port (tried ${DEFAULT_PORT}-${DEFAULT_PORT + MAX_PORT_ATTEMPTS - 1}). Close other applications using these ports.`
+    }));
+});
+/**
+ * Start a local HTTP server to receive OAuth callback.
+ *
+ * @param expectedState - The state parameter to verify against CSRF
+ * @returns Server control interface with code promise, shutdown, and port
+ *
+ * @category OAuth
+ */
+export const startCallbackServer = (expectedState) => Effect.gen(function* () {
+    const factory = yield* HttpServerFactoryTag;
+    const port = yield* findAvailablePort();
+    const deferred = yield* Deferred.make();
+    const readyDeferred = yield* Deferred.make();
+    const app = HttpRouter.empty.pipe(HttpRouter.get("/callback", Effect.gen(function* () {
+        const req = yield* HttpServerRequest.HttpServerRequest;
+        const url = new URL(req.url, `http://localhost:${port}`);
+        const code = url.searchParams.get("code");
+        const state = url.searchParams.get("state");
+        const error = url.searchParams.get("error");
+        const errorDescription = url.searchParams.get("error_description");
+        if (error) {
+            yield* Deferred.fail(deferred, new OAuthError({ step: "authorize", cause: errorDescription || error }));
+            return HttpServerResponse.html("<html><body><h1>Authorization Failed</h1><p>You can close this window.</p></body></html>");
+        }
+        if (state !== expectedState) {
+            yield* Deferred.fail(deferred, new OAuthError({ step: "authorize", cause: "State mismatch - possible CSRF attack" }));
+            return HttpServerResponse.html("<html><body><h1>Security Error</h1><p>State verification failed.</p></body></html>");
+        }
+        if (!code) {
+            yield* Deferred.fail(deferred, new OAuthError({ step: "authorize", cause: "No authorization code received" }));
+            return HttpServerResponse.html("<html><body><h1>Error</h1><p>No authorization code received.</p></body></html>");
+        }
+        yield* Deferred.succeed(deferred, code);
+        return HttpServerResponse.html("<html><body><h1>Success!</h1><p>You can close this window and return to the terminal.</p></body></html>");
+    })));
+    const serverLayer = factory.createServerLayer(port);
+    const serverFiber = yield* HttpServer.serve(app).pipe(Layer.provide(serverLayer), Layer.build, Effect.tap(() => Deferred.succeed(readyDeferred, undefined)), Effect.tapError((err) => Deferred.fail(readyDeferred, new OAuthError({ step: "authorize", cause: err }))), 
+    // Keep the layer alive until fiber is interrupted
+    Effect.flatMap(() => Effect.never), Effect.scoped, Effect.fork);
+    // Wait for server to be ready (or fail)
+    yield* Deferred.await(readyDeferred);
+    return {
+        codePromise: Deferred.await(deferred),
+        shutdown: Fiber.interrupt(serverFiber).pipe(Effect.asVoid),
+        port
+    };
+});
+//# sourceMappingURL=oauthServer.js.map

package/dist/internal/oauthServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauthServer.js","sourceRoot":"","sources":["../../src/internal/oauthServer.ts"],"names":[],"mappings":"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"}

package/dist/internal/pathUtils.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Path utilities for converting page titles to file paths.
+ *
+ * @module
+ * @internal
+ */
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
 /**
  * Convert a page title to a URL-safe slug.
  * Prevents path traversal by only allowing alphanumeric characters and hyphens.
@@ -11,14 +19,23 @@ export declare const slugify: (title: string) => string;
 /**
  * Convert a page to a local file path.
  *
+ * Pages are always stored as `slug.md`. If a page has children,
+ * the children are stored in a `slug/` directory alongside the parent file.
+ *
+ * Example structure:
+ * - guide.md           (page with children)
+ * - guide/             (directory for children)
+ *   - getting-started.md
+ *   - advanced.md
+ *
  * @param title - The page title
- * @param hasChildren - Whether the page has child pages
+ * @param _hasChildren - Whether the page has child pages (unused, kept for API compat)
  * @param parentPath - The parent directory path
  * @returns The local file path for the page
  *
  * @internal
  */
-export declare const pageToPath: (title: string, hasChildren: boolean, parentPath: string) => string;
+export declare const pageToPath: (title: string, _hasChildren: boolean, parentPath: string) => Effect.Effect<string, never, Path.Path>;
 /**
  * Get the directory path for a page (used when creating children).
  *
@@ -28,7 +45,7 @@ export declare const pageToPath: (title: string, hasChildren: boolean, parentPat
  *
  * @internal
  */
-export declare const pageToDir: (title: string, parentPath: string) => string;
+export declare const pageToDir: (title: string, parentPath: string) => Effect.Effect<string, never, Path.Path>;
 /**
  * Extract page slug from a file path.
  *
@@ -37,5 +54,5 @@ export declare const pageToDir: (title: string, parentPath: string) => string;
  *
  * @internal
  */
-export declare const pathToSlug: (filePath: string) => string;
+export declare const pathToSlug: (filePath: string) => Effect.Effect<string, never, Path.Path>;
 //# sourceMappingURL=pathUtils.d.ts.map

package/dist/internal/pathUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../../src/internal/pathUtils.ts"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,KAAG,MAWvC,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,MAAM,EACb,aAAa,OAAO,EACpB,YAAY,MAAM,KACjB,MAKF,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,YAAY,MAAM,KAAG,MAG7D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,KAAG,MAG7C,CAAA"}
+{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../../src/internal/pathUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,KAAG,MAWvC,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,MAAM,EACb,cAAc,OAAO,EACrB,YAAY,MAAM,KACjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAMrC,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO,MAAM,EACb,YAAY,MAAM,KACjB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAKrC,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAIhF,CAAA"}

package/dist/internal/pathUtils.js

@@ -4,7 +4,8 @@
  * @module
  * @internal
  */
-import * as path from "node:path";
+import * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
 /**
  * Convert a page title to a URL-safe slug.
  * Prevents path traversal by only allowing alphanumeric characters and hyphens.
@@ -28,19 +29,28 @@ export const slugify = (title) => {
 /**
  * Convert a page to a local file path.
  *
+ * Pages are always stored as `slug.md`. If a page has children,
+ * the children are stored in a `slug/` directory alongside the parent file.
+ *
+ * Example structure:
+ * - guide.md           (page with children)
+ * - guide/             (directory for children)
+ *   - getting-started.md
+ *   - advanced.md
+ *
  * @param title - The page title
- * @param hasChildren - Whether the page has child pages
+ * @param _hasChildren - Whether the page has child pages (unused, kept for API compat)
  * @param parentPath - The parent directory path
  * @returns The local file path for the page
  *
  * @internal
  */
-export const pageToPath = (title, hasChildren, parentPath) => {
+export const pageToPath = (title, _hasChildren, parentPath) => Effect.gen(function* () {
+    const path = yield* Path.Path;
     const slug = slugify(title);
-    return hasChildren
-        ? path.join(parentPath, slug, "index.md")
-        : path.join(parentPath, `${slug}.md`);
-};
+    // Always use slug.md, children go in slug/ directory
+    return path.join(parentPath, `${slug}.md`);
+});
 /**
  * Get the directory path for a page (used when creating children).
  *
@@ -50,10 +60,11 @@ export const pageToPath = (title, hasChildren, parentPath) => {
  *
  * @internal
  */
-export const pageToDir = (title, parentPath) => {
+export const pageToDir = (title, parentPath) => Effect.gen(function* () {
+    const path = yield* Path.Path;
     const slug = slugify(title);
     return path.join(parentPath, slug);
-};
+});
 /**
  * Extract page slug from a file path.
  *
@@ -62,8 +73,8 @@ export const pageToDir = (title, parentPath) => {
  *
  * @internal
  */
-export const pathToSlug = (filePath) => {
-    const basename = path.basename(filePath, ".md");
-    return basename === "index" ? path.basename(path.dirname(filePath)) : basename;
-};
+export const pathToSlug = (filePath) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    return path.basename(filePath, ".md");
+});
 //# sourceMappingURL=pathUtils.js.map

package/dist/internal/pathUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"pathUtils.js","sourceRoot":"","sources":["../../src/internal/pathUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE;IAC/C,MAAM,IAAI,GAAG,KAAK;SACf,WAAW,EAAE;SACb,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,oBAAoB;SACpD,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,sEAAsE;SAClG,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,gCAAgC;SACxD,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA,CAAC,eAAe;IAEpC,6DAA6D;IAC7D,OAAO,IAAI,IAAI,UAAU,CAAA;AAC3B,CAAC,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,KAAa,EACb,WAAoB,EACpB,UAAkB,EACV,EAAE;IACV,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3B,OAAO,WAAW;QAChB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,KAAK,CAAC,CAAA;AACzC,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,UAAkB,EAAU,EAAE;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AACpC,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAU,EAAE;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC/C,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AAChF,CAAC,CAAA"}
+{"version":3,"file":"pathUtils.js","sourceRoot":"","sources":["../../src/internal/pathUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAA;AAC7C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAU,EAAE;IAC/C,MAAM,IAAI,GAAG,KAAK;SACf,WAAW,EAAE;SACb,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,oBAAoB;SACpD,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,sEAAsE;SAClG,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,gCAAgC;SACxD,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA,CAAC,eAAe;IAEpC,6DAA6D;IAC7D,OAAO,IAAI,IAAI,UAAU,CAAA;AAC3B,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,KAAa,EACb,YAAqB,EACrB,UAAkB,EACuB,EAAE,CAC3C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3B,qDAAqD;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,KAAK,CAAC,CAAA;AAC5C,CAAC,CAAC,CAAA;AAEJ;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,KAAa,EACb,UAAkB,EACuB,EAAE,CAC3C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AACpC,CAAC,CAAC,CAAA;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAA2C,EAAE,CACtF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;IAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;AACvC,CAAC,CAAC,CAAA"}

package/dist/internal/tokenStorage.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Token storage for OAuth credentials.
+ *
+ * @module
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { FileSystemError } from "../ConfluenceError.js";
+import { type OAuthConfig, type OAuthToken } from "../Schemas.js";
+/**
+ * Service for getting the home directory.
+ * This allows mocking in tests.
+ *
+ * @category Services
+ */
+export interface HomeDirectory {
+    readonly get: () => Effect.Effect<string>;
+}
+declare const HomeDirectoryTag_base: Context.TagClass<HomeDirectoryTag, "@knpkv/confluence-to-markdown/HomeDirectory", HomeDirectory>;
+/**
+ * Tag for the HomeDirectory service.
+ *
+ * @category Services
+ */
+export declare class HomeDirectoryTag extends HomeDirectoryTag_base {
+}
+/**
+ * Default implementation using process.env.HOME.
+ *
+ * @category Layers
+ */
+export declare const HomeDirectoryLive: Layer.Layer<HomeDirectoryTag>;
+/**
+ * Load stored OAuth token from disk.
+ *
+ * @returns The stored token or null if not found/invalid
+ *
+ * @category Token Storage
+ */
+export declare const loadToken: () => Effect.Effect<OAuthToken | null, FileSystemError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Save OAuth token to disk with secure permissions.
+ *
+ * @param token - The token to save
+ *
+ * @category Token Storage
+ */
+export declare const saveToken: (token: OAuthToken) => Effect.Effect<void, FileSystemError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Delete stored OAuth token.
+ *
+ * @category Token Storage
+ */
+export declare const deleteToken: () => Effect.Effect<void, FileSystemError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Load OAuth client configuration from disk.
+ *
+ * @returns The stored config or null if not found/invalid
+ *
+ * @category OAuth Config
+ */
+export declare const loadOAuthConfig: () => Effect.Effect<OAuthConfig | null, FileSystemError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Save OAuth client configuration to disk with secure permissions.
+ *
+ * @param config - The config to save
+ *
+ * @category OAuth Config
+ */
+export declare const saveOAuthConfig: (config: OAuthConfig) => Effect.Effect<void, FileSystemError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+export {};
+//# sourceMappingURL=tokenStorage.d.ts.map

package/dist/internal/tokenStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenStorage.d.ts","sourceRoot":"","sources":["../../src/internal/tokenStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAA;AAC7C,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,KAAK,WAAW,EAAqB,KAAK,UAAU,EAAoB,MAAM,eAAe,CAAA;AAMtG;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;CAC1C;;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,qBAGnC;CAAG;AAEN;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAK3D,CAAA;AAiCD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,QAAO,MAAM,CAAC,MAAM,CACxC,UAAU,GAAG,IAAI,EACjB,eAAe,EACf,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CA6BlD,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GACpB,OAAO,UAAU,KAChB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAkBxF,CAAA;AAEJ;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAAO,MAAM,CAAC,MAAM,CAC1C,IAAI,EACJ,eAAe,EACf,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAUlD,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,QAAO,MAAM,CAAC,MAAM,CAC9C,WAAW,GAAG,IAAI,EAClB,eAAe,EACf,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CA6BlD,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,WAAW,KAClB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAkBxF,CAAA"}

package/dist/internal/tokenStorage.js

@@ -0,0 +1,149 @@
+/**
+ * Token storage for OAuth credentials.
+ *
+ * @module
+ */
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Path from "@effect/platform/Path";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+import { FileSystemError } from "../ConfluenceError.js";
+import { OAuthConfigSchema, OAuthTokenSchema } from "../Schemas.js";
+const TOKEN_DIR_NAME = ".confluence";
+const TOKEN_FILE_NAME = "auth.json";
+const CONFIG_FILE_NAME = "config.json";
+/**
+ * Tag for the HomeDirectory service.
+ *
+ * @category Services
+ */
+export class HomeDirectoryTag extends Context.Tag("@knpkv/confluence-to-markdown/HomeDirectory")() {
+}
+/**
+ * Default implementation using process.env.HOME.
+ *
+ * @category Layers
+ */
+export const HomeDirectoryLive = Layer.succeed(HomeDirectoryTag, {
+    get: () => Effect.sync(() => process.env.HOME ?? process.env.USERPROFILE ?? "/")
+});
+/**
+ * Get the token directory path.
+ */
+const getTokenDir = () => Effect.gen(function* () {
+    const homeDir = yield* HomeDirectoryTag;
+    const path = yield* Path.Path;
+    const home = yield* homeDir.get();
+    return path.join(home, TOKEN_DIR_NAME);
+});
+/**
+ * Get the token file path.
+ */
+const getTokenPath = () => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const tokenDir = yield* getTokenDir();
+    return path.join(tokenDir, TOKEN_FILE_NAME);
+});
+/**
+ * Get the config file path.
+ */
+const getConfigPath = () => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const tokenDir = yield* getTokenDir();
+    return path.join(tokenDir, CONFIG_FILE_NAME);
+});
+/**
+ * Load stored OAuth token from disk.
+ *
+ * @returns The stored token or null if not found/invalid
+ *
+ * @category Token Storage
+ */
+export const loadToken = () => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const tokenPath = yield* getTokenPath();
+    const exists = yield* fs.exists(tokenPath).pipe(Effect.catchAll(() => Effect.succeed(false)));
+    if (!exists) {
+        return null;
+    }
+    const content = yield* fs.readFileString(tokenPath).pipe(Effect.mapError((cause) => new FileSystemError({ operation: "read", path: tokenPath, cause })));
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+    const decoded = yield* Schema.decodeUnknown(OAuthTokenSchema)(parsed).pipe(Effect.catchAll(() => Effect.succeed(null)));
+    return decoded;
+});
+/**
+ * Save OAuth token to disk with secure permissions.
+ *
+ * @param token - The token to save
+ *
+ * @category Token Storage
+ */
+export const saveToken = (token) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const tokenDir = yield* getTokenDir();
+    const tokenPath = yield* getTokenPath();
+    yield* fs.makeDirectory(tokenDir, { recursive: true }).pipe(Effect.mapError((cause) => new FileSystemError({ operation: "mkdir", path: tokenDir, cause })));
+    yield* fs.writeFileString(tokenPath, JSON.stringify(token, null, 2)).pipe(Effect.mapError((cause) => new FileSystemError({ operation: "write", path: tokenPath, cause })));
+    // Set secure permissions (owner only)
+    yield* fs.chmod(tokenPath, 0o600).pipe(Effect.mapError((cause) => new FileSystemError({ operation: "write", path: tokenPath, cause })));
+});
+/**
+ * Delete stored OAuth token.
+ *
+ * @category Token Storage
+ */
+export const deleteToken = () => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const tokenPath = yield* getTokenPath();
+    yield* fs.remove(tokenPath).pipe(Effect.catchAll(() => Effect.void), Effect.mapError((cause) => new FileSystemError({ operation: "delete", path: tokenPath, cause })));
+});
+/**
+ * Load OAuth client configuration from disk.
+ *
+ * @returns The stored config or null if not found/invalid
+ *
+ * @category OAuth Config
+ */
+export const loadOAuthConfig = () => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const configPath = yield* getConfigPath();
+    const exists = yield* fs.exists(configPath).pipe(Effect.catchAll(() => Effect.succeed(false)));
+    if (!exists) {
+        return null;
+    }
+    const content = yield* fs.readFileString(configPath).pipe(Effect.mapError((cause) => new FileSystemError({ operation: "read", path: configPath, cause })));
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+    const decoded = yield* Schema.decodeUnknown(OAuthConfigSchema)(parsed).pipe(Effect.catchAll(() => Effect.succeed(null)));
+    return decoded;
+});
+/**
+ * Save OAuth client configuration to disk with secure permissions.
+ *
+ * @param config - The config to save
+ *
+ * @category OAuth Config
+ */
+export const saveOAuthConfig = (config) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const tokenDir = yield* getTokenDir();
+    const configPath = yield* getConfigPath();
+    yield* fs.makeDirectory(tokenDir, { recursive: true }).pipe(Effect.mapError((cause) => new FileSystemError({ operation: "mkdir", path: tokenDir, cause })));
+    yield* fs.writeFileString(configPath, JSON.stringify(config, null, 2)).pipe(Effect.mapError((cause) => new FileSystemError({ operation: "write", path: configPath, cause })));
+    // Set secure permissions (owner only)
+    yield* fs.chmod(configPath, 0o600).pipe(Effect.mapError((cause) => new FileSystemError({ operation: "write", path: configPath, cause })));
+});
+//# sourceMappingURL=tokenStorage.js.map

package/dist/internal/tokenStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenStorage.js","sourceRoot":"","sources":["../../src/internal/tokenStorage.ts"],"names":[],"mappings":"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"}

package/dist/internal/userCache.d.ts

@@ -0,0 +1,42 @@
+/**
+ * In-memory cache for Atlassian user info.
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type { AtlassianUser } from "../Schemas.js";
+declare const UserCache_base: Context.TagClass<UserCache, "@knpkv/confluence-to-markdown/UserCache", {
+    /**
+     * Get user from cache, or fetch and cache if not present.
+     */
+    readonly getOrFetch: (accountId: string, fetch: (accountId: string) => Effect.Effect<AtlassianUser, unknown>) => Effect.Effect<AtlassianUser, unknown>;
+    /**
+     * Get user from cache only (no fetch).
+     */
+    readonly get: (accountId: string) => Effect.Effect<AtlassianUser | undefined>;
+    /**
+     * Put user into cache.
+     */
+    readonly put: (accountId: string, user: AtlassianUser) => Effect.Effect<void>;
+    /**
+     * Clear the cache.
+     */
+    readonly clear: () => Effect.Effect<void>;
+}>;
+/**
+ * User cache service for caching Atlassian user lookups.
+ *
+ * @category Cache
+ */
+export declare class UserCache extends UserCache_base {
+}
+/**
+ * Layer that provides UserCache.
+ *
+ * @category Layers
+ */
+export declare const UserCacheLayer: Layer.Layer<UserCache>;
+export {};
+//# sourceMappingURL=userCache.d.ts.map

package/dist/internal/userCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userCache.d.ts","sourceRoot":"","sources":["../../src/internal/userCache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;;IAU9C;;OAEG;yBACkB,CACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,KAChE,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC;IAE1C;;OAEG;kBACW,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC;IAE7E;;OAEG;kBACW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IAE7E;;OAEG;oBACa,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;AA7B7C;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,cA0B5B;CAAG;AA0CN;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAiC,CAAA"}