@passlock/cli 2.0.6 → 2.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -32,7 +32,7 @@ in README.template.md and outputs to README.md
32
32
 
33
33
  ## Requirements
34
34
 
35
- Node 22+
35
+ Node 20+
36
36
 
37
37
  ## Usage
38
38
 
@@ -32,7 +32,7 @@ in README.template.md and outputs to README.md
32
32
 
33
33
  ## Requirements
34
34
 
35
- Node 22+
35
+ Node 20+
36
36
 
37
37
  ## Usage
38
38
 
package/dist/cli.js CHANGED
@@ -7,7 +7,7 @@
7
7
  import { Console, Data, Effect, pipe } from "effect";
8
8
  import { init } from "./init.js";
9
9
  import { NetworkFetchLive } from "./network.js";
10
- const VERSION = "2.0.6";
10
+ const VERSION = "2.0.7";
11
11
  const DEFAULT_ENDPOINT = "https://api.passlock.dev";
12
12
  const MAIN_HELP_TEXT = [
13
13
  "Passlock CLI tools",
package/dist/network.d.ts CHANGED
@@ -28,7 +28,7 @@ export type NetworkHeaders = Headers | Readonly<Record<string, string>> | Array<
28
28
  export interface FetchNetworkOptions {
29
29
  readonly headers?: NetworkHeaders;
30
30
  }
31
- declare const NetworkFetch_base: Context.TagClass<NetworkFetch, "@passlock/node/network/Fetch", typeof fetch>;
31
+ declare const NetworkFetch_base: Context.TagClass<NetworkFetch, "NetworkFetch", typeof fetch>;
32
32
  /**
33
33
  * Effect service tag for the fetch implementation.
34
34
  *
package/dist/network.js CHANGED
@@ -5,7 +5,7 @@ import { Context, Data, Effect, Layer } from "effect";
5
5
  * Supply this service with `Effect.provide` / layers to swap fetch behavior
6
6
  * in tests or alternate runtimes.
7
7
  */
8
- export class NetworkFetch extends Context.Tag("@passlock/node/network/Fetch")() {
8
+ export class NetworkFetch extends Context.Tag("NetworkFetch")() {
9
9
  }
10
10
  /**
11
11
  * Default live fetch layer backed by `globalThis.fetch`.
@@ -1 +1 @@
1
- {"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"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","sourcesContent":["import { Context, Data, Effect, Layer } from \"effect\"\n\n/**\n * Supported HTTP methods accepted by {@link fetchNetwork}.\n */\nexport type NetworkMethod = \"get\" | \"post\" | \"delete\" | \"patch\"\n\n/**\n * Lightweight response model used by this package.\n *\n * Invariants:\n * - `json` is lazy: parsing only happens when the effect is run.\n * - `json` is memoized per response wrapper, so repeated evaluation does not\n * parse the same payload multiple times.\n */\nexport interface NetworkResponse {\n readonly status: number\n readonly statusText: string\n readonly statusMessage: string\n readonly headers: Readonly<Record<string, string>>\n readonly json: Effect.Effect<unknown, NetworkResponseError>\n}\n\n/**\n * Accepted request header input formats.\n */\nexport type NetworkHeaders =\n | Headers\n | Readonly<Record<string, string>>\n | Array<[string, string]>\n\n/**\n * Optional request options for {@link fetchNetwork}.\n */\nexport interface FetchNetworkOptions {\n readonly headers?: NetworkHeaders\n}\n\n/**\n * Effect service tag for the fetch implementation.\n *\n * Supply this service with `Effect.provide` / layers to swap fetch behavior\n * in tests or alternate runtimes.\n */\nexport class NetworkFetch extends Context.Tag(\"@passlock/node/network/Fetch\")<\n NetworkFetch,\n typeof fetch\n>() {}\n\n/**\n * Default live fetch layer backed by `globalThis.fetch`.\n */\nexport const NetworkFetchLive: Layer.Layer<NetworkFetch> = Layer.succeed(\n NetworkFetch,\n globalThis.fetch\n)\n\n/**\n * HTTP status buckets used by {@link matchStatus}.\n */\nexport type NetworkResponseStatusCase = \"2xx\" | \"3xx\" | \"4xx\" | \"5xx\"\n\ntype MatchStatusHandler<\n Resp extends NetworkResponse = NetworkResponse,\n A = unknown,\n E = unknown,\n> = (response: Resp) => Effect.Effect<A, E, never>\n\ntype HandlerEffect<\n Cases extends MatchStatusCases<Resp>,\n Resp extends NetworkResponse,\n Case extends NetworkResponseStatusCase | \"orElse\",\n> = Case extends keyof Cases\n ? NonNullable<Cases[Case]> extends MatchStatusHandler<Resp>\n ? ReturnType<NonNullable<Cases[Case]>>\n : never\n : never\n\ntype MatchStatusEffectUnion<\n Cases extends MatchStatusCases<Resp>,\n Resp extends NetworkResponse,\n> =\n | HandlerEffect<Cases, Resp, \"2xx\">\n | HandlerEffect<Cases, Resp, \"3xx\">\n | HandlerEffect<Cases, Resp, \"4xx\">\n | HandlerEffect<Cases, Resp, \"5xx\">\n | HandlerEffect<Cases, Resp, \"orElse\">\n\ntype MatchStatusResolvedHandler<\n Cases extends MatchStatusCases<Resp>,\n Resp extends NetworkResponse,\n> = NonNullable<\n Cases[\"2xx\"] | Cases[\"3xx\"] | Cases[\"4xx\"] | Cases[\"5xx\"] | Cases[\"orElse\"]\n>\n\ntype EffectSuccess<T> =\n T extends Effect.Effect<infer A, unknown, unknown> ? A : never\n\ntype EffectError<T> =\n T extends Effect.Effect<unknown, infer E, unknown> ? E : never\n\ntype EffectContext<T> =\n T extends Effect.Effect<unknown, unknown, infer R> ? R : never\n\n/**\n * Handlers used by {@link matchStatus}.\n *\n * Invariants:\n * - `orElse` is always required.\n * - Specific status family handlers are optional and fall back to `orElse`\n * when missing.\n */\nexport interface MatchStatusCases<\n Resp extends NetworkResponse = NetworkResponse,\n> {\n readonly \"2xx\"?: MatchStatusHandler<Resp>\n readonly \"3xx\"?: MatchStatusHandler<Resp>\n readonly \"4xx\"?: MatchStatusHandler<Resp>\n readonly \"5xx\"?: MatchStatusHandler<Resp>\n readonly orElse: MatchStatusHandler<Resp>\n}\n\ntype RequestContext = {\n readonly method: NetworkMethod\n readonly url: string\n}\n\n/**\n * Raised when the underlying fetch call fails before a response is received.\n */\nexport class NetworkRequestError extends Data.TaggedError(\n \"@error/NetworkRequest\"\n)<{\n readonly method: NetworkMethod\n readonly url: string\n readonly message: string\n}> {}\n\n/**\n * Raised when request payload serialization fails.\n */\nexport class NetworkPayloadError extends Data.TaggedError(\n \"@error/NetworkPayload\"\n)<{\n readonly method: NetworkMethod\n readonly message: string\n}> {}\n\n/**\n * Raised when response body parsing fails.\n */\nexport class NetworkResponseError extends Data.TaggedError(\n \"@error/NetworkResponse\"\n)<{\n readonly method: NetworkMethod\n readonly url: string\n readonly message: string\n}> {}\n\nconst formatMessage = (cause: unknown, fallback: string): string =>\n cause instanceof Error ? cause.message : fallback\n\n/**\n * Convert an HTTP status code into its status family bucket.\n *\n * Returns `undefined` for codes outside the 2xx-5xx families.\n */\nexport const statusToCase = (\n status: number\n): NetworkResponseStatusCase | undefined => {\n if (status >= 200 && status <= 299) return \"2xx\"\n if (status >= 300 && status <= 399) return \"3xx\"\n if (status >= 400 && status <= 499) return \"4xx\"\n if (status >= 500 && status <= 599) return \"5xx\"\n\n return undefined\n}\n\nconst resolveStatusHandler = <\n Resp extends NetworkResponse,\n Cases extends MatchStatusCases<Resp>,\n>(\n response: Resp,\n cases: Cases\n): MatchStatusResolvedHandler<Cases, Resp> => {\n const statusCase = statusToCase(response.status)\n if (!statusCase)\n return cases.orElse as MatchStatusResolvedHandler<Cases, Resp>\n\n const handler = cases[statusCase]\n return (handler ?? cases.orElse) as MatchStatusResolvedHandler<Cases, Resp>\n}\n\n/**\n * Route a {@link NetworkResponse} to the first matching status-family handler.\n *\n * Invariants:\n * - `2xx`/`3xx`/`4xx`/`5xx` handlers are matched by status family.\n * - `orElse` is always used as a fallback when no specific family handler exists.\n * - The returned effect type is inferred as the union of all handler effects.\n */\nexport const matchStatus = <\n Resp extends NetworkResponse,\n Cases extends MatchStatusCases<Resp>,\n>(\n response: Resp,\n cases: Cases\n): Effect.Effect<\n EffectSuccess<MatchStatusEffectUnion<Cases, Resp>>,\n EffectError<MatchStatusEffectUnion<Cases, Resp>>,\n EffectContext<MatchStatusEffectUnion<Cases, Resp>>\n> =>\n Effect.suspend(() => {\n const handler = resolveStatusHandler(response, cases)\n return handler(response)\n }) as Effect.Effect<\n EffectSuccess<MatchStatusEffectUnion<Cases, Resp>>,\n EffectError<MatchStatusEffectUnion<Cases, Resp>>,\n EffectContext<MatchStatusEffectUnion<Cases, Resp>>\n >\n\n/**\n * Serialize an optional payload into a JSON request body.\n *\n * Invariants:\n * - `GET` requests cannot carry a payload and fail with `NetworkPayloadError`.\n * - when a payload exists, `content-type: application/json` is emitted.\n */\nconst serializePayload = (\n method: NetworkMethod,\n payload?: unknown\n): Effect.Effect<\n | {\n readonly body: string\n readonly headers: Readonly<Record<string, string>>\n }\n | undefined,\n NetworkPayloadError\n> => {\n if (payload === undefined) {\n return Effect.succeed(undefined)\n }\n\n if (method === \"get\") {\n return Effect.fail(\n new NetworkPayloadError({\n method,\n message: \"GET requests do not support a request body\",\n })\n )\n }\n\n return Effect.try({\n try: () => ({\n body: JSON.stringify(payload),\n headers: { \"content-type\": \"application/json\" },\n }),\n catch: (cause) =>\n new NetworkPayloadError({\n method,\n message: formatMessage(cause, \"Unable to serialize payload to JSON\"),\n }),\n })\n}\n\n/**\n * Convert `Headers` into a readonly plain record.\n */\nexport const headersToRecord = (\n headers: Headers\n): Readonly<Record<string, string>> => Object.fromEntries(headers.entries())\n\nconst normalizeHeaders = (headers: NetworkHeaders): Headers => {\n if (headers instanceof Headers) {\n return new Headers(headers)\n }\n\n if (Array.isArray(headers)) {\n return new Headers(headers)\n }\n\n return new Headers(headers)\n}\n\nconst mergeHeaders = (\n ...headers: ReadonlyArray<Readonly<Record<string, string>>>\n): Readonly<Record<string, string>> => Object.assign({}, ...headers)\n\n/**\n * Build a lazy, memoized JSON parser effect from a response.\n *\n * Invariants:\n * - parsing happens on effect execution, not during response construction.\n * - parsing uses `response.clone()` so the original response body remains untouched.\n */\nconst makeJsonEffect = (\n response: Response,\n context: RequestContext\n): Effect.Effect<unknown, NetworkResponseError> => {\n let cached: Promise<unknown> | undefined\n\n return Effect.tryPromise({\n try: () => {\n cached = cached ?? response.clone().json()\n return cached\n },\n catch: (cause) =>\n new NetworkResponseError({\n method: context.method,\n url: context.url,\n message: formatMessage(cause, \"Unable to parse response JSON\"),\n }),\n })\n}\n\nconst toNetworkResponse = (\n response: Response,\n context: RequestContext\n): NetworkResponse => ({\n status: response.status,\n statusText: response.statusText,\n statusMessage: response.statusText,\n headers: headersToRecord(response.headers),\n json: makeJsonEffect(response, context),\n})\n\n/**\n * Execute a fetch request using the injected {@link NetworkFetch} service.\n *\n * Invariants:\n * - method is always normalized to upper-case before dispatch.\n * - JSON payload (if present) is serialized before request execution.\n * - caller headers override payload-derived headers when keys overlap.\n * - the returned `NetworkResponse.json` remains lazy.\n */\nexport const fetchNetwork = (\n url: string | URL,\n method: NetworkMethod,\n payload?: unknown,\n options?: FetchNetworkOptions\n): Effect.Effect<\n NetworkResponse,\n NetworkRequestError | NetworkPayloadError,\n NetworkFetch\n> =>\n Effect.gen(function* () {\n const requestUrl = String(url)\n const context: RequestContext = { method, url: requestUrl }\n const fetchImpl = yield* NetworkFetch\n const serialized = yield* serializePayload(method, payload)\n\n const providedHeaders = options?.headers\n ? headersToRecord(normalizeHeaders(options.headers))\n : {}\n\n const requestHeaders = mergeHeaders(\n serialized?.headers ?? {},\n providedHeaders\n )\n const hasHeaders = Object.keys(requestHeaders).length > 0\n\n const response = yield* Effect.tryPromise({\n try: () =>\n fetchImpl(requestUrl, {\n method: method.toUpperCase(),\n ...(hasHeaders ? { headers: requestHeaders } : {}),\n ...(serialized\n ? {\n body: serialized.body,\n }\n : {}),\n }),\n catch: (cause) =>\n new NetworkRequestError({\n method,\n url: requestUrl,\n message: formatMessage(cause, \"Network request failed\"),\n }),\n })\n\n return toNetworkResponse(response, context)\n })\n"]}
1
+ {"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"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","sourcesContent":["import { Context, Data, Effect, Layer } from \"effect\"\n\n/**\n * Supported HTTP methods accepted by {@link fetchNetwork}.\n */\nexport type NetworkMethod = \"get\" | \"post\" | \"delete\" | \"patch\"\n\n/**\n * Lightweight response model used by this package.\n *\n * Invariants:\n * - `json` is lazy: parsing only happens when the effect is run.\n * - `json` is memoized per response wrapper, so repeated evaluation does not\n * parse the same payload multiple times.\n */\nexport interface NetworkResponse {\n readonly status: number\n readonly statusText: string\n readonly statusMessage: string\n readonly headers: Readonly<Record<string, string>>\n readonly json: Effect.Effect<unknown, NetworkResponseError>\n}\n\n/**\n * Accepted request header input formats.\n */\nexport type NetworkHeaders =\n | Headers\n | Readonly<Record<string, string>>\n | Array<[string, string]>\n\n/**\n * Optional request options for {@link fetchNetwork}.\n */\nexport interface FetchNetworkOptions {\n readonly headers?: NetworkHeaders\n}\n\n/**\n * Effect service tag for the fetch implementation.\n *\n * Supply this service with `Effect.provide` / layers to swap fetch behavior\n * in tests or alternate runtimes.\n */\nexport class NetworkFetch extends Context.Tag(\"NetworkFetch\")<\n NetworkFetch,\n typeof fetch\n>() {}\n\n/**\n * Default live fetch layer backed by `globalThis.fetch`.\n */\nexport const NetworkFetchLive: Layer.Layer<NetworkFetch> = Layer.succeed(\n NetworkFetch,\n globalThis.fetch\n)\n\n/**\n * HTTP status buckets used by {@link matchStatus}.\n */\nexport type NetworkResponseStatusCase = \"2xx\" | \"3xx\" | \"4xx\" | \"5xx\"\n\ntype MatchStatusHandler<\n Resp extends NetworkResponse = NetworkResponse,\n A = unknown,\n E = unknown,\n> = (response: Resp) => Effect.Effect<A, E, never>\n\ntype HandlerEffect<\n Cases extends MatchStatusCases<Resp>,\n Resp extends NetworkResponse,\n Case extends NetworkResponseStatusCase | \"orElse\",\n> = Case extends keyof Cases\n ? NonNullable<Cases[Case]> extends MatchStatusHandler<Resp>\n ? ReturnType<NonNullable<Cases[Case]>>\n : never\n : never\n\ntype MatchStatusEffectUnion<\n Cases extends MatchStatusCases<Resp>,\n Resp extends NetworkResponse,\n> =\n | HandlerEffect<Cases, Resp, \"2xx\">\n | HandlerEffect<Cases, Resp, \"3xx\">\n | HandlerEffect<Cases, Resp, \"4xx\">\n | HandlerEffect<Cases, Resp, \"5xx\">\n | HandlerEffect<Cases, Resp, \"orElse\">\n\ntype MatchStatusResolvedHandler<\n Cases extends MatchStatusCases<Resp>,\n Resp extends NetworkResponse,\n> = NonNullable<\n Cases[\"2xx\"] | Cases[\"3xx\"] | Cases[\"4xx\"] | Cases[\"5xx\"] | Cases[\"orElse\"]\n>\n\ntype EffectSuccess<T> =\n T extends Effect.Effect<infer A, unknown, unknown> ? A : never\n\ntype EffectError<T> =\n T extends Effect.Effect<unknown, infer E, unknown> ? E : never\n\ntype EffectContext<T> =\n T extends Effect.Effect<unknown, unknown, infer R> ? R : never\n\n/**\n * Handlers used by {@link matchStatus}.\n *\n * Invariants:\n * - `orElse` is always required.\n * - Specific status family handlers are optional and fall back to `orElse`\n * when missing.\n */\nexport interface MatchStatusCases<\n Resp extends NetworkResponse = NetworkResponse,\n> {\n readonly \"2xx\"?: MatchStatusHandler<Resp>\n readonly \"3xx\"?: MatchStatusHandler<Resp>\n readonly \"4xx\"?: MatchStatusHandler<Resp>\n readonly \"5xx\"?: MatchStatusHandler<Resp>\n readonly orElse: MatchStatusHandler<Resp>\n}\n\ntype RequestContext = {\n readonly method: NetworkMethod\n readonly url: string\n}\n\n/**\n * Raised when the underlying fetch call fails before a response is received.\n */\nexport class NetworkRequestError extends Data.TaggedError(\n \"@error/NetworkRequest\"\n)<{\n readonly method: NetworkMethod\n readonly url: string\n readonly message: string\n}> {}\n\n/**\n * Raised when request payload serialization fails.\n */\nexport class NetworkPayloadError extends Data.TaggedError(\n \"@error/NetworkPayload\"\n)<{\n readonly method: NetworkMethod\n readonly message: string\n}> {}\n\n/**\n * Raised when response body parsing fails.\n */\nexport class NetworkResponseError extends Data.TaggedError(\n \"@error/NetworkResponse\"\n)<{\n readonly method: NetworkMethod\n readonly url: string\n readonly message: string\n}> {}\n\nconst formatMessage = (cause: unknown, fallback: string): string =>\n cause instanceof Error ? cause.message : fallback\n\n/**\n * Convert an HTTP status code into its status family bucket.\n *\n * Returns `undefined` for codes outside the 2xx-5xx families.\n */\nexport const statusToCase = (\n status: number\n): NetworkResponseStatusCase | undefined => {\n if (status >= 200 && status <= 299) return \"2xx\"\n if (status >= 300 && status <= 399) return \"3xx\"\n if (status >= 400 && status <= 499) return \"4xx\"\n if (status >= 500 && status <= 599) return \"5xx\"\n\n return undefined\n}\n\nconst resolveStatusHandler = <\n Resp extends NetworkResponse,\n Cases extends MatchStatusCases<Resp>,\n>(\n response: Resp,\n cases: Cases\n): MatchStatusResolvedHandler<Cases, Resp> => {\n const statusCase = statusToCase(response.status)\n if (!statusCase)\n return cases.orElse as MatchStatusResolvedHandler<Cases, Resp>\n\n const handler = cases[statusCase]\n return (handler ?? cases.orElse) as MatchStatusResolvedHandler<Cases, Resp>\n}\n\n/**\n * Route a {@link NetworkResponse} to the first matching status-family handler.\n *\n * Invariants:\n * - `2xx`/`3xx`/`4xx`/`5xx` handlers are matched by status family.\n * - `orElse` is always used as a fallback when no specific family handler exists.\n * - The returned effect type is inferred as the union of all handler effects.\n */\nexport const matchStatus = <\n Resp extends NetworkResponse,\n Cases extends MatchStatusCases<Resp>,\n>(\n response: Resp,\n cases: Cases\n): Effect.Effect<\n EffectSuccess<MatchStatusEffectUnion<Cases, Resp>>,\n EffectError<MatchStatusEffectUnion<Cases, Resp>>,\n EffectContext<MatchStatusEffectUnion<Cases, Resp>>\n> =>\n Effect.suspend(() => {\n const handler = resolveStatusHandler(response, cases)\n return handler(response)\n }) as Effect.Effect<\n EffectSuccess<MatchStatusEffectUnion<Cases, Resp>>,\n EffectError<MatchStatusEffectUnion<Cases, Resp>>,\n EffectContext<MatchStatusEffectUnion<Cases, Resp>>\n >\n\n/**\n * Serialize an optional payload into a JSON request body.\n *\n * Invariants:\n * - `GET` requests cannot carry a payload and fail with `NetworkPayloadError`.\n * - when a payload exists, `content-type: application/json` is emitted.\n */\nconst serializePayload = (\n method: NetworkMethod,\n payload?: unknown\n): Effect.Effect<\n | {\n readonly body: string\n readonly headers: Readonly<Record<string, string>>\n }\n | undefined,\n NetworkPayloadError\n> => {\n if (payload === undefined) {\n return Effect.succeed(undefined)\n }\n\n if (method === \"get\") {\n return Effect.fail(\n new NetworkPayloadError({\n method,\n message: \"GET requests do not support a request body\",\n })\n )\n }\n\n return Effect.try({\n try: () => ({\n body: JSON.stringify(payload),\n headers: { \"content-type\": \"application/json\" },\n }),\n catch: (cause) =>\n new NetworkPayloadError({\n method,\n message: formatMessage(cause, \"Unable to serialize payload to JSON\"),\n }),\n })\n}\n\n/**\n * Convert `Headers` into a readonly plain record.\n */\nexport const headersToRecord = (\n headers: Headers\n): Readonly<Record<string, string>> => Object.fromEntries(headers.entries())\n\nconst normalizeHeaders = (headers: NetworkHeaders): Headers => {\n if (headers instanceof Headers) {\n return new Headers(headers)\n }\n\n if (Array.isArray(headers)) {\n return new Headers(headers)\n }\n\n return new Headers(headers)\n}\n\nconst mergeHeaders = (\n ...headers: ReadonlyArray<Readonly<Record<string, string>>>\n): Readonly<Record<string, string>> => Object.assign({}, ...headers)\n\n/**\n * Build a lazy, memoized JSON parser effect from a response.\n *\n * Invariants:\n * - parsing happens on effect execution, not during response construction.\n * - parsing uses `response.clone()` so the original response body remains untouched.\n */\nconst makeJsonEffect = (\n response: Response,\n context: RequestContext\n): Effect.Effect<unknown, NetworkResponseError> => {\n let cached: Promise<unknown> | undefined\n\n return Effect.tryPromise({\n try: () => {\n cached = cached ?? response.clone().json()\n return cached\n },\n catch: (cause) =>\n new NetworkResponseError({\n method: context.method,\n url: context.url,\n message: formatMessage(cause, \"Unable to parse response JSON\"),\n }),\n })\n}\n\nconst toNetworkResponse = (\n response: Response,\n context: RequestContext\n): NetworkResponse => ({\n status: response.status,\n statusText: response.statusText,\n statusMessage: response.statusText,\n headers: headersToRecord(response.headers),\n json: makeJsonEffect(response, context),\n})\n\n/**\n * Execute a fetch request using the injected {@link NetworkFetch} service.\n *\n * Invariants:\n * - method is always normalized to upper-case before dispatch.\n * - JSON payload (if present) is serialized before request execution.\n * - caller headers override payload-derived headers when keys overlap.\n * - the returned `NetworkResponse.json` remains lazy.\n */\nexport const fetchNetwork = (\n url: string | URL,\n method: NetworkMethod,\n payload?: unknown,\n options?: FetchNetworkOptions\n): Effect.Effect<\n NetworkResponse,\n NetworkRequestError | NetworkPayloadError,\n NetworkFetch\n> =>\n Effect.gen(function* () {\n const requestUrl = String(url)\n const context: RequestContext = { method, url: requestUrl }\n const fetchImpl = yield* NetworkFetch\n const serialized = yield* serializePayload(method, payload)\n\n const providedHeaders = options?.headers\n ? headersToRecord(normalizeHeaders(options.headers))\n : {}\n\n const requestHeaders = mergeHeaders(\n serialized?.headers ?? {},\n providedHeaders\n )\n const hasHeaders = Object.keys(requestHeaders).length > 0\n\n const response = yield* Effect.tryPromise({\n try: () =>\n fetchImpl(requestUrl, {\n method: method.toUpperCase(),\n ...(hasHeaders ? { headers: requestHeaders } : {}),\n ...(serialized\n ? {\n body: serialized.body,\n }\n : {}),\n }),\n catch: (cause) =>\n new NetworkRequestError({\n method,\n url: requestUrl,\n message: formatMessage(cause, \"Network request failed\"),\n }),\n })\n\n return toNetworkResponse(response, context)\n })\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@passlock/cli",
3
- "version": "2.0.6",
3
+ "version": "2.0.7",
4
4
  "description": "CLI tooling support for the Passlock authentication framework",
5
5
  "keywords": [
6
6
  "passkey",
@@ -42,14 +42,14 @@
42
42
  "!dist/**/*.spec.*"
43
43
  ],
44
44
  "dependencies": {
45
- "@clack/prompts": "^1.0.1",
45
+ "@clack/prompts": "^1.1.0",
46
46
  "effect": "3.19.19",
47
47
  "kleur": "^4.1.5"
48
48
  },
49
49
  "devDependencies": {
50
- "@biomejs/biome": "^2.4.4",
50
+ "@biomejs/biome": "^2.4.6",
51
51
  "@effect/vitest": "^0.27.0",
52
- "@types/node": "25.3.3",
52
+ "@types/node": "25.3.5",
53
53
  "globals": "^17.4.0",
54
54
  "npm-check-updates": "^19.6.3",
55
55
  "publint": "0.3.18",