@outfoxx/sunday 1.1.0-alpha.8 → 1.1.0-beta.1

package/src/media-type-codecs/media-type-encoders.ts

@@ -1,4 +1,19 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 import { MediaType } from '../media-type';
+import { AnyTextEncoder } from './any-text-encoder';
 import { BinaryEncoder } from './binary-encoder';
 import { CBOREncoder } from './cbor-encoder';
 import { JSONEncoder } from './json-encoder';
@@ -10,7 +25,7 @@ export interface MediaTypeEncodersBuilder {
 
   add(
     mediaType: MediaType,
-    encoder: MediaTypeEncoder
+    encoder: MediaTypeEncoder,
   ): MediaTypeEncodersBuilder;
 
   build(): MediaTypeEncoders;
@@ -21,22 +36,27 @@ export interface MediaTypeEncodersBuilderConstructor {
 
 export class MediaTypeEncoders {
   static Builder: MediaTypeEncodersBuilderConstructor = class Builder
-    implements MediaTypeEncodersBuilder {
+    implements MediaTypeEncodersBuilder
+  {
     encoders = new Map<MediaType, MediaTypeEncoder>();
 
     add(
       mediaType: MediaType,
-      encoder: MediaTypeEncoder
+      encoder: MediaTypeEncoder,
     ): MediaTypeEncodersBuilder {
       this.encoders.set(mediaType, encoder);
       return this;
     }
 
     addDefaults(): MediaTypeEncodersBuilder {
-      return this.add(MediaType.JSON, JSONEncoder.default)
-        .add(MediaType.OctetStream, BinaryEncoder.default)
+      return this.add(MediaType.OctetStream, BinaryEncoder.default)
         .add(MediaType.WWWFormUrlEncoded, WWWFormUrlEncoder.default)
-        .add(MediaType.CBOR, CBOREncoder.default);
+        .add(MediaType.JSON, JSONEncoder.default)
+        .add(MediaType.JSONStructured, JSONEncoder.default)
+        .add(MediaType.CBOR, CBOREncoder.default)
+        .add(MediaType.AnyText, AnyTextEncoder.default)
+        .add(MediaType.X509CACert, BinaryEncoder.default)
+        .add(MediaType.X509UserCert, BinaryEncoder.default);
     }
 
     build(): MediaTypeEncoders {
@@ -52,13 +72,13 @@ export class MediaTypeEncoders {
 
   supports(mediaType: MediaType): boolean {
     return Array.from(this.encoders.keys()).some((key) =>
-      key.compatible(mediaType)
+      key.compatible(mediaType),
     );
   }
 
   find(mediaType: MediaType): MediaTypeEncoder {
     const found = Array.from(this.encoders.entries()).find(([type]) =>
-      type.compatible(mediaType)
+      type.compatible(mediaType),
     );
     if (!found) {
       throw Error(`Unsupported media type - ${mediaType}`);

package/src/media-type-codecs/www-form-url-encoder.ts

@@ -1,4 +1,28 @@
-import { Instant } from '@js-joda/core';
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import {
+  DateTimeFormatter,
+  Instant,
+  LocalDate,
+  LocalDateTime,
+  LocalTime,
+  OffsetDateTime,
+  OffsetTime,
+  Temporal,
+  ZonedDateTime,
+} from '@js-joda/core';
 import { JsonStringifier } from '@outfoxx/jackson-js';
 import { URLQueryParamsEncoder } from './media-type-encoder';
 
@@ -7,7 +31,7 @@ export class WWWFormUrlEncoder implements URLQueryParamsEncoder {
     return new WWWFormUrlEncoder(
       WWWFormUrlEncoder.ArrayEncoding.UNBRACKETED,
       WWWFormUrlEncoder.BoolEncoding.LITERAL,
-      WWWFormUrlEncoder.DateEncoding.DECIMAL_SECONDS_SINCE_EPOCH
+      WWWFormUrlEncoder.DateEncoding.DECIMAL_SECONDS_SINCE_EPOCH,
     );
   }
 
@@ -16,7 +40,7 @@ export class WWWFormUrlEncoder implements URLQueryParamsEncoder {
     private boolEncoding: WWWFormUrlEncoder.BoolEncoding,
     private dateEncoding: WWWFormUrlEncoder.DateEncoding,
     private json = new JsonStringifier(),
-    private encoder = new TextEncoder()
+    private encoder = new TextEncoder(),
   ) {}
 
   encode<T = unknown>(value: T): ArrayBuffer | SharedArrayBuffer {
@@ -50,23 +74,35 @@ export class WWWFormUrlEncoder implements URLQueryParamsEncoder {
         components.push(
           ...this.encodeQueryComponent(
             encodeArrayKey(key, this.arrayEncoding),
-            item
-          )
+            item,
+          ),
         );
       }
-    } else if (value instanceof Instant) {
+    } else if (value instanceof Date) {
       //
       components.push(
         encodeURIComponent(key) +
           '=' +
-          encodeURIComponent(encodeDate(value, this.dateEncoding))
+          encodeURIComponent(
+            encodeInstant(
+              Instant.ofEpochMilli(value.getTime()),
+              this.dateEncoding,
+            ),
+          ),
+      );
+    } else if (value instanceof Temporal) {
+      //
+      components.push(
+        encodeURIComponent(key) +
+          '=' +
+          encodeURIComponent(encodeTemporal(value, this.dateEncoding)),
       );
     } else if (typeof value === 'boolean') {
       //
       components.push(
         encodeURIComponent(key) +
           '=' +
-          encodeURIComponent(encodeBoolean(value, this.boolEncoding))
+          encodeURIComponent(encodeBoolean(value, this.boolEncoding)),
       );
     } else if (typeof value === 'object') {
       //
@@ -74,13 +110,13 @@ export class WWWFormUrlEncoder implements URLQueryParamsEncoder {
 
       for (const nestedKey of Object.keys(rec).sort()) {
         components.push(
-          ...this.encodeQueryComponent(`${key}[${nestedKey}]`, rec[nestedKey])
+          ...this.encodeQueryComponent(`${key}[${nestedKey}]`, rec[nestedKey]),
         );
       }
     } else {
       //
       components.push(
-        encodeURIComponent(key) + '=' + encodeURIComponent(`${value}`)
+        encodeURIComponent(key) + '=' + encodeURIComponent(`${value}`),
       );
     }
 
@@ -90,7 +126,7 @@ export class WWWFormUrlEncoder implements URLQueryParamsEncoder {
 
 function encodeArrayKey(
   key: string,
-  encoding: WWWFormUrlEncoder.ArrayEncoding
+  encoding: WWWFormUrlEncoder.ArrayEncoding,
 ): string {
   return encoding === WWWFormUrlEncoder.ArrayEncoding.BRACKETED
     ? `${key}[]`
@@ -99,7 +135,7 @@ function encodeArrayKey(
 
 function encodeBoolean(
   value: boolean,
-  encoding: WWWFormUrlEncoder.BoolEncoding
+  encoding: WWWFormUrlEncoder.BoolEncoding,
 ): string {
   switch (encoding) {
     case WWWFormUrlEncoder.BoolEncoding.NUMERIC:
@@ -111,18 +147,46 @@ function encodeBoolean(
   }
 }
 
-function encodeDate(
-  value: Date | Instant,
-  encoding: WWWFormUrlEncoder.DateEncoding
+function encodeTemporal(
+  value: Temporal,
+  encoding: WWWFormUrlEncoder.DateEncoding,
+): string {
+  if (value instanceof Instant) {
+    return encodeInstant(value, encoding);
+  } else if (value instanceof OffsetDateTime) {
+    if (encoding == WWWFormUrlEncoder.DateEncoding.ISO8601) {
+      return value.format(DateTimeFormatter.ISO_OFFSET_DATE_TIME);
+    }
+    return encodeInstant(value.toInstant(), encoding);
+  } else if (value instanceof ZonedDateTime) {
+    if (encoding == WWWFormUrlEncoder.DateEncoding.ISO8601) {
+      return value.format(DateTimeFormatter.ISO_ZONED_DATE_TIME);
+    }
+    return encodeInstant(value.toInstant(), encoding);
+  } else if (value instanceof LocalDateTime) {
+    return value.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME);
+  } else if (value instanceof LocalDate) {
+    return value.format(DateTimeFormatter.ISO_LOCAL_DATE);
+  } else if (value instanceof LocalTime) {
+    return value.format(DateTimeFormatter.ISO_LOCAL_TIME);
+  } else if (value instanceof OffsetTime) {
+    return value.format(DateTimeFormatter.ISO_OFFSET_TIME);
+  } else {
+    throw Error('unsupported temporal value for ');
+  }
+}
+
+function encodeInstant(
+  value: Instant,
+  encoding: WWWFormUrlEncoder.DateEncoding,
 ): string {
-  value = value instanceof Date ? Instant.ofEpochMilli(value.getTime()) : value;
   switch (encoding) {
     case WWWFormUrlEncoder.DateEncoding.DECIMAL_SECONDS_SINCE_EPOCH:
       return (value.epochSecond() + value.nano() / 1_000_000_000.0).toFixed(7);
     case WWWFormUrlEncoder.DateEncoding.MILLISECONDS_SINCE_EPOCH:
       return `${value.toEpochMilli()}`;
     case WWWFormUrlEncoder.DateEncoding.ISO8601:
-      return value.toString();
+      return DateTimeFormatter.ISO_INSTANT.format(value);
     default:
       throw new Error('unknown date encoding');
   }

package/src/media-type.ts

@@ -1,3 +1,17 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 export class MediaType {
   type: MediaType.Type;
   tree: MediaType.Tree;
@@ -21,7 +35,7 @@ export class MediaType {
         obj[name.toLowerCase()] = value.toLowerCase();
         return obj;
       },
-      {} as Record<string, string>
+      {} as Record<string, string>,
     );
   }
 
@@ -47,7 +61,7 @@ export class MediaType {
 
   withParameter(
     parameter: MediaType.ParameterName | string,
-    value: string
+    value: string,
   ): MediaType {
     const parameters = Object.assign({}, this.parameters, {
       [parameter]: value,
@@ -181,28 +195,35 @@ export namespace MediaType {
     CharSet = 'charset',
   }
 
-  export function from(value?: string | null): MediaType | undefined;
+  export function from(value?: string | null): MediaType;
   export function from(
     value: string | null | undefined,
-    def: MediaType
+    def: MediaType,
   ): MediaType;
   export function from(
     value?: string | null,
-    def: MediaType | undefined = undefined
-  ): MediaType | undefined {
-    if (!value) {
+    def: MediaType | undefined = undefined,
+  ): MediaType {
+    const reqDef = () => {
+      if (!def) {
+        throw Error('Invalid media type');
+      }
       return def;
+    };
+
+    if (!value) {
+      return reqDef();
     }
 
     fullRegex.lastIndex = 0;
     const match = fullRegex.exec(value);
     if (match?.[0] != value) {
-      return def;
+      return reqDef();
     }
 
     const type = MediaType.Type.from(match[1]?.toLowerCase());
     if (!type) {
-      return def;
+      return reqDef();
     }
 
     const tree =
@@ -210,7 +231,7 @@ export namespace MediaType {
 
     const subtype = match[3]?.toLowerCase();
     if (!subtype) {
-      return def;
+      return reqDef();
     }
 
     const suffix = MediaType.Suffix.from(match[4]?.toLowerCase());
@@ -239,7 +260,8 @@ export namespace MediaType {
     });
   }
 
-  const fullRegex = /^((?:[a-z]+|\*))\/(x(?:-|\\.)|(?:(?:vnd|prs|x)\.)|\*)?([a-z0-9\-.]+|\*)(?:\+([a-z]+))?( *(?:; *(?:(?:[\w.-]+) *= *(?:[\w.-]+)) *)*)$/gi;
+  const fullRegex =
+    /^((?:[a-z]+|\*))\/(x(?:-|\\.)|(?:(?:vnd|prs|x)\.)|\*)?([a-z0-9\-.]+|\*)(?:\+([a-z]+))?( *(?:; *(?:(?:[\w.-]+) *= *(?:[\w.-]+)) *)*)$/gi;
   const paramRegex = / *; *([\w.-]+) *= *([\w.-]+)/gi;
 
   export const Plain = new MediaType({
@@ -320,9 +342,21 @@ export namespace MediaType {
     suffix: Suffix.XML,
   });
 
-  export const ProblemJSON = new MediaType({
+  export const Problem = new MediaType({
     type: MediaType.Type.Application,
     subtype: 'problem',
     suffix: Suffix.JSON,
   });
+
+  export const JsonPatch = new MediaType({
+    type: MediaType.Type.Application,
+    subtype: 'json-patch',
+    suffix: Suffix.JSON,
+  });
+
+  export const MergePatch = new MediaType({
+    type: MediaType.Type.Application,
+    subtype: 'merge-patch',
+    suffix: Suffix.JSON,
+  });
 }

package/src/problem.ts

@@ -1,3 +1,17 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 import { ResponseExample } from './fetch';
 import {
   JsonAnyGetter,
@@ -67,7 +81,7 @@ export class Problem extends Error implements Problem {
   constructor(spec: ProblemSpec) {
     super(`${spec.status.toString()} ${spec.type} - ${spec.title}`);
 
-    const src = (spec as unknown) as Record<string, unknown>;
+    const src = spec as unknown as Record<string, unknown>;
 
     const json = Object.assign({}, src);
 
@@ -118,7 +132,7 @@ export class Problem extends Error implements Problem {
   static async fromResponse(response: Response): Promise<Problem> {
     const [bodyExcerpt, body] = await ResponseExample.bodyExcerpt(
       response,
-      256
+      256,
     );
 
     return new Problem({
@@ -129,9 +143,13 @@ export class Problem extends Error implements Problem {
         url: response.url,
       },
       response: {
-        type: response.type,
         headers: response.headers,
-        trailer: response.trailer,
+        ok: response.ok,
+        redirected: response.redirected,
+        status: response.status,
+        statusText: response.statusText,
+        type: response.type,
+        url: response.url,
         body,
         example: ResponseExample.build(response, bodyExcerpt),
       },

package/src/request-factory.ts

@@ -1,9 +1,24 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 import { Observable } from 'rxjs';
 import { AnyType } from './any-type';
 import { ClassType, ConstructableClassType } from './class-type';
 import { MediaType } from './media-type';
 import { TextMediaTypeDecoder } from './media-type-codecs/media-type-decoder';
 import { Problem } from './problem';
+import { ResultResponse } from './result-response';
 import { URLTemplate } from './url-template';
 import { Logger } from './logger';
 
@@ -12,7 +27,7 @@ export interface RequestFactory {
 
   registerProblem(
     type: URL | string,
-    problemType: ConstructableClassType<Problem>
+    problemType: ConstructableClassType<Problem>,
   ): void;
 
   request(requestSpec: RequestSpec<unknown>): Observable<Request>;
@@ -21,22 +36,46 @@ export interface RequestFactory {
 
   response<B>(
     requestSpec: RequestSpec<B>,
-    dataExpected?: boolean
+    dataExpected?: boolean,
   ): Observable<Response>;
 
+  resultResponse<B, R>(
+    requestSpec: RequestSpec<B>,
+    resultType: [ClassType<R>],
+  ): Observable<ResultResponse<R>>;
+
+  resultResponse<B, R>(
+    requestSpec: RequestSpec<B>,
+    resultType: [ClassType<Array<unknown>>, ClassType<R>],
+  ): Observable<ResultResponse<Array<R>>>;
+
+  resultResponse<B, R>(
+    requestSpec: RequestSpec<B>,
+    resultType: [ClassType<Set<unknown>>, ClassType<R>],
+  ): Observable<ResultResponse<Set<R>>>;
+
+  resultResponse<B, R>(
+    requestSpec: RequestSpec<B>,
+    resultType: AnyType,
+  ): Observable<ResultResponse<R>>;
+
+  resultResponse<B>(
+    requestSpec: RequestSpec<B>,
+  ): Observable<ResultResponse<void>>;
+
   result<B, R>(
     requestSpec: RequestSpec<B>,
-    resultType: [ClassType<R>]
+    resultType: [ClassType<R>],
   ): Observable<R>;
 
   result<B, R>(
     requestSpec: RequestSpec<B>,
-    resultType: [ClassType<Array<unknown>>, ClassType<R>]
+    resultType: [ClassType<Array<unknown>>, ClassType<R>],
   ): Observable<Array<R>>;
 
   result<B, R>(
     requestSpec: RequestSpec<B>,
-    resultType: [ClassType<Set<unknown>>, ClassType<R>]
+    resultType: [ClassType<Set<unknown>>, ClassType<R>],
   ): Observable<Set<R>>;
 
   result<B, R>(requestSpec: RequestSpec<B>, resultType: AnyType): Observable<R>;
@@ -52,8 +91,8 @@ export interface RequestFactory {
       event: string | undefined,
       id: string | undefined,
       data: string,
-      logger?: Logger
-    ) => E | undefined
+      logger?: Logger,
+    ) => E | undefined,
   ): Observable<E>;
 }
 

package/src/result-response.ts

@@ -0,0 +1,18 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+export interface ResultResponse<R> {
+  readonly result: R;
+  readonly response: Response;
+}

package/src/sunday-error.ts

@@ -1,3 +1,17 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 import { ResponseExample } from './fetch';
 
 export class SundayError extends Error {
@@ -9,18 +23,18 @@ export class SundayError extends Error {
     public statusText: string,
     public headers: Headers,
     public body: unknown | undefined,
-    public responseExample: string
+    public responseExample: string,
   ) {
     super(message);
   }
 
   static async fromResponse(
     message: string,
-    response: Response
+    response: Response,
   ): Promise<SundayError> {
     const [bodyExcerpt, body] = await ResponseExample.bodyExcerpt(
       response,
-      256
+      256,
     );
 
     return new SundayError(
@@ -31,7 +45,7 @@ export class SundayError extends Error {
       response.statusText,
       response.headers,
       body,
-      ResponseExample.build(response, bodyExcerpt)
+      ResponseExample.build(response, bodyExcerpt),
     );
   }
 }

package/src/url-template.ts

@@ -1,9 +1,23 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 import { URI } from 'uri-template-lite';
 
 export class URLTemplate {
   constructor(
     public template: string,
-    public parameters: Record<string, unknown> = {}
+    public parameters: Record<string, unknown> = {},
   ) {}
 
   complete(relativeTemplate: string, parameters: Record<string, unknown>): URL {

package/src/util/any.ts

@@ -1,3 +1,17 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 export function unknownGet<T = unknown>(obj: unknown, key: string): T {
   return (obj as Record<string, unknown>)?.[key] as T;
 }

package/src/util/base64.ts

@@ -1,3 +1,17 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
 const chars =
   'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
 
@@ -17,7 +31,7 @@ export namespace Base64 {
   export function encodeSlice(
     buffer: ArrayBufferLike,
     offset: number,
-    length: number
+    length: number,
   ): string {
     const bytes = new Uint8Array(buffer, offset, length);
     const len = bytes.length;

package/src/util/error.ts

@@ -0,0 +1,28 @@
+// Copyright 2020 Outfox, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+export function isError(value: unknown): value is Error {
+  return value instanceof Error;
+}
+
+export function errorToMessage(value: unknown, defMsg?: string): string {
+  return isError(value) ? value.message : defMsg ?? `${fmtMsg(value)}`;
+}
+
+function fmtMsg(value: unknown): string {
+  if (value instanceof Object) {
+    return JSON.stringify(value);
+  }
+  return `${value}`;
+}