@knpkv/atlassian-common 0.2.0

package/dist/config/TokenStorage.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Persistent token and OAuth config storage with schema validation and secure file I/O.
+ *
+ * **Mental model**
+ *
+ * - **Load returns null, not error**: {@link loadToken} and {@link loadOAuthConfig} return
+ *   `null` for missing/corrupt files — callers decide whether absence is an error.
+ * - **Save is atomic**: Writes go through {@link writeSecureFile} with `0o600` permissions.
+ * - **Schema-gated reads**: JSON is parsed then validated via `Schema.decodeUnknown` —
+ *   corrupt data is treated as absent rather than crashing.
+ *
+ * **Common tasks**
+ *
+ * - Load stored token: {@link loadToken}
+ * - Persist after refresh: {@link saveToken}
+ * - Check expiration: {@link isTokenExpired}
+ *
+ * @module
+ */
+import type * as Error from "@effect/platform/Error";
+import * as FileSystem from "@effect/platform/FileSystem";
+import type * as Path from "@effect/platform/Path";
+import * as Effect from "effect/Effect";
+import { type HomeDirectoryError, type HomeDirectoryTag } from "./ConfigPaths.js";
+import { type OAuthConfig, type OAuthToken } from "./OAuthSchemas.js";
+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>;
+/**
+ * Error during file system operations.
+ *
+ * @category Errors
+ */
+export declare class FileSystemError extends FileSystemError_base<{
+    readonly operation: string;
+    readonly path: string;
+    readonly cause?: unknown;
+}> {
+    get message(): string;
+}
+/**
+ * Load stored OAuth token from disk.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ * @returns The stored token or null if not found/invalid
+ *
+ * @category Token Storage
+ */
+export declare const loadToken: (toolName: string) => Effect.Effect<OAuthToken | null, FileSystemError | HomeDirectoryError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Save OAuth token to disk with secure permissions.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ * @param token - The token to save
+ *
+ * @category Token Storage
+ */
+export declare const saveToken: (toolName: string, token: OAuthToken) => Effect.Effect<void, FileSystemError | HomeDirectoryError | Error.PlatformError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Delete stored OAuth token.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ *
+ * @category Token Storage
+ */
+export declare const deleteToken: (toolName: string) => Effect.Effect<void, FileSystemError | HomeDirectoryError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Load OAuth client configuration from disk.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ * @returns The stored config or null if not found/invalid
+ *
+ * @category OAuth Config
+ */
+export declare const loadOAuthConfig: (toolName: string) => Effect.Effect<OAuthConfig | null, FileSystemError | HomeDirectoryError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Save OAuth client configuration to disk with secure permissions.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ * @param config - The config to save
+ *
+ * @category OAuth Config
+ */
+export declare const saveOAuthConfig: (toolName: string, config: OAuthConfig) => Effect.Effect<void, FileSystemError | HomeDirectoryError | Error.PlatformError, FileSystem.FileSystem | Path.Path | HomeDirectoryTag>;
+/**
+ * Check if token is expired or about to expire.
+ *
+ * @param token - The token to check
+ * @param bufferMs - Buffer time in ms before expiration (default: 5 minutes)
+ * @returns True if token is expired or will expire within buffer time
+ *
+ * @category Utilities
+ */
+export declare const isTokenExpired: (token: OAuthToken, bufferMs?: number) => boolean;
+export {};
+//# sourceMappingURL=TokenStorage.d.ts.map

package/dist/config/TokenStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenStorage.d.ts","sourceRoot":"","sources":["../../src/config/TokenStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,KAAK,IAAI,MAAM,uBAAuB,CAAA;AAElD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEjF,OAAO,EAAE,KAAK,WAAW,EAAqB,KAAK,UAAU,EAAoB,MAAM,mBAAmB,CAAA;;;;AAE1G;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,CAAC;IACA,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CACd,UAAU,GAAG,IAAI,EACjB,eAAe,GAAG,kBAAkB,EACpC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAoClD,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GACpB,UAAU,MAAM,EAChB,OAAO,UAAU,KAChB,MAAM,CAAC,MAAM,CACd,IAAI,EACJ,eAAe,GAAG,kBAAkB,GAAG,KAAK,CAAC,aAAa,EAC1D,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAUlD,CAAA;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAQ7G,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,KACf,MAAM,CAAC,MAAM,CACd,WAAW,GAAG,IAAI,EAClB,eAAe,GAAG,kBAAkB,EACpC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAoClD,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,QAAQ,WAAW,KAClB,MAAM,CAAC,MAAM,CACd,IAAI,EACJ,eAAe,GAAG,kBAAkB,GAAG,KAAK,CAAC,aAAa,EAC1D,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAUlD,CAAA;AAEJ;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,UAAU,EAAE,WAAU,MAAsB,KAAG,OAC1C,CAAA"}

