@knpkv/jira-api-client 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @knpkv/jira-api-client
+
+## 0.2.0
+
+### Minor Changes
+
+- [#61](https://github.com/knpkv/npm/pull/61) [`fc7be8f`](https://github.com/knpkv/npm/commit/fc7be8ffaf5b6b094c7f81551e8ace6f2a8f2c4c) Thanks @konopkov! - feat: add jira-api-client and atlassian-common packages
+  - New @knpkv/atlassian-common: shared AST types, serializers, auth, and config
+  - New @knpkv/jira-api-client: Effect-based Jira REST API client (openapi-gen)
+  - Updated @knpkv/confluence-api-client: regenerated with openapi-gen
+  - Updated @knpkv/confluence-to-markdown: use new generated API client

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 knpkv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @knpkv/jira-api-client
+
+Effect-based Jira Cloud REST API v3 client. Type-safe paths and responses generated from the official OpenAPI schema via `openapi-typescript` + `openapi-fetch`.
+
+## Installation
+
+```bash
+pnpm add @knpkv/jira-api-client
+```
+
+Peer dependencies: `effect`
+
+## Usage
+
+```typescript
+import { Effect, Layer } from "effect"
+import * as Redacted from "effect/Redacted"
+import { JiraApiClient, JiraApiConfig, toEffect } from "@knpkv/jira-api-client"
+
+const program = Effect.gen(function* () {
+  const client = yield* JiraApiClient
+
+  // Get issue by key
+  const issue = yield* toEffect(
+    client.v3.client.GET("/rest/api/3/issue/{issueIdOrKey}", {
+      params: { path: { issueIdOrKey: "PROJ-123" } }
+    })
+  )
+  console.log(issue.fields?.summary)
+
+  // Search with JQL
+  const results = yield* toEffect(
+    client.v3.client.POST("/rest/api/3/search/jql", {
+      body: { jql: "project = PROJ AND status != Done", maxResults: 50 }
+    })
+  )
+})
+
+// Basic auth
+const configLayer = Layer.succeed(JiraApiConfig, {
+  baseUrl: "https://mysite.atlassian.net",
+  auth: {
+    type: "basic",
+    email: "user@example.com",
+    apiToken: Redacted.make("your-api-token")
+  }
+})
+
+// Or OAuth2
+const oauthConfigLayer = Layer.succeed(JiraApiConfig, {
+  baseUrl: "",
+  auth: {
+    type: "oauth2",
+    accessToken: Redacted.make("oauth-access-token"),
+    cloudId: "your-cloud-id"
+  }
+})
+
+Effect.runPromise(program.pipe(Effect.provide(JiraApiClient.layer), Effect.provide(configLayer)))
+```
+
+## API Pattern
+
+All API calls go through `toEffect()` which wraps the openapi-fetch promise in an Effect:
+
+```typescript
+toEffect(client.v3.client.GET("/rest/api/3/..."))
+// → Effect<ResponseData, FetchClientError>
+```
+
+Paths are fully type-safe — autocomplete and compile-time errors for invalid paths, params, and bodies.
+
+## Errors
+
+`FetchClientError` is a tagged error with `error`, `status`, and `message` fields:
+
+```typescript
+import { FetchClientError } from "@knpkv/jira-api-client"
+
+program.pipe(Effect.catchTag("FetchClientError", (e) => Console.log(`HTTP ${e.status}: ${e.message}`)))
+```
+
+## Subpath Exports
+
+| Export                                 | Contents                        |
+| -------------------------------------- | ------------------------------- |
+| `@knpkv/jira-api-client`               | Client, config, toEffect, types |
+| `@knpkv/jira-api-client/v3`            | Generated V3 OpenAPI types      |
+| `@knpkv/jira-api-client/JiraApiClient` | Client service only             |
+| `@knpkv/jira-api-client/JiraApiConfig` | Config service only             |
+
+## License
+
+MIT

package/dist/JiraApiClient.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Effect Layer wrapping openapi-fetch Jira V3 client with auth and base URL.
+ *
+ * **Mental model**
+ *
+ * - **Auth-polymorphic**: Supports both Basic (email + API token) and OAuth2 (access token +
+ *   cloud ID) auth. The layer reads {@link JiraApiConfig} to build the Authorization header
+ *   and derive the correct base URL.
+ * - **openapi-fetch wrapper**: Uses {@link OpenApiFetchClient} for Effect-based methods.
+ *
+ * **Common tasks**
+ *
+ * - Use the client: `const jira = yield* JiraApiClient; jira.v3.GET(...)`
+ * - Provide the layer: `Effect.provide(JiraApiClient.layer)`
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import type { paths as V3Paths } from "./generated/v3/schema.js";
+import { JiraApiConfig } from "./JiraApiConfig.js";
+import { type OpenApiFetchClient } from "./OpenApiFetchClient.js";
+/**
+ * Jira API client shape (v3 only).
+ *
+ * @example
+ * ```typescript
+ * import { toEffect } from "@knpkv/jira-api-client"
+ *
+ * // Get issue by key
+ * toEffect(client.v3.client.GET("/rest/api/3/issue/{issueIdOrKey}", {
+ *   params: { path: { issueIdOrKey: "PROJ-123" } }
+ * }))
+ *
+ * // Search issues with JQL
+ * toEffect(client.v3.client.POST("/rest/api/3/search/jql", {
+ *   body: { jql: "project = PROJ", maxResults: 50 }
+ * }))
+ * ```
+ *
+ * @category Client
+ */
+export interface JiraApiClientShape {
+    readonly v3: OpenApiFetchClient<V3Paths>;
+}
+declare const JiraApiClient_base: Context.TagClass<JiraApiClient, "@knpkv/jira-api-client/JiraApiClient", JiraApiClientShape>;
+/**
+ * Jira API client service.
+ *
+ * @example
+ * ```typescript
+ * import { JiraApiClient, JiraApiConfig } from "@knpkv/jira-api-client"
+ * import * as Redacted from "effect/Redacted"
+ * import * as Effect from "effect/Effect"
+ * import * as Layer from "effect/Layer"
+ *
+ * const program = Effect.gen(function* () {
+ *   const client = yield* JiraApiClient
+ *   const issue = yield* toEffect(client.v3.client.GET("/rest/api/3/issue/{issueIdOrKey}", {
+ *     params: { path: { issueIdOrKey: "PROJ-123" } }
+ *   }))
+ *   console.log(issue.fields?.summary)
+ * })
+ *
+ * const configLayer = Layer.succeed(JiraApiConfig, {
+ *   baseUrl: "https://mysite.atlassian.net",
+ *   auth: {
+ *     type: "basic",
+ *     email: "user@example.com",
+ *     apiToken: Redacted.make("token")
+ *   }
+ * })
+ *
+ * Effect.runPromise(
+ *   program.pipe(
+ *     Effect.provide(JiraApiClient.layer),
+ *     Effect.provide(configLayer)
+ *   )
+ * )
+ * ```
+ *
+ * @category Client
+ */
+export declare class JiraApiClient extends JiraApiClient_base {
+    /**
+     * Layer that provides JiraApiClient.
+     *
+     * Requires: JiraApiConfig
+     */
+    static readonly layer: Layer.Layer<JiraApiClient, never, JiraApiConfig>;
+}
+/**
+ * Layer that provides JiraApiClient.
+ *
+ * @category Layers
+ */
+export declare const layer: Layer.Layer<JiraApiClient, never, JiraApiConfig>;
+export {};
+//# sourceMappingURL=JiraApiClient.d.ts.map

package/dist/JiraApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JiraApiClient.d.ts","sourceRoot":"","sources":["../src/JiraApiClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAGzC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,EAAE,KAAK,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEzF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAA;CACzC;;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,aAAc,SAAQ,kBAEG;IACpC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,aAAa,CAAC,CAyBtE;CACF;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK,kDAAsB,CAAA"}

package/dist/JiraApiClient.js

@@ -0,0 +1,94 @@
+/**
+ * Effect Layer wrapping openapi-fetch Jira V3 client with auth and base URL.
+ *
+ * **Mental model**
+ *
+ * - **Auth-polymorphic**: Supports both Basic (email + API token) and OAuth2 (access token +
+ *   cloud ID) auth. The layer reads {@link JiraApiConfig} to build the Authorization header
+ *   and derive the correct base URL.
+ * - **openapi-fetch wrapper**: Uses {@link OpenApiFetchClient} for Effect-based methods.
+ *
+ * **Common tasks**
+ *
+ * - Use the client: `const jira = yield* JiraApiClient; jira.v3.GET(...)`
+ * - Provide the layer: `Effect.provide(JiraApiClient.layer)`
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Encoding from "effect/Encoding";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { JiraApiConfig } from "./JiraApiConfig.js";
+import { makeOpenApiFetchClient } from "./OpenApiFetchClient.js";
+/**
+ * Jira API client service.
+ *
+ * @example
+ * ```typescript
+ * import { JiraApiClient, JiraApiConfig } from "@knpkv/jira-api-client"
+ * import * as Redacted from "effect/Redacted"
+ * import * as Effect from "effect/Effect"
+ * import * as Layer from "effect/Layer"
+ *
+ * const program = Effect.gen(function* () {
+ *   const client = yield* JiraApiClient
+ *   const issue = yield* toEffect(client.v3.client.GET("/rest/api/3/issue/{issueIdOrKey}", {
+ *     params: { path: { issueIdOrKey: "PROJ-123" } }
+ *   }))
+ *   console.log(issue.fields?.summary)
+ * })
+ *
+ * const configLayer = Layer.succeed(JiraApiConfig, {
+ *   baseUrl: "https://mysite.atlassian.net",
+ *   auth: {
+ *     type: "basic",
+ *     email: "user@example.com",
+ *     apiToken: Redacted.make("token")
+ *   }
+ * })
+ *
+ * Effect.runPromise(
+ *   program.pipe(
+ *     Effect.provide(JiraApiClient.layer),
+ *     Effect.provide(configLayer)
+ *   )
+ * )
+ * ```
+ *
+ * @category Client
+ */
+export class JiraApiClient extends Context.Tag("@knpkv/jira-api-client/JiraApiClient")() {
+    /**
+     * Layer that provides JiraApiClient.
+     *
+     * Requires: JiraApiConfig
+     */
+    static layer = Layer.effect(JiraApiClient, Effect.gen(function* () {
+        const config = yield* JiraApiConfig;
+        // Build auth header
+        const authHeader = config.auth.type === "basic"
+            ? `Basic ${Encoding.encodeBase64(`${config.auth.email}:${Redacted.value(config.auth.apiToken)}`)}`
+            : `Bearer ${Redacted.value(config.auth.accessToken)}`;
+        // Base URL differs by auth type
+        const baseUrl = config.auth.type === "oauth2"
+            ? `https://api.atlassian.com/ex/jira/${config.auth.cloudId}`
+            : config.baseUrl;
+        const headers = {
+            Authorization: authHeader,
+            Accept: "application/json",
+            "Content-Type": "application/json"
+        };
+        return {
+            v3: makeOpenApiFetchClient(baseUrl, headers)
+        };
+    }));
+}
+/**
+ * Layer that provides JiraApiClient.
+ *
+ * @category Layers
+ */
+export const layer = JiraApiClient.layer;
+//# sourceMappingURL=JiraApiClient.js.map

package/dist/JiraApiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JiraApiClient.js","sourceRoot":"","sources":["../src/JiraApiClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,sBAAsB,EAA2B,MAAM,yBAAyB,CAAA;AA0BzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO,CAAC,GAAG,CAC5C,sCAAsC,CACvC,EAAqC;IACpC;;;;OAIG;IACH,MAAM,CAAU,KAAK,GAAqD,KAAK,CAAC,MAAM,CACpF,aAAa,EACb,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,aAAa,CAAA;QAEnC,oBAAoB;QACpB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;YAC7C,CAAC,CAAC,SAAS,QAAQ,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;YAClG,CAAC,CAAC,UAAU,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAA;QAEvD,gCAAgC;QAChC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;YAC3C,CAAC,CAAC,qCAAqC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YAC5D,CAAC,CAAC,MAAM,CAAC,OAAO,CAAA;QAElB,MAAM,OAAO,GAAG;YACd,aAAa,EAAE,UAAU;YACzB,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;SACnC,CAAA;QAED,OAAO;YACL,EAAE,EAAE,sBAAsB,CAAU,OAAO,EAAE,OAAO,CAAC;SACtD,CAAA;IACH,CAAC,CAAC,CACH,CAAA;;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAA"}

package/dist/JiraApiConfig.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Configuration service tag for the Jira API client (basic or OAuth2 auth).
+ *
+ * **Mental model**
+ *
+ * - **Discriminated auth union**: The `auth` field is `{ type: "basic", ... } | { type: "oauth2", ... }`.
+ *   Basic auth uses email + Redacted API token; OAuth2 uses Redacted access token + cloud ID.
+ * - **Base URL routing**: For OAuth2, the base URL is derived from cloud ID (`api.atlassian.com/ex/jira/{cloudId}`);
+ *   for basic auth, `baseUrl` is used directly.
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+import type * as Redacted from "effect/Redacted";
+/**
+ * Configuration shape for Jira API client.
+ *
+ * @category Config
+ */
+export interface JiraApiConfigShape {
+    readonly baseUrl: string;
+    readonly auth: {
+        readonly type: "basic";
+        readonly email: string;
+        readonly apiToken: Redacted.Redacted<string>;
+    } | {
+        readonly type: "oauth2";
+        readonly accessToken: Redacted.Redacted<string>;
+        readonly cloudId: string;
+    };
+}
+declare const JiraApiConfig_base: Context.TagClass<JiraApiConfig, "@knpkv/jira-api-client/JiraApiConfig", JiraApiConfigShape>;
+/**
+ * Jira API configuration service.
+ *
+ * @example
+ * ```typescript
+ * import { JiraApiConfig } from "@knpkv/jira-api-client"
+ * import * as Redacted from "effect/Redacted"
+ * import * as Layer from "effect/Layer"
+ *
+ * const configLayer = Layer.succeed(JiraApiConfig, {
+ *   baseUrl: "https://mysite.atlassian.net",
+ *   auth: {
+ *     type: "basic",
+ *     email: "user@example.com",
+ *     apiToken: Redacted.make("token")
+ *   }
+ * })
+ * ```
+ *
+ * @category Config
+ */
+export declare class JiraApiConfig extends JiraApiConfig_base {
+}
+export {};
+//# sourceMappingURL=JiraApiConfig.d.ts.map

package/dist/JiraApiConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JiraApiConfig.d.ts","sourceRoot":"","sources":["../src/JiraApiConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAEhD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EACT;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;KAAE,GAChG;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC3G;;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAc,SAAQ,kBAEG;CAAG"}

package/dist/JiraApiConfig.js

@@ -0,0 +1,37 @@
+/**
+ * Configuration service tag for the Jira API client (basic or OAuth2 auth).
+ *
+ * **Mental model**
+ *
+ * - **Discriminated auth union**: The `auth` field is `{ type: "basic", ... } | { type: "oauth2", ... }`.
+ *   Basic auth uses email + Redacted API token; OAuth2 uses Redacted access token + cloud ID.
+ * - **Base URL routing**: For OAuth2, the base URL is derived from cloud ID (`api.atlassian.com/ex/jira/{cloudId}`);
+ *   for basic auth, `baseUrl` is used directly.
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+/**
+ * Jira API configuration service.
+ *
+ * @example
+ * ```typescript
+ * import { JiraApiConfig } from "@knpkv/jira-api-client"
+ * import * as Redacted from "effect/Redacted"
+ * import * as Layer from "effect/Layer"
+ *
+ * const configLayer = Layer.succeed(JiraApiConfig, {
+ *   baseUrl: "https://mysite.atlassian.net",
+ *   auth: {
+ *     type: "basic",
+ *     email: "user@example.com",
+ *     apiToken: Redacted.make("token")
+ *   }
+ * })
+ * ```
+ *
+ * @category Config
+ */
+export class JiraApiConfig extends Context.Tag("@knpkv/jira-api-client/JiraApiConfig")() {
+}
+//# sourceMappingURL=JiraApiConfig.js.map

package/dist/JiraApiConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JiraApiConfig.js","sourceRoot":"","sources":["../src/JiraApiConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAezC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO,CAAC,GAAG,CAC5C,sCAAsC,CACvC,EAAqC;CAAG"}

package/dist/OpenApiFetchClient.d.ts

@@ -0,0 +1,55 @@
+import * as Effect from "effect/Effect";
+import { type Client, type FetchResponse } from "openapi-fetch";
+import type { MediaType } from "openapi-typescript-helpers";
+declare const FetchClientError_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: "FetchClientError";
+} & Readonly<A>;
+/**
+ * Error from openapi-fetch operations.
+ *
+ * @category Errors
+ */
+export declare class FetchClientError extends FetchClientError_base<{
+    readonly error: unknown;
+    readonly status: number;
+    readonly message: string;
+}> {
+}
+/** Extract success `data` from a FetchResponse discriminated union. */
+export type SuccessData<T> = T extends {
+    data: infer D;
+    error?: undefined;
+} ? D : T extends {
+    data?: infer D;
+} ? NonNullable<D> : never;
+/**
+ * Wrap an openapi-fetch `Promise<FetchResponse>` in Effect.
+ *
+ * Extracts `data` on success, maps errors to `FetchClientError`.
+ * Fully type-safe — path/body constraints come from the `Client<Paths>` call site.
+ *
+ * @example
+ * ```typescript
+ * const page = yield* toEffect(client.GET("/pages/{id}", { params: { path: { id: 123 } } }))
+ * ```
+ *
+ * @category Utilities
+ */
+export declare const toEffect: <T extends Record<string | number, any>, O, M extends MediaType>(promise: Promise<FetchResponse<T, O, M>>) => Effect.Effect<SuccessData<FetchResponse<T, O, M>>, FetchClientError>;
+/**
+ * openapi-fetch client paired with the `toEffect` helper.
+ *
+ * @category Client
+ */
+export interface OpenApiFetchClient<Paths extends {}> {
+    /** Type-safe openapi-fetch client. Use with `toEffect()` to get Effect. */
+    readonly client: Client<Paths, "application/json">;
+}
+/**
+ * Create an openapi-fetch client with auth headers pre-configured.
+ *
+ * @category Constructors
+ */
+export declare const makeOpenApiFetchClient: <Paths extends {}>(baseUrl: string, headers: Record<string, string>) => OpenApiFetchClient<Paths>;
+export {};
+//# sourceMappingURL=OpenApiFetchClient.d.ts.map

