@knpkv/clockify-api-client 0.2.0

package/.specs/clockify-v1.patch.json

@@ -0,0 +1,48 @@
+{
+  "$comment": "Patches for clockify-v1.json — the official spec has incomplete DTOs. Applied by scripts/regenerate.ts before generating types.",
+  "schemas": {
+    "UserDto": {
+      "addProperties": {
+        "activeWorkspace": { "type": "string" },
+        "defaultWorkspace": { "type": "string" },
+        "profilePicture": { "type": "string" },
+        "status": { "type": "string" }
+      },
+      "required": ["id", "name", "email", "activeWorkspace", "defaultWorkspace", "status"]
+    },
+    "TimeEntryDto": {
+      "renameProperties": {
+        "get_id": "id"
+      },
+      "addProperties": {
+        "workspaceId": { "type": "string" },
+        "type": { "type": "string" },
+        "isLocked": { "type": "boolean" },
+        "tagIds": { "type": "array", "items": { "type": "string" } }
+      },
+      "required": ["id", "description", "billable", "userId", "workspaceId", "timeInterval"]
+    },
+    "TimeIntervalDto": {
+      "required": ["start"],
+      "patchProperties": {
+        "end": { "type": "string", "format": "date-time", "nullable": true },
+        "duration": { "type": "string", "nullable": true }
+      }
+    },
+    "TagDto": {
+      "required": ["id", "name", "workspaceId", "archived"]
+    },
+    "ProjectDtoV1": {
+      "addProperties": {
+        "name": { "type": "string" },
+        "note": { "type": "string" },
+        "workspaceId": { "type": "string" },
+        "public": { "type": "boolean" }
+      },
+      "required": ["id", "name", "archived", "billable", "color", "workspaceId"]
+    },
+    "CreateTimeEntryRequest": {
+      "required": ["description", "start"]
+    }
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @knpkv/clockify-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,121 @@
+# @knpkv/clockify-api-client
+
+Effect-based Clockify REST API client. Type-safe paths and responses generated from a patched OpenAPI spec via `openapi-typescript` + `openapi-fetch`.
+
+## Installation
+
+```bash
+pnpm add @knpkv/clockify-api-client
+```
+
+Peer dependencies: `effect`
+
+## Usage
+
+### Method-based API
+
+Convenience methods for common operations:
+
+```typescript
+import { Effect, Layer } from "effect"
+import * as Redacted from "effect/Redacted"
+import { ClockifyApiClient, ClockifyApiConfig } from "@knpkv/clockify-api-client"
+
+const program = Effect.gen(function* () {
+  const clockify = yield* ClockifyApiClient
+
+  const user = yield* clockify.getUser()
+  const projects = yield* clockify.getProjects("workspace-id")
+
+  // Start a timer
+  const entry = yield* clockify.createTimeEntry("workspace-id", {
+    start: new Date().toISOString(),
+    description: "Working on PROJ-123"
+  })
+
+  // Stop timer
+  yield* clockify.stopTimer("workspace-id", user.id, {
+    end: new Date().toISOString()
+  })
+
+  // Get running timer
+  const running = yield* clockify.getRunningTimer("workspace-id", user.id)
+})
+
+const configLayer = Layer.succeed(ClockifyApiConfig, {
+  apiKey: Redacted.make("your-clockify-api-key"),
+  workspaceId: "workspace-id",
+  userId: "user-id",
+  baseUrl: "https://api.clockify.me/api"
+})
+
+Effect.runPromise(program.pipe(Effect.provide(ClockifyApiClient.layer), Effect.provide(configLayer)))
+```
+
+### Raw API
+
+Direct openapi-fetch access for any endpoint:
+
+```typescript
+import { toEffect } from "@knpkv/clockify-api-client"
+
+const program = Effect.gen(function* () {
+  const clockify = yield* ClockifyApiClient
+
+  const user = yield* toEffect(clockify.api.client.GET("/v1/user"))
+
+  const entries = yield* toEffect(
+    clockify.api.client.GET("/v1/workspaces/{workspaceId}/user/{userId}/time-entries", {
+      params: { path: { workspaceId: "ws-id", userId: "u-id" } }
+    })
+  )
+})
+```
+
+## Available Methods
+
+| Method                                   | Description                   |
+| ---------------------------------------- | ----------------------------- |
+| `getUser()`                              | Current authenticated user    |
+| `getWorkspaces()`                        | List workspaces               |
+| `getProjects(wsId)`                      | List projects in workspace    |
+| `getProjectByName(wsId, name)`           | Find project by name          |
+| `createTimeEntry(wsId, params)`          | Start or create entry         |
+| `stopTimer(wsId, userId, params)`        | Stop running timer            |
+| `getTimeEntries(wsId, userId, params?)`  | List time entries             |
+| `getRunningTimer(wsId, userId)`          | Get in-progress entry or null |
+| `getTimeEntry(wsId, entryId)`            | Get single entry              |
+| `updateTimeEntry(wsId, entryId, params)` | Update entry                  |
+| `deleteTimeEntry(wsId, entryId)`         | Delete entry                  |
+| `getTags(wsId)`                          | List tags                     |
+| `createTag(wsId, name)`                  | Create tag                    |
+| `findOrCreateTag(wsId, name)`            | Find or create tag            |
+
+## Errors
+
+`FetchClientError` — tagged error with `status` and `message`:
+
+```typescript
+import { FetchClientError } from "@knpkv/clockify-api-client"
+
+program.pipe(Effect.catchTag("FetchClientError", (e) => Console.log(`HTTP ${e.status}: ${e.message}`)))
+```
+
+## Notes
+
+- The OpenAPI spec is patched for accurate types (the official spec has gaps).
+- API key is stored as `Redacted<string>` to prevent accidental logging.
+
+## Subpath Exports
+
+| Export                                         | Contents                        |
+| ---------------------------------------------- | ------------------------------- |
+| `@knpkv/clockify-api-client`                   | Client, config, toEffect, types |
+| `@knpkv/clockify-api-client/generated`         | Generated OpenAPI types         |
+| `@knpkv/clockify-api-client/ClockifyApiClient` | Client service only             |
+| `@knpkv/clockify-api-client/ClockifyApiConfig` | Config service only             |
+| `@knpkv/clockify-api-client/ClockifyApiError`  | Error types                     |
+
+## License
+
+MIT

package/dist/ClockifyApiClient.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Effect Layer wrapping openapi-fetch Clockify v1 client with auth and base URL.
+ *
+ * **Mental model**
+ *
+ * - **Auth via X-Api-Key**: The layer reads {@link ClockifyApiConfig} to build the
+ *   `X-Api-Key` header and derive the base URL.
+ * - **openapi-fetch wrapper**: Uses {@link OpenApiFetchClient} for type-safe HTTP calls.
+ * - **Method-based interface**: Exposes convenience methods (getUser, createTimeEntry, etc.)
+ *   for backwards compatibility with jira-clockify consumers.
+ * - **Raw API access**: `.api` exposes the raw `OpenApiFetchClient<paths>` for direct access.
+ *
+ * **Common tasks**
+ *
+ * - Use the client: `const clockify = yield* ClockifyApiClient`
+ * - Call a method: `clockify.getProjects(workspaceId)`
+ * - Raw access: `toEffect(clockify.api.client.GET("/v1/user"))`
+ * - Provide the layer: `Effect.provide(ClockifyApiClient.layer)`
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { ClockifyApiConfig } from "./ClockifyApiConfig.js";
+import type { components, paths } from "./generated/schema.js";
+import { type FetchClientError, type OpenApiFetchClient } from "./OpenApiFetchClient.js";
+export type User = components["schemas"]["UserDto"];
+export type Workspace = components["schemas"]["WorkspaceDtoV1"];
+export type Project = components["schemas"]["ProjectDtoV1"];
+export type Tag = components["schemas"]["TagDto"];
+export type TimeInterval = components["schemas"]["TimeIntervalDto"];
+export type TimeEntry = components["schemas"]["TimeEntryDto"];
+export type CreateTimeEntryParams = components["schemas"]["CreateTimeEntryRequest"];
+export type StopTimeEntryParams = components["schemas"]["StopTimeEntryRequest"];
+export type UpdateTimeEntryParams = components["schemas"]["UpdateTimeEntryRequest"];
+export interface GetTimeEntriesParams {
+    readonly start?: string | undefined;
+    readonly end?: string | undefined;
+    readonly page?: number | undefined;
+    readonly pageSize?: number | undefined;
+}
+export interface ClockifyApiClientShape {
+    /** Raw openapi-fetch client for direct type-safe API access. */
+    readonly api: OpenApiFetchClient<paths>;
+    readonly getUser: () => Effect.Effect<User, FetchClientError>;
+    readonly getWorkspaces: () => Effect.Effect<ReadonlyArray<Workspace>, FetchClientError>;
+    readonly getProjects: (workspaceId: string) => Effect.Effect<ReadonlyArray<Project>, FetchClientError>;
+    readonly getProjectByName: (workspaceId: string, name: string) => Effect.Effect<Project | null, FetchClientError>;
+    readonly createTimeEntry: (workspaceId: string, params: CreateTimeEntryParams) => Effect.Effect<TimeEntry, FetchClientError>;
+    readonly stopTimer: (workspaceId: string, userId: string, params: StopTimeEntryParams) => Effect.Effect<TimeEntry, FetchClientError>;
+    readonly getTimeEntries: (workspaceId: string, userId: string, params?: GetTimeEntriesParams) => Effect.Effect<ReadonlyArray<TimeEntry>, FetchClientError>;
+    readonly getRunningTimer: (workspaceId: string, userId: string) => Effect.Effect<TimeEntry | null, FetchClientError>;
+    readonly getTags: (workspaceId: string) => Effect.Effect<ReadonlyArray<Tag>, FetchClientError>;
+    readonly createTag: (workspaceId: string, name: string) => Effect.Effect<Tag, FetchClientError>;
+    readonly findOrCreateTag: (workspaceId: string, name: string) => Effect.Effect<Tag, FetchClientError>;
+    readonly getTimeEntry: (workspaceId: string, timeEntryId: string) => Effect.Effect<TimeEntry, FetchClientError>;
+    readonly deleteTimeEntry: (workspaceId: string, timeEntryId: string) => Effect.Effect<void, FetchClientError>;
+    readonly updateTimeEntry: (workspaceId: string, timeEntryId: string, params: UpdateTimeEntryParams) => Effect.Effect<TimeEntry, FetchClientError>;
+}
+declare const ClockifyApiClient_base: Context.TagClass<ClockifyApiClient, "@knpkv/clockify-api-client/ClockifyApiClient", ClockifyApiClientShape>;
+export declare class ClockifyApiClient extends ClockifyApiClient_base {
+    static readonly layer: Layer.Layer<ClockifyApiClient, never, ClockifyApiConfig>;
+}
+export declare const layer: Layer.Layer<ClockifyApiClient, never, ClockifyApiConfig>;
+export {};
+//# sourceMappingURL=ClockifyApiClient.d.ts.map

package/dist/ClockifyApiClient.d.ts.map

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

package/dist/ClockifyApiClient.js

@@ -0,0 +1,141 @@
+/**
+ * Effect Layer wrapping openapi-fetch Clockify v1 client with auth and base URL.
+ *
+ * **Mental model**
+ *
+ * - **Auth via X-Api-Key**: The layer reads {@link ClockifyApiConfig} to build the
+ *   `X-Api-Key` header and derive the base URL.
+ * - **openapi-fetch wrapper**: Uses {@link OpenApiFetchClient} for type-safe HTTP calls.
+ * - **Method-based interface**: Exposes convenience methods (getUser, createTimeEntry, etc.)
+ *   for backwards compatibility with jira-clockify consumers.
+ * - **Raw API access**: `.api` exposes the raw `OpenApiFetchClient<paths>` for direct access.
+ *
+ * **Common tasks**
+ *
+ * - Use the client: `const clockify = yield* ClockifyApiClient`
+ * - Call a method: `clockify.getProjects(workspaceId)`
+ * - Raw access: `toEffect(clockify.api.client.GET("/v1/user"))`
+ * - Provide the layer: `Effect.provide(ClockifyApiClient.layer)`
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { ClockifyApiConfig } from "./ClockifyApiConfig.js";
+import { makeOpenApiFetchClient, toEffect } from "./OpenApiFetchClient.js";
+// ---------------------------------------------------------------------------
+// Service tag + layer
+// ---------------------------------------------------------------------------
+export class ClockifyApiClient extends Context.Tag("@knpkv/clockify-api-client/ClockifyApiClient")() {
+    static layer = Layer.effect(ClockifyApiClient, Effect.gen(function* () {
+        const config = yield* ClockifyApiConfig;
+        const headers = {
+            "X-Api-Key": Redacted.value(config.apiKey),
+            "Content-Type": "application/json"
+        };
+        const api = makeOpenApiFetchClient(config.baseUrl, headers);
+        const { client } = api;
+        return {
+            api,
+            getUser: () => toEffect(client.GET("/v1/user")),
+            getWorkspaces: () => toEffect(client.GET("/v1/workspaces")),
+            getProjects: (workspaceId) => toEffect(client.GET("/v1/workspaces/{workspaceId}/projects", {
+                params: {
+                    path: { workspaceId },
+                    query: { archived: false, "page-size": 500 }
+                }
+            })),
+            getProjectByName: (workspaceId, name) => Effect.gen(function* () {
+                const projects = yield* toEffect(client.GET("/v1/workspaces/{workspaceId}/projects", {
+                    params: {
+                        path: { workspaceId },
+                        query: { name, archived: false }
+                    }
+                }));
+                return projects.find((p) => p.name.toLowerCase() === name.toLowerCase()) ?? null;
+            }),
+            createTimeEntry: (workspaceId, params) => toEffect(client.POST("/v1/workspaces/{workspaceId}/time-entries", {
+                params: { path: { workspaceId } },
+                body: {
+                    description: params.description,
+                    start: params.start,
+                    ...(params.end ? { end: params.end } : {}),
+                    ...(params.projectId ? { projectId: params.projectId } : {}),
+                    ...(params.taskId ? { taskId: params.taskId } : {}),
+                    ...(params.billable !== undefined ? { billable: params.billable } : {}),
+                    ...(params.tagIds !== undefined ? { tagIds: [...params.tagIds] } : {})
+                }
+            })),
+            stopTimer: (workspaceId, userId, params) => toEffect(client.PATCH("/v1/workspaces/{workspaceId}/user/{userId}/time-entries", {
+                params: { path: { workspaceId, userId } },
+                body: { end: params.end }
+            })),
+            getTimeEntries: (workspaceId, userId, params) => toEffect(client.GET("/v1/workspaces/{workspaceId}/user/{userId}/time-entries", {
+                params: {
+                    path: { workspaceId, userId },
+                    query: {
+                        ...(params?.start !== undefined ? { start: params.start } : {}),
+                        ...(params?.end !== undefined ? { end: params.end } : {}),
+                        ...(params?.page !== undefined ? { page: params.page } : {}),
+                        ...(params?.pageSize !== undefined ? { "page-size": params.pageSize } : {})
+                    }
+                }
+            })),
+            getRunningTimer: (workspaceId, userId) => Effect.gen(function* () {
+                const entries = yield* toEffect(client.GET("/v1/workspaces/{workspaceId}/user/{userId}/time-entries", {
+                    params: {
+                        path: { workspaceId, userId },
+                        query: { "in-progress": true, "page-size": 1 }
+                    }
+                }));
+                return entries.length > 0 ? entries[0] : null;
+            }),
+            getTimeEntry: (workspaceId, timeEntryId) => toEffect(client.GET("/v1/workspaces/{workspaceId}/time-entries/{id}", {
+                params: { path: { workspaceId, id: timeEntryId } }
+            })),
+            updateTimeEntry: (workspaceId, timeEntryId, params) => toEffect(client.PUT("/v1/workspaces/{workspaceId}/time-entries/{id}", {
+                params: { path: { workspaceId, id: timeEntryId } },
+                body: {
+                    start: params.start,
+                    ...(params.end !== undefined ? { end: params.end } : {}),
+                    ...(params.description !== undefined ? { description: params.description } : {}),
+                    ...(params.projectId !== undefined ? { projectId: params.projectId } : {}),
+                    ...(params.billable !== undefined ? { billable: params.billable } : {}),
+                    ...(params.tagIds !== undefined ? { tagIds: [...params.tagIds] } : {})
+                }
+            })),
+            getTags: (workspaceId) => toEffect(client.GET("/v1/workspaces/{workspaceId}/tags", {
+                params: {
+                    path: { workspaceId },
+                    query: { archived: false, "page-size": 200 }
+                }
+            })),
+            createTag: (workspaceId, name) => toEffect(client.POST("/v1/workspaces/{workspaceId}/tags", {
+                params: { path: { workspaceId } },
+                body: { name }
+            })),
+            findOrCreateTag: (workspaceId, name) => Effect.gen(function* () {
+                const tags = yield* toEffect(client.GET("/v1/workspaces/{workspaceId}/tags", {
+                    params: {
+                        path: { workspaceId },
+                        query: { name, archived: false }
+                    }
+                }));
+                const existing = tags.find((t) => t.name.toLowerCase() === name.toLowerCase());
+                if (existing)
+                    return existing;
+                return yield* toEffect(client.POST("/v1/workspaces/{workspaceId}/tags", {
+                    params: { path: { workspaceId } },
+                    body: { name }
+                }));
+            }),
+            deleteTimeEntry: (workspaceId, timeEntryId) => toEffect(client.DELETE("/v1/workspaces/{workspaceId}/time-entries/{id}", {
+                params: { path: { workspaceId, id: timeEntryId } }
+            }))
+        };
+    }));
+}
+export const layer = ClockifyApiClient.layer;
+//# sourceMappingURL=ClockifyApiClient.js.map

package/dist/ClockifyApiClient.js.map

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

package/dist/ClockifyApiConfig.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Configuration service tag for the Clockify API client.
+ *
+ * **Mental model**
+ *
+ * - **Context.Tag for DI**: {@link ClockifyApiConfig} carries API key (as `Redacted`),
+ *   workspace ID, user ID, and base URL. Provided via `Layer.succeed` by the consumer.
+ * - **Redacted API key**: The `apiKey` field uses Effect's `Redacted` type to prevent
+ *   accidental logging of credentials.
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+import type * as Redacted from "effect/Redacted";
+export interface ClockifyApiConfigShape {
+    readonly apiKey: Redacted.Redacted<string>;
+    readonly workspaceId: string;
+    readonly userId: string;
+    readonly baseUrl: string;
+}
+declare const ClockifyApiConfig_base: Context.TagClass<ClockifyApiConfig, "@knpkv/clockify-api-client/ClockifyApiConfig", ClockifyApiConfigShape>;
+export declare class ClockifyApiConfig extends ClockifyApiConfig_base {
+}
+export {};
+//# sourceMappingURL=ClockifyApiConfig.d.ts.map

package/dist/ClockifyApiConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClockifyApiConfig.d.ts","sourceRoot":"","sources":["../src/ClockifyApiConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAEhD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;;AAED,qBAAa,iBAAkB,SAAQ,sBAEO;CAAG"}

package/dist/ClockifyApiConfig.js

@@ -0,0 +1,16 @@
+/**
+ * Configuration service tag for the Clockify API client.
+ *
+ * **Mental model**
+ *
+ * - **Context.Tag for DI**: {@link ClockifyApiConfig} carries API key (as `Redacted`),
+ *   workspace ID, user ID, and base URL. Provided via `Layer.succeed` by the consumer.
+ * - **Redacted API key**: The `apiKey` field uses Effect's `Redacted` type to prevent
+ *   accidental logging of credentials.
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+export class ClockifyApiConfig extends Context.Tag("@knpkv/clockify-api-client/ClockifyApiConfig")() {
+}
+//# sourceMappingURL=ClockifyApiConfig.js.map

package/dist/ClockifyApiConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClockifyApiConfig.js","sourceRoot":"","sources":["../src/ClockifyApiConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AAUzC,MAAM,OAAO,iBAAkB,SAAQ,OAAO,CAAC,GAAG,CAChD,8CAA8C,CAC/C,EAA6C;CAAG"}

package/dist/ClockifyApiError.d.ts

@@ -0,0 +1,11 @@
+declare const ClockifyApiError_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: "ClockifyApiError";
+} & Readonly<A>;
+export declare class ClockifyApiError extends ClockifyApiError_base<{
+    readonly status: number;
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+export {};
+//# sourceMappingURL=ClockifyApiError.d.ts.map

package/dist/ClockifyApiError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClockifyApiError.d.ts","sourceRoot":"","sources":["../src/ClockifyApiError.ts"],"names":[],"mappings":";;;AAYA,qBAAa,gBAAiB,SAAQ,sBAAqC;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB,CAAC;CAAG"}

package/dist/ClockifyApiError.js

@@ -0,0 +1,14 @@
+/**
+ * Tagged error for Clockify API failures.
+ *
+ * **Mental model**
+ *
+ * - **Catch by tag**: `Effect.catchTag("ClockifyApiError", ...)` handles all API errors.
+ *   The `status` field distinguishes HTTP errors (>0) from network errors (0).
+ *
+ * @module
+ */
+import * as Data from "effect/Data";
+export class ClockifyApiError extends Data.TaggedError("ClockifyApiError") {
+}
+//# sourceMappingURL=ClockifyApiError.js.map

package/dist/ClockifyApiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClockifyApiError.js","sourceRoot":"","sources":["../src/ClockifyApiError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AAEnC,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAIvE;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