@knpkv/atlassian-common 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @knpkv/atlassian-common
 
+## 0.4.0
+
+### Minor Changes
+
+- [#103](https://github.com/knpkv/npm/pull/103) [`477e4c6`](https://github.com/knpkv/npm/commit/477e4c60fa5c501883be6c03629da5a3cc91444c) Thanks [@konopkov](https://github.com/konopkov)! - Add shared Atlassian auth profile storage for multi-account and multi-site OAuth use.
+
+  Jira and Confluence now expose `auth profiles`, `auth use <profile>`, and `auth remove <profile>` commands backed by shared profile management in `@knpkv/atlassian-common`. Confluence also migrates existing legacy auth/config files on first use. Agent skills and docs now describe the profile commands and active-profile checks.
+
+- [#105](https://github.com/knpkv/npm/pull/105) [`a3a4d3a`](https://github.com/knpkv/npm/commit/a3a4d3a14fafe235bc901ed5015bb9bd82c59281) Thanks [@konopkov](https://github.com/konopkov)! - Add a unified Atlassian profile manager CLI with cross-tool profile listing, selection, diagnostics, token refresh, and scope validation helpers.
+
+  Update bundled Jira, Confluence, and Jira Clockify agent skills to recommend the unified profile diagnostics workflow.
+
+## 0.3.0
+
+### Minor Changes
+
+- [#71](https://github.com/knpkv/npm/pull/71) [`e3c3805`](https://github.com/knpkv/npm/commit/e3c3805ee527a6edb69ed91977c95c586b563ff9) Thanks [@konopkov](https://github.com/konopkov)! - Migrate the package workspace to Effect v4 beta.
+
+  This updates runtime and peer dependencies to the Effect v4 beta module layout,
+  adopts Effect platform/runtime services for Node process, HTTP, filesystem, and
+  clock access, and refreshes package export metadata to point published type
+  entries at emitted `dist/*.d.ts` declarations.
+
+  CodeCommit packages now use Effect v4-compatible AWS and cache layers, including
+  typed `distilled-aws` context services, shared cached-comment decoding, and
+  schema-derived config defaults. Jira and Confluence OAuth callback servers bind
+  the expected local callback port range again under the Effect v4 Node HTTP
+  server layer.
+
+  The retired Claude AI packages have been removed from the workspace.
+
 ## 0.2.0
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,6 @@
 # @knpkv/atlassian-common
 
-Shared utilities for Atlassian tools: OAuth2 + PKCE auth, token storage, config paths, AST types, and markdown serialization.
+Shared utilities for Atlassian tools: OAuth2 + PKCE auth, shared auth profiles, token storage, config paths, AST types, and markdown serialization.
 
 ## Installation
 
@@ -15,7 +15,7 @@ pnpm add @knpkv/atlassian-common
 | `@knpkv/atlassian-common`             | Everything (AST, auth, config, serializers)  |
 | `@knpkv/atlassian-common/ast`         | Inline, block, macro, and document AST nodes |
 | `@knpkv/atlassian-common/auth`        | OAuth2 endpoints, PKCE, token exchange       |
-| `@knpkv/atlassian-common/config`      | Config paths, schemas, token storage         |
+| `@knpkv/atlassian-common/config`      | Config paths, schemas, token/profile storage |
 | `@knpkv/atlassian-common/serializers` | Markdown serializer for AST nodes            |
 
 ## OAuth2 + PKCE
@@ -59,15 +59,17 @@ const program = Effect.gen(function* () {
 })
 ```
 
-## Token Storage
+## Token And Profile Storage
 
-Stores OAuth config and tokens in `~/.config/atlassian/` with 0600 permissions.
+Stores OAuth config, auth profiles, and the active token mirror in `~/.config/atlassian/<tool>/` with 0600 permissions.
 
 ```typescript
 import { Effect } from "effect"
 import {
-  saveToken,
-  loadToken,
+  saveProfileToken,
+  loadActiveProfileToken,
+  loadProfiles,
+  setActiveProfileBySelector,
   isTokenExpired,
   saveOAuthConfig,
   loadOAuthConfig,
@@ -75,15 +77,28 @@ import {
 } from "@knpkv/atlassian-common/config"
 
 const program = Effect.gen(function* () {
-  yield* saveOAuthConfig({ clientId: "...", clientSecret: "..." }, "jira")
+  yield* saveOAuthConfig("jira", { clientId: "...", clientSecret: "..." })
   const config = yield* loadOAuthConfig("jira")
 
-  yield* saveToken({ access_token: "...", refresh_token: "...", expires_in: 3600 }, "jira")
-  const token = yield* loadToken("jira")
-  const expired = isTokenExpired(token)
+  yield* saveProfileToken("jira", {
+    access_token: "...",
+    refresh_token: "...",
+    expires_at: Date.now() + 3600_000,
+    scope: "read:jira-work offline_access",
+    cloud_id: "...",
+    site_url: "https://example.atlassian.net"
+  })
+
+  const profiles = yield* loadProfiles("jira")
+  yield* setActiveProfileBySelector("jira", "https://example.atlassian.net")
+
+  const token = yield* loadActiveProfileToken("jira")
+  const expired = token ? isTokenExpired(token) : true
 }).pipe(Effect.provide(HomeDirectoryLive))
 ```
 
+`profiles.json` is the multi-account/site source of truth. `auth.json` is still mirrored to the active profile so older single-profile consumers keep working.
+
 ## AST Types
 
 Typed Atlassian Document Format nodes — used by `@knpkv/jira-cli` and `@knpkv/confluence-to-markdown`.

package/dist/Brand.d.ts

@@ -4,7 +4,7 @@
  * **Mental model**
  *
  * - **Brand = runtime validation + compile-time narrowing**: Each brand combines
- *   an Effect `Brand.refined` (throws on invalid values) with an Effect `Schema`
+ *   an Effect `Brand.make` (throws on invalid values) with an Effect `Schema`
  *   (composable validation). The `Type` property exposes the branded type for use
  *   in type annotations.
  * - **Pattern-guarded strings**: `SpaceKey`, `IssueKey`, `ProjectKey` are regex-branded;
@@ -41,8 +41,8 @@ import * as Schema from "effect/Schema";
  *
  * @category Brand
  */
-export declare const makeBrandedString: <B extends string>(name: B, pattern: RegExp) => Brand.Brand.Constructor<string & Brand.Brand<B>> & {
-    schema: Schema.brand<Schema.filter<typeof Schema.String>, B>;
+export declare const makeBrandedString: <B extends string>(name: B, pattern: RegExp) => Brand.Constructor<string & Brand.Brand<B>> & {
+    schema: Schema.brand<Schema.String, B>;
     Type: string & Brand.Brand<B>;
 };
 /**
@@ -61,8 +61,8 @@ export declare const makeBrandedString: <B extends string>(name: B, pattern: Reg
  *
  * @category Brand
  */
-export declare const makeBrandedNonEmptyString: <B extends string>(name: B) => Brand.Brand.Constructor<string & Brand.Brand<B>> & {
-    schema: Schema.brand<Schema.filter<typeof Schema.String>, B>;
+export declare const makeBrandedNonEmptyString: <B extends string>(name: B) => Brand.Constructor<string & Brand.Brand<B>> & {
+    schema: Schema.brand<Schema.NonEmptyString, B>;
     Type: string & Brand.Brand<B>;
 };
 /**
@@ -70,8 +70,8 @@ export declare const makeBrandedNonEmptyString: <B extends string>(name: B) => B
  *
  * @category Brand
  */
-export declare const PageId: Brand.Brand.Constructor<string & Brand.Brand<"PageId">> & {
-    schema: Schema.brand<Schema.filter<typeof Schema.String>, "PageId">;
+export declare const PageId: Brand.Constructor<string & Brand.Brand<"PageId">> & {
+    schema: Schema.brand<Schema.NonEmptyString, "PageId">;
     Type: string & Brand.Brand<"PageId">;
 };
 export type PageId = typeof PageId.Type;
@@ -80,8 +80,8 @@ export type PageId = typeof PageId.Type;
  *
  * @category Brand
  */
-export declare const SpaceKey: Brand.Brand.Constructor<string & Brand.Brand<"SpaceKey">> & {
-    schema: Schema.brand<Schema.filter<typeof Schema.String>, "SpaceKey">;
+export declare const SpaceKey: Brand.Constructor<string & Brand.Brand<"SpaceKey">> & {
+    schema: Schema.brand<Schema.String, "SpaceKey">;
     Type: string & Brand.Brand<"SpaceKey">;
 };
 export type SpaceKey = typeof SpaceKey.Type;
@@ -90,8 +90,8 @@ export type SpaceKey = typeof SpaceKey.Type;
  *
  * @category Brand
  */
-export declare const IssueKey: Brand.Brand.Constructor<string & Brand.Brand<"IssueKey">> & {
-    schema: Schema.brand<Schema.filter<typeof Schema.String>, "IssueKey">;
+export declare const IssueKey: Brand.Constructor<string & Brand.Brand<"IssueKey">> & {
+    schema: Schema.brand<Schema.String, "IssueKey">;
     Type: string & Brand.Brand<"IssueKey">;
 };
 export type IssueKey = typeof IssueKey.Type;
@@ -100,8 +100,8 @@ export type IssueKey = typeof IssueKey.Type;
  *
  * @category Brand
  */
-export declare const ProjectKey: Brand.Brand.Constructor<string & Brand.Brand<"ProjectKey">> & {
-    schema: Schema.brand<Schema.filter<typeof Schema.String>, "ProjectKey">;
+export declare const ProjectKey: Brand.Constructor<string & Brand.Brand<"ProjectKey">> & {
+    schema: Schema.brand<Schema.String, "ProjectKey">;
     Type: string & Brand.Brand<"ProjectKey">;
 };
 export type ProjectKey = typeof ProjectKey.Type;
@@ -110,8 +110,8 @@ export type ProjectKey = typeof ProjectKey.Type;
  *
  * @category Brand
  */
-export declare const ContentHash: Brand.Brand.Constructor<string & Brand.Brand<"ContentHash">> & {
-    schema: Schema.brand<Schema.filter<typeof Schema.String>, "ContentHash">;
+export declare const ContentHash: Brand.Constructor<string & Brand.Brand<"ContentHash">> & {
+    schema: Schema.brand<Schema.String, "ContentHash">;
     Type: string & Brand.Brand<"ContentHash">;
 };
 export type ContentHash = typeof ContentHash.Type;

package/dist/Brand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../src/Brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,EAChD,MAAM,CAAC,EACP,SAAS,MAAM;;;CAkBhB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,MAAM,EAAE,MAAM,CAAC;;;CAiBlE,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,MAAM;;;CAAsC,CAAA;AACzD,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;CAAoD,CAAA;AACzE,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;CAAwD,CAAA;AAC7E,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;CAAsD,CAAA;AAC7E,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;CAAqD,CAAA;AAC7E,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA"}
+{"version":3,"file":"Brand.d.ts","sourceRoot":"","sources":["../src/Brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,EAChD,MAAM,CAAC,EACP,SAAS,MAAM;;;CAYhB,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,MAAM,EAAE,MAAM,CAAC;;;CAWlE,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,MAAM;;;CAAsC,CAAA;AACzD,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;CAAoD,CAAA;AACzE,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;CAAwD,CAAA;AAC7E,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,UAAU;;;CAAsD,CAAA;AAC7E,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;CAAqD,CAAA;AAC7E,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA"}

package/dist/Brand.js

@@ -4,7 +4,7 @@
  * **Mental model**
  *
  * - **Brand = runtime validation + compile-time narrowing**: Each brand combines
- *   an Effect `Brand.refined` (throws on invalid values) with an Effect `Schema`
+ *   an Effect `Brand.make` (throws on invalid values) with an Effect `Schema`
  *   (composable validation). The `Type` property exposes the branded type for use
  *   in type annotations.
  * - **Pattern-guarded strings**: `SpaceKey`, `IssueKey`, `ProjectKey` are regex-branded;
@@ -42,8 +42,8 @@ import * as Schema from "effect/Schema";
  * @category Brand
  */
 export const makeBrandedString = (name, pattern) => {
-    const brand = Brand.refined((s) => pattern.test(s), (s) => Brand.error(`Invalid ${name}: ${s} does not match ${pattern}`));
-    const schema = Schema.String.pipe(Schema.pattern(pattern), Schema.brand(name));
+    const brand = Brand.make((s) => pattern.test(s) || `Invalid ${name}: ${s} does not match ${pattern}`);
+    const schema = Schema.String.check(Schema.isPattern(pattern)).pipe(Schema.brand(name));
     return Object.assign(brand, {
         schema,
         Type: undefined
@@ -66,8 +66,8 @@ export const makeBrandedString = (name, pattern) => {
  * @category Brand
  */
 export const makeBrandedNonEmptyString = (name) => {
-    const brand = Brand.refined((s) => s.length > 0, (_s) => Brand.error(`${name} cannot be empty`));
-    const schema = Schema.String.pipe(Schema.nonEmptyString(), Schema.brand(name));
+    const brand = Brand.make((s) => s.length > 0 || `${name} cannot be empty`);
+    const schema = Schema.NonEmptyString.pipe(Schema.brand(name));
     return Object.assign(brand, {
         schema,
         Type: undefined

package/dist/Brand.js.map

@@ -1 +1 @@
-{"version":3,"file":"Brand.js","sourceRoot":"","sources":["../src/Brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAO,EACP,OAAe,EACf,EAAE;IAGF,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EACtB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CACtE,CAAA;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC/B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EACvB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CACnB,CAAA;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;QAC1B,MAAM;QACN,IAAI,EAAE,SAAmC;KAC1C,CAAC,CAAA;AACJ,CAAC,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAmB,IAAO,EAAE,EAAE;IAGrE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EACnB,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,kBAAkB,CAAC,CAC/C,CAAA;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC/B,MAAM,CAAC,cAAc,EAAE,EACvB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CACnB,CAAA;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;QAC1B,MAAM;QACN,IAAI,EAAE,SAAmC;KAC1C,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,8CAA8C;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAA;AAGzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAA;AAGzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAA;AAG7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAA;AAG7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAA"}
+{"version":3,"file":"Brand.js","sourceRoot":"","sources":["../src/Brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAO,EACP,OAAe,EACf,EAAE;IAGF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAc,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,WAAW,IAAI,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAA;IAElH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAEtF,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;QAC1B,MAAM;QACN,IAAI,EAAE,SAAmC;KAC1C,CAAC,CAAA;AACJ,CAAC,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAmB,IAAO,EAAE,EAAE;IAGrE,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAc,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,IAAI,kBAAkB,CAAC,CAAA;IAEvF,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAE7D,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;QAC1B,MAAM;QACN,IAAI,EAAE,SAAmC;KAC1C,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,8CAA8C;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAA;AAGzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAA;AAGzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAA;AAG7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,iBAAiB,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAA;AAG7E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAA"}

package/dist/Hash.d.ts

@@ -1,11 +1,11 @@
 /**
- * SHA256 content hashing via Node.js crypto, returning branded {@link ContentHash} values.
+ * SHA256 content hashing via Effect's platform `Crypto` service, returning branded {@link ContentHash} values.
  *
  * **Mental model**
  *
- * - **Effect-wrapped crypto**: {@link hashContent} and {@link hashBuffer} return
- *   `Effect<ContentHash>` so hashing composes into pipelines without try/catch.
- * - **Sync escape hatch**: {@link hashContentSync} for contexts where Effect isn't needed.
+ * - **Service-backed crypto**: {@link hashContent} and {@link hashBuffer} use
+ *   the `Crypto` service from Effect context, so applications provide the
+ *   platform implementation at the runtime edge.
  *
  * **Common tasks**
  *
@@ -15,39 +15,37 @@
  *
  * @module
  */
+import * as Crypto from "effect/Crypto";
 import * as Effect from "effect/Effect";
+import type * as PlatformError from "effect/PlatformError";
 import { ContentHash } from "./Brand.js";
 /**
  * Compute SHA256 hash of a string.
  *
  * @example
  * ```typescript
- * import { hashContent } from "@knpkv/atlassian-common"
+ * import * as Crypto from "effect/Crypto"
  * import * as Effect from "effect/Effect"
+ * import { hashContent } from "@knpkv/atlassian-common"
  *
- * const hash = Effect.runSync(hashContent("hello world"))
+ * declare const crypto: Crypto.Crypto
+ * const hash = Effect.runSync(hashContent("hello world").pipe(Effect.provideService(Crypto.Crypto, crypto)))
  * // => "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
  * ```
  *
  * @category Hash
  */
-export declare const hashContent: (content: string) => Effect.Effect<ContentHash>;
+export declare const hashContent: (content: string) => Effect.Effect<ContentHash, PlatformError.PlatformError, Crypto.Crypto>;
 /**
  * Compute SHA256 hash of a buffer.
  *
  * @category Hash
  */
-export declare const hashBuffer: (buffer: Buffer | Uint8Array) => Effect.Effect<ContentHash>;
+export declare const hashBuffer: (buffer: Uint8Array) => Effect.Effect<ContentHash, PlatformError.PlatformError, Crypto.Crypto>;
 /**
  * Check if two hashes are equal.
  *
  * @category Hash
  */
 export declare const hashEquals: (a: ContentHash, b: ContentHash) => boolean;
-/**
- * Synchronous version of hashContent for simple use cases.
- *
- * @category Hash
- */
-export declare const hashContentSync: (content: string) => ContentHash;
 //# sourceMappingURL=Hash.d.ts.map

package/dist/Hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Hash.d.ts","sourceRoot":"","sources":["../src/Hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAInE,CAAA;AAEJ;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,GAAG,UAAU,KAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAI9E,CAAA;AAEJ;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,WAAW,EAAE,GAAG,WAAW,KAAG,OAAkB,CAAA;AAE9E;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,WAGjD,CAAA"}
+{"version":3,"file":"Hash.d.ts","sourceRoot":"","sources":["../src/Hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,KAAK,aAAa,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAaxC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CACxE,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,QAAQ,UAAU,KACjB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAyB,CAAA;AAEjG;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,WAAW,EAAE,GAAG,WAAW,KAAG,OAAkB,CAAA"}

package/dist/Hash.js

@@ -1,11 +1,11 @@
 /**
- * SHA256 content hashing via Node.js crypto, returning branded {@link ContentHash} values.
+ * SHA256 content hashing via Effect's platform `Crypto` service, returning branded {@link ContentHash} values.
  *
  * **Mental model**
  *
- * - **Effect-wrapped crypto**: {@link hashContent} and {@link hashBuffer} return
- *   `Effect<ContentHash>` so hashing composes into pipelines without try/catch.
- * - **Sync escape hatch**: {@link hashContentSync} for contexts where Effect isn't needed.
+ * - **Service-backed crypto**: {@link hashContent} and {@link hashBuffer} use
+ *   the `Crypto` service from Effect context, so applications provide the
+ *   platform implementation at the runtime edge.
  *
  * **Common tasks**
  *
@@ -15,49 +15,43 @@
  *
  * @module
  */
+import * as Crypto from "effect/Crypto";
 import * as Effect from "effect/Effect";
-import * as crypto from "node:crypto";
+import * as Encoding from "effect/Encoding";
 import { ContentHash } from "./Brand.js";
+const textEncoder = new TextEncoder();
+const digestSha256 = (bytes) => Effect.gen(function* () {
+    const crypto = yield* Crypto.Crypto;
+    const digest = yield* crypto.digest("SHA-256", bytes);
+    return ContentHash(Encoding.encodeHex(digest));
+});
 /**
  * Compute SHA256 hash of a string.
  *
  * @example
  * ```typescript
- * import { hashContent } from "@knpkv/atlassian-common"
+ * import * as Crypto from "effect/Crypto"
  * import * as Effect from "effect/Effect"
+ * import { hashContent } from "@knpkv/atlassian-common"
  *
- * const hash = Effect.runSync(hashContent("hello world"))
+ * declare const crypto: Crypto.Crypto
+ * const hash = Effect.runSync(hashContent("hello world").pipe(Effect.provideService(Crypto.Crypto, crypto)))
  * // => "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
  * ```
  *
  * @category Hash
  */
-export const hashContent = (content) => Effect.sync(() => {
-    const hash = crypto.createHash("sha256").update(content, "utf8").digest("hex");
-    return ContentHash(hash);
-});
+export const hashContent = (content) => digestSha256(textEncoder.encode(content));
 /**
  * Compute SHA256 hash of a buffer.
  *
  * @category Hash
  */
-export const hashBuffer = (buffer) => Effect.sync(() => {
-    const hash = crypto.createHash("sha256").update(buffer).digest("hex");
-    return ContentHash(hash);
-});
+export const hashBuffer = (buffer) => digestSha256(buffer);
 /**
  * Check if two hashes are equal.
  *
  * @category Hash
  */
 export const hashEquals = (a, b) => a === b;
-/**
- * Synchronous version of hashContent for simple use cases.
- *
- * @category Hash
- */
-export const hashContentSync = (content) => {
-    const hash = crypto.createHash("sha256").update(content, "utf8").digest("hex");
-    return ContentHash(hash);
-};
 //# sourceMappingURL=Hash.js.map

package/dist/Hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"Hash.js","sourceRoot":"","sources":["../src/Hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAA8B,EAAE,CACzE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACf,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9E,OAAO,WAAW,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC,CAAC,CAAA;AAEJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAA2B,EAA8B,EAAE,CACpF,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACf,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACrE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC,CAAC,CAAA;AAEJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAc,EAAE,CAAc,EAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAA;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAe,EAAE;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9E,OAAO,WAAW,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC,CAAA"}
+{"version":3,"file":"Hash.js","sourceRoot":"","sources":["../src/Hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAA;AAErC,MAAM,YAAY,GAAG,CACnB,KAAiB,EACuD,EAAE,CAC1E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAA;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IACrD,OAAO,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;AAChD,CAAC,CAAC,CAAA;AAEJ;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAA0E,EAAE,CACrH,YAAY,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;AAE3C;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,MAAkB,EACsD,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;AAEjG;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAc,EAAE,CAAc,EAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAA"}