package/dist/OpenApiFetchClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiFetchClient.d.ts","sourceRoot":"","sources":["../src/OpenApiFetchClient.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAqB,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;;;;AAE3D;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,sBAAqC;IACzE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAC;CAAG;AAEL,uEAAuE;AACvE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,CAAC,GAC3E,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,WAAW,CAAC,CAAC,CAAC,GAC7C,KAAK,CAAA;AAET;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,SAAS,EACrF,SAAS,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KACvC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAiBlE,CAAA;AAEJ;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,SAAS,EAAE;IAClD,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAA;CACnD;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,SAAS,EAAE,EACrD,SAAS,MAAM,EACf,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC9B,kBAAkB,CAAC,KAAK,CAEzB,CAAA"}

package/dist/OpenApiFetchClient.js

@@ -0,0 +1,63 @@
+/**
+ * Generic Effect wrapper for openapi-fetch clients.
+ *
+ * Exposes a type-safe `Client<Paths>` and a `toEffect` helper that wraps
+ * any `Promise<FetchResponse>` in Effect with error mapping.
+ *
+ * @example
+ * ```typescript
+ * const page = yield* toEffect(client.GET("/pages/{id}", {
+ *   params: { path: { id: 123 } }
+ * }))
+ * ```
+ *
+ * @module
+ */
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import createClient, {} from "openapi-fetch";
+/**
+ * Error from openapi-fetch operations.
+ *
+ * @category Errors
+ */
+export class FetchClientError extends Data.TaggedError("FetchClientError") {
+}
+/**
+ * Wrap an openapi-fetch `Promise<FetchResponse>` in Effect.
+ *
+ * Extracts `data` on success, maps errors to `FetchClientError`.
+ * Fully type-safe — path/body constraints come from the `Client<Paths>` call site.
+ *
+ * @example
+ * ```typescript
+ * const page = yield* toEffect(client.GET("/pages/{id}", { params: { path: { id: 123 } } }))
+ * ```
+ *
+ * @category Utilities
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- matches FetchResponse generic constraint
+export const toEffect = (promise) => Effect.tryPromise({
+    try: () => promise.then(({ data, error, response }) => {
+        if (error !== undefined || !response.ok) {
+            throw { error, status: response.status };
+        }
+        return data;
+    }),
+    catch: (e) => new FetchClientError({
+        error: e.error ?? e,
+        status: e.status ?? 0,
+        message: typeof e.error === "string"
+            ? e.error
+            : JSON.stringify(e.error ?? e)
+    })
+});
+/**
+ * Create an openapi-fetch client with auth headers pre-configured.
+ *
+ * @category Constructors
+ */
+export const makeOpenApiFetchClient = (baseUrl, headers) => ({
+    client: createClient({ baseUrl, headers })
+});
+//# sourceMappingURL=OpenApiFetchClient.js.map