package/dist/config/TokenStorage.js

@@ -0,0 +1,128 @@
+import * as FileSystem from "@effect/platform/FileSystem";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import {} from "./ConfigPaths.js";
+import { ensureConfigDir, getAuthPath, getOAuthConfigPath, writeSecureFile } from "./ConfigPaths.js";
+import { OAuthConfigSchema, OAuthTokenSchema } from "./OAuthSchemas.js";
+/**
+ * Error during file system operations.
+ *
+ * @category Errors
+ */
+export class FileSystemError extends Data.TaggedError("FileSystemError") {
+    get message() {
+        return `Failed to ${this.operation} file at ${this.path}`;
+    }
+}
+/**
+ * Load stored OAuth token from disk.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ * @returns The stored token or null if not found/invalid
+ *
+ * @category Token Storage
+ */
+export const loadToken = (toolName) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const tokenPath = yield* getAuthPath(toolName);
+    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 })));
+    const parsed = yield* Effect.sync(() => {
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    });
+    if (parsed === null) {
+        yield* Effect.logWarning(`Corrupted auth.json at ${tokenPath} — could not parse JSON`);
+        return null;
+    }
+    return yield* Schema.decodeUnknown(OAuthTokenSchema)(parsed).pipe(Effect.catchAll((e) => Effect.logWarning(`Invalid token schema in ${tokenPath}: ${e}`).pipe(Effect.map(() => null))));
+});
+/**
+ * Save OAuth token to disk with secure permissions.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ * @param token - The token to save
+ *
+ * @category Token Storage
+ */
+export const saveToken = (toolName, token) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    yield* ensureConfigDir(toolName);
+    const tokenPath = yield* getAuthPath(toolName);
+    yield* writeSecureFile(tokenPath, JSON.stringify(token, null, 2)).pipe(Effect.provideService(FileSystem.FileSystem, fs));
+});
+/**
+ * Delete stored OAuth token.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ *
+ * @category Token Storage
+ */
+export const deleteToken = (toolName) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const tokenPath = yield* getAuthPath(toolName);
+    yield* fs.remove(tokenPath).pipe(Effect.catchAll(() => Effect.void));
+});
+/**
+ * Load OAuth client configuration from disk.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ * @returns The stored config or null if not found/invalid
+ *
+ * @category OAuth Config
+ */
+export const loadOAuthConfig = (toolName) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const configPath = yield* getOAuthConfigPath(toolName);
+    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 })));
+    const parsed = yield* Effect.sync(() => {
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    });
+    if (parsed === null) {
+        yield* Effect.logWarning(`Corrupted oauth config at ${configPath} — could not parse JSON`);
+        return null;
+    }
+    return yield* Schema.decodeUnknown(OAuthConfigSchema)(parsed).pipe(Effect.catchAll((e) => Effect.logWarning(`Invalid OAuth config schema in ${configPath}: ${e}`).pipe(Effect.map(() => null))));
+});
+/**
+ * Save OAuth client configuration to disk with secure permissions.
+ *
+ * @param toolName - The tool name (e.g., "confluence", "jira")
+ * @param config - The config to save
+ *
+ * @category OAuth Config
+ */
+export const saveOAuthConfig = (toolName, config) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    yield* ensureConfigDir(toolName);
+    const configPath = yield* getOAuthConfigPath(toolName);
+    yield* writeSecureFile(configPath, JSON.stringify(config, null, 2)).pipe(Effect.provideService(FileSystem.FileSystem, fs));
+});
+/**
+ * Check if token is expired or about to expire.
+ *
+ * @param token - The token to check
+ * @param bufferMs - Buffer time in ms before expiration (default: 5 minutes)
+ * @returns True if token is expired or will expire within buffer time
+ *
+ * @category Utilities
+ */
+export const isTokenExpired = (token, bufferMs = 5 * 60 * 1000) => Date.now() >= token.expires_at - bufferMs;
+//# sourceMappingURL=TokenStorage.js.map