package/dist/OpenApiFetchClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiFetchClient.js","sourceRoot":"","sources":["../src/OpenApiFetchClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,YAAY,EAAE,EAAmC,MAAM,eAAe,CAAA;AAG7E;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAIvE;CAAG;AAOL;;;;;;;;;;;;GAYG;AACH,0GAA0G;AAC1G,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,OAAwC,EAC8B,EAAE,CACxE,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,GAAG,EAAE,CACR,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE;QACzC,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;QAC1C,CAAC;QACD,OAAO,IAA2C,CAAA;IACpD,CAAC,CAAC;IACJ,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,IAAI,gBAAgB,CAAC;QACnB,KAAK,EAAG,CAA6B,CAAC,KAAK,IAAI,CAAC;QAChD,MAAM,EAAI,CAA6B,CAAC,MAA6B,IAAI,CAAC;QAC1E,OAAO,EAAE,OAAQ,CAA6B,CAAC,KAAK,KAAK,QAAQ;YAC/D,CAAC,CAAE,CAA6B,CAAC,KAAe;YAChD,CAAC,CAAC,IAAI,CAAC,SAAS,CAAE,CAA6B,CAAC,KAAK,IAAI,CAAC,CAAC;KAC9D,CAAC;CACL,CAAC,CAAA;AAYJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAe,EACf,OAA+B,EACJ,EAAE,CAAC,CAAC;IAC/B,MAAM,EAAE,YAAY,CAA4B,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;CACtE,CAAC,CAAA"}

package/dist/generated/v3/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generated Jira Cloud REST API v3 types.
+ *
+ * @module
+ */
+export type { components, operations, paths } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/generated/v3/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generated/v3/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA"}

package/dist/generated/v3/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/generated/v3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generated/v3/index.ts"],"names":[],"mappings":""}