package/dist/config/TokenStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenStorage.js","sourceRoot":"","sources":["../../src/config/TokenStorage.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,UAAU,MAAM,6BAA6B,CAAA;AAEzD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAkD,MAAM,kBAAkB,CAAA;AACjF,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACpG,OAAO,EAAoB,iBAAiB,EAAmB,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAE1G;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAIrE;IACA,IAAa,OAAO;QAClB,OAAO,aAAa,IAAI,CAAC,SAAS,YAAY,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3D,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,QAAgB,EAKhB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAA;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;IAE9C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAC7C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAC7C,CAAA;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,IAAI,CACtD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAC/F,CAAA;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACrC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAC,CAAA;IACF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,0BAA0B,SAAS,yBAAyB,CAAC,CAAA;QACtF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAC/D,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,MAAM,CAAC,UAAU,CAAC,2BAA2B,SAAS,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAClE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CACvB,CACF,CACF,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,QAAgB,EAChB,KAAiB,EAKjB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAA;IACvC,KAAK,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAA;IAChC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;IAE9C,KAAK,CAAC,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CACpE,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,CACjD,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,QAAgB,EACiG,EAAE,CACnH,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAA;IACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;IAE9C,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CACnC,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAgB,EAKhB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAA;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IAEtD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAC9C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAC7C,CAAA;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,IAAI,CACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAChG,CAAA;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACrC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAA;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAC,CAAA;IACF,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,6BAA6B,UAAU,yBAAyB,CAAC,CAAA;QAC1F,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAChE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACpB,MAAM,CAAC,UAAU,CAAC,kCAAkC,UAAU,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAC1E,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CACvB,CACF,CACF,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAgB,EAChB,MAAmB,EAKnB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAA;IACvC,KAAK,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAA;IAChC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAA;IAEtD,KAAK,CAAC,CAAC,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CACtE,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,CAAC,CACjD,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAiB,EAAE,WAAmB,CAAC,GAAG,EAAE,GAAG,IAAI,EAAW,EAAE,CAC7F,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAA"}

package/dist/config/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Barrel export for config path utilities, schemas, and token storage.
+ *
+ * @module
+ */
+export { ensureConfigDir, getAuthPath, getConfigDir, getOAuthConfigPath, type HomeDirectory, HomeDirectoryError, HomeDirectoryLive, HomeDirectoryTag, writeSecureFile } from "./ConfigPaths.js";
+export { type AtlassianSite, AtlassianSiteSchema, type AtlassianUser, AtlassianUserSchema, type OAuthConfig, OAuthConfigSchema, type OAuthToken, OAuthTokenSchema, type OAuthUser, OAuthUserSchema } from "./OAuthSchemas.js";
+export { deleteToken, FileSystemError, isTokenExpired, loadOAuthConfig, loadToken, saveOAuthConfig, saveToken } from "./TokenStorage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,KAAK,aAAa,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,WAAW,EAChB,iBAAiB,EACjB,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,SAAS,EACd,eAAe,EAChB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACT,eAAe,EACf,SAAS,EACV,MAAM,mBAAmB,CAAA"}

package/dist/config/index.js

@@ -0,0 +1,12 @@
+/**
+ * Barrel export for config path utilities, schemas, and token storage.
+ *
+ * @module
+ */
+// Config paths
+export { ensureConfigDir, getAuthPath, getConfigDir, getOAuthConfigPath, HomeDirectoryError, HomeDirectoryLive, HomeDirectoryTag, writeSecureFile } from "./ConfigPaths.js";
+// OAuth schemas
+export { AtlassianSiteSchema, AtlassianUserSchema, OAuthConfigSchema, OAuthTokenSchema, OAuthUserSchema } from "./OAuthSchemas.js";
+// Token storage
+export { deleteToken, FileSystemError, isTokenExpired, loadOAuthConfig, loadToken, saveOAuthConfig, saveToken } from "./TokenStorage.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EACL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,kBAAkB,EAElB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAEzB,gBAAgB;AAChB,OAAO,EAEL,mBAAmB,EAEnB,mBAAmB,EAEnB,iBAAiB,EAEjB,gBAAgB,EAEhB,eAAe,EAChB,MAAM,mBAAmB,CAAA;AAE1B,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACT,eAAe,EACf,SAAS,EACV,MAAM,mBAAmB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Root barrel export for `@knpkv/atlassian-common` — AST nodes, auth, config, serializers.
+ *
+ * @module
+ */
+export * from "./ast/index.js";
+export { ContentHash, IssueKey, makeBrandedNonEmptyString, makeBrandedString, PageId, ProjectKey, SpaceKey } from "./Brand.js";
+export { hashBuffer, hashContent, hashContentSync, hashEquals } from "./Hash.js";
+export { ParseError, SerializeError } from "./SerializeError.js";
+export { serializeInlineNodes, type SerializeOptions, serializeToMarkdown } from "./serializers/index.js";
+export * from "./config/index.js";
+export * from "./auth/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,gBAAgB,CAAA;AAG9B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,yBAAyB,EACzB,iBAAiB,EACjB,MAAM,EACN,UAAU,EACV,QAAQ,EACT,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAGhF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGhE,OAAO,EAAE,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAGzG,cAAc,mBAAmB,CAAA;AAGjC,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Root barrel export for `@knpkv/atlassian-common` — AST nodes, auth, config, serializers.
+ *
+ * @module
+ */
+// AST types
+export * from "./ast/index.js";
+// Brand utilities
+export { ContentHash, IssueKey, makeBrandedNonEmptyString, makeBrandedString, PageId, ProjectKey, SpaceKey } from "./Brand.js";
+// Hash utilities
+export { hashBuffer, hashContent, hashContentSync, hashEquals } from "./Hash.js";
+// Error types
+export { ParseError, SerializeError } from "./SerializeError.js";
+// Serializers
+export { serializeInlineNodes, serializeToMarkdown } from "./serializers/index.js";
+// Config utilities
+export * from "./config/index.js";
+// Auth utilities
+export * from "./auth/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY;AACZ,cAAc,gBAAgB,CAAA;AAE9B,kBAAkB;AAClB,OAAO,EACL,WAAW,EACX,QAAQ,EACR,yBAAyB,EACzB,iBAAiB,EACjB,MAAM,EACN,UAAU,EACV,QAAQ,EACT,MAAM,YAAY,CAAA;AAEnB,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEhF,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEhE,cAAc;AACd,OAAO,EAAE,oBAAoB,EAAyB,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEzG,mBAAmB;AACnB,cAAc,mBAAmB,CAAA;AAEjC,iBAAiB;AACjB,cAAc,iBAAiB,CAAA"}

package/dist/parsers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Barrel export for content parsers (placeholder — not yet implemented).
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/parsers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAA"}

package/dist/parsers/index.js

@@ -0,0 +1,8 @@
+/**
+ * Barrel export for content parsers (placeholder — not yet implemented).
+ *
+ * @module
+ */
+// TODO: Extract MarkdownParser from confluence-to-markdown
+export {};
+//# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2DAA2D;AAC3D,OAAO,EAAE,CAAA"}

package/dist/serializers/MarkdownSerializer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * AST-to-Markdown serializer with roundtrip comment encoding for non-Markdown features.
+ *
+ * **Mental model**
+ *
+ * - **Visitor over DocumentNode union**: {@link serializeToMarkdown} walks the AST, dispatching
+ *   on `_tag` to emit Markdown. Effect-based for composability with the rest of the pipeline.
+ * - **Roundtrip via HTML comments**: Confluence-specific data (panel types, task status,
+ *   image alignment) is encoded in `<!-- ... -->` comments with base64/URL encoding so
+ *   a future parser can reconstruct the original.
+ *
+ * **Common tasks**
+ *
+ * - Serialize a document: {@link serializeToMarkdown}
+ * - Serialize inline nodes only: {@link serializeInlineNodes}
+ *
+ * **Gotchas**
+ *
+ * - Comment-encoded data is fragile if users hand-edit the Markdown — edits inside
+ *   `<!-- -->` blocks will break roundtripping.
+ *
+ * @module
+ */
+import * as Effect from "effect/Effect";
+import type { Document } from "../ast/Document.js";
+import type { InlineNode } from "../ast/InlineNode.js";
+import type { SerializeError } from "../SerializeError.js";
+/**
+ * Options for Markdown serialization.
+ *
+ * @category Serializers
+ */
+export interface SerializeOptions {
+    /** Include raw source for lossless roundtrip. Default: false */
+    readonly includeRawSource?: boolean;
+    /** Custom comment prefix for roundtrip encoding. Default: "src" */
+    readonly commentPrefix?: string;
+}
+/**
+ * Serialize Document AST to GitHub Flavored Markdown.
+ *
+ * @example
+ * ```typescript
+ * import { serializeToMarkdown, makeDocument, Heading, Text } from "@knpkv/atlassian-common"
+ * import { Effect } from "effect"
+ *
+ * Effect.gen(function* () {
+ *   const doc = makeDocument([
+ *     new Heading({ level: 1, children: [new Text({ value: "Title" })] })
+ *   ])
+ *   const md = yield* serializeToMarkdown(doc)
+ *   console.log(md) // # Title
+ * })
+ * ```
+ *
+ * @category Serializers
+ */
+export declare const serializeToMarkdown: (doc: Document, options?: SerializeOptions) => Effect.Effect<string, SerializeError>;
+/**
+ * Serialize inline nodes to Markdown.
+ */
+export declare const serializeInlineNodes: (nodes: ReadonlyArray<InlineNode>) => Effect.Effect<string, SerializeError>;
+//# sourceMappingURL=MarkdownSerializer.d.ts.map

package/dist/serializers/MarkdownSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownSerializer.d.ts","sourceRoot":"","sources":["../../src/serializers/MarkdownSerializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IACnC,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,KAAK,QAAQ,EACb,UAAS,gBAAqB,KAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAkBnC,CAAA;AAuVJ;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,aAAa,CAAC,UAAU,CAAC,KAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAOnC,CAAA